@scaleflex/dam-core 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @scaleflex/dam-core
+
+Headless, framework-agnostic foundation for the Scaleflex DAM widgets. **No UI, no Lit, no
+React — Fetch API only.** Everything every widget needs to talk to the Filerobot DAM
+backend, in one place, so it isn't reimplemented (and allowed to drift) per widget.
+
+## What's inside
+
+- **`auth/`** — `resolveAuth`, `normalizeAuth`, `exchangeSassKey`, `buildAuthHeaders`,
+  `getApiBase`, and the `AuthConfig` union. Accepts the canonical (`container`) shape **and**
+  asset-picker's historical (`projectToken`) shape, normalizing the latter. See
+  [`plan/05`](../../plan/05-shared-core-design.md) + [`plan/11`](../../plan/11-deepdive-findings.md).
+- **`api/`** — `DamClient` + `folders` / `files` / `labels` services.
+- **`types/`** — `Asset`, `Folder`, `Label`, and API response envelopes.
+- **`store/`** — headless observable `BrowseStore` + `FavouritesAdapter` /
+  `LocalFavouritesAdapter`.
+- **`helpers/`** — CDN / thumbnail URL builders.
+
+## Usage
+
+```ts
+import { resolveAuth, DamClient } from '@scaleflex/dam-core';
+
+// Canonical shape (light-dam / uploader):
+const resolved = await resolveAuth({ mode: 'sass-key', container: 'akli', sassKey: 'K' });
+
+// asset-picker shape is accepted too and normalized automatically:
+await resolveAuth({ mode: 'sassKey', projectToken: 'akli', sassKey: 'K' });
+```
+
+## Conventions
+
+This is the bottom of the dependency graph: it imports **nothing** internal. Keep it that
+way. Domain types here are the contract every widget shares — change them deliberately.

package/dist/api/archive.service.d.ts

@@ -0,0 +1,44 @@
+import { DamClient } from './dam-client';
+import { ArchiveStatusResponse } from '../types/api.types';
+/** What to bundle. Any combination of file uuids, folder uuids, and raw CDN URLs. */
+export interface ArchiveTarget {
+    filesUuids?: string[];
+    foldersUuids?: string[];
+    urls?: string[];
+}
+/** Kick off an archive job; resolves with its task id. */
+export declare function createArchive(client: DamClient, target: ArchiveTarget): Promise<string>;
+/** One status read of an archive job. */
+export declare function getArchiveStatus(client: DamClient, taskId: string): Promise<ArchiveStatusResponse>;
+/**
+ * Interpret an archive status payload. Pure — the heart of the poll loop, tested
+ * in isolation. Throws on a terminal failure status; returns `{done,progress}`
+ * otherwise (`done` only for DONE).
+ */
+export declare function archiveStatusOutcome(res: ArchiveStatusResponse): {
+    done: boolean;
+    progress: number;
+};
+export interface PollArchiveOptions {
+    /** Delay between status reads (default 1500ms). */
+    intervalMs?: number;
+    /** Give up after this long (default 120000ms). */
+    timeoutMs?: number;
+    /** Tolerate this many transient status-read errors (the job may not be registered yet). */
+    maxRetries?: number;
+    /** Abort the poll early. */
+    signal?: AbortSignal;
+    /** Progress callback (0–100). */
+    onProgress?: (percent: number) => void;
+    /** Injectable sleep (tests pass an immediate resolver). */
+    sleep?: (ms: number) => Promise<void>;
+    /** Injectable clock (tests pass a controllable one). */
+    now?: () => number;
+}
+/** Poll an archive job until it reports DONE (or throws on failure/timeout/abort). */
+export declare function pollArchive(client: DamClient, taskId: string, opts?: PollArchiveOptions): Promise<void>;
+/** Build the authenticated direct-download URL for a finished archive. */
+export declare function archiveDownloadUrl(client: DamClient, taskId: string): string;
+/** Create → poll → resolve the authenticated download URL. */
+export declare function createAndPollArchive(client: DamClient, target: ArchiveTarget, opts?: PollArchiveOptions): Promise<string>;
+//# sourceMappingURL=archive.service.d.ts.map

package/dist/api/archive.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.service.d.ts","sourceRoot":"","sources":["../../src/api/archive.service.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAyB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEvF,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ7F;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC,CAIhC;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG;IAChE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA;AAED,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iCAAiC;IACjC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,sFAAsF;AACtF,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,8DAA8D;AAC9D,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/api/archive.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=archive.test.d.ts.map

package/dist/api/archive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.test.d.ts","sourceRoot":"","sources":["../../src/api/archive.test.ts"],"names":[],"mappings":""}

package/dist/api/dam-client.d.ts

@@ -0,0 +1,27 @@
+import { AuthConfig, ResolvedAuth } from '../auth';
+type Params = Record<string, unknown>;
+export declare class DamClient {
+    /** REST base, e.g. "https://api.filerobot.com/akli/v5". */
+    private readonly baseUrl;
+    private headers;
+    private readonly auth?;
+    private readonly apiDomain?;
+    constructor(resolved: ResolvedAuth, auth?: AuthConfig, apiDomain?: string);
+    /** Resolve an AuthConfig (performing key exchange if needed) and build a client. */
+    static create(auth: AuthConfig, apiDomain?: string): Promise<DamClient>;
+    get<T>(path: string, params?: Params): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    put<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Absolute REST URL (incl. the `/v5` base) for a path — for building direct
+     * browser-download links (e.g. the archive ZIP) that bypass `fetch`.
+     */
+    absoluteUrl(path: string): string;
+    /** The Filerobot key (`X-Filerobot-Key`), for query-param auth on direct downloads. */
+    get authKey(): string | undefined;
+    private sendJson;
+    private send;
+}
+export {};
+//# sourceMappingURL=dam-client.d.ts.map

package/dist/api/dam-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dam-client.d.ts","sourceRoot":"","sources":["../../src/api/dam-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AAIrE,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtC,qBAAa,SAAS;IACpB,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,OAAO,CAAc;IAE7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAExB,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM;IAOzE,oFAAoF;WACvE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAK7E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAWjD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,uFAAuF;IACvF,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,OAAO,CAAC,QAAQ;YAQF,IAAI;CAkDnB"}

package/dist/api/filerobot-browse.service.d.ts

@@ -0,0 +1,84 @@
+import { DamClient } from './dam-client';
+import { FilerobotAsset, FilerobotFolder } from '../types/filerobot.types';
+export interface FilerobotFilesParams {
+    folder?: string;
+    offset?: number;
+    limit?: number;
+    sort_by?: string;
+    sort_direction?: string;
+    /** Free-text search. */
+    search?: string;
+    /** Pre-serialized search/filter notation. */
+    q?: string;
+    recursive?: number;
+    /** Enable AI-powered semantic search. */
+    with_ai?: boolean;
+    ai_query?: string;
+    ai_lang?: string;
+    /** Filter by collection. */
+    collection_uuid?: string;
+    /** Base64-encoded collection-folder filter. */
+    f64?: string;
+    /** Extra computed fields (e.g. `cdn_permalink`); undefined → the default set. */
+    fields?: string[];
+}
+export interface FilerobotFilesResponse {
+    status: string;
+    msg?: string;
+    files: FilerobotAsset[];
+    folders: FilerobotFolder[];
+    base?: {
+        count?: {
+            files_direct?: number;
+            files_recursive?: number;
+        };
+    };
+    info?: {
+        total_files_count?: number;
+        total_files_size?: number;
+    };
+    limit: number;
+    offset: number;
+}
+/** Fetch a page of files as the raw Filerobot wire response (no normalization). */
+export declare function getFilesRaw(client: DamClient, params: FilerobotFilesParams): Promise<FilerobotFilesResponse>;
+export interface FilerobotFilesStatsResponse {
+    status: string;
+    stats?: {
+        approx_files_count?: number;
+        approx_files_size?: number;
+    };
+    info?: {
+        total_files_count?: number;
+        total_files_size?: number;
+    };
+}
+export type FilerobotFilesStatsParams = Pick<FilerobotFilesParams, 'folder' | 'q' | 'search' | 'recursive' | 'with_ai' | 'ai_query' | 'ai_lang' | 'collection_uuid' | 'f64'>;
+/** Approximate file count/size for a scope (the `/files/stats` endpoint). */
+export declare function getFilesStats(client: DamClient, params: FilerobotFilesStatsParams): Promise<FilerobotFilesStatsResponse>;
+export interface FilerobotFoldersParams {
+    folderPath?: string;
+    recursive?: number;
+    limit?: number;
+    offset?: number;
+    q?: string;
+    sort_by?: string;
+    sort_direction?: string;
+}
+export interface FilerobotFoldersResponse {
+    status: string;
+    msg?: string;
+    folders: FilerobotFolder[];
+    total?: number;
+}
+/** Fetch folders as the raw Filerobot wire response (no normalization). */
+export declare function getFoldersRaw(client: DamClient, params?: FilerobotFoldersParams): Promise<FilerobotFoldersResponse>;
+export interface FolderPreview {
+    file_uuid: string;
+    file_uri_cdn: string;
+    file_type: string;
+    preview_origin: string;
+}
+/** Preview thumbnails for a set of folders (`POST /folders/previews`). */
+export declare function getFolderPreviews(client: DamClient, folderUuids: string[]): Promise<Record<string, FolderPreview[]>>;
+//# sourceMappingURL=filerobot-browse.service.d.ts.map

package/dist/api/filerobot-browse.service.d.ts.map

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

package/dist/api/files.service.d.ts

@@ -0,0 +1,63 @@
+import { DamClient } from './dam-client';
+import { Asset } from '../types/asset.types';
+/** File-type categories the backend can filter on (`type:"image"` …). */
+export type FileTypeFilter = 'image' | 'video' | 'audio' | 'document' | 'other';
+/** Coarse file-size buckets (in bytes), mapped to a `size:"min..max"` clause. */
+export type SizeBucket = 'small' | 'medium' | 'large' | 'huge';
+/** "Within the last …" presets for the created/modified date facets. */
+export type DatePreset = 'today' | 'week' | 'month' | 'year';
+export interface GetFilesParams {
+    folder?: string;
+    recursive?: number;
+    limit?: number;
+    offset?: number;
+    search?: string;
+    q?: string;
+    /** Restrict to these file-type categories (Filerobot `type:"…"` clause). */
+    types?: FileTypeFilter[];
+    /** Restrict to a file-size bucket (`size:"min..max"` clause). */
+    sizeBucket?: SizeBucket;
+    /** Only assets created within this window (`created>"…"` clause). */
+    createdWithin?: DatePreset;
+    /** Only assets modified within this window (`updated>"…"` clause). */
+    updatedWithin?: DatePreset;
+    sortBy?: 'created_at' | 'modified_at' | 'name' | 'size' | 'type';
+    sortDirection?: 'asc' | 'desc';
+    /** Additive computed fields; `cdn_permalink` must be requested explicitly. */
+    fields?: string[];
+}
+export interface FilesPage {
+    assets: Asset[];
+    /** Total matching the query (from the API when available, else this page's size). */
+    total: number;
+}
+/** One page of files. `total` is the API's grand total when provided, else this page's size. */
+export declare function getFilesPage(client: DamClient, params?: GetFilesParams): Promise<FilesPage>;
+export declare function getFiles(client: DamClient, params?: GetFilesParams): Promise<Asset[]>;
+/** Subset of the facets that can also be evaluated client-side (favourites). */
+export type FacetFilters = Pick<GetFilesParams, 'types' | 'sizeBucket' | 'createdWithin' | 'updatedWithin'>;
+/**
+ * Does an already-loaded asset satisfy the facet filters? Used for the
+ * Favourites axis, which fetches a known uuid set directly and filters in
+ * memory rather than re-querying the server. Mirrors buildFilesQuery's clauses
+ * (shares SIZE_BUCKETS / sinceMidnight) so server- and client-side agree.
+ */
+export declare function assetMatchesFacets(asset: Asset, f: FacetFilters, nowMs: number): boolean;
+type SortField = NonNullable<GetFilesParams['sortBy']>;
+/** Client-side sort matching the server's `sort=field:dir`, for the favourites set. */
+export declare function sortAssets(assets: Asset[], sortBy: SortField, dir: 'asc' | 'desc'): Asset[];
+/**
+ * Fetch specific files by uuid (one `GET /file/{uuid}` each, bounded concurrency).
+ * The Favourites axis is a known, usually-small uuid set, so this is far cheaper
+ * than scanning the whole library. Missing/forbidden uuids are skipped; results
+ * keep the input order (caller re-sorts as needed).
+ */
+export declare function getFilesByUuids(client: DamClient, uuids: string[], opts?: {
+    concurrency?: number;
+    fields?: string[];
+}): Promise<Asset[]>;
+export declare function renameFile(client: DamClient, uuid: string, newName: string): Promise<void>;
+export declare function deleteFiles(client: DamClient, uuids: string[]): Promise<void>;
+export declare function moveFiles(client: DamClient, uuids: string[], destinationFolder: string): Promise<void>;
+export {};
+//# sourceMappingURL=files.service.d.ts.map

package/dist/api/files.service.d.ts.map

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

package/dist/api/files.service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=files.service.test.d.ts.map

package/dist/api/files.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.service.test.d.ts","sourceRoot":"","sources":["../../src/api/files.service.test.ts"],"names":[],"mappings":""}

package/dist/api/folders.service.d.ts

@@ -0,0 +1,21 @@
+import { DamClient } from './dam-client';
+import { Folder } from '../types/folder.types';
+export interface GetFoldersParams {
+    folderPath?: string;
+    recursive?: number;
+    limit?: number;
+    offset?: number;
+    q?: string;
+    sortBy?: 'created_at' | 'modified_at' | 'name';
+    sortDirection?: 'asc' | 'desc';
+}
+export declare function getFolders(client: DamClient, params?: GetFoldersParams): Promise<Folder[]>;
+/**
+ * Create a folder. The backend's `name` is a full path; we build it from
+ * parent + leaf. `parentFolderPath` is expected to start with `/`.
+ */
+export declare function createFolder(client: DamClient, leafName: string, parentFolderPath: string): Promise<void>;
+export declare function renameFolder(client: DamClient, uuid: string, newName: string): Promise<void>;
+export declare function deleteFolders(client: DamClient, uuids: string[]): Promise<void>;
+export declare function moveFolders(client: DamClient, uuids: string[], destinationPath: string): Promise<void>;
+//# sourceMappingURL=folders.service.d.ts.map

package/dist/api/folders.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.service.d.ts","sourceRoot":"","sources":["../../src/api/folders.service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;IAC/C,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAChC;AAeD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAKf;AAID,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrF;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EAAE,EACf,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/api/index.d.ts

@@ -0,0 +1,8 @@
+export { DamClient } from './dam-client';
+export { getFolders, createFolder, renameFolder, deleteFolders, moveFolders, type GetFoldersParams, } from './folders.service';
+export { getFiles, getFilesPage, getFilesByUuids, assetMatchesFacets, sortAssets, renameFile, deleteFiles, moveFiles, type GetFilesParams, type FilesPage, type FacetFilters, type FileTypeFilter, type SizeBucket, type DatePreset, } from './files.service';
+export { getLabels, labelFilterQuery } from './labels.service';
+export { getFileVariations, getPresets, normalizePresets, loadVariations, } from './variations.service';
+export { createArchive, getArchiveStatus, archiveStatusOutcome, pollArchive, archiveDownloadUrl, createAndPollArchive, type ArchiveTarget, type PollArchiveOptions, } from './archive.service';
+export { getFilesRaw, getFilesStats, getFoldersRaw, getFolderPreviews, type FilerobotFilesParams, type FilerobotFilesResponse, type FilerobotFilesStatsParams, type FilerobotFilesStatsResponse, type FilerobotFoldersParams, type FilerobotFoldersResponse, type FolderPreview, } from './filerobot-browse.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,aAAa,GACnB,MAAM,4BAA4B,CAAC"}

package/dist/api/labels.service.d.ts

@@ -0,0 +1,10 @@
+import { DamClient } from './dam-client';
+import { Label } from '../types/label.types';
+export declare function getLabels(client: DamClient): Promise<Label[]>;
+/**
+ * Build the Files API query that filters by a label, mirroring asset-picker:
+ * `q=labels:{sid}` with the leading "#" stripped from the label's sid.
+ * Returns undefined for a label with no usable sid (caller skips the filter).
+ */
+export declare function labelFilterQuery(label: Label): string | undefined;
+//# sourceMappingURL=labels.service.d.ts.map

package/dist/api/labels.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.service.d.ts","sourceRoot":"","sources":["../../src/api/labels.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAOlD,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAGjE"}

package/dist/api/variations.service.d.ts

@@ -0,0 +1,23 @@
+import { DamClient } from './dam-client';
+import { Asset } from '../types/asset.types';
+import { Variation, Preset } from '../types/variation.types';
+import { RawVariation, RawPreset } from '../types/api.types';
+/** List a file's raw variations (custom + background-removed renditions). */
+export declare function getFileVariations(client: DamClient, uuid: string): Promise<RawVariation[]>;
+/** Normalize the various preset shapes (`string` | `{ name, desc }`) into `Preset[]`. */
+export declare function normalizePresets(raw: RawPreset[] | undefined): Preset[];
+/**
+ * Fetch the container's resolution presets from `/settings`. The presets array
+ * lives under the container's cloudimg config; its exact nesting varies by
+ * deployment, so we probe the known locations defensively (verify against a live
+ * container — Q-AP presets).
+ */
+export declare function getPresets(client: DamClient): Promise<Preset[]>;
+/**
+ * Convenience: fetch a file's variants + the container presets and assemble the
+ * full ordered `Variation[]` (Original + custom + background-removed + presets).
+ * Hosts that already hold variants/presets can call `assembleVariations` directly
+ * instead (the fetch-or-inject contract).
+ */
+export declare function loadVariations(client: DamClient, asset: Asset): Promise<Variation[]>;
+//# sourceMappingURL=variations.service.d.ts.map

package/dist/api/variations.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variations.service.d.ts","sourceRoot":"","sources":["../../src/api/variations.service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAGV,YAAY,EACZ,SAAS,EACV,MAAM,oBAAoB,CAAC;AAG5B,6EAA6E;AAC7E,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAKhG;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAWvE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKrE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAM1F"}

package/dist/api/variations.service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=variations.service.test.d.ts.map

package/dist/api/variations.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variations.service.test.d.ts","sourceRoot":"","sources":["../../src/api/variations.service.test.ts"],"names":[],"mappings":""}

package/dist/auth/auth.service.d.ts

@@ -0,0 +1,34 @@
+import { AnyAuthConfig, AuthConfig, AuthHeaders, ResolvedAuth } from './auth.types';
+/**
+ * Container base URL, e.g. "https://api.filerobot.com/akli".
+ * `apiDomain` overrides the default host. The REST client appends `/v5` to this
+ * for the Files/Folders API.
+ */
+export declare function getApiBase(container: string, apiDomain?: string): string;
+/**
+ * Exchange a security template id for a short-lived SASS key.
+ *
+ * Resilience: the response is fetched with `cache: 'no-store'` (the key is
+ * short-lived and security-sensitive — never serve a cached key or a cached
+ * transient 404), and transient failures (404/408/429/5xx, network errors) are
+ * retried a few times with linear backoff. This fixes the intermittent
+ * "SASS key exchange failed (HTTP 404)" seen with a valid container + template.
+ */
+export declare function exchangeSassKey(container: string, securityTemplateId: string, apiDomain?: string, opts?: {
+    retries?: number;
+    retryDelayMs?: number;
+}): Promise<string>;
+/** Build auth headers from a (possibly resolved) SASS key. */
+export declare function buildAuthHeaders(auth: AuthConfig, resolvedSassKey?: string): AuthHeaders;
+/**
+ * Normalize any accepted auth shape onto the canonical {@link AuthConfig}. The canonical
+ * shape passes through untouched; asset-picker's `projectToken`/camelCase shape is mapped.
+ */
+export declare function normalizeAuth(auth: AnyAuthConfig): AuthConfig;
+/**
+ * Resolve any accepted auth shape into a ready-to-use base URL + headers.
+ * Accepts the canonical {@link AuthConfig} or asset-picker's {@link AssetPickerAuth}.
+ * For security-template mode this performs the SASS key exchange.
+ */
+export declare function resolveAuth(auth: AnyAuthConfig, apiDomain?: string): Promise<ResolvedAuth>;
+//# sourceMappingURL=auth.service.d.ts.map

package/dist/auth/auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../src/auth/auth.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EAEb,UAAU,EACV,WAAW,EACX,YAAY,EACb,MAAM,cAAc,CAAC;AA0BtB;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACrD,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW,CAsBxF;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAiB7D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAShG"}

package/dist/auth/auth.service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.service.test.d.ts.map

package/dist/auth/auth.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.test.d.ts","sourceRoot":"","sources":["../../src/auth/auth.service.test.ts"],"names":[],"mappings":""}

package/dist/auth/auth.types.d.ts

@@ -0,0 +1,44 @@
+export interface SecurityTemplateAuth {
+    mode: 'security-template';
+    /** Filerobot container / project token, e.g. "akli". */
+    container: string;
+    /** Security template id, exchanged for a short-lived SASS key at runtime. */
+    securityTemplateId: string;
+    airboxPuid?: string;
+}
+export interface SassKeyAuth {
+    mode: 'sass-key';
+    container: string;
+    /** Pre-resolved SASS key — used directly, no exchange. */
+    sassKey: string;
+    airboxPuid?: string;
+}
+export type AuthConfig = SecurityTemplateAuth | SassKeyAuth;
+/**
+ * @scaleflex/asset-picker's historical auth shape. Accepted by {@link resolveAuth} for
+ * back-compat and normalized onto {@link AuthConfig}. Field/mode mapping:
+ * `projectToken→container`, `securityTemplateKey→securityTemplateId`,
+ * `'securityTemplate'→'security-template'`, `'sassKey'→'sass-key'`.
+ */
+export type AssetPickerAuth = {
+    mode: 'securityTemplate';
+    projectToken: string;
+    securityTemplateKey: string;
+    airboxPuid?: string;
+} | {
+    mode: 'sassKey';
+    projectToken: string;
+    sassKey: string;
+    airboxPuid?: string;
+};
+/** Any auth shape {@link resolveAuth} accepts: canonical or the asset-picker variant. */
+export type AnyAuthConfig = AuthConfig | AssetPickerAuth;
+/** Headers attached to every Scaleflex/Filerobot API request. */
+export type AuthHeaders = Record<string, string>;
+/** Output of {@link resolveAuth}: a ready-to-use base URL + headers. */
+export interface ResolvedAuth {
+    apiBase: string;
+    headers: AuthHeaders;
+    sassKey?: string;
+}
+//# sourceMappingURL=auth.types.d.ts.map

package/dist/auth/auth.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.types.d.ts","sourceRoot":"","sources":["../../src/auth/auth.types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,eAAe,CAAC;AAEzD,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/auth/index.d.ts

@@ -0,0 +1,3 @@
+export type { AuthConfig, SecurityTemplateAuth, SassKeyAuth, AssetPickerAuth, AnyAuthConfig, AuthHeaders, ResolvedAuth, } from './auth.types';
+export { resolveAuth, normalizeAuth, exchangeSassKey, getApiBase, buildAuthHeaders, } from './auth.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,UAAU,EACV,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/helpers/cdn.d.ts

@@ -0,0 +1,50 @@
+export interface TransformParams {
+    width?: number;
+    height?: number;
+    /** 1–100, or "auto". */
+    quality?: number | 'auto';
+}
+/** Append Filerobot CDN sizing params (w/h/q) to a permalink, preserving existing params. */
+export declare function addCdnParams(cdnUrl: string, params: TransformParams): string;
+/** Output formats the transform pipeline supports. */
+export type DownloadFormat = 'webp' | 'jpeg' | 'png' | 'gif';
+/** Quality presets → numeric `q` (JPEG/WEBP), matching the reference admin. */
+export declare const QUALITY_LEVELS: {
+    readonly excellent: 90;
+    readonly good: 75;
+    readonly fair: 60;
+};
+export type QualityLevel = keyof typeof QUALITY_LEVELS;
+/** Standardized resize presets (max box, in px); "Full HD" + the reference's large/medium/small. */
+export declare const RESIZE_PRESETS: {
+    readonly fullhd: 1920;
+    readonly large: 1200;
+    readonly medium: 600;
+    readonly small: 300;
+};
+export type ResizePreset = keyof typeof RESIZE_PRESETS;
+export interface TransformOptions {
+    format?: DownloadFormat;
+    /** Numeric q (1–100). Use QUALITY_LEVELS for the named presets. Omit for "Original" quality. */
+    quality?: number;
+    width?: number;
+    height?: number;
+    /**
+     * Aspect-ratio handling when width/height are set (the embed/options "lock" toggle).
+     * `true` → `func=bound` (fit inside the box, keep ratio); `false` → `func=cover`
+     * (fill the box, may crop). Omit to leave `func` off (the reference admin's default
+     * resize). Mirrors Portals' strict-size switch.
+     */
+    strictSizes?: boolean;
+}
+/** The downloaded file's name with the new extension (jpeg → jpg) when reformatting. */
+export declare function transformedFileName(originalName: string, format?: DownloadFormat): string;
+/**
+ * Build a CDN URL that serves the *transformed* asset as a download attachment.
+ * Uses `force_download=<name>` (not `download=1`, which bypasses transforms and
+ * returns the original) — same contract as the reference admin's getFileWithNewParams.
+ */
+export declare function buildTransformedDownloadUrl(cdnUrl: string, originalName: string, t?: TransformOptions): string;
+/** Build a CDN URL for the transformed asset for embedding/linking (no download flag). */
+export declare function buildEmbedUrl(cdnUrl: string, t?: TransformOptions): string;
+//# sourceMappingURL=cdn.d.ts.map

package/dist/helpers/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../../src/helpers/cdn.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAM5E;AAID,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7D,+EAA+E;AAC/E,eAAO,MAAM,cAAc;;;;CAAiD,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD,oGAAoG;AACpG,eAAO,MAAM,cAAc;;;;;CAAkE,CAAC;AAC9F,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAQvD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAgBD,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,CAAC,GAAE,gBAAqB,GACvB,MAAM,CAKR;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAE,gBAAqB,GAAG,MAAM,CAI9E"}

package/dist/helpers/cdn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cdn.test.d.ts.map

package/dist/helpers/cdn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.test.d.ts","sourceRoot":"","sources":["../../src/helpers/cdn.test.ts"],"names":[],"mappings":""}

package/dist/helpers/debounce.d.ts

@@ -0,0 +1,4 @@
+export declare function debounce<T extends (...args: any[]) => void>(fn: T, delay: number): T & {
+    cancel(): void;
+};
+//# sourceMappingURL=debounce.d.ts.map

package/dist/helpers/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/helpers/debounce.ts"],"names":[],"mappings":"AAMA,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EACzD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CASxB"}

package/dist/helpers/format.d.ts

@@ -0,0 +1,7 @@
+/** Human-readable byte size ("—" when unknown, e.g. "1.4 MB", "512 B"). */
+export declare function formatFileSize(bytes?: number | null): string;
+/** Short, locale-aware date ("—" when missing; echoes the raw value if unparseable). */
+export declare function formatDate(iso?: string | null): string;
+/** "W × H" pixel dimensions, or "—" when either side is missing. */
+export declare function formatDimensions(width?: number | null, height?: number | null): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/helpers/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/helpers/format.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA0B5D;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKtD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEtF"}

package/dist/helpers/format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.test.d.ts.map

package/dist/helpers/format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.d.ts","sourceRoot":"","sources":["../../src/helpers/format.test.ts"],"names":[],"mappings":""}

package/dist/helpers/index.d.ts

@@ -0,0 +1,6 @@
+export { addCdnParams, buildTransformedDownloadUrl, buildEmbedUrl, transformedFileName, QUALITY_LEVELS, RESIZE_PRESETS, type TransformParams, type TransformOptions, type DownloadFormat, type QualityLevel, type ResizePreset, } from './cdn';
+export { getThumbnailUrl, getFormattedPreviewUrl, getFileTypeIconUrl, getDefaultFileTypeIconUrl, } from './thumbnail';
+export { formatFileSize, formatDate, formatDimensions } from './format';
+export { debounce } from './debounce';
+export { presetUrl, normalizeVariation, assembleVariations, type AssembleVariationsInput, } from './variations';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC"}