共享与链接

// The page a link goes to: app/shared/page.tsx
'use client';
import { SharedLink } from '@rebofiles/react';
import { useSearchParams } from 'next/navigation';

export default function Shared() {
  return <SharedLink base="/api/files" token={useSearchParams().get('link') ?? ''} />;
}

// And in the drive, where its links point:
<FileDrive base="/api/files" linkAddress={(token) => `${origin}/shared?link=${token}`} />

await client.share(folder.id, 'auditor', 'viewer', 30);   // for thirty days, then nothing
await client.share(folder.id, 'auditor', 'editor');       // another role: the same end
await client.share(folder.id, 'auditor', 'editor', null); // for good

// A request for files: whoever opens it sends them, and sees nothing of what is there.
const { token } = await client.createLink(folder.id, 7, {
  uploads: 'only', // or 'also': they see the folder, and may add to it
  request: {
    title: 'Northwind',
    message: 'Send what is missing, please.',
    askName: true,
    email: 'carla@northwind.com',                    // for your app to remind her, and send a receipt
    items: [{ id: 'contract', label: 'Signed contract' }, { id: 'id', label: 'ID' }],
    closeWhenDone: true,                             // closed once both came
    accept: ['application/pdf', 'image/*'],
    maxSize: 25 * 1024 * 1024,
    perSender: true,                                 // Northwind papers / Carla Ruiz / …
    rename: '{item} - {name}',                       // "Signed contract - Carla Ruiz.pdf"
    fields: { client: 'northwind' },                 // found by your CRM with withField
  },
});

createDriveHandler({
  ...options,
  onReceived: ({ entry, from, item, request, got }) => mail(request?.email, `Received: ${item}`),
  onReview: ({ entry, status, reason, from }) => status === 'rejected' && tellToSendAgain(from, reason),
});
// A cron of yours: GET /admin/requests gives every request open, whom it was sent to and what is missing.

import { createDriveHandler, mailReminders, resend } from '@rebofiles/server';

createDriveHandler({
  ...options,
  // Whom a request was sent to, reminded every `remind` days of what is missing, and with "Remind now".
  reminders: mailReminders({
    mail: resend({ apiKey: process.env.RESEND_KEY!, from: 'Acme <files@acme.com>' }), // or (mail) => yourSmtp(mail)
    url: (token) => `https://files.acme.com/?link=${token}`,
  }),
  // Told 15 days before a file's field `expires`, in the bell and here; `false` for none.
  expiring: { days: 15, onExpiring: ({ entry, expires }) => log(entry.name, expires) },
  // What is written in what came, against its document's words and patterns: the core's, yours, or false.
  // check: async ({ entry, item, text }) => ({ missing: [], fields: await readWithYourService(text) }),
});

await client.createLink(folder.id, 30, {
  uploads: 'only',
  request: {
    email: 'carla@northwind.com',
    remind: 3,
    items: [
      { id: 'id', label: 'ID', words: ['INE', 'passport'], expires: true },
      { id: 'tax', label: 'Tax certificate', find: { rfc: '\\b([A-Z&Ñ]{3,4}\\d{6}[A-Z0-9]{3})\\b' } },
    ],
  },
});

// Templates, for everyone of the drive: saved from the dialog, or given as the defaults.
createDriveHandler({ ...options, settings: { requestTemplates: [{ id: 'supplier', name: 'Supplier sign-up', request }] } });