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

package/dist/shared/attachments.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Good-to-Go action attachments — shared API contract shapes.
+ *
+ * A type offers actions to its assets by attaching them, inherited with
+ * field-binding mechanics (a keyed nearest-wins merge — FORMS.md §6): an
+ * authored row attaches an action, re-configures an inherited attachment, or
+ * detaches it for this type and its descendants.
+ */
+/** An authored attachment row on a type (a delta, keyed by action name). */
+export interface IActionAttachment {
+    /** Immutable handle of the action being attached, configured or detached. */
+    actionName: string;
+    /**
+     * Offer the action only while this expression is TRUE for the asset.
+     * Presentation, not authorization — submit does not re-check it.
+     */
+    visibleWhen?: string;
+    /** Suppress the inherited attachment from this type down. */
+    detach?: boolean;
+}
+/** A resolved attachment (own + inherited), on a type's `actionsAll`. */
+export interface IActionAttachmentAll {
+    actionName: string;
+    /** The action's display label, denormalised at resolve (refreshed on rename). */
+    label: string;
+    visibleWhen?: string;
+    /** Path of the type whose row attached it (provenance, like `fieldsAll`). */
+    typePath: string;
+}

package/dist/shared/attachments.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Good-to-Go action attachments — shared API contract shapes.
+ *
+ * A type offers actions to its assets by attaching them, inherited with
+ * field-binding mechanics (a keyed nearest-wins merge — FORMS.md §6): an
+ * authored row attaches an action, re-configures an inherited attachment, or
+ * detaches it for this type and its descendants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=attachments.js.map

package/dist/shared/attachments.js.map

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

package/dist/shared/index.d.ts

@@ -9,3 +9,5 @@ export * from './sort';
 export * from './timezone';
 export * from './timestamp';
 export * from './relative-date';
+export * from './readiness';
+export * from './attachments';

package/dist/shared/index.js

@@ -25,4 +25,6 @@ __exportStar(require("./sort"), exports);
 __exportStar(require("./timezone"), exports);
 __exportStar(require("./timestamp"), exports);
 __exportStar(require("./relative-date"), exports);
+__exportStar(require("./readiness"), exports);
+__exportStar(require("./attachments"), exports);
 //# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

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

package/dist/shared/readiness.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Good-to-Go (G2G) asset readiness — shared API contract shapes.
+ *
+ * Readiness rules are authored on types (and inherited like fields), evaluated
+ * against an asset's field values by the excelexp engine. A rule whose
+ * expression evaluates TRUE raises an issue at its level; an asset's overall
+ * `ready` is the worst level among its issues.
+ */
+/** Readiness severity: 1 = amber (warning), 2 = red (blocking). */
+export declare type ReadinessLevel = 1 | 2;
+/** Overall readiness: 0 = ready (green), else the worst issue level. */
+export declare type ReadinessState = 0 | ReadinessLevel;
+/**
+ * A rule's optional remediation tie to an action attached to the same type
+ * (FORMS.md §7): when the issue is shown, the UI offers `cta` → runs the
+ * action's form against the asset. Discoverable remediation, nothing more —
+ * the rule clears identically however the field changes.
+ */
+export interface IReadinessRuleAction {
+    /** Immutable handle of the linked action (must be in the type's `actionsAll`). */
+    actionName: string;
+    /** Button label the UI offers on the fired issue. */
+    cta: string;
+}
+/**
+ * An authored readiness rule on a type. `expression` is an excelexp boolean;
+ * when it evaluates TRUE the issue fires at `level` with `message` rendered as
+ * a `{FieldName}` template.
+ */
+export interface IReadinessRule {
+    level: ReadinessLevel;
+    expression: string;
+    message: string;
+    action?: IReadinessRuleAction;
+}
+/**
+ * A resolved rule (own + inherited), carrying the path of the type that
+ * authored it — mirrors how `IFieldDefinitionAll` carries `typePath`.
+ */
+export interface IReadinessRuleAll extends IReadinessRule {
+    /** Id of the type that authored the rule. */
+    typeId: string;
+    typePath: string;
+}
+/** The remediation link resolved onto a fired issue at evaluation time. */
+export interface IReadinessIssueAction extends IReadinessRuleAction {
+    /** The linked action's display label at evaluation time. */
+    label: string;
+}
+/** A fired readiness issue on an asset. */
+export interface IReadinessIssue {
+    /** The type that authored the fired rule. */
+    typeId: string;
+    /**
+     * The asset the issue came from: the asset itself for a leaf, or a member
+     * for a kit (kit issues are materialized copies of member issues).
+     */
+    assetId: string;
+    assetName: string;
+    level: ReadinessLevel;
+    /** Rendered message (the rule's `message` template with field values). */
+    reason: string;
+    /**
+     * Referenced DATE / number fields that had no value, causing the rule to
+     * fail closed. Present only when the issue fired on missing data.
+     */
+    missingFields?: string[];
+    /**
+     * The fired rule's remediation link, stamped at evaluation only while the
+     * action is still attached to the asset's type — so it can never dangle.
+     */
+    action?: IReadinessIssueAction;
+}
+/** Stored/returned readiness for an asset. */
+export interface IReadiness {
+    /** Worst level among `readyIssues`; 0 = ready (green). */
+    ready: ReadinessState;
+    readyIssues: IReadinessIssue[];
+    /** Epoch ms of the evaluation that produced this result. */
+    evaluatedAt?: number;
+}

package/dist/shared/readiness.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Good-to-Go (G2G) asset readiness — shared API contract shapes.
+ *
+ * Readiness rules are authored on types (and inherited like fields), evaluated
+ * against an asset's field values by the excelexp engine. A rule whose
+ * expression evaluates TRUE raises an issue at its level; an asset's overall
+ * `ready` is the worst level among its issues.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=readiness.js.map

package/dist/shared/readiness.js.map

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

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

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

package/dist/submissions/[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("./void/post"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/submissions/[id]/void/post.d.ts

@@ -0,0 +1,6 @@
+import { GetSubmissionResponse } from '../../shared';
+export interface PostSubmissionVoidRequest {
+    reason?: string;
+}
+/** The voided submission — the resource with its `voided` overlay applied. */
+export declare type PostSubmissionVoidResponse = GetSubmissionResponse;

package/dist/submissions/[id]/void/post.js

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

package/dist/submissions/[id]/void/post.js.map

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

package/dist/submissions/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Media content types a capture block accepts (§4.3) — images only, never
+ * SVG (active content). Enforced at upload-mint (the presigned POST pins the
+ * exact type into the policy) and re-checked at submit.
+ */
+export declare const SUBMISSION_MEDIA_CONTENT_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
+export declare type SubmissionMediaContentType = (typeof SUBMISSION_MEDIA_CONTENT_TYPES)[number];
+/**
+ * Upload size cap (§4.3), enforced by the presigned-POST policy's
+ * content-length-range condition and re-checked by HEAD at submit.
+ */
+export declare const SUBMISSION_MEDIA_MAX_BYTES: number;
+/** Most files a single mint request may ask for — the per-form capture-block cap. */
+export declare const SUBMISSION_UPLOADS_MAX_FILES = 10;

package/dist/submissions/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUBMISSION_UPLOADS_MAX_FILES = exports.SUBMISSION_MEDIA_MAX_BYTES = exports.SUBMISSION_MEDIA_CONTENT_TYPES = void 0;
+/**
+ * Media content types a capture block accepts (§4.3) — images only, never
+ * SVG (active content). Enforced at upload-mint (the presigned POST pins the
+ * exact type into the policy) and re-checked at submit.
+ */
+exports.SUBMISSION_MEDIA_CONTENT_TYPES = [
+    'image/png',
+    'image/jpeg',
+    'image/webp',
+];
+/**
+ * Upload size cap (§4.3), enforced by the presigned-POST policy's
+ * content-length-range condition and re-checked by HEAD at submit.
+ */
+exports.SUBMISSION_MEDIA_MAX_BYTES = 10 * 1024 * 1024;
+/** Most files a single mint request may ask for — the per-form capture-block cap. */
+exports.SUBMISSION_UPLOADS_MAX_FILES = 10;
+//# sourceMappingURL=constants.js.map

package/dist/submissions/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/submissions/constants.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,8BAA8B,GAAG;IAC5C,WAAW;IACX,YAAY;IACZ,YAAY;CACJ,CAAA;AAKV;;;GAGG;AACU,QAAA,0BAA0B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAE1D,qFAAqF;AACxE,QAAA,4BAA4B,GAAG,EAAE,CAAA"}

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

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

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

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

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

@@ -0,0 +1,14 @@
+import { SortOrders } from '../../shared';
+export interface SubmissionFilters {
+    /** Filter to submissions against these assets. */
+    assets?: string[];
+    /** Filter to submissions against these locations. */
+    locations?: string[];
+    timeFrom?: number;
+    timeTo?: number;
+}
+export interface GetSubmissionsQuery extends SubmissionFilters {
+    page?: number;
+    limit?: number;
+    sortOrder?: SortOrders;
+}

package/dist/submissions/get/query.js

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

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

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

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

@@ -0,0 +1,6 @@
+import { GetSubmissionResponse } from '../shared';
+import { GetSubmissionsQuery } from './query';
+export interface GetSubmissionsResponse {
+    query: GetSubmissionsQuery | null;
+    items: GetSubmissionResponse[];
+}

package/dist/submissions/get/response.js

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

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

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

package/dist/submissions/index.d.ts

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

package/dist/submissions/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("./uploads"), exports);
+//# sourceMappingURL=index.js.map

package/dist/submissions/index.js.map

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

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

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

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

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

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

@@ -0,0 +1,17 @@
+import { ActionTargetEntity } from '../../actions/shared';
+import { ISubmissionAttachment, ISubmissionFieldValue } from '../shared';
+export interface PostSubmissionRequest {
+    /** Client-minted idempotency key (ULID) — one per capture, reused on retry. */
+    clientReference: string;
+    actionName: string;
+    /** The form version pinned when the run opened. */
+    formName: string;
+    formVersion: number;
+    /** The run's target: a location run captures without write-back (§4.4). */
+    entity: ActionTargetEntity;
+    entityId: string;
+    /** Client fill time (ISO). */
+    capturedAt: string;
+    fieldValues?: ISubmissionFieldValue[];
+    attachments?: ISubmissionAttachment[];
+}

package/dist/submissions/post/request.js

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

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

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

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

@@ -0,0 +1,22 @@
+import { GetAssetResponse } from '../../assets';
+import { GetSubmissionResponse, ISubmissionEffect } from '../shared';
+/**
+ * Delivery status of one effect on a fresh submit (§4.2): a raiseAlert entry
+ * is 'raised' by being returned; sendMessage is 'sent' or 'failed' (the
+ * capture is committed either way — effects never roll it back). Replays
+ * carry the stored effects without statuses: effects are at-most-once and
+ * ran (if ever) on the original request.
+ */
+export declare type SubmissionEffectStatus = 'raised' | 'sent' | 'failed' | 'skipped';
+export interface PostSubmissionResponseEffect extends ISubmissionEffect {
+    status?: SubmissionEffectStatus;
+    /** The send failure detail when status is 'failed'. */
+    error?: string;
+}
+export interface PostSubmissionResponse extends GetSubmissionResponse {
+    /** True when this request replayed an already-recorded capture (§3.3 dedupe). */
+    replayed: boolean;
+    /** Fresh target readiness after recompute; absent when the target has gone. */
+    readiness?: GetAssetResponse['readiness'];
+    effects?: PostSubmissionResponseEffect[];
+}

package/dist/submissions/post/response.js

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

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

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

package/dist/submissions/shared.d.ts

@@ -0,0 +1,133 @@
+import { ActionAlertLevel, ActionEffectType, ActionTargetEntity } from '../actions/shared';
+import { IEmbeddedEntity } from '../shared';
+import { IFieldValue } from '../types';
+/**
+ * A value captured for one form field item, as transmitted at submit.
+ * Name-keyed (form items name global field definitions); exactly one value
+ * slot per entry — a multi-select (CHECKBOXES) sends one entry per selected
+ * option, and an unanswered field sends no entry at all.
+ */
+export interface ISubmissionFieldValue {
+    name: string;
+    valueString?: string;
+    valueInteger?: number;
+    valueDecimal?: number;
+    valueBoolean?: boolean;
+    /** DATE wire format: YYYY-MM-DD. */
+    valueDate?: string;
+    valueDateTime?: Date | string;
+    /** Tolerated on input for round-trips; stripped — identity resolves by name. */
+    id?: string;
+    /** Tolerated on input for round-trips; stripped — re-derived server-side. */
+    computed?: boolean;
+}
+/** A captured signature/photo reference (uploaded via B4's presigned POST). */
+export interface ISubmissionAttachment {
+    /** Names a capture block of the pinned form version — distinct per row. */
+    blockName: string;
+    fileId: string;
+    contentType: string;
+}
+/**
+ * A write-back audit value in stored format: DATE as a YYYYMMDD integer,
+ * DATETIME as a Date, CHECKBOXES as the full option array.
+ */
+export declare type SubmissionWriteBackValue = string | number | boolean | string[];
+/** One write-back row's outcome — applied with values, or skipped with why. */
+export interface ISubmissionWriteBackAudit {
+    to: string;
+    appliedValue?: SubmissionWriteBackValue;
+    /** The asset-level value the write replaced; absent when the field had none. */
+    previousValue?: SubmissionWriteBackValue;
+    /** Present on expression rows — the formula that produced the value. */
+    expression?: string;
+    skipped?: true;
+    reason?: string;
+}
+/**
+ * One effect outcome as stored on the event (§4.2): resolved content for an
+ * effect that ran — messages interpolated over the submit env — or a skip
+ * audit when the action's write authority was gone (§3.2). Delivery status
+ * never persists: the event commits before effects run (see the POST
+ * response's status overlay).
+ */
+export interface ISubmissionEffect {
+    type: ActionEffectType;
+    /** raiseAlert severity. */
+    level?: ActionAlertLevel;
+    /** Resolved message (missing references render as "(not set)"). */
+    message?: string;
+    /** sendMessage recipients. */
+    to?: string[];
+    /** sendMessage resolved subject. */
+    subject?: string;
+    skipped?: true;
+    reason?: string;
+}
+export interface ISubmissionContext {
+    entity: ActionTargetEntity;
+    entityId: string;
+    /** The asset's type at submit — never present on location runs (§4.4). */
+    typeId?: string;
+    /** The asset's type path at submit — never present on location runs (§4.4). */
+    typePath?: string;
+}
+/** The asset a submission ran against — identity plus its type path, both
+ * frozen at submit (later type renames never rewrite event history). */
+export interface ISubmissionAssetEmbed extends IEmbeddedEntity {
+    typePath?: string;
+}
+/** Overlay from an appended FormSubmissionVoided event. */
+export interface ISubmissionVoided {
+    eventId: string;
+    timestamp: number;
+    user: IEmbeddedEntity;
+    reason?: string;
+}
+/**
+ * The submission payload as stored on the FormSubmitted event — everything
+ * below the event envelope. Shared by the submission resource and the
+ * events-feed member.
+ */
+export interface ISubmissionPayload {
+    /** Client-minted idempotency key (ULID). */
+    clientReference: string;
+    /** Server-computed canonical hash of the capture (excludes attachment fileIds). */
+    fingerprint: string;
+    /** Absent when the action had been deleted by the time the capture drained. */
+    actionId?: string;
+    actionName: string;
+    actionLabel?: string;
+    formId: string;
+    formName: string;
+    formVersion: number;
+    /** Display label from the action's `event` config. */
+    eventLabel?: string;
+    context: ISubmissionContext;
+    /** Client fill time (ISO) — differs from the event timestamp under offline drain. */
+    capturedAt: string;
+    fieldValues: IFieldValue[];
+    attachments?: ISubmissionAttachment[];
+    writeBack?: ISubmissionWriteBackAudit[];
+    effects?: ISubmissionEffect[];
+}
+/** The payload of a FormSubmissionVoided event. */
+export interface ISubmissionVoidPayload {
+    /** The FormSubmitted event id this void applies to. */
+    original: string;
+    actionName: string;
+    actionLabel?: string;
+    formName: string;
+    formVersion: number;
+    reason?: string;
+}
+/** The submission resource — a parsed FormSubmitted event. Exactly one of
+ * `asset`/`location` is present, matching the run's target entity. */
+export interface GetSubmissionResponse extends ISubmissionPayload {
+    id: string;
+    timestamp: number;
+    asset?: ISubmissionAssetEmbed;
+    location?: IEmbeddedEntity;
+    user: IEmbeddedEntity;
+    voided?: ISubmissionVoided;
+}

package/dist/submissions/shared.js

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

package/dist/submissions/shared.js.map

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

package/dist/submissions/uploads/[fileId]/get.d.ts

@@ -0,0 +1,11 @@
+/** GET /submissions/uploads/{fileId} — path parameters. */
+export interface SubmissionUploadPath {
+    fileId: string;
+}
+/**
+ * A short-lived presigned download for a committed object under the caller's
+ * own org — the key derives from the authenticated org, never from input.
+ */
+export interface GetSubmissionUploadResponse {
+    url: string;
+}

package/dist/submissions/uploads/[fileId]/get.js

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

package/dist/submissions/uploads/[fileId]/get.js.map

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

package/dist/submissions/uploads/[fileId]/index.d.ts

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

package/dist/submissions/uploads/[fileId]/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("./get"), exports);
+//# sourceMappingURL=index.js.map

package/dist/submissions/uploads/[fileId]/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/submissions/uploads/[fileId]/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAqB"}

package/dist/submissions/uploads/index.d.ts

@@ -0,0 +1,2 @@
+export * from './post';
+export * from './[fileId]';