@labacacia/nps-sdk 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/ncp/preamble.js

@@ -0,0 +1,74 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * NCP native-mode connection preamble — the 8-byte ASCII constant
+ * `"NPS/1.0\n"` that every native-mode client MUST emit immediately
+ * after the transport handshake and before its first HelloFrame.
+ * Defined by NPS-RFC-0001 and NPS-1 NCP §2.6.1.
+ *
+ * HTTP-mode connections do not use the preamble.
+ */
+export const PREAMBLE_LITERAL = "NPS/1.0\n";
+export const PREAMBLE_LENGTH = 8;
+export const PREAMBLE_BYTES = new TextEncoder().encode(PREAMBLE_LITERAL);
+/** Validation timeout in milliseconds (NPS-RFC-0001 §4.1). */
+export const PREAMBLE_READ_TIMEOUT_MS = 10_000;
+/** Maximum delay before closing after a mismatch, in milliseconds. */
+export const PREAMBLE_CLOSE_DEADLINE_MS = 500;
+export const PREAMBLE_ERROR_CODE = "NCP-PREAMBLE-INVALID";
+export const PREAMBLE_STATUS_CODE = "NPS-PROTO-PREAMBLE-INVALID";
+export class NcpPreambleInvalidError extends Error {
+    errorCode = PREAMBLE_ERROR_CODE;
+    statusCode = PREAMBLE_STATUS_CODE;
+    constructor(reason) {
+        super(reason);
+        this.name = "NcpPreambleInvalidError";
+    }
+}
+/**
+ * Returns `true` iff `buf` starts with the 8-byte NPS/1.0 preamble.
+ * Safe to call with shorter buffers.
+ */
+export function preambleMatches(buf) {
+    if (buf.length < PREAMBLE_LENGTH)
+        return false;
+    for (let i = 0; i < PREAMBLE_LENGTH; i++) {
+        if (buf[i] !== PREAMBLE_BYTES[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Validates a presumed-preamble buffer.
+ * Returns `{ valid: true, reason: "" }` on success or `{ valid: false, reason }` on failure.
+ */
+export function tryValidatePreamble(buf) {
+    if (buf.length < PREAMBLE_LENGTH) {
+        return { valid: false, reason: `short read (${buf.length}/${PREAMBLE_LENGTH} bytes); peer is not speaking NCP` };
+    }
+    if (!preambleMatches(buf)) {
+        // "NPS/" = 0x4E 0x50 0x53 0x2F
+        const isNps = buf[0] === 0x4e && buf[1] === 0x50 && buf[2] === 0x53 && buf[3] === 0x2f;
+        if (isNps) {
+            return { valid: false, reason: "future-major-version NPS preamble; close with NPS-PREAMBLE-UNSUPPORTED-VERSION diagnostic" };
+        }
+        return { valid: false, reason: "preamble mismatch; peer is not speaking NPS/1.x" };
+    }
+    return { valid: true, reason: "" };
+}
+/**
+ * Validates a presumed-preamble buffer, throwing {@link NcpPreambleInvalidError} on mismatch.
+ */
+export function validatePreamble(buf) {
+    const { valid, reason } = tryValidatePreamble(buf);
+    if (!valid)
+        throw new NcpPreambleInvalidError(reason);
+}
+/**
+ * Writes the preamble bytes to `writer`.
+ * `writer` must expose a `write(buf: Uint8Array): void` method (e.g. Node.js `net.Socket`).
+ */
+export function writePreamble(writer) {
+    writer.write(PREAMBLE_BYTES);
+}
+//# sourceMappingURL=preamble.js.map

package/dist/ncp/preamble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.js","sourceRoot":"","sources":["../../src/ncp/preamble.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAe,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACrF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,sEAAsE;AACtE,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,MAAM,CAAC,MAAM,mBAAmB,GAAI,sBAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEjE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,SAAS,GAAI,mBAAmB,CAAC;IACjC,UAAU,GAAG,oBAAoB,CAAC;IAE3C,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAe;IAC7C,IAAI,GAAG,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,KAAK,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAe;IACjD,IAAI,GAAG,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,GAAG,CAAC,MAAM,IAAI,eAAe,mCAAmC,EAAE,CAAC;IACnH,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,+BAA+B;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;QACvF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,2FAA2F,EAAE,CAAC;QAC/H,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iDAAiD,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe;IAC9C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwC;IACpE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAC/B,CAAC"}

package/dist/ncp/registry.js

@@ -0,0 +1,13 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { FrameType } from "../core/frames.js";
+import { AnchorFrame, CapsFrame, DiffFrame, ErrorFrame, HelloFrame, StreamFrame } from "./frames.js";
+export function registerNcpFrames(registry) {
+    registry.register(FrameType.ANCHOR, AnchorFrame);
+    registry.register(FrameType.DIFF, DiffFrame);
+    registry.register(FrameType.STREAM, StreamFrame);
+    registry.register(FrameType.CAPS, CapsFrame);
+    registry.register(FrameType.HELLO, HelloFrame);
+    registry.register(FrameType.ERROR, ErrorFrame);
+}
+//# sourceMappingURL=registry.js.map

package/dist/ncp/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/ncp/registry.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAGtC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErG,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAI,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAI,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAG,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAG,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/ncp/stream-manager.js

@@ -0,0 +1,163 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
+//
+// StreamManager — Concurrent stream tracking, sequence validation, flow control
+// NPS-1 §4.3, §7.3
+import { NcpError } from "../core/frame-header.js";
+import { NCP_ERROR_CODES } from "./ncp-error-codes.js";
+/**
+ * Manages concurrent StreamFrame streams.
+ *
+ * - Tracks active streams by stream_id
+ * - Validates sequential seq numbers
+ * - Enforces max concurrent stream limit (NPS-1 §7.3, default 32)
+ * - Detects early termination via error_code
+ * - Enforces window-based flow control on outgoing streams (NCP-S-07–11)
+ */
+export class StreamManager {
+    streams = new Map();
+    outgoing = new Map();
+    maxConcurrent;
+    constructor(options) {
+        this.maxConcurrent = options?.maxConcurrent ?? 32;
+    }
+    /**
+     * Receive a StreamFrame chunk.
+     *
+     * @returns true if stream is complete (is_last=true or error_code set).
+     * @throws {NcpError} NCP-STREAM-LIMIT-EXCEEDED if too many concurrent streams.
+     * @throws {NcpError} NCP-STREAM-NOT-FOUND if frame.seq > 0 for a stream that was never opened.
+     * @throws {NcpError} NPS-CLIENT-CONFLICT if the stream_id was already completed (stream-id reuse; see test_cases NCP-S-04).
+     * @throws {NcpError} NCP-STREAM-SEQ-GAP if sequence number is not expected.
+     */
+    receive(frame) {
+        let stream = this.streams.get(frame.stream_id);
+        if (!stream) {
+            // A stream is opened only by seq=0. Any other seq on an unknown stream_id
+            // means the opener was never seen (NCP-S-13: unknown stream_id).
+            if (frame.seq !== 0) {
+                throw new NcpError(NCP_ERROR_CODES.NCP_STREAM_NOT_FOUND, `Unknown stream_id ${frame.stream_id} — first frame must have seq=0`);
+            }
+            // New stream — check concurrent limit
+            if (this.streams.size >= this.maxConcurrent) {
+                throw new NcpError(NCP_ERROR_CODES.NCP_STREAM_LIMIT_EXCEEDED, `Max concurrent streams (${this.maxConcurrent}) exceeded`);
+            }
+            stream = {
+                streamId: frame.stream_id,
+                expectedSeq: 0,
+                chunks: [],
+                completed: false,
+            };
+            this.streams.set(frame.stream_id, stream);
+        }
+        // Reject writes to completed streams. Per test_cases NCP-S-04, the spec does
+        // not assign a dedicated NCP code for stream-id reuse; interim mapping uses
+        // the NPS-level NPS-CLIENT-CONFLICT until a spec-side code is added.
+        if (stream.completed) {
+            throw new NcpError("NPS-CLIENT-CONFLICT", `Stream ${frame.stream_id} is already completed — cannot reuse stream_id`);
+        }
+        // Sequence validation
+        if (frame.seq !== stream.expectedSeq) {
+            // Duplicate detection — same seq as last accepted
+            if (frame.seq < stream.expectedSeq) {
+                // Ignore duplicate (idempotent)
+                return false;
+            }
+            throw new NcpError(NCP_ERROR_CODES.NCP_STREAM_SEQ_GAP, `Expected seq ${stream.expectedSeq}, got ${frame.seq} on stream ${frame.stream_id}`);
+        }
+        stream.chunks.push(frame.data);
+        stream.expectedSeq = frame.seq + 1;
+        // Early termination via error_code
+        if (frame.error_code) {
+            stream.completed = true;
+            stream.errorCode = frame.error_code;
+            return true;
+        }
+        // Normal completion
+        if (frame.is_last) {
+            stream.completed = true;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Send a StreamFrame on an outgoing stream, enforcing window-based flow control.
+     *
+     * - seq=0 with window_size initialises remainingWindow (no decrement for opening frame).
+     * - Subsequent sends decrement remainingWindow when flow control is active.
+     * - Throws NCP-STREAM-WINDOW-OVERFLOW when remainingWindow === 0.
+     *
+     * @throws {NcpError} NCP-STREAM-WINDOW-OVERFLOW if window is exhausted.
+     */
+    send(frame) {
+        let out = this.outgoing.get(frame.stream_id);
+        if (!out) {
+            out = {
+                streamId: frame.stream_id,
+                remainingWindow: undefined,
+                paused: false,
+            };
+            this.outgoing.set(frame.stream_id, out);
+        }
+        // Opening frame: initialise window from window_size if provided.
+        if (frame.seq === 0 && frame.window_size !== undefined) {
+            out.remainingWindow = frame.window_size;
+            return; // opening frame does not consume a window slot
+        }
+        // Flow control check for subsequent frames.
+        if (out.remainingWindow !== undefined) {
+            if (out.remainingWindow === 0) {
+                throw new NcpError(NCP_ERROR_CODES.NCP_STREAM_WINDOW_OVERFLOW, `Window exhausted on stream ${frame.stream_id}`);
+            }
+            out.remainingWindow -= 1;
+        }
+    }
+    /**
+     * Update the send window for a stream.
+     *
+     * Called when a reverse-direction StreamFrame arrives with data=[] and window_size set.
+     * Replaces remainingWindow with new_size. Sets paused=true when new_size === 0.
+     */
+    updateWindow(streamId, newSize) {
+        let out = this.outgoing.get(streamId);
+        if (!out) {
+            out = {
+                streamId,
+                remainingWindow: newSize,
+                paused: newSize === 0,
+            };
+            this.outgoing.set(streamId, out);
+            return;
+        }
+        out.remainingWindow = newSize;
+        out.paused = newSize === 0;
+    }
+    /**
+     * Returns true when the outgoing stream is paused (window=0 was received).
+     * Resumes (returns false) once a non-zero window update arrives.
+     */
+    isPaused(streamId) {
+        return this.outgoing.get(streamId)?.paused ?? false;
+    }
+    /** Get reassembled data for a completed stream. */
+    getData(streamId) {
+        const stream = this.streams.get(streamId);
+        if (!stream || !stream.completed)
+            return null;
+        return stream.chunks.flat();
+    }
+    /** Get error code if stream terminated with error. */
+    getError(streamId) {
+        return this.streams.get(streamId)?.errorCode;
+    }
+    /** Number of active (non-completed) streams. */
+    get activeCount() {
+        let count = 0;
+        for (const s of this.streams.values()) {
+            if (!s.completed)
+                count++;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=stream-manager.js.map

package/dist/ncp/stream-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-manager.js","sourceRoot":"","sources":["../../src/ncp/stream-manager.ts"],"names":[],"mappings":"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"}

package/dist/ndp/frames.js

@@ -0,0 +1,87 @@
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+import { EncodingTier, FrameType } from "../core/frames.js";
+export class AnnounceFrame {
+    nid;
+    addresses;
+    capabilities;
+    ttl;
+    timestamp;
+    signature;
+    nodeType;
+    frameType = FrameType.ANNOUNCE;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(nid, addresses, capabilities, ttl, timestamp, signature, nodeType) {
+        this.nid = nid;
+        this.addresses = addresses;
+        this.capabilities = capabilities;
+        this.ttl = ttl;
+        this.timestamp = timestamp;
+        this.signature = signature;
+        this.nodeType = nodeType;
+    }
+    unsignedDict() {
+        return {
+            nid: this.nid,
+            addresses: this.addresses,
+            capabilities: this.capabilities,
+            ttl: this.ttl,
+            timestamp: this.timestamp,
+            node_type: this.nodeType ?? null,
+        };
+    }
+    toDict() {
+        return { ...this.unsignedDict(), signature: this.signature };
+    }
+    static fromDict(data) {
+        return new AnnounceFrame(data["nid"], data["addresses"], data["capabilities"], data["ttl"], data["timestamp"], data["signature"], data["node_type"] ?? undefined);
+    }
+}
+export class ResolveFrame {
+    target;
+    requesterNid;
+    resolved;
+    frameType = FrameType.RESOLVE;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(target, requesterNid, resolved) {
+        this.target = target;
+        this.requesterNid = requesterNid;
+        this.resolved = resolved;
+    }
+    toDict() {
+        return {
+            target: this.target,
+            requester_nid: this.requesterNid ?? null,
+            resolved: this.resolved ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new ResolveFrame(data["target"], data["requester_nid"] ?? undefined, data["resolved"] ?? undefined);
+    }
+}
+export class GraphFrame {
+    seq;
+    initialSync;
+    nodes;
+    patch;
+    frameType = FrameType.GRAPH;
+    preferredTier = EncodingTier.MSGPACK;
+    constructor(seq, initialSync, nodes, patch) {
+        this.seq = seq;
+        this.initialSync = initialSync;
+        this.nodes = nodes;
+        this.patch = patch;
+    }
+    toDict() {
+        return {
+            seq: this.seq,
+            initial_sync: this.initialSync,
+            nodes: this.nodes ?? null,
+            patch: this.patch ?? null,
+        };
+    }
+    static fromDict(data) {
+        return new GraphFrame(data["seq"], data["initial_sync"], data["nodes"] ?? undefined, data["patch"] ?? undefined);
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/ndp/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","sourceRoot":"","sources":["../../src/ndp/frames.ts"],"names":[],"mappings":"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"}

package/dist/ndp/index.js

@@ -1,224 +1,7 @@
-import * as ed25519 from '@noble/ed25519';
-import { sha512 } from '@noble/hashes/sha512';
-
-// src/ndp/frames.ts
-var AnnounceFrame = class _AnnounceFrame {
-  constructor(nid, addresses, capabilities, ttl, timestamp, signature, nodeType) {
-    this.nid = nid;
-    this.addresses = addresses;
-    this.capabilities = capabilities;
-    this.ttl = ttl;
-    this.timestamp = timestamp;
-    this.signature = signature;
-    this.nodeType = nodeType;
-  }
-  nid;
-  addresses;
-  capabilities;
-  ttl;
-  timestamp;
-  signature;
-  nodeType;
-  frameType = 48 /* ANNOUNCE */;
-  preferredTier = 1 /* MSGPACK */;
-  unsignedDict() {
-    return {
-      nid: this.nid,
-      addresses: this.addresses,
-      capabilities: this.capabilities,
-      ttl: this.ttl,
-      timestamp: this.timestamp,
-      node_type: this.nodeType ?? null
-    };
-  }
-  toDict() {
-    return { ...this.unsignedDict(), signature: this.signature };
-  }
-  static fromDict(data) {
-    return new _AnnounceFrame(
-      data["nid"],
-      data["addresses"],
-      data["capabilities"],
-      data["ttl"],
-      data["timestamp"],
-      data["signature"],
-      data["node_type"] ?? void 0
-    );
-  }
-};
-var ResolveFrame = class _ResolveFrame {
-  constructor(target, requesterNid, resolved) {
-    this.target = target;
-    this.requesterNid = requesterNid;
-    this.resolved = resolved;
-  }
-  target;
-  requesterNid;
-  resolved;
-  frameType = 49 /* RESOLVE */;
-  preferredTier = 1 /* MSGPACK */;
-  toDict() {
-    return {
-      target: this.target,
-      requester_nid: this.requesterNid ?? null,
-      resolved: this.resolved ?? null
-    };
-  }
-  static fromDict(data) {
-    return new _ResolveFrame(
-      data["target"],
-      data["requester_nid"] ?? void 0,
-      data["resolved"] ?? void 0
-    );
-  }
-};
-var GraphFrame = class _GraphFrame {
-  constructor(seq, initialSync, nodes, patch) {
-    this.seq = seq;
-    this.initialSync = initialSync;
-    this.nodes = nodes;
-    this.patch = patch;
-  }
-  seq;
-  initialSync;
-  nodes;
-  patch;
-  frameType = 50 /* GRAPH */;
-  preferredTier = 1 /* MSGPACK */;
-  toDict() {
-    return {
-      seq: this.seq,
-      initial_sync: this.initialSync,
-      nodes: this.nodes ?? null,
-      patch: this.patch ?? null
-    };
-  }
-  static fromDict(data) {
-    return new _GraphFrame(
-      data["seq"],
-      data["initial_sync"],
-      data["nodes"] ?? void 0,
-      data["patch"] ?? void 0
-    );
-  }
-};
-
-// src/ndp/registry.ts
-function registerNdpFrames(registry) {
-  registry.register(48 /* ANNOUNCE */, AnnounceFrame);
-  registry.register(49 /* RESOLVE */, ResolveFrame);
-  registry.register(50 /* GRAPH */, GraphFrame);
-}
-
-// src/ndp/ndp-registry.ts
-var InMemoryNdpRegistry = class _InMemoryNdpRegistry {
-  _store = /* @__PURE__ */ new Map();
-  // Replaceable for testing
-  clock = () => Date.now();
-  announce(frame) {
-    const expiresAt = this.clock() + frame.ttl * 1e3;
-    if (frame.ttl === 0) {
-      this._store.delete(frame.nid);
-      return;
-    }
-    this._store.set(frame.nid, { frame, expiresAt });
-  }
-  getByNid(nid) {
-    const entry = this._store.get(nid);
-    if (entry === void 0) return void 0;
-    if (this.clock() > entry.expiresAt) {
-      this._store.delete(nid);
-      return void 0;
-    }
-    return entry.frame;
-  }
-  resolve(target) {
-    for (const [nid, entry] of this._store) {
-      if (this.clock() > entry.expiresAt) {
-        this._store.delete(nid);
-        continue;
-      }
-      if (!_InMemoryNdpRegistry.nwpTargetMatchesNid(nid, target)) continue;
-      const addr = entry.frame.addresses[0];
-      if (addr === void 0) continue;
-      return { host: addr.host, port: addr.port, ttl: entry.frame.ttl };
-    }
-    return void 0;
-  }
-  getAll() {
-    const now = this.clock();
-    const result = [];
-    for (const [nid, entry] of this._store) {
-      if (now > entry.expiresAt) {
-        this._store.delete(nid);
-        continue;
-      }
-      result.push(entry.frame);
-    }
-    return result;
-  }
-  static nwpTargetMatchesNid(nid, target) {
-    const nidParts = nid.split(":");
-    if (nidParts.length < 5 || nidParts[0] !== "urn" || nidParts[1] !== "nps" || nidParts[2] !== "node") {
-      return false;
-    }
-    if (!target.startsWith("nwp://")) return false;
-    const nidAuthority = nidParts[3];
-    const nidPath = nidParts[4];
-    const rest = target.slice("nwp://".length);
-    const slashIdx = rest.indexOf("/");
-    if (slashIdx === -1) return false;
-    const urlAuthority = rest.slice(0, slashIdx);
-    const urlPath = rest.slice(slashIdx + 1);
-    if (urlAuthority !== nidAuthority) return false;
-    if (urlPath === nidPath) return true;
-    if (urlPath.startsWith(nidPath + "/")) return true;
-    return false;
-  }
-};
-ed25519.etc.sha512Sync = (...m) => sha512(ed25519.etc.concatBytes(...m));
-var NdpAnnounceResult = {
-  ok: () => ({ isValid: true }),
-  fail: (errorCode, message) => ({ isValid: false, errorCode, message })
-};
-var NdpAnnounceValidator = class {
-  _keys = /* @__PURE__ */ new Map();
-  // nid → "ed25519:<hex>"
-  registerPublicKey(nid, encodedPubKey) {
-    this._keys.set(nid, encodedPubKey);
-  }
-  removePublicKey(nid) {
-    this._keys.delete(nid);
-  }
-  get knownPublicKeys() {
-    return this._keys;
-  }
-  validate(frame) {
-    const encoded = this._keys.get(frame.nid);
-    if (encoded === void 0) {
-      return NdpAnnounceResult.fail("NDP-ANNOUNCE-NID-MISMATCH", `No public key registered for NID: ${frame.nid}`);
-    }
-    try {
-      const prefix = "ed25519:";
-      const pubHex = encoded.startsWith(prefix) ? encoded.slice(prefix.length) : encoded;
-      const pubKey = Buffer.from(pubHex, "hex");
-      const sig = frame.signature;
-      if (!sig.startsWith(prefix)) {
-        return NdpAnnounceResult.fail("NDP-ANNOUNCE-SIG-INVALID", "Signature must start with 'ed25519:'");
-      }
-      const sigBytes = Buffer.from(sig.slice(prefix.length), "base64");
-      const unsigned = frame.unsignedDict();
-      const canonical = JSON.stringify(unsigned, Object.keys(unsigned).sort());
-      const message = new TextEncoder().encode(canonical);
-      const valid = ed25519.verify(sigBytes, message, pubKey);
-      if (!valid) return NdpAnnounceResult.fail("NDP-ANNOUNCE-SIG-INVALID", "Ed25519 signature verification failed.");
-      return NdpAnnounceResult.ok();
-    } catch {
-      return NdpAnnounceResult.fail("NDP-ANNOUNCE-SIG-INVALID", "Ed25519 signature verification failed.");
-    }
-  }
-};
-
-export { AnnounceFrame, GraphFrame, InMemoryNdpRegistry, NdpAnnounceResult, NdpAnnounceValidator, ResolveFrame, registerNdpFrames };
-//# sourceMappingURL=index.js.map
+// Copyright 2026 INNO LOTUS PTY LTD
+// SPDX-License-Identifier: Apache-2.0
+export * from "./frames.js";
+export * from "./registry.js";
+export * from "./ndp-registry.js";
+export * from "./validator.js";
 //# sourceMappingURL=index.js.map

package/dist/ndp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ndp/frames.ts","../../src/ndp/registry.ts","../../src/ndp/ndp-registry.ts","../../src/ndp/validator.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport { EncodingTier, FrameType } from \"../core/frames.js\";\nimport type { NpsFrame } from \"../core/codec.js\";\n\nexport interface NdpAddress {\n  host:     string;\n  port:     number;\n  protocol: string;\n}\n\nexport interface NdpGraphNode {\n  nid:          string;\n  addresses:    readonly NdpAddress[];\n  capabilities: readonly string[];\n  nodeType?:    string;\n}\n\nexport interface NdpResolveResult {\n  host:              string;\n  port:              number;\n  ttl:               number;\n  certFingerprint?:  string;\n}\n\nexport class AnnounceFrame implements NpsFrame {\n  readonly frameType     = FrameType.ANNOUNCE;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly nid:          string,\n    public readonly addresses:    readonly NdpAddress[],\n    public readonly capabilities: readonly string[],\n    public readonly ttl:          number,\n    public readonly timestamp:    string,\n    public readonly signature:    string,\n    public readonly nodeType?:    string,\n  ) {}\n\n  unsignedDict(): Record<string, unknown> {\n    return {\n      nid:          this.nid,\n      addresses:    this.addresses,\n      capabilities: this.capabilities,\n      ttl:          this.ttl,\n      timestamp:    this.timestamp,\n      node_type:    this.nodeType ?? null,\n    };\n  }\n\n  toDict(): Record<string, unknown> {\n    return { ...this.unsignedDict(), signature: this.signature };\n  }\n\n  static fromDict(data: Record<string, unknown>): AnnounceFrame {\n    return new AnnounceFrame(\n      data[\"nid\"]          as string,\n      data[\"addresses\"]    as NdpAddress[],\n      data[\"capabilities\"] as string[],\n      data[\"ttl\"]          as number,\n      data[\"timestamp\"]    as string,\n      data[\"signature\"]    as string,\n      (data[\"node_type\"]    as string | null) ?? undefined,\n    );\n  }\n}\n\nexport class ResolveFrame implements NpsFrame {\n  readonly frameType     = FrameType.RESOLVE;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly target:        string,\n    public readonly requesterNid?: string,\n    public readonly resolved?:     NdpResolveResult,\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      target:        this.target,\n      requester_nid: this.requesterNid ?? null,\n      resolved:      this.resolved     ?? null,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): ResolveFrame {\n    return new ResolveFrame(\n      data[\"target\"]         as string,\n      (data[\"requester_nid\"] as string | null) ?? undefined,\n      (data[\"resolved\"]      as NdpResolveResult | null) ?? undefined,\n    );\n  }\n}\n\nexport class GraphFrame implements NpsFrame {\n  readonly frameType     = FrameType.GRAPH;\n  readonly preferredTier = EncodingTier.MSGPACK;\n\n  constructor(\n    public readonly seq:         number,\n    public readonly initialSync: boolean,\n    public readonly nodes?:      readonly NdpGraphNode[],\n    public readonly patch?:      readonly Record<string, unknown>[],\n  ) {}\n\n  toDict(): Record<string, unknown> {\n    return {\n      seq:          this.seq,\n      initial_sync: this.initialSync,\n      nodes:        this.nodes ?? null,\n      patch:        this.patch ?? null,\n    };\n  }\n\n  static fromDict(data: Record<string, unknown>): GraphFrame {\n    return new GraphFrame(\n      data[\"seq\"]          as number,\n      data[\"initial_sync\"] as boolean,\n      (data[\"nodes\"] as NdpGraphNode[] | null) ?? undefined,\n      (data[\"patch\"] as Record<string, unknown>[] | null) ?? undefined,\n    );\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport { FrameRegistry } from \"../core/registry.js\";\nimport { FrameType } from \"../core/frames.js\";\nimport { AnnounceFrame, GraphFrame, ResolveFrame } from \"./frames.js\";\n\nexport function registerNdpFrames(registry: FrameRegistry): void {\n  registry.register(FrameType.ANNOUNCE, AnnounceFrame);\n  registry.register(FrameType.RESOLVE,  ResolveFrame);\n  registry.register(FrameType.GRAPH,    GraphFrame);\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { AnnounceFrame, NdpResolveResult } from \"./frames.js\";\n\ninterface RegistryEntry {\n  frame:     AnnounceFrame;\n  expiresAt: number;\n}\n\nexport class InMemoryNdpRegistry {\n  private readonly _store = new Map<string, RegistryEntry>();\n\n  // Replaceable for testing\n  clock: () => number = () => Date.now();\n\n  announce(frame: AnnounceFrame): void {\n    const expiresAt = this.clock() + frame.ttl * 1000;\n    if (frame.ttl === 0) {\n      this._store.delete(frame.nid);\n      return;\n    }\n    this._store.set(frame.nid, { frame, expiresAt });\n  }\n\n  getByNid(nid: string): AnnounceFrame | undefined {\n    const entry = this._store.get(nid);\n    if (entry === undefined) return undefined;\n    if (this.clock() > entry.expiresAt) {\n      this._store.delete(nid);\n      return undefined;\n    }\n    return entry.frame;\n  }\n\n  resolve(target: string): NdpResolveResult | undefined {\n    for (const [nid, entry] of this._store) {\n      if (this.clock() > entry.expiresAt) { this._store.delete(nid); continue; }\n      if (!InMemoryNdpRegistry.nwpTargetMatchesNid(nid, target)) continue;\n      const addr = entry.frame.addresses[0];\n      if (addr === undefined) continue;\n      return { host: addr.host, port: addr.port, ttl: entry.frame.ttl };\n    }\n    return undefined;\n  }\n\n  getAll(): AnnounceFrame[] {\n    const now    = this.clock();\n    const result: AnnounceFrame[] = [];\n    for (const [nid, entry] of this._store) {\n      if (now > entry.expiresAt) { this._store.delete(nid); continue; }\n      result.push(entry.frame);\n    }\n    return result;\n  }\n\n  static nwpTargetMatchesNid(nid: string, target: string): boolean {\n    // NID: urn:nps:node:{authority}:{path-segment}\n    // target: nwp://{authority}/{path}\n    const nidParts = nid.split(\":\");\n    if (nidParts.length < 5 || nidParts[0] !== \"urn\" || nidParts[1] !== \"nps\" || nidParts[2] !== \"node\") {\n      return false;\n    }\n    if (!target.startsWith(\"nwp://\")) return false;\n\n    const nidAuthority = nidParts[3]!;\n    const nidPath      = nidParts[4]!;\n    const rest         = target.slice(\"nwp://\".length);\n    const slashIdx     = rest.indexOf(\"/\");\n    if (slashIdx === -1) return false;\n\n    const urlAuthority = rest.slice(0, slashIdx);\n    const urlPath      = rest.slice(slashIdx + 1); // without leading slash\n\n    if (urlAuthority !== nidAuthority) return false;\n\n    // nidPath must be a prefix of urlPath at a segment boundary\n    if (urlPath === nidPath) return true;\n    if (urlPath.startsWith(nidPath + \"/\")) return true;\n    return false;\n  }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport * as ed25519 from \"@noble/ed25519\";\nimport { sha512 } from \"@noble/hashes/sha512\";\nimport type { AnnounceFrame } from \"./frames.js\";\n\ned25519.etc.sha512Sync = (...m) => sha512(ed25519.etc.concatBytes(...m));\n\nexport interface NdpAnnounceResult {\n  isValid:    boolean;\n  errorCode?: string;\n  message?:   string;\n}\n\nexport const NdpAnnounceResult = {\n  ok: (): NdpAnnounceResult => ({ isValid: true }),\n  fail: (errorCode: string, message: string): NdpAnnounceResult => ({ isValid: false, errorCode, message }),\n};\n\nexport class NdpAnnounceValidator {\n  private readonly _keys = new Map<string, string>(); // nid → \"ed25519:<hex>\"\n\n  registerPublicKey(nid: string, encodedPubKey: string): void {\n    this._keys.set(nid, encodedPubKey);\n  }\n\n  removePublicKey(nid: string): void {\n    this._keys.delete(nid);\n  }\n\n  get knownPublicKeys(): ReadonlyMap<string, string> {\n    return this._keys;\n  }\n\n  validate(frame: AnnounceFrame): NdpAnnounceResult {\n    const encoded = this._keys.get(frame.nid);\n    if (encoded === undefined) {\n      return NdpAnnounceResult.fail(\"NDP-ANNOUNCE-NID-MISMATCH\", `No public key registered for NID: ${frame.nid}`);\n    }\n\n    try {\n      const prefix  = \"ed25519:\";\n      const pubHex  = encoded.startsWith(prefix) ? encoded.slice(prefix.length) : encoded;\n      const pubKey  = Buffer.from(pubHex, \"hex\");\n\n      const sig = frame.signature;\n      if (!sig.startsWith(prefix)) {\n        return NdpAnnounceResult.fail(\"NDP-ANNOUNCE-SIG-INVALID\", \"Signature must start with 'ed25519:'\");\n      }\n      const sigBytes = Buffer.from(sig.slice(prefix.length), \"base64\");\n\n      const unsigned  = frame.unsignedDict();\n      const canonical = JSON.stringify(unsigned, Object.keys(unsigned).sort());\n      const message   = new TextEncoder().encode(canonical);\n\n      const valid = ed25519.verify(sigBytes, message, pubKey);\n      if (!valid) return NdpAnnounceResult.fail(\"NDP-ANNOUNCE-SIG-INVALID\", \"Ed25519 signature verification failed.\");\n      return NdpAnnounceResult.ok();\n    } catch {\n      return NdpAnnounceResult.fail(\"NDP-ANNOUNCE-SIG-INVALID\", \"Ed25519 signature verification failed.\");\n    }\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ndp/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}