@bacano/sdk 1.0.0

package/media.d.ts

@@ -0,0 +1,9 @@
+export type MediaUrlVariant = 'original' | 'thumbnail' | 'card' | 'detail';
+export type MediaTransformFormat = 'auto' | 'same' | 'jpeg' | 'webp' | 'png' | 'avif';
+export declare function buildStorageFileUrl(storageUrl: string | undefined, fileId: string, variant?: MediaUrlVariant): string;
+export declare function buildStorageMediaUrls(storageUrl: string | undefined, fileId: string): {
+    originalUrl: string;
+    thumbnailUrl: string;
+    cardUrl: string;
+    detailUrl: string;
+};

package/modules/auth.d.ts

@@ -0,0 +1,9 @@
+import type { AccessTokenProvider, GetWebsitePublicConfigOptions, WebsitePublicConfig } from "../types";
+/** Build a bearer header from a token without inspecting or storing it. */
+export declare function createAuthHeaders(accessToken: string | null | undefined): Record<string, string>;
+export declare function createRequestHeadersProvider(websiteSlug: string, getAccessToken?: AccessTokenProvider): () => Promise<Record<string, string>>;
+/**
+ * Load the browser-safe buyer-auth bootstrap for the current storefront.
+ * Clerk secrets are intentionally never part of this response.
+ */
+export declare function getWebsitePublicConfig(options: GetWebsitePublicConfigOptions): Promise<WebsitePublicConfig>;

package/modules/availability.d.ts

@@ -0,0 +1,6 @@
+import type { ProductAvailability, BacanoClientContext } from '../types';
+import { type RequestHeadersProvider } from '../transport/graphql';
+export interface AvailabilityModule {
+    checkAvailability(productVariantIds: string[]): Promise<ProductAvailability[]>;
+}
+export declare function createAvailabilityModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext): AvailabilityModule;

package/modules/cart-session.d.ts

@@ -0,0 +1,13 @@
+import type { BacanoClientConfig } from '../types';
+export interface CartSession {
+    orderId: string;
+    cartToken: string;
+}
+export interface CartSessionStorage {
+    get(): CartSession | null;
+    set(session: CartSession): void;
+    clear(): void;
+}
+type StorageKind = NonNullable<BacanoClientConfig['tokenStorage']>;
+export declare function createCartSessionStorage(kind: StorageKind, getSlug: () => string): CartSessionStorage;
+export {};

package/modules/cart.d.ts

@@ -0,0 +1,16 @@
+import type { Cart, CartItem, StartGuestCheckoutInput, BacanoClientContext, WebsiteFulfillmentFamily, WebsiteGuestContact } from '../types';
+import { type RequestHeadersProvider } from '../transport/graphql';
+import type { CartSessionStorage } from './cart-session';
+export interface CartModule {
+    getOrCreate(contact?: WebsiteGuestContact, fulfillmentFamily?: WebsiteFulfillmentFamily): Promise<Cart>;
+    startCheckout(input: StartGuestCheckoutInput): Promise<Cart>;
+    get(): Promise<Cart | null>;
+    setItem(productVariantId: string, quantity: number): Promise<Cart>;
+    addItem(productVariantId: string, quantity: number): Promise<CartItem>;
+    updateItem(cartItemId: string, quantity: number): Promise<{
+        id: string;
+        quantity: number;
+    }>;
+    removeItem(cartItemId: string): Promise<Cart>;
+}
+export declare function createCartModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, cartSessionStorage: CartSessionStorage): CartModule;

package/modules/catalog.d.ts

@@ -0,0 +1,24 @@
+import type { Product, ProductPrice, ProductVariantPricing, ProductMedia, ProductMediaKind, ProductCategory, CatalogCategoryList, CatalogAttributeList, Brand, GetProductsOptions, GetCategoryListOptions, GetAttributeListOptions, GetCatalogPageOptions, CatalogPageResult, GetProductRecommendationsOptions, ProductRecommendationsResult, GetProductSeoEntriesOptions, ProductSeoEntriesResult, GetProductFiltersOptions, ProductFilters, SearchSuggestion, GetSearchSuggestionsOptions, BacanoClientContext } from '../types';
+import { type RequestHeadersProvider } from '../transport/graphql';
+export declare function getProductMediaKind(mimeType?: string | null): ProductMediaKind;
+export declare function getProductMediaByKind(media: ProductMedia[] | null | undefined, kind: ProductMediaKind): ProductMedia[];
+export declare function getProductImages(media: ProductMedia[] | null | undefined): ProductMedia[];
+export declare function getProductVideos(media: ProductMedia[] | null | undefined): ProductMedia[];
+export declare function getPrimaryProductImage(media: ProductMedia[] | null | undefined): ProductMedia | null;
+export declare function resolveProductPricing(prices: ProductPrice[]): ProductVariantPricing;
+export interface CatalogModule {
+    getCatalogPage(opts: GetCatalogPageOptions): Promise<CatalogPageResult>;
+    getProductRecommendations(opts: GetProductRecommendationsOptions): Promise<ProductRecommendationsResult>;
+    getProductSeoEntries(opts?: GetProductSeoEntriesOptions): Promise<ProductSeoEntriesResult>;
+    getProducts(opts?: GetProductsOptions): Promise<Product[]>;
+    getProduct(productId: string): Promise<Product | null>;
+    getProductBySlug(slug: string): Promise<Product | null>;
+    getCategories(): Promise<ProductCategory[]>;
+    getCategoryList(opts: GetCategoryListOptions): Promise<CatalogCategoryList | null>;
+    getAttributeList(opts: GetAttributeListOptions): Promise<CatalogAttributeList | null>;
+    getBrands(): Promise<Brand[]>;
+    getProductFilters(opts?: GetProductFiltersOptions): Promise<ProductFilters>;
+    getSearchSuggestions(opts: GetSearchSuggestionsOptions): Promise<SearchSuggestion[]>;
+    checkAvailability: never;
+}
+export declare function createCatalogModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, storageUrl?: string): Omit<CatalogModule, 'checkAvailability'>;

package/modules/checkout.d.ts

@@ -0,0 +1,42 @@
+import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext, CheckoutResult, CheckoutSubmission, WebsiteCheckoutAddress, WebsiteCheckoutItem, WebsiteCouponActionResult, WebsiteDeliveryOption, WebsiteFreeShippingProgress, WebsiteLocationOptions, WebsitePaymentMethod, WebsitePaymentOption, WebsitePaymentSessionResult, WebsiteShippingPolicy, WebsiteShippingQuote } from "../types";
+import type { CartSessionStorage } from "./cart-session";
+export interface CheckoutModule {
+    getLocationOptions(): Promise<WebsiteLocationOptions>;
+    getDeliveryOptions(): Promise<WebsiteDeliveryOption[]>;
+    getShippingQuotes(input: {
+        address: WebsiteCheckoutAddress;
+        items?: WebsiteCheckoutItem[];
+    }): Promise<WebsiteShippingQuote[]>;
+    getShippingPolicy(): Promise<WebsiteShippingPolicy>;
+    getFreeShippingProgress(input: {
+        items: WebsiteCheckoutItem[];
+    }): Promise<WebsiteFreeShippingProgress>;
+    getPaymentMethods(): Promise<WebsitePaymentMethod[]>;
+    getPaymentOptions(input: {
+        fulfillmentFamily: "PICKUP" | "SHIPPING";
+    }): Promise<WebsitePaymentOption[]>;
+    validateCoupon(input: {
+        code: string;
+    }): Promise<WebsiteCouponActionResult>;
+    applyCoupon(input: {
+        code: string;
+    }): Promise<WebsiteCouponActionResult>;
+    removeCoupon(input: {
+        couponId: string;
+    }): Promise<WebsiteCouponActionResult>;
+    submit(input: CheckoutSubmission): Promise<CheckoutResult>;
+    createPaymentSession(input: {
+        orderId?: string;
+        publicOrderToken?: string;
+        paymentMethodId: string;
+        returnUrl: string;
+    }): Promise<WebsitePaymentSessionResult>;
+    reconcilePaymentSession(input: {
+        orderId: string;
+        publicOrderToken: string;
+        paymentSessionId: string;
+        gatewayTransactionId: string;
+    }): Promise<WebsitePaymentSessionResult>;
+}
+export declare function createCheckoutModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, cartSessionStorage: CartSessionStorage): CheckoutModule;

package/modules/content.d.ts

@@ -0,0 +1,9 @@
+import type { GetContentOptions, ContentEntry, ProductContentBlock, BacanoClientContext } from '../types';
+import { type RequestHeadersProvider } from '../transport/graphql';
+export interface ContentModule {
+    getByKey(key: string, opts?: GetContentOptions): Promise<ContentEntry | null>;
+    getByCategory(categoryKey: string, opts?: GetContentOptions): Promise<ContentEntry[]>;
+    getByTag(tag: string, opts?: GetContentOptions): Promise<ContentEntry[]>;
+    getForProduct(productId: string, opts?: GetContentOptions): Promise<ProductContentBlock[]>;
+}
+export declare function createContentModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, storageUrl?: string): ContentModule;

package/modules/orders.d.ts

@@ -0,0 +1,9 @@
+import type { BacanoClientContext, GetOrdersOptions, Order, PublicOrder, PublicOrderLookupInput, WaitForPublicOrderPaymentInput } from '../types';
+import { type RequestHeadersProvider } from '../transport/graphql';
+export interface OrdersModule {
+    list(opts?: GetOrdersOptions): Promise<Order[]>;
+    get(orderId: string): Promise<Order | null>;
+    getPublicOrder(input: PublicOrderLookupInput): Promise<PublicOrder | null>;
+    waitForPayment(input: WaitForPublicOrderPaymentInput): Promise<PublicOrder>;
+}
+export declare function createOrdersModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext): OrdersModule;

package/modules/profile.d.ts

@@ -0,0 +1,8 @@
+import type { CustomerAddress, CustomerProfile, CustomerProfileUpdate } from "../types";
+import { type RequestHeadersProvider } from "../transport/graphql";
+export interface ProfileModule {
+    get(): Promise<CustomerProfile>;
+    getAddresses(): Promise<CustomerAddress[]>;
+    update(data: CustomerProfileUpdate): Promise<CustomerProfile>;
+}
+export declare function createProfileModule(graphqlUrl: string, getHeaders: RequestHeadersProvider): ProfileModule;

package/modules/website.d.ts

@@ -0,0 +1,3 @@
+import type { BacanoClientContext } from "../types";
+import { type RequestHeadersProvider } from "../transport/graphql";
+export declare function resolveWebsite(graphqlUrl: string, slug: string, headers?: RequestHeadersProvider): Promise<BacanoClientContext>;

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@bacano/sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for building websites on the Bacano ERP",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    },
+    "./graphql": {
+      "types": "./graphql.d.ts",
+      "import": "./graphql.js",
+      "require": "./graphql.cjs"
+    },
+    "./react": {
+      "types": "./react.d.ts",
+      "import": "./react.js",
+      "require": "./react.cjs"
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pulpo-labs/erp.git",
+    "directory": "libs/sdk"
+  },
+  "homepage": "https://github.com/pulpo-labs/erp/tree/main/libs/sdk#readme",
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "bacano",
+    "erp",
+    "website",
+    "sdk",
+    "graphql",
+    "ecommerce"
+  ],
+  "license": "MIT"
+}

package/react/context.d.ts

@@ -0,0 +1,7 @@
+import type { BacanoClient } from '../client';
+export interface BacanoClientContextValue {
+    client: BacanoClient | null;
+    loading: boolean;
+    error: Error | null;
+}
+export declare const BacanoReactContext: import("react").Context<BacanoClientContextValue>;

package/react/hooks.d.ts

@@ -0,0 +1,74 @@
+import type { BacanoClient } from '../client';
+import type { Product, ProductCategory, CatalogCategoryList, CatalogAttributeList, Brand, ProductAvailability, ProductFilters, GetProductsOptions, GetCategoryListOptions, GetAttributeListOptions, GetProductFiltersOptions, SearchSuggestion, GetSearchSuggestionsOptions, ContentEntry, GetContentOptions, Cart, CartItem, StartGuestCheckoutInput, WebsiteFulfillmentFamily, WebsiteGuestContact, CheckoutSubmission, CheckoutResult, Order, GetOrdersOptions, CustomerProfile, CustomerProfileUpdate, AsyncState } from '../types';
+/** Returns the initialized BacanoClient instance */
+export declare function useBacano(): BacanoClient;
+/** Returns the initialization state (for loading/error handling) */
+export declare function useBacanoState(): import("./context").BacanoClientContextValue;
+export declare function useProducts(opts?: GetProductsOptions): AsyncState<Product[]> & {
+    refetch: () => void;
+};
+export declare function useProduct(productId: string | null): AsyncState<Product | null> & {
+    refetch: () => void;
+};
+export declare function useCategories(): AsyncState<ProductCategory[]> & {
+    refetch: () => void;
+};
+export declare function useCategoryList(opts: GetCategoryListOptions | null): AsyncState<CatalogCategoryList | null> & {
+    refetch: () => void;
+};
+export declare function useAttributeList(opts: GetAttributeListOptions | null): AsyncState<CatalogAttributeList | null> & {
+    refetch: () => void;
+};
+export declare function useBrands(): AsyncState<Brand[]> & {
+    refetch: () => void;
+};
+export declare function useProductFilters(opts?: GetProductFiltersOptions): AsyncState<ProductFilters> & {
+    refetch: () => void;
+};
+export declare function useSearchSuggestions(opts?: GetSearchSuggestionsOptions): AsyncState<SearchSuggestion[]> & {
+    refetch: () => void;
+};
+export declare function useAvailability(productVariantIds: string[]): AsyncState<ProductAvailability[]> & {
+    refetch: () => void;
+};
+export declare function useContentByKey(key: string | null, opts?: GetContentOptions): AsyncState<ContentEntry | null> & {
+    refetch: () => void;
+};
+export declare function useContentByCategory(categoryKey: string | null, opts?: GetContentOptions): AsyncState<ContentEntry[]> & {
+    refetch: () => void;
+};
+export declare function useContentByTag(tag: string | null, opts?: GetContentOptions): AsyncState<ContentEntry[]> & {
+    refetch: () => void;
+};
+export declare function useCart(): {
+    cart: Cart | null;
+    loading: boolean;
+    error: Error | null;
+    getOrCreate: (contact?: WebsiteGuestContact, fulfillmentFamily?: WebsiteFulfillmentFamily) => Promise<Cart>;
+    startCheckout: (input: StartGuestCheckoutInput) => Promise<Cart>;
+    addItem: (productVariantId: string, quantity: number) => Promise<CartItem>;
+    updateItem: (cartItemId: string, quantity: number) => Promise<{
+        id: string;
+        quantity: number;
+    }>;
+    removeItem: (cartItemId: string) => Promise<void>;
+    refresh: () => Promise<void>;
+};
+export declare function useCheckout(): {
+    checkout: (input: CheckoutSubmission) => Promise<CheckoutResult>;
+    loading: boolean;
+    error: Error | null;
+};
+export declare function useOrders(opts?: GetOrdersOptions): AsyncState<Order[]> & {
+    refetch: () => void;
+};
+export declare function useOrder(orderId: string | null): AsyncState<Order | null> & {
+    refetch: () => void;
+};
+export declare function useProfile(): {
+    profile: CustomerProfile | null;
+    loading: boolean;
+    error: Error | null;
+    updateProfile: (data: CustomerProfileUpdate) => Promise<CustomerProfile>;
+    refresh: () => void;
+};

package/react/provider.d.ts

@@ -0,0 +1,7 @@
+import { type JSX, type ReactNode } from "react";
+import type { BacanoClientConfig } from "../types";
+export interface BacanoProviderProps {
+    config: BacanoClientConfig;
+    children: ReactNode;
+}
+export declare function BacanoProvider({ config, children, }: BacanoProviderProps): JSX.Element;