@tasker-systems/tasker 0.1.7 → 0.1.8

package/dist/index.js

@@ -1,8 +1,8 @@
-import { EventEmitter } from 'eventemitter3';
-import pino from 'pino';
 import { existsSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
+import { EventEmitter } from 'eventemitter3';
+import pino from 'pino';
 import { readdir } from 'fs/promises';
 
 var __defProp = Object.defineProperty;
@@ -378,6 +378,131 @@ function healthCheck(module) {
     return false;
   }
 }
+var FfiLayer = class _FfiLayer {
+  module = null;
+  modulePath = null;
+  configuredModulePath;
+  constructor(config = {}) {
+    this.configuredModulePath = config.modulePath;
+  }
+  /**
+   * Load the napi-rs native module.
+   *
+   * @param customPath - Optional override for module path
+   * @throws Error if module not found or failed to load
+   */
+  async load(customPath) {
+    if (this.module) {
+      return;
+    }
+    const path = customPath ?? this.configuredModulePath ?? this.discoverModulePath();
+    if (!path) {
+      throw new Error(
+        `napi-rs native module not found. No bundled .node file matches this platform, and TASKER_FFI_MODULE_PATH is not set.
+Current platform: ${process.platform}-${process.arch}
+Supported: linux-x64, darwin-arm64
+Override: export TASKER_FFI_MODULE_PATH=/path/to/tasker_ts.linux-x64-gnu.node`
+      );
+    }
+    const nativeModule = __require(path);
+    this.module = nativeModule;
+    this.modulePath = path;
+  }
+  /**
+   * Unload the native module and release resources.
+   */
+  async unload() {
+    this.module = null;
+    this.modulePath = null;
+  }
+  /**
+   * Check if the native module is loaded.
+   */
+  isLoaded() {
+    return this.module !== null;
+  }
+  /**
+   * Get the loaded napi-rs module.
+   *
+   * @throws Error if module is not loaded
+   */
+  getModule() {
+    if (!this.module) {
+      throw new Error("FFI not loaded. Call load() first.");
+    }
+    return this.module;
+  }
+  /**
+   * Backward-compatible alias for getModule().
+   *
+   * @deprecated Use getModule() instead
+   */
+  getRuntime() {
+    return this.getModule();
+  }
+  /**
+   * Get the path to the loaded module.
+   */
+  getModulePath() {
+    return this.modulePath;
+  }
+  /**
+   * Find the napi-rs module path.
+   *
+   * Resolution order:
+   * 1. TASKER_FFI_MODULE_PATH environment variable (explicit override, for unusual setups)
+   * 2. Bundled .node file in package directory (standard path — `napi build --platform` places it here)
+   */
+  static findModulePath() {
+    const envPath = process.env.TASKER_FFI_MODULE_PATH;
+    if (envPath) {
+      if (!existsSync(envPath)) {
+        console.warn(`TASKER_FFI_MODULE_PATH is set to "${envPath}" but the file does not exist`);
+        return null;
+      }
+      return envPath;
+    }
+    const bundledPath = findBundledNodeModule();
+    if (bundledPath && existsSync(bundledPath)) {
+      return bundledPath;
+    }
+    return null;
+  }
+  /**
+   * Backward-compatible alias for findModulePath().
+   *
+   * @deprecated Use findModulePath() instead
+   */
+  static findLibraryPath(_callerDir) {
+    return _FfiLayer.findModulePath();
+  }
+  discoverModulePath() {
+    return _FfiLayer.findModulePath();
+  }
+};
+var BUNDLED_NODE_MODULES = {
+  "linux-x64": "tasker_ts.linux-x64-gnu.node",
+  "darwin-arm64": "tasker_ts.darwin-arm64.node",
+  "darwin-x64": "tasker_ts.darwin-x64.node"
+};
+function findBundledNodeModule() {
+  const key = `${process.platform}-${process.arch}`;
+  const filename = BUNDLED_NODE_MODULES[key];
+  if (!filename) {
+    return null;
+  }
+  let dir = dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 5; i++) {
+    const candidate = join(dir, filename);
+    if (existsSync(candidate)) return candidate;
+    const nativeCandidate = join(dir, "native", filename);
+    if (existsSync(nativeCandidate)) return nativeCandidate;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
 
 // src/client/index.ts
 var TaskerClientError = class extends Error {
@@ -398,7 +523,7 @@ var TaskerClient = class {
    * Create a task via the orchestration API.
    *
    * @param options - Task creation options (only `name` is required)
-   * @returns Typed task response data
+   * @returns Task response with execution context and step readiness
    * @throws TaskerClientError if the operation fails
    */
   createTask(options) {
@@ -425,7 +550,7 @@ var TaskerClient = class {
    * Get a task by UUID.
    *
    * @param taskUuid - The task UUID
-   * @returns Typed task response data
+   * @returns Task response with execution context and step readiness
    * @throws TaskerClientError if the operation fails
    */
   getTask(taskUuid) {
@@ -436,7 +561,7 @@ var TaskerClient = class {
    * List tasks with optional filtering and pagination.
    *
    * @param options - Filtering and pagination options
-   * @returns Typed task list response data
+   * @returns Task list with pagination metadata
    * @throws TaskerClientError if the operation fails
    */
   listTasks(options = {}) {
@@ -463,7 +588,7 @@ var TaskerClient = class {
    * List workflow steps for a task.
    *
    * @param taskUuid - The task UUID
-   * @returns Array of step data
+   * @returns Array of step responses with readiness information
    * @throws TaskerClientError if the operation fails
    */
   listTaskSteps(taskUuid) {
@@ -475,7 +600,7 @@ var TaskerClient = class {
    *
    * @param taskUuid - The task UUID
    * @param stepUuid - The step UUID
-   * @returns Typed step response data
+   * @returns Step response with readiness information
    * @throws TaskerClientError if the operation fails
    */
   getStep(taskUuid, stepUuid) {
@@ -487,7 +612,7 @@ var TaskerClient = class {
    *
    * @param taskUuid - The task UUID
    * @param stepUuid - The step UUID
-   * @returns Array of audit history entries
+   * @returns Array of audit history entries with attribution context
    * @throws TaskerClientError if the operation fails
    */
   getStepAuditHistory(taskUuid, stepUuid) {
@@ -497,7 +622,7 @@ var TaskerClient = class {
   /**
    * Check orchestration API health.
    *
-   * @returns Typed health response data
+   * @returns Health status from the orchestration API
    * @throws TaskerClientError if the operation fails
    */
   healthCheck() {
@@ -506,6 +631,11 @@ var TaskerClient = class {
   }
   /**
    * Unwrap a NapiClientResult envelope, throwing on error.
+   *
+   * The type parameter allows callers to assert the expected response shape.
+   * The actual data comes from Rust via serde_json serialization, so the
+   * runtime shape is guaranteed by the Rust type system — the cast here
+   * is safe at the FFI boundary.
    */
   unwrap(result) {
     if (!result.success) {
@@ -523,6 +653,26 @@ var TaskerClient = class {
     return this.ffiLayer.getModule();
   }
 };
+var sharedFfiLayer = null;
+var loadPromise = null;
+async function getFfiLayer() {
+  if (sharedFfiLayer) {
+    return sharedFfiLayer;
+  }
+  if (!loadPromise) {
+    loadPromise = (async () => {
+      const layer = new FfiLayer();
+      await layer.load();
+      sharedFfiLayer = layer;
+      return layer;
+    })();
+  }
+  return loadPromise;
+}
+async function getTaskerClient() {
+  const ffiLayer = await getFfiLayer();
+  return new TaskerClient(ffiLayer);
+}
 
 // src/events/event-names.ts
 var StepEventNames = {
@@ -2093,6 +2243,10 @@ var StepExecutionSubscriber = class {
   /**
    * Send a completion result to Rust via FFI and handle the response.
    *
+   * If the primary FFI call fails (e.g. serialization error, unexpected
+   * type mismatch), we construct a guaranteed-safe failure result so the
+   * step is marked as permanently failed rather than silently lost.
+   *
    * @returns true if the completion was accepted by Rust, false otherwise
    */
   async sendCompletionViaFfi(event, napiResult, isSuccess) {
@@ -2116,8 +2270,61 @@ var StepExecutionSubscriber = class {
       return false;
     } catch (error) {
       this.handleFfiError(event, error);
-      return false;
+      return this.submitFallbackFailure(event, error);
+    }
+  }
+  /**
+   * Submit a minimal safe-failure result after the primary FFI call fails.
+   *
+   * Builds a primitive-only result guaranteed to serialize, then attempts
+   * to submit it. Throws if the fallback is also rejected or fails,
+   * since the step would otherwise be silently lost.
+   */
+  submitFallbackFailure(event, originalError) {
+    const fallback = this.buildFfiSafeFailure(event, originalError);
+    try {
+      const accepted = this.module.completeStepEvent(event.eventId, fallback);
+      if (accepted) {
+        pinoLog.warn(
+          { component: "subscriber", eventId: event.eventId },
+          "FFI fallback failure submitted successfully"
+        );
+        return true;
+      }
+      this.throwOrphanedError(event, "rejected", originalError);
+    } catch (fallbackError) {
+      this.throwOrphanedError(event, "failed", originalError, fallbackError);
     }
+    return false;
+  }
+  /**
+   * Throw an error indicating a step has been orphaned (both primary and fallback failed).
+   */
+  throwOrphanedError(event, reason, originalError, fallbackError) {
+    const originalMsg = originalError instanceof Error ? originalError.message : String(originalError);
+    if (reason === "rejected") {
+      pinoLog.error(
+        { component: "subscriber", eventId: event.eventId, stepUuid: event.stepUuid },
+        "FFI fallback submission also rejected - step is orphaned"
+      );
+      throw new Error(
+        `Both primary and fallback FFI submissions rejected for event ${event.eventId}. Step ${event.stepUuid} is orphaned.`
+      );
+    }
+    const fallbackMsg = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
+    pinoLog.error(
+      {
+        component: "subscriber",
+        eventId: event.eventId,
+        stepUuid: event.stepUuid,
+        error: fallbackMsg,
+        originalError: originalMsg
+      },
+      "FFI fallback also failed - step is orphaned"
+    );
+    throw new Error(
+      `Both primary and fallback FFI submissions failed for event ${event.eventId}. Step ${event.stepUuid} is orphaned. Fallback: ${fallbackMsg}, Original: ${originalMsg}`
+    );
   }
   /**
    * Handle successful FFI completion submission.
@@ -2177,6 +2384,36 @@ var StepExecutionSubscriber = class {
       error_message: error instanceof Error ? error.message : String(error)
     });
   }
+  /**
+   * Build a minimal NapiStepExecutionResult guaranteed to serialize through napi-rs.
+   *
+   * Uses only primitive values so there is zero chance of a secondary
+   * serialization failure. The step will be marked as permanently failed
+   * rather than silently lost.
+   */
+  buildFfiSafeFailure(event, error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      stepUuid: event.stepUuid,
+      success: false,
+      result: {},
+      status: "error",
+      metadata: {
+        executionTimeMs: 0,
+        retryable: false,
+        completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        ...this.workerId != null && { workerId: this.workerId },
+        custom: {
+          ffi_serialization_error: errorMessage.substring(0, 500)
+        }
+      },
+      error: {
+        message: `FFI serialization failed: ${errorMessage}`.substring(0, 500),
+        errorType: "FFI_SERIALIZATION_ERROR",
+        retryable: false
+      }
+    };
+  }
 };
 
 // src/events/event-system.ts
@@ -2322,131 +2559,6 @@ var EventSystem = class {
     };
   }
 };
-var FfiLayer = class _FfiLayer {
-  module = null;
-  modulePath = null;
-  configuredModulePath;
-  constructor(config = {}) {
-    this.configuredModulePath = config.modulePath;
-  }
-  /**
-   * Load the napi-rs native module.
-   *
-   * @param customPath - Optional override for module path
-   * @throws Error if module not found or failed to load
-   */
-  async load(customPath) {
-    if (this.module) {
-      return;
-    }
-    const path = customPath ?? this.configuredModulePath ?? this.discoverModulePath();
-    if (!path) {
-      throw new Error(
-        `napi-rs native module not found. No bundled .node file matches this platform, and TASKER_FFI_MODULE_PATH is not set.
-Current platform: ${process.platform}-${process.arch}
-Supported: linux-x64, darwin-arm64
-Override: export TASKER_FFI_MODULE_PATH=/path/to/tasker_ts.linux-x64-gnu.node`
-      );
-    }
-    const nativeModule = __require(path);
-    this.module = nativeModule;
-    this.modulePath = path;
-  }
-  /**
-   * Unload the native module and release resources.
-   */
-  async unload() {
-    this.module = null;
-    this.modulePath = null;
-  }
-  /**
-   * Check if the native module is loaded.
-   */
-  isLoaded() {
-    return this.module !== null;
-  }
-  /**
-   * Get the loaded napi-rs module.
-   *
-   * @throws Error if module is not loaded
-   */
-  getModule() {
-    if (!this.module) {
-      throw new Error("FFI not loaded. Call load() first.");
-    }
-    return this.module;
-  }
-  /**
-   * Backward-compatible alias for getModule().
-   *
-   * @deprecated Use getModule() instead
-   */
-  getRuntime() {
-    return this.getModule();
-  }
-  /**
-   * Get the path to the loaded module.
-   */
-  getModulePath() {
-    return this.modulePath;
-  }
-  /**
-   * Find the napi-rs module path.
-   *
-   * Resolution order:
-   * 1. TASKER_FFI_MODULE_PATH environment variable (explicit override, for unusual setups)
-   * 2. Bundled .node file in package directory (standard path — `napi build --platform` places it here)
-   */
-  static findModulePath() {
-    const envPath = process.env.TASKER_FFI_MODULE_PATH;
-    if (envPath) {
-      if (!existsSync(envPath)) {
-        console.warn(`TASKER_FFI_MODULE_PATH is set to "${envPath}" but the file does not exist`);
-        return null;
-      }
-      return envPath;
-    }
-    const bundledPath = findBundledNodeModule();
-    if (bundledPath && existsSync(bundledPath)) {
-      return bundledPath;
-    }
-    return null;
-  }
-  /**
-   * Backward-compatible alias for findModulePath().
-   *
-   * @deprecated Use findModulePath() instead
-   */
-  static findLibraryPath(_callerDir) {
-    return _FfiLayer.findModulePath();
-  }
-  discoverModulePath() {
-    return _FfiLayer.findModulePath();
-  }
-};
-var BUNDLED_NODE_MODULES = {
-  "linux-x64": "tasker_ts.linux-x64-gnu.node",
-  "darwin-arm64": "tasker_ts.darwin-arm64.node",
-  "darwin-x64": "tasker_ts.darwin-x64.node"
-};
-function findBundledNodeModule() {
-  const key = `${process.platform}-${process.arch}`;
-  const filename = BUNDLED_NODE_MODULES[key];
-  if (!filename) {
-    return null;
-  }
-  let dir = dirname(fileURLToPath(import.meta.url));
-  for (let i = 0; i < 5; i++) {
-    const candidate = join(dir, filename);
-    if (existsSync(candidate)) return candidate;
-    const nativeCandidate = join(dir, "native", filename);
-    if (existsSync(nativeCandidate)) return nativeCandidate;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
 
 // src/handler/base.ts
 var StepHandler = class {
@@ -6458,6 +6570,6 @@ var WorkerServer = class {
   }
 };
 
-export { APIMixin, ApiHandler, ApiResponse, BasePublisher, BaseSubscriber, BatchableMixin, ClassLookupResolver, Decision, DecisionHandler, DecisionMixin, DecisionType, DefaultPublisher, DuplicatePublisherError, ErrorType, EventNames, EventPoller, EventSystem, ExplicitMappingResolver, FfiLayer, HandlerRegistry, HandlerSystem, InProcessDomainEventPoller, MethodDispatchError, MethodDispatchWrapper, MetricsEventNames, NoResolverMatchError, PermanentError, PollerEventNames, PublisherNotFoundError, PublisherRegistry, PublisherValidationError, RegistryFrozenError, RegistryResolver, ResolutionError, ResolverChain, ResolverNotFoundError, RetryableError, ShutdownController, StepContext, StepEventNames, StepExecutionSubscriber, StepHandler, StepHandlerResult, SubscriberRegistry, TaskerClient, TaskerClientError, TaskerEventEmitter, WorkerEventNames, WorkerServer, aggregateBatchResults, applyAPI, applyBatchable, applyDecision, bootstrapWorker, createBatchWorkerContext, createBatches, createDomainEvent, createEventPoller, createFfiPollAdapter, createLogger, createStepEventContext, defineApiHandler, defineBatchAnalyzer, defineBatchWorker, defineDecisionHandler, defineHandler, effectiveMethod, ffiEventToDomainEvent, fromCallable, fromDto, getRustVersion, getVersion, getWorkerStatus, hasResolverHint, healthCheck, isCreateBatches, isNoBatches, isStandardErrorType, isTypicallyRetryable, isWorkerRunning, logDebug, logError, logInfo, logTrace, logWarn, noBatches, normalizeToDefinition, stopWorker, transitionToGracefulShutdown, usesMethodDispatch };
+export { APIMixin, ApiHandler, ApiResponse, BasePublisher, BaseSubscriber, BatchableMixin, ClassLookupResolver, Decision, DecisionHandler, DecisionMixin, DecisionType, DefaultPublisher, DuplicatePublisherError, ErrorType, EventNames, EventPoller, EventSystem, ExplicitMappingResolver, FfiLayer, HandlerRegistry, HandlerSystem, InProcessDomainEventPoller, MethodDispatchError, MethodDispatchWrapper, MetricsEventNames, NoResolverMatchError, PermanentError, PollerEventNames, PublisherNotFoundError, PublisherRegistry, PublisherValidationError, RegistryFrozenError, RegistryResolver, ResolutionError, ResolverChain, ResolverNotFoundError, RetryableError, ShutdownController, StepContext, StepEventNames, StepExecutionSubscriber, StepHandler, StepHandlerResult, SubscriberRegistry, TaskerClient, TaskerClientError, TaskerEventEmitter, WorkerEventNames, WorkerServer, aggregateBatchResults, applyAPI, applyBatchable, applyDecision, bootstrapWorker, createBatchWorkerContext, createBatches, createDomainEvent, createEventPoller, createFfiPollAdapter, createLogger, createStepEventContext, defineApiHandler, defineBatchAnalyzer, defineBatchWorker, defineDecisionHandler, defineHandler, effectiveMethod, ffiEventToDomainEvent, fromCallable, fromDto, getFfiLayer, getRustVersion, getTaskerClient, getVersion, getWorkerStatus, hasResolverHint, healthCheck, isCreateBatches, isNoBatches, isStandardErrorType, isTypicallyRetryable, isWorkerRunning, logDebug, logError, logInfo, logTrace, logWarn, noBatches, normalizeToDefinition, stopWorker, transitionToGracefulShutdown, usesMethodDispatch };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map