@forge-cms/runtime 0.0.1

package/dist/operations.js

@@ -0,0 +1,402 @@
+import { validateCollection } from '@forge-cms/core';
+import { AccessDeniedError, ForgeError, InvalidInputError, NotFoundError, ValidationFailedError } from './errors.js';
+import { documentMatches, mergeWhere, resolveAccess } from './access.js';
+import { applyAutoSlugs, applyFieldDefaults } from './defaults.js';
+import { runAfterChangeHooks, runAfterDeleteHooks, runAfterOperationHooks, runAfterReadHooks, runBeforeChangeHooks, runBeforeDeleteHooks, runBeforeOperationHooks, runBeforeReadHooks, runBeforeValidateHooks, runFieldHooks } from './hooks.js';
+import { assertWritableFields, filterReadableFields, FieldAccessError } from './field-access.js';
+import { populateRecord, populateRecords } from './populate.js';
+import { createVersion, versionsEnabled } from './versions.js';
+import { isLocalizedCollection, storeLocalizedDocument, resolveLocalizedDocument } from './localization.js';
+import { checkDeleteRestrictions, handleCascadeDelete, handleSetNullOnDelete } from './relation-integrity.js';
+function getCollectionOrThrow(ctx, slug) {
+    const collection = ctx.getCollection(slug);
+    if (!collection)
+        throw new NotFoundError(`Collection '${slug}' not found`);
+    return collection;
+}
+function notFound(slug, id) {
+    return new NotFoundError(`Record '${id}' not found in '${slug}'`);
+}
+/**
+ * Resolves the collection's access rule for an operation.
+ *
+ * A rule that is not configured yields `undefined`, which every caller treats as "allowed" — the
+ * Local API has no route-level fallback to defer to, and the HTTP layer applies its own
+ * `allowedRoles` gate *before* calling in.
+ */
+async function checkAccess(collection, operation, args) {
+    if (args.overrideAccess !== false)
+        return { allowed: true };
+    const decision = await resolveAccess(collection.access?.[operation], {
+        user: args.user ?? null,
+        operation,
+        collection,
+        ...(args.id !== undefined && { id: args.id }),
+        ...(args.data !== undefined && { data: args.data }),
+        ...(args.doc !== undefined && { doc: args.doc })
+    });
+    if (decision === undefined)
+        return { allowed: true };
+    if (!decision.allowed)
+        throw new AccessDeniedError();
+    return decision;
+}
+/**
+ * The `_status` constraint for a read. Anonymous callers only ever see published documents,
+ * whatever they ask for.
+ *
+ * `defaultStatus` differs by operation, preserving spec 017's behaviour: a **list** stays
+ * published-only unless the caller opts in (`?status=draft|all`), because a listing is the surface
+ * that leaks unfinished content; a **single read by id** shows drafts to any authenticated caller,
+ * since they had to know the id already.
+ */
+function statusConstraint(collection, status, user, overrideAccess, defaultStatus) {
+    if (collection.drafts !== true)
+        return undefined;
+    // Trusted server-side calls see everything unless they ask for a specific status.
+    if (overrideAccess) {
+        if (status === undefined || status === 'all')
+            return undefined;
+        return { _status: status };
+    }
+    if (!user)
+        return { _status: 'published' };
+    const effective = status ?? defaultStatus;
+    if (effective === 'all')
+        return undefined;
+    return { _status: effective };
+}
+/**
+ * Runs a stage that may reject the write. A hook throwing a plain `Error` is a rejection of the
+ * caller's payload (400), not a server fault — preserving the spec-013 contract that a throwing
+ * `beforeChange` hook fails the request with its own message.
+ */
+async function runRejectableStage(stage, label) {
+    try {
+        return await stage();
+    }
+    catch (err) {
+        if (err instanceof ForgeError)
+            throw err;
+        throw new InvalidInputError(err instanceof Error ? err.message : `${label} failed`);
+    }
+}
+function assertDraftStatus(collection, data) {
+    if (collection.drafts !== true || data._status === undefined)
+        return;
+    if (data._status !== 'draft' && data._status !== 'published') {
+        throw new InvalidInputError(`Invalid status '${String(data._status)}', expected 'draft' or 'published'`);
+    }
+}
+/** The shared read-side tail: populate relations, strip unreadable fields, run read hooks. */
+async function prepareForRead(ctx, collection, records, args) {
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    let docs = records;
+    if (args.depth === 1) {
+        docs = await populateRecords(docs, collection, ctx);
+    }
+    if (args.overrideAccess === false) {
+        docs = await Promise.all(docs.map((doc) => filterReadableFields(doc, collection, user)));
+    }
+    // Resolve localized fields if locale is specified
+    if (args.locale && isLocalizedCollection(collection)) {
+        docs = docs.map((doc) => resolveLocalizedDocument(doc, collection, args.locale));
+    }
+    docs = await Promise.all(docs.map(async (doc) => {
+        const withFieldHooks = await runFieldHooks(collection, 'afterRead', {
+            data: doc,
+            operation: 'read',
+            user,
+            overrideAccess
+        });
+        return runAfterReadHooks(collection, { user, overrideAccess, doc: withFieldHooks });
+    }));
+    return docs;
+}
+async function prepareReadQuery(collection, args, defaultStatus) {
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    const decision = await checkAccess(collection, 'read', args);
+    let where = mergeWhere(args.where, decision.where);
+    where = mergeWhere(where, statusConstraint(collection, args.status, user, args.overrideAccess !== false, defaultStatus));
+    where = (await runBeforeReadHooks(collection, {
+        user,
+        overrideAccess,
+        query: where ?? {}
+    }));
+    return where !== undefined && Object.keys(where).length > 0 ? where : undefined;
+}
+export async function find(ctx, args) {
+    const collection = getCollectionOrThrow(ctx, args.collection);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    await runBeforeOperationHooks(collection, { operation: 'read', user, overrideAccess });
+    const where = await prepareReadQuery(collection, args, 'published');
+    const findOptions = {
+        collection: args.collection,
+        ...(args.limit !== undefined && { limit: args.limit }),
+        ...(args.offset !== undefined && { offset: args.offset }),
+        ...(where !== undefined && { where }),
+        ...(args.sort !== undefined && { sort: args.sort }),
+        ...(args.order !== undefined && { order: args.order })
+    };
+    const [records, totalDocs] = await Promise.all([
+        ctx.adapters.database.findMany(findOptions),
+        ctx.adapters.database.count(args.collection, where)
+    ]);
+    const docs = await prepareForRead(ctx, collection, records, args);
+    const result = paginate(docs, totalDocs, args.limit, args.offset ?? 0);
+    await runAfterOperationHooks(collection, { operation: 'read', user, overrideAccess, result });
+    return result;
+}
+function paginate(docs, totalDocs, limit, offset) {
+    const totalPages = limit !== undefined && limit > 0 ? Math.ceil(totalDocs / limit) : 1;
+    const page = limit !== undefined && limit > 0 ? Math.floor(offset / limit) + 1 : 1;
+    return {
+        docs,
+        totalDocs,
+        limit,
+        offset,
+        page,
+        totalPages,
+        hasNextPage: offset + docs.length < totalDocs,
+        hasPrevPage: offset > 0
+    };
+}
+export async function findByID(ctx, args) {
+    const collection = getCollectionOrThrow(ctx, args.collection);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    await runBeforeOperationHooks(collection, { operation: 'read', user, overrideAccess });
+    const decision = await checkAccess(collection, 'read', { ...args, id: args.id });
+    const record = await ctx.adapters.database.findById(args.collection, args.id);
+    if (!record)
+        throw notFound(args.collection, args.id);
+    // A document the caller may not reach must 404, not 403: a 403 confirms the id exists.
+    if (decision.where && !documentMatches(record, decision.where)) {
+        throw notFound(args.collection, args.id);
+    }
+    const status = statusConstraint(collection, args.status, user, args.overrideAccess !== false, 'all');
+    if (status && !documentMatches(record, status)) {
+        throw notFound(args.collection, args.id);
+    }
+    const [doc] = await prepareForRead(ctx, collection, [record], args);
+    const result = doc ?? record;
+    await runAfterOperationHooks(collection, { operation: 'read', user, overrideAccess, result });
+    return result;
+}
+export async function count(ctx, args) {
+    const collection = getCollectionOrThrow(ctx, args.collection);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    await runBeforeOperationHooks(collection, { operation: 'read', user, overrideAccess });
+    const where = await prepareReadQuery(collection, args, 'published');
+    const result = await ctx.adapters.database.count(args.collection, where);
+    await runAfterOperationHooks(collection, { operation: 'read', user, overrideAccess, result });
+    return result;
+}
+export async function create(ctx, args) {
+    const collection = getCollectionOrThrow(ctx, args.collection);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    await runBeforeOperationHooks(collection, { operation: 'create', user, overrideAccess });
+    await checkAccess(collection, 'create', { ...args, data: args.data });
+    if (args.overrideAccess === false) {
+        try {
+            await assertWritableFields(args.data, collection, user, 'create');
+        }
+        catch (err) {
+            if (err instanceof FieldAccessError)
+                throw new AccessDeniedError(err.message);
+            throw err;
+        }
+    }
+    // Defaults and auto-slugs are resolved before any hook runs, so a hook still gets the last word
+    // and validation only ever sees the final value.
+    const seeded = applyAutoSlugs(collection, applyFieldDefaults(collection, args.data));
+    // Process localized fields if the collection has locales configured
+    const processedData = isLocalizedCollection(collection) && args.locale
+        ? storeLocalizedDocument(seeded, collection, args.locale)
+        : seeded;
+    let data = await runRejectableStage(async () => runBeforeValidateHooks(collection, {
+        operation: 'create',
+        data: await runFieldHooks(collection, 'beforeValidate', {
+            data: processedData,
+            operation: 'create',
+            user,
+            overrideAccess
+        }),
+        user,
+        overrideAccess
+    }), 'beforeValidate hook');
+    assertDraftStatus(collection, data);
+    if (collection.drafts === true && data._status === undefined) {
+        data = { ...data, _status: 'draft' };
+    }
+    const validation = validateCollection(collection, data);
+    if (!validation.valid)
+        throw new ValidationFailedError(validation.errors);
+    data = await runRejectableStage(async () => runBeforeChangeHooks(collection, {
+        operation: 'create',
+        data: await runFieldHooks(collection, 'beforeChange', {
+            data,
+            operation: 'create',
+            user,
+            overrideAccess
+        }),
+        user,
+        overrideAccess
+    }), 'beforeChange hook');
+    const record = await ctx.adapters.database.create(args.collection, data);
+    // Create initial version if versions are enabled
+    if (versionsEnabled(collection)) {
+        await createVersion(ctx, {
+            collection: args.collection,
+            documentId: record.id,
+            data,
+            user
+        });
+    }
+    await runAfterChangeHooks(collection, {
+        operation: 'create',
+        data,
+        result: record,
+        doc: record,
+        user,
+        overrideAccess
+    });
+    const [doc] = await prepareForRead(ctx, collection, [record], args);
+    const result = doc ?? record;
+    await runAfterOperationHooks(collection, { operation: 'create', user, overrideAccess, result });
+    return result;
+}
+export async function update(ctx, args) {
+    const collection = getCollectionOrThrow(ctx, args.collection);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    await runBeforeOperationHooks(collection, { operation: 'update', user, overrideAccess });
+    const existing = await ctx.adapters.database.findById(args.collection, args.id);
+    if (!existing)
+        throw notFound(args.collection, args.id);
+    const decision = await checkAccess(collection, 'update', {
+        ...args,
+        id: args.id,
+        data: args.data,
+        doc: existing
+    });
+    if (decision.where && !documentMatches(existing, decision.where)) {
+        throw new AccessDeniedError();
+    }
+    if (args.overrideAccess === false) {
+        try {
+            await assertWritableFields(args.data, collection, user, 'update');
+        }
+        catch (err) {
+            if (err instanceof FieldAccessError)
+                throw new AccessDeniedError(err.message);
+            throw err;
+        }
+    }
+    // Process localized fields if the collection has locales configured
+    const processedData = isLocalizedCollection(collection) && args.locale
+        ? storeLocalizedDocument(args.data, collection, args.locale, existing)
+        : args.data;
+    let data = await runRejectableStage(async () => runBeforeValidateHooks(collection, {
+        operation: 'update',
+        data: await runFieldHooks(collection, 'beforeValidate', {
+            data: applyAutoSlugs(collection, processedData, existing),
+            previousData: existing,
+            operation: 'update',
+            user,
+            overrideAccess
+        }),
+        previousData: existing,
+        user,
+        overrideAccess
+    }), 'beforeValidate hook');
+    assertDraftStatus(collection, data);
+    // Validate the merged document so required fields already stored do not fail a partial update,
+    // then report only the errors the caller can actually act on: fields they are touching, or fields
+    // that are still missing entirely.
+    const merged = { ...existing, ...data };
+    const validation = validateCollection(collection, merged);
+    if (!validation.valid) {
+        const relevant = validation.errors.filter((e) => {
+            const top = e.field.split('.')[0] ?? e.field;
+            return data[top] !== undefined || existing[top] === undefined;
+        });
+        if (relevant.length > 0)
+            throw new ValidationFailedError(relevant);
+    }
+    data = await runRejectableStage(async () => runBeforeChangeHooks(collection, {
+        operation: 'update',
+        data: await runFieldHooks(collection, 'beforeChange', {
+            data,
+            previousData: existing,
+            operation: 'update',
+            user,
+            overrideAccess
+        }),
+        previousData: existing,
+        user,
+        overrideAccess
+    }), 'beforeChange hook');
+    const record = await ctx.adapters.database.update(args.collection, args.id, data);
+    // Create a version snapshot if versions are enabled
+    if (versionsEnabled(collection)) {
+        await createVersion(ctx, {
+            collection: args.collection,
+            documentId: args.id,
+            data,
+            user
+        });
+    }
+    await runAfterChangeHooks(collection, {
+        operation: 'update',
+        data,
+        previousData: existing,
+        result: record,
+        doc: record,
+        user,
+        overrideAccess
+    });
+    const [doc] = await prepareForRead(ctx, collection, [record], args);
+    const result = doc ?? record;
+    await runAfterOperationHooks(collection, { operation: 'update', user, overrideAccess, result });
+    return result;
+}
+export async function deleteDocument(ctx, args) {
+    const collection = getCollectionOrThrow(ctx, args.collection);
+    const user = args.user ?? null;
+    const overrideAccess = args.overrideAccess !== false;
+    await runBeforeOperationHooks(collection, { operation: 'delete', user, overrideAccess });
+    const existing = await ctx.adapters.database.findById(args.collection, args.id);
+    if (!existing)
+        throw notFound(args.collection, args.id);
+    const decision = await checkAccess(collection, 'delete', {
+        ...args,
+        id: args.id,
+        doc: existing
+    });
+    if (decision.where && !documentMatches(existing, decision.where)) {
+        throw new AccessDeniedError();
+    }
+    await runRejectableStage(() => runBeforeDeleteHooks(collection, { user, overrideAccess, id: args.id, doc: existing }), 'beforeDelete hook');
+    // Check relation integrity constraints
+    await checkDeleteRestrictions(ctx, collection, args.id);
+    // Handle cascade and set-null before deleting
+    await handleCascadeDelete(ctx, collection, args.id);
+    await handleSetNullOnDelete(ctx, collection, args.id);
+    await ctx.adapters.database.delete(args.collection, args.id);
+    await runAfterDeleteHooks(collection, { user, overrideAccess, id: args.id, doc: existing });
+    await runAfterOperationHooks(collection, {
+        operation: 'delete',
+        user,
+        overrideAccess,
+        result: existing
+    });
+    return existing;
+}
+export { populateRecord, populateRecords };
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/populate.d.ts

@@ -0,0 +1,6 @@
+import type { CollectionDefinition } from '@forge-cms/core';
+import type { DatabaseRecord } from '@forge-cms/db';
+import type { OperationContext } from './context.js';
+export declare function populateRecords(records: DatabaseRecord[], collection: CollectionDefinition, ctx: OperationContext): Promise<DatabaseRecord[]>;
+export declare function populateRecord(record: DatabaseRecord, collection: CollectionDefinition, ctx: OperationContext): Promise<DatabaseRecord>;
+//# sourceMappingURL=populate.d.ts.map

package/dist/populate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"populate.d.ts","sourceRoot":"","sources":["../src/populate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AA0BrD,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,EAAE,oBAAoB,EAChC,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CA0C3B;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,oBAAoB,EAChC,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,cAAc,CAAC,CAGzB"}

package/dist/populate.js

@@ -0,0 +1,65 @@
+/**
+ * Every field `depth: 1` resolves: `relation` and — since spec 040 — `upload`, which is a single
+ * relation to an upload-enabled collection in everything but name. Leaving `upload` out meant every
+ * image in a populated response came back as a bare id, which no client can render.
+ */
+function getRelationFields(collection) {
+    return Object.entries(collection.fields)
+        .filter(([, field]) => field.kind === 'relation' || field.kind === 'upload')
+        .map(([name, field]) => {
+        if (field.kind === 'upload') {
+            const options = field.options;
+            return { name, targetSlug: options.collection, many: false };
+        }
+        const options = field.options;
+        return { name, targetSlug: options.collection, many: options.many === true };
+    });
+}
+export async function populateRecords(records, collection, ctx) {
+    const relationFields = getRelationFields(collection);
+    if (relationFields.length === 0 || records.length === 0)
+        return records;
+    const populated = records.map((record) => ({ ...record }));
+    for (const { name, targetSlug, many } of relationFields) {
+        if (!ctx.getCollection(targetSlug))
+            continue;
+        const ids = new Set();
+        for (const record of populated) {
+            const value = record[name];
+            if (many && Array.isArray(value)) {
+                for (const id of value) {
+                    if (typeof id === 'string')
+                        ids.add(id);
+                }
+            }
+            else if (typeof value === 'string') {
+                ids.add(value);
+            }
+        }
+        if (ids.size === 0)
+            continue;
+        const related = await ctx.adapters.database.findMany({
+            collection: targetSlug,
+            where: { id: { in: Array.from(ids) } }
+        });
+        const byId = new Map(related.map((r) => [r.id, r]));
+        for (const record of populated) {
+            const value = record[name];
+            if (many && Array.isArray(value)) {
+                record[name] = value
+                    .filter((id) => typeof id === 'string')
+                    .map((id) => byId.get(id))
+                    .filter((related) => related !== undefined);
+            }
+            else if (typeof value === 'string') {
+                record[name] = byId.get(value) ?? null;
+            }
+        }
+    }
+    return populated;
+}
+export async function populateRecord(record, collection, ctx) {
+    const [result] = await populateRecords([record], collection, ctx);
+    return result ?? record;
+}
+//# sourceMappingURL=populate.js.map

package/dist/populate.js.map

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

package/dist/relation-integrity.d.ts

@@ -0,0 +1,39 @@
+import type { CollectionDefinition, RelationFieldOptions } from '@forge-cms/core';
+import type { DatabaseRecord } from '@forge-cms/db';
+import type { OperationContext } from './context.js';
+/**
+ * Relation integrity utilities for handling cascade, restrict, and set-null on delete.
+ */
+/**
+ * Finds all relation fields in a collection that reference a target collection.
+ */
+export declare function findRelationFields(collection: CollectionDefinition, targetCollection: string): Array<{
+    fieldName: string;
+    options: RelationFieldOptions;
+}>;
+/**
+ * Finds all documents in a collection that reference a specific document ID.
+ */
+export declare function findReferencingDocuments(ctx: OperationContext, collection: CollectionDefinition, fieldName: string, documentId: string, many: boolean): Promise<DatabaseRecord[]>;
+/**
+ * Checks if a document can be deleted based on relation constraints.
+ * Throws InvalidInputError if deletion is restricted.
+ */
+export declare function checkDeleteRestrictions(ctx: OperationContext, targetCollection: CollectionDefinition, documentId: string): Promise<void>;
+/**
+ * Handles cascade delete: deletes all documents that reference the deleted document.
+ */
+export declare function handleCascadeDelete(ctx: OperationContext, targetCollection: CollectionDefinition, documentId: string): Promise<void>;
+/**
+ * Handles set-null: sets relation fields to null in all referencing documents.
+ */
+export declare function handleSetNullOnDelete(ctx: OperationContext, targetCollection: CollectionDefinition, documentId: string): Promise<void>;
+/**
+ * Finds orphaned documents: documents with relation fields pointing to non-existent documents.
+ */
+export declare function findOrphanedDocuments(ctx: OperationContext, collection: CollectionDefinition): Promise<Array<{
+    document: DatabaseRecord;
+    fieldName: string;
+    missingId: string;
+}>>;
+//# sourceMappingURL=relation-integrity.d.ts.map

package/dist/relation-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-integrity.d.ts","sourceRoot":"","sources":["../src/relation-integrity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,oBAAoB,EAChC,gBAAgB,EAAE,MAAM,GACvB,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAa7D;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,gBAAgB,EACrB,gBAAgB,EAAE,oBAAoB,EACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,gBAAgB,EAAE,oBAAoB,EACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,gBAAgB,EAAE,oBAAoB,EACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkCpF"}