@rudderstack/analytics-js 3.21.0-beta.pr.2309.bb541e7 → 3.22.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [3.22.0](https://github.com/rudderlabs/rudder-sdk-js/compare/@rudderstack/analytics-js@3.21.0...@rudderstack/analytics-js@3.22.0) (2025-07-21)
+
+### Dependency Updates
+
+* `@rudderstack/analytics-js-cookies` updated to version `0.5.0`
+* `@rudderstack/analytics-js-common` updated to version `3.22.0`
+* `@rudderstack/analytics-js-plugins` updated to version `3.11.0`
+
+### Features
+
+* add legacy utils package ([#2323](https://github.com/rudderlabs/rudder-sdk-js/issues/2323)) ([32a90c4](https://github.com/rudderlabs/rudder-sdk-js/commit/32a90c4417b747f4da2b1027249ccfbab1d075fd))
+* categorize integration errors ([#2331](https://github.com/rudderlabs/rudder-sdk-js/issues/2331)) ([c64df64](https://github.com/rudderlabs/rudder-sdk-js/commit/c64df64a585108dafc2cbd459806ab3506395dc7))
+* relocate destination constants ([#2325](https://github.com/rudderlabs/rudder-sdk-js/issues/2325)) ([0a421ae](https://github.com/rudderlabs/rudder-sdk-js/commit/0a421ae9f5c38556a3fa9487f16cdcea66921064))
+
+
+### Bug Fixes
+
+* error handle property access and instance mutation ([#2316](https://github.com/rudderlabs/rudder-sdk-js/issues/2316)) ([99f2788](https://github.com/rudderlabs/rudder-sdk-js/commit/99f278812ee832350e7a0afc807bf38d86bdce9f))
+* remove unnecessary bugsnag dependency in declaration files ([#2341](https://github.com/rudderlabs/rudder-sdk-js/issues/2341)) ([0e17aa2](https://github.com/rudderlabs/rudder-sdk-js/commit/0e17aa2651697f3d8a37d729704bf1530ebe925f))
+
 ## [3.21.0](https://github.com/rudderlabs/rudder-sdk-js/compare/@rudderstack/analytics-js@3.20.1...@rudderstack/analytics-js@3.21.0) (2025-06-20)
 
 ### Dependency Updates

package/dist/npm/index.d.cts

@@ -1,5 +1,3 @@
-import { Event } from '@bugsnag/js';
-
 type LoggerProvider$1 = Record<Exclude<Lowercase<LogLevel>, Lowercase<'NONE'>>, (...data: any[]) => void>;
 interface ILogger {
     minLogLevel: number;
@@ -14,7 +12,6 @@ interface ILogger {
     setMinLogLevel(logLevel: LogLevel): void;
 }
 type LogLevel = 'LOG' | 'INFO' | 'DEBUG' | 'WARN' | 'ERROR' | 'NONE';
-type RSALogger = Pick<ILogger, 'log' | 'info' | 'debug' | 'warn' | 'error' | 'setMinLogLevel'>;
 
 type LoggerProvider = Record<Exclude<Lowercase<LogLevel>, Lowercase<'NONE'>>, (...data: any[]) => void>;
 
@@ -63,7 +60,6 @@ type IntegrationOpts = {
     [index: string]: DestinationIntgConfig;
 };
 
-type Traits = Nullable<ApiObject>;
 type ApiCallback = (data?: any) => void;
 /**
  * Represents the options parameter in the APIs
@@ -163,11 +159,6 @@ type CookieSameSite = 'Strict' | 'Lax' | 'None';
 type OneTrustCookieCategory = {
     oneTrustCookieCategory: string;
 };
-type ConsentManagement = {
-    deniedConsentIds: Consents;
-    allowedConsentIds: Consents;
-    provider: ConsentManagementProvider;
-};
 type ConsentManagementMetadata = {
     providers: ConsentManagementProviderMetadata[];
 };
@@ -428,76 +419,6 @@ type IdentifyTraits = {
     [index: string]: string | number | boolean | ApiObject | null | Date | (string | number | boolean | null | Date | ApiObject)[] | undefined;
 };
 
-type AppInfo = {
-    readonly name: string;
-    readonly version: string;
-    readonly namespace: string;
-    readonly installType: string;
-};
-type LibraryInfo = {
-    readonly name: string;
-    readonly version: string;
-    readonly snippetVersion?: string;
-};
-type OSInfo = {
-    readonly name: string;
-    readonly version: string;
-};
-type ScreenInfo = {
-    readonly density: number;
-    readonly width: number;
-    readonly height: number;
-    readonly innerWidth: number;
-    readonly innerHeight: number;
-};
-type UTMParameters = Record<string, string>;
-
-type PageLifecycle = {
-    pageViewId: string;
-};
-type AutoTrack = {
-    page: PageLifecycle;
-};
-type RudderContext = {
-    [index: string]: string | number | boolean | ApiObject | UADataValues | Nullable<string> | (string | number | boolean | ApiObject)[] | undefined;
-    traits?: Nullable<ApiObject>;
-    sessionId?: number;
-    sessionStart?: boolean;
-    consentManagement?: ConsentManagement;
-    'ua-ch'?: UADataValues;
-    app: AppInfo;
-    library: LibraryInfo;
-    userAgent: Nullable<string>;
-    os: OSInfo;
-    locale: Nullable<string>;
-    screen: ScreenInfo;
-    campaign?: UTMParameters;
-    trulyAnonymousTracking?: boolean;
-    timezone: string;
-    autoTrack?: AutoTrack;
-};
-type RudderEvent = {
-    type: RudderEventType;
-    channel: string;
-    anonymousId: string;
-    context: RudderContext;
-    originalTimestamp: string;
-    integrations: IntegrationOpts;
-    messageId: string;
-    event: Nullable<string>;
-    previousId?: string;
-    userId?: Nullable<string>;
-    sentAt?: string;
-    properties?: Nullable<ApiObject>;
-    name?: Nullable<string>;
-    category?: Nullable<string>;
-    traits?: Traits;
-    groupId?: Nullable<string>;
-};
-type RSAEvent = {
-    message: RudderEvent;
-};
-
 type AnalyticsIdentifyMethod = {
     (userId: string, traits?: Nullable<IdentifyTraits>, options?: Nullable<ApiOptions>, callback?: ApiCallback): void;
     (userId: string, traits?: Nullable<IdentifyTraits>, callback?: ApiCallback): void;
@@ -635,75 +556,7 @@ interface IRudderAnalytics<T = any> {
      * @param options Consent API options
      */
     consent(options?: ConsentOptions): void;
-    /**
-     * To add a custom integration
-     * @param name The name of the custom integration
-     * @param integration The custom integration object
-     */
-    addCustomIntegration(name: string, integration: RSACustomIntegration): void;
 }
-type RSAnalytics = Pick<IRudderAnalytics, 'track' | 'page' | 'identify' | 'group' | 'alias' | 'getAnonymousId' | 'getUserId' | 'getUserTraits' | 'getGroupId' | 'getGroupTraits' | 'getSessionId'>;
-/**
- * Type for the custom integration to be used in addCustomIntegration API
- * Defines the contract that all custom integrations must implement
- */
-type RSACustomIntegration = {
-    /**
-     * Initialize the integration
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @optional
-     */
-    init?: (analytics: RSAnalytics, logger: RSALogger) => void;
-    /**
-     * Check if the integration is ready to process events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @returns boolean indicating whether the integration is ready
-     * @required
-     */
-    isReady: (analytics: RSAnalytics, logger: RSALogger) => boolean;
-    /**
-     * Process track events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The track event payload to process
-     * @optional
-     */
-    track?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process page events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The page event payload to process
-     * @optional
-     */
-    page?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process identify events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The identify event payload to process
-     * @optional
-     */
-    identify?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process group events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The group event payload to process
-     * @optional
-     */
-    group?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process alias events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The alias event payload to process
-     * @optional
-     */
-    alias?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-};
 
 type SDKError = unknown | Error | ErrorEvent | Event | PromiseRejectionEvent;
 type ErrorInfo = {
@@ -712,6 +565,7 @@ type ErrorInfo = {
     customMessage?: string;
     errorType?: ErrorType;
     groupingHash?: string | SDKError;
+    category?: 'sdk' | 'integrations';
 };
 interface IErrorHandler {
     httpClient: IHttpClient;
@@ -1278,13 +1132,6 @@ interface IAnalytics {
      * To set auth token
      */
     setAuthToken(token: string): void;
-    /**
-     * Add a custom integration to the SDK
-     * @param name - Unique name for the custom integration
-     * @param integration - The custom integration instance implementing RSACustomIntegration
-     * @param isBufferedInvocation - Internal flag to indicate if this is a buffered call
-     */
-    addCustomIntegration(name: string, integration: RSACustomIntegration, isBufferedInvocation?: boolean): void;
 }
 
 declare class RudderAnalytics implements IRudderAnalytics<IAnalytics> {
@@ -1293,12 +1140,6 @@ declare class RudderAnalytics implements IRudderAnalytics<IAnalytics> {
     defaultAnalyticsKey: string;
     logger: Logger;
     constructor();
-    /**
-     * Create an instance of the current instance that can be used
-     * to call a subset of methods of the current instance.
-     * It is typically used to expose the analytics instance to the integrations (standard and custom)
-     */
-    createSafeAnalyticsInstance(): void;
     static initializeGlobalResources(): void;
     /**
      * Set instance to use if no specific writeKey is provided in methods
@@ -1393,7 +1234,6 @@ declare class RudderAnalytics implements IRudderAnalytics<IAnalytics> {
     getSessionId(): Nullable<number> | undefined;
     setAuthToken(token: string): void;
     consent(options?: ConsentOptions): void;
-    addCustomIntegration(name: string, integration: RSACustomIntegration): void;
 }
 //# sourceMappingURL=RudderAnalytics.d.ts.map
 
@@ -1405,4 +1245,4 @@ declare global {
 //# sourceMappingURL=index.d.ts.map
 
 export { RudderAnalytics };
-export type { AnonymousIdOptions, ApiCallback, ApiObject, ApiOptions, BeaconQueueOpts, ConsentOptions, CookieSameSite, DestinationsQueueOpts, IdentifyTraits, IntegrationOpts, LoadOptions, LogLevel, PluginName, PreloadedEventCall, QueueOpts, RSACustomIntegration, RSAEvent, RSALogger, RSAnalytics, RudderAnalyticsPreloader, SessionOpts, UaChTrackLevel };
+export type { AnonymousIdOptions, ApiCallback, ApiObject, ApiOptions, BeaconQueueOpts, ConsentOptions, CookieSameSite, DestinationsQueueOpts, IdentifyTraits, IntegrationOpts, LoadOptions, LogLevel, PluginName, PreloadedEventCall, QueueOpts, RudderAnalyticsPreloader, SessionOpts, UaChTrackLevel };

package/dist/npm/index.d.mts

@@ -1,5 +1,3 @@
-import { Event } from '@bugsnag/js';
-
 type LoggerProvider$1 = Record<Exclude<Lowercase<LogLevel>, Lowercase<'NONE'>>, (...data: any[]) => void>;
 interface ILogger {
     minLogLevel: number;
@@ -14,7 +12,6 @@ interface ILogger {
     setMinLogLevel(logLevel: LogLevel): void;
 }
 type LogLevel = 'LOG' | 'INFO' | 'DEBUG' | 'WARN' | 'ERROR' | 'NONE';
-type RSALogger = Pick<ILogger, 'log' | 'info' | 'debug' | 'warn' | 'error' | 'setMinLogLevel'>;
 
 type LoggerProvider = Record<Exclude<Lowercase<LogLevel>, Lowercase<'NONE'>>, (...data: any[]) => void>;
 
@@ -63,7 +60,6 @@ type IntegrationOpts = {
     [index: string]: DestinationIntgConfig;
 };
 
-type Traits = Nullable<ApiObject>;
 type ApiCallback = (data?: any) => void;
 /**
  * Represents the options parameter in the APIs
@@ -163,11 +159,6 @@ type CookieSameSite = 'Strict' | 'Lax' | 'None';
 type OneTrustCookieCategory = {
     oneTrustCookieCategory: string;
 };
-type ConsentManagement = {
-    deniedConsentIds: Consents;
-    allowedConsentIds: Consents;
-    provider: ConsentManagementProvider;
-};
 type ConsentManagementMetadata = {
     providers: ConsentManagementProviderMetadata[];
 };
@@ -428,76 +419,6 @@ type IdentifyTraits = {
     [index: string]: string | number | boolean | ApiObject | null | Date | (string | number | boolean | null | Date | ApiObject)[] | undefined;
 };
 
-type AppInfo = {
-    readonly name: string;
-    readonly version: string;
-    readonly namespace: string;
-    readonly installType: string;
-};
-type LibraryInfo = {
-    readonly name: string;
-    readonly version: string;
-    readonly snippetVersion?: string;
-};
-type OSInfo = {
-    readonly name: string;
-    readonly version: string;
-};
-type ScreenInfo = {
-    readonly density: number;
-    readonly width: number;
-    readonly height: number;
-    readonly innerWidth: number;
-    readonly innerHeight: number;
-};
-type UTMParameters = Record<string, string>;
-
-type PageLifecycle = {
-    pageViewId: string;
-};
-type AutoTrack = {
-    page: PageLifecycle;
-};
-type RudderContext = {
-    [index: string]: string | number | boolean | ApiObject | UADataValues | Nullable<string> | (string | number | boolean | ApiObject)[] | undefined;
-    traits?: Nullable<ApiObject>;
-    sessionId?: number;
-    sessionStart?: boolean;
-    consentManagement?: ConsentManagement;
-    'ua-ch'?: UADataValues;
-    app: AppInfo;
-    library: LibraryInfo;
-    userAgent: Nullable<string>;
-    os: OSInfo;
-    locale: Nullable<string>;
-    screen: ScreenInfo;
-    campaign?: UTMParameters;
-    trulyAnonymousTracking?: boolean;
-    timezone: string;
-    autoTrack?: AutoTrack;
-};
-type RudderEvent = {
-    type: RudderEventType;
-    channel: string;
-    anonymousId: string;
-    context: RudderContext;
-    originalTimestamp: string;
-    integrations: IntegrationOpts;
-    messageId: string;
-    event: Nullable<string>;
-    previousId?: string;
-    userId?: Nullable<string>;
-    sentAt?: string;
-    properties?: Nullable<ApiObject>;
-    name?: Nullable<string>;
-    category?: Nullable<string>;
-    traits?: Traits;
-    groupId?: Nullable<string>;
-};
-type RSAEvent = {
-    message: RudderEvent;
-};
-
 type AnalyticsIdentifyMethod = {
     (userId: string, traits?: Nullable<IdentifyTraits>, options?: Nullable<ApiOptions>, callback?: ApiCallback): void;
     (userId: string, traits?: Nullable<IdentifyTraits>, callback?: ApiCallback): void;
@@ -635,75 +556,7 @@ interface IRudderAnalytics<T = any> {
      * @param options Consent API options
      */
     consent(options?: ConsentOptions): void;
-    /**
-     * To add a custom integration
-     * @param name The name of the custom integration
-     * @param integration The custom integration object
-     */
-    addCustomIntegration(name: string, integration: RSACustomIntegration): void;
 }
-type RSAnalytics = Pick<IRudderAnalytics, 'track' | 'page' | 'identify' | 'group' | 'alias' | 'getAnonymousId' | 'getUserId' | 'getUserTraits' | 'getGroupId' | 'getGroupTraits' | 'getSessionId'>;
-/**
- * Type for the custom integration to be used in addCustomIntegration API
- * Defines the contract that all custom integrations must implement
- */
-type RSACustomIntegration = {
-    /**
-     * Initialize the integration
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @optional
-     */
-    init?: (analytics: RSAnalytics, logger: RSALogger) => void;
-    /**
-     * Check if the integration is ready to process events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @returns boolean indicating whether the integration is ready
-     * @required
-     */
-    isReady: (analytics: RSAnalytics, logger: RSALogger) => boolean;
-    /**
-     * Process track events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The track event payload to process
-     * @optional
-     */
-    track?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process page events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The page event payload to process
-     * @optional
-     */
-    page?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process identify events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The identify event payload to process
-     * @optional
-     */
-    identify?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process group events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The group event payload to process
-     * @optional
-     */
-    group?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-    /**
-     * Process alias events
-     * @param analytics - The RudderStack analytics instance
-     * @param logger - The logger instance for this integration
-     * @param event - The alias event payload to process
-     * @optional
-     */
-    alias?: (analytics: RSAnalytics, logger: RSALogger, event: RSAEvent) => void;
-};
 
 type SDKError = unknown | Error | ErrorEvent | Event | PromiseRejectionEvent;
 type ErrorInfo = {
@@ -712,6 +565,7 @@ type ErrorInfo = {
     customMessage?: string;
     errorType?: ErrorType;
     groupingHash?: string | SDKError;
+    category?: 'sdk' | 'integrations';
 };
 interface IErrorHandler {
     httpClient: IHttpClient;
@@ -1278,13 +1132,6 @@ interface IAnalytics {
      * To set auth token
      */
     setAuthToken(token: string): void;
-    /**
-     * Add a custom integration to the SDK
-     * @param name - Unique name for the custom integration
-     * @param integration - The custom integration instance implementing RSACustomIntegration
-     * @param isBufferedInvocation - Internal flag to indicate if this is a buffered call
-     */
-    addCustomIntegration(name: string, integration: RSACustomIntegration, isBufferedInvocation?: boolean): void;
 }
 
 declare class RudderAnalytics implements IRudderAnalytics<IAnalytics> {
@@ -1293,12 +1140,6 @@ declare class RudderAnalytics implements IRudderAnalytics<IAnalytics> {
     defaultAnalyticsKey: string;
     logger: Logger;
     constructor();
-    /**
-     * Create an instance of the current instance that can be used
-     * to call a subset of methods of the current instance.
-     * It is typically used to expose the analytics instance to the integrations (standard and custom)
-     */
-    createSafeAnalyticsInstance(): void;
     static initializeGlobalResources(): void;
     /**
      * Set instance to use if no specific writeKey is provided in methods
@@ -1393,7 +1234,6 @@ declare class RudderAnalytics implements IRudderAnalytics<IAnalytics> {
     getSessionId(): Nullable<number> | undefined;
     setAuthToken(token: string): void;
     consent(options?: ConsentOptions): void;
-    addCustomIntegration(name: string, integration: RSACustomIntegration): void;
 }
 //# sourceMappingURL=RudderAnalytics.d.ts.map
 
@@ -1405,4 +1245,4 @@ declare global {
 //# sourceMappingURL=index.d.ts.map
 
 export { RudderAnalytics };
-export type { AnonymousIdOptions, ApiCallback, ApiObject, ApiOptions, BeaconQueueOpts, ConsentOptions, CookieSameSite, DestinationsQueueOpts, IdentifyTraits, IntegrationOpts, LoadOptions, LogLevel, PluginName, PreloadedEventCall, QueueOpts, RSACustomIntegration, RSAEvent, RSALogger, RSAnalytics, RudderAnalyticsPreloader, SessionOpts, UaChTrackLevel };
+export type { AnonymousIdOptions, ApiCallback, ApiObject, ApiOptions, BeaconQueueOpts, ConsentOptions, CookieSameSite, DestinationsQueueOpts, IdentifyTraits, IntegrationOpts, LoadOptions, LogLevel, PluginName, PreloadedEventCall, QueueOpts, RudderAnalyticsPreloader, SessionOpts, UaChTrackLevel };