@spur.us/monocle-react 0.1.0 → 1.1.0-canary.v20250520214223

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @spur.us/monocle-react@0.1.0 build /home/runner/work/javascript/javascript/packages/monocle-react
+> @spur.us/monocle-react@1.1.0-canary.v20250520214223 build /home/runner/work/javascript/javascript/packages/monocle-react
 > tsup
 
 CLI Building entry: {"index":"src/index.ts"}
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/index.mjs     3.26 KB
-ESM dist/index.mjs.map 7.39 KB
-ESM ⚡️ Build success in 27ms
-CJS dist/index.js     5.06 KB
-CJS dist/index.js.map 7.53 KB
-CJS ⚡️ Build success in 27ms
+ESM dist/index.mjs     3.35 KB
+ESM dist/index.mjs.map 7.54 KB
+ESM ⚡️ Build success in 43ms
+CJS dist/index.js     5.15 KB
+CJS dist/index.js.map 7.72 KB
+CJS ⚡️ Build success in 44ms
 DTS Build start
-DTS ⚡️ Build success in 2092ms
-DTS dist/index.d.ts  428.00 B
-DTS dist/index.d.mts 428.00 B
+DTS ⚡️ Build success in 2322ms
+DTS dist/index.d.ts  806.00 B
+DTS dist/index.d.mts 806.00 B

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @spur.us/monocle-react
 
+## 1.0.0
+
+### Major Changes
+
+- a2b3919: - Rename `bundle` to `assessment` in `useMonocle` hook
+
+### Patch Changes
+
+- d377c8a: Remove 'use client' directive.
+- Updated dependencies [a2b3919]
+- Updated dependencies [d7071af]
+  - @spur.us/types@0.2.0
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <a href="https://nextjs.org">
+  <a href="https://spur.us">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="../../docs/images/logo-dark-mode.svg">
       <img alt="Spur logo" src="../../docs/images/logo-light-mode.svg" height="128">
@@ -15,11 +15,11 @@ A React library for integrating Monocle into your React applications. This packa
 ## Installation
 
 ```bash
-npm install @spur/monocle-react
+npm install @spur.us/monocle-react
 # or
-yarn add @spur/monocle-react
+yarn add @spur.us/monocle-react
 # or
-pnpm add @spur/monocle-react
+pnpm add @spur.us/monocle-react
 ```
 
 ## Contributing

package/dist/index.d.mts

@@ -1,16 +1,25 @@
-import React from 'react';
+import React$1 from 'react';
+
+/**
+ * Props for the MonocleProvider component.
+ * @interface MonocleProviderProps
+ */
+interface MonocleProviderProps {
+    /** The child components to be wrapped by the MonocleProvider. */
+    children: React.ReactNode;
+    /** The publishable key used for authentication with Monocle. */
+    publishableKey: string;
+    /** Optional base domain for the Monocle API. Defaults to `mcl.spur.us` if not provided */
+    domain?: string;
+}
 
 interface MonocleContextType {
-    bundle: string | undefined;
+    assessment: string | undefined;
     refresh: () => void;
     isLoading: boolean;
     error: Error | null;
 }
-interface MonocleProviderProps {
-    children: React.ReactNode;
-    publishableKey: string;
-}
-declare const MonocleProvider: React.ComponentType<MonocleProviderProps>;
+declare const MonocleProvider: React$1.ComponentType<MonocleProviderProps>;
 declare const useMonocle: () => MonocleContextType;
 
-export { MonocleProvider, useMonocle };
+export { MonocleProvider, type MonocleProviderProps, useMonocle };

package/dist/index.d.ts

@@ -1,16 +1,25 @@
-import React from 'react';
+import React$1 from 'react';
+
+/**
+ * Props for the MonocleProvider component.
+ * @interface MonocleProviderProps
+ */
+interface MonocleProviderProps {
+    /** The child components to be wrapped by the MonocleProvider. */
+    children: React.ReactNode;
+    /** The publishable key used for authentication with Monocle. */
+    publishableKey: string;
+    /** Optional base domain for the Monocle API. Defaults to `mcl.spur.us` if not provided */
+    domain?: string;
+}
 
 interface MonocleContextType {
-    bundle: string | undefined;
+    assessment: string | undefined;
     refresh: () => void;
     isLoading: boolean;
     error: Error | null;
 }
-interface MonocleProviderProps {
-    children: React.ReactNode;
-    publishableKey: string;
-}
-declare const MonocleProvider: React.ComponentType<MonocleProviderProps>;
+declare const MonocleProvider: React$1.ComponentType<MonocleProviderProps>;
 declare const useMonocle: () => MonocleContextType;
 
-export { MonocleProvider, useMonocle };
+export { MonocleProvider, type MonocleProviderProps, useMonocle };

package/dist/index.js

@@ -64,14 +64,18 @@ function withMaxAllowedInstancesGuard(WrappedComponent, name, error) {
   return Hoc;
 }
 
+// src/constants.ts
+var DOMAIN = "mcl.spur.us";
+
 // src/contexts/MonocleProvider.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var MonocleContext = (0, import_react2.createContext)(null);
 var MonocleProviderComponent = ({
   children,
-  publishableKey
+  publishableKey,
+  domain = DOMAIN
 }) => {
-  const [bundle, setBundle] = (0, import_react2.useState)(void 0);
+  const [assessment, setAssessment] = (0, import_react2.useState)(void 0);
   const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
   const [error, setError] = (0, import_react2.useState)(null);
   const loadScript = () => {
@@ -89,7 +93,7 @@ var MonocleProviderComponent = ({
       const script = document.createElement("script");
       script.id = "_mcl";
       script.async = true;
-      script.src = `https://mcl.spur.us/d/mcl.js?tk=${publishableKey}`;
+      script.src = `https://${domain}/d/mcl.js?tk=${publishableKey}`;
       script.onload = () => {
         resolve();
       };
@@ -106,8 +110,8 @@ var MonocleProviderComponent = ({
       setError(null);
       await loadScript();
       if (window.MCL) {
-        const newBundle = window.MCL.getBundle();
-        setBundle(newBundle);
+        const newAssessment = window.MCL.getAssessment();
+        setAssessment(newAssessment);
       } else {
         throw new Error("MCL object not found on window");
       }
@@ -120,11 +124,11 @@ var MonocleProviderComponent = ({
     }
   };
   (0, import_react2.useEffect)(() => {
-    if (!bundle) {
+    if (!assessment) {
       refresh();
     }
   }, [publishableKey]);
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MonocleContext.Provider, { value: { bundle, refresh, isLoading, error }, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MonocleContext.Provider, { value: { assessment, refresh, isLoading, error }, children });
 };
 var MonocleProvider = withMaxAllowedInstancesGuard(
   MonocleProviderComponent,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/contexts/MonocleProvider.tsx","../src/utils/useMaxAllowedInstancesGuard.tsx"],"sourcesContent":["export * from './contexts';\n","'use client';\n\nimport React, { createContext, useContext, useEffect, useState } from 'react';\nimport { withMaxAllowedInstancesGuard } from '../utils';\n\ninterface MonocleContextType {\n  bundle: string | undefined;\n  refresh: () => void;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nconst MonocleContext = createContext<MonocleContextType | null>(null);\n\ninterface MonocleProviderProps {\n  children: React.ReactNode;\n  publishableKey: string;\n}\n\nconst MonocleProviderComponent: React.FC<MonocleProviderProps> = ({\n  children,\n  publishableKey,\n}) => {\n  const [bundle, setBundle] = useState<string | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const loadScript = () => {\n    return new Promise<void>((resolve, reject) => {\n      const existingScript = document.getElementById('_mcl');\n      if (existingScript) {\n        // If script exists but hasn't loaded yet, wait for it\n        if (!window.MCL) {\n          existingScript.onload = () => resolve();\n          existingScript.onerror = () =>\n            reject(new Error('Failed to load Monocle script'));\n        } else {\n          resolve();\n        }\n        return;\n      }\n\n      const script = document.createElement('script');\n      script.id = '_mcl';\n      script.async = true;\n      script.src = `https://mcl.spur.us/d/mcl.js?tk=${publishableKey}`;\n      script.onload = () => {\n        resolve();\n      };\n      script.onerror = (_e) => {\n        console.error('MonocleProvider: Script failed to load');\n        reject(new Error('Failed to load Monocle script'));\n      };\n      document.head.appendChild(script);\n    });\n  };\n\n  const refresh = async () => {\n    try {\n      setIsLoading(true);\n      setError(null);\n      await loadScript();\n      if (window.MCL) {\n        const newBundle = window.MCL.getBundle();\n        setBundle(newBundle);\n      } else {\n        throw new Error('MCL object not found on window');\n      }\n    } catch (err) {\n      setError(\n        err instanceof Error ? err : new Error('Unknown error occurred')\n      );\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  useEffect(() => {\n    // Only refresh if the publishableKey changes and we don't already have a bundle\n    if (!bundle) {\n      refresh();\n    }\n  }, [publishableKey]);\n\n  return (\n    <MonocleContext.Provider value={{ bundle, refresh, isLoading, error }}>\n      {children}\n    </MonocleContext.Provider>\n  );\n};\n\nexport const MonocleProvider = withMaxAllowedInstancesGuard(\n  MonocleProviderComponent,\n  'MonocleProvider',\n  'Only one instance of MonocleProvider is allowed'\n);\n\nexport const useMonocle = () => {\n  const context = useContext(MonocleContext);\n  if (!context) {\n    throw new Error('useMonocle must be used within a MonocleProvider');\n  }\n  return context;\n};\n","import React from 'react';\n\nconst instanceCounter = new Map<string, number>();\n\n/**\n * A React hook that ensures a component is not instantiated more than a specified number of times.\n * Throws an error if the maximum number of instances is exceeded.\n *\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @param maxCount - The maximum number of allowed instances (defaults to 1)\n * @throws Error when the maximum number of instances is exceeded\n *\n * @example\n * ```tsx\n * const MyComponent = () => {\n *   useMaxAllowedInstancesGuard('MyComponent', 'Only one instance of MyComponent is allowed');\n *   return <div>My Component</div>;\n * };\n * ```\n */\nexport function useMaxAllowedInstancesGuard(\n  name: string,\n  error: string,\n  maxCount = 1\n): void {\n  React.useEffect(() => {\n    const count = instanceCounter.get(name) || 0;\n    if (count === maxCount) {\n      throw new Error(error);\n    }\n    instanceCounter.set(name, count + 1);\n\n    return () => {\n      instanceCounter.set(name, (instanceCounter.get(name) || 1) - 1);\n    };\n  }, []);\n}\n\n/**\n * A higher-order component that wraps a component with instance count protection.\n * This HOC ensures that the wrapped component cannot be instantiated more than once\n * (or a specified number of times) in the application.\n *\n * @param WrappedComponent - The component to wrap with instance count protection\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @returns A new component with instance count protection\n *\n * @example\n * ```tsx\n * const ProtectedComponent = withMaxAllowedInstancesGuard(\n *   MyComponent,\n *   'MyComponent',\n *   'Only one instance of MyComponent is allowed'\n * );\n * ```\n */\nexport function withMaxAllowedInstancesGuard<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  name: string,\n  error: string\n): React.ComponentType<P> {\n  const displayName =\n    WrappedComponent.displayName ||\n    WrappedComponent.name ||\n    name ||\n    'Component';\n\n  const Hoc: React.FC<P> = (props) => {\n    useMaxAllowedInstancesGuard(name, error);\n    return <WrappedComponent {...props} />;\n  };\n\n  Hoc.displayName = `withMaxAllowedInstancesGuard(${displayName})`;\n  return Hoc;\n}\n"],"mappings":"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","names":["import_react","React","import_jsx_runtime"]}
+{"version":3,"sources":["../src/index.ts","../src/contexts/MonocleProvider.tsx","../src/utils/useMaxAllowedInstancesGuard.tsx","../src/constants.ts"],"sourcesContent":["export * from './contexts';\n\nexport type { MonocleProviderProps } from './types';\n","import React, { createContext, useContext, useEffect, useState } from 'react';\nimport { withMaxAllowedInstancesGuard } from '../utils';\nimport { MonocleProviderProps } from '../types';\nimport { DOMAIN } from '../constants';\ninterface MonocleContextType {\n  assessment: string | undefined;\n  refresh: () => void;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nconst MonocleContext = createContext<MonocleContextType | null>(null);\n\nconst MonocleProviderComponent: React.FC<MonocleProviderProps> = ({\n  children,\n  publishableKey,\n  domain = DOMAIN,\n}) => {\n  const [assessment, setAssessment] = useState<string | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const loadScript = () => {\n    return new Promise<void>((resolve, reject) => {\n      const existingScript = document.getElementById('_mcl');\n      if (existingScript) {\n        // If script exists but hasn't loaded yet, wait for it\n        if (!window.MCL) {\n          existingScript.onload = () => resolve();\n          existingScript.onerror = () =>\n            reject(new Error('Failed to load Monocle script'));\n        } else {\n          resolve();\n        }\n        return;\n      }\n\n      const script = document.createElement('script');\n      script.id = '_mcl';\n      script.async = true;\n      script.src = `https://${domain}/d/mcl.js?tk=${publishableKey}`;\n      script.onload = () => {\n        resolve();\n      };\n      script.onerror = (_e) => {\n        console.error('MonocleProvider: Script failed to load');\n        reject(new Error('Failed to load Monocle script'));\n      };\n      document.head.appendChild(script);\n    });\n  };\n\n  const refresh = async () => {\n    try {\n      setIsLoading(true);\n      setError(null);\n      await loadScript();\n      if (window.MCL) {\n        const newAssessment = window.MCL.getAssessment();\n        setAssessment(newAssessment);\n      } else {\n        throw new Error('MCL object not found on window');\n      }\n    } catch (err) {\n      setError(\n        err instanceof Error ? err : new Error('Unknown error occurred')\n      );\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  useEffect(() => {\n    // Only refresh if the publishableKey changes and we don't already have an assessment\n    if (!assessment) {\n      refresh();\n    }\n  }, [publishableKey]);\n\n  return (\n    <MonocleContext.Provider value={{ assessment, refresh, isLoading, error }}>\n      {children}\n    </MonocleContext.Provider>\n  );\n};\n\nexport const MonocleProvider = withMaxAllowedInstancesGuard(\n  MonocleProviderComponent,\n  'MonocleProvider',\n  'Only one instance of MonocleProvider is allowed'\n);\n\nexport const useMonocle = () => {\n  const context = useContext(MonocleContext);\n  if (!context) {\n    throw new Error('useMonocle must be used within a MonocleProvider');\n  }\n  return context;\n};\n","import React from 'react';\n\nconst instanceCounter = new Map<string, number>();\n\n/**\n * A React hook that ensures a component is not instantiated more than a specified number of times.\n * Throws an error if the maximum number of instances is exceeded.\n *\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @param maxCount - The maximum number of allowed instances (defaults to 1)\n * @throws Error when the maximum number of instances is exceeded\n *\n * @example\n * ```tsx\n * const MyComponent = () => {\n *   useMaxAllowedInstancesGuard('MyComponent', 'Only one instance of MyComponent is allowed');\n *   return <div>My Component</div>;\n * };\n * ```\n */\nexport function useMaxAllowedInstancesGuard(\n  name: string,\n  error: string,\n  maxCount = 1\n): void {\n  React.useEffect(() => {\n    const count = instanceCounter.get(name) || 0;\n    if (count === maxCount) {\n      throw new Error(error);\n    }\n    instanceCounter.set(name, count + 1);\n\n    return () => {\n      instanceCounter.set(name, (instanceCounter.get(name) || 1) - 1);\n    };\n  }, []);\n}\n\n/**\n * A higher-order component that wraps a component with instance count protection.\n * This HOC ensures that the wrapped component cannot be instantiated more than once\n * (or a specified number of times) in the application.\n *\n * @param WrappedComponent - The component to wrap with instance count protection\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @returns A new component with instance count protection\n *\n * @example\n * ```tsx\n * const ProtectedComponent = withMaxAllowedInstancesGuard(\n *   MyComponent,\n *   'MyComponent',\n *   'Only one instance of MyComponent is allowed'\n * );\n * ```\n */\nexport function withMaxAllowedInstancesGuard<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  name: string,\n  error: string\n): React.ComponentType<P> {\n  const displayName =\n    WrappedComponent.displayName ||\n    WrappedComponent.name ||\n    name ||\n    'Component';\n\n  const Hoc: React.FC<P> = (props) => {\n    useMaxAllowedInstancesGuard(name, error);\n    return <WrappedComponent {...props} />;\n  };\n\n  Hoc.displayName = `withMaxAllowedInstancesGuard(${displayName})`;\n  return Hoc;\n}\n","export const DOMAIN = 'mcl.spur.us';\n"],"mappings":"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","names":["import_react","React","import_jsx_runtime"]}

package/dist/index.mjs

@@ -27,14 +27,18 @@ function withMaxAllowedInstancesGuard(WrappedComponent, name, error) {
   return Hoc;
 }
 
+// src/constants.ts
+var DOMAIN = "mcl.spur.us";
+
 // src/contexts/MonocleProvider.tsx
 import { jsx as jsx2 } from "react/jsx-runtime";
 var MonocleContext = createContext(null);
 var MonocleProviderComponent = ({
   children,
-  publishableKey
+  publishableKey,
+  domain = DOMAIN
 }) => {
-  const [bundle, setBundle] = useState(void 0);
+  const [assessment, setAssessment] = useState(void 0);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
   const loadScript = () => {
@@ -52,7 +56,7 @@ var MonocleProviderComponent = ({
       const script = document.createElement("script");
       script.id = "_mcl";
       script.async = true;
-      script.src = `https://mcl.spur.us/d/mcl.js?tk=${publishableKey}`;
+      script.src = `https://${domain}/d/mcl.js?tk=${publishableKey}`;
       script.onload = () => {
         resolve();
       };
@@ -69,8 +73,8 @@ var MonocleProviderComponent = ({
       setError(null);
       await loadScript();
       if (window.MCL) {
-        const newBundle = window.MCL.getBundle();
-        setBundle(newBundle);
+        const newAssessment = window.MCL.getAssessment();
+        setAssessment(newAssessment);
       } else {
         throw new Error("MCL object not found on window");
       }
@@ -83,11 +87,11 @@ var MonocleProviderComponent = ({
     }
   };
   useEffect(() => {
-    if (!bundle) {
+    if (!assessment) {
       refresh();
     }
   }, [publishableKey]);
-  return /* @__PURE__ */ jsx2(MonocleContext.Provider, { value: { bundle, refresh, isLoading, error }, children });
+  return /* @__PURE__ */ jsx2(MonocleContext.Provider, { value: { assessment, refresh, isLoading, error }, children });
 };
 var MonocleProvider = withMaxAllowedInstancesGuard(
   MonocleProviderComponent,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contexts/MonocleProvider.tsx","../src/utils/useMaxAllowedInstancesGuard.tsx"],"sourcesContent":["'use client';\n\nimport React, { createContext, useContext, useEffect, useState } from 'react';\nimport { withMaxAllowedInstancesGuard } from '../utils';\n\ninterface MonocleContextType {\n  bundle: string | undefined;\n  refresh: () => void;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nconst MonocleContext = createContext<MonocleContextType | null>(null);\n\ninterface MonocleProviderProps {\n  children: React.ReactNode;\n  publishableKey: string;\n}\n\nconst MonocleProviderComponent: React.FC<MonocleProviderProps> = ({\n  children,\n  publishableKey,\n}) => {\n  const [bundle, setBundle] = useState<string | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const loadScript = () => {\n    return new Promise<void>((resolve, reject) => {\n      const existingScript = document.getElementById('_mcl');\n      if (existingScript) {\n        // If script exists but hasn't loaded yet, wait for it\n        if (!window.MCL) {\n          existingScript.onload = () => resolve();\n          existingScript.onerror = () =>\n            reject(new Error('Failed to load Monocle script'));\n        } else {\n          resolve();\n        }\n        return;\n      }\n\n      const script = document.createElement('script');\n      script.id = '_mcl';\n      script.async = true;\n      script.src = `https://mcl.spur.us/d/mcl.js?tk=${publishableKey}`;\n      script.onload = () => {\n        resolve();\n      };\n      script.onerror = (_e) => {\n        console.error('MonocleProvider: Script failed to load');\n        reject(new Error('Failed to load Monocle script'));\n      };\n      document.head.appendChild(script);\n    });\n  };\n\n  const refresh = async () => {\n    try {\n      setIsLoading(true);\n      setError(null);\n      await loadScript();\n      if (window.MCL) {\n        const newBundle = window.MCL.getBundle();\n        setBundle(newBundle);\n      } else {\n        throw new Error('MCL object not found on window');\n      }\n    } catch (err) {\n      setError(\n        err instanceof Error ? err : new Error('Unknown error occurred')\n      );\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  useEffect(() => {\n    // Only refresh if the publishableKey changes and we don't already have a bundle\n    if (!bundle) {\n      refresh();\n    }\n  }, [publishableKey]);\n\n  return (\n    <MonocleContext.Provider value={{ bundle, refresh, isLoading, error }}>\n      {children}\n    </MonocleContext.Provider>\n  );\n};\n\nexport const MonocleProvider = withMaxAllowedInstancesGuard(\n  MonocleProviderComponent,\n  'MonocleProvider',\n  'Only one instance of MonocleProvider is allowed'\n);\n\nexport const useMonocle = () => {\n  const context = useContext(MonocleContext);\n  if (!context) {\n    throw new Error('useMonocle must be used within a MonocleProvider');\n  }\n  return context;\n};\n","import React from 'react';\n\nconst instanceCounter = new Map<string, number>();\n\n/**\n * A React hook that ensures a component is not instantiated more than a specified number of times.\n * Throws an error if the maximum number of instances is exceeded.\n *\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @param maxCount - The maximum number of allowed instances (defaults to 1)\n * @throws Error when the maximum number of instances is exceeded\n *\n * @example\n * ```tsx\n * const MyComponent = () => {\n *   useMaxAllowedInstancesGuard('MyComponent', 'Only one instance of MyComponent is allowed');\n *   return <div>My Component</div>;\n * };\n * ```\n */\nexport function useMaxAllowedInstancesGuard(\n  name: string,\n  error: string,\n  maxCount = 1\n): void {\n  React.useEffect(() => {\n    const count = instanceCounter.get(name) || 0;\n    if (count === maxCount) {\n      throw new Error(error);\n    }\n    instanceCounter.set(name, count + 1);\n\n    return () => {\n      instanceCounter.set(name, (instanceCounter.get(name) || 1) - 1);\n    };\n  }, []);\n}\n\n/**\n * A higher-order component that wraps a component with instance count protection.\n * This HOC ensures that the wrapped component cannot be instantiated more than once\n * (or a specified number of times) in the application.\n *\n * @param WrappedComponent - The component to wrap with instance count protection\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @returns A new component with instance count protection\n *\n * @example\n * ```tsx\n * const ProtectedComponent = withMaxAllowedInstancesGuard(\n *   MyComponent,\n *   'MyComponent',\n *   'Only one instance of MyComponent is allowed'\n * );\n * ```\n */\nexport function withMaxAllowedInstancesGuard<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  name: string,\n  error: string\n): React.ComponentType<P> {\n  const displayName =\n    WrappedComponent.displayName ||\n    WrappedComponent.name ||\n    name ||\n    'Component';\n\n  const Hoc: React.FC<P> = (props) => {\n    useMaxAllowedInstancesGuard(name, error);\n    return <WrappedComponent {...props} />;\n  };\n\n  Hoc.displayName = `withMaxAllowedInstancesGuard(${displayName})`;\n  return Hoc;\n}\n"],"mappings":"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","names":["jsx"]}
+{"version":3,"sources":["../src/contexts/MonocleProvider.tsx","../src/utils/useMaxAllowedInstancesGuard.tsx","../src/constants.ts"],"sourcesContent":["import React, { createContext, useContext, useEffect, useState } from 'react';\nimport { withMaxAllowedInstancesGuard } from '../utils';\nimport { MonocleProviderProps } from '../types';\nimport { DOMAIN } from '../constants';\ninterface MonocleContextType {\n  assessment: string | undefined;\n  refresh: () => void;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nconst MonocleContext = createContext<MonocleContextType | null>(null);\n\nconst MonocleProviderComponent: React.FC<MonocleProviderProps> = ({\n  children,\n  publishableKey,\n  domain = DOMAIN,\n}) => {\n  const [assessment, setAssessment] = useState<string | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const loadScript = () => {\n    return new Promise<void>((resolve, reject) => {\n      const existingScript = document.getElementById('_mcl');\n      if (existingScript) {\n        // If script exists but hasn't loaded yet, wait for it\n        if (!window.MCL) {\n          existingScript.onload = () => resolve();\n          existingScript.onerror = () =>\n            reject(new Error('Failed to load Monocle script'));\n        } else {\n          resolve();\n        }\n        return;\n      }\n\n      const script = document.createElement('script');\n      script.id = '_mcl';\n      script.async = true;\n      script.src = `https://${domain}/d/mcl.js?tk=${publishableKey}`;\n      script.onload = () => {\n        resolve();\n      };\n      script.onerror = (_e) => {\n        console.error('MonocleProvider: Script failed to load');\n        reject(new Error('Failed to load Monocle script'));\n      };\n      document.head.appendChild(script);\n    });\n  };\n\n  const refresh = async () => {\n    try {\n      setIsLoading(true);\n      setError(null);\n      await loadScript();\n      if (window.MCL) {\n        const newAssessment = window.MCL.getAssessment();\n        setAssessment(newAssessment);\n      } else {\n        throw new Error('MCL object not found on window');\n      }\n    } catch (err) {\n      setError(\n        err instanceof Error ? err : new Error('Unknown error occurred')\n      );\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  useEffect(() => {\n    // Only refresh if the publishableKey changes and we don't already have an assessment\n    if (!assessment) {\n      refresh();\n    }\n  }, [publishableKey]);\n\n  return (\n    <MonocleContext.Provider value={{ assessment, refresh, isLoading, error }}>\n      {children}\n    </MonocleContext.Provider>\n  );\n};\n\nexport const MonocleProvider = withMaxAllowedInstancesGuard(\n  MonocleProviderComponent,\n  'MonocleProvider',\n  'Only one instance of MonocleProvider is allowed'\n);\n\nexport const useMonocle = () => {\n  const context = useContext(MonocleContext);\n  if (!context) {\n    throw new Error('useMonocle must be used within a MonocleProvider');\n  }\n  return context;\n};\n","import React from 'react';\n\nconst instanceCounter = new Map<string, number>();\n\n/**\n * A React hook that ensures a component is not instantiated more than a specified number of times.\n * Throws an error if the maximum number of instances is exceeded.\n *\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @param maxCount - The maximum number of allowed instances (defaults to 1)\n * @throws Error when the maximum number of instances is exceeded\n *\n * @example\n * ```tsx\n * const MyComponent = () => {\n *   useMaxAllowedInstancesGuard('MyComponent', 'Only one instance of MyComponent is allowed');\n *   return <div>My Component</div>;\n * };\n * ```\n */\nexport function useMaxAllowedInstancesGuard(\n  name: string,\n  error: string,\n  maxCount = 1\n): void {\n  React.useEffect(() => {\n    const count = instanceCounter.get(name) || 0;\n    if (count === maxCount) {\n      throw new Error(error);\n    }\n    instanceCounter.set(name, count + 1);\n\n    return () => {\n      instanceCounter.set(name, (instanceCounter.get(name) || 1) - 1);\n    };\n  }, []);\n}\n\n/**\n * A higher-order component that wraps a component with instance count protection.\n * This HOC ensures that the wrapped component cannot be instantiated more than once\n * (or a specified number of times) in the application.\n *\n * @param WrappedComponent - The component to wrap with instance count protection\n * @param name - A unique identifier for the component type\n * @param error - The error message to display if the maximum count is exceeded\n * @returns A new component with instance count protection\n *\n * @example\n * ```tsx\n * const ProtectedComponent = withMaxAllowedInstancesGuard(\n *   MyComponent,\n *   'MyComponent',\n *   'Only one instance of MyComponent is allowed'\n * );\n * ```\n */\nexport function withMaxAllowedInstancesGuard<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  name: string,\n  error: string\n): React.ComponentType<P> {\n  const displayName =\n    WrappedComponent.displayName ||\n    WrappedComponent.name ||\n    name ||\n    'Component';\n\n  const Hoc: React.FC<P> = (props) => {\n    useMaxAllowedInstancesGuard(name, error);\n    return <WrappedComponent {...props} />;\n  };\n\n  Hoc.displayName = `withMaxAllowedInstancesGuard(${displayName})`;\n  return Hoc;\n}\n","export const DOMAIN = 'mcl.spur.us';\n"],"mappings":"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","names":["jsx"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spur.us/monocle-react",
-  "version": "0.1.0",
+  "version": "1.1.0-canary.v20250520214223",
   "description": "Monocle React library",
   "keywords": [
     "spur",
@@ -20,7 +20,7 @@
   "author": "Spur",
   "license": "MIT",
   "dependencies": {
-    "@spur.us/types": "^0.1.0"
+    "@spur.us/types": "^0.2.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0 || ^19.0.0-0",

package/src/constants.ts

@@ -0,0 +1 @@
+export const DOMAIN = 'mcl.spur.us';

package/src/contexts/MonocleProvider.tsx

@@ -1,10 +1,9 @@
-'use client';
-
 import React, { createContext, useContext, useEffect, useState } from 'react';
 import { withMaxAllowedInstancesGuard } from '../utils';
-
+import { MonocleProviderProps } from '../types';
+import { DOMAIN } from '../constants';
 interface MonocleContextType {
-  bundle: string | undefined;
+  assessment: string | undefined;
   refresh: () => void;
   isLoading: boolean;
   error: Error | null;
@@ -12,16 +11,12 @@ interface MonocleContextType {
 
 const MonocleContext = createContext<MonocleContextType | null>(null);
 
-interface MonocleProviderProps {
-  children: React.ReactNode;
-  publishableKey: string;
-}
-
 const MonocleProviderComponent: React.FC<MonocleProviderProps> = ({
   children,
   publishableKey,
+  domain = DOMAIN,
 }) => {
-  const [bundle, setBundle] = useState<string | undefined>(undefined);
+  const [assessment, setAssessment] = useState<string | undefined>(undefined);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<Error | null>(null);
 
@@ -43,7 +38,7 @@ const MonocleProviderComponent: React.FC<MonocleProviderProps> = ({
       const script = document.createElement('script');
       script.id = '_mcl';
       script.async = true;
-      script.src = `https://mcl.spur.us/d/mcl.js?tk=${publishableKey}`;
+      script.src = `https://${domain}/d/mcl.js?tk=${publishableKey}`;
       script.onload = () => {
         resolve();
       };
@@ -61,8 +56,8 @@ const MonocleProviderComponent: React.FC<MonocleProviderProps> = ({
       setError(null);
       await loadScript();
       if (window.MCL) {
-        const newBundle = window.MCL.getBundle();
-        setBundle(newBundle);
+        const newAssessment = window.MCL.getAssessment();
+        setAssessment(newAssessment);
       } else {
         throw new Error('MCL object not found on window');
       }
@@ -76,14 +71,14 @@ const MonocleProviderComponent: React.FC<MonocleProviderProps> = ({
   };
 
   useEffect(() => {
-    // Only refresh if the publishableKey changes and we don't already have a bundle
-    if (!bundle) {
+    // Only refresh if the publishableKey changes and we don't already have an assessment
+    if (!assessment) {
       refresh();
     }
   }, [publishableKey]);
 
   return (
-    <MonocleContext.Provider value={{ bundle, refresh, isLoading, error }}>
+    <MonocleContext.Provider value={{ assessment, refresh, isLoading, error }}>
       {children}
     </MonocleContext.Provider>
   );

package/src/index.ts

@@ -1 +1,3 @@
 export * from './contexts';
+
+export type { MonocleProviderProps } from './types';

package/src/types.ts

@@ -0,0 +1,12 @@
+/**
+ * Props for the MonocleProvider component.
+ * @interface MonocleProviderProps
+ */
+export interface MonocleProviderProps {
+  /** The child components to be wrapped by the MonocleProvider. */
+  children: React.ReactNode;
+  /** The publishable key used for authentication with Monocle. */
+  publishableKey: string;
+  /** Optional base domain for the Monocle API. Defaults to `mcl.spur.us` if not provided */
+  domain?: string;
+}