@octostar/platform-api 0.5.31 → 1.0.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -16,4 +16,5 @@ export * from './lib/ContextApiRegistry';
 export * from './lib/SearchQueryBuilder';
 export * from './lib/browserChannel';
 export * from './lib/ApiConfig';
+export * from './lib/RemoteDevManager';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/lib/AIClientImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIClientImpl.d.ts","sourceRoot":"","sources":["../../src/lib/AIClientImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAyBjH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,MAAM,CAA0B;gBAE5B,WAAW,EAAE,WAAW;IAI9B,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IASrC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CA+CvE"}
+{"version":3,"file":"AIClientImpl.d.ts","sourceRoot":"","sources":["../../src/lib/AIClientImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAyBjH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,MAAM,CAA0B;gBAE5B,WAAW,EAAE,WAAW;IAI9B,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IASrC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBvE"}

package/dist/lib/AIClientImpl.js

@@ -24,45 +24,22 @@ export class AIClientImpl {
         return this.models;
     }
     async prompt(prompt, options) {
-        const model = options?.model ?? (await this.getChatModels())[0]?.model_name;
-        const enableRag = options?.enableRag ?? true; // getPreference is not available to this package.
-        const contextEntities = options?.context ?? [];
-        const messages = contextEntities.length > 0
-            ? [
-                {
-                    role: 'user',
-                    type: 'add_entities',
-                    hasEntity: false,
-                    content: contextEntities.map(({ entity_id, entity_label, entity_type }) => ({
-                        entity_id,
-                        entity_label,
-                        entity_type,
-                    })),
-                    id: contextEntities[0].entity_id,
-                },
-            ]
-            : undefined;
-        // TODO: Streaming is not supported yet.
+        if (options?.context && options.context.length > 0) {
+            throw new Error('[AIClientImpl] options.context is not supported in completion mode. Call /api/v2/chat directly for context-bearing prompts.');
+        }
         const chatMessage = await this.osAPIClient.fetchData({
             endpoint: '/api/v1/chat',
             method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
+            headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({
-                model_name: model,
                 prompt,
-                api_key: options?.apiKey ?? '',
                 streaming: false,
-                enable_rag: enableRag,
-                cohere_key: options?.cohereKey ?? '',
+                execution_mode: 'completion',
                 temperature: typeof options?.temperature === 'number' ? options.temperature : undefined,
-                messages,
             }),
         });
         if (options?.noThink) {
-            const parsedResponse = extractThoughts(chatMessage.response.content);
-            return parsedResponse.content;
+            return extractThoughts(chatMessage.response.content).content;
         }
         return chatMessage.response.content;
     }

package/dist/lib/AIClientImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"AIClientImpl.js","sourceRoot":"","sources":["../../src/lib/AIClientImpl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AIClientImpl.js","sourceRoot":"","sources":["../../src/lib/AIClientImpl.ts"],"names":[],"mappings":"AAOA,SAAS,eAAe,CACtB,OAAe,EACf,YAA8B,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAE3D,IAAI,iBAAiB,GAAW,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxD,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,OAAO,eAAe,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,SAAS,CAAC,OAAO,IAAI,iBAAiB,CAAC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,OAAO,YAAY;IAKvB,YAAY,WAAwB;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAc;gBAC1D,QAAQ,EAAE,qBAAqB;aAChC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,OAAuB;QAClD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,6HAA6H,CAC9H,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAkB;YACpE,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM;gBACN,SAAS,EAAE,KAAK;gBAChB,cAAc,EAAE,YAAY;gBAC5B,WAAW,EAAE,OAAO,OAAO,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aACxF,CAAC;SACH,CAAC,CAAC;QACH,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;QAC/D,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;IACtC,CAAC;CACF"}

package/dist/lib/ApiConfig.d.ts

@@ -1,4 +1,26 @@
 import { type DeveloperSettings } from '@octostar/platform-types';
+/**
+ * Supported backend thumbnail rungs for `getEntityThumbnailUrl`. The server
+ * snaps any requested `max_width` UP to one of these and caches one object
+ * per rung, so request the rung you actually want — an arbitrary width below
+ * a rung just maps to that same rung's object.
+ */
+export declare const THUMBNAIL_WIDTHS: {
+    readonly SMALL: 512;
+    readonly LARGE: 2048;
+};
+/** The renderer also caps a thumbnail's height, at this multiple of its rung's width. */
+export declare const THUMBNAIL_MAX_HEIGHT_FACTOR = 4;
+/** True if `pathname` (or a path-only URL string) targets Octostar API attachment/image/source-bytes assets.
+ *
+ * `/files/source/bytes` is included so the navigation-fallback that strips
+ * scheme/host (and thus the auth headers attached at the SDK layer) does
+ * not silently apply to source-backed reads — same reasoning as the
+ * attachments path: cross-environment portability without auth loss. The v2
+ * entity attachment + thumbnail routes (`/api/v2/entities/.../attachment`) get
+ * the same treatment.
+ */
+export declare function isOctostarApiAssetPathname(pathname: string): boolean;
 /**
  * ApiConfig
  * A generic, synchronous store for developer settings and URL construction.
@@ -18,13 +40,45 @@ export declare const ApiConfig: {
      */
     isUsingDefaultApi(): boolean;
     /**
-     * Specifically handles the migrated attachment path.
+     * Specifically handles the migrated (v1) attachment path.
      * Usage: ApiConfig.getAttachmentUrl(attachmentId)
+     * Pass relative: true for path+query only (browser resolves against the current origin).
+     *
+     * For images/thumbnails prefer the v2 builders below
+     * (`getEntityAttachmentUrl` / `getEntityThumbnailUrl`).
      */
     getAttachmentUrl(path: string, options?: {
         content_type?: string;
         content_disposition?: "inline" | "attachment";
-        cb?: number;
+        relative?: boolean;
     }): string;
+    /**
+     * v2 entity attachment bytes: GET /api/v2/entities/{os_workspace}/{entity_uid}/attachment.
+     * Streams the original inline, resolving `osfs://` / `mntfs://` source-backed
+     * entities server-side. Use this for raw image/file reads; for previews use
+     * `getEntityThumbnailUrl`.
+     */
+    getEntityAttachmentUrl(osWorkspace: string, entityUid: string, options?: {
+        relative?: boolean;
+    }): string;
+    /**
+     * v2 backend-rendered thumbnail: GET .../attachment/_thumbnail?max_width=N&v=<token>.
+     * A downscaled WebP for images and PDF first pages; the backend snaps
+     * `max_width` to a fixed rung (512 / 2048) and 302-redirects to the original
+     * for non-thumbnailable content. Pass `v` (e.g. the entity's
+     * `os_last_updated_at`) to opt into long-lived immutable caching — the URL is
+     * then content-versioned, so a tile seen once never re-downloads or
+     * revalidates; omit it to revalidate.
+     */
+    getEntityThumbnailUrl(osWorkspace: string, entityUid: string, options: {
+        max_width: number;
+        v?: number | string;
+        relative?: boolean;
+    }): string;
+    /**
+     * Strip scheme/host for Octostar API asset URLs so they stay valid across environments.
+     * Leaves other URLs (e.g. CDN icons) unchanged.
+     */
+    toPortableAssetPath(url: string): string;
 };
 //# sourceMappingURL=ApiConfig.d.ts.map

package/dist/lib/ApiConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiConfig.d.ts","sourceRoot":"","sources":["../../src/lib/ApiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQlE;;;GAGG;AACH,eAAO,MAAM,SAAS;cAEJ,iBAAiB;IAEjC;;OAEG;qBACc,MAAM;IAcvB;;;;;;OAMG;yBACkB,OAAO;IAc5B;;;OAGG;2BAEK,MAAM,YACF;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9F,MAAM;CAaV,CAAC"}
+{"version":3,"file":"ApiConfig.d.ts","sourceRoot":"","sources":["../../src/lib/ApiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;CAAuC,CAAC;AAErE,yFAAyF;AACzF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOpE;AAQD;;;GAGG;AACH,eAAO,MAAM,SAAS;cAEJ,iBAAiB;IAEjC;;OAEG;qBACc,MAAM;IAcvB;;;;;;OAMG;yBACkB,OAAO;IAc5B;;;;;;;OAOG;2BAEK,MAAM,YACF;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,mBAAmB,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;QAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GACA,MAAM;IAoBT;;;;;OAKG;wCACiC,MAAM,aAAa,MAAM,YAAY;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;IASxG;;;;;;;;OAQG;uCAEY,MAAM,aACR,MAAM,WACR;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GACA,MAAM;IAmBT;;;OAGG;6BACsB,MAAM,GAAG,MAAM;CAezC,CAAC"}

package/dist/lib/ApiConfig.js

@@ -1,3 +1,27 @@
+/**
+ * Supported backend thumbnail rungs for `getEntityThumbnailUrl`. The server
+ * snaps any requested `max_width` UP to one of these and caches one object
+ * per rung, so request the rung you actually want — an arbitrary width below
+ * a rung just maps to that same rung's object.
+ */
+export const THUMBNAIL_WIDTHS = { SMALL: 512, LARGE: 2048 };
+/** The renderer also caps a thumbnail's height, at this multiple of its rung's width. */
+export const THUMBNAIL_MAX_HEIGHT_FACTOR = 4;
+/** True if `pathname` (or a path-only URL string) targets Octostar API attachment/image/source-bytes assets.
+ *
+ * `/files/source/bytes` is included so the navigation-fallback that strips
+ * scheme/host (and thus the auth headers attached at the SDK layer) does
+ * not silently apply to source-backed reads — same reasoning as the
+ * attachments path: cross-environment portability without auth loss. The v2
+ * entity attachment + thumbnail routes (`/api/v2/entities/.../attachment`) get
+ * the same treatment.
+ */
+export function isOctostarApiAssetPathname(pathname) {
+    return (pathname.includes('/api/v1/files/attachments') ||
+        pathname.includes('/api/v1/octostar/image/') ||
+        pathname.includes('/api/v1/files/source/bytes') ||
+        (pathname.includes('/api/v2/entities/') && pathname.includes('/attachment')));
+}
 // FIXME: TEAM-4235 To be removed when superset is gone.
 function getDefaultBaseUrl() {
     if (typeof window === 'undefined')
@@ -50,19 +74,92 @@ export const ApiConfig = {
         }
     },
     /**
-     * Specifically handles the migrated attachment path.
+     * Specifically handles the migrated (v1) attachment path.
      * Usage: ApiConfig.getAttachmentUrl(attachmentId)
+     * Pass relative: true for path+query only (browser resolves against the current origin).
+     *
+     * For images/thumbnails prefer the v2 builders below
+     * (`getEntityAttachmentUrl` / `getEntityThumbnailUrl`).
      */
     getAttachmentUrl(path, options) {
+        const { relative, ...queryFields } = options ?? {};
         const base = this.getApiBaseUrl().replace(/\/$/, '');
         const suffix = path.startsWith('/') ? path : `/${path}`;
         const query = new URLSearchParams();
         const url = `${base}/api/v1/files/attachments${suffix}`;
-        if (options) {
-            Object.keys(options).forEach(key => {
-                query.set(key, String(options[key]));
-            });
-            return `${url}?${query.toString()}`;
+        for (const key of Object.keys(queryFields)) {
+            const value = queryFields[key];
+            if (value !== undefined) {
+                query.set(key, String(value));
+            }
+        }
+        const full = query.toString() ? `${url}?${query.toString()}` : url;
+        if (relative) {
+            const { pathname, search } = new URL(full);
+            return `${pathname}${search}`;
+        }
+        return full;
+    },
+    /**
+     * v2 entity attachment bytes: GET /api/v2/entities/{os_workspace}/{entity_uid}/attachment.
+     * Streams the original inline, resolving `osfs://` / `mntfs://` source-backed
+     * entities server-side. Use this for raw image/file reads; for previews use
+     * `getEntityThumbnailUrl`.
+     */
+    getEntityAttachmentUrl(osWorkspace, entityUid, options) {
+        const base = this.getApiBaseUrl().replace(/\/$/, '');
+        const full = `${base}/api/v2/entities/${encodeURIComponent(osWorkspace)}/${encodeURIComponent(entityUid)}/attachment`;
+        if (options?.relative) {
+            return new URL(full).pathname;
+        }
+        return full;
+    },
+    /**
+     * v2 backend-rendered thumbnail: GET .../attachment/_thumbnail?max_width=N&v=<token>.
+     * A downscaled WebP for images and PDF first pages; the backend snaps
+     * `max_width` to a fixed rung (512 / 2048) and 302-redirects to the original
+     * for non-thumbnailable content. Pass `v` (e.g. the entity's
+     * `os_last_updated_at`) to opt into long-lived immutable caching — the URL is
+     * then content-versioned, so a tile seen once never re-downloads or
+     * revalidates; omit it to revalidate.
+     */
+    getEntityThumbnailUrl(osWorkspace, entityUid, options) {
+        const { relative, ...queryFields } = options;
+        const base = this.getApiBaseUrl().replace(/\/$/, '');
+        const url = `${base}/api/v2/entities/${encodeURIComponent(osWorkspace)}/${encodeURIComponent(entityUid)}/attachment/_thumbnail`;
+        const query = new URLSearchParams();
+        for (const key of Object.keys(queryFields)) {
+            const value = queryFields[key];
+            if (value !== undefined) {
+                query.set(key, String(value));
+            }
+        }
+        const full = `${url}?${query.toString()}`;
+        if (relative) {
+            const { pathname, search } = new URL(full);
+            return `${pathname}${search}`;
+        }
+        return full;
+    },
+    /**
+     * Strip scheme/host for Octostar API asset URLs so they stay valid across environments.
+     * Leaves other URLs (e.g. CDN icons) unchanged.
+     */
+    toPortableAssetPath(url) {
+        if (!url)
+            return url;
+        const t = url.trim();
+        if (t.startsWith('/'))
+            return t;
+        try {
+            const u = new URL(t);
+            const { pathname, search } = u;
+            if (isOctostarApiAssetPathname(pathname)) {
+                return `${pathname}${search}`;
+            }
+        }
+        catch {
+            /* ignore */
         }
         return url;
     },

package/dist/lib/ApiConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiConfig.js","sourceRoot":"","sources":["../../src/lib/ApiConfig.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,SAAS,iBAAiB;IACxB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,wDAAwD;IACxD,QAAQ,EAAE,EAAuB;IAEjC;;OAEG;IACH,aAAa;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC9B,2CAA2C;gBAC3C,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;YACvC,OAAO,GAAG,WAAW,CAAC,QAAQ,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,UAAU,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,gBAAgB,CACd,IAAY,EACZ,OAA+F;QAE/F,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,IAAI,4BAA4B,MAAM,EAAE,CAAC;QACxD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBACjC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAA2B,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}
+{"version":3,"file":"ApiConfig.js","sourceRoot":"","sources":["../../src/lib/ApiConfig.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAW,CAAC;AAErE,yFAAyF;AACzF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC9C,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC5C,QAAQ,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC/C,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,SAAS,iBAAiB;IACxB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,wDAAwD;IACxD,QAAQ,EAAE,EAAuB;IAEjC;;OAEG;IACH,aAAa;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC9B,2CAA2C;gBAC3C,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;YACvC,OAAO,GAAG,WAAW,CAAC,QAAQ,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,UAAU,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CACd,IAAY,EACZ,OAIC;QAED,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,IAAI,4BAA4B,MAAM,EAAE,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAoC,EAAE,CAAC;YAC9E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,WAAmB,EAAE,SAAiB,EAAE,OAAgC;QAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,GAAG,IAAI,oBAAoB,kBAAkB,CAAC,WAAW,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC,aAAa,CAAC;QACtH,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,qBAAqB,CACnB,WAAmB,EACnB,SAAiB,EACjB,OAIC;QAED,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,GAAG,IAAI,oBAAoB,kBAAkB,CAAC,WAAW,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC,wBAAwB,CAAC;QAChI,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAoC,EAAE,CAAC;YAC9E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,GAAW;QAC7B,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,CAAC;QACrB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;YAC/B,IAAI,0BAA0B,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzC,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/lib/AsyncServiceLocator.d.ts

@@ -1,9 +1,6 @@
 type DependencyFactoryGeneral = (locator: unknown) => Promise<any>;
 type DependencyFactory<T, S extends Record<string, DependencyFactoryGeneral>> = (locator: AsyncServiceLocator<S>) => Promise<T>;
 type GetServiceResult<T> = Promise<T extends (...args: any) => infer R ? Awaited<R> : never>;
-export interface ReadOnlyAsyncServiceLocator<T, I = T extends AsyncServiceLocator<infer S> ? S : never> {
-    getService: <K extends keyof I>(name: K) => GetServiceResult<I[K]>;
-}
 interface AsyncServiceLocatorOptions {
     cache: boolean;
 }

package/dist/lib/AsyncServiceLocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncServiceLocator.d.ts","sourceRoot":"","sources":["../../src/lib/AsyncServiceLocator.ts"],"names":[],"mappings":"AAAA,KAAK,wBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEnE,KAAK,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,IAAI,CAC9E,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,KAAK,gBAAgB,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AAE7F,MAAM,WAAW,2BAA2B,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,mBAAmB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;IACpG,UAAU,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,UAAU,0BAA0B;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,mBAAmB,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAE1F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAI;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,0BAA0B;IAMzF,MAAM,CAAC,SAAS,EAAE,MAAM,CACtB,MAAM,EACN,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,CACtG,CAAM;IAEP,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B;IAYnE,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,EACnE,IAAI,EAAE,CAAC,EACP,cAAc,EAAE,CAAC,GAChB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAWlC,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAChC,IAAI,EAAE,CAAC,GAEN,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAc1B"}
+{"version":3,"file":"AsyncServiceLocator.d.ts","sourceRoot":"","sources":["../../src/lib/AsyncServiceLocator.ts"],"names":[],"mappings":"AAAA,KAAK,wBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEnE,KAAK,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,IAAI,CAC9E,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,KAAK,gBAAgB,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AAE7F,UAAU,0BAA0B;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,mBAAmB,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAE1F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAI;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,0BAA0B;IAMzF,MAAM,CAAC,SAAS,EAAE,MAAM,CACtB,MAAM,EACN,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,CACtG,CAAM;IAEP,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B;IAYnE,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,EACnE,IAAI,EAAE,CAAC,EACP,cAAc,EAAE,CAAC,GAChB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAWlC,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAChC,IAAI,EAAE,CAAC,GAEN,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAc1B"}

package/dist/lib/AsyncServiceLocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncServiceLocator.js","sourceRoot":"","sources":["../../src/lib/AsyncServiceLocator.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,mBAAmB;IAS9B,YAAY,QAAW,EAAE,KAA2B,EAAE,OAAmC;QACvF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAOD,MAAM,CAAC,WAAW,CAAC,GAAW,EAAE,OAAmC;QACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAElD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,mBAAmB,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,uCAAuC;IACvC,eAAe,CACb,IAAO,EACP,cAAiB;QAEjB,OAAO,IAAI,mBAAmB,CAC5B;YACE,GAAG,IAAI,CAAC,QAAQ;YAChB,CAAC,IAAI,CAAC,EAAE,cAAc;SACvB,EACD,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAS,EAAE,sBAAsB;QACnE,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAO;IACP,4EAA4E;;QAE5E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7C,uCAAuC;YACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;;AA/CM,6BAAS,GAGZ,EAAE,CAAC;AA+CT,eAAe;AACf,iDAAiD;AACjD,EAAE;AACF,oBAAoB;AACpB,qBAAqB;AACrB,MAAM;AACN,IAAI;AACJ,EAAE;AACF,gBAAgB;AAChB,iDAAiD;AACjD,EAAE;AACF,uBAAuB;AACvB,sBAAsB;AACtB,MAAM;AACN,EAAE;AACF,oBAAoB;AACpB,sBAAsB;AACtB,MAAM;AACN,IAAI;AACJ,EAAE;AACF,iEAAiE;AACjE,qDAAqD;AACrD,gDAAgD;AAChD,sBAAsB;AACtB,eAAe;AACf,oEAAoE;AACpE,OAAO;AACP,4DAA4D;AAC5D,8DAA8D;AAC9D,EAAE;AACF,sBAAsB;AACtB,0BAA0B"}
+{"version":3,"file":"AsyncServiceLocator.js","sourceRoot":"","sources":["../../src/lib/AsyncServiceLocator.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,mBAAmB;IAS9B,YAAY,QAAW,EAAE,KAA2B,EAAE,OAAmC;QACvF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAOD,MAAM,CAAC,WAAW,CAAC,GAAW,EAAE,OAAmC;QACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAElD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,mBAAmB,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,uCAAuC;IACvC,eAAe,CACb,IAAO,EACP,cAAiB;QAEjB,OAAO,IAAI,mBAAmB,CAC5B;YACE,GAAG,IAAI,CAAC,QAAQ;YAChB,CAAC,IAAI,CAAC,EAAE,cAAc;SACvB,EACD,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAS,EAAE,sBAAsB;QACnE,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAO;IACP,4EAA4E;;QAE5E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7C,uCAAuC;YACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;;AA/CM,6BAAS,GAGZ,EAAE,CAAC;AA+CT,eAAe;AACf,iDAAiD;AACjD,EAAE;AACF,oBAAoB;AACpB,qBAAqB;AACrB,MAAM;AACN,IAAI;AACJ,EAAE;AACF,gBAAgB;AAChB,iDAAiD;AACjD,EAAE;AACF,uBAAuB;AACvB,sBAAsB;AACtB,MAAM;AACN,EAAE;AACF,oBAAoB;AACpB,sBAAsB;AACtB,MAAM;AACN,IAAI;AACJ,EAAE;AACF,iEAAiE;AACjE,qDAAqD;AACrD,gDAAgD;AAChD,sBAAsB;AACtB,eAAe;AACf,oEAAoE;AACpE,OAAO;AACP,4DAA4D;AAC5D,8DAA8D;AAC9D,EAAE;AACF,sBAAsB;AACtB,0BAA0B"}

package/dist/lib/FilesAPIImpl.d.ts

@@ -1,4 +1,4 @@
-import type { FilesAPIClient, FileListResponse, OsAPIClient, WorkspaceItem, MoveOptions, MoveResponse, MkdirResponse, DeleteResponse, DownloadOptions, ListFolderOptions, S3UploadResponse, UploadOptions, UnzipOptions } from '@octostar/platform-types';
+import type { FilesAPIClient, FileListResponse, OsAPIClient, WorkspaceItem, MoveOptions, MoveResponse, MkdirResponse, DeleteResponse, DownloadOptions, ListFolderOptions, PeekSourceOptions, PeekSourceTarget, S3UploadResponse, SourceExportRequest, SourceExportResponse, SourcePeekResponse, UploadOptions, UnzipOptions, UploadFromUrlRequest, UploadFromUrlResponse } from '@octostar/platform-types';
 export declare class FilesAPIImpl implements FilesAPIClient {
     private osAPIClient;
     constructor(osAPIClient: OsAPIClient);
@@ -10,7 +10,9 @@ export declare class FilesAPIImpl implements FilesAPIClient {
     listFolder(os_workspace: string, options?: ListFolderOptions): Promise<FileListResponse>;
     moveOrRename(os_workspace: string, path: string, { entity_id, new_name, new_os_parent_folder, force }: MoveOptions): Promise<MoveResponse>;
     getDownloadUrl(os_workspace: string, path: string, { content_type, content_disposition, redirect }?: DownloadOptions): Promise<string>;
-    createFile(item: WorkspaceItem): Promise<MkdirResponse>;
+    createFile(item: WorkspaceItem, options?: {
+        clientKey?: string;
+    }): Promise<MkdirResponse>;
     mkdir(item: WorkspaceItem): Promise<MkdirResponse>;
     deleteFile(os_workspace: string, path: string): Promise<DeleteResponse>;
     deleteRecursive(os_workspace: string, path: string): Promise<DeleteResponse>;
@@ -18,6 +20,10 @@ export declare class FilesAPIImpl implements FilesAPIClient {
         tracking_id: string;
         status_url: string;
     }>;
+    uploadFromUrl(os_workspace: string, body: UploadFromUrlRequest, signal?: AbortSignal): Promise<UploadFromUrlResponse>;
     getUploadUrl(os_workspace: string, entity_id: string, options: UploadOptions): Promise<S3UploadResponse>;
+    peekSource(os_workspace: string, target: PeekSourceTarget, options?: PeekSourceOptions): Promise<SourcePeekResponse>;
+    private buildPeekSourceUrl;
+    bulkExportSourceSubtree(os_workspace: string, body: SourceExportRequest): Promise<SourceExportResponse>;
 }
 //# sourceMappingURL=FilesAPIImpl.d.ts.map

package/dist/lib/FilesAPIImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilesAPIImpl.d.ts","sourceRoot":"","sources":["../../src/lib/FilesAPIImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,0BAA0B,CAAC;AAGlC,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,EAAE,WAAW;IAIpC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAajE,OAAO,CAAC,gBAAgB;YAiBV,UAAU;YAYV,kBAAkB;YAelB,QAAQ;IAWhB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYxF,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAa,EAAE,EAAE,WAAW,GACxE,OAAO,CAAC,YAAY,CAAC;IAclB,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,EAAE,YAAY,EAAE,mBAA8B,EAAE,QAAe,EAAE,GAAE,eAAoB,GACtF,OAAO,CAAC,MAAM,CAAC;IAoBZ,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBvD,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAclD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQvE,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ5E,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBjD,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAc/G"}
+{"version":3,"file":"FilesAPIImpl.d.ts","sourceRoot":"","sources":["../../src/lib/FilesAPIImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EAEjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAGlC,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,EAAE,WAAW;IAIpC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAajE,OAAO,CAAC,gBAAgB;YAiBV,UAAU;YAYV,kBAAkB;YAelB,QAAQ;IAWhB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYxF,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAa,EAAE,EAAE,WAAW,GACxE,OAAO,CAAC,YAAY,CAAC;IAclB,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,EAAE,YAAY,EAAE,mBAA8B,EAAE,QAAe,EAAE,GAAE,eAAoB,GACtF,OAAO,CAAC,MAAM,CAAC;IAoBZ,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAyB7F,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAclD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQvE,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ5E,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBjD,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC;IAc3B,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAexG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IAS9B,OAAO,CAAC,kBAAkB;IAgBpB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAQ9G"}

package/dist/lib/FilesAPIImpl.js

@@ -87,8 +87,10 @@ export class FilesAPIImpl {
         });
         return signedUrl;
     }
-    async createFile(item) {
-        const url = `/api/v1/files/create/${item.os_workspace}`;
+    async createFile(item, options = {}) {
+        const base = `/api/v1/files/create/${item.os_workspace}`;
+        // The pipeline groups every request of one upload action under its `client_key`.
+        const url = options.clientKey ? `${base}?client_key=${encodeURIComponent(options.clientKey)}` : base;
         return this.osAPIClient.fetchData({
             endpoint: url,
             method: 'POST',
@@ -148,6 +150,19 @@ export class FilesAPIImpl {
             },
         });
     }
+    async uploadFromUrl(os_workspace, body, signal) {
+        const endpoint = `/api/v2/files/upload-from-url/${encodeURIComponent(os_workspace)}`;
+        const response = await this.osAPIClient.fetch(endpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal,
+        });
+        if (!response.ok) {
+            throw await parseUploadFromUrlError(response);
+        }
+        return (await response.json());
+    }
     async getUploadUrl(os_workspace, entity_id, options) {
         const { content_type, ttl_minutes = 60 } = options;
         const ttl = ttl_minutes * 60;
@@ -161,5 +176,69 @@ export class FilesAPIImpl {
             },
         });
     }
+    async peekSource(os_workspace, target, options) {
+        const url = this.buildPeekSourceUrl(os_workspace, target, options);
+        return this.osAPIClient.fetchData({
+            endpoint: url,
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+    buildPeekSourceUrl(os_workspace, target, options) {
+        // Path mode requires a non-empty path; an empty string would produce
+        // `.../source/list/{ws}/` which the backend can't route. The type
+        // signature does not (and cannot) encode non-empty at compile time.
+        if (target.path !== undefined && target.path !== '') {
+            const query = this.buildQueryParams({ inner: options?.inner });
+            const encodedPath = encodeURIComponent(target.path);
+            return `/api/v1/files/source/list/${os_workspace}/${encodedPath}${query ? `?${query}` : ''}`;
+        }
+        if (target.entity_id !== undefined && target.entity_id !== '') {
+            const query = this.buildQueryParams({ entity_id: target.entity_id, inner: options?.inner });
+            return `/api/v1/files/source/list/${os_workspace}${query ? `?${query}` : ''}`;
+        }
+        throw new Error('peekSource: target must include a non-empty `path` or `entity_id`.');
+    }
+    async bulkExportSourceSubtree(os_workspace, body) {
+        return this.osAPIClient.fetchData({
+            endpoint: `/api/v1/files/source/export/${os_workspace}`,
+            method: 'POST',
+            body,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+}
+/**
+ * Parse a non-2xx response from `uploadFromUrl` into an `UploadFromUrlError`
+ * carrying the API's `{ detail: { error_code, message } }` envelope when present.
+ * Falls back gracefully when the body isn't JSON (e.g. nginx 502 page).
+ */
+async function parseUploadFromUrlError(response) {
+    let code;
+    let detailMessage;
+    try {
+        const parsed = (await response.json());
+        const detail = parsed?.detail;
+        if (detail && typeof detail === 'object') {
+            const obj = detail;
+            if (typeof obj.error_code === 'string')
+                code = obj.error_code;
+            if (typeof obj.message === 'string')
+                detailMessage = obj.message;
+        }
+        else if (typeof detail === 'string') {
+            detailMessage = detail;
+        }
+    }
+    catch {
+        // Non-JSON body — leave code/detailMessage undefined.
+    }
+    const error = new Error(detailMessage ?? `Upload from URL failed: ${String(response.status)}`);
+    error.status = response.status;
+    if (code !== undefined)
+        error.code = code;
+    if (detailMessage !== undefined)
+        error.detailMessage = detailMessage;
+    return error;
 }
 //# sourceMappingURL=FilesAPIImpl.js.map

package/dist/lib/FilesAPIImpl.js.map

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

package/dist/lib/FusionApi.d.ts

@@ -1,5 +1,5 @@
 import type { Entity, WorkspaceItem } from '@octostar/platform-types';
-import type { FusionConnectedDataKey, FusionConnectionValue, FusionAPIConstructorParams, FusionSource, FusionValue, FusionDocumentData } from '../type/FusionTypes';
+import type { FusionConnectedDataKey, FusionConnectionValues, FusionAPIConstructorParams, FusionSource, FusionValue, FusionDocumentData } from '../type/FusionTypes';
 interface GetFusionValuesFromSourcesParams {
     sources: FusionSource[];
     getValue: (record: Record<string, unknown>) => unknown;
@@ -26,14 +26,23 @@ export declare class FusionAPI {
      */
     getSources(): Promise<FusionSource[]>;
     /**
-     * Gets connected data for the main entity only
+     * Gets connected data for the main entity only.
+     *
+     * The returned object pairs the values with a `truncated` flag indicating
+     * whether the underlying `getConnectionsByType` SQL hit
+     * `CONNECTIONS_QUERY_CAP`. Consumers iterate via `result.values` and read
+     * `result.truncated` to surface a "results truncated" notice.
      */
-    getMainConnectedData(name: string, connectedDataKey: FusionConnectedDataKey): Promise<FusionConnectionValue[]>;
-    fuseEntities(dataToSave: FusionDocumentData[]): Promise<(WorkspaceItem | undefined)[]>;
+    getMainConnectedData(name: string, connectedDataKey: FusionConnectedDataKey): Promise<FusionConnectionValues>;
+    fuseEntities(dataToSave: FusionDocumentData[]): Promise<(WorkspaceItem | undefined)[] | undefined>;
     /**
-     * Gets connected data for all fusion sources and merges them
+     * Gets connected data for all fusion sources and merges them.
+     *
+     * The returned object pairs the merged values with a `truncated` flag that
+     * is `true` if *any* per-source fetch hit the connections cap. See
+     * `getMainConnectedData` for the consumer contract.
      */
-    getFusionConnectedData(name: string, connectedDataKey: FusionConnectedDataKey): Promise<FusionConnectionValue[]>;
+    getFusionConnectedData(name: string, connectedDataKey: FusionConnectedDataKey): Promise<FusionConnectionValues>;
     /**
      * Generates ordered record fields for fusion sources based on UI schema
      */

package/dist/lib/FusionApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FusionApi.d.ts","sourceRoot":"","sources":["../../src/lib/FusionApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,MAAM,EAAY,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGtG,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,WAAW,EACX,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,UAAU,gCAAgC;IACxC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACvD,eAAe,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,SAAS;IAEpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAa;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAa;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAc;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAiB;IAGjE,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAc;IACrD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0B;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;gBAEvD,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,0BAA0B;IAW3E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAc3C;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAK9G,YAAY,CAAC,UAAU,EAAE,kBAAkB,EAAE;IA0CnD;;OAEG;IACG,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,sBAAsB,GACvC,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAoBnC;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtE;;OAEG;IACG,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAkBtD,oCAAoC;YAmBpC,sCAAsC;YAmBtC,eAAe;IAW7B;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,EAChC,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE,gCAAgC,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;IA0BlE,OAAO,CAAC,gBAAgB;YAIV,eAAe;IAS7B,OAAO,CAAC,qBAAqB;YAgBf,yBAAyB;YAWzB,qBAAqB;YAyCrB,iBAAiB;YASjB,uBAAuB;IA0CrC,OAAO,CAAC,oBAAoB;YAyBd,oBAAoB;YAiBpB,4BAA4B;YAgB5B,sBAAsB;IAmBpC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAOvC,OAAO,CAAC,MAAM,CAAC,SAAS;CAMzB"}
+{"version":3,"file":"FusionApi.d.ts","sourceRoot":"","sources":["../../src/lib/FusionApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,MAAM,EAAY,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGtG,OAAO,KAAK,EACV,sBAAsB,EAEtB,sBAAsB,EACtB,0BAA0B,EAC1B,YAAY,EACZ,WAAW,EACX,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,UAAU,gCAAgC;IACxC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACvD,eAAe,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,SAAS;IAEpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAa;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAa;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAc;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAiB;IAGjE,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAc;IACrD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0B;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;gBAEvD,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,0BAA0B;IAW3E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAc3C;;;;;;;OAOG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK7G,YAAY,CAAC,UAAU,EAAE,kBAAkB,EAAE;IA0CnD;;;;;;OAMG;IACG,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,sBAAsB,GACvC,OAAO,CAAC,sBAAsB,CAAC;IAwBlC;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQtE;;OAEG;IACG,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAkBtD,oCAAoC;YAmBpC,sCAAsC;YAmBtC,eAAe;IAW7B;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,EAChC,OAAO,EACP,QAAQ,EACR,eAAe,GAChB,EAAE,gCAAgC,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;IA0BlE,OAAO,CAAC,gBAAgB;YAIV,eAAe;IAS7B,OAAO,CAAC,qBAAqB;YAgBf,yBAAyB;YAWzB,qBAAqB;YAyCrB,iBAAiB;YASjB,uBAAuB;IA0CrC,OAAO,CAAC,oBAAoB;YAyBd,oBAAoB;YAmBpB,4BAA4B;YAgB5B,sBAAsB;IAmBpC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAOvC,OAAO,CAAC,MAAM,CAAC,SAAS;CAMzB"}