@graphrefly/ts 0.0.0

package/dist/index-CAEmLCYF.d.cts

@@ -0,0 +1,166 @@
+import { N as Node, n as NodeOptions, h as HttpResponse, g as HttpRequest, x as ProcessResult, z as SseEvent, A as SseRequest, J as WebSocketEvent, M as WebSocketRequest, X as WebhookEvent, Y as WebhookRegistration, w as ProcessCommand } from './types-bNMSWKqF.cjs';
+import { L as Operator } from './graph-s23RbbFO.cjs';
+
+/**
+ * Async + sync sources (binding-layer sugar, D43 / D40 / feedback_async_sources_binding_layer).
+ *
+ * Sources are depless {@link Operator}`<never, T>` specs built on the `producer`/`node` path:
+ * the body runs ONCE on activation (node `_activate`), schedules its work, and emits later via
+ * the captured `ctx.down` (an external tier-3 emit → the leading DIRTY is synthesized for it,
+ * R-dirty-before-data). Async lives ONLY here (R-no-raw-async / F-SYNC-CORE): `setTimeout` /
+ * `Promise` / `for await` are confined to source bodies; the wave core stays sync. Cleanup is
+ * `ctx.onDeactivation` (D28), NOT a returned object. Per-language (D6/D24), never in parity.
+ *
+ * Instantiate via `g.initNode(timer(1000), [])` (graph-bound, inspectable) or
+ * {@link initNode}(timer(1000), []) (bare). Pool/pause defaults (D43): timer/interval =
+ * sync + pausable:false (keep producing through PAUSE); fromPromise/fromAsyncIter = async
+ * (default pausable, so a paused source buffers its late emits — R-async-paused).
+ */
+
+/**
+ * Values accepted by {@link fromAny}: an existing Node, a Promise, an (a)sync iterable, or a
+ * bare scalar. The universal coercion target for higher-order operators (CSP-2.7).
+ */
+type NodeInput<T> = Node<T> | PromiseLike<T> | AsyncIterable<T> | Iterable<T> | T;
+/** Host-boundary options for {@link singleFromAny}. */
+interface SingleFromAnyOptions<K> {
+    /**
+     * Map a caller key to the in-flight dedupe key. Defaults to key identity; object keys dedupe only
+     * when the same object reference is reused. Return a stable string/canonical value for structural
+     * object-key dedupe.
+     */
+    keyOf?: (key: K) => unknown;
+    /** Treat a sync iterable result as a stream and take its first item. Defaults to scalar value. */
+    iter?: boolean;
+}
+/** Options shared by async/timer sources: an optional AbortSignal → ERROR on abort. */
+interface AsyncSourceOpts {
+    signal?: AbortSignal;
+}
+interface TimerSourceOpts extends AsyncSourceOpts {
+    period?: number;
+}
+/** Options for {@link fromCron}. */
+interface FromCronOptions extends AsyncSourceOpts {
+    /** Cron matcher polling interval in milliseconds. Default: 60_000. */
+    tickMs?: number;
+    /**
+     * Emitted value shape. `timestamp_ns` is a decimal string so it cannot lose precision as a
+     * JavaScript number; use `timestamp_ms` when numeric millisecond precision is enough.
+     */
+    output?: "date" | "timestamp_ms" | "timestamp_ns";
+}
+/** Minimal five-field cron schedule: minute hour day-of-month month day-of-week. */
+interface CronSchedule {
+    readonly minutes: ReadonlySet<number>;
+    readonly hours: ReadonlySet<number>;
+    readonly daysOfMonth: ReadonlySet<number>;
+    readonly months: ReadonlySet<number>;
+    readonly daysOfWeek: ReadonlySet<number>;
+}
+/** DOM/EventEmitter-style target accepted by {@link fromEvent}. */
+interface EventTargetLike {
+    addEventListener(type: string, listener: (event: unknown) => void, options?: EventListenerOptionsLike): void;
+    removeEventListener(type: string, listener: (event: unknown) => void, options?: EventListenerOptionsLike): void;
+}
+interface EventListenerOptionsLike {
+    capture?: boolean;
+    passive?: boolean;
+    once?: boolean;
+}
+type FromEventOptions = EventListenerOptionsLike;
+/** Host push registration callback accepted by {@link fromPushNotification}. */
+type PushUnsubscribe = () => void;
+type PushRegister<T> = (deliver: (payload: T) => void) => PushUnsubscribe | undefined;
+/** Parse a standard five-field cron expression. */
+declare function parseCron(expr: string): CronSchedule;
+/** Test whether a local Date matches a parsed cron schedule. */
+declare function matchesCron(schedule: CronSchedule, date: Date): boolean;
+declare function fromCron(expr: string, opts: FromCronOptions & {
+    output: "date";
+}): Operator<never, Date>;
+declare function fromCron(expr: string, opts: FromCronOptions & {
+    output: "timestamp_ms";
+}): Operator<never, number>;
+declare function fromCron(expr: string, opts?: FromCronOptions & {
+    output?: "timestamp_ns";
+}): Operator<never, string>;
+declare function fromCron(expr: string, opts?: FromCronOptions): Operator<never, Date | number | string>;
+declare function runProcess(program: string, args?: readonly string[]): Operator<never, ProcessResult>;
+declare function fromProcess(program: string, args?: readonly string[]): Operator<never, ProcessResult>;
+declare function runProcessWithOptions(command: ProcessCommand): Operator<never, ProcessResult>;
+declare function fromHttp(url: string): Operator<never, HttpResponse>;
+declare function fromHttpWithOptions(request: HttpRequest): Operator<never, HttpResponse>;
+declare function fromSSE(url: string): Operator<never, SseEvent>;
+declare function fromSSEWithOptions(request: SseRequest): Operator<never, SseEvent>;
+declare function fromWebSocket(url: string): Operator<never, WebSocketEvent>;
+declare function fromWebSocketWithOptions(request: WebSocketRequest): Operator<never, WebSocketEvent>;
+declare function fromWebhook(id: string): Operator<never, WebhookEvent>;
+declare function fromWebhookWithOptions(registration: WebhookRegistration): Operator<never, WebhookEvent>;
+/**
+ * Timer source: one-shot (first tick then COMPLETE) or periodic (`{period}` → 0, 1, 2, …).
+ * sync pool + pausable:false (a timer keeps producing through PAUSE, R-pause-modes). Emits the
+ * tick counter from 0; deactivation clears the timers.
+ */
+declare function timer(ms: number, opts?: TimerSourceOpts): Operator<never, number>;
+/** Frozen pure-ts name for {@link timer}; preserves the real factory name in describe(). */
+declare function fromTimer(ms: number, opts?: TimerSourceOpts): Operator<never, number>;
+/** interval: periodic ticks (0, 1, 2, …), first at `ms`, then every `ms` (RxJS semantics). */
+declare function interval(ms: number): Operator<never, number>;
+/**
+ * Lift a Promise (or thenable) to a single-value stream: one DATA then COMPLETE, or ERROR on
+ * rejection. async pool (default pausable → a paused source buffers its late emit). Optional
+ * `signal` aborts to ERROR.
+ */
+declare function fromPromise<T>(p: Promise<T> | PromiseLike<T>, opts?: AsyncSourceOpts): Operator<never, T>;
+/**
+ * Read an async iterable: each value → DATA; COMPLETE when done; ERROR on failure. async pool.
+ * Optional `signal` aborts the pump.
+ */
+declare function fromAsyncIter<T>(iterable: AsyncIterable<T>, opts?: AsyncSourceOpts): Operator<never, T>;
+/**
+ * of: synchronous values — each argument as DATA, then COMPLETE. `of()` is the EMPTY source.
+ */
+declare function of<T = never>(...values: T[]): Operator<never, T>;
+/** fromIter: a sync iterable — each value → DATA (in order), then COMPLETE, on activation. */
+declare function fromIter<T>(iterable: Iterable<T>): Operator<never, T>;
+/** EMPTY analogue: complete immediately with no DATA. */
+declare function empty<T = never>(): Operator<never, T>;
+/** NEVER analogue: activate and remain silent until deactivation. */
+declare function never<T = never>(): Operator<never, T>;
+/** Error source: terminate with ERROR on activation, coercing invalid host-language payloads. */
+declare function throwError(err: unknown): Operator<never, never>;
+/**
+ * Wrap a DOM-style event target. Each event becomes DATA; deactivation removes the listener.
+ * External callbacks are source boundaries (D43), so no polling or operator-level async leaks in.
+ */
+declare function fromEvent<T = unknown>(target: EventTargetLike, type: string, opts?: FromEventOptions): Operator<never, T>;
+/**
+ * Wrap a host push transport. The host owns network/native setup; this factory owns reactive
+ * delivery and teardown only, preserving async-at-source-boundary discipline.
+ */
+declare function fromPushNotification<T = unknown>(register: PushRegister<T>): Operator<never, T>;
+/**
+ * Coerce a {@link NodeInput}`<T>` to a `Node<T>` (D43 — coercion prerequisite for the CSP-2.7
+ * higher-order operators). An existing Node passes through; a thenable → {@link fromPromise};
+ * an async iterable → {@link fromAsyncIter}; with `{iter:true}` a sync iterable →
+ * {@link fromIter}; everything else → {@link of}. Coerced nodes are bare (use
+ * `opts.dispatcher` to bind one, default = process-global D26).
+ */
+declare function fromAny<T>(input: NodeInput<T>, opts?: NodeOptions<T> & {
+    iter?: boolean;
+}): Node<T>;
+/**
+ * Resolve the first DATA from a Node as a Promise. This is a host-boundary escape hatch, not a
+ * graph operator; do not call it from reactive node bodies. ERROR rejects, and COMPLETE before DATA
+ * rejects because no value exists.
+ */
+declare function firstValueFrom<T>(source: Node<T>): Promise<T>;
+/**
+ * Keyed singleflight over {@link NodeInput}. Concurrent calls with the same key share one Promise;
+ * once that input resolves/rejects, the in-flight entry is cleared and a later call re-runs the
+ * factory. Host-boundary helper only; it does not create graph topology.
+ */
+declare function singleFromAny<K, T>(factory: (key: K) => NodeInput<T>, opts?: SingleFromAnyOptions<K>): (key: K) => Promise<T>;
+
+export { type AsyncSourceOpts as A, parseCron as B, type CronSchedule as C, runProcess as D, type EventListenerOptionsLike as E, type FromCronOptions as F, runProcessWithOptions as G, singleFromAny as H, throwError as I, timer as J, type NodeInput as N, type PushRegister as P, type SingleFromAnyOptions as S, type TimerSourceOpts as T, type EventTargetLike as a, type FromEventOptions as b, type PushUnsubscribe as c, fromAny as d, empty as e, firstValueFrom as f, fromAsyncIter as g, fromCron as h, fromEvent as i, fromHttp as j, fromHttpWithOptions as k, fromIter as l, fromProcess as m, fromPromise as n, fromPushNotification as o, fromSSE as p, fromSSEWithOptions as q, fromTimer as r, fromWebSocket as s, fromWebSocketWithOptions as t, fromWebhook as u, fromWebhookWithOptions as v, interval as w, matchesCron as x, never as y, of as z };

package/dist/index-SnzZu3x7.d.ts

@@ -0,0 +1,166 @@
+import { N as Node, n as NodeOptions, h as HttpResponse, g as HttpRequest, x as ProcessResult, z as SseEvent, A as SseRequest, J as WebSocketEvent, M as WebSocketRequest, X as WebhookEvent, Y as WebhookRegistration, w as ProcessCommand } from './types-h12mNYbq.js';
+import { L as Operator } from './graph-DfdF9zy4.js';
+
+/**
+ * Async + sync sources (binding-layer sugar, D43 / D40 / feedback_async_sources_binding_layer).
+ *
+ * Sources are depless {@link Operator}`<never, T>` specs built on the `producer`/`node` path:
+ * the body runs ONCE on activation (node `_activate`), schedules its work, and emits later via
+ * the captured `ctx.down` (an external tier-3 emit → the leading DIRTY is synthesized for it,
+ * R-dirty-before-data). Async lives ONLY here (R-no-raw-async / F-SYNC-CORE): `setTimeout` /
+ * `Promise` / `for await` are confined to source bodies; the wave core stays sync. Cleanup is
+ * `ctx.onDeactivation` (D28), NOT a returned object. Per-language (D6/D24), never in parity.
+ *
+ * Instantiate via `g.initNode(timer(1000), [])` (graph-bound, inspectable) or
+ * {@link initNode}(timer(1000), []) (bare). Pool/pause defaults (D43): timer/interval =
+ * sync + pausable:false (keep producing through PAUSE); fromPromise/fromAsyncIter = async
+ * (default pausable, so a paused source buffers its late emits — R-async-paused).
+ */
+
+/**
+ * Values accepted by {@link fromAny}: an existing Node, a Promise, an (a)sync iterable, or a
+ * bare scalar. The universal coercion target for higher-order operators (CSP-2.7).
+ */
+type NodeInput<T> = Node<T> | PromiseLike<T> | AsyncIterable<T> | Iterable<T> | T;
+/** Host-boundary options for {@link singleFromAny}. */
+interface SingleFromAnyOptions<K> {
+    /**
+     * Map a caller key to the in-flight dedupe key. Defaults to key identity; object keys dedupe only
+     * when the same object reference is reused. Return a stable string/canonical value for structural
+     * object-key dedupe.
+     */
+    keyOf?: (key: K) => unknown;
+    /** Treat a sync iterable result as a stream and take its first item. Defaults to scalar value. */
+    iter?: boolean;
+}
+/** Options shared by async/timer sources: an optional AbortSignal → ERROR on abort. */
+interface AsyncSourceOpts {
+    signal?: AbortSignal;
+}
+interface TimerSourceOpts extends AsyncSourceOpts {
+    period?: number;
+}
+/** Options for {@link fromCron}. */
+interface FromCronOptions extends AsyncSourceOpts {
+    /** Cron matcher polling interval in milliseconds. Default: 60_000. */
+    tickMs?: number;
+    /**
+     * Emitted value shape. `timestamp_ns` is a decimal string so it cannot lose precision as a
+     * JavaScript number; use `timestamp_ms` when numeric millisecond precision is enough.
+     */
+    output?: "date" | "timestamp_ms" | "timestamp_ns";
+}
+/** Minimal five-field cron schedule: minute hour day-of-month month day-of-week. */
+interface CronSchedule {
+    readonly minutes: ReadonlySet<number>;
+    readonly hours: ReadonlySet<number>;
+    readonly daysOfMonth: ReadonlySet<number>;
+    readonly months: ReadonlySet<number>;
+    readonly daysOfWeek: ReadonlySet<number>;
+}
+/** DOM/EventEmitter-style target accepted by {@link fromEvent}. */
+interface EventTargetLike {
+    addEventListener(type: string, listener: (event: unknown) => void, options?: EventListenerOptionsLike): void;
+    removeEventListener(type: string, listener: (event: unknown) => void, options?: EventListenerOptionsLike): void;
+}
+interface EventListenerOptionsLike {
+    capture?: boolean;
+    passive?: boolean;
+    once?: boolean;
+}
+type FromEventOptions = EventListenerOptionsLike;
+/** Host push registration callback accepted by {@link fromPushNotification}. */
+type PushUnsubscribe = () => void;
+type PushRegister<T> = (deliver: (payload: T) => void) => PushUnsubscribe | undefined;
+/** Parse a standard five-field cron expression. */
+declare function parseCron(expr: string): CronSchedule;
+/** Test whether a local Date matches a parsed cron schedule. */
+declare function matchesCron(schedule: CronSchedule, date: Date): boolean;
+declare function fromCron(expr: string, opts: FromCronOptions & {
+    output: "date";
+}): Operator<never, Date>;
+declare function fromCron(expr: string, opts: FromCronOptions & {
+    output: "timestamp_ms";
+}): Operator<never, number>;
+declare function fromCron(expr: string, opts?: FromCronOptions & {
+    output?: "timestamp_ns";
+}): Operator<never, string>;
+declare function fromCron(expr: string, opts?: FromCronOptions): Operator<never, Date | number | string>;
+declare function runProcess(program: string, args?: readonly string[]): Operator<never, ProcessResult>;
+declare function fromProcess(program: string, args?: readonly string[]): Operator<never, ProcessResult>;
+declare function runProcessWithOptions(command: ProcessCommand): Operator<never, ProcessResult>;
+declare function fromHttp(url: string): Operator<never, HttpResponse>;
+declare function fromHttpWithOptions(request: HttpRequest): Operator<never, HttpResponse>;
+declare function fromSSE(url: string): Operator<never, SseEvent>;
+declare function fromSSEWithOptions(request: SseRequest): Operator<never, SseEvent>;
+declare function fromWebSocket(url: string): Operator<never, WebSocketEvent>;
+declare function fromWebSocketWithOptions(request: WebSocketRequest): Operator<never, WebSocketEvent>;
+declare function fromWebhook(id: string): Operator<never, WebhookEvent>;
+declare function fromWebhookWithOptions(registration: WebhookRegistration): Operator<never, WebhookEvent>;
+/**
+ * Timer source: one-shot (first tick then COMPLETE) or periodic (`{period}` → 0, 1, 2, …).
+ * sync pool + pausable:false (a timer keeps producing through PAUSE, R-pause-modes). Emits the
+ * tick counter from 0; deactivation clears the timers.
+ */
+declare function timer(ms: number, opts?: TimerSourceOpts): Operator<never, number>;
+/** Frozen pure-ts name for {@link timer}; preserves the real factory name in describe(). */
+declare function fromTimer(ms: number, opts?: TimerSourceOpts): Operator<never, number>;
+/** interval: periodic ticks (0, 1, 2, …), first at `ms`, then every `ms` (RxJS semantics). */
+declare function interval(ms: number): Operator<never, number>;
+/**
+ * Lift a Promise (or thenable) to a single-value stream: one DATA then COMPLETE, or ERROR on
+ * rejection. async pool (default pausable → a paused source buffers its late emit). Optional
+ * `signal` aborts to ERROR.
+ */
+declare function fromPromise<T>(p: Promise<T> | PromiseLike<T>, opts?: AsyncSourceOpts): Operator<never, T>;
+/**
+ * Read an async iterable: each value → DATA; COMPLETE when done; ERROR on failure. async pool.
+ * Optional `signal` aborts the pump.
+ */
+declare function fromAsyncIter<T>(iterable: AsyncIterable<T>, opts?: AsyncSourceOpts): Operator<never, T>;
+/**
+ * of: synchronous values — each argument as DATA, then COMPLETE. `of()` is the EMPTY source.
+ */
+declare function of<T = never>(...values: T[]): Operator<never, T>;
+/** fromIter: a sync iterable — each value → DATA (in order), then COMPLETE, on activation. */
+declare function fromIter<T>(iterable: Iterable<T>): Operator<never, T>;
+/** EMPTY analogue: complete immediately with no DATA. */
+declare function empty<T = never>(): Operator<never, T>;
+/** NEVER analogue: activate and remain silent until deactivation. */
+declare function never<T = never>(): Operator<never, T>;
+/** Error source: terminate with ERROR on activation, coercing invalid host-language payloads. */
+declare function throwError(err: unknown): Operator<never, never>;
+/**
+ * Wrap a DOM-style event target. Each event becomes DATA; deactivation removes the listener.
+ * External callbacks are source boundaries (D43), so no polling or operator-level async leaks in.
+ */
+declare function fromEvent<T = unknown>(target: EventTargetLike, type: string, opts?: FromEventOptions): Operator<never, T>;
+/**
+ * Wrap a host push transport. The host owns network/native setup; this factory owns reactive
+ * delivery and teardown only, preserving async-at-source-boundary discipline.
+ */
+declare function fromPushNotification<T = unknown>(register: PushRegister<T>): Operator<never, T>;
+/**
+ * Coerce a {@link NodeInput}`<T>` to a `Node<T>` (D43 — coercion prerequisite for the CSP-2.7
+ * higher-order operators). An existing Node passes through; a thenable → {@link fromPromise};
+ * an async iterable → {@link fromAsyncIter}; with `{iter:true}` a sync iterable →
+ * {@link fromIter}; everything else → {@link of}. Coerced nodes are bare (use
+ * `opts.dispatcher` to bind one, default = process-global D26).
+ */
+declare function fromAny<T>(input: NodeInput<T>, opts?: NodeOptions<T> & {
+    iter?: boolean;
+}): Node<T>;
+/**
+ * Resolve the first DATA from a Node as a Promise. This is a host-boundary escape hatch, not a
+ * graph operator; do not call it from reactive node bodies. ERROR rejects, and COMPLETE before DATA
+ * rejects because no value exists.
+ */
+declare function firstValueFrom<T>(source: Node<T>): Promise<T>;
+/**
+ * Keyed singleflight over {@link NodeInput}. Concurrent calls with the same key share one Promise;
+ * once that input resolves/rejects, the in-flight entry is cleared and a later call re-runs the
+ * factory. Host-boundary helper only; it does not create graph topology.
+ */
+declare function singleFromAny<K, T>(factory: (key: K) => NodeInput<T>, opts?: SingleFromAnyOptions<K>): (key: K) => Promise<T>;
+
+export { type AsyncSourceOpts as A, parseCron as B, type CronSchedule as C, runProcess as D, type EventListenerOptionsLike as E, type FromCronOptions as F, runProcessWithOptions as G, singleFromAny as H, throwError as I, timer as J, type NodeInput as N, type PushRegister as P, type SingleFromAnyOptions as S, type TimerSourceOpts as T, type EventTargetLike as a, type FromEventOptions as b, type PushUnsubscribe as c, fromAny as d, empty as e, firstValueFrom as f, fromAsyncIter as g, fromCron as h, fromEvent as i, fromHttp as j, fromHttpWithOptions as k, fromIter as l, fromProcess as m, fromPromise as n, fromPushNotification as o, fromSSE as p, fromSSEWithOptions as q, fromTimer as r, fromWebSocket as s, fromWebSocketWithOptions as t, fromWebhook as u, fromWebhookWithOptions as v, interval as w, matchesCron as x, never as y, of as z };