@nextsparkjs/core 0.1.0-beta.189 → 0.1.0-beta.190

package/dist/templates/app/api/v1/billing/cancel/route.ts

@@ -8,7 +8,7 @@
  */
 
 import { NextRequest, NextResponse } from 'next/server'
-import { z } from 'zod'
+import * as z from 'zod'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
 import { SubscriptionService, MembershipService } from '@nextsparkjs/core/lib/services'
 import { getBillingGateway } from '@nextsparkjs/core/lib/billing/gateways/factory'

package/dist/templates/app/api/v1/billing/change-plan/route.ts

@@ -8,7 +8,7 @@
  */
 
 import { NextRequest, NextResponse } from 'next/server'
-import { z } from 'zod'
+import * as z from 'zod'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
 import { SubscriptionService, MembershipService } from '@nextsparkjs/core/lib/services'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'

package/dist/templates/app/api/v1/billing/check-action/route.ts

@@ -12,7 +12,7 @@
 import { NextRequest, NextResponse } from 'next/server'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
 import { SubscriptionService } from '@nextsparkjs/core/lib/services'
-import { z } from 'zod'
+import * as z from 'zod'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
 const checkActionSchema = z.object({

package/dist/templates/app/api/v1/billing/checkout/route.ts

@@ -11,7 +11,7 @@ import { NextRequest, NextResponse } from 'next/server'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
 import { getBillingGateway } from '@nextsparkjs/core/lib/billing/gateways/factory'
 import { SubscriptionService, MembershipService } from '@nextsparkjs/core/lib/services'
-import { z } from 'zod'
+import * as z from 'zod'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
 const checkoutSchema = z.object({

package/dist/templates/app/api/v1/blocks/validate/route.ts

@@ -1,6 +1,6 @@
 import { NextRequest, NextResponse } from 'next/server'
 import { BLOCK_REGISTRY } from '@nextsparkjs/registries/block-registry'
-import { z } from 'zod'
+import * as z from 'zod'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
 const requestSchema = z.object({

package/dist/templates/app/api/v1/media/[id]/tags/route.ts

@@ -5,7 +5,7 @@ import { API_ERROR_CODES } from '@nextsparkjs/core/lib/api/api-error'
 import { checkPermission } from '@nextsparkjs/core/lib/permissions/check'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 import { MediaService } from '@nextsparkjs/core/lib/services/media.service'
-import { z } from 'zod'
+import * as z from 'zod'
 
 const addTagSchema = z.object({
   tagId: z.string().min(1),

package/dist/templates/app/api/v1/post-categories/[id]/route.ts

@@ -1,7 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
 import { query as dbQuery } from '@nextsparkjs/core/lib/db'
-import { z } from 'zod'
+import * as z from 'zod'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
 const updateCategorySchema = z.object({

package/dist/templates/app/api/v1/post-categories/route.ts

@@ -1,7 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
 import { query as dbQuery } from '@nextsparkjs/core/lib/db'
-import { z } from 'zod'
+import * as z from 'zod'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
 const createCategorySchema = z.object({

package/dist/templates/app/api/v1/teams/[teamId]/members/route.ts

@@ -19,6 +19,7 @@ import type { TeamMember, TeamInvitation, TeamRole, Team } from '@nextsparkjs/co
 import { EmailFactory } from '@nextsparkjs/core/lib/email/factory'
 import { sendTeamInvitationEmail } from '@nextsparkjs/core/lib/email/send'
 import { I18N_CONFIG } from '@nextsparkjs/core/lib/config'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 // Handle CORS preflight
 export async function OPTIONS(request: NextRequest) {
@@ -294,7 +295,7 @@ export const POST = withRateLimitTier(withApiLogging(
 
       // Build accept URL
       const baseUrl = (process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:5173').replace(/\/$/, '')
-      const acceptUrl = `${baseUrl}/accept-invite/${token}`
+      const acceptUrl = `${baseUrl}${withBasePath(`/accept-invite/${token}`)}`
 
       // Send invitation email
       try {

package/dist/templates/app/api/v1/teams/[teamId]/subscription/route.ts

@@ -41,11 +41,9 @@ export const GET = withRateLimitTier(async function GET(request: NextRequest, pr
 
     const subscription = await SubscriptionService.getActive(teamId)
 
-    if (!subscription) {
-      return createApiError('No active subscription found for this team', 404)
-    }
-
-    return createApiResponse({ subscription })
+    // A team can legitimately have no subscription yet. Keep that normal state
+    // in the successful response so dashboard loads do not log a 404.
+    return createApiResponse({ subscription: subscription ?? null })
   } catch (error) {
     console.error('[Billing API] Error fetching subscription:', error)
     return createApiError('Failed to fetch subscription', 500)

package/dist/templates/app/api/v1/teams/docs.md

@@ -194,25 +194,20 @@ Same as POST /members - creates a new invitation.
 ### Get Team Subscription
 `GET /api/v1/teams/[teamId]/subscription`
 
-Returns the team's active subscription details. Requires `billing.view` permission.
+Returns the team's active subscription details, or `null` when the team has not subscribed yet. Requires `billing.view` permission.
 
 **Response:**
 ```json
 {
   "success": true,
   "data": {
-    "subscription": {
-      "id": "sub_123",
-      "planId": "plan_pro",
-      "planName": "Pro",
-      "status": "active",
-      "currentPeriodEnd": "2024-03-01T00:00:00Z",
-      "cancelAtPeriodEnd": false
-    }
+    "subscription": null
   }
 }
 ```
 
+When an active subscription exists, `subscription` contains its details.
+
 ---
 
 ## Usage & Quota Endpoints

package/dist/templates/app/api/v1/teams/switch/route.ts

@@ -14,7 +14,7 @@ import {
   ACTIVE_TEAM_COOKIE_MAX_AGE,
   activeTeamCookieValue,
 } from '@nextsparkjs/core/lib/teams/active-team-cookie'
-import { z } from 'zod'
+import * as z from 'zod'
 
 const switchTeamSchema = z.object({
   teamId: z.string().min(1, 'Team ID is required'),

package/dist/templates/app/api/v1/users/[id]/meta/[key]/route.ts

@@ -29,7 +29,7 @@ import {
   addCorsHeaders,
 } from '@nextsparkjs/core/lib/api/helpers'
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth'
-import { z } from 'zod'
+import * as z from 'zod'
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit'
 
 // Validation schema for metadata value

package/dist/templates/app/api/v1/users/[id]/route.ts

@@ -12,7 +12,7 @@ import {
   processEntityMetadata
 } from '@nextsparkjs/core/lib/api/helpers';
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth';
-import { z } from 'zod';
+import * as z from 'zod';
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit';
 
 const updateUserSchema = z.object({

package/dist/templates/app/api/v1/users/route.ts

@@ -16,7 +16,7 @@ import {
 } from '@nextsparkjs/core/lib/api/helpers';
 import { authenticateRequest, createAuthFailureResponse } from '@nextsparkjs/core/lib/api/auth/dual-auth';
 import { hasAdminPermission } from '@nextsparkjs/core/lib/api/auth/permissions';
-import { z } from 'zod';
+import * as z from 'zod';
 import { withRateLimitTier } from '@nextsparkjs/core/lib/api/rate-limit';
 
 const createUserSchema = z.object({

package/dist/templates/app/dashboard/(main)/media/page.tsx

@@ -51,6 +51,7 @@ import { usePermissions } from '@nextsparkjs/core/lib/permissions/hooks'
 import { getTemplateOrDefaultClient } from '@nextsparkjs/registries/template-registry.client'
 import type { Media, MediaListOptions } from '@nextsparkjs/core/lib/media/types'
 import type { Permission } from '@nextsparkjs/core/lib/permissions/types'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 type ViewMode = 'grid' | 'list'
 
@@ -484,8 +485,9 @@ function DefaultMediaDashboardPage() {
             {/* Left: Image preview - Dark canvas */}
             <div className="relative bg-neutral-950 flex items-center justify-center overflow-hidden h-[250px] md:h-auto">
               {editingMedia?.mimeType.startsWith('image/') ? (
+                // eslint-disable-next-line @next/next/no-img-element -- the original upload at its own size, whose dimensions next/image would need up front
                 <img
-                  src={editingMedia.url}
+                  src={withBasePathIfInApp(editingMedia.url)}
                   alt={editingMedia.alt || editingMedia.filename}
                   className="max-w-[90%] max-h-[90%] object-contain select-none"
                   draggable={false}

package/dist/templates/app/dashboard/settings/api-keys/page.tsx

@@ -37,6 +37,7 @@ import { ApiKeyDisplay } from '@nextsparkjs/core/components/api/keys/ApiKeyDispl
 import { toast } from 'sonner';
 import { getTemplateOrDefaultClient } from '@nextsparkjs/registries/template-registry.client'
 import { sel } from '@nextsparkjs/core/selectors'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 interface ApiKey {
   id: string;
@@ -73,7 +74,7 @@ function ApiKeysPage() {
   const { data: apiKeys, isLoading, error } = useQuery<ApiKey[]>({
     queryKey: ['api-keys'],
     queryFn: async () => {
-      const response = await fetch('/api/v1/api-keys');
+      const response = await fetch(withBasePath('/api/v1/api-keys'));
       if (!response.ok) {
         const errorData = await response.json();
         throw new Error(errorData.error || 'Failed to fetch API keys');
@@ -86,7 +87,7 @@ function ApiKeysPage() {
   // Revoke API key mutation
   const revokeApiKey = useMutation({
     mutationFn: async (keyId: string) => {
-      const response = await fetch(`/api/v1/api-keys/${keyId}`, {
+      const response = await fetch(withBasePath(`/api/v1/api-keys/${keyId}`), {
         method: 'DELETE'
       });
       if (!response.ok) {
@@ -107,7 +108,7 @@ function ApiKeysPage() {
   // Toggle API key status
   const toggleApiKey = useMutation({
     mutationFn: async ({ keyId, status }: { keyId: string; status: 'active' | 'inactive' }) => {
-      const response = await fetch(`/api/v1/api-keys/${keyId}`, {
+      const response = await fetch(withBasePath(`/api/v1/api-keys/${keyId}`), {
         method: 'PATCH',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ status })
@@ -417,7 +418,7 @@ function ApiKeyDetailsDialog({
   const { data: keyDetails, isLoading } = useQuery({
     queryKey: ['api-key-details', keyId],
     queryFn: async () => {
-      const response = await fetch(`/api/v1/api-keys/${keyId}`);
+      const response = await fetch(withBasePath(`/api/v1/api-keys/${keyId}`));
       if (!response.ok) throw new Error('Failed to fetch API key details');
       const result = await response.json();
       return result.data;

package/dist/templates/app/dashboard/settings/profile/page.tsx

@@ -64,6 +64,7 @@ import { countries, timezones } from '@nextsparkjs/core/lib/countries-timezones'
 import { sel } from '@nextsparkjs/core/selectors'
 import { useLocale, useTranslations } from 'next-intl'
 import { getTemplateOrDefaultClient } from '@nextsparkjs/registries/template-registry.client'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 // Language options
 const languages = [
@@ -119,7 +120,7 @@ function ProfilePage() {
   // Update profile mutation
   const updateProfileMutation = useMutation({
     mutationFn: async (data: ProfileFormData) => {
-      const response = await fetch('/api/user/profile', {
+      const response = await fetch(withBasePath('/api/user/profile'), {
         method: 'PATCH',
         headers: {
           'Content-Type': 'application/json',
@@ -151,7 +152,7 @@ function ProfilePage() {
   // Delete account mutation
   const deleteAccountMutation = useMutation({
     mutationFn: async () => {
-      const response = await fetch('/api/user/delete-account', {
+      const response = await fetch(withBasePath('/api/user/delete-account'), {
         method: 'DELETE',
         headers: {
           'Content-Type': 'application/json',

package/dist/templates/app/devtools/scheduled-actions/page.tsx

@@ -23,6 +23,7 @@ import { sel } from '@nextsparkjs/core/selectors'
 import { Filters } from '@nextsparkjs/core/components/devtools/scheduled-actions/filters'
 import { ActionsTable } from '@nextsparkjs/core/components/devtools/scheduled-actions/actions-table'
 import type { ScheduledActionsFilters, ScheduledActionsResponse } from '@nextsparkjs/core/components/devtools/scheduled-actions/types'
+import { withBasePath } from '@nextsparkjs/core/lib/base-path'
 
 async function fetchScheduledActions(
   filters: ScheduledActionsFilters,
@@ -42,7 +43,7 @@ async function fetchScheduledActions(
   params.append('page', page.toString())
   params.append('limit', limit.toString())
 
-  const response = await fetch(`/api/v1/devtools/scheduled-actions?${params.toString()}`)
+  const response = await fetch(withBasePath(`/api/v1/devtools/scheduled-actions?${params.toString()}`))
 
   if (!response.ok) {
     throw new Error('Failed to fetch scheduled actions')

package/dist/templates/app/superadmin/docs/[section]/[page]/page.tsx

@@ -15,6 +15,22 @@ interface SuperadminDocsPageProps {
   }>
 }
 
+// generateStaticParams below lists every superadmin doc page, and
+// dynamicParams = false answers 404 for any other section/page pair in
+// `next dev`. connection() keeps these pages from being prerendered, so a
+// production build renders them on demand, where Next has no prerendered list
+// to check, and the notFound() calls below cannot set the status either: they
+// run inside the superadmin layout's Suspense boundary, after the response
+// head has gone out with a 200. For those requests the proxy answers 404
+// before anything renders (isMissingDocsPage in proxy.ts).
+export const dynamicParams = false
+
+export async function generateStaticParams() {
+  return DOCS_REGISTRY.superadmin.flatMap(section =>
+    section.pages.map(page => ({ section: section.slug, page: page.slug }))
+  )
+}
+
 export async function generateMetadata({ params }: SuperadminDocsPageProps): Promise<Metadata> {
   const resolvedParams = await params
   const { section: sectionSlug, page: pageSlug } = resolvedParams

package/dist/templates/app/superadmin/subscriptions/page.tsx

@@ -43,6 +43,7 @@ import {
   ExternalLink,
 } from "lucide-react";
 import Link from "next/link";
+import { withBasePath, withBasePathIfInApp } from "@nextsparkjs/core/lib/base-path";
 import { getTemplateOrDefaultClient } from "@nextsparkjs/registries/template-registry.client";
 import {
   SearchInput,
@@ -229,7 +230,7 @@ function SubscriptionsPage() {
     queryFn: async () => {
       const queryString = getQueryParams();
       const url = `/api/superadmin/subscriptions${queryString ? `?${queryString}` : ""}`;
-      const response = await fetch(url);
+      const response = await fetch(withBasePath(url));
       if (!response.ok) {
         throw new Error("Failed to fetch subscriptions data");
       }
@@ -600,7 +601,7 @@ function SubscriptionsPage() {
                                   className="text-muted-foreground"
                                 >
                                   <a
-                                    href={sub.providerDashboardUrl}
+                                    href={withBasePathIfInApp(sub.providerDashboardUrl)}
                                     target="_blank"
                                     rel="noopener noreferrer"
                                   >

package/dist/templates/app/superadmin/teams/[teamId]/page.tsx

@@ -43,6 +43,7 @@ import {
 } from "lucide-react";
 import Link from "next/link";
 import { getTemplateOrDefaultClient } from "@nextsparkjs/registries/template-registry.client";
+import { withBasePath, withBasePathIfInApp } from "@nextsparkjs/core/lib/base-path"
 
 interface TeamOwner {
   id: string;
@@ -153,7 +154,7 @@ function TeamDetailPage() {
   const { data: teamData, isLoading, error, refetch } = useQuery<TeamDetailData>({
     queryKey: ["superadmin-team", teamId],
     queryFn: async () => {
-      const response = await fetch(`/api/superadmin/teams/${teamId}`);
+      const response = await fetch(withBasePath(`/api/superadmin/teams/${teamId}`));
       if (!response.ok) {
         if (response.status === 404) {
           throw new Error("Team not found");
@@ -503,7 +504,7 @@ function TeamDetailPage() {
                         {teamData.subscription.providerName || 'Payment Provider'}
                       </h4>
                       <a
-                        href={teamData.subscription.providerDashboardUrl}
+                        href={withBasePathIfInApp(teamData.subscription.providerDashboardUrl)}
                         target="_blank"
                         rel="noopener noreferrer"
                         className="inline-flex items-center gap-1 text-sm text-primary hover:underline"
@@ -604,7 +605,7 @@ function TeamDetailPage() {
                         <div className="flex items-center gap-2">
                           {event.invoiceUrl && (
                             <a
-                              href={event.invoiceUrl}
+                              href={withBasePathIfInApp(event.invoiceUrl)}
                               target="_blank"
                               rel="noopener noreferrer"
                               className="text-primary hover:underline text-sm"
@@ -614,7 +615,7 @@ function TeamDetailPage() {
                           )}
                           {event.receiptUrl && (
                             <a
-                              href={event.receiptUrl}
+                              href={withBasePathIfInApp(event.receiptUrl)}
                               target="_blank"
                               rel="noopener noreferrer"
                               className="text-primary hover:underline text-sm"

package/dist/templates/app/superadmin/users/[userId]/page.tsx

@@ -39,6 +39,7 @@ import {
 } from "lucide-react";
 import Link from "next/link";
 import { getTemplateOrDefaultClient } from "@nextsparkjs/registries/template-registry.client";
+import { withBasePath } from "@nextsparkjs/core/lib/base-path"
 
 interface TeamMembership {
   teamId: string;
@@ -114,7 +115,7 @@ function UserDetailPage() {
   const { data: userData, isLoading, error, refetch } = useQuery<UserDetailData>({
     queryKey: ["superadmin-user", userId],
     queryFn: async () => {
-      const response = await fetch(`/api/superadmin/users/${userId}`);
+      const response = await fetch(withBasePath(`/api/superadmin/users/${userId}`));
       if (!response.ok) {
         if (response.status === 404) {
           throw new Error("User not found");

package/dist/templates/app/superadmin/users/page.tsx

@@ -38,6 +38,7 @@ import {
   FilterDropdown,
 } from "@nextsparkjs/core/components/superadmin/filters";
 import { sel } from "@nextsparkjs/core/selectors";
+import { withBasePath } from "@nextsparkjs/core/lib/base-path"
 
 interface UsersData {
   regularUsers: User[];
@@ -119,7 +120,7 @@ function UsersPage() {
     queryKey: ["superadmin-users", search, roleFilter, statusFilter, activeTab, page, limit],
     queryFn: async () => {
       const queryString = getQueryParams();
-      const response = await fetch(`/api/superadmin/users?${queryString}`);
+      const response = await fetch(withBasePath(`/api/superadmin/users?${queryString}`));
       if (!response.ok) {
         throw new Error("Failed to fetch users data");
       }

package/dist/templates/blocks/cta-section/component.tsx

@@ -2,6 +2,7 @@ import React from 'react'
 import { Button } from '@nextsparkjs/core/components/ui/button'
 import { buildSectionClasses } from '@nextsparkjs/core/types/blocks'
 import type { CTASectionBlockProps } from './schema'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 /**
  * CTA Section Block Component
@@ -67,7 +68,7 @@ export function CTASectionBlock({
             {primaryCta && (
               <Button asChild size="lg">
                 <a
-                  href={primaryCta.link}
+                  href={withBasePathIfInApp(primaryCta.link)}
                   target={primaryCta.target}
                   rel={primaryCta.target === '_blank' ? 'noopener noreferrer' : undefined}
                 >
@@ -83,7 +84,7 @@ export function CTASectionBlock({
                 variant={secondaryButton.variant || 'outline'}
               >
                 <a
-                  href={secondaryButton.link}
+                  href={withBasePathIfInApp(secondaryButton.link)}
                   target={secondaryButton.target}
                   rel={secondaryButton.target === '_blank' ? 'noopener noreferrer' : undefined}
                 >

package/dist/templates/blocks/cta-section/schema.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import * as z from 'zod'
 import { baseBlockSchema, ctaSchema } from '@nextsparkjs/core/types/blocks'
 
 /**

package/dist/templates/blocks/features-grid/component.tsx

@@ -8,6 +8,7 @@ import * as Icons from 'lucide-react'
 import { cn } from '@nextsparkjs/core/lib/utils'
 import { buildSectionClasses } from '@nextsparkjs/core/types/blocks'
 import type { FeaturesGridBlockProps, FeatureItem } from './schema'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 /**
  * Features Grid Block Component
@@ -101,7 +102,7 @@ export function FeaturesGridBlock({
         {cta && (
           <div className="mt-12 text-center">
             <a
-              href={cta.link}
+              href={withBasePathIfInApp(cta.link)}
               target={cta.target}
               rel={cta.target === '_blank' ? 'noopener noreferrer' : undefined}
               className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors"

package/dist/templates/blocks/features-grid/schema.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import * as z from 'zod'
 import { baseBlockSchema } from '@nextsparkjs/core/types/blocks'
 
 /**

package/dist/templates/blocks/hero/component.tsx

@@ -3,6 +3,7 @@ import { Button } from '@nextsparkjs/core/components/ui/button'
 import { cn } from '@nextsparkjs/core/lib/utils'
 import { buildSectionClasses, resolveMediaUrl } from '@nextsparkjs/core/types/blocks'
 import type { HeroBlockProps } from './schema'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 /**
  * Hero Block Component
@@ -62,7 +63,7 @@ export function HeroBlock({
         <div
           className="absolute inset-0 z-0"
           style={{
-            backgroundImage: `url(${backgroundImageUrl})`,
+            backgroundImage: `url(${withBasePathIfInApp(backgroundImageUrl)})`,
             backgroundSize: 'cover',
             backgroundPosition: 'center',
           }}
@@ -88,7 +89,7 @@ export function HeroBlock({
         {ctaConfig && (
           <Button asChild size="lg" className="text-lg px-8 py-6">
             <a
-              href={ctaConfig.link}
+              href={withBasePathIfInApp(ctaConfig.link)}
               target={ctaConfig.target}
               rel={ctaConfig.target === '_blank' ? 'noopener noreferrer' : undefined}
             >

package/dist/templates/blocks/hero/schema.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import * as z from 'zod'
 import {
   baseBlockSchema,
   mediaRefSchema,

package/dist/templates/blocks/testimonials/component.tsx

@@ -4,6 +4,7 @@ import { Avatar, AvatarFallback, AvatarImage } from '@nextsparkjs/core/component
 import { cn } from '@nextsparkjs/core/lib/utils'
 import { buildSectionClasses, resolveMediaUrl } from '@nextsparkjs/core/types/blocks'
 import type { TestimonialsBlockProps, TestimonialItem } from './schema'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 /**
  * Testimonials Block Component
@@ -98,7 +99,7 @@ export function TestimonialsBlock({
         {cta && (
           <div className="mt-12 text-center">
             <a
-              href={cta.link}
+              href={withBasePathIfInApp(cta.link)}
               target={cta.target}
               rel={cta.target === '_blank' ? 'noopener noreferrer' : undefined}
               className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors"

package/dist/templates/blocks/testimonials/schema.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import * as z from 'zod'
 import { baseBlockSchema, mediaRefSchema } from '@nextsparkjs/core/types/blocks'
 
 /**

package/dist/templates/blocks/text-content/component.tsx

@@ -3,6 +3,7 @@ import { cn } from '@nextsparkjs/core/lib/utils'
 import { buildSectionClasses } from '@nextsparkjs/core/types/blocks'
 import { sanitizeBlockHtml } from '@nextsparkjs/core/lib/blocks/sanitize-html'
 import type { TextContentBlockProps } from './schema'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 /**
  * Text Content Block Component
@@ -82,7 +83,7 @@ export function TextContentBlock({
             alignmentClasses[alignment]
           )}>
             <a
-              href={cta.link}
+              href={withBasePathIfInApp(cta.link)}
               target={cta.target}
               rel={cta.target === '_blank' ? 'noopener noreferrer' : undefined}
               className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors"

package/dist/templates/blocks/text-content/schema.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import * as z from 'zod'
 import { baseBlockSchema } from '@nextsparkjs/core/types/blocks'
 
 /**

package/dist/templates/ci-workflows/README.md

@@ -35,7 +35,7 @@ Runs critical path tests on every PR to catch breaking changes quickly.
 
 **Configuration:**
 - Uses `@smoke` tag to filter tests
-- Runs on Ubuntu with Node.js 20
+- Runs on Ubuntu with Node.js 22.14.0 or later
 - Uploads artifacts on failure
 
 ### cypress-regression.yml

package/dist/templates/ci-workflows/github/cypress-regression.yml

@@ -42,7 +42,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2

package/dist/templates/ci-workflows/github/cypress-smoke.yml

@@ -35,7 +35,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2

package/dist/templates/contents/plugins/starter/plugin/api/example/route.ts.template

@@ -8,7 +8,7 @@
  */
 
 import { NextRequest, NextResponse } from 'next/server'
-import { z } from 'zod'
+import * as z from 'zod'
 import { getAuthContext } from '@/core/lib/api/auth'
 import { usePlugin } from '@/core/lib/registries/plugin-registry'
 

package/dist/templates/contents/themes/starter/blocks/cta-section/component.tsx

@@ -2,6 +2,7 @@ import React from 'react'
 import { Button } from '@nextsparkjs/core/components/ui/button'
 import { buildSectionClasses } from '@nextsparkjs/core/types/blocks'
 import type { CTASectionBlockProps } from './schema'
+import { withBasePathIfInApp } from '@nextsparkjs/core/lib/base-path'
 
 /**
  * CTA Section Block Component
@@ -67,7 +68,7 @@ export function CTASectionBlock({
             {primaryCta && (
               <Button asChild size="lg">
                 <a
-                  href={primaryCta.link}
+                  href={withBasePathIfInApp(primaryCta.link)}
                   target={primaryCta.target}
                   rel={primaryCta.target === '_blank' ? 'noopener noreferrer' : undefined}
                 >
@@ -83,7 +84,7 @@ export function CTASectionBlock({
                 variant={secondaryButton.variant || 'outline'}
               >
                 <a
-                  href={secondaryButton.link}
+                  href={withBasePathIfInApp(secondaryButton.link)}
                   target={secondaryButton.target}
                   rel={secondaryButton.target === '_blank' ? 'noopener noreferrer' : undefined}
                 >