@callbag-recharge/callbag-recharge 0.20.0 → 0.22.0

package/dist/chunk-5PWKJDS3.js

@@ -0,0 +1 @@
+function m(r){let c=r?.failureThreshold??5,t=r?.cooldownMs??3e4,o=r?.cooldown??null,i=r?.halfOpenMax??1,f=r?.now??Date.now,e="closed",n=0,a=0,s=0,d=t,u=0;function b(){if(!o)return t;let l=o(a);return l!==null?l:t}function p(){e="open",d=b(),s=f(),u=0}return{canExecute(){return e==="closed"?!0:e==="open"?f()-s>=d?(e="half-open",u=1,!0):!1:u<i?(u++,!0):!1},recordSuccess(){e==="half-open"?(e="closed",n=0,a=0):e==="closed"&&(n=0)},recordFailure(l){if(e==="half-open"){a++,p();return}e==="closed"&&(n++,n>=c&&p())},get state(){return e},get failureCount(){return n},reset(){e="closed",n=0,a=0,u=0}}}function h(r){return(c,t)=>{if(c!==0)return;let o=!1;t(0,i=>{i===2&&(o=!0)}),r.onsuccess=()=>{o||(o=!0,t(1,r.result),t(2))},r.onerror=()=>{o||(o=!0,t(2,r.error))}}}export{h as a,m as b};

package/dist/chunk-DHPPL5V6.js

@@ -0,0 +1 @@
+import{a as z}from"./chunk-JCENQEPP.js";import{a as W}from"./chunk-ZJCF5NYF.js";import{a as b}from"./chunk-PV347CGV.js";import{a as E}from"./chunk-GMLWTZFM.js";import{a as A}from"./chunk-EAK2HKAD.js";import{B as S,v as w}from"./chunk-TUPD47IE.js";function k(i){let a=i?.halfLife??864e5,m=i?.recency??1,p=i?.importance??1,T=i?.frequency??.5,y=Math.LN2/a;return(t,f)=>{let l=(f??Date.now())-t.accessedAt,u=Math.exp(-y*l),s=1-1/(1+t.accessCount);return m*u+p*t.importance+T*s}}function v(i,a,m){let p=a?.halfLife??864e5,T=a?.recency??1,y=a?.importance??1,t=a?.frequency??.5,f=(m??Date.now())-i.accessedAt,l=Math.exp(-Math.LN2/p*f),u=1-1/(1+i.accessCount);return T*l+y*i.importance+t*u}var O=0;function q(){return`mem-${++O}`}function L(i,a){let m=a?.id??q(),p=Date.now(),T={id:m,createdAt:p,updatedAt:p,accessedAt:p,accessCount:0,importance:a?.importance??.5,tags:new Set(a?.tags)},y=A(i,{name:`mem:${m}:content`}),t=A(T,{name:`mem:${m}:meta`,equals:()=>!1}),f={},l=b([t],()=>v(t.get(),f),{name:`mem:${m}:score`});return{id:m,content:y,meta:t,scoreStore:l,touch(){let s=Date.now();t.update(d=>({...d,accessedAt:s,accessCount:d.accessCount+1}))},tag(...s){t.update(d=>{let h=new Set(d.tags);for(let M of s)h.add(M);return{...d,tags:h,updatedAt:Date.now()}})},untag(...s){t.update(d=>{let h=new Set(d.tags);for(let M of s)h.delete(M);return{...d,tags:h,updatedAt:Date.now()}})},setImportance(s){t.update(d=>({...d,importance:Math.max(0,Math.min(1,s)),updatedAt:Date.now()}))},update(s){w(()=>{y.set(s),t.update(d=>({...d,updatedAt:Date.now()}))})},score(s){return v(t.get(),s??f)},destroy(){S(y),S(t)}}}var P=0;function oe(i){let a=++P,m=i?.maxSize??1/0,p=i?.weights??{},T=i?.admissionPolicy,y=i?.forgetPolicy,t=new Map,f=W(),l=new Map,u=m<1/0?z(e=>t.get(e).meta,e=>v(e,p)):null,s=A(0,{name:`collection-${a}:ver`}),d=b([s],()=>Array.from(t.values()),{name:`collection-${a}:nodes`}),h=b([s],()=>t.size,{name:`collection-${a}:size`}),M=!1;function _(){s.update(e=>e+1)}function x(e){let o=Array.from(e.meta.get().tags);f.update(e.id,o);let r=E(e.meta,I=>{let n=Array.from(I.tags);f.update(e.id,n)});l.set(e.id,()=>r.unsubscribe())}function D(e){let o=l.get(e);o&&(o(),l.delete(e)),f.remove(e)}function $(){if(!u||t.size<=m)return;let e=u.evict(t.size-m);for(let o of e){let r=t.get(o);r&&(D(o),r.destroy(),t.delete(o))}}function C(){if(!y)return 0;let e=[];for(let o of t.values())y(o)&&e.push(o.id);for(let o of e){let r=t.get(o);r&&(D(o),u?.delete(o),r.destroy(),t.delete(o))}return e.length}return{add(e,o){if(M)throw new Error("Collection is destroyed");if(T){let I=Array.from(t.values()),n=T(e,I);switch(n.action){case"reject":return;case"update":{let c=t.get(n.targetId);if(!c)throw new Error(`Admission update target "${n.targetId}" not found`);return c.update(n.content),c}case"merge":{let c=t.get(n.targetId);if(!c)throw new Error(`Admission merge target "${n.targetId}" not found`);let g=n.reducer(c.content.get(),e);return c.update(g),c}default:break}}y&&C();let r=L(e,o);return t.set(r.id,r),x(r),u?.insert(r.id),$(),_(),r},remove(e){let o=typeof e=="string"?e:e.id,r=t.get(o);return r?(D(o),u?.delete(o),r.destroy(),t.delete(o),_(),!0):!1},get(e){return t.get(e)},has(e){return t.has(e)},nodes:d,size:h,tagIndex:f,query(e){let o=[];for(let r of t.values())e(r)&&o.push(r);return o},byTag(e){let o=f.get(e),r=[];for(let I of o){let n=t.get(I);n&&r.push(n)}return r},topK(e,o){let r=o??p,I=Date.now(),n=Array.from(t.values()).map(c=>({node:c,score:v(c.meta.get(),r,I)}));return n.sort((c,g)=>g.score-c.score),n.slice(0,e).map(c=>c.node)},summarize(e,o,r){if(M)throw new Error("Collection is destroyed");let I=Array.from(new Set(e)),n=[];for(let N of I){let F=t.get(N);F&&n.push(F)}if(n.length===0)throw new Error("No valid nodes to summarize");let c=o(n),g;return w(()=>{for(let N of n)D(N.id),u?.delete(N.id),N.destroy(),t.delete(N.id);y&&C(),g=L(c,r),t.set(g.id,g),x(g),u?.insert(g.id),_()}),g},gc(){if(M)throw new Error("Collection is destroyed");let e=C();return e>0&&_(),e},destroy(){if(!M){M=!0,u?.clear();for(let e of l.values())e();l.clear(),f.destroy(),w(()=>{for(let e of t.values())e.destroy();t.clear()}),S(s)}}}}export{k as a,v as b,L as c,oe as d};

package/dist/chunk-VCD3MXHY.js

@@ -0,0 +1 @@
+import{a as g}from"./chunk-QSFTSBDR.js";import{a as u}from"./chunk-EAK2HKAD.js";import{B as m}from"./chunk-TUPD47IE.js";function A(b,d){let h=Math.max(1,d?.concurrency??1),S=d?.strategy??"fifo",s=d?.name??"asyncQueue",a=u(0,{name:`${s}.size`}),c=u(0,{name:`${s}.running`}),p=u(0,{name:`${s}.completed`}),k=u(0,{name:`${s}.failed`}),l=u(!1,{name:`${s}.paused`}),t=[],o=0,i=!1;function T(n,e){i||(o--,c.set(o),p.update(r=>r+1),n.done$.set({ok:!0,result:e}),f())}function y(n,e){i||(o--,c.set(o),k.update(r=>r+1),n.done$.set({ok:!1,error:e}),f())}function f(){if(!(i||l.get()))for(;o<h&&t.length>0;){let n=S==="lifo"?t.pop():t.shift();a.set(t.length),o++,c.set(o);try{b(n.task).then(e=>T(n,e),e=>y(n,e))}catch(e){y(n,e)}}}function Q(n){if(i)return Promise.reject(new Error("Queue is disposed"));let e=u(null,{name:`${s}.task`});return t.push({task:n,done$:e}),a.set(t.length),f(),g(e,r=>r!==null).then(r=>{if(m(e),r.ok)return r.result;throw r.error},r=>{throw m(e),r})}function $(){l.set(!0)}function v(){l.set(!1),f()}function R(){let n=t.splice(0,t.length);a.set(0);for(let e of n)e.done$.set({ok:!1,error:new Error("Queue cleared")})}function w(){i||(i=!0,R())}return{enqueue:Q,size:a,running:c,completed:p,failed:k,pause:$,resume:v,paused:l,clear:R,dispose:w}}export{A as a};

package/dist/data/index.d.cts

@@ -1,9 +1,34 @@
-import { P as PubSub, a as PubSubSnapshot, R as ReactiveIndex, I as IndexSnapshot, N as NodeV0, L as ListSnapshot, b as ReactiveLogOptions, c as ReactiveLog, d as LogSnapshot, e as ReactiveMapOptions, f as ReactiveMap, M as MapSnapshot } from '../types-CrTRz6Oy.cjs';
-export { K as KVEvent, g as KVEventType, h as LogEntry, i as LogEvent, j as LogEventType, k as ReactiveIndexOptions } from '../types-CrTRz6Oy.cjs';
+import { P as PubSub, b as PubSubSnapshot, R as ReactiveIndex, I as IndexSnapshot, N as NodeV0, L as ListSnapshot, c as ReactiveLogOptions, a as ReactiveLog, d as LogSnapshot, e as ReactiveMapOptions, f as ReactiveMap, M as MapSnapshot } from '../types-BRnNQbJn.cjs';
+export { K as KVEvent, g as KVEventType, h as LogEntry, i as LogEvent, j as LogEventType, k as ReactiveIndexOptions } from '../types-BRnNQbJn.cjs';
 import { S as Store } from '../types-BohB8jJr.cjs';
 import '../eviction-DGPP1vHP.cjs';
 import '../protocol-fwiQ1TAS.cjs';
 
+/**
+ * Creates a lightweight topic-based publish/subscribe channel.
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `PubSub<T>` — topic publish/subscribe API with snapshot and lifecycle methods.
+ *
+ * @remarks **Lazy channels:** Topics are created on first publish/subscribe.
+ * @remarks **Reactive subscription:** `subscribe(topic)` returns a read-only store for latest topic value.
+ * @remarks **Ephemeral emission semantics:** Message updates always emit, even for referentially equal values.
+ *
+ * @example
+ * ```ts
+ * import { pubsub } from "callbag-recharge/data";
+ *
+ * const bus = pubsub<string>();
+ * const chat = bus.subscribe("chat");
+ *
+ * bus.publish("chat", "hello");
+ * chat.get(); // "hello"
+ * ```
+ *
+ * @seeAlso [topic](/api/topic), [subscription](/api/subscription), [reactiveMap](./reactiveMap)
+ * @category data
+ */
 declare function pubsub<T = unknown>(opts?: {
     id?: string;
 }): PubSub<T>;
@@ -15,6 +40,39 @@ interface ReactiveIndexCreateOptions {
     /** User-specified ID. Auto-generated if omitted. */
     id?: string;
 }
+/**
+ * Creates a reactive secondary index from index key to sets of primary keys.
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `ReactiveIndex` — reverse mapping queries, reactive selectors, mutation helpers, and snapshot APIs.
+ *
+ * @remarks **Reverse map:** Tracks primary key to index keys for efficient `remove()` and `update()`.
+ * @remarks **Reactive selectors:** `select(indexKey)` returns cached stores for index-key membership updates.
+ * @remarks **Structural versioning:** `keysStore`/`sizeStore` are version-gated and update on keyset changes.
+ *
+ * @example
+ * ```ts
+ * import { reactiveIndex } from "callbag-recharge/data";
+ *
+ * const byTag = reactiveIndex();
+ * byTag.add("u1", ["admin", "active"]);
+ * byTag.get("admin"); // Set { "u1" }
+ * ```
+ *
+ * @example Update indexed keys
+ * ```ts
+ * const byTag = reactiveIndex();
+ * byTag.add("u1", ["admin"]);
+ * byTag.update("u1", ["editor"]);
+ *
+ * byTag.get("admin").size; // 0
+ * byTag.get("editor").size; // 1
+ * ```
+ *
+ * @seeAlso [reactiveMap](./reactiveMap), [reactiveList](./reactiveList), [pubsub](./pubsub)
+ * @category data
+ */
 declare function reactiveIndex(opts?: ReactiveIndexCreateOptions): ReactiveIndex;
 declare namespace reactiveIndex {
     var from: (snap: IndexSnapshot) => ReactiveIndex;
@@ -135,6 +193,38 @@ declare namespace reactiveLog {
     var from: <V>(snap: LogSnapshot<V>, opts?: Omit<ReactiveLogOptions, "id">) => ReactiveLog<V>;
 }
 
+/**
+ * Creates a reactive key-value store with point reads, reactive selects, and optional TTL.
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `ReactiveMap<V>` — key-value operations, reactive views, events, and lifecycle controls.
+ *
+ * @remarks **Single source of truth:** Internal `Map` is authoritative; reactive stores mirror map state.
+ * @remarks **Reactive views:** `select(key)`, `keysStore`, and `sizeStore` update through graph propagation.
+ * @remarks **TTL + eviction:** Supports per-key/default TTL and optional bounded-size eviction policies.
+ *
+ * @example
+ * ```ts
+ * import { reactiveMap } from "callbag-recharge/data";
+ *
+ * const users = reactiveMap<{ name: string }>();
+ * users.set("u1", { name: "Ada" });
+ * users.get("u1"); // { name: "Ada" }
+ * ```
+ *
+ * @example Reactive key subscription
+ * ```ts
+ * const users = reactiveMap<number>();
+ * const score = users.select("u1");
+ *
+ * users.set("u1", 10);
+ * score.get(); // 10
+ * ```
+ *
+ * @seeAlso [reactiveIndex](./reactiveIndex), [reactiveLog](./reactiveLog), [compaction](./compaction)
+ * @category data
+ */
 declare function reactiveMap<V>(opts?: ReactiveMapOptions<V>): ReactiveMap<V>;
 declare namespace reactiveMap {
     var from: <V>(snap: MapSnapshot<V>, opts?: Omit<ReactiveMapOptions<V>, "id">) => ReactiveMap<V>;

package/dist/data/index.d.ts

@@ -1,9 +1,34 @@
-import { P as PubSub, a as PubSubSnapshot, R as ReactiveIndex, I as IndexSnapshot, N as NodeV0, L as ListSnapshot, b as ReactiveLogOptions, c as ReactiveLog, d as LogSnapshot, e as ReactiveMapOptions, f as ReactiveMap, M as MapSnapshot } from '../types-Ds0-O16t.js';
-export { K as KVEvent, g as KVEventType, h as LogEntry, i as LogEvent, j as LogEventType, k as ReactiveIndexOptions } from '../types-Ds0-O16t.js';
+import { P as PubSub, b as PubSubSnapshot, R as ReactiveIndex, I as IndexSnapshot, N as NodeV0, L as ListSnapshot, c as ReactiveLogOptions, a as ReactiveLog, d as LogSnapshot, e as ReactiveMapOptions, f as ReactiveMap, M as MapSnapshot } from '../types-n54oEEx_.js';
+export { K as KVEvent, g as KVEventType, h as LogEntry, i as LogEvent, j as LogEventType, k as ReactiveIndexOptions } from '../types-n54oEEx_.js';
 import { S as Store } from '../types-CB1htCM8.js';
 import '../eviction-DGPP1vHP.js';
 import '../protocol-fwiQ1TAS.js';
 
+/**
+ * Creates a lightweight topic-based publish/subscribe channel.
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `PubSub<T>` — topic publish/subscribe API with snapshot and lifecycle methods.
+ *
+ * @remarks **Lazy channels:** Topics are created on first publish/subscribe.
+ * @remarks **Reactive subscription:** `subscribe(topic)` returns a read-only store for latest topic value.
+ * @remarks **Ephemeral emission semantics:** Message updates always emit, even for referentially equal values.
+ *
+ * @example
+ * ```ts
+ * import { pubsub } from "callbag-recharge/data";
+ *
+ * const bus = pubsub<string>();
+ * const chat = bus.subscribe("chat");
+ *
+ * bus.publish("chat", "hello");
+ * chat.get(); // "hello"
+ * ```
+ *
+ * @seeAlso [topic](/api/topic), [subscription](/api/subscription), [reactiveMap](./reactiveMap)
+ * @category data
+ */
 declare function pubsub<T = unknown>(opts?: {
     id?: string;
 }): PubSub<T>;
@@ -15,6 +40,39 @@ interface ReactiveIndexCreateOptions {
     /** User-specified ID. Auto-generated if omitted. */
     id?: string;
 }
+/**
+ * Creates a reactive secondary index from index key to sets of primary keys.
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `ReactiveIndex` — reverse mapping queries, reactive selectors, mutation helpers, and snapshot APIs.
+ *
+ * @remarks **Reverse map:** Tracks primary key to index keys for efficient `remove()` and `update()`.
+ * @remarks **Reactive selectors:** `select(indexKey)` returns cached stores for index-key membership updates.
+ * @remarks **Structural versioning:** `keysStore`/`sizeStore` are version-gated and update on keyset changes.
+ *
+ * @example
+ * ```ts
+ * import { reactiveIndex } from "callbag-recharge/data";
+ *
+ * const byTag = reactiveIndex();
+ * byTag.add("u1", ["admin", "active"]);
+ * byTag.get("admin"); // Set { "u1" }
+ * ```
+ *
+ * @example Update indexed keys
+ * ```ts
+ * const byTag = reactiveIndex();
+ * byTag.add("u1", ["admin"]);
+ * byTag.update("u1", ["editor"]);
+ *
+ * byTag.get("admin").size; // 0
+ * byTag.get("editor").size; // 1
+ * ```
+ *
+ * @seeAlso [reactiveMap](./reactiveMap), [reactiveList](./reactiveList), [pubsub](./pubsub)
+ * @category data
+ */
 declare function reactiveIndex(opts?: ReactiveIndexCreateOptions): ReactiveIndex;
 declare namespace reactiveIndex {
     var from: (snap: IndexSnapshot) => ReactiveIndex;
@@ -135,6 +193,38 @@ declare namespace reactiveLog {
     var from: <V>(snap: LogSnapshot<V>, opts?: Omit<ReactiveLogOptions, "id">) => ReactiveLog<V>;
 }
 
+/**
+ * Creates a reactive key-value store with point reads, reactive selects, and optional TTL.
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `ReactiveMap<V>` — key-value operations, reactive views, events, and lifecycle controls.
+ *
+ * @remarks **Single source of truth:** Internal `Map` is authoritative; reactive stores mirror map state.
+ * @remarks **Reactive views:** `select(key)`, `keysStore`, and `sizeStore` update through graph propagation.
+ * @remarks **TTL + eviction:** Supports per-key/default TTL and optional bounded-size eviction policies.
+ *
+ * @example
+ * ```ts
+ * import { reactiveMap } from "callbag-recharge/data";
+ *
+ * const users = reactiveMap<{ name: string }>();
+ * users.set("u1", { name: "Ada" });
+ * users.get("u1"); // { name: "Ada" }
+ * ```
+ *
+ * @example Reactive key subscription
+ * ```ts
+ * const users = reactiveMap<number>();
+ * const score = users.select("u1");
+ *
+ * users.set("u1", 10);
+ * score.get(); // 10
+ * ```
+ *
+ * @seeAlso [reactiveIndex](./reactiveIndex), [reactiveLog](./reactiveLog), [compaction](./compaction)
+ * @category data
+ */
 declare function reactiveMap<V>(opts?: ReactiveMapOptions<V>): ReactiveMap<V>;
 declare namespace reactiveMap {
     var from: <V>(snap: MapSnapshot<V>, opts?: Omit<ReactiveMapOptions<V>, "id">) => ReactiveMap<V>;

package/dist/executionLog-CREljpYk.d.cts

@@ -0,0 +1,104 @@
+import { S as Store } from './types-BohB8jJr.cjs';
+import { a as ReactiveLog } from './types-BRnNQbJn.cjs';
+
+type ExecutionEventType = "start" | "value" | "complete" | "error";
+interface ExecutionEntry {
+    /** Step name (or pipeline-level event). */
+    step: string;
+    /** Event type. */
+    event: ExecutionEventType;
+    /** Timestamp (ms since epoch). */
+    timestamp: number;
+    /** Value payload (for "value" events). */
+    value?: unknown;
+    /** Error payload (for "error" events). */
+    error?: unknown;
+    /** Run count at time of event. */
+    runCount?: number;
+}
+interface ExecutionLogPersistAdapter {
+    /** Append an entry to persistent storage. May be sync or async. */
+    append(entry: ExecutionEntry): void | Promise<void>;
+    /** Load all persisted entries. */
+    load(): ExecutionEntry[] | Promise<ExecutionEntry[]>;
+    /** Clear all persisted entries. */
+    clear(): void | Promise<void>;
+}
+interface ExecutionLogOptions {
+    /** Maximum number of entries to keep in memory. Default: unlimited. */
+    maxSize?: number;
+    /** Debug name. */
+    name?: string;
+    /** Optional persistence adapter. Entries are written through on append. */
+    persist?: ExecutionLogPersistAdapter;
+}
+interface ExecutionLogResult {
+    /** The underlying reactive log. */
+    log: ReactiveLog<ExecutionEntry>;
+    /** Append an execution event. */
+    append(entry: ExecutionEntry): number;
+    /** Get all entries for a specific step. */
+    forStep(step: string): ExecutionEntry[];
+    /** Reactive store: latest entry. */
+    latest: Store<ExecutionEntry | undefined>;
+    /** Reactive store: entry count. */
+    length: Store<number>;
+    /** Reactive store: last persist error (null when healthy). */
+    persistError: Store<unknown>;
+    /** Clear the log. */
+    clear(): void;
+    /** Destroy the log and clean up. */
+    destroy(): void;
+    /**
+     * Connect to a pipeline's stepMeta stores for auto-logging.
+     * Returns an unsubscribe function.
+     */
+    connectPipeline(stepMeta: Record<string, Store<any>>, stepNames: string[]): () => void;
+}
+/**
+ * Creates a reactive execution log for workflow step tracking. Backed by `reactiveLog` (Phase 3b).
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `ExecutionLogResult` — reactive log with step filtering, pipeline auto-connect, and optional persistence.
+ *
+ * @returnsTable log | ReactiveLog\<ExecutionEntry\> | Underlying reactive log.
+ * append(entry) | (entry) => number | Append an execution event.
+ * forStep(step) | (step) => ExecutionEntry[] | Get entries for a specific step.
+ * latest | Store\<ExecutionEntry \| undefined\> | Reactive latest entry.
+ * length | Store\<number\> | Reactive entry count.
+ * persistError | Store\<unknown\> | Last persist error (null when healthy).
+ * connectPipeline(stepMeta, names) | (...) => () => void | Auto-log pipeline step events.
+ * clear() | () => void | Clear the log.
+ * destroy() | () => void | Destroy and clean up.
+ *
+ * @remarks **Auto-logging:** `connectPipeline()` subscribes to per-step metadata stores and auto-appends start/value/complete/error events.
+ * @remarks **Persistence:** Optional adapter writes through on every append. Load on construction for recovery.
+ * @remarks **Bounded:** Set `maxSize` for production to prevent unbounded memory growth.
+ *
+ * @example
+ * ```ts
+ * import { executionLog } from 'callbag-recharge/orchestrate';
+ * import { pipeline, step, fromTrigger } from 'callbag-recharge/orchestrate';
+ *
+ * const log = executionLog({ maxSize: 500 });
+ * const wf = pipeline({
+ *   trigger: step(fromTrigger<number>()),
+ * });
+ * const unsub = log.connectPipeline(wf.stepMeta, wf.order);
+ * // Events auto-logged as pipeline runs
+ * log.forStep("trigger"); // all events for "trigger" step
+ * unsub();
+ * ```
+ *
+ * @seeAlso [pipeline](./pipeline) — workflow builder, [reactiveLog](./reactiveLog) — underlying data structure
+ *
+ * @category orchestrate
+ */
+declare function executionLog(opts?: ExecutionLogOptions): ExecutionLogResult;
+/**
+ * In-memory execution log persistence adapter. Useful for testing.
+ */
+declare function memoryLogAdapter(): ExecutionLogPersistAdapter;
+
+export { type ExecutionLogPersistAdapter as E, type ExecutionEntry as a, type ExecutionEventType as b, type ExecutionLogOptions as c, type ExecutionLogResult as d, executionLog as e, memoryLogAdapter as m };

package/dist/executionLog-cGvVp5Ha.d.ts

@@ -0,0 +1,104 @@
+import { S as Store } from './types-CB1htCM8.js';
+import { a as ReactiveLog } from './types-n54oEEx_.js';
+
+type ExecutionEventType = "start" | "value" | "complete" | "error";
+interface ExecutionEntry {
+    /** Step name (or pipeline-level event). */
+    step: string;
+    /** Event type. */
+    event: ExecutionEventType;
+    /** Timestamp (ms since epoch). */
+    timestamp: number;
+    /** Value payload (for "value" events). */
+    value?: unknown;
+    /** Error payload (for "error" events). */
+    error?: unknown;
+    /** Run count at time of event. */
+    runCount?: number;
+}
+interface ExecutionLogPersistAdapter {
+    /** Append an entry to persistent storage. May be sync or async. */
+    append(entry: ExecutionEntry): void | Promise<void>;
+    /** Load all persisted entries. */
+    load(): ExecutionEntry[] | Promise<ExecutionEntry[]>;
+    /** Clear all persisted entries. */
+    clear(): void | Promise<void>;
+}
+interface ExecutionLogOptions {
+    /** Maximum number of entries to keep in memory. Default: unlimited. */
+    maxSize?: number;
+    /** Debug name. */
+    name?: string;
+    /** Optional persistence adapter. Entries are written through on append. */
+    persist?: ExecutionLogPersistAdapter;
+}
+interface ExecutionLogResult {
+    /** The underlying reactive log. */
+    log: ReactiveLog<ExecutionEntry>;
+    /** Append an execution event. */
+    append(entry: ExecutionEntry): number;
+    /** Get all entries for a specific step. */
+    forStep(step: string): ExecutionEntry[];
+    /** Reactive store: latest entry. */
+    latest: Store<ExecutionEntry | undefined>;
+    /** Reactive store: entry count. */
+    length: Store<number>;
+    /** Reactive store: last persist error (null when healthy). */
+    persistError: Store<unknown>;
+    /** Clear the log. */
+    clear(): void;
+    /** Destroy the log and clean up. */
+    destroy(): void;
+    /**
+     * Connect to a pipeline's stepMeta stores for auto-logging.
+     * Returns an unsubscribe function.
+     */
+    connectPipeline(stepMeta: Record<string, Store<any>>, stepNames: string[]): () => void;
+}
+/**
+ * Creates a reactive execution log for workflow step tracking. Backed by `reactiveLog` (Phase 3b).
+ *
+ * @param opts - Optional configuration.
+ *
+ * @returns `ExecutionLogResult` — reactive log with step filtering, pipeline auto-connect, and optional persistence.
+ *
+ * @returnsTable log | ReactiveLog\<ExecutionEntry\> | Underlying reactive log.
+ * append(entry) | (entry) => number | Append an execution event.
+ * forStep(step) | (step) => ExecutionEntry[] | Get entries for a specific step.
+ * latest | Store\<ExecutionEntry \| undefined\> | Reactive latest entry.
+ * length | Store\<number\> | Reactive entry count.
+ * persistError | Store\<unknown\> | Last persist error (null when healthy).
+ * connectPipeline(stepMeta, names) | (...) => () => void | Auto-log pipeline step events.
+ * clear() | () => void | Clear the log.
+ * destroy() | () => void | Destroy and clean up.
+ *
+ * @remarks **Auto-logging:** `connectPipeline()` subscribes to per-step metadata stores and auto-appends start/value/complete/error events.
+ * @remarks **Persistence:** Optional adapter writes through on every append. Load on construction for recovery.
+ * @remarks **Bounded:** Set `maxSize` for production to prevent unbounded memory growth.
+ *
+ * @example
+ * ```ts
+ * import { executionLog } from 'callbag-recharge/orchestrate';
+ * import { pipeline, step, fromTrigger } from 'callbag-recharge/orchestrate';
+ *
+ * const log = executionLog({ maxSize: 500 });
+ * const wf = pipeline({
+ *   trigger: step(fromTrigger<number>()),
+ * });
+ * const unsub = log.connectPipeline(wf.stepMeta, wf.order);
+ * // Events auto-logged as pipeline runs
+ * log.forStep("trigger"); // all events for "trigger" step
+ * unsub();
+ * ```
+ *
+ * @seeAlso [pipeline](./pipeline) — workflow builder, [reactiveLog](./reactiveLog) — underlying data structure
+ *
+ * @category orchestrate
+ */
+declare function executionLog(opts?: ExecutionLogOptions): ExecutionLogResult;
+/**
+ * In-memory execution log persistence adapter. Useful for testing.
+ */
+declare function memoryLogAdapter(): ExecutionLogPersistAdapter;
+
+export { type ExecutionLogPersistAdapter as E, type ExecutionEntry as a, type ExecutionEventType as b, type ExecutionLogOptions as c, type ExecutionLogResult as d, executionLog as e, memoryLogAdapter as m };

package/dist/index.js

@@ -1 +1 @@
-import{a as A}from"./chunk-DIXN33QZ.js";import{a as R}from"./chunk-2ZFSL4MA.js";import{a as D}from"./chunk-BWH53TL4.js";import{a as b}from"./chunk-YBVQC3GP.js";import{a as u}from"./chunk-PV347CGV.js";import"./chunk-HK7DRUNM.js";import{a as v}from"./chunk-GMLWTZFM.js";import{a as g}from"./chunk-EAK2HKAD.js";import{i as O}from"./chunk-2F6QWERG.js";import{a as l}from"./chunk-2L6223KN.js";import{A as E,B as T,a as e,b as r,d as t,e as o,f as p,g as i,h as a,r as s,s as c,t as f,u as n,v as S,w as m,x as d,y as x,z as y}from"./chunk-TUPD47IE.js";import"./chunk-I7AUKTXE.js";export{c as DATA,e as DIRTY,f as END,l as Inspector,o as PAUSE,t as RESET,r as RESOLVED,p as RESUME,s as START,n as STATE,i as TEARDOWN,S as batch,x as beginDeferredStart,d as deferEmission,E as deferStart,u as derived,D as dynamicDerived,R as effect,y as endDeferredStart,m as isBatching,a as isLifecycleSignal,b as operator,A as pipe,O as producer,g as state,v as subscribe,T as teardown};
+import{a as D}from"./chunk-BWH53TL4.js";import{a as A}from"./chunk-DIXN33QZ.js";import{a as R}from"./chunk-2ZFSL4MA.js";import{a as b}from"./chunk-YBVQC3GP.js";import{a as u}from"./chunk-PV347CGV.js";import"./chunk-HK7DRUNM.js";import{a as v}from"./chunk-GMLWTZFM.js";import{a as g}from"./chunk-EAK2HKAD.js";import{i as O}from"./chunk-2F6QWERG.js";import{a as l}from"./chunk-2L6223KN.js";import{A as E,B as T,a as e,b as r,d as t,e as o,f as p,g as i,h as a,r as s,s as c,t as f,u as n,v as S,w as m,x as d,y as x,z as y}from"./chunk-TUPD47IE.js";import"./chunk-I7AUKTXE.js";export{c as DATA,e as DIRTY,f as END,l as Inspector,o as PAUSE,t as RESET,r as RESOLVED,p as RESUME,s as START,n as STATE,i as TEARDOWN,S as batch,x as beginDeferredStart,d as deferEmission,E as deferStart,u as derived,D as dynamicDerived,R as effect,y as endDeferredStart,m as isBatching,a as isLifecycleSignal,b as operator,A as pipe,O as producer,g as state,v as subscribe,T as teardown};