@byline/db-postgres 3.0.2 → 3.1.0

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

@@ -216,6 +216,20 @@ export declare class DocumentQueries implements IDocumentQueries {
         created_at: Date;
         updated_at: Date;
     } | null>;
+    /**
+     * getCurrentPath — resolve a document's canonical (source-locale) path.
+     *
+     * Reuses `pathProjection` against `current_documents`, passing
+     * `requestedLocale: undefined` so the projection's fallback floor — the
+     * document's own `source_locale` (COALESCE-guarded to the default content
+     * locale for not-yet-anchored rows) — supplies the canonical path. Used by
+     * the lifecycle to populate `path` on the status-change / unpublish hook
+     * contexts. Returns `null` when no path row (or document) exists.
+     */
+    getCurrentPath({ collection_id, document_id, }: {
+        collection_id: string;
+        document_id: string;
+    }): Promise<string | null>;
     /**
      * getDocumentById — gets the current version of a document by its logical document ID.
      *

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

@@ -439,6 +439,26 @@ export class DocumentQueries {
             updated_at: row.updated_at ?? new Date(),
         };
     }
+    /**
+     * getCurrentPath — resolve a document's canonical (source-locale) path.
+     *
+     * Reuses `pathProjection` against `current_documents`, passing
+     * `requestedLocale: undefined` so the projection's fallback floor — the
+     * document's own `source_locale` (COALESCE-guarded to the default content
+     * locale for not-yet-anchored rows) — supplies the canonical path. Used by
+     * the lifecycle to populate `path` on the status-change / unpublish hook
+     * contexts. Returns `null` when no path row (or document) exists.
+     */
+    async getCurrentPath({ collection_id, document_id, }) {
+        const [row] = await this.db
+            .select({
+            path: this.pathProjection(sql `${currentDocumentsView.document_id}`, undefined, sql `${currentDocumentsView.source_locale}`),
+        })
+            .from(currentDocumentsView)
+            .where(and(eq(currentDocumentsView.collection_id, collection_id), eq(currentDocumentsView.document_id, document_id)))
+            .limit(1);
+        return row?.path ?? null;
+    }
     /**
      * getDocumentById — gets the current version of a document by its logical document ID.
      *

package/dist/modules/storage/tests/storage-document-paths.test.js

@@ -181,4 +181,81 @@ describe('byline_document_paths integration', () => {
         });
         expect(result).toBe(null);
     });
+    describe('getCurrentPath', () => {
+        it('resolves a document’s canonical path under its default source locale', async () => {
+            const canonicalPath = `current-path-${Date.now()}`;
+            const created = await commandBuilders.documents.createDocumentVersion({
+                collectionId: testCollection.id,
+                collectionVersion: 1,
+                collectionConfig: PathsCollectionConfig,
+                action: 'create',
+                documentData: { title: 'Has Path' },
+                path: canonicalPath,
+                locale: 'all',
+                status: 'draft',
+            });
+            const documentId = created.document.document_id;
+            const path = await queryBuilders.documents.getCurrentPath({
+                collection_id: testCollection.id,
+                document_id: documentId,
+            });
+            expect(path).toBe(canonicalPath);
+        });
+        it('follows the source-locale anchor after a document is re-anchored', async () => {
+            const canonicalPath = `reanchor-path-${Date.now()}`;
+            // Create locale-agnostic content (ledger carries the 'all' sentinel) so
+            // the document is "complete" in any target and re-anchoring is eligible.
+            const created = await commandBuilders.documents.createDocumentVersion({
+                collectionId: testCollection.id,
+                collectionVersion: 1,
+                collectionConfig: PathsCollectionConfig,
+                action: 'create',
+                documentData: { title: 'Re-anchor me' },
+                path: canonicalPath,
+                locale: 'all',
+                status: 'draft',
+            });
+            const documentId = created.document.document_id;
+            // Flip the document's source locale from the default ('en') to 'fr'.
+            // reAnchorDocument moves the path row onto the new source locale,
+            // keeping the slug. getCurrentPath passes requestedLocale: undefined, so
+            // its fallback floor is COALESCE(source_locale, default) — it must now
+            // resolve via the 'fr' anchor, not the global default 'en'.
+            const result = await commandBuilders.documents.reAnchorDocument({
+                documentId,
+                targetLocale: 'fr',
+            });
+            expect(result.status).toBe('reanchored');
+            const path = await queryBuilders.documents.getCurrentPath({
+                collection_id: testCollection.id,
+                document_id: documentId,
+            });
+            expect(path).toBe(canonicalPath);
+        });
+        it('returns null when the document has no path row', async () => {
+            // Create a version without a `path` — no document_paths row is written.
+            const created = await commandBuilders.documents.createDocumentVersion({
+                collectionId: testCollection.id,
+                collectionVersion: 1,
+                collectionConfig: PathsCollectionConfig,
+                action: 'create',
+                documentData: { title: 'No Path' },
+                locale: 'all',
+                status: 'draft',
+            });
+            const documentId = created.document.document_id;
+            const path = await queryBuilders.documents.getCurrentPath({
+                collection_id: testCollection.id,
+                document_id: documentId,
+            });
+            expect(path).toBe(null);
+        });
+        it('returns null for a non-existent document', async () => {
+            const path = await queryBuilders.documents.getCurrentPath({
+                collection_id: testCollection.id,
+                document_id: crypto.randomUUID(),
+            });
+            expect(path).toBe(null);
+        });
+    });
 });

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/db-postgres",
   "private": false,
   "license": "MPL-2.0",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "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.2",
-    "@byline/auth": "3.0.2",
-    "@byline/core": "3.0.2"
+    "@byline/core": "3.1.0",
+    "@byline/auth": "3.1.0",
+    "@byline/admin": "3.1.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",