@taskcast/server-sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+import type { Task, TaskEvent, TaskStatus, SeriesMode, SinceCursor, TaskError } from '@taskcast/core';
+export type CreateTaskInput = Pick<Partial<Task>, 'type' | 'params' | 'result' | 'metadata' | 'ttl' | 'authConfig' | 'webhooks' | 'cleanup'>;
+export interface PublishEventInput {
+    type: string;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    data: unknown;
+    seriesId?: string;
+    seriesMode?: SeriesMode;
+}
+export interface TaskcastServerClientOptions {
+    baseUrl: string;
+    token?: string;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class TaskcastServerClient {
+    private fetch;
+    private baseUrl;
+    private token?;
+    constructor(opts: TaskcastServerClientOptions);
+    createTask(input: CreateTaskInput): Promise<Task>;
+    getTask(taskId: string): Promise<Task>;
+    transitionTask(taskId: string, status: TaskStatus, payload?: {
+        result?: Record<string, unknown>;
+        error?: TaskError;
+    }): Promise<Task>;
+    publishEvent(taskId: string, input: PublishEventInput): Promise<TaskEvent>;
+    publishEvents(taskId: string, inputs: PublishEventInput[]): Promise<TaskEvent[]>;
+    getHistory(taskId: string, opts?: {
+        since?: SinceCursor;
+    }): Promise<TaskEvent[]>;
+    private _request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAA8C,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAEjJ,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC,CAAA;AAE5I,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAC,CAAQ;gBAEV,IAAI,EAAE,2BAA2B;IAQvC,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,GAChE,OAAO,CAAC,IAAI,CAAC;IAOV,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAI1E,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIhF,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GAC7B,OAAO,CAAC,SAAS,EAAE,CAAC;YAUT,QAAQ;CAgCvB"}

package/dist/client.js

@@ -0,0 +1,69 @@
+export class TaskcastServerClient {
+    fetch;
+    baseUrl;
+    token;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        if (opts.token !== undefined) {
+            this.token = opts.token;
+        }
+        this.fetch = opts.fetch ?? globalThis.fetch;
+    }
+    async createTask(input) {
+        return this._request('POST', '/tasks', input);
+    }
+    async getTask(taskId) {
+        return this._request('GET', `/tasks/${taskId}`);
+    }
+    async transitionTask(taskId, status, payload) {
+        return this._request('PATCH', `/tasks/${taskId}/status`, {
+            status,
+            ...payload,
+        });
+    }
+    async publishEvent(taskId, input) {
+        return this._request('POST', `/tasks/${taskId}/events`, input);
+    }
+    async publishEvents(taskId, inputs) {
+        return this._request('POST', `/tasks/${taskId}/events`, inputs);
+    }
+    async getHistory(taskId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.since?.id)
+            params.set('since.id', opts.since.id);
+        if (opts?.since?.index !== undefined)
+            params.set('since.index', String(opts.since.index));
+        if (opts?.since?.timestamp !== undefined)
+            params.set('since.timestamp', String(opts.since.timestamp));
+        const qs = params.toString();
+        return this._request('GET', `/tasks/${taskId}/events/history${qs ? `?${qs}` : ''}`);
+    }
+    async _request(method, path, body) {
+        const headers = {
+            Accept: 'application/json',
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        const init = { method, headers };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const res = await this.fetch(`${this.baseUrl}${path}`, init);
+        if (!res.ok) {
+            let message = `HTTP ${res.status}`;
+            try {
+                const err = await res.json();
+                message = err.error ?? message;
+            }
+            catch {
+                // ignore parse errors
+            }
+            throw new Error(message);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,oBAAoB;IACvB,KAAK,CAAyB;IAC9B,OAAO,CAAQ;IACf,KAAK,CAAS;IAEtB,YAAY,IAAiC;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACzB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAsB;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAO,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAO,KAAK,EAAE,UAAU,MAAM,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAAc,EACd,MAAkB,EAClB,OAAiE;QAEjE,OAAO,IAAI,CAAC,QAAQ,CAAO,OAAO,EAAE,UAAU,MAAM,SAAS,EAAE;YAC7D,MAAM;YACN,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,KAAwB;QACzD,OAAO,IAAI,CAAC,QAAQ,CAAY,MAAM,EAAE,UAAU,MAAM,SAAS,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,MAA2B;QAC7D,OAAO,IAAI,CAAC,QAAQ,CAAc,MAAM,EAAE,UAAU,MAAM,SAAS,EAAE,MAAM,CAAC,CAAA;IAC9E,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,IAA8B;QAE9B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC1D,IAAI,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QACzF,IAAI,IAAI,EAAE,KAAK,EAAE,SAAS,KAAK,SAAS;YACtC,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;QAC7D,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAc,KAAK,EAAE,UAAU,MAAM,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAClG,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,MAAc,EACd,IAAY,EACZ,IAAc;QAEd,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;SAC3B,CAAA;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAA;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAA;QAEjE,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;QAC7C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;QAE5D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAA;YAClC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;gBAC5B,OAAO,GAAI,GAA0B,CAAC,KAAK,IAAI,OAAO,CAAA;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAA;IACjC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { TaskcastServerClient } from './client.js';
+export type { TaskcastServerClientOptions, CreateTaskInput, PublishEventInput } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,2BAA2B,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { TaskcastServerClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@taskcast/server-sdk",
+  "version": "0.1.0",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@taskcast/core": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "@vitest/coverage-v8": "^2.1.0"
+  }
+}