@semilayer/react 1.1.0

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { BeamClient, SearchParams, SearchResponse, SimilarParams, SimilarResponse, QueryParams, QueryResponse } from '@semilayer/client';
+
+interface SemiLayerProviderProps {
+    baseUrl: string;
+    apiKey: string;
+    children: React.ReactNode;
+}
+declare function SemiLayerProvider({ baseUrl, apiKey, children }: SemiLayerProviderProps): react_jsx_runtime.JSX.Element;
+declare function useSemiLayer(): BeamClient;
+
+interface UseSearchOptions {
+    enabled?: boolean;
+}
+interface UseSearchResult<M> {
+    data: SearchResponse<M> | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+declare function useSearch<M = Record<string, unknown>>(lens: string, params: SearchParams | null, opts?: UseSearchOptions): UseSearchResult<M>;
+
+interface UseSimilarOptions {
+    enabled?: boolean;
+}
+interface UseSimilarResult<M> {
+    data: SimilarResponse<M> | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+declare function useSimilar<M = Record<string, unknown>>(lens: string, params: SimilarParams | null, opts?: UseSimilarOptions): UseSimilarResult<M>;
+
+interface UseQueryOptions {
+    enabled?: boolean;
+}
+interface UseQueryResult<M> {
+    data: QueryResponse<M> | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+declare function useQuery<M = Record<string, unknown>>(lens: string, params?: QueryParams | null, opts?: UseQueryOptions): UseQueryResult<M>;
+
+export { SemiLayerProvider, type SemiLayerProviderProps, useQuery, useSearch, useSemiLayer, useSimilar };

package/dist/index.js

@@ -0,0 +1,126 @@
+// src/provider.tsx
+import { createContext, useContext, useMemo } from "react";
+import { BeamClient } from "@semilayer/client";
+import { jsx } from "react/jsx-runtime";
+var SemiLayerContext = createContext(null);
+function SemiLayerProvider({ baseUrl, apiKey, children }) {
+  const client = useMemo(
+    () => new BeamClient({ baseUrl, apiKey }),
+    [baseUrl, apiKey]
+  );
+  return /* @__PURE__ */ jsx(SemiLayerContext.Provider, { value: client, children });
+}
+function useSemiLayer() {
+  const client = useContext(SemiLayerContext);
+  if (!client) {
+    throw new Error("useSemiLayer must be used within a <SemiLayerProvider>");
+  }
+  return client;
+}
+
+// src/use-search.ts
+import { useState, useEffect, useCallback } from "react";
+function useSearch(lens, params, opts) {
+  const client = useSemiLayer();
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [trigger, setTrigger] = useState(0);
+  const enabled = opts?.enabled !== false;
+  const refetch = useCallback(() => setTrigger((t) => t + 1), []);
+  useEffect(() => {
+    if (!params?.query || !enabled) {
+      setData(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    client.search(lens, params).then((res) => {
+      if (!cancelled) setData(res);
+    }).catch((err) => {
+      if (!cancelled) setError(err instanceof Error ? err : new Error(String(err)));
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, lens, params?.query, params?.limit, params?.minScore, params?.mode, enabled, trigger]);
+  return { data, loading, error, refetch };
+}
+
+// src/use-similar.ts
+import { useState as useState2, useEffect as useEffect2, useCallback as useCallback2 } from "react";
+function useSimilar(lens, params, opts) {
+  const client = useSemiLayer();
+  const [data, setData] = useState2(null);
+  const [loading, setLoading] = useState2(false);
+  const [error, setError] = useState2(null);
+  const [trigger, setTrigger] = useState2(0);
+  const enabled = opts?.enabled !== false;
+  const refetch = useCallback2(() => setTrigger((t) => t + 1), []);
+  useEffect2(() => {
+    if (!params?.id || !enabled) {
+      setData(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    client.similar(lens, params).then((res) => {
+      if (!cancelled) setData(res);
+    }).catch((err) => {
+      if (!cancelled) setError(err instanceof Error ? err : new Error(String(err)));
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, lens, params?.id, params?.limit, params?.minScore, enabled, trigger]);
+  return { data, loading, error, refetch };
+}
+
+// src/use-query.ts
+import { useState as useState3, useEffect as useEffect3, useCallback as useCallback3, useRef } from "react";
+function useQuery(lens, params, opts) {
+  const client = useSemiLayer();
+  const [data, setData] = useState3(null);
+  const [loading, setLoading] = useState3(false);
+  const [error, setError] = useState3(null);
+  const [trigger, setTrigger] = useState3(0);
+  const enabled = opts?.enabled !== false;
+  const refetch = useCallback3(() => setTrigger((t) => t + 1), []);
+  const paramsRef = useRef(params);
+  const paramsKey = JSON.stringify(params ?? {});
+  paramsRef.current = params;
+  useEffect3(() => {
+    if (!enabled) {
+      setData(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    client.query(lens, paramsRef.current ?? void 0).then((res) => {
+      if (!cancelled) setData(res);
+    }).catch((err) => {
+      if (!cancelled) setError(err instanceof Error ? err : new Error(String(err)));
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, lens, paramsKey, enabled, trigger]);
+  return { data, loading, error, refetch };
+}
+export {
+  SemiLayerProvider,
+  useQuery,
+  useSearch,
+  useSemiLayer,
+  useSimilar
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.tsx","../src/use-search.ts","../src/use-similar.ts","../src/use-query.ts"],"sourcesContent":["import { createContext, useContext, useMemo } from 'react'\nimport { BeamClient } from '@semilayer/client'\n\nconst SemiLayerContext = createContext<BeamClient | null>(null)\n\nexport interface SemiLayerProviderProps {\n  baseUrl: string\n  apiKey: string\n  children: React.ReactNode\n}\n\nexport function SemiLayerProvider({ baseUrl, apiKey, children }: SemiLayerProviderProps) {\n  const client = useMemo(\n    () => new BeamClient({ baseUrl, apiKey }),\n    [baseUrl, apiKey],\n  )\n\n  return (\n    <SemiLayerContext.Provider value={client}>{children}</SemiLayerContext.Provider>\n  )\n}\n\nexport function useSemiLayer(): BeamClient {\n  const client = useContext(SemiLayerContext)\n  if (!client) {\n    throw new Error('useSemiLayer must be used within a <SemiLayerProvider>')\n  }\n  return client\n}\n","import { useState, useEffect, useCallback } from 'react'\nimport type { SearchParams, SearchResponse } from '@semilayer/client'\nimport { useSemiLayer } from './provider.js'\n\ninterface UseSearchOptions {\n  enabled?: boolean\n}\n\ninterface UseSearchResult<M> {\n  data: SearchResponse<M> | null\n  loading: boolean\n  error: Error | null\n  refetch: () => void\n}\n\nexport function useSearch<M = Record<string, unknown>>(\n  lens: string,\n  params: SearchParams | null,\n  opts?: UseSearchOptions,\n): UseSearchResult<M> {\n  const client = useSemiLayer()\n  const [data, setData] = useState<SearchResponse<M> | null>(null)\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState<Error | null>(null)\n  const [trigger, setTrigger] = useState(0)\n\n  const enabled = opts?.enabled !== false\n\n  const refetch = useCallback(() => setTrigger((t) => t + 1), [])\n\n  useEffect(() => {\n    if (!params?.query || !enabled) {\n      setData(null)\n      return\n    }\n\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    client\n      .search<M>(lens, params)\n      .then((res) => {\n        if (!cancelled) setData(res)\n      })\n      .catch((err) => {\n        if (!cancelled) setError(err instanceof Error ? err : new Error(String(err)))\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false)\n      })\n\n    return () => {\n      cancelled = true\n    }\n  }, [client, lens, params?.query, params?.limit, params?.minScore, params?.mode, enabled, trigger])\n\n  return { data, loading, error, refetch }\n}\n","import { useState, useEffect, useCallback } from 'react'\nimport type { SimilarParams, SimilarResponse } from '@semilayer/client'\nimport { useSemiLayer } from './provider.js'\n\ninterface UseSimilarOptions {\n  enabled?: boolean\n}\n\ninterface UseSimilarResult<M> {\n  data: SimilarResponse<M> | null\n  loading: boolean\n  error: Error | null\n  refetch: () => void\n}\n\nexport function useSimilar<M = Record<string, unknown>>(\n  lens: string,\n  params: SimilarParams | null,\n  opts?: UseSimilarOptions,\n): UseSimilarResult<M> {\n  const client = useSemiLayer()\n  const [data, setData] = useState<SimilarResponse<M> | null>(null)\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState<Error | null>(null)\n  const [trigger, setTrigger] = useState(0)\n\n  const enabled = opts?.enabled !== false\n\n  const refetch = useCallback(() => setTrigger((t) => t + 1), [])\n\n  useEffect(() => {\n    if (!params?.id || !enabled) {\n      setData(null)\n      return\n    }\n\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    client\n      .similar<M>(lens, params)\n      .then((res) => {\n        if (!cancelled) setData(res)\n      })\n      .catch((err) => {\n        if (!cancelled) setError(err instanceof Error ? err : new Error(String(err)))\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false)\n      })\n\n    return () => {\n      cancelled = true\n    }\n  }, [client, lens, params?.id, params?.limit, params?.minScore, enabled, trigger])\n\n  return { data, loading, error, refetch }\n}\n","import { useState, useEffect, useCallback, useRef } from 'react'\nimport type { QueryParams, QueryResponse } from '@semilayer/client'\nimport { useSemiLayer } from './provider.js'\n\ninterface UseQueryOptions {\n  enabled?: boolean\n}\n\ninterface UseQueryResult<M> {\n  data: QueryResponse<M> | null\n  loading: boolean\n  error: Error | null\n  refetch: () => void\n}\n\nexport function useQuery<M = Record<string, unknown>>(\n  lens: string,\n  params?: QueryParams | null,\n  opts?: UseQueryOptions,\n): UseQueryResult<M> {\n  const client = useSemiLayer()\n  const [data, setData] = useState<QueryResponse<M> | null>(null)\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState<Error | null>(null)\n  const [trigger, setTrigger] = useState(0)\n\n  const enabled = opts?.enabled !== false\n\n  const refetch = useCallback(() => setTrigger((t) => t + 1), [])\n\n  // Serialize params for dependency tracking\n  const paramsRef = useRef(params)\n  const paramsKey = JSON.stringify(params ?? {})\n  paramsRef.current = params\n\n  useEffect(() => {\n    if (!enabled) {\n      setData(null)\n      return\n    }\n\n    let cancelled = false\n    setLoading(true)\n    setError(null)\n\n    client\n      .query<M>(lens, paramsRef.current ?? undefined)\n      .then((res) => {\n        if (!cancelled) setData(res)\n      })\n      .catch((err) => {\n        if (!cancelled) setError(err instanceof Error ? err : new Error(String(err)))\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false)\n      })\n\n    return () => {\n      cancelled = true\n    }\n  }, [client, lens, paramsKey, enabled, trigger])\n\n  return { data, loading, error, refetch }\n}\n"],"mappings":"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","names":["useState","useEffect","useCallback","useState","useCallback","useEffect","useState","useEffect","useCallback","useState","useCallback","useEffect"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@semilayer/react",
+  "version": "1.1.0",
+  "description": "SemiLayer React hooks — useSearch, useSimilar, useQuery",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@semilayer/client": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0"
+  }
+}