@pgflow/dsl 0.5.2 → 0.5.4

package/README.md

@@ -13,7 +13,7 @@ Key features:
 
 - **Type Safety** - Complete TypeScript type checking from flow inputs to outputs
 - **Fluent Interface** - Chainable method calls for defining steps and dependencies
-- **Functional Approach** - Clean separation between task implementation and flow orchestration 
+- **Functional Approach** - Clean separation between task implementation and flow orchestration
 - **JSON-Compatible** - All inputs and outputs are JSON-serializable for database storage
 - **Immutable Flow Definitions** - Each step operation returns a new Flow instance
 
@@ -68,21 +68,101 @@ In pgflow, each step receives an `input` object that contains:
 2. **`input.{stepName}`** - Outputs from dependency steps
 
 This design ensures:
+
 - Original flow parameters are accessible throughout the entire flow
 - Data doesn't need to be manually forwarded through intermediate steps
 - Steps can combine original input with processed data from previous steps
 
+### Context Object
+
+Step handlers can optionally receive a second parameter - the **context object** - which provides access to platform resources and runtime information.
+
+```typescript
+.step(
+  { slug: 'saveToDb' },
+  async (input, context) => {
+    // Access platform resources through context
+    const result = await context.sql`SELECT * FROM users WHERE id = ${input.userId}`;
+    return result[0];
+  }
+)
+```
+
+#### Core Context Resources
+
+All platforms provide these core resources:
+
+- **`context.env`** - Environment variables (`Record<string, string | undefined>`)
+- **`context.shutdownSignal`** - AbortSignal for graceful shutdown handling
+- **`context.rawMessage`** - Original pgmq message with metadata
+  ```typescript
+  interface PgmqMessageRecord<T> {
+    msg_id: number;
+    read_ct: number;
+    enqueued_at: Date;
+    vt: Date;
+    message: T; // <-- this is your 'input'
+  }
+  ```
+- **`context.stepTask`** - Current step task details (flow handlers only)
+  ```typescript
+  interface StepTaskRecord<TFlow> {
+    flow_slug: string;
+    run_id: string;
+    step_slug: string;
+    input: StepInput<TFlow, StepSlug>; // <-- this is handler 'input'
+    msg_id: number;
+  }
+  ```
+
+#### Supabase Platform Resources
+
+When using the Supabase platform with EdgeWorker, additional resources are available:
+
+- **`context.sql`** - PostgreSQL client (postgres.js)
+- **`context.anonSupabase`** - Supabase client with anonymous key
+- **`context.serviceSupabase`** - Supabase client with service role key
+
+To use Supabase resources, import the `Flow` class from the Supabase preset:
+
+```typescript
+import { Flow } from '@pgflow/dsl/supabase';
+
+const MyFlow = new Flow<{ userId: string }>({
+  slug: 'my_flow',
+}).step({ slug: 'process' }, async (input, context) => {
+  // TypeScript knows context includes Supabase resources
+  const { data } = await context.serviceSupabase
+    .from('users')
+    .select('*')
+    .eq('id', input.userId);
+
+  // Use SQL directly
+  const stats = await context.sql`
+      SELECT COUNT(*) as total FROM events 
+      WHERE user_id = ${input.userId}
+    `;
+
+  return { user: data[0], eventCount: stats[0].total };
+});
+```
+
+> [!NOTE]
+> Context is optional - handlers that don't need platform resources can omit the second parameter for backward compatibility.
+
+For more details on available resources and platform configuration, see the [@pgflow/edge-worker documentation](https://github.com/pgflow-org/pgflow/tree/main/pkgs/edge-worker#context-resources).
+
 ### Flow Configuration
 
 Configure flows and steps with runtime options:
 
 ```typescript
 new Flow<Input>({
-  slug: 'my_flow',     // Required: Unique flow identifier
-  maxAttempts: 3,      // Optional: Maximum retry attempts (default: 1)
-  baseDelay: 5,        // Optional: Base delay in seconds for retries (default: 1)
-  timeout: 10,         // Optional: Task timeout in seconds (default: 30)
-})
+  slug: 'my_flow', // Required: Unique flow identifier
+  maxAttempts: 3, // Optional: Maximum retry attempts (default: 1)
+  baseDelay: 5, // Optional: Base delay in seconds for retries (default: 1)
+  timeout: 10, // Optional: Task timeout in seconds (default: 30)
+});
 ```
 
 ## Compiling Flows
@@ -120,4 +200,5 @@ Run `nx test dsl` to execute the unit tests via [Vitest](https://vitest.dev/).
 ## Documentation
 
 For detailed documentation on the Flow DSL, visit:
-- [Understanding the Flow DSL](https://pgflow.dev/explanations/flow-dsl/)
+
+- [Understanding the Flow DSL](https://pgflow.dev/explanations/flow-dsl/)

package/dist/CHANGELOG.md

@@ -1,5 +1,129 @@
 # @pgflow/dsl
 
+## 0.5.4
+
+### Patch Changes
+
+- 9f219a4: Add context object as second parameter to handlers
+
+  Queue and flow handlers now receive an optional context parameter that provides platform resources like database connections, environment variables, and Supabase clients - eliminating boilerplate and connection management.
+
+  ```typescript
+  // Queue handler
+  EdgeWorker.start(async (payload, context) => {
+    await context.sql`INSERT INTO tasks (data) VALUES (${payload})`;
+  });
+
+  // Flow step handler
+  .step({ slug: 'process' }, async (input, context) => {
+    const result = await context.serviceSupabase.from('users').select();
+  })
+  ```
+
+  **Core resources** (always available):
+
+  - `context.env` - Environment variables
+  - `context.shutdownSignal` - AbortSignal for graceful shutdown
+  - `context.rawMessage` - Original pgmq message with metadata
+  - `context.stepTask` - Current step task details (flow handlers only)
+
+  **Supabase platform resources**:
+
+  - `context.sql` - PostgreSQL client (postgres.js)
+  - `context.anonSupabase` - Supabase client with anonymous key
+  - `context.serviceSupabase` - Supabase client with service role key
+
+  To use Supabase resources in flows, import from the Supabase preset:
+
+  ```typescript
+  import { Flow } from '@pgflow/dsl/supabase';
+  ```
+
+  The context parameter is optional for backward compatibility - existing single-parameter handlers continue to work unchanged.
+
+## 0.5.3
+
+### Patch Changes
+
+- af787ff: Add `startDelay` option for workflow steps
+
+  Introduces the ability to delay a step's **initial execution** by a specified number of seconds, enabling multi-day workflows and scheduled tasks within pgflow.
+
+  **Important**: `startDelay` only applies to the first execution attempt. Retries use the standard exponential backoff mechanism based on `baseDelay`, not `startDelay`.
+
+  ### Core Changes (@pgflow/core)
+
+  - Added `opt_start_delay` column (integer, nullable, CHECK >= 0) to `pgflow.steps` table
+  - Updated `add_step` function to accept and validate the new `start_delay` parameter
+  - Modified `start_ready_steps` to schedule initial task execution with delay via `pgmq.send(queue, message, delay)`
+  - Requires pgmq >= 0.40 for delay support
+  - Migration: `20250707210212_pgflow_add_opt_start_delay.sql`
+  - Added comprehensive PgTAP tests for validation and scheduling behavior
+
+  ### DSL Changes (@pgflow/dsl)
+
+  - Extended `StepOptions` and `StepRuntimeOptions` interfaces with optional `startDelay` (in seconds)
+  - Updated `compileFlow()` to emit `start_delay => value` in generated SQL
+  - Added validation: `startDelay` is only allowed at step level, not flow level (prevents cascading delays)
+  - Valid range: 0 to 2,147,483,647 seconds (~68 years)
+  - Added unit tests for compilation and validation
+
+  ### Documentation Updates (@pgflow/website)
+
+  - Added `startDelay` section in configuration guide with detailed explanation
+  - Created multi-day workflow example (onboarding email sequence)
+  - Updated "Update Flow Options" to include `opt_start_delay`
+  - Enhanced VS comparison pages to mention "Native step delays" capability
+  - Documented why `startDelay` is step-level only
+
+  ### Example Usage
+
+  ```typescript
+  new Flow({
+    slug: 'user_onboarding',
+    maxAttempts: 3,
+    baseDelay: 5, // Retry delay (not initial delay)
+    timeout: 60,
+  })
+    .step(
+      {
+        slug: 'send_welcome_email',
+        // Executes immediately when step becomes ready
+      },
+      sendWelcomeHandler
+    )
+    .step(
+      {
+        slug: 'send_day_3_tips',
+        startDelay: 259200, // Wait 3 days before first execution
+        timeout: 120,
+      },
+      sendTipsHandler
+    )
+    .step(
+      {
+        slug: 'send_week_review',
+        startDelay: 604800, // Wait 7 days after dependencies complete
+        timeout: 120,
+      },
+      sendReviewHandler
+    );
+  ```
+
+  ### Use Cases
+
+  - **Multi-day workflows**: Onboarding sequences, follow-up reminders
+  - **Scheduled notifications**: Send reports or alerts at specific intervals
+  - **Rate limiting**: Enforce minimum time between API calls
+  - **Compliance delays**: Cooling-off periods before actions
+
+  ### Technical Notes
+
+  - Non-breaking, additive change (hence minor version bump)
+  - No changes required in `@pgflow/edge-worker` - delays handled by pgmq
+  - `startDelay` does not affect retry timing - only the initial execution
+  - Delays are reliable even across worker restarts (persisted in queue)
+
 ## 0.5.2
 
 ## 0.5.1

package/dist/README.md

@@ -13,7 +13,7 @@ Key features:
 
 - **Type Safety** - Complete TypeScript type checking from flow inputs to outputs
 - **Fluent Interface** - Chainable method calls for defining steps and dependencies
-- **Functional Approach** - Clean separation between task implementation and flow orchestration 
+- **Functional Approach** - Clean separation between task implementation and flow orchestration
 - **JSON-Compatible** - All inputs and outputs are JSON-serializable for database storage
 - **Immutable Flow Definitions** - Each step operation returns a new Flow instance
 
@@ -68,21 +68,101 @@ In pgflow, each step receives an `input` object that contains:
 2. **`input.{stepName}`** - Outputs from dependency steps
 
 This design ensures:
+
 - Original flow parameters are accessible throughout the entire flow
 - Data doesn't need to be manually forwarded through intermediate steps
 - Steps can combine original input with processed data from previous steps
 
+### Context Object
+
+Step handlers can optionally receive a second parameter - the **context object** - which provides access to platform resources and runtime information.
+
+```typescript
+.step(
+  { slug: 'saveToDb' },
+  async (input, context) => {
+    // Access platform resources through context
+    const result = await context.sql`SELECT * FROM users WHERE id = ${input.userId}`;
+    return result[0];
+  }
+)
+```
+
+#### Core Context Resources
+
+All platforms provide these core resources:
+
+- **`context.env`** - Environment variables (`Record<string, string | undefined>`)
+- **`context.shutdownSignal`** - AbortSignal for graceful shutdown handling
+- **`context.rawMessage`** - Original pgmq message with metadata
+  ```typescript
+  interface PgmqMessageRecord<T> {
+    msg_id: number;
+    read_ct: number;
+    enqueued_at: Date;
+    vt: Date;
+    message: T; // <-- this is your 'input'
+  }
+  ```
+- **`context.stepTask`** - Current step task details (flow handlers only)
+  ```typescript
+  interface StepTaskRecord<TFlow> {
+    flow_slug: string;
+    run_id: string;
+    step_slug: string;
+    input: StepInput<TFlow, StepSlug>; // <-- this is handler 'input'
+    msg_id: number;
+  }
+  ```
+
+#### Supabase Platform Resources
+
+When using the Supabase platform with EdgeWorker, additional resources are available:
+
+- **`context.sql`** - PostgreSQL client (postgres.js)
+- **`context.anonSupabase`** - Supabase client with anonymous key
+- **`context.serviceSupabase`** - Supabase client with service role key
+
+To use Supabase resources, import the `Flow` class from the Supabase preset:
+
+```typescript
+import { Flow } from '@pgflow/dsl/supabase';
+
+const MyFlow = new Flow<{ userId: string }>({
+  slug: 'my_flow',
+}).step({ slug: 'process' }, async (input, context) => {
+  // TypeScript knows context includes Supabase resources
+  const { data } = await context.serviceSupabase
+    .from('users')
+    .select('*')
+    .eq('id', input.userId);
+
+  // Use SQL directly
+  const stats = await context.sql`
+      SELECT COUNT(*) as total FROM events 
+      WHERE user_id = ${input.userId}
+    `;
+
+  return { user: data[0], eventCount: stats[0].total };
+});
+```
+
+> [!NOTE]
+> Context is optional - handlers that don't need platform resources can omit the second parameter for backward compatibility.
+
+For more details on available resources and platform configuration, see the [@pgflow/edge-worker documentation](https://github.com/pgflow-org/pgflow/tree/main/pkgs/edge-worker#context-resources).
+
 ### Flow Configuration
 
 Configure flows and steps with runtime options:
 
 ```typescript
 new Flow<Input>({
-  slug: 'my_flow',     // Required: Unique flow identifier
-  maxAttempts: 3,      // Optional: Maximum retry attempts (default: 1)
-  baseDelay: 5,        // Optional: Base delay in seconds for retries (default: 1)
-  timeout: 10,         // Optional: Task timeout in seconds (default: 30)
-})
+  slug: 'my_flow', // Required: Unique flow identifier
+  maxAttempts: 3, // Optional: Maximum retry attempts (default: 1)
+  baseDelay: 5, // Optional: Base delay in seconds for retries (default: 1)
+  timeout: 10, // Optional: Task timeout in seconds (default: 30)
+});
 ```
 
 ## Compiling Flows
@@ -120,4 +200,5 @@ Run `nx test dsl` to execute the unit tests via [Vitest](https://vitest.dev/).
 ## Documentation
 
 For detailed documentation on the Flow DSL, visit:
-- [Understanding the Flow DSL](https://pgflow.dev/explanations/flow-dsl/)
+
+- [Understanding the Flow DSL](https://pgflow.dev/explanations/flow-dsl/)

package/dist/compile-flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile-flow.d.ts","sourceRoot":"","sources":["../src/compile-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,UAAU,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAyBnD"}
+{"version":3,"file":"compile-flow.d.ts","sourceRoot":"","sources":["../src/compile-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsC,MAAM,UAAU,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAyBnD"}

package/dist/compile-flow.js

@@ -38,5 +38,8 @@ function formatRuntimeOptions(options) {
     if (options.timeout !== undefined) {
         parts.push(`timeout => ${options.timeout}`);
     }
+    if ('startDelay' in options && options.startDelay !== undefined) {
+        parts.push(`start_delay => ${options.startDelay}`);
+    }
     return parts.length > 0 ? `, ${parts.join(', ')}` : '';
 }

package/dist/dsl.d.ts

@@ -4,6 +4,13 @@ export type Json = string | number | boolean | null | Json[] | {
 export type Simplify<T> = {
     [KeyType in keyof T]: T[KeyType];
 } & {};
+type AwaitedReturn<T> = T extends (...args: any[]) => Promise<infer R> ? R : T extends (...args: any[]) => infer R ? R : never;
+export interface Env {
+    [key: string]: string | undefined;
+}
+export type ValidEnv<T> = T extends Env ? T : never;
+export interface UserEnv extends Env {
+}
 export type AnyInput = Json;
 export type AnyOutput = Json;
 export type EmptySteps = Record<never, never>;
@@ -14,35 +21,47 @@ export type AnyDeps = Record<string, string[]>;
 /**
  * Represents a Flow that has not steps nor deps defined yet
  */
-export type EmptyFlow = Flow<AnyInput, EmptySteps, EmptyDeps>;
+export type EmptyFlow = Flow<AnyInput, BaseContext, EmptySteps, EmptyDeps>;
 /**
- * Represents any Flow with flexible input, steps, and dependencies.
+ * Represents any Flow with flexible input, context, steps, and dependencies.
  * This type is intentionally more permissive to allow for better type inference
  * in utility types like StepOutput.
  */
-export type AnyFlow = Flow<any, any, any>;
+export type AnyFlow = Flow<any, any, any, any>;
 /**
  * Extracts the input type from a Flow
  * @template TFlow - The Flow type to extract from
  */
-export type ExtractFlowInput<TFlow extends AnyFlow> = TFlow extends Flow<infer TI, infer _TS, infer _TD> ? TI : never;
+export type ExtractFlowInput<TFlow extends AnyFlow> = TFlow extends Flow<infer TI, infer _TC, infer _TS, infer _TD> ? TI : never;
+/**
+ * Utility type to extract all possible step inputs from a flow
+ * This creates a union of all step input types
+ */
+export type AllStepInputs<TFlow extends AnyFlow> = {
+    [K in keyof ExtractFlowSteps<TFlow> & string]: StepInput<TFlow, K>;
+}[keyof ExtractFlowSteps<TFlow> & string];
 /**
  * Extracts the output type from a Flow
  * @template TFlow - The Flow type to extract from
  */
-export type ExtractFlowOutput<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer _TS, infer _TD> ? {
+export type ExtractFlowOutput<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer _TC, infer _TS, infer _TD> ? {
     [K in keyof ExtractFlowLeafSteps<TFlow> as K extends string ? K : never]: StepOutput<TFlow, K & string>;
 } : never;
 /**
  * Extracts the steps type from a Flow
  * @template TFlow - The Flow type to extract from
  */
-export type ExtractFlowSteps<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer TS, infer _TD> ? TS : never;
+export type ExtractFlowSteps<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer _TC, infer TS, infer _TD> ? TS : never;
 /**
  * Extracts the dependencies type from a Flow
  * @template TFlow - The Flow type to extract from
  */
-export type ExtractFlowDeps<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer _TS, infer TD> ? TD : never;
+export type ExtractFlowDeps<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer _TC, infer _TS, infer TD> ? TD : never;
+/**
+ * Extracts the context type from a Flow
+ * @template TFlow - The Flow type to extract from
+ */
+export type ExtractFlowContext<TFlow extends AnyFlow> = TFlow extends Flow<infer _TI, infer TC, infer _TS, infer _TD> ? TC : never;
 /**
  * Extracts the dependencies type from a Flow
  * @template TFlow - The Flow type to extract from
@@ -73,13 +92,23 @@ export interface RuntimeOptions {
     baseDelay?: number;
     timeout?: number;
 }
-export interface StepDefinition<TInput extends AnyInput, TOutput extends AnyOutput> {
+export interface BaseContext {
+    env: Env & ValidEnv<UserEnv>;
+    shutdownSignal: AbortSignal;
+}
+export type Context<T extends Record<string, unknown> = Record<string, never>> = BaseContext & T;
+type ExtractHandlerContext<T> = T extends (input: any, context: infer C) => any ? C : never;
+export interface StepRuntimeOptions extends RuntimeOptions {
+    startDelay?: number;
+}
+export interface StepDefinition<TInput extends AnyInput, TOutput extends AnyOutput, TContext = BaseContext> {
     slug: string;
-    handler: (input: TInput) => TOutput | Promise<TOutput>;
+    handler: (input: TInput, context: TContext) => TOutput | Promise<TOutput>;
     dependencies: string[];
-    options: RuntimeOptions;
+    options: StepRuntimeOptions;
 }
-export declare class Flow<TFlowInput extends AnyInput = AnyInput, Steps extends AnySteps = EmptySteps, StepDependencies extends AnyDeps = EmptyDeps> {
+export declare class Flow<TFlowInput extends AnyInput = AnyInput, TContext = BaseContext, // Accumulated context requirements (starts with BaseContext)
+Steps extends AnySteps = EmptySteps, StepDependencies extends AnyDeps = EmptyDeps> {
     /**
      * Store step definitions with their proper types
      *
@@ -103,15 +132,15 @@ export declare class Flow<TFlowInput extends AnyInput = AnyInput, Steps extends
     } & {
         [K in StepDependencies[SlugType][number]]: K extends keyof Steps ? Steps[K] : never;
     }>, Steps[SlugType]>;
-    step<Slug extends string, Deps extends Extract<keyof Steps, string> = never, RetType extends AnyOutput = AnyOutput>(opts: Simplify<{
-        slug: Slug;
-        dependsOn?: Deps[];
-    } & RuntimeOptions>, handler: (input: Simplify<{
+    step<Slug extends string, THandler extends (input: Simplify<{
         run: TFlowInput;
     } & {
         [K in Deps]: K extends keyof Steps ? Steps[K] : never;
-    }>) => RetType | Promise<RetType>): Flow<TFlowInput, Steps & {
-        [K in Slug]: Awaited<RetType>;
+    }>, context: BaseContext & TContext) => any, Deps extends Extract<keyof Steps, string> = never>(opts: Simplify<{
+        slug: Slug;
+        dependsOn?: Deps[];
+    } & StepRuntimeOptions>, handler: THandler): Flow<TFlowInput, TContext & BaseContext & ExtractHandlerContext<THandler>, Steps & {
+        [K in Slug]: AwaitedReturn<THandler>;
     }, StepDependencies & {
         [K in Slug]: Deps[];
     }>;

package/dist/dsl.d.ts.map

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

package/dist/dsl.js

@@ -64,12 +64,14 @@ export class Flow {
             options.baseDelay = opts.baseDelay;
         if (opts.timeout !== undefined)
             options.timeout = opts.timeout;
+        if (opts.startDelay !== undefined)
+            options.startDelay = opts.startDelay;
         // Validate runtime options (optional for step level)
         validateRuntimeOptions(options, { optional: true });
         // Preserve the exact type of the handler
         const newStepDefinition = {
             slug,
-            handler: handler,
+            handler: handler, // Type assertion needed due to complex generic constraints
             dependencies: dependencies,
             options,
         };

package/dist/example-flow.d.ts

@@ -2,7 +2,7 @@ import { Flow } from './dsl.js';
 type Input = {
     url: string;
 };
-export declare const AnalyzeWebsite: Flow<Input, import("./dsl.js").EmptySteps & {
+export declare const AnalyzeWebsite: Flow<Input, import("./dsl.js").BaseContext, import("./dsl.js").EmptySteps & {
     website: {
         content: string;
     };

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/dsl",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -14,12 +14,22 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./platforms": {
+      "types": "./dist/platforms/index.d.ts",
+      "import": "./dist/platforms/index.js"
+    },
+    "./supabase": {
+      "types": "./dist/platforms/supabase.d.ts",
+      "import": "./dist/platforms/supabase.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "^22.14.1"
+    "@types/node": "^22.14.1",
+    "postgres": "^3.4.5",
+    "@supabase/supabase-js": "^2.47.10"
   }
 }

package/dist/platforms/index.d.ts

@@ -0,0 +1,2 @@
+export type { BaseContext, Context } from '../index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/platforms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platforms/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/platforms/index.js

@@ -0,0 +1,2 @@
+export {};
+// Future: utility types for platform implementations can go here

package/dist/platforms/supabase.d.ts

@@ -0,0 +1,30 @@
+import type { Sql } from 'postgres';
+import type { SupabaseClient } from '@supabase/supabase-js';
+import { Flow as CoreFlow, type AnyInput, type AnySteps, type AnyDeps, EmptySteps, EmptyDeps, type Env, type UserEnv, type ValidEnv, type AnyFlow, type Json, type BaseContext } from '../index.js';
+export interface SupabaseResources extends Record<string, unknown> {
+    sql: Sql;
+    anonSupabase: SupabaseClient;
+    serviceSupabase: SupabaseClient;
+}
+export interface SupabaseEnv extends Env {
+    EDGE_WORKER_DB_URL: string;
+    SUPABASE_URL: string;
+    SUPABASE_ANON_KEY: string;
+    SUPABASE_SERVICE_ROLE_KEY: string;
+    SB_EXECUTION_ID: string;
+    EDGE_WORKER_LOG_LEVEL?: string;
+}
+export type SupabasePlatformContext = BaseContext & SupabaseResources & {
+    env: SupabaseEnv & ValidEnv<UserEnv>;
+};
+export type SupabaseMessageContext<T extends Json = Json> = SupabasePlatformContext & {
+    rawMessage: any;
+};
+export type SupabaseStepTaskContext<F extends AnyFlow = AnyFlow> = SupabasePlatformContext & {
+    rawMessage: any;
+    stepTask: any;
+};
+export declare class Flow<I extends AnyInput = AnyInput, ExtraCtx extends Record<string, unknown> = Record<string, never>, S extends AnySteps = EmptySteps, D extends AnyDeps = EmptyDeps> extends CoreFlow<I, SupabasePlatformContext & ExtraCtx, // <── full ctx in handlers
+S, D> {
+}
+//# sourceMappingURL=supabase.d.ts.map

package/dist/platforms/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/platforms/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,IAAI,IAAI,QAAQ,EAChB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAC1C,UAAU,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAC5D,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,WAAW,EAC1C,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,GAAG,EAAc,GAAG,CAAC;IACrB,YAAY,EAAK,cAAc,CAAC;IAChC,eAAe,EAAE,cAAc,CAAC;CACjC;AAGD,MAAM,WAAW,WAAY,SAAQ,GAAG;IACtC,kBAAkB,EAAQ,MAAM,CAAC;IACjC,YAAY,EAAc,MAAM,CAAC;IACjC,iBAAiB,EAAS,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAW,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAI,MAAM,CAAC;CAClC;AAGD,MAAM,MAAM,uBAAuB,GACjC,WAAW,GAAG,iBAAiB,GAAG;IAChC,GAAG,EAAE,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC;AAGJ,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,IACtD,uBAAuB,GAAG;IACxB,UAAU,EAAE,GAAG,CAAC;CACjB,CAAC;AAEJ,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAC7D,uBAAuB,GAAG;IACxB,UAAU,EAAE,GAAG,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;CACf,CAAC;AAGJ,qBAAa,IAAI,CACf,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAChE,CAAC,SAAS,QAAQ,GAAG,UAAU,EAC/B,CAAC,SAAS,OAAO,GAAK,SAAS,CAC/B,SAAQ,QAAQ,CAChB,CAAC,EACD,uBAAuB,GAAG,QAAQ,EAAI,2BAA2B;AACjE,CAAC,EAAE,CAAC,CACL;CAAG"}

package/dist/platforms/supabase.js

@@ -0,0 +1,4 @@
+import { Flow as CoreFlow } from '../index.js';
+/* ---------- 5. pre-wired Flow helper -------------------------------- */
+export class Flow extends CoreFlow {
+}

package/dist/supabase.d.ts

@@ -0,0 +1,2 @@
+export * from './platforms/supabase.js';
+//# sourceMappingURL=supabase.d.ts.map

package/dist/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../src/supabase.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC"}

package/dist/supabase.js

@@ -0,0 +1,2 @@
+// Re-export everything from platforms/supabase
+export * from './platforms/supabase.js';

package/dist/utils.d.ts

@@ -21,6 +21,7 @@ export interface ValidateRuntimeOptionsOpts {
  * - maxAttempts should be >= 1
  * - baseDelay should be >= 1
  * - timeout should be >= 3
+ * - startDelay should be >= 0
  *
  * @param options The runtime options to validate
  * @param opts Configuration options for validation
@@ -31,5 +32,6 @@ export declare function validateRuntimeOptions(options: {
     maxAttempts?: number;
     baseDelay?: number;
     timeout?: number;
+    startDelay?: number;
 }, opts?: ValidateRuntimeOptionsOpts): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAsB/C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACvE,IAAI,GAAE,0BAAgD,GACrD,IAAI,CA2BN"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAsB/C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5F,IAAI,GAAE,0BAAgD,GACrD,IAAI,CAiCN"}

package/dist/utils.js

@@ -31,6 +31,7 @@ export function validateSlug(slug) {
  * - maxAttempts should be >= 1
  * - baseDelay should be >= 1
  * - timeout should be >= 3
+ * - startDelay should be >= 0
  *
  * @param options The runtime options to validate
  * @param opts Configuration options for validation
@@ -38,7 +39,7 @@ export function validateSlug(slug) {
  * @throws Error if any runtime option is invalid
  */
 export function validateRuntimeOptions(options, opts = { optional: false }) {
-    const { maxAttempts, baseDelay, timeout } = options;
+    const { maxAttempts, baseDelay, timeout, startDelay } = options;
     // If optional is true, skip validation for undefined/null values
     if (maxAttempts !== undefined && maxAttempts !== null) {
         if (maxAttempts < 1) {
@@ -64,4 +65,9 @@ export function validateRuntimeOptions(options, opts = { optional: false }) {
     else if (!opts.optional) {
         throw new Error('timeout is required');
     }
+    if (startDelay !== undefined && startDelay !== null) {
+        if (startDelay < 0) {
+            throw new Error('startDelay must be greater than or equal to 0');
+        }
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/dsl",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -14,12 +14,22 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./platforms": {
+      "types": "./dist/platforms/index.d.ts",
+      "import": "./dist/platforms/index.js"
+    },
+    "./supabase": {
+      "types": "./dist/platforms/supabase.d.ts",
+      "import": "./dist/platforms/supabase.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "^22.14.1"
+    "@types/node": "^22.14.1",
+    "postgres": "^3.4.5",
+    "@supabase/supabase-js": "^2.47.10"
   }
 }