delta-auth-next 0.1.0

package/dist/DeltaProvider.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { DeltaAuthConfig } from './types';
+interface Props {
+    config: DeltaAuthConfig;
+    children: React.ReactNode;
+}
+export declare function DeltaAuthProvider({ config, children }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DeltaProvider.d.ts.map

package/dist/DeltaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeltaProvider.d.ts","sourceRoot":"","sources":["../src/DeltaProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAiB,MAAM,SAAS,CAAC;AAGzD,UAAU,KAAK;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,2CAsF5D"}

package/dist/DeltaProvider.js

@@ -0,0 +1,78 @@
+// src/DeltaAuthProvider.tsx
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from 'react';
+import { AuthContext } from './context';
+import { createAuthClient } from './client/authClient';
+import toast from 'react-hot-toast';
+export function DeltaAuthProvider({ config, children }) {
+    if (!config?.publishableKey)
+        throw new Error('DeltaAuth: publishableKey is required');
+    const [session, setSession] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const client = createAuthClient(config.backendUrl ? { backendUrl: config.backendUrl } : {});
+    // 🔹 Fetch current session
+    const fetchSession = useCallback(async () => {
+        try {
+            const res = await client.get('/auth/me'); // cookie-based
+            if (res.data?.data?.user) {
+                setSession(res.data.data);
+            }
+            else {
+                setSession(null);
+            }
+        }
+        catch (err) {
+            setSession(null);
+            if (config.showAlerts ?? true) {
+                toast.error(err.response?.data?.error ?? 'Auth failed');
+            }
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, config.showAlerts]);
+    // 🔹 Fetch detailed user info
+    const fetchUserDetails = useCallback(async () => {
+        if (!session?.user)
+            return null;
+        try {
+            const res = await client.get(`/users/${session.user.id}`);
+            setSession((prev) => (prev ? { ...prev, user: res.data } : null));
+            return res.data;
+        }
+        catch {
+            return session.user; // fallback
+        }
+    }, [client, session]);
+    // 🔹 Bootstrap session
+    useEffect(() => {
+        // block test/live key misuse
+        const isLocalhost = typeof window !== 'undefined' &&
+            window.location.hostname.includes('localhost');
+        const isProd = typeof window !== 'undefined' && window.location.protocol === 'https:';
+        if (isLocalhost && config.publishableKey.startsWith('pk_live')) {
+            throw new Error('Cannot use live key on localhost');
+        }
+        if (isProd && config.publishableKey.startsWith('pk_test')) {
+            throw new Error('Cannot use test key in production');
+        }
+        fetchSession();
+    }, [fetchSession, config.publishableKey]);
+    // 🔹 Auto refresh
+    useEffect(() => {
+        if (!config.autoRefresh)
+            return;
+        const interval = setInterval(fetchSession, config.refreshInterval ?? 5 * 60 * 1000);
+        return () => clearInterval(interval);
+    }, [fetchSession, config.autoRefresh, config.refreshInterval]);
+    return (_jsx(AuthContext.Provider, { value: {
+            session,
+            user: session?.user ?? null,
+            loading,
+            isAuthenticated: !!session,
+            client,
+            fetchUser: fetchUserDetails,
+        }, children: children }));
+}
+//# sourceMappingURL=DeltaProvider.js.map

package/dist/DeltaProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeltaProvider.js","sourceRoot":"","sources":["../src/DeltaProvider.tsx"],"names":[],"mappings":"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"}

package/dist/client/authClient.d.ts

@@ -0,0 +1,4 @@
+export declare function createAuthClient(config: {
+    backendUrl?: string;
+}): import("axios").AxiosInstance;
+//# sourceMappingURL=authClient.d.ts.map

package/dist/client/authClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authClient.d.ts","sourceRoot":"","sources":["../../src/client/authClient.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,iCAS/D"}

package/dist/client/authClient.js

@@ -0,0 +1,11 @@
+// src/client/authClient.ts
+import axios from 'axios';
+export function createAuthClient(config) {
+    const baseURL = config.backendUrl ?? '/api';
+    const client = axios.create({
+        baseURL,
+        withCredentials: true, // send cookies
+    });
+    return client;
+}
+//# sourceMappingURL=authClient.js.map

package/dist/client/authClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authClient.js","sourceRoot":"","sources":["../../src/client/authClient.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC;IAE5C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,OAAO;QACP,eAAe,EAAE,IAAI,EAAE,eAAe;KACvC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,11 @@
+import { Session, User } from './types';
+export interface AuthContextValue {
+    session: Session | null;
+    user: User | null;
+    loading: boolean;
+    isAuthenticated: boolean;
+    client: ReturnType<typeof import('./client/authClient').createAuthClient>;
+    fetchUser: () => Promise<User | null>;
+}
+export declare const AuthContext: import("react").Context<AuthContextValue>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC,cAAc,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;IAC1E,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,WAAW,2CAOtB,CAAC"}

package/dist/context.js

@@ -0,0 +1,11 @@
+// src/context.ts
+import { createContext } from 'react';
+export const AuthContext = createContext({
+    session: null,
+    user: null,
+    loading: true,
+    isAuthenticated: false,
+    client: {},
+    fetchUser: async () => null,
+});
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAYtC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAmB;IACzD,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,eAAe,EAAE,KAAK;IACtB,MAAM,EAAE,EAAS;IACjB,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;CAC5B,CAAC,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,2 @@
+export declare function useDeltaAuth(): import("./context").AuthContextValue;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,yCAE3B"}

package/dist/hooks.js

@@ -0,0 +1,7 @@
+// src/hooks.ts
+import { useContext } from 'react';
+import { AuthContext } from './context';
+export function useDeltaAuth() {
+    return useContext(AuthContext);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+export interface DeltaAuthConfig {
+    publishableKey: string;
+    autoRefresh?: boolean;
+    refreshInterval?: number;
+    showAlerts?: boolean;
+    backendUrl?: string;
+}
+export interface User {
+    id: string;
+    email: string;
+    first_name: string;
+    last_name: string;
+    role: string;
+    public_metadata?: Record<string, any>;
+}
+export interface Session {
+    access_token: string;
+    refresh_token: string;
+    expires_at: string;
+    user: User;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;CACZ"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "delta-auth-next",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@types/react": "^19.2.10",
+    "@types/react-dom": "^19.2.3",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "axios": "^1.13.4",
+    "react-hot-toast": "^2.6.0",
+    "uuid": "^13.0.0"
+  }
+}

package/src/DeltaProvider.tsx

@@ -0,0 +1,100 @@
+// src/DeltaAuthProvider.tsx
+'use client';
+import React, { useState, useEffect, useCallback } from 'react';
+import { AuthContext } from './context';
+import { createAuthClient } from './client/authClient';
+import { DeltaAuthConfig, Session, User } from './types';
+import toast from 'react-hot-toast';
+
+interface Props {
+  config: DeltaAuthConfig;
+  children: React.ReactNode;
+}
+
+export function DeltaAuthProvider({ config, children }: Props) {
+  if (!config?.publishableKey)
+    throw new Error('DeltaAuth: publishableKey is required');
+
+  const [session, setSession] = useState<Session | null>(null);
+  const [loading, setLoading] = useState(true);
+
+  const client = createAuthClient(
+    config.backendUrl ? { backendUrl: config.backendUrl } : {}
+  );
+
+
+  // 🔹 Fetch current session
+  const fetchSession = useCallback(async () => {
+    try {
+      const res = await client.get('/auth/me'); // cookie-based
+      if (res.data?.data?.user) {
+        setSession(res.data.data);
+      } else {
+        setSession(null);
+      }
+    } catch (err: any) {
+      setSession(null);
+      if (config.showAlerts ?? true) {
+        toast.error(err.response?.data?.error ?? 'Auth failed');
+      }
+    } finally {
+      setLoading(false);
+    }
+  }, [client, config.showAlerts]);
+
+  // 🔹 Fetch detailed user info
+  const fetchUserDetails = useCallback(async () => {
+    if (!session?.user) return null;
+    try {
+      const res = await client.get(`/users/${session.user.id}`);
+      setSession((prev) => (prev ? { ...prev, user: res.data } : null));
+      return res.data as User;
+    } catch {
+      return session.user; // fallback
+    }
+  }, [client, session]);
+
+  // 🔹 Bootstrap session
+  useEffect(() => {
+    // block test/live key misuse
+    const isLocalhost =
+      typeof window !== 'undefined' &&
+      window.location.hostname.includes('localhost');
+    const isProd =
+      typeof window !== 'undefined' && window.location.protocol === 'https:';
+
+    if (isLocalhost && config.publishableKey.startsWith('pk_live')) {
+      throw new Error('Cannot use live key on localhost');
+    }
+    if (isProd && config.publishableKey.startsWith('pk_test')) {
+      throw new Error('Cannot use test key in production');
+    }
+
+    fetchSession();
+  }, [fetchSession, config.publishableKey]);
+
+  // 🔹 Auto refresh
+  useEffect(() => {
+    if (!config.autoRefresh) return;
+    const interval = setInterval(
+      fetchSession,
+      config.refreshInterval ?? 5 * 60 * 1000
+    );
+    return () => clearInterval(interval);
+  }, [fetchSession, config.autoRefresh, config.refreshInterval]);
+
+  return (
+    <AuthContext.Provider
+      value={{
+        session,
+        user: session?.user ?? null,
+        loading,
+        isAuthenticated: !!session,
+        client,
+        fetchUser: fetchUserDetails,
+      }}
+    >
+      {children}
+    </AuthContext.Provider>
+  );
+}

package/src/client/authClient.ts

@@ -0,0 +1,13 @@
+// src/client/authClient.ts
+import axios from 'axios';
+
+export function createAuthClient(config: { backendUrl?: string }) {
+  const baseURL = config.backendUrl ?? '/api';
+
+  const client = axios.create({
+    baseURL,
+    withCredentials: true, // send cookies
+  });
+
+  return client;
+}

package/src/context.ts

@@ -0,0 +1,21 @@
+// src/context.ts
+import { createContext } from 'react';
+import { Session, User } from './types';
+
+export interface AuthContextValue {
+  session: Session | null;
+  user: User | null;
+  loading: boolean;
+  isAuthenticated: boolean;
+  client: ReturnType<typeof import('./client/authClient').createAuthClient>;
+  fetchUser: () => Promise<User | null>;
+}
+
+export const AuthContext = createContext<AuthContextValue>({
+  session: null,
+  user: null,
+  loading: true,
+  isAuthenticated: false,
+  client: {} as any,
+  fetchUser: async () => null,
+});

package/src/hooks.ts

@@ -0,0 +1,7 @@
+// src/hooks.ts
+import { useContext } from 'react';
+import { AuthContext } from './context';
+
+export function useDeltaAuth() {
+  return useContext(AuthContext);
+}

package/src/types.ts

@@ -0,0 +1,24 @@
+// src/types.ts
+export interface DeltaAuthConfig {
+  publishableKey: string;
+  autoRefresh?: boolean;
+  refreshInterval?: number; // ms
+  showAlerts?: boolean; // toggle alerts
+  backendUrl?: string;
+}
+
+export interface User {
+  id: string;
+  email: string;
+  first_name: string;
+  last_name: string;
+  role: string;
+  public_metadata?: Record<string, any>;
+}
+
+export interface Session {
+  access_token: string;
+  refresh_token: string;
+  expires_at: string;
+  user: User;
+}

package/tsconfig.json

@@ -0,0 +1,37 @@
+{
+  "compilerOptions": {
+    // Input / Output
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+
+    // Module / Target
+    "module": "ESNext",
+    "target": "ES2022",
+    "moduleResolution": "node",
+
+    // JSX support
+    "jsx": "react-jsx",
+
+    // Type Checking
+    "strict": true,
+    "noImplicitAny": true,
+    "exactOptionalPropertyTypes": true,
+    "noUncheckedIndexedAccess": true,
+    "isolatedModules": true,
+
+    // Skip library type checks for faster compilation
+    "skipLibCheck": true,
+
+    // Types
+    "types": ["node", "react", "react-dom"],
+
+    // Helps with ES modules and npm publishing
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}