@raspect/workflow-sdk 0.1.0

package/README.md

@@ -0,0 +1,249 @@
+# @inspectica/workflow-sdk
+
+Node.js SDK for Inspectica Workflow Server - Execute workflows and activities.
+
+## Installation
+
+```bash
+npm install @inspectica/workflow-sdk
+```
+
+## Quick Start
+
+```typescript
+import { Worker, workflow, activity } from '@inspectica/workflow-sdk';
+
+// Define an activity
+const sayHello = activity.defn(async (input: { name: string }) => {
+  return { message: `Hello, ${input.name}!` };
+});
+
+// Define a workflow
+@workflow.defn
+class HelloWorldWorkflow {
+  @workflow.run
+  async run(input: { name: string }) {
+    const result = await workflow.executeActivity(sayHello, input);
+    return result;
+  }
+}
+
+// Create and start the worker
+const worker = new Worker({
+  serverUrl: 'https://workflow.example.com',
+  apiKey: 'wk_your_api_key_here',
+});
+
+worker.register({
+  workflows: [HelloWorldWorkflow],
+  activities: [sayHello],
+});
+
+await worker.run();
+```
+
+## Configuration
+
+### Worker Configuration
+
+```typescript
+const worker = new Worker({
+  serverUrl: 'https://workflow.example.com',
+  apiKey: 'wk_abc123...',
+  groupId: 'my-consumer-group',        // optional, defaults to worker-id based
+  maxConcurrentWorkflows: 10,          // optional, default 10
+});
+```
+
+## Activities
+
+Activities are the building blocks of workflows. They represent individual units of work.
+
+```typescript
+import { activity } from '@inspectica/workflow-sdk';
+
+// Simple activity
+const processData = activity.defn(async (input: { data: number[] }) => {
+  const sum = input.data.reduce((a, b) => a + b, 0);
+  return { sum };
+});
+
+// Activity with custom name
+const myActivity = activity.defn(
+  async (input: { value: string }) => {
+    return { processed: input.value.toUpperCase() };
+  },
+  'custom_activity_name'  // optional custom name
+);
+```
+
+## Workflows
+
+Workflows orchestrate activities and define the business logic.
+
+```typescript
+import { workflow, activity } from '@inspectica/workflow-sdk';
+
+const step1 = activity.defn(async (input: { data: string }) => {
+  return { result: input.data + '_step1' };
+});
+
+const step2 = activity.defn(async (input: { data: string }) => {
+  return { result: input.data + '_step2' };
+});
+
+@workflow.defn
+class MyWorkflow {
+  @workflow.run
+  async run(input: { initialData: string }) {
+    // Execute activities sequentially
+    const result1 = await workflow.executeActivity(step1, { data: input.initialData });
+    const result2 = await workflow.executeActivity(step2, { data: result1.result });
+    
+    return { finalResult: result2.result };
+  }
+}
+```
+
+### Accessing Workflow Context
+
+You can access the workflow context to get metadata (like access tokens):
+
+```typescript
+import { workflow, getCurrentContext } from '@inspectica/workflow-sdk';
+
+@workflow.defn
+class AuthenticatedWorkflow {
+  @workflow.run
+  async run(input: { projectId: string }) {
+    const ctx = getCurrentContext();
+    
+    // Access metadata passed from the workflow submission
+    const accessToken = ctx.metadata.access_token;
+    const workflowId = ctx.workflowId;
+    
+    // Use the token for authorization checks
+    // ...
+    
+    return { success: true };
+  }
+}
+```
+
+### Cross-Worker Activity Execution
+
+You can call activities registered on other workers by using the activity name as a string:
+
+```typescript
+@workflow.defn
+class CrossWorkerWorkflow {
+  @workflow.run
+  async run(input: { data: string }) {
+    // Call an activity on another worker by name
+    const result = await workflow.executeActivity(
+      'remote_activity_name',  // Activity registered on another worker
+      { data: input.data },
+      120000  // timeout in ms
+    );
+    
+    return result;
+  }
+}
+```
+
+## API Reference
+
+### Worker
+
+```typescript
+class Worker {
+  constructor(config: WorkerConfig);
+  
+  // Register workflows and activities
+  register(options: {
+    workflows?: WorkflowClass[];
+    activities?: ActivityHandler[];
+  }): void;
+  
+  // Start the worker (blocking)
+  run(): Promise<void>;
+  
+  // Stop the worker gracefully
+  stop(): Promise<void>;
+}
+
+interface WorkerConfig {
+  serverUrl: string;
+  apiKey: string;
+  groupId?: string;
+  maxConcurrentWorkflows?: number;
+}
+```
+
+### Activity
+
+```typescript
+// Define an activity
+activity.defn<TInput, TOutput>(
+  fn: (input: TInput) => Promise<TOutput> | TOutput,
+  activityName?: string
+): ActivityHandler<TInput, TOutput>;
+
+// Get activity name
+activity.getActivityName(fn: ActivityHandler | string): string;
+
+// Check if function is an activity
+activity.isActivity(fn: unknown): boolean;
+```
+
+### Workflow
+
+```typescript
+// Class decorator to mark as workflow
+@workflow.defn
+class MyWorkflow { ... }
+
+// Method decorator to mark as entry point
+@workflow.run
+async run(input: any) { ... }
+
+// Execute an activity within a workflow
+workflow.executeActivity<TInput, TOutput>(
+  activity: ActivityHandler<TInput, TOutput> | string,
+  inputData?: TInput,
+  startToCloseTimeoutMs?: number  // default: 60000
+): Promise<TOutput>;
+
+// Get current workflow context
+getCurrentContext(): WorkflowContext;
+```
+
+### WorkflowContext
+
+```typescript
+class WorkflowContext {
+  readonly workflowId: string;
+  readonly metadata: Record<string, unknown>;
+  readonly activityResults: unknown[];
+  
+  executeActivity<TInput, TOutput>(
+    activity: ActivityHandler<TInput, TOutput> | string,
+    inputData?: TInput,
+    startToCloseTimeoutMs?: number
+  ): Promise<TOutput>;
+}
+```
+
+## Features
+
+- **Workflow Execution**: Define and execute complex workflows with multiple activities
+- **Activity Replay**: Automatic replay of completed activities on workflow resume
+- **Cross-Worker Routing**: Execute activities on different workers via the server
+- **Concurrency Control**: Limit concurrent workflow executions to prevent OOM
+- **AWS MSK IAM Support**: Built-in support for AWS MSK with IAM authentication
+- **Graceful Shutdown**: Proper cleanup on SIGINT/SIGTERM signals
+- **Heartbeat**: Automatic heartbeat to keep worker connection alive
+
+## License
+
+MIT

package/dist/activity.d.ts

@@ -0,0 +1,23 @@
+import type { ActivityHandler } from './types';
+/**
+ * Decorator to mark a function as an activity definition.
+ *
+ * Usage:
+ *   import { activity } from '@inspectica/workflow-sdk';
+ *
+ *   const myActivity = activity.defn(async (input: { name: string }) => {
+ *     return { message: `Hello, ${input.name}!` };
+ *   });
+ */
+export declare function defn<TInput = unknown, TOutput = unknown>(fn: ActivityHandler<TInput, TOutput>, activityName?: string): ActivityHandler<TInput, TOutput> & {
+    __activityName__: string;
+    __isActivity__: boolean;
+};
+/**
+ * Get the activity name from a function
+ */
+export declare function getActivityName(fn: ActivityHandler | string): string;
+/**
+ * Check if a function is a decorated activity
+ */
+export declare function isActivity(fn: unknown): boolean;

package/dist/activity.js

@@ -0,0 +1,44 @@
+"use strict";
+// Activity decorators and utilities
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defn = defn;
+exports.getActivityName = getActivityName;
+exports.isActivity = isActivity;
+// Symbol to store activity metadata
+const ACTIVITY_NAME = Symbol('activityName');
+const IS_ACTIVITY = Symbol('isActivity');
+/**
+ * Decorator to mark a function as an activity definition.
+ *
+ * Usage:
+ *   import { activity } from '@inspectica/workflow-sdk';
+ *
+ *   const myActivity = activity.defn(async (input: { name: string }) => {
+ *     return { message: `Hello, ${input.name}!` };
+ *   });
+ */
+function defn(fn, activityName) {
+    const name = activityName || fn.name || 'anonymous';
+    const decorated = fn;
+    decorated.__activityName__ = name;
+    decorated.__isActivity__ = true;
+    decorated[ACTIVITY_NAME] = name;
+    decorated[IS_ACTIVITY] = true;
+    return decorated;
+}
+/**
+ * Get the activity name from a function
+ */
+function getActivityName(fn) {
+    if (typeof fn === 'string') {
+        return fn;
+    }
+    return fn.__activityName__ || fn.name || 'anonymous';
+}
+/**
+ * Check if a function is a decorated activity
+ */
+function isActivity(fn) {
+    return typeof fn === 'function' && fn.__isActivity__ === true;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWN0aXZpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvYWN0aXZpdHkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLG9DQUFvQzs7QUFrQnBDLG9CQWdCQztBQUtELDBDQUtDO0FBS0QsZ0NBRUM7QUEvQ0Qsb0NBQW9DO0FBQ3BDLE1BQU0sYUFBYSxHQUFHLE1BQU0sQ0FBQyxjQUFjLENBQUMsQ0FBQztBQUM3QyxNQUFNLFdBQVcsR0FBRyxNQUFNLENBQUMsWUFBWSxDQUFDLENBQUM7QUFFekM7Ozs7Ozs7OztHQVNHO0FBQ0gsU0FBZ0IsSUFBSSxDQUNsQixFQUFvQyxFQUNwQyxZQUFxQjtJQUVyQixNQUFNLElBQUksR0FBRyxZQUFZLElBQUksRUFBRSxDQUFDLElBQUksSUFBSSxXQUFXLENBQUM7SUFDcEQsTUFBTSxTQUFTLEdBQUcsRUFLakIsQ0FBQztJQUNGLFNBQVMsQ0FBQyxnQkFBZ0IsR0FBRyxJQUFJLENBQUM7SUFDbEMsU0FBUyxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUM7SUFDaEMsU0FBUyxDQUFDLGFBQWEsQ0FBQyxHQUFHLElBQUksQ0FBQztJQUNoQyxTQUFTLENBQUMsV0FBVyxDQUFDLEdBQUcsSUFBSSxDQUFDO0lBQzlCLE9BQU8sU0FBUyxDQUFDO0FBQ25CLENBQUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLGVBQWUsQ0FBQyxFQUE0QjtJQUMxRCxJQUFJLE9BQU8sRUFBRSxLQUFLLFFBQVEsRUFBRSxDQUFDO1FBQzNCLE9BQU8sRUFBRSxDQUFDO0lBQ1osQ0FBQztJQUNELE9BQVEsRUFBVSxDQUFDLGdCQUFnQixJQUFJLEVBQUUsQ0FBQyxJQUFJLElBQUksV0FBVyxDQUFDO0FBQ2hFLENBQUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLFVBQVUsQ0FBQyxFQUFXO0lBQ3BDLE9BQU8sT0FBTyxFQUFFLEtBQUssVUFBVSxJQUFLLEVBQVUsQ0FBQyxjQUFjLEtBQUssSUFBSSxDQUFDO0FBQ3pFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBBY3Rpdml0eSBkZWNvcmF0b3JzIGFuZCB1dGlsaXRpZXNcblxuaW1wb3J0IHR5cGUgeyBBY3Rpdml0eUhhbmRsZXIgfSBmcm9tICcuL3R5cGVzJztcblxuLy8gU3ltYm9sIHRvIHN0b3JlIGFjdGl2aXR5IG1ldGFkYXRhXG5jb25zdCBBQ1RJVklUWV9OQU1FID0gU3ltYm9sKCdhY3Rpdml0eU5hbWUnKTtcbmNvbnN0IElTX0FDVElWSVRZID0gU3ltYm9sKCdpc0FjdGl2aXR5Jyk7XG5cbi8qKlxuICogRGVjb3JhdG9yIHRvIG1hcmsgYSBmdW5jdGlvbiBhcyBhbiBhY3Rpdml0eSBkZWZpbml0aW9uLlxuICogXG4gKiBVc2FnZTpcbiAqICAgaW1wb3J0IHsgYWN0aXZpdHkgfSBmcm9tICdAaW5zcGVjdGljYS93b3JrZmxvdy1zZGsnO1xuICogICBcbiAqICAgY29uc3QgbXlBY3Rpdml0eSA9IGFjdGl2aXR5LmRlZm4oYXN5bmMgKGlucHV0OiB7IG5hbWU6IHN0cmluZyB9KSA9PiB7XG4gKiAgICAgcmV0dXJuIHsgbWVzc2FnZTogYEhlbGxvLCAke2lucHV0Lm5hbWV9IWAgfTtcbiAqICAgfSk7XG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkZWZuPFRJbnB1dCA9IHVua25vd24sIFRPdXRwdXQgPSB1bmtub3duPihcbiAgZm46IEFjdGl2aXR5SGFuZGxlcjxUSW5wdXQsIFRPdXRwdXQ+LFxuICBhY3Rpdml0eU5hbWU/OiBzdHJpbmdcbik6IEFjdGl2aXR5SGFuZGxlcjxUSW5wdXQsIFRPdXRwdXQ+ICYgeyBfX2FjdGl2aXR5TmFtZV9fOiBzdHJpbmc7IF9faXNBY3Rpdml0eV9fOiBib29sZWFuIH0ge1xuICBjb25zdCBuYW1lID0gYWN0aXZpdHlOYW1lIHx8IGZuLm5hbWUgfHwgJ2Fub255bW91cyc7XG4gIGNvbnN0IGRlY29yYXRlZCA9IGZuIGFzIEFjdGl2aXR5SGFuZGxlcjxUSW5wdXQsIFRPdXRwdXQ+ICYgeyBcbiAgICBfX2FjdGl2aXR5TmFtZV9fOiBzdHJpbmc7IFxuICAgIF9faXNBY3Rpdml0eV9fOiBib29sZWFuO1xuICAgIFtBQ1RJVklUWV9OQU1FXTogc3RyaW5nO1xuICAgIFtJU19BQ1RJVklUWV06IGJvb2xlYW47XG4gIH07XG4gIGRlY29yYXRlZC5fX2FjdGl2aXR5TmFtZV9fID0gbmFtZTtcbiAgZGVjb3JhdGVkLl9faXNBY3Rpdml0eV9fID0gdHJ1ZTtcbiAgZGVjb3JhdGVkW0FDVElWSVRZX05BTUVdID0gbmFtZTtcbiAgZGVjb3JhdGVkW0lTX0FDVElWSVRZXSA9IHRydWU7XG4gIHJldHVybiBkZWNvcmF0ZWQ7XG59XG5cbi8qKlxuICogR2V0IHRoZSBhY3Rpdml0eSBuYW1lIGZyb20gYSBmdW5jdGlvblxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0QWN0aXZpdHlOYW1lKGZuOiBBY3Rpdml0eUhhbmRsZXIgfCBzdHJpbmcpOiBzdHJpbmcge1xuICBpZiAodHlwZW9mIGZuID09PSAnc3RyaW5nJykge1xuICAgIHJldHVybiBmbjtcbiAgfVxuICByZXR1cm4gKGZuIGFzIGFueSkuX19hY3Rpdml0eU5hbWVfXyB8fCBmbi5uYW1lIHx8ICdhbm9ueW1vdXMnO1xufVxuXG4vKipcbiAqIENoZWNrIGlmIGEgZnVuY3Rpb24gaXMgYSBkZWNvcmF0ZWQgYWN0aXZpdHlcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzQWN0aXZpdHkoZm46IHVua25vd24pOiBib29sZWFuIHtcbiAgcmV0dXJuIHR5cGVvZiBmbiA9PT0gJ2Z1bmN0aW9uJyAmJiAoZm4gYXMgYW55KS5fX2lzQWN0aXZpdHlfXyA9PT0gdHJ1ZTtcbn1cbiJdfQ==

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Worker } from './worker';
+export * as activity from './activity';
+export * as workflow from './workflow';
+export { WorkflowContext, getCurrentContext } from './workflow';
+export type { WorkerConfig, ActivityHandler, WorkflowClass, WorkflowInstance, WorkflowTask, ActivityTask, WorkflowResult, ActivityResult, WorkflowError, ActivityError, CompletedActivity, } from './types';

package/dist/index.js

@@ -0,0 +1,67 @@
+"use strict";
+// Workflow SDK - Node.js Worker for Workflows and Activities
+//
+// Usage:
+//   import { Worker, workflow, activity } from '@inspectica/workflow-sdk';
+//
+//   const sayHello = activity.defn(async (input: { name: string }) => {
+//     return { message: `Hello, ${input.name}!` };
+//   });
+//
+//   @workflow.defn
+//   class HelloWorldWorkflow {
+//     @workflow.run
+//     async run(input: { name: string }) {
+//       return await workflow.executeActivity(sayHello, input);
+//     }
+//   }
+//
+//   const worker = new Worker({
+//     serverUrl: 'https://workflow.example.com',
+//     apiKey: 'wk_abc123...',
+//   });
+//   worker.register({ workflows: [HelloWorldWorkflow], activities: [sayHello] });
+//   await worker.run();
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentContext = exports.WorkflowContext = exports.workflow = exports.activity = exports.Worker = void 0;
+var worker_1 = require("./worker");
+Object.defineProperty(exports, "Worker", { enumerable: true, get: function () { return worker_1.Worker; } });
+exports.activity = __importStar(require("./activity"));
+exports.workflow = __importStar(require("./workflow"));
+var workflow_1 = require("./workflow");
+Object.defineProperty(exports, "WorkflowContext", { enumerable: true, get: function () { return workflow_1.WorkflowContext; } });
+Object.defineProperty(exports, "getCurrentContext", { enumerable: true, get: function () { return workflow_1.getCurrentContext; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLDZEQUE2RDtBQUM3RCxFQUFFO0FBQ0YsU0FBUztBQUNULDJFQUEyRTtBQUMzRSxFQUFFO0FBQ0Ysd0VBQXdFO0FBQ3hFLG1EQUFtRDtBQUNuRCxRQUFRO0FBQ1IsRUFBRTtBQUNGLG1CQUFtQjtBQUNuQiwrQkFBK0I7QUFDL0Isb0JBQW9CO0FBQ3BCLDJDQUEyQztBQUMzQyxnRUFBZ0U7QUFDaEUsUUFBUTtBQUNSLE1BQU07QUFDTixFQUFFO0FBQ0YsZ0NBQWdDO0FBQ2hDLGlEQUFpRDtBQUNqRCw4QkFBOEI7QUFDOUIsUUFBUTtBQUNSLGtGQUFrRjtBQUNsRix3QkFBd0I7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUV4QixtQ0FBa0M7QUFBekIsZ0dBQUEsTUFBTSxPQUFBO0FBQ2YsdURBQXVDO0FBQ3ZDLHVEQUF1QztBQUN2Qyx1Q0FBZ0U7QUFBdkQsMkdBQUEsZUFBZSxPQUFBO0FBQUUsNkdBQUEsaUJBQWlCLE9BQUEiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBXb3JrZmxvdyBTREsgLSBOb2RlLmpzIFdvcmtlciBmb3IgV29ya2Zsb3dzIGFuZCBBY3Rpdml0aWVzXG4vL1xuLy8gVXNhZ2U6XG4vLyAgIGltcG9ydCB7IFdvcmtlciwgd29ya2Zsb3csIGFjdGl2aXR5IH0gZnJvbSAnQGluc3BlY3RpY2Evd29ya2Zsb3ctc2RrJztcbi8vXG4vLyAgIGNvbnN0IHNheUhlbGxvID0gYWN0aXZpdHkuZGVmbihhc3luYyAoaW5wdXQ6IHsgbmFtZTogc3RyaW5nIH0pID0+IHtcbi8vICAgICByZXR1cm4geyBtZXNzYWdlOiBgSGVsbG8sICR7aW5wdXQubmFtZX0hYCB9O1xuLy8gICB9KTtcbi8vXG4vLyAgIEB3b3JrZmxvdy5kZWZuXG4vLyAgIGNsYXNzIEhlbGxvV29ybGRXb3JrZmxvdyB7XG4vLyAgICAgQHdvcmtmbG93LnJ1blxuLy8gICAgIGFzeW5jIHJ1bihpbnB1dDogeyBuYW1lOiBzdHJpbmcgfSkge1xuLy8gICAgICAgcmV0dXJuIGF3YWl0IHdvcmtmbG93LmV4ZWN1dGVBY3Rpdml0eShzYXlIZWxsbywgaW5wdXQpO1xuLy8gICAgIH1cbi8vICAgfVxuLy9cbi8vICAgY29uc3Qgd29ya2VyID0gbmV3IFdvcmtlcih7XG4vLyAgICAgc2VydmVyVXJsOiAnaHR0cHM6Ly93b3JrZmxvdy5leGFtcGxlLmNvbScsXG4vLyAgICAgYXBpS2V5OiAnd2tfYWJjMTIzLi4uJyxcbi8vICAgfSk7XG4vLyAgIHdvcmtlci5yZWdpc3Rlcih7IHdvcmtmbG93czogW0hlbGxvV29ybGRXb3JrZmxvd10sIGFjdGl2aXRpZXM6IFtzYXlIZWxsb10gfSk7XG4vLyAgIGF3YWl0IHdvcmtlci5ydW4oKTtcblxuZXhwb3J0IHsgV29ya2VyIH0gZnJvbSAnLi93b3JrZXInO1xuZXhwb3J0ICogYXMgYWN0aXZpdHkgZnJvbSAnLi9hY3Rpdml0eSc7XG5leHBvcnQgKiBhcyB3b3JrZmxvdyBmcm9tICcuL3dvcmtmbG93JztcbmV4cG9ydCB7IFdvcmtmbG93Q29udGV4dCwgZ2V0Q3VycmVudENvbnRleHQgfSBmcm9tICcuL3dvcmtmbG93JztcbmV4cG9ydCB0eXBlIHtcbiAgV29ya2VyQ29uZmlnLFxuICBBY3Rpdml0eUhhbmRsZXIsXG4gIFdvcmtmbG93Q2xhc3MsXG4gIFdvcmtmbG93SW5zdGFuY2UsXG4gIFdvcmtmbG93VGFzayxcbiAgQWN0aXZpdHlUYXNrLFxuICBXb3JrZmxvd1Jlc3VsdCxcbiAgQWN0aXZpdHlSZXN1bHQsXG4gIFdvcmtmbG93RXJyb3IsXG4gIEFjdGl2aXR5RXJyb3IsXG4gIENvbXBsZXRlZEFjdGl2aXR5LFxufSBmcm9tICcuL3R5cGVzJztcbiJdfQ==

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+export interface WorkerConfig {
+    serverUrl: string;
+    apiKey: string;
+    groupId?: string;
+    maxConcurrentWorkflows?: number;
+}
+export type ActivityHandler<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput> | TOutput;
+export type DecoratedActivity = ActivityHandler<any, any> & {
+    __activityName__: string;
+    __isActivity__: boolean;
+};
+export type WorkflowClass = new () => WorkflowInstance;
+export interface WorkflowInstance {
+    run(input: unknown): Promise<unknown>;
+}
+export interface CompletedActivity {
+    index: number;
+    name: string;
+    output: unknown;
+    is_remote: boolean;
+}
+export interface WorkflowTask {
+    task_type: 'workflow';
+    task_id: string;
+    workflow_id: string;
+    workflow_name: string;
+    input: unknown;
+    timeout_ms: number;
+    created_at: string;
+    completed_activities?: CompletedActivity[];
+    metadata?: Record<string, unknown>;
+}
+export interface ActivityTask {
+    task_type?: 'activity';
+    task_id: string;
+    workflow_id: string;
+    activity_name: string;
+    activity_index: number;
+    input: unknown;
+    fan_out_index?: number;
+    fan_out_total?: number;
+    timeout_ms: number;
+    retry_count: number;
+    created_at: string;
+    requester_worker_id?: string;
+    correlation_id?: string;
+}
+export interface WorkflowResult {
+    task_id: string;
+    workflow_id: string;
+    workflow_name: string;
+    status: 'completed' | 'failed';
+    output?: unknown;
+    error?: WorkflowError;
+    started_at: string;
+    completed_at: string;
+    duration_ms: number;
+    worker_id: string;
+}
+export interface WorkflowError {
+    type: string;
+    message: string;
+    stack_trace?: string;
+}
+export interface ActivityResult {
+    task_id: string;
+    workflow_id: string;
+    activity_name: string;
+    activity_index: number;
+    fan_out_index?: number;
+    status: 'completed' | 'failed';
+    output?: unknown;
+    error?: ActivityError;
+    started_at: string;
+    completed_at: string;
+    duration_ms: number;
+    worker_id: string;
+    requester_worker_id?: string;
+    correlation_id?: string;
+}
+export interface ActivityError {
+    type: string;
+    message: string;
+    stack_trace?: string;
+}
+export interface KafkaConfig {
+    brokers: string[];
+    worker_topic: string;
+    result_topic: string;
+    auth?: {
+        type: 'plaintext' | 'sasl' | 'msk_iam';
+        region?: string;
+        access_key_id?: string;
+        secret_access_key?: string;
+        security_protocol?: string;
+        sasl_mechanism?: string;
+        sasl_username?: string;
+        sasl_password?: string;
+    };
+}
+export interface ConnectResponse {
+    worker_id: string;
+    instance_id: string;
+    heartbeat_interval_ms: number;
+    kafka: KafkaConfig;
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Type definitions for Workflow SDK
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLG9DQUFvQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIFR5cGUgZGVmaW5pdGlvbnMgZm9yIFdvcmtmbG93IFNES1xuXG5leHBvcnQgaW50ZXJmYWNlIFdvcmtlckNvbmZpZyB7XG4gIHNlcnZlclVybDogc3RyaW5nO1xuICBhcGlLZXk6IHN0cmluZztcbiAgZ3JvdXBJZD86IHN0cmluZztcbiAgbWF4Q29uY3VycmVudFdvcmtmbG93cz86IG51bWJlcjtcbn1cblxuZXhwb3J0IHR5cGUgQWN0aXZpdHlIYW5kbGVyPFRJbnB1dCA9IHVua25vd24sIFRPdXRwdXQgPSB1bmtub3duPiA9IChcbiAgaW5wdXQ6IFRJbnB1dFxuKSA9PiBQcm9taXNlPFRPdXRwdXQ+IHwgVE91dHB1dDtcblxuZXhwb3J0IHR5cGUgRGVjb3JhdGVkQWN0aXZpdHkgPSBBY3Rpdml0eUhhbmRsZXI8YW55LCBhbnk+ICYge1xuICBfX2FjdGl2aXR5TmFtZV9fOiBzdHJpbmc7XG4gIF9faXNBY3Rpdml0eV9fOiBib29sZWFuO1xufTtcblxuZXhwb3J0IHR5cGUgV29ya2Zsb3dDbGFzcyA9IG5ldyAoKSA9PiBXb3JrZmxvd0luc3RhbmNlO1xuXG5leHBvcnQgaW50ZXJmYWNlIFdvcmtmbG93SW5zdGFuY2Uge1xuICBydW4oaW5wdXQ6IHVua25vd24pOiBQcm9taXNlPHVua25vd24+O1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIENvbXBsZXRlZEFjdGl2aXR5IHtcbiAgaW5kZXg6IG51bWJlcjtcbiAgbmFtZTogc3RyaW5nO1xuICBvdXRwdXQ6IHVua25vd247XG4gIGlzX3JlbW90ZTogYm9vbGVhbjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBXb3JrZmxvd1Rhc2sge1xuICB0YXNrX3R5cGU6ICd3b3JrZmxvdyc7XG4gIHRhc2tfaWQ6IHN0cmluZztcbiAgd29ya2Zsb3dfaWQ6IHN0cmluZztcbiAgd29ya2Zsb3dfbmFtZTogc3RyaW5nO1xuICBpbnB1dDogdW5rbm93bjtcbiAgdGltZW91dF9tczogbnVtYmVyO1xuICBjcmVhdGVkX2F0OiBzdHJpbmc7XG4gIGNvbXBsZXRlZF9hY3Rpdml0aWVzPzogQ29tcGxldGVkQWN0aXZpdHlbXTtcbiAgbWV0YWRhdGE/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBBY3Rpdml0eVRhc2sge1xuICB0YXNrX3R5cGU/OiAnYWN0aXZpdHknO1xuICB0YXNrX2lkOiBzdHJpbmc7XG4gIHdvcmtmbG93X2lkOiBzdHJpbmc7XG4gIGFjdGl2aXR5X25hbWU6IHN0cmluZztcbiAgYWN0aXZpdHlfaW5kZXg6IG51bWJlcjtcbiAgaW5wdXQ6IHVua25vd247XG4gIGZhbl9vdXRfaW5kZXg/OiBudW1iZXI7XG4gIGZhbl9vdXRfdG90YWw/OiBudW1iZXI7XG4gIHRpbWVvdXRfbXM6IG51bWJlcjtcbiAgcmV0cnlfY291bnQ6IG51bWJlcjtcbiAgY3JlYXRlZF9hdDogc3RyaW5nO1xuICByZXF1ZXN0ZXJfd29ya2VyX2lkPzogc3RyaW5nO1xuICBjb3JyZWxhdGlvbl9pZD86IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBXb3JrZmxvd1Jlc3VsdCB7XG4gIHRhc2tfaWQ6IHN0cmluZztcbiAgd29ya2Zsb3dfaWQ6IHN0cmluZztcbiAgd29ya2Zsb3dfbmFtZTogc3RyaW5nO1xuICBzdGF0dXM6ICdjb21wbGV0ZWQnIHwgJ2ZhaWxlZCc7XG4gIG91dHB1dD86IHVua25vd247XG4gIGVycm9yPzogV29ya2Zsb3dFcnJvcjtcbiAgc3RhcnRlZF9hdDogc3RyaW5nO1xuICBjb21wbGV0ZWRfYXQ6IHN0cmluZztcbiAgZHVyYXRpb25fbXM6IG51bWJlcjtcbiAgd29ya2VyX2lkOiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgV29ya2Zsb3dFcnJvciB7XG4gIHR5cGU6IHN0cmluZztcbiAgbWVzc2FnZTogc3RyaW5nO1xuICBzdGFja190cmFjZT86IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBBY3Rpdml0eVJlc3VsdCB7XG4gIHRhc2tfaWQ6IHN0cmluZztcbiAgd29ya2Zsb3dfaWQ6IHN0cmluZztcbiAgYWN0aXZpdHlfbmFtZTogc3RyaW5nO1xuICBhY3Rpdml0eV9pbmRleDogbnVtYmVyO1xuICBmYW5fb3V0X2luZGV4PzogbnVtYmVyO1xuICBzdGF0dXM6ICdjb21wbGV0ZWQnIHwgJ2ZhaWxlZCc7XG4gIG91dHB1dD86IHVua25vd247XG4gIGVycm9yPzogQWN0aXZpdHlFcnJvcjtcbiAgc3RhcnRlZF9hdDogc3RyaW5nO1xuICBjb21wbGV0ZWRfYXQ6IHN0cmluZztcbiAgZHVyYXRpb25fbXM6IG51bWJlcjtcbiAgd29ya2VyX2lkOiBzdHJpbmc7XG4gIHJlcXVlc3Rlcl93b3JrZXJfaWQ/OiBzdHJpbmc7XG4gIGNvcnJlbGF0aW9uX2lkPzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIEFjdGl2aXR5RXJyb3Ige1xuICB0eXBlOiBzdHJpbmc7XG4gIG1lc3NhZ2U6IHN0cmluZztcbiAgc3RhY2tfdHJhY2U/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgS2Fma2FDb25maWcge1xuICBicm9rZXJzOiBzdHJpbmdbXTtcbiAgd29ya2VyX3RvcGljOiBzdHJpbmc7XG4gIHJlc3VsdF90b3BpYzogc3RyaW5nO1xuICBhdXRoPzoge1xuICAgIHR5cGU6ICdwbGFpbnRleHQnIHwgJ3Nhc2wnIHwgJ21za19pYW0nO1xuICAgIHJlZ2lvbj86IHN0cmluZztcbiAgICBhY2Nlc3Nfa2V5X2lkPzogc3RyaW5nO1xuICAgIHNlY3JldF9hY2Nlc3Nfa2V5Pzogc3RyaW5nO1xuICAgIHNlY3VyaXR5X3Byb3RvY29sPzogc3RyaW5nO1xuICAgIHNhc2xfbWVjaGFuaXNtPzogc3RyaW5nO1xuICAgIHNhc2xfdXNlcm5hbWU/OiBzdHJpbmc7XG4gICAgc2FzbF9wYXNzd29yZD86IHN0cmluZztcbiAgfTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBDb25uZWN0UmVzcG9uc2Uge1xuICB3b3JrZXJfaWQ6IHN0cmluZztcbiAgaW5zdGFuY2VfaWQ6IHN0cmluZztcbiAgaGVhcnRiZWF0X2ludGVydmFsX21zOiBudW1iZXI7XG4gIGthZmthOiBLYWZrYUNvbmZpZztcbn1cbiJdfQ==

package/dist/worker.d.ts

@@ -0,0 +1,73 @@
+import type { WorkerConfig, DecoratedActivity, WorkflowClass } from './types';
+import { type WorkerInterface } from './workflow';
+/**
+ * Worker that executes workflows and activities.
+ *
+ * Usage:
+ *   import { Worker, workflow, activity } from '@inspectica/workflow-sdk';
+ *
+ *   const sayHello = activity.defn(async (input: { name: string }) => {
+ *     return { message: `Hello, ${input.name}!` };
+ *   });
+ *
+ *   @workflow.defn
+ *   class HelloWorldWorkflow {
+ *     @workflow.run
+ *     async run(input: { name: string }) {
+ *       return await workflow.executeActivity(sayHello, input);
+ *     }
+ *   }
+ *
+ *   const worker = new Worker({
+ *     serverUrl: 'https://workflow.example.com',
+ *     apiKey: 'wk_abc123...',
+ *   });
+ *   worker.register({ workflows: [HelloWorldWorkflow], activities: [sayHello] });
+ *   await worker.run();
+ */
+export declare class Worker implements WorkerInterface {
+    private config;
+    private workflows;
+    private activities;
+    private workerId;
+    private instanceId;
+    private running;
+    private kafka;
+    private consumer;
+    private producer;
+    private heartbeatInterval;
+    private heartbeatIntervalMs;
+    private resultTopic;
+    private maxConcurrentWorkflows;
+    private activeWorkflows;
+    constructor(config: WorkerConfig);
+    /**
+     * Register workflows and activities.
+     */
+    register(options: {
+        workflows?: WorkflowClass[];
+        activities?: DecoratedActivity[];
+    }): void;
+    /**
+     * Start the worker (blocking).
+     */
+    run(): Promise<void>;
+    /**
+     * Stop the worker gracefully.
+     */
+    stop(): Promise<void>;
+    private connectToServer;
+    private createKafkaClient;
+    private startHeartbeat;
+    private disconnectFromServer;
+    private processMessage;
+    private processWorkflowTask;
+    private executeWorkflow;
+    private processActivityTask;
+    private sendWorkflowResult;
+    private sendActivityResult;
+    reportLocalActivityCompletion(workflowId: string, activityName: string, activityIndex: number, output: unknown, durationMs: number): Promise<void>;
+    reportLocalActivityFailure(workflowId: string, activityName: string, activityIndex: number, error: string, errorType: string, durationMs: number): Promise<void>;
+    executeRemoteActivity(workflowId: string, activityName: string, activityIndex: number, inputData: unknown, timeoutMs: number): Promise<unknown>;
+    private cleanup;
+}