@byline/host-tanstack-start 1.3.1 → 1.6.0

package/dist/admin-shell/collections/edit.js

@@ -82,6 +82,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
         }
     };
     const publishedVersion = initialData?._publishedVersion ?? null;
+    const restoreWarnings = initialData?._restoreWarnings;
     const handleUnpublish = async ()=>{
         try {
             await unpublishDocument({
@@ -262,6 +263,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 onUnpublish: publishedVersion ? handleUnpublish : void 0,
                 onDelete: handleDelete,
                 publishedVersion: publishedVersion,
+                restoreWarnings: restoreWarnings,
                 nextStatus: nextStatus,
                 workflowStatuses: workflowStatuses,
                 onCancel: ()=>navigate({

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

@@ -16,6 +16,7 @@
  * `{target_document_id, target_collection_id}` refs.
  */
 export declare function getCollectionDocument(collection: string, id: string, locale?: string, depth?: number, populateRelations?: boolean): Promise<{
+    _restoreWarnings?: string[] | undefined;
     _publishedVersion: Record<string, any> | null;
 } | null>;
 /**

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

@@ -38,7 +38,8 @@ const getDocumentFn = createServerFn({
         locale: locale ?? 'en',
         populate,
         depth: resolvedDepth,
-        status: 'any'
+        status: 'any',
+        lenient: true
     });
     if (!document) throw ERR_NOT_FOUND({
         message: 'Document not found',
@@ -67,9 +68,13 @@ const getDocumentFn = createServerFn({
             updatedAt: pv.updated_at
         }) : null;
     }
+    const restoreWarnings = serialised._restoreWarnings;
     return {
         ...parsed,
-        _publishedVersion: publishedVersion
+        _publishedVersion: publishedVersion,
+        ...restoreWarnings && restoreWarnings.length > 0 ? {
+            _restoreWarnings: restoreWarnings
+        } : {}
     };
 });
 const getDocumentByVersionFn = createServerFn({

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "1.3.1",
+  "version": "1.6.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -101,11 +101,11 @@
     "react-swipeable": "^7.0.2",
     "uuid": "^14.0.0",
     "zod": "^4.4.2",
-    "@byline/admin": "1.3.1",
-    "@byline/client": "1.4.0",
-    "@byline/core": "1.4.0",
-    "@byline/auth": "1.3.0",
-    "@byline/ui": "1.3.1"
+    "@byline/auth": "1.6.0",
+    "@byline/core": "1.6.0",
+    "@byline/admin": "1.6.0",
+    "@byline/client": "1.6.0",
+    "@byline/ui": "1.6.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",

package/src/admin-shell/collections/edit.tsx

@@ -119,6 +119,13 @@ export const EditView = ({
   // biome-ignore lint/suspicious/noExplicitAny: storage shape
   const publishedVersion = (initialData as any)?._publishedVersion ?? null
 
+  // Schema-mismatch warnings — attached by getCollectionDocument when the
+  // document was loaded leniently (admin edit path) and at least one
+  // orphan row was skipped because the collection schema has moved on
+  // since the document was written.
+  // biome-ignore lint/suspicious/noExplicitAny: storage shape
+  const restoreWarnings = (initialData as any)?._restoreWarnings as string[] | undefined
+
   const handleUnpublish = async () => {
     try {
       await unpublishDocument({ data: { collection: path, id: String(initialData.id) } })
@@ -302,6 +309,7 @@ export const EditView = ({
           onUnpublish={publishedVersion ? handleUnpublish : undefined}
           onDelete={handleDelete}
           publishedVersion={publishedVersion}
+          restoreWarnings={restoreWarnings}
           nextStatus={nextStatus}
           workflowStatuses={workflowStatuses}
           onCancel={() =>

package/src/admin-shell/collections/preview-link.tsx

@@ -25,10 +25,12 @@
  * document yet, so offering a preview link would just lead to a 404.
  *
  * The component does not load the document itself. Callers pass the
- * already-loaded `doc` from their route loader. If `preview.populate`
- * is configured, it's the loader's responsibility to apply that hint
- * when fetching the document so `url(doc, ctx)` sees the resolved
- * relation values it expects (e.g. `doc.fields.area?.document?.path`).
+ * already-loaded `doc` from their route loader. The edit-view loader
+ * applies a blanket depth-1 populate (picker projection) so direct
+ * relation targets are available as `doc.fields.<name>?.document` —
+ * `url(doc, ctx)` inherits that populated tree without further work.
+ * Deeper hops or fields outside the picker projection are not available;
+ * see `CollectionAdminConfig.preview` for the full contract.
  *
  * Two-step "enable cookie then navigate" intentionally avoids the
  * Payload-style `/routes/draft?url=...&secret=...` redirect handler:

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

@@ -88,6 +88,10 @@ const getDocumentFn = createServerFn({ method: 'GET' })
       populate,
       depth: resolvedDepth,
       status: 'any',
+      // Admin edit path: tolerate schema-mismatch warnings rather than
+      // hard-failing the load. Warnings (if any) come back on the document
+      // as `_restoreWarnings` and the edit form surfaces them via an Alert.
+      lenient: true,
     })
 
     if (!document) {
@@ -136,7 +140,21 @@ const getDocumentFn = createServerFn({ method: 'GET' })
         : null
     }
 
-    return { ...(parsed as Record<string, any>), _publishedVersion: publishedVersion }
+    // Preserve `_restoreWarnings` across the Zod parse — the parse strips
+    // unknown keys, so the warnings list (set by `findById({ lenient: true })`
+    // when older rows can't be reconstructed against the current schema)
+    // would otherwise be lost before reaching the edit form.
+    const restoreWarnings = (serialised as Record<string, any>)._restoreWarnings as
+      | string[]
+      | undefined
+
+    return {
+      ...(parsed as Record<string, any>),
+      _publishedVersion: publishedVersion,
+      ...(restoreWarnings && restoreWarnings.length > 0
+        ? { _restoreWarnings: restoreWarnings }
+        : {}),
+    }
   })
 
 // ---------------------------------------------------------------------------