@fluentcommerce/fc-connect-sdk 0.1.48 → 0.1.52

package/dist/types/index.d.ts

@@ -34,7 +34,7 @@ export { GraphQLTemplateGenerator } from './services/mapping/query/graphql-templ
 export { MappingError, ResolverError } from './errors';
 export type { NodeConfig, NodesConfig, FieldConfig, FieldsConfig, NodesContext, MappingContext, ResolverFunction, ResolverHelpers, ResolverContext, ResolversMap, MapResult, MapWithNodesResult, NodeValidationResult, MappingOptions, } from './services/mapping/types';
 export { CsvDelimiter, FileEncoding, JobStrategy, FileType, BatchAction, EntityType, AwsRegion, ValidationMode, ProcessingStatus, } from './types/enums';
-export type { FluentClientConfig, FluentBatchPayload, FluentInventoryBatchEntity, FluentInventoryBatchRequest, FluentBatchResponse, FluentBatchStatus, FluentJobPayload, FluentJobResponse, FluentJobMetadata, FluentJobStatus, FluentJobResults, FluentEvent, FluentEventMode, CreateEventOptions, GraphQLPayload, GraphQLResponse, PaginationConfig, PageInfo, PaginatedResponse, FluentWebhookPayload, WebhookRequestContext, GraphQLValidationResult, BatchConfiguration, DataSourceConfig, FileMetadata, Logger, StructuredLogger, LogContext, LoggerConfig, PerformanceMetrics, InventoryDataRecord, ParquetDataRecord, FieldMappingConfig, FieldMappingRule, ProcessingMetadata, AttributeValue, } from './types';
+export type { FluentClientConfig, FluentBatchPayload, FluentInventoryBatchEntity, FluentInventoryBatchRequest, FluentBatchResponse, FluentBatchStatus, FluentJobPayload, FluentJobResponse, FluentJobMetadata, FluentJobStatus, FluentJobResults, FluentEvent, FluentEventMode, CreateEventOptions, FluentEventRootEntityType, FluentEventEntityType, FluentEventCategory, FluentEventType, FluentEventStatus, FluentEventQueryParamValue, FluentEventQueryParams, FluentEventLogAttribute, FluentEventLogContext, FluentEventLogItem, FluentEventLogResponse, GraphQLPayload, GraphQLResponse, GraphQLErrorMode, GraphQLError, PaginationConfig, PageInfo, PaginatedResponse, FluentWebhookPayload, WebhookRequestContext, GraphQLValidationResult, BatchConfiguration, DataSourceConfig, FileMetadata, Logger, StructuredLogger, LogContext, LoggerConfig, PerformanceMetrics, InventoryDataRecord, ParquetDataRecord, FieldMappingConfig, FieldMappingRule, ProcessingMetadata, AttributeValue, } from './types';
 export type { VersoriContext, WebhookContext, DirectContext } from './types';
 export { S3SDKTester, S3PresignedTester, S3ComparisonTester, FluentConnectionTester, type TestResult, type FluentTestConfig, type S3TestConfig, } from './testing/index';
 export { S3Service, S3ServiceError, type S3ServiceConfig, type S3Config, type S3Object, type ListOptions, type PutOptions, type CopyOptions, type S3Location, } from './services/s3/index';

package/dist/types/services/extraction/extraction-orchestrator.d.ts

@@ -1,5 +1,5 @@
 import type { FluentClient } from '../../clients/fluent-client';
-import type { Logger } from '../../types';
+import type { Logger, GraphQLErrorMode, GraphQLError } from '../../types';
 export interface ExtractionOptions<T = any> {
     query: string;
     resultPath: string;
@@ -10,6 +10,8 @@ export interface ExtractionOptions<T = any> {
     direction?: 'forward' | 'backward';
     timeout?: number;
     validateItem?: (item: T) => boolean;
+    operationName?: string;
+    errorHandling?: GraphQLErrorMode;
 }
 export interface ExtractionStats {
     totalRecords: number;
@@ -20,6 +22,7 @@ export interface ExtractionStats {
     validRecords?: number;
     invalidRecords?: number;
     direction?: 'forward' | 'backward';
+    partialErrors?: GraphQLError[];
 }
 export interface ExtractionError {
     type: 'graphql' | 'network' | 'validation' | 'parsing';

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

@@ -95,23 +95,91 @@ export interface FluentEvent {
 export interface CreateEventOptions {
     mode?: FluentEventMode;
 }
+export type FluentEventRootEntityType = 'ORDER' | 'LOCATION' | 'FULFILMENT_OPTIONS' | 'PRODUCT_CATALOGUE' | 'INVENTORY_CATALOGUE' | 'VIRTUAL_CATALOGUE' | 'CONTROL_GROUP' | 'RETURN_ORDER' | 'BILLING_ACCOUNT' | 'JOB';
+export type FluentEventEntityType = 'ORDER' | 'FULFILMENT' | 'ARTICLE' | 'CONSIGNMENT' | 'LOCATION' | 'WAVE' | 'FULFILMENT_OPTIONS' | 'FULFILMENT_PLAN' | 'PRODUCT_CATALOGUE' | 'CATEGORY' | 'PRODUCT' | 'INVENTORY_CATALOGUE' | 'INVENTORY_POSITION' | 'INVENTORY_QUANTITY' | 'VIRTUAL_CATALOGUE' | 'VIRTUAL_POSITION' | 'CONTROL_GROUP' | 'CONTROL' | 'RETURN_ORDER' | 'RETURN_FULFILMENT' | 'BILLING_ACCOUNT' | 'CREDIT_MEMO' | 'BATCH';
+export type FluentEventCategory = 'snapshot' | 'ruleSet' | 'rule' | 'ACTION' | 'CUSTOM' | 'exception' | 'ORDER_WORKFLOW';
+export type FluentEventType = 'ORCHESTRATION' | 'ORCHESTRATION_AUDIT' | 'API' | 'INTEGRATION' | 'SECURITY' | 'GENERAL';
+export type FluentEventStatus = 'PENDING' | 'SCHEDULED' | 'NO_MATCH' | 'SUCCESS' | 'FAILED' | 'COMPLETE';
+export type FluentEventQueryParamValue = string | number | boolean;
+export interface FluentEventQueryParams {
+    start?: number;
+    count?: number;
+    from?: string;
+    to?: string;
+    name?: string;
+    category?: FluentEventCategory | string;
+    retailerId?: string | number;
+    eventType?: FluentEventType | string;
+    eventStatus?: FluentEventStatus | string;
+    eventId?: string;
+    'context.rootEntityType'?: FluentEventRootEntityType | string;
+    'context.rootEntityId'?: string | number;
+    'context.rootEntityRef'?: string;
+    'context.entityType'?: FluentEventEntityType | string;
+    'context.entityId'?: string | number;
+    'context.entityRef'?: string;
+    'context.sourceEvents'?: string;
+    [key: string]: FluentEventQueryParamValue | undefined;
+}
+export interface FluentEventLogContext {
+    sourceEvents?: string[];
+    entityType?: FluentEventEntityType | string;
+    entityId?: string;
+    entityRef?: string;
+    rootEntityType?: FluentEventRootEntityType | string;
+    rootEntityId?: string;
+    rootEntityRef?: string;
+    [key: string]: JsonValue | undefined;
+}
+export interface FluentEventLogAttribute {
+    name: string;
+    value: string;
+    type?: string;
+    [key: string]: unknown;
+}
+export interface FluentEventLogItem {
+    id: string;
+    name: string;
+    type?: FluentEventType | string;
+    accountId?: string;
+    retailerId?: string;
+    category?: FluentEventCategory | string;
+    context?: FluentEventLogContext;
+    eventStatus?: FluentEventStatus | string;
+    attributes?: FluentEventLogAttribute[] | Record<string, JsonValue> | null;
+    source?: string | null;
+    generatedBy?: string;
+    generatedOn?: string;
+    [key: string]: unknown;
+}
+export interface FluentEventLogResponse {
+    start: number;
+    count: number;
+    hasMore: boolean;
+    results: FluentEventLogItem[];
+    [key: string]: unknown;
+}
+export type GraphQLErrorMode = 'throw' | 'partial';
 export interface GraphQLPayload<T = Record<string, JsonValue>> {
     query: string;
     variables?: T;
     operationName?: string;
     pagination?: PaginationConfig;
+    errorHandling?: GraphQLErrorMode;
+}
+export interface GraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: (string | number)[];
+    extensions?: Record<string, JsonValue>;
+    [key: string]: unknown;
 }
 export interface GraphQLResponse<T = JsonValue> {
     data?: T;
-    errors?: Array<{
-        message: string;
-        locations?: Array<{
-            line: number;
-            column: number;
-        }>;
-        path?: (string | number)[];
-        extensions?: Record<string, JsonValue>;
-    }>;
+    errors?: GraphQLError[];
     extensions?: Record<string, unknown> & {
         autoPagination?: {
             totalPages: number;
@@ -121,6 +189,7 @@ export interface GraphQLResponse<T = JsonValue> {
             direction?: 'forward' | 'backward';
         };
     };
+    hasPartialData?: boolean;
 }
 export interface FluentInventoryBatchEntity {
     locationRef: string;
@@ -359,7 +428,7 @@ export interface Logger {
     debug(message: string, meta?: Record<string, unknown> | undefined): void;
     info(message: string, meta?: Record<string, unknown> | undefined): void;
     warn(message: string, meta?: Record<string, unknown> | undefined): void;
-    error(message: string, error?: Error, meta?: Record<string, unknown> | undefined): void;
+    error(message: string, errorOrMeta?: unknown, meta?: Record<string, unknown>): void;
 }
 export interface LogContext {
     [key: string]: MetadataValue;

package/dist/types/versori/fluent-versori-client.d.ts

@@ -1,4 +1,4 @@
-import type { FluentEvent, GraphQLPayload, GraphQLResponse, FluentEventMode, JsonValue, FluentBatchPayload, FluentBatchResponse, FluentBatchStatus, FluentJobPayload, FluentJobResponse, FluentJobStatus, FluentJobResults } from '../types';
+import type { FluentEvent, GraphQLPayload, GraphQLResponse, FluentEventMode, FluentEventLogResponse, FluentEventLogItem, FluentEventQueryParams, JsonValue, FluentBatchPayload, FluentBatchResponse, FluentBatchStatus, FluentJobPayload, FluentJobResponse, FluentJobStatus, FluentJobResults } from '../types';
 import type { FluentWebhookPayload, EventResponse } from '../types';
 export declare class FluentVersoriClient {
     private ctx;
@@ -13,6 +13,8 @@ export declare class FluentVersoriClient {
     private executeSinglePage;
     private executeWithAutoPagination;
     sendEvent(event: FluentEvent, mode?: FluentEventMode): Promise<EventResponse>;
+    getEvents(params?: FluentEventQueryParams): Promise<FluentEventLogResponse>;
+    getEventById(eventId: string): Promise<FluentEventLogItem>;
     createJob(payload: FluentJobPayload): Promise<FluentJobResponse>;
     sendBatch(jobId: string, payload: FluentBatchPayload): Promise<FluentBatchResponse>;
     getJobStatus(jobId: string): Promise<FluentJobStatus>;
@@ -20,6 +22,7 @@ export declare class FluentVersoriClient {
     getJobResults(jobId: string): Promise<FluentJobResults>;
     query<T = JsonValue>(queryOrPayload: string | GraphQLPayload, variables?: Record<string, any>): Promise<T | undefined>;
     mutate<T = JsonValue>(mutationOrPayload: string | GraphQLPayload, variables?: Record<string, any>): Promise<T | undefined>;
+    private buildEventQueryString;
     private throwApiError;
     private fetchWithRetry;
     validateWebhook(payload: FluentWebhookPayload, signature?: string, rawPayload?: string, publicKey?: string): Promise<boolean>;