@pendo/openfeature-web-provider 0.1.0

package/README.md

@@ -0,0 +1,175 @@
+# @pendo/openfeature-web-provider
+
+OpenFeature provider for [Pendo](https://www.pendo.io/) feature flags in web browsers.
+
+## Installation
+
+```bash
+npm install @pendo/openfeature-web-provider @openfeature/web-sdk
+```
+
+## Prerequisites
+
+The Pendo agent must be installed on your page. The provider reads flags from `window.pendo.segmentFlags` which is populated by the agent.
+
+```html
+<script>
+  (function(apiKey){
+    // Pendo agent snippet
+    // ...
+  })('YOUR_PENDO_API_KEY');
+</script>
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { OpenFeature } from '@openfeature/web-sdk';
+import { PendoProvider } from '@pendo/openfeature-web-provider';
+
+// Initialize the provider (waits for Pendo agent to be ready)
+await OpenFeature.setProviderAndWait(new PendoProvider());
+
+// Get a client
+const client = OpenFeature.getClient();
+```
+
+### Evaluating Flags
+
+```typescript
+// Boolean flag
+const showNewFeature = await client.getBooleanValue('new-checkout-flow', false);
+
+// String flag (returns "on" or "off")
+const variant = await client.getStringValue('checkout-variant', 'control');
+
+// Number flag (returns 1 or 0)
+const flagValue = await client.getNumberValue('feature-score', 0);
+
+// Object flag (returns { enabled: true/false })
+const config = await client.getObjectValue('feature-config', { enabled: false });
+```
+
+### Event Tracking
+
+Track custom events to Pendo:
+
+```typescript
+const provider = new PendoProvider();
+await OpenFeature.setProviderAndWait(provider);
+
+// Track an event
+provider.track('checkout_started', undefined, { cartValue: '99.99' });
+
+// The context parameter is ignored in the web provider
+// since the Pendo agent already knows the current visitor
+provider.track('feature_used');
+```
+
+### Telemetry Hook
+
+Automatically track all flag evaluations to Pendo using the telemetry hook:
+
+```typescript
+import { OpenFeature } from '@openfeature/web-sdk';
+import { PendoProvider, PendoTelemetryHook } from '@pendo/openfeature-web-provider';
+
+const provider = new PendoProvider();
+const telemetryHook = new PendoTelemetryHook();
+
+await OpenFeature.setProviderAndWait(provider);
+OpenFeature.addHooks(telemetryHook);
+```
+
+#### Telemetry Hook Options
+
+```typescript
+const telemetryHook = new PendoTelemetryHook({
+  // Optional: Custom event name (default: "flag_evaluated")
+  eventName: 'feature_flag_evaluated',
+
+  // Optional: Filter which flags to track
+  flagFilter: (flagKey) => flagKey.startsWith('feature_'),
+});
+```
+
+#### Event Payload
+
+Each flag evaluation sends a track event with these properties:
+
+| Property | Description |
+|----------|-------------|
+| `flag_key` | The flag that was evaluated |
+| `flag_variant` | "on", "off", or variant name |
+| `flag_reason` | "TARGETING_MATCH", "DEFAULT", or "ERROR" |
+| `flag_value` | Stringified value |
+| `provider_name` | "pendo-provider" |
+
+### Configuration Options
+
+```typescript
+const provider = new PendoProvider({
+  // API key for Pendo initialization (optional if already initialized)
+  apiKey: 'YOUR_API_KEY',
+
+  // Timeout waiting for Pendo agent to be ready (default: 5000ms)
+  readyTimeout: 10000,
+});
+```
+
+## How It Works
+
+1. The provider waits for the Pendo agent to initialize
+2. Flag evaluation checks if the flag key exists in `window.pendo.segmentFlags`
+3. If the flag key is present, the flag is enabled; otherwise, it returns the default value
+
+## Context
+
+The web provider does not require explicit context for flag evaluation since the Pendo agent maintains visitor/account identity automatically. However, you can pass context for consistency with the OpenFeature API:
+
+```typescript
+const enabled = await client.getBooleanValue('my-flag', false, {
+  targetingKey: 'user-123',  // Ignored by web provider
+  accountId: 'account-456',  // Ignored by web provider
+});
+```
+
+## Resolution Details
+
+| Scenario | Reason | Variant |
+|----------|--------|---------|
+| Flag key in segmentFlags | `TARGETING_MATCH` | `on` |
+| Flag key not in segmentFlags | `DEFAULT` | `off` |
+| Pendo not ready | `DEFAULT` | `default` |
+
+## Troubleshooting
+
+### Flags always return default values
+
+1. Check that the Pendo agent is properly installed and initialized
+2. Verify the visitor is in a segment that has the flag enabled
+3. Check browser console for `[PendoProvider]` warnings
+
+### Provider times out
+
+Increase the `readyTimeout` option:
+
+```typescript
+new PendoProvider({ readyTimeout: 15000 });
+```
+
+### Track events not appearing
+
+Ensure the Pendo agent's `track` function is available:
+
+```typescript
+if (window.pendo?.track) {
+  provider.track('my-event');
+}
+```
+
+## License
+
+MIT

package/dist/PendoProvider.d.ts

@@ -0,0 +1,102 @@
+import type { Provider, ProviderMetadata, ResolutionDetails, EvaluationContext, JsonValue, Hook, TrackingEventDetails } from "@openfeature/web-sdk";
+import { ClientProviderStatus } from "@openfeature/web-sdk";
+declare global {
+    interface Window {
+        pendo?: {
+            segmentFlags?: string[];
+            isReady?: () => boolean;
+            initialize?: (options: unknown) => void;
+            track?: (event: string, properties?: Record<string, string>) => void;
+        };
+    }
+}
+export interface PendoProviderOptions {
+    /**
+     * Optional: Pendo API key for initialization.
+     * If not provided, assumes Pendo is already initialized on the page.
+     */
+    apiKey?: string;
+    /**
+     * Optional: Timeout in milliseconds to wait for Pendo to be ready.
+     * Default: 5000ms
+     */
+    readyTimeout?: number;
+}
+/**
+ * OpenFeature provider for Pendo feature flags.
+ *
+ * This provider evaluates feature flags by checking the `pendo.segmentFlags` array
+ * which is populated by the Pendo agent based on segment membership.
+ *
+ * @example
+ * ```typescript
+ * import { OpenFeature } from '@openfeature/web-sdk';
+ * import { PendoProvider } from '@pendo/openfeature-web-provider';
+ *
+ * await OpenFeature.setProviderAndWait(new PendoProvider());
+ *
+ * const client = OpenFeature.getClient();
+ * const enabled = await client.getBooleanValue('myFeature', false);
+ * ```
+ */
+export declare class PendoProvider implements Provider {
+    readonly metadata: ProviderMetadata;
+    readonly rulesChanged?: () => void;
+    status: ClientProviderStatus;
+    hooks?: Hook[];
+    private options;
+    private readyPromise;
+    constructor(options?: PendoProviderOptions);
+    /**
+     * Initialize the provider.
+     * Waits for Pendo to be ready before resolving.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Wait for Pendo to be ready with timeout.
+     */
+    private waitForPendo;
+    /**
+     * Shutdown the provider.
+     */
+    onClose(): Promise<void>;
+    /**
+     * Resolve a boolean flag value.
+     *
+     * Checks if the flagKey exists in pendo.segmentFlags array.
+     */
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, _context: EvaluationContext): ResolutionDetails<boolean>;
+    /**
+     * Resolve a string flag value.
+     *
+     * For Pendo flags, this returns "on" if the flag is enabled, "off" otherwise.
+     */
+    resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): ResolutionDetails<string>;
+    /**
+     * Resolve a number flag value.
+     *
+     * For Pendo flags, this returns 1 if enabled, 0 if disabled.
+     */
+    resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext): ResolutionDetails<number>;
+    /**
+     * Resolve an object flag value.
+     *
+     * For Pendo flags, this returns { enabled: true/false }.
+     */
+    resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext): ResolutionDetails<T>;
+    /**
+     * Get the segment flags array from Pendo.
+     */
+    private getSegmentFlags;
+    /**
+     * Track a custom event in Pendo.
+     *
+     * This method delegates to the Pendo agent's track function.
+     * The Pendo agent must be initialized on the page for this to work.
+     *
+     * @param trackingEventName - The name of the event to track
+     * @param _context - Evaluation context (unused in web provider, Pendo agent handles visitor context)
+     * @param trackingEventDetails - Optional additional event properties
+     */
+    track(trackingEventName: string, _context: EvaluationContext, trackingEventDetails: TrackingEventDetails): void;
+}

package/dist/PendoProvider.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendoProvider = void 0;
+const web_sdk_1 = require("@openfeature/web-sdk");
+/**
+ * OpenFeature provider for Pendo feature flags.
+ *
+ * This provider evaluates feature flags by checking the `pendo.segmentFlags` array
+ * which is populated by the Pendo agent based on segment membership.
+ *
+ * @example
+ * ```typescript
+ * import { OpenFeature } from '@openfeature/web-sdk';
+ * import { PendoProvider } from '@pendo/openfeature-web-provider';
+ *
+ * await OpenFeature.setProviderAndWait(new PendoProvider());
+ *
+ * const client = OpenFeature.getClient();
+ * const enabled = await client.getBooleanValue('myFeature', false);
+ * ```
+ */
+class PendoProvider {
+    constructor(options = {}) {
+        this.metadata = {
+            name: "pendo-provider",
+        };
+        this.status = web_sdk_1.ClientProviderStatus.NOT_READY;
+        this.readyPromise = null;
+        this.options = {
+            readyTimeout: 5000,
+            ...options,
+        };
+    }
+    /**
+     * Initialize the provider.
+     * Waits for Pendo to be ready before resolving.
+     */
+    async initialize() {
+        if (this.readyPromise) {
+            return this.readyPromise;
+        }
+        this.readyPromise = this.waitForPendo();
+        await this.readyPromise;
+        this.status = web_sdk_1.ClientProviderStatus.READY;
+    }
+    /**
+     * Wait for Pendo to be ready with timeout.
+     */
+    async waitForPendo() {
+        const timeout = this.options.readyTimeout ?? 5000;
+        const startTime = Date.now();
+        return new Promise((resolve, reject) => {
+            const check = () => {
+                // Check if pendo is available and ready
+                if (typeof window !== "undefined" && window.pendo) {
+                    if (window.pendo.isReady?.() || window.pendo.segmentFlags !== undefined) {
+                        resolve();
+                        return;
+                    }
+                }
+                // Check timeout
+                if (Date.now() - startTime > timeout) {
+                    // Don't reject - just resolve and work without Pendo
+                    // Flags will default to false
+                    console.warn("[PendoProvider] Pendo not ready within timeout. Flags will use default values.");
+                    resolve();
+                    return;
+                }
+                // Try again
+                setTimeout(check, 100);
+            };
+            // Also listen for pendo:ready event
+            if (typeof document !== "undefined") {
+                document.addEventListener("pendo:ready", () => {
+                    resolve();
+                }, { once: true });
+            }
+            check();
+        });
+    }
+    /**
+     * Shutdown the provider.
+     */
+    async onClose() {
+        this.status = web_sdk_1.ClientProviderStatus.NOT_READY;
+        this.readyPromise = null;
+    }
+    /**
+     * Resolve a boolean flag value.
+     *
+     * Checks if the flagKey exists in pendo.segmentFlags array.
+     */
+    resolveBooleanEvaluation(flagKey, defaultValue, _context) {
+        const flags = this.getSegmentFlags();
+        if (!flags) {
+            return {
+                value: defaultValue,
+                reason: "DEFAULT",
+                variant: "default",
+            };
+        }
+        const enabled = flags.includes(flagKey);
+        return {
+            value: enabled,
+            reason: enabled ? "TARGETING_MATCH" : "DEFAULT",
+            variant: enabled ? "on" : "off",
+        };
+    }
+    /**
+     * Resolve a string flag value.
+     *
+     * For Pendo flags, this returns "on" if the flag is enabled, "off" otherwise.
+     */
+    resolveStringEvaluation(flagKey, defaultValue, context) {
+        const boolResult = this.resolveBooleanEvaluation(flagKey, false, context);
+        if (boolResult.reason === "DEFAULT" && !boolResult.value) {
+            return {
+                value: defaultValue,
+                reason: "DEFAULT",
+                variant: "default",
+            };
+        }
+        return {
+            value: boolResult.value ? "on" : "off",
+            reason: boolResult.reason,
+            variant: boolResult.variant,
+        };
+    }
+    /**
+     * Resolve a number flag value.
+     *
+     * For Pendo flags, this returns 1 if enabled, 0 if disabled.
+     */
+    resolveNumberEvaluation(flagKey, defaultValue, context) {
+        const boolResult = this.resolveBooleanEvaluation(flagKey, false, context);
+        if (boolResult.reason === "DEFAULT" && !boolResult.value) {
+            return {
+                value: defaultValue,
+                reason: "DEFAULT",
+                variant: "default",
+            };
+        }
+        return {
+            value: boolResult.value ? 1 : 0,
+            reason: boolResult.reason,
+            variant: boolResult.variant,
+        };
+    }
+    /**
+     * Resolve an object flag value.
+     *
+     * For Pendo flags, this returns { enabled: true/false }.
+     */
+    resolveObjectEvaluation(flagKey, defaultValue, context) {
+        const boolResult = this.resolveBooleanEvaluation(flagKey, false, context);
+        if (boolResult.reason === "DEFAULT" && !boolResult.value) {
+            return {
+                value: defaultValue,
+                reason: "DEFAULT",
+                variant: "default",
+            };
+        }
+        return {
+            value: { enabled: boolResult.value },
+            reason: boolResult.reason,
+            variant: boolResult.variant,
+        };
+    }
+    /**
+     * Get the segment flags array from Pendo.
+     */
+    getSegmentFlags() {
+        if (typeof window === "undefined") {
+            return undefined;
+        }
+        return window.pendo?.segmentFlags;
+    }
+    /**
+     * Track a custom event in Pendo.
+     *
+     * This method delegates to the Pendo agent's track function.
+     * The Pendo agent must be initialized on the page for this to work.
+     *
+     * @param trackingEventName - The name of the event to track
+     * @param _context - Evaluation context (unused in web provider, Pendo agent handles visitor context)
+     * @param trackingEventDetails - Optional additional event properties
+     */
+    track(trackingEventName, _context, trackingEventDetails) {
+        if (typeof window === "undefined" || !window.pendo?.track) {
+            console.warn("[PendoProvider] Pendo agent not available for tracking");
+            return;
+        }
+        // Convert TrackingEventDetails to Record<string, string> for Pendo agent
+        const properties = {};
+        for (const [key, value] of Object.entries(trackingEventDetails)) {
+            if (value !== undefined && value !== null) {
+                properties[key] = String(value);
+            }
+        }
+        // Fire-and-forget: delegate to Pendo agent
+        window.pendo.track(trackingEventName, properties);
+    }
+}
+exports.PendoProvider = PendoProvider;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUGVuZG9Qcm92aWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9QZW5kb1Byb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQVNBLGtEQUE0RDtBQTJCNUQ7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxNQUFhLGFBQWE7SUFZeEIsWUFBWSxVQUFnQyxFQUFFO1FBWHJDLGFBQVEsR0FBcUI7WUFDcEMsSUFBSSxFQUFFLGdCQUFnQjtTQUN2QixDQUFDO1FBR0YsV0FBTSxHQUF5Qiw4QkFBb0IsQ0FBQyxTQUFTLENBQUM7UUFJdEQsaUJBQVksR0FBeUIsSUFBSSxDQUFDO1FBR2hELElBQUksQ0FBQyxPQUFPLEdBQUc7WUFDYixZQUFZLEVBQUUsSUFBSTtZQUNsQixHQUFHLE9BQU87U0FDWCxDQUFDO0lBQ0osQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUssQ0FBQyxVQUFVO1FBQ2QsSUFBSSxJQUFJLENBQUMsWUFBWSxFQUFFLENBQUM7WUFDdEIsT0FBTyxJQUFJLENBQUMsWUFBWSxDQUFDO1FBQzNCLENBQUM7UUFFRCxJQUFJLENBQUMsWUFBWSxHQUFHLElBQUksQ0FBQyxZQUFZLEVBQUUsQ0FBQztRQUN4QyxNQUFNLElBQUksQ0FBQyxZQUFZLENBQUM7UUFDeEIsSUFBSSxDQUFDLE1BQU0sR0FBRyw4QkFBb0IsQ0FBQyxLQUFLLENBQUM7SUFDM0MsQ0FBQztJQUVEOztPQUVHO0lBQ0ssS0FBSyxDQUFDLFlBQVk7UUFDeEIsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxZQUFZLElBQUksSUFBSSxDQUFDO1FBQ2xELE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUU3QixPQUFPLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQ3JDLE1BQU0sS0FBSyxHQUFHLEdBQUcsRUFBRTtnQkFDakIsd0NBQXdDO2dCQUN4QyxJQUFJLE9BQU8s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QU0sS0FBSyxXQUFXLEVBQUUsQ0FBQztZQUNsQyxPQUFPLFNBQVMsQ0FBQztRQUNuQixDQUFDO1FBRUQsT0FBTyxNQUFNLENBQUMsS0FBSyxFQUFFLFlBQVksQ0FBQztJQUNwQyxDQUFDO0lBRUQ7Ozs7Ozs7OztPQVNHO0lBQ0gsS0FBSyxDQUNILGlCQUF5QixFQUN6QixRQUEyQixFQUMzQixvQkFBMEM7UUFFMUMsSUFBSSxPQUFPLE1BQU0sS0FBSyxXQUFXLElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxDQUFDO1lBQzFELE9BQU8sQ0FBQyxJQUFJLENBQUMsd0RBQXdELENBQUMsQ0FBQztZQUN2RSxPQUFPO1FBQ1QsQ0FBQztRQUVELHlFQUF5RTtRQUN6RSxNQUFNLFVBQVUsR0FBMkIsRUFBRSxDQUFDO1FBQzlDLEtBQUssTUFBTSxDQUFDLEdBQUcsRUFBRSxLQUFLLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLG9CQUFvQixDQUFDLEVBQUUsQ0FBQztZQUNoRSxJQUFJLEtBQUssS0FBSyxTQUFTLElBQUksS0FBSyxLQUFLLElBQUksRUFBRSxDQUFDO2dCQUMxQyxVQUFVLENBQUMsR0FBRyxDQUFDLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQ2xDLENBQUM7UUFDSCxDQUFDO1FBRUQsMkNBQTJDO1FBQzNDLE1BQU0sQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLGlCQUFpQixFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBQ3BELENBQUM7Q0FDRjtBQWhQRCxzQ0FnUEMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7XG4gIFByb3ZpZGVyLFxuICBQcm92aWRlck1ldGFkYXRhLFxuICBSZXNvbHV0aW9uRGV0YWlscyxcbiAgRXZhbHVhdGlvbkNvbnRleHQsXG4gIEpzb25WYWx1ZSxcbiAgSG9vayxcbiAgVHJhY2tpbmdFdmVudERldGFpbHMsXG59IGZyb20gXCJAb3BlbmZlYXR1cmUvd2ViLXNka1wiO1xuaW1wb3J0IHsgQ2xpZW50UHJvdmlkZXJTdGF0dXMgfSBmcm9tIFwiQG9wZW5mZWF0dXJlL3dlYi1zZGtcIjtcblxuZGVjbGFyZSBnbG9iYWwge1xuICBpbnRlcmZhY2UgV2luZG93IHtcbiAgICBwZW5kbz86IHtcbiAgICAgIHNlZ21lbnRGbGFncz86IHN0cmluZ1tdO1xuICAgICAgaXNSZWFkeT86ICgpID0+IGJvb2xlYW47XG4gICAgICBpbml0aWFsaXplPzogKG9wdGlvbnM6IHVua25vd24pID0+IHZvaWQ7XG4gICAgICB0cmFjaz86IChldmVudDogc3RyaW5nLCBwcm9wZXJ0aWVzPzogUmVjb3JkPHN0cmluZywgc3RyaW5nPikgPT4gdm9pZDtcbiAgICB9O1xuICB9XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgUGVuZG9Qcm92aWRlck9wdGlvbnMge1xuICAvKipcbiAgICogT3B0aW9uYWw6IFBlbmRvIEFQSSBrZXkgZm9yIGluaXRpYWxpemF0aW9uLlxuICAgKiBJZiBub3QgcHJvdmlkZWQsIGFzc3VtZXMgUGVuZG8gaXMgYWxyZWFkeSBpbml0aWFsaXplZCBvbiB0aGUgcGFnZS5cbiAgICovXG4gIGFwaUtleT86IHN0cmluZztcblxuICAvKipcbiAgICogT3B0aW9uYWw6IFRpbWVvdXQgaW4gbWlsbGlzZWNvbmRzIHRvIHdhaXQgZm9yIFBlbmRvIHRvIGJlIHJlYWR5LlxuICAgKiBEZWZhdWx0OiA1MDAwbXNcbiAgICovXG4gIHJlYWR5VGltZW91dD86IG51bWJlcjtcbn1cblxuLyoqXG4gKiBPcGVuRmVhdHVyZSBwcm92aWRlciBmb3IgUGVuZG8gZmVhdHVyZSBmbGFncy5cbiAqXG4gKiBUaGlzIHByb3ZpZGVyIGV2YWx1YXRlcyBmZWF0dXJlIGZsYWdzIGJ5IGNoZWNraW5nIHRoZSBgcGVuZG8uc2VnbWVudEZsYWdzYCBhcnJheVxuICogd2hpY2ggaXMgcG9wdWxhdGVkIGJ5IHRoZSBQZW5kbyBhZ2VudCBiYXNlZCBvbiBzZWdtZW50IG1lbWJlcnNoaXAuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGltcG9ydCB7IE9wZW5GZWF0dXJlIH0gZnJvbSAnQG9wZW5mZWF0dXJlL3dlYi1zZGsnO1xuICogaW1wb3J0IHsgUGVuZG9Qcm92aWRlciB9IGZyb20gJ0BwZW5kby9vcGVuZmVhdHVyZS13ZWItcHJvdmlkZXInO1xuICpcbiAqIGF3YWl0IE9wZW5GZWF0dXJlLnNldFByb3ZpZGVyQW5kV2FpdChuZXcgUGVuZG9Qcm92aWRlcigpKTtcbiAqXG4gKiBjb25zdCBjbGllbnQgPSBPcGVuRmVhdHVyZS5nZXRDbGllbnQoKTtcbiAqIGNvbnN0IGVuYWJsZWQgPSBhd2FpdCBjbGllbnQuZ2V0Qm9vbGVhblZhbHVlKCdteUZlYXR1cmUnLCBmYWxzZSk7XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGNsYXNzIFBlbmRvUHJvdmlkZXIgaW1wbGVtZW50cyBQcm92aWRlciB7XG4gIHJlYWRvbmx5IG1ldGFkYXRhOiBQcm92aWRlck1ldGFkYXRhID0ge1xuICAgIG5hbWU6IFwicGVuZG8tcHJvdmlkZXJcIixcbiAgfTtcblxuICByZWFkb25seSBydWxlc0NoYW5nZWQ/OiAoKSA9PiB2b2lkO1xuICBzdGF0dXM6IENsaWVudFByb3ZpZGVyU3RhdHVzID0gQ2xpZW50UHJvdmlkZXJTdGF0dXMuTk9UX1JFQURZO1xuICBob29rcz86IEhvb2tbXTtcblxuICBwcml2YXRlIG9wdGlvbnM6IFBlbmRvUHJvdmlkZXJPcHRpb25zO1xuICBwcml2YXRlIHJlYWR5UHJvbWlzZTogUHJvbWlzZTx2b2lkPiB8IG51bGwgPSBudWxsO1xuXG4gIGNvbnN0cnVjdG9yKG9wdGlvbnM6IFBlbmRvUHJvdmlkZXJPcHRpb25zID0ge30pIHtcbiAgICB0aGlzLm9wdGlvbnMgPSB7XG4gICAgICByZWFkeVRpbWVvdXQ6IDUwMDAsXG4gICAgICAuLi5vcHRpb25zLFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogSW5pdGlhbGl6ZSB0aGUgcHJvdmlkZXIuXG4gICAqIFdhaXRzIGZvciBQZW5kbyB0byBiZSByZWFkeSBiZWZvcmUgcmVzb2x2aW5nLlxuICAgKi9cbiAgYXN5bmMgaW5pdGlhbGl6ZSgpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBpZiAodGhpcy5yZWFkeVByb21pc2UpIHtcbiAgICAgIHJldHVybiB0aGlzLnJlYWR5UHJvbWlzZTtcbiAgICB9XG5cbiAgICB0aGlzLnJlYWR5UHJvbWlzZSA9IHRoaXMud2FpdEZvclBlbmRvKCk7XG4gICAgYXdhaXQgdGhpcy5yZWFkeVByb21pc2U7XG4gICAgdGhpcy5zdGF0dXMgPSBDbGllbnRQcm92aWRlclN0YXR1cy5SRUFEWTtcbiAgfVxuXG4gIC8qKlxuICAgKiBXYWl0IGZvciBQZW5kbyB0byBiZSByZWFkeSB3aXRoIHRpbWVvdXQuXG4gICAqL1xuICBwcml2YXRlIGFzeW5jIHdhaXRGb3JQZW5kbygpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBjb25zdCB0aW1lb3V0ID0gdGhpcy5vcHRpb25zLnJlYWR5VGltZW91dCA/PyA1MDAwO1xuICAgIGNvbnN0IHN0YXJ0VGltZSA9IERhdGUubm93KCk7XG5cbiAgICByZXR1cm4gbmV3IFByb21pc2UoKHJlc29sdmUsIHJlamVjdCkgPT4ge1xuICAgICAgY29uc3QgY2hlY2sgPSAoKSA9PiB7XG4gICAgICAgIC8vIENoZWNrIGlmIHBlbmRvIGlzIGF2YWlsYWJsZSBhbmQgcmVhZHlcbiAgICAgICAgaWYgKHR5cGVvZiB3aW5kb3cgIT09IFwidW5kZWZpbmVkXCIgJiYgd2luZG93LnBlbmRvKSB7XG4gICAgICAgICAgaWYgKHdpbmRvdy5wZW5kby5pc1JlYWR5Py4oKSB8fCB3aW5kb3cucGVuZG8uc2VnbWVudEZsYWdzICE9PSB1bmRlZmluZWQpIHtcbiAgICAgICAgICAgIHJlc29sdmUoKTtcbiAgICAgICAgICAgIHJldHVybjtcbiAgICAgICAgICB9XG4gICAgICAgIH1cblxuICAgICAgICAvLyBDaGVjayB0aW1lb3V0XG4gICAgICAgIGlmIChEYXRlLm5vdygpIC0gc3RhcnRUaW1lID4gdGltZW91dCkge1xuICAgICAgICAgIC8vIERvbid0IHJlamVjdCAtIGp1c3QgcmVzb2x2ZSBhbmQgd29yayB3aXRob3V0IFBlbmRvXG4gICAgICAgICAgLy8gRmxhZ3Mgd2lsbCBkZWZhdWx0IHRvIGZhbHNlXG4gICAgICAgICAgY29uc29sZS53YXJuKFxuICAgICAgICAgICAgXCJbUGVuZG9Qcm92aWRlcl0gUGVuZG8gbm90IHJlYWR5IHdpdGhpbiB0aW1lb3V0LiBGbGFncyB3aWxsIHVzZSBkZWZhdWx0IHZhbHVlcy5cIlxuICAgICAgICAgICk7XG4gICAgICAgICAgcmVzb2x2ZSgpO1xuICAgICAgICAgIHJldHVybjtcbiAgICAgICAgfVxuXG4gICAgICAgIC8vIFRyeSBhZ2FpblxuICAgICAgICBzZXRUaW1lb3V0KGNoZWNrLCAxMDApO1xuICAgICAgfTtcblxuICAgICAgLy8gQWxzbyBsaXN0ZW4gZm9yIHBlbmRvOnJlYWR5IGV2ZW50XG4gICAgICBpZiAodHlwZW9mIGRvY3VtZW50ICE9PSBcInVuZGVmaW5lZFwiKSB7XG4gICAgICAgIGRvY3VtZW50LmFkZEV2ZW50TGlzdGVuZXIoXG4gICAgICAgICAgXCJwZW5kbzpyZWFkeVwiLFxuICAgICAgICAgICgpID0+IHtcbiAgICAgICAgICAgIHJlc29sdmUoKTtcbiAgICAgICAgICB9LFxuICAgICAgICAgIHsgb25jZTogdHJ1ZSB9XG4gICAgICAgICk7XG4gICAgICB9XG5cbiAgICAgIGNoZWNrKCk7XG4gICAgfSk7XG4gIH1cblxuICAvKipcbiAgICogU2h1dGRvd24gdGhlIHByb3ZpZGVyLlxuICAgKi9cbiAgYXN5bmMgb25DbG9zZSgpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICB0aGlzLnN0YXR1cyA9IENsaWVudFByb3ZpZGVyU3RhdHVzLk5PVF9SRUFEWTtcbiAgICB0aGlzLnJlYWR5UHJvbWlzZSA9IG51bGw7XG4gIH1cblxuICAvKipcbiAgICogUmVzb2x2ZSBhIGJvb2xlYW4gZmxhZyB2YWx1ZS5cbiAgICpcbiAgICogQ2hlY2tzIGlmIHRoZSBmbGFnS2V5IGV4aXN0cyBpbiBwZW5kby5zZWdtZW50RmxhZ3MgYXJyYXkuXG4gICAqL1xuICByZXNvbHZlQm9vbGVhbkV2YWx1YXRpb24oXG4gICAgZmxhZ0tleTogc3RyaW5nLFxuICAgIGRlZmF1bHRWYWx1ZTogYm9vbGVhbixcbiAgICBfY29udGV4dDogRXZhbHVhdGlvbkNvbnRleHRcbiAgKTogUmVzb2x1dGlvbkRldGFpbHM8Ym9vbGVhbj4ge1xuICAgIGNvbnN0IGZsYWdzID0gdGhpcy5nZXRTZWdtZW50RmxhZ3MoKTtcblxuICAgIGlmICghZmxhZ3MpIHtcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHZhbHVlOiBkZWZhdWx0VmFsdWUsXG4gICAgICAgIHJlYXNvbjogXCJERUZBVUxUXCIsXG4gICAgICAgIHZhcmlhbnQ6IFwiZGVmYXVsdFwiLFxuICAgICAgfTtcbiAgICB9XG5cbiAgICBjb25zdCBlbmFibGVkID0gZmxhZ3MuaW5jbHVkZXMoZmxhZ0tleSk7XG5cbiAgICByZXR1cm4ge1xuICAgICAgdmFsdWU6IGVuYWJsZWQsXG4gICAgICByZWFzb246IGVuYWJsZWQgPyBcIlRBUkdFVElOR19NQVRDSFwiIDogXCJERUZBVUxUXCIsXG4gICAgICB2YXJpYW50OiBlbmFibGVkID8gXCJvblwiIDogXCJvZmZcIixcbiAgICB9O1xuICB9XG5cbiAgLyoqXG4gICAqIFJlc29sdmUgYSBzdHJpbmcgZmxhZyB2YWx1ZS5cbiAgICpcbiAgICogRm9yIFBlbmRvIGZsYWdzLCB0aGlzIHJldHVybnMgXCJvblwiIGlmIHRoZSBmbGFnIGlzIGVuYWJsZWQsIFwib2ZmXCIgb3RoZXJ3aXNlLlxuICAgKi9cbiAgcmVzb2x2ZVN0cmluZ0V2YWx1YXRpb24oXG4gICAgZmxhZ0tleTogc3RyaW5nLFxuICAgIGRlZmF1bHRWYWx1ZTogc3RyaW5nLFxuICAgIGNvbnRleHQ6IEV2YWx1YXRpb25Db250ZXh0XG4gICk6IFJlc29sdXRpb25EZXRhaWxzPHN0cmluZz4ge1xuICAgIGNvbnN0IGJvb2xSZXN1bHQgPSB0aGlzLnJlc29sdmVCb29sZWFuRXZhbHVhdGlvbihmbGFnS2V5LCBmYWxzZSwgY29udGV4dCk7XG5cbiAgICBpZiAoYm9vbFJlc3VsdC5yZWFzb24gPT09IFwiREVGQVVMVFwiICYmICFib29sUmVzdWx0LnZhbHVlKSB7XG4gICAgICByZXR1cm4ge1xuICAgICAgICB2YWx1ZTogZGVmYXVsdFZhbHVlLFxuICAgICAgICByZWFzb246IFwiREVGQVVMVFwiLFxuICAgICAgICB2YXJpYW50OiBcImRlZmF1bHRcIixcbiAgICAgIH07XG4gICAgfVxuXG4gICAgcmV0dXJuIHtcbiAgICAgIHZhbHVlOiBib29sUmVzdWx0LnZhbHVlID8gXCJvblwiIDogXCJvZmZcIixcbiAgICAgIHJlYXNvbjogYm9vbFJlc3VsdC5yZWFzb24sXG4gICAgICB2YXJpYW50OiBib29sUmVzdWx0LnZhcmlhbnQsXG4gICAgfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXNvbHZlIGEgbnVtYmVyIGZsYWcgdmFsdWUuXG4gICAqXG4gICAqIEZvciBQZW5kbyBmbGFncywgdGhpcyByZXR1cm5zIDEgaWYgZW5hYmxlZCwgMCBpZiBkaXNhYmxlZC5cbiAgICovXG4gIHJlc29sdmVOdW1iZXJFdmFsdWF0aW9uKFxuICAgIGZsYWdLZXk6IHN0cmluZyxcbiAgICBkZWZhdWx0VmFsdWU6IG51bWJlcixcbiAgICBjb250ZXh0OiBFdmFsdWF0aW9uQ29udGV4dFxuICApOiBSZXNvbHV0aW9uRGV0YWlsczxudW1iZXI+IHtcbiAgICBjb25zdCBib29sUmVzdWx0ID0gdGhpcy5yZXNvbHZlQm9vbGVhbkV2YWx1YXRpb24oZmxhZ0tleSwgZmFsc2UsIGNvbnRleHQpO1xuXG4gICAgaWYgKGJvb2xSZXN1bHQucmVhc29uID09PSBcIkRFRkFVTFRcIiAmJiAhYm9vbFJlc3VsdC52YWx1ZSkge1xuICAgICAgcmV0dXJuIHtcbiAgICAgICAgdmFsdWU6IGRlZmF1bHRWYWx1ZSxcbiAgICAgICAgcmVhc29uOiBcIkRFRkFVTFRcIixcbiAgICAgICAgdmFyaWFudDogXCJkZWZhdWx0XCIsXG4gICAgICB9O1xuICAgIH1cblxuICAgIHJldHVybiB7XG4gICAgICB2YWx1ZTogYm9vbFJlc3VsdC52YWx1ZSA/IDEgOiAwLFxuICAgICAgcmVhc29uOiBib29sUmVzdWx0LnJlYXNvbixcbiAgICAgIHZhcmlhbnQ6IGJvb2xSZXN1bHQudmFyaWFudCxcbiAgICB9O1xuICB9XG5cbiAgLyoqXG4gICAqIFJlc29sdmUgYW4gb2JqZWN0IGZsYWcgdmFsdWUuXG4gICAqXG4gICAqIEZvciBQZW5kbyBmbGFncywgdGhpcyByZXR1cm5zIHsgZW5hYmxlZDogdHJ1ZS9mYWxzZSB9LlxuICAgKi9cbiAgcmVzb2x2ZU9iamVjdEV2YWx1YXRpb248VCBleHRlbmRzIEpzb25WYWx1ZT4oXG4gICAgZmxhZ0tleTogc3RyaW5nLFxuICAgIGRlZmF1bHRWYWx1ZTogVCxcbiAgICBjb250ZXh0OiBFdmFsdWF0aW9uQ29udGV4dFxuICApOiBSZXNvbHV0aW9uRGV0YWlsczxUPiB7XG4gICAgY29uc3QgYm9vbFJlc3VsdCA9IHRoaXMucmVzb2x2ZUJvb2xlYW5FdmFsdWF0aW9uKGZsYWdLZXksIGZhbHNlLCBjb250ZXh0KTtcblxuICAgIGlmIChib29sUmVzdWx0LnJlYXNvbiA9PT0gXCJERUZBVUxUXCIgJiYgIWJvb2xSZXN1bHQudmFsdWUpIHtcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHZhbHVlOiBkZWZhdWx0VmFsdWUsXG4gICAgICAgIHJlYXNvbjogXCJERUZBVUxUXCIsXG4gICAgICAgIHZhcmlhbnQ6IFwiZGVmYXVsdFwiLFxuICAgICAgfTtcbiAgICB9XG5cbiAgICByZXR1cm4ge1xuICAgICAgdmFsdWU6IHsgZW5hYmxlZDogYm9vbFJlc3VsdC52YWx1ZSB9IGFzIHVua25vd24gYXMgVCxcbiAgICAgIHJlYXNvbjogYm9vbFJlc3VsdC5yZWFzb24sXG4gICAgICB2YXJpYW50OiBib29sUmVzdWx0LnZhcmlhbnQsXG4gICAgfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgdGhlIHNlZ21lbnQgZmxhZ3MgYXJyYXkgZnJvbSBQZW5kby5cbiAgICovXG4gIHByaXZhdGUgZ2V0U2VnbWVudEZsYWdzKCk6IHN0cmluZ1tdIHwgdW5kZWZpbmVkIHtcbiAgICBpZiAodHlwZW9mIHdpbmRvdyA9PT0gXCJ1bmRlZmluZWRcIikge1xuICAgICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgICB9XG5cbiAgICByZXR1cm4gd2luZG93LnBlbmRvPy5zZWdtZW50RmxhZ3M7XG4gIH1cblxuICAvKipcbiAgICogVHJhY2sgYSBjdXN0b20gZXZlbnQgaW4gUGVuZG8uXG4gICAqXG4gICAqIFRoaXMgbWV0aG9kIGRlbGVnYXRlcyB0byB0aGUgUGVuZG8gYWdlbnQncyB0cmFjayBmdW5jdGlvbi5cbiAgICogVGhlIFBlbmRvIGFnZW50IG11c3QgYmUgaW5pdGlhbGl6ZWQgb24gdGhlIHBhZ2UgZm9yIHRoaXMgdG8gd29yay5cbiAgICpcbiAgICogQHBhcmFtIHRyYWNraW5nRXZlbnROYW1lIC0gVGhlIG5hbWUgb2YgdGhlIGV2ZW50IHRvIHRyYWNrXG4gICAqIEBwYXJhbSBfY29udGV4dCAtIEV2YWx1YXRpb24gY29udGV4dCAodW51c2VkIGluIHdlYiBwcm92aWRlciwgUGVuZG8gYWdlbnQgaGFuZGxlcyB2aXNpdG9yIGNvbnRleHQpXG4gICAqIEBwYXJhbSB0cmFja2luZ0V2ZW50RGV0YWlscyAtIE9wdGlvbmFsIGFkZGl0aW9uYWwgZXZlbnQgcHJvcGVydGllc1xuICAgKi9cbiAgdHJhY2soXG4gICAgdHJhY2tpbmdFdmVudE5hbWU6IHN0cmluZyxcbiAgICBfY29udGV4dDogRXZhbHVhdGlvbkNvbnRleHQsXG4gICAgdHJhY2tpbmdFdmVudERldGFpbHM6IFRyYWNraW5nRXZlbnREZXRhaWxzXG4gICk6IHZvaWQge1xuICAgIGlmICh0eXBlb2Ygd2luZG93ID09PSBcInVuZGVmaW5lZFwiIHx8ICF3aW5kb3cucGVuZG8/LnRyYWNrKSB7XG4gICAgICBjb25zb2xlLndhcm4oXCJbUGVuZG9Qcm92aWRlcl0gUGVuZG8gYWdlbnQgbm90IGF2YWlsYWJsZSBmb3IgdHJhY2tpbmdcIik7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgLy8gQ29udmVydCBUcmFja2luZ0V2ZW50RGV0YWlscyB0byBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+IGZvciBQZW5kbyBhZ2VudFxuICAgIGNvbnN0IHByb3BlcnRpZXM6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4gPSB7fTtcbiAgICBmb3IgKGNvbnN0IFtrZXksIHZhbHVlXSBvZiBPYmplY3QuZW50cmllcyh0cmFja2luZ0V2ZW50RGV0YWlscykpIHtcbiAgICAgIGlmICh2YWx1ZSAhPT0gdW5kZWZpbmVkICYmIHZhbHVlICE9PSBudWxsKSB7XG4gICAgICAgIHByb3BlcnRpZXNba2V5XSA9IFN0cmluZyh2YWx1ZSk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgLy8gRmlyZS1hbmQtZm9yZ2V0OiBkZWxlZ2F0ZSB0byBQZW5kbyBhZ2VudFxuICAgIHdpbmRvdy5wZW5kby50cmFjayh0cmFja2luZ0V2ZW50TmFtZSwgcHJvcGVydGllcyk7XG4gIH1cbn1cbiJdfQ==

package/dist/PendoTelemetryHook.d.ts

@@ -0,0 +1,47 @@
+import type { Hook, HookContext, EvaluationDetails, FlagValue } from "@openfeature/web-sdk";
+export interface PendoTelemetryHookOptions {
+    /**
+     * Event name for flag evaluation tracking.
+     * Default: "flag_evaluated"
+     */
+    eventName?: string;
+    /**
+     * Optional filter function to selectively track flags.
+     * Return true to track the flag, false to skip.
+     */
+    flagFilter?: (flagKey: string) => boolean;
+}
+/**
+ * OpenFeature hook that automatically tracks flag evaluations to Pendo.
+ *
+ * This hook sends an event to Pendo after each flag evaluation, allowing you
+ * to analyze feature flag usage alongside your other Pendo analytics.
+ *
+ * The hook uses the Pendo agent's track function, so the Pendo agent must be
+ * initialized on the page for tracking to work.
+ *
+ * @example
+ * ```typescript
+ * import { OpenFeature } from '@openfeature/web-sdk';
+ * import { PendoProvider, PendoTelemetryHook } from '@pendo/openfeature-web-provider';
+ *
+ * const provider = new PendoProvider();
+ * const telemetryHook = new PendoTelemetryHook();
+ *
+ * await OpenFeature.setProviderAndWait(provider);
+ * OpenFeature.addHooks(telemetryHook);
+ * ```
+ */
+export declare class PendoTelemetryHook implements Hook {
+    private options;
+    constructor(options?: PendoTelemetryHookOptions);
+    /**
+     * Called after a flag is successfully evaluated.
+     * Sends the evaluation result to Pendo as a track event.
+     */
+    after(hookContext: Readonly<HookContext<FlagValue>>, evaluationDetails: EvaluationDetails<FlagValue>): void;
+    /**
+     * Convert a flag value to a string for tracking.
+     */
+    private stringifyValue;
+}

package/dist/PendoTelemetryHook.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendoTelemetryHook = void 0;
+/**
+ * OpenFeature hook that automatically tracks flag evaluations to Pendo.
+ *
+ * This hook sends an event to Pendo after each flag evaluation, allowing you
+ * to analyze feature flag usage alongside your other Pendo analytics.
+ *
+ * The hook uses the Pendo agent's track function, so the Pendo agent must be
+ * initialized on the page for tracking to work.
+ *
+ * @example
+ * ```typescript
+ * import { OpenFeature } from '@openfeature/web-sdk';
+ * import { PendoProvider, PendoTelemetryHook } from '@pendo/openfeature-web-provider';
+ *
+ * const provider = new PendoProvider();
+ * const telemetryHook = new PendoTelemetryHook();
+ *
+ * await OpenFeature.setProviderAndWait(provider);
+ * OpenFeature.addHooks(telemetryHook);
+ * ```
+ */
+class PendoTelemetryHook {
+    constructor(options = {}) {
+        this.options = {
+            eventName: "flag_evaluated",
+            ...options,
+        };
+    }
+    /**
+     * Called after a flag is successfully evaluated.
+     * Sends the evaluation result to Pendo as a track event.
+     */
+    after(hookContext, evaluationDetails) {
+        const { flagKey } = hookContext;
+        // Check if this flag should be tracked
+        if (this.options.flagFilter && !this.options.flagFilter(flagKey)) {
+            return;
+        }
+        // Check if Pendo agent is available
+        if (typeof window === "undefined" || !window.pendo?.track) {
+            return;
+        }
+        const properties = {
+            flag_key: flagKey,
+            flag_variant: evaluationDetails.variant || "unknown",
+            flag_reason: evaluationDetails.reason || "UNKNOWN",
+            flag_value: this.stringifyValue(evaluationDetails.value),
+            provider_name: hookContext.providerMetadata.name,
+        };
+        // Fire-and-forget: delegate to Pendo agent
+        window.pendo.track(this.options.eventName, properties);
+    }
+    /**
+     * Convert a flag value to a string for tracking.
+     */
+    stringifyValue(value) {
+        if (value === null) {
+            return "null";
+        }
+        if (typeof value === "object") {
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+}
+exports.PendoTelemetryHook = PendoTelemetryHook;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUGVuZG9UZWxlbWV0cnlIb29rLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL1BlbmRvVGVsZW1ldHJ5SG9vay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFxQkE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBb0JHO0FBQ0gsTUFBYSxrQkFBa0I7SUFLN0IsWUFBWSxVQUFxQyxFQUFFO1FBQ2pELElBQUksQ0FBQyxPQUFPLEdBQUc7WUFDYixTQUFTLEVBQUUsZ0JBQWdCO1lBQzNCLEdBQUcsT0FBTztTQUNYLENBQUM7SUFDSixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUNILFdBQTZDLEVBQzdDLGlCQUErQztRQUUvQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsV0FBVyxDQUFDO1FBRWhDLHVDQUF1QztRQUN2QyxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsVUFBVSxJQUFJLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUNqRSxPQUFPO1FBQ1QsQ0FBQztRQUVELG9DQUFvQztRQUNwQyxJQUFJLE9BQU8sTUFBTSxLQUFLLFdBQVcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLENBQUM7WUFDMUQsT0FBTztRQUNULENBQUM7UUFFRCxNQUFNLFVBQVUsR0FBMkI7WUFDekMsUUFBUSxFQUFFLE9BQU87WUFDakIsWUFBWSxFQUFFLGlCQUFpQixDQUFDLE9BQU8sSUFBSSxTQUFTO1lBQ3BELFdBQVcsRUFBRSxpQkFBaUIsQ0FBQyxNQUFNLElBQUksU0FBUztZQUNsRCxVQUFVLEVBQUUsSUFBSSxDQUFDLGNBQWMsQ0FBQyxpQkFBaUIsQ0FBQyxLQUFLLENBQUM7WUFDeEQsYUFBYSxFQUFFLFdBQVcsQ0FBQyxnQkFBZ0IsQ0FBQyxJQUFJO1NBQ2pELENBQUM7UUFFRiwyQ0FBMkM7UUFDM0MsTUFBTSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsVUFBVSxDQUFDLENBQUM7SUFDekQsQ0FBQztJQUVEOztPQUVHO0lBQ0ssY0FBYyxDQUFDLEtBQWdCO1FBQ3JDLElBQUksS0FBSyxLQUFLLElBQUksRUFBRSxDQUFDO1lBQ25CLE9BQU8sTUFBTSxDQUFDO1FBQ2hCLENBQUM7UUFDRCxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsRUFBRSxDQUFDO1lBQzlCLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUMvQixDQUFDO1FBQ0QsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDdkIsQ0FBQztDQUNGO0FBeERELGdEQXdEQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHtcbiAgSG9vayxcbiAgSG9va0NvbnRleHQsXG4gIEV2YWx1YXRpb25EZXRhaWxzLFxuICBGbGFnVmFsdWUsXG59IGZyb20gXCJAb3BlbmZlYXR1cmUvd2ViLXNka1wiO1xuXG5leHBvcnQgaW50ZXJmYWNlIFBlbmRvVGVsZW1ldHJ5SG9va09wdGlvbnMge1xuICAvKipcbiAgICogRXZlbnQgbmFtZSBmb3IgZmxhZyBldmFsdWF0aW9uIHRyYWNraW5nLlxuICAgKiBEZWZhdWx0OiBcImZsYWdfZXZhbHVhdGVkXCJcbiAgICovXG4gIGV2ZW50TmFtZT86IHN0cmluZztcblxuICAvKipcbiAgICogT3B0aW9uYWwgZmlsdGVyIGZ1bmN0aW9uIHRvIHNlbGVjdGl2ZWx5IHRyYWNrIGZsYWdzLlxuICAgKiBSZXR1cm4gdHJ1ZSB0byB0cmFjayB0aGUgZmxhZywgZmFsc2UgdG8gc2tpcC5cbiAgICovXG4gIGZsYWdGaWx0ZXI/OiAoZmxhZ0tleTogc3RyaW5nKSA9PiBib29sZWFuO1xufVxuXG4vKipcbiAqIE9wZW5GZWF0dXJlIGhvb2sgdGhhdCBhdXRvbWF0aWNhbGx5IHRyYWNrcyBmbGFnIGV2YWx1YXRpb25zIHRvIFBlbmRvLlxuICpcbiAqIFRoaXMgaG9vayBzZW5kcyBhbiBldmVudCB0byBQZW5kbyBhZnRlciBlYWNoIGZsYWcgZXZhbHVhdGlvbiwgYWxsb3dpbmcgeW91XG4gKiB0byBhbmFseXplIGZlYXR1cmUgZmxhZyB1c2FnZSBhbG9uZ3NpZGUgeW91ciBvdGhlciBQZW5kbyBhbmFseXRpY3MuXG4gKlxuICogVGhlIGhvb2sgdXNlcyB0aGUgUGVuZG8gYWdlbnQncyB0cmFjayBmdW5jdGlvbiwgc28gdGhlIFBlbmRvIGFnZW50IG11c3QgYmVcbiAqIGluaXRpYWxpemVkIG9uIHRoZSBwYWdlIGZvciB0cmFja2luZyB0byB3b3JrLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBpbXBvcnQgeyBPcGVuRmVhdHVyZSB9IGZyb20gJ0BvcGVuZmVhdHVyZS93ZWItc2RrJztcbiAqIGltcG9ydCB7IFBlbmRvUHJvdmlkZXIsIFBlbmRvVGVsZW1ldHJ5SG9vayB9IGZyb20gJ0BwZW5kby9vcGVuZmVhdHVyZS13ZWItcHJvdmlkZXInO1xuICpcbiAqIGNvbnN0IHByb3ZpZGVyID0gbmV3IFBlbmRvUHJvdmlkZXIoKTtcbiAqIGNvbnN0IHRlbGVtZXRyeUhvb2sgPSBuZXcgUGVuZG9UZWxlbWV0cnlIb29rKCk7XG4gKlxuICogYXdhaXQgT3BlbkZlYXR1cmUuc2V0UHJvdmlkZXJBbmRXYWl0KHByb3ZpZGVyKTtcbiAqIE9wZW5GZWF0dXJlLmFkZEhvb2tzKHRlbGVtZXRyeUhvb2spO1xuICogYGBgXG4gKi9cbmV4cG9ydCBjbGFzcyBQZW5kb1RlbGVtZXRyeUhvb2sgaW1wbGVtZW50cyBIb29rIHtcbiAgcHJpdmF0ZSBvcHRpb25zOiBSZXF1aXJlZDxPbWl0PFBlbmRvVGVsZW1ldHJ5SG9va09wdGlvbnMsIFwiZmxhZ0ZpbHRlclwiPj4gJiB7XG4gICAgZmxhZ0ZpbHRlcj86IChmbGFnS2V5OiBzdHJpbmcpID0+IGJvb2xlYW47XG4gIH07XG5cbiAgY29uc3RydWN0b3Iob3B0aW9uczogUGVuZG9UZWxlbWV0cnlIb29rT3B0aW9ucyA9IHt9KSB7XG4gICAgdGhpcy5vcHRpb25zID0ge1xuICAgICAgZXZlbnROYW1lOiBcImZsYWdfZXZhbHVhdGVkXCIsXG4gICAgICAuLi5vcHRpb25zLFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogQ2FsbGVkIGFmdGVyIGEgZmxhZyBpcyBzdWNjZXNzZnVsbHkgZXZhbHVhdGVkLlxuICAgKiBTZW5kcyB0aGUgZXZhbHVhdGlvbiByZXN1bHQgdG8gUGVuZG8gYXMgYSB0cmFjayBldmVudC5cbiAgICovXG4gIGFmdGVyKFxuICAgIGhvb2tDb250ZXh0OiBSZWFkb25seTxIb29rQ29udGV4dDxGbGFnVmFsdWU+PixcbiAgICBldmFsdWF0aW9uRGV0YWlsczogRXZhbHVhdGlvbkRldGFpbHM8RmxhZ1ZhbHVlPlxuICApOiB2b2lkIHtcbiAgICBjb25zdCB7IGZsYWdLZXkgfSA9IGhvb2tDb250ZXh0O1xuXG4gICAgLy8gQ2hlY2sgaWYgdGhpcyBmbGFnIHNob3VsZCBiZSB0cmFja2VkXG4gICAgaWYgKHRoaXMub3B0aW9ucy5mbGFnRmlsdGVyICYmICF0aGlzLm9wdGlvbnMuZmxhZ0ZpbHRlcihmbGFnS2V5KSkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIC8vIENoZWNrIGlmIFBlbmRvIGFnZW50IGlzIGF2YWlsYWJsZVxuICAgIGlmICh0eXBlb2Ygd2luZG93ID09PSBcInVuZGVmaW5lZFwiIHx8ICF3aW5kb3cucGVuZG8/LnRyYWNrKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgY29uc3QgcHJvcGVydGllczogUmVjb3JkPHN0cmluZywgc3RyaW5nPiA9IHtcbiAgICAgIGZsYWdfa2V5OiBmbGFnS2V5LFxuICAgICAgZmxhZ192YXJpYW50OiBldmFsdWF0aW9uRGV0YWlscy52YXJpYW50IHx8IFwidW5rbm93blwiLFxuICAgICAgZmxhZ19yZWFzb246IGV2YWx1YXRpb25EZXRhaWxzLnJlYXNvbiB8fCBcIlVOS05PV05cIixcbiAgICAgIGZsYWdfdmFsdWU6IHRoaXMuc3RyaW5naWZ5VmFsdWUoZXZhbHVhdGlvbkRldGFpbHMudmFsdWUpLFxuICAgICAgcHJvdmlkZXJfbmFtZTogaG9va0NvbnRleHQucHJvdmlkZXJNZXRhZGF0YS5uYW1lLFxuICAgIH07XG5cbiAgICAvLyBGaXJlLWFuZC1mb3JnZXQ6IGRlbGVnYXRlIHRvIFBlbmRvIGFnZW50XG4gICAgd2luZG93LnBlbmRvLnRyYWNrKHRoaXMub3B0aW9ucy5ldmVudE5hbWUsIHByb3BlcnRpZXMpO1xuICB9XG5cbiAgLyoqXG4gICAqIENvbnZlcnQgYSBmbGFnIHZhbHVlIHRvIGEgc3RyaW5nIGZvciB0cmFja2luZy5cbiAgICovXG4gIHByaXZhdGUgc3RyaW5naWZ5VmFsdWUodmFsdWU6IEZsYWdWYWx1ZSk6IHN0cmluZyB7XG4gICAgaWYgKHZhbHVlID09PSBudWxsKSB7XG4gICAgICByZXR1cm4gXCJudWxsXCI7XG4gICAgfVxuICAgIGlmICh0eXBlb2YgdmFsdWUgPT09IFwib2JqZWN0XCIpIHtcbiAgICAgIHJldHVybiBKU09OLnN0cmluZ2lmeSh2YWx1ZSk7XG4gICAgfVxuICAgIHJldHVybiBTdHJpbmcodmFsdWUpO1xuICB9XG59XG4iXX0=

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { PendoProvider } from "./PendoProvider";
+export type { PendoProviderOptions } from "./PendoProvider";
+export { PendoTelemetryHook } from "./PendoTelemetryHook";
+export type { PendoTelemetryHookOptions } from "./PendoTelemetryHook";

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendoTelemetryHook = exports.PendoProvider = void 0;
+var PendoProvider_1 = require("./PendoProvider");
+Object.defineProperty(exports, "PendoProvider", { enumerable: true, get: function () { return PendoProvider_1.PendoProvider; } });
+var PendoTelemetryHook_1 = require("./PendoTelemetryHook");
+Object.defineProperty(exports, "PendoTelemetryHook", { enumerable: true, get: function () { return PendoTelemetryHook_1.PendoTelemetryHook; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsaURBQWdEO0FBQXZDLDhHQUFBLGFBQWEsT0FBQTtBQUV0QiwyREFBMEQ7QUFBakQsd0hBQUEsa0JBQWtCLE9BQUEiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgeyBQZW5kb1Byb3ZpZGVyIH0gZnJvbSBcIi4vUGVuZG9Qcm92aWRlclwiO1xuZXhwb3J0IHR5cGUgeyBQZW5kb1Byb3ZpZGVyT3B0aW9ucyB9IGZyb20gXCIuL1BlbmRvUHJvdmlkZXJcIjtcbmV4cG9ydCB7IFBlbmRvVGVsZW1ldHJ5SG9vayB9IGZyb20gXCIuL1BlbmRvVGVsZW1ldHJ5SG9va1wiO1xuZXhwb3J0IHR5cGUgeyBQZW5kb1RlbGVtZXRyeUhvb2tPcHRpb25zIH0gZnJvbSBcIi4vUGVuZG9UZWxlbWV0cnlIb29rXCI7XG4iXX0=

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@pendo/openfeature-web-provider",
+  "version": "0.1.0",
+  "description": "OpenFeature provider for Pendo feature flags (web/browser)",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "lint": "eslint src"
+  },
+  "peerDependencies": {
+    "@openfeature/web-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@openfeature/web-sdk": "^1.0.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "openfeature",
+    "feature-flags",
+    "pendo",
+    "provider"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pendo-io/pendo-flags.git",
+    "directory": "packages/web-provider"
+  }
+}