@ironflow/browser 0.1.0-test.2 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @ironflow/browser
 
-Browser client for [Ironflow](https://github.com/anthropics/ironflow) workflow engine. Provides real-time subscriptions, workflow triggers, and event emission for web applications.
+Browser client for [Ironflow](https://github.com/sahina/ironflow), an event-driven backend platform. Provides real-time subscriptions, workflow triggers, and event emission for web applications.
 
 ## Installation
 
@@ -29,7 +29,7 @@ const run = await ironflow.trigger('process-order', {
 });
 
 // Emit events
-await ironflow.emit('order.approved', { orderId: '123' });
+await ironflow.emit('order.approved', { orderId: '123' }, { version: 1 });
 
 // Cleanup
 sub.unsubscribe();
@@ -51,7 +51,7 @@ sub.unsubscribe();
 | `ironflow.connect()` | Connect to the server |
 | `ironflow.subscribe(pattern, options)` | Subscribe to events |
 | `ironflow.trigger(functionId, options)` | Trigger a workflow |
-| `ironflow.emit(eventName, data)` | Emit an event |
+| `ironflow.emit(eventName, data, options?)` | Emit an event |
 | `ironflow.getRun(runId)` | Get run status |
 
 ## Browser Compatibility

package/dist/client.d.ts

@@ -3,9 +3,11 @@
  *
  * Singleton client for browser-based real-time interactions with Ironflow.
  */
-import type { Run, ListRunsOptions, ListRunsResult, TriggerResult, EmitOptions, EmitResult, SubscriptionErrorInfo, SubscriptionCallbacks, Subscription, AckableSubscription, ConnectionState } from "@ironflow/core";
+import type { Run, ListRunsOptions, ListRunsResult, TriggerResult, EmitOptions, EmitResult, SubscriptionErrorInfo, SubscriptionCallbacks, Subscription, AckableSubscription, ConnectionState, AppendEventInput, AppendOptions, AppendResult, ReadStreamOptions, StreamEvent, StreamInfo, EntitySubscribeOptions, GetProjectionOptions, RebuildProjectionOptions, ProjectionStatusInfo, ProjectionStateResult, ProjectionSubscriptionCallbacks } from "@ironflow/core";
 import type { IronflowConfig, IronflowConfigOptions } from "./config.js";
 import { type BrowserSubscribeOptions, type SubscriptionGroup } from "./subscription.js";
+import { BrowserKVClient } from "./kv.js";
+import { BrowserConfigClient } from "./config-client.js";
 /**
  * Ironflow browser client singleton
  */
@@ -125,6 +127,42 @@ declare class IronflowClient {
      * Cancel a running run
      */
     cancelRun(runId: string, reason?: string): Promise<Run>;
+    /**
+     * Retry a failed run
+     */
+    retryRun(runId: string, fromStep?: string): Promise<Run>;
+    /**
+     * Patch a step's output (hot patching)
+     */
+    patchStep(stepId: string, output: Record<string, unknown>, reason?: string): Promise<void>;
+    /**
+     * Resume a paused or failed run
+     */
+    resumeRun(runId: string, fromStep?: string): Promise<Run>;
+    /**
+     * List registered functions
+     */
+    listFunctions(): Promise<unknown[]>;
+    /**
+     * List connected workers
+     */
+    listWorkers(): Promise<unknown[]>;
+    /**
+     * Health check
+     */
+    health(): Promise<{
+        status: string;
+        timestamp: string;
+        version: string;
+    }>;
+    /**
+     * Get server capabilities
+     */
+    getCapabilities(): Promise<{
+        transports: string[];
+        features: string[];
+        version: string;
+    }>;
     /**
      * Emit an event
      *
@@ -141,6 +179,163 @@ declare class IronflowClient {
      * Join a consumer group for load-balanced event processing
      */
     joinConsumerGroup<T = unknown>(groupName: string, pattern: string, callbacksAndOptions: SubscriptionCallbacks<T> & BrowserSubscribeOptions): Promise<AckableSubscription>;
+    /**
+     * Entity stream operations
+     *
+     * @example
+     * ```typescript
+     * // Append an event to a stream
+     * const result = await ironflow.streams.append("order-123", {
+     *   name: "order.created",
+     *   data: { total: 100 },
+     *   entityType: "order",
+     * });
+     *
+     * // Read events from a stream
+     * const { events } = await ironflow.streams.read("order-123", { limit: 10 });
+     *
+     * // Get stream info
+     * const info = await ironflow.streams.getInfo("order-123");
+     * ```
+     */
+    streams: {
+        /**
+         * Append an event to an entity stream
+         */
+        append: (entityId: string, input: AppendEventInput, options?: AppendOptions) => Promise<AppendResult>;
+        /**
+         * Read events from an entity stream
+         */
+        read: (entityId: string, options?: ReadStreamOptions) => Promise<{
+            events: StreamEvent[];
+            totalCount: number;
+        }>;
+        /**
+         * Get information about an entity stream
+         */
+        getInfo: (entityId: string) => Promise<StreamInfo>;
+        /**
+         * Subscribe to real-time events for an entity stream
+         *
+         * @example
+         * ```typescript
+         * const sub = await ironflow.streams.subscribe("order-123", {
+         *   entityType: "order",
+         *   onEvent: (event) => console.log(event),
+         *   replay: 100,
+         * });
+         *
+         * // Cleanup
+         * sub.unsubscribe();
+         * ```
+         */
+        subscribe: (entityId: string, options: EntitySubscribeOptions) => Promise<Subscription>;
+    };
+    /**
+     * Get the current state of a projection
+     *
+     * @example
+     * ```typescript
+     * const result = await ironflow.getProjection<OrderStats>('order-stats');
+     * console.log(result.state); // { totalOrders: 42, ... }
+     *
+     * // With partition
+     * const result = await ironflow.getProjection('order-stats', { partition: 'customer-123' });
+     * ```
+     */
+    getProjection<TState = unknown>(name: string, options?: GetProjectionOptions): Promise<ProjectionStateResult<TState>>;
+    /**
+     * Get the status of a projection
+     *
+     * @example
+     * ```typescript
+     * const status = await ironflow.getProjectionStatus('order-stats');
+     * console.log(status.status); // 'active' | 'rebuilding' | 'paused' | 'error'
+     * ```
+     */
+    getProjectionStatus(name: string): Promise<ProjectionStatusInfo>;
+    /**
+     * Trigger a rebuild of a projection
+     *
+     * @example
+     * ```typescript
+     * const result = await ironflow.rebuildProjection('order-stats');
+     * ```
+     */
+    rebuildProjection(name: string, options?: RebuildProjectionOptions): Promise<{
+        status: string;
+    }>;
+    /**
+     * List all registered projections
+     *
+     * @example
+     * ```typescript
+     * const projections = await ironflow.listProjections();
+     * projections.forEach(p => console.log(p.name, p.status));
+     * ```
+     */
+    listProjections(): Promise<ProjectionStatusInfo[]>;
+    /**
+     * Subscribe to real-time updates for a projection
+     *
+     * @example
+     * ```typescript
+     * const sub = await ironflow.subscribeToProjection<OrderStats>('order-stats', {
+     *   onUpdate: (state, event) => console.log('Updated:', state),
+     *   onError: (error) => console.error(error),
+     * });
+     *
+     * // With partition
+     * const sub = await ironflow.subscribeToProjection('order-stats', {
+     *   onUpdate: (state, event) => console.log('Updated:', state),
+     * }, { partition: 'customer-123' });
+     *
+     * // Cleanup
+     * sub.unsubscribe();
+     * ```
+     */
+    subscribeToProjection<TState = unknown>(name: string, callbacks: ProjectionSubscriptionCallbacks<TState>, options?: {
+        partition?: string;
+        replay?: number;
+    }): Promise<Subscription>;
+    /**
+     * KV store operations
+     *
+     * @example
+     * ```typescript
+     * const kv = ironflow.kv();
+     * const bucket = await kv.createBucket({ name: "sessions", ttlSeconds: 3600 });
+     * const handle = kv.bucket("sessions");
+     * const { revision } = await handle.put("user.123", { token: "abc" });
+     * const entry = await handle.get("user.123");
+     *
+     * // Watch for changes
+     * const watcher = handle.watch({
+     *   onUpdate: (event) => console.log(event),
+     * }, { key: "user.*" });
+     * ```
+     */
+    kv(): BrowserKVClient;
+    /**
+     * Config management operations
+     *
+     * @example
+     * ```typescript
+     * const cfg = ironflow.configManager();
+     * await cfg.set("app", { featureX: true, maxRetries: 3 });
+     * const { data, revision } = await cfg.get("app");
+     * await cfg.patch("app", { maxRetries: 5 });
+     * const configs = await cfg.list();
+     * await cfg.delete("app");
+     *
+     * // Watch for changes
+     * const sub = await cfg.watch("app", {
+     *   onEvent: (config) => console.log(config),
+     * });
+     * sub.unsubscribe();
+     * ```
+     */
+    configManager(): BrowserConfigClient;
     /**
      * Pattern helpers for building subscription patterns
      */
@@ -156,8 +351,14 @@ declare class IronflowClient {
     };
     private ensureConfigured;
     private cleanup;
+    /**
+     * Reset client state for testing. Not intended for production use.
+     * @internal
+     */
+    _resetForTesting(): void;
     private setupVisibilityHandling;
     private request;
+    private streamRequest;
     private mapRunResponse;
 }
 /**

package/dist/client.d.ts.map

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