@tagadapay/plugin-sdk 2.0.1 → 2.1.0

package/README.md

@@ -1,6 +1,6 @@
 # TagadaPay Plugin SDK
 
-A comprehensive SDK for building checkout plugins on the TagadaPay platform. Create custom checkout experiences with React components, payment processing, and advanced features.
+A comprehensive React SDK for building plugins on the TagadaPay platform. Create custom checkout experiences, landing pages, and interactive components with automatic configuration injection and advanced routing capabilities.pnpm
 
 ## 📚 Documentation
 
@@ -122,11 +122,11 @@ npm install @tagadapay/plugin-sdk
 
 ```tsx
 import React from 'react';
-import { 
-  TagadaProvider, 
+import {
+  TagadaProvider,
   usePluginConfig,
   useGoogleAutocomplete,
-  useISOData 
+  useISOData,
 } from '@tagadapay/plugin-sdk/react';
 
 function MyPlugin() {
@@ -134,7 +134,7 @@ function MyPlugin() {
 
   // Optional: Add address autocomplete
   const { searchPlaces, predictions } = useGoogleAutocomplete({
-    apiKey: config?.googleMapsApiKey || 'YOUR_API_KEY'
+    apiKey: config?.googleMapsApiKey || 'YOUR_API_KEY',
   });
 
   // Optional: Add country/region data
@@ -181,33 +181,40 @@ const { storeId, accountId, basePath, config } = usePluginConfig();
 
 ## 🎯 Key Features
 
-### Payment Processing
+### 🔧 **Plugin Configuration System**
+
+- **Automatic Context Injection** - Store ID, Account ID, and custom config
+- **Development & Production** - Seamless environment switching
+- **Generic Configuration** - Support for any JSON structure
+- **React Hooks** - Clean, type-safe configuration access
+
+### 💳 **Payment Processing**
 
 - Secure tokenized payments
 - Multiple payment method support
 - Real-time validation
 - PCI compliance
 
-### Customer Management
+### 🌍 **Address & Location**
 
-- Profile management
-- Address validation
-- Order history
-- Preferences
+- **Google Places Autocomplete** - Automatic API loading and address parsing
+- **ISO Country/Region Data** - Complete ISO 3166-1/3166-2 database
+- **Address Validation** - Structured component extraction
+- **Multi-language Support** - 11+ languages for international users
 
-### Cart & Pricing
+### 🛒 **E-commerce Features**
 
-- Dynamic pricing
-- Promotional offers
-- Tax calculations
-- Currency conversion
+- Dynamic pricing and promotional offers
+- Cart management and tax calculations
+- Currency conversion and formatting
+- Customer profile management
 
-### UI Components
+### 🎨 **UI & Development**
 
-- Pre-built checkout components
-- Customizable themes
-- Mobile-optimized
-- Accessibility features
+- Pre-built React components
+- Customizable themes with configuration
+- Mobile-optimized and accessible
+- TypeScript support throughout
 
 ## 📖 API Reference
 
@@ -347,48 +354,6 @@ npx @tagadapay/plugin-cli deploy --env production
 }
 ```
 
-### Environment Variables
-
-```env
-TAGADAPAY_API_KEY=your_api_key
-TAGADAPAY_ENVIRONMENT=sandbox
-TAGADAPAY_STORE_ID=your_store_id
-```
-
-## 🎨 Styling & Themes
-
-### CSS Custom Properties
-
-```css
-:root {
-  --tagada-primary: #007bff;
-  --tagada-secondary: #6c757d;
-  --tagada-success: #28a745;
-  --tagada-danger: #dc3545;
-  --tagada-border-radius: 4px;
-  --tagada-font-family: -apple-system, BlinkMacSystemFont, sans-serif;
-}
-```
-
-### Component Styling
-
-```typescript
-import { styled } from '@tagadapay/plugin-sdk';
-
-const StyledButton = styled.button`
-  background: var(--tagada-primary);
-  color: white;
-  border-radius: var(--tagada-border-radius);
-  padding: 12px 24px;
-  border: none;
-  cursor: pointer;
-
-  &:hover {
-    opacity: 0.9;
-  }
-`;
-```
-
 ## 🔐 Security
 
 ### Best Practices

package/dist/index.d.ts

@@ -1,33 +1,16 @@
 /**
  * Tagada Pay Plugin SDK
  *
- * Modern React SDK for building Tagada Pay plugins
+ * Core SDK for building Tagada Pay plugins
  *
- * Usage:
+ * For React-specific functionality, use:
  * ```tsx
  * import { TagadaProvider, useCustomer } from '@tagadapay/plugin-sdk/react';
- *
- * function App() {
- *   return (
- *     <TagadaProvider>
- *       <MyPlugin />
- *     </TagadaProvider>
- *   );
- * }
- *
- * function MyPlugin() {
- *   const { customer, isAuthenticated } = useCustomer();
- *
- *   return (
- *     <div>
- *       {isAuthenticated ? (
- *         <p>Welcome back, {customer.firstName}!</p>
- *       ) : (
- *         <p>Welcome, guest!</p>
- *       )}
- *     </div>
- *   );
- * }
  * ```
+ *
+ * This main export contains non-React utilities and types.
  */
-export * from './react';
+export type { Currency, Customer, Environment, EnvironmentConfig, Locale, Order, OrderAddress, OrderItem, OrderSummary, PickupPoint, Session, Store, } from './react/types';
+export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './react/utils/money';
+export * from './data/countries';
+export * from './data/iso3166';

package/dist/index.js

@@ -1,37 +1,17 @@
 /**
  * Tagada Pay Plugin SDK
  *
- * Modern React SDK for building Tagada Pay plugins
+ * Core SDK for building Tagada Pay plugins
  *
- * Usage:
+ * For React-specific functionality, use:
  * ```tsx
  * import { TagadaProvider, useCustomer } from '@tagadapay/plugin-sdk/react';
- *
- * function App() {
- *   return (
- *     <TagadaProvider>
- *       <MyPlugin />
- *     </TagadaProvider>
- *   );
- * }
- *
- * function MyPlugin() {
- *   const { customer, isAuthenticated } = useCustomer();
- *
- *   return (
- *     <div>
- *       {isAuthenticated ? (
- *         <p>Welcome back, {customer.firstName}!</p>
- *       ) : (
- *         <p>Welcome, guest!</p>
- *       )}
- *     </div>
- *   );
- * }
  * ```
+ *
+ * This main export contains non-React utilities and types.
  */
-// Export the new React SDK
-export * from './react';
-// Bridge functionality has been moved to separate imports to prevent SSR issues
-// If you need the deprecated bridge, explicitly import from '@tagadapay/plugin-sdk/bridge'
-// Example: import { initializePlugin } from '@tagadapay/plugin-sdk/bridge'
+// Export utility functions that don't depend on React
+export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './react/utils/money';
+// Export data utilities
+export * from './data/countries';
+export * from './data/iso3166';

package/package.json

@@ -1,9 +1,21 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.js"
+    }
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",