@usefidel/contracts 0.2.0 → 0.3.0

package/dist/run-errors.d.ts

@@ -15,7 +15,7 @@
  * When editing this file, run `npx tsx scripts/check-vendor-sync.ts` and
  * update all consumer copies.
  */
-export declare const RUN_ERROR_CODES: readonly ["TARGET_AUTH_WALL", "TARGET_UNREACHABLE", "TARGET_TIMEOUT", "TARGET_CSP_BLOCKED", "FIGMA_ACCESS_DENIED", "FIGMA_TOKEN_EXPIRED", "FIGMA_NOT_FOUND", "FIGMA_RATE_LIMITED", "PIPELINE_TIMEOUT", "PIPELINE_ERROR", "ZERO_ELEMENTS_MATCHED", "PERSIST_FAILED", "SESSION_EXPIRED", "INVALID_REFERENCE_URL", "INVALID_TARGET_URL", "DESIGN_SYSTEM_NOT_AVAILABLE", "DESIGN_SYSTEM_CONTEXT_NOT_AVAILABLE", "DESIGN_SYSTEM_INCOMPATIBLE", "FLOW_STEP_FAILED", "UNKNOWN_ERROR"];
+export declare const RUN_ERROR_CODES: readonly ["TARGET_AUTH_WALL", "TARGET_UNREACHABLE", "TARGET_TIMEOUT", "TARGET_CSP_BLOCKED", "FIGMA_ACCESS_DENIED", "FIGMA_TOKEN_EXPIRED", "FIGMA_NOT_FOUND", "FIGMA_RATE_LIMITED", "PIPELINE_TIMEOUT", "PIPELINE_ERROR", "ZERO_ELEMENTS_MATCHED", "PERSIST_FAILED", "SESSION_EXPIRED", "INVALID_REFERENCE_URL", "INVALID_TARGET_URL", "DESIGN_SYSTEM_NOT_AVAILABLE", "DESIGN_SYSTEM_CONTEXT_NOT_AVAILABLE", "DESIGN_SYSTEM_INCOMPATIBLE", "FLOW_STEP_FAILED", "CAPABILITY_UNAVAILABLE", "PROVIDER_REQUEST_REJECTED", "UNKNOWN_ERROR"];
 export type RunErrorCode = (typeof RUN_ERROR_CODES)[number];
 export interface RunErrorMeta {
     retryable: boolean;

package/dist/run-errors.js

@@ -66,6 +66,23 @@ export const RUN_ERROR_CODES = [
     // (e.g. a transition target is missing or the step response is invalid).
     // retryable: false — this is a structural design problem, not a transient error.
     'FLOW_STEP_FAILED',
+    // Plan G-10 follow-up: replay-provider outcomes that cannot recover by
+    // retrying. Both are deliberately provider-NEUTRAL, in name and in message.
+    // The provider, its status codes and its response bodies stay in structured
+    // logs (`replay_provider_failed`); error_message is owner-readable AND
+    // projected through get_shared_run to anon share viewers, so it must not
+    // name a vendor or describe our configuration (same H-4 reasoning as the
+    // DESIGN_SYSTEM_* codes above).
+    //
+    // CAPABILITY_UNAVAILABLE — the saved-session capability itself is not
+    // usable: credential absent, rejected, or the plan/quota is exhausted.
+    // Operator-side. retryable: false — no number of retries configures a key.
+    'CAPABILITY_UNAVAILABLE',
+    // PROVIDER_REQUEST_REJECTED — a deterministic rejection of this specific
+    // request (a 4xx that is not auth, not "gone", not rate limiting), or a 2xx
+    // whose body was structurally unusable. retryable: false — the same request
+    // will be rejected the same way.
+    'PROVIDER_REQUEST_REJECTED',
     'UNKNOWN_ERROR',
 ];
 export const ERROR_CODE_META = {
@@ -134,6 +151,16 @@ export const ERROR_CODE_META = {
         userMessage: "This site's saved session has expired. Reconnect it to validate again.",
         shortLabel: 'Session expired',
     },
+    CAPABILITY_UNAVAILABLE: {
+        retryable: false,
+        userMessage: "Validating sites that need a saved sign-in isn't available right now. This one's on us — contact support and we'll get it working.",
+        shortLabel: 'Capability unavailable',
+    },
+    PROVIDER_REQUEST_REJECTED: {
+        retryable: false,
+        userMessage: "This validation couldn't be completed. Trying again won't change the result — contact support if you need it looked at.",
+        shortLabel: 'Validation rejected',
+    },
     INVALID_REFERENCE_URL: {
         retryable: false,
         userMessage: 'The reference URL is invalid. It must start with https:// and point to a real page.',

package/package.json

@@ -7,7 +7,7 @@
     "The source of truth still lives in the monorepo at packages/contracts/."
   ],
   "name": "@usefidel/contracts",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shared, code-free contracts between Fidel surfaces. Run-error taxonomy and theme-intake wire types.",
   "license": "UNLICENSED",
   "private": false,