@pgflow/client 0.0.0-test-snapshot-releases2-8d5d9bc1-20250922101158 → 0.0.0-update-supabase-868977e5-20251119071021

package/CHANGELOG.md

@@ -1,12 +1,80 @@
 # @pgflow/client
 
-## 0.0.0-test-snapshot-releases2-8d5d9bc1-20250922101158
+## 0.0.0-update-supabase-868977e5-20251119071021
+
+### Minor Changes
+
+- 3d8b13b: BREAKING CHANGE: pgflow 0.8.0 requires pgmq 1.5.0+, PostgreSQL 17, and Supabase CLI 2.34.3+
+
+  This version modernizes infrastructure dependencies and will NOT work with pgmq 1.4.x or earlier. The migration includes a compatibility check that aborts with a clear error message if requirements are not met.
+
+  **Requirements:**
+
+  - pgmq 1.5.0 or higher (previously supported 1.4.x)
+  - PostgreSQL 17 (from 15)
+  - Supabase CLI 2.34.3 or higher (includes pgmq 1.5.0+)
+
+  **For Supabase users:** Upgrade your Supabase CLI to 2.34.3+ which includes pgmq 1.5.0 by default.
+
+  **For self-hosted users:** Upgrade pgmq to 1.5.0+ and PostgreSQL to 17 before upgrading pgflow.
+
+  **If you cannot upgrade immediately:** Stay on pgflow 0.7.x until your infrastructure is ready. The migration safety check ensures you cannot accidentally upgrade to an incompatible version.
+
+### Patch Changes
+
+- Updated dependencies [3d8b13b]
+  - @pgflow/core@0.0.0-update-supabase-868977e5-20251119071021
+  - @pgflow/dsl@0.0.0-update-supabase-868977e5-20251119071021
+
+## 0.7.3
+
+### Patch Changes
+
+- bde6bed: Add `realtimeStabilizationDelayMs` option to PgflowClient for improved Supabase Realtime reliability
+  - @pgflow/core@0.7.3
+  - @pgflow/dsl@0.7.3
+
+## 0.7.2
+
+### Patch Changes
+
+- c22a1e5: Fix missing realtime broadcasts for step:started and step:completed events
+
+  **Critical bug fix:** Clients were not receiving `step:started` events when steps transitioned to Started status, and `step:completed` events for empty map steps and cascade completions were also missing.
+
+  **Root cause:** PostgreSQL query optimizer was eliminating CTEs containing `realtime.send()` calls because they were not referenced by subsequent operations or the final RETURN statement.
+
+  **Solution:** Moved `realtime.send()` calls directly into RETURNING clauses of UPDATE statements, ensuring they execute atomically with state changes and cannot be optimized away.
+
+  **Changes:**
+
+  - `start_ready_steps()`: Broadcasts step:started and step:completed events in RETURNING clauses
+  - `cascade_complete_taskless_steps()`: Broadcasts step:completed events atomically with cascade completion
+  - `complete_task()`: Added PERFORM statements for run:failed and step:failed broadcasts
+  - Client: Added `applySnapshot()` methods to FlowRun and FlowStep for proper initial state hydration without event emission
+
+- Updated dependencies [c22a1e5]
+  - @pgflow/core@0.7.2
+  - @pgflow/dsl@0.7.2
+
+## 0.7.1
+
+### Patch Changes
+
+- Updated dependencies [a71b371]
+  - @pgflow/core@0.7.1
+  - @pgflow/dsl@0.7.1
+
+## 0.7.0
 
 ### Patch Changes
 
-- Updated dependencies
-  - @pgflow/core@0.0.0-test-snapshot-releases2-8d5d9bc1-20250922101158
-  - @pgflow/dsl@0.0.0-test-snapshot-releases2-8d5d9bc1-20250922101158
+- Updated dependencies [524db03]
+- Updated dependencies [524db03]
+- Updated dependencies [524db03]
+- Updated dependencies [524db03]
+  - @pgflow/dsl@0.7.0
+  - @pgflow/core@0.7.0
 
 ## 0.6.1
 

package/README.md

@@ -28,6 +28,9 @@ Key features:
 npm install @pgflow/client
 ```
 
+> [!NOTE]
+> Real-time updates use Supabase broadcast channels. Ensure real-time is enabled in your Supabase project.
+
 ## Quick Start
 
 ```typescript
@@ -376,5 +379,6 @@ See [BUILD_AND_RELEASE.md](./BUILD_AND_RELEASE.md#browser-via-cdn) for full CDN
 For more detailed documentation, visit:
 
 - [pgflow Documentation](https://pgflow.dev)
-- [Client Library Guide](https://pgflow.dev/how-to/monitor-flow-execution)
+- [Start Flows from TypeScript Client](https://pgflow.dev/build/starting-flows/typescript-client/)
+- [Client API Reference](https://pgflow.dev/reference/pgflow-client/)
 

package/dist/client/src/browser.d.ts

@@ -0,0 +1,7 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+import { PgflowClient } from './lib/PgflowClient.js';
+export { PgflowClient } from './lib/PgflowClient.js';
+export { FlowRunStatus, FlowStepStatus } from './lib/types.js';
+export * from './lib/types.js';
+export declare function createClient(supabaseClient: SupabaseClient): PgflowClient<import('../../dsl/src/index.ts').AnyFlow>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/client/src/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/D,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,wBAAgB,YAAY,CAAC,cAAc,EAAE,cAAc,+CAE1D"}

package/dist/client/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/types.js';
+export { PgflowClient } from './lib/PgflowClient.js';
+export { FlowRun } from './lib/FlowRun.js';
+export { FlowStep } from './lib/FlowStep.js';
+export type { Unsubscribe } from './lib/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/client/src/lib/FlowRun.d.ts

@@ -0,0 +1,125 @@
+import { FlowStep } from './FlowStep.js';
+import { FlowRunStatus, FlowRunState, FlowRunEvents, Unsubscribe, FlowRunBase, FlowRunEvent, StepEvent } from './types.js';
+import { AnyFlow, ExtractFlowInput, ExtractFlowOutput, ExtractFlowSteps } from '../../../dsl/src/index.ts';
+
+/**
+ * Represents a single execution of a flow
+ */
+export declare class FlowRun<TFlow extends AnyFlow> implements FlowRunBase<FlowRunEvent<TFlow>> {
+    #private;
+    /**
+     * Creates a new FlowRun instance
+     *
+     * @param initialState - Initial state for the run
+     */
+    constructor(initialState: FlowRunState<TFlow>);
+    /**
+     * Get the run ID
+     */
+    get run_id(): string;
+    /**
+     * Get the flow slug
+     */
+    get flow_slug(): string;
+    /**
+     * Get the current status
+     */
+    get status(): FlowRunStatus;
+    /**
+     * Get the started_at timestamp
+     */
+    get started_at(): Date | null;
+    /**
+     * Get the completed_at timestamp
+     */
+    get completed_at(): Date | null;
+    /**
+     * Get the failed_at timestamp
+     */
+    get failed_at(): Date | null;
+    /**
+     * Get the flow input
+     */
+    get input(): ExtractFlowInput<TFlow>;
+    /**
+     * Get the flow output
+     */
+    get output(): ExtractFlowOutput<TFlow> | null;
+    /**
+     * Get the error object
+     */
+    get error(): Error | null;
+    /**
+     * Get the error message
+     */
+    get error_message(): string | null;
+    /**
+     * Get the number of remaining steps
+     */
+    get remaining_steps(): number;
+    /**
+     * Register an event handler for a run event
+     *
+     * @param event - Event type to listen for
+     * @param callback - Callback function to execute when event is emitted
+     * @returns Function to unsubscribe from the event
+     */
+    on<E extends keyof FlowRunEvents<TFlow>>(event: E, callback: FlowRunEvents<TFlow>[E]): Unsubscribe;
+    /**
+     * Get a FlowStep instance for a specific step
+     *
+     * @param stepSlug - Step slug to get
+     * @returns FlowStep instance for the specified step
+     */
+    step<TStepSlug extends keyof ExtractFlowSteps<TFlow> & string>(stepSlug: TStepSlug): FlowStep<TFlow, TStepSlug>;
+    /**
+     * Check if this run has a specific step
+     *
+     * @param stepSlug - Step slug to check
+     * @returns true if the step exists, false otherwise
+     */
+    hasStep(stepSlug: string): boolean;
+    /**
+     * Wait for the run to reach a specific status
+     *
+     * @param targetStatus - The status to wait for
+     * @param options - Optional timeout and abort signal
+     * @returns Promise that resolves with the run instance when the status is reached
+     */
+    waitForStatus(targetStatus: FlowRunStatus.Completed | FlowRunStatus.Failed, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<this>;
+    /**
+     * Apply state from database snapshot (no events emitted)
+     * Used when initializing state from start_flow_with_states() or get_run_with_states()
+     *
+     * @internal This method is only intended for use by PgflowClient.
+     * Applications should not call this directly.
+     */
+    applySnapshot(row: import('../../../core/src/index.ts').RunRow): void;
+    /**
+     * Updates the run state based on an event
+     *
+     * @internal This method is only intended for use by PgflowClient and tests.
+     * Applications should not call this directly - state updates should come from
+     * database events through the PgflowClient.
+     *
+     * TODO: After v1.0, make this method private and refactor tests to use PgflowClient
+     * with event emission instead of direct state manipulation.
+     */
+    updateState(event: FlowRunEvent<TFlow>): boolean;
+    /**
+     * Updates a step state based on an event
+     *
+     * @param stepSlug - Step slug to update
+     * @param event - Event data to update the step with
+     * @returns true if the state was updated, false otherwise
+     */
+    updateStepState<TStepSlug extends keyof ExtractFlowSteps<TFlow> & string>(stepSlug: TStepSlug, event: StepEvent<TFlow, TStepSlug>): boolean;
+    /**
+     * Clean up all resources held by this run
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=FlowRun.d.ts.map

package/dist/client/src/lib/FlowRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowRun.d.ts","sourceRoot":"","sources":["../../../../src/lib/FlowRun.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EAEX,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,qBAAa,OAAO,CAAC,KAAK,SAAS,OAAO,CACxC,YAAW,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;;IAY3C;;;;OAIG;gBACS,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC;IAI7C;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,IAAI,CAE5B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,IAAI,GAAG,IAAI,CAE9B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,GAAG,IAAI,CAE3B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAEnC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAE5C;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,CAAC,KAAK,CAAC,EACrC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAChC,WAAW;IAad;;;;;OAKG;IACH,IAAI,CAAC,SAAS,SAAS,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,EAC3D,QAAQ,EAAE,SAAS,GAClB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IA8B7B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKlC;;;;;;OAMG;IACH,aAAa,CACX,YAAY,EAAE,aAAa,CAAC,SAAS,GAAG,aAAa,CAAC,MAAM,EAC5D,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACrD,OAAO,CAAC,IAAI,CAAC;IA+DhB;;;;;;OAMG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,cAAc,EAAE,MAAM,GAAG,IAAI;IAavD;;;;;;;;;OASG;IACH,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO;IAmFhD;;;;;;OAMG;IACH,eAAe,CAAC,SAAS,SAAS,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,EACtE,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,GACjC,OAAO;IAyDV;;OAEG;IACH,OAAO,IAAI,IAAI;CAgBhB"}

package/dist/client/src/lib/FlowStep.d.ts

@@ -0,0 +1,90 @@
+import { FlowStepStatus, FlowStepState, StepEvents, Unsubscribe, FlowStepBase, StepEvent } from './types.js';
+import { AnyFlow, ExtractFlowSteps, StepOutput } from '../../../dsl/src/index.ts';
+
+/**
+ * Represents a single step in a flow run
+ */
+export declare class FlowStep<TFlow extends AnyFlow, TStepSlug extends keyof ExtractFlowSteps<TFlow> & string> implements FlowStepBase<StepEvent<TFlow, TStepSlug>> {
+    #private;
+    /**
+     * Creates a new FlowStep instance
+     *
+     * @param initialState - Initial state for the step
+     */
+    constructor(initialState: FlowStepState<TFlow, TStepSlug>);
+    /**
+     * Get the run ID this step belongs to
+     */
+    get run_id(): string;
+    /**
+     * Get the step slug
+     */
+    get step_slug(): TStepSlug;
+    /**
+     * Get the current status
+     */
+    get status(): FlowStepStatus;
+    /**
+     * Get the started_at timestamp
+     */
+    get started_at(): Date | null;
+    /**
+     * Get the completed_at timestamp
+     */
+    get completed_at(): Date | null;
+    /**
+     * Get the failed_at timestamp
+     */
+    get failed_at(): Date | null;
+    /**
+     * Get the step output
+     */
+    get output(): StepOutput<TFlow, TStepSlug> | null;
+    /**
+     * Get the error object
+     */
+    get error(): Error | null;
+    /**
+     * Get the error message
+     */
+    get error_message(): string | null;
+    /**
+     * Register an event handler for a step event
+     *
+     * @param event - Event type to listen for
+     * @param callback - Callback function to execute when event is emitted
+     * @returns Function to unsubscribe from the event
+     */
+    on<E extends keyof StepEvents<TFlow, TStepSlug>>(event: E, callback: StepEvents<TFlow, TStepSlug>[E]): Unsubscribe;
+    /**
+     * Wait for the step to reach a specific status
+     *
+     * @param targetStatus - The status to wait for
+     * @param options - Optional timeout and abort signal
+     * @returns Promise that resolves with the step instance when the status is reached
+     */
+    waitForStatus(targetStatus: FlowStepStatus.Started | FlowStepStatus.Completed | FlowStepStatus.Failed, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<this>;
+    /**
+     * Apply state from database snapshot (no events emitted)
+     * Used when initializing state from start_flow_with_states() or get_run_with_states()
+     *
+     * @internal This method is only intended for use by PgflowClient.
+     * Applications should not call this directly.
+     */
+    applySnapshot(row: import('../../../core/src/index.ts').StepStateRow): void;
+    /**
+     * Updates the step state based on an event
+     *
+     * @internal This method is only intended for use by FlowRun and tests.
+     * Applications should not call this directly - state updates should come from
+     * database events through the PgflowClient.
+     *
+     * TODO: After v1.0, make this method private and refactor tests to use PgflowClient
+     * with event emission instead of direct state manipulation.
+     */
+    updateState(event: StepEvent<TFlow, TStepSlug>): boolean;
+}
+//# sourceMappingURL=FlowStep.d.ts.map

package/dist/client/src/lib/FlowStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowStep.d.ts","sourceRoot":"","sources":["../../../../src/lib/FlowStep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,QAAQ,CACnB,KAAK,SAAS,OAAO,EACrB,SAAS,SAAS,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,CACxD,YAAW,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;;IAUpD;;;;OAIG;gBACS,YAAY,EAAE,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;IAIzD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,IAAI,CAE5B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,IAAI,GAAG,IAAI,CAE9B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,GAAG,IAAI,CAE3B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,IAAI,CAEhD;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,EAC7C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GACxC,WAAW;IAId;;;;;;OAMG;IACH,aAAa,CACX,YAAY,EAAE,cAAc,CAAC,OAAO,GAAG,cAAc,CAAC,SAAS,GAAG,cAAc,CAAC,MAAM,EACvF,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACrD,OAAO,CAAC,IAAI,CAAC;IAuDhB;;;;;;OAMG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,cAAc,EAAE,YAAY,GAAG,IAAI;IAW7D;;;;;;;;;OASG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,OAAO;CAgFzD"}

package/dist/client/src/lib/PgflowClient.d.ts

@@ -0,0 +1,76 @@
+import { FlowRun } from './FlowRun.js';
+import { IFlowClient, BroadcastRunEvent, BroadcastStepEvent, Unsubscribe } from './types.js';
+import { AnyFlow, ExtractFlowInput } from '../../../dsl/src/index.ts';
+import { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * Client for interacting with pgflow
+ */
+export declare class PgflowClient<TFlow extends AnyFlow = AnyFlow> implements IFlowClient<TFlow> {
+    #private;
+    /**
+     * Creates a new PgflowClient instance
+     *
+     * @param supabaseClient - Supabase client instance
+     * @param opts - Optional configuration
+     */
+    constructor(supabaseClient: SupabaseClient, opts?: {
+        realtimeStabilizationDelayMs?: number;
+        schedule?: typeof setTimeout;
+    });
+    /**
+     * Start a flow with optional run_id
+     *
+     * @param flow_slug - Flow slug to start
+     * @param input - Input data for the flow
+     * @param run_id - Optional run ID (will be generated if not provided)
+     * @returns Promise that resolves with the FlowRun instance
+     */
+    startFlow<TSpecificFlow extends TFlow>(flow_slug: string, input: ExtractFlowInput<TSpecificFlow>, run_id?: string): Promise<FlowRun<TSpecificFlow>>;
+    /**
+     * Dispose a specific flow run
+     *
+     * @param runId - Run ID to dispose
+     */
+    dispose(runId: string): void;
+    /**
+     * Dispose all flow runs
+     */
+    disposeAll(): void;
+    /**
+     * Fetch flow definition metadata
+     */
+    fetchFlowDefinition(flow_slug: string): Promise<{
+        flow: import('../../../core/src/index.ts').FlowRow;
+        steps: import('../../../core/src/index.ts').StepRow[];
+    }>;
+    /**
+     * Register a callback for run events
+     * @returns Function to unsubscribe from the event
+     */
+    onRunEvent(callback: (event: BroadcastRunEvent) => void): Unsubscribe;
+    /**
+     * Register a callback for step events
+     * @returns Function to unsubscribe from the event
+     */
+    onStepEvent(callback: (event: BroadcastStepEvent) => void): Unsubscribe;
+    /**
+     * Subscribe to a flow run's events
+     */
+    subscribeToRun(run_id: string): Promise<() => void>;
+    /**
+     * Fetch current state of a run and its steps
+     */
+    getRunWithStates(run_id: string): Promise<{
+        run: import('../../../core/src/index.ts').RunRow;
+        steps: import('../../../core/src/index.ts').StepStateRow[];
+    }>;
+    /**
+     * Get a flow run by ID
+     *
+     * @param run_id - ID of the run to get
+     * @returns Promise that resolves with the FlowRun instance or null if not found
+     */
+    getRun<TSpecificFlow extends TFlow = TFlow>(run_id: string): Promise<FlowRun<TSpecificFlow> | null>;
+}
+//# sourceMappingURL=PgflowClient.d.ts.map

package/dist/client/src/lib/PgflowClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PgflowClient.d.ts","sourceRoot":"","sources":["../../../../src/lib/PgflowClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;GAEG;AACH,qBAAa,YAAY,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,CAAE,YAAW,WAAW,CAAC,KAAK,CAAC;;IAOtF;;;;;OAKG;gBAED,cAAc,EAAE,cAAc,EAC9B,IAAI,GAAE;QACJ,4BAA4B,CAAC,EAAE,MAAM,CAAC;QACtC,QAAQ,CAAC,EAAE,OAAO,UAAU,CAAC;KACzB;IA4BR;;;;;;;OAOG;IACG,SAAS,CAAC,aAAa,SAAS,KAAK,EACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,CAAC,aAAa,CAAC,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAwDlC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc5B;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM;;;;IAI3C;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,WAAW;IAIrE;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,WAAW;IAIvE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAIzD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM;;;;IAIrC;;;;;OAKG;IACG,MAAM,CAAC,aAAa,SAAS,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CA6E1G"}

package/dist/client/src/lib/SupabaseBroadcastAdapter.d.ts

@@ -0,0 +1,66 @@
+import { IFlowRealtime, BroadcastRunEvent, BroadcastStepEvent, Unsubscribe } from './types.js';
+import { FlowRow, StepRow, RunRow, StepStateRow } from '../../../core/src/index.ts';
+import { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * Adapter to handle realtime communication with Supabase
+ */
+export declare class SupabaseBroadcastAdapter implements IFlowRealtime {
+    #private;
+    /**
+     * Creates a new instance of SupabaseBroadcastAdapter
+     *
+     * @param supabase - Supabase client instance
+     */
+    constructor(supabase: SupabaseClient, opts?: {
+        reconnectDelayMs?: number;
+        stabilizationDelayMs?: number;
+        schedule?: typeof setTimeout;
+    });
+    /**
+     * Fetches flow definition metadata from the database
+     *
+     * @param flow_slug - Flow slug to fetch
+     */
+    fetchFlowDefinition(flow_slug: string): Promise<{
+        flow: FlowRow;
+        steps: StepRow[];
+    }>;
+    /**
+     * Registers a callback for run events
+     *
+     * @param callback - Function to call when run events are received
+     * @returns Function to unsubscribe from the event
+     */
+    onRunEvent(callback: (event: BroadcastRunEvent) => void): Unsubscribe;
+    /**
+     * Registers a callback for step events
+     *
+     * @param callback - Function to call when step events are received
+     * @returns Function to unsubscribe from the event
+     */
+    onStepEvent(callback: (event: BroadcastStepEvent) => void): Unsubscribe;
+    /**
+     * Subscribes to a flow run's events
+     *
+     * @param run_id - Run ID to subscribe to
+     * @returns Function to unsubscribe
+     */
+    subscribeToRun(run_id: string): Promise<() => void>;
+    /**
+     * Unsubscribes from a run's events
+     *
+     * @param run_id - Run ID to unsubscribe from
+     */
+    unsubscribe(run_id: string): void;
+    /**
+     * Fetches current state of a run and its steps
+     *
+     * @param run_id - Run ID to fetch
+     */
+    getRunWithStates(run_id: string): Promise<{
+        run: RunRow;
+        steps: StepStateRow[];
+    }>;
+}
+//# sourceMappingURL=SupabaseBroadcastAdapter.d.ts.map

package/dist/client/src/lib/SupabaseBroadcastAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupabaseBroadcastAdapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/SupabaseBroadcastAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACZ,MAAM,YAAY,CAAC;AAQpB;;GAEG;AACH,qBAAa,wBAAyB,YAAW,aAAa;;IAS5D;;;;OAIG;gBAED,QAAQ,EAAE,cAAc,EACxB,IAAI,GAAE;QACJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,EAAE,OAAO,UAAU,CAAC;KACzB;IAmLR;;;;OAIG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACpD,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,EAAE,CAAC;KAClB,CAAC;IAiCF;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,WAAW;IAYrE;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,WAAW;IAevE;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAgEzD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9C,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,YAAY,EAAE,CAAC;KACvB,CAAC;CAiCH"}

package/dist/client/src/lib/eventAdapters.d.ts

@@ -0,0 +1,21 @@
+import { BroadcastRunEvent, BroadcastStepEvent, FlowRunEvent, StepEvent } from './types.js';
+import { RunRow, StepStateRow } from '../../../core/src/index.ts';
+import { AnyFlow, ExtractFlowSteps } from '../../../dsl/src/index.ts';
+
+/**
+ * Convert a broadcast run event to a typed run event
+ */
+export declare function toTypedRunEvent<TFlow extends AnyFlow>(evt: BroadcastRunEvent): FlowRunEvent<TFlow>;
+/**
+ * Convert a broadcast step event to a typed step event
+ */
+export declare function toTypedStepEvent<TFlow extends AnyFlow, TStepSlug extends keyof ExtractFlowSteps<TFlow> & string>(evt: BroadcastStepEvent): StepEvent<TFlow, TStepSlug>;
+/**
+ * Convert a database run row to a typed run event
+ */
+export declare function runRowToTypedEvent<TFlow extends AnyFlow>(row: RunRow): FlowRunEvent<TFlow>;
+/**
+ * Convert a database step state row to a typed step event
+ */
+export declare function stepStateRowToTypedEvent<TFlow extends AnyFlow, TStepSlug extends keyof ExtractFlowSteps<TFlow> & string>(row: StepStateRow): StepEvent<TFlow, TStepSlug>;
+//# sourceMappingURL=eventAdapters.d.ts.map

package/dist/client/src/lib/eventAdapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventAdapters.d.ts","sourceRoot":"","sources":["../../../../src/lib/eventAdapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAGP,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKzD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAS,OAAO,EACnD,GAAG,EAAE,iBAAiB,GACrB,YAAY,CAAC,KAAK,CAAC,CA+BrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,SAAS,OAAO,EACrB,SAAS,SAAS,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,EACxD,GAAG,EAAE,kBAAkB,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CA6BtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,OAAO,EACtD,GAAG,EAAE,MAAM,GACV,YAAY,CAAC,KAAK,CAAC,CAiCrB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,SAAS,OAAO,EACrB,SAAS,SAAS,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,EACxD,GAAG,EAAE,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAgChD"}