@byline/cli 6.6.0 → 6.7.0

package/dist/lib/template-docs-hooks.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=template-docs-hooks.test.node.d.ts.map

package/dist/lib/template-docs-hooks.test.node.d.ts.map

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

package/dist/lib/template-docs-hooks.test.node.js

@@ -0,0 +1,98 @@
+/**
+ * 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 { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
+const search = vi.hoisted(() => ({
+    collection: vi.fn(),
+    indexDocument: vi.fn(),
+}));
+vi.mock('@byline/client/server', () => ({
+    getSystemBylineClient: () => ({ collection: search.collection }),
+}));
+// The template imports `@byline/client/server`, which is not a CLI dependency
+// (it is mocked above), and `src/templates` is excluded from the CLI's
+// TypeScript program. A runtime-only specifier keeps the compiler from
+// following the import while Vitest still resolves and loads the module.
+const templateHooksPath = '../templates/byline-examples/collections/docs/hooks.js';
+let hooks;
+beforeAll(async () => {
+    hooks = (await import(/* @vite-ignore */ templateHooksPath)).default;
+});
+function context(overrides) {
+    return {
+        documentId: 'doc-1',
+        collectionPath: 'docs',
+        requested: { path: false, availableLocales: false },
+        changed: { path: false, availableLocales: false },
+        reconciliation: false,
+        previousPath: 'intro',
+        currentPath: 'intro',
+        previousAvailableLocales: ['en'],
+        currentAvailableLocales: ['en'],
+        ...overrides,
+    };
+}
+async function run(ctx) {
+    const hook = hooks.afterSystemFieldsChange;
+    expect(hook).toBeDefined();
+    for (const fn of Array.isArray(hook) ? hook : hook ? [hook] : [])
+        await fn(ctx);
+}
+describe('scaffolded docs afterSystemFieldsChange', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.spyOn(console, 'log').mockImplementation(() => { });
+        search.indexDocument.mockResolvedValue(undefined);
+        search.collection.mockReturnValue({ indexDocument: search.indexDocument });
+    });
+    it.each([
+        ['enabled', ['en'], ['en', 'es']],
+        ['disabled', ['en', 'es'], ['en']],
+    ])('reindexes once when a locale is %s and the path is untouched', async (_name, before, after) => {
+        await run(context({
+            requested: { path: false, availableLocales: true },
+            changed: { path: false, availableLocales: true },
+            previousAvailableLocales: before,
+            currentAvailableLocales: after,
+        }));
+        expect(search.collection).toHaveBeenCalledWith('docs');
+        expect(search.indexDocument).toHaveBeenCalledOnce();
+        expect(search.indexDocument).toHaveBeenCalledWith('doc-1');
+    });
+    it('reindexes once for a path change, or a combined path and locale change', async () => {
+        await run(context({
+            requested: { path: true, availableLocales: false },
+            changed: { path: true, availableLocales: false },
+            currentPath: 'introduction',
+        }));
+        await run(context({
+            requested: { path: true, availableLocales: true },
+            changed: { path: true, availableLocales: true },
+            currentPath: 'introduction',
+            currentAvailableLocales: ['en', 'es'],
+        }));
+        expect(search.indexDocument).toHaveBeenCalledTimes(2);
+    });
+    it('re-runs indexing on an explicit no-op locale reconciliation retry', async () => {
+        await run(context({
+            requested: { path: false, availableLocales: true },
+            changed: { path: false, availableLocales: false },
+            reconciliation: true,
+        }));
+        expect(search.indexDocument).toHaveBeenCalledOnce();
+    });
+    it('surfaces an indexing failure so the committed-hook flow can report and retry it', async () => {
+        const failure = new Error('index unavailable');
+        search.indexDocument.mockRejectedValueOnce(failure);
+        await expect(run(context({
+            requested: { path: false, availableLocales: true },
+            changed: { path: false, availableLocales: true },
+            currentAvailableLocales: ['en', 'es'],
+        }))).rejects.toBe(failure);
+    });
+});
+//# sourceMappingURL=template-docs-hooks.test.node.js.map

package/dist/lib/template-docs-hooks.test.node.js.map

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

package/dist/lib/template-pages-preview.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=template-pages-preview.test.node.d.ts.map

package/dist/lib/template-pages-preview.test.node.d.ts.map

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

package/dist/lib/template-pages-preview.test.node.js

@@ -0,0 +1,55 @@
+/**
+ * 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
+ */
+/**
+ * Runtime test of the scaffolded Pages preview builder (the file generated
+ * projects receive). The prefix must follow the content default locale, never
+ * the admin interface default, and the selected content locale must survive
+ * even when it is not advertised.
+ */
+import { beforeAll, describe, expect, it, vi } from 'vitest';
+// Admin and content defaults deliberately differ.
+vi.mock('~/i18n', () => ({
+    i18n: {
+        admin: { defaultLocale: 'en', locales: ['en', 'fr'] },
+        content: { defaultLocale: 'fr', locales: ['fr', 'en', 'es'] },
+    },
+}));
+// The admin config is data plus React components; only `preview.url` matters.
+vi.mock('@byline/core', async (importOriginal) => ({
+    ...(await importOriginal()),
+    defineAdmin: (_definition, config) => config,
+}));
+vi.mock('@byline/admin/react', () => ({ DateTimeFormatter: () => null }));
+vi.mock('~/components/summary-length.js', () => ({ SummaryLength: () => null }));
+// `src/templates` is excluded from the CLI's TypeScript program; a runtime-only
+// specifier keeps the compiler from following the import (see the docs hooks test).
+const templateAdminPath = '../templates/byline-examples/collections/pages/admin.js';
+let url;
+beforeAll(async () => {
+    const module = await import(/* @vite-ignore */ templateAdminPath);
+    const preview = module.PagesAdmin.preview;
+    if (preview == null)
+        throw new Error('template Pages admin has no preview builder');
+    url = preview.url;
+});
+function page(path, area) {
+    return { id: 'doc-1', path, status: 'draft', fields: area ? { area } : {} };
+}
+describe('scaffolded Pages preview URL', () => {
+    it('omits the prefix for the content default locale, even though admin defaults to en', () => {
+        expect(url(page('team'), { locale: 'fr' })).toBe('/team');
+    });
+    it('prefixes every other content locale, including the admin default', () => {
+        expect(url(page('team'), { locale: 'en' })).toBe('/en/team');
+        expect(url(page('team'), { locale: 'es' })).toBe('/es/team');
+    });
+    it('hides the affordance until the page has a path', () => {
+        expect(url(page(''), { locale: 'es' })).toBeNull();
+    });
+});
+//# sourceMappingURL=template-pages-preview.test.node.js.map

package/dist/lib/template-pages-preview.test.node.js.map

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

package/dist/templates/byline-examples/collections/docs/admin.tsx

@@ -129,6 +129,13 @@ export const DocsAdmin: CollectionAdminConfig = defineAdmin(Docs, {
    * Direct relations are auto-populated by the edit view (depth 1, picker
    * projection) and appear under `doc.fields.<name>?.document`.
    *
+   * `locale` is the content locale selected in the editor. Keep it even when
+   * that translation is not advertised: preview is how an editor reviews an
+   * unchecked translation. The locale prefix must follow your public routes'
+   * rule, which this scaffold cannot know; the example assumes the default
+   * locale (`'en'`) is unprefixed. Never derive it from the admin interface
+   * language.
+   *
    * @example
    * preview: {
    *   url: (doc, { locale }) => {

package/dist/templates/byline-examples/collections/docs/hooks.ts

@@ -78,8 +78,11 @@ export default defineHooks({
       `afterSystemFieldsChange: ${documentId} in '${collectionPath}' changed`,
       changed
     )
-    // Advertised locales affect alternates/sitemaps, not indexed content.
-    if (requested.path) {
+    // Both change the public index: a path change moves the indexed URL, and
+    // an advertised-locale change alters which translations are publicly
+    // delivered (and so indexed). Check `requested` rather than `changed` so an
+    // explicit reconciliation retry re-runs indexing after a failed attempt.
+    if (requested.path || requested.availableLocales) {
       await getSystemBylineClient().collection('docs').indexDocument(documentId)
     }
   },

package/dist/templates/byline-examples/collections/news/admin.tsx

@@ -140,6 +140,13 @@ export const NewsAdmin: CollectionAdminConfig = defineAdmin(News, {
    * Direct relations are auto-populated by the edit view (depth 1, picker
    * projection) and appear under `doc.fields.<name>?.document`.
    *
+   * `locale` is the content locale selected in the editor. Keep it even when
+   * that translation is not advertised: preview is how an editor reviews an
+   * unchecked translation. The locale prefix must follow your public routes'
+   * rule, which this scaffold cannot know; the example assumes the default
+   * locale (`'en'`) is unprefixed. Never derive it from the admin interface
+   * language.
+   *
    * @example
    * preview: {
    *   url: (doc, { locale }) => {

package/dist/templates/byline-examples/collections/pages/admin.tsx

@@ -125,6 +125,14 @@ export const PagesAdmin: CollectionAdminConfig = defineAdmin(Pages, {
    * richtext embed walker on internal-link nodes) and adds the request-
    * locale prefix on top. Returns `null` to hide the preview affordance.
    *
+   * `locale` is the content locale selected in the editor. Keep it even
+   * when that translation is not advertised: preview is how an editor
+   * reviews an unchecked translation. The locale prefix is your public
+   * routes' rule, which this scaffold cannot know. This default assumes
+   * the content default locale is served without a prefix and every other
+   * locale under `/<locale>`; change it to match your routes. Never derive
+   * the prefix from the admin interface language.
+   *
    * `doc.path` is the top-level slug (derived from `useAsPath`), not a
    * field. Direct relations are auto-populated by the edit view (depth
    * 1, picker projection) and appear under `doc.fields.<name>?.document`.
@@ -133,7 +141,7 @@ export const PagesAdmin: CollectionAdminConfig = defineAdmin(Pages, {
     url: (doc, { locale }) => {
       const path = Pages.buildDocumentPath?.(doc, { collectionPath: Pages.path }) ?? null
       if (path == null) return null
-      const prefix = locale && locale !== i18n.admin.defaultLocale ? `/${locale}` : ''
+      const prefix = locale && locale !== i18n.content.defaultLocale ? `/${locale}` : ''
       return `${prefix}${path}`
     },
   },

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/cli",
   "private": false,
   "license": "MPL-2.0",
-  "version": "6.6.0",
+  "version": "6.7.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -61,7 +61,7 @@
     "typescript": "^7.0.2",
     "unified": "^11.0.5",
     "vitest": "^5.0.1",
-    "@byline/core": "6.6.0"
+    "@byline/core": "6.7.0"
   },
   "publishConfig": {
     "access": "public",