@createlex/onetapforms-sdk 1.2.0 → 1.2.1

package/dist/autofill.d.ts

@@ -0,0 +1,18 @@
+import type { AutofillPreviewOptions, AutofillPreviewResult } from './types';
+/**
+ * Helper to attach the canonical mapping attribute to a DOM element.
+ */
+export declare function otfFieldAttr(canonicalName: string): Record<string, string>;
+/**
+ * Collects all elements with a data-otf-field attribute.
+ * Returns the canonical name and the element reference.
+ */
+export declare function collectMappedFields(root?: ParentNode): Array<{
+    name: string;
+    element: Element;
+}>;
+/**
+ * Preview autofill values from the backend without mutating the DOM.
+ * The caller is responsible for applying values to inputs after user consent.
+ */
+export declare function previewAutofill(options: AutofillPreviewOptions): Promise<AutofillPreviewResult>;

package/dist/index.cjs

@@ -2403,6 +2403,58 @@ var sdk = /*#__PURE__*/Object.freeze({
   default: OneTapForms
 });
 
+/**
+ * Helper to attach the canonical mapping attribute to a DOM element.
+ */
+function otfFieldAttr(canonicalName) {
+    return { 'data-otf-field': canonicalName };
+}
+/**
+ * Collects all elements with a data-otf-field attribute.
+ * Returns the canonical name and the element reference.
+ */
+function collectMappedFields(root = document) {
+    if (typeof document === 'undefined')
+        return [];
+    const nodes = Array.from(root.querySelectorAll('[data-otf-field]'));
+    return nodes
+        .map((el) => {
+        const name = el.getAttribute('data-otf-field');
+        return name ? { name, element: el } : null;
+    })
+        .filter((item) => Boolean(item));
+}
+/**
+ * Preview autofill values from the backend without mutating the DOM.
+ * The caller is responsible for applying values to inputs after user consent.
+ */
+async function previewAutofill(options) {
+    const apiUrl = options.apiUrl || 'https://api.createlex.com/api/onetapforms/autofill/preview';
+    const payload = {
+        fields: options.fields || null,
+        formTemplate: options.formTemplate,
+    };
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (options.token) {
+        headers['Authorization'] = `Bearer ${options.token}`;
+    }
+    if (options.userId) {
+        headers['x-user-id'] = options.userId;
+    }
+    const response = await fetch(apiUrl, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Autofill preview failed: ${response.status} ${text}`);
+    }
+    return response.json();
+}
+
 // Export the OneTapForms class and types
 // Widget auto-initialization for CDN/script tag usage
 // This runs automatically when loaded via <script> tag
@@ -2680,7 +2732,10 @@ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
 }
 
 exports.OneTapForms = OneTapForms;
+exports.collectMappedFields = collectMappedFields;
 exports.default = OneTapForms;
 exports.initWidgets = initWidgets;
+exports.otfFieldAttr = otfFieldAttr;
+exports.previewAutofill = previewAutofill;
 exports.showQRModal = showQRModal;
 //# sourceMappingURL=index.cjs.map