@cshah18/sdk 1.0.0

package/dist/types/ui/widget/widget-root.d.ts

@@ -0,0 +1,79 @@
+import { InternalConfig, RenderWidgetOptions } from "../../core/types";
+import { ApiClient } from "../../core/api-client";
+import { AnalyticsClient } from "../../core/analytics";
+/**
+ * WidgetRoot handles rendering of the CoBuy widget into a DOM container
+ */
+export declare class WidgetRoot {
+    private logger;
+    private apiClient;
+    private analyticsClient;
+    private config;
+    private events?;
+    private state;
+    private retryCount;
+    private readonly MAX_RETRIES;
+    private currentProductId;
+    private currentContainer;
+    private debouncedCTAClick;
+    constructor(config: InternalConfig, apiClient: ApiClient | null, analyticsClient?: AnalyticsClient | null);
+    /**
+     * Render the widget into the specified container
+     */
+    render(options: RenderWidgetOptions): Promise<void>;
+    /**
+     * Fetch reward data with automatic retry on failure
+     */
+    private fetchRewardWithRetry;
+    /**
+     * Fetch reward data for a product
+     */
+    private fetchReward;
+    /**
+     * Fetch widget configuration from API
+     *
+     * NOTE: This endpoint is currently NOT USED in the SDK implementation.
+     * It is reserved for future enhancements such as:
+     * - Server-side control of widget display settings (show/hide elements)
+     * - Per-merchant feature flags (enable/disable social sharing, group creation)
+     * - Group size requirements and timeout configurations
+     * - Modal layout and behavior customization
+     * - A/B testing and dynamic theming
+     *
+     * For now, widget behavior is controlled by:
+     * 1. Merchant's init() options (theme, debug)
+     * 2. Reward data from /v1/sdk/products/:productId/reward
+     *
+     * This method is kept for future integration when modal group lobby,
+     * social sharing, and advanced customization features are implemented.
+     *
+     * @future Will be activated in modal implementation (post-SCRUM-248)
+     */
+    private fetchWidgetConfig;
+    /**
+     * Resolve container from string selector or HTMLElement
+     */
+    private resolveContainer;
+    /**
+     * Render skeleton loading state with animated shimmer effect
+     */
+    private renderSkeleton;
+    /**
+     * Render error state with retry button
+     */
+    private renderError;
+    /**
+     * Handle retry button click - reset retry count and re-fetch
+     */
+    private handleRetry;
+    private createWidget;
+    /**
+     * Inject base layout styles for responsive widget rendering
+     */
+    private injectBaseStyles;
+    /**
+     * Handle CTA button click with analytics and modal opening
+     */
+    private handleCTAClick;
+    private formatRewardText;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cshah18/sdk",
+  "version": "1.0.0",
+  "description": "CoBuy Embedded SDK for browser JavaScript integration",
+  "type": "module",
+  "main": "dist/cobuy-sdk.umd.js",
+  "module": "dist/cobuy-sdk.esm.js",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "build:watch": "rollup -c -w",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix",
+    "check": "npm run lint && tsc --noEmit"
+  },
+  "keywords": [
+    "cobuy",
+    "sdk",
+    "browser",
+    "embedded"
+  ],
+  "author": "CoBuy",
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "eslint-plugin-import": "^2.32.0",
+    "prettier": "^3.7.4",
+    "rollup": "^4.9.4",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  }
+}