@carlonicora/nextjs-jsonapi 5.4.0 → 5.6.0

package/dist/server/index.js

@@ -3,7 +3,7 @@
 
 
 
-var _chunkYW4ZCEWBjs = require('../chunk-YW4ZCEWB.js');
+var _chunk53BAULDPjs = require('../chunk-53BAULDP.js');
 
 
 var _chunkIK65TDQHjs = require('../chunk-IK65TDQH.js');
@@ -35,10 +35,10 @@ require('../chunk-G4JR3SFV.js');
 
 
 
-var _chunkNFBOSPNJjs = require('../chunk-NFBOSPNJ.js');
+var _chunkHKZAESS6js = require('../chunk-HKZAESS6.js');
+require('../chunk-GHE4VT2R.js');
 require('../chunk-LXKSUWAV.js');
 require('../chunk-JTPRJNT2.js');
-require('../chunk-GHE4VT2R.js');
 require('../chunk-7QVYU63E.js');
 
 
@@ -66,5 +66,5 @@ require('../chunk-7QVYU63E.js');
 
 
 
-exports.CACHE_PROFILES = _chunkIK65TDQHjs.CACHE_PROFILES; exports.ServerAuthService = _chunkNFBOSPNJjs.AuthService; exports.ServerCompanyService = _chunkNFBOSPNJjs.CompanyService; exports.ServerContentService = _chunkNFBOSPNJjs.ContentService; exports.ServerFeatureService = _chunkNFBOSPNJjs.FeatureService; exports.ServerJsonApiDelete = _chunkKSYQEKJXjs.ServerJsonApiDelete; exports.ServerJsonApiGet = _chunkKSYQEKJXjs.ServerJsonApiGet; exports.ServerJsonApiPatch = _chunkKSYQEKJXjs.ServerJsonApiPatch; exports.ServerJsonApiPost = _chunkKSYQEKJXjs.ServerJsonApiPost; exports.ServerJsonApiPut = _chunkKSYQEKJXjs.ServerJsonApiPut; exports.ServerNotificationService = _chunkNFBOSPNJjs.NotificationService; exports.ServerPushService = _chunkNFBOSPNJjs.PushService; exports.ServerRoleService = _chunkNFBOSPNJjs.RoleService; exports.ServerS3Service = _chunkNFBOSPNJjs.S3Service; exports.ServerSession = _chunkYW4ZCEWBjs.ServerSession; exports.ServerUserService = _chunkNFBOSPNJjs.UserService; exports.configureServerJsonApi = _chunkKSYQEKJXjs.configureServerJsonApi; exports.getServerApiUrl = _chunkKSYQEKJXjs.getServerApiUrl; exports.getServerAppUrl = _chunkKSYQEKJXjs.getServerAppUrl; exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken; exports.getServerTrackablePages = _chunkKSYQEKJXjs.getServerTrackablePages; exports.invalidateCacheTag = _chunkYW4ZCEWBjs.invalidateCacheTag; exports.invalidateCacheTags = _chunkYW4ZCEWBjs.invalidateCacheTags; exports.serverRequest = _chunk6TUB7Y6Tjs.serverRequest; exports.updateCacheTag = _chunkYW4ZCEWBjs.updateCacheTag;
+exports.CACHE_PROFILES = _chunkIK65TDQHjs.CACHE_PROFILES; exports.ServerAuthService = _chunkHKZAESS6js.AuthService; exports.ServerCompanyService = _chunkHKZAESS6js.CompanyService; exports.ServerContentService = _chunkHKZAESS6js.ContentService; exports.ServerFeatureService = _chunkHKZAESS6js.FeatureService; exports.ServerJsonApiDelete = _chunkKSYQEKJXjs.ServerJsonApiDelete; exports.ServerJsonApiGet = _chunkKSYQEKJXjs.ServerJsonApiGet; exports.ServerJsonApiPatch = _chunkKSYQEKJXjs.ServerJsonApiPatch; exports.ServerJsonApiPost = _chunkKSYQEKJXjs.ServerJsonApiPost; exports.ServerJsonApiPut = _chunkKSYQEKJXjs.ServerJsonApiPut; exports.ServerNotificationService = _chunkHKZAESS6js.NotificationService; exports.ServerPushService = _chunkHKZAESS6js.PushService; exports.ServerRoleService = _chunkHKZAESS6js.RoleService; exports.ServerS3Service = _chunkHKZAESS6js.S3Service; exports.ServerSession = _chunk53BAULDPjs.ServerSession; exports.ServerUserService = _chunkHKZAESS6js.UserService; exports.configureServerJsonApi = _chunkKSYQEKJXjs.configureServerJsonApi; exports.getServerApiUrl = _chunkKSYQEKJXjs.getServerApiUrl; exports.getServerAppUrl = _chunkKSYQEKJXjs.getServerAppUrl; exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken; exports.getServerTrackablePages = _chunkKSYQEKJXjs.getServerTrackablePages; exports.invalidateCacheTag = _chunk53BAULDPjs.invalidateCacheTag; exports.invalidateCacheTags = _chunk53BAULDPjs.invalidateCacheTags; exports.serverRequest = _chunk6TUB7Y6Tjs.serverRequest; exports.updateCacheTag = _chunk53BAULDPjs.updateCacheTag;
 //# sourceMappingURL=index.js.map

package/dist/server/index.mjs

@@ -3,7 +3,7 @@ import {
   invalidateCacheTag,
   invalidateCacheTags,
   updateCacheTag
-} from "../chunk-XCHSX3VC.mjs";
+} from "../chunk-BTPUYUQ3.mjs";
 import {
   CACHE_PROFILES
 } from "../chunk-T7SAW3UW.mjs";
@@ -35,10 +35,10 @@ import {
   RoleService,
   S3Service,
   UserService
-} from "../chunk-WC63PJSC.mjs";
+} from "../chunk-EYA2F6AN.mjs";
+import "../chunk-V5MI7RNB.mjs";
 import "../chunk-AUXK7QSA.mjs";
 import "../chunk-PI56A4DG.mjs";
-import "../chunk-V5MI7RNB.mjs";
 import "../chunk-PAWJFY3S.mjs";
 export {
   CACHE_PROFILES,

package/messages/en.json

@@ -297,6 +297,118 @@
   },
   "billing": {
     "admin": {
+      "coupons": {
+        "all_products": "All products",
+        "codes": {
+          "automatic": "Automatic",
+          "deactivate": {
+            "confirm": "Deactivate",
+            "description": "Nobody will be able to use \"{code}\" until you reactivate it. Subscriptions that already have it keep their discount.",
+            "title": "Deactivate code"
+          },
+          "empty": {
+            "description": "Add a code customers can use to get this coupon's discount.",
+            "title": "No codes yet"
+          },
+          "entity": "code",
+          "never": "Never",
+          "reactivate": {
+            "confirm": "Reactivate",
+            "description": "\"{code}\" can be used again.",
+            "title": "Reactivate code"
+          },
+          "status": {
+            "active": "Active",
+            "expired": "Expired",
+            "inactive": "Inactive",
+            "used_up": "Used up"
+          },
+          "title": "Codes"
+        },
+        "discount": {
+          "amount": "{amount} off",
+          "forever": "forever",
+          "once": "once",
+          "percent": "{value}% off",
+          "repeating": "for {months} months"
+        },
+        "duration": {
+          "forever": "Forever",
+          "once": "Once",
+          "repeating": "For a number of months"
+        },
+        "empty": {
+          "description": "Create a coupon to offer a discount at checkout.",
+          "title": "No coupons yet"
+        },
+        "entity": "coupon",
+        "errors": {
+          "amountOff": "Enter an amount above zero",
+          "durationInMonths": "Enter at least one month",
+          "minimumAmount": "Enter an amount above zero, or leave it empty",
+          "name": "A coupon name is required",
+          "percentOff": "Enter a percentage between 0.01 and 100"
+        },
+        "fields": {
+          "amountOff": "Amount off",
+          "automatic": "Apply automatically",
+          "code": "Code",
+          "codeMaxRedemptions": "Usage limit for this code",
+          "codes": "Codes",
+          "currency": "Currency",
+          "discount": "Discount",
+          "discountType": "Type",
+          "duration": "Duration",
+          "durationInMonths": "Months",
+          "expiresAt": "Expires",
+          "firstTimeTransaction": "First-time customers only",
+          "first_time_warning": "A GM coming from a trial counts as an existing customer, so leave this off for codes meant for trial GMs.",
+          "maxRedemptions": "Total usage limit",
+          "minimumAmount": "Minimum order amount",
+          "name": "Name",
+          "percentOff": "Percentage off",
+          "places": "Places",
+          "products": "Apply to specific products",
+          "redeemBy": "Redeem by",
+          "status": "Status",
+          "stripeCouponId": "ID",
+          "stripeCustomerId": "Limit to one customer",
+          "stripeId": "Stripe coupon ID"
+        },
+        "first_code": "First code",
+        "fixed_notice": "Stripe doesn't allow changing the discount, duration or limits of a coupon. Make a new coupon instead.",
+        "help": {
+          "automatic": "Applied by itself when a GM first pays. Only one code can have it: switching it on here switches it off on the code that had it.",
+          "products": "Leave empty to apply the coupon to every product."
+        },
+        "placeholders": {
+          "amountOff": "5.00",
+          "code": "Leave empty to let Stripe generate one",
+          "durationInMonths": "3",
+          "maxRedemptions": "No limit",
+          "minimumAmount": "0.00",
+          "name": "e.g. Founding GM",
+          "percentOff": "20",
+          "stripeCouponId": "Leave empty to let Stripe generate one"
+        },
+        "places": {
+          "limited": "{used} / {limit}",
+          "no_limit": "No limit",
+          "unlimited": "{used} / no limit"
+        },
+        "refresh": {
+          "title": "Refresh counts"
+        },
+        "status": {
+          "active": "Active",
+          "ended": "Ended"
+        },
+        "title": "Coupons",
+        "type": {
+          "amount_off": "Fixed amount off",
+          "percent_off": "Percentage off"
+        }
+      },
       "prices": {
         "actions": {
           "addFeature": "Add feature",
@@ -430,7 +542,9 @@
           "archived": "Archived"
         },
         "tabs": {
-          "details": "Details"
+          "codes": "Codes",
+          "details": "Details",
+          "products": "Products"
         },
         "title": "Products"
       }
@@ -626,10 +740,12 @@
       },
       "promo_code": {
         "apply": "Apply",
+        "automatic_label": "Applied automatically",
         "duration_forever": "Applied to all payments",
         "duration_once": "Applied to first payment only",
         "duration_repeating": "Applied for {months} months",
-        "placeholder": "Enter promo code"
+        "placeholder": "Enter promo code",
+        "use_different": "Have a different code?"
       },
       "proration": {
         "net_due_today": "Net Due Today",
@@ -698,8 +814,10 @@
         "change_title": "Change Subscription Plan",
         "errors": {
           "already_subscribed": "You already have an active subscription. Please change your existing plan instead.",
+          "discount_unavailable": "This discount is no longer available. You have not been charged.",
           "invalid_promo_code": "Invalid promotion code",
           "payment_method_required": "A payment method is required to upgrade from your trial.",
+          "payment_not_confirmed": "The payment was not completed. {reason} Nothing was charged: try again, or add another card.",
           "prepare_review": "Failed to prepare review",
           "process_subscription": "Failed to process subscription",
           "validate_promo_code": "Failed to validate promotion code"
@@ -708,6 +826,7 @@
         "payment_description": "Enter your card details to complete your subscription",
         "review": {
           "amount_off": "{amount} off",
+          "card_on_file": "{brand} ending in {last4}",
           "charge_now": "Amount to charge now:",
           "confirm_change": "Confirm Plan Change",
           "due_now": "Amount due now:",
@@ -725,7 +844,10 @@
           "selected_plan": "Selected Plan",
           "subscribe_now": "Subscribe Now",
           "trial_upgrade": "Trial Upgrade",
-          "trial_upgrade_description": "Your trial will end immediately and you will be charged the full price."
+          "trial_upgrade_description": "Your trial will end immediately and you will be charged the full price.",
+          "trial_upgrade_description_discounted": "Your trial will end immediately and you will be charged the discounted price.",
+          "use_another_card": "Use another card",
+          "discount_carries_over": "Your current discount carries over to the new plan."
         },
         "steps": {
           "payment": "Payment",

package/messages/it.json

@@ -297,6 +297,118 @@
   },
   "billing": {
     "admin": {
+      "coupons": {
+        "all_products": "Tutti i prodotti",
+        "codes": {
+          "automatic": "Automatico",
+          "deactivate": {
+            "confirm": "Disattiva",
+            "description": "Nessuno potrà usare \"{code}\" finché non lo riattivi. Gli abbonamenti che lo hanno già mantengono lo sconto.",
+            "title": "Disattiva codice"
+          },
+          "empty": {
+            "description": "Aggiungi un codice che i clienti possono usare per avere lo sconto di questo coupon.",
+            "title": "Ancora nessun codice"
+          },
+          "entity": "codice",
+          "never": "Mai",
+          "reactivate": {
+            "confirm": "Riattiva",
+            "description": "\"{code}\" potrà essere usato di nuovo.",
+            "title": "Riattiva codice"
+          },
+          "status": {
+            "active": "Attivo",
+            "expired": "Scaduto",
+            "inactive": "Inattivo",
+            "used_up": "Esaurito"
+          },
+          "title": "Codici"
+        },
+        "discount": {
+          "amount": "{amount} di sconto",
+          "forever": "per sempre",
+          "once": "una volta",
+          "percent": "{value}% di sconto",
+          "repeating": "per {months} mesi"
+        },
+        "duration": {
+          "forever": "Per sempre",
+          "once": "Una volta",
+          "repeating": "Per un numero di mesi"
+        },
+        "empty": {
+          "description": "Crea un coupon per offrire uno sconto al pagamento.",
+          "title": "Ancora nessun coupon"
+        },
+        "entity": "coupon",
+        "errors": {
+          "amountOff": "Inserisci un importo maggiore di zero",
+          "durationInMonths": "Inserisci almeno un mese",
+          "minimumAmount": "Inserisci un importo maggiore di zero, o lascia vuoto",
+          "name": "Il nome del coupon è obbligatorio",
+          "percentOff": "Inserisci una percentuale tra 0,01 e 100"
+        },
+        "fields": {
+          "amountOff": "Importo dello sconto",
+          "automatic": "Applica automaticamente",
+          "code": "Codice",
+          "codeMaxRedemptions": "Limite di utilizzo per questo codice",
+          "codes": "Codici",
+          "currency": "Valuta",
+          "discount": "Sconto",
+          "discountType": "Tipo",
+          "duration": "Durata",
+          "durationInMonths": "Mesi",
+          "expiresAt": "Scadenza",
+          "firstTimeTransaction": "Solo nuovi clienti",
+          "first_time_warning": "Un GM che arriva da una prova conta come cliente esistente, quindi lascia disattivato per i codici pensati per i GM in prova.",
+          "maxRedemptions": "Limite di utilizzo totale",
+          "minimumAmount": "Importo minimo dell'ordine",
+          "name": "Nome",
+          "percentOff": "Percentuale di sconto",
+          "places": "Posti",
+          "products": "Applica a prodotti specifici",
+          "redeemBy": "Utilizzabile fino al",
+          "status": "Stato",
+          "stripeCouponId": "ID",
+          "stripeCustomerId": "Limita a un solo cliente",
+          "stripeId": "ID coupon Stripe"
+        },
+        "first_code": "Primo codice",
+        "fixed_notice": "Stripe non permette di cambiare sconto, durata o limiti di un coupon. Crea un nuovo coupon.",
+        "help": {
+          "automatic": "Si applica da solo quando un GM paga la prima volta. Solo un codice può averlo: attivarlo qui lo disattiva sul codice che lo aveva.",
+          "products": "Lascia vuoto per applicare il coupon a tutti i prodotti."
+        },
+        "placeholders": {
+          "amountOff": "5,00",
+          "code": "Lascia vuoto per farlo generare a Stripe",
+          "durationInMonths": "3",
+          "maxRedemptions": "Nessun limite",
+          "minimumAmount": "0,00",
+          "name": "es. GM fondatore",
+          "percentOff": "20",
+          "stripeCouponId": "Lascia vuoto per farlo generare a Stripe"
+        },
+        "places": {
+          "limited": "{used} / {limit}",
+          "no_limit": "Nessun limite",
+          "unlimited": "{used} / nessun limite"
+        },
+        "refresh": {
+          "title": "Aggiorna conteggi"
+        },
+        "status": {
+          "active": "Attivo",
+          "ended": "Terminato"
+        },
+        "title": "Coupon",
+        "type": {
+          "amount_off": "Importo fisso",
+          "percent_off": "Percentuale"
+        }
+      },
       "prices": {
         "actions": {
           "addFeature": "Aggiungi caratteristica",
@@ -430,7 +542,9 @@
           "archived": "Archiviato"
         },
         "tabs": {
-          "details": "Dettagli"
+          "codes": "Codici",
+          "details": "Dettagli",
+          "products": "Prodotti"
         },
         "title": "Prodotti"
       }
@@ -626,10 +740,12 @@
       },
       "promo_code": {
         "apply": "Applica",
+        "automatic_label": "Applicato automaticamente",
         "duration_forever": "Applicato a tutti i pagamenti",
         "duration_once": "Applicato solo al primo pagamento",
         "duration_repeating": "Applicato per {months} mesi",
-        "placeholder": "Inserisci il codice promozionale"
+        "placeholder": "Inserisci il codice promozionale",
+        "use_different": "Hai un altro codice?"
       },
       "proration": {
         "net_due_today": "Netto dovuto oggi",
@@ -698,8 +814,10 @@
         "change_title": "Cambia piano di abbonamento",
         "errors": {
           "already_subscribed": "Hai già un abbonamento attivo. Cambia invece il piano attuale.",
+          "discount_unavailable": "Questo sconto non è più disponibile. Non ti è stato addebitato nulla.",
           "invalid_promo_code": "Codice promozionale non valido",
           "payment_method_required": "Per passare dalla prova a un piano a pagamento serve un metodo di pagamento.",
+          "payment_not_confirmed": "Il pagamento non è stato completato. {reason} Non ti è stato addebitato nulla: riprova o aggiungi un'altra carta.",
           "prepare_review": "Impossibile preparare il riepilogo",
           "process_subscription": "Impossibile elaborare l'abbonamento",
           "validate_promo_code": "Impossibile verificare il codice promozionale"
@@ -708,6 +826,7 @@
         "payment_description": "Inserisci i dati della carta per completare l'abbonamento",
         "review": {
           "amount_off": "{amount} di sconto",
+          "card_on_file": "{brand} che termina con {last4}",
           "charge_now": "Importo da addebitare ora:",
           "confirm_change": "Conferma il cambio di piano",
           "due_now": "Importo dovuto ora:",
@@ -725,7 +844,10 @@
           "selected_plan": "Piano selezionato",
           "subscribe_now": "Abbonati ora",
           "trial_upgrade": "Passaggio dalla prova",
-          "trial_upgrade_description": "La tua prova terminerà subito e ti verrà addebitato il prezzo pieno."
+          "trial_upgrade_description": "La tua prova terminerà subito e ti verrà addebitato il prezzo pieno.",
+          "trial_upgrade_description_discounted": "La tua prova terminerà subito e ti verrà addebitato il prezzo scontato.",
+          "use_another_card": "Usa un'altra carta",
+          "discount_carries_over": "Il tuo sconto attuale resta valido anche sul nuovo piano."
         },
         "steps": {
           "payment": "Pagamento",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "5.4.0",
+  "version": "5.6.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -49,6 +49,11 @@
       "require": "./dist/contexts/index.js"
     },
     "./contexts/styles.css": "./dist/contexts/index.css",
+    "./blocknote/server": {
+      "types": "./dist/components/editors/server.d.ts",
+      "import": "./dist/components/editors/server.mjs",
+      "require": "./dist/components/editors/server.js"
+    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.mjs",
@@ -164,6 +169,7 @@
     "@base-ui/react": "1.8.0",
     "@blocknote/core": "^0.55.0",
     "@blocknote/react": "^0.55.0",
+    "@blocknote/server-util": "^0.55.0",
     "@blocknote/shadcn": "^0.55.0",
     "@blocknote/xl-ai": "^0.55.0",
     "@dnd-kit/core": "^6.3.1",
@@ -213,6 +219,8 @@
     "tw-animate-css": "^1.4.0",
     "uuid": "^14.0.2",
     "vaul": "^1.1.2",
+    "y-prosemirror": "^1.3.7",
+    "y-protocols": "^1.0.6",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/scripts/validate-messages.mjs

@@ -28,6 +28,7 @@ export const APP_PROVIDED_KEYS = [
   /^features\.assistant\.starters\./, // example questions about the app's own domain
   /^features\.assistant\.empty_state\.subtitle$/, // says what the app's assistant knows about
   /^auth\.gdpr\.marketing_consent$/, // a consent must name who sends the news: the app
+  /^billing\.ui\.wizard\.errors\.discount_sold_out$/, // names who to contact: the app
   // The app's own entities (CommonDeleter / RecentPagesNavigator render
   // `entities.${type}` for any module). Only the library's own entities ship.
   /^entities\.(?!(?:assistants|companies|howtos|rbac|roles|users)(?:\.|$))/,

package/src/billing/index.ts

@@ -5,6 +5,7 @@ export * from "../features/billing/stripe-customer/components";
 export * from "../features/billing/stripe-invoice/components";
 export * from "../features/billing/stripe-price/components";
 export * from "../features/billing/stripe-product/components";
+export * from "../features/billing/stripe-coupon/components";
 export * from "../features/billing/stripe-subscription/components";
 export * from "../features/billing/stripe-usage/components";
 export * from "../features/billing/stripe-promotion-code/components";

package/src/client/index.ts

@@ -21,6 +21,8 @@ import { useRoleTableStructure } from "../features/role/hooks";
 import { useUserTableStructure } from "../features/user/hooks";
 import { useStripePriceTableStructure } from "../features/billing/stripe-price/hooks/useStripePriceTableStructure";
 import { useStripeProductTableStructure } from "../features/billing/stripe-product/hooks/useStripeProductTableStructure";
+import { useStripeCouponTableStructure } from "../features/billing/stripe-coupon/hooks/useStripeCouponTableStructure";
+import { useStripeCouponCodeTableStructure } from "../features/billing/stripe-coupon/hooks/useStripeCouponCodeTableStructure";
 import { useWaitlistTableStructure } from "../features/waitlist/hooks/useWaitlistTableStructure";
 import { registerTableGenerator } from "../hooks";
 
@@ -35,5 +37,7 @@ registerTableGenerator("users", useUserTableStructure);
 registerTableGenerator("companies", useCompanyTableStructure);
 registerTableGenerator("stripe-products", useStripeProductTableStructure);
 registerTableGenerator("stripe-prices", useStripePriceTableStructure);
+registerTableGenerator("stripe-coupons", useStripeCouponTableStructure);
+registerTableGenerator("stripe-coupon-codes", useStripeCouponCodeTableStructure);
 registerTableGenerator("waitlists", useWaitlistTableStructure);
 // Note: Content registration moved to app-level to support app-specific cellTopic

package/src/components/editors/server/BlockNoteServerContent.tsx

@@ -0,0 +1,28 @@
+import type { PartialBlock } from "@blocknote/core";
+import "@blocknote/shadcn/style.css";
+// Imported through the package's own client subpath, like the analytics server
+// pages: the built server entry must reach the viewer through the "use client"
+// bundle, not inline it.
+import { BlockNoteStaticViewer } from "@carlonicora/nextjs-jsonapi/components";
+import { renderBlockNoteHTML } from "./renderBlockNoteHTML";
+
+/**
+ * Read-only rich text rendered on the server, so the text is in the HTML that
+ * crawlers read. For public read-only pages only: everywhere else, display goes
+ * through BlockNoteEditorContainer.
+ */
+export async function BlockNoteServerContent({
+  content,
+  size,
+  className,
+}: {
+  content?: PartialBlock[];
+  size?: "default" | "sm";
+  className?: string;
+}) {
+  if (!Array.isArray(content) || content.length === 0) return null;
+
+  const html = await renderBlockNoteHTML(content);
+
+  return <BlockNoteStaticViewer html={html} size={size} className={className} />;
+}

package/src/components/editors/server/__tests__/renderBlockNoteHTML.spec.ts

@@ -0,0 +1,44 @@
+// @vitest-environment node
+// The server render runs in Node, where there is no window or document of our own:
+// BlockNote's ServerBlockNoteEditor brings its JSDOM.
+import type { PartialBlock } from "@blocknote/core";
+import { describe, expect, it } from "vitest";
+import { renderBlockNoteHTML } from "../renderBlockNoteHTML";
+
+const blocks: PartialBlock[] = [
+  { type: "heading", props: { level: 2 }, content: "Prep situations" },
+  {
+    type: "paragraph",
+    content: [
+      { type: "text", text: "A scene that can go ", styles: {} },
+      { type: "text", text: "three ways", styles: { bold: true } },
+    ],
+  },
+  { type: "bulletListItem", content: "First clue" },
+  { type: "bulletListItem", content: "Second clue" },
+  {
+    type: "paragraph",
+    content: [{ type: "link", href: "https://example.com/guide", content: "Read the guide" }],
+  },
+];
+
+describe("renderBlockNoteHTML", () => {
+  it("renders the blocks' text into HTML on the server", async () => {
+    const html = await renderBlockNoteHTML(blocks);
+
+    expect(html).toContain("Prep situations");
+    expect(html).toMatch(/<h2[^>]*>.*Prep situations.*<\/h2>/s);
+    expect(html).toMatch(/<strong[^>]*>three ways<\/strong>/);
+    expect(html).toContain("First clue");
+    expect(html).toContain("Second clue");
+    expect(html).toContain('href="https://example.com/guide"');
+    expect(html).toContain("Read the guide");
+  });
+
+  it("leaves the server globals as they were", async () => {
+    await Promise.all([renderBlockNoteHTML(blocks), renderBlockNoteHTML(blocks)]);
+
+    expect(typeof (globalThis as { window?: unknown }).window).toBe("undefined");
+    expect(typeof (globalThis as { document?: unknown }).document).toBe("undefined");
+  });
+});

package/src/components/editors/server/renderBlockNoteHTML.ts

@@ -0,0 +1,26 @@
+import type { PartialBlock } from "@blocknote/core";
+import { ServerBlockNoteEditor } from "@blocknote/server-util";
+
+// Default schema only, the same one BlockNoteViewer uses: the editor's mention
+// and diff inline specs are React specs from "use client" modules (next/link,
+// hover cards), so they cannot run here.
+let editor: ServerBlockNoteEditor | undefined;
+
+// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around
+// each call and restores them after an await. Two overlapping calls would
+// restore each other's values and could leave the JSDOM window on the server's
+// globals, so calls run one at a time.
+let queue: Promise<unknown> = Promise.resolve();
+
+/**
+ * Renders a BlockNote blocks array to the HTML the editor itself would render,
+ * through BlockNote's own server editor (`blocksToFullHTML`). Server only.
+ */
+export function renderBlockNoteHTML(blocks: PartialBlock[]): Promise<string> {
+  const run = queue.then(() => {
+    editor ??= ServerBlockNoteEditor.create();
+    return editor.blocksToFullHTML(blocks);
+  });
+  queue = run.catch(() => undefined);
+  return run;
+}

package/src/components/editors/server-entry.ts

@@ -0,0 +1,7 @@
+// Server-only barrel for BlockNote rendering.
+// Consumed via `@carlonicora/nextjs-jsonapi/blocknote/server`. Must NOT receive a
+// "use client" directive: it loads @blocknote/server-util (and its JSDOM), which
+// must never reach a client bundle. The app lists @blocknote/server-util in
+// `serverExternalPackages` so Node loads it instead of the bundler.
+
+export { BlockNoteServerContent } from "./server/BlockNoteServerContent";

package/src/components/index.ts

@@ -7,6 +7,7 @@ export * from "./contents";
 export * from "./details";
 export * from "./editors";
 export { BlockNoteViewerContainer } from "./viewers/BlockNoteViewerContainer";
+export { BlockNoteStaticViewer } from "./viewers/BlockNoteStaticViewer";
 export * from "./errors";
 export * from "./forms";
 export * from "./navigations";

package/src/components/viewers/BlockNoteStaticViewer.tsx

@@ -0,0 +1,44 @@
+"use client";
+
+import { useTheme } from "next-themes";
+import { useEffect, useState } from "react";
+import { cn } from "../../utils";
+
+/**
+ * Shows HTML produced by BlockNoteServerContent inside the same container
+ * markup BlockNoteView renders, so BlockNote's stylesheet and the app's
+ * `.BlockNoteView` rules apply as they do to BlockNoteViewer.
+ */
+export function BlockNoteStaticViewer({
+  html,
+  size,
+  className,
+}: {
+  html: string;
+  size?: "default" | "sm";
+  className?: string;
+}) {
+  // The server cannot know the theme: render light until mounted, then follow
+  // the app theme like BlockNoteViewer, so hydration never mismatches.
+  const [mounted, setMounted] = useState(false);
+  const { resolvedTheme } = useTheme();
+
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  const theme = mounted && resolvedTheme === "dark" ? "dark" : "light";
+
+  return (
+    <div
+      className={cn("bn-root bn-container", theme, "bn-shadcn BlockNoteView", size === "sm" && "small", className)}
+      data-color-scheme={theme}
+    >
+      <div
+        className="bn-editor bn-default-styles ProseMirror"
+        contentEditable={false}
+        dangerouslySetInnerHTML={{ __html: html }}
+      />
+    </div>
+  );
+}

package/src/core/index.ts

@@ -56,6 +56,7 @@ export * from "../features/billing/stripe-product";
 export * from "../features/billing/stripe-subscription";
 export * from "../features/billing/stripe-usage";
 export * from "../features/billing/stripe-promotion-code";
+export * from "../features/billing/stripe-coupon";
 // AI connection administration: data + module only, NOT the feature barrel —
 // that one also re-exports the feature's client components, and core must stay
 // importable from the server (same rationale as the tokenusage entries below).