@spotto/contract 1.0.70-alpha.1 → 1.0.70-alpha.11

package/dist/fields/constants.d.ts

@@ -2,3 +2,22 @@ export declare type FieldDataType = 'STRING' | 'INTEGER' | 'DECIMAL' | 'BOOLEAN'
 export declare const FIELD_DATA_TYPES: FieldDataType[];
 export declare type FieldInputType = 'SINGLELINE' | 'MULTILINE' | 'LINK' | 'RICHTEXT' | 'DROPDOWN' | 'RADIO' | 'CHECKBOXES' | 'DATE' | 'DATETIME' | 'INTEGER' | 'DECIMAL' | 'SWITCH';
 export declare const FIELD_INPUT_TYPES: FieldInputType[];
+export declare type FieldSource = 'INPUT' | 'COMPUTED' | 'AGGREGATED';
+export declare const FIELD_SOURCES: FieldSource[];
+export declare type AggregateFunction = 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'COUNT';
+export declare const AGGREGATE_FUNCTIONS: AggregateFunction[];
+/**
+ * A per-type field-binding delta, layered onto the inherited field identity
+ * (`fieldsAll = parent.fieldsAll ⊕ fields`). Omitted `source` on an override =
+ * inherit; explicit `INPUT` = reset to user-entered.
+ *   - `expression`   — COMPUTED: excelexp over the asset's other fields.
+ *   - `visibleWhen`  — conditional visibility (client-render only).
+ *   - `function`     — AGGREGATED (M2 — kits): the same field is reduced across
+ *     a kit's direct members.
+ */
+export interface IFieldBindingDelta {
+    source?: FieldSource;
+    expression?: string;
+    visibleWhen?: string;
+    function?: AggregateFunction;
+}

package/dist/fields/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FIELD_INPUT_TYPES = exports.FIELD_DATA_TYPES = void 0;
+exports.AGGREGATE_FUNCTIONS = exports.FIELD_SOURCES = exports.FIELD_INPUT_TYPES = exports.FIELD_DATA_TYPES = void 0;
 const dataTypes = {
     STRING: null,
     INTEGER: null,
@@ -25,4 +25,18 @@ const inputTypes = {
     SWITCH: null,
 };
 exports.FIELD_INPUT_TYPES = Object.keys(inputTypes);
+const fieldSources = {
+    INPUT: null,
+    COMPUTED: null,
+    AGGREGATED: null,
+};
+exports.FIELD_SOURCES = Object.keys(fieldSources);
+const aggregateFunctions = {
+    SUM: null,
+    AVG: null,
+    MIN: null,
+    MAX: null,
+    COUNT: null,
+};
+exports.AGGREGATE_FUNCTIONS = Object.keys(aggregateFunctions);
 //# sourceMappingURL=constants.js.map

package/dist/fields/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/fields/constants.ts"],"names":[],"mappings":";;;AAQA,MAAM,SAAS,GAAqC;IAClD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;CACf,CAAA;AAEY,QAAA,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAoB,CAAA;AAgBzE,MAAM,UAAU,GAAsC;IACpD,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;CACb,CAAA;AAEY,QAAA,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAqB,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/fields/constants.ts"],"names":[],"mappings":";;;AAQA,MAAM,SAAS,GAAqC;IAClD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;CACf,CAAA;AAEY,QAAA,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAoB,CAAA;AAgBzE,MAAM,UAAU,GAAsC;IACpD,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;CACb,CAAA;AAEY,QAAA,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAqB,CAAA;AAS5E,MAAM,YAAY,GAAmC;IACnD,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;CACjB,CAAA;AAEY,QAAA,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAkB,CAAA;AAIvE,MAAM,kBAAkB,GAAyC;IAC/D,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;CACZ,CAAA;AAEY,QAAA,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAC5C,kBAAkB,CACI,CAAA"}

package/dist/forms/[id]/index.d.ts

@@ -0,0 +1 @@
+export * from './patch';

package/dist/forms/[id]/index.js

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

package/dist/forms/[id]/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/forms/[id]/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB"}

package/dist/forms/[id]/patch/index.d.ts

@@ -0,0 +1,2 @@
+export * from './request';
+export * from './response';

package/dist/forms/[id]/patch/index.js

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

package/dist/forms/[id]/patch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/forms/[id]/patch/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,6CAA0B"}

package/dist/forms/[id]/patch/request.d.ts

@@ -0,0 +1,14 @@
+import { FormItem, FormPrefillRow, FormWriteBackRow } from '../../shared';
+/**
+ * Publishes a new version of the form. `{id}` is the version document the
+ * editor loaded — the server inserts exactly `that.version + 1` and returns
+ * 409 when the head has moved ("form changed — reload"). Version documents
+ * themselves are never mutated. Omitted fields carry over from the loaded
+ * version; `name` is immutable.
+ */
+export interface UpdateFormRequest {
+    label?: string;
+    items?: FormItem[];
+    prefill?: FormPrefillRow[];
+    writeBack?: FormWriteBackRow[];
+}

package/dist/forms/[id]/patch/request.js

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

package/dist/forms/[id]/patch/request.js.map

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

package/dist/forms/[id]/patch/response.d.ts

@@ -0,0 +1 @@
+export { GetFormResponse as UpdateFormResponse } from '../../get/response';

package/dist/forms/[id]/patch/response.js

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

package/dist/forms/[id]/patch/response.js.map

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

package/dist/forms/constants.d.ts

@@ -0,0 +1,19 @@
+import { FieldDataType } from '../fields/constants';
+/**
+ * Context names injected into every form-expression environment (entity-neutral
+ * — asset and location targets share them). Reserved: the fields service
+ * rejects creating a custom field with any of these names (case-insensitively,
+ * matching its name-uniqueness rule), because the injected context value would
+ * shadow the field in every form env. They can never collide with engine
+ * functions — call-vs-identifier is decided syntactically.
+ */
+export declare const RESERVED_CONTEXT_FIELD_NAMES: readonly ["entityId", "entityName", "entityTypeId", "currentUser", "now"];
+export declare type ReservedContextFieldName = (typeof RESERVED_CONTEXT_FIELD_NAMES)[number];
+/**
+ * The dataType each injected context value presents as inside a form env —
+ * what save-time expression checks and `from`→`to` compatibility resolve a
+ * context reference to. Ids are opaque strings; `now` is the submit timestamp.
+ */
+export declare const RESERVED_CONTEXT_FIELD_TYPES: Record<ReservedContextFieldName, FieldDataType>;
+/** Signature/photo capture blocks allowed on a single form version. */
+export declare const MAX_CAPTURE_BLOCKS_PER_FORM = 10;

package/dist/forms/constants.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CAPTURE_BLOCKS_PER_FORM = exports.RESERVED_CONTEXT_FIELD_TYPES = exports.RESERVED_CONTEXT_FIELD_NAMES = void 0;
+/**
+ * Context names injected into every form-expression environment (entity-neutral
+ * — asset and location targets share them). Reserved: the fields service
+ * rejects creating a custom field with any of these names (case-insensitively,
+ * matching its name-uniqueness rule), because the injected context value would
+ * shadow the field in every form env. They can never collide with engine
+ * functions — call-vs-identifier is decided syntactically.
+ */
+exports.RESERVED_CONTEXT_FIELD_NAMES = [
+    'entityId',
+    'entityName',
+    'entityTypeId',
+    'currentUser',
+    'now',
+];
+/**
+ * The dataType each injected context value presents as inside a form env —
+ * what save-time expression checks and `from`→`to` compatibility resolve a
+ * context reference to. Ids are opaque strings; `now` is the submit timestamp.
+ */
+exports.RESERVED_CONTEXT_FIELD_TYPES = {
+    entityId: 'STRING',
+    entityName: 'STRING',
+    entityTypeId: 'STRING',
+    currentUser: 'STRING',
+    now: 'DATETIME',
+};
+/** Signature/photo capture blocks allowed on a single form version. */
+exports.MAX_CAPTURE_BLOCKS_PER_FORM = 10;
+//# sourceMappingURL=constants.js.map

package/dist/forms/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/forms/constants.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACU,QAAA,4BAA4B,GAAG;IAC1C,UAAU;IACV,YAAY;IACZ,cAAc;IACd,aAAa;IACb,KAAK;CACG,CAAA;AAKV;;;;GAIG;AACU,QAAA,4BAA4B,GAGrC;IACF,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,QAAQ;IACrB,GAAG,EAAE,UAAU;CAChB,CAAA;AAED,uEAAuE;AAC1D,QAAA,2BAA2B,GAAG,EAAE,CAAA"}

package/dist/forms/get/index.d.ts

@@ -0,0 +1,2 @@
+export * from './query';
+export * from './response';

package/dist/forms/get/index.js

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

package/dist/forms/get/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/forms/get/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,6CAA0B"}

package/dist/forms/get/query.d.ts

@@ -0,0 +1,18 @@
+import { StandardSortFields, SortOrders } from '../../shared';
+export declare type FormEmbedField = 'meta';
+/**
+ * Lists current form versions only (one row per form name). Historic
+ * versions are fetched individually via GET /forms/{name}/versions/{version}.
+ */
+export interface GetFormsQuery {
+    page?: number;
+    limit?: number;
+    ids?: string[];
+    sort?: StandardSortFields;
+    sortOrder?: SortOrders;
+    embed?: Array<FormEmbedField>;
+    /** Exact form name (the immutable handle). */
+    name?: string;
+    /** Include archived forms — defaults to false. */
+    archived?: boolean;
+}

package/dist/forms/get/query.js

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

package/dist/forms/get/query.js.map

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

package/dist/forms/get/response.d.ts

@@ -0,0 +1,24 @@
+import { IEntityMeta } from '../../shared';
+import { FormItem, FormPrefillRow, FormWriteBackRow } from '../shared';
+import { GetFormsQuery } from './query';
+/** One immutable form version document. */
+export interface GetFormResponse {
+    id: string;
+    /** Immutable handle — shared by every version of the form. */
+    name: string;
+    label: string;
+    version: number;
+    /** Exactly one version per (org, name) is current. */
+    current: boolean;
+    archived: boolean;
+    items: FormItem[];
+    prefill: FormPrefillRow[];
+    writeBack: FormWriteBackRow[];
+    createdBy: string;
+    meta?: IEntityMeta;
+}
+export interface GetFormsResponse {
+    query: GetFormsQuery | null;
+    total: number;
+    items: GetFormResponse[];
+}

package/dist/forms/get/response.js

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

package/dist/forms/get/response.js.map

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

package/dist/forms/index.d.ts

@@ -0,0 +1,6 @@
+export * from './constants';
+export * from './shared';
+export * from './get';
+export * from './post';
+export * from './[id]';
+export * from './versions';

package/dist/forms/index.js

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

package/dist/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,2CAAwB;AACxB,wCAAqB;AACrB,yCAAsB;AACtB,yCAAsB;AACtB,6CAA0B"}

package/dist/forms/post/index.d.ts

@@ -0,0 +1,2 @@
+export * from './request';
+export * from './response';

package/dist/forms/post/index.js

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

package/dist/forms/post/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/forms/post/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,6CAA0B"}

package/dist/forms/post/request.d.ts

@@ -0,0 +1,10 @@
+import { FormItem, FormPrefillRow, FormWriteBackRow } from '../shared';
+/** Creates a new form as version 1 (current). */
+export interface PostFormRequest {
+    /** Immutable handle; referenced by actions. */
+    name: string;
+    label: string;
+    items: FormItem[];
+    prefill?: FormPrefillRow[];
+    writeBack?: FormWriteBackRow[];
+}

package/dist/forms/post/request.js

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

package/dist/forms/post/request.js.map

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

package/dist/forms/post/response.d.ts

@@ -0,0 +1 @@
+export { GetFormResponse as PostFormResponse } from '../get/response';

package/dist/forms/post/response.js

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

package/dist/forms/post/response.js.map

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

package/dist/forms/shared.d.ts

@@ -0,0 +1,86 @@
+import { ReservedContextFieldName } from './constants';
+/**
+ * How a form field item's value is produced. `INPUT` (default) is entered by
+ * the user, `COMPUTED` derives from an expression over the merged env, and
+ * `CONTEXT` is injected from the submission context (never entered/computed).
+ * `AGGREGATED` is meaningless on a form — there are no members.
+ */
+export declare type FormFieldSource = 'INPUT' | 'COMPUTED' | 'CONTEXT';
+/** Content blocks that capture media and produce a submission attachment. */
+export declare type FormCaptureKind = 'signature' | 'photo';
+/**
+ * A field binding on a form — a delta over the global field definition
+ * (which owns identity: dataType, options), plus form-only extras.
+ */
+export interface FormFieldItem {
+    kind: 'field';
+    /** Name of a global field definition. */
+    name: string;
+    source?: FormFieldSource;
+    /** Required (and only allowed) when source is COMPUTED. */
+    expression?: string;
+    /** Required (and only allowed) when source is CONTEXT. */
+    from?: ReservedContextFieldName;
+    /** Must be present to submit — only bites while the item is visible. */
+    required?: boolean;
+    /** Shown, not editable (e.g. filled by prefill purely for context). */
+    readonly?: boolean;
+    /** Open-time expression seeding the initial value (prefill wins over it). */
+    default?: string;
+    visibleWhen?: string;
+    /** Per-form display overrides; identity still comes from the definition. */
+    label?: string;
+    help?: string;
+}
+export interface FormSectionItem {
+    kind: 'section';
+    title: string;
+}
+export interface FormTextItem {
+    kind: 'text';
+    text: string;
+}
+export interface FormImageItem {
+    kind: 'image';
+    src: string;
+    caption?: string;
+}
+export interface FormDividerItem {
+    kind: 'divider';
+}
+/**
+ * A signature/photo capture block. Produces an attachment reference on the
+ * submission (never a fieldValue), keyed by the block's `name`.
+ */
+export interface FormCaptureItem {
+    kind: FormCaptureKind;
+    name: string;
+    required?: boolean;
+    label?: string;
+    help?: string;
+}
+export declare type FormItem = FormFieldItem | FormSectionItem | FormTextItem | FormImageItem | FormDividerItem | FormCaptureItem;
+export declare type FormItemKind = FormItem['kind'];
+/**
+ * A read-in row: on open, seed form field `to` from the target — either a
+ * copy of target field `from` or an `expression` over the target's effective
+ * values (exactly one of the two), optionally gated by `when`.
+ */
+export interface FormPrefillRow {
+    to: string;
+    from?: string;
+    expression?: string;
+    when?: string;
+}
+/**
+ * A write-back row: on submit, set target field `to` — either a copy of
+ * captured form value `from` or an `expression` over the merged env (exactly
+ * one of the two), optionally gated by `when`. Written as ordinary authored
+ * data (user-editable afterward) and triggers the standard recompute.
+ */
+export interface FormWriteBackRow {
+    to: string;
+    from?: string;
+    expression?: string;
+    when?: string;
+}

package/dist/forms/shared.js

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

package/dist/forms/shared.js.map

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

package/dist/forms/versions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './path';
+export * from './response';

package/dist/forms/versions/index.js

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

package/dist/forms/versions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/forms/versions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,6CAA0B"}

package/dist/forms/versions/path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Path parameters for GET /forms/{name}/versions/{version} — fetches a
+ * pinned, possibly non-current version (submission detail renders these).
+ */
+export interface FormVersionPath {
+    name: string;
+    version: number;
+}

package/dist/forms/versions/path.js

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

package/dist/forms/versions/path.js.map

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

package/dist/forms/versions/response.d.ts

@@ -0,0 +1 @@
+export { GetFormResponse as GetFormVersionResponse } from '../get/response';

package/dist/forms/versions/response.js

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

package/dist/forms/versions/response.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './shared';
+export * from './ai';
 export * from './events';
 export * from './integrations';
 export * from './labels';
@@ -21,3 +22,6 @@ export * from './system';
 export * from './reports';
 export * from './sso';
 export * from './views';
+export * from './forms';
+export * from './actions';
+export * from './submissions';

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./shared"), exports);
+__exportStar(require("./ai"), exports);
 __exportStar(require("./events"), exports);
 __exportStar(require("./integrations"), exports);
 __exportStar(require("./labels"), exports);
@@ -37,4 +38,7 @@ __exportStar(require("./system"), exports);
 __exportStar(require("./reports"), exports);
 __exportStar(require("./sso"), exports);
 __exportStar(require("./views"), exports);
+__exportStar(require("./forms"), exports);
+__exportStar(require("./actions"), exports);
+__exportStar(require("./submissions"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,2CAAwB;AACxB,iDAA8B;AAC9B,2CAAwB;AACxB,2CAAwB;AACxB,8CAA2B;AAC3B,6CAA0B;AAC1B,kDAA+B;AAC/B,4CAAyB;AACzB,0CAAuB;AACvB,yCAAsB;AACtB,8CAA2B;AAC3B,0CAAuB;AACvB,8CAA2B;AAC3B,0CAAuB;AACvB,2CAAwB;AACxB,8CAA2B;AAC3B,2CAAwB;AACxB,8CAA2B;AAC3B,2CAAwB;AACxB,4CAAyB;AACzB,wCAAqB;AACrB,0CAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,uCAAoB;AACpB,2CAAwB;AACxB,iDAA8B;AAC9B,2CAAwB;AACxB,2CAAwB;AACxB,8CAA2B;AAC3B,6CAA0B;AAC1B,kDAA+B;AAC/B,4CAAyB;AACzB,0CAAuB;AACvB,yCAAsB;AACtB,8CAA2B;AAC3B,0CAAuB;AACvB,8CAA2B;AAC3B,0CAAuB;AACvB,2CAAwB;AACxB,8CAA2B;AAC3B,2CAAwB;AACxB,8CAA2B;AAC3B,2CAAwB;AACxB,4CAAyB;AACzB,wCAAqB;AACrB,0CAAuB;AACvB,0CAAuB;AACvB,4CAAyB;AACzB,gDAA6B"}

package/dist/integrations/constants.d.ts

@@ -27,6 +27,7 @@ export declare enum IntegrationType {
 export declare type OneBlinkIntegrationDetails = {
     enabled: true;
     accessKey: string;
+    formsAppId?: number;
 } | {
     enabled: false;
 };

package/dist/integrations/oneblink/patch/request.d.ts

@@ -1,7 +1,8 @@
 export declare type UpdateOneBlinkSettingsRequest = {
     enabled: true;
-    accessKey: string;
-    secretKey: string;
+    accessKey?: string;
+    secretKey?: string;
+    formsAppId?: number;
 } | {
     enabled: false;
 };

package/dist/integrations/oneblink/token.d.ts

@@ -1,4 +1,6 @@
 export interface GetOneBlinkTokenResponse {
     token: string;
     expiration: string;
+    /** The org's OneBlink Forms App id, if configured. */
+    formsAppId?: number;
 }