@layr8/sdk 0.1.0

package/dist/client.js

@@ -0,0 +1,509 @@
+import { EventEmitter } from "node:events";
+import { resolveConfig } from "./config.js";
+import { AlreadyConnectedError, ClientClosedError, ErrorKind, NotConnectedError, ProblemReportError, SDKError, ServerRejectError, } from "./errors.js";
+import { HandlerRegistry, PASS } from "./handler.js";
+import { generateId, marshalDIDComm, parseDIDComm, } from "./message.js";
+import { PhoenixChannel } from "./channel.js";
+import { RestClient, restUrlFromWebSocket } from "./rest.js";
+function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+/**
+ * Layr8Client is the main entry point for interacting with the Layr8 platform.
+ *
+ * Lifecycle: new Layr8Client → handle (register handlers) → connect → ... → close
+ *
+ * Extends EventEmitter for "disconnect" and "reconnect" events.
+ */
+export class Layr8Client extends EventEmitter {
+    cfg;
+    onError;
+    registry = new HandlerRegistry();
+    channel = null;
+    connected = false;
+    isClosed = false;
+    agentDid;
+    rest;
+    /** Correlation map for Request/Response pattern: threadId → {resolve, reject} */
+    pending = new Map();
+    constructor(onError, cfg = {}) {
+        super();
+        if (typeof onError !== "function") {
+            throw new TypeError("ErrorHandler is required: pass logErrors() or a custom (error: SDKError) => void");
+        }
+        this.onError = onError;
+        this.cfg = resolveConfig(cfg);
+        this.agentDid = this.cfg.agentDid;
+        this.rest = new RestClient(restUrlFromWebSocket(this.cfg.nodeUrl), this.cfg.apiKey);
+    }
+    /** The agent's DID — either provided in Config or assigned by the node on connect(). */
+    get did() {
+        return this.agentDid;
+    }
+    /**
+     * Register a handler for a DIDComm message type.
+     * Must be called BEFORE connect(). Throws AlreadyConnectedError after.
+     */
+    handle(msgType, fn, opts) {
+        if (this.connected) {
+            throw new AlreadyConnectedError();
+        }
+        this.registry.register(msgType, fn, opts);
+    }
+    /**
+     * Register a catch-all handler for any message type not matched by a specific handler.
+     * Must be called BEFORE connect(). Throws AlreadyConnectedError after.
+     */
+    handleAll(fn, opts) {
+        if (this.connected) {
+            throw new AlreadyConnectedError();
+        }
+        this.registry.registerCatchAll(fn, opts);
+    }
+    /**
+     * EventEmitter.emit() is synchronous and propagates listener exceptions.
+     * For SDK-internal events that fire on hot paths (inbound dispatch,
+     * outbound send), a throwing listener must NOT break the path — otherwise
+     * a pending request() can hang indefinitely. Route any throw to onError.
+     */
+    safeEmit(event, msg) {
+        try {
+            this.emit(event, msg);
+        }
+        catch (err) {
+            this.onError(new SDKError(ErrorKind.HandlerException, {
+                messageId: msg.id,
+                type: msg.type,
+                from: msg.from,
+                cause: err instanceof Error ? err : new Error(String(err)),
+            }));
+        }
+    }
+    /**
+     * Establish WebSocket connection and join the Phoenix Channel
+     * with protocols derived from registered handlers.
+     */
+    async connect(signal) {
+        if (this.connected)
+            throw new AlreadyConnectedError();
+        if (this.isClosed)
+            throw new ClientClosedError();
+        const protocols = this.registry.protocols();
+        // Always subscribe to the problem-report protocol so nodes can deliver
+        // problem reports back to us (e.g., when B is disconnected or passes).
+        const PROBLEM_REPORT_PROTOCOL = "https://didcomm.org/report-problem/2.0";
+        if (!protocols.includes("*") && !protocols.includes(PROBLEM_REPORT_PROTOCOL)) {
+            protocols.push(PROBLEM_REPORT_PROTOCOL);
+        }
+        const channel = new PhoenixChannel(this.cfg.nodeUrl, this.cfg.apiKey, this.cfg.agentDid, {
+            onMessage: (payload) => this.handleInboundMessage(payload),
+            onDisconnect: (err) => this.emit("disconnect", err),
+            onReconnect: () => this.emit("reconnect"),
+        }, this.cfg.didSpec);
+        await channel.connect(protocols, signal);
+        // If no DID was provided, use the one assigned by the node
+        if (!this.agentDid && channel.assignedDID()) {
+            this.agentDid = channel.assignedDID();
+        }
+        this.channel = channel;
+        this.connected = true;
+    }
+    /** Gracefully shut down the client connection. */
+    async close() {
+        if (this.isClosed)
+            return;
+        this.isClosed = true;
+        this.connected = false;
+        if (this.channel) {
+            this.channel.close();
+            this.channel = null;
+        }
+        // Reject all pending requests
+        for (const [threadId, pending] of this.pending) {
+            pending.reject(new ClientClosedError());
+            this.pending.delete(threadId);
+        }
+    }
+    /**
+     * Send a message. By default waits for server acknowledgment.
+     * Pass `{ fireAndForget: true }` to skip waiting for the server reply.
+     */
+    async send(msg, opts) {
+        if (!this.connected || !this.channel) {
+            throw new NotConnectedError();
+        }
+        const internal = this.fillMessage(msg);
+        if (opts?.fireAndForget) {
+            this.sendMessageFireAndForget(internal);
+            return;
+        }
+        await this.sendMessageAcked(internal);
+    }
+    /**
+     * Send a message and wait for a correlated response.
+     * Throws on timeout (AbortSignal), ProblemReportError, or NotConnectedError.
+     */
+    async request(msg, opts) {
+        if (!this.connected || !this.channel) {
+            throw new NotConnectedError();
+        }
+        const internal = this.fillMessage(msg);
+        if (!internal.threadId) {
+            internal.threadId = generateId();
+        }
+        if (opts?.parentThread) {
+            internal.parentThreadId = opts.parentThread;
+        }
+        return new Promise((resolve, reject) => {
+            const signal = opts?.signal;
+            if (signal?.aborted) {
+                reject(signal.reason ?? new Error("aborted"));
+                return;
+            }
+            const cleanup = () => {
+                this.pending.delete(internal.threadId);
+                signal?.removeEventListener("abort", onAbort);
+            };
+            const onAbort = () => {
+                cleanup();
+                reject(signal.reason ?? new Error("aborted"));
+            };
+            signal?.addEventListener("abort", onAbort, { once: true });
+            this.pending.set(internal.threadId, {
+                resolve: (resp) => {
+                    cleanup();
+                    // Check if response is a problem report
+                    if (resp.type ===
+                        "https://didcomm.org/report-problem/2.0/problem-report") {
+                        const body = ((resp.bodyRaw ?? resp.body) ?? {});
+                        const attachments = (resp.attachments ?? []);
+                        reject(new ProblemReportError(body?.code ?? "unknown", body?.comment ?? "unknown error", body, attachments));
+                        return;
+                    }
+                    resolve(resp);
+                },
+                reject: (err) => {
+                    cleanup();
+                    reject(err);
+                },
+            });
+            this.emit("outbound", internal);
+            this.channel.send("message", JSON.parse(marshalDIDComm(internal)))
+                .then((reply) => {
+                if (reply.status === "error") {
+                    cleanup();
+                    reject(new ServerRejectError(reply.reason || reply.status));
+                    return;
+                }
+                // Server accepted, keep waiting for DIDComm response
+            })
+                .catch((err) => {
+                cleanup();
+                reject(err);
+            });
+        });
+    }
+    // --- W3C Verifiable Credential APIs (REST, no WebSocket required) ---
+    /**
+     * Sign a W3C Verifiable Credential using the issuer's assertion key.
+     * Defaults: issuer = client.did, format = "compact_jwt".
+     */
+    async signCredential(credential, options) {
+        const body = {
+            credential,
+            issuer_did: options?.issuerDid ?? this.agentDid,
+            format: options?.format ?? "compact_jwt",
+        };
+        const result = await this.rest.post("/api/v1/credentials/sign", body);
+        return result.signed_credential;
+    }
+    /**
+     * Verify a signed credential using the verifier DID's assertion key.
+     * Defaults: verifier = client.did.
+     */
+    async verifyCredential(signedCredential, options) {
+        const body = {
+            signed_credential: signedCredential,
+            verifier_did: options?.verifierDid ?? this.agentDid,
+        };
+        return this.rest.post("/api/v1/credentials/verify", body);
+    }
+    /**
+     * Store a signed credential JWT for a holder.
+     * Defaults: holder = client.did.
+     */
+    async storeCredential(credentialJwt, options) {
+        const body = {
+            holder_did: options?.holderDid ?? this.agentDid,
+            credential_jwt: credentialJwt,
+        };
+        if (options?.issuerDid) {
+            body.issuer_did = options.issuerDid;
+        }
+        if (options?.validUntil) {
+            body.valid_until = options.validUntil.toISOString();
+        }
+        return this.rest.post("/api/v1/credentials", body);
+    }
+    /**
+     * List all stored credentials for a holder.
+     * Defaults: holder = client.did.
+     */
+    async listCredentials(options) {
+        const holderDid = options?.holderDid ?? this.agentDid;
+        const path = "/api/v1/credentials?holder_did=" + encodeURIComponent(holderDid);
+        const result = await this.rest.get(path);
+        return result.credentials;
+    }
+    /** Retrieve a stored credential by ID. */
+    async getCredential(credentialId) {
+        const path = "/api/v1/credentials/" + encodeURIComponent(credentialId);
+        return this.rest.get(path);
+    }
+    // --- W3C Verifiable Presentation APIs (REST, no WebSocket required) ---
+    /**
+     * Sign a W3C Verifiable Presentation wrapping one or more signed credentials.
+     * Uses the holder's authentication key (not assertion key).
+     * Defaults: holder = client.did, format = "compact_jwt".
+     */
+    async signPresentation(credentials, options) {
+        const body = {
+            credentials,
+            holder_did: options?.holderDid ?? this.agentDid,
+            format: options?.format ?? "compact_jwt",
+        };
+        if (options?.nonce) {
+            body.nonce = options.nonce;
+        }
+        const result = await this.rest.post("/api/v1/presentations/sign", body);
+        return result.signed_presentation;
+    }
+    /**
+     * Verify a signed presentation using the verifier DID's authentication key.
+     * Defaults: verifier = client.did.
+     */
+    async verifyPresentation(signedPresentation, options) {
+        const body = {
+            signed_presentation: signedPresentation,
+            verifier_did: options?.verifierDid ?? this.agentDid,
+        };
+        return this.rest.post("/api/v1/presentations/verify", body);
+    }
+    sendReplyMessage(resp, original) {
+        try {
+            const internal = this.fillMessage(resp);
+            if (!internal.to.length && original.from) {
+                internal.to = [original.from];
+            }
+            if (!internal.threadId) {
+                internal.threadId = original.threadId || original.id;
+            }
+            this.sendMessage(internal);
+        }
+        catch (err) {
+            this.onError(new SDKError(ErrorKind.TransportWrite, {
+                messageId: original.id,
+                type: original.type,
+                from: original.from,
+                cause: toError(err),
+            }));
+        }
+    }
+    handleInboundMessage(payload) {
+        let msg;
+        try {
+            msg = parseDIDComm(payload);
+        }
+        catch (err) {
+            this.onError(new SDKError(ErrorKind.ParseFailure, {
+                cause: toError(err),
+                raw: payload,
+            }));
+            return;
+        }
+        // Observability hook before dispatch — observers see every parsed message
+        // regardless of how it gets routed. A throwing listener must NOT break
+        // dispatch (e.g. cause a pending request() to hang).
+        this.safeEmit("inbound", msg);
+        // Check if this is a response to a pending Request (by thread ID).
+        // For most replies the responder reuses our thid → match by threadId.
+        // For DIDComm 2 problem-reports (and other corrective protocols) the
+        // responder typically sets pthid = our thid and starts a fresh thid
+        // for the report itself; match by parentThreadId in that case.
+        const matchKey = (msg.threadId && this.pending.has(msg.threadId)) ? msg.threadId :
+            (msg.parentThreadId && this.pending.has(msg.parentThreadId)) ? msg.parentThreadId :
+                undefined;
+        if (matchKey) {
+            const pending = this.pending.get(matchKey);
+            if (pending) {
+                this.pending.delete(matchKey);
+                // Send dispatch_reply so the node's PluginRouter doesn't time out
+                // Send dispatch_reply so the node's PluginRouter doesn't time out.
+                // Only when the node advertises reply_protocol — legacy nodes don't
+                // recognize the event and may drop the connection.
+                if (this.channel.replyProtocol()) {
+                    this.sendDispatchReply(msg.id, "handled");
+                }
+                pending.resolve(msg);
+                return;
+            }
+        }
+        const useReplyProtocol = this.channel.replyProtocol();
+        // Route to registered handler
+        const entry = this.registry.lookup(msg.type);
+        if (!entry) {
+            if (useReplyProtocol) {
+                this.sendDispatchReply(msg.id, "pass");
+            }
+            this.onError(new SDKError(ErrorKind.NoHandler, {
+                messageId: msg.id,
+                type: msg.type,
+                from: msg.from,
+            }));
+            return;
+        }
+        if (useReplyProtocol) {
+            // New mode: no ack, use dispatch_reply after handler
+            this.runHandlerWithReply(entry.fn, msg);
+        }
+        else {
+            // Legacy mode: ack before handler
+            if (!entry.manualAck) {
+                try {
+                    this.channel.sendAck([msg.id]);
+                }
+                catch {
+                    // Best-effort ack
+                }
+            }
+            else {
+                msg.ackFn = (id) => {
+                    this.channel.sendAck([id]);
+                };
+            }
+            this.runHandler(entry.fn, msg);
+        }
+    }
+    async runHandler(fn, msg) {
+        let resp;
+        try {
+            resp = await fn(msg);
+        }
+        catch (err) {
+            const error = toError(err);
+            this.onError(new SDKError(ErrorKind.HandlerException, {
+                messageId: msg.id,
+                type: msg.type,
+                from: msg.from,
+                cause: error,
+            }));
+            this.sendProblemReport(msg, error);
+            return;
+        }
+        if (resp && resp !== PASS) {
+            this.sendReplyMessage(resp, msg);
+        }
+    }
+    async runHandlerWithReply(fn, msg) {
+        let resp;
+        try {
+            resp = await fn(msg);
+        }
+        catch (err) {
+            const error = toError(err);
+            this.onError(new SDKError(ErrorKind.HandlerException, {
+                messageId: msg.id,
+                type: msg.type,
+                from: msg.from,
+                cause: error,
+            }));
+            this.sendDispatchReply(msg.id, "error", error.name, error.message);
+            return;
+        }
+        if (resp === PASS) {
+            this.sendDispatchReply(msg.id, "pass");
+            return;
+        }
+        // Send dispatch_reply BEFORE the response message. The node's channel
+        // processes WebSocket events sequentially; if the response targets a
+        // remote node, the channel blocks during HTTP delivery. Sending
+        // dispatch_reply first ensures the PluginRouter's receive unblocks
+        // before that blocking send.
+        this.sendDispatchReply(msg.id, "handled");
+        if (resp) {
+            this.sendReplyMessage(resp, msg);
+        }
+    }
+    sendDispatchReply(messageId, status, code, message) {
+        try {
+            const payload = { message_id: messageId, status };
+            if (code)
+                payload.code = code;
+            if (message)
+                payload.message = message;
+            this.channel.sendFireAndForget("dispatch_reply", payload);
+        }
+        catch {
+            // Best-effort
+        }
+    }
+    sendProblemReport(original, err) {
+        try {
+            const threadId = original.threadId || original.id;
+            const report = {
+                id: generateId(),
+                type: "https://didcomm.org/report-problem/2.0/problem-report",
+                from: this.agentDid,
+                to: original.from ? [original.from] : [],
+                threadId,
+                parentThreadId: "",
+                body: {
+                    code: "e.p.xfer.cant-process",
+                    comment: err.message,
+                },
+            };
+            this.sendMessage(report);
+        }
+        catch {
+            // Best-effort: if we can't send the problem report (e.g., connection
+            // lost), swallow the error to avoid masking the original handler failure.
+        }
+    }
+    fillMessage(msg) {
+        return {
+            id: msg.id || generateId(),
+            type: msg.type || "",
+            from: msg.from || this.agentDid,
+            to: msg.to || [],
+            threadId: msg.threadId || "",
+            parentThreadId: msg.parentThreadId || "",
+            body: msg.body ?? null,
+            ...(msg.attachments ? { attachments: msg.attachments } : {}),
+        };
+    }
+    async sendMessageAcked(msg) {
+        if (!this.channel)
+            throw new NotConnectedError();
+        const data = marshalDIDComm(msg);
+        this.safeEmit("outbound", msg);
+        const reply = await this.channel.send("message", JSON.parse(data));
+        if (reply.status === "error") {
+            throw new ServerRejectError(reply.reason || reply.status);
+        }
+    }
+    sendMessageFireAndForget(msg) {
+        if (!this.channel)
+            throw new NotConnectedError();
+        const data = marshalDIDComm(msg);
+        this.safeEmit("outbound", msg);
+        this.channel.sendFireAndForget("message", JSON.parse(data));
+    }
+    sendMessage(msg) {
+        if (!this.channel)
+            throw new NotConnectedError();
+        const data = marshalDIDComm(msg);
+        this.safeEmit("outbound", msg);
+        this.channel.sendFireAndForget("message", JSON.parse(data));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,49 @@
+/** Verification method purpose for DID creation. */
+export interface VerificationMethod {
+    /** Key purpose: authentication, assertionMethod, keyAgreement, capabilityInvocation, capabilityDelegation. */
+    purpose: string;
+    /** Key type. Defaults based on purpose (e.g., Ed25519VerificationKey2020 for authentication). */
+    type?: string;
+    /** Curve for JsonWebKey2020: Ed25519, X25519, P-256, P-384, P-521, secp256k1. */
+    curve?: string;
+    /** Optional key ID. */
+    id?: string;
+}
+/** DID specification for the cloud-node join handshake. */
+export interface DidSpec {
+    /** How to handle DID creation: Create (create if not found), Require (must exist), Update (create or update). */
+    mode?: string;
+    /** Where to store the DID: persistent (database) or ephemeral (memory only). */
+    storage?: string;
+    /** Optional label for the DID. */
+    label?: string;
+    /** Optional type metadata (e.g., "plugin", "service"). */
+    type?: string;
+    /** Cryptographic verification methods to create. */
+    verificationMethods?: VerificationMethod[];
+    /** Optional controller DID for the created DID document. Defaults to the node DID. */
+    controller?: string;
+}
+/** Default DID specification matching the original hardcoded behavior. */
+export declare const DEFAULT_DID_SPEC: Required<DidSpec>;
+/** Configuration for a Layr8 client. */
+export interface Config {
+    /** WebSocket URL of the Layr8 cloud-node. Fallback: LAYR8_NODE_URL env. */
+    nodeUrl?: string;
+    /** Authentication key for the cloud-node. Fallback: LAYR8_API_KEY env. */
+    apiKey?: string;
+    /** DID identity of this agent. If empty, an ephemeral DID is created on connect(). Fallback: LAYR8_AGENT_DID env. */
+    agentDid?: string;
+    /** DID specification for the cloud-node join handshake. Merged with defaults. */
+    didSpec?: DidSpec;
+}
+/** Resolved configuration with required fields guaranteed present. */
+export interface ResolvedConfig {
+    nodeUrl: string;
+    apiKey: string;
+    agentDid: string;
+    didSpec: Required<DidSpec>;
+}
+/** Fills empty fields from environment variables and validates required fields. */
+export declare function resolveConfig(cfg: Config): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,8GAA8G;IAC9G,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,2DAA2D;AAC3D,MAAM,WAAW,OAAO;IACtB,iHAAiH;IACjH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAW9C,CAAC;AAEF,wCAAwC;AACxC,MAAM,WAAW,MAAM;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qHAAqH;IACrH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAkCzD"}

package/dist/config.js

@@ -0,0 +1,42 @@
+import { Layr8Error } from "./errors.js";
+/** Default DID specification matching the original hardcoded behavior. */
+export const DEFAULT_DID_SPEC = {
+    mode: "Create",
+    storage: "ephemeral",
+    label: "",
+    type: "plugin",
+    controller: "",
+    verificationMethods: [
+        { purpose: "authentication" },
+        { purpose: "assertionMethod" },
+        { purpose: "keyAgreement" },
+    ],
+};
+/** Fills empty fields from environment variables and validates required fields. */
+export function resolveConfig(cfg) {
+    const nodeUrl = cfg.nodeUrl || process.env.LAYR8_NODE_URL || "";
+    const apiKey = cfg.apiKey || process.env.LAYR8_API_KEY || "";
+    const agentDid = cfg.agentDid || process.env.LAYR8_AGENT_DID || "";
+    if (!nodeUrl) {
+        throw new Layr8Error("nodeUrl is required (set in Config or LAYR8_NODE_URL env)");
+    }
+    // Normalize HTTP(S) URLs to WebSocket scheme.
+    // In production, the /plugin_socket endpoint serves WebSocket over HTTPS.
+    let normalizedUrl = nodeUrl;
+    if (normalizedUrl.startsWith("https://")) {
+        normalizedUrl = "wss://" + normalizedUrl.slice("https://".length);
+    }
+    else if (normalizedUrl.startsWith("http://")) {
+        normalizedUrl = "ws://" + normalizedUrl.slice("http://".length);
+    }
+    if (!apiKey) {
+        throw new Layr8Error("apiKey is required (set in Config or LAYR8_API_KEY env)");
+    }
+    const didSpec = {
+        ...DEFAULT_DID_SPEC,
+        ...cfg.didSpec,
+        verificationMethods: cfg.didSpec?.verificationMethods ?? DEFAULT_DID_SPEC.verificationMethods,
+    };
+    return { nodeUrl: normalizedUrl, apiKey, agentDid, didSpec };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA8BzC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE;IACd,mBAAmB,EAAE;QACnB,EAAE,OAAO,EAAE,gBAAgB,EAAE;QAC7B,EAAE,OAAO,EAAE,iBAAiB,EAAE;QAC9B,EAAE,OAAO,EAAE,cAAc,EAAE;KAC5B;CACF,CAAC;AAsBF,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;IAEnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,0EAA0E;IAC1E,IAAI,aAAa,GAAG,OAAO,CAAC;IAC5B,IAAI,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACpE,CAAC;SAAM,IAAI,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,UAAU,CAClB,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAsB;QACjC,GAAG,gBAAgB;QACnB,GAAG,GAAG,CAAC,OAAO;QACd,mBAAmB,EACjB,GAAG,CAAC,OAAO,EAAE,mBAAmB,IAAI,gBAAgB,CAAC,mBAAmB;KAC3E,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC"}