@macula-io/ts 0.17.0 → 0.19.0

package/dist/binding.js

@@ -1,133 +1,16 @@
-// Loads the compiled N-API addon (addon/binding.cc) and re-exports its
-// typed functions. Unlike the koffi-era version of this file, there is
-// no runtime signature declaration here -- the addon's C++ glue already
-// knows its own shapes, throws real JS errors on failure (no more
-// manual errOut-array/checkErr dance), and is a single self-contained
-// .node file (cabi/'s Go code is statically linked in via
-// -buildmode=c-archive, not loaded separately at runtime).
+// Loads the compiled N-API addon (addon/binding.cc) and types its functions.
+// cabi/'s Go code is linked into the addon statically, so it is one
+// self-contained .node file. node-gyp-build picks, at require time, a local
+// build (build/Release/*.node) or the published prebuild for this platform
+// (prebuilds/<platform>-<arch>/*.node), so a consumer installing from npm
+// never runs a compiler.
 //
-// node-gyp-build picks, at require time, whichever of these exists:
-// build/Release/*.node (a local dev build via `npm run build:addon:dev`)
-// or prebuilds/<platform>-<arch>/*.node (baked in by `npm run
-// build:prebuilds` / prebuildify, and published as part of the npm
-// package) -- this is the whole point: a consumer installing this
-// package from npm never runs a compiler or fetches anything, because
-// the matching prebuild is already sitting in the downloaded tarball.
+// Internal to the package: the public API is key.ts, pool.ts and stream.ts.
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 const require = createRequire(import.meta.url);
 const repoRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
-const addon = require("node-gyp-build")(repoRoot);
-export const native = {
-    identityGenerate() {
-        return addon.identityGenerate();
-    },
-    identityFromSeedBytes(seed32) {
-        if (seed32.length !== 32) {
-            throw new Error(`macula-ts: seed must be exactly 32 bytes, got ${seed32.length}`);
-        }
-        return addon.identityFromSeedBytes(seed32);
-    },
-    identityNodeId(handle) {
-        return addon.identityNodeId(handle);
-    },
-    identityPrivateBytes(handle) {
-        return addon.identityPrivateBytes(handle);
-    },
-    identityFree(handle) {
-        addon.identityFree(handle);
-    },
-    identitySign(handle, data) {
-        return addon.identitySign(handle, data);
-    },
-    sessionConnect(host, port, identityHandle) {
-        return addon.sessionConnect(host, port, identityHandle);
-    },
-    sessionRemoteAddr(handle) {
-        return addon.sessionRemoteAddr(handle);
-    },
-    sessionStationNodeId(handle) {
-        return addon.sessionStationNodeId(handle);
-    },
-    sessionClose(handle, identityHandle, reason) {
-        return addon.sessionClose(handle, identityHandle, reason);
-    },
-    sessionCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode) {
-        return addon.sessionCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode);
-    },
-    ucanMint(identityHandle, issuer, audience, capabilitiesJson, expiresAt, notBefore, nonce, factsJson, proofsJson) {
-        return addon.ucanMint(identityHandle, issuer, audience, capabilitiesJson, expiresAt, notBefore, nonce, factsJson, proofsJson);
-    },
-    ucanDecode(token) {
-        return addon.ucanDecode(token);
-    },
-    sessionCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode) {
-        return addon.sessionCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode);
-    },
-    sessionAdvertise(sessionHandle, identityHandle, realm, procedure) {
-        return addon.sessionAdvertise(sessionHandle, identityHandle, realm, procedure);
-    },
-    sessionUnadvertise(sessionHandle, identityHandle, realm, procedure) {
-        return addon.sessionUnadvertise(sessionHandle, identityHandle, realm, procedure);
-    },
-    serveWaitForCall(sessionHandle, identityHandle, realm, procedure, timeoutMs) {
-        return addon.serveWaitForCall(sessionHandle, identityHandle, realm, procedure, timeoutMs);
-    },
-    pendingCallProcedure(pendingHandle) {
-        return addon.pendingCallProcedure(pendingHandle);
-    },
-    pendingCallPayloadJson(pendingHandle, bytesMode) {
-        return addon.pendingCallPayloadJson(pendingHandle, bytesMode);
-    },
-    pendingCallReplyResult(pendingHandle, resultJson) {
-        return addon.pendingCallReplyResult(pendingHandle, resultJson);
-    },
-    pendingCallReplyError(pendingHandle, detail) {
-        return addon.pendingCallReplyError(pendingHandle, detail);
-    },
-    dhtFindRecordsByType(sessionHandle, identityHandle, recordType) {
-        return addon.dhtFindRecordsByType(sessionHandle, identityHandle, recordType);
-    },
-    dhtFindRecords(sessionHandle, identityHandle, key32) {
-        return addon.dhtFindRecords(sessionHandle, identityHandle, key32);
-    },
-    dhtFindRecord(sessionHandle, identityHandle, key32) {
-        return addon.dhtFindRecord(sessionHandle, identityHandle, key32);
-    },
-    dhtPutProcedureAdvertisement(sessionHandle, identityHandle, realm, procedure, servingStation32, ttlMs) {
-        return addon.dhtPutProcedureAdvertisement(sessionHandle, identityHandle, realm, procedure, servingStation32, ttlMs);
-    },
-    dhtPutContentAnnouncement(sessionHandle, identityHandle, mcid34, endpoint, ttlMs) {
-        return addon.dhtPutContentAnnouncement(sessionHandle, identityHandle, mcid34, endpoint, ttlMs);
-    },
-    sessionPublish(sessionHandle, identityHandle, realm, topic, payloadJson, ttlMs) {
-        return addon.sessionPublish(sessionHandle, identityHandle, realm, topic, payloadJson, ttlMs);
-    },
-    sessionSubscribeStart(sessionHandle, identityHandle, realm, topic, onEvent, bytesMode) {
-        return addon.sessionSubscribeStart(sessionHandle, identityHandle, realm, topic, onEvent, bytesMode);
-    },
-    sessionSubscribeStop(subscriptionHandle) {
-        return addon.sessionSubscribeStop(subscriptionHandle);
-    },
-    contentPut(sessionHandle, identityHandle, data, name) {
-        return addon.contentPut(sessionHandle, identityHandle, data, name);
-    },
-    contentGet(sessionHandle, identityHandle, mcidHex) {
-        return addon.contentGet(sessionHandle, identityHandle, mcidHex);
-    },
-    directdialResolve(sessionHandle, identityHandle, realm, procedure, timeoutMs) {
-        return addon.directdialResolve(sessionHandle, identityHandle, realm, procedure, timeoutMs);
-    },
-    directdialCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode) {
-        return addon.directdialCall(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, bytesMode);
-    },
-    directdialCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode) {
-        return addon.directdialCallWithUcan(sessionHandle, identityHandle, procedure, realm, payloadJson, timeoutMs, ucanToken, bytesMode);
-    },
-    directdialAdvertise(sessionHandle, identityHandle, realm, procedure, ttlMs) {
-        return addon.directdialAdvertise(sessionHandle, identityHandle, realm, procedure, ttlMs);
-    },
-};
+export const native = require("node-gyp-build")(repoRoot);
 //# sourceMappingURL=binding.js.map

package/dist/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,oEAAoE;AACpE,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,yBAAyB;AACzB,EAAE;AACF,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAgBrE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CA+CvD,CAAC"}

package/dist/content.d.ts

@@ -1,14 +1,33 @@
-/** Thrown by Session.getContent() when the station reports the content
- * isn't known to it (macula-go's content.ErrNotFound) -- an expected,
- * routine outcome for a transfer mechanism with no durability
- * guarantee, not a transport failure. Unlike DhtRecord's findRecord()
- * (which resolves `null` for its own equivalent "not found" case),
- * getContent() throws instead: its whole contract is "hand back the
- * bytes or fail", and there is no sensible non-throwing value to return
- * in place of the `Uint8Array` a caller asked for. */
-export declare class ContentNotFoundError extends Error {
-    /** The mcid that produced this error, hex-encoded (the same string
-     * that was passed to getContent()). */
-    readonly mcid: string;
-    constructor(mcid: string);
+/** A content id (MCID): 50 bytes, tag 2 (SHA-384), a codec byte (0x55 a raw
+ * block of at most 256 KiB, 0x56 a manifest over 256 KiB chunks) and the
+ * 48-byte hash. Given as 100 hex characters or 50 bytes. */
+export type Mcid = string | Uint8Array;
+/** A content id as the 50 bytes the native layer takes. */
+export declare function mcid50(mcid: Mcid): Uint8Array;
+/** Bounds on one fetch; each defaults as macula's does. */
+export interface ContentOptions {
+    /** Largest content accepted, 256 MiB by default. */
+    readonly maxBytes?: number;
+    /** Most chunks a manifest may have, 16,384 by default. */
+    readonly maxChunks?: number;
+    /** Chunk streams open at once, 4 by default. */
+    readonly parallel?: number;
+    /** Deadline of one stream, 15 s by default. */
+    readonly chunkTimeoutMs?: number;
+    /** Deadline of the whole fetch, 5 minutes by default. */
+    readonly timeoutMs?: number;
 }
+/** Content no node announces in the realm. */
+export declare class NotSharedError extends Error {
+    constructor();
+}
+/** Content every announcing node failed to give; `detail` names each failure
+ * (unreachable, not the content asked for, over the bounds, ...). */
+export declare class ContentUnavailableError extends Error {
+    readonly detail: string;
+    constructor(detail: string);
+}
+/** The native layer's content errors, as the classes they name. */
+export declare function contentError(e: unknown): Error;
+/** How long a whole fetch waits when not told: 5 minutes. */
+export declare const DEFAULT_CONTENT_TIMEOUT_MS = 300000;

package/dist/content.js

@@ -1,44 +1,46 @@
-// Content transfer -- macula-go's content package (Put/Get), thin
-// CALL/RESULT wrappers to reserved `_content.*` procedures sent on
-// their OWN dedicated QUIC stream (Session.OpenDedicatedStream on the
-// Go side), NOT the control stream call()/serve()/the DHT
-// methods/subscribe() all use -- see cabi/content.go's own doc for why
-// Session.putContent()/getContent() (session.ts) are, unlike those, never
-// subject to Session's one-role rule, and why two concurrent
-// putContent()/getContent() calls on one Session don't race each other
-// either (each gets its own fresh dedicated stream).
-//
-// IMPORTANT: this is a one-time TRANSFER mechanism, not durable object
-// storage. A station may forget content after serving it, there is no
-// "list what's stored here" operation, and there is no "delete"
-// operation -- putContent()/getContent() hand a blob to a peer once,
-// they do not give you a key-value store. Do not build anything on this
-// SDK that assumes content survives indefinitely, or that a station is
-// obligated to keep serving something it once accepted.
-//
-// mcid crosses the FFI boundary as a lowercase hex string (68 hex
-// chars = 34 bytes: <<Version:8, Codec:8, Hash:32/binary>>, macula-go's
-// manifest.Mcid) -- the same "raw byte identifier -> hex string"
-// convention DhtRecord's key/version/signature already use (dht.ts),
-// deliberately NOT rpc.ts's own "0x"-prefixed convention for bytes
-// embedded *inside* a JSON payload -- an mcid stands on its own here,
-// it isn't a payload field.
-/** Thrown by Session.getContent() when the station reports the content
- * isn't known to it (macula-go's content.ErrNotFound) -- an expected,
- * routine outcome for a transfer mechanism with no durability
- * guarantee, not a transport failure. Unlike DhtRecord's findRecord()
- * (which resolves `null` for its own equivalent "not found" case),
- * getContent() throws instead: its whole contract is "hand back the
- * bytes or fail", and there is no sensible non-throwing value to return
- * in place of the `Uint8Array` a caller asked for. */
-export class ContentNotFoundError extends Error {
-    /** The mcid that produced this error, hex-encoded (the same string
-     * that was passed to getContent()). */
-    mcid;
-    constructor(mcid) {
-        super(`macula-ts: no content found for mcid ${mcid}`);
-        this.name = "ContentNotFoundError";
-        this.mcid = mcid;
+// Node-served content (macula 12.6.0, D27): a node shares content by serving
+// it on its own ~<node_id>/content_v1 and announcing it in the DHT; a fetch
+// finds the announcements, dials each sharer through the station it names, and
+// checks the block, the manifest and every chunk against the content id it
+// asked for, so it trusts no sharer and needs no realm key.
+/** A content id as the 50 bytes the native layer takes. */
+export function mcid50(mcid) {
+    if (typeof mcid === "string") {
+        if (!/^[0-9a-fA-F]{100}$/.test(mcid))
+            throw new Error("macula-ts: a content id is 100 hex characters (50 bytes)");
+        return Uint8Array.from(Buffer.from(mcid, "hex"));
     }
+    if (mcid.length !== 50)
+        throw new Error(`macula-ts: a content id is 50 bytes, got ${mcid.length}`);
+    return mcid;
 }
+/** Content no node announces in the realm. */
+export class NotSharedError extends Error {
+    constructor() {
+        super("macula-ts: no node shares that content in that realm");
+        this.name = "NotSharedError";
+    }
+}
+/** Content every announcing node failed to give; `detail` names each failure
+ * (unreachable, not the content asked for, over the bounds, ...). */
+export class ContentUnavailableError extends Error {
+    detail;
+    constructor(detail) {
+        super(`macula-ts: no sharer gave the content: ${detail}`);
+        this.detail = detail;
+        this.name = "ContentUnavailableError";
+    }
+}
+/** The native layer's content errors, as the classes they name. */
+export function contentError(e) {
+    const message = e instanceof Error ? e.message : String(e);
+    if (message === "not_shared")
+        return new NotSharedError();
+    const unavailable = /^unavailable:([\s\S]*)$/.exec(message);
+    if (unavailable)
+        return new ContentUnavailableError(unavailable[1] ?? "");
+    return e instanceof Error ? e : new Error(message);
+}
+/** How long a whole fetch waits when not told: 5 minutes. */
+export const DEFAULT_CONTENT_TIMEOUT_MS = 300_000;
 //# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,mEAAmE;AACnE,sEAAsE;AACtE,0DAA0D;AAC1D,uEAAuE;AACvE,0EAA0E;AAC1E,6DAA6D;AAC7D,uEAAuE;AACvE,qDAAqD;AACrD,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,gEAAgE;AAChE,qEAAqE;AACrE,wEAAwE;AACxE,uEAAuE;AACvE,wDAAwD;AACxD,EAAE;AACF,kEAAkE;AAClE,wEAAwE;AACxE,iEAAiE;AACjE,qEAAqE;AACrE,mEAAmE;AACnE,sEAAsE;AACtE,4BAA4B;AAE5B;;;;;;;sDAOsD;AACtD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;2CACuC;IAC9B,IAAI,CAAS;IAEtB,YAAY,IAAY;QACtB,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,4DAA4D;AAO5D,2DAA2D;AAC3D,MAAM,UAAU,MAAM,CAAC,IAAU;IAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAClH,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnG,OAAO,IAAI,CAAC;AACd,CAAC;AAgBD,8CAA8C;AAC9C,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;QACE,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;qEACqE;AACrE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC3B,MAAM;IAA3B,YAAqB,MAAc;QACjC,KAAK,CAAC,0CAA0C,MAAM,EAAE,CAAC,CAAC;sBADvC,MAAM;QAEzB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,YAAY;QAAE,OAAO,IAAI,cAAc,EAAE,CAAC;IAC1D,MAAM,WAAW,GAAG,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,WAAW;QAAE,OAAO,IAAI,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,5 @@
-export { Identity } from "./identity.js";
-export { Session, type CallOptions, type ServeOptions } from "./session.js";
-export { Pool, NoHealthyStationError, type Seed, type PoolOptions, type PoolStatus } from "./pool.js";
-export { MaculaCallError, type JsonValue, type Bolt4ErrorInfo, type BytesOutput } from "./rpc.js";
-export { DhtRecordType, DHT_DEFAULT_TTL_MS, type DhtRecord } from "./dht.js";
-export type { PublishOptions, PubsubEvent, SubscribeOptions } from "./pubsub.js";
-export { ContentNotFoundError } from "./content.js";
-export { Ucan, type UcanCapability, type UcanFactValue, type UcanMintOptions } from "./ucan.js";
-export { keepAdvertisedDirect, KEEP_ADVERTISED_DIRECT_INTERVAL_MS, type DirectDialTarget, type AdvertiseDirectOptions, type KeepAdvertisedDirectOptions, } from "./directdial.js";
+export { NodeKey, type Profile } from "./key.js";
+export { Pool, Subscription, Served, RecordType, type Seed, type PoolOptions, type LinkStatus, type Provider, type Event, type Request, type DhtRecord, } from "./pool.js";
+export { NotSharedError, ContentUnavailableError, DEFAULT_CONTENT_TIMEOUT_MS, type ContentOptions, type Mcid, } from "./content.js";
+export { Stream, StreamMode, type StreamEvent, type StreamRequest } from "./stream.js";
+export { ProviderError, RelayError, StreamError, DEFAULT_CALL_TIMEOUT_MS, type JsonValue, type BytesOutput, type Id, } from "./wire.js";

package/dist/index.js

@@ -1,9 +1,7 @@
-export { Identity } from "./identity.js";
-export { Session } from "./session.js";
-export { Pool, NoHealthyStationError } from "./pool.js";
-export { MaculaCallError } from "./rpc.js";
-export { DhtRecordType, DHT_DEFAULT_TTL_MS } from "./dht.js";
-export { ContentNotFoundError } from "./content.js";
-export { Ucan } from "./ucan.js";
-export { keepAdvertisedDirect, KEEP_ADVERTISED_DIRECT_INTERVAL_MS, } from "./directdial.js";
+// @macula-io/ts: the macula 12 mesh from TypeScript, over macula-go.
+export { NodeKey } from "./key.js";
+export { Pool, Subscription, Served, RecordType, } from "./pool.js";
+export { NotSharedError, ContentUnavailableError, DEFAULT_CONTENT_TIMEOUT_MS, } from "./content.js";
+export { Stream, StreamMode } from "./stream.js";
+export { ProviderError, RelayError, StreamError, DEFAULT_CALL_TIMEOUT_MS, } from "./wire.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAuC,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAgD,MAAM,WAAW,CAAC;AACtG,OAAO,EAAE,eAAe,EAAyD,MAAM,UAAU,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAkB,MAAM,UAAU,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,IAAI,EAAiE,MAAM,WAAW,CAAC;AAChG,OAAO,EACL,oBAAoB,EACpB,kCAAkC,GAInC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,OAAO,EAAgB,MAAM,UAAU,CAAC;AACjD,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,UAAU,GAQX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,0BAA0B,GAG3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAwC,MAAM,aAAa,CAAC;AACvF,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,uBAAuB,GAIxB,MAAM,WAAW,CAAC"}

package/dist/key.d.ts

@@ -0,0 +1,31 @@
+import { type Handle } from "./binding.js";
+/** A crypto profile: "pq_hybrid" (the fleet's) or "pq_pure". */
+export type Profile = "pq_hybrid" | "pq_pure";
+export declare class NodeKey {
+    private handle;
+    private constructor();
+    /** A new key whose node_id solves the admission puzzle; takes a second or
+     * so, off the event loop. */
+    static generate(profile?: Profile): Promise<NodeKey>;
+    /** The key in the key file at path. A file its group or others can read,
+     * or holding a key of another profile, is refused. */
+    static load(path: string, profile?: Profile): Promise<NodeKey>;
+    /** The key at path, or a new one saved there when the file does not exist. */
+    static loadOrCreate(path: string, profile?: Profile): Promise<NodeKey>;
+    /** Writes the key to path, readable by its owner only. */
+    save(path: string): Promise<void>;
+    /** The key's 32-byte node_id. */
+    nodeId(): Uint8Array;
+    /** The node_id as lowercase hex. */
+    nodeIdHex(): string;
+    /** The public key as carried on the wire. */
+    publicKey(): Uint8Array;
+    /** The key's profile. */
+    profile(): Profile;
+    /** Signs data as given. */
+    sign(data: Uint8Array): Promise<Uint8Array>;
+    /** Frees the native key. The NodeKey is unusable after. */
+    free(): void;
+    /** @internal */
+    live(): Handle;
+}

package/dist/key.js

@@ -0,0 +1,72 @@
+// A node's identity key, as macula 12 has it: ML-DSA-87 (pq_pure) or the LAMPS
+// composite ML-DSA-87 + RSA-4096-PSS (pq_hybrid, the fleet's profile), whose
+// node_id solves the admission puzzle. Stored in a key file readable by its
+// owner only.
+import { access } from "node:fs/promises";
+import { native } from "./binding.js";
+import { hex } from "./wire.js";
+export class NodeKey {
+    handle;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    /** A new key whose node_id solves the admission puzzle; takes a second or
+     * so, off the event loop. */
+    static async generate(profile = "pq_hybrid") {
+        return new NodeKey(await native.keyGenerate(profile));
+    }
+    /** The key in the key file at path. A file its group or others can read,
+     * or holding a key of another profile, is refused. */
+    static async load(path, profile = "pq_hybrid") {
+        return new NodeKey(await native.keyLoad(path, profile));
+    }
+    /** The key at path, or a new one saved there when the file does not exist. */
+    static async loadOrCreate(path, profile = "pq_hybrid") {
+        try {
+            await access(path);
+        }
+        catch {
+            const key = await NodeKey.generate(profile);
+            await key.save(path);
+            return key;
+        }
+        return NodeKey.load(path, profile);
+    }
+    /** Writes the key to path, readable by its owner only. */
+    async save(path) {
+        await native.keySave(this.live(), path);
+    }
+    /** The key's 32-byte node_id. */
+    nodeId() {
+        return native.keyNodeId(this.live());
+    }
+    /** The node_id as lowercase hex. */
+    nodeIdHex() {
+        return hex(this.nodeId());
+    }
+    /** The public key as carried on the wire. */
+    publicKey() {
+        return native.keyPublicKey(this.live());
+    }
+    /** The key's profile. */
+    profile() {
+        return native.keyProfile(this.live());
+    }
+    /** Signs data as given. */
+    async sign(data) {
+        return native.keySign(this.live(), data);
+    }
+    /** Frees the native key. The NodeKey is unusable after. */
+    free() {
+        if (this.handle !== null)
+            native.keyFree(this.handle);
+        this.handle = null;
+    }
+    /** @internal */
+    live() {
+        if (this.handle === null)
+            throw new Error("macula-ts: this NodeKey was freed");
+        return this.handle;
+    }
+}
+//# sourceMappingURL=key.js.map

package/dist/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../src/key.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,cAAc;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAe,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAKhC,MAAM,OAAO,OAAO;IACU,MAAM;IAAlC,YAA4B,MAAqB;sBAArB,MAAM;IAAkB,CAAC;IAErD;iCAC6B;IAC7B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAY,WAAW;QAClD,OAAO,IAAI,OAAO,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;0DACsD;IACtD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAAO,GAAY,WAAW;QAC5D,OAAO,IAAI,OAAO,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,8EAA8E;IAC9E,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,OAAO,GAAY,WAAW;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,iCAAiC;IACjC,MAAM;QACJ,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,oCAAoC;IACpC,SAAS;QACP,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,6CAA6C;IAC7C,SAAS;QACP,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,yBAAyB;IACzB,OAAO;QACL,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAY,CAAC;IACnD,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,IAAI,CAAC,IAAgB;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,2DAA2D;IAC3D,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,gBAAgB;IAChB,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}