@graphrefly/graphrefly 0.44.0 → 0.46.0

package/dist/status-U-rUI79b.d.cts

@@ -0,0 +1,84 @@
+import { Node } from '@graphrefly/pure-ts/core';
+
+/**
+ * Status wrapper — surface lifecycle state alongside output.
+ *
+ * `withStatus` mirrors a source `Node<T>` and produces companion `status` /
+ * `error` reactive nodes for UI and meta-snapshot consumers.
+ */
+
+/**
+ * Central lifecycle vocabulary for resilience primitives + `processManager`.
+ *
+ * **DS-13.5.B follow-on (2026-05-01).** Widened from
+ * `"pending" | "running" | "completed" | "errored"` to add `"cancelled"`
+ * (replaces `processManager`'s prior `"compensated"` semantics) and
+ * `"paused"` (carried by `<Primitive>State` lifecycle-shaped companions
+ * on `retry` / `circuitBreaker` / `rateLimiter`).
+ *
+ * Resilience primitives use this enum as the literal vocabulary inside
+ * lifecycle-shaped state nodes; `withStatus` (legacy) only emits the
+ * original four (pre-widening) — the cancelled / paused values are added
+ * for downstream consumers that need richer lifecycle reporting.
+ */
+type StatusValue = "pending" | "running" | "completed" | "errored" | "cancelled" | "paused";
+type WithStatusBundle<T> = {
+    node: Node<T>;
+    status: Node<StatusValue>;
+    error: Node<unknown | null>;
+};
+/**
+ * Wraps `src` with `status` and `error` {@link state} companions for UI or meta snapshots.
+ *
+ * @param src - Upstream node to mirror.
+ * @param options - `initialStatus` defaults to `"pending"`.
+ * @returns `{ node, status, error }` where `out` is the mirrored stream, `status` is a
+ *   reactive `Node<StatusValue>` (`"pending" | "running" | "completed" | "errored"`),
+ *   and `error` holds the last `ERROR` payload (cleared to `null` on the next `DATA`
+ *   after `errored`).
+ *
+ * @remarks
+ * **Lifecycle:** `pending` (no DATA yet) → `running` (on first DATA) → `completed`
+ * (on COMPLETE) or `errored` (on ERROR). After `errored`, the next `DATA` clears
+ * `error` and re-enters `running` inside a {@link batch} so subscribers see one
+ * consistent transition (matches graphrefly-py).
+ *
+ * **Producer-pattern visibility:** `out` is built via `node([], fn, …)`, so `src`
+ * appears as the source dependency in `describe()` traversal but the `status` /
+ * `error` companions are mirrored via subscribe-callback effects — they appear
+ * under `out.meta.status` / `out.meta.error` (and as `<name>::__meta__::status`
+ * paths in `describe()`) rather than as separate top-level edges. Subscribers
+ * to `out` see the throttled DATA stream; `status` / `error` companions may not
+ * appear as edges in `describe()` if no consumer subscribes to them (per
+ * COMPOSITION-GUIDE §1, push-on-subscribe semantics).
+ *
+ * **Per-subscribe lifecycle (DF8, 2026-04-29 doc lock).** When the wrapped
+ * source is `resubscribable: true` and multiple consumers attach in
+ * sequence, each new subscription cycle re-runs the producer fn AND
+ * re-emits the initial `pending` + `null` companion DATAs. Downstream
+ * subscribers to the `status` / `error` companions see thrash:
+ * `pending → running → completed → pending → running …`. This is the
+ * intended fresh-cycle semantic (each subscription cycle reports its own
+ * lifecycle); consumers that need a "stable" status across cycles should
+ * derive a snapshot via a separate `state()` mirror rather than depending
+ * on the per-cycle reset.
+ *
+ * @example
+ * ```ts
+ * import { withStatus, state } from "@graphrefly/graphrefly-ts";
+ *
+ * const src = state<number>(0);
+ * const { node, status, error } = withStatus(src);
+ *
+ * status.subscribe((msgs) => console.log("status:", msgs));
+ * src.down([[DATA, 42]]); // status → "running"
+ * ```
+ *
+ * @category extra
+ */
+declare function withStatus<T>(src: Node<T>, options?: {
+    initialStatus?: StatusValue;
+    meta?: Record<string, unknown>;
+}): WithStatusBundle<T>;
+
+export { type StatusValue as S, type WithStatusBundle as W, withStatus as w };

package/dist/status-U-rUI79b.d.ts

@@ -0,0 +1,84 @@
+import { Node } from '@graphrefly/pure-ts/core';
+
+/**
+ * Status wrapper — surface lifecycle state alongside output.
+ *
+ * `withStatus` mirrors a source `Node<T>` and produces companion `status` /
+ * `error` reactive nodes for UI and meta-snapshot consumers.
+ */
+
+/**
+ * Central lifecycle vocabulary for resilience primitives + `processManager`.
+ *
+ * **DS-13.5.B follow-on (2026-05-01).** Widened from
+ * `"pending" | "running" | "completed" | "errored"` to add `"cancelled"`
+ * (replaces `processManager`'s prior `"compensated"` semantics) and
+ * `"paused"` (carried by `<Primitive>State` lifecycle-shaped companions
+ * on `retry` / `circuitBreaker` / `rateLimiter`).
+ *
+ * Resilience primitives use this enum as the literal vocabulary inside
+ * lifecycle-shaped state nodes; `withStatus` (legacy) only emits the
+ * original four (pre-widening) — the cancelled / paused values are added
+ * for downstream consumers that need richer lifecycle reporting.
+ */
+type StatusValue = "pending" | "running" | "completed" | "errored" | "cancelled" | "paused";
+type WithStatusBundle<T> = {
+    node: Node<T>;
+    status: Node<StatusValue>;
+    error: Node<unknown | null>;
+};
+/**
+ * Wraps `src` with `status` and `error` {@link state} companions for UI or meta snapshots.
+ *
+ * @param src - Upstream node to mirror.
+ * @param options - `initialStatus` defaults to `"pending"`.
+ * @returns `{ node, status, error }` where `out` is the mirrored stream, `status` is a
+ *   reactive `Node<StatusValue>` (`"pending" | "running" | "completed" | "errored"`),
+ *   and `error` holds the last `ERROR` payload (cleared to `null` on the next `DATA`
+ *   after `errored`).
+ *
+ * @remarks
+ * **Lifecycle:** `pending` (no DATA yet) → `running` (on first DATA) → `completed`
+ * (on COMPLETE) or `errored` (on ERROR). After `errored`, the next `DATA` clears
+ * `error` and re-enters `running` inside a {@link batch} so subscribers see one
+ * consistent transition (matches graphrefly-py).
+ *
+ * **Producer-pattern visibility:** `out` is built via `node([], fn, …)`, so `src`
+ * appears as the source dependency in `describe()` traversal but the `status` /
+ * `error` companions are mirrored via subscribe-callback effects — they appear
+ * under `out.meta.status` / `out.meta.error` (and as `<name>::__meta__::status`
+ * paths in `describe()`) rather than as separate top-level edges. Subscribers
+ * to `out` see the throttled DATA stream; `status` / `error` companions may not
+ * appear as edges in `describe()` if no consumer subscribes to them (per
+ * COMPOSITION-GUIDE §1, push-on-subscribe semantics).
+ *
+ * **Per-subscribe lifecycle (DF8, 2026-04-29 doc lock).** When the wrapped
+ * source is `resubscribable: true` and multiple consumers attach in
+ * sequence, each new subscription cycle re-runs the producer fn AND
+ * re-emits the initial `pending` + `null` companion DATAs. Downstream
+ * subscribers to the `status` / `error` companions see thrash:
+ * `pending → running → completed → pending → running …`. This is the
+ * intended fresh-cycle semantic (each subscription cycle reports its own
+ * lifecycle); consumers that need a "stable" status across cycles should
+ * derive a snapshot via a separate `state()` mirror rather than depending
+ * on the per-cycle reset.
+ *
+ * @example
+ * ```ts
+ * import { withStatus, state } from "@graphrefly/graphrefly-ts";
+ *
+ * const src = state<number>(0);
+ * const { node, status, error } = withStatus(src);
+ *
+ * status.subscribe((msgs) => console.log("status:", msgs));
+ * src.down([[DATA, 42]]); // status → "running"
+ * ```
+ *
+ * @category extra
+ */
+declare function withStatus<T>(src: Node<T>, options?: {
+    initialStatus?: StatusValue;
+    meta?: Record<string, unknown>;
+}): WithStatusBundle<T>;
+
+export { type StatusValue as S, type WithStatusBundle as W, withStatus as w };

package/dist/timeout-U5O4ESK3.js

@@ -0,0 +1,12 @@
+import {
+  TimeoutError,
+  withTimeout
+} from "./chunk-RAGGHLCV.js";
+import "./chunk-TSBFTJKM.js";
+import "./chunk-P5LBT622.js";
+import "./chunk-AZDQPQ3V.js";
+export {
+  TimeoutError,
+  withTimeout
+};
+//# sourceMappingURL=timeout-U5O4ESK3.js.map

package/dist/timeout-U5O4ESK3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{types-CWFysE9E.d.ts → types-BB5Lw-pB.d.cts}

@@ -1,5 +1,5 @@
-import { N as Node } from './node-kK3CvTrR.js';
-import { NodeInput } from './extra/sources.js';
+import { Node } from '@graphrefly/pure-ts/core';
+import { NodeInput } from '@graphrefly/pure-ts/extra';
 
 /**
  * A rate per 1M tokens. Supports threshold-based tiering (Anthropic
@@ -439,4 +439,4 @@ interface LLMAdapter {
     capabilities?(model?: string): ModelCapabilities | undefined;
 }
 
-export { type ChatMessage as C, type LLMAdapter as L, type ModelCapabilities as M, type PricingFn as P, type Rate as R, type StreamDelta as S, type TokenUsage as T, type LLMInvokeOptions as a, type LLMResponse as b, type ToolCall as c, type ToolDefinition as d, type CapabilitiesRegistry as e, type ModelFeatures as f, type ModelLimits as g, type ModelPricing as h, type PriceBreakdown as i, type PricingRegistry as j, type TieredRate as k, composePricing as l, computePrice as m, createCapabilitiesRegistry as n, createPricingRegistry as o, pricingFor as p, registryPricing as r, zeroPrice as z };
+export { type CapabilitiesRegistry as C, type LLMAdapter as L, type ModelCapabilities as M, type PriceBreakdown as P, type Rate as R, type StreamDelta as S, type TieredRate as T, type ChatMessage as a, type LLMInvokeOptions as b, type LLMResponse as c, type ModelFeatures as d, type ModelLimits as e, type ModelPricing as f, type PricingFn as g, type PricingRegistry as h, type TokenUsage as i, type ToolCall as j, type ToolDefinition as k, composePricing as l, computePrice as m, createCapabilitiesRegistry as n, createPricingRegistry as o, pricingFor as p, registryPricing as r, zeroPrice as z };

package/dist/{types-C0_yquda.d.cts → types-BB5Lw-pB.d.ts}

@@ -1,5 +1,5 @@
-import { N as Node } from './node-kK3CvTrR.cjs';
-import { NodeInput } from './extra/sources.cjs';
+import { Node } from '@graphrefly/pure-ts/core';
+import { NodeInput } from '@graphrefly/pure-ts/extra';
 
 /**
  * A rate per 1M tokens. Supports threshold-based tiering (Anthropic
@@ -439,4 +439,4 @@ interface LLMAdapter {
     capabilities?(model?: string): ModelCapabilities | undefined;
 }
 
-export { type ChatMessage as C, type LLMAdapter as L, type ModelCapabilities as M, type PricingFn as P, type Rate as R, type StreamDelta as S, type TokenUsage as T, type LLMInvokeOptions as a, type LLMResponse as b, type ToolCall as c, type ToolDefinition as d, type CapabilitiesRegistry as e, type ModelFeatures as f, type ModelLimits as g, type ModelPricing as h, type PriceBreakdown as i, type PricingRegistry as j, type TieredRate as k, composePricing as l, computePrice as m, createCapabilitiesRegistry as n, createPricingRegistry as o, pricingFor as p, registryPricing as r, zeroPrice as z };
+export { type CapabilitiesRegistry as C, type LLMAdapter as L, type ModelCapabilities as M, type PriceBreakdown as P, type Rate as R, type StreamDelta as S, type TieredRate as T, type ChatMessage as a, type LLMInvokeOptions as b, type LLMResponse as c, type ModelFeatures as d, type ModelLimits as e, type ModelPricing as f, type PricingFn as g, type PricingRegistry as h, type TokenUsage as i, type ToolCall as j, type ToolDefinition as k, composePricing as l, computePrice as m, createCapabilitiesRegistry as n, createPricingRegistry as o, pricingFor as p, registryPricing as r, zeroPrice as z };