@riverbankcms/sdk 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+'use strict';
+
+var commander = require('commander');
+var zod = require('zod');
+var blocks = require('@riverbankcms/blocks');
+require('@riverbankcms/blocks/system/data');
+var jiti = require('jiti');
+var path = require('path');
+var fs = require('fs');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+var SUPPORTED_LOADER_ENDPOINTS = [
+  "listPublishedEntries",
+  "getPublishedEntryPreview",
+  "listPublicEvents",
+  "getPublicFormById",
+  "getPublicBookingServices"
+];
+
+// src/config/validation.ts
+var sdkThemePaletteSchema = zod.z.record(zod.z.string(), zod.z.string());
+var sdkThemeConfigSchema = zod.z.object({
+  palette: sdkThemePaletteSchema
+});
+var sectionBackgroundSchema = zod.z.object({
+  id: zod.z.string(),
+  label: zod.z.string(),
+  token: zod.z.string()
+  // Reference to theme palette token
+});
+var sectionSpacingSchema = zod.z.enum(["compact", "default", "spacious"]);
+var containerMaxWidthSchema = zod.z.enum(["narrow", "default", "wide", "full"]);
+var containerAlignmentSchema = zod.z.enum(["left", "center", "right"]);
+var sectionOptionsSchema = zod.z.object({
+  backgroundColor: zod.z.boolean().optional(),
+  backgroundImage: zod.z.boolean().optional(),
+  backgroundGradient: zod.z.boolean().optional(),
+  spacing: zod.z.union([
+    zod.z.array(sectionSpacingSchema),
+    zod.z.boolean()
+  ]).optional(),
+  textColor: zod.z.boolean().optional()
+}).optional();
+var containerOptionsSchema = zod.z.object({
+  maxWidth: zod.z.union([
+    zod.z.array(containerMaxWidthSchema),
+    zod.z.boolean()
+  ]).optional(),
+  alignment: zod.z.union([
+    zod.z.array(containerAlignmentSchema),
+    zod.z.boolean()
+  ]).optional()
+}).optional();
+var siteStyleConfigSchema = zod.z.object({
+  sectionBackgrounds: zod.z.array(sectionBackgroundSchema).optional(),
+  sectionOptions: sectionOptionsSchema,
+  containerOptions: containerOptionsSchema
+}).optional();
+var sdkLoaderEndpointSchema = zod.z.enum(SUPPORTED_LOADER_ENDPOINTS);
+var loaderParamBindingSchema = zod.z.object({
+  $bind: zod.z.object({
+    from: zod.z.string().min(1, "Binding path is required"),
+    fallback: zod.z.string().optional()
+  })
+});
+var loaderParamValueSchema = zod.z.union([
+  zod.z.string(),
+  zod.z.number(),
+  zod.z.boolean(),
+  loaderParamBindingSchema
+]);
+var sdkConfigLoaderSchema = zod.z.object({
+  endpoint: sdkLoaderEndpointSchema,
+  params: zod.z.record(zod.z.string(), loaderParamValueSchema),
+  mode: zod.z.enum(["server", "client"]).default("server")
+});
+var sdkDataLoadersSchema = zod.z.record(zod.z.string(), sdkConfigLoaderSchema).refine(
+  (loaders) => Object.keys(loaders).length <= 5,
+  { message: "Maximum 5 data loaders per block" }
+).optional();
+var fieldSelectOptionSchema = zod.z.object({
+  value: zod.z.string().min(1, "Option value is required"),
+  label: zod.z.string().min(1, "Option label is required")
+});
+var blockFieldConfigSchema = zod.z.object({
+  options: zod.z.array(fieldSelectOptionSchema).min(1, "At least one option is required").optional()
+});
+var blockFieldOptionsSchema = zod.z.record(
+  zod.z.string().regex(/^(block\.|custom\.)[a-z][a-z0-9-]*$/, {
+    message: "Block ID must be 'block.*' or 'custom.*' format"
+  }),
+  zod.z.record(
+    zod.z.string().min(1, "Field ID is required"),
+    blockFieldConfigSchema
+  )
+).optional();
+var blockFieldExtensionSchema = zod.z.object({
+  fields: blocks.fieldSchema.array().min(1, "At least one field is required")
+}).refine(
+  (data) => {
+    return data.fields.every((field) => {
+      if (!field.required) return true;
+      return field.defaultValue !== void 0;
+    });
+  },
+  {
+    message: "Required fields must have a defaultValue to support existing blocks"
+  }
+);
+var blockFieldExtensionsSchema = zod.z.record(
+  zod.z.string().regex(/^block\.[a-z][a-zA-Z0-9]*$/, {
+    message: "Block ID must be 'block.*' format (system blocks only)"
+  }),
+  blockFieldExtensionSchema
+).optional();
+function validateFieldIdConflicts(blockFieldExtensions) {
+  if (!blockFieldExtensions) return [];
+  const conflicts = [];
+  for (const [blockId, extension] of Object.entries(blockFieldExtensions)) {
+    const definition = blocks.getBlockDefinition(blockId);
+    if (!definition) {
+      conflicts.push({
+        blockId,
+        fieldId: "",
+        message: `Unknown block type: ${blockId}`
+      });
+      continue;
+    }
+    const existingFieldIds = /* @__PURE__ */ new Set();
+    const collectFieldIds = (fields) => {
+      if (!fields) return;
+      for (const field of fields) {
+        existingFieldIds.add(field.id);
+        if (field.type === "group" || field.type === "modal") {
+          collectFieldIds(field.schema?.fields);
+        } else if (field.type === "repeater" && field.schema?.fields) {
+          collectFieldIds(field.schema.fields);
+        } else if (field.type === "tabGroup") {
+          for (const tab of field.tabs ?? []) {
+            collectFieldIds(tab.fields);
+          }
+        }
+      }
+    };
+    collectFieldIds(definition.manifest.fields);
+    for (const field of extension.fields) {
+      if (existingFieldIds.has(field.id)) {
+        conflicts.push({
+          blockId,
+          fieldId: field.id,
+          message: `Field ID "${field.id}" conflicts with existing field in ${blockId}`
+        });
+      }
+    }
+  }
+  return conflicts;
+}
+var sdkCustomBlockSchema = zod.z.object({
+  // Block ID must start with 'custom.'
+  id: zod.z.string().min(8).regex(/^custom\.[a-z][a-z0-9-]*$/, {
+    message: "Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens"
+  }),
+  title: zod.z.string().min(1, "Title is required"),
+  titleSource: zod.z.string().optional(),
+  description: zod.z.string().optional(),
+  category: blocks.blockCategoryEnum,
+  icon: zod.z.string().optional(),
+  tags: zod.z.array(zod.z.string()).optional(),
+  // Reuse the exact field schema from @riverbankcms/blocks - all field types supported
+  fields: blocks.fieldSchema.array().min(1, "Custom blocks must have at least one field"),
+  // Data loaders for CMS endpoints
+  dataLoaders: sdkDataLoadersSchema
+}).refine(
+  // Validate titleSource references a valid field if provided
+  (data) => {
+    if (!data.titleSource) return true;
+    return data.fields.some((f) => f.id === data.titleSource);
+  },
+  {
+    message: "titleSource must reference a valid field ID",
+    path: ["titleSource"]
+  }
+);
+var riverbankSiteConfigSchema = zod.z.object({
+  siteId: zod.z.string().uuid(),
+  theme: sdkThemeConfigSchema.optional(),
+  styles: siteStyleConfigSchema,
+  customBlocks: zod.z.array(sdkCustomBlockSchema).max(20, "Maximum 20 custom blocks per site").refine(
+    // Ensure unique block IDs
+    (blocks) => {
+      const ids = blocks.map((b) => b.id);
+      return ids.length === new Set(ids).size;
+    },
+    { message: "Block IDs must be unique" }
+  ).optional(),
+  blockFieldOptions: blockFieldOptionsSchema,
+  blockFieldExtensions: blockFieldExtensionsSchema
+}).strict();
+var DEFAULT_CONFIG_FILENAME = "riverbank.config.ts";
+async function loadConfigFile(configPath) {
+  const resolvedPath = resolveConfigPath(configPath);
+  if (!fs.existsSync(resolvedPath)) {
+    throw new Error(
+      `Config file not found: ${resolvedPath}
+Create a riverbank.config.ts file or specify a path with --config`
+    );
+  }
+  console.log(`Loading config from ${resolvedPath}...`);
+  const jiti$1 = jiti.createJiti((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.js', document.baseURI).href)), {
+    // Disable caching for CLI tool
+    fsCache: false,
+    moduleCache: false
+  });
+  try {
+    const configModule = await jiti$1.import(resolvedPath);
+    const config = configModule.default ?? configModule.config ?? configModule;
+    if (!config || typeof config !== "object") {
+      throw new Error("Config file must export a configuration object");
+    }
+    return config;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(`Failed to load config: ${error.message}`);
+    }
+    throw error;
+  }
+}
+function resolveConfigPath(configPath) {
+  if (!configPath) {
+    return path.resolve(process.cwd(), DEFAULT_CONFIG_FILENAME);
+  }
+  const resolved = path.resolve(configPath);
+  if (fs.existsSync(resolved) && !resolved.endsWith(".ts") && !resolved.endsWith(".js")) {
+    return path.resolve(resolved, DEFAULT_CONFIG_FILENAME);
+  }
+  return resolved;
+}
+
+// src/cli/push-config.ts
+async function pushToDashboard(dashboardUrl, siteId, apiKey, config) {
+  const pushUrl = `${dashboardUrl}/api/sites/${siteId}/sdk-config`;
+  console.log(`Pushing config to ${pushUrl}...`);
+  let response;
+  try {
+    response = await fetch(pushUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify({ config }),
+      signal: AbortSignal.timeout(3e4)
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new Error(`Failed to connect to dashboard: ${message}`);
+  }
+  if (!response.ok) {
+    let errorMessage = `Dashboard returned ${response.status}`;
+    try {
+      const errorBody = await response.json();
+      if (errorBody.error) {
+        errorMessage = errorBody.error;
+        if (errorBody.details) {
+          errorMessage += ":\n" + errorBody.details.map((d) => `  - ${d.path}: ${d.message}`).join("\n");
+        }
+      }
+    } catch {
+    }
+    throw new Error(errorMessage);
+  }
+}
+async function pushConfigAction(options) {
+  try {
+    const rawConfig = await loadConfigFile(options.config);
+    console.log("Validating config...");
+    const parseResult = riverbankSiteConfigSchema.safeParse(rawConfig);
+    if (!parseResult.success) {
+      console.error("Invalid config:");
+      for (const issue of parseResult.error.issues) {
+        console.error(`  - ${issue.path.join(".")}: ${issue.message}`);
+      }
+      process.exit(1);
+    }
+    const conflicts = validateFieldIdConflicts(parseResult.data.blockFieldExtensions);
+    if (conflicts.length > 0) {
+      console.error("Field ID conflicts detected in blockFieldExtensions:");
+      for (const conflict of conflicts) {
+        console.error(`  - ${conflict.message}`);
+      }
+      process.exit(1);
+    }
+    const { siteId } = parseResult.data;
+    await pushToDashboard(
+      options.dashboard,
+      siteId,
+      options.apiKey,
+      parseResult.data
+    );
+    console.log("Config pushed successfully!");
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+function resolveDashboardUrl(cliOption) {
+  const url = cliOption || process.env.NEXT_PUBLIC_DASHBOARD_URL;
+  if (!url) {
+    console.error("Error: Dashboard URL is required.");
+    console.error("Provide --dashboard <url> or set NEXT_PUBLIC_DASHBOARD_URL environment variable.");
+    process.exit(1);
+  }
+  return url;
+}
+var pushConfigCommand = new commander.Command("push-config").description("Push SDK config from riverbank.config.ts to dashboard").requiredOption("--api-key <key>", "Dashboard API key").option("--config <path>", "Path to riverbank.config.ts (default: ./riverbank.config.ts)").option("--dashboard <url>", "Dashboard API URL (or set NEXT_PUBLIC_DASHBOARD_URL)").action((options) => {
+  const dashboard = resolveDashboardUrl(options.dashboard);
+  return pushConfigAction({ ...options, dashboard });
+});
+
+// src/cli/index.ts
+var program = new commander.Command();
+program.name("riverbankcms").description("Builder SDK CLI tools").version("0.1.0");
+program.addCommand(pushConfigCommand);
+program.parse();
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data/prefetchBlockData.ts","../../src/config/validation.ts","../../src/cli/load-config.ts","../../src/cli/push-config.ts","../../src/cli/index.ts"],"names":["z","fieldSchema","getBlockDefinition","blockCategoryEnum","existsSync","jiti","createJiti","resolve","Command"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * SDK wrapper for block data prefetching.\n * Uses the shared core implementation from @riverbankcms/blocks with the SDK client.\n */\n\nimport type { BlockDataLoader, PageOutline, SdkCustomBlock } from '@riverbankcms/blocks';\nimport { prefetchBlockData as prefetchBlockDataCore } from '@riverbankcms/blocks/system/data';\nimport type { PrefetchContext, ResolvedBlockData } from '@riverbankcms/blocks/system/data';\nimport type { RiverbankClient } from '../client/types';\n\nexport type { PrefetchContext, ResolvedBlockData };\n\n/**\n * Supported loader endpoints for SDK data fetching.\n * Only these endpoints can be used in block data loaders when using the SDK.\n *\n * This is the SINGLE SOURCE OF TRUTH for whitelisted endpoints.\n * - Zod validation schema derives from this array\n * - TypeScript types derive from this array\n * - Runtime validation uses this array\n */\nexport const SUPPORTED_LOADER_ENDPOINTS = [\n  'listPublishedEntries',\n  'getPublishedEntryPreview',\n  'listPublicEvents',\n  'getPublicFormById',\n  'getPublicBookingServices',\n] as const;\n\n/**\n * Union type of all supported loader endpoints.\n * Derived from SUPPORTED_LOADER_ENDPOINTS array.\n */\nexport type SupportedLoaderEndpoint = typeof SUPPORTED_LOADER_ENDPOINTS[number];\n\n/**\n * Options for SDK block data prefetching.\n */\nexport type SdkPrefetchOptions = {\n  /**\n   * SDK custom blocks from site config.\n   * Used to look up data loaders for custom.* blocks.\n   */\n  customBlocks?: SdkCustomBlock[];\n};\n\n/**\n * Prefetch block data for SDK-based applications.\n * Maps loader endpoints to corresponding SDK client methods.\n *\n * Supports both system blocks and SDK custom blocks with data loaders.\n *\n * @example\n * ```typescript\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { prefetchBlockData } from '@riverbankcms/sdk/data';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n * const page = await client.getPage({ siteId, path: '/' });\n *\n * // Basic usage (system blocks only)\n * const blockData = await prefetchBlockData(page.outline, {\n *   siteId: page.siteId,\n *   pageId: page.id,\n * }, client);\n *\n * // With custom blocks from SDK config\n * const blockData = await prefetchBlockData(page.outline, context, client, {\n *   customBlocks: site.sdkConfig?.customBlocks,\n * });\n * ```\n */\nexport async function prefetchBlockData(\n  page: PageOutline,\n  context: PrefetchContext,\n  client: RiverbankClient,\n  options?: SdkPrefetchOptions,\n): Promise<ResolvedBlockData> {\n  const { customBlocks } = options ?? {};\n\n  // Build lookup map for custom block loaders\n  // Key is string (blockKind from page) matching block.id (custom.xxx)\n  const customBlockMap = new Map<string, SdkCustomBlock>(\n    (customBlocks ?? []).map((block) => [block.id as string, block])\n  );\n\n  return prefetchBlockDataCore(page, context, {\n    apiClient: async ({ endpoint, params }) => {\n      // Only support whitelisted loader endpoints\n      if (!isSupportedEndpoint(endpoint)) {\n        throw new Error(\n          `Unsupported loader endpoint: ${endpoint}. ` +\n          `SDK only supports: ${SUPPORTED_LOADER_ENDPOINTS.join(', ')}`\n        );\n      }\n\n      // Map endpoint to SDK client method\n      switch (endpoint) {\n        case 'listPublishedEntries': {\n          const { siteId, type, orderBy, limit, stage, mode, entryIds } = params ?? {};\n          if (!siteId || !type) {\n            throw new Error('listPublishedEntries requires siteId and type params');\n          }\n\n          // Parse limit if provided (can come as string from bindings)\n          const parsedLimit = typeof limit === 'string'\n            ? Number.parseInt(limit, 10)\n            : typeof limit === 'number'\n              ? limit\n              : undefined;\n\n          // Map orderBy to order param (matching embed block field values)\n          const order = (orderBy === 'newest' || orderBy === 'oldest' || orderBy === 'title' || orderBy === 'order')\n            ? orderBy as 'newest' | 'oldest' | 'title' | 'order'\n            : undefined;\n\n          // Extract entry IDs for manual mode\n          // entryIds comes from binding to entries field which contains { entryId: \"uuid\" } objects\n          let parsedEntryIds: string[] | undefined;\n          if (mode === 'manual' && Array.isArray(entryIds)) {\n            parsedEntryIds = entryIds\n              .map((item: unknown) => {\n                if (typeof item === 'object' && item !== null && 'entryId' in item) {\n                  return (item as { entryId: string }).entryId;\n                }\n                // Also support direct string IDs\n                if (typeof item === 'string') {\n                  return item;\n                }\n                return null;\n              })\n              .filter((id): id is string => id !== null);\n          }\n\n          return await client.getEntries({\n            siteId,\n            contentType: type,\n            limit: parsedLimit,\n            order,\n            preview: stage === 'preview',\n            // Manual mode - pass entry IDs for hydration\n            mode: mode === 'manual' ? 'manual' : undefined,\n            entryIds: parsedEntryIds,\n          });\n        }\n\n        case 'getPublishedEntryPreview': {\n          const { siteId, type, slug } = params ?? {};\n          if (!siteId || !type || !slug) {\n            throw new Error('getPublishedEntryPreview requires siteId, type, and slug params');\n          }\n          return await client.getEntry({ siteId, contentType: type, slug });\n        }\n        case 'listPublicEvents': {\n          const { siteId, limit, from, to, stage } = params ?? {};\n          if (!siteId) {\n            throw new Error('listPublicEvents requires siteId param');\n          }\n          const parsedLimit =\n            typeof limit === 'string'\n              ? Number.parseInt(limit, 10)\n              : typeof limit === 'number'\n                ? limit\n                : undefined;\n          return await client.listPublicEvents({ siteId, limit: parsedLimit, from, to, stage });\n        }\n        case 'getPublicFormById': {\n          const { formId } = params ?? {};\n          if (!formId) {\n            throw new Error('getPublicFormById requires formId param');\n          }\n          return await client.getPublicFormById({ formId });\n        }\n        case 'getPublicBookingServices': {\n          const { siteId, ids } = params ?? {};\n          if (!siteId) {\n            throw new Error('getPublicBookingServices requires siteId param');\n          }\n          return await client.getPublicBookingServices({ siteId, ids });\n        }\n\n        default: {\n          // TypeScript should never reach here due to isSupportedEndpoint check\n          const _exhaustive: never = endpoint;\n          throw new Error(`Unhandled endpoint: ${_exhaustive}`);\n        }\n      }\n    },\n    isValidEndpoint: isSupportedEndpoint,\n    onError: (error, { block, loader }) => {\n      console.warn('[prefetchBlockData] failed to prefetch block data', {\n        block,\n        loader,\n        error,\n      });\n    },\n    // Provide custom block loader lookup for SDK custom blocks\n    getCustomBlockLoaders: (blockKind): Record<string, BlockDataLoader> | undefined => {\n      const customBlock = customBlockMap.get(blockKind);\n      if (!customBlock?.dataLoaders) return undefined;\n\n      // Convert SdkConfigLoader to BlockDataLoader\n      // SdkConfigLoader.endpoint is SdkLoaderEndpoint (string union) -> string\n      // SdkConfigLoader.params is Record<string, LoaderParamValue> -> Record<string, unknown>\n      // Both are structurally compatible via covariance\n      const loaders: Record<string, BlockDataLoader> = {};\n      for (const [key, loader] of Object.entries(customBlock.dataLoaders)) {\n        loaders[key] = {\n          endpoint: loader.endpoint,\n          params: loader.params,\n          mode: loader.mode,\n        };\n      }\n      return loaders;\n    },\n  });\n}\n\n/**\n * Type guard for supported loader endpoints\n */\nfunction isSupportedEndpoint(endpoint: string): endpoint is SupportedLoaderEndpoint {\n  return SUPPORTED_LOADER_ENDPOINTS.includes(endpoint as SupportedLoaderEndpoint);\n}\n","/**\n * Zod validation schemas for SDK site configuration.\n *\n * These schemas are used to validate configuration fetched from\n * SDK sites before storing in the database.\n */\n\nimport { z } from 'zod';\nimport { blockCategoryEnum, fieldSchema, getBlockDefinition, type SdkCustomBlock, type FieldDefinition } from '@riverbankcms/blocks';\nimport type { RiverbankSiteConfig, BlockFieldOptionsMap, BlockFieldExtensionsMap, BlockFieldExtension } from './types';\n\n/**\n * Schema for SDK theme palette.\n * Maps token names to CSS color values.\n */\nexport const sdkThemePaletteSchema = z.record(z.string(), z.string());\n\n/**\n * Schema for SDK theme configuration.\n */\nexport const sdkThemeConfigSchema = z.object({\n  palette: sdkThemePaletteSchema,\n});\n\n/**\n * Schema for section background color options.\n */\nexport const sectionBackgroundSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  token: z.string(), // Reference to theme palette token\n});\n\n/**\n * Schema for section spacing values.\n */\nexport const sectionSpacingSchema = z.enum(['compact', 'default', 'spacious']);\n\n/**\n * Schema for container max-width values.\n */\nexport const containerMaxWidthSchema = z.enum(['narrow', 'default', 'wide', 'full']);\n\n/**\n * Schema for container alignment values.\n */\nexport const containerAlignmentSchema = z.enum(['left', 'center', 'right']);\n\n/**\n * Schema for section options configuration.\n */\nexport const sectionOptionsSchema = z.object({\n  backgroundColor: z.boolean().optional(),\n  backgroundImage: z.boolean().optional(),\n  backgroundGradient: z.boolean().optional(),\n  spacing: z.union([\n    z.array(sectionSpacingSchema),\n    z.boolean(),\n  ]).optional(),\n  textColor: z.boolean().optional(),\n}).optional();\n\n/**\n * Schema for container options configuration.\n */\nexport const containerOptionsSchema = z.object({\n  maxWidth: z.union([\n    z.array(containerMaxWidthSchema),\n    z.boolean(),\n  ]).optional(),\n  alignment: z.union([\n    z.array(containerAlignmentSchema),\n    z.boolean(),\n  ]).optional(),\n}).optional();\n\n/**\n * Schema for site style configuration.\n */\nexport const siteStyleConfigSchema = z.object({\n  sectionBackgrounds: z.array(sectionBackgroundSchema).optional(),\n  sectionOptions: sectionOptionsSchema,\n  containerOptions: containerOptionsSchema,\n}).optional();\n\n// ============================================================================\n// Data Loader Schemas\n// ============================================================================\n\nimport { SUPPORTED_LOADER_ENDPOINTS } from '../data/prefetchBlockData';\n\n/**\n * Whitelisted endpoints for SDK data loaders.\n *\n * These are the only CMS endpoints that can be called from config-based loaders.\n * This ensures SDK sites can only access safe, read-only public endpoints.\n *\n * Derived from SUPPORTED_LOADER_ENDPOINTS - the single source of truth.\n */\nexport const sdkLoaderEndpointSchema = z.enum(SUPPORTED_LOADER_ENDPOINTS);\n\n/**\n * A binding expression for dynamic loader params.\n *\n * @example\n * ```typescript\n * { $bind: { from: 'content.categoryId' } }\n * { $bind: { from: '$root.siteId' } }\n * { $bind: { from: 'content.limit', fallback: '10' } }\n * ```\n */\nexport const loaderParamBindingSchema = z.object({\n  $bind: z.object({\n    from: z.string().min(1, \"Binding path is required\"),\n    fallback: z.string().optional(),\n  }),\n});\n\n/**\n * A loader param value can be static or a binding expression.\n */\nexport const loaderParamValueSchema = z.union([\n  z.string(),\n  z.number(),\n  z.boolean(),\n  loaderParamBindingSchema,\n]);\n\n/**\n * Schema for config-based data loader.\n *\n * Config loaders execute server-side during loadPage() and are\n * restricted to whitelisted CMS endpoints.\n */\nexport const sdkConfigLoaderSchema = z.object({\n  endpoint: sdkLoaderEndpointSchema,\n  params: z.record(z.string(), loaderParamValueSchema),\n  mode: z.enum(['server', 'client']).default('server'),\n});\n\n/**\n * Schema for the dataLoaders field on custom blocks.\n * Validates the loader configuration and limits the number of loaders.\n */\nexport const sdkDataLoadersSchema = z.record(z.string(), sdkConfigLoaderSchema)\n  .refine(\n    (loaders) => Object.keys(loaders).length <= 5,\n    { message: \"Maximum 5 data loaders per block\" }\n  )\n  .optional();\n\n// ============================================================================\n// Custom Block Schema\n// ============================================================================\n\n/**\n * Schema for field select option.\n */\nexport const fieldSelectOptionSchema = z.object({\n  value: z.string().min(1, \"Option value is required\"),\n  label: z.string().min(1, \"Option label is required\"),\n});\n\n/**\n * Schema for per-field configuration within a block.\n */\nexport const blockFieldConfigSchema = z.object({\n  options: z.array(fieldSelectOptionSchema).min(1, \"At least one option is required\").optional(),\n});\n\n/**\n * Schema for per-block field options.\n *\n * Block IDs must be either 'block.*' (system blocks) or 'custom.*' (custom blocks).\n * Field IDs can be any valid identifier string.\n */\nexport const blockFieldOptionsSchema: z.ZodType<BlockFieldOptionsMap> = z.record(\n  z.string().regex(/^(block\\.|custom\\.)[a-z][a-z0-9-]*$/, {\n    message: \"Block ID must be 'block.*' or 'custom.*' format\",\n  }),\n  z.record(\n    z.string().min(1, \"Field ID is required\"),\n    blockFieldConfigSchema\n  )\n).optional() as z.ZodType<BlockFieldOptionsMap>;\n\n// ============================================================================\n// Block Field Extensions Schema\n// ============================================================================\n\n/**\n * Schema for block field extension configuration.\n *\n * Validates additional fields to be appended to a built-in block.\n * Includes refinement to ensure required fields have defaultValue.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const blockFieldExtensionSchema: z.ZodType<BlockFieldExtension> = z.object({\n  fields: fieldSchema.array().min(1, \"At least one field is required\"),\n}).refine(\n  (data) => {\n    // All required fields must have a defaultValue\n    return data.fields.every((field: FieldDefinition) => {\n      if (!field.required) return true;\n      return field.defaultValue !== undefined;\n    });\n  },\n  {\n    message: \"Required fields must have a defaultValue to support existing blocks\",\n  }\n) as z.ZodType<BlockFieldExtension>;\n\n/**\n * Schema for block field extensions map.\n *\n * Block IDs must be system blocks (e.g., 'block.bodyText', 'block.hero').\n * Custom blocks ('custom.*') should define their fields directly, not via extensions.\n */\nexport const blockFieldExtensionsSchema: z.ZodType<BlockFieldExtensionsMap | undefined> = z.record(\n  z.string().regex(/^block\\.[a-z][a-zA-Z0-9]*$/, {\n    message: \"Block ID must be 'block.*' format (system blocks only)\",\n  }),\n  blockFieldExtensionSchema\n).optional() as z.ZodType<BlockFieldExtensionsMap | undefined>;\n\n/**\n * Validates that extended field IDs don't conflict with existing block fields.\n *\n * This validation should be called during config push to provide clear error messages.\n * Returns an array of conflict errors, or empty array if valid.\n *\n * @example\n * ```typescript\n * const conflicts = validateFieldIdConflicts(config.blockFieldExtensions);\n * if (conflicts.length > 0) {\n *   throw new Error(conflicts.map(c => c.message).join('\\n'));\n * }\n * ```\n */\nexport function validateFieldIdConflicts(\n  blockFieldExtensions?: BlockFieldExtensionsMap | null\n): { blockId: string; fieldId: string; message: string }[] {\n  if (!blockFieldExtensions) return [];\n\n  const conflicts: { blockId: string; fieldId: string; message: string }[] = [];\n\n  for (const [blockId, extension] of Object.entries(blockFieldExtensions)) {\n    const definition = getBlockDefinition(blockId);\n    if (!definition) {\n      conflicts.push({\n        blockId,\n        fieldId: '',\n        message: `Unknown block type: ${blockId}`,\n      });\n      continue;\n    }\n\n    // Get all existing field IDs from the block manifest\n    const existingFieldIds = new Set<string>();\n    const collectFieldIds = (fields: FieldDefinition[] | undefined) => {\n      if (!fields) return;\n      for (const field of fields) {\n        existingFieldIds.add(field.id);\n        // Also collect nested field IDs from groups, modals, repeaters, tab groups\n        if (field.type === 'group' || field.type === 'modal') {\n          collectFieldIds(field.schema?.fields);\n        } else if (field.type === 'repeater' && field.schema?.fields) {\n          collectFieldIds(field.schema.fields);\n        } else if (field.type === 'tabGroup') {\n          for (const tab of field.tabs ?? []) {\n            collectFieldIds(tab.fields);\n          }\n        }\n      }\n    };\n    collectFieldIds(definition.manifest.fields);\n\n    // Check for conflicts\n    for (const field of extension.fields) {\n      if (existingFieldIds.has(field.id)) {\n        conflicts.push({\n          blockId,\n          fieldId: field.id,\n          message: `Field ID \"${field.id}\" conflicts with existing field in ${blockId}`,\n        });\n      }\n    }\n  }\n\n  return conflicts;\n}\n\n/**\n * Schema for SDK custom block definitions.\n *\n * Validates custom blocks defined in riverbank.config.ts.\n * Reuses fieldSchema from @riverbankcms/blocks for field validation.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const sdkCustomBlockSchema: z.ZodType<SdkCustomBlock> = z.object({\n  // Block ID must start with 'custom.'\n  id: z.string()\n    .min(8) // 'custom.' + at least 1 char\n    .regex(/^custom\\.[a-z][a-z0-9-]*$/, {\n      message: \"Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens\",\n    }),\n  title: z.string().min(1, \"Title is required\"),\n  titleSource: z.string().optional(),\n  description: z.string().optional(),\n  category: blockCategoryEnum,\n  icon: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  // Reuse the exact field schema from @riverbankcms/blocks - all field types supported\n  fields: fieldSchema.array().min(1, \"Custom blocks must have at least one field\"),\n  // Data loaders for CMS endpoints\n  dataLoaders: sdkDataLoadersSchema,\n}).refine(\n  // Validate titleSource references a valid field if provided\n  (data) => {\n    if (!data.titleSource) return true;\n    return data.fields.some(f => f.id === data.titleSource);\n  },\n  {\n    message: \"titleSource must reference a valid field ID\",\n    path: [\"titleSource\"],\n  }\n) as z.ZodType<SdkCustomBlock>;\n\n/**\n * Schema for the complete SDK site configuration.\n *\n * Use this schema to validate configuration fetched from SDK sites\n * before storing in the database.\n *\n * @example\n * ```typescript\n * import { riverbankSiteConfigSchema } from '@riverbankcms/sdk/config/validation';\n *\n * const rawConfig = await response.json();\n * const config = riverbankSiteConfigSchema.parse(rawConfig);\n * ```\n */\nexport const riverbankSiteConfigSchema: z.ZodType<RiverbankSiteConfig> = z.object({\n  siteId: z.string().uuid(),\n  theme: sdkThemeConfigSchema.optional(),\n  styles: siteStyleConfigSchema,\n  customBlocks: z.array(sdkCustomBlockSchema)\n    .max(20, \"Maximum 20 custom blocks per site\")\n    .refine(\n      // Ensure unique block IDs\n      (blocks) => {\n        const ids = blocks.map(b => b.id);\n        return ids.length === new Set(ids).size;\n      },\n      { message: \"Block IDs must be unique\" }\n    )\n    .optional(),\n  blockFieldOptions: blockFieldOptionsSchema,\n  blockFieldExtensions: blockFieldExtensionsSchema,\n}).strict() as z.ZodType<RiverbankSiteConfig>;\n\n/**\n * Type inferred from the validation schema.\n * This should match the RiverbankSiteConfig type from ./types.ts\n */\nexport type ValidatedRiverbankSiteConfig = z.infer<typeof riverbankSiteConfigSchema>;\n\n/**\n * Type for a validated SDK custom block.\n */\nexport type ValidatedSdkCustomBlock = z.infer<typeof sdkCustomBlockSchema>;\n\n// ============================================================================\n// Compile-time type assertions\n//\n// These assertions ensure the Zod schemas stay in sync with the TypeScript types.\n// If the schema output diverges from the expected type, TypeScript will error here.\n// ============================================================================\n\n/** Asserts sdkCustomBlockSchema output matches SdkCustomBlock */\ntype _AssertSdkCustomBlockSchema = z.infer<typeof sdkCustomBlockSchema> extends SdkCustomBlock\n  ? SdkCustomBlock extends z.infer<typeof sdkCustomBlockSchema>\n    ? true\n    : never\n  : never;\n\n/** Asserts riverbankSiteConfigSchema output matches RiverbankSiteConfig */\ntype _AssertRiverbankSiteConfigSchema = z.infer<typeof riverbankSiteConfigSchema> extends RiverbankSiteConfig\n  ? RiverbankSiteConfig extends z.infer<typeof riverbankSiteConfigSchema>\n    ? true\n    : never\n  : never;\n\n// These assignments will fail to compile if the types don't match\nconst _checkSdkCustomBlock: _AssertSdkCustomBlockSchema = true;\nconst _checkRiverbankSiteConfig: _AssertRiverbankSiteConfigSchema = true;\n\n// Prevent unused variable warnings\nvoid _checkSdkCustomBlock;\nvoid _checkRiverbankSiteConfig;\n","/**\n * Config file loader for riverbank.config.ts\n *\n * Uses jiti to load TypeScript config files at runtime without\n * requiring a build step.\n */\n\nimport { createJiti } from 'jiti';\nimport { resolve } from 'path';\nimport { existsSync } from 'fs';\n\nconst DEFAULT_CONFIG_FILENAME = 'riverbank.config.ts';\n\n/**\n * Load builder config from a TypeScript file.\n *\n * @param configPath - Path to config file, or directory containing riverbank.config.ts\n * @returns The loaded config object\n * @throws Error if config file not found or invalid\n */\nexport async function loadConfigFile(configPath?: string): Promise<unknown> {\n  // Resolve the config file path\n  const resolvedPath = resolveConfigPath(configPath);\n\n  if (!existsSync(resolvedPath)) {\n    throw new Error(\n      `Config file not found: ${resolvedPath}\\n` +\n      `Create a riverbank.config.ts file or specify a path with --config`\n    );\n  }\n\n  console.log(`Loading config from ${resolvedPath}...`);\n\n  // Create jiti instance for loading TypeScript files\n  const jiti = createJiti(import.meta.url, {\n    // Disable caching for CLI tool\n    fsCache: false,\n    moduleCache: false,\n  });\n\n  try {\n    // Load the config file\n    const configModule = await jiti.import(resolvedPath);\n\n    // Support both default export and named 'config' export\n    const config = (configModule as Record<string, unknown>).default\n      ?? (configModule as Record<string, unknown>).config\n      ?? configModule;\n\n    if (!config || typeof config !== 'object') {\n      throw new Error('Config file must export a configuration object');\n    }\n\n    return config;\n  } catch (error) {\n    if (error instanceof Error) {\n      throw new Error(`Failed to load config: ${error.message}`);\n    }\n    throw error;\n  }\n}\n\n/**\n * Resolve config path from user input.\n *\n * If no path provided, looks for riverbank.config.ts in cwd.\n * If path is a directory, looks for riverbank.config.ts in that directory.\n * If path is a file, uses it directly.\n */\nfunction resolveConfigPath(configPath?: string): string {\n  if (!configPath) {\n    // Default: look in current directory\n    return resolve(process.cwd(), DEFAULT_CONFIG_FILENAME);\n  }\n\n  const resolved = resolve(configPath);\n\n  // If it's a directory, append the default filename\n  if (existsSync(resolved) && !resolved.endsWith('.ts') && !resolved.endsWith('.js')) {\n    return resolve(resolved, DEFAULT_CONFIG_FILENAME);\n  }\n\n  // Otherwise use as-is (could be a specific file)\n  return resolved;\n}\n","/**\n * push-config CLI command\n *\n * Pushes SDK site configuration from a riverbank.config.ts file to the dashboard API.\n */\n\nimport { Command } from 'commander';\nimport { riverbankSiteConfigSchema, validateFieldIdConflicts } from '../config/validation';\nimport { loadConfigFile } from './load-config';\n\ninterface PushConfigOptions {\n  config?: string;\n  apiKey: string;\n  dashboard: string;\n}\n\n/**\n * Push config to dashboard API\n */\nasync function pushToDashboard(\n  dashboardUrl: string,\n  siteId: string,\n  apiKey: string,\n  config: unknown\n): Promise<void> {\n  const pushUrl = `${dashboardUrl}/api/sites/${siteId}/sdk-config`;\n  console.log(`Pushing config to ${pushUrl}...`);\n\n  let response: Response;\n  try {\n    response = await fetch(pushUrl, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-API-Key': apiKey,\n      },\n      body: JSON.stringify({ config }),\n      signal: AbortSignal.timeout(30000),\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    throw new Error(`Failed to connect to dashboard: ${message}`);\n  }\n\n  if (!response.ok) {\n    let errorMessage = `Dashboard returned ${response.status}`;\n    try {\n      const errorBody = await response.json();\n      if (errorBody.error) {\n        errorMessage = errorBody.error;\n        if (errorBody.details) {\n          errorMessage += ':\\n' + errorBody.details\n            .map((d: { path: string; message: string }) => `  - ${d.path}: ${d.message}`)\n            .join('\\n');\n        }\n      }\n    } catch {\n      // Use default error message if JSON parsing fails\n    }\n    throw new Error(errorMessage);\n  }\n}\n\n/**\n * Main push-config action\n */\nasync function pushConfigAction(options: PushConfigOptions): Promise<void> {\n  try {\n    // 1. Load config from file\n    const rawConfig = await loadConfigFile(options.config);\n\n    // 2. Validate config\n    console.log('Validating config...');\n    const parseResult = riverbankSiteConfigSchema.safeParse(rawConfig);\n    if (!parseResult.success) {\n      console.error('Invalid config:');\n      for (const issue of parseResult.error.issues) {\n        console.error(`  - ${issue.path.join('.')}: ${issue.message}`);\n      }\n      process.exit(1);\n    }\n\n    // 2b. Validate field ID conflicts for blockFieldExtensions\n    const conflicts = validateFieldIdConflicts(parseResult.data.blockFieldExtensions);\n    if (conflicts.length > 0) {\n      console.error('Field ID conflicts detected in blockFieldExtensions:');\n      for (const conflict of conflicts) {\n        console.error(`  - ${conflict.message}`);\n      }\n      process.exit(1);\n    }\n\n    const { siteId } = parseResult.data;\n\n    // 3. Push to dashboard (send full config, dashboard will verify siteId matches)\n    await pushToDashboard(\n      options.dashboard,\n      siteId,\n      options.apiKey,\n      parseResult.data\n    );\n\n    console.log('Config pushed successfully!');\n  } catch (error) {\n    console.error('Error:', error instanceof Error ? error.message : error);\n    process.exit(1);\n  }\n}\n\n/**\n * Resolve dashboard URL from CLI option or environment variable.\n * Requires one of them to be set.\n */\nfunction resolveDashboardUrl(cliOption?: string): string {\n  const url = cliOption || process.env.NEXT_PUBLIC_DASHBOARD_URL;\n  if (!url) {\n    console.error('Error: Dashboard URL is required.');\n    console.error('Provide --dashboard <url> or set NEXT_PUBLIC_DASHBOARD_URL environment variable.');\n    process.exit(1);\n  }\n  return url;\n}\n\n/**\n * push-config command definition\n */\nexport const pushConfigCommand = new Command('push-config')\n  .description('Push SDK config from riverbank.config.ts to dashboard')\n  .requiredOption('--api-key <key>', 'Dashboard API key')\n  .option('--config <path>', 'Path to riverbank.config.ts (default: ./riverbank.config.ts)')\n  .option('--dashboard <url>', 'Dashboard API URL (or set NEXT_PUBLIC_DASHBOARD_URL)')\n  .action((options: Omit<PushConfigOptions, 'dashboard'> & { dashboard?: string }) => {\n    const dashboard = resolveDashboardUrl(options.dashboard);\n    return pushConfigAction({ ...options, dashboard });\n  });\n","/**\n * Builder SDK CLI\n *\n * CLI tools for SDK site developers.\n */\n\nimport { Command } from 'commander';\nimport { pushConfigCommand } from './push-config';\n\nconst program = new Command();\n\nprogram\n  .name('riverbankcms')\n  .description('Builder SDK CLI tools')\n  .version('0.1.0');\n\n// Add push-config command\nprogram.addCommand(pushConfigCommand);\n\nprogram.parse();\n"]}

package/dist/client/analytics.d.mts

@@ -0,0 +1,103 @@
+/**
+ * Analytics Bootstrap Component
+ *
+ * Client component that initializes analytics tracking for a Builder site.
+ * Auto-tracks page views and provides helpers for tracking custom events.
+ */
+type AnalyticsConfig = {
+    /**
+     * Site ID for analytics tracking
+     */
+    siteId: string;
+    /**
+     * Site slug for analytics tracking
+     */
+    siteSlug: string;
+    /**
+     * Analytics endpoint URL
+     * @default '/api/analytics/collect'
+     */
+    endpoint?: string;
+    /**
+     * Custom session cookie name
+     * @default 'builder_analytics_session'
+     */
+    sessionCookieName?: string;
+    /**
+     * Disable analytics tracking
+     * @default false
+     */
+    disabled?: boolean;
+};
+type AnalyticsClient = {
+    track: (event: TrackEventInput) => Promise<void>;
+    trackCtaClick: (metadata?: Record<string, unknown>) => Promise<void>;
+    trackFormSubmit: (metadata?: Record<string, unknown>) => Promise<void>;
+    destroy: () => void;
+};
+type TrackEventInput = {
+    eventType: string;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Analytics helpers returned by useAnalytics hook
+ */
+type AnalyticsHelpers = {
+    trackEvent: (event: TrackEventInput) => void;
+    trackCtaClick: (metadata?: Record<string, unknown>) => void;
+    trackFormSubmit: (metadata?: Record<string, unknown>) => void;
+};
+/**
+ * Analytics Bootstrap component
+ *
+ * Place this component in your layout to enable analytics tracking.
+ *
+ * @example
+ * ```tsx
+ * import { AnalyticsBootstrap } from '@riverbankcms/sdk/analytics';
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <AnalyticsBootstrap
+ *           siteId="your-site-id"
+ *           siteSlug="your-site-slug"
+ *         />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+declare function AnalyticsBootstrap(config: AnalyticsConfig): null;
+/**
+ * Hook for tracking analytics events
+ *
+ * @param config - Analytics configuration. Pass null to disable analytics.
+ * @returns Analytics helpers for tracking events
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ *
+ * import { useAnalytics } from '@riverbankcms/sdk/analytics';
+ *
+ * export function MyComponent() {
+ *   const analytics = useAnalytics({
+ *     siteId: 'your-site-id',
+ *     siteSlug: 'your-site-slug',
+ *   });
+ *
+ *   const handleClick = () => {
+ *     analytics.trackCtaClick({ buttonLabel: 'Sign Up' });
+ *   };
+ *
+ *   return <button onClick={handleClick}>Sign Up</button>;
+ * }
+ * ```
+ */
+declare function useAnalytics(config: AnalyticsConfig | null): AnalyticsHelpers;
+
+export { AnalyticsBootstrap, type AnalyticsClient, type AnalyticsConfig, type AnalyticsHelpers, type TrackEventInput, useAnalytics };

package/dist/client/analytics.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Analytics Bootstrap Component
+ *
+ * Client component that initializes analytics tracking for a Builder site.
+ * Auto-tracks page views and provides helpers for tracking custom events.
+ */
+type AnalyticsConfig = {
+    /**
+     * Site ID for analytics tracking
+     */
+    siteId: string;
+    /**
+     * Site slug for analytics tracking
+     */
+    siteSlug: string;
+    /**
+     * Analytics endpoint URL
+     * @default '/api/analytics/collect'
+     */
+    endpoint?: string;
+    /**
+     * Custom session cookie name
+     * @default 'builder_analytics_session'
+     */
+    sessionCookieName?: string;
+    /**
+     * Disable analytics tracking
+     * @default false
+     */
+    disabled?: boolean;
+};
+type AnalyticsClient = {
+    track: (event: TrackEventInput) => Promise<void>;
+    trackCtaClick: (metadata?: Record<string, unknown>) => Promise<void>;
+    trackFormSubmit: (metadata?: Record<string, unknown>) => Promise<void>;
+    destroy: () => void;
+};
+type TrackEventInput = {
+    eventType: string;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Analytics helpers returned by useAnalytics hook
+ */
+type AnalyticsHelpers = {
+    trackEvent: (event: TrackEventInput) => void;
+    trackCtaClick: (metadata?: Record<string, unknown>) => void;
+    trackFormSubmit: (metadata?: Record<string, unknown>) => void;
+};
+/**
+ * Analytics Bootstrap component
+ *
+ * Place this component in your layout to enable analytics tracking.
+ *
+ * @example
+ * ```tsx
+ * import { AnalyticsBootstrap } from '@riverbankcms/sdk/analytics';
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <AnalyticsBootstrap
+ *           siteId="your-site-id"
+ *           siteSlug="your-site-slug"
+ *         />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+declare function AnalyticsBootstrap(config: AnalyticsConfig): null;
+/**
+ * Hook for tracking analytics events
+ *
+ * @param config - Analytics configuration. Pass null to disable analytics.
+ * @returns Analytics helpers for tracking events
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ *
+ * import { useAnalytics } from '@riverbankcms/sdk/analytics';
+ *
+ * export function MyComponent() {
+ *   const analytics = useAnalytics({
+ *     siteId: 'your-site-id',
+ *     siteSlug: 'your-site-slug',
+ *   });
+ *
+ *   const handleClick = () => {
+ *     analytics.trackCtaClick({ buttonLabel: 'Sign Up' });
+ *   };
+ *
+ *   return <button onClick={handleClick}>Sign Up</button>;
+ * }
+ * ```
+ */
+declare function useAnalytics(config: AnalyticsConfig | null): AnalyticsHelpers;
+
+export { AnalyticsBootstrap, type AnalyticsClient, type AnalyticsConfig, type AnalyticsHelpers, type TrackEventInput, useAnalytics };