@23blocks/react 0.1.0

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './lib/index.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './lib/index.js';\n"],"names":[],"rangeMappings":"","mappings":"AAAA,cAAc,iBAAiB"}

package/dist/lib/context.js

@@ -0,0 +1,86 @@
+import { createContext, useContext, useMemo } from 'react';
+import { createAuthenticationBlock } from '@23blocks/block-authentication';
+import { createSearchBlock } from '@23blocks/block-search';
+// ─────────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────────
+const Blocks23ContextInternal = /*#__PURE__*/ createContext(null);
+// ─────────────────────────────────────────────────────────────────────────────
+// Provider Component
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Provider component for 23blocks services.
+ *
+ * @example
+ * ```tsx
+ * import { Blocks23Provider } from '@23blocks/react';
+ * import { createHttpTransport } from '@23blocks/transport-http';
+ *
+ * const transport = createHttpTransport({
+ *   baseUrl: 'https://api.example.com',
+ *   headers: () => ({
+ *     'Authorization': `Bearer ${localStorage.getItem('token')}`,
+ *   }),
+ * });
+ *
+ * function App() {
+ *   return (
+ *     <Blocks23Provider
+ *       transport={transport}
+ *       authentication={{ appId: 'my-app' }}
+ *       search={{ appId: 'my-app' }}
+ *     >
+ *       <MyApp />
+ *     </Blocks23Provider>
+ *   );
+ * }
+ * ```
+ */ export function Blocks23Provider({ children, transport, authentication, search }) {
+    const value = useMemo(()=>({
+            transport,
+            authentication: authentication ? createAuthenticationBlock(transport, authentication) : null,
+            search: search ? createSearchBlock(transport, search) : null
+        }), [
+        transport,
+        authentication,
+        search
+    ]);
+    return /*#__PURE__*/ React.createElement(Blocks23ContextInternal.Provider, {
+        value: value
+    }, children);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Context Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook to access the 23blocks context.
+ * Use this for low-level access to blocks.
+ */ export function use23Blocks() {
+    const context = useContext(Blocks23ContextInternal);
+    if (!context) {
+        throw new Error('use23Blocks must be used within a Blocks23Provider');
+    }
+    return context;
+}
+/**
+ * Hook to access the Authentication block.
+ * Throws if authentication was not configured in the provider.
+ */ export function useAuthenticationBlock() {
+    const { authentication } = use23Blocks();
+    if (!authentication) {
+        throw new Error('Authentication block not configured. Pass `authentication` prop to Blocks23Provider.');
+    }
+    return authentication;
+}
+/**
+ * Hook to access the Search block.
+ * Throws if search was not configured in the provider.
+ */ export function useSearchBlock() {
+    const { search } = use23Blocks();
+    if (!search) {
+        throw new Error('Search block not configured. Pass `search` prop to Blocks23Provider.');
+    }
+    return search;
+}
+
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/context.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport type { Transport } from '@23blocks/contracts';\nimport {\n  createAuthenticationBlock,\n  type AuthenticationBlock,\n  type AuthenticationBlockConfig,\n} from '@23blocks/block-authentication';\nimport {\n  createSearchBlock,\n  type SearchBlock,\n  type SearchBlockConfig,\n} from '@23blocks/block-search';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Context Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface Blocks23Context {\n  transport: Transport;\n  authentication: AuthenticationBlock | null;\n  search: SearchBlock | null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Context\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst Blocks23ContextInternal = createContext<Blocks23Context | null>(null);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Props\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface Blocks23ProviderProps {\n  children: ReactNode;\n\n  /**\n   * The transport instance (e.g., from createHttpTransport)\n   */\n  transport: Transport;\n\n  /**\n   * Authentication block configuration (optional)\n   */\n  authentication?: AuthenticationBlockConfig;\n\n  /**\n   * Search block configuration (optional)\n   */\n  search?: SearchBlockConfig;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Component\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Provider component for 23blocks services.\n *\n * @example\n * ```tsx\n * import { Blocks23Provider } from '@23blocks/react';\n * import { createHttpTransport } from '@23blocks/transport-http';\n *\n * const transport = createHttpTransport({\n *   baseUrl: 'https://api.example.com',\n *   headers: () => ({\n *     'Authorization': `Bearer ${localStorage.getItem('token')}`,\n *   }),\n * });\n *\n * function App() {\n *   return (\n *     <Blocks23Provider\n *       transport={transport}\n *       authentication={{ appId: 'my-app' }}\n *       search={{ appId: 'my-app' }}\n *     >\n *       <MyApp />\n *     </Blocks23Provider>\n *   );\n * }\n * ```\n */\nexport function Blocks23Provider({\n  children,\n  transport,\n  authentication,\n  search,\n}: Blocks23ProviderProps) {\n  const value = useMemo<Blocks23Context>(() => ({\n    transport,\n    authentication: authentication\n      ? createAuthenticationBlock(transport, authentication)\n      : null,\n    search: search\n      ? createSearchBlock(transport, search)\n      : null,\n  }), [transport, authentication, search]);\n\n  return (\n    <Blocks23ContextInternal.Provider value={value}>\n      {children}\n    </Blocks23ContextInternal.Provider>\n  );\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Context Hook\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Hook to access the 23blocks context.\n * Use this for low-level access to blocks.\n */\nexport function use23Blocks(): Blocks23Context {\n  const context = useContext(Blocks23ContextInternal);\n  if (!context) {\n    throw new Error('use23Blocks must be used within a Blocks23Provider');\n  }\n  return context;\n}\n\n/**\n * Hook to access the Authentication block.\n * Throws if authentication was not configured in the provider.\n */\nexport function useAuthenticationBlock(): AuthenticationBlock {\n  const { authentication } = use23Blocks();\n  if (!authentication) {\n    throw new Error(\n      'Authentication block not configured. Pass `authentication` prop to Blocks23Provider.'\n    );\n  }\n  return authentication;\n}\n\n/**\n * Hook to access the Search block.\n * Throws if search was not configured in the provider.\n */\nexport function useSearchBlock(): SearchBlock {\n  const { search } = use23Blocks();\n  if (!search) {\n    throw new Error(\n      'Search block not configured. Pass `search` prop to Blocks23Provider.'\n    );\n  }\n  return search;\n}\n"],"names":["createContext","useContext","useMemo","createAuthenticationBlock","createSearchBlock","Blocks23ContextInternal","Blocks23Provider","children","transport","authentication","search","value","Provider","use23Blocks","context","Error","useAuthenticationBlock","useSearchBlock"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAwB,QAAQ;AAE3E,SACEC,yBAAyB,QAGpB,iCAAiC;AACxC,SACEC,iBAAiB,QAGZ,yBAAyB;AAYhC,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAMC,wCAA0BL,cAAsC;AAyBtE,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,OAAO,SAASM,iBAAiB,EAC/BC,QAAQ,EACRC,SAAS,EACTC,cAAc,EACdC,MAAM,EACgB;IACtB,MAAMC,QAAQT,QAAyB,IAAO,CAAA;YAC5CM;YACAC,gBAAgBA,iBACZN,0BAA0BK,WAAWC,kBACrC;YACJC,QAAQA,SACJN,kBAAkBI,WAAWE,UAC7B;QACN,CAAA,GAAI;QAACF;QAAWC;QAAgBC;KAAO;IAEvC,qBACE,oBAACL,wBAAwBO,QAAQ;QAACD,OAAOA;OACtCJ;AAGP;AAEA,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;CAGC,GACD,OAAO,SAASM;IACd,MAAMC,UAAUb,WAAWI;IAC3B,IAAI,CAACS,SAAS;QACZ,MAAM,IAAIC,MAAM;IAClB;IACA,OAAOD;AACT;AAEA;;;CAGC,GACD,OAAO,SAASE;IACd,MAAM,EAAEP,cAAc,EAAE,GAAGI;IAC3B,IAAI,CAACJ,gBAAgB;QACnB,MAAM,IAAIM,MACR;IAEJ;IACA,OAAON;AACT;AAEA;;;CAGC,GACD,OAAO,SAASQ;IACd,MAAM,EAAEP,MAAM,EAAE,GAAGG;IACnB,IAAI,CAACH,QAAQ;QACX,MAAM,IAAIK,MACR;IAEJ;IACA,OAAOL;AACT"}

package/dist/lib/hooks/index.js

@@ -0,0 +1,8 @@
+// Authentication hooks
+export { useAuth } from './use-auth.js';
+export { useUsers } from './use-users.js';
+// Search hooks
+export { useSearch } from './use-search.js';
+export { useFavorites } from './use-favorites.js';
+
+//# sourceMappingURL=index.js.map

package/dist/lib/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/hooks/index.ts"],"sourcesContent":["// Authentication hooks\nexport { useAuth, type UseAuthReturn, type UseAuthState, type UseAuthActions } from './use-auth.js';\nexport { useUsers, type UseUsersReturn, type UseUsersState, type UseUsersActions } from './use-users.js';\n\n// Search hooks\nexport { useSearch, type UseSearchReturn, type UseSearchState, type UseSearchActions } from './use-search.js';\nexport { useFavorites, type UseFavoritesReturn, type UseFavoritesState, type UseFavoritesActions } from './use-favorites.js';\n"],"names":["useAuth","useUsers","useSearch","useFavorites"],"rangeMappings":";;;;;","mappings":"AAAA,uBAAuB;AACvB,SAASA,OAAO,QAAoE,gBAAgB;AACpG,SAASC,QAAQ,QAAuE,iBAAiB;AAEzG,eAAe;AACf,SAASC,SAAS,QAA0E,kBAAkB;AAC9G,SAASC,YAAY,QAAmF,qBAAqB"}

package/dist/lib/hooks/use-auth.js

@@ -0,0 +1,159 @@
+import { useState, useCallback } from 'react';
+import { useAuthenticationBlock } from '../context.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for authentication operations with state management.
+ *
+ * @example
+ * ```tsx
+ * function LoginForm() {
+ *   const { signIn, isLoading, error, user } = useAuth();
+ *
+ *   const handleSubmit = async (e: FormEvent) => {
+ *     e.preventDefault();
+ *     try {
+ *       await signIn({ email, password });
+ *       navigate('/dashboard');
+ *     } catch (err) {
+ *       // Error is automatically captured in `error` state
+ *     }
+ *   };
+ *
+ *   if (user) {
+ *     return <p>Welcome, {user.email}!</p>;
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {error && <p className="error">{error.message}</p>}
+ *       <button disabled={isLoading}>
+ *         {isLoading ? 'Signing in...' : 'Sign In'}
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */ export function useAuth() {
+    const block = useAuthenticationBlock();
+    const [user, setUser] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const signIn = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await block.auth.signIn(request);
+            setUser(response.user);
+            return response;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const signUp = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await block.auth.signUp(request);
+            setUser(response.user);
+            return response;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const signOut = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.auth.signOut();
+            setUser(null);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const requestPasswordReset = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.auth.requestPasswordReset(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const updatePassword = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.auth.updatePassword(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const refreshUser = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const currentUser = await block.auth.getCurrentUser();
+            setUser(currentUser);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        // State
+        user,
+        isLoading,
+        error,
+        isAuthenticated: user !== null,
+        // Actions
+        signIn,
+        signUp,
+        signOut,
+        requestPasswordReset,
+        updatePassword,
+        refreshUser,
+        clearError
+    };
+}
+
+//# sourceMappingURL=use-auth.js.map

package/dist/lib/hooks/use-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/hooks/use-auth.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\nimport type {\n  User,\n  SignInRequest,\n  SignInResponse,\n  SignUpRequest,\n  SignUpResponse,\n  PasswordResetRequest,\n  PasswordUpdateRequest,\n} from '@23blocks/block-authentication';\nimport { useAuthenticationBlock } from '../context.js';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface UseAuthState {\n  user: User | null;\n  isLoading: boolean;\n  error: Error | null;\n  isAuthenticated: boolean;\n}\n\nexport interface UseAuthActions {\n  signIn: (request: SignInRequest) => Promise<SignInResponse>;\n  signUp: (request: SignUpRequest) => Promise<SignUpResponse>;\n  signOut: () => Promise<void>;\n  requestPasswordReset: (request: PasswordResetRequest) => Promise<void>;\n  updatePassword: (request: PasswordUpdateRequest) => Promise<void>;\n  refreshUser: () => Promise<void>;\n  clearError: () => void;\n}\n\nexport type UseAuthReturn = UseAuthState & UseAuthActions;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Hook\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Hook for authentication operations with state management.\n *\n * @example\n * ```tsx\n * function LoginForm() {\n *   const { signIn, isLoading, error, user } = useAuth();\n *\n *   const handleSubmit = async (e: FormEvent) => {\n *     e.preventDefault();\n *     try {\n *       await signIn({ email, password });\n *       navigate('/dashboard');\n *     } catch (err) {\n *       // Error is automatically captured in `error` state\n *     }\n *   };\n *\n *   if (user) {\n *     return <p>Welcome, {user.email}!</p>;\n *   }\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       {error && <p className=\"error\">{error.message}</p>}\n *       <button disabled={isLoading}>\n *         {isLoading ? 'Signing in...' : 'Sign In'}\n *       </button>\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n  const block = useAuthenticationBlock();\n\n  const [user, setUser] = useState<User | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const signIn = useCallback(async (request: SignInRequest): Promise<SignInResponse> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const response = await block.auth.signIn(request);\n      setUser(response.user);\n      return response;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.auth]);\n\n  const signUp = useCallback(async (request: SignUpRequest): Promise<SignUpResponse> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const response = await block.auth.signUp(request);\n      setUser(response.user);\n      return response;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.auth]);\n\n  const signOut = useCallback(async (): Promise<void> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await block.auth.signOut();\n      setUser(null);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.auth]);\n\n  const requestPasswordReset = useCallback(async (request: PasswordResetRequest): Promise<void> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await block.auth.requestPasswordReset(request);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.auth]);\n\n  const updatePassword = useCallback(async (request: PasswordUpdateRequest): Promise<void> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await block.auth.updatePassword(request);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.auth]);\n\n  const refreshUser = useCallback(async (): Promise<void> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const currentUser = await block.auth.getCurrentUser();\n      setUser(currentUser);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.auth]);\n\n  const clearError = useCallback(() => {\n    setError(null);\n  }, []);\n\n  return {\n    // State\n    user,\n    isLoading,\n    error,\n    isAuthenticated: user !== null,\n\n    // Actions\n    signIn,\n    signUp,\n    signOut,\n    requestPasswordReset,\n    updatePassword,\n    refreshUser,\n    clearError,\n  };\n}\n"],"names":["useState","useCallback","useAuthenticationBlock","useAuth","block","user","setUser","isLoading","setIsLoading","error","setError","signIn","request","response","auth","err","Error","String","signUp","signOut","requestPasswordReset","updatePassword","refreshUser","currentUser","getCurrentUser","clearError","isAuthenticated"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,QAAQ,EAAEC,WAAW,QAAQ,QAAQ;AAU9C,SAASC,sBAAsB,QAAQ,gBAAgB;AAyBvD,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCC,GACD,OAAO,SAASC;IACd,MAAMC,QAAQF;IAEd,MAAM,CAACG,MAAMC,QAAQ,GAAGN,SAAsB;IAC9C,MAAM,CAACO,WAAWC,aAAa,GAAGR,SAAS;IAC3C,MAAM,CAACS,OAAOC,SAAS,GAAGV,SAAuB;IAEjD,MAAMW,SAASV,YAAY,OAAOW;QAChCJ,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMG,WAAW,MAAMT,MAAMU,IAAI,CAACH,MAAM,CAACC;YACzCN,QAAQO,SAASR,IAAI;YACrB,OAAOQ;QACT,EAAE,OAAOE,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMU,IAAI;KAAC;IAEf,MAAMI,SAASjB,YAAY,OAAOW;QAChCJ,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMG,WAAW,MAAMT,MAAMU,IAAI,CAACI,MAAM,CAACN;YACzCN,QAAQO,SAASR,IAAI;YACrB,OAAOQ;QACT,EAAE,OAAOE,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMU,IAAI;KAAC;IAEf,MAAMK,UAAUlB,YAAY;QAC1BO,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMN,MAAMU,IAAI,CAACK,OAAO;YACxBb,QAAQ;QACV,EAAE,OAAOS,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMU,IAAI;KAAC;IAEf,MAAMM,uBAAuBnB,YAAY,OAAOW;QAC9CJ,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMN,MAAMU,IAAI,CAACM,oBAAoB,CAACR;QACxC,EAAE,OAAOG,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMU,IAAI;KAAC;IAEf,MAAMO,iBAAiBpB,YAAY,OAAOW;QACxCJ,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMN,MAAMU,IAAI,CAACO,cAAc,CAACT;QAClC,EAAE,OAAOG,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMU,IAAI;KAAC;IAEf,MAAMQ,cAAcrB,YAAY;QAC9BO,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMa,cAAc,MAAMnB,MAAMU,IAAI,CAACU,cAAc;YACnDlB,QAAQiB;QACV,EAAE,OAAOR,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMU,IAAI;KAAC;IAEf,MAAMW,aAAaxB,YAAY;QAC7BS,SAAS;IACX,GAAG,EAAE;IAEL,OAAO;QACL,QAAQ;QACRL;QACAE;QACAE;QACAiB,iBAAiBrB,SAAS;QAE1B,UAAU;QACVM;QACAO;QACAC;QACAC;QACAC;QACAC;QACAG;IACF;AACF"}

package/dist/lib/hooks/use-favorites.js

@@ -0,0 +1,114 @@
+import { useState, useCallback } from 'react';
+import { useSearchBlock } from '../context.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for managing favorites.
+ *
+ * @example
+ * ```tsx
+ * function FavoritesList() {
+ *   const { favorites, listFavorites, removeFavorite, isLoading } = useFavorites();
+ *
+ *   useEffect(() => {
+ *     listFavorites();
+ *   }, [listFavorites]);
+ *
+ *   return (
+ *     <ul>
+ *       {favorites.map(fav => (
+ *         <li key={fav.id}>
+ *           {fav.entityDescription}
+ *           <button onClick={() => removeFavorite(fav.id)}>Remove</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */ export function useFavorites() {
+    const block = useSearchBlock();
+    const [favorites, setFavorites] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const listFavorites = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.favorites.list();
+            setFavorites(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.favorites
+    ]);
+    const addFavorite = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const favorite = await block.favorites.add(request);
+            setFavorites((prev)=>[
+                    ...prev,
+                    favorite
+                ]);
+            return favorite;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.favorites
+    ]);
+    const removeFavorite = useCallback(async (id)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.favorites.remove(id);
+            setFavorites((prev)=>prev.filter((f)=>f.id !== id));
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.favorites
+    ]);
+    const isFavorite = useCallback(async (entityUniqueId)=>{
+        try {
+            return await block.favorites.isFavorite(entityUniqueId);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        }
+    }, [
+        block.favorites
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        favorites,
+        isLoading,
+        error,
+        listFavorites,
+        addFavorite,
+        removeFavorite,
+        isFavorite,
+        clearError
+    };
+}
+
+//# sourceMappingURL=use-favorites.js.map

package/dist/lib/hooks/use-favorites.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/hooks/use-favorites.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\nimport type {\n  FavoriteEntity,\n  AddFavoriteRequest,\n} from '@23blocks/block-search';\nimport { useSearchBlock } from '../context.js';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface UseFavoritesState {\n  favorites: FavoriteEntity[];\n  isLoading: boolean;\n  error: Error | null;\n}\n\nexport interface UseFavoritesActions {\n  listFavorites: () => Promise<FavoriteEntity[]>;\n  addFavorite: (request: AddFavoriteRequest) => Promise<FavoriteEntity>;\n  removeFavorite: (id: string) => Promise<void>;\n  isFavorite: (entityUniqueId: string) => Promise<boolean>;\n  clearError: () => void;\n}\n\nexport type UseFavoritesReturn = UseFavoritesState & UseFavoritesActions;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Hook\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Hook for managing favorites.\n *\n * @example\n * ```tsx\n * function FavoritesList() {\n *   const { favorites, listFavorites, removeFavorite, isLoading } = useFavorites();\n *\n *   useEffect(() => {\n *     listFavorites();\n *   }, [listFavorites]);\n *\n *   return (\n *     <ul>\n *       {favorites.map(fav => (\n *         <li key={fav.id}>\n *           {fav.entityDescription}\n *           <button onClick={() => removeFavorite(fav.id)}>Remove</button>\n *         </li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useFavorites(): UseFavoritesReturn {\n  const block = useSearchBlock();\n\n  const [favorites, setFavorites] = useState<FavoriteEntity[]>([]);\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const listFavorites = useCallback(async (): Promise<FavoriteEntity[]> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const result = await block.favorites.list();\n      setFavorites(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.favorites]);\n\n  const addFavorite = useCallback(async (\n    request: AddFavoriteRequest\n  ): Promise<FavoriteEntity> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const favorite = await block.favorites.add(request);\n      setFavorites(prev => [...prev, favorite]);\n      return favorite;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.favorites]);\n\n  const removeFavorite = useCallback(async (id: string): Promise<void> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await block.favorites.remove(id);\n      setFavorites(prev => prev.filter(f => f.id !== id));\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.favorites]);\n\n  const isFavorite = useCallback(async (entityUniqueId: string): Promise<boolean> => {\n    try {\n      return await block.favorites.isFavorite(entityUniqueId);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    }\n  }, [block.favorites]);\n\n  const clearError = useCallback(() => {\n    setError(null);\n  }, []);\n\n  return {\n    favorites,\n    isLoading,\n    error,\n    listFavorites,\n    addFavorite,\n    removeFavorite,\n    isFavorite,\n    clearError,\n  };\n}\n"],"names":["useState","useCallback","useSearchBlock","useFavorites","block","favorites","setFavorites","isLoading","setIsLoading","error","setError","listFavorites","result","list","err","Error","String","addFavorite","request","favorite","add","prev","removeFavorite","id","remove","filter","f","isFavorite","entityUniqueId","clearError"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,QAAQ,EAAEC,WAAW,QAAQ,QAAQ;AAK9C,SAASC,cAAc,QAAQ,gBAAgB;AAsB/C,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC;IACd,MAAMC,QAAQF;IAEd,MAAM,CAACG,WAAWC,aAAa,GAAGN,SAA2B,EAAE;IAC/D,MAAM,CAACO,WAAWC,aAAa,GAAGR,SAAS;IAC3C,MAAM,CAACS,OAAOC,SAAS,GAAGV,SAAuB;IAEjD,MAAMW,gBAAgBV,YAAY;QAChCO,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAME,SAAS,MAAMR,MAAMC,SAAS,CAACQ,IAAI;YACzCP,aAAaM;YACb,OAAOA;QACT,EAAE,OAAOE,KAAK;YACZ,MAAML,QAAQK,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DJ,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,SAAS;KAAC;IAEpB,MAAMY,cAAchB,YAAY,OAC9BiB;QAEAV,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMS,WAAW,MAAMf,MAAMC,SAAS,CAACe,GAAG,CAACF;YAC3CZ,aAAae,CAAAA,OAAQ;uBAAIA;oBAAMF;iBAAS;YACxC,OAAOA;QACT,EAAE,OAAOL,KAAK;YACZ,MAAML,QAAQK,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DJ,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,SAAS;KAAC;IAEpB,MAAMiB,iBAAiBrB,YAAY,OAAOsB;QACxCf,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMN,MAAMC,SAAS,CAACmB,MAAM,CAACD;YAC7BjB,aAAae,CAAAA,OAAQA,KAAKI,MAAM,CAACC,CAAAA,IAAKA,EAAEH,EAAE,KAAKA;QACjD,EAAE,OAAOT,KAAK;YACZ,MAAML,QAAQK,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DJ,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,SAAS;KAAC;IAEpB,MAAMsB,aAAa1B,YAAY,OAAO2B;QACpC,IAAI;YACF,OAAO,MAAMxB,MAAMC,SAAS,CAACsB,UAAU,CAACC;QAC1C,EAAE,OAAOd,KAAK;YACZ,MAAML,QAAQK,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DJ,SAASD;YACT,MAAMA;QACR;IACF,GAAG;QAACL,MAAMC,SAAS;KAAC;IAEpB,MAAMwB,aAAa5B,YAAY;QAC7BS,SAAS;IACX,GAAG,EAAE;IAEL,OAAO;QACLL;QACAE;QACAE;QACAE;QACAM;QACAK;QACAK;QACAE;IACF;AACF"}

package/dist/lib/hooks/use-search.js

@@ -0,0 +1,120 @@
+import { useState, useCallback } from 'react';
+import { useSearchBlock } from '../context.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for search operations with state management.
+ *
+ * @example
+ * ```tsx
+ * function SearchPage() {
+ *   const { results, search, isLoading, query } = useSearch();
+ *   const [inputValue, setInputValue] = useState('');
+ *
+ *   const handleSearch = async (e: FormEvent) => {
+ *     e.preventDefault();
+ *     await search({ query: inputValue });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <form onSubmit={handleSearch}>
+ *         <input
+ *           value={inputValue}
+ *           onChange={(e) => setInputValue(e.target.value)}
+ *           placeholder="Search..."
+ *         />
+ *         <button disabled={isLoading}>Search</button>
+ *       </form>
+ *
+ *       {query && <p>Results for: {query}</p>}
+ *
+ *       <ul>
+ *         {results.map(result => (
+ *           <li key={result.id}>{result.entityDescription}</li>
+ *         ))}
+ *       </ul>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */ export function useSearch() {
+    const block = useSearchBlock();
+    const [results, setResults] = useState([]);
+    const [totalRecords, setTotalRecords] = useState(0);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [query, setQuery] = useState('');
+    const search = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        setQuery(request.query);
+        try {
+            const response = await block.search.search(request);
+            setResults(response.results);
+            setTotalRecords(response.totalRecords);
+            return response;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.search
+    ]);
+    const suggest = useCallback(async (query, limit)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.search.suggest(query, limit);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.search
+    ]);
+    const getEntityTypes = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.search.entityTypes();
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.search
+    ]);
+    const clearResults = useCallback(()=>{
+        setResults([]);
+        setTotalRecords(0);
+        setQuery('');
+    }, []);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        results,
+        totalRecords,
+        isLoading,
+        error,
+        query,
+        search,
+        suggest,
+        getEntityTypes,
+        clearResults,
+        clearError
+    };
+}
+
+//# sourceMappingURL=use-search.js.map

package/dist/lib/hooks/use-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/hooks/use-search.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\nimport type {\n  SearchResult,\n  SearchRequest,\n  SearchResponse,\n  EntityType,\n} from '@23blocks/block-search';\nimport { useSearchBlock } from '../context.js';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface UseSearchState {\n  results: SearchResult[];\n  totalRecords: number;\n  isLoading: boolean;\n  error: Error | null;\n  query: string;\n}\n\nexport interface UseSearchActions {\n  search: (request: SearchRequest) => Promise<SearchResponse>;\n  suggest: (query: string, limit?: number) => Promise<SearchResult[]>;\n  getEntityTypes: () => Promise<EntityType[]>;\n  clearResults: () => void;\n  clearError: () => void;\n}\n\nexport type UseSearchReturn = UseSearchState & UseSearchActions;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Hook\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Hook for search operations with state management.\n *\n * @example\n * ```tsx\n * function SearchPage() {\n *   const { results, search, isLoading, query } = useSearch();\n *   const [inputValue, setInputValue] = useState('');\n *\n *   const handleSearch = async (e: FormEvent) => {\n *     e.preventDefault();\n *     await search({ query: inputValue });\n *   };\n *\n *   return (\n *     <div>\n *       <form onSubmit={handleSearch}>\n *         <input\n *           value={inputValue}\n *           onChange={(e) => setInputValue(e.target.value)}\n *           placeholder=\"Search...\"\n *         />\n *         <button disabled={isLoading}>Search</button>\n *       </form>\n *\n *       {query && <p>Results for: {query}</p>}\n *\n *       <ul>\n *         {results.map(result => (\n *           <li key={result.id}>{result.entityDescription}</li>\n *         ))}\n *       </ul>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useSearch(): UseSearchReturn {\n  const block = useSearchBlock();\n\n  const [results, setResults] = useState<SearchResult[]>([]);\n  const [totalRecords, setTotalRecords] = useState(0);\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [query, setQuery] = useState('');\n\n  const search = useCallback(async (request: SearchRequest): Promise<SearchResponse> => {\n    setIsLoading(true);\n    setError(null);\n    setQuery(request.query);\n    try {\n      const response = await block.search.search(request);\n      setResults(response.results);\n      setTotalRecords(response.totalRecords);\n      return response;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.search]);\n\n  const suggest = useCallback(async (\n    query: string,\n    limit?: number\n  ): Promise<SearchResult[]> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      return await block.search.suggest(query, limit);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.search]);\n\n  const getEntityTypes = useCallback(async (): Promise<EntityType[]> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      return await block.search.entityTypes();\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.search]);\n\n  const clearResults = useCallback(() => {\n    setResults([]);\n    setTotalRecords(0);\n    setQuery('');\n  }, []);\n\n  const clearError = useCallback(() => {\n    setError(null);\n  }, []);\n\n  return {\n    results,\n    totalRecords,\n    isLoading,\n    error,\n    query,\n    search,\n    suggest,\n    getEntityTypes,\n    clearResults,\n    clearError,\n  };\n}\n"],"names":["useState","useCallback","useSearchBlock","useSearch","block","results","setResults","totalRecords","setTotalRecords","isLoading","setIsLoading","error","setError","query","setQuery","search","request","response","err","Error","String","suggest","limit","getEntityTypes","entityTypes","clearResults","clearError"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,QAAQ,EAAEC,WAAW,QAAQ,QAAQ;AAO9C,SAASC,cAAc,QAAQ,gBAAgB;AAwB/C,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCC,GACD,OAAO,SAASC;IACd,MAAMC,QAAQF;IAEd,MAAM,CAACG,SAASC,WAAW,GAAGN,SAAyB,EAAE;IACzD,MAAM,CAACO,cAAcC,gBAAgB,GAAGR,SAAS;IACjD,MAAM,CAACS,WAAWC,aAAa,GAAGV,SAAS;IAC3C,MAAM,CAACW,OAAOC,SAAS,GAAGZ,SAAuB;IACjD,MAAM,CAACa,OAAOC,SAAS,GAAGd,SAAS;IAEnC,MAAMe,SAASd,YAAY,OAAOe;QAChCN,aAAa;QACbE,SAAS;QACTE,SAASE,QAAQH,KAAK;QACtB,IAAI;YACF,MAAMI,WAAW,MAAMb,MAAMW,MAAM,CAACA,MAAM,CAACC;YAC3CV,WAAWW,SAASZ,OAAO;YAC3BG,gBAAgBS,SAASV,YAAY;YACrC,OAAOU;QACT,EAAE,OAAOC,KAAK;YACZ,MAAMP,QAAQO,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DN,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACN,MAAMW,MAAM;KAAC;IAEjB,MAAMM,UAAUpB,YAAY,OAC1BY,OACAS;QAEAZ,aAAa;QACbE,SAAS;QACT,IAAI;YACF,OAAO,MAAMR,MAAMW,MAAM,CAACM,OAAO,CAACR,OAAOS;QAC3C,EAAE,OAAOJ,KAAK;YACZ,MAAMP,QAAQO,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DN,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACN,MAAMW,MAAM;KAAC;IAEjB,MAAMQ,iBAAiBtB,YAAY;QACjCS,aAAa;QACbE,SAAS;QACT,IAAI;YACF,OAAO,MAAMR,MAAMW,MAAM,CAACS,WAAW;QACvC,EAAE,OAAON,KAAK;YACZ,MAAMP,QAAQO,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DN,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACN,MAAMW,MAAM;KAAC;IAEjB,MAAMU,eAAexB,YAAY;QAC/BK,WAAW,EAAE;QACbE,gBAAgB;QAChBM,SAAS;IACX,GAAG,EAAE;IAEL,MAAMY,aAAazB,YAAY;QAC7BW,SAAS;IACX,GAAG,EAAE;IAEL,OAAO;QACLP;QACAE;QACAE;QACAE;QACAE;QACAE;QACAM;QACAE;QACAE;QACAC;IACF;AACF"}

package/dist/lib/hooks/use-users.js

@@ -0,0 +1,115 @@
+import { useState, useCallback } from 'react';
+import { useAuthenticationBlock } from '../context.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for user management operations.
+ *
+ * @example
+ * ```tsx
+ * function UserList() {
+ *   const { users, listUsers, isLoading, error } = useUsers();
+ *
+ *   useEffect(() => {
+ *     listUsers({ page: 1, perPage: 20 });
+ *   }, [listUsers]);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return <Error message={error.message} />;
+ *
+ *   return (
+ *     <ul>
+ *       {users.map(user => (
+ *         <li key={user.id}>{user.email}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */ export function useUsers() {
+    const block = useAuthenticationBlock();
+    const [users, setUsers] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const listUsers = useCallback(async (params)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.users.list(params);
+            setUsers(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const getUser = useCallback(async (id)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.get(id);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const updateUser = useCallback(async (id, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const updated = await block.users.update(id, request);
+            setUsers((prev)=>prev.map((u)=>u.id === id ? updated : u));
+            return updated;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const deleteUser = useCallback(async (id)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.users.delete(id);
+            setUsers((prev)=>prev.filter((u)=>u.id !== id));
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        users,
+        isLoading,
+        error,
+        listUsers,
+        getUser,
+        updateUser,
+        deleteUser,
+        clearError
+    };
+}
+
+//# sourceMappingURL=use-users.js.map

package/dist/lib/hooks/use-users.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/hooks/use-users.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\nimport type {\n  User,\n  UpdateUserRequest,\n} from '@23blocks/block-authentication';\nimport { useAuthenticationBlock } from '../context.js';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface UseUsersState {\n  users: User[];\n  isLoading: boolean;\n  error: Error | null;\n}\n\nexport interface UseUsersActions {\n  listUsers: (params?: { page?: number; perPage?: number }) => Promise<User[]>;\n  getUser: (id: string) => Promise<User>;\n  updateUser: (id: string, request: UpdateUserRequest) => Promise<User>;\n  deleteUser: (id: string) => Promise<void>;\n  clearError: () => void;\n}\n\nexport type UseUsersReturn = UseUsersState & UseUsersActions;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Hook\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Hook for user management operations.\n *\n * @example\n * ```tsx\n * function UserList() {\n *   const { users, listUsers, isLoading, error } = useUsers();\n *\n *   useEffect(() => {\n *     listUsers({ page: 1, perPage: 20 });\n *   }, [listUsers]);\n *\n *   if (isLoading) return <Spinner />;\n *   if (error) return <Error message={error.message} />;\n *\n *   return (\n *     <ul>\n *       {users.map(user => (\n *         <li key={user.id}>{user.email}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useUsers(): UseUsersReturn {\n  const block = useAuthenticationBlock();\n\n  const [users, setUsers] = useState<User[]>([]);\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const listUsers = useCallback(async (\n    params?: { page?: number; perPage?: number }\n  ): Promise<User[]> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const result = await block.users.list(params);\n      setUsers(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.users]);\n\n  const getUser = useCallback(async (id: string): Promise<User> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      return await block.users.get(id);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.users]);\n\n  const updateUser = useCallback(async (\n    id: string,\n    request: UpdateUserRequest\n  ): Promise<User> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const updated = await block.users.update(id, request);\n      setUsers(prev => prev.map(u => u.id === id ? updated : u));\n      return updated;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.users]);\n\n  const deleteUser = useCallback(async (id: string): Promise<void> => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await block.users.delete(id);\n      setUsers(prev => prev.filter(u => u.id !== id));\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, [block.users]);\n\n  const clearError = useCallback(() => {\n    setError(null);\n  }, []);\n\n  return {\n    users,\n    isLoading,\n    error,\n    listUsers,\n    getUser,\n    updateUser,\n    deleteUser,\n    clearError,\n  };\n}\n"],"names":["useState","useCallback","useAuthenticationBlock","useUsers","block","users","setUsers","isLoading","setIsLoading","error","setError","listUsers","params","result","list","err","Error","String","getUser","id","get","updateUser","request","updated","update","prev","map","u","deleteUser","delete","filter","clearError"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,QAAQ,EAAEC,WAAW,QAAQ,QAAQ;AAK9C,SAASC,sBAAsB,QAAQ,gBAAgB;AAsBvD,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC;IACd,MAAMC,QAAQF;IAEd,MAAM,CAACG,OAAOC,SAAS,GAAGN,SAAiB,EAAE;IAC7C,MAAM,CAACO,WAAWC,aAAa,GAAGR,SAAS;IAC3C,MAAM,CAACS,OAAOC,SAAS,GAAGV,SAAuB;IAEjD,MAAMW,YAAYV,YAAY,OAC5BW;QAEAJ,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMG,SAAS,MAAMT,MAAMC,KAAK,CAACS,IAAI,CAACF;YACtCN,SAASO;YACT,OAAOA;QACT,EAAE,OAAOE,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,KAAK;KAAC;IAEhB,MAAMa,UAAUjB,YAAY,OAAOkB;QACjCX,aAAa;QACbE,SAAS;QACT,IAAI;YACF,OAAO,MAAMN,MAAMC,KAAK,CAACe,GAAG,CAACD;QAC/B,EAAE,OAAOJ,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,KAAK;KAAC;IAEhB,MAAMgB,aAAapB,YAAY,OAC7BkB,IACAG;QAEAd,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMa,UAAU,MAAMnB,MAAMC,KAAK,CAACmB,MAAM,CAACL,IAAIG;YAC7ChB,SAASmB,CAAAA,OAAQA,KAAKC,GAAG,CAACC,CAAAA,IAAKA,EAAER,EAAE,KAAKA,KAAKI,UAAUI;YACvD,OAAOJ;QACT,EAAE,OAAOR,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,KAAK;KAAC;IAEhB,MAAMuB,aAAa3B,YAAY,OAAOkB;QACpCX,aAAa;QACbE,SAAS;QACT,IAAI;YACF,MAAMN,MAAMC,KAAK,CAACwB,MAAM,CAACV;YACzBb,SAASmB,CAAAA,OAAQA,KAAKK,MAAM,CAACH,CAAAA,IAAKA,EAAER,EAAE,KAAKA;QAC7C,EAAE,OAAOJ,KAAK;YACZ,MAAMN,QAAQM,eAAeC,QAAQD,MAAM,IAAIC,MAAMC,OAAOF;YAC5DL,SAASD;YACT,MAAMA;QACR,SAAU;YACRD,aAAa;QACf;IACF,GAAG;QAACJ,MAAMC,KAAK;KAAC;IAEhB,MAAM0B,aAAa9B,YAAY;QAC7BS,SAAS;IACX,GAAG,EAAE;IAEL,OAAO;QACLL;QACAE;QACAE;QACAE;QACAO;QACAG;QACAO;QACAG;IACF;AACF"}

package/dist/lib/index.js

@@ -0,0 +1,8 @@
+// Context and Provider
+export { Blocks23Provider, use23Blocks, useAuthenticationBlock, useSearchBlock } from './context.js';
+// Hooks
+export { // Auth
+useAuth, useUsers, // Search
+useSearch, useFavorites } from './hooks/index.js';
+
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/index.ts"],"sourcesContent":["// Context and Provider\nexport {\n  Blocks23Provider,\n  use23Blocks,\n  useAuthenticationBlock,\n  useSearchBlock,\n  type Blocks23ProviderProps,\n  type Blocks23Context,\n} from './context.js';\n\n// Hooks\nexport {\n  // Auth\n  useAuth,\n  useUsers,\n  type UseAuthReturn,\n  type UseAuthState,\n  type UseAuthActions,\n  type UseUsersReturn,\n  type UseUsersState,\n  type UseUsersActions,\n\n  // Search\n  useSearch,\n  useFavorites,\n  type UseSearchReturn,\n  type UseSearchState,\n  type UseSearchActions,\n  type UseFavoritesReturn,\n  type UseFavoritesState,\n  type UseFavoritesActions,\n} from './hooks/index.js';\n"],"names":["Blocks23Provider","use23Blocks","useAuthenticationBlock","useSearchBlock","useAuth","useUsers","useSearch","useFavorites"],"rangeMappings":";;;;;","mappings":"AAAA,uBAAuB;AACvB,SACEA,gBAAgB,EAChBC,WAAW,EACXC,sBAAsB,EACtBC,cAAc,QAGT,eAAe;AAEtB,QAAQ;AACR,SACE,OAAO;AACPC,OAAO,EACPC,QAAQ,EAQR,SAAS;AACTC,SAAS,EACTC,YAAY,QAOP,mBAAmB"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@23blocks/react",
+  "version": "0.1.0",
+  "description": "React bindings for 23blocks SDK - hooks and context providers",
+  "license": "MIT",
+  "author": "23blocks <hello@23blocks.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/23blocks-OS/frontend-sdk.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/23blocks-OS/frontend-sdk/tree/main/packages/react",
+  "bugs": {
+    "url": "https://github.com/23blocks-OS/frontend-sdk/issues"
+  },
+  "keywords": [
+    "23blocks",
+    "sdk",
+    "react",
+    "hooks",
+    "context",
+    "provider"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "nx": {
+    "sourceRoot": "packages/react/src",
+    "targets": {
+      "build": {
+        "executor": "@nx/js:swc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/react/dist",
+          "main": "packages/react/src/index.ts",
+          "tsConfig": "packages/react/tsconfig.lib.json",
+          "skipTypeCheck": true,
+          "stripLeadingPaths": true
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@23blocks/contracts": "*",
+    "@23blocks/block-authentication": "*",
+    "@23blocks/block-search": "*",
+    "@swc/helpers": "~0.5.11"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  }
+}