@graphrefly/ts 0.0.1 → 0.0.3

package/dist/adapters/nestjs.d.ts

@@ -0,0 +1,385 @@
+import { DataIssue } from '../data/index.js';
+import { d as Graph } from '../graph-CS0b4V9B.js';
+import { N as Node } from '../types-DChxk1vK.js';
+import '../core/index.js';
+import '../messages-CAzUPPJM.js';
+import '../codec-BB7p8fJc.js';
+import '../describe-cYr_Z5zm.js';
+
+/**
+ * Focused NestJS boundary bindings for GraphReFly (D474/D478).
+ *
+ * This subpath stays dependency-light: it exposes graph boundary primitives,
+ * token/provider shapes, and decorator metadata without importing Nest itself.
+ * User-land Nest modules/controllers bind these helpers to real decorators and
+ * host lifecycle objects at the framework edge.
+ */
+
+declare const NEST_BOUNDARY_ENVELOPE_VERSION = 1;
+declare const NEST_BOUNDARY_PAYLOAD_MAX_BYTES: number;
+declare const NEST_HTTP_DIAGNOSTICS_MAX_RETAINED = 100;
+/** D478 minimal graph-visible transport envelope. Payload must be data-only. */
+interface NestBoundaryEnvelope<T = unknown> {
+    readonly bindingId: string;
+    readonly version: number;
+    readonly payload: T;
+    readonly requestId?: string;
+}
+/** Reply-capable egress must carry host-private request correlation (D478). */
+type NestReplyEnvelope<T = unknown> = NestBoundaryEnvelope<T> & {
+    readonly requestId: string;
+};
+type NestBoundaryKind = "request" | "guard" | "interceptor" | "error" | "lifecycle" | "cron" | "diagnostics" | "ws" | "message";
+type NestEgressKind = "http" | "guard-decision" | "ws-ack" | "ws-reply" | "message-reply";
+type NestFilterMode = "handle" | "observe";
+type NestDiagnosticPhase = "adapter" | "http" | "guard" | "filter" | "cron" | "lifecycle" | "ws" | "message" | NestBoundaryKind | NestEgressKind;
+interface NestHttpResponsePayload<TBody = unknown> {
+    readonly status: number;
+    readonly body?: TBody;
+    readonly headers?: Record<string, string>;
+}
+interface HttpDataIssue extends DataIssue {
+    readonly status: number;
+    readonly body?: unknown;
+    readonly headers?: Record<string, string>;
+}
+type NestIssueResponse<THost = unknown> = (issue: DataIssue, host: THost) => NestHttpResponsePayload;
+type NestProtocolErrorResponse<THost = unknown> = (errorPayload: unknown, host: THost) => NestHttpResponsePayload;
+interface NestBoundaryDiagnostic {
+    readonly kind: "binding-mismatch" | "dispose-pending" | "malformed-egress" | "stale-egress" | "terminal-egress" | "timeout" | "resolve-threw" | "reject-threw";
+    readonly phase?: NestDiagnosticPhase;
+    readonly requestId?: string;
+    readonly bindingId?: string;
+    readonly expectedBindingId?: string;
+    readonly message: string;
+    readonly error?: unknown;
+}
+interface NestDiagnosticErrorPayload {
+    readonly name?: string;
+    readonly message: string;
+}
+interface NestDiagnosticPayload {
+    readonly kind: NestBoundaryDiagnostic["kind"];
+    readonly phase: NestDiagnosticPhase;
+    readonly requestId?: string;
+    readonly bindingId?: string;
+    readonly expectedBindingId?: string;
+    readonly message: string;
+    readonly error?: NestDiagnosticErrorPayload;
+}
+interface NestDiagnosticInput extends NestBoundaryDiagnostic {
+    readonly phase?: NestDiagnosticPhase;
+}
+interface NestDiagnosticsOptions extends Omit<NestIngressOptions<NestDiagnosticInput, NestDiagnosticPayload>, "payload"> {
+    readonly phase?: NestDiagnosticPhase;
+}
+type NestDiagnosticIngressBoundary = NestIngressBoundary<NestDiagnosticInput, NestDiagnosticPayload>;
+interface NestIngressBoundary<THost = unknown, TPayload = THost> {
+    readonly kind: NestBoundaryKind;
+    readonly bindingId: string;
+    readonly version: number;
+    readonly node: Node<NestBoundaryEnvelope<TPayload>>;
+    envelope(host: THost, opts?: NestIngressEmitOptions<TPayload>): NestBoundaryEnvelope<TPayload>;
+    emit(host: THost, opts?: NestIngressEmitOptions<TPayload>): NestBoundaryEnvelope<TPayload>;
+}
+interface NestIngressOptions<THost, TPayload> {
+    readonly bindingId?: string;
+    readonly name?: string;
+    readonly version?: number;
+    readonly maxPayloadBytes?: number;
+    readonly requestId?: string | ((host: THost) => string | undefined);
+    readonly requireRequestId?: boolean;
+    readonly payload?: (host: THost) => TPayload;
+}
+interface NestIngressEmitOptions<TPayload> {
+    readonly requestId?: string;
+    readonly bindingId?: string;
+    readonly version?: number;
+    readonly payload?: TPayload;
+    readonly requireRequestId?: boolean;
+}
+interface NestReplyResponseHandle<TPayload> {
+    resolve(payload: TPayload, envelope: NestReplyEnvelope<TPayload>): void;
+    reject(error: unknown, envelope?: NestReplyEnvelope<TPayload>): void;
+}
+interface NestReplyPendingRegistration<TPayload> {
+    readonly requestId: string;
+    readonly handle: NestReplyResponseHandle<TPayload>;
+    readonly bindingId?: string;
+}
+interface NestReplyBoundary<TPayload = unknown> {
+    readonly kind: NestEgressKind;
+    readonly bindingId: string;
+    attach(registration: NestReplyPendingRegistration<TPayload>): () => boolean;
+    pendingCount(): number;
+    diagnostics(): readonly NestBoundaryDiagnostic[];
+    dispose(): void;
+}
+interface NestHttpResponseHandle<TPayload> extends NestReplyResponseHandle<TPayload> {
+}
+interface NestHttpPendingRegistration<TPayload> extends NestReplyPendingRegistration<TPayload> {
+}
+interface NestHttpBoundary<TPayload = unknown> extends NestReplyBoundary<TPayload> {
+    readonly kind: "http";
+}
+interface ToNestHttpOptions<TPayload> {
+    readonly bindingId?: string;
+    readonly diagnosticBoundary?: NestDiagnosticIngressBoundary;
+    readonly diagnosticPhase?: NestDiagnosticPhase;
+    readonly maxDiagnostics?: number;
+    readonly maxPayloadBytes?: number;
+    readonly name?: string;
+    readonly transform?: (payload: TPayload, envelope: NestReplyEnvelope<TPayload>) => TPayload;
+    readonly label?: string;
+}
+interface NestBoundaryDecoratorOptions<THost = unknown, TPayload = unknown> {
+    readonly bindingId?: string;
+    readonly payload?: (host: THost) => TPayload;
+    readonly requestId?: string | ((host: THost) => string | undefined);
+    readonly order?: number;
+}
+interface NestFilterDecoratorOptions<THost = unknown, TPayload = unknown> extends NestBoundaryDecoratorOptions<THost, TPayload> {
+    readonly mode?: NestFilterMode;
+    readonly issueResponse?: NestIssueResponse<THost>;
+    readonly protocolError?: NestProtocolErrorResponse<THost>;
+}
+interface NestHttpReplyDecoratorOptions<THost = unknown> {
+    readonly bindingId: string;
+    readonly order?: number;
+    readonly issueResponse?: NestIssueResponse<THost>;
+    readonly protocolError?: NestProtocolErrorResponse<THost>;
+}
+interface NestGuardDecisionDecoratorOptions<THost = unknown> {
+    readonly bindingId: string;
+    readonly order?: number;
+    readonly issueResponse?: NestIssueResponse<THost>;
+    readonly protocolError?: NestProtocolErrorResponse<THost>;
+}
+interface NestGraphRunOptions<THost = unknown> {
+    readonly requestId?: string | ((host: THost) => string | undefined);
+}
+interface NestGraphBoundaryRunnerOptions {
+    readonly diagnosticBoundary?: NestDiagnosticIngressBoundary;
+    readonly diagnosticPhase?: NestDiagnosticPhase;
+}
+interface NestGraphBoundaryRunner {
+    run<THost = unknown>(target: DecoratorHostConstructor | object, methodKey: string | symbol, host: THost, opts?: NestGraphRunOptions<THost>): Promise<unknown> | undefined;
+    dispose(): void;
+}
+interface NestExecutionContextLike {
+    getClass(): DecoratorHostConstructor;
+    getHandler(): DecoratorBoundMethod;
+    switchToHttp?(): {
+        getRequest<T = unknown>(): T;
+    };
+}
+interface NestCallHandlerLike {
+    handle(): unknown;
+}
+interface NestGraphBoundaryInterceptorOptions<THost = unknown> extends NestGraphRunOptions<THost>, NestGraphBoundaryRunnerOptions {
+    readonly host?: (context: NestExecutionContextLike) => THost;
+    readonly runner?: NestGraphBoundaryRunner;
+}
+interface NestGraphBoundaryInterceptor {
+    intercept(context: NestExecutionContextLike, next?: NestCallHandlerLike): Promise<unknown> | unknown;
+    dispose(): void;
+}
+/** Injection token for a root graph singleton. */
+declare const GRAPHREFLY_ROOT_GRAPH: unique symbol;
+/** Injection token for adapter module options. */
+declare const GRAPHREFLY_MODULE_OPTIONS: unique symbol;
+/** Injection token for a request-scoped graph. */
+declare const GRAPHREFLY_REQUEST_GRAPH: unique symbol;
+type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;
+type DecoratorBoundMethod = (...args: unknown[]) => unknown;
+interface OnGraphEventMeta {
+    nodeName: string;
+    methodKey: string | symbol;
+}
+interface GraphIntervalMeta {
+    ms: number;
+    methodKey: string | symbol;
+}
+interface GraphCronMeta {
+    expr: string;
+    methodKey: string | symbol;
+}
+type NestBoundaryBindingDirection = "ingress" | "egress";
+interface NestIngressBindingMeta {
+    readonly direction: "ingress";
+    kind: NestBoundaryKind;
+    bindingId: string;
+    methodKey: string | symbol;
+    readonly boundary: NestIngressBoundary<unknown, unknown>;
+    readonly payload?: (host: unknown) => unknown;
+    readonly requestId?: string | ((host: unknown) => string | undefined);
+    readonly order?: number;
+    readonly mode?: NestFilterMode;
+    readonly issueResponse?: NestIssueResponse<unknown>;
+    readonly protocolError?: NestProtocolErrorResponse<unknown>;
+}
+interface NestHttpReplyBindingMeta {
+    readonly direction: "egress";
+    readonly kind: "http";
+    readonly bindingId: string;
+    readonly methodKey: string | symbol;
+    readonly replyNode: Node<NestReplyEnvelope<unknown>>;
+    readonly order?: number;
+    readonly issueResponse?: NestIssueResponse<unknown>;
+    readonly protocolError?: NestProtocolErrorResponse<unknown>;
+}
+interface NestGuardDecisionBindingMeta {
+    readonly direction: "egress";
+    readonly kind: "guard-decision";
+    readonly bindingId: string;
+    readonly methodKey: string | symbol;
+    readonly decisionNode: Node<NestReplyEnvelope<GraphGuardDecision>>;
+    readonly order?: number;
+    readonly issueResponse?: NestIssueResponse<unknown>;
+    readonly protocolError?: NestProtocolErrorResponse<unknown>;
+}
+interface NestWsAckBindingMeta {
+    readonly direction: "egress";
+    readonly kind: "ws-ack";
+    readonly bindingId: string;
+    readonly methodKey: string | symbol;
+    readonly ackNode: Node<NestReplyEnvelope<unknown>>;
+    readonly order?: number;
+}
+interface NestWsReplyBindingMeta {
+    readonly direction: "egress";
+    readonly kind: "ws-reply";
+    readonly bindingId: string;
+    readonly methodKey: string | symbol;
+    readonly replyNode: Node<NestReplyEnvelope<unknown>>;
+    readonly order?: number;
+}
+interface NestMessageReplyBindingMeta {
+    readonly direction: "egress";
+    readonly kind: "message-reply";
+    readonly bindingId: string;
+    readonly methodKey: string | symbol;
+    readonly replyNode: Node<NestReplyEnvelope<unknown>>;
+    readonly order?: number;
+}
+type NestBoundaryBindingMeta = NestIngressBindingMeta | NestHttpReplyBindingMeta | NestGuardDecisionBindingMeta | NestWsAckBindingMeta | NestWsReplyBindingMeta | NestMessageReplyBindingMeta;
+declare const EVENT_HANDLERS: WeakMap<DecoratorHostConstructor, OnGraphEventMeta[]>;
+declare const INTERVAL_HANDLERS: WeakMap<DecoratorHostConstructor, GraphIntervalMeta[]>;
+declare const CRON_HANDLERS: WeakMap<DecoratorHostConstructor, GraphCronMeta[]>;
+declare const NEST_BOUNDARY_BINDINGS: WeakMap<DecoratorHostConstructor, NestBoundaryBindingMeta[]>;
+type GraphMethodDecorator = MethodDecorator & ((value: DecoratorBoundMethod, context: ClassMethodDecoratorContext) => void);
+/** Minimal Nest provider object shape without importing @nestjs/common. */
+type NestProviderBinding<T = unknown> = {
+    readonly provide: string | symbol;
+    readonly useValue: T;
+} | {
+    readonly provide: string | symbol;
+    readonly useFactory: (...args: unknown[]) => T;
+};
+/** Get the injection token for a named feature graph. */
+declare function getGraphToken(name: string): symbol;
+/** Get the injection token for a node at a qualified path. */
+declare function getNodeToken(path: string): symbol;
+/** Get the injection token for a named Nest boundary binding. */
+declare function getNestBoundaryToken(bindingId: string): symbol;
+/** Build a dependency-free provider binding shape for user-land Nest modules. */
+declare function nestProvider<T>(provide: string | symbol, useValue: T): NestProviderBinding<T>;
+/** D474 P0 HTTP request ingress. */
+declare function fromNestReq<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D474 P0 guard/admission ingress. */
+declare function fromNestGuard<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D474 P1 interceptor ingress. */
+declare function fromNestIntercept<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D474 P0 error/filter ingress. */
+declare function fromNestError<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D474 P1 Nest lifecycle hook ingress. */
+declare function fromNestLifecycle<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D474 P1 schedule/cron ingress. */
+declare function fromNestCron<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D494 explicit graph-visible diagnostics ingress. Emits sanitized data-only payloads. */
+declare function fromNestDiagnostics(graph: Graph, opts?: NestDiagnosticsOptions): NestDiagnosticIngressBoundary;
+/** D474 later/optional WebSocket ingress. Kept thin for first-slice experiments. */
+declare function fromNestWs<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/** D474 later/optional microservice/message ingress. */
+declare function fromNestMessage<THost = unknown, TPayload = THost>(graph: Graph, opts?: NestIngressOptions<THost, TPayload>): NestIngressBoundary<THost, TPayload>;
+/**
+ * D474 HTTP egress resolver.
+ *
+ * The returned boundary owns only a host-private pending map. It never stores
+ * response/socket/ack handles in graph DATA and only resolves handles whose
+ * requestId (and optional bindingId) match an egress envelope.
+ */
+declare function toNestHttp<TPayload = unknown>(egress: Node<NestReplyEnvelope<TPayload>>, opts?: ToNestHttpOptions<TPayload>): NestHttpBoundary<TPayload>;
+/** D478 route-request decorator over an existing ingress boundary. */
+declare function GraphReq<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D478 route-guard decorator over an existing ingress boundary. */
+declare function GraphGuard<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D478 route-interceptor decorator over an existing ingress boundary. */
+declare function GraphIntercept<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D484 generic filter decorator over an existing ingress boundary. */
+declare function GraphFilter<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestFilterDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D484 exception-oriented sugar over GraphFilter. */
+declare function GraphError<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestFilterDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D478 lifecycle decorator over an existing ingress boundary. */
+declare function GraphLifecycle<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D478 cron/schedule decorator over an existing ingress boundary. */
+declare function GraphCron<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D488 WebSocket message ingress decorator over an existing boundary. */
+declare function GraphWs<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D488 microservice/message ingress decorator over an existing boundary. */
+declare function GraphMessage<THost = unknown, TPayload = unknown>(boundary: NestIngressBoundary<THost, TPayload>, opts?: NestBoundaryDecoratorOptions<THost, TPayload>): GraphMethodDecorator;
+/** D478 HTTP reply decorator over an existing reply node. */
+declare function GraphHttpReply<THost = unknown, TPayload = unknown>(replyNode: Node<NestReplyEnvelope<TPayload>>, opts: NestHttpReplyDecoratorOptions<THost>): GraphMethodDecorator;
+type GraphGuardDecision = {
+    readonly kind: "allow";
+    readonly reason?: string;
+    readonly metadata?: Record<string, unknown>;
+} | {
+    readonly kind: "deny";
+    readonly reason?: string;
+    readonly status?: number;
+    readonly body?: unknown;
+    readonly headers?: Record<string, string>;
+    readonly issue?: DataIssue | HttpDataIssue;
+    readonly metadata?: Record<string, unknown>;
+};
+/** D484 guard decision egress decorator over an existing reply-correlated decision node. */
+declare function GraphGuardDecision<THost = unknown>(decisionNode: Node<NestReplyEnvelope<GraphGuardDecision>>, opts: NestGuardDecisionDecoratorOptions<THost>): GraphMethodDecorator;
+/** D488 WebSocket acknowledgement egress decorator over an existing reply-correlated node. */
+declare function GraphWsAck<TPayload = unknown>(ackNode: Node<NestReplyEnvelope<TPayload>>, opts: {
+    readonly bindingId: string;
+    readonly order?: number;
+}): GraphMethodDecorator;
+/** D488 WebSocket reply egress decorator over an existing reply-correlated node. */
+declare function GraphWsReply<TPayload = unknown>(replyNode: Node<NestReplyEnvelope<TPayload>>, opts: {
+    readonly bindingId: string;
+    readonly order?: number;
+}): GraphMethodDecorator;
+/** D488 microservice/message reply egress decorator over an existing reply-correlated node. */
+declare function GraphMessageReply<TPayload = unknown>(replyNode: Node<NestReplyEnvelope<TPayload>>, opts: {
+    readonly bindingId: string;
+    readonly order?: number;
+}): GraphMethodDecorator;
+declare function createNestGraphBoundaryRunner(opts?: NestGraphBoundaryRunnerOptions): NestGraphBoundaryRunner;
+declare function createNestGraphBoundaryInterceptor<THost = unknown>(opts?: NestGraphBoundaryInterceptorOptions<THost>): NestGraphBoundaryInterceptor;
+declare function getNestBoundaryBindings(target: DecoratorHostConstructor | object, methodKey?: string | symbol): readonly NestBoundaryBindingMeta[];
+declare function resolveNestMethodKey(ctor: DecoratorHostConstructor, handler: DecoratorBoundMethod): string | symbol | undefined;
+declare function bindingRequestId<THost>(host: THost, binding: NestBoundaryBindingMeta, fallback?: string | ((host: THost) => string | undefined)): string | undefined;
+declare function bindingEmitOptions<THost>(host: THost, binding: NestIngressBindingMeta, requestId?: string): NestIngressEmitOptions<unknown>;
+declare function isDataIssue(value: unknown): value is DataIssue;
+declare function isHttpDataIssue(value: unknown): value is HttpDataIssue;
+declare function issueResponse<THost = unknown>(issue: DataIssue, _host?: THost): NestHttpResponsePayload;
+declare function protocolError<THost = unknown>(_errorPayload: unknown, _host?: THost): NestHttpResponsePayload;
+declare function lowerHttpReplyPayload<THost = unknown>(payload: unknown, host: THost, opts?: {
+    readonly issueResponse?: NestIssueResponse<THost>;
+}): NestHttpResponsePayload;
+declare function lowerProtocolError<THost = unknown>(errorPayload: unknown, host: THost, opts?: {
+    readonly protocolError?: NestProtocolErrorResponse<THost>;
+}): NestHttpResponsePayload;
+declare function sanitizeNestDiagnostic(diagnostic: NestDiagnosticInput, defaultPhase?: NestDiagnosticPhase): NestDiagnosticPayload;
+/** Register a method as a DATA-event handler for a graph observe path. */
+declare function OnGraphEvent(nodeName: string): GraphMethodDecorator;
+/** Register fixed-interval metadata for a user-land NestJS scheduler bridge. */
+declare function GraphInterval(ms: number): GraphMethodDecorator;
+
+export { CRON_HANDLERS, type DecoratorBoundMethod, type DecoratorHostConstructor, EVENT_HANDLERS, GRAPHREFLY_MODULE_OPTIONS, GRAPHREFLY_REQUEST_GRAPH, GRAPHREFLY_ROOT_GRAPH, GraphCron, type GraphCronMeta, GraphError, GraphFilter, GraphGuard, GraphGuardDecision, GraphHttpReply, GraphIntercept, GraphInterval, type GraphIntervalMeta, GraphLifecycle, GraphMessage, GraphMessageReply, type GraphMethodDecorator, GraphReq, GraphWs, GraphWsAck, GraphWsReply, type HttpDataIssue, INTERVAL_HANDLERS, NEST_BOUNDARY_BINDINGS, NEST_BOUNDARY_ENVELOPE_VERSION, NEST_BOUNDARY_PAYLOAD_MAX_BYTES, NEST_HTTP_DIAGNOSTICS_MAX_RETAINED, type NestBoundaryBindingDirection, type NestBoundaryBindingMeta, type NestBoundaryDecoratorOptions, type NestBoundaryDiagnostic, type NestBoundaryEnvelope, type NestBoundaryKind, type NestCallHandlerLike, type NestDiagnosticErrorPayload, type NestDiagnosticIngressBoundary, type NestDiagnosticInput, type NestDiagnosticPayload, type NestDiagnosticPhase, type NestDiagnosticsOptions, type NestEgressKind, type NestExecutionContextLike, type NestFilterDecoratorOptions, type NestFilterMode, type NestGraphBoundaryInterceptor, type NestGraphBoundaryInterceptorOptions, type NestGraphBoundaryRunner, type NestGraphBoundaryRunnerOptions, type NestGraphRunOptions, type NestGuardDecisionBindingMeta, type NestGuardDecisionDecoratorOptions, type NestHttpBoundary, type NestHttpPendingRegistration, type NestHttpReplyBindingMeta, type NestHttpReplyDecoratorOptions, type NestHttpResponseHandle, type NestHttpResponsePayload, type NestIngressBindingMeta, type NestIngressBoundary, type NestIngressEmitOptions, type NestIngressOptions, type NestIssueResponse, type NestMessageReplyBindingMeta, type NestProtocolErrorResponse, type NestProviderBinding, type NestReplyBoundary, type NestReplyEnvelope, type NestReplyPendingRegistration, type NestReplyResponseHandle, type NestWsAckBindingMeta, type NestWsReplyBindingMeta, OnGraphEvent, type OnGraphEventMeta, type ToNestHttpOptions, bindingEmitOptions, bindingRequestId, createNestGraphBoundaryInterceptor, createNestGraphBoundaryRunner, fromNestCron, fromNestDiagnostics, fromNestError, fromNestGuard, fromNestIntercept, fromNestLifecycle, fromNestMessage, fromNestReq, fromNestWs, getGraphToken, getNestBoundaryBindings, getNestBoundaryToken, getNodeToken, isDataIssue, isHttpDataIssue, issueResponse, lowerHttpReplyPayload, lowerProtocolError, nestProvider, protocolError, resolveNestMethodKey, sanitizeNestDiagnostic, toNestHttp };

package/dist/adapters/nestjs.js

@@ -0,0 +1,112 @@
+import {
+  CRON_HANDLERS,
+  EVENT_HANDLERS,
+  GRAPHREFLY_MODULE_OPTIONS,
+  GRAPHREFLY_REQUEST_GRAPH,
+  GRAPHREFLY_ROOT_GRAPH,
+  GraphCron,
+  GraphError,
+  GraphFilter,
+  GraphGuard,
+  GraphGuardDecision,
+  GraphHttpReply,
+  GraphIntercept,
+  GraphInterval,
+  GraphLifecycle,
+  GraphMessage,
+  GraphMessageReply,
+  GraphReq,
+  GraphWs,
+  GraphWsAck,
+  GraphWsReply,
+  INTERVAL_HANDLERS,
+  NEST_BOUNDARY_BINDINGS,
+  NEST_BOUNDARY_ENVELOPE_VERSION,
+  NEST_BOUNDARY_PAYLOAD_MAX_BYTES,
+  NEST_HTTP_DIAGNOSTICS_MAX_RETAINED,
+  OnGraphEvent,
+  bindingEmitOptions,
+  bindingRequestId,
+  createNestGraphBoundaryInterceptor,
+  createNestGraphBoundaryRunner,
+  fromNestCron,
+  fromNestDiagnostics,
+  fromNestError,
+  fromNestGuard,
+  fromNestIntercept,
+  fromNestLifecycle,
+  fromNestMessage,
+  fromNestReq,
+  fromNestWs,
+  getGraphToken,
+  getNestBoundaryBindings,
+  getNestBoundaryToken,
+  getNodeToken,
+  isDataIssue,
+  isHttpDataIssue,
+  issueResponse,
+  lowerHttpReplyPayload,
+  lowerProtocolError,
+  nestProvider,
+  protocolError,
+  resolveNestMethodKey,
+  sanitizeNestDiagnostic,
+  toNestHttp
+} from "../chunk-MQEQMS7B.js";
+import "../chunk-DGUM43GV.js";
+export {
+  CRON_HANDLERS,
+  EVENT_HANDLERS,
+  GRAPHREFLY_MODULE_OPTIONS,
+  GRAPHREFLY_REQUEST_GRAPH,
+  GRAPHREFLY_ROOT_GRAPH,
+  GraphCron,
+  GraphError,
+  GraphFilter,
+  GraphGuard,
+  GraphGuardDecision,
+  GraphHttpReply,
+  GraphIntercept,
+  GraphInterval,
+  GraphLifecycle,
+  GraphMessage,
+  GraphMessageReply,
+  GraphReq,
+  GraphWs,
+  GraphWsAck,
+  GraphWsReply,
+  INTERVAL_HANDLERS,
+  NEST_BOUNDARY_BINDINGS,
+  NEST_BOUNDARY_ENVELOPE_VERSION,
+  NEST_BOUNDARY_PAYLOAD_MAX_BYTES,
+  NEST_HTTP_DIAGNOSTICS_MAX_RETAINED,
+  OnGraphEvent,
+  bindingEmitOptions,
+  bindingRequestId,
+  createNestGraphBoundaryInterceptor,
+  createNestGraphBoundaryRunner,
+  fromNestCron,
+  fromNestDiagnostics,
+  fromNestError,
+  fromNestGuard,
+  fromNestIntercept,
+  fromNestLifecycle,
+  fromNestMessage,
+  fromNestReq,
+  fromNestWs,
+  getGraphToken,
+  getNestBoundaryBindings,
+  getNestBoundaryToken,
+  getNodeToken,
+  isDataIssue,
+  isHttpDataIssue,
+  issueResponse,
+  lowerHttpReplyPayload,
+  lowerProtocolError,
+  nestProvider,
+  protocolError,
+  resolveNestMethodKey,
+  sanitizeNestDiagnostic,
+  toNestHttp
+};
+//# sourceMappingURL=nestjs.js.map

package/dist/adapters/nestjs.js.map

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

package/dist/adapters/observe-storage.d.cts

@@ -1,12 +1,12 @@
-import { O as ObserveEvent, d as Graph } from '../graph-DCEWh4T2.cjs';
+import { O as ObserveEvent, d as Graph } from '../graph-C1C-wb0L.cjs';
 import { d as AppendLogStorageTier } from '../append-log-DisvEReb.cjs';
 import { O as ObserveEventFrame } from '../observe-event-log-0SVsx7JG.cjs';
 export { c as ObserveEventLogPage } from '../observe-event-log-0SVsx7JG.cjs';
 import '../core/index.cjs';
-import '../types-CcPIn7sy.cjs';
+import '../types-CTN3XoMl.cjs';
 import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-DYMw_l1C.cjs';
+import '../describe-BumQ-3_0.cjs';
 
 /**
  * Graph-bound observe storage adapters.

package/dist/adapters/observe-storage.d.ts

@@ -1,12 +1,12 @@
-import { O as ObserveEvent, d as Graph } from '../graph-D-1-SQeC.js';
+import { O as ObserveEvent, d as Graph } from '../graph-CS0b4V9B.js';
 import { d as AppendLogStorageTier } from '../append-log-DzKMmjxx.js';
 import { O as ObserveEventFrame } from '../observe-event-log-Dnm76owp.js';
 export { c as ObserveEventLogPage } from '../observe-event-log-Dnm76owp.js';
 import '../core/index.js';
-import '../types-BsJvElYZ.js';
+import '../types-DChxk1vK.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-BpyJuWkw.js';
+import '../describe-cYr_Z5zm.js';
 
 /**
  * Graph-bound observe storage adapters.

package/dist/adapters/observe-storage.js

@@ -1,9 +1,9 @@
 import {
   observeEventFrame
-} from "../chunk-K3FXTC3I.js";
-import "../chunk-6PHB5CJS.js";
-import "../chunk-DKP56CSW.js";
-import "../chunk-4VLAQHZI.js";
+} from "../chunk-HJACH5PU.js";
+import "../chunk-ZLFRB6FI.js";
+import "../chunk-JKAYLDQV.js";
+import "../chunk-K7FB3JTD.js";
 import "../chunk-DGUM43GV.js";
 
 // src/adapters/observe-storage.ts

package/dist/adapters/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/react.ts","../../src/adapters/store.ts"],"sourcesContent":["/**\n * React node bindings for GraphReFly (D238).\n *\n * React is imported only from this focused subpath. The dependency-free\n * `@graphrefly/ts/adapters` barrel keeps the framework-neutral store contract.\n */\n\nimport { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type { Node } from \"../node/node.js\";\nimport { externalStore, recordReadableStore, type WritableNode } from \"./store.js\";\n\nfunction assertDataValue(value: unknown): void {\n\tif (value === undefined) {\n\t\tthrow new TypeError(\"useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value\");\n\t}\n}\n\n/** Read a GraphReFly node through React's useSyncExternalStore contract. */\nexport function useNodeValue<T>(node: Node<T>): T | undefined {\n\tconst store = useMemo(() => externalStore(node), [node]);\n\treturn useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);\n}\n\n/**\n * Bind a writable GraphReFly node as `[value, setValue]`.\n *\n * The setter identity is stable for a stable node identity, and writes through\n * the node's reactive DATA boundary rather than a presentation-owned trigger.\n */\nexport function useNodeInput<T>(\n\tnode: WritableNode<T>,\n): readonly [T | undefined, (value: T) => void] {\n\tconst value = useNodeValue(node);\n\tconst setValue = useCallback(\n\t\t(next: T) => {\n\t\t\tassertDataValue(next);\n\t\t\tnode.set(next);\n\t\t},\n\t\t[node],\n\t);\n\treturn [value, setValue] as const;\n}\n\n/**\n * Read a keyed record of nodes.\n *\n * `factory` must have stable identity. Recreating it on every render forces the\n * record subscription graph to rebuild on every render.\n */\nexport function useNodeRecord<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: (key: K) => { [P in keyof R]: Node<R[P]> },\n): Record<K, R> {\n\tconst store = useMemo(() => {\n\t\tconst recordStore = recordReadableStore(keysNode, factory);\n\t\tlet current = recordStore.get() ?? ({} as Record<K, R>);\n\t\treturn {\n\t\t\tgetSnapshot: () => current,\n\t\t\tsubscribe(onStoreChange: () => void) {\n\t\t\t\treturn recordStore.subscribe((next) => {\n\t\t\t\t\tcurrent = next ?? ({} as Record<K, R>);\n\t\t\t\t\tonStoreChange();\n\t\t\t\t});\n\t\t\t},\n\t\t};\n\t}, [keysNode, factory]);\n\tconst getSnapshot = useCallback(() => store.getSnapshot(), [store]);\n\treturn useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);\n}\n","/**\n * Framework-neutral store adapters.\n *\n * Focused framework bindings build on this tiny Node-facing layer without\n * importing framework packages into the dependency-free adapters barrel\n * (D125/D238).\n */\n\nimport type { DeliveryMeta, Sink } from \"../ctx/types.js\";\nimport type { Node } from \"../node/node.js\";\n\n/** A minimal readable store contract shared by Svelte/Nanostores-style adapters. */\nexport interface ReadableStore<T> {\n\tget(): T | undefined;\n\tsubscribe(run: (value: T | undefined) => void): () => void;\n}\n\n/** A minimal writable store contract over a clean-slate writable node. */\nexport interface WritableStore<T> extends ReadableStore<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** React `useSyncExternalStore`-compatible shape, without importing React. */\nexport interface ExternalStore<T> {\n\tgetSnapshot(): T | undefined;\n\tgetServerSnapshot(): T | undefined;\n\tsubscribe(onStoreChange: () => void): () => void;\n}\n\n/** Object-of-nodes factory used by record subscription adapters. */\nexport type NodeRecordFactory<K extends string, R extends Record<string, unknown>> = (key: K) => {\n\t[P in keyof R]: Node<R[P]>;\n};\n\n/** Zustand-compatible store API over a caller-owned clean-slate state node. */\nexport interface ZustandStoreApi<T extends object> {\n\tgetState(): T;\n\tsetState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean): void;\n\tgetInitialState(): T;\n\tsubscribe(listener: (state: T, prevState: T) => void): () => void;\n\tdestroy(): void;\n}\n\n/** Jotai-style atom facade over a caller-owned node. */\nexport interface JotaiAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Jotai-style atom facade over a caller-owned writable node. */\nexport interface WritableJotaiAtom<T> extends JotaiAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** Nanostores-style atom facade over a caller-owned node. */\nexport interface NanoAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\tlisten(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Nanostores-style atom facade over a caller-owned writable node. */\nexport interface WritableNanoAtom<T> extends NanoAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** TC39-Signals-style facade over a caller-owned node. */\nexport interface SignalLike<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable TC39-Signals-style facade over a caller-owned writable node. */\nexport interface WritableSignalLike<T> extends SignalLike<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\nexport interface SubscribeValuesOptions<T> {\n\t/** Emit the current cache snapshot immediately. `undefined` means SENTINEL/no DATA. */\n\timmediate?: boolean;\n\t/** Suppress synchronous push-on-subscribe/replay DATA. Useful for change-only store listeners. */\n\tchangesOnly?: boolean;\n\tonError?: (error: unknown) => void;\n\tonComplete?: () => void;\n\t/** Custom cache reader for wrappers that keep their own snapshot object. */\n\tgetSnapshot?: () => T | undefined;\n}\n\nexport interface WritableNode<T> extends Node<T> {\n\tset(value: T): void;\n}\n\nexport interface WritableStoreOptions<T> extends SubscribeValuesOptions<T> {\n\t/** Override writes for adapters that need a framework-owned reducer. */\n\twrite?: (node: WritableNode<T>, value: T) => void;\n}\n\n/** Read a node cache without activating it. */\nexport function nodeSnapshot<T>(node: Node<T>): T | undefined {\n\treturn node.cache as T | undefined;\n}\n\n/**\n * Subscribe to DATA values from a Node. Protocol internals stay below the adapter boundary:\n * DATA drives value listeners, ERROR/COMPLETE route to optional lifecycle callbacks.\n */\nexport function subscribeNodeValues<T>(\n\tnode: Node<T>,\n\trun: (value: T | undefined) => void,\n\topts: SubscribeValuesOptions<T> = {},\n): () => void {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tif (opts.immediate) run(read());\n\n\tlet subscribing = true;\n\tconst skipSynchronousHandshakeData = opts.changesOnly || opts.immediate;\n\tconst sink: Sink = (msg, delivery?: DeliveryMeta) => {\n\t\tswitch (msg[0]) {\n\t\t\tcase \"DATA\":\n\t\t\t\tif (skipSynchronousHandshakeData && subscribing && delivery === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\trun(msg[1] as T);\n\t\t\t\treturn;\n\t\t\tcase \"ERROR\":\n\t\t\t\topts.onError?.(msg[1]);\n\t\t\t\treturn;\n\t\t\tcase \"COMPLETE\":\n\t\t\t\topts.onComplete?.();\n\t\t\t\treturn;\n\t\t}\n\t};\n\tconst unsubscribe = node.subscribe(sink);\n\tsubscribing = false;\n\treturn unsubscribe;\n}\n\n/** Build a Svelte/Nanostores-style readable store from a clean-slate Node. */\nexport function readableStore<T>(\n\tnode: Node<T>,\n\topts: SubscribeValuesOptions<T> = {},\n): ReadableStore<T> {\n\treturn {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t};\n}\n\nfunction hasWritableSet<T>(node: Node<T>): node is WritableNode<T> {\n\treturn typeof (node as { set?: unknown }).set === \"function\";\n}\n\nfunction defaultWrite<T>(node: WritableNode<T>, value: T): void {\n\tnode.set(value);\n}\n\n/** Build a writable store over a StateNode or compatible clean-slate writable Node. */\nexport function writableStore<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> = {},\n): WritableStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"writableStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\treturn {\n\t\tget: read,\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t\tset: (value) => write(writable, value),\n\t\tupdate: (fn) => write(writable, fn(read())),\n\t};\n}\n\n/** Build the tiny shape React's `useSyncExternalStore` expects, without importing React. */\nexport function externalStore<T>(\n\tnode: Node<T>,\n\topts: Pick<SubscribeValuesOptions<T>, \"getSnapshot\" | \"onError\" | \"onComplete\"> = {},\n): ExternalStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\treturn {\n\t\tgetSnapshot: read,\n\t\tgetServerSnapshot: read,\n\t\tsubscribe: (onStoreChange) =>\n\t\t\tsubscribeNodeValues(node, () => onStoreChange(), {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t}),\n\t};\n}\n\n/** Build a framework-neutral keyed record store for focused framework record bindings. */\nexport function recordReadableStore<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: NodeRecordFactory<K, R>,\n\topts: SubscribeValuesOptions<Record<K, R>> = {},\n): ReadableStore<Record<K, R>> {\n\tconst read = () => {\n\t\tconst keys = keysNode.cache ?? [];\n\t\tconst out = {} as Record<K, R>;\n\t\tfor (const key of keys) {\n\t\t\tconst nodes = factory(key);\n\t\t\tconst values = {} as R;\n\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\tvalues[field] = nodes[field].cache as R[keyof R];\n\t\t\t}\n\t\t\tout[key] = values;\n\t\t}\n\t\treturn out;\n\t};\n\n\treturn {\n\t\tget: read,\n\t\tsubscribe(run) {\n\t\t\tconst entryUnsubs: Array<() => void> = [];\n\t\t\tconst cleanupEntries = () => {\n\t\t\t\tfor (const unsub of entryUnsubs.splice(0)) unsub();\n\t\t\t};\n\t\t\tconst sync = () => {\n\t\t\t\tcleanupEntries();\n\t\t\t\tfor (const key of keysNode.cache ?? []) {\n\t\t\t\t\tconst nodes = factory(key);\n\t\t\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\t\t\tentryUnsubs.push(\n\t\t\t\t\t\t\tsubscribeNodeValues(nodes[field], () => run(read()), {\n\t\t\t\t\t\t\t\tchangesOnly: true,\n\t\t\t\t\t\t\t\tonError: opts.onError,\n\t\t\t\t\t\t\t\tonComplete: opts.onComplete,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trun(read());\n\t\t\t};\n\t\t\tconst keysUnsub = subscribeNodeValues(keysNode, sync, {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t});\n\t\t\tsync();\n\t\t\treturn () => {\n\t\t\t\tkeysUnsub();\n\t\t\t\tcleanupEntries();\n\t\t\t};\n\t\t},\n\t};\n}\n\n/** Build a Zustand-compatible StoreApi over a caller-owned clean-slate state node. */\nexport function zustandStore<T extends object>(\n\tnode: WritableNode<T>,\n\tinitialState?: T,\n\topts?: WritableStoreOptions<T>,\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T | undefined,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T = nodeSnapshot(node) as T,\n\topts: WritableStoreOptions<T> = {},\n): ZustandStoreApi<T> {\n\tconst listeners = new Set<() => void>();\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"zustandStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\tconst api: ZustandStoreApi<T> = {\n\t\tgetState: () => read() as T,\n\t\tsetState(partial, replace) {\n\t\t\tconst prev = api.getState();\n\t\t\tconst next = typeof partial === \"function\" ? partial(prev) : partial;\n\t\t\twrite(writable, replace ? (next as T) : ({ ...prev, ...next } as T));\n\t\t},\n\t\tgetInitialState: () => initialState,\n\t\tsubscribe(listener) {\n\t\t\tlet prev = api.getState();\n\t\t\tconst unsub = subscribeNodeValues(\n\t\t\t\tnode,\n\t\t\t\t(value) => {\n\t\t\t\t\tconst next = value as T;\n\t\t\t\t\tlistener(next, prev);\n\t\t\t\t\tprev = next;\n\t\t\t\t},\n\t\t\t\t{ changesOnly: true, onError: opts.onError, onComplete: opts.onComplete },\n\t\t\t);\n\t\t\tlisteners.add(unsub);\n\t\t\treturn () => {\n\t\t\t\tif (!listeners.delete(unsub)) return;\n\t\t\t\tunsub();\n\t\t\t};\n\t\t},\n\t\tdestroy() {\n\t\t\tfor (const unsub of [...listeners]) {\n\t\t\t\tlisteners.delete(unsub);\n\t\t\t\tunsub();\n\t\t\t}\n\t\t},\n\t};\n\treturn api;\n}\n\n/** Build a Jotai-style atom facade over a caller-owned node. */\nexport function jotaiAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableJotaiAtom<T>;\nexport function jotaiAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): JotaiAtom<T>;\nexport function jotaiAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): JotaiAtom<T> | WritableJotaiAtom<T> {\n\tconst base: JotaiAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a Nanostores-style atom facade over a caller-owned node. */\nexport function nanoAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableNanoAtom<T>;\nexport function nanoAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): NanoAtom<T>;\nexport function nanoAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): NanoAtom<T> | WritableNanoAtom<T> {\n\tconst base: NanoAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { immediate: true, ...opts }),\n\t\tlisten: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a TC39-Signals-style facade over a caller-owned node. */\nexport function signalFromNode<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableSignalLike<T>;\nexport function signalFromNode<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): SignalLike<T>;\nexport function signalFromNode<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): SignalLike<T> | WritableSignalLike<T> {\n\tconst base: SignalLike<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/adapters/react.ts","../../src/adapters/store.ts"],"sourcesContent":["/**\n * React node bindings for GraphReFly (D238).\n *\n * React is imported only from this focused subpath. The dependency-free\n * `@graphrefly/ts/adapters` barrel keeps the framework-neutral store contract.\n */\n\nimport { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type { Node } from \"../node/node.js\";\nimport { externalStore, recordReadableStore, type WritableNode } from \"./store.js\";\n\nfunction assertDataValue(value: unknown): void {\n\tif (value === undefined) {\n\t\tthrow new TypeError(\"useNodeInput: undefined is SENTINEL/no DATA, not a writable DATA value\");\n\t}\n}\n\n/** Read a GraphReFly node through React's useSyncExternalStore contract. */\nexport function useNodeValue<T>(node: Node<T>): T | undefined {\n\tconst store = useMemo(() => externalStore(node), [node]);\n\treturn useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);\n}\n\n/**\n * Bind a writable GraphReFly node as `[value, setValue]`.\n *\n * The setter identity is stable for a stable node identity, and writes through\n * the node's reactive DATA boundary rather than a presentation-owned trigger.\n */\nexport function useNodeInput<T>(\n\tnode: WritableNode<T>,\n): readonly [T | undefined, (value: T) => void] {\n\tconst value = useNodeValue(node);\n\tconst setValue = useCallback(\n\t\t(next: T) => {\n\t\t\tassertDataValue(next);\n\t\t\tnode.set(next);\n\t\t},\n\t\t[node],\n\t);\n\treturn [value, setValue] as const;\n}\n\n/**\n * Read a keyed record of nodes.\n *\n * `factory` must have stable identity. Recreating it on every render forces the\n * record subscription graph to rebuild on every render.\n */\nexport function useNodeRecord<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: (key: K) => { [P in keyof R]: Node<R[P]> },\n): Record<K, R> {\n\tconst store = useMemo(() => {\n\t\tconst recordStore = recordReadableStore(keysNode, factory);\n\t\tlet current = recordStore.get() ?? ({} as Record<K, R>);\n\t\treturn {\n\t\t\tgetSnapshot: () => current,\n\t\t\tsubscribe(onStoreChange: () => void) {\n\t\t\t\treturn recordStore.subscribe((next) => {\n\t\t\t\t\tcurrent = next ?? ({} as Record<K, R>);\n\t\t\t\t\tonStoreChange();\n\t\t\t\t});\n\t\t\t},\n\t\t};\n\t}, [keysNode, factory]);\n\tconst getSnapshot = useCallback(() => store.getSnapshot(), [store]);\n\treturn useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);\n}\n","/**\n * Framework-neutral store adapters.\n *\n * Focused framework bindings build on this tiny Node-facing layer without\n * importing framework packages into the dependency-free adapters barrel\n * (D125/D238).\n */\n\nimport type { DeliveryMeta, Sink } from \"../ctx/types.js\";\nimport type { Node } from \"../node/node.js\";\n\n/** A minimal readable store contract shared by Svelte/Nanostores-style adapters. */\nexport interface ReadableStore<T> {\n\tget(): T | undefined;\n\tsubscribe(run: (value: T | undefined) => void): () => void;\n}\n\n/** A minimal writable store contract over a clean-slate writable node. */\nexport interface WritableStore<T> extends ReadableStore<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** React `useSyncExternalStore`-compatible shape, without importing React. */\nexport interface ExternalStore<T> {\n\tgetSnapshot(): T | undefined;\n\tgetServerSnapshot(): T | undefined;\n\tsubscribe(onStoreChange: () => void): () => void;\n}\n\n/** Object-of-nodes factory used by record subscription adapters. */\nexport type NodeRecordFactory<K extends string, R extends Record<string, unknown>> = (key: K) => {\n\t[P in keyof R]: Node<R[P]>;\n};\n\n/** Zustand-compatible store API over a caller-owned clean-slate state node. */\nexport interface ZustandStoreApi<T extends object> {\n\tgetState(): T;\n\tsetState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean): void;\n\tgetInitialState(): T;\n\tsubscribe(listener: (state: T, prevState: T) => void): () => void;\n\tdestroy(): void;\n}\n\n/** Jotai-style atom facade over a caller-owned node. */\nexport interface JotaiAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Jotai-style atom facade over a caller-owned writable node. */\nexport interface WritableJotaiAtom<T> extends JotaiAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** Nanostores-style atom facade over a caller-owned node. */\nexport interface NanoAtom<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\tlisten(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable Nanostores-style atom facade over a caller-owned writable node. */\nexport interface WritableNanoAtom<T> extends NanoAtom<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\n/** TC39-Signals-style facade over a caller-owned node. */\nexport interface SignalLike<T> {\n\tget(): T | undefined;\n\tsubscribe(callback: (value: T | undefined) => void): () => void;\n\treadonly _node: Node<T>;\n}\n\n/** Writable TC39-Signals-style facade over a caller-owned writable node. */\nexport interface WritableSignalLike<T> extends SignalLike<T> {\n\tset(value: T): void;\n\tupdate(fn: (value: T | undefined) => T): void;\n}\n\nexport interface SubscribeValuesOptions<T> {\n\t/** Emit the current cache snapshot immediately. `undefined` means SENTINEL/no DATA. */\n\timmediate?: boolean;\n\t/** Suppress synchronous push-on-subscribe/replay DATA. Useful for change-only store listeners. */\n\tchangesOnly?: boolean;\n\tonError?: (error: unknown) => void;\n\tonComplete?: () => void;\n\t/** Custom cache reader for wrappers that keep their own snapshot object. */\n\tgetSnapshot?: () => T | undefined;\n}\n\nexport interface WritableNode<T> extends Node<T> {\n\tset(value: T): void;\n}\n\nexport interface WritableStoreOptions<T> extends SubscribeValuesOptions<T> {\n\t/** Override writes for adapters that need a framework-owned reducer. */\n\twrite?: (node: WritableNode<T>, value: T) => void;\n}\n\n/** Read a node cache without activating it. */\nexport function nodeSnapshot<T>(node: Node<T>): T | undefined {\n\treturn node.cache as T | undefined;\n}\n\n/**\n * Subscribe to DATA values from a Node. Protocol internals stay below the adapter boundary:\n * DATA drives value listeners, ERROR/COMPLETE route to optional lifecycle callbacks.\n */\nexport function subscribeNodeValues<T>(\n\tnode: Node<T>,\n\trun: (value: T | undefined) => void,\n\topts: SubscribeValuesOptions<T> = {},\n): () => void {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tif (opts.immediate) run(read());\n\n\tlet subscribing = true;\n\tconst skipSynchronousHandshakeData = opts.changesOnly || opts.immediate;\n\tconst sink: Sink = (msg, delivery?: DeliveryMeta) => {\n\t\tswitch (msg[0]) {\n\t\t\tcase \"DATA\":\n\t\t\t\tif (skipSynchronousHandshakeData && subscribing && delivery === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\trun(msg[1] as T);\n\t\t\t\treturn;\n\t\t\tcase \"ERROR\":\n\t\t\t\topts.onError?.(msg[1]);\n\t\t\t\treturn;\n\t\t\tcase \"COMPLETE\":\n\t\t\t\topts.onComplete?.();\n\t\t\t\treturn;\n\t\t}\n\t};\n\tconst unsubscribe = node.subscribe(sink);\n\tsubscribing = false;\n\treturn unsubscribe;\n}\n\n/** Build a Svelte/Nanostores-style readable store from a clean-slate Node. */\nexport function readableStore<T>(\n\tnode: Node<T>,\n\topts: SubscribeValuesOptions<T> = {},\n): ReadableStore<T> {\n\treturn {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t};\n}\n\nfunction hasWritableSet<T>(node: Node<T>): node is WritableNode<T> {\n\treturn typeof (node as { set?: unknown }).set === \"function\";\n}\n\nfunction defaultWrite<T>(node: WritableNode<T>, value: T): void {\n\tnode.set(value);\n}\n\n/** Build a writable store over a StateNode or compatible clean-slate writable Node. */\nexport function writableStore<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): WritableStore<T>;\nexport function writableStore<T>(\n\tnode: Node<T>,\n\topts: WritableStoreOptions<T> = {},\n): WritableStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"writableStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\treturn {\n\t\tget: read,\n\t\tsubscribe: (run) => subscribeNodeValues(node, run, { immediate: true, ...opts }),\n\t\tset: (value) => write(writable, value),\n\t\tupdate: (fn) => write(writable, fn(read())),\n\t};\n}\n\n/** Build the tiny shape React's `useSyncExternalStore` expects, without importing React. */\nexport function externalStore<T>(\n\tnode: Node<T>,\n\topts: Pick<SubscribeValuesOptions<T>, \"getSnapshot\" | \"onError\" | \"onComplete\"> = {},\n): ExternalStore<T> {\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\treturn {\n\t\tgetSnapshot: read,\n\t\tgetServerSnapshot: read,\n\t\tsubscribe: (onStoreChange) =>\n\t\t\tsubscribeNodeValues(node, () => onStoreChange(), {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t}),\n\t};\n}\n\n/** Build a framework-neutral keyed record store for focused framework record bindings. */\nexport function recordReadableStore<K extends string, R extends Record<string, unknown>>(\n\tkeysNode: Node<readonly K[]>,\n\tfactory: NodeRecordFactory<K, R>,\n\topts: SubscribeValuesOptions<Record<K, R>> = {},\n): ReadableStore<Record<K, R>> {\n\tconst read = () => {\n\t\tconst keys = keysNode.cache ?? [];\n\t\tconst out = {} as Record<K, R>;\n\t\tfor (const key of keys) {\n\t\t\tconst nodes = factory(key);\n\t\t\tconst values = {} as R;\n\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\tvalues[field] = nodes[field].cache as R[keyof R];\n\t\t\t}\n\t\t\tout[key] = values;\n\t\t}\n\t\treturn out;\n\t};\n\n\treturn {\n\t\tget: read,\n\t\tsubscribe(run) {\n\t\t\tconst entryUnsubs: Array<() => void> = [];\n\t\t\tconst cleanupEntries = () => {\n\t\t\t\tfor (const unsub of entryUnsubs.splice(0)) unsub();\n\t\t\t};\n\t\t\tconst sync = () => {\n\t\t\t\tcleanupEntries();\n\t\t\t\tfor (const key of keysNode.cache ?? []) {\n\t\t\t\t\tconst nodes = factory(key);\n\t\t\t\t\tfor (const field of Object.keys(nodes) as Array<keyof R>) {\n\t\t\t\t\t\tentryUnsubs.push(\n\t\t\t\t\t\t\tsubscribeNodeValues(nodes[field], () => run(read()), {\n\t\t\t\t\t\t\t\tchangesOnly: true,\n\t\t\t\t\t\t\t\tonError: opts.onError,\n\t\t\t\t\t\t\t\tonComplete: opts.onComplete,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trun(read());\n\t\t\t};\n\t\t\tconst keysUnsub = subscribeNodeValues(keysNode, sync, {\n\t\t\t\tchangesOnly: true,\n\t\t\t\tonError: opts.onError,\n\t\t\t\tonComplete: opts.onComplete,\n\t\t\t});\n\t\t\tsync();\n\t\t\treturn () => {\n\t\t\t\tkeysUnsub();\n\t\t\t\tcleanupEntries();\n\t\t\t};\n\t\t},\n\t};\n}\n\n/** Build a Zustand-compatible StoreApi over a caller-owned clean-slate state node. */\nexport function zustandStore<T extends object>(\n\tnode: WritableNode<T>,\n\tinitialState?: T,\n\topts?: WritableStoreOptions<T>,\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T | undefined,\n\topts: WritableStoreOptions<T> & { write: (node: WritableNode<T>, value: T) => void },\n): ZustandStoreApi<T>;\nexport function zustandStore<T extends object>(\n\tnode: Node<T>,\n\tinitialState: T = nodeSnapshot(node) as T,\n\topts: WritableStoreOptions<T> = {},\n): ZustandStoreApi<T> {\n\tconst listeners = new Set<() => void>();\n\tconst read = opts.getSnapshot ?? (() => nodeSnapshot(node));\n\tconst write = opts.write ?? (hasWritableSet(node) ? defaultWrite : undefined);\n\tif (!write) {\n\t\tthrow new TypeError(\"zustandStore: node must expose set(value) or opts.write\");\n\t}\n\tconst writable = node as WritableNode<T>;\n\tconst api: ZustandStoreApi<T> = {\n\t\tgetState: () => read() as T,\n\t\tsetState(partial, replace) {\n\t\t\tconst prev = api.getState();\n\t\t\tconst next = typeof partial === \"function\" ? partial(prev) : partial;\n\t\t\twrite(writable, replace ? (next as T) : ({ ...prev, ...next } as T));\n\t\t},\n\t\tgetInitialState: () => initialState,\n\t\tsubscribe(listener) {\n\t\t\tlet prev = api.getState();\n\t\t\tconst unsub = subscribeNodeValues(\n\t\t\t\tnode,\n\t\t\t\t() => {\n\t\t\t\t\tconst next = api.getState();\n\t\t\t\t\tlistener(next, prev);\n\t\t\t\t\tprev = next;\n\t\t\t\t},\n\t\t\t\t{ changesOnly: true, onError: opts.onError, onComplete: opts.onComplete },\n\t\t\t);\n\t\t\tlisteners.add(unsub);\n\t\t\treturn () => {\n\t\t\t\tif (!listeners.delete(unsub)) return;\n\t\t\t\tunsub();\n\t\t\t};\n\t\t},\n\t\tdestroy() {\n\t\t\tfor (const unsub of [...listeners]) {\n\t\t\t\tlisteners.delete(unsub);\n\t\t\t\tunsub();\n\t\t\t}\n\t\t},\n\t};\n\treturn api;\n}\n\n/** Build a Jotai-style atom facade over a caller-owned node. */\nexport function jotaiAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableJotaiAtom<T>;\nexport function jotaiAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): JotaiAtom<T>;\nexport function jotaiAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): JotaiAtom<T> | WritableJotaiAtom<T> {\n\tconst base: JotaiAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a Nanostores-style atom facade over a caller-owned node. */\nexport function nanoAtom<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableNanoAtom<T>;\nexport function nanoAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): NanoAtom<T>;\nexport function nanoAtom<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): NanoAtom<T> | WritableNanoAtom<T> {\n\tconst base: NanoAtom<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { immediate: true, ...opts }),\n\t\tlisten: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n\n/** Build a TC39-Signals-style facade over a caller-owned node. */\nexport function signalFromNode<T>(\n\tnode: WritableNode<T>,\n\topts?: WritableStoreOptions<T>,\n): WritableSignalLike<T>;\nexport function signalFromNode<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): SignalLike<T>;\nexport function signalFromNode<T>(\n\tnode: Node<T> | WritableNode<T>,\n\topts: SubscribeValuesOptions<T> | WritableStoreOptions<T> = {},\n): SignalLike<T> | WritableSignalLike<T> {\n\tconst base: SignalLike<T> = {\n\t\tget: () => (opts.getSnapshot ?? (() => nodeSnapshot(node)))(),\n\t\tsubscribe: (callback) => subscribeNodeValues(node, callback, { changesOnly: true, ...opts }),\n\t\t_node: node,\n\t};\n\tif (hasWritableSet(node) || typeof (opts as WritableStoreOptions<T>).write === \"function\") {\n\t\tconst writable = writableStore(\n\t\t\tnode,\n\t\t\topts as WritableStoreOptions<T> & {\n\t\t\t\twrite: (node: WritableNode<T>, value: T) => void;\n\t\t\t},\n\t\t);\n\t\treturn { ...base, set: writable.set, update: writable.update };\n\t}\n\treturn base;\n}\n"],"mappings":"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","names":[]}