@typokit/client-swr 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import type { RouteContract } from "@typokit/types";
+import type { RouteMap, TypeSafeClient } from "@typokit/client";
+import type { SWRResponse } from "swr";
+import type { SWRMutationResponse } from "swr/mutation";
+/** Build an SWR cache key from route path, params, and query */
+export declare function buildSWRKey(path: string, params?: Record<string, string>, query?: Record<string, unknown>): readonly unknown[];
+/** Extract GET route paths from a RouteMap */
+type GetPaths<TRoutes extends RouteMap> = {
+    [P in keyof TRoutes]: "GET" extends keyof TRoutes[P] ? P : never;
+}[keyof TRoutes] & string;
+type MutationMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+/** Extract paths that have a given mutation method */
+type MutationPaths<TRoutes extends RouteMap, M extends MutationMethod> = {
+    [P in keyof TRoutes]: M extends keyof TRoutes[P] ? P : never;
+}[keyof TRoutes] & string;
+/** Resolve the RouteContract for a given path and method */
+type ContractFor<TRoutes extends RouteMap, P extends string, M extends string> = P extends keyof TRoutes ? M extends keyof TRoutes[P] ? TRoutes[P][M] extends RouteContract ? TRoutes[P][M] : RouteContract : RouteContract : RouteContract;
+/** Options for useSWRGet: route-specific params/query + SWR config */
+export interface UseSWRGetOptions<C extends RouteContract> {
+    params?: C["params"] extends void ? undefined : C["params"] & Record<string, string>;
+    query?: C["query"] extends void ? undefined : C["query"];
+    revalidateOnFocus?: boolean;
+    refreshInterval?: number;
+    dedupingInterval?: number;
+    suspense?: boolean;
+}
+/** Variables passed to mutation hooks */
+export interface MutationVariables<C extends RouteContract> {
+    params?: C["params"] extends void ? undefined : C["params"] & Record<string, string>;
+    body?: C["body"] extends void ? undefined : C["body"];
+}
+/** Mutation lifecycle callbacks */
+interface MutationCallbacks<TData> {
+    onSuccess?: (data: TData) => void;
+    onError?: (error: Error) => void;
+}
+/** Type-safe SWR hooks generated from a RouteMap */
+export interface SWRHooks<TRoutes extends RouteMap> {
+    /** useSWR wrapper for GET routes */
+    useGet<P extends GetPaths<TRoutes>>(path: P, options?: UseSWRGetOptions<ContractFor<TRoutes, P, "GET">>): SWRResponse<ContractFor<TRoutes, P, "GET">["response"], Error>;
+    /** useSWRMutation wrapper for POST routes */
+    usePost<P extends MutationPaths<TRoutes, "POST">>(path: P, options?: MutationCallbacks<ContractFor<TRoutes, P, "POST">["response"]>): SWRMutationResponse<ContractFor<TRoutes, P, "POST">["response"], Error, MutationVariables<ContractFor<TRoutes, P, "POST">>>;
+    /** useSWRMutation wrapper for PUT routes */
+    usePut<P extends MutationPaths<TRoutes, "PUT">>(path: P, options?: MutationCallbacks<ContractFor<TRoutes, P, "PUT">["response"]>): SWRMutationResponse<ContractFor<TRoutes, P, "PUT">["response"], Error, MutationVariables<ContractFor<TRoutes, P, "PUT">>>;
+    /** useSWRMutation wrapper for PATCH routes */
+    usePatch<P extends MutationPaths<TRoutes, "PATCH">>(path: P, options?: MutationCallbacks<ContractFor<TRoutes, P, "PATCH">["response"]>): SWRMutationResponse<ContractFor<TRoutes, P, "PATCH">["response"], Error, MutationVariables<ContractFor<TRoutes, P, "PATCH">>>;
+    /** useSWRMutation wrapper for DELETE routes */
+    useDelete<P extends MutationPaths<TRoutes, "DELETE">>(path: P, options?: MutationCallbacks<ContractFor<TRoutes, P, "DELETE">["response"]>): SWRMutationResponse<ContractFor<TRoutes, P, "DELETE">["response"], Error, MutationVariables<ContractFor<TRoutes, P, "DELETE">>>;
+}
+/**
+ * Create type-safe SWR hooks from a TypoKit client.
+ *
+ * @example
+ * ```ts
+ * const hooks = createSWRHooks<MyRoutes>(client);
+ * // In a React component:
+ * const { data, isLoading } = hooks.useGet("/users", { query: { page: 1 } });
+ * const { trigger: createUser } = hooks.usePost("/users");
+ * createUser({ body: { name: "Alice" } });
+ * ```
+ */
+export declare function createSWRHooks<TRoutes extends RouteMap>(client: TypeSafeClient<TRoutes>): SWRHooks<TRoutes>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,61 @@
+// @typokit/client-swr — SWR Hooks
+import useSWR from "swr";
+import useSWRMutation from "swr/mutation";
+// ─── SWR Key Builder ────────────────────────────────────────
+/** Build an SWR cache key from route path, params, and query */
+export function buildSWRKey(path, params, query) {
+    const key = [path];
+    if (params && Object.keys(params).length > 0) {
+        key.push(params);
+    }
+    if (query && Object.keys(query).length > 0) {
+        key.push(query);
+    }
+    return key;
+}
+// ─── Factory ────────────────────────────────────────────────
+/**
+ * Create type-safe SWR hooks from a TypoKit client.
+ *
+ * @example
+ * ```ts
+ * const hooks = createSWRHooks<MyRoutes>(client);
+ * // In a React component:
+ * const { data, isLoading } = hooks.useGet("/users", { query: { page: 1 } });
+ * const { trigger: createUser } = hooks.usePost("/users");
+ * createUser({ body: { name: "Alice" } });
+ * ```
+ */
+export function createSWRHooks(client) {
+    const c = client;
+    function makeGetHook(path, options) {
+        const key = buildSWRKey(path, options?.params, options?.query);
+        const config = {};
+        if (options?.revalidateOnFocus !== undefined)
+            config.revalidateOnFocus = options.revalidateOnFocus;
+        if (options?.refreshInterval !== undefined)
+            config.refreshInterval = options.refreshInterval;
+        if (options?.dedupingInterval !== undefined)
+            config.dedupingInterval = options.dedupingInterval;
+        if (options?.suspense !== undefined)
+            config.suspense = options.suspense;
+        return useSWR(key, () => c.get(path, { params: options?.params, query: options?.query }), config);
+    }
+    function makeMutationHook(method, path, options) {
+        const key = buildSWRKey(path);
+        const config = {};
+        if (options?.onSuccess)
+            config.onSuccess = options.onSuccess;
+        if (options?.onError)
+            config.onError = options.onError;
+        return useSWRMutation(key, (_key, { arg }) => c[method](path, { params: arg.params, body: arg.body }), config);
+    }
+    return {
+        useGet: (path, options) => makeGetHook(path, options),
+        usePost: (path, options) => makeMutationHook("post", path, options),
+        usePut: (path, options) => makeMutationHook("put", path, options),
+        usePatch: (path, options) => makeMutationHook("patch", path, options),
+        useDelete: (path, options) => makeMutationHook("delete", path, options),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@typokit/client-swr",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@typokit/client": "0.1.4",
+    "@typokit/types": "0.1.4"
+  },
+  "peerDependencies": {
+    "swr": ">=2.0.0",
+    "react": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/client-swr"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests"
+  }
+}

package/src/env.d.ts

@@ -0,0 +1,79 @@
+// Ambient type declarations for swr (peer dependency)
+// Consumers must install swr >= 2.0.0
+
+declare module "swr" {
+  export type Key = string | readonly unknown[] | null | undefined | false;
+
+  export interface SWRConfiguration<TData = unknown, TError = Error> {
+    revalidateOnFocus?: boolean;
+    revalidateOnReconnect?: boolean;
+    refreshInterval?: number;
+    dedupingInterval?: number;
+    shouldRetryOnError?: boolean;
+    errorRetryCount?: number;
+    fallbackData?: TData;
+    suspense?: boolean;
+    onSuccess?: (data: TData) => void;
+    onError?: (error: TError) => void;
+  }
+
+  export interface SWRResponse<TData = unknown, TError = Error> {
+    data: TData | undefined;
+    error: TError | undefined;
+    isLoading: boolean;
+    isValidating: boolean;
+    mutate: (
+      data?:
+        | TData
+        | Promise<TData>
+        | ((current?: TData) => TData | Promise<TData>),
+      opts?: boolean | { revalidate?: boolean },
+    ) => Promise<TData | undefined>;
+  }
+
+  export type Fetcher<TData> = (...args: readonly unknown[]) => Promise<TData>;
+
+  export default function useSWR<TData = unknown, TError = Error>(
+    key: Key,
+    fetcher: Fetcher<TData> | null,
+    config?: SWRConfiguration<TData, TError>,
+  ): SWRResponse<TData, TError>;
+}
+
+declare module "swr/mutation" {
+  export interface SWRMutationConfiguration<
+    TData = unknown,
+    TError = Error,
+    _TArg = never,
+  > {
+    onSuccess?: (data: TData) => void;
+    onError?: (error: TError) => void;
+  }
+
+  export interface SWRMutationResponse<
+    TData = unknown,
+    TError = Error,
+    TArg = never,
+  > {
+    trigger: (arg: TArg) => Promise<TData>;
+    data: TData | undefined;
+    error: TError | undefined;
+    isMutating: boolean;
+    reset: () => void;
+  }
+
+  export type MutationFetcher<TData, TArg = never> = (
+    key: string | readonly unknown[],
+    options: { arg: TArg },
+  ) => Promise<TData>;
+
+  export default function useSWRMutation<
+    TData = unknown,
+    TError = Error,
+    TArg = never,
+  >(
+    key: string | readonly unknown[],
+    fetcher: MutationFetcher<TData, TArg>,
+    options?: SWRMutationConfiguration<TData, TError, TArg>,
+  ): SWRMutationResponse<TData, TError, TArg>;
+}

package/src/index.test.ts

@@ -0,0 +1,56 @@
+// @typokit/client-swr — Tests
+
+import { describe, it, expect } from "@rstest/core";
+import { buildSWRKey } from "./index.js";
+
+// ─── buildSWRKey Tests ──────────────────────────────────────
+
+describe("buildSWRKey", () => {
+  it("returns path-only key when no params or query", () => {
+    const key = buildSWRKey("/users");
+    expect(key).toEqual(["/users"]);
+  });
+
+  it("includes params in key when provided", () => {
+    const key = buildSWRKey("/users/:id", { id: "123" });
+    expect(key).toEqual(["/users/:id", { id: "123" }]);
+  });
+
+  it("includes query in key when provided", () => {
+    const key = buildSWRKey("/users", undefined, { page: 1, limit: 10 });
+    expect(key).toEqual(["/users", { page: 1, limit: 10 }]);
+  });
+
+  it("includes both params and query when provided", () => {
+    const key = buildSWRKey("/users/:id/posts", { id: "42" }, { sort: "date" });
+    expect(key).toEqual(["/users/:id/posts", { id: "42" }, { sort: "date" }]);
+  });
+
+  it("omits empty params object", () => {
+    const key = buildSWRKey("/users", {});
+    expect(key).toEqual(["/users"]);
+  });
+
+  it("omits empty query object", () => {
+    const key = buildSWRKey("/users", undefined, {});
+    expect(key).toEqual(["/users"]);
+  });
+
+  it("produces different keys for different params", () => {
+    const key1 = buildSWRKey("/users/:id", { id: "1" });
+    const key2 = buildSWRKey("/users/:id", { id: "2" });
+    expect(key1).not.toEqual(key2);
+  });
+
+  it("produces different keys for different queries", () => {
+    const key1 = buildSWRKey("/users", undefined, { page: 1 });
+    const key2 = buildSWRKey("/users", undefined, { page: 2 });
+    expect(key1).not.toEqual(key2);
+  });
+
+  it("produces different keys for different paths", () => {
+    const key1 = buildSWRKey("/users");
+    const key2 = buildSWRKey("/posts");
+    expect(key1).not.toEqual(key2);
+  });
+});

package/src/index.ts

@@ -0,0 +1,239 @@
+// @typokit/client-swr — SWR Hooks
+
+import type { RouteContract } from "@typokit/types";
+import type { RouteMap, TypeSafeClient } from "@typokit/client";
+import type { SWRConfiguration, SWRResponse } from "swr";
+import type {
+  SWRMutationConfiguration,
+  SWRMutationResponse,
+} from "swr/mutation";
+import useSWR from "swr";
+import useSWRMutation from "swr/mutation";
+
+// ─── SWR Key Builder ────────────────────────────────────────
+
+/** Build an SWR cache key from route path, params, and query */
+export function buildSWRKey(
+  path: string,
+  params?: Record<string, string>,
+  query?: Record<string, unknown>,
+): readonly unknown[] {
+  const key: unknown[] = [path];
+  if (params && Object.keys(params).length > 0) {
+    key.push(params);
+  }
+  if (query && Object.keys(query).length > 0) {
+    key.push(query);
+  }
+  return key;
+}
+
+// ─── Type-Level Utilities ───────────────────────────────────
+
+/** Extract GET route paths from a RouteMap */
+type GetPaths<TRoutes extends RouteMap> = {
+  [P in keyof TRoutes]: "GET" extends keyof TRoutes[P] ? P : never;
+}[keyof TRoutes] &
+  string;
+
+type MutationMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+
+/** Extract paths that have a given mutation method */
+type MutationPaths<TRoutes extends RouteMap, M extends MutationMethod> = {
+  [P in keyof TRoutes]: M extends keyof TRoutes[P] ? P : never;
+}[keyof TRoutes] &
+  string;
+
+/** Resolve the RouteContract for a given path and method */
+type ContractFor<
+  TRoutes extends RouteMap,
+  P extends string,
+  M extends string,
+> = P extends keyof TRoutes
+  ? M extends keyof TRoutes[P]
+    ? TRoutes[P][M] extends RouteContract
+      ? TRoutes[P][M]
+      : RouteContract
+    : RouteContract
+  : RouteContract;
+
+// ─── Hook Option / Variable Types ───────────────────────────
+
+/** Options for useSWRGet: route-specific params/query + SWR config */
+export interface UseSWRGetOptions<C extends RouteContract> {
+  params?: C["params"] extends void
+    ? undefined
+    : C["params"] & Record<string, string>;
+  query?: C["query"] extends void ? undefined : C["query"];
+  revalidateOnFocus?: boolean;
+  refreshInterval?: number;
+  dedupingInterval?: number;
+  suspense?: boolean;
+}
+
+/** Variables passed to mutation hooks */
+export interface MutationVariables<C extends RouteContract> {
+  params?: C["params"] extends void
+    ? undefined
+    : C["params"] & Record<string, string>;
+  body?: C["body"] extends void ? undefined : C["body"];
+}
+
+/** Mutation lifecycle callbacks */
+interface MutationCallbacks<TData> {
+  onSuccess?: (data: TData) => void;
+  onError?: (error: Error) => void;
+}
+
+// ─── SWRHooks Interface ─────────────────────────────────────
+
+/** Type-safe SWR hooks generated from a RouteMap */
+export interface SWRHooks<TRoutes extends RouteMap> {
+  /** useSWR wrapper for GET routes */
+  useGet<P extends GetPaths<TRoutes>>(
+    path: P,
+    options?: UseSWRGetOptions<ContractFor<TRoutes, P, "GET">>,
+  ): SWRResponse<ContractFor<TRoutes, P, "GET">["response"], Error>;
+
+  /** useSWRMutation wrapper for POST routes */
+  usePost<P extends MutationPaths<TRoutes, "POST">>(
+    path: P,
+    options?: MutationCallbacks<ContractFor<TRoutes, P, "POST">["response"]>,
+  ): SWRMutationResponse<
+    ContractFor<TRoutes, P, "POST">["response"],
+    Error,
+    MutationVariables<ContractFor<TRoutes, P, "POST">>
+  >;
+
+  /** useSWRMutation wrapper for PUT routes */
+  usePut<P extends MutationPaths<TRoutes, "PUT">>(
+    path: P,
+    options?: MutationCallbacks<ContractFor<TRoutes, P, "PUT">["response"]>,
+  ): SWRMutationResponse<
+    ContractFor<TRoutes, P, "PUT">["response"],
+    Error,
+    MutationVariables<ContractFor<TRoutes, P, "PUT">>
+  >;
+
+  /** useSWRMutation wrapper for PATCH routes */
+  usePatch<P extends MutationPaths<TRoutes, "PATCH">>(
+    path: P,
+    options?: MutationCallbacks<ContractFor<TRoutes, P, "PATCH">["response"]>,
+  ): SWRMutationResponse<
+    ContractFor<TRoutes, P, "PATCH">["response"],
+    Error,
+    MutationVariables<ContractFor<TRoutes, P, "PATCH">>
+  >;
+
+  /** useSWRMutation wrapper for DELETE routes */
+  useDelete<P extends MutationPaths<TRoutes, "DELETE">>(
+    path: P,
+    options?: MutationCallbacks<ContractFor<TRoutes, P, "DELETE">["response"]>,
+  ): SWRMutationResponse<
+    ContractFor<TRoutes, P, "DELETE">["response"],
+    Error,
+    MutationVariables<ContractFor<TRoutes, P, "DELETE">>
+  >;
+}
+
+// ─── Untyped client for internal use ────────────────────────
+
+interface UntypedClient {
+  get(path: string, options?: unknown): Promise<unknown>;
+  post(path: string, options?: unknown): Promise<unknown>;
+  put(path: string, options?: unknown): Promise<unknown>;
+  patch(path: string, options?: unknown): Promise<unknown>;
+  delete(path: string, options?: unknown): Promise<unknown>;
+}
+
+// ─── Factory ────────────────────────────────────────────────
+
+/**
+ * Create type-safe SWR hooks from a TypoKit client.
+ *
+ * @example
+ * ```ts
+ * const hooks = createSWRHooks<MyRoutes>(client);
+ * // In a React component:
+ * const { data, isLoading } = hooks.useGet("/users", { query: { page: 1 } });
+ * const { trigger: createUser } = hooks.usePost("/users");
+ * createUser({ body: { name: "Alice" } });
+ * ```
+ */
+export function createSWRHooks<TRoutes extends RouteMap>(
+  client: TypeSafeClient<TRoutes>,
+): SWRHooks<TRoutes> {
+  const c = client as unknown as UntypedClient;
+
+  function makeGetHook(
+    path: string,
+    options?: {
+      params?: Record<string, string>;
+      query?: Record<string, unknown>;
+      revalidateOnFocus?: boolean;
+      refreshInterval?: number;
+      dedupingInterval?: number;
+      suspense?: boolean;
+    },
+  ): SWRResponse<unknown, Error> {
+    const key = buildSWRKey(path, options?.params, options?.query);
+    const config: SWRConfiguration<unknown, Error> = {};
+    if (options?.revalidateOnFocus !== undefined)
+      config.revalidateOnFocus = options.revalidateOnFocus;
+    if (options?.refreshInterval !== undefined)
+      config.refreshInterval = options.refreshInterval;
+    if (options?.dedupingInterval !== undefined)
+      config.dedupingInterval = options.dedupingInterval;
+    if (options?.suspense !== undefined) config.suspense = options.suspense;
+
+    return useSWR(
+      key,
+      () => c.get(path, { params: options?.params, query: options?.query }),
+      config,
+    );
+  }
+
+  function makeMutationHook(
+    method: "post" | "put" | "patch" | "delete",
+    path: string,
+    options?: {
+      onSuccess?: (data: unknown) => void;
+      onError?: (error: Error) => void;
+    },
+  ): SWRMutationResponse<
+    unknown,
+    Error,
+    { params?: Record<string, string>; body?: unknown }
+  > {
+    const key = buildSWRKey(path);
+    const config: SWRMutationConfiguration<
+      unknown,
+      Error,
+      { params?: Record<string, string>; body?: unknown }
+    > = {};
+    if (options?.onSuccess) config.onSuccess = options.onSuccess;
+    if (options?.onError) config.onError = options.onError;
+
+    return useSWRMutation(
+      key,
+      (
+        _key: string | readonly unknown[],
+        { arg }: { arg: { params?: Record<string, string>; body?: unknown } },
+      ) => c[method](path, { params: arg.params, body: arg.body }),
+      config,
+    );
+  }
+
+  return {
+    useGet: (path: string, options?: Record<string, unknown>) =>
+      makeGetHook(path, options as Record<string, unknown>),
+    usePost: (path: string, options?: Record<string, unknown>) =>
+      makeMutationHook("post", path, options as Record<string, unknown>),
+    usePut: (path: string, options?: Record<string, unknown>) =>
+      makeMutationHook("put", path, options as Record<string, unknown>),
+    usePatch: (path: string, options?: Record<string, unknown>) =>
+      makeMutationHook("patch", path, options as Record<string, unknown>),
+    useDelete: (path: string, options?: Record<string, unknown>) =>
+      makeMutationHook("delete", path, options as Record<string, unknown>),
+  } as SWRHooks<TRoutes>;
+}