@unifiedcommerce/sdk 0.1.0

package/src/index.ts

@@ -0,0 +1,3 @@
+export { createSDK, type SDKOptions } from "./client";
+export { authMiddleware, type AuthCredential, type ApiKeyAuth, type BearerAuth } from "./middleware";
+export type { paths, components } from "./generated/api-types";

package/src/middleware.ts

@@ -0,0 +1,31 @@
+import type { Middleware } from "openapi-fetch";
+
+export interface ApiKeyAuth {
+  type: "api_key";
+  key: string;
+}
+
+export interface BearerAuth {
+  type: "bearer";
+  token: string;
+}
+
+export type AuthCredential = ApiKeyAuth | BearerAuth;
+
+/**
+ * openapi-fetch middleware that injects authentication headers.
+ *
+ * Supports API key (x-api-key header) and Bearer token (Authorization header).
+ */
+export function authMiddleware(credential: AuthCredential): Middleware {
+  return {
+    onRequest({ request }) {
+      if (credential.type === "api_key") {
+        request.headers.set("x-api-key", credential.key);
+      } else if (credential.type === "bearer") {
+        request.headers.set("Authorization", `Bearer ${credential.token}`);
+      }
+      return request;
+    },
+  };
+}

package/src/react.ts

@@ -0,0 +1,43 @@
+/**
+ * React Query integration for the UnifiedCommerce SDK.
+ *
+ * Wraps the openapi-fetch client in TanStack Query hooks (useQuery, useMutation,
+ * useSuspenseQuery) with the same generated path types.
+ *
+ * Requires peer dependencies: @tanstack/react-query >= 5.0.0, openapi-react-query >= 0.3.0
+ *
+ * @example
+ * ```typescript
+ * import { createSDK } from "@unifiedcommerce/sdk";
+ * import { createCommerceHooks } from "@unifiedcommerce/sdk/react";
+ *
+ * const sdk = createSDK({ baseUrl: "http://localhost:4000", auth: { type: "api_key", key: "..." } });
+ * const commerce = createCommerceHooks(sdk.raw);
+ *
+ * function ProductList() {
+ *   const { data, isLoading } = commerce.useQuery("get", "/api/catalog/entities", {
+ *     params: { query: { type: "product", limit: "20" } },
+ *   });
+ * }
+ * ```
+ */
+
+import createQueryHooks from "openapi-react-query";
+import type createClient from "openapi-fetch";
+import type { paths } from "./generated/api-types";
+
+/**
+ * Type alias for the hooks object returned by createCommerceHooks.
+ * Plugin hook factories accept this type as their parameter.
+ */
+export type CommerceHooks = ReturnType<typeof createCommerceHooks>;
+
+/**
+ * Creates TanStack Query hooks from the typed openapi-fetch client.
+ *
+ * @param client - The raw openapi-fetch client (sdk.raw)
+ * @returns Typed useQuery, useMutation, useSuspenseQuery hooks for all API paths
+ */
+export function createCommerceHooks(client: ReturnType<typeof createClient<paths>>) {
+  return createQueryHooks(client);
+}