feat(workflows): add metadata handling for collection flow URL

- Introduce optional metadata object for workflows
- Implement functionality to copy the collection flow link to clipboard
- Update case options UI to support new features

(Your error messages are so friendly, they deserve an 'I'm sorry' button)

Author: alonp99

apps/backoffice-v2/src/domains/workflows/fetchers.ts

@@ -68,6 +68,12 @@ export const BaseWorkflowByIdSchema = z.object({
       vendor: z.string().optional(),
     }).optional(),
     documents: z.array(z.any()).default([]),
+    metadata: z
+      .object({
+        collectionFlowUrl: z.string().url().optional(),
+        token: z.string().optional(),
+      })
+      .optional(),
     entity: z.record(z.any(), z.any()),
     parentMachine: ObjectWithIdSchema.extend({
       status: z.union([z.literal('active'), z.literal('failed'), z.literal('completed')]),

apps/backoffice-v2/src/pages/Entity/components/Case/components/CaseOptions/CaseOptions.tsx

@@ -4,23 +4,45 @@ import { DropdownMenuContent } from '@/common/components/molecules/DropdownMenu/
 import { DropdownMenuItem } from '@/common/components/molecules/DropdownMenu/DropdownMenu.Item';
 import { DropdownMenuTrigger } from '@/common/components/molecules/DropdownMenu/DropdownMenu.Trigger';
 import { useCaseOptionsLogic } from '@/pages/Entity/components/Case/components/CaseOptions/hooks/useCaseOptionsLogic/useCaseOptionsLogic';
+import { FileText, Link, MoreVertical } from 'lucide-react';
 
 export const CaseOptions = () => {
-  const { isGeneratingPDF, generateAndOpenPDFInNewTab } = useCaseOptionsLogic();
+  const {
+    isGeneratingPDF,
+    generateAndOpenPDFInNewTab,
+    isCopyingCollectionFlowLink,
+    copyCollectionFlowLink,
+  } = useCaseOptionsLogic();
 
   return (
     <DropdownMenu>
       <DropdownMenuTrigger asChild>
-        <Button variant="outline">Options</Button>
+        <Button variant="outline">
+          <MoreVertical size={23} />
+        </Button>
       </DropdownMenuTrigger>
       <DropdownMenuContent align="end">
-        <DropdownMenuItem className="px-8 py-1" asChild>
+        <DropdownMenuItem className="w-full px-8 py-1" asChild>
           <Button
             onClick={() => generateAndOpenPDFInNewTab()}
             disabled={isGeneratingPDF}
             variant={'ghost'}
+            className="justify-start"
           >
-            Open PDF Certificate
+            <FileText size={18} className="mr-2" /> Open PDF Certificate
+          </Button>
+        </DropdownMenuItem>
+        <DropdownMenuItem
+          className={`w-full px-8 py-1 ${isCopyingCollectionFlowLink ? 'hidden' : ''}`}
+          asChild
+        >
+          <Button
+            onClick={() => copyCollectionFlowLink()}
+            disabled={isCopyingCollectionFlowLink}
+            variant={'ghost'}
+            className="justify-start"
+          >
+            <Link size={18} className="mr-2" /> Copy Collection Flow Link
           </Button>
         </DropdownMenuItem>
       </DropdownMenuContent>

apps/backoffice-v2/src/pages/Entity/components/Case/components/CaseOptions/hooks/useCaseOptionsLogic/mutations/copyingCollectionFlowLinkMutation.tsx

@@ -0,0 +1,23 @@
+import { TWorkflowById } from '@/domains/workflows/fetchers';
+import { useMutation } from '@tanstack/react-query';
+import { toast } from 'sonner';
+
+export const useCopyCollectionFlowLinkMutation = ({ workflow }: { workflow: TWorkflowById }) => {
+  return useMutation({
+    mutationFn: async () => {
+      if (!workflow?.context?.metadata?.collectionFlowUrl || !workflow?.context?.metadata?.token) {
+        throw new Error('Collection flow URL or token not available');
+      }
+
+      const url = `${workflow.context.metadata.collectionFlowUrl}?token=${workflow.context.metadata.token}`;
+      await navigator.clipboard.writeText(url);
+    },
+    onSuccess: () => {
+      toast.success('Collection flow link copied to clipboard');
+    },
+    onError: error => {
+      console.error('Failed to copy collection flow link:', error);
+      toast.error('Failed to copy collection flow link');
+    },
+  });
+};

apps/backoffice-v2/src/pages/Entity/components/Case/components/CaseOptions/hooks/useCaseOptionsLogic/useCaseOptionsLogic.tsx

@@ -1,6 +1,7 @@
 import { useCustomerQuery } from '@/domains/customer/hooks/queries/useCustomerQuery/useCustomerQuery';
 import { useCurrentCaseQuery } from '@/pages/Entity/hooks/useCurrentCaseQuery/useCurrentCaseQuery';
 import { useGeneratePDFMutation } from '@/pages/Entity/components/Case/components/CaseOptions/hooks/useCaseOptionsLogic/mutations/useGeneratePDFMutation/useGeneratePDFMutation';
+import { useCopyCollectionFlowLinkMutation } from './mutations/CopyingCollectionFlowLinkMutation';
 
 export const useCaseOptionsLogic = () => {
   const { data: workflow } = useCurrentCaseQuery();
@@ -9,9 +10,17 @@ export const useCaseOptionsLogic = () => {
     workflow,
     customer,
   });
+  const { mutate: copyCollectionFlowLink } = useCopyCollectionFlowLinkMutation({
+    workflow,
+  });
+
+  const isCopyingCollectionFlowLink =
+    !workflow?.context?.metadata?.collectionFlowUrl || !workflow?.context?.metadata?.token;
 
   return {
     isGeneratingPDF: isLoading,
     generateAndOpenPDFInNewTab,
+    isCopyingCollectionFlowLink,
+    copyCollectionFlowLink,
   };
 };