happy2 0.0.5

package/packages/happy2-server/dist/modules/operations/types.d.ts

@@ -0,0 +1,144 @@
+export type OperationsErrorCode = "invalid" | "forbidden" | "not_found" | "conflict";
+export declare class OperationsError extends Error {
+    readonly code: OperationsErrorCode;
+    constructor(code: OperationsErrorCode, message: string);
+}
+export interface Page<T> {
+    items: T[];
+    nextCursor?: string;
+}
+export interface OperationsSyncHint {
+    sequence: string;
+    chats: Array<{
+        chatId: string;
+        pts: string;
+    }>;
+    areas: string[];
+}
+export interface AuditLogEntry {
+    id: string;
+    actorUserId?: string;
+    actorIntegrationId?: string;
+    action: string;
+    targetType: string;
+    targetId?: string;
+    chatId?: string;
+    before?: unknown;
+    after?: unknown;
+    metadata?: unknown;
+    clientIp?: string;
+    device?: string;
+    appVersion?: string;
+    userAgent?: string;
+    createdAt: string;
+}
+export type BanStatus = "active" | "expired" | "revoked";
+export interface AccountBan {
+    id: string;
+    accountId: string;
+    userId?: string;
+    username?: string;
+    bannedByUserId?: string;
+    reason?: string;
+    bannedAt: string;
+    expiresAt?: string;
+    revokedAt?: string;
+    revokedByUserId?: string;
+    revokeReason?: string;
+    status: BanStatus;
+}
+export type ModerationReportStatus = "open" | "reviewing" | "resolved" | "dismissed";
+export type ModerationActionKind = "warn" | "restrict" | "remove_message" | "remove_file" | "ban" | "unban" | "delete_user";
+export interface ModerationReport {
+    id: string;
+    reportedByUserId?: string;
+    targetUserId?: string;
+    chatId?: string;
+    messageId?: string;
+    fileId?: string;
+    reason: string;
+    details?: string;
+    status: ModerationReportStatus;
+    assignedToUserId?: string;
+    resolution?: string;
+    createdAt: string;
+    updatedAt: string;
+    resolvedAt?: string;
+}
+export interface ModerationAction {
+    id: string;
+    reportId?: string;
+    actorUserId?: string;
+    targetUserId?: string;
+    chatId?: string;
+    messageId?: string;
+    fileId?: string;
+    action: ModerationActionKind;
+    reason?: string;
+    metadata?: unknown;
+    expiresAt?: string;
+    revokedAt?: string;
+    createdAt: string;
+}
+export type DataExportKind = "user_data" | "server_data" | "audit_log" | "chat_history";
+export type DataExportStatus = "pending" | "running" | "complete" | "failed" | "cancelled" | "expired";
+/** Deliberately exposes an opaque file id, never a storage path or provider credential. */
+export interface DataExportJob {
+    id: string;
+    requestedByUserId?: string;
+    kind: DataExportKind;
+    targetId?: string;
+    status: DataExportStatus;
+    outputFileId?: string;
+    options?: unknown;
+    lastError?: string;
+    expiresAt?: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+export type BackupStatus = "pending" | "running" | "complete" | "failed" | "deleted";
+export interface BackupRecord {
+    id: string;
+    storageProvider: string;
+    storageKey: string;
+    checksumSha256?: string;
+    size?: number;
+    status: BackupStatus;
+    createdByUserId?: string;
+    metadata?: unknown;
+    lastError?: string;
+    createdAt: string;
+    completedAt?: string;
+    retentionUntil?: string;
+}
+export type RetentionScope = "messages" | "files" | "sync" | "idempotency" | "audit" | "backups";
+export type RetentionRunStatus = "running" | "complete" | "failed";
+export interface RetentionRun {
+    id: string;
+    scope: RetentionScope;
+    status: RetentionRunStatus;
+    itemsExamined: number;
+    itemsDeleted: number;
+    details?: unknown;
+    lastError?: string;
+    startedAt: string;
+    completedAt?: string;
+}
+export interface UserAccessTelemetry {
+    userId: string;
+    username: string;
+    email: string;
+    role: "member" | "admin";
+    lastAccessAt?: string;
+    lastSessionAccessAt?: string;
+    activeSessionCount: number;
+    bannedAt?: string;
+    banExpiresAt?: string;
+    deletedAt?: string;
+    lastClientIp?: string;
+    lastDevice?: string;
+    lastAppVersion?: string;
+    lastUserAgent?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/happy2-server/dist/modules/operations/types.d.ts.map

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

package/packages/happy2-server/dist/modules/operations/types.js

@@ -0,0 +1,9 @@
+export class OperationsError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "OperationsError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/packages/happy2-server/dist/modules/operations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../sources/modules/operations/types.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEzB,IAAI;IADjB,YACa,IAAyB,EAClC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHN,IAAI;QAIb,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ"}

package/packages/happy2-server/dist/modules/realtime/events.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Realtime events are delivery hints only. The sync event points clients at
+ * durable database state; typing, presence, and call signaling are ephemeral.
+ */
+export interface RealtimeLimits {
+    maxEventBytes: number;
+    maxIdLength: number;
+    maxSyncChats: number;
+    maxSyncAreas: number;
+    maxAreaLength: number;
+    maxTypingTtlMs: number;
+    maxSessionDescriptionBytes: number;
+    maxIceCandidateBytes: number;
+    maxPresenceUsers: number;
+}
+export declare const DEFAULT_REALTIME_LIMITS: Readonly<RealtimeLimits>;
+/** An unsigned SQLite INTEGER encoded losslessly for JSON transport. */
+export type RealtimeSequence = string;
+export interface ChatSyncPoint {
+    readonly chatId: string;
+    readonly pts: RealtimeSequence;
+}
+export interface SyncHintEvent {
+    readonly type: "sync";
+    readonly sequence: RealtimeSequence;
+    readonly chats: readonly ChatSyncPoint[];
+    readonly areas: readonly string[];
+}
+export type DurableSyncHintEvent = SyncHintEvent;
+export interface TypingEvent {
+    readonly type: "typing";
+    readonly chatId: string;
+    readonly userId: string;
+    readonly active: boolean;
+    readonly occurredAt: number;
+    /** Required for active typing and intentionally short-lived. */
+    readonly expiresAt?: number;
+}
+export type PresenceStatus = "online" | "offline";
+export interface PresenceSnapshot {
+    readonly userId: string;
+    readonly status: PresenceStatus;
+    readonly connectionCount: number;
+    readonly lastActiveAt?: number;
+}
+export type PresenceChange = "connected" | "activity" | "disconnected";
+export interface PresenceEvent {
+    readonly type: "presence";
+    readonly change: PresenceChange;
+    readonly snapshot: PresenceSnapshot;
+    readonly occurredAt: number;
+}
+export interface WebRtcSessionDescriptionSignal {
+    readonly kind: "offer" | "answer";
+    readonly sdp: string;
+}
+export interface WebRtcIceCandidateSignal {
+    readonly kind: "ice-candidate";
+    readonly candidate: string;
+    readonly sdpMid?: string | null;
+    readonly sdpMLineIndex?: number | null;
+    readonly usernameFragment?: string | null;
+}
+export interface WebRtcHangupSignal {
+    readonly kind: "hangup";
+    readonly reason?: "ended" | "declined" | "busy" | "failed";
+}
+export type WebRtcSignal = WebRtcSessionDescriptionSignal | WebRtcIceCandidateSignal | WebRtcHangupSignal;
+export interface CallSignalEvent {
+    readonly type: "call.signal";
+    readonly callId: string;
+    readonly chatId: string;
+    readonly senderUserId: string;
+    /** Omit for a signal addressed to every authorized call participant. */
+    readonly recipientUserId?: string;
+    readonly signal: WebRtcSignal;
+    readonly occurredAt: number;
+}
+/** Ephemeral invalidation only; clients reconcile the current tree through HTTP. */
+export interface WorkspaceChangedEvent {
+    readonly type: "workspace.changed";
+    readonly chatId: string;
+    readonly occurredAt: number;
+}
+export type RealtimeEvent = SyncHintEvent | TypingEvent | PresenceEvent | CallSignalEvent | WorkspaceChangedEvent;
+export type RealtimeEventType = RealtimeEvent["type"];
+export type RealtimeTopic = "server" | "presence" | `user:${string}` | `chat:${string}` | `call:${string}`;
+export declare const realtimeTopics: Readonly<{
+    server: "server";
+    presence: "presence";
+    user: (userId: string) => RealtimeTopic;
+    chat: (chatId: string) => RealtimeTopic;
+    call: (callId: string) => RealtimeTopic;
+}>;
+export declare function assertRealtimeTopic(topic: string, limits?: RealtimeLimits): asserts topic is RealtimeTopic;
+export declare function assertRealtimeEvent(event: RealtimeEvent, limits?: RealtimeLimits): void;
+export declare function assertRealtimeId(value: string | undefined, name: string, limits?: RealtimeLimits): asserts value is string;
+export declare function assertSequence(value: string, name?: string): void;
+//# sourceMappingURL=events.d.ts.map

package/packages/happy2-server/dist/modules/realtime/events.d.ts.map

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

package/packages/happy2-server/dist/modules/realtime/events.js

@@ -0,0 +1,173 @@
+/**
+ * Realtime events are delivery hints only. The sync event points clients at
+ * durable database state; typing, presence, and call signaling are ephemeral.
+ */
+export const DEFAULT_REALTIME_LIMITS = Object.freeze({
+    maxEventBytes: 64 * 1024,
+    maxIdLength: 128,
+    maxSyncChats: 256,
+    maxSyncAreas: 64,
+    maxAreaLength: 64,
+    maxTypingTtlMs: 30_000,
+    maxSessionDescriptionBytes: 48 * 1024,
+    maxIceCandidateBytes: 8 * 1024,
+    maxPresenceUsers: 10_000,
+});
+export const realtimeTopics = Object.freeze({
+    server: "server",
+    presence: "presence",
+    user: (userId) => scopedTopic("user", userId),
+    chat: (chatId) => scopedTopic("chat", chatId),
+    call: (callId) => scopedTopic("call", callId),
+});
+export function assertRealtimeTopic(topic, limits = DEFAULT_REALTIME_LIMITS) {
+    if (topic === "server" || topic === "presence")
+        return;
+    const match = /^(user|chat|call):(.+)$/.exec(topic);
+    if (!match)
+        throw new Error("Invalid realtime topic");
+    assertRealtimeId(match[2], "topic id", limits);
+}
+export function assertRealtimeEvent(event, limits = DEFAULT_REALTIME_LIMITS) {
+    let encoded;
+    try {
+        encoded = JSON.stringify(event);
+    }
+    catch {
+        throw new Error("Realtime event must be JSON serializable");
+    }
+    if (!encoded || Buffer.byteLength(encoded) > limits.maxEventBytes)
+        throw new Error(`Realtime event exceeds ${limits.maxEventBytes} bytes`);
+    switch (event.type) {
+        case "sync":
+            assertSequence(event.sequence, "sequence");
+            if (!Array.isArray(event.chats) || event.chats.length > limits.maxSyncChats)
+                throw new Error(`Sync hint may include at most ${limits.maxSyncChats} chats`);
+            if (!Array.isArray(event.areas) || event.areas.length > limits.maxSyncAreas)
+                throw new Error(`Sync hint may include at most ${limits.maxSyncAreas} areas`);
+            assertUnique(event.chats.map((chat) => chat.chatId), "sync chat ids");
+            for (const chat of event.chats) {
+                assertRealtimeId(chat.chatId, "chat id", limits);
+                assertSequence(chat.pts, "chat pts");
+            }
+            assertUnique(event.areas, "sync areas");
+            for (const area of event.areas) {
+                if (typeof area !== "string" ||
+                    !/^[a-z][a-z0-9_.-]*$/.test(area) ||
+                    area.length > limits.maxAreaLength)
+                    throw new Error("Invalid sync area");
+            }
+            return;
+        case "typing":
+            assertRealtimeId(event.chatId, "chat id", limits);
+            assertRealtimeId(event.userId, "user id", limits);
+            assertTimestamp(event.occurredAt, "typing occurredAt");
+            if (event.active && event.expiresAt === undefined)
+                throw new Error("Active typing event requires expiresAt");
+            if (event.expiresAt !== undefined) {
+                assertTimestamp(event.expiresAt, "typing expiresAt");
+                if (event.expiresAt < event.occurredAt ||
+                    event.expiresAt - event.occurredAt > limits.maxTypingTtlMs)
+                    throw new Error(`Typing expiry must be within ${limits.maxTypingTtlMs} ms`);
+            }
+            return;
+        case "presence":
+            assertTimestamp(event.occurredAt, "presence occurredAt");
+            if (!["connected", "activity", "disconnected"].includes(event.change))
+                throw new Error("Invalid presence change");
+            assertPresenceSnapshot(event.snapshot, limits);
+            return;
+        case "call.signal":
+            assertRealtimeId(event.callId, "call id", limits);
+            assertRealtimeId(event.chatId, "chat id", limits);
+            assertRealtimeId(event.senderUserId, "sender user id", limits);
+            if (event.recipientUserId !== undefined)
+                assertRealtimeId(event.recipientUserId, "recipient user id", limits);
+            assertTimestamp(event.occurredAt, "call occurredAt");
+            assertCallSignal(event.signal, limits);
+            return;
+        case "workspace.changed":
+            assertRealtimeId(event.chatId, "chat id", limits);
+            assertTimestamp(event.occurredAt, "workspace change occurredAt");
+            return;
+        default:
+            throw new Error("Invalid realtime event type");
+    }
+}
+export function assertRealtimeId(value, name, limits = DEFAULT_REALTIME_LIMITS) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.length > limits.maxIdLength ||
+        [...value].some((character) => {
+            const code = character.charCodeAt(0);
+            return code <= 31 || code === 127;
+        }))
+        throw new Error(`Invalid ${name}`);
+}
+export function assertSequence(value, name = "sequence") {
+    if (typeof value !== "string" || !/^(0|[1-9]\d*)$/.test(value))
+        throw new Error(`${name} must be an unsigned decimal string`);
+    if (value.length > 19 || BigInt(value) > 9223372036854775807n)
+        throw new Error(`${name} exceeds SQLite INTEGER range`);
+}
+function scopedTopic(scope, id) {
+    assertRealtimeId(id, `${scope} id`);
+    return `${scope}:${id}`;
+}
+function assertPresenceSnapshot(snapshot, limits) {
+    if (!snapshot || typeof snapshot !== "object")
+        throw new Error("Invalid presence snapshot");
+    assertRealtimeId(snapshot.userId, "presence user id", limits);
+    if (snapshot.status !== "online" && snapshot.status !== "offline")
+        throw new Error("Invalid presence status");
+    if (!Number.isSafeInteger(snapshot.connectionCount) || snapshot.connectionCount < 0)
+        throw new Error("Invalid presence connection count");
+    if (snapshot.status === "online" && snapshot.connectionCount === 0)
+        throw new Error("Online presence requires a connection");
+    if (snapshot.status === "offline" && snapshot.connectionCount !== 0)
+        throw new Error("Offline presence cannot have connections");
+    if (snapshot.lastActiveAt !== undefined)
+        assertTimestamp(snapshot.lastActiveAt, "presence lastActiveAt");
+}
+function assertCallSignal(signal, limits) {
+    if (!signal || typeof signal !== "object")
+        throw new Error("Invalid WebRTC signal");
+    if (signal.kind === "offer" || signal.kind === "answer") {
+        assertBoundedString(signal.sdp, "session description", limits.maxSessionDescriptionBytes);
+        return;
+    }
+    if (signal.kind === "ice-candidate") {
+        assertBoundedString(signal.candidate, "ICE candidate", limits.maxIceCandidateBytes, true);
+        if (signal.sdpMid !== undefined && signal.sdpMid !== null)
+            assertBoundedString(signal.sdpMid, "ICE sdpMid", 256, true);
+        if (signal.sdpMLineIndex !== undefined &&
+            signal.sdpMLineIndex !== null &&
+            (!Number.isSafeInteger(signal.sdpMLineIndex) || signal.sdpMLineIndex < 0))
+            throw new Error("Invalid ICE sdpMLineIndex");
+        if (signal.usernameFragment !== undefined && signal.usernameFragment !== null)
+            assertBoundedString(signal.usernameFragment, "ICE username fragment", 256, true);
+        return;
+    }
+    if (signal.kind === "hangup") {
+        if (signal.reason !== undefined &&
+            !"ended,declined,busy,failed".split(",").includes(signal.reason))
+            throw new Error("Invalid call hangup reason");
+        return;
+    }
+    throw new Error("Invalid WebRTC signal kind");
+}
+function assertTimestamp(value, name) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`Invalid ${name}`);
+}
+function assertBoundedString(value, name, maximumBytes, allowEmpty = false) {
+    if (typeof value !== "string" ||
+        (!allowEmpty && value.length === 0) ||
+        Buffer.byteLength(value) > maximumBytes)
+        throw new Error(`Invalid ${name}`);
+}
+function assertUnique(values, name) {
+    if (new Set(values).size !== values.length)
+        throw new Error(`Duplicate ${name}`);
+}
+//# sourceMappingURL=events.js.map

package/packages/happy2-server/dist/modules/realtime/events.js.map

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

package/packages/happy2-server/dist/modules/realtime/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./events.js";
+export * from "./local.js";
+export * from "./pubsub.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/happy2-server/dist/modules/realtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sources/modules/realtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/packages/happy2-server/dist/modules/realtime/index.js

@@ -0,0 +1,4 @@
+export * from "./events.js";
+export * from "./local.js";
+export * from "./pubsub.js";
+//# sourceMappingURL=index.js.map

package/packages/happy2-server/dist/modules/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../sources/modules/realtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/packages/happy2-server/dist/modules/realtime/local.d.ts

@@ -0,0 +1,37 @@
+import { type PresenceSnapshot, type RealtimeEvent, type RealtimeLimits, type RealtimeTopic } from "./events.js";
+import { type PresenceConnection, type PubSub, type RealtimeSubscriber, type Unsubscribe } from "./pubsub.js";
+export interface SubscriberErrorContext {
+    readonly topic: RealtimeTopic;
+    readonly event: RealtimeEvent;
+}
+export interface LocalPubSubOptions {
+    readonly clock?: () => number;
+    readonly limits?: Partial<RealtimeLimits>;
+    readonly onSubscriberError?: (error: unknown, context: SubscriberErrorContext) => void | Promise<void>;
+}
+/** In-memory, process-local pubsub. All state disappears on close or restart. */
+export declare class LocalPubSub implements PubSub {
+    private readonly clock;
+    private readonly limits;
+    private readonly onSubscriberError?;
+    private readonly subscribers;
+    private readonly connections;
+    private readonly connectionsByUser;
+    private readonly lastActivityByUser;
+    private closed;
+    constructor(options?: LocalPubSubOptions);
+    publish(topic: RealtimeTopic, event: RealtimeEvent): Promise<void>;
+    subscribe(topic: RealtimeTopic, subscriber: RealtimeSubscriber): Unsubscribe;
+    connectPresence(connection: PresenceConnection): Promise<PresenceSnapshot>;
+    recordPresenceActivity(connectionId: string, occurredAt?: number): Promise<PresenceSnapshot | undefined>;
+    disconnectPresence(connectionId: string, occurredAt?: number): Promise<PresenceSnapshot | undefined>;
+    getPresenceSnapshot(userIds?: readonly string[]): Promise<readonly PresenceSnapshot[]>;
+    close(): Promise<void>;
+    private emitPresence;
+    private snapshot;
+    private rememberActivity;
+    private occurredAt;
+    private assertOpen;
+    private reportSubscriberError;
+}
+//# sourceMappingURL=local.d.ts.map

package/packages/happy2-server/dist/modules/realtime/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../sources/modules/realtime/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,sBAAsB,KAC9B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAQD,iFAAiF;AACjF,qBAAa,WAAY,YAAW,MAAM;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAA0C;IAC7E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqD;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,OAAO,GAAE,kBAAuB,EAK3C;IAEK,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAevE;IAED,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,GAAG,WAAW,CAc3E;IAEK,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2B/E;IAEK,sBAAsB,CACxB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CASvC;IAEK,kBAAkB,CACpB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAYvC;IAEK,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAO3F;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAO3B;YAEa,YAAY;IAW1B,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,qBAAqB;CAQhC"}