@isplay/worker 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 isplay contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @isplay/worker
+
+Graphile Worker task list and local worker entrypoint for isplay.
+
+It runs queued replay and experiment jobs against the local Postgres store.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { type Runner, type TaskList } from "graphile-worker";
+export type StartWorkerOptions = {
+    connectionString: string;
+    artifactsDir?: string;
+    concurrency?: number;
+};
+export declare function createTaskList(options: StartWorkerOptions): TaskList;
+export declare const taskList: TaskList;
+export declare function startWorker(options: StartWorkerOptions): Promise<Runner>;
+//# 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,EAAO,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,CA0CpE;AAED,eAAO,MAAM,QAAQ,EAAE,QAGrB,CAAC;AAoCH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9E"}

package/dist/index.js

@@ -0,0 +1,93 @@
+import { run } from "graphile-worker";
+import { IsplayStore } from "@isplay/postgres";
+import { executeReplay, runExperiment } from "@isplay/server";
+export function createTaskList(options) {
+    return {
+        "replay.run": async (payload, helpers) => {
+            const { jobId, replayId } = replayPayload(payload);
+            await withStore(options, async (store) => {
+                await store.updateDurableJob(jobId, { status: "running" });
+                await store.appendDurableJobEvent(jobId, "job.started", { replayId });
+                try {
+                    const replay = await store.getReplay(replayId);
+                    if (!replay)
+                        throw new Error(`Replay not found: ${replayId}`);
+                    const result = await executeReplay(store, replay);
+                    const status = result.status === "error" ? "error" : "ok";
+                    await store.updateDurableJob(jobId, { status, error: result.error });
+                    await store.appendDurableJobEvent(jobId, status === "ok" ? "job.finished" : "job.failed", { replayId: result.id, replayStatus: result.status });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await store.updateDurableJob(jobId, { status: "error", error: message });
+                    await store.appendDurableJobEvent(jobId, "job.failed", { replayId, error: message }, { retryable: false });
+                }
+            });
+            helpers.logger.info("Replay job finished", { jobId, replayId });
+        },
+        "experiment.run": async (payload, helpers) => {
+            const { jobId, experimentId } = experimentPayload(payload);
+            await withStore(options, async (store) => {
+                await store.updateDurableJob(jobId, { status: "running" });
+                await store.appendDurableJobEvent(jobId, "job.started", { experimentId });
+                try {
+                    const result = await runExperiment(store, experimentId);
+                    const status = result.status === "invalid" ? "error" : "ok";
+                    await store.updateDurableJob(jobId, { status, error: status === "error" ? "Experiment completed invalid" : undefined });
+                    await store.appendDurableJobEvent(jobId, status === "ok" ? "job.finished" : "job.failed", { experimentId, experimentStatus: result.status });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await store.updateDurableJob(jobId, { status: "error", error: message });
+                    await store.appendDurableJobEvent(jobId, "job.failed", { experimentId, error: message }, { retryable: false });
+                }
+            });
+            helpers.logger.info("Experiment job finished", { jobId, experimentId });
+        }
+    };
+}
+export const taskList = createTaskList({
+    connectionString: process.env.DATABASE_URL ?? "",
+    artifactsDir: process.env.ISPLAY_ARTIFACTS_DIR
+});
+async function withStore(options, fn) {
+    const store = new IsplayStore({
+        connectionString: options.connectionString,
+        artifactsDir: options.artifactsDir ?? process.env.ISPLAY_ARTIFACTS_DIR ?? ".isplay/artifacts"
+    });
+    await store.migrate();
+    try {
+        return await fn(store);
+    }
+    finally {
+        await store.close();
+    }
+}
+function replayPayload(payload) {
+    const record = objectPayload(payload);
+    return { jobId: stringPayload(record, "jobId"), replayId: stringPayload(record, "replayId") };
+}
+function experimentPayload(payload) {
+    const record = objectPayload(payload);
+    return { jobId: stringPayload(record, "jobId"), experimentId: stringPayload(record, "experimentId") };
+}
+function objectPayload(payload) {
+    if (!payload || typeof payload !== "object" || Array.isArray(payload))
+        throw new Error("Expected object job payload.");
+    return payload;
+}
+function stringPayload(payload, key) {
+    const value = payload[key];
+    if (typeof value !== "string")
+        throw new Error(`Expected ${key} in job payload.`);
+    return value;
+}
+;
+export async function startWorker(options) {
+    return run({
+        connectionString: options.connectionString,
+        concurrency: options.concurrency ?? 2,
+        taskList: createTaskList(options)
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@isplay/worker",
+  "version": "0.3.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@isplay/core": "0.3.0",
+    "@isplay/postgres": "0.3.0",
+    "@isplay/server": "0.3.0",
+    "graphile-worker": "^0.16.6"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isplay/isplay.git"
+  },
+  "bugs": {
+    "url": "https://github.com/isplay/isplay/issues"
+  },
+  "homepage": "https://isplay.dev",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "description": "Graphile Worker task handlers for durable isplay replay and experiment jobs.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.5.0"
+  }
+}