@fluentcommerce/fc-connect-sdk 0.1.52 → 0.1.54

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

@@ -0,0 +1,3 @@
+export { loadFluentProfile, listFluentProfiles, getFluentProfileInfo, resolveProfileBaseDir, } from './profile-loader';
+export type { FluentProfileOptions, FluentProfileInfo } from './profile-loader';
+export { OAuth2AuthProvider, BearerTokenAuthProvider, AuthManager, VersoriConnectionAdapter, type VersoriConnection, } from './auth-provider';

package/dist/types/auth/profile-loader.d.ts

@@ -0,0 +1,18 @@
+import { FluentClientConfig } from '../types';
+export interface FluentProfileOptions {
+    profileDir?: string;
+    retailer?: string;
+    timeout?: number;
+    retryConfig?: FluentClientConfig['retryConfig'];
+}
+export interface FluentProfileInfo {
+    name: string;
+    baseUrl: string;
+    accountId: string;
+    username: string;
+    retailers: string[];
+}
+export declare function resolveProfileBaseDir(options?: FluentProfileOptions): string;
+export declare function loadFluentProfile(profileName: string, options?: FluentProfileOptions): FluentClientConfig;
+export declare function listFluentProfiles(options?: FluentProfileOptions): string[];
+export declare function getFluentProfileInfo(profileName: string, options?: FluentProfileOptions): FluentProfileInfo | null;

package/dist/types/client-factory.d.ts

@@ -1,6 +1,7 @@
 import { FluentClient } from './clients/fluent-client';
 import { FluentVersoriClient } from './versori/fluent-versori-client';
 import { FluentClientConfig, Logger, ExecutionContext } from './types';
+import { type FluentProfileOptions } from './auth/profile-loader';
 export type ClientContext = {
     fetch: typeof fetch;
     log?: Logger;
@@ -24,3 +25,6 @@ export declare const isDirectContext: (context: ClientContext) => context is {
     config: FluentClientConfig;
     logger?: Logger;
 };
+export declare function createClientFromProfile(profileName: string, options?: FluentProfileOptions & CreateClientOptions & {
+    logger?: Logger;
+}): Promise<FluentClient>;

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { createClient, isHttpContext, isDirectContext } from './client-factory';
+export { createClient, createClientFromProfile, isHttpContext, isDirectContext, } from './client-factory';
 export type { ClientContext, CreateClientOptions } from './client-factory';
 export { FluentClient } from './clients/fluent-client';
 export { FluentVersoriClient } from './versori/fluent-versori-client';
@@ -14,6 +14,8 @@ export { DataSourceType } from './types';
 export { parseAndValidateCsv, detectFileType, parseWebhookRequest, validateFluentEvent, validateGraphQLPayload, generateFileName, generateTimestampedFileName, generateFilePath, generateDateSubdirectories, extractFileName, extractFileExtension, replaceFileExtension, type FileNamingOptions, } from './utils';
 export { detectPaginationVariables, extractConnection, extractCursor, hasMorePages, buildPaginationVariables, type PaginationVariables, } from './utils/pagination-helpers';
 export { OAuth2AuthProvider, BearerTokenAuthProvider, AuthManager, VersoriConnectionAdapter, type VersoriConnection, } from './auth/auth-provider';
+export { loadFluentProfile, listFluentProfiles, getFluentProfileInfo, resolveProfileBaseDir, } from './auth/profile-loader';
+export type { FluentProfileOptions, FluentProfileInfo } from './auth/profile-loader';
 export { type FileDiscoveryStrategy, type FileDiscoveryContext, type FileParserStrategy, type TransformationStrategy, type TransformationContext, type IngestionValidationResult, type BatchSubmissionStrategy, type BatchSubmissionContext, type BatchSubmissionResult, type JobManagementStrategy, type JobContext, type JobStatus, type IngestionStrategy, type StrategyFactory, } from './services/orchestration/strategies/ingestion-strategies';
 export * from './errors/index';
 export { ConfigurationError, AggregateIngestionError, IngestionErrorFactory, } from './errors/ingestion-errors';

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

@@ -133,7 +133,7 @@ export interface FluentEventLogContext {
 }
 export interface FluentEventLogAttribute {
     name: string;
-    value: string;
+    value: unknown;
     type?: string;
     [key: string]: unknown;
 }

package/docs/02-CORE-GUIDES/api-reference/cli-profile-integration.md

@@ -0,0 +1,377 @@
+# Fluent CLI Profile Integration
+
+## Overview
+
+The SDK can read profiles created by the official Fluent CLI (`fluent profile create`), allowing you to create a fully configured `FluentClient` without hardcoding any credentials. This is the recommended approach for standalone Node.js and Deno scripts that run outside the Versori platform.
+
+Key benefits:
+
+- **No hardcoded credentials.** Reuse the same profiles you already created with the Fluent CLI.
+- **One-liner client creation.** `createClientFromProfile('MYPROFILE')` returns a ready-to-use `FluentClient`.
+- **Multi-retailer support.** Pass a `retailer` option to automatically load the correct retailer ID and user credentials.
+
+## How Fluent CLI Profiles Work
+
+When you run `fluent profile create`, the CLI writes JSON files under `~/.fluentcommerce/`. Each profile is a directory containing credentials and optional retailer configurations.
+
+```
+~/.fluentcommerce/
+├── PROFILE_BETA/
+│   ├── profile.json              -> { id, baseUrl, clientSecret, user }
+│   ├── retailer.RETAILER_ALPHA.json    -> { id, ref, user }
+│   └── user.profile_beta_admin.json    -> { username, password }
+└── PROFILE_ALPHA/
+    ├── profile.json
+    └── user.profile_alpha_admin.json
+```
+
+**File descriptions:**
+
+| File | Purpose | Key Fields |
+|------|---------|------------|
+| `profile.json` | Account-level config | `id` (clientId), `baseUrl`, `clientSecret`, `user` (default username ref) |
+| `retailer.<REF>.json` | Retailer-specific config | `id` (retailerId), `ref`, `user` (retailer-specific username ref) |
+| `user.<name>.json` | User credentials | `username`, `password` |
+
+**Loading chain:**
+
+1. Read `profile.json` to get `baseUrl`, `clientId`, `clientSecret`, and the default user reference.
+2. If a retailer is specified, read `retailer.<ref>.json` to get `retailerId` and an optional user override.
+3. Read `user.<resolvedUser>.json` to get the final `username` and `password`.
+
+## Quick Start
+
+```typescript
+import { createClientFromProfile, listFluentProfiles } from '@fluentcommerce/fc-connect-sdk';
+
+// List available profiles
+const profiles = listFluentProfiles();
+console.log(profiles); // ['PROFILE_BETA', 'PROFILE_ALPHA']
+
+// Create a client from a CLI profile
+const client = await createClientFromProfile('PROFILE_ALPHA');
+
+// Use it like any other FluentClient
+const events = await client.getEvents({ eventType: 'ORCHESTRATION_AUDIT' });
+```
+
+## Retailer Override
+
+When a profile has multiple retailers, the `retailer` option loads the correct retailer ID **and** switches to the retailer-specific user credentials automatically.
+
+```typescript
+const client = await createClientFromProfile('PROFILE_BETA', { retailer: 'RETAILER_ALPHA' });
+```
+
+What happens internally:
+
+1. `profile.json` is read. Default user is `profile_beta_admin`.
+2. `retailer.RETAILER_ALPHA.json` is read. It overrides the user to `retailer_alpha_admin` and provides `retailerId: '5'`.
+3. `user.retailer_alpha_admin.json` is read for the final credentials.
+4. The resulting `FluentClientConfig` contains `retailerId: '5'` and the `retailer_alpha_admin` credentials -- not the default `profile_beta_admin`.
+
+Without the `retailer` option, the profile's default user is used and no `retailerId` is set.
+
+## API Reference
+
+All functions below are exported from the main SDK entry point:
+
+```typescript
+import {
+  createClientFromProfile,
+  loadFluentProfile,
+  listFluentProfiles,
+  getFluentProfileInfo,
+  resolveProfileBaseDir,
+} from '@fluentcommerce/fc-connect-sdk';
+```
+
+### createClientFromProfile(profileName, options?)
+
+Creates a `FluentClient` from a Fluent CLI profile. This is the primary entry point for most use cases.
+
+```typescript
+async function createClientFromProfile(
+  profileName: string,
+  options?: FluentProfileOptions & CreateClientOptions & { logger?: Logger }
+): Promise<FluentClient>
+```
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `profileName` | `string` | Yes | CLI profile name (directory name under `~/.fluentcommerce/`) |
+| `options` | `object` | No | Merged options from `FluentProfileOptions`, `CreateClientOptions`, and `{ logger }` |
+
+**Returns:** `Promise<FluentClient>` -- a fully configured client with OAuth2 credentials loaded from disk.
+
+**Throws:** `Error` if the profile directory, `profile.json`, retailer file, or user credentials file is missing or malformed.
+
+**Examples:**
+
+```typescript
+// Basic usage
+const client = await createClientFromProfile('PROFILE_ALPHA');
+
+// With retailer and connection validation
+const client = await createClientFromProfile('PROFILE_BETA', {
+  retailer: 'RETAILER_ALPHA',
+  validateConnection: true,
+});
+
+// With custom logger and timeout
+const client = await createClientFromProfile('PROFILE_BETA', {
+  retailer: 'RETAILER_ALPHA',
+  timeout: 30000,
+  logger: myCustomLogger,
+});
+```
+
+When `validateConnection: true` is set, the factory executes `query { me { ref } }` immediately after creating the client to verify that authentication works. If it fails, the error is thrown before any business logic runs.
+
+---
+
+### loadFluentProfile(profileName, options?)
+
+Loads a CLI profile and returns a raw `FluentClientConfig` object without creating a client. Useful when you need the config for custom client construction.
+
+```typescript
+function loadFluentProfile(
+  profileName: string,
+  options?: FluentProfileOptions
+): FluentClientConfig
+```
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `profileName` | `string` | Yes | CLI profile name |
+| `options` | `FluentProfileOptions` | No | Profile directory, retailer, timeout, retry overrides |
+
+**Returns:** `FluentClientConfig` with `baseUrl`, `clientId`, `clientSecret`, `username`, `password`, and optionally `retailerId`, `timeout`, `retryConfig`.
+
+**Throws:** `Error` if any required file is missing or contains invalid data.
+
+**Example:**
+
+```typescript
+const config = loadFluentProfile('PROFILE_BETA', { retailer: 'RETAILER_ALPHA' });
+// config = {
+//   baseUrl: 'https://profile-beta.api.fluentcommerce.com',
+//   clientId: 'PROFILE_BETA',
+//   clientSecret: '...',
+//   username: 'retailer_alpha_admin',
+//   password: '...',
+//   retailerId: '5',
+// }
+
+// Use with a custom client setup
+const client = new FluentClient(config, myLogger);
+```
+
+---
+
+### listFluentProfiles(options?)
+
+Lists all valid CLI profiles found on disk. A directory is considered a valid profile if it contains a `profile.json` file. Hidden directories (e.g., `.sessions`) are skipped.
+
+```typescript
+function listFluentProfiles(options?: FluentProfileOptions): string[]
+```
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `options` | `FluentProfileOptions` | No | Only `profileDir` is relevant here |
+
+**Returns:** Alphabetically sorted array of profile names. Returns an empty array if the base directory does not exist or contains no valid profiles.
+
+**Example:**
+
+```typescript
+const profiles = listFluentProfiles();
+// ['PROFILE_BETA', 'PROFILE_ALPHA']
+
+// Custom directory
+const profiles = listFluentProfiles({ profileDir: '/opt/fluent/profiles' });
+```
+
+---
+
+### getFluentProfileInfo(profileName, options?)
+
+Returns metadata about a profile without loading credentials. Useful for building profile selection UIs or diagnostic tools.
+
+```typescript
+function getFluentProfileInfo(
+  profileName: string,
+  options?: FluentProfileOptions
+): FluentProfileInfo | null
+```
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `profileName` | `string` | Yes | CLI profile name |
+| `options` | `FluentProfileOptions` | No | Only `profileDir` is relevant here |
+
+**Returns:** `FluentProfileInfo` object or `null` if the profile does not exist.
+
+**FluentProfileInfo shape:**
+
+```typescript
+interface FluentProfileInfo {
+  name: string;        // Profile name (directory name)
+  baseUrl: string;     // API base URL
+  accountId: string;   // Account/client ID
+  username: string;    // Default username reference
+  retailers: string[]; // Available retailer refs (from retailer.*.json files)
+}
+```
+
+**Example:**
+
+```typescript
+const info = getFluentProfileInfo('PROFILE_BETA');
+// {
+//   name: 'PROFILE_BETA',
+//   baseUrl: 'https://profile-beta.api.fluentcommerce.com',
+//   accountId: 'PROFILE_BETA',
+//   username: 'profile_beta_admin',
+//   retailers: ['RETAILER_ALPHA'],
+// }
+
+if (info && info.retailers.length > 0) {
+  console.log(`Profile has retailers: ${info.retailers.join(', ')}`);
+}
+```
+
+---
+
+### resolveProfileBaseDir(options?)
+
+Returns the base directory where CLI profiles are stored. Useful for debugging or custom profile discovery logic.
+
+```typescript
+function resolveProfileBaseDir(options?: FluentProfileOptions): string
+```
+
+**Resolution order:**
+
+1. `options.profileDir` if provided.
+2. `FLUENT_PROFILE_DIR` environment variable if set.
+3. `~/.fluentcommerce/` (default).
+
+**Example:**
+
+```typescript
+const dir = resolveProfileBaseDir();
+// '/home/user/.fluentcommerce'
+
+const dir = resolveProfileBaseDir({ profileDir: '/opt/fluent/profiles' });
+// '/opt/fluent/profiles'
+```
+
+## FluentProfileOptions
+
+All profile-related functions accept a `FluentProfileOptions` object:
+
+```typescript
+interface FluentProfileOptions {
+  profileDir?: string;
+  retailer?: string;
+  timeout?: number;
+  retryConfig?: FluentClientConfig['retryConfig'];
+}
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `profileDir` | `string` | `~/.fluentcommerce/` | Override the base directory for profile discovery |
+| `retailer` | `string` | `undefined` | Retailer ref (e.g., `'RETAILER_ALPHA'`). Loads retailer-specific `retailerId` and user credentials |
+| `timeout` | `number` | `undefined` | Request timeout in milliseconds. Passed through to `FluentClientConfig` |
+| `retryConfig` | `object` | `undefined` | Retry configuration. Passed through to `FluentClientConfig` |
+
+`createClientFromProfile` additionally accepts:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `validateConnection` | `boolean` | `false` | Execute a test query immediately to verify authentication |
+| `logger` | `Logger` | `undefined` | Custom logger instance passed to the `FluentClient` constructor |
+
+## Profile Directory Resolution
+
+The SDK resolves the profile base directory in the following order:
+
+1. **Explicit option:** `options.profileDir` takes highest priority.
+2. **Environment variable:** `FLUENT_PROFILE_DIR`, useful for CI or non-standard installations.
+3. **Default path:** `~/.fluentcommerce/`, which is where the Fluent CLI stores profiles by default.
+
+```typescript
+// Use default (~/.fluentcommerce/)
+const client = await createClientFromProfile('MYPROFILE');
+
+// Use environment variable
+// export FLUENT_PROFILE_DIR=/opt/fluent/profiles
+const client = await createClientFromProfile('MYPROFILE');
+
+// Explicit override (takes priority over env var)
+const client = await createClientFromProfile('MYPROFILE', {
+  profileDir: '/opt/fluent/profiles',
+});
+```
+
+## Error Handling
+
+All profile functions throw descriptive errors with actionable messages. The error messages include the file path that was expected and, where possible, a list of available alternatives.
+
+| Condition | Error Message Pattern |
+|-----------|----------------------|
+| Profile name is empty or not a string | `Profile name is required` |
+| Profile directory does not exist | `Fluent CLI profile '<name>' not found at <path>. Available profiles: X, Y` |
+| `profile.json` missing | `profile.json not found in <dir>. This directory may not be a valid Fluent CLI profile.` |
+| Required field missing in `profile.json` | `Profile '<name>' is missing required field '<field>' in profile.json` |
+| Retailer file not found | `Retailer '<ref>' not found for profile '<name>' at <path>. Available retailers: X, Y` |
+| User credentials file missing | `User credentials file not found: <path>. Expected file for user '<user>' (set by retailer '<ref>').` |
+| User credentials missing fields | `User credentials file <path> is missing 'username' or 'password' field` |
+| JSON parse failure | `Failed to read <path>: <original error>` |
+
+**Example: Handling missing profiles gracefully**
+
+```typescript
+import { listFluentProfiles, createClientFromProfile } from '@fluentcommerce/fc-connect-sdk';
+
+const profiles = listFluentProfiles();
+if (profiles.length === 0) {
+  console.error('No Fluent CLI profiles found. Run: fluent profile create <NAME>');
+  process.exit(1);
+}
+
+try {
+  const client = await createClientFromProfile(profiles[0]);
+} catch (err) {
+  console.error('Failed to load profile:', err.message);
+  process.exit(1);
+}
+```
+
+## When NOT to Use CLI Profiles
+
+CLI profile integration is designed for local development and standalone scripts. It is **not** appropriate for every runtime context.
+
+| Context | Recommended Approach |
+|---------|---------------------|
+| **Versori platform** | Use `createClient({ fetch, log, activation })`. Versori manages auth via connections. |
+| **CI/CD pipelines** | Use environment variables (`FLUENT_CLIENT_ID`, `FLUENT_CLIENT_SECRET`, etc.) with `new FluentClient(config)`. |
+| **Docker containers** | Use environment variables or mounted secrets, not host filesystem profiles. |
+| **Local dev / standalone scripts** | Use `createClientFromProfile()`. This is its intended use case. |
+
+## Source Files
+
+- Implementation: `src/auth/profile-loader.ts`
+- Factory integration: `src/client-factory.ts` (lines 284-296)
+- Public exports: `src/index.ts`

package/docs/02-CORE-GUIDES/api-reference/event-api-input-output-reference.md

@@ -1,6 +1,6 @@
 # Event API - Input/Output Reference Guide
 
-> **Complete reference** for Event API request/response structures with live examples from sagirish test environment
+> **Complete reference** for Event API request/response structures with live examples from a profile-alpha test environment
 
 ## Table of Contents
 
@@ -118,6 +118,15 @@ interface FluentEventQueryParams {
 }
 ```
 
+> **Note:** Context parameters use dot-notation (`context.rootEntityType`). In JavaScript/TypeScript, keys with dots **must be quoted**:
+> ```typescript
+> // ✅ Correct - quotes required for dot-notation keys
+> { 'context.rootEntityType': 'ORDER', eventType: 'ORCHESTRATION_AUDIT' }
+>
+> // ❌ Wrong - will cause syntax error
+> { context.rootEntityType: 'ORDER' }
+> ```
+
 ### Output: FluentEventLogResponse (SUCCESS)
 
 ```typescript
@@ -167,7 +176,7 @@ const result = await client.getEvents({
       "id": "e2cc5040-360b-43e9-b3c0-07bbc1934f82",
       "name": "BATCH_COMPLETE",
       "type": "ORCHESTRATION_AUDIT",
-      "accountId": "HMDEV",
+      "accountId": "PROFILE_BETA",
       "retailerId": "5",
       "category": "BATCH",
       "context": {
@@ -271,7 +280,7 @@ if (attrs) {
   "id": "e2cc5040-360b-43e9-b3c0-07bbc1934f82",
   "name": "BATCH_COMPLETE",
   "type": "ORCHESTRATION_AUDIT",
-  "accountId": "HMDEV",
+  "accountId": "PROFILE_BETA",
   "retailerId": "5",
   "category": "BATCH",
   "context": {
@@ -437,10 +446,10 @@ FluentValidationError {
 ### Test Environment Details
 
 ```yaml
-Base URL: https://sagirish.test.api.fluentretail.com
+Base URL: https://profile-alpha.test.api.fluentretail.com
 Retailer ID: 2
-Account ID: SAGIRISH
-Client ID: SAGIRISH
+Account ID: PROFILE_ALPHA
+Client ID: PROFILE_ALPHA
 ```
 
 ### Example 1: Successful Async Event
@@ -465,11 +474,11 @@ POST /api/v4.1/event/async
 **SDK Code:**
 ```typescript
 const client = new FluentClient({
-  baseUrl: 'https://sagirish.test.api.fluentretail.com',
-  clientId: 'SAGIRISH',
-  clientSecret: '534901d2-626d-4997-aabd-7600838d83c2',
-  username: 'module_test_admin',
-  password: '89YZBN',
+  baseUrl: 'https://profile-alpha.test.api.fluentretail.com',
+  clientId: 'PROFILE_ALPHA',
+  clientSecret: '<CLIENT_SECRET>',
+  username: 'profile_alpha_admin',
+  password: '<PASSWORD>',
   retailerId: '2'
 });
 
@@ -624,10 +633,10 @@ FluentValidationError: retailerId is required for Event API
 ```typescript
 // Client WITHOUT retailerId configured
 const client = new FluentClient({
-  baseUrl: 'https://sagirish.test.api.fluentretail.com',
-  clientId: 'SAGIRISH',
+  baseUrl: 'https://profile-alpha.test.api.fluentretail.com',
+  clientId: 'PROFILE_ALPHA',
   clientSecret: '...',
-  username: 'module_test_admin',
+  username: 'profile_alpha_admin',
   password: '...'
   // retailerId: undefined ← Not set
 });
@@ -1157,6 +1166,6 @@ try {
 
 ---
 
-**Generated from live test environments**: sagirish.test.api.fluentretail.com, hmdev.sandbox.api.fluentretail.com
+**Generated from live test environments**: profile-alpha.test.api.fluentretail.com, profile-beta.sandbox.api.fluentretail.com
 **SDK Version**: 0.1.51
 **Last Updated**: 2026-02-15

package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-01-client-api.md

@@ -56,6 +56,44 @@ const client = await createClient(ctx);
 
 - `Promise<FluentClient>` - Configured client instance
 
+#### createClientFromProfile Function (Fluent CLI Integration)
+
+Create a standalone `FluentClient` from an existing Fluent CLI profile in `~/.fluentcommerce`.
+
+```typescript
+import { createClientFromProfile } from '@fluentcommerce/fc-connect-sdk';
+
+// Simple profile
+const client = await createClientFromProfile('PROFILE_ALPHA');
+
+// Multi-retailer profile
+const retailerClient = await createClientFromProfile('PROFILE_BETA', {
+  retailer: 'RETAILER_ALPHA',
+  validateConnection: true, // Optional fail-fast auth check
+});
+```
+
+**Parameters:**
+
+- `profileName: string` - Fluent CLI profile directory name
+- `options?: FluentProfileOptions & CreateClientOptions`
+  - `profileDir?: string` - Override profile base directory (default: `~/.fluentcommerce`)
+  - `retailer?: string` - Retailer ref to load `retailer.<REF>.json` (retailer ID + user override)
+  - `timeout?: number` - Override request timeout
+  - `retryConfig?: RetryConfig` - Override retry behavior
+  - `validateConnection?: boolean` - Validate auth immediately using `query { me { ref } }`
+
+**Returns:**
+
+- `Promise<FluentClient>` - Standalone OAuth2 client built from profile credentials
+
+**Behavior Notes:**
+
+- Loads in this order: `profile.json` → optional `retailer.<REF>.json` → `user.<name>.json`
+- When `retailer` is provided, retailer-specific `user` override is respected
+- Throws explicit errors for missing profile/user/retailer files
+- For Versori runtime, use `createClient(ctx)` instead of profile-based loading
+
 #### FluentClientConfig Interface
 
 ```typescript

package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-09-rubix-event-vs-http-call.md

@@ -24,7 +24,7 @@ This module clarifies the **TWO types of webhooks** that can come from Fluent Co
 {
   "id": "2a43a5d2-0c8f-484d-a0cf-c5353d040997",
   "name": "order_webhook_status",
-  "accountId": "SAGIRISH",
+  "accountId": "PROFILE_ALPHA",
   "retailerId": "2",
   "entityId": "6469",
   "entityRef": "HD_G_FROM_POSTMAN_WEBHOOK_TEST",

package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-02-quick-start.md

@@ -128,7 +128,7 @@ console.log(`Locations: ${result.data.locations.edges.length} records`);
 
 ## Live Test Results ✅
 
-These examples were tested against a real Fluent Commerce API instance (`https://sagirish.test.api.fluentretail.com`):
+These examples were tested against a real Fluent Commerce API instance (`https://profile-alpha.test.api.fluentretail.com`):
 
 ### Test 1: Products + Locations with connectionPath
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluentcommerce/fc-connect-sdk",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "Fluent Commerce SDK - Deno & Node.js Compatible",
   "type": "module",
   "main": "dist/cjs/index.js",