@labacacia/nps-sdk 1.0.0-alpha.5 → 1.0.0-alpha.7

package/src/ncp/handshake.ts

@@ -1,95 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// Handshake — Version negotiation and encoding negotiation
-// NPS-1 §2.6
-
-/**
- * Parse a "major.minor" (optionally "major.minor.patch") version string into a
- * tuple of numeric components. Invalid parts become NaN which makes subsequent
- * comparisons return false in both directions (safe failure).
- */
-function parseVersion(v: string): number[] {
-  return v.split(".").map((p) => Number.parseInt(p, 10));
-}
-
-/**
- * Numeric component-wise comparison of two version strings.
- * Returns negative if a < b, zero if equal, positive if a > b.
- * Avoids the lexicographic pitfall where "0.9" > "0.10".
- */
-function compareVersions(a: string, b: string): number {
-  const partsA = parseVersion(a);
-  const partsB = parseVersion(b);
-  const len = Math.max(partsA.length, partsB.length);
-  for (let i = 0; i < len; i += 1) {
-    const x = partsA[i] ?? 0;
-    const y = partsB[i] ?? 0;
-    if (x !== y) return x - y;
-  }
-  return 0;
-}
-
-/**
- * Negotiate the session NPS version between client and server.
- *
- * Session version = numeric min of client.nps_version and server.nps_version
- * (component-wise — "0.9" < "0.10" < "1.0").
- * If the effective client minimum (min_version ?? nps_version) > server.nps_version,
- * the versions are incompatible.
- *
- * Spec: NPS-1 §2.6
- */
-export function negotiateVersion(
-  client: { nps_version: string; min_version?: string },
-  server: { nps_version: string },
-): { session_version: string; compatible: boolean; error_code?: string } {
-  const clientMin = client.min_version ?? client.nps_version;
-  const serverVersion = server.nps_version;
-
-  if (compareVersions(clientMin, serverVersion) > 0) {
-    return {
-      session_version: serverVersion,
-      compatible: false,
-      error_code: "NCP-VERSION-INCOMPATIBLE",
-    };
-  }
-
-  // Session version = component-wise min of client.nps_version and server.nps_version
-  const sessionVersion =
-    compareVersions(client.nps_version, serverVersion) <= 0
-      ? client.nps_version
-      : serverVersion;
-
-  return { session_version: sessionVersion, compatible: true };
-}
-
-/**
- * Negotiate the encoding between client and server preferred lists.
- *
- * Returns the first mutually supported encoding, preferring "msgpack" over "json".
- * Returns null if there is no intersection.
- */
-export function negotiateEncoding(
-  client: string[],
-  server: string[],
-): { encoding: string | null } {
-  const serverSet = new Set(server);
-
-  // Prefer msgpack over json (and over any other encoding)
-  if (client.includes("msgpack") && serverSet.has("msgpack")) {
-    return { encoding: "msgpack" };
-  }
-  if (client.includes("json") && serverSet.has("json")) {
-    return { encoding: "json" };
-  }
-
-  // Fall back to first intersection in client-preference order
-  for (const enc of client) {
-    if (serverSet.has(enc)) {
-      return { encoding: enc };
-    }
-  }
-
-  return { encoding: null };
-}

package/src/ncp/index.ts

@@ -1,13 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-export * from "./frames/anchor-frame.js";
-export * from "./frames/caps-frame.js";
-export * from "./frames/diff-frame.js";
-export * from "./frames/error-frame.js";
-export * from "./frames/hello-frame.js";
-export * from "./frames/stream-frame.js";
-export * from "./ncp-error-codes.js";
-export * from "./ncp-patch-format.js";
-export * from "./handshake.js";
-export * from "./stream-manager.js";
-export * from "./preamble.js";

package/src/ncp/ncp-error-codes.ts

@@ -1,36 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// NCP Error Codes — All v0.4 protocol error codes
-// NPS-1 §6 + §7.4
-//
-// Implementation-only codes (NCP_FRAME_PARSE_ERROR, NCP_FRAME_INCOMPLETE) cover
-// wire-layer parse failures not in spec §6. See test/ncp_test_results.md spec
-// question 2 for the proposal to register them upstream.
-
-export const NCP_ERROR_CODES = {
-  // Implementation-only codes (not in spec §6 — see test_results.md spec question 2)
-  NCP_FRAME_PARSE_ERROR: "NCP-FRAME-PARSE-ERROR",
-  NCP_FRAME_INCOMPLETE: "NCP-FRAME-INCOMPLETE",
-  // NPS-RFC-0001 — native-mode preamble
-  NCP_PREAMBLE_INVALID: "NCP-PREAMBLE-INVALID",
-  // Spec-defined codes
-  NCP_FRAME_UNKNOWN_TYPE: "NCP-FRAME-UNKNOWN-TYPE",
-  NCP_FRAME_PAYLOAD_TOO_LARGE: "NCP-FRAME-PAYLOAD-TOO-LARGE",
-  NCP_FRAME_FLAGS_INVALID: "NCP-FRAME-FLAGS-INVALID",
-  NCP_ANCHOR_NOT_FOUND: "NCP-ANCHOR-NOT-FOUND",
-  NCP_ANCHOR_SCHEMA_INVALID: "NCP-ANCHOR-SCHEMA-INVALID",
-  NCP_ANCHOR_ID_MISMATCH: "NCP-ANCHOR-ID-MISMATCH",
-  NCP_ANCHOR_STALE: "NCP-ANCHOR-STALE",
-  NCP_STREAM_SEQ_GAP: "NCP-STREAM-SEQ-GAP",
-  NCP_STREAM_NOT_FOUND: "NCP-STREAM-NOT-FOUND",
-  NCP_STREAM_LIMIT_EXCEEDED: "NCP-STREAM-LIMIT-EXCEEDED",
-  NCP_STREAM_WINDOW_OVERFLOW: "NCP-STREAM-WINDOW-OVERFLOW",
-  NCP_ENCODING_UNSUPPORTED: "NCP-ENCODING-UNSUPPORTED",
-  NCP_DIFF_FORMAT_UNSUPPORTED: "NCP-DIFF-FORMAT-UNSUPPORTED",
-  NCP_VERSION_INCOMPATIBLE: "NCP-VERSION-INCOMPATIBLE",
-  NCP_ENC_NOT_NEGOTIATED: "NCP-ENC-NOT-NEGOTIATED",
-  NCP_ENC_AUTH_FAILED: "NCP-ENC-AUTH-FAILED",
-} as const;
-
-export type NcpErrorCode = typeof NCP_ERROR_CODES[keyof typeof NCP_ERROR_CODES];

package/src/ncp/ncp-patch-format.ts

@@ -1,16 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 LabAcacia / INNO LOTUS PTY LTD
-//
-// NCP Patch Format — DiffFrame patch encoding types
-// NPS-1 §4.2
-
-export const PATCH_FORMAT = {
-  JSON_PATCH: "json_patch",
-  BINARY_BITSET: "binary_bitset",
-} as const;
-
-export type PatchFormat = typeof PATCH_FORMAT[keyof typeof PATCH_FORMAT];
-
-export function isValidPatchFormat(v: unknown): v is PatchFormat {
-  return v === PATCH_FORMAT.JSON_PATCH || v === PATCH_FORMAT.BINARY_BITSET;
-}

package/src/ncp/preamble.ts

@@ -1,79 +0,0 @@
-// 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: Uint8Array = 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 {
-  readonly errorCode  = PREAMBLE_ERROR_CODE;
-  readonly statusCode = PREAMBLE_STATUS_CODE;
-
-  constructor(reason: string) {
-    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: Uint8Array): boolean {
-  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: Uint8Array): { valid: boolean; reason: string } {
-  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: Uint8Array): void {
-  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: { write(buf: Uint8Array): void }): void {
-  writer.write(PREAMBLE_BYTES);
-}

package/src/ncp/registry.ts

@@ -1,15 +0,0 @@
-// Copyright 2026 INNO LOTUS PTY LTD
-// SPDX-License-Identifier: Apache-2.0
-
-import { FrameRegistry } from "../core/registry.js";
-import { FrameType } from "../core/frames.js";
-import { AnchorFrame, CapsFrame, DiffFrame, ErrorFrame, HelloFrame, StreamFrame } from "./frames.js";
-
-export function registerNcpFrames(registry: FrameRegistry): void {
-  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);
-}

package/src/ncp/stream-manager.ts

@@ -1,212 +0,0 @@
-// 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";
-import type { StreamFrame } from "./frames/stream-frame.js";
-
-interface ActiveStream {
-  streamId: string;
-  expectedSeq: number;
-  chunks: unknown[][];
-  completed: boolean;
-  errorCode?: string;
-}
-
-interface OutgoingStream {
-  streamId: string;
-  remainingWindow: number | undefined; // undefined = no flow control
-  paused: boolean;
-}
-
-/**
- * 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 {
-  private readonly streams = new Map<string, ActiveStream>();
-  private readonly outgoing = new Map<string, OutgoingStream>();
-  private readonly maxConcurrent: number;
-
-  constructor(options?: { maxConcurrent?: number }) {
-    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: StreamFrame): boolean {
-    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: StreamFrame): void {
-    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: string, newSize: number): void {
-    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: string): boolean {
-    return this.outgoing.get(streamId)?.paused ?? false;
-  }
-
-  /** Get reassembled data for a completed stream. */
-  getData(streamId: string): unknown[] | null {
-    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: string): string | undefined {
-    return this.streams.get(streamId)?.errorCode;
-  }
-
-  /** Number of active (non-completed) streams. */
-  get activeCount(): number {
-    let count = 0;
-    for (const s of this.streams.values()) {
-      if (!s.completed) count++;
-    }
-    return count;
-  }
-}

package/src/ndp/dns-txt.ts

@@ -1,86 +0,0 @@
-// Copyright 2026 INNO LOTUS PTY LTD
-// SPDX-License-Identifier: Apache-2.0
-
-import type { NdpResolveResult } from "./frames.js";
-
-export const DNS_TXT_DEFAULT_TTL = 300;
-
-/**
- * Extract the hostname from an NWP target URI.
- * e.g. "nwp://api.example.com/products" → "api.example.com"
- */
-export function extractHostFromTarget(target: string): string | undefined {
-  if (!target.startsWith("nwp://")) return undefined;
-  const rest     = target.slice("nwp://".length);
-  const slashIdx = rest.indexOf("/");
-  const host     = slashIdx === -1 ? rest : rest.slice(0, slashIdx);
-  return host.length > 0 ? host : undefined;
-}
-
-/**
- * Parse one TXT record (array of string chunks) into an NdpResolveResult.
- *
- * Expected format (chunks joined with a single space):
- *   v=nps1 type=<type> port=<port> nid=<nid> fp=sha256:<fingerprint>
- *
- * Rules:
- *  - `v` MUST be present and equal to "nps1"
- *  - `nid` MUST be present
- *  - `port` defaults to 17433 when absent
- *  - `fp` is mapped to certFingerprint
- */
-export function parseNpsTxtRecord(
-  parts: string[],
-  host: string,
-): NdpResolveResult | undefined {
-  const joined = parts.join(" ");
-  const kv     = new Map<string, string>();
-
-  for (const token of joined.split(/\s+/)) {
-    const eq = token.indexOf("=");
-    if (eq === -1) continue;
-    const key = token.slice(0, eq);
-    const val = token.slice(eq + 1);
-    kv.set(key, val);
-  }
-
-  if (kv.get("v") !== "nps1") return undefined;
-
-  const nid = kv.get("nid");
-  if (!nid) return undefined;
-
-  const rawPort = kv.get("port");
-  const port    = rawPort !== undefined ? Number(rawPort) : 17433;
-  const fp      = kv.get("fp");
-
-  const result: NdpResolveResult = {
-    host,
-    port,
-    ttl: DNS_TXT_DEFAULT_TTL,
-  };
-
-  if (fp !== undefined) {
-    result.certFingerprint = fp;
-  }
-
-  return result;
-}
-
-/**
- * Abstraction over DNS TXT lookups.
- * The default implementation uses Node's `dns.promises`; pass a mock in tests.
- */
-export interface DnsTxtLookup {
-  resolveTxt(hostname: string): Promise<string[][]>;
-}
-
-/**
- * System DNS TXT resolver backed by Node's built-in `dns.promises`.
- * The dynamic `import()` keeps browser bundles from failing at parse time.
- */
-export class SystemDnsTxtLookup implements DnsTxtLookup {
-  async resolveTxt(hostname: string): Promise<string[][]> {
-    const { promises: dns } = await import("node:dns");
-    return dns.resolveTxt(hostname);
-  }
-}

package/src/ndp/frames.ts

@@ -1,124 +0,0 @@
-// Copyright 2026 INNO LOTUS PTY LTD
-// SPDX-License-Identifier: Apache-2.0
-
-import { EncodingTier, FrameType } from "../core/frames.js";
-import type { NpsFrame } from "../core/codec.js";
-
-export interface NdpAddress {
-  host:     string;
-  port:     number;
-  protocol: string;
-}
-
-export interface NdpGraphNode {
-  nid:          string;
-  addresses:    readonly NdpAddress[];
-  capabilities: readonly string[];
-  nodeType?:    string;
-}
-
-export interface NdpResolveResult {
-  host:              string;
-  port:              number;
-  ttl:               number;
-  certFingerprint?:  string;
-}
-
-export class AnnounceFrame implements NpsFrame {
-  readonly frameType     = FrameType.ANNOUNCE;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly nid:          string,
-    public readonly addresses:    readonly NdpAddress[],
-    public readonly capabilities: readonly string[],
-    public readonly ttl:          number,
-    public readonly timestamp:    string,
-    public readonly signature:    string,
-    public readonly nodeType?:    string,
-  ) {}
-
-  unsignedDict(): Record<string, unknown> {
-    return {
-      nid:          this.nid,
-      addresses:    this.addresses,
-      capabilities: this.capabilities,
-      ttl:          this.ttl,
-      timestamp:    this.timestamp,
-      node_type:    this.nodeType ?? null,
-    };
-  }
-
-  toDict(): Record<string, unknown> {
-    return { ...this.unsignedDict(), signature: this.signature };
-  }
-
-  static fromDict(data: Record<string, unknown>): AnnounceFrame {
-    return new AnnounceFrame(
-      data["nid"]          as string,
-      data["addresses"]    as NdpAddress[],
-      data["capabilities"] as string[],
-      data["ttl"]          as number,
-      data["timestamp"]    as string,
-      data["signature"]    as string,
-      (data["node_type"]    as string | null) ?? undefined,
-    );
-  }
-}
-
-export class ResolveFrame implements NpsFrame {
-  readonly frameType     = FrameType.RESOLVE;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly target:        string,
-    public readonly requesterNid?: string,
-    public readonly resolved?:     NdpResolveResult,
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      target:        this.target,
-      requester_nid: this.requesterNid ?? null,
-      resolved:      this.resolved     ?? null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): ResolveFrame {
-    return new ResolveFrame(
-      data["target"]         as string,
-      (data["requester_nid"] as string | null) ?? undefined,
-      (data["resolved"]      as NdpResolveResult | null) ?? undefined,
-    );
-  }
-}
-
-export class GraphFrame implements NpsFrame {
-  readonly frameType     = FrameType.GRAPH;
-  readonly preferredTier = EncodingTier.MSGPACK;
-
-  constructor(
-    public readonly seq:         number,
-    public readonly initialSync: boolean,
-    public readonly nodes?:      readonly NdpGraphNode[],
-    public readonly patch?:      readonly Record<string, unknown>[],
-  ) {}
-
-  toDict(): Record<string, unknown> {
-    return {
-      seq:          this.seq,
-      initial_sync: this.initialSync,
-      nodes:        this.nodes ?? null,
-      patch:        this.patch ?? null,
-    };
-  }
-
-  static fromDict(data: Record<string, unknown>): GraphFrame {
-    return new GraphFrame(
-      data["seq"]          as number,
-      data["initial_sync"] as boolean,
-      (data["nodes"] as NdpGraphNode[] | null) ?? undefined,
-      (data["patch"] as Record<string, unknown>[] | null) ?? undefined,
-    );
-  }
-}

package/src/ndp/index.ts

@@ -1,8 +0,0 @@
-// 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";
-export * from "./dns-txt.js";