@sailpoint/connector-sdk 1.1.41 → 1.2.1

package/dist/lib/cache.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Key prefix reserved for internal SDK use. User keys must not start with this prefix.
+ */
+export declare const SDK_CACHE_PREFIX = "__sdk:";
+/**
+ * A general-purpose in-memory cache with TTL support.
+ *
+ * Because connectors run in a Lambda-like environment where module-level state persists
+ * across warm invocations, values stored in the cache remain available between requests
+ * as long as the container stays warm.
+ *
+ * The SDK uses this cache internally for auth token storage (with reserved keys prefixed
+ * by `__sdk:`). Connector developers can use it to cache any data that is expensive to
+ * fetch on every invocation.
+ *
+ * @example
+ * ```typescript
+ * import { connectorCache } from '@sailpoint/connector-sdk'
+ *
+ * // Cache an API response for 5 minutes using fetch()
+ * const users = await connectorCache.fetch('all-users', () => myClient.getUsers(), 300)
+ * ```
+ */
+export declare class ConnectorCache {
+    private readonly store;
+    private readonly inflight;
+    /**
+     * Get a value from the cache. Returns `undefined` if the key does not exist or has expired.
+     * @param key Cache key
+     */
+    get<T = any>(key: string): T | undefined;
+    /**
+     * Store a value in the cache.
+     * @param key Cache key (must not start with `__sdk:` — that prefix is reserved for internal use)
+     * @param value Value to cache
+     * @param ttlSeconds Time-to-live in seconds. If omitted, the entry never expires.
+     */
+    set<T = any>(key: string, value: T, ttlSeconds?: number): void;
+    /**
+     * Check whether a key exists and has not expired.
+     * @param key Cache key
+     */
+    has(key: string): boolean;
+    /**
+     * Return the cached value for `key`, or compute and store it if absent.
+     *
+     * If the key is not in the cache (or has expired), `factory` is called once to produce
+     * the value, which is then stored with the given TTL. Concurrent calls with the same key
+     * are deduplicated — only one `factory` invocation runs, and all callers receive the
+     * same result.
+     *
+     * @param key Cache key
+     * @param factory Async function that produces the value when the cache is empty
+     * @param ttlSeconds Time-to-live in seconds. If omitted, the entry never expires.
+     *
+     * @example
+     * ```typescript
+     * const entitlementMap = await connectorCache.fetch(
+     *     'entitlement-map',
+     *     async () => {
+     *         const entitlements = await client.listEntitlements()
+     *         return new Map(entitlements.map(e => [e.id, e.name]))
+     *     },
+     *     600,
+     * )
+     * ```
+     */
+    fetch<T = any>(key: string, factory: () => Promise<T>, ttlSeconds?: number): Promise<T>;
+    /**
+     * Remove a key from the cache.
+     * @param key Cache key
+     */
+    delete(key: string): boolean;
+    /**
+     * Remove all entries from the cache. By default, only clears user entries and
+     * preserves internal SDK entries. Pass `true` to clear everything.
+     * @param includeInternal If true, also clears internal SDK cache entries
+     */
+    clear(includeInternal?: boolean): void;
+    /**
+     * Get the number of entries currently in the cache (including expired but not yet evicted).
+     */
+    get size(): number;
+    private validateUserKey;
+}
+/**
+ * Module-level singleton cache instance. Persists across warm invocations in Lambda-like environments.
+ */
+export declare const connectorCache: ConnectorCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../lib/cache.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,gBAAgB,WAAW,CAAA;AAOxC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D;;;OAGG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAYxC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9D;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAwB7F;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;OAIG;IACH,KAAK,CAAC,eAAe,GAAE,OAAe,GAAG,IAAI;IAY7C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,eAAe;CAKvB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAA"}

package/dist/lib/cache.js

@@ -0,0 +1,152 @@
+"use strict";
+/* Copyright (c) 2021. SailPoint Technologies, Inc. All rights reserved. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectorCache = exports.ConnectorCache = exports.SDK_CACHE_PREFIX = void 0;
+/**
+ * Key prefix reserved for internal SDK use. User keys must not start with this prefix.
+ */
+exports.SDK_CACHE_PREFIX = '__sdk:';
+/**
+ * A general-purpose in-memory cache with TTL support.
+ *
+ * Because connectors run in a Lambda-like environment where module-level state persists
+ * across warm invocations, values stored in the cache remain available between requests
+ * as long as the container stays warm.
+ *
+ * The SDK uses this cache internally for auth token storage (with reserved keys prefixed
+ * by `__sdk:`). Connector developers can use it to cache any data that is expensive to
+ * fetch on every invocation.
+ *
+ * @example
+ * ```typescript
+ * import { connectorCache } from '@sailpoint/connector-sdk'
+ *
+ * // Cache an API response for 5 minutes using fetch()
+ * const users = await connectorCache.fetch('all-users', () => myClient.getUsers(), 300)
+ * ```
+ */
+class ConnectorCache {
+    constructor() {
+        this.store = new Map();
+        this.inflight = new Map();
+    }
+    /**
+     * Get a value from the cache. Returns `undefined` if the key does not exist or has expired.
+     * @param key Cache key
+     */
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (entry.expiresAt !== null && Date.now() >= entry.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Store a value in the cache.
+     * @param key Cache key (must not start with `__sdk:` — that prefix is reserved for internal use)
+     * @param value Value to cache
+     * @param ttlSeconds Time-to-live in seconds. If omitted, the entry never expires.
+     */
+    set(key, value, ttlSeconds) {
+        if (!key.startsWith(exports.SDK_CACHE_PREFIX)) {
+            this.validateUserKey(key);
+        }
+        const expiresAt = ttlSeconds != null ? Date.now() + ttlSeconds * 1000 : null;
+        this.store.set(key, { value, expiresAt });
+    }
+    /**
+     * Check whether a key exists and has not expired.
+     * @param key Cache key
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Return the cached value for `key`, or compute and store it if absent.
+     *
+     * If the key is not in the cache (or has expired), `factory` is called once to produce
+     * the value, which is then stored with the given TTL. Concurrent calls with the same key
+     * are deduplicated — only one `factory` invocation runs, and all callers receive the
+     * same result.
+     *
+     * @param key Cache key
+     * @param factory Async function that produces the value when the cache is empty
+     * @param ttlSeconds Time-to-live in seconds. If omitted, the entry never expires.
+     *
+     * @example
+     * ```typescript
+     * const entitlementMap = await connectorCache.fetch(
+     *     'entitlement-map',
+     *     async () => {
+     *         const entitlements = await client.listEntitlements()
+     *         return new Map(entitlements.map(e => [e.id, e.name]))
+     *     },
+     *     600,
+     * )
+     * ```
+     */
+    async fetch(key, factory, ttlSeconds) {
+        const cached = this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const existing = this.inflight.get(key);
+        if (existing) {
+            return existing;
+        }
+        const promise = factory().then((value) => {
+            this.set(key, value, ttlSeconds);
+            this.inflight.delete(key);
+            return value;
+        }).catch((err) => {
+            this.inflight.delete(key);
+            throw err;
+        });
+        this.inflight.set(key, promise);
+        return promise;
+    }
+    /**
+     * Remove a key from the cache.
+     * @param key Cache key
+     */
+    delete(key) {
+        return this.store.delete(key);
+    }
+    /**
+     * Remove all entries from the cache. By default, only clears user entries and
+     * preserves internal SDK entries. Pass `true` to clear everything.
+     * @param includeInternal If true, also clears internal SDK cache entries
+     */
+    clear(includeInternal = false) {
+        if (includeInternal) {
+            this.store.clear();
+            return;
+        }
+        for (const key of Array.from(this.store.keys())) {
+            if (!key.startsWith(exports.SDK_CACHE_PREFIX)) {
+                this.store.delete(key);
+            }
+        }
+    }
+    /**
+     * Get the number of entries currently in the cache (including expired but not yet evicted).
+     */
+    get size() {
+        return this.store.size;
+    }
+    validateUserKey(key) {
+        if (key.startsWith(exports.SDK_CACHE_PREFIX)) {
+            throw new Error(`Cache keys starting with "${exports.SDK_CACHE_PREFIX}" are reserved for internal SDK use`);
+        }
+    }
+}
+exports.ConnectorCache = ConnectorCache;
+/**
+ * Module-level singleton cache instance. Persists across warm invocations in Lambda-like environments.
+ */
+exports.connectorCache = new ConnectorCache();
+//# sourceMappingURL=cache.js.map

package/dist/lib/cache.js.map

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

package/dist/lib/data-store.d.ts

@@ -0,0 +1,102 @@
+import { Response } from './response';
+import { Context } from './connector-handler';
+/**
+ * A persistent key-value data store backed by source config attributes.
+ *
+ * Provides a simple API to read and write values that persist across connector invocations.
+ * Under the hood, changes are sent via `patchConfig` as JSON Patch operations targeting
+ * `/<key>` directly. Only changed values are patched — if a value is set to the same thing
+ * it was before, no patch is emitted.
+ *
+ * During long aggregations, call `reload(context)` to pick up config changes that occurred
+ * mid-run (including values written by a previous `flush()` call in the same invocation).
+ *
+ * @example
+ * ```typescript
+ * import { createConnectorDataStore, readConfig } from '@sailpoint/connector-sdk'
+ *
+ * // Inside a command handler:
+ * async (context, input, res) => {
+ *     const config = await readConfig()
+ *     const dataStore = createConnectorDataStore(config, res)
+ *
+ *     // Read a previously stored value
+ *     const lastSync = dataStore.get<string>('lastSyncTimestamp')
+ *
+ *     // Fetch data since last sync...
+ *     const data = await fetchDataSince(lastSync)
+ *
+ *     // Store the new timestamp (only patched if different)
+ *     dataStore.set('lastSyncTimestamp', new Date().toISOString())
+ *
+ *     // Send all accumulated changes
+ *     dataStore.flush()
+ * }
+ * ```
+ */
+export declare class ConnectorDataStore {
+    private config;
+    private readonly res;
+    private readonly pending;
+    constructor(config: Record<string, any>, res: Response<any>);
+    /**
+     * Get a value from the config.
+     * Returns the pending value if one has been set, otherwise the original config value.
+     * @param key Attribute key
+     */
+    get<T = any>(key: string): T | undefined;
+    /**
+     * Set a value in the config. The change is buffered until `flush()` is called.
+     * If the value is identical to the current stored value, no patch will be emitted.
+     * @param key Attribute key
+     * @param value Value to store (must be JSON-serializable)
+     */
+    set(key: string, value: any): void;
+    /**
+     * Remove a key from the config. The change is buffered until `flush()` is called.
+     * If the key doesn't exist, no patch will be emitted.
+     * @param key Attribute key to remove
+     */
+    delete(key: string): void;
+    /**
+     * Returns true if there are pending changes that haven't been flushed yet.
+     */
+    get hasPendingChanges(): boolean;
+    /**
+     * Send all accumulated changes as a single `patchConfig` call.
+     * Only emits patches for values that differ from the current config.
+     * After flushing, the local config is updated to reflect the sent patches so that
+     * subsequent `set()` calls in the same invocation use the correct baseline for
+     * change detection.
+     */
+    flush(): void;
+    /**
+     * Reload the connector config from ISC via the command context and update the data
+     * store's baseline. Call this during long aggregations to pick up config changes that
+     * occurred mid-run — for example, values written by a previous `flush()` call or
+     * updates made externally.
+     *
+     * Pending changes are preserved across a reload.
+     *
+     * @param context The command context passed to the handler
+     *
+     * @example
+     * ```typescript
+     * // Flush a batch of changes, then reload so the next batch uses the updated baseline
+     * dataStore.set('cursor', nextCursor)
+     * dataStore.flush()
+     * await dataStore.reload(context)
+     * ```
+     */
+    reload(context: Context): Promise<void>;
+    private deepEqual;
+}
+/**
+ * Creates a persistent data store backed by source config attributes.
+ *
+ * @param config The connector config object (from `readConfig()`)
+ * @param res The response object from the current command handler
+ * @returns A ConnectorDataStore instance
+ */
+export declare function createConnectorDataStore(config: Record<string, any>, res: Response<any>): ConnectorDataStore;
+//# sourceMappingURL=data-store.d.ts.map

package/dist/lib/data-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-store.d.ts","sourceRoot":"","sources":["../../lib/data-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;gBAEvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC;IAK3D;;;;OAIG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQxC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IASlC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzB;;OAEG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;IAyCb;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,OAAO,CAAC,SAAS;CAOjB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAE5G"}

package/dist/lib/data-store.js

@@ -0,0 +1,178 @@
+"use strict";
+/* Copyright (c) 2021. SailPoint Technologies, Inc. All rights reserved. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnectorDataStore = exports.ConnectorDataStore = void 0;
+const response_1 = require("./response");
+const logger_1 = require("./logger");
+/**
+ * A persistent key-value data store backed by source config attributes.
+ *
+ * Provides a simple API to read and write values that persist across connector invocations.
+ * Under the hood, changes are sent via `patchConfig` as JSON Patch operations targeting
+ * `/<key>` directly. Only changed values are patched — if a value is set to the same thing
+ * it was before, no patch is emitted.
+ *
+ * During long aggregations, call `reload(context)` to pick up config changes that occurred
+ * mid-run (including values written by a previous `flush()` call in the same invocation).
+ *
+ * @example
+ * ```typescript
+ * import { createConnectorDataStore, readConfig } from '@sailpoint/connector-sdk'
+ *
+ * // Inside a command handler:
+ * async (context, input, res) => {
+ *     const config = await readConfig()
+ *     const dataStore = createConnectorDataStore(config, res)
+ *
+ *     // Read a previously stored value
+ *     const lastSync = dataStore.get<string>('lastSyncTimestamp')
+ *
+ *     // Fetch data since last sync...
+ *     const data = await fetchDataSince(lastSync)
+ *
+ *     // Store the new timestamp (only patched if different)
+ *     dataStore.set('lastSyncTimestamp', new Date().toISOString())
+ *
+ *     // Send all accumulated changes
+ *     dataStore.flush()
+ * }
+ * ```
+ */
+class ConnectorDataStore {
+    constructor(config, res) {
+        this.pending = new Map();
+        this.config = config;
+        this.res = res;
+    }
+    /**
+     * Get a value from the config.
+     * Returns the pending value if one has been set, otherwise the original config value.
+     * @param key Attribute key
+     */
+    get(key) {
+        const pendingEntry = this.pending.get(key);
+        if (pendingEntry) {
+            return pendingEntry.op === 'delete' ? undefined : pendingEntry.value;
+        }
+        return this.config?.[key];
+    }
+    /**
+     * Set a value in the config. The change is buffered until `flush()` is called.
+     * If the value is identical to the current stored value, no patch will be emitted.
+     * @param key Attribute key
+     * @param value Value to store (must be JSON-serializable)
+     */
+    set(key, value) {
+        const current = this.config?.[key];
+        if (this.deepEqual(current, value)) {
+            this.pending.delete(key);
+            return;
+        }
+        this.pending.set(key, { op: 'set', value });
+    }
+    /**
+     * Remove a key from the config. The change is buffered until `flush()` is called.
+     * If the key doesn't exist, no patch will be emitted.
+     * @param key Attribute key to remove
+     */
+    delete(key) {
+        const exists = this.config?.hasOwnProperty(key);
+        if (!exists && !this.pending.has(key)) {
+            return;
+        }
+        this.pending.set(key, { op: 'delete' });
+    }
+    /**
+     * Returns true if there are pending changes that haven't been flushed yet.
+     */
+    get hasPendingChanges() {
+        return this.pending.size > 0;
+    }
+    /**
+     * Send all accumulated changes as a single `patchConfig` call.
+     * Only emits patches for values that differ from the current config.
+     * After flushing, the local config is updated to reflect the sent patches so that
+     * subsequent `set()` calls in the same invocation use the correct baseline for
+     * change detection.
+     */
+    flush() {
+        if (this.pending.size === 0) {
+            return;
+        }
+        const log = logger_1.logger.child({ component: 'data-store' });
+        log.debug({ config: this.config ?? null }, 'data-store flush: config baseline');
+        const patches = [];
+        for (const [key, entry] of this.pending) {
+            if (entry.op === 'delete') {
+                patches.push({ op: response_1.PatchOp.Remove, path: `/${key}` });
+            }
+            else {
+                const existed = this.config?.hasOwnProperty(key);
+                patches.push({
+                    op: existed ? response_1.PatchOp.Replace : response_1.PatchOp.Add,
+                    path: `/${key}`,
+                    value: entry.value,
+                });
+            }
+        }
+        log.debug({ patches }, 'data-store flush: sending patches');
+        if (patches.length > 0) {
+            this.res.patchConfig(patches);
+        }
+        // Update the local config baseline so subsequent set() calls detect no change
+        for (const [key, entry] of this.pending) {
+            if (entry.op === 'delete') {
+                delete this.config[key];
+            }
+            else {
+                this.config[key] = entry.value;
+            }
+        }
+        this.pending.clear();
+    }
+    /**
+     * Reload the connector config from ISC via the command context and update the data
+     * store's baseline. Call this during long aggregations to pick up config changes that
+     * occurred mid-run — for example, values written by a previous `flush()` call or
+     * updates made externally.
+     *
+     * Pending changes are preserved across a reload.
+     *
+     * @param context The command context passed to the handler
+     *
+     * @example
+     * ```typescript
+     * // Flush a batch of changes, then reload so the next batch uses the updated baseline
+     * dataStore.set('cursor', nextCursor)
+     * dataStore.flush()
+     * await dataStore.reload(context)
+     * ```
+     */
+    async reload(context) {
+        this.config = await context.reloadConfig();
+    }
+    deepEqual(a, b) {
+        if (a === b)
+            return true;
+        if (a == null || b == null)
+            return false;
+        if (typeof a !== typeof b)
+            return false;
+        if (typeof a !== 'object')
+            return false;
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+}
+exports.ConnectorDataStore = ConnectorDataStore;
+/**
+ * Creates a persistent data store backed by source config attributes.
+ *
+ * @param config The connector config object (from `readConfig()`)
+ * @param res The response object from the current command handler
+ * @returns A ConnectorDataStore instance
+ */
+function createConnectorDataStore(config, res) {
+    return new ConnectorDataStore(config, res);
+}
+exports.createConnectorDataStore = createConnectorDataStore;
+//# sourceMappingURL=data-store.js.map

package/dist/lib/data-store.js.map

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

package/dist/lib/http-client.d.ts

@@ -0,0 +1,195 @@
+import { AxiosInstance, CreateAxiosDefaults } from 'axios';
+export type { AxiosInstance } from 'axios';
+/**
+ * Basic authentication using username and password
+ */
+export interface BasicAuth {
+    type: 'basic';
+    username: string;
+    password: string;
+}
+/**
+ * Bearer token authentication using a static token
+ */
+export interface BearerTokenAuth {
+    type: 'bearer';
+    token: string;
+}
+/**
+ * API key authentication sent as a header or query parameter
+ */
+export interface ApiKeyAuth {
+    type: 'apiKey';
+    /**
+     * Where to send the API key: 'header' or 'query'
+     */
+    in: 'header' | 'query';
+    /**
+     * Name of the header or query parameter (e.g. 'X-API-Key', 'api_key')
+     */
+    name: string;
+    value: string;
+}
+/**
+ * OAuth2 Client Credentials grant. Automatically fetches and refreshes access tokens.
+ */
+export interface OAuth2ClientCredentialsAuth {
+    type: 'oauth2ClientCredentials';
+    /**
+     * Token endpoint URL (e.g. 'https://auth.example.com/oauth/token')
+     */
+    tokenUrl: string;
+    clientId: string;
+    clientSecret: string;
+    /**
+     * Optional scopes to request
+     */
+    scope?: string;
+    /**
+     * How to send credentials: 'body' (form post) or 'header' (Basic auth header).
+     * Defaults to 'body'.
+     */
+    credentialPlacement?: 'body' | 'header';
+}
+export type AuthConfig = BasicAuth | BearerTokenAuth | ApiKeyAuth | OAuth2ClientCredentialsAuth;
+/**
+ * Configuration for automatic request retry with exponential backoff.
+ */
+export interface RetryConfig {
+    /**
+     * Maximum number of retry attempts. Set to 0 to disable retries.
+     * Default: 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay in milliseconds for exponential backoff. The actual delay is
+     * `baseDelay * 2^(attempt - 1)` plus jitter.
+     * Default: 1000
+     */
+    baseDelay?: number;
+    /**
+     * Maximum delay in milliseconds between retries.
+     * Default: 30000
+     */
+    maxDelay?: number;
+    /**
+     * HTTP status codes that should trigger a retry.
+     * Default: [429, 500, 502, 503, 504]
+     */
+    retryableStatusCodes?: number[];
+    /**
+     * Whether to retry on network errors (no response received).
+     * Default: true
+     */
+    retryOnNetworkError?: boolean;
+}
+/**
+ * Options for creating a connector HTTP client
+ */
+export interface HttpClientOptions {
+    /**
+     * Base URL for all requests (e.g. 'https://api.example.com/v1')
+     */
+    baseURL?: string;
+    /**
+     * Default headers to include on every request
+     */
+    headers?: Record<string, string>;
+    /**
+     * Request timeout in milliseconds (default: 30000)
+     */
+    timeout?: number;
+    /**
+     * Authentication configuration. Supports basic, bearer, apiKey, and oauth2ClientCredentials.
+     */
+    auth?: AuthConfig;
+    /**
+     * Retry configuration. Enabled by default with 3 retries and exponential backoff.
+     * Set to `false` to disable retries entirely.
+     */
+    retry?: RetryConfig | false;
+    /**
+     * Additional Axios configuration options
+     */
+    axiosOptions?: CreateAxiosDefaults;
+}
+/**
+ * Parses the Retry-After header value into milliseconds to wait.
+ * Supports both seconds (integer) and HTTP-date formats.
+ * Returns undefined if the header is missing or unparseable.
+ */
+export declare function parseRetryAfter(headerValue: string | undefined | null): number | undefined;
+/**
+ * Calculates the delay for a retry attempt using exponential backoff with jitter.
+ */
+export declare function calculateRetryDelay(attempt: number, baseDelay: number, maxDelay: number): number;
+/**
+ * Creates a pre-configured Axios HTTP client instance for use within connectors.
+ *
+ * The client includes:
+ * - Configurable base URL, headers, and timeout
+ * - Built-in authentication (basic, bearer, apiKey, oauth2ClientCredentials)
+ * - Automatic retry with exponential backoff (429, 5xx, network errors)
+ * - Token caching via the shared `connectorCache` (persists across warm invocations)
+ * - Request/response logging via the SDK's pino logger
+ * - Error logging for failed requests
+ *
+ * @example Basic auth
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: { type: 'basic', username: config.username, password: config.password },
+ * })
+ * ```
+ *
+ * @example Bearer token
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: { type: 'bearer', token: config.token },
+ * })
+ * ```
+ *
+ * @example API key
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: { type: 'apiKey', in: 'header', name: 'X-API-Key', value: config.apiKey },
+ * })
+ * ```
+ *
+ * @example OAuth2 Client Credentials (automatic token management)
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: {
+ *         type: 'oauth2ClientCredentials',
+ *         tokenUrl: config.tokenUrl,
+ *         clientId: config.clientId,
+ *         clientSecret: config.clientSecret,
+ *         scope: 'read write',
+ *     },
+ * })
+ * ```
+ *
+ * @example Custom retry configuration
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     retry: { maxRetries: 5, baseDelay: 2000 },
+ * })
+ * ```
+ *
+ * @example Disable retries
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     retry: false,
+ * })
+ * ```
+ *
+ * @param options Configuration options for the HTTP client
+ * @returns A configured Axios instance
+ */
+export declare function createConnectorHttpClient(options?: HttpClientOptions): AxiosInstance;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/lib/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../lib/http-client.ts"],"names":[],"mappings":"AAEA,OAAc,EAAc,aAAa,EAAE,mBAAmB,EAA8B,MAAM,OAAO,CAAA;AAIzG,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAW1C;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd;;OAEG;IACH,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAA;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,IAAI,EAAE,yBAAyB,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CACvC;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,GAAG,2BAA2B,CAAA;AAE/F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAA;CAClC;AAoFD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAmB1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIhG;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,iBAAsB,GAAG,aAAa,CA6JxF"}

package/dist/lib/http-client.js

@@ -0,0 +1,312 @@
+"use strict";
+/* Copyright (c) 2021. SailPoint Technologies, Inc. All rights reserved. */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnectorHttpClient = exports.calculateRetryDelay = exports.parseRetryAfter = void 0;
+const axios_1 = __importDefault(require("axios"));
+const logger_1 = require("./logger");
+const cache_1 = require("./cache");
+/** Cache key prefix for auth tokens */
+const AUTH_CACHE_PREFIX = `${cache_1.SDK_CACHE_PREFIX}auth:`;
+/** Custom config property to track retry count */
+const RETRY_COUNT_KEY = '__retryCount';
+/** Default status codes that trigger a retry */
+const DEFAULT_RETRYABLE_STATUS_CODES = [429, 500, 502, 503, 504];
+/**
+ * Builds a deterministic cache key from the auth config so that the same credentials
+ * always resolve to the same cached token, even across multiple `createConnectorHttpClient` calls.
+ */
+function authCacheKey(auth) {
+    switch (auth.type) {
+        case 'oauth2ClientCredentials':
+            return `${AUTH_CACHE_PREFIX}oauth2:${auth.tokenUrl}:${auth.clientId}`;
+        default:
+            return `${AUTH_CACHE_PREFIX}${auth.type}`;
+    }
+}
+// Tracks in-flight token fetches to deduplicate concurrent requests
+const inflightTokenRequests = new Map();
+/**
+ * Fetches an OAuth2 Client Credentials token, using the shared cache and deduplicating
+ * concurrent requests.
+ */
+async function getOAuth2Token(config, cacheKey, log) {
+    // Check the shared cache first
+    const cached = cache_1.connectorCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    // Deduplicate concurrent token requests
+    const inflight = inflightTokenRequests.get(cacheKey);
+    if (inflight) {
+        return inflight;
+    }
+    const promise = fetchOAuth2Token(config, cacheKey, log);
+    inflightTokenRequests.set(cacheKey, promise);
+    try {
+        return await promise;
+    }
+    finally {
+        inflightTokenRequests.delete(cacheKey);
+    }
+}
+async function fetchOAuth2Token(config, cacheKey, log) {
+    log.debug({ tokenUrl: config.tokenUrl }, 'Fetching OAuth2 access token');
+    const params = new URLSearchParams();
+    params.append('grant_type', 'client_credentials');
+    if (config.scope) {
+        params.append('scope', config.scope);
+    }
+    const headers = {
+        'Content-Type': 'application/x-www-form-urlencoded',
+    };
+    if (config.credentialPlacement === 'header') {
+        const encoded = Buffer.from(`${config.clientId}:${config.clientSecret}`).toString('base64');
+        headers['Authorization'] = `Basic ${encoded}`;
+    }
+    else {
+        params.append('client_id', config.clientId);
+        params.append('client_secret', config.clientSecret);
+    }
+    const response = await axios_1.default.post(config.tokenUrl, params.toString(), { headers });
+    const { access_token, expires_in } = response.data;
+    // Cache with TTL. Use a 30s buffer so the token is refreshed before it actually expires.
+    const ttlSeconds = Math.max((expires_in || 3600) - 30, 0);
+    cache_1.connectorCache.set(cacheKey, access_token, ttlSeconds);
+    log.debug({ expiresIn: expires_in }, 'OAuth2 access token acquired');
+    return access_token;
+}
+/**
+ * Parses the Retry-After header value into milliseconds to wait.
+ * Supports both seconds (integer) and HTTP-date formats.
+ * Returns undefined if the header is missing or unparseable.
+ */
+function parseRetryAfter(headerValue) {
+    if (!headerValue) {
+        return undefined;
+    }
+    // Try parsing as integer seconds
+    const seconds = Number(headerValue);
+    if (!isNaN(seconds) && seconds >= 0) {
+        return seconds * 1000;
+    }
+    // Try parsing as HTTP-date
+    const date = new Date(headerValue);
+    if (!isNaN(date.getTime())) {
+        const delay = date.getTime() - Date.now();
+        return Math.max(delay, 0);
+    }
+    return undefined;
+}
+exports.parseRetryAfter = parseRetryAfter;
+/**
+ * Calculates the delay for a retry attempt using exponential backoff with jitter.
+ */
+function calculateRetryDelay(attempt, baseDelay, maxDelay) {
+    const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+    const jitter = Math.random() * baseDelay * 0.5;
+    return Math.min(exponentialDelay + jitter, maxDelay);
+}
+exports.calculateRetryDelay = calculateRetryDelay;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Creates a pre-configured Axios HTTP client instance for use within connectors.
+ *
+ * The client includes:
+ * - Configurable base URL, headers, and timeout
+ * - Built-in authentication (basic, bearer, apiKey, oauth2ClientCredentials)
+ * - Automatic retry with exponential backoff (429, 5xx, network errors)
+ * - Token caching via the shared `connectorCache` (persists across warm invocations)
+ * - Request/response logging via the SDK's pino logger
+ * - Error logging for failed requests
+ *
+ * @example Basic auth
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: { type: 'basic', username: config.username, password: config.password },
+ * })
+ * ```
+ *
+ * @example Bearer token
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: { type: 'bearer', token: config.token },
+ * })
+ * ```
+ *
+ * @example API key
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: { type: 'apiKey', in: 'header', name: 'X-API-Key', value: config.apiKey },
+ * })
+ * ```
+ *
+ * @example OAuth2 Client Credentials (automatic token management)
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     auth: {
+ *         type: 'oauth2ClientCredentials',
+ *         tokenUrl: config.tokenUrl,
+ *         clientId: config.clientId,
+ *         clientSecret: config.clientSecret,
+ *         scope: 'read write',
+ *     },
+ * })
+ * ```
+ *
+ * @example Custom retry configuration
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     retry: { maxRetries: 5, baseDelay: 2000 },
+ * })
+ * ```
+ *
+ * @example Disable retries
+ * ```typescript
+ * const httpClient = createConnectorHttpClient({
+ *     baseURL: config.apiUrl,
+ *     retry: false,
+ * })
+ * ```
+ *
+ * @param options Configuration options for the HTTP client
+ * @returns A configured Axios instance
+ */
+function createConnectorHttpClient(options = {}) {
+    const { baseURL, headers, timeout = 30000, auth, retry, axiosOptions = {} } = options;
+    const client = axios_1.default.create({
+        ...axiosOptions,
+        baseURL,
+        timeout,
+        headers: {
+            ...axiosOptions.headers,
+            ...headers,
+        },
+    });
+    const log = logger_1.logger.child({ component: 'http-client' });
+    // Set up authentication interceptor
+    if (auth) {
+        switch (auth.type) {
+            case 'basic': {
+                const encoded = Buffer.from(`${auth.username}:${auth.password}`).toString('base64');
+                client.interceptors.request.use((config) => {
+                    config.headers.set('Authorization', `Basic ${encoded}`);
+                    return config;
+                });
+                break;
+            }
+            case 'bearer': {
+                client.interceptors.request.use((config) => {
+                    config.headers.set('Authorization', `Bearer ${auth.token}`);
+                    return config;
+                });
+                break;
+            }
+            case 'apiKey': {
+                client.interceptors.request.use((config) => {
+                    if (auth.in === 'header') {
+                        config.headers.set(auth.name, auth.value);
+                    }
+                    else {
+                        config.params = { ...config.params, [auth.name]: auth.value };
+                    }
+                    return config;
+                });
+                break;
+            }
+            case 'oauth2ClientCredentials': {
+                const cacheKey = authCacheKey(auth);
+                client.interceptors.request.use(async (config) => {
+                    const token = await getOAuth2Token(auth, cacheKey, log);
+                    config.headers.set('Authorization', `Bearer ${token}`);
+                    return config;
+                });
+                break;
+            }
+        }
+    }
+    // Logging interceptors
+    client.interceptors.request.use((config) => {
+        log.debug({ method: config.method?.toUpperCase(), url: config.url, baseURL: config.baseURL }, 'HTTP request');
+        return config;
+    }, (error) => {
+        log.error({ error: error.message }, 'HTTP request error');
+        return Promise.reject(error);
+    });
+    client.interceptors.response.use((response) => {
+        log.debug({ method: response.config.method?.toUpperCase(), url: response.config.url, status: response.status }, 'HTTP response');
+        return response;
+    }, (error) => {
+        if (error.response) {
+            log.error({
+                method: error.config?.method?.toUpperCase(),
+                url: error.config?.url,
+                status: error.response.status,
+            }, 'HTTP response error');
+        }
+        else {
+            log.error({ message: error.message }, 'HTTP request failed');
+        }
+        return Promise.reject(error);
+    });
+    // Retry interceptor (added after logging so retries are logged)
+    if (retry !== false) {
+        const retryConfig = {
+            maxRetries: retry?.maxRetries ?? 3,
+            baseDelay: retry?.baseDelay ?? 1000,
+            maxDelay: retry?.maxDelay ?? 30000,
+            retryableStatusCodes: retry?.retryableStatusCodes ?? DEFAULT_RETRYABLE_STATUS_CODES,
+            retryOnNetworkError: retry?.retryOnNetworkError ?? true,
+        };
+        client.interceptors.response.use(undefined, async (error) => {
+            const config = error.config;
+            if (!config) {
+                return Promise.reject(error);
+            }
+            const retryCount = config[RETRY_COUNT_KEY] || 0;
+            if (retryCount >= retryConfig.maxRetries) {
+                return Promise.reject(error);
+            }
+            const status = error.response?.status;
+            const isRetryable = status
+                ? retryConfig.retryableStatusCodes.includes(status)
+                : retryConfig.retryOnNetworkError && !error.response;
+            if (!isRetryable) {
+                return Promise.reject(error);
+            }
+            const attempt = retryCount + 1;
+            // For 429, prefer Retry-After header
+            let delay;
+            if (status === 429) {
+                const retryAfterHeader = error.response?.headers?.['retry-after'];
+                const retryAfterMs = parseRetryAfter(retryAfterHeader);
+                delay = retryAfterMs ?? calculateRetryDelay(attempt, retryConfig.baseDelay, retryConfig.maxDelay);
+            }
+            else {
+                delay = calculateRetryDelay(attempt, retryConfig.baseDelay, retryConfig.maxDelay);
+            }
+            log.info({
+                attempt,
+                maxRetries: retryConfig.maxRetries,
+                status,
+                delay: Math.round(delay),
+                url: config.url,
+            }, 'Retrying request');
+            config[RETRY_COUNT_KEY] = attempt;
+            await sleep(delay);
+            return client.request(config);
+        });
+    }
+    return client;
+}
+exports.createConnectorHttpClient = createConnectorHttpClient;
+//# sourceMappingURL=http-client.js.map

package/dist/lib/http-client.js.map

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

package/dist/lib/index.d.ts

@@ -10,4 +10,7 @@ export * from './logger';
 export * from './partitionAdapter';
 export * from './filter';
 export * from './unescape';
+export * from './cache';
+export * from './data-store';
+export * from './http-client';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/lib/index.js

@@ -27,4 +27,7 @@ __exportStar(require("./logger"), exports);
 __exportStar(require("./partitionAdapter"), exports);
 __exportStar(require("./filter"), exports);
 __exportStar(require("./unescape"), exports);
+__exportStar(require("./cache"), exports);
+__exportStar(require("./data-store"), exports);
+__exportStar(require("./http-client"), exports);
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";AAAA,2EAA2E;;;;;;;;;;;;;;;;AAE3E,6CAA0B;AAC1B,2CAAwB;AACxB,8CAA2B;AAC3B,yDAAsC;AACtC,0CAAuB;AACvB,sDAAmC;AACnC,iEAA8C;AAC9C,6CAA0B;AAC1B,2CAAwB;AACxB,qDAAkC;AAClC,2CAAyB;AACzB,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";AAAA,2EAA2E;;;;;;;;;;;;;;;;AAE3E,6CAA0B;AAC1B,2CAAwB;AACxB,8CAA2B;AAC3B,yDAAsC;AACtC,0CAAuB;AACvB,sDAAmC;AACnC,iEAA8C;AAC9C,6CAA0B;AAC1B,2CAAwB;AACxB,qDAAkC;AAClC,2CAAyB;AACzB,6CAA2B;AAC3B,0CAAwB;AACxB,+CAA6B;AAC7B,gDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sailpoint/connector-sdk",
-	"version": "1.1.41",
+	"version": "1.2.1",
 	"description": "JavaScript framework to build SailPoint Connectors",
 	"author": "SailPoint Technologies, Inc.",
 	"license": "Copyright (c) 2023. SailPoint Technologies, Inc. All rights reserved.",
@@ -29,6 +29,7 @@
 	},
 	"dependencies": {
 		"archiver": "^7.0.1",
+		"axios": "^1.14.0",
 		"debug": "^4.4.1",
 		"express": "^5.2.1",
 		"jsep": "^1.4.0",