@contentful/optimization-api-client 0.1.0-alpha8 → 0.1.0-alpha9

package/dist/fetch/createRetryFetchMethod.js

@@ -1,138 +0,0 @@
-import { createScopedLogger } from 'logger';
-import retry from 'p-retry';
-const logger = createScopedLogger('ApiClient:Retry');
-/**
- * Default interval (in milliseconds) between retry attempts.
- *
- * @internal
- */
-const DEFAULT_INTERVAL_TIMEOUT = 0;
-/**
- * Default number of retry attempts.
- *
- * @internal
- */
-const DEFAULT_RETRY_COUNT = 1;
-/**
- * HTTP status code that triggers a retry.
- *
- * @internal
- *
- * @remarks
- * This value is currently fixed to `503 Service Unavailable`.
- */
-const RETRY_RESPONSE_STATUS = 503;
-/**
- * Default HTTP status code used for {@link HttpError}.
- *
- * @internal
- */
-const HTTP_ERROR_RESPONSE_STATUS = 500;
-/**
- * Error type representing HTTP failures with an associated status code.
- *
- * @internal
- */
-class HttpError extends Error {
-    /**
-     * The HTTP status code associated with the error.
-     */
-    status;
-    /**
-     * Creates a new {@link HttpError}.
-     *
-     * @param message - Description of the error.
-     * @param status - HTTP status code associated with the error.
-     */
-    constructor(message, status = HTTP_ERROR_RESPONSE_STATUS) {
-        super(message);
-        Object.setPrototypeOf(this, HttpError.prototype);
-        this.status = status;
-    }
-}
-/**
- * Creates a callback function used by `p-retry` to perform a fetch with retry logic.
- *
- * @param options - Internal options controlling the retry behavior.
- * @returns A function that, when invoked, performs the fetch and applies retry rules.
- *
- * @internal
- */
-function createRetryFetchCallback({ apiName = 'Optimization', controller, fetchMethod = fetch, init, url, }) {
-    return async () => {
-        try {
-            const response = await fetchMethod(url, init);
-            if (response.status === RETRY_RESPONSE_STATUS) {
-                throw new HttpError(`${apiName} API request to "${url.toString()}" failed with status: "[${response.status}] ${response.statusText}".`, RETRY_RESPONSE_STATUS);
-            }
-            if (!response.ok) {
-                const httpError = new Error(`Request to "${url.toString()}" failed with status: [${response.status}] ${response.statusText} - traceparent: ${response.headers.get('traceparent')}`);
-                logger.error('Request failed with non-OK status:', httpError);
-                controller.abort();
-                return;
-            }
-            logger.debug(`Response from "${url.toString()}":`, response);
-            return response;
-        }
-        catch (error) {
-            if (error instanceof HttpError && error.status === RETRY_RESPONSE_STATUS) {
-                throw error;
-            }
-            logger.error(`Request to "${url.toString()}" failed:`, error);
-            controller.abort();
-        }
-    };
-}
-/**
- * Creates a {@link FetchMethod} that retries failed requests according to the
- * provided configuration.
- *
- * @param options - Configuration options that control retry behavior.
- * @returns A {@link FetchMethod} that automatically retries qualifying failures.
- *
- * @remarks
- * This wrapper integrates with `p-retry` and uses an {@link AbortController}
- * to cancel pending requests when a non-retriable error occurs.
- *
- * @throws {@link Error}
- * Thrown when the request cannot be retried and no successful response is obtained.
- *
- * @example
- * ```ts
- * const fetchWithRetry = createRetryFetchMethod({
- *   apiName: 'Optimization',
- *   retries: 3,
- *   intervalTimeout: 200,
- *   onFailedAttempt: ({ attemptNumber, retriesLeft }) => {
- *     console.warn(`Attempt ${attemptNumber} failed. Retries left: ${retriesLeft}`)
- *   },
- * })
- *
- * const response = await fetchWithRetry('https://example.com', { method: 'GET' })
- * ```
- */
-export function createRetryFetchMethod({ apiName = 'Optimization', fetchMethod = fetch, intervalTimeout = DEFAULT_INTERVAL_TIMEOUT, onFailedAttempt, retries = DEFAULT_RETRY_COUNT, } = {}) {
-    return async (url, init) => {
-        const controller = new AbortController();
-        let retryResponse = undefined;
-        try {
-            retryResponse = await retry(createRetryFetchCallback({ apiName, controller, fetchMethod, init, url }), {
-                minTimeout: intervalTimeout,
-                onFailedAttempt: (options) => onFailedAttempt?.({ ...options, apiName }),
-                retries,
-                signal: controller.signal,
-            });
-        }
-        catch (error) {
-            // Abort errors caused by timeouts should not bubble up and be reported by third-party tools (e.g. Sentry)
-            if (!(error instanceof Error) || error.name !== 'AbortError') {
-                throw error;
-            }
-        }
-        if (!retryResponse) {
-            throw new Error(`${apiName} API request to "${url.toString()}" may not be retried.`);
-        }
-        return retryResponse;
-    };
-}
-//# sourceMappingURL=createRetryFetchMethod.js.map

package/dist/fetch/createRetryFetchMethod.js.map

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

package/dist/fetch/createTimeoutFetchMethod.d.ts

@@ -1,51 +0,0 @@
-import type { BaseFetchMethodOptions, FetchMethod, FetchMethodCallbackOptions } from './Fetch';
-/**
- * Configuration options for {@link createTimeoutFetchMethod}.
- */
-export interface TimeoutFetchMethodOptions extends BaseFetchMethodOptions {
-    /**
-     * Callback invoked when a request exceeds the configured timeout.
-     *
-     * @param options - Information about the timed-out request.
-     *
-     * @remarks
-     * If this callback is not provided, a default error is logged.
-     *
-     * @see {@link FetchMethodCallbackOptions}
-     */
-    onRequestTimeout?: (options: FetchMethodCallbackOptions) => void;
-    /**
-     * Maximum time (in milliseconds) to wait for a response before aborting the request.
-     *
-     * @remarks
-     * Defaults to {@link DEFAULT_REQUEST_TIMEOUT}.
-     */
-    requestTimeout?: number;
-}
-/**
- * Creates a {@link FetchMethod} that aborts requests after a configurable timeout.
- *
- * @param options - Configuration options controlling timeout behavior.
- * @returns A {@link FetchMethod} that enforces a timeout for each request.
- *
- * @remarks
- * When a timeout occurs, the request is aborted using an {@link AbortController}.
- * If `onRequestTimeout` is not provided, an error is logged by the {@link logger}.
- *
- * @example
- * ```ts
- * const fetchWithTimeout = createTimeoutFetchMethod({
- *   apiName: 'Optimization',
- *   requestTimeout: 5000,
- *   onRequestTimeout: ({ apiName }) => {
- *     console.warn(`${apiName} request timed out`)
- *   },
- * })
- *
- * const response = await fetchWithTimeout('https://example.com', { method: 'GET' })
- * ```
- *
- * @see {@link TimeoutFetchMethodOptions}
- */
-export declare function createTimeoutFetchMethod({ apiName, fetchMethod, onRequestTimeout, requestTimeout, }?: TimeoutFetchMethodOptions): FetchMethod;
-//# sourceMappingURL=createTimeoutFetchMethod.d.ts.map

package/dist/fetch/createTimeoutFetchMethod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createTimeoutFetchMethod.d.ts","sourceRoot":"","sources":["../../src/fetch/createTimeoutFetchMethod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAW9F;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACvE;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,CAAA;IAEhE;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,OAAwB,EACxB,WAAmB,EACnB,gBAAgB,EAChB,cAAwC,GACzC,GAAE,yBAA8B,GAAG,WAAW,CAoB9C"}

package/dist/fetch/createTimeoutFetchMethod.js

@@ -1,51 +0,0 @@
-import { createScopedLogger } from 'logger';
-const logger = createScopedLogger('ApiClient:Timeout');
-/**
- * Default timeout (in milliseconds) for outgoing requests.
- *
- * @internal
- */
-const DEFAULT_REQUEST_TIMEOUT = 3000;
-/**
- * Creates a {@link FetchMethod} that aborts requests after a configurable timeout.
- *
- * @param options - Configuration options controlling timeout behavior.
- * @returns A {@link FetchMethod} that enforces a timeout for each request.
- *
- * @remarks
- * When a timeout occurs, the request is aborted using an {@link AbortController}.
- * If `onRequestTimeout` is not provided, an error is logged by the {@link logger}.
- *
- * @example
- * ```ts
- * const fetchWithTimeout = createTimeoutFetchMethod({
- *   apiName: 'Optimization',
- *   requestTimeout: 5000,
- *   onRequestTimeout: ({ apiName }) => {
- *     console.warn(`${apiName} request timed out`)
- *   },
- * })
- *
- * const response = await fetchWithTimeout('https://example.com', { method: 'GET' })
- * ```
- *
- * @see {@link TimeoutFetchMethodOptions}
- */
-export function createTimeoutFetchMethod({ apiName = 'Optimization', fetchMethod = fetch, onRequestTimeout, requestTimeout = DEFAULT_REQUEST_TIMEOUT, } = {}) {
-    return async (url, init) => {
-        const controller = new AbortController();
-        const id = setTimeout(() => {
-            if (typeof onRequestTimeout === 'function') {
-                onRequestTimeout({ apiName });
-            }
-            else {
-                logger.error(`Request to "${url.toString()}" timed out`, new Error('Request timeout'));
-            }
-            controller.abort();
-        }, requestTimeout);
-        const response = await fetchMethod(url, { ...init, signal: controller.signal });
-        clearTimeout(id);
-        return response;
-    };
-}
-//# sourceMappingURL=createTimeoutFetchMethod.js.map

package/dist/fetch/createTimeoutFetchMethod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createTimeoutFetchMethod.js","sourceRoot":"","sources":["../../src/fetch/createTimeoutFetchMethod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAG3C,MAAM,MAAM,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAAA;AAEtD;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,IAAI,CAAA;AA2BpC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,wBAAwB,CAAC,EACvC,OAAO,GAAG,cAAc,EACxB,WAAW,GAAG,KAAK,EACnB,gBAAgB,EAChB,cAAc,GAAG,uBAAuB,MACX,EAAE;IAC/B,OAAO,KAAK,EAAE,GAAiB,EAAE,IAAiB,EAAE,EAAE;QACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QAExC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;YACzB,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;gBAC3C,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;YAC/B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;YACxF,CAAC;YAED,UAAU,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC,EAAE,cAAc,CAAC,CAAA;QAElB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QAE/E,YAAY,CAAC,EAAE,CAAC,CAAA;QAEhB,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;AACH,CAAC"}

package/dist/fetch/index.d.ts

@@ -1,7 +0,0 @@
-import Fetch from './Fetch';
-export * from './createProtectedFetchMethod';
-export * from './createRetryFetchMethod';
-export * from './createTimeoutFetchMethod';
-export * from './Fetch';
-export default Fetch;
-//# sourceMappingURL=index.d.ts.map

package/dist/fetch/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,SAAS,CAAA;AAE3B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,SAAS,CAAA;AAEvB,eAAe,KAAK,CAAA"}

package/dist/fetch/index.js

@@ -1,7 +0,0 @@
-import Fetch from './Fetch';
-export * from './createProtectedFetchMethod';
-export * from './createRetryFetchMethod';
-export * from './createTimeoutFetchMethod';
-export * from './Fetch';
-export default Fetch;
-//# sourceMappingURL=index.js.map

package/dist/fetch/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,SAAS,CAAA;AAE3B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,SAAS,CAAA;AAEvB,eAAe,KAAK,CAAA"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAA;AAElD,cAAc,sCAAsC,CAAA;AACpD,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -1,8 +0,0 @@
-export { default as ApiClient } from './ApiClient';
-export * from '@contentful/optimization-api-schemas';
-export * from './ApiClient';
-export * from './ApiClientBase';
-export * from './builders';
-export * from './experience';
-export * from './insights';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAA;AAElD,cAAc,sCAAsC,CAAA;AACpD,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/insights/InsightsApiClient.d.ts

@@ -1,130 +0,0 @@
-import { BatchInsightsEventArray } from '@contentful/optimization-api-schemas';
-import ApiClientBase, { type ApiConfig } from '../ApiClientBase';
-/**
- * Default base URL for the Insights ingest API.
- *
- * @public
- */
-export declare const INSIGHTS_BASE_URL = "https://ingest.insights.ninetailed.co/";
-/**
- * Options that control how Insights events are sent.
- *
- * @public
- */
-interface RequestOptions {
-    /**
-     * Handler used to enqueue events via the Beacon API or a similar mechanism.
-     *
-     * @param url - Target URL for the batched events.
-     * @param data - Array of batched insights events to be sent.
-     * @returns `true` if the events were successfully queued, `false` otherwise.
-     *
-     * @remarks
-     * When provided, this handler is preferred over direct `fetch` calls. If it
-     * returns `false`, the client falls back to emitting events immediately via
-     * `fetch`.
-     */
-    beaconHandler?: (url: string | URL, data: BatchInsightsEventArray) => boolean;
-}
-/**
- * Configuration for {@link InsightsApiClient}.
- *
- * @public
- */
-export interface InsightsApiClientConfig extends ApiConfig, RequestOptions {
-}
-/**
- * Client for sending analytics and insights events to the Ninetailed Insights API.
- *
- * @public
- *
- * @remarks
- * This client is optimized for sending batched events, optionally using a
- * custom beacon-like handler when available.
- *
- * @example
- * ```ts
- * const insightsClient = new InsightsApiClient({
- *   clientId: 'org-id',
- *   environment: 'main',
- *   preview: false,
- * })
- *
- * await insightsClient.sendBatchEvents([
- *   {
- *     profile: { id: 'profile-123', ... },
- *     events: [
- *       {
- *         type: 'track',
- *         event: 'button_clicked',
- *         properties: { id: 'primary-cta' },
- *       },
- *     ],
- *   }
- * ])
- * ```
- */
-export default class InsightsApiClient extends ApiClientBase {
-    /**
-     * Base URL used for Insights API requests.
-     */
-    protected readonly baseUrl: string;
-    /**
-     * Optional handler used to enqueue events via the Beacon API or a similar mechanism.
-     */
-    private readonly beaconHandler;
-    /**
-     * Creates a new {@link InsightsApiClient} instance.
-     *
-     * @param config - Configuration for the Insights API client.
-     *
-     * @example
-     * ```ts
-     * const client = new InsightsApiClient({
-     *   clientId: 'org-id',
-     *   environment: 'main',
-     *   beaconHandler: (url, data) => {
-     *     return navigator.sendBeacon(url.toString(), JSON.stringify(data))
-     *   },
-     * })
-     * ```
-     */
-    constructor(config: InsightsApiClientConfig);
-    /**
-     * Sends batches of insights events to the Ninetailed Insights API.
-     *
-     * @param batches - Array of event batches to send.
-     * @param options - Optional request options, including a per-call `beaconHandler`.
-     * @returns A promise that resolves when the events have been sent or queued.
-     *
-     * @remarks
-     * If a `beaconHandler` is provided (either in the method call or in the
-     * client configuration) it will be invoked first. When the handler returns
-     * `true`, the events are considered successfully queued and no network
-     * request is made by this method.
-     *
-     * If the handler is missing or returns `false`, the events are emitted
-     * immediately via `fetch`.
-     *
-     * @returns A boolean value that is true when either the event batch is successfully
-     * queued by the beacon handler or a direct request is successfully sent.
-     *
-     * @example
-     * ```ts
-     * const success = await insightsClient.sendBatchEvents(batches)
-     * ```
-     *
-     * @example
-     * ```ts
-     * // Override beaconHandler for a single call
-     * const success = await insightsClient.sendBatchEvents(batches, {
-     *   beaconHandler: (url, data) => {
-     *     return navigator.sendBeacon(url.toString(), JSON.stringify(data))
-     *   },
-     * })
-     * ```
-     */
-    sendBatchEvents(batches: BatchInsightsEventArray, options?: RequestOptions): Promise<boolean>;
-}
-export {};
-//# sourceMappingURL=InsightsApiClient.d.ts.map

package/dist/insights/InsightsApiClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InsightsApiClient.d.ts","sourceRoot":"","sources":["../../src/insights/InsightsApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAE9E,OAAO,aAAa,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAIhE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,2CAA2C,CAAA;AAEzE;;;;GAIG;AACH,UAAU,cAAc;IACtB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAA;CAC9E;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,SAAS,EAAE,cAAc;CAAG;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAC1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAElC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAE/D;;;;;;;;;;;;;;;OAeG;gBACS,MAAM,EAAE,uBAAuB;IAU3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACU,eAAe,CAC1B,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC;CAiDpB"}

package/dist/insights/InsightsApiClient.js

@@ -1,143 +0,0 @@
-import { BatchInsightsEventArray } from '@contentful/optimization-api-schemas';
-import { createScopedLogger } from 'logger';
-import ApiClientBase from '../ApiClientBase';
-const logger = createScopedLogger('ApiClient:Insights');
-/**
- * Default base URL for the Insights ingest API.
- *
- * @public
- */
-export const INSIGHTS_BASE_URL = 'https://ingest.insights.ninetailed.co/';
-/**
- * Client for sending analytics and insights events to the Ninetailed Insights API.
- *
- * @public
- *
- * @remarks
- * This client is optimized for sending batched events, optionally using a
- * custom beacon-like handler when available.
- *
- * @example
- * ```ts
- * const insightsClient = new InsightsApiClient({
- *   clientId: 'org-id',
- *   environment: 'main',
- *   preview: false,
- * })
- *
- * await insightsClient.sendBatchEvents([
- *   {
- *     profile: { id: 'profile-123', ... },
- *     events: [
- *       {
- *         type: 'track',
- *         event: 'button_clicked',
- *         properties: { id: 'primary-cta' },
- *       },
- *     ],
- *   }
- * ])
- * ```
- */
-export default class InsightsApiClient extends ApiClientBase {
-    /**
-     * Base URL used for Insights API requests.
-     */
-    baseUrl;
-    /**
-     * Optional handler used to enqueue events via the Beacon API or a similar mechanism.
-     */
-    beaconHandler;
-    /**
-     * Creates a new {@link InsightsApiClient} instance.
-     *
-     * @param config - Configuration for the Insights API client.
-     *
-     * @example
-     * ```ts
-     * const client = new InsightsApiClient({
-     *   clientId: 'org-id',
-     *   environment: 'main',
-     *   beaconHandler: (url, data) => {
-     *     return navigator.sendBeacon(url.toString(), JSON.stringify(data))
-     *   },
-     * })
-     * ```
-     */
-    constructor(config) {
-        super('Insights', config);
-        const { baseUrl, beaconHandler } = config;
-        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- Set default for anything falsey
-        this.baseUrl = baseUrl || INSIGHTS_BASE_URL;
-        this.beaconHandler = beaconHandler;
-    }
-    /**
-     * Sends batches of insights events to the Ninetailed Insights API.
-     *
-     * @param batches - Array of event batches to send.
-     * @param options - Optional request options, including a per-call `beaconHandler`.
-     * @returns A promise that resolves when the events have been sent or queued.
-     *
-     * @remarks
-     * If a `beaconHandler` is provided (either in the method call or in the
-     * client configuration) it will be invoked first. When the handler returns
-     * `true`, the events are considered successfully queued and no network
-     * request is made by this method.
-     *
-     * If the handler is missing or returns `false`, the events are emitted
-     * immediately via `fetch`.
-     *
-     * @returns A boolean value that is true when either the event batch is successfully
-     * queued by the beacon handler or a direct request is successfully sent.
-     *
-     * @example
-     * ```ts
-     * const success = await insightsClient.sendBatchEvents(batches)
-     * ```
-     *
-     * @example
-     * ```ts
-     * // Override beaconHandler for a single call
-     * const success = await insightsClient.sendBatchEvents(batches, {
-     *   beaconHandler: (url, data) => {
-     *     return navigator.sendBeacon(url.toString(), JSON.stringify(data))
-     *   },
-     * })
-     * ```
-     */
-    async sendBatchEvents(batches, options = {}) {
-        const { beaconHandler = this.beaconHandler } = options;
-        const url = new URL(`v1/organizations/${this.clientId}/environments/${this.environment}/events`, this.baseUrl);
-        const body = BatchInsightsEventArray.parse(batches);
-        if (typeof beaconHandler === 'function') {
-            logger.debug('Queueing events via beaconHandler');
-            const beaconSuccessfullyQueued = beaconHandler(url, body);
-            if (beaconSuccessfullyQueued) {
-                return true;
-            }
-            else {
-                logger.warn('beaconHandler failed to queue events; events will be emitted immediately via fetch');
-            }
-        }
-        const requestName = 'Event Batches';
-        logger.info(`Sending "${requestName}" request`);
-        logger.debug(`"${requestName}" request body:`, body);
-        try {
-            await this.fetch(url, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(body),
-                keepalive: true,
-            });
-            logger.debug(`"${requestName}" request successfully completed`);
-            return true;
-        }
-        catch (error) {
-            this.logRequestError(error, { requestName });
-            return false;
-        }
-    }
-}
-//# sourceMappingURL=InsightsApiClient.js.map

package/dist/insights/InsightsApiClient.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"InsightsApiClient.js","sourceRoot":"","sources":["../../src/insights/InsightsApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,aAAiC,MAAM,kBAAkB,CAAA;AAEhE,MAAM,MAAM,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,wCAAwC,CAAA;AA8BzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAC1D;;OAEG;IACgB,OAAO,CAAQ;IAElC;;OAEG;IACc,aAAa,CAAiC;IAE/D;;;;;;;;;;;;;;;OAeG;IACH,YAAY,MAA+B;QACzC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAEzB,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;QAEzC,2GAA2G;QAC3G,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,iBAAiB,CAAA;QAC3C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACI,KAAK,CAAC,eAAe,CAC1B,OAAgC,EAChC,UAA0B,EAAE;QAE5B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,OAAO,CAAA;QAEtD,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,oBAAoB,IAAI,CAAC,QAAQ,iBAAiB,IAAI,CAAC,WAAW,SAAS,EAC3E,IAAI,CAAC,OAAO,CACb,CAAA;QAED,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAEnD,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAA;YAEjD,MAAM,wBAAwB,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAEzD,IAAI,wBAAwB,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAA;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CACT,oFAAoF,CACrF,CAAA;YACH,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,eAAe,CAAA;QAEnC,MAAM,CAAC,IAAI,CAAC,YAAY,WAAW,WAAW,CAAC,CAAA;QAE/C,MAAM,CAAC,KAAK,CAAC,IAAI,WAAW,iBAAiB,EAAE,IAAI,CAAC,CAAA;QAEpD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;gBACpB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,SAAS,EAAE,IAAI;aAChB,CAAC,CAAA;YAEF,MAAM,CAAC,KAAK,CAAC,IAAI,WAAW,kCAAkC,CAAC,CAAA;YAE/D,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAA;YAE5C,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/insights/index.d.ts

@@ -1,4 +0,0 @@
-import InsightsApiClient from './InsightsApiClient';
-export * from './InsightsApiClient';
-export default InsightsApiClient;
-//# sourceMappingURL=index.d.ts.map

package/dist/insights/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AAEnD,cAAc,qBAAqB,CAAA;AAEnC,eAAe,iBAAiB,CAAA"}

package/dist/insights/index.js

@@ -1,4 +0,0 @@
-import InsightsApiClient from './InsightsApiClient';
-export * from './InsightsApiClient';
-export default InsightsApiClient;
-//# sourceMappingURL=index.js.map

package/dist/insights/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AAEnD,cAAc,qBAAqB,CAAA;AAEnC,eAAe,iBAAiB,CAAA"}