tradly 1.1.98 → 1.2.0

package/Helper/APIParam.js

@@ -1,22 +1,26 @@
-import {DEV, PRO, SANDBOX } from "../Constants/PathConstant.js"
+import { DEV, PRO, SANDBOX } from "../Constants/PathConstant.js";
 
 export var EVN = {
-  DEV:'development',
-  PRO: 'production',
-  SANDBOX: 'sandbox',
-}
-export var UserParameter = {data:{}}
+	DEV: "development",
+	PRO: "production",
+	SANDBOX: "sandbox",
+};
+export var UserParameter = { data: {} };
 export default function Environment(evn) {
-  switch(evn) {
-    case EVN.DEV : return DEV
-    case EVN.SANDBOX : return SANDBOX
-    case EVN.PRO : return PRO
-    default : return DEV
-  }
+	switch (evn) {
+		case EVN.DEV:
+			return DEV;
+		case EVN.SANDBOX:
+			return SANDBOX;
+		case EVN.PRO:
+			return PRO;
+		default:
+			return PRO;
+	}
 }
 
 export var ImageConfig = {
-  signedUrl:'',
-  mime:'', 
-  blob_body:''
-}
+	signedUrl: "",
+	mime: "",
+	blob_body: "",
+};

package/README.md

@@ -1,5 +1,3 @@
-# Tradly Platform JS SDK (Beluga)
-
 <p align="center">
   <a href="https://tradly.app">
     <h1 align="center"> Tradly Platform JS SDK </h1>
@@ -31,7 +29,7 @@ to launch marketplaces, Ecosystem for SaaS and commerce apps.
 ## Installation
 
 ```bash
-npm install beluga
+npm install tradly
 ```
 
 ### Optional: Install with Auth Package
@@ -48,11 +46,11 @@ npm install tradly @tradly/auth
 
 ### Option 1: With @tradly/auth (Recommended)
 
-**Simplest approach - just initialize auth, then use beluga directly:**
+**Simplest approach - just initialize auth, then use tradly sdk directly:**
 
 ```javascript
 import { initializeAuth, emailLogin } from "@tradly/auth";
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
 // Step 1: Initialize auth (once at app start)
 initializeAuth("beauty.tradly.co", "production");
@@ -60,7 +58,7 @@ initializeAuth("beauty.tradly.co", "production");
 // Step 2: Login via auth (keys automatically stored)
 await emailLogin("user@example.com", "password");
 
-// Step 3: Use beluga APIs directly (keys auto-injected!)
+// Step 3: Use tradly APIs directly (keys auto-injected!)
 const [error, response] = await TradlySDK.app.getListings({
 	bodyParam: {},
 	// authKey automatically from auth package!
@@ -79,9 +77,9 @@ const [error, response] = await TradlySDK.app.getListings({
 ### Option 2: Standalone (Without Auth Package)
 
 ```javascript
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
-// Initialize beluga
+// Initialize tradly
 await TradlySDK.init_v2.config({
 	domain: "beauty.tradly.co",
 	env: "production",
@@ -100,13 +98,13 @@ const [error, response] = await TradlySDK.app.getListings({
 
 ```javascript
 import { initializeAuth, emailLogin } from "@tradly/auth";
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
 // Initialize auth
 initializeAuth("beauty.tradly.co", "production");
 await emailLogin("user@example.com", "password");
 
-// Initialize beluga (uses auth's PK key automatically)
+// Initialize tradly (uses auth's PK key automatically)
 await TradlySDK.init_v2.config({
 	domain: "beauty.tradly.co",
 	env: "production",
@@ -125,7 +123,7 @@ const [error, response] = await TradlySDK.app.getListings({
 ### Using InitV2 (Recommended)
 
 ```javascript
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
 await TradlySDK.init_v2.config({
 	domain: "beauty.tradly.co", // Required
@@ -141,7 +139,7 @@ automatically use auth's cached PK key (no duplicate API call).
 ### Using Legacy Init (Deprecated)
 
 ```javascript
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
 await TradlySDK.init.config({
 	token: "your-pk-key", // PK key
@@ -154,7 +152,7 @@ await TradlySDK.init.config({
 
 ## Integration with @tradly/auth
 
-Beluga automatically integrates with `@tradly/auth` when available:
+tradly automatically integrates with `@tradly/auth` when available:
 
 ### Automatic Features
 
@@ -173,7 +171,7 @@ Beluga automatically integrates with `@tradly/auth` when available:
       - Syncs environment from auth config if `APPCONSTANT.ENVIRONMENT` is empty
 
 4. **Base URL Sync:**
-      - Uses auth's `baseUrl` if available (preferred over beluga's Environment
+      - Uses auth's `baseUrl` if available (preferred over tradly's Environment
         function)
 
 ### Backward Compatibility
@@ -695,7 +693,7 @@ auto-injected.
 ### Example 1: Get Listings
 
 ```javascript
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
 // With auth package (keys auto-injected)
 const [error, response] = await TradlySDK.app.getListings({
@@ -842,7 +840,7 @@ const [error, response] = await TradlySDK.app.getListings({
 
 ## Environment Variables
 
-Beluga supports these environments:
+Tradly sdk supports these environments:
 
 - `production` - Production API (https://api.tradly.app)
 - `development` - Development API (https://api.dev.tradly.app)
@@ -852,7 +850,7 @@ Beluga supports these environments:
 
 ## Best Practices
 
-1. **Initialize Once:** Initialize auth or beluga once at app startup
+1. **Initialize Once:** Initialize auth or tradly once at app startup
 2. **Use Auth Package:** For automatic key management, use `@tradly/auth`
 3. **Error Handling:** Always check for errors before using response
 4. **TypeScript:** Use TypeScript for better type safety
@@ -862,10 +860,10 @@ Beluga supports these environments:
 
 ## TypeScript Support
 
-While beluga is written in JavaScript, it works with TypeScript:
+While tradly is written in JavaScript, it works with TypeScript:
 
 ```typescript
-import TradlySDK from "beluga";
+import TradlySDK from "tradly";
 
 const [error, response]: [any, any] = await TradlySDK.app.getListings({
 	bodyParam: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tradly",
-  "version": "1.1.98",
+  "version": "1.2.0",
   "description": "Tradly JS SDK",
   "main": "index.js",
   "type": "module",

package/INTEGRATION_IMPLEMENTATION.md

@@ -1,290 +0,0 @@
-# Beluga-Auth Integration Implementation
-
-## Summary
-
-This document describes the implementation of automatic integration between
-`beluga` and `@tradly/auth` packages. After these enhancements, `beluga` will
-automatically detect and use `@tradly/auth` when available, without requiring
-any new packages.
-
----
-
-## Changes Made
-
-### 1. Created AuthHelper.js
-
-**File:** `beluga/Helper/AuthHelper.js`
-
-**Purpose:** Provides reusable functions for integrating with `@tradly/auth`
-package (optional dependency).
-
-**Key Functions:**
-
-- `getAuthKeyFromAuth()` - Gets auth key from auth package
-- `getPKKeyFromAuth()` - Gets PK key from auth package
-- `isAuthInitialized()` - Checks if auth package is initialized
-- `getAuthConfig()` - Gets auth configuration
-- `getCachedPKKeyFromAuth(domain, env)` - Gets cached PK key data
-- `enrichParamsWithAuth(params)` - Enriches params with auth key
-
-**Features:**
-
-- ✅ Safely handles cases where `@tradly/auth` is not installed
-- ✅ Uses ES module dynamic import
-- ✅ Non-blocking eager loading
-- ✅ Graceful fallback if package unavailable
-
----
-
-### 2. Enhanced NetworkManager.js
-
-**File:** `beluga/NetworkManager/NetworkManager.js`
-
-**Changes:**
-
-1. **Added import for AuthHelper:**
-   ```javascript
-   import {
-       getAuthKeyFromAuth,
-       getPKKeyFromAuth,
-   } from "../Helper/AuthHelper.js";
-   ```
-
-2. **Auto-inject PK key from auth:**
-   - If `APPCONSTANT.TOKEN` is empty, tries to get PK key from auth package
-   - Caches the PK key in `APPCONSTANT.TOKEN` for future use
-
-3. **Auto-inject auth key from auth:**
-   - If `config.authKey` is not provided, tries to get auth key from auth package
-   - Only injects if auth package is available and initialized
-
-**Benefits:**
-
-- ✅ All beluga API calls automatically get keys from auth
-- ✅ No changes needed in individual methods
-- ✅ Works immediately after enhancement
-- ✅ Backward compatible (works without auth package)
-
----
-
-### 3. Enhanced InitV2.js
-
-**File:** `beluga/Roots/InitV2.js`
-
-**Changes:**
-
-1. **Added import for AuthHelper:**
-   ```javascript
-   import {
-       isAuthInitialized,
-       getAuthConfig,
-       getCachedPKKeyFromAuth,
-   } from "../Helper/AuthHelper.js";
-   ```
-
-2. **Check auth package before fetching PK key:**
-   - Checks if auth package is initialized
-   - If initialized and domain/env match, uses auth's cached PK key
-   - Skips API call to fetch PK key if auth already has it
-   - Syncs `APPCONSTANT` with auth's configuration
-
-**Benefits:**
-
-- ✅ Avoids duplicate PK key fetching
-- ✅ Consistent configuration
-- ✅ Single source of truth (auth)
-- ✅ Faster initialization
-
----
-
-## How It Works
-
-### Initialization Flow
-
-```javascript
-// Step 1: Initialize auth package
-import { initializeAuth } from "@tradly/auth";
-initializeAuth("beauty.tradly.co", "production");
-// Auth package automatically fetches and caches PK key
-
-// Step 2: Initialize beluga (optional, but recommended)
-import TradlySDK from "beluga";
-await TradlySDK.init_v2.config({
-    domain: "beauty.tradly.co",
-    env: "production",
-});
-// InitV2 will detect auth is initialized and use its PK key
-// No duplicate API call needed!
-```
-
-### API Call Flow
-
-```javascript
-// Step 1: User logs in via auth package
-import { emailLogin } from "@tradly/auth";
-await emailLogin("user@example.com", "password");
-// Auth key automatically stored by auth package
-
-// Step 2: Use beluga APIs (keys auto-injected)
-import TradlySDK from "beluga";
-const [error, response] = await TradlySDK.app.getListings({
-    bodyParam: {},
-    // authKey not needed - automatically from auth package!
-});
-```
-
-### NetworkManager Auto-Injection
-
-When `NetworkManager.networkCall()` is called:
-
-1. **PK Key Injection:**
-   - Checks if `APPCONSTANT.TOKEN` exists
-   - If not, tries to get from auth package
-   - Caches it in `APPCONSTANT.TOKEN`
-
-2. **Auth Key Injection:**
-   - Checks if `config.authKey` is provided
-   - If not, tries to get from auth package
-   - Adds to headers if available
-
----
-
-## Backward Compatibility
-
-### Scenario 1: Auth Package NOT Installed
-
-```javascript
-// Beluga works exactly as before
-import TradlySDK from "beluga";
-await TradlySDK.init_v2.config({
-    domain: "beauty.tradly.co",
-    env: "production",
-});
-
-// Manual authKey passing still works
-const [error, response] = await TradlySDK.app.getListings({
-    authKey: "manual-key",
-    bodyParam: {},
-});
-```
-
-**Result:** ✅ Works exactly as before, no errors
-
----
-
-### Scenario 2: Auth Package Installed but NOT Initialized
-
-```javascript
-// Auth package installed but not initialized
-import TradlySDK from "beluga";
-await TradlySDK.init_v2.config({
-    domain: "beauty.tradly.co",
-    env: "production",
-});
-
-// Beluga will fetch PK key normally (no auth sync)
-const [error, response] = await TradlySDK.app.getListings({
-    authKey: "manual-key", // Still need manual key
-    bodyParam: {},
-});
-```
-
-**Result:** ✅ Works as before, manual keys still work
-
----
-
-### Scenario 3: Auth Package Installed AND Initialized
-
-```javascript
-// Initialize auth first
-import { initializeAuth, emailLogin } from "@tradly/auth";
-initializeAuth("beauty.tradly.co", "production");
-await emailLogin("user@example.com", "password");
-
-// Initialize beluga (uses auth's PK key)
-import TradlySDK from "beluga";
-await TradlySDK.init_v2.config({
-    domain: "beauty.tradly.co",
-    env: "production",
-});
-// Uses auth's cached PK key - no API call!
-
-// Use beluga APIs (keys auto-injected)
-const [error, response] = await TradlySDK.app.getListings({
-    bodyParam: {},
-    // authKey automatically from auth package!
-});
-```
-
-**Result:** ✅ Automatic key injection, seamless integration
-
----
-
-## Testing Checklist
-
-### Test Case 1: Without Auth Package
-
-- [ ] Install beluga without `@tradly/auth`
-- [ ] Initialize beluga normally
-- [ ] Make API calls with manual authKey
-- [ ] Verify no errors occur
-- [ ] Verify API calls work as before
-
-### Test Case 2: With Auth Package (Not Initialized)
-
-- [ ] Install both `beluga` and `@tradly/auth`
-- [ ] Don't initialize auth
-- [ ] Initialize beluga normally
-- [ ] Make API calls with manual authKey
-- [ ] Verify no errors occur
-- [ ] Verify beluga works normally
-
-### Test Case 3: With Auth Package (Initialized)
-
-- [ ] Install both packages
-- [ ] Initialize auth first
-- [ ] Login via auth package
-- [ ] Initialize beluga (should use auth's PK key)
-- [ ] Make API calls without manual authKey
-- [ ] Verify keys are auto-injected
-- [ ] Verify API calls work correctly
-
-### Test Case 4: Manual Override
-
-- [ ] Initialize auth and login
-- [ ] Initialize beluga
-- [ ] Make API call with manual authKey (should override)
-- [ ] Verify manual key is used instead of auto-injected
-
----
-
-## Files Modified
-
-1. ✅ `beluga/Helper/AuthHelper.js` - **NEW FILE**
-2. ✅ `beluga/NetworkManager/NetworkManager.js` - **ENHANCED**
-3. ✅ `beluga/Roots/InitV2.js` - **ENHANCED**
-
----
-
-## Next Steps
-
-1. **Testing:** Test all scenarios to ensure backward compatibility
-2. **Documentation:** Update beluga README with integration examples
-3. **TypeScript Definitions:** Add TypeScript definitions (optional)
-4. **Performance:** Monitor and optimize if needed
-
----
-
-## Benefits Summary
-
-✅ **No Breaking Changes:** All existing code continues to work  
-✅ **Automatic Integration:** Keys auto-injected when auth is used  
-✅ **Backward Compatible:** Works without auth package  
-✅ **No New Package:** Keeps both packages separate  
-✅ **Seamless Experience:** Users can use both packages together  
-✅ **Performance:** Avoids duplicate PK key fetching  
-
----
-
-This implementation follows the recommendations in `UNIFICATION_ANALYSIS.md`
-and provides seamless integration between `beluga` and `@tradly/auth` packages.

package/USAGE_SCENARIOS.md

@@ -1,293 +0,0 @@
-# Beluga-Auth Integration Usage Scenarios
-
-## Scenario 1: Initialize Auth Only (Recommended - Simplest)
-
-**Question:** Can I just initialize auth and use beluga SDK APIs directly?
-
-**Answer:** ✅ **YES!** This will work after the enhancements.
-
-### Usage:
-
-```javascript
-// Step 1: Initialize auth only
-import { initializeAuth, emailLogin } from "@tradly/auth";
-initializeAuth("beauty.tradly.co", "production");
-
-// Step 2: Login via auth
-await emailLogin("user@example.com", "password");
-// Auth key automatically stored
-
-// Step 3: Use beluga APIs directly (NO init_v2.config() needed!)
-import TradlySDK from "beluga";
-
-// Keys are automatically injected:
-// - PK key from auth's cache
-// - Auth key from auth's storage
-// - Environment from auth's config
-// - Base URL from auth's config
-const [error, response] = await TradlySDK.app.getListings({
-	bodyParam: {},
-	// No authKey needed - automatically from auth!
-});
-
-const [error2, response2] = await TradlySDK.app.getAccounts({
-	bodyParam: {},
-	// Keys auto-injected!
-});
-```
-
-### What Happens Automatically:
-
-1. **PK Key:** NetworkManager gets PK key from auth's cache
-2. **Auth Key:** NetworkManager gets auth key from auth's storage
-3. **Environment:** NetworkManager syncs environment from auth config
-4. **Base URL:** NetworkManager uses auth's baseUrl if available
-
-### Benefits:
-
-- ✅ Simplest usage - only initialize auth
-- ✅ No need to call `init_v2.config()`
-- ✅ All keys automatically injected
-- ✅ Consistent configuration
-
----
-
-## Scenario 2: Initialize Both (Optional - For Explicit Control)
-
-**Usage:**
-
-```javascript
-// Step 1: Initialize auth
-import { initializeAuth, emailLogin } from "@tradly/auth";
-initializeAuth("beauty.tradly.co", "production");
-await emailLogin("user@example.com", "password");
-
-// Step 2: Initialize beluga (optional - uses auth's PK key)
-import TradlySDK from "beluga";
-await TradlySDK.init_v2.config({
-	domain: "beauty.tradly.co",
-	env: "production",
-});
-// Uses auth's cached PK key - no duplicate API call!
-
-// Step 3: Use beluga APIs
-const [error, response] = await TradlySDK.app.getListings({
-	bodyParam: {},
-});
-```
-
-### Benefits:
-
-- ✅ Explicit initialization
-- ✅ Beluga's cache is populated
-- ✅ Still uses auth's keys automatically
-
----
-
-## Scenario 3: Without Auth Package (Backward Compatible)
-
-**Usage:**
-
-```javascript
-// Only beluga, no auth package
-import TradlySDK from "beluga";
-
-// Initialize beluga normally
-await TradlySDK.init_v2.config({
-	domain: "beauty.tradly.co",
-	env: "production",
-});
-
-// Use beluga APIs with manual authKey
-const [error, response] = await TradlySDK.app.getListings({
-	authKey: "manual-key",
-	bodyParam: {},
-});
-```
-
-### Result:
-
-- ✅ Works exactly as before
-- ✅ No errors
-- ✅ Manual key passing still works
-
----
-
-## Scenario 4: Auth Installed but Not Initialized
-
-**Usage:**
-
-```javascript
-// Auth package installed but not initialized
-import TradlySDK from "beluga";
-
-// Initialize beluga normally
-await TradlySDK.init_v2.config({
-	domain: "beauty.tradly.co",
-	env: "production",
-});
-
-// Beluga will fetch PK key normally (no auth sync)
-const [error, response] = await TradlySDK.app.getListings({
-	authKey: "manual-key", // Still need manual key
-	bodyParam: {},
-});
-```
-
-### Result:
-
-- ✅ Works as before
-- ✅ Manual keys still work
-- ✅ No errors thrown
-
----
-
-## Complete Example: Auth Only Initialization
-
-```javascript
-// app.js or main entry point
-import { initializeAuth } from "@tradly/auth";
-
-// Initialize once at app start
-initializeAuth("beauty.tradly.co", "production");
-
-// ============================================
-// In your login component
-// ============================================
-import { emailLogin } from "@tradly/auth";
-
-async function handleLogin(email, password) {
-	const response = await emailLogin(email, password);
-	if (response.status) {
-		// User logged in, auth key stored automatically
-		console.log("Login successful!");
-	}
-}
-
-// ============================================
-// In your listings component
-// ============================================
-import TradlySDK from "beluga";
-
-async function loadListings() {
-	// No initialization needed!
-	// Keys automatically injected from auth package
-	const [error, response] = await TradlySDK.app.getListings({
-		bodyParam: {
-			page: 1,
-			per_page: 20,
-		},
-		// authKey automatically from auth package!
-	});
-
-	if (error) {
-		console.error("Error:", error);
-	} else {
-		console.log("Listings:", response.data);
-	}
-}
-
-// ============================================
-// In your orders component
-// ============================================
-async function loadOrders() {
-	// Same - keys auto-injected
-	const [error, response] = await TradlySDK.app.getOrders({
-		bodyParam: {},
-		// No authKey needed!
-	});
-}
-```
-
----
-
-## What Gets Auto-Injected
-
-When you call any beluga API method, NetworkManager automatically:
-
-1. **Checks for PK Key:**
-
-      - If `APPCONSTANT.TOKEN` is empty → Gets from auth package
-      - Caches it in `APPCONSTANT.TOKEN`
-
-2. **Checks for Auth Key:**
-
-      - If `config.authKey` is not provided → Gets from auth package
-      - Adds to `x-auth-key` header
-
-3. **Syncs Environment:**
-
-      - If `APPCONSTANT.ENVIRONMENT` is empty → Gets from auth config
-      - Sets `APPCONSTANT.ENVIRONMENT`
-
-4. **Uses Base URL:**
-      - Prefers auth's `baseUrl` if available
-      - Falls back to beluga's `Environment()` function
-
----
-
-## Testing the Integration
-
-### Test 1: Auth Only Initialization
-
-```javascript
-// Test: Initialize auth only, use beluga directly
-import { initializeAuth, emailLogin } from "@tradly/auth";
-import TradlySDK from "beluga";
-
-// Initialize auth
-initializeAuth("beauty.tradly.co", "production");
-
-// Login
-await emailLogin("test@example.com", "password");
-
-// Use beluga directly (no init_v2.config())
-const [error, response] = await TradlySDK.app.getListings({
-	bodyParam: {},
-});
-
-console.log("Works:", !error && response);
-// Expected: true (keys auto-injected)
-```
-
-### Test 2: Manual Override
-
-```javascript
-// Test: Manual authKey should override auto-injected
-const [error, response] = await TradlySDK.app.getListings({
-	authKey: "custom-key", // Should override auto-injected
-	bodyParam: {},
-});
-
-// Manual key takes precedence
-```
-
----
-
-## Summary
-
-✅ **YES, you can just initialize auth and use beluga SDK APIs directly!**
-
-After the enhancements:
-
-- ✅ Initialize auth once
-- ✅ Login via auth (keys stored automatically)
-- ✅ Use beluga APIs directly (no `init_v2.config()` needed)
-- ✅ All keys automatically injected
-- ✅ Environment and base URL synced from auth
-
-**Simplest Usage:**
-
-```javascript
-// 1. Initialize auth
-initializeAuth("beauty.tradly.co", "production");
-
-// 2. Login
-await emailLogin("user@example.com", "password");
-
-// 3. Use beluga directly
-await TradlySDK.app.getListings({ bodyParam: {} });
-```
-
-That's it! No other initialization needed.
-