@mailwoman/core 2.1.0 → 3.0.0

package/out/api/APIClient.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { type IRuntimeLogger } from "@mailwoman/core/logging";
+import { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse, type CreateAxiosDefaults } from "axios";
+import { type AxiosCacheInstance, type CacheAxiosResponse, type CacheOptions } from "axios-cache-interceptor";
+export type { IRuntimeLogger };
+/**
+ * Configuration for an API client.
+ */
+export interface APIClientConfig {
+    /**
+     * The logged display name of the API client.
+     */
+    displayName: string;
+    /**
+     * Options for caching responses.
+     */
+    caching?: CacheOptions;
+    /**
+     * How many requests to make per minute before enforcing a cooldown.
+     */
+    requestsPerMinute?: number;
+    /**
+     * Axios configuration.
+     */
+    axios?: CreateAxiosDefaults;
+}
+/**
+ * A base class for API clients used in Mailwoman, providing features like request cooldowns,
+ * response caching, and integrated logging.
+ */
+export declare class APIClient<C extends APIClientConfig = APIClientConfig> extends EventTarget implements AsyncDisposable {
+    #private;
+    readonly config: C;
+    get $cooldown(): Promise<void>;
+    /**
+     * The prefixed logger for the API client.
+     */
+    readonly logger: IRuntimeLogger;
+    /**
+     * The Axios instance for the API client.
+     */
+    readonly axios: AxiosInstance | AxiosCacheInstance;
+    constructor(config: C);
+    /**
+     * Perform a fetch operation using the API's Axios instance.
+     */
+    fetch: <T>(options: AxiosRequestConfig) => Promise<AxiosResponse<T>>;
+    protected setCooldown: (nextCooldown: number) => void;
+    protected updateCooldownAfterResponse: (response: CacheAxiosResponse | AxiosResponse) => CacheAxiosResponse | AxiosResponse<unknown, unknown>;
+    [Symbol.asyncDispose](): Promise<void>;
+    toString(): string;
+}
+//# sourceMappingURL=APIClient.d.ts.map

package/out/api/APIClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIClient.d.ts","sourceRoot":"","sources":["../../api/APIClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAc,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AACxH,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAEjB,MAAM,yBAAyB,CAAA;AAIhC,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAC3B;AAED;;;GAGG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,CAAE,SAAQ,WAAY,YAAW,eAAe;;IACjH,SAAgB,MAAM,EAAE,CAAC,CAAA;IAOzB,IAAW,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED;;OAEG;IACH,SAAgB,MAAM,EAAE,cAAc,CAAA;IACtC;;OAEG;IACH,SAAgB,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAAA;gBAE7C,MAAM,EAAE,CAAC;IAyCrB;;OAEG;IACI,KAAK,GAAU,CAAC,EAAE,SAAS,kBAAkB,KAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAM/E;IAED,SAAS,CAAC,WAAW,GAAI,cAAc,MAAM,KAAG,IAAI,CAYnD;IAED,SAAS,CAAC,2BAA2B,GACpC,UAAU,kBAAkB,GAAG,aAAa,KAC1C,kBAAkB,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAkBtD;IAEY,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC,QAAQ;CAGxB"}

package/out/api/APIClient.js

@@ -0,0 +1,108 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { ConsoleLogger } from "@mailwoman/core/logging";
+import Axios, {} from "axios";
+import { setupCache, } from "axios-cache-interceptor";
+import { ServiceSymbol } from "../lifecycle/ServiceSymbol.js";
+import { delegateAxiosError } from "./responses.js";
+/**
+ * A base class for API clients used in Mailwoman, providing features like request cooldowns,
+ * response caching, and integrated logging.
+ */
+export class APIClient extends EventTarget {
+    config;
+    #cooldownWithResolvers = null;
+    #requestInterval = 0;
+    #requestCountWithinCooldown = 0;
+    #lastRequestTime = 0;
+    get $cooldown() {
+        return this.#cooldownWithResolvers?.promise || Promise.resolve();
+    }
+    /**
+     * The prefixed logger for the API client.
+     */
+    logger;
+    /**
+     * The Axios instance for the API client.
+     */
+    axios;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.logger = ConsoleLogger.prefix(config.displayName);
+        const axiosInstance = Axios.create({
+            ...config.axios,
+        });
+        if (config.caching) {
+            this.axios = setupCache(axiosInstance, {
+                debug: (msg) => {
+                    this.logger.info(msg);
+                },
+                ttl: 60 * 60 * 1000, // 1 hour
+                ...config.caching,
+            });
+        }
+        else {
+            this.axios = axiosInstance;
+        }
+        this.axios.interceptors.response.use((response) => {
+            const cachedLabel = response.cached ? " (cached)" : "(uncached)";
+            this.logger.debug(`${response.status} ${cachedLabel} ${response.config.method?.toUpperCase()}: ${response.config.url}`);
+            return response;
+        });
+        this.axios.interceptors.response.use(undefined, delegateAxiosError);
+        this.#requestInterval = typeof config.requestsPerMinute === "number" ? 60000 / config.requestsPerMinute : 0;
+        if (this.#requestInterval) {
+            this.axios.interceptors.response.use(this.updateCooldownAfterResponse);
+        }
+    }
+    /**
+     * Perform a fetch operation using the API's Axios instance.
+     */
+    fetch = async (options) => {
+        await this.$cooldown;
+        const method = options.method?.toUpperCase() || "GET";
+        this.logger.debug(`${method}: ${options.url}`);
+        return this.axios(options);
+    };
+    setCooldown = (nextCooldown) => {
+        const nextCooldownWithResolvers = Promise.withResolvers();
+        setTimeout(() => {
+            this.#requestCountWithinCooldown = 0;
+            nextCooldownWithResolvers.resolve();
+            this.dispatchEvent(new Event("cooldown_end"));
+        }, nextCooldown);
+        this.#cooldownWithResolvers = nextCooldownWithResolvers;
+        this.dispatchEvent(new Event("cooldown_start"));
+    };
+    updateCooldownAfterResponse = (response) => {
+        this.#cooldownWithResolvers?.resolve();
+        const now = Date.now();
+        const previousRequestTime = this.#lastRequestTime;
+        this.#lastRequestTime = now;
+        if (!this.config.requestsPerMinute)
+            return response;
+        this.#requestCountWithinCooldown++;
+        const elapsed = now - previousRequestTime;
+        const cooldown = this.#requestInterval - elapsed;
+        if (this.#requestCountWithinCooldown >= this.config.requestsPerMinute) {
+            this.setCooldown(cooldown);
+        }
+        return response;
+    };
+    async [Symbol.asyncDispose]() {
+        this.#cooldownWithResolvers?.resolve();
+        const storedCache = this.config.caching?.storage;
+        if (ServiceSymbol.isAsyncDisposable(storedCache)) {
+            await storedCache[Symbol.asyncDispose]();
+        }
+        return Promise.resolve();
+    }
+    toString() {
+        return `${this.config.displayName} API Client`;
+    }
+}
+//# sourceMappingURL=APIClient.js.map

package/out/api/APIClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIClient.js","sourceRoot":"","sources":["../../api/APIClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAuB,MAAM,yBAAyB,CAAA;AAC5E,OAAO,KAAK,EAAE,EAA6F,MAAM,OAAO,CAAA;AACxH,OAAO,EAIN,UAAU,GACV,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AA6BnD;;;GAGG;AACH,MAAM,OAAO,SAAuD,SAAQ,WAAW;IACtE,MAAM,CAAG;IAEzB,sBAAsB,GAAsC,IAAI,CAAA;IAChE,gBAAgB,GAAG,CAAC,CAAA;IACpB,2BAA2B,GAAG,CAAC,CAAA;IAC/B,gBAAgB,GAAG,CAAC,CAAA;IAEpB,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,sBAAsB,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;IACjE,CAAC;IAED;;OAEG;IACa,MAAM,CAAgB;IACtC;;OAEG;IACa,KAAK,CAAoC;IAEzD,YAAY,MAAS;QACpB,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QAEtD,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;YAClC,GAAG,MAAM,CAAC,KAAK;SACf,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,aAAa,EAAE;gBACtC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;oBACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtB,CAAC;gBACD,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;gBAC9B,GAAG,MAAM,CAAC,OAAO;aACjB,CAAC,CAAA;QACH,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,aAAa,CAAA;QAC3B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,QAA4C,EAAE,EAAE;YACrF,MAAM,WAAW,GAAI,QAA+B,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAA;YAExF,IAAI,CAAC,MAAM,CAAC,KAAK,CAChB,GAAG,QAAQ,CAAC,MAAM,IAAI,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CACpG,CAAA;YAED,OAAO,QAAQ,CAAA;QAChB,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;QAEnE,IAAI,CAAC,gBAAgB,GAAG,OAAO,MAAM,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;QAE3G,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACvE,CAAC;IACF,CAAC;IAED;;OAEG;IACI,KAAK,GAAG,KAAK,EAAK,OAA2B,EAA6B,EAAE;QAClF,MAAM,IAAI,CAAC,SAAS,CAAA;QAEpB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAA;QACrD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC3B,CAAC,CAAA;IAES,WAAW,GAAG,CAAC,YAAoB,EAAQ,EAAE;QACtD,MAAM,yBAAyB,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAA;QAE/D,UAAU,CAAC,GAAG,EAAE;YACf,IAAI,CAAC,2BAA2B,GAAG,CAAC,CAAA;YACpC,yBAAyB,CAAC,OAAO,EAAE,CAAA;YAEnC,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAA;QAC9C,CAAC,EAAE,YAAY,CAAC,CAAA;QAEhB,IAAI,CAAC,sBAAsB,GAAG,yBAAyB,CAAA;QACvD,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAChD,CAAC,CAAA;IAES,2BAA2B,GAAG,CACvC,QAA4C,EACW,EAAE;QACzD,IAAI,CAAC,sBAAsB,EAAE,OAAO,EAAE,CAAA;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,CAAA;QACjD,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAA;QAE3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB;YAAE,OAAO,QAAQ,CAAA;QAEnD,IAAI,CAAC,2BAA2B,EAAE,CAAA;QAElC,MAAM,OAAO,GAAG,GAAG,GAAG,mBAAmB,CAAA;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAA;QAEhD,IAAI,IAAI,CAAC,2BAA2B,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACvE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAC3B,CAAC;QAED,OAAO,QAAQ,CAAA;IAChB,CAAC,CAAA;IAEM,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACjC,IAAI,CAAC,sBAAsB,EAAE,OAAO,EAAE,CAAA;QAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAA;QAEhD,IAAI,aAAa,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,MAAM,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;QACzC,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IACzB,CAAC;IAEe,QAAQ;QACvB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,aAAa,CAAA;IAC/C,CAAC;CACD"}

package/out/api/headless.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Headless browser utilities.
+ */
+/**
+ * Common user agent strings.
+ */
+export declare enum UserAgent {
+    /**
+     * IPad OS 13.0 Safari.
+     */
+    iPadSafari = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0 Safari/605.1.15"
+}
+//# sourceMappingURL=headless.d.ts.map

package/out/api/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../api/headless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACpB;;OAEG;IACH,UAAU,wHAAwH;CAClI"}

package/out/api/headless.js

@@ -0,0 +1,18 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Headless browser utilities.
+ */
+/**
+ * Common user agent strings.
+ */
+export var UserAgent;
+(function (UserAgent) {
+    /**
+     * IPad OS 13.0 Safari.
+     */
+    UserAgent["iPadSafari"] = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0 Safari/605.1.15";
+})(UserAgent || (UserAgent = {}));
+//# sourceMappingURL=headless.js.map

package/out/api/headless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.js","sourceRoot":"","sources":["../../api/headless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACpB;;OAEG;IACH,+IAAkI,CAAA;AACnI,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}

package/out/api/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Core API utilities.
+ */
+export * from "./APIClient.js";
+export * from "./headless.js";
+export * from "./responses.js";
+//# sourceMappingURL=index.d.ts.map

package/out/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../api/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA"}

package/out/api/index.js

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Core API utilities.
+ */
+export * from "./APIClient.js";
+export * from "./headless.js";
+export * from "./responses.js";
+//# sourceMappingURL=index.js.map

package/out/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../api/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA"}

package/out/api/responses.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   API response utilities.
+ */
+/**
+ * A response container, wrapping the actual response body.
+ */
+export interface ResponseContainer<Body> {
+    data: Body;
+}
+export type ResponseLike<Body> = ResponseContainer<Body> | Body;
+/**
+ * Type-helper to pluck the response body, possibly from within an Axios response.
+ *
+ * This is useful when normalizing a new Axios response and a cached local response.
+ *
+ * @internal
+ */
+export type ExtractResponseData<T> = T extends ResponseContainer<infer Body> ? Body : T;
+/**
+ * Type-helper to recursively pluck the `data` property from a response body.
+ *
+ * This is useful when an API nests the actual response body within a `data` property.
+ *
+ * @internal
+ */
+export type ExtractResponseBodyData<Body> = Body extends {
+    data: infer Data;
+} ? ExtractResponseBodyData<Data> : Body;
+/**
+ * Helper function to recursively pluck the `data` property from a response body.
+ *
+ * This is useful when an API nests the actual response body within a `data` property.
+ *
+ * @internal
+ */
+export declare function pluckResponseData<Body>(responseContainer: ResponseContainer<Body>): ExtractResponseBodyData<Body>;
+export declare function checkConnectivity(connectivityURL?: URL | string): Promise<boolean>;
+/**
+ * Delegate Axios errors to an appropriate error handler.
+ *
+ * @internal
+ */
+export declare function delegateAxiosError(error: unknown): Promise<unknown>;
+//# sourceMappingURL=responses.d.ts.map

package/out/api/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../api/responses.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,IAAI;IACtC,IAAI,EAAE,IAAI,CAAA;CACV;AAED,MAAM,MAAM,YAAY,CAAC,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,iBAAiB,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAA;AAmBvF;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,CAAC,IAAI,IAAI,IAAI,SAAS;IACxD,IAAI,EAAE,MAAM,IAAI,CAAA;CAChB,GACE,uBAAuB,CAAC,IAAI,CAAC,GAC7B,IAAI,CAAA;AAEP;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;AASlH,wBAAgB,iBAAiB,CAChC,eAAe,GAAE,GAAG,GAAG,MAA6D,GAClF,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA0CzE"}

package/out/api/responses.js

@@ -0,0 +1,68 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   API response utilities.
+ */
+import { AxiosError, HttpStatusCode, isAxiosError } from "axios";
+import { ResourceError } from "../errors/schema.js";
+import { ConsoleLogger } from "../logging/index.js";
+function isResponseContainer(input) {
+    return typeof input === "object" && input !== null && "data" in input;
+}
+function pluckResponseBody(input) {
+    if (isResponseContainer(input))
+        return input.data;
+    return input;
+}
+export function pluckResponseData(input) {
+    const body = pluckResponseBody(input);
+    if (isResponseContainer(body))
+        return pluckResponseData(body);
+    return body;
+}
+export function checkConnectivity(connectivityURL = "https://connectivitycheck.gstatic.com/generate_204") {
+    return fetch(connectivityURL, {
+        method: "HEAD",
+    })
+        .then((response) => response.ok)
+        .catch(() => false);
+}
+/**
+ * Delegate Axios errors to an appropriate error handler.
+ *
+ * @internal
+ */
+export async function delegateAxiosError(error) {
+    {
+        if (!isAxiosError(error))
+            return Promise.reject(error);
+        const { response, code: networkErrorCode } = error;
+        if (networkErrorCode === "ENOTFOUND") {
+            const internetReachable = await checkConnectivity();
+            if (!internetReachable)
+                throw ResourceError.from(500, "Could not reach host. Are we connected to the internet?", "axios", "network", "unreachable");
+        }
+        if (!response)
+            throw ResourceError.from(500, "Internal Server Error", "axios", "response", "missing");
+        if (response.status === HttpStatusCode.Unauthorized) {
+            throw ResourceError.from(401, "Unauthorized");
+        }
+        if (!networkErrorCode) {
+            throw ResourceError.from(500, "Internal Server Error", "axios", "code", "missing");
+        }
+        switch (networkErrorCode) {
+            case AxiosError.ERR_NETWORK:
+                throw ResourceError.from(503, "Service Unavailable");
+            case AxiosError.ERR_CANCELED:
+            case AxiosError.ECONNABORTED:
+            case AxiosError.ETIMEDOUT:
+                return Promise.resolve();
+            default:
+                ConsoleLogger.warn(`Unhandled network error: ${networkErrorCode}`);
+        }
+        return Promise.reject(error);
+    }
+}
+//# sourceMappingURL=responses.js.map

package/out/api/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../api/responses.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAsBnD,SAAS,mBAAmB,CAAO,KAAyB;IAC3D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAA;AACtE,CAAC;AAOD,SAAS,iBAAiB,CAAO,KAAqC;IACrE,IAAI,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAA;IAEjD,OAAO,KAAK,CAAA;AACb,CAAC;AAuBD,MAAM,UAAU,iBAAiB,CAAO,KAAqC;IAC5E,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAErC,IAAI,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAE7D,OAAO,IAAqC,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,kBAAgC,oDAAoD;IAEpF,OAAO,KAAK,CAAC,eAAe,EAAE;QAC7B,MAAM,EAAE,MAAM;KACd,CAAC;SACA,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;SAC/B,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc;IACtD,CAAC;QACA,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAEtD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAA;QAElD,IAAI,gBAAgB,KAAK,WAAW,EAAE,CAAC;YACtC,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,EAAE,CAAA;YAEnD,IAAI,CAAC,iBAAiB;gBACrB,MAAM,aAAa,CAAC,IAAI,CACvB,GAAG,EACH,yDAAyD,EACzD,OAAO,EACP,SAAS,EACT,aAAa,CACb,CAAA;QACH,CAAC;QAED,IAAI,CAAC,QAAQ;YAAE,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;QAErG,IAAI,QAAQ,CAAC,MAAM,KAAK,cAAc,CAAC,YAAY,EAAE,CAAC;YACrD,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;QAC9C,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvB,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QACnF,CAAC;QAED,QAAQ,gBAAgB,EAAE,CAAC;YAC1B,KAAK,UAAU,CAAC,WAAW;gBAC1B,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAA;YACrD,KAAK,UAAU,CAAC,YAAY,CAAC;YAC7B,KAAK,UAAU,CAAC,YAAY,CAAC;YAC7B,KAAK,UAAU,CAAC,SAAS;gBACxB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YACzB;gBACC,aAAa,CAAC,IAAI,CAAC,4BAA4B,gBAAgB,EAAE,CAAC,CAAA;QACpE,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;AACF,CAAC"}

package/out/collections.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Extracts the property keys of an object that are of type `number`.
+ */
+export type NumericProperties<T> = {
+    [K in keyof T]: T[K] extends number ? K : never;
+}[keyof T];
+/**
+ * Given an iterable of objects, returns the sum of the specified property.
+ */
+export declare function sumOf<T extends object>(iterable: Iterable<T>, prop: NumericProperties<T>): number;
+/**
+ * Given an iterable, returns an array of arrays of the specified size.
+ *
+ * This is useful for batching asynchronous operations.
+ *
+ * @param collection The collection to batch.
+ * @param batchSize The size of each batch.
+ *
+ * @returns An iterable of arrays of the specified size.
+ */
+export declare function take<T>(collection: Iterable<T>, batchSize: number): Iterable<T[]>;
+/**
+ * Convenience function to await an async iterable.
+ */
+export declare function iterateInParallel<T>(asyncIterable: AsyncIterable<T>): Promise<void>;
+/**
+ * Given an iterable of values, maps each value to a record of the value and the result of the
+ * callback.
+ *
+ * This is a convenience function when an iterable needs mapping to an object-like structure.
+ *
+ * @category Collections
+ * @category Object
+ */
+export declare function pivot<T extends PropertyKey, C extends (value: T) => Promise<unknown> | unknown>(
+/**
+ * The iterable to pivot.
+ */
+iterable: Iterable<T>, 
+/**
+ * The callback to transform each value.
+ */
+callback: C): ReturnType<C> extends PromiseLike<infer U> ? Promise<Record<T, U>> : Record<T, ReturnType<C>>;
+/**
+ * Type-predicate for checking if a value is iterable.
+ *
+ * @category Type Guard
+ * @category Object
+ */
+export declare function isIterable<T>(input: unknown): input is Iterable<T>;
+/**
+ * Iterable that can be checked for the existence of a member.
+ */
+export interface IndexedIterable<T = unknown> extends Iterable<T> {
+    has(value: T): boolean;
+}
+/**
+ * Type-predicate for checking if an member within an iterable can be checked for existence.
+ */
+export declare function isIndexedIterable<T>(value: Iterable<T>): value is IndexedIterable<T>;
+//# sourceMappingURL=collections.d.ts.map

package/out/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../collections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;KACjC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK;CAC/C,CAAC,MAAM,CAAC,CAAC,CAAA;AAEV;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,CAQjG;AAED;;;;;;;;;GASG;AACH,wBAAiB,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAgBlF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;AAC9F;;GAEG;AACH,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrB;;GAEG;AACH,QAAQ,EAAE,CAAC,GACT,UAAU,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CA6B/F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,CAElE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAChE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,eAAe,CAAC,CAAC,CAAC,CAEpF"}

package/out/collections.js

@@ -0,0 +1,97 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Given an iterable of objects, returns the sum of the specified property.
+ */
+export function sumOf(iterable, prop) {
+    let total = 0;
+    for (const item of iterable) {
+        total += item[prop];
+    }
+    return total;
+}
+/**
+ * Given an iterable, returns an array of arrays of the specified size.
+ *
+ * This is useful for batching asynchronous operations.
+ *
+ * @param collection The collection to batch.
+ * @param batchSize The size of each batch.
+ *
+ * @returns An iterable of arrays of the specified size.
+ */
+export function* take(collection, batchSize) {
+    const batch = [];
+    for (const item of collection) {
+        batch.push(item);
+        if (batch.length === batchSize) {
+            yield batch;
+            batch.length = 0;
+        }
+    }
+    if (batch.length > 0) {
+        yield batch;
+    }
+}
+/**
+ * Convenience function to await an async iterable.
+ */
+export async function iterateInParallel(asyncIterable) {
+    for await (const _ of asyncIterable) {
+        /* empty */
+    }
+}
+/**
+ * Given an iterable of values, maps each value to a record of the value and the result of the
+ * callback.
+ *
+ * This is a convenience function when an iterable needs mapping to an object-like structure.
+ *
+ * @category Collections
+ * @category Object
+ */
+export function pivot(
+/**
+ * The iterable to pivot.
+ */
+iterable, 
+/**
+ * The callback to transform each value.
+ */
+callback) {
+    const entries = [];
+    let foundThenable = false;
+    for (const value of iterable) {
+        const result = callback(value);
+        if (result && typeof result === "object" && "then" in result) {
+            foundThenable = true;
+        }
+        entries.push([value, result]);
+    }
+    if (foundThenable) {
+        return Promise.all(entries.map(([key, value]) => {
+            return Promise.resolve(value).then((resolvedValue) => [key, resolvedValue]);
+        })).then(Object.fromEntries);
+    }
+    const pivotedRecord = Object.fromEntries(entries);
+    return pivotedRecord;
+}
+/**
+ * Type-predicate for checking if a value is iterable.
+ *
+ * @category Type Guard
+ * @category Object
+ */
+export function isIterable(input) {
+    return Symbol.iterator in Object(input);
+}
+/**
+ * Type-predicate for checking if an member within an iterable can be checked for existence.
+ */
+export function isIndexedIterable(value) {
+    return value && typeof value.has === "function";
+}
+//# sourceMappingURL=collections.js.map

package/out/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../collections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,MAAM,UAAU,KAAK,CAAmB,QAAqB,EAAE,IAA0B;IACxF,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC7B,KAAK,IAAI,IAAI,CAAC,IAAI,CAAW,CAAA;IAC9B,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,SAAS,CAAC,CAAC,IAAI,CAAI,UAAuB,EAAE,SAAiB;IAClE,MAAM,KAAK,GAAQ,EAAE,CAAA;IAErB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,CAAA;YAEX,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QACjB,CAAC;IACF,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,CAAA;IACZ,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,aAA+B;IACzE,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QACrC,WAAW;IACZ,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,KAAK;AACpB;;GAEG;AACH,QAAqB;AACrB;;GAEG;AACH,QAAW;IAEX,MAAM,OAAO,GAA8B,EAAE,CAAA;IAC7C,IAAI,aAAa,GAAG,KAAK,CAAA;IAEzB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAE9B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC9D,aAAa,GAAG,IAAI,CAAA;QACrB,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAuB,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,GAAG,CACjB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAU,CAAC,CAAA;QACrF,CAAC,CAAC,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAEE,CAAA;IAC5B,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAEjD,OAAO,aAEoB,CAAA;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,KAAc;IAC3C,OAAO,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AASD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAAkB;IACtD,OAAO,KAAK,IAAI,OAAQ,KAAyB,CAAC,GAAG,KAAK,UAAU,CAAA;AACrE,CAAC"}

package/out/db/schema.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Shared `Database` typing for the Kysely client at `core/kysley/client.ts`.
+ *
+ *   This file intentionally ships an empty schema. Consumers that want compile-time table typing
+ *   should extend `Kysely<TheirSchema>` directly rather than baking a schema into core — the WOF
+ *   resolver (Phase 4.2), corpus adapters, and any future consumer all touch different tables.
+ *
+ *   The exported `Database` interface exists so `client.ts` has a target for `Kysely<Database>` and
+ *   the boilerplate compiles without forcing a concrete schema commitment.
+ */
+/**
+ * Empty schema marker. Consumers declare their own schema interface and pass it directly to `new
+ * Kysely<MySchema>({...})` or instantiate `new DatabaseClient<MySchema>(...)` once `DatabaseClient`
+ * becomes generic (Phase 4.2 work).
+ */
+export type Database = Record<string, never>;
+//# sourceMappingURL=schema.d.ts.map

package/out/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA"}

package/out/db/schema.js

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Shared `Database` typing for the Kysely client at `core/kysley/client.ts`.
+ *
+ *   This file intentionally ships an empty schema. Consumers that want compile-time table typing
+ *   should extend `Kysely<TheirSchema>` directly rather than baking a schema into core — the WOF
+ *   resolver (Phase 4.2), corpus adapters, and any future consumer all touch different tables.
+ *
+ *   The exported `Database` interface exists so `client.ts` has a target for `Kysely<Database>` and
+ *   the boilerplate compiles without forcing a concrete schema commitment.
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/out/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/out/decoder/build-tree.d.ts

@@ -21,11 +21,24 @@
  *   as attributes.
  */
 import type { AddressTree, DecoderToken } from "./types.js";
+/**
+ * Optional caller-supplied attribution stamped on every emitted node. The BIO stream comes from a
+ * single model, so there's no per-span variation — one source for the whole tree.
+ *
+ * Phase 4.3 may overlay a resolver-derived attribution per node on top of this baseline.
+ */
+export interface BuildTreeOpts {
+    source?: string;
+    sourceId?: string;
+}
 /**
  * Build an `AddressTree` from a raw input string and the token stream produced by the model.
  *
  * @param raw The original input as fed to the tokenizer.
  * @param tokens Model output: one entry per piece with predicted BIO label + confidence.
+ * @param opts Optional attribution stamped on every emitted node. Callers in the neural pipeline
+ *   pass `{ source: "neural", sourceId: <model-card-version> }` to mark provenance for the XML
+ *   serializer's `src` attribute.
  */
-export declare function buildAddressTree(raw: string, tokens: DecoderToken[]): AddressTree;
+export declare function buildAddressTree(raw: string, tokens: DecoderToken[], opts?: BuildTreeOpts): AddressTree;
 //# sourceMappingURL=build-tree.d.ts.map

package/out/decoder/build-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-tree.d.ts","sourceRoot":"","sources":["../../decoder/build-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAe,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAuExE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,CAYjF"}
+{"version":3,"file":"build-tree.d.ts","sourceRoot":"","sources":["../../decoder/build-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAe,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AA4FD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,WAAW,CAY3G"}