@fatagnus/dink-convex 1.0.0

package/dist/http.js

@@ -0,0 +1,222 @@
+/**
+ * HTTP endpoint utilities for dinkd communication.
+ *
+ * Provides helpers for the /api/dink/applyDelta HTTP endpoint
+ * that receives CRDT deltas from edge devices.
+ *
+ * @module http
+ */
+import * as Y from "yjs";
+/**
+ * Validate the Authorization header for applyDelta endpoint.
+ *
+ * Expects: Authorization: Bearer <appSyncKey>
+ *
+ * @param header - The Authorization header value
+ * @param expectedKey - The expected app sync key
+ * @returns Validation result
+ */
+export function validateAuthHeader(header, expectedKey) {
+    if (!header || header.trim() === "") {
+        return { valid: false, error: "Missing Authorization header" };
+    }
+    if (!header.startsWith("Bearer ")) {
+        return { valid: false, error: "Authorization header must use Bearer scheme" };
+    }
+    const token = header.slice(7).trim();
+    if (!token || token !== expectedKey) {
+        return { valid: false, error: "Invalid authorization token" };
+    }
+    return { valid: true };
+}
+/**
+ * Parse and validate the getSnapshot query parameters.
+ *
+ * @param params - The query parameters
+ * @returns Parsed parameters result
+ */
+export function parseGetSnapshotParams(params) {
+    if (!params || typeof params !== "object") {
+        return { success: false, error: "Invalid params: expected object" };
+    }
+    if (typeof params.collection !== "string" || !params.collection) {
+        return { success: false, error: "Invalid params: collection is required" };
+    }
+    if (typeof params.docId !== "string" || !params.docId) {
+        return { success: false, error: "Invalid params: docId is required" };
+    }
+    return {
+        success: true,
+        data: {
+            collection: params.collection,
+            docId: params.docId,
+        },
+    };
+}
+/**
+ * Parse and validate the listDocuments query parameters.
+ *
+ * @param params - The query parameters
+ * @returns Parsed parameters result
+ */
+export function parseListDocumentsParams(params) {
+    if (!params || typeof params !== "object") {
+        return { success: false, error: "Invalid params: expected object" };
+    }
+    if (typeof params.collection !== "string" || !params.collection) {
+        return { success: false, error: "Invalid params: collection is required" };
+    }
+    const result = {
+        collection: params.collection,
+    };
+    if (params.cursor !== undefined) {
+        result.cursor = params.cursor;
+    }
+    if (params.limit !== undefined) {
+        result.limit = params.limit;
+    }
+    return {
+        success: true,
+        data: result,
+    };
+}
+/**
+ * Parse and validate the applyDelta request payload.
+ *
+ * @param payload - The raw request payload
+ * @returns Parsed payload result
+ */
+export function parseApplyDeltaPayload(payload) {
+    if (!payload || typeof payload !== "object") {
+        return { success: false, error: "Invalid payload: expected object" };
+    }
+    if (typeof payload.collection !== "string" || !payload.collection) {
+        return { success: false, error: "Invalid payload: collection is required" };
+    }
+    if (typeof payload.docId !== "string" || !payload.docId) {
+        return { success: false, error: "Invalid payload: docId is required" };
+    }
+    if (!Array.isArray(payload.bytes)) {
+        return { success: false, error: "Invalid payload: bytes must be an array" };
+    }
+    // Convert number array to Uint8Array
+    const bytes = new Uint8Array(payload.bytes);
+    // Handle optional edgeId - only include if it's a string
+    const edgeId = typeof payload.edgeId === "string" ? payload.edgeId : undefined;
+    return {
+        success: true,
+        data: {
+            collection: payload.collection,
+            docId: payload.docId,
+            bytes,
+            edgeId,
+        },
+    };
+}
+/**
+ * Apply a CRDT delta to an existing document state.
+ *
+ * Merges the incoming delta with the existing state using Yjs CRDT semantics.
+ * This is the core merge function used by the HTTP endpoint.
+ *
+ * @param delta - The incoming CRDT delta (Yjs update)
+ * @param existingState - The existing document state, or null for new document
+ * @returns Merged state result with fromEdge flag for skipping outbox
+ */
+export function applyDeltaToDocument(delta, existingState) {
+    try {
+        const ydoc = new Y.Doc();
+        // Apply existing state first if present
+        if (existingState) {
+            Y.applyUpdate(ydoc, existingState);
+        }
+        // Apply the incoming delta
+        Y.applyUpdate(ydoc, delta);
+        // Encode the merged state
+        const mergedState = Y.encodeStateAsUpdate(ydoc);
+        return {
+            success: true,
+            mergedState,
+            fromEdge: true, // Flag to indicate this came from edge, skip outbox
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            error: `Failed to apply delta: ${message}`,
+        };
+    }
+}
+/**
+ * Create a JSON response with proper headers.
+ *
+ * @param data - Response data to serialize
+ * @param status - HTTP status code
+ * @returns Response object
+ */
+export function createJsonResponse(data, status) {
+    return new Response(JSON.stringify(data), {
+        status,
+        headers: {
+            "Content-Type": "application/json",
+        },
+    });
+}
+/**
+ * Create an error response with proper headers.
+ *
+ * @param error - Error message
+ * @param status - HTTP status code
+ * @returns Response object
+ */
+export function createErrorResponse(error, status) {
+    return createJsonResponse({ success: false, error }, status);
+}
+// Import serializeValue from crdt module to avoid duplication
+import { serializeValue } from "./crdt.js";
+/**
+ * Encode a document's data as a Yjs snapshot.
+ *
+ * Creates a Yjs document with all fields from the document data,
+ * compatible with the edge SDK's YjsDocument format.
+ *
+ * @param documentData - The document data to encode
+ * @returns Encoded snapshot result with Uint8Array bytes
+ *
+ * @example
+ * ```typescript
+ * const result = encodeDocumentAsSnapshot({
+ *   _collection: "tasks",
+ *   syncId: "sync-123",
+ *   title: "My Task",
+ *   completed: false,
+ * });
+ * ```
+ */
+export function encodeDocumentAsSnapshot(documentData) {
+    try {
+        const ydoc = new Y.Doc();
+        const fields = ydoc.getMap("fields");
+        // Add all document fields
+        for (const [key, value] of Object.entries(documentData)) {
+            if (value !== undefined) {
+                fields.set(key, serializeValue(value));
+            }
+        }
+        // Encode the state as an update (snapshot)
+        const bytes = Y.encodeStateAsUpdate(ydoc);
+        return {
+            success: true,
+            bytes,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            error: `Failed to encode snapshot: ${message}`,
+        };
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/httpFactory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * HTTP router factory for simplified @fatagnus/dink-convex setup.
+ *
+ * @module httpFactory
+ */
+import { httpRouter } from "convex/server";
+/**
+ * API type expected by the HTTP router factory.
+ */
+interface SyncApi {
+    sync: {
+        applyDeltaFromEdge: unknown;
+    };
+}
+/**
+ * Create a sync HTTP router with /dink/applyDelta endpoint.
+ *
+ * This factory creates an HTTP router pre-configured with the
+ * /dink/applyDelta endpoint for receiving CRDT deltas from edge devices.
+ *
+ * @param httpAction - The httpAction function from _generated/server
+ * @param api - The api from _generated/api
+ * @returns HTTP router to export as default
+ *
+ * @example
+ * ```typescript
+ * // convex/http.ts
+ * import { createSyncHttpRouter } from "@fatagnus/dink-convex";
+ * import { httpAction } from "./_generated/server";
+ * import { api } from "./_generated/api";
+ *
+ * export default createSyncHttpRouter(httpAction, api);
+ * ```
+ */
+export declare function createSyncHttpRouter(httpAction: (handler: (ctx: {
+    runMutation: (fn: unknown, args: unknown) => Promise<unknown>;
+}, request: Request) => Promise<Response>) => unknown, api: SyncApi): ReturnType<typeof httpRouter>;
+export {};
+//# sourceMappingURL=httpFactory.d.ts.map

package/dist/httpFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpFactory.d.ts","sourceRoot":"","sources":["../src/httpFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;GAEG;AACH,UAAU,OAAO;IACf,IAAI,EAAE;QACJ,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,CACV,OAAO,EAAE,CACP,GAAG,EAAE;IAAE,WAAW,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EACtE,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,QAAQ,CAAC,KACnB,OAAO,EACZ,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,UAAU,CAAC,CAoI/B"}

package/dist/httpFactory.js

@@ -0,0 +1,128 @@
+/**
+ * HTTP router factory for simplified @fatagnus/dink-convex setup.
+ *
+ * @module httpFactory
+ */
+import { httpRouter } from "convex/server";
+/**
+ * Create a sync HTTP router with /dink/applyDelta endpoint.
+ *
+ * This factory creates an HTTP router pre-configured with the
+ * /dink/applyDelta endpoint for receiving CRDT deltas from edge devices.
+ *
+ * @param httpAction - The httpAction function from _generated/server
+ * @param api - The api from _generated/api
+ * @returns HTTP router to export as default
+ *
+ * @example
+ * ```typescript
+ * // convex/http.ts
+ * import { createSyncHttpRouter } from "@fatagnus/dink-convex";
+ * import { httpAction } from "./_generated/server";
+ * import { api } from "./_generated/api";
+ *
+ * export default createSyncHttpRouter(httpAction, api);
+ * ```
+ */
+export function createSyncHttpRouter(httpAction, api) {
+    const http = httpRouter();
+    http.route({
+        path: "/dink/applyDelta",
+        method: "POST",
+        handler: httpAction(async (ctx, request) => {
+            // Validate Authorization header
+            const authHeader = request.headers.get("Authorization");
+            if (!authHeader || !authHeader.startsWith("Bearer ")) {
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: "Missing or invalid Authorization header",
+                }), {
+                    status: 401,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            const token = authHeader.slice(7).trim();
+            if (!token) {
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: "Missing authorization token",
+                }), {
+                    status: 401,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            // Parse request body
+            let payload;
+            try {
+                payload = await request.json();
+            }
+            catch {
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: "Invalid JSON payload",
+                }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            // Validate payload
+            if (!payload.collection || typeof payload.collection !== "string") {
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: "Missing or invalid collection field",
+                }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            if (!payload.docId || typeof payload.docId !== "string") {
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: "Missing or invalid docId field",
+                }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            if (!Array.isArray(payload.bytes)) {
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: "Missing or invalid bytes field",
+                }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            // Convert bytes array to ArrayBuffer for Convex
+            const bytes = new Uint8Array(payload.bytes).buffer;
+            try {
+                const result = (await ctx.runMutation(api.sync.applyDeltaFromEdge, {
+                    collection: payload.collection,
+                    docId: payload.docId,
+                    bytes,
+                    authToken: token,
+                    edgeId: payload.edgeId,
+                }));
+                return new Response(JSON.stringify({
+                    success: true,
+                    seq: result.seq,
+                }), {
+                    status: 200,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Unknown error";
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: message,
+                }), {
+                    status: 500,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+        }),
+    });
+    return http;
+}
+//# sourceMappingURL=httpFactory.js.map

package/dist/httpFactory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fatagnus/dink-convex - Dink Convex Sync Component
+ *
+ * Provides bidirectional sync between Convex and edge devices using CRDT deltas.
+ * Minimal boilerplate - each user file is just ~5 lines!
+ *
+ * ## Quick Start
+ *
+ * 1. Define your schema with syncedTable:
+ * ```typescript
+ * // convex/schema.ts
+ * import { syncedTable, internalSyncSchema } from "@fatagnus/dink-convex";
+ * export default defineSchema({
+ *   tasks: syncedTable({ title: v.string(), completed: v.boolean() }),
+ *   ...internalSyncSchema,
+ * });
+ * ```
+ *
+ * 2. Create sync mutations (5 lines!):
+ * ```typescript
+ * // convex/sync.ts
+ * import { createSyncMutations } from "@fatagnus/dink-convex";
+ * import { mutation, query } from "./_generated/server";
+ *
+ * export const { applyDeltaFromEdge, getDocumentState, listDocuments, listDocumentsPaginated } =
+ *   createSyncMutations({ mutation, query });
+ * ```
+ *
+ * 3. Create outbox processor (5 lines!):
+ * ```typescript
+ * // convex/outboxProcessor.ts
+ * import { createOutboxProcessor } from "@fatagnus/dink-convex";
+ * import { internalAction, internalMutation, internalQuery } from "./_generated/server";
+ * import { internal } from "./_generated/api";
+ *
+ * export const { processOutboxBatch, queryPendingItems, updateItemStatus, scheduleOutboxProcessing } =
+ *   createOutboxProcessor({ internalAction, internalMutation, internalQuery, internal });
+ * ```
+ *
+ * 4. Create HTTP router (4 lines!):
+ * ```typescript
+ * // convex/http.ts
+ * import { createSyncHttpRouter } from "@fatagnus/dink-convex";
+ * import { httpAction } from "./_generated/server";
+ * import { api } from "./_generated/api";
+ *
+ * export default createSyncHttpRouter({ httpAction, api });
+ * ```
+ *
+ * 5. Create crons (4 lines!):
+ * ```typescript
+ * // convex/crons.ts
+ * import { createSyncCrons } from "@fatagnus/dink-convex";
+ * import { internal } from "./_generated/api";
+ *
+ * export default createSyncCrons({ internal });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { syncedTable, internalSyncSchema, registerSyncedTableName, getRegisteredSyncedTables, clearRegisteredSyncedTables, } from "./schema.js";
+export { generateInsertDelta, generateUpdateDelta, generateDeleteDelta, type DocumentData, } from "./crdt.js";
+export { createSyncMutations, createOutboxProcessor, createSyncHttpRouter, createSyncCrons, type SyncMutationsInput, type SyncMutationsOutput, type OutboxProcessorInput, type OutboxProcessorOutput, type SyncHttpRouterInput, type SyncCronsInput, } from "./syncFactories.js";
+export { createSyncMutation, type SyncCronsConfig } from "./factories.js";
+export { syncTriggers, registerSyncedTable, isSyncedTable, getSyncConfig, createDeltaRecord, createOutboxRecord, createSyncTriggerHandler, createSyncTriggerHandlerAsync, createSyncTriggerHandlerWithScheduling, scheduleImmediateProcessing, getNextSeq, getNextSeqAsync, createSequenceCounter, checkSyncConfigEnabled, createSyncConfigChecker, createConfigAwareSyncTriggerHandler, createSyncTriggers, createSyncTriggersWithHandlers, customMutation, type SequenceCounter, } from "./triggers.js";
+export declare const VERSION = "0.3.0";
+export type { SyncedTableConfig } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAGH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mCAAmC,EACnC,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,73 @@
+/**
+ * @fatagnus/dink-convex - Dink Convex Sync Component
+ *
+ * Provides bidirectional sync between Convex and edge devices using CRDT deltas.
+ * Minimal boilerplate - each user file is just ~5 lines!
+ *
+ * ## Quick Start
+ *
+ * 1. Define your schema with syncedTable:
+ * ```typescript
+ * // convex/schema.ts
+ * import { syncedTable, internalSyncSchema } from "@fatagnus/dink-convex";
+ * export default defineSchema({
+ *   tasks: syncedTable({ title: v.string(), completed: v.boolean() }),
+ *   ...internalSyncSchema,
+ * });
+ * ```
+ *
+ * 2. Create sync mutations (5 lines!):
+ * ```typescript
+ * // convex/sync.ts
+ * import { createSyncMutations } from "@fatagnus/dink-convex";
+ * import { mutation, query } from "./_generated/server";
+ *
+ * export const { applyDeltaFromEdge, getDocumentState, listDocuments, listDocumentsPaginated } =
+ *   createSyncMutations({ mutation, query });
+ * ```
+ *
+ * 3. Create outbox processor (5 lines!):
+ * ```typescript
+ * // convex/outboxProcessor.ts
+ * import { createOutboxProcessor } from "@fatagnus/dink-convex";
+ * import { internalAction, internalMutation, internalQuery } from "./_generated/server";
+ * import { internal } from "./_generated/api";
+ *
+ * export const { processOutboxBatch, queryPendingItems, updateItemStatus, scheduleOutboxProcessing } =
+ *   createOutboxProcessor({ internalAction, internalMutation, internalQuery, internal });
+ * ```
+ *
+ * 4. Create HTTP router (4 lines!):
+ * ```typescript
+ * // convex/http.ts
+ * import { createSyncHttpRouter } from "@fatagnus/dink-convex";
+ * import { httpAction } from "./_generated/server";
+ * import { api } from "./_generated/api";
+ *
+ * export default createSyncHttpRouter({ httpAction, api });
+ * ```
+ *
+ * 5. Create crons (4 lines!):
+ * ```typescript
+ * // convex/crons.ts
+ * import { createSyncCrons } from "@fatagnus/dink-convex";
+ * import { internal } from "./_generated/api";
+ *
+ * export default createSyncCrons({ internal });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Schema helpers
+export { syncedTable, internalSyncSchema, registerSyncedTableName, getRegisteredSyncedTables, clearRegisteredSyncedTables, } from "./schema.js";
+// CRDT utilities
+export { generateInsertDelta, generateUpdateDelta, generateDeleteDelta, } from "./crdt.js";
+// Factory functions for minimal boilerplate DX (object-based API - recommended)
+export { createSyncMutations, createOutboxProcessor, createSyncHttpRouter, createSyncCrons, } from "./syncFactories.js";
+// Sync mutation wrapper for user mutations (wraps with CRDT triggers)
+export { createSyncMutation } from "./factories.js";
+// Legacy triggers exports (for advanced usage)
+export { syncTriggers, registerSyncedTable, isSyncedTable, getSyncConfig, createDeltaRecord, createOutboxRecord, createSyncTriggerHandler, createSyncTriggerHandlerAsync, createSyncTriggerHandlerWithScheduling, scheduleImmediateProcessing, getNextSeq, getNextSeqAsync, createSequenceCounter, checkSyncConfigEnabled, createSyncConfigChecker, createConfigAwareSyncTriggerHandler, createSyncTriggers, createSyncTriggersWithHandlers, customMutation, } from "./triggers.js";
+// Component version
+export const VERSION = "0.3.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAOhB,MAAM,oBAAoB,CAAC;AAE5B,sEAAsE;AACtE,OAAO,EAAE,kBAAkB,EAAwB,MAAM,gBAAgB,CAAC;AAE1E,+CAA+C;AAC/C,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mCAAmC,EACnC,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,oBAAoB;AACpB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}