@linkpane/mailer-post 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# @linkpane/mailer-post
+
+Submission-only SDK for Linkpane Mailer forms.
+
+## Install
+
+```bash
+npm install @linkpane/mailer-post
+```
+
+## Usage
+
+```ts
+import { submitForm } from '@linkpane/mailer-post'
+
+const result = await submitForm({
+  apiBaseUrl: 'https://api.linkpane.com',
+  pid: '12345',
+  slug: 'contact-me',
+  data: {
+    firstName: 'Ada',
+    lastName: 'Lovelace',
+    email: 'ada@example.com',
+    message: 'Hello from my website'
+  }
+})
+
+if (!result.ok) {
+  console.error(result.message, result.errors)
+}
+```
+
+## Browser Helper
+
+```ts
+import { attachToForm } from '@linkpane/mailer-post'
+
+const form = document.querySelector('#contact-form')
+attachToForm(form, {
+  apiBaseUrl: 'https://api.linkpane.com',
+  pid: '12345',
+  slug: 'contact-me',
+  onSuccess: () => {},
+  onError: () => {},
+})
+```
+
+## Notes
+
+- Required fields: `email`, `firstName`, `lastName`.
+- For mobile apps, submit through your backend proxy to satisfy Origin rules.

package/dist/__tests__/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/__tests__/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/client.test.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const helpers_1 = require("../helpers");
+const client_1 = require("../client");
+const dummyFetch = async (url, options) => {
+    return {
+        ok: true,
+        status: 200,
+        headers: {
+            get: (name) => (name.toLowerCase() === 'content-type' ? 'application/json' : null),
+        },
+        json: async () => ({ message: 'Form submitted successfully!' }),
+    };
+};
+(0, vitest_1.describe)('buildActionUrl', () => {
+    (0, vitest_1.it)('builds the correct endpoint', () => {
+        const url = (0, helpers_1.buildActionUrl)({
+            apiBaseUrl: 'https://api.linkpane.com/',
+            pid: '123',
+            slug: 'contact-me',
+        });
+        (0, vitest_1.expect)(url).toBe('https://api.linkpane.com/mailer/123/form/contact-me');
+    });
+});
+(0, vitest_1.describe)('submitForm', () => {
+    (0, vitest_1.it)('returns ok for successful submission', async () => {
+        const result = await (0, client_1.submitForm)({
+            apiBaseUrl: 'https://api.linkpane.com',
+            pid: '123',
+            slug: 'contact-me',
+            data: { email: 'a@b.com', firstName: 'Ada', lastName: 'Lovelace' },
+            fetch: dummyFetch,
+        });
+        (0, vitest_1.expect)(result.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/__tests__/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":";;AAAA,mCAA6C;AAC7C,wCAA2C;AAC3C,sCAAsC;AAEtC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAE,OAAY,EAAE,EAAE;IACrD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,GAAG;QACX,OAAO,EAAE;YACP,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;SAC3F;QACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;KAChE,CAAA;AACH,CAAC,CAAA;AAED,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,IAAA,wBAAc,EAAC;YACzB,UAAU,EAAE,2BAA2B;YACvC,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,YAAY;SACnB,CAAC,CAAA;QACF,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,IAAA,iBAAQ,EAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAA,WAAE,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAU,EAAC;YAC9B,UAAU,EAAE,0BAA0B;YACtC,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE;YAClE,KAAK,EAAE,UAAiB;SACzB,CAAC,CAAA;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/client.d.ts

@@ -0,0 +1,4 @@
+import { AttachToFormOptions, SubmitFormParams, SubmitFormResult } from './types';
+export declare function submitForm(params: SubmitFormParams): Promise<SubmitFormResult>;
+export declare function attachToForm(form: HTMLFormElement, options: AttachToFormOptions): () => void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AA0BjF,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgFpF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,cAoC/E"}

package/dist/client.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitForm = submitForm;
+exports.attachToForm = attachToForm;
+const helpers_1 = require("./helpers");
+const REQUIRED_FIELDS = ['email', 'firstName', 'lastName'];
+function validateRequiredFields(data) {
+    const missing = REQUIRED_FIELDS.filter((field) => {
+        const value = data[field];
+        if (value === null || typeof value === 'undefined')
+            return true;
+        if (typeof value === 'string' && value.trim().length === 0)
+            return true;
+        return false;
+    });
+    if (missing.length === 0)
+        return null;
+    return {
+        message: 'Missing required fields',
+        fields: missing,
+    };
+}
+function getFetchImpl(explicitFetch) {
+    if (explicitFetch)
+        return explicitFetch;
+    if (typeof fetch !== 'undefined')
+        return fetch;
+    return null;
+}
+async function submitForm(params) {
+    const { apiBaseUrl, pid, slug, data, mode = 'json', headers, fetch: explicitFetch, validateRequired = true, } = params;
+    if (validateRequired) {
+        const validationError = validateRequiredFields(data);
+        if (validationError) {
+            return { ok: false, message: validationError.message, errors: validationError };
+        }
+    }
+    const fetchImpl = getFetchImpl(explicitFetch);
+    if (!fetchImpl) {
+        return {
+            ok: false,
+            message: 'Fetch API is not available. Provide a fetch implementation via options.fetch.',
+        };
+    }
+    const url = (0, helpers_1.buildActionUrl)({ apiBaseUrl, pid, slug });
+    const requestHeaders = {
+        'Content-Type': 'application/json',
+        ...headers,
+    };
+    if (mode === 'json') {
+        requestHeaders.Accept = 'application/json';
+        requestHeaders['X-Requested-With'] = 'XMLHttpRequest';
+    }
+    try {
+        const response = await fetchImpl(url, {
+            method: 'POST',
+            headers: requestHeaders,
+            body: JSON.stringify(data),
+        });
+        const contentType = response.headers?.get?.('content-type') || '';
+        if (contentType.includes('application/json')) {
+            const payload = await response.json().catch(() => null);
+            if (!response.ok) {
+                return {
+                    ok: false,
+                    message: payload?.message || 'Form submission failed',
+                    errors: payload?.errors,
+                    status: response.status,
+                };
+            }
+            return {
+                ok: true,
+                message: payload?.message || 'Form submitted successfully',
+                status: response.status,
+            };
+        }
+        if (!response.ok) {
+            return {
+                ok: false,
+                message: 'Form submission failed',
+                status: response.status,
+            };
+        }
+        return { ok: true, message: 'Form submitted successfully', status: response.status };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: error?.message || 'Form submission failed',
+        };
+    }
+}
+function attachToForm(form, options) {
+    if (!form || typeof form.addEventListener !== 'function') {
+        throw new Error('attachToForm expects a valid HTMLFormElement');
+    }
+    const handler = async (event) => {
+        event.preventDefault();
+        const data = (0, helpers_1.serializeForm)(form);
+        const honeypotField = options.honeypotField;
+        if (honeypotField && typeof data[honeypotField] === 'undefined') {
+            data[honeypotField] = '';
+        }
+        const result = await submitForm({
+            apiBaseUrl: options.apiBaseUrl,
+            pid: options.pid,
+            slug: options.slug,
+            data,
+            mode: options.mode,
+            headers: options.headers,
+            fetch: options.fetch,
+            validateRequired: options.validateRequired,
+        });
+        if (result.ok) {
+            options.onSuccess?.(result);
+        }
+        else {
+            options.onError?.(result);
+        }
+    };
+    form.addEventListener('submit', handler);
+    return () => form.removeEventListener('submit', handler);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;AA0BA,gCAgFC;AAED,oCAoCC;AA/ID,uCAAyD;AAEzD,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;AAE1D,SAAS,sBAAsB,CAAC,IAAyB;IACvD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,WAAW;YAAE,OAAO,IAAI,CAAA;QAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACvE,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO;QACL,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,OAAO;KAChB,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,aAA4B;IAChD,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,IAAI,OAAO,KAAK,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAC9C,OAAO,IAAI,CAAA;AACb,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,MAAwB;IACvD,MAAM,EACJ,UAAU,EACV,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,GAAG,MAAM,EACb,OAAO,EACP,KAAK,EAAE,aAAa,EACpB,gBAAgB,GAAG,IAAI,GACxB,GAAG,MAAM,CAAA;IAEV,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACpD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;QACjF,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,CAAC,CAAA;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,+EAA+E;SACzF,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,wBAAc,EAAC,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;IAErD,MAAM,cAAc,GAA2B;QAC7C,cAAc,EAAE,kBAAkB;QAClC,GAAG,OAAO;KACX,CAAA;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,cAAc,CAAC,MAAM,GAAG,kBAAkB,CAAA;QAC1C,cAAc,CAAC,kBAAkB,CAAC,GAAG,gBAAgB,CAAA;IACvD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QAEjE,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;YACvD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,wBAAwB;oBACrD,MAAM,EAAE,OAAO,EAAE,MAAM;oBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;iBACxB,CAAA;YACH,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,6BAA6B;gBAC1D,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAA;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,wBAAwB;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAA;QACH,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,6BAA6B,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IACtF,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,wBAAwB;SACpD,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,IAAqB,EAAE,OAA4B;IAC9E,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,EAAE,KAAY,EAAE,EAAE;QACrC,KAAK,CAAC,cAAc,EAAE,CAAA;QAEtB,MAAM,IAAI,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,CAAA;QAEhC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC3C,IAAI,aAAa,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,WAAW,EAAE,CAAC;YAChE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAA;QAC1B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI;YACJ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC,CAAA;IAED,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAExC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AAC1D,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,4 @@
+import { SubmitFormParams } from './types';
+export declare function buildActionUrl(params: Pick<SubmitFormParams, 'apiBaseUrl' | 'pid' | 'slug'>): string;
+export declare function serializeForm(form: HTMLFormElement): Record<string, any>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE1C,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC,UAG3F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,uBAsBlD"}

package/dist/helpers.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildActionUrl = buildActionUrl;
+exports.serializeForm = serializeForm;
+function buildActionUrl(params) {
+    const base = params.apiBaseUrl.replace(/\/+$/, '');
+    return `${base}/mailer/${encodeURIComponent(params.pid)}/form/${encodeURIComponent(params.slug)}`;
+}
+function serializeForm(form) {
+    if (typeof FormData === 'undefined') {
+        throw new Error('FormData is not available in this environment');
+    }
+    const formData = new FormData(form);
+    const data = {};
+    for (const [key, value] of formData.entries()) {
+        if (Object.prototype.hasOwnProperty.call(data, key)) {
+            const existing = data[key];
+            if (Array.isArray(existing)) {
+                existing.push(value);
+            }
+            else {
+                data[key] = [existing, value];
+            }
+            continue;
+        }
+        data[key] = value;
+    }
+    return data;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";;AAEA,wCAGC;AAED,sCAsBC;AA3BD,SAAgB,cAAc,CAAC,MAA6D;IAC1F,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAClD,OAAO,GAAG,IAAI,WAAW,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;AACnG,CAAC;AAED,SAAgB,aAAa,CAAC,IAAqB;IACjD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,IAAI,GAAwB,EAAE,CAAA;IAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC/B,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+type SubmissionMode = 'json' | 'redirect';
+type SubmitFormParams = {
+    apiBaseUrl: string;
+    pid: string;
+    slug: string;
+    data: Record<string, any>;
+    mode?: SubmissionMode;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+    validateRequired?: boolean;
+};
+type SubmitFormResult = {
+    ok: true;
+    message: string;
+    status: number;
+} | {
+    ok: false;
+    message: string;
+    status?: number;
+    errors?: any;
+};
+type AttachToFormOptions = Omit<SubmitFormParams, 'data'> & {
+    onSuccess?: (result: SubmitFormResult) => void;
+    onError?: (result: SubmitFormResult) => void;
+    honeypotField?: string;
+};
+
+declare function buildActionUrl(params: Pick<SubmitFormParams, 'apiBaseUrl' | 'pid' | 'slug'>): string;
+declare function serializeForm(form: HTMLFormElement): Record<string, any>;
+
+declare function submitForm(params: SubmitFormParams): Promise<SubmitFormResult>;
+declare function attachToForm(form: HTMLFormElement, options: AttachToFormOptions): () => void;
+
+export { type AttachToFormOptions, type SubmissionMode, type SubmitFormParams, type SubmitFormResult, attachToForm, buildActionUrl, serializeForm, submitForm };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './helpers';
+export * from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,4CAAyB;AACzB,2CAAwB"}

package/dist/index.mjs

@@ -0,0 +1,154 @@
+// src/helpers.ts
+function buildActionUrl(params) {
+  const base = params.apiBaseUrl.replace(/\/+$/, "");
+  return `${base}/mailer/${encodeURIComponent(params.pid)}/form/${encodeURIComponent(params.slug)}`;
+}
+function serializeForm(form) {
+  if (typeof FormData === "undefined") {
+    throw new Error("FormData is not available in this environment");
+  }
+  const formData = new FormData(form);
+  const data = {};
+  for (const [key, value] of formData.entries()) {
+    if (Object.prototype.hasOwnProperty.call(data, key)) {
+      const existing = data[key];
+      if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        data[key] = [existing, value];
+      }
+      continue;
+    }
+    data[key] = value;
+  }
+  return data;
+}
+
+// src/client.ts
+var REQUIRED_FIELDS = ["email", "firstName", "lastName"];
+function validateRequiredFields(data) {
+  const missing = REQUIRED_FIELDS.filter((field) => {
+    const value = data[field];
+    if (value === null || typeof value === "undefined") return true;
+    if (typeof value === "string" && value.trim().length === 0) return true;
+    return false;
+  });
+  if (missing.length === 0) return null;
+  return {
+    message: "Missing required fields",
+    fields: missing
+  };
+}
+function getFetchImpl(explicitFetch) {
+  if (explicitFetch) return explicitFetch;
+  if (typeof fetch !== "undefined") return fetch;
+  return null;
+}
+async function submitForm(params) {
+  const {
+    apiBaseUrl,
+    pid,
+    slug,
+    data,
+    mode = "json",
+    headers,
+    fetch: explicitFetch,
+    validateRequired = true
+  } = params;
+  if (validateRequired) {
+    const validationError = validateRequiredFields(data);
+    if (validationError) {
+      return { ok: false, message: validationError.message, errors: validationError };
+    }
+  }
+  const fetchImpl = getFetchImpl(explicitFetch);
+  if (!fetchImpl) {
+    return {
+      ok: false,
+      message: "Fetch API is not available. Provide a fetch implementation via options.fetch."
+    };
+  }
+  const url = buildActionUrl({ apiBaseUrl, pid, slug });
+  const requestHeaders = {
+    "Content-Type": "application/json",
+    ...headers
+  };
+  if (mode === "json") {
+    requestHeaders.Accept = "application/json";
+    requestHeaders["X-Requested-With"] = "XMLHttpRequest";
+  }
+  try {
+    const response = await fetchImpl(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: JSON.stringify(data)
+    });
+    const contentType = response.headers?.get?.("content-type") || "";
+    if (contentType.includes("application/json")) {
+      const payload = await response.json().catch(() => null);
+      if (!response.ok) {
+        return {
+          ok: false,
+          message: payload?.message || "Form submission failed",
+          errors: payload?.errors,
+          status: response.status
+        };
+      }
+      return {
+        ok: true,
+        message: payload?.message || "Form submitted successfully",
+        status: response.status
+      };
+    }
+    if (!response.ok) {
+      return {
+        ok: false,
+        message: "Form submission failed",
+        status: response.status
+      };
+    }
+    return { ok: true, message: "Form submitted successfully", status: response.status };
+  } catch (error) {
+    return {
+      ok: false,
+      message: error?.message || "Form submission failed"
+    };
+  }
+}
+function attachToForm(form, options) {
+  if (!form || typeof form.addEventListener !== "function") {
+    throw new Error("attachToForm expects a valid HTMLFormElement");
+  }
+  const handler = async (event) => {
+    event.preventDefault();
+    const data = serializeForm(form);
+    const honeypotField = options.honeypotField;
+    if (honeypotField && typeof data[honeypotField] === "undefined") {
+      data[honeypotField] = "";
+    }
+    const result = await submitForm({
+      apiBaseUrl: options.apiBaseUrl,
+      pid: options.pid,
+      slug: options.slug,
+      data,
+      mode: options.mode,
+      headers: options.headers,
+      fetch: options.fetch,
+      validateRequired: options.validateRequired
+    });
+    if (result.ok) {
+      options.onSuccess?.(result);
+    } else {
+      options.onError?.(result);
+    }
+  };
+  form.addEventListener("submit", handler);
+  return () => form.removeEventListener("submit", handler);
+}
+export {
+  attachToForm,
+  buildActionUrl,
+  serializeForm,
+  submitForm
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers.ts","../src/client.ts"],"sourcesContent":["import { SubmitFormParams } from './types'\n\nexport function buildActionUrl(params: Pick<SubmitFormParams, 'apiBaseUrl' | 'pid' | 'slug'>) {\n  const base = params.apiBaseUrl.replace(/\\/+$/, '')\n  return `${base}/mailer/${encodeURIComponent(params.pid)}/form/${encodeURIComponent(params.slug)}`\n}\n\nexport function serializeForm(form: HTMLFormElement) {\n  if (typeof FormData === 'undefined') {\n    throw new Error('FormData is not available in this environment')\n  }\n\n  const formData = new FormData(form)\n  const data: Record<string, any> = {}\n\n  for (const [key, value] of formData.entries()) {\n    if (Object.prototype.hasOwnProperty.call(data, key)) {\n      const existing = data[key]\n      if (Array.isArray(existing)) {\n        existing.push(value)\n      } else {\n        data[key] = [existing, value]\n      }\n      continue\n    }\n    data[key] = value\n  }\n\n  return data\n}\r\n","import { AttachToFormOptions, SubmitFormParams, SubmitFormResult } from './types'\nimport { buildActionUrl, serializeForm } from './helpers'\n\nconst REQUIRED_FIELDS = ['email', 'firstName', 'lastName']\n\nfunction validateRequiredFields(data: Record<string, any>) {\n  const missing = REQUIRED_FIELDS.filter((field) => {\n    const value = data[field]\n    if (value === null || typeof value === 'undefined') return true\n    if (typeof value === 'string' && value.trim().length === 0) return true\n    return false\n  })\n\n  if (missing.length === 0) return null\n  return {\n    message: 'Missing required fields',\n    fields: missing,\n  }\n}\n\nfunction getFetchImpl(explicitFetch?: typeof fetch) {\n  if (explicitFetch) return explicitFetch\n  if (typeof fetch !== 'undefined') return fetch\n  return null\n}\n\nexport async function submitForm(params: SubmitFormParams): Promise<SubmitFormResult> {\n  const {\n    apiBaseUrl,\n    pid,\n    slug,\n    data,\n    mode = 'json',\n    headers,\n    fetch: explicitFetch,\n    validateRequired = true,\n  } = params\n\n  if (validateRequired) {\n    const validationError = validateRequiredFields(data)\n    if (validationError) {\n      return { ok: false, message: validationError.message, errors: validationError }\n    }\n  }\n\n  const fetchImpl = getFetchImpl(explicitFetch)\n  if (!fetchImpl) {\n    return {\n      ok: false,\n      message: 'Fetch API is not available. Provide a fetch implementation via options.fetch.',\n    }\n  }\n\n  const url = buildActionUrl({ apiBaseUrl, pid, slug })\n\n  const requestHeaders: Record<string, string> = {\n    'Content-Type': 'application/json',\n    ...headers,\n  }\n\n  if (mode === 'json') {\n    requestHeaders.Accept = 'application/json'\n    requestHeaders['X-Requested-With'] = 'XMLHttpRequest'\n  }\n\n  try {\n    const response = await fetchImpl(url, {\n      method: 'POST',\n      headers: requestHeaders,\n      body: JSON.stringify(data),\n    })\n\n    const contentType = response.headers?.get?.('content-type') || ''\n\n    if (contentType.includes('application/json')) {\n      const payload = await response.json().catch(() => null)\n      if (!response.ok) {\n        return {\n          ok: false,\n          message: payload?.message || 'Form submission failed',\n          errors: payload?.errors,\n          status: response.status,\n        }\n      }\n      return {\n        ok: true,\n        message: payload?.message || 'Form submitted successfully',\n        status: response.status,\n      }\n    }\n\n    if (!response.ok) {\n      return {\n        ok: false,\n        message: 'Form submission failed',\n        status: response.status,\n      }\n    }\n\n    return { ok: true, message: 'Form submitted successfully', status: response.status }\n  } catch (error: any) {\n    return {\n      ok: false,\n      message: error?.message || 'Form submission failed',\n    }\n  }\n}\n\nexport function attachToForm(form: HTMLFormElement, options: AttachToFormOptions) {\n  if (!form || typeof form.addEventListener !== 'function') {\n    throw new Error('attachToForm expects a valid HTMLFormElement')\n  }\n\n  const handler = async (event: Event) => {\n    event.preventDefault()\n\n    const data = serializeForm(form)\n\n    const honeypotField = options.honeypotField\n    if (honeypotField && typeof data[honeypotField] === 'undefined') {\n      data[honeypotField] = ''\n    }\n\n    const result = await submitForm({\n      apiBaseUrl: options.apiBaseUrl,\n      pid: options.pid,\n      slug: options.slug,\n      data,\n      mode: options.mode,\n      headers: options.headers,\n      fetch: options.fetch,\n      validateRequired: options.validateRequired,\n    })\n\n    if (result.ok) {\n      options.onSuccess?.(result)\n    } else {\n      options.onError?.(result)\n    }\n  }\n\n  form.addEventListener('submit', handler)\n\n  return () => form.removeEventListener('submit', handler)\n}\r\n"],"mappings":"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","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export type SubmissionMode = 'json' | 'redirect';
+export type SubmitFormParams = {
+    apiBaseUrl: string;
+    pid: string;
+    slug: string;
+    data: Record<string, any>;
+    mode?: SubmissionMode;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+    validateRequired?: boolean;
+};
+export type SubmitFormResult = {
+    ok: true;
+    message: string;
+    status: number;
+} | {
+    ok: false;
+    message: string;
+    status?: number;
+    errors?: any;
+};
+export type AttachToFormOptions = Omit<SubmitFormParams, 'data'> & {
+    onSuccess?: (result: SubmitFormResult) => void;
+    onError?: (result: SubmitFormResult) => void;
+    honeypotField?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAA;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA;AAEjE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG;IACjE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC9C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist-cjs/__tests__/client.test.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const helpers_1 = require("../helpers");
+const client_1 = require("../client");
+const dummyFetch = async (url, options) => {
+    return {
+        ok: true,
+        status: 200,
+        headers: {
+            get: (name) => (name.toLowerCase() === 'content-type' ? 'application/json' : null),
+        },
+        json: async () => ({ message: 'Form submitted successfully!' }),
+    };
+};
+(0, vitest_1.describe)('buildActionUrl', () => {
+    (0, vitest_1.it)('builds the correct endpoint', () => {
+        const url = (0, helpers_1.buildActionUrl)({
+            apiBaseUrl: 'https://api.linkpane.com/',
+            pid: '123',
+            slug: 'contact-me',
+        });
+        (0, vitest_1.expect)(url).toBe('https://api.linkpane.com/mailer/123/form/contact-me');
+    });
+});
+(0, vitest_1.describe)('submitForm', () => {
+    (0, vitest_1.it)('returns ok for successful submission', async () => {
+        const result = await (0, client_1.submitForm)({
+            apiBaseUrl: 'https://api.linkpane.com',
+            pid: '123',
+            slug: 'contact-me',
+            data: { email: 'a@b.com', firstName: 'Ada', lastName: 'Lovelace' },
+            fetch: dummyFetch,
+        });
+        (0, vitest_1.expect)(result.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist-cjs/__tests__/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":";;AAAA,mCAA6C;AAC7C,wCAA2C;AAC3C,sCAAsC;AAEtC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAW,EAAE,OAAY,EAAE,EAAE;IACrD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,GAAG;QACX,OAAO,EAAE;YACP,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;SAC3F;QACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;KAChE,CAAA;AACH,CAAC,CAAA;AAED,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,IAAA,wBAAc,EAAC;YACzB,UAAU,EAAE,2BAA2B;YACvC,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,YAAY;SACnB,CAAC,CAAA;QACF,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,IAAA,iBAAQ,EAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAA,WAAE,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAU,EAAC;YAC9B,UAAU,EAAE,0BAA0B;YACtC,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE;YAClE,KAAK,EAAE,UAAiB;SACzB,CAAC,CAAA;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist-cjs/client.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitForm = submitForm;
+exports.attachToForm = attachToForm;
+const helpers_1 = require("./helpers");
+const REQUIRED_FIELDS = ['email', 'firstName', 'lastName'];
+function validateRequiredFields(data) {
+    const missing = REQUIRED_FIELDS.filter((field) => {
+        const value = data[field];
+        if (value === null || typeof value === 'undefined')
+            return true;
+        if (typeof value === 'string' && value.trim().length === 0)
+            return true;
+        return false;
+    });
+    if (missing.length === 0)
+        return null;
+    return {
+        message: 'Missing required fields',
+        fields: missing,
+    };
+}
+function getFetchImpl(explicitFetch) {
+    if (explicitFetch)
+        return explicitFetch;
+    if (typeof fetch !== 'undefined')
+        return fetch;
+    return null;
+}
+async function submitForm(params) {
+    const { apiBaseUrl, pid, slug, data, mode = 'json', headers, fetch: explicitFetch, validateRequired = true, } = params;
+    if (validateRequired) {
+        const validationError = validateRequiredFields(data);
+        if (validationError) {
+            return { ok: false, message: validationError.message, errors: validationError };
+        }
+    }
+    const fetchImpl = getFetchImpl(explicitFetch);
+    if (!fetchImpl) {
+        return {
+            ok: false,
+            message: 'Fetch API is not available. Provide a fetch implementation via options.fetch.',
+        };
+    }
+    const url = (0, helpers_1.buildActionUrl)({ apiBaseUrl, pid, slug });
+    const requestHeaders = {
+        'Content-Type': 'application/json',
+        ...headers,
+    };
+    if (mode === 'json') {
+        requestHeaders.Accept = 'application/json';
+        requestHeaders['X-Requested-With'] = 'XMLHttpRequest';
+    }
+    try {
+        const response = await fetchImpl(url, {
+            method: 'POST',
+            headers: requestHeaders,
+            body: JSON.stringify(data),
+        });
+        const contentType = response.headers?.get?.('content-type') || '';
+        if (contentType.includes('application/json')) {
+            const payload = await response.json().catch(() => null);
+            if (!response.ok) {
+                return {
+                    ok: false,
+                    message: payload?.message || 'Form submission failed',
+                    errors: payload?.errors,
+                    status: response.status,
+                };
+            }
+            return {
+                ok: true,
+                message: payload?.message || 'Form submitted successfully',
+                status: response.status,
+            };
+        }
+        if (!response.ok) {
+            return {
+                ok: false,
+                message: 'Form submission failed',
+                status: response.status,
+            };
+        }
+        return { ok: true, message: 'Form submitted successfully', status: response.status };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: error?.message || 'Form submission failed',
+        };
+    }
+}
+function attachToForm(form, options) {
+    if (!form || typeof form.addEventListener !== 'function') {
+        throw new Error('attachToForm expects a valid HTMLFormElement');
+    }
+    const handler = async (event) => {
+        event.preventDefault();
+        const data = (0, helpers_1.serializeForm)(form);
+        const honeypotField = options.honeypotField;
+        if (honeypotField && typeof data[honeypotField] === 'undefined') {
+            data[honeypotField] = '';
+        }
+        const result = await submitForm({
+            apiBaseUrl: options.apiBaseUrl,
+            pid: options.pid,
+            slug: options.slug,
+            data,
+            mode: options.mode,
+            headers: options.headers,
+            fetch: options.fetch,
+            validateRequired: options.validateRequired,
+        });
+        if (result.ok) {
+            options.onSuccess?.(result);
+        }
+        else {
+            options.onError?.(result);
+        }
+    };
+    form.addEventListener('submit', handler);
+    return () => form.removeEventListener('submit', handler);
+}
+//# sourceMappingURL=client.js.map

package/dist-cjs/client.js.map

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

package/dist-cjs/helpers.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildActionUrl = buildActionUrl;
+exports.serializeForm = serializeForm;
+function buildActionUrl(params) {
+    const base = params.apiBaseUrl.replace(/\/+$/, '');
+    return `${base}/mailer/${encodeURIComponent(params.pid)}/form/${encodeURIComponent(params.slug)}`;
+}
+function serializeForm(form) {
+    if (typeof FormData === 'undefined') {
+        throw new Error('FormData is not available in this environment');
+    }
+    const formData = new FormData(form);
+    const data = {};
+    for (const [key, value] of formData.entries()) {
+        if (Object.prototype.hasOwnProperty.call(data, key)) {
+            const existing = data[key];
+            if (Array.isArray(existing)) {
+                existing.push(value);
+            }
+            else {
+                data[key] = [existing, value];
+            }
+            continue;
+        }
+        data[key] = value;
+    }
+    return data;
+}
+//# sourceMappingURL=helpers.js.map

package/dist-cjs/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";;AAEA,wCAGC;AAED,sCAsBC;AA3BD,SAAgB,cAAc,CAAC,MAA6D;IAC1F,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAClD,OAAO,GAAG,IAAI,WAAW,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;AACnG,CAAC;AAED,SAAgB,aAAa,CAAC,IAAqB;IACjD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,IAAI,GAAwB,EAAE,CAAA;IAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC/B,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist-cjs/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./client"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,4CAAyB;AACzB,2CAAwB"}

package/dist-cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@linkpane/mailer-post",
+  "version": "0.1.0",
+  "description": "Submission-only SDK for Linkpane Mailer forms",
+  "main": "dist-cjs/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "dist-cjs"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json",
+    "dev": "tsc -p tsconfig.esm.json --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=16"
+  }
+}