@spacefast/common 0.0.5 → 0.0.7

package/dist/contracts/builds.d.ts

@@ -86,24 +86,66 @@ export declare const BuildCreateInputSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     branch: z.ZodOptional<z.ZodString>;
     pullRequestNumber: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "kind">;
+declare const buildExecutionLaunchSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        started: "started";
+        starting: "starting";
+        rejected: "rejected";
+    }>;
+    requestedAt: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    rejectedReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const buildExecutionSupervisionSchema: z.ZodObject<{
+    generation: z.ZodNumber;
+    owner: z.ZodString;
+    leaseExpiresAt: z.ZodString;
+}, z.core.$strip>;
 declare const InternalBuildExecutionSchema: z.ZodObject<{
     runner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     runnerJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     sandboxId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     region: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    logOffset: z.ZodOptional<z.ZodNumber>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    terminationReason: z.ZodOptional<z.ZodEnum<{
+        command: "command";
+        timeout: "timeout";
+    }>>;
+    launch: z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<{
+            started: "started";
+            starting: "starting";
+            rejected: "rejected";
+        }>;
+        requestedAt: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodNumber>;
+        rejectedReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    supervision: z.ZodOptional<z.ZodObject<{
+        generation: z.ZodNumber;
+        owner: z.ZodString;
+        leaseExpiresAt: z.ZodString;
+    }, z.core.$strip>>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    phases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        phase: z.ZodString;
+        at: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const BuildSchema: z.ZodObject<{
     id: z.ZodString;
     spaceId: z.ZodString;
     status: z.ZodEnum<{
         failed: "failed";
-        queued: "queued";
-        running: "running";
-        succeeded: "succeeded";
         canceled: "canceled";
         waiting_for_source: "waiting_for_source";
         uploading_source: "uploading_source";
+        queued: "queued";
+        running: "running";
+        succeeded: "succeeded";
         skipped: "skipped";
     }>;
     input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -137,16 +179,16 @@ export declare const BuildSchema: z.ZodObject<{
     diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
+            info: "info";
             warning: "warning";
             error: "error";
-            info: "info";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            registrar: "registrar";
             wpcloud: "wpcloud";
             dns: "dns";
-            registrar: "registrar";
             runtime: "runtime";
         }>>>;
         details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -188,16 +230,16 @@ export declare const buildCreateRequestSchema: z.ZodObject<{
     diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
+            info: "info";
             warning: "warning";
             error: "error";
-            info: "info";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            registrar: "registrar";
             wpcloud: "wpcloud";
             dns: "dns";
-            registrar: "registrar";
             runtime: "runtime";
         }>>>;
         details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -251,16 +293,16 @@ export declare const buildSourceArchiveUploadSchema: z.ZodObject<{
         diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
+                info: "info";
                 warning: "warning";
                 error: "error";
-                info: "info";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -276,12 +318,12 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
             spaceId: z.ZodString;
             status: z.ZodEnum<{
                 failed: "failed";
-                queued: "queued";
-                running: "running";
-                succeeded: "succeeded";
                 canceled: "canceled";
                 waiting_for_source: "waiting_for_source";
                 uploading_source: "uploading_source";
+                queued: "queued";
+                running: "running";
+                succeeded: "succeeded";
                 skipped: "skipped";
             }>;
             input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -315,16 +357,16 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
             diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
+                    info: "info";
                     warning: "warning";
                     error: "error";
-                    info: "info";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    registrar: "registrar";
                     wpcloud: "wpcloud";
                     dns: "dns";
-                    registrar: "registrar";
                     runtime: "runtime";
                 }>>>;
                 details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -380,16 +422,16 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                 diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     code: z.ZodString;
                     severity: z.ZodEnum<{
+                        info: "info";
                         warning: "warning";
                         error: "error";
-                        info: "info";
                     }>;
                     message: z.ZodString;
                     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                        registrar: "registrar";
                         wpcloud: "wpcloud";
                         dns: "dns";
-                        registrar: "registrar";
                         runtime: "runtime";
                     }>>>;
                     details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -410,12 +452,12 @@ export declare const buildListResponseSchema: z.ZodObject<{
         spaceId: z.ZodString;
         status: z.ZodEnum<{
             failed: "failed";
-            queued: "queued";
-            running: "running";
-            succeeded: "succeeded";
             canceled: "canceled";
             waiting_for_source: "waiting_for_source";
             uploading_source: "uploading_source";
+            queued: "queued";
+            running: "running";
+            succeeded: "succeeded";
             skipped: "skipped";
         }>;
         input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -449,16 +491,16 @@ export declare const buildListResponseSchema: z.ZodObject<{
         diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
+                info: "info";
                 warning: "warning";
                 error: "error";
-                info: "info";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -499,6 +541,8 @@ export type InternalBuildSource = z.infer<typeof InternalBuildSourceSchema>;
 export type BuildSettings = z.infer<typeof BuildSettingsSchema>;
 export type BuildTarget = z.infer<typeof BuildTargetSchema>;
 export type InternalBuildExecution = z.infer<typeof InternalBuildExecutionSchema>;
+export type InternalBuildExecutionLaunch = z.infer<typeof buildExecutionLaunchSchema>;
+export type InternalBuildExecutionSupervision = z.infer<typeof buildExecutionSupervisionSchema>;
 export type BuildCreateRequest = z.infer<typeof buildCreateRequestSchema>;
 export type BuildCreateResponse = z.infer<typeof buildCreateResponseSchema>;
 export {};

package/dist/contracts/builds.js

@@ -168,13 +168,42 @@ export const BuildCreateInputSchema = z
     }),
 ])
     .describe("What a new build should run against.");
+// One phase-timeline entry the build runner appends via recordBuildPhase
+// (apps/control-plane/src/builds/runner.ts BUILD_PHASES); `phase` stays a
+// plain string here since the runner's specific phase vocabulary is an
+// app-level concern, not a shared contract.
+const buildExecutionPhaseSchema = z.object({
+    phase: z.string().min(1).describe("Build phase name; see BUILD_PHASES in builds/runner.ts."),
+    at: z.string().datetime(),
+});
+const buildExecutionLaunchSchema = z.object({
+    state: z.enum(["starting", "started", "rejected"]),
+    requestedAt: z.string().datetime(),
+    startedAt: z.string().datetime().optional(),
+    pid: z.number().int().optional(),
+    rejectedReason: z.string().optional(),
+});
+const buildExecutionSupervisionSchema = z.object({
+    generation: z.number().int().positive(),
+    owner: z.string().min(1),
+    leaseExpiresAt: z.string().datetime(),
+});
 const InternalBuildExecutionSchema = z
     .object({
     runner: z.string().nullable().default(null),
     runnerJobId: z.string().nullable().default(null),
     sandboxId: z.string().nullable().default(null),
     region: z.string().nullable().default(null),
+    logOffset: z.number().int().nonnegative().optional(),
+    exitCode: z.number().int().min(0).max(255).optional(),
+    terminationReason: z.enum(["command", "timeout"]).optional(),
+    launch: buildExecutionLaunchSchema.optional(),
+    supervision: buildExecutionSupervisionSchema.optional(),
     metadata: z.record(z.string(), z.unknown()).default({}),
+    phases: z
+        .array(buildExecutionPhaseSchema)
+        .optional()
+        .describe("Phase timeline the runner appends to via recordBuildPhase."),
 })
     .describe("Internal runner execution metadata surfaced only where appropriate.");
 export const BuildSchema = z.object({

package/dist/contracts/common.d.ts

@@ -110,9 +110,11 @@ export declare const ApiErrorResponseSchema: z.ZodObject<{
         docsUrl: z.ZodString;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        next: z.ZodOptional<z.ZodArray<z.ZodString>>;
         requestId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export type ApiErrorResponse = z.infer<typeof ApiErrorResponseSchema>;
 export declare function dataEnvelope<T extends z.ZodType>(data: T): z.ZodObject<{
     data: T;
 }, z.core.$strip>;

package/dist/contracts/common.js

@@ -83,6 +83,10 @@ export const ApiErrorResponseSchema = z.object({
             .array(z.string())
             .optional()
             .describe("Actionable recovery steps safe to show in dashboards, SDKs, and CLI output."),
+        next: z
+            .array(z.string())
+            .optional()
+            .describe("Copy-pasteable commands or API requests an agent can run next."),
         requestId: z.string().optional().describe("Request id to quote when contacting support."),
     }),
 });

package/dist/contracts/continuation.d.ts

@@ -2,7 +2,6 @@ import { z } from "zod";
 export declare const RequiresActionTypeSchema: z.ZodEnum<{
     device_authorization: "device_authorization";
 }>;
-export type RequiresActionType = z.infer<typeof RequiresActionTypeSchema>;
 export declare const RequiresActionSchema: z.ZodObject<{
     actionType: z.ZodEnum<{
         device_authorization: "device_authorization";
@@ -27,11 +26,9 @@ export declare const RequiresActionEnvelopeSchema: z.ZodObject<{
         expiresAt: z.ZodString;
     }, z.core.$strict>;
 }, z.core.$strict>;
-export type RequiresActionEnvelope = z.infer<typeof RequiresActionEnvelopeSchema>;
 export declare const ActionResumeRequestSchema: z.ZodObject<{
     continuationToken: z.ZodString;
 }, z.core.$strict>;
-export type ActionResumeRequest = z.infer<typeof ActionResumeRequestSchema>;
 export declare const ActionResumeResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     status: z.ZodLiteral<"pending">;
     requiresAction: z.ZodObject<{

package/dist/contracts/countries.d.ts

@@ -0,0 +1,2 @@
+export declare const ISO_COUNTRY_CODES: readonly ["AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"];
+export type IsoCountryCode = (typeof ISO_COUNTRY_CODES)[number];

package/dist/contracts/countries.js

@@ -0,0 +1,261 @@
+// ISO 3166-1 alpha-2 country codes — the vocabulary of the firewall card's
+// country section (contracts/access.ts `firewallCountriesSchema`, access-plan
+// §5.6). The rule `match.country` is an exact-equality matcher against the
+// edge-supplied country header, so "allow only these countries" compiles to
+// one deny/challenge rule per code in the COMPLEMENT of this list — which is
+// why the list itself is a contract: the compiler and the projection must
+// agree on the universe.
+//
+// Officially assigned codes only (no exceptionally-reserved / user-assigned
+// ranges). Display names are a UI concern (`Intl.DisplayNames`), never stored.
+export const ISO_COUNTRY_CODES = [
+    "AD",
+    "AE",
+    "AF",
+    "AG",
+    "AI",
+    "AL",
+    "AM",
+    "AO",
+    "AQ",
+    "AR",
+    "AS",
+    "AT",
+    "AU",
+    "AW",
+    "AX",
+    "AZ",
+    "BA",
+    "BB",
+    "BD",
+    "BE",
+    "BF",
+    "BG",
+    "BH",
+    "BI",
+    "BJ",
+    "BL",
+    "BM",
+    "BN",
+    "BO",
+    "BQ",
+    "BR",
+    "BS",
+    "BT",
+    "BV",
+    "BW",
+    "BY",
+    "BZ",
+    "CA",
+    "CC",
+    "CD",
+    "CF",
+    "CG",
+    "CH",
+    "CI",
+    "CK",
+    "CL",
+    "CM",
+    "CN",
+    "CO",
+    "CR",
+    "CU",
+    "CV",
+    "CW",
+    "CX",
+    "CY",
+    "CZ",
+    "DE",
+    "DJ",
+    "DK",
+    "DM",
+    "DO",
+    "DZ",
+    "EC",
+    "EE",
+    "EG",
+    "EH",
+    "ER",
+    "ES",
+    "ET",
+    "FI",
+    "FJ",
+    "FK",
+    "FM",
+    "FO",
+    "FR",
+    "GA",
+    "GB",
+    "GD",
+    "GE",
+    "GF",
+    "GG",
+    "GH",
+    "GI",
+    "GL",
+    "GM",
+    "GN",
+    "GP",
+    "GQ",
+    "GR",
+    "GS",
+    "GT",
+    "GU",
+    "GW",
+    "GY",
+    "HK",
+    "HM",
+    "HN",
+    "HR",
+    "HT",
+    "HU",
+    "ID",
+    "IE",
+    "IL",
+    "IM",
+    "IN",
+    "IO",
+    "IQ",
+    "IR",
+    "IS",
+    "IT",
+    "JE",
+    "JM",
+    "JO",
+    "JP",
+    "KE",
+    "KG",
+    "KH",
+    "KI",
+    "KM",
+    "KN",
+    "KP",
+    "KR",
+    "KW",
+    "KY",
+    "KZ",
+    "LA",
+    "LB",
+    "LC",
+    "LI",
+    "LK",
+    "LR",
+    "LS",
+    "LT",
+    "LU",
+    "LV",
+    "LY",
+    "MA",
+    "MC",
+    "MD",
+    "ME",
+    "MF",
+    "MG",
+    "MH",
+    "MK",
+    "ML",
+    "MM",
+    "MN",
+    "MO",
+    "MP",
+    "MQ",
+    "MR",
+    "MS",
+    "MT",
+    "MU",
+    "MV",
+    "MW",
+    "MX",
+    "MY",
+    "MZ",
+    "NA",
+    "NC",
+    "NE",
+    "NF",
+    "NG",
+    "NI",
+    "NL",
+    "NO",
+    "NP",
+    "NR",
+    "NU",
+    "NZ",
+    "OM",
+    "PA",
+    "PE",
+    "PF",
+    "PG",
+    "PH",
+    "PK",
+    "PL",
+    "PM",
+    "PN",
+    "PR",
+    "PS",
+    "PT",
+    "PW",
+    "PY",
+    "QA",
+    "RE",
+    "RO",
+    "RS",
+    "RU",
+    "RW",
+    "SA",
+    "SB",
+    "SC",
+    "SD",
+    "SE",
+    "SG",
+    "SH",
+    "SI",
+    "SJ",
+    "SK",
+    "SL",
+    "SM",
+    "SN",
+    "SO",
+    "SR",
+    "SS",
+    "ST",
+    "SV",
+    "SX",
+    "SY",
+    "SZ",
+    "TC",
+    "TD",
+    "TF",
+    "TG",
+    "TH",
+    "TJ",
+    "TK",
+    "TL",
+    "TM",
+    "TN",
+    "TO",
+    "TR",
+    "TT",
+    "TV",
+    "TW",
+    "TZ",
+    "UA",
+    "UG",
+    "UM",
+    "US",
+    "UY",
+    "UZ",
+    "VA",
+    "VC",
+    "VE",
+    "VG",
+    "VI",
+    "VN",
+    "VU",
+    "WF",
+    "WS",
+    "YE",
+    "YT",
+    "ZA",
+    "ZM",
+    "ZW",
+];