@byline/client 1.7.7 → 1.8.0

package/dist/collection-handle.js

@@ -32,7 +32,7 @@ export class CollectionHandle {
     async find(options = {}) {
         const requestContext = await this.resolveAndAssertRead();
         const collectionId = await this.client.resolveCollectionId(this.definition.path);
-        const { where, select, sort, locale = 'en', page = 1, pageSize = 20 } = options;
+        const { where, select, sort, locale = this.client.defaultLocale, page = 1, pageSize = 20, } = options;
         const readMode = resolveReadMode(options.status);
         const readCtx = options._readContext ?? createReadContext();
         const hookPredicate = await this.resolveBeforeReadPredicate(requestContext, readCtx, options._bypassBeforeRead);
@@ -107,7 +107,7 @@ export class CollectionHandle {
     async findById(documentId, options = {}) {
         const requestContext = await this.resolveAndAssertRead();
         const collectionId = await this.client.resolveCollectionId(this.definition.path);
-        const { locale = 'en' } = options;
+        const { locale = this.client.defaultLocale } = options;
         const readMode = resolveReadMode(options.status);
         const readCtx = options._readContext ?? createReadContext();
         const filters = await this.resolveBeforeReadFilters(requestContext, readCtx, options._bypassBeforeRead);
@@ -147,7 +147,7 @@ export class CollectionHandle {
     async findByPath(path, options = {}) {
         const requestContext = await this.resolveAndAssertRead();
         const collectionId = await this.client.resolveCollectionId(this.definition.path);
-        const { locale = 'en' } = options;
+        const { locale = this.client.defaultLocale } = options;
         const readMode = resolveReadMode(options.status);
         const readCtx = options._readContext ?? createReadContext();
         const filters = await this.resolveBeforeReadFilters(requestContext, readCtx, options._bypassBeforeRead);
@@ -308,7 +308,7 @@ export class CollectionHandle {
         const _requestContext = await this.resolveAndAssertRead();
         const collectionId = await this.client.resolveCollectionId(this.definition.path);
         const readCtx = options._readContext ?? createReadContext();
-        const locale = options.locale ?? 'en';
+        const locale = options.locale ?? this.client.defaultLocale;
         const page = options.page ?? 1;
         const pageSize = options.pageSize ?? 20;
         // Access gate. `findById` runs `beforeRead`; a `null` here means either
@@ -365,7 +365,7 @@ export class CollectionHandle {
      */
     async findByVersion(versionId, options = {}) {
         await this.resolveAndAssertRead();
-        const locale = options.locale ?? 'en';
+        const locale = options.locale ?? this.client.defaultLocale;
         const raw = await this.client.db.queries.documents.getDocumentByVersion({
             document_version_id: versionId,
             locale,

package/dist/types.d.ts

@@ -42,8 +42,15 @@ export interface BylineClientConfig {
      */
     logger?: BylineLogger;
     /**
-     * Default content locale. Forwarded to `DocumentLifecycleContext` and
-     * used to anchor `path` derivation. Defaults to `'en'` when omitted.
+     * Default content locale. Forwarded to `DocumentLifecycleContext`,
+     * used to anchor `path` derivation, and applied as the implicit
+     * default for `locale` on every read method (`find`, `findOne`,
+     * `findById`, `findByPath`). Resolved in priority order:
+     *   1. explicit `defaultLocale` on the client config
+     *   2. `config.i18n.content.defaultLocale` when a `ServerConfig` is
+     *      passed via `config`
+     *   3. `'en'` as a last-resort fallback for tests / migration scripts
+     *      that never configure i18n.
      */
     defaultLocale?: string;
     /**
@@ -153,7 +160,7 @@ export interface FindOptions<F = Record<string, any>> extends PopulateControls,
     select?: (keyof F & string)[] | string[];
     /** Sort specification. Keys are field names or document-level columns. */
     sort?: SortSpec;
-    /** Locale for field value resolution. Defaults to 'en'. */
+    /** Locale for field value resolution. Defaults to the client's `defaultLocale`. */
     locale?: string;
     /** Page number (1-based). Defaults to 1. */
     page?: number;
@@ -208,7 +215,7 @@ export interface FindByVersionOptions<F = Record<string, any>> {
     locale?: string;
 }
 export interface CreateOptions {
-    /** Locale for field value resolution. Defaults to 'en'. */
+    /** Locale for field value resolution. Defaults to the client's `defaultLocale`. */
     locale?: string;
     /**
      * Initial workflow status. When omitted, `document-lifecycle` derives
@@ -222,7 +229,7 @@ export interface CreateOptions {
     path?: string;
 }
 export interface UpdateOptions {
-    /** Locale for field value resolution. Defaults to 'en'. */
+    /** Locale for field value resolution. Defaults to the client's `defaultLocale`. */
     locale?: string;
     /**
      * Explicit path override. When omitted, the previous version's path

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/client",
   "private": false,
   "license": "MPL-2.0",
-  "version": "1.7.7",
+  "version": "1.8.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -38,8 +38,8 @@
   ],
   "dependencies": {
     "npm-run-all": "^4.1.5",
-    "@byline/auth": "1.7.7",
-    "@byline/core": "1.7.7"
+    "@byline/auth": "1.8.0",
+    "@byline/core": "1.8.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.14",
@@ -51,7 +51,7 @@
     "tsx": "^4.21.0",
     "typescript": "6.0.3",
     "vitest": "^4.1.5",
-    "@byline/db-postgres": "1.7.7"
+    "@byline/db-postgres": "1.8.0"
   },
   "publishConfig": {
     "access": "public",