@insforge/shared 1.1.1 → 1.1.2

package/README.md

@@ -1,62 +1,62 @@
-# @insforge/shared
-
-Shared utilities, types, and React contexts for Insforge packages.
-
-## Purpose
-
-This package centralizes React Context definitions to prevent duplication issues when using `tsup` with multiple entry points. By defining contexts here, all Insforge packages (`@insforge/react`, `@insforge/nextjs`, etc.) import from the same source, ensuring a single Context instance.
-
-## Architecture Pattern
-
-Inspired by `@clerk/shared`, this package solves the Context duplication problem:
-
-### The Problem
-
-When using `bundle: true` with multiple entry points:
-
-```typescript
-// tsup.config.ts
-entry: {
-  index: 'src/index.ts',
-  hooks: 'src/hooks/index.ts',
-  components: 'src/components/index.ts'
-}
-```
-
-Each entry point bundles its own copy of Context → Provider uses Context instance A, but components use Context instance B → `useContext` returns `undefined`.
-
-### The Solution
-
-1. **Centralized Context**: Define all Contexts in `@insforge/shared`
-2. **External React**: Mark `react` as external in tsup config
-3. **Shared Import**: All packages import Context from `@insforge/shared`
-
-```typescript
-// packages/shared/tsup.config.ts
-export default defineConfig({
-  external: ['react', 'react-dom'], // Critical!
-  bundle: true,
-});
-```
-
-## Exports
-
-### Main Entry (`@insforge/shared`)
-
-```typescript
-import type { InsforgeUser, InsforgeContextValue, OAuthProvider } from '@insforge/shared';
-```
-
-### React Entry (`@insforge/shared/react`)
-
-```typescript
-import { InsforgeContext } from '@insforge/shared/react';
-```
-
-## Usage
-
-This package is intended for internal use within the Insforge monorepo. Application developers should not need to import from it directly.
-
-## License
-
-MIT
+# @insforge/shared
+
+Shared utilities, types, and React contexts for Insforge packages.
+
+## Purpose
+
+This package centralizes React Context definitions to prevent duplication issues when using `tsup` with multiple entry points. By defining contexts here, all Insforge packages (`@insforge/react`, `@insforge/nextjs`, etc.) import from the same source, ensuring a single Context instance.
+
+## Architecture Pattern
+
+Inspired by `@clerk/shared`, this package solves the Context duplication problem:
+
+### The Problem
+
+When using `bundle: true` with multiple entry points:
+
+```typescript
+// tsup.config.ts
+entry: {
+  index: 'src/index.ts',
+  hooks: 'src/hooks/index.ts',
+  components: 'src/components/index.ts'
+}
+```
+
+Each entry point bundles its own copy of Context → Provider uses Context instance A, but components use Context instance B → `useContext` returns `undefined`.
+
+### The Solution
+
+1. **Centralized Context**: Define all Contexts in `@insforge/shared`
+2. **External React**: Mark `react` as external in tsup config
+3. **Shared Import**: All packages import Context from `@insforge/shared`
+
+```typescript
+// packages/shared/tsup.config.ts
+export default defineConfig({
+  external: ['react', 'react-dom'], // Critical!
+  bundle: true,
+});
+```
+
+## Exports
+
+### Main Entry (`@insforge/shared`)
+
+```typescript
+import type { InsforgeUser, InsforgeContextValue, OAuthProvider } from '@insforge/shared';
+```
+
+### React Entry (`@insforge/shared/react`)
+
+```typescript
+import { InsforgeContext } from '@insforge/shared/react';
+```
+
+## Usage
+
+This package is intended for internal use within the Insforge monorepo. Application developers should not need to import from it directly.
+
+## License
+
+MIT

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/contexts.tsx"],"names":["createContext"],"mappings":";;;;;AAmBO,IAAM,eAAA,GAAkBA,oBAAgD,MAAS;AACxF,eAAA,CAAgB,WAAA,GAAc,iBAAA;AAQvB,IAAM,wBAAA,GAA2BA,oBAA6C,MAAS;AAC9F,wBAAA,CAAyB,WAAA,GAAc,0BAAA;AAYhC,IAAM,sBAAA,GAAyBA,oBAA+C,MAAS;AAC9F,sBAAA,CAAuB,WAAA,GAAc,wBAAA;AAQ9B,IAAM,qBAAA,GAAwBA,oBAA8C,MAAS;AAC5F,qBAAA,CAAsB,WAAA,GAAc,uBAAA","file":"react.cjs","sourcesContent":["import { createContext } from 'react';\r\nimport type {\r\n  InsforgeContextValue,\r\n  InsforgeAuthState,\r\n  InsforgeAuthMethods,\r\n  InsforgeAuthConfig,\r\n} from '../types';\r\n\r\n/**\r\n * InsforgeContext - The single source of truth for authentication state\r\n *\r\n * This Context is defined in @insforge/shared to prevent duplication across\r\n * multiple tsup entry points. All packages (@insforge/react, @insforge/nextjs, etc.)\r\n * import this Context definition, ensuring there's only ONE Context instance.\r\n *\r\n * Pattern learned from @clerk/shared\r\n *\r\n * @deprecated Internal use only. Use useInsforge() hook instead.\r\n */\r\nexport const InsforgeContext = createContext<InsforgeContextValue | undefined>(undefined);\r\nInsforgeContext.displayName = 'InsforgeContext';\r\n\r\n/**\r\n * InsforgeAuthStateContext - Reactive auth state that changes on sign in/out\r\n *\r\n * This context holds the reactive state: user, userId, isLoaded, isSignedIn.\r\n * It updates when auth state changes.\r\n */\r\nexport const InsforgeAuthStateContext = createContext<InsforgeAuthState | undefined>(undefined);\r\nInsforgeAuthStateContext.displayName = 'InsforgeAuthStateContext';\r\n\r\n/**\r\n * InsforgeMethodsContext - Stable method references\r\n *\r\n * This context holds method references that NEVER change once initialized.\r\n * Methods like signIn, signOut, verifyEmail etc. are stored here.\r\n * This prevents useEffect re-runs when state changes.\r\n *\r\n * Pattern learned from @clerk/shared - they store the Clerk instance\r\n * in a separate context to keep method references stable.\r\n */\r\nexport const InsforgeMethodsContext = createContext<InsforgeAuthMethods | undefined>(undefined);\r\nInsforgeMethodsContext.displayName = 'InsforgeMethodsContext';\r\n\r\n/**\r\n * InsforgeConfigContext - Static configuration values\r\n *\r\n * This context holds configuration values like baseUrl, afterSignInUrl.\r\n * These rarely change after initialization.\r\n */\r\nexport const InsforgeConfigContext = createContext<InsforgeAuthConfig | undefined>(undefined);\r\nInsforgeConfigContext.displayName = 'InsforgeConfigContext';\r\n"]}
+{"version":3,"sources":["../src/react/contexts.tsx"],"names":["createContext"],"mappings":";;;;;AAmBO,IAAM,eAAA,GAAkBA,oBAAgD,MAAS;AACxF,eAAA,CAAgB,WAAA,GAAc,iBAAA;AAQvB,IAAM,wBAAA,GAA2BA,oBAA6C,MAAS;AAC9F,wBAAA,CAAyB,WAAA,GAAc,0BAAA;AAYhC,IAAM,sBAAA,GAAyBA,oBAA+C,MAAS;AAC9F,sBAAA,CAAuB,WAAA,GAAc,wBAAA;AAQ9B,IAAM,qBAAA,GAAwBA,oBAA8C,MAAS;AAC5F,qBAAA,CAAsB,WAAA,GAAc,uBAAA","file":"react.cjs","sourcesContent":["import { createContext } from 'react';\nimport type {\n  InsforgeContextValue,\n  InsforgeAuthState,\n  InsforgeAuthMethods,\n  InsforgeAuthConfig,\n} from '../types';\n\n/**\n * InsforgeContext - The single source of truth for authentication state\n *\n * This Context is defined in @insforge/shared to prevent duplication across\n * multiple tsup entry points. All packages (@insforge/react, @insforge/nextjs, etc.)\n * import this Context definition, ensuring there's only ONE Context instance.\n *\n * Pattern learned from @clerk/shared\n *\n * @deprecated Internal use only. Use useInsforge() hook instead.\n */\nexport const InsforgeContext = createContext<InsforgeContextValue | undefined>(undefined);\nInsforgeContext.displayName = 'InsforgeContext';\n\n/**\n * InsforgeAuthStateContext - Reactive auth state that changes on sign in/out\n *\n * This context holds the reactive state: user, userId, isLoaded, isSignedIn.\n * It updates when auth state changes.\n */\nexport const InsforgeAuthStateContext = createContext<InsforgeAuthState | undefined>(undefined);\nInsforgeAuthStateContext.displayName = 'InsforgeAuthStateContext';\n\n/**\n * InsforgeMethodsContext - Stable method references\n *\n * This context holds method references that NEVER change once initialized.\n * Methods like signIn, signOut, verifyEmail etc. are stored here.\n * This prevents useEffect re-runs when state changes.\n *\n * Pattern learned from @clerk/shared - they store the Clerk instance\n * in a separate context to keep method references stable.\n */\nexport const InsforgeMethodsContext = createContext<InsforgeAuthMethods | undefined>(undefined);\nInsforgeMethodsContext.displayName = 'InsforgeMethodsContext';\n\n/**\n * InsforgeConfigContext - Static configuration values\n *\n * This context holds configuration values like baseUrl, afterSignInUrl.\n * These rarely change after initialization.\n */\nexport const InsforgeConfigContext = createContext<InsforgeAuthConfig | undefined>(undefined);\nInsforgeConfigContext.displayName = 'InsforgeConfigContext';\n"]}

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/contexts.tsx"],"names":[],"mappings":";;;AAmBO,IAAM,eAAA,GAAkB,cAAgD,MAAS;AACxF,eAAA,CAAgB,WAAA,GAAc,iBAAA;AAQvB,IAAM,wBAAA,GAA2B,cAA6C,MAAS;AAC9F,wBAAA,CAAyB,WAAA,GAAc,0BAAA;AAYhC,IAAM,sBAAA,GAAyB,cAA+C,MAAS;AAC9F,sBAAA,CAAuB,WAAA,GAAc,wBAAA;AAQ9B,IAAM,qBAAA,GAAwB,cAA8C,MAAS;AAC5F,qBAAA,CAAsB,WAAA,GAAc,uBAAA","file":"react.js","sourcesContent":["import { createContext } from 'react';\r\nimport type {\r\n  InsforgeContextValue,\r\n  InsforgeAuthState,\r\n  InsforgeAuthMethods,\r\n  InsforgeAuthConfig,\r\n} from '../types';\r\n\r\n/**\r\n * InsforgeContext - The single source of truth for authentication state\r\n *\r\n * This Context is defined in @insforge/shared to prevent duplication across\r\n * multiple tsup entry points. All packages (@insforge/react, @insforge/nextjs, etc.)\r\n * import this Context definition, ensuring there's only ONE Context instance.\r\n *\r\n * Pattern learned from @clerk/shared\r\n *\r\n * @deprecated Internal use only. Use useInsforge() hook instead.\r\n */\r\nexport const InsforgeContext = createContext<InsforgeContextValue | undefined>(undefined);\r\nInsforgeContext.displayName = 'InsforgeContext';\r\n\r\n/**\r\n * InsforgeAuthStateContext - Reactive auth state that changes on sign in/out\r\n *\r\n * This context holds the reactive state: user, userId, isLoaded, isSignedIn.\r\n * It updates when auth state changes.\r\n */\r\nexport const InsforgeAuthStateContext = createContext<InsforgeAuthState | undefined>(undefined);\r\nInsforgeAuthStateContext.displayName = 'InsforgeAuthStateContext';\r\n\r\n/**\r\n * InsforgeMethodsContext - Stable method references\r\n *\r\n * This context holds method references that NEVER change once initialized.\r\n * Methods like signIn, signOut, verifyEmail etc. are stored here.\r\n * This prevents useEffect re-runs when state changes.\r\n *\r\n * Pattern learned from @clerk/shared - they store the Clerk instance\r\n * in a separate context to keep method references stable.\r\n */\r\nexport const InsforgeMethodsContext = createContext<InsforgeAuthMethods | undefined>(undefined);\r\nInsforgeMethodsContext.displayName = 'InsforgeMethodsContext';\r\n\r\n/**\r\n * InsforgeConfigContext - Static configuration values\r\n *\r\n * This context holds configuration values like baseUrl, afterSignInUrl.\r\n * These rarely change after initialization.\r\n */\r\nexport const InsforgeConfigContext = createContext<InsforgeAuthConfig | undefined>(undefined);\r\nInsforgeConfigContext.displayName = 'InsforgeConfigContext';\r\n"]}
+{"version":3,"sources":["../src/react/contexts.tsx"],"names":[],"mappings":";;;AAmBO,IAAM,eAAA,GAAkB,cAAgD,MAAS;AACxF,eAAA,CAAgB,WAAA,GAAc,iBAAA;AAQvB,IAAM,wBAAA,GAA2B,cAA6C,MAAS;AAC9F,wBAAA,CAAyB,WAAA,GAAc,0BAAA;AAYhC,IAAM,sBAAA,GAAyB,cAA+C,MAAS;AAC9F,sBAAA,CAAuB,WAAA,GAAc,wBAAA;AAQ9B,IAAM,qBAAA,GAAwB,cAA8C,MAAS;AAC5F,qBAAA,CAAsB,WAAA,GAAc,uBAAA","file":"react.js","sourcesContent":["import { createContext } from 'react';\nimport type {\n  InsforgeContextValue,\n  InsforgeAuthState,\n  InsforgeAuthMethods,\n  InsforgeAuthConfig,\n} from '../types';\n\n/**\n * InsforgeContext - The single source of truth for authentication state\n *\n * This Context is defined in @insforge/shared to prevent duplication across\n * multiple tsup entry points. All packages (@insforge/react, @insforge/nextjs, etc.)\n * import this Context definition, ensuring there's only ONE Context instance.\n *\n * Pattern learned from @clerk/shared\n *\n * @deprecated Internal use only. Use useInsforge() hook instead.\n */\nexport const InsforgeContext = createContext<InsforgeContextValue | undefined>(undefined);\nInsforgeContext.displayName = 'InsforgeContext';\n\n/**\n * InsforgeAuthStateContext - Reactive auth state that changes on sign in/out\n *\n * This context holds the reactive state: user, userId, isLoaded, isSignedIn.\n * It updates when auth state changes.\n */\nexport const InsforgeAuthStateContext = createContext<InsforgeAuthState | undefined>(undefined);\nInsforgeAuthStateContext.displayName = 'InsforgeAuthStateContext';\n\n/**\n * InsforgeMethodsContext - Stable method references\n *\n * This context holds method references that NEVER change once initialized.\n * Methods like signIn, signOut, verifyEmail etc. are stored here.\n * This prevents useEffect re-runs when state changes.\n *\n * Pattern learned from @clerk/shared - they store the Clerk instance\n * in a separate context to keep method references stable.\n */\nexport const InsforgeMethodsContext = createContext<InsforgeAuthMethods | undefined>(undefined);\nInsforgeMethodsContext.displayName = 'InsforgeMethodsContext';\n\n/**\n * InsforgeConfigContext - Static configuration values\n *\n * This context holds configuration values like baseUrl, afterSignInUrl.\n * These rarely change after initialization.\n */\nexport const InsforgeConfigContext = createContext<InsforgeAuthConfig | undefined>(undefined);\nInsforgeConfigContext.displayName = 'InsforgeConfigContext';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/shared",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Shared utilities and React contexts for Insforge packages",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -40,7 +40,7 @@
     "react": ">=18.0.0 <20.0.0"
   },
   "dependencies": {
-    "@insforge/shared-schemas": "^1.1.39"
+    "@insforge/shared-schemas": "^1.1.42"
   },
   "devDependencies": {
     "@types/react": "^19.2.2",