@insforge/shared 0.1.0

package/README.md

@@ -0,0 +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

package/dist/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/index.d.cts

@@ -0,0 +1,74 @@
+import { UserSchema } from '@insforge/sdk';
+import { CreateSessionResponse, CreateUserResponse, ResetPasswordResponse, OAuthProvidersSchema, GetPublicAuthConfigResponse } from '@insforge/shared-schemas';
+
+/**
+ * Insforge User type
+ */
+interface InsforgeUser {
+    id: string;
+    email: string;
+    name?: string;
+    avatarUrl?: string;
+}
+/**
+ * OAuth Provider type - re-export from shared-schemas
+ */
+type OAuthProvider = OAuthProvidersSchema;
+/**
+ * Context value interface for InsforgeContext
+ */
+interface InsforgeContextValue {
+    user: InsforgeUser | null;
+    isLoaded: boolean;
+    isSignedIn: boolean;
+    setUser: (user: InsforgeUser | null) => void;
+    signIn: (email: string, password: string) => Promise<CreateSessionResponse | {
+        error: string;
+        statusCode?: number;
+        errorCode?: string;
+    }>;
+    signUp: (email: string, password: string) => Promise<CreateUserResponse | {
+        error: string;
+        statusCode?: number;
+        errorCode?: string;
+    }>;
+    signOut: () => Promise<void>;
+    updateUser: (data: Partial<InsforgeUser>) => Promise<{
+        error: string;
+    } | null>;
+    reloadAuth: () => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    sendVerificationEmail: (email: string) => Promise<{
+        success: boolean;
+        message: string;
+    } | null>;
+    sendResetPasswordEmail: (email: string) => Promise<{
+        success: boolean;
+        message: string;
+    } | null>;
+    resetPassword: (token: string, newPassword: string) => Promise<ResetPasswordResponse | null>;
+    verifyEmail: (otp: string, email?: string) => Promise<{
+        accessToken: string;
+        user?: UserSchema;
+        redirectTo?: string;
+        error?: {
+            message: string;
+        };
+    } | null>;
+    exchangeResetPasswordToken: (email: string, code: string) => Promise<{
+        token: string;
+        expiresAt?: string;
+    } | {
+        error: {
+            message: string;
+        };
+    }>;
+    loginWithOAuth: (provider: OAuthProvider, redirectTo: string) => Promise<void>;
+    getPublicAuthConfig: () => Promise<GetPublicAuthConfigResponse | null>;
+    baseUrl: string;
+    afterSignInUrl: string;
+}
+
+export type { InsforgeContextValue, InsforgeUser, OAuthProvider };

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { UserSchema } from '@insforge/sdk';
+import { CreateSessionResponse, CreateUserResponse, ResetPasswordResponse, OAuthProvidersSchema, GetPublicAuthConfigResponse } from '@insforge/shared-schemas';
+
+/**
+ * Insforge User type
+ */
+interface InsforgeUser {
+    id: string;
+    email: string;
+    name?: string;
+    avatarUrl?: string;
+}
+/**
+ * OAuth Provider type - re-export from shared-schemas
+ */
+type OAuthProvider = OAuthProvidersSchema;
+/**
+ * Context value interface for InsforgeContext
+ */
+interface InsforgeContextValue {
+    user: InsforgeUser | null;
+    isLoaded: boolean;
+    isSignedIn: boolean;
+    setUser: (user: InsforgeUser | null) => void;
+    signIn: (email: string, password: string) => Promise<CreateSessionResponse | {
+        error: string;
+        statusCode?: number;
+        errorCode?: string;
+    }>;
+    signUp: (email: string, password: string) => Promise<CreateUserResponse | {
+        error: string;
+        statusCode?: number;
+        errorCode?: string;
+    }>;
+    signOut: () => Promise<void>;
+    updateUser: (data: Partial<InsforgeUser>) => Promise<{
+        error: string;
+    } | null>;
+    reloadAuth: () => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    sendVerificationEmail: (email: string) => Promise<{
+        success: boolean;
+        message: string;
+    } | null>;
+    sendResetPasswordEmail: (email: string) => Promise<{
+        success: boolean;
+        message: string;
+    } | null>;
+    resetPassword: (token: string, newPassword: string) => Promise<ResetPasswordResponse | null>;
+    verifyEmail: (otp: string, email?: string) => Promise<{
+        accessToken: string;
+        user?: UserSchema;
+        redirectTo?: string;
+        error?: {
+            message: string;
+        };
+    } | null>;
+    exchangeResetPasswordToken: (email: string, code: string) => Promise<{
+        token: string;
+        expiresAt?: string;
+    } | {
+        error: {
+            message: string;
+        };
+    }>;
+    loginWithOAuth: (provider: OAuthProvider, redirectTo: string) => Promise<void>;
+    getPublicAuthConfig: () => Promise<GetPublicAuthConfigResponse | null>;
+    baseUrl: string;
+    afterSignInUrl: string;
+}
+
+export type { InsforgeContextValue, InsforgeUser, OAuthProvider };

package/dist/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/react.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+var react = require('react');
+
+// src/react/contexts.tsx
+var InsforgeContext = react.createContext(void 0);
+InsforgeContext.displayName = "InsforgeContext";
+
+exports.InsforgeContext = InsforgeContext;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/contexts.tsx"],"names":["createContext"],"mappings":";;;;;AAYO,IAAM,eAAA,GAAkBA,oBAAgD,MAAS;AACxF,eAAA,CAAgB,WAAA,GAAc,iBAAA","file":"react.cjs","sourcesContent":["import { createContext } from 'react';\nimport type { InsforgeContextValue } 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 */\nexport const InsforgeContext = createContext<InsforgeContextValue | undefined>(undefined);\nInsforgeContext.displayName = 'InsforgeContext';\n"]}

package/dist/react.d.cts

@@ -0,0 +1,17 @@
+import * as react from 'react';
+import { InsforgeContextValue } from './index.cjs';
+import '@insforge/sdk';
+import '@insforge/shared-schemas';
+
+/**
+ * InsforgeContext - The single source of truth for authentication state
+ *
+ * This Context is defined in @insforge/shared to prevent duplication across
+ * multiple tsup entry points. All packages (@insforge/react, @insforge/nextjs, etc.)
+ * import this Context definition, ensuring there's only ONE Context instance.
+ *
+ * Pattern learned from @clerk/shared
+ */
+declare const InsforgeContext: react.Context<InsforgeContextValue | undefined>;
+
+export { InsforgeContext };

package/dist/react.d.ts

@@ -0,0 +1,17 @@
+import * as react from 'react';
+import { InsforgeContextValue } from './index.js';
+import '@insforge/sdk';
+import '@insforge/shared-schemas';
+
+/**
+ * InsforgeContext - The single source of truth for authentication state
+ *
+ * This Context is defined in @insforge/shared to prevent duplication across
+ * multiple tsup entry points. All packages (@insforge/react, @insforge/nextjs, etc.)
+ * import this Context definition, ensuring there's only ONE Context instance.
+ *
+ * Pattern learned from @clerk/shared
+ */
+declare const InsforgeContext: react.Context<InsforgeContextValue | undefined>;
+
+export { InsforgeContext };

package/dist/react.js

@@ -0,0 +1,9 @@
+import { createContext } from 'react';
+
+// src/react/contexts.tsx
+var InsforgeContext = createContext(void 0);
+InsforgeContext.displayName = "InsforgeContext";
+
+export { InsforgeContext };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/contexts.tsx"],"names":[],"mappings":";;;AAYO,IAAM,eAAA,GAAkB,cAAgD,MAAS;AACxF,eAAA,CAAgB,WAAA,GAAc,iBAAA","file":"react.js","sourcesContent":["import { createContext } from 'react';\nimport type { InsforgeContextValue } 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 */\nexport const InsforgeContext = createContext<InsforgeContextValue | undefined>(undefined);\nInsforgeContext.displayName = 'InsforgeContext';\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@insforge/shared",
+  "version": "0.1.0",
+  "description": "Shared utilities and React contexts for Insforge packages",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "insforge",
+    "shared",
+    "react",
+    "context"
+  ],
+  "author": "Insforge",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "dependencies": {
+    "@insforge/sdk": "^0.0.58",
+    "@insforge/shared-schemas": "^1.1.19"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.2"
+  }
+}