@burdenoff/website-sdk 0.0.0-dev

package/dist/product/index.mjs

@@ -0,0 +1,278 @@
+import { createContext, useState, useCallback, useLayoutEffect, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/client/security.ts
+var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "::1"]);
+var RESERVED_HEADERS = /* @__PURE__ */ new Set([
+  "authorization",
+  "cookie",
+  "x-actor-id",
+  "x-actor-type",
+  "x-consent-granted-by",
+  "x-consent-scope",
+  "x-consent-granted-at",
+  "x-consent-expires-at"
+]);
+function validateGatewayUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error("Gateway URL must be a valid absolute URL");
+  }
+  if (url.protocol === "https:") {
+    return url.toString();
+  }
+  if (url.protocol === "http:" && LOOPBACK_HOSTS.has(url.hostname.toLowerCase())) {
+    return url.toString();
+  }
+  throw new Error("Gateway URL must use HTTPS unless it targets localhost");
+}
+function sanitizeHeaders(headers) {
+  if (!headers) return void 0;
+  return Object.fromEntries(
+    Object.entries(headers).filter(
+      ([key]) => !RESERVED_HEADERS.has(key.toLowerCase())
+    )
+  );
+}
+
+// src/client/graphql-client.ts
+var _WebSDKClient = class _WebSDKClient {
+  constructor(config) {
+    __publicField(this, "config");
+    __publicField(this, "queryCache", /* @__PURE__ */ new Map());
+    __publicField(this, "inflight", /* @__PURE__ */ new Map());
+    this.config = {
+      ...config,
+      gatewayUrl: validateGatewayUrl(config.gatewayUrl),
+      headers: sanitizeHeaders(config.headers)
+    };
+  }
+  getConfig() {
+    return this.config;
+  }
+  /**
+   * Execute a GraphQL query (with deduplication and caching)
+   */
+  async query(query, variables) {
+    const cacheKey = JSON.stringify({ query, variables });
+    const cached = this.queryCache.get(cacheKey);
+    if (cached) {
+      if (Date.now() - cached.ts < _WebSDKClient.CACHE_TTL) {
+        return cached.data;
+      }
+      this.queryCache.delete(cacheKey);
+    }
+    const existing = this.inflight.get(cacheKey);
+    if (existing) {
+      return existing;
+    }
+    const promise = this.request(query, variables).then((result) => {
+      if (result.data && !result.errors?.length) {
+        if (this.queryCache.size >= _WebSDKClient.MAX_CACHE_ENTRIES) {
+          const oldestEntry = this.queryCache.keys().next().value;
+          if (oldestEntry) {
+            this.queryCache.delete(oldestEntry);
+          }
+        }
+        this.queryCache.set(cacheKey, { data: result, ts: Date.now() });
+      }
+      return result;
+    }).finally(() => {
+      this.inflight.delete(cacheKey);
+    });
+    this.inflight.set(cacheKey, promise);
+    return promise;
+  }
+  /**
+   * Execute a GraphQL mutation
+   */
+  async mutate(mutation, variables) {
+    return this.request(mutation, variables);
+  }
+  async request(query, variables) {
+    try {
+      const response = await fetch(this.config.gatewayUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-product-id": this.config.productId,
+          ...this.config.headers
+        },
+        body: JSON.stringify({ query, variables })
+      });
+      if (!response.ok) {
+        console.error(
+          "[WebSDK] GraphQL request failed",
+          response.status,
+          response.statusText
+        );
+        return {
+          errors: [
+            {
+              message: `HTTP ${response.status}: ${response.statusText}`,
+              extensions: { code: `HTTP_${response.status}` }
+            }
+          ]
+        };
+      }
+      return await response.json();
+    } catch (error) {
+      console.error(
+        "[WebSDK] Network error",
+        error instanceof Error ? error.message : "unknown error"
+      );
+      return {
+        errors: [
+          {
+            message: error instanceof Error ? error.message : "Network error",
+            extensions: { code: "NETWORK_ERROR" }
+          }
+        ]
+      };
+    }
+  }
+};
+__publicField(_WebSDKClient, "CACHE_TTL", 5 * 60 * 1e3);
+// 5 minutes
+__publicField(_WebSDKClient, "MAX_CACHE_ENTRIES", 100);
+var WebSDKContext = createContext(null);
+function useWebSDK() {
+  const client = useContext(WebSDKContext);
+  if (!client) {
+    throw new Error("useWebSDK must be used within a WebSDKProvider");
+  }
+  return client;
+}
+function useWebSDKConfig() {
+  const client = useWebSDK();
+  return client.getConfig();
+}
+var PRODUCT_FIELDS_BASE = `
+      id
+      name
+      slug
+      description
+      status
+      logoUrl
+      website
+      appUrl
+      docsUrl
+      contactEmail
+      supportEmail
+      contactPhone
+      contactAddress
+      seoTitle
+      seoDescription
+      seoKeywords
+      ogImage
+      socialLinks
+      recaptchaSiteKey
+      rybbitSiteId
+      notificationEmail
+      metadata
+`;
+var PUBLIC_PRODUCT_QUERY = `
+  query PublicProduct($slug: String!) {
+    publicProduct(slug: $slug) {
+      ${PRODUCT_FIELDS_BASE}
+      resourceLinks
+    }
+  }
+`;
+var PUBLIC_PRODUCT_QUERY_FALLBACK = `
+  query PublicProductFallback($slug: String!) {
+    publicProduct(slug: $slug) {
+      ${PRODUCT_FIELDS_BASE}
+    }
+  }
+`;
+var ProductContext = createContext({
+  product: null,
+  loading: true,
+  error: null,
+  hasProvider: false,
+  refetch: () => {
+  }
+});
+function ProductProvider({ children, fallback }) {
+  const client = useWebSDK();
+  const config = useWebSDKConfig();
+  const [product, setProduct] = useState(
+    fallback ? fallback : null
+  );
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const fetchProduct = useCallback(async () => {
+    if (!config.productSlug) {
+      setLoading(false);
+      return;
+    }
+    setLoading(true);
+    setError(null);
+    try {
+      let result = await client.query(
+        PUBLIC_PRODUCT_QUERY,
+        { slug: config.productSlug }
+      );
+      const schemaMissingResourceLinks = result.errors?.some(
+        (e) => /Cannot query field ["']?resourceLinks["']?/i.test(e?.message ?? "")
+      );
+      if (schemaMissingResourceLinks) {
+        result = await client.query(
+          PUBLIC_PRODUCT_QUERY_FALLBACK,
+          { slug: config.productSlug }
+        );
+      }
+      if (result.errors?.length) {
+        setError(result.errors[0]?.message ?? "Unknown error");
+      } else if (result.data?.publicProduct) {
+        setProduct(result.data.publicProduct);
+      }
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to fetch product");
+    } finally {
+      setLoading(false);
+    }
+  }, [client, config.productSlug]);
+  useLayoutEffect(() => {
+    fetchProduct();
+  }, [fetchProduct]);
+  const value = useMemo(
+    () => ({
+      product,
+      loading,
+      error,
+      hasProvider: true,
+      refetch: fetchProduct
+    }),
+    [product, loading, error, fetchProduct]
+  );
+  return /* @__PURE__ */ jsx(ProductContext.Provider, { value, children });
+}
+function useProduct() {
+  return useContext(ProductContext);
+}
+function useProductConfig() {
+  const { product } = useProduct();
+  const config = useWebSDKConfig();
+  return {
+    // Prefer product-level config, fall back to SDK config
+    recaptchaSiteKey: product?.recaptchaSiteKey ?? config.recaptchaSiteKey ?? null,
+    rybbitSiteId: product?.rybbitSiteId ?? config.rybbitSiteId ?? null,
+    contactEmail: product?.contactEmail ?? null,
+    supportEmail: product?.supportEmail ?? null,
+    notificationEmail: product?.notificationEmail ?? product?.contactEmail ?? null,
+    productName: product?.name ?? null,
+    logoUrl: product?.logoUrl ?? null
+  };
+}
+
+export { ProductProvider, useProduct, useProductConfig };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/product/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/security.ts","../../src/client/graphql-client.ts","../../src/client/provider.tsx","../../src/product/product-provider.tsx"],"names":["createContext","useMemo","jsx","useContext"],"mappings":"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","file":"index.mjs","sourcesContent":["const LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"::1\"]);\nconst RESERVED_HEADERS = new Set([\n  \"authorization\",\n  \"cookie\",\n  \"x-actor-id\",\n  \"x-actor-type\",\n  \"x-consent-granted-by\",\n  \"x-consent-scope\",\n  \"x-consent-granted-at\",\n  \"x-consent-expires-at\",\n]);\n\nexport function validateGatewayUrl(value: string): string {\n  let url: URL;\n\n  try {\n    url = new URL(value);\n  } catch {\n    throw new Error(\"Gateway URL must be a valid absolute URL\");\n  }\n\n  if (url.protocol === \"https:\") {\n    return url.toString();\n  }\n\n  if (\n    url.protocol === \"http:\" &&\n    LOOPBACK_HOSTS.has(url.hostname.toLowerCase())\n  ) {\n    return url.toString();\n  }\n\n  throw new Error(\"Gateway URL must use HTTPS unless it targets localhost\");\n}\n\nexport function sanitizeHeaders(\n  headers?: Record<string, string>,\n): Record<string, string> | undefined {\n  if (!headers) return undefined;\n\n  return Object.fromEntries(\n    Object.entries(headers).filter(\n      ([key]) => !RESERVED_HEADERS.has(key.toLowerCase()),\n    ),\n  );\n}\n","/**\n * Lightweight GraphQL client for the Burdenoff Web SDK.\n * Uses native fetch - zero external dependencies.\n * All calls are unauthenticated (public gateway operations only).\n */\n\nimport { sanitizeHeaders, validateGatewayUrl } from \"./security\";\n\nexport interface WebSDKClientConfig {\n  /** Global public gateway URL (e.g. \"https://api.burdenoff.com/global/graphql\") */\n  gatewayUrl: string;\n  /** Platform product ID for scoping operations */\n  productId: string;\n  /** Product slug (used for public product queries) */\n  productSlug?: string;\n  /** reCAPTCHA site key (if not fetched from product config) */\n  recaptchaSiteKey?: string;\n  /** Rybbit analytics site ID */\n  rybbitSiteId?: string;\n  /** Custom headers to include in all requests */\n  headers?: Record<string, string>;\n}\n\nexport interface GraphQLResponse<T = Record<string, unknown>> {\n  data?: T;\n  errors?: Array<{\n    message: string;\n    locations?: Array<{ line: number; column: number }>;\n    path?: Array<string | number>;\n    extensions?: Record<string, unknown>;\n  }>;\n}\n\nexport class WebSDKClient {\n  private config: WebSDKClientConfig;\n  private queryCache = new Map<\n    string,\n    { data: GraphQLResponse<unknown>; ts: number }\n  >();\n  private inflight = new Map<string, Promise<GraphQLResponse<unknown>>>();\n  private static CACHE_TTL = 5 * 60 * 1000; // 5 minutes\n  private static MAX_CACHE_ENTRIES = 100;\n\n  constructor(config: WebSDKClientConfig) {\n    this.config = {\n      ...config,\n      gatewayUrl: validateGatewayUrl(config.gatewayUrl),\n      headers: sanitizeHeaders(config.headers),\n    };\n  }\n\n  getConfig(): WebSDKClientConfig {\n    return this.config;\n  }\n\n  /**\n   * Execute a GraphQL query (with deduplication and caching)\n   */\n  async query<T = Record<string, unknown>>(\n    query: string,\n    variables?: Record<string, unknown>,\n  ): Promise<GraphQLResponse<T>> {\n    const cacheKey = JSON.stringify({ query, variables });\n\n    // Return cached response if still valid, evict if expired\n    const cached = this.queryCache.get(cacheKey);\n    if (cached) {\n      if (Date.now() - cached.ts < WebSDKClient.CACHE_TTL) {\n        return cached.data as GraphQLResponse<T>;\n      }\n      this.queryCache.delete(cacheKey);\n    }\n\n    // Deduplicate: if same query is already in-flight, reuse the promise\n    const existing = this.inflight.get(cacheKey);\n    if (existing) {\n      return existing as Promise<GraphQLResponse<T>>;\n    }\n\n    const promise = this.request<T>(query, variables)\n      .then((result) => {\n        // Cache successful responses only\n        if (result.data && !result.errors?.length) {\n          if (this.queryCache.size >= WebSDKClient.MAX_CACHE_ENTRIES) {\n            const oldestEntry = this.queryCache.keys().next().value;\n            if (oldestEntry) {\n              this.queryCache.delete(oldestEntry);\n            }\n          }\n          this.queryCache.set(cacheKey, { data: result, ts: Date.now() });\n        }\n        return result;\n      })\n      .finally(() => {\n        this.inflight.delete(cacheKey);\n      });\n\n    this.inflight.set(cacheKey, promise);\n    return promise;\n  }\n\n  /**\n   * Execute a GraphQL mutation\n   */\n  async mutate<T = Record<string, unknown>>(\n    mutation: string,\n    variables?: Record<string, unknown>,\n  ): Promise<GraphQLResponse<T>> {\n    return this.request<T>(mutation, variables);\n  }\n\n  private async request<T>(\n    query: string,\n    variables?: Record<string, unknown>,\n  ): Promise<GraphQLResponse<T>> {\n    try {\n      const response = await fetch(this.config.gatewayUrl, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"x-product-id\": this.config.productId,\n          ...this.config.headers,\n        },\n        body: JSON.stringify({ query, variables }),\n      });\n\n      if (!response.ok) {\n        console.error(\n          \"[WebSDK] GraphQL request failed\",\n          response.status,\n          response.statusText,\n        );\n        return {\n          errors: [\n            {\n              message: `HTTP ${response.status}: ${response.statusText}`,\n              extensions: { code: `HTTP_${response.status}` },\n            },\n          ],\n        };\n      }\n\n      return (await response.json()) as GraphQLResponse<T>;\n    } catch (error) {\n      console.error(\n        \"[WebSDK] Network error\",\n        error instanceof Error ? error.message : \"unknown error\",\n      );\n      return {\n        errors: [\n          {\n            message: error instanceof Error ? error.message : \"Network error\",\n            extensions: { code: \"NETWORK_ERROR\" },\n          },\n        ],\n      };\n    }\n  }\n}\n","/**\n * React context provider for the Web SDK client.\n * Wraps the application with WebSDKClient configuration.\n */\n\"use client\";\n\nimport { createContext, useContext, useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { resolveGatewayUrl } from \"./gateway-resolver\";\nimport { WebSDKClient, type WebSDKClientConfig } from \"./graphql-client\";\n\nconst WebSDKContext = createContext<WebSDKClient | null>(null);\n\nexport interface WebSDKProviderProps {\n  /** SDK client configuration */\n  config: WebSDKClientConfig;\n  /** Child components */\n  children: ReactNode;\n}\n\n/**\n * Provider component that makes the WebSDKClient available to all child components.\n *\n * @example\n * ```tsx\n * <WebSDKProvider config={{\n *   gatewayUrl: \"https://api.burdenoff.com/global/graphql\",\n *   productId: \"your-product-id\",\n *   productSlug: \"your-product\",\n * }}>\n *   <App />\n * </WebSDKProvider>\n * ```\n */\nexport function WebSDKProvider({ config, children }: WebSDKProviderProps) {\n  const client = useMemo(() => {\n    const resolvedConfig = {\n      ...config,\n      gatewayUrl: resolveGatewayUrl(config.gatewayUrl),\n    };\n    return new WebSDKClient(resolvedConfig);\n  }, [config]);\n\n  return (\n    <WebSDKContext.Provider value={client}>{children}</WebSDKContext.Provider>\n  );\n}\n\n/**\n * Hook to access the WebSDKClient instance.\n * Must be used within a WebSDKProvider.\n */\nexport function useWebSDK(): WebSDKClient {\n  const client = useContext(WebSDKContext);\n  if (!client) {\n    throw new Error(\"useWebSDK must be used within a WebSDKProvider\");\n  }\n  return client;\n}\n\n/**\n * Hook to access the SDK configuration.\n * Useful for components that need config values like productId, recaptchaSiteKey, etc.\n */\nexport function useWebSDKConfig(): WebSDKClientConfig {\n  const client = useWebSDK();\n  return client.getConfig();\n}\n","/**\n * Product Provider\n *\n * React context and hooks for accessing product metadata from the global tenant service.\n * Fetches product info (name, logo, SEO, contact, reCAPTCHA key, etc.) on mount\n * and provides it to all child components.\n */\n\"use client\";\n\nimport {\n  createContext,\n  useContext,\n  useState,\n  useLayoutEffect,\n  useCallback,\n  useMemo,\n} from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { useWebSDK, useWebSDKConfig } from \"../client/provider\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ProductData {\n  id: string;\n  name: string;\n  slug: string;\n  description?: string | null;\n  status: string;\n  logoUrl?: string | null;\n  website?: string | null;\n  appUrl?: string | null;\n  docsUrl?: string | null;\n  contactEmail?: string | null;\n  supportEmail?: string | null;\n  contactPhone?: string | null;\n  contactAddress?: string | null;\n  seoTitle?: string | null;\n  seoDescription?: string | null;\n  seoKeywords?: string | null;\n  ogImage?: string | null;\n  socialLinks?: Record<string, string> | null;\n  /**\n   * Resource links for the website footer \"Resources\" column\n   * (JSON: { docs, community, careers, team, companies, ... }).\n   * Same shape as socialLinks. Free-form keys; the ResourceLinks\n   * component renders known keys and silently ignores the rest.\n   * Backed by Product.resourceLinks on the backend (global-tenant-svc).\n   */\n  resourceLinks?: Record<string, string> | null;\n  recaptchaSiteKey?: string | null;\n  rybbitSiteId?: string | null;\n  notificationEmail?: string | null;\n  metadata?: Record<string, unknown> | null;\n}\n\nexport interface ProductProviderProps {\n  /** Child components */\n  children: ReactNode;\n  /** Optional fallback product data (used while loading) */\n  fallback?: Partial<ProductData>;\n}\n\n// ============================================================================\n// GraphQL Query\n// ============================================================================\n\n/**\n * Body of fields requested for every product fetch — shared by the primary\n * query and the legacy-backend fallback below. Kept as a string fragment\n * (not a real GraphQL `fragment` block) so we can append/strip\n * `resourceLinks` without touching anything else.\n */\nconst PRODUCT_FIELDS_BASE = `\n      id\n      name\n      slug\n      description\n      status\n      logoUrl\n      website\n      appUrl\n      docsUrl\n      contactEmail\n      supportEmail\n      contactPhone\n      contactAddress\n      seoTitle\n      seoDescription\n      seoKeywords\n      ogImage\n      socialLinks\n      recaptchaSiteKey\n      rybbitSiteId\n      notificationEmail\n      metadata\n`;\n\n/**\n * Primary query — includes the recently-added `resourceLinks` field.\n * Backends that have run the corresponding `global-tenant-svc` migration\n * (PR #64) expose this field; older ones don't, in which case\n * GraphQL validation rejects the whole query with\n * `Cannot query field \"resourceLinks\" on type \"PublicProduct\"`. The fetch\n * helper detects that specific error and transparently retries the\n * fallback below, so the SDK works on both pre- and post-migration\n * deployments without consumer-side gating.\n */\nconst PUBLIC_PRODUCT_QUERY = `\n  query PublicProduct($slug: String!) {\n    publicProduct(slug: $slug) {\n      ${PRODUCT_FIELDS_BASE}\n      resourceLinks\n    }\n  }\n`;\n\n/**\n * Fallback query for older backend deployments. Identical to the primary\n * minus `resourceLinks`. Consumers see `product.resourceLinks === undefined`\n * and any consumer (e.g. `<ResourceLinks/>`) falls through to prop / default\n * resolution paths.\n */\nconst PUBLIC_PRODUCT_QUERY_FALLBACK = `\n  query PublicProductFallback($slug: String!) {\n    publicProduct(slug: $slug) {\n      ${PRODUCT_FIELDS_BASE}\n    }\n  }\n`;\n\n// ============================================================================\n// Context\n// ============================================================================\n\ninterface ProductContextValue {\n  product: ProductData | null;\n  loading: boolean;\n  error: string | null;\n  hasProvider: boolean;\n  refetch: () => void;\n}\n\nconst ProductContext = createContext<ProductContextValue>({\n  product: null,\n  loading: true,\n  error: null,\n  hasProvider: false,\n  refetch: () => {},\n});\n\n// ============================================================================\n// Provider\n// ============================================================================\n\n/**\n * ProductProvider fetches and provides product metadata to child components.\n * Uses the product slug from WebSDKConfig to fetch from the public API.\n *\n * @example\n * ```tsx\n * <WebSDKProvider config={sdkConfig}>\n *   <ProductProvider>\n *     <App />\n *   </ProductProvider>\n * </WebSDKProvider>\n * ```\n */\nexport function ProductProvider({ children, fallback }: ProductProviderProps) {\n  const client = useWebSDK();\n  const config = useWebSDKConfig();\n  const [product, setProduct] = useState<ProductData | null>(\n    fallback ? (fallback as ProductData) : null,\n  );\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n  const fetchProduct = useCallback(async () => {\n    if (!config.productSlug) {\n      setLoading(false);\n      return;\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      let result = await client.query<{ publicProduct: ProductData | null }>(\n        PUBLIC_PRODUCT_QUERY,\n        { slug: config.productSlug },\n      );\n\n      // Backwards-compat fallback: if the backend's `publicProduct` schema\n      // doesn't yet expose `resourceLinks` (deployed before\n      // `global-tenant-svc` PR #64), the primary query fails validation\n      // with a \"Cannot query field …\" error and `result.data` is null.\n      // Retry the fallback query that omits `resourceLinks`; consumers\n      // gracefully see `product.resourceLinks === undefined` and fall\n      // through their own resolution paths.\n      const schemaMissingResourceLinks = result.errors?.some((e) =>\n        /Cannot query field [\"']?resourceLinks[\"']?/i.test(e?.message ?? \"\"),\n      );\n      if (schemaMissingResourceLinks) {\n        result = await client.query<{ publicProduct: ProductData | null }>(\n          PUBLIC_PRODUCT_QUERY_FALLBACK,\n          { slug: config.productSlug },\n        );\n      }\n\n      if (result.errors?.length) {\n        setError(result.errors[0]?.message ?? \"Unknown error\");\n      } else if (result.data?.publicProduct) {\n        setProduct(result.data.publicProduct);\n      }\n    } catch (err) {\n      setError(err instanceof Error ? err.message : \"Failed to fetch product\");\n    } finally {\n      setLoading(false);\n    }\n  }, [client, config.productSlug]);\n\n  // Use useLayoutEffect for earliest possible fetch after commit (before paint).\n  // Runs when slug or client changes. Client-side query cache + dedup ensures\n  // no duplicate network requests even if React StrictMode fires this twice.\n  useLayoutEffect(() => {\n    fetchProduct();\n  }, [fetchProduct]);\n\n  const value = useMemo(\n    () => ({\n      product,\n      loading,\n      error,\n      hasProvider: true,\n      refetch: fetchProduct,\n    }),\n    [product, loading, error, fetchProduct],\n  );\n\n  return (\n    <ProductContext.Provider value={value}>{children}</ProductContext.Provider>\n  );\n}\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\n/**\n * Hook to access the current product data.\n *\n * @example\n * ```tsx\n * const { product, loading } = useProduct();\n * if (loading) return <Loading />;\n * return <h1>{product?.name}</h1>;\n * ```\n */\nexport function useProduct(): ProductContextValue {\n  return useContext(ProductContext);\n}\n\n/**\n * Hook to get product-specific configuration.\n * Merges SDK config with fetched product data.\n * Useful for getting reCAPTCHA keys, analytics IDs, etc.\n *\n * @example\n * ```tsx\n * const { recaptchaSiteKey, rybbitSiteId } = useProductConfig();\n * ```\n */\nexport function useProductConfig(): {\n  recaptchaSiteKey: string | null;\n  rybbitSiteId: string | null;\n  contactEmail: string | null;\n  supportEmail: string | null;\n  notificationEmail: string | null;\n  productName: string | null;\n  logoUrl: string | null;\n} {\n  const { product } = useProduct();\n  const config = useWebSDKConfig();\n\n  return {\n    // Prefer product-level config, fall back to SDK config\n    recaptchaSiteKey:\n      product?.recaptchaSiteKey ?? config.recaptchaSiteKey ?? null,\n    rybbitSiteId: product?.rybbitSiteId ?? config.rybbitSiteId ?? null,\n    contactEmail: product?.contactEmail ?? null,\n    supportEmail: product?.supportEmail ?? null,\n    notificationEmail:\n      product?.notificationEmail ?? product?.contactEmail ?? null,\n    productName: product?.name ?? null,\n    logoUrl: product?.logoUrl ?? null,\n  };\n}\n"]}

package/dist/provider-D7Rij9UM.d.mts

@@ -0,0 +1,86 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Lightweight GraphQL client for the Burdenoff Web SDK.
+ * Uses native fetch - zero external dependencies.
+ * All calls are unauthenticated (public gateway operations only).
+ */
+interface WebSDKClientConfig {
+    /** Global public gateway URL (e.g. "https://api.burdenoff.com/global/graphql") */
+    gatewayUrl: string;
+    /** Platform product ID for scoping operations */
+    productId: string;
+    /** Product slug (used for public product queries) */
+    productSlug?: string;
+    /** reCAPTCHA site key (if not fetched from product config) */
+    recaptchaSiteKey?: string;
+    /** Rybbit analytics site ID */
+    rybbitSiteId?: string;
+    /** Custom headers to include in all requests */
+    headers?: Record<string, string>;
+}
+interface GraphQLResponse<T = Record<string, unknown>> {
+    data?: T;
+    errors?: Array<{
+        message: string;
+        locations?: Array<{
+            line: number;
+            column: number;
+        }>;
+        path?: Array<string | number>;
+        extensions?: Record<string, unknown>;
+    }>;
+}
+declare class WebSDKClient {
+    private config;
+    private queryCache;
+    private inflight;
+    private static CACHE_TTL;
+    private static MAX_CACHE_ENTRIES;
+    constructor(config: WebSDKClientConfig);
+    getConfig(): WebSDKClientConfig;
+    /**
+     * Execute a GraphQL query (with deduplication and caching)
+     */
+    query<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    /**
+     * Execute a GraphQL mutation
+     */
+    mutate<T = Record<string, unknown>>(mutation: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    private request;
+}
+
+interface WebSDKProviderProps {
+    /** SDK client configuration */
+    config: WebSDKClientConfig;
+    /** Child components */
+    children: ReactNode;
+}
+/**
+ * Provider component that makes the WebSDKClient available to all child components.
+ *
+ * @example
+ * ```tsx
+ * <WebSDKProvider config={{
+ *   gatewayUrl: "https://api.burdenoff.com/global/graphql",
+ *   productId: "your-product-id",
+ *   productSlug: "your-product",
+ * }}>
+ *   <App />
+ * </WebSDKProvider>
+ * ```
+ */
+declare function WebSDKProvider({ config, children }: WebSDKProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the WebSDKClient instance.
+ * Must be used within a WebSDKProvider.
+ */
+declare function useWebSDK(): WebSDKClient;
+/**
+ * Hook to access the SDK configuration.
+ * Useful for components that need config values like productId, recaptchaSiteKey, etc.
+ */
+declare function useWebSDKConfig(): WebSDKClientConfig;
+
+export { WebSDKClient as W, type WebSDKClientConfig as a, WebSDKProvider as b, type WebSDKProviderProps as c, useWebSDKConfig as d, useWebSDK as u };

package/dist/provider-D7Rij9UM.d.ts

@@ -0,0 +1,86 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Lightweight GraphQL client for the Burdenoff Web SDK.
+ * Uses native fetch - zero external dependencies.
+ * All calls are unauthenticated (public gateway operations only).
+ */
+interface WebSDKClientConfig {
+    /** Global public gateway URL (e.g. "https://api.burdenoff.com/global/graphql") */
+    gatewayUrl: string;
+    /** Platform product ID for scoping operations */
+    productId: string;
+    /** Product slug (used for public product queries) */
+    productSlug?: string;
+    /** reCAPTCHA site key (if not fetched from product config) */
+    recaptchaSiteKey?: string;
+    /** Rybbit analytics site ID */
+    rybbitSiteId?: string;
+    /** Custom headers to include in all requests */
+    headers?: Record<string, string>;
+}
+interface GraphQLResponse<T = Record<string, unknown>> {
+    data?: T;
+    errors?: Array<{
+        message: string;
+        locations?: Array<{
+            line: number;
+            column: number;
+        }>;
+        path?: Array<string | number>;
+        extensions?: Record<string, unknown>;
+    }>;
+}
+declare class WebSDKClient {
+    private config;
+    private queryCache;
+    private inflight;
+    private static CACHE_TTL;
+    private static MAX_CACHE_ENTRIES;
+    constructor(config: WebSDKClientConfig);
+    getConfig(): WebSDKClientConfig;
+    /**
+     * Execute a GraphQL query (with deduplication and caching)
+     */
+    query<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    /**
+     * Execute a GraphQL mutation
+     */
+    mutate<T = Record<string, unknown>>(mutation: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    private request;
+}
+
+interface WebSDKProviderProps {
+    /** SDK client configuration */
+    config: WebSDKClientConfig;
+    /** Child components */
+    children: ReactNode;
+}
+/**
+ * Provider component that makes the WebSDKClient available to all child components.
+ *
+ * @example
+ * ```tsx
+ * <WebSDKProvider config={{
+ *   gatewayUrl: "https://api.burdenoff.com/global/graphql",
+ *   productId: "your-product-id",
+ *   productSlug: "your-product",
+ * }}>
+ *   <App />
+ * </WebSDKProvider>
+ * ```
+ */
+declare function WebSDKProvider({ config, children }: WebSDKProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the WebSDKClient instance.
+ * Must be used within a WebSDKProvider.
+ */
+declare function useWebSDK(): WebSDKClient;
+/**
+ * Hook to access the SDK configuration.
+ * Useful for components that need config values like productId, recaptchaSiteKey, etc.
+ */
+declare function useWebSDKConfig(): WebSDKClientConfig;
+
+export { WebSDKClient as W, type WebSDKClientConfig as a, WebSDKProvider as b, type WebSDKProviderProps as c, useWebSDKConfig as d, useWebSDK as u };

package/dist/seo/index.d.mts

@@ -0,0 +1,64 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * PageHead Component
+ * Manages dynamic meta tags for SEO optimization on a per-page basis.
+ * Supports JSON-LD structured data, Open Graph, Twitter Cards, favicons, and robots directives.
+ *
+ * @example
+ * ```tsx
+ * <PageHead
+ *   title="About Us"
+ *   description="Learn about our mission and team"
+ *   productName="MyProduct"
+ *   keywords="about, team, mission"
+ *   image="/og-about.png"
+ *   url="https://myproduct.com/about"
+ *   favicon="/favicon.ico"
+ *   robots="index, follow"
+ *   locale="en_US"
+ *   twitterHandle="@burdenoff"
+ *   themeColor="#1a1a2e"
+ *   structuredData={{
+ *     "@context": "https://schema.org",
+ *     "@type": "WebPage",
+ *     name: "About Us",
+ *   }}
+ * />
+ * ```
+ */
+interface PageHeadProps {
+    /** Page title */
+    title: string;
+    /** Meta description */
+    description?: string;
+    /** Product/brand name (appended to title) */
+    productName?: string;
+    /** SEO keywords */
+    keywords?: string;
+    /** Open Graph image URL */
+    image?: string;
+    /** Page canonical URL */
+    url?: string;
+    /** Favicon URL */
+    favicon?: string;
+    /** Robots directive (e.g., "index, follow") */
+    robots?: string;
+    /** Open Graph locale (e.g., "en_US") */
+    locale?: string;
+    /** Twitter handle (e.g., "@burdenoff") */
+    twitterHandle?: string;
+    /** Theme color for mobile browsers */
+    themeColor?: string;
+    /** JSON-LD structured data objects */
+    structuredData?: Record<string, unknown> | Array<Record<string, unknown>>;
+    /** Additional meta tags */
+    additionalMeta?: Array<{
+        name?: string;
+        property?: string;
+        content: string;
+    }>;
+}
+declare function PageHead({ title, description, productName, keywords, image, url, favicon, robots, locale, twitterHandle, themeColor, structuredData, additionalMeta, }: PageHeadProps): react_jsx_runtime.JSX.Element;
+
+export { PageHead, type PageHeadProps };

package/dist/seo/index.d.ts

@@ -0,0 +1,64 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * PageHead Component
+ * Manages dynamic meta tags for SEO optimization on a per-page basis.
+ * Supports JSON-LD structured data, Open Graph, Twitter Cards, favicons, and robots directives.
+ *
+ * @example
+ * ```tsx
+ * <PageHead
+ *   title="About Us"
+ *   description="Learn about our mission and team"
+ *   productName="MyProduct"
+ *   keywords="about, team, mission"
+ *   image="/og-about.png"
+ *   url="https://myproduct.com/about"
+ *   favicon="/favicon.ico"
+ *   robots="index, follow"
+ *   locale="en_US"
+ *   twitterHandle="@burdenoff"
+ *   themeColor="#1a1a2e"
+ *   structuredData={{
+ *     "@context": "https://schema.org",
+ *     "@type": "WebPage",
+ *     name: "About Us",
+ *   }}
+ * />
+ * ```
+ */
+interface PageHeadProps {
+    /** Page title */
+    title: string;
+    /** Meta description */
+    description?: string;
+    /** Product/brand name (appended to title) */
+    productName?: string;
+    /** SEO keywords */
+    keywords?: string;
+    /** Open Graph image URL */
+    image?: string;
+    /** Page canonical URL */
+    url?: string;
+    /** Favicon URL */
+    favicon?: string;
+    /** Robots directive (e.g., "index, follow") */
+    robots?: string;
+    /** Open Graph locale (e.g., "en_US") */
+    locale?: string;
+    /** Twitter handle (e.g., "@burdenoff") */
+    twitterHandle?: string;
+    /** Theme color for mobile browsers */
+    themeColor?: string;
+    /** JSON-LD structured data objects */
+    structuredData?: Record<string, unknown> | Array<Record<string, unknown>>;
+    /** Additional meta tags */
+    additionalMeta?: Array<{
+        name?: string;
+        property?: string;
+        content: string;
+    }>;
+}
+declare function PageHead({ title, description, productName, keywords, image, url, favicon, robots, locale, twitterHandle, themeColor, structuredData, additionalMeta, }: PageHeadProps): react_jsx_runtime.JSX.Element;
+
+export { PageHead, type PageHeadProps };