@graphrefly/graphrefly 0.6.0 → 0.7.0

package/dist/{index-C5mqLhMX.d.cts → index-D8NIq6om.d.cts}

@@ -1,4 +1,4 @@
-import { i as Messages, N as Node, j as NodeDescribeKind, k as NodeGuard, a as NodeOptions, a0 as NodeInspectorHook, m as NodeStatus, A as Actor, n as NodeTransportOptions, l as NodeSink, S as SubscribeHints, c as NodeFn, C as COMPLETE, D as DATA, d as DEFAULT_ACTOR, e as DIRTY, f as DescribeNodeOutput, E as ERROR, G as GuardAction, g as GuardDenied, h as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, b as NodeActions, o as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, p as PolicyAllow, q as PolicyDeny, r as PolicyRuleData, R as RESOLVED, s as RESUME, T as TEARDOWN, V as V0, t as V1, u as VersioningLevel, v as VersioningOptions, w as accessHintForGuard, x as advanceVersion, y as createVersioning, z as defaultHash, B as describeNode, F as isKnownMessageType, J as isPhase2Message, K as isTerminalMessage, L as isV1, Q as knownMessageTypes, U as messageTier, W as metaSnapshot, X as node, Y as normalizeActor, Z as policy, _ as policyFromRules, $ as propagatesToMeta } from './meta-BsF6Sag9.cjs';
+import { k as Messages, N as Node, l as NodeDescribeKind, m as NodeGuard, a as NodeOptions, a3 as NodeInspectorHook, o as NodeStatus, A as Actor, p as NodeTransportOptions, n as NodeSink, S as SubscribeHints, c as NodeFn, C as COMPLETE, D as DATA, d as DEFAULT_ACTOR, e as DIRTY, f as DescribeDetail, g as DescribeField, h as DescribeNodeOutput, E as ERROR, G as GuardAction, i as GuardDenied, j as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, b as NodeActions, q as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, r as PolicyAllow, s as PolicyDeny, t as PolicyRuleData, R as RESOLVED, u as RESUME, T as TEARDOWN, V as V0, v as V1, w as VersioningLevel, x as VersioningOptions, y as accessHintForGuard, z as advanceVersion, B as createVersioning, F as defaultHash, J as describeNode, K as isKnownMessageType, L as isPhase2Message, Q as isTerminalMessage, U as isV1, W as knownMessageTypes, X as messageTier, Y as metaSnapshot, Z as node, _ as normalizeActor, $ as policy, a0 as policyFromRules, a1 as propagatesToMeta, a2 as resolveDescribeFields } from './meta-BJEU8fYz.cjs';
 
 /**
  * Returns whether the current call stack is inside a batch scope **or** while
@@ -97,6 +97,9 @@ declare function partitionForBatch(messages: Messages): {
  * @param emit — Sink callback. May be called up to three times per invocation
  *   (immediate, deferred, terminal) when not batching.
  * @param messages — Full `[[Type, Data?], ...]` array for one emission.
+ * @param phase — Starting delivery phase (`2` = data, `3` = terminal). Default `2`.
+ * @param options - Optional configuration.
+ * @option strategy | `"partition"` or `"sequential"` | `"partition"` | `"partition"` groups by tier; `"sequential"` preserves message order within each tier using `messageTier()` classification.
  * @returns `void` — delivery is performed through `emit` callbacks, synchronously
  *   or deferred into the active batch queue.
  *
@@ -109,7 +112,9 @@ declare function partitionForBatch(messages: Messages): {
  *
  * @category core
  */
-declare function emitWithBatch(emit: (messages: Messages) => void, messages: Messages, phase?: 2 | 3): void;
+declare function emitWithBatch(emit: (messages: Messages) => void, messages: Messages, phase?: 2 | 3, options?: {
+    strategy?: "partition" | "sequential";
+}): void;
 
 /**
  * Centralised timestamp utilities.
@@ -369,6 +374,39 @@ type PipeOperator = (n: Node) => Node;
  */
 declare function pipe(source: Node, ...ops: PipeOperator[]): Node;
 
+/**
+ * Creates a resettable deadline timer for internal timeout, retry, and rate-limiting use.
+ *
+ * @remarks **Centralised primitive:** wraps `setTimeout`/`clearTimeout` with a generation guard
+ * so that stale callbacks never fire after `cancel()` or a new `start()`.
+ *
+ * @remarks **Spec §5.10 exception:** resilience operators (`timeout`, `retry`, `rateLimiter`)
+ * need raw timers — `fromTimer` creates a new Node per reset, which is too heavy here.
+ *
+ * @example
+ * ```ts
+ * import { ResettableTimer } from "@graphrefly/graphrefly-ts";
+ *
+ * const timer = new ResettableTimer();
+ * timer.start(1000, () => console.log("fired"));
+ * timer.cancel();          // cancels before firing
+ * timer.start(500, () => console.log("new deadline"));
+ * console.log(timer.pending); // true
+ * ```
+ *
+ * @category core
+ */
+declare class ResettableTimer {
+    private _timer;
+    private _gen;
+    /** Schedule callback after delayMs. Cancels any pending timer. */
+    start(delayMs: number, callback: () => void): void;
+    /** Cancel the pending timer (if any). */
+    cancel(): void;
+    /** Whether a timer is currently pending. */
+    get pending(): boolean;
+}
+
 /**
  * Core layer: message protocol, node primitive, lifecycle (Phase 0).
  */
@@ -378,6 +416,8 @@ declare const index_COMPLETE: typeof COMPLETE;
 declare const index_DATA: typeof DATA;
 declare const index_DEFAULT_ACTOR: typeof DEFAULT_ACTOR;
 declare const index_DIRTY: typeof DIRTY;
+declare const index_DescribeDetail: typeof DescribeDetail;
+declare const index_DescribeField: typeof DescribeField;
 declare const index_DescribeNodeOutput: typeof DescribeNodeOutput;
 type index_DynGet = DynGet;
 type index_DynamicNodeFn<T> = DynamicNodeFn<T>;
@@ -410,6 +450,8 @@ declare const index_PolicyDeny: typeof PolicyDeny;
 declare const index_PolicyRuleData: typeof PolicyRuleData;
 declare const index_RESOLVED: typeof RESOLVED;
 declare const index_RESUME: typeof RESUME;
+type index_ResettableTimer = ResettableTimer;
+declare const index_ResettableTimer: typeof ResettableTimer;
 declare const index_SubscribeHints: typeof SubscribeHints;
 declare const index_TEARDOWN: typeof TEARDOWN;
 declare const index_V0: typeof V0;
@@ -443,10 +485,11 @@ declare const index_policy: typeof policy;
 declare const index_policyFromRules: typeof policyFromRules;
 declare const index_producer: typeof producer;
 declare const index_propagatesToMeta: typeof propagatesToMeta;
+declare const index_resolveDescribeFields: typeof resolveDescribeFields;
 declare const index_state: typeof state;
 declare const index_wallClockNs: typeof wallClockNs;
 declare namespace index {
-  export { index_Actor as Actor, index_COMPLETE as COMPLETE, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DIRTY as DIRTY, index_DescribeNodeOutput as DescribeNodeOutput, type index_DynGet as DynGet, type index_DynamicNodeFn as DynamicNodeFn, index_DynamicNodeImpl as DynamicNodeImpl, type index_DynamicNodeOptions as DynamicNodeOptions, index_ERROR as ERROR, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_Message as Message, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeDescribeKind as NodeDescribeKind, index_NodeFn as NodeFn, index_NodeGuard as NodeGuard, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_PAUSE as PAUSE, type index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_RESOLVED as RESOLVED, index_RESUME as RESUME, index_SubscribeHints as SubscribeHints, index_TEARDOWN as TEARDOWN, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_batch as batch, index_createVersioning as createVersioning, index_defaultHash as defaultHash, index_derived as derived, index_describeNode as describeNode, index_dynamicNode as dynamicNode, index_effect as effect, index_emitWithBatch as emitWithBatch, index_isBatching as isBatching, index_isKnownMessageType as isKnownMessageType, index_isPhase2Message as isPhase2Message, index_isTerminalMessage as isTerminalMessage, index_isV1 as isV1, index_knownMessageTypes as knownMessageTypes, index_messageTier as messageTier, index_metaSnapshot as metaSnapshot, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_partitionForBatch as partitionForBatch, index_pipe as pipe, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_propagatesToMeta as propagatesToMeta, index_state as state, index_wallClockNs as wallClockNs };
+  export { index_Actor as Actor, index_COMPLETE as COMPLETE, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DIRTY as DIRTY, index_DescribeDetail as DescribeDetail, index_DescribeField as DescribeField, index_DescribeNodeOutput as DescribeNodeOutput, type index_DynGet as DynGet, type index_DynamicNodeFn as DynamicNodeFn, index_DynamicNodeImpl as DynamicNodeImpl, type index_DynamicNodeOptions as DynamicNodeOptions, index_ERROR as ERROR, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_Message as Message, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeDescribeKind as NodeDescribeKind, index_NodeFn as NodeFn, index_NodeGuard as NodeGuard, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_PAUSE as PAUSE, type index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_RESOLVED as RESOLVED, index_RESUME as RESUME, index_ResettableTimer as ResettableTimer, index_SubscribeHints as SubscribeHints, index_TEARDOWN as TEARDOWN, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_batch as batch, index_createVersioning as createVersioning, index_defaultHash as defaultHash, index_derived as derived, index_describeNode as describeNode, index_dynamicNode as dynamicNode, index_effect as effect, index_emitWithBatch as emitWithBatch, index_isBatching as isBatching, index_isKnownMessageType as isKnownMessageType, index_isPhase2Message as isPhase2Message, index_isTerminalMessage as isTerminalMessage, index_isV1 as isV1, index_knownMessageTypes as knownMessageTypes, index_messageTier as messageTier, index_metaSnapshot as metaSnapshot, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_partitionForBatch as partitionForBatch, index_pipe as pipe, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_propagatesToMeta as propagatesToMeta, index_resolveDescribeFields as resolveDescribeFields, index_state as state, index_wallClockNs as wallClockNs };
 }
 
-export { type DynGet as D, type PipeOperator as P, type DynamicNodeFn as a, DynamicNodeImpl as b, type DynamicNodeOptions as c, batch as d, derived as e, dynamicNode as f, effect as g, emitWithBatch as h, index as i, isBatching as j, pipe as k, producer as l, monotonicNs as m, partitionForBatch as p, state as s, wallClockNs as w };
+export { type DynGet as D, type PipeOperator as P, ResettableTimer as R, type DynamicNodeFn as a, DynamicNodeImpl as b, type DynamicNodeOptions as c, batch as d, derived as e, dynamicNode as f, effect as g, emitWithBatch as h, index as i, isBatching as j, pipe as k, producer as l, monotonicNs as m, partitionForBatch as p, state as s, wallClockNs as w };

package/dist/{index-CP_QvbWu.d.ts → index-DFFNKYig.d.ts}

@@ -1,8 +1,8 @@
-import { R as ReactiveLogSnapshot, o as observeGraph$, c as observeNode$, t as toMessages$, d as toObservable } from './reactive-log-ohLmTXoZ.js';
+import { R as ReactiveLogSnapshot, o as observeGraph$, c as observeNode$, t as toMessages$, d as toObservable } from './reactive-log-DwNhOe0g.js';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, a as GraphOptions, q as GraphPersistSnapshot } from './graph-D18qmsNm.js';
-import { A as Actor, N as Node } from './meta-BsF6Sag9.js';
+import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-CmiUuhaN.js';
+import { A as Actor, N as Node } from './meta-BJEU8fYz.js';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;