@learncard/partner-connect 0.2.14 → 0.2.16

package/README.md

@@ -305,6 +305,102 @@ if (recipients.hasMore) {
 
 **Returns:** `{ records: TemplateRecipientRecord[], hasMore: boolean, cursor?: string, total?: number }`
 
+### `sendNotification(input)`
+
+Send a notification to the current user from this app. The notification appears in the user's LearnCard notification inbox, even after they leave the app.
+
+```typescript
+await learnCard.sendNotification({
+    title: 'Sprint Bonus!',
+    body: '+10 coins from Sprint 42',
+    actionPath: '/',
+    category: 'reward',
+});
+```
+
+**Parameters:**
+
+-   `title` _(optional)_: Notification title
+-   `body` _(optional)_: Notification body text
+-   `actionPath` _(optional)_: Deep link path within the app (e.g. `'/prizes'`). Must be an absolute pathname starting with `/`. This path is appended to the app's configured embed URL when the user taps the notification. For example, if your embed URL is `https://myapp.com` and `actionPath` is `'/challenges/42'`, the app will open at `https://myapp.com/challenges/42`. Hash routes (e.g. `'/#/page'`) are **not** supported — use pathname-based routing.
+-   `category` _(optional)_: Grouping category (e.g. `'reward'`, `'announcement'`, `'status'`)
+-   `priority` _(optional)_: `'normal'` (default) or `'high'`. Affects visual styling of the notification card and toast. Does not change delivery priority or ordering.
+
+At least one of `title` or `body` is required.
+
+**Returns:** `{ sent: boolean }`
+
+> **Note:** This method sends a notification to the _current_ user (self-notification) via the `send-notification` app event. For server-to-server notifications to arbitrary users, use the `POST /app-store/listing/{listingId}/notify` brain-service route directly from your app backend.
+
+---
+
+### `incrementCounter(key, amount)`
+
+Increment or decrement an app-scoped counter for the current user. Counters are scoped to (user, app, key). If the counter does not exist, it is created with the given amount as its initial value.
+
+```typescript
+// Add 10 coins
+const result = await learnCard.incrementCounter('coins', 10);
+console.log(result.newValue); // 10
+
+// Spend 5 coins
+const spent = await learnCard.incrementCounter('coins', -5);
+console.log(spent.newValue); // 5
+```
+
+**Parameters:**
+
+-   `key` _(required)_: Counter name. Must match `[a-zA-Z0-9_-]+`, max 64 characters.
+-   `amount` _(required)_: Integer value to add. Use a negative integer to decrement.
+
+**Returns:** `{ key: string, previousValue: number, newValue: number }`
+
+**Limits:**
+
+-   Max 50 distinct counter keys per user per app
+-   Max 100 writes per user per app per minute
+-   Amount must be a finite integer
+
+---
+
+### `getCounter(key)`
+
+Read the current value of an app-scoped counter. Returns `{ value: 0 }` if the counter does not exist.
+
+```typescript
+const { value } = await learnCard.getCounter('coins');
+console.log('Balance:', value);
+```
+
+**Parameters:**
+
+-   `key` _(required)_: Counter name (same format as `incrementCounter`)
+
+**Returns:** `{ key: string, value: number, updatedAt: string | null }`
+
+---
+
+### `getCounters(keys?)`
+
+Read multiple app-scoped counters at once. If `keys` is omitted, returns all counters for this app.
+
+```typescript
+// Specific keys
+const { counters } = await learnCard.getCounters(['coins', 'spins', 'streak']);
+counters.forEach(c => console.log(c.key, c.value));
+
+// All counters
+const all = await learnCard.getCounters();
+```
+
+**Parameters:**
+
+-   `keys` _(optional)_: Array of counter names to fetch (max 50). Omit to return all.
+
+**Returns:** `{ counters: Array<{ key: string, value: number, updatedAt: string | null }> }`
+
+---
+
 ### `launchFeature(featurePath, initialPrompt?)`
 
 Launch a feature in the LearnCard host application.

package/dist/index.d.ts

@@ -158,6 +158,17 @@ interface RequestConsentOptions {
      */
     redirect?: boolean;
 }
+/**
+ * Payload for REQUEST_CONSENT action
+ */
+interface RequestConsentPayload {
+    /**
+     * URI of the consent contract. If not provided, the system will attempt
+     * to use the contract configured for the current app listing.
+     */
+    contractUri?: string;
+    redirect?: boolean;
+}
 /**
  * Response from REQUEST_CONSENT action
  */
@@ -242,6 +253,179 @@ interface TemplateRecipientsResponse {
     cursor?: string;
     total?: number;
 }
+/**
+ * Options for REQUEST_LEARNER_CONTEXT action
+ */
+interface RequestLearnerContextOptions {
+    /**
+     * Whether to include credentials in the context
+     * @default true
+     */
+    includeCredentials?: boolean;
+    /**
+     * Whether to include personal data (name, bio, etc.) in the context
+     * @default false
+     */
+    includePersonalData?: boolean;
+    /**
+     * Format of the response
+     * - 'prompt': Returns LLM-ready formatted text
+     * - 'structured': Returns structured data object
+     * @default 'prompt'
+     */
+    format?: 'prompt' | 'structured';
+    /**
+     * Optional instructions to guide the LLM prompt generation
+     */
+    instructions?: string;
+    /**
+     * Level of detail in the generated prompt
+     * @default 'compact'
+     */
+    detailLevel?: 'compact' | 'expanded';
+}
+/**
+ * Raw data included in learner context response (when format is 'structured')
+ */
+interface LearnerContextRawData {
+    /** Array of Verifiable Credentials */
+    credentials: unknown[];
+    /** Personal data if requested and available (name, bio, etc.) */
+    personalData?: Record<string, unknown>;
+}
+/**
+ * Response from REQUEST_LEARNER_CONTEXT action
+ */
+interface LearnerContextResponse {
+    /** LLM-ready formatted prompt text */
+    prompt: string;
+    /** Raw structured data (only included when format is 'structured') */
+    raw?: LearnerContextRawData;
+    /** User's DID */
+    did: string;
+    /** User's display name if available */
+    displayName?: string;
+}
+/**
+ * Keywords for next steps in summary credential data
+ */
+interface SummaryCredentialKeyword {
+    occupations: string[] | null;
+    careers: string[] | null;
+    jobs: string[] | null;
+    skills: string[] | null;
+    fieldOfStudy: string | null;
+}
+/**
+ * Skill item in summary credential data
+ */
+interface SummaryCredentialSkill {
+    title: string;
+    description: string;
+}
+/**
+ * Next step item in summary credential data
+ */
+interface SummaryCredentialNextStep {
+    title: string;
+    description: string;
+    keywords: SummaryCredentialKeyword;
+}
+/**
+ * Reflection item in summary credential data
+ */
+interface SummaryCredentialReflection {
+    title: string;
+    description: string;
+}
+/**
+ * Summary data for an AI Session credential
+ * Contains structured information about what was learned
+ */
+interface SummaryCredentialData {
+    /** Short, concise title for the learning session or credential */
+    title: string;
+    /** Comprehensive summary of what happened during the session */
+    summary: string;
+    /** Bullet points of key knowledge gained */
+    learned: string[];
+    /** Categorized skills learned during the session */
+    skills: SummaryCredentialSkill[];
+    /** Recommended follow-up activities or learning modules */
+    nextSteps: SummaryCredentialNextStep[];
+    /** Reflections on the learning experience */
+    reflections: SummaryCredentialReflection[];
+}
+/**
+ * Input for creating and sending an AI Session credential
+ */
+interface SendAiSessionCredentialInput {
+    /** Title of this specific AI session */
+    sessionTitle: string;
+    /** Structured summary data about what was learned */
+    summaryData: SummaryCredentialData;
+    /** Optional metadata for the session */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Response from sending an AI Session credential
+ */
+interface SendAiSessionCredentialResponse {
+    /** URI of the AI Topic (parent) boost */
+    topicUri: string;
+    /** URI of the topic credential, if a new topic was created */
+    topicCredentialUri?: string;
+    /** URI of the created AI Session credential */
+    sessionCredentialUri: string;
+    /** URI of the session boost (child of topic) */
+    sessionBoostUri: string;
+    /** Whether a new topic was created (true) or existing was used (false) */
+    isNewTopic: boolean;
+}
+/**
+ * Input for sending a notification to the current user from this app.
+ * The notification appears in the user's LearnCard notification inbox.
+ */
+interface AppNotificationInput {
+    /** Notification title */
+    title?: string;
+    /** Notification body text */
+    body?: string;
+    /** Deep link path within the app (e.g. '/prizes') */
+    actionPath?: string;
+    /** Grouping category (e.g. 'reward', 'announcement', 'status') */
+    category?: string;
+    /** Notification priority */
+    priority?: 'normal' | 'high';
+}
+/**
+ * Response from sendNotification
+ */
+interface AppNotificationResponse {
+    sent: boolean;
+}
+/**
+ * Response from incrementCounter
+ */
+interface IncrementCounterResponse {
+    key: string;
+    previousValue: number;
+    newValue: number;
+}
+/**
+ * Response from getCounter
+ */
+interface GetCounterResponse {
+    key: string;
+    value: number;
+    updatedAt: string | null;
+}
+/**
+ * Response from getCounters
+ */
+interface GetCountersResponse {
+    counters: GetCounterResponse[];
+}
 /**
  * Error codes that can be returned by the LearnCard host
  */
@@ -319,11 +503,17 @@ declare class PartnerConnect {
     /**
      * Configure the active host origin using the following hierarchy:
      * 1. Check for `lc_host_override` query parameter (for staging/testing)
-     * 2. Fall back to first configured origin
-     * 3. Fall back to DEFAULT_HOST_ORIGIN
+     * 2. Check sessionStorage for a previously stored override (survives in-app navigation)
+     * 3. Fall back to first configured origin
+     * 4. Fall back to DEFAULT_HOST_ORIGIN
+     *
+     * When a valid override is found in the query parameter, it is persisted to
+     * sessionStorage so that subsequent page navigations within the same tab
+     * automatically use the same override without requiring it in every URL.
      *
      * This origin will be used for all outgoing messages and incoming message validation.
      */
+    private static readonly SESSION_STORAGE_KEY;
     private configureActiveOrigin;
     private isOriginNativeApp;
     /**
@@ -513,25 +703,30 @@ declare class PartnerConnect {
     /**
      * Request user consent for permissions
      *
-     * @param contractUri - URI of the consent contract
+     * @param contractUri - URI of the consent contract (optional for App Store apps with configured contracts)
+     * @param options - Additional options including redirect behavior
      * @returns Promise resolving to consent response
      *
      * @example
      * ```typescript
-     * // Without redirect (default) - returns VP in response if app owns the contract
+     * // With explicit contract URI (for external/non-app store integrations)
      * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');
      * if (response.granted) {
      *   console.log('User granted consent');
-     *   if (response.vp) {
-     *     console.log('VP:', response.vp);
-     *   }
+     * }
+     *
+     * // Without contract URI (uses app's configured contract from integration)
+     * // This works for App Store apps that have configured a contract in their integration
+     * const response = await learnCard.requestConsent();
+     * if (response.granted) {
+     *   console.log('User granted consent using listing contract');
      * }
      *
      * // With redirect - redirects to contract's redirectUrl with VP in URL params
-     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123', { redirect: true });
+     * const response = await learnCard.requestConsent(undefined, { redirect: true });
      * ```
      */
-    requestConsent(contractUri: string, options?: RequestConsentOptions): Promise<ConsentResponse>;
+    requestConsent(contractUri?: string, options?: RequestConsentOptions): Promise<ConsentResponse>;
     /**
      * Initiate a template-based credential issuance flow
      *
@@ -552,6 +747,36 @@ declare class PartnerConnect {
      * ```
      */
     initiateTemplateIssue(templateId: string, draftRecipients?: string[]): Promise<TemplateIssueResponse>;
+    /**
+     * Request comprehensive learner context for AI tutoring systems.
+     *
+     * This method retrieves the user's credentials and personal data,
+     * then formats them into an LLM-ready prompt that can be injected directly into
+     * an AI system prompt.
+     *
+     * @param options - Configuration options for what data to include and how to format it
+     * @returns Promise resolving to learner context with prompt and optional raw data
+     *
+     * @example
+     * ```typescript
+     * // Get LLM-ready prompt with credentials and personal data
+     * const context = await learnCard.requestLearnerContext({
+     *   includeCredentials: true,
+     *   includePersonalData: true,
+     *   format: 'prompt',
+     *   instructions: 'Focus on technical skills and certifications',
+     *   detailLevel: 'expanded'
+     * });
+     *
+     * // Use in AI system prompt
+     * const systemPrompt = `You are a helpful tutor. ${context.prompt}`;
+     *
+     * // Access structured data if needed
+     * console.log('User DID:', context.did);
+     * console.log('Credentials count:', context.raw?.credentials.length);
+     * ```
+     */
+    requestLearnerContext(options?: RequestLearnerContextOptions): Promise<LearnerContextResponse>;
     /**
      * Send a generic event to be processed by the brain service on behalf of this app.
      * This is used for backend-like operations such as issuing credentials.
@@ -574,6 +799,36 @@ declare class PartnerConnect {
      * ```
      */
     sendAppEvent<T = AppEventResponse>(event: AppEvent): Promise<T>;
+    /**
+     * Create and send an AI Session credential to the user.
+     *
+     * This method manages the AI Topic → AI Session hierarchy:
+     * - Ensures an AI Topic exists for this app (creates one if needed)
+     * - Creates a new AI Session as a child of the topic
+     * - The topic appears in the user's AI Sessions page with the app's name
+     * - All sessions from this app are organized under that topic
+     *
+     * @param input - Session details including title and optional metadata
+     * @returns Promise resolving to topic and session URIs
+     */
+    sendAiSessionCredential(input: SendAiSessionCredentialInput): Promise<SendAiSessionCredentialResponse>;
+    /**
+     * Send a notification to the current user from this app.
+     * The notification appears in the user's LearnCard notification inbox.
+     */
+    sendNotification(input: AppNotificationInput): Promise<AppNotificationResponse>;
+    /**
+     * Increment or decrement an app-scoped counter for the current user.
+     */
+    incrementCounter(key: string, amount: number): Promise<IncrementCounterResponse>;
+    /**
+     * Read the current value of an app-scoped counter for the current user.
+     */
+    getCounter(key: string): Promise<GetCounterResponse>;
+    /**
+     * Read multiple app-scoped counters at once for the current user.
+     */
+    getCounters(keys?: string[]): Promise<GetCountersResponse>;
     /**
      * Clean up the SDK and remove event listeners
      */
@@ -596,4 +851,4 @@ declare class PartnerConnect {
  */
 declare function createPartnerConnect(options?: PartnerConnectOptions): PartnerConnect;
 
-export { CheckCredentialInput, CheckCredentialResponse, CheckIssuanceStatusInput, ConsentResponse, CredentialSearchResponse, CredentialSpecificResponse, ErrorCode, GetTemplateRecipientsInput, IdentityResponse, LearnCardError, PartnerConnect, PartnerConnectOptions, PendingRequest, PostMessageRequest, PostMessageResponse, RequestConsentOptions, SendCredentialResponse, TemplateCredentialInput, TemplateCredentialResponse, TemplateIssuanceStatusResponse, TemplateIssueResponse, TemplateRecipientRecord, TemplateRecipientsResponse, VPRQuery, VerifiablePresentationRequest, createPartnerConnect, createPartnerConnect as default };
+export { AppNotificationInput, AppNotificationResponse, CheckCredentialInput, CheckCredentialResponse, CheckIssuanceStatusInput, ConsentResponse, CredentialSearchResponse, CredentialSpecificResponse, ErrorCode, GetCounterResponse, GetCountersResponse, GetTemplateRecipientsInput, IdentityResponse, IncrementCounterResponse, LearnCardError, LearnerContextRawData, LearnerContextResponse, PartnerConnect, PartnerConnectOptions, PendingRequest, PostMessageRequest, PostMessageResponse, RequestConsentOptions, RequestConsentPayload, RequestLearnerContextOptions, SendAiSessionCredentialInput, SendAiSessionCredentialResponse, SendCredentialResponse, SummaryCredentialData, SummaryCredentialKeyword, SummaryCredentialNextStep, SummaryCredentialReflection, SummaryCredentialSkill, TemplateCredentialInput, TemplateCredentialResponse, TemplateIssuanceStatusResponse, TemplateIssueResponse, TemplateRecipientRecord, TemplateRecipientsResponse, VPRQuery, VerifiablePresentationRequest, createPartnerConnect, createPartnerConnect as default };

package/dist/partner-connect.esm.js

@@ -21,14 +21,6 @@ const _PartnerConnect = class _PartnerConnect {
     this.configureActiveOrigin();
     this.setupMessageListener();
   }
-  /**
-   * Configure the active host origin using the following hierarchy:
-   * 1. Check for `lc_host_override` query parameter (for staging/testing)
-   * 2. Fall back to first configured origin
-   * 3. Fall back to DEFAULT_HOST_ORIGIN
-   *
-   * This origin will be used for all outgoing messages and incoming message validation.
-   */
   configureActiveOrigin() {
     if (typeof window === "undefined") {
       this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
@@ -48,11 +40,25 @@ const _PartnerConnect = class _PartnerConnect {
           this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
         } else {
           this.activeHostOrigin = hostOverride;
+          try {
+            sessionStorage.setItem(_PartnerConnect.SESSION_STORAGE_KEY, hostOverride);
+          } catch {
+          }
           console.log("[LearnCard SDK] Using lc_host_override:", hostOverride);
         }
       } else {
-        this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
-        console.log("[LearnCard SDK] Using configured origin:", this.activeHostOrigin);
+        let storedOverride = null;
+        try {
+          storedOverride = sessionStorage.getItem(_PartnerConnect.SESSION_STORAGE_KEY);
+        } catch {
+        }
+        if (storedOverride && this.isOriginInWhitelist(storedOverride)) {
+          this.activeHostOrigin = storedOverride;
+          console.log("[LearnCard SDK] Using stored lc_host_override:", storedOverride);
+        } else {
+          this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
+          console.log("[LearnCard SDK] Using configured origin:", this.activeHostOrigin);
+        }
       }
     } catch (error) {
       console.error("[LearnCard SDK] Error configuring active origin:", error);
@@ -354,22 +360,27 @@ const _PartnerConnect = class _PartnerConnect {
   /**
    * Request user consent for permissions
    *
-   * @param contractUri - URI of the consent contract
+   * @param contractUri - URI of the consent contract (optional for App Store apps with configured contracts)
+   * @param options - Additional options including redirect behavior
    * @returns Promise resolving to consent response
    *
    * @example
    * ```typescript
-   * // Without redirect (default) - returns VP in response if app owns the contract
+   * // With explicit contract URI (for external/non-app store integrations)
    * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');
    * if (response.granted) {
    *   console.log('User granted consent');
-   *   if (response.vp) {
-   *     console.log('VP:', response.vp);
-   *   }
+   * }
+   *
+   * // Without contract URI (uses app's configured contract from integration)
+   * // This works for App Store apps that have configured a contract in their integration
+   * const response = await learnCard.requestConsent();
+   * if (response.granted) {
+   *   console.log('User granted consent using listing contract');
    * }
    *
    * // With redirect - redirects to contract's redirectUrl with VP in URL params
-   * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123', { redirect: true });
+   * const response = await learnCard.requestConsent(undefined, { redirect: true });
    * ```
    */
   requestConsent(contractUri, options = {}) {
@@ -404,6 +415,45 @@ const _PartnerConnect = class _PartnerConnect {
       draftRecipients: draftRecipients || []
     });
   }
+  /**
+   * Request comprehensive learner context for AI tutoring systems.
+   *
+   * This method retrieves the user's credentials and personal data,
+   * then formats them into an LLM-ready prompt that can be injected directly into
+   * an AI system prompt.
+   *
+   * @param options - Configuration options for what data to include and how to format it
+   * @returns Promise resolving to learner context with prompt and optional raw data
+   *
+   * @example
+   * ```typescript
+   * // Get LLM-ready prompt with credentials and personal data
+   * const context = await learnCard.requestLearnerContext({
+   *   includeCredentials: true,
+   *   includePersonalData: true,
+   *   format: 'prompt',
+   *   instructions: 'Focus on technical skills and certifications',
+   *   detailLevel: 'expanded'
+   * });
+   *
+   * // Use in AI system prompt
+   * const systemPrompt = `You are a helpful tutor. ${context.prompt}`;
+   *
+   * // Access structured data if needed
+   * console.log('User DID:', context.did);
+   * console.log('Credentials count:', context.raw?.credentials.length);
+   * ```
+   */
+  requestLearnerContext(options) {
+    var _a, _b, _c, _d;
+    return this.sendMessage("REQUEST_LEARNER_CONTEXT", {
+      includeCredentials: (_a = options == null ? void 0 : options.includeCredentials) != null ? _a : true,
+      includePersonalData: (_b = options == null ? void 0 : options.includePersonalData) != null ? _b : false,
+      format: (_c = options == null ? void 0 : options.format) != null ? _c : "prompt",
+      instructions: options == null ? void 0 : options.instructions,
+      detailLevel: (_d = options == null ? void 0 : options.detailLevel) != null ? _d : "compact"
+    });
+  }
   /**
    * Send a generic event to be processed by the brain service on behalf of this app.
    * This is used for backend-like operations such as issuing credentials.
@@ -428,6 +478,62 @@ const _PartnerConnect = class _PartnerConnect {
   sendAppEvent(event) {
     return this.sendMessage("APP_EVENT", event);
   }
+  /**
+   * Create and send an AI Session credential to the user.
+   *
+   * This method manages the AI Topic → AI Session hierarchy:
+   * - Ensures an AI Topic exists for this app (creates one if needed)
+   * - Creates a new AI Session as a child of the topic
+   * - The topic appears in the user's AI Sessions page with the app's name
+   * - All sessions from this app are organized under that topic
+   *
+   * @param input - Session details including title and optional metadata
+   * @returns Promise resolving to topic and session URIs
+   */
+  sendAiSessionCredential(input) {
+    return this.sendAppEvent({
+      type: "send-ai-session-credential",
+      ...input
+    });
+  }
+  /**
+   * Send a notification to the current user from this app.
+   * The notification appears in the user's LearnCard notification inbox.
+   */
+  sendNotification(input) {
+    return this.sendAppEvent({
+      type: "send-notification",
+      ...input
+    });
+  }
+  /**
+   * Increment or decrement an app-scoped counter for the current user.
+   */
+  incrementCounter(key, amount) {
+    return this.sendAppEvent({
+      type: "increment-counter",
+      key,
+      amount
+    });
+  }
+  /**
+   * Read the current value of an app-scoped counter for the current user.
+   */
+  getCounter(key) {
+    return this.sendAppEvent({
+      type: "get-counter",
+      key
+    });
+  }
+  /**
+   * Read multiple app-scoped counters at once for the current user.
+   */
+  getCounters(keys) {
+    return this.sendAppEvent({
+      type: "get-counters",
+      ...keys ? { keys } : {}
+    });
+  }
   /**
    * Clean up the SDK and remove event listeners
    */
@@ -449,6 +555,20 @@ const _PartnerConnect = class _PartnerConnect {
 };
 /** Default host origin (security anchor) */
 __publicField(_PartnerConnect, "DEFAULT_HOST_ORIGIN", "https://learncard.app");
+/**
+ * Configure the active host origin using the following hierarchy:
+ * 1. Check for `lc_host_override` query parameter (for staging/testing)
+ * 2. Check sessionStorage for a previously stored override (survives in-app navigation)
+ * 3. Fall back to first configured origin
+ * 4. Fall back to DEFAULT_HOST_ORIGIN
+ *
+ * When a valid override is found in the query parameter, it is persisted to
+ * sessionStorage so that subsequent page navigations within the same tab
+ * automatically use the same override without requiring it in every URL.
+ *
+ * This origin will be used for all outgoing messages and incoming message validation.
+ */
+__publicField(_PartnerConnect, "SESSION_STORAGE_KEY", "lc_host_override");
 let PartnerConnect = _PartnerConnect;
 function createPartnerConnect(options) {
   return new PartnerConnect(options);

package/dist/partner-connect.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"partner-connect.esm.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * LearnCard Partner Connect SDK\n *\n * A Promise-based JavaScript utility for managing cross-origin message communication\n * between partner apps and the LearnCard host application.\n *\n * @example\n * ```typescript\n * import { createPartnerConnect } from '@learncard/partner-connect';\n *\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app'\n * });\n *\n * // Request user identity (SSO)\n * const identity = await learnCard.requestIdentity();\n * console.log('User DID:', identity.user.did);\n * ```\n */\n\nimport type {\n    PartnerConnectOptions,\n    IdentityResponse,\n    SendCredentialResponse,\n    TemplateCredentialInput,\n    TemplateCredentialResponse,\n    VerifiablePresentationRequest,\n    CredentialSearchResponse,\n    CredentialSpecificResponse,\n    ConsentResponse,\n    RequestConsentOptions,\n    TemplateIssueResponse,\n    CheckCredentialInput,\n    CheckCredentialResponse,\n    CheckIssuanceStatusInput,\n    TemplateIssuanceStatusResponse,\n    GetTemplateRecipientsInput,\n    TemplateRecipientsResponse,\n    AppEvent,\n    AppEventResponse,\n    LearnCardError,\n    PostMessageRequest,\n    PostMessageResponse,\n    PendingRequest,\n} from './types';\n\nexport type * from './types';\n\n/**\n * LearnCard Partner Connect SDK class\n */\nexport class PartnerConnect {\n    /** Default host origin (security anchor) */\n    public static readonly DEFAULT_HOST_ORIGIN = 'https://learncard.app';\n\n    private hostOrigins: string[] = ['https://learncard.app'];\n    private activeHostOrigin: string = 'https://learncard.app';\n    private allowNativeAppOrigins: boolean = true;\n    private protocol: string = 'LEARNCARD_V1';\n    private requestTimeout: number = 30000;\n    private pendingRequests: Map<string, PendingRequest>;\n    private messageListener: ((event: MessageEvent) => void) | null = null;\n    private isInitialized = false;\n\n    constructor(options?: PartnerConnectOptions) {\n        // Normalize hostOrigin to an array for whitelist validation\n        const hostOrigin = options?.hostOrigin || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        this.hostOrigins = Array.isArray(hostOrigin) ? hostOrigin : [hostOrigin];\n\n        this.protocol = options?.protocol || 'LEARNCARD_V1';\n        this.requestTimeout = options?.requestTimeout || 30000;\n        this.allowNativeAppOrigins = options?.allowNativeAppOrigins ?? true;\n        this.pendingRequests = new Map();\n        this.configureActiveOrigin();\n        this.setupMessageListener();\n    }\n\n    /**\n     * Configure the active host origin using the following hierarchy:\n     * 1. Check for `lc_host_override` query parameter (for staging/testing)\n     * 2. Fall back to first configured origin\n     * 3. Fall back to DEFAULT_HOST_ORIGIN\n     *\n     * This origin will be used for all outgoing messages and incoming message validation.\n     */\n    private configureActiveOrigin(): void {\n        if (typeof window === 'undefined') {\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n            return;\n        }\n\n        try {\n            // Check for lc_host_override query parameter\n            const urlParams = new URLSearchParams(window.location.search);\n            const hostOverride = urlParams.get('lc_host_override');\n\n            if (hostOverride) {\n                // Validate override against whitelist (if provided)\n                if (this.hostOrigins.length > 0 && !this.isOriginInWhitelist(hostOverride)) {\n                    console.warn(\n                        '[LearnCard SDK] lc_host_override value is not in the configured whitelist:',\n                        hostOverride,\n                        'Allowed:',\n                        this.hostOrigins\n                    );\n                    this.activeHostOrigin =\n                        this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                } else {\n                    this.activeHostOrigin = hostOverride;\n                    console.log('[LearnCard SDK] Using lc_host_override:', hostOverride);\n                }\n            } else {\n                // Use first configured origin or default\n                this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                console.log('[LearnCard SDK] Using configured origin:', this.activeHostOrigin);\n            }\n        } catch (error) {\n            console.error('[LearnCard SDK] Error configuring active origin:', error);\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        }\n    }\n\n    private isOriginNativeApp(origin: string): boolean {\n        return (\n            origin.startsWith('capacitor://') ||\n            origin.startsWith('ionic://') ||\n            origin.startsWith('https://localhost') ||\n            origin.startsWith('http://localhost') ||\n            origin.startsWith('http://127.0.0.1')\n        );\n    }\n\n    /**\n     * Check if an origin is in the configured whitelist\n     */\n    private isOriginInWhitelist(origin: string): boolean {\n        return (\n            this.hostOrigins.includes(origin) ||\n            (this.allowNativeAppOrigins && this.isOriginNativeApp(origin))\n        );\n    }\n\n    /**\n     * Check if an event origin is valid against the active host origin\n     *\n     * Security Rule: Incoming messages must exactly match the active host origin.\n     * This prevents malicious actors from spoofing origins via query parameters.\n     *\n     * @param eventOrigin - The origin from the MessageEvent\n     * @returns true if the origin is valid\n     */\n    private isValidOrigin(eventOrigin: string): boolean {\n        // STRICT: Exact match with active host origin only\n        return eventOrigin === this.activeHostOrigin;\n    }\n\n    /**\n     * Set up the central message listener to handle responses from the LearnCard host\n     */\n    private setupMessageListener(): void {\n        if (typeof window === 'undefined') {\n            throw new Error('PartnerConnect SDK can only be used in a browser environment');\n        }\n\n        this.messageListener = (event: MessageEvent) => {\n            // SECURITY CHECK 1: Strict origin validation - must exactly match active host origin\n            if (!this.isValidOrigin(event.origin)) {\n                // Silently ignore messages from unauthorized origins\n                return;\n            }\n\n            const data = event.data as PostMessageResponse;\n\n            // SECURITY CHECK 2: Validate protocol and requestId\n            if (data.protocol !== this.protocol || !data.requestId) {\n                return;\n            }\n\n            // Look up the pending request\n            const pending = this.pendingRequests.get(data.requestId);\n            if (!pending) {\n                return; // Ignore stale or unrecognized responses\n            }\n\n            // Clean up\n            clearTimeout(pending.timeoutId);\n            this.pendingRequests.delete(data.requestId);\n\n            // Resolve or reject the promise\n            if (data.type === 'SUCCESS') {\n                pending.resolve(data.data);\n            } else if (data.type === 'ERROR') {\n                pending.reject(\n                    data.error || { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred' }\n                );\n            }\n        };\n\n        window.addEventListener('message', this.messageListener);\n        this.isInitialized = true;\n    }\n\n    /**\n     * Generate a unique request ID\n     */\n    private generateRequestId(action: string): string {\n        return `${action}-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n    }\n\n    /**\n     * Send a message to the parent window and return a Promise\n     */\n    private sendMessage<T = unknown>(action: string, payload?: unknown): Promise<T> {\n        if (!this.isInitialized) {\n            return Promise.reject({\n                code: 'SDK_NOT_INITIALIZED',\n                message: 'SDK is not initialized',\n            } as LearnCardError);\n        }\n\n        return new Promise<T>((resolve, reject) => {\n            const requestId = this.generateRequestId(action);\n\n            // Set up timeout\n            const timeoutId = setTimeout(() => {\n                if (this.pendingRequests.has(requestId)) {\n                    this.pendingRequests.delete(requestId);\n                    reject({\n                        code: 'LC_TIMEOUT',\n                        message: `Request ${action} timed out after ${this.requestTimeout}ms`,\n                    } as LearnCardError);\n                }\n            }, this.requestTimeout);\n\n            // Store the pending request\n            this.pendingRequests.set(requestId, {\n                resolve: resolve as (value: unknown) => void,\n                reject,\n                timeoutId,\n            });\n\n            // Construct the message\n            const message: PostMessageRequest = {\n                protocol: this.protocol,\n                action,\n                requestId,\n                payload,\n            };\n\n            // Send to parent window with the active host origin (configured or overridden)\n            window.parent.postMessage(message, this.activeHostOrigin);\n        });\n    }\n\n    /**\n     * Request user identity (Single Sign-On)\n     *\n     * @returns Promise resolving to user identity including DID and JWT token\n     * @throws {LearnCardError} When user is not authenticated or request fails\n     *\n     * @example\n     * ```typescript\n     * const identity = await learnCard.requestIdentity();\n     * console.log('User DID:', identity.user.did);\n     * console.log('JWT Token:', identity.token);\n     * ```\n     */\n    public requestIdentity(): Promise<IdentityResponse> {\n        return this.sendMessage<IdentityResponse>('REQUEST_IDENTITY', {\n            challenge: `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,\n        });\n    }\n\n    /**\n     * Send a credential to the user's LearnCard wallet\n     *\n     * Supports two modes:\n     * 1. **Raw credential**: Pass a full verifiable credential object\n     * 2. **Template-based**: Pass `{ templateAlias, templateData }` to issue from a pre-configured boost template\n     *\n     * @param input - Either a verifiable credential or a template-based input\n     * @returns Promise resolving to credential response\n     *\n     * @example Raw credential\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   '@context': ['https://www.w3.org/2018/credentials/v1'],\n     *   type: ['VerifiableCredential'],\n     *   credentialSubject: { id: 'did:example:123' }\n     * });\n     * console.log('Credential ID:', response.credentialId);\n     * ```\n     *\n     * @example Template-based (for App Store apps)\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95', courseName: 'Web Dev 101' }\n     * });\n     * console.log('Credential URI:', response.credentialUri);\n     * ```\n     */\n    public sendCredential(\n        input: unknown | TemplateCredentialInput\n    ): Promise<SendCredentialResponse | TemplateCredentialResponse> {\n        if (\n            input &&\n            typeof input === 'object' &&\n            'templateAlias' in input &&\n            typeof (input as TemplateCredentialInput).templateAlias === 'string'\n        ) {\n            const templateInput = input as TemplateCredentialInput;\n\n            return this.sendAppEvent<TemplateCredentialResponse>({\n                type: 'send-credential',\n                templateAlias: templateInput.templateAlias,\n                templateData: templateInput.templateData,\n                preventDuplicateClaim: templateInput.preventDuplicateClaim,\n            });\n        }\n\n        return this.sendMessage<SendCredentialResponse>('SEND_CREDENTIAL', { credential: input });\n    }\n\n    /**\n     * Check whether the current user already has a credential from a given boost template.\n     * This is a silent, non-interactive status check for installed app integrations.\n     */\n    public checkUserHasCredential(input: CheckCredentialInput): Promise<CheckCredentialResponse> {\n        return this.sendAppEvent<CheckCredentialResponse>({\n            type: 'check-credential',\n            ...input,\n        });\n    }\n\n    /**\n     * Check if the current user has issued/sent a specific template to someone.\n     * Returns issuance status including sent date and claim status.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and recipient identifier (recipientDid or recipientProfileId)\n     * @returns Promise resolving to issuance status response\n     *\n     * @example\n     * ```typescript\n     * // Check if user already issued 'achievement-badge' to a specific person\n     * const status = await learnCard.getTemplateIssuanceStatus({\n     *   templateAlias: 'achievement-badge',\n     *   recipientProfileId: 'user123'\n     * });\n     *\n     * if (status.sent) {\n     *   console.log('Already issued on:', status.sentDate);\n     *   console.log('Status:', status.status); // 'pending', 'claimed', or 'revoked'\n     * }\n     * ```\n     */\n    public getTemplateIssuanceStatus(\n        input: CheckIssuanceStatusInput\n    ): Promise<TemplateIssuanceStatusResponse> {\n        return this.sendAppEvent<TemplateIssuanceStatusResponse>({\n            type: 'check-issuance-status',\n            ...input,\n        });\n    }\n\n    /**\n     * Get the list of all recipients for a specific template/boost.\n     * Useful for dashboards showing who has received a credential.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and optional pagination params\n     * @returns Promise resolving to paginated list of recipients\n     *\n     * @example\n     * ```typescript\n     * // Get first 10 recipients of 'achievement-badge'\n     * const recipients = await learnCard.getTemplateRecipients({\n     *   templateAlias: 'achievement-badge',\n     *   limit: 10\n     * });\n     *\n     * console.log(`Found ${recipients.records.length} recipients`);\n     * recipients.records.forEach(r => {\n     *   console.log(`${r.recipientDisplayName}: ${r.status}`);\n     * });\n     *\n     * // Get next page if available\n     * if (recipients.hasMore) {\n     *   const nextPage = await learnCard.getTemplateRecipients({\n     *     templateAlias: 'achievement-badge',\n     *     limit: 10,\n     *     cursor: recipients.cursor\n     *   });\n     * }\n     * ```\n     */\n    public getTemplateRecipients(\n        input: GetTemplateRecipientsInput\n    ): Promise<TemplateRecipientsResponse> {\n        return this.sendAppEvent<TemplateRecipientsResponse>({\n            type: 'get-template-recipients',\n            ...input,\n        });\n    }\n\n    /**\n     * Launch a feature in the LearnCard host application\n     *\n     * @param featurePath - Path to the feature (e.g., '/ai/topics')\n     * @param initialPrompt - Optional initial prompt or data\n     *\n     * @example\n     * ```typescript\n     * await learnCard.launchFeature(\n     *   '/ai/topics?shortCircuitStep=newTopic',\n     *   'Help me understand cryptography'\n     * );\n     * ```\n     */\n    public launchFeature(featurePath: string, initialPrompt?: string): Promise<void> {\n        return this.sendMessage<void>('LAUNCH_FEATURE', { featurePath, initialPrompt });\n    }\n\n    /**\n     * Request credentials from the user's wallet using a query\n     *\n     * @param verifiablePresentationRequest - VPR with query criteria\n     * @returns Promise resolving to verifiable presentation\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSearch({\n     *   query: [{\n     *     type: 'QueryByTitle',\n     *     credentialQuery: {\n     *       reason: 'We need to verify your skills',\n     *       title: 'JavaScript Expert'\n     *     }\n     *   }],\n     *   challenge: 'challenge-123',\n     *   domain: window.location.hostname\n     * });\n     *\n     * if (response.verifiablePresentation) {\n     *   console.log('Received credentials:', response.verifiablePresentation.verifiableCredential);\n     * }\n     * ```\n     */\n    public askCredentialSearch(\n        verifiablePresentationRequest: VerifiablePresentationRequest\n    ): Promise<CredentialSearchResponse> {\n        return this.sendMessage<CredentialSearchResponse>('ASK_CREDENTIAL_SEARCH', {\n            verifiablePresentationRequest,\n        });\n    }\n\n    /**\n     * Request a specific credential by ID\n     *\n     * @param credentialId - The ID of the credential to request\n     * @returns Promise resolving to the credential\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSpecific('credential-id-123');\n     * if (response.credential) {\n     *   console.log('Received credential:', response.credential);\n     * }\n     * ```\n     */\n    public askCredentialSpecific(credentialId: string): Promise<CredentialSpecificResponse> {\n        return this.sendMessage<CredentialSpecificResponse>('ASK_CREDENTIAL_SPECIFIC', {\n            credentialId,\n        });\n    }\n\n    /**\n     * Request user consent for permissions\n     *\n     * @param contractUri - URI of the consent contract\n     * @returns Promise resolving to consent response\n     *\n     * @example\n     * ```typescript\n     * // Without redirect (default) - returns VP in response if app owns the contract\n     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');\n     * if (response.granted) {\n     *   console.log('User granted consent');\n     *   if (response.vp) {\n     *     console.log('VP:', response.vp);\n     *   }\n     * }\n     *\n     * // With redirect - redirects to contract's redirectUrl with VP in URL params\n     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123', { redirect: true });\n     * ```\n     */\n    public requestConsent(\n        contractUri: string,\n        options: RequestConsentOptions = {}\n    ): Promise<ConsentResponse> {\n        const { redirect = false } = options;\n\n        return this.sendMessage<ConsentResponse>('REQUEST_CONSENT', {\n            contractUri,\n            redirect,\n        });\n    }\n\n    /**\n     * Initiate a template-based credential issuance flow\n     *\n     * @param templateId - ID of the template/boost to issue\n     * @param draftRecipients - Optional array of recipient DIDs\n     * @returns Promise resolving to template issue response\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.initiateTemplateIssue(\n     *   'lc:network:network.learncard.com/trpc:boost:xyz789',\n     *   ['did:key:abc', 'did:key:def']\n     * );\n     *\n     * if (response.issued) {\n     *   console.log('Template issued successfully');\n     * }\n     * ```\n     */\n    public initiateTemplateIssue(\n        templateId: string,\n        draftRecipients?: string[]\n    ): Promise<TemplateIssueResponse> {\n        return this.sendMessage<TemplateIssueResponse>('INITIATE_TEMPLATE_ISSUE', {\n            templateId,\n            draftRecipients: draftRecipients || [],\n        });\n    }\n\n    /**\n     * Send a generic event to be processed by the brain service on behalf of this app.\n     * This is used for backend-like operations such as issuing credentials.\n     *\n     * @param event - The event payload to send\n     * @returns Promise resolving to the event response\n     *\n     * @example\n     * ```typescript\n     * // Issue a credential to the current user\n     * const response = await learnCard.sendAppEvent({\n     *   type: 'send-credential',\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95' }\n     * });\n     *\n     * if (response.credentialUri) {\n     *   console.log('Credential issued:', response.credentialUri);\n     * }\n     * ```\n     */\n    public sendAppEvent<T = AppEventResponse>(event: AppEvent): Promise<T> {\n        return this.sendMessage<T>('APP_EVENT', event);\n    }\n\n    /**\n     * Clean up the SDK and remove event listeners\n     */\n    public destroy(): void {\n        if (this.messageListener) {\n            window.removeEventListener('message', this.messageListener);\n            this.messageListener = null;\n        }\n\n        // Reject all pending requests\n        for (const [requestId, pending] of this.pendingRequests.entries()) {\n            clearTimeout(pending.timeoutId);\n            pending.reject({\n                code: 'SDK_DESTROYED',\n                message: 'SDK was destroyed before request completed',\n            });\n        }\n\n        this.pendingRequests.clear();\n        this.isInitialized = false;\n    }\n}\n\n/**\n * Factory function to create a PartnerConnect instance\n *\n * @param options - Configuration options\n * @returns PartnerConnect instance\n *\n * @example\n * ```typescript\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app',\n *   protocol: 'LEARNCARD_V1',\n *   requestTimeout: 30000\n * });\n * ```\n */\nexport function createPartnerConnect(options?: PartnerConnectOptions): PartnerConnect {\n    return new PartnerConnect(options);\n}\n\n// Default export for convenience\nexport default createPartnerConnect;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"partner-connect.esm.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * LearnCard Partner Connect SDK\n *\n * A Promise-based JavaScript utility for managing cross-origin message communication\n * between partner apps and the LearnCard host application.\n *\n * @example\n * ```typescript\n * import { createPartnerConnect } from '@learncard/partner-connect';\n *\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app'\n * });\n *\n * // Request user identity (SSO)\n * const identity = await learnCard.requestIdentity();\n * console.log('User DID:', identity.user.did);\n * ```\n */\n\nimport type {\n    PartnerConnectOptions,\n    IdentityResponse,\n    SendCredentialResponse,\n    TemplateCredentialInput,\n    TemplateCredentialResponse,\n    VerifiablePresentationRequest,\n    CredentialSearchResponse,\n    CredentialSpecificResponse,\n    ConsentResponse,\n    RequestConsentOptions,\n    TemplateIssueResponse,\n    CheckCredentialInput,\n    CheckCredentialResponse,\n    CheckIssuanceStatusInput,\n    TemplateIssuanceStatusResponse,\n    GetTemplateRecipientsInput,\n    TemplateRecipientsResponse,\n    RequestLearnerContextOptions,\n    LearnerContextResponse,\n    SendAiSessionCredentialInput,\n    SendAiSessionCredentialResponse,\n    AppNotificationInput,\n    AppNotificationResponse,\n    IncrementCounterResponse,\n    GetCounterResponse,\n    GetCountersResponse,\n    AppEvent,\n    AppEventResponse,\n    LearnCardError,\n    PostMessageRequest,\n    PostMessageResponse,\n    PendingRequest,\n} from './types';\n\nexport type * from './types';\n\n/**\n * LearnCard Partner Connect SDK class\n */\nexport class PartnerConnect {\n    /** Default host origin (security anchor) */\n    public static readonly DEFAULT_HOST_ORIGIN = 'https://learncard.app';\n\n    private hostOrigins: string[] = ['https://learncard.app'];\n    private activeHostOrigin: string = 'https://learncard.app';\n    private allowNativeAppOrigins: boolean = true;\n    private protocol: string = 'LEARNCARD_V1';\n    private requestTimeout: number = 30000;\n    private pendingRequests: Map<string, PendingRequest>;\n    private messageListener: ((event: MessageEvent) => void) | null = null;\n    private isInitialized = false;\n\n    constructor(options?: PartnerConnectOptions) {\n        // Normalize hostOrigin to an array for whitelist validation\n        const hostOrigin = options?.hostOrigin || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        this.hostOrigins = Array.isArray(hostOrigin) ? hostOrigin : [hostOrigin];\n\n        this.protocol = options?.protocol || 'LEARNCARD_V1';\n        this.requestTimeout = options?.requestTimeout || 30000;\n        this.allowNativeAppOrigins = options?.allowNativeAppOrigins ?? true;\n        this.pendingRequests = new Map();\n        this.configureActiveOrigin();\n        this.setupMessageListener();\n    }\n\n    /**\n     * Configure the active host origin using the following hierarchy:\n     * 1. Check for `lc_host_override` query parameter (for staging/testing)\n     * 2. Check sessionStorage for a previously stored override (survives in-app navigation)\n     * 3. Fall back to first configured origin\n     * 4. Fall back to DEFAULT_HOST_ORIGIN\n     *\n     * When a valid override is found in the query parameter, it is persisted to\n     * sessionStorage so that subsequent page navigations within the same tab\n     * automatically use the same override without requiring it in every URL.\n     *\n     * This origin will be used for all outgoing messages and incoming message validation.\n     */\n    private static readonly SESSION_STORAGE_KEY = 'lc_host_override';\n\n    private configureActiveOrigin(): void {\n        if (typeof window === 'undefined') {\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n            return;\n        }\n\n        try {\n            // Check for lc_host_override query parameter\n            const urlParams = new URLSearchParams(window.location.search);\n            const hostOverride = urlParams.get('lc_host_override');\n\n            if (hostOverride) {\n                // Validate override against whitelist (if provided)\n                if (this.hostOrigins.length > 0 && !this.isOriginInWhitelist(hostOverride)) {\n                    console.warn(\n                        '[LearnCard SDK] lc_host_override value is not in the configured whitelist:',\n                        hostOverride,\n                        'Allowed:',\n                        this.hostOrigins\n                    );\n                    this.activeHostOrigin =\n                        this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                } else {\n                    this.activeHostOrigin = hostOverride;\n\n                    // Persist to sessionStorage so subsequent page navigations\n                    // within this tab automatically use the same override.\n                    try {\n                        sessionStorage.setItem(PartnerConnect.SESSION_STORAGE_KEY, hostOverride);\n                    } catch {\n                        // sessionStorage may be unavailable (e.g. sandboxed iframes)\n                    }\n\n                    console.log('[LearnCard SDK] Using lc_host_override:', hostOverride);\n                }\n            } else {\n                // Fall back to a previously stored override from this session\n                let storedOverride: string | null = null;\n\n                try {\n                    storedOverride = sessionStorage.getItem(PartnerConnect.SESSION_STORAGE_KEY);\n                } catch {\n                    // sessionStorage may be unavailable\n                }\n\n                if (storedOverride && this.isOriginInWhitelist(storedOverride)) {\n                    this.activeHostOrigin = storedOverride;\n                    console.log('[LearnCard SDK] Using stored lc_host_override:', storedOverride);\n                } else {\n                    // Use first configured origin or default\n                    this.activeHostOrigin =\n                        this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                    console.log('[LearnCard SDK] Using configured origin:', this.activeHostOrigin);\n                }\n            }\n        } catch (error) {\n            console.error('[LearnCard SDK] Error configuring active origin:', error);\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        }\n    }\n\n    private isOriginNativeApp(origin: string): boolean {\n        return (\n            origin.startsWith('capacitor://') ||\n            origin.startsWith('ionic://') ||\n            origin.startsWith('https://localhost') ||\n            origin.startsWith('http://localhost') ||\n            origin.startsWith('http://127.0.0.1')\n        );\n    }\n\n    /**\n     * Check if an origin is in the configured whitelist\n     */\n    private isOriginInWhitelist(origin: string): boolean {\n        return (\n            this.hostOrigins.includes(origin) ||\n            (this.allowNativeAppOrigins && this.isOriginNativeApp(origin))\n        );\n    }\n\n    /**\n     * Check if an event origin is valid against the active host origin\n     *\n     * Security Rule: Incoming messages must exactly match the active host origin.\n     * This prevents malicious actors from spoofing origins via query parameters.\n     *\n     * @param eventOrigin - The origin from the MessageEvent\n     * @returns true if the origin is valid\n     */\n    private isValidOrigin(eventOrigin: string): boolean {\n        // STRICT: Exact match with active host origin only\n        return eventOrigin === this.activeHostOrigin;\n    }\n\n    /**\n     * Set up the central message listener to handle responses from the LearnCard host\n     */\n    private setupMessageListener(): void {\n        if (typeof window === 'undefined') {\n            throw new Error('PartnerConnect SDK can only be used in a browser environment');\n        }\n\n        this.messageListener = (event: MessageEvent) => {\n            // SECURITY CHECK 1: Strict origin validation - must exactly match active host origin\n            if (!this.isValidOrigin(event.origin)) {\n                // Silently ignore messages from unauthorized origins\n                return;\n            }\n\n            const data = event.data as PostMessageResponse;\n\n            // SECURITY CHECK 2: Validate protocol and requestId\n            if (data.protocol !== this.protocol || !data.requestId) {\n                return;\n            }\n\n            // Look up the pending request\n            const pending = this.pendingRequests.get(data.requestId);\n            if (!pending) {\n                return; // Ignore stale or unrecognized responses\n            }\n\n            // Clean up\n            clearTimeout(pending.timeoutId);\n            this.pendingRequests.delete(data.requestId);\n\n            // Resolve or reject the promise\n            if (data.type === 'SUCCESS') {\n                pending.resolve(data.data);\n            } else if (data.type === 'ERROR') {\n                pending.reject(\n                    data.error || { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred' }\n                );\n            }\n        };\n\n        window.addEventListener('message', this.messageListener);\n        this.isInitialized = true;\n    }\n\n    /**\n     * Generate a unique request ID\n     */\n    private generateRequestId(action: string): string {\n        return `${action}-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n    }\n\n    /**\n     * Send a message to the parent window and return a Promise\n     */\n    private sendMessage<T = unknown>(action: string, payload?: unknown): Promise<T> {\n        if (!this.isInitialized) {\n            return Promise.reject({\n                code: 'SDK_NOT_INITIALIZED',\n                message: 'SDK is not initialized',\n            } as LearnCardError);\n        }\n\n        return new Promise<T>((resolve, reject) => {\n            const requestId = this.generateRequestId(action);\n\n            // Set up timeout\n            const timeoutId = setTimeout(() => {\n                if (this.pendingRequests.has(requestId)) {\n                    this.pendingRequests.delete(requestId);\n                    reject({\n                        code: 'LC_TIMEOUT',\n                        message: `Request ${action} timed out after ${this.requestTimeout}ms`,\n                    } as LearnCardError);\n                }\n            }, this.requestTimeout);\n\n            // Store the pending request\n            this.pendingRequests.set(requestId, {\n                resolve: resolve as (value: unknown) => void,\n                reject,\n                timeoutId,\n            });\n\n            // Construct the message\n            const message: PostMessageRequest = {\n                protocol: this.protocol,\n                action,\n                requestId,\n                payload,\n            };\n\n            // Send to parent window with the active host origin (configured or overridden)\n            window.parent.postMessage(message, this.activeHostOrigin);\n        });\n    }\n\n    /**\n     * Request user identity (Single Sign-On)\n     *\n     * @returns Promise resolving to user identity including DID and JWT token\n     * @throws {LearnCardError} When user is not authenticated or request fails\n     *\n     * @example\n     * ```typescript\n     * const identity = await learnCard.requestIdentity();\n     * console.log('User DID:', identity.user.did);\n     * console.log('JWT Token:', identity.token);\n     * ```\n     */\n    public requestIdentity(): Promise<IdentityResponse> {\n        return this.sendMessage<IdentityResponse>('REQUEST_IDENTITY', {\n            challenge: `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,\n        });\n    }\n\n    /**\n     * Send a credential to the user's LearnCard wallet\n     *\n     * Supports two modes:\n     * 1. **Raw credential**: Pass a full verifiable credential object\n     * 2. **Template-based**: Pass `{ templateAlias, templateData }` to issue from a pre-configured boost template\n     *\n     * @param input - Either a verifiable credential or a template-based input\n     * @returns Promise resolving to credential response\n     *\n     * @example Raw credential\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   '@context': ['https://www.w3.org/2018/credentials/v1'],\n     *   type: ['VerifiableCredential'],\n     *   credentialSubject: { id: 'did:example:123' }\n     * });\n     * console.log('Credential ID:', response.credentialId);\n     * ```\n     *\n     * @example Template-based (for App Store apps)\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95', courseName: 'Web Dev 101' }\n     * });\n     * console.log('Credential URI:', response.credentialUri);\n     * ```\n     */\n    public sendCredential(\n        input: unknown | TemplateCredentialInput\n    ): Promise<SendCredentialResponse | TemplateCredentialResponse> {\n        if (\n            input &&\n            typeof input === 'object' &&\n            'templateAlias' in input &&\n            typeof (input as TemplateCredentialInput).templateAlias === 'string'\n        ) {\n            const templateInput = input as TemplateCredentialInput;\n\n            return this.sendAppEvent<TemplateCredentialResponse>({\n                type: 'send-credential',\n                templateAlias: templateInput.templateAlias,\n                templateData: templateInput.templateData,\n                preventDuplicateClaim: templateInput.preventDuplicateClaim,\n            });\n        }\n\n        return this.sendMessage<SendCredentialResponse>('SEND_CREDENTIAL', { credential: input });\n    }\n\n    /**\n     * Check whether the current user already has a credential from a given boost template.\n     * This is a silent, non-interactive status check for installed app integrations.\n     */\n    public checkUserHasCredential(input: CheckCredentialInput): Promise<CheckCredentialResponse> {\n        return this.sendAppEvent<CheckCredentialResponse>({\n            type: 'check-credential',\n            ...input,\n        });\n    }\n\n    /**\n     * Check if the current user has issued/sent a specific template to someone.\n     * Returns issuance status including sent date and claim status.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and recipient identifier (recipientDid or recipientProfileId)\n     * @returns Promise resolving to issuance status response\n     *\n     * @example\n     * ```typescript\n     * // Check if user already issued 'achievement-badge' to a specific person\n     * const status = await learnCard.getTemplateIssuanceStatus({\n     *   templateAlias: 'achievement-badge',\n     *   recipientProfileId: 'user123'\n     * });\n     *\n     * if (status.sent) {\n     *   console.log('Already issued on:', status.sentDate);\n     *   console.log('Status:', status.status); // 'pending', 'claimed', or 'revoked'\n     * }\n     * ```\n     */\n    public getTemplateIssuanceStatus(\n        input: CheckIssuanceStatusInput\n    ): Promise<TemplateIssuanceStatusResponse> {\n        return this.sendAppEvent<TemplateIssuanceStatusResponse>({\n            type: 'check-issuance-status',\n            ...input,\n        });\n    }\n\n    /**\n     * Get the list of all recipients for a specific template/boost.\n     * Useful for dashboards showing who has received a credential.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and optional pagination params\n     * @returns Promise resolving to paginated list of recipients\n     *\n     * @example\n     * ```typescript\n     * // Get first 10 recipients of 'achievement-badge'\n     * const recipients = await learnCard.getTemplateRecipients({\n     *   templateAlias: 'achievement-badge',\n     *   limit: 10\n     * });\n     *\n     * console.log(`Found ${recipients.records.length} recipients`);\n     * recipients.records.forEach(r => {\n     *   console.log(`${r.recipientDisplayName}: ${r.status}`);\n     * });\n     *\n     * // Get next page if available\n     * if (recipients.hasMore) {\n     *   const nextPage = await learnCard.getTemplateRecipients({\n     *     templateAlias: 'achievement-badge',\n     *     limit: 10,\n     *     cursor: recipients.cursor\n     *   });\n     * }\n     * ```\n     */\n    public getTemplateRecipients(\n        input: GetTemplateRecipientsInput\n    ): Promise<TemplateRecipientsResponse> {\n        return this.sendAppEvent<TemplateRecipientsResponse>({\n            type: 'get-template-recipients',\n            ...input,\n        });\n    }\n\n    /**\n     * Launch a feature in the LearnCard host application\n     *\n     * @param featurePath - Path to the feature (e.g., '/ai/topics')\n     * @param initialPrompt - Optional initial prompt or data\n     *\n     * @example\n     * ```typescript\n     * await learnCard.launchFeature(\n     *   '/ai/topics?shortCircuitStep=newTopic',\n     *   'Help me understand cryptography'\n     * );\n     * ```\n     */\n    public launchFeature(featurePath: string, initialPrompt?: string): Promise<void> {\n        return this.sendMessage<void>('LAUNCH_FEATURE', { featurePath, initialPrompt });\n    }\n\n    /**\n     * Request credentials from the user's wallet using a query\n     *\n     * @param verifiablePresentationRequest - VPR with query criteria\n     * @returns Promise resolving to verifiable presentation\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSearch({\n     *   query: [{\n     *     type: 'QueryByTitle',\n     *     credentialQuery: {\n     *       reason: 'We need to verify your skills',\n     *       title: 'JavaScript Expert'\n     *     }\n     *   }],\n     *   challenge: 'challenge-123',\n     *   domain: window.location.hostname\n     * });\n     *\n     * if (response.verifiablePresentation) {\n     *   console.log('Received credentials:', response.verifiablePresentation.verifiableCredential);\n     * }\n     * ```\n     */\n    public askCredentialSearch(\n        verifiablePresentationRequest: VerifiablePresentationRequest\n    ): Promise<CredentialSearchResponse> {\n        return this.sendMessage<CredentialSearchResponse>('ASK_CREDENTIAL_SEARCH', {\n            verifiablePresentationRequest,\n        });\n    }\n\n    /**\n     * Request a specific credential by ID\n     *\n     * @param credentialId - The ID of the credential to request\n     * @returns Promise resolving to the credential\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSpecific('credential-id-123');\n     * if (response.credential) {\n     *   console.log('Received credential:', response.credential);\n     * }\n     * ```\n     */\n    public askCredentialSpecific(credentialId: string): Promise<CredentialSpecificResponse> {\n        return this.sendMessage<CredentialSpecificResponse>('ASK_CREDENTIAL_SPECIFIC', {\n            credentialId,\n        });\n    }\n\n    /**\n     * Request user consent for permissions\n     *\n     * @param contractUri - URI of the consent contract (optional for App Store apps with configured contracts)\n     * @param options - Additional options including redirect behavior\n     * @returns Promise resolving to consent response\n     *\n     * @example\n     * ```typescript\n     * // With explicit contract URI (for external/non-app store integrations)\n     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');\n     * if (response.granted) {\n     *   console.log('User granted consent');\n     * }\n     *\n     * // Without contract URI (uses app's configured contract from integration)\n     * // This works for App Store apps that have configured a contract in their integration\n     * const response = await learnCard.requestConsent();\n     * if (response.granted) {\n     *   console.log('User granted consent using listing contract');\n     * }\n     *\n     * // With redirect - redirects to contract's redirectUrl with VP in URL params\n     * const response = await learnCard.requestConsent(undefined, { redirect: true });\n     * ```\n     */\n    public requestConsent(\n        contractUri?: string,\n        options: RequestConsentOptions = {}\n    ): Promise<ConsentResponse> {\n        const { redirect = false } = options;\n\n        return this.sendMessage<ConsentResponse>('REQUEST_CONSENT', {\n            contractUri,\n            redirect,\n        });\n    }\n\n    /**\n     * Initiate a template-based credential issuance flow\n     *\n     * @param templateId - ID of the template/boost to issue\n     * @param draftRecipients - Optional array of recipient DIDs\n     * @returns Promise resolving to template issue response\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.initiateTemplateIssue(\n     *   'lc:network:network.learncard.com/trpc:boost:xyz789',\n     *   ['did:key:abc', 'did:key:def']\n     * );\n     *\n     * if (response.issued) {\n     *   console.log('Template issued successfully');\n     * }\n     * ```\n     */\n    public initiateTemplateIssue(\n        templateId: string,\n        draftRecipients?: string[]\n    ): Promise<TemplateIssueResponse> {\n        return this.sendMessage<TemplateIssueResponse>('INITIATE_TEMPLATE_ISSUE', {\n            templateId,\n            draftRecipients: draftRecipients || [],\n        });\n    }\n\n    /**\n     * Request comprehensive learner context for AI tutoring systems.\n     *\n     * This method retrieves the user's credentials and personal data,\n     * then formats them into an LLM-ready prompt that can be injected directly into\n     * an AI system prompt.\n     *\n     * @param options - Configuration options for what data to include and how to format it\n     * @returns Promise resolving to learner context with prompt and optional raw data\n     *\n     * @example\n     * ```typescript\n     * // Get LLM-ready prompt with credentials and personal data\n     * const context = await learnCard.requestLearnerContext({\n     *   includeCredentials: true,\n     *   includePersonalData: true,\n     *   format: 'prompt',\n     *   instructions: 'Focus on technical skills and certifications',\n     *   detailLevel: 'expanded'\n     * });\n     *\n     * // Use in AI system prompt\n     * const systemPrompt = `You are a helpful tutor. ${context.prompt}`;\n     *\n     * // Access structured data if needed\n     * console.log('User DID:', context.did);\n     * console.log('Credentials count:', context.raw?.credentials.length);\n     * ```\n     */\n    public requestLearnerContext(\n        options?: RequestLearnerContextOptions\n    ): Promise<LearnerContextResponse> {\n        return this.sendMessage<LearnerContextResponse>('REQUEST_LEARNER_CONTEXT', {\n            includeCredentials: options?.includeCredentials ?? true,\n            includePersonalData: options?.includePersonalData ?? false,\n            format: options?.format ?? 'prompt',\n            instructions: options?.instructions,\n            detailLevel: options?.detailLevel ?? 'compact',\n        });\n    }\n\n    /**\n     * Send a generic event to be processed by the brain service on behalf of this app.\n     * This is used for backend-like operations such as issuing credentials.\n     *\n     * @param event - The event payload to send\n     * @returns Promise resolving to the event response\n     *\n     * @example\n     * ```typescript\n     * // Issue a credential to the current user\n     * const response = await learnCard.sendAppEvent({\n     *   type: 'send-credential',\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95' }\n     * });\n     *\n     * if (response.credentialUri) {\n     *   console.log('Credential issued:', response.credentialUri);\n     * }\n     * ```\n     */\n    public sendAppEvent<T = AppEventResponse>(event: AppEvent): Promise<T> {\n        return this.sendMessage<T>('APP_EVENT', event);\n    }\n\n    /**\n     * Create and send an AI Session credential to the user.\n     *\n     * This method manages the AI Topic → AI Session hierarchy:\n     * - Ensures an AI Topic exists for this app (creates one if needed)\n     * - Creates a new AI Session as a child of the topic\n     * - The topic appears in the user's AI Sessions page with the app's name\n     * - All sessions from this app are organized under that topic\n     *\n     * @param input - Session details including title and optional metadata\n     * @returns Promise resolving to topic and session URIs\n     */\n    public sendAiSessionCredential(\n        input: SendAiSessionCredentialInput\n    ): Promise<SendAiSessionCredentialResponse> {\n        return this.sendAppEvent<SendAiSessionCredentialResponse>({\n            type: 'send-ai-session-credential',\n            ...input,\n        });\n    }\n\n    /**\n     * Send a notification to the current user from this app.\n     * The notification appears in the user's LearnCard notification inbox.\n     */\n    public sendNotification(input: AppNotificationInput): Promise<AppNotificationResponse> {\n        return this.sendAppEvent<AppNotificationResponse>({\n            type: 'send-notification',\n            ...input,\n        });\n    }\n\n    /**\n     * Increment or decrement an app-scoped counter for the current user.\n     */\n    public incrementCounter(key: string, amount: number): Promise<IncrementCounterResponse> {\n        return this.sendAppEvent<IncrementCounterResponse>({\n            type: 'increment-counter',\n            key,\n            amount,\n        });\n    }\n\n    /**\n     * Read the current value of an app-scoped counter for the current user.\n     */\n    public getCounter(key: string): Promise<GetCounterResponse> {\n        return this.sendAppEvent<GetCounterResponse>({\n            type: 'get-counter',\n            key,\n        });\n    }\n\n    /**\n     * Read multiple app-scoped counters at once for the current user.\n     */\n    public getCounters(keys?: string[]): Promise<GetCountersResponse> {\n        return this.sendAppEvent<GetCountersResponse>({\n            type: 'get-counters',\n            ...(keys ? { keys } : {}),\n        });\n    }\n\n    /**\n     * Clean up the SDK and remove event listeners\n     */\n    public destroy(): void {\n        if (this.messageListener) {\n            window.removeEventListener('message', this.messageListener);\n            this.messageListener = null;\n        }\n\n        // Reject all pending requests\n        for (const [requestId, pending] of this.pendingRequests.entries()) {\n            clearTimeout(pending.timeoutId);\n            pending.reject({\n                code: 'SDK_DESTROYED',\n                message: 'SDK was destroyed before request completed',\n            });\n        }\n\n        this.pendingRequests.clear();\n        this.isInitialized = false;\n    }\n}\n\n/**\n * Factory function to create a PartnerConnect instance\n *\n * @param options - Configuration options\n * @returns PartnerConnect instance\n *\n * @example\n * ```typescript\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app',\n *   protocol: 'LEARNCARD_V1',\n *   requestTimeout: 30000\n * });\n * ```\n */\nexport function createPartnerConnect(options?: PartnerConnectOptions): PartnerConnect {\n    return new PartnerConnect(options);\n}\n\n// Default export for convenience\nexport default createPartnerConnect;\n"],"names":[],"mappings":";;;AA4DO,MAAM,eAAA,GAAN,MAAM,eAAe,CAAA;AAAA,EAaxB,YAAY,OAAiC,EAAA;AAT7C,IAAQ,aAAA,CAAA,IAAA,EAAA,aAAA,EAAwB,CAAC,uBAAuB,CAAA,CAAA,CAAA;AACxD,IAAA,aAAA,CAAA,IAAA,EAAQ,kBAA2B,EAAA,uBAAA,CAAA,CAAA;AACnC,IAAA,aAAA,CAAA,IAAA,EAAQ,uBAAiC,EAAA,IAAA,CAAA,CAAA;AACzC,IAAA,aAAA,CAAA,IAAA,EAAQ,UAAmB,EAAA,cAAA,CAAA,CAAA;AAC3B,IAAA,aAAA,CAAA,IAAA,EAAQ,gBAAyB,EAAA,GAAA,CAAA,CAAA;AACjC,IAAQ,aAAA,CAAA,IAAA,EAAA,iBAAA,CAAA,CAAA;AACR,IAAA,aAAA,CAAA,IAAA,EAAQ,iBAA0D,EAAA,IAAA,CAAA,CAAA;AAClE,IAAA,aAAA,CAAA,IAAA,EAAQ,eAAgB,EAAA,KAAA,CAAA,CAAA;AAvE5B,IAAA,IAAA,EAAA,CAAA;AA2EQ,IAAM,MAAA,UAAA,GAAA,CAAa,OAAS,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,UAAA,KAAc,eAAe,CAAA,mBAAA,CAAA;AACzD,IAAA,IAAA,CAAK,cAAc,KAAM,CAAA,OAAA,CAAQ,UAAU,CAAI,GAAA,UAAA,GAAa,CAAC,UAAU,CAAA,CAAA;AAEvE,IAAK,IAAA,CAAA,QAAA,GAAA,CAAW,mCAAS,QAAY,KAAA,cAAA,CAAA;AACrC,IAAK,IAAA,CAAA,cAAA,GAAA,CAAiB,mCAAS,cAAkB,KAAA,GAAA,CAAA;AACjD,IAAK,IAAA,CAAA,qBAAA,GAAA,CAAwB,EAAS,GAAA,OAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,qBAAA,KAAT,IAAkC,GAAA,EAAA,GAAA,IAAA,CAAA;AAC/D,IAAK,IAAA,CAAA,eAAA,uBAAsB,GAAI,EAAA,CAAA;AAC/B,IAAA,IAAA,CAAK,qBAAsB,EAAA,CAAA;AAC3B,IAAA,IAAA,CAAK,oBAAqB,EAAA,CAAA;AAAA,GAC9B;AAAA,EAiBQ,qBAA8B,GAAA;AAClC,IAAI,IAAA,OAAO,WAAW,WAAa,EAAA;AAC/B,MAAA,IAAA,CAAK,gBAAmB,GAAA,IAAA,CAAK,WAAY,CAAA,CAAC,KAAK,eAAe,CAAA,mBAAA,CAAA;AAC9D,MAAA,OAAA;AAAA,KACJ;AAEA,IAAI,IAAA;AAEA,MAAA,MAAM,SAAY,GAAA,IAAI,eAAgB,CAAA,MAAA,CAAO,SAAS,MAAM,CAAA,CAAA;AAC5D,MAAM,MAAA,YAAA,GAAe,SAAU,CAAA,GAAA,CAAI,kBAAkB,CAAA,CAAA;AAErD,MAAA,IAAI,YAAc,EAAA;AAEd,QAAI,IAAA,IAAA,CAAK,YAAY,MAAS,GAAA,CAAA,IAAK,CAAC,IAAK,CAAA,mBAAA,CAAoB,YAAY,CAAG,EAAA;AACxE,UAAQ,OAAA,CAAA,IAAA;AAAA,YACJ,4EAAA;AAAA,YACA,YAAA;AAAA,YACA,UAAA;AAAA,YACA,IAAK,CAAA,WAAA;AAAA,WACT,CAAA;AACA,UAAA,IAAA,CAAK,gBACD,GAAA,IAAA,CAAK,WAAY,CAAA,CAAC,KAAK,eAAe,CAAA,mBAAA,CAAA;AAAA,SACvC,MAAA;AACH,UAAA,IAAA,CAAK,gBAAmB,GAAA,YAAA,CAAA;AAIxB,UAAI,IAAA;AACA,YAAe,cAAA,CAAA,OAAA,CAAQ,eAAe,CAAA,mBAAA,EAAqB,YAAY,CAAA,CAAA;AAAA,WACnE,CAAA,MAAA;AAAA,WAER;AAEA,UAAQ,OAAA,CAAA,GAAA,CAAI,2CAA2C,YAAY,CAAA,CAAA;AAAA,SACvE;AAAA,OACG,MAAA;AAEH,QAAA,IAAI,cAAgC,GAAA,IAAA,CAAA;AAEpC,QAAI,IAAA;AACA,UAAiB,cAAA,GAAA,cAAA,CAAe,OAAQ,CAAA,eAAA,CAAe,mBAAmB,CAAA,CAAA;AAAA,SACtE,CAAA,MAAA;AAAA,SAER;AAEA,QAAA,IAAI,cAAkB,IAAA,IAAA,CAAK,mBAAoB,CAAA,cAAc,CAAG,EAAA;AAC5D,UAAA,IAAA,CAAK,gBAAmB,GAAA,cAAA,CAAA;AACxB,UAAQ,OAAA,CAAA,GAAA,CAAI,kDAAkD,cAAc,CAAA,CAAA;AAAA,SACzE,MAAA;AAEH,UAAA,IAAA,CAAK,gBACD,GAAA,IAAA,CAAK,WAAY,CAAA,CAAC,KAAK,eAAe,CAAA,mBAAA,CAAA;AAC1C,UAAQ,OAAA,CAAA,GAAA,CAAI,0CAA4C,EAAA,IAAA,CAAK,gBAAgB,CAAA,CAAA;AAAA,SACjF;AAAA,OACJ;AAAA,aACK,KAAO,EAAA;AACZ,MAAQ,OAAA,CAAA,KAAA,CAAM,oDAAoD,KAAK,CAAA,CAAA;AACvE,MAAA,IAAA,CAAK,gBAAmB,GAAA,IAAA,CAAK,WAAY,CAAA,CAAC,KAAK,eAAe,CAAA,mBAAA,CAAA;AAAA,KAClE;AAAA,GACJ;AAAA,EAEQ,kBAAkB,MAAyB,EAAA;AAC/C,IAAA,OACI,OAAO,UAAW,CAAA,cAAc,KAChC,MAAO,CAAA,UAAA,CAAW,UAAU,CAC5B,IAAA,MAAA,CAAO,UAAW,CAAA,mBAAmB,KACrC,MAAO,CAAA,UAAA,CAAW,kBAAkB,CACpC,IAAA,MAAA,CAAO,WAAW,kBAAkB,CAAA,CAAA;AAAA,GAE5C;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAoB,MAAyB,EAAA;AACjD,IACI,OAAA,IAAA,CAAK,YAAY,QAAS,CAAA,MAAM,KAC/B,IAAK,CAAA,qBAAA,IAAyB,IAAK,CAAA,iBAAA,CAAkB,MAAM,CAAA,CAAA;AAAA,GAEpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,cAAc,WAA8B,EAAA;AAEhD,IAAA,OAAO,gBAAgB,IAAK,CAAA,gBAAA,CAAA;AAAA,GAChC;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAA6B,GAAA;AACjC,IAAI,IAAA,OAAO,WAAW,WAAa,EAAA;AAC/B,MAAM,MAAA,IAAI,MAAM,8DAA8D,CAAA,CAAA;AAAA,KAClF;AAEA,IAAK,IAAA,CAAA,eAAA,GAAkB,CAAC,KAAwB,KAAA;AAE5C,MAAA,IAAI,CAAC,IAAA,CAAK,aAAc,CAAA,KAAA,CAAM,MAAM,CAAG,EAAA;AAEnC,QAAA,OAAA;AAAA,OACJ;AAEA,MAAA,MAAM,OAAO,KAAM,CAAA,IAAA,CAAA;AAGnB,MAAA,IAAI,KAAK,QAAa,KAAA,IAAA,CAAK,QAAY,IAAA,CAAC,KAAK,SAAW,EAAA;AACpD,QAAA,OAAA;AAAA,OACJ;AAGA,MAAA,MAAM,OAAU,GAAA,IAAA,CAAK,eAAgB,CAAA,GAAA,CAAI,KAAK,SAAS,CAAA,CAAA;AACvD,MAAA,IAAI,CAAC,OAAS,EAAA;AACV,QAAA,OAAA;AAAA,OACJ;AAGA,MAAA,YAAA,CAAa,QAAQ,SAAS,CAAA,CAAA;AAC9B,MAAK,IAAA,CAAA,eAAA,CAAgB,MAAO,CAAA,IAAA,CAAK,SAAS,CAAA,CAAA;AAG1C,MAAI,IAAA,IAAA,CAAK,SAAS,SAAW,EAAA;AACzB,QAAQ,OAAA,CAAA,OAAA,CAAQ,KAAK,IAAI,CAAA,CAAA;AAAA,OAC7B,MAAA,IAAW,IAAK,CAAA,IAAA,KAAS,OAAS,EAAA;AAC9B,QAAQ,OAAA,CAAA,MAAA;AAAA,UACJ,KAAK,KAAS,IAAA,EAAE,IAAM,EAAA,eAAA,EAAiB,SAAS,2BAA4B,EAAA;AAAA,SAChF,CAAA;AAAA,OACJ;AAAA,KACJ,CAAA;AAEA,IAAO,MAAA,CAAA,gBAAA,CAAiB,SAAW,EAAA,IAAA,CAAK,eAAe,CAAA,CAAA;AACvD,IAAA,IAAA,CAAK,aAAgB,GAAA,IAAA,CAAA;AAAA,GACzB;AAAA;AAAA;AAAA;AAAA,EAKQ,kBAAkB,MAAwB,EAAA;AAC9C,IAAA,OAAO,GAAG,MAAM,CAAA,CAAA,EAAI,IAAK,CAAA,GAAA,EAAK,CAAI,CAAA,EAAA,IAAA,CAAK,MAAO,EAAA,CAAE,SAAS,EAAE,CAAA,CAAE,SAAU,CAAA,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA,CAAA;AAAA,GAChF;AAAA;AAAA;AAAA;AAAA,EAKQ,WAAA,CAAyB,QAAgB,OAA+B,EAAA;AAC5E,IAAI,IAAA,CAAC,KAAK,aAAe,EAAA;AACrB,MAAA,OAAO,QAAQ,MAAO,CAAA;AAAA,QAClB,IAAM,EAAA,qBAAA;AAAA,QACN,OAAS,EAAA,wBAAA;AAAA,OACM,CAAA,CAAA;AAAA,KACvB;AAEA,IAAA,OAAO,IAAI,OAAA,CAAW,CAAC,OAAA,EAAS,MAAW,KAAA;AACvC,MAAM,MAAA,SAAA,GAAY,IAAK,CAAA,iBAAA,CAAkB,MAAM,CAAA,CAAA;AAG/C,MAAM,MAAA,SAAA,GAAY,WAAW,MAAM;AAC/B,QAAA,IAAI,IAAK,CAAA,eAAA,CAAgB,GAAI,CAAA,SAAS,CAAG,EAAA;AACrC,UAAK,IAAA,CAAA,eAAA,CAAgB,OAAO,SAAS,CAAA,CAAA;AACrC,UAAO,MAAA,CAAA;AAAA,YACH,IAAM,EAAA,YAAA;AAAA,YACN,OAAS,EAAA,CAAA,QAAA,EAAW,MAAM,CAAA,iBAAA,EAAoB,KAAK,cAAc,CAAA,EAAA,CAAA;AAAA,WAClD,CAAA,CAAA;AAAA,SACvB;AAAA,OACJ,EAAG,KAAK,cAAc,CAAA,CAAA;AAGtB,MAAK,IAAA,CAAA,eAAA,CAAgB,IAAI,SAAW,EAAA;AAAA,QAChC,OAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,OACH,CAAA,CAAA;AAGD,MAAA,MAAM,OAA8B,GAAA;AAAA,QAChC,UAAU,IAAK,CAAA,QAAA;AAAA,QACf,MAAA;AAAA,QACA,SAAA;AAAA,QACA,OAAA;AAAA,OACJ,CAAA;AAGA,MAAA,MAAA,CAAO,MAAO,CAAA,WAAA,CAAY,OAAS,EAAA,IAAA,CAAK,gBAAgB,CAAA,CAAA;AAAA,KAC3D,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeO,eAA6C,GAAA;AAChD,IAAO,OAAA,IAAA,CAAK,YAA8B,kBAAoB,EAAA;AAAA,MAC1D,SAAW,EAAA,CAAA,EAAG,IAAK,CAAA,GAAA,EAAK,CAAI,CAAA,EAAA,IAAA,CAAK,MAAO,EAAA,CAAE,SAAS,EAAE,CAAA,CAAE,SAAU,CAAA,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAAA,KACzE,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA+BO,eACH,KAC4D,EAAA;AAC5D,IACI,IAAA,KAAA,IACA,OAAO,KAAU,KAAA,QAAA,IACjB,mBAAmB,KACnB,IAAA,OAAQ,KAAkC,CAAA,aAAA,KAAkB,QAC9D,EAAA;AACE,MAAA,MAAM,aAAgB,GAAA,KAAA,CAAA;AAEtB,MAAA,OAAO,KAAK,YAAyC,CAAA;AAAA,QACjD,IAAM,EAAA,iBAAA;AAAA,QACN,eAAe,aAAc,CAAA,aAAA;AAAA,QAC7B,cAAc,aAAc,CAAA,YAAA;AAAA,QAC5B,uBAAuB,aAAc,CAAA,qBAAA;AAAA,OACxC,CAAA,CAAA;AAAA,KACL;AAEA,IAAA,OAAO,KAAK,WAAoC,CAAA,iBAAA,EAAmB,EAAE,UAAA,EAAY,OAAO,CAAA,CAAA;AAAA,GAC5F;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,uBAAuB,KAA+D,EAAA;AACzF,IAAA,OAAO,KAAK,YAAsC,CAAA;AAAA,MAC9C,IAAM,EAAA,kBAAA;AAAA,MACN,GAAG,KAAA;AAAA,KACN,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBO,0BACH,KACuC,EAAA;AACvC,IAAA,OAAO,KAAK,YAA6C,CAAA;AAAA,MACrD,IAAM,EAAA,uBAAA;AAAA,MACN,GAAG,KAAA;AAAA,KACN,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgCO,sBACH,KACmC,EAAA;AACnC,IAAA,OAAO,KAAK,YAAyC,CAAA;AAAA,MACjD,IAAM,EAAA,yBAAA;AAAA,MACN,GAAG,KAAA;AAAA,KACN,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBO,aAAA,CAAc,aAAqB,aAAuC,EAAA;AAC7E,IAAA,OAAO,KAAK,WAAkB,CAAA,gBAAA,EAAkB,EAAE,WAAA,EAAa,eAAe,CAAA,CAAA;AAAA,GAClF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BO,oBACH,6BACiC,EAAA;AACjC,IAAO,OAAA,IAAA,CAAK,YAAsC,uBAAyB,EAAA;AAAA,MACvE,6BAAA;AAAA,KACH,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBO,sBAAsB,YAA2D,EAAA;AACpF,IAAO,OAAA,IAAA,CAAK,YAAwC,yBAA2B,EAAA;AAAA,MAC3E,YAAA;AAAA,KACH,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BO,cACH,CAAA,WAAA,EACA,OAAiC,GAAA,EACT,EAAA;AACxB,IAAM,MAAA,EAAE,QAAW,GAAA,KAAA,EAAU,GAAA,OAAA,CAAA;AAE7B,IAAO,OAAA,IAAA,CAAK,YAA6B,iBAAmB,EAAA;AAAA,MACxD,WAAA;AAAA,MACA,QAAA;AAAA,KACH,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBO,qBAAA,CACH,YACA,eAC8B,EAAA;AAC9B,IAAO,OAAA,IAAA,CAAK,YAAmC,yBAA2B,EAAA;AAAA,MACtE,UAAA;AAAA,MACA,eAAA,EAAiB,mBAAmB,EAAC;AAAA,KACxC,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA+BO,sBACH,OAC+B,EAAA;AArmBvC,IAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,CAAA;AAsmBQ,IAAO,OAAA,IAAA,CAAK,YAAoC,yBAA2B,EAAA;AAAA,MACvE,kBAAA,EAAA,CAAoB,EAAS,GAAA,OAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,kBAAA,KAAT,IAA+B,GAAA,EAAA,GAAA,IAAA;AAAA,MACnD,mBAAA,EAAA,CAAqB,EAAS,GAAA,OAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,mBAAA,KAAT,IAAgC,GAAA,EAAA,GAAA,KAAA;AAAA,MACrD,MAAA,EAAA,CAAQ,EAAS,GAAA,OAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,MAAA,KAAT,IAAmB,GAAA,EAAA,GAAA,QAAA;AAAA,MAC3B,cAAc,OAAS,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,YAAA;AAAA,MACvB,WAAA,EAAA,CAAa,EAAS,GAAA,OAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,OAAA,CAAA,WAAA,KAAT,IAAwB,GAAA,EAAA,GAAA,SAAA;AAAA,KACxC,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBO,aAAmC,KAA6B,EAAA;AACnE,IAAO,OAAA,IAAA,CAAK,WAAe,CAAA,WAAA,EAAa,KAAK,CAAA,CAAA;AAAA,GACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcO,wBACH,KACwC,EAAA;AACxC,IAAA,OAAO,KAAK,YAA8C,CAAA;AAAA,MACtD,IAAM,EAAA,4BAAA;AAAA,MACN,GAAG,KAAA;AAAA,KACN,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,iBAAiB,KAA+D,EAAA;AACnF,IAAA,OAAO,KAAK,YAAsC,CAAA;AAAA,MAC9C,IAAM,EAAA,mBAAA;AAAA,MACN,GAAG,KAAA;AAAA,KACN,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA,EAKO,gBAAA,CAAiB,KAAa,MAAmD,EAAA;AACpF,IAAA,OAAO,KAAK,YAAuC,CAAA;AAAA,MAC/C,IAAM,EAAA,mBAAA;AAAA,MACN,GAAA;AAAA,MACA,MAAA;AAAA,KACH,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA,EAKO,WAAW,GAA0C,EAAA;AACxD,IAAA,OAAO,KAAK,YAAiC,CAAA;AAAA,MACzC,IAAM,EAAA,aAAA;AAAA,MACN,GAAA;AAAA,KACH,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA,EAKO,YAAY,IAA+C,EAAA;AAC9D,IAAA,OAAO,KAAK,YAAkC,CAAA;AAAA,MAC1C,IAAM,EAAA,cAAA;AAAA,MACN,GAAI,IAAA,GAAO,EAAE,IAAA,KAAS,EAAC;AAAA,KAC1B,CAAA,CAAA;AAAA,GACL;AAAA;AAAA;AAAA;AAAA,EAKO,OAAgB,GAAA;AACnB,IAAA,IAAI,KAAK,eAAiB,EAAA;AACtB,MAAO,MAAA,CAAA,mBAAA,CAAoB,SAAW,EAAA,IAAA,CAAK,eAAe,CAAA,CAAA;AAC1D,MAAA,IAAA,CAAK,eAAkB,GAAA,IAAA,CAAA;AAAA,KAC3B;AAGA,IAAA,KAAA,MAAW,CAAC,SAAW,EAAA,OAAO,KAAK,IAAK,CAAA,eAAA,CAAgB,SAAW,EAAA;AAC/D,MAAA,YAAA,CAAa,QAAQ,SAAS,CAAA,CAAA;AAC9B,MAAA,OAAA,CAAQ,MAAO,CAAA;AAAA,QACX,IAAM,EAAA,eAAA;AAAA,QACN,OAAS,EAAA,4CAAA;AAAA,OACZ,CAAA,CAAA;AAAA,KACL;AAEA,IAAA,IAAA,CAAK,gBAAgB,KAAM,EAAA,CAAA;AAC3B,IAAA,IAAA,CAAK,aAAgB,GAAA,KAAA,CAAA;AAAA,GACzB;AACJ,CAAA,CAAA;AAAA;AA9pBI,aAAA,CAFS,iBAEc,qBAAsB,EAAA,uBAAA,CAAA,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqC7C,aAAA,CAvCS,iBAuCe,qBAAsB,EAAA,kBAAA,CAAA,CAAA;AAvC3C,IAAM,cAAN,GAAA,gBAAA;AAirBA,SAAS,qBAAqB,OAAiD,EAAA;AAClF,EAAO,OAAA,IAAI,eAAe,OAAO,CAAA,CAAA;AACrC;;;;"}

package/dist/partner-connect.js

@@ -25,14 +25,6 @@ const _PartnerConnect = class _PartnerConnect {
     this.configureActiveOrigin();
     this.setupMessageListener();
   }
-  /**
-   * Configure the active host origin using the following hierarchy:
-   * 1. Check for `lc_host_override` query parameter (for staging/testing)
-   * 2. Fall back to first configured origin
-   * 3. Fall back to DEFAULT_HOST_ORIGIN
-   *
-   * This origin will be used for all outgoing messages and incoming message validation.
-   */
   configureActiveOrigin() {
     if (typeof window === "undefined") {
       this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
@@ -52,11 +44,25 @@ const _PartnerConnect = class _PartnerConnect {
           this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
         } else {
           this.activeHostOrigin = hostOverride;
+          try {
+            sessionStorage.setItem(_PartnerConnect.SESSION_STORAGE_KEY, hostOverride);
+          } catch {
+          }
           console.log("[LearnCard SDK] Using lc_host_override:", hostOverride);
         }
       } else {
-        this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
-        console.log("[LearnCard SDK] Using configured origin:", this.activeHostOrigin);
+        let storedOverride = null;
+        try {
+          storedOverride = sessionStorage.getItem(_PartnerConnect.SESSION_STORAGE_KEY);
+        } catch {
+        }
+        if (storedOverride && this.isOriginInWhitelist(storedOverride)) {
+          this.activeHostOrigin = storedOverride;
+          console.log("[LearnCard SDK] Using stored lc_host_override:", storedOverride);
+        } else {
+          this.activeHostOrigin = this.hostOrigins[0] || _PartnerConnect.DEFAULT_HOST_ORIGIN;
+          console.log("[LearnCard SDK] Using configured origin:", this.activeHostOrigin);
+        }
       }
     } catch (error) {
       console.error("[LearnCard SDK] Error configuring active origin:", error);
@@ -358,22 +364,27 @@ const _PartnerConnect = class _PartnerConnect {
   /**
    * Request user consent for permissions
    *
-   * @param contractUri - URI of the consent contract
+   * @param contractUri - URI of the consent contract (optional for App Store apps with configured contracts)
+   * @param options - Additional options including redirect behavior
    * @returns Promise resolving to consent response
    *
    * @example
    * ```typescript
-   * // Without redirect (default) - returns VP in response if app owns the contract
+   * // With explicit contract URI (for external/non-app store integrations)
    * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');
    * if (response.granted) {
    *   console.log('User granted consent');
-   *   if (response.vp) {
-   *     console.log('VP:', response.vp);
-   *   }
+   * }
+   *
+   * // Without contract URI (uses app's configured contract from integration)
+   * // This works for App Store apps that have configured a contract in their integration
+   * const response = await learnCard.requestConsent();
+   * if (response.granted) {
+   *   console.log('User granted consent using listing contract');
    * }
    *
    * // With redirect - redirects to contract's redirectUrl with VP in URL params
-   * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123', { redirect: true });
+   * const response = await learnCard.requestConsent(undefined, { redirect: true });
    * ```
    */
   requestConsent(contractUri, options = {}) {
@@ -408,6 +419,45 @@ const _PartnerConnect = class _PartnerConnect {
       draftRecipients: draftRecipients || []
     });
   }
+  /**
+   * Request comprehensive learner context for AI tutoring systems.
+   *
+   * This method retrieves the user's credentials and personal data,
+   * then formats them into an LLM-ready prompt that can be injected directly into
+   * an AI system prompt.
+   *
+   * @param options - Configuration options for what data to include and how to format it
+   * @returns Promise resolving to learner context with prompt and optional raw data
+   *
+   * @example
+   * ```typescript
+   * // Get LLM-ready prompt with credentials and personal data
+   * const context = await learnCard.requestLearnerContext({
+   *   includeCredentials: true,
+   *   includePersonalData: true,
+   *   format: 'prompt',
+   *   instructions: 'Focus on technical skills and certifications',
+   *   detailLevel: 'expanded'
+   * });
+   *
+   * // Use in AI system prompt
+   * const systemPrompt = `You are a helpful tutor. ${context.prompt}`;
+   *
+   * // Access structured data if needed
+   * console.log('User DID:', context.did);
+   * console.log('Credentials count:', context.raw?.credentials.length);
+   * ```
+   */
+  requestLearnerContext(options) {
+    var _a, _b, _c, _d;
+    return this.sendMessage("REQUEST_LEARNER_CONTEXT", {
+      includeCredentials: (_a = options == null ? void 0 : options.includeCredentials) != null ? _a : true,
+      includePersonalData: (_b = options == null ? void 0 : options.includePersonalData) != null ? _b : false,
+      format: (_c = options == null ? void 0 : options.format) != null ? _c : "prompt",
+      instructions: options == null ? void 0 : options.instructions,
+      detailLevel: (_d = options == null ? void 0 : options.detailLevel) != null ? _d : "compact"
+    });
+  }
   /**
    * Send a generic event to be processed by the brain service on behalf of this app.
    * This is used for backend-like operations such as issuing credentials.
@@ -432,6 +482,62 @@ const _PartnerConnect = class _PartnerConnect {
   sendAppEvent(event) {
     return this.sendMessage("APP_EVENT", event);
   }
+  /**
+   * Create and send an AI Session credential to the user.
+   *
+   * This method manages the AI Topic → AI Session hierarchy:
+   * - Ensures an AI Topic exists for this app (creates one if needed)
+   * - Creates a new AI Session as a child of the topic
+   * - The topic appears in the user's AI Sessions page with the app's name
+   * - All sessions from this app are organized under that topic
+   *
+   * @param input - Session details including title and optional metadata
+   * @returns Promise resolving to topic and session URIs
+   */
+  sendAiSessionCredential(input) {
+    return this.sendAppEvent({
+      type: "send-ai-session-credential",
+      ...input
+    });
+  }
+  /**
+   * Send a notification to the current user from this app.
+   * The notification appears in the user's LearnCard notification inbox.
+   */
+  sendNotification(input) {
+    return this.sendAppEvent({
+      type: "send-notification",
+      ...input
+    });
+  }
+  /**
+   * Increment or decrement an app-scoped counter for the current user.
+   */
+  incrementCounter(key, amount) {
+    return this.sendAppEvent({
+      type: "increment-counter",
+      key,
+      amount
+    });
+  }
+  /**
+   * Read the current value of an app-scoped counter for the current user.
+   */
+  getCounter(key) {
+    return this.sendAppEvent({
+      type: "get-counter",
+      key
+    });
+  }
+  /**
+   * Read multiple app-scoped counters at once for the current user.
+   */
+  getCounters(keys) {
+    return this.sendAppEvent({
+      type: "get-counters",
+      ...keys ? { keys } : {}
+    });
+  }
   /**
    * Clean up the SDK and remove event listeners
    */
@@ -453,6 +559,20 @@ const _PartnerConnect = class _PartnerConnect {
 };
 /** Default host origin (security anchor) */
 __publicField(_PartnerConnect, "DEFAULT_HOST_ORIGIN", "https://learncard.app");
+/**
+ * Configure the active host origin using the following hierarchy:
+ * 1. Check for `lc_host_override` query parameter (for staging/testing)
+ * 2. Check sessionStorage for a previously stored override (survives in-app navigation)
+ * 3. Fall back to first configured origin
+ * 4. Fall back to DEFAULT_HOST_ORIGIN
+ *
+ * When a valid override is found in the query parameter, it is persisted to
+ * sessionStorage so that subsequent page navigations within the same tab
+ * automatically use the same override without requiring it in every URL.
+ *
+ * This origin will be used for all outgoing messages and incoming message validation.
+ */
+__publicField(_PartnerConnect, "SESSION_STORAGE_KEY", "lc_host_override");
 let PartnerConnect = _PartnerConnect;
 function createPartnerConnect(options) {
   return new PartnerConnect(options);

package/dist/partner-connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"partner-connect.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * LearnCard Partner Connect SDK\n *\n * A Promise-based JavaScript utility for managing cross-origin message communication\n * between partner apps and the LearnCard host application.\n *\n * @example\n * ```typescript\n * import { createPartnerConnect } from '@learncard/partner-connect';\n *\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app'\n * });\n *\n * // Request user identity (SSO)\n * const identity = await learnCard.requestIdentity();\n * console.log('User DID:', identity.user.did);\n * ```\n */\n\nimport type {\n    PartnerConnectOptions,\n    IdentityResponse,\n    SendCredentialResponse,\n    TemplateCredentialInput,\n    TemplateCredentialResponse,\n    VerifiablePresentationRequest,\n    CredentialSearchResponse,\n    CredentialSpecificResponse,\n    ConsentResponse,\n    RequestConsentOptions,\n    TemplateIssueResponse,\n    CheckCredentialInput,\n    CheckCredentialResponse,\n    CheckIssuanceStatusInput,\n    TemplateIssuanceStatusResponse,\n    GetTemplateRecipientsInput,\n    TemplateRecipientsResponse,\n    AppEvent,\n    AppEventResponse,\n    LearnCardError,\n    PostMessageRequest,\n    PostMessageResponse,\n    PendingRequest,\n} from './types';\n\nexport type * from './types';\n\n/**\n * LearnCard Partner Connect SDK class\n */\nexport class PartnerConnect {\n    /** Default host origin (security anchor) */\n    public static readonly DEFAULT_HOST_ORIGIN = 'https://learncard.app';\n\n    private hostOrigins: string[] = ['https://learncard.app'];\n    private activeHostOrigin: string = 'https://learncard.app';\n    private allowNativeAppOrigins: boolean = true;\n    private protocol: string = 'LEARNCARD_V1';\n    private requestTimeout: number = 30000;\n    private pendingRequests: Map<string, PendingRequest>;\n    private messageListener: ((event: MessageEvent) => void) | null = null;\n    private isInitialized = false;\n\n    constructor(options?: PartnerConnectOptions) {\n        // Normalize hostOrigin to an array for whitelist validation\n        const hostOrigin = options?.hostOrigin || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        this.hostOrigins = Array.isArray(hostOrigin) ? hostOrigin : [hostOrigin];\n\n        this.protocol = options?.protocol || 'LEARNCARD_V1';\n        this.requestTimeout = options?.requestTimeout || 30000;\n        this.allowNativeAppOrigins = options?.allowNativeAppOrigins ?? true;\n        this.pendingRequests = new Map();\n        this.configureActiveOrigin();\n        this.setupMessageListener();\n    }\n\n    /**\n     * Configure the active host origin using the following hierarchy:\n     * 1. Check for `lc_host_override` query parameter (for staging/testing)\n     * 2. Fall back to first configured origin\n     * 3. Fall back to DEFAULT_HOST_ORIGIN\n     *\n     * This origin will be used for all outgoing messages and incoming message validation.\n     */\n    private configureActiveOrigin(): void {\n        if (typeof window === 'undefined') {\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n            return;\n        }\n\n        try {\n            // Check for lc_host_override query parameter\n            const urlParams = new URLSearchParams(window.location.search);\n            const hostOverride = urlParams.get('lc_host_override');\n\n            if (hostOverride) {\n                // Validate override against whitelist (if provided)\n                if (this.hostOrigins.length > 0 && !this.isOriginInWhitelist(hostOverride)) {\n                    console.warn(\n                        '[LearnCard SDK] lc_host_override value is not in the configured whitelist:',\n                        hostOverride,\n                        'Allowed:',\n                        this.hostOrigins\n                    );\n                    this.activeHostOrigin =\n                        this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                } else {\n                    this.activeHostOrigin = hostOverride;\n                    console.log('[LearnCard SDK] Using lc_host_override:', hostOverride);\n                }\n            } else {\n                // Use first configured origin or default\n                this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                console.log('[LearnCard SDK] Using configured origin:', this.activeHostOrigin);\n            }\n        } catch (error) {\n            console.error('[LearnCard SDK] Error configuring active origin:', error);\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        }\n    }\n\n    private isOriginNativeApp(origin: string): boolean {\n        return (\n            origin.startsWith('capacitor://') ||\n            origin.startsWith('ionic://') ||\n            origin.startsWith('https://localhost') ||\n            origin.startsWith('http://localhost') ||\n            origin.startsWith('http://127.0.0.1')\n        );\n    }\n\n    /**\n     * Check if an origin is in the configured whitelist\n     */\n    private isOriginInWhitelist(origin: string): boolean {\n        return (\n            this.hostOrigins.includes(origin) ||\n            (this.allowNativeAppOrigins && this.isOriginNativeApp(origin))\n        );\n    }\n\n    /**\n     * Check if an event origin is valid against the active host origin\n     *\n     * Security Rule: Incoming messages must exactly match the active host origin.\n     * This prevents malicious actors from spoofing origins via query parameters.\n     *\n     * @param eventOrigin - The origin from the MessageEvent\n     * @returns true if the origin is valid\n     */\n    private isValidOrigin(eventOrigin: string): boolean {\n        // STRICT: Exact match with active host origin only\n        return eventOrigin === this.activeHostOrigin;\n    }\n\n    /**\n     * Set up the central message listener to handle responses from the LearnCard host\n     */\n    private setupMessageListener(): void {\n        if (typeof window === 'undefined') {\n            throw new Error('PartnerConnect SDK can only be used in a browser environment');\n        }\n\n        this.messageListener = (event: MessageEvent) => {\n            // SECURITY CHECK 1: Strict origin validation - must exactly match active host origin\n            if (!this.isValidOrigin(event.origin)) {\n                // Silently ignore messages from unauthorized origins\n                return;\n            }\n\n            const data = event.data as PostMessageResponse;\n\n            // SECURITY CHECK 2: Validate protocol and requestId\n            if (data.protocol !== this.protocol || !data.requestId) {\n                return;\n            }\n\n            // Look up the pending request\n            const pending = this.pendingRequests.get(data.requestId);\n            if (!pending) {\n                return; // Ignore stale or unrecognized responses\n            }\n\n            // Clean up\n            clearTimeout(pending.timeoutId);\n            this.pendingRequests.delete(data.requestId);\n\n            // Resolve or reject the promise\n            if (data.type === 'SUCCESS') {\n                pending.resolve(data.data);\n            } else if (data.type === 'ERROR') {\n                pending.reject(\n                    data.error || { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred' }\n                );\n            }\n        };\n\n        window.addEventListener('message', this.messageListener);\n        this.isInitialized = true;\n    }\n\n    /**\n     * Generate a unique request ID\n     */\n    private generateRequestId(action: string): string {\n        return `${action}-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n    }\n\n    /**\n     * Send a message to the parent window and return a Promise\n     */\n    private sendMessage<T = unknown>(action: string, payload?: unknown): Promise<T> {\n        if (!this.isInitialized) {\n            return Promise.reject({\n                code: 'SDK_NOT_INITIALIZED',\n                message: 'SDK is not initialized',\n            } as LearnCardError);\n        }\n\n        return new Promise<T>((resolve, reject) => {\n            const requestId = this.generateRequestId(action);\n\n            // Set up timeout\n            const timeoutId = setTimeout(() => {\n                if (this.pendingRequests.has(requestId)) {\n                    this.pendingRequests.delete(requestId);\n                    reject({\n                        code: 'LC_TIMEOUT',\n                        message: `Request ${action} timed out after ${this.requestTimeout}ms`,\n                    } as LearnCardError);\n                }\n            }, this.requestTimeout);\n\n            // Store the pending request\n            this.pendingRequests.set(requestId, {\n                resolve: resolve as (value: unknown) => void,\n                reject,\n                timeoutId,\n            });\n\n            // Construct the message\n            const message: PostMessageRequest = {\n                protocol: this.protocol,\n                action,\n                requestId,\n                payload,\n            };\n\n            // Send to parent window with the active host origin (configured or overridden)\n            window.parent.postMessage(message, this.activeHostOrigin);\n        });\n    }\n\n    /**\n     * Request user identity (Single Sign-On)\n     *\n     * @returns Promise resolving to user identity including DID and JWT token\n     * @throws {LearnCardError} When user is not authenticated or request fails\n     *\n     * @example\n     * ```typescript\n     * const identity = await learnCard.requestIdentity();\n     * console.log('User DID:', identity.user.did);\n     * console.log('JWT Token:', identity.token);\n     * ```\n     */\n    public requestIdentity(): Promise<IdentityResponse> {\n        return this.sendMessage<IdentityResponse>('REQUEST_IDENTITY', {\n            challenge: `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,\n        });\n    }\n\n    /**\n     * Send a credential to the user's LearnCard wallet\n     *\n     * Supports two modes:\n     * 1. **Raw credential**: Pass a full verifiable credential object\n     * 2. **Template-based**: Pass `{ templateAlias, templateData }` to issue from a pre-configured boost template\n     *\n     * @param input - Either a verifiable credential or a template-based input\n     * @returns Promise resolving to credential response\n     *\n     * @example Raw credential\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   '@context': ['https://www.w3.org/2018/credentials/v1'],\n     *   type: ['VerifiableCredential'],\n     *   credentialSubject: { id: 'did:example:123' }\n     * });\n     * console.log('Credential ID:', response.credentialId);\n     * ```\n     *\n     * @example Template-based (for App Store apps)\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95', courseName: 'Web Dev 101' }\n     * });\n     * console.log('Credential URI:', response.credentialUri);\n     * ```\n     */\n    public sendCredential(\n        input: unknown | TemplateCredentialInput\n    ): Promise<SendCredentialResponse | TemplateCredentialResponse> {\n        if (\n            input &&\n            typeof input === 'object' &&\n            'templateAlias' in input &&\n            typeof (input as TemplateCredentialInput).templateAlias === 'string'\n        ) {\n            const templateInput = input as TemplateCredentialInput;\n\n            return this.sendAppEvent<TemplateCredentialResponse>({\n                type: 'send-credential',\n                templateAlias: templateInput.templateAlias,\n                templateData: templateInput.templateData,\n                preventDuplicateClaim: templateInput.preventDuplicateClaim,\n            });\n        }\n\n        return this.sendMessage<SendCredentialResponse>('SEND_CREDENTIAL', { credential: input });\n    }\n\n    /**\n     * Check whether the current user already has a credential from a given boost template.\n     * This is a silent, non-interactive status check for installed app integrations.\n     */\n    public checkUserHasCredential(input: CheckCredentialInput): Promise<CheckCredentialResponse> {\n        return this.sendAppEvent<CheckCredentialResponse>({\n            type: 'check-credential',\n            ...input,\n        });\n    }\n\n    /**\n     * Check if the current user has issued/sent a specific template to someone.\n     * Returns issuance status including sent date and claim status.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and recipient identifier (recipientDid or recipientProfileId)\n     * @returns Promise resolving to issuance status response\n     *\n     * @example\n     * ```typescript\n     * // Check if user already issued 'achievement-badge' to a specific person\n     * const status = await learnCard.getTemplateIssuanceStatus({\n     *   templateAlias: 'achievement-badge',\n     *   recipientProfileId: 'user123'\n     * });\n     *\n     * if (status.sent) {\n     *   console.log('Already issued on:', status.sentDate);\n     *   console.log('Status:', status.status); // 'pending', 'claimed', or 'revoked'\n     * }\n     * ```\n     */\n    public getTemplateIssuanceStatus(\n        input: CheckIssuanceStatusInput\n    ): Promise<TemplateIssuanceStatusResponse> {\n        return this.sendAppEvent<TemplateIssuanceStatusResponse>({\n            type: 'check-issuance-status',\n            ...input,\n        });\n    }\n\n    /**\n     * Get the list of all recipients for a specific template/boost.\n     * Useful for dashboards showing who has received a credential.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and optional pagination params\n     * @returns Promise resolving to paginated list of recipients\n     *\n     * @example\n     * ```typescript\n     * // Get first 10 recipients of 'achievement-badge'\n     * const recipients = await learnCard.getTemplateRecipients({\n     *   templateAlias: 'achievement-badge',\n     *   limit: 10\n     * });\n     *\n     * console.log(`Found ${recipients.records.length} recipients`);\n     * recipients.records.forEach(r => {\n     *   console.log(`${r.recipientDisplayName}: ${r.status}`);\n     * });\n     *\n     * // Get next page if available\n     * if (recipients.hasMore) {\n     *   const nextPage = await learnCard.getTemplateRecipients({\n     *     templateAlias: 'achievement-badge',\n     *     limit: 10,\n     *     cursor: recipients.cursor\n     *   });\n     * }\n     * ```\n     */\n    public getTemplateRecipients(\n        input: GetTemplateRecipientsInput\n    ): Promise<TemplateRecipientsResponse> {\n        return this.sendAppEvent<TemplateRecipientsResponse>({\n            type: 'get-template-recipients',\n            ...input,\n        });\n    }\n\n    /**\n     * Launch a feature in the LearnCard host application\n     *\n     * @param featurePath - Path to the feature (e.g., '/ai/topics')\n     * @param initialPrompt - Optional initial prompt or data\n     *\n     * @example\n     * ```typescript\n     * await learnCard.launchFeature(\n     *   '/ai/topics?shortCircuitStep=newTopic',\n     *   'Help me understand cryptography'\n     * );\n     * ```\n     */\n    public launchFeature(featurePath: string, initialPrompt?: string): Promise<void> {\n        return this.sendMessage<void>('LAUNCH_FEATURE', { featurePath, initialPrompt });\n    }\n\n    /**\n     * Request credentials from the user's wallet using a query\n     *\n     * @param verifiablePresentationRequest - VPR with query criteria\n     * @returns Promise resolving to verifiable presentation\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSearch({\n     *   query: [{\n     *     type: 'QueryByTitle',\n     *     credentialQuery: {\n     *       reason: 'We need to verify your skills',\n     *       title: 'JavaScript Expert'\n     *     }\n     *   }],\n     *   challenge: 'challenge-123',\n     *   domain: window.location.hostname\n     * });\n     *\n     * if (response.verifiablePresentation) {\n     *   console.log('Received credentials:', response.verifiablePresentation.verifiableCredential);\n     * }\n     * ```\n     */\n    public askCredentialSearch(\n        verifiablePresentationRequest: VerifiablePresentationRequest\n    ): Promise<CredentialSearchResponse> {\n        return this.sendMessage<CredentialSearchResponse>('ASK_CREDENTIAL_SEARCH', {\n            verifiablePresentationRequest,\n        });\n    }\n\n    /**\n     * Request a specific credential by ID\n     *\n     * @param credentialId - The ID of the credential to request\n     * @returns Promise resolving to the credential\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSpecific('credential-id-123');\n     * if (response.credential) {\n     *   console.log('Received credential:', response.credential);\n     * }\n     * ```\n     */\n    public askCredentialSpecific(credentialId: string): Promise<CredentialSpecificResponse> {\n        return this.sendMessage<CredentialSpecificResponse>('ASK_CREDENTIAL_SPECIFIC', {\n            credentialId,\n        });\n    }\n\n    /**\n     * Request user consent for permissions\n     *\n     * @param contractUri - URI of the consent contract\n     * @returns Promise resolving to consent response\n     *\n     * @example\n     * ```typescript\n     * // Without redirect (default) - returns VP in response if app owns the contract\n     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');\n     * if (response.granted) {\n     *   console.log('User granted consent');\n     *   if (response.vp) {\n     *     console.log('VP:', response.vp);\n     *   }\n     * }\n     *\n     * // With redirect - redirects to contract's redirectUrl with VP in URL params\n     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123', { redirect: true });\n     * ```\n     */\n    public requestConsent(\n        contractUri: string,\n        options: RequestConsentOptions = {}\n    ): Promise<ConsentResponse> {\n        const { redirect = false } = options;\n\n        return this.sendMessage<ConsentResponse>('REQUEST_CONSENT', {\n            contractUri,\n            redirect,\n        });\n    }\n\n    /**\n     * Initiate a template-based credential issuance flow\n     *\n     * @param templateId - ID of the template/boost to issue\n     * @param draftRecipients - Optional array of recipient DIDs\n     * @returns Promise resolving to template issue response\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.initiateTemplateIssue(\n     *   'lc:network:network.learncard.com/trpc:boost:xyz789',\n     *   ['did:key:abc', 'did:key:def']\n     * );\n     *\n     * if (response.issued) {\n     *   console.log('Template issued successfully');\n     * }\n     * ```\n     */\n    public initiateTemplateIssue(\n        templateId: string,\n        draftRecipients?: string[]\n    ): Promise<TemplateIssueResponse> {\n        return this.sendMessage<TemplateIssueResponse>('INITIATE_TEMPLATE_ISSUE', {\n            templateId,\n            draftRecipients: draftRecipients || [],\n        });\n    }\n\n    /**\n     * Send a generic event to be processed by the brain service on behalf of this app.\n     * This is used for backend-like operations such as issuing credentials.\n     *\n     * @param event - The event payload to send\n     * @returns Promise resolving to the event response\n     *\n     * @example\n     * ```typescript\n     * // Issue a credential to the current user\n     * const response = await learnCard.sendAppEvent({\n     *   type: 'send-credential',\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95' }\n     * });\n     *\n     * if (response.credentialUri) {\n     *   console.log('Credential issued:', response.credentialUri);\n     * }\n     * ```\n     */\n    public sendAppEvent<T = AppEventResponse>(event: AppEvent): Promise<T> {\n        return this.sendMessage<T>('APP_EVENT', event);\n    }\n\n    /**\n     * Clean up the SDK and remove event listeners\n     */\n    public destroy(): void {\n        if (this.messageListener) {\n            window.removeEventListener('message', this.messageListener);\n            this.messageListener = null;\n        }\n\n        // Reject all pending requests\n        for (const [requestId, pending] of this.pendingRequests.entries()) {\n            clearTimeout(pending.timeoutId);\n            pending.reject({\n                code: 'SDK_DESTROYED',\n                message: 'SDK was destroyed before request completed',\n            });\n        }\n\n        this.pendingRequests.clear();\n        this.isInitialized = false;\n    }\n}\n\n/**\n * Factory function to create a PartnerConnect instance\n *\n * @param options - Configuration options\n * @returns PartnerConnect instance\n *\n * @example\n * ```typescript\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app',\n *   protocol: 'LEARNCARD_V1',\n *   requestTimeout: 30000\n * });\n * ```\n */\nexport function createPartnerConnect(options?: PartnerConnectOptions): PartnerConnect {\n    return new PartnerConnect(options);\n}\n\n// Default export for convenience\nexport default createPartnerConnect;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"partner-connect.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * LearnCard Partner Connect SDK\n *\n * A Promise-based JavaScript utility for managing cross-origin message communication\n * between partner apps and the LearnCard host application.\n *\n * @example\n * ```typescript\n * import { createPartnerConnect } from '@learncard/partner-connect';\n *\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app'\n * });\n *\n * // Request user identity (SSO)\n * const identity = await learnCard.requestIdentity();\n * console.log('User DID:', identity.user.did);\n * ```\n */\n\nimport type {\n    PartnerConnectOptions,\n    IdentityResponse,\n    SendCredentialResponse,\n    TemplateCredentialInput,\n    TemplateCredentialResponse,\n    VerifiablePresentationRequest,\n    CredentialSearchResponse,\n    CredentialSpecificResponse,\n    ConsentResponse,\n    RequestConsentOptions,\n    TemplateIssueResponse,\n    CheckCredentialInput,\n    CheckCredentialResponse,\n    CheckIssuanceStatusInput,\n    TemplateIssuanceStatusResponse,\n    GetTemplateRecipientsInput,\n    TemplateRecipientsResponse,\n    RequestLearnerContextOptions,\n    LearnerContextResponse,\n    SendAiSessionCredentialInput,\n    SendAiSessionCredentialResponse,\n    AppNotificationInput,\n    AppNotificationResponse,\n    IncrementCounterResponse,\n    GetCounterResponse,\n    GetCountersResponse,\n    AppEvent,\n    AppEventResponse,\n    LearnCardError,\n    PostMessageRequest,\n    PostMessageResponse,\n    PendingRequest,\n} from './types';\n\nexport type * from './types';\n\n/**\n * LearnCard Partner Connect SDK class\n */\nexport class PartnerConnect {\n    /** Default host origin (security anchor) */\n    public static readonly DEFAULT_HOST_ORIGIN = 'https://learncard.app';\n\n    private hostOrigins: string[] = ['https://learncard.app'];\n    private activeHostOrigin: string = 'https://learncard.app';\n    private allowNativeAppOrigins: boolean = true;\n    private protocol: string = 'LEARNCARD_V1';\n    private requestTimeout: number = 30000;\n    private pendingRequests: Map<string, PendingRequest>;\n    private messageListener: ((event: MessageEvent) => void) | null = null;\n    private isInitialized = false;\n\n    constructor(options?: PartnerConnectOptions) {\n        // Normalize hostOrigin to an array for whitelist validation\n        const hostOrigin = options?.hostOrigin || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        this.hostOrigins = Array.isArray(hostOrigin) ? hostOrigin : [hostOrigin];\n\n        this.protocol = options?.protocol || 'LEARNCARD_V1';\n        this.requestTimeout = options?.requestTimeout || 30000;\n        this.allowNativeAppOrigins = options?.allowNativeAppOrigins ?? true;\n        this.pendingRequests = new Map();\n        this.configureActiveOrigin();\n        this.setupMessageListener();\n    }\n\n    /**\n     * Configure the active host origin using the following hierarchy:\n     * 1. Check for `lc_host_override` query parameter (for staging/testing)\n     * 2. Check sessionStorage for a previously stored override (survives in-app navigation)\n     * 3. Fall back to first configured origin\n     * 4. Fall back to DEFAULT_HOST_ORIGIN\n     *\n     * When a valid override is found in the query parameter, it is persisted to\n     * sessionStorage so that subsequent page navigations within the same tab\n     * automatically use the same override without requiring it in every URL.\n     *\n     * This origin will be used for all outgoing messages and incoming message validation.\n     */\n    private static readonly SESSION_STORAGE_KEY = 'lc_host_override';\n\n    private configureActiveOrigin(): void {\n        if (typeof window === 'undefined') {\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n            return;\n        }\n\n        try {\n            // Check for lc_host_override query parameter\n            const urlParams = new URLSearchParams(window.location.search);\n            const hostOverride = urlParams.get('lc_host_override');\n\n            if (hostOverride) {\n                // Validate override against whitelist (if provided)\n                if (this.hostOrigins.length > 0 && !this.isOriginInWhitelist(hostOverride)) {\n                    console.warn(\n                        '[LearnCard SDK] lc_host_override value is not in the configured whitelist:',\n                        hostOverride,\n                        'Allowed:',\n                        this.hostOrigins\n                    );\n                    this.activeHostOrigin =\n                        this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                } else {\n                    this.activeHostOrigin = hostOverride;\n\n                    // Persist to sessionStorage so subsequent page navigations\n                    // within this tab automatically use the same override.\n                    try {\n                        sessionStorage.setItem(PartnerConnect.SESSION_STORAGE_KEY, hostOverride);\n                    } catch {\n                        // sessionStorage may be unavailable (e.g. sandboxed iframes)\n                    }\n\n                    console.log('[LearnCard SDK] Using lc_host_override:', hostOverride);\n                }\n            } else {\n                // Fall back to a previously stored override from this session\n                let storedOverride: string | null = null;\n\n                try {\n                    storedOverride = sessionStorage.getItem(PartnerConnect.SESSION_STORAGE_KEY);\n                } catch {\n                    // sessionStorage may be unavailable\n                }\n\n                if (storedOverride && this.isOriginInWhitelist(storedOverride)) {\n                    this.activeHostOrigin = storedOverride;\n                    console.log('[LearnCard SDK] Using stored lc_host_override:', storedOverride);\n                } else {\n                    // Use first configured origin or default\n                    this.activeHostOrigin =\n                        this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n                    console.log('[LearnCard SDK] Using configured origin:', this.activeHostOrigin);\n                }\n            }\n        } catch (error) {\n            console.error('[LearnCard SDK] Error configuring active origin:', error);\n            this.activeHostOrigin = this.hostOrigins[0] || PartnerConnect.DEFAULT_HOST_ORIGIN;\n        }\n    }\n\n    private isOriginNativeApp(origin: string): boolean {\n        return (\n            origin.startsWith('capacitor://') ||\n            origin.startsWith('ionic://') ||\n            origin.startsWith('https://localhost') ||\n            origin.startsWith('http://localhost') ||\n            origin.startsWith('http://127.0.0.1')\n        );\n    }\n\n    /**\n     * Check if an origin is in the configured whitelist\n     */\n    private isOriginInWhitelist(origin: string): boolean {\n        return (\n            this.hostOrigins.includes(origin) ||\n            (this.allowNativeAppOrigins && this.isOriginNativeApp(origin))\n        );\n    }\n\n    /**\n     * Check if an event origin is valid against the active host origin\n     *\n     * Security Rule: Incoming messages must exactly match the active host origin.\n     * This prevents malicious actors from spoofing origins via query parameters.\n     *\n     * @param eventOrigin - The origin from the MessageEvent\n     * @returns true if the origin is valid\n     */\n    private isValidOrigin(eventOrigin: string): boolean {\n        // STRICT: Exact match with active host origin only\n        return eventOrigin === this.activeHostOrigin;\n    }\n\n    /**\n     * Set up the central message listener to handle responses from the LearnCard host\n     */\n    private setupMessageListener(): void {\n        if (typeof window === 'undefined') {\n            throw new Error('PartnerConnect SDK can only be used in a browser environment');\n        }\n\n        this.messageListener = (event: MessageEvent) => {\n            // SECURITY CHECK 1: Strict origin validation - must exactly match active host origin\n            if (!this.isValidOrigin(event.origin)) {\n                // Silently ignore messages from unauthorized origins\n                return;\n            }\n\n            const data = event.data as PostMessageResponse;\n\n            // SECURITY CHECK 2: Validate protocol and requestId\n            if (data.protocol !== this.protocol || !data.requestId) {\n                return;\n            }\n\n            // Look up the pending request\n            const pending = this.pendingRequests.get(data.requestId);\n            if (!pending) {\n                return; // Ignore stale or unrecognized responses\n            }\n\n            // Clean up\n            clearTimeout(pending.timeoutId);\n            this.pendingRequests.delete(data.requestId);\n\n            // Resolve or reject the promise\n            if (data.type === 'SUCCESS') {\n                pending.resolve(data.data);\n            } else if (data.type === 'ERROR') {\n                pending.reject(\n                    data.error || { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred' }\n                );\n            }\n        };\n\n        window.addEventListener('message', this.messageListener);\n        this.isInitialized = true;\n    }\n\n    /**\n     * Generate a unique request ID\n     */\n    private generateRequestId(action: string): string {\n        return `${action}-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n    }\n\n    /**\n     * Send a message to the parent window and return a Promise\n     */\n    private sendMessage<T = unknown>(action: string, payload?: unknown): Promise<T> {\n        if (!this.isInitialized) {\n            return Promise.reject({\n                code: 'SDK_NOT_INITIALIZED',\n                message: 'SDK is not initialized',\n            } as LearnCardError);\n        }\n\n        return new Promise<T>((resolve, reject) => {\n            const requestId = this.generateRequestId(action);\n\n            // Set up timeout\n            const timeoutId = setTimeout(() => {\n                if (this.pendingRequests.has(requestId)) {\n                    this.pendingRequests.delete(requestId);\n                    reject({\n                        code: 'LC_TIMEOUT',\n                        message: `Request ${action} timed out after ${this.requestTimeout}ms`,\n                    } as LearnCardError);\n                }\n            }, this.requestTimeout);\n\n            // Store the pending request\n            this.pendingRequests.set(requestId, {\n                resolve: resolve as (value: unknown) => void,\n                reject,\n                timeoutId,\n            });\n\n            // Construct the message\n            const message: PostMessageRequest = {\n                protocol: this.protocol,\n                action,\n                requestId,\n                payload,\n            };\n\n            // Send to parent window with the active host origin (configured or overridden)\n            window.parent.postMessage(message, this.activeHostOrigin);\n        });\n    }\n\n    /**\n     * Request user identity (Single Sign-On)\n     *\n     * @returns Promise resolving to user identity including DID and JWT token\n     * @throws {LearnCardError} When user is not authenticated or request fails\n     *\n     * @example\n     * ```typescript\n     * const identity = await learnCard.requestIdentity();\n     * console.log('User DID:', identity.user.did);\n     * console.log('JWT Token:', identity.token);\n     * ```\n     */\n    public requestIdentity(): Promise<IdentityResponse> {\n        return this.sendMessage<IdentityResponse>('REQUEST_IDENTITY', {\n            challenge: `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,\n        });\n    }\n\n    /**\n     * Send a credential to the user's LearnCard wallet\n     *\n     * Supports two modes:\n     * 1. **Raw credential**: Pass a full verifiable credential object\n     * 2. **Template-based**: Pass `{ templateAlias, templateData }` to issue from a pre-configured boost template\n     *\n     * @param input - Either a verifiable credential or a template-based input\n     * @returns Promise resolving to credential response\n     *\n     * @example Raw credential\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   '@context': ['https://www.w3.org/2018/credentials/v1'],\n     *   type: ['VerifiableCredential'],\n     *   credentialSubject: { id: 'did:example:123' }\n     * });\n     * console.log('Credential ID:', response.credentialId);\n     * ```\n     *\n     * @example Template-based (for App Store apps)\n     * ```typescript\n     * const response = await learnCard.sendCredential({\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95', courseName: 'Web Dev 101' }\n     * });\n     * console.log('Credential URI:', response.credentialUri);\n     * ```\n     */\n    public sendCredential(\n        input: unknown | TemplateCredentialInput\n    ): Promise<SendCredentialResponse | TemplateCredentialResponse> {\n        if (\n            input &&\n            typeof input === 'object' &&\n            'templateAlias' in input &&\n            typeof (input as TemplateCredentialInput).templateAlias === 'string'\n        ) {\n            const templateInput = input as TemplateCredentialInput;\n\n            return this.sendAppEvent<TemplateCredentialResponse>({\n                type: 'send-credential',\n                templateAlias: templateInput.templateAlias,\n                templateData: templateInput.templateData,\n                preventDuplicateClaim: templateInput.preventDuplicateClaim,\n            });\n        }\n\n        return this.sendMessage<SendCredentialResponse>('SEND_CREDENTIAL', { credential: input });\n    }\n\n    /**\n     * Check whether the current user already has a credential from a given boost template.\n     * This is a silent, non-interactive status check for installed app integrations.\n     */\n    public checkUserHasCredential(input: CheckCredentialInput): Promise<CheckCredentialResponse> {\n        return this.sendAppEvent<CheckCredentialResponse>({\n            type: 'check-credential',\n            ...input,\n        });\n    }\n\n    /**\n     * Check if the current user has issued/sent a specific template to someone.\n     * Returns issuance status including sent date and claim status.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and recipient identifier (recipientDid or recipientProfileId)\n     * @returns Promise resolving to issuance status response\n     *\n     * @example\n     * ```typescript\n     * // Check if user already issued 'achievement-badge' to a specific person\n     * const status = await learnCard.getTemplateIssuanceStatus({\n     *   templateAlias: 'achievement-badge',\n     *   recipientProfileId: 'user123'\n     * });\n     *\n     * if (status.sent) {\n     *   console.log('Already issued on:', status.sentDate);\n     *   console.log('Status:', status.status); // 'pending', 'claimed', or 'revoked'\n     * }\n     * ```\n     */\n    public getTemplateIssuanceStatus(\n        input: CheckIssuanceStatusInput\n    ): Promise<TemplateIssuanceStatusResponse> {\n        return this.sendAppEvent<TemplateIssuanceStatusResponse>({\n            type: 'check-issuance-status',\n            ...input,\n        });\n    }\n\n    /**\n     * Get the list of all recipients for a specific template/boost.\n     * Useful for dashboards showing who has received a credential.\n     *\n     * @param input - Template identifier (templateAlias or boostUri) and optional pagination params\n     * @returns Promise resolving to paginated list of recipients\n     *\n     * @example\n     * ```typescript\n     * // Get first 10 recipients of 'achievement-badge'\n     * const recipients = await learnCard.getTemplateRecipients({\n     *   templateAlias: 'achievement-badge',\n     *   limit: 10\n     * });\n     *\n     * console.log(`Found ${recipients.records.length} recipients`);\n     * recipients.records.forEach(r => {\n     *   console.log(`${r.recipientDisplayName}: ${r.status}`);\n     * });\n     *\n     * // Get next page if available\n     * if (recipients.hasMore) {\n     *   const nextPage = await learnCard.getTemplateRecipients({\n     *     templateAlias: 'achievement-badge',\n     *     limit: 10,\n     *     cursor: recipients.cursor\n     *   });\n     * }\n     * ```\n     */\n    public getTemplateRecipients(\n        input: GetTemplateRecipientsInput\n    ): Promise<TemplateRecipientsResponse> {\n        return this.sendAppEvent<TemplateRecipientsResponse>({\n            type: 'get-template-recipients',\n            ...input,\n        });\n    }\n\n    /**\n     * Launch a feature in the LearnCard host application\n     *\n     * @param featurePath - Path to the feature (e.g., '/ai/topics')\n     * @param initialPrompt - Optional initial prompt or data\n     *\n     * @example\n     * ```typescript\n     * await learnCard.launchFeature(\n     *   '/ai/topics?shortCircuitStep=newTopic',\n     *   'Help me understand cryptography'\n     * );\n     * ```\n     */\n    public launchFeature(featurePath: string, initialPrompt?: string): Promise<void> {\n        return this.sendMessage<void>('LAUNCH_FEATURE', { featurePath, initialPrompt });\n    }\n\n    /**\n     * Request credentials from the user's wallet using a query\n     *\n     * @param verifiablePresentationRequest - VPR with query criteria\n     * @returns Promise resolving to verifiable presentation\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSearch({\n     *   query: [{\n     *     type: 'QueryByTitle',\n     *     credentialQuery: {\n     *       reason: 'We need to verify your skills',\n     *       title: 'JavaScript Expert'\n     *     }\n     *   }],\n     *   challenge: 'challenge-123',\n     *   domain: window.location.hostname\n     * });\n     *\n     * if (response.verifiablePresentation) {\n     *   console.log('Received credentials:', response.verifiablePresentation.verifiableCredential);\n     * }\n     * ```\n     */\n    public askCredentialSearch(\n        verifiablePresentationRequest: VerifiablePresentationRequest\n    ): Promise<CredentialSearchResponse> {\n        return this.sendMessage<CredentialSearchResponse>('ASK_CREDENTIAL_SEARCH', {\n            verifiablePresentationRequest,\n        });\n    }\n\n    /**\n     * Request a specific credential by ID\n     *\n     * @param credentialId - The ID of the credential to request\n     * @returns Promise resolving to the credential\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.askCredentialSpecific('credential-id-123');\n     * if (response.credential) {\n     *   console.log('Received credential:', response.credential);\n     * }\n     * ```\n     */\n    public askCredentialSpecific(credentialId: string): Promise<CredentialSpecificResponse> {\n        return this.sendMessage<CredentialSpecificResponse>('ASK_CREDENTIAL_SPECIFIC', {\n            credentialId,\n        });\n    }\n\n    /**\n     * Request user consent for permissions\n     *\n     * @param contractUri - URI of the consent contract (optional for App Store apps with configured contracts)\n     * @param options - Additional options including redirect behavior\n     * @returns Promise resolving to consent response\n     *\n     * @example\n     * ```typescript\n     * // With explicit contract URI (for external/non-app store integrations)\n     * const response = await learnCard.requestConsent('lc:network:network.learncard.com/trpc:contract:abc123');\n     * if (response.granted) {\n     *   console.log('User granted consent');\n     * }\n     *\n     * // Without contract URI (uses app's configured contract from integration)\n     * // This works for App Store apps that have configured a contract in their integration\n     * const response = await learnCard.requestConsent();\n     * if (response.granted) {\n     *   console.log('User granted consent using listing contract');\n     * }\n     *\n     * // With redirect - redirects to contract's redirectUrl with VP in URL params\n     * const response = await learnCard.requestConsent(undefined, { redirect: true });\n     * ```\n     */\n    public requestConsent(\n        contractUri?: string,\n        options: RequestConsentOptions = {}\n    ): Promise<ConsentResponse> {\n        const { redirect = false } = options;\n\n        return this.sendMessage<ConsentResponse>('REQUEST_CONSENT', {\n            contractUri,\n            redirect,\n        });\n    }\n\n    /**\n     * Initiate a template-based credential issuance flow\n     *\n     * @param templateId - ID of the template/boost to issue\n     * @param draftRecipients - Optional array of recipient DIDs\n     * @returns Promise resolving to template issue response\n     *\n     * @example\n     * ```typescript\n     * const response = await learnCard.initiateTemplateIssue(\n     *   'lc:network:network.learncard.com/trpc:boost:xyz789',\n     *   ['did:key:abc', 'did:key:def']\n     * );\n     *\n     * if (response.issued) {\n     *   console.log('Template issued successfully');\n     * }\n     * ```\n     */\n    public initiateTemplateIssue(\n        templateId: string,\n        draftRecipients?: string[]\n    ): Promise<TemplateIssueResponse> {\n        return this.sendMessage<TemplateIssueResponse>('INITIATE_TEMPLATE_ISSUE', {\n            templateId,\n            draftRecipients: draftRecipients || [],\n        });\n    }\n\n    /**\n     * Request comprehensive learner context for AI tutoring systems.\n     *\n     * This method retrieves the user's credentials and personal data,\n     * then formats them into an LLM-ready prompt that can be injected directly into\n     * an AI system prompt.\n     *\n     * @param options - Configuration options for what data to include and how to format it\n     * @returns Promise resolving to learner context with prompt and optional raw data\n     *\n     * @example\n     * ```typescript\n     * // Get LLM-ready prompt with credentials and personal data\n     * const context = await learnCard.requestLearnerContext({\n     *   includeCredentials: true,\n     *   includePersonalData: true,\n     *   format: 'prompt',\n     *   instructions: 'Focus on technical skills and certifications',\n     *   detailLevel: 'expanded'\n     * });\n     *\n     * // Use in AI system prompt\n     * const systemPrompt = `You are a helpful tutor. ${context.prompt}`;\n     *\n     * // Access structured data if needed\n     * console.log('User DID:', context.did);\n     * console.log('Credentials count:', context.raw?.credentials.length);\n     * ```\n     */\n    public requestLearnerContext(\n        options?: RequestLearnerContextOptions\n    ): Promise<LearnerContextResponse> {\n        return this.sendMessage<LearnerContextResponse>('REQUEST_LEARNER_CONTEXT', {\n            includeCredentials: options?.includeCredentials ?? true,\n            includePersonalData: options?.includePersonalData ?? false,\n            format: options?.format ?? 'prompt',\n            instructions: options?.instructions,\n            detailLevel: options?.detailLevel ?? 'compact',\n        });\n    }\n\n    /**\n     * Send a generic event to be processed by the brain service on behalf of this app.\n     * This is used for backend-like operations such as issuing credentials.\n     *\n     * @param event - The event payload to send\n     * @returns Promise resolving to the event response\n     *\n     * @example\n     * ```typescript\n     * // Issue a credential to the current user\n     * const response = await learnCard.sendAppEvent({\n     *   type: 'send-credential',\n     *   templateAlias: 'achievement-badge',\n     *   templateData: { score: '95' }\n     * });\n     *\n     * if (response.credentialUri) {\n     *   console.log('Credential issued:', response.credentialUri);\n     * }\n     * ```\n     */\n    public sendAppEvent<T = AppEventResponse>(event: AppEvent): Promise<T> {\n        return this.sendMessage<T>('APP_EVENT', event);\n    }\n\n    /**\n     * Create and send an AI Session credential to the user.\n     *\n     * This method manages the AI Topic → AI Session hierarchy:\n     * - Ensures an AI Topic exists for this app (creates one if needed)\n     * - Creates a new AI Session as a child of the topic\n     * - The topic appears in the user's AI Sessions page with the app's name\n     * - All sessions from this app are organized under that topic\n     *\n     * @param input - Session details including title and optional metadata\n     * @returns Promise resolving to topic and session URIs\n     */\n    public sendAiSessionCredential(\n        input: SendAiSessionCredentialInput\n    ): Promise<SendAiSessionCredentialResponse> {\n        return this.sendAppEvent<SendAiSessionCredentialResponse>({\n            type: 'send-ai-session-credential',\n            ...input,\n        });\n    }\n\n    /**\n     * Send a notification to the current user from this app.\n     * The notification appears in the user's LearnCard notification inbox.\n     */\n    public sendNotification(input: AppNotificationInput): Promise<AppNotificationResponse> {\n        return this.sendAppEvent<AppNotificationResponse>({\n            type: 'send-notification',\n            ...input,\n        });\n    }\n\n    /**\n     * Increment or decrement an app-scoped counter for the current user.\n     */\n    public incrementCounter(key: string, amount: number): Promise<IncrementCounterResponse> {\n        return this.sendAppEvent<IncrementCounterResponse>({\n            type: 'increment-counter',\n            key,\n            amount,\n        });\n    }\n\n    /**\n     * Read the current value of an app-scoped counter for the current user.\n     */\n    public getCounter(key: string): Promise<GetCounterResponse> {\n        return this.sendAppEvent<GetCounterResponse>({\n            type: 'get-counter',\n            key,\n        });\n    }\n\n    /**\n     * Read multiple app-scoped counters at once for the current user.\n     */\n    public getCounters(keys?: string[]): Promise<GetCountersResponse> {\n        return this.sendAppEvent<GetCountersResponse>({\n            type: 'get-counters',\n            ...(keys ? { keys } : {}),\n        });\n    }\n\n    /**\n     * Clean up the SDK and remove event listeners\n     */\n    public destroy(): void {\n        if (this.messageListener) {\n            window.removeEventListener('message', this.messageListener);\n            this.messageListener = null;\n        }\n\n        // Reject all pending requests\n        for (const [requestId, pending] of this.pendingRequests.entries()) {\n            clearTimeout(pending.timeoutId);\n            pending.reject({\n                code: 'SDK_DESTROYED',\n                message: 'SDK was destroyed before request completed',\n            });\n        }\n\n        this.pendingRequests.clear();\n        this.isInitialized = false;\n    }\n}\n\n/**\n * Factory function to create a PartnerConnect instance\n *\n * @param options - Configuration options\n * @returns PartnerConnect instance\n *\n * @example\n * ```typescript\n * const learnCard = createPartnerConnect({\n *   hostOrigin: 'https://learncard.app',\n *   protocol: 'LEARNCARD_V1',\n *   requestTimeout: 30000\n * });\n * ```\n */\nexport function createPartnerConnect(options?: PartnerConnectOptions): PartnerConnect {\n    return new PartnerConnect(options);\n}\n\n// Default export for convenience\nexport default createPartnerConnect;\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@learncard/partner-connect",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "repository": {
     "type": "git",
     "url": "https://github.com/learningeconomy/LearnCard"
@@ -30,7 +30,7 @@
   "license": "MIT",
   "author": "Learning Economy Foundation (www.learningeconomy.io)",
   "dependencies": {
-    "@learncard/types": "5.13.4"
+    "@learncard/types": "5.13.6"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^22.0.2",