@fluentcommerce/fc-connect-sdk 0.1.52 → 0.1.54

package/README.md

@@ -31,6 +31,8 @@ TypeScript SDK for building **Fluent Commerce** integrations across Node.js, Den
 - [More Examples](#-more-quick-examples) - Common patterns
 - [Core Services](#core-services) - API reference
 - [CLI Tools](#cli-tooling) - Command-line utilities
+- [Standalone Usage](#-standalone-usage-outside-versori) - Node.js/Deno app integration
+- [CLI Profile Integration](#fluent-cli-profile-integration-no-hardcoded-credentials) - Reuse Fluent CLI profiles
 - [Authentication & Webhooks](#authentication-webhooks) - Security
 - [Security & Compliance](#security--compliance) - Security audits, SOC 2, vulnerability management 🆕
 - [Common Pitfalls](#common-pitfalls-and-fixes) - Troubleshooting
@@ -1309,7 +1311,17 @@ if (logs.results[0]?.id) {
 
 #### Query Parameters
 
-All parameters are optional. Context filters use flat dot-notation keys:
+All parameters are optional. Context filters use **dot-notation keys** which require quotes in JavaScript/TypeScript:
+
+```typescript
+// ⚠️ Dot-notation keys MUST be quoted (JavaScript syntax requirement)
+await client.getEvents({
+  'context.rootEntityType': 'ORDER',  // ✅ Quotes required (has dot)
+  'context.entityRef': 'ORD-123',     // ✅ Quotes required (has dot)
+  eventType: 'ORCHESTRATION_AUDIT',   // ✅ No quotes needed (simple key)
+  count: 100,                         // ✅ No quotes needed (simple key)
+});
+```
 
 | Parameter | Type | Description | Example |
 |-----------|------|-------------|---------|
@@ -1325,7 +1337,7 @@ All parameters are optional. Context filters use flat dot-notation keys:
 | `category` | string | Category filter | `'ruleSet'`, `'ACTION'` |
 | `from` | string | Start date (UTC ISO 8601) | `'2026-02-01T00:00:00.000Z'` |
 | `to` | string | End date (UTC ISO 8601) | `'2026-02-15T23:59:59.999Z'` |
-| `retailerId` | string/number | Retailer filter (falls back to client config) | `'5'` |
+| `retailerId` | string/number | Retailer filter (pass explicitly; no auto-fallback) | `'5'` |
 | `start` | number | Pagination offset (default: `0`) | `0` |
 | `count` | number | Results per page (default: `100`, max: `5000`) | `1000` |
 
@@ -1418,7 +1430,7 @@ const orderEvents = await client.getEvents({
 | **Time range (to)** | 1 month forward max | API rejects future dates beyond ~1 month |
 | **Default time window** | Past 30 days | Applied when `from` is omitted |
 | **Date format** | UTC ISO 8601 | `YYYY-MM-DDTHH:mm:ss.SSSZ` |
-| **retailerId fallback** | Client config | If not in params, uses `client.config.retailerId` |
+| **retailerId** | Pass explicitly | Unlike `sendEvent()`, no auto-fallback to client config — pass in params if needed |
 | **attributes field** | Nullable | Can be `null` (not empty array) — always check before iterating |
 | **name field** | Nullable | Can be `null` for some system events |
 | **GraphQL** | Not available | Event queries use REST only — no GraphQL `events` root field exists |
@@ -1658,6 +1670,43 @@ console.log('Status:', response.status);
 console.log('Data:', response.data);
 ```
 
+### Fluent CLI Profile Integration (No Hardcoded Credentials)
+
+If you already use the Fluent CLI (`fluent profile create`, `fluent profile switch`), you can reuse the same profile files directly in the SDK.
+
+```typescript
+import { createClientFromProfile, listFluentProfiles } from '@fluentcommerce/fc-connect-sdk';
+
+// Discover available local Fluent CLI profiles (~/.fluentcommerce/*)
+const profiles = listFluentProfiles();
+// Example: ['PROFILE_ALPHA', 'PROFILE_BETA']
+
+// Create client from profile.json + user.*.json
+const client = await createClientFromProfile('PROFILE_ALPHA');
+
+// Multi-retailer profile: pass retailer ref to load retailerId + retailer user override
+const retailerClient = await createClientFromProfile('PROFILE_BETA', {
+  retailer: 'RETAILER_ALPHA',
+  validateConnection: true, // Optional fail-fast auth check
+});
+
+const events = await retailerClient.getEvents({
+  eventType: 'ORCHESTRATION_AUDIT',
+  'context.rootEntityType': 'ORDER',
+});
+```
+
+**Behavior and limitations:**
+
+- Uses Fluent CLI profile files from `~/.fluentcommerce/<PROFILE>/`:
+  - `profile.json` (base URL, client ID/secret, default user)
+  - `retailer.<REF>.json` (optional retailer ID + retailer-specific user override)
+  - `user.<name>.json` (username/password)
+- For multi-retailer setups, pass `retailer` to ensure the correct retailer-specific user credentials are loaded.
+- Throws clear errors when profile directories/files are missing or malformed.
+- Supports profile directory overrides via `FLUENT_PROFILE_DIR` or `options.profileDir`.
+- Intended for standalone Node.js/Deno usage; in Versori workflows use `createClient(ctx)` instead.
+
 ### What's Handled Automatically
 
 - ✅ **OAuth2 Authentication** - Token fetched and cached automatically

package/dist/cjs/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/cjs/auth/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersoriConnectionAdapter = exports.AuthManager = exports.BearerTokenAuthProvider = exports.OAuth2AuthProvider = exports.resolveProfileBaseDir = exports.getFluentProfileInfo = exports.listFluentProfiles = exports.loadFluentProfile = void 0;
+var profile_loader_1 = require("./profile-loader");
+Object.defineProperty(exports, "loadFluentProfile", { enumerable: true, get: function () { return profile_loader_1.loadFluentProfile; } });
+Object.defineProperty(exports, "listFluentProfiles", { enumerable: true, get: function () { return profile_loader_1.listFluentProfiles; } });
+Object.defineProperty(exports, "getFluentProfileInfo", { enumerable: true, get: function () { return profile_loader_1.getFluentProfileInfo; } });
+Object.defineProperty(exports, "resolveProfileBaseDir", { enumerable: true, get: function () { return profile_loader_1.resolveProfileBaseDir; } });
+var auth_provider_1 = require("./auth-provider");
+Object.defineProperty(exports, "OAuth2AuthProvider", { enumerable: true, get: function () { return auth_provider_1.OAuth2AuthProvider; } });
+Object.defineProperty(exports, "BearerTokenAuthProvider", { enumerable: true, get: function () { return auth_provider_1.BearerTokenAuthProvider; } });
+Object.defineProperty(exports, "AuthManager", { enumerable: true, get: function () { return auth_provider_1.AuthManager; } });
+Object.defineProperty(exports, "VersoriConnectionAdapter", { enumerable: true, get: function () { return auth_provider_1.VersoriConnectionAdapter; } });

package/dist/cjs/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/cjs/auth/profile-loader.js

@@ -0,0 +1,208 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProfileBaseDir = resolveProfileBaseDir;
+exports.loadFluentProfile = loadFluentProfile;
+exports.listFluentProfiles = listFluentProfiles;
+exports.getFluentProfileInfo = getFluentProfileInfo;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+function resolveProfileBaseDir(options) {
+    if (options?.profileDir) {
+        return options.profileDir;
+    }
+    const envDir = process.env.FLUENT_PROFILE_DIR;
+    if (envDir) {
+        return envDir;
+    }
+    return path.join(os.homedir(), '.fluentcommerce');
+}
+function loadFluentProfile(profileName, options) {
+    if (!profileName || typeof profileName !== 'string') {
+        throw new Error('Profile name is required');
+    }
+    const baseDir = resolveProfileBaseDir(options);
+    const profileDir = path.join(baseDir, profileName);
+    if (!fs.existsSync(profileDir)) {
+        const available = listFluentProfiles(options);
+        throw new Error(`Fluent CLI profile '${profileName}' not found at ${profileDir}. ` +
+            (available.length > 0
+                ? `Available profiles: ${available.join(', ')}`
+                : `No profiles found in ${baseDir}. Create one with: fluent profile create ${profileName}`));
+    }
+    const profileJsonPath = path.join(profileDir, 'profile.json');
+    if (!fs.existsSync(profileJsonPath)) {
+        throw new Error(`profile.json not found in ${profileDir}. ` +
+            `This directory may not be a valid Fluent CLI profile.`);
+    }
+    let profile;
+    try {
+        const raw = fs.readFileSync(profileJsonPath, 'utf-8');
+        profile = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to read ${profileJsonPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!profile.baseUrl) {
+        throw new Error(`Profile '${profileName}' is missing required field 'baseUrl' in profile.json`);
+    }
+    if (!profile.id) {
+        throw new Error(`Profile '${profileName}' is missing required field 'id' in profile.json`);
+    }
+    if (!profile.clientSecret) {
+        throw new Error(`Profile '${profileName}' is missing required field 'clientSecret' in profile.json`);
+    }
+    if (!profile.user) {
+        throw new Error(`Profile '${profileName}' is missing required field 'user' in profile.json`);
+    }
+    let retailerId;
+    let resolvedUser = profile.user;
+    if (options?.retailer) {
+        const retailerJsonPath = path.join(profileDir, `retailer.${options.retailer}.json`);
+        if (!fs.existsSync(retailerJsonPath)) {
+            const availableRetailers = listProfileRetailers(profileDir);
+            throw new Error(`Retailer '${options.retailer}' not found for profile '${profileName}' at ${retailerJsonPath}. ` +
+                (availableRetailers.length > 0
+                    ? `Available retailers: ${availableRetailers.join(', ')}`
+                    : `No retailer files found in ${profileDir}.`));
+        }
+        let retailer;
+        try {
+            const raw = fs.readFileSync(retailerJsonPath, 'utf-8');
+            retailer = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`Failed to read ${retailerJsonPath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        retailerId = retailer.id;
+        if (retailer.user) {
+            resolvedUser = retailer.user;
+        }
+    }
+    const userJsonPath = path.join(profileDir, `user.${resolvedUser}.json`);
+    if (!fs.existsSync(userJsonPath)) {
+        throw new Error(`User credentials file not found: ${userJsonPath}. ` +
+            `Expected file for user '${resolvedUser}'` +
+            (options?.retailer
+                ? ` (set by retailer '${options.retailer}').`
+                : ` (set in profile.json).`));
+    }
+    let userCreds;
+    try {
+        const raw = fs.readFileSync(userJsonPath, 'utf-8');
+        userCreds = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to read ${userJsonPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!userCreds.username || !userCreds.password) {
+        throw new Error(`User credentials file ${userJsonPath} is missing 'username' or 'password' field`);
+    }
+    const config = {
+        baseUrl: profile.baseUrl,
+        clientId: profile.id,
+        clientSecret: profile.clientSecret,
+        username: userCreds.username,
+        password: userCreds.password,
+    };
+    if (retailerId) {
+        config.retailerId = retailerId;
+    }
+    if (options?.timeout) {
+        config.timeout = options.timeout;
+    }
+    if (options?.retryConfig) {
+        config.retryConfig = options.retryConfig;
+    }
+    return config;
+}
+function listFluentProfiles(options) {
+    const baseDir = resolveProfileBaseDir(options);
+    if (!fs.existsSync(baseDir)) {
+        return [];
+    }
+    try {
+        const entries = fs.readdirSync(baseDir, { withFileTypes: true });
+        return entries
+            .filter(entry => {
+            if (!entry.isDirectory())
+                return false;
+            if (entry.name.startsWith('.'))
+                return false;
+            const profileJson = path.join(baseDir, entry.name, 'profile.json');
+            return fs.existsSync(profileJson);
+        })
+            .map(entry => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function getFluentProfileInfo(profileName, options) {
+    const baseDir = resolveProfileBaseDir(options);
+    const profileDirPath = path.join(baseDir, profileName);
+    const profileJsonPath = path.join(profileDirPath, 'profile.json');
+    if (!fs.existsSync(profileJsonPath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(profileJsonPath, 'utf-8');
+        const profile = JSON.parse(raw);
+        return {
+            name: profileName,
+            baseUrl: profile.baseUrl,
+            accountId: profile.id,
+            username: profile.user,
+            retailers: listProfileRetailers(profileDirPath),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function listProfileRetailers(profileDirPath) {
+    try {
+        const entries = fs.readdirSync(profileDirPath);
+        return entries
+            .filter(name => name.startsWith('retailer.') && name.endsWith('.json'))
+            .map(name => name.slice('retailer.'.length, -'.json'.length))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}

package/dist/cjs/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/cjs/client-factory.js

@@ -2,8 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isDirectContext = exports.isHttpContext = void 0;
 exports.createClient = createClient;
+exports.createClientFromProfile = createClientFromProfile;
 const fluent_client_1 = require("./clients/fluent-client");
 const fluent_versori_client_1 = require("./versori/fluent-versori-client");
+const profile_loader_1 = require("./auth/profile-loader");
 async function createClient(context, options) {
     const logger = 'log' in context ? context.log : 'logger' in context ? context.logger : undefined;
     const validateConnection = options?.validateConnection ?? false;
@@ -107,3 +109,11 @@ const isDirectContext = (context) => {
     return 'config' in context;
 };
 exports.isDirectContext = isDirectContext;
+async function createClientFromProfile(profileName, options) {
+    const config = (0, profile_loader_1.loadFluentProfile)(profileName, options);
+    const client = new fluent_client_1.FluentClient(config, options?.logger);
+    if (options?.validateConnection) {
+        await client.graphql({ query: 'query { me { ref } }' });
+    }
+    return client;
+}

package/dist/cjs/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/cjs/index.js

@@ -14,10 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.XMLBuilder = exports.detectParserFileType = exports.isParserSupported = exports.getSupportedParserTypes = exports.createParser = exports.JSONParserService = exports.XMLParserService = exports.ParquetParserService = exports.CSVParserService = exports.classifyErrors = exports.classifyError = exports.IngestionErrorFactory = exports.AggregateIngestionError = exports.ConfigurationError = exports.VersoriConnectionAdapter = exports.AuthManager = exports.BearerTokenAuthProvider = exports.OAuth2AuthProvider = exports.buildPaginationVariables = exports.hasMorePages = exports.extractCursor = exports.extractConnection = exports.detectPaginationVariables = exports.replaceFileExtension = exports.extractFileExtension = exports.extractFileName = exports.generateDateSubdirectories = exports.generateFilePath = exports.generateTimestampedFileName = exports.generateFileName = exports.validateGraphQLPayload = exports.validateFluentEvent = exports.parseWebhookRequest = exports.detectFileType = exports.parseAndValidateCsv = exports.DataSourceType = exports.Intermediate = exports.SchemaValidationService = exports.SignatureAlgorithm = exports.WebhookValidationError = exports.WebhookValidationFactory = exports.WebhookValidationService = exports.VersoriIndexedFileTracker = exports.VersoriKVAdapter = exports.VersoriFileTracker = exports.FluentVersoriClient = exports.FluentClient = exports.isDirectContext = exports.isHttpContext = exports.createClient = void 0;
-exports.VERSION = exports.S3ServiceError = exports.S3Service = exports.FluentConnectionTester = exports.S3ComparisonTester = exports.S3PresignedTester = exports.S3SDKTester = exports.ProcessingStatus = exports.ValidationMode = exports.AwsRegion = exports.EntityType = exports.BatchAction = exports.FileType = exports.JobStrategy = exports.FileEncoding = exports.CsvDelimiter = exports.ResolverError = exports.MappingError = exports.GraphQLTemplateGenerator = exports.GraphQLIntrospectionService = exports.formatErrorSummary = exports.getSuccessfulMutations = exports.getFailedMutations = exports.getErrorMessage = exports.parseAliasedMutationResponse = exports.inferInputTypeName = exports.buildAliasedMutationQuery = exports.buildMutationQuery = exports.GraphQLMutationMapper = exports.createResolverBuilder = exports.ResolverBuilder = exports.getSdkResolverNames = exports.isSdkResolver = exports.getSdkResolver = exports.sdkResolvers = exports.UniversalMapper = exports.UniversalPathResolver = exports.JSONBuilder = exports.CSVBuilder = void 0;
+exports.JSONParserService = exports.XMLParserService = exports.ParquetParserService = exports.CSVParserService = exports.classifyErrors = exports.classifyError = exports.IngestionErrorFactory = exports.AggregateIngestionError = exports.ConfigurationError = exports.resolveProfileBaseDir = exports.getFluentProfileInfo = exports.listFluentProfiles = exports.loadFluentProfile = exports.VersoriConnectionAdapter = exports.AuthManager = exports.BearerTokenAuthProvider = exports.OAuth2AuthProvider = exports.buildPaginationVariables = exports.hasMorePages = exports.extractCursor = exports.extractConnection = exports.detectPaginationVariables = exports.replaceFileExtension = exports.extractFileExtension = exports.extractFileName = exports.generateDateSubdirectories = exports.generateFilePath = exports.generateTimestampedFileName = exports.generateFileName = exports.validateGraphQLPayload = exports.validateFluentEvent = exports.parseWebhookRequest = exports.detectFileType = exports.parseAndValidateCsv = exports.DataSourceType = exports.Intermediate = exports.SchemaValidationService = exports.SignatureAlgorithm = exports.WebhookValidationError = exports.WebhookValidationFactory = exports.WebhookValidationService = exports.VersoriIndexedFileTracker = exports.VersoriKVAdapter = exports.VersoriFileTracker = exports.FluentVersoriClient = exports.FluentClient = exports.isDirectContext = exports.isHttpContext = exports.createClientFromProfile = exports.createClient = void 0;
+exports.VERSION = exports.S3ServiceError = exports.S3Service = exports.FluentConnectionTester = exports.S3ComparisonTester = exports.S3PresignedTester = exports.S3SDKTester = exports.ProcessingStatus = exports.ValidationMode = exports.AwsRegion = exports.EntityType = exports.BatchAction = exports.FileType = exports.JobStrategy = exports.FileEncoding = exports.CsvDelimiter = exports.ResolverError = exports.MappingError = exports.GraphQLTemplateGenerator = exports.GraphQLIntrospectionService = exports.formatErrorSummary = exports.getSuccessfulMutations = exports.getFailedMutations = exports.getErrorMessage = exports.parseAliasedMutationResponse = exports.inferInputTypeName = exports.buildAliasedMutationQuery = exports.buildMutationQuery = exports.GraphQLMutationMapper = exports.createResolverBuilder = exports.ResolverBuilder = exports.getSdkResolverNames = exports.isSdkResolver = exports.getSdkResolver = exports.sdkResolvers = exports.UniversalMapper = exports.UniversalPathResolver = exports.JSONBuilder = exports.CSVBuilder = exports.XMLBuilder = exports.detectParserFileType = exports.isParserSupported = exports.getSupportedParserTypes = exports.createParser = void 0;
 var client_factory_1 = require("./client-factory");
 Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_factory_1.createClient; } });
+Object.defineProperty(exports, "createClientFromProfile", { enumerable: true, get: function () { return client_factory_1.createClientFromProfile; } });
 Object.defineProperty(exports, "isHttpContext", { enumerable: true, get: function () { return client_factory_1.isHttpContext; } });
 Object.defineProperty(exports, "isDirectContext", { enumerable: true, get: function () { return client_factory_1.isDirectContext; } });
 var fluent_client_1 = require("./clients/fluent-client");
@@ -66,6 +67,11 @@ Object.defineProperty(exports, "OAuth2AuthProvider", { enumerable: true, get: fu
 Object.defineProperty(exports, "BearerTokenAuthProvider", { enumerable: true, get: function () { return auth_provider_1.BearerTokenAuthProvider; } });
 Object.defineProperty(exports, "AuthManager", { enumerable: true, get: function () { return auth_provider_1.AuthManager; } });
 Object.defineProperty(exports, "VersoriConnectionAdapter", { enumerable: true, get: function () { return auth_provider_1.VersoriConnectionAdapter; } });
+var profile_loader_1 = require("./auth/profile-loader");
+Object.defineProperty(exports, "loadFluentProfile", { enumerable: true, get: function () { return profile_loader_1.loadFluentProfile; } });
+Object.defineProperty(exports, "listFluentProfiles", { enumerable: true, get: function () { return profile_loader_1.listFluentProfiles; } });
+Object.defineProperty(exports, "getFluentProfileInfo", { enumerable: true, get: function () { return profile_loader_1.getFluentProfileInfo; } });
+Object.defineProperty(exports, "resolveProfileBaseDir", { enumerable: true, get: function () { return profile_loader_1.resolveProfileBaseDir; } });
 __exportStar(require("./errors/index"), exports);
 var ingestion_errors_1 = require("./errors/ingestion-errors");
 Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return ingestion_errors_1.ConfigurationError; } });

package/dist/cjs/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/dist/esm/auth/index.d.ts

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

package/dist/esm/auth/index.js

@@ -0,0 +1,2 @@
+export { loadFluentProfile, listFluentProfiles, getFluentProfileInfo, resolveProfileBaseDir, } from './profile-loader.js';
+export { OAuth2AuthProvider, BearerTokenAuthProvider, AuthManager, VersoriConnectionAdapter, } from './auth-provider.js';

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

@@ -0,0 +1,18 @@
+import { FluentClientConfig } from '../types/index.js';
+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/esm/auth/profile-loader.js

@@ -0,0 +1,169 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+export function resolveProfileBaseDir(options) {
+    if (options?.profileDir) {
+        return options.profileDir;
+    }
+    const envDir = process.env.FLUENT_PROFILE_DIR;
+    if (envDir) {
+        return envDir;
+    }
+    return path.join(os.homedir(), '.fluentcommerce');
+}
+export function loadFluentProfile(profileName, options) {
+    if (!profileName || typeof profileName !== 'string') {
+        throw new Error('Profile name is required');
+    }
+    const baseDir = resolveProfileBaseDir(options);
+    const profileDir = path.join(baseDir, profileName);
+    if (!fs.existsSync(profileDir)) {
+        const available = listFluentProfiles(options);
+        throw new Error(`Fluent CLI profile '${profileName}' not found at ${profileDir}. ` +
+            (available.length > 0
+                ? `Available profiles: ${available.join(', ')}`
+                : `No profiles found in ${baseDir}. Create one with: fluent profile create ${profileName}`));
+    }
+    const profileJsonPath = path.join(profileDir, 'profile.json');
+    if (!fs.existsSync(profileJsonPath)) {
+        throw new Error(`profile.json not found in ${profileDir}. ` +
+            `This directory may not be a valid Fluent CLI profile.`);
+    }
+    let profile;
+    try {
+        const raw = fs.readFileSync(profileJsonPath, 'utf-8');
+        profile = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to read ${profileJsonPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!profile.baseUrl) {
+        throw new Error(`Profile '${profileName}' is missing required field 'baseUrl' in profile.json`);
+    }
+    if (!profile.id) {
+        throw new Error(`Profile '${profileName}' is missing required field 'id' in profile.json`);
+    }
+    if (!profile.clientSecret) {
+        throw new Error(`Profile '${profileName}' is missing required field 'clientSecret' in profile.json`);
+    }
+    if (!profile.user) {
+        throw new Error(`Profile '${profileName}' is missing required field 'user' in profile.json`);
+    }
+    let retailerId;
+    let resolvedUser = profile.user;
+    if (options?.retailer) {
+        const retailerJsonPath = path.join(profileDir, `retailer.${options.retailer}.json`);
+        if (!fs.existsSync(retailerJsonPath)) {
+            const availableRetailers = listProfileRetailers(profileDir);
+            throw new Error(`Retailer '${options.retailer}' not found for profile '${profileName}' at ${retailerJsonPath}. ` +
+                (availableRetailers.length > 0
+                    ? `Available retailers: ${availableRetailers.join(', ')}`
+                    : `No retailer files found in ${profileDir}.`));
+        }
+        let retailer;
+        try {
+            const raw = fs.readFileSync(retailerJsonPath, 'utf-8');
+            retailer = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`Failed to read ${retailerJsonPath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        retailerId = retailer.id;
+        if (retailer.user) {
+            resolvedUser = retailer.user;
+        }
+    }
+    const userJsonPath = path.join(profileDir, `user.${resolvedUser}.json`);
+    if (!fs.existsSync(userJsonPath)) {
+        throw new Error(`User credentials file not found: ${userJsonPath}. ` +
+            `Expected file for user '${resolvedUser}'` +
+            (options?.retailer
+                ? ` (set by retailer '${options.retailer}').`
+                : ` (set in profile.json).`));
+    }
+    let userCreds;
+    try {
+        const raw = fs.readFileSync(userJsonPath, 'utf-8');
+        userCreds = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to read ${userJsonPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!userCreds.username || !userCreds.password) {
+        throw new Error(`User credentials file ${userJsonPath} is missing 'username' or 'password' field`);
+    }
+    const config = {
+        baseUrl: profile.baseUrl,
+        clientId: profile.id,
+        clientSecret: profile.clientSecret,
+        username: userCreds.username,
+        password: userCreds.password,
+    };
+    if (retailerId) {
+        config.retailerId = retailerId;
+    }
+    if (options?.timeout) {
+        config.timeout = options.timeout;
+    }
+    if (options?.retryConfig) {
+        config.retryConfig = options.retryConfig;
+    }
+    return config;
+}
+export function listFluentProfiles(options) {
+    const baseDir = resolveProfileBaseDir(options);
+    if (!fs.existsSync(baseDir)) {
+        return [];
+    }
+    try {
+        const entries = fs.readdirSync(baseDir, { withFileTypes: true });
+        return entries
+            .filter(entry => {
+            if (!entry.isDirectory())
+                return false;
+            if (entry.name.startsWith('.'))
+                return false;
+            const profileJson = path.join(baseDir, entry.name, 'profile.json');
+            return fs.existsSync(profileJson);
+        })
+            .map(entry => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function getFluentProfileInfo(profileName, options) {
+    const baseDir = resolveProfileBaseDir(options);
+    const profileDirPath = path.join(baseDir, profileName);
+    const profileJsonPath = path.join(profileDirPath, 'profile.json');
+    if (!fs.existsSync(profileJsonPath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(profileJsonPath, 'utf-8');
+        const profile = JSON.parse(raw);
+        return {
+            name: profileName,
+            baseUrl: profile.baseUrl,
+            accountId: profile.id,
+            username: profile.user,
+            retailers: listProfileRetailers(profileDirPath),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function listProfileRetailers(profileDirPath) {
+    try {
+        const entries = fs.readdirSync(profileDirPath);
+        return entries
+            .filter(name => name.startsWith('retailer.') && name.endsWith('.json'))
+            .map(name => name.slice('retailer.'.length, -'.json'.length))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}

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

@@ -1,6 +1,7 @@
 import { FluentClient } from './clients/fluent-client.js';
 import { FluentVersoriClient } from './versori/fluent-versori-client.js';
 import { FluentClientConfig, Logger, ExecutionContext } from './types/index.js';
+import { type FluentProfileOptions } from './auth/profile-loader.js';
 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>;