@downcity/services 0.1.67 → 0.1.69

package/bin/usage/index.d.ts

@@ -1,177 +1,6 @@
 /**
- * Downcity 官方 Usage 服务。
- *
- * 通过全局 hook 记录 service 调用事件。
- * 兼容 Node.js 和 Cloudflare Workers（使用 Web Crypto API）。
+ * Usage 服务子模块公共入口。
  */
-import type { ServiceDefinition } from "@downcity/city";
-export interface UsageServiceOptions {
-    /**
-     * 是否记录失败的用户侧 service 调用。
-     *
-     * 默认只记录成功调用；开启后会通过 error hook 记录失败事件。
-     */
-    record_errors?: boolean;
-}
-/** Usage 事件表 */
-export declare const usageEvents: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
-    name: "service_usage_events";
-    schema: undefined;
-    columns: {
-        event_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "event_id";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        town_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "town_id";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "user_id";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        service: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "service";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        model_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "model_id";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "status";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        metadata_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "metadata_json";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "created_at";
-            tableName: "service_usage_events";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-    };
-    dialect: "sqlite";
-}>;
-export declare function usageService(options?: UsageServiceOptions): ServiceDefinition;
+export { UsageService, usageEvents } from "./service.js";
+export type { UsageServiceOptions } from "./service.js";
 //# sourceMappingURL=index.d.ts.map

package/bin/usage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAW,MAAM,gBAAgB,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,gBAAgB;AAChB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStB,CAAC;AAEH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,iBAAiB,CA6DjF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/bin/usage/index.js

@@ -1,120 +1,5 @@
 /**
- * Downcity 官方 Usage 服务。
- *
- * 通过全局 hook 记录 service 调用事件。
- * 兼容 Node.js 和 Cloudflare Workers（使用 Web Crypto API）。
+ * Usage 服务子模块公共入口。
  */
-import { sqliteTable, text } from "drizzle-orm/sqlite-core";
-/** Usage 事件表 */
-export const usageEvents = sqliteTable("service_usage_events", {
-    event_id: text("event_id").primaryKey(),
-    town_id: text("town_id").notNull(),
-    user_id: text("user_id").notNull(),
-    service: text("service").notNull(),
-    model_id: text("model_id").notNull(),
-    status: text("status").notNull(),
-    metadata_json: text("metadata_json").notNull(),
-    created_at: text("created_at").notNull(),
-});
-export function usageService(options = {}) {
-    return {
-        id: "usage",
-        name: "Usage",
-        version: "0.1.0",
-        schema: { events: usageEvents },
-        instruction: [
-            "通过全局 hook 记录真实用户侧 service 调用事件。",
-            "默认只记录成功调用；record_errors=true 时也会记录失败调用。",
-            "常用读取方式是管理端查看 events/summary，用户侧查看 me。",
-        ].join("\n"),
-        install(ctx) {
-            const events = ctx.table("events");
-            ctx.hook.after(async (serviceCtx) => {
-                if (!shouldRecordUsage(serviceCtx))
-                    return;
-                await events.insert(createUsageEvent(serviceCtx, "success"));
-            });
-            if (options.record_errors) {
-                ctx.hook.onError(async (serviceCtx) => {
-                    if (!shouldRecordUsage(serviceCtx))
-                        return;
-                    await events.insert(createUsageEvent(serviceCtx, "error"));
-                });
-            }
-            ctx.route({
-                method: "GET",
-                path: "/events",
-                auth: ["admin"],
-                async handler(requestCtx) {
-                    return requestCtx.jsonResponse({ items: await events.select() });
-                },
-            });
-            ctx.route({
-                method: "GET",
-                path: "/summary",
-                auth: ["admin"],
-                async handler(requestCtx) {
-                    return requestCtx.jsonResponse({
-                        items: summarizeUsage(await events.select()),
-                    });
-                },
-            });
-            ctx.route({
-                method: "GET",
-                path: "/me",
-                auth: ["user"],
-                async handler(requestCtx) {
-                    return requestCtx.jsonResponse({
-                        items: await events.select({
-                            user_id: requestCtx.user?.user_id ?? "",
-                            town_id: requestCtx.town?.town_id ?? "",
-                        }),
-                    });
-                },
-            });
-        },
-    };
-}
-/**
- * 只记录真实用户侧调用。
- *
- * 管理端操作没有 user/town 上下文，usage 服务自己的查询也不应反过来
- * 产生 usage 事件，否则统计接口会污染自身结果。
- */
-function shouldRecordUsage(ctx) {
-    return Boolean(ctx.user?.user_id && ctx.town?.town_id && ctx.service?.id !== "usage");
-}
-function createUsageEvent(ctx, status) {
-    return {
-        event_id: `usage_${randomId()}`,
-        town_id: ctx.town?.town_id ?? "",
-        user_id: ctx.user?.user_id ?? "",
-        service: ctx.service?.id ?? "",
-        model_id: ctx.variant?.id ?? "",
-        status,
-        metadata_json: JSON.stringify({
-            variant: ctx.variant?.id,
-            started_at: ctx.started_at?.toISOString(),
-            ended_at: ctx.ended_at?.toISOString(),
-            error: ctx.error?.message,
-        }),
-        created_at: new Date().toISOString(),
-    };
-}
-function summarizeUsage(rows) {
-    const byKey = new Map();
-    for (const row of rows) {
-        const key = `${row.town_id}\u0000${row.service}\u0000${row.status}`;
-        const current = byKey.get(key) ?? { town_id: row.town_id, service: row.service, status: row.status, count: 0 };
-        current.count += 1;
-        byKey.set(key, current);
-    }
-    return [...byKey.values()].sort((a, b) => `${a.town_id}:${a.service}:${a.status}`.localeCompare(`${b.town_id}:${b.service}:${b.status}`));
-}
-/** 生成随机 ID（兼容 Node 和 Workers） */
-function randomId() {
-    const buf = new Uint8Array(12);
-    crypto.getRandomValues(buf);
-    return btoa(String.fromCharCode(...buf)).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
+export { UsageService, usageEvents } from "./service.js";
 //# sourceMappingURL=index.js.map

package/bin/usage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/bin/usage/service.d.ts

@@ -0,0 +1,353 @@
+/**
+ * Downcity 官方 Usage 服务。
+ *
+ * 通过全局 hook 记录 service 调用事件。
+ * 兼容 Node.js 和 Cloudflare Workers（使用 Web Crypto API）。
+ */
+import { InstallableService, type ServiceInstallContext } from "@downcity/city";
+/**
+ * Usage 服务配置。
+ */
+export interface UsageServiceOptions {
+    /**
+     * 是否记录失败的用户侧 service 调用。
+     *
+     * 默认只记录成功调用；开启后会通过 error hook 记录失败事件。
+     */
+    record_errors?: boolean;
+}
+/**
+ * Usage 事件表。
+ */
+export declare const usageEvents: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "service_usage_events";
+    schema: undefined;
+    columns: {
+        event_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "event_id";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        town_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "town_id";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "user_id";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        service: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "service";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        model_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "model_id";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        metadata_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "metadata_json";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "service_usage_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * Usage 服务实例。
+ */
+export declare class UsageService extends InstallableService {
+    private readonly options;
+    readonly id = "usage";
+    readonly name = "Usage";
+    readonly version = "0.1.0";
+    readonly schema: {
+        events: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+            name: "service_usage_events";
+            schema: undefined;
+            columns: {
+                event_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "event_id";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: true;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                town_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "town_id";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "user_id";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                service: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "service";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                model_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "model_id";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "status";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                metadata_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "metadata_json";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "created_at";
+                    tableName: "service_usage_events";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+            };
+            dialect: "sqlite";
+        }>;
+    };
+    constructor(options?: UsageServiceOptions);
+    install(ctx: ServiceInstallContext): void;
+}
+//# sourceMappingURL=service.d.ts.map

package/bin/usage/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/usage/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,qBAAqB,EAAgB,MAAM,gBAAgB,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStB,CAAC;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,kBAAkB;IAMtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,QAAQ,CAAC,EAAE,WAAW;IACtB,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA2B;gBAEb,OAAO,GAAE,mBAAwB;IAS9D,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI;CAiD1C"}