@classytic/commerce-sdk 0.1.1

package/dist/core/index.d.ts

@@ -0,0 +1,166 @@
+export { d as AggregatePaginationResponse, A as ApiResponse, B as BaseApi, f as BaseApiConfig, D as DeleteResponse, E as ExtractDoc, F as FilterOperator, K as KeysetPaginationResponse, O as OffsetPaginationResponse, P as PaginatedResponse, Q as QueryParams, R as RequestOptions, S as SortDirection, e as SortSpec, c as createCrudApi, b as isAggregatePagination, a as isKeysetPagination, i as isOffsetPagination } from '../api-factory-B_h4RKBm.js';
+
+/**
+ * @classytic/commerce-sdk - API Handler
+ *
+ * Universal API request handler for Next.js applications.
+ * Handles JSON, binary (PDF, images), CSV, and text responses.
+ */
+type HttpMethod = "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+interface ApiRequestOptions {
+    body?: unknown;
+    token?: string | null;
+    organizationId?: string | null;
+    revalidate?: number;
+    headerOptions?: Record<string, string>;
+    tags?: string[];
+    cache?: RequestCache;
+    /**
+     * Credentials mode for this specific request.
+     * Overrides SDK-level credentials config.
+     * - "include": Always send cookies
+     * - "same-origin": Only send cookies for same-origin requests
+     * - "omit": Never send cookies (pure bearer-token auth)
+     */
+    credentials?: RequestCredentials;
+}
+interface BlobResponse {
+    data: Blob;
+    response: Response;
+}
+interface TextResponse {
+    data: string;
+    response: Response;
+}
+/**
+ * SDK Configuration
+ */
+interface SDKConfig {
+    /** Base URL for API requests (e.g., "https://api.example.com") */
+    baseUrl: string;
+    /** Default organization ID for multi-tenant support */
+    organizationId?: string;
+    /** Function to get current auth token */
+    getToken?: () => string | null | Promise<string | null>;
+    /** Default request cache mode */
+    cache?: RequestCache;
+    /** Default headers to include in all requests (e.g., API keys, custom headers) */
+    headers?: Record<string, string>;
+    /**
+     * Default credentials mode for fetch requests.
+     * Can be overridden per-request via ApiRequestOptions.credentials
+     * - "include": Always send cookies (default for backward compatibility)
+     * - "same-origin": Only send cookies for same-origin requests
+     * - "omit": Never send cookies (use for pure bearer-token auth)
+     * @default "include"
+     */
+    credentials?: RequestCredentials;
+}
+/**
+ * Custom API Error class that preserves HTTP status and response body.
+ * Provides better debugging context for API failures.
+ *
+ * @example
+ * try {
+ *   await sdk.orders.create(data);
+ * } catch (error) {
+ *   if (error instanceof ApiError) {
+ *     console.log(error.status);      // 422
+ *     console.log(error.body);        // { errors: [...] }
+ *     console.log(error.endpoint);    // "/api/v1/orders"
+ *   }
+ * }
+ */
+declare class ApiError extends Error {
+    /** HTTP status code (e.g., 400, 401, 404, 500) */
+    readonly status: number;
+    /** HTTP status text (e.g., "Bad Request", "Unauthorized") */
+    readonly statusText: string;
+    /** Raw response body - JSON object, string, or null if unparseable */
+    readonly body: unknown;
+    /** The API endpoint that was called */
+    readonly endpoint: string;
+    /** The HTTP method used */
+    readonly method: HttpMethod;
+    constructor(options: {
+        message: string;
+        status: number;
+        statusText: string;
+        body: unknown;
+        endpoint: string;
+        method: HttpMethod;
+    });
+    /** Check if error is a client error (4xx) */
+    isClientError(): boolean;
+    /** Check if error is a server error (5xx) */
+    isServerError(): boolean;
+    /** Returns detailed string for logging */
+    toDetailedString(): string;
+}
+declare function setSDKConfigProvider(provider: (() => SDKConfig | null) | null): void;
+/**
+ * Configure the SDK with base URL and other options
+ *
+ * @example
+ * // Basic configuration
+ * configureSDK({
+ *   baseUrl: process.env.NEXT_PUBLIC_API_URL!,
+ *   getToken: () => localStorage.getItem('token'),
+ *   organizationId: 'org_123',
+ * });
+ *
+ * @example
+ * // With custom headers (API keys, etc.)
+ * configureSDK({
+ *   baseUrl: process.env.NEXT_PUBLIC_API_URL!,
+ *   headers: {
+ *     'x-api-key': process.env.API_KEY,
+ *     'x-custom-header': 'value',
+ *   },
+ * });
+ */
+declare function configureSDK(config: SDKConfig): void;
+/**
+ * Get current SDK configuration
+ */
+declare function getSDKConfig(): SDKConfig | null;
+/**
+ * Get base URL from SDK config or throw if not configured
+ */
+declare function getBaseUrl(): string;
+/**
+ * Universal API request handler for Next.js applications
+ * Handles JSON, binary (PDF, images), CSV, and text responses
+ *
+ * @template T - Expected response type
+ * @param method - HTTP method
+ * @param endpoint - API endpoint (will be appended to BASE_URL)
+ * @param options - Request options
+ * @param debug - Enable debug logging
+ * @returns Promise resolving to the response data
+ *
+ * @example
+ * // JSON response
+ * const { success, data } = await handleApiRequest<ApiResponse<User>>('GET', '/users/me', { token });
+ *
+ * // Paginated response
+ * const response = await handleApiRequest<PaginatedResponse<Product>>('GET', '/products?page=1');
+ *
+ * // Create with body
+ * const result = await handleApiRequest('POST', '/orders', { token, body: orderData });
+ */
+declare function handleApiRequest<T = unknown>(method: HttpMethod, endpoint: string, options?: ApiRequestOptions, debug?: boolean): Promise<T>;
+/**
+ * Creates query string from parameters
+ * Supports: ?field=value and arrays as field[in]=value1,value2
+ *
+ * @example
+ * createQueryString({ page: 1, limit: 10, status: 'active' })
+ * // => 'page=1&limit=10&status=active'
+ *
+ * createQueryString({ roles: ['admin', 'user'] })
+ * // => 'roles[in]=admin,user'
+ */
+declare function createQueryString<T extends Record<string, unknown>>(params?: T): string;
+
+export { ApiError, type ApiRequestOptions, type BlobResponse, type HttpMethod, type SDKConfig, type TextResponse, configureSDK, createQueryString, getBaseUrl, getSDKConfig, handleApiRequest, setSDKConfigProvider };

package/dist/core/index.js

@@ -0,0 +1,5 @@
+import '../chunk-PYYLHUV6.js';
+export { BaseApi, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination } from '../chunk-QCTXAMLA.js';
+export { ApiError, configureSDK, createQueryString, getBaseUrl, getSDKConfig, handleApiRequest, setSDKConfigProvider } from '../chunk-IHCBBLLW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/core/react.d.ts

@@ -0,0 +1,107 @@
+export { o as CreateDetailQueryOptions, n as CreateListQueryOptions, d as CrudActions, C as CrudApi, a as CrudHooksConfig, b as CrudHooksReturn, j as DEFAULT_QUERY_CONFIG, D as DetailOptions, m as DetailQueryResult, L as ListOptions, l as ListQueryResult, N as NavigateFn, e as NavigationOptions, P as PaginationData, Q as QueryConfig, k as QueryKeys, c as createCrudHooks, g as createDetailQuery, f as createListQuery, h as createQueryKeys, i as getItemId, u as updateListCache } from '../crud.factory-DyKaPHcU.js';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryKey, QueryClient } from '@tanstack/react-query';
+
+interface ToastHandler {
+    success: (message: string) => void;
+    error: (message: string) => void;
+}
+/**
+ * Configure the toast handler for mutations
+ * @example
+ * import { toast } from 'sonner';
+ * configureToast({ success: toast.success, error: toast.error });
+ */
+declare function configureToast(handler: ToastHandler): void;
+/**
+ * Get the current toast handler (for internal use)
+ */
+declare function getToastHandler(): ToastHandler;
+interface MutationMessages {
+    success?: string | ((data: unknown, variables: unknown) => string);
+    error?: string | ((error: Error, variables: unknown) => string);
+}
+interface MutationWithTransitionConfig<TData, TVariables> {
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    invalidateQueries?: QueryKey[];
+    onSuccess?: (data: TData, variables: TVariables, context: unknown) => void;
+    onError?: (error: Error, variables: TVariables, context: unknown) => void;
+    messages?: MutationMessages;
+    useTransition?: boolean;
+    showToast?: boolean;
+}
+declare function useMutationWithTransition<TData, TVariables>(config: MutationWithTransitionConfig<TData, TVariables>): {
+    mutate: _tanstack_react_query.UseMutateFunction<TData, Error, TVariables, unknown>;
+    mutateAsync: _tanstack_react_query.UseMutateAsyncFunction<TData, Error, TVariables, unknown>;
+    isLoading: boolean;
+    isPending: boolean;
+    isSuccess: boolean;
+    error: Error | null;
+    data: TData | undefined;
+    reset: () => void;
+};
+interface MutationWithOptimisticConfig<TData, TVariables> {
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    queryKeys?: QueryKey[];
+    optimisticUpdate?: (oldData: unknown, variables: TVariables) => unknown;
+    messages?: MutationMessages;
+    onSuccess?: (data: TData, variables: TVariables, context: unknown) => void;
+    onError?: (error: Error, variables: TVariables, context: unknown) => void;
+    showToast?: boolean;
+}
+declare function useMutationWithOptimistic<TData, TVariables>(config: MutationWithOptimisticConfig<TData, TVariables>): {
+    mutate: _tanstack_react_query.UseMutateFunction<TData, Error, TVariables, {
+        previousData: {
+            queryKey: readonly unknown[];
+            data: unknown;
+        }[];
+    }>;
+    mutateAsync: _tanstack_react_query.UseMutateAsyncFunction<TData, Error, TVariables, {
+        previousData: {
+            queryKey: readonly unknown[];
+            data: unknown;
+        }[];
+    }>;
+    isLoading: boolean;
+    isPending: boolean;
+    isSuccess: boolean;
+    error: Error | null;
+    data: TData | undefined;
+    reset: () => void;
+};
+interface CreateOptimisticMutationConfig<TData, TVariables> {
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    queryClient: QueryClient;
+    queryKeys: QueryKey[];
+    optimisticUpdate?: (oldData: unknown, variables: TVariables) => unknown;
+    onSuccess?: (data: TData, variables: TVariables, context: unknown) => void;
+    onError?: (error: Error, variables: TVariables, context: unknown) => void;
+    messages?: MutationMessages;
+}
+declare function createOptimisticMutation<TData, TVariables>({ mutationFn, queryClient, queryKeys, optimisticUpdate, onSuccess, onError, messages, }: CreateOptimisticMutationConfig<TData, TVariables>): _tanstack_react_query.UseMutationResult<TData, Error, TVariables, {
+    previous: {
+        key: readonly unknown[];
+        data: [readonly unknown[], unknown][];
+    }[];
+}>;
+declare const QUERY_CONFIGS: {
+    readonly realtime: {
+        readonly staleTime: 20000;
+        readonly refetchInterval: 30000;
+    };
+    readonly frequent: {
+        readonly staleTime: 60000;
+        readonly refetchInterval: false;
+    };
+    readonly stable: {
+        readonly staleTime: 300000;
+        readonly refetchInterval: false;
+    };
+    readonly static: {
+        readonly staleTime: 600000;
+        readonly refetchInterval: false;
+    };
+};
+declare const createMessage: <T>(fn: T) => T;
+
+export { type CreateOptimisticMutationConfig, type MutationMessages, type MutationWithOptimisticConfig, type MutationWithTransitionConfig, QUERY_CONFIGS, type ToastHandler, configureToast, createMessage, createOptimisticMutation, getToastHandler, useMutationWithOptimistic, useMutationWithTransition };

package/dist/core/react.js

@@ -0,0 +1,5 @@
+"use client";
+export { DEFAULT_QUERY_CONFIG, createCrudHooks, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache } from '../chunk-B6MPVOV7.js';
+export { QUERY_CONFIGS, configureToast, createMessage, createOptimisticMutation, getToastHandler, useMutationWithOptimistic, useMutationWithTransition } from '../chunk-U3XT35GZ.js';
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/core/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"react.js"}

package/dist/coupon-BZSZ0y3n.d.ts

@@ -0,0 +1,129 @@
+import { k as QueryKeys, b as CrudHooksReturn, L as ListOptions, l as ListQueryResult, D as DetailOptions, m as DetailQueryResult, d as CrudActions, N as NavigateFn } from './crud.factory-DyKaPHcU.js';
+import { I as PlatformConfig, J as UpdatePlatformConfigPayload, X as PaymentMethodConfig, Q as CheckoutSettings, H as MembershipConfig, g as Branch, h as CreateBranchPayload, j as UpdateBranchPayload, Z as User, n as CreateUserPayload, o as UpdateUserPayload, r as Coupon, t as CreateCouponPayload } from './coupon-CDzL4bJG.js';
+
+declare const PLATFORM_KEYS: QueryKeys;
+interface UsePlatformConfigReturn {
+    config: PlatformConfig | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+interface UsePaymentMethodsReturn {
+    paymentMethods: PaymentMethodConfig[];
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+interface UseDeliveryZonesReturn {
+    deliveryZones: CheckoutSettings["deliveryZones"];
+    freeDeliveryThreshold: number;
+    allowStorePickup: boolean;
+    pickupBranches: CheckoutSettings["pickupBranches"];
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+interface UseMembershipConfigReturn {
+    membership: MembershipConfig | null | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+interface UseUpdatePlatformConfigReturn {
+    updateConfig: (data: UpdatePlatformConfigPayload) => Promise<PlatformConfig | undefined>;
+    isUpdating: boolean;
+    error: Error | null;
+}
+/**
+ * Hook to fetch platform configuration
+ *
+ * @param token - Optional auth token (public access without, authenticated with)
+ * @param select - Optional field selection (e.g., "paymentMethods", "checkout,vat")
+ * @returns Platform config with loading/error states
+ */
+declare function usePlatformConfig(token?: string | null, select?: string | null): UsePlatformConfigReturn;
+/**
+ * Hook to update platform configuration
+ *
+ * @param token - Admin auth token (required)
+ * @returns Mutation function with loading state
+ */
+declare function useUpdatePlatformConfig(token: string): UseUpdatePlatformConfigReturn;
+/**
+ * Hook to fetch payment methods only
+ * Convenience hook for checkout/POS
+ *
+ * @param token - Optional auth token
+ * @returns Payment methods with loading state
+ */
+declare function usePaymentMethods(token?: string | null): UsePaymentMethodsReturn;
+/**
+ * Hook to fetch delivery zones and checkout settings
+ * Convenience hook for checkout flow
+ *
+ * @param token - Optional auth token
+ * @returns Delivery zones and checkout settings
+ */
+declare function useDeliveryZones(token?: string | null): UseDeliveryZonesReturn;
+/**
+ * Hook to fetch membership config only
+ * Convenience hook for loyalty programs
+ *
+ * @param token - Optional auth token
+ * @returns Membership configuration
+ */
+declare function useMembershipConfig(token?: string | null): UseMembershipConfigReturn;
+
+/**
+ * Branch hooks using createCrudHooks factory
+ *
+ * Provides:
+ * - useBranches: List branches with filtering/pagination
+ * - useBranchDetail: Get single branch
+ * - useBranchActions: Create, update, delete mutations
+ * - useBranchNavigation: Navigation between branches
+ */
+declare const branchHooks: CrudHooksReturn<Branch, CreateBranchPayload, UpdateBranchPayload>;
+declare const BRANCH_KEYS: QueryKeys;
+declare const useBranches: (token: string | null, params?: Record<string, unknown>, options?: ListOptions) => ListQueryResult<Branch>;
+declare const useBranchDetail: (id: string | null, token: string | null, options?: DetailOptions) => DetailQueryResult<Branch>;
+declare const useBranchActions: () => CrudActions<CreateBranchPayload, UpdateBranchPayload>;
+declare const useBranchNavigation: () => NavigateFn<Branch>;
+
+/**
+ * User hooks using createCrudHooks factory
+ *
+ * Provides:
+ * - useUsers: List users with filtering/pagination
+ * - useUserDetail: Get single user
+ * - useUserActions: Create, update, delete mutations
+ * - useUserNavigation: Navigation between users
+ */
+declare const userHooks: CrudHooksReturn<User, CreateUserPayload, UpdateUserPayload>;
+declare const USER_KEYS: QueryKeys;
+declare const useUsers: (token: string | null, params?: Record<string, unknown>, options?: ListOptions) => ListQueryResult<User>;
+declare const useUserDetail: (id: string | null, token: string | null, options?: DetailOptions) => DetailQueryResult<User>;
+declare const useUserActions: () => CrudActions<CreateUserPayload, UpdateUserPayload>;
+declare const useUserNavigation: () => NavigateFn<User>;
+
+/**
+ * Coupon hooks using createCrudHooks factory
+ *
+ * Provides:
+ * - useCoupons: List coupons with filtering/pagination
+ * - useCouponDetail: Get single coupon
+ * - useCouponActions: Create, update, delete mutations
+ * - useCouponNavigation: Navigation between coupons
+ */
+declare const couponHooks: CrudHooksReturn<Coupon, CreateCouponPayload, Partial<CreateCouponPayload>>;
+declare const COUPON_KEYS: QueryKeys;
+declare const useCoupons: (token: string | null, params?: Record<string, unknown>, options?: ListOptions) => ListQueryResult<Coupon>;
+declare const useCouponDetail: (id: string | null, token: string | null, options?: DetailOptions) => DetailQueryResult<Coupon>;
+declare const useCouponActions: () => CrudActions<CreateCouponPayload, Partial<CreateCouponPayload>>;
+declare const useCouponNavigation: () => NavigateFn<Coupon>;
+
+export { BRANCH_KEYS as B, COUPON_KEYS as C, PLATFORM_KEYS as P, USER_KEYS as U, useUpdatePlatformConfig as a, usePaymentMethods as b, useDeliveryZones as c, useMembershipConfig as d, branchHooks as e, useBranches as f, useBranchDetail as g, useBranchActions as h, useBranchNavigation as i, userHooks as j, useUsers as k, useUserDetail as l, useUserActions as m, useUserNavigation as n, couponHooks as o, useCoupons as p, useCouponDetail as q, useCouponActions as r, useCouponNavigation as s, type UsePlatformConfigReturn as t, usePlatformConfig as u, type UsePaymentMethodsReturn as v, type UseDeliveryZonesReturn as w, type UseMembershipConfigReturn as x, type UseUpdatePlatformConfigReturn as y };