@atomic-solutions/woocommerce-api-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Atomic Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# @atomic-solutions/woocommerce-utils
+
+> Type-safe WooCommerce Store API client with React Query integration
+
+**Status:** 🚧 Work in Progress
+
+## Features
+
+- ✅ **Type-Safe** - Full TypeScript support with Zod validation
+- ✅ **WooCommerce Store API v1** - Designed for headless/mobile apps
+- ✅ **React Query Integration** - Optimized caching and state management
+- ✅ **Cart Session Management** - Automatic nonce/cart-token handling
+- ✅ **JWT Authentication** - Secure user authentication support
+- ✅ **Error Handling** - Built-in error classes with optional error reporter injection
+- ✅ **Tree-Shakeable** - Sub-path exports for minimal bundle size
+- ✅ **Platform Agnostic** - Works in React Native, Next.js, and web
+
+## Installation
+
+```bash
+yarn add @atomic-solutions/woocommerce-utils
+```
+
+### Peer Dependencies
+
+```bash
+yarn add axios @tanstack/react-query zod
+```
+
+## Quick Start
+
+### 1. Create Client
+
+```tsx
+import { createClient } from '@atomic-solutions/woocommerce-utils';
+
+// For React Native
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+const cartHeadersAdapter = {
+  get: async () => {
+    const nonce = await AsyncStorage.getItem('woo_nonce');
+    const cartToken = await AsyncStorage.getItem('woo_cart_token');
+    return { nonce, cartToken };
+  },
+  save: async ({ nonce, cartToken }) => {
+    if (nonce) await AsyncStorage.setItem('woo_nonce', nonce);
+    if (cartToken) await AsyncStorage.setItem('woo_cart_token', cartToken);
+  },
+  clear: async () => {
+    await AsyncStorage.removeItem('woo_nonce');
+    await AsyncStorage.removeItem('woo_cart_token');
+  },
+};
+
+const client = createClient({
+  baseURL: 'https://your-store.com/wp-json',
+  cartHeaders: cartHeadersAdapter,
+  debug: process.env.DEBUG === 'true',
+});
+```
+
+### 2. Setup Provider
+
+**Important:** You must provide your own `QueryClientProvider` from `@tanstack/react-query`.
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { WooCommerceProvider } from '@atomic-solutions/woocommerce-utils';
+
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <WooCommerceProvider client={client}>
+        <YourApp />
+      </WooCommerceProvider>
+    </QueryClientProvider>
+  );
+}
+```
+
+### 3. Use Hooks
+
+```tsx
+import { useProducts, useAddToCart } from '@atomic-solutions/woocommerce-utils/hooks';
+
+function ProductList() {
+  const { data: products, isLoading } = useProducts({
+    category: 'electronics',
+    per_page: 20,
+  });
+
+  const addToCart = useAddToCart();
+
+  if (isLoading) return <Loading />;
+
+  return (
+    <FlatList
+      data={products}
+      renderItem={({ item }) => (
+        <ProductCard
+          product={item}
+          onAddToCart={() =>
+            addToCart.mutate({
+              id: item.id,
+              quantity: 1,
+            })
+          }
+        />
+      )}
+    />
+  );
+}
+```
+
+## Documentation
+
+Coming soon...
+
+## License
+
+MIT © Atomic Solutions

package/dist/client/index.d.mts

@@ -0,0 +1,9 @@
+import { h as WooCommerceConfig, g as WooCommerceClient } from '../types-B-zy1xrP.mjs';
+export { C as CartAPI, b as CartHeadersAdapter, c as CheckoutAPI, J as JwtTokenAdapter, O as OrdersAPI, d as ProductsAPI } from '../types-B-zy1xrP.mjs';
+import 'axios';
+import 'zod';
+import '../products-Cxl54crz.mjs';
+
+declare const createClient: (config: WooCommerceConfig) => WooCommerceClient;
+
+export { WooCommerceClient, WooCommerceConfig, createClient };

package/dist/client/index.d.ts

@@ -0,0 +1,9 @@
+import { h as WooCommerceConfig, g as WooCommerceClient } from '../types-qKWtrw7A.js';
+export { C as CartAPI, b as CartHeadersAdapter, c as CheckoutAPI, J as JwtTokenAdapter, O as OrdersAPI, d as ProductsAPI } from '../types-qKWtrw7A.js';
+import 'axios';
+import 'zod';
+import '../products-Cxl54crz.js';
+
+declare const createClient: (config: WooCommerceConfig) => WooCommerceClient;
+
+export { WooCommerceClient, WooCommerceConfig, createClient };