@ismaelsoilet/synapsejs 1.9.0 → 1.11.1

package/README.md

@@ -33,7 +33,7 @@ with rawBody preservation · B2B multi-tenancy & IDOR prevention (`requireTenant
 and Turbo Morphing router · explicit RBAC via `requireAuth(session, roles)` · zero-wiring routing + SSR + RPC · slice discovery
 that never reports PASS with zero slices · isomorphic splitter with compile and leak gates · typed AST skeleton map ·
 scaffolder with `--fields` grammar and templates (create, list, update, delete, login, oauth-github, crud) · standalone production bundler (`synapse build --standalone`) ·
-MCP stdio server with 18 native tools (11 Synapse + 7 Jev) · slice invariants under `bun:test` with per-invariant reporting · PostgreSQL parity · real concurrency & load stress benchmarks ·
+MCP stdio server with 23 native tools (16 Synapse + 7 Jev) · slice invariants under `bun:test` with per-invariant reporting · PostgreSQL parity · real concurrency & load stress benchmarks ·
 SSRF & Network Guard (`validateExternalUrl`, `isPrivateOrReservedIp`) · anti-spoofing & bounded LRU rate limiting · bounded LRU SSR micro-cache with parameter normalization · strict payload size guards (RPC 5MB, Webhook 10MB) & malformed JSON protection · SQLite queue zombie job recovery with `locked_at` visibility timeout · HTTP 500 SSR error isolation & bundle suppression · secure HttpOnly cookies (`ctx.setCookie`) · graceful HTTP shutdown (`server.stop` with connection drain) ·
 Prototype Pollution Shield (`setNestedProperty`, `expandNestedObject`) · Parameterized Query Operator Allowlist (`VALID_WHERE_OPERATORS`) · Reentrant SQLite Savepoints (`txDepth` + `SAVEPOINT`) · Atomic Queue Poison-Pill Neutralization (claim increment & DLQ timeout) · Strict Multi-Tenant Context Derivation (spoofing-proof token claims) · Streaming Upload & Chunked DoS Armor (`readBodyWithinLimit`) · Origin-Validated WebSocket Upgrades (`SYNAPSE_ALLOWED_ORIGINS`) · Safe SSR Serialization (`<script type="application/json">`) & Cookie CRLF Guard.
 
@@ -131,9 +131,10 @@ bun run mcp     # JSON-RPC 2.0 over stdio
 ```
 
 Tools: `synapse_get_repo_map`, `synapse_get_db_schema`, `synapse_check`, `synapse_split`,
-`synapse_run_pbt`, `synapse_scaffold_slice`, `synapse_migrate`, `synapse_rollback`, `synapse_contract`,
+`synapse_run_pbt`, `synapse_scaffold_slice`, `synapse_scaffold_domain`, `synapse_migrate`, `synapse_rollback`, `synapse_contract`,
 `synapse_check_db_drift`, `synapse_diff_impact`, `synapse_test_gate`, `synapse_abort_check`,
-`synapse_verify_completion`, `synapse_reasoning_effort`, `synapse_triage_error`, `synapse_route_task`, `synapse_evaluate_nudge`.
+`synapse_verify_completion`, `synapse_reasoning_effort`, `synapse_triage_error`, `synapse_route_task`, `synapse_evaluate_nudge`,
+`synapse_inspect_routes`, `synapse_test_slice`, `synapse_generate_seed`, `synapse_scaffold_component`.
 Slice-dependent tools fail with `NO_SLICES_DIR` (listing the paths they examined) instead of reporting an empty success.
 
 ## Write-surface containment

package/bin/synapse.ts

@@ -15,6 +15,7 @@
  *   synapse split      - Partition slices into shared/server/client modules (gated)
  *   synapse test       - Run all property-based testing (PBT) oracles
  *   synapse new-slice  - Scaffold a new atomic vertical slice
+ *   synapse new-domain - Scaffold a domain layout, list slice and shared module
  *   synapse info       - Machine metadata and framework metrics
  */
 
@@ -22,19 +23,20 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { runMachineVerifications } from '../src/compiler/agent-diagnostic-json';
 import { compressRepositoryAST } from '../src/compiler/ast-daemon-compressor';
-import { buildAllClientBundles } from '../src/compiler/client-bundler';
+import { buildAllClientBundles, buildCssBundle } from '../src/compiler/client-bundler';
 import { renderContractJson, renderContractMarkdown } from '../src/compiler/contract';
 import { generateDatabaseSchemaCatalog } from '../src/compiler/db-schema-generator';
 import { analyzeImpact } from '../src/compiler/impact-analyzer';
 import { rollbackSliceMigrations, runSliceMigrations } from '../src/compiler/migration-runner';
 import { analyzeOptionalItemCoverage, unionCoverage } from '../src/compiler/optional-coverage';
 import { runSliceOracles } from '../src/compiler/oracle-runner';
-import { scaffoldCrud, scaffoldShared, scaffoldSlice } from '../src/compiler/scaffolder';
+import { scaffoldCrud, scaffoldDomain, scaffoldShared, scaffoldSlice } from '../src/compiler/scaffolder';
 import { checkSchemaDrift } from '../src/compiler/schema-drift';
 import { findSliceFiles, resolveSlicesDir } from '../src/compiler/slice-discovery';
 import { artifactDirectory, splitSlice, verifySplit, writeSplitArtifacts } from '../src/compiler/slice-splitter';
 import { SLICE_TEMPLATES, type SliceTemplate } from '../src/compiler/slice-templates';
 import { buildStandalone } from '../src/compiler/standalone-builder';
+import { assertCompilerApi } from '../src/compiler/typescript-api';
 import { isInsideBase } from '../src/core/path-guard';
 import { SynapseMcpServer } from '../src/mcp/server';
 import { projectStatus } from '../src/project-status';
@@ -63,6 +65,7 @@ const KNOWN_FLAGS: Record<string, string[]> = {
   split: [],
   'new-slice': ['--template', '--fields'],
   'new-shared': [],
+  'new-domain': ['--fields'],
   build: ['--standalone'],
   contract: ['--markdown'],
   test: ['--gate'],
@@ -112,6 +115,24 @@ async function main() {
     process.exit(1);
   }
 
+  const compilerCommands = new Set(['check', 'split', 'skeleton', 'db-schema', 'impact', 'test', 'build']);
+
+  if (compilerCommands.has(command)) {
+    try {
+      assertCompilerApi();
+    } catch (error) {
+      process.stdout.write(
+        `${JSON.stringify({
+          status: 'FAIL',
+          operation: 'COMPILER_API_CHECK',
+          code: 'COMPILER_API_UNAVAILABLE',
+          message: error instanceof Error ? error.message : String(error)
+        })}\n`
+      );
+      process.exit(1);
+    }
+  }
+
   switch (command) {
     case 'dev': {
       const watch = process.argv.includes('--watch');
@@ -125,6 +146,7 @@ async function main() {
       }
 
       const port = parseInt(process.argv[3] || process.env.PORT || '3000', 10);
+      await buildCssBundle(root);
       const server = new SynapseServer(root, port);
       await server.discoverSlices();
       await server.start();
@@ -162,6 +184,7 @@ async function main() {
         );
       }
 
+      await buildCssBundle(root);
       const server = new SynapseServer(root, port);
       await server.discoverSlices();
       await server.start();
@@ -593,7 +616,56 @@ async function main() {
       break;
     }
 
+    case 'new-domain': {
+      const domain = process.argv[3];
+      if (!domain) {
+        process.stdout.write(
+          `${JSON.stringify({
+            status: 'ERROR',
+            message: 'Nome do domínio ausente. Uso: synapse new-domain <dominio> [--fields="..."]'
+          })}\n`
+        );
+        process.exit(1);
+      }
+
+      const root = process.env.SYNAPSE_ROOT || process.cwd();
+      const fields = process.argv.find((arg) => arg.startsWith('--fields='))?.slice('--fields='.length);
+      const created = scaffoldDomain(domain, root, fields);
+
+      if (!created.ok) {
+        process.stdout.write(
+          `${JSON.stringify(
+            {
+              status: 'ERROR',
+              operation: 'SCAFFOLD_DOMAIN',
+              code: created.error.code,
+              message: created.error.message
+            },
+            null,
+            2
+          )}\n`
+        );
+        process.exit(1);
+      }
+
+      process.stdout.write(
+        `${JSON.stringify(
+          {
+            status: 'PASS',
+            operation: 'SCAFFOLD_DOMAIN',
+            domain,
+            createdFiles: created.value.map((f) => path.relative(root, f))
+          },
+          null,
+          2
+        )}\n`
+      );
+      process.exit(0);
+      break;
+    }
+
     case 'build': {
+      await buildCssBundle(root);
       const isStandalone = process.argv.includes('--standalone');
 
       if (isStandalone) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ismaelsoilet/synapsejs",
-  "version": "1.9.0",
+  "version": "1.11.1",
   "description": "Bun-only fullstack framework where a feature is a single contiguous file",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -56,7 +56,7 @@
     "postgres": "^3.4.9",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "typescript": "^5.8.2"
+    "typescript": "~5.9.3"
   },
   "devDependencies": {
     "@types/bun": "^1.4.2",

package/src/client/components.tsx

@@ -1,4 +1,13 @@
-import React, { type ReactNode, useMemo, useState } from 'react';
+import React, {
+  createContext,
+  type ReactNode,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState
+} from 'react';
 
 // ============================================================================
 // 1. BADGE COMPONENT
@@ -523,3 +532,452 @@ export function DataForm({
     </form>
   );
 }
+
+// ============================================================================
+// 7. MODAL / DIALOG COMPONENT (WAI-ARIA COMPLIANT)
+// ============================================================================
+export interface ModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  title?: ReactNode;
+  description?: ReactNode;
+  size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+  children?: ReactNode;
+  footer?: ReactNode;
+  className?: string;
+  closeOnBackdrop?: boolean;
+}
+
+export function Modal({
+  isOpen,
+  onClose,
+  title,
+  description,
+  size = 'md',
+  children,
+  footer,
+  className = '',
+  closeOnBackdrop = true
+}: ModalProps) {
+  const dialogRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    if (!isOpen) return;
+
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        e.stopPropagation();
+        onClose();
+      }
+    };
+
+    const previousOverflow = document.body.style.overflow;
+    document.body.style.overflow = 'hidden';
+    window.addEventListener('keydown', handleKeyDown);
+
+    return () => {
+      document.body.style.overflow = previousOverflow;
+      window.removeEventListener('keydown', handleKeyDown);
+    };
+  }, [isOpen, onClose]);
+
+  if (!isOpen) return null;
+
+  const sizeStyles = {
+    sm: 'max-w-sm',
+    md: 'max-w-lg',
+    lg: 'max-w-2xl',
+    xl: 'max-w-4xl',
+    full: 'max-w-[95vw] h-[90vh]'
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center p-4 sm:p-6 bg-slate-950/70 backdrop-blur-sm animate-in fade-in duration-200"
+      style={{ position: 'fixed', top: 0, right: 0, bottom: 0, left: 0, zIndex: 50 }}
+      onClick={closeOnBackdrop ? onClose : undefined}
+      onKeyDown={(e) => {
+        if (e.key === 'Escape') onClose();
+      }}
+      aria-modal="true"
+      role="dialog"
+      tabIndex={-1}
+    >
+      <div
+        ref={dialogRef}
+        onClick={(e) => e.stopPropagation()}
+        onKeyDown={(e) => e.stopPropagation()}
+        role="document"
+        className={`bg-slate-900 border border-slate-800 rounded-2xl shadow-2xl flex flex-col w-full overflow-hidden transition-all duration-200 transform scale-100 ${sizeStyles[size]} ${className}`}
+      >
+        {(title || description) && (
+          <div className="flex items-start justify-between p-5 border-b border-slate-800">
+            <div>
+              {title && <h3 className="text-lg font-bold text-slate-100 tracking-tight">{title}</h3>}
+              {description && <p className="text-xs text-slate-400 mt-1">{description}</p>}
+            </div>
+            <button
+              type="button"
+              onClick={onClose}
+              aria-label="Fechar diálogo"
+              className="text-slate-400 hover:text-white p-1 rounded-lg hover:bg-slate-800 transition-colors text-base font-mono leading-none"
+            >
+              ✕
+            </button>
+          </div>
+        )}
+        <div className="p-5 overflow-y-auto flex-1 text-slate-200 text-sm leading-relaxed">{children}</div>
+        {footer && (
+          <div className="p-4 border-t border-slate-800 bg-slate-950/40 flex items-center justify-end gap-2">
+            {footer}
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
+// ============================================================================
+// 8. DRAWER / SLIDE-OVER SHEET COMPONENT
+// ============================================================================
+export interface DrawerProps {
+  isOpen: boolean;
+  onClose: () => void;
+  title?: ReactNode;
+  description?: ReactNode;
+  position?: 'left' | 'right';
+  size?: 'sm' | 'md' | 'lg' | 'full';
+  children?: ReactNode;
+  footer?: ReactNode;
+  className?: string;
+  closeOnBackdrop?: boolean;
+}
+
+export function Drawer({
+  isOpen,
+  onClose,
+  title,
+  description,
+  position = 'right',
+  size = 'md',
+  children,
+  footer,
+  className = '',
+  closeOnBackdrop = true
+}: DrawerProps) {
+  const drawerRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    if (!isOpen) return;
+
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        e.stopPropagation();
+        onClose();
+      }
+    };
+
+    const previousOverflow = document.body.style.overflow;
+    document.body.style.overflow = 'hidden';
+    window.addEventListener('keydown', handleKeyDown);
+
+    return () => {
+      document.body.style.overflow = previousOverflow;
+      window.removeEventListener('keydown', handleKeyDown);
+    };
+  }, [isOpen, onClose]);
+
+  if (!isOpen) return null;
+
+  const sizeStyles = {
+    sm: 'max-w-sm',
+    md: 'max-w-md',
+    lg: 'max-w-2xl',
+    full: 'max-w-full'
+  };
+
+  const posStyles = {
+    right: 'inset-y-0 right-0',
+    left: 'inset-y-0 left-0'
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex bg-slate-950/70 backdrop-blur-sm animate-in fade-in duration-200"
+      style={{ position: 'fixed', top: 0, right: 0, bottom: 0, left: 0, zIndex: 50 }}
+      onClick={closeOnBackdrop ? onClose : undefined}
+      onKeyDown={(e) => {
+        if (e.key === 'Escape') onClose();
+      }}
+      aria-modal="true"
+      role="dialog"
+      tabIndex={-1}
+    >
+      <div
+        ref={drawerRef}
+        onClick={(e) => e.stopPropagation()}
+        onKeyDown={(e) => e.stopPropagation()}
+        role="document"
+        className={`fixed ${posStyles[position]} flex flex-col h-full w-full bg-slate-900 border-${position === 'right' ? 'l' : 'r'} border-slate-800 shadow-2xl overflow-hidden transition-transform duration-300 ${sizeStyles[size]} ${className}`}
+        style={{ position: 'fixed', top: 0, bottom: 0, [position]: 0 }}
+      >
+        <div className="flex items-start justify-between p-5 border-b border-slate-800">
+          <div>
+            {title && <h3 className="text-lg font-bold text-slate-100 tracking-tight">{title}</h3>}
+            {description && <p className="text-xs text-slate-400 mt-1">{description}</p>}
+          </div>
+          <button
+            type="button"
+            onClick={onClose}
+            aria-label="Fechar painel lateral"
+            className="text-slate-400 hover:text-white p-1 rounded-lg hover:bg-slate-800 transition-colors text-base font-mono leading-none"
+          >
+            ✕
+          </button>
+        </div>
+        <div className="p-5 overflow-y-auto flex-1 text-slate-200 text-sm leading-relaxed">{children}</div>
+        {footer && (
+          <div className="p-4 border-t border-slate-800 bg-slate-950/40 flex items-center justify-end gap-2">
+            {footer}
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
+// ============================================================================
+// 9. TABS ACCESSIBLE COMPONENT
+// ============================================================================
+interface TabsContextValue {
+  value: string;
+  setValue: (val: string) => void;
+}
+const TabsContext = createContext<TabsContextValue | null>(null);
+
+export interface TabsProps {
+  defaultValue?: string;
+  value?: string;
+  onValueChange?: (val: string) => void;
+  syncQueryParam?: string;
+  children?: ReactNode;
+  className?: string;
+}
+
+export function Tabs({
+  defaultValue = '',
+  value: controlledValue,
+  onValueChange,
+  syncQueryParam,
+  children,
+  className = ''
+}: TabsProps) {
+  const [internalValue, setInternalValue] = useState<string>(() => {
+    if (typeof window !== 'undefined' && syncQueryParam) {
+      const sp = new URLSearchParams(window.location.search);
+      const fromUrl = sp.get(syncQueryParam);
+      if (fromUrl) return fromUrl;
+    }
+    return defaultValue;
+  });
+
+  const activeValue = controlledValue !== undefined ? controlledValue : internalValue;
+
+  const handleValueChange = useCallback(
+    (newVal: string) => {
+      if (controlledValue === undefined) {
+        setInternalValue(newVal);
+      }
+      onValueChange?.(newVal);
+
+      if (typeof window !== 'undefined' && syncQueryParam) {
+        const url = new URL(window.location.href);
+        url.searchParams.set(syncQueryParam, newVal);
+        window.history.replaceState({}, '', url.toString());
+      }
+    },
+    [controlledValue, onValueChange, syncQueryParam]
+  );
+
+  return (
+    <TabsContext.Provider value={{ value: activeValue, setValue: handleValueChange }}>
+      <div className={`space-y-4 ${className}`}>{children}</div>
+    </TabsContext.Provider>
+  );
+}
+
+export interface TabListProps {
+  children?: ReactNode;
+  className?: string;
+}
+
+export function TabList({ children, className = '' }: TabListProps) {
+  return (
+    <div
+      role="tablist"
+      className={`flex items-center gap-1.5 p-1 bg-slate-900 border border-slate-800 rounded-xl overflow-x-auto ${className}`}
+    >
+      {children}
+    </div>
+  );
+}
+
+export interface TabProps {
+  value: string;
+  children?: ReactNode;
+  disabled?: boolean;
+  className?: string;
+}
+
+export function Tab({ value, children, disabled = false, className = '' }: TabProps) {
+  const ctx = useContext(TabsContext);
+  if (!ctx) throw new Error('<Tab> must be used within <Tabs>');
+
+  const isSelected = ctx.value === value;
+
+  return (
+    <button
+      type="button"
+      role="tab"
+      aria-selected={isSelected}
+      disabled={disabled}
+      onClick={() => ctx.setValue(value)}
+      className={`px-3.5 py-1.5 text-xs font-semibold rounded-lg transition-all duration-150 cursor-pointer disabled:cursor-not-allowed disabled:opacity-40 whitespace-nowrap ${
+        isSelected
+          ? 'bg-slate-800 text-cyan-400 shadow-sm border border-slate-700/80 font-bold'
+          : 'text-slate-400 hover:text-slate-200 hover:bg-slate-800/50'
+      } ${className}`}
+    >
+      {children}
+    </button>
+  );
+}
+
+export interface TabPanelProps {
+  value: string;
+  children?: ReactNode;
+  className?: string;
+}
+
+export function TabPanel({ value, children, className = '' }: TabPanelProps) {
+  const ctx = useContext(TabsContext);
+  if (!ctx) throw new Error('<TabPanel> must be used within <Tabs>');
+
+  if (ctx.value !== value) return null;
+
+  return (
+    <div role="tabpanel" className={`focus:outline-none ${className}`}>
+      {children}
+    </div>
+  );
+}
+
+// ============================================================================
+// 10. DROPDOWN MENU ACCESSIBLE COMPONENT
+// ============================================================================
+export interface DropdownMenuProps {
+  trigger: ReactNode;
+  align?: 'left' | 'right';
+  children?: ReactNode;
+  className?: string;
+}
+
+export function DropdownMenu({ trigger, align = 'right', children, className = '' }: DropdownMenuProps) {
+  const [isOpen, setIsOpen] = useState(false);
+  const containerRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    if (!isOpen) return;
+
+    const handleClickOutside = (e: MouseEvent) => {
+      if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
+        setIsOpen(false);
+      }
+    };
+
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') {
+        setIsOpen(false);
+      }
+    };
+
+    document.addEventListener('mousedown', handleClickOutside);
+    window.addEventListener('keydown', handleKeyDown);
+
+    return () => {
+      document.removeEventListener('mousedown', handleClickOutside);
+      window.removeEventListener('keydown', handleKeyDown);
+    };
+  }, [isOpen]);
+
+  const alignStyles = {
+    left: 'left-0',
+    right: 'right-0'
+  };
+
+  return (
+    <div ref={containerRef} className={`relative inline-block text-left ${className}`}>
+      {/* biome-ignore lint/a11y/useSemanticElements: custom trigger wrapper avoids button-inside-button HTML nesting */}
+      <div
+        role="button"
+        tabIndex={0}
+        onClick={() => setIsOpen((prev) => !prev)}
+        onKeyDown={(e) => {
+          if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            setIsOpen((prev) => !prev);
+          }
+        }}
+        className="text-left bg-transparent border-0 p-0 m-0 cursor-pointer inline-block"
+      >
+        {trigger}
+      </div>
+      {isOpen && (
+        <div
+          role="menu"
+          aria-orientation="vertical"
+          tabIndex={-1}
+          className={`absolute ${alignStyles[align]} mt-2 w-52 rounded-xl bg-slate-900 border border-slate-800 shadow-2xl p-1 z-50 animate-in fade-in duration-150`}
+        >
+          {children}
+        </div>
+      )}
+    </div>
+  );
+}
+
+export interface DropdownItemProps {
+  onClick?: () => void;
+  variant?: 'default' | 'danger';
+  icon?: ReactNode;
+  disabled?: boolean;
+  children?: ReactNode;
+  className?: string;
+}
+
+export function DropdownItem({
+  onClick,
+  variant = 'default',
+  icon,
+  disabled = false,
+  children,
+  className = ''
+}: DropdownItemProps) {
+  const variantStyles = {
+    default: 'text-slate-300 hover:text-white hover:bg-slate-800',
+    danger: 'text-rose-400 hover:text-rose-300 hover:bg-rose-950/50'
+  };
+
+  return (
+    <button
+      type="button"
+      role="menuitem"
+      disabled={disabled}
+      onClick={onClick}
+      className={`w-full flex items-center gap-2.5 px-3 py-2 text-xs font-medium rounded-lg transition-colors text-left cursor-pointer disabled:cursor-not-allowed disabled:opacity-40 ${variantStyles[variant]} ${className}`}
+    >
+      {icon && <span className="shrink-0">{icon}</span>}
+      <span className="flex-1 truncate">{children}</span>
+    </button>
+  );
+}

package/src/client/context.tsx

@@ -1,9 +1,11 @@
 import { createContext, type ReactNode, useContext } from 'react';
 import type { SessionContext } from '../core/session-context';
+import { SliceErrorBoundary, type SliceErrorBoundaryProps } from './error-boundary';
 
 export interface SynapseContextValue {
   props: Record<string, unknown>;
   session?: SessionContext;
+  url?: string;
 }
 
 const SynapseContext = createContext<SynapseContextValue | null>(null);
@@ -11,13 +13,24 @@ const SynapseContext = createContext<SynapseContextValue | null>(null);
 export interface SynapseProviderProps {
   props?: Record<string, unknown>;
   session?: SessionContext;
+  url?: string;
+  /** Defaults to true: a slice render error shows a fallback instead of a dead tree. */
+  errorBoundary?: boolean;
+  errorBoundaryFallback?: SliceErrorBoundaryProps['fallback'];
   children?: ReactNode;
 }
 
 /**
  * SynapseProvider delivers per-request SSR data isolation and seamless client hydration.
  */
-export function SynapseProvider({ props, session, children }: SynapseProviderProps) {
+export function SynapseProvider({
+  props,
+  session,
+  url,
+  errorBoundary = true,
+  errorBoundaryFallback,
+  children
+}: SynapseProviderProps) {
   // On client, if props not passed directly, hydrate from window.__SYNAPSE_PROPS__
   const clientProps =
     props ??
@@ -27,10 +40,17 @@ export function SynapseProvider({ props, session, children }: SynapseProviderPro
 
   const value: SynapseContextValue = {
     props: clientProps,
-    session
+    session,
+    url
   };
 
-  return <SynapseContext.Provider value={value}>{children}</SynapseContext.Provider>;
+  const content = errorBoundary ? (
+    <SliceErrorBoundary fallback={errorBoundaryFallback}>{children}</SliceErrorBoundary>
+  ) : (
+    children
+  );
+
+  return <SynapseContext.Provider value={value}>{content}</SynapseContext.Provider>;
 }
 
 export function useSynapseContext(): SynapseContextValue {