@leadping/consent 1.0.3 → 1.0.4

package/dist/esm/capture.d.ts

@@ -5,7 +5,12 @@ export declare class ConsentCapture {
     private static active?;
     private readonly browser;
     private readonly buffer;
-    private readonly transport;
+    private transport?;
+    /** Resolves when the service session is available and validated. Recording starts before this. */
+    readonly ready: Promise<void>;
+    private session?;
+    private readonly observedDisclosure;
+    private disposed;
     private readonly pending;
     private head;
     private queuedBytes;

package/dist/esm/capture.js

@@ -19,6 +19,11 @@ export class ConsentCapture {
     };
     buffer = new EventBuffer();
     transport;
+    /** Resolves when the service session is available and validated. Recording starts before this. */
+    ready;
+    session;
+    observedDisclosure;
+    disposed = false;
     pending = [];
     head = 0;
     queuedBytes = 0;
@@ -36,15 +41,26 @@ export class ConsentCapture {
         const url = new URL(options.apiUrl);
         if (url.protocol !== 'https:' || url.username || url.password || url.search || url.hash)
             throw new Error('Capture API requires an HTTPS URL without credentials.');
-        if (!/^[0-9a-f-]{36}$/i.test(options.session.sessionId) || options.session.form.origin !== location.origin ||
-            !options.form.contains(options.checkbox) || !options.form.contains(options.disclosure) ||
-            options.checkbox.type !== 'checkbox' || options.checkbox.checked || options.checkbox.defaultChecked ||
-            options.disclosure.textContent !== options.session.form.disclosure)
-            throw new Error('Form does not match the approved disclosure and unchecked consent control.');
-        const remaining = Date.parse(options.session.expiresAt) - Date.now();
-        if (!Number.isFinite(remaining) || remaining <= 0 || remaining > 60 * 60 * 1000)
-            throw new Error('Invalid or expired capture session.');
-        this.transport = new CaptureTransport(url.href.replace(/\/$/, '') + '/consent/sessions/' + options.session.sessionId, options.session.uploadToken);
+        if (!options.form.contains(options.checkbox) || !options.form.contains(options.disclosure) ||
+            options.checkbox.type !== 'checkbox' || options.checkbox.checked || options.checkbox.defaultChecked)
+            throw new Error('Form requires an unchecked consent control and disclosure.');
+        this.observedDisclosure = options.disclosure.textContent ?? '';
+        this.ready = Promise.resolve().then(() => typeof options.session === 'function' ? options.session() : options.session)
+            .then(session => {
+            if (this.disposed || this.failure)
+                throw this.failure ?? new Error('Recorder is disposed.');
+            if (!/^[0-9a-f-]{36}$/i.test(session.sessionId) || session.form.origin !== location.origin ||
+                session.form.disclosure !== this.observedDisclosure)
+                throw new Error('Form does not match the approved disclosure.');
+            const remaining = Date.parse(session.expiresAt) - Date.now();
+            if (!Number.isFinite(remaining) || remaining <= 0 || remaining > 60 * 60 * 1000)
+                throw new Error('Invalid or expired capture session.');
+            this.session = session;
+            this.transport = new CaptureTransport(url.href.replace(/\/$/, '') + '/consent/sessions/' + session.sessionId, session.uploadToken);
+            if (!this.stopped)
+                this.expiry = setTimeout(() => this.fail(new Error('Capture session expired.')), remaining);
+        });
+        void this.ready.then(this.backgroundFlush).catch(error => this.fail(error));
         ConsentCapture.active = this;
         try {
             this.stopRecording = record({
@@ -69,11 +85,10 @@ export class ConsentCapture {
             options.checkbox.addEventListener('change', this.consentChanged);
             document.addEventListener('visibilitychange', this.visibilityChanged);
             this.interval = setInterval(this.backgroundFlush, 3000);
-            this.expiry = setTimeout(() => this.fail(new Error('Capture session expired.')), remaining);
-            record.addCustomEvent('leadping.disclosure', { formId: options.session.form.id });
+            record.addCustomEvent('leadping.disclosure', { disclosure: this.observedDisclosure });
         }
         catch (error) {
-            this.stop();
+            this.dispose();
             throw error;
         }
     }
@@ -86,6 +101,9 @@ export class ConsentCapture {
         if (this.failure)
             throw this.failure;
         this.seal();
+        await this.ready;
+        if (this.failure || this.disposed)
+            throw this.failure ?? new Error('Recorder is disposed.');
         while (this.head < this.pending.length || this.sending) {
             this.sending ??= this.send();
             await this.sending;
@@ -93,12 +111,12 @@ export class ConsentCapture {
         if (this.failure)
             throw this.failure;
     }
-    dispose() { this.stop(); this.transport.dispose(); }
+    dispose() { this.disposed = true; this.stop(); this.transport?.dispose(); }
     async finishCore(recipient) {
         if (this.stopped || this.failure)
             throw this.failure ?? new Error('Recorder is stopped.');
         const observedDisclosure = this.options.disclosure.textContent ?? '';
-        if (observedDisclosure !== this.options.session.form.disclosure)
+        if (observedDisclosure !== this.observedDisclosure)
             throw new Error('The disclosure changed during capture. Start a new approved form session.');
         const accepted = this.options.checkbox.checked;
         record.addCustomEvent('leadping.submit', { accepted });
@@ -108,7 +126,7 @@ export class ConsentCapture {
             lastBatchNumber: this.buffer.lastBatchNumber, lastEventNumber: this.buffer.lastEventNumber,
             accepted, observedDisclosure, recipient, browser: this.browser,
         }));
-        return { sessionId: this.options.session.sessionId, uploadToken: this.options.session.uploadToken };
+        return { sessionId: this.session.sessionId, uploadToken: this.session.uploadToken };
     }
     emit = (event) => {
         if (this.stopped || this.failure)

package/dist/esm/embed.js

@@ -1,3 +1,4 @@
+import { CaptureRejectedError } from './capture-rejected-error.js';
 import { ConsentCapture } from './capture.js';
 export { ConsentCapture } from './capture.js';
 /** Attach the Leadping-hosted capture and submission flow to a form. */
@@ -17,10 +18,8 @@ export async function attach(script) {
     status.setAttribute('role', 'status');
     form.append(status);
     let capture;
-    let ready = false;
     let submitted = false;
     const fail = (error) => {
-        ready = false;
         status.textContent = 'Unable to complete consent capture. Please reload to start again.';
         form.dispatchEvent(new CustomEvent('leadping:error', { detail: error }));
     };
@@ -33,25 +32,37 @@ export async function attach(script) {
         throw new Error('Leadping requires an HTTPS portal origin.');
     const endpoint = `${origin.origin}/api/consent`;
     const post = async (path, body) => {
-        const response = await fetch(endpoint + path, {
-            method: 'POST', headers: { 'Content-Type': 'application/json' },
-            credentials: 'omit', redirect: 'error', body: JSON.stringify(body),
-            signal: AbortSignal.timeout(30000),
-        });
-        if (!response.ok)
-            throw new Error(`Leadping request failed (${response.status}).`);
-        return response;
+        const attempts = path.endsWith('/sessions') ? 5 : 1;
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            try {
+                const response = await fetch(endpoint + path, {
+                    method: 'POST', headers: { 'Content-Type': 'application/json' },
+                    credentials: 'omit', redirect: 'error', body: JSON.stringify(body),
+                    signal: AbortSignal.timeout(attempts > 1 ? 15000 : 30000),
+                });
+                if (response.ok)
+                    return response;
+                if (response.status < 500 && response.status !== 408 && response.status !== 429)
+                    throw new CaptureRejectedError(`Leadping request failed (${response.status}).`);
+                throw new Error(`Leadping request failed (${response.status}).`);
+            }
+            catch (error) {
+                if (error instanceof CaptureRejectedError || attempt === attempts - 1)
+                    throw error;
+            }
+            await new Promise(resolve => setTimeout(resolve, 500 * 2 ** attempt));
+        }
+        throw new Error('Leadping session could not be started.');
     };
     form.addEventListener('submit', async (event) => {
         event.preventDefault();
-        if (!ready || submitted || !capture || !form.reportValidity())
+        if (submitted || !capture || !form.reportValidity())
             return;
         if (!(checkbox instanceof HTMLInputElement) || !checkbox.checked) {
             status.textContent = 'Please check the consent box before submitting.';
             return;
         }
         submitted = true;
-        ready = false;
         status.textContent = 'Submitting…';
         const values = new FormData(form);
         const recipient = {};
@@ -90,12 +101,15 @@ export async function attach(script) {
     try {
         if (!(disclosure instanceof HTMLElement) || !(checkbox instanceof HTMLInputElement))
             throw new Error('Add data-leadping-disclosure and data-leadping-consent inside the form.');
-        const session = await (await post(`/domains/${encodeURIComponent(domainId)}/sessions`, { pageUrl: location.href, disclosure: disclosure.textContent ?? '' })).json();
-        checkbox.checked = false;
-        capture = new ConsentCapture({ apiUrl: origin.origin + '/api', session, form, disclosure, checkbox, onError: fail });
-        window.addEventListener('pagehide', () => { ready = false; capture?.dispose(); }, { once: true });
-        ready = true;
-        status.textContent = '';
+        const pageUrl = location.href;
+        const observedDisclosure = disclosure.textContent ?? '';
+        capture = new ConsentCapture({ apiUrl: origin.origin + '/api',
+            session: async () => (await post(`/domains/${encodeURIComponent(domainId)}/sessions`, { pageUrl, disclosure: observedDisclosure })).json(),
+            form, disclosure, checkbox, onError: fail });
+        window.addEventListener('pagehide', () => { capture?.dispose(); }, { once: true });
+        await capture.ready;
+        if (!submitted)
+            status.textContent = '';
         form.dispatchEvent(new CustomEvent('leadping:ready'));
     }
     catch (error) {

package/dist/esm/types.d.ts

@@ -27,7 +27,8 @@ export interface CaptureReference {
 export interface CaptureOptions {
     /** Absolute HTTPS API origin; no credentials or query string. */
     apiUrl: string;
-    session: CaptureSession;
+    /** A session or a factory that obtains one. Capture starts immediately while the factory is pending. */
+    session: CaptureSession | (() => Promise<CaptureSession>);
     form: HTMLFormElement;
     disclosure: HTMLElement;
     checkbox: HTMLInputElement;

package/dist/leadping-consent.js

@@ -25,6 +25,10 @@ var LeadpingConsent = (() => {
     attach: () => attach
   });
 
+  // src/capture-rejected-error.ts
+  var CaptureRejectedError = class extends Error {
+  };
+
   // node_modules/rrweb/dist/rrweb.js
   var __defProp2 = Object.defineProperty;
   var __defNormalProp = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -12768,10 +12772,6 @@ var LeadpingConsent = (() => {
     }
   };
 
-  // src/capture-rejected-error.ts
-  var CaptureRejectedError = class extends Error {
-  };
-
   // src/transport.ts
   var CaptureTransport = class {
     constructor(baseUrl, token) {
@@ -12839,12 +12839,21 @@ var LeadpingConsent = (() => {
       const url = new URL(options.apiUrl);
       if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash)
         throw new Error("Capture API requires an HTTPS URL without credentials.");
-      if (!/^[0-9a-f-]{36}$/i.test(options.session.sessionId) || options.session.form.origin !== location.origin || !options.form.contains(options.checkbox) || !options.form.contains(options.disclosure) || options.checkbox.type !== "checkbox" || options.checkbox.checked || options.checkbox.defaultChecked || options.disclosure.textContent !== options.session.form.disclosure)
-        throw new Error("Form does not match the approved disclosure and unchecked consent control.");
-      const remaining = Date.parse(options.session.expiresAt) - Date.now();
-      if (!Number.isFinite(remaining) || remaining <= 0 || remaining > 60 * 60 * 1e3)
-        throw new Error("Invalid or expired capture session.");
-      this.transport = new CaptureTransport(url.href.replace(/\/$/, "") + "/consent/sessions/" + options.session.sessionId, options.session.uploadToken);
+      if (!options.form.contains(options.checkbox) || !options.form.contains(options.disclosure) || options.checkbox.type !== "checkbox" || options.checkbox.checked || options.checkbox.defaultChecked)
+        throw new Error("Form requires an unchecked consent control and disclosure.");
+      this.observedDisclosure = options.disclosure.textContent ?? "";
+      this.ready = Promise.resolve().then(() => typeof options.session === "function" ? options.session() : options.session).then((session) => {
+        if (this.disposed || this.failure) throw this.failure ?? new Error("Recorder is disposed.");
+        if (!/^[0-9a-f-]{36}$/i.test(session.sessionId) || session.form.origin !== location.origin || session.form.disclosure !== this.observedDisclosure)
+          throw new Error("Form does not match the approved disclosure.");
+        const remaining = Date.parse(session.expiresAt) - Date.now();
+        if (!Number.isFinite(remaining) || remaining <= 0 || remaining > 60 * 60 * 1e3)
+          throw new Error("Invalid or expired capture session.");
+        this.session = session;
+        this.transport = new CaptureTransport(url.href.replace(/\/$/, "") + "/consent/sessions/" + session.sessionId, session.uploadToken);
+        if (!this.stopped) this.expiry = setTimeout(() => this.fail(new Error("Capture session expired.")), remaining);
+      });
+      void this.ready.then(this.backgroundFlush).catch((error) => this.fail(error));
       _ConsentCapture.active = this;
       try {
         this.stopRecording = record({
@@ -12871,10 +12880,9 @@ var LeadpingConsent = (() => {
         options.checkbox.addEventListener("change", this.consentChanged);
         document.addEventListener("visibilitychange", this.visibilityChanged);
         this.interval = setInterval(this.backgroundFlush, 3e3);
-        this.expiry = setTimeout(() => this.fail(new Error("Capture session expired.")), remaining);
-        record.addCustomEvent("leadping.disclosure", { formId: options.session.form.id });
+        record.addCustomEvent("leadping.disclosure", { disclosure: this.observedDisclosure });
       } catch (error) {
-        this.stop();
+        this.dispose();
         throw error;
       }
     }
@@ -12894,6 +12902,11 @@ var LeadpingConsent = (() => {
     };
     buffer = new EventBuffer();
     transport;
+    /** Resolves when the service session is available and validated. Recording starts before this. */
+    ready;
+    session;
+    observedDisclosure;
+    disposed = false;
     pending = [];
     head = 0;
     queuedBytes = 0;
@@ -12912,6 +12925,8 @@ var LeadpingConsent = (() => {
     async flush() {
       if (this.failure) throw this.failure;
       this.seal();
+      await this.ready;
+      if (this.failure || this.disposed) throw this.failure ?? new Error("Recorder is disposed.");
       while (this.head < this.pending.length || this.sending) {
         this.sending ??= this.send();
         await this.sending;
@@ -12919,13 +12934,14 @@ var LeadpingConsent = (() => {
       if (this.failure) throw this.failure;
     }
     dispose() {
+      this.disposed = true;
       this.stop();
-      this.transport.dispose();
+      this.transport?.dispose();
     }
     async finishCore(recipient) {
       if (this.stopped || this.failure) throw this.failure ?? new Error("Recorder is stopped.");
       const observedDisclosure = this.options.disclosure.textContent ?? "";
-      if (observedDisclosure !== this.options.session.form.disclosure)
+      if (observedDisclosure !== this.observedDisclosure)
         throw new Error("The disclosure changed during capture. Start a new approved form session.");
       const accepted = this.options.checkbox.checked;
       record.addCustomEvent("leadping.submit", { accepted });
@@ -12939,7 +12955,7 @@ var LeadpingConsent = (() => {
         recipient,
         browser: this.browser
       }));
-      return { sessionId: this.options.session.sessionId, uploadToken: this.options.session.uploadToken };
+      return { sessionId: this.session.sessionId, uploadToken: this.session.uploadToken };
     }
     emit = (event) => {
       if (this.stopped || this.failure) return;
@@ -13020,10 +13036,8 @@ var LeadpingConsent = (() => {
     status.setAttribute("role", "status");
     form.append(status);
     let capture;
-    let ready = false;
     let submitted = false;
     const fail = (error) => {
-      ready = false;
       status.textContent = "Unable to complete consent capture. Please reload to start again.";
       form.dispatchEvent(new CustomEvent("leadping:error", { detail: error }));
     };
@@ -13035,26 +13049,36 @@ var LeadpingConsent = (() => {
       throw new Error("Leadping requires an HTTPS portal origin.");
     const endpoint = `${origin.origin}/api/consent`;
     const post = async (path, body) => {
-      const response = await fetch(endpoint + path, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        credentials: "omit",
-        redirect: "error",
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(3e4)
-      });
-      if (!response.ok) throw new Error(`Leadping request failed (${response.status}).`);
-      return response;
+      const attempts = path.endsWith("/sessions") ? 5 : 1;
+      for (let attempt = 0; attempt < attempts; attempt++) {
+        try {
+          const response = await fetch(endpoint + path, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            credentials: "omit",
+            redirect: "error",
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(attempts > 1 ? 15e3 : 3e4)
+          });
+          if (response.ok) return response;
+          if (response.status < 500 && response.status !== 408 && response.status !== 429)
+            throw new CaptureRejectedError(`Leadping request failed (${response.status}).`);
+          throw new Error(`Leadping request failed (${response.status}).`);
+        } catch (error) {
+          if (error instanceof CaptureRejectedError || attempt === attempts - 1) throw error;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 500 * 2 ** attempt));
+      }
+      throw new Error("Leadping session could not be started.");
     };
     form.addEventListener("submit", async (event) => {
       event.preventDefault();
-      if (!ready || submitted || !capture || !form.reportValidity()) return;
+      if (submitted || !capture || !form.reportValidity()) return;
       if (!(checkbox instanceof HTMLInputElement) || !checkbox.checked) {
         status.textContent = "Please check the consent box before submitting.";
         return;
       }
       submitted = true;
-      ready = false;
       status.textContent = "Submitting\u2026";
       const values = new FormData(form);
       const recipient = {};
@@ -13088,15 +13112,21 @@ var LeadpingConsent = (() => {
     try {
       if (!(disclosure instanceof HTMLElement) || !(checkbox instanceof HTMLInputElement))
         throw new Error("Add data-leadping-disclosure and data-leadping-consent inside the form.");
-      const session = await (await post(`/domains/${encodeURIComponent(domainId)}/sessions`, { pageUrl: location.href, disclosure: disclosure.textContent ?? "" })).json();
-      checkbox.checked = false;
-      capture = new ConsentCapture({ apiUrl: origin.origin + "/api", session, form, disclosure, checkbox, onError: fail });
+      const pageUrl = location.href;
+      const observedDisclosure = disclosure.textContent ?? "";
+      capture = new ConsentCapture({
+        apiUrl: origin.origin + "/api",
+        session: async () => (await post(`/domains/${encodeURIComponent(domainId)}/sessions`, { pageUrl, disclosure: observedDisclosure })).json(),
+        form,
+        disclosure,
+        checkbox,
+        onError: fail
+      });
       window.addEventListener("pagehide", () => {
-        ready = false;
         capture?.dispose();
       }, { once: true });
-      ready = true;
-      status.textContent = "";
+      await capture.ready;
+      if (!submitted) status.textContent = "";
       form.dispatchEvent(new CustomEvent("leadping:ready"));
     } catch (error) {
       capture?.dispose();