@byline/db-postgres 3.0.0 → 3.0.1

package/dist/database/schema/index.js

@@ -148,7 +148,7 @@ export const documentPaths = pgTable('byline_document_paths', {
 // carries forward across edits and survives restore. Surfaced on reads as
 // `availableLocales`; the public advertised set is the intersection with the
 // ledger's `_availableVersionLocales`. Replaced wholesale on write (the lifecycle
-// deletes then re-inserts the set), never appended. See docs/AVAILABLE-LOCALES.md.
+// deletes then re-inserts the set), never appended. See docs/I18N.md.
 export const documentAvailableLocales = pgTable('byline_document_available_locales', {
     document_id: uuid('document_id')
         .notNull()
@@ -172,7 +172,7 @@ export const documentAvailableLocales = pgTable('byline_document_available_local
 // identically in any locale). Computed status-blind at write time and frozen
 // on the immutable version, so restore / point-in-time reads stay consistent.
 // Drives `localeFallback: 'strict'` reads via an indexed EXISTS gate without
-// scanning the store_* tables. See docs/CONTENT-LOCALE-RESOLUTION.md.
+// scanning the store_* tables. See docs/I18N.md.
 export const documentVersionLocales = pgTable('byline_document_version_locales', {
     document_version_id: uuid('document_version_id')
         .notNull()
@@ -248,7 +248,7 @@ export const currentDocumentsView = pgView('byline_current_documents').as((qb) =
         // read paths (`buildLocaleChain` / `pathProjection` / field-fallback)
         // re-base onto the per-document source rather than the mutable global
         // default — a primary-key join, already present for `order_key`.
-        // See docs/DEFAULT-LOCALE-SWITCHING.md.
+        // See docs/I18N.md.
         source_locale: documents.source_locale,
     })
         .from(sq)

package/dist/index.d.ts

@@ -31,7 +31,7 @@ export interface PgAdapter extends IDbAdapter {
      * existed, so `localeFallback: 'strict'` reads can see pre-existing
      * documents. Idempotent; uses the configured default content locale. Kept
      * off the core `IDbAdapter` contract (no service depends on it) — see
-     * docs/CONTENT-LOCALE-RESOLUTION.md.
+     * docs/I18N.md.
      */
     backfillVersionLocales(): Promise<{
         rowsInserted: number;
@@ -42,7 +42,7 @@ export interface PgAdapter extends IDbAdapter {
      * default content locale (the anchor they were implicitly authored against).
      * Idempotent; run automatically at boot by `initBylineCore` (also exposed on
      * the core `IDbAdapter` contract as an optional method) — see
-     * docs/DEFAULT-LOCALE-SWITCHING.md.
+     * docs/I18N.md.
      */
     backfillSourceLocales(): Promise<{
         rowsUpdated: number;
@@ -53,7 +53,7 @@ export interface PgAdapter extends IDbAdapter {
      * unless the document is complete in the target. Writes a new immutable
      * version. `dryRun` reports the would-be outcome without writing. Off the
      * core `IDbAdapter` contract (maintenance/admin operation) — see
-     * docs/DEFAULT-LOCALE-SWITCHING.md.
+     * docs/I18N.md.
      */
     reAnchorDocument(params: {
         documentId: string;
@@ -83,7 +83,7 @@ export declare const pgAdapter: ({ connectionString, collections, defaultContent
      * for documents whose `source_locale` is not yet backfilled. Per-document
      * reads and writes otherwise re-base onto each document's own `source_locale`
      * (carried on the current-documents views), so changing this value does not
-     * re-interpret existing data. See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * re-interpret existing data. See docs/I18N.md.
      */
     defaultContentLocale: string;
     /**

package/dist/modules/storage/storage-commands.d.ts

@@ -104,7 +104,7 @@ export declare class DocumentCommands implements IDocumentCommands {
          * `undefined` leaves the existing set untouched (sticky across versions,
          * like `path`); an empty array clears it (advertise nothing). The locale
          * values are the advertised content locales themselves, not the default
-         * locale. See docs/AVAILABLE-LOCALES.md.
+         * locale. See docs/I18N.md.
          */
         availableLocales?: string[];
         locale?: string;
@@ -139,7 +139,7 @@ export declare class DocumentCommands implements IDocumentCommands {
      * so callers must have written them first. Shared by the create write path
      * (step 6) and `reAnchorDocument` (which recomputes against the new source).
      * Assumes the version has no ledger rows yet (a freshly-inserted version).
-     * See docs/CONTENT-LOCALE-RESOLUTION.md and docs/DEFAULT-LOCALE-SWITCHING.md.
+     * See docs/I18N.md.
      */
     private writeVersionLocaleLedger;
     /**
@@ -167,7 +167,7 @@ export declare class DocumentCommands implements IDocumentCommands {
      * identities preserved), and computes that version's ledger against the new
      * source. `dryRun` performs only the eligibility check and reports the
      * outcome that *would* result, writing nothing. See
-     * docs/DEFAULT-LOCALE-SWITCHING.md.
+     * docs/I18N.md.
      */
     reAnchorDocument(params: {
         documentId: string;
@@ -185,7 +185,7 @@ export declare class DocumentCommands implements IDocumentCommands {
      * "client switched the default content locale, move every fully-translated
      * document onto it" operation; the `skipped-incomplete` results double as the
      * outstanding-translation backlog. `dryRun` reports what would happen without
-     * writing. See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * writing. See docs/I18N.md.
      */
     reAnchorDocuments(params: {
         targetLocale: string;
@@ -211,7 +211,7 @@ export declare class DocumentCommands implements IDocumentCommands {
      * a version's computed locale set never changes. Returns the number of
      * `(version, locale)` rows inserted.
      *
-     * See docs/CONTENT-LOCALE-RESOLUTION.md.
+     * See docs/I18N.md.
      */
     backfillVersionLocales(): Promise<{
         rowsInserted: number;
@@ -230,7 +230,7 @@ export declare class DocumentCommands implements IDocumentCommands {
      *
      * Returns the number of document rows stamped.
      *
-     * See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * See docs/I18N.md.
      */
     backfillSourceLocales(): Promise<{
         rowsUpdated: number;

package/dist/modules/storage/storage-commands.js

@@ -77,7 +77,7 @@ export class DocumentCommands {
             // source locale rather than the mutable global default. NULL (a row not
             // yet touched by `backfillSourceLocales`) falls back to the configured
             // default — the value it was implicitly authored against.
-            // See docs/DEFAULT-LOCALE-SWITCHING.md.
+            // See docs/I18N.md.
             let sourceLocale;
             if (documentId == null) {
                 documentId = uuidv7();
@@ -271,7 +271,7 @@ export class DocumentCommands {
             // accounts for the per-locale carry-forward in step 5 — not just the
             // freshly-flattened locale. A version with no localized content at all
             // records a single `'all'` sentinel (it renders identically in any
-            // locale). Status-blind by design — see docs/CONTENT-LOCALE-RESOLUTION.md.
+            // locale). Status-blind by design — see docs/I18N.md.
             await this.writeVersionLocaleLedger(tx, documentVersion.id, sourceLocale);
             return {
                 document: documentVersion,
@@ -289,7 +289,7 @@ export class DocumentCommands {
      * so callers must have written them first. Shared by the create write path
      * (step 6) and `reAnchorDocument` (which recomputes against the new source).
      * Assumes the version has no ledger rows yet (a freshly-inserted version).
-     * See docs/CONTENT-LOCALE-RESOLUTION.md and docs/DEFAULT-LOCALE-SWITCHING.md.
+     * See docs/I18N.md.
      */
     async writeVersionLocaleLedger(tx, versionId, sourceLocale) {
         await tx.execute(sql `
@@ -398,7 +398,7 @@ export class DocumentCommands {
      * identities preserved), and computes that version's ledger against the new
      * source. `dryRun` performs only the eligibility check and reports the
      * outcome that *would* result, writing nothing. See
-     * docs/DEFAULT-LOCALE-SWITCHING.md.
+     * docs/I18N.md.
      */
     async reAnchorDocument(params) {
         const { documentId, targetLocale, dryRun = false } = params;
@@ -479,7 +479,7 @@ export class DocumentCommands {
      * "client switched the default content locale, move every fully-translated
      * document onto it" operation; the `skipped-incomplete` results double as the
      * outstanding-translation backlog. `dryRun` reports what would happen without
-     * writing. See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * writing. See docs/I18N.md.
      */
     async reAnchorDocuments(params) {
         const { targetLocale, collectionId, dryRun = false } = params;
@@ -540,7 +540,7 @@ export class DocumentCommands {
      * a version's computed locale set never changes. Returns the number of
      * `(version, locale)` rows inserted.
      *
-     * See docs/CONTENT-LOCALE-RESOLUTION.md.
+     * See docs/I18N.md.
      */
     async backfillVersionLocales() {
         const result = await this.db.execute(sql `
@@ -598,7 +598,7 @@ export class DocumentCommands {
      *
      * Returns the number of document rows stamped.
      *
-     * See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * See docs/I18N.md.
      */
     async backfillSourceLocales() {
         const result = await this.db

package/dist/modules/storage/storage-queries.d.ts

@@ -84,7 +84,7 @@ export declare class DocumentQueries implements IDocumentQueries {
      * document, or any document read after the global default is switched, falls
      * back to the locale it was actually authored in) — otherwise the configured
      * global default, which is correct for not-yet-anchored rows and for
-     * row-less lookups (findByPath). See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * row-less lookups (findByPath). See docs/I18N.md.
      */
     private buildLocaleChain;
     /**
@@ -113,7 +113,7 @@ export declare class DocumentQueries implements IDocumentQueries {
      * advertise. Surfaced on reads as `availableLocales` — the deliberate
      * counterpart to the version-grain `_availableVersionLocales` ledger fact;
      * the public advertised set is their intersection. One indexed query per
-     * call. See docs/AVAILABLE-LOCALES.md.
+     * call. See docs/I18N.md.
      */
     private getAdvertisedLocalesByDocument;
     /**

package/dist/modules/storage/storage-queries.js

@@ -105,7 +105,7 @@ export class DocumentQueries {
      * document, or any document read after the global default is switched, falls
      * back to the locale it was actually authored in) — otherwise the configured
      * global default, which is correct for not-yet-anchored rows and for
-     * row-less lookups (findByPath). See docs/DEFAULT-LOCALE-SWITCHING.md.
+     * row-less lookups (findByPath). See docs/I18N.md.
      */
     buildLocaleChain(requestedLocale, sourceLocale) {
         const floor = sourceLocale ?? this.defaultContentLocale;
@@ -171,7 +171,7 @@ export class DocumentQueries {
      * advertise. Surfaced on reads as `availableLocales` — the deliberate
      * counterpart to the version-grain `_availableVersionLocales` ledger fact;
      * the public advertised set is their intersection. One indexed query per
-     * call. See docs/AVAILABLE-LOCALES.md.
+     * call. See docs/I18N.md.
      */
     async getAdvertisedLocalesByDocument(documentIds) {
         const result = new Map();

package/dist/modules/storage/tests/storage-locale-fallback.test.js

@@ -278,26 +278,6 @@ describe('content-locale resolution & fallback', () => {
         const second = await commandBuilders.documents.backfillVersionLocales();
         expect(second.rowsInserted).toBe(0);
     });
-    it('backfillSourceLocales stamps NULL source_locale rows with the default locale', async () => {
-        const id = await createDoc({
-            title: { en: 'Hello', de: 'Hallo' },
-            body: { en: 'World', de: 'Welt' },
-            sku: 'S1',
-        });
-        // The write path now stamps source_locale on create (Slice 2), so simulate
-        // a row written before the column existed by nulling it — exactly the
-        // pre-existing-data shape backfill exists to repair.
-        await db.execute(sql `UPDATE byline_documents SET source_locale = NULL WHERE id = ${id}::uuid`);
-        const before = await db.execute(sql `SELECT source_locale FROM byline_documents WHERE id = ${id}::uuid`);
-        expect(before.rows[0].source_locale).toBeNull();
-        const result = await commandBuilders.documents.backfillSourceLocales();
-        expect(result.rowsUpdated).toBeGreaterThan(0);
-        const after = await db.execute(sql `SELECT source_locale FROM byline_documents WHERE id = ${id}::uuid`);
-        expect(after.rows[0].source_locale, 'stamped with the adapter default content locale (en)').toBe('en');
-        // Idempotent: a second run touches nothing (no NULL rows remain).
-        const second = await commandBuilders.documents.backfillSourceLocales();
-        expect(second.rowsUpdated).toBe(0);
-    });
     // --- source_locale write path (Slice 2) ----------------------------------
     it('records source_locale on create and writes the path row under it', async () => {
         const created = await commandBuilders.documents.createDocumentVersion({

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/db-postgres",
   "private": false,
   "license": "MPL-2.0",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -57,9 +57,9 @@
     "pg": "^8.21.0",
     "uuid": "^14.0.0",
     "zod": "^4.4.3",
-    "@byline/admin": "3.0.0",
-    "@byline/auth": "3.0.0",
-    "@byline/core": "3.0.0"
+    "@byline/core": "3.0.1",
+    "@byline/auth": "3.0.1",
+    "@byline/admin": "3.0.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",