@datlv-trustshop/shopify-inapp-components 0.2.8 → 0.2.10

package/dist/core/SDKManager.d.ts

@@ -0,0 +1,262 @@
+/**
+ * SDK Manager - Internal singleton for managing global state
+ * Components automatically connect to this without manual provider setup
+ */
+import { type SupportedLocale, type SDKTranslations } from "../translations/translation-manager";
+import { type ShopInfo, type SDKInternalConfig } from "../config/internal-config";
+import { DashboardEngine } from "./engine";
+import { DashboardData } from "../types";
+interface SDKState {
+    initialized: boolean;
+    shopInfo?: ShopInfo;
+    locale: SupportedLocale;
+    translations: SDKTranslations;
+    config: SDKInternalConfig;
+    loading: boolean;
+    error?: Error;
+    dashboardData?: DashboardData | null;
+    dashboardLoading?: boolean;
+    dashboardError?: Error | null;
+    campaignsData?: any[] | null;
+    campaignsLoading?: boolean;
+    campaignsError?: Error | null;
+}
+interface SDKOptions {
+    shopInfo?: ShopInfo;
+    locale?: SupportedLocale;
+    translations?: Partial<SDKTranslations>;
+    config?: Partial<SDKInternalConfig>;
+}
+declare class SDKManagerClass {
+    private state;
+    private listeners;
+    private initPromise?;
+    private localeObserver?;
+    private currentDetectedLocale?;
+    private dashboardEngine?;
+    constructor();
+    /**
+     * Auto-detect current locale from browser/Shopify context
+     */
+    private autoDetectLocale;
+    /**
+     * Get locale from Shopify Admin context
+     */
+    private getShopifyAdminLocale;
+    /**
+     * Setup watcher for locale changes in the DOM
+     */
+    private setupLocaleWatcher;
+    /**
+     * Handle custom locale change events
+     */
+    private handleCustomLocaleChange;
+    /**
+     * Handle locale changes (re-fetch data and translations)
+     */
+    private handleLocaleChange;
+    /**
+     * Refresh dashboard data with new locale
+     */
+    private refreshDashboardData;
+    /**
+     * Refresh campaigns data with new locale
+     */
+    private refreshCampaignsData;
+    /**
+     * Normalize locale string to supported format
+     */
+    private normalizeLocale;
+    /**
+     * Manually update locale (for programmatic changes)
+     */
+    updateLocale(newLocale: string | SupportedLocale): Promise<void>;
+    /**
+     * Auto-detect shop info from Shopify App Bridge or URL
+     */
+    private autoDetectShopInfo;
+    /**
+     * Initialize SDK with options (called automatically by components)
+     */
+    initialize(options?: SDKOptions): Promise<void>;
+    private performInitialization;
+    /**
+     * Update SDK state and notify listeners
+     */
+    private updateState;
+    /**
+     * Update configuration (called when components pass new props)
+     */
+    updateConfig(options: SDKOptions): Promise<void>;
+    /**
+     * Get current state
+     */
+    getState(): SDKState;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener: () => void): () => void;
+    private notifyListeners;
+    /**
+     * Get component defaults
+     */
+    getDefaults(): {
+        readonly topBanner: {
+            readonly open: true;
+            readonly closable: true;
+            readonly sticky: false;
+        };
+        readonly whatsNew: {
+            readonly maxUpdates: 5;
+            readonly maxArticles: 10;
+            readonly showNavigation: true;
+            readonly showViewAllButton: true;
+            readonly enableSwipe: true;
+        };
+        readonly growApps: {
+            readonly maxItems: 6;
+            readonly showDismiss: true;
+            readonly showNavigation: true;
+            readonly dismissKey: "ts-dashboard-growapps-dismissed";
+            readonly dismissDuration: number;
+        };
+        readonly popupBanner: {
+            readonly autoShow: true;
+            readonly showDelay: 0;
+            readonly persistClose: true;
+            readonly storageKey: "ts-dashboard-popup-closed";
+        };
+        readonly partnerIntegration: {
+            readonly showEmptyState: true;
+            readonly maxItems: 12;
+        };
+        readonly ui: {
+            readonly animationDuration: 300;
+            readonly debounceDelay: 100;
+            readonly skeletonCount: 3;
+            readonly enableHapticFeedback: false;
+        };
+        readonly cls: {
+            readonly reserveSpace: true;
+            readonly useSkeletons: true;
+            readonly lazyLoadImages: true;
+            readonly preventLayoutShift: true;
+        };
+        readonly loading: {
+            readonly retryAttempts: 3;
+            readonly retryDelay: 1000;
+            readonly loadingDelay: 200;
+            readonly showSpinner: false;
+        };
+        readonly storage: {
+            readonly keyPrefix: "ts-sdk-";
+            readonly persistenceEnabled: true;
+            readonly encryptStorage: false;
+        };
+    };
+    /**
+     * Get dashboard engine instance
+     */
+    getDashboardEngine(): DashboardEngine | undefined;
+    /**
+     * Get dashboard data
+     */
+    getDashboardData(): DashboardData | null | undefined;
+    /**
+     * Get campaigns data
+     */
+    getCampaignsData(): any[] | null | undefined;
+    /**
+     * Check if SDK is ready for use
+     */
+    isReady(): boolean;
+    /**
+     * Cleanup observers and listeners
+     */
+    destroy(): void;
+}
+export declare const SDKManager: SDKManagerClass;
+export interface UseSDKOptions {
+    shopInfo?: ShopInfo;
+    locale?: SupportedLocale;
+    translations?: Partial<SDKTranslations>;
+    config?: Partial<SDKInternalConfig>;
+}
+/**
+ * Hook for components to connect to SDK Manager
+ * Automatically initializes SDK on first use
+ */
+export declare function useSDK(options?: UseSDKOptions): {
+    isInitializing: boolean;
+    defaults: {
+        readonly topBanner: {
+            readonly open: true;
+            readonly closable: true;
+            readonly sticky: false;
+        };
+        readonly whatsNew: {
+            readonly maxUpdates: 5;
+            readonly maxArticles: 10;
+            readonly showNavigation: true;
+            readonly showViewAllButton: true;
+            readonly enableSwipe: true;
+        };
+        readonly growApps: {
+            readonly maxItems: 6;
+            readonly showDismiss: true;
+            readonly showNavigation: true;
+            readonly dismissKey: "ts-dashboard-growapps-dismissed";
+            readonly dismissDuration: number;
+        };
+        readonly popupBanner: {
+            readonly autoShow: true;
+            readonly showDelay: 0;
+            readonly persistClose: true;
+            readonly storageKey: "ts-dashboard-popup-closed";
+        };
+        readonly partnerIntegration: {
+            readonly showEmptyState: true;
+            readonly maxItems: 12;
+        };
+        readonly ui: {
+            readonly animationDuration: 300;
+            readonly debounceDelay: 100;
+            readonly skeletonCount: 3;
+            readonly enableHapticFeedback: false;
+        };
+        readonly cls: {
+            readonly reserveSpace: true;
+            readonly useSkeletons: true;
+            readonly lazyLoadImages: true;
+            readonly preventLayoutShift: true;
+        };
+        readonly loading: {
+            readonly retryAttempts: 3;
+            readonly retryDelay: 1000;
+            readonly loadingDelay: 200;
+            readonly showSpinner: false;
+        };
+        readonly storage: {
+            readonly keyPrefix: "ts-sdk-";
+            readonly persistenceEnabled: true;
+            readonly encryptStorage: false;
+        };
+    };
+    isReady: boolean;
+    dashboardEngine: DashboardEngine | undefined;
+    initialized: boolean;
+    shopInfo?: ShopInfo;
+    locale: SupportedLocale;
+    translations: SDKTranslations;
+    config: SDKInternalConfig;
+    loading: boolean;
+    error?: Error;
+    dashboardData?: DashboardData | null;
+    dashboardLoading?: boolean;
+    dashboardError?: Error | null;
+    campaignsData?: any[] | null;
+    campaignsLoading?: boolean;
+    campaignsError?: Error | null;
+};
+export default SDKManager;
+//# sourceMappingURL=SDKManager.d.ts.map

package/dist/core/SDKManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDKManager.d.ts","sourceRoot":"","sources":["../../src/core/SDKManager.ts"],"names":[],"mappings":"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"}