@use-stall/core 0.0.2 → 0.0.3

package/dist/index.d.mts

@@ -1,673 +1,706 @@
-import { UnifiedOrderType, UnifiedProductType, UnifiedOrderRefundType, ConnectorConfigurationType } from '@use-stall/types';
+import { ConnectorModuleKey, UnifiedProductType, UnifiedVariantsType, UnifiedCollectionType, UnifiedCategoryType, UnifiedInventoryLevelType, UnifiedPromotion, UnifiedOrderType, UnifiedOrderNote, UnifiedOrderRefundType, UnifiedPaymentProviderType, UnifiedPaymentCollectionType, UnifiedTaxRegionType, UnifiedTaxRateType, UnifiedCustomerType, UnifiedLocationType, UnifiedFulfillmentType } from '@use-stall/types';
 
-/**
- * Response type for plugin operations
- */
-interface ConnectorResponse<T = any> {
-    success: boolean;
-    data?: T;
-    error?: {
-        code: string;
-        message: string;
-        details?: Record<string, any>;
-    };
-    metadata?: {
-        timestamp: number;
-        connector_id: string;
-        operation: string;
-        request_id: string;
-    };
-}
-/**
- * Pagination options for list operations
- */
-interface PaginationOptions {
-    limit?: number;
-    offset?: number;
-    page?: number;
-    per_page?: number;
-    sort?: string;
-    order?: "asc" | "desc";
-}
-/**
- * Plugin metadata and capabilities
- */
-interface PluginMetadata {
-    id: string;
-    version: string;
-    name: string;
-    description: string;
-}
-interface ModuleCapability {
-    module: "orders" | "products" | "customers" | "refunds" | "inventory" | "payments";
-    actions: {
-        create?: boolean;
-        read?: boolean;
-        update?: boolean;
-        delete?: boolean;
-    };
-}
-/**
- * Configuration passed to connector plugins
- */
-interface ConnectorPluginConfig {
-    /**
-     * The connector ID from the database
-     */
-    connectorId: string;
-    /**
-     * The integration ID (e.g., woocommerce, shopify)
-     */
-    integrationId: string;
-    /**
-     * Organization ID for context
-     */
-    organizationId: string;
-    /**
-     * Decrypted connector configuration with credentials
-     */
-    configuration: {
-        endpoint: string;
-        username?: string;
-        password?: string;
-        token?: string;
-        api_key_header?: string;
-        api_key_value?: string;
-        [key: string]: any;
-    };
-    /**
-     * Optional additional options
-     */
-    options?: {
-        timeout?: number;
-        retries?: number;
-        logLevel?: "debug" | "info" | "warn" | "error";
-        [key: string]: any;
-    };
-}
-/**
- * Base plugin interface that all connectors must implement
- */
-interface IConnectorPlugin {
-    metadata: PluginMetadata;
-    /**
-     * Initialize the plugin with configuration
-     */
-    initialize(config: ConnectorPluginConfig): Promise<void>;
-    /**
-     * Verify the configuration is valid and credentials work
-     */
-    verify(): Promise<ConnectorResponse<boolean>>;
-    /**
-     * Get supported modules for this connector
-     */
-    getSupportedModules(): string[];
-    /**
-     * Order-related operations
-     */
-    orders: {
-        create(order: UnifiedOrderType): Promise<ConnectorResponse<any>>;
-        get(orderId: string): Promise<ConnectorResponse<any>>;
-        update(orderId: string, order: Partial<UnifiedOrderType>): Promise<ConnectorResponse<any>>;
-        delete(orderId: string): Promise<ConnectorResponse<any>>;
-        list(options?: PaginationOptions & {
-            [key: string]: any;
-        }): Promise<ConnectorResponse<any[]>>;
-    };
-    /**
-     * Product-related operations
-     */
-    products: {
-        create(product: UnifiedProductType): Promise<ConnectorResponse<any>>;
-        get(productId: string): Promise<ConnectorResponse<any>>;
-        update(productId: string, product: Partial<UnifiedProductType>): Promise<ConnectorResponse<any>>;
-        delete(productId: string): Promise<ConnectorResponse<any>>;
-        list(options?: PaginationOptions & {
-            [key: string]: any;
-        }): Promise<ConnectorResponse<any[]>>;
-    };
-    /**
-     * Customer-related operations
-     */
-    customers: {
-        create(customer: any): Promise<ConnectorResponse<any>>;
-        get(customerId: string): Promise<ConnectorResponse<any>>;
-        update(customerId: string, customer: any): Promise<ConnectorResponse<any>>;
-        delete(customerId: string): Promise<ConnectorResponse<any>>;
-        list(options?: PaginationOptions & {
-            [key: string]: any;
-        }): Promise<ConnectorResponse<any[]>>;
-    };
-    /**
-     * Inventory/Stock-related operations
-     */
-    inventory: {
-        get(productId: string, variantId?: string): Promise<ConnectorResponse<any>>;
-        update(productId: string, inventory: any, variantId?: string): Promise<ConnectorResponse<any>>;
-        list(options?: PaginationOptions & {
-            [key: string]: any;
-        }): Promise<ConnectorResponse<any[]>>;
-    };
-    /**
-     * Refund-related operations
-     */
-    refunds: {
-        create(orderId: string, refund: UnifiedOrderRefundType): Promise<ConnectorResponse<any>>;
-        get(refundId: string): Promise<ConnectorResponse<any>>;
-        list(orderId: string, options?: PaginationOptions & {
-            [key: string]: any;
-        }): Promise<ConnectorResponse<any[]>>;
-    };
-    /**
-     * Payment-related operations
-     */
-    payments: {
-        create(payment: any): Promise<ConnectorResponse<any>>;
-        get(paymentId: string): Promise<ConnectorResponse<any>>;
-        list(options?: PaginationOptions & {
-            [key: string]: any;
-        }): Promise<ConnectorResponse<any[]>>;
-    };
-    /**
-     * Webhook support (optional)
-     */
-    webhooks?: {
-        register(url: string, events: string[]): Promise<ConnectorResponse<any>>;
-        unregister(webhookId: string): Promise<ConnectorResponse<any>>;
-        verifySignature(payload: string, signature: string): Promise<ConnectorResponse<boolean>>;
-    };
-}
-/**
- * Plugin constructor type for dynamic loading
- */
-type PluginConstructor = new () => IConnectorPlugin;
-/**
- * Plugin module structure when loaded from storage
- */
-interface PluginModule {
-    default: PluginConstructor;
-    Plugin?: PluginConstructor;
+interface StallCoreConfigOptions {
+  connector_url: string;
+  version: string;
+  configuration: Record<string, any>;
 }
 
-/**
- * Options for initializing the Stall SDK
- * Uses ConnectorConfigurationType directly for configuration
- */
-interface StallSDKOptions extends ConnectorConfigurationType {
-    /**
-     * Optional additional options
-     */
-    options?: {
-        timeout?: number;
-        retries?: number;
-        logLevel?: "debug" | "info" | "warn" | "error";
-        cachePlugins?: boolean;
-        connectorUrl?: string;
-        [key: string]: any;
-    };
-}
-/**
- * Connector loader options
- */
-interface ConnectorLoaderOptions {
-    /**
-     * Base URL for loading connector plugins
-     * e.g., https://connectors.myapp.xyz
-     */
-    connectorUrl: string;
-    /**
-     * Whether to cache loaded plugins in memory
-     */
-    cache?: boolean;
-    /**
-     * Cache TTL in milliseconds (default: 1 hour)
-     */
-    cacheTtl?: number;
-}
-/**
- * Error response from connector operations
- */
-interface ConnectorError extends Error {
-    code: string;
-    details?: any;
-    statusCode?: number;
-}
-/**
- * Operation metadata
- */
-interface OperationMetadata {
-    connector_id: string;
-    integration_id: string;
-    organization_id: string;
-    operation: string;
-    timestamp: number;
-    request_id: string;
-}
-/**
- * Batch operation options
- */
-interface BatchOperationOptions {
-    /**
-     * Whether to stop on first error
-     */
-    stopOnError?: boolean;
-    /**
-     * Parallel execution count
-     */
-    parallel?: number;
-    /**
-     * Timeout per item in milliseconds
-     */
-    timeout?: number;
+interface CoreConfig {
+  options: StallCoreConfigOptions;
+  adapter: () => Promise<AdapterModuleType>;
+  refreshAdapter: () => Promise<AdapterModuleType>;
 }
 
-/**
- * Manages connector plugin lifecycle and operations
- */
-declare class PluginManager {
-    private plugin;
-    private logger;
-    private connectorLoader;
-    private initialized;
-    constructor(logLevel?: "debug" | "info" | "warn" | "error");
-    /**
-     * Initialize the plugin manager with a plugin
-     */
-    initialize(plugin: IConnectorPlugin | null, options: StallSDKOptions): Promise<void>;
-    /**
-     * Get the loaded plugin
-     */
-    getPlugin(): IConnectorPlugin;
-    /**
-     * Check if plugin is initialized
-     */
-    isInitialized(): boolean;
-    /**
-     * Verify the plugin configuration
-     */
-    verify(): Promise<boolean>;
-    /**
-     * Get metadata about the loaded plugin
-     */
-    getMetadata(): {
-        id: string;
-        name: string;
-        version: string;
-        description: string;
-        supportedModules: string[];
-    };
-    /**
-     * Check if a module is supported
-     */
-    isModuleSupported(module: string): boolean;
-    /**
-     * Clear plugin cache (if using remote loading)
-     */
-    clearCache(): void;
-}
+type ModuleTypeMap = {
+  products: UnifiedProductType;
+  variants: UnifiedVariantsType;
+  collections: UnifiedCollectionType;
+  categories: UnifiedCategoryType;
+  tags: string;
+  inventory_levels: UnifiedInventoryLevelType;
+  inventory_history: UnifiedInventoryLevelType;
+  promotions: UnifiedPromotion;
+  orders: UnifiedOrderType;
+  order_notes: UnifiedOrderNote;
+  refunds: UnifiedOrderRefundType;
+  payment_providers: UnifiedPaymentProviderType;
+  payments: UnifiedPaymentCollectionType;
+  tax_regions: UnifiedTaxRegionType;
+  tax_rates: UnifiedTaxRateType;
+  customers: UnifiedCustomerType;
+  locations: UnifiedLocationType;
+  fulfillment_types: string;
+  fulfillment_providers: string;
+  fulfillments: UnifiedFulfillmentType;
+};
 
-type LogLevel = "debug" | "info" | "warn" | "error";
-/**
- * Simple logger for SDK operations
- */
-declare class Logger {
-    private level;
-    private context;
-    constructor(context?: string, level?: LogLevel);
-    private shouldLog;
-    private format;
-    debug(message: string, data?: any): void;
-    info(message: string, data?: any): void;
-    warn(message: string, data?: any): void;
-    error(message: string, error?: Error | any): void;
-    setLevel(level: LogLevel): void;
-}
-/**
- * Create a logger instance
- */
-declare function createLogger(context?: string, level?: LogLevel): Logger;
+type GetModuleType<K extends ConnectorModuleKey> = K extends keyof ModuleTypeMap
+  ? ModuleTypeMap[K]
+  : never;
 
-/**
- * Base service class for all connector operations
- */
-declare abstract class BaseService {
-    protected logger: Logger;
-    protected pluginManager: PluginManager;
-    protected connectorId: string;
-    constructor(pluginManager: PluginManager, connectorId: string, serviceName: string);
-    /**
-     * Wrap a connector operation with error handling and logging
-     */
-    protected executeOperation<T>(operation: string, fn: () => Promise<ConnectorResponse<T>>): Promise<ConnectorResponse<T>>;
-    /**
-     * Check if a module is supported
-     */
-    protected isModuleSupported(module: string): boolean;
-    /**
-     * Get the plugin instance
-     */
-    protected getPlugin(): IConnectorPlugin;
-    /**
-     * Verify plugin is ready
-     */
-    protected ensurePluginInitialized(): void;
-}
+type AdapterModuleType = {
+  [K in ConnectorModuleKey]: {
+    list: (props: {
+      connector_config: Record<string, any>;
+      query?: string;
+    }) => Promise<GetModuleType<K>[]>;
+    retrieve: (props: {
+      connector_config: Record<string, any>;
+      id: string;
+    }) => Promise<GetModuleType<K>>;
+    create: (props: {
+      connector_config: Record<string, any>;
+      data: GetModuleType<K>;
+    }) => Promise<GetModuleType<K>>;
+    update: (props: {
+      connector_config: Record<string, any>;
+      id: string;
+      data: Partial<GetModuleType<K>>;
+    }) => Promise<GetModuleType<K>>;
+    delete: (props: {
+      connector_config: Record<string, any>;
+      id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+      connector_config: Record<string, any>;
+      data: GetModuleType<K>[];
+    }) => Promise<GetModuleType<K>[]>;
+    bulk_update: (props: {
+      connector_config: Record<string, any>;
+      data: Array<{ id: string; data: Partial<GetModuleType<K>> }>;
+    }) => Promise<GetModuleType<K>[]>;
+    bulk_delete: (props: {
+      connector_config: Record<string, any>;
+      ids: string[];
+    }) => Promise<void>;
+  };
+};
 
-/**
- * Service for managing orders through connectors
- */
-declare class OrdersService extends BaseService {
-    constructor(pluginManager: PluginManager, connectorId: string);
-    /**
-     * Create a new order
-     */
-    createOrder(order: UnifiedOrderType): Promise<ConnectorResponse<UnifiedOrderType>>;
-    /**
-     * Get an order by ID
-     */
-    getOrder(orderId: string): Promise<ConnectorResponse<UnifiedOrderType>>;
-    /**
-     * Update an existing order
-     */
-    updateOrder(orderId: string, order: Partial<UnifiedOrderType>): Promise<ConnectorResponse<UnifiedOrderType>>;
-    /**
-     * Delete/cancel an order
-     */
-    deleteOrder(orderId: string): Promise<ConnectorResponse<void>>;
-    /**
-     * List orders with optional filtering
-     */
-    listOrders(options?: PaginationOptions & {
-        [key: string]: any;
-    }): Promise<ConnectorResponse<UnifiedOrderType[]>>;
-    /**
-     * Create a refund for an order
-     */
-    createRefund(orderId: string, refund: UnifiedOrderRefundType): Promise<ConnectorResponse<UnifiedOrderRefundType>>;
-    /**
-     * Get a refund by ID
-     */
-    getRefund(refundId: string): Promise<ConnectorResponse<UnifiedOrderRefundType>>;
-    /**
-     * List refunds for an order
-     */
-    listRefunds(orderId: string, options?: PaginationOptions & {
-        [key: string]: any;
-    }): Promise<ConnectorResponse<UnifiedOrderRefundType[]>>;
-}
+declare const initializeStallCore: (options: StallCoreConfigOptions) => CoreConfig;
 
-/**
- * Service for managing products through connectors
- */
-declare class ProductsService extends BaseService {
-    constructor(pluginManager: PluginManager, connectorId: string);
-    /**
-     * Create a new product
-     */
-    createProduct(product: UnifiedProductType): Promise<ConnectorResponse<UnifiedProductType>>;
-    /**
-     * Get a product by ID
-     */
-    getProduct(productId: string): Promise<ConnectorResponse<UnifiedProductType>>;
-    /**
-     * Update an existing product
-     */
-    updateProduct(productId: string, product: Partial<UnifiedProductType>): Promise<ConnectorResponse<UnifiedProductType>>;
-    /**
-     * Delete a product
-     */
-    deleteProduct(productId: string): Promise<ConnectorResponse<void>>;
-    /**
-     * List products with optional filtering
-     */
-    listProducts(options?: PaginationOptions & {
-        [key: string]: any;
-    }): Promise<ConnectorResponse<UnifiedProductType[]>>;
-}
+declare const products: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedProductType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedProductType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedProductType;
+    }) => Promise<UnifiedProductType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedProductType>;
+    }) => Promise<UnifiedProductType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedProductType[];
+    }) => Promise<UnifiedProductType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedProductType>;
+        }>;
+    }) => Promise<UnifiedProductType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
 
-/**
- * Main Stall Core for unified connector access
- * Firebase-style initialization using ConnectorConfigurationType
- *
- * Usage:
- * const stall = await StallCore.initialize({
- *   id: 'config_123',
- *   integration_id: 'woocommerce',
- *   created_at: Date.now(),
- *   updated_at: Date.now(),
- *   configuration: {
- *     endpoint: 'https://myshop.com',
- *     token: 'decrypted_token',
- *   },
- *   options: {
- *     logLevel: 'info',
- *     connectorUrl: 'https://connectors.myapp.xyz'
- *   }
- * });
- *
- * // Then use services
- * const result = await stall.orders.createOrder(unifiedOrder);
- * const products = await stall.products.listProducts();
- */
-declare class StallCore {
-    private pluginManager;
-    private logger;
-    private options;
-    orders: OrdersService;
-    products: ProductsService;
-    private constructor();
-    /**
-     * Firebase-style initialization with automatic plugin loading
-     * Loads connector from public URL: {connectorUrl}/{integration_id}/index.js
-     * Default URL: https://connectors.myapp.xyz
-     */
-    static initialize(options: StallSDKOptions): Promise<StallCore>;
-    /**
-     * Initialize with a provided plugin instance (for testing/custom plugins)
-     * Useful for mock plugins or custom implementations
-     */
-    static initializeWithPlugin(options: StallSDKOptions, plugin: IConnectorPlugin): Promise<StallCore>;
-    /**
-     * Get plugin metadata
-     */
-    getMetadata(): {
-        id: string;
-        name: string;
-        version: string;
-        description: string;
-        supportedModules: string[];
-    };
-    /**
-     * Verify the connector configuration
-     */
-    verify(): Promise<boolean>;
-    /**
-     * Check if a module is supported
-     */
-    isModuleSupported(module: string): boolean;
-    /**
-     * Check if SDK is initialized
-     */
-    isInitialized(): boolean;
-    /**
-     * Clear plugin cache
-     */
-    clearCache(): void;
-    /**
-     * Get the underlying plugin instance
-     */
-    getPlugin(): IConnectorPlugin;
-    /**
-     * Get SDK configuration
-     */
-    getConfiguration(): {
-        id: string;
-        integration_id: string;
-        created_at: number;
-        updated_at: number;
-    };
-}
+declare const orders: {
+    list: (props: {
+        sdk: CoreConfig;
+        query?: string;
+    }) => Promise<UnifiedOrderType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedOrderType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedOrderType;
+    }) => Promise<UnifiedOrderType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedOrderType>;
+    }) => Promise<UnifiedOrderType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedOrderType[];
+    }) => Promise<UnifiedOrderType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedOrderType>;
+        }>;
+    }) => Promise<UnifiedOrderType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
 
-/**
- * Loads connector plugins from a public URL
- * Example: https://connectors.myapp.xyz/woocommerce/index.js
- */
-declare class ConnectorLoader {
-    private logger;
-    private connectorUrl;
-    private cache;
-    private cacheTtl;
-    constructor(options: ConnectorLoaderOptions);
-    /**
-     * Load a connector plugin from public URL
-     * URL pattern: {connectorUrl}/{integrationId}/index.js
-     */
-    loadConnector(integrationId: string): Promise<IConnectorPlugin>;
-    /**
-     * Instantiate a plugin from code
-     */
-    private instantiatePlugin;
-    /**
-     * Validate that an object implements IConnectorPlugin
-     */
-    private validatePlugin;
-    /**
-     * Build the connector plugin URL
-     * Pattern: {connectorUrl}/{integrationId}/index.js
-     */
-    private buildConnectorUrl;
-    /**
-     * Create a proxy for require() in loaded plugins
-     */
-    private createRequireProxy;
-    /**
-     * Clear the cache
-     */
-    clearCache(): void;
-    /**
-     * Remove a specific plugin from cache
-     */
-    removeCacheEntry(integrationId: string): void;
-}
+declare const customers: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedCustomerType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedCustomerType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedCustomerType;
+    }) => Promise<UnifiedCustomerType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedCustomerType>;
+    }) => Promise<UnifiedCustomerType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedCustomerType[];
+    }) => Promise<UnifiedCustomerType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedCustomerType>;
+        }>;
+    }) => Promise<UnifiedCustomerType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
 
-/**
- * Custom error class for connector operations
- */
-declare class StallConnectorError extends Error implements ConnectorError {
-    code: string;
-    details?: any;
-    statusCode?: number;
-    constructor(message: string, code: string, statusCode?: number, details?: any);
-}
-/**
- * Error codes for various connector operations
- */
-declare const ErrorCodes: {
-    readonly INVALID_CONFIGURATION: "INVALID_CONFIGURATION";
-    readonly MISSING_CREDENTIALS: "MISSING_CREDENTIALS";
-    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
-    readonly PLUGIN_LOAD_FAILED: "PLUGIN_LOAD_FAILED";
-    readonly PLUGIN_NOT_FOUND: "PLUGIN_NOT_FOUND";
-    readonly OPERATION_FAILED: "OPERATION_FAILED";
-    readonly OPERATION_TIMEOUT: "OPERATION_TIMEOUT";
-    readonly OPERATION_NOT_SUPPORTED: "OPERATION_NOT_SUPPORTED";
-    readonly NETWORK_ERROR: "NETWORK_ERROR";
-    readonly REQUEST_FAILED: "REQUEST_FAILED";
-    readonly RATE_LIMITED: "RATE_LIMITED";
-    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
-    readonly INVALID_DATA: "INVALID_DATA";
-    readonly MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
-    readonly UNAUTHORIZED: "UNAUTHORIZED";
-    readonly FORBIDDEN: "FORBIDDEN";
-    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
-    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
-    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+declare const collections: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedCollectionType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedCollectionType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedCollectionType;
+    }) => Promise<UnifiedCollectionType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedCollectionType>;
+    }) => Promise<UnifiedCollectionType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedCollectionType[];
+    }) => Promise<UnifiedCollectionType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedCollectionType>;
+        }>;
+    }) => Promise<UnifiedCollectionType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
 };
-/**
- * Handle errors from connector operations
- */
-declare function handleConnectorError(error: any, context: string): StallConnectorError;
-/**
- * Create a ConnectorResponse error format
- */
-declare function createErrorResponse(error: Error | StallConnectorError, operation: string, connectorId: string): {
-    success: boolean;
-    error: {
-        code: string;
-        message: string;
-        details: any;
-    };
-    metadata: {
-        connector_id: string;
-        operation: string;
-        timestamp: number;
-        request_id: string;
-    };
+
+declare const categories: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedCategoryType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedCategoryType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedCategoryType;
+    }) => Promise<UnifiedCategoryType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedCategoryType>;
+    }) => Promise<UnifiedCategoryType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedCategoryType[];
+    }) => Promise<UnifiedCategoryType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedCategoryType>;
+        }>;
+    }) => Promise<UnifiedCategoryType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
 };
-/**
- * Generate a unique request ID
- */
-declare function generateRequestId(): string;
 
-/**
- * Mock connector plugin for development and testing
- * This demonstrates the plugin interface and can be used as a template
- */
-declare class MockConnectorPlugin implements IConnectorPlugin {
-    metadata: PluginMetadata;
-    private config;
-    private initialized;
-    initialize(config: ConnectorPluginConfig): Promise<void>;
-    verify(): Promise<ConnectorResponse<boolean>>;
-    getSupportedModules(): string[];
-    orders: {
-        create: (order: UnifiedOrderType) => Promise<ConnectorResponse<any>>;
-        get: (orderId: string) => Promise<ConnectorResponse<any>>;
-        update: (orderId: string, order: Partial<UnifiedOrderType>) => Promise<ConnectorResponse<any>>;
-        delete: (orderId: string) => Promise<ConnectorResponse<any>>;
-        list: (options?: PaginationOptions & {
-            [key: string]: any;
-        }) => Promise<ConnectorResponse<any[]>>;
-    };
-    products: {
-        create: (product: UnifiedProductType) => Promise<ConnectorResponse<any>>;
-        get: (productId: string) => Promise<ConnectorResponse<any>>;
-        update: (productId: string, product: Partial<UnifiedProductType>) => Promise<ConnectorResponse<any>>;
-        delete: (productId: string) => Promise<ConnectorResponse<any>>;
-        list: (options?: PaginationOptions & {
-            [key: string]: any;
-        }) => Promise<ConnectorResponse<any[]>>;
-    };
-    customers: {
-        create: (customer: any) => Promise<ConnectorResponse<any>>;
-        get: (customerId: string) => Promise<ConnectorResponse<any>>;
-        update: (customerId: string, customer: any) => Promise<ConnectorResponse<any>>;
-        delete: (customerId: string) => Promise<ConnectorResponse<any>>;
-        list: (options?: PaginationOptions & {
-            [key: string]: any;
-        }) => Promise<ConnectorResponse<any[]>>;
-    };
-    inventory: {
-        get: (productId: string, variantId?: string) => Promise<ConnectorResponse<any>>;
-        update: (productId: string, inventory: any, variantId?: string) => Promise<ConnectorResponse<any>>;
-        list: (options?: PaginationOptions & {
-            [key: string]: any;
-        }) => Promise<ConnectorResponse<any[]>>;
-    };
-    refunds: {
-        create: (orderId: string, refund: UnifiedOrderRefundType) => Promise<ConnectorResponse<any>>;
-        get: (refundId: string) => Promise<ConnectorResponse<any>>;
-        list: (orderId: string, options?: PaginationOptions & {
-            [key: string]: any;
-        }) => Promise<ConnectorResponse<any[]>>;
-    };
-    payments: {
-        create: (payment: any) => Promise<ConnectorResponse<any>>;
-        get: (paymentId: string) => Promise<ConnectorResponse<any>>;
-        list: (options?: PaginationOptions & {
-            [key: string]: any;
-        }) => Promise<ConnectorResponse<any[]>>;
-    };
-}
+declare const variants: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedVariantsType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedVariantsType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedVariantsType;
+    }) => Promise<UnifiedVariantsType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedVariantsType>;
+    }) => Promise<UnifiedVariantsType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedVariantsType[];
+    }) => Promise<UnifiedVariantsType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedVariantsType>;
+        }>;
+    }) => Promise<UnifiedVariantsType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const inventory_levels: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedInventoryLevelType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedInventoryLevelType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedInventoryLevelType;
+    }) => Promise<UnifiedInventoryLevelType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedInventoryLevelType>;
+    }) => Promise<UnifiedInventoryLevelType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedInventoryLevelType[];
+    }) => Promise<UnifiedInventoryLevelType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedInventoryLevelType>;
+        }>;
+    }) => Promise<UnifiedInventoryLevelType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const promotions: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedPromotion[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedPromotion>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedPromotion;
+    }) => Promise<UnifiedPromotion>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedPromotion>;
+    }) => Promise<UnifiedPromotion>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedPromotion[];
+    }) => Promise<UnifiedPromotion[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedPromotion>;
+        }>;
+    }) => Promise<UnifiedPromotion[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const order_notes: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedOrderNote[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedOrderNote>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedOrderNote;
+    }) => Promise<UnifiedOrderNote>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedOrderNote>;
+    }) => Promise<UnifiedOrderNote>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedOrderNote[];
+    }) => Promise<UnifiedOrderNote[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedOrderNote>;
+        }>;
+    }) => Promise<UnifiedOrderNote[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const refunds: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedOrderRefundType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedOrderRefundType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedOrderRefundType;
+    }) => Promise<UnifiedOrderRefundType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedOrderRefundType>;
+    }) => Promise<UnifiedOrderRefundType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedOrderRefundType[];
+    }) => Promise<UnifiedOrderRefundType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedOrderRefundType>;
+        }>;
+    }) => Promise<UnifiedOrderRefundType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const payment_providers: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedPaymentProviderType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedPaymentProviderType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedPaymentProviderType;
+    }) => Promise<UnifiedPaymentProviderType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedPaymentProviderType>;
+    }) => Promise<UnifiedPaymentProviderType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedPaymentProviderType[];
+    }) => Promise<UnifiedPaymentProviderType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedPaymentProviderType>;
+        }>;
+    }) => Promise<UnifiedPaymentProviderType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const payments: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedPaymentCollectionType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedPaymentCollectionType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedPaymentCollectionType;
+    }) => Promise<UnifiedPaymentCollectionType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedPaymentCollectionType>;
+    }) => Promise<UnifiedPaymentCollectionType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedPaymentCollectionType[];
+    }) => Promise<UnifiedPaymentCollectionType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedPaymentCollectionType>;
+        }>;
+    }) => Promise<UnifiedPaymentCollectionType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const tax_regions: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedTaxRegionType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedTaxRegionType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedTaxRegionType;
+    }) => Promise<UnifiedTaxRegionType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedTaxRegionType>;
+    }) => Promise<UnifiedTaxRegionType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedTaxRegionType[];
+    }) => Promise<UnifiedTaxRegionType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedTaxRegionType>;
+        }>;
+    }) => Promise<UnifiedTaxRegionType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const tax_rates: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedTaxRateType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedTaxRateType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedTaxRateType;
+    }) => Promise<UnifiedTaxRateType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedTaxRateType>;
+    }) => Promise<UnifiedTaxRateType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedTaxRateType[];
+    }) => Promise<UnifiedTaxRateType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedTaxRateType>;
+        }>;
+    }) => Promise<UnifiedTaxRateType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const locations: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedLocationType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedLocationType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedLocationType;
+    }) => Promise<UnifiedLocationType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedLocationType>;
+    }) => Promise<UnifiedLocationType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedLocationType[];
+    }) => Promise<UnifiedLocationType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedLocationType>;
+        }>;
+    }) => Promise<UnifiedLocationType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
+
+declare const fulfillments: {
+    list: (props: {
+        sdk: CoreConfig;
+        query: string;
+    }) => Promise<UnifiedFulfillmentType[]>;
+    retrieve: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<UnifiedFulfillmentType>;
+    create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedFulfillmentType;
+    }) => Promise<UnifiedFulfillmentType>;
+    update: (props: {
+        sdk: CoreConfig;
+        id: string;
+        data: Partial<UnifiedFulfillmentType>;
+    }) => Promise<UnifiedFulfillmentType>;
+    delete: (props: {
+        sdk: CoreConfig;
+        id: string;
+    }) => Promise<void>;
+    bulk_create: (props: {
+        sdk: CoreConfig;
+        data: UnifiedFulfillmentType[];
+    }) => Promise<UnifiedFulfillmentType[]>;
+    bulk_update: (props: {
+        sdk: CoreConfig;
+        data: Array<{
+            id: string;
+            data: Partial<UnifiedFulfillmentType>;
+        }>;
+    }) => Promise<UnifiedFulfillmentType[]>;
+    bulk_delete: (props: {
+        sdk: CoreConfig;
+        ids: string[];
+    }) => Promise<void>;
+};
 
-export { BaseService, type BatchOperationOptions, type ConnectorError, ConnectorLoader, type ConnectorLoaderOptions, type ConnectorPluginConfig, type ConnectorResponse, ErrorCodes, type IConnectorPlugin, Logger, MockConnectorPlugin, type ModuleCapability, type OperationMetadata, OrdersService, type PaginationOptions, type PluginConstructor, PluginManager, type PluginMetadata, type PluginModule, ProductsService, StallConnectorError, StallCore, type StallSDKOptions, createErrorResponse, createLogger, generateRequestId, handleConnectorError };
+export { categories, collections, customers, fulfillments, initializeStallCore, inventory_levels, locations, order_notes, orders, payment_providers, payments, products, promotions, refunds, tax_rates, tax_regions, variants };