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

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

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

package/dist/actions/[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/actions/[id]/index.js.map

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

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

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

package/dist/actions/[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/actions/[id]/patch/index.js.map

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

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

@@ -0,0 +1,12 @@
+import { ActionEffect, ActionEvent, ActionPresentation, ActionTargetEntity } from '../../shared';
+/** `name` is immutable. `event: null` clears the custom history label. */
+export interface UpdateActionRequest {
+    label?: string;
+    purpose?: string;
+    form?: string;
+    targetEntity?: ActionTargetEntity;
+    presentation?: ActionPresentation;
+    event?: ActionEvent | null;
+    /** Replaced wholesale; an empty array clears every effect. */
+    effects?: ActionEffect[];
+}

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/actions/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/actions/get/index.js.map

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

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

@@ -0,0 +1,14 @@
+import { StandardSortFields, SortOrders } from '../../shared';
+import { ActionTargetEntity } from '../shared';
+export declare type ActionEmbedField = 'meta';
+export interface GetActionsQuery {
+    page?: number;
+    limit?: number;
+    ids?: string[];
+    sort?: StandardSortFields;
+    sortOrder?: SortOrders;
+    embed?: Array<ActionEmbedField>;
+    /** Actions running the given form (exact form name). */
+    form?: string;
+    targetEntity?: ActionTargetEntity;
+}

package/dist/actions/get/query.js

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

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

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

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

@@ -0,0 +1,25 @@
+import { IEntityMeta } from '../../shared';
+import { ActionEffect, ActionEvent, ActionPresentation, ActionTargetEntity } from '../shared';
+import { GetActionsQuery } from './query';
+export interface GetActionResponse {
+    id: string;
+    /** Immutable handle; referenced by type attachments and rule CTAs. */
+    name: string;
+    label: string;
+    /** Free-form semantic tag (e.g. INSPECTION, CAPTURE, AUDIT). */
+    purpose?: string;
+    /** Form name — resolved to the current version at run time. */
+    form: string;
+    targetEntity: ActionTargetEntity;
+    presentation: ActionPresentation;
+    /** Absent = the generic submission label on history events. */
+    event?: ActionEvent;
+    /** Run on submit in author order (§4.2); absent = none. */
+    effects?: ActionEffect[];
+    meta?: IEntityMeta;
+}
+export interface GetActionsResponse {
+    query: GetActionsQuery | null;
+    total: number;
+    items: GetActionResponse[];
+}

package/dist/actions/get/response.js

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

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

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

package/dist/actions/index.d.ts

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

package/dist/actions/index.js

@@ -0,0 +1,21 @@
+"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("./shared"), exports);
+__exportStar(require("./get"), exports);
+__exportStar(require("./post"), exports);
+__exportStar(require("./[id]"), exports);
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

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

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

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

package/dist/actions/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/actions/post/index.js.map

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

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

@@ -0,0 +1,15 @@
+import { ActionEffect, ActionEvent, ActionPresentation, ActionTargetEntity } from '../shared';
+export interface PostActionRequest {
+    /** Immutable handle; referenced by type attachments and rule CTAs. */
+    name: string;
+    label: string;
+    purpose?: string;
+    /** Must name an existing, non-archived form. Required in v1. */
+    form: string;
+    targetEntity: ActionTargetEntity;
+    /** Defaults to { placement: ['entityDetailButton'] }. */
+    presentation?: ActionPresentation;
+    event?: ActionEvent;
+    /** Run on submit in author order; templates checked at save (§4.2). */
+    effects?: ActionEffect[];
+}

package/dist/actions/post/request.js

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

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

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

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

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

package/dist/actions/post/response.js

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

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

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

package/dist/actions/shared.d.ts

@@ -0,0 +1,51 @@
+/** The kind of entity an action runs against. */
+export declare type ActionTargetEntity = 'asset' | 'location';
+/**
+ * Where the client surfaces the action. Asset-target actions appear per the
+ * type attachment; location-target actions appear on every location (v1).
+ * `entityListButton` also surfaces the action inline on each row of the entity
+ * list / tree, not just on the detail page.
+ */
+export declare type ActionPlacement = 'entityDetailButton' | 'overflowMenu' | 'entityListButton';
+export interface ActionPresentation {
+    placement: ActionPlacement[];
+    icon?: string;
+}
+/**
+ * Display label stamped on the submission event (e.g. "INSPECTION_COMPLETED").
+ * Absent/null = the generic submission label. Never an event *type* — the
+ * stored type is always FormSubmitted.
+ */
+export interface ActionEvent {
+    label: string;
+}
+/** Severity of a raiseAlert effect — drives the client toast/result panel. */
+export declare const ACTION_ALERT_LEVELS: readonly ["success", "info", "warning", "error"];
+export declare type ActionAlertLevel = (typeof ACTION_ALERT_LEVELS)[number];
+/** One SES call carries all of a sendMessage effect's recipients (§4.2). */
+export declare const ACTION_EFFECT_MAX_RECIPIENTS = 50;
+/**
+ * Raise a resolved message into the submit response and the stored
+ * submission — client toast + result panel (§4.2). There is no persistent
+ * notification store in v1.
+ */
+export interface ActionAlertEffect {
+    type: 'raiseAlert';
+    level: ActionAlertLevel;
+    /** Template; {Field} placeholders resolve over the submit env at run time. */
+    message: string;
+}
+/**
+ * Email via SES, sent post-commit best-effort (§4.2) — at most once per
+ * capture; interpolated values are HTML-escaped into the body at send time.
+ */
+export interface ActionMessageEffect {
+    type: 'sendMessage';
+    /** Static recipient addresses (v1), capped at ACTION_EFFECT_MAX_RECIPIENTS. */
+    to: string[];
+    /** Template, interpolated like message (an SES field — structurally header-safe). */
+    subject: string;
+    message: string;
+}
+export declare type ActionEffect = ActionAlertEffect | ActionMessageEffect;
+export declare type ActionEffectType = ActionEffect['type'];

package/dist/actions/shared.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTION_EFFECT_MAX_RECIPIENTS = exports.ACTION_ALERT_LEVELS = void 0;
+/** Severity of a raiseAlert effect — drives the client toast/result panel. */
+exports.ACTION_ALERT_LEVELS = [
+    'success',
+    'info',
+    'warning',
+    'error',
+];
+/** One SES call carries all of a sendMessage effect's recipients (§4.2). */
+exports.ACTION_EFFECT_MAX_RECIPIENTS = 50;
+//# sourceMappingURL=shared.js.map

package/dist/actions/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/actions/shared.ts"],"names":[],"mappings":";;;AA4BA,8EAA8E;AACjE,QAAA,mBAAmB,GAAG;IACjC,SAAS;IACT,MAAM;IACN,SAAS;IACT,OAAO;CACC,CAAA;AAIV,4EAA4E;AAC/D,QAAA,4BAA4B,GAAG,EAAE,CAAA"}

package/dist/events/constants.d.ts

@@ -4,6 +4,7 @@ export declare type AssetCrudEventType = 'AssetCreated' | 'AssetUpdated' | 'Asse
 export declare type LocationCrudEventType = 'LocationCreated' | 'LocationUpdated' | 'LocationDeleted';
 export declare type ReaderCrudEventType = 'ReaderCreated' | 'ReaderUpdated' | 'ReaderDeleted';
 export declare type SnapshotCrudEventType = 'SnapshotCreated' | 'SnapshotDeleted';
+export declare type FormEventType = 'FormSubmitted' | 'FormSubmissionVoided';
 export declare type SlateEventType = 'ReaderArrived' | 'ReaderExited' | 'Arrived' | 'Moved' | 'Exited' | 'ReaderOnline' | 'ReaderOffline' | 'AssetDispatch';
-export declare type EventType = SlateEventType | AssetCrudEventType | LocationCrudEventType | ReaderCrudEventType | SnapshotCrudEventType | 'UserSearch' | 'WorkflowActionExecuted';
+export declare type EventType = SlateEventType | AssetCrudEventType | LocationCrudEventType | ReaderCrudEventType | SnapshotCrudEventType | FormEventType | 'UserSearch' | 'WorkflowActionExecuted';
 export declare const EVENT_TYPES: EventType[];

package/dist/events/constants.js

@@ -28,6 +28,8 @@ exports.EVENT_TYPES = [
     'ReaderDeleted',
     'SnapshotCreated',
     'SnapshotDeleted',
+    'FormSubmitted',
+    'FormSubmissionVoided',
     'UserSearch',
     'WorkflowActionExecuted',
 ];

package/dist/events/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/events/constants.ts"],"names":[],"mappings":";;;AACa,QAAA,qBAAqB,GAA0B;IAC1D,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;CACP,CAAA;AAsCY,QAAA,WAAW,GAAgB;IACtC,eAAe;IACf,cAAc;IACd,SAAS;IACT,OAAO;IACP,QAAQ;IACR,cAAc;IACd,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;IACZ,wBAAwB;CACzB,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/events/constants.ts"],"names":[],"mappings":";;;AACa,QAAA,qBAAqB,GAA0B;IAC1D,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;CACP,CAAA;AAyCY,QAAA,WAAW,GAAgB;IACtC,eAAe;IACf,cAAc;IACd,SAAS;IACT,OAAO;IACP,QAAQ;IACR,cAAc;IACd,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,sBAAsB;IACtB,YAAY;IACZ,wBAAwB;CACzB,CAAA"}

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

@@ -6,6 +6,7 @@ import { LocationType } from '../../locations/constants';
 import { GetSnapshotResponse } from '../../snapshots';
 import { ExecutedWorkflow } from '../../workflows';
 import { GetAssetResponse } from '../../assets';
+import { ISubmissionAssetEmbed, ISubmissionPayload, ISubmissionVoidPayload } from '../../submissions';
 export interface EventLocation {
     id?: string;
     name?: string;
@@ -85,6 +86,21 @@ export interface IWorkflowActionExecutedEvent extends IBaseEvent {
     type: 'WorkflowActionExecuted';
     workflow: ExecutedWorkflow;
 }
+/** Exactly one of `asset`/`location` is present — the run's target (§4.4). */
+export interface IFormSubmittedEvent extends IBaseEvent {
+    type: 'FormSubmitted';
+    asset?: ISubmissionAssetEmbed;
+    location?: IEmbeddedEntity;
+    user: IEmbeddedEntity;
+    submission: ISubmissionPayload;
+}
+export interface IFormSubmissionVoidedEvent extends IBaseEvent {
+    type: 'FormSubmissionVoided';
+    asset?: ISubmissionAssetEmbed;
+    location?: IEmbeddedEntity;
+    user: IEmbeddedEntity;
+    submission: ISubmissionVoidPayload;
+}
 export interface IArrivedEventAsset extends IEmbeddedEntity {
     dispatch?: boolean;
     userId?: string;
@@ -137,7 +153,7 @@ export interface IAssetDispatchEvent extends IBaseEvent {
     location?: AssetEventLocation;
     dispatchExpires: number;
 }
-export declare type GetEventResponse = IAssetCrudEvent | ILocationCrudEvent | IReaderCrudEvent | ISnapshotCrudEvent | IUserSearchEvent | IReaderArrivedEvent | IReaderExitedEvent | IArrivedEvent | IMovedEvent | IExitedEvent | IReaderOnlineEvent | IReaderOfflineEvent | IAssetDispatchEvent | IWorkflowActionExecutedEvent;
+export declare type GetEventResponse = IAssetCrudEvent | ILocationCrudEvent | IReaderCrudEvent | ISnapshotCrudEvent | IUserSearchEvent | IReaderArrivedEvent | IReaderExitedEvent | IArrivedEvent | IMovedEvent | IExitedEvent | IReaderOnlineEvent | IReaderOfflineEvent | IAssetDispatchEvent | IWorkflowActionExecutedEvent | IFormSubmittedEvent | IFormSubmissionVoidedEvent;
 export interface GetEventsResponse {
     query: GetEventsQuery | null;
     items: GetEventResponse[];

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":""}