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

package/dist/index.d.cts

@@ -1134,6 +1134,19 @@ declare class ConnectorError extends Error {
     readonly operation: string;
     readonly status?: number;
     readonly providerCode?: string;
+    /**
+     * Every failed attempt of the call, in order. Set on the error a call throws
+     * (`callConnector`), absent on one built anywhere else.
+     *
+     * `declare`, not a field: it is attached with `Object.defineProperty` when the
+     * call gives up, so an error that did not end a call carries no such property.
+     */
+    readonly attempts?: Attempt[];
+    /**
+     * What the call declared. With `attempts`, it separates "never allowed to
+     * retry" from "retries ran out". Same presence rule as `attempts`.
+     */
+    readonly idempotent?: boolean;
     /**
      * What kind of failure this is. The primitive every retry decision reads.
      *

package/dist/index.d.ts

@@ -1134,6 +1134,19 @@ declare class ConnectorError extends Error {
     readonly operation: string;
     readonly status?: number;
     readonly providerCode?: string;
+    /**
+     * Every failed attempt of the call, in order. Set on the error a call throws
+     * (`callConnector`), absent on one built anywhere else.
+     *
+     * `declare`, not a field: it is attached with `Object.defineProperty` when the
+     * call gives up, so an error that did not end a call carries no such property.
+     */
+    readonly attempts?: Attempt[];
+    /**
+     * What the call declared. With `attempts`, it separates "never allowed to
+     * retry" from "retries ran out". Same presence rule as `attempts`.
+     */
+    readonly idempotent?: boolean;
     /**
      * What kind of failure this is. The primitive every retry decision reads.
      *

package/dist/index.js

@@ -34,7 +34,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
   );