@spacefast/common 0.0.26 → 0.2.1

package/dist/contracts/enums.js

@@ -1,8 +1,8 @@
 import { z } from "zod";
-// Space operation-lifecycle axis (the platform spec "Space"): exactly
-// these five. Serving (disabled) and deletion (deletedAt) are separate axes —
-// a disabled space can still be updating. There is no `moving`: a space IS a
-// site, so ownership changes commit in place and nothing relocates.
+// Space operation-lifecycle axis (the platform spec "Space"). Serving
+// (disabled) and deletion (deletedAt) are separate axes, so a disabled space
+// can still be updating. There is no `moving`: a space IS a site, so ownership
+// changes commit in place.
 export const spaceStatusValues = [
     "provisioning",
     "active",
@@ -19,18 +19,16 @@ export const spaceDisabledReasonCodeValues = [
     "abuse_takedown",
     "tenant_suspended",
     "site_suspended",
-    // Space-key author delete, phase one: the holder of an unclaimed space's key
-    // took the site dark. The key survives, so the same key can restore (or
-    // claim) until the claim window expires; expiry then hard-deletes as usual.
+    // The owner, or the holder of an unclaimed space's key, deleted the Space.
+    // Serving stops while data remains retained for deliberate cleanup. An
+    // unclaimed key survives so it can restore or claim during its claim window.
     "author_removed",
 ];
 export const spaceDisabledReasonCode = z.enum(spaceDisabledReasonCodeValues);
-// SpaceTransfer status machine (the platform spec "Transfer
-// semantics"), stored directly — there is no separate DB vocabulary. A
-// transfer is a request that the receiving side accepts; accepting moves
-// ownership in one database transaction, so there is no intermediate moving
-// state and no `failed` state. Withdraw (from-side) and decline (to-side)
-// both land on `canceled`.
+// SpaceTransfer status machine (the platform spec "Transfer semantics"),
+// stored directly with no separate DB vocabulary. Accepting moves ownership in
+// one database transaction, so there is no intermediate moving state and no
+// `failed` state. Withdraw and decline both land on `canceled`.
 export const spaceTransferStatusValues = [
     "pending_confirmation",
     "completed",
@@ -38,14 +36,21 @@ export const spaceTransferStatusValues = [
     "expired",
 ];
 export const spaceTransferStatus = z.enum(spaceTransferStatusValues);
-// A tenant is the platform-account boundary that owns every resource (the platform spec
-// "Tenant -> Site -> Space"), Stripe-style. `main` is the single well-known
-// Stattic account (`ten_main`) all self-serve teams/users live under;
-// `platform` and `partner` are host integrations with their own user
-// directories and/or external customers; `internal` is for Stattic-operated
-// infrastructure tenants.
-export const tenantKindValues = ["main", "platform", "partner", "internal"];
+// A tenant is the platform-account boundary that owns every resource,
+// Stripe-style. `main` is the single well-known account (`ten_main`) all
+// self-serve teams/users live under; `partner` is a host integration with
+// its own user directory and/or external customers; `internal` is for
+// Spacefast-operated infrastructure tenants.
+export const tenantKindValues = ["main", "partner", "internal"];
 export const tenantKind = z.enum(tenantKindValues);
+// A tenant's mode: `live` is a real partner account provisioning real sites;
+// `test` is its linked sandbox twin — same partner API, isolated data,
+// simulated provisioning, no real wp.cloud/DNS/email. Modeled as a SEPARATE
+// tenant row linked back to its live parent via `liveTenantId`, never a column
+// filtered into every resource query (partner-operations spec §1): isolation
+// holds by construction because every resource is already `tenant_id`-scoped.
+export const tenantModeValues = ["live", "test"];
+export const tenantMode = z.enum(tenantModeValues);
 // `past_due` is the billing-grace state: mutations are rejected immediately
 // (`tenant_past_due`) but serving continues until `servingGraceUntil`, after
 // which the tenant transitions to `suspended` and goes dark.
@@ -55,38 +60,20 @@ export const tenantStatus = z.enum(tenantStatusValues);
 // (operator-only resource, `pvc_` prefix).
 export const providerClientStatusValues = ["active", "disabled"];
 export const providerClientStatus = z.enum(providerClientStatusValues);
-// The only site shape there is. Kept as a named vocabulary because the sites
-// table spells it as an enum column; a dead-code sweep removed it while that
-// column still referenced it.
-export const siteKindValues = ["static_runtime"];
-export const siteKind = z.enum(siteKindValues);
-// Whether settings and access default to the site or to each space. Same story
-// as the two vocabularies around it: a dead-code sweep took it while the
-// `sites` table's own column still named it.
-export const siteIsolationValues = ["site", "space"];
-export const siteIsolation = z.enum(siteIsolationValues);
-// Site lifecycle. A dead-code sweep removed this vocabulary while two live
-// consumers still needed it: the `sites` table's own status column and the
-// superadmin provider-site search result. `ready_pool` is a pre-provisioned
-// warm site waiting to be claimed — load-bearing now that every space draws
-// its own site from the pool.
-export const siteStatusValues = [
-    "ready_pool",
-    "active",
+// Warm-pool inventory (`site_pool`): provider sites provisioned ahead of
+// demand, with no owner yet. These statuses are the whole lifecycle a row has
+// before a space adopts it and the row is deleted. `retired` holds a legacy
+// migration source box that is never automatically promoted for deletion.
+// `cleanup_pending` is the explicit, unclaimable queue for Superadmin review.
+// This is a varchar type union, not a PostgreSQL enum, so adding a value needs
+// no database migration.
+export const poolSiteStatusValues = [
     "provisioning",
+    "ready_pool",
     "degraded",
-    "suspended",
-    "deleted",
+    "retired",
+    "cleanup_pending",
 ];
-export const siteStatus = z.enum(siteStatusValues);
-// Warm-pool inventory (`site_pool`): provider sites provisioned ahead of
-// demand, with no owner yet. A space IS a site, so these statuses are the
-// whole lifecycle a row can have before a space adopts it and the row is
-// deleted — `active`/`suspended`/`deleted` were live-space states and now live
-// on the space's own axes. `retired` holds a drained space=site migration
-// source box: not adoptable, not reapable, kept permanently — migration
-// tooling never deletes a wp.cloud site (owner ruling 2026-08-11).
-export const poolSiteStatusValues = ["provisioning", "ready_pool", "degraded", "retired"];
 export const poolSiteStatus = z.enum(poolSiteStatusValues);
 // PublishSource.kind (the platform spec "PublishSource"): the single
 // provenance axis for how a version came to exist. `variable_update` and
@@ -126,7 +113,7 @@ export const versionStatusValues = [
 export const versionStatus = z.enum(versionStatusValues);
 export const gitProviderValues = ["github", "gitlab", "bitbucket", "generic"];
 export const gitProvider = z.enum(gitProviderValues);
-// Pre-ready, non-terminal statuses: a version in one of these is in flight.
+// Pre-ready, non-terminal statuses.
 export const VERSION_IN_FLIGHT_STATUSES = [
     "created",
     "uploading",
@@ -145,6 +132,30 @@ export const buildStatusValues = [
     "skipped",
 ];
 export const buildStatus = z.enum(buildStatusValues);
+/**
+ * The one authoritative "this build can still change on its own" set. Poll
+ * cadences, cancelability, activity checks and webhook re-enqueue gates all
+ * derive from it — never restate it.
+ */
+export const BUILD_IN_FLIGHT_STATUSES = [
+    "waiting_for_source",
+    "uploading_source",
+    "queued",
+    "running",
+];
+const buildInFlightStatusSet = new Set(BUILD_IN_FLIGHT_STATUSES);
+/**
+ * Its complement: a build that has settled and will never move again.
+ * `skipped` is terminal — a build the runner decided not to run at all.
+ */
+export const BUILD_TERMINAL_STATUSES = buildStatusValues.filter((status) => !buildInFlightStatusSet.has(status));
+const buildTerminalStatusSet = new Set(BUILD_TERMINAL_STATUSES);
+export function buildIsInFlight(status) {
+    return buildInFlightStatusSet.has(status);
+}
+export function buildIsTerminal(status) {
+    return buildTerminalStatusSet.has(status);
+}
 export const diagnosticSeverity = z.enum(["info", "warning", "error"]);
 // Upstream system a Diagnostic originated from. Absent when the diagnostic is
 // Stattic's own (validation, routing compile, upload policy, ...).
@@ -200,9 +211,6 @@ export const safetyCategoryValues = [
 export const safetyCategory = z.enum(safetyCategoryValues);
 // Why a review item was closed (or a space taken down): the operator's verdict
 // in one word, so enforcement quality is measurable without parsing notes.
-// Confirmed-* reasons say the detection was right; the tail says it wasn't
-// (false_positive, test_detection) or the item never needed its own verdict
-// (duplicate, insufficient_evidence, other).
 export const safetyResolutionReasonValues = [
     "malware_confirmed",
     "phishing_confirmed",
@@ -216,7 +224,6 @@ export const safetyResolutionReasonValues = [
     "other",
 ];
 export const safetyResolutionReason = z.enum(safetyResolutionReasonValues);
-// 1 = suspicious, 2 = low, 3 = medium, 4 = high, 5 = critical.
 export const SAFETY_SEVERITY = {
     suspicious: 1,
     low: 2,

package/dist/contracts/error-code-meta.d.ts

@@ -2,7 +2,6 @@ export type ErrorRecovery = "retry" | "re_auth" | "fix_input" | "wait" | "contac
 export interface ErrorCodeMeta {
     /** True when an identical request may succeed on a later attempt without caller changes. */
     retryable: boolean;
-    /** The single actionable recovery hint for this code. */
     recovery: ErrorRecovery;
     /** Copy-pasteable commands or requests an agent can run next. */
     next?: readonly string[];
@@ -74,6 +73,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "re_auth";
     };
+    readonly authorization_level_not_allowed: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
     readonly authorization_pending: {
         readonly retryable: true;
         readonly recovery: "wait";
@@ -195,6 +198,27 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly confirmation_denied: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
+    readonly confirmation_expired: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly confirmation_mismatch: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly confirmation_required: {
+        readonly retryable: false;
+        readonly recovery: "wait";
+        readonly next: readonly ["Open the `url` in the error details so a person can approve or deny it", "POST the `continuationToken` to /v1/actions/resume every 5 seconds", "Give up after 10 minutes, report to your human, and stop"];
+    };
+    readonly confirmation_token_required: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly continuation_unavailable: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -221,6 +245,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "re_auth";
     };
+    readonly credential_sponsor_inactive: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
     readonly csam_blocked: {
         readonly retryable: false;
         readonly recovery: "contact_support";
@@ -229,6 +257,18 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
+    readonly dashboard_prefs_key_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly dashboard_prefs_too_large: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly dashboard_prefs_too_many_keys: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly data_location_immutable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -237,6 +277,15 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly decision_execution_lost: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly decision_in_progress: {
+        readonly retryable: true;
+        readonly recovery: "wait";
+        readonly next: readonly ["POST the continuationToken to /v1/actions/resume"];
+    };
     readonly device_authorization_failed: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -452,6 +501,18 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly elevation_not_required: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly email_already_claimed: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly email_verification_code_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly enforcement_policy_overlap: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -509,6 +570,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: true;
         readonly recovery: "wait";
     };
+    readonly insufficient_scope: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
     readonly internal_error: {
         readonly retryable: true;
         readonly recovery: "retry";
@@ -525,6 +590,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly invalid_decision_state: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
     readonly invalid_device_code: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -537,6 +606,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly invalid_elevation_request: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly invalid_file_path: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -581,6 +654,18 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "re_auth";
     };
+    readonly invalid_usage_bucket: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly invalid_usage_correction: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly invalid_usage_window: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly invalid_version_path: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -629,6 +714,26 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
+    readonly issuer_exists: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly issuer_not_active: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly issuer_proof_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly issuer_tenant_occupied: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly issuer_unknown: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
     readonly job_not_found: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -710,6 +815,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly no_space_selected: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly noop_publish: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -722,6 +831,22 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly partner_preset_not_grantable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly partner_tenant_immutable_client: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly password_already_set: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly password_compromised: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly path_case_collision: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -738,11 +863,11 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
-    readonly placement_invalid_burstable: {
+    readonly plan_unknown: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
-    readonly platform_tenant_immutable_client: {
+    readonly placement_invalid_burstable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
@@ -755,10 +880,34 @@ export declare const ERROR_CODE_META: {
         readonly recovery: "fix_input";
         readonly next: readonly ["sf build", "Delete the archive's .meta.json sidecar if the archive contains plain files"];
     };
+    readonly primary_email_not_removable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly principal_closed: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
+    readonly principal_has_active_spaces: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly principal_not_found: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly principal_space_mismatch: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly principal_suspended: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
+    readonly principal_suspension_locked: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
     readonly provider_error: {
         readonly retryable: true;
         readonly recovery: "retry";
@@ -787,6 +936,34 @@ export declare const ERROR_CODE_META: {
         readonly retryable: true;
         readonly recovery: "wait";
     };
+    readonly promotion_live_content_missing: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly promotion_live_system_space_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly promotion_live_system_space_not_designated: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly promotion_not_live_tenant: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly promotion_nothing_to_promote: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly promotion_runtime_publish_incomplete: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
+    readonly promotion_test_twin_missing: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly proxy_upstream_denied: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -875,6 +1052,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly quota_exceeded: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
@@ -1013,6 +1194,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "re_auth";
     };
+    readonly session_not_fresh: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
     readonly site_already_deleted: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1128,6 +1313,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly space_selection_conflict: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly space_transferring: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1204,10 +1393,26 @@ export declare const ERROR_CODE_META: {
         readonly retryable: true;
         readonly recovery: "retry";
     };
+    readonly superadmin_two_factor_required: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly superadmin_wpcom_account_required: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly superseded_by_publish: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly system_space_conflict: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly system_space_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly takeover_notice_window: {
         readonly retryable: true;
         readonly recovery: "wait";
@@ -1224,6 +1429,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly team_scope_mismatch: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly team_slug_conflict: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1268,6 +1477,42 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly token_alg_invalid: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_audience_mismatch: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_claims_invalid: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_header_forbidden: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_malformed: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_signature_invalid: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_subject_invalid: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_ttl_invalid: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
+    readonly token_type_invalid: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
     readonly transfer_cross_tenant_unsupported: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1316,6 +1561,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly usage_period_not_found: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly user_banned: {
         readonly retryable: false;
         readonly recovery: "contact_support";
@@ -1416,6 +1665,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly webhook_managed_by_manifest: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly whois_unavailable: {
         readonly retryable: true;
         readonly recovery: "retry";
@@ -1688,10 +1941,18 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_email_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_envelope_encode_failed: {
         readonly retryable: true;
         readonly recovery: "retry";
     };
+    readonly zero_gravatar_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_js_context_init_failed: {
         readonly retryable: true;
         readonly recovery: "retry";
@@ -1856,13 +2117,14 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_spam_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_runs_too_many: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
 };
-/**
- * Resolve the metadata for an error code, degrading to a safe `contact_support` default for
- * codes outside the table (dynamic provider passthrough, codes from a newer control plane).
- */
+/** Metadata for an error code, or `DEFAULT_ERROR_CODE_META` when it is outside the table. */
 export declare function errorCodeMeta(code: string): ErrorCodeMeta;