Version Packages (#186)

github-actions[bot] · web-flow · commit 3f5339a72c0f · 2025-07-17T02:26:24.000+02:00
Co-authored-by: github-actions[bot] &lt;41898282+github-actions[bot]@users.noreply.github.com&gt;
diff --git a/.changeset/clean-zoos-smoke.md b/.changeset/clean-zoos-smoke.md
diff --git a/.changeset/little-seas-lick.md b/.changeset/little-seas-lick.md
diff --git a/pkgs/cli/CHANGELOG.md b/pkgs/cli/CHANGELOG.md
@@ -1,5 +1,11 @@
 # pgflow
 
+## 0.5.4
+
+### Patch Changes
+
+- @pgflow/core@0.5.4
+
 ## 0.5.3
 
 ### Patch Changes
diff --git a/pkgs/cli/package.json b/pkgs/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "pgflow",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "type": "module",
   "main": "./dist/index.js",
   "typings": "./dist/index.d.ts",
diff --git a/pkgs/client/CHANGELOG.md b/pkgs/client/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @pgflow/client
 
+## 0.5.4
+
+### Patch Changes
+
+- Updated dependencies [9f219a4]
+  - @pgflow/dsl@0.5.4
+  - @pgflow/core@0.5.4
+
 ## 0.5.3
 
 ### Patch Changes
diff --git a/pkgs/client/package.json b/pkgs/client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/client",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "type": "module",
   "scripts": {
     "verify-exports": "node scripts/verify-exports.js"
diff --git a/pkgs/core/CHANGELOG.md b/pkgs/core/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @pgflow/core
 
+## 0.5.4
+
+### Patch Changes
+
+- Updated dependencies [9f219a4]
+  - @pgflow/dsl@0.5.4
+
 ## 0.5.3
 
 ### Patch Changes
diff --git a/pkgs/core/package.json b/pkgs/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/core",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "license": "AGPL-3.0",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/pkgs/dsl/CHANGELOG.md b/pkgs/dsl/CHANGELOG.md
@@ -1,5 +1,46 @@
 # @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
diff --git a/pkgs/dsl/package.json b/pkgs/dsl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/dsl",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
diff --git a/pkgs/edge-worker/CHANGELOG.md b/pkgs/edge-worker/CHANGELOG.md
@@ -1,5 +1,56 @@
 # @pgflow/edge-worker
 
+## 0.5.4
+
+### Patch Changes
+
+- 9f219a4: Remove PlatformAdapter from EdgeWorker.start() return type
+
+  The `EdgeWorker.start()` method now returns `Promise<void>` instead of `Promise<PlatformAdapter>`. The PlatformAdapter was never intended to be part of the public API and was accidentally exposed. This change properly encapsulates the internal implementation details.
+
+  **Breaking Change**: If you were using the returned PlatformAdapter (which was undocumented), you'll need to refactor your code. However, this is unlikely as the EdgeWorker is designed to be started and run without further interaction.
+
+- 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.
+
+- Updated dependencies [9f219a4]
+  - @pgflow/dsl@0.5.4
+  - @pgflow/core@0.5.4
+
 ## 0.5.3
 
 ### Patch Changes
diff --git a/pkgs/edge-worker/jsr.json b/pkgs/edge-worker/jsr.json
@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/edge-worker",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "license": "AGPL-3.0",
   "exports": {
     ".": "./src/index.ts",
@@ -9,8 +9,8 @@
   "imports": {
     "@henrygd/queue": "jsr:@henrygd/queue@^1.0.7",
     "postgres": "npm:postgres@3.4.5",
-    "@pgflow/core": "npm:@pgflow/core@0.5.3",
-    "@pgflow/dsl": "npm:@pgflow/dsl@0.5.3"
+    "@pgflow/core": "npm:@pgflow/core@0.5.4",
+    "@pgflow/dsl": "npm:@pgflow/dsl@0.5.4"
   },
   "publish": {
     "include": [
diff --git a/pkgs/edge-worker/package.json b/pkgs/edge-worker/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/edge-worker",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "license": "AGPL-3.0",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/pkgs/example-flows/CHANGELOG.md b/pkgs/example-flows/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @pgflow/example-flows
 
+## 0.5.4
+
+### Patch Changes
+
+- Updated dependencies [9f219a4]
+  - @pgflow/dsl@0.5.4
+  - @pgflow/core@0.5.4
+
 ## 0.5.3
 
 ### Patch Changes
diff --git a/pkgs/example-flows/package.json b/pkgs/example-flows/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@pgflow/example-flows",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "dependencies": {
     "@pgflow/core": "workspace:*",
     "@pgflow/dsl": "workspace:*"
diff --git a/pkgs/website/CHANGELOG.md b/pkgs/website/CHANGELOG.md
@@ -1,5 +1,7 @@
 # @pgflow/website
 
+## 0.5.4
+
 ## 0.5.3
 
 ### Patch Changes
diff --git a/pkgs/website/package.json b/pkgs/website/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@pgflow/website",
   "type": "module",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "pgflow",`
`3`		`- "version": "0.5.3",`
	`3`	`+ "version": "0.5.4",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"main": "./dist/index.js",`
`6`	`6`	`"typings": "./dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@pgflow/client",`
`3`		`- "version": "0.5.3",`
	`3`	`+ "version": "0.5.4",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"scripts": {`
`6`	`6`	`"verify-exports": "node scripts/verify-exports.js"`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@pgflow/core",`
`3`		`- "version": "0.5.3",`
	`3`	`+ "version": "0.5.4",`
`4`	`4`	`"license": "AGPL-3.0",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@pgflow/dsl",`
`3`		`- "version": "0.5.3",`
	`3`	`+ "version": "0.5.4",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"main": "./dist/index.js",`
`6`	`6`	`"module": "./dist/index.js",`