@yoamigo.com/core 0.4.7 → 1.0.0

package/dist/cart-storage-DFdGPcwm.d.ts

@@ -0,0 +1,176 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type EditMode = 'read-only' | 'inline-edit';
+type ChangeSource = 'user' | 'ai' | 'initial';
+interface PageInfo {
+    path: string;
+    label: string;
+}
+interface ActiveFieldCallbacks {
+    close: () => void;
+}
+interface ContentStore {
+    getValue: (fieldId: string) => string;
+    setValue: (fieldId: string, value: string, source?: ChangeSource) => void;
+    getChangeSource: (fieldId: string) => ChangeSource;
+    clearChangeSource: (fieldId: string) => void;
+    mode: EditMode;
+    setMode: (mode: EditMode) => void;
+    subscribe: (listener: () => void) => () => void;
+    saveToWorker?: (fieldId: string, value: string) => Promise<void>;
+    activeFieldId: string | null;
+    setActiveField: (fieldId: string, callbacks: ActiveFieldCallbacks) => void;
+    clearActiveField: () => void;
+    getPages: () => PageInfo[];
+}
+type ContentStoreContextType = ContentStore;
+type ContentStoreMode = EditMode;
+declare function useContentStore(): ContentStoreContextType;
+interface ContentStoreProviderProps {
+    children: ReactNode;
+    initialContent?: Record<string, string>;
+    initialMode?: EditMode;
+    pages?: PageInfo[];
+}
+declare function ContentStoreProvider({ children, initialContent, initialMode, pages, }: ContentStoreProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Collection Client
+ *
+ * Handles communication with the backend API for collection data.
+ * Used for fetching collection records on published sites and builder preview.
+ */
+interface QueryFilter {
+    field: string;
+    operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'contains' | 'startsWith' | 'endsWith' | 'isNull' | 'isNotNull';
+    value: unknown;
+}
+interface CollectionRecord<T = Record<string, unknown>> {
+    id: string;
+    appId: string;
+    collectionId: string;
+    ownerId: string | null;
+    data: T;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ListOptions {
+    filters?: QueryFilter[];
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDir?: 'asc' | 'desc';
+}
+interface ListResponse<T> {
+    success: boolean;
+    data?: CollectionRecord<T>[];
+    totalCount?: number;
+    error?: string;
+    errorCode?: string;
+}
+interface SingleResponse<T> {
+    success: boolean;
+    data?: CollectionRecord<T>;
+    error?: string;
+    errorCode?: string;
+}
+interface CollectionClientConfig {
+    apiUrl: string;
+    appId: string;
+}
+declare class CollectionClient {
+    private apiUrl;
+    private appId;
+    constructor(config: CollectionClientConfig);
+    /**
+     * List records from a collection with optional filtering, pagination, and sorting.
+     */
+    list<T = Record<string, unknown>>(collection: string, options?: ListOptions): Promise<ListResponse<T>>;
+    /**
+     * Get a single record by its ID.
+     */
+    getById<T = Record<string, unknown>>(collection: string, id: string): Promise<SingleResponse<T>>;
+    /**
+     * Get a single record by a slug field value.
+     * Convenience method that uses list with a filter.
+     */
+    getBySlug<T = Record<string, unknown>>(collection: string, slugField: string, slugValue: string): Promise<SingleResponse<T>>;
+}
+/**
+ * Get the global CollectionClient instance.
+ * Uses window.YOAMIGO_CONFIG for configuration.
+ */
+declare function getCollectionClient(): CollectionClient;
+/**
+ * Reset the cached client (useful for testing or when config changes).
+ */
+declare function resetCollectionClient(): void;
+
+/**
+ * Initialize builder selection when running in iframe
+ */
+declare function initBuilderSelection(): void;
+
+/**
+ * Cart Storage Helpers
+ *
+ * Handles localStorage persistence for guest carts and session management.
+ * Used for fallback when user is not logged in.
+ */
+interface CartItem {
+    id: string;
+    productId: string;
+    collectionSlug: string;
+    quantity: number;
+    variantId?: string;
+    addedAt: string;
+    data?: Record<string, unknown>;
+}
+interface LocalCart {
+    sessionId: string;
+    items: CartItem[];
+    updatedAt: string;
+}
+/**
+ * Get or create a session ID for the current browser.
+ */
+declare function getSessionId(): string;
+/**
+ * Clear the current session ID (e.g., after successful cart merge).
+ */
+declare function clearSessionId(): void;
+/**
+ * Get the local cart from localStorage.
+ */
+declare function getLocalCart(appId: string): LocalCart | null;
+/**
+ * Save cart to localStorage.
+ */
+declare function saveLocalCart(appId: string, items: CartItem[]): void;
+/**
+ * Clear the local cart.
+ */
+declare function clearLocalCart(appId: string): void;
+/**
+ * Get items from local cart.
+ */
+declare function getLocalCartItems(appId: string): CartItem[];
+/**
+ * Add item to local cart.
+ */
+declare function addLocalCartItem(appId: string, productId: string, collectionSlug: string, quantity?: number, variantId?: string, data?: Record<string, unknown>): CartItem[];
+/**
+ * Update item quantity in local cart.
+ */
+declare function updateLocalCartItem(appId: string, itemId: string, quantity: number): CartItem[];
+/**
+ * Remove item from local cart.
+ */
+declare function removeLocalCartItem(appId: string, itemId: string): CartItem[];
+/**
+ * Get cart item count.
+ */
+declare function getLocalCartItemCount(appId: string): number;
+
+export { type ChangeSource as C, type EditMode as E, type ListOptions as L, type QueryFilter as Q, type SingleResponse as S, CollectionClient as a, type CollectionRecord as b, type ListResponse as c, type CollectionClientConfig as d, getSessionId as e, clearSessionId as f, getCollectionClient as g, getLocalCart as h, initBuilderSelection as i, clearLocalCart as j, getLocalCartItems as k, addLocalCartItem as l, removeLocalCartItem as m, getLocalCartItemCount as n, type CartItem as o, ContentStoreProvider as p, useContentStore as q, resetCollectionClient as r, saveLocalCart as s, type ContentStoreContextType as t, updateLocalCartItem as u, type ContentStoreMode as v };