@kavachos/react 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KavachOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface KavachUser {
+    id: string;
+    email?: string;
+    name?: string;
+    image?: string;
+}
+interface KavachSession {
+    token: string;
+    user: KavachUser;
+    expiresAt?: string;
+}
+interface KavachAgent {
+    id: string;
+    ownerId: string;
+    name: string;
+    type: "autonomous" | "delegated" | "service";
+    token: string;
+    permissions: KavachPermission[];
+    status: "active" | "revoked" | "expired";
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface KavachPermission {
+    resource: string;
+    actions: string[];
+    constraints?: {
+        maxCallsPerHour?: number;
+        allowedArgPatterns?: string[];
+        requireApproval?: boolean;
+        timeWindow?: {
+            start: string;
+            end: string;
+        };
+        ipAllowlist?: string[];
+    };
+}
+interface CreateAgentInput {
+    ownerId: string;
+    name: string;
+    type: "autonomous" | "delegated" | "service";
+    permissions: KavachPermission[];
+    expiresAt?: string;
+    metadata?: Record<string, unknown>;
+}
+type ActionResult<T = void> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+interface KavachContextValue {
+    session: KavachSession | null;
+    user: KavachUser | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    signIn: (email: string, password: string) => Promise<ActionResult>;
+    signUp: (email: string, password: string, name?: string) => Promise<ActionResult>;
+    signOut: () => Promise<void>;
+    refresh: () => Promise<void>;
+}
+
+declare const KavachContext: react.Context<KavachContextValue | null>;
+declare function useKavachContext(): KavachContextValue;
+interface KavachProviderProps {
+    children: ReactNode;
+    /** Base path where KavachOS is mounted. Defaults to "/api/kavach". */
+    basePath?: string;
+}
+declare function KavachProvider({ children, basePath, }: KavachProviderProps): ReactNode;
+
+/**
+ * Returns the current session, loading state, and a manual refresh function.
+ */
+declare function useSession(): {
+    session: KavachSession | null;
+    isLoading: boolean;
+    refresh: () => Promise<void>;
+};
+/**
+ * Returns the current user, loading state, and authentication status.
+ */
+declare function useUser(): {
+    user: KavachUser | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+};
+/**
+ * Returns a signIn function plus local loading and error state.
+ */
+declare function useSignIn(): {
+    signIn: (email: string, password: string) => Promise<ActionResult>;
+    isLoading: boolean;
+    error: string | null;
+};
+/**
+ * Returns a signUp function plus local loading and error state.
+ */
+declare function useSignUp(): {
+    signUp: (email: string, password: string, name?: string) => Promise<ActionResult>;
+    isLoading: boolean;
+    error: string | null;
+};
+/**
+ * Returns a signOut function.
+ */
+declare function useSignOut(): {
+    signOut: () => Promise<void>;
+};
+/**
+ * Manages agent identity records for a given user.
+ *
+ * Fetches the agent list and exposes create, revoke, and rotate helpers.
+ * All mutations refresh the list automatically.
+ */
+declare function useAgents(basePath?: string): {
+    agents: KavachAgent[];
+    isLoading: boolean;
+    error: string | null;
+    load: () => Promise<void>;
+    create: (input: CreateAgentInput) => Promise<ActionResult<KavachAgent>>;
+    revoke: (agentId: string) => Promise<ActionResult>;
+    rotate: (agentId: string) => Promise<ActionResult<KavachAgent>>;
+};
+
+export { type ActionResult, type CreateAgentInput, type KavachAgent, KavachContext, type KavachContextValue, type KavachPermission, KavachProvider, type KavachProviderProps, type KavachSession, type KavachUser, useAgents, useKavachContext, useSession, useSignIn, useSignOut, useSignUp, useUser };

package/dist/index.js

@@ -0,0 +1,324 @@
+// src/context.tsx
+import { createContext, useCallback, useContext, useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+var KavachContext = createContext(null);
+function useKavachContext() {
+  const ctx = useContext(KavachContext);
+  if (!ctx) {
+    throw new Error("useKavachContext must be used inside <KavachProvider>");
+  }
+  return ctx;
+}
+function KavachProvider({
+  children,
+  basePath = "/api/kavach"
+}) {
+  const [session, setSession] = useState(null);
+  const [isLoading, setIsLoading] = useState(true);
+  const base = basePath.replace(/\/$/, "");
+  const fetchSession = useCallback(async () => {
+    try {
+      const res = await fetch(`${base}/session`, {
+        credentials: "include"
+      });
+      if (res.ok) {
+        const json = await res.json();
+        setSession(json.data ?? null);
+      } else {
+        setSession(null);
+      }
+    } catch {
+      setSession(null);
+    }
+  }, [base]);
+  useEffect(() => {
+    if (typeof window === "undefined") {
+      setIsLoading(false);
+      return;
+    }
+    setIsLoading(true);
+    void fetchSession().finally(() => {
+      setIsLoading(false);
+    });
+  }, [fetchSession]);
+  const refresh = useCallback(async () => {
+    await fetchSession();
+  }, [fetchSession]);
+  const signIn = useCallback(
+    async (email, password) => {
+      try {
+        const res = await fetch(`${base}/sign-in/email`, {
+          method: "POST",
+          credentials: "include",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ email, password })
+        });
+        const json = await res.json();
+        if (!res.ok) {
+          const errBody = json;
+          return {
+            success: false,
+            error: errBody.error?.message ?? `Sign-in failed (${res.status})`
+          };
+        }
+        const okBody = json;
+        setSession(okBody.data);
+        return { success: true, data: void 0 };
+      } catch (err) {
+        return {
+          success: false,
+          error: err instanceof Error ? err.message : "Network error"
+        };
+      }
+    },
+    [base]
+  );
+  const signUp = useCallback(
+    async (email, password, name) => {
+      try {
+        const res = await fetch(`${base}/sign-up/email`, {
+          method: "POST",
+          credentials: "include",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ email, password, name })
+        });
+        const json = await res.json();
+        if (!res.ok) {
+          const errBody = json;
+          return {
+            success: false,
+            error: errBody.error?.message ?? `Sign-up failed (${res.status})`
+          };
+        }
+        const okBody = json;
+        setSession(okBody.data);
+        return { success: true, data: void 0 };
+      } catch (err) {
+        return {
+          success: false,
+          error: err instanceof Error ? err.message : "Network error"
+        };
+      }
+    },
+    [base]
+  );
+  const signOut = useCallback(async () => {
+    try {
+      await fetch(`${base}/sign-out`, {
+        method: "POST",
+        credentials: "include"
+      });
+    } finally {
+      setSession(null);
+    }
+  }, [base]);
+  const user = session?.user ?? null;
+  const value = {
+    session,
+    user,
+    isLoading,
+    isAuthenticated: session !== null,
+    signIn,
+    signUp,
+    signOut,
+    refresh
+  };
+  return /* @__PURE__ */ jsx(KavachContext.Provider, { value, children });
+}
+
+// src/hooks.ts
+import { useCallback as useCallback2, useContext as useContext2, useState as useState2 } from "react";
+function useRequiredContext(hookName) {
+  const ctx = useContext2(KavachContext);
+  if (!ctx) {
+    throw new Error(`${hookName} must be used inside <KavachProvider>`);
+  }
+  return ctx;
+}
+function useSession() {
+  const { session, isLoading, refresh } = useRequiredContext("useSession");
+  return { session, isLoading, refresh };
+}
+function useUser() {
+  const { user, isLoading, isAuthenticated } = useRequiredContext("useUser");
+  return { user, isLoading, isAuthenticated };
+}
+function useSignIn() {
+  const { signIn } = useRequiredContext("useSignIn");
+  const [isLoading, setIsLoading] = useState2(false);
+  const [error, setError] = useState2(null);
+  const execute = useCallback2(
+    async (email, password) => {
+      setIsLoading(true);
+      setError(null);
+      const result = await signIn(email, password);
+      if (!result.success) {
+        setError(result.error);
+      }
+      setIsLoading(false);
+      return result;
+    },
+    [signIn]
+  );
+  return { signIn: execute, isLoading, error };
+}
+function useSignUp() {
+  const { signUp } = useRequiredContext("useSignUp");
+  const [isLoading, setIsLoading] = useState2(false);
+  const [error, setError] = useState2(null);
+  const execute = useCallback2(
+    async (email, password, name) => {
+      setIsLoading(true);
+      setError(null);
+      const result = await signUp(email, password, name);
+      if (!result.success) {
+        setError(result.error);
+      }
+      setIsLoading(false);
+      return result;
+    },
+    [signUp]
+  );
+  return { signUp: execute, isLoading, error };
+}
+function useSignOut() {
+  const { signOut } = useRequiredContext("useSignOut");
+  return { signOut };
+}
+function extractError(body, fallback) {
+  if (body !== null && typeof body === "object" && "error" in body && body.error !== null && typeof body.error === "object" && "message" in body.error && typeof body.error.message === "string") {
+    return body.error.message;
+  }
+  return fallback;
+}
+function useAgents(basePath = "/api/kavach") {
+  const { user } = useRequiredContext("useAgents");
+  const base = basePath.replace(/\/$/, "");
+  const [agents, setAgents] = useState2([]);
+  const [isLoading, setIsLoading] = useState2(false);
+  const [error, setError] = useState2(null);
+  const load = useCallback2(async () => {
+    if (!user) {
+      setAgents([]);
+      return;
+    }
+    setIsLoading(true);
+    setError(null);
+    try {
+      const res = await fetch(`${base}/agents?userId=${encodeURIComponent(user.id)}`, {
+        credentials: "include"
+      });
+      const json = await res.json();
+      if (!res.ok) {
+        setError(extractError(json, `Failed to load agents (${res.status})`));
+        return;
+      }
+      setAgents(json.data);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Network error");
+    } finally {
+      setIsLoading(false);
+    }
+  }, [base, user]);
+  const [loaded, setLoaded] = useState2(false);
+  if (user && !loaded) {
+    setLoaded(true);
+    void Promise.resolve().then(load);
+  }
+  if (!user && loaded) {
+    setLoaded(false);
+    setAgents([]);
+  }
+  const create = useCallback2(
+    async (input) => {
+      try {
+        const res = await fetch(`${base}/agents`, {
+          method: "POST",
+          credentials: "include",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        const json = await res.json();
+        if (!res.ok) {
+          return {
+            success: false,
+            error: extractError(json, `Failed to create agent (${res.status})`)
+          };
+        }
+        const agent = json.data;
+        await load();
+        return { success: true, data: agent };
+      } catch (err) {
+        return {
+          success: false,
+          error: err instanceof Error ? err.message : "Network error"
+        };
+      }
+    },
+    [base, load]
+  );
+  const revoke = useCallback2(
+    async (agentId) => {
+      try {
+        const res = await fetch(`${base}/agents/${encodeURIComponent(agentId)}`, {
+          method: "DELETE",
+          credentials: "include"
+        });
+        if (!res.ok && res.status !== 204) {
+          const json = await res.json().catch(() => null);
+          return {
+            success: false,
+            error: extractError(json, `Failed to revoke agent (${res.status})`)
+          };
+        }
+        await load();
+        return { success: true, data: void 0 };
+      } catch (err) {
+        return {
+          success: false,
+          error: err instanceof Error ? err.message : "Network error"
+        };
+      }
+    },
+    [base, load]
+  );
+  const rotate = useCallback2(
+    async (agentId) => {
+      try {
+        const res = await fetch(`${base}/agents/${encodeURIComponent(agentId)}/rotate`, {
+          method: "POST",
+          credentials: "include"
+        });
+        const json = await res.json();
+        if (!res.ok) {
+          return {
+            success: false,
+            error: extractError(json, `Failed to rotate agent token (${res.status})`)
+          };
+        }
+        const agent = json.data;
+        await load();
+        return { success: true, data: agent };
+      } catch (err) {
+        return {
+          success: false,
+          error: err instanceof Error ? err.message : "Network error"
+        };
+      }
+    },
+    [base, load]
+  );
+  return { agents, isLoading, error, load, create, revoke, rotate };
+}
+export {
+  KavachContext,
+  KavachProvider,
+  useAgents,
+  useKavachContext,
+  useSession,
+  useSignIn,
+  useSignOut,
+  useSignUp,
+  useUser
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.tsx","../src/hooks.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { createContext, useCallback, useContext, useEffect, useState } from \"react\";\nimport type { ActionResult, KavachContextValue, KavachSession, KavachUser } from \"./types.js\";\n\n// ─── Context ──────────────────────────────────────────────────────────────────\n\nexport const KavachContext = createContext<KavachContextValue | null>(null);\n\nexport function useKavachContext(): KavachContextValue {\n\tconst ctx = useContext(KavachContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useKavachContext must be used inside <KavachProvider>\");\n\t}\n\treturn ctx;\n}\n\n// ─── Provider ─────────────────────────────────────────────────────────────────\n\nexport interface KavachProviderProps {\n\tchildren: ReactNode;\n\t/** Base path where KavachOS is mounted. Defaults to \"/api/kavach\". */\n\tbasePath?: string;\n}\n\nexport function KavachProvider({\n\tchildren,\n\tbasePath = \"/api/kavach\",\n}: KavachProviderProps): ReactNode {\n\tconst [session, setSession] = useState<KavachSession | null>(null);\n\tconst [isLoading, setIsLoading] = useState(true);\n\n\t// Strip trailing slash from basePath once\n\tconst base = basePath.replace(/\\/$/, \"\");\n\n\tconst fetchSession = useCallback(async (): Promise<void> => {\n\t\ttry {\n\t\t\tconst res = await fetch(`${base}/session`, {\n\t\t\t\tcredentials: \"include\",\n\t\t\t});\n\t\t\tif (res.ok) {\n\t\t\t\tconst json = (await res.json()) as { data?: KavachSession };\n\t\t\t\tsetSession(json.data ?? null);\n\t\t\t} else {\n\t\t\t\tsetSession(null);\n\t\t\t}\n\t\t} catch {\n\t\t\tsetSession(null);\n\t\t}\n\t}, [base]);\n\n\t// Fetch session on mount (only in browser)\n\tuseEffect(() => {\n\t\tif (typeof window === \"undefined\") {\n\t\t\tsetIsLoading(false);\n\t\t\treturn;\n\t\t}\n\t\tsetIsLoading(true);\n\t\tvoid fetchSession().finally(() => {\n\t\t\tsetIsLoading(false);\n\t\t});\n\t}, [fetchSession]);\n\n\tconst refresh = useCallback(async (): Promise<void> => {\n\t\tawait fetchSession();\n\t}, [fetchSession]);\n\n\tconst signIn = useCallback(\n\t\tasync (email: string, password: string): Promise<ActionResult> => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(`${base}/sign-in/email`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tcredentials: \"include\",\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t\tbody: JSON.stringify({ email, password }),\n\t\t\t\t});\n\t\t\t\tconst json = (await res.json()) as\n\t\t\t\t\t| { data: KavachSession }\n\t\t\t\t\t| { error: { code: string; message: string } };\n\n\t\t\t\tif (!res.ok) {\n\t\t\t\t\tconst errBody = json as { error: { code: string; message: string } };\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror: errBody.error?.message ?? `Sign-in failed (${res.status})`,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst okBody = json as { data: KavachSession };\n\t\t\t\tsetSession(okBody.data);\n\t\t\t\treturn { success: true, data: undefined };\n\t\t\t} catch (err) {\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: err instanceof Error ? err.message : \"Network error\",\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\t[base],\n\t);\n\n\tconst signUp = useCallback(\n\t\tasync (email: string, password: string, name?: string): Promise<ActionResult> => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(`${base}/sign-up/email`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tcredentials: \"include\",\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t\tbody: JSON.stringify({ email, password, name }),\n\t\t\t\t});\n\t\t\t\tconst json = (await res.json()) as\n\t\t\t\t\t| { data: KavachSession }\n\t\t\t\t\t| { error: { code: string; message: string } };\n\n\t\t\t\tif (!res.ok) {\n\t\t\t\t\tconst errBody = json as { error: { code: string; message: string } };\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror: errBody.error?.message ?? `Sign-up failed (${res.status})`,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst okBody = json as { data: KavachSession };\n\t\t\t\tsetSession(okBody.data);\n\t\t\t\treturn { success: true, data: undefined };\n\t\t\t} catch (err) {\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: err instanceof Error ? err.message : \"Network error\",\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\t[base],\n\t);\n\n\tconst signOut = useCallback(async (): Promise<void> => {\n\t\ttry {\n\t\t\tawait fetch(`${base}/sign-out`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tcredentials: \"include\",\n\t\t\t});\n\t\t} finally {\n\t\t\tsetSession(null);\n\t\t}\n\t}, [base]);\n\n\tconst user: KavachUser | null = session?.user ?? null;\n\n\tconst value: KavachContextValue = {\n\t\tsession,\n\t\tuser,\n\t\tisLoading,\n\t\tisAuthenticated: session !== null,\n\t\tsignIn,\n\t\tsignUp,\n\t\tsignOut,\n\t\trefresh,\n\t};\n\n\treturn <KavachContext.Provider value={value}>{children}</KavachContext.Provider>;\n}\n","import { useCallback, useContext, useState } from \"react\";\nimport { KavachContext } from \"./context.js\";\nimport type { ActionResult, CreateAgentInput, KavachAgent } from \"./types.js\";\n\n// ─── Guards ────────────────────────────────────────────────────────────────────\n\nfunction useRequiredContext(hookName: string) {\n\tconst ctx = useContext(KavachContext);\n\tif (!ctx) {\n\t\tthrow new Error(`${hookName} must be used inside <KavachProvider>`);\n\t}\n\treturn ctx;\n}\n\n// ─── useSession ───────────────────────────────────────────────────────────────\n\n/**\n * Returns the current session, loading state, and a manual refresh function.\n */\nexport function useSession() {\n\tconst { session, isLoading, refresh } = useRequiredContext(\"useSession\");\n\treturn { session, isLoading, refresh };\n}\n\n// ─── useUser ──────────────────────────────────────────────────────────────────\n\n/**\n * Returns the current user, loading state, and authentication status.\n */\nexport function useUser() {\n\tconst { user, isLoading, isAuthenticated } = useRequiredContext(\"useUser\");\n\treturn { user, isLoading, isAuthenticated };\n}\n\n// ─── useSignIn ────────────────────────────────────────────────────────────────\n\n/**\n * Returns a signIn function plus local loading and error state.\n */\nexport function useSignIn() {\n\tconst { signIn } = useRequiredContext(\"useSignIn\");\n\tconst [isLoading, setIsLoading] = useState(false);\n\tconst [error, setError] = useState<string | null>(null);\n\n\tconst execute = useCallback(\n\t\tasync (email: string, password: string): Promise<ActionResult> => {\n\t\t\tsetIsLoading(true);\n\t\t\tsetError(null);\n\t\t\tconst result = await signIn(email, password);\n\t\t\tif (!result.success) {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t\treturn result;\n\t\t},\n\t\t[signIn],\n\t);\n\n\treturn { signIn: execute, isLoading, error };\n}\n\n// ─── useSignUp ────────────────────────────────────────────────────────────────\n\n/**\n * Returns a signUp function plus local loading and error state.\n */\nexport function useSignUp() {\n\tconst { signUp } = useRequiredContext(\"useSignUp\");\n\tconst [isLoading, setIsLoading] = useState(false);\n\tconst [error, setError] = useState<string | null>(null);\n\n\tconst execute = useCallback(\n\t\tasync (email: string, password: string, name?: string): Promise<ActionResult> => {\n\t\t\tsetIsLoading(true);\n\t\t\tsetError(null);\n\t\t\tconst result = await signUp(email, password, name);\n\t\t\tif (!result.success) {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t\treturn result;\n\t\t},\n\t\t[signUp],\n\t);\n\n\treturn { signUp: execute, isLoading, error };\n}\n\n// ─── useSignOut ───────────────────────────────────────────────────────────────\n\n/**\n * Returns a signOut function.\n */\nexport function useSignOut() {\n\tconst { signOut } = useRequiredContext(\"useSignOut\");\n\treturn { signOut };\n}\n\n// ─── useAgents ────────────────────────────────────────────────────────────────\n\ninterface AgentApiResponse {\n\tdata: KavachAgent[];\n}\n\ninterface AgentSingleApiResponse {\n\tdata: KavachAgent;\n}\n\ninterface ApiErrorResponse {\n\terror: {\n\t\tcode: string;\n\t\tmessage: string;\n\t};\n}\n\nfunction extractError(body: unknown, fallback: string): string {\n\tif (\n\t\tbody !== null &&\n\t\ttypeof body === \"object\" &&\n\t\t\"error\" in body &&\n\t\tbody.error !== null &&\n\t\ttypeof body.error === \"object\" &&\n\t\t\"message\" in body.error &&\n\t\ttypeof (body as ApiErrorResponse).error.message === \"string\"\n\t) {\n\t\treturn (body as ApiErrorResponse).error.message;\n\t}\n\treturn fallback;\n}\n\n/**\n * Manages agent identity records for a given user.\n *\n * Fetches the agent list and exposes create, revoke, and rotate helpers.\n * All mutations refresh the list automatically.\n */\nexport function useAgents(basePath = \"/api/kavach\") {\n\tconst { user } = useRequiredContext(\"useAgents\");\n\tconst base = basePath.replace(/\\/$/, \"\");\n\n\tconst [agents, setAgents] = useState<KavachAgent[]>([]);\n\tconst [isLoading, setIsLoading] = useState(false);\n\tconst [error, setError] = useState<string | null>(null);\n\n\tconst load = useCallback(async (): Promise<void> => {\n\t\tif (!user) {\n\t\t\tsetAgents([]);\n\t\t\treturn;\n\t\t}\n\t\tsetIsLoading(true);\n\t\tsetError(null);\n\t\ttry {\n\t\t\tconst res = await fetch(`${base}/agents?userId=${encodeURIComponent(user.id)}`, {\n\t\t\t\tcredentials: \"include\",\n\t\t\t});\n\t\t\tconst json: unknown = await res.json();\n\t\t\tif (!res.ok) {\n\t\t\t\tsetError(extractError(json, `Failed to load agents (${res.status})`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsetAgents((json as AgentApiResponse).data);\n\t\t} catch (err) {\n\t\t\tsetError(err instanceof Error ? err.message : \"Network error\");\n\t\t} finally {\n\t\t\tsetIsLoading(false);\n\t\t}\n\t}, [base, user]);\n\n\t// Load once when user is available\n\tconst [loaded, setLoaded] = useState(false);\n\tif (user && !loaded) {\n\t\tsetLoaded(true);\n\t\t// Use a microtask to avoid calling setState during render\n\t\tvoid Promise.resolve().then(load);\n\t}\n\tif (!user && loaded) {\n\t\tsetLoaded(false);\n\t\tsetAgents([]);\n\t}\n\n\tconst create = useCallback(\n\t\tasync (input: CreateAgentInput): Promise<ActionResult<KavachAgent>> => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(`${base}/agents`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tcredentials: \"include\",\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t\tbody: JSON.stringify(input),\n\t\t\t\t});\n\t\t\t\tconst json: unknown = await res.json();\n\t\t\t\tif (!res.ok) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror: extractError(json, `Failed to create agent (${res.status})`),\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst agent = (json as AgentSingleApiResponse).data;\n\t\t\t\tawait load();\n\t\t\t\treturn { success: true, data: agent };\n\t\t\t} catch (err) {\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: err instanceof Error ? err.message : \"Network error\",\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\t[base, load],\n\t);\n\n\tconst revoke = useCallback(\n\t\tasync (agentId: string): Promise<ActionResult> => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(`${base}/agents/${encodeURIComponent(agentId)}`, {\n\t\t\t\t\tmethod: \"DELETE\",\n\t\t\t\t\tcredentials: \"include\",\n\t\t\t\t});\n\t\t\t\tif (!res.ok && res.status !== 204) {\n\t\t\t\t\tconst json: unknown = await res.json().catch(() => null);\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror: extractError(json, `Failed to revoke agent (${res.status})`),\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tawait load();\n\t\t\t\treturn { success: true, data: undefined };\n\t\t\t} catch (err) {\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: err instanceof Error ? err.message : \"Network error\",\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\t[base, load],\n\t);\n\n\tconst rotate = useCallback(\n\t\tasync (agentId: string): Promise<ActionResult<KavachAgent>> => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(`${base}/agents/${encodeURIComponent(agentId)}/rotate`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tcredentials: \"include\",\n\t\t\t\t});\n\t\t\t\tconst json: unknown = await res.json();\n\t\t\t\tif (!res.ok) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror: extractError(json, `Failed to rotate agent token (${res.status})`),\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst agent = (json as AgentSingleApiResponse).data;\n\t\t\t\tawait load();\n\t\t\t\treturn { success: true, data: agent };\n\t\t\t} catch (err) {\n\t\t\t\treturn {\n\t\t\t\t\tsuccess: false,\n\t\t\t\t\terror: err instanceof Error ? err.message : \"Network error\",\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\t[base, load],\n\t);\n\n\treturn { agents, isLoading, error, load, create, revoke, rotate };\n}\n"],"mappings":"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","names":["useCallback","useContext","useState","useContext","useState","useCallback"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@kavachos/react",
+  "version": "0.0.3",
+  "description": "React hooks for KavachOS auth",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "author": "KavachOS <hello@kavachos.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kavachos/kavachos.git",
+    "directory": "packages/react"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "react": "^19.0.0",
+    "@types/react": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}