@vibesdotdev/infra-core 0.0.2 → 1.0.0-rc.5

package/dist/schemas/spend-guard.d.ts

@@ -0,0 +1,155 @@
+import * as z from 'zod/v4';
+/** USD a script may spend in the trailing hour and in the calendar month. */
+export declare const SpendBudgetSchema: z.ZodObject<{
+    hourlyUsd: z.ZodNumber;
+    monthlyUsd: z.ZodNumber;
+}, z.core.$strip>;
+export type SpendBudget = z.infer<typeof SpendBudgetSchema>;
+/** A script with no declared budget is capped at this ceiling. */
+export declare const DEFAULT_SPEND_BUDGET: SpendBudget;
+/**
+ * `stub` takes the script out of service; `alert` only reports. A script
+ * is `alert` when stopping it would stop the guard itself.
+ */
+export declare const SpendActionSchema: z.ZodEnum<{
+    stub: "stub";
+    alert: "alert";
+}>;
+export type SpendAction = z.infer<typeof SpendActionSchema>;
+export declare const SpendGuardScriptSchema: z.ZodObject<{
+    script: z.ZodString;
+    budget: z.ZodOptional<z.ZodObject<{
+        hourlyUsd: z.ZodOptional<z.ZodNumber>;
+        monthlyUsd: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    action: z.ZodOptional<z.ZodEnum<{
+        stub: "stub";
+        alert: "alert";
+    }>>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type SpendGuardScript = z.infer<typeof SpendGuardScriptSchema>;
+export declare const SpendGuardDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"infra/spend-guard">;
+    adapter: z.ZodString;
+    adapterConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    environment: z.ZodDefault<z.ZodString>;
+    budget: z.ZodDefault<z.ZodObject<{
+        hourlyUsd: z.ZodNumber;
+        monthlyUsd: z.ZodNumber;
+    }, z.core.$strip>>;
+    action: z.ZodDefault<z.ZodEnum<{
+        stub: "stub";
+        alert: "alert";
+    }>>;
+    scripts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        script: z.ZodString;
+        budget: z.ZodOptional<z.ZodObject<{
+            hourlyUsd: z.ZodOptional<z.ZodNumber>;
+            monthlyUsd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        action: z.ZodOptional<z.ZodEnum<{
+            stub: "stub";
+            alert: "alert";
+        }>>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SpendGuardDescriptor = z.infer<typeof SpendGuardDescriptorSchema>;
+export type SpendGuardDescriptorInput = z.input<typeof SpendGuardDescriptorSchema>;
+/** One script's priced usage. `breakdownUsd` is per billed meter. */
+export declare const ScriptSpendSchema: z.ZodObject<{
+    script: z.ZodString;
+    hourUsd: z.ZodNumber;
+    monthUsd: z.ZodNumber;
+    breakdownUsd: z.ZodObject<{
+        hour: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        month: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ScriptSpend = z.infer<typeof ScriptSpendSchema>;
+export declare const SpendMeasurementSchema: z.ZodObject<{
+    provider: z.ZodString;
+    collectedAt: z.ZodISODateTime;
+    hourStart: z.ZodISODateTime;
+    monthStart: z.ZodISODateTime;
+    pricing: z.ZodString;
+    scripts: z.ZodArray<z.ZodObject<{
+        script: z.ZodString;
+        hourUsd: z.ZodNumber;
+        monthUsd: z.ZodNumber;
+        breakdownUsd: z.ZodObject<{
+            hour: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            month: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    stubbed: z.ZodArray<z.ZodString>;
+    errors: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SpendMeasurement = z.infer<typeof SpendMeasurementSchema>;
+export interface SpendVerdict {
+    script: string;
+    state: 'ok' | 'over' | 'stubbed';
+    action: SpendAction;
+    budget: SpendBudget;
+    hourUsd: number;
+    monthUsd: number;
+    /** Set when over: which window broke. */
+    window?: 'hour' | 'month';
+}
+export declare const SpendTripReceiptSchema: z.ZodObject<{
+    script: z.ZodString;
+    stubVersionId: z.ZodString;
+    previous: z.ZodArray<z.ZodObject<{
+        versionId: z.ZodString;
+        percentage: z.ZodNumber;
+    }, z.core.$strip>>;
+    reason: z.ZodString;
+    trippedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type SpendTripReceipt = z.infer<typeof SpendTripReceiptSchema>;
+export interface SpendGuardImplementation {
+    measure(): Promise<SpendMeasurement>;
+    /** Deploy the stub to 100% of traffic. Idempotent for an already-stubbed script. */
+    trip(script: string, reason: string): Promise<SpendTripReceipt>;
+}
+export interface SpendGuardRun {
+    measurement: SpendMeasurement;
+    verdicts: SpendVerdict[];
+    tripped: SpendTripReceipt[];
+    alerted: SpendVerdict[];
+    failures: Array<{
+        script: string;
+        message: string;
+    }>;
+}
+export type SpendGuardRegistration = SpendGuardImplementation & {
+    create?(options: {
+        environment?: string;
+        descriptor?: SpendGuardDescriptor;
+    }): Promise<SpendGuardImplementation>;
+};
+//# sourceMappingURL=spend-guard.d.ts.map

package/dist/schemas/spend-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-guard.d.ts","sourceRoot":"","sources":["../../src/schemas/spend-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,EAAE,WAAgD,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;EAA4B,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF,qEAAqE;AACrE,eAAO,MAAM,iBAAiB;;;;;;;;iBAQ5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;iBAcjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;iBAOjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,wBAAwB;IACxC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,oFAAoF;IACpF,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,GAAG;IAC/D,MAAM,CAAC,CAAC,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,oBAAoB,CAAA;KAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjH,CAAC"}

package/dist/schemas/spend-guard.js

@@ -0,0 +1,61 @@
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+/** USD a script may spend in the trailing hour and in the calendar month. */
+export const SpendBudgetSchema = z.object({
+    hourlyUsd: z.number().positive(),
+    monthlyUsd: z.number().positive()
+});
+/** A script with no declared budget is capped at this ceiling. */
+export const DEFAULT_SPEND_BUDGET = { hourlyUsd: 25, monthlyUsd: 250 };
+/**
+ * `stub` takes the script out of service; `alert` only reports. A script
+ * is `alert` when stopping it would stop the guard itself.
+ */
+export const SpendActionSchema = z.enum(['stub', 'alert']);
+export const SpendGuardScriptSchema = z.object({
+    script: z.string().min(1),
+    budget: SpendBudgetSchema.partial().optional(),
+    action: SpendActionSchema.optional(),
+    /** Why this script differs from the default; required so overrides stay explained. */
+    reason: z.string().min(1)
+});
+export const SpendGuardDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('infra/spend-guard'),
+    adapter: z.string().min(1),
+    adapterConfig: z.record(z.string(), z.unknown()).optional(),
+    environment: z.string().default('local'),
+    budget: SpendBudgetSchema.default(DEFAULT_SPEND_BUDGET),
+    action: SpendActionSchema.default('stub'),
+    scripts: z.array(SpendGuardScriptSchema).refine((scripts) => new Set(scripts.map(({ script }) => script)).size === scripts.length, 'Script budget overrides must be unique.').default([])
+});
+/** One script's priced usage. `breakdownUsd` is per billed meter. */
+export const ScriptSpendSchema = z.object({
+    script: z.string().min(1),
+    hourUsd: z.number().nonnegative(),
+    monthUsd: z.number().nonnegative(),
+    breakdownUsd: z.object({
+        hour: z.record(z.string(), z.number().nonnegative()),
+        month: z.record(z.string(), z.number().nonnegative())
+    })
+});
+export const SpendMeasurementSchema = z.object({
+    provider: z.string().min(1),
+    collectedAt: z.iso.datetime({ offset: true }),
+    hourStart: z.iso.datetime({ offset: true }),
+    monthStart: z.iso.datetime({ offset: true }),
+    /** How prices were applied, so a reader can check the arithmetic. */
+    pricing: z.string().min(1),
+    scripts: z.array(ScriptSpendSchema).refine((scripts) => new Set(scripts.map(({ script }) => script)).size === scripts.length, 'Script measurements must be unique.'),
+    /** Scripts the guard already stubbed; they are not tripped twice. */
+    stubbed: z.array(z.string()),
+    errors: z.array(z.object({ source: z.string(), message: z.string() }))
+});
+export const SpendTripReceiptSchema = z.object({
+    script: z.string().min(1),
+    stubVersionId: z.string().min(1),
+    /** The versions that were serving, with their traffic share — the rollback target. */
+    previous: z.array(z.object({ versionId: z.string().min(1), percentage: z.number().min(0).max(100) })),
+    reason: z.string().min(1),
+    trippedAt: z.iso.datetime({ offset: true })
+});
+//# sourceMappingURL=spend-guard.js.map

package/dist/schemas/spend-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-guard.js","sourceRoot":"","sources":["../../src/schemas/spend-guard.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -1,30 +1,28 @@
 import * as z from 'zod/v4';
-/**
- * Deployment providers with active adapter implementations.
- * Only providers backed by adapter packages are enumerated.
- * - cloudflare-workers: via infra-cloudflare
- * - digitalocean-app: via infra-doks
- */
-export declare const deploymentProviderSchema: z.ZodEnum<{
-    "cloudflare-workers": "cloudflare-workers";
-    "digitalocean-app": "digitalocean-app";
-}>;
+export { deploymentOriginKindSchema } from '@vibesdotdev/infra-contracts';
+export type { DeploymentOriginKind } from '@vibesdotdev/infra-contracts';
+/** Provider IDs are open; the handed runtime admits registered capabilities. */
+export declare const deploymentProviderSchema: z.ZodString;
 export type DeploymentProvider = z.infer<typeof deploymentProviderSchema>;
 export declare const appRuntimeSchema: z.ZodEnum<{
-    edge: "edge";
+    browser: "browser";
     worker: "worker";
+    edge: "edge";
     node: "node";
-    browser: "browser";
 }>;
 export type AppRuntime = z.infer<typeof appRuntimeSchema>;
+/** The environment variables an upstream's origin is published as (`NAME` → origin). */
+export declare const deploymentOriginEnvSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export type DeploymentOriginEnv = z.infer<typeof deploymentOriginEnvSchema>;
 export declare const deploymentOriginSchema: z.ZodObject<{
     hostname: z.ZodString;
     origin: z.ZodString;
     kind: z.ZodDefault<z.ZodEnum<{
+        internal: "internal";
         primary: "primary";
         redirect: "redirect";
         preview: "preview";
-        internal: "internal";
+        alias: "alias";
     }>>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -45,11 +43,13 @@ export declare const deploymentEnvRequirementSchema: z.ZodObject<{
     secret: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
     storeKey: z.ZodOptional<z.ZodString>;
+    storeBinding: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type DeploymentEnvRequirement = z.infer<typeof deploymentEnvRequirementSchema>;
 export declare const deploymentDependencySchema: z.ZodObject<{
     appId: z.ZodString;
     reason: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type DeploymentDependency = z.infer<typeof deploymentDependencySchema>;
 export declare const deploymentUpstreamSchema: z.ZodObject<{
@@ -59,18 +59,23 @@ export declare const deploymentUpstreamSchema: z.ZodObject<{
     originEnvVar: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type DeploymentUpstream = z.infer<typeof deploymentUpstreamSchema>;
+/** Execution requirements validated against the registered provider at admission. */
+export declare const deploymentExecutionSchema: z.ZodOptional<z.ZodObject<{
+    pty: z.ZodOptional<z.ZodBoolean>;
+    shell: z.ZodOptional<z.ZodBoolean>;
+    maxSessions: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export type DeploymentExecution = z.infer<typeof deploymentExecutionSchema>;
 export declare const appDeploymentSchema: z.ZodObject<{
     appId: z.ZodString;
     appName: z.ZodString;
-    provider: z.ZodEnum<{
-        "cloudflare-workers": "cloudflare-workers";
-        "digitalocean-app": "digitalocean-app";
-    }>;
+    provider: z.ZodString;
+    providerPlugin: z.ZodOptional<z.ZodString>;
     runtime: z.ZodEnum<{
-        edge: "edge";
+        browser: "browser";
         worker: "worker";
+        edge: "edge";
         node: "node";
-        browser: "browser";
     }>;
     build: z.ZodObject<{
         workspaceRootDir: z.ZodDefault<z.ZodString>;
@@ -83,10 +88,11 @@ export declare const appDeploymentSchema: z.ZodObject<{
         hostname: z.ZodString;
         origin: z.ZodString;
         kind: z.ZodDefault<z.ZodEnum<{
+            internal: "internal";
             primary: "primary";
             redirect: "redirect";
             preview: "preview";
-            internal: "internal";
+            alias: "alias";
         }>>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -98,10 +104,12 @@ export declare const appDeploymentSchema: z.ZodObject<{
         secret: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
         storeKey: z.ZodOptional<z.ZodString>;
+        storeBinding: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
     dependsOn: z.ZodDefault<z.ZodArray<z.ZodObject<{
         appId: z.ZodString;
         reason: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>>;
     upstreams: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -119,7 +127,169 @@ export declare const appDeploymentSchema: z.ZodObject<{
         command: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    execution: z.ZodOptional<z.ZodObject<{
+        pty: z.ZodOptional<z.ZodBoolean>;
+        shell: z.ZodOptional<z.ZodBoolean>;
+        maxSessions: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    migrations: z.ZodOptional<z.ZodObject<{
+        requiredForLocalDev: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AppDeploymentInput = z.input<typeof appDeploymentSchema>;
 export type AppDeployment = z.infer<typeof appDeploymentSchema>;
+/** Default preview TTL in hours. Redeploys refresh `expiresAt` from this. */
+export declare const DEFAULT_PREVIEW_TTL_HOURS = 72;
+export declare const PreviewRecordStatusSchema: z.ZodEnum<{
+    building: "building";
+    failed: "failed";
+    live: "live";
+    destroyed: "destroyed";
+}>;
+export type PreviewRecordStatus = z.infer<typeof PreviewRecordStatusSchema>;
+export declare const PreviewRepoOfRecordSchema: z.ZodEnum<{
+    forge: "forge";
+    github: "github";
+}>;
+export type PreviewRepoOfRecord = z.infer<typeof PreviewRepoOfRecordSchema>;
+export declare const PreviewSecretsModeSchema: z.ZodEnum<{
+    namespace: "namespace";
+    "script-pushed": "script-pushed";
+}>;
+export type PreviewSecretsMode = z.infer<typeof PreviewSecretsModeSchema>;
+/** Provider-reported availability for one declared preview capability. */
+export declare const PreviewCapabilityStatusSchema: z.ZodEnum<{
+    unavailable: "unavailable";
+    available: "available";
+    degraded: "degraded";
+    "not-declared": "not-declared";
+}>;
+export type PreviewCapabilityStatus = z.infer<typeof PreviewCapabilityStatusSchema>;
+/** Resource isolation achieved by a rendered preview binding. */
+export declare const PreviewCapabilityIsolationSchema: z.ZodEnum<{
+    none: "none";
+    "preview-tier": "preview-tier";
+    "shared-external": "shared-external";
+    "not-applicable": "not-applicable";
+}>;
+export type PreviewCapabilityIsolation = z.infer<typeof PreviewCapabilityIsolationSchema>;
+/** Machine-readable proof of what one preview capability actually renders. */
+export declare const PreviewCapabilitySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        unavailable: "unavailable";
+        available: "available";
+        degraded: "degraded";
+        "not-declared": "not-declared";
+    }>;
+    isolation: z.ZodEnum<{
+        none: "none";
+        "preview-tier": "preview-tier";
+        "shared-external": "shared-external";
+        "not-applicable": "not-applicable";
+    }>;
+    critical: z.ZodBoolean;
+    declared: z.ZodArray<z.ZodString>;
+    rendered: z.ZodArray<z.ZodString>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type PreviewCapability = z.infer<typeof PreviewCapabilitySchema>;
+export declare const PreviewFidelityLevelSchema: z.ZodEnum<{
+    degraded: "degraded";
+    full: "full";
+}>;
+export type PreviewFidelityLevel = z.infer<typeof PreviewFidelityLevelSchema>;
+/**
+ * Provider-neutral preview fidelity envelope. Providers own the capability
+ * facts; orchestration surfaces expose this exact shape and may require
+ * `level: 'full'` before any build or upload begins.
+ */
+export declare const PreviewFidelitySchema: z.ZodObject<{
+    level: z.ZodEnum<{
+        degraded: "degraded";
+        full: "full";
+    }>;
+    fullFidelity: z.ZodBoolean;
+    criticalMissing: z.ZodArray<z.ZodString>;
+    capabilities: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            available: "available";
+            degraded: "degraded";
+            "not-declared": "not-declared";
+        }>;
+        isolation: z.ZodEnum<{
+            none: "none";
+            "preview-tier": "preview-tier";
+            "shared-external": "shared-external";
+            "not-applicable": "not-applicable";
+        }>;
+        critical: z.ZodBoolean;
+        declared: z.ZodArray<z.ZodString>;
+        rendered: z.ZodArray<z.ZodString>;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PreviewFidelity = z.infer<typeof PreviewFidelitySchema>;
+/**
+ * Current-state record for one preview deployment (one per previewId).
+ * Persisted as the `infra-deploy.previews` storage manifest (infra-deploy);
+ * `runId` references the matching `deployment_runs` history row.
+ */
+export declare const PreviewRecordSchema: z.ZodObject<{
+    previewId: z.ZodString;
+    appId: z.ZodString;
+    branch: z.ZodString;
+    worktreePath: z.ZodOptional<z.ZodString>;
+    previewRef: z.ZodOptional<z.ZodString>;
+    sha: z.ZodString;
+    repoOfRecord: z.ZodDefault<z.ZodEnum<{
+        forge: "forge";
+        github: "github";
+    }>>;
+    buildJobId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        building: "building";
+        failed: "failed";
+        live: "live";
+        destroyed: "destroyed";
+    }>;
+    url: z.ZodString;
+    dispatchScript: z.ZodString;
+    secretsMode: z.ZodDefault<z.ZodEnum<{
+        namespace: "namespace";
+        "script-pushed": "script-pushed";
+    }>>;
+    fidelity: z.ZodOptional<z.ZodObject<{
+        level: z.ZodEnum<{
+            degraded: "degraded";
+            full: "full";
+        }>;
+        fullFidelity: z.ZodBoolean;
+        criticalMissing: z.ZodArray<z.ZodString>;
+        capabilities: z.ZodRecord<z.ZodString, z.ZodObject<{
+            status: z.ZodEnum<{
+                unavailable: "unavailable";
+                available: "available";
+                degraded: "degraded";
+                "not-declared": "not-declared";
+            }>;
+            isolation: z.ZodEnum<{
+                none: "none";
+                "preview-tier": "preview-tier";
+                "shared-external": "shared-external";
+                "not-applicable": "not-applicable";
+            }>;
+            critical: z.ZodBoolean;
+            declared: z.ZodArray<z.ZodString>;
+            rendered: z.ZodArray<z.ZodString>;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    ttlHours: z.ZodDefault<z.ZodNumber>;
+    expiresAt: z.ZodString;
+    createdBy: z.ZodString;
+    runId: z.ZodString;
+}, z.core.$strip>;
+export type PreviewRecordInput = z.input<typeof PreviewRecordSchema>;
+export type PreviewRecord = z.infer<typeof PreviewRecordSchema>;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;EAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAW1E,eAAO,MAAM,gBAAgB;;;;;EAAgD,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,8BAA8B;;;;;;;;iBAazC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,wBAAwB;;;;;iBAQnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+C9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}