@byline/core 0.9.3

package/dist/services/richtext-populate.test.node.js

@@ -0,0 +1,197 @@
+/**
+ * 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 { collectRichTextLeaves, resolvePopulateOnRead, validateRichTextFieldFlags, } from './richtext-populate.js';
+// ---------------------------------------------------------------------------
+// Fixture — a synthetic collection that exercises every nesting type the
+// walker needs to handle: top-level, group, array, blocks (with two block
+// types), and richText nested inside a block's array sub-field.
+// ---------------------------------------------------------------------------
+const richTextValue = (label) => ({ root: { type: 'root', children: [], _label: label } });
+const fields = [
+    { name: 'title', type: 'text', label: 'Title' },
+    { name: 'body', type: 'richText', label: 'Body' },
+    {
+        name: 'meta',
+        type: 'group',
+        label: 'Meta',
+        fields: [{ name: 'summary', type: 'richText', label: 'Summary' }],
+    },
+    {
+        name: 'faq',
+        type: 'array',
+        label: 'FAQ',
+        fields: [{ name: 'answer', type: 'richText', label: 'Answer' }],
+    },
+    {
+        name: 'content',
+        type: 'blocks',
+        label: 'Content',
+        blocks: [
+            {
+                blockType: 'photoBlock',
+                fields: [{ name: 'caption', type: 'richText', label: 'Caption' }],
+            },
+            {
+                blockType: 'richTextBlock',
+                fields: [{ name: 'richText', type: 'richText', label: 'RichText' }],
+            },
+        ],
+    },
+];
+const data = {
+    title: 'Post',
+    body: richTextValue('body'),
+    meta: { summary: richTextValue('summary') },
+    faq: [{ answer: richTextValue('answer-0') }, { answer: richTextValue('answer-1') }],
+    content: [
+        { _id: 'a', _type: 'photoBlock', caption: richTextValue('caption') },
+        { _id: 'b', _type: 'richTextBlock', richText: richTextValue('rt') },
+    ],
+};
+// ---------------------------------------------------------------------------
+// collectRichTextLeaves
+// ---------------------------------------------------------------------------
+describe('collectRichTextLeaves', () => {
+    it('yields top-level richText fields', () => {
+        const out = Array.from(collectRichTextLeaves(fields, data));
+        const paths = out.map((l) => l.fieldPath);
+        expect(paths).toContain('body');
+    });
+    it('recurses through group fields', () => {
+        const out = Array.from(collectRichTextLeaves(fields, data));
+        const paths = out.map((l) => l.fieldPath);
+        expect(paths).toContain('meta.summary');
+    });
+    it('recurses through array fields with index in path', () => {
+        const out = Array.from(collectRichTextLeaves(fields, data));
+        const paths = out.map((l) => l.fieldPath);
+        expect(paths).toContain('faq.0.answer');
+        expect(paths).toContain('faq.1.answer');
+    });
+    it('dispatches blocks on _type and recurses into matching block schema', () => {
+        const out = Array.from(collectRichTextLeaves(fields, data));
+        const paths = out.map((l) => l.fieldPath);
+        expect(paths).toContain('content.0.caption');
+        expect(paths).toContain('content.1.richText');
+    });
+    it('yields the raw richText value for each leaf', () => {
+        const out = Array.from(collectRichTextLeaves(fields, data));
+        const bodyLeaf = out.find((l) => l.fieldPath === 'body');
+        expect(bodyLeaf?.value).toEqual(richTextValue('body'));
+    });
+    it('skips missing data without throwing', () => {
+        const out = Array.from(collectRichTextLeaves(fields, { title: 'only-title' }));
+        // No richText values present in data — walker yields nothing.
+        expect(out).toEqual([]);
+    });
+    it('skips block items with unknown _type', () => {
+        const dataWithUnknownBlock = {
+            content: [
+                { _id: 'x', _type: 'unknownBlock', caption: richTextValue('skipped') },
+                { _id: 'b', _type: 'richTextBlock', richText: richTextValue('kept') },
+            ],
+        };
+        const out = Array.from(collectRichTextLeaves(fields, dataWithUnknownBlock));
+        const paths = out.map((l) => l.fieldPath);
+        expect(paths).toEqual(['content.1.richText']);
+    });
+    it('skips block items with no _type', () => {
+        const dataWithoutType = {
+            content: [{ _id: 'a', caption: richTextValue('skipped') }],
+        };
+        const out = Array.from(collectRichTextLeaves(fields, dataWithoutType));
+        expect(out).toEqual([]);
+    });
+});
+// ---------------------------------------------------------------------------
+// resolvePopulateOnRead — default-derivation table
+// ---------------------------------------------------------------------------
+describe('resolvePopulateOnRead', () => {
+    const baseField = { name: 'body', type: 'richText', label: 'Body' };
+    it('defaults populate to false when embed defaults to true', () => {
+        expect(resolvePopulateOnRead(baseField)).toBe(false);
+    });
+    it('derives populate from explicit embedRelationsOnSave: false', () => {
+        expect(resolvePopulateOnRead({ ...baseField, embedRelationsOnSave: false })).toBe(true);
+    });
+    it('honours explicit populateRelationsOnRead: true (belt-and-braces)', () => {
+        expect(resolvePopulateOnRead({
+            ...baseField,
+            embedRelationsOnSave: true,
+            populateRelationsOnRead: true,
+        })).toBe(true);
+    });
+    it('honours explicit populateRelationsOnRead: false even when embed is also false', () => {
+        // The invalid combination — caller has to validate separately.
+        expect(resolvePopulateOnRead({
+            ...baseField,
+            embedRelationsOnSave: false,
+            populateRelationsOnRead: false,
+        })).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
+// validateRichTextFieldFlags
+// ---------------------------------------------------------------------------
+function makeCollection(richTextField) {
+    return {
+        path: 'pages',
+        labels: { singular: 'Page', plural: 'Pages' },
+        fields: [
+            { name: 'title', type: 'text', label: 'Title' },
+            { name: 'body', type: 'richText', label: 'Body', ...richTextField },
+        ],
+    };
+}
+describe('validateRichTextFieldFlags', () => {
+    it('passes when default flags are used and adapter is registered', () => {
+        expect(() => validateRichTextFieldFlags([makeCollection({})], true)).not.toThrow();
+    });
+    it('passes when default flags are used and no adapter is registered (snapshot mode)', () => {
+        expect(() => validateRichTextFieldFlags([makeCollection({})], false)).not.toThrow();
+    });
+    it('throws when both flags are explicitly false', () => {
+        expect(() => validateRichTextFieldFlags([makeCollection({ embedRelationsOnSave: false, populateRelationsOnRead: false })], true)).toThrow(/both .* set to false/i);
+    });
+    it('throws when embedRelationsOnSave: false but no adapter is registered', () => {
+        expect(() => validateRichTextFieldFlags([makeCollection({ embedRelationsOnSave: false })], false)).toThrow(/no.*server adapter/i);
+    });
+    it('throws when belt-and-braces is asked for but no adapter is registered', () => {
+        expect(() => validateRichTextFieldFlags([makeCollection({ embedRelationsOnSave: true, populateRelationsOnRead: true })], false)).toThrow(/no.*server adapter/i);
+    });
+    it('reports nested richText paths inside blocks with the block type tag', () => {
+        const collection = {
+            path: 'pages',
+            labels: { singular: 'Page', plural: 'Pages' },
+            fields: [
+                {
+                    name: 'content',
+                    type: 'blocks',
+                    label: 'Content',
+                    blocks: [
+                        {
+                            blockType: 'photoBlock',
+                            fields: [
+                                {
+                                    name: 'caption',
+                                    type: 'richText',
+                                    label: 'Caption',
+                                    embedRelationsOnSave: false,
+                                    populateRelationsOnRead: false,
+                                },
+                            ],
+                        },
+                    ],
+                },
+            ],
+        };
+        expect(() => validateRichTextFieldFlags([collection], true)).toThrow(/content\.<photoBlock>\.caption/);
+    });
+});
+//# sourceMappingURL=richtext-populate.test.node.js.map

package/dist/services/richtext-populate.test.node.js.map

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

package/dist/storage/collection-fingerprint.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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';
+/**
+ * Computes a deterministic SHA-256 fingerprint of the data-shape-relevant
+ * portion of a `CollectionDefinition`. Two definitions that differ only in
+ * cosmetic fields (labels, hooks, admin/search/showStats metadata, helpText,
+ * placeholders) produce the same fingerprint. Adding or removing a field,
+ * changing a field type, renaming a block variant, altering workflow statuses,
+ * or changing a relation target all produce a different fingerprint.
+ *
+ * Async because `crypto.subtle.digest` is async on every platform. Returned
+ * as a lowercase hex string (64 characters).
+ */
+export declare function fingerprintCollection(def: CollectionDefinition): Promise<string>;
+//# sourceMappingURL=collection-fingerprint.d.ts.map

package/dist/storage/collection-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-fingerprint.d.ts","sourceRoot":"","sources":["../../src/storage/collection-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAEV,oBAAoB,EAIrB,MAAM,oBAAoB,CAAA;AA6K3B;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtF"}

package/dist/storage/collection-fingerprint.js

@@ -0,0 +1,172 @@
+/**
+ * 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
+ */
+function canonicalField(field) {
+    const base = {
+        name: field.name,
+        type: field.type,
+        optional: field.optional === true,
+        localized: field.localized === true,
+    };
+    switch (field.type) {
+        case 'group':
+        case 'array':
+            base.fields = field.fields.map(canonicalField);
+            if (field.type === 'array' && field.validation) {
+                base.validation = sortedShallow(field.validation);
+            }
+            return base;
+        case 'blocks':
+            base.blocks = field.blocks.map((b) => ({
+                blockType: b.blockType,
+                fields: b.fields.map(canonicalField),
+            }));
+            return base;
+        case 'select':
+            base.options = field.options.map((o) => ({ value: o.value }));
+            return base;
+        case 'relation':
+            base.targetCollection = field.targetCollection;
+            if (field.displayField !== undefined)
+                base.displayField = field.displayField;
+            return base;
+        case 'datetime':
+            if (field.mode !== undefined)
+                base.mode = field.mode;
+            return base;
+        case 'image':
+        case 'file':
+            // Per-field upload config affects the read-back contract (mime
+            // policy, variant set, storage backend), so it folds into the
+            // schema fingerprint. `hooks` is excluded — functions don't
+            // canonicalise, and `stableStringify` would drop them anyway.
+            // `storage` is also excluded: it's a runtime provider object,
+            // not a schema-shape declaration.
+            if (field.upload)
+                base.upload = canonicalUpload(field.upload);
+            return base;
+        case 'text':
+        case 'textArea':
+        case 'richText':
+        case 'float':
+        case 'integer':
+            if (field.validation) {
+                base.validation = sortedShallow(field.validation);
+            }
+            return base;
+        default:
+            return base;
+    }
+}
+function canonicalWorkflow(w) {
+    return {
+        // Status names only — labels and verbs are presentation.
+        statuses: w.statuses.map((s) => ({ name: s.name })),
+        ...(w.defaultStatus !== undefined ? { defaultStatus: w.defaultStatus } : {}),
+    };
+}
+function canonicalUpload(u) {
+    const out = {};
+    if (u.mimeTypes !== undefined)
+        out.mimeTypes = [...u.mimeTypes].sort();
+    if (u.maxFileSize !== undefined)
+        out.maxFileSize = u.maxFileSize;
+    if (u.sizes !== undefined) {
+        out.sizes = u.sizes
+            .map((s) => ({
+            name: s.name,
+            ...(s.width !== undefined ? { width: s.width } : {}),
+            ...(s.height !== undefined ? { height: s.height } : {}),
+            ...(s.fit !== undefined ? { fit: s.fit } : {}),
+            ...(s.format !== undefined ? { format: s.format } : {}),
+            ...(s.quality !== undefined ? { quality: s.quality } : {}),
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    return out;
+}
+function sortedShallow(obj) {
+    const out = {};
+    for (const key of Object.keys(obj).sort()) {
+        const v = obj[key];
+        if (v === undefined || typeof v === 'function')
+            continue;
+        out[key] = v;
+    }
+    return out;
+}
+function canonicalCollection(def) {
+    const out = {
+        path: def.path,
+        fields: def.fields.map(canonicalField),
+    };
+    if (def.workflow)
+        out.workflow = canonicalWorkflow(def.workflow);
+    if (def.useAsPath !== undefined)
+        out.useAsPath = def.useAsPath;
+    if (def.useAsTitle !== undefined)
+        out.useAsTitle = def.useAsTitle;
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Deterministic serialisation
+// ---------------------------------------------------------------------------
+// Recursive key-sorted JSON stringify. Skips `undefined` and functions so the
+// presence of hooks / handler callbacks cannot change the output. Arrays
+// preserve order (order is meaningful for fields, blocks, statuses).
+function stableStringify(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? String(value) : 'null';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'undefined' || typeof value === 'function')
+        return 'null';
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(',')}]`;
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const keys = Object.keys(obj)
+            .filter((k) => obj[k] !== undefined && typeof obj[k] !== 'function')
+            .sort();
+        const body = keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(',');
+        return `{${body}}`;
+    }
+    return 'null';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Computes a deterministic SHA-256 fingerprint of the data-shape-relevant
+ * portion of a `CollectionDefinition`. Two definitions that differ only in
+ * cosmetic fields (labels, hooks, admin/search/showStats metadata, helpText,
+ * placeholders) produce the same fingerprint. Adding or removing a field,
+ * changing a field type, renaming a block variant, altering workflow statuses,
+ * or changing a relation target all produce a different fingerprint.
+ *
+ * Async because `crypto.subtle.digest` is async on every platform. Returned
+ * as a lowercase hex string (64 characters).
+ */
+export async function fingerprintCollection(def) {
+    const canonical = canonicalCollection(def);
+    const serialised = stableStringify(canonical);
+    const buffer = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(serialised));
+    return bytesToHex(new Uint8Array(buffer));
+}
+function bytesToHex(bytes) {
+    let out = '';
+    for (const byte of bytes) {
+        out += byte.toString(16).padStart(2, '0');
+    }
+    return out;
+}
+//# sourceMappingURL=collection-fingerprint.js.map

package/dist/storage/collection-fingerprint.js.map

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

package/dist/storage/collection-fingerprint.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=collection-fingerprint.test.node.d.ts.map

package/dist/storage/collection-fingerprint.test.node.d.ts.map

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