@superdurable/dex 0.1.0

package/dist/src/worker.js

@@ -0,0 +1,139 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { Server, ServerCredentials, credentials, } from "@grpc/grpc-js";
+import { FlowServiceClient, WorkerServiceService, } from "./gen/dex.js";
+import { workerServiceError } from "./grpc-status.js";
+import { ValueHydrator } from "./value-mapper.js";
+import { WorkerDispatcher } from "./worker-dispatcher.js";
+export class Worker {
+    registry;
+    blobCache;
+    options;
+    workerTarget;
+    server = new Server();
+    flowService;
+    stopped;
+    resolveStopped;
+    state = "created";
+    constructor(registry, blobCache, options = {}) {
+        this.registry = registry;
+        this.blobCache = blobCache;
+        this.options = options;
+        const bindAddress = options.bindAddress ?? "127.0.0.1:8803";
+        this.workerTarget = options.workerTarget ?? targetFromBindAddress(bindAddress);
+        this.flowService = new FlowServiceClient(options.serverAddress ?? "localhost:8801", credentials.createInsecure());
+        const dispatcher = new WorkerDispatcher(registry, new ValueHydrator(this.flowService, blobCache));
+        this.server.addService(WorkerServiceService, workerService(dispatcher));
+        this.stopped = new Promise((resolve) => {
+            this.resolveStopped = resolve;
+        });
+    }
+    async start() {
+        if (this.state !== "created") {
+            throw new Error(`Worker cannot start from state ${this.state}`);
+        }
+        const bindAddress = this.options.bindAddress ?? "127.0.0.1:8803";
+        try {
+            await bind(this.server, bindAddress);
+            this.state = "running";
+        }
+        catch (failure) {
+            this.state = "stopped";
+            this.flowService.close();
+            this.resolveStopped();
+            throw new Error(`cannot bind TypeScript Worker to ${bindAddress}`, { cause: failure });
+        }
+    }
+    async run() {
+        await this.start();
+        await this.stopped;
+    }
+    async close() {
+        if (this.state === "closed") {
+            return;
+        }
+        if (this.state === "created") {
+            this.state = "closed";
+            this.flowService.close();
+            this.resolveStopped();
+            return;
+        }
+        if (this.state === "running") {
+            this.state = "stopping";
+            await shutdown(this.server);
+            this.flowService.close();
+            this.state = "stopped";
+            this.resolveStopped();
+        }
+        else {
+            await this.stopped;
+        }
+        this.state = "closed";
+    }
+}
+function workerService(dispatcher) {
+    return {
+        invokeWaitForMethod(call, callback) {
+            invoke(() => dispatcher.invokeWaitFor(call.request), callback);
+        },
+        invokeExecuteMethod(call, callback) {
+            invoke(() => dispatcher.invokeExecute(call.request), callback);
+        },
+        invokeWorkerRpc(call, callback) {
+            invoke(() => dispatcher.invokeRPC(call.request), callback);
+        },
+    };
+}
+function invoke(invocation, callback) {
+    invocation().then((response) => callback(null, response), (failure) => callback(workerServiceError(failure), null));
+}
+function bind(server, address) {
+    parseAddress(address);
+    return new Promise((resolve, reject) => {
+        server.bindAsync(address, ServerCredentials.createInsecure(), (error, port) => {
+            if (error !== null) {
+                reject(error);
+                return;
+            }
+            resolve(port);
+        });
+    });
+}
+function shutdown(server) {
+    return new Promise((resolve, reject) => {
+        server.tryShutdown((error) => {
+            if (error !== undefined) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+function targetFromBindAddress(address) {
+    const parsed = parseAddress(address);
+    const host = parsed.host === "" || parsed.host === "0.0.0.0" || parsed.host === "::"
+        ? "localhost"
+        : parsed.host;
+    return { address: host.includes(":") ? `[${host}]:${parsed.port}` : `${host}:${parsed.port}` };
+}
+function parseAddress(address) {
+    if (address.trim() !== address || address === "") {
+        throw new TypeError("Worker bind address is required without whitespace");
+    }
+    const bracketed = /^\[([^\]]+)]:(\d+)$/.exec(address);
+    const separator = address.lastIndexOf(":");
+    const host = bracketed?.[1] ?? (separator < 0 ? "" : address.slice(0, separator));
+    const portText = bracketed?.[2] ?? (separator < 0 ? "" : address.slice(separator + 1));
+    const port = Number(portText);
+    if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+        throw new TypeError("Worker bind address requires port 1-65535");
+    }
+    return { host, port };
+}
+//# sourceMappingURL=worker.js.map

package/dist/src/worker.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@superdurable/dex",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Dex durable workflow engine",
+  "license": "LicenseRef-Super-Durable-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/superdurable/dex.git",
+    "directory": "sdk-typescript"
+  },
+  "homepage": "https://github.com/superdurable/dex/tree/main/sdk-typescript#readme",
+  "bugs": {
+    "url": "https://github.com/superdurable/dex/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": "^22.0.0 || ^24.0.0"
+  },
+  "files": [
+    "dist/src",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "coverage:integration": "./run-integration-tests.sh --coverage",
+    "generate:proto": "node scripts/generate-proto.mjs",
+    "prepack": "npm run build",
+    "test:integration": "npm run build && node --test --test-concurrency=1 dist/test/integ/*.integration.test.js",
+    "test:integration:coverage": "npm run build && c8 node --test --test-concurrency=1 dist/test/integ/*.integration.test.js && node scripts/report-uncovered.mjs coverage/lcov.info",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test dist/test/*.test.js"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "c8": "^12.0.0",
+    "ts-proto": "^2.12.0",
+    "typescript": "^5.9.0"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.13.0",
+    "@grpc/grpc-js": "^1.14.4"
+  }
+}