create-nextblock 0.2.78 → 0.8.1

package/templates/nextblock-template/app/sitemap.ts

@@ -0,0 +1,128 @@
+import type { MetadataRoute } from 'next';
+import { verifyPackageOnline } from '@nextblock-cms/db/server';
+import {
+  fetchAllActiveProducts,
+  fetchAllPublishedPages,
+  fetchAllPublishedPosts,
+  type SitemapEntry,
+} from './lib/sitemap-utils';
+
+/**
+ * Cache the generated sitemap and rebuild it at most once an hour. Crawlers get
+ * a fast, statically-served file while newly published pages/posts/products
+ * still appear without a redeploy.
+ *
+ * NextBlock does not enable Next.js Cache Components, so the route-segment
+ * `revalidate` config is the idiomatic caching control here (it matches the
+ * rest of the app's ISR cadence). If `cacheComponents` were turned on, the
+ * equivalent would be a `'use cache'` body paired with `cacheLife('hours')`
+ * instead of this export.
+ */
+export const revalidate = 3600;
+
+type SitemapItem = MetadataRoute.Sitemap[number];
+type ChangeFrequency = NonNullable<SitemapItem['changeFrequency']>;
+
+const BASE_URL = (process.env.NEXT_PUBLIC_URL || 'http://localhost:3000').replace(/\/+$/, '');
+
+function toAbsolute(path: string): string {
+  return `${BASE_URL}${path.startsWith('/') ? path : `/${path}`}`;
+}
+
+/** Maps a language-aware {@link SitemapEntry} onto a Next.js sitemap item. */
+function toSitemapItem(
+  entry: SitemapEntry,
+  changeFrequency: ChangeFrequency,
+  priority: number,
+): SitemapItem {
+  const item: SitemapItem = {
+    url: toAbsolute(entry.path),
+    lastModified: entry.lastModified,
+    changeFrequency,
+    priority,
+  };
+
+  if (entry.alternates) {
+    item.alternates = {
+      // Next.js renders this map as <xhtml:link rel="alternate" hreflang=.. href=.. />.
+      languages: Object.fromEntries(
+        Object.entries(entry.alternates).map(([code, path]) => [code, toAbsolute(path)]),
+      ),
+    };
+  }
+
+  return item;
+}
+
+async function safe(
+  label: string,
+  load: () => Promise<SitemapEntry[]>,
+): Promise<SitemapEntry[]> {
+  try {
+    return await load();
+  } catch (error) {
+    console.error(`Sitemap: failed to load ${label}.`, error);
+    return [];
+  }
+}
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  // Disposable sandbox deployments should not advertise an indexable sitemap
+  // (mirrors the legacy app/sitemap.xml route and app/robots.txt).
+  if (process.env.NEXT_PUBLIC_IS_SANDBOX === 'true') {
+    return [];
+  }
+
+  if (!process.env.NEXT_PUBLIC_URL) {
+    console.warn(
+      'Warning: NEXT_PUBLIC_URL is not set for the sitemap. Defaulting to http://localhost:3000 — set this in production.',
+    );
+  }
+
+  // Products live behind the premium ecommerce package; their routes 404 when
+  // it is inactive (see app/product/[slug]/page.tsx), so only advertise them
+  // when the package verifies as active.
+  let ecommerceActive = false;
+  try {
+    ecommerceActive = await verifyPackageOnline('ecommerce');
+  } catch (error) {
+    console.error('Sitemap: failed to verify the ecommerce package; omitting products.', error);
+  }
+
+  const [pages, posts, products] = await Promise.all([
+    safe('pages', fetchAllPublishedPages),
+    safe('posts', fetchAllPublishedPosts),
+    ecommerceActive
+      ? safe('products', fetchAllActiveProducts)
+      : Promise.resolve<SitemapEntry[]>([]),
+  ]);
+
+  // Code-defined route with no row in the content tables. The homepage is served
+  // at "/" (its `home`/`accueil` page rows are excluded from the pages query to
+  // avoid duplicate URLs).
+  const homepage: SitemapItem = {
+    url: toAbsolute('/'),
+    lastModified: new Date().toISOString(),
+    changeFrequency: 'daily',
+    priority: 1,
+  };
+
+  const items: SitemapItem[] = [
+    homepage,
+    ...pages.map((entry) => toSitemapItem(entry, 'weekly', 0.8)),
+    ...posts.map((entry) => toSitemapItem(entry, 'weekly', 0.6)),
+    ...products.map((entry) => toSitemapItem(entry, 'daily', 0.7)),
+  ];
+
+  // Translations can share a slug (NextBlock has no locale path prefix), so the
+  // same URL may surface more than once. Collapse duplicates, keeping the first
+  // (highest-priority) occurrence.
+  const seen = new Set<string>();
+  return items.filter((item) => {
+    if (seen.has(item.url)) {
+      return false;
+    }
+    seen.add(item.url);
+    return true;
+  });
+}

package/templates/nextblock-template/app/ucp/v1/carts/[id]/cancel/route.ts

@@ -0,0 +1,38 @@
+import { NextResponse } from 'next/server';
+import {
+  buildProtocolError,
+  cancelUcpCart,
+  ensureEcommerceOnline,
+} from '../../../../../lib/ucp/server';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+interface CartCancelRouteContext {
+  params: Promise<{ id: string }>;
+}
+
+export async function POST(request: Request, context: CartCancelRouteContext) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const { id } = await context.params;
+    const result = await cancelUcpCart(id, request);
+    return NextResponse.json(result.body, { status: result.status });
+  } catch (error) {
+    console.error('UCP cancel cart error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Cart cancellation failed.'),
+      { status: 500 }
+    );
+  }
+}

package/templates/nextblock-template/app/ucp/v1/carts/[id]/route.ts

@@ -0,0 +1,68 @@
+import { NextResponse } from 'next/server';
+import {
+  buildProtocolError,
+  ensureEcommerceOnline,
+  getUcpCart,
+  parseJsonBody,
+  updateUcpCart,
+} from '../../../../lib/ucp/server';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+interface CartRouteContext {
+  params: Promise<{ id: string }>;
+}
+
+export async function GET(request: Request, context: CartRouteContext) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const { id } = await context.params;
+    const result = await getUcpCart(id, request);
+    return NextResponse.json(result.body, { status: result.status });
+  } catch (error) {
+    console.error('UCP get cart error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Cart retrieval failed.'),
+      { status: 500 }
+    );
+  }
+}
+
+export async function PUT(request: Request, context: CartRouteContext) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const { id } = await context.params;
+    const body = await parseJsonBody(request);
+    const result = await updateUcpCart(id, body, request);
+    return NextResponse.json(result.body, { status: result.status });
+  } catch (error) {
+    console.error('UCP update cart error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Cart update failed.'),
+      { status: 500 }
+    );
+  }
+}
+
+export const PATCH = PUT;

package/templates/nextblock-template/app/ucp/v1/carts/route.ts

@@ -0,0 +1,35 @@
+import { NextResponse } from 'next/server';
+import {
+  buildProtocolError,
+  createUcpCart,
+  ensureEcommerceOnline,
+  parseJsonBody,
+} from '../../../lib/ucp/server';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+export async function POST(request: Request) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const body = await parseJsonBody(request);
+    const result = await createUcpCart(body, request);
+    return NextResponse.json(result.body, { status: result.status });
+  } catch (error) {
+    console.error('UCP create cart error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Cart creation failed.'),
+      { status: 500 }
+    );
+  }
+}

package/templates/nextblock-template/app/ucp/v1/catalog/lookup/route.ts

@@ -0,0 +1,35 @@
+import { NextResponse } from 'next/server';
+import {
+  buildProtocolError,
+  ensureEcommerceOnline,
+  lookupCatalogProducts,
+  parseJsonBody,
+} from '../../../../lib/ucp/server';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+export async function POST(request: Request) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const body = await parseJsonBody(request);
+    const result = await lookupCatalogProducts(body, request);
+    return NextResponse.json(result.body, { status: result.status });
+  } catch (error) {
+    console.error('UCP catalog lookup error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Catalog lookup failed.'),
+      { status: 500 }
+    );
+  }
+}

package/templates/nextblock-template/app/ucp/v1/catalog/product/route.ts

@@ -0,0 +1,35 @@
+import { NextResponse } from 'next/server';
+import {
+  buildProtocolError,
+  ensureEcommerceOnline,
+  getCatalogProduct,
+  parseJsonBody,
+} from '../../../../lib/ucp/server';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+export async function POST(request: Request) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const body = await parseJsonBody(request);
+    const result = await getCatalogProduct(body, request);
+    return NextResponse.json(result.body, { status: result.status });
+  } catch (error) {
+    console.error('UCP catalog product error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Catalog product lookup failed.'),
+      { status: 500 }
+    );
+  }
+}

package/templates/nextblock-template/app/ucp/v1/catalog/search/route.ts

@@ -0,0 +1,34 @@
+import { NextResponse } from 'next/server';
+import {
+  buildProtocolError,
+  ensureEcommerceOnline,
+  parseJsonBody,
+  searchCatalogProducts,
+} from '../../../../lib/ucp/server';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+export async function POST(request: Request) {
+  try {
+    const isOnline = await ensureEcommerceOnline();
+    if (!isOnline) {
+      return NextResponse.json(
+        buildProtocolError(
+          'ecommerce_unavailable',
+          'Ecommerce module license is inactive.'
+        ),
+        { status: 403 }
+      );
+    }
+
+    const body = await parseJsonBody(request);
+    return NextResponse.json(await searchCatalogProducts(body, request));
+  } catch (error) {
+    console.error('UCP catalog search error:', error);
+    return NextResponse.json(
+      buildProtocolError('internal_server_error', 'Catalog search failed.'),
+      { status: 500 }
+    );
+  }
+}

package/templates/nextblock-template/components/AppShell.tsx

@@ -0,0 +1,154 @@
+'use client';
+
+import type { Database } from '@nextblock-cms/db';
+import { cn } from '@nextblock-cms/utils';
+import { usePathname } from 'next/navigation';
+import Link from 'next/link';
+import { createContext, useContext, useMemo, type ReactNode } from 'react';
+import Header from './Header';
+import FooterNavigation from './FooterNavigation';
+import { EnvVarWarning } from './env-var-warning';
+import { SandboxBanner } from './SandboxBanner';
+import { ThemeSwitcher } from './theme-switcher';
+
+type NavigationItem = Database['public']['Tables']['navigation_items']['Row'];
+type Logo =
+  Database['public']['Tables']['logos']['Row'] & {
+    media: (Database['public']['Tables']['media']['Row'] & { alt_text: string | null }) | null;
+  };
+
+type AppBrandingContextValue = {
+  logo: Logo | null;
+  siteTitle: string;
+};
+
+const AppBrandingContext = createContext<AppBrandingContextValue>({
+  logo: null,
+  siteTitle: 'Nextblock',
+});
+
+export function useAppBranding() {
+  return useContext(AppBrandingContext);
+}
+
+type CorporateFooter = {
+  legalName: string;
+  address: string;
+  supportEmail: string;
+};
+
+type AppShellProps = {
+  canAccessCms: boolean;
+  children: ReactNode;
+  copyrightText: string;
+  corporateFooter?: CorporateFooter;
+  footerNavItems: NavigationItem[];
+  hasSupabaseEnv: boolean;
+  headerNavItems: NavigationItem[];
+  isDraftModeEnabled: boolean;
+  isEcommerceActive: boolean;
+  logo: Logo | null;
+  siteTitle: string;
+};
+
+export function AppShell({
+  canAccessCms,
+  children,
+  copyrightText,
+  corporateFooter,
+  footerNavItems,
+  hasSupabaseEnv,
+  headerNavItems,
+  isDraftModeEnabled,
+  isEcommerceActive,
+  logo,
+  siteTitle,
+}: AppShellProps) {
+  const pathname = usePathname() || '';
+  const isCmsRequest = pathname.startsWith('/cms');
+  const branding = useMemo(() => ({ logo, siteTitle }), [logo, siteTitle]);
+
+  return (
+    <AppBrandingContext.Provider value={branding}>
+      {process.env.NEXT_PUBLIC_IS_SANDBOX === 'true' && !isCmsRequest && <SandboxBanner />}
+      <div
+        className={cn(
+          'text-foreground flex w-full flex-col',
+          isCmsRequest
+            ? 'h-[100dvh] overflow-hidden bg-slate-50 dark:bg-slate-950'
+            : 'min-h-screen bg-background'
+        )}
+      >
+        <div
+          className={cn(
+            'flex min-h-0 w-full flex-1 flex-col',
+            !isCmsRequest && 'items-center'
+          )}
+        >
+          <nav className="w-full flex justify-center border-b border-b-foreground/10 h-16 shrink-0">
+            <div className="w-full max-w-7xl flex justify-between items-center p-3 px-5 text-sm">
+              {!hasSupabaseEnv ? (
+                <EnvVarWarning />
+              ) : (
+                <Header
+                  navItems={headerNavItems}
+                  canAccessCms={canAccessCms}
+                  isDraftModeEnabled={isDraftModeEnabled}
+                  logo={logo}
+                  siteTitle={siteTitle}
+                  isEcommerceActive={isEcommerceActive}
+                />
+              )}
+            </div>
+          </nav>
+          <main
+            className={cn(
+              'w-full',
+              isCmsRequest ? 'flex flex-1 min-h-0 overflow-hidden' : 'flex-grow'
+            )}
+          >
+            {children}
+          </main>
+          {!isCmsRequest && (
+            <footer className="w-full border-t py-6">
+              <div className="mx-auto flex flex-col items-center justify-center gap-6 text-center text-xs">
+                <FooterNavigation navItems={footerNavItems} />
+                {corporateFooter &&
+                  (corporateFooter.legalName ||
+                    corporateFooter.address ||
+                    corporateFooter.supportEmail) && (
+                    <p className="max-w-2xl text-[11px] leading-relaxed text-muted-foreground/80">
+                      {[corporateFooter.legalName, corporateFooter.address]
+                        .filter(Boolean)
+                        .join(' · ')}
+                      {corporateFooter.supportEmail && (
+                        <>
+                          {(corporateFooter.legalName || corporateFooter.address) && ' · '}
+                          <a
+                            href={`mailto:${corporateFooter.supportEmail}`}
+                            className="hover:underline"
+                          >
+                            {corporateFooter.supportEmail}
+                          </a>
+                        </>
+                      )}
+                    </p>
+                  )}
+                <div className="flex flex-row items-center gap-4">
+                  <p className="text-muted-foreground">{copyrightText}</p>
+                  <Link href="/privacy-policy" className="hover:underline">
+                    Privacy Policy
+                  </Link>
+                  <Link href="/terms-of-service" className="hover:underline">
+                    Terms of Service
+                  </Link>
+                  <ThemeSwitcher />
+                </div>
+              </div>
+            </footer>
+          )}
+        </div>
+      </div>
+    </AppBrandingContext.Provider>
+  );
+}