@ironflow/browser 0.26.0 → 0.27.0

package/README.md

@@ -119,7 +119,7 @@ Register a global handler that fires for all subscription errors:
 
 ```typescript
 const unsubscribe = ironflow.onError((error) => {
-  // error: { message: string; code: string; retryable?: boolean }
+  // error: { subscriptionId?: string; code: string; message: string; retrying?: boolean }
   console.error('Ironflow error:', error.message, error.code);
 });
 ```
@@ -204,7 +204,7 @@ sub.unsubscribe();
 
 ### Pattern Helpers
 
-Use the `patterns` utility to build subscription patterns. Available as a static property on the client class and as a direct import:
+Use the `patterns` utility to build subscription patterns. Import it directly:
 
 ```typescript
 import { ironflow, patterns } from '@ironflow/browser';
@@ -273,9 +273,9 @@ const sub = await ironflow.joinConsumerGroup(
 );
 
 // Returns AckableSubscription
-sub.ack(eventId);                // Acknowledge successful processing
-sub.nak(eventId, 5000);         // Negative ack with optional redelivery delay (ms)
-sub.term(eventId);               // Terminate - do not redeliver
+await sub.ack(eventId);          // Acknowledge successful processing
+await sub.nak(eventId, 5000);   // Negative ack with optional redelivery delay (ms)
+await sub.term(eventId);         // Terminate - do not redeliver
 
 sub.unsubscribe();
 ```
@@ -291,7 +291,7 @@ const sub = await ironflow.subscribe('events:order.created', {
 
 // sub is AckableSubscription when ackMode is 'manual'
 const ackableSub = sub as AckableSubscription;
-ackableSub.ack(eventId);
+await ackableSub.ack(eventId);
 ```
 
 ## Emitting Events
@@ -481,7 +481,7 @@ Errors:
 | `RunFailedError` | `system.run.{runId}.failed` |
 | `RunCancelledError` | `system.run.{runId}.cancelled` |
 
-### `agents.subscribe(runId, callbacks)`
+### `agents.subscribe(runId, callbacks, opts?)`
 
 Typed wrapper over the broader `subscribe(pattern)` API. Dispatches by topic.
 
@@ -1302,13 +1302,13 @@ The package re-exports the following types from `@ironflow/core` for convenience
 
 **KV types:** `KVBucketConfig`, `KVBucketInfo`, `KVEntry`, `KVPutResult`, `KVListKeysResult`, `KVListBucketsResult`, `KVWatchEvent`, `KVWatchCallbacks`, `KVWatchOptions`, `KVWatcher`
 
-**Config types:** `ConfigResponse`, `ConfigEntry`, `ConfigSetResult`, `ConfigWatchCallbacks`
+**Config types:** `ConfigResponse`, `ConfigEntry`, `ConfigSetResult`, `ConfigWatchCallbacks`, `ConfigWatchEvent`
 
 **Browser-specific types:** `IronflowConfig`, `IronflowConfigOptions`, `ReconnectConfig`, `VisibilityConfig`, `AuthConfig`, `BrowserSubscribeOptions`, `SubscriptionGroup`, `Transport`, `TransportCallbacks`, `TransportFactory`, `TransportOptions`
 
-**Utilities:** `patterns`, `DEFAULT_SERVER_URL`, `DEFAULT_WS_URL`, `DEFAULT_TIMEOUTS`, `getServerUrl`, `getWebSocketUrl`
+**Utilities:** `patterns`, `DEFAULT_SERVER_URL`, `DEFAULT_WS_URL`, `DEFAULT_TIMEOUTS`, `getServerUrl`, `getWebSocketUrl`, `DEFAULT_CONFIG`, `mergeConfig`
 
-**Classes:** `BrowserKVClient`, `BrowserKVBucketHandle`, `BrowserConfigClient`
+**Classes:** `BrowserKVClient`, `BrowserKVBucketHandle`, `BrowserConfigClient`, `SubscriptionManager`
 
 ## Links
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ironflow/browser",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Browser client for Ironflow event-driven backend platform - real-time subscriptions, workflow triggers, and event emission",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "@connectrpc/connect": "^2.1.2",
     "@connectrpc/connect-web": "^2.1.2",
     "zod": "^4.4.3",
-    "@ironflow/core": "^0.26.0"
+    "@ironflow/core": "^0.27.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
@@ -54,7 +54,7 @@
   "license": "LicenseRef-Ironflow-EULA",
   "homepage": "https://ironflow.run",
   "bugs": {
-    "url": "https://github.com/sahina/ironflow-js/issues"
+    "url": "https://github.com/sahina/ironflow-issues/issues"
   },
   "repository": {
     "type": "git",