@byline/core 0.9.3

package/dist/services/field-upload.test.node.js

@@ -0,0 +1,337 @@
+/**
+ * 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 { createSuperAdminContext } from '@byline/auth';
+import { describe, expect, it, vi } from 'vitest';
+import { BylineError, ErrorCodes } from '../lib/errors.js';
+import { uploadField } from './field-upload.js';
+const uploadCollection = {
+    path: 'media',
+    labels: { singular: 'Media', plural: 'Media' },
+    fields: [
+        {
+            name: 'image',
+            label: 'Image',
+            type: 'image',
+            upload: {
+                mimeTypes: ['image/png'],
+                maxFileSize: 1024 * 1024,
+                sizes: [{ name: 'thumbnail', width: 400, height: 400, fit: 'cover' }],
+            },
+        },
+        { name: 'title', label: 'Title', type: 'text' },
+        { name: 'caption', label: 'Caption', type: 'textArea', optional: true },
+    ],
+};
+function withFieldUpload(collection, fieldName, patch) {
+    return {
+        ...collection,
+        fields: collection.fields.map((f) => {
+            if (f.name !== fieldName)
+                return f;
+            const next = structuredClone(f);
+            patch(next);
+            return next;
+        }),
+    };
+}
+function createMockDb() {
+    const createDocumentVersion = vi.fn().mockResolvedValue({
+        document: { id: 'ver-1', document_id: 'doc-1' },
+        fieldCount: 2,
+    });
+    const db = {
+        commands: {
+            collections: {
+                create: vi.fn(),
+                update: vi.fn(),
+                delete: vi.fn(),
+            },
+            documents: {
+                createDocumentVersion,
+                setDocumentStatus: vi.fn(),
+                archivePublishedVersions: vi.fn(),
+                softDeleteDocument: vi.fn(),
+            },
+        },
+        queries: {
+            collections: {
+                getAllCollections: vi.fn(),
+                getCollectionByPath: vi.fn(),
+                getCollectionById: vi.fn(),
+            },
+            documents: {
+                getDocumentById: vi.fn(),
+                getCurrentVersionMetadata: vi.fn(),
+                getDocumentByPath: vi.fn(),
+                getDocumentByVersion: vi.fn(),
+                getDocumentsByVersionIds: vi.fn(),
+                getDocumentsByDocumentIds: vi.fn(),
+                getDocumentHistory: vi.fn(),
+                getPublishedVersion: vi.fn(),
+                getPublishedDocumentIds: vi.fn(),
+                getDocumentCountsByStatus: vi.fn(),
+                findDocuments: vi.fn(),
+            },
+        },
+    };
+    return { db, createDocumentVersion };
+}
+function createMockStorage() {
+    const upload = vi.fn().mockResolvedValue({
+        storageProvider: 'local',
+        storagePath: 'media/original.png',
+        storageUrl: '/uploads/media/original.png',
+    });
+    const del = vi.fn().mockResolvedValue(undefined);
+    const storage = {
+        providerName: 'local',
+        upload,
+        delete: del,
+        getUrl: vi.fn((storagePath) => `/uploads/${storagePath}`),
+    };
+    return { storage, upload, del };
+}
+const noopLogger = {
+    log: vi.fn(),
+    fatal: vi.fn(),
+    error: vi.fn(),
+    warn: vi.fn(),
+    info: vi.fn(),
+    debug: vi.fn(),
+    trace: vi.fn(),
+    silent: vi.fn(),
+};
+function createImageProcessor(overrides) {
+    return {
+        extractMeta: vi.fn().mockResolvedValue({ width: 1200, height: 800, format: 'png' }),
+        isBypassMimeType: vi.fn().mockReturnValue(false),
+        generateVariants: vi.fn().mockResolvedValue([
+            {
+                name: 'thumbnail',
+                storagePath: 'media/thumbnail.webp',
+                width: 400,
+                height: 400,
+                format: 'webp',
+            },
+        ]),
+        ...overrides,
+    };
+}
+function buildCtx(overrides) {
+    const { db, createDocumentVersion } = createMockDb();
+    const { storage, upload, del } = createMockStorage();
+    const imageProcessor = createImageProcessor();
+    const ctx = {
+        db,
+        definition: uploadCollection,
+        collectionId: 'col-1',
+        collectionVersion: 1,
+        collectionPath: uploadCollection.path,
+        fieldName: 'image',
+        storage,
+        logger: noopLogger,
+        imageProcessor,
+        defaultLocale: 'en',
+        requestContext: createSuperAdminContext({ id: 'test-super-admin' }),
+        ...overrides,
+    };
+    return { ctx, createDocumentVersion, upload, del, imageProcessor };
+}
+describe('uploadField service', () => {
+    it('uploads a file without creating a document when requested', async () => {
+        const { ctx, createDocumentVersion, upload } = buildCtx();
+        const result = await uploadField(ctx, {
+            buffer: Buffer.from('png'),
+            originalFilename: 'hero.png',
+            mimeType: 'image/png',
+            fileSize: 3,
+            shouldCreateDocument: false,
+        });
+        expect(upload).toHaveBeenCalledOnce();
+        expect(createDocumentVersion).not.toHaveBeenCalled();
+        expect(result.documentId).toBeUndefined();
+        expect(result.storedFile.filename).toBe('hero.png');
+        // Variants are now persisted on the file value itself — single source of truth.
+        expect(result.storedFile.variants).toEqual([
+            {
+                name: 'thumbnail',
+                storagePath: 'media/thumbnail.webp',
+                storageUrl: '/uploads/media/thumbnail.webp',
+                width: 400,
+                height: 400,
+                format: 'webp',
+            },
+        ]);
+    });
+    it('applies beforeStore filename override and threads it into storage.upload + variants', async () => {
+        const beforeStore = vi.fn().mockResolvedValue('overridden.png');
+        const afterStore = vi.fn().mockResolvedValue(undefined);
+        const definition = withFieldUpload(uploadCollection, 'image', (f) => {
+            f.upload.hooks = { beforeStore, afterStore };
+        });
+        const { ctx, createDocumentVersion, upload } = buildCtx({ definition });
+        const result = await uploadField(ctx, {
+            buffer: Buffer.from('png'),
+            originalFilename: 'Hero Banner.PNG',
+            mimeType: 'image/png',
+            fileSize: 3,
+            fields: { caption: 'Front page image' },
+            shouldCreateDocument: true,
+            locale: 'en',
+        });
+        // beforeStore receives the rich context.
+        expect(beforeStore).toHaveBeenCalledWith(expect.objectContaining({
+            fieldName: 'image',
+            filename: 'hero-banner.png',
+            collectionPath: 'media',
+            fields: { caption: 'Front page image' },
+        }));
+        // The override is threaded into storage.upload — fixes the legacy bug
+        // where the rewritten filename only landed in StoredFileValue metadata.
+        expect(upload).toHaveBeenCalledWith(expect.any(Buffer), expect.objectContaining({ filename: 'overridden.png' }));
+        // afterStore receives the persisted StoredFileValue with variants.
+        expect(afterStore).toHaveBeenCalledWith(expect.objectContaining({
+            fieldName: 'image',
+            storedFile: expect.objectContaining({
+                filename: 'overridden.png',
+                variants: expect.any(Array),
+            }),
+        }));
+        expect(createDocumentVersion).toHaveBeenCalledOnce();
+        expect(createDocumentVersion.mock.calls[0]?.[0].documentData).toEqual(expect.objectContaining({
+            title: 'overridden.png',
+            caption: 'Front page image',
+            image: expect.objectContaining({ filename: 'overridden.png' }),
+        }));
+        expect(result.documentId).toBe('doc-1');
+    });
+    it('folds a chain of beforeStore hooks (each sees the previous rename)', async () => {
+        const definition = withFieldUpload(uploadCollection, 'image', (f) => {
+            f.upload.hooks = {
+                beforeStore: [
+                    ({ filename }) => `tenant-${filename}`,
+                    ({ filename, fields }) => fields.publicationId ? `${fields.publicationId}-${filename}` : undefined,
+                ],
+            };
+        });
+        const { ctx, upload } = buildCtx({ definition });
+        await uploadField(ctx, {
+            buffer: Buffer.from('png'),
+            originalFilename: 'hero.png',
+            mimeType: 'image/png',
+            fileSize: 3,
+            fields: { publicationId: 'PUB-42' },
+            shouldCreateDocument: false,
+        });
+        expect(upload).toHaveBeenCalledWith(expect.any(Buffer), expect.objectContaining({ filename: 'PUB-42-tenant-hero.png' }));
+    });
+    it('beforeStore { error } short-circuits — no storage write, no variants, no afterStore', async () => {
+        const afterStore = vi.fn();
+        const definition = withFieldUpload(uploadCollection, 'image', (f) => {
+            f.upload.hooks = {
+                beforeStore: () => ({ error: 'duplicate publication ID' }),
+                afterStore,
+            };
+        });
+        const { ctx, upload, imageProcessor } = buildCtx({ definition });
+        await expect(uploadField(ctx, {
+            buffer: Buffer.from('png'),
+            originalFilename: 'hero.png',
+            mimeType: 'image/png',
+            fileSize: 3,
+            shouldCreateDocument: false,
+        })).rejects.toMatchObject({ code: ErrorCodes.VALIDATION });
+        expect(upload).not.toHaveBeenCalled();
+        expect(imageProcessor.generateVariants).not.toHaveBeenCalled();
+        expect(afterStore).not.toHaveBeenCalled();
+    });
+    it('rejects MIME types not allowed by the field upload config — before any hook fires', async () => {
+        const beforeStore = vi.fn();
+        const definition = withFieldUpload(uploadCollection, 'image', (f) => {
+            f.upload.hooks = { beforeStore };
+        });
+        const { ctx } = buildCtx({ definition });
+        await expect(uploadField(ctx, {
+            buffer: Buffer.from('gif'),
+            originalFilename: 'hero.gif',
+            mimeType: 'image/gif',
+            fileSize: 3,
+        })).rejects.toMatchObject({ code: ErrorCodes.VALIDATION });
+        // Validation gate runs ahead of user code.
+        expect(beforeStore).not.toHaveBeenCalled();
+    });
+    it('rejects when the named field is not upload-capable', async () => {
+        const { ctx } = buildCtx({ fieldName: 'caption' });
+        await expect(uploadField(ctx, {
+            buffer: Buffer.from('png'),
+            originalFilename: 'hero.png',
+            mimeType: 'image/png',
+            fileSize: 3,
+        })).rejects.toMatchObject({ code: ErrorCodes.VALIDATION });
+    });
+    it('afterStore failures are logged but do not roll back the storage write', async () => {
+        const afterStore = vi.fn().mockRejectedValue(new Error('boom'));
+        const definition = withFieldUpload(uploadCollection, 'image', (f) => {
+            f.upload.hooks = { afterStore };
+        });
+        const { ctx, upload, del } = buildCtx({ definition });
+        const result = await uploadField(ctx, {
+            buffer: Buffer.from('png'),
+            originalFilename: 'hero.png',
+            mimeType: 'image/png',
+            fileSize: 3,
+            shouldCreateDocument: false,
+        });
+        expect(upload).toHaveBeenCalledOnce();
+        expect(afterStore).toHaveBeenCalledOnce();
+        expect(del).not.toHaveBeenCalled();
+        expect(result.storedFile.filename).toBe('hero.png');
+    });
+    it('rolls back stored files when document creation fails', async () => {
+        const { db } = createMockDb();
+        db.commands.documents.createDocumentVersion = vi.fn().mockRejectedValue(new Error('db down'));
+        const { storage, del } = createMockStorage();
+        const ctx = {
+            db,
+            definition: uploadCollection,
+            collectionId: 'col-1',
+            collectionVersion: 1,
+            collectionPath: uploadCollection.path,
+            fieldName: 'image',
+            storage,
+            logger: noopLogger,
+            imageProcessor: createImageProcessor({
+                generateVariants: vi.fn().mockResolvedValue([
+                    { name: 'thumbnail', storagePath: 'media/thumbnail.webp' },
+                    { name: 'card', storagePath: 'media/card.webp' },
+                ]),
+            }),
+            defaultLocale: 'en',
+            requestContext: createSuperAdminContext({ id: 'test-super-admin' }),
+        };
+        let error;
+        try {
+            await uploadField(ctx, {
+                buffer: Buffer.from('png'),
+                originalFilename: 'hero.png',
+                mimeType: 'image/png',
+                fileSize: 3,
+            });
+        }
+        catch (err) {
+            error = err;
+        }
+        expect(error).toBeInstanceOf(BylineError);
+        expect(error.code).toBe(ErrorCodes.DATABASE);
+        expect(del).toHaveBeenCalledTimes(3);
+        expect(del).toHaveBeenNthCalledWith(1, 'media/original.png');
+        expect(del).toHaveBeenNthCalledWith(2, 'media/thumbnail.webp');
+        expect(del).toHaveBeenNthCalledWith(3, 'media/card.webp');
+    });
+});
+//# sourceMappingURL=field-upload.test.node.js.map

package/dist/services/field-upload.test.node.js.map

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

package/dist/services/index.d.ts

@@ -0,0 +1,10 @@
+export { ERR_CONFLICT, ERR_INVALID_TRANSITION, ERR_NOT_FOUND, ERR_PATCH_FAILED, ERR_READ_BUDGET_EXCEEDED, ERR_VALIDATION, } from '../lib/errors.js';
+export { normaliseDateFields } from '../utils/normalise-dates.js';
+export { type CollectionRecord, type EnsureCollectionsInput, ensureCollections, } from './collection-bootstrap.js';
+export * from './document-lifecycle.js';
+export * from './document-read.js';
+export * from './field-upload.js';
+export { type CycleRelationValue, createReadContext, type PopulatedRelationValue, type PopulateFieldOptions, type PopulateFieldSpec, type PopulateMap, type PopulateOptions, type PopulateSpec, populateDocuments, type ReadContext, type UnresolvedRelationValue, } from './populate.js';
+export { buildRelationSummaryPopulateMap, type RelationTargetResolver, resolveRelationProjection, } from './relation-projection.js';
+export { collectRichTextLeaves, type PopulateRichTextFieldsOptions, populateRichTextFields, type RichTextLeaf, resolvePopulateOnRead, validateRichTextFieldFlags, } from './richtext-populate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,iBAAiB,GAClB,MAAM,2BAA2B,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,OAAO,EACL,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,+BAA+B,EAC/B,KAAK,sBAAsB,EAC3B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,qBAAqB,EACrB,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,KAAK,YAAY,EACjB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA"}

package/dist/services/index.js

@@ -0,0 +1,11 @@
+// packages/core/src/services/index.ts
+export { ERR_CONFLICT, ERR_INVALID_TRANSITION, ERR_NOT_FOUND, ERR_PATCH_FAILED, ERR_READ_BUDGET_EXCEEDED, ERR_VALIDATION, } from '../lib/errors.js';
+export { normaliseDateFields } from '../utils/normalise-dates.js';
+export { ensureCollections, } from './collection-bootstrap.js';
+export * from './document-lifecycle.js';
+export * from './document-read.js';
+export * from './field-upload.js';
+export { createReadContext, populateDocuments, } from './populate.js';
+export { buildRelationSummaryPopulateMap, resolveRelationProjection, } from './relation-projection.js';
+export { collectRichTextLeaves, populateRichTextFields, resolvePopulateOnRead, validateRichTextFieldFlags, } from './richtext-populate.js';
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAGL,iBAAiB,GAClB,MAAM,2BAA2B,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAEL,iBAAiB,EAOjB,iBAAiB,GAGlB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,+BAA+B,EAE/B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,qBAAqB,EAErB,sBAAsB,EAEtB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA"}