@hotmeshio/long-tail-dbos 0.0.0-stage → 0.1.0

package/build/steps.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ltClose = exports.ltOpen = void 0;
+exports.openWait = openWait;
+exports.closeWait = closeWait;
+const dbos_sdk_1 = require("@dbos-inc/dbos-sdk");
+const constants_1 = require("./constants");
+const duration_1 = require("./duration");
+const lt_client_1 = require("./lt-client");
+/** Open the escalation this workflow waits on. Runs as a checkpointed step. */
+async function openWait(waitKey, config) {
+    const workflowId = dbos_sdk_1.DBOS.workflowID;
+    if (!workflowId)
+        throw new Error('conditional() must run inside a DBOS workflow');
+    const status = await dbos_sdk_1.DBOS.getWorkflowStatus(workflowId);
+    const workflowType = status?.workflowName ?? null;
+    const expiresAt = config.timeout !== undefined ? new Date(Date.now() + (0, duration_1.toMs)(config.timeout)).toISOString() : null;
+    const opened = await (0, lt_client_1.postOpenWait)({
+        workflowId,
+        runScope: '',
+        ...(workflowType ? { workflowType } : {}),
+        waitKey,
+        role: config.role,
+        type: config.type,
+        subtype: config.subtype,
+        description: config.description,
+        priority: config.priority,
+        metadata: config.metadata,
+        data: config.data,
+        ...(expiresAt ? { expiresAt } : {}),
+    });
+    return { escalationId: opened.escalationId, waitKey, status: opened.status, expiresAt, workflowType };
+}
+/** Cancel the escalation when the recv deadline passes first. */
+async function closeWait(escalationId) {
+    await (0, lt_client_1.postCancel)(escalationId);
+}
+function register(fn, name) {
+    try {
+        return dbos_sdk_1.DBOS.registerStep(fn, { name, retriesAllowed: true, maxAttempts: constants_1.WAIT_DEFAULTS.OPEN_ATTEMPTS });
+    }
+    catch (err) {
+        if (err instanceof dbos_sdk_1.Error.DBOSConflictingRegistrationError) {
+            throw new Error(`@hotmeshio/long-tail-dbos must be imported before DBOS.launch(): its ${name} step registers at import`, { cause: err });
+        }
+        throw err;
+    }
+}
+exports.ltOpen = register(openWait, constants_1.STEP.OPEN);
+exports.ltClose = register(closeWait, constants_1.STEP.CLOSE);

package/build/types.d.ts

@@ -0,0 +1,39 @@
+/** Mirrors Long Tail's LTWaitOutcome; kept local so app processes need no Long Tail install. */
+export interface LTWaitOutcome {
+    waitKey: string;
+    escalationId: string;
+    status: 'resolved' | 'expired' | 'cancelled';
+    data?: Record<string, unknown>;
+    resolvedBy?: string;
+    resolvedAt?: string;
+}
+export interface LongTailConnection {
+    /** Long Tail base URL, e.g. https://longtail.example.com */
+    url: string;
+    /** Bot API key (lt_bot_...) or a JWT. */
+    apiKey: string;
+    /** Per-request timeout. Default 15 s. */
+    requestTimeoutMs?: number;
+}
+export interface LTConditionalConfig {
+    role: string;
+    type: string;
+    subtype?: string;
+    description?: string;
+    priority?: 1 | 2 | 3 | 4;
+    metadata?: Record<string, unknown>;
+    /** Shown to the resolver. */
+    data?: Record<string, unknown>;
+    /** Escalation SLA: '48h', '30m', '10s', '2d', or milliseconds. */
+    timeout?: string | number;
+    /** recv backstop when there is no SLA, in seconds. Default 365 days. */
+    maxWaitSeconds?: number;
+}
+/** Output of the lt.open step; stored in the checkpoint. */
+export interface OpenedWait {
+    escalationId: string;
+    waitKey: string;
+    status: string;
+    expiresAt: string | null;
+    workflowType: string | null;
+}

package/build/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@hotmeshio/long-tail-dbos",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Long Tail escalations for DBOS workflows: one call, conditional().",
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "files": [
+    "build/",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node build/start.js",
+    "probe": "tsx scripts/probe.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "pg": "^8.23.1"
+  },
+  "peerDependencies": {
+    "@dbos-inc/dbos-sdk": "^5.5.0",
+    "@hotmeshio/long-tail": "^0.35.0"
+  },
+  "devDependencies": {
+    "@dbos-inc/dbos-sdk": "^5.5.0",
+    "@hotmeshio/long-tail": "^0.35.0",
+    "@types/node": "^22.20.5",
+    "@types/pg": "^8.23.1",
+    "socket.io-client": "^4.8.4",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  },
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    },
+    "./provider": {
+      "types": "./build/provider/index.d.ts",
+      "default": "./build/provider/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "provider": [
+        "./build/provider/index.d.ts"
+      ]
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hotmeshio/long-tail-dbos.git"
+  }
+}