@dyrected/core 2.5.24 → 2.5.26

package/dist/utils/openapi.js

@@ -0,0 +1,331 @@
+/**
+ * Generate an OpenAPI 3.0 specification based on the Dyrected configuration.
+ */
+export function generateOpenApi(config) {
+    const spec = {
+        openapi: "3.0.0",
+        info: {
+            title: "Dyrected API",
+            version: "1.0.0",
+            description: "Automatically generated OpenAPI specification for the Dyrected project.",
+        },
+        components: {
+            schemas: {},
+            securitySchemes: {
+                ApiKeyAuth: {
+                    type: "apiKey",
+                    in: "header",
+                    name: "x-api-key",
+                },
+            },
+        },
+        paths: {},
+        security: [{ ApiKeyAuth: [] }],
+    };
+    // 1. Generate Schemas for Collections
+    for (const collection of config.collections) {
+        spec.components.schemas[collection.slug] = collectionToSchema(collection);
+    }
+    // 2. Generate Schemas for Globals
+    for (const global of config.globals) {
+        spec.components.schemas[global.slug] = globalToSchema(global);
+    }
+    // 3. Generate Paths for Collections
+    for (const collection of config.collections) {
+        const slug = collection.slug;
+        const path = `/api/collections/${slug}`;
+        const labels = collection.labels || { singular: slug, plural: `${slug}s` };
+        spec.paths[path] = {
+            get: {
+                tags: ["Collections"],
+                summary: `Find ${labels.plural}`,
+                parameters: [
+                    { name: "limit", in: "query", schema: { type: "integer", default: 10 } },
+                    { name: "page", in: "query", schema: { type: "integer", default: 1 } },
+                    { name: "where", in: "query", schema: { type: "string" }, description: "JSON filter" },
+                    { name: "sort", in: "query", schema: { type: "string" }, description: "Sort field (e.g. -createdAt)" },
+                ],
+                responses: {
+                    200: {
+                        description: "Success",
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    properties: {
+                                        docs: { type: "array", items: { $ref: `#/components/schemas/${slug}` } },
+                                        total: { type: "integer" },
+                                        limit: { type: "integer" },
+                                        page: { type: "integer" },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            post: {
+                tags: ["Collections"],
+                summary: `Create ${labels.singular}`,
+                requestBody: {
+                    required: true,
+                    content: {
+                        "application/json": {
+                            schema: { $ref: `#/components/schemas/${slug}` },
+                        },
+                    },
+                },
+                responses: {
+                    201: {
+                        description: "Created",
+                        content: {
+                            "application/json": {
+                                schema: { $ref: `#/components/schemas/${slug}` },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+        spec.paths[`${path}/{id}`] = {
+            get: {
+                tags: ["Collections"],
+                summary: `Get a single ${labels.singular}`,
+                parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+                responses: {
+                    200: {
+                        description: "Success",
+                        content: {
+                            "application/json": {
+                                schema: { $ref: `#/components/schemas/${slug}` },
+                            },
+                        },
+                    },
+                },
+            },
+            patch: {
+                tags: ["Collections"],
+                summary: `Update ${labels.singular}`,
+                parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+                requestBody: {
+                    required: true,
+                    content: {
+                        "application/json": {
+                            schema: { $ref: `#/components/schemas/${slug}` },
+                        },
+                    },
+                },
+                responses: {
+                    200: {
+                        description: "Updated",
+                        content: {
+                            "application/json": {
+                                schema: { $ref: `#/components/schemas/${slug}` },
+                            },
+                        },
+                    },
+                },
+            },
+            delete: {
+                tags: ["Collections"],
+                summary: `Delete ${labels.singular}`,
+                parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+                responses: {
+                    204: { description: "Deleted" },
+                },
+            },
+        };
+    }
+    // 4. Generate Paths for Globals
+    for (const global of config.globals) {
+        const slug = global.slug;
+        const path = `/api/globals/${slug}`;
+        spec.paths[path] = {
+            get: {
+                tags: ["Globals"],
+                summary: `Get ${global.label || slug}`,
+                responses: {
+                    200: {
+                        description: "Success",
+                        content: {
+                            "application/json": {
+                                schema: { $ref: `#/components/schemas/${slug}` },
+                            },
+                        },
+                    },
+                },
+            },
+            patch: {
+                tags: ["Globals"],
+                summary: `Update ${global.label || slug}`,
+                requestBody: {
+                    required: true,
+                    content: {
+                        "application/json": {
+                            schema: { $ref: `#/components/schemas/${slug}` },
+                        },
+                    },
+                },
+                responses: {
+                    200: {
+                        description: "Updated",
+                        content: {
+                            "application/json": {
+                                schema: { $ref: `#/components/schemas/${slug}` },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    // 5. Generate Paths for Media (if storage is configured)
+    if (config.storage) {
+        spec.paths["/api/media"] = {
+            get: {
+                tags: ["Media"],
+                summary: "List Media",
+                responses: {
+                    200: {
+                        description: "Success",
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    properties: {
+                                        docs: { type: "array", items: { type: "object", additionalProperties: true } },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            post: {
+                tags: ["Media"],
+                summary: "Upload Media",
+                requestBody: {
+                    content: {
+                        "multipart/form-data": {
+                            schema: {
+                                type: "object",
+                                properties: {
+                                    file: { type: "string", format: "binary" },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    201: { description: "Uploaded" },
+                },
+            },
+        };
+    }
+    return spec;
+}
+function collectionToSchema(collection) {
+    const { properties, required } = fieldsToProperties(collection.fields);
+    return {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            createdAt: { type: "string", format: "date-time" },
+            updatedAt: { type: "string", format: "date-time" },
+            ...properties,
+        },
+        required: ["id", ...required],
+    };
+}
+function globalToSchema(global) {
+    const { properties, required } = fieldsToProperties(global.fields);
+    return {
+        type: "object",
+        properties,
+        required,
+    };
+}
+function fieldsToProperties(fields) {
+    const props = {};
+    const required = [];
+    for (const field of fields) {
+        if (!field.name || field.type === 'join' || field.type === 'row')
+            continue;
+        props[field.name] = fieldToSchema(field);
+        if (field.required) {
+            required.push(field.name);
+        }
+    }
+    return { properties: props, required };
+}
+function fieldToSchema(field) {
+    let schema = {};
+    switch (field.type) {
+        case "text":
+        case "textarea":
+        case "email":
+        case "url":
+            schema = { type: "string" };
+            break;
+        case "number":
+            schema = { type: "number" };
+            break;
+        case "boolean":
+            schema = { type: "boolean" };
+            break;
+        case "date":
+            schema = { type: "string", format: "date-time" };
+            break;
+        case "select":
+        case "radio":
+            schema = { type: "string", enum: Array.isArray(field.options) ? field.options.map((o) => (typeof o === "string" ? o : o.value)) : undefined };
+            break;
+        case "multiSelect":
+            schema = {
+                type: "array",
+                items: { type: "string", enum: Array.isArray(field.options) ? field.options.map((o) => (typeof o === "string" ? o : o.value)) : undefined },
+            };
+            break;
+        case "relationship":
+            schema = { type: 'string', description: `ID of a ${field.relationTo} record` };
+            break;
+        case "object": {
+            const { properties, required } = fieldsToProperties(field.fields || []);
+            schema = { type: "object", properties, required };
+            break;
+        }
+        case "array": {
+            const { properties, required } = fieldsToProperties(field.fields || []);
+            schema = { type: "array", items: { type: "object", properties, required } };
+            break;
+        }
+        case "json":
+        case "richText":
+            schema = { type: "object", additionalProperties: true };
+            break;
+        case "blocks":
+            schema = {
+                type: "array",
+                items: {
+                    oneOf: field.blocks?.map((block) => {
+                        const { properties, required } = fieldsToProperties(block.fields);
+                        return {
+                            type: "object",
+                            properties: {
+                                blockType: { type: "string", enum: [block.slug] },
+                                ...properties,
+                            },
+                            required: ["blockType", ...required],
+                        };
+                    }),
+                },
+            };
+            break;
+        default:
+            schema = { type: "string" };
+    }
+    if (field.label)
+        schema.description = field.label;
+    return schema;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/utils/openapi.js.map

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

package/dist/utils/parse-where.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+export type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'starts_with' | 'exists';
+export type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    gte: any;
+} | {
+    lt: any;
+} | {
+    lte: any;
+} | {
+    contains: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+export type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[];
+    AND?: WhereClause[];
+};
+export interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+export declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+export declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+//# sourceMappingURL=parse-where.d.ts.map

package/dist/utils/parse-where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-where.d.ts","sourceRoot":"","sources":["../../src/utils/parse-where.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,YAAY,GACZ,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,UAAU,GACV,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,GACf;IAAE,UAAU,EAAE,GAAG,CAAA;CAAE,GACnB;IAAE,EAAE,EAAE,GAAG,EAAE,CAAA;CAAE,GACb;IAAE,MAAM,EAAE,GAAG,EAAE,CAAA;CAAE,GACjB;IAAE,EAAE,EAAE,GAAG,CAAA;CAAE,GACX;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,GAAG,CAAA;CAAE,GACX;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GACZ;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,GAAG,CAAC;IACrC,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,WAAW,EAAE,CAAC;CACrB,CAAC;AAUF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,GAAG,EAAE,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACvC,WAAW,GAAE,GAAG,GAAG,IAAU,GAC5B,cAAc,CA6GhB;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAkFvE"}

package/dist/utils/parse-where.js

@@ -0,0 +1,196 @@
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+/** Compile-time exhaustiveness guard. Any unhandled operator becomes a type error. */
+function assertNever(op, context) {
+    throw new Error(`[dyrected/core] Unhandled where operator "${op}" in ${context}`);
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+export function parseSqlWhere(where, getJsonField, placeholder = '?') {
+    const params = [];
+    let pgIndex = 1;
+    function next() {
+        return placeholder === 'pg' ? `$${pgIndex++}` : '?';
+    }
+    function col(field) {
+        return field === 'id' ? 'id' : getJsonField(field);
+    }
+    function buildOperator(field, value) {
+        const c = col(field);
+        // Shorthand scalar: { slug: 'hello' } → treat as equals
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            params.push(value);
+            return `${c} = ${next()}`;
+        }
+        const entries = Object.entries(value);
+        if (entries.length !== 1) {
+            // Multiple keys inside an operator object — treat as AND of conditions on same field
+            return entries
+                .map(([op, operand]) => buildSingleOp(c, op, operand))
+                .join(' AND ');
+        }
+        const [op, operand] = entries[0];
+        return buildSingleOp(c, op, operand);
+    }
+    function buildSingleOp(c, op, operand) {
+        switch (op) {
+            case 'equals':
+                params.push(typeof operand === 'boolean' ? String(operand) : operand);
+                return `${c} = ${next()}`;
+            case 'not_equals':
+                params.push(typeof operand === 'boolean' ? String(operand) : operand);
+                return `${c} != ${next()}`;
+            case 'in': {
+                const vals = Array.isArray(operand) ? operand : [operand];
+                if (vals.length === 0)
+                    return '1=0'; // IN () is invalid SQL
+                const placeholders = vals.map((v) => { params.push(v); return next(); });
+                return `${c} IN (${placeholders.join(', ')})`;
+            }
+            case 'not_in': {
+                const vals = Array.isArray(operand) ? operand : [operand];
+                if (vals.length === 0)
+                    return '1=1';
+                const placeholders = vals.map((v) => { params.push(v); return next(); });
+                return `${c} NOT IN (${placeholders.join(', ')})`;
+            }
+            case 'gt':
+                params.push(operand);
+                return `${c} > ${next()}`;
+            case 'gte':
+                params.push(operand);
+                return `${c} >= ${next()}`;
+            case 'lt':
+                params.push(operand);
+                return `${c} < ${next()}`;
+            case 'lte':
+                params.push(operand);
+                return `${c} <= ${next()}`;
+            case 'contains':
+                params.push(`%${operand}%`);
+                return `${c} LIKE ${next()}`;
+            case 'starts_with':
+                params.push(`${operand}%`);
+                return `${c} LIKE ${next()}`;
+            case 'exists':
+                return operand ? `${c} IS NOT NULL` : `${c} IS NULL`;
+            default:
+                // If you hit this, you added an operator to WhereOperatorName but forgot to handle it here.
+                return assertNever(op, 'parseSqlWhere');
+        }
+    }
+    function buildClause(w) {
+        const parts = [];
+        for (const [field, value] of Object.entries(w)) {
+            const upperField = field.toUpperCase();
+            if (upperField === 'OR' && Array.isArray(value)) {
+                const sub = value.map((v) => `(${buildClause(v)})`).join(' OR ');
+                parts.push(`(${sub})`);
+            }
+            else if (upperField === 'AND' && Array.isArray(value)) {
+                const sub = value.map((v) => `(${buildClause(v)})`).join(' AND ');
+                parts.push(`(${sub})`);
+            }
+            else {
+                parts.push(buildOperator(field, value));
+            }
+        }
+        return parts.length ? parts.join(' AND ') : '1=1';
+    }
+    const sql = buildClause(where);
+    return { sql, params };
+}
+// ─── MongoDB Translator ──────────────────────────────────────────────────────
+//  Used by: @dyrected/db-mongodb
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+export function parseMongoWhere(where) {
+    function buildOperator(field, value) {
+        // Shorthand scalar
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return { [field]: { $eq: value } };
+        }
+        const entries = Object.entries(value);
+        if (entries.length !== 1) {
+            // Multiple operators on same field — merge into one field condition
+            const merged = {};
+            for (const [op, operand] of entries) {
+                Object.assign(merged, buildSingleOp(field, op, operand)[field]);
+            }
+            return { [field]: merged };
+        }
+        const [op, operand] = entries[0];
+        return buildSingleOp(field, op, operand);
+    }
+    function buildSingleOp(field, op, operand) {
+        switch (op) {
+            case 'equals':
+                return { [field]: { $eq: operand } };
+            case 'not_equals':
+                return { [field]: { $ne: operand } };
+            case 'in':
+                return { [field]: { $in: Array.isArray(operand) ? operand : [operand] } };
+            case 'not_in':
+                return { [field]: { $nin: Array.isArray(operand) ? operand : [operand] } };
+            case 'gt':
+                return { [field]: { $gt: operand } };
+            case 'gte':
+                return { [field]: { $gte: operand } };
+            case 'lt':
+                return { [field]: { $lt: operand } };
+            case 'lte':
+                return { [field]: { $lte: operand } };
+            case 'contains':
+                return { [field]: { $regex: operand, $options: 'i' } };
+            case 'starts_with':
+                return { [field]: { $regex: `^${operand}`, $options: 'i' } };
+            case 'exists':
+                return { [field]: { $exists: operand } };
+            default:
+                // Compile-time exhaustiveness: adding an operator without handling it here = build error.
+                return assertNever(op, 'parseMongoWhere');
+        }
+    }
+    function buildClause(w) {
+        const conditions = [];
+        for (const [field, value] of Object.entries(w)) {
+            const upperField = field.toUpperCase();
+            if (upperField === 'OR' && Array.isArray(value)) {
+                conditions.push({ $or: value.map(buildClause) });
+            }
+            else if (upperField === 'AND' && Array.isArray(value)) {
+                conditions.push({ $and: value.map(buildClause) });
+            }
+            else {
+                conditions.push(buildOperator(field, value));
+            }
+        }
+        if (conditions.length === 0)
+            return {};
+        if (conditions.length === 1)
+            return conditions[0];
+        return { $and: conditions };
+    }
+    return buildClause(where);
+}
+//# sourceMappingURL=parse-where.js.map

package/dist/utils/parse-where.js.map

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

package/dist/utils/readonly-db.d.ts

@@ -0,0 +1,9 @@
+import type { DatabaseAdapter, ReadonlyDatabaseAdapter } from "../types/index.js";
+/**
+ * Wrap a DatabaseAdapter so that write operations throw at runtime.
+ *
+ * Passed to `beforeChange`, `beforeDelete`, `beforeRead`, `afterRead`,
+ * and field-level hooks — phases where only reads are permitted.
+ */
+export declare function createReadonlyDb(db: DatabaseAdapter): ReadonlyDatabaseAdapter;
+//# sourceMappingURL=readonly-db.d.ts.map

package/dist/utils/readonly-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-db.d.ts","sourceRoot":"","sources":["../../src/utils/readonly-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAIlF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,eAAe,GAAG,uBAAuB,CAc7E"}

package/dist/utils/readonly-db.js

@@ -0,0 +1,21 @@
+const WRITE_METHODS = ["create", "update", "delete", "updateGlobal", "execute"];
+/**
+ * Wrap a DatabaseAdapter so that write operations throw at runtime.
+ *
+ * Passed to `beforeChange`, `beforeDelete`, `beforeRead`, `afterRead`,
+ * and field-level hooks — phases where only reads are permitted.
+ */
+export function createReadonlyDb(db) {
+    return new Proxy(db, {
+        get(target, prop) {
+            if (WRITE_METHODS.includes(prop)) {
+                return () => {
+                    throw new Error(`[dyrected] Write operation "${String(prop)}" is not allowed in this hook phase. ` +
+                        `Use afterChange/afterDelete hooks for write operations.`);
+                };
+            }
+            return Reflect.get(target, prop);
+        },
+    });
+}
+//# sourceMappingURL=readonly-db.js.map

package/dist/utils/readonly-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-db.js","sourceRoot":"","sources":["../../src/utils/readonly-db.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAmB;IAClD,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;QACnB,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAc,CAAC,EAAE,CAAC;gBAC3C,OAAO,GAAG,EAAE;oBACV,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,IAAI,CAAC,uCAAuC;wBAClF,yDAAyD,CAC1D,CAAC;gBACJ,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}