@hasna/todos 0.11.75 → 0.11.81

package/dist/server/openapi.d.ts

@@ -0,0 +1,628 @@
+export declare function buildV1OpenApiDocument(version?: string): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    servers: {
+        url: string;
+    }[];
+    components: {
+        securitySchemes: {
+            apiKey: {
+                type: string;
+                in: string;
+                name: string;
+            };
+        };
+        schemas: {
+            Task: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                    };
+                    readonly priority: {
+                        readonly type: "string";
+                    };
+                    readonly project_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly assigned_to: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly agent_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly version: {
+                        readonly type: "number";
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            Project: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            CreateTaskInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    title: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    status: {
+                        type: string;
+                    };
+                    priority: {
+                        type: string;
+                    };
+                    project_id: {
+                        type: string;
+                    };
+                    assigned_to: {
+                        type: string;
+                    };
+                    agent_id: {
+                        type: string;
+                    };
+                    tags: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+            UpdateTaskInput: {
+                type: string;
+                properties: {
+                    title: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    status: {
+                        type: string;
+                    };
+                    priority: {
+                        type: string;
+                    };
+                    assigned_to: {
+                        type: string;
+                    };
+                    version: {
+                        type: string;
+                    };
+                };
+            };
+            CreateProjectInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    path: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    task_prefix: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+    security: {
+        apiKey: never[];
+    }[];
+    paths: {
+        "/v1/tasks": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        tasks: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        task: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/tasks/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        task: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            patch: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        task: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            delete: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        deleted: {
+                                            type: string;
+                                        };
+                                        id: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/tasks/{id}/start": {
+            post: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        task: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/tasks/{id}/complete": {
+            post: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        task: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/projects": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        projects: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        project: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/projects/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        project: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/stats": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        tasks: {
+                                            type: string;
+                                        };
+                                        projects: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/import": {
+            post: {
+                operationId: string;
+                summary: string;
+                description: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                type: string;
+                                properties: {
+                                    exportedAt: {
+                                        type: string;
+                                    };
+                                    source: {
+                                        type: string;
+                                    };
+                                    tasks: {
+                                        type: string;
+                                        items: {
+                                            $ref: string;
+                                        };
+                                    };
+                                    projects: {
+                                        type: string;
+                                        items: {
+                                            $ref: string;
+                                        };
+                                    };
+                                    projectMachinePaths: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    plans: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    agents: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    taskLists: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    templates: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    auditHistory: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                    tombstones: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        received: {
+                                            type: string;
+                                        };
+                                        result: {
+                                            type: string;
+                                            properties: {
+                                                inserted: {
+                                                    type: string;
+                                                };
+                                                updated: {
+                                                    type: string;
+                                                };
+                                                deleted: {
+                                                    type: string;
+                                                };
+                                                skipped: {
+                                                    type: string;
+                                                };
+                                                errors: {
+                                                    type: string;
+                                                    items: {
+                                                        type: string;
+                                                    };
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/server/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAqCA,wBAAgB,sBAAsB,CAAC,OAAO,SAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2QnE"}

package/dist/server/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AA+B9C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW7C,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAwEF,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ,CASjF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAYjE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;EA0B1D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgc3H"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AA+B9C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW7C,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAwEF,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ,CASjF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAYjE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;EA0B1D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAue3H"}

package/dist/server/v1.d.ts

@@ -0,0 +1,19 @@
+import type { TodosStorageSnapshot } from "../storage/interfaces.js";
+/**
+ * Coerce an arbitrary request body into a well-formed {@link TodosStorageSnapshot}.
+ *
+ * Every record array is optional and defaults to `[]`, so a caller can backfill a
+ * single object type (e.g. just `tasks`) or a full snapshot. Non-array values for
+ * a record key are treated as empty rather than throwing, keeping partial-chunk
+ * ingest robust. The returned snapshot is safe to hand straight to
+ * `storage.sync.importSnapshot`, which upserts every row by primary key (idempotent).
+ */
+export declare function normalizeImportSnapshot(raw: unknown): TodosStorageSnapshot;
+/** Total number of records (across every object type) carried by a snapshot. */
+export declare function countSnapshotRecords(s: TodosStorageSnapshot): number;
+/**
+ * Handle a `/v1/*` request. Returns `null` when the path is not a `/v1` route so
+ * the caller can fall through to other handlers.
+ */
+export declare function handleV1Request(req: Request, url: URL): Promise<Response | null>;
+//# sourceMappingURL=v1.d.ts.map

package/dist/server/v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/server/v1.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAuB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AA4B1F;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAgB1E;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAYpE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuPtF"}

package/dist/storage/cloud-client.d.ts

@@ -0,0 +1,30 @@
+import type { TodosPostgresQueryClient } from "./postgres-sync.js";
+import { type TodosStorageEnv } from "./config.js";
+/**
+ * A live Postgres query client for the shadow mirror and divergence diagnostics.
+ *
+ * This uses Bun's built-in SQL driver (`Bun.SQL`) so the OSS package keeps ZERO
+ * cloud/database runtime dependencies — the driver is only touched when the
+ * caller explicitly opens a connection (shadow mode or `storage shadow-status`).
+ * SSL/TLS behaviour is taken verbatim from the connection string (e.g.
+ * `?sslmode=require`); we never disable certificate verification.
+ */
+export interface TodosCloudQueryClient extends TodosPostgresQueryClient {
+    close(): Promise<void>;
+}
+export interface CreateTodosCloudQueryClientOptions {
+    /** Maximum pooled connections. Shadow mirror is low-volume, so keep it tiny. */
+    max?: number;
+    /** Connection idle timeout in seconds. */
+    idleTimeout?: number;
+    /** Statement/connection timeout in seconds. */
+    connectionTimeout?: number;
+}
+export declare function createTodosCloudQueryClient(url: string, options?: CreateTodosCloudQueryClientOptions): TodosCloudQueryClient;
+/**
+ * Build a live cloud client from the configured database URL, or return `null`
+ * when no remote DSN is present. Never reads from the remote store on its own —
+ * callers decide what to run.
+ */
+export declare function createTodosCloudQueryClientFromEnv(env?: TodosStorageEnv, options?: CreateTodosCloudQueryClientOptions): TodosCloudQueryClient | null;
+//# sourceMappingURL=cloud-client.d.ts.map

package/dist/storage/cloud-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-client.d.ts","sourceRoot":"","sources":["../../src/storage/cloud-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAA4B,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA6BD,MAAM,WAAW,kCAAkC;IACjD,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kCAAuC,GAC/C,qBAAqB,CAqBvB;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,GAAG,GAAE,eAA6B,EAClC,OAAO,GAAE,kCAAuC,GAC/C,qBAAqB,GAAG,IAAI,CAI9B"}