duroxide 0.1.1 → 0.1.2

package/README.md

@@ -15,8 +15,10 @@ Node.js/TypeScript SDK for the [Duroxide](https://github.com/affandar/duroxide)
 - **Fan-out/fan-in** — run tasks in parallel with `ctx.all()` (supports all task types)
 - **Race conditions** — wait for the first of multiple tasks with `ctx.race()` (supports all task types)
 - **Cooperative cancellation** — activities detect when they're no longer needed via `ctx.isCancelled()`
+- **Activity client access** — activities can start new orchestrations via `ctx.getClient()`
 - **Continue-as-new** — restart orchestrations with fresh history for eternal workflows
 - **Structured tracing** — orchestration and activity logs route through Rust's `tracing` crate
+- **Runtime metrics** — `metricsSnapshot()` for orchestration/activity counters
 - **SQLite & PostgreSQL** — pluggable storage backends
 
 ## Quick Start
@@ -146,11 +148,11 @@ RUST_LOG=duroxide::activity=info node app.js  # Activity traces only
 Requires PostgreSQL (see `.env.example`):
 
 ```bash
-npm test                 # e2e tests (23 PG + 1 SQLite smoketest)
+npm test                 # e2e tests (25 PG + 1 SQLite smoketest)
 npm run test:races       # Race/join composition tests (7 tests)
 npm run test:admin       # Admin API tests (14 tests)
 npm run test:scenarios   # Scenario tests (6 tests)
-npm run test:all         # Everything (50 tests)
+npm run test:all         # Everything (52 tests)
 ```
 
 ## License

package/index.d.ts

@@ -16,6 +16,14 @@ export interface JsRuntimeOptions {
    * manager renews locks, which affects cancellation detection speed.
    */
   workerLockTimeoutMs?: number
+  /** Log format: "json", "pretty", or "compact" (default) */
+  logFormat?: string
+  /** Log level filter: "info", "debug", "warn", "error", etc. */
+  logLevel?: string
+  /** Service name for identification in logs/metrics */
+  serviceName?: string
+  /** Optional service version */
+  serviceVersion?: string
 }
 /** Orchestration status returned to JS. */
 export interface JsOrchestrationStatus {
@@ -89,6 +97,26 @@ export interface JsInstanceFilter {
   completedBefore?: number
   limit?: number
 }
+/** Runtime metrics snapshot returned to JS. */
+export interface JsMetricsSnapshot {
+  orchStarts: number
+  orchCompletions: number
+  orchFailures: number
+  orchApplicationErrors: number
+  orchInfrastructureErrors: number
+  orchConfigurationErrors: number
+  orchPoison: number
+  activitySuccess: number
+  activityAppErrors: number
+  activityInfraErrors: number
+  activityConfigErrors: number
+  activityPoison: number
+  orchDispatcherItemsFetched: number
+  workerDispatcherItemsFetched: number
+  orchContinueAsNew: number
+  suborchestrationCalls: number
+  providerErrors: number
+}
 /** A single history event returned to JS. */
 export interface JsEvent {
   eventId: number
@@ -113,6 +141,8 @@ export declare function orchestrationTraceLog(instanceId: string, level: string,
  * Returns true if the activity has been cancelled (e.g., due to losing a race/select).
  */
 export declare function activityIsCancelled(token: string): boolean
+/** Get a Client from an activity context, allowing activities to start new orchestrations. */
+export declare function activityGetClient(token: string): JsClient | null
 /** Wraps duroxide's Client for use from JavaScript. */
 export declare class JsClient {
   constructor(provider: JsSqliteProvider)
@@ -210,6 +240,8 @@ export declare class JsRuntime {
    * This is async and takes &mut self. napi-rs requires async &mut methods to be marked unsafe.
    */
   start(): Promise<void>
+  /** Get a snapshot of runtime metrics. */
+  metricsSnapshot(): JsMetricsSnapshot | null
   /**
    * Shutdown the runtime gracefully.
    *

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { JsClient, JsPostgresProvider, JsSqliteProvider, JsRuntime, activityTraceLog, orchestrationTraceLog, activityIsCancelled } = nativeBinding
+const { JsClient, JsPostgresProvider, JsSqliteProvider, JsRuntime, activityTraceLog, orchestrationTraceLog, activityIsCancelled, activityGetClient } = nativeBinding
 
 module.exports.JsClient = JsClient
 module.exports.JsPostgresProvider = JsPostgresProvider
@@ -319,3 +319,4 @@ module.exports.JsRuntime = JsRuntime
 module.exports.activityTraceLog = activityTraceLog
 module.exports.orchestrationTraceLog = orchestrationTraceLog
 module.exports.activityIsCancelled = activityIsCancelled
+module.exports.activityGetClient = activityGetClient

package/lib/duroxide.js

@@ -6,7 +6,7 @@
  */
 
 // Load native bindings from the auto-generated napi-rs loader
-const { JsSqliteProvider, JsPostgresProvider, JsClient, JsRuntime, activityTraceLog, orchestrationTraceLog, activityIsCancelled } = require('../index.js');
+const { JsSqliteProvider, JsPostgresProvider, JsClient, JsRuntime, activityTraceLog, orchestrationTraceLog, activityIsCancelled, activityGetClient } = require('../index.js');
 
 // ─── Generator Driver ────────────────────────────────────────────
 
@@ -673,6 +673,14 @@ class Runtime {
   async shutdown(timeoutMs) {
     await this._native.shutdown(timeoutMs);
   }
+
+  /**
+   * Get a snapshot of runtime metrics.
+   * @returns {object|null}
+   */
+  metricsSnapshot() {
+    return this._native.metricsSnapshot();
+  }
 }
 
 /**
@@ -713,6 +721,18 @@ class ActivityContext {
   isCancelled() {
     return activityIsCancelled(this._traceToken);
   }
+
+  /**
+   * Get a Client from the activity context, allowing activities to start new orchestrations.
+   * @returns {Client|null}
+   */
+  getClient() {
+    const native = activityGetClient(this._traceToken);
+    if (!native) return null;
+    const client = Object.create(Client.prototype);
+    client._native = native;
+    return client;
+  }
 }
 
 // ─── Exports ─────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "duroxide",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Durable execution runtime for Node.js, powered by Rust",
   "main": "lib/duroxide.js",
   "types": "index.d.ts",
@@ -34,10 +34,10 @@
     "node": ">= 18"
   },
   "optionalDependencies": {
-    "duroxide-win32-x64-msvc": "0.1.1",
-    "duroxide-darwin-x64": "0.1.1",
-    "duroxide-linux-x64-gnu": "0.1.1",
-    "duroxide-darwin-arm64": "0.1.1"
+    "duroxide-win32-x64-msvc": "0.1.2",
+    "duroxide-darwin-x64": "0.1.2",
+    "duroxide-linux-x64-gnu": "0.1.2",
+    "duroxide-darwin-arm64": "0.1.2"
   },
   "files": [
     "index.js",