@owlmeans/common-inquiry 0.0.0-stage → 0.1.18-rc.1

package/README.md

@@ -1,3 +1,74 @@
-# Temporary Holding Version
+# @owlmeans/common-inquiry
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The runtime-free contract of the OwlMeans customer inquiry widget: a visitor opens a dialog from a
+host page, picks an intent (a tab), leaves contact details, a message and up to five attachments,
+and a CRM service mails it on. Three parties share this package — the browser SDK
+(`@owlmeans/web-inquiry`), the widget bundle that renders the dialog, and the CRM API that accepts
+the submission — so the names, limits and shapes they agree on live in one place.
+
+No React, no DOM, no runtime dependencies: constants, types, JSON schemas and one pure helper.
+
+## Installation
+
+```bash
+bun add @owlmeans/common-inquiry@^0.1.18-rc.1
+```
+
+`ajv` is an optional peer: the schemas are typed with its `JSONSchemaType`, and a server that
+compiles them brings its own.
+
+## Concepts
+
+- **Widget config** (`InquiryWidgetConfig`): an id, one or more tabs (`alias`, localized `title`
+  and `description`), an optional `defaultTab`, the terms and privacy links the inquirer consents
+  to, and an optional language. A config with ONE tab renders without a tab strip.
+- **Runtime** (`InquiryRuntime`): what the widget bundle `inquiry.js` installs at
+  `window.__owlmeansInquiry` — `version`, `configure`, `open`, `button`, `unmount`. Hosts reach it
+  through `@owlmeans/web-inquiry`, which checks `version` against `INQUIRY_RUNTIME_VERSION`.
+- **Submission** (`InquirySubmission`): one multipart POST to `<crm>/api/inquiry` — text fields,
+  `files` as a JSON string of `InquiryFileMeta[]`, and the bytes in `file0` … `file4`.
+- **Limits**: 5 000 000 bytes per file, 20 000 000 in total, five files; PNG, JPEG, GIF, WEBP,
+  PDF, CSV and plain text only (never SVG).
+
+## Usage
+
+```ts
+import { inquiryConfigHelper, type InquiryWidgetConfig } from '@owlmeans/common-inquiry'
+
+const config: InquiryWidgetConfig = {
+  id: 'owlmeans-quote',
+  tabs: [{ alias: 'quote', title: { en: 'Get a quote', pl: 'Poproś o wycenę' } }],
+  legal: { terms: 'https://owlmeans.com/legal/terms', privacy: 'https://owlmeans.com/legal/privacy' },
+}
+
+inquiryConfigHelper.validate(config)               // [] — or English sentences, one per problem
+inquiryConfigHelper.tabOf(config, 'quote')         // the tab, else the default, else the first
+inquiryConfigHelper.text(config.tabs[0].title, 'pl-PL')   // 'Poproś o wycenę'
+inquiryConfigHelper.normalizeLanguage('uk-UA')     // 'uk' — or 'en' when unsupported
+```
+
+A CRM route validates the multipart body with `InquirySubmissionSchema` (ajv with
+`removeAdditional` and `coerceTypes`), then parses `files` and validates it with
+`InquiryFileMetaListSchema`. The file fields are declared as open objects on purpose: any stricter
+keyword makes ajv walk the Buffer's bytes.
+
+## Related
+
+- [`@owlmeans/web-inquiry`](../web-inquiry): the browser SDK that loads the widget and reports opens
+- [`@owlmeans/web-log`](../web-log): the consent-gated tag-manager plugin the open event reaches
+
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded agent skills under `agent-meta/`. After installing your
+`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
+your project's skill store (`.agents/skills/`):
+
+```sh
+npx @owlmeans/agent-skills@^0.1.18-rc.53
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/agent-meta/manifest.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 2,
+  "package": "@owlmeans/common-inquiry",
+  "version": "0.1.18-rc.1",
+  "generatedAt": "2026-10-09T11:30:42.759Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "common-inquiry",
+      "category": "package-specific",
+      "file": "skills/common-inquiry/SKILL.md",
+      "canonicalPath": ".agents/skills/common-inquiry/SKILL.md"
+    }
+  ]
+}

package/agent-meta/skills/common-inquiry/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: common-inquiry
+description: How to use @owlmeans/common-inquiry — the runtime-free contract of the OwlMeans customer inquiry widget (a contact dialog a host page opens, mailed on by a CRM service). Covers the widget config and its tabs, the window runtime contract (INQUIRY_GLOBAL, INQUIRY_RUNTIME_VERSION, configure/open/button/unmount, one onOpen per open), the multipart submission and its file fields, the size/type/text limits, the JSON schemas and inquiryConfigHelper (text, validate, tabOf, normalizeLanguage). Auto-invoked when building the widget bundle, a CRM inquiry route, or a host's widget config, or when importing any INQUIRY_* constant, Inquiry* type or schema. Not the agent's ask-a-person inquiry (that is the `inquiry` skill).
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/common-inquiry
+
+**Layer:** Cross-cutting domain (no `@owlmeans/*` dependencies; optional `ajv` peer for schema types)
+**Install:** `"@owlmeans/common-inquiry": "^0.1.18-rc.1"` in `dependencies`
+
+The one place the three parties of the inquiry widget agree: the browser SDK
+(`@owlmeans/web-inquiry`), the widget bundle that renders the dialog, and the CRM API that accepts
+the submission. Constants, types, JSON schemas and one pure helper — no React, no DOM, nothing that
+runs on import.
+
+## Addresses
+
+A CRM is addressed by its base URL (`https://<web host>/crm`, no trailing slash):
+
+| Constant | Value | Full address |
+|---|---|---|
+| `INQUIRY_SCRIPT` | `inquiry.js` | `<crm>/inquiry.js?v=<INQUIRY_RUNTIME_VERSION>` — the widget bundle |
+| `INQUIRY_API_SEGMENT` | `api` | `<crm>/api` — the CRM API |
+| `INQUIRY_CONFIG_PATH` | `/assets/config.json` | `<crm>/api/assets/config.json` — the advertised config (reCAPTCHA site key) |
+| `INQUIRY_SUBMIT_PATH` | `/inquiry` | `POST <crm>/api/inquiry` — multipart |
+| `INQUIRY_RECAPTCHA_ACTION` | `inquiry` | the reCAPTCHA v3 action the widget executes and the CRM requires |
+| `INQUIRY_OPEN_EVENT` | `inquiry_dialog_open` | the analytics event of an open |
+
+## The widget config
+
+```ts
+const config: InquiryWidgetConfig = {
+  id: 'viable',                                   // INQUIRY_ALIAS_PATTERN: ^[a-z0-9][a-z0-9-]{0,31}$
+  tabs: [
+    { alias: 'report-issue', title: { en: 'Report an issue', pl: 'Zgłoś problem' } },
+    { alias: 'ask-question', title: 'Ask a question', description: 'We answer within a day.' },
+  ],
+  defaultTab: 'report-issue',                     // optional; default: the first tab
+  legal: { terms: 'https://…/terms', privacy: '/legal/privacy' },
+  language: 'pl',                                 // optional; default: the runtime's, then the document's
+}
+```
+
+- **One tab renders without a tab strip** — the dialog is that single intent. A site that opens a
+  dialog per intent (a "Get a quote" button, a "Book a session" button) gives each its own one-tab
+  config with its own `id`.
+- `LocalizedText` is a string or a `{ language: string }` map; `inquiryConfigHelper.text` reads it
+  with the fallback chain exact tag → primary subtag → `en` → first entry.
+- Legal links are absolute http(s) URLs or root-relative paths; a widget resolves a relative one
+  against the host page and submits the absolute form (`terms`, `privacy`).
+- Caps: 1–`INQUIRY_MAX_TABS` (12) tabs, title ≤ `INQUIRY_TITLE_MAX` (120), description ≤
+  `INQUIRY_DESCRIPTION_MAX` (600) per language.
+
+`inquiryConfigHelper.validate(config)` returns every problem as an English sentence (`[]` when
+usable): the id and aliases against the pattern, alias uniqueness, non-empty titles, `defaultTab`
+naming a tab, the legal links. `InquiryWidgetConfigSchema` checks the structure only — uniqueness
+and `defaultTab` membership are the helper's.
+
+## The runtime contract
+
+The bundle installs an `InquiryRuntime` at `window[INQUIRY_GLOBAL]` (`window.__owlmeansInquiry`):
+
+| Member | Contract |
+|---|---|
+| `version` | `INQUIRY_RUNTIME_VERSION`; a client refuses another. Bump it only for an incompatible change |
+| `configure(options)` | page-wide `{ url, language?, onOpen? }`, last call wins; `language` may be a function read at every open |
+| `open(config, opts?)` | mount the widget's dialog on first use, open it on `opts.tab` or the default tab; apply `opts.email` when supplied |
+| `button(config, opts?)` | mount a floating button (`position`, `offset`, `label`, `source` — default `fab`, `email`); returns an `InquiryHandle` (`open`, `update`, `unmount`); a second call for the same id updates it |
+| `unmount(id?)` | remove one widget, or all |
+
+**`onOpen` is called exactly once per dialog open**, whatever opened it — `open`, a handle's
+`open`, the floating button — with `{ widget, tab, source }`. Opening a dialog that is already open
+does not call it again. The SDK reports analytics from this callback only, so a runtime that also
+reported from elsewhere would double-count.
+
+`InquiryEmailOptions.email` is an optional `InquiryEmailPreset`: a string or a lazy function
+returning `InquiryEmailValue` (`string | null | undefined`), synchronously or in a Promise. The
+runtime resolves it on each closed-to-open transition and replaces any manually edited address;
+calling `open` on an already open dialog does not resolve it again. A null/undefined result or a
+provider failure clears the address for manual entry. Omitting the option preserves the manual
+draft. A button's provider also applies to its floating trigger and handle's `open`; an explicit
+open option overrides it.
+
+While a Promise is pending, the address is empty, its field and Send are disabled, and a spinner
+beside the field announces loading. Other fields remain editable. Closing, reopening or unmounting
+invalidates earlier pending results. A synchronous result needs no spinner. The host owns caching;
+the runtime does not fetch identity or persist addresses. These optional options keep runtime
+version 1 compatible with clients that omit them.
+
+## The submission
+
+One multipart POST. A multipart parser with `attachFieldsToBody: 'keyValues'` hands every text
+field over as a string and every file as a Buffer:
+
+| Field | Rule |
+|---|---|
+| `widget`, `tab` | alias pattern; required |
+| `email` | ≤ `INQUIRY_EMAIL_MAX` (254), `format: email`; required |
+| `subject` | 1–`INQUIRY_SUBJECT_MAX` (150); required |
+| `contactMethod` | `InquiryContactMethod`: `email`, `phone`, `messenger`, `video`; required |
+| `contactDetail` | ≤ `INQUIRY_DETAIL_MAX` (100); the number, handle or time the method needs |
+| `body` | 1–`INQUIRY_BODY_MAX` (5000); required |
+| `consent` | `true` or `'true'` only; required |
+| `files` | JSON string of `InquiryFileMeta[]` (`'[]'` without attachments); required |
+| `tabTitle`, `language`, `page`, `terms`, `privacy` | optional context for the mail |
+| `file0` … `file4` | the bytes, in the fields `files` names |
+
+`InquirySubmissionSchema` is written for ajv with `removeAdditional` + `coerceTypes`. The file
+fields are declared as `{ type: 'object', additionalProperties: true }` and nothing else: any
+`properties`, `additionalProperties: false` or size keyword makes ajv walk the Buffer (or strip its
+bytes). The handler parses `files` and validates it with `InquiryFileMetaListSchema` (known field,
+allowed type, size ≤ the per-file cap, at most five), then checks that each named field is present.
+
+## Limits
+
+| Constant | Value |
+|---|---|
+| `INQUIRY_MAX_FILE_BYTES` | 5 000 000 (decimal) |
+| `INQUIRY_MAX_TOTAL_BYTES` | 20 000 000 |
+| `INQUIRY_MAX_FILES` | 5 (`INQUIRY_FILE_FIELDS` = `file0` … `file4`) |
+| `INQUIRY_ALLOWED_TYPES` | `image/png`, `image/jpeg`, `image/gif`, `image/webp`, `application/pdf`, `text/csv`, `text/plain` — never SVG |
+| `INQUIRY_TYPE_EXTENSIONS` | per type, lower case, first canonical (`jpg`/`jpeg`, `txt`/`log`) |
+
+Declared types are claims: the CRM re-detects the type from the bytes and refuses a mismatch, so a
+widget's client-side check is a convenience, never the gate.
+
+## Languages
+
+`INQUIRY_LANGUAGES` (`en pl ru be uk es de fr`) is what the widget ships strings for;
+`inquiryConfigHelper.normalizeLanguage(tag)` maps any tag to its primary subtag when supported,
+else `en`.
+
+## Related
+
+- `web-inquiry` — the browser SDK over this contract (load, open, bind, button, analytics)
+- `web-log` — `gtmAnalyticsPlugin`, which carries the open event to a tag manager

package/build/config/types.d.ts

@@ -0,0 +1,24 @@
+import type { InquiryTab, InquiryWidgetConfig, LocalizedText } from '../types.js';
+/** Reading and checking an `InquiryWidgetConfig` — the same rules in the widget, the SDK and a server. */
+export interface InquiryConfigHelper {
+    /**
+     * The text of `value` in `language`: the exact tag, then its primary subtag (`pt-BR` → `pt`),
+     * then `fallback`, then the first entry; `''` for `undefined`.
+     */
+    text: (value: LocalizedText | undefined, language: string, fallback?: string) => string;
+    /**
+     * Everything wrong with a config, as English sentences; `[]` when it is usable. Checks the id
+     * and every alias against `INQUIRY_ALIAS_PATTERN`, at least one and at most `INQUIRY_MAX_TABS`
+     * tabs, unique aliases, non-empty titles within their caps, `defaultTab` naming a tab, and legal
+     * links that are absolute http(s) URLs or root-relative paths.
+     */
+    validate: (config: InquiryWidgetConfig) => string[];
+    /** The tab `alias` names, else `defaultTab`'s, else the first; `undefined` only without tabs. */
+    tabOf: (config: InquiryWidgetConfig, alias?: string) => InquiryTab | undefined;
+    /**
+     * The supported language closest to `language` — its primary subtag, lower case — or `fallback`
+     * (`INQUIRY_FALLBACK_LANGUAGE`) when that is not among `supported` (`INQUIRY_LANGUAGES`).
+     */
+    normalizeLanguage: (language: string | undefined | null, supported?: readonly string[], fallback?: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEjF,0GAA0G;AAC1G,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACvF;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,MAAM,EAAE,CAAA;IACnD,iGAAiG;IACjG,KAAK,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAA;IAC9E;;;OAGG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CACrH"}

package/build/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/config/types.js.map

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

package/build/config.d.ts

@@ -0,0 +1,4 @@
+import type { InquiryConfigHelper } from './config/types.js';
+export declare const createInquiryConfigHelper: () => InquiryConfigHelper;
+export declare const inquiryConfigHelper: InquiryConfigHelper;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAG5D,eAAO,MAAM,yBAAyB,QAAO,mBAiI5C,CAAA;AAED,eAAO,MAAM,mBAAmB,qBAA8B,CAAA"}

package/build/config.js

@@ -0,0 +1,118 @@
+import { INQUIRY_ALIAS_PATTERN, INQUIRY_DESCRIPTION_MAX, INQUIRY_FALLBACK_LANGUAGE, INQUIRY_LANGUAGES, INQUIRY_MAX_TABS, INQUIRY_TITLE_MAX, INQUIRY_URL_MAX, } from './consts.js';
+import { INQUIRY_LINK_PATTERN } from './consts.local.js';
+export const createInquiryConfigHelper = () => {
+    const alias = new RegExp(INQUIRY_ALIAS_PATTERN);
+    const link = new RegExp(INQUIRY_LINK_PATTERN);
+    /** `pt-BR` / `pt_br` → `pt`. */
+    const primaryOf = (language) => language.trim().toLowerCase().split(/[-_]/)[0] ?? '';
+    const text = (value, language, fallback = INQUIRY_FALLBACK_LANGUAGE) => {
+        if (value == null) {
+            return '';
+        }
+        if (typeof value === 'string') {
+            return value;
+        }
+        const exact = value[language];
+        if (exact != null) {
+            return exact;
+        }
+        const primary = primaryOf(language);
+        const byPrimary = Object.entries(value).find(([key]) => primaryOf(key) === primary)?.[1];
+        if (byPrimary != null) {
+            return byPrimary;
+        }
+        return value[fallback] ?? Object.values(value)[0] ?? '';
+    };
+    /** The non-empty values a localized text holds, or `null` for a malformed one. */
+    const valuesOf = (value) => {
+        if (typeof value === 'string') {
+            return [value];
+        }
+        if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+            return null;
+        }
+        const values = Object.values(value);
+        return values.every(entry => typeof entry === 'string') ? values : null;
+    };
+    const checkText = (errors, label, value, max, required) => {
+        if (value == null) {
+            if (required) {
+                errors.push(`${label} is missing`);
+            }
+            return;
+        }
+        const values = valuesOf(value);
+        if (values == null || values.length === 0 || values.some(entry => entry.trim() === '')) {
+            errors.push(`${label} must be a non-empty string or a map of language to non-empty string`);
+            return;
+        }
+        if (values.some(entry => entry.length > max)) {
+            errors.push(`${label} is longer than ${max} characters`);
+        }
+    };
+    const checkLink = (errors, label, value) => {
+        if (typeof value !== 'string' || value.length > INQUIRY_URL_MAX || !link.test(value)) {
+            errors.push(`${label} must be an http(s) URL or a root-relative path`);
+        }
+    };
+    const validate = config => {
+        const errors = [];
+        if (config == null || typeof config !== 'object') {
+            return ['config must be an object'];
+        }
+        if (typeof config.id !== 'string' || !alias.test(config.id)) {
+            errors.push(`id must match ${INQUIRY_ALIAS_PATTERN}`);
+        }
+        const tabs = config.tabs;
+        if (!Array.isArray(tabs) || tabs.length === 0) {
+            errors.push('tabs must hold at least one tab');
+        }
+        else {
+            if (tabs.length > INQUIRY_MAX_TABS) {
+                errors.push(`tabs must hold at most ${INQUIRY_MAX_TABS} tabs`);
+            }
+            const seen = new Set();
+            tabs.forEach((tab, index) => {
+                if (tab == null || typeof tab !== 'object') {
+                    errors.push(`tabs[${index}] must be an object`);
+                    return;
+                }
+                if (typeof tab.alias !== 'string' || !alias.test(tab.alias)) {
+                    errors.push(`tabs[${index}].alias must match ${INQUIRY_ALIAS_PATTERN}`);
+                }
+                else if (seen.has(tab.alias)) {
+                    errors.push(`tabs[${index}].alias "${tab.alias}" is not unique`);
+                }
+                else {
+                    seen.add(tab.alias);
+                }
+                checkText(errors, `tabs[${index}].title`, tab.title, INQUIRY_TITLE_MAX, true);
+                checkText(errors, `tabs[${index}].description`, tab.description, INQUIRY_DESCRIPTION_MAX, false);
+            });
+            if (config.defaultTab != null && !seen.has(config.defaultTab)) {
+                errors.push(`defaultTab "${String(config.defaultTab)}" names no tab`);
+            }
+        }
+        if (config.legal == null || typeof config.legal !== 'object') {
+            errors.push('legal must hold the terms and privacy links');
+        }
+        else {
+            checkLink(errors, 'legal.terms', config.legal.terms);
+            checkLink(errors, 'legal.privacy', config.legal.privacy);
+        }
+        return errors;
+    };
+    const tabOf = (config, wanted) => (wanted != null ? config.tabs.find(tab => tab.alias === wanted) : undefined)
+        ?? (config.defaultTab != null ? config.tabs.find(tab => tab.alias === config.defaultTab) : undefined)
+        ?? config.tabs[0];
+    const normalizeLanguage = (language, supported = INQUIRY_LANGUAGES, fallback = INQUIRY_FALLBACK_LANGUAGE) => {
+        if (language == null || language.trim() === '') {
+            return fallback;
+        }
+        const primary = primaryOf(language);
+        return supported.includes(primary) ? primary : fallback;
+    };
+    return { text, validate, tabOf, normalizeLanguage };
+};
+export const inquiryConfigHelper = createInquiryConfigHelper();
+//# sourceMappingURL=config.js.map

package/build/config.js.map

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

package/build/consts.d.ts

@@ -0,0 +1,62 @@
+import type { InquiryFileField, InquiryFileType } from './types.js';
+/** The widget bundle, served at `<crm url>/inquiry.js`. */
+export declare const INQUIRY_SCRIPT = "inquiry.js";
+/** The CRM API sits under `<crm url>/api`. */
+export declare const INQUIRY_API_SEGMENT = "api";
+/** POST, multipart — relative to the API (`<crm url>/api/inquiry`). */
+export declare const INQUIRY_SUBMIT_PATH = "/inquiry";
+/** GET — the advertised config (reCAPTCHA site key), relative to the API (`<crm url>/api/assets/config.json`). */
+export declare const INQUIRY_CONFIG_PATH = "/assets/config.json";
+/** The `window` property the bundle installs its `InquiryRuntime` at. */
+export declare const INQUIRY_GLOBAL = "__owlmeansInquiry";
+/**
+ * The runtime contract version. The bundle reports it as `InquiryRuntime.version`, a client
+ * requests the bundle with `?v=<version>` and refuses a runtime of another version. Bump it only
+ * for an incompatible change of `InquiryRuntime`.
+ */
+export declare const INQUIRY_RUNTIME_VERSION = 1;
+/** The analytics event of a dialog open (`@owlmeans/log` `analytics` option → tag manager). */
+export declare const INQUIRY_OPEN_EVENT = "inquiry_dialog_open";
+/** The reCAPTCHA v3 action the widget executes and the CRM requires. */
+export declare const INQUIRY_RECAPTCHA_ACTION = "inquiry";
+/** One attachment at most, in bytes (decimal). */
+export declare const INQUIRY_MAX_FILE_BYTES = 5000000;
+/** All attachments of one inquiry together, in bytes (decimal). */
+export declare const INQUIRY_MAX_TOTAL_BYTES = 20000000;
+export declare const INQUIRY_MAX_FILES = 5;
+/** The multipart fields attachments travel in, in order. */
+export declare const INQUIRY_FILE_FIELDS: readonly InquiryFileField[];
+/** Accepted attachment types. SVG is not one of them: it can carry script. */
+export declare const INQUIRY_ALLOWED_TYPES: readonly InquiryFileType[];
+/** The file extensions of each accepted type, lower case without the dot; the first is canonical. */
+export declare const INQUIRY_TYPE_EXTENSIONS: Readonly<Record<InquiryFileType, readonly string[]>>;
+export declare const INQUIRY_EMAIL_MAX = 254;
+export declare const INQUIRY_SUBJECT_MAX = 150;
+export declare const INQUIRY_DETAIL_MAX = 100;
+export declare const INQUIRY_BODY_MAX = 5000;
+/** A tab title, per language. */
+export declare const INQUIRY_TITLE_MAX = 120;
+/** A tab description, per language. */
+export declare const INQUIRY_DESCRIPTION_MAX = 600;
+/** A reported file name. */
+export declare const INQUIRY_FILE_NAME_MAX = 255;
+/** A page or legal URL. */
+export declare const INQUIRY_URL_MAX = 2048;
+/** Tabs of one widget. */
+export declare const INQUIRY_MAX_TABS = 12;
+/** How the inquirer prefers to be contacted; every method but `email` asks for a detail line. */
+export declare enum InquiryContactMethod {
+    Email = "email",
+    Phone = "phone",
+    Messenger = "messenger",
+    Video = "video"
+}
+/** A widget id and a tab alias: lower-case, digits and dashes, at most 32 characters. */
+export declare const INQUIRY_ALIAS_PATTERN = "^[a-z0-9][a-z0-9-]{0,31}$";
+/** A language tag as the widget and the submission carry it (`en`, `pt-BR`, `en_US`). */
+export declare const INQUIRY_LANGUAGE_PATTERN = "^[A-Za-z]{2,3}([-_][A-Za-z0-9]{2,8}){0,3}$";
+/** The languages the widget ships strings for. */
+export declare const INQUIRY_LANGUAGES: readonly string[];
+/** The language every lookup falls back to. */
+export declare const INQUIRY_FALLBACK_LANGUAGE = "en";
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEnE,2DAA2D;AAC3D,eAAO,MAAM,cAAc,eAAe,CAAA;AAE1C,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAQ,CAAA;AAExC,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,aAAa,CAAA;AAE7C,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AAExD,yEAAyE;AACzE,eAAO,MAAM,cAAc,sBAAsB,CAAA;AAEjD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,+FAA+F;AAC/F,eAAO,MAAM,kBAAkB,wBAAwB,CAAA;AAEvD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAE/C,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,WAAa,CAAA;AAEjD,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAEzD,CAAA;AAEF,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,EAAE,SAAS,eAAe,EAE1D,CAAA;AAEF,qGAAqG;AACrG,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC,CAQvF,CAAA;AAEF,eAAO,MAAM,iBAAiB,MAAM,CAAA;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAA;AACtC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,MAAM,CAAA;AACpC,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,4BAA4B;AAC5B,eAAO,MAAM,qBAAqB,MAAM,CAAA;AACxC,2BAA2B;AAC3B,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,iGAAiG;AACjG,oBAAY,oBAAoB;IAC9B,KAAK,UAAU;IACf,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,8BAA8B,CAAA;AAEhE,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,+CAA+C,CAAA;AAEpF,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAoE,CAAA;AAEnH,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAA"}

package/build/consts.js

@@ -0,0 +1,74 @@
+/** The widget bundle, served at `<crm url>/inquiry.js`. */
+export const INQUIRY_SCRIPT = 'inquiry.js';
+/** The CRM API sits under `<crm url>/api`. */
+export const INQUIRY_API_SEGMENT = 'api';
+/** POST, multipart — relative to the API (`<crm url>/api/inquiry`). */
+export const INQUIRY_SUBMIT_PATH = '/inquiry';
+/** GET — the advertised config (reCAPTCHA site key), relative to the API (`<crm url>/api/assets/config.json`). */
+export const INQUIRY_CONFIG_PATH = '/assets/config.json';
+/** The `window` property the bundle installs its `InquiryRuntime` at. */
+export const INQUIRY_GLOBAL = '__owlmeansInquiry';
+/**
+ * The runtime contract version. The bundle reports it as `InquiryRuntime.version`, a client
+ * requests the bundle with `?v=<version>` and refuses a runtime of another version. Bump it only
+ * for an incompatible change of `InquiryRuntime`.
+ */
+export const INQUIRY_RUNTIME_VERSION = 1;
+/** The analytics event of a dialog open (`@owlmeans/log` `analytics` option → tag manager). */
+export const INQUIRY_OPEN_EVENT = 'inquiry_dialog_open';
+/** The reCAPTCHA v3 action the widget executes and the CRM requires. */
+export const INQUIRY_RECAPTCHA_ACTION = 'inquiry';
+/** One attachment at most, in bytes (decimal). */
+export const INQUIRY_MAX_FILE_BYTES = 5_000_000;
+/** All attachments of one inquiry together, in bytes (decimal). */
+export const INQUIRY_MAX_TOTAL_BYTES = 20_000_000;
+export const INQUIRY_MAX_FILES = 5;
+/** The multipart fields attachments travel in, in order. */
+export const INQUIRY_FILE_FIELDS = Object.freeze([
+    'file0', 'file1', 'file2', 'file3', 'file4',
+]);
+/** Accepted attachment types. SVG is not one of them: it can carry script. */
+export const INQUIRY_ALLOWED_TYPES = Object.freeze([
+    'image/png', 'image/jpeg', 'image/gif', 'image/webp', 'application/pdf', 'text/csv', 'text/plain',
+]);
+/** The file extensions of each accepted type, lower case without the dot; the first is canonical. */
+export const INQUIRY_TYPE_EXTENSIONS = Object.freeze({
+    'image/png': Object.freeze(['png']),
+    'image/jpeg': Object.freeze(['jpg', 'jpeg']),
+    'image/gif': Object.freeze(['gif']),
+    'image/webp': Object.freeze(['webp']),
+    'application/pdf': Object.freeze(['pdf']),
+    'text/csv': Object.freeze(['csv']),
+    'text/plain': Object.freeze(['txt', 'log']),
+});
+export const INQUIRY_EMAIL_MAX = 254;
+export const INQUIRY_SUBJECT_MAX = 150;
+export const INQUIRY_DETAIL_MAX = 100;
+export const INQUIRY_BODY_MAX = 5000;
+/** A tab title, per language. */
+export const INQUIRY_TITLE_MAX = 120;
+/** A tab description, per language. */
+export const INQUIRY_DESCRIPTION_MAX = 600;
+/** A reported file name. */
+export const INQUIRY_FILE_NAME_MAX = 255;
+/** A page or legal URL. */
+export const INQUIRY_URL_MAX = 2048;
+/** Tabs of one widget. */
+export const INQUIRY_MAX_TABS = 12;
+/** How the inquirer prefers to be contacted; every method but `email` asks for a detail line. */
+export var InquiryContactMethod;
+(function (InquiryContactMethod) {
+    InquiryContactMethod["Email"] = "email";
+    InquiryContactMethod["Phone"] = "phone";
+    InquiryContactMethod["Messenger"] = "messenger";
+    InquiryContactMethod["Video"] = "video";
+})(InquiryContactMethod || (InquiryContactMethod = {}));
+/** A widget id and a tab alias: lower-case, digits and dashes, at most 32 characters. */
+export const INQUIRY_ALIAS_PATTERN = '^[a-z0-9][a-z0-9-]{0,31}$';
+/** A language tag as the widget and the submission carry it (`en`, `pt-BR`, `en_US`). */
+export const INQUIRY_LANGUAGE_PATTERN = '^[A-Za-z]{2,3}([-_][A-Za-z0-9]{2,8}){0,3}$';
+/** The languages the widget ships strings for. */
+export const INQUIRY_LANGUAGES = Object.freeze(['en', 'pl', 'ru', 'be', 'uk', 'es', 'de', 'fr']);
+/** The language every lookup falls back to. */
+export const INQUIRY_FALLBACK_LANGUAGE = 'en';
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

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

package/build/consts.local.d.ts

@@ -0,0 +1,3 @@
+/** A legal link: an absolute http(s) URL, or a root-relative path (never protocol-relative). */
+export declare const INQUIRY_LINK_PATTERN = "^(https?://[^\\s]+|/(?!/)[^\\s]*)$";
+//# sourceMappingURL=consts.local.d.ts.map

package/build/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,uCAAuC,CAAA"}

package/build/consts.local.js

@@ -0,0 +1,3 @@
+/** A legal link: an absolute http(s) URL, or a root-relative path (never protocol-relative). */
+export const INQUIRY_LINK_PATTERN = '^(https?://[^\\s]+|/(?!/)[^\\s]*)$';
+//# sourceMappingURL=consts.local.js.map

package/build/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,CAAC,MAAM,oBAAoB,GAAG,oCAAoC,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,6 @@
+export type * from './types.js';
+export type * from './config/types.js';
+export * from './consts.js';
+export * from './schemas.js';
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export * from './schemas.js';
+export * from './config.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/build/schemas.d.ts

@@ -0,0 +1,18 @@
+import type { JSONSchemaType } from 'ajv';
+import type { InquiryFileMeta, InquiryReceipt, InquirySubmission, InquiryWidgetConfig } from './types.js';
+/**
+ * A widget config. Structure only: alias uniqueness and `defaultTab` membership are checked by
+ * `inquiryConfigHelper.validate`, which a JSON schema cannot express.
+ */
+export declare const InquiryWidgetConfigSchema: JSONSchemaType<InquiryWidgetConfig>;
+export declare const InquiryFileMetaSchema: JSONSchemaType<InquiryFileMeta>;
+/** The parsed `files` field of a submission. Field uniqueness is the handler's to check. */
+export declare const InquiryFileMetaListSchema: JSONSchemaType<InquiryFileMeta[]>;
+/**
+ * The multipart body of `POST <crm url>/api/inquiry`, for a route validated with
+ * `removeAdditional` + `coerceTypes`. `files` stays a JSON string here; validate its parsed value
+ * with `InquiryFileMetaListSchema`.
+ */
+export declare const InquirySubmissionSchema: JSONSchemaType<InquirySubmission>;
+export declare const InquiryReceiptSchema: JSONSchemaType<InquiryReceipt>;
+//# sourceMappingURL=schemas.d.ts.map

package/build/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAOzC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAc,mBAAmB,EAAE,MAAM,YAAY,CAAA;AA4BrH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,cAAc,CAAC,mBAAmB,CAmBzE,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,eAAe,CAUjE,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,EAAE,cAAc,CAAC,eAAe,EAAE,CAKvE,CAAA;AASD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,iBAAiB,CAyBrE,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,cAAc,CAQ/D,CAAA"}

package/build/schemas.js

@@ -0,0 +1,115 @@
+import { INQUIRY_ALIAS_PATTERN, INQUIRY_ALLOWED_TYPES, INQUIRY_BODY_MAX, INQUIRY_DESCRIPTION_MAX, INQUIRY_DETAIL_MAX, INQUIRY_EMAIL_MAX, INQUIRY_FILE_FIELDS, INQUIRY_FILE_NAME_MAX, INQUIRY_LANGUAGE_PATTERN, INQUIRY_MAX_FILE_BYTES, INQUIRY_MAX_FILES, INQUIRY_MAX_TABS, INQUIRY_SUBJECT_MAX, INQUIRY_TITLE_MAX, INQUIRY_URL_MAX, InquiryContactMethod, } from './consts.js';
+import { INQUIRY_LINK_PATTERN } from './consts.local.js';
+/** `LocalizedText`: a string, or a non-empty map of language tag → string. */
+const localizedText = (maxLength) => ({
+    anyOf: [
+        { type: 'string', minLength: 1, maxLength },
+        {
+            type: 'object',
+            minProperties: 1,
+            maxProperties: 32,
+            propertyNames: { pattern: INQUIRY_LANGUAGE_PATTERN },
+            additionalProperties: { type: 'string', minLength: 1, maxLength },
+            required: [],
+        },
+    ],
+});
+const InquiryTabSchema = {
+    type: 'object',
+    properties: {
+        alias: { type: 'string', pattern: INQUIRY_ALIAS_PATTERN },
+        title: localizedText(INQUIRY_TITLE_MAX),
+        description: localizedText(INQUIRY_DESCRIPTION_MAX),
+    },
+    required: ['alias', 'title'],
+    additionalProperties: false,
+};
+/**
+ * A widget config. Structure only: alias uniqueness and `defaultTab` membership are checked by
+ * `inquiryConfigHelper.validate`, which a JSON schema cannot express.
+ */
+export const InquiryWidgetConfigSchema = {
+    type: 'object',
+    properties: {
+        id: { type: 'string', pattern: INQUIRY_ALIAS_PATTERN },
+        tabs: { type: 'array', minItems: 1, maxItems: INQUIRY_MAX_TABS, items: InquiryTabSchema },
+        defaultTab: { type: 'string', pattern: INQUIRY_ALIAS_PATTERN, nullable: true },
+        legal: {
+            type: 'object',
+            properties: {
+                terms: { type: 'string', maxLength: INQUIRY_URL_MAX, pattern: INQUIRY_LINK_PATTERN },
+                privacy: { type: 'string', maxLength: INQUIRY_URL_MAX, pattern: INQUIRY_LINK_PATTERN },
+            },
+            required: ['terms', 'privacy'],
+            additionalProperties: false,
+        },
+        language: { type: 'string', pattern: INQUIRY_LANGUAGE_PATTERN, nullable: true },
+    },
+    required: ['id', 'tabs', 'legal'],
+    additionalProperties: false,
+};
+export const InquiryFileMetaSchema = {
+    type: 'object',
+    properties: {
+        field: { type: 'string', enum: [...INQUIRY_FILE_FIELDS] },
+        name: { type: 'string', minLength: 1, maxLength: INQUIRY_FILE_NAME_MAX },
+        type: { type: 'string', enum: [...INQUIRY_ALLOWED_TYPES] },
+        size: { type: 'integer', minimum: 1, maximum: INQUIRY_MAX_FILE_BYTES },
+    },
+    required: ['field', 'name', 'type', 'size'],
+    additionalProperties: false,
+};
+/** The parsed `files` field of a submission. Field uniqueness is the handler's to check. */
+export const InquiryFileMetaListSchema = {
+    type: 'array',
+    minItems: 0,
+    maxItems: INQUIRY_MAX_FILES,
+    items: InquiryFileMetaSchema,
+};
+/**
+ * A file field: the multipart parser (`attachFieldsToBody: 'keyValues'`) hands it over as a
+ * Buffer. It is declared ONLY as an open object — `properties`, `additionalProperties: false` or
+ * any size keyword would make ajv walk (or, with `removeAdditional`, strip) the bytes.
+ */
+const fileField = { type: 'object', additionalProperties: true };
+/**
+ * The multipart body of `POST <crm url>/api/inquiry`, for a route validated with
+ * `removeAdditional` + `coerceTypes`. `files` stays a JSON string here; validate its parsed value
+ * with `InquiryFileMetaListSchema`.
+ */
+export const InquirySubmissionSchema = {
+    type: 'object',
+    properties: {
+        widget: { type: 'string', pattern: INQUIRY_ALIAS_PATTERN },
+        tab: { type: 'string', pattern: INQUIRY_ALIAS_PATTERN },
+        tabTitle: { type: 'string', maxLength: INQUIRY_TITLE_MAX, nullable: true },
+        email: { type: 'string', minLength: 3, maxLength: INQUIRY_EMAIL_MAX, format: 'email' },
+        subject: { type: 'string', minLength: 1, maxLength: INQUIRY_SUBJECT_MAX },
+        contactMethod: { type: 'string', enum: Object.values(InquiryContactMethod) },
+        contactDetail: { type: 'string', maxLength: INQUIRY_DETAIL_MAX, nullable: true },
+        body: { type: 'string', minLength: 1, maxLength: INQUIRY_BODY_MAX },
+        language: { type: 'string', pattern: INQUIRY_LANGUAGE_PATTERN, nullable: true },
+        page: { type: 'string', maxLength: INQUIRY_URL_MAX, nullable: true },
+        terms: { type: 'string', maxLength: INQUIRY_URL_MAX, nullable: true },
+        privacy: { type: 'string', maxLength: INQUIRY_URL_MAX, nullable: true },
+        consent: { type: ['boolean', 'string'], enum: [true, 'true'] },
+        files: { type: 'string', minLength: 2, maxLength: 4096 },
+        file0: fileField,
+        file1: fileField,
+        file2: fileField,
+        file3: fileField,
+        file4: fileField,
+    },
+    required: ['widget', 'tab', 'email', 'subject', 'contactMethod', 'body', 'consent', 'files'],
+    additionalProperties: false,
+};
+export const InquiryReceiptSchema = {
+    type: 'object',
+    properties: {
+        id: { type: 'string', minLength: 1 },
+        queued: { type: 'boolean' },
+    },
+    required: ['id', 'queued'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=schemas.js.map

package/build/schemas.js.map

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

package/build/types.d.ts

@@ -0,0 +1,180 @@
+import type { InquiryContactMethod } from './consts.js';
+/**
+ * A text the widget shows: one string for every language, or one string per language keyed by
+ * its tag (`{ en: 'Report an issue', pl: 'Zgłoś problem' }`). A missing language falls back to the
+ * primary subtag, then English, then the first entry (`inquiryConfigHelper.text`).
+ */
+export type LocalizedText = string | Record<string, string>;
+/** One of the attachment types the CRM accepts — the detected type, never only the declared one. */
+export type InquiryFileType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'application/pdf' | 'text/csv' | 'text/plain';
+/** The multipart field an attachment travels in. */
+export type InquiryFileField = 'file0' | 'file1' | 'file2' | 'file3' | 'file4';
+/** Where the floating button sits. */
+export type InquiryButtonPosition = 'bottom-right' | 'bottom-left';
+/** One intent of a widget — a tab of the dialog. */
+export interface InquiryTab {
+    /** Stable machine name (`INQUIRY_ALIAS_PATTERN`); it prefixes the mail subject. */
+    alias: string;
+    title: LocalizedText;
+    /** One or two sentences under the tab strip. */
+    description?: LocalizedText;
+}
+/** The documents the inquirer consents to before sending. */
+export interface InquiryLegalLinks {
+    /** An absolute http(s) URL, or a root-relative path resolved against the host page. */
+    terms: string;
+    /** An absolute http(s) URL, or a root-relative path resolved against the host page. */
+    privacy: string;
+}
+/**
+ * What a host page asks the widget to show.
+ *
+ * A config with ONE tab renders without a tab strip — the dialog is then that single intent, its
+ * title the dialog's title. Two or more tabs render a tab strip, `defaultTab` (or the first)
+ * selected.
+ */
+export interface InquiryWidgetConfig {
+    /** The widget's id (`INQUIRY_ALIAS_PATTERN`): one mounted dialog per id, reported in analytics and mail. */
+    id: string;
+    tabs: InquiryTab[];
+    /** The alias of the tab selected when no other is asked for. Default: the first tab. */
+    defaultTab?: string;
+    legal: InquiryLegalLinks;
+    /** The interface language; default: the runtime's configured language, then the document's. */
+    language?: string;
+}
+/** A preset reply address, resolved when the dialog opens. A missing result clears the email. */
+export type InquiryEmailValue = string | null | undefined;
+/** A reply address or a lazy provider; a pending provider shows the widget's email spinner. */
+export type InquiryEmailPreset = string | (() => InquiryEmailValue | Promise<InquiryEmailValue>);
+export interface InquiryEmailOptions {
+    /** Applied on every dialog open, replacing any previously edited email. Omit to keep manual entry. */
+    email?: InquiryEmailPreset;
+}
+export interface InquiryOpenOptions extends InquiryEmailOptions {
+    /** The alias of the tab to select; an unknown alias selects the default tab. */
+    tab?: string;
+    /** Which trigger opened the dialog (`fab`, `menu`, `pricing-card` …), reported in analytics. */
+    source?: string;
+}
+export interface InquiryButtonOptions extends InquiryEmailOptions {
+    /** Default: `bottom-right`. */
+    position?: InquiryButtonPosition;
+    /** Distance from the viewport edges in CSS pixels. */
+    offset?: number;
+    /** The button's accessible label (and tooltip); default: the widget's own "Contact us". */
+    label?: LocalizedText;
+    /** Reported as the source of every open the button makes. Default: `fab`. */
+    source?: string;
+}
+/** One dialog open, as analytics and `onOpen` callbacks receive it. */
+export interface InquiryOpenEvent {
+    /** `InquiryWidgetConfig.id`. */
+    widget: string;
+    /** The alias of the tab the dialog opened on. */
+    tab: string;
+    source?: string;
+}
+/** One attachment, described in the submission's `files` field (a JSON string of these). */
+export interface InquiryFileMeta {
+    /** The multipart field carrying the bytes. */
+    field: InquiryFileField;
+    /** The file name as the inquirer's device reported it. */
+    name: string;
+    /** The declared type; the CRM re-detects it from the bytes and refuses a mismatch. */
+    type: InquiryFileType;
+    /** Size in bytes. */
+    size: number;
+}
+/**
+ * The multipart text fields of one inquiry.
+ *
+ * The multipart parser hands every text field over as a string, so `consent` arrives as `'true'`
+ * and `files` is a JSON string of `InquiryFileMeta[]` the handler parses and validates
+ * (`InquiryFileMetaListSchema`). Every field `files` names must be present.
+ */
+export interface InquirySubmissionFields {
+    /** `InquiryWidgetConfig.id`. */
+    widget: string;
+    /** The tab's alias. */
+    tab: string;
+    /** The tab's title as the inquirer saw it. */
+    tabTitle?: string;
+    /** The reply address. */
+    email: string;
+    subject: string;
+    contactMethod: InquiryContactMethod;
+    /** A phone number, a messenger handle or a preferred call time — whatever the method needs. */
+    contactDetail?: string;
+    body: string;
+    /** The interface language the inquirer used. */
+    language?: string;
+    /** The page the dialog was opened on. */
+    page?: string;
+    /** The terms the inquirer consented to, absolute. */
+    terms?: string;
+    /** The privacy notice the inquirer consented to, absolute. */
+    privacy?: string;
+    /** The consent checkbox: only `true` is accepted. */
+    consent: true | 'true';
+    /** JSON of `InquiryFileMeta[]`; `'[]'` without attachments. */
+    files: string;
+}
+/** The whole multipart body as the server receives it: the text fields plus the file buffers. */
+export interface InquirySubmission extends InquirySubmissionFields {
+    file0?: Uint8Array;
+    file1?: Uint8Array;
+    file2?: Uint8Array;
+    file3?: Uint8Array;
+    file4?: Uint8Array;
+}
+/** What the CRM answers to an accepted inquiry. */
+export interface InquiryReceipt {
+    id: string;
+    /** Whether the mail was queued (always, once accepted). */
+    queued: boolean;
+}
+/** What a host (through `@owlmeans/web-inquiry`) tells the runtime once it is loaded. */
+export interface InquiryRuntimeOptions {
+    /** The CRM base URL the bundle was loaded from, without a trailing slash (`https://<web>/crm`). */
+    url: string;
+    /** The interface language, or a function read at every open (so a language switch is honoured). */
+    language?: string | (() => string);
+    /**
+     * Called exactly once per dialog open, whatever opened it — `open`, a handle's `open` or the
+     * floating button. An `open` of a dialog that is already open does not call it again.
+     */
+    onOpen?: (event: InquiryOpenEvent) => void;
+}
+/** A mounted floating button. */
+export interface InquiryHandle {
+    /** Open the button's dialog as if it were clicked (its `source` unless `opts` names another). */
+    open: (opts?: InquiryOpenOptions) => void;
+    /** Replace the widget's config (texts, tabs, language) in place. */
+    update: (config: InquiryWidgetConfig) => void;
+    /** Remove the button and its dialog. */
+    unmount: () => void;
+}
+/**
+ * The contract the widget bundle (`INQUIRY_SCRIPT`) installs at `window[INQUIRY_GLOBAL]`.
+ *
+ * A host never loads the bundle by hand: `@owlmeans/web-inquiry` injects it once, checks `version`
+ * against `INQUIRY_RUNTIME_VERSION` and calls `configure` before anything else.
+ */
+export interface InquiryRuntime {
+    /** `INQUIRY_RUNTIME_VERSION` of the bundle; a client refuses a runtime of another version. */
+    version: number;
+    /** Set (or replace) the page-wide options; the last call wins. */
+    configure: (options: InquiryRuntimeOptions) => void;
+    /** Open the widget's dialog (mounting it on first use) on `opts.tab` or the default tab. */
+    open: (config: InquiryWidgetConfig, opts?: InquiryOpenOptions) => void;
+    /** Mount the widget's floating button; a second call for the same `config.id` updates it. */
+    button: (config: InquiryWidgetConfig, opts?: InquiryButtonOptions) => InquiryHandle;
+    /** Remove one widget (button and dialog) by its id, or every widget. */
+    unmount: (id?: string) => void;
+}
+/** The `window` slot the runtime lives in. */
+export interface InquiryWindow {
+    __owlmeansInquiry?: InquiryRuntime;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

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

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@owlmeans/common-inquiry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.18-rc.1",
+  "license": "MIT",
+  "description": "Runtime-free contract of the OwlMeans customer inquiry widget — the window runtime, the widget config, the multipart submission and its limits, schemas and the config helper.",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 2 && nodemon -e ts,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty",
+    "test": "bun test ./tests"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "files": [
+    "build",
+    "agent-meta"
+  ],
+  "peerDependencies": {
+    "ajv": "*"
+  },
+  "peerDependenciesMeta": {
+    "ajv": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "@types/bun": "^1.4.2",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "nodemon": "^3.1.14",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}