@byline/core 6.0.2 → 6.1.0

package/dist/@types/admin-types.d.ts

@@ -392,6 +392,19 @@ export interface CollectionAdminConfig<T = any> extends FormAdminConfig {
             locale?: string;
         }) => string | null;
     };
+    /**
+     * Declares this collection's document paths managed — minted by the system
+     * or an import rather than typed by an editor. The admin path widget then
+     * renders read-only in both modes, with no preview or "Regenerate" action,
+     * and renders even when the collection declares no `useAsPath`.
+     *
+     * An admin-interface guard only: it does not make the path immutable, and
+     * it is independent of `useAsPath`. See
+     * [Document paths](../../../../docs/04-collections/05-document-paths.md).
+     *
+     * @default false
+     */
+    lockPath?: boolean;
     /**
      * Custom list-view component for this collection.
      *
@@ -458,6 +471,8 @@ export interface SingletonAdminConfig<T = any> extends FormAdminConfig {
     itemViewSort?: never;
     listView?: never;
     listActions?: never;
+    /** A singleton has no document path and no path widget. */
+    lockPath?: never;
 }
 /** Admin presentation config for either registered document-resource kind. */
 export type AdminResourceConfig<T = any> = CollectionAdminConfig<T> | SingletonAdminConfig<T>;

package/dist/@types/singleton-admin-config.test.node.js

@@ -52,6 +52,13 @@ describe('singleton admin config', () => {
             columns: [{ fieldName: 'title', label: 'Title' }],
         });
     });
+    it('rejects lockPath at the singleton definition site and accepts it on a collection', () => {
+        defineSingletonAdmin(settings, {
+            // @ts-expect-error — a singleton has no document path and no path widget.
+            lockPath: true,
+        });
+        expect(defineAdmin(pages, { lockPath: true }).lockPath).toBe(true);
+    });
     it('keeps the singleton preview document pathless', () => {
         defineSingletonAdmin(settings, {
             preview: {

package/dist/config/resolve-item-view-columns.test.node.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 {};

package/dist/config/resolve-item-view-columns.test.node.js

@@ -0,0 +1,30 @@
+/**
+ * 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 { resolveItemViewColumns } from './config.js';
+const itemViewCols = [{ fieldName: 'title', label: 'Title' }];
+const pickerCols = [{ fieldName: 'name', label: 'Name' }];
+const cfg = (over) => ({ slug: 'x', ...over });
+describe('resolveItemViewColumns', () => {
+    it('returns itemView when present', () => {
+        expect(resolveItemViewColumns(cfg({ itemView: itemViewCols }))).toBe(itemViewCols);
+    });
+    it('falls back to the deprecated picker alias', () => {
+        expect(resolveItemViewColumns(cfg({ picker: pickerCols }))).toBe(pickerCols);
+    });
+    it('prefers itemView over picker when both are present', () => {
+        expect(resolveItemViewColumns(cfg({ itemView: itemViewCols, picker: pickerCols }))).toBe(itemViewCols);
+    });
+    it('returns undefined when neither is set', () => {
+        expect(resolveItemViewColumns(cfg({}))).toBeUndefined();
+    });
+    it('tolerates null / undefined config', () => {
+        expect(resolveItemViewColumns(null)).toBeUndefined();
+        expect(resolveItemViewColumns(undefined)).toBeUndefined();
+    });
+});

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

@@ -19,6 +19,7 @@ const COLLECTION_ONLY_ADMIN_KEYS = completeCollectionOnlyAdminKeys([
     'itemViewSort',
     'listView',
     'listActions',
+    'lockPath',
 ]);
 /**
  * Resolve a `fields{}` override key against a field set.

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

@@ -72,6 +72,13 @@ describe('validateAdminConfigs', () => {
         };
         expect(() => validateAdminConfigs([admin], [collection, singleton])).toThrow(/columns.*not allowed on a singleton admin config/);
     });
+    it('rejects the collection-only lockPath option on a singleton from untyped callers', () => {
+        const admin = {
+            ...defineSingletonAdmin(singleton, {}),
+            lockPath: true,
+        };
+        expect(() => validateAdminConfigs([admin], [collection, singleton])).toThrow(/lockPath.*not allowed on a singleton admin config/);
+    });
     it('rejects a singleton admin config targeting a multi-collection', () => {
         const admin = { ...defineSingletonAdmin(singleton, {}), slug: collection.path };
         expect(() => validateAdminConfigs([admin], [collection, singleton])).toThrow(/targets a collection definition/);

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

@@ -452,7 +452,7 @@ describe('uploadField service', () => {
     it('beforeStore { storagePath } threads targetStoragePath verbatim and derives the filename from its basename', async () => {
         const definition = withFieldUpload(uploadCollection, 'image', (f) => {
             f.upload.hooks = {
-                beforeStore: () => ({ storagePath: 'publications/forru-0000447-0001-en.png' }),
+                beforeStore: () => ({ storagePath: 'publications/pub-0000447-0001-en.png' }),
             };
         });
         const { ctx, upload } = buildCtx({ definition });
@@ -466,17 +466,17 @@ describe('uploadField service', () => {
         // Explicit key is handed to the provider verbatim — no entropy suffix,
         // no collection-derived key.
         expect(upload).toHaveBeenCalledWith(expect.any(Buffer), expect.objectContaining({
-            targetStoragePath: 'publications/forru-0000447-0001-en.png',
-            filename: 'forru-0000447-0001-en.png',
+            targetStoragePath: 'publications/pub-0000447-0001-en.png',
+            filename: 'pub-0000447-0001-en.png',
         }));
         // Stored filename follows the explicit key's basename.
-        expect(result.storedFile.filename).toBe('forru-0000447-0001-en.png');
+        expect(result.storedFile.filename).toBe('pub-0000447-0001-en.png');
     });
     it('beforeStore { storagePath, filename } honours both; a leading slash is stripped from the key', async () => {
         const definition = withFieldUpload(uploadCollection, 'image', (f) => {
             f.upload.hooks = {
                 beforeStore: () => ({
-                    storagePath: '/publications/forru-0000447-0002-en.png',
+                    storagePath: '/publications/pub-0000447-0002-en.png',
                     filename: 'display-name.png',
                 }),
             };
@@ -490,7 +490,7 @@ describe('uploadField service', () => {
             shouldCreateDocument: false,
         });
         expect(upload).toHaveBeenCalledWith(expect.any(Buffer), expect.objectContaining({
-            targetStoragePath: 'publications/forru-0000447-0002-en.png',
+            targetStoragePath: 'publications/pub-0000447-0002-en.png',
             filename: 'display-name.png',
         }));
         expect(result.storedFile.filename).toBe('display-name.png');

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/core",
   "private": false,
   "license": "MPL-2.0",
-  "version": "6.0.2",
+  "version": "6.1.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -87,7 +87,7 @@
     "sharp": "^0.35.4",
     "uuid": "^14.0.2",
     "zod": "^4.6.2",
-    "@byline/auth": "6.0.2"
+    "@byline/auth": "6.1.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.13",