@weifuwujs/messages 0.0.0-stage → 1.0.0

package/dist/messages.js

@@ -0,0 +1,272 @@
+import { json } from '@weifuwujs/weifuwu';
+import { localMessageBus } from "./bus.js";
+import { decodeCursor } from "./cursor.js";
+import { localMessageHub } from "./hub.js";
+const MAX_PAGE_SIZE = 100;
+const DEFAULT_PAGE_SIZE = 20;
+/** 从 ctx.auth.user.id 取当前用户（与 auth 模块结构耦合，不 import） */
+function userIdOf(ctx) {
+    const id = ctx.auth?.user?.id;
+    return typeof id === 'string' && id.length > 0 ? id : null;
+}
+function unauthorized() {
+    return json({ error: 'unauthorized' }, { status: 401 });
+}
+const badRequest = (error) => json({ error }, { status: 400 });
+/**
+ * 站内信/通知中心：持久化 + 未读计数 + 本人可见的只读 REST。
+ *
+ * - `send` 是服务端发送入口（HTTP 不暴露写消息，防越权群发）；
+ * - 至少一次 + 按 id 去重由客户端/实时层承担，幂等键由 store 唯一约束承担；
+ * - 实时推送（WebSocket）见后续阶段，`messages.routes()` 先提供轮询兜底。
+ */
+export function createMessages(options) {
+    const store = options.store;
+    const now = options.now ?? (() => new Date());
+    const logger = options.logger ?? console;
+    const prefix = options.routePrefix ?? '/messages';
+    const pageSize = Math.min(MAX_PAGE_SIZE, Math.max(1, options.pageSize ?? DEFAULT_PAGE_SIZE));
+    const syncLimit = Math.max(1, options.syncLimit ?? 100);
+    const hub = localMessageHub();
+    const bus = options.bus ?? localMessageBus();
+    const ownsBus = options.bus === undefined;
+    /** 每个 userId 的 bus 订阅停止函数（首个连接 watch，末个连接 unwatch） */
+    const watchers = new Map();
+    async function publishEvent(userId, event) {
+        try {
+            await bus.ready?.();
+            await bus.publish(userId, event);
+        }
+        catch (error) {
+            logger.error(`[messages] 推送失败（消息已持久化）：${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async function publishUnread(userId) {
+        await publishEvent(userId, {
+            type: 'unread',
+            unread: await store.unreadCount(userId),
+        });
+    }
+    function addConnection(userId, socket) {
+        const remove = hub.add(userId, socket);
+        if (hub.connections(userId) === 1) {
+            watchers.set(userId, bus.watch(userId, (event) => hub.publish(userId, event)));
+        }
+        return () => {
+            remove();
+            if (hub.connections(userId) === 0) {
+                watchers.get(userId)?.();
+                watchers.delete(userId);
+            }
+        };
+    }
+    async function close() {
+        for (const stop of watchers.values())
+            stop();
+        watchers.clear();
+        hub.closeAll();
+        if (ownsBus)
+            await bus.close?.();
+    }
+    async function markRead(userId, ids) {
+        const updated = await store.markRead(userId, ids, now());
+        if (updated > 0)
+            await publishUnread(userId);
+        return updated;
+    }
+    async function markAllRead(userId) {
+        const updated = await store.markAllRead(userId, now());
+        if (updated > 0)
+            await publishUnread(userId);
+        return updated;
+    }
+    async function send(input) {
+        if (typeof input.title !== 'string' || input.title.trim() === '') {
+            throw new TypeError('messages.send: title is required');
+        }
+        if (input.data !== undefined && input.data !== null) {
+            try {
+                JSON.stringify(input.data);
+            }
+            catch {
+                throw new TypeError('messages.send: data must be JSON-serializable');
+            }
+        }
+        const result = await store.insert({
+            userId: input.userId,
+            kind: input.kind ?? 'default',
+            title: input.title,
+            body: input.body ?? null,
+            data: input.data ?? null,
+            idempotencyKey: input.idempotencyKey ?? null,
+            createdAt: now(),
+        });
+        if (result.created && options.onSend) {
+            try {
+                await options.onSend(result.message);
+            }
+            catch (error) {
+                logger.error(`[messages] onSend hook 失败（消息已持久化）：${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        if (result.created) {
+            await publishEvent(result.message.userId, {
+                type: 'message',
+                message: result.message,
+            });
+            await publishUnread(result.message.userId);
+        }
+        return result;
+    }
+    async function readJsonBody(req) {
+        const text = await req.text();
+        if (text.trim() === '')
+            return { ok: true, value: null };
+        try {
+            return { ok: true, value: JSON.parse(text) };
+        }
+        catch {
+            return { ok: false, response: badRequest('invalid_json') };
+        }
+    }
+    function parseLimit(raw) {
+        if (raw === undefined)
+            return pageSize;
+        const parsed = Number(raw);
+        if (!Number.isInteger(parsed) || parsed < 1 || parsed > MAX_PAGE_SIZE)
+            return null;
+        return parsed;
+    }
+    const routes = () => [
+        {
+            method: 'GET',
+            path: prefix,
+            handler: async (req, ctx) => {
+                const userId = userIdOf(ctx);
+                if (!userId)
+                    return unauthorized();
+                const limit = parseLimit(ctx.query.limit);
+                if (limit === null)
+                    return badRequest('invalid_limit');
+                const cursor = ctx.query.cursor ?? null;
+                if (cursor !== null && decodeCursor(cursor) === null) {
+                    return badRequest('invalid_cursor');
+                }
+                const page = await store.list({
+                    userId,
+                    limit,
+                    cursor,
+                    unreadOnly: ctx.query.unread === '1' || ctx.query.unread === 'true',
+                    kind: ctx.query.kind || undefined,
+                });
+                return json({
+                    items: page.items,
+                    nextCursor: page.nextCursor,
+                    unread: await store.unreadCount(userId),
+                });
+            },
+        },
+        {
+            method: 'GET',
+            path: `${prefix}/unread`,
+            handler: async (req, ctx) => {
+                const userId = userIdOf(ctx);
+                if (!userId)
+                    return unauthorized();
+                return json({ unread: await store.unreadCount(userId) });
+            },
+        },
+        {
+            method: 'POST',
+            path: `${prefix}/read`,
+            handler: async (req, ctx) => {
+                const userId = userIdOf(ctx);
+                if (!userId)
+                    return unauthorized();
+                const body = await readJsonBody(req);
+                if (!body.ok)
+                    return body.response;
+                const ids = body.value?.ids;
+                if (!Array.isArray(ids) || ids.some((id) => typeof id !== 'string')) {
+                    return badRequest('invalid_ids');
+                }
+                return json({ updated: await markRead(userId, ids) });
+            },
+        },
+        {
+            method: 'POST',
+            path: `${prefix}/read-all`,
+            handler: async (req, ctx) => {
+                const userId = userIdOf(ctx);
+                if (!userId)
+                    return unauthorized();
+                return json({ updated: await markAllRead(userId) });
+            },
+        },
+    ];
+    const api = {
+        store,
+        send,
+        list: (query) => store.list(query),
+        unread: (userId) => store.unreadCount(userId),
+        markRead,
+        markAllRead,
+        routes,
+        install(app, installOptions = {}) {
+            if (installOptions.rest !== false)
+                app.mount(api);
+            const wsPath = installOptions.wsPath ?? `${prefix}/ws`;
+            const guard = async (req, ctx, next) => {
+                if (!userIdOf(ctx))
+                    return new Response('Unauthorized', { status: 401 });
+                return next(req, ctx);
+            };
+            app.ws(wsPath, guard, async (socket, ctx) => {
+                const userId = userIdOf(ctx);
+                if (!userId) {
+                    socket.close(1008, 'unauthorized');
+                    return;
+                }
+                const sinceParam = ctx.query.since;
+                if (sinceParam !== undefined &&
+                    sinceParam !== '' &&
+                    decodeCursor(sinceParam) === null) {
+                    socket.close(1008, 'invalid cursor');
+                    return;
+                }
+                // subscribe-first：竞态下宁可重复（由 id 去重）也不丢失
+                const unsubscribe = addConnection(userId, socket);
+                if (sinceParam !== undefined) {
+                    const page = await store.listAfter({
+                        userId,
+                        cursor: sinceParam === '' ? null : sinceParam,
+                        limit: syncLimit,
+                    });
+                    socket.send(JSON.stringify({
+                        type: 'sync',
+                        items: page.items,
+                        hasMore: page.hasMore,
+                        unread: await store.unreadCount(userId),
+                    }));
+                }
+                else {
+                    socket.send(JSON.stringify({ type: 'unread', unread: await store.unreadCount(userId) }));
+                }
+                return { onClose: () => unsubscribe() };
+            });
+            app.onClose(() => close());
+            return api;
+        },
+        connections: (userId) => hub.connections(userId),
+        publish: (userId, event) => publishEvent(userId, event),
+        async ready() {
+            await bus.ready?.();
+        },
+        close,
+        async migrate() {
+            await store.migrate?.();
+        },
+    };
+    return api;
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

package/dist/postgres.d.ts

@@ -0,0 +1,3 @@
+export { postgresMessageStore } from './stores/postgres.ts';
+export type { PostgresMessageStore } from './stores/postgres.ts';
+//# sourceMappingURL=postgres.d.ts.map

package/dist/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/postgres.js

@@ -0,0 +1,2 @@
+export { postgresMessageStore } from "./stores/postgres.js";
+//# sourceMappingURL=postgres.js.map

package/dist/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../src/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/redis.d.ts

@@ -0,0 +1,24 @@
+import type { Redis, RedisOptions } from 'ioredis';
+import type { MessageBus } from './types.ts';
+export interface RedisMessageBusOptions extends RedisOptions {
+    /** 频道前缀（默认 `ww:messages`）；测试/多租户用独立前缀隔离 */
+    prefix?: string;
+}
+export interface RedisMessageBus extends MessageBus {
+    close(): Promise<void>;
+}
+/**
+ * redis pub/sub 总线：多副本部署时让 `send` 到达持有连接的其他实例。
+ *
+ * - **按需订阅**：本节点有某用户的连接时才 SUBSCRIBE `<prefix>:<userId>`，最后一个连接
+ *   断开后自动退订（不把全量事件广播给所有节点）；
+ * - 复用 `./ioredis` 子路径的同一客户端（`ctx.redis`）：注入时 `duplicate()` 出订阅连接，
+ *   不负责关闭注入客户端；
+ * - 至少一次、可乱序：`unread` 是快照值，`message` 由客户端按 id 去重。
+ *
+ * ```ts
+ * redisMessageBus(process.env.REDIS_URL!, { prefix: 'ww:messages' })
+ * ```
+ */
+export declare function redisMessageBus(urlOrRedis?: string | Redis, options?: RedisMessageBusOptions): RedisMessageBus;
+//# sourceMappingURL=redis.d.ts.map

package/dist/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAA;AAE3D,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,EAC3B,OAAO,GAAE,sBAA2B,GACnC,eAAe,CA2HjB"}

package/dist/redis.js

@@ -0,0 +1,126 @@
+/**
+ * redis pub/sub 总线：多副本部署时让 `send` 到达持有连接的其他实例。
+ *
+ * - **按需订阅**：本节点有某用户的连接时才 SUBSCRIBE `<prefix>:<userId>`，最后一个连接
+ *   断开后自动退订（不把全量事件广播给所有节点）；
+ * - 复用 `./ioredis` 子路径的同一客户端（`ctx.redis`）：注入时 `duplicate()` 出订阅连接，
+ *   不负责关闭注入客户端；
+ * - 至少一次、可乱序：`unread` 是快照值，`message` 由客户端按 id 去重。
+ *
+ * ```ts
+ * redisMessageBus(process.env.REDIS_URL!, { prefix: 'ww:messages' })
+ * ```
+ */
+export function redisMessageBus(urlOrRedis, options = {}) {
+    const injected = typeof urlOrRedis === 'string' || urlOrRedis === undefined ? null : urlOrRedis;
+    const { prefix = 'ww:messages', ...redisOptions } = options;
+    const channel = (userId) => `${prefix}:${userId}`;
+    const handlers = new Map();
+    const pending = new Set();
+    let publisherPromise = null;
+    let subscriberPromise = null;
+    const track = (promise) => {
+        const op = promise.then(() => undefined);
+        pending.add(op);
+        void op.finally(() => pending.delete(op)).catch(() => { });
+        op.catch(() => { });
+    };
+    const connect = async () => {
+        const { default: RedisClient } = (await import('ioredis'));
+        return RedisClient;
+    };
+    const url = () => typeof urlOrRedis === 'string'
+        ? urlOrRedis
+        : (process.env.REDIS_URL ?? 'redis://127.0.0.1:6379');
+    const publisher = async () => {
+        publisherPromise ??= (async () => {
+            if (injected)
+                return injected;
+            const RedisCtor = await connect();
+            return new RedisCtor(url(), redisOptions);
+        })();
+        return publisherPromise;
+    };
+    const subscriber = async () => {
+        subscriberPromise ??= (async () => {
+            if (injected)
+                return injected.duplicate();
+            const RedisCtor = await connect();
+            const sub = new RedisCtor(url(), redisOptions);
+            sub.on('message', (receivedChannel, payload) => {
+                if (!receivedChannel.startsWith(`${prefix}:`))
+                    return;
+                const userId = receivedChannel.slice(prefix.length + 1);
+                const set = handlers.get(userId);
+                if (!set)
+                    return;
+                let event;
+                try {
+                    event = JSON.parse(payload);
+                }
+                catch {
+                    return;
+                }
+                for (const handler of [...set])
+                    handler(event);
+            });
+            return sub;
+        })();
+        return subscriberPromise;
+    };
+    const whenReady = async () => {
+        await publisher();
+        while (pending.size > 0)
+            await Promise.all([...pending]);
+    };
+    return {
+        async publish(userId, event) {
+            // 先等本节点订阅就绪：刚 watch 完就 publish 时不能丢事件（echo/同进程）
+            await whenReady();
+            const pub = await publisher();
+            await pub.publish(channel(userId), JSON.stringify(event));
+        },
+        watch(userId, handler) {
+            let set = handlers.get(userId);
+            if (!set) {
+                set = new Set();
+                handlers.set(userId, set);
+            }
+            set.add(handler);
+            if (set.size === 1) {
+                track(subscriber().then((sub) => sub.subscribe(channel(userId))));
+            }
+            let stopped = false;
+            return () => {
+                if (stopped)
+                    return;
+                stopped = true;
+                set.delete(handler);
+                if (set.size === 0) {
+                    handlers.delete(userId);
+                    track(subscriber().then((sub) => sub.unsubscribe(channel(userId))));
+                }
+            };
+        },
+        async ready() {
+            await whenReady();
+        },
+        async close() {
+            if (injected)
+                return;
+            const closing = [];
+            if (subscriberPromise) {
+                const sub = await subscriberPromise;
+                subscriberPromise = null;
+                closing.push(sub.quit());
+            }
+            if (publisherPromise) {
+                const pub = await publisherPromise;
+                publisherPromise = null;
+                closing.push(pub.quit());
+            }
+            await Promise.all(closing);
+        },
+    };
+}
+//# sourceMappingURL=redis.js.map

package/dist/redis.js.map

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

package/dist/sqlite.d.ts

@@ -0,0 +1,3 @@
+export { sqliteMessageStore } from './stores/sqlite.ts';
+export type { SqliteMessageStore } from './stores/sqlite.ts';
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/sqlite.js

@@ -0,0 +1,2 @@
+export { sqliteMessageStore } from "./stores/sqlite.js";
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/stores/memory.d.ts

@@ -0,0 +1,6 @@
+import type { MessageStore } from '../types.ts';
+/**
+ * 内存驱动：dev/test 用（单进程；不作生产承诺）。
+ */
+export declare function memoryMessageStore(): MessageStore;
+//# sourceMappingURL=memory.d.ts.map

package/dist/stores/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/stores/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAOV,YAAY,EAEb,MAAM,aAAa,CAAA;AAMpB;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAyGjD"}

package/dist/stores/memory.js

@@ -0,0 +1,115 @@
+import { randomUUID } from 'node:crypto';
+import { compareAsc, compareDesc, decodeCursor, encodeCursor, isAfterCursor, isBeyondCursor } from "../cursor.js";
+function clone(message) {
+    return { ...message, data: message.data };
+}
+/**
+ * 内存驱动：dev/test 用（单进程；不作生产承诺）。
+ */
+export function memoryMessageStore() {
+    const rows = new Map();
+    const byKey = new Map();
+    const store = {
+        async insert(input) {
+            const key = input.idempotencyKey;
+            if (key) {
+                const existingId = byKey.get(`${input.userId}\u0000${key}`);
+                const existing = existingId ? rows.get(existingId) : undefined;
+                if (existing)
+                    return { message: clone(existing), created: false };
+            }
+            const message = {
+                id: randomUUID(),
+                userId: input.userId,
+                kind: input.kind,
+                title: input.title,
+                body: input.body,
+                data: input.data,
+                readAt: null,
+                idempotencyKey: key,
+                createdAt: input.createdAt,
+            };
+            rows.set(message.id, message);
+            if (key)
+                byKey.set(`${input.userId}\u0000${key}`, message.id);
+            return { message: clone(message), created: true };
+        },
+        async get(id, userId) {
+            const message = rows.get(id);
+            if (!message || message.userId !== userId)
+                return null;
+            return clone(message);
+        },
+        async list(query) {
+            const limit = query.limit ?? 20;
+            let result = [...rows.values()].filter((message) => message.userId === query.userId);
+            if (query.unreadOnly)
+                result = result.filter((message) => message.readAt === null);
+            if (query.kind)
+                result = result.filter((message) => message.kind === query.kind);
+            result.sort(compareDesc);
+            if (query.cursor) {
+                const cursor = decodeCursor(query.cursor);
+                if (!cursor)
+                    throw new Error(`invalid cursor: ${query.cursor}`);
+                result = result.filter((message) => isAfterCursor(message, cursor));
+            }
+            const page = result.slice(0, limit);
+            const hasMore = result.length > limit;
+            return {
+                items: page.map(clone),
+                nextCursor: hasMore ? encodeCursor(page[page.length - 1]) : null,
+            };
+        },
+        async listAfter(query) {
+            let cursor = null;
+            if (query.cursor !== null) {
+                cursor = decodeCursor(query.cursor);
+                if (!cursor)
+                    throw new Error(`invalid cursor: ${query.cursor}`);
+            }
+            let result = [...rows.values()].filter((message) => message.userId === query.userId);
+            result.sort(compareAsc);
+            if (cursor)
+                result = result.filter((message) => isBeyondCursor(message, cursor));
+            const page = result.slice(0, query.limit);
+            return {
+                items: page.map(clone),
+                hasMore: result.length > query.limit,
+            };
+        },
+        async unreadCount(userId) {
+            let count = 0;
+            for (const message of rows.values()) {
+                if (message.userId === userId && message.readAt === null)
+                    count += 1;
+            }
+            return count;
+        },
+        async markRead(userId, ids, now) {
+            const wanted = new Set(ids);
+            let updated = 0;
+            for (const message of rows.values()) {
+                if (message.userId !== userId)
+                    continue;
+                if (!wanted.has(message.id) || message.readAt !== null)
+                    continue;
+                message.readAt = now;
+                updated += 1;
+            }
+            return updated;
+        },
+        async markAllRead(userId, now) {
+            let updated = 0;
+            for (const message of rows.values()) {
+                if (message.userId !== userId || message.readAt !== null)
+                    continue;
+                message.readAt = now;
+                updated += 1;
+            }
+            return updated;
+        },
+    };
+    return store;
+}
+//# sourceMappingURL=memory.js.map

package/dist/stores/memory.js.map

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

package/dist/stores/postgres.d.ts

@@ -0,0 +1,22 @@
+import type postgresJs from 'postgres';
+import type { MessageStore } from '../types.ts';
+/** postgres.js 的 options（其泛型无默认值，同 `./postgres`） */
+type PostgresOptions = NonNullable<Parameters<typeof postgresJs>[1]>;
+export interface PostgresMessageStore extends MessageStore {
+    migrate(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * postgres 驱动（复用 `postgres.js`，与 `./postgres` 的 `ctx.sql` 同一客户端）。
+ *
+ * ```ts
+ * postgresMessageStore('postgres://…')
+ * postgresMessageStore(ctx.sql)   // 注入已有客户端（不负责 close）
+ * ```
+ *
+ * 幂等键靠 `(user_id, idempotency_key)` 唯一约束 + `ON CONFLICT DO NOTHING` 原子去重；
+ * 表结构与 sqlite 对齐，`migrate()` 幂等（`message_migrations`）。
+ */
+export declare function postgresMessageStore(urlOrSql?: string | postgresJs.Sql, options?: PostgresOptions): PostgresMessageStore;
+export {};
+//# sourceMappingURL=postgres.d.ts.map

package/dist/stores/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/stores/postgres.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,UAAU,CAAA;AAEtC,OAAO,KAAK,EAOV,YAAY,EAEb,MAAM,aAAa,CAAA;AAEpB,oDAAoD;AACpD,KAAK,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AA8CpE,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,oBAAoB,CA2JtB"}