@nextsparkjs/core 0.1.0-beta.131 → 0.1.0-beta.133

package/dist/components/dashboard/block-editor/builder-editor-view.d.ts

@@ -4,6 +4,7 @@ export interface BuilderEditorViewProps {
     entityConfig: ClientEntityConfig;
     id?: string;
     mode: 'create' | 'edit';
+    onEntityFieldChange?: (field: string, value: unknown) => void;
 }
-export declare function BuilderEditorView({ entitySlug, entityConfig, id, mode }: BuilderEditorViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function BuilderEditorView({ entitySlug, entityConfig, id, mode, onEntityFieldChange: onEntityFieldChangeProp }: BuilderEditorViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=builder-editor-view.d.ts.map

package/dist/components/dashboard/block-editor/builder-editor-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-editor-view.d.ts","sourceRoot":"","sources":["../../../../src/components/dashboard/block-editor/builder-editor-view.tsx"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAA;AAwCxF,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;CACxB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,sBAAsB,2CA+rB/F"}
+{"version":3,"file":"builder-editor-view.d.ts","sourceRoot":"","sources":["../../../../src/components/dashboard/block-editor/builder-editor-view.tsx"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAA;AAwCxF,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC9D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,EAAE,sBAAsB,2CAgsB7I"}

package/dist/components/dashboard/block-editor/builder-editor-view.js

@@ -41,7 +41,7 @@ function buildApiHeaders(includeContentType = false) {
 function slugify(text) {
   return text.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s-]/g, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-");
 }
-function BuilderEditorView({ entitySlug, entityConfig, id, mode }) {
+function BuilderEditorView({ entitySlug, entityConfig, id, mode, onEntityFieldChange: onEntityFieldChangeProp }) {
   var _a;
   const router = useRouter();
   const t = useTranslations("admin.builder");
@@ -311,7 +311,8 @@ function BuilderEditorView({ entitySlug, entityConfig, id, mode }) {
   }, []);
   const handleEntityFieldChange = useCallback((field, value) => {
     setEntityFields((prev) => ({ ...prev, [field]: value }));
-  }, []);
+    onEntityFieldChangeProp == null ? void 0 : onEntityFieldChangeProp(field, value);
+  }, [onEntityFieldChangeProp]);
   const handleLeftSidebarToggle = useCallback((value) => {
     if (!value || value === leftSidebarMode) {
       setLeftSidebarMode("none");

package/dist/components/public/pageBuilder/PageRenderer.d.ts

@@ -2,7 +2,12 @@
  * PageRenderer Component
  *
  * Renders pages from the Page Builder by iterating over blocks
- * and dynamically loading block components from the registry.
+ * and directly loading block components from the SSR registry.
+ *
+ * Uses direct imports (BLOCK_COMPONENTS_SSR) instead of React.lazy
+ * so that all HTML is visible in the initial server response without JS.
+ * React.lazy puts content inside hidden <template> tags that require
+ * client-side JS to reveal — breaking no-JS rendering and hurting SEO.
  *
  * @module core/components/public/pageBuilder
  */

package/dist/components/public/pageBuilder/PageRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageRenderer.d.ts","sourceRoot":"","sources":["../../../../src/components/public/pageBuilder/PageRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAmD1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,aAAa,EAAE,CAAA;QACvB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,iBAAiB,2CA+BvD"}
+{"version":3,"file":"PageRenderer.d.ts","sourceRoot":"","sources":["../../../../src/components/public/pageBuilder/PageRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAkC1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,aAAa,EAAE,CAAA;QACvB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,iBAAiB,2CA+BvD"}

package/dist/components/public/pageBuilder/PageRenderer.js

@@ -1,13 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { Suspense } from "react";
-import { getBlockComponent, normalizeBlockProps } from "../../../lib/blocks/loader.js";
-function BlockSkeleton() {
-  return /* @__PURE__ */ jsx("div", { className: "w-full py-12 px-4 animate-pulse", children: /* @__PURE__ */ jsxs("div", { className: "max-w-7xl mx-auto", children: [
-    /* @__PURE__ */ jsx("div", { className: "h-8 bg-muted rounded w-3/4 mb-4" }),
-    /* @__PURE__ */ jsx("div", { className: "h-4 bg-muted rounded w-full mb-2" }),
-    /* @__PURE__ */ jsx("div", { className: "h-4 bg-muted rounded w-5/6" })
-  ] }) });
-}
+import { getBlockComponentSSR, normalizeBlockProps } from "../../../lib/blocks/loader.js";
 function BlockError({ blockSlug }) {
   return /* @__PURE__ */ jsx("div", { className: "w-full py-12 px-4 bg-destructive/10 border border-destructive/20 rounded", children: /* @__PURE__ */ jsxs("div", { className: "max-w-7xl mx-auto text-center", children: [
     /* @__PURE__ */ jsxs("p", { className: "text-destructive", children: [
@@ -18,13 +10,13 @@ function BlockError({ blockSlug }) {
   ] }) });
 }
 function BlockRenderer({ block }) {
-  const BlockComponent = getBlockComponent(block.blockSlug);
+  const BlockComponent = getBlockComponentSSR(block.blockSlug);
   if (!BlockComponent) {
     console.warn(`Block component not found for slug: ${block.blockSlug}`);
     return /* @__PURE__ */ jsx(BlockError, { blockSlug: block.blockSlug });
   }
   const normalizedProps = normalizeBlockProps(block.props);
-  return /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(BlockSkeleton, {}), children: /* @__PURE__ */ jsx(BlockComponent, { ...normalizedProps }) });
+  return /* @__PURE__ */ jsx(BlockComponent, { ...normalizedProps });
 }
 function PageRenderer({ page }) {
   const blocks = Array.isArray(page.blocks) ? page.blocks : [];

package/dist/lib/blocks/loader.d.ts

@@ -22,6 +22,15 @@ export declare function getBlockComponents(): Record<string, BlockComponent>;
  * @returns The block component or undefined if not found
  */
 export declare function getBlockComponent(slug: string): BlockComponent | undefined;
+/**
+ * Get all SSR block components (direct imports, no React.lazy)
+ * Use for public page rendering where no-JS SSR is required
+ */
+export declare function getBlockComponentsSSR(): Record<string, BlockComponent>;
+/**
+ * Get a specific SSR block component by slug (direct import, no React.lazy)
+ */
+export declare function getBlockComponentSSR(slug: string): BlockComponent | undefined;
 /**
  * Check if a block exists in the registry
  *

package/dist/lib/blocks/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/lib/blocks/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAIrC,KAAK,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;AAExC;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgD3F"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/lib/blocks/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAIrC,KAAK,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;AAExC;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgD3F"}

package/dist/lib/blocks/loader.js

@@ -1,10 +1,16 @@
-import { BLOCK_COMPONENTS } from "@nextsparkjs/registries/block-registry";
+import { BLOCK_COMPONENTS, BLOCK_COMPONENTS_SSR } from "@nextsparkjs/registries/block-registry";
 function getBlockComponents() {
   return BLOCK_COMPONENTS;
 }
 function getBlockComponent(slug) {
   return BLOCK_COMPONENTS[slug];
 }
+function getBlockComponentsSSR() {
+  return BLOCK_COMPONENTS_SSR;
+}
+function getBlockComponentSSR(slug) {
+  return BLOCK_COMPONENTS_SSR[slug];
+}
 function hasBlock(slug) {
   return slug in BLOCK_COMPONENTS;
 }
@@ -48,7 +54,9 @@ function normalizeBlockProps(props) {
 }
 export {
   getBlockComponent,
+  getBlockComponentSSR,
   getBlockComponents,
+  getBlockComponentsSSR,
   hasBlock,
   normalizeBlockProps
 };

package/dist/styles/classes.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-03-31T21:30:22.374Z",
+  "generated": "2026-04-06T20:21:52.643Z",
   "totalClasses": 1078,
   "classes": [
     "!text-2xl",

package/dist/templates/app/(auth)/accept-invite/[token]/page.tsx

@@ -68,7 +68,7 @@ function AcceptInvitePage() {
         }
 
         // Check email match
-        if (user.email.toLowerCase() !== data.data.email.toLowerCase()) {
+        if ((user.email ?? '').toLowerCase()  !== data.data.email.toLowerCase()) {
           setStatus('email_mismatch')
           setErrorMessage(`This invitation was sent to ${data.data.email}, but you are logged in as ${user.email}`)
           return

package/dist/templates/app/api/v1/billing/webhooks/polar/route.ts

@@ -22,7 +22,15 @@ import { query, queryOne } from '@nextsparkjs/core/lib/db'
 import { getBillingGateway } from '@nextsparkjs/core/lib/billing/gateways/factory'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 import type { PolarWebhookExtensions } from '@nextsparkjs/core/lib/billing/polar-webhook'
-import { polarWebhookExtensions } from '@/lib/billing/polar-webhook-extensions'
+
+async function loadExtensions(): Promise<PolarWebhookExtensions> {
+  try {
+    const mod = await import('@/lib/billing/polar-webhook-extensions')
+    return mod.polarWebhookExtensions
+  } catch {
+    return {}
+  }
+}
 
 async function handlePolarWebhook(request: NextRequest) {
   // 1. Get raw body and ALL headers (Polar needs full headers for verification)
@@ -86,7 +94,7 @@ async function handlePolarWebhook(request: NextRequest) {
         break
 
       case 'order.paid':
-        await handleOrderPaid(event.data, eventId, polarWebhookExtensions)
+        await handleOrderPaid(event.data, eventId, await loadExtensions())
         break
 
       default:

package/dist/templates/app/api/v1/billing/webhooks/stripe/route.ts

@@ -3,7 +3,7 @@
  *
  * Handles Stripe subscription lifecycle events.
  * To add one-time payment handling (credit packs, LTD, upsells),
- * override lib/billing/stripe-webhook-extensions.ts in your project.
+ * create lib/billing/stripe-webhook-extensions.ts in your project.
  *
  * Rate limiting: 500 requests/hour per IP (tier: webhook).
  * Stripe signature verification is the primary security layer;
@@ -14,12 +14,21 @@
 
 import { NextRequest } from 'next/server'
 import { handleStripeWebhook } from '@nextsparkjs/core/lib/billing/stripe-webhook'
-import { stripeWebhookExtensions } from '@/lib/billing/stripe-webhook-extensions'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
+async function loadExtensions() {
+  try {
+    const mod = await import('@/lib/billing/stripe-webhook-extensions')
+    return mod.stripeWebhookExtensions
+  } catch {
+    return {}
+  }
+}
+
 export const POST = withRateLimitTier(
   async (request: NextRequest) => {
-    return handleStripeWebhook(request, stripeWebhookExtensions)
+    const extensions = await loadExtensions()
+    return handleStripeWebhook(request, extensions)
   },
   'webhook'
 )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.131",
+  "version": "0.1.0-beta.133",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -462,7 +462,7 @@
     "tailwind-merge": "^3.3.1",
     "uuid": "^13.0.0",
     "zod": "^4.1.5",
-    "@nextsparkjs/testing": "0.1.0-beta.131"
+    "@nextsparkjs/testing": "0.1.0-beta.133"
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.mjs || true",

package/scripts/build/registry/generators/block-registry.mjs

@@ -47,6 +47,13 @@ export const BLOCK_CATEGORIES: string[] = []
 
 export const BLOCK_COMPONENTS: Record<string, React.LazyExoticComponent<React.ComponentType<unknown>>> = {}
 
+/**
+ * Direct-imported block components for SSR rendering
+ * No React.lazy, no Suspense — HTML is fully visible without JS
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const BLOCK_COMPONENTS_SSR: Record<string, React.ComponentType<any>> = {}
+
 export const BLOCK_METADATA = {
   totalBlocks: 0,
   categories: [],
@@ -59,6 +66,8 @@ export const BLOCK_METADATA = {
 
   // Import field definitions and examples (if they exist)
   const imports = []
+  // Direct component imports for SSR (no React.lazy)
+  const ssrImports = []
 
   blocks.forEach(block => {
     const slugVar = block.slug.replace(/-/g, '_')
@@ -66,6 +75,9 @@ export const BLOCK_METADATA = {
     // Always import field definitions
     imports.push(`import { fieldDefinitions as ${slugVar}_fields } from '${block.paths.fields}'`)
 
+    // Direct component import for SSR rendering
+    ssrImports.push(`import { default as ${slugVar}_component } from '${block.paths.component}'`)
+
     // Conditionally import examples if they exist
     if (block.hasExamples) {
       imports.push(`import { examples as ${slugVar}_examples } from '${block.paths.examples}'`)
@@ -73,6 +85,7 @@ export const BLOCK_METADATA = {
   })
 
   const fieldImports = imports.join('\n')
+  const ssrComponentImports = ssrImports.join('\n')
 
   const registryEntries = blocks.map(block => {
     const slugVar = block.slug.replace(/-/g, '_')
@@ -124,6 +137,9 @@ import type { BlockConfig, BlockCategory } from '${convertCorePath('@/core/types
 
 ${fieldImports}
 
+// Direct component imports for SSR (no React.lazy, no Suspense needed)
+${ssrComponentImports}
+
 export const BLOCK_REGISTRY: Record<string, BlockConfig> = {
 ${registryEntries}
 }
@@ -141,6 +157,19 @@ ${blocks.map(block => {
   }).join(',\n')}
 }
 
+/**
+ * Direct-imported block components for SSR rendering
+ * No React.lazy, no Suspense — HTML is fully visible without JS.
+ * Use with SSRPageRenderer for public pages where SEO and no-JS rendering matter.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const BLOCK_COMPONENTS_SSR: Record<string, React.ComponentType<any>> = {
+${blocks.map(block => {
+    const slugVar = block.slug.replace(/-/g, '_')
+    return `  '${block.slug}': ${slugVar}_component`
+  }).join(',\n')}
+}
+
 /**
  * Block registry metadata
  */

package/scripts/build/registry/generators/plugin-registry.mjs

@@ -133,7 +133,7 @@ export interface PluginRegistryEntry {
   hasAssets: boolean
 }
 
-export const PLUGIN_REGISTRY = {
+export const PLUGIN_REGISTRY: Record<string, PluginRegistryEntry> = {
 ${registryEntries}
 }
 

package/templates/app/(auth)/accept-invite/[token]/page.tsx

@@ -68,7 +68,7 @@ function AcceptInvitePage() {
         }
 
         // Check email match
-        if (user.email.toLowerCase() !== data.data.email.toLowerCase()) {
+        if ((user.email ?? '').toLowerCase()  !== data.data.email.toLowerCase()) {
           setStatus('email_mismatch')
           setErrorMessage(`This invitation was sent to ${data.data.email}, but you are logged in as ${user.email}`)
           return

package/templates/app/api/v1/billing/webhooks/polar/route.ts

@@ -22,7 +22,15 @@ import { query, queryOne } from '@nextsparkjs/core/lib/db'
 import { getBillingGateway } from '@nextsparkjs/core/lib/billing/gateways/factory'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 import type { PolarWebhookExtensions } from '@nextsparkjs/core/lib/billing/polar-webhook'
-import { polarWebhookExtensions } from '@/lib/billing/polar-webhook-extensions'
+
+async function loadExtensions(): Promise<PolarWebhookExtensions> {
+  try {
+    const mod = await import('@/lib/billing/polar-webhook-extensions')
+    return mod.polarWebhookExtensions
+  } catch {
+    return {}
+  }
+}
 
 async function handlePolarWebhook(request: NextRequest) {
   // 1. Get raw body and ALL headers (Polar needs full headers for verification)
@@ -86,7 +94,7 @@ async function handlePolarWebhook(request: NextRequest) {
         break
 
       case 'order.paid':
-        await handleOrderPaid(event.data, eventId, polarWebhookExtensions)
+        await handleOrderPaid(event.data, eventId, await loadExtensions())
         break
 
       default:

package/templates/app/api/v1/billing/webhooks/stripe/route.ts

@@ -3,7 +3,7 @@
  *
  * Handles Stripe subscription lifecycle events.
  * To add one-time payment handling (credit packs, LTD, upsells),
- * override lib/billing/stripe-webhook-extensions.ts in your project.
+ * create lib/billing/stripe-webhook-extensions.ts in your project.
  *
  * Rate limiting: 500 requests/hour per IP (tier: webhook).
  * Stripe signature verification is the primary security layer;
@@ -14,12 +14,21 @@
 
 import { NextRequest } from 'next/server'
 import { handleStripeWebhook } from '@nextsparkjs/core/lib/billing/stripe-webhook'
-import { stripeWebhookExtensions } from '@/lib/billing/stripe-webhook-extensions'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
+async function loadExtensions() {
+  try {
+    const mod = await import('@/lib/billing/stripe-webhook-extensions')
+    return mod.stripeWebhookExtensions
+  } catch {
+    return {}
+  }
+}
+
 export const POST = withRateLimitTier(
   async (request: NextRequest) => {
-    return handleStripeWebhook(request, stripeWebhookExtensions)
+    const extensions = await loadExtensions()
+    return handleStripeWebhook(request, extensions)
   },
   'webhook'
 )

package/tests/jest/__mocks__/@nextsparkjs/registries/block-registry.ts

@@ -6,6 +6,8 @@ export const BLOCK_REGISTRY: Record<string, any> = {}
 
 export const BLOCK_COMPONENTS: Record<string, any> = {}
 
+export const BLOCK_COMPONENTS_SSR: Record<string, any> = {}
+
 export const BLOCK_METADATA = {
   generated: new Date().toISOString(),
   totalBlocks: 0,