@ebitex/forms-sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+import type { SdkForm } from './types.js';
+export interface FormsClientOptions {
+    /**
+     * An organization-scoped API key, created in Hub under Organizations → API Keys.
+     *
+     * **Server-side only.** This key acts for the whole organization and is not scoped to one form.
+     * Anything you ship to a browser is readable by every visitor, so fetch form definitions from
+     * your own server or build step and pass the resulting object to the rendering components — which
+     * never receive the key. That split is why `@ebitex/forms-sdk/react` is a separate entry point.
+     */
+    apiKey: string;
+    /** Defaults to ebitex's production API. Override for a self-hosted or local deployment. */
+    baseUrl?: string;
+    /** Injectable for testing or for a runtime with a non-global fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * A non-2xx response from the Forms API. `status` and `body` are exposed so callers can branch on
+ * the specific failure rather than parsing a message: 401 (bad or revoked key), 402 (the
+ * organization's subscription needs attention), 404 (no such form for this organization), 409 (the
+ * form has two fields sharing a submission key and must be fixed in the Forms editor), 429 (rate
+ * limited — a `Retry-After` header accompanies it).
+ */
+export declare class FormsApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+export interface FormsClient {
+    getForm(externalId: string): Promise<SdkForm>;
+}
+export declare function createFormsClient(options: FormsClientOptions): FormsClient;
+//# 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,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM1C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA4B1E"}

package/dist/client.js

@@ -0,0 +1,50 @@
+/**
+ * A non-2xx response from the Forms API. `status` and `body` are exposed so callers can branch on
+ * the specific failure rather than parsing a message: 401 (bad or revoked key), 402 (the
+ * organization's subscription needs attention), 404 (no such form for this organization), 409 (the
+ * form has two fields sharing a submission key and must be fixed in the Forms editor), 429 (rate
+ * limited — a `Retry-After` header accompanies it).
+ */
+export class FormsApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`ebitex Forms API request failed with status ${status}`);
+        this.name = 'FormsApiError';
+        this.status = status;
+        this.body = body;
+    }
+}
+const DEFAULT_BASE_URL = 'https://api.ebitex.io';
+export function createFormsClient(options) {
+    const { apiKey } = options;
+    if (!apiKey) {
+        throw new Error('createFormsClient requires an apiKey.');
+    }
+    const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+    const doFetch = options.fetch ?? globalThis.fetch;
+    return {
+        async getForm(externalId) {
+            const response = await doFetch(`${baseUrl}/forms/v1/sdk/forms/${encodeURIComponent(externalId)}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    Accept: 'application/json',
+                },
+            });
+            if (!response.ok) {
+                throw new FormsApiError(response.status, await readBody(response));
+            }
+            return (await response.json());
+        },
+    };
+}
+/** Error bodies are JSON in every documented case, but a proxy or gateway can return HTML — don't throw while building an error. */
+async function readBody(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAQ;IACd,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAa;QACvC,KAAK,CAAC,+CAA+C,MAAM,EAAE,CAAC,CAAA;QAC9D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAMD,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AAEhD,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAC1D,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAEjD,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,UAAkB;YAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,GAAG,OAAO,uBAAuB,kBAAkB,CAAC,UAAU,CAAC,EAAE,EACjE;gBACE,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,EAAE;oBACjC,MAAM,EAAE,kBAAkB;iBAC3B;aACF,CACF,CAAA;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;YACpE,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAA;QAC3C,CAAC;KACF,CAAA;AACH,CAAC;AAED,oIAAoI;AACpI,KAAK,UAAU,QAAQ,CAAC,QAAkB;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@ebitex/forms-sdk` — the framework-agnostic half: fetching a form definition and validating a
+ * submission against it. Neither imports React, so a server-only consumer never pulls it in.
+ *
+ * The rendering components live behind a separate entry point, `@ebitex/forms-sdk/react`. That
+ * split is deliberate and load-bearing: `createFormsClient` takes an organization-wide API key and
+ * must only ever run server-side, while the components render in a respondent's browser and must
+ * never receive one. Expressing the boundary in the import graph makes a mistake visible in review.
+ */
+export { createFormsClient, FormsApiError, type FormsClient, type FormsClientOptions, } from './client.js';
+export { validateSubmission, type ValidateOptions } from './validators.js';
+export { collectDataFields, isDataField, isFormField, type ButtonField, type ButtonType, type ChoiceField, type ChoiceOption, type ChoiceType, type FieldsetNode, type FormField, type FormNode, type FormStep, type InputField, type InputVariant, type NumberField, type RowNode, type SdkForm, type SubmissionData, type TextareaField, type ValidationErrors, } from './types.js';
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAE1E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@ebitex/forms-sdk` — the framework-agnostic half: fetching a form definition and validating a
+ * submission against it. Neither imports React, so a server-only consumer never pulls it in.
+ *
+ * The rendering components live behind a separate entry point, `@ebitex/forms-sdk/react`. That
+ * split is deliberate and load-bearing: `createFormsClient` takes an organization-wide API key and
+ * must only ever run server-side, while the components render in a respondent's browser and must
+ * never receive one. Expressing the boundary in the import graph makes a mistake visible in review.
+ */
+export { createFormsClient, FormsApiError, } from './client.js';
+export { validateSubmission } from './validators.js';
+export { collectDataFields, isDataField, isFormField, } from './types.js';
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EACL,iBAAiB,EACjB,aAAa,GAGd,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,kBAAkB,EAAwB,MAAM,iBAAiB,CAAA;AAE1E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,WAAW,GAkBZ,MAAM,YAAY,CAAA"}

package/dist/react/EbitexForm.d.ts

@@ -0,0 +1,36 @@
+import { type CSSProperties } from 'react';
+import { type SdkForm, type SubmissionData } from '../types.js';
+import { type FieldComponents } from './fields.js';
+export interface EbitexFormProps {
+    /** A form definition from `createFormsClient(...).getForm(...)`, fetched on your server. */
+    form: SdkForm;
+    /** Called after a successful final submission. */
+    onSubmitted?: (data: SubmissionData) => void;
+    /** Called when a submission request fails. Validation failures are shown inline and don't call this. */
+    onError?: (error: unknown) => void;
+    className?: string;
+    style?: CSSProperties;
+    /**
+     * Replace the component used for one or more field types. Anything not overridden keeps its
+     * default, so this is a per-field escape hatch rather than an all-or-nothing takeover — override
+     * `Input` alone and your Choice fields still render normally.
+     */
+    fieldComponents?: FieldComponents;
+    /** Injectable for tests and non-standard runtimes. */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Renders an ebitex Form and submits it.
+ *
+ * **This component never sees your API key**, by design. It posts to the form's own
+ * `submissionUrl` — the public, anonymous submission endpoint — exactly as ebitex's own hosted page
+ * and iframe embed do. An organization-wide credential shipped to a respondent's browser would be
+ * readable by every visitor; fetch the definition server-side with `createFormsClient` and pass the
+ * result here.
+ *
+ * Multi-step forms save progress as the respondent advances, so a partially-completed submission
+ * isn't lost — matching the behaviour of ebitex's own renderer rather than a simplified
+ * client-only notion of steps.
+ */
+export declare function EbitexForm({ form, onSubmitted, onError, className, style, fieldComponents, fetch: injectedFetch, }: EbitexFormProps): import("react").JSX.Element | null;
+//# sourceMappingURL=EbitexForm.d.ts.map

package/dist/react/EbitexForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EbitexForm.d.ts","sourceRoot":"","sources":["../../src/react/EbitexForm.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,OAAO,CAAA;AACpE,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAA;AAGpB,MAAM,WAAW,eAAe;IAC9B,4FAA4F;IAC5F,IAAI,EAAE,OAAO,CAAA;IAEb,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IAE5C,wGAAwG;IACxG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAElC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;IAErB;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,WAAW,EACX,OAAO,EACP,SAAS,EACT,KAAK,EACL,eAAe,EACf,KAAK,EAAE,aAAa,GACrB,EAAE,eAAe,sCAoLjB"}

package/dist/react/EbitexForm.js

@@ -0,0 +1,174 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useId, useMemo, useState } from 'react';
+import { collectDataFields, } from '../types.js';
+import { validateSubmission } from '../validators.js';
+import { ChoiceFieldControl, InputFieldControl, NumberFieldControl, TextareaFieldControl, } from './fields.js';
+import { getOrCreateVisitorId } from './visitorId.js';
+/**
+ * Renders an ebitex Form and submits it.
+ *
+ * **This component never sees your API key**, by design. It posts to the form's own
+ * `submissionUrl` — the public, anonymous submission endpoint — exactly as ebitex's own hosted page
+ * and iframe embed do. An organization-wide credential shipped to a respondent's browser would be
+ * readable by every visitor; fetch the definition server-side with `createFormsClient` and pass the
+ * result here.
+ *
+ * Multi-step forms save progress as the respondent advances, so a partially-completed submission
+ * isn't lost — matching the behaviour of ebitex's own renderer rather than a simplified
+ * client-only notion of steps.
+ */
+export function EbitexForm({ form, onSubmitted, onError, className, style, fieldComponents, fetch: injectedFetch, }) {
+    const baseId = useId();
+    const doFetch = injectedFetch ?? globalThis.fetch;
+    const [stepIndex, setStepIndex] = useState(0);
+    const [data, setData] = useState({});
+    const [errors, setErrors] = useState({});
+    const [submitting, setSubmitting] = useState(false);
+    const [completed, setCompleted] = useState(false);
+    const steps = form.steps;
+    const step = steps[stepIndex];
+    const isLastStep = stepIndex === steps.length - 1;
+    const visitorId = useMemo(() => getOrCreateVisitorId(), []);
+    if (completed) {
+        return (_jsx("div", { className: joinClassNames('ebitex-forms', className), style: style, children: _jsx("p", { className: "ebitex-forms__complete", role: "status", children: "Thanks \u2014 your response has been submitted." }) }));
+    }
+    if (!step) {
+        return null;
+    }
+    /**
+     * Validates only the current step's fields. Validating the whole form on a step advance would
+     * report errors for fields the respondent hasn't reached yet.
+     */
+    function validateCurrentStep(requireAll) {
+        const stepKeys = new Set(collectDataFields(step.nodes)
+            .map((field) => field.submissionKey)
+            .filter((key) => key !== undefined));
+        const all = validateSubmission(form, data, { requireAll });
+        return Object.fromEntries(Object.entries(all).filter(([key]) => stepKeys.has(key)));
+    }
+    async function save(complete) {
+        setSubmitting(true);
+        try {
+            const response = await doFetch(form.submissionUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ visitor: visitorId, data, complete }),
+            });
+            if (!response.ok) {
+                // The server is authoritative: a field-level rejection is surfaced inline rather than
+                // thrown, so a respondent can fix it. Anything else is the host app's to handle.
+                const body = (await response.json().catch(() => null));
+                if (body?.error === 'validation_failed' && body.errors) {
+                    setErrors(body.errors);
+                    return false;
+                }
+                onError?.(new Error(`Submission failed with status ${response.status}`));
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            onError?.(error);
+            return false;
+        }
+        finally {
+            setSubmitting(false);
+        }
+    }
+    async function advance() {
+        const stepErrors = validateCurrentStep(true);
+        if (Object.keys(stepErrors).length > 0) {
+            setErrors(stepErrors);
+            return;
+        }
+        setErrors({});
+        // A partial save, so progress survives a respondent leaving mid-form.
+        if (await save(false)) {
+            setStepIndex((current) => current + 1);
+        }
+    }
+    async function submit() {
+        const allErrors = validateSubmission(form, data, { requireAll: true });
+        if (Object.keys(allErrors).length > 0) {
+            setErrors(allErrors);
+            return;
+        }
+        setErrors({});
+        if (await save(true)) {
+            setCompleted(true);
+            onSubmitted?.(data);
+        }
+    }
+    function setValue(key, value) {
+        setData((current) => ({ ...current, [key]: value }));
+    }
+    const disabled = submitting || !form.submittable;
+    return (_jsxs("div", { className: joinClassNames('ebitex-forms', className), style: style, children: [!form.submittable ? (_jsxs("p", { className: "ebitex-forms__notice", role: "status", children: ["This form is ", form.status.toLowerCase(), " and isn't accepting responses yet. It's shown here for preview only."] })) : null, _jsxs("form", { noValidate: true, onSubmit: (event) => {
+                    event.preventDefault();
+                    if (isLastStep) {
+                        void submit();
+                    }
+                    else {
+                        void advance();
+                    }
+                }, children: [steps.length > 1 ? (_jsxs("p", { className: "ebitex-forms__step-indicator", role: "status", children: ["Step ", stepIndex + 1, " of ", steps.length, step.label ? `: ${step.label}` : ''] })) : null, _jsx(NodeList, { nodes: step.nodes, baseId: baseId, data: data, errors: errors, disabled: disabled, fieldComponents: fieldComponents, onChange: setValue }), _jsxs("div", { className: "ebitex-forms__actions", children: [stepIndex > 0 ? (_jsx("button", { type: "button", className: "ebitex-forms__button ebitex-forms__button--secondary", disabled: submitting, 
+                                // Deliberately does not re-save: going back is navigation, not a change.
+                                onClick: () => setStepIndex((current) => current - 1), children: "Back" })) : null, isLastStep ? (_jsx(ActionButtons, { nodes: form.actions, disabled: disabled })) : (_jsx("button", { type: "submit", className: "ebitex-forms__button", disabled: disabled, children: "Next" }))] })] })] }));
+}
+/** The Form's own configured Submit/Reset controls, shown on the final step. */
+function ActionButtons({ nodes, disabled }) {
+    const buttons = nodes.filter((node) => node.nodeType === 'Field' && node.fieldType === 'Button');
+    if (buttons.length === 0) {
+        return (_jsx("button", { type: "submit", className: "ebitex-forms__button", disabled: disabled, children: "Submit" }));
+    }
+    return (_jsx(_Fragment, { children: buttons.map((button, index) => (_jsx("button", { type: button.buttonType === 'Reset' ? 'reset' : button.buttonType === 'Button' ? 'button' : 'submit', className: joinClassNames('ebitex-forms__button', button.buttonType !== 'Submit' ? 'ebitex-forms__button--secondary' : undefined), disabled: disabled, children: button.label }, `${button.label}-${index}`))) }));
+}
+function NodeList({ nodes, baseId, data, errors, disabled, fieldComponents, onChange, }) {
+    return (_jsx(_Fragment, { children: nodes.map((node, index) => {
+            if (node.nodeType === 'Fieldset') {
+                return (_jsxs("fieldset", { className: "ebitex-forms__fieldset", children: [_jsx("legend", { children: node.legend }), _jsx(NodeList, { nodes: node.nodes, baseId: baseId, data: data, errors: errors, disabled: disabled, fieldComponents: fieldComponents, onChange: onChange })] }, `fieldset-${index}`));
+            }
+            if (node.nodeType === 'Row') {
+                // Horizontal on wide viewports, single column on narrow — see styles.css.
+                return (_jsx("div", { className: "ebitex-forms__row", children: _jsx(NodeList, { nodes: node.nodes, baseId: baseId, data: data, errors: errors, disabled: disabled, fieldComponents: fieldComponents, onChange: onChange }) }, `row-${index}`));
+            }
+            if (node.fieldType === 'Button') {
+                // Buttons inside a step's tree are the Form's own Actions, rendered by ActionButtons.
+                return null;
+            }
+            const key = node.submissionKey;
+            if (key === undefined)
+                return null;
+            const id = `${baseId}-${key}`;
+            const error = errors[key] ?? null;
+            const shared = {
+                id,
+                value: data[key] ?? null,
+                error,
+                disabled,
+                onChange: (value) => onChange(key, value),
+            };
+            switch (node.fieldType) {
+                case 'Input': {
+                    const Component = fieldComponents?.Input ?? InputFieldControl;
+                    return _jsx(Component, { field: node, ...shared }, key);
+                }
+                case 'Textarea': {
+                    const Component = fieldComponents?.Textarea ?? TextareaFieldControl;
+                    return _jsx(Component, { field: node, ...shared }, key);
+                }
+                case 'Number': {
+                    const Component = fieldComponents?.Number ?? NumberFieldControl;
+                    return _jsx(Component, { field: node, ...shared }, key);
+                }
+                case 'Choice': {
+                    const Component = fieldComponents?.Choice ?? ChoiceFieldControl;
+                    return _jsx(Component, { field: node, ...shared }, key);
+                }
+            }
+        }) }));
+}
+function joinClassNames(...values) {
+    return values.filter(Boolean).join(' ');
+}
+//# sourceMappingURL=EbitexForm.js.map

package/dist/react/EbitexForm.js.map

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

package/dist/react/fields.d.ts

@@ -0,0 +1,26 @@
+import type { ChoiceField, InputField, NumberField, SubmissionData, TextareaField } from '../types.js';
+/**
+ * What every field component receives. A consumer overriding one via `fieldComponents` implements
+ * this same contract, so an override is a drop-in rather than a fork of the surrounding form.
+ */
+export interface FieldComponentProps<TField> {
+    field: TField;
+    /** Stable, unique per field — wire this to both the control's `id` and its label's `htmlFor`. */
+    id: string;
+    value: SubmissionData[string];
+    onChange: (value: SubmissionData[string]) => void;
+    /** A validation message for this field, or `null`. Render it and reference it via `aria-describedby`. */
+    error: string | null;
+    disabled: boolean;
+}
+export interface FieldComponents {
+    Input?: React.ComponentType<FieldComponentProps<InputField>>;
+    Textarea?: React.ComponentType<FieldComponentProps<TextareaField>>;
+    Number?: React.ComponentType<FieldComponentProps<NumberField>>;
+    Choice?: React.ComponentType<FieldComponentProps<ChoiceField>>;
+}
+export declare function InputFieldControl({ field, id, value, onChange, error, disabled }: FieldComponentProps<InputField>): import("react").JSX.Element;
+export declare function TextareaFieldControl({ field, id, value, onChange, error, disabled }: FieldComponentProps<TextareaField>): import("react").JSX.Element;
+export declare function NumberFieldControl({ field, id, value, onChange, error, disabled }: FieldComponentProps<NumberField>): import("react").JSX.Element;
+export declare function ChoiceFieldControl({ field, id, value, onChange, error, disabled }: FieldComponentProps<ChoiceField>): import("react").JSX.Element;
+//# sourceMappingURL=fields.d.ts.map

package/dist/react/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/react/fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAA;AAEpB;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IACjD,yGAAyG;IACzG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5D,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAA;IAClE,MAAM,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAA;IAC9D,MAAM,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAA;CAC/D;AAuCD,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,UAAU,CAAC,+BAsBjH;AAED,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,aAAa,CAAC,+BAsBvH;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,WAAW,CAAC,+BA2BnH;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,WAAW,CAAC,+BAsFnH"}

package/dist/react/fields.js

@@ -0,0 +1,57 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+const INPUT_TYPES = {
+    Text: 'text',
+    Email: 'email',
+    Tel: 'tel',
+    Url: 'url',
+    Password: 'password',
+};
+/**
+ * A real `<label for>` rather than a placeholder or an aria-label: a placeholder disappears on
+ * focus and is not reliably announced, and this is the one surface an organization's own customers
+ * use directly.
+ */
+function Label({ id, children, required }) {
+    return (_jsxs("label", { className: "ebitex-forms__label", htmlFor: id, children: [children, required ? (_jsxs("span", { className: "ebitex-forms__required", "aria-hidden": "true", children: [' ', "*"] })) : null] }));
+}
+function ErrorMessage({ id, error }) {
+    if (error === null)
+        return null;
+    return (_jsx("p", { className: "ebitex-forms__error", id: `${id}-error`, children: error }));
+}
+export function InputFieldControl({ field, id, value, onChange, error, disabled }) {
+    return (_jsxs("div", { className: "ebitex-forms__field", children: [_jsx(Label, { id: id, required: field.required, children: field.label }), _jsx("input", { className: "ebitex-forms__control", id: id, type: INPUT_TYPES[field.variant], value: typeof value === 'string' ? value : '', placeholder: field.placeholder ?? undefined, required: field.required, "aria-required": field.required, "aria-invalid": error !== null, "aria-describedby": error !== null ? `${id}-error` : undefined, disabled: disabled, onChange: (event) => onChange(event.target.value) }), _jsx(ErrorMessage, { id: id, error: error })] }));
+}
+export function TextareaFieldControl({ field, id, value, onChange, error, disabled }) {
+    return (_jsxs("div", { className: "ebitex-forms__field", children: [_jsx(Label, { id: id, required: field.required, children: field.label }), _jsx("textarea", { className: "ebitex-forms__control", id: id, rows: field.rows ?? 4, value: typeof value === 'string' ? value : '', placeholder: field.placeholder ?? undefined, required: field.required, "aria-required": field.required, "aria-invalid": error !== null, "aria-describedby": error !== null ? `${id}-error` : undefined, disabled: disabled, onChange: (event) => onChange(event.target.value) }), _jsx(ErrorMessage, { id: id, error: error })] }));
+}
+export function NumberFieldControl({ field, id, value, onChange, error, disabled }) {
+    return (_jsxs("div", { className: "ebitex-forms__field", children: [_jsx(Label, { id: id, required: field.required, children: field.label }), _jsx("input", { className: "ebitex-forms__control", id: id, type: "number", value: value === null || value === undefined ? '' : String(value), placeholder: field.placeholder ?? undefined, min: field.min ?? undefined, max: field.max ?? undefined, step: field.step ?? undefined, required: field.required, "aria-required": field.required, "aria-invalid": error !== null, "aria-describedby": error !== null ? `${id}-error` : undefined, disabled: disabled, 
+                // Kept as a string rather than coerced here: the server accepts a numeric string, and
+                // coercing would turn a half-typed "-" or "1." into NaN mid-keystroke.
+                onChange: (event) => onChange(event.target.value) }), _jsx(ErrorMessage, { id: id, error: error })] }));
+}
+export function ChoiceFieldControl({ field, id, value, onChange, error, disabled }) {
+    const describedBy = error !== null ? `${id}-error` : undefined;
+    if (field.choiceType === 'Select') {
+        return (_jsxs("div", { className: "ebitex-forms__field", children: [_jsx(Label, { id: id, required: field.required, children: field.label }), _jsxs("select", { className: "ebitex-forms__control", id: id, value: typeof value === 'string' ? value : '', required: field.required, "aria-required": field.required, "aria-invalid": error !== null, "aria-describedby": describedBy, disabled: disabled, onChange: (event) => onChange(event.target.value), children: [_jsx("option", { value: "", children: "Select\u2026" }), field.options.map((option) => (_jsx("option", { value: option.value, children: option.label }, option.value)))] }), _jsx(ErrorMessage, { id: id, error: error })] }));
+    }
+    const selected = Array.isArray(value) ? value : typeof value === 'string' && value !== '' ? [value] : [];
+    // A radio/checkbox group is a group of controls, not one labelled control — so the visible label
+    // becomes a <legend> inside a <fieldset>, which is what actually associates it with every option
+    // for a screen reader.
+    return (_jsxs("fieldset", { className: "ebitex-forms__field ebitex-forms__group", "aria-required": field.required, "aria-invalid": error !== null, "aria-describedby": describedBy, disabled: disabled, children: [_jsxs("legend", { className: "ebitex-forms__label", children: [field.label, field.required ? (_jsxs("span", { className: "ebitex-forms__required", "aria-hidden": "true", children: [' ', "*"] })) : null] }), field.options.map((option) => {
+                const optionId = `${id}-${option.value}`;
+                const isCheckbox = field.choiceType === 'Checkbox';
+                return (_jsxs("div", { className: "ebitex-forms__option", children: [_jsx("input", { id: optionId, type: isCheckbox ? 'checkbox' : 'radio', name: id, value: option.value, checked: selected.includes(option.value), onChange: (event) => {
+                                if (!isCheckbox) {
+                                    onChange(option.value);
+                                    return;
+                                }
+                                onChange(event.target.checked
+                                    ? [...selected, option.value]
+                                    : selected.filter((item) => item !== option.value));
+                            } }), _jsx("label", { htmlFor: optionId, children: option.label })] }, option.value));
+            }), _jsx(ErrorMessage, { id: id, error: error })] }));
+}
+//# sourceMappingURL=fields.js.map

package/dist/react/fields.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@ebitex/forms-sdk/react` — the rendering half.
+ *
+ * Nothing here takes an API key, deliberately: these components run in a respondent's browser and
+ * submit to the form's own public, anonymous endpoint. Fetch the definition server-side with
+ * `createFormsClient` from the root entry point and pass the result to `<EbitexForm />`.
+ */
+export { EbitexForm, type EbitexFormProps } from './EbitexForm.js';
+export { ChoiceFieldControl, InputFieldControl, NumberFieldControl, TextareaFieldControl, type FieldComponentProps, type FieldComponents, } from './fields.js';
+export { getOrCreateVisitorId } from './visitorId.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/react/index.js

@@ -0,0 +1,11 @@
+/**
+ * `@ebitex/forms-sdk/react` — the rendering half.
+ *
+ * Nothing here takes an API key, deliberately: these components run in a respondent's browser and
+ * submit to the form's own public, anonymous endpoint. Fetch the definition server-side with
+ * `createFormsClient` from the root entry point and pass the result to `<EbitexForm />`.
+ */
+export { EbitexForm } from './EbitexForm.js';
+export { ChoiceFieldControl, InputFieldControl, NumberFieldControl, TextareaFieldControl, } from './fields.js';
+export { getOrCreateVisitorId } from './visitorId.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAA;AAElE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/react/styles.css

@@ -0,0 +1,180 @@
+/*
+ * Optional default styling for @ebitex/forms-sdk's React components.
+ *
+ * Import it (`import '@ebitex/forms-sdk/styles.css'`) for a usable form out of the box, or skip it
+ * entirely and target the `.ebitex-forms__*` class names with your own CSS. Every value below is a
+ * custom property, so the common case — matching your own design system — needs neither a fork nor
+ * a build step:
+ *
+ *   .ebitex-forms {
+ *     --ebitex-forms-accent: #7c3aed;
+ *     --ebitex-forms-radius: 0;
+ *   }
+ *
+ * Deliberately unopinionated: no font stack (inherits yours), no imposed max-width, no colour
+ * scheme beyond what the tokens set. A form embedded in someone else's page should look like it
+ * belongs there, and the most common complaint about an embeddable widget is that it doesn't.
+ */
+
+.ebitex-forms {
+  --ebitex-forms-accent: #2563eb;
+  --ebitex-forms-accent-contrast: #ffffff;
+  --ebitex-forms-text: #111827;
+  --ebitex-forms-muted: #6b7280;
+  --ebitex-forms-border: #d1d5db;
+  --ebitex-forms-error: #dc2626;
+  --ebitex-forms-surface: transparent;
+  --ebitex-forms-radius: 0.375rem;
+  --ebitex-forms-gap: 1rem;
+
+  color: var(--ebitex-forms-text);
+  background: var(--ebitex-forms-surface);
+  display: flex;
+  flex-direction: column;
+  gap: var(--ebitex-forms-gap);
+}
+
+/* Follows the host page when it hasn't set an explicit theme, rather than forcing light. */
+@media (prefers-color-scheme: dark) {
+  .ebitex-forms:not([data-ebitex-theme='light']) {
+    --ebitex-forms-text: #f3f4f6;
+    --ebitex-forms-muted: #9ca3af;
+    --ebitex-forms-border: #4b5563;
+    --ebitex-forms-error: #f87171;
+  }
+}
+
+.ebitex-forms form {
+  display: flex;
+  flex-direction: column;
+  gap: var(--ebitex-forms-gap);
+}
+
+.ebitex-forms__field {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+  min-width: 0;
+}
+
+.ebitex-forms__label {
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+
+.ebitex-forms__required {
+  color: var(--ebitex-forms-error);
+}
+
+.ebitex-forms__control {
+  font: inherit;
+  color: inherit;
+  background: transparent;
+  border: 1px solid var(--ebitex-forms-border);
+  border-radius: var(--ebitex-forms-radius);
+  padding: 0.5rem 0.625rem;
+  width: 100%;
+  box-sizing: border-box;
+}
+
+.ebitex-forms__control:focus-visible {
+  outline: 2px solid var(--ebitex-forms-accent);
+  outline-offset: 1px;
+}
+
+.ebitex-forms__control[aria-invalid='true'] {
+  border-color: var(--ebitex-forms-error);
+}
+
+/* Without this a disabled control is indistinguishable from an editable one in most browsers'
+   default styling — which matters here because the whole point of the non-submittable preview
+   state is that it should be visibly not-fillable. Caught by looking at a rendered Draft form,
+   not by a test: every disabled assertion passed while the form still looked interactive. */
+.ebitex-forms__control:disabled,
+.ebitex-forms__group:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  background: color-mix(in srgb, var(--ebitex-forms-border) 20%, transparent);
+}
+
+.ebitex-forms__error {
+  color: var(--ebitex-forms-error);
+  font-size: 0.8125rem;
+  margin: 0;
+}
+
+.ebitex-forms__notice,
+.ebitex-forms__step-indicator {
+  color: var(--ebitex-forms-muted);
+  font-size: 0.875rem;
+  margin: 0;
+}
+
+.ebitex-forms__complete {
+  font-size: 0.9375rem;
+  margin: 0;
+}
+
+.ebitex-forms__fieldset,
+.ebitex-forms__group {
+  border: 1px solid var(--ebitex-forms-border);
+  border-radius: var(--ebitex-forms-radius);
+  padding: 0.875rem;
+  margin: 0;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.ebitex-forms__group {
+  border: 0;
+  padding: 0;
+}
+
+.ebitex-forms__option {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  font-size: 0.9375rem;
+}
+
+/* Horizontal, collapsing to one column on narrow viewports — matching how Row renders in the
+   ebitex builder and on the hosted page. */
+.ebitex-forms__row {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(12rem, 1fr));
+  gap: var(--ebitex-forms-gap);
+}
+
+.ebitex-forms__actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+
+.ebitex-forms__button {
+  font: inherit;
+  cursor: pointer;
+  border: 1px solid var(--ebitex-forms-accent);
+  border-radius: var(--ebitex-forms-radius);
+  background: var(--ebitex-forms-accent);
+  color: var(--ebitex-forms-accent-contrast);
+  padding: 0.5rem 1rem;
+}
+
+.ebitex-forms__button--secondary {
+  background: transparent;
+  color: inherit;
+  border-color: var(--ebitex-forms-border);
+}
+
+.ebitex-forms__button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+.ebitex-forms__button:focus-visible {
+  outline: 2px solid var(--ebitex-forms-accent);
+  outline-offset: 2px;
+}

package/dist/react/visitorId.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The persistent visitor id the public submission endpoint uses to reconcile a respondent's
+ * progress across steps.
+ *
+ * Deliberately a small reimplementation of `forms-web`'s own `lib/visitorId.ts` rather than a
+ * shared import: this package must have zero dependency on ebitex's internal workspace packages —
+ * its consumers are arbitrary external apps with their own bundlers and design systems — so a
+ * shared module would have to become a second published package to serve one caller.
+ *
+ * Note the id is scoped to *your* site's origin, not ebitex's, because nothing here loads in an
+ * iframe. A respondent who fills the same form on two different sites is therefore two visitors.
+ *
+ * Never throws. Storage access can fail outright under some privacy settings, and a form that
+ * refuses to render because it couldn't save an id would be a far worse outcome than one that
+ * simply can't reconcile progress.
+ */
+export declare function getOrCreateVisitorId(): string;
+/** Test seam — resets the in-memory fallback between cases. */
+export declare function resetVisitorIdFallbackForTests(): void;
+//# sourceMappingURL=visitorId.d.ts.map

package/dist/react/visitorId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitorId.d.ts","sourceRoot":"","sources":["../../src/react/visitorId.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAY7C;AAED,+DAA+D;AAC/D,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/react/visitorId.js

@@ -0,0 +1,42 @@
+const STORAGE_KEY = 'ebitex.visitor-id';
+/**
+ * Held for the life of the page when storage is unavailable, so a respondent in a privacy-mode
+ * browser still gets consistent behaviour *within* one visit (a multi-step form keeps accumulating
+ * into one submission) even though nothing persists across visits.
+ */
+let inMemoryFallback = null;
+/**
+ * The persistent visitor id the public submission endpoint uses to reconcile a respondent's
+ * progress across steps.
+ *
+ * Deliberately a small reimplementation of `forms-web`'s own `lib/visitorId.ts` rather than a
+ * shared import: this package must have zero dependency on ebitex's internal workspace packages —
+ * its consumers are arbitrary external apps with their own bundlers and design systems — so a
+ * shared module would have to become a second published package to serve one caller.
+ *
+ * Note the id is scoped to *your* site's origin, not ebitex's, because nothing here loads in an
+ * iframe. A respondent who fills the same form on two different sites is therefore two visitors.
+ *
+ * Never throws. Storage access can fail outright under some privacy settings, and a form that
+ * refuses to render because it couldn't save an id would be a far worse outcome than one that
+ * simply can't reconcile progress.
+ */
+export function getOrCreateVisitorId() {
+    try {
+        const existing = window.localStorage.getItem(STORAGE_KEY);
+        if (existing)
+            return existing;
+        const created = crypto.randomUUID();
+        window.localStorage.setItem(STORAGE_KEY, created);
+        return created;
+    }
+    catch {
+        inMemoryFallback ??= crypto.randomUUID();
+        return inMemoryFallback;
+    }
+}
+/** Test seam — resets the in-memory fallback between cases. */
+export function resetVisitorIdFallbackForTests() {
+    inMemoryFallback = null;
+}
+//# sourceMappingURL=visitorId.js.map

package/dist/react/visitorId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitorId.js","sourceRoot":"","sources":["../../src/react/visitorId.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,mBAAmB,CAAA;AAEvC;;;;GAIG;AACH,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACzD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAE7B,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QACnC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,OAAO,CAAA;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB,KAAK,MAAM,CAAC,UAAU,EAAE,CAAA;QACxC,OAAO,gBAAgB,CAAA;IACzB,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,8BAA8B;IAC5C,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The wire shape of `GET /forms/v1/sdk/forms/{externalId}`.
+ *
+ * Transcribed from the endpoint's actual response, not from a spec document — the server serializes
+ * its resolved node tree through the same converter its persistence layer uses, so these types
+ * describe what genuinely arrives rather than what was intended to.
+ */
+export type InputVariant = 'Text' | 'Email' | 'Tel' | 'Url' | 'Password';
+export type ChoiceType = 'Select' | 'Radio' | 'Checkbox';
+export type ButtonType = 'Submit' | 'Reset' | 'Button';
+export interface ChoiceOption {
+    value: string;
+    label: string;
+}
+interface FieldBase {
+    nodeType: 'Field';
+    label: string;
+    /**
+     * The key this field's answer is submitted under. Absent on buttons, which carry no value.
+     *
+     * Deliberately **not** the same as `name`: a field placed by reference to a shared Field is keyed
+     * by that Field's external id instead. Always submit under this value — deriving a key any other
+     * way silently breaks plugin field mapping on the server.
+     */
+    submissionKey?: string;
+}
+export interface InputField extends FieldBase {
+    fieldType: 'Input';
+    name: string;
+    required: boolean;
+    variant: InputVariant;
+    placeholder?: string | null;
+}
+export interface TextareaField extends FieldBase {
+    fieldType: 'Textarea';
+    name: string;
+    required: boolean;
+    placeholder?: string | null;
+    rows?: number | null;
+}
+export interface NumberField extends FieldBase {
+    fieldType: 'Number';
+    name: string;
+    required: boolean;
+    placeholder?: string | null;
+    min?: number | null;
+    max?: number | null;
+    step?: number | null;
+}
+export interface ChoiceField extends FieldBase {
+    fieldType: 'Choice';
+    name: string;
+    required: boolean;
+    choiceType: ChoiceType;
+    /** Always a plain array — the server resolves data-set- and plugin-backed options before sending. */
+    options: ChoiceOption[];
+}
+export interface ButtonField extends FieldBase {
+    fieldType: 'Button';
+    buttonType: ButtonType;
+}
+export type FormField = InputField | TextareaField | NumberField | ChoiceField | ButtonField;
+export interface FieldsetNode {
+    nodeType: 'Fieldset';
+    legend: string;
+    nodes: FormNode[];
+}
+export interface RowNode {
+    nodeType: 'Row';
+    nodes: FormNode[];
+}
+export type FormNode = FieldsetNode | RowNode | FormField;
+export interface FormStep {
+    label: string;
+    nodes: FormNode[];
+}
+export interface SdkForm {
+    name: string;
+    externalId: string;
+    orgSlug: string;
+    /** Absolute URL of the public submission endpoint. Never send the API key here. */
+    submissionUrl: string;
+    status: 'Draft' | 'Active' | 'Archived';
+    /**
+     * Whether submissions will be accepted. `false` for a Draft or Archived form: the definition is
+     * retrievable so you can build against it before publishing, but the public submission endpoint
+     * gates on Active and would reject every submission.
+     */
+    submittable: boolean;
+    actions: FormNode[];
+    steps: FormStep[];
+}
+/** A respondent's answers, keyed by each field's `submissionKey`. */
+export type SubmissionData = Record<string, string | string[] | number | null>;
+/** Field-level validation messages, keyed by `submissionKey`. Empty means valid. */
+export type ValidationErrors = Record<string, string>;
+export declare function isFormField(node: FormNode): node is FormField;
+/** Buttons are the one field shape carrying no answer, so they're excluded from data and validation. */
+export declare function isDataField(node: FormNode): node is InputField | TextareaField | NumberField | ChoiceField;
+/** Depth-first walk of a node tree, flattened to the data-carrying fields only. */
+export declare function collectDataFields(nodes: FormNode[]): (InputField | TextareaField | NumberField | ChoiceField)[];
+export {};
+//# 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;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAA;AAExE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,SAAS;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,YAAY,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,SAAS,EAAE,UAAU,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,SAAS,EAAE,QAAQ,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,SAAS,EAAE,QAAQ,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;IACtB,qGAAqG;IACrG,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,SAAS,EAAE,QAAQ,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAA;AAE5F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,UAAU,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,KAAK,CAAA;IACf,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAA;AAEzD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IACvC;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;AAE9E,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,SAAS,CAE7D;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,GACb,IAAI,IAAI,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAEhE;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EAAE,GAChB,CAAC,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC,EAAE,CAY5D"}

package/dist/types.js

@@ -0,0 +1,28 @@
+/**
+ * The wire shape of `GET /forms/v1/sdk/forms/{externalId}`.
+ *
+ * Transcribed from the endpoint's actual response, not from a spec document — the server serializes
+ * its resolved node tree through the same converter its persistence layer uses, so these types
+ * describe what genuinely arrives rather than what was intended to.
+ */
+export function isFormField(node) {
+    return node.nodeType === 'Field';
+}
+/** Buttons are the one field shape carrying no answer, so they're excluded from data and validation. */
+export function isDataField(node) {
+    return isFormField(node) && node.fieldType !== 'Button';
+}
+/** Depth-first walk of a node tree, flattened to the data-carrying fields only. */
+export function collectDataFields(nodes) {
+    const result = [];
+    for (const node of nodes) {
+        if (node.nodeType === 'Fieldset' || node.nodeType === 'Row') {
+            result.push(...collectDataFields(node.nodes));
+        }
+        else if (isDataField(node)) {
+            result.push(node);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6GH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAA;AAClC,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,WAAW,CACzB,IAAc;IAEd,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAA;AACzD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAC/B,KAAiB;IAEjB,MAAM,MAAM,GAA+D,EAAE,CAAA;IAE7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAC/C,CAAC;aAAM,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/validators.d.ts

@@ -0,0 +1,25 @@
+import { type SdkForm, type SubmissionData, type ValidationErrors } from './types.js';
+export interface ValidateOptions {
+    /**
+     * `true` when finalizing a submission — every required field must be present and non-empty.
+     * `false` for an intermediate step save, which legitimately omits fields on later steps; only the
+     * shape of what *is* present gets checked.
+     */
+    requireAll: boolean;
+}
+/**
+ * A client-side port of the server's own `SubmissionDataValidator`, for immediate feedback before a
+ * step advances or a form submits.
+ *
+ * **The server remains authoritative.** These rules exist so a respondent sees a mistake without a
+ * round trip, not to be trusted — a client bypass still gets a real 400. They are kept deliberately
+ * identical to the server's, down to the message strings, and a shared fixture file
+ * (`src/test/fixtures/validation-cases.json`) is run through both implementations so a divergence
+ * fails a test rather than surfacing as "the SDK said this was valid and the API disagreed".
+ *
+ * Like the server's, this is a *basic* shape check by design — no email regex on an Email-variant
+ * input, for instance. It enforces the constraints a field definition actually declares, not
+ * stricter invented formats. Native browser validation still applies on top.
+ */
+export declare function validateSubmission(form: SdkForm, data: SubmissionData, options: ValidateOptions): ValidationErrors;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAExG,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAoClB"}

package/dist/validators.js

@@ -0,0 +1,98 @@
+import { collectDataFields } from './types.js';
+/**
+ * A client-side port of the server's own `SubmissionDataValidator`, for immediate feedback before a
+ * step advances or a form submits.
+ *
+ * **The server remains authoritative.** These rules exist so a respondent sees a mistake without a
+ * round trip, not to be trusted — a client bypass still gets a real 400. They are kept deliberately
+ * identical to the server's, down to the message strings, and a shared fixture file
+ * (`src/test/fixtures/validation-cases.json`) is run through both implementations so a divergence
+ * fails a test rather than surfacing as "the SDK said this was valid and the API disagreed".
+ *
+ * Like the server's, this is a *basic* shape check by design — no email regex on an Email-variant
+ * input, for instance. It enforces the constraints a field definition actually declares, not
+ * stricter invented formats. Native browser validation still applies on top.
+ */
+export function validateSubmission(form, data, options) {
+    const errors = {};
+    const fields = new Map(collectDataFields(form.steps.flatMap((step) => step.nodes))
+        .filter((field) => field.submissionKey !== undefined)
+        .map((field) => [field.submissionKey, field]));
+    // Unknown keys are errors, not ignored input — matching the server, which rejects them so
+    // arbitrary caller-supplied keys never accumulate in a column staff will later read.
+    for (const key of Object.keys(data)) {
+        if (!fields.has(key)) {
+            errors[key] = 'Unknown field.';
+        }
+    }
+    for (const [key, field] of fields) {
+        const value = data[key];
+        const present = value !== undefined && value !== null;
+        if (!present || isEmptyString(value)) {
+            if (options.requireAll && field.required) {
+                errors[key] = 'This field is required.';
+            }
+            continue;
+        }
+        const shapeError = validateShape(field, value);
+        if (shapeError !== null) {
+            errors[key] = shapeError;
+        }
+    }
+    return errors;
+}
+function isEmptyString(value) {
+    return typeof value === 'string' && value.trim() === '';
+}
+function validateShape(field, value) {
+    switch (field.fieldType) {
+        case 'Number':
+            return validateNumber(field.min ?? null, field.max ?? null, value);
+        case 'Choice':
+            return validateChoice(field.options.map((option) => option.value), value);
+        case 'Input':
+        case 'Textarea':
+            return typeof value === 'string' ? null : 'Value must be text.';
+        default:
+            return null;
+    }
+}
+function validateNumber(min, max, value) {
+    let parsed;
+    if (typeof value === 'number') {
+        parsed = value;
+    }
+    else if (typeof value === 'string' && value.trim() !== '' && Number.isFinite(Number(value))) {
+        // A browser number input yields a string, so a numeric string is accepted rather than rejected
+        // on a technicality — same allowance the server makes.
+        parsed = Number(value);
+    }
+    else {
+        return 'Value must be a number.';
+    }
+    if (min !== null && parsed < min) {
+        return `Value must be ${min} or greater.`;
+    }
+    if (max !== null && parsed > max) {
+        return `Value must be ${max} or less.`;
+    }
+    return null;
+}
+function validateChoice(allowed, value) {
+    const permitted = new Set(allowed);
+    // A Checkbox choice submits several values; Select/Radio submit one. An array is accepted for any
+    // choice type, keeping this about membership rather than arity — which the model doesn't constrain.
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (typeof item !== 'string' || !permitted.has(item)) {
+                return 'Value is not one of the allowed options.';
+            }
+        }
+        return null;
+    }
+    if (typeof value !== 'string' || !permitted.has(value)) {
+        return 'Value is not one of the allowed options.';
+    }
+    return null;
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@ebitex/forms-sdk",
+  "version": "0.1.0",
+  "description": "Fetch and render ebitex Forms in your own application.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./styles.css": "./dist/react/styles.css"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "lint": "oxlint",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-dom": ">=19"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^7.0.0",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.3",
+    "jsdom": "^29.1.1",
+    "oxlint": "^1.71.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "~6.0.2",
+    "vitest": "^4.1.10"
+  }
+}