@taskcast/server 0.3.0 → 1.0.0

package/dist/schemas.js

@@ -0,0 +1,143 @@
+import { z } from '@hono/zod-openapi';
+// ─── Enums ──────────────────────────────────────────────────────────────────
+export const TaskStatusSchema = z.enum([
+    'pending',
+    'assigned',
+    'running',
+    'paused',
+    'blocked',
+    'completed',
+    'failed',
+    'timeout',
+    'cancelled',
+]);
+export const LevelSchema = z.enum(['debug', 'info', 'warn', 'error']);
+export const SeriesModeSchema = z.enum(['keep-all', 'accumulate', 'latest']);
+export const AssignModeSchema = z.enum(['external', 'pull', 'ws-offer', 'ws-race']);
+export const DisconnectPolicySchema = z.enum(['reassign', 'mark', 'fail']);
+// ─── Response Schemas ───────────────────────────────────────────────────────
+export const TaskErrorSchema = z
+    .object({
+    code: z.string().optional(),
+    message: z.string(),
+    details: z.record(z.unknown()).optional(),
+})
+    .openapi('TaskError');
+export const TaskSchema = z
+    .object({
+    id: z.string(),
+    type: z.string().optional(),
+    status: TaskStatusSchema,
+    params: z.record(z.unknown()).optional(),
+    result: z.record(z.unknown()).optional(),
+    error: TaskErrorSchema.optional(),
+    metadata: z.record(z.unknown()).optional(),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+    completedAt: z.number().optional(),
+    ttl: z.number().int().positive().optional(),
+    tags: z.array(z.string()).optional(),
+    assignMode: AssignModeSchema.optional(),
+    cost: z.number().int().positive().optional(),
+    assignedWorker: z.string().optional(),
+    disconnectPolicy: DisconnectPolicySchema.optional(),
+})
+    .openapi('Task');
+export const TaskEventSchema = z
+    .object({
+    id: z.string(),
+    taskId: z.string(),
+    index: z.number().int(),
+    timestamp: z.number(),
+    type: z.string(),
+    level: LevelSchema,
+    data: z.unknown(),
+    seriesId: z.string().optional(),
+    seriesMode: SeriesModeSchema.optional(),
+    seriesAccField: z.string().optional(),
+})
+    .openapi('TaskEvent');
+export const WorkerSchema = z
+    .object({
+    id: z.string(),
+    status: z.enum(['idle', 'busy', 'draining', 'offline']),
+    matchRule: z.object({
+        taskTypes: z.array(z.string()).optional(),
+        tags: z
+            .object({
+            all: z.array(z.string()).optional(),
+            any: z.array(z.string()).optional(),
+            none: z.array(z.string()).optional(),
+        })
+            .optional(),
+    }),
+    capacity: z.number().int(),
+    usedSlots: z.number().int(),
+    weight: z.number(),
+    connectionMode: z.enum(['pull', 'websocket']),
+    connectedAt: z.number(),
+    lastHeartbeatAt: z.number(),
+    metadata: z.record(z.unknown()).optional(),
+})
+    .openapi('Worker');
+export const ErrorSchema = z
+    .object({
+    error: z.string(),
+})
+    .openapi('Error');
+// ─── Request Body Schemas ───────────────────────────────────────────────────
+export const CreateTaskSchema = z
+    .object({
+    id: z.string().optional(),
+    type: z.string().optional(),
+    params: z.record(z.unknown()).optional(),
+    metadata: z.record(z.unknown()).optional(),
+    ttl: z.number().int().positive().optional(),
+    webhooks: z.array(z.unknown()).optional(),
+    cleanup: z.object({ rules: z.array(z.unknown()) }).optional(),
+    tags: z.array(z.string()).optional(),
+    assignMode: AssignModeSchema.optional(),
+    cost: z.number().int().positive().optional(),
+    disconnectPolicy: DisconnectPolicySchema.optional(),
+    authConfig: z.record(z.unknown()).optional(),
+})
+    .openapi('CreateTaskInput');
+export const TransitionSchema = z
+    .object({
+    status: TaskStatusSchema,
+    result: z.record(z.unknown()).optional(),
+    error: z
+        .object({
+        code: z.string().optional(),
+        message: z.string(),
+        details: z.record(z.unknown()).optional(),
+    })
+        .optional(),
+    reason: z.string().optional(),
+    ttl: z.number().int().positive().optional(),
+    resumeAfterMs: z.number().int().positive().optional(),
+    blockedRequest: z.object({ type: z.string(), data: z.unknown() }).optional(),
+})
+    .openapi('TransitionInput');
+export const PublishEventSchema = z
+    .object({
+    type: z.string(),
+    level: LevelSchema,
+    data: z.unknown(),
+    seriesId: z.string().optional(),
+    seriesMode: SeriesModeSchema.optional(),
+    seriesAccField: z.string().optional(),
+})
+    .openapi('PublishEventInput');
+export const DeclineSchema = z
+    .object({
+    workerId: z.string(),
+    blacklist: z.boolean().optional(),
+})
+    .openapi('DeclineInput');
+export const WorkerStatusUpdateSchema = z
+    .object({
+    status: z.enum(['draining', 'idle']),
+})
+    .openapi('WorkerStatusUpdateInput');
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,14 @@
+export { createTaskcastApp } from './index.js';
+export type { TaskcastServerOptions } from './index.js';
+/**
+ * Starts a real HTTP server for integration testing.
+ * Requires @hono/node-server as a devDependency.
+ * Returns baseUrl and a close function.
+ */
+export declare function startTestServer(opts: import('./index.js').TaskcastServerOptions & {
+    port?: number;
+}): Promise<{
+    baseUrl: string;
+    close: () => void;
+}>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,OAAO,YAAY,EAAE,qBAAqB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CAYjD"}

package/dist/testing.js

@@ -0,0 +1,20 @@
+export { createTaskcastApp } from './index.js';
+/**
+ * Starts a real HTTP server for integration testing.
+ * Requires @hono/node-server as a devDependency.
+ * Returns baseUrl and a close function.
+ */
+export async function startTestServer(opts) {
+    const { serve } = await import('@hono/node-server');
+    const { createTaskcastApp } = await import('./index.js');
+    const taskcast = createTaskcastApp(opts);
+    return new Promise((resolve) => {
+        const server = serve({ fetch: taskcast.app.fetch, port: opts.port ?? 0 }, (info) => {
+            resolve({
+                baseUrl: `http://localhost:${info.port}`,
+                close: () => { taskcast.stop(); server.close(); },
+            });
+        });
+    });
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAG9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAoE;IAEpE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;IACnD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;IACxD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YACjF,OAAO,CAAC;gBACN,OAAO,EAAE,oBAAqB,IAAyB,CAAC,IAAI,EAAE;gBAC9D,KAAK,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA,CAAC,CAAC;aACjD,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskcast/server",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "Hono HTTP server — REST + SSE + auth + webhooks for Taskcast.",
   "repository": {
     "type": "git",
@@ -22,16 +22,22 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
     }
   },
   "publishConfig": {
     "provenance": true
   },
   "dependencies": {
+    "@hono/zod-openapi": "^0.19.10",
+    "@scalar/hono-api-reference": "^0.10.0",
     "hono": "^4.6.0",
     "jose": "^5.9.0",
     "zod": "^3.23.0",
-    "@taskcast/core": "0.3.0"
+    "@taskcast/core": "1.0.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.9",
@@ -40,7 +46,7 @@
     "testcontainers": "^10.13.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0",
-    "@taskcast/redis": "0.3.0"
+    "@taskcast/redis": "1.0.0"
   },
   "scripts": {
     "build": "tsc",