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

package/dist/engine/paths/sessions.js

@@ -0,0 +1,484 @@
+import z from "zod";
+import { createSessionRequestSchema, createSessionResponseSchema, getRunResponseSchema, getSessionResponseSchema, listRunsResponseSchema, runInSessionRequestSchema, runInSessionResponseSchema, syncFileRequestSchema, syncFileResponseSchema } from "../sessions.js";
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+import { errorResponseSchema } from "../response.js";
+extendZodWithOpenApi(z);
+export const listSessionsRouteSchema = {
+    method: "get",
+    path: "/api/v1/sessions",
+    operationId: "listSessions",
+    summary: "List all active sessions",
+    description: "Returns all active sessions from the session store (memory and Valkey).",
+    tags: [
+        "sessions"
+    ],
+    responses: {
+        200: {
+            description: "List of active sessions",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        sessions: getSessionResponseSchema.array(),
+                        count: z.int(),
+                    })
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable (Valkey not configured)",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const createSessionRouteSchema = {
+    method: "post",
+    path: "/api/v1/sessions",
+    operationId: "createSession",
+    summary: "Create a persistent session",
+    description: "Creates and starts a persistent container session. Returns 503 if Valkey is not configured (session management unavailable).",
+    tags: [
+        "sessions"
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: createSessionRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        201: {
+            description: "Session created",
+            content: {
+                "application/json": {
+                    schema: createSessionResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing image_tag or invalid request",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Failed to create session",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable (Valkey not configured)",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const getSessionRouteSchema = {
+    method: "get",
+    path: "/api/v1/sessions/{sessionId}",
+    operationId: "getSession",
+    summary: "Get session details",
+    description: "Returns the current status and metadata for a session, with container liveness verification.",
+    tags: [
+        "sessions"
+    ],
+    parameters: [
+        {
+            name: "sessionId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "sess-abc123"
+        }
+    ],
+    responses: {
+        200: {
+            description: "Session details",
+            content: {
+                "application/json": {
+                    schema: getSessionResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing sessionId",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Session not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const deleteSessionRouteSchema = {
+    method: "delete",
+    path: "/api/v1/sessions/{sessionId}",
+    operationId: "deleteSession",
+    summary: "Delete a session",
+    description: "Destroys the session and its container.",
+    tags: [
+        "sessions"
+    ],
+    parameters: [
+        {
+            name: "sessionId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "sess-abc123"
+        }
+    ],
+    responses: {
+        200: {
+            description: "Session deleted",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        message: z.string(),
+                        session_id: z.string(),
+                    }),
+                    example: {
+                        message: "Session deleted successfully",
+                        session_id: "sess-abc123"
+                    }
+                }
+            }
+        },
+        400: {
+            description: "Missing sessionId",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Session not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const runInSessionRouteSchema = {
+    method: "post",
+    path: "/api/v1/sessions/{sessionId}/run",
+    operationId: "runInSession",
+    summary: "Run a command in a session",
+    description: "Executes a command inside the session container and returns the result. Blocks until command completes or timeout is reached.",
+    tags: [
+        "sessions"
+    ],
+    parameters: [
+        {
+            name: "sessionId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "sess-abc123"
+        }
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: runInSessionRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        200: {
+            description: "Command completed",
+            content: {
+                "application/json": {
+                    schema: runInSessionResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing command or invalid request",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Session not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Run failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const syncFileInSessionRouteSchema = {
+    method: "post",
+    path: "/api/v1/sessions/{sessionId}/sync-file",
+    operationId: "syncFileInSession",
+    summary: "Sync a file into a session container",
+    description: "Writes a file to an absolute path inside the running session container. Content must be base64-encoded (default) or utf8 as specified by encoding.",
+    tags: [
+        "sessions"
+    ],
+    parameters: [
+        {
+            name: "sessionId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "sess-abc123"
+        }
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: syncFileRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        200: {
+            description: "File written successfully",
+            content: {
+                "application/json": {
+                    schema: syncFileResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing targetPath/content, invalid encoding, invalid base64, or invalid path",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Session not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        409: {
+            description: "Container is no longer running",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "File write failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const listSessionRunsRouteSchema = {
+    method: "get",
+    path: "/api/v1/sessions/{sessionId}/runs",
+    operationId: "listSessionRuns",
+    summary: "List all runs for a session",
+    description: "Returns all cached runs for a session, ordered by start time ascending.",
+    tags: [
+        "sessions"
+    ],
+    parameters: [
+        {
+            name: "sessionId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "sess-abc123"
+        }
+    ],
+    responses: {
+        200: {
+            description: "List of runs",
+            content: {
+                "application/json": {
+                    schema: listRunsResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing sessionId",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Internal error",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const getSessionRunRouteSchema = {
+    method: "get",
+    path: "/api/v1/sessions/{sessionId}/runs/{runId}",
+    operationId: "getSessionRun",
+    summary: "Get a previous run result",
+    description: "Retrieves the stored result of a past run within a session.",
+    tags: [
+        "sessions"
+    ],
+    parameters: [
+        {
+            name: "sessionId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "sess-abc123"
+        },
+        {
+            name: "runId",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "run-def456"
+        }
+    ],
+    responses: {
+        200: {
+            description: "Run details",
+            content: {
+                "application/json": {
+                    schema: getRunResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing runId",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Run not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Session management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=sessions.js.map

package/dist/engine/paths/sessions.js.map

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

package/dist/engine/paths/stacks.d.ts

@@ -0,0 +1,6 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const startStackRouteSchema: RouteConfig;
+export declare const listStacksRouteSchema: RouteConfig;
+export declare const getStackRouteSchema: RouteConfig;
+export declare const stopStackRouteSchema: RouteConfig;
+//# sourceMappingURL=stacks.d.ts.map

package/dist/engine/paths/stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/stacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAI7D,eAAO,MAAM,qBAAqB,EAAE,WAsDnC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WA2BnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WA8CjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAyClC,CAAC"}

package/dist/engine/paths/stacks.js

@@ -0,0 +1,175 @@
+import { getStackResponseSchema, listStacksResponseSchema, startStackRequestSchema, startStackResponseSchema } from "../sessions.js";
+import { errorResponseSchema } from "../response.js";
+export const startStackRouteSchema = {
+    method: "post",
+    path: "/api/v1/stacks",
+    operationId: "startStack",
+    summary: "Start a FigStack",
+    description: "Parse the FigStack spec and start all containers in dependency order. Optionally builds all required images first if build=true.",
+    tags: [
+        "stacks"
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: startStackRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        201: {
+            description: "Stack started successfully",
+            content: {
+                "application/json": {
+                    schema: startStackResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Invalid request or spec",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Stack startup failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Stack management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const listStacksRouteSchema = {
+    method: "get",
+    path: "/api/v1/stacks",
+    operationId: "listStacks",
+    summary: "List all running FigStacks",
+    description: "Returns all stacks currently tracked by the engine.",
+    tags: [
+        "stacks"
+    ],
+    responses: {
+        200: {
+            description: "List of running stacks",
+            content: {
+                "application/json": {
+                    schema: listStacksResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Stack management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const getStackRouteSchema = {
+    method: "get",
+    path: "/api/v1/stacks/{stackName}",
+    operationId: "getStack",
+    summary: "Get the status of a running FigStack",
+    description: "Returns the current status of all containers in the named stack.",
+    tags: [
+        "stacks"
+    ],
+    parameters: [
+        {
+            name: "stackName",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "blog"
+        }
+    ],
+    responses: {
+        200: {
+            description: "Stack status",
+            content: {
+                "application/json": {
+                    schema: getStackResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Stack not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Stack management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const stopStackRouteSchema = {
+    method: "delete",
+    path: "/api/v1/stacks/{stackName}",
+    operationId: "stopStack",
+    summary: "Stop a running FigStack",
+    description: "Stops all containers in the stack and removes the stack network.",
+    tags: [
+        "stacks"
+    ],
+    parameters: [
+        {
+            name: "stackName",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "blog"
+        }
+    ],
+    responses: {
+        204: {
+            description: "Stack stopped successfully"
+        },
+        500: {
+            description: "Stack stop failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        503: {
+            description: "Stack management unavailable",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=stacks.js.map

package/dist/engine/paths/stacks.js.map

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

package/dist/engine/paths/volumes.d.ts

@@ -0,0 +1,6 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const ensureVolumeRouteSchema: RouteConfig;
+export declare const listVolumesRouteSchema: RouteConfig;
+export declare const deleteVolumeRouteSchema: RouteConfig;
+export declare const pruneVolumesRouteSchema: RouteConfig;
+//# sourceMappingURL=volumes.d.ts.map