@graphrefly/ts 0.0.0

package/dist/messaging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/messaging/index.ts"],"sourcesContent":["/**\n * Reusable application-infrastructure messaging namespace.\n *\n * Retained root messaging utilities land here only after B63 re-derives them\n * onto the D125 package DAG.\n */\n\nimport { depBatch, type NodeFn } from \"../ctx/types.js\";\nimport { type Graph, releaseGraphNodes } from \"../graph/graph.js\";\nimport type { Node } from \"../node/node.js\";\n\nexport interface MessageEnvelope<T = unknown> {\n\treadonly topic: string;\n\treadonly seq: number;\n\treadonly payload: T;\n\treadonly key?: string;\n\treadonly timestampMs: number;\n}\n\n/**\n * Minimal JSON Schema vocabulary for cross-graph/topic payload descriptions.\n *\n * D125/D132 keep this as passive messaging vocabulary: GraphReFly does not ship\n * a validator here and does not make schemas protocol messages.\n */\nexport interface JsonSchema {\n\treadonly type?:\n\t\t| \"string\"\n\t\t| \"number\"\n\t\t| \"integer\"\n\t\t| \"boolean\"\n\t\t| \"object\"\n\t\t| \"array\"\n\t\t| \"null\"\n\t\t| readonly (\"string\" | \"number\" | \"integer\" | \"boolean\" | \"object\" | \"array\" | \"null\")[];\n\treadonly properties?: Readonly<Record<string, JsonSchema>>;\n\treadonly required?: readonly string[];\n\treadonly additionalProperties?: boolean | JsonSchema;\n\treadonly items?: JsonSchema | readonly JsonSchema[];\n\treadonly enum?: readonly unknown[];\n\treadonly const?: unknown;\n\treadonly $ref?: string;\n\treadonly definitions?: Readonly<Record<string, JsonSchema>>;\n\treadonly description?: string;\n\treadonly title?: string;\n}\n\n/**\n * Recommended passive envelope for payloads that cross topic, agent, or graph\n * boundaries. It is an application fact shape, not a required protocol type.\n */\nexport interface TopicMessage<T = unknown> {\n\treadonly id: string;\n\treadonly schema?: JsonSchema;\n\treadonly expiresAt?: string;\n\treadonly correlationId?: string;\n\treadonly payload: T;\n}\n\nexport const PROMPTS_TOPIC = \"prompts\";\nexport const RESPONSES_TOPIC = \"responses\";\nexport const INJECTIONS_TOPIC = \"injections\";\nexport const DEFERRED_TOPIC = \"deferred\";\nexport const SPAWNS_TOPIC = \"spawns\";\nexport const CONTEXT_TOPIC = \"context\";\nexport const TODOS_TOPIC = \"todos\";\n\nexport const STANDARD_TOPICS = Object.freeze([\n\tPROMPTS_TOPIC,\n\tRESPONSES_TOPIC,\n\tINJECTIONS_TOPIC,\n\tDEFERRED_TOPIC,\n\tSPAWNS_TOPIC,\n\tCONTEXT_TOPIC,\n\tTODOS_TOPIC,\n] as const);\n\nexport type StandardTopic = (typeof STANDARD_TOPICS)[number];\n\nexport interface MessageBusEvent<T = unknown> {\n\treadonly kind: \"publish\" | \"complete\" | \"error\";\n\treadonly topic: string;\n\treadonly seq?: number;\n\treadonly payload?: T;\n\treadonly error?: unknown;\n}\n\nexport interface MessageBusOptions<TTopic extends string = string> {\n\treadonly topics: readonly TTopic[];\n\treadonly name?: string;\n\treadonly now?: () => number;\n}\n\nexport interface MessageBus<TTopic extends string = string> {\n\treadonly topics: readonly TTopic[];\n\ttopic<T = unknown>(name: TTopic): Node<MessageEnvelope<T>>;\n\tpublish<T = unknown>(name: TTopic, payload: T, opts?: { key?: string }): MessageEnvelope<T>;\n\thas(name: string): name is TTopic;\n}\n\ninterface MessageBusState<TTopic extends string> {\n\treadonly graph: Graph;\n\treadonly name: string;\n\treadonly now: () => number;\n\treadonly topics: readonly TTopic[];\n\treadonly records: Map<TTopic, TopicRecord>;\n\tseq: number;\n}\n\ntype ProducedTopicMessage<T = unknown> =\n\t| { readonly kind: \"publish\"; readonly envelope: MessageEnvelope<T> }\n\t| { readonly kind: \"error\"; readonly topic: string; readonly error: unknown };\n\ninterface TopicRecord {\n\treadonly node: Node<MessageEnvelope<unknown>>;\n\treadonly producers: Node<ProducedTopicMessage<unknown>>[];\n\treadonly body: NodeFn;\n}\n\nconst busStates = new WeakMap<MessageBus<string>, MessageBusState<string>>();\n\nexport interface ToTopicOptions {\n\treadonly name?: string;\n\treadonly keyOf?: (value: unknown) => string | undefined;\n}\n\nexport interface ToTopicBundle<T> {\n\treadonly events: Node<MessageBusEvent<T>>;\n}\n\nexport type DynamicHubUnknownTopicPolicy = \"drop\" | \"error\" | \"dead-letter\" | \"create-as-fact\";\n\nexport interface DynamicHubOptions {\n\treadonly name?: string;\n\treadonly topics?: readonly string[];\n\treadonly unknownTopic?: DynamicHubUnknownTopicPolicy;\n\treadonly deadLetter?: boolean;\n\treadonly maxTopics?: number;\n\treadonly maxTopicLength?: number;\n\treadonly now?: () => number;\n}\n\nexport interface DynamicHubMetadata {\n\treadonly seq: number;\n\treadonly cursor: number;\n\treadonly timestampMs: number;\n}\n\nexport type DynamicHubEventKind =\n\t| \"create\"\n\t| \"delete\"\n\t| \"message\"\n\t| \"subscribe\"\n\t| \"close\"\n\t| \"error\"\n\t| \"dead-letter\";\n\nexport type DynamicHubCommand<T = unknown> =\n\t| {\n\t\t\treadonly kind: \"create\";\n\t\t\treadonly topic: string;\n\t\t\treadonly key?: string;\n\t\t\treadonly payload?: T;\n\t  }\n\t| {\n\t\t\treadonly kind: \"delete\";\n\t\t\treadonly topic: string;\n\t\t\treadonly key?: string;\n\t\t\treadonly payload?: T;\n\t  }\n\t| {\n\t\t\treadonly kind: \"publish\";\n\t\t\treadonly topic: string;\n\t\t\treadonly payload: T;\n\t\t\treadonly key?: string;\n\t  }\n\t| {\n\t\t\treadonly kind: \"subscribe\";\n\t\t\treadonly topic: string;\n\t\t\treadonly key?: string;\n\t\t\treadonly payload?: T;\n\t  }\n\t| {\n\t\t\treadonly kind: \"close\";\n\t\t\treadonly key?: string;\n\t\t\treadonly payload?: T;\n\t  };\n\nexport interface DynamicHubStatus {\n\treadonly open: boolean;\n\treadonly topics: readonly string[];\n\treadonly seq: number;\n\treadonly cursor: number;\n\treadonly lastEventKind?: DynamicHubEventKind;\n}\n\ninterface DynamicHubEventFrame {\n\treadonly meta: DynamicHubMetadata;\n\treadonly status: DynamicHubStatus;\n}\n\nexport type DynamicHubEvent<T = unknown> = DynamicHubEventFrame &\n\t(\n\t\t| {\n\t\t\t\treadonly kind: \"create\";\n\t\t\t\treadonly topic: string;\n\t\t\t\treadonly key?: string;\n\t\t\t\treadonly payload?: T;\n\t\t  }\n\t\t| {\n\t\t\t\treadonly kind: \"delete\";\n\t\t\t\treadonly topic: string;\n\t\t\t\treadonly key?: string;\n\t\t\t\treadonly payload?: T;\n\t\t  }\n\t\t| {\n\t\t\t\treadonly kind: \"message\";\n\t\t\t\treadonly topic: string;\n\t\t\t\treadonly payload: T;\n\t\t\t\treadonly key?: string;\n\t\t  }\n\t\t| {\n\t\t\t\treadonly kind: \"subscribe\";\n\t\t\t\treadonly topic: string;\n\t\t\t\treadonly key?: string;\n\t\t\t\treadonly payload?: T;\n\t\t  }\n\t\t| {\n\t\t\t\treadonly kind: \"close\";\n\t\t\t\treadonly key?: string;\n\t\t\t\treadonly payload?: T;\n\t\t  }\n\t\t| {\n\t\t\t\treadonly kind: \"error\";\n\t\t\t\treadonly topic?: string;\n\t\t\t\treadonly error: string;\n\t\t\t\treadonly command: unknown;\n\t\t  }\n\t\t| {\n\t\t\t\treadonly kind: \"dead-letter\";\n\t\t\t\treadonly topic?: string;\n\t\t\t\treadonly reason: string;\n\t\t\t\treadonly command: unknown;\n\t\t  }\n\t);\n\nexport interface DynamicHubError {\n\treadonly topic?: string;\n\treadonly error: string;\n\treadonly command: unknown;\n\treadonly meta: DynamicHubMetadata;\n}\n\nexport interface DynamicHubDeadLetter {\n\treadonly topic?: string;\n\treadonly reason: string;\n\treadonly command: unknown;\n\treadonly meta: DynamicHubMetadata;\n}\n\nexport interface DynamicHub<T = unknown> {\n\treadonly command: Node<DynamicHubCommand<T>>;\n\treadonly events: Node<DynamicHubEvent<T>>;\n\treadonly status: Node<DynamicHubStatus>;\n\treadonly errors: Node<DynamicHubError>;\n\treadonly deadLetter?: Node<DynamicHubDeadLetter>;\n\tcreate(topic: string, opts?: { key?: string; payload?: T }): DynamicHubCommand<T>;\n\tdelete(topic: string, opts?: { key?: string; payload?: T }): DynamicHubCommand<T>;\n\tpublish(topic: string, payload: T, opts?: { key?: string }): DynamicHubCommand<T>;\n\tsubscribeTopic(topic: string, opts?: { key?: string; payload?: T }): DynamicHubCommand<T>;\n\tclose(opts?: { key?: string; payload?: T }): DynamicHubCommand<T>;\n}\n\nexport interface ToHubTopicOptions<T> {\n\treadonly name?: string;\n\treadonly keyOf?: (value: T) => string | undefined;\n}\n\nexport interface ToHubTopicBundle<T> {\n\treadonly commands: Node<DynamicHubCommand<T>>;\n}\n\ninterface DynamicHubState<T> {\n\treadonly graph: Graph;\n\treadonly name: string;\n\treadonly maxTopicLength: number;\n\treadonly commandSources: Node<DynamicHubCommand<T>>[];\n\treadonly commandBody: NodeFn;\n\treadonly releaseEventsRetain: () => void;\n}\n\ninterface DynamicHubRuntime {\n\ttopics: string[];\n\topen: boolean;\n\tseq: number;\n\tcursor: number;\n}\n\nconst dynamicHubStates = new WeakMap<DynamicHub<unknown>, DynamicHubState<unknown>>();\nconst DEFAULT_DYNAMIC_HUB_MAX_TOPICS = 1024;\nconst DEFAULT_DYNAMIC_HUB_MAX_TOPIC_LENGTH = 256;\n\nexport function messageBus<TTopic extends string>(\n\tgraph: Graph,\n\topts: MessageBusOptions<TTopic>,\n): MessageBus<TTopic> {\n\tconst unique = [...new Set(opts.topics)];\n\tif (unique.length !== opts.topics.length) throw new Error(\"messageBus: duplicate topic\");\n\tif (unique.length === 0) throw new Error(\"messageBus: at least one topic is required\");\n\tconst name = opts.name ?? \"messageBus\";\n\tconst state: MessageBusState<TTopic> = {\n\t\tgraph,\n\t\tname,\n\t\tnow: opts.now ?? Date.now,\n\t\ttopics: Object.freeze([...unique]),\n\t\trecords: new Map(),\n\t\tseq: 0,\n\t};\n\tfor (const topic of unique) {\n\t\tconst producers: Node<ProducedTopicMessage<unknown>>[] = [];\n\t\tconst body: NodeFn = (ctx) => {\n\t\t\tfor (let i = 0; i < producers.length; i++) {\n\t\t\t\tfor (const produced of depBatch(ctx, i) ?? []) {\n\t\t\t\t\tif ((produced as ProducedTopicMessage).kind === \"publish\") {\n\t\t\t\t\t\tctx.down([\n\t\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t\t(\n\t\t\t\t\t\t\t\t\tproduced as ProducedTopicMessage<unknown> & {\n\t\t\t\t\t\t\t\t\t\tkind: \"publish\";\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t).envelope,\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}\n\t\t};\n\t\tconst node = graph.node<MessageEnvelope<unknown>>([], body, {\n\t\t\tname: `${name}/${topic}`,\n\t\t\tfactory: \"messageTopic\",\n\t\t\tmeta: { topic },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t});\n\t\tstate.records.set(topic, { node, producers, body });\n\t}\n\tconst bus: MessageBus<TTopic> = {\n\t\ttopics: state.topics,\n\t\ttopic<T = unknown>(topic: TTopic): Node<MessageEnvelope<T>> {\n\t\t\treturn requireTopic(state, topic) as Node<MessageEnvelope<T>>;\n\t\t},\n\t\tpublish<T = unknown>(\n\t\t\ttopic: TTopic,\n\t\t\tpayload: T,\n\t\t\tpublishOpts: { key?: string } = {},\n\t\t): MessageEnvelope<T> {\n\t\t\tconst node = requireTopic(state, topic);\n\t\t\tconst envelope: MessageEnvelope<T> = {\n\t\t\t\ttopic,\n\t\t\t\tseq: ++state.seq,\n\t\t\t\tpayload,\n\t\t\t\ttimestampMs: state.now(),\n\t\t\t\t...(publishOpts.key === undefined ? {} : { key: publishOpts.key }),\n\t\t\t};\n\t\t\tnode.down([[\"DATA\", envelope as MessageEnvelope<unknown>]]);\n\t\t\treturn envelope;\n\t\t},\n\t\thas(topic: string): topic is TTopic {\n\t\t\treturn state.records.has(topic as TTopic);\n\t\t},\n\t};\n\tbusStates.set(bus as MessageBus<string>, state as unknown as MessageBusState<string>);\n\treturn bus;\n}\n\n/**\n * D135 dynamic messaging hub: topic lifecycle is DATA facts over fixed graph-visible\n * command/event/status/error nodes. Topic keys never create or delete graph nodes.\n */\nexport function dynamicHub<T = unknown>(graph: Graph, opts: DynamicHubOptions = {}): DynamicHub<T> {\n\tconst name = opts.name ?? \"dynamicHub\";\n\tconst unknownTopic = normalizeUnknownTopicPolicy(opts.unknownTopic);\n\tconst maxTopics = normalizeHubLimit(\n\t\topts.maxTopics,\n\t\tDEFAULT_DYNAMIC_HUB_MAX_TOPICS,\n\t\t\"dynamicHub: maxTopics\",\n\t);\n\tconst maxTopicLength = normalizeHubLimit(\n\t\topts.maxTopicLength,\n\t\tDEFAULT_DYNAMIC_HUB_MAX_TOPIC_LENGTH,\n\t\t\"dynamicHub: maxTopicLength\",\n\t);\n\tconst now = opts.now ?? Date.now;\n\tconst initialTopics = uniqueTopics(opts.topics ?? [], maxTopicLength);\n\tif (initialTopics.length > maxTopics) {\n\t\tthrow new Error(\"dynamicHub: topics exceed maxTopics\");\n\t}\n\tconst commandSources: Node<DynamicHubCommand<T>>[] = [];\n\tconst commandBody: NodeFn = (ctx) => {\n\t\tfor (let i = 0; i < commandSources.length; i++) {\n\t\t\tfor (const command of depBatch(ctx, i) ?? []) ctx.down([[\"DATA\", command]]);\n\t\t}\n\t};\n\tconst command = graph.node<DynamicHubCommand<T>>([], commandBody, {\n\t\tname: `${name}/command`,\n\t\tfactory: \"dynamicHubCommand\",\n\t\tcompleteWhenDepsComplete: false,\n\t\terrorWhenDepsError: false,\n\t});\n\tconst events = graph.node<DynamicHubEvent<T>>(\n\t\t[command],\n\t\t(ctx) => {\n\t\t\tconst runtime =\n\t\t\t\tctx.state.get<DynamicHubRuntime>() ??\n\t\t\t\t({\n\t\t\t\t\ttopics: [...initialTopics],\n\t\t\t\t\topen: true,\n\t\t\t\t\tseq: 0,\n\t\t\t\t\tcursor: 0,\n\t\t\t\t} satisfies DynamicHubRuntime);\n\t\t\tctx.state.persist(true);\n\t\t\tfor (const commandFact of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst parsed = parseDynamicHubCommand(commandFact);\n\t\t\t\tif (typeof parsed === \"string\") {\n\t\t\t\t\tctx.down([[\"DATA\", hubError(runtime, commandFact, parsed, timestampOrFallback(now))]]);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst reduced = reduceDynamicHubCommand(\n\t\t\t\t\truntime,\n\t\t\t\t\tparsed as DynamicHubCommand<T>,\n\t\t\t\t\tunknownTopic,\n\t\t\t\t\tmaxTopics,\n\t\t\t\t\tmaxTopicLength,\n\t\t\t\t\tnow,\n\t\t\t\t);\n\t\t\t\tfor (const event of reduced) ctx.down([[\"DATA\", event]]);\n\t\t\t}\n\t\t\tctx.state.set(runtime);\n\t\t},\n\t\t{\n\t\t\tname: `${name}/events`,\n\t\t\tfactory: \"dynamicHubEvents\",\n\t\t\tmeta: { unknownTopic },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\tconst status = graph.node<DynamicHubStatus>(\n\t\t[events],\n\t\t(ctx) => {\n\t\t\tfor (const event of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = event as DynamicHubEvent<T>;\n\t\t\t\tctx.down([[\"DATA\", typed.status]]);\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: `${name}/status`,\n\t\t\tfactory: \"dynamicHubStatus\",\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\tconst errors = graph.node<DynamicHubError>(\n\t\t[events],\n\t\t(ctx) => {\n\t\t\tfor (const event of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = event as DynamicHubEvent<T>;\n\t\t\t\tif (typed.kind !== \"error\") continue;\n\t\t\t\tctx.down([\n\t\t\t\t\t[\n\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t...(typed.topic === undefined ? {} : { topic: typed.topic }),\n\t\t\t\t\t\t\terror: typed.error,\n\t\t\t\t\t\t\tcommand: typed.command,\n\t\t\t\t\t\t\tmeta: typed.meta,\n\t\t\t\t\t\t} satisfies DynamicHubError,\n\t\t\t\t\t],\n\t\t\t\t]);\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: `${name}/errors`,\n\t\t\tfactory: \"dynamicHubErrors\",\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\tconst deadLetter =\n\t\topts.deadLetter === true || unknownTopic === \"dead-letter\"\n\t\t\t? graph.node<DynamicHubDeadLetter>(\n\t\t\t\t\t[events],\n\t\t\t\t\t(ctx) => {\n\t\t\t\t\t\tfor (const event of depBatch(ctx, 0) ?? []) {\n\t\t\t\t\t\t\tconst typed = event as DynamicHubEvent<T>;\n\t\t\t\t\t\t\tif (typed.kind !== \"dead-letter\") continue;\n\t\t\t\t\t\t\tctx.down([\n\t\t\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t...(typed.topic === undefined ? {} : { topic: typed.topic }),\n\t\t\t\t\t\t\t\t\t\treason: typed.reason,\n\t\t\t\t\t\t\t\t\t\tcommand: typed.command,\n\t\t\t\t\t\t\t\t\t\tmeta: typed.meta,\n\t\t\t\t\t\t\t\t\t} satisfies DynamicHubDeadLetter,\n\t\t\t\t\t\t\t\t],\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\t{\n\t\t\t\t\t\tname: `${name}/deadLetter`,\n\t\t\t\t\t\tfactory: \"dynamicHubDeadLetter\",\n\t\t\t\t\t\tcompleteWhenDepsComplete: false,\n\t\t\t\t\t\terrorWhenDepsError: false,\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t: undefined;\n\tconst releaseEventsRetain = graph.retain(events, { reason: `${name}.dynamicHub.events` });\n\tconst hub: DynamicHub<T> = {\n\t\tcommand,\n\t\tevents,\n\t\tstatus,\n\t\terrors,\n\t\t...(deadLetter === undefined ? {} : { deadLetter }),\n\t\tcreate(topic, commandOpts = {}) {\n\t\t\treturn publishHubCommand(command, {\n\t\t\t\tkind: \"create\",\n\t\t\t\ttopic,\n\t\t\t\t...(commandOpts.key === undefined ? {} : { key: commandOpts.key }),\n\t\t\t\t...(commandOpts.payload === undefined ? {} : { payload: commandOpts.payload }),\n\t\t\t} as DynamicHubCommand<T>);\n\t\t},\n\t\tdelete(topic, commandOpts = {}) {\n\t\t\treturn publishHubCommand(command, {\n\t\t\t\tkind: \"delete\",\n\t\t\t\ttopic,\n\t\t\t\t...(commandOpts.key === undefined ? {} : { key: commandOpts.key }),\n\t\t\t\t...(commandOpts.payload === undefined ? {} : { payload: commandOpts.payload }),\n\t\t\t} as DynamicHubCommand<T>);\n\t\t},\n\t\tpublish(topic, payload, commandOpts = {}) {\n\t\t\treturn publishHubCommand(command, {\n\t\t\t\tkind: \"publish\",\n\t\t\t\ttopic,\n\t\t\t\tpayload,\n\t\t\t\t...(commandOpts.key === undefined ? {} : { key: commandOpts.key }),\n\t\t\t});\n\t\t},\n\t\tsubscribeTopic(topic, commandOpts = {}) {\n\t\t\treturn publishHubCommand(command, {\n\t\t\t\tkind: \"subscribe\",\n\t\t\t\ttopic,\n\t\t\t\t...(commandOpts.key === undefined ? {} : { key: commandOpts.key }),\n\t\t\t\t...(commandOpts.payload === undefined ? {} : { payload: commandOpts.payload }),\n\t\t\t} as DynamicHubCommand<T>);\n\t\t},\n\t\tclose(commandOpts = {}) {\n\t\t\treturn publishHubCommand(command, {\n\t\t\t\tkind: \"close\",\n\t\t\t\t...(commandOpts.key === undefined ? {} : { key: commandOpts.key }),\n\t\t\t\t...(commandOpts.payload === undefined ? {} : { payload: commandOpts.payload }),\n\t\t\t} as DynamicHubCommand<T>);\n\t\t},\n\t};\n\tdynamicHubStates.set(hub as DynamicHub<unknown>, {\n\t\tgraph,\n\t\tname,\n\t\tmaxTopicLength,\n\t\tcommandSources: commandSources as Node<DynamicHubCommand<unknown>>[],\n\t\tcommandBody,\n\t\treleaseEventsRetain,\n\t});\n\treturn hub;\n}\n\n/** Static D135 projection over hub event facts for one topic key; no topic node is created. */\nexport function fromHubTopic<T = unknown>(\n\thub: DynamicHub<unknown>,\n\ttopic: string,\n\topts: { name?: string } = {},\n): Node<MessageEnvelope<T>> {\n\tconst state = requireDynamicHubState(hub);\n\tassertTopicKey(topic, \"fromHubTopic\", state.maxTopicLength);\n\treturn state.graph.node<MessageEnvelope<T>>(\n\t\t[hub.events],\n\t\t(ctx) => {\n\t\t\tfor (const event of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = event as DynamicHubEvent<T>;\n\t\t\t\tif (typed.kind !== \"message\" || typed.topic !== topic) continue;\n\t\t\t\tctx.down([\n\t\t\t\t\t[\n\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttopic,\n\t\t\t\t\t\t\tseq: typed.meta.seq,\n\t\t\t\t\t\t\tpayload: typed.payload,\n\t\t\t\t\t\t\ttimestampMs: typed.meta.timestampMs,\n\t\t\t\t\t\t\t...(typed.key === undefined ? {} : { key: typed.key }),\n\t\t\t\t\t\t} satisfies MessageEnvelope<T>,\n\t\t\t\t\t],\n\t\t\t\t]);\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: opts.name ?? `${state.name}/${topic}/fromHubTopic`,\n\t\t\tfactory: \"fromHubTopic\",\n\t\t\tmeta: { topic },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n}\n\n/** Static D135 command helper: source DATA becomes publish command facts for one topic key. */\nexport function toHubTopic<T>(\n\tgraph: Graph,\n\tsource: Node<T>,\n\thub: DynamicHub<unknown>,\n\ttopic: string,\n\topts: ToHubTopicOptions<T> = {},\n): ToHubTopicBundle<T> {\n\tconst state = requireDynamicHubState(hub);\n\tassertTopicKey(topic, \"toHubTopic\", state.maxTopicLength);\n\tif (state.graph !== graph) throw new Error(\"toHubTopic: hub and source graph must match\");\n\tif (isReachableUpstream(source as Node<unknown>, hub.command as Node<unknown>)) {\n\t\tthrow new Error(\"toHubTopic: source already depends on hub command path\");\n\t}\n\tconst commands = graph.node<DynamicHubCommand<T>>(\n\t\t[source],\n\t\t(ctx) => {\n\t\t\tfor (const value of depBatch(ctx, 0) ?? []) {\n\t\t\t\ttry {\n\t\t\t\t\tconst key = opts.keyOf?.(value as T);\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tkind: \"publish\",\n\t\t\t\t\t\t\t\ttopic,\n\t\t\t\t\t\t\t\tpayload: value as T,\n\t\t\t\t\t\t\t\t...(key === undefined ? {} : { key }),\n\t\t\t\t\t\t\t} satisfies DynamicHubCommand<T>,\n\t\t\t\t\t\t],\n\t\t\t\t\t]);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tkind: \"invalid\",\n\t\t\t\t\t\t\t\ttopic,\n\t\t\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t} as unknown as DynamicHubCommand<T>,\n\t\t\t\t\t\t],\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: opts.name ?? `${state.name}/${topic}/toHubTopic`,\n\t\t\tfactory: \"toHubTopic\",\n\t\t\tmeta: { topic },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\tconst commandSource = commands as Node<DynamicHubCommand<unknown>>;\n\tstate.commandSources.push(commandSource);\n\ttry {\n\t\thub.command.replaceDeps([...state.commandSources], state.commandBody);\n\t} catch (error) {\n\t\tstate.commandSources.splice(state.commandSources.indexOf(commandSource), 1);\n\t\treleaseGraphNodes(graph, [commands as Node<unknown>], {\n\t\t\treason: \"toHubTopic failed command wiring\",\n\t\t});\n\t\tthrow error;\n\t}\n\treturn { commands };\n}\n\nexport function fromTopic<T = unknown, TTopic extends string = string>(\n\tbus: MessageBus<TTopic>,\n\ttopic: TTopic,\n): Node<MessageEnvelope<T>> {\n\treturn bus.topic<T>(topic);\n}\n\nexport function toTopic<T, TTopic extends string>(\n\tgraph: Graph,\n\tsource: Node<T>,\n\tbus: MessageBus<TTopic>,\n\ttopic: TTopic,\n\topts: ToTopicOptions = {},\n): ToTopicBundle<T> {\n\tconst state = busStates.get(bus as MessageBus<string>) as MessageBusState<TTopic> | undefined;\n\tif (state === undefined) throw new Error(\"toTopic: unknown message bus implementation\");\n\tif (state.graph !== graph) throw new Error(\"toTopic: bus and source graph must match\");\n\tconst record = requireTopicRecord(state, topic);\n\tconst name = opts.name ?? `toTopic/${topic}`;\n\tconst producer = graph.node<ProducedTopicMessage<T>>(\n\t\t[source],\n\t\t(ctx) => {\n\t\t\tfor (const value of depBatch(ctx, 0) ?? []) {\n\t\t\t\ttry {\n\t\t\t\t\tconst key = opts.keyOf?.(value);\n\t\t\t\t\tconst envelope: MessageEnvelope<T> = {\n\t\t\t\t\t\ttopic,\n\t\t\t\t\t\tseq: ++state.seq,\n\t\t\t\t\t\tpayload: value as T,\n\t\t\t\t\t\ttimestampMs: state.now(),\n\t\t\t\t\t\t...(key === undefined ? {} : { key }),\n\t\t\t\t\t};\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tkind: \"publish\",\n\t\t\t\t\t\t\t\tenvelope,\n\t\t\t\t\t\t\t} satisfies ProducedTopicMessage<T>,\n\t\t\t\t\t\t],\n\t\t\t\t\t]);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tctx.down([[\"DATA\", { kind: \"error\", topic, error } satisfies ProducedTopicMessage<T>]]);\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname,\n\t\t\tfactory: \"toTopic\",\n\t\t\tmeta: { topic },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\trecord.producers.push(producer as Node<ProducedTopicMessage<unknown>>);\n\trecord.node.replaceDeps([...record.producers], record.body);\n\tconst events = graph.node<MessageBusEvent<T>>(\n\t\t[producer, source],\n\t\t(ctx) => {\n\t\t\tfor (const produced of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = produced as ProducedTopicMessage<T>;\n\t\t\t\tif (typed.kind === \"publish\") {\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tkind: \"publish\",\n\t\t\t\t\t\t\t\ttopic,\n\t\t\t\t\t\t\t\tseq: typed.envelope.seq,\n\t\t\t\t\t\t\t\tpayload: typed.envelope.payload,\n\t\t\t\t\t\t\t} satisfies MessageBusEvent<T>,\n\t\t\t\t\t\t],\n\t\t\t\t\t]);\n\t\t\t\t} else {\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\"DATA\", { kind: \"error\", topic, error: typed.error } satisfies MessageBusEvent<T>],\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst terminal = ctx.terminal[0];\n\t\t\tif (terminal !== false && terminal !== undefined && terminal !== true) {\n\t\t\t\tctx.down([\n\t\t\t\t\t[\"DATA\", { kind: \"error\", topic, error: terminal } satisfies MessageBusEvent<T>],\n\t\t\t\t]);\n\t\t\t}\n\t\t\tconst sourceTerminal = ctx.terminal[1];\n\t\t\tif (sourceTerminal === true) {\n\t\t\t\tctx.down([[\"DATA\", { kind: \"complete\", topic } satisfies MessageBusEvent<T>]]);\n\t\t\t} else if (sourceTerminal !== false && sourceTerminal !== undefined) {\n\t\t\t\tctx.down([\n\t\t\t\t\t[\"DATA\", { kind: \"error\", topic, error: sourceTerminal } satisfies MessageBusEvent<T>],\n\t\t\t\t]);\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: `${name}/events`,\n\t\t\tfactory: \"toTopicEvents\",\n\t\t\tmeta: { topic },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t\tterminalAsRealInput: true,\n\t\t},\n\t);\n\treturn { events };\n}\n\nfunction requireTopic<TTopic extends string>(\n\tstate: MessageBusState<TTopic>,\n\ttopic: TTopic,\n): Node<MessageEnvelope<unknown>> {\n\treturn requireTopicRecord(state, topic).node;\n}\n\nfunction requireTopicRecord<TTopic extends string>(\n\tstate: MessageBusState<TTopic>,\n\ttopic: TTopic,\n): TopicRecord {\n\tconst record = state.records.get(topic);\n\tif (record === undefined) throw new Error(`messageBus: unknown topic '${topic}'`);\n\treturn record;\n}\n\nfunction uniqueTopics(topics: readonly string[], maxTopicLength: number): readonly string[] {\n\tconst unique = [...new Set(topics)];\n\tif (unique.length !== topics.length) throw new Error(\"dynamicHub: duplicate topic\");\n\tfor (const topic of unique) assertTopicKey(topic, \"dynamicHub\", maxTopicLength);\n\treturn Object.freeze(unique.sort());\n}\n\nfunction normalizeUnknownTopicPolicy(\n\tpolicy: DynamicHubOptions[\"unknownTopic\"],\n): DynamicHubUnknownTopicPolicy {\n\tif (policy === undefined) return \"error\";\n\tif (\n\t\tpolicy === \"drop\" ||\n\t\tpolicy === \"error\" ||\n\t\tpolicy === \"dead-letter\" ||\n\t\tpolicy === \"create-as-fact\"\n\t) {\n\t\treturn policy;\n\t}\n\tthrow new Error(\"dynamicHub: unknownTopic policy is not recognized\");\n}\n\nfunction normalizeHubLimit(value: number | undefined, fallback: number, owner: string): number {\n\tif (value === undefined) return fallback;\n\tif (!Number.isInteger(value) || value < 1) {\n\t\tthrow new Error(`${owner} must be a positive integer`);\n\t}\n\treturn value;\n}\n\nfunction publishHubCommand<T>(\n\tcommandNode: Node<DynamicHubCommand<T>>,\n\tcommand: DynamicHubCommand<T>,\n): DynamicHubCommand<T> {\n\tcommandNode.down([[\"DATA\", command]]);\n\treturn command;\n}\n\nfunction parseDynamicHubCommand(value: unknown): DynamicHubCommand<unknown> | string {\n\tif (!isObjectRecord(value)) return \"dynamicHub: command fact must be an object\";\n\tconst kind = value.kind;\n\tif (\n\t\tkind !== \"create\" &&\n\t\tkind !== \"delete\" &&\n\t\tkind !== \"publish\" &&\n\t\tkind !== \"subscribe\" &&\n\t\tkind !== \"close\"\n\t) {\n\t\treturn \"dynamicHub: command kind is not recognized\";\n\t}\n\tif (kind === \"close\") {\n\t\treturn {\n\t\t\tkind,\n\t\t\t...(typeof value.key === \"string\" ? { key: value.key } : {}),\n\t\t\t...(value.payload === undefined ? {} : { payload: value.payload }),\n\t\t};\n\t}\n\tconst topic = value.topic;\n\tif (typeof topic !== \"string\" || topic.length === 0) {\n\t\treturn \"dynamicHub: command topic must be a non-empty string\";\n\t}\n\tif (kind === \"publish\") {\n\t\tif (value.payload === undefined) return \"dynamicHub: publish command payload is required\";\n\t\treturn {\n\t\t\tkind,\n\t\t\ttopic,\n\t\t\tpayload: value.payload,\n\t\t\t...(typeof value.key === \"string\" ? { key: value.key } : {}),\n\t\t};\n\t}\n\treturn {\n\t\tkind,\n\t\ttopic,\n\t\t...(typeof value.key === \"string\" ? { key: value.key } : {}),\n\t\t...(value.payload === undefined ? {} : { payload: value.payload }),\n\t};\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readHubTimestamp(now: () => number): number | string {\n\ttry {\n\t\tconst timestampMs = now();\n\t\treturn Number.isFinite(timestampMs)\n\t\t\t? timestampMs\n\t\t\t: \"dynamicHub: now() must return a finite number\";\n\t} catch (error) {\n\t\treturn `dynamicHub: now() threw: ${error instanceof Error ? error.message : String(error)}`;\n\t}\n}\n\nfunction timestampOrFallback(now: () => number): number {\n\tconst timestampMs = readHubTimestamp(now);\n\treturn typeof timestampMs === \"number\" ? timestampMs : Date.now();\n}\n\nfunction reduceDynamicHubCommand<T>(\n\truntime: DynamicHubRuntime,\n\tcommand: DynamicHubCommand<T>,\n\tunknownTopic: DynamicHubUnknownTopicPolicy,\n\tmaxTopics: number,\n\tmaxTopicLength: number,\n\tnow: () => number,\n): DynamicHubEvent<T>[] {\n\tconst topic = \"topic\" in command ? command.topic : undefined;\n\tif (topic !== undefined) {\n\t\tconst topicError = validateTopicKey(topic, \"dynamicHub\", maxTopicLength);\n\t\tif (topicError !== undefined) {\n\t\t\treturn [hubError(runtime, command, topicError, timestampOrFallback(now))];\n\t\t}\n\t}\n\tif (!runtime.open && command.kind !== \"close\") {\n\t\treturn [hubError(runtime, command, \"dynamicHub: hub is closed\", timestampOrFallback(now))];\n\t}\n\tswitch (command.kind) {\n\t\tcase \"create\": {\n\t\t\tconst capacityError = canAddHubTopic(runtime, command.topic, maxTopics);\n\t\t\tif (capacityError !== undefined) {\n\t\t\t\treturn [hubError(runtime, command, capacityError, timestampOrFallback(now))];\n\t\t\t}\n\t\t\tconst timestampMs = readHubTimestamp(now);\n\t\t\tif (typeof timestampMs === \"string\")\n\t\t\t\treturn [hubError(runtime, command, timestampMs, Date.now())];\n\t\t\taddHubTopic(runtime, command.topic);\n\t\t\treturn [hubEvent(runtime, timestampMs, command)];\n\t\t}\n\t\tcase \"delete\": {\n\t\t\tif (!hasHubTopic(runtime, command.topic)) {\n\t\t\t\treturn unknownHubTopic(runtime, command, unknownTopic, now);\n\t\t\t}\n\t\t\tconst timestampMs = readHubTimestamp(now);\n\t\t\tif (typeof timestampMs === \"string\")\n\t\t\t\treturn [hubError(runtime, command, timestampMs, Date.now())];\n\t\t\tdeleteHubTopic(runtime, command.topic);\n\t\t\treturn [hubEvent(runtime, timestampMs, command)];\n\t\t}\n\t\tcase \"publish\": {\n\t\t\tif (!hasHubTopic(runtime, command.topic)) {\n\t\t\t\tif (unknownTopic === \"create-as-fact\") {\n\t\t\t\t\tconst capacityError = canAddHubTopic(runtime, command.topic, maxTopics);\n\t\t\t\t\tif (capacityError !== undefined) {\n\t\t\t\t\t\treturn [hubError(runtime, command, capacityError, timestampOrFallback(now))];\n\t\t\t\t\t}\n\t\t\t\t\tconst createTimestampMs = readHubTimestamp(now);\n\t\t\t\t\tif (typeof createTimestampMs === \"string\") {\n\t\t\t\t\t\treturn [hubError(runtime, command, createTimestampMs, Date.now())];\n\t\t\t\t\t}\n\t\t\t\t\tconst messageTimestampMs = readHubTimestamp(now);\n\t\t\t\t\tif (typeof messageTimestampMs === \"string\") {\n\t\t\t\t\t\treturn [hubError(runtime, command, messageTimestampMs, Date.now())];\n\t\t\t\t\t}\n\t\t\t\t\taddHubTopic(runtime, command.topic);\n\t\t\t\t\treturn [\n\t\t\t\t\t\thubEvent(runtime, createTimestampMs, { kind: \"create\", topic: command.topic }),\n\t\t\t\t\t\thubEvent(runtime, messageTimestampMs, {\n\t\t\t\t\t\t\tkind: \"message\",\n\t\t\t\t\t\t\ttopic: command.topic,\n\t\t\t\t\t\t\tpayload: command.payload,\n\t\t\t\t\t\t\t...(command.key === undefined ? {} : { key: command.key }),\n\t\t\t\t\t\t}),\n\t\t\t\t\t];\n\t\t\t\t}\n\t\t\t\treturn unknownHubTopic(runtime, command, unknownTopic, now);\n\t\t\t}\n\t\t\tconst timestampMs = readHubTimestamp(now);\n\t\t\tif (typeof timestampMs === \"string\")\n\t\t\t\treturn [hubError(runtime, command, timestampMs, Date.now())];\n\t\t\treturn [\n\t\t\t\thubEvent(runtime, timestampMs, {\n\t\t\t\t\tkind: \"message\",\n\t\t\t\t\ttopic: command.topic,\n\t\t\t\t\tpayload: command.payload,\n\t\t\t\t\t...(command.key === undefined ? {} : { key: command.key }),\n\t\t\t\t}),\n\t\t\t];\n\t\t}\n\t\tcase \"subscribe\": {\n\t\t\tif (!hasHubTopic(runtime, command.topic)) {\n\t\t\t\tif (unknownTopic === \"create-as-fact\") {\n\t\t\t\t\tconst capacityError = canAddHubTopic(runtime, command.topic, maxTopics);\n\t\t\t\t\tif (capacityError !== undefined) {\n\t\t\t\t\t\treturn [hubError(runtime, command, capacityError, timestampOrFallback(now))];\n\t\t\t\t\t}\n\t\t\t\t\tconst createTimestampMs = readHubTimestamp(now);\n\t\t\t\t\tif (typeof createTimestampMs === \"string\") {\n\t\t\t\t\t\treturn [hubError(runtime, command, createTimestampMs, Date.now())];\n\t\t\t\t\t}\n\t\t\t\t\tconst subscribeTimestampMs = readHubTimestamp(now);\n\t\t\t\t\tif (typeof subscribeTimestampMs === \"string\") {\n\t\t\t\t\t\treturn [hubError(runtime, command, subscribeTimestampMs, Date.now())];\n\t\t\t\t\t}\n\t\t\t\t\taddHubTopic(runtime, command.topic);\n\t\t\t\t\treturn [\n\t\t\t\t\t\thubEvent(runtime, createTimestampMs, { kind: \"create\", topic: command.topic }),\n\t\t\t\t\t\thubEvent(runtime, subscribeTimestampMs, command),\n\t\t\t\t\t];\n\t\t\t\t}\n\t\t\t\treturn unknownHubTopic(runtime, command, unknownTopic, now);\n\t\t\t}\n\t\t\tconst timestampMs = readHubTimestamp(now);\n\t\t\tif (typeof timestampMs === \"string\")\n\t\t\t\treturn [hubError(runtime, command, timestampMs, Date.now())];\n\t\t\treturn [hubEvent(runtime, timestampMs, command)];\n\t\t}\n\t\tcase \"close\": {\n\t\t\tconst timestampMs = readHubTimestamp(now);\n\t\t\tif (typeof timestampMs === \"string\")\n\t\t\t\treturn [hubError(runtime, command, timestampMs, Date.now())];\n\t\t\truntime.open = false;\n\t\t\treturn [hubEvent(runtime, timestampMs, command)];\n\t\t}\n\t}\n}\n\nfunction hubEvent<T>(\n\truntime: DynamicHubRuntime,\n\ttimestampMs: number,\n\tevent: Record<string, unknown> & { readonly kind: DynamicHubEventKind },\n): DynamicHubEvent<T> {\n\tconst meta = nextHubMetadata(runtime, timestampMs);\n\treturn {\n\t\t...event,\n\t\tmeta,\n\t\tstatus: snapshotHubStatus(runtime, meta, event.kind),\n\t} as DynamicHubEvent<T>;\n}\n\nfunction hubError<T>(\n\truntime: DynamicHubRuntime,\n\tcommand: unknown,\n\terror: string,\n\ttimestampMs: number,\n): DynamicHubEvent<T> {\n\treturn hubEvent(runtime, timestampMs, {\n\t\tkind: \"error\",\n\t\t...(isObjectRecord(command) && typeof command.topic === \"string\"\n\t\t\t? { topic: command.topic }\n\t\t\t: {}),\n\t\terror,\n\t\tcommand,\n\t});\n}\n\nfunction unknownHubTopic<T>(\n\truntime: DynamicHubRuntime,\n\tcommand: DynamicHubCommand<T>,\n\tpolicy: DynamicHubUnknownTopicPolicy,\n\tnow: () => number,\n): DynamicHubEvent<T>[] {\n\tconst topic = \"topic\" in command ? command.topic : undefined;\n\tconst reason = `dynamicHub: unknown topic '${topic ?? \"\"}'`;\n\tif (policy === \"drop\") return [];\n\tif (policy === \"dead-letter\") {\n\t\treturn [\n\t\t\thubEvent(runtime, timestampOrFallback(now), {\n\t\t\t\tkind: \"dead-letter\",\n\t\t\t\t...(topic === undefined ? {} : { topic }),\n\t\t\t\treason,\n\t\t\t\tcommand,\n\t\t\t}),\n\t\t];\n\t}\n\treturn [hubError(runtime, command, reason, timestampOrFallback(now))];\n}\n\nfunction nextHubMetadata(runtime: DynamicHubRuntime, timestampMs: number): DynamicHubMetadata {\n\truntime.seq += 1;\n\truntime.cursor = runtime.seq;\n\treturn { seq: runtime.seq, cursor: runtime.cursor, timestampMs };\n}\n\nfunction snapshotHubStatus(\n\truntime: DynamicHubRuntime,\n\tmeta: DynamicHubMetadata,\n\tkind: DynamicHubEventKind,\n): DynamicHubStatus {\n\treturn {\n\t\topen: runtime.open,\n\t\ttopics: Object.freeze([...runtime.topics].sort()),\n\t\tseq: meta.seq,\n\t\tcursor: meta.cursor,\n\t\tlastEventKind: kind,\n\t};\n}\n\nfunction assertTopicKey(topic: string, owner: string, maxTopicLength: number): void {\n\tconst error = validateTopicKey(topic, owner, maxTopicLength);\n\tif (error !== undefined) throw new Error(error);\n}\n\nfunction validateTopicKey(\n\ttopic: string,\n\towner: string,\n\tmaxTopicLength: number,\n): string | undefined {\n\tif (typeof topic !== \"string\" || topic.length === 0) {\n\t\treturn `${owner}: topic must be a non-empty string`;\n\t}\n\tif (topic.length > maxTopicLength) {\n\t\treturn `${owner}: topic exceeds maxTopicLength`;\n\t}\n\treturn undefined;\n}\n\nfunction hasHubTopic(runtime: DynamicHubRuntime, topic: string): boolean {\n\treturn runtime.topics.includes(topic);\n}\n\nfunction addHubTopic(runtime: DynamicHubRuntime, topic: string): void {\n\tif (!hasHubTopic(runtime, topic)) runtime.topics = [...runtime.topics, topic];\n}\n\nfunction deleteHubTopic(runtime: DynamicHubRuntime, topic: string): void {\n\truntime.topics = runtime.topics.filter((existing) => existing !== topic);\n}\n\nfunction canAddHubTopic(\n\truntime: DynamicHubRuntime,\n\ttopic: string,\n\tmaxTopics: number,\n): string | undefined {\n\tif (hasHubTopic(runtime, topic)) return undefined;\n\treturn runtime.topics.length >= maxTopics\n\t\t? \"dynamicHub: topic count exceeds maxTopics\"\n\t\t: undefined;\n}\n\nfunction isReachableUpstream(from: Node<unknown>, target: Node<unknown>): boolean {\n\tconst seen = new Set<Node<unknown>>();\n\tconst stack: Node<unknown>[] = [from];\n\twhile (stack.length > 0) {\n\t\tconst node = stack.pop();\n\t\tif (node === undefined) continue;\n\t\tif (node === target) return true;\n\t\tif (seen.has(node)) continue;\n\t\tseen.add(node);\n\t\tfor (const dep of node.deps) stack.push(dep);\n\t}\n\treturn false;\n}\n\nfunction requireDynamicHubState(hub: DynamicHub<unknown>): DynamicHubState<unknown> {\n\tconst state = dynamicHubStates.get(hub);\n\tif (state === undefined) throw new Error(\"dynamicHub: unknown hub implementation\");\n\treturn state;\n}\n"],"mappings":"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","names":["command"]}

package/dist/observe-event-log-0SVsx7JG.d.cts

@@ -0,0 +1,88 @@
+import { b as AppendLogPage, d as AppendLogStorageTier, c as AppendLogReadOptions } from './append-log-DisvEReb.cjs';
+import { C as Codec } from './codec-BB7p8fJc.cjs';
+
+/**
+ * Storage scalar helpers (D88): host BigInt in memory, canonical decimal strings on JSON/storage.
+ */
+/** Canonical decimal integer string; no leading zeroes, and no negative zero. */
+type DecimalIntegerString = string;
+/** Canonical non-negative decimal integer string. */
+type NonNegativeDecimalIntegerString = DecimalIntegerString;
+/** Test whether a value is a canonical decimal integer string. */
+declare function isDecimalIntegerString(value: unknown): value is DecimalIntegerString;
+/** Test whether a value is a canonical non-negative decimal integer string. */
+declare function isNonNegativeDecimalIntegerString(value: unknown): value is NonNegativeDecimalIntegerString;
+/** Assert a canonical decimal integer string and return it typed. */
+declare function assertDecimalIntegerString(value: unknown, label?: string): DecimalIntegerString;
+/** Assert a canonical non-negative decimal integer string and return it typed. */
+declare function assertNonNegativeDecimalIntegerString(value: unknown, label?: string): NonNegativeDecimalIntegerString;
+/** Convert a host BigInt to the canonical decimal storage scalar. */
+declare function bigIntToDecimalString(value: bigint): DecimalIntegerString;
+/** Convert a non-negative host BigInt to the canonical non-negative decimal storage scalar. */
+declare function bigIntToNonNegativeDecimalString(value: bigint): NonNegativeDecimalIntegerString;
+/** Parse a canonical decimal storage scalar into host BigInt. */
+declare function decimalStringToBigInt(value: DecimalIntegerString): bigint;
+/** Parse a canonical non-negative decimal storage scalar into host BigInt. */
+declare function nonNegativeDecimalStringToBigInt(value: NonNegativeDecimalIntegerString): bigint;
+
+/**
+ * Storage change envelopes (D82): persistence framing for raw graph/data-structure deltas.
+ */
+
+/** Storage-side lifecycle namespace for change envelopes; presentation framing only. */
+type ChangeLifecycle = "spec" | "data" | "ownership";
+/** D84 cross-runtime wall-clock nanosecond metadata: canonical non-negative decimal string. */
+type StorageTimestampNs = NonNegativeDecimalIntegerString;
+/** Persistence envelope for raw graph/data-structure deltas (D82), not restore semantics. */
+interface ChangeEnvelope<T = unknown> {
+    readonly lifecycle: ChangeLifecycle;
+    readonly structure: string;
+    readonly version: number | string;
+    readonly t_ns: StorageTimestampNs;
+    readonly seq?: number;
+    readonly change: T;
+}
+/** Options for wrapping a raw change in a storage envelope. */
+interface ChangeEnvelopeOptions {
+    lifecycle?: ChangeLifecycle;
+    structure: string;
+    version?: number | string;
+    t_ns?: StorageTimestampNs;
+    seq?: number;
+}
+/** Wall-clock nanoseconds for storage metadata. */
+declare function nowNs(): StorageTimestampNs;
+/** Wrap a raw change payload in a D82 storage envelope. */
+declare function envelopeChange<T>(change: T, opts: ChangeEnvelopeOptions): ChangeEnvelope<T>;
+/** Validate a decoded D82 change envelope and return it with typed payload. */
+declare function assertChangeEnvelope<T = unknown>(value: unknown): ChangeEnvelope<T>;
+/** Stable JSON codec for D82 change envelopes, with strict framing checks. */
+declare function changeEnvelopeCodec<T = unknown>(): Codec<ChangeEnvelope<T>>;
+
+interface ObserveEventLike {
+    readonly seq: number;
+    readonly path: string;
+}
+/** Storage frame for one Graph.observe() event, preserving graph observe sequence. */
+interface ObserveEventFrame<T = unknown> extends ChangeEnvelope<T> {
+    readonly structure: "observe-event";
+    readonly observeSeq: number;
+    readonly path: string;
+    readonly stream?: string;
+}
+/** One ordered observe-event log page. It is not graph projection or restore replay. */
+type ObserveEventLogPage<T = unknown> = AppendLogPage<ObserveEventFrame<T>>;
+/** Create a storage frame from one observe event and mapped payload. */
+declare function observeEventFrame<T>(event: ObserveEventLike, value: T, opts?: {
+    stream?: string;
+}): ObserveEventFrame<T>;
+/** Validate a decoded D82 observe-event storage frame. */
+declare function assertObserveEventFrame<T = unknown>(value: unknown): ObserveEventFrame<T>;
+/** Stable JSON codec for D82 observe-event frames, not restore records. */
+declare function observeEventFrameCodec<T = unknown>(): Codec<ObserveEventFrame<T>>;
+/**
+ * Read one ordered observe-event log page without projecting it into graph state.
+ */
+declare function readObserveEventLogPage<T = unknown>(log: AppendLogStorageTier<ObserveEventFrame<T>>, opts?: AppendLogReadOptions): Promise<ObserveEventLogPage<T>>;
+
+export { type ChangeEnvelope as C, type DecimalIntegerString as D, type NonNegativeDecimalIntegerString as N, type ObserveEventFrame as O, type StorageTimestampNs as S, type ChangeEnvelopeOptions as a, type ChangeLifecycle as b, type ObserveEventLogPage as c, assertChangeEnvelope as d, assertDecimalIntegerString as e, assertNonNegativeDecimalIntegerString as f, assertObserveEventFrame as g, bigIntToDecimalString as h, bigIntToNonNegativeDecimalString as i, changeEnvelopeCodec as j, decimalStringToBigInt as k, envelopeChange as l, isDecimalIntegerString as m, isNonNegativeDecimalIntegerString as n, nonNegativeDecimalStringToBigInt as o, nowNs as p, observeEventFrame as q, observeEventFrameCodec as r, readObserveEventLogPage as s };

package/dist/observe-event-log-Dnm76owp.d.ts

@@ -0,0 +1,88 @@
+import { b as AppendLogPage, d as AppendLogStorageTier, c as AppendLogReadOptions } from './append-log-DzKMmjxx.js';
+import { C as Codec } from './codec-BB7p8fJc.js';
+
+/**
+ * Storage scalar helpers (D88): host BigInt in memory, canonical decimal strings on JSON/storage.
+ */
+/** Canonical decimal integer string; no leading zeroes, and no negative zero. */
+type DecimalIntegerString = string;
+/** Canonical non-negative decimal integer string. */
+type NonNegativeDecimalIntegerString = DecimalIntegerString;
+/** Test whether a value is a canonical decimal integer string. */
+declare function isDecimalIntegerString(value: unknown): value is DecimalIntegerString;
+/** Test whether a value is a canonical non-negative decimal integer string. */
+declare function isNonNegativeDecimalIntegerString(value: unknown): value is NonNegativeDecimalIntegerString;
+/** Assert a canonical decimal integer string and return it typed. */
+declare function assertDecimalIntegerString(value: unknown, label?: string): DecimalIntegerString;
+/** Assert a canonical non-negative decimal integer string and return it typed. */
+declare function assertNonNegativeDecimalIntegerString(value: unknown, label?: string): NonNegativeDecimalIntegerString;
+/** Convert a host BigInt to the canonical decimal storage scalar. */
+declare function bigIntToDecimalString(value: bigint): DecimalIntegerString;
+/** Convert a non-negative host BigInt to the canonical non-negative decimal storage scalar. */
+declare function bigIntToNonNegativeDecimalString(value: bigint): NonNegativeDecimalIntegerString;
+/** Parse a canonical decimal storage scalar into host BigInt. */
+declare function decimalStringToBigInt(value: DecimalIntegerString): bigint;
+/** Parse a canonical non-negative decimal storage scalar into host BigInt. */
+declare function nonNegativeDecimalStringToBigInt(value: NonNegativeDecimalIntegerString): bigint;
+
+/**
+ * Storage change envelopes (D82): persistence framing for raw graph/data-structure deltas.
+ */
+
+/** Storage-side lifecycle namespace for change envelopes; presentation framing only. */
+type ChangeLifecycle = "spec" | "data" | "ownership";
+/** D84 cross-runtime wall-clock nanosecond metadata: canonical non-negative decimal string. */
+type StorageTimestampNs = NonNegativeDecimalIntegerString;
+/** Persistence envelope for raw graph/data-structure deltas (D82), not restore semantics. */
+interface ChangeEnvelope<T = unknown> {
+    readonly lifecycle: ChangeLifecycle;
+    readonly structure: string;
+    readonly version: number | string;
+    readonly t_ns: StorageTimestampNs;
+    readonly seq?: number;
+    readonly change: T;
+}
+/** Options for wrapping a raw change in a storage envelope. */
+interface ChangeEnvelopeOptions {
+    lifecycle?: ChangeLifecycle;
+    structure: string;
+    version?: number | string;
+    t_ns?: StorageTimestampNs;
+    seq?: number;
+}
+/** Wall-clock nanoseconds for storage metadata. */
+declare function nowNs(): StorageTimestampNs;
+/** Wrap a raw change payload in a D82 storage envelope. */
+declare function envelopeChange<T>(change: T, opts: ChangeEnvelopeOptions): ChangeEnvelope<T>;
+/** Validate a decoded D82 change envelope and return it with typed payload. */
+declare function assertChangeEnvelope<T = unknown>(value: unknown): ChangeEnvelope<T>;
+/** Stable JSON codec for D82 change envelopes, with strict framing checks. */
+declare function changeEnvelopeCodec<T = unknown>(): Codec<ChangeEnvelope<T>>;
+
+interface ObserveEventLike {
+    readonly seq: number;
+    readonly path: string;
+}
+/** Storage frame for one Graph.observe() event, preserving graph observe sequence. */
+interface ObserveEventFrame<T = unknown> extends ChangeEnvelope<T> {
+    readonly structure: "observe-event";
+    readonly observeSeq: number;
+    readonly path: string;
+    readonly stream?: string;
+}
+/** One ordered observe-event log page. It is not graph projection or restore replay. */
+type ObserveEventLogPage<T = unknown> = AppendLogPage<ObserveEventFrame<T>>;
+/** Create a storage frame from one observe event and mapped payload. */
+declare function observeEventFrame<T>(event: ObserveEventLike, value: T, opts?: {
+    stream?: string;
+}): ObserveEventFrame<T>;
+/** Validate a decoded D82 observe-event storage frame. */
+declare function assertObserveEventFrame<T = unknown>(value: unknown): ObserveEventFrame<T>;
+/** Stable JSON codec for D82 observe-event frames, not restore records. */
+declare function observeEventFrameCodec<T = unknown>(): Codec<ObserveEventFrame<T>>;
+/**
+ * Read one ordered observe-event log page without projecting it into graph state.
+ */
+declare function readObserveEventLogPage<T = unknown>(log: AppendLogStorageTier<ObserveEventFrame<T>>, opts?: AppendLogReadOptions): Promise<ObserveEventLogPage<T>>;
+
+export { type ChangeEnvelope as C, type DecimalIntegerString as D, type NonNegativeDecimalIntegerString as N, type ObserveEventFrame as O, type StorageTimestampNs as S, type ChangeEnvelopeOptions as a, type ChangeLifecycle as b, type ObserveEventLogPage as c, assertChangeEnvelope as d, assertDecimalIntegerString as e, assertNonNegativeDecimalIntegerString as f, assertObserveEventFrame as g, bigIntToDecimalString as h, bigIntToNonNegativeDecimalString as i, changeEnvelopeCodec as j, decimalStringToBigInt as k, envelopeChange as l, isDecimalIntegerString as m, isNonNegativeDecimalIntegerString as n, nonNegativeDecimalStringToBigInt as o, nowNs as p, observeEventFrame as q, observeEventFrameCodec as r, readObserveEventLogPage as s };