@gravito/flux 3.0.3 → 4.0.0

package/dist/bun.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkZE2RDS47cjs = require('./chunk-ZE2RDS47.cjs');
+var _chunkOAJWPPYGcjs = require('./chunk-OAJWPPYG.cjs');
 
 
-exports.BunSQLiteStorage = _chunkZE2RDS47cjs.BunSQLiteStorage;
+exports.BunSQLiteStorage = _chunkOAJWPPYGcjs.BunSQLiteStorage;
 //# sourceMappingURL=bun.cjs.map

package/dist/bun.js

@@ -1,6 +1,6 @@
 import {
   BunSQLiteStorage
-} from "./chunk-EZGSU6AW.js";
+} from "./chunk-UZKSACBE.js";
 export {
   BunSQLiteStorage
 };

package/dist/{chunk-DN7SIQ34.cjs → chunk-AVWZYY7U.cjs}

@@ -1,117 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9;
 
-var _chunkZE2RDS47cjs = require('./chunk-ZE2RDS47.cjs');
 
-// src/errors.ts
-var FluxErrorCode = /* @__PURE__ */ ((FluxErrorCode2) => {
-  FluxErrorCode2["WORKFLOW_NOT_FOUND"] = "WORKFLOW_NOT_FOUND";
-  FluxErrorCode2["WORKFLOW_INVALID_INPUT"] = "WORKFLOW_INVALID_INPUT";
-  FluxErrorCode2["WORKFLOW_DEFINITION_CHANGED"] = "WORKFLOW_DEFINITION_CHANGED";
-  FluxErrorCode2["WORKFLOW_NAME_MISMATCH"] = "WORKFLOW_NAME_MISMATCH";
-  FluxErrorCode2["INVALID_STATE_TRANSITION"] = "INVALID_STATE_TRANSITION";
-  FluxErrorCode2["WORKFLOW_NOT_SUSPENDED"] = "WORKFLOW_NOT_SUSPENDED";
-  FluxErrorCode2["INVALID_STEP_INDEX"] = "INVALID_STEP_INDEX";
-  FluxErrorCode2["STEP_TIMEOUT"] = "STEP_TIMEOUT";
-  FluxErrorCode2["STEP_NOT_FOUND"] = "STEP_NOT_FOUND";
-  FluxErrorCode2["CONCURRENT_MODIFICATION"] = "CONCURRENT_MODIFICATION";
-  FluxErrorCode2["EMPTY_WORKFLOW"] = "EMPTY_WORKFLOW";
-  FluxErrorCode2["NO_RECOVERY_ACTION"] = "NO_RECOVERY_ACTION";
-  FluxErrorCode2["INVALID_JSON_POINTER"] = "INVALID_JSON_POINTER";
-  FluxErrorCode2["INVALID_PATH_TRAVERSAL"] = "INVALID_PATH_TRAVERSAL";
-  FluxErrorCode2["CANNOT_REPLACE_ROOT"] = "CANNOT_REPLACE_ROOT";
-  FluxErrorCode2["CANNOT_REMOVE_ROOT"] = "CANNOT_REMOVE_ROOT";
-  return FluxErrorCode2;
-})(FluxErrorCode || {});
-var FluxError = class extends Error {
-  /**
-   * Creates a new FluxError.
-   *
-   * @param message - Human-readable error description.
-   * @param code - Machine-readable error code.
-   * @param context - Additional metadata related to the error.
-   */
-  constructor(message, code, context) {
-    super(message);
-    this.code = code;
-    this.context = context;
-    this.name = "FluxError";
-  }
-};
-function workflowNotFound(id) {
-  return new FluxError(`Workflow not found: ${id}`, "WORKFLOW_NOT_FOUND" /* WORKFLOW_NOT_FOUND */, {
-    workflowId: id
-  });
-}
-function invalidStateTransition(from, to) {
-  return new FluxError(
-    `Invalid state transition: ${from} \u2192 ${to}`,
-    "INVALID_STATE_TRANSITION" /* INVALID_STATE_TRANSITION */,
-    { from, to }
-  );
-}
-function invalidInput(workflowName) {
-  return new FluxError(
-    `Invalid input for workflow "${workflowName}"`,
-    "WORKFLOW_INVALID_INPUT" /* WORKFLOW_INVALID_INPUT */,
-    { workflowName }
-  );
-}
-function workflowNameMismatch(expected, received) {
-  return new FluxError(
-    `Workflow name mismatch: ${received} !== ${expected}`,
-    "WORKFLOW_NAME_MISMATCH" /* WORKFLOW_NAME_MISMATCH */,
-    { expected, received }
-  );
-}
-function workflowDefinitionChanged() {
-  return new FluxError(
-    "Workflow definition changed; operation is not safe",
-    "WORKFLOW_DEFINITION_CHANGED" /* WORKFLOW_DEFINITION_CHANGED */
-  );
-}
-function workflowNotSuspended(status) {
-  return new FluxError(
-    `Workflow is not suspended (status: ${status})`,
-    "WORKFLOW_NOT_SUSPENDED" /* WORKFLOW_NOT_SUSPENDED */,
-    { status }
-  );
-}
-function stepNotFound(step) {
-  return new FluxError(`Step not found: ${step}`, "STEP_NOT_FOUND" /* STEP_NOT_FOUND */, { step });
-}
-function invalidStepIndex(index) {
-  return new FluxError(`Invalid step index: ${index}`, "INVALID_STEP_INDEX" /* INVALID_STEP_INDEX */, { index });
-}
-function emptyWorkflow(workflowName) {
-  return new FluxError(`Workflow "${workflowName}" has no steps`, "EMPTY_WORKFLOW" /* EMPTY_WORKFLOW */, {
-    workflowName
-  });
-}
-function noRecoveryAction(stepName) {
-  return new FluxError(
-    `No recovery action registered for step: ${stepName}`,
-    "NO_RECOVERY_ACTION" /* NO_RECOVERY_ACTION */,
-    { stepName }
-  );
-}
-function invalidJsonPointer(path) {
-  return new FluxError(`Invalid JSON Pointer: ${path}`, "INVALID_JSON_POINTER" /* INVALID_JSON_POINTER */, {
-    path
-  });
-}
-function invalidPathTraversal(segment, current) {
-  return new FluxError(
-    `Cannot access property '${segment}' on ${current}`,
-    "INVALID_PATH_TRAVERSAL" /* INVALID_PATH_TRAVERSAL */,
-    { segment, currentType: typeof current }
-  );
-}
-function cannotReplaceRoot() {
-  return new FluxError("Cannot replace root object", "CANNOT_REPLACE_ROOT" /* CANNOT_REPLACE_ROOT */);
-}
-function cannotRemoveRoot() {
-  return new FluxError("Cannot remove root object", "CANNOT_REMOVE_ROOT" /* CANNOT_REMOVE_ROOT */);
-}
+
+
+
+
+
+
+
+
+
+
+var _chunkOAJWPPYGcjs = require('./chunk-OAJWPPYG.cjs');
 
 // src/builder/WorkflowBuilder.ts
 var WorkflowBuilder = (_class = class {
@@ -244,7 +144,7 @@ var WorkflowBuilder = (_class = class {
    */
   build() {
     if (this._steps.length === 0) {
-      throw emptyWorkflow(this._name);
+      throw _chunkOAJWPPYGcjs.emptyWorkflow.call(void 0, this._name);
     }
     return {
       name: this._name,
@@ -713,7 +613,7 @@ var StateMachine = (_class3 = class extends EventTarget {constructor(...args2) {
    */
   transition(to) {
     if (!this.canTransition(to)) {
-      throw invalidStateTransition(this._status, to);
+      throw _chunkOAJWPPYGcjs.invalidStateTransition.call(void 0, this._status, to);
     }
     const from = this._status;
     this._status = to;
@@ -1522,14 +1422,14 @@ function resolveDefinition(workflow) {
 function resolveStartIndex(definition, fromStep, fallback) {
   if (typeof fromStep === "number") {
     if (fromStep < 0 || fromStep >= definition.steps.length) {
-      throw invalidStepIndex(fromStep);
+      throw _chunkOAJWPPYGcjs.invalidStepIndex.call(void 0, fromStep);
     }
     return fromStep;
   }
   if (typeof fromStep === "string") {
     const index = definition.steps.findIndex((step) => step.name === fromStep);
     if (index === -1) {
-      throw stepNotFound(fromStep);
+      throw _chunkOAJWPPYGcjs.stepNotFound.call(void 0, fromStep);
     }
     return index;
   }
@@ -1585,7 +1485,7 @@ async function persistContext(ctx, storage, contextManager, definitionVersion) {
   const state = contextManager.toState(ctx);
   const stored = await storage.load(state.id);
   if (stored && stored.version !== state.version) {
-    throw new FluxError(
+    throw new (0, _chunkOAJWPPYGcjs.FluxError)(
       "Concurrent modification detected",
       "CONCURRENT_MODIFICATION" /* CONCURRENT_MODIFICATION */
     );
@@ -1860,7 +1760,7 @@ var RecoveryManager = (_class6 = class {constructor() { _class6.prototype.__init
   async executeRecovery(stepName) {
     const action = this.actions.get(stepName);
     if (!action) {
-      throw noRecoveryAction(stepName);
+      throw _chunkOAJWPPYGcjs.noRecoveryAction.call(void 0, stepName);
     }
     if (action.type === "manual") {
       await action.handler();
@@ -2657,7 +2557,7 @@ var FluxEngine = class {
   async execute(workflow, input) {
     const definition = resolveDefinition(workflow);
     if (definition.validateInput && !definition.validateInput(input)) {
-      throw invalidInput(definition.name);
+      throw _chunkOAJWPPYGcjs.invalidInput.call(void 0, definition.name);
     }
     let ctx = this.contextManager.create(
       definition.name,
@@ -2701,10 +2601,10 @@ var FluxEngine = class {
       if (!state) {
         return null;
       }
-      throw workflowNameMismatch(definition.name, state.name);
+      throw _chunkOAJWPPYGcjs.workflowNameMismatch.call(void 0, definition.name, state.name);
     }
     if (state.history.length !== definition.steps.length) {
-      throw workflowDefinitionChanged();
+      throw _chunkOAJWPPYGcjs.workflowDefinitionChanged.call(void 0, );
     }
     if (state.definitionVersion && definition.version && state.definitionVersion !== definition.version) {
       _optionalChain([this, 'access', _109 => _109.config, 'access', _110 => _110.logger, 'optionalAccess', _111 => _111.warn, 'call', _112 => _112(
@@ -2724,10 +2624,10 @@ var FluxEngine = class {
     const definition = resolveDefinition(workflow);
     const state = await this.storage.load(workflowId);
     if (!state) {
-      throw workflowNotFound(workflowId);
+      throw _chunkOAJWPPYGcjs.workflowNotFound.call(void 0, workflowId);
     }
     if (state.status !== "suspended") {
-      throw workflowNotSuspended(state.status);
+      throw _chunkOAJWPPYGcjs.workflowNotSuspended.call(void 0, state.status);
     }
     let ctx = this.contextManager.restore(
       state
@@ -2736,7 +2636,7 @@ var FluxEngine = class {
     const exec = ctx.history[idx];
     if (!exec || exec.status !== "suspended" || exec.waitingFor !== signalName) {
       const isSuspended = _optionalChain([exec, 'optionalAccess', _114 => _114.status]) === "suspended";
-      throw new FluxError(
+      throw new (0, _chunkOAJWPPYGcjs.FluxError)(
         isSuspended ? `Workflow waiting for signal "${exec.waitingFor}", received "${signalName}"` : "Workflow state invalid: no suspended step found",
         isSuspended ? "INVALID_STATE_TRANSITION" /* INVALID_STATE_TRANSITION */ : "STEP_NOT_FOUND" /* STEP_NOT_FOUND */
       );
@@ -2770,10 +2670,10 @@ var FluxEngine = class {
       if (!state) {
         return null;
       }
-      throw workflowNameMismatch(definition.name, state.name);
+      throw _chunkOAJWPPYGcjs.workflowNameMismatch.call(void 0, definition.name, state.name);
     }
     if (state.history.length !== definition.steps.length) {
-      throw workflowDefinitionChanged();
+      throw _chunkOAJWPPYGcjs.workflowDefinitionChanged.call(void 0, );
     }
     let ctx = this.contextManager.restore(
       state
@@ -2796,7 +2696,7 @@ var FluxEngine = class {
   async saveState(state) {
     const stored = await this.storage.load(state.id);
     if (stored && stored.version !== state.version) {
-      throw new FluxError(
+      throw new (0, _chunkOAJWPPYGcjs.FluxError)(
         "Concurrent modification detected",
         "CONCURRENT_MODIFICATION" /* CONCURRENT_MODIFICATION */
       );
@@ -3096,8 +2996,10 @@ var PostgreSQLStorage = (_class7 = class {
 }, _class7);
 function validateSqlIdentifier(value, field) {
   if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
-    throw new Error(
-      `Invalid ${field}: "${value}". Only letters, numbers, and underscores are allowed.`
+    throw new (0, _chunkOAJWPPYGcjs.FluxError)(
+      `Invalid ${field}: "${value}". Only letters, numbers, and underscores are allowed.`,
+      "WORKFLOW_INVALID_INPUT" /* WORKFLOW_INVALID_INPUT */,
+      { field, value }
     );
   }
   return value;
@@ -3484,7 +3386,7 @@ var OrbitFlux = class _OrbitFlux {
     if (typeof storage === "string") {
       switch (storage) {
         case "sqlite":
-          storageAdapter = new (0, _chunkZE2RDS47cjs.BunSQLiteStorage)({ path: dbPath });
+          storageAdapter = new (0, _chunkOAJWPPYGcjs.BunSQLiteStorage)({ path: dbPath });
           break;
         default:
           storageAdapter = new MemoryStorage();
@@ -3523,6 +3425,16 @@ var OrbitFlux = class _OrbitFlux {
     };
     this.engine = new FluxEngine(engineConfig);
     core.container.instance(exposeAs, this.engine);
+    const health = core.container.make("health");
+    if (health) {
+      const engine = this.engine;
+      health.register("flux", async () => ({
+        status: engine ? "healthy" : "unhealthy",
+        details: {
+          storage: typeof storage === "string" ? storage : "custom"
+        }
+      }));
+    }
     core.logger.info(
       `[OrbitFlux] Initialized (Storage: ${typeof storage === "string" ? storage : "custom"})`
     );
@@ -3566,21 +3478,5 @@ var OrbitFlux = class _OrbitFlux {
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.FluxErrorCode = FluxErrorCode; exports.FluxError = FluxError; exports.workflowNotFound = workflowNotFound; exports.invalidStateTransition = invalidStateTransition; exports.invalidInput = invalidInput; exports.workflowNameMismatch = workflowNameMismatch; exports.workflowDefinitionChanged = workflowDefinitionChanged; exports.workflowNotSuspended = workflowNotSuspended; exports.stepNotFound = stepNotFound; exports.invalidStepIndex = invalidStepIndex; exports.emptyWorkflow = emptyWorkflow; exports.noRecoveryAction = noRecoveryAction; exports.invalidJsonPointer = invalidJsonPointer; exports.invalidPathTraversal = invalidPathTraversal; exports.cannotReplaceRoot = cannotReplaceRoot; exports.cannotRemoveRoot = cannotRemoveRoot; exports.WorkflowBuilder = WorkflowBuilder; exports.createWorkflow = createWorkflow; exports.BatchExecutor = BatchExecutor; exports.ContextManager = ContextManager; exports.StateMachine = StateMachine; exports.CronTrigger = CronTrigger; exports.MemoryStorage = MemoryStorage; exports.StepExecutor = StepExecutor; exports.FluxEngine = FluxEngine; exports.PostgreSQLStorage = PostgreSQLStorage; exports.JsonFileTraceSink = JsonFileTraceSink; exports.MemoryLockProvider = MemoryLockProvider; exports.RedisLockProvider = RedisLockProvider; exports.FluxConsoleLogger = FluxConsoleLogger; exports.FluxSilentLogger = FluxSilentLogger; exports.OrbitFlux = OrbitFlux;
-//# sourceMappingURL=chunk-DN7SIQ34.cjs.map
+exports.WorkflowBuilder = WorkflowBuilder; exports.createWorkflow = createWorkflow; exports.BatchExecutor = BatchExecutor; exports.ContextManager = ContextManager; exports.StateMachine = StateMachine; exports.CronTrigger = CronTrigger; exports.MemoryStorage = MemoryStorage; exports.StepExecutor = StepExecutor; exports.FluxEngine = FluxEngine; exports.PostgreSQLStorage = PostgreSQLStorage; exports.JsonFileTraceSink = JsonFileTraceSink; exports.MemoryLockProvider = MemoryLockProvider; exports.RedisLockProvider = RedisLockProvider; exports.FluxConsoleLogger = FluxConsoleLogger; exports.FluxSilentLogger = FluxSilentLogger; exports.OrbitFlux = OrbitFlux;
+//# sourceMappingURL=chunk-AVWZYY7U.cjs.map