@sylphx/lens-react 1.2.4 → 1.2.7

package/README.md

@@ -0,0 +1,44 @@
+# @sylphx/lens-react
+
+React hooks for the Lens API framework.
+
+## Installation
+
+```bash
+bun add @sylphx/lens-react
+```
+
+## Usage
+
+```typescript
+import { LensProvider, useQuery, useMutation } from "@sylphx/lens-react";
+import { client } from "./client";
+
+function App() {
+  return (
+    <LensProvider client={client}>
+      <UserProfile />
+    </LensProvider>
+  );
+}
+
+function UserProfile() {
+  const { data, loading, error } = useQuery(client.user.get({ id: "1" }));
+  const [createUser, { loading: creating }] = useMutation(client.user.create);
+
+  if (loading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return <div>{data.name}</div>;
+}
+```
+
+## License
+
+MIT
+
+---
+
+Built with [@sylphx/lens-client](https://github.com/SylphxAI/Lens).
+
+✨ Powered by Sylphx

package/package.json

@@ -1,46 +1,47 @@
 {
-  "name": "@sylphx/lens-react",
-  "version": "1.2.4",
-  "description": "React bindings for Lens API framework",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "bunup",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test"
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "keywords": [
-    "lens",
-    "react",
-    "hooks",
-    "reactive"
-  ],
-  "author": "SylphxAI",
-  "license": "MIT",
-  "dependencies": {
-    "@sylphx/lens-client": "^1.0.8"
-  },
-  "peerDependencies": {
-    "react": ">=18.0.0"
-  },
-  "devDependencies": {
-    "@happy-dom/global-registrator": "^20.0.10",
-    "@testing-library/react": "^16.2.0",
-    "@types/react": "^18.3.12",
-    "happy-dom": "^17.4.7",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "typescript": "^5.9.3"
-  }
+	"name": "@sylphx/lens-react",
+	"version": "1.2.7",
+	"description": "React bindings for Lens API framework",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "bunup",
+		"typecheck": "tsc --noEmit",
+		"test": "bun test",
+		"prepack": "bun run build"
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"keywords": [
+		"lens",
+		"react",
+		"hooks",
+		"reactive"
+	],
+	"author": "SylphxAI",
+	"license": "MIT",
+	"dependencies": {
+		"@sylphx/lens-client": "^1.6.0"
+	},
+	"peerDependencies": {
+		"react": ">=18.0.0"
+	},
+	"devDependencies": {
+		"@happy-dom/global-registrator": "^20.0.10",
+		"@testing-library/react": "^16.2.0",
+		"@types/react": "^19.1.6",
+		"happy-dom": "^20.0.10",
+		"react": "^19.1.0",
+		"react-dom": "^19.1.0",
+		"typescript": "^5.9.3"
+	}
 }

package/src/context.tsx

@@ -5,7 +5,7 @@
  */
 
 import type { LensClient } from "@sylphx/lens-client";
-import { type ReactElement, type ReactNode, createContext, useContext } from "react";
+import { createContext, type ReactElement, type ReactNode, useContext } from "react";
 
 // =============================================================================
 // Context
@@ -15,7 +15,6 @@ import { type ReactElement, type ReactNode, createContext, useContext } from "re
  * Context for Lens client
  * Using any for internal storage to avoid type constraint issues
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 const LensContext = createContext<LensClient<any, any> | null>(null);
 
 // =============================================================================
@@ -24,7 +23,6 @@ const LensContext = createContext<LensClient<any, any> | null>(null);
 
 export interface LensProviderProps {
 	/** Lens client instance */
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	client: LensClient<any, any>;
 	/** Children */
 	children: ReactNode;
@@ -74,7 +72,6 @@ export function LensProvider({ client, children }: LensProviderProps): ReactElem
  * }
  * ```
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function useLensClient<TRouter = any>(): LensClient<any, any> & TRouter {
 	const client = useContext(LensContext);
 
@@ -85,6 +82,5 @@ export function useLensClient<TRouter = any>(): LensClient<any, any> & TRouter {
 		);
 	}
 
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	return client as LensClient<any, any> & TRouter;
 }

package/src/hooks.test.tsx

@@ -1,10 +1,19 @@
 /**
  * Tests for React Hooks (Operations-based API)
+ *
+ * NOTE: These tests require DOM environment (happy-dom).
+ * Run from packages/react directory: cd packages/react && bun test
  */
 
-import { describe, expect, test } from "bun:test";
-import { signal } from "@sylphx/lens-client";
+// Skip all tests if DOM is not available (when run from root)
+const hasDom = typeof document !== "undefined";
+
+import { test as bunTest, describe, expect } from "bun:test";
+
+const test = hasDom ? bunTest : bunTest.skip;
+
 import type { MutationResult, QueryResult } from "@sylphx/lens-client";
+import { signal } from "@sylphx/lens-client";
 import { act, renderHook, waitFor } from "@testing-library/react";
 import { useLazyQuery, useMutation, useQuery } from "./hooks";
 
@@ -17,7 +26,7 @@ function createMockQueryResult<T>(initialValue: T | null = null): QueryResult<T>
 	_setError: (error: Error) => void;
 } {
 	let currentValue = initialValue;
-	let currentError: Error | null = null;
+	let _currentError: Error | null = null;
 	const subscribers: Array<(value: T) => void> = [];
 	let resolved = false;
 	let resolvePromise: ((value: T) => void) | null = null;
@@ -66,14 +75,14 @@ function createMockQueryResult<T>(initialValue: T | null = null): QueryResult<T>
 			result.signal.value = value;
 			result.loading.value = false;
 			result.error.value = null;
-			subscribers.forEach((cb) => cb(value));
+			for (const cb of subscribers) cb(value);
 			if (!resolved && resolvePromise) {
 				resolved = true;
 				resolvePromise(value);
 			}
 		},
 		_setError(error: Error) {
-			currentError = error;
+			_currentError = error;
 			result.loading.value = false;
 			result.error.value = error;
 			if (!resolved && rejectPromise) {
@@ -180,9 +189,7 @@ describe("useQuery", () => {
 
 describe("useMutation", () => {
 	test("executes mutation and returns result", async () => {
-		const mutationFn = async (input: { name: string }): Promise<
-			MutationResult<{ id: string; name: string }>
-		> => {
+		const mutationFn = async (input: { name: string }): Promise<MutationResult<{ id: string; name: string }>> => {
 			return {
 				data: { id: "new-id", name: input.name },
 			};
@@ -204,9 +211,7 @@ describe("useMutation", () => {
 	});
 
 	test("handles mutation error", async () => {
-		const mutationFn = async (_input: { name: string }): Promise<
-			MutationResult<{ id: string; name: string }>
-		> => {
+		const mutationFn = async (_input: { name: string }): Promise<MutationResult<{ id: string; name: string }>> => {
 			throw new Error("Mutation failed");
 		};
 
@@ -226,9 +231,7 @@ describe("useMutation", () => {
 
 	test("shows loading state during mutation", async () => {
 		let resolveMutation: ((value: MutationResult<{ id: string }>) => void) | null = null;
-		const mutationFn = async (_input: { name: string }): Promise<
-			MutationResult<{ id: string }>
-		> => {
+		const mutationFn = async (_input: { name: string }): Promise<MutationResult<{ id: string }>> => {
 			return new Promise((resolve) => {
 				resolveMutation = resolve;
 			});
@@ -255,9 +258,7 @@ describe("useMutation", () => {
 	});
 
 	test("reset clears mutation state", async () => {
-		const mutationFn = async (input: { name: string }): Promise<
-			MutationResult<{ id: string; name: string }>
-		> => {
+		const mutationFn = async (input: { name: string }): Promise<MutationResult<{ id: string; name: string }>> => {
 			return { data: { id: "new-id", name: input.name } };
 		};
 

package/src/index.ts

@@ -9,23 +9,23 @@
 // Context & Provider
 // =============================================================================
 
-export { LensProvider, useLensClient, type LensProviderProps } from "./context";
+export { LensProvider, type LensProviderProps, useLensClient } from "./context";
 
 // =============================================================================
 // Hooks (Operations-based API)
 // =============================================================================
 
 export {
-	// Query hooks
-	useQuery,
-	useLazyQuery,
-	// Mutation hook
-	useMutation,
+	type MutationFn,
 	// Types
 	type QueryInput,
-	type UseQueryResult,
 	type UseLazyQueryResult,
 	type UseMutationResult,
 	type UseQueryOptions,
-	type MutationFn,
+	type UseQueryResult,
+	useLazyQuery,
+	// Mutation hook
+	useMutation,
+	// Query hooks
+	useQuery,
 } from "./hooks";