@labacacia/nps-sdk 1.0.0-alpha.1 → 1.0.0-alpha.13

package/dist/nwp/index.cjs

@@ -1,658 +0,0 @@
-'use strict';
-
-var msgpack = require('@msgpack/msgpack');
-
-function _interopNamespace(e) {
-  if (e && e.__esModule) return e;
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
-}
-
-var msgpack__namespace = /*#__PURE__*/_interopNamespace(msgpack);
-
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/core/exceptions.ts
-var NpsError, NpsFrameError, NpsCodecError;
-var init_exceptions = __esm({
-  "src/core/exceptions.ts"() {
-    NpsError = class extends Error {
-      constructor(message) {
-        super(message);
-        this.name = new.target.name;
-      }
-    };
-    NpsFrameError = class extends NpsError {
-    };
-    NpsCodecError = class extends NpsError {
-    };
-  }
-});
-
-// src/core/frames.ts
-var FrameFlags, DEFAULT_HEADER_SIZE, EXTENDED_HEADER_SIZE, DEFAULT_MAX_PAYLOAD, FrameHeader;
-var init_frames = __esm({
-  "src/core/frames.ts"() {
-    init_exceptions();
-    FrameFlags = {
-      NONE: 0,
-      TIER1_JSON: 0,
-      TIER2_MSGPACK: 1,
-      FINAL: 4,
-      ENCRYPTED: 8,
-      EXT: 128
-    };
-    DEFAULT_HEADER_SIZE = 4;
-    EXTENDED_HEADER_SIZE = 8;
-    DEFAULT_MAX_PAYLOAD = 65535;
-    FrameHeader = class _FrameHeader {
-      constructor(frameType, flags, payloadLength) {
-        this.frameType = frameType;
-        this.flags = flags;
-        this.payloadLength = payloadLength;
-      }
-      frameType;
-      flags;
-      payloadLength;
-      get isExtended() {
-        return (this.flags & FrameFlags.EXT) !== 0;
-      }
-      get headerSize() {
-        return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
-      }
-      get encodingTier() {
-        return this.flags & 3;
-      }
-      get isFinal() {
-        return (this.flags & 4) !== 0;
-      }
-      get isEncrypted() {
-        return (this.flags & 8) !== 0;
-      }
-      // ── Parsing ───────────────────────────────────────────────────────────────
-      static parse(buf) {
-        if (buf.length < 2) {
-          throw new NpsFrameError(
-            `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`
-          );
-        }
-        const flags = buf[1];
-        const ext = (flags & FrameFlags.EXT) !== 0;
-        if (ext) {
-          if (buf.length < EXTENDED_HEADER_SIZE) {
-            throw new NpsFrameError(
-              `Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`
-            );
-          }
-          const view2 = new DataView(buf.buffer, buf.byteOffset);
-          const payloadLength2 = view2.getUint32(4, false);
-          return new _FrameHeader(buf[0], flags, payloadLength2);
-        }
-        if (buf.length < DEFAULT_HEADER_SIZE) {
-          throw new NpsFrameError(
-            `Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`
-          );
-        }
-        const view = new DataView(buf.buffer, buf.byteOffset);
-        const payloadLength = view.getUint16(2, false);
-        return new _FrameHeader(buf[0], flags, payloadLength);
-      }
-      // ── Serialisation ─────────────────────────────────────────────────────────
-      toBytes() {
-        if (this.isExtended) {
-          const buf2 = new Uint8Array(EXTENDED_HEADER_SIZE);
-          const view2 = new DataView(buf2.buffer);
-          view2.setUint8(0, this.frameType);
-          view2.setUint8(1, this.flags);
-          view2.setUint16(2, 0, false);
-          view2.setUint32(4, this.payloadLength, false);
-          return buf2;
-        }
-        const buf = new Uint8Array(DEFAULT_HEADER_SIZE);
-        const view = new DataView(buf.buffer);
-        view.setUint8(0, this.frameType);
-        view.setUint8(1, this.flags);
-        view.setUint16(2, this.payloadLength, false);
-        return buf;
-      }
-      toString() {
-        return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, "0")}, flags=0x${this.flags.toString(16).padStart(2, "0")}, payloadLength=${this.payloadLength})`;
-      }
-    };
-  }
-});
-
-// src/ncp/frames.ts
-var frames_exports = {};
-__export(frames_exports, {
-  AnchorFrame: () => AnchorFrame,
-  CapsFrame: () => CapsFrame,
-  DiffFrame: () => DiffFrame,
-  ErrorFrame: () => ErrorFrame,
-  StreamFrame: () => StreamFrame
-});
-var AnchorFrame, DiffFrame, StreamFrame, CapsFrame, ErrorFrame;
-var init_frames2 = __esm({
-  "src/ncp/frames.ts"() {
-    init_frames();
-    AnchorFrame = class _AnchorFrame {
-      constructor(anchorId, schema, ttl = 3600) {
-        this.anchorId = anchorId;
-        this.schema = schema;
-        this.ttl = ttl;
-      }
-      anchorId;
-      schema;
-      ttl;
-      frameType = 1 /* ANCHOR */;
-      preferredTier = 1 /* MSGPACK */;
-      toDict() {
-        return {
-          anchor_id: this.anchorId,
-          schema: { fields: this.schema.fields.map((f) => ({ ...f })) },
-          ttl: this.ttl
-        };
-      }
-      static fromDict(data) {
-        const schemaRaw = data["schema"];
-        return new _AnchorFrame(
-          data["anchor_id"],
-          { fields: schemaRaw.fields },
-          data["ttl"] ?? 3600
-        );
-      }
-    };
-    DiffFrame = class _DiffFrame {
-      constructor(anchorRef, baseSeq, patch, entityId) {
-        this.anchorRef = anchorRef;
-        this.baseSeq = baseSeq;
-        this.patch = patch;
-        this.entityId = entityId;
-      }
-      anchorRef;
-      baseSeq;
-      patch;
-      entityId;
-      frameType = 2 /* DIFF */;
-      preferredTier = 1 /* MSGPACK */;
-      toDict() {
-        return {
-          anchor_ref: this.anchorRef,
-          base_seq: this.baseSeq,
-          patch: this.patch.map((p) => ({ ...p })),
-          entity_id: this.entityId ?? null
-        };
-      }
-      static fromDict(data) {
-        return new _DiffFrame(
-          data["anchor_ref"],
-          data["base_seq"],
-          data["patch"],
-          data["entity_id"] ?? void 0
-        );
-      }
-    };
-    StreamFrame = class _StreamFrame {
-      constructor(streamId, seq, isLast, data, anchorRef, windowSize) {
-        this.streamId = streamId;
-        this.seq = seq;
-        this.isLast = isLast;
-        this.data = data;
-        this.anchorRef = anchorRef;
-        this.windowSize = windowSize;
-      }
-      streamId;
-      seq;
-      isLast;
-      data;
-      anchorRef;
-      windowSize;
-      frameType = 3 /* STREAM */;
-      preferredTier = 1 /* MSGPACK */;
-      toDict() {
-        return {
-          stream_id: this.streamId,
-          seq: this.seq,
-          is_last: this.isLast,
-          data: this.data,
-          anchor_ref: this.anchorRef ?? null,
-          window_size: this.windowSize ?? null
-        };
-      }
-      static fromDict(data) {
-        return new _StreamFrame(
-          data["stream_id"],
-          data["seq"],
-          data["is_last"],
-          data["data"],
-          data["anchor_ref"] ?? void 0,
-          data["window_size"] ?? void 0
-        );
-      }
-    };
-    CapsFrame = class _CapsFrame {
-      constructor(anchorRef, count, data, nextCursor, tokenEst, cached, tokenizerUsed) {
-        this.anchorRef = anchorRef;
-        this.count = count;
-        this.data = data;
-        this.nextCursor = nextCursor;
-        this.tokenEst = tokenEst;
-        this.cached = cached;
-        this.tokenizerUsed = tokenizerUsed;
-      }
-      anchorRef;
-      count;
-      data;
-      nextCursor;
-      tokenEst;
-      cached;
-      tokenizerUsed;
-      frameType = 4 /* CAPS */;
-      preferredTier = 1 /* MSGPACK */;
-      toDict() {
-        return {
-          anchor_ref: this.anchorRef,
-          count: this.count,
-          data: this.data,
-          next_cursor: this.nextCursor ?? null,
-          token_est: this.tokenEst ?? null,
-          cached: this.cached ?? null,
-          tokenizer_used: this.tokenizerUsed ?? null
-        };
-      }
-      static fromDict(data) {
-        return new _CapsFrame(
-          data["anchor_ref"],
-          data["count"],
-          data["data"],
-          data["next_cursor"] ?? void 0,
-          data["token_est"] ?? void 0,
-          data["cached"] ?? void 0,
-          data["tokenizer_used"] ?? void 0
-        );
-      }
-    };
-    ErrorFrame = class _ErrorFrame {
-      constructor(status, error, message, details) {
-        this.status = status;
-        this.error = error;
-        this.message = message;
-        this.details = details;
-      }
-      status;
-      error;
-      message;
-      details;
-      frameType = 254 /* ERROR */;
-      preferredTier = 1 /* MSGPACK */;
-      toDict() {
-        return {
-          status: this.status,
-          error: this.error,
-          message: this.message ?? null,
-          details: this.details ?? null
-        };
-      }
-      static fromDict(data) {
-        return new _ErrorFrame(
-          data["status"],
-          data["error"],
-          data["message"] ?? void 0,
-          data["details"] ?? void 0
-        );
-      }
-    };
-  }
-});
-
-// src/nwp/frames.ts
-init_frames();
-var QueryFrame = class _QueryFrame {
-  constructor(anchorRef, filter, limit, offset, orderBy, fields, vectorSearch, depth) {
-    this.anchorRef = anchorRef;
-    this.filter = filter;
-    this.limit = limit;
-    this.offset = offset;
-    this.orderBy = orderBy;
-    this.fields = fields;
-    this.vectorSearch = vectorSearch;
-    this.depth = depth;
-  }
-  anchorRef;
-  filter;
-  limit;
-  offset;
-  orderBy;
-  fields;
-  vectorSearch;
-  depth;
-  frameType = 16 /* QUERY */;
-  preferredTier = 1 /* MSGPACK */;
-  toDict() {
-    return {
-      anchor_ref: this.anchorRef ?? null,
-      filter: this.filter ?? null,
-      limit: this.limit ?? null,
-      offset: this.offset ?? null,
-      order_by: this.orderBy ?? null,
-      fields: this.fields ?? null,
-      vector_search: this.vectorSearch ?? null,
-      depth: this.depth ?? null
-    };
-  }
-  static fromDict(data) {
-    return new _QueryFrame(
-      data["anchor_ref"] ?? void 0,
-      data["filter"] ?? void 0,
-      data["limit"] ?? void 0,
-      data["offset"] ?? void 0,
-      data["order_by"] ?? void 0,
-      data["fields"] ?? void 0,
-      data["vector_search"] ?? void 0,
-      data["depth"] ?? void 0
-    );
-  }
-};
-var ActionFrame = class _ActionFrame {
-  constructor(actionId, params, async_, idempotencyKey, timeoutMs) {
-    this.actionId = actionId;
-    this.params = params;
-    this.async_ = async_;
-    this.idempotencyKey = idempotencyKey;
-    this.timeoutMs = timeoutMs;
-  }
-  actionId;
-  params;
-  async_;
-  idempotencyKey;
-  timeoutMs;
-  frameType = 17 /* ACTION */;
-  preferredTier = 1 /* MSGPACK */;
-  toDict() {
-    return {
-      action_id: this.actionId,
-      params: this.params ?? null,
-      async: this.async_ ?? false,
-      idempotency_key: this.idempotencyKey ?? null,
-      timeout_ms: this.timeoutMs ?? null
-    };
-  }
-  static fromDict(data) {
-    return new _ActionFrame(
-      data["action_id"],
-      data["params"] ?? void 0,
-      data["async"] ?? void 0,
-      data["idempotency_key"] ?? void 0,
-      data["timeout_ms"] ?? void 0
-    );
-  }
-};
-function asyncActionResponseFromDict(data) {
-  const r = {
-    taskId: data["task_id"],
-    status: data["status"]
-  };
-  const pollUrl = data["poll_url"];
-  if (pollUrl != null) r.pollUrl = pollUrl;
-  return r;
-}
-
-// src/nwp/registry.ts
-init_frames();
-function registerNwpFrames(registry) {
-  registry.register(16 /* QUERY */, QueryFrame);
-  registry.register(17 /* ACTION */, ActionFrame);
-}
-
-// src/core/codec.ts
-init_exceptions();
-init_frames();
-var Tier1JsonCodec = class {
-  encode(frame) {
-    try {
-      const json = JSON.stringify(frame.toDict());
-      return new TextEncoder().encode(json);
-    } catch (err) {
-      throw new NpsCodecError(
-        `Tier-1 JSON encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
-      );
-    }
-  }
-  decode(frameType, payload, registry) {
-    const cls = registry.resolve(frameType);
-    try {
-      const text = new TextDecoder().decode(payload);
-      const data = JSON.parse(text);
-      return cls.fromDict(data);
-    } catch (err) {
-      throw new NpsCodecError(
-        `Tier-1 JSON decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
-      );
-    }
-  }
-};
-var Tier2MsgPackCodec = class {
-  encode(frame) {
-    try {
-      return msgpack__namespace.encode(frame.toDict());
-    } catch (err) {
-      throw new NpsCodecError(
-        `Tier-2 MsgPack encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
-      );
-    }
-  }
-  decode(frameType, payload, registry) {
-    const cls = registry.resolve(frameType);
-    try {
-      const data = msgpack__namespace.decode(payload);
-      return cls.fromDict(data);
-    } catch (err) {
-      throw new NpsCodecError(
-        `Tier-2 MsgPack decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
-      );
-    }
-  }
-};
-var NpsFrameCodec = class {
-  _registry;
-  _maxPayload;
-  _json = new Tier1JsonCodec();
-  _msgpack = new Tier2MsgPackCodec();
-  constructor(registry, options = {}) {
-    this._registry = registry;
-    this._maxPayload = options.maxPayload ?? DEFAULT_MAX_PAYLOAD;
-  }
-  // ── Encode ────────────────────────────────────────────────────────────────
-  encode(frame, options = {}) {
-    const tier = options.overrideTier ?? frame.preferredTier;
-    const tierCodec = this._selectCodec(tier);
-    let payload;
-    try {
-      payload = tierCodec.encode(frame);
-    } catch (err) {
-      if (err instanceof NpsCodecError) throw err;
-      throw new NpsCodecError(`Encode failed for 0x${frame.frameType.toString(16)}.`);
-    }
-    if (payload.length > this._maxPayload) {
-      throw new NpsCodecError(
-        `Encoded payload for 0x${frame.frameType.toString(16).padStart(2, "0")} exceeds max_frame_payload (${payload.length} bytes > ${this._maxPayload}). Use StreamFrame (0x03) for large payloads.`
-      );
-    }
-    const useExt = payload.length > DEFAULT_MAX_PAYLOAD;
-    let flags = this._buildFlags(frame, tier);
-    if (useExt) flags |= FrameFlags.EXT;
-    const header = new FrameHeader(frame.frameType, flags, payload.length);
-    const headerBytes = header.toBytes();
-    const wire = new Uint8Array(headerBytes.length + payload.length);
-    wire.set(headerBytes, 0);
-    wire.set(payload, headerBytes.length);
-    return wire;
-  }
-  // ── Decode ────────────────────────────────────────────────────────────────
-  decode(wire) {
-    const header = FrameHeader.parse(wire);
-    const payload = wire.slice(header.headerSize, header.headerSize + header.payloadLength);
-    const codec = this._selectCodec(header.encodingTier);
-    return codec.decode(header.frameType, payload, this._registry);
-  }
-  static peekHeader(wire) {
-    return FrameHeader.parse(wire);
-  }
-  // ── Private ───────────────────────────────────────────────────────────────
-  _buildFlags(frame, tier) {
-    let flags = tier === 0 /* JSON */ ? FrameFlags.TIER1_JSON : FrameFlags.TIER2_MSGPACK;
-    const isStreamFrame = "isLast" in frame;
-    const isFinal = !isStreamFrame || frame.isLast;
-    if (isFinal) flags |= FrameFlags.FINAL;
-    return flags;
-  }
-  _selectCodec(tier) {
-    if (tier === 0 /* JSON */) return this._json;
-    if (tier === 1 /* MSGPACK */) return this._msgpack;
-    throw new NpsCodecError(`Unsupported encoding tier: 0x${tier.toString(16).padStart(2, "0")}.`);
-  }
-};
-
-// src/nwp/client.ts
-init_frames();
-
-// src/core/registry.ts
-init_exceptions();
-var FrameRegistry = class {
-  _map = /* @__PURE__ */ new Map();
-  register(frameType, cls) {
-    this._map.set(frameType, cls);
-  }
-  resolve(frameType) {
-    const cls = this._map.get(frameType);
-    if (cls === void 0) {
-      throw new NpsFrameError(
-        `No frame class registered for type 0x${frameType.toString(16).padStart(2, "0")}.`
-      );
-    }
-    return cls;
-  }
-};
-
-// src/ncp/registry.ts
-init_frames();
-init_frames2();
-function registerNcpFrames(registry) {
-  registry.register(1 /* ANCHOR */, AnchorFrame);
-  registry.register(2 /* DIFF */, DiffFrame);
-  registry.register(3 /* STREAM */, StreamFrame);
-  registry.register(4 /* CAPS */, CapsFrame);
-  registry.register(254 /* ERROR */, ErrorFrame);
-}
-
-// src/nwp/client.ts
-init_frames2();
-var CONTENT_TYPE = "application/x-nps-frame";
-var NwpClient = class {
-  _baseUrl;
-  _codec;
-  _tier;
-  constructor(baseUrl, options = {}) {
-    this._baseUrl = baseUrl.replace(/\/$/, "");
-    this._tier = options.defaultTier ?? 1 /* MSGPACK */;
-    const registry = options.registry ?? (() => {
-      const r = new FrameRegistry();
-      registerNcpFrames(r);
-      registerNwpFrames(r);
-      return r;
-    })();
-    const codecOpts = options.maxPayload !== void 0 ? { maxPayload: options.maxPayload } : {};
-    this._codec = new NpsFrameCodec(registry, codecOpts);
-  }
-  async sendAnchor(frame) {
-    const wire = this._codec.encode(frame, { overrideTier: this._tier });
-    const res = await fetch(`${this._baseUrl}/anchor`, {
-      method: "POST",
-      body: wire,
-      headers: { "Content-Type": CONTENT_TYPE, "Accept": CONTENT_TYPE }
-    });
-    if (!res.ok) throw new Error(`NWP /anchor failed: HTTP ${res.status}`);
-  }
-  async query(frame) {
-    const wire = this._codec.encode(frame, { overrideTier: this._tier });
-    const res = await fetch(`${this._baseUrl}/query`, {
-      method: "POST",
-      body: wire,
-      headers: { "Content-Type": CONTENT_TYPE, "Accept": CONTENT_TYPE }
-    });
-    if (!res.ok) throw new Error(`NWP /query failed: HTTP ${res.status}`);
-    const buf = new Uint8Array(await res.arrayBuffer());
-    const result = this._codec.decode(buf);
-    if (!(result instanceof CapsFrame)) {
-      throw new TypeError(`Expected CapsFrame from /query, got ${result.constructor.name}.`);
-    }
-    return result;
-  }
-  async *stream(frame) {
-    const wire = this._codec.encode(frame, { overrideTier: this._tier });
-    const res = await fetch(`${this._baseUrl}/stream`, {
-      method: "POST",
-      body: wire,
-      headers: { "Content-Type": CONTENT_TYPE, "Accept": CONTENT_TYPE }
-    });
-    if (!res.ok) throw new Error(`NWP /stream failed: HTTP ${res.status}`);
-    if (res.body === null) return;
-    const { StreamFrame: SF } = await Promise.resolve().then(() => (init_frames2(), frames_exports));
-    for await (const chunk of res.body) {
-      const bytes = chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk);
-      if (bytes.length === 0) continue;
-      const result = this._codec.decode(bytes);
-      if (!(result instanceof SF)) {
-        throw new TypeError(`Expected StreamFrame from /stream, got ${result.constructor.name}.`);
-      }
-      yield result;
-      if (result.isLast) break;
-    }
-  }
-  async invoke(frame) {
-    const wire = this._codec.encode(frame, { overrideTier: this._tier });
-    const res = await fetch(`${this._baseUrl}/invoke`, {
-      method: "POST",
-      body: wire,
-      headers: { "Content-Type": CONTENT_TYPE, "Accept": CONTENT_TYPE }
-    });
-    if (!res.ok) throw new Error(`NWP /invoke failed: HTTP ${res.status}`);
-    if (frame.async_) {
-      return asyncActionResponseFromDict(await res.json());
-    }
-    const contentType = res.headers.get("content-type") ?? "";
-    if (contentType.includes(CONTENT_TYPE)) {
-      const buf = new Uint8Array(await res.arrayBuffer());
-      return this._codec.decode(buf);
-    }
-    return res.json();
-  }
-};
-
-exports.ActionFrame = ActionFrame;
-exports.NwpClient = NwpClient;
-exports.QueryFrame = QueryFrame;
-exports.asyncActionResponseFromDict = asyncActionResponseFromDict;
-exports.registerNwpFrames = registerNwpFrames;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map