@sylphx/lens-solid 2.0.5 → 2.1.1

package/README.md

@@ -1,31 +1,80 @@
 # @sylphx/lens-solid
 
-Solid.js primitives for the Lens API framework.
+SolidJS primitives for the Lens API framework.
 
 ## Installation
 
 ```bash
-bun add @sylphx/lens-solid
+bun add @sylphx/lens-solid @sylphx/lens-client
 ```
 
 ## Usage
 
+### Setup Client
+
 ```typescript
-import { createQuery, createMutation } from "@sylphx/lens-solid";
-import { client } from "./client";
+// lib/client.ts
+import { createClient } from "@sylphx/lens-solid";
+import { http } from "@sylphx/lens-client";
+import type { AppRouter } from "@/server/router";
+
+export const client = createClient<AppRouter>({
+  transport: http({ url: "/api/lens" }),
+});
+```
+
+### Query (in component)
+
+```tsx
+import { client } from "@/lib/client";
+import { Show } from "solid-js";
 
-function UserProfile() {
-  const user = createQuery(() => client.user.get({ id: "1" }));
-  const createUser = createMutation(client.user.create);
+function UserProfile(props: { id: string }) {
+  const { data, loading, error, refetch } = client.user.get({
+    input: { id: props.id },
+    select: { name: true, email: true },
+  });
 
   return (
-    <Show when={!user.loading} fallback={<div>Loading...</div>}>
-      <div>{user.data?.name}</div>
+    <Show when={!loading()} fallback={<div>Loading...</div>}>
+      <Show when={!error()} fallback={<div>Error: {error()?.message}</div>}>
+        <div>{data()?.name}</div>
+      </Show>
     </Show>
   );
 }
 ```
 
+### Mutation (in component)
+
+```tsx
+import { client } from "@/lib/client";
+
+function CreateUser() {
+  const { mutate, loading, error, data, reset } = client.user.create({
+    onSuccess: (data) => console.log("Created:", data),
+    onError: (error) => console.error("Failed:", error),
+  });
+
+  const handleSubmit = async () => {
+    await mutate({ input: { name: "New User" } });
+  };
+
+  return (
+    <button onClick={handleSubmit} disabled={loading()}>
+      {loading() ? "Creating..." : "Create User"}
+    </button>
+  );
+}
+```
+
+### SSR / Server-side
+
+```typescript
+// Use .fetch() for promise-based calls
+const user = await client.user.get.fetch({ input: { id } });
+```
+
 ## License
 
 MIT
@@ -34,4 +83,4 @@ MIT
 
 Built with [@sylphx/lens-client](https://github.com/SylphxAI/Lens).
 
-✨ Powered by Sylphx
+Powered by Sylphx

package/dist/create.d.ts

@@ -0,0 +1,149 @@
+/**
+ * @sylphx/lens-solid - Create Client
+ *
+ * Creates a typed Lens client with SolidJS primitives.
+ * Each endpoint can be called directly as a primitive or via .fetch() for promises.
+ *
+ * @example
+ * ```tsx
+ * // lib/client.ts
+ * import { createClient } from '@sylphx/lens-solid';
+ * import { httpTransport } from '@sylphx/lens-client';
+ * import type { AppRouter } from '@/server/router';
+ *
+ * export const client = createClient<AppRouter>({
+ *   transport: httpTransport({ url: '/api/lens' }),
+ * });
+ *
+ * // In component
+ * const { data, loading } = client.user.get({ input: { id } });
+ *
+ * // In SSR
+ * const user = await client.user.get.fetch({ input: { id } });
+ * ```
+ */
+import { type LensClientConfig, type SelectionObject, type TypedClientConfig } from "@sylphx/lens-client";
+import type { MutationDef, QueryDef, RouterDef, RouterRoutes } from "@sylphx/lens-core";
+import { type Accessor } from "solid-js";
+/** Query hook options */
+export interface QueryHookOptions<TInput> {
+    /** Query input parameters */
+    input?: TInput;
+    /** Field selection */
+    select?: SelectionObject;
+    /** Skip query execution */
+    skip?: boolean;
+}
+/** Query hook result */
+export interface QueryHookResult<T> {
+    /** Reactive data accessor */
+    data: Accessor<T | null>;
+    /** Reactive loading state */
+    loading: Accessor<boolean>;
+    /** Reactive error state */
+    error: Accessor<Error | null>;
+    /** Refetch the query */
+    refetch: () => void;
+}
+/** Mutation hook options */
+export interface MutationHookOptions<TOutput> {
+    /** Called on successful mutation */
+    onSuccess?: (data: TOutput) => void;
+    /** Called on mutation error */
+    onError?: (error: Error) => void;
+    /** Called when mutation settles (success or error) */
+    onSettled?: () => void;
+}
+/** Mutation hook result */
+export interface MutationHookResult<TInput, TOutput> {
+    /** Execute the mutation */
+    mutate: (options: {
+        input: TInput;
+        select?: SelectionObject;
+    }) => Promise<TOutput>;
+    /** Reactive loading state */
+    loading: Accessor<boolean>;
+    /** Reactive error state */
+    error: Accessor<Error | null>;
+    /** Reactive last mutation result */
+    data: Accessor<TOutput | null>;
+    /** Reset mutation state */
+    reset: () => void;
+}
+/** Query endpoint type */
+export interface QueryEndpoint<TInput, TOutput> {
+    /** Primitive call (in component) */
+    <_TSelect extends SelectionObject = Record<string, never>>(options: TInput extends void ? QueryHookOptions<void> | void : QueryHookOptions<TInput>): QueryHookResult<TOutput>;
+    /** Promise call (SSR) */
+    fetch: <TSelect extends SelectionObject = Record<string, never>>(options: TInput extends void ? {
+        input?: void;
+        select?: TSelect;
+    } | void : {
+        input: TInput;
+        select?: TSelect;
+    }) => Promise<TOutput>;
+}
+/** Mutation endpoint type */
+export interface MutationEndpoint<TInput, TOutput> {
+    /** Primitive call (in component) */
+    (options?: MutationHookOptions<TOutput>): MutationHookResult<TInput, TOutput>;
+    /** Promise call (SSR) */
+    fetch: <TSelect extends SelectionObject = Record<string, never>>(options: {
+        input: TInput;
+        select?: TSelect;
+    }) => Promise<TOutput>;
+}
+/** Infer client type from router routes */
+type InferTypedClient<TRoutes extends RouterRoutes> = {
+    [K in keyof TRoutes]: TRoutes[K] extends RouterDef<infer TNestedRoutes> ? InferTypedClient<TNestedRoutes> : TRoutes[K] extends QueryDef<infer TInput, infer TOutput> ? QueryEndpoint<TInput, TOutput> : TRoutes[K] extends MutationDef<infer TInput, infer TOutput> ? MutationEndpoint<TInput, TOutput> : never;
+};
+/** Typed client from router */
+export type TypedClient<TRouter extends RouterDef> = TRouter extends RouterDef<infer TRoutes> ? InferTypedClient<TRoutes> : never;
+/**
+ * Create a Lens client with SolidJS primitives.
+ *
+ * Each endpoint can be called:
+ * - Directly as a primitive: `client.user.get({ input: { id } })`
+ * - Via .fetch() for promises: `await client.user.get.fetch({ input: { id } })`
+ *
+ * @example
+ * ```tsx
+ * // lib/client.ts
+ * import { createClient } from '@sylphx/lens-solid';
+ * import { httpTransport } from '@sylphx/lens-client';
+ * import type { AppRouter } from '@/server/router';
+ *
+ * export const client = createClient<AppRouter>({
+ *   transport: httpTransport({ url: '/api/lens' }),
+ * });
+ *
+ * // Component usage
+ * function UserProfile(props: { id: string }) {
+ *   const { data, loading, error } = client.user.get({
+ *     input: { id: props.id },
+ *     select: { name: true },
+ *   });
+ *
+ *   const { mutate, loading: saving } = client.user.update({
+ *     onSuccess: () => console.log('Updated!'),
+ *   });
+ *
+ *   return (
+ *     <Show when={!loading()} fallback={<Spinner />}>
+ *       <h1>{data()?.name}</h1>
+ *       <button
+ *         onClick={() => mutate({ input: { id: props.id, name: 'New' } })}
+ *         disabled={saving()}
+ *       >
+ *         Update
+ *       </button>
+ *     </Show>
+ *   );
+ * }
+ * ```
+ */
+export declare function createClient<TRouter extends RouterDef>(config: LensClientConfig | TypedClientConfig<{
+    router: TRouter;
+}>): TypedClient<TRouter>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,7 +3,26 @@
  *
  * SolidJS bindings for Lens API framework.
  * Reactive primitives that integrate with SolidJS fine-grained reactivity.
+ *
+ * @example
+ * ```tsx
+ * // lib/client.ts
+ * import { createClient } from '@sylphx/lens-solid';
+ * import { httpTransport } from '@sylphx/lens-client';
+ * import type { AppRouter } from '@/server/router';
+ *
+ * export const client = createClient<AppRouter>({
+ *   transport: httpTransport({ url: '/api/lens' }),
+ * });
+ *
+ * // Component usage
+ * const { data, loading } = client.user.get({ input: { id } });
+ *
+ * // SSR usage
+ * const user = await client.user.get.fetch({ input: { id } });
+ * ```
  */
+export { createClient, type MutationEndpoint, type MutationHookOptions, type MutationHookResult, type QueryEndpoint, type QueryHookOptions, type QueryHookResult, type TypedClient, } from "./create.js";
 export { LensProvider, type LensProviderProps, useLensClient } from "./context.js";
 export { type CreateLazyQueryResult, type CreateMutationResult, type CreateQueryOptions, type CreateQueryResult, createLazyQuery, createMutation, createQuery, type MutationFn, type QueryInput, } from "./primitives.js";
 //# 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,KAAK,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMnF,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,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EACN,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,GAChB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMnF,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,iBAAiB,CAAC"}