@byline/host-tanstack-start 1.9.0 → 1.10.0

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

@@ -2,7 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import { useState } from "react";
 import { getDefaultStatus, getWorkflowStatuses } from "@byline/core";
 import { Container, FormRenderer, Section, useToastManager } from "@byline/ui/react";
-import { deleteDocument, unpublishDocument, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
+import { copyDocumentToLocale, deleteDocument, duplicateCollectionDocument, unpublishDocument, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
 import { useTanStackNavigationGuard } from "./tanstack-navigation-guard.js";
 import { ViewMenu } from "./view-menu.js";
@@ -133,6 +133,108 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
         }
     };
+    const handleDuplicate = async ()=>{
+        try {
+            const result = await duplicateCollectionDocument({
+                data: {
+                    collection: path,
+                    id: String(initialData.id)
+                }
+            });
+            toastManager.add({
+                title: `${labels.singular} Duplicated`,
+                description: result.pathRetried ? `Created with auto-generated path "${result.newPath}" (the preferred slug was already in use).` : `Created with path "${result.newPath}". Update the title and path in the new document.`,
+                data: {
+                    intent: 'success',
+                    iconType: 'success',
+                    icon: true,
+                    close: true
+                }
+            });
+            setEditState({
+                status: 'success',
+                message: `${labels.singular} duplicated.`
+            });
+            navigate({
+                to: '/admin/collections/$collection/$id',
+                params: {
+                    collection: path,
+                    id: result.documentId
+                }
+            });
+        } catch (err) {
+            console.error('Duplicate error:', err);
+            toastManager.add({
+                title: `${labels.singular} Duplicate`,
+                description: `Failed to duplicate: ${err.message}`,
+                data: {
+                    intent: 'danger',
+                    iconType: 'danger',
+                    icon: true,
+                    close: true
+                }
+            });
+            setEditState({
+                status: 'failed',
+                message: `Failed to duplicate: ${err.message}`
+            });
+        }
+    };
+    const handleCopyToLocale = async ({ targetLocale, overwrite })=>{
+        try {
+            const result = await copyDocumentToLocale({
+                data: {
+                    collection: path,
+                    id: String(initialData.id),
+                    sourceLocale: locale ?? defaultContentLocale,
+                    targetLocale,
+                    overwrite
+                }
+            });
+            const sourceLabel = contentLocales.find((l)=>l.code === result.sourceLocale)?.label ?? result.sourceLocale;
+            const targetLabel = contentLocales.find((l)=>l.code === result.targetLocale)?.label ?? result.targetLocale;
+            toastManager.add({
+                title: `${labels.singular} Copy to Locale`,
+                description: result.fieldsUpdated > 0 ? `Copied ${result.fieldsUpdated} field${1 === result.fieldsUpdated ? '' : 's'} from ${sourceLabel} to ${targetLabel}.` : `No fields needed copying from ${sourceLabel} to ${targetLabel} under the current rule.`,
+                data: {
+                    intent: 'success',
+                    iconType: 'success',
+                    icon: true,
+                    close: true
+                }
+            });
+            setEditState({
+                status: 'success',
+                message: `Copied ${sourceLabel} → ${targetLabel}.`
+            });
+            navigate({
+                to: '/admin/collections/$collection/$id',
+                params: {
+                    collection: path,
+                    id: String(initialData.id)
+                },
+                search: {
+                    locale: targetLocale
+                }
+            });
+        } catch (err) {
+            console.error('Copy to locale error:', err);
+            toastManager.add({
+                title: `${labels.singular} Copy to Locale`,
+                description: `Failed to copy: ${err.message}`,
+                data: {
+                    intent: 'danger',
+                    iconType: 'danger',
+                    icon: true,
+                    close: true
+                }
+            });
+            setEditState({
+                status: 'failed',
+                message: `Failed to copy: ${err.message}`
+            });
+        }
+    };
     const handleDelete = async ()=>{
         try {
             await deleteDocument({
@@ -262,6 +364,9 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 onStatusChange: handleStatusChange,
                 onUnpublish: publishedVersion ? handleUnpublish : void 0,
                 onDelete: handleDelete,
+                onDuplicate: handleDuplicate,
+                onCopyToLocale: handleCopyToLocale,
+                contentLocales: contentLocales,
                 publishedVersion: publishedVersion,
                 restoreWarnings: restoreWarnings,
                 nextStatus: nextStatus,

package/dist/server-fns/collections/copy-to-locale.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { CopyToLocaleResult } from '@byline/core/services';
+/**
+ * Copy a document's content from `sourceLocale` into `targetLocale` on
+ * the same document. Mirrors the thin-wrapper pattern of the other
+ * collection server fns: resolve the request context, build the
+ * lifecycle context, delegate to the `copyToLocale` service.
+ *
+ * `assertActorCanPerform('update')` runs inside the service; auth
+ * failures propagate to TanStack Start's transport layer.
+ */
+export declare const copyDocumentToLocale: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    collection: string;
+    id: string;
+    sourceLocale: string;
+    targetLocale: string;
+    overwrite: boolean;
+}) => {
+    collection: string;
+    id: string;
+    sourceLocale: string;
+    targetLocale: string;
+    overwrite: boolean;
+}, Promise<CopyToLocaleResult>>;

package/dist/server-fns/collections/copy-to-locale.js

@@ -0,0 +1,37 @@
+import { createServerFn } from "@tanstack/react-start";
+import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
+import { copyToLocale } from "@byline/core/services";
+import { getAdminRequestContext } from "../../auth/auth-context.js";
+import { ensureCollection } from "../../integrations/api-utils.js";
+const copyDocumentToLocale = createServerFn({
+    method: 'POST'
+}).inputValidator((input)=>input).handler(async ({ data: input })=>{
+    const { collection: path, id, sourceLocale, targetLocale, overwrite } = input;
+    const logger = getLogger();
+    const config = await ensureCollection(path);
+    if (!config) throw ERR_NOT_FOUND({
+        message: 'Collection not found',
+        details: {
+            collectionPath: path
+        }
+    }).log(logger);
+    const serverConfig = getServerConfig();
+    const ctx = {
+        db: serverConfig.db,
+        definition: config.definition,
+        collectionId: config.collection.id,
+        collectionVersion: config.collection.version,
+        collectionPath: path,
+        logger,
+        defaultLocale: serverConfig.i18n.content.defaultLocale,
+        slugifier: serverConfig.slugifier,
+        requestContext: await getAdminRequestContext()
+    };
+    return copyToLocale(ctx, {
+        documentId: id,
+        sourceLocale,
+        targetLocale,
+        overwrite
+    });
+});
+export { copyDocumentToLocale };

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

@@ -0,0 +1,26 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { DuplicateDocumentResult } from '@byline/core/services';
+/**
+ * Duplicate an existing document — clones all locales into a brand-new
+ * document in one atomic write. Returns the new document's id so the UI
+ * can navigate straight to its edit view.
+ *
+ * Mirrors the thin-wrapper pattern of the other collection server fns:
+ * resolve the request context from session cookies, build the lifecycle
+ * context, delegate to the `duplicateDocument` service. The service runs
+ * `assertActorCanPerform(..., 'create')`; any auth failure propagates to
+ * TanStack Start's transport layer for the client to branch on.
+ */
+export declare const duplicateCollectionDocument: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    collection: string;
+    id: string;
+}) => {
+    collection: string;
+    id: string;
+}, Promise<DuplicateDocumentResult>>;

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

@@ -0,0 +1,34 @@
+import { createServerFn } from "@tanstack/react-start";
+import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
+import { duplicateDocument } from "@byline/core/services";
+import { getAdminRequestContext } from "../../auth/auth-context.js";
+import { ensureCollection } from "../../integrations/api-utils.js";
+const duplicateCollectionDocument = createServerFn({
+    method: 'POST'
+}).inputValidator((input)=>input).handler(async ({ data: input })=>{
+    const { collection: path, id: sourceDocumentId } = input;
+    const logger = getLogger();
+    const config = await ensureCollection(path);
+    if (!config) throw ERR_NOT_FOUND({
+        message: 'Collection not found',
+        details: {
+            collectionPath: path
+        }
+    }).log(logger);
+    const serverConfig = getServerConfig();
+    const ctx = {
+        db: serverConfig.db,
+        definition: config.definition,
+        collectionId: config.collection.id,
+        collectionVersion: config.collection.version,
+        collectionPath: path,
+        logger,
+        defaultLocale: serverConfig.i18n.content.defaultLocale,
+        slugifier: serverConfig.slugifier,
+        requestContext: await getAdminRequestContext()
+    };
+    return duplicateDocument(ctx, {
+        sourceDocumentId
+    });
+});
+export { duplicateCollectionDocument };

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

@@ -4,8 +4,10 @@
  * Each module is self-contained: it defines the TanStack Start server
  * function and exports a clean public API.
  */
+export * from './copy-to-locale';
 export * from './create';
 export * from './delete';
+export * from './duplicate';
 export * from './get';
 export * from './history';
 export * from './list';

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

@@ -1,5 +1,7 @@
+export * from "./copy-to-locale.js";
 export * from "./create.js";
 export * from "./delete.js";
+export * from "./duplicate.js";
 export * from "./get.js";
 export * from "./history.js";
 export * from "./list.js";

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -105,12 +105,12 @@
     "react-swipeable": "^7.0.2",
     "uuid": "^14.0.0",
     "zod": "^4.4.2",
-    "@byline/admin": "1.9.0",
-    "@byline/ai": "1.9.0",
-    "@byline/client": "1.9.0",
-    "@byline/core": "1.9.0",
-    "@byline/auth": "1.9.0",
-    "@byline/ui": "1.9.0"
+    "@byline/admin": "1.10.0",
+    "@byline/auth": "1.10.0",
+    "@byline/core": "1.10.0",
+    "@byline/client": "1.10.0",
+    "@byline/ai": "1.10.0",
+    "@byline/ui": "1.10.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",

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

@@ -14,7 +14,9 @@ import type { AnyCollectionSchemaTypes } from '@byline/core/zod-schemas'
 import { Container, FormRenderer, Section, useToastManager } from '@byline/ui/react'
 
 import {
+  copyDocumentToLocale,
   deleteDocument,
+  duplicateCollectionDocument,
   unpublishDocument,
   updateCollectionDocumentWithPatches,
   updateDocumentStatus,
@@ -167,6 +169,115 @@ export const EditView = ({
     }
   }
 
+  const handleDuplicate = async () => {
+    try {
+      const result = await duplicateCollectionDocument({
+        data: { collection: path, id: String(initialData.id) },
+      })
+      toastManager.add({
+        title: `${labels.singular} Duplicated`,
+        description: result.pathRetried
+          ? `Created with auto-generated path "${result.newPath}" (the preferred slug was already in use).`
+          : `Created with path "${result.newPath}". Update the title and path in the new document.`,
+        data: {
+          intent: 'success',
+          iconType: 'success',
+          icon: true,
+          close: true,
+        },
+      })
+      setEditState({
+        status: 'success',
+        message: `${labels.singular} duplicated.`,
+      })
+      // Navigate to the new document's edit view.
+      navigate({
+        to: '/admin/collections/$collection/$id' as never,
+        params: { collection: path, id: result.documentId },
+      })
+    } catch (err) {
+      console.error('Duplicate error:', err)
+      toastManager.add({
+        title: `${labels.singular} Duplicate`,
+        description: `Failed to duplicate: ${(err as Error).message}`,
+        data: {
+          intent: 'danger',
+          iconType: 'danger',
+          icon: true,
+          close: true,
+        },
+      })
+      setEditState({
+        status: 'failed',
+        message: `Failed to duplicate: ${(err as Error).message}`,
+      })
+    }
+  }
+
+  const handleCopyToLocale = async ({
+    targetLocale,
+    overwrite,
+  }: {
+    targetLocale: string
+    overwrite: boolean
+  }) => {
+    try {
+      const result = await copyDocumentToLocale({
+        data: {
+          collection: path,
+          id: String(initialData.id),
+          sourceLocale: locale ?? defaultContentLocale,
+          targetLocale,
+          overwrite,
+        },
+      })
+      const sourceLabel =
+        contentLocales.find((l) => l.code === result.sourceLocale)?.label ?? result.sourceLocale
+      const targetLabel =
+        contentLocales.find((l) => l.code === result.targetLocale)?.label ?? result.targetLocale
+      toastManager.add({
+        title: `${labels.singular} Copy to Locale`,
+        description:
+          result.fieldsUpdated > 0
+            ? `Copied ${result.fieldsUpdated} field${result.fieldsUpdated === 1 ? '' : 's'} from ${sourceLabel} to ${targetLabel}.`
+            : `No fields needed copying from ${sourceLabel} to ${targetLabel} under the current rule.`,
+        data: {
+          intent: 'success',
+          iconType: 'success',
+          icon: true,
+          close: true,
+        },
+      })
+      setEditState({
+        status: 'success',
+        message: `Copied ${sourceLabel} → ${targetLabel}.`,
+      })
+      // Switch the form to the target locale so the editor sees the
+      // copied content immediately.
+      navigate({
+        to: '/admin/collections/$collection/$id' as never,
+        params: { collection: path, id: String(initialData.id) },
+        search: { locale: targetLocale },
+      })
+    } catch (err) {
+      console.error('Copy to locale error:', err)
+      toastManager.add({
+        title: `${labels.singular} Copy to Locale`,
+        description: `Failed to copy: ${(err as Error).message}`,
+        data: {
+          intent: 'danger',
+          iconType: 'danger',
+          icon: true,
+          close: true,
+        },
+      })
+      setEditState({
+        status: 'failed',
+        message: `Failed to copy: ${(err as Error).message}`,
+      })
+    }
+  }
+
   const handleDelete = async () => {
     try {
       await deleteDocument({ data: { collection: path, id: String(initialData.id) } })
@@ -308,6 +419,9 @@ export const EditView = ({
           onStatusChange={handleStatusChange}
           onUnpublish={publishedVersion ? handleUnpublish : undefined}
           onDelete={handleDelete}
+          onDuplicate={handleDuplicate}
+          onCopyToLocale={handleCopyToLocale}
+          contentLocales={contentLocales}
           publishedVersion={publishedVersion}
           restoreWarnings={restoreWarnings}
           nextStatus={nextStatus}

package/src/server-fns/collections/copy-to-locale.ts

@@ -0,0 +1,71 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+import { createServerFn } from '@tanstack/react-start'
+
+import { ERR_NOT_FOUND, getLogger, getServerConfig } from '@byline/core'
+import type { CopyToLocaleResult, DocumentLifecycleContext } from '@byline/core/services'
+import { copyToLocale } from '@byline/core/services'
+
+import { getAdminRequestContext } from '../../auth/auth-context.js'
+import { ensureCollection } from '../../integrations/api-utils.js'
+
+// ---------------------------------------------------------------------------
+// Copy document content from one locale into another
+// ---------------------------------------------------------------------------
+
+/**
+ * Copy a document's content from `sourceLocale` into `targetLocale` on
+ * the same document. Mirrors the thin-wrapper pattern of the other
+ * collection server fns: resolve the request context, build the
+ * lifecycle context, delegate to the `copyToLocale` service.
+ *
+ * `assertActorCanPerform('update')` runs inside the service; auth
+ * failures propagate to TanStack Start's transport layer.
+ */
+export const copyDocumentToLocale = createServerFn({ method: 'POST' })
+  .inputValidator(
+    (input: {
+      collection: string
+      id: string
+      sourceLocale: string
+      targetLocale: string
+      overwrite: boolean
+    }) => input
+  )
+  .handler(async ({ data: input }): Promise<CopyToLocaleResult> => {
+    const { collection: path, id, sourceLocale, targetLocale, overwrite } = input
+    const logger = getLogger()
+    const config = await ensureCollection(path)
+    if (!config) {
+      throw ERR_NOT_FOUND({
+        message: 'Collection not found',
+        details: { collectionPath: path },
+      }).log(logger)
+    }
+
+    const serverConfig = getServerConfig()
+    const ctx: DocumentLifecycleContext = {
+      db: serverConfig.db,
+      definition: config.definition,
+      collectionId: config.collection.id,
+      collectionVersion: config.collection.version,
+      collectionPath: path,
+      logger,
+      defaultLocale: serverConfig.i18n.content.defaultLocale,
+      slugifier: serverConfig.slugifier,
+      requestContext: await getAdminRequestContext(),
+    }
+
+    return copyToLocale(ctx, {
+      documentId: id,
+      sourceLocale,
+      targetLocale,
+      overwrite,
+    })
+  })

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

@@ -0,0 +1,60 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+
+import { createServerFn } from '@tanstack/react-start'
+
+import { ERR_NOT_FOUND, getLogger, getServerConfig } from '@byline/core'
+import type { DocumentLifecycleContext, DuplicateDocumentResult } from '@byline/core/services'
+import { duplicateDocument } from '@byline/core/services'
+
+import { getAdminRequestContext } from '../../auth/auth-context.js'
+import { ensureCollection } from '../../integrations/api-utils.js'
+
+// ---------------------------------------------------------------------------
+// Duplicate document
+// ---------------------------------------------------------------------------
+
+/**
+ * Duplicate an existing document — clones all locales into a brand-new
+ * document in one atomic write. Returns the new document's id so the UI
+ * can navigate straight to its edit view.
+ *
+ * Mirrors the thin-wrapper pattern of the other collection server fns:
+ * resolve the request context from session cookies, build the lifecycle
+ * context, delegate to the `duplicateDocument` service. The service runs
+ * `assertActorCanPerform(..., 'create')`; any auth failure propagates to
+ * TanStack Start's transport layer for the client to branch on.
+ */
+export const duplicateCollectionDocument = createServerFn({ method: 'POST' })
+  .inputValidator((input: { collection: string; id: string }) => input)
+  .handler(async ({ data: input }): Promise<DuplicateDocumentResult> => {
+    const { collection: path, id: sourceDocumentId } = input
+    const logger = getLogger()
+    const config = await ensureCollection(path)
+    if (!config) {
+      throw ERR_NOT_FOUND({
+        message: 'Collection not found',
+        details: { collectionPath: path },
+      }).log(logger)
+    }
+
+    const serverConfig = getServerConfig()
+    const ctx: DocumentLifecycleContext = {
+      db: serverConfig.db,
+      definition: config.definition,
+      collectionId: config.collection.id,
+      collectionVersion: config.collection.version,
+      collectionPath: path,
+      logger,
+      defaultLocale: serverConfig.i18n.content.defaultLocale,
+      slugifier: serverConfig.slugifier,
+      requestContext: await getAdminRequestContext(),
+    }
+
+    return duplicateDocument(ctx, { sourceDocumentId })
+  })

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

@@ -5,8 +5,10 @@
  * function and exports a clean public API.
  */
 
+export * from './copy-to-locale'
 export * from './create'
 export * from './delete'
+export * from './duplicate'
 export * from './get'
 export * from './history'
 export * from './list'