@figulus/schema 0.4.0-alpha-dev → 0.5.0-alpha-dev-2

package/dist/core/entities/figspec.js

@@ -0,0 +1,73 @@
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+import { z } from 'zod';
+import { buildExecuteStepSchema, executeMainCmdSchema, executeShutdownCmdSchema, executeStartupCmdSchema, scheduledCmdSchema } from '../execute.js';
+import { installGroupSchema, portMappingSchema } from '../generic.js';
+import { buildVolumeMountSchema, runVolumeMountSchema } from '../volumes.js';
+extendZodWithOpenApi(z);
+// ---------------------------------------------------------------------------
+// Execute model
+// ---------------------------------------------------------------------------
+export const figSpecExecuteSchema = z.object({
+    startup: z.array(executeStartupCmdSchema).optional().describe("Commands that run before main (sync commands block main start)"),
+    main: executeMainCmdSchema,
+    shutdown: z.array(executeShutdownCmdSchema).optional().describe("Commands that run before the container stops"),
+    scheduled: z.array(scheduledCmdSchema).optional(),
+}).openapi("FigSpecExecute");
+// ---------------------------------------------------------------------------
+// Build spec
+// ---------------------------------------------------------------------------
+export const figSpecBuildBaseSchema = z.object({
+    schemaVersion: z.string().optional(),
+    specName: z.string().optional(),
+    packagesToInstall: z.array(installGroupSchema).optional(),
+    platform: z.string().optional().describe("Target platform, e.g. \"linux/amd64\" or \"linux/arm64\"").openapi({ example: "linux/amd64" }),
+    env: z.record(z.string(), z.string()).optional().describe("Build-time environment variables"),
+    volumes: z.array(buildVolumeMountSchema).optional(),
+    execute: z.array(buildExecuteStepSchema).optional().describe("Ordered list of RUN instructions; each step is a separate cacheable layer"),
+    workDir: z.string().optional().describe("Working directory inside the image"),
+    user: z.string().optional().describe("User to run build commands as (e.g. \"root\")"),
+}).openapi("FigSpecBuildBase");
+export const figSpecBuildStandaloneSchema = figSpecBuildBaseSchema.extend({
+    baseImage: z.string(),
+}).openapi("FigSpecBuildStandalone");
+export const figSpecBuildWithBaseSpecSchema = figSpecBuildBaseSchema.extend({
+    baseSpec: z.string(),
+    baseImage: z.string().optional(),
+}).openapi("FigSpecBuildWithBaseSpec");
+export const figSpecBuildSchema = z.union([
+    figSpecBuildStandaloneSchema,
+    figSpecBuildWithBaseSpecSchema,
+]);
+// ---------------------------------------------------------------------------
+// Run spec
+// ---------------------------------------------------------------------------
+export const figSpecRunSchema = z.object({
+    schemaVersion: z.string().optional(),
+    specName: z.string().optional(),
+    execute: figSpecExecuteSchema,
+    env: z.record(z.string(), z.string()).optional(),
+    secrets: z.record(z.string(), z.string()).optional().describe("Secret references: env_name → \"vault:path#field\""),
+    volumes: z.array(runVolumeMountSchema).optional(),
+    workDir: z.string().optional(),
+    user: z.string().optional(),
+    ports: z.array(portMappingSchema).optional(),
+}).openapi("FigSpecRun");
+// ---------------------------------------------------------------------------
+// Top-level Figspec document
+// ---------------------------------------------------------------------------
+export const figSpecBuildInputSchema = z.union([
+    figSpecBuildSchema,
+    z.string(),
+    z.array(z.string()),
+]).openapi("FigSpecBuildInput");
+export const figSpecRunInputSchema = z.union([
+    figSpecRunSchema,
+    z.string(),
+]).openapi("FigSpecRunInput");
+export const figSpecSchema = z.object({
+    schemaVersion: z.string(),
+    specName: z.string().optional(),
+    build: figSpecBuildInputSchema,
+    run: figSpecRunInputSchema.optional(),
+}).openapi("FigSpec");
+//# sourceMappingURL=figspec.js.map

package/dist/core/entities/figspec.js.map

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

package/dist/core/entities/figstack.d.ts

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+export declare const figStackDependencySchema: z.ZodObject<{
+    name: z.ZodString;
+    condition: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        started: "started";
+        healthy: "healthy";
+        completed: "completed";
+    }>>>;
+}, z.core.$strip>;
+export type FigStackDependency = z.infer<typeof figStackDependencySchema>;
+export declare const figStackHealthCheckSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        exec: "exec";
+        http: "http";
+        tcp: "tcp";
+    }>;
+    cmd: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    port: z.ZodOptional<z.ZodInt>;
+    method: z.ZodOptional<z.ZodEnum<{
+        GET: "GET";
+        HEAD: "HEAD";
+    }>>;
+    expectedStatus: z.ZodOptional<z.ZodInt>;
+    intervalSeconds: z.ZodOptional<z.ZodInt>;
+    timeoutSeconds: z.ZodOptional<z.ZodInt>;
+    retries: z.ZodOptional<z.ZodInt>;
+    startPeriodSeconds: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+export type FigStackHealthCheck = z.infer<typeof figStackHealthCheckSchema>;
+export declare const figStackSpecSchema: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodString]>;
+export declare const figStackEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    spec: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodString]>;
+    ports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        container: z.ZodInt;
+        host: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strip>>>;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        condition: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            started: "started";
+            healthy: "healthy";
+            completed: "completed";
+        }>>>;
+    }, z.core.$strip>>>;
+    healthCheck: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            exec: "exec";
+            http: "http";
+            tcp: "tcp";
+        }>;
+        cmd: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        port: z.ZodOptional<z.ZodInt>;
+        method: z.ZodOptional<z.ZodEnum<{
+            GET: "GET";
+            HEAD: "HEAD";
+        }>>;
+        expectedStatus: z.ZodOptional<z.ZodInt>;
+        intervalSeconds: z.ZodOptional<z.ZodInt>;
+        timeoutSeconds: z.ZodOptional<z.ZodInt>;
+        retries: z.ZodOptional<z.ZodInt>;
+        startPeriodSeconds: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strip>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type FigStackEntry = z.infer<typeof figStackEntrySchema>;
+export declare const figStackNetworkConfigSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    subnet: z.ZodOptional<z.ZodString>;
+    external: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FigStackNetworkConfig = z.infer<typeof figStackNetworkConfigSchema>;
+export declare const figStackVolumeDeclarationSchema: z.ZodObject<{
+    name: z.ZodString;
+    external: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FigStackVolumeDeclaration = z.infer<typeof figStackVolumeDeclarationSchema>;
+export declare const figStackEnvGroupSchema: z.ZodObject<{
+    vars: z.ZodRecord<z.ZodString, z.ZodString>;
+    inject: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type FigStackEnvGroup = z.infer<typeof figStackEnvGroupSchema>;
+export declare const figStackSchema: z.ZodObject<{
+    schemaVersion: z.ZodString;
+    stackName: z.ZodString;
+    containers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        spec: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodString]>;
+        ports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            container: z.ZodInt;
+            host: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strip>>>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            condition: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                started: "started";
+                healthy: "healthy";
+                completed: "completed";
+            }>>>;
+        }, z.core.$strip>>>;
+        healthCheck: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                exec: "exec";
+                http: "http";
+                tcp: "tcp";
+            }>;
+            cmd: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            port: z.ZodOptional<z.ZodInt>;
+            method: z.ZodOptional<z.ZodEnum<{
+                GET: "GET";
+                HEAD: "HEAD";
+            }>>;
+            expectedStatus: z.ZodOptional<z.ZodInt>;
+            intervalSeconds: z.ZodOptional<z.ZodInt>;
+            timeoutSeconds: z.ZodOptional<z.ZodInt>;
+            retries: z.ZodOptional<z.ZodInt>;
+            startPeriodSeconds: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strip>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        vars: z.ZodRecord<z.ZodString, z.ZodString>;
+        inject: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    network: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        subnet: z.ZodOptional<z.ZodString>;
+        external: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    volumes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        external: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type FigStack = z.infer<typeof figStackSchema>;
+//# sourceMappingURL=figstack.d.ts.map

package/dist/core/entities/figstack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figstack.d.ts","sourceRoot":"","sources":["../../../src/core/entities/figstack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,wBAAwB;;;;;;;iBAGL,CAAC;AACjC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;iBAcL,CAAC;AAClC,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAO5E,eAAO,MAAM,kBAAkB,oEAGL,CAAC;AAE3B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOL,CAAC;AAC5B,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,2BAA2B;;;;iBAIL,CAAC;AACpC,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAMhF,eAAO,MAAM,+BAA+B;;;iBAGL,CAAC;AACxC,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,eAAO,MAAM,sBAAsB;;;iBAGL,CAAC;AAC/B,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOL,CAAC;AACvB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/core/entities/figstack.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { portMappingSchema } from '../generic.js';
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+extendZodWithOpenApi(z);
+// ---------------------------------------------------------------------------
+// FigStackDependency
+// ---------------------------------------------------------------------------
+export const figStackDependencySchema = z.object({
+    name: z.string().min(1).describe("References another entry's name in this stack."),
+    condition: z.enum(['started', 'healthy', 'completed']).default('started').optional().describe("started — wait for the container to be running; healthy — wait for the health check to pass; completed — wait for the container to exit successfully."),
+}).openapi("FigStackDependency");
+// ---------------------------------------------------------------------------
+// FigStackHealthCheck (discriminated union flattened into one object)
+// ---------------------------------------------------------------------------
+export const figStackHealthCheckSchema = z.object({
+    type: z.enum(['exec', 'http', 'tcp']),
+    // exec
+    cmd: z.string().optional().describe("Shell command to run inside the container (exec type only)."),
+    // http
+    path: z.string().optional().describe("HTTP path to check (http type only). Example: /health"),
+    port: z.int().optional().describe("Container port to check (http and tcp types)."),
+    method: z.enum(['GET', 'HEAD']).optional().describe("HTTP method (http type only)."),
+    expectedStatus: z.int().optional().describe("Expected HTTP status code (http type only)."),
+    // shared timing
+    intervalSeconds: z.int().optional(),
+    timeoutSeconds: z.int().optional(),
+    retries: z.int().optional(),
+    startPeriodSeconds: z.int().optional().describe("Grace period before failures count against the retry limit."),
+}).openapi("FigStackHealthCheck");
+// ---------------------------------------------------------------------------
+// FigStackEntry
+// ---------------------------------------------------------------------------
+// Inline FigSpec reference: either an object or a string reference
+export const figStackSpecSchema = z.union([
+    z.object({}).passthrough().openapi({ type: "object" }),
+    z.string()
+]).openapi("FigStackSpec");
+export const figStackEntrySchema = z.object({
+    name: z.string().min(1).describe("Unique container name within the stack; also the hostname on the shared network.").openapi({ example: "postgres" }),
+    spec: figStackSpecSchema.describe("Inline FigSpec object or string reference (e.g. \"postgres#default\")."),
+    ports: z.array(portMappingSchema).optional().describe("Overrides spec.run.ports for this deployment."),
+    dependsOn: z.array(figStackDependencySchema).optional(),
+    healthCheck: figStackHealthCheckSchema.optional(),
+    env: z.record(z.string(), z.string()).optional().describe("Entry-level environment variable overrides (run-time only)."),
+}).openapi("FigStackEntry");
+// ---------------------------------------------------------------------------
+// FigStackNetworkConfig
+// ---------------------------------------------------------------------------
+export const figStackNetworkConfigSchema = z.object({
+    name: z.string().optional().describe("Custom Docker network name. Defaults to {stackName}_network."),
+    subnet: z.string().optional().describe("Optional CIDR for predictable container IPs. Example: 172.20.0.0/16"),
+    external: z.string().optional().describe("Join an existing external Docker network by name instead of creating one."),
+}).openapi("FigStackNetworkConfig");
+// ---------------------------------------------------------------------------
+// FigStackVolumeDeclaration
+// ---------------------------------------------------------------------------
+export const figStackVolumeDeclarationSchema = z.object({
+    name: z.string().min(1).describe("Exact Docker volume name — no stack prefix is applied."),
+    external: z.boolean().optional().describe("If true, the volume must already exist; the engine will not create it."),
+}).openapi("FigStackVolumeDeclaration");
+// ---------------------------------------------------------------------------
+// FigStackEnvGroup
+// ---------------------------------------------------------------------------
+export const figStackEnvGroupSchema = z.object({
+    vars: z.record(z.string(), z.string()),
+    inject: z.array(z.string()).optional().describe("Container names to inject into. Omit to inject into all containers."),
+}).openapi("FigStackEnvGroup");
+// ---------------------------------------------------------------------------
+// FigStack (top-level)
+// ---------------------------------------------------------------------------
+export const figStackSchema = z.object({
+    schemaVersion: z.string().openapi({ example: "0.1" }),
+    stackName: z.string().min(1).openapi({ example: "blog" }),
+    containers: z.array(figStackEntrySchema).min(1),
+    env: z.array(figStackEnvGroupSchema).optional(),
+    network: figStackNetworkConfigSchema.optional(),
+    volumes: z.array(figStackVolumeDeclarationSchema).optional(),
+}).openapi("FigStack");
+//# sourceMappingURL=figstack.js.map

package/dist/core/entities/figstack.js.map

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

package/dist/core/entities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './figspec.js';
+export * from './figstack.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/core/entities/index.js

@@ -0,0 +1,3 @@
+export * from './figspec.js';
+export * from './figstack.js';
+//# sourceMappingURL=index.js.map

package/dist/core/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/core/execute.d.ts

@@ -0,0 +1,64 @@
+import z from "zod";
+export declare const mainCmdOnExitWithCodeSchema: z.ZodObject<{
+    cmd: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    exitCode: z.ZodInt;
+}, z.core.$strip>;
+export type MainCmdOnExitWithCode = z.infer<typeof mainCmdOnExitWithCodeSchema>;
+export declare const mainCmdOnExitListSchema: z.ZodArray<z.ZodObject<{
+    cmd: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    exitCode: z.ZodInt;
+}, z.core.$strip>>;
+export declare const onExitBehaviorSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNull, z.ZodArray<z.ZodObject<{
+    cmd: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    exitCode: z.ZodInt;
+}, z.core.$strip>>]>;
+export type OnExitBehavior = z.infer<typeof onExitBehaviorSchema>;
+export declare const executeStartupCmdSchema: z.ZodObject<{
+    cmd: z.ZodString;
+    async: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ExecuteStartupCmd = z.infer<typeof executeStartupCmdSchema>;
+export declare const executeMainCmdSchema: z.ZodObject<{
+    cmd: z.ZodString;
+    onExit: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull, z.ZodArray<z.ZodObject<{
+        cmd: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        exitCode: z.ZodInt;
+    }, z.core.$strip>>]>>;
+    parser: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ExecuteMainCmd = z.infer<typeof executeMainCmdSchema>;
+export declare const executeShutdownCmdSchema: z.ZodObject<{
+    cmd: z.ZodString;
+}, z.core.$strip>;
+export type ExecuteShutdownCmd = z.infer<typeof executeShutdownCmdSchema>;
+export declare const scheduleExpressionStructSchema: z.ZodObject<{
+    interval: z.ZodOptional<z.ZodInt>;
+    time: z.ZodOptional<z.ZodString>;
+    cron: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ScheduleExpressionStruct = z.infer<typeof scheduleExpressionStructSchema>;
+export declare const scheduleExpressionSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    interval: z.ZodOptional<z.ZodInt>;
+    time: z.ZodOptional<z.ZodString>;
+    cron: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type ScheduleExpression = z.infer<typeof scheduleExpressionSchema>;
+export declare const scheduledCmdSchema: z.ZodObject<{
+    cmd: z.ZodString;
+    runAt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        interval: z.ZodOptional<z.ZodInt>;
+        time: z.ZodOptional<z.ZodString>;
+        cron: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>;
+    onExit: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull, z.ZodArray<z.ZodObject<{
+        cmd: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        exitCode: z.ZodInt;
+    }, z.core.$strip>>]>>;
+    parser: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ScheduledCmd = z.infer<typeof scheduledCmdSchema>;
+export declare const buildExecuteStepSchema: z.ZodObject<{
+    cmd: z.ZodString;
+}, z.core.$strip>;
+export type BuildExecuteStep = z.infer<typeof buildExecuteStepSchema>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/core/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/core/execute.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAKpB,eAAO,MAAM,2BAA2B;;;iBAGL,CAAC;AACpC,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,uBAAuB;;;kBAEnC,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;oBAIL,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,uBAAuB;;;iBAGL,CAAC;AAChC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB;;;;;;;iBAIL,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;iBAEL,CAAC;AACjC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,8BAA8B;;;;iBAIL,CAAC;AACvC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,wBAAwB;;;;mBAGL,CAAC;AACjC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAKL,CAAC;AAC3B,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;iBAEL,CAAC;AAC/B,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/core/execute.js

@@ -0,0 +1,45 @@
+import z from "zod";
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+extendZodWithOpenApi(z);
+export const mainCmdOnExitWithCodeSchema = z.object({
+    cmd: z.union([z.string(), z.null()]).optional().describe("Action: a command string, \"persist\", \"shutdown\", or null"),
+    exitCode: z.int(),
+}).openapi("MainCmdOnExitWithCode");
+export const mainCmdOnExitListSchema = z.array(mainCmdOnExitWithCodeSchema);
+// onExit accepts: null | "persist" | "shutdown" | command-string | dispatch-table
+export const onExitBehaviorSchema = z.union([
+    z.string(),
+    z.null(),
+    z.array(mainCmdOnExitWithCodeSchema),
+]).openapi("OnExitBehavior");
+export const executeStartupCmdSchema = z.object({
+    cmd: z.string().describe("Shell command to run before the main process"),
+    async: z.boolean().optional().describe("Fire-and-forget if true; blocks main start if false"),
+}).openapi("ExecuteStartupCmd");
+export const executeMainCmdSchema = z.object({
+    cmd: z.string().describe("Primary command the container runs"),
+    onExit: onExitBehaviorSchema.optional(),
+    parser: z.string().optional().describe("JavaScript parser source or URI for structured output"),
+}).openapi("ExecuteMainCmd");
+export const executeShutdownCmdSchema = z.object({
+    cmd: z.string().describe("Shell command to run before the container stops"),
+}).openapi("ExecuteShutdownCmd");
+export const scheduleExpressionStructSchema = z.object({
+    interval: z.int().optional().describe("Seconds after startup, or repeat interval"),
+    time: z.string().optional().describe("Daily run time in \"HH:MM\" format"),
+    cron: z.string().optional().describe("Cron expression (e.g. \"0 9 * * *\")"),
+}).openapi("ScheduleExpressionStruct");
+export const scheduleExpressionSchema = z.union([
+    z.string(),
+    scheduleExpressionStructSchema,
+]).openapi("ScheduleExpression");
+export const scheduledCmdSchema = z.object({
+    cmd: z.string(),
+    runAt: scheduleExpressionSchema,
+    onExit: onExitBehaviorSchema.optional(),
+    parser: z.string().optional(),
+}).openapi("ScheduledCmd");
+export const buildExecuteStepSchema = z.object({
+    cmd: z.string().min(1).describe("Shell command to run as a separate RUN instruction (cacheable layer)").openapi({ example: "apt-get install -y curl" }),
+}).openapi("BuildExecuteStep");
+//# sourceMappingURL=execute.js.map

package/dist/core/execute.js.map

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

package/dist/core/generic.d.ts

@@ -0,0 +1,35 @@
+import z from "zod";
+export declare const resourceLimitsSchema: z.ZodObject<{
+    memory_limit: z.ZodOptional<z.ZodString>;
+    memory_reservation: z.ZodOptional<z.ZodString>;
+    cpu_limit: z.ZodOptional<z.ZodString>;
+    cpu_reservation: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ResourceLimits = z.infer<typeof resourceLimitsSchema>;
+export declare const portMappingSchema: z.ZodObject<{
+    container: z.ZodInt;
+    host: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+export type PortMapping = z.infer<typeof portMappingSchema>;
+export declare const parsedOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ParsedOutput = z.infer<typeof parsedOutputSchema>;
+export declare const packageSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PackageSpec = z.infer<typeof packageSpecSchema>;
+export declare const installGroupSchema: z.ZodObject<{
+    packageManager: z.ZodString;
+    packages: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>]>>;
+    globalArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type InstallGroup = z.infer<typeof installGroupSchema>;
+//# sourceMappingURL=generic.d.ts.map

package/dist/core/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/core/generic.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAKpB,eAAO,MAAM,oBAAoB;;;;;iBAKL,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;;iBAGL,CAAC;AAC1B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;iBAGL,CAAC;AAC3B,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;iBAIL,CAAC;AAC1B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;iBAIL,CAAC;AAC3B,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/core/generic.js

@@ -0,0 +1,28 @@
+import z from "zod";
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+extendZodWithOpenApi(z);
+export const resourceLimitsSchema = z.object({
+    memory_limit: z.string().optional().describe("e.g. \"2G\", \"512M\"").openapi({ example: "2G" }),
+    memory_reservation: z.string().optional().describe("Soft memory limit, e.g. \"1G\"").openapi({ example: "1G" }),
+    cpu_limit: z.string().optional().describe("e.g. \"2\", \"0.5\"").openapi({ example: "2" }),
+    cpu_reservation: z.string().optional().describe("Soft CPU limit, e.g. \"1\"").openapi({ example: "1" }),
+}).openapi("ResourceLimits");
+export const portMappingSchema = z.object({
+    container: z.int().min(1).max(65535).describe("Container port").openapi({ example: 3000 }),
+    host: z.int().min(0).max(65535).optional().describe("Host port. 0 or omitted means same as container port.").openapi({ example: 8080 }),
+}).openapi("PortMapping");
+export const parsedOutputSchema = z.object({
+    success: z.boolean(),
+    data: z.record(z.string(), z.unknown()).optional().describe("Arbitrary structured data produced by the parser script"),
+}).openapi("ParsedOutput");
+export const packageSpecSchema = z.object({
+    name: z.string(),
+    version: z.string().optional(),
+    args: z.array(z.string()).optional(),
+}).openapi("PackageSpec");
+export const installGroupSchema = z.object({
+    packageManager: z.string().min(1).describe("Package manager to use (e.g. \"apt\", \"npm\", \"pip\")"),
+    packages: z.array(z.union([z.string(), packageSpecSchema])),
+    globalArgs: z.array(z.string()).optional().describe("Arguments passed to every package install invocation"),
+}).openapi("InstallGroup");
+//# sourceMappingURL=generic.js.map

package/dist/core/generic.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './primitives.js';
+export * from './generic.js';
+export * from './execute.js';
+export * from './volumes.js';
+export * from './entities/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from './primitives.js';
+export * from './generic.js';
+export * from './execute.js';
+export * from './volumes.js';
+export * from './entities/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}

package/dist/core/primitives.d.ts

@@ -0,0 +1,3 @@
+import z from "zod";
+export declare const bigIntSchema: z.ZodBigInt;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/core/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAKpB,eAAO,MAAM,YAAY,aAMvB,CAAC"}

package/dist/core/primitives.js

@@ -0,0 +1,11 @@
+import z from "zod";
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+extendZodWithOpenApi(z);
+export const bigIntSchema = z
+    .bigint()
+    .describe("An integer between 3n and 5n")
+    .openapi("BigInt", {
+    format: "int64",
+    type: "integer",
+});
+//# sourceMappingURL=primitives.js.map

package/dist/core/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,QAAQ,CAAC,8BAA8B,CAAC;KACxC,OAAO,CAAC,QAAQ,EAAE;IACf,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,SAAS;CAClB,CAAC,CAAC"}