@ironflow/core 0.1.0-test.2

package/README.md

@@ -0,0 +1,60 @@
+# @ironflow/core
+
+Shared types, schemas, constants, and utilities for the Ironflow JavaScript SDK.
+
+> **Note:** You typically don't need to install this package directly. It's automatically included as a dependency of `@ironflow/browser` and `@ironflow/node`.
+
+## Installation
+
+```bash
+npm install @ironflow/core
+```
+
+## Quick Start
+
+### Types
+
+```typescript
+import type { IronflowEvent, Run, Step, FunctionConfig, Logger } from '@ironflow/core';
+```
+
+### Schemas (Zod)
+
+```typescript
+import { EventSchema, RunSchema } from '@ironflow/core';
+
+const event = EventSchema.parse(rawData);
+```
+
+### Constants
+
+```typescript
+import { DEFAULT_SERVER_URL, STEP_STATUS, RUN_STATUS } from '@ironflow/core';
+```
+
+### Error Classes
+
+```typescript
+import { IronflowError, ConnectionError, isRetryable } from '@ironflow/core';
+
+if (isRetryable(error)) {
+  // Safe to retry
+}
+```
+
+### Utilities
+
+```typescript
+import { generateId, createLogger } from '@ironflow/core';
+
+const runId = generateId('run');   // 'run_abc123...'
+const logger = createLogger({ prefix: '[myapp]' });
+```
+
+## Documentation
+
+For the full API reference, see the [Core Package Documentation](https://ironflow.dev/docs/api-reference/js-sdk/core).
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Default configuration constants for Ironflow SDK.
+ */
+/** Default HTTP server port for Ironflow. */
+export declare const DEFAULT_PORT = 9123;
+/** Default host for Ironflow. */
+export declare const DEFAULT_HOST = "localhost";
+/** Default server URL for Ironflow. */
+export declare const DEFAULT_SERVER_URL = "http://localhost:9123";
+/** Default WebSocket URL for Ironflow. */
+export declare const DEFAULT_WS_URL = "ws://localhost:9123/ws";
+/** Environment variable names */
+export declare const ENV_VARS: {
+    /** Environment variable for server URL. */
+    readonly SERVER_URL: "IRONFLOW_SERVER_URL";
+    /** Environment variable for signing key. */
+    readonly SIGNING_KEY: "IRONFLOW_SIGNING_KEY";
+    /** Environment variable for API key. */
+    readonly API_KEY: "IRONFLOW_API_KEY";
+    /** Environment variable for log level (debug, info, warn, error, silent). */
+    readonly LOG_LEVEL: "IRONFLOW_LOG_LEVEL";
+};
+/** Default timeout values in milliseconds */
+export declare const DEFAULT_TIMEOUTS: {
+    /** Default client timeout (30 seconds). */
+    readonly CLIENT: 30000;
+    /** Default function timeout (10 minutes). */
+    readonly FUNCTION: 600000;
+    /** Default trigger sync timeout (30 seconds). */
+    readonly TRIGGER_SYNC: 30000;
+};
+/** Default retry configuration for function steps */
+export declare const DEFAULT_RETRY: {
+    /** Default maximum retry attempts. */
+    readonly MAX_ATTEMPTS: 3;
+    /** Default initial delay in milliseconds. */
+    readonly INITIAL_DELAY_MS: 1000;
+    /** Default backoff factor. */
+    readonly BACKOFF_FACTOR: 2;
+    /** Default maximum delay in milliseconds (5 minutes). */
+    readonly MAX_DELAY_MS: 300000;
+};
+/** Default client retry configuration for HTTP requests */
+export declare const DEFAULT_CLIENT_RETRY: {
+    /** Default maximum retry attempts. */
+    readonly MAX_ATTEMPTS: 3;
+    /** Default initial delay in milliseconds for server errors. */
+    readonly INITIAL_DELAY_MS: 100;
+    /** Default backoff factor for server errors. */
+    readonly BACKOFF_MULTIPLIER: 2;
+    /** Default maximum delay in milliseconds (10 seconds). */
+    readonly MAX_DELAY_MS: 10000;
+    /** Default fixed delay for connection errors in milliseconds (2 seconds). */
+    readonly CONNECTION_RETRY_DELAY_MS: 2000;
+};
+/** Default worker configuration */
+export declare const DEFAULT_WORKER: {
+    /** Default maximum concurrent jobs. */
+    readonly MAX_CONCURRENT_JOBS: 10;
+    /** Default heartbeat interval in milliseconds (30 seconds). */
+    readonly HEARTBEAT_INTERVAL_MS: 30000;
+    /** Default reconnect delay in milliseconds (5 seconds). */
+    readonly RECONNECT_DELAY_MS: 5000;
+};
+/** Default reconnection configuration */
+export declare const DEFAULT_RECONNECT: {
+    /** Whether auto-reconnect is enabled by default. */
+    readonly ENABLED: true;
+    /** Maximum reconnection attempts (-1 for infinite). */
+    readonly MAX_ATTEMPTS: 10;
+    /** Initial backoff delay in milliseconds. */
+    readonly INITIAL_DELAY_MS: 1000;
+    /** Maximum backoff delay in milliseconds. */
+    readonly MAX_DELAY_MS: 30000;
+    /** Backoff multiplier. */
+    readonly MULTIPLIER: 2;
+};
+/**
+ * Get the server URL from environment variable or return the default.
+ * Works in both Node.js and browser environments.
+ */
+export declare function getServerUrl(): string;
+/**
+ * Get the WebSocket URL from environment variable or return the default.
+ * Converts HTTP URLs to WebSocket URLs.
+ */
+export declare function getWebSocketUrl(serverUrl?: string): string;
+/** Step types for workflow execution */
+export declare const STEP_TYPES: {
+    /** Invoke a sub-function or external call */
+    readonly INVOKE: "invoke";
+    /** Sleep/pause execution for a duration */
+    readonly SLEEP: "sleep";
+    /** Wait for an external event */
+    readonly WAIT_FOR_EVENT: "wait_for_event";
+};
+/** Step status values */
+export declare const STEP_STATUS: {
+    /** Step completed successfully */
+    readonly COMPLETED: "completed";
+    /** Step failed with an error */
+    readonly FAILED: "failed";
+    /** Step is waiting (for sleep or event) */
+    readonly WAITING: "waiting";
+};
+/** Run status values */
+export declare const RUN_STATUS: {
+    /** Run is pending execution */
+    readonly PENDING: "pending";
+    /** Run is currently executing */
+    readonly RUNNING: "running";
+    /** Run completed successfully */
+    readonly COMPLETED: "completed";
+    /** Run failed with an error */
+    readonly FAILED: "failed";
+    /** Run was cancelled */
+    readonly CANCELLED: "cancelled";
+    /** Run is paused (waiting for event or sleep) */
+    readonly PAUSED: "paused";
+};
+/** WebSocket message types for pub/sub */
+export declare const WS_MESSAGE_TYPES: {
+    /** Subscribe to a pattern */
+    readonly SUBSCRIBE: "subscribe";
+    /** Unsubscribe from a pattern */
+    readonly UNSUBSCRIBE: "unsubscribe";
+    /** Acknowledge message receipt */
+    readonly ACK: "ack";
+    /** Event message from server */
+    readonly EVENT: "event";
+    /** Subscription result/confirmation */
+    readonly SUBSCRIPTION_RESULT: "subscription_result";
+    /** Subscription error */
+    readonly SUBSCRIPTION_ERROR: "subscription_error";
+    /** General error */
+    readonly ERROR: "error";
+};
+/** HTTP headers */
+export declare const HTTP_HEADERS: {
+    /** Content-Type for JSON */
+    readonly CONTENT_TYPE_JSON: "application/json";
+};
+/** JSON headers for fetch requests */
+export declare const JSON_HEADERS: {
+    readonly "Content-Type": "application/json";
+};
+/** Error codes returned by the SDK */
+export declare const ERROR_CODES: {
+    /** Function not found in registry */
+    readonly FUNCTION_NOT_FOUND: "FUNCTION_NOT_FOUND";
+    /** Validation error in request */
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /** Invalid webhook signature */
+    readonly SIGNATURE_INVALID: "SIGNATURE_INVALID";
+    /** Network/connection error */
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    /** Server error (5xx) */
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    /** Timeout error */
+    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
+    /** Connection lost */
+    readonly CONNECTION_LOST: "CONNECTION_LOST";
+    /** Connection refused */
+    readonly CONNECTION_REFUSED: "CONNECTION_REFUSED";
+    /** Subscription error */
+    readonly SUBSCRIPTION_ERROR: "SUBSCRIPTION_ERROR";
+    /** Not configured */
+    readonly NOT_CONFIGURED: "NOT_CONFIGURED";
+};
+/** ConnectRPC API endpoints */
+export declare const API_ENDPOINTS: {
+    /** Trigger a function */
+    readonly TRIGGER: "/ironflow.v1.IronflowService/Trigger";
+    /** Trigger a function synchronously */
+    readonly TRIGGER_SYNC: "/ironflow.v1.IronflowService/TriggerSync";
+    /** Get a specific run */
+    readonly GET_RUN: "/ironflow.v1.IronflowService/GetRun";
+    /** List runs */
+    readonly LIST_RUNS: "/ironflow.v1.IronflowService/ListRuns";
+    /** Cancel a run */
+    readonly CANCEL_RUN: "/ironflow.v1.IronflowService/CancelRun";
+    /** Retry a run */
+    readonly RETRY_RUN: "/ironflow.v1.IronflowService/RetryRun";
+    /** Register a function */
+    readonly REGISTER_FUNCTION: "/ironflow.v1.IronflowService/RegisterFunction";
+    /** Health check */
+    readonly HEALTH: "/ironflow.v1.IronflowService/Health";
+    /** Emit an event */
+    readonly EMIT: "/ironflow.v1.PubSubService/Emit";
+    /** Create a consumer group */
+    readonly CREATE_CONSUMER_GROUP: "/ironflow.v1.PubSubService/CreateConsumerGroup";
+    /** Get a consumer group */
+    readonly GET_CONSUMER_GROUP: "/ironflow.v1.PubSubService/GetConsumerGroup";
+    /** List consumer groups */
+    readonly LIST_CONSUMER_GROUPS: "/ironflow.v1.PubSubService/ListConsumerGroups";
+    /** Delete a consumer group */
+    readonly DELETE_CONSUMER_GROUP: "/ironflow.v1.PubSubService/DeleteConsumerGroup";
+};
+/** Timing constants */
+export declare const TIMING: {
+    /** Default poll interval in milliseconds */
+    readonly POLL_INTERVAL_MS: 1000;
+    /** Error retry delay in milliseconds */
+    readonly ERROR_RETRY_DELAY_MS: 5000;
+    /** Default reconnect delay in milliseconds */
+    readonly RECONNECT_DELAY_MS: 1000;
+    /** WebSocket normal close code */
+    readonly WS_CLOSE_NORMAL: 1000;
+};
+/** Ack types for message acknowledgment */
+export declare const ACK_TYPES: {
+    /** Positive acknowledgment */
+    readonly ACK: "ack";
+    /** Negative acknowledgment (retry) */
+    readonly NAK: "nak";
+    /** Terminal acknowledgment (no retry) */
+    readonly TERM: "term";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/constants.js

@@ -0,0 +1,233 @@
+/**
+ * Default configuration constants for Ironflow SDK.
+ */
+/** Default HTTP server port for Ironflow. */
+export const DEFAULT_PORT = 9123;
+/** Default host for Ironflow. */
+export const DEFAULT_HOST = "localhost";
+/** Default server URL for Ironflow. */
+export const DEFAULT_SERVER_URL = `http://${DEFAULT_HOST}:${DEFAULT_PORT}`;
+/** Default WebSocket URL for Ironflow. */
+export const DEFAULT_WS_URL = `ws://${DEFAULT_HOST}:${DEFAULT_PORT}/ws`;
+/** Environment variable names */
+export const ENV_VARS = {
+    /** Environment variable for server URL. */
+    SERVER_URL: "IRONFLOW_SERVER_URL",
+    /** Environment variable for signing key. */
+    SIGNING_KEY: "IRONFLOW_SIGNING_KEY",
+    /** Environment variable for API key. */
+    API_KEY: "IRONFLOW_API_KEY",
+    /** Environment variable for log level (debug, info, warn, error, silent). */
+    LOG_LEVEL: "IRONFLOW_LOG_LEVEL",
+};
+/** Default timeout values in milliseconds */
+export const DEFAULT_TIMEOUTS = {
+    /** Default client timeout (30 seconds). */
+    CLIENT: 30_000,
+    /** Default function timeout (10 minutes). */
+    FUNCTION: 600_000,
+    /** Default trigger sync timeout (30 seconds). */
+    TRIGGER_SYNC: 30_000,
+};
+/** Default retry configuration for function steps */
+export const DEFAULT_RETRY = {
+    /** Default maximum retry attempts. */
+    MAX_ATTEMPTS: 3,
+    /** Default initial delay in milliseconds. */
+    INITIAL_DELAY_MS: 1000,
+    /** Default backoff factor. */
+    BACKOFF_FACTOR: 2.0,
+    /** Default maximum delay in milliseconds (5 minutes). */
+    MAX_DELAY_MS: 300_000,
+};
+/** Default client retry configuration for HTTP requests */
+export const DEFAULT_CLIENT_RETRY = {
+    /** Default maximum retry attempts. */
+    MAX_ATTEMPTS: 3,
+    /** Default initial delay in milliseconds for server errors. */
+    INITIAL_DELAY_MS: 100,
+    /** Default backoff factor for server errors. */
+    BACKOFF_MULTIPLIER: 2.0,
+    /** Default maximum delay in milliseconds (10 seconds). */
+    MAX_DELAY_MS: 10_000,
+    /** Default fixed delay for connection errors in milliseconds (2 seconds). */
+    CONNECTION_RETRY_DELAY_MS: 2_000,
+};
+/** Default worker configuration */
+export const DEFAULT_WORKER = {
+    /** Default maximum concurrent jobs. */
+    MAX_CONCURRENT_JOBS: 10,
+    /** Default heartbeat interval in milliseconds (30 seconds). */
+    HEARTBEAT_INTERVAL_MS: 30_000,
+    /** Default reconnect delay in milliseconds (5 seconds). */
+    RECONNECT_DELAY_MS: 5_000,
+};
+/** Default reconnection configuration */
+export const DEFAULT_RECONNECT = {
+    /** Whether auto-reconnect is enabled by default. */
+    ENABLED: true,
+    /** Maximum reconnection attempts (-1 for infinite). */
+    MAX_ATTEMPTS: 10,
+    /** Initial backoff delay in milliseconds. */
+    INITIAL_DELAY_MS: 1_000,
+    /** Maximum backoff delay in milliseconds. */
+    MAX_DELAY_MS: 30_000,
+    /** Backoff multiplier. */
+    MULTIPLIER: 2,
+};
+/**
+ * Get the server URL from environment variable or return the default.
+ * Works in both Node.js and browser environments.
+ */
+export function getServerUrl() {
+    if (typeof process !== "undefined" && process.env?.[ENV_VARS.SERVER_URL]) {
+        return process.env[ENV_VARS.SERVER_URL];
+    }
+    return DEFAULT_SERVER_URL;
+}
+/**
+ * Get the WebSocket URL from environment variable or return the default.
+ * Converts HTTP URLs to WebSocket URLs.
+ */
+export function getWebSocketUrl(serverUrl) {
+    const url = serverUrl || getServerUrl();
+    if (url.startsWith("https://")) {
+        return url.replace("https://", "wss://") + "/ws";
+    }
+    if (url.startsWith("http://")) {
+        return url.replace("http://", "ws://") + "/ws";
+    }
+    return url + "/ws";
+}
+/** Step types for workflow execution */
+export const STEP_TYPES = {
+    /** Invoke a sub-function or external call */
+    INVOKE: "invoke",
+    /** Sleep/pause execution for a duration */
+    SLEEP: "sleep",
+    /** Wait for an external event */
+    WAIT_FOR_EVENT: "wait_for_event",
+};
+/** Step status values */
+export const STEP_STATUS = {
+    /** Step completed successfully */
+    COMPLETED: "completed",
+    /** Step failed with an error */
+    FAILED: "failed",
+    /** Step is waiting (for sleep or event) */
+    WAITING: "waiting",
+};
+/** Run status values */
+export const RUN_STATUS = {
+    /** Run is pending execution */
+    PENDING: "pending",
+    /** Run is currently executing */
+    RUNNING: "running",
+    /** Run completed successfully */
+    COMPLETED: "completed",
+    /** Run failed with an error */
+    FAILED: "failed",
+    /** Run was cancelled */
+    CANCELLED: "cancelled",
+    /** Run is paused (waiting for event or sleep) */
+    PAUSED: "paused",
+};
+/** WebSocket message types for pub/sub */
+export const WS_MESSAGE_TYPES = {
+    /** Subscribe to a pattern */
+    SUBSCRIBE: "subscribe",
+    /** Unsubscribe from a pattern */
+    UNSUBSCRIBE: "unsubscribe",
+    /** Acknowledge message receipt */
+    ACK: "ack",
+    /** Event message from server */
+    EVENT: "event",
+    /** Subscription result/confirmation */
+    SUBSCRIPTION_RESULT: "subscription_result",
+    /** Subscription error */
+    SUBSCRIPTION_ERROR: "subscription_error",
+    /** General error */
+    ERROR: "error",
+};
+/** HTTP headers */
+export const HTTP_HEADERS = {
+    /** Content-Type for JSON */
+    CONTENT_TYPE_JSON: "application/json",
+};
+/** JSON headers for fetch requests */
+export const JSON_HEADERS = {
+    "Content-Type": HTTP_HEADERS.CONTENT_TYPE_JSON,
+};
+/** Error codes returned by the SDK */
+export const ERROR_CODES = {
+    /** Function not found in registry */
+    FUNCTION_NOT_FOUND: "FUNCTION_NOT_FOUND",
+    /** Validation error in request */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** Invalid webhook signature */
+    SIGNATURE_INVALID: "SIGNATURE_INVALID",
+    /** Network/connection error */
+    NETWORK_ERROR: "NETWORK_ERROR",
+    /** Server error (5xx) */
+    SERVER_ERROR: "SERVER_ERROR",
+    /** Timeout error */
+    TIMEOUT_ERROR: "TIMEOUT_ERROR",
+    /** Connection lost */
+    CONNECTION_LOST: "CONNECTION_LOST",
+    /** Connection refused */
+    CONNECTION_REFUSED: "CONNECTION_REFUSED",
+    /** Subscription error */
+    SUBSCRIPTION_ERROR: "SUBSCRIPTION_ERROR",
+    /** Not configured */
+    NOT_CONFIGURED: "NOT_CONFIGURED",
+};
+/** ConnectRPC API endpoints */
+export const API_ENDPOINTS = {
+    /** Trigger a function */
+    TRIGGER: "/ironflow.v1.IronflowService/Trigger",
+    /** Trigger a function synchronously */
+    TRIGGER_SYNC: "/ironflow.v1.IronflowService/TriggerSync",
+    /** Get a specific run */
+    GET_RUN: "/ironflow.v1.IronflowService/GetRun",
+    /** List runs */
+    LIST_RUNS: "/ironflow.v1.IronflowService/ListRuns",
+    /** Cancel a run */
+    CANCEL_RUN: "/ironflow.v1.IronflowService/CancelRun",
+    /** Retry a run */
+    RETRY_RUN: "/ironflow.v1.IronflowService/RetryRun",
+    /** Register a function */
+    REGISTER_FUNCTION: "/ironflow.v1.IronflowService/RegisterFunction",
+    /** Health check */
+    HEALTH: "/ironflow.v1.IronflowService/Health",
+    /** Emit an event */
+    EMIT: "/ironflow.v1.PubSubService/Emit",
+    /** Create a consumer group */
+    CREATE_CONSUMER_GROUP: "/ironflow.v1.PubSubService/CreateConsumerGroup",
+    /** Get a consumer group */
+    GET_CONSUMER_GROUP: "/ironflow.v1.PubSubService/GetConsumerGroup",
+    /** List consumer groups */
+    LIST_CONSUMER_GROUPS: "/ironflow.v1.PubSubService/ListConsumerGroups",
+    /** Delete a consumer group */
+    DELETE_CONSUMER_GROUP: "/ironflow.v1.PubSubService/DeleteConsumerGroup",
+};
+/** Timing constants */
+export const TIMING = {
+    /** Default poll interval in milliseconds */
+    POLL_INTERVAL_MS: 1000,
+    /** Error retry delay in milliseconds */
+    ERROR_RETRY_DELAY_MS: 5000,
+    /** Default reconnect delay in milliseconds */
+    RECONNECT_DELAY_MS: 1000,
+    /** WebSocket normal close code */
+    WS_CLOSE_NORMAL: 1000,
+};
+/** Ack types for message acknowledgment */
+export const ACK_TYPES = {
+    /** Positive acknowledgment */
+    ACK: "ack",
+    /** Negative acknowledgment (retry) */
+    NAK: "nak",
+    /** Terminal acknowledgment (no retry) */
+    TERM: "term",
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Ironflow SDK Error Classes
+ *
+ * Provides a hierarchy of error types for different failure scenarios.
+ */
+/**
+ * Base error class for all Ironflow errors
+ */
+export declare class IronflowError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** Whether this error is retryable */
+    readonly retryable: boolean;
+    /** Additional error details */
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        code?: string;
+        retryable?: boolean;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a connection is lost
+ */
+export declare class ConnectionError extends IronflowError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a subscription fails
+ */
+export declare class SubscriptionError extends IronflowError {
+    /** The subscription ID that failed */
+    readonly subscriptionId?: string;
+    constructor(message: string, options?: {
+        subscriptionId?: string;
+        code?: string;
+        retryable?: boolean;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a request times out
+ */
+export declare class TimeoutError extends IronflowError {
+    /** The timeout duration in milliseconds */
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when validation fails
+ */
+export declare class ValidationError extends IronflowError {
+    /** The validation errors */
+    readonly validationErrors?: string[];
+    constructor(message: string, options?: {
+        validationErrors?: string[];
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when schema validation fails
+ */
+export declare class SchemaValidationError extends ValidationError {
+    constructor(message: string, options?: {
+        validationErrors?: string[];
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a signature is invalid
+ */
+export declare class SignatureError extends IronflowError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a function is not found
+ */
+export declare class FunctionNotFoundError extends IronflowError {
+    /** The function ID that was not found */
+    readonly functionId: string;
+    constructor(functionId: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a run is not found
+ */
+export declare class RunNotFoundError extends IronflowError {
+    /** The run ID that was not found */
+    readonly runId: string;
+    constructor(runId: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when a step fails
+ */
+export declare class StepError extends IronflowError {
+    /** The step ID that failed */
+    readonly stepId: string;
+    /** The step name that failed */
+    readonly stepName: string;
+    constructor(message: string, options: {
+        stepId: string;
+        stepName: string;
+        retryable?: boolean;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown for non-retryable failures
+ */
+export declare class NonRetryableError extends IronflowError {
+    constructor(message: string, options?: {
+        code?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when the client is not configured
+ */
+export declare class NotConfiguredError extends IronflowError {
+    constructor(message?: string);
+}
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryable(error: unknown): boolean;
+/**
+ * Type guard to check if an error is an IronflowError
+ */
+export declare function isIronflowError(error: unknown): error is IronflowError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAQJ;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAQzD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,sCAAsC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;gBAG/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAUJ;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAS5E;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,4BAA4B;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAStF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAItF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAQzD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAU5D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAUvD;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAYJ;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAQxE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,GAAE,MAAyD;CAO/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}