@embeddable/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Embeddable Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,230 @@
+# @embeddable/sdk
+
+A TypeScript/JavaScript SDK with React utilities and hooks for embeddable applications. Built with tree shaking support and modern development practices.
+
+[![npm version](https://badge.fury.io/js/%40embeddable%2Fsdk.svg)](https://badge.fury.io/js/%40embeddable%2Fsdk)
+[![CI/CD](https://github.com/CommonNinja/embeddable-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/CommonNinja/embeddable-sdk/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/CommonNinja/embeddable-sdk/branch/main/graph/badge.svg)](https://codecov.io/gh/CommonNinja/embeddable-sdk)
+
+## Features
+
+- 🌳 **Tree Shaking**: Import only what you need
+- 📦 **TypeScript**: Full TypeScript support with type definitions
+- ⚛️ **React Hooks**: Custom hooks for common patterns
+- 🛠️ **Utilities**: Useful utility functions
+- 🎨 **Theme Support**: Built-in theme management
+- 📱 **Storage**: Enhanced localStorage utilities
+- 🌐 **API Client**: Type-safe API client with error handling
+- 🧪 **Well Tested**: Comprehensive test coverage
+
+## Installation
+
+```bash
+npm install @embeddable/sdk
+# or
+yarn add @embeddable/sdk
+# or
+pnpm add @embeddable/sdk
+```
+
+## Usage
+
+### Import Everything
+
+```typescript
+import { useLocalStorage, debounce } from '@embeddable/sdk';
+```
+
+### Import Specific Modules (Tree Shaking)
+
+```typescript
+// Import only hooks
+import { useLocalStorage } from '@embeddable/sdk/hooks';
+
+// Import only utilities
+import { debounce } from '@embeddable/sdk/utils';
+```
+
+## API Reference
+
+### Hooks
+
+#### `useLocalStorage<T>(key: string, initialValue: T, options?: LocalStorageOptions)`
+
+A React hook for localStorage with state synchronization across tabs.
+
+```typescript
+import { useLocalStorage } from '@embeddable/sdk/hooks'
+
+function MyComponent() {
+  const [user, setUser, removeUser] = useLocalStorage('user', { name: '', email: '' })
+
+  return (
+    <div>
+      <input
+        value={user.name}
+        onChange={(e) => setUser(prev => ({ ...prev, name: e.target.value }))}
+      />
+      <button onClick={removeUser}>Clear</button>
+    </div>
+  )
+}
+```
+
+#### `useDebounce<T>(value: T, delay: number)`
+
+A React hook that debounces a value.
+
+```typescript
+import { useDebounce } from '@embeddable/sdk/hooks'
+
+function SearchInput() {
+  const [searchTerm, setSearchTerm] = useState('')
+  const debouncedSearchTerm = useDebounce(searchTerm, 300)
+
+  useEffect(() => {
+    if (debouncedSearchTerm) {
+      // Perform search
+    }
+  }, [debouncedSearchTerm])
+
+  return <input onChange={(e) => setSearchTerm(e.target.value)} />
+}
+```
+
+#### `useApi(config: EmbeddableApiConfig)`
+
+A React hook for API calls with loading and error states.
+
+```typescript
+import { useApi } from '@embeddable/sdk/hooks'
+
+function DataComponent() {
+  const api = useApi({ apiKey: 'your-api-key', baseUrl: 'https://api.example.com' })
+
+  const fetchData = async () => {
+    const response = await api.get('/users')
+    if (response.success) {
+      console.log(response.data)
+    }
+  }
+
+  return (
+    <div>
+      {api.loading && <div>Loading...</div>}
+      {api.error && <div>Error: {api.error}</div>}
+      <button onClick={fetchData}>Fetch Data</button>
+    </div>
+  )
+}
+```
+
+### Utilities
+
+#### `debounce<T>(func: T, wait: number)`
+
+Creates a debounced function.
+
+```typescript
+import { debounce } from '@embeddable/sdk/utils';
+
+const debouncedSave = debounce(data => {
+  // Save data
+}, 500);
+```
+
+#### `createApiClient(config: EmbeddableApiConfig)`
+
+Creates a type-safe API client.
+
+```typescript
+import { createApiClient } from '@embeddable/sdk/utils';
+
+const api = createApiClient({
+  apiKey: 'your-api-key',
+  baseUrl: 'https://api.example.com',
+  debug: true,
+});
+
+const response = await api.get('/users');
+```
+
+#### `storage`
+
+Enhanced localStorage utility with serialization support.
+
+```typescript
+import { storage } from '@embeddable/sdk/utils';
+
+// Basic usage
+storage.set('user', { name: 'John', age: 30 });
+const user = storage.get('user');
+
+// With options
+storage.set('data', complexObject, {
+  prefix: 'myapp_',
+  serialize: JSON.stringify,
+  deserialize: JSON.parse,
+});
+```
+
+## Types
+
+The SDK exports TypeScript types for better development experience:
+
+```typescript
+import type {
+  EmbeddableApiConfig,
+  ApiResponse,
+  Theme,
+  ThemeConfig,
+  LocalStorageOptions,
+} from '@embeddable/sdk';
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Build the package
+npm run build
+
+# Run linter
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+
+# Format code with Prettier
+npm run format
+
+# Check code formatting
+npm run format:check
+
+# Type check
+npm run type-check
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes using conventional commits (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+MIT © [Embeddable Team](https://github.com/CommonNinja/embeddable-sdk)
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for a list of changes.

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useApi } from './useApi';
+export { useDebounce } from './useDebounce';
+export { useLocalStorage } from './useLocalStorage';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/hooks/useApi.d.ts

@@ -0,0 +1,18 @@
+import { ApiResponse, EmbeddableApiConfig } from '../types';
+
+/**
+ * React hook for API calls with loading and error states
+ * @param config - API configuration
+ * @returns API client with state management
+ */
+export declare function useApi(config: EmbeddableApiConfig): {
+    get: <T = any>(endpoint: string) => Promise<ApiResponse<T>>;
+    post: <T = any>(endpoint: string, body?: any) => Promise<ApiResponse<T>>;
+    put: <T = any>(endpoint: string, body?: any) => Promise<ApiResponse<T>>;
+    delete: <T = any>(endpoint: string) => Promise<ApiResponse<T>>;
+    reset: () => void;
+    data: any;
+    loading: boolean;
+    error: string | null;
+};
+//# sourceMappingURL=useApi.d.ts.map

package/dist/hooks/useApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApi.d.ts","sourceRoot":"","sources":["../../src/hooks/useApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AASjE;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,mBAAmB;UA8DvB,CAAC,kBAAkB,MAAM;WAG/C,CAAC,kBAAkB,MAAM,SAAS,GAAG;UAKrC,CAAC,kBAAkB,MAAM,SAAS,GAAG;aAIf,CAAC,kBAAkB,MAAM;;;aAnFzC,OAAO;WACT,MAAM,GAAG,IAAI;EAoGrB"}

package/dist/hooks/useDebounce.d.ts

@@ -0,0 +1,8 @@
+/**
+ * React hook that debounces a value
+ * @param value - The value to debounce
+ * @param delay - The delay in milliseconds
+ * @returns The debounced value
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/hooks/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAczD"}

package/dist/hooks/useLocalStorage.d.ts

@@ -0,0 +1,11 @@
+import { LocalStorageOptions } from '../types';
+
+/**
+ * React hook for localStorage with state synchronization
+ * @param key - The localStorage key
+ * @param initialValue - The initial value if key doesn't exist
+ * @param options - Storage options
+ * @returns [value, setValue, removeValue]
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T, options?: LocalStorageOptions): [T, (value: T | ((prev: T) => T)) => void, () => void];
+//# sourceMappingURL=useLocalStorage.d.ts.map

package/dist/hooks/useLocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,mBAAwB,GAChC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAsDxD"}

package/dist/hooks.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./useLocalStorage-C4q-PhVk.cjs");exports.useApi=e.useApi,exports.useDebounce=e.useDebounce,exports.useLocalStorage=e.useLocalStorage;

package/dist/hooks.d.ts

@@ -0,0 +1 @@
+export * from './hooks/index'

package/dist/hooks.js

@@ -0,0 +1,6 @@
+import { u, a, b } from "./useLocalStorage-BYg8a4Ry.js";
+export {
+  u as useApi,
+  a as useDebounce,
+  b as useLocalStorage
+};

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./useLocalStorage-C4q-PhVk.cjs"),o=require("./storage-3dk6ww91.cjs"),r=require("./utils.cjs");exports.useApi=e.useApi,exports.useDebounce=e.useDebounce,exports.useLocalStorage=e.useLocalStorage,exports.createApiClient=o.createApiClient,exports.storage=o.storage,exports.debounce=r.debounce;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './hooks';
+export * from './utils';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,mBAAmB,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { u, a, b } from "./useLocalStorage-BYg8a4Ry.js";
+import { c, s } from "./storage-CRPDfSRn.js";
+import { debounce } from "./utils.js";
+export {
+  c as createApiClient,
+  debounce,
+  s as storage,
+  u as useApi,
+  a as useDebounce,
+  b as useLocalStorage
+};

package/dist/storage-3dk6ww91.cjs

@@ -0,0 +1 @@
+"use strict";const e={get(e,t={}){try{const{prefix:r="",deserialize:o=JSON.parse}=t,a=r+e,s=localStorage.getItem(a);return null===s?null:o(s)}catch(r){return null}},set(e,t,r={}){try{const{prefix:o="",serialize:a=JSON.stringify}=r,s=o+e,c=a(t);localStorage.setItem(s,c)}catch(o){}},remove(e,t={}){try{const{prefix:r=""}=t,o=r+e;localStorage.removeItem(o)}catch(r){}},clear(e={}){try{const{prefix:t=""}=e;if(!t)return void localStorage.clear();const r=[];for(let e=0;e<localStorage.length;e++){const o=localStorage.key(e);o&&o.startsWith(t)&&r.push(o)}r.forEach((e=>localStorage.removeItem(e)))}catch(t){}},isAvailable(){try{const e="__storage_test__";return localStorage.setItem(e,"test"),localStorage.removeItem(e),!0}catch{return!1}}};exports.createApiClient=function(e){const t=e.baseUrl||"https://api.embeddable.com",r={"Content-Type":"application/json"};e.apiKey&&(r.Authorization=`Bearer ${e.apiKey}`);const o=async(o,a={})=>{try{const e=`${t}${o}`,s=await fetch(e,{...a,headers:{...r,...a.headers}}),c=await s.json();return s.ok?{data:c,success:!0}:{data:null,success:!1,error:c.message||`HTTP ${s.status}`}}catch(s){return e.debug,{data:null,success:!1,error:s instanceof Error?s.message:"Unknown error"}}};return{get:e=>o(e,{method:"GET"}),post:(e,t)=>o(e,{method:"POST",body:t?JSON.stringify(t):void 0}),put:(e,t)=>o(e,{method:"PUT",body:t?JSON.stringify(t):void 0}),delete:e=>o(e,{method:"DELETE"})}},exports.storage=e;

package/dist/storage-CRPDfSRn.js

@@ -0,0 +1,147 @@
+function createApiClient(config) {
+  const baseUrl = config.baseUrl || "https://api.embeddable.com";
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (config.apiKey) {
+    headers["Authorization"] = `Bearer ${config.apiKey}`;
+  }
+  const request = async (endpoint, options = {}) => {
+    try {
+      const url = `${baseUrl}${endpoint}`;
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          ...headers,
+          ...options.headers
+        }
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        return {
+          data: null,
+          success: false,
+          error: data.message || `HTTP ${response.status}`
+        };
+      }
+      return {
+        data,
+        success: true
+      };
+    } catch (error) {
+      if (config.debug) {
+        console.error("API Request failed:", error);
+      }
+      return {
+        data: null,
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  };
+  return {
+    get: (endpoint) => request(endpoint, { method: "GET" }),
+    post: (endpoint, body) => request(endpoint, {
+      method: "POST",
+      body: body ? JSON.stringify(body) : void 0
+    }),
+    put: (endpoint, body) => request(endpoint, {
+      method: "PUT",
+      body: body ? JSON.stringify(body) : void 0
+    }),
+    delete: (endpoint) => request(endpoint, { method: "DELETE" })
+  };
+}
+const storage = {
+  /**
+   * Get an item from localStorage
+   * @param key - The key to retrieve
+   * @param options - Storage options
+   * @returns The parsed value or null if not found
+   */
+  get(key, options = {}) {
+    try {
+      const { prefix = "", deserialize = JSON.parse } = options;
+      const fullKey = prefix + key;
+      const item = localStorage.getItem(fullKey);
+      if (item === null) {
+        return null;
+      }
+      return deserialize(item);
+    } catch (error) {
+      console.warn(`Failed to get item from localStorage: ${key}`, error);
+      return null;
+    }
+  },
+  /**
+   * Set an item in localStorage
+   * @param key - The key to set
+   * @param value - The value to store
+   * @param options - Storage options
+   */
+  set(key, value, options = {}) {
+    try {
+      const { prefix = "", serialize = JSON.stringify } = options;
+      const fullKey = prefix + key;
+      const serializedValue = serialize(value);
+      localStorage.setItem(fullKey, serializedValue);
+    } catch (error) {
+      console.warn(`Failed to set item in localStorage: ${key}`, error);
+    }
+  },
+  /**
+   * Remove an item from localStorage
+   * @param key - The key to remove
+   * @param options - Storage options
+   */
+  remove(key, options = {}) {
+    try {
+      const { prefix = "" } = options;
+      const fullKey = prefix + key;
+      localStorage.removeItem(fullKey);
+    } catch (error) {
+      console.warn(`Failed to remove item from localStorage: ${key}`, error);
+    }
+  },
+  /**
+   * Clear all items with the given prefix
+   * @param options - Storage options
+   */
+  clear(options = {}) {
+    try {
+      const { prefix = "" } = options;
+      if (!prefix) {
+        localStorage.clear();
+        return;
+      }
+      const keysToRemove = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key && key.startsWith(prefix)) {
+          keysToRemove.push(key);
+        }
+      }
+      keysToRemove.forEach((key) => localStorage.removeItem(key));
+    } catch (error) {
+      console.warn("Failed to clear localStorage", error);
+    }
+  },
+  /**
+   * Check if localStorage is available
+   * @returns True if localStorage is available
+   */
+  isAvailable() {
+    try {
+      const testKey = "__storage_test__";
+      localStorage.setItem(testKey, "test");
+      localStorage.removeItem(testKey);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+export {
+  createApiClient as c,
+  storage as s
+};

package/dist/types/index.d.ts

@@ -0,0 +1,27 @@
+export interface EmbeddableApiConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    debug?: boolean;
+}
+export interface ApiResponse<T = any> {
+    data: T;
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export interface LocalStorageOptions {
+    prefix?: string;
+    serialize?: (value: any) => string;
+    deserialize?: (value: string) => any;
+}
+export type Theme = 'light' | 'dark' | 'auto';
+export interface ThemeConfig {
+    theme: Theme;
+    colors?: {
+        primary?: string;
+        secondary?: string;
+        background?: string;
+        text?: string;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;CACtC;AAED,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/useLocalStorage-BYg8a4Ry.js

@@ -0,0 +1,139 @@
+import { useState, useCallback, useEffect } from "react";
+import { c as createApiClient, s as storage } from "./storage-CRPDfSRn.js";
+function useApi(config) {
+  const [state, setState] = useState({
+    data: null,
+    loading: false,
+    error: null
+  });
+  const apiClient = createApiClient(config);
+  const request = useCallback(
+    async (method, endpoint, body) => {
+      setState((prev) => ({ ...prev, loading: true, error: null }));
+      try {
+        let response;
+        switch (method) {
+          case "get":
+            response = await apiClient.get(endpoint);
+            break;
+          case "post":
+            response = await apiClient.post(endpoint, body);
+            break;
+          case "put":
+            response = await apiClient.put(endpoint, body);
+            break;
+          case "delete":
+            response = await apiClient.delete(endpoint);
+            break;
+          default:
+            throw new Error(`Unsupported method: ${method}`);
+        }
+        setState({
+          data: response.data,
+          loading: false,
+          error: response.success ? null : response.error || "Unknown error"
+        });
+        return response;
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        setState({
+          data: null,
+          loading: false,
+          error: errorMessage
+        });
+        return {
+          data: null,
+          success: false,
+          error: errorMessage
+        };
+      }
+    },
+    [apiClient]
+  );
+  const get = useCallback((endpoint) => request("get", endpoint), [request]);
+  const post = useCallback(
+    (endpoint, body) => request("post", endpoint, body),
+    [request]
+  );
+  const put = useCallback(
+    (endpoint, body) => request("put", endpoint, body),
+    [request]
+  );
+  const del = useCallback((endpoint) => request("delete", endpoint), [request]);
+  const reset = useCallback(() => {
+    setState({
+      data: null,
+      loading: false,
+      error: null
+    });
+  }, []);
+  return {
+    ...state,
+    get,
+    post,
+    put,
+    delete: del,
+    reset
+  };
+}
+function useDebounce(value, delay) {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+  useEffect(() => {
+    const handler = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(handler);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+}
+function useLocalStorage(key, initialValue, options = {}) {
+  const [storedValue, setStoredValue] = useState(() => {
+    const item = storage.get(key, options);
+    return item !== null ? item : initialValue;
+  });
+  const setValue = useCallback(
+    (value) => {
+      try {
+        const valueToStore = value instanceof Function ? value(storedValue) : value;
+        setStoredValue(valueToStore);
+        storage.set(key, valueToStore, options);
+      } catch (error) {
+        console.warn(`Error setting localStorage key "${key}":`, error);
+      }
+    },
+    [key, storedValue, options]
+  );
+  const removeValue = useCallback(() => {
+    try {
+      setStoredValue(initialValue);
+      storage.remove(key, options);
+    } catch (error) {
+      console.warn(`Error removing localStorage key "${key}":`, error);
+    }
+  }, [key, initialValue, options]);
+  useEffect(() => {
+    const handleStorageChange = (e) => {
+      const { prefix = "" } = options;
+      const fullKey = prefix + key;
+      if (e.key === fullKey && e.newValue !== null) {
+        try {
+          const { deserialize = JSON.parse } = options;
+          const newValue = deserialize(e.newValue);
+          setStoredValue(newValue);
+        } catch (error) {
+          console.warn(`Error parsing localStorage value for key "${key}":`, error);
+        }
+      }
+    };
+    window.addEventListener("storage", handleStorageChange);
+    return () => window.removeEventListener("storage", handleStorageChange);
+  }, [key, options]);
+  return [storedValue, setValue, removeValue];
+}
+export {
+  useDebounce as a,
+  useLocalStorage as b,
+  useApi as u
+};

package/dist/useLocalStorage-C4q-PhVk.cjs

@@ -0,0 +1 @@
+"use strict";const e=require("react"),t=require("./storage-3dk6ww91.cjs");exports.useApi=function(r){const[a,s]=e.useState({data:null,loading:!1,error:null}),n=t.createApiClient(r),o=e.useCallback((async(e,t,r)=>{s((e=>({...e,loading:!0,error:null})));try{let a;switch(e){case"get":a=await n.get(t);break;case"post":a=await n.post(t,r);break;case"put":a=await n.put(t,r);break;case"delete":a=await n.delete(t);break;default:throw new Error(`Unsupported method: ${e}`)}return s({data:a.data,loading:!1,error:a.success?null:a.error||"Unknown error"}),a}catch(a){const e=a instanceof Error?a.message:"Unknown error";return s({data:null,loading:!1,error:e}),{data:null,success:!1,error:e}}}),[n]);return{...a,get:e.useCallback((e=>o("get",e)),[o]),post:e.useCallback(((e,t)=>o("post",e,t)),[o]),put:e.useCallback(((e,t)=>o("put",e,t)),[o]),delete:e.useCallback((e=>o("delete",e)),[o]),reset:e.useCallback((()=>{s({data:null,loading:!1,error:null})}),[])}},exports.useDebounce=function(t,r){const[a,s]=e.useState(t);return e.useEffect((()=>{const e=setTimeout((()=>{s(t)}),r);return()=>{clearTimeout(e)}}),[t,r]),a},exports.useLocalStorage=function(r,a,s={}){const[n,o]=e.useState((()=>{const e=t.storage.get(r,s);return null!==e?e:a})),u=e.useCallback((e=>{try{const a=e instanceof Function?e(n):e;o(a),t.storage.set(r,a,s)}catch(a){}}),[r,n,s]),l=e.useCallback((()=>{try{o(a),t.storage.remove(r,s)}catch(e){}}),[r,a,s]);return e.useEffect((()=>{const e=e=>{const{prefix:t=""}=s,a=t+r;if(e.key===a&&null!==e.newValue)try{const{deserialize:t=JSON.parse}=s,r=t(e.newValue);o(r)}catch(n){}};return window.addEventListener("storage",e),()=>window.removeEventListener("storage",e)}),[r,s]),[n,u,l]};

package/dist/utils/apiClient.d.ts

@@ -0,0 +1,14 @@
+import { ApiResponse, EmbeddableApiConfig } from '../types';
+
+/**
+ * Creates an API client with the given configuration
+ * @param config - The configuration for the API client
+ * @returns API client with common methods
+ */
+export declare function createApiClient(config: EmbeddableApiConfig): {
+    get: <T = any>(endpoint: string) => Promise<ApiResponse<T>>;
+    post: <T = any>(endpoint: string, body?: any) => Promise<ApiResponse<T>>;
+    put: <T = any>(endpoint: string, body?: any) => Promise<ApiResponse<T>>;
+    delete: <T = any>(endpoint: string) => Promise<ApiResponse<T>>;
+};
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/utils/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/utils/apiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB;UAoDjD,CAAC,kBAAkB,MAAM;WACxB,CAAC,kBAAkB,MAAM,SAAS,GAAG;UAKtC,CAAC,kBAAkB,MAAM,SAAS,GAAG;aAKlC,CAAC,kBAAkB,MAAM;EAErC"}

package/dist/utils/debounce.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Creates a debounced function that delays invoking func until after wait milliseconds
+ * have elapsed since the last time the debounced function was invoked.
+ * @param func - The function to debounce
+ * @param wait - The number of milliseconds to delay
+ * @returns The debounced function
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/utils/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAclC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { createApiClient } from './apiClient';
+export { debounce } from './debounce';
+export { storage } from './storage';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/storage.d.ts

@@ -0,0 +1,38 @@
+import { LocalStorageOptions } from '../types';
+
+/**
+ * Enhanced localStorage utility with serialization and error handling
+ */
+export declare const storage: {
+    /**
+     * Get an item from localStorage
+     * @param key - The key to retrieve
+     * @param options - Storage options
+     * @returns The parsed value or null if not found
+     */
+    get<T = any>(key: string, options?: LocalStorageOptions): T | null;
+    /**
+     * Set an item in localStorage
+     * @param key - The key to set
+     * @param value - The value to store
+     * @param options - Storage options
+     */
+    set<T = any>(key: string, value: T, options?: LocalStorageOptions): void;
+    /**
+     * Remove an item from localStorage
+     * @param key - The key to remove
+     * @param options - Storage options
+     */
+    remove(key: string, options?: LocalStorageOptions): void;
+    /**
+     * Clear all items with the given prefix
+     * @param options - Storage options
+     */
+    clear(options?: LocalStorageOptions): void;
+    /**
+     * Check if localStorage is available
+     * @returns True if localStorage is available
+     */
+    isAvailable(): boolean;
+};
+//# sourceMappingURL=storage.d.ts.map

package/dist/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;;;;OAKG;QACC,CAAC,aAAa,MAAM,YAAW,mBAAmB,GAAQ,CAAC,GAAG,IAAI;IAiBtE;;;;;OAKG;QACC,CAAC,aAAa,MAAM,SAAS,CAAC,YAAW,mBAAmB,GAAQ,IAAI;IAW5E;;;;OAIG;gBACS,MAAM,YAAW,mBAAmB,GAAQ,IAAI;IAU5D;;;OAGG;oBACY,mBAAmB,GAAQ,IAAI;IAuB9C;;;OAGG;mBACY,OAAO;CAUvB,CAAC"}

package/dist/utils.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./storage-3dk6ww91.cjs");exports.createApiClient=e.createApiClient,exports.storage=e.storage,exports.debounce=function(e,t){let o;return function(...r){void 0!==o&&clearTimeout(o),o=setTimeout((()=>{o=void 0,e(...r)}),t)}};

package/dist/utils.d.ts

@@ -0,0 +1 @@
+export * from './utils/index'

package/dist/utils.js

@@ -0,0 +1,19 @@
+import { c, s } from "./storage-CRPDfSRn.js";
+function debounce(func, wait) {
+  let timeoutId;
+  return function debounced(...args) {
+    const later = () => {
+      timeoutId = void 0;
+      func(...args);
+    };
+    if (timeoutId !== void 0) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(later, wait);
+  };
+}
+export {
+  c as createApiClient,
+  debounce,
+  s as storage
+};

package/package.json

@@ -0,0 +1,116 @@
+{
+  "name": "@embeddable/sdk",
+  "version": "1.0.0",
+  "description": "A TypeScript/JavaScript SDK with React utilities and hooks for embeddable applications",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./hooks": {
+      "import": "./dist/hooks/index.js",
+      "require": "./dist/hooks/index.cjs",
+      "types": "./dist/hooks/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs",
+      "types": "./dist/utils/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "lint:fix": "eslint . --ext ts,tsx --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit",
+    "prepare": "husky install",
+    "semantic-release": "semantic-release"
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "utilities",
+    "typescript",
+    "embeddable",
+    "sdk",
+    "tree-shaking"
+  ],
+  "author": "Embeddable Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CommonNinja/embeddable-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/CommonNinja/embeddable-sdk/issues"
+  },
+  "homepage": "https://github.com/CommonNinja/embeddable-sdk#readme",
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-dom": ">=18.2.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^18.4.3",
+    "@commitlint/config-conventional": "^18.4.3",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^9.2.6",
+    "@semantic-release/npm": "^11.0.2",
+    "@testing-library/jest-dom": "^6.1.5",
+    "@testing-library/react": "^14.1.2",
+    "@testing-library/user-event": "^14.5.1",
+    "@types/react": "^18.2.43",
+    "@types/react-dom": "^18.2.17",
+    "@typescript-eslint/eslint-plugin": "^6.14.0",
+    "@typescript-eslint/parser": "^6.14.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "@vitest/coverage-v8": "^1.0.4",
+    "@vitest/ui": "^1.0.4",
+    "eslint": "^8.55.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "eslint-plugin-react-refresh": "^0.4.5",
+    "husky": "^8.0.3",
+    "jsdom": "^23.0.1",
+    "lint-staged": "^15.2.0",
+    "prettier": "^3.5.3",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "semantic-release": "^22.0.12",
+    "terser": "^5.39.2",
+    "typescript": "^5.2.2",
+    "vite": "^5.0.8",
+    "vite-plugin-dts": "^3.6.4",
+    "vitest": "^1.0.4"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json,md}": [
+      "prettier --write"
+    ],
+    "*.{ts,tsx}": [
+      "eslint --fix"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}