@macula-io/ts 0.17.0 → 0.18.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,CA2CvD,CAAC"}

package/dist/content.js

@@ -1,12 +1,13 @@
 // 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).
+// Go side), NOT the shared control stream call()/serve()/the DHT
+// methods/subscribe() all read from -- see cabi/content.go's own doc
+// for why Session.putContent()/getContent() (session.ts) are, unlike
+// those, never subject to Session's same-Session exclusivity guard, 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

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,kEAAkE;AAClE,mEAAmE;AACnE,sEAAsE;AACtE,iEAAiE;AACjE,qEAAqE;AACrE,qEAAqE;AACrE,wEAAwE;AACxE,oEAAoE;AACpE,kEAAkE;AAClE,WAAW;AACX,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"}

package/dist/directdial.d.ts

@@ -62,9 +62,9 @@ export interface KeepAdvertisedDirectOptions extends AdvertiseDirectOptions {
  * long-lived provider needs to call `AdvertiseDirect` again on its own
  * schedule, and it is this function's CALLER's job to decide WHICH
  * Session that runs on. See `Session.advertiseDirect()`'s own doc for why
- * that must NOT be a Session with an active `serve()` on it (a Session
- * takes one role at a time, and `advertiseDirect()`'s own `PutRecord` is a
- * CALL): a long-lived provider that
+ * that must NOT be a Session with an active `serve()` on it
+ * (`advertiseDirect()`'s own `PutRecord` CALL would race `serve()`'s own
+ * reads of the same shared control stream): a long-lived provider that
  * also serves `procedure` needs a SEPARATE Session (and identity -- this
  * fleet enforces one connection per identity, kicking whichever connects
  * second) for that, passed here instead of the serving Session.

package/dist/directdial.js

@@ -37,9 +37,9 @@ export const KEEP_ADVERTISED_DIRECT_INTERVAL_MS = 15 * 60 * 1000;
  * long-lived provider needs to call `AdvertiseDirect` again on its own
  * schedule, and it is this function's CALLER's job to decide WHICH
  * Session that runs on. See `Session.advertiseDirect()`'s own doc for why
- * that must NOT be a Session with an active `serve()` on it (a Session
- * takes one role at a time, and `advertiseDirect()`'s own `PutRecord` is a
- * CALL): a long-lived provider that
+ * that must NOT be a Session with an active `serve()` on it
+ * (`advertiseDirect()`'s own `PutRecord` CALL would race `serve()`'s own
+ * reads of the same shared control stream): a long-lived provider that
  * also serves `procedure` needs a SEPARATE Session (and identity -- this
  * fleet enforces one connection per identity, kicking whichever connects
  * second) for that, passed here instead of the serving Session.

package/dist/index.d.ts

@@ -1,9 +1,4 @@
-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 { 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,6 @@
-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 { 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,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"}