@fluentcommerce/fc-connect-sdk 0.1.48 → 0.1.52

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

@@ -80,8 +80,9 @@ export class FluentVersoriClient {
         });
         const paginationVars = detectPaginationVariables(payload.query);
         const paginationEnabled = !isMutation && (payload.pagination?.enabled ?? paginationVars.hasPagination);
+        const errorHandling = payload.errorHandling ?? 'throw';
         if (!paginationEnabled) {
-            return this.executeSinglePage(payload);
+            return this.executeSinglePage(payload, errorHandling);
         }
         const direction = payload.pagination?.direction ??
             paginationVars.direction ??
@@ -97,10 +98,11 @@ export class FluentVersoriClient {
             abortSignal: payload.pagination?.abortSignal,
             onProgress: payload.pagination?.onProgress ?? (() => { }),
             onWarning: payload.pagination?.onWarning ?? ((msg) => this.ctx.log?.warn?.(msg)),
+            errorHandling,
         };
         return this.executeWithAutoPagination(payload, paginationVars, config);
     }
-    async executeSinglePage(payload) {
+    async executeSinglePage(payload, errorHandling = 'throw') {
         const operationName = payload.operationName || 'unnamed';
         try {
             const apiPayload = {
@@ -139,6 +141,18 @@ export class FluentVersoriClient {
                 throw new Error('Failed to parse GraphQL response');
             }
             if (parsedResponse.errors && parsedResponse.errors.length > 0) {
+                if (errorHandling === 'partial') {
+                    this.ctx.log.warn(`[fc-connect-sdk:graphql] GraphQL operation "${operationName}" returned partial data with ${parsedResponse.errors.length} error(s)`, {
+                        operationName,
+                        errors: parsedResponse.errors,
+                        errorCount: parsedResponse.errors.length,
+                        hasData: !!parsedResponse.data,
+                    });
+                    return {
+                        ...parsedResponse,
+                        hasPartialData: true,
+                    };
+                }
                 this.ctx.log.error(`[fc-connect-sdk:graphql] GraphQL operation "${operationName}" returned ${parsedResponse.errors.length} error(s)`, {
                     operationName,
                     errors: parsedResponse.errors,
@@ -175,6 +189,7 @@ export class FluentVersoriClient {
         let currentVariables = { ...(payload.variables || {}) };
         let lastCursor = null;
         let emptyPageCount = 0;
+        const accumulatedErrors = [];
         while (true) {
             if (config.abortSignal?.aborted) {
                 truncated = true;
@@ -197,17 +212,29 @@ export class FluentVersoriClient {
             const response = await this.executeSinglePage({
                 query: payload.query,
                 variables: currentVariables,
-            });
+            }, 'partial');
             lastExtensions = response.extensions;
             if (response.errors && response.errors.length > 0) {
-                this.ctx.log.error(`[fc-connect-sdk:pagination] GraphQL errors during pagination (page ${pageNumber + 1}, ${totalRecords} records fetched so far)`, {
-                    errors: response.errors,
-                    pagesCompleted: pageNumber,
-                    totalRecordsBeforeError: totalRecords,
-                    errorCount: response.errors.length,
-                });
-                const firstError = response.errors[0];
-                throw new GraphQLExecutionError(`GraphQL error during pagination (page ${pageNumber}): ${firstError.message || 'Unknown error'}`, response.errors, payload.query, currentVariables);
+                if (config.errorHandling === 'partial') {
+                    this.ctx.log.warn(`[fc-connect-sdk:pagination] Page ${pageNumber + 1} returned partial data with ${response.errors.length} error(s)`, {
+                        errors: response.errors,
+                        pagesCompleted: pageNumber,
+                        totalRecordsSoFar: totalRecords,
+                        errorCount: response.errors.length,
+                        hasData: !!response.data,
+                    });
+                    accumulatedErrors.push(...response.errors);
+                }
+                else {
+                    this.ctx.log.error(`[fc-connect-sdk:pagination] GraphQL errors during pagination (page ${pageNumber + 1}, ${totalRecords} records fetched so far)`, {
+                        errors: response.errors,
+                        pagesCompleted: pageNumber,
+                        totalRecordsBeforeError: totalRecords,
+                        errorCount: response.errors.length,
+                    });
+                    const firstError = response.errors[0];
+                    throw new GraphQLExecutionError(`GraphQL error during pagination (page ${pageNumber}): ${firstError.message || 'Unknown error'}`, response.errors, payload.query, currentVariables);
+                }
             }
             pageNumber++;
             const connection = extractConnection(response.data, config.connectionPath);
@@ -310,14 +337,17 @@ export class FluentVersoriClient {
                 await new Promise(resolve => setTimeout(resolve, config.delayMs));
             }
         }
-        this.ctx.log?.info?.(`[fc-connect-sdk:pagination] Pagination complete (${pageNumber} pages, ${totalRecords} records${truncated ? `, truncated: ${truncationReason}` : ''})`, {
+        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` : ''})`, {
             totalPages: pageNumber,
             totalRecords,
             truncated,
             truncationReason,
             duration: Date.now() - startTime,
+            hasPartialErrors,
+            errorCount: accumulatedErrors.length,
         });
-        return {
+        const response = {
             data: allData,
             extensions: {
                 ...(lastExtensions || {}),
@@ -330,6 +360,11 @@ export class FluentVersoriClient {
                 },
             },
         };
+        if (hasPartialErrors) {
+            response.errors = accumulatedErrors;
+            response.hasPartialData = true;
+        }
+        return response;
     }
     async sendEvent(event, mode = 'async') {
         this.ctx.log.info(`[fc-connect-sdk:event] Sending event "${event.name}" (${event.entityType}:${event.entityRef}, mode: ${mode})`, {
@@ -389,6 +424,79 @@ export class FluentVersoriClient {
             return { success: true, statusCode: response.status, message: text };
         }
     }
+    async getEvents(params = {}) {
+        const query = this.buildEventQueryString(params);
+        const endpoint = query ? `/api/v4.1/event?${query}` : '/api/v4.1/event';
+        this.ctx.log.info('[fc-connect-sdk:event] Searching event logs', {
+            endpoint,
+            filterCount: Object.keys(params).length,
+            hasDateRange: !!(params.from || params.to),
+            entityType: params['context.entityType'],
+            rootEntityType: params['context.rootEntityType'],
+            eventStatus: params.eventStatus,
+        });
+        const response = await this.fetchWithRetry(endpoint, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        const text = response.text;
+        if (!response.ok) {
+            this.ctx.log.error('[fc-connect-sdk:event] Failed to search events', {
+                status: response.status,
+                body: text,
+            });
+            this.throwApiError('Get events failed', response.status, text);
+        }
+        try {
+            const result = JSON.parse(text);
+            this.ctx.log.info('[fc-connect-sdk:event] Event search completed', {
+                resultCount: result.count,
+                hasMore: result.hasMore,
+                start: result.start,
+            });
+            return result;
+        }
+        catch {
+            throw new FluentAPIError('Failed to parse event log response', response.status, text);
+        }
+    }
+    async getEventById(eventId) {
+        if (!eventId) {
+            throw new FluentValidationError('eventId is required');
+        }
+        this.ctx.log.info(`[fc-connect-sdk:event] Getting event by ID: ${eventId}`, { eventId });
+        const response = await this.fetchWithRetry(`/api/v4.1/event/${eventId}`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        const text = response.text;
+        if (!response.ok) {
+            this.ctx.log.error(`[fc-connect-sdk:event] Failed to get event ${eventId}`, {
+                eventId,
+                status: response.status,
+                body: text,
+            });
+            this.throwApiError(`Get event ${eventId} failed`, response.status, text);
+        }
+        try {
+            const event = JSON.parse(text);
+            this.ctx.log.info(`[fc-connect-sdk:event] Event retrieved: ${event.name}`, {
+                eventId: event.id,
+                name: event.name,
+                type: event.type,
+                eventStatus: event.eventStatus,
+                entityType: event.context?.entityType,
+            });
+            return event;
+        }
+        catch {
+            throw new FluentAPIError('Failed to parse event response', response.status, text);
+        }
+    }
     async createJob(payload) {
         this.ctx.log.info(`[fc-connect-sdk:job] Creating job "${payload.name}"`, {
             name: payload.name,
@@ -536,6 +644,16 @@ export class FluentVersoriClient {
         const result = await this.graphql(payload);
         return result.data;
     }
+    buildEventQueryString(params) {
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null || value === '') {
+                continue;
+            }
+            searchParams.append(key, String(value));
+        }
+        return searchParams.toString();
+    }
     throwApiError(message, status, responseText) {
         if (status === 401) {
             throw new AuthenticationError(`${message}: ${responseText}`, { response: responseText });