@byline/host-tanstack-start 3.17.0 → 3.18.0

package/dist/admin-shell/collections/api.d.ts

@@ -17,7 +17,7 @@ import 'react-json-view-lite/dist/index.css';
  */
 export declare const ApiView: ({ collectionDefinition, initialData, locale, depth, contentLocales, defaultContentLocale, }: {
     collectionDefinition: CollectionDefinition;
-    initialData: AnyCollectionSchemaTypes["UpdateType"];
+    initialData: AnyCollectionSchemaTypes['UpdateType'];
     /** Currently active locale from the route search param (undefined → all). */
     locale?: string;
     /** Populate depth from the route search param (undefined → 0, no populate). */

package/dist/admin-shell/collections/edit.d.ts

@@ -11,7 +11,7 @@ import type { ContentLocaleOption } from './view-menu.js';
 export declare const EditView: ({ collectionDefinition, adminConfig, initialData, locale, contentLocales, defaultContentLocale, }: {
     collectionDefinition: CollectionDefinition;
     adminConfig?: CollectionAdminConfig;
-    initialData: AnyCollectionSchemaTypes["UpdateType"];
+    initialData: AnyCollectionSchemaTypes['UpdateType'];
     locale?: string;
     contentLocales: ReadonlyArray<ContentLocaleOption>;
     defaultContentLocale: string;

package/dist/admin-shell/collections/history.d.ts

@@ -12,7 +12,7 @@ import type { ContentLocaleOption } from './view-menu.js';
 export declare const HistoryView: ({ collectionDefinition, adminConfig, data, auditLog, workflowStatuses, currentDocument, contentLocales, defaultContentLocale, }: {
     collectionDefinition: CollectionDefinition;
     adminConfig?: CollectionAdminConfig;
-    data: AnyCollectionSchemaTypes["HistoryType"] & {
+    data: AnyCollectionSchemaTypes['HistoryType'] & {
         /**
          * Audit display labels (the acting user per version), resolved admin-side from each
          * version's `createdBy` id (see docs/06-auth-and-security/02-auditability.md — Workstream 1). Ids

package/dist/admin-shell/collections/list.d.ts

@@ -14,7 +14,7 @@ type ReorderFn = (params: {
     afterDocumentId: string | null;
 }) => Promise<unknown>;
 export declare const ListView: ({ data, columns, workflowStatuses, useAsTitle, orderable, onReorder, listActions, }: {
-    data: AnyCollectionSchemaTypes["ListType"];
+    data: AnyCollectionSchemaTypes['ListType'];
     columns: ColumnDefinition[];
     workflowStatuses?: WorkflowStatus[];
     useAsTitle?: string;

package/dist/server-fns/admin-permissions/list-registered.d.ts

@@ -16,7 +16,7 @@ export declare const listRegisteredAbilities: import("@tanstack/react-start").Op
         label: string;
         description: string | null;
         group: string;
-        source: "collection" | "admin" | "plugin" | "core" | null;
+        source: "admin" | "collection" | "core" | "plugin" | null;
     }[];
     groups: {
         group: string;
@@ -25,7 +25,7 @@ export declare const listRegisteredAbilities: import("@tanstack/react-start").Op
             label: string;
             description: string | null;
             group: string;
-            source: "collection" | "admin" | "plugin" | "core" | null;
+            source: "admin" | "collection" | "core" | "plugin" | null;
         }[];
     }[];
     total: number;

package/dist/server-fns/admin-users/list.d.ts

@@ -45,7 +45,7 @@ export declare const listAdminUsers: import("@tanstack/react-start").RequiredFet
         page: number;
         page_size: number;
         query: string;
-        order: "email" | "created_at" | "updated_at" | "given_name" | "family_name" | "username";
+        order: "created_at" | "email" | "family_name" | "given_name" | "updated_at" | "username";
         desc: boolean;
     };
 }>>;

package/dist/server-fns/auth/sign-out.d.ts

@@ -6,5 +6,5 @@
  * Copyright (c) Infonomic Company Limited
  */
 export declare const adminSignOut: import("@tanstack/react-start").OptionalFetcher<undefined, undefined, Promise<{
-    status: "ok";
+    status: 'ok';
 }>>;

package/dist/server-fns/collections/create.d.ts

@@ -18,7 +18,7 @@ export declare const createCollectionDocument: import("@tanstack/react-start").R
     path?: string;
     availableLocales?: string[];
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     documentId: string;
     documentVersionId: string;
 }>>;

package/dist/server-fns/collections/delete.d.ts

@@ -12,6 +12,6 @@ export declare const deleteDocument: import("@tanstack/react-start").RequiredFet
     collection: string;
     id: string;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     deletedVersionCount: number;
 }>>;

package/dist/server-fns/collections/get.d.ts

@@ -16,10 +16,10 @@
  * `{target_document_id, target_collection_id}` refs.
  */
 export declare function getCollectionDocument(collection: string, id: string, locale?: string, depth?: number, populateRelations?: boolean): Promise<{
-    _availableVersionLocales?: string[] | undefined;
-    availableLocales?: string[] | undefined;
-    _restoreWarnings?: string[] | undefined;
     _publishedVersion: Record<string, any> | null;
+    _restoreWarnings?: string[] | undefined;
+    availableLocales?: string[] | undefined;
+    _availableVersionLocales?: string[] | undefined;
 } | null>;
 /**
  * Fetch a specific historical version of a document. Returns `null` when the

package/dist/server-fns/collections/history.d.ts

@@ -22,19 +22,18 @@ export declare const getCollectionDocumentHistory: import("@tanstack/react-start
     id: string;
     params: HistorySearchParams;
 }, Promise<{
-    actors: ActorLabelMap;
     docs: {
-        fields: Record<string, any>;
         id: string;
-        status: string;
-        createdAt: string;
-        updatedAt: string;
         versionId?: string | undefined;
         path?: string | undefined;
         sourceLocale?: string | undefined;
+        status: string;
         hasPublishedVersion?: boolean | undefined;
+        createdAt: string;
+        updatedAt: string;
         createdBy?: string | undefined;
         eventType?: string | undefined;
+        fields: Record<string, any>;
     }[];
     meta: {
         page: number;
@@ -44,4 +43,5 @@ export declare const getCollectionDocumentHistory: import("@tanstack/react-start
         order?: string | undefined;
         desc?: boolean | undefined;
     };
+    actors: ActorLabelMap;
 }>>;

package/dist/server-fns/collections/list.d.ts

@@ -23,17 +23,17 @@ export declare const getCollectionDocuments: import("@tanstack/react-start").Req
     params: CollectionSearchParams;
 }, Promise<{
     docs: {
-        fields: Record<string, any>;
         id: string;
-        status: string;
-        createdAt: string;
-        updatedAt: string;
         versionId?: string | undefined;
         path?: string | undefined;
         sourceLocale?: string | undefined;
+        status: string;
         hasPublishedVersion?: boolean | undefined;
+        createdAt: string;
+        updatedAt: string;
         createdBy?: string | undefined;
         eventType?: string | undefined;
+        fields: Record<string, any>;
     }[];
     meta: {
         page: number;

package/dist/server-fns/collections/reorder.d.ts

@@ -16,6 +16,6 @@ export declare const reorderCollectionDocument: import("@tanstack/react-start").
     beforeDocumentId?: string | null;
     afterDocumentId?: string | null;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     orderKey: string;
 }>>;

package/dist/server-fns/collections/restore-version.d.ts

@@ -14,7 +14,7 @@ export declare const restoreDocumentVersion: import("@tanstack/react-start").Req
     id: string;
     versionId: string;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     documentId: string;
     documentVersionId: string;
     sourceVersionId: string;

package/dist/server-fns/collections/status.d.ts

@@ -14,7 +14,7 @@ export declare const updateDocumentStatus: import("@tanstack/react-start").Requi
     id: string;
     status: string;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     previousStatus: string;
     newStatus: string;
 }>>;
@@ -25,6 +25,6 @@ export declare const unpublishDocument: import("@tanstack/react-start").Required
     collection: string;
     id: string;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     archivedCount: number;
 }>>;

package/dist/server-fns/collections/tree.d.ts

@@ -18,7 +18,7 @@ export declare const placeTreeNode: import("@tanstack/react-start").RequiredFetc
     beforeDocumentId?: string | null;
     afterDocumentId?: string | null;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
     orderKey: string;
 }>>;
 export declare const removeFromTree: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
@@ -28,7 +28,7 @@ export declare const removeFromTree: import("@tanstack/react-start").RequiredFet
     collection: string;
     documentId: string;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
 }>>;
 export declare const getTreeAncestors: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
     collection: string;

package/dist/server-fns/collections/update.d.ts

@@ -19,7 +19,7 @@ export declare const updateCollectionDocumentWithPatches: import("@tanstack/reac
     versionId?: string;
     locale?: string;
 }, Promise<{
-    status: "ok";
+    status: 'ok';
 }>>;
 export declare const updateCollectionDocumentSystemFields: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
     collection: string;
@@ -38,5 +38,5 @@ export declare const updateCollectionDocumentSystemFields: import("@tanstack/rea
     /** Editorial advertised-locale set; omitted means no advertised-locale write. */
     availableLocales?: string[];
 }, Promise<{
-    status: "ok";
+    status: 'ok';
 }>>;

package/dist/server-fns/collections/upload.js

@@ -25,7 +25,7 @@ function parseUploadFormData(data) {
         fields
     };
 }
-function resolveUploadFieldName(definition, collectionPath, requested) {
+function resolveUploadField(definition, collectionPath, requested) {
     const candidates = getUploadFields(definition);
     if (requested) {
         const match = candidates.find((f)=>f.name === requested);
@@ -37,9 +37,9 @@ function resolveUploadFieldName(definition, collectionPath, requested) {
                 available: candidates.map((f)=>f.name)
             }
         });
-        return match.name;
+        return match;
     }
-    if (1 === candidates.length) return candidates[0].name;
+    if (1 === candidates.length) return candidates[0];
     if (0 === candidates.length) throw ERR_VALIDATION({
         message: `Collection '${collectionPath}' has no upload-capable image/file field. Add an 'upload' block to one of its image/file fields.`,
         details: {
@@ -72,10 +72,9 @@ const uploadCollectionField = createServerFn({
             }
         }, uploadCollectionField).log(logger);
         const serverConfig = getServerConfig();
-        const resolvedFieldName = resolveUploadFieldName(config.definition, collectionPath, fieldName);
-        const targetField = config.definition.fields.find((f)=>f.name === resolvedFieldName);
+        const targetField = resolveUploadField(config.definition, collectionPath, fieldName);
         const storage = targetField.upload?.storage ?? serverConfig.storage;
-        if (!storage) throw new Error(`No storage provider configured for field '${resolvedFieldName}' on collection '${collectionPath}'. Set either field.upload.storage or the site-wide ServerConfig.storage.`);
+        if (!storage) throw new Error(`No storage provider configured for field '${targetField.name}' on collection '${collectionPath}'. Set either field.upload.storage or the site-wide ServerConfig.storage.`);
         let buffer;
         try {
             buffer = Buffer.from(await file.arrayBuffer());
@@ -92,7 +91,7 @@ const uploadCollectionField = createServerFn({
             collectionId: config.collection.id,
             collectionVersion: config.collection.version,
             collectionPath,
-            fieldName: resolvedFieldName,
+            fieldName: targetField.name,
             storage,
             logger,
             defaultLocale: serverConfig.i18n.content.defaultLocale,

package/dist/server-fns/preview/disable.d.ts

@@ -6,6 +6,6 @@
  * Copyright (c) Infonomic Company Limited
  */
 export declare const disablePreviewModeFn: import("@tanstack/react-start").OptionalFetcher<undefined, undefined, Promise<{
-    status: "ok";
+    status: 'ok';
     preview: false;
 }>>;

package/dist/server-fns/preview/enable.d.ts

@@ -6,6 +6,6 @@
  * Copyright (c) Infonomic Company Limited
  */
 export declare const enablePreviewModeFn: import("@tanstack/react-start").OptionalFetcher<undefined, undefined, Promise<{
-    status: "ok";
+    status: 'ok';
     preview: true;
 }>>;

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "3.17.0",
+  "version": "3.18.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -117,15 +117,15 @@
     "npm-run-all": "^4.1.5",
     "react-json-view-lite": "^2.5.0",
     "react-swipeable": "^7.0.2",
-    "uuid": "^14.0.0",
+    "uuid": "^14.0.1",
     "zod": "^4.4.3",
-    "@byline/admin": "3.17.0",
-    "@byline/auth": "3.17.0",
-    "@byline/core": "3.17.0",
-    "@byline/client": "3.17.0",
-    "@byline/ui": "3.17.0",
-    "@byline/i18n": "3.17.0",
-    "@byline/ai": "3.17.0"
+    "@byline/admin": "3.18.0",
+    "@byline/ai": "3.18.0",
+    "@byline/client": "3.18.0",
+    "@byline/core": "3.18.0",
+    "@byline/auth": "3.18.0",
+    "@byline/i18n": "3.18.0",
+    "@byline/ui": "3.18.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",
@@ -134,21 +134,21 @@
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.15",
-    "@rsbuild/plugin-react": "^2.0.0",
-    "@rslib/core": "^0.21.5",
-    "@tanstack/react-router": "^1.170.15",
-    "@tanstack/react-start": "^1.168.25",
-    "@types/node": "^25.9.1",
-    "@types/react": "19.2.15",
+    "@biomejs/biome": "2.5.2",
+    "@rsbuild/plugin-react": "^2.1.0",
+    "@rslib/core": "^0.23.2",
+    "@tanstack/react-router": "^1.170.17",
+    "@tanstack/react-start": "^1.168.27",
+    "@types/node": "^26.1.0",
+    "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
     "lightningcss": "^1.32.0",
-    "react": "19.2.6",
-    "react-dom": "19.2.6",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "rimraf": "^6.1.3",
-    "typescript": "6.0.3",
+    "typescript": "^7.0.2",
     "typescript-plugin-css-modules": "^5.2.0",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.10"
   },
   "publishConfig": {
     "access": "public",

package/src/server-fns/collections/upload.ts

@@ -84,16 +84,17 @@ function parseUploadFormData(data: FormData): UploadDocumentInput {
  * wins; otherwise default to the unique upload-capable field. Throws
  * `ERR_VALIDATION` when the request is ambiguous.
  *
- * Walks `definition.fields` only (not nested `group` / `array` /
- * `blocks`) — top-level upload fields are the supported case for the
- * transport today. Nested-field uploads remain available via the core
- * service when wired into a custom transport.
+ * Candidates come from `getUploadFields`, which recurses into `group` /
+ * `array` / `blocks` — upload fields nested in repeating structures are
+ * addressed by their leaf field name. Note the ambiguity fallback counts
+ * nested fields too: a collection whose only extra upload field is
+ * nested still requires an explicit `field` selector.
  */
-function resolveUploadFieldName(
+function resolveUploadField(
   definition: CollectionDefinition,
   collectionPath: string,
   requested: string | null
-): string {
+): ImageField | FileField {
   const candidates = getUploadFields(definition)
 
   if (requested) {
@@ -110,10 +111,10 @@ function resolveUploadFieldName(
         },
       })
     }
-    return match.name
+    return match
   }
 
-  if (candidates.length === 1) return candidates[0].name
+  if (candidates.length === 1) return candidates[0]
 
   if (candidates.length === 0) {
     throw ERR_VALIDATION({
@@ -167,19 +168,12 @@ export const uploadCollectionField = createServerFn({ method: 'POST' })
         }
 
         const serverConfig = getServerConfig()
-        const resolvedFieldName = resolveUploadFieldName(
-          config.definition,
-          collectionPath,
-          fieldName
-        )
-        const targetField = config.definition.fields.find((f) => f.name === resolvedFieldName) as
-          | ImageField
-          | FileField
+        const targetField = resolveUploadField(config.definition, collectionPath, fieldName)
         // Per-field storage routing falls through to the site-wide default.
         const storage = targetField.upload?.storage ?? serverConfig.storage
         if (!storage) {
           throw new Error(
-            `No storage provider configured for field '${resolvedFieldName}' on collection ` +
+            `No storage provider configured for field '${targetField.name}' on collection ` +
               `'${collectionPath}'. Set either field.upload.storage or the site-wide ` +
               'ServerConfig.storage.'
           )
@@ -199,7 +193,7 @@ export const uploadCollectionField = createServerFn({ method: 'POST' })
           collectionId: config.collection.id,
           collectionVersion: config.collection.version,
           collectionPath,
-          fieldName: resolvedFieldName,
+          fieldName: targetField.name,
           storage,
           logger,
           defaultLocale: serverConfig.i18n.content.defaultLocale,