@spacefast/common 0.0.11 → 0.0.12

package/dist/contracts/sites.d.ts

@@ -14,6 +14,7 @@ export declare const SitePressureSchema: z.ZodObject<{
     lastSampleAt: z.ZodOptional<z.ZodString>;
     consecutivePressured: z.ZodOptional<z.ZodNumber>;
     consecutiveClean: z.ZodOptional<z.ZodNumber>;
+    placementHoldRevision: z.ZodOptional<z.ZodNumber>;
     pressureHoldUntil: z.ZodOptional<z.ZodString>;
     lastBulkLaneActivityAt: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
@@ -76,8 +77,8 @@ export declare const SiteSchema: 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>>;
@@ -98,9 +99,10 @@ export declare const SiteSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type Site = z.infer<typeof SiteSchema>;
-export declare const siteProvisioningSchema: z.ZodOptional<z.ZodObject<{
+export declare const operatorSiteProvisioningSchema: z.ZodOptional<z.ZodObject<{
     importProviderSiteId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
+export declare const tenantSiteProvisioningSchema: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
 export declare const siteCreateSchema: z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<{
         static_runtime: "static_runtime";
@@ -110,10 +112,8 @@ export declare const siteCreateSchema: z.ZodObject<{
         space: "space";
     }>>;
     region: z.ZodOptional<z.ZodString>;
-    provisioning: z.ZodOptional<z.ZodObject<{
-        importProviderSiteId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    provisioning: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
+}, z.core.$strict>;
 export declare const siteListSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -173,8 +173,8 @@ export declare const siteListSchema: 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>>;
@@ -264,8 +264,8 @@ export declare const SuperadminSiteSchema: 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>>;
@@ -353,8 +353,8 @@ export declare const SuperadminSiteListSchema: 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>>;
@@ -388,16 +388,16 @@ export declare const superadminSiteCreateSchema: z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<{
         static_runtime: "static_runtime";
     }>>;
+    region: z.ZodOptional<z.ZodString>;
     isolation: z.ZodDefault<z.ZodEnum<{
         site: "site";
         space: "space";
     }>>;
-    region: z.ZodOptional<z.ZodString>;
+    tenantId: z.ZodString;
     provisioning: z.ZodOptional<z.ZodObject<{
         importProviderSiteId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    tenantId: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export declare const siteRebalanceRequestSchema: z.ZodObject<{
     spaceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;

package/dist/contracts/sites.js

@@ -36,6 +36,10 @@ export const SitePressureSchema = z
     lastSampleAt: z.string().datetime().optional(),
     consecutivePressured: z.number().int().nonnegative().optional(),
     consecutiveClean: z.number().int().nonnegative().optional(),
+    // Monotonic CAS token shared by explicit operator hold actions and the
+    // pressure sampler. Every durable hold transition advances it, including
+    // transitions that restore a prior timestamp.
+    placementHoldRevision: z.number().int().nonnegative().optional(),
     // Provenance stamp for the sampler's automatic hold: set on trip to the
     // exact hold instant it wrote, so release only clears holds the pressure
     // pipeline itself set — never an operator-set placement hold.
@@ -70,13 +74,10 @@ export const SiteSchema = z.object({
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
 });
-// How a site connects to WP.Cloud on creation: provision a fresh provider site
-// (optional region override, falling back to the tenant's WP.Cloud client
-// defaults), or import an existing one by its WP.Cloud site id (atomic_site_id).
-// Runtime-owned knobs such as filesystem mode, static miss handling, PHP
-// workers, and alias canonicalization are intentionally not exposed here; the
-// control plane sets them from Spacefast runtime invariants.
-export const siteProvisioningSchema = z
+// Operator-only WP.Cloud provisioning controls. Tenant site creation never
+// accepts provider object identifiers: authority to create a Spacefast site
+// must not imply authority to adopt existing provider infrastructure.
+export const operatorSiteProvisioningSchema = z
     .object({
     importProviderSiteId: z
         .string()
@@ -86,12 +87,17 @@ export const siteProvisioningSchema = z
         .describe("Import an existing WP.Cloud site by its atomic_site_id (operator flows)."),
 })
     .optional();
-export const siteCreateSchema = z.object({
+// An explicit empty object requests fresh provider provisioning while keeping
+// every provider identity and runtime knob outside tenant control.
+export const tenantSiteProvisioningSchema = z.object({}).strict().optional();
+export const siteCreateSchema = z
+    .object({
     kind: siteKind.default("static_runtime"),
     isolation: siteIsolation.default("site"),
     region: z.string().trim().min(1).optional().describe('Placement region; defaults to `"auto"`.'),
-    provisioning: siteProvisioningSchema,
-});
+    provisioning: tenantSiteProvisioningSchema,
+})
+    .strict();
 export const siteListSchema = z.object({
     data: z.array(SiteSchema),
     pagination: CursorPaginationSchema,
@@ -114,8 +120,9 @@ export const SuperadminSiteListSchema = z.object({
 });
 // Superadmin site create targets an explicit tenant (the tenant-facing
 // `siteCreateSchema` derives the tenant from the principal).
-export const superadminSiteCreateSchema = siteCreateSchema.extend({
+export const superadminSiteCreateSchema = siteCreateSchema.omit({ provisioning: true }).extend({
     tenantId: z.string().trim().min(1),
+    provisioning: operatorSiteProvisioningSchema,
 });
 // Operator rebalance trigger (internal-docs/platform.md "Space placement and
 // moves": operator rebalancing is a move trigger). Queues `space_move`

package/dist/contracts/space-config.d.ts

@@ -56,7 +56,6 @@ export declare const spacePlacementModeSchema: z.ZodEnum<{
     dedicated: "dedicated";
 }>;
 export declare const spacePlacementConfigSchema: z.ZodObject<{
-    region: z.ZodOptional<z.ZodString>;
     mode: z.ZodOptional<z.ZodEnum<{
         shared: "shared";
         dedicated: "dedicated";
@@ -128,7 +127,6 @@ export declare const spaceConfigSchema: z.ZodObject<{
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     placement: z.ZodOptional<z.ZodObject<{
-        region: z.ZodOptional<z.ZodString>;
         mode: z.ZodOptional<z.ZodEnum<{
             shared: "shared";
             dedicated: "dedicated";
@@ -158,6 +156,7 @@ export declare const spaceAccessConfigSchema: z.ZodObject<{
             ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             agent: z.ZodOptional<z.ZodString>;
             country: z.ZodOptional<z.ZodString>;
+            countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
             header: z.ZodOptional<z.ZodObject<{
                 name: z.ZodString;
                 value: z.ZodString;
@@ -270,7 +269,6 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     placement: z.ZodOptional<z.ZodObject<{
-        region: z.ZodOptional<z.ZodString>;
         mode: z.ZodOptional<z.ZodEnum<{
             shared: "shared";
             dedicated: "dedicated";
@@ -299,6 +297,7 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
                 ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 agent: z.ZodOptional<z.ZodString>;
                 country: z.ZodOptional<z.ZodString>;
+                countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 header: z.ZodOptional<z.ZodObject<{
                     name: z.ZodString;
                     value: z.ZodString;

package/dist/contracts/space-config.js

@@ -128,9 +128,11 @@ export const spaceBuildSettingsSchema = z
 // (enums.ts) rather than declaring a second "shared"/"dedicated" enum —
 // space placement mode and normalized site class are the same axis.
 export const spacePlacementModeSchema = normalizedSiteClass;
+// No region knob: a space binds to the site it was placed on at creation and
+// the only placement change that relocates it is shared -> dedicated. Data
+// location is chosen once, at creation, and never changes.
 export const spacePlacementConfigSchema = z
     .object({
-    region: z.string().trim().min(1).optional(),
     mode: spacePlacementModeSchema.optional(),
     burstable: z.boolean().optional(),
 })