@fluentcommerce/fc-connect-sdk 0.1.53 → 0.1.55

package/CHANGELOG.md

@@ -5,9 +5,37 @@ All notable changes to the Fluent Commerce Connect SDK will be documented in thi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.1.55] - 2026-04-02
 
-_No unreleased changes_
+### Fixed - Pagination Cursor Detection & Record Counting
+- **Root cause fix:** `detectPaginationVariables()` now uses body-based fallback detection for non-standard variable names (e.g., `$cursor` used as `after:`, `$pageSize` used as `first:`). Previously, only convention-named variables like `$after`/`$first` were detected, causing pagination to silently re-fetch page 1 repeatedly.
+- **`totalRecords` accuracy:** Both `FluentClient` and `FluentVersoriClient` now derive `totalRecords` from actual merged/deduped edges instead of raw page-count accumulation. Fixes inflated counts (e.g., reporting 1000 when actual was 529).
+- **`maxRecords` limit accuracy:** The pagination loop now checks unique record count (post-dedup) against `maxRecords`, not the raw accumulator. Prevents premature or delayed truncation.
+- Added 5 new unit tests for body-based variable detection patterns.
+- Fixed `fluent-versori-client-parity` maxRecords test to use unique edges per page.
+
+### Changed
+- Upgraded `@versori/run` from `^0.4.18` to `^0.5.10` (adds OpenTelemetry observability, connection services; no breaking changes to SDK imports).
+
+## [0.1.54] - 2026-02-20
+
+### Added - Fluent CLI Profile Integration
+- Added `createClientFromProfile(profileName, options?)` factory function to create a `FluentClient` directly from Fluent CLI profiles stored at `~/.fluentcommerce/`
+- Added `loadFluentProfile(profileName, options?)` to read CLI profile files and return a `FluentClientConfig`
+- Added `listFluentProfiles(options?)` to discover available CLI profiles
+- Added `getFluentProfileInfo(profileName, options?)` to inspect profile metadata without loading credentials
+- Supports full retailer loading chain: `profile.json` -> `retailer.<REF>.json` -> `user.<name>.json`
+  - When `options.retailer` is specified, reads the retailer file to get `retailerId` and the retailer-specific user override
+  - Ensures correct credentials are loaded for multi-retailer accounts (e.g., different users per retailer)
+- Profile directory resolution: `options.profileDir` > `FLUENT_PROFILE_DIR` env var > `~/.fluentcommerce/`
+- New types exported: `FluentProfileOptions`, `FluentProfileInfo`
+- Skips hidden/internal directories (e.g., `.sessions`) when listing profiles
+
+### Fixed - Fluent CLI Profile Integration Test Stability
+- Unit tests use real temporary filesystem fixtures instead of platform-sensitive path mocks for cross-platform reliability.
+
+### Added - Fluent CLI Profile Integration Documentation
+- README section with usage examples for `createClientFromProfile()` and `listFluentProfiles()`, including multi-retailer behavior.
 
 ## [0.1.53] - 2026-02-15
 

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
@@ -1668,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/clients/fluent-client.js

@@ -250,9 +250,12 @@ class FluentClient {
             else {
                 emptyPageCount = 0;
             }
+            const mergedConnection = (0, pagination_helpers_1.extractConnection)(allData, config.connectionPath);
+            const uniqueRecords = mergedConnection ? mergedConnection.edges.length : totalRecords;
             this.log('debug', `[FluentClient:pagination] Page ${pageNumber} fetched`, {
                 edgesInPage: connection.edges.length,
-                totalRecords,
+                uniqueRecords,
+                rawRecordsFetched: totalRecords,
                 hasMore: (0, pagination_helpers_1.hasMorePages)(connection.pageInfo, config.direction),
                 emptyPageCount,
             });
@@ -262,13 +265,13 @@ class FluentClient {
                 config.onWarning(`Pagination stopped: maxPages (${config.maxPages}) reached`);
                 break;
             }
-            if (totalRecords >= config.maxRecords) {
+            if (uniqueRecords >= config.maxRecords) {
                 truncated = true;
                 truncationReason = 'maxRecords';
                 config.onWarning(`Pagination stopped: maxRecords (${config.maxRecords}) reached`);
                 break;
             }
-            config.onProgress(pageNumber, totalRecords);
+            config.onProgress(pageNumber, uniqueRecords);
             if (!(0, pagination_helpers_1.hasMorePages)(connection.pageInfo, config.direction)) {
                 this.log('debug', '[FluentClient:pagination] No more pages, stopping');
                 break;
@@ -289,9 +292,13 @@ class FluentClient {
             }
         }
         const hasPartialErrors = accumulatedErrors.length > 0;
-        this.log('info', `[FluentClient:pagination] Pagination complete (${pageNumber} pages, ${totalRecords} records${truncated ? `, truncated: ${truncationReason}` : ''}${hasPartialErrors ? `, ${accumulatedErrors.length} errors` : ''})`, {
+        const finalConnection = (0, pagination_helpers_1.extractConnection)(allData, config.connectionPath);
+        const actualTotalRecords = finalConnection ? finalConnection.edges.length : totalRecords;
+        this.log('info', `[FluentClient:pagination] Pagination complete (${pageNumber} pages, ${actualTotalRecords} records${totalRecords !== actualTotalRecords ? ` (${totalRecords} raw, ${totalRecords - actualTotalRecords} duplicates removed)` : ''}${truncated ? `, truncated: ${truncationReason}` : ''}${hasPartialErrors ? `, ${accumulatedErrors.length} errors` : ''})`, {
             totalPages: pageNumber,
-            totalRecords,
+            totalRecords: actualTotalRecords,
+            rawRecordsFetched: totalRecords,
+            duplicatesRemoved: totalRecords - actualTotalRecords,
             truncated,
             truncationReason,
             duration: Date.now() - startTime,
@@ -304,7 +311,7 @@ class FluentClient {
                 ...(lastExtensions || {}),
                 autoPagination: {
                     totalPages: pageNumber,
-                    totalRecords,
+                    totalRecords: actualTotalRecords,
                     truncated,
                     truncationReason,
                     direction: config.direction,

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/utils/pagination-helpers.js

@@ -32,8 +32,44 @@ function detectPaginationVariables(query) {
         variableNames.last = lastMatch[1];
     if (beforeMatch)
         variableNames.before = beforeMatch[1];
-    const hasForward = !!firstMatch || !!afterMatch;
-    const hasBackward = !!lastMatch || !!beforeMatch;
+    if (!variableNames.after) {
+        const afterUsage = normalized.match(/after\s*:\s*\$(\w+)/);
+        if (afterUsage) {
+            const varName = afterUsage[1];
+            if (varDeclarations.includes(`$${varName}`)) {
+                variableNames.after = varName;
+            }
+        }
+    }
+    if (!variableNames.before) {
+        const beforeUsage = normalized.match(/before\s*:\s*\$(\w+)/);
+        if (beforeUsage) {
+            const varName = beforeUsage[1];
+            if (varDeclarations.includes(`$${varName}`)) {
+                variableNames.before = varName;
+            }
+        }
+    }
+    if (!variableNames.first) {
+        const firstUsage = normalized.match(/first\s*:\s*\$(\w+)/);
+        if (firstUsage) {
+            const varName = firstUsage[1];
+            if (varDeclarations.includes(`$${varName}`)) {
+                variableNames.first = varName;
+            }
+        }
+    }
+    if (!variableNames.last) {
+        const lastUsage = normalized.match(/last\s*:\s*\$(\w+)/);
+        if (lastUsage) {
+            const varName = lastUsage[1];
+            if (varDeclarations.includes(`$${varName}`)) {
+                variableNames.last = varName;
+            }
+        }
+    }
+    const hasForward = !!variableNames.first || !!variableNames.after;
+    const hasBackward = !!variableNames.last || !!variableNames.before;
     let direction = 'none';
     if (hasForward && !hasBackward) {
         direction = 'forward';

package/dist/cjs/versori/fluent-versori-client.js

@@ -308,19 +308,21 @@ class FluentVersoriClient {
             else {
                 emptyPageCount = 0;
             }
+            const mergedConnection = (0, pagination_helpers_1.extractConnection)(allData, config.connectionPath);
+            const uniqueRecords = mergedConnection ? mergedConnection.edges.length : totalRecords;
             if (pageNumber >= config.maxPages) {
                 truncated = true;
                 truncationReason = 'maxPages';
                 config.onWarning(`Pagination stopped: maxPages (${config.maxPages}) reached`);
                 break;
             }
-            if (totalRecords >= config.maxRecords) {
+            if (uniqueRecords >= config.maxRecords) {
                 truncated = true;
                 truncationReason = 'maxRecords';
                 config.onWarning(`Pagination stopped: maxRecords (${config.maxRecords}) reached`);
                 break;
             }
-            config.onProgress(pageNumber, totalRecords);
+            config.onProgress(pageNumber, uniqueRecords);
             if (!(0, pagination_helpers_1.hasMorePages)(connection.pageInfo, config.direction)) {
                 this.ctx.log?.debug?.('[fc-connect-sdk:pagination] No more pages, stopping');
                 break;
@@ -341,9 +343,13 @@ class FluentVersoriClient {
             }
         }
         const hasPartialErrors = accumulatedErrors.length > 0;
-        this.ctx.log?.info?.(`[fc-connect-sdk:pagination] Pagination complete (${pageNumber} pages, ${totalRecords} records${truncated ? `, truncated: ${truncationReason}` : ''}${hasPartialErrors ? `, ${accumulatedErrors.length} errors` : ''})`, {
+        const finalConnection = (0, pagination_helpers_1.extractConnection)(allData, config.connectionPath);
+        const actualTotalRecords = finalConnection ? finalConnection.edges.length : totalRecords;
+        this.ctx.log?.info?.(`[fc-connect-sdk:pagination] Pagination complete (${pageNumber} pages, ${actualTotalRecords} records${totalRecords !== actualTotalRecords ? ` (${totalRecords} raw, ${totalRecords - actualTotalRecords} duplicates removed)` : ''}${truncated ? `, truncated: ${truncationReason}` : ''}${hasPartialErrors ? `, ${accumulatedErrors.length} errors` : ''})`, {
             totalPages: pageNumber,
-            totalRecords,
+            totalRecords: actualTotalRecords,
+            rawRecordsFetched: totalRecords,
+            duplicatesRemoved: totalRecords - actualTotalRecords,
             truncated,
             truncationReason,
             duration: Date.now() - startTime,
@@ -356,7 +362,7 @@ class FluentVersoriClient {
                 ...(lastExtensions || {}),
                 autoPagination: {
                     totalPages: pageNumber,
-                    totalRecords,
+                    totalRecords: actualTotalRecords,
                     truncated,
                     truncationReason,
                     direction: config.direction,

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;