@kylebegeman/pulse 0.3.0

package/dist/schema/tables.js

@@ -0,0 +1,123 @@
+const VALID_PREFIX = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function validatePrefix(prefix) {
+    if (!VALID_PREFIX.test(prefix)) {
+        throw new Error(`Invalid table prefix "${prefix}": must contain only letters, digits, and underscores, and start with a letter or underscore`);
+    }
+}
+export function getTableNames(prefix) {
+    validatePrefix(prefix);
+    return {
+        triggers: `${prefix}triggers`,
+        workflowDefinitions: `${prefix}workflow_definitions`,
+        workflowRuns: `${prefix}workflow_runs`,
+        workflowStepRuns: `${prefix}workflow_step_runs`,
+        executionLogs: `${prefix}execution_logs`,
+    };
+}
+export function getMigrationSQL(prefix) {
+    validatePrefix(prefix);
+    const t = getTableNames(prefix);
+    return `
+    CREATE TABLE IF NOT EXISTS ${t.triggers} (
+      id TEXT PRIMARY KEY,
+      tenant_id TEXT NOT NULL,
+      source TEXT NOT NULL,
+      type TEXT NOT NULL,
+      resource_type TEXT,
+      resource_id TEXT,
+      environment TEXT,
+      payload JSONB DEFAULT '{}',
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${t.triggers}_tenant_type
+      ON ${t.triggers} (tenant_id, type);
+
+    CREATE INDEX IF NOT EXISTS idx_${t.triggers}_created
+      ON ${t.triggers} (created_at);
+
+    CREATE TABLE IF NOT EXISTS ${t.workflowDefinitions} (
+      id TEXT PRIMARY KEY,
+      tenant_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      description TEXT,
+      trigger_type TEXT NOT NULL,
+      environment_filter TEXT,
+      resource_type_filter TEXT,
+      steps JSONB NOT NULL DEFAULT '[]',
+      config JSONB NOT NULL DEFAULT '{}',
+      is_enabled BOOLEAN NOT NULL DEFAULT true,
+      cron_expression TEXT,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${t.workflowDefinitions}_tenant_trigger
+      ON ${t.workflowDefinitions} (tenant_id, trigger_type, is_enabled);
+
+    CREATE TABLE IF NOT EXISTS ${t.workflowRuns} (
+      id TEXT PRIMARY KEY,
+      definition_id TEXT NOT NULL REFERENCES ${t.workflowDefinitions}(id),
+      tenant_id TEXT NOT NULL,
+      trigger_id TEXT NOT NULL REFERENCES ${t.triggers}(id),
+      status TEXT NOT NULL DEFAULT 'pending',
+      context JSONB NOT NULL DEFAULT '{}',
+      current_step_index INTEGER NOT NULL DEFAULT 0,
+      is_replay BOOLEAN NOT NULL DEFAULT false,
+      definition_snapshot JSONB NOT NULL DEFAULT '{}',
+      started_at TIMESTAMPTZ,
+      completed_at TIMESTAMPTZ,
+      failed_at TIMESTAMPTZ,
+      canceled_at TIMESTAMPTZ,
+      cancel_reason TEXT,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${t.workflowRuns}_tenant_status
+      ON ${t.workflowRuns} (tenant_id, status);
+
+    CREATE INDEX IF NOT EXISTS idx_${t.workflowRuns}_trigger
+      ON ${t.workflowRuns} (trigger_id);
+
+    CREATE TABLE IF NOT EXISTS ${t.workflowStepRuns} (
+      id TEXT PRIMARY KEY,
+      run_id TEXT NOT NULL REFERENCES ${t.workflowRuns}(id),
+      tenant_id TEXT NOT NULL,
+      step_index INTEGER NOT NULL,
+      step_type TEXT NOT NULL,
+      step_name TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'pending',
+      scheduled_for TIMESTAMPTZ,
+      started_at TIMESTAMPTZ,
+      completed_at TIMESTAMPTZ,
+      result JSONB,
+      error_message TEXT,
+      branch_index INTEGER,
+      parent_step_run_id TEXT,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${t.workflowStepRuns}_run
+      ON ${t.workflowStepRuns} (run_id, step_index);
+
+    CREATE INDEX IF NOT EXISTS idx_${t.workflowStepRuns}_scheduled
+      ON ${t.workflowStepRuns} (status, scheduled_for)
+      WHERE status = 'scheduled';
+
+    CREATE TABLE IF NOT EXISTS ${t.executionLogs} (
+      id TEXT PRIMARY KEY,
+      run_id TEXT NOT NULL REFERENCES ${t.workflowRuns}(id),
+      step_run_id TEXT REFERENCES ${t.workflowStepRuns}(id),
+      tenant_id TEXT NOT NULL,
+      level TEXT NOT NULL DEFAULT 'info',
+      message TEXT NOT NULL,
+      data JSONB,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_${t.executionLogs}_run
+      ON ${t.executionLogs} (run_id, created_at);
+  `;
+}
+//# sourceMappingURL=tables.js.map

package/dist/schema/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/schema/tables.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAE/C,SAAS,cAAc,CAAC,MAAc;IACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,yBAAyB,MAAM,8FAA8F,CAC9H,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,cAAc,CAAC,MAAM,CAAC,CAAA;IACtB,OAAO;QACL,QAAQ,EAAE,GAAG,MAAM,UAAU;QAC7B,mBAAmB,EAAE,GAAG,MAAM,sBAAsB;QACpD,YAAY,EAAE,GAAG,MAAM,eAAe;QACtC,gBAAgB,EAAE,GAAG,MAAM,oBAAoB;QAC/C,aAAa,EAAE,GAAG,MAAM,gBAAgB;KAChC,CAAA;AACZ,CAAC;AAID,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,cAAc,CAAC,MAAM,CAAC,CAAA;IACtB,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAE/B,OAAO;iCACwB,CAAC,CAAC,QAAQ;;;;;;;;;;;;qCAYN,CAAC,CAAC,QAAQ;WACpC,CAAC,CAAC,QAAQ;;qCAEgB,CAAC,CAAC,QAAQ;WACpC,CAAC,CAAC,QAAQ;;iCAEY,CAAC,CAAC,mBAAmB;;;;;;;;;;;;;;;;qCAgBjB,CAAC,CAAC,mBAAmB;WAC/C,CAAC,CAAC,mBAAmB;;iCAEC,CAAC,CAAC,YAAY;;+CAEA,CAAC,CAAC,mBAAmB;;4CAExB,CAAC,CAAC,QAAQ;;;;;;;;;;;;;;;qCAejB,CAAC,CAAC,YAAY;WACxC,CAAC,CAAC,YAAY;;qCAEY,CAAC,CAAC,YAAY;WACxC,CAAC,CAAC,YAAY;;iCAEQ,CAAC,CAAC,gBAAgB;;wCAEX,CAAC,CAAC,YAAY;;;;;;;;;;;;;;;;qCAgBjB,CAAC,CAAC,gBAAgB;WAC5C,CAAC,CAAC,gBAAgB;;qCAEQ,CAAC,CAAC,gBAAgB;WAC5C,CAAC,CAAC,gBAAgB;;;iCAGI,CAAC,CAAC,aAAa;;wCAER,CAAC,CAAC,YAAY;oCAClB,CAAC,CAAC,gBAAgB;;;;;;;;qCAQjB,CAAC,CAAC,aAAa;WACzC,CAAC,CAAC,aAAa;GACvB,CAAA;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,186 @@
+import type { Pool } from 'pg';
+import type { ZodSchema } from 'zod';
+export interface TriggerInput {
+    tenantId: string;
+    source: string;
+    type: string;
+    resourceType?: string;
+    resourceId?: string;
+    environment?: string;
+    payload?: Record<string, unknown>;
+}
+export interface TriggerEnvelope extends TriggerInput {
+    id: string;
+    createdAt: Date;
+}
+export interface TriggerRegistration {
+    source: string;
+    resourceType?: string;
+    payloadSchema?: ZodSchema;
+}
+export type StepType = 'action' | 'condition' | 'delay' | 'parallel';
+export interface RetryPolicy {
+    maxAttempts: number;
+    backoffMs: number;
+}
+export interface WorkflowStep {
+    type: StepType;
+    name: string;
+    config?: Record<string, unknown>;
+    /** Delay duration in milliseconds (only for 'delay' steps) */
+    delayMs?: number;
+    /** Step execution timeout in milliseconds */
+    timeoutMs?: number;
+    /** Retry policy for failed action steps */
+    retryPolicy?: RetryPolicy;
+    /** Behavior when a condition returns false: 'complete' (default), 'skip' (skip next step), number (skip N steps) */
+    onFalse?: 'complete' | 'skip' | number;
+    /** Parallel branches — each branch is an array of steps executed concurrently (only for 'parallel' steps) */
+    branches?: WorkflowStep[][];
+}
+export interface WorkflowDefinition {
+    id: string;
+    tenantId: string;
+    name: string;
+    description?: string;
+    triggerType: string;
+    environmentFilter?: string;
+    resourceTypeFilter?: string;
+    steps: WorkflowStep[];
+    config: Record<string, unknown>;
+    isEnabled: boolean;
+    cronExpression?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type WorkflowStatus = 'pending' | 'running' | 'waiting' | 'completed' | 'failed' | 'canceled';
+export interface DefinitionSnapshot {
+    steps: WorkflowStep[];
+    config: Record<string, unknown>;
+    triggerType: string;
+}
+export interface WorkflowRun {
+    id: string;
+    definitionId: string;
+    tenantId: string;
+    triggerId: string;
+    status: WorkflowStatus;
+    context: Record<string, unknown>;
+    currentStepIndex: number;
+    isReplay: boolean;
+    definitionSnapshot: DefinitionSnapshot;
+    startedAt?: Date;
+    completedAt?: Date;
+    failedAt?: Date;
+    canceledAt?: Date;
+    cancelReason?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type StepStatus = 'pending' | 'scheduled' | 'running' | 'completed' | 'failed' | 'skipped';
+export interface WorkflowStepRun {
+    id: string;
+    runId: string;
+    tenantId: string;
+    stepIndex: number;
+    stepType: StepType;
+    stepName: string;
+    status: StepStatus;
+    scheduledFor?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    result?: Record<string, unknown>;
+    errorMessage?: string;
+    /** Branch index for parallel step branches (null for top-level steps) */
+    branchIndex?: number;
+    /** Parent step run ID for parallel branch steps */
+    parentStepRunId?: string;
+    createdAt: Date;
+}
+export interface WorkflowContext {
+    tenantId: string;
+    trigger: TriggerEnvelope;
+    run: WorkflowRun;
+    step: WorkflowStepRun;
+    config: Record<string, unknown>;
+    isReplay: boolean;
+    emit: (trigger: TriggerInput) => Promise<TriggerEnvelope>;
+    log: (message: string, data?: Record<string, unknown>) => void;
+}
+export type ActionHandler = (ctx: WorkflowContext) => Promise<ActionResult>;
+export interface ActionResult {
+    success: boolean;
+    data?: Record<string, unknown>;
+    error?: string;
+}
+export type ConditionHandler = (ctx: WorkflowContext) => Promise<boolean>;
+export interface ActionOptions {
+    replaySafe: boolean;
+}
+export type LifecycleHook<T> = (event: T) => void | Promise<void>;
+export interface StepCompleteEvent {
+    run: WorkflowRun;
+    step: WorkflowStepRun;
+}
+export interface RunCompleteEvent {
+    run: WorkflowRun;
+    status: 'completed' | 'failed' | 'canceled';
+}
+export interface EngineConfig {
+    db: Pool;
+    /** ioredis instance or compatible connection */
+    redis: unknown;
+    /** Table prefix (default: 'pulse_') */
+    tablePrefix?: string;
+    /** BullMQ queue prefix (default: 'pulse') */
+    queuePrefix?: string;
+    /** Concurrency for step workers (default: 5) */
+    concurrency?: number;
+    /** Called after each step completes, fails, or is skipped */
+    onStepComplete?: LifecycleHook<StepCompleteEvent>;
+    /** Called when a run reaches completed or failed status */
+    onRunComplete?: LifecycleHook<RunCompleteEvent>;
+}
+export interface EngineInstance {
+    registerTrigger: (type: string, registration: TriggerRegistration) => void;
+    registerAction: (name: string, handler: ActionHandler, options?: ActionOptions) => void;
+    registerCondition: (name: string, handler: ConditionHandler) => void;
+    emit: (trigger: TriggerInput) => Promise<TriggerEnvelope>;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+    getRun: (runId: string) => Promise<WorkflowRun | null>;
+    getRunSteps: (runId: string) => Promise<WorkflowStepRun[]>;
+    getRunsByTrigger: (triggerId: string) => Promise<WorkflowRun[]>;
+    getTrigger: (triggerId: string) => Promise<TriggerEnvelope | null>;
+    getRunTimeline: (runId: string) => Promise<RunTimelineEntry[]>;
+    cancelRun: (runId: string, reason?: string) => Promise<WorkflowRun>;
+    retryRun: (runId: string) => Promise<WorkflowRun>;
+    getFailedRuns: (tenantId?: string) => Promise<WorkflowRun[]>;
+    replay: (triggerId: string, options?: ReplayOptions) => Promise<WorkflowRun[]>;
+    createWorkflow: (definition: Omit<WorkflowDefinition, 'id' | 'createdAt' | 'updatedAt'>) => Promise<WorkflowDefinition>;
+    enableWorkflow: (definitionId: string) => Promise<void>;
+    disableWorkflow: (definitionId: string) => Promise<void>;
+    migrate: () => Promise<void>;
+}
+export interface ReplayOptions {
+    dryRun?: boolean;
+}
+export interface RunTimelineEntry {
+    timestamp: Date;
+    type: 'run_created' | 'step_scheduled' | 'step_started' | 'step_completed' | 'step_failed' | 'step_skipped' | 'run_completed' | 'run_failed' | 'run_canceled' | 'log';
+    stepIndex?: number;
+    stepName?: string;
+    stepType?: string;
+    detail?: Record<string, unknown>;
+}
+export interface ExecutionLog {
+    id: string;
+    runId: string;
+    stepRunId?: string;
+    tenantId: string;
+    level: 'info' | 'warn' | 'error';
+    message: string;
+    data?: Record<string, unknown>;
+    createdAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class PulseError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+export declare class TriggerValidationError extends PulseError {
+    constructor(triggerType: string, details?: Record<string, unknown>);
+}
+export declare class UnregisteredTriggerError extends PulseError {
+    constructor(triggerType: string);
+}
+export declare class UnregisteredActionError extends PulseError {
+    constructor(actionName: string, runId?: string, stepIndex?: number);
+}
+export declare class UnregisteredConditionError extends PulseError {
+    constructor(conditionName: string, runId?: string, stepIndex?: number);
+}
+export declare class WorkflowRunError extends PulseError {
+    constructor(runId: string, message: string);
+}
+export declare class ReplayError extends PulseError {
+    constructor(triggerId: string, message: string);
+}
+export declare class CircularTriggerError extends PulseError {
+    constructor(triggerId: string, depth: number);
+}
+export declare class WorkflowValidationError extends PulseError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IAG1B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFxC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C;AAED,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQnE;AAED,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,WAAW,EAAE,MAAM;CAQhC;AAED,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CASnE;AAED,qBAAa,0BAA2B,SAAQ,UAAU;gBAC5C,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAStE;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AAED,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI/C;AAED,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAQ7C;AAED,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D"}

package/dist/utils/errors.js

@@ -0,0 +1,61 @@
+export class PulseError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'PulseError';
+    }
+}
+export class TriggerValidationError extends PulseError {
+    constructor(triggerType, details) {
+        super(`Trigger validation failed for type "${triggerType}"`, 'TRIGGER_VALIDATION_ERROR', details);
+        this.name = 'TriggerValidationError';
+    }
+}
+export class UnregisteredTriggerError extends PulseError {
+    constructor(triggerType) {
+        super(`No trigger registered for type "${triggerType}"`, 'UNREGISTERED_TRIGGER', { triggerType });
+        this.name = 'UnregisteredTriggerError';
+    }
+}
+export class UnregisteredActionError extends PulseError {
+    constructor(actionName, runId, stepIndex) {
+        const context = runId ? ` (run=${runId}, stepIndex=${stepIndex})` : '';
+        super(`No action registered with name "${actionName}"${context}`, 'UNREGISTERED_ACTION', { actionName, runId, stepIndex });
+        this.name = 'UnregisteredActionError';
+    }
+}
+export class UnregisteredConditionError extends PulseError {
+    constructor(conditionName, runId, stepIndex) {
+        const context = runId ? ` (run=${runId}, stepIndex=${stepIndex})` : '';
+        super(`No condition registered with name "${conditionName}"${context}`, 'UNREGISTERED_CONDITION', { conditionName, runId, stepIndex });
+        this.name = 'UnregisteredConditionError';
+    }
+}
+export class WorkflowRunError extends PulseError {
+    constructor(runId, message) {
+        super(message, 'WORKFLOW_RUN_ERROR', { runId });
+        this.name = 'WorkflowRunError';
+    }
+}
+export class ReplayError extends PulseError {
+    constructor(triggerId, message) {
+        super(message, 'REPLAY_ERROR', { triggerId });
+        this.name = 'ReplayError';
+    }
+}
+export class CircularTriggerError extends PulseError {
+    constructor(triggerId, depth) {
+        super(`Circular trigger detected: emit depth ${depth} exceeds maximum. Trigger "${triggerId}" was emitted from within a handler chain that is too deep.`, 'CIRCULAR_TRIGGER', { triggerId, depth });
+        this.name = 'CircularTriggerError';
+    }
+}
+export class WorkflowValidationError extends PulseError {
+    constructor(message, details) {
+        super(message, 'WORKFLOW_VALIDATION_ERROR', details);
+        this.name = 'WorkflowValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG1B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHP,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,WAAmB,EAAE,OAAiC;QAChE,KAAK,CACH,uCAAuC,WAAW,GAAG,EACrD,0BAA0B,EAC1B,OAAO,CACR,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACtD,YAAY,WAAmB;QAC7B,KAAK,CACH,mCAAmC,WAAW,GAAG,EACjD,sBAAsB,EACtB,EAAE,WAAW,EAAE,CAChB,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAY,UAAkB,EAAE,KAAc,EAAE,SAAkB;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,eAAe,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QACtE,KAAK,CACH,mCAAmC,UAAU,IAAI,OAAO,EAAE,EAC1D,qBAAqB,EACrB,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CACjC,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,UAAU;IACxD,YAAY,aAAqB,EAAE,KAAc,EAAE,SAAkB;QACnE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,eAAe,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QACtE,KAAK,CACH,sCAAsC,aAAa,IAAI,OAAO,EAAE,EAChE,wBAAwB,EACxB,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,CACpC,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,KAAa,EAAE,OAAe;QACxC,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,SAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAY,SAAiB,EAAE,KAAa;QAC1C,KAAK,CACH,yCAAyC,KAAK,8BAA8B,SAAS,6DAA6D,EAClJ,kBAAkB,EAClB,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,2BAA2B,EAAE,OAAO,CAAC,CAAA;QACpD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF"}

package/dist/utils/ids.d.ts

@@ -0,0 +1,2 @@
+export declare function generateId(prefix?: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/utils/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/utils/ids.js

@@ -0,0 +1,6 @@
+import { nanoid } from 'nanoid';
+export function generateId(prefix) {
+    const id = nanoid(21);
+    return prefix ? `${prefix}_${id}` : id;
+}
+//# sourceMappingURL=ids.js.map

package/dist/utils/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IACrB,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kylebegeman/pulse",
+  "version": "0.3.0",
+  "description": "Universal workflow engine — signal-driven automation for multi-tenant applications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "workflow",
+    "engine",
+    "automation",
+    "signals",
+    "multi-tenant",
+    "bullmq"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "bullmq": "^5.0.0",
+    "nanoid": "^5.0.0",
+    "pg": "^8.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}