@particle-academy/fancy-connector-core 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -6,6 +6,37 @@ All notable changes to `fancy-connector-core` are documented here, in
 **This package is pre-1.0, so breaking changes land in MINOR releases.** The
 version number is not a promise it can keep yet; the entries below are.
 
+## [0.6.2] - 2026-09-14
+
+### Fixed
+
+- **Three remedies that could not be followed are gone, and a test now refuses
+  any string that names a command, package or script that does not exist.**
+  `ConnectorApiMismatch` for a connector behind the window told the reader to
+  run `npx fancy-cli@latest add connector <id>` — there is no such command; it
+  now says to move the connector to a release written for this core (upgrade
+  its `-js`/`-php` package, or regenerate a vendored copy from that release).
+  `index.ts` opened by naming `@particle-academy/fancy-connectors`, a package
+  that was never published and whose vendored catalogue is retired (the owner,
+  2026-09-14 — every connector is a generated package from the Fancy-Friends
+  estate, and this core is Weaver's). And the banner `scripts/vendor.mjs`
+  writes into every generated file said to re-run `php artisan flow:build`,
+  which regenerates nothing; it now names `vendor.mjs` itself. **What to do:**
+  nothing at runtime; a host carrying a vendored `_connector` copy regenerates
+  it with `node scripts/vendor.mjs --target <dir>` on its next core update, and
+  its drift check will say so.
+
+## [0.6.1] - 2026-09-13
+
+### Fixed
+
+- **`ConnectorError` declares `attempts` and `idempotent` on its type.** A failed
+  call has attached both since 0.5.0, but the class never declared them, so
+  TypeScript refused `error.attempts` and the README taught a cast. They are
+  `declare` fields: nothing changes at runtime, and an error that did not end a
+  call still has no such property. **What to do:** nothing; a cast you added
+  still compiles and can go.
+
 ## [0.6.0] - 2026-09-13
 
 Additive only. **What a consumer must DO: nothing** — see each entry.

package/README.md

@@ -1,5 +1,7 @@
 # fancy-connector-core
 
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
 **The runtime under every Fancy connector.** Modes and estates, connections, one
 call path, a failure taxonomy that knows the difference between *it never
 arrived* and *nobody can tell*, deterministic fakers, webhook verification, pure
@@ -84,10 +86,8 @@ try {
   error.kind;          // the retry primitive
   error.providerCode;  // only where the service declared `providerCodeFrom`
   error.cause;         // the classified error; for a thrown transport, the original below it
-  // Set at runtime but not declared on the `ConnectorError` type, so read them
-  // through a narrowing of your own:
-  (error as { attempts?: Attempt[] }).attempts;       // every failed attempt of the call, in order
-  (error as { idempotent?: boolean }).idempotent;     // what the call declared — "never allowed to retry" vs "retries ran out"
+  error.attempts;      // every failed attempt of the call, in order
+  error.idempotent;    // what the call declared — "never allowed to retry" vs "retries ran out"
 }
 ```
 
@@ -222,7 +222,9 @@ entirely. That is the whole argument.
 
 - [`AGENTS.md`](./AGENTS.md) — the invariants, the traps, and what a change here
   breaks.
-- `.ai/plans/fancy-connectors.md` in the envelope — the architecture, the
-  Socialite seam, the drift research, and every decision with its reason.
+- `RULES.md` in [`Fancy-Friends/weaver.agi`](https://github.com/Fancy-Friends/weaver.agi)
+  — the estate every connector is generated from (one definition → four
+  packages), its invariants, and the process rules this core follows since it
+  became Weaver's on 2026-09-14.
 
 MIT.

package/dist/index.cjs

@@ -142,7 +142,7 @@ function assertConnectorApi(connectorId, declared) {
   if (SUPPORTED_CONNECTOR_API.includes(declared)) return;
   const supported = SUPPORTED_CONNECTOR_API.join(", ");
   throw new ConnectorApiMismatch(
-    declared > CONNECTOR_API_VERSION ? `"${connectorId}" was written against connector API ${declared}, and this core implements ${supported}. The CONNECTOR is newer: upgrade @particle-academy/fancy-connector-core. Vendoring a connector ahead of the core it needs is the one direction that cannot be made to work by trying.` : `"${connectorId}" was written against connector API ${declared}, which is older than anything this core still runs (${supported}). The CONNECTOR is behind: re-vendor it \u2014 \`npx fancy-cli@latest add connector ${connectorId}\` \u2014 which fetches the copy written for this core. Nothing is adapted automatically, because guessing what a two-version-old connector meant is how a connector quietly starts doing something else.`,
+    declared > CONNECTOR_API_VERSION ? `"${connectorId}" was written against connector API ${declared}, and this core implements ${supported}. The CONNECTOR is newer: upgrade @particle-academy/fancy-connector-core. Vendoring a connector ahead of the core it needs is the one direction that cannot be made to work by trying.` : `"${connectorId}" was written against connector API ${declared}, which is older than anything this core still runs (${supported}). The CONNECTOR is behind: move it to a release written for this core \u2014 upgrade its package (@particle-academy/${connectorId}-js, particle-academy/${connectorId}-php), or regenerate a vendored copy from that release; its CHANGELOG names the connector API each release targets. Nothing is adapted automatically, because guessing what a two-version-old connector meant is how a connector quietly starts doing something else.`,
     connectorId,
     declared
   );