@byline/core 0.9.3

package/dist/config/validate-admin-configs.d.ts

@@ -0,0 +1,33 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { CollectionAdminConfig, CollectionDefinition } from '../@types/index.js';
+/**
+ * Validate every admin config in a configuration.
+ *
+ * Enforced rules (per admin config):
+ *  1. Slug pairing — `admin.slug` matches exactly one `collection.path`.
+ *  2. Placement — when `layout` is present, every top-level schema field
+ *     name appears exactly once across the union of all `tabSet.tabs[].fields`,
+ *     all `row.fields`, all `group.fields`, `layout.main`, and `layout.sidebar`.
+ *  3. Name resolution — every string referenced in any `fields[]` array or
+ *     layout region resolves to either a top-level schema field name or a
+ *     declared primitive name. The literal `'path'` is explicitly rejected
+ *     with a message pointing the user at `useAsPath`.
+ *  4. No collisions — primitive names (across `tabSets` / `rows` / `groups`)
+ *     are unique within an admin config and don't shadow schema field names.
+ *  5. Nesting — `tabSets` only appear in `layout.main`; rows contain only
+ *     schema field names; groups exclude tabSets and nested groups.
+ *  6. `fields` map sanity — every key in `admin.fields` matches a top-level
+ *     schema field name.
+ *
+ * Throws a plain `Error` (not a `BylineError`) because configuration
+ * validation runs at startup, before the logger and error registry are
+ * necessarily wired up.
+ */
+export declare function validateAdminConfigs(admins: readonly CollectionAdminConfig[] | undefined, collections: readonly CollectionDefinition[]): void;
+//# sourceMappingURL=validate-admin-configs.d.ts.map

package/dist/config/validate-admin-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-admin-configs.d.ts","sourceRoot":"","sources":["../../src/config/validate-admin-configs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAErF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,EACpD,WAAW,EAAE,SAAS,oBAAoB,EAAE,GAC3C,IAAI,CAWN"}

package/dist/config/validate-admin-configs.js

@@ -0,0 +1,250 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Validate every admin config in a configuration.
+ *
+ * Enforced rules (per admin config):
+ *  1. Slug pairing — `admin.slug` matches exactly one `collection.path`.
+ *  2. Placement — when `layout` is present, every top-level schema field
+ *     name appears exactly once across the union of all `tabSet.tabs[].fields`,
+ *     all `row.fields`, all `group.fields`, `layout.main`, and `layout.sidebar`.
+ *  3. Name resolution — every string referenced in any `fields[]` array or
+ *     layout region resolves to either a top-level schema field name or a
+ *     declared primitive name. The literal `'path'` is explicitly rejected
+ *     with a message pointing the user at `useAsPath`.
+ *  4. No collisions — primitive names (across `tabSets` / `rows` / `groups`)
+ *     are unique within an admin config and don't shadow schema field names.
+ *  5. Nesting — `tabSets` only appear in `layout.main`; rows contain only
+ *     schema field names; groups exclude tabSets and nested groups.
+ *  6. `fields` map sanity — every key in `admin.fields` matches a top-level
+ *     schema field name.
+ *
+ * Throws a plain `Error` (not a `BylineError`) because configuration
+ * validation runs at startup, before the logger and error registry are
+ * necessarily wired up.
+ */
+export function validateAdminConfigs(admins, collections) {
+    if (admins == null || admins.length === 0)
+        return;
+    const collectionsByPath = new Map();
+    for (const collection of collections) {
+        collectionsByPath.set(collection.path, collection);
+    }
+    for (const admin of admins) {
+        validateOne(admin, collectionsByPath);
+    }
+}
+function validateOne(admin, collectionsByPath) {
+    // Rule 1 — slug pairing.
+    const collection = collectionsByPath.get(admin.slug);
+    if (collection == null) {
+        throw new Error(`Admin config "${admin.slug}" has no matching collection (no collection with \`path: '${admin.slug}'\` was registered).`);
+    }
+    const slug = admin.slug;
+    const fail = (msg) => {
+        throw new Error(`Collection "${slug}": ${msg}`);
+    };
+    // Top-level schema field names — the population subject to placement
+    // bookkeeping. Fields nested inside group/array/blocks are rendered by
+    // their parent widget and are not addressable from layout.
+    const topLevelFieldNames = new Set();
+    for (const field of collection.fields) {
+        if ('name' in field)
+            topLevelFieldNames.add(field.name);
+    }
+    // Build primitive lookup tables.
+    const tabSets = admin.tabSets ?? [];
+    const rows = admin.rows ?? [];
+    const groups = admin.groups ?? [];
+    const tabSetNames = new Set();
+    const rowNames = new Set();
+    const groupNames = new Set();
+    // Rule 4 (collisions) — primitive names unique among themselves and
+    // distinct from schema field names. Collected as we go so we can also
+    // resolve names later.
+    for (const set of tabSets) {
+        if (tabSetNames.has(set.name)) {
+            fail(`tab set name "${set.name}" is declared more than once.`);
+        }
+        if (topLevelFieldNames.has(set.name)) {
+            fail(`tab set name "${set.name}" collides with a schema field of the same name. Rename the tab set.`);
+        }
+        tabSetNames.add(set.name);
+    }
+    for (const row of rows) {
+        if (rowNames.has(row.name)) {
+            fail(`row name "${row.name}" is declared more than once.`);
+        }
+        if (tabSetNames.has(row.name) || groupNames.has(row.name)) {
+            fail(`row name "${row.name}" collides with another primitive of the same name.`);
+        }
+        if (topLevelFieldNames.has(row.name)) {
+            fail(`row name "${row.name}" collides with a schema field of the same name. Rename the row.`);
+        }
+        rowNames.add(row.name);
+    }
+    for (const group of groups) {
+        if (groupNames.has(group.name)) {
+            fail(`group name "${group.name}" is declared more than once.`);
+        }
+        if (tabSetNames.has(group.name) || rowNames.has(group.name)) {
+            fail(`group name "${group.name}" collides with another primitive of the same name.`);
+        }
+        if (topLevelFieldNames.has(group.name)) {
+            fail(`group name "${group.name}" collides with a schema field of the same name. Rename the group.`);
+        }
+        groupNames.add(group.name);
+    }
+    // Helper: reject `'path'` references with a clear message regardless of
+    // where they appear.
+    const checkNotPath = (name, where) => {
+        if (name === 'path') {
+            fail(`'path' is a system widget rendered automatically based on \`useAsPath\` and cannot be referenced from admin configs (found in ${where}). Remove the entry — the path widget already renders at the top of the sidebar when \`useAsPath\` is set.`);
+        }
+    };
+    const resolve = (name) => {
+        if (topLevelFieldNames.has(name))
+            return 'field';
+        if (tabSetNames.has(name))
+            return 'tabSet';
+        if (rowNames.has(name))
+            return 'row';
+        if (groupNames.has(name))
+            return 'group';
+        return undefined;
+    };
+    // Rule 5 — nesting. Validate each primitive's contents.
+    for (const set of tabSets) {
+        if (set.tabs.length === 0) {
+            fail(`tab set "${set.name}" declares no tabs.`);
+        }
+        const tabNames = new Set();
+        for (const tab of set.tabs) {
+            if (tabNames.has(tab.name)) {
+                fail(`tab set "${set.name}" declares tab "${tab.name}" more than once.`);
+            }
+            tabNames.add(tab.name);
+            for (const name of tab.fields) {
+                checkNotPath(name, `tab set "${set.name}" → tab "${tab.name}" fields`);
+                const kind = resolve(name);
+                if (kind == null) {
+                    fail(`tab set "${set.name}" → tab "${tab.name}" references "${name}", which is neither a top-level schema field nor a declared primitive (tabSet/row/group).`);
+                }
+                if (kind === 'tabSet') {
+                    fail(`tab set "${set.name}" → tab "${tab.name}" cannot contain tab set "${name}". Tab sets are top-level only.`);
+                }
+            }
+        }
+    }
+    for (const row of rows) {
+        if (row.fields.length === 0) {
+            fail(`row "${row.name}" declares no fields.`);
+        }
+        for (const name of row.fields) {
+            checkNotPath(name, `row "${row.name}" fields`);
+            const kind = resolve(name);
+            if (kind == null) {
+                fail(`row "${row.name}" references "${name}", which is neither a top-level schema field nor a declared primitive.`);
+            }
+            if (kind !== 'field') {
+                fail(`row "${row.name}" can only contain schema field names; "${name}" is a ${kind}.`);
+            }
+        }
+    }
+    for (const group of groups) {
+        if (group.fields.length === 0) {
+            fail(`group "${group.name}" declares no fields.`);
+        }
+        for (const name of group.fields) {
+            checkNotPath(name, `group "${group.name}" fields`);
+            const kind = resolve(name);
+            if (kind == null) {
+                fail(`group "${group.name}" references "${name}", which is neither a top-level schema field nor a declared primitive.`);
+            }
+            if (kind === 'tabSet') {
+                fail(`group "${group.name}" cannot contain tab set "${name}". Tab sets are top-level only.`);
+            }
+            if (kind === 'group') {
+                fail(`group "${group.name}" cannot contain another group ("${name}"). Groups do not nest.`);
+            }
+        }
+    }
+    // Rule 6 — `fields` map keys must match top-level schema field names.
+    if (admin.fields != null) {
+        for (const key of Object.keys(admin.fields)) {
+            if (!topLevelFieldNames.has(key)) {
+                fail(`\`fields["${key}"]\` references a name that is not a top-level schema field. Per-field overrides apply only to top-level schema fields.`);
+            }
+        }
+    }
+    // Rule 2 + 3 — layout: name resolution + bookkeeping (every schema field
+    // placed exactly once). Skipped when no `layout` is declared (the
+    // renderer's default-layout synthesis covers the trivial case).
+    if (admin.layout == null)
+        return;
+    // Validate that layout regions reference resolvable names with valid
+    // kinds. Then walk into tab sets via their declared tabs to enumerate
+    // every schema field actually placed somewhere.
+    const placedFields = new Set();
+    const recordFieldPlacement = (name, where) => {
+        if (placedFields.has(name)) {
+            fail(`schema field "${name}" is placed more than once (most recently in ${where}).`);
+        }
+        placedFields.add(name);
+    };
+    // Walk a `fields[]` list (from a tab, group, or layout region) and record
+    // every schema field encountered. Recurses through groups and rows.
+    const walkContents = (names, where, allow) => {
+        for (const name of names) {
+            checkNotPath(name, where);
+            const kind = resolve(name);
+            if (kind == null) {
+                fail(`${where} references "${name}", which is neither a top-level schema field nor a declared primitive.`);
+            }
+            if (kind === 'tabSet' && !allow.tabSet) {
+                fail(`${where} cannot contain tab set "${name}". Tab sets are only allowed in \`layout.main\`.`);
+            }
+            if (kind === 'field') {
+                recordFieldPlacement(name, where);
+            }
+            else if (kind === 'tabSet') {
+                const set = tabSets.find((s) => s.name === name);
+                if (set == null)
+                    return;
+                for (const tab of set.tabs) {
+                    walkContents(tab.fields, `tab set "${set.name}" → tab "${tab.name}"`, {
+                        tabSet: false,
+                    });
+                }
+            }
+            else if (kind === 'row') {
+                const row = rows.find((r) => r.name === name);
+                if (row == null)
+                    return;
+                walkContents(row.fields, `row "${row.name}"`, { tabSet: false });
+            }
+            else if (kind === 'group') {
+                const group = groups.find((g) => g.name === name);
+                if (group == null)
+                    return;
+                walkContents(group.fields, `group "${group.name}"`, { tabSet: false });
+            }
+        }
+    };
+    walkContents(admin.layout.main, '`layout.main`', { tabSet: true });
+    if (admin.layout.sidebar != null) {
+        walkContents(admin.layout.sidebar, '`layout.sidebar`', { tabSet: false });
+    }
+    // Bookkeeping — every top-level schema field must be placed somewhere.
+    for (const fieldName of topLevelFieldNames) {
+        if (!placedFields.has(fieldName)) {
+            fail(`schema field "${fieldName}" is not placed in any tab, row, group, or layout region. Add it to one of them, or remove the field from the schema.`);
+        }
+    }
+}
+//# sourceMappingURL=validate-admin-configs.js.map

package/dist/config/validate-admin-configs.js.map

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

package/dist/config/validate-admin-configs.test.node.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export {};
+//# sourceMappingURL=validate-admin-configs.test.node.d.ts.map

package/dist/config/validate-admin-configs.test.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-admin-configs.test.node.d.ts","sourceRoot":"","sources":["../../src/config/validate-admin-configs.test.node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/config/validate-admin-configs.test.node.js

@@ -0,0 +1,224 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { describe, expect, it } from 'vitest';
+import { validateAdminConfigs } from './validate-admin-configs.js';
+const collection = {
+    path: 'news',
+    labels: { singular: 'News', plural: 'News' },
+    useAsPath: 'title',
+    fields: [
+        { name: 'title', label: 'Title', type: 'text' },
+        { name: 'summary', label: 'Summary', type: 'textArea' },
+        { name: 'content', label: 'Content', type: 'richText' },
+        { name: 'text1', label: 'Text 1', type: 'text' },
+        { name: 'text2', label: 'Text 2', type: 'text' },
+    ],
+};
+const baseAdmin = {
+    slug: 'news',
+    tabSets: [
+        {
+            name: 'main',
+            tabs: [
+                { name: 'details', label: 'Details', fields: ['title', 'summary', 'titles'] },
+                { name: 'content', label: 'Content', fields: ['content'] },
+            ],
+        },
+    ],
+    rows: [{ name: 'titles', fields: ['text1', 'text2'] }],
+    layout: { main: ['main'] },
+};
+describe('validateAdminConfigs', () => {
+    it('accepts a valid admin config (baseline)', () => {
+        expect(() => validateAdminConfigs([baseAdmin], [collection])).not.toThrow();
+    });
+    it('is a no-op when admins is undefined', () => {
+        expect(() => validateAdminConfigs(undefined, [collection])).not.toThrow();
+    });
+    // Rule 1 — slug pairing.
+    it('rejects an admin config whose slug has no matching collection', () => {
+        const orphan = { slug: 'nonexistent', layout: { main: [] } };
+        expect(() => validateAdminConfigs([orphan], [collection])).toThrow(/no matching collection/);
+    });
+    // Rule 2 — placement bookkeeping.
+    it('rejects an admin config that leaves a schema field unplaced', () => {
+        const admin = {
+            ...baseAdmin,
+            tabSets: [
+                {
+                    name: 'main',
+                    tabs: [
+                        // omit 'summary' from the details tab
+                        { name: 'details', label: 'Details', fields: ['title', 'titles'] },
+                        { name: 'content', label: 'Content', fields: ['content'] },
+                    ],
+                },
+            ],
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/"summary" is not placed/);
+    });
+    it('rejects placing the same schema field twice', () => {
+        const admin = {
+            ...baseAdmin,
+            layout: { main: ['main'], sidebar: ['title'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/placed more than once/);
+    });
+    // Rule 3 — name resolution + path rejection.
+    it('rejects unknown names in a layout region', () => {
+        const admin = {
+            ...baseAdmin,
+            layout: { main: ['main', 'doesNotExist'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/"doesNotExist", which is neither a top-level schema field nor a declared primitive/);
+    });
+    it("rejects 'path' in layout.sidebar with a useAsPath hint", () => {
+        const admin = {
+            ...baseAdmin,
+            layout: { main: ['main'], sidebar: ['path'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/useAsPath/);
+    });
+    it("rejects 'path' inside a tab", () => {
+        const admin = {
+            ...baseAdmin,
+            tabSets: [
+                {
+                    name: 'main',
+                    tabs: [
+                        {
+                            name: 'details',
+                            label: 'Details',
+                            fields: ['title', 'summary', 'titles', 'path'],
+                        },
+                        { name: 'content', label: 'Content', fields: ['content'] },
+                    ],
+                },
+            ],
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/useAsPath/);
+    });
+    // Rule 4 — collisions.
+    it('rejects a primitive name that collides with a schema field', () => {
+        const admin = {
+            ...baseAdmin,
+            rows: [
+                { name: 'titles', fields: ['text1', 'text2'] },
+                // 'title' is also a schema field — collision
+                { name: 'title', fields: ['summary'] },
+            ],
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/collides with a schema field/);
+    });
+    it('rejects two primitives sharing the same name', () => {
+        const admin = {
+            ...baseAdmin,
+            rows: [{ name: 'titles', fields: ['text1', 'text2'] }],
+            groups: [{ name: 'titles', label: 'X', fields: ['summary'] }],
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/collides with another primitive/);
+    });
+    // Rule 5 — nesting.
+    it('rejects a row whose fields include a non-field primitive', () => {
+        const admin = {
+            slug: 'news',
+            tabSets: [
+                {
+                    name: 'main',
+                    tabs: [
+                        { name: 'details', label: 'Details', fields: ['title', 'summary', 'badRow'] },
+                        { name: 'content', label: 'Content', fields: ['content'] },
+                    ],
+                },
+            ],
+            groups: [{ name: 'someGroup', fields: ['text1'] }],
+            rows: [
+                // Row contains a group name — illegal.
+                { name: 'badRow', fields: ['text2', 'someGroup'] },
+            ],
+            layout: { main: ['main'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/can only contain schema field names/);
+    });
+    it('rejects a tab set referenced from inside a tab', () => {
+        const admin = {
+            slug: 'news',
+            tabSets: [
+                {
+                    name: 'inner',
+                    tabs: [{ name: 'a', label: 'A', fields: ['text1', 'text2'] }],
+                },
+                {
+                    name: 'outer',
+                    tabs: [
+                        // Embedding the inner tab set inside a tab is illegal.
+                        { name: 'wrapper', label: 'Wrapper', fields: ['title', 'summary', 'inner'] },
+                        { name: 'content', label: 'Content', fields: ['content'] },
+                    ],
+                },
+            ],
+            layout: { main: ['outer'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/Tab sets are top-level only/);
+    });
+    it('rejects a tab set referenced from layout.sidebar', () => {
+        const admin = {
+            ...baseAdmin,
+            layout: { main: [], sidebar: ['main'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/Tab sets are only allowed in `layout.main`/);
+    });
+    it('rejects a group nested inside another group', () => {
+        const admin = {
+            slug: 'news',
+            tabSets: [
+                {
+                    name: 'main',
+                    tabs: [
+                        { name: 'details', label: 'Details', fields: ['title', 'summary', 'outer'] },
+                        { name: 'content', label: 'Content', fields: ['content'] },
+                    ],
+                },
+            ],
+            groups: [
+                { name: 'outer', label: 'Outer', fields: ['text1', 'inner'] },
+                { name: 'inner', label: 'Inner', fields: ['text2'] },
+            ],
+            layout: { main: ['main'] },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/Groups do not nest/);
+    });
+    // Rule 6 — `fields` map sanity.
+    it('rejects a `fields` map key that is not a schema field name', () => {
+        const admin = {
+            ...baseAdmin,
+            fields: { nonexistent: {} },
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/not a top-level schema field/);
+    });
+    // Layout omitted — bookkeeping skipped, primitive declarations still checked.
+    it('skips placement bookkeeping when layout is omitted', () => {
+        const admin = {
+            slug: 'news',
+            // No layout — renderer will synthesise a default.
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).not.toThrow();
+    });
+    it('still rejects a primitive collision when layout is omitted', () => {
+        const admin = {
+            slug: 'news',
+            rows: [
+                { name: 'titles', fields: ['text1', 'text2'] },
+                // 'title' is also a schema field — collision still caught.
+                { name: 'title', fields: ['summary'] },
+            ],
+        };
+        expect(() => validateAdminConfigs([admin], [collection])).toThrow(/collides with a schema field/);
+    });
+});
+//# sourceMappingURL=validate-admin-configs.test.node.js.map

package/dist/config/validate-admin-configs.test.node.js.map

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

package/dist/config/validate-collections.d.ts

@@ -0,0 +1,33 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { CollectionDefinition } from '../@types/index.js';
+/**
+ * Field names that cannot be declared in a collection schema because they
+ * collide with system-managed attributes on `documentVersions`. Exported
+ * so storage-layer reconstruction can skip orphan rows that may exist in
+ * store tables from installations whose schemas declared these names as
+ * user fields before they were promoted to system attributes.
+ */
+export declare const RESERVED_FIELD_NAMES: ReadonlySet<string>;
+/**
+ * Validate every collection in a configuration.
+ *
+ * Enforced rules:
+ *  - No field (at any nesting depth) may be named `path`. The `path`
+ *    column on `documentVersions` is system-managed; collections opt
+ *    into derived paths via `useAsPath`.
+ *  - When `useAsPath` is set, the referenced field must exist at the
+ *    top level of the collection and be of a type the slugifier can
+ *    sensibly consume (text-like or date-like).
+ *
+ * Throws a plain `Error` (not a `BylineError`) because configuration
+ * validation runs at startup, before the logger and error registry are
+ * necessarily wired up.
+ */
+export declare function validateCollections(collections: readonly CollectionDefinition[]): void;
+//# sourceMappingURL=validate-collections.d.ts.map

package/dist/config/validate-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-collections.d.ts","sourceRoot":"","sources":["../../src/config/validate-collections.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAoB,MAAM,oBAAoB,CAAA;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAqB,CAAA;AAwB1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CA0BtF"}