@spacefast/common 0.0.24 → 0.0.26

package/dist/contracts/domains.d.ts

@@ -91,14 +91,14 @@ export declare const domainVerificationSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -112,8 +112,8 @@ export declare const domainHintSchema: z.ZodObject<{
     code: z.ZodString;
     severity: z.ZodEnum<{
         info: "info";
-        warning: "warning";
         error: "error";
+        warning: "warning";
     }>;
     painLevel: z.ZodEnum<{
         info: "info";
@@ -225,6 +225,7 @@ export declare const domainRedirectTargetSchema: z.ZodUnion<readonly [z.ZodObjec
     path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>]>;
 export declare const domainRedirectStatusSchema: z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<307>, z.ZodLiteral<308>]>;
+export type DomainRedirectStatus = z.infer<typeof domainRedirectStatusSchema>;
 export declare const domainRedirectSchema: z.ZodObject<{
     to: z.ZodUnion<readonly [z.ZodObject<{
         url: z.ZodString;
@@ -356,14 +357,14 @@ export declare const DomainSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -377,8 +378,8 @@ export declare const DomainSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         painLevel: z.ZodEnum<{
             info: "info";
@@ -614,14 +615,14 @@ export declare const domainListResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -635,8 +636,8 @@ export declare const domainListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             painLevel: z.ZodEnum<{
                 info: "info";
@@ -869,14 +870,14 @@ export declare const spaceCustomDomainSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -890,8 +891,8 @@ export declare const spaceCustomDomainSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         painLevel: z.ZodEnum<{
             info: "info";
@@ -1038,14 +1039,14 @@ export declare const spaceManagedDomainSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -1093,14 +1094,14 @@ export declare const spaceDomainSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -1233,14 +1234,14 @@ export declare const spaceDomainSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -1254,8 +1255,8 @@ export declare const spaceDomainSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         painLevel: z.ZodEnum<{
             info: "info";
@@ -1404,14 +1405,14 @@ export declare const spaceDomainListResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -1544,14 +1545,14 @@ export declare const spaceDomainListResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -1565,8 +1566,8 @@ export declare const spaceDomainListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             painLevel: z.ZodEnum<{
                 info: "info";
@@ -1718,14 +1719,14 @@ export declare const teamManagedDomainSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -1778,14 +1779,14 @@ export declare const teamManagedDomainListResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     registrar: "registrar";
-                    wpcloud: "wpcloud";
+                    infra: "infra";
                     dns: "dns";
                     runtime: "runtime";
                 }>>>;
@@ -1806,6 +1807,16 @@ export declare const teamManagedDomainListResponseSchema: z.ZodObject<{
         hasMore: z.ZodBoolean;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const domainPreflightQuerySchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const domainPreflightSchema: z.ZodObject<{
+    name: z.ZodString;
+    unicodeName: z.ZodOptional<z.ZodString>;
+    canHost: z.ZodNullable<z.ZodBoolean>;
+    providerMessage: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type DomainPreflight = z.infer<typeof domainPreflightSchema>;
 export declare const domainCreateRequestSchema: z.ZodObject<{
     name: z.ZodString;
     teamId: z.ZodOptional<z.ZodString>;
@@ -1899,14 +1910,14 @@ export declare const domainRegistrationActionResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -1942,14 +1953,14 @@ export declare const domainNameserverResponseSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -2091,14 +2102,14 @@ export declare const domainDnsModeResponseSchema: z.ZodObject<{
                     code: z.ZodString;
                     severity: z.ZodEnum<{
                         info: "info";
-                        warning: "warning";
                         error: "error";
+                        warning: "warning";
                     }>;
                     message: z.ZodString;
                     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                         registrar: "registrar";
-                        wpcloud: "wpcloud";
+                        infra: "infra";
                         dns: "dns";
                         runtime: "runtime";
                     }>>>;
@@ -2112,8 +2123,8 @@ export declare const domainDnsModeResponseSchema: z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
                     info: "info";
-                    warning: "warning";
                     error: "error";
+                    warning: "warning";
                 }>;
                 painLevel: z.ZodEnum<{
                     info: "info";
@@ -2224,14 +2235,14 @@ export declare const domainDnsModeResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -2292,14 +2303,14 @@ export declare const domainDnsModeResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -2791,14 +2802,14 @@ export declare const domainDnsCapabilitiesSchema: z.ZodPipe<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -2940,10 +2951,10 @@ export declare const domainDnsCapabilitiesSchema: z.ZodPipe<z.ZodObject<{
     };
     diagnostics: {
         code: string;
-        severity: "info" | "warning" | "error";
+        severity: "info" | "error" | "warning";
         message: string;
         path?: string | null | undefined;
-        provider?: "registrar" | "wpcloud" | "dns" | "runtime" | null | undefined;
+        provider?: "registrar" | "infra" | "dns" | "runtime" | null | undefined;
         details?: Record<string, unknown> | null | undefined;
         fix?: string | null | undefined;
         retryable?: boolean | null | undefined;
@@ -3081,10 +3092,10 @@ export declare const domainDnsCapabilitiesSchema: z.ZodPipe<z.ZodObject<{
     };
     diagnostics: {
         code: string;
-        severity: "info" | "warning" | "error";
+        severity: "info" | "error" | "warning";
         message: string;
         path?: string | null | undefined;
-        provider?: "registrar" | "wpcloud" | "dns" | "runtime" | null | undefined;
+        provider?: "registrar" | "infra" | "dns" | "runtime" | null | undefined;
         details?: Record<string, unknown> | null | undefined;
         fix?: string | null | undefined;
         retryable?: boolean | null | undefined;
@@ -3347,14 +3358,14 @@ export declare const domainProviderSnapshotRefreshResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -3419,14 +3430,14 @@ export declare const domainDnsOperationSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -3473,8 +3484,8 @@ export declare const domainDnsOperationSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         painLevel: z.ZodEnum<{
             info: "info";
@@ -3620,14 +3631,14 @@ export declare const domainDnsOperationListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -3674,8 +3685,8 @@ export declare const domainDnsOperationListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             painLevel: z.ZodEnum<{
                 info: "info";
@@ -4153,14 +4164,14 @@ export declare const domainActionMutationResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -4483,14 +4494,14 @@ export declare const domainDnsRecordListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -4632,10 +4643,10 @@ export declare const domainDnsRecordListResponseSchema: z.ZodObject<{
         };
         diagnostics: {
             code: string;
-            severity: "info" | "warning" | "error";
+            severity: "info" | "error" | "warning";
             message: string;
             path?: string | null | undefined;
-            provider?: "registrar" | "wpcloud" | "dns" | "runtime" | null | undefined;
+            provider?: "registrar" | "infra" | "dns" | "runtime" | null | undefined;
             details?: Record<string, unknown> | null | undefined;
             fix?: string | null | undefined;
             retryable?: boolean | null | undefined;
@@ -4773,10 +4784,10 @@ export declare const domainDnsRecordListResponseSchema: z.ZodObject<{
         };
         diagnostics: {
             code: string;
-            severity: "info" | "warning" | "error";
+            severity: "info" | "error" | "warning";
             message: string;
             path?: string | null | undefined;
-            provider?: "registrar" | "wpcloud" | "dns" | "runtime" | null | undefined;
+            provider?: "registrar" | "infra" | "dns" | "runtime" | null | undefined;
             details?: Record<string, unknown> | null | undefined;
             fix?: string | null | undefined;
             retryable?: boolean | null | undefined;
@@ -4997,14 +5008,14 @@ export declare const domainDiagnosticsResponseSchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;

package/dist/contracts/domains.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { AnyObjectSchema, baseDiagnosticSchema, CursorPaginationSchema, cursorListQuerySchema, DnsInstructionSchema, mutationEnvelope, requiredActionsSchema, } from "./common.js";
 import { PrincipalRefSchema } from "./resources.js";
 // ---------------------------------------------------------------------------
-// Domain resource (internal-docs/platform.md L2387-2431). A canonical name
+// Domain resource (the platform spec). A canonical name
 // owned by a tenant-local principal, plus its registrar/DNS facets and THE
 // serving pointer/whole-host redirect intent.
 // ---------------------------------------------------------------------------
@@ -52,7 +52,7 @@ export const domainDnsFacetSchema = z.object({
     assignedNameservers: z
         .array(z.string())
         .optional()
-        .describe('Managed-zone delegation set the registrar should point at (mode "stattic").'),
+        .describe("Managed-zone delegation set the registrar should point at (mode `stattic`)."),
     observedNameservers: z
         .array(z.string())
         .optional()
@@ -270,6 +270,33 @@ export const teamManagedDomainListResponseSchema = z.object({
     data: z.array(teamManagedDomainSchema),
     pagination: CursorPaginationSchema,
 });
+// Pre-add advisory check. `canHost` mirrors the hosting provider's
+// hostability verdict: `false` often means the domain is blocklisted or
+// already attached to other provider infrastructure (which a later TXT
+// ownership proof can still claim), so clients warn — they never hard-block.
+export const domainPreflightQuerySchema = z.object({
+    name: z
+        .string()
+        .trim()
+        .min(1)
+        .max(253)
+        .describe("Apex or concrete hostname to preflight; canonicalized server-side."),
+});
+export const domainPreflightSchema = z.object({
+    name: z.string().describe("Canonical lowercase ASCII form of the requested hostname."),
+    unicodeName: z
+        .string()
+        .optional()
+        .describe("Read-only U-label form, present only when it differs from `name`."),
+    canHost: z
+        .boolean()
+        .nullable()
+        .describe("Provider hostability verdict. `null` when the provider check was unavailable; treat as unknown, not as failure."),
+    providerMessage: z
+        .string()
+        .nullable()
+        .describe("Provider-reported reason when the verdict is negative."),
+});
 export const domainCreateRequestSchema = z.object({
     name: z
         .string()

package/dist/contracts/enums.d.ts

@@ -111,14 +111,15 @@ export declare const buildStatus: z.ZodEnum<{
     succeeded: "succeeded";
     skipped: "skipped";
 }>;
+export type BuildStatus = z.infer<typeof buildStatus>;
 export declare const diagnosticSeverity: z.ZodEnum<{
     info: "info";
-    warning: "warning";
     error: "error";
+    warning: "warning";
 }>;
 export declare const diagnosticProvider: z.ZodEnum<{
     registrar: "registrar";
-    wpcloud: "wpcloud";
+    infra: "infra";
     dns: "dns";
     runtime: "runtime";
 }>;