@diskd-ai/sdk 5.1.2

package/dist/tgUserbot/tgUserbot.js

@@ -0,0 +1,314 @@
+import { resolveDiskdGatewayUrl } from '../env/baseUrl.js';
+const isObject = (value) => typeof value === 'object' && value !== null;
+const str = (obj, key) => {
+    const v = obj[key];
+    return typeof v === 'string' ? v : undefined;
+};
+const num = (obj, key) => {
+    const v = obj[key];
+    return typeof v === 'number' ? v : undefined;
+};
+const bool = (obj, key) => {
+    const v = obj[key];
+    return typeof v === 'boolean' ? v : undefined;
+};
+const buildQueryString = (params) => {
+    const entries = Object.entries(params).filter(([, v]) => v !== undefined && v !== '');
+    if (entries.length === 0)
+        return '';
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of entries) {
+        searchParams.set(key, String(value));
+    }
+    return `?${searchParams.toString()}`;
+};
+// ---------------------------------------------------------------------------
+// Response decoders -- explicit snake_case -> camelCase per field
+// ---------------------------------------------------------------------------
+const decodeTask = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: task must be an object');
+    return {
+        taskUuid: str(o, 'task_uuid') ?? '',
+        status: str(o, 'status') ?? 'running',
+        progressPercentage: num(o, 'progress_percentage') ?? 0,
+        messagesProcessed: num(o, 'messages_processed') ?? 0,
+        totalMessagesToProcess: num(o, 'total_messages_to_process') ?? 0,
+        errorMessage: str(o, 'error_message'),
+        createdAt: str(o, 'created_at') ?? '',
+        updatedAt: str(o, 'updated_at') ?? '',
+    };
+};
+const decodeChannel = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: channel must be an object');
+    return {
+        id: num(o, 'id') ?? 0,
+        telegramId: num(o, 'telegram_id') ?? 0,
+        title: str(o, 'title') ?? '',
+        username: str(o, 'username'),
+        isPublic: bool(o, 'is_public') ?? false,
+        participantsCount: num(o, 'participants_count'),
+        status: str(o, 'status') ?? 'new',
+        totalMessages: num(o, 'total_messages') ?? 0,
+        createdAt: str(o, 'created_at') ?? '',
+        updatedAt: str(o, 'updated_at') ?? '',
+    };
+};
+const decodeChannelResolveResult = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: resolve result must be an object');
+    return {
+        telegramId: num(o, 'telegram_id') ?? 0,
+        title: str(o, 'title') ?? '',
+        username: str(o, 'username'),
+        isPublic: bool(o, 'is_public') ?? false,
+        participantsCount: num(o, 'participants_count'),
+    };
+};
+const decodeChannelAddResult = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: channel add result must be an object');
+    const rawTask = o.task;
+    return {
+        message: str(o, 'message') ?? '',
+        action: str(o, 'action') ?? 'created',
+        channel: decodeChannel(o.channel),
+        task: rawTask !== undefined && rawTask !== null ? decodeTask(rawTask) : undefined,
+    };
+};
+const decodeChannelStatusResult = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: channel status must be an object');
+    const rawLastTask = o.last_task;
+    return {
+        channelStatus: str(o, 'channel_status') ?? '',
+        lastTask: rawLastTask !== undefined && rawLastTask !== null ? decodeTask(rawLastTask) : undefined,
+    };
+};
+const decodeMessage = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: message must be an object');
+    return {
+        id: num(o, 'id') ?? 0,
+        channelTelegramId: num(o, 'channel_telegram_id') ?? 0,
+        senderId: num(o, 'sender_id'),
+        senderName: str(o, 'sender_name'),
+        text: str(o, 'text'),
+        date: str(o, 'date') ?? '',
+        replyToMessageId: num(o, 'reply_to_message_id'),
+        isForward: bool(o, 'is_forward') ?? false,
+        views: num(o, 'views'),
+        createdAt: str(o, 'created_at'),
+    };
+};
+const decodeMessagesResult = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: messages result must be an object');
+    const rawMessages = o.messages;
+    const messages = Array.isArray(rawMessages) ? rawMessages.map(decodeMessage) : [];
+    return {
+        totalMessagesInDb: num(o, 'total_messages_in_db') ?? 0,
+        messages,
+    };
+};
+const decodeChannelStatsResult = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: stats result must be an object');
+    const rawDateRange = o.date_range;
+    let dateRange;
+    if (isObject(rawDateRange)) {
+        dateRange = {
+            earliest: str(rawDateRange, 'earliest') ?? '',
+            latest: str(rawDateRange, 'latest') ?? '',
+        };
+    }
+    return {
+        totalMessages: num(o, 'total_messages') ?? 0,
+        dateRange,
+    };
+};
+const decodeTaskListResult = (o) => {
+    if (!isObject(o))
+        throw new Error('Invalid TG Userbot response: task list result must be an object');
+    const rawRunning = o.running_tasks;
+    const runningTasks = {};
+    if (isObject(rawRunning)) {
+        for (const [uuid, rawTask] of Object.entries(rawRunning)) {
+            runningTasks[uuid] = decodeTask(rawTask);
+        }
+    }
+    return { runningTasks };
+};
+const encodeChannelAddParams = (params) => ({
+    channel_identifier: params.channelIdentifier,
+    ...(params.limit !== undefined ? { limit: params.limit } : {}),
+    ...(params.forceRecreate !== undefined ? { force_recreate: params.forceRecreate } : {}),
+});
+const encodeChannelSyncParams = (params) => ({
+    telegram_id: params.telegramId,
+    ...(params.limit !== undefined ? { limit: params.limit } : {}),
+});
+const encodeMessagesParams = (params) => ({
+    limit: params.limit,
+    offset: params.offset,
+    start_date: params.startDate,
+    end_date: params.endDate,
+    search_text: params.searchText,
+});
+const httpRequest = async (options) => {
+    const headers = { ...options.authHeaders };
+    if (options.body !== undefined) {
+        headers['Content-Type'] = 'application/json';
+    }
+    if (options.workspaceId !== undefined) {
+        headers['X-Workspace-Id'] = options.workspaceId;
+    }
+    const response = await fetch(options.url, {
+        method: options.method,
+        headers,
+        body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+    });
+    if (!response.ok) {
+        let message = `HTTP ${response.status}`;
+        try {
+            const errorData = (await response.json());
+            if (isObject(errorData)) {
+                const err = errorData.error;
+                if (isObject(err) && typeof err.message === 'string') {
+                    message = err.message;
+                }
+                else if (typeof errorData.message === 'string') {
+                    message = errorData.message;
+                }
+                else if (typeof errorData.detail === 'string') {
+                    message = errorData.detail;
+                }
+            }
+        }
+        catch {
+            // Could not parse error body -- use default message
+        }
+        throw new Error(`TG Userbot request failed (${response.status}): ${message}`);
+    }
+    if (response.status === 204) {
+        return undefined;
+    }
+    return (await response.json());
+};
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a TG Userbot REST client bound to a given auth module and workspace.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/utils/tg-userbot` path prefix.
+ *
+ * The workspace is derived from `auth.getWorkspaceId()` and forwarded as
+ * `X-Workspace-Id` on all authenticated endpoints. The `channels.resolve`
+ * endpoint is public and does not require it.
+ *
+ * Example:
+ * ```ts
+ * const tg = createTgUserbotClient({ auth });
+ * const channels = await tg.channels.list();
+ * ```
+ */
+export const createTgUserbotClient = (params) => {
+    const baseUrl = (params.url ?? resolveDiskdGatewayUrl('utils/tg-userbot')).replace(/\/+$/, '');
+    const resolveWorkspaceId = async () => await params.auth.getWorkspaceId();
+    const getAuthHeaders = async () => {
+        if (params.auth.getRequestHeaders) {
+            return params.auth.getRequestHeaders();
+        }
+        const token = await params.auth.getAccessToken();
+        return { Authorization: `Bearer ${token}` };
+    };
+    const request = async (method, path, opts = {}) => {
+        const authHeaders = await getAuthHeaders();
+        const qs = opts.query ? buildQueryString(opts.query) : '';
+        return httpRequest({
+            method,
+            url: `${baseUrl}${path}${qs}`,
+            authHeaders,
+            workspaceId: opts.withWorkspace !== false ? await resolveWorkspaceId() : undefined,
+            body: opts.body,
+        });
+    };
+    /** Public request -- no auth headers, no workspace id. */
+    const publicRequest = async (path, query) => {
+        const qs = query ? buildQueryString(query) : '';
+        return httpRequest({
+            method: 'GET',
+            url: `${baseUrl}${path}${qs}`,
+            authHeaders: {},
+        });
+    };
+    return {
+        channels: {
+            resolve: async (identifier) => {
+                const raw = await publicRequest('/api/v1/channels/resolve', {
+                    identifier,
+                });
+                return decodeChannelResolveResult(raw);
+            },
+            add: async (addParams) => {
+                const raw = await request('POST', '/api/v1/channels', {
+                    withWorkspace: true,
+                    body: encodeChannelAddParams(addParams),
+                });
+                return decodeChannelAddResult(raw);
+            },
+            sync: async (syncParams) => {
+                const raw = await request('POST', `/api/v1/channels/${syncParams.telegramId}/sync`, {
+                    withWorkspace: true,
+                    body: encodeChannelSyncParams(syncParams),
+                });
+                return decodeChannelAddResult(raw);
+            },
+            list: async () => {
+                const raw = await request('GET', '/api/v1/channels', {
+                    withWorkspace: true,
+                });
+                return raw.map(decodeChannel);
+            },
+            getStatus: async (channelId) => {
+                const raw = await request('GET', `/api/v1/channels/${channelId}/status`, {
+                    withWorkspace: true,
+                });
+                return decodeChannelStatusResult(raw);
+            },
+            getMessages: async (channelId, msgParams) => {
+                const raw = await request('GET', `/api/v1/channels/${channelId}/messages`, {
+                    withWorkspace: true,
+                    query: msgParams ? encodeMessagesParams(msgParams) : undefined,
+                });
+                return decodeMessagesResult(raw);
+            },
+            getStats: async (channelId) => {
+                const raw = await request('GET', `/api/v1/channels/${channelId}/stats`, {
+                    withWorkspace: true,
+                });
+                return decodeChannelStatsResult(raw);
+            },
+            delete: async (channelId) => {
+                await request('DELETE', `/api/v1/channels/${channelId}`, { withWorkspace: true });
+            },
+        },
+        tasks: {
+            list: async () => {
+                const raw = await request('GET', '/api/v1/tasks', {
+                    withWorkspace: true,
+                });
+                return decodeTaskListResult(raw);
+            },
+            cancel: async (taskUuid) => {
+                await request('DELETE', `/api/v1/tasks/${encodeURIComponent(taskUuid)}`, {
+                    withWorkspace: true,
+                });
+            },
+        },
+    };
+};
+//# sourceMappingURL=tgUserbot.js.map

package/dist/tgUserbot/tgUserbot.js.map

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

package/dist/tgUserbot/tgUserbotTypes.d.ts

@@ -0,0 +1,124 @@
+export type TgChannelStatus = 'new' | 'idle' | 'syncing' | 'error';
+export type TgChannel = {
+    readonly id: number;
+    readonly telegramId: number;
+    readonly title: string;
+    readonly username?: string;
+    readonly isPublic: boolean;
+    readonly participantsCount?: number;
+    readonly status: TgChannelStatus;
+    readonly totalMessages: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+export type TgChannelResolveResult = {
+    readonly telegramId: number;
+    readonly title: string;
+    readonly username?: string;
+    readonly isPublic: boolean;
+    readonly participantsCount?: number;
+};
+export type TgTaskStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export type TgTask = {
+    readonly taskUuid: string;
+    readonly status: TgTaskStatus;
+    readonly progressPercentage: number;
+    readonly messagesProcessed: number;
+    readonly totalMessagesToProcess: number;
+    readonly errorMessage?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+export type TgChannelAddParams = {
+    readonly channelIdentifier: string;
+    readonly limit?: number;
+    readonly forceRecreate?: boolean;
+};
+export type TgChannelAddAction = 'created' | 'sync_started' | 'already_syncing' | 'recreated';
+export type TgChannelAddResult = {
+    readonly message: string;
+    readonly action: TgChannelAddAction;
+    readonly channel: TgChannel;
+    readonly task?: TgTask;
+};
+export type TgChannelSyncParams = {
+    readonly telegramId: number;
+    readonly limit?: number;
+};
+export type TgChannelStatusResult = {
+    readonly channelStatus: string;
+    readonly lastTask?: TgTask;
+};
+export type TgMessage = {
+    readonly id: number;
+    readonly channelTelegramId: number;
+    readonly senderId?: number;
+    readonly senderName?: string;
+    readonly text?: string;
+    readonly date: string;
+    readonly replyToMessageId?: number;
+    readonly isForward: boolean;
+    readonly views?: number;
+    readonly createdAt?: string;
+};
+export type TgMessagesParams = {
+    /** Number of messages to return (1-1000, default 100). */
+    readonly limit?: number;
+    readonly offset?: number;
+    readonly startDate?: string;
+    readonly endDate?: string;
+    readonly searchText?: string;
+};
+export type TgMessagesResult = {
+    readonly totalMessagesInDb: number;
+    readonly messages: readonly TgMessage[];
+};
+export type TgChannelStatsResult = {
+    readonly totalMessages: number;
+    readonly dateRange?: {
+        readonly earliest: string;
+        readonly latest: string;
+    };
+};
+/**
+ * Wire-format map of running tasks keyed by task UUID.
+ * Record<string, TgTask> is acceptable here because it represents a
+ * server-side keyed map, not a domain object.
+ */
+export type TgTaskListResult = {
+    readonly runningTasks: Record<string, TgTask>;
+};
+/**
+ * TG Userbot REST client organized by namespace.
+ *
+ * Obtain via `createTgUserbotClient`. The workspace is derived from `auth.getWorkspaceId()`
+ * time and is forwarded as `X-Workspace-Id` on all authenticated endpoints.
+ * The `channels.resolve` endpoint is public and does not require auth.
+ */
+export type TgUserbotClient = {
+    readonly channels: {
+        /** GET /api/v1/channels/resolve?identifier={identifier} -- resolve a channel by username or invite link (no auth). */
+        readonly resolve: (identifier: string) => Promise<TgChannelResolveResult>;
+        /** POST /api/v1/channels -- add a channel and start sync. */
+        readonly add: (params: TgChannelAddParams) => Promise<TgChannelAddResult>;
+        /** POST /api/v1/channels/{channelId}/sync -- trigger a sync for an existing channel. */
+        readonly sync: (params: TgChannelSyncParams) => Promise<TgChannelAddResult>;
+        /** GET /api/v1/channels -- list all channels for the workspace. */
+        readonly list: () => Promise<readonly TgChannel[]>;
+        /** GET /api/v1/channels/{channelId}/status -- get current status and last task. */
+        readonly getStatus: (channelId: number) => Promise<TgChannelStatusResult>;
+        /** GET /api/v1/channels/{channelId}/messages -- fetch messages with optional filters. */
+        readonly getMessages: (channelId: number, params?: TgMessagesParams) => Promise<TgMessagesResult>;
+        /** GET /api/v1/channels/{channelId}/stats -- get aggregate stats. */
+        readonly getStats: (channelId: number) => Promise<TgChannelStatsResult>;
+        /** DELETE /api/v1/channels/{channelId} -- delete a channel and all its data. */
+        readonly delete: (channelId: number) => Promise<void>;
+    };
+    readonly tasks: {
+        /** GET /api/v1/tasks -- list all running tasks. */
+        readonly list: () => Promise<TgTaskListResult>;
+        /** DELETE /api/v1/tasks/{taskUuid} -- cancel a running task. */
+        readonly cancel: (taskUuid: string) => Promise<void>;
+    };
+};
+//# sourceMappingURL=tgUserbotTypes.d.ts.map

package/dist/tgUserbot/tgUserbotTypes.d.ts.map

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

package/dist/tgUserbot/tgUserbotTypes.js

@@ -0,0 +1,5 @@
+// Domain types for the TG Userbot API.
+// These are pure data types only -- no classes, no I/O, no side effects.
+// The TG Userbot REST API uses snake_case on the wire; encode/decode happens in tgUserbot.ts.
+export {};
+//# sourceMappingURL=tgUserbotTypes.js.map

package/dist/tgUserbot/tgUserbotTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tgUserbotTypes.js","sourceRoot":"","sources":["../../src/tgUserbot/tgUserbotTypes.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,yEAAyE;AACzE,8FAA8F"}

package/dist/webNavigator/webNavigator.d.ts

@@ -0,0 +1,22 @@
+import type { AuthModule } from '../auth/types.js';
+import type { WebNavigatorClient } from './webNavigatorTypes.js';
+/**
+ * Creates a Web Navigator REST client bound to a given auth module and workspace.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/utils/web-navigator` path prefix.
+ *
+ * The workspace is derived from `auth.getWorkspaceId()` and forwarded as
+ * `X-Workspace-Id` on all requests.
+ *
+ * Example:
+ * ```ts
+ * const nav = createWebNavigatorClient({ auth });
+ * const job = await nav.scrape.submit({ url: 'https://example.com', depth: 1 });
+ * ```
+ */
+export declare const createWebNavigatorClient: (params: {
+    readonly auth: AuthModule;
+    readonly url?: string;
+}) => WebNavigatorClient;
+//# sourceMappingURL=webNavigator.d.ts.map

package/dist/webNavigator/webNavigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webNavigator.d.ts","sourceRoot":"","sources":["../../src/webNavigator/webNavigator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAQV,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAMhC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ;IAC/C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB,KAAG,kBAkDH,CAAC"}

package/dist/webNavigator/webNavigator.js

@@ -0,0 +1,46 @@
+import { resolveDiskdGatewayUrl } from '../env/baseUrl.js';
+import { httpRequest, resolveAuthHeaders } from '../sdk/http.js';
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a Web Navigator REST client bound to a given auth module and workspace.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/utils/web-navigator` path prefix.
+ *
+ * The workspace is derived from `auth.getWorkspaceId()` and forwarded as
+ * `X-Workspace-Id` on all requests.
+ *
+ * Example:
+ * ```ts
+ * const nav = createWebNavigatorClient({ auth });
+ * const job = await nav.scrape.submit({ url: 'https://example.com', depth: 1 });
+ * ```
+ */
+export const createWebNavigatorClient = (params) => {
+    const baseUrl = (params.url ?? resolveDiskdGatewayUrl('utils/web-navigator')).replace(/\/+$/, '');
+    const resolveWorkspaceId = async () => await params.auth.getWorkspaceId();
+    const request = async (method, path, opts = {}) => {
+        const authHeaders = await resolveAuthHeaders(params.auth);
+        return httpRequest({
+            method,
+            url: `${baseUrl}${path}`,
+            authHeaders,
+            workspaceId: await resolveWorkspaceId(),
+            body: opts.body,
+        }, 'Web Navigator');
+    };
+    return {
+        scrape: {
+            submit: async (scrapeParams) => request('POST', '/api/v1/scrape', { body: scrapeParams }),
+            sync: async (scrapeParams) => request('POST', '/api/v1/scrape/sync', { body: scrapeParams }),
+            getJob: async (jobId) => request('GET', `/api/v1/scrape/${encodeURIComponent(jobId)}`),
+            getStatus: async (jobId) => request('GET', `/api/v1/scrape/${encodeURIComponent(jobId)}/status`),
+            getResult: async (jobId) => request('GET', `/api/v1/scrape/${encodeURIComponent(jobId)}/result`),
+            cancel: async (jobId) => request('POST', `/api/v1/scrape/${encodeURIComponent(jobId)}/cancel`),
+        },
+        resolve: async (resolveParams) => request('POST', '/api/v1/resolve', { body: resolveParams }),
+    };
+};
+//# sourceMappingURL=webNavigator.js.map

package/dist/webNavigator/webNavigator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webNavigator.js","sourceRoot":"","sources":["../../src/webNavigator/webNavigator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAmB,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAYlF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAGxC,EAAsB,EAAE;IACvB,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElG,MAAM,kBAAkB,GAAG,KAAK,IAAiC,EAAE,CACjE,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,KAAK,EACnB,MAAkB,EAClB,IAAY,EACZ,OAEI,EAAE,EACM,EAAE;QACd,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,WAAW,CAChB;YACE,MAAM;YACN,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,EAAE;YACxB,WAAW;YACX,WAAW,EAAE,MAAM,kBAAkB,EAAE;YACvC,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE;YACN,MAAM,EAAE,KAAK,EAAE,YAA0B,EAA+B,EAAE,CACxE,OAAO,CAAqB,MAAM,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAE/E,IAAI,EAAE,KAAK,EAAE,YAA0B,EAA+B,EAAE,CACtE,OAAO,CAAqB,MAAM,EAAE,qBAAqB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAEpF,MAAM,EAAE,KAAK,EAAE,KAAa,EAAsB,EAAE,CAClD,OAAO,CAAY,KAAK,EAAE,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAE1E,SAAS,EAAE,KAAK,EAAE,KAAa,EAA4B,EAAE,CAC3D,OAAO,CAAkB,KAAK,EAAE,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC;YAEvF,SAAS,EAAE,KAAK,EAAE,KAAa,EAAyB,EAAE,CACxD,OAAO,CAAe,KAAK,EAAE,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC;YAEpF,MAAM,EAAE,KAAK,EAAE,KAAa,EAAsB,EAAE,CAClD,OAAO,CAAY,MAAM,EAAE,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC;SACnF;QAED,OAAO,EAAE,KAAK,EAAE,aAA4B,EAA0B,EAAE,CACtE,OAAO,CAAgB,MAAM,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;KAC7E,CAAC;AACJ,CAAC,CAAC"}