@rudderstack/integrations-lib 0.2.44 → 0.2.47

package/README.md

@@ -1 +1,110 @@
-# rudder-integrations-lib
+# RudderStack Integrations Library
+
+A comprehensive TypeScript library providing shared utilities, SDKs, and tools for RudderStack integrations and destinations.
+
+## Features
+
+- **SDK Integrations**: Pre-built SDKs for Google Ads, Zoho, Customer.io, Criteo, and SFMC
+- **Feature Flags**: Multi-provider feature flag system with Flagsmith and Local support
+- **Network Utilities**: HTTP client factory and request handling
+- **Error Handling**: Comprehensive error types and handling utilities
+- **Logging**: Structured logging with multiple levels and formats
+- **Cluster Management**: Process clustering and management utilities
+- **Utilities**: Common utilities for data manipulation, validation, and processing
+
+## Installation
+
+```bash
+npm install @rudderstack/integrations-lib
+```
+
+## Quick Start
+
+```typescript
+import {
+  // Core utilities
+  logger,
+  structuredLogger,
+  setValue,
+
+  // SDKs
+  SFMC,
+  CustomerIOSegment,
+  ZOHO_SDK,
+  GoogleAdsSDK,
+  CriteoAudience,
+
+  // Feature flags
+  featureFlagService,
+  FeatureFlagService,
+
+  // Network
+  createHttpClient,
+
+  // Utils
+  deepFreeze,
+  batchProcess,
+} from '@rudderstack/integrations-lib';
+
+// Initialize feature flags
+await featureFlagService.initialize();
+
+// Use SDKs
+const sfmc = new SFMC(config);
+const googleAds = new GoogleAdsSDK.GoogleAdsRestAPI(config);
+
+// Structured logging
+structuredLogger.info('Integration started', {
+  destinationId: 'dest-123',
+  workspaceId: 'ws-456',
+});
+```
+
+## SDKs
+
+- **SFMC**: Salesforce Marketing Cloud integration
+- **Customer.io**: Customer.io audience management
+- **Zoho**: Zoho CRM and marketing tools
+- **Google Ads**: Google Ads REST API client
+- **Criteo**: Criteo audience management
+
+## Feature Flags
+
+Multi-provider feature flag system supporting:
+
+- Flagsmith for production
+- Local provider for development
+- Environment-based overrides
+- Type-safe flag definitions
+
+```typescript
+const user = {
+  workspaceId: 'ws-123',
+  traits: new Map([
+    ['organization_id', 'org-456'],
+    ['user_id', 'user-789'],
+  ]),
+};
+
+const result = await featureFlagService.isFeatureEnabled(user, 'my-feature');
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test
+npm test
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT

package/build/auth-types/index.d.ts

@@ -0,0 +1,62 @@
+export type commonAuthSecretT = {
+    expirationDate?: string;
+};
+export type AmazonDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+    clientId: string;
+};
+export type BingAdsDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+    developer_token: string;
+};
+export type CriteoDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+export type GoogleAdwordsDestinationAuthSecretT = commonAuthSecretT & {
+    access_token: string;
+    refresh_token: string;
+    developer_token: string;
+};
+export type IntercomDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+export type LinkedinDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+export type RedditDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+export type SalesforceDestinationAuthSecretT = commonAuthSecretT & {
+    access_token: string;
+    refresh_token: string;
+    instance_url: string;
+};
+export type SnapchatDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+export type TiktokAudienceDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    advertiserIds: string;
+};
+export type TwitterAdsDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    accessTokenSecret: string;
+    consumerKey: string;
+    consumerSecret: string;
+};
+export type YandexMetricaDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+export type ZohoDestinationAuthSecretT = commonAuthSecretT & {
+    accessToken: string;
+    refreshToken: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/build/auth-types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth-types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,GAAG;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,iBAAiB,GAAG;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,GAAG;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,iBAAiB,GAAG;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,GAAG;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,GAAG;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,GAAG;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,iBAAiB,GAAG;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,GAAG;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,iBAAiB,GAAG;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,iBAAiB,GAAG;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,iBAAiB,GAAG;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,iBAAiB,GAAG;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/build/auth-types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXV0aC10eXBlcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0IHR5cGUgY29tbW9uQXV0aFNlY3JldFQgPSB7XG4gIGV4cGlyYXRpb25EYXRlPzogc3RyaW5nOyAvLyBJU08gODYwMSBmb3JtYXRcbn07XG5cbmV4cG9ydCB0eXBlIEFtYXpvbkRlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgcmVmcmVzaFRva2VuOiBzdHJpbmc7XG4gIGNsaWVudElkOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBCaW5nQWRzRGVzdGluYXRpb25BdXRoU2VjcmV0VCA9IGNvbW1vbkF1dGhTZWNyZXRUICYge1xuICBhY2Nlc3NUb2tlbjogc3RyaW5nO1xuICByZWZyZXNoVG9rZW46IHN0cmluZztcbiAgZGV2ZWxvcGVyX3Rva2VuOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBDcml0ZW9EZXN0aW5hdGlvbkF1dGhTZWNyZXRUID0gY29tbW9uQXV0aFNlY3JldFQgJiB7XG4gIGFjY2Vzc1Rva2VuOiBzdHJpbmc7XG4gIHJlZnJlc2hUb2tlbjogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgR29vZ2xlQWR3b3Jkc0Rlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzX3Rva2VuOiBzdHJpbmc7XG4gIHJlZnJlc2hfdG9rZW46IHN0cmluZztcbiAgZGV2ZWxvcGVyX3Rva2VuOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBJbnRlcmNvbURlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgcmVmcmVzaFRva2VuOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBMaW5rZWRpbkRlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgcmVmcmVzaFRva2VuOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBSZWRkaXREZXN0aW5hdGlvbkF1dGhTZWNyZXRUID0gY29tbW9uQXV0aFNlY3JldFQgJiB7XG4gIGFjY2Vzc1Rva2VuOiBzdHJpbmc7XG4gIHJlZnJlc2hUb2tlbjogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgU2FsZXNmb3JjZURlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzX3Rva2VuOiBzdHJpbmc7XG4gIHJlZnJlc2hfdG9rZW46IHN0cmluZztcbiAgaW5zdGFuY2VfdXJsOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBTbmFwY2hhdERlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgcmVmcmVzaFRva2VuOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBUaWt0b2tBdWRpZW5jZURlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgYWR2ZXJ0aXNlcklkczogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgVHdpdHRlckFkc0Rlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgYWNjZXNzVG9rZW5TZWNyZXQ6IHN0cmluZztcbiAgY29uc3VtZXJLZXk6IHN0cmluZztcbiAgY29uc3VtZXJTZWNyZXQ6IHN0cmluZztcbn07XG5cbmV4cG9ydCB0eXBlIFlhbmRleE1ldHJpY2FEZXN0aW5hdGlvbkF1dGhTZWNyZXRUID0gY29tbW9uQXV0aFNlY3JldFQgJiB7XG4gIGFjY2Vzc1Rva2VuOiBzdHJpbmc7XG4gIHJlZnJlc2hUb2tlbjogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgWm9ob0Rlc3RpbmF0aW9uQXV0aFNlY3JldFQgPSBjb21tb25BdXRoU2VjcmV0VCAmIHtcbiAgYWNjZXNzVG9rZW46IHN0cmluZztcbiAgcmVmcmVzaFRva2VuOiBzdHJpbmc7XG59O1xuIl19

package/build/index.d.ts

@@ -10,5 +10,6 @@ export * from './constants';
 export * from './sdks';
 export * from './cluster';
 export * from './feature-flags';
+export * from './auth-types';
 export { setValue };
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/build/index.js

@@ -31,4 +31,5 @@ __exportStar(require("./constants"), exports);
 __exportStar(require("./sdks"), exports);
 __exportStar(require("./cluster"), exports);
 __exportStar(require("./feature-flags"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxnRUFBdUM7QUFhOUIsbUJBYkYsbUJBQVEsQ0FhRTtBQVhqQiwwQ0FBd0I7QUFDeEIseUNBQXVCO0FBQ3ZCLDJDQUF5QjtBQUN6QiwyQ0FBeUI7QUFDekIsc0RBQW9DO0FBQ3BDLDRDQUEwQjtBQUMxQiwwQ0FBd0I7QUFDeEIsOENBQTRCO0FBQzVCLHlDQUF1QjtBQUN2Qiw0Q0FBMEI7QUFDMUIsa0RBQWdDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHNldFZhbHVlIGZyb20gJy4vbGliL3NldC12YWx1ZSc7XG5cbmV4cG9ydCAqIGZyb20gJy4vdHlwZXMnO1xuZXhwb3J0ICogZnJvbSAnLi90YWdzJztcbmV4cG9ydCAqIGZyb20gJy4vZXJyb3JzJztcbmV4cG9ydCAqIGZyb20gJy4vbG9nZ2VyJztcbmV4cG9ydCAqIGZyb20gJy4vc3RydWN0dXJlZC1sb2dnZXInO1xuZXhwb3J0ICogZnJvbSAnLi9uZXR3b3JrJztcbmV4cG9ydCAqIGZyb20gJy4vdXRpbHMnO1xuZXhwb3J0ICogZnJvbSAnLi9jb25zdGFudHMnO1xuZXhwb3J0ICogZnJvbSAnLi9zZGtzJztcbmV4cG9ydCAqIGZyb20gJy4vY2x1c3Rlcic7XG5leHBvcnQgKiBmcm9tICcuL2ZlYXR1cmUtZmxhZ3MnO1xuZXhwb3J0IHsgc2V0VmFsdWUgfTtcbiJdfQ==
+__exportStar(require("./auth-types"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxnRUFBdUM7QUFjOUIsbUJBZEYsbUJBQVEsQ0FjRTtBQVpqQiwwQ0FBd0I7QUFDeEIseUNBQXVCO0FBQ3ZCLDJDQUF5QjtBQUN6QiwyQ0FBeUI7QUFDekIsc0RBQW9DO0FBQ3BDLDRDQUEwQjtBQUMxQiwwQ0FBd0I7QUFDeEIsOENBQTRCO0FBQzVCLHlDQUF1QjtBQUN2Qiw0Q0FBMEI7QUFDMUIsa0RBQWdDO0FBQ2hDLCtDQUE2QiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBzZXRWYWx1ZSBmcm9tICcuL2xpYi9zZXQtdmFsdWUnO1xuXG5leHBvcnQgKiBmcm9tICcuL3R5cGVzJztcbmV4cG9ydCAqIGZyb20gJy4vdGFncyc7XG5leHBvcnQgKiBmcm9tICcuL2Vycm9ycyc7XG5leHBvcnQgKiBmcm9tICcuL2xvZ2dlcic7XG5leHBvcnQgKiBmcm9tICcuL3N0cnVjdHVyZWQtbG9nZ2VyJztcbmV4cG9ydCAqIGZyb20gJy4vbmV0d29yayc7XG5leHBvcnQgKiBmcm9tICcuL3V0aWxzJztcbmV4cG9ydCAqIGZyb20gJy4vY29uc3RhbnRzJztcbmV4cG9ydCAqIGZyb20gJy4vc2Rrcyc7XG5leHBvcnQgKiBmcm9tICcuL2NsdXN0ZXInO1xuZXhwb3J0ICogZnJvbSAnLi9mZWF0dXJlLWZsYWdzJztcbmV4cG9ydCAqIGZyb20gJy4vYXV0aC10eXBlcyc7XG5leHBvcnQgeyBzZXRWYWx1ZSB9O1xuIl19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rudderstack/integrations-lib",
-  "version": "0.2.44",
+  "version": "0.2.47",
   "description": "",
   "main": "build/index.js",
   "module": "build/index.js",