@liforma/publisher 0.1.0

package/dist/hash.js

@@ -0,0 +1,21 @@
+import { createHash } from 'node:crypto';
+import { LiformaPublisherError } from './errors.js';
+export async function toUint8Array(input) {
+    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(input)) {
+        return new Uint8Array(input);
+    }
+    if (input instanceof Uint8Array) {
+        return input;
+    }
+    if (input instanceof ArrayBuffer) {
+        return new Uint8Array(input);
+    }
+    if (typeof Blob !== 'undefined' && input instanceof Blob) {
+        return new Uint8Array(await input.arrayBuffer());
+    }
+    throw new LiformaPublisherError('Unsupported image input type.', { code: 'INVALID_IMAGE_INPUT' });
+}
+export function sha256Hex(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAiB;IACnD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1D,OAAO,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,qBAAqB,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAiB;IAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,20 @@
+import type { z } from 'zod';
+export type PublisherHttp = {
+    readonly baseUrl: string;
+    readonly apiKey: string;
+    readonly fetchImpl: typeof fetch;
+    readonly projectId: string;
+};
+export type RequestOptions = {
+    readonly method?: 'GET' | 'POST' | 'PATCH';
+    readonly body?: unknown;
+    readonly signal?: AbortSignal;
+    readonly retry?: boolean;
+};
+export declare function publisherRequest<T>(http: PublisherHttp, path: string, schema: z.ZodType<T>, options?: RequestOptions): Promise<{
+    data: T;
+    status: number;
+    headers: Headers;
+}>;
+export declare function projectPath(http: PublisherHttp, suffix: string): string;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,KAAK,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAqBF,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA0ExD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvE"}

package/dist/http.js

@@ -0,0 +1,93 @@
+import { isRetryableError, LiformaPublisherError, publisherErrorFromResponse } from './errors.js';
+async function sleep(ms, signal) {
+    if (ms <= 0)
+        return;
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason ?? new DOMException('Aborted', 'AbortError'));
+        };
+        if (signal?.aborted) {
+            onAbort();
+            return;
+        }
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export async function publisherRequest(http, path, schema, options = {}) {
+    const method = options.method ?? (options.body === undefined ? 'GET' : 'POST');
+    const url = `${http.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+    const maxAttempts = options.retry ? 3 : 1;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        options.signal?.throwIfAborted();
+        let response;
+        try {
+            response = await http.fetchImpl(url, {
+                method,
+                headers: {
+                    authorization: `Bearer ${http.apiKey}`,
+                    accept: 'application/json',
+                    ...(options.body === undefined ? {} : { 'content-type': 'application/json' })
+                },
+                body: options.body === undefined ? undefined : JSON.stringify(options.body),
+                signal: options.signal
+            });
+        }
+        catch (error) {
+            lastError = new LiformaPublisherError(error instanceof Error ? error.message : 'Network request failed.', {
+                code: 'NETWORK_ERROR',
+                retryable: true,
+                cause: error
+            });
+            if (attempt < maxAttempts) {
+                await sleep(100 * 2 ** (attempt - 1), options.signal);
+                continue;
+            }
+            throw lastError;
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            lastError = publisherErrorFromResponse(response.status, text, response.headers);
+            if (options.retry && isRetryableError(lastError) && attempt < maxAttempts) {
+                const retryAfter = Number(response.headers.get('retry-after'));
+                const delayMs = Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter * 1000 : 100 * 2 ** (attempt - 1);
+                await sleep(delayMs, options.signal);
+                continue;
+            }
+            throw lastError;
+        }
+        let json;
+        try {
+            json = text ? JSON.parse(text) : {};
+        }
+        catch (error) {
+            throw new LiformaPublisherError('API returned invalid JSON.', {
+                code: 'INVALID_RESPONSE',
+                status: response.status,
+                requestId: response.headers.get('Liforma-Request-Id') ?? undefined,
+                cause: error
+            });
+        }
+        const parsed = schema.safeParse(json);
+        if (!parsed.success) {
+            throw new LiformaPublisherError('API response failed schema validation.', {
+                code: 'INVALID_RESPONSE',
+                status: response.status,
+                requestId: response.headers.get('Liforma-Request-Id') ?? undefined,
+                details: { issues: parsed.error.issues }
+            });
+        }
+        return { data: parsed.data, status: response.status, headers: response.headers };
+    }
+    throw lastError ?? new LiformaPublisherError('Request failed.', { code: 'HTTP_ERROR' });
+}
+export function projectPath(http, suffix) {
+    const clean = suffix.startsWith('/') ? suffix : `/${suffix}`;
+    return `/v1/projects/${encodeURIComponent(http.projectId)}${clean}`;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createPublisher } from './createPublisher.js';
+export type { BackgroundMode, CreateCharacterInput, CreateClothesInput, CreateExperienceInput, CreateHairInput, CreateLocationInput, CreatePlaceInput, CreatePublisherOptions, Publisher, UpdateExperienceInput } from './createPublisher.js';
+export type { WaitOptions } from './jobs.js';
+export type { ImageBytes } from './hash.js';
+export type { UploadedImage } from './upload.js';
+export { LiformaPublisherError, isRetryableError } from './errors.js';
+export type { AuthoringAvatar, AuthoringJob, CharacterResource, ClothesResource, CreatePublishResponse, ExperienceResource, HairResource, LocationResource, PlaceResource } from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,qBAAqB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACX,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createPublisher } from './createPublisher.js';
+export { LiformaPublisherError, isRetryableError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAgBvD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/jobs.d.ts

@@ -0,0 +1,15 @@
+import { type PublisherHttp } from './http.js';
+import { type AuthoringJob, type ClothesResource, type CreatePublishResponse, type HairResource, type LocationResource } from './schemas.js';
+export type WaitOptions = {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly onProgress?: (job: AuthoringJob) => void;
+};
+export declare function getJob(http: PublisherHttp, jobId: string, signal?: AbortSignal): Promise<AuthoringJob>;
+export declare function retryJob(http: PublisherHttp, jobId: string, signal?: AbortSignal): Promise<CreatePublishResponse>;
+export declare function waitForJob(http: PublisherHttp, jobId: string, options?: WaitOptions): Promise<AuthoringJob>;
+export declare function watchJob(http: PublisherHttp, jobId: string, options?: WaitOptions): AsyncGenerator<AuthoringJob, AuthoringJob, void>;
+export declare function getClothes(http: PublisherHttp, clothesId: string, signal?: AbortSignal): Promise<ClothesResource>;
+export declare function getHair(http: PublisherHttp, hairId: string, signal?: AbortSignal): Promise<HairResource>;
+export declare function getLocation(http: PublisherHttp, locationId: string, signal?: AbortSignal): Promise<LocationResource>;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAMN,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;CAClD,CAAC;AA0CF,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAO5G;AAED,wBAAsB,QAAQ,CAC7B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAQhC;AAED,wBAAsB,UAAU,CAC/B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACvB,OAAO,CAAC,YAAY,CAAC,CAkCvB;AAED,wBAAuB,QAAQ,CAC9B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACvB,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC,CAkClD;AAED,wBAAsB,UAAU,CAC/B,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAED,wBAAsB,OAAO,CAC5B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED,wBAAsB,WAAW,CAChC,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/dist/jobs.js

@@ -0,0 +1,127 @@
+import { LiformaPublisherError } from './errors.js';
+import { projectPath, publisherRequest } from './http.js';
+import { createPublishResponseSchema, getClothesResponseSchema, getHairResponseSchema, getJobResponseSchema, getLocationResponseSchema } from './schemas.js';
+const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
+const MIN_POLL_MS = 500;
+const MAX_POLL_MS = 5_000;
+function clampPollDelay(ms) {
+    return Math.min(MAX_POLL_MS, Math.max(MIN_POLL_MS, ms));
+}
+function delayUntilNextRun(job, attempt) {
+    if (job.nextRunAt) {
+        const target = Date.parse(job.nextRunAt);
+        if (Number.isFinite(target)) {
+            const delta = target - Date.now();
+            if (delta > 0)
+                return clampPollDelay(delta);
+        }
+    }
+    const base = Math.min(MAX_POLL_MS, MIN_POLL_MS * 2 ** Math.min(attempt, 4));
+    const jitter = Math.floor(Math.random() * 250);
+    return clampPollDelay(base + jitter);
+}
+async function sleep(ms, signal) {
+    if (ms <= 0)
+        return;
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason ?? new DOMException('Aborted', 'AbortError'));
+        };
+        if (signal?.aborted) {
+            onAbort();
+            return;
+        }
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export async function getJob(http, jobId, signal) {
+    const { data } = await publisherRequest(http, projectPath(http, `/jobs/${encodeURIComponent(jobId)}`), getJobResponseSchema, {
+        method: 'GET',
+        signal,
+        retry: true
+    });
+    return data.job;
+}
+export async function retryJob(http, jobId, signal) {
+    const { data } = await publisherRequest(http, projectPath(http, `/jobs/${encodeURIComponent(jobId)}/retry`), createPublishResponseSchema, { method: 'POST', signal });
+    return data;
+}
+export async function waitForJob(http, jobId, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const deadline = Date.now() + timeoutMs;
+    let attempt = 0;
+    while (true) {
+        options.signal?.throwIfAborted();
+        if (Date.now() > deadline) {
+            throw new LiformaPublisherError(`Timed out waiting for job ${jobId} after ${timeoutMs}ms.`, {
+                code: 'JOB_TIMEOUT',
+                retryable: true
+            });
+        }
+        const job = await getJob(http, jobId, options.signal);
+        options.onProgress?.(job);
+        if (job.status === 'succeeded' && job.requiredOk) {
+            return job;
+        }
+        if (job.status === 'failed') {
+            throw new LiformaPublisherError(job.error?.message ?? `Job ${jobId} failed.`, {
+                code: job.error?.code ?? 'JOB_FAILED',
+                retryable: false,
+                job: job
+            });
+        }
+        const remaining = deadline - Date.now();
+        const waitMs = Math.min(delayUntilNextRun(job, attempt), Math.max(0, remaining));
+        attempt += 1;
+        await sleep(waitMs, options.signal);
+    }
+}
+export async function* watchJob(http, jobId, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const deadline = Date.now() + timeoutMs;
+    let attempt = 0;
+    while (true) {
+        options.signal?.throwIfAborted();
+        if (Date.now() > deadline) {
+            throw new LiformaPublisherError(`Timed out waiting for job ${jobId} after ${timeoutMs}ms.`, {
+                code: 'JOB_TIMEOUT',
+                retryable: true
+            });
+        }
+        const job = await getJob(http, jobId, options.signal);
+        options.onProgress?.(job);
+        yield job;
+        if (job.status === 'succeeded' && job.requiredOk) {
+            return job;
+        }
+        if (job.status === 'failed') {
+            throw new LiformaPublisherError(job.error?.message ?? `Job ${jobId} failed.`, {
+                code: job.error?.code ?? 'JOB_FAILED',
+                retryable: false,
+                job: job
+            });
+        }
+        const remaining = deadline - Date.now();
+        const waitMs = Math.min(delayUntilNextRun(job, attempt), Math.max(0, remaining));
+        attempt += 1;
+        await sleep(waitMs, options.signal);
+    }
+}
+export async function getClothes(http, clothesId, signal) {
+    const { data } = await publisherRequest(http, projectPath(http, `/clothes/${encodeURIComponent(clothesId)}`), getClothesResponseSchema, { method: 'GET', signal, retry: true });
+    return data.resource;
+}
+export async function getHair(http, hairId, signal) {
+    const { data } = await publisherRequest(http, projectPath(http, `/hair/${encodeURIComponent(hairId)}`), getHairResponseSchema, { method: 'GET', signal, retry: true });
+    return data.resource;
+}
+export async function getLocation(http, locationId, signal) {
+    const { data } = await publisherRequest(http, projectPath(http, `/locations/${encodeURIComponent(locationId)}`), getLocationResponseSchema, { method: 'GET', signal, retry: true });
+    return data.resource;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,4 @@
+export declare function assertServerRuntime(): void;
+export declare function resolveApiKey(explicit?: string): string;
+export declare function resolveBaseUrl(explicit?: string): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C;AAED,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/runtime.js

@@ -0,0 +1,19 @@
+import { LiformaPublisherError } from './errors.js';
+export function assertServerRuntime() {
+    const g = globalThis;
+    if (typeof g.window !== 'undefined' || typeof g.document !== 'undefined') {
+        throw new LiformaPublisherError('@liforma/publisher is server-only. Call it from Node (or another server runtime), never from a browser.', { code: 'BROWSER_NOT_SUPPORTED' });
+    }
+}
+export function resolveApiKey(explicit) {
+    const key = (explicit ?? process.env.LIFORMA_API_KEY ?? '').trim();
+    if (!key) {
+        throw new LiformaPublisherError('Missing API key. Pass apiKey to createPublisher() or set LIFORMA_API_KEY.', { code: 'MISSING_API_KEY' });
+    }
+    return key;
+}
+export function resolveBaseUrl(explicit) {
+    const raw = (explicit ?? process.env.LIFORMA_API_URL ?? 'https://api.liforma.ai').trim();
+    return raw.replace(/\/$/, '');
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,mBAAmB;IAClC,MAAM,CAAC,GAAG,UAAsD,CAAC;IACjE,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC1E,MAAM,IAAI,qBAAqB,CAC9B,yGAAyG,EACzG,EAAE,IAAI,EAAE,uBAAuB,EAAE,CACjC,CAAC;IACH,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC9C,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,qBAAqB,CAC9B,2EAA2E,EAC3E,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAC3B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC/C,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB,CAAC,CAAC,IAAI,EAAE,CAAC;IACzF,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC"}