@faststore/api 2.2.42 → 2.2.44

package/dist/esm/src/platforms/vtex/utils/slugify.js

@@ -0,0 +1,39 @@
+/**
+ * VTEX catalog slugify function
+ *
+ * Copied from:
+ * https://github.com/vtex/rewriter/blob/1ce2010783e0586cab42534ce2fb7a983d8a3a84/node/clients/catalog.ts#L72
+ *
+ * Sometimes, we need to slugify strings for creating urls. An example is the
+ * brand urls, where we create them from the brand's name.
+ * This slugify function should match exactly what VTEX catalog generates. Any mismatch
+ * will lead to broken links.
+ * Hopefully, we had this function implemented on VTEX IO and we've been using it for
+ * years now. However, looking at the code, I think we can save lots of computing. I'm
+ * in a hurry for doing these tests now, so I'll leave a small TODO.
+ *
+ * TODO: Research for better ways of computing this slugify function. Things I'd try are:
+ * - Join those 3 regexs for special characters into a single one.
+ * - Replace the regexp of `removeDiacritics` function with a Map. We can make the complexity
+ * of this function be O(n) with n=string.length
+ *
+ */
+const from = 'ÁÄÂÀÃÅČÇĆĎÉĚËÈÊẼĔȆÍÌÎÏŇÑÓÖÒÔÕØŘŔŠŤÚŮÜÙÛÝŸŽáäâàãåčçćďéěëèêẽĕȇíìîïňñóöòôõøðřŕšťúůüùûýÿžþÞĐđßÆa';
+const to = 'AAAAAACCCDEEEEEEEEIIIINNOOOOOORRSTUUUUUYYZaaaaaacccdeeeeeeeeiiiinnooooooorrstuuuuuyyzbBDdBAa';
+const removeDiacritics = (str) => {
+    let newStr = str.slice(0);
+    for (let i = 0; i < from.length; i++) {
+        newStr = newStr.replace(new RegExp(from.charAt(i), 'g'), to.charAt(i));
+    }
+    return newStr;
+};
+const slugifySpecialCharacters = (str) => {
+    return str.replace(/[·/_,:]/, '-');
+};
+export function slugify(str) {
+    const noCommas = str.replace(/,/g, '');
+    const replaced = noCommas.replace(/[*+~.()'"!:@&\[\]`/ %$#?{}|><=_^]/g, '-');
+    const slugified = slugifySpecialCharacters(removeDiacritics(replaced));
+    return slugified.toLowerCase();
+}
+//# sourceMappingURL=slugify.js.map

package/dist/esm/src/platforms/vtex/utils/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../../../../../src/platforms/vtex/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,IAAI,GACR,8FAA8F,CAAA;AAEhG,MAAM,EAAE,GACN,8FAA8F,CAAA;AAEhG,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE;IACvC,IAAI,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,wBAAwB,GAAG,CAAC,GAAW,EAAE,EAAE;IAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAA;IAC5E,MAAM,SAAS,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEtE,OAAO,SAAS,CAAC,WAAW,EAAE,CAAA;AAChC,CAAC"}

package/dist/esm/src/platforms/vtex/utils/sort.d.ts

@@ -0,0 +1,10 @@
+export declare const SORT_MAP: {
+    readonly price_desc: "price:desc";
+    readonly price_asc: "price:asc";
+    readonly orders_desc: "orders:desc";
+    readonly name_desc: "name:desc";
+    readonly name_asc: "name:asc";
+    readonly release_desc: "release:desc";
+    readonly discount_desc: "discount:desc";
+    readonly score_desc: "";
+};

package/dist/esm/src/platforms/vtex/utils/sort.js

@@ -0,0 +1,11 @@
+export const SORT_MAP = {
+    price_desc: 'price:desc',
+    price_asc: 'price:asc',
+    orders_desc: 'orders:desc',
+    name_desc: 'name:desc',
+    name_asc: 'name:asc',
+    release_desc: 'release:desc',
+    discount_desc: 'discount:desc',
+    score_desc: '',
+};
+//# sourceMappingURL=sort.js.map

package/dist/esm/src/platforms/vtex/utils/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../../../../../src/platforms/vtex/utils/sort.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,EAAE;CACN,CAAA"}

package/dist/esm/src/telemetry/index.d.ts

@@ -0,0 +1,8 @@
+import type { Options } from '../';
+export type GetTelemetryOptions = {
+    mode?: 'verbose' | 'dev';
+    experimentalSendLogs?: boolean;
+};
+export declare function getTelemetry(APIOptions: Options, telemetryOptions?: GetTelemetryOptions): {
+    useFaststoreTelemetry: () => import("@envelop/types").Plugin<import("./useFaststoreTelemetry").PluginContext>;
+};

package/dist/esm/src/telemetry/index.js

@@ -0,0 +1,72 @@
+import { BasicTracerProvider, SimpleSpanProcessor, ConsoleSpanExporter, } from '@opentelemetry/sdk-trace-base';
+import { Resource } from '@opentelemetry/resources';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
+import { LoggerProvider, SimpleLogRecordProcessor, ConsoleLogRecordExporter, } from '@opentelemetry/sdk-logs';
+import { OTLPLogsExporter } from '@opentelemetry/exporter-logs-otlp-grpc';
+import { getFaststoreTelemetryPlugin } from './useFaststoreTelemetry';
+import packageJson from '../../package.json';
+const FASTSTORE_API_VERSION = packageJson.version;
+// TODO: These urls are hardcoded for now, but they should be configurable via ENV variables
+// They are only acessible from within the VTEX network, so they are not a security risk
+const TRACE_COLLECTOR_URL = 'opentelemetry-collector.vtex.systems';
+const TRACE_COLLECTOR_URL_DEV = 'opentelemetry-collector-beta.vtex.systems';
+const LOG_COLLECTOR_URL = 'opentelemetry-collector.vtex.systems';
+export function getTelemetry(APIOptions, telemetryOptions) {
+    const honeycombCollectorOptions = {
+        url: telemetryOptions?.mode === 'dev'
+            ? TRACE_COLLECTOR_URL_DEV
+            : TRACE_COLLECTOR_URL,
+    };
+    const openSearchCollectorOptions = {
+        url: LOG_COLLECTOR_URL,
+    };
+    // Create a new tracer provider
+    const tracerProvider = new BasicTracerProvider({
+        resource: new Resource({
+            'service.name': 'faststore-api',
+            'service.version': FASTSTORE_API_VERSION,
+            'service.name_and_version': `faststore-api@${FASTSTORE_API_VERSION}`,
+            platform: APIOptions.platform,
+            [`${APIOptions.platform}.account`]: APIOptions.account,
+            [`${APIOptions.platform}.environment`]: APIOptions.environment,
+            // TODO: include the following properties in the logs
+            // [`${APIOptions.platform}.options.hideUnavailableItems`]:
+            //   APIOptions.hideUnavailableItems,
+            // [`${APIOptions.platform}.flags.enableOrderFormSync`]:
+            //   APIOptions.flags?.enableOrderFormSync,
+            // channel: APIOptions.channel,
+            locale: APIOptions.locale,
+        }),
+    });
+    const loggerProvider = new LoggerProvider();
+    // Create trace exporter
+    const honeycombExporter = new OTLPTraceExporter(honeycombCollectorOptions);
+    // Create log exporter
+    const openSearchExporter = new OTLPLogsExporter(openSearchCollectorOptions);
+    // Set up a span processor to export spans to Honeycomb
+    const honeyCombSpanProcessor = new SimpleSpanProcessor(honeycombExporter);
+    // Set up a log record processor to export spans to OpenSearch
+    const openSearchLogProcessor = new SimpleLogRecordProcessor(openSearchExporter);
+    // Register the span processor with the tracer provider
+    tracerProvider.addSpanProcessor(honeyCombSpanProcessor);
+    // Register the log record processor with the log provider
+    loggerProvider.addLogRecordProcessor(openSearchLogProcessor);
+    if (telemetryOptions?.mode === 'verbose' ||
+        telemetryOptions?.mode === 'dev') {
+        // Set up a console exporter for verbose mode
+        const consoleExporter = new ConsoleSpanExporter();
+        const verboseTraceProcessor = new SimpleSpanProcessor(consoleExporter);
+        // Set up processors for verbose mode
+        const consoleLogExporter = new ConsoleLogRecordExporter();
+        const veboseLogRecordExporter = new SimpleLogRecordProcessor(consoleLogExporter);
+        tracerProvider.addSpanProcessor(verboseTraceProcessor);
+        loggerProvider.addLogRecordProcessor(veboseLogRecordExporter);
+    }
+    const useFaststoreTelemetry = getFaststoreTelemetryPlugin(
+    // The @opentelemetry/sdk-trace-base was renamed from @opentelemetry/tracing but the
+    // envelop plugin doesn't support this change yet. This causes the class type to be incompatible,
+    // even if they are the same. https://github.com/n1ru4l/envelop/issues/1610
+    tracerProvider, loggerProvider, 'faststore-api', telemetryOptions?.experimentalSendLogs ?? false);
+    return { useFaststoreTelemetry };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/src/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAC3E,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAGzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,WAAW,MAAM,oBAAoB,CAAA;AAO5C,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAA;AAEjD,4FAA4F;AAC5F,wFAAwF;AACxF,MAAM,mBAAmB,GAAG,sCAAsC,CAAA;AAClE,MAAM,uBAAuB,GAAG,2CAA2C,CAAA;AAC3E,MAAM,iBAAiB,GAAG,sCAAsC,CAAA;AAEhE,MAAM,UAAU,YAAY,CAC1B,UAAmB,EACnB,gBAAsC;IAEtC,MAAM,yBAAyB,GAAG;QAChC,GAAG,EACD,gBAAgB,EAAE,IAAI,KAAK,KAAK;YAC9B,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,mBAAmB;KAC1B,CAAA;IAED,MAAM,0BAA0B,GAAG;QACjC,GAAG,EAAE,iBAAiB;KACvB,CAAA;IAED,+BAA+B;IAC/B,MAAM,cAAc,GAAG,IAAI,mBAAmB,CAAC;QAC7C,QAAQ,EAAE,IAAI,QAAQ,CAAC;YACrB,cAAc,EAAE,eAAe;YAC/B,iBAAiB,EAAE,qBAAqB;YACxC,0BAA0B,EAAE,iBAAiB,qBAAqB,EAAE;YACpE,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,CAAC,GAAG,UAAU,CAAC,QAAQ,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO;YACtD,CAAC,GAAG,UAAU,CAAC,QAAQ,cAAc,CAAC,EAAE,UAAU,CAAC,WAAW;YAC9D,qDAAqD;YACrD,2DAA2D;YAC3D,qCAAqC;YACrC,wDAAwD;YACxD,2CAA2C;YAC3C,+BAA+B;YAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC;KACH,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAA;IAE3C,wBAAwB;IACxB,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,yBAAyB,CAAC,CAAA;IAE1E,sBAAsB;IACtB,MAAM,kBAAkB,GAAG,IAAI,gBAAgB,CAAC,0BAA0B,CAAC,CAAA;IAE3E,uDAAuD;IACvD,MAAM,sBAAsB,GAAG,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;IAEzE,8DAA8D;IAC9D,MAAM,sBAAsB,GAAG,IAAI,wBAAwB,CACzD,kBAAkB,CACnB,CAAA;IAED,uDAAuD;IACvD,cAAc,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAA;IAEvD,0DAA0D;IAC1D,cAAc,CAAC,qBAAqB,CAAC,sBAAsB,CAAC,CAAA;IAE5D,IACE,gBAAgB,EAAE,IAAI,KAAK,SAAS;QACpC,gBAAgB,EAAE,IAAI,KAAK,KAAK,EAChC,CAAC;QACD,6CAA6C;QAC7C,MAAM,eAAe,GAAG,IAAI,mBAAmB,EAAE,CAAA;QACjD,MAAM,qBAAqB,GAAG,IAAI,mBAAmB,CAAC,eAAe,CAAC,CAAA;QAEtE,qCAAqC;QACrC,MAAM,kBAAkB,GAAG,IAAI,wBAAwB,EAAE,CAAA;QACzD,MAAM,uBAAuB,GAAG,IAAI,wBAAwB,CAC1D,kBAAkB,CACnB,CAAA;QAED,cAAc,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAA;QACtD,cAAc,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,qBAAqB,GAAG,2BAA2B;IACvD,oFAAoF;IACpF,iGAAiG;IACjG,2EAA2E;IAC3E,cAAqB,EACrB,cAAc,EACd,eAAe,EACf,gBAAgB,EAAE,oBAAoB,IAAI,KAAK,CAChD,CAAA;IAED,OAAO,EAAE,qBAAqB,EAAE,CAAA;AAClC,CAAC"}

package/dist/esm/src/telemetry/useFaststoreTelemetry.d.ts

@@ -0,0 +1,24 @@
+import type { Plugin } from '@envelop/core';
+import { Span } from '@opentelemetry/api';
+import type { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';
+import type { LoggerProvider } from '@opentelemetry/sdk-logs';
+export declare enum AttributeName {
+    EXECUTION_ERROR = "graphql.error",
+    EXECUTION_RESULT = "graphql.result",
+    RESOLVER_EXECUTION_ERROR = "graphql.resolver.error",
+    RESOLVER_EXCEPTION = "graphql.resolver.exception",
+    RESOLVER_FIELD_NAME = "graphql.resolver.fieldName",
+    RESOLVER_TYPE_NAME = "graphql.resolver.typeName",
+    RESOLVER_RESULT_TYPE = "graphql.resolver.resultType",
+    RESOLVER_ARGS = "graphql.resolver.args",
+    EXECUTION_OPERATION_NAME = "graphql.operation.name",
+    EXECUTION_OPERATION_TYPE = "graphql.operation.type",
+    EXECUTION_OPERATION_DOCUMENT = "graphql.document",
+    EXECUTION_VARIABLES = "graphql.variables"
+}
+declare const tracingSpanSymbol: unique symbol;
+export type PluginContext = {
+    [tracingSpanSymbol]: Span;
+};
+export declare const getFaststoreTelemetryPlugin: (tracingProvider: BasicTracerProvider, loggerProvider: LoggerProvider, serviceName: string, experimentalSendLogs: boolean) => (() => Plugin<PluginContext>);
+export {};

package/dist/esm/src/telemetry/useFaststoreTelemetry.js

@@ -0,0 +1,170 @@
+import { isAsyncIterable } from '@envelop/core';
+import { useOnResolve } from '@envelop/on-resolve';
+import { SpanKind } from '@opentelemetry/api';
+import { trace as openTelTrace, context as openTelContext, } from '@opentelemetry/api';
+import { SeverityNumber } from '@opentelemetry/api-logs';
+import { print, Kind } from 'graphql';
+export var AttributeName;
+(function (AttributeName) {
+    AttributeName["EXECUTION_ERROR"] = "graphql.error";
+    AttributeName["EXECUTION_RESULT"] = "graphql.result";
+    AttributeName["RESOLVER_EXECUTION_ERROR"] = "graphql.resolver.error";
+    AttributeName["RESOLVER_EXCEPTION"] = "graphql.resolver.exception";
+    AttributeName["RESOLVER_FIELD_NAME"] = "graphql.resolver.fieldName";
+    AttributeName["RESOLVER_TYPE_NAME"] = "graphql.resolver.typeName";
+    AttributeName["RESOLVER_RESULT_TYPE"] = "graphql.resolver.resultType";
+    AttributeName["RESOLVER_ARGS"] = "graphql.resolver.args";
+    AttributeName["EXECUTION_OPERATION_NAME"] = "graphql.operation.name";
+    AttributeName["EXECUTION_OPERATION_TYPE"] = "graphql.operation.type";
+    AttributeName["EXECUTION_OPERATION_DOCUMENT"] = "graphql.document";
+    AttributeName["EXECUTION_VARIABLES"] = "graphql.variables";
+})(AttributeName || (AttributeName = {}));
+const tracingSpanSymbol = Symbol('OPEN_TELEMETRY_GRAPHQL');
+function getResolverSpanKey(path) {
+    const nodes = [];
+    // If the first node (after reversed, it will be the last one) is an integer, that is, identifies a list,
+    // we don't want to include it in the key. Note that this will only happen when analysing .prev paths in
+    // a list of elements. We just want to remove the initial node that is a integer, not all of them.
+    //
+    // Nodes with keys 6bc73341b2a183fc::product::image::0::url would not be able to find
+    // parents with key 6bc73341b2a183fc::product::image because of the "0" list index -
+    // it would search for 6bc73341b2a183fc::product::image::0
+    let currentPath = nodes.length === 0 && Number.isInteger(path.key) ? path.prev : path;
+    while (currentPath) {
+        nodes.push(currentPath.key);
+        currentPath = currentPath.prev;
+    }
+    return [...nodes].reverse().join('.');
+}
+export const getFaststoreTelemetryPlugin = (tracingProvider, loggerProvider, serviceName, experimentalSendLogs) => {
+    return function useFaststoreTelemetry() {
+        const tracer = tracingProvider.getTracer(serviceName);
+        const logger = loggerProvider.getLogger(serviceName);
+        const resolverContextsByRootSpans = {};
+        return {
+            onPluginInit({ addPlugin }) {
+                addPlugin(
+                // eslint-disable-next-line
+                useOnResolve(({ info, context }) => {
+                    if (context &&
+                        typeof context === 'object' &&
+                        context[tracingSpanSymbol]) {
+                        tracer.getActiveSpanProcessor();
+                        const rootContextSpanId = context[tracingSpanSymbol].spanContext().spanId;
+                        const { fieldName, returnType, parentType, path } = info;
+                        const previousResolverSpanKey = path.prev && getResolverSpanKey(path.prev);
+                        let ctx = null;
+                        if (previousResolverSpanKey &&
+                            resolverContextsByRootSpans[rootContextSpanId][previousResolverSpanKey]) {
+                            ctx =
+                                resolverContextsByRootSpans[rootContextSpanId][previousResolverSpanKey];
+                        }
+                        else {
+                            ctx = openTelTrace.setSpan(openTelContext.active(), context[tracingSpanSymbol]);
+                            resolverContextsByRootSpans[rootContextSpanId] =
+                                resolverContextsByRootSpans[rootContextSpanId] ?? {};
+                        }
+                        const resolverIndexInList = Number.isInteger(path.prev?.key)
+                            ? `[${path.prev?.key}]`
+                            : '';
+                        const resolverSpan = tracer.startSpan(`${parentType.toString()}.${fieldName}${resolverIndexInList}`, {
+                            attributes: {
+                                [AttributeName.RESOLVER_FIELD_NAME]: fieldName,
+                                [AttributeName.RESOLVER_TYPE_NAME]: parentType.toString(),
+                                [AttributeName.RESOLVER_RESULT_TYPE]: returnType.toString(),
+                                'meta.span.path': getResolverSpanKey(path),
+                            },
+                        }, ctx);
+                        const resolverCtx = openTelTrace.setSpan(ctx, resolverSpan);
+                        resolverContextsByRootSpans[rootContextSpanId][getResolverSpanKey(path)] = resolverCtx;
+                        return ({ result }) => {
+                            if (result instanceof Error) {
+                                resolverSpan.setAttributes({
+                                    error: true,
+                                    'exception.category': AttributeName.RESOLVER_EXECUTION_ERROR,
+                                    'exception.message': result.message,
+                                    'exception.type': result.name,
+                                });
+                                resolverSpan.recordException(result);
+                            }
+                            resolverSpan.end();
+                        };
+                    }
+                    return () => { };
+                }));
+            },
+            onExecute({ args, extendContext }) {
+                const operationType = args.document.definitions
+                    .filter((def) => def.kind === Kind.OPERATION_DEFINITION)
+                    .map((def) => def.operation)?.[0];
+                // Span name according to Semantic Conventions
+                // https://github.com/open-telemetry/semantic-conventions
+                let spanName = 'GraphQL Operation';
+                if (operationType && args.operationName) {
+                    spanName = `${operationType} ${args.operationName}`;
+                }
+                else if (operationType && !args.operationName) {
+                    spanName = operationType;
+                }
+                const executionSpan = tracer.startSpan(spanName, {
+                    kind: SpanKind.SERVER,
+                    attributes: {
+                        [AttributeName.EXECUTION_OPERATION_NAME]: args.operationName ?? undefined,
+                        [AttributeName.EXECUTION_OPERATION_TYPE]: operationType ?? undefined,
+                        [AttributeName.EXECUTION_OPERATION_DOCUMENT]: print(args.document),
+                    },
+                });
+                const executeContext = openTelContext.active();
+                const resultCbs = {
+                    onExecuteDone({ result }) {
+                        if (isAsyncIterable(result)) {
+                            executionSpan.end();
+                            // eslint-disable-next-line no-console
+                            console.warn(`Plugin "newrelic" encountered a AsyncIterator which is not supported yet, so tracing data is not available for the operation.`);
+                            return;
+                        }
+                        const logRecord = {
+                            context: executeContext,
+                            attributes: {
+                                'service.name': 'faststore-api',
+                                'service.version': '1.12.38',
+                                'service.name_and_version': 'faststore-api@1.12.38',
+                                'vtex.search_index': 'faststore_beta_api',
+                                [AttributeName.EXECUTION_OPERATION_NAME]: args.operationName ?? undefined,
+                                [AttributeName.EXECUTION_OPERATION_DOCUMENT]: print(args.document),
+                                [AttributeName.EXECUTION_VARIABLES]: JSON.stringify(args.variableValues ?? {}),
+                            },
+                        };
+                        if (typeof result.data !== 'undefined' &&
+                            !(result.errors && result.errors.length > 0)) {
+                            logRecord.severityNumber = SeverityNumber.INFO;
+                            logRecord.severityText = 'Info';
+                            logRecord.attributes[AttributeName.EXECUTION_RESULT] =
+                                JSON.stringify(result);
+                        }
+                        if (result.errors && result.errors.length > 0) {
+                            logRecord.severityNumber = SeverityNumber.ERROR;
+                            logRecord.severityText = 'Error';
+                            logRecord.attributes[AttributeName.EXECUTION_ERROR] =
+                                JSON.stringify(result.errors);
+                            executionSpan.setAttributes({
+                                error: true,
+                                'exception.category': AttributeName.EXECUTION_ERROR,
+                                'exception.message': JSON.stringify(result.errors),
+                            });
+                        }
+                        if (experimentalSendLogs) {
+                            logger.emit(logRecord);
+                        }
+                        executionSpan.end();
+                    },
+                };
+                extendContext({
+                    [tracingSpanSymbol]: executionSpan,
+                });
+                return resultCbs;
+            },
+        };
+    };
+};
+//# sourceMappingURL=useFaststoreTelemetry.js.map

package/dist/esm/src/telemetry/useFaststoreTelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFaststoreTelemetry.js","sourceRoot":"","sources":["../../../../src/telemetry/useFaststoreTelemetry.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/typeDefs/address.graphql

@@ -0,0 +1,45 @@
+"""
+Address information.
+"""
+type Address {
+  """
+  Address postal code
+  """
+  postalCode: String
+  """
+  Address city
+  """
+  city: String
+  """
+  Address state
+  """
+  state: String
+  """
+  Address country
+  """
+  country: String
+  """
+  Address street
+  """
+  street: String
+  """
+  Address number
+  """
+  number: String
+  """
+  Address neighborhood
+  """
+  neighborhood: String
+  """
+  Address complement
+  """
+  complement: String
+  """
+  Address reference
+  """
+  reference: String
+  """
+  Address geoCoordinates
+  """
+  geoCoordinates: [Float]
+}

package/dist/esm/src/typeDefs/aggregateOffer.graphql

@@ -0,0 +1,25 @@
+"""
+Aggregate offer information, for a given SKU that is available to be fulfilled by multiple sellers.
+"""
+type StoreAggregateOffer {
+  """
+  Highest price among all sellers.
+  """
+  highPrice: Float!
+  """
+  Lowest price among all sellers.
+  """
+  lowPrice: Float!
+  """
+  Number of sellers selling this SKU.
+  """
+  offerCount: Int!
+  """
+  ISO code of the currency used for the offer prices.
+  """
+  priceCurrency: String!
+  """
+  Array with information on each available offer.
+  """
+  offers: [StoreOffer!]!
+}

package/dist/esm/src/typeDefs/aggregateRating.graphql

@@ -0,0 +1,13 @@
+"""
+Average rating, based on multiple ratings or reviews.
+"""
+type StoreAggregateRating {
+  """
+  Value of the aggregate rating.
+  """
+  ratingValue: Float!
+  """
+  Total number of ratings.
+  """
+  reviewCount: Int!
+}

package/dist/esm/src/typeDefs/author.graphql

@@ -0,0 +1,9 @@
+"""
+information about the author of a product review or rating.
+"""
+type StoreAuthor {
+  """
+  Author name.
+  """
+  name: String!
+}

package/dist/esm/src/typeDefs/brand.graphql

@@ -0,0 +1,9 @@
+"""
+Brand of a given product.
+"""
+type StoreBrand {
+  """
+  Brand name.
+  """
+  name: String!
+}

package/dist/esm/src/typeDefs/breadcrumb.graphql

@@ -0,0 +1,31 @@
+"""
+Item of a list.
+"""
+type StoreListItem {
+  """
+  List item value.
+  """
+  item: String!
+  """
+  Name of the list item.
+  """
+  name: String!
+  """
+  Position of the item in the list.
+  """
+  position: Int!
+}
+
+"""
+List of items consisting of chain linked web pages, ending with the current page.
+"""
+type StoreBreadcrumbList {
+  """
+  Array with breadcrumb elements.
+  """
+  itemListElement: [StoreListItem!]!
+  """
+  Number of breadcrumbs in the list.
+  """
+  numberOfItems: Int!
+}

package/dist/esm/src/typeDefs/cart.graphql

@@ -0,0 +1,37 @@
+"""
+Shopping cart message.
+"""
+type StoreCartMessage {
+  """
+  Shopping cart message text.
+  """
+  text: String!
+  """
+  Shopping cart message status, which can be `INFO`, `WARNING` or `ERROR`.
+  """
+  status: StoreStatus!
+}
+
+"""
+Shopping cart information.
+"""
+type StoreCart {
+  """
+  Order information, including `orderNumber` and `acceptedOffer`.
+  """
+  order: StoreOrder!
+  """
+  List of shopping cart messages.
+  """
+  messages: [StoreCartMessage!]!
+}
+
+"""
+Shopping cart input.
+"""
+input IStoreCart {
+  """
+  Order information, including `orderNumber`, `acceptedOffer` and `shouldSplitItem`.
+  """
+  order: IStoreOrder!
+}

package/dist/esm/src/typeDefs/collection.graphql

@@ -0,0 +1,83 @@
+"""
+Product collection type. Possible values are `Department`, `Category`, `Brand`, `Cluster`, `SubCategory` or `Collection`.
+"""
+enum StoreCollectionType {
+  """
+  First level of product categorization.
+  """
+  Department
+  """
+  Second level of product categorization.
+  """
+  Category
+  """
+  Third level of product categorization.
+  """
+  SubCategory
+  """
+  Product brand.
+  """
+  Brand
+  """
+  Product cluster.
+  """
+  Cluster
+  """
+  Product collection.
+  """
+  Collection
+}
+
+"""
+Product collection facet, used for search.
+"""
+type StoreCollectionFacet {
+  """
+  Facet key.
+  """
+  key: String!
+  """
+  Facet value.
+  """
+  value: String!
+}
+
+"""
+Collection meta information. Used for search.
+"""
+type StoreCollectionMeta {
+  """
+  List of selected collection facets.
+  """
+  selectedFacets: [StoreCollectionFacet!]!
+}
+
+"""
+Product collection information.
+"""
+type StoreCollection {
+  """
+  Meta tag data.
+  """
+  seo: StoreSeo!
+  """
+  List of items consisting of chain linked web pages, ending with the current page.
+  """
+  breadcrumbList: StoreBreadcrumbList!
+  """
+  Collection meta information. Used for search.
+  """
+  meta: StoreCollectionMeta!
+  """
+  Collection ID.
+  """
+  id: ID!
+  """
+  Corresponding collection URL slug, with which to retrieve this entity.
+  """
+  slug: String!
+  """
+  Collection type.
+  """
+  type: StoreCollectionType!
+}