@dyrected/core 2.6.2 → 2.6.4

package/dist/utils/collection-search.d.ts

@@ -0,0 +1,11 @@
+import type { CollectionConfig, Field, ReadonlyDatabaseAdapter } from "../types/index.js";
+import type { WhereClause } from "./parse-where.js";
+export declare function resolveCollectionTitleField(collection: CollectionConfig): Field | undefined;
+export declare function getCollectionSearchableFields(collection: CollectionConfig): Field[];
+export declare function buildCollectionSearchWhere(args: {
+    collection: CollectionConfig;
+    search: string | undefined;
+    db: ReadonlyDatabaseAdapter;
+    collections: CollectionConfig[];
+}): Promise<WhereClause | undefined>;
+//# sourceMappingURL=collection-search.d.ts.map

package/dist/utils/collection-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-search.d.ts","sourceRoot":"","sources":["../../src/utils/collection-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA8BpD,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAU3F;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,gBAAgB,GAAG,KAAK,EAAE,CAgCnF;AAoJD,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,EAAE,EAAE,uBAAuB,CAAC;IAC5B,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA+BnC"}

package/dist/utils/collection-search.js

@@ -0,0 +1,204 @@
+const DEFAULT_SEARCHABLE_NAMES = new Set([
+    "title",
+    "name",
+    "label",
+    "slug",
+    "email",
+    "caption",
+    "description",
+]);
+const MAX_RELATION_MATCHES = 50;
+const MAX_RELATION_TITLE_DEPTH = 8;
+const TITLE_FALLBACK_NAMES = ["title", "name", "label", "heading", "email", "subject"];
+function isScalarSearchField(field) {
+    return (field.type === "text" ||
+        field.type === "textarea" ||
+        field.type === "richText" ||
+        field.type === "email");
+}
+function findFieldByName(collection, fieldName) {
+    if (!fieldName)
+        return undefined;
+    return collection.fields.find((field) => field.name === fieldName);
+}
+export function resolveCollectionTitleField(collection) {
+    const configured = findFieldByName(collection, collection.admin?.useAsTitle);
+    if (configured)
+        return configured;
+    for (const name of TITLE_FALLBACK_NAMES) {
+        const field = findFieldByName(collection, name);
+        if (field)
+            return field;
+    }
+    return collection.fields.find((field) => !!field.name && field.type !== "join" && field.type !== "row");
+}
+export function getCollectionSearchableFields(collection) {
+    const fieldByName = new Map(collection.fields
+        .filter((field) => !!field.name)
+        .map((field) => [field.name, field]));
+    const configured = collection.admin?.searchableFields
+        ?.map((fieldName) => fieldByName.get(fieldName))
+        .filter((field) => !!field);
+    if (configured && configured.length > 0) {
+        return configured;
+    }
+    const results = [];
+    const pushUnique = (field) => {
+        if (!field?.name)
+            return;
+        if (results.some((item) => item.name === field.name))
+            return;
+        results.push(field);
+    };
+    pushUnique(findFieldByName(collection, collection.admin?.useAsTitle));
+    for (const field of collection.fields) {
+        if (!field.name)
+            continue;
+        if (isScalarSearchField(field) && DEFAULT_SEARCHABLE_NAMES.has(field.name)) {
+            pushUnique(field);
+        }
+    }
+    return results;
+}
+function buildScalarSearchClause(fieldName, search) {
+    return { [fieldName]: { contains: search } };
+}
+function getFallbackTitleFields(collection) {
+    const fields = [];
+    for (const name of TITLE_FALLBACK_NAMES) {
+        const field = findFieldByName(collection, name);
+        if (!field?.name || !isScalarSearchField(field))
+            continue;
+        if (fields.some((item) => item.name === field.name))
+            continue;
+        fields.push(field);
+    }
+    return fields;
+}
+async function findMatchingDocumentIdsByWhere(args) {
+    const { collection, where, db } = args;
+    if (!where)
+        return [];
+    const matches = await db.find({
+        collection: collection.slug,
+        where,
+        limit: MAX_RELATION_MATCHES,
+    });
+    return matches.docs
+        .map((doc) => doc?.id)
+        .filter((id) => typeof id === "string");
+}
+function buildMultiRelationshipClause(fieldName, ids) {
+    const matches = ids.map((id) => ({
+        OR: [
+            { [fieldName]: { contains: `"${id}"` } },
+            { [fieldName]: { contains: id } },
+        ],
+    }));
+    if (matches.length === 0)
+        return undefined;
+    return matches.length === 1 ? matches[0] : { OR: matches };
+}
+function buildRelationshipMatchClause(field, ids) {
+    if (!field.name || ids.length === 0)
+        return undefined;
+    if (field.hasMany) {
+        return buildMultiRelationshipClause(field.name, ids);
+    }
+    return { [field.name]: { in: ids } };
+}
+async function findMatchingDocumentIdsByTitle(args) {
+    const { collection, search, db, collections, depth = 0 } = args;
+    if (depth >= MAX_RELATION_TITLE_DEPTH) {
+        return [];
+    }
+    const ids = new Set();
+    const titleField = resolveCollectionTitleField(collection);
+    if (titleField?.name && isScalarSearchField(titleField)) {
+        for (const id of await findMatchingDocumentIdsByWhere({
+            collection,
+            where: buildScalarSearchClause(titleField.name, search),
+            db,
+        })) {
+            ids.add(id);
+        }
+    }
+    if (titleField?.type === "relationship" && titleField.relationTo) {
+        for (const field of getFallbackTitleFields(collection)) {
+            for (const id of await findMatchingDocumentIdsByWhere({
+                collection,
+                where: buildScalarSearchClause(field.name, search),
+                db,
+            })) {
+                ids.add(id);
+            }
+        }
+        const relatedCollection = collections.find((item) => item.slug === titleField.relationTo);
+        if (relatedCollection) {
+            const relatedIds = await findMatchingDocumentIdsByTitle({
+                collection: relatedCollection,
+                search,
+                db,
+                collections,
+                depth: depth + 1,
+            });
+            const relationClause = buildRelationshipMatchClause(titleField, relatedIds);
+            for (const id of await findMatchingDocumentIdsByWhere({
+                collection,
+                where: relationClause,
+                db,
+            })) {
+                ids.add(id);
+            }
+        }
+    }
+    return Array.from(ids).slice(0, MAX_RELATION_MATCHES);
+}
+async function buildRelationshipSearchClause(args) {
+    const { field, search, db, collections } = args;
+    if (!field.name || field.type !== "relationship" || !field.relationTo) {
+        return undefined;
+    }
+    const relatedCollection = collections.find((collection) => collection.slug === field.relationTo);
+    if (!relatedCollection)
+        return undefined;
+    const ids = await findMatchingDocumentIdsByTitle({
+        collection: relatedCollection,
+        search,
+        db,
+        collections,
+    });
+    return buildRelationshipMatchClause(field, ids);
+}
+export async function buildCollectionSearchWhere(args) {
+    const { collection, search, db, collections } = args;
+    const trimmedSearch = search?.trim();
+    if (!trimmedSearch)
+        return undefined;
+    const searchableFields = getCollectionSearchableFields(collection);
+    if (searchableFields.length === 0)
+        return undefined;
+    const clauses = [];
+    for (const field of searchableFields) {
+        if (!field.name)
+            continue;
+        if (isScalarSearchField(field)) {
+            clauses.push(buildScalarSearchClause(field.name, trimmedSearch));
+            continue;
+        }
+        if (field.type === "relationship") {
+            const clause = await buildRelationshipSearchClause({
+                field,
+                search: trimmedSearch,
+                db,
+                collections,
+            });
+            if (clause)
+                clauses.push(clause);
+        }
+    }
+    if (clauses.length === 0)
+        return undefined;
+    return clauses.length === 1 ? clauses[0] : { OR: clauses };
+}
+//# sourceMappingURL=collection-search.js.map

package/dist/utils/collection-search.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,8 @@
+import type { DyrectedConfig } from "../types/index.js";
+/**
+ * Normalizes the Dyrected configuration by injecting system fields
+ * (createdAt, updatedAt, createdBy, updatedBy) into every collection and
+ * registering the __audit collection if any collection has audit: true.
+ */
+export declare function normalizeConfig(config: DyrectedConfig): DyrectedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,mBAAmB,CAAC;AA6I3B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAiOtE"}

package/dist/utils/config.js

@@ -0,0 +1,336 @@
+import { AUTH_SESSIONS_COLLECTION } from "../auth/sessions.js";
+import { LIFECYCLE_EVENTS_COLLECTION, WORKFLOW_HISTORY_COLLECTION, simplePublishingWorkflow, } from "../workflows.js";
+import { getAdminAuthCollection } from "./admin-auth.js";
+import { normalizeSchemaFragment } from "./block-references.js";
+const AUDIT_COLLECTION_SLUG = "__audit";
+const SYSTEM_FIELDS = [
+    {
+        name: "createdAt",
+        type: "date",
+        label: "Created At",
+        admin: { readOnly: true, hidden: true },
+    },
+    {
+        name: "updatedAt",
+        type: "date",
+        label: "Updated At",
+        admin: { readOnly: true, hidden: true },
+    },
+    {
+        name: "createdBy",
+        type: "text",
+        label: "Created By",
+        admin: { readOnly: true, hidden: true },
+    },
+    {
+        name: "updatedBy",
+        type: "text",
+        label: "Updated By",
+        admin: { readOnly: true, hidden: true },
+    },
+];
+const AUDIT_COLLECTION = {
+    slug: AUDIT_COLLECTION_SLUG,
+    labels: { singular: "Audit Log", plural: "Audit Logs" },
+    fields: [
+        { name: "collection", type: "text", label: "Collection", required: true },
+        { name: "documentId", type: "text", label: "Document ID" },
+        {
+            name: "operation",
+            type: "select",
+            label: "Operation",
+            options: ["create", "update", "delete"],
+            required: true,
+        },
+        { name: "user", type: "text", label: "User ID" },
+        { name: "timestamp", type: "date", label: "Timestamp", required: true },
+        { name: "changes", type: "json", label: "Changes" },
+    ],
+    access: {
+        read: () => false,
+        create: () => false,
+        update: () => false,
+        delete: () => false,
+    },
+    admin: { hidden: true },
+};
+const WORKFLOW_HISTORY_COLLECTION_CONFIG = {
+    slug: WORKFLOW_HISTORY_COLLECTION,
+    labels: { singular: "Workflow transition", plural: "Workflow transitions" },
+    fields: [
+        { name: "collection", type: "text", required: true },
+        { name: "documentId", type: "text", required: true },
+        { name: "transition", type: "text", required: true },
+        { name: "from", type: "text", required: true },
+        { name: "to", type: "text", required: true },
+        { name: "revision", type: "number", required: true },
+        { name: "comment", type: "textarea" },
+        { name: "actorId", type: "text" },
+        { name: "createdAt", type: "date", required: true },
+    ],
+    access: {
+        read: ({ user }) => !!user,
+        create: () => false,
+        update: () => false,
+        delete: () => false,
+    },
+    admin: { hidden: true },
+};
+const LIFECYCLE_EVENTS_COLLECTION_CONFIG = {
+    slug: LIFECYCLE_EVENTS_COLLECTION,
+    labels: { singular: "Lifecycle event", plural: "Lifecycle events" },
+    fields: [
+        { name: "name", type: "text", required: true },
+        { name: "collection", type: "text", required: true },
+        { name: "documentId", type: "text", required: true },
+        { name: "occurredAt", type: "date", required: true },
+        { name: "actorId", type: "text" },
+        { name: "payload", type: "json", required: true },
+        { name: "attempts", type: "number", required: true },
+        {
+            name: "status",
+            type: "select",
+            options: ["pending", "processing", "delivered", "failed"],
+            required: true,
+        },
+        { name: "nextAttemptAt", type: "date" },
+        { name: "deliveredAt", type: "date" },
+        { name: "lastError", type: "textarea" },
+    ],
+    access: {
+        read: ({ user }) => !!user?.roles?.includes("admin"),
+        create: () => false,
+        update: () => false,
+        delete: () => false,
+    },
+    admin: { hidden: true },
+};
+const AUTH_SESSIONS_COLLECTION_CONFIG = {
+    slug: AUTH_SESSIONS_COLLECTION,
+    labels: { singular: "Auth session", plural: "Auth sessions" },
+    fields: [
+        { name: "userId", type: "text", required: true },
+        { name: "email", type: "email", required: true },
+        { name: "collection", type: "text", required: true },
+        { name: "authSource", type: "text" },
+        { name: "providerId", type: "text" },
+        { name: "lastIp", type: "text" },
+        { name: "lastSeenAt", type: "date" },
+        { name: "expiresAt", type: "date" },
+        { name: "revokedAt", type: "date" },
+    ],
+    access: {
+        read: () => false,
+        create: () => false,
+        update: () => false,
+        delete: () => false,
+    },
+    admin: { hidden: true },
+};
+/**
+ * Normalizes the Dyrected configuration by injecting system fields
+ * (createdAt, updatedAt, createdBy, updatedBy) into every collection and
+ * registering the __audit collection if any collection has audit: true.
+ */
+export function normalizeConfig(config) {
+    const schemaAwareConfig = normalizeSchemaFragment(config);
+    const collections = schemaAwareConfig?.collections || [];
+    const globals = schemaAwareConfig?.globals || [];
+    const needsAudit = collections.some((col) => col.audit);
+    const needsWorkflow = collections.some((col) => col.workflow || col.drafts);
+    const needsAuthSessions = collections.some((col) => !!col.auth);
+    const adminAuthCollectionSlug = getAdminAuthCollection({
+        collections,
+        adminAuth: schemaAwareConfig.adminAuth,
+    })?.slug;
+    const normalizedCollections = collections.map((col) => {
+        let fields = col.fields || [];
+        const existingFieldNames = new Set(fields.map((f) => f.name));
+        // Inject email and password if auth is enabled
+        if (col.auth) {
+            if (!existingFieldNames.has("email")) {
+                fields = [
+                    ...fields,
+                    {
+                        name: "email",
+                        type: "email",
+                        label: "Email",
+                        required: true,
+                        unique: true,
+                        promoted: true,
+                        access: {
+                            update: "!id",
+                        },
+                    },
+                ];
+            }
+            if (!existingFieldNames.has("password")) {
+                fields = [
+                    ...fields,
+                    {
+                        name: "password",
+                        type: "text",
+                        label: "Password",
+                        required: true,
+                        access: {
+                            update: "!id || user.id == id",
+                        },
+                    },
+                ];
+            }
+            if (!existingFieldNames.has("roles")) {
+                fields = [
+                    ...fields,
+                    {
+                        name: "roles",
+                        type: "select",
+                        label: "Roles",
+                        defaultValue: [],
+                        options: [
+                            { value: "admin", label: "Admin" },
+                            { value: "editor", label: "Editor" },
+                            { value: "viewer", label: "Viewer" },
+                        ],
+                        access: {
+                            update: "user.roles && 'admin' in user.roles",
+                        },
+                    },
+                ];
+            }
+            if (!existingFieldNames.has("status")) {
+                fields = [
+                    ...fields,
+                    {
+                        name: "status",
+                        type: "select",
+                        label: "Status",
+                        defaultValue: "active",
+                        options: [
+                            { value: "active", label: "Active" },
+                            { value: "pending", label: "Pending" },
+                        ],
+                        access: {
+                            update: "user.roles && 'admin' in user.roles && user.id != id",
+                        },
+                    },
+                ];
+            }
+            // Enforce access control rules for email, password, and roles fields even if explicitly defined
+            fields = fields.map((field) => {
+                if (field.name === "email") {
+                    return {
+                        ...field,
+                        // Email is the login identifier. Keep the integrity constraints
+                        // auth relies on even when the field is explicitly redefined, so a
+                        // custom `email` field can never silently drop uniqueness.
+                        required: true,
+                        unique: true,
+                        promoted: true,
+                        access: {
+                            ...(field.access || {}),
+                            update: "!id",
+                        },
+                    };
+                }
+                if (field.name === "password") {
+                    return {
+                        ...field,
+                        // Password is required to authenticate; enforce it regardless of
+                        // how the field was declared.
+                        required: true,
+                        admin: { ...(field.admin || {}) },
+                        access: {
+                            ...(field.access || {}),
+                            update: "!id || user.id == id",
+                        },
+                    };
+                }
+                if (field.name === "roles") {
+                    return {
+                        ...field,
+                        access: {
+                            ...(field.access || {}),
+                            // Must be an admin; cannot edit own roles (no self-elevation).
+                            update: "user.roles && 'admin' in user.roles && user.id != id",
+                        },
+                    };
+                }
+                if (field.name === "status") {
+                    return {
+                        ...field,
+                        access: {
+                            ...(field.access || {}),
+                            update: "user.roles && 'admin' in user.roles && user.id != id",
+                        },
+                    };
+                }
+                return field;
+            });
+        }
+        if (adminAuthCollectionSlug &&
+            col.slug === adminAuthCollectionSlug &&
+            schemaAwareConfig.adminAuth?.mode === "external") {
+            const externalAdminFields = [
+                {
+                    name: "authProvider",
+                    type: "text",
+                    label: "Auth Provider",
+                    admin: { readOnly: true, hidden: true },
+                },
+                {
+                    name: "externalSubject",
+                    type: "text",
+                    label: "External Subject",
+                    admin: { readOnly: true, hidden: true },
+                },
+                {
+                    name: "authSource",
+                    type: "text",
+                    label: "Auth Source",
+                    admin: { readOnly: true, hidden: true },
+                },
+                {
+                    name: "lastLoginAt",
+                    type: "date",
+                    label: "Last Login At",
+                    admin: { readOnly: true, hidden: true },
+                },
+            ];
+            for (const field of externalAdminFields) {
+                if (!existingFieldNames.has(field.name)) {
+                    fields = [...fields, field];
+                }
+            }
+        }
+        const updatedFieldNames = new Set(fields.map((f) => f.name));
+        const fieldsToInject = SYSTEM_FIELDS.filter((f) => !updatedFieldNames.has(f.name));
+        const workflow = col.workflow || (col.drafts ? simplePublishingWorkflow() : undefined);
+        return {
+            ...col,
+            workflow,
+            fields: [...fields, ...fieldsToInject],
+        };
+    });
+    const hasAuditCollection = normalizedCollections.some((col) => col.slug === AUDIT_COLLECTION_SLUG);
+    const systemCollections = [];
+    if (needsAudit && !hasAuditCollection)
+        systemCollections.push(AUDIT_COLLECTION);
+    if (needsWorkflow &&
+        !normalizedCollections.some((col) => col.slug === WORKFLOW_HISTORY_COLLECTION)) {
+        systemCollections.push(WORKFLOW_HISTORY_COLLECTION_CONFIG);
+    }
+    if (needsWorkflow &&
+        !normalizedCollections.some((col) => col.slug === LIFECYCLE_EVENTS_COLLECTION)) {
+        systemCollections.push(LIFECYCLE_EVENTS_COLLECTION_CONFIG);
+    }
+    if (needsAuthSessions &&
+        !normalizedCollections.some((col) => col.slug === AUTH_SESSIONS_COLLECTION)) {
+        systemCollections.push(AUTH_SESSIONS_COLLECTION_CONFIG);
+    }
+    return {
+        ...schemaAwareConfig,
+        collections: [...normalizedCollections, ...systemCollections],
+        globals,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/hooks.d.ts

@@ -0,0 +1,41 @@
+import type { Field } from "../types/index.js";
+type AnyHookFn = (args: any) => any;
+/**
+ * Run a list of hook functions sequentially.
+ *
+ * Each hook receives the output of the previous hook merged back into the
+ * original `args`. When a hook returns a non-undefined value it becomes the
+ * `data` / `doc` for the next hook in the chain.
+ *
+ * Pass `{ isolated: true }` for hooks that run **after** a DB write has already
+ * been committed (`afterChange`, `afterDelete`). In isolated mode each hook is
+ * wrapped in a try/catch so a failing side-effect (email, webhook, etc.) never
+ * surfaces as an HTTP 500 to the caller — the write already succeeded.
+ */
+export declare function runCollectionHooks(hooks: AnyHookFn[] | undefined, args: {
+    data?: unknown;
+    doc?: unknown;
+    user?: unknown;
+    req?: unknown;
+    db?: unknown;
+    operation?: "create" | "update" | "delete";
+    [key: string]: unknown;
+}, options?: {
+    isolated?: boolean;
+}): Promise<any>;
+/**
+ * Execute field-level `beforeChange` hooks recursively on a data payload.
+ *
+ * Traverses `array`, `object`, and `blocks` fields depth-first so that nested
+ * field hooks fire on every item automatically.
+ */
+export declare function executeFieldBeforeChange(fields: Field[], data: Record<string, unknown>, originalDoc: Record<string, unknown> | null, user: unknown, db?: unknown): Promise<Record<string, unknown>>;
+/**
+ * Execute field-level `afterRead` hooks recursively on a document.
+ *
+ * Traverses `array`, `object`, and `blocks` fields depth-first so that nested
+ * field hooks fire on every item automatically.
+ */
+export declare function executeFieldAfterRead(fields: Field[], doc: Record<string, unknown>, user: unknown, db?: unknown): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/utils/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/utils/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,KAAK,EAMN,MAAM,mBAAmB,CAAC;AAO3B,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;AAWpC;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAC9B,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,EACD,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC,GAAG,CAAC,CA+Bd;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,KAAK,EAAE,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC3C,IAAI,EAAE,OAAO,EACb,EAAE,CAAC,EAAE,OAAO,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgGlC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,KAAK,EAAE,EACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,OAAO,EACb,EAAE,CAAC,EAAE,OAAO,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoFlC"}