@byline/cli 6.6.0 → 6.7.1

package/dist/lib/pg-url.d.ts

@@ -0,0 +1,11 @@
+export interface PgConn {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+}
+export declare function buildPgUrl(c: PgConn): string;
+export declare function parsePgUrl(raw: string): PgConn;
+export declare function withDatabase(c: PgConn, database: string): PgConn;
+//# sourceMappingURL=pg-url.d.ts.map

package/dist/lib/pg-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-url.d.ts","sourceRoot":"","sources":["../../src/lib/pg-url.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY9C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/lib/pg-url.js

@@ -0,0 +1,22 @@
+export function buildPgUrl(c) {
+    const u = encodeURIComponent(c.user);
+    const p = encodeURIComponent(c.password);
+    return `postgresql://${u}:${p}@${c.host}:${c.port}/${encodeURIComponent(c.database)}`;
+}
+export function parsePgUrl(raw) {
+    const url = new URL(raw);
+    if (url.protocol !== 'postgresql:' && url.protocol !== 'postgres:') {
+        throw new Error(`expected postgresql:// URL, got ${url.protocol}`);
+    }
+    return {
+        host: url.hostname,
+        port: url.port ? Number(url.port) : 5432,
+        user: decodeURIComponent(url.username),
+        password: decodeURIComponent(url.password),
+        database: url.pathname.replace(/^\//, '') || 'postgres',
+    };
+}
+export function withDatabase(c, database) {
+    return { ...c, database };
+}
+//# sourceMappingURL=pg-url.js.map

package/dist/lib/pg-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-url.js","sourceRoot":"","sources":["../../src/lib/pg-url.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IACxC,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAA;AACvF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACxC,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACtC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,UAAU;KACxD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,QAAgB;IACtD,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAA;AAC3B,CAAC"}

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/phases/stub.d.ts

@@ -0,0 +1,3 @@
+import type { Phase, PhaseId } from '../types.js';
+export declare function stubPhase(id: PhaseId, title: string): Phase;
+//# sourceMappingURL=stub.d.ts.map

package/dist/phases/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../src/phases/stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAEjD,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAoB3D"}

package/dist/phases/stub.js

@@ -0,0 +1,25 @@
+export function stubPhase(id, title) {
+    return {
+        id,
+        title,
+        defaultMode: 'confirm',
+        async detect(ctx) {
+            return ctx.state.isComplete(id) ? 'done' : 'pending';
+        },
+        async plan() {
+            return {
+                writes: [],
+                commands: [],
+                notes: [`${id}: not yet implemented in @byline/cli ${currentVersion()}`],
+            };
+        },
+        async apply(_plan, ctx) {
+            ctx.logger.warn(`${id} — phase is stubbed; please follow the manual instructions in docs`);
+            return { state: 'pending' };
+        },
+    };
+}
+function currentVersion() {
+    return '0.1.0';
+}
+//# sourceMappingURL=stub.js.map

package/dist/phases/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../src/phases/stub.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CAAC,EAAW,EAAE,KAAa;IAClD,OAAO;QACL,EAAE;QACF,KAAK;QACL,WAAW,EAAE,SAAS;QACtB,KAAK,CAAC,MAAM,CAAC,GAAY;YACvB,OAAO,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;QACtD,CAAC;QACD,KAAK,CAAC,IAAI;YACR,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,CAAC,GAAG,EAAE,wCAAwC,cAAc,EAAE,EAAE,CAAC;aACzE,CAAA;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG;YACpB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,oEAAoE,CAAC,CAAA;YAC1F,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,OAAO,CAAA;AAChB,CAAC"}

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/dist/ui/snippet.d.ts

@@ -0,0 +1,2 @@
+export declare function renderSnippet(title: string, body: string, lang?: string): string;
+//# sourceMappingURL=snippet.d.ts.map

package/dist/ui/snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/ui/snippet.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAI5E"}

package/dist/ui/snippet.js

@@ -0,0 +1,7 @@
+import pc from 'picocolors';
+export function renderSnippet(title, body, lang = '') {
+    const header = pc.dim(`--- ${title}${lang ? ` (${lang})` : ''} ---`);
+    const footer = pc.dim('---');
+    return `${header}\n${body}\n${footer}`;
+}
+//# sourceMappingURL=snippet.js.map

package/dist/ui/snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/ui/snippet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,IAAI,GAAG,EAAE;IAClE,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC5B,OAAO,GAAG,MAAM,KAAK,IAAI,KAAK,MAAM,EAAE,CAAA;AACxC,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/cli",
   "private": false,
   "license": "MPL-2.0",
-  "version": "6.6.0",
+  "version": "6.7.1",
   "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.1"
   },
   "publishConfig": {
     "access": "public",