@sylphx/lens-solid 1.2.5 → 1.2.16

package/README.md

@@ -0,0 +1,37 @@
+# @sylphx/lens-solid
+
+Solid.js primitives for the Lens API framework.
+
+## Installation
+
+```bash
+bun add @sylphx/lens-solid
+```
+
+## Usage
+
+```typescript
+import { createQuery, createMutation } from "@sylphx/lens-solid";
+import { client } from "./client";
+
+function UserProfile() {
+  const user = createQuery(() => client.user.get({ id: "1" }));
+  const createUser = createMutation(client.user.create);
+
+  return (
+    <Show when={!user.loading} fallback={<div>Loading...</div>}>
+      <div>{user.data?.name}</div>
+    </Show>
+  );
+}
+```
+
+## License
+
+MIT
+
+---
+
+Built with [@sylphx/lens-client](https://github.com/SylphxAI/Lens).
+
+✨ Powered by Sylphx

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,KAAK,eAAe,EAA6B,MAAM,UAAU,CAAC;AAa3E,MAAM,WAAW,iBAAiB;IACjC,2BAA2B;IAE3B,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,EAAE,eAAe,CAAC,iBAAiB,CAI3D,CAAC;AAMF;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,OAAO,GAAG,GAAG,KAAK,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAY7E"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAiB,KAAK,eAAe,EAAc,MAAM,UAAU,CAAC;AAY3E,MAAM,WAAW,iBAAiB;IACjC,2BAA2B;IAC3B,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,EAAE,eAAe,CAAC,iBAAiB,CAI3D,CAAC;AAMF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAG,GAAG,KAAK,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAW7E"}

package/dist/index.d.ts

@@ -4,6 +4,6 @@
  * SolidJS bindings for Lens API framework.
  * Reactive primitives that integrate with SolidJS fine-grained reactivity.
  */
-export { LensProvider, useLensClient, type LensProviderProps } from "./context";
-export { createQuery, createLazyQuery, createMutation, type QueryInput, type CreateQueryResult, type CreateMutationResult, type CreateLazyQueryResult, type CreateQueryOptions, type MutationFn, } from "./primitives";
+export { LensProvider, type LensProviderProps, useLensClient } from "./context";
+export { type CreateLazyQueryResult, type CreateMutationResult, type CreateQueryOptions, type CreateQueryResult, createLazyQuery, createMutation, createQuery, type MutationFn, type QueryInput, } from "./primitives";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAMhF,OAAO,EAEN,WAAW,EACX,eAAe,EAEf,cAAc,EAEd,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,UAAU,GACf,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAMhF,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,eAAe,EAEf,cAAc,EAEd,WAAW,EACX,KAAK,UAAU,EAEf,KAAK,UAAU,GACf,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,43 +1,44 @@
 {
-  "name": "@sylphx/lens-solid",
-  "version": "1.2.5",
-  "description": "SolidJS 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": "bun build ./src/index.ts --outdir ./dist --target browser --external solid-js && tsc --emitDeclarationOnly --declaration --outDir ./dist",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test"
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "keywords": [
-    "lens",
-    "solid",
-    "solidjs",
-    "reactive",
-    "signals"
-  ],
-  "author": "SylphxAI",
-  "license": "MIT",
-  "dependencies": {
-    "@sylphx/lens-client": "^1.0.9"
-  },
-  "peerDependencies": {
-    "solid-js": ">=1.8.0"
-  },
-  "devDependencies": {
-    "@solidjs/testing-library": "^0.8.10",
-    "solid-js": "^1.9.5",
-    "typescript": "^5.9.3"
-  }
+	"name": "@sylphx/lens-solid",
+	"version": "1.2.16",
+	"description": "SolidJS 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": "bun build ./src/index.ts --outdir ./dist --target browser --external solid-js && tsc --emitDeclarationOnly --declaration --outDir ./dist",
+		"typecheck": "tsc --noEmit",
+		"test": "bun test",
+		"prepack": "bun run build"
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"keywords": [
+		"lens",
+		"solid",
+		"solidjs",
+		"reactive",
+		"signals"
+	],
+	"author": "SylphxAI",
+	"license": "MIT",
+	"dependencies": {
+		"@sylphx/lens-client": "^1.6.0"
+	},
+	"peerDependencies": {
+		"solid-js": ">=1.8.0"
+	},
+	"devDependencies": {
+		"@solidjs/testing-library": "^0.8.10",
+		"solid-js": "^1.9.5",
+		"typescript": "^5.9.3"
+	}
 }

package/src/context.test.ts

@@ -0,0 +1,31 @@
+/**
+ * Tests for SolidJS Context
+ *
+ * Basic tests to verify exports and types.
+ * Tests LensProvider and useLensClient exports via the index.
+ *
+ * Note: Context tests are limited because context.tsx uses JSX
+ * and requires a SolidJS render context. Full integration tests
+ * would require @solidjs/testing-library.
+ */
+
+import { describe, expect, test } from "bun:test";
+// Import from index to test public API
+// The context.tsx file uses JSX which requires special handling
+import type { LensProviderProps } from "./index";
+
+// =============================================================================
+// Tests: Types (compile-time verification)
+// =============================================================================
+
+describe("@sylphx/lens-solid context types", () => {
+	test("LensProviderProps has client property", () => {
+		// Type assertion test - if this compiles, types are correct
+		type HasClient = LensProviderProps["client"];
+
+		// Runtime check that the type exists
+		const _checkClient: HasClient = null as unknown as HasClient;
+
+		expect(true).toBe(true);
+	});
+});

package/src/context.tsx

@@ -5,13 +5,12 @@
  */
 
 import type { LensClient } from "@sylphx/lens-client";
-import { type ParentComponent, createContext, useContext } from "solid-js";
+import { createContext, type ParentComponent, useContext } from "solid-js";
 
 // =============================================================================
 // Context
 // =============================================================================
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 const LensClientContext = createContext<LensClient<any, any>>();
 
 // =============================================================================
@@ -20,7 +19,6 @@ const LensClientContext = createContext<LensClient<any, any>>();
 
 export interface LensProviderProps {
 	/** Lens client instance */
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	client: LensClient<any, any>;
 }
 
@@ -70,7 +68,6 @@ export const LensProvider: ParentComponent<LensProviderProps> = (props) => {
  * }
  * ```
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function useLensClient<TRouter = any>(): LensClient<any, any> & TRouter {
 	const client = useContext(LensClientContext);
 
@@ -81,6 +78,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/index.ts

@@ -9,23 +9,23 @@
 // Context & Provider
 // =============================================================================
 
-export { LensProvider, useLensClient, type LensProviderProps } from "./context";
+export { LensProvider, type LensProviderProps, useLensClient } from "./context";
 
 // =============================================================================
 // Reactive Primitives
 // =============================================================================
 
 export {
-	// Query primitives
-	createQuery,
+	type CreateLazyQueryResult,
+	type CreateMutationResult,
+	type CreateQueryOptions,
+	type CreateQueryResult,
 	createLazyQuery,
 	// Mutation primitive
 	createMutation,
+	// Query primitives
+	createQuery,
+	type MutationFn,
 	// Types
 	type QueryInput,
-	type CreateQueryResult,
-	type CreateMutationResult,
-	type CreateLazyQueryResult,
-	type CreateQueryOptions,
-	type MutationFn,
 } from "./primitives";

package/src/primitives.test.ts

@@ -0,0 +1,184 @@
+/**
+ * Tests for SolidJS Primitives
+ *
+ * Basic tests to verify exports and types.
+ * Tests createQuery, createMutation, createLazyQuery exports.
+ */
+
+import { describe, expect, test } from "bun:test";
+import {
+	type CreateLazyQueryResult,
+	type CreateMutationResult,
+	type CreateQueryOptions,
+	type CreateQueryResult,
+	createLazyQuery,
+	createMutation,
+	createQuery,
+	type MutationFn,
+	type QueryInput,
+} from "./primitives";
+
+// =============================================================================
+// Tests: Exports
+// =============================================================================
+
+describe("@sylphx/lens-solid primitives exports", () => {
+	test("createQuery is exported", () => {
+		expect(typeof createQuery).toBe("function");
+	});
+
+	test("createLazyQuery is exported", () => {
+		expect(typeof createLazyQuery).toBe("function");
+	});
+
+	test("createMutation is exported", () => {
+		expect(typeof createMutation).toBe("function");
+	});
+});
+
+// =============================================================================
+// Tests: Types (compile-time verification)
+// =============================================================================
+
+describe("primitives types", () => {
+	test("QueryInput type accepts QueryResult, null, undefined, or accessor", () => {
+		// This is a compile-time test - if it compiles, types are correct
+		const _testNull: QueryInput<string> = null;
+		const _testUndefined: QueryInput<string> = undefined;
+		const _testAccessor: QueryInput<string> = () => null;
+
+		expect(true).toBe(true);
+	});
+
+	test("CreateQueryResult has correct shape", () => {
+		// Type assertion test - SolidJS uses Accessor functions
+		type ExpectedShape = {
+			data: () => { id: string } | null;
+			loading: () => boolean;
+			error: () => Error | null;
+			refetch: () => void;
+		};
+
+		// If this compiles, CreateQueryResult has the correct shape
+		const _typeCheck: CreateQueryResult<{ id: string }> extends ExpectedShape ? true : false = true;
+		expect(_typeCheck).toBe(true);
+	});
+
+	test("CreateLazyQueryResult has correct shape", () => {
+		type ExpectedShape = {
+			data: () => { id: string } | null;
+			loading: () => boolean;
+			error: () => Error | null;
+			execute: () => Promise<{ id: string }>;
+			reset: () => void;
+		};
+
+		const _typeCheck: CreateLazyQueryResult<{ id: string }> extends ExpectedShape ? true : false = true;
+		expect(_typeCheck).toBe(true);
+	});
+
+	test("CreateMutationResult has correct shape", () => {
+		type ExpectedShape = {
+			data: () => { id: string } | null;
+			loading: () => boolean;
+			error: () => Error | null;
+			mutate: (input: { name: string }) => Promise<{ data: { id: string } }>;
+			reset: () => void;
+		};
+
+		const _typeCheck: CreateMutationResult<{ name: string }, { id: string }> extends ExpectedShape ? true : false =
+			true;
+		expect(_typeCheck).toBe(true);
+	});
+
+	test("CreateQueryOptions has skip property", () => {
+		const options: CreateQueryOptions = { skip: true };
+		expect(options.skip).toBe(true);
+	});
+
+	test("MutationFn type is correct", () => {
+		const fn: MutationFn<{ name: string }, { id: string }> = async (input) => ({
+			data: { id: input.name },
+		});
+
+		expect(typeof fn).toBe("function");
+	});
+});
+
+// =============================================================================
+// Tests: Basic Functionality
+// =============================================================================
+
+describe("primitive functions", () => {
+	test("createMutation returns object with correct methods", () => {
+		const mockMutation = async (input: { name: string }) => ({
+			data: { id: "123", name: input.name },
+		});
+
+		const mutation = createMutation(mockMutation);
+
+		// Verify structure
+		expect(typeof mutation.data).toBe("function");
+		expect(typeof mutation.loading).toBe("function");
+		expect(typeof mutation.error).toBe("function");
+		expect(typeof mutation.mutate).toBe("function");
+		expect(typeof mutation.reset).toBe("function");
+
+		// Check initial state
+		expect(mutation.data()).toBe(null);
+		expect(mutation.loading()).toBe(false);
+		expect(mutation.error()).toBe(null);
+	});
+
+	test("createLazyQuery returns object with correct methods for null input", () => {
+		const query = createLazyQuery(null);
+
+		// Verify structure
+		expect(typeof query.data).toBe("function");
+		expect(typeof query.loading).toBe("function");
+		expect(typeof query.error).toBe("function");
+		expect(typeof query.execute).toBe("function");
+		expect(typeof query.reset).toBe("function");
+
+		// Check initial state
+		expect(query.data()).toBe(null);
+		expect(query.loading()).toBe(false);
+		expect(query.error()).toBe(null);
+	});
+
+	test("createMutation reset clears state", () => {
+		const mockMutation = async (input: { name: string }) => ({
+			data: { id: "123", name: input.name },
+		});
+
+		const mutation = createMutation(mockMutation);
+
+		// Reset should maintain initial cleared state
+		mutation.reset();
+
+		expect(mutation.loading()).toBe(false);
+		expect(mutation.error()).toBe(null);
+		expect(mutation.data()).toBe(null);
+	});
+
+	test("createLazyQuery reset clears state", () => {
+		const query = createLazyQuery(null);
+
+		// Reset should maintain initial cleared state
+		query.reset();
+
+		expect(query.loading()).toBe(false);
+		expect(query.error()).toBe(null);
+		expect(query.data()).toBe(null);
+	});
+
+	test("createLazyQuery execute returns null for null input", async () => {
+		const query = createLazyQuery(null);
+
+		const result = await query.execute();
+
+		expect(result).toBe(null);
+		expect(query.data()).toBe(null);
+		expect(query.loading()).toBe(false);
+	});
+});

package/src/primitives.test.tsx

@@ -61,7 +61,7 @@ function createMockQueryResult<T>(initialValue: T | null = null): QueryResult<T>
 		// Test helpers
 		_setValue(value: T) {
 			currentValue = value;
-			subscribers.forEach((cb) => cb(value));
+			for (const cb of subscribers) cb(value);
 			if (!resolved && resolvePromise) {
 				resolved = true;
 				resolvePromise(value);
@@ -143,9 +143,7 @@ describe("createMutation", () => {
 	test("executes mutation and returns result", async () => {
 		await new Promise<void>((resolve) => {
 			createRoot(async (dispose) => {
-				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 } };
 				};
 
@@ -169,9 +167,7 @@ describe("createMutation", () => {
 	test("handles mutation error", async () => {
 		await new Promise<void>((resolve) => {
 			createRoot(async (dispose) => {
-				const mutationFn = async (_input: { name: string }): Promise<
-					MutationResult<{ id: string }>
-				> => {
+				const mutationFn = async (_input: { name: string }): Promise<MutationResult<{ id: string }>> => {
 					throw new Error("Mutation failed");
 				};
 
@@ -195,9 +191,7 @@ describe("createMutation", () => {
 	test("reset clears mutation state", async () => {
 		await new Promise<void>((resolve) => {
 			createRoot(async (dispose) => {
-				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 } };
 				};