@carlonicora/nextjs-jsonapi 5.2.0 → 5.4.0

package/dist/types-l8SFleXi.d.ts

@@ -0,0 +1,39 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { P as PageUrl } from './types-bsm8Fp55.js';
+import { D as DataListRetriever } from './useDataListRetriever-WEXL4bqB.js';
+
+type TableContent<T> = {
+    jsonApiData: T;
+    [key: string]: any;
+};
+interface TableStructureGeneratorInterface<T, U> {
+    generateTableStructure: (params: {
+        t: (key: string) => string;
+        generateUrl: (params: {
+            page: string | PageUrl | string;
+            id?: string;
+        }) => string;
+        data: T[];
+        fields: Array<U>;
+        checkedIds?: string[];
+        toggleId?: (id: string) => void;
+    }) => {
+        data: TableContent<T>[];
+        columns: ColumnDef<TableContent<T>>[];
+    };
+}
+type UseTableStructureHookParams<T, U> = {
+    data: T[];
+    fields: Array<U>;
+    checkedIds?: string[];
+    toggleId?: (id: string) => void;
+    dataRetriever?: DataListRetriever<T>;
+    context?: Record<string, any>;
+};
+type UseTableStructureHookReturn<T> = {
+    data: TableContent<T>[];
+    columns: ColumnDef<TableContent<T>>[];
+};
+type UseTableStructureHook<T, U> = (params: UseTableStructureHookParams<T, U>) => UseTableStructureHookReturn<T>;
+
+export type { TableContent as T, UseTableStructureHook as U, UseTableStructureHookParams as a, UseTableStructureHookReturn as b, TableStructureGeneratorInterface as c };

package/messages/en.json

@@ -736,6 +736,108 @@
       }
     }
   },
+  "blog": {
+    "admin": {
+      "title": "Blog",
+      "newPost": "New post",
+      "editPost": "Edit post",
+      "newCategory": "New category",
+      "editCategory": "Edit category",
+      "empty": "No posts yet. Write the first one.",
+      "emptyCategories": "No categories yet."
+    },
+    "tabs": {
+      "posts": "Posts",
+      "categories": "Categories",
+      "layout": "Layout"
+    },
+    "fields": {
+      "title": "Title",
+      "slug": "Slug",
+      "slugHelp": "The last part of the post's address. Changing it breaks links that already point to the post.",
+      "summary": "Summary",
+      "summaryHelp": "Leave it empty to let AI write it from the body.",
+      "body": "Body",
+      "coverImage": "Cover image",
+      "coverImageAlt": "Cover image description",
+      "categories": "Categories",
+      "originalLanguage": "Original language",
+      "name": "Name",
+      "description": "Description",
+      "image": "Image",
+      "status": "Status",
+      "publishedAt": "Published",
+      "languages": "Languages ready"
+    },
+    "status": {
+      "draft": "Draft",
+      "published": "Published",
+      "unpublished": "Unpublished"
+    },
+    "actions": {
+      "publish": "Publish",
+      "unpublish": "Unpublish",
+      "edit": "Edit",
+      "translateAgain": "Translate again",
+      "compareWithOriginal": "Compare with original",
+      "hideComparison": "Hide comparison"
+    },
+    "translation": {
+      "original": "Original",
+      "translatedFrom": "Translated from {language} on {date}",
+      "editedByHand": "Edited by hand",
+      "overwriteWarning": "Editing the original will translate it again and replace these edits.",
+      "translating": "Translating…",
+      "failed": "Translation failed",
+      "pending": "Waiting to translate"
+    },
+    "layout": {
+      "title": "Public list layout",
+      "featured": "Featured",
+      "featuredDescription": "The newest post as a large hero, then a three-column grid of cards.",
+      "column": "Column",
+      "columnDescription": "A narrow reading column with one row per post, image beside the text.",
+      "rail": "Rail",
+      "railDescription": "Search and categories in a side rail, the newest post large, the rest in two columns.",
+      "saved": "Layout saved"
+    },
+    "public": {
+      "eyebrow": "Blog",
+      "title": "Notes and guides",
+      "subtitle": "Ideas, guides and news from the team.",
+      "all": "All",
+      "search": "Search",
+      "searchPlaceholder": "Search posts",
+      "loadMore": "Load more",
+      "readingTime": "{minutes} min read",
+      "updated": "Updated {date}",
+      "by": "By {author}",
+      "back": "All posts",
+      "moreIn": "More in {category}",
+      "empty": "No posts yet.",
+      "noResults": "No posts match your search."
+    },
+    "entities": {
+      "post": "Post",
+      "posts": "Posts",
+      "category": "Category",
+      "categories": "Categories"
+    },
+    "errors": {
+      "title": "A title is required",
+      "name": "A name is required",
+      "language": "Choose the original language"
+    }
+  },
+  "canvas": {
+    "toolbar": {
+      "fitView": "Fit to view",
+      "tidy": "Tidy",
+      "tidyTooltip": "Clear manual positions and re-run auto-layout",
+      "zoomIn": "Zoom in",
+      "zoomOut": "Zoom out"
+    }
+  },
   "common": {
     "actions": {
       "submitting": "Submitting..."
@@ -906,6 +1008,114 @@
     },
     "news": "Recent Relevant Contents"
   },
+  "emailAutomations": {
+    "admin": {
+      "editAutomation": "Edit automation",
+      "empty": "No email automations yet.",
+      "newAutomation": "New automation",
+      "title": "Email automations"
+    },
+    "canvas": {
+      "addEmail": "Add email",
+      "chainError": "That connection would break the sequence.",
+      "deleteEmail": "Delete email",
+      "deleteEmailConfirm": "Delete this email? The sequence closes around it and anyone waiting on it moves to the next email.",
+      "emptyBody": "Right-click the canvas or drag from the trigger to add the first one.",
+      "emptyTitle": "No emails yet",
+      "hoursAfterEntering": "hours after entering the automation",
+      "hoursAfterPrevious": "hours after the previous email",
+      "noTrigger": "No trigger",
+      "orphan": "not in the sequence",
+      "sent": "sent {count}"
+    },
+    "fields": {
+      "exitTrigger": {
+        "label": "Exit trigger"
+      },
+      "isActive": {
+        "help": "Off holds everyone in place; overdue emails go out when you switch it back on.",
+        "label": "Active"
+      },
+      "name": {
+        "error": "Name is required",
+        "label": "Name"
+      },
+      "replyTo": {
+        "error": "Enter a valid email address",
+        "label": "Reply-to"
+      },
+      "trigger": {
+        "label": "Trigger",
+        "none": "— none —"
+      }
+    },
+    "list": {
+      "columns": {
+        "active": "Active",
+        "completed": "Done",
+        "name": "Name",
+        "status": "Status",
+        "steps": "Emails",
+        "trigger": "Trigger",
+        "unsubscribed": "Left"
+      },
+      "status": {
+        "off": "Off",
+        "on": "On"
+      }
+    },
+    "recipients": {
+      "columns": {
+        "currentStep": "Next email",
+        "email": "Email",
+        "name": "Name",
+        "nextSendAt": "Due",
+        "sentCount": "Sent",
+        "status": "Status"
+      },
+      "empty": "Nobody has entered this automation yet.",
+      "status": {
+        "active": "Active",
+        "all": "All",
+        "completed": "Completed",
+        "exited": "Exited",
+        "failed": "Failed",
+        "unsubscribed": "Unsubscribed"
+      }
+    },
+    "step": {
+      "editTitle": "Edit email",
+      "fields": {
+        "body": {
+          "error": "Body is required",
+          "label": "Body (Markdown)"
+        },
+        "delayHours": {
+          "label": "Delay"
+        },
+        "subject": {
+          "error": "Subject is required",
+          "label": "Subject"
+        }
+      },
+      "title": "New email",
+      "unsubscribeHint": "The unsubscribe links are always added below the body.",
+      "variablesHint": "Variables:"
+    },
+    "tabs": {
+      "canvas": "Canvas",
+      "recipients": "Recipients"
+    },
+    "unsubscribe": {
+      "alsoStopAll": "Also stop all marketing emails",
+      "invalidBody": "This link is not valid.",
+      "invalidTitle": "Link not valid",
+      "loading": "Updating your email preferences...",
+      "stoppedAll": "You will not receive any more marketing emails from us.",
+      "stoppedAutomation": "You will not receive more emails from {name}.",
+      "title": "You are unsubscribed"
+    }
+  },
   "entities": {
     "assistants": "{count, plural, =1 {Assistant} other {Assistants}}",
     "companies": "{count, plural, =1 {Company} other {Companies}}",

package/messages/it.json

@@ -736,6 +736,108 @@
       }
     }
   },
+  "blog": {
+    "admin": {
+      "title": "Blog",
+      "newPost": "Nuovo articolo",
+      "editPost": "Modifica articolo",
+      "newCategory": "Nuova categoria",
+      "editCategory": "Modifica categoria",
+      "empty": "Nessun articolo. Scrivi il primo.",
+      "emptyCategories": "Nessuna categoria."
+    },
+    "tabs": {
+      "posts": "Articoli",
+      "categories": "Categorie",
+      "layout": "Impaginazione"
+    },
+    "fields": {
+      "title": "Titolo",
+      "slug": "Slug",
+      "slugHelp": "L'ultima parte dell'indirizzo dell'articolo. Cambiarlo rompe i link che puntano già all'articolo.",
+      "summary": "Sommario",
+      "summaryHelp": "Lascialo vuoto e lo scriverà l'AI a partire dal testo.",
+      "body": "Testo",
+      "coverImage": "Immagine di copertina",
+      "coverImageAlt": "Descrizione dell'immagine di copertina",
+      "categories": "Categorie",
+      "originalLanguage": "Lingua originale",
+      "name": "Nome",
+      "description": "Descrizione",
+      "image": "Immagine",
+      "status": "Stato",
+      "publishedAt": "Pubblicato",
+      "languages": "Lingue pronte"
+    },
+    "status": {
+      "draft": "Bozza",
+      "published": "Pubblicato",
+      "unpublished": "Ritirato"
+    },
+    "actions": {
+      "publish": "Pubblica",
+      "unpublish": "Ritira",
+      "edit": "Modifica",
+      "translateAgain": "Traduci di nuovo",
+      "compareWithOriginal": "Confronta con l'originale",
+      "hideComparison": "Nascondi confronto"
+    },
+    "translation": {
+      "original": "Originale",
+      "translatedFrom": "Lingua originale: {language}, tradotto il {date}",
+      "editedByHand": "Modificato a mano",
+      "overwriteWarning": "Modificare l'originale lo farà tradurre di nuovo e sostituirà queste modifiche.",
+      "translating": "Traduzione in corso…",
+      "failed": "Traduzione non riuscita",
+      "pending": "In attesa di traduzione"
+    },
+    "layout": {
+      "title": "Impaginazione dell'elenco pubblico",
+      "featured": "In evidenza",
+      "featuredDescription": "L'articolo più recente in grande, poi una griglia di schede su tre colonne.",
+      "column": "Colonna",
+      "columnDescription": "Una colonna di lettura stretta, una riga per articolo con l'immagine accanto al testo.",
+      "rail": "Barra laterale",
+      "railDescription": "Ricerca e categorie in una barra laterale, l'articolo più recente in grande, gli altri su due colonne.",
+      "saved": "Impaginazione salvata"
+    },
+    "public": {
+      "eyebrow": "Blog",
+      "title": "Note e guide",
+      "subtitle": "Idee, guide e novità dal team.",
+      "all": "Tutti",
+      "search": "Cerca",
+      "searchPlaceholder": "Cerca negli articoli",
+      "loadMore": "Carica altri",
+      "readingTime": "{minutes} min di lettura",
+      "updated": "Aggiornato il {date}",
+      "by": "Di {author}",
+      "back": "Tutti gli articoli",
+      "moreIn": "Altro in {category}",
+      "empty": "Ancora nessun articolo.",
+      "noResults": "Nessun articolo corrisponde alla ricerca."
+    },
+    "entities": {
+      "post": "Articolo",
+      "posts": "Articoli",
+      "category": "Categoria",
+      "categories": "Categorie"
+    },
+    "errors": {
+      "title": "Il titolo è obbligatorio",
+      "name": "Il nome è obbligatorio",
+      "language": "Scegli la lingua originale"
+    }
+  },
+  "canvas": {
+    "toolbar": {
+      "fitView": "Adatta alla vista",
+      "tidy": "Riordina",
+      "tidyTooltip": "Cancella le posizioni manuali e rifai il layout automatico",
+      "zoomIn": "Ingrandisci",
+      "zoomOut": "Riduci"
+    }
+  },
   "common": {
     "actions": {
       "submitting": "Invio in corso..."
@@ -906,6 +1008,114 @@
     },
     "news": "Contenuti recenti pertinenti"
   },
+  "emailAutomations": {
+    "admin": {
+      "editAutomation": "Modifica automazione",
+      "empty": "Nessuna automazione email.",
+      "newAutomation": "Nuova automazione",
+      "title": "Automazioni email"
+    },
+    "canvas": {
+      "addEmail": "Aggiungi email",
+      "chainError": "Questo collegamento romperebbe la sequenza.",
+      "deleteEmail": "Elimina email",
+      "deleteEmailConfirm": "Eliminare questa email? La sequenza si richiude e chi la stava aspettando passa all'email successiva.",
+      "emptyBody": "Fai clic destro sul canvas o trascina dall'evento per aggiungere la prima.",
+      "emptyTitle": "Ancora nessuna email",
+      "hoursAfterEntering": "ore dopo l'ingresso nell'automazione",
+      "hoursAfterPrevious": "ore dopo l'email precedente",
+      "noTrigger": "Nessun evento",
+      "orphan": "fuori dalla sequenza",
+      "sent": "inviate {count}"
+    },
+    "fields": {
+      "exitTrigger": {
+        "label": "Evento di uscita"
+      },
+      "isActive": {
+        "help": "Spenta, tiene tutti fermi dove sono; le email in ritardo partono quando la riaccendi.",
+        "label": "Attiva"
+      },
+      "name": {
+        "error": "Il nome è obbligatorio",
+        "label": "Nome"
+      },
+      "replyTo": {
+        "error": "Inserisci un indirizzo email valido",
+        "label": "Rispondi a"
+      },
+      "trigger": {
+        "label": "Evento di ingresso",
+        "none": "— nessuno —"
+      }
+    },
+    "list": {
+      "columns": {
+        "active": "Attivi",
+        "completed": "Completati",
+        "name": "Nome",
+        "status": "Stato",
+        "steps": "Email",
+        "trigger": "Evento",
+        "unsubscribed": "Disiscritti"
+      },
+      "status": {
+        "off": "Spenta",
+        "on": "Attiva"
+      }
+    },
+    "recipients": {
+      "columns": {
+        "currentStep": "Prossima email",
+        "email": "Email",
+        "name": "Nome",
+        "nextSendAt": "In programma",
+        "sentCount": "Inviate",
+        "status": "Stato"
+      },
+      "empty": "Nessuno è ancora entrato in questa automazione.",
+      "status": {
+        "active": "Attivi",
+        "all": "Tutti",
+        "completed": "Completati",
+        "exited": "Usciti",
+        "failed": "Non riusciti",
+        "unsubscribed": "Disiscritti"
+      }
+    },
+    "step": {
+      "editTitle": "Modifica email",
+      "fields": {
+        "body": {
+          "error": "Il testo è obbligatorio",
+          "label": "Testo (Markdown)"
+        },
+        "delayHours": {
+          "label": "Attesa"
+        },
+        "subject": {
+          "error": "L'oggetto è obbligatorio",
+          "label": "Oggetto"
+        }
+      },
+      "title": "Nuova email",
+      "unsubscribeHint": "I link per disiscriversi vengono sempre aggiunti sotto il testo.",
+      "variablesHint": "Variabili:"
+    },
+    "tabs": {
+      "canvas": "Canvas",
+      "recipients": "Destinatari"
+    },
+    "unsubscribe": {
+      "alsoStopAll": "Interrompi anche tutte le email promozionali",
+      "invalidBody": "Questo link non è valido.",
+      "invalidTitle": "Link non valido",
+      "loading": "Aggiornamento delle tue preferenze email in corso...",
+      "stoppedAll": "Non riceverai più nessuna email promozionale da noi.",
+      "stoppedAutomation": "Non riceverai altre email da {name}.",
+      "title": "Disiscrizione completata"
+    }
+  },
   "entities": {
     "assistants": "{count, plural, =1 {Assistente} other {Assistenti}}",
     "companies": "{count, plural, =1 {Azienda} other {Aziende}}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -59,6 +59,11 @@
       "import": "./dist/billing/index.mjs",
       "require": "./dist/billing/index.js"
     },
+    "./email-automations": {
+      "types": "./dist/email-automations/index.d.ts",
+      "import": "./dist/email-automations/index.mjs",
+      "require": "./dist/email-automations/index.js"
+    },
     "./help": {
       "types": "./dist/features/help/index.d.ts",
       "import": "./dist/features/help/index.mjs",
@@ -69,6 +74,16 @@
       "import": "./dist/features/help/server.mjs",
       "require": "./dist/features/help/server.js"
     },
+    "./blog": {
+      "types": "./dist/features/blog/index.d.ts",
+      "import": "./dist/features/blog/index.mjs",
+      "require": "./dist/features/blog/index.js"
+    },
+    "./blog/server": {
+      "types": "./dist/features/blog/server.d.ts",
+      "import": "./dist/features/blog/server.mjs",
+      "require": "./dist/features/blog/server.js"
+    },
     "./tokenusage": {
       "types": "./dist/features/tokenusage/index.d.ts",
       "import": "./dist/features/tokenusage/index.mjs",
@@ -118,6 +133,7 @@
     "@stripe/react-stripe-js": ">=6.8.0",
     "@stripe/stripe-js": ">=9.13.0",
     "@tanstack/react-table": ">=8.0.0",
+    "@xyflow/react": ">=12.0.0",
     "next": ">=16.4.0",
     "next-intl": ">=4.0.0",
     "react": ">=19.3.0",
@@ -134,6 +150,9 @@
     "@tanstack/react-table": {
       "optional": true
     },
+    "@xyflow/react": {
+      "optional": true
+    },
     "next-intl": {
       "optional": true
     },
@@ -220,6 +239,7 @@
     "@vitejs/plugin-react": "^6.1.2",
     "@vitest/coverage-v8": "^5.0.3",
     "@vitest/ui": "^5.0.3",
+    "@xyflow/react": "^12.12.0",
     "conventional-changelog-conventionalcommits": "9.3.1",
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",

package/src/components/editors/BlockNoteEditor.tsx

@@ -78,6 +78,13 @@ export type BlockNoteEditorProps = {
   diffContent?: PartialBlock[];
   placeholder?: string;
   bordered?: boolean;
+  /**
+   * Storage folder for pasted images, used instead of the current company's
+   * `companies/<companyId>/<type>` folder: the image key becomes
+   * `<uploadKeyPrefix>/<id>/<file name>`. For platform content edited by users
+   * who belong to no company (the blog). Omitted: the company folder, as before.
+   */
+  uploadKeyPrefix?: string;
   inlineContentSpecs?: Record<string, any>;
   renderOverlays?: (editor: any) => React.ReactNode;
   enableMentions?: boolean;
@@ -405,6 +412,7 @@ export default function BlockNoteEditor({
   diffContent,
   placeholder,
   bordered,
+  uploadKeyPrefix,
   inlineContentSpecs,
   renderOverlays,
   enableMentions,
@@ -547,7 +555,7 @@ export default function BlockNoteEditor({
 
   const uploadImage = useCallback(
     async (file: File): Promise<string> => {
-      if (!company) {
+      if (!company && !uploadKeyPrefix) {
         errorToast({
           title: t(`common.errors.upload`),
           error: t(`common.errors.upload_description`),
@@ -556,7 +564,9 @@ export default function BlockNoteEditor({
       }
 
       const fileType = file.type;
-      const key = `companies/${company.id}/${type}/${id}/${file.name}`;
+      const key = uploadKeyPrefix
+        ? `${uploadKeyPrefix}/${id}/${file.name}`
+        : `companies/${company!.id}/${type}/${id}/${file.name}`;
 
       const s3: S3Interface = await S3Service.getPreSignedUrl({
         key: key,
@@ -577,7 +587,7 @@ export default function BlockNoteEditor({
 
       return signedImage.url;
     },
-    [company, id, t],
+    [company, id, t, type, uploadKeyPrefix],
   );
 
   // Utility: Remove trailing empty blocks for read-only display

package/src/components/forms/FormBlockNote.tsx

@@ -41,6 +41,7 @@ export function FormBlockNote({
   aiConfig,
   aiHandleRef,
   headerAction,
+  uploadKeyPrefix,
 }: {
   form: any;
   id: string;
@@ -74,6 +75,8 @@ export function FormBlockNote({
   aiHandleRef?: React.MutableRefObject<import("../editors/BlockNoteEditor").BlockNoteAiHandle | null>;
   /** Rendered on the label row, right-aligned — e.g. a "Suggest impression" button. */
   headerAction?: React.ReactNode;
+  /** See `BlockNoteEditorProps.uploadKeyPrefix`. */
+  uploadKeyPrefix?: string;
 }) {
   const initialContentRef = useRef<any>(null);
   const lastEditorContentRef = useRef<any>(undefined);
@@ -133,6 +136,7 @@ export function FormBlockNote({
               bordered
               inlineContentSpecs={inlineContentSpecs}
               renderOverlays={renderOverlays}
+              uploadKeyPrefix={uploadKeyPrefix}
               enableMentions={enableMentions}
               mentionSearchFn={mentionSearchFn}
               mentionSearchParams={mentionSearchParams}

package/src/components/forms/FormFieldWrapper.tsx

@@ -21,7 +21,7 @@ type FormFieldWrapperProps<T extends FieldValues> = {
    * label built by the caller, so the label row stays one element.
    */
   labelAction?: ReactNode;
-  description?: string;
+  description?: ReactNode;
   isRequired?: boolean;
   orientation?: "vertical" | "horizontal" | "responsive";
   className?: string;

package/src/components/forms/FormTextarea.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { ReactNode } from "react";
 import { Textarea } from "../../shadcnui";
 import { cn } from "../../utils";
 import { FormFieldWrapper } from "./FormFieldWrapper";
@@ -21,7 +22,7 @@ export function FormTextarea({
   placeholder?: string;
   className?: string;
   testId?: string;
-  description?: string;
+  description?: ReactNode;
   isRequired?: boolean;
   textareaRef?: React.RefObject<HTMLTextAreaElement>;
 }) {

package/src/components/navigations/ContentTitle.tsx

@@ -11,9 +11,20 @@ type TitleProps = {
   className?: string;
   module?: ModuleWithPermissions;
   prioritizeFunctions?: boolean;
+  /** Renders the title line as a real heading (public SEO pages). Omitted: a plain div, as before. */
+  headingLevel?: 1 | 2;
 };
 
-export function ContentTitle({ module, type, element, functions, className, prioritizeFunctions }: TitleProps) {
+export function ContentTitle({
+  module,
+  type,
+  element,
+  functions,
+  className,
+  prioritizeFunctions,
+  headingLevel,
+}: TitleProps) {
+  const ElementTag = headingLevel === 1 ? "h1" : headingLevel === 2 ? "h2" : "div";
   const [clientFunctions, setClientFunctions] = useState<ReactNode>(null);
   const [isClient, setIsClient] = useState(false);
 
@@ -43,9 +54,9 @@ export function ContentTitle({ module, type, element, functions, className, prio
           </div>
         )}
         {/* Element (name) - truncates with ellipsis when space is limited */}
-        <div className={cn("text-primary text-3xl font-semibold", prioritizeFunctions ? "truncate" : "w-full")}>
+        <ElementTag className={cn("text-primary text-3xl font-semibold", prioritizeFunctions ? "truncate" : "w-full")}>
           {element}
-        </div>
+        </ElementTag>
       </div>
       {/* Functions section - doesn't shrink when prioritizeFunctions is true */}
       {isClient && clientFunctions && (