@labacacia/nps-sdk 1.0.0-alpha.2 → 1.0.0-alpha.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.cn.md +73 -2
- package/CHANGELOG.md +82 -2
- package/README.cn.md +8 -2
- package/README.md +8 -2
- package/dist/core/anchor-cache.d.ts +0 -0
- package/dist/core/anchor-cache.d.ts.map +0 -0
- package/dist/core/anchor-cache.js +0 -0
- package/dist/core/anchor-cache.js.map +0 -0
- package/dist/core/cache.d.ts +0 -0
- package/dist/core/cache.d.ts.map +0 -0
- package/dist/core/cache.js +0 -0
- package/dist/core/cache.js.map +0 -0
- package/dist/core/canonical-json.d.ts +0 -0
- package/dist/core/canonical-json.d.ts.map +0 -0
- package/dist/core/canonical-json.js +0 -0
- package/dist/core/canonical-json.js.map +0 -0
- package/dist/core/codec.d.ts +0 -0
- package/dist/core/codec.d.ts.map +0 -0
- package/dist/core/codec.js +0 -0
- package/dist/core/codec.js.map +0 -0
- package/dist/core/codecs/index.d.ts +0 -0
- package/dist/core/codecs/index.d.ts.map +0 -0
- package/dist/core/codecs/index.js +0 -0
- package/dist/core/codecs/index.js.map +0 -0
- package/dist/core/codecs/ncp-codec.d.ts +0 -0
- package/dist/core/codecs/ncp-codec.d.ts.map +0 -0
- package/dist/core/codecs/ncp-codec.js +0 -0
- package/dist/core/codecs/ncp-codec.js.map +0 -0
- package/dist/core/codecs/tier1-json-codec.d.ts +0 -0
- package/dist/core/codecs/tier1-json-codec.d.ts.map +0 -0
- package/dist/core/codecs/tier1-json-codec.js +0 -0
- package/dist/core/codecs/tier1-json-codec.js.map +0 -0
- package/dist/core/codecs/tier2-msgpack-codec.d.ts +0 -0
- package/dist/core/codecs/tier2-msgpack-codec.d.ts.map +0 -0
- package/dist/core/codecs/tier2-msgpack-codec.js +0 -0
- package/dist/core/codecs/tier2-msgpack-codec.js.map +0 -0
- package/dist/core/crypto-provider.d.ts +0 -0
- package/dist/core/crypto-provider.d.ts.map +0 -0
- package/dist/core/crypto-provider.js +0 -0
- package/dist/core/crypto-provider.js.map +0 -0
- package/dist/core/exceptions.d.ts +0 -0
- package/dist/core/exceptions.d.ts.map +0 -0
- package/dist/core/exceptions.js +0 -0
- package/dist/core/exceptions.js.map +0 -0
- package/dist/core/frame-header.d.ts +0 -0
- package/dist/core/frame-header.d.ts.map +0 -0
- package/dist/core/frame-header.js +0 -0
- package/dist/core/frame-header.js.map +0 -0
- package/dist/core/frame-registry.d.ts +0 -0
- package/dist/core/frame-registry.d.ts.map +0 -0
- package/dist/core/frame-registry.js +0 -0
- package/dist/core/frame-registry.js.map +0 -0
- package/dist/core/frames.d.ts +0 -0
- package/dist/core/frames.d.ts.map +0 -0
- package/dist/core/frames.js +0 -0
- package/dist/core/frames.js.map +0 -0
- package/dist/core/index.d.ts +0 -0
- package/dist/core/index.d.ts.map +0 -0
- package/dist/core/index.js +0 -0
- package/dist/core/index.js.map +0 -0
- package/dist/core/registry.d.ts +0 -0
- package/dist/core/registry.d.ts.map +0 -0
- package/dist/core/registry.js +0 -0
- package/dist/core/registry.js.map +0 -0
- package/dist/core/status-codes.d.ts +0 -0
- package/dist/core/status-codes.d.ts.map +0 -0
- package/dist/core/status-codes.js +0 -0
- package/dist/core/status-codes.js.map +0 -0
- package/dist/index.d.ts +0 -0
- package/dist/index.d.ts.map +0 -0
- package/dist/index.js +0 -0
- package/dist/index.js.map +0 -0
- package/dist/ncp/frames/anchor-frame.d.ts +0 -0
- package/dist/ncp/frames/anchor-frame.d.ts.map +0 -0
- package/dist/ncp/frames/anchor-frame.js +0 -0
- package/dist/ncp/frames/anchor-frame.js.map +0 -0
- package/dist/ncp/frames/caps-frame.d.ts +0 -0
- package/dist/ncp/frames/caps-frame.d.ts.map +0 -0
- package/dist/ncp/frames/caps-frame.js +0 -0
- package/dist/ncp/frames/caps-frame.js.map +0 -0
- package/dist/ncp/frames/diff-frame.d.ts +0 -0
- package/dist/ncp/frames/diff-frame.d.ts.map +0 -0
- package/dist/ncp/frames/diff-frame.js +0 -0
- package/dist/ncp/frames/diff-frame.js.map +0 -0
- package/dist/ncp/frames/error-frame.d.ts +0 -0
- package/dist/ncp/frames/error-frame.d.ts.map +0 -0
- package/dist/ncp/frames/error-frame.js +0 -0
- package/dist/ncp/frames/error-frame.js.map +0 -0
- package/dist/ncp/frames/hello-frame.d.ts +0 -0
- package/dist/ncp/frames/hello-frame.d.ts.map +0 -0
- package/dist/ncp/frames/hello-frame.js +0 -0
- package/dist/ncp/frames/hello-frame.js.map +0 -0
- package/dist/ncp/frames/stream-frame.d.ts +0 -0
- package/dist/ncp/frames/stream-frame.d.ts.map +0 -0
- package/dist/ncp/frames/stream-frame.js +0 -0
- package/dist/ncp/frames/stream-frame.js.map +0 -0
- package/dist/ncp/frames.d.ts +0 -0
- package/dist/ncp/frames.d.ts.map +0 -0
- package/dist/ncp/frames.js +0 -0
- package/dist/ncp/frames.js.map +0 -0
- package/dist/ncp/handshake.d.ts +0 -0
- package/dist/ncp/handshake.d.ts.map +0 -0
- package/dist/ncp/handshake.js +0 -0
- package/dist/ncp/handshake.js.map +0 -0
- package/dist/ncp/index.d.ts +1 -0
- package/dist/ncp/index.d.ts.map +1 -1
- package/dist/ncp/index.js +1 -0
- package/dist/ncp/index.js.map +1 -1
- package/dist/ncp/ncp-error-codes.d.ts +1 -0
- package/dist/ncp/ncp-error-codes.d.ts.map +1 -1
- package/dist/ncp/ncp-error-codes.js +2 -0
- package/dist/ncp/ncp-error-codes.js.map +1 -1
- package/dist/ncp/ncp-patch-format.d.ts +0 -0
- package/dist/ncp/ncp-patch-format.d.ts.map +0 -0
- package/dist/ncp/ncp-patch-format.js +0 -0
- package/dist/ncp/ncp-patch-format.js.map +0 -0
- package/dist/ncp/preamble.d.ts +47 -0
- package/dist/ncp/preamble.d.ts.map +1 -0
- package/dist/ncp/preamble.js +74 -0
- package/dist/ncp/preamble.js.map +1 -0
- package/dist/ncp/registry.d.ts +0 -0
- package/dist/ncp/registry.d.ts.map +0 -0
- package/dist/ncp/registry.js +0 -0
- package/dist/ncp/registry.js.map +0 -0
- package/dist/ncp/stream-manager.d.ts +0 -0
- package/dist/ncp/stream-manager.d.ts.map +0 -0
- package/dist/ncp/stream-manager.js +0 -0
- package/dist/ncp/stream-manager.js.map +0 -0
- package/dist/ndp/frames.d.ts +0 -0
- package/dist/ndp/frames.d.ts.map +0 -0
- package/dist/ndp/frames.js +0 -0
- package/dist/ndp/frames.js.map +0 -0
- package/dist/ndp/index.d.ts +0 -0
- package/dist/ndp/index.d.ts.map +0 -0
- package/dist/ndp/index.js +0 -0
- package/dist/ndp/index.js.map +0 -0
- package/dist/ndp/ndp-registry.d.ts +0 -0
- package/dist/ndp/ndp-registry.d.ts.map +0 -0
- package/dist/ndp/ndp-registry.js +0 -0
- package/dist/ndp/ndp-registry.js.map +0 -0
- package/dist/ndp/registry.d.ts +0 -0
- package/dist/ndp/registry.d.ts.map +0 -0
- package/dist/ndp/registry.js +0 -0
- package/dist/ndp/registry.js.map +0 -0
- package/dist/ndp/validator.d.ts +0 -0
- package/dist/ndp/validator.d.ts.map +0 -0
- package/dist/ndp/validator.js +0 -0
- package/dist/ndp/validator.js.map +0 -0
- package/dist/nip/acme/client.d.ts +31 -0
- package/dist/nip/acme/client.d.ts.map +1 -0
- package/dist/nip/acme/client.js +136 -0
- package/dist/nip/acme/client.js.map +1 -0
- package/dist/nip/acme/index.d.ts +6 -0
- package/dist/nip/acme/index.d.ts.map +1 -0
- package/dist/nip/acme/index.js +8 -0
- package/dist/nip/acme/index.js.map +1 -0
- package/dist/nip/acme/jws.d.ts +31 -0
- package/dist/nip/acme/jws.d.ts.map +1 -0
- package/dist/nip/acme/jws.js +76 -0
- package/dist/nip/acme/jws.js.map +1 -0
- package/dist/nip/acme/messages.d.ts +71 -0
- package/dist/nip/acme/messages.d.ts.map +1 -0
- package/dist/nip/acme/messages.js +4 -0
- package/dist/nip/acme/messages.js.map +1 -0
- package/dist/nip/acme/server.d.ts +41 -0
- package/dist/nip/acme/server.d.ts.map +1 -0
- package/dist/nip/acme/server.js +458 -0
- package/dist/nip/acme/server.js.map +1 -0
- package/dist/nip/acme/wire.d.ts +19 -0
- package/dist/nip/acme/wire.d.ts.map +1 -0
- package/dist/nip/acme/wire.js +21 -0
- package/dist/nip/acme/wire.js.map +1 -0
- package/dist/nip/assurance-level.d.ts +14 -0
- package/dist/nip/assurance-level.d.ts.map +1 -0
- package/dist/nip/assurance-level.js +33 -0
- package/dist/nip/assurance-level.js.map +1 -0
- package/dist/nip/cert-format.d.ts +5 -0
- package/dist/nip/cert-format.d.ts.map +1 -0
- package/dist/nip/cert-format.js +6 -0
- package/dist/nip/cert-format.js.map +1 -0
- package/dist/nip/error-codes.d.ts +23 -0
- package/dist/nip/error-codes.d.ts.map +1 -0
- package/dist/nip/error-codes.js +30 -0
- package/dist/nip/error-codes.js.map +1 -0
- package/dist/nip/frames.d.ts +10 -1
- package/dist/nip/frames.d.ts.map +1 -1
- package/dist/nip/frames.js +29 -4
- package/dist/nip/frames.js.map +1 -1
- package/dist/nip/identity.d.ts +0 -0
- package/dist/nip/identity.d.ts.map +0 -0
- package/dist/nip/identity.js +0 -0
- package/dist/nip/identity.js.map +0 -0
- package/dist/nip/index.d.ts +6 -0
- package/dist/nip/index.d.ts.map +1 -1
- package/dist/nip/index.js +7 -0
- package/dist/nip/index.js.map +1 -1
- package/dist/nip/registry.d.ts +0 -0
- package/dist/nip/registry.d.ts.map +0 -0
- package/dist/nip/registry.js +0 -0
- package/dist/nip/registry.js.map +0 -0
- package/dist/nip/verifier.d.ts +23 -0
- package/dist/nip/verifier.d.ts.map +1 -0
- package/dist/nip/verifier.js +90 -0
- package/dist/nip/verifier.js.map +1 -0
- package/dist/nip/x509/builder.d.ts +35 -0
- package/dist/nip/x509/builder.d.ts.map +1 -0
- package/dist/nip/x509/builder.js +59 -0
- package/dist/nip/x509/builder.js.map +1 -0
- package/dist/nip/x509/index.d.ts +4 -0
- package/dist/nip/x509/index.d.ts.map +1 -0
- package/dist/nip/x509/index.js +6 -0
- package/dist/nip/x509/index.js.map +1 -0
- package/dist/nip/x509/oids.d.ts +17 -0
- package/dist/nip/x509/oids.d.ts.map +1 -0
- package/dist/nip/x509/oids.js +23 -0
- package/dist/nip/x509/oids.js.map +1 -0
- package/dist/nip/x509/verifier.d.ts +26 -0
- package/dist/nip/x509/verifier.d.ts.map +1 -0
- package/dist/nip/x509/verifier.js +171 -0
- package/dist/nip/x509/verifier.js.map +1 -0
- package/dist/nop/client.d.ts +0 -0
- package/dist/nop/client.d.ts.map +0 -0
- package/dist/nop/client.js +0 -0
- package/dist/nop/client.js.map +0 -0
- package/dist/nop/frames.d.ts +0 -0
- package/dist/nop/frames.d.ts.map +0 -0
- package/dist/nop/frames.js +0 -0
- package/dist/nop/frames.js.map +0 -0
- package/dist/nop/index.d.ts +0 -0
- package/dist/nop/index.d.ts.map +0 -0
- package/dist/nop/index.js +0 -0
- package/dist/nop/index.js.map +0 -0
- package/dist/nop/models.d.ts +0 -0
- package/dist/nop/models.d.ts.map +0 -0
- package/dist/nop/models.js +0 -0
- package/dist/nop/models.js.map +0 -0
- package/dist/nop/nop-types.d.ts +0 -0
- package/dist/nop/nop-types.d.ts.map +0 -0
- package/dist/nop/nop-types.js +0 -0
- package/dist/nop/nop-types.js.map +0 -0
- package/dist/nop/registry.d.ts +0 -0
- package/dist/nop/registry.d.ts.map +0 -0
- package/dist/nop/registry.js +0 -0
- package/dist/nop/registry.js.map +0 -0
- package/dist/nwp/client.d.ts +0 -0
- package/dist/nwp/client.d.ts.map +0 -0
- package/dist/nwp/client.js +0 -0
- package/dist/nwp/client.js.map +0 -0
- package/dist/nwp/frames.d.ts +0 -0
- package/dist/nwp/frames.d.ts.map +0 -0
- package/dist/nwp/frames.js +0 -0
- package/dist/nwp/frames.js.map +0 -0
- package/dist/nwp/index.d.ts +0 -0
- package/dist/nwp/index.d.ts.map +0 -0
- package/dist/nwp/index.js +0 -0
- package/dist/nwp/index.js.map +0 -0
- package/dist/nwp/registry.d.ts +0 -0
- package/dist/nwp/registry.d.ts.map +0 -0
- package/dist/nwp/registry.js +0 -0
- package/dist/nwp/registry.js.map +0 -0
- package/dist/setup.d.ts +0 -0
- package/dist/setup.d.ts.map +0 -0
- package/dist/setup.js +0 -0
- package/dist/setup.js.map +0 -0
- package/package.json +2 -1
- package/src/index.ts +0 -0
- package/src/ncp/index.ts +1 -0
- package/src/ncp/ncp-error-codes.ts +2 -0
- package/src/ncp/preamble.ts +79 -0
- package/src/nip/acme/client.ts +185 -0
- package/src/nip/acme/index.ts +8 -0
- package/src/nip/acme/jws.ts +109 -0
- package/src/nip/acme/messages.ts +85 -0
- package/src/nip/acme/server.ts +480 -0
- package/src/nip/acme/wire.ts +24 -0
- package/src/nip/assurance-level.ts +35 -0
- package/src/nip/cert-format.ts +9 -0
- package/src/nip/error-codes.ts +36 -0
- package/src/nip/frames.ts +35 -3
- package/src/nip/index.ts +8 -0
- package/src/nip/verifier.ts +122 -0
- package/src/nip/x509/builder.ts +91 -0
- package/src/nip/x509/index.ts +6 -0
- package/src/nip/x509/oids.ts +28 -0
- package/src/nip/x509/verifier.ts +214 -0
- package/tests/_rfc0002-keys.ts +57 -0
- package/tests/ncp/preamble.test.ts +93 -0
- package/tests/nip-acme-agent01.test.ts +192 -0
- package/tests/nip-x509.test.ts +280 -0
- package/.npmrc.publish +0 -1
- package/dist/codec-CmHeovTV.d.cts +0 -120
- package/dist/codec-CmHeovTV.d.ts +0 -120
- package/dist/core/index.cjs +0 -371
- package/dist/core/index.cjs.map +0 -1
- package/dist/core/index.d.cts +0 -41
- package/dist/frames-B3qLdl_g.d.cts +0 -77
- package/dist/frames-Ff7-ZPUl.d.ts +0 -77
- package/dist/index.cjs +0 -1556
- package/dist/index.cjs.map +0 -1
- package/dist/index.d.cts +0 -21
- package/dist/ncp/index.cjs +0 -188
- package/dist/ncp/index.cjs.map +0 -1
- package/dist/ncp/index.d.cts +0 -6
- package/dist/ndp/index.cjs +0 -252
- package/dist/ndp/index.cjs.map +0 -1
- package/dist/ndp/index.d.cts +0 -86
- package/dist/nip/index.cjs +0 -214
- package/dist/nip/index.cjs.map +0 -1
- package/dist/nip/index.d.cts +0 -65
- package/dist/nop/index.cjs +0 -762
- package/dist/nop/index.cjs.map +0 -1
- package/dist/nop/index.d.cts +0 -155
- package/dist/nwp/index.cjs +0 -658
- package/dist/nwp/index.cjs.map +0 -1
- package/dist/nwp/index.d.cts +0 -65
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
|
|
2
|
-
declare enum FrameType {
|
|
3
|
-
ANCHOR = 1,
|
|
4
|
-
DIFF = 2,
|
|
5
|
-
STREAM = 3,
|
|
6
|
-
CAPS = 4,
|
|
7
|
-
ALIGN = 5,// deprecated — use AlignStream (0x43)
|
|
8
|
-
QUERY = 16,
|
|
9
|
-
ACTION = 17,
|
|
10
|
-
IDENT = 32,
|
|
11
|
-
TRUST = 33,
|
|
12
|
-
REVOKE = 34,
|
|
13
|
-
ANNOUNCE = 48,
|
|
14
|
-
RESOLVE = 49,
|
|
15
|
-
GRAPH = 50,
|
|
16
|
-
TASK = 64,
|
|
17
|
-
DELEGATE = 65,
|
|
18
|
-
SYNC = 66,
|
|
19
|
-
ALIGN_STREAM = 67,
|
|
20
|
-
ERROR = 254
|
|
21
|
-
}
|
|
22
|
-
/**
|
|
23
|
-
* Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
|
|
24
|
-
* 0x00 = Tier-1 JSON — human-readable; development / compatibility.
|
|
25
|
-
* 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
|
|
26
|
-
*/
|
|
27
|
-
declare enum EncodingTier {
|
|
28
|
-
JSON = 0,
|
|
29
|
-
MSGPACK = 1
|
|
30
|
-
}
|
|
31
|
-
/**
|
|
32
|
-
* Flags byte in the NPS frame header (NPS-1 §3.2).
|
|
33
|
-
* Bit layout (LSB = bit 0):
|
|
34
|
-
* Bits 0–1 (T0,T1) : Encoding tier
|
|
35
|
-
* Bit 2 (FINAL) : Last chunk of a StreamFrame; non-stream frames MUST set this
|
|
36
|
-
* Bit 3 (ENC) : Payload encrypted
|
|
37
|
-
* Bits 4–6 (RSV) : Reserved — sender MUST write 0
|
|
38
|
-
* Bit 7 (EXT) : Extended 8-byte header
|
|
39
|
-
*/
|
|
40
|
-
declare const FrameFlags: {
|
|
41
|
-
readonly NONE: 0;
|
|
42
|
-
readonly TIER1_JSON: 0;
|
|
43
|
-
readonly TIER2_MSGPACK: 1;
|
|
44
|
-
readonly FINAL: 4;
|
|
45
|
-
readonly ENCRYPTED: 8;
|
|
46
|
-
readonly EXT: 128;
|
|
47
|
-
};
|
|
48
|
-
declare const DEFAULT_HEADER_SIZE = 4;
|
|
49
|
-
declare const EXTENDED_HEADER_SIZE = 8;
|
|
50
|
-
declare const DEFAULT_MAX_PAYLOAD = 65535;
|
|
51
|
-
declare const EXTENDED_MAX_PAYLOAD = 4294967295;
|
|
52
|
-
/**
|
|
53
|
-
* NPS frame header, present at the start of every wire message (NPS-1 §3.1).
|
|
54
|
-
*
|
|
55
|
-
* Default (4 bytes, EXT=0):
|
|
56
|
-
* Byte 0 : FrameType
|
|
57
|
-
* Byte 1 : Flags
|
|
58
|
-
* Byte 2–3 : PayloadLength (big-endian uint16)
|
|
59
|
-
*
|
|
60
|
-
* Extended (8 bytes, EXT=1):
|
|
61
|
-
* Byte 0 : FrameType
|
|
62
|
-
* Byte 1 : Flags (bit 7 = 1)
|
|
63
|
-
* Byte 2–3 : Reserved (must be 0)
|
|
64
|
-
* Byte 4–7 : PayloadLength (big-endian uint32)
|
|
65
|
-
*/
|
|
66
|
-
declare class FrameHeader {
|
|
67
|
-
readonly frameType: FrameType;
|
|
68
|
-
readonly flags: number;
|
|
69
|
-
readonly payloadLength: number;
|
|
70
|
-
constructor(frameType: FrameType, flags: number, payloadLength: number);
|
|
71
|
-
get isExtended(): boolean;
|
|
72
|
-
get headerSize(): number;
|
|
73
|
-
get encodingTier(): EncodingTier;
|
|
74
|
-
get isFinal(): boolean;
|
|
75
|
-
get isEncrypted(): boolean;
|
|
76
|
-
static parse(buf: Uint8Array): FrameHeader;
|
|
77
|
-
toBytes(): Uint8Array;
|
|
78
|
-
toString(): string;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
interface FrameClass {
|
|
82
|
-
fromDict(data: Record<string, unknown>): NpsFrame;
|
|
83
|
-
}
|
|
84
|
-
declare class FrameRegistry {
|
|
85
|
-
private readonly _map;
|
|
86
|
-
register(frameType: FrameType, cls: FrameClass): void;
|
|
87
|
-
resolve(frameType: FrameType): FrameClass;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
interface NpsFrame {
|
|
91
|
-
readonly frameType: FrameType;
|
|
92
|
-
readonly preferredTier: EncodingTier;
|
|
93
|
-
toDict(): Record<string, unknown>;
|
|
94
|
-
}
|
|
95
|
-
declare class Tier1JsonCodec {
|
|
96
|
-
encode(frame: NpsFrame): Uint8Array;
|
|
97
|
-
decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
|
|
98
|
-
}
|
|
99
|
-
declare class Tier2MsgPackCodec {
|
|
100
|
-
encode(frame: NpsFrame): Uint8Array;
|
|
101
|
-
decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
|
|
102
|
-
}
|
|
103
|
-
declare class NpsFrameCodec {
|
|
104
|
-
private readonly _registry;
|
|
105
|
-
private readonly _maxPayload;
|
|
106
|
-
private readonly _json;
|
|
107
|
-
private readonly _msgpack;
|
|
108
|
-
constructor(registry: FrameRegistry, options?: {
|
|
109
|
-
maxPayload?: number;
|
|
110
|
-
});
|
|
111
|
-
encode(frame: NpsFrame, options?: {
|
|
112
|
-
overrideTier?: EncodingTier;
|
|
113
|
-
}): Uint8Array;
|
|
114
|
-
decode(wire: Uint8Array): NpsFrame;
|
|
115
|
-
static peekHeader(wire: Uint8Array): FrameHeader;
|
|
116
|
-
private _buildFlags;
|
|
117
|
-
private _selectCodec;
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export { DEFAULT_HEADER_SIZE as D, EXTENDED_HEADER_SIZE as E, FrameRegistry as F, type NpsFrame as N, Tier1JsonCodec as T, DEFAULT_MAX_PAYLOAD as a, EXTENDED_MAX_PAYLOAD as b, EncodingTier as c, type FrameClass as d, FrameFlags as e, FrameHeader as f, FrameType as g, NpsFrameCodec as h, Tier2MsgPackCodec as i };
|
package/dist/codec-CmHeovTV.d.ts
DELETED
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */
|
|
2
|
-
declare enum FrameType {
|
|
3
|
-
ANCHOR = 1,
|
|
4
|
-
DIFF = 2,
|
|
5
|
-
STREAM = 3,
|
|
6
|
-
CAPS = 4,
|
|
7
|
-
ALIGN = 5,// deprecated — use AlignStream (0x43)
|
|
8
|
-
QUERY = 16,
|
|
9
|
-
ACTION = 17,
|
|
10
|
-
IDENT = 32,
|
|
11
|
-
TRUST = 33,
|
|
12
|
-
REVOKE = 34,
|
|
13
|
-
ANNOUNCE = 48,
|
|
14
|
-
RESOLVE = 49,
|
|
15
|
-
GRAPH = 50,
|
|
16
|
-
TASK = 64,
|
|
17
|
-
DELEGATE = 65,
|
|
18
|
-
SYNC = 66,
|
|
19
|
-
ALIGN_STREAM = 67,
|
|
20
|
-
ERROR = 254
|
|
21
|
-
}
|
|
22
|
-
/**
|
|
23
|
-
* Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).
|
|
24
|
-
* 0x00 = Tier-1 JSON — human-readable; development / compatibility.
|
|
25
|
-
* 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.
|
|
26
|
-
*/
|
|
27
|
-
declare enum EncodingTier {
|
|
28
|
-
JSON = 0,
|
|
29
|
-
MSGPACK = 1
|
|
30
|
-
}
|
|
31
|
-
/**
|
|
32
|
-
* Flags byte in the NPS frame header (NPS-1 §3.2).
|
|
33
|
-
* Bit layout (LSB = bit 0):
|
|
34
|
-
* Bits 0–1 (T0,T1) : Encoding tier
|
|
35
|
-
* Bit 2 (FINAL) : Last chunk of a StreamFrame; non-stream frames MUST set this
|
|
36
|
-
* Bit 3 (ENC) : Payload encrypted
|
|
37
|
-
* Bits 4–6 (RSV) : Reserved — sender MUST write 0
|
|
38
|
-
* Bit 7 (EXT) : Extended 8-byte header
|
|
39
|
-
*/
|
|
40
|
-
declare const FrameFlags: {
|
|
41
|
-
readonly NONE: 0;
|
|
42
|
-
readonly TIER1_JSON: 0;
|
|
43
|
-
readonly TIER2_MSGPACK: 1;
|
|
44
|
-
readonly FINAL: 4;
|
|
45
|
-
readonly ENCRYPTED: 8;
|
|
46
|
-
readonly EXT: 128;
|
|
47
|
-
};
|
|
48
|
-
declare const DEFAULT_HEADER_SIZE = 4;
|
|
49
|
-
declare const EXTENDED_HEADER_SIZE = 8;
|
|
50
|
-
declare const DEFAULT_MAX_PAYLOAD = 65535;
|
|
51
|
-
declare const EXTENDED_MAX_PAYLOAD = 4294967295;
|
|
52
|
-
/**
|
|
53
|
-
* NPS frame header, present at the start of every wire message (NPS-1 §3.1).
|
|
54
|
-
*
|
|
55
|
-
* Default (4 bytes, EXT=0):
|
|
56
|
-
* Byte 0 : FrameType
|
|
57
|
-
* Byte 1 : Flags
|
|
58
|
-
* Byte 2–3 : PayloadLength (big-endian uint16)
|
|
59
|
-
*
|
|
60
|
-
* Extended (8 bytes, EXT=1):
|
|
61
|
-
* Byte 0 : FrameType
|
|
62
|
-
* Byte 1 : Flags (bit 7 = 1)
|
|
63
|
-
* Byte 2–3 : Reserved (must be 0)
|
|
64
|
-
* Byte 4–7 : PayloadLength (big-endian uint32)
|
|
65
|
-
*/
|
|
66
|
-
declare class FrameHeader {
|
|
67
|
-
readonly frameType: FrameType;
|
|
68
|
-
readonly flags: number;
|
|
69
|
-
readonly payloadLength: number;
|
|
70
|
-
constructor(frameType: FrameType, flags: number, payloadLength: number);
|
|
71
|
-
get isExtended(): boolean;
|
|
72
|
-
get headerSize(): number;
|
|
73
|
-
get encodingTier(): EncodingTier;
|
|
74
|
-
get isFinal(): boolean;
|
|
75
|
-
get isEncrypted(): boolean;
|
|
76
|
-
static parse(buf: Uint8Array): FrameHeader;
|
|
77
|
-
toBytes(): Uint8Array;
|
|
78
|
-
toString(): string;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
interface FrameClass {
|
|
82
|
-
fromDict(data: Record<string, unknown>): NpsFrame;
|
|
83
|
-
}
|
|
84
|
-
declare class FrameRegistry {
|
|
85
|
-
private readonly _map;
|
|
86
|
-
register(frameType: FrameType, cls: FrameClass): void;
|
|
87
|
-
resolve(frameType: FrameType): FrameClass;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
interface NpsFrame {
|
|
91
|
-
readonly frameType: FrameType;
|
|
92
|
-
readonly preferredTier: EncodingTier;
|
|
93
|
-
toDict(): Record<string, unknown>;
|
|
94
|
-
}
|
|
95
|
-
declare class Tier1JsonCodec {
|
|
96
|
-
encode(frame: NpsFrame): Uint8Array;
|
|
97
|
-
decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
|
|
98
|
-
}
|
|
99
|
-
declare class Tier2MsgPackCodec {
|
|
100
|
-
encode(frame: NpsFrame): Uint8Array;
|
|
101
|
-
decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame;
|
|
102
|
-
}
|
|
103
|
-
declare class NpsFrameCodec {
|
|
104
|
-
private readonly _registry;
|
|
105
|
-
private readonly _maxPayload;
|
|
106
|
-
private readonly _json;
|
|
107
|
-
private readonly _msgpack;
|
|
108
|
-
constructor(registry: FrameRegistry, options?: {
|
|
109
|
-
maxPayload?: number;
|
|
110
|
-
});
|
|
111
|
-
encode(frame: NpsFrame, options?: {
|
|
112
|
-
overrideTier?: EncodingTier;
|
|
113
|
-
}): Uint8Array;
|
|
114
|
-
decode(wire: Uint8Array): NpsFrame;
|
|
115
|
-
static peekHeader(wire: Uint8Array): FrameHeader;
|
|
116
|
-
private _buildFlags;
|
|
117
|
-
private _selectCodec;
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export { DEFAULT_HEADER_SIZE as D, EXTENDED_HEADER_SIZE as E, FrameRegistry as F, type NpsFrame as N, Tier1JsonCodec as T, DEFAULT_MAX_PAYLOAD as a, EXTENDED_MAX_PAYLOAD as b, EncodingTier as c, type FrameClass as d, FrameFlags as e, FrameHeader as f, FrameType as g, NpsFrameCodec as h, Tier2MsgPackCodec as i };
|
package/dist/core/index.cjs
DELETED
|
@@ -1,371 +0,0 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
|
|
3
|
-
var msgpack = require('@msgpack/msgpack');
|
|
4
|
-
var crypto = require('crypto');
|
|
5
|
-
|
|
6
|
-
function _interopNamespace(e) {
|
|
7
|
-
if (e && e.__esModule) return e;
|
|
8
|
-
var n = Object.create(null);
|
|
9
|
-
if (e) {
|
|
10
|
-
Object.keys(e).forEach(function (k) {
|
|
11
|
-
if (k !== 'default') {
|
|
12
|
-
var d = Object.getOwnPropertyDescriptor(e, k);
|
|
13
|
-
Object.defineProperty(n, k, d.get ? d : {
|
|
14
|
-
enumerable: true,
|
|
15
|
-
get: function () { return e[k]; }
|
|
16
|
-
});
|
|
17
|
-
}
|
|
18
|
-
});
|
|
19
|
-
}
|
|
20
|
-
n.default = e;
|
|
21
|
-
return Object.freeze(n);
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
var msgpack__namespace = /*#__PURE__*/_interopNamespace(msgpack);
|
|
25
|
-
|
|
26
|
-
// src/core/exceptions.ts
|
|
27
|
-
var NpsError = class extends Error {
|
|
28
|
-
constructor(message) {
|
|
29
|
-
super(message);
|
|
30
|
-
this.name = new.target.name;
|
|
31
|
-
}
|
|
32
|
-
};
|
|
33
|
-
var NpsFrameError = class extends NpsError {
|
|
34
|
-
};
|
|
35
|
-
var NpsCodecError = class extends NpsError {
|
|
36
|
-
};
|
|
37
|
-
var NpsAnchorNotFoundError = class extends NpsError {
|
|
38
|
-
constructor(anchorId) {
|
|
39
|
-
super(`AnchorFrame not found in cache: ${anchorId}`);
|
|
40
|
-
this.anchorId = anchorId;
|
|
41
|
-
}
|
|
42
|
-
anchorId;
|
|
43
|
-
};
|
|
44
|
-
var NpsAnchorPoisonError = class extends NpsError {
|
|
45
|
-
constructor(anchorId) {
|
|
46
|
-
super(
|
|
47
|
-
`Anchor poisoning detected: anchor_id ${anchorId} already exists with a different schema.`
|
|
48
|
-
);
|
|
49
|
-
this.anchorId = anchorId;
|
|
50
|
-
}
|
|
51
|
-
anchorId;
|
|
52
|
-
};
|
|
53
|
-
|
|
54
|
-
// src/core/frames.ts
|
|
55
|
-
var FrameType = /* @__PURE__ */ ((FrameType3) => {
|
|
56
|
-
FrameType3[FrameType3["ANCHOR"] = 1] = "ANCHOR";
|
|
57
|
-
FrameType3[FrameType3["DIFF"] = 2] = "DIFF";
|
|
58
|
-
FrameType3[FrameType3["STREAM"] = 3] = "STREAM";
|
|
59
|
-
FrameType3[FrameType3["CAPS"] = 4] = "CAPS";
|
|
60
|
-
FrameType3[FrameType3["ALIGN"] = 5] = "ALIGN";
|
|
61
|
-
FrameType3[FrameType3["QUERY"] = 16] = "QUERY";
|
|
62
|
-
FrameType3[FrameType3["ACTION"] = 17] = "ACTION";
|
|
63
|
-
FrameType3[FrameType3["IDENT"] = 32] = "IDENT";
|
|
64
|
-
FrameType3[FrameType3["TRUST"] = 33] = "TRUST";
|
|
65
|
-
FrameType3[FrameType3["REVOKE"] = 34] = "REVOKE";
|
|
66
|
-
FrameType3[FrameType3["ANNOUNCE"] = 48] = "ANNOUNCE";
|
|
67
|
-
FrameType3[FrameType3["RESOLVE"] = 49] = "RESOLVE";
|
|
68
|
-
FrameType3[FrameType3["GRAPH"] = 50] = "GRAPH";
|
|
69
|
-
FrameType3[FrameType3["TASK"] = 64] = "TASK";
|
|
70
|
-
FrameType3[FrameType3["DELEGATE"] = 65] = "DELEGATE";
|
|
71
|
-
FrameType3[FrameType3["SYNC"] = 66] = "SYNC";
|
|
72
|
-
FrameType3[FrameType3["ALIGN_STREAM"] = 67] = "ALIGN_STREAM";
|
|
73
|
-
FrameType3[FrameType3["ERROR"] = 254] = "ERROR";
|
|
74
|
-
return FrameType3;
|
|
75
|
-
})(FrameType || {});
|
|
76
|
-
var EncodingTier = /* @__PURE__ */ ((EncodingTier2) => {
|
|
77
|
-
EncodingTier2[EncodingTier2["JSON"] = 0] = "JSON";
|
|
78
|
-
EncodingTier2[EncodingTier2["MSGPACK"] = 1] = "MSGPACK";
|
|
79
|
-
return EncodingTier2;
|
|
80
|
-
})(EncodingTier || {});
|
|
81
|
-
var FrameFlags = {
|
|
82
|
-
NONE: 0,
|
|
83
|
-
TIER1_JSON: 0,
|
|
84
|
-
TIER2_MSGPACK: 1,
|
|
85
|
-
FINAL: 4,
|
|
86
|
-
ENCRYPTED: 8,
|
|
87
|
-
EXT: 128
|
|
88
|
-
};
|
|
89
|
-
var DEFAULT_HEADER_SIZE = 4;
|
|
90
|
-
var EXTENDED_HEADER_SIZE = 8;
|
|
91
|
-
var DEFAULT_MAX_PAYLOAD = 65535;
|
|
92
|
-
var EXTENDED_MAX_PAYLOAD = 4294967295;
|
|
93
|
-
var FrameHeader = class _FrameHeader {
|
|
94
|
-
constructor(frameType, flags, payloadLength) {
|
|
95
|
-
this.frameType = frameType;
|
|
96
|
-
this.flags = flags;
|
|
97
|
-
this.payloadLength = payloadLength;
|
|
98
|
-
}
|
|
99
|
-
frameType;
|
|
100
|
-
flags;
|
|
101
|
-
payloadLength;
|
|
102
|
-
get isExtended() {
|
|
103
|
-
return (this.flags & FrameFlags.EXT) !== 0;
|
|
104
|
-
}
|
|
105
|
-
get headerSize() {
|
|
106
|
-
return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;
|
|
107
|
-
}
|
|
108
|
-
get encodingTier() {
|
|
109
|
-
return this.flags & 3;
|
|
110
|
-
}
|
|
111
|
-
get isFinal() {
|
|
112
|
-
return (this.flags & 4) !== 0;
|
|
113
|
-
}
|
|
114
|
-
get isEncrypted() {
|
|
115
|
-
return (this.flags & 8) !== 0;
|
|
116
|
-
}
|
|
117
|
-
// ── Parsing ───────────────────────────────────────────────────────────────
|
|
118
|
-
static parse(buf) {
|
|
119
|
-
if (buf.length < 2) {
|
|
120
|
-
throw new NpsFrameError(
|
|
121
|
-
`Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`
|
|
122
|
-
);
|
|
123
|
-
}
|
|
124
|
-
const flags = buf[1];
|
|
125
|
-
const ext = (flags & FrameFlags.EXT) !== 0;
|
|
126
|
-
if (ext) {
|
|
127
|
-
if (buf.length < EXTENDED_HEADER_SIZE) {
|
|
128
|
-
throw new NpsFrameError(
|
|
129
|
-
`Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`
|
|
130
|
-
);
|
|
131
|
-
}
|
|
132
|
-
const view2 = new DataView(buf.buffer, buf.byteOffset);
|
|
133
|
-
const payloadLength2 = view2.getUint32(4, false);
|
|
134
|
-
return new _FrameHeader(buf[0], flags, payloadLength2);
|
|
135
|
-
}
|
|
136
|
-
if (buf.length < DEFAULT_HEADER_SIZE) {
|
|
137
|
-
throw new NpsFrameError(
|
|
138
|
-
`Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`
|
|
139
|
-
);
|
|
140
|
-
}
|
|
141
|
-
const view = new DataView(buf.buffer, buf.byteOffset);
|
|
142
|
-
const payloadLength = view.getUint16(2, false);
|
|
143
|
-
return new _FrameHeader(buf[0], flags, payloadLength);
|
|
144
|
-
}
|
|
145
|
-
// ── Serialisation ─────────────────────────────────────────────────────────
|
|
146
|
-
toBytes() {
|
|
147
|
-
if (this.isExtended) {
|
|
148
|
-
const buf2 = new Uint8Array(EXTENDED_HEADER_SIZE);
|
|
149
|
-
const view2 = new DataView(buf2.buffer);
|
|
150
|
-
view2.setUint8(0, this.frameType);
|
|
151
|
-
view2.setUint8(1, this.flags);
|
|
152
|
-
view2.setUint16(2, 0, false);
|
|
153
|
-
view2.setUint32(4, this.payloadLength, false);
|
|
154
|
-
return buf2;
|
|
155
|
-
}
|
|
156
|
-
const buf = new Uint8Array(DEFAULT_HEADER_SIZE);
|
|
157
|
-
const view = new DataView(buf.buffer);
|
|
158
|
-
view.setUint8(0, this.frameType);
|
|
159
|
-
view.setUint8(1, this.flags);
|
|
160
|
-
view.setUint16(2, this.payloadLength, false);
|
|
161
|
-
return buf;
|
|
162
|
-
}
|
|
163
|
-
toString() {
|
|
164
|
-
return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, "0")}, flags=0x${this.flags.toString(16).padStart(2, "0")}, payloadLength=${this.payloadLength})`;
|
|
165
|
-
}
|
|
166
|
-
};
|
|
167
|
-
var Tier1JsonCodec = class {
|
|
168
|
-
encode(frame) {
|
|
169
|
-
try {
|
|
170
|
-
const json = JSON.stringify(frame.toDict());
|
|
171
|
-
return new TextEncoder().encode(json);
|
|
172
|
-
} catch (err) {
|
|
173
|
-
throw new NpsCodecError(
|
|
174
|
-
`Tier-1 JSON encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
|
|
175
|
-
);
|
|
176
|
-
}
|
|
177
|
-
}
|
|
178
|
-
decode(frameType, payload, registry) {
|
|
179
|
-
const cls = registry.resolve(frameType);
|
|
180
|
-
try {
|
|
181
|
-
const text = new TextDecoder().decode(payload);
|
|
182
|
-
const data = JSON.parse(text);
|
|
183
|
-
return cls.fromDict(data);
|
|
184
|
-
} catch (err) {
|
|
185
|
-
throw new NpsCodecError(
|
|
186
|
-
`Tier-1 JSON decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
|
|
187
|
-
);
|
|
188
|
-
}
|
|
189
|
-
}
|
|
190
|
-
};
|
|
191
|
-
var Tier2MsgPackCodec = class {
|
|
192
|
-
encode(frame) {
|
|
193
|
-
try {
|
|
194
|
-
return msgpack__namespace.encode(frame.toDict());
|
|
195
|
-
} catch (err) {
|
|
196
|
-
throw new NpsCodecError(
|
|
197
|
-
`Tier-2 MsgPack encode failed for 0x${frame.frameType.toString(16).padStart(2, "0")}: ${String(err)}`
|
|
198
|
-
);
|
|
199
|
-
}
|
|
200
|
-
}
|
|
201
|
-
decode(frameType, payload, registry) {
|
|
202
|
-
const cls = registry.resolve(frameType);
|
|
203
|
-
try {
|
|
204
|
-
const data = msgpack__namespace.decode(payload);
|
|
205
|
-
return cls.fromDict(data);
|
|
206
|
-
} catch (err) {
|
|
207
|
-
throw new NpsCodecError(
|
|
208
|
-
`Tier-2 MsgPack decode failed for 0x${frameType.toString(16).padStart(2, "0")}: ${String(err)}`
|
|
209
|
-
);
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
};
|
|
213
|
-
var NpsFrameCodec = class {
|
|
214
|
-
_registry;
|
|
215
|
-
_maxPayload;
|
|
216
|
-
_json = new Tier1JsonCodec();
|
|
217
|
-
_msgpack = new Tier2MsgPackCodec();
|
|
218
|
-
constructor(registry, options = {}) {
|
|
219
|
-
this._registry = registry;
|
|
220
|
-
this._maxPayload = options.maxPayload ?? DEFAULT_MAX_PAYLOAD;
|
|
221
|
-
}
|
|
222
|
-
// ── Encode ────────────────────────────────────────────────────────────────
|
|
223
|
-
encode(frame, options = {}) {
|
|
224
|
-
const tier = options.overrideTier ?? frame.preferredTier;
|
|
225
|
-
const tierCodec = this._selectCodec(tier);
|
|
226
|
-
let payload;
|
|
227
|
-
try {
|
|
228
|
-
payload = tierCodec.encode(frame);
|
|
229
|
-
} catch (err) {
|
|
230
|
-
if (err instanceof NpsCodecError) throw err;
|
|
231
|
-
throw new NpsCodecError(`Encode failed for 0x${frame.frameType.toString(16)}.`);
|
|
232
|
-
}
|
|
233
|
-
if (payload.length > this._maxPayload) {
|
|
234
|
-
throw new NpsCodecError(
|
|
235
|
-
`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.`
|
|
236
|
-
);
|
|
237
|
-
}
|
|
238
|
-
const useExt = payload.length > DEFAULT_MAX_PAYLOAD;
|
|
239
|
-
let flags = this._buildFlags(frame, tier);
|
|
240
|
-
if (useExt) flags |= FrameFlags.EXT;
|
|
241
|
-
const header = new FrameHeader(frame.frameType, flags, payload.length);
|
|
242
|
-
const headerBytes = header.toBytes();
|
|
243
|
-
const wire = new Uint8Array(headerBytes.length + payload.length);
|
|
244
|
-
wire.set(headerBytes, 0);
|
|
245
|
-
wire.set(payload, headerBytes.length);
|
|
246
|
-
return wire;
|
|
247
|
-
}
|
|
248
|
-
// ── Decode ────────────────────────────────────────────────────────────────
|
|
249
|
-
decode(wire) {
|
|
250
|
-
const header = FrameHeader.parse(wire);
|
|
251
|
-
const payload = wire.slice(header.headerSize, header.headerSize + header.payloadLength);
|
|
252
|
-
const codec = this._selectCodec(header.encodingTier);
|
|
253
|
-
return codec.decode(header.frameType, payload, this._registry);
|
|
254
|
-
}
|
|
255
|
-
static peekHeader(wire) {
|
|
256
|
-
return FrameHeader.parse(wire);
|
|
257
|
-
}
|
|
258
|
-
// ── Private ───────────────────────────────────────────────────────────────
|
|
259
|
-
_buildFlags(frame, tier) {
|
|
260
|
-
let flags = tier === 0 /* JSON */ ? FrameFlags.TIER1_JSON : FrameFlags.TIER2_MSGPACK;
|
|
261
|
-
const isStreamFrame = "isLast" in frame;
|
|
262
|
-
const isFinal = !isStreamFrame || frame.isLast;
|
|
263
|
-
if (isFinal) flags |= FrameFlags.FINAL;
|
|
264
|
-
return flags;
|
|
265
|
-
}
|
|
266
|
-
_selectCodec(tier) {
|
|
267
|
-
if (tier === 0 /* JSON */) return this._json;
|
|
268
|
-
if (tier === 1 /* MSGPACK */) return this._msgpack;
|
|
269
|
-
throw new NpsCodecError(`Unsupported encoding tier: 0x${tier.toString(16).padStart(2, "0")}.`);
|
|
270
|
-
}
|
|
271
|
-
};
|
|
272
|
-
|
|
273
|
-
// src/core/registry.ts
|
|
274
|
-
var FrameRegistry = class {
|
|
275
|
-
_map = /* @__PURE__ */ new Map();
|
|
276
|
-
register(frameType, cls) {
|
|
277
|
-
this._map.set(frameType, cls);
|
|
278
|
-
}
|
|
279
|
-
resolve(frameType) {
|
|
280
|
-
const cls = this._map.get(frameType);
|
|
281
|
-
if (cls === void 0) {
|
|
282
|
-
throw new NpsFrameError(
|
|
283
|
-
`No frame class registered for type 0x${frameType.toString(16).padStart(2, "0")}.`
|
|
284
|
-
);
|
|
285
|
-
}
|
|
286
|
-
return cls;
|
|
287
|
-
}
|
|
288
|
-
};
|
|
289
|
-
var AnchorFrameCache = class _AnchorFrameCache {
|
|
290
|
-
_store = /* @__PURE__ */ new Map();
|
|
291
|
-
// Allow clock injection for testing
|
|
292
|
-
clock = () => Date.now();
|
|
293
|
-
// ── Public API ────────────────────────────────────────────────────────────
|
|
294
|
-
set(frame) {
|
|
295
|
-
const anchorId = frame.anchorId.startsWith("sha256:") ? frame.anchorId : _AnchorFrameCache.computeAnchorId(frame.schema);
|
|
296
|
-
const existing = this._store.get(anchorId);
|
|
297
|
-
if (existing !== void 0 && this.clock() < existing.expiresAt) {
|
|
298
|
-
if (!_AnchorFrameCache._schemasEqual(existing.frame.schema, frame.schema)) {
|
|
299
|
-
throw new NpsAnchorPoisonError(anchorId);
|
|
300
|
-
}
|
|
301
|
-
}
|
|
302
|
-
const ttlMs = (frame.ttl ?? 3600) * 1e3;
|
|
303
|
-
const expiresAt = this.clock() + ttlMs;
|
|
304
|
-
this._store.set(anchorId, { frame, expiresAt });
|
|
305
|
-
return anchorId;
|
|
306
|
-
}
|
|
307
|
-
get(anchorId) {
|
|
308
|
-
const entry = this._store.get(anchorId);
|
|
309
|
-
if (entry === void 0) return void 0;
|
|
310
|
-
if (this.clock() > entry.expiresAt) {
|
|
311
|
-
this._store.delete(anchorId);
|
|
312
|
-
return void 0;
|
|
313
|
-
}
|
|
314
|
-
return entry.frame;
|
|
315
|
-
}
|
|
316
|
-
getRequired(anchorId) {
|
|
317
|
-
const frame = this.get(anchorId);
|
|
318
|
-
if (frame === void 0) throw new NpsAnchorNotFoundError(anchorId);
|
|
319
|
-
return frame;
|
|
320
|
-
}
|
|
321
|
-
invalidate(anchorId) {
|
|
322
|
-
this._store.delete(anchorId);
|
|
323
|
-
}
|
|
324
|
-
get size() {
|
|
325
|
-
this._evictExpired();
|
|
326
|
-
return this._store.size;
|
|
327
|
-
}
|
|
328
|
-
// ── Static helpers ────────────────────────────────────────────────────────
|
|
329
|
-
static computeAnchorId(schema) {
|
|
330
|
-
const sorted = [...schema.fields].map((f) => {
|
|
331
|
-
const obj = { name: f.name, type: f.type };
|
|
332
|
-
if (f.semantic !== void 0) obj["semantic"] = f.semantic;
|
|
333
|
-
if (f.nullable !== void 0) obj["nullable"] = f.nullable;
|
|
334
|
-
return obj;
|
|
335
|
-
}).sort((a, b) => String(a["name"]).localeCompare(String(b["name"])));
|
|
336
|
-
const canonical = JSON.stringify(sorted);
|
|
337
|
-
const digest = crypto.createHash("sha256").update(canonical, "utf8").digest("hex");
|
|
338
|
-
return `sha256:${digest}`;
|
|
339
|
-
}
|
|
340
|
-
// ── Private ───────────────────────────────────────────────────────────────
|
|
341
|
-
_evictExpired() {
|
|
342
|
-
const now = this.clock();
|
|
343
|
-
for (const [k, entry] of this._store) {
|
|
344
|
-
if (now > entry.expiresAt) this._store.delete(k);
|
|
345
|
-
}
|
|
346
|
-
}
|
|
347
|
-
static _schemasEqual(a, b) {
|
|
348
|
-
return _AnchorFrameCache.computeAnchorId(a) === _AnchorFrameCache.computeAnchorId(b);
|
|
349
|
-
}
|
|
350
|
-
};
|
|
351
|
-
|
|
352
|
-
exports.AnchorFrameCache = AnchorFrameCache;
|
|
353
|
-
exports.DEFAULT_HEADER_SIZE = DEFAULT_HEADER_SIZE;
|
|
354
|
-
exports.DEFAULT_MAX_PAYLOAD = DEFAULT_MAX_PAYLOAD;
|
|
355
|
-
exports.EXTENDED_HEADER_SIZE = EXTENDED_HEADER_SIZE;
|
|
356
|
-
exports.EXTENDED_MAX_PAYLOAD = EXTENDED_MAX_PAYLOAD;
|
|
357
|
-
exports.EncodingTier = EncodingTier;
|
|
358
|
-
exports.FrameFlags = FrameFlags;
|
|
359
|
-
exports.FrameHeader = FrameHeader;
|
|
360
|
-
exports.FrameRegistry = FrameRegistry;
|
|
361
|
-
exports.FrameType = FrameType;
|
|
362
|
-
exports.NpsAnchorNotFoundError = NpsAnchorNotFoundError;
|
|
363
|
-
exports.NpsAnchorPoisonError = NpsAnchorPoisonError;
|
|
364
|
-
exports.NpsCodecError = NpsCodecError;
|
|
365
|
-
exports.NpsError = NpsError;
|
|
366
|
-
exports.NpsFrameCodec = NpsFrameCodec;
|
|
367
|
-
exports.NpsFrameError = NpsFrameError;
|
|
368
|
-
exports.Tier1JsonCodec = Tier1JsonCodec;
|
|
369
|
-
exports.Tier2MsgPackCodec = Tier2MsgPackCodec;
|
|
370
|
-
//# sourceMappingURL=index.cjs.map
|
|
371
|
-
//# sourceMappingURL=index.cjs.map
|
package/dist/core/index.cjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/core/exceptions.ts","../../src/core/frames.ts","../../src/core/codec.ts","../../src/core/registry.ts","../../src/core/cache.ts"],"names":["FrameType","EncodingTier","view","payloadLength","buf","msgpack","createHash"],"mappings":"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","file":"index.cjs","sourcesContent":["// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/** Base class for all NPS errors. */\nexport class NpsError extends Error {\n constructor(message: string) {\n super(message);\n this.name = new.target.name;\n }\n}\n\n/** Raised when a wire buffer cannot be parsed as a valid NPS frame. */\nexport class NpsFrameError extends NpsError {}\n\n/** Raised when frame serialisation or deserialisation fails. */\nexport class NpsCodecError extends NpsError {}\n\n/** Raised when an anchor_id is not found in the cache. */\nexport class NpsAnchorNotFoundError extends NpsError {\n constructor(public readonly anchorId: string) {\n super(`AnchorFrame not found in cache: ${anchorId}`);\n }\n}\n\n/**\n * Raised when the same anchor_id is stored with a different schema (NPS-1 §7.2).\n * This indicates a potential anchor-poisoning attack.\n */\nexport class NpsAnchorPoisonError extends NpsError {\n constructor(public readonly anchorId: string) {\n super(\n `Anchor poisoning detected: anchor_id ${anchorId} already exists with a different schema.`,\n );\n }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * NPS wire-level frame primitives: FrameType, FrameFlags, EncodingTier, FrameHeader.\n */\n\nimport { NpsFrameError } from \"./exceptions.js\";\n\n// ── FrameType ────────────────────────────────────────────────────────────────\n\n/** Unified frame byte namespace for the full NPS suite (NPS-0 §9). */\nexport enum FrameType {\n // NCP 0x01–0x0F\n ANCHOR = 0x01,\n DIFF = 0x02,\n STREAM = 0x03,\n CAPS = 0x04,\n ALIGN = 0x05, // deprecated — use AlignStream (0x43)\n\n // NWP 0x10–0x1F\n QUERY = 0x10,\n ACTION = 0x11,\n\n // NIP 0x20–0x2F\n IDENT = 0x20,\n TRUST = 0x21,\n REVOKE = 0x22,\n\n // NDP 0x30–0x3F\n ANNOUNCE = 0x30,\n RESOLVE = 0x31,\n GRAPH = 0x32,\n\n // NOP 0x40–0x4F\n TASK = 0x40,\n DELEGATE = 0x41,\n SYNC = 0x42,\n ALIGN_STREAM = 0x43,\n\n // Reserved / System 0xF0–0xFF\n ERROR = 0xFE,\n}\n\n// ── EncodingTier ─────────────────────────────────────────────────────────────\n\n/**\n * Wire encoding tier, stored in the lower 2 bits of the flags byte (NPS-1 §3.2).\n * 0x00 = Tier-1 JSON — human-readable; development / compatibility.\n * 0x01 = Tier-2 MsgPack — binary, ~60 % smaller; production default.\n */\nexport enum EncodingTier {\n JSON = 0x00,\n MSGPACK = 0x01,\n}\n\n// ── FrameFlags ───────────────────────────────────────────────────────────────\n\n/**\n * Flags byte in the NPS frame header (NPS-1 §3.2).\n * Bit layout (LSB = bit 0):\n * Bits 0–1 (T0,T1) : Encoding tier\n * Bit 2 (FINAL) : Last chunk of a StreamFrame; non-stream frames MUST set this\n * Bit 3 (ENC) : Payload encrypted\n * Bits 4–6 (RSV) : Reserved — sender MUST write 0\n * Bit 7 (EXT) : Extended 8-byte header\n */\nexport const FrameFlags = {\n NONE: 0x00,\n TIER1_JSON: 0x00,\n TIER2_MSGPACK: 0x01,\n FINAL: 0x04,\n ENCRYPTED: 0x08,\n EXT: 0x80,\n} as const;\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_HEADER_SIZE = 4;\nexport const EXTENDED_HEADER_SIZE = 8;\nexport const DEFAULT_MAX_PAYLOAD = 0xffff; // 65 535 bytes\nexport const EXTENDED_MAX_PAYLOAD = 0xffffffff; // 4 GiB - 1\n\n// ── FrameHeader ──────────────────────────────────────────────────────────────\n\n/**\n * NPS frame header, present at the start of every wire message (NPS-1 §3.1).\n *\n * Default (4 bytes, EXT=0):\n * Byte 0 : FrameType\n * Byte 1 : Flags\n * Byte 2–3 : PayloadLength (big-endian uint16)\n *\n * Extended (8 bytes, EXT=1):\n * Byte 0 : FrameType\n * Byte 1 : Flags (bit 7 = 1)\n * Byte 2–3 : Reserved (must be 0)\n * Byte 4–7 : PayloadLength (big-endian uint32)\n */\nexport class FrameHeader {\n constructor(\n public readonly frameType: FrameType,\n public readonly flags: number,\n public readonly payloadLength: number,\n ) {}\n\n get isExtended(): boolean {\n return (this.flags & FrameFlags.EXT) !== 0;\n }\n\n get headerSize(): number {\n return this.isExtended ? EXTENDED_HEADER_SIZE : DEFAULT_HEADER_SIZE;\n }\n\n get encodingTier(): EncodingTier {\n return (this.flags & 0x03) as EncodingTier;\n }\n\n get isFinal(): boolean {\n return (this.flags & 0x04) !== 0;\n }\n\n get isEncrypted(): boolean {\n return (this.flags & 0x08) !== 0;\n }\n\n // ── Parsing ───────────────────────────────────────────────────────────────\n\n static parse(buf: Uint8Array): FrameHeader {\n if (buf.length < 2) {\n throw new NpsFrameError(\n `Buffer too small to read frame type and flags: need >= 2 bytes, got ${buf.length}.`,\n );\n }\n\n const flags = buf[1]!;\n const ext = (flags & FrameFlags.EXT) !== 0;\n\n if (ext) {\n if (buf.length < EXTENDED_HEADER_SIZE) {\n throw new NpsFrameError(\n `Buffer too small for extended frame header: need ${EXTENDED_HEADER_SIZE} bytes, got ${buf.length}.`,\n );\n }\n const view = new DataView(buf.buffer, buf.byteOffset);\n const payloadLength = view.getUint32(4, false); // big-endian\n return new FrameHeader(buf[0]! as FrameType, flags, payloadLength);\n }\n\n if (buf.length < DEFAULT_HEADER_SIZE) {\n throw new NpsFrameError(\n `Buffer too small for frame header: need ${DEFAULT_HEADER_SIZE} bytes, got ${buf.length}.`,\n );\n }\n const view = new DataView(buf.buffer, buf.byteOffset);\n const payloadLength = view.getUint16(2, false); // big-endian\n return new FrameHeader(buf[0]! as FrameType, flags, payloadLength);\n }\n\n // ── Serialisation ─────────────────────────────────────────────────────────\n\n toBytes(): Uint8Array {\n if (this.isExtended) {\n const buf = new Uint8Array(EXTENDED_HEADER_SIZE);\n const view = new DataView(buf.buffer);\n view.setUint8(0, this.frameType);\n view.setUint8(1, this.flags);\n view.setUint16(2, 0, false); // reserved\n view.setUint32(4, this.payloadLength, false);\n return buf;\n }\n const buf = new Uint8Array(DEFAULT_HEADER_SIZE);\n const view = new DataView(buf.buffer);\n view.setUint8(0, this.frameType);\n view.setUint8(1, this.flags);\n view.setUint16(2, this.payloadLength, false);\n return buf;\n }\n\n toString(): string {\n return `FrameHeader(frameType=0x${this.frameType.toString(16).padStart(2, \"0\")}, flags=0x${this.flags.toString(16).padStart(2, \"0\")}, payloadLength=${this.payloadLength})`;\n }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * NPS frame codec: Tier-1 (JSON) and Tier-2 (MsgPack) encode/decode,\n * plus the top-level NpsFrameCodec dispatcher.\n */\n\nimport * as msgpack from \"@msgpack/msgpack\";\nimport { NpsCodecError } from \"./exceptions.js\";\nimport {\n DEFAULT_MAX_PAYLOAD,\n EncodingTier,\n FrameFlags,\n FrameHeader,\n FrameType,\n} from \"./frames.js\";\nimport type { FrameRegistry } from \"./registry.js\";\n\n// ── NpsFrame interface ────────────────────────────────────────────────────────\n\nexport interface NpsFrame {\n readonly frameType: FrameType;\n readonly preferredTier: EncodingTier;\n toDict(): Record<string, unknown>;\n}\n\n// ── Tier-1 JSON codec ─────────────────────────────────────────────────────────\n\nexport class Tier1JsonCodec {\n encode(frame: NpsFrame): Uint8Array {\n try {\n const json = JSON.stringify(frame.toDict());\n return new TextEncoder().encode(json);\n } catch (err) {\n throw new NpsCodecError(\n `Tier-1 JSON encode failed for 0x${frame.frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n );\n }\n }\n\n decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame {\n const cls = registry.resolve(frameType);\n try {\n const text = new TextDecoder().decode(payload);\n const data = JSON.parse(text) as Record<string, unknown>;\n return cls.fromDict(data);\n } catch (err) {\n throw new NpsCodecError(\n `Tier-1 JSON decode failed for 0x${frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n );\n }\n }\n}\n\n// ── Tier-2 MsgPack codec ──────────────────────────────────────────────────────\n\nexport class Tier2MsgPackCodec {\n encode(frame: NpsFrame): Uint8Array {\n try {\n return msgpack.encode(frame.toDict());\n } catch (err) {\n throw new NpsCodecError(\n `Tier-2 MsgPack encode failed for 0x${frame.frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n );\n }\n }\n\n decode(frameType: FrameType, payload: Uint8Array, registry: FrameRegistry): NpsFrame {\n const cls = registry.resolve(frameType);\n try {\n const data = msgpack.decode(payload) as Record<string, unknown>;\n return cls.fromDict(data);\n } catch (err) {\n throw new NpsCodecError(\n `Tier-2 MsgPack decode failed for 0x${frameType.toString(16).padStart(2, \"0\")}: ${String(err)}`,\n );\n }\n }\n}\n\n// ── NpsFrameCodec (dispatcher) ────────────────────────────────────────────────\n\nexport class NpsFrameCodec {\n private readonly _registry: FrameRegistry;\n private readonly _maxPayload: number;\n private readonly _json = new Tier1JsonCodec();\n private readonly _msgpack = new Tier2MsgPackCodec();\n\n constructor(registry: FrameRegistry, options: { maxPayload?: number } = {}) {\n this._registry = registry;\n this._maxPayload = options.maxPayload ?? DEFAULT_MAX_PAYLOAD;\n }\n\n // ── Encode ────────────────────────────────────────────────────────────────\n\n encode(frame: NpsFrame, options: { overrideTier?: EncodingTier } = {}): Uint8Array {\n const tier = options.overrideTier ?? frame.preferredTier;\n const tierCodec = this._selectCodec(tier);\n\n let payload: Uint8Array;\n try {\n payload = tierCodec.encode(frame);\n } catch (err) {\n if (err instanceof NpsCodecError) throw err;\n throw new NpsCodecError(`Encode failed for 0x${frame.frameType.toString(16)}.`);\n }\n\n if (payload.length > this._maxPayload) {\n throw new NpsCodecError(\n `Encoded payload for 0x${frame.frameType.toString(16).padStart(2, \"0\")} exceeds max_frame_payload` +\n ` (${payload.length} bytes > ${this._maxPayload}). Use StreamFrame (0x03) for large payloads.`,\n );\n }\n\n const useExt = payload.length > DEFAULT_MAX_PAYLOAD;\n let flags = this._buildFlags(frame, tier);\n if (useExt) flags |= FrameFlags.EXT;\n\n const header = new FrameHeader(frame.frameType, flags, payload.length);\n const headerBytes = header.toBytes();\n const wire = new Uint8Array(headerBytes.length + payload.length);\n wire.set(headerBytes, 0);\n wire.set(payload, headerBytes.length);\n return wire;\n }\n\n // ── Decode ────────────────────────────────────────────────────────────────\n\n decode(wire: Uint8Array): NpsFrame {\n const header = FrameHeader.parse(wire);\n const payload = wire.slice(header.headerSize, header.headerSize + header.payloadLength);\n const codec = this._selectCodec(header.encodingTier);\n return codec.decode(header.frameType, payload, this._registry);\n }\n\n static peekHeader(wire: Uint8Array): FrameHeader {\n return FrameHeader.parse(wire);\n }\n\n // ── Private ───────────────────────────────────────────────────────────────\n\n private _buildFlags(frame: NpsFrame, tier: EncodingTier): number {\n let flags = tier === EncodingTier.JSON ? FrameFlags.TIER1_JSON : FrameFlags.TIER2_MSGPACK;\n\n const isStreamFrame = \"isLast\" in frame;\n const isFinal = !isStreamFrame || (frame as { isLast: boolean }).isLast;\n if (isFinal) flags |= FrameFlags.FINAL;\n\n return flags;\n }\n\n private _selectCodec(tier: EncodingTier): Tier1JsonCodec | Tier2MsgPackCodec {\n if (tier === EncodingTier.JSON) return this._json;\n if (tier === EncodingTier.MSGPACK) return this._msgpack;\n throw new NpsCodecError(`Unsupported encoding tier: 0x${(tier as number).toString(16).padStart(2, \"0\")}.`);\n }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\nimport { NpsFrameError } from \"./exceptions.js\";\nimport { FrameType } from \"./frames.js\";\nimport type { NpsFrame } from \"./codec.js\";\n\nexport interface FrameClass {\n fromDict(data: Record<string, unknown>): NpsFrame;\n}\n\nexport class FrameRegistry {\n private readonly _map = new Map<FrameType, FrameClass>();\n\n register(frameType: FrameType, cls: FrameClass): void {\n this._map.set(frameType, cls);\n }\n\n resolve(frameType: FrameType): FrameClass {\n const cls = this._map.get(frameType);\n if (cls === undefined) {\n throw new NpsFrameError(\n `No frame class registered for type 0x${frameType.toString(16).padStart(2, \"0\")}.`,\n );\n }\n return cls;\n }\n}\n","// Copyright 2026 INNO LOTUS PTY LTD\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * AnchorFrameCache — in-process cache for AnchorFrame instances (NPS-1 §4.1).\n */\n\nimport { createHash } from \"node:crypto\";\nimport { NpsAnchorNotFoundError, NpsAnchorPoisonError } from \"./exceptions.js\";\nimport type { AnchorFrame, FrameSchema } from \"../ncp/frames.js\";\n\nexport class AnchorFrameCache {\n private readonly _store = new Map<string, { frame: AnchorFrame; expiresAt: number }>();\n\n // Allow clock injection for testing\n clock: () => number = () => Date.now();\n\n // ── Public API ────────────────────────────────────────────────────────────\n\n set(frame: AnchorFrame): string {\n const anchorId = frame.anchorId.startsWith(\"sha256:\")\n ? frame.anchorId\n : AnchorFrameCache.computeAnchorId(frame.schema);\n\n const existing = this._store.get(anchorId);\n if (existing !== undefined && this.clock() < existing.expiresAt) {\n if (!AnchorFrameCache._schemasEqual(existing.frame.schema, frame.schema)) {\n throw new NpsAnchorPoisonError(anchorId);\n }\n // Same schema — idempotent; refresh TTL below\n }\n\n const ttlMs = (frame.ttl ?? 3600) * 1000;\n const expiresAt = this.clock() + ttlMs;\n this._store.set(anchorId, { frame, expiresAt });\n return anchorId;\n }\n\n get(anchorId: string): AnchorFrame | undefined {\n const entry = this._store.get(anchorId);\n if (entry === undefined) return undefined;\n if (this.clock() > entry.expiresAt) {\n this._store.delete(anchorId);\n return undefined;\n }\n return entry.frame;\n }\n\n getRequired(anchorId: string): AnchorFrame {\n const frame = this.get(anchorId);\n if (frame === undefined) throw new NpsAnchorNotFoundError(anchorId);\n return frame;\n }\n\n invalidate(anchorId: string): void {\n this._store.delete(anchorId);\n }\n\n get size(): number {\n this._evictExpired();\n return this._store.size;\n }\n\n // ── Static helpers ────────────────────────────────────────────────────────\n\n static computeAnchorId(schema: FrameSchema): string {\n const sorted = [...schema.fields]\n .map((f) => {\n const obj: Record<string, unknown> = { name: f.name, type: f.type };\n if (f.semantic !== undefined) obj[\"semantic\"] = f.semantic;\n if (f.nullable !== undefined) obj[\"nullable\"] = f.nullable;\n return obj;\n })\n .sort((a, b) => String(a[\"name\"]).localeCompare(String(b[\"name\"])));\n\n const canonical = JSON.stringify(sorted);\n const digest = createHash(\"sha256\").update(canonical, \"utf8\").digest(\"hex\");\n return `sha256:${digest}`;\n }\n\n // ── Private ───────────────────────────────────────────────────────────────\n\n private _evictExpired(): void {\n const now = this.clock();\n for (const [k, entry] of this._store) {\n if (now > entry.expiresAt) this._store.delete(k);\n }\n }\n\n private static _schemasEqual(a: FrameSchema, b: FrameSchema): boolean {\n return AnchorFrameCache.computeAnchorId(a) === AnchorFrameCache.computeAnchorId(b);\n }\n}\n"]}
|