@clowder-ai/connector-telegram 0.0.0-stage → 0.1.0-alpha.5

package/dist/runtime.d.ts

@@ -0,0 +1,61 @@
+import { TelegramAdapter, type InlineFinalPersistence, type TelegramInboundMessage } from './TelegramAdapter.js';
+import type { ConnectorLogger } from './types.js';
+export interface TelegramRuntimeConfig {
+    /** Manifest-declared secret projected explicitly by the Host. */
+    readonly botToken: string;
+}
+export interface TelegramInboundAttachment {
+    readonly type: 'image' | 'file' | 'audio';
+    readonly platformKey: string;
+    readonly fileName?: string;
+    readonly duration?: number;
+}
+/**
+ * Provider facts delivered to the Host-owned connector binding layer.
+ *
+ * This deliberately carries no Clowder address or thread identifier: only the
+ * Host may resolve the installed connector instance to an authenticated
+ * `connector_binding` and derive admission or wake behavior.
+ */
+export interface TelegramHostInboundMessage {
+    readonly externalConversationId: string;
+    readonly externalSenderId: string;
+    readonly providerMessageId: string;
+    readonly text: string;
+    readonly attachments?: readonly TelegramInboundAttachment[];
+}
+export interface TelegramRuntimeHost {
+    deliver(message: TelegramHostInboundMessage): Promise<void>;
+}
+export interface TelegramOutbound {
+    readonly connectorId: string;
+    sendReply(externalChatId: string, content: string, metadata?: Record<string, unknown>): Promise<void>;
+}
+export interface TelegramRuntimeAdapter extends TelegramOutbound {
+    startPolling(handler: (message: TelegramInboundMessage) => Promise<void>): void | Promise<void>;
+    stopPolling(): Promise<void>;
+}
+export interface TelegramConnectorRuntime<Adapter extends TelegramRuntimeAdapter = TelegramAdapter> {
+    /** Provider egress implementation consumed by the Host's generic delivery adapter. */
+    readonly outbound: Adapter;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** True while the provider polling loop is running. */
+    isPolling(): boolean;
+}
+export interface TelegramConnectorRuntimeOptions<Adapter extends TelegramRuntimeAdapter = TelegramAdapter> {
+    readonly config: TelegramRuntimeConfig;
+    readonly host: TelegramRuntimeHost;
+    readonly logger: ConnectorLogger;
+    /** Durable backing for the lifecycle-keyed inline-final map; omitting keeps it in-memory only. */
+    readonly inlineFinalPersistence?: InlineFinalPersistence;
+    readonly createAdapter?: (normalizedBotToken: string, logger: ConnectorLogger, persistence?: InlineFinalPersistence) => Adapter;
+}
+/**
+ * Composes Telegram provider I/O without importing Core or reading ambient
+ * process state. The Host injects the declared secret and receives provider
+ * facts; binding lookup, admission, wake routing, retry, and settlement remain
+ * outside this package runtime.
+ */
+export declare function createTelegramConnectorRuntime<Adapter extends TelegramRuntimeAdapter = TelegramAdapter>(options: TelegramConnectorRuntimeOptions<Adapter>): TelegramConnectorRuntime<Adapter>;
+//# 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":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,CACP,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,sBAAsB,GAAG,eAAe;IAChG,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uDAAuD;IACvD,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,+BAA+B,CAAC,OAAO,SAAS,sBAAsB,GAAG,eAAe;IACvG,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,kGAAkG;IAClG,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;CACjI;AAkBD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,SAAS,sBAAsB,GAAG,eAAe,EACrG,OAAO,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAChD,wBAAwB,CAAC,OAAO,CAAC,CAwDnC"}

package/dist/runtime.js

@@ -0,0 +1,82 @@
+import { TelegramAdapter, } from './TelegramAdapter.js';
+import { normalizeTelegramBotToken } from './token.js';
+function hostMessage(message) {
+    const attachments = message.attachments?.map(attachment => ({
+        type: attachment.type,
+        platformKey: attachment.telegramFileId,
+        ...(attachment.fileName === undefined ? {} : { fileName: attachment.fileName }),
+        ...(attachment.duration === undefined ? {} : { duration: attachment.duration }),
+    }));
+    return {
+        externalConversationId: message.chatId,
+        externalSenderId: message.senderId,
+        providerMessageId: message.messageId,
+        text: message.text,
+        ...(attachments === undefined ? {} : { attachments }),
+    };
+}
+/**
+ * Composes Telegram provider I/O without importing Core or reading ambient
+ * process state. The Host injects the declared secret and receives provider
+ * facts; binding lookup, admission, wake routing, retry, and settlement remain
+ * outside this package runtime.
+ */
+export function createTelegramConnectorRuntime(options) {
+    const token = normalizeTelegramBotToken(options.config.botToken);
+    if (token === null)
+        throw new TypeError('botToken must be a valid Telegram Bot token');
+    const createAdapter = options.createAdapter ?? ((value, logger, persistence) => new TelegramAdapter(value, logger, persistence));
+    const outbound = createAdapter(token, options.logger, options.inlineFinalPersistence);
+    let state = 'idle';
+    let startPromise;
+    let stopPromise;
+    const deliverIfRunning = async (message) => {
+        if (state !== 'running')
+            return;
+        await options.host.deliver(hostMessage(message));
+    };
+    return {
+        outbound,
+        start() {
+            if (state === 'stopped')
+                return Promise.reject(new Error('Telegram connector runtime has been stopped'));
+            if (startPromise !== undefined)
+                return startPromise;
+            state = 'starting';
+            startPromise = Promise.resolve()
+                .then(() => outbound.startPolling(deliverIfRunning))
+                .then(() => {
+                if (state !== 'stopped') {
+                    state = 'running';
+                    options.logger.info('[TelegramRuntime] Provider polling started');
+                }
+            })
+                .catch((error) => {
+                if (state !== 'stopped') {
+                    state = 'idle';
+                    startPromise = undefined;
+                }
+                throw error;
+            });
+            return startPromise;
+        },
+        isPolling() {
+            return state === 'running';
+        },
+        stop() {
+            if (stopPromise !== undefined)
+                return stopPromise;
+            if (state === 'idle') {
+                state = 'stopped';
+                return Promise.resolve();
+            }
+            state = 'stopped';
+            stopPromise = (async () => {
+                await startPromise?.catch(() => undefined);
+                await outbound.stopPolling();
+            })();
+            return stopPromise;
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/telegram-html-formatter.d.ts

@@ -0,0 +1,3 @@
+import type { RichBlock } from './types.js';
+export declare function formatTelegramHtml(blocks: RichBlock[], catDisplayName: string, textContent?: string): string;
+//# sourceMappingURL=telegram-html-formatter.d.ts.map

package/dist/telegram-html-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-html-formatter.d.ts","sourceRoot":"","sources":["../src/telegram-html-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmC5C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5G"}

package/dist/telegram-html-formatter.js

@@ -0,0 +1,42 @@
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function blockToHtml(block) {
+    switch (block.kind) {
+        case 'card': {
+            const parts = [`📋 <b>${esc(block.title)}</b>`];
+            if (block.bodyMarkdown)
+                parts.push(esc(block.bodyMarkdown));
+            if (block.fields?.length) {
+                parts.push(block.fields.map((f) => `<b>${esc(f.label)}</b>: ${esc(f.value)}`).join('\n'));
+            }
+            return parts.join('\n');
+        }
+        case 'checklist': {
+            const header = block.title ? `☑️ <b>${esc(block.title)}</b>` : '☑️ <b>Checklist</b>';
+            const items = block.items.map((i) => `${i.checked ? '✅' : '☐'} ${esc(i.text)}`).join('\n');
+            return `${header}\n${items}`;
+        }
+        case 'diff':
+            return `📝 <b>${esc(block.filePath)}</b>\n<pre>${esc(block.diff)}</pre>`;
+        case 'audio':
+            return block.text ? `🔊 ${esc(block.text)}` : '🔊 [Audio]';
+        case 'media_gallery': {
+            const header = block.title ? `🖼️ <b>${esc(block.title)}</b>` : '🖼️ <b>Gallery</b>';
+            const items = block.items.map((i) => esc(i.caption || i.alt || i.url)).join('\n');
+            return `${header}\n${items}`;
+        }
+        default:
+            return `[${esc(block.kind)}]`;
+    }
+}
+export function formatTelegramHtml(blocks, catDisplayName, textContent) {
+    const header = `<b>【${esc(catDisplayName)}🐱】</b>`;
+    const parts = [header];
+    if (textContent) {
+        parts.push(esc(textContent));
+    }
+    parts.push(blocks.map(blockToHtml).join('\n\n'));
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=telegram-html-formatter.js.map

package/dist/telegram-html-formatter.js.map

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

package/dist/thread-mappings.d.ts

@@ -0,0 +1,46 @@
+import type { FeatureContext } from '@clowder-ai/plugin-sdk';
+type Mapping = {
+    readonly key: string;
+    readonly threadId: string;
+    readonly createdAt: number;
+};
+type Creation = {
+    readonly title: string;
+    readonly parentThreadId?: string;
+    readonly participants?: readonly string[];
+};
+export declare function threadMappings(context: FeatureContext): {
+    findByKey: (name: string) => Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary | null>;
+    bind: (name: string, threadId: string) => Promise<boolean | Mapping>;
+    unbind: (name: string) => Promise<boolean | Mapping>;
+    listBindings: () => Promise<Mapping[]>;
+    ensureByKey: (name: string, input: Creation) => Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    ensureSystemThread: () => Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    get(threadId: string): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary | null>;
+    list(options?: {
+        readonly limit?: number;
+        readonly before?: {
+            readonly lastActiveAt: number;
+            readonly id: string;
+        };
+    }): Promise<readonly import("@clowder-ai/plugin-sdk").PluginThreadSummary[]>;
+    readMessages(threadId: string, options: {
+        readonly before?: {
+            readonly timestamp: number;
+            readonly id: string;
+        };
+        readonly limit: number;
+    }): Promise<readonly import("@clowder-ai/plugin-sdk").PluginThreadMessage[]>;
+    getCats(threadId: string): Promise<import("@clowder-ai/plugin-sdk").PluginThreadCats>;
+    addParticipants(input: {
+        readonly threadId: string;
+        readonly catIds: readonly string[];
+    }): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    create(input: import("@clowder-ai/plugin-sdk").PluginThreadCreateInput): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    update(threadId: string, patch: {
+        readonly title?: string;
+        readonly preferredCats?: readonly string[];
+    }): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+};
+export {};
+//# sourceMappingURL=thread-mappings.d.ts.map

package/dist/thread-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-mappings.d.ts","sourceRoot":"","sources":["../src/thread-mappings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AA+CxH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc;sBA/B1B,MAAM;iBAwBjB,MAAM,YAAY,MAAM;mBACtB,MAAM;;wBAVD,MAAM,SAAS,QAAQ;;;;sBAkBT,CAAC;uBAAiC,CAAC;;;;;;uBAG2M,CAAC;;;;;;;;;;;;;sBAA2f,CAAC;8BAAwC,CAAC;;EADzzB"}

package/dist/thread-mappings.js

@@ -0,0 +1,62 @@
+const contexts = new WeakMap();
+/** Package-owned external-conversation mapping. Host receives ordinary thread calls only. */
+function createMappings(context) {
+    const key = 'thread-mappings.v1';
+    let tail = Promise.resolve();
+    const serialize = (run) => {
+        const next = tail.then(run, run);
+        tail = next.catch(() => { });
+        return next;
+    };
+    const read = async () => {
+        const stored = await context.storage.get(key);
+        const rows = stored?.value ?? [];
+        if (!Array.isArray(rows) || rows.some(row => !row || typeof row.key !== 'string' || typeof row.threadId !== 'string' || typeof row.createdAt !== 'number'))
+            throw new Error('Invalid plugin thread mappings');
+        return { stored, rows: rows };
+    };
+    const find = async (name) => {
+        const { rows } = await read();
+        const row = rows.find(row => row.key === name);
+        return row ? context.threads.get(row.threadId) : null;
+    };
+    const save = async (name, threadId) => {
+        const { stored, rows } = await read();
+        const next = rows.filter(row => row.key !== name);
+        if (threadId !== null) {
+            if (!await context.threads.get(threadId))
+                throw new Error('Thread unavailable');
+            next.push({ key: name, threadId, createdAt: Date.now() });
+        }
+        const result = await context.storage.compareAndSet(key, stored?.revision ?? null, next);
+        if (!result.applied)
+            throw new Error('Plugin thread mappings changed concurrently');
+        return threadId === null ? rows.length !== next.length : next.find(row => row.key === name);
+    };
+    const ensure = (name, input) => serialize(async () => {
+        const existing = await find(name);
+        if (existing)
+            return existing;
+        const thread = await context.threads.create(input);
+        await save(name, thread.id);
+        return thread;
+    });
+    return {
+        ...context.threads,
+        findByKey: find,
+        bind: (name, threadId) => serialize(() => save(name, threadId)),
+        unbind: (name) => serialize(() => save(name, null)),
+        listBindings: async () => (await read()).rows,
+        ensureByKey: ensure,
+        ensureSystemThread: () => ensure('command-audit', { title: '连接器命令记录' }),
+    };
+}
+export function threadMappings(context) {
+    let value = contexts.get(context);
+    if (!value) {
+        value = createMappings(context);
+        contexts.set(context, value);
+    }
+    return value;
+}
+//# sourceMappingURL=thread-mappings.js.map

package/dist/thread-mappings.js.map

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

package/dist/token.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeTelegramBotToken(token: string | null | undefined): string | null;
+//# sourceMappingURL=token.d.ts.map

package/dist/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAEA,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIzF"}

package/dist/token.js

@@ -0,0 +1,8 @@
+const TELEGRAM_BOT_TOKEN_PATTERN = /^\d+:[A-Za-z0-9_-]{10,}$/;
+export function normalizeTelegramBotToken(token) {
+    const value = token?.trim();
+    if (!value)
+        return null;
+    return TELEGRAM_BOT_TOKEN_PATTERN.test(value) ? value : null;
+}
+//# sourceMappingURL=token.js.map

package/dist/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAE9D,MAAM,UAAU,yBAAyB,CAAC,KAAgC;IACxE,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+export type ConnectorLogMethod = (...args: readonly unknown[]) => void;
+export interface ConnectorLogger {
+    info: ConnectorLogMethod;
+    warn: ConnectorLogMethod;
+    error: ConnectorLogMethod;
+}
+interface RichBlockBase {
+    readonly id: string;
+    readonly v: 1;
+}
+export interface CardBlock extends RichBlockBase {
+    readonly kind: 'card';
+    readonly title: string;
+    readonly bodyMarkdown?: string;
+    readonly fields?: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+    }>;
+}
+export interface ChecklistBlock extends RichBlockBase {
+    readonly kind: 'checklist';
+    readonly title?: string;
+    readonly items: ReadonlyArray<{
+        readonly id: string;
+        readonly checked?: boolean;
+        readonly text: string;
+    }>;
+}
+export interface DiffBlock extends RichBlockBase {
+    readonly kind: 'diff';
+    readonly filePath: string;
+    readonly diff: string;
+}
+export interface AudioBlock extends RichBlockBase {
+    readonly kind: 'audio';
+    readonly text?: string;
+}
+export interface MediaGalleryBlock extends RichBlockBase {
+    readonly kind: 'media_gallery';
+    readonly title?: string;
+    readonly items: ReadonlyArray<{
+        readonly caption?: string;
+        readonly alt?: string;
+        readonly url: string;
+    }>;
+}
+export interface InteractiveBlock extends RichBlockBase {
+    readonly kind: 'interactive';
+}
+export interface HtmlWidgetBlock extends RichBlockBase {
+    readonly kind: 'html_widget';
+}
+export interface FileBlock extends RichBlockBase {
+    readonly kind: 'file';
+}
+export type RichBlock = CardBlock | ChecklistBlock | DiffBlock | AudioBlock | MediaGalleryBlock | InteractiveBlock | HtmlWidgetBlock | FileBlock;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;CACf;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3G;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3G;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,SAAS,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}