From e528a45887baa1b43142737d3e321d4b80497e13 Mon Sep 17 00:00:00 2001 From: AbdullahT01 Date: Thu, 19 Nov 2026 22:43:27 -0500 Subject: [PATCH 1/3] add the salesforce eol plugin Signed-off-by: AbdullahT01 --- README.md | 2 +- docs/plugins.json | 12 +- docs/plugins.md | 3 +- docs/plugins.schema.json | 2 +- docs/writing-a-plugin.md | 1 + plugins/all/all.go | 1 + plugins/eol/eol.go | 237 ++++++ plugins/eol/eol_test.go | 56 ++ plugins/eol/testdata/README.md | 5 + plugins/eol/testdata/golden/salesforce.json | 682 ++++++++++++++++++ .../salesforce-api-rest-eol-2026-10-31.html | 80 ++ providers/README.md | 1 + providers/salesforce.md | 38 + 13 files changed, 1116 insertions(+), 4 deletions(-) create mode 100644 plugins/eol/eol.go create mode 100644 plugins/eol/eol_test.go create mode 100644 plugins/eol/testdata/README.md create mode 100644 plugins/eol/testdata/golden/salesforce.json create mode 100644 plugins/eol/testdata/salesforce-api-rest-eol-2026-10-31.html create mode 100644 providers/salesforce.md diff --git a/README.md b/README.md index d17a116..7cb71bc 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ [![Go Reference](https://pkg.go.dev/badge/github.com/patch-it-dev/patch-it-plugins.svg)](https://pkg.go.dev/github.com/patch-it-dev/patch-it-plugins) [![Go version](https://img.shields.io/github/go-mod/go-version/patch-it-dev/patch-it-plugins)](go.mod) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-3f5bf0)](LICENSE) -[![Plugins](https://img.shields.io/badge/plugins-28-3f5bf0)](docs/plugins.md) +[![Plugins](https://img.shields.io/badge/plugins-29-3f5bf0)](docs/plugins.md) [![Docs](https://img.shields.io/badge/docs-docs.patch--it.dev-3f5bf0)](https://docs.patch-it.dev) [![Discussions](https://img.shields.io/github/discussions/patch-it-dev/patch-it-plugins)](https://github.com/patch-it-dev/patch-it-plugins/discussions) diff --git a/docs/plugins.json b/docs/plugins.json index b3fc203..9e9a812 100644 --- a/docs/plugins.json +++ b/docs/plugins.json @@ -1,7 +1,7 @@ { "_comment": "Generated from the plugin registry and docs/plugins.md by `make plugins-json` (go run ./cmd/list-plugins). Don't edit by hand.", "$schema": "./plugins.schema.json", - "count": 28, + "count": 29, "plugins": [ { "id": "algolia-ingestion", @@ -213,6 +213,16 @@ "status": "live", "provider_page": "providers/redis.md" }, + { + "id": "salesforce", + "provider": "Salesforce", + "layer": "api", + "watches": "REST API version ranges deprecated and retired, from Salesforce's own API end-of-life policy page", + "format": "eol", + "source_url": "https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "status": "live", + "provider_page": "providers/salesforce.md" + }, { "id": "sentry", "provider": "Sentry", diff --git a/docs/plugins.md b/docs/plugins.md index d1a32c4..256aa35 100644 --- a/docs/plugins.md +++ b/docs/plugins.md @@ -37,6 +37,7 @@ The table between the `plugins:start` and `plugins:end` markers is also publishe | [`posthog`](https://github.com/patch-it-dev/patch-it-plugins/blob/main/providers/posthog.md) | PostHog | SDK | Members removed in the posthog Python SDK 8.0.0 | `removedmembers` | [posthog-python 7.x to 8.0 migration guide](https://github.com/PostHog/posthog-python/blob/posthog-v8.0.0/docs/migration-7.x-to-8.0.md) | live | | [`newrelic`](https://github.com/patch-it-dev/patch-it-plugins/blob/main/providers/newrelic.md) | New Relic | SDK | Members removed in the New Relic Python agent 11.0.0 | `removedmembers` | [Python agent 11.0.0 release notes](https://github.com/newrelic/docs-website/blob/f0b4f817bf9a7b76a78e26609369a8a7ce764c8e/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-110000.mdx) | live | | [`appwrite`](https://github.com/patch-it-dev/patch-it-plugins/blob/main/providers/appwrite.md) | Appwrite | API | REST API operations a server SDK calls that are deprecated between commits of the spec, SDK method renames left out | `openapi` | [appwrite/specs](https://github.com/appwrite/specs) (`specs/.x/open-api3-.x.json`, the newest minor) | live | +| [`salesforce`](https://github.com/patch-it-dev/patch-it-plugins/blob/main/providers/salesforce.md) | Salesforce | API | REST API version ranges deprecated and retired, from Salesforce's own API end-of-life policy page | `eol` | [Salesforce API End-of-Life Policy](https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html) | live | ## The columns @@ -47,7 +48,7 @@ The table between the `plugins:start` and `plugins:end` markers is also publishe | Provider | Whose API, SDK or package it is. | | Layer | Which kind of dependency it covers: `API`, `SDK`, `package`, `runtime`, `CI` or `AI models`. | | What it watches | The kind of change it reports, in a few words. | -| Format plugin | Which shared reader it is built on: `openapi` (a spec per release, diffed), `retirements` (a deprecations page), `migrationguide` (an SDK's migration guide), `removedmembers` (a package's table of removed members, in RST or Markdown), `changelog` (a release changelog file), `feed` (an RSS or Atom feed), `catalog` (a structured JSON catalog of names, diffed between two snapshots), `apichangelog` (a vendor's machine-readable API changelog, in JSON). | +| Format plugin | Which shared reader it is built on: `openapi` (a spec per release, diffed), `retirements` (a deprecations page), `migrationguide` (an SDK's migration guide), `removedmembers` (a package's table of removed members, in RST or Markdown), `changelog` (a release changelog file), `feed` (an RSS or Atom feed), `catalog` (a structured JSON catalog of names, diffed between two snapshots), `apichangelog` (a vendor's machine-readable API changelog, in JSON), `eol` (a vendor's own table of whole API version ranges and their support status). | | Source | The provider's own public page or file the plugin reads. Every event links back to it. | | Status | `live`: in the code on `main`. patch-it's hosted ingestion service runs it daily from the next release, which is cut automatically. `planned`: accepted, not written yet. `paused`: in the code but deliberately switched off, with the reason in the row. | diff --git a/docs/plugins.schema.json b/docs/plugins.schema.json index 6399a73..35b1cad 100644 --- a/docs/plugins.schema.json +++ b/docs/plugins.schema.json @@ -21,7 +21,7 @@ "provider": { "type": "string", "minLength": 1 }, "layer": { "type": "string", "enum": ["api", "sdk", "package", "runtime", "ci", "ai-models"] }, "watches": { "type": "string", "minLength": 1 }, - "format": { "type": "string", "enum": ["openapi", "retirements", "migrationguide", "removedmembers", "changelog", "feed", "apichangelog", "catalog"] }, + "format": { "type": "string", "enum": ["openapi", "retirements", "migrationguide", "removedmembers", "changelog", "feed", "apichangelog", "catalog", "eol"] }, "source_url": { "type": "string", "pattern": "^https://" }, "status": { "type": "string", "enum": ["live", "paused", "planned"] }, "status_note": { "type": "string", "description": "Why, for a paused plugin." }, diff --git a/docs/writing-a-plugin.md b/docs/writing-a-plugin.md index d7883b7..9e08c71 100644 --- a/docs/writing-a-plugin.md +++ b/docs/writing-a-plugin.md @@ -83,6 +83,7 @@ Write the numbers on the provider page, as `providers/vercel.md` does for its sp | `plugins/feed` | An RSS or Atom feed | A `feed.Feed` with a reader for that vendor's entries | | `plugins/catalog` | A flat JSON catalog, one entry per name, with no release tags to pin — a commit SHA stands in | A `catalog.Catalog`, diffed between two snapshots for names that disappeared entirely | | `plugins/apichangelog` | A vendor's machine-readable API changelog in JSON (per day, endpoint and API version, oasdiff change codes), at the commit that last changed it | An `apichangelog.Log` | +| `plugins/eol` | A vendor's own table of whole API version ranges and their support status (supported, deprecated, retired) | An `eol.Page`; `--format` doesn't scaffold this one yet, write it by hand | ## 4. The interface diff --git a/plugins/all/all.go b/plugins/all/all.go index e8bd0bd..7ca6527 100644 --- a/plugins/all/all.go +++ b/plugins/all/all.go @@ -7,6 +7,7 @@ import ( _ "github.com/patch-it-dev/patch-it-plugins/plugins/apichangelog" _ "github.com/patch-it-dev/patch-it-plugins/plugins/catalog" _ "github.com/patch-it-dev/patch-it-plugins/plugins/changelog" + _ "github.com/patch-it-dev/patch-it-plugins/plugins/eol" _ "github.com/patch-it-dev/patch-it-plugins/plugins/feed" _ "github.com/patch-it-dev/patch-it-plugins/plugins/migrationguide" _ "github.com/patch-it-dev/patch-it-plugins/plugins/openapi" diff --git a/plugins/eol/eol.go b/plugins/eol/eol.go new file mode 100644 index 0000000..eae7a98 --- /dev/null +++ b/plugins/eol/eol.go @@ -0,0 +1,237 @@ +// Package eol is the source plugin for a vendor's own API end-of-life page: a +// table of whole version ranges, each with a support status. One event per +// version number a row says is already retired (breaking) or scheduled to be +// (deprecation); a row that only says "Supported." names nothing to report. +// +// There is no spec to diff, like retirements and feed: the page is read as it +// is now, and the events cite a Wayback Machine snapshot of it, never the +// live page (kit/). Unlike retirements (one named model per row) and feed +// (an RSS or Atom entry), a row here names a whole range of version numbers +// and no replacement: moving up to any newer version clears it. +package eol + +import ( + "context" + "fmt" + "log" + "regexp" + "strconv" + "strings" + + "github.com/patch-it-dev/patch-it-plugins/event" + "github.com/patch-it-dev/patch-it-plugins/kit" + "github.com/patch-it-dev/patch-it-plugins/plugin" +) + +func init() { + plugin.Register(Plugin{Page: Salesforce, Archiver: kit.Wayback{}}) +} + +// Page is one vendor's end-of-life table. +type Page struct { + API string // the events' api: "salesforce" + Vendor string // for sentences: "Salesforce" + URL string // the page, as HTML + // Operation names the one real, documented, version-rooted resource a + // retired version takes down: Salesforce's "List Available REST + // Resources" call, GET /services/data/vXX.X/. Every other resource under + // that version is gone too (the page says so), but this is the one this + // plugin can point at honestly, without inventing a wildcard operation + // nothing calls. + Operation func(version string) string +} + +// Salesforce is the REST API's end-of-life policy page (checked 2026-11-20): +// a table of version ranges, each "Supported.", already retired ("As of +// Summer '25, these versions are retired and unavailable."), or scheduled +// ("Deprecated and unsupported from Summer '27. Retired from Summer '28."). +// Salesforce gives no exact date, only the named release ("Summer '27"); the +// policy text above the table says the notice is at least a year ahead of +// retirement. +var Salesforce = Page{ + API: "salesforce", Vendor: "Salesforce", + URL: "https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + Operation: func(v string) string { return "GET /services/data/v" + v + "/" }, +} + +// Row is one version range and what its status cell says, cleaned of HTML. +type Row struct { + From, To int // inclusive, both ends; From == To for a single version + Status string // every

in the status cell, joined with a space +} + +// Finding is one version number a row's status names, or a row that names +// none (Dropped set). +type Finding struct { + ChangeType event.ChangeType + Version string // "21.0" + Season string // "Summer ’25", or "Summer ’27, retired from Summer ’28" + Excerpt string + Row string // the row's version-range text, for Dropped's log line + Dropped string +} + +var ( + table = regexp.MustCompile(`(?is)(.*?)`) + row = regexp.MustCompile(`(?is)(.*?)`) + cell = regexp.MustCompile(`(?is)(.*?)`) + tag = regexp.MustCompile(`<[^>]+>`) + versions = regexp.MustCompile(`(?i)Versions?\s+(\d+)(?:\.\d+)?(?:\s+through\s+(\d+)(?:\.\d+)?)?`) + retired = regexp.MustCompile(`(?i)As of ([^,]+), these versions are retired and unavailable\.`) + deprecd = regexp.MustCompile(`(?i)Deprecated and unsupported from ([^.]+)\.\s*Retired from ([^.]+)\.`) +) + +// text strips tags and normalizes whitespace, the way a 's content (bare +// text, or several

s) reads as one sentence. +func text(fragment string) string { + return strings.Join(strings.Fields(tag.ReplaceAllString(fragment, " ")), " ") +} + +// Parse reads every row of the page's first table. +func Parse(page []byte) ([]Row, error) { + m := table.FindStringSubmatch(string(page)) + if m == nil { + return nil, fmt.Errorf("no table found: the page's shape may have changed") + } + var out []Row + for _, r := range row.FindAllStringSubmatch(m[1], -1) { + cells := cell.FindAllStringSubmatch(r[1], -1) + if len(cells) < 2 { + continue + } + vm := versions.FindStringSubmatch(text(cells[0][1])) + if vm == nil { + continue + } + from, _ := strconv.Atoi(vm[1]) + to := from + if vm[2] != "" { + to, _ = strconv.Atoi(vm[2]) + } + out = append(out, Row{From: from, To: to, Status: text(cells[1][1])}) + } + if len(out) == 0 { + return nil, fmt.Errorf("no version rows found: the page's shape may have changed") + } + return out, nil +} + +// Findings classifies every row and names every version number a breaking or +// deprecated row covers. A row that's merely "Supported." names none. +func Findings(page []byte) ([]Finding, error) { + rows, err := Parse(page) + if err != nil { + return nil, err + } + var out []Finding + for _, r := range rows { + label := fmt.Sprintf("Versions %d.0 through %d.0", r.From, r.To) + if r.From == r.To { + label = fmt.Sprintf("Version %d.0", r.From) + } + excerpt := label + " | " + r.Status + + var ct event.ChangeType + var season string + switch { + case retired.MatchString(r.Status): + ct, season = event.ChangeTypeBreaking, retired.FindStringSubmatch(r.Status)[1] + case deprecd.MatchString(r.Status): + m := deprecd.FindStringSubmatch(r.Status) + ct, season = event.ChangeTypeDeprecation, m[1]+", retired from "+m[2] + default: + out = append(out, Finding{Row: label, Dropped: fmt.Sprintf("status %q names neither a retirement nor a deprecation", r.Status)}) + continue + } + for v := r.From; v <= r.To; v++ { + out = append(out, Finding{ + ChangeType: ct, + Version: fmt.Sprintf("%d.0", v), + Season: season, + Excerpt: excerpt, + Row: label, + }) + } + } + return out, nil +} + +// Plugin reads one vendor's end-of-life page. +type Plugin struct { + Page Page + Archiver kit.Archiver +} + +func (p Plugin) Name() string { return p.Page.API } + +// Run reads the page as it is now. An unchanged page since the last run costs +// one GET and no snapshot. +func (p Plugin) Run(ctx context.Context, env plugin.Env) (plugin.Result, error) { + pg := p.Page + live, err := env.Get(ctx, pg.URL) + if err != nil { + return plugin.Result{}, fmt.Errorf("fetching %s: %w", pg.URL, err) + } + hash := plugin.SHA256(live) + last, same, err := kit.Unchanged(env, pg.API, live) + if err != nil { + return plugin.Result{}, err + } + if same { + log.Printf("%s: no change since %s", pg.API, last.SourceURL) + return plugin.Result{}, nil + } + + want, err := Findings(live) + if err != nil { + return plugin.Result{}, fmt.Errorf("reading %s: %w", pg.URL, err) + } + snapURL, snap, got, err := kit.Cite(ctx, p.Archiver, pg.URL, Findings, want) + if err != nil { + return plugin.Result{}, err + } + + now := env.Now().UTC() + var events []event.EventV2 + var rejected []error + for _, f := range got { + if f.Dropped != "" { + log.Printf("%s: dropped %s: %s", pg.API, f.Row, f.Dropped) + continue + } + e := event.EventV2{ + API: pg.API, + Version: f.Version, + ChangeType: f.ChangeType, + Breaking: f.ChangeType == event.ChangeTypeBreaking, + Subject: event.Subject{ + Type: event.SubjectAPIOperation, + Kind: event.AffectedKindOperation, + Side: event.SideRequest, + Operation: pg.Operation(f.Version), + }, + Description: describe(pg, f), + MigrationHint: fmt.Sprintf("Pin a newer %s REST API version: %s names which ones are still supported.", pg.Vendor, snapURL), + SourceURL: snapURL, + SourceExcerpt: f.Excerpt, + Confidence: 1.0, + DetectedAt: now, + } + e.Fingerprint = event.FingerprintV2(e.API, e.Version, e.ChangeType, e.Subject, "") + if err := e.Validate(); err != nil { + rejected = append(rejected, fmt.Errorf("%s %s: %w", pg.API, f.Version, err)) + continue + } + events = append(events, e) + } + baseline := plugin.Baseline(pg.API, now.Format("2006-01-02"), snapURL, snapURL, snap, false, now) + baseline.SHA256 = hash + return plugin.Result{Label: snapURL, Events: events, Rejected: rejected, Baselines: []plugin.Spec{baseline}}, nil +} + +func describe(pg Page, f Finding) string { + if f.ChangeType == event.ChangeTypeBreaking { + return fmt.Sprintf("%s REST API version %s is retired, as of %s: it returns 410:GONE for every resource.", pg.Vendor, f.Version, f.Season) + } + return fmt.Sprintf("%s REST API version %s is deprecated and scheduled for retirement: unsupported from %s.", pg.Vendor, f.Version, f.Season) +} diff --git a/plugins/eol/eol_test.go b/plugins/eol/eol_test.go new file mode 100644 index 0000000..d1a53b1 --- /dev/null +++ b/plugins/eol/eol_test.go @@ -0,0 +1,56 @@ +package eol + +import ( + "fmt" + "testing" + + "github.com/patch-it-dev/patch-it-plugins/kit/kittest" +) + +func TestRegistersItself(t *testing.T) { + kittest.Registered(t, Plugin{Page: Salesforce}) +} + +// The golden test: Salesforce's own end-of-life policy page (checked +// 2026-11-20, saved 2026-10-31), real and unedited but for dropping the +// surrounding navigation chrome. It already holds two real, past retirements +// (versions 7.0 through 20.0, retired as of Summer '22; versions 21.0 +// through 30.0, retired as of Summer '25) and one real, scheduled one +// (versions 31.0 through 40.0, deprecated from Summer '27, retired from +// Summer '28): 34 events, and the still-"Supported." 41.0 through 67.0 band +// names none, the pinned drop test. +func TestGolden(t *testing.T) { + saved := kittest.Pages{Salesforce.URL: "testdata/salesforce-api-rest-eol-2026-10-31.html"} + archive := &kittest.Archive{T: t, Pages: saved} + got := kittest.IngestWith(t, kittest.Env(t, saved), Plugin{Page: Salesforce, Archiver: archive}) + if archive.Calls != 1 { + t.Errorf("%d snapshots, want 1: the second run's page is unchanged", archive.Calls) + } + kittest.Golden(t, "testdata/golden/salesforce.json", got) +} + +// The pinned drop test: "Versions 41.0 through 67.0: Supported." is a real +// row on the page, and it must name no version. +func TestDropsAStillSupportedBand(t *testing.T) { + page := kittest.Read(t, "testdata/salesforce-api-rest-eol-2026-10-31.html") + found, err := Findings(page) + if err != nil { + t.Fatal(err) + } + supported := map[string]bool{} + for v := 41; v <= 67; v++ { + supported[fmt.Sprintf("%d.0", v)] = true + } + var dropped bool + for _, f := range found { + if f.Dropped == "" && supported[f.Version] { + t.Errorf("version %s got an event, want none: it's still Supported", f.Version) + } + if f.Dropped != "" && f.Row == "Versions 41.0 through 67.0" { + dropped = true + } + } + if !dropped { + t.Error("the still-supported band wasn't found and dropped") + } +} diff --git a/plugins/eol/testdata/README.md b/plugins/eol/testdata/README.md new file mode 100644 index 0000000..9b956a7 --- /dev/null +++ b/plugins/eol/testdata/README.md @@ -0,0 +1,5 @@ +# Saved end-of-life pages + +| File | URL | Fetched | License | Quote | +|---|---|---|---|---| +| `salesforce-api-rest-eol-2026-10-31.html` | https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html | 2026-11-20 (the page itself as crawled 2026-10-31; the live page 403s a plain fetch, so this is the newest Wayback Machine snapshot, checked 2026-11-20) | Excerpt for testing; © Salesforce. Trimmed to the policy paragraphs and the version table, every line copied unchanged (its internal links' Wayback rewrite prefix removed, to read as the live page serves them); the surrounding navigation and page chrome left out. | "As of Summer ’25, these versions are retired and unavailable." (Versions 21.0 through 30.0) | diff --git a/plugins/eol/testdata/golden/salesforce.json b/plugins/eol/testdata/golden/salesforce.json new file mode 100644 index 0000000..4d9140c --- /dev/null +++ b/plugins/eol/testdata/golden/salesforce.json @@ -0,0 +1,682 @@ +[ + { + "id": 1, + "fingerprint": "sha256:5712d5a3f809b2edd3032446bfe6a0a654eb113f1f7e0e80b0d673132dced685", + "api": "salesforce", + "version": "31.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v31.0/" + }, + "description": "Salesforce REST API version 31.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 2, + "fingerprint": "sha256:d5cd04d4a65a7ba09f4a71e7c346a4be3309451212787016d5c614498b556516", + "api": "salesforce", + "version": "32.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v32.0/" + }, + "description": "Salesforce REST API version 32.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 3, + "fingerprint": "sha256:c009d4f0635e311b34acfbb6696c6d2aacbcd7c102ebc56d13036044f10910bf", + "api": "salesforce", + "version": "33.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v33.0/" + }, + "description": "Salesforce REST API version 33.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 4, + "fingerprint": "sha256:08ef4a0e2b7798dd6e15087bfc30505dd412de40c553d3617f3d4533730b3931", + "api": "salesforce", + "version": "34.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v34.0/" + }, + "description": "Salesforce REST API version 34.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 5, + "fingerprint": "sha256:f8b44ec3074f7f9d2ea45e3d2e681dc7e0bfca83a3c046d188e90a63295c06bd", + "api": "salesforce", + "version": "35.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v35.0/" + }, + "description": "Salesforce REST API version 35.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 6, + "fingerprint": "sha256:edc028b547f9ed0ec5559febeb2ea9a04eb681e4d53fd15fe98961d110fbe3d3", + "api": "salesforce", + "version": "36.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v36.0/" + }, + "description": "Salesforce REST API version 36.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 7, + "fingerprint": "sha256:a00a996c75520031b4df78d500f327f9b9c94706753f2e8beb8ec123ee3e37e1", + "api": "salesforce", + "version": "37.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v37.0/" + }, + "description": "Salesforce REST API version 37.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 8, + "fingerprint": "sha256:ae8c254aa2eeb784a0cda9eaafeedf617991223b3ebcdf6c12bfd56e496712f9", + "api": "salesforce", + "version": "38.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v38.0/" + }, + "description": "Salesforce REST API version 38.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 9, + "fingerprint": "sha256:5f738a2088c9e818c5da229746de80ff1966e94b454eddcd1ea7e2fb6323bb27", + "api": "salesforce", + "version": "39.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v39.0/" + }, + "description": "Salesforce REST API version 39.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 10, + "fingerprint": "sha256:01287da0f76665a83b6d2cf46f99ea4b189e3b5e4a3f1370d03e59da9928fc09", + "api": "salesforce", + "version": "40.0", + "change_type": "deprecation", + "breaking": false, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v40.0/" + }, + "description": "Salesforce REST API version 40.0 is deprecated and scheduled for retirement: unsupported from Summer ’27, retired from Summer ’28.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 31.0 through 40.0 | Supported. Deprecated and unsupported from Summer ’27. Retired from Summer ’28.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 11, + "fingerprint": "sha256:3196e696d971115984b011f675c6625471769a9bed370f39fa34697cabb2a568", + "api": "salesforce", + "version": "21.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v21.0/" + }, + "description": "Salesforce REST API version 21.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 12, + "fingerprint": "sha256:b01efdc1068b028b253b16195c3a40220f2c38a47692b039c972ad860fd04aa5", + "api": "salesforce", + "version": "22.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v22.0/" + }, + "description": "Salesforce REST API version 22.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 13, + "fingerprint": "sha256:6d416539f96a25434c34a311bbc0f5c946c07a9a2f87bcb3c58b04e0d47fb15f", + "api": "salesforce", + "version": "23.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v23.0/" + }, + "description": "Salesforce REST API version 23.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 14, + "fingerprint": "sha256:54e2b6dde407bf4e2cbe571daf71c7759c625b079c6e7fc9e0b9ed630745edcf", + "api": "salesforce", + "version": "24.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v24.0/" + }, + "description": "Salesforce REST API version 24.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 15, + "fingerprint": "sha256:0c4183136450ca1afccd23bf6e4e9f25f08f2a0470c55032e0724312b616a7e1", + "api": "salesforce", + "version": "25.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v25.0/" + }, + "description": "Salesforce REST API version 25.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 16, + "fingerprint": "sha256:2f8518fb4d77876618e24c6848977e471825e305404f234c349b9af56e731078", + "api": "salesforce", + "version": "26.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v26.0/" + }, + "description": "Salesforce REST API version 26.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 17, + "fingerprint": "sha256:44ed65c3d55263ee40bdf9324715ad0b31c727f927a172a38cc0162bf796d325", + "api": "salesforce", + "version": "27.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v27.0/" + }, + "description": "Salesforce REST API version 27.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 18, + "fingerprint": "sha256:3da22cdfd664c8f52ebb476cd278bfdeb460918c50d8b0184a542ce091fd72e8", + "api": "salesforce", + "version": "28.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v28.0/" + }, + "description": "Salesforce REST API version 28.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 19, + "fingerprint": "sha256:f3d260b9acef562eaf5f530d3a253176d878d7788bf827441745ee93b32c6787", + "api": "salesforce", + "version": "29.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v29.0/" + }, + "description": "Salesforce REST API version 29.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 20, + "fingerprint": "sha256:01ccee5cbdd725ba99be6328151e1366be0efa49d6431a3b0e93bb09a3676131", + "api": "salesforce", + "version": "30.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v30.0/" + }, + "description": "Salesforce REST API version 30.0 is retired, as of Summer ’25: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 21, + "fingerprint": "sha256:e9867faae1b6920e6c39cedeaf143997102f9a91d9515a442e1cc4f9cffae820", + "api": "salesforce", + "version": "7.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v7.0/" + }, + "description": "Salesforce REST API version 7.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 22, + "fingerprint": "sha256:d35aebdfad2134fd75a451817b2a347633eed5d94a53e96b1665bb800d557863", + "api": "salesforce", + "version": "8.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v8.0/" + }, + "description": "Salesforce REST API version 8.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 23, + "fingerprint": "sha256:f5af0d2c541f41c371b8dbfe80cb9abeedb7758c6fd8a79d0251c1b763578549", + "api": "salesforce", + "version": "9.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v9.0/" + }, + "description": "Salesforce REST API version 9.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 24, + "fingerprint": "sha256:1975b2eb2a035e983a81cfe32fa432edaa62ec0ab7b1d7aea1b542f194ca6170", + "api": "salesforce", + "version": "10.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v10.0/" + }, + "description": "Salesforce REST API version 10.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 25, + "fingerprint": "sha256:39d1421f1d4675f662bd0d3e984fd813de2ba740438c09d9ecdd96f9c5e517cc", + "api": "salesforce", + "version": "11.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v11.0/" + }, + "description": "Salesforce REST API version 11.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 26, + "fingerprint": "sha256:9a3cb32fac90139da92e6e9de3e67261309654ee5ee2fc0f149133af811ad96e", + "api": "salesforce", + "version": "12.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v12.0/" + }, + "description": "Salesforce REST API version 12.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 27, + "fingerprint": "sha256:ac37dc2324273bc9523c0ff620f7de402ad0e6350d930c9f6f2d4c3644e2a956", + "api": "salesforce", + "version": "13.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v13.0/" + }, + "description": "Salesforce REST API version 13.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 28, + "fingerprint": "sha256:4364f685eb1cb5b90db0a979bc329dc7df0a03ca0e85626c981a5119f0acdd41", + "api": "salesforce", + "version": "14.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v14.0/" + }, + "description": "Salesforce REST API version 14.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 29, + "fingerprint": "sha256:c26fd727091b806bd34d1761e4b7801d24256e7567e9c65dd41171c6e3b7b1ff", + "api": "salesforce", + "version": "15.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v15.0/" + }, + "description": "Salesforce REST API version 15.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 30, + "fingerprint": "sha256:0241eda116305ecfd420fa6f42900e4db478297db732a21beff08b1e21ae96b6", + "api": "salesforce", + "version": "16.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v16.0/" + }, + "description": "Salesforce REST API version 16.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 31, + "fingerprint": "sha256:b95ba1dc0afc72b21b40e934ec2d8549da5bf406a5cae9feaba94e7a0fb7ec63", + "api": "salesforce", + "version": "17.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v17.0/" + }, + "description": "Salesforce REST API version 17.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 32, + "fingerprint": "sha256:44912e7a1618ccf57e957a8219609236f6757381eb4f590c66f95978fffe5af2", + "api": "salesforce", + "version": "18.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v18.0/" + }, + "description": "Salesforce REST API version 18.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 33, + "fingerprint": "sha256:94cefbc9eb19323ce7fcf84fc0ee7b2f0a9064046959c52c64bfa755e3ba13c6", + "api": "salesforce", + "version": "19.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v19.0/" + }, + "description": "Salesforce REST API version 19.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + }, + { + "id": 34, + "fingerprint": "sha256:8f15f28dabaee09688f5588d5c939c72053f0c6002bb4c239c48eb22ba20e3cc", + "api": "salesforce", + "version": "20.0", + "change_type": "breaking", + "breaking": true, + "subject": { + "type": "api_operation", + "kind": "operation", + "side": "request", + "operation": "GET /services/data/v20.0/" + }, + "description": "Salesforce REST API version 20.0 is retired, as of Summer ’22: it returns 410:GONE for every resource.", + "migration_hint": "Pin a newer Salesforce REST API version: https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html names which ones are still supported.", + "source_url": "https://web.archive.org/web/20261114120000/https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html", + "source_excerpt": "Versions 7.0 through 20.0 | As of Summer ’22, these versions are retired and unavailable.", + "confidence": 1, + "detected_at": "2026-11-14T12:00:00Z" + } +] diff --git a/plugins/eol/testdata/salesforce-api-rest-eol-2026-10-31.html b/plugins/eol/testdata/salesforce-api-rest-eol-2026-10-31.html new file mode 100644 index 0000000..afd1c70 --- /dev/null +++ b/plugins/eol/testdata/salesforce-api-rest-eol-2026-10-31.html @@ -0,0 +1,80 @@ +

Salesforce is committed to supporting each API version for a minimum of 3 years from the date of first release. To improve the quality and performance of the API, versions that are over 3 years old sometimes are no longer supported.

+

Salesforce notifies customers who use an API version scheduled for deprecation at least 1 year before support for the version ends.

+

++ ++ ++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Salesforce API Versions + + Version Support Status + + Version Retirement Info +
+ Versions 41.0 through + 67.0 + + Supported. + +   +
+ Versions 31.0 through 40.0 + +

+ Supported. +

+

+ Deprecated and unsupported from Summer ’27. +

+

+ Retired from Summer ’28. +

+
+ Salesforce Platform API Versions 31.0 through 40.0 Retirement +
+ Versions 21.0 through 30.0 + + As of Summer ’25, these versions are retired and unavailable. + + Salesforce Platform API Versions 21.0 through 30.0 Retirement +
+ Versions 7.0 through 20.0 + + As of Summer ’22, these versions are retired and unavailable. + + Salesforce Platform API Versions 7.0 through 20.0 Retirement +
+

If you request any resource or use an operation from a retired API version, REST API returns the 410:GONE error code.

+

To identify requests made from old or unsupported API versions, use the API Total Usage event type.

\ No newline at end of file diff --git a/providers/README.md b/providers/README.md index 7a00e40..89677b9 100644 --- a/providers/README.md +++ b/providers/README.md @@ -36,5 +36,6 @@ One page per plugin id: `providers/.md`. Start from [`_template.md`](_templ | [redis.md](redis.md) | `redis` | `catalog` | | [cloudflare.md](cloudflare.md) | `cloudflare` | `feed` | | [mongodb-atlas.md](mongodb-atlas.md) | `mongodb-atlas` | `apichangelog` | +| [salesforce.md](salesforce.md) | `salesforce` | `eol` | The list of plugins, with their status, is [docs/plugins.md](../docs/plugins.md). diff --git a/providers/salesforce.md b/providers/salesforce.md new file mode 100644 index 0000000..5ba31ee --- /dev/null +++ b/providers/salesforce.md @@ -0,0 +1,38 @@ +# Salesforce (`salesforce`) + +## What it watches + +Salesforce's REST API version policy: whole numbered API version ranges (`/services/data/vNN.N/`) that Salesforce's own end-of-life page says are already retired (every resource under that version returns `410:GONE`) or scheduled to be. + +Format plugin: `eol` (`plugins/eol`), with the `Salesforce` page. + +## Why this source + +- **Source:** [API End-of-Life Policy](https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html), Salesforce's own table of REST API version ranges and their support status. The live page 403s a plain fetch (bot-protected), so it's read through a Wayback Machine snapshot, same as `retirements` and `feed`. Checked 2026-11-20 (page crawled 2026-10-31). +- **Why this one:** it's the only place Salesforce states, in one page, which whole version ranges still work, which are scheduled to stop, and which already have. Salesforce's own policy text above the table: "Salesforce is committed to supporting each API version for a minimum of 3 years from the date of first release... Salesforce notifies customers who use an API version scheduled for deprecation at least 1 year before support for the version ends." +- **Alternatives considered:** + - **A changelog or RSS/Atom feed.** None found. Salesforce Help's release notes (HTML and PDF, three times a year: Spring, Summer, Winter) cover new features and, inconsistently, "Critical Updates" with their own auto-activation dates, but as prose spread across hundreds of pages per release, not a page or feed keyed by what changed in the API. No official feed of any of this exists. + - **An OpenAPI spec.** Salesforce publishes no stable, versioned one. There's a beta, on-demand generator (`POST .../async/specifications/oas3`) for the sObjects REST API only, explicitly "subject to change... Don't build production integrations based on this," generated live per org and not pinned to a release, so there's nothing to diff between two points in time. + - **Official Python and JS/TS SDKs for the REST API.** Checked 2026-11-20: Salesforce publishes none. `simple-salesforce` (PyPI) and `jsforce` (npm) are the community-maintained libraries almost everyone actually uses, but they're not Salesforce's own, so a breaking change in either is about the library, not the API; left for a future, separate client-library plugin if either becomes worth watching on its own. Salesforce does maintain its own SDKs for other surfaces (the `sf` CLI, Lightning Web Components), just not a general REST/SOAP API client. + - **The retirement-detail sub-pages** the main table links to (e.g. "Salesforce Platform API Versions 31.0 through 40.0 Retirement"), each its own Salesforce Help article. The main page already states the same range, status and season; reading only it keeps one source of truth and one snapshot per run. +- **Quote:** "As of Summer ’25, these versions are retired and unavailable." (versions 21.0 through 30.0, a real, already-happened retirement) + +## How the provider announces changes + +- **Versioned by path, numbered, incrementing:** `/services/data/vNN.N/...` (currently up to v67.0; a new major number roughly every release, three times a year). `GET /services/data/vNN.N/` ("List Available REST Resources") is the one resource that exists at every version and nothing else, so it's this plugin's one honest, documented `operation` to cite for "this whole version is gone." +- **No exact date, only a named release:** "Summer '27", not a calendar date. Salesforce's exact production rollout for a named release is staggered across weekends per instance (confirmed by cross-checking Salesforce's own admin blog against three others, which disagree on the exact weekend), so there is no single verifiable day to convert "Summer '27" into; the event's `version` is the API version number, and the season name is quoted, not guessed into a date. +- **Three years minimum per version, one year's notice before deprecation,** per the policy text above the table. + +## What the plugin reads and ignores + +- **Reads** every row of the end-of-life table: a version range, and its status cell. A range already described as retired ("As of Summer 'XX, these versions are retired and unavailable.") becomes a `breaking` event per version number in the range; a range with both a deprecation and a retirement sentence ("Deprecated and unsupported from Summer 'XX. Retired from Summer 'YY.") becomes a `deprecation` event per version number. One event per version number, not one per range, so a repo pinned to one specific version is matched directly. +- **Ignores** a row that only says "Supported." (on the live page, 2026-11-20: versions 41.0 through 67.0) — nothing to report, and the pinned drop test. +- **Cites** the Wayback snapshot, with the row's version-range label and its full status text as the excerpt. +- On the page saved 2026-10-31 this gives 34 events: 10 deprecations (versions 31.0–40.0) and 24 already-breaking (versions 7.0–30.0, both past retirement bands). + +## Known gaps + +- **No per-operation or per-field changes.** This plugin only sees whole-version retirement; a field or resource removed within a still-supported version (the kind GitHub's or GitLab's `openapi` plugin would catch, if Salesforce had a stable spec to diff) isn't watched. +- **Critical Updates aren't watched.** These are Salesforce's other real mechanism for staged breaking changes (an org-level toggle that eventually activates by default, then becomes mandatory), but there's no single, official, publicly dated list of them across releases to read; only the per-org Setup page and third-party trackers exist. +- **The community SDKs (`simple-salesforce`, `jsforce`) aren't watched,** even though they're what most Python and JS code calling Salesforce actually uses (see Alternatives considered). +- **The client fix is a version bump, not a code search.** Unlike an operation or parameter removal, there's no single call site to point at: the fix is "pin a newer API version" wherever the repo's SDK, base URL or `Accept`/version header names the retiring one. From 185cca093bb486cbe0eac9ba6aab2fb69e04540d Mon Sep 17 00:00:00 2001 From: AbdullahT01 Date: Fri, 20 Nov 2026 00:11:42 -0500 Subject: [PATCH 2/3] eol: fall back to the Wayback Machine when the live page is blocked Signed-off-by: AbdullahT01 --- plugins/eol/eol.go | 59 ++++++++++++++++++++++++++++++++++------- plugins/eol/eol_test.go | 52 ++++++++++++++++++++++++++++++++++++ providers/salesforce.md | 3 ++- 3 files changed, 104 insertions(+), 10 deletions(-) diff --git a/plugins/eol/eol.go b/plugins/eol/eol.go index eae7a98..1002573 100644 --- a/plugins/eol/eol.go +++ b/plugins/eol/eol.go @@ -4,14 +4,26 @@ // (deprecation); a row that only says "Supported." names nothing to report. // // There is no spec to diff, like retirements and feed: the page is read as it -// is now, and the events cite a Wayback Machine snapshot of it, never the -// live page (kit/). Unlike retirements (one named model per row) and feed -// (an RSS or Atom entry), a row here names a whole range of version numbers -// and no replacement: moving up to any newer version clears it. +// is now, and (as with them) the events cite a Wayback Machine snapshot of +// it, taken after a successful read of the live page, so the citation always +// says what the plugin actually saw. +// +// Salesforce's docs site is the one difference from retirements and feed: it +// answers 403 to a plain GET (checked 2026-11-20, including with a browser +// User-Agent), so Run's direct read of the live page fails every time. The +// Wayback Machine's own save-page-now request succeeds against it anyway +// (checked the same day), so Run falls back to a fresh snapshot, used +// directly as both the content and its own citation, kit.Cite's +// double-check skipped: there is no separate live read left to agree with. +// +// Unlike retirements (one named model per row) and feed (an RSS or Atom +// entry), a row here names a whole range of version numbers and no +// replacement: moving up to any newer version clears it. package eol import ( "context" + "errors" "fmt" "log" "regexp" @@ -19,6 +31,7 @@ import ( "strings" "github.com/patch-it-dev/patch-it-plugins/event" + "github.com/patch-it-dev/patch-it-plugins/fetch" "github.com/patch-it-dev/patch-it-plugins/kit" "github.com/patch-it-dev/patch-it-plugins/plugin" ) @@ -165,10 +178,10 @@ type Plugin struct { func (p Plugin) Name() string { return p.Page.API } // Run reads the page as it is now. An unchanged page since the last run costs -// one GET and no snapshot. +// one GET and no snapshot, unless the live page is blocked: see liveOrArchived. func (p Plugin) Run(ctx context.Context, env plugin.Env) (plugin.Result, error) { pg := p.Page - live, err := env.Get(ctx, pg.URL) + live, archived, err := liveOrArchived(ctx, env, p.Archiver, pg.URL) if err != nil { return plugin.Result{}, fmt.Errorf("fetching %s: %w", pg.URL, err) } @@ -186,9 +199,13 @@ func (p Plugin) Run(ctx context.Context, env plugin.Env) (plugin.Result, error) if err != nil { return plugin.Result{}, fmt.Errorf("reading %s: %w", pg.URL, err) } - snapURL, snap, got, err := kit.Cite(ctx, p.Archiver, pg.URL, Findings, want) - if err != nil { - return plugin.Result{}, err + + snapURL, snap, got := archived, live, want + if snapURL == "" { + snapURL, snap, got, err = kit.Cite(ctx, p.Archiver, pg.URL, Findings, want) + if err != nil { + return plugin.Result{}, err + } } now := env.Now().UTC() @@ -229,6 +246,30 @@ func (p Plugin) Run(ctx context.Context, env plugin.Env) (plugin.Result, error) return plugin.Result{Label: snapURL, Events: events, Rejected: rejected, Baselines: []plugin.Spec{baseline}}, nil } +// liveOrArchived reads pageURL directly. When the provider blocks a plain +// fetch with a 4xx (Salesforce's docs site, every time, checked 2026-11-20), +// it falls back to a fresh Wayback Machine snapshot, taken right now by the +// archive's own crawler rather than patch-it's, and returns that content +// with its own permanent URL in archivedURL: it needs no further citation +// step, having come from the archive already. A non-4xx error (a timeout, a +// 5xx) is returned as is: retrying it against the archive would hide a +// transient failure as a real page, not fix one. +func liveOrArchived(ctx context.Context, env plugin.Env, a kit.Archiver, pageURL string) (body []byte, archivedURL string, err error) { + body, err = env.Get(ctx, pageURL) + if err == nil { + return body, "", nil + } + var se *fetch.StatusError + if !errors.As(err, &se) || se.StatusCode < 400 || se.StatusCode >= 500 { + return nil, "", err + } + archivedURL, body, archErr := a.Snapshot(ctx, pageURL) + if archErr != nil { + return nil, "", fmt.Errorf("fetching it directly failed (%w), and so did asking the Wayback Machine to: %w", err, archErr) + } + return body, archivedURL, nil +} + func describe(pg Page, f Finding) string { if f.ChangeType == event.ChangeTypeBreaking { return fmt.Sprintf("%s REST API version %s is retired, as of %s: it returns 410:GONE for every resource.", pg.Vendor, f.Version, f.Season) diff --git a/plugins/eol/eol_test.go b/plugins/eol/eol_test.go index d1a53b1..c66caf2 100644 --- a/plugins/eol/eol_test.go +++ b/plugins/eol/eol_test.go @@ -1,10 +1,14 @@ package eol import ( + "context" "fmt" "testing" + "time" + "github.com/patch-it-dev/patch-it-plugins/fetch" "github.com/patch-it-dev/patch-it-plugins/kit/kittest" + "github.com/patch-it-dev/patch-it-plugins/plugin" ) func TestRegistersItself(t *testing.T) { @@ -54,3 +58,51 @@ func TestDropsAStillSupportedBand(t *testing.T) { t.Error("the still-supported band wasn't found and dropped") } } + +// Salesforce's docs site answers 403 to a plain GET; the live page is never +// reachable through env.Get. Run must fall back to the Wayback Machine's own +// fetch and use its snapshot directly, not fail outright. +func TestFallsBackToTheArchiveWhenTheLiveFetchIs403d(t *testing.T) { + saved := kittest.Pages{Salesforce.URL: "testdata/salesforce-api-rest-eol-2026-10-31.html"} + archive := &kittest.Archive{T: t, Pages: saved} + mem := kittest.NewMem() + env := plugin.Env{ + Baselines: mem, + Get: func(context.Context, string) ([]byte, error) { + return nil, &fetch.StatusError{URL: Salesforce.URL, StatusCode: 403} + }, + Now: func() time.Time { return kittest.Clock }, + } + got := kittest.IngestWith(t, env, Plugin{Page: Salesforce, Archiver: archive}) + if len(got) == 0 { + t.Fatal("no events: the archive fallback didn't run") + } + // Unlike the normal path, a permanently blocked live page has no cheap + // way to check "did it change": liveOrArchived needs the archive's own + // fetch just to get bytes to hash, on every run, not only a changed one. + // The second run still stores nothing new: the hash matches. + if archive.Calls != 2 { + t.Errorf("%d snapshots, want 2: the live page is blocked every run", archive.Calls) + } + for _, e := range got { + if e.SourceURL == Salesforce.URL { + t.Errorf("%s: source_url is the blocked live page, want the archive's snapshot", e.Fingerprint) + } + } +} + +// A real failure (not the provider's own 403) must stay a failure: falling +// back to the archive for a timeout or a 5xx would hide it as a real page. +func TestDoesNotFallBackOnATransientError(t *testing.T) { + env := plugin.Env{ + Baselines: kittest.NewMem(), + Get: func(context.Context, string) ([]byte, error) { + return nil, &fetch.StatusError{URL: Salesforce.URL, StatusCode: 503} + }, + Now: func() time.Time { return kittest.Clock }, + } + _, err := Plugin{Page: Salesforce, Archiver: &kittest.Archive{T: t}}.Run(context.Background(), env) + if err == nil { + t.Fatal("want an error for a 503, got none") + } +} diff --git a/providers/salesforce.md b/providers/salesforce.md index 5ba31ee..4e7b7b6 100644 --- a/providers/salesforce.md +++ b/providers/salesforce.md @@ -8,7 +8,7 @@ Format plugin: `eol` (`plugins/eol`), with the `Salesforce` page. ## Why this source -- **Source:** [API End-of-Life Policy](https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html), Salesforce's own table of REST API version ranges and their support status. The live page 403s a plain fetch (bot-protected), so it's read through a Wayback Machine snapshot, same as `retirements` and `feed`. Checked 2026-11-20 (page crawled 2026-10-31). +- **Source:** [API End-of-Life Policy](https://developer.salesforce.com/docs/platform/api-rest/guide/api-rest-eol.html), Salesforce's own table of REST API version ranges and their support status. Checked 2026-11-20: a plain GET of the live page gets a 403 every time, including with a browser `User-Agent`, so `env.Get` always fails here. The Wayback Machine's own save-page-now request succeeds against the same URL anyway (checked the same day), so this plugin falls back to a fresh snapshot when the direct read is blocked, and reads and cites that snapshot directly: unlike `retirements` and `feed`, which read the live page first and only snapshot it afterward to cite, there's no live read here to cite alongside. - **Why this one:** it's the only place Salesforce states, in one page, which whole version ranges still work, which are scheduled to stop, and which already have. Salesforce's own policy text above the table: "Salesforce is committed to supporting each API version for a minimum of 3 years from the date of first release... Salesforce notifies customers who use an API version scheduled for deprecation at least 1 year before support for the version ends." - **Alternatives considered:** - **A changelog or RSS/Atom feed.** None found. Salesforce Help's release notes (HTML and PDF, three times a year: Spring, Summer, Winter) cover new features and, inconsistently, "Critical Updates" with their own auto-activation dates, but as prose spread across hundreds of pages per release, not a page or feed keyed by what changed in the API. No official feed of any of this exists. @@ -36,3 +36,4 @@ Format plugin: `eol` (`plugins/eol`), with the `Salesforce` page. - **Critical Updates aren't watched.** These are Salesforce's other real mechanism for staged breaking changes (an org-level toggle that eventually activates by default, then becomes mandatory), but there's no single, official, publicly dated list of them across releases to read; only the per-org Setup page and third-party trackers exist. - **The community SDKs (`simple-salesforce`, `jsforce`) aren't watched,** even though they're what most Python and JS code calling Salesforce actually uses (see Alternatives considered). - **The client fix is a version bump, not a code search.** Unlike an operation or parameter removal, there's no single call site to point at: the fix is "pin a newer API version" wherever the repo's SDK, base URL or `Accept`/version header names the retiring one. +- **Every run costs one Wayback snapshot, not only a changed one.** The live page being permanently blocked means there's no cheap direct GET to check "did it change" first; `retirements` and `feed` only pay for a snapshot on the rare run that sees a real change. From cf9887b689b143987125239bdf416e3d9e0bf46f Mon Sep 17 00:00:00 2001 From: AbdullahT01 Date: Fri, 20 Nov 2026 00:37:09 -0500 Subject: [PATCH 3/3] eol: verify the archive capture parses, narrow the fallback, address review nits Signed-off-by: AbdullahT01 --- plugin/plugin.go | 10 ++++- plugins/eol/eol.go | 56 +++++++++++++++---------- plugins/eol/eol_test.go | 90 +++++++++++++++++++++++------------------ providers/salesforce.md | 2 + 4 files changed, 95 insertions(+), 63 deletions(-) diff --git a/plugin/plugin.go b/plugin/plugin.go index 80ed242..14e919c 100644 --- a/plugin/plugin.go +++ b/plugin/plugin.go @@ -40,8 +40,14 @@ type Replayer interface { // that client instead. type Env struct { Baselines BaselineReader - Get func(ctx context.Context, url string) ([]byte, error) - Now func() time.Time + // Get fetches one URL. In both the hosted ingestion service and the test + // kit, this is fetch.Cache.Get (kit/kittest's Pages.Get wraps saved files + // the same way): a non-2xx, non-304 response fails with a *fetch.StatusError + // naming the status, returned as is, so errors.As finds it. A plugin that + // branches on the status (eol, when the provider's own site blocks a plain + // GET) can rely on that. + Get func(ctx context.Context, url string) ([]byte, error) + Now func() time.Time } // BaselineReader is the one thing a plugin reads back: the baseline its last diff --git a/plugins/eol/eol.go b/plugins/eol/eol.go index 1002573..e6e415d 100644 --- a/plugins/eol/eol.go +++ b/plugins/eol/eol.go @@ -11,9 +11,10 @@ // Salesforce's docs site is the one difference from retirements and feed: it // answers 403 to a plain GET (checked 2026-11-20, including with a browser // User-Agent), so Run's direct read of the live page fails every time. The -// Wayback Machine's own save-page-now request succeeds against it anyway -// (checked the same day), so Run falls back to a fresh snapshot, used -// directly as both the content and its own citation, kit.Cite's +// Wayback Machine's own save-page-now request succeeds against it anyway, +// and its capture parses to the same findings the live page would (checked +// the same day), so Run falls back to a fresh snapshot on a 401 or 403, +// used directly as both the content and its own citation, kit.Cite's // double-check skipped: there is no separate live read left to agree with. // // Unlike retirements (one named model per row) and feed (an RSS or Atom @@ -70,6 +71,7 @@ var Salesforce = Page{ // Row is one version range and what its status cell says, cleaned of HTML. type Row struct { From, To int // inclusive, both ends; From == To for a single version + Label string // the first cell's own text, word for word ("Versions 31.0 through 40.0") Status string // every

in the status cell, joined with a space } @@ -85,10 +87,16 @@ type Finding struct { } var ( - table = regexp.MustCompile(`(?is)(.*?)`) - row = regexp.MustCompile(`(?is)(.*?)`) - cell = regexp.MustCompile(`(?is)(.*?)`) - tag = regexp.MustCompile(`<[^>]+>`) + table = regexp.MustCompile(`(?is)(.*?)`) + row = regexp.MustCompile(`(?is)(.*?)`) + // cell tolerates an attribute (): a future style change + // shouldn't make every row unreadable. + cell = regexp.MustCompile(`(?is)]*>(.*?)`) + tag = regexp.MustCompile(`<[^>]+>`) + // versions reads only the whole-number part of a version ("31.0 through + // 40.0" -> 31, 40): every version on the page today is a whole number. + // Salesforce has never shipped a minor REST API version, but this would + // silently drop one ("31.5") rather than fail loudly if that changed. versions = regexp.MustCompile(`(?i)Versions?\s+(\d+)(?:\.\d+)?(?:\s+through\s+(\d+)(?:\.\d+)?)?`) retired = regexp.MustCompile(`(?i)As of ([^,]+), these versions are retired and unavailable\.`) deprecd = regexp.MustCompile(`(?i)Deprecated and unsupported from ([^.]+)\.\s*Retired from ([^.]+)\.`) @@ -112,7 +120,8 @@ func Parse(page []byte) ([]Row, error) { if len(cells) < 2 { continue } - vm := versions.FindStringSubmatch(text(cells[0][1])) + label := text(cells[0][1]) + vm := versions.FindStringSubmatch(label) if vm == nil { continue } @@ -121,7 +130,7 @@ func Parse(page []byte) ([]Row, error) { if vm[2] != "" { to, _ = strconv.Atoi(vm[2]) } - out = append(out, Row{From: from, To: to, Status: text(cells[1][1])}) + out = append(out, Row{From: from, To: to, Label: label, Status: text(cells[1][1])}) } if len(out) == 0 { return nil, fmt.Errorf("no version rows found: the page's shape may have changed") @@ -138,10 +147,7 @@ func Findings(page []byte) ([]Finding, error) { } var out []Finding for _, r := range rows { - label := fmt.Sprintf("Versions %d.0 through %d.0", r.From, r.To) - if r.From == r.To { - label = fmt.Sprintf("Version %d.0", r.From) - } + label := r.Label excerpt := label + " | " + r.Status var ct event.ChangeType @@ -246,21 +252,27 @@ func (p Plugin) Run(ctx context.Context, env plugin.Env) (plugin.Result, error) return plugin.Result{Label: snapURL, Events: events, Rejected: rejected, Baselines: []plugin.Spec{baseline}}, nil } -// liveOrArchived reads pageURL directly. When the provider blocks a plain -// fetch with a 4xx (Salesforce's docs site, every time, checked 2026-11-20), -// it falls back to a fresh Wayback Machine snapshot, taken right now by the -// archive's own crawler rather than patch-it's, and returns that content -// with its own permanent URL in archivedURL: it needs no further citation -// step, having come from the archive already. A non-4xx error (a timeout, a -// 5xx) is returned as is: retrying it against the archive would hide a -// transient failure as a real page, not fix one. +// liveOrArchived reads pageURL directly. When the provider's own site +// blocks a plain fetch with 401 or 403 (Salesforce's docs site, every time, +// checked 2026-11-20; confirmed the same day that a real Wayback Machine +// save-page-now capture of this exact page parses to the same findings as +// the live page would), it falls back to a fresh Wayback Machine snapshot, +// taken right now by the archive's own crawler rather than patch-it's, and +// returns that content with its own permanent URL in archivedURL: it needs +// no further citation step, having come from the archive already. +// +// Only 401 and 403 fall back. A 404 or 410 means the page moved, not that +// it's blocked: asking the archive to snapshot a page that's gone would +// waste the call and hide the real cause behind the archive's own error. +// A 429 or a 5xx is returned as is: retrying it against the archive would +// hide a transient failure as a real page, not fix one. func liveOrArchived(ctx context.Context, env plugin.Env, a kit.Archiver, pageURL string) (body []byte, archivedURL string, err error) { body, err = env.Get(ctx, pageURL) if err == nil { return body, "", nil } var se *fetch.StatusError - if !errors.As(err, &se) || se.StatusCode < 400 || se.StatusCode >= 500 { + if !errors.As(err, &se) || (se.StatusCode != 401 && se.StatusCode != 403) { return nil, "", err } archivedURL, body, archErr := a.Snapshot(ctx, pageURL) diff --git a/plugins/eol/eol_test.go b/plugins/eol/eol_test.go index c66caf2..fbdf736 100644 --- a/plugins/eol/eol_test.go +++ b/plugins/eol/eol_test.go @@ -61,48 +61,60 @@ func TestDropsAStillSupportedBand(t *testing.T) { // Salesforce's docs site answers 403 to a plain GET; the live page is never // reachable through env.Get. Run must fall back to the Wayback Machine's own -// fetch and use its snapshot directly, not fail outright. -func TestFallsBackToTheArchiveWhenTheLiveFetchIs403d(t *testing.T) { - saved := kittest.Pages{Salesforce.URL: "testdata/salesforce-api-rest-eol-2026-10-31.html"} - archive := &kittest.Archive{T: t, Pages: saved} - mem := kittest.NewMem() - env := plugin.Env{ - Baselines: mem, - Get: func(context.Context, string) ([]byte, error) { - return nil, &fetch.StatusError{URL: Salesforce.URL, StatusCode: 403} - }, - Now: func() time.Time { return kittest.Clock }, - } - got := kittest.IngestWith(t, env, Plugin{Page: Salesforce, Archiver: archive}) - if len(got) == 0 { - t.Fatal("no events: the archive fallback didn't run") - } - // Unlike the normal path, a permanently blocked live page has no cheap - // way to check "did it change": liveOrArchived needs the archive's own - // fetch just to get bytes to hash, on every run, not only a changed one. - // The second run still stores nothing new: the hash matches. - if archive.Calls != 2 { - t.Errorf("%d snapshots, want 2: the live page is blocked every run", archive.Calls) - } - for _, e := range got { - if e.SourceURL == Salesforce.URL { - t.Errorf("%s: source_url is the blocked live page, want the archive's snapshot", e.Fingerprint) - } +// fetch and use its snapshot directly, not fail outright. 401 falls back the +// same way. +func TestFallsBackToTheArchiveWhenTheLiveFetchIsBlocked(t *testing.T) { + for _, code := range []int{401, 403} { + t.Run(fmt.Sprint(code), func(t *testing.T) { + saved := kittest.Pages{Salesforce.URL: "testdata/salesforce-api-rest-eol-2026-10-31.html"} + archive := &kittest.Archive{T: t, Pages: saved} + env := plugin.Env{ + Baselines: kittest.NewMem(), + Get: func(context.Context, string) ([]byte, error) { + return nil, &fetch.StatusError{URL: Salesforce.URL, StatusCode: code} + }, + Now: func() time.Time { return kittest.Clock }, + } + got := kittest.IngestWith(t, env, Plugin{Page: Salesforce, Archiver: archive}) + if len(got) == 0 { + t.Fatal("no events: the archive fallback didn't run") + } + // Unlike the normal path, a permanently blocked live page has no + // cheap way to check "did it change": liveOrArchived needs the + // archive's own fetch just to get bytes to hash, on every run, + // not only a changed one. The second run still stores nothing + // new: the hash matches. + if archive.Calls != 2 { + t.Errorf("%d snapshots, want 2: the live page is blocked every run", archive.Calls) + } + for _, e := range got { + if e.SourceURL == Salesforce.URL { + t.Errorf("%s: source_url is the blocked live page, want the archive's snapshot", e.Fingerprint) + } + } + }) } } -// A real failure (not the provider's own 403) must stay a failure: falling -// back to the archive for a timeout or a 5xx would hide it as a real page. +// A real failure (not the provider blocking a plain fetch) must stay a +// failure: falling back to the archive for a timeout or a 5xx would hide it +// as a real page. func TestDoesNotFallBackOnATransientError(t *testing.T) { - env := plugin.Env{ - Baselines: kittest.NewMem(), - Get: func(context.Context, string) ([]byte, error) { - return nil, &fetch.StatusError{URL: Salesforce.URL, StatusCode: 503} - }, - Now: func() time.Time { return kittest.Clock }, - } - _, err := Plugin{Page: Salesforce, Archiver: &kittest.Archive{T: t}}.Run(context.Background(), env) - if err == nil { - t.Fatal("want an error for a 503, got none") + for _, code := range []int{404, 429, 503} { + t.Run(fmt.Sprint(code), func(t *testing.T) { + env := plugin.Env{ + Baselines: kittest.NewMem(), + Get: func(context.Context, string) ([]byte, error) { + return nil, &fetch.StatusError{URL: Salesforce.URL, StatusCode: code} + }, + Now: func() time.Time { return kittest.Clock }, + } + // No Pages: a fallback here would fail the test by asking the + // archive for a snapshot it was never given. + _, err := Plugin{Page: Salesforce, Archiver: &kittest.Archive{T: t}}.Run(context.Background(), env) + if err == nil { + t.Fatalf("want an error for a %d, got none", code) + } + }) } } diff --git a/providers/salesforce.md b/providers/salesforce.md index 4e7b7b6..1396a1b 100644 --- a/providers/salesforce.md +++ b/providers/salesforce.md @@ -37,3 +37,5 @@ Format plugin: `eol` (`plugins/eol`), with the `Salesforce` page. - **The community SDKs (`simple-salesforce`, `jsforce`) aren't watched,** even though they're what most Python and JS code calling Salesforce actually uses (see Alternatives considered). - **The client fix is a version bump, not a code search.** Unlike an operation or parameter removal, there's no single call site to point at: the fix is "pin a newer API version" wherever the repo's SDK, base URL or `Accept`/version header names the retiring one. - **Every run costs one Wayback snapshot, not only a changed one.** The live page being permanently blocked means there's no cheap direct GET to check "did it change" first; `retirements` and `feed` only pay for a snapshot on the rare run that sees a real change. +- **A baseline could churn without any event changing.** The hash that decides "unchanged" is taken from the archive's captured bytes, not Salesforce's own. If a future capture ever varies by a few bytes that aren't the table (a nonce, a timestamp the page itself injects), a new baseline would be saved every run even though nothing the plugin reads changed. No event would duplicate: each one's fingerprint is unaffected. Not seen as of 2026-11-20's capture. +- **Repeated Wayback save-page-now calls could start rate-limiting.** One a day, on patch-it's schedule, is fine; if this plugin ever ran much more often, the archive might answer slower or serve an older capture instead of a fresh one. An older capture is still real and dated, so this is a speed concern, not a precision one.