@spacefast/common 0.0.3 → 0.0.6

package/dist/contracts/domains.js

@@ -209,12 +209,12 @@ export const spaceCustomDomainSchema = DomainSchema.extend({
 });
 export const spaceManagedDomainSchema = z.object({
     id: z.string().describe("Stable managed row id derived from the default hostname row."),
-    source: z.literal("managed_view_fast").describe("System-managed view.fast hostname row."),
+    source: z.literal("managed_view_fast").describe("System-managed hostname row."),
     managed: z.literal(true),
     deletable: z.literal(false),
     assignable: z.literal(false),
     primary: z.boolean().describe("True when no custom primary domain overrides the managed URL."),
-    name: z.string().describe("Managed view.fast hostname."),
+    name: z.string().describe("Managed hostname."),
     unicodeName: z.string().optional(),
     kind: z.literal("hostname"),
     publicName: z.string().describe("Left-hand public project label for the managed hostname."),
@@ -1027,7 +1027,7 @@ export const domainProviderConnectionCreateSchema = z
 });
 export const domainProviderConnectionOAuthCompleteSchema = z.object({
     teamId: z.string().min(1).optional(),
-    provider: z.literal("cloudflare"),
+    provider: z.enum(["cloudflare", "wpcom"]),
     label: z.string().trim().min(1).max(255).optional(),
 });
 export const domainProviderZoneSchema = z.object({
@@ -1047,6 +1047,22 @@ export const domainProviderZoneAttachSchema = z.object({
     providerZoneId: z.string().min(1).max(255),
     providerZoneName: z.string().trim().min(1).max(255).optional(),
 });
+export const domainConnectDiscoverySchema = z.object({
+    supported: z.boolean(),
+    gated: z.boolean().optional(),
+    provider: z
+        .object({
+        urlSyncUX: z.string().url().optional(),
+        urlAPI: z.string().url().optional(),
+        urlControlPanel: z.string().url().optional(),
+        providerName: z.string().optional(),
+    })
+        .optional(),
+    checkedAt: z.string().datetime(),
+});
+export const domainConnectDiscoveryResponseSchema = z.object({
+    data: domainConnectDiscoverySchema,
+});
 export const domainProviderSnapshotRefreshResponseSchema = mutationEnvelope(z.object({
     operationId: z.string(),
     snapshot: z.object({
@@ -1361,7 +1377,7 @@ export const domainDnsRecordBatchSchema = z
     puts: z
         .array(domainDnsRecordFields.extend({ id: z.string() }).superRefine(requireMxSrvPriority))
         .default([])
-        .describe("Full record upserts by id, applied third."),
+        .describe("Full replacements for existing records by id, applied third."),
     posts: z
         .array(domainDnsRecordFields.superRefine(requireMxSrvPriority))
         .default([])
@@ -1376,6 +1392,8 @@ export const domainHostnameDnsSnapshotSchema = z.object({
     a: z.array(z.string()).default([]),
     aaaa: z.array(z.string()).default([]),
     caa: z.array(z.string()).default([]),
+    cname: z.array(z.string()).default([]),
+    mx: z.array(z.string()).default([]),
     txt: z.array(z.string()).default([]),
 });
 export const domainHostnameSslBrokenRecordSchema = z.object({
@@ -1400,8 +1418,10 @@ export const domainHostnameDiagnosticsSchema = z.object({
         .default([])
         .describe("DNS records required for this hostname."),
     dns: z.object({
+        observedAt: z.string().datetime(),
         expectedTxtValue: z.string().nullable(),
         pointsToProvider: z.boolean().describe("Whether observed A records point at the provider."),
+        proxyDetected: z.boolean().nullable().describe("Whether observed A records look proxied."),
         txtVerified: z.boolean().nullable().describe("Whether the verification TXT is observed."),
         hasAaaaRecords: z.boolean(),
         hasCaaRecords: z.boolean(),
@@ -1409,6 +1429,8 @@ export const domainHostnameDiagnosticsSchema = z.object({
             a: z.array(z.string()).default([]),
             aaaa: z.array(z.string()).default([]),
             caa: z.array(z.string()).default([]),
+            cname: z.array(z.string()).default([]),
+            mx: z.array(z.string()).default([]),
             txt: z.array(z.string()).default([]),
         }),
         byResolver: z.array(domainHostnameDnsSnapshotSchema).default([]),

package/dist/contracts/enums.d.ts

@@ -8,12 +8,13 @@ export declare const spaceStatus: z.ZodEnum<{
     deleting: "deleting";
     failed: "failed";
 }>;
-export declare const spaceDisabledReasonCodeValues: readonly ["anonymous_expired", "abuse_takedown", "tenant_suspended", "site_suspended"];
+export declare const spaceDisabledReasonCodeValues: readonly ["anonymous_expired", "abuse_takedown", "tenant_suspended", "site_suspended", "visit_cap_exceeded"];
 export declare const spaceDisabledReasonCode: z.ZodEnum<{
     anonymous_expired: "anonymous_expired";
     abuse_takedown: "abuse_takedown";
     tenant_suspended: "tenant_suspended";
     site_suspended: "site_suspended";
+    visit_cap_exceeded: "visit_cap_exceeded";
 }>;
 export declare const spaceTransferStatusValues: readonly ["pending_confirmation", "confirming_domains", "moving", "completed", "canceled", "expired"];
 export declare const spaceTransferStatus: z.ZodEnum<{
@@ -61,20 +62,30 @@ export declare const siteStatus: z.ZodEnum<{
     ready_pool: "ready_pool";
     degraded: "degraded";
 }>;
-export declare const siteClassValues: readonly ["anonymous_pool", "shared_org", "dedicated_space"];
+export declare const siteClassValues: readonly ["shared", "dedicated", "shared_org", "anonymous_pool", "dedicated_space"];
 export declare const siteClass: z.ZodEnum<{
-    anonymous_pool: "anonymous_pool";
+    shared: "shared";
+    dedicated: "dedicated";
     shared_org: "shared_org";
+    anonymous_pool: "anonymous_pool";
     dedicated_space: "dedicated_space";
 }>;
+export declare const normalizedSiteClassValues: readonly ["shared", "dedicated"];
+export declare const normalizedSiteClass: z.ZodEnum<{
+    shared: "shared";
+    dedicated: "dedicated";
+}>;
+export declare function normalizeSiteClass(value: SiteClass): NormalizedSiteClass;
+export declare function siteClassIsShared(value: SiteClass): boolean;
+export declare function siteClassIsDedicated(value: SiteClass): boolean;
 export declare const publishSourceKindValues: readonly ["direct_upload", "cli", "dashboard", "api", "git", "import", "agent", "build", "variable_update", "config_update"];
 export declare const publishSourceKind: z.ZodEnum<{
+    api: "api";
+    dashboard: "dashboard";
     build: "build";
     agent: "agent";
-    api: "api";
     direct_upload: "direct_upload";
     cli: "cli";
-    dashboard: "dashboard";
     git: "git";
     import: "import";
     variable_update: "variable_update";
@@ -165,15 +176,6 @@ export declare const cachePurgeTarget: z.ZodEnum<{
     domain: "domain";
     path: "path";
 }>;
-export declare const bullJobStatus: z.ZodEnum<{
-    active: "active";
-    failed: "failed";
-    completed: "completed";
-    delayed: "delayed";
-    prioritized: "prioritized";
-    waiting: "waiting";
-    "waiting-children": "waiting-children";
-}>;
 export declare const operationStatus: z.ZodEnum<{
     failed: "failed";
     canceled: "canceled";
@@ -181,16 +183,13 @@ export declare const operationStatus: z.ZodEnum<{
     running: "running";
     succeeded: "succeeded";
 }>;
-export type VersionStatus = z.infer<typeof versionStatus>;
 export type GitProvider = z.infer<typeof gitProvider>;
 export type PublishSourceKind = z.infer<typeof publishSourceKind>;
 export type SiteIsolation = z.infer<typeof siteIsolation>;
-export type TenantKind = z.infer<typeof tenantKind>;
 export type TenantStatus = z.infer<typeof tenantStatus>;
-export type ProviderClientStatus = z.infer<typeof providerClientStatus>;
 export type SiteKind = z.infer<typeof siteKind>;
-export type SiteStatus = z.infer<typeof siteStatus>;
 export type SiteClass = z.infer<typeof siteClass>;
+export type NormalizedSiteClass = z.infer<typeof normalizedSiteClass>;
 export type OperationStatus = z.infer<typeof operationStatus>;
 export type SafetyCategory = z.infer<typeof safetyCategory>;
 export type EnforcementTier = z.infer<typeof enforcementTier>;

package/dist/contracts/enums.js

@@ -12,13 +12,16 @@ export const spaceStatusValues = [
 ];
 export const spaceStatus = z.enum(spaceStatusValues);
 // Serving-axis disable reasons (internal-docs/platform.md "Space"): exactly
-// these four. Malware takedowns are `abuse_takedown` with
-// `details.source = "malware_scan"`.
+// these five. Malware takedowns are `abuse_takedown` with
+// `details.source = "malware_scan"`. `visit_cap_exceeded` is the anonymous
+// visit-quota pause (ANONYMOUS_PUBLISH_CAPS.maxLifetimeViews): recoverable,
+// the claim token stays intact, and claiming the space restores serving.
 export const spaceDisabledReasonCodeValues = [
     "anonymous_expired",
     "abuse_takedown",
     "tenant_suspended",
     "site_suspended",
+    "visit_cap_exceeded",
 ];
 export const spaceDisabledReasonCode = z.enum(spaceDisabledReasonCodeValues);
 // SpaceTransfer status machine (internal-docs/platform.md "Transfer
@@ -72,10 +75,27 @@ export const siteStatusValues = [
     "deleted",
 ];
 export const siteStatus = z.enum(siteStatusValues);
-// Placement class for shared-pool sites: anonymous pool partition, one shared
-// site per team, or a site dedicated to a single space / tenant-created site.
-export const siteClassValues = ["anonymous_pool", "shared_org", "dedicated_space"];
+// Placement class for a WP.Cloud site. Deploy T accepts the legacy class
+// strings while new code writes the normalized shared/dedicated vocabulary.
+export const siteClassValues = [
+    "shared",
+    "dedicated",
+    "shared_org",
+    "anonymous_pool",
+    "dedicated_space",
+];
 export const siteClass = z.enum(siteClassValues);
+export const normalizedSiteClassValues = ["shared", "dedicated"];
+export const normalizedSiteClass = z.enum(normalizedSiteClassValues);
+export function normalizeSiteClass(value) {
+    return value === "dedicated" || value === "dedicated_space" ? "dedicated" : "shared";
+}
+export function siteClassIsShared(value) {
+    return normalizeSiteClass(value) === "shared";
+}
+export function siteClassIsDedicated(value) {
+    return normalizeSiteClass(value) === "dedicated";
+}
 // PublishSource.kind (internal-docs/platform.md "PublishSource"): the single
 // provenance axis for how a version came to exist. `variable_update` and
 // `config_update` versions are minted by cascades/config regeneration.
@@ -199,13 +219,4 @@ export const enforcementTierValues = ["record", "space_takedown", "account_suspe
 export const enforcementTier = z.enum(enforcementTierValues);
 export const cachePurgeAction = z.enum(["invalidate"]);
 export const cachePurgeTarget = z.enum(["space", "domain", "path"]);
-export const bullJobStatus = z.enum([
-    "active",
-    "completed",
-    "delayed",
-    "failed",
-    "prioritized",
-    "waiting",
-    "waiting-children",
-]);
 export const operationStatus = z.enum(["queued", "running", "succeeded", "failed", "canceled"]);

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

@@ -4,6 +4,8 @@ export interface ErrorCodeMeta {
     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[];
 }
 /** Safe default for codes outside the table (provider passthrough, future codes). */
 export declare const DEFAULT_ERROR_CODE_META: ErrorCodeMeta;
@@ -15,6 +17,7 @@ export declare const ERROR_CODE_META: {
     readonly abuse_report_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly abuse_takedown: {
         readonly retryable: false;
@@ -35,6 +38,7 @@ export declare const ERROR_CODE_META: {
     readonly anonymous_expired: {
         readonly retryable: false;
         readonly recovery: "re_auth";
+        readonly next: readonly ["sf publish", "MCP: call publish", "curl -sS -F archive=@site.zip https://api.spacefast.com/v1/publish"];
     };
     readonly anonymous_pool_unavailable: {
         readonly retryable: true;
@@ -43,6 +47,12 @@ export declare const ERROR_CODE_META: {
     readonly anonymous_publish_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds", "sf login", "sf publish"];
+    };
+    readonly anonymous_space_limit_reached: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["sf login", "Claim or delete an existing anonymous space"];
     };
     readonly archive_body_required: {
         readonly retryable: false;
@@ -168,6 +178,16 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly continuation_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["Ask the owner to create an access token", "sf login", "sf publish --token <access-token>"];
+    };
+    readonly continuation_used: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["Use the saved access token", "sf publish --token <access-token>", "Ask the owner to create an access token"];
+    };
     readonly credential_expired: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -192,6 +212,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
+    readonly datacenters_unavailable: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly data_location_immutable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -203,6 +227,7 @@ export declare const ERROR_CODE_META: {
     readonly device_verification_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly dns_export_required: {
         readonly retryable: false;
@@ -287,6 +312,7 @@ export declare const ERROR_CODE_META: {
     readonly dns_provider_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds", "sf domains check"];
     };
     readonly dns_provider_replace_all_requires_fresh_plan: {
         readonly retryable: false;
@@ -367,6 +393,7 @@ export declare const ERROR_CODE_META: {
     readonly domain_lookup_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly domain_not_bound: {
         readonly retryable: false;
@@ -415,6 +442,7 @@ export declare const ERROR_CODE_META: {
     readonly event_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly expired_token: {
         readonly retryable: false;
@@ -492,6 +520,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "re_auth";
     };
+    readonly invalid_continuation_token: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+    };
     readonly invalid_data_location: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -580,6 +612,14 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly invitation_email_mismatch: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly invitation_expired: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly invitation_not_pending: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -620,6 +660,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
+    readonly move_target_capacity_lost: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly managed_domain_protected: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -680,6 +724,14 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly placement_invalid_burstable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly placement_mode_requires_plan: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly platform_tenant_immutable_client: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -767,6 +819,7 @@ export declare const ERROR_CODE_META: {
     readonly rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly registration_expired: {
         readonly retryable: false;
@@ -895,15 +948,22 @@ export declare const ERROR_CODE_META: {
     readonly slow_down: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly space_already_claimed: {
         readonly retryable: false;
         readonly recovery: "fix_input";
+        readonly next: readonly ["sf login", "sf publish --space <space-id>", "Ask the owner to create an access token"];
     };
     readonly space_claim_unavailable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly space_claimed_credential_available: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["bash scripts/continue.sh", "MCP: call continue_space", "curl -sS -X POST -H 'Authorization: Bearer <claim-token>' https://api.spacefast.com/v1/anonymous-claim/exchange"];
+    };
     readonly space_disabled: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -980,6 +1040,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly storage_bucket_unavailable: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly storage_quota_exceeded: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1000,6 +1064,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: true;
         readonly recovery: "wait";
     };
+    readonly team_member_quota_exceeded: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly team_ref_required: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1064,6 +1132,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly transfer_push_failed: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly transfer_source_changed: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1072,6 +1144,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly transfer_verify_failed: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly unauthorized: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -1248,6 +1324,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_activating: {
+        readonly retryable: true;
+        readonly recovery: "wait";
+    };
     readonly zero_artifact_invalid: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1488,6 +1568,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_requires_dedicated_plan: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_run_operation_unsupported: {
         readonly retryable: false;
         readonly recovery: "fix_input";