@fias/arche-sdk 2.11.0 → 2.13.0

package/dist/panels.js.map

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

package/dist/panels.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=panels.test.d.ts.map

package/dist/panels.test.d.ts.map

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

package/dist/panels.test.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const panels_1 = require("./panels");
+const panel = {
+    id: 'reward-default',
+    title: 'Game over',
+    elements: [
+        { kind: 'text', text: 'Score: {score}' },
+        { kind: 'conditionalText', text: 'New high score!', showIf: 'isRecord' },
+        { kind: 'text', text: 'Base Reward:', joinNext: true },
+        { kind: 'slottedItems', slot: 'base' },
+        { kind: 'button', label: 'Play again', action: 'emit:restart' },
+    ],
+};
+describe('validatePanelCatalog', () => {
+    it('accepts a well-formed catalog with a theme', () => {
+        const result = (0, panels_1.validatePanelCatalog)({
+            theme: { bg: '#F6EAD2', font: "'YoungSerif', Georgia, serif", amountFormat: '×{n}' },
+            panels: [panel],
+        });
+        expect(result).toEqual({ ok: true, issues: [] });
+    });
+    it('reports every problem at once, each with its path', () => {
+        // A validator that stops at the first issue turns one authoring pass into
+        // several — the caller is usually showing these in a form.
+        const result = (0, panels_1.validatePanelCatalog)({
+            panels: [
+                { ...panel, id: 'Reward Default' },
+                { ...panel, elements: [{ kind: 'confetti' }] },
+            ],
+        });
+        expect(result.ok).toBe(false);
+        expect(result.issues).toHaveLength(2);
+        expect(result.issues[0]).toContain('catalog.panels[0].id');
+        expect(result.issues[1]).toContain('catalog.panels[1].elements[0].kind');
+        expect(result.issues[1]).toContain('confetti');
+    });
+    it('rejects duplicate panel ids — they key dedupe, telemetry and render output', () => {
+        const result = (0, panels_1.validatePanelCatalog)({ panels: [panel, { ...panel }] });
+        expect(result.ok).toBe(false);
+        expect(result.issues[0]).toContain('duplicate panel id "reward-default"');
+    });
+    it('rejects unknown top-level fields rather than dropping them silently', () => {
+        const result = (0, panels_1.validatePanelCatalog)({ panels: [panel], schemaVersion: 1 });
+        expect(result.ok).toBe(false);
+        expect(result.issues[0]).toContain('unknown field "schemaVersion"');
+    });
+    it('rejects a non-object and a missing panels array with a usable message', () => {
+        expect((0, panels_1.validatePanelCatalog)(null).issues[0]).toContain('expected an object');
+        expect((0, panels_1.validatePanelCatalog)({ panels: 'nope' }).issues[0]).toContain('expected an array');
+    });
+});
+describe('validatePanelDefinition', () => {
+    it('caps the element list', () => {
+        const elements = Array.from({ length: panels_1.PANEL_MAX_ELEMENTS + 1 }, () => ({
+            kind: 'text',
+            text: 'x',
+        }));
+        const result = (0, panels_1.validatePanelDefinition)({ ...panel, elements });
+        expect(result.ok).toBe(false);
+        expect(result.issues[0]).toContain(`more than ${panels_1.PANEL_MAX_ELEMENTS} elements`);
+    });
+    it('requires at least one element', () => {
+        expect((0, panels_1.validatePanelDefinition)({ ...panel, elements: [] }).ok).toBe(false);
+    });
+    it('rejects an unknown field on a known element kind', () => {
+        // Mass-assignment's cosmetic cousin: a field nobody reads looks like it works.
+        const result = (0, panels_1.validatePanelDefinition)({
+            ...panel,
+            elements: [{ kind: 'text', text: 'x', color: 'red' }],
+        });
+        expect(result.ok).toBe(false);
+        expect(result.issues[0]).toContain('unknown field "color"');
+    });
+    it.each([
+        ['open_url:javascript:alert(1)', 'a javascript: URL'],
+        ['open_url:http://insecure.example', 'plain http'],
+        ['open_url://protocol-relative.example', 'protocol-relative'],
+        ['open_arche:arc_short', 'a malformed arche id'],
+        ['exfiltrate', 'a form outside the namespace'],
+    ])('rejects button action %p (%s)', (action, _why) => {
+        const result = (0, panels_1.validatePanelDefinition)({
+            ...panel,
+            elements: [{ kind: 'button', label: 'Go', action }],
+        });
+        expect(result.ok).toBe(false);
+    });
+    it('rejects an image key outside the presignable roots', () => {
+        // Not pedantry: the platform only presigns these roots, so any other key is a
+        // permanently broken image rather than an unusual one.
+        const result = (0, panels_1.validatePanelDefinition)({
+            ...panel,
+            elements: [{ kind: 'image', imageKey: 'https://cdn.example/x.png' }],
+        });
+        expect(result.ok).toBe(false);
+        expect(result.issues[0]).toContain('dfe-icons');
+    });
+    it.each(['score > 100', '!isRecord', 'a && b', 'is-record'])('rejects showIf %p — a value NAME, never an expression', (showIf) => {
+        const result = (0, panels_1.validatePanelDefinition)({
+            ...panel,
+            elements: [{ kind: 'conditionalText', text: 'x', showIf }],
+        });
+        expect(result.ok).toBe(false);
+    });
+});
+describe('validatePanelTheme', () => {
+    it('accepts a partial theme', () => {
+        expect((0, panels_1.validatePanelTheme)({ accent: '#D8B24A' })).toEqual({ ok: true, issues: [] });
+    });
+    it.each([
+        ['url(https://evil.example/p.png)', 'an outbound request from every panel you draw'],
+        ['var(--host-bg)', 'reaching into the host’s variables'],
+        ['#fff; position: fixed', 'escaping the declaration'],
+    ])('rejects colour %p (%s)', (bg, _why) => {
+        expect((0, panels_1.validatePanelTheme)({ bg }).ok).toBe(false);
+    });
+    it('requires {n} in amountFormat — otherwise every quantity silently vanishes', () => {
+        expect((0, panels_1.validatePanelTheme)({ amountFormat: '×' }).ok).toBe(false);
+        expect((0, panels_1.validatePanelTheme)({ amountFormat: '×{n}' }).ok).toBe(true);
+    });
+    it('names the offending field, since a theme is a flat bag of look-alike strings', () => {
+        const result = (0, panels_1.validatePanelTheme)({ radius: '100vw' });
+        expect(result.issues[0]).toContain('theme.radius');
+        expect(result.issues[0]).toContain('px, rem or em');
+    });
+});
+//# sourceMappingURL=panels.test.js.map

package/dist/panels.test.js.map

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

package/dist/types.d.ts

@@ -826,10 +826,183 @@ export interface ArcheAssetsApi {
     /** Refresh the signed URL for a single asset. */
     getUrl: (assetId: string) => Promise<ArcheAsset>;
 }
+/** Where an asset sits in the moderation lifecycle, from the author's view. */
+export type CommunityAssetStatus = 
+/** Awaiting a verdict. Nobody else can see it yet. */
+'pending_moderation'
+/** Live — every user of this arche can see it. */
+ | 'published'
+/** Moderation said no. Terminal; `moderationReason` says roughly why. */
+ | 'rejected'
+/** Held for a human moderator. */
+ | 'needs_review'
+/** The author removed it. */
+ | 'unpublished'
+/** An admin removed it. */
+ | 'taken_down';
+export interface CommunityAsset {
+    assetId: string;
+    archeId: string;
+    title: string | null;
+    caption: string | null;
+    tags: string[];
+    /** Opt-in display credit chosen by the publisher; null when anonymous. */
+    attributionName: string | null;
+    /** Always `image/png` — publishing normalizes to a canonical PNG. */
+    contentType: string;
+    sizeBytes: number;
+    /** ISO timestamp, or null while it is not published. */
+    publishedAt: string | null;
+    /** Present only on YOUR OWN assets (`listMine`, and `get` when you published it). */
+    status?: CommunityAssetStatus;
+    /** Coarse reason a rejected asset was refused. Own assets only. */
+    moderationReason?: string | null;
+    /** Whatever `clientRef` you passed at publish time. Own assets only. */
+    clientRef?: string | null;
+    createdAt?: string;
+}
+/** A short-lived signed URL for one published asset. Render with `<img src>`. */
+export interface CommunityAssetUrl {
+    assetId: string;
+    url: string;
+    /**
+     * Epoch MILLISECONDS (the Vault convention — note `ArcheAsset.expiresAt`
+     * above is unix SECONDS). URLs last ~5 minutes; the hook refreshes them for
+     * you, so prefer calling `getUrls` again over caching this yourself.
+     */
+    expiresAt: number;
+}
+export interface CommunityAssetPublishInput {
+    /**
+     * The `fileId` from a `useImageGeneration()` result — the image must be one
+     * YOU created or uploaded, in your own Fias files.
+     *
+     * Required here, while `ImageGenerationResult.fileId` is OPTIONAL (it is
+     * absent if the generated image was never written to the user's files). That
+     * mismatch is deliberate: TypeScript makes you handle the missing case rather
+     * than forwarding `undefined` and discovering it as a runtime
+     * `FILE_NOT_FOUND`. Guard before publishing:
+     *
+     * ```ts
+     * const image = await generate({ prompt });
+     * if (!image.fileId) return;  // nothing saved — nothing to publish
+     * await publish({ fileId: image.fileId });
+     * ```
+     */
+    fileId: string;
+    title?: string | null;
+    caption?: string | null;
+    /** Up to 16, each ≤64 chars. The only filterable dimension in `listCommunity`. */
+    tags?: string[];
+    /** Your own correlation handle (e.g. `"page-3"`), echoed back per item. */
+    clientRef?: string | null;
+    /** Opt-in display credit. Screened like every other author-supplied string. */
+    attributionName?: string | null;
+}
+/**
+ * One item's outcome from `publishMany`. Items succeed or fail INDEPENDENTLY —
+ * a single rejected page must not sink a whole book — and retrying only the
+ * failures is safe: publishing the same bytes twice returns the first result
+ * rather than creating a duplicate.
+ */
+export type CommunityAssetPublishResult = {
+    clientRef: string | null;
+    asset: CommunityAsset;
+    error?: undefined;
+} | {
+    clientRef: string | null;
+    asset?: undefined;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export interface CommunityAssetListOptions {
+    /** 1..100. Default 30. */
+    limit?: number;
+    /** `nextCursor` from the previous page. */
+    cursor?: string | null;
+    /** Return only assets carrying this tag. `listCommunity` only. */
+    tag?: string | null;
+}
+export interface CommunityAssetListResult {
+    assets: CommunityAsset[];
+    /** Null when there are no more pages. */
+    nextCursor: string | null;
+}
+export type CommunityAssetReportReason = 'sexual' | 'violence' | 'hate' | 'illegal' | 'copyright' | 'spam' | 'other';
+export interface CommunityAssetsApi {
+    /**
+     * Publish one image you created so other users of this arche can see it.
+     * Free. It becomes visible only after moderation — expect
+     * `status: 'pending_moderation'` back, not `'published'`.
+     */
+    publish: (input: CommunityAssetPublishInput) => Promise<CommunityAsset>;
+    /** Publish up to 20 at once; each item succeeds or fails on its own. */
+    publishMany: (items: CommunityAssetPublishInput[]) => Promise<CommunityAssetPublishResult[]>;
+    /** Remove one of YOUR published assets. */
+    unpublish: (assetId: string) => Promise<CommunityAsset>;
+    /** Your own publications here, including moderation status. */
+    listMine: (options?: CommunityAssetListOptions) => Promise<CommunityAssetListResult>;
+    /** Browse what this arche's community has published. */
+    listCommunity: (options?: CommunityAssetListOptions) => Promise<CommunityAssetListResult>;
+    /** Metadata for one asset. */
+    get: (assetId: string) => Promise<CommunityAsset>;
+    /** A signed URL for one asset. Cached and auto-refreshed by the hook. */
+    getUrl: (assetId: string) => Promise<CommunityAssetUrl>;
+    /**
+     * Signed URLs for up to 50 assets in ONE call. Use this for a gallery or a
+     * multi-page book — 13 separate `getUrl` calls against a 5-minute TTL is the
+     * shape this exists to avoid. Ids that are gone or not yet published are
+     * simply omitted from the result rather than throwing.
+     */
+    getUrls: (assetIds: string[]) => Promise<CommunityAssetUrl[]>;
+    /** Report a published asset for moderator review. */
+    report: (assetId: string, reason: CommunityAssetReportReason, details?: string) => Promise<{
+        reportId: string;
+        status: string;
+    }>;
+}
 /**
  * Message types sent from the plugin iframe to the parent frame.
  */
-export type PluginToHostMessageType = 'ready' | 'resize' | 'toast' | 'get_user' | 'get_theme' | 'storage_read' | 'storage_write' | 'storage_list' | 'storage_delete' | 'entity_invoke' | 'client_entity_invoke' | 'image_generate' | 'entities_list_image' | 'audio_generate' | 'surface_invoke' | 'navigate' | 'open_arche' | 'data_create_collection' | 'data_list_collections' | 'data_delete_collection' | 'data_put' | 'data_get' | 'data_query' | 'data_delete' | 'data_batch' | 'data_search' | 'workspace_create' | 'workspace_list' | 'workspace_get' | 'workspace_archive' | 'workspace_list_members' | 'workspace_add_member' | 'workspace_update_member' | 'workspace_remove_member' | 'store_get_products' | 'store_purchase' | 'store_get_entitlements' | 'store_get_purchase_history' | 'store_restore' | 'store_cancel_subscription' | 'vault_documents_list' | 'vault_documents_read' | 'vault_documents_read_many' | 'vault_documents_download_url' | 'vault_documents_get_urls' | 'vault_documents_search' | 'vault_documents_write' | 'vault_documents_update' | 'vault_documents_delete' | 'vault_documents_attach' | 'vault_documents_detach' | 'vault_documents_upload_init' | 'vault_documents_upload_finalize' | 'vault_documents_upload' | 'vault_documents_pick' | 'arche_assets_list' | 'arche_assets_index' | 'arche_assets_get_url' | 'preview_state' | 'subscription_unsubscribe';
+export type PluginToHostMessageType = 'ready' | 'resize' | 'toast' | 'get_user' | 'get_theme' | 'storage_read' | 'storage_write' | 'storage_list' | 'storage_delete' | 'entity_invoke' | 'client_entity_invoke' | 'image_generate' | 'entities_list_image' | 'audio_generate' | 'surface_invoke' | 'navigate' | 'open_arche' | 'data_create_collection' | 'data_list_collections' | 'data_delete_collection' | 'data_put' | 'data_get' | 'data_query' | 'data_delete' | 'data_batch' | 'data_search' | 'workspace_create' | 'workspace_list' | 'workspace_get' | 'workspace_archive' | 'workspace_list_members' | 'workspace_add_member' | 'workspace_update_member' | 'workspace_remove_member' | 'store_get_products' | 'store_purchase' | 'store_get_entitlements' | 'store_get_purchase_history' | 'store_restore' | 'store_cancel_subscription' | 'vault_documents_list' | 'vault_documents_read' | 'vault_documents_read_many' | 'vault_documents_download_url' | 'vault_documents_get_urls' | 'vault_documents_search' | 'vault_documents_write' | 'vault_documents_update' | 'vault_documents_delete' | 'vault_documents_attach' | 'vault_documents_detach' | 'vault_documents_upload_init' | 'vault_documents_upload_finalize' | 'vault_documents_upload' | 'vault_documents_pick' | 'arche_assets_list' | 'arche_assets_index' | 'arche_assets_get_url' | 'preview_state' | 'subscription_unsubscribe' | 'ai_actions_declare' | 'ai_state' | 'ai_action_result';
+/**
+ * One Fias AI action a plugin declares — what the platform assistant may do
+ * in this plugin's UI while it is open. Mirrors the platform's
+ * `PluginManifestAiAction` (@fias/db-types): the manifest `fiasAI` block
+ * declares actions statically (fixed at publish, reviewable); this same shape
+ * declares them at runtime via `useFiasAIActions` (TRUSTED arches only).
+ */
+export interface FiasAIActionDescriptor {
+    /** Lowercase snake_case, ≤100 chars — becomes the assistant's `ui__<id>` tool name. */
+    id: string;
+    /** Written FOR the model: when to use it, what it does. ≤1000 chars. */
+    description: string;
+    /** JSON Schema for the action's params ({"type":"object","properties":{}} for none). */
+    parameterSchema: Record<string, unknown>;
+    /** Escalate to an explicit in-app approval before the action runs. Escalate-only — there is no way to skip a confirmation the platform requires. */
+    requiresConfirmation?: boolean;
+    category?: string;
+    /**
+     * Host-side visibility precondition: the action is offered to the assistant
+     * only while every named key of the last `state` snapshot equals the given
+     * value (e.g. `{ documentOpen: true }`). Equality over booleans/strings
+     * only. Filtering is presentation, not enforcement — the `onAction` handler
+     * must still re-check its own preconditions and throw when unmet.
+     */
+    availableWhen?: Record<string, boolean | string>;
+}
+/** A runtime Fias AI declaration (`useFiasAIActions`). */
+export interface FiasAIActionsDeclaration {
+    /**
+     * Capability summary the assistant always sees while the plugin is open —
+     * cover availableWhen-hidden actions too ("once a document is open, …") so
+     * a filtered-out verb reads as a precondition, not a missing capability.
+     */
+    description: string;
+    actions: FiasAIActionDescriptor[];
+}
 /**
  * Why a realtime subscription ended (ADR-012 Phase M4). Closed union so
  * hooks can distinguish terminal endings (`authorization_revoked`,
@@ -870,7 +1043,7 @@ export interface StepNavigationOptions {
 /**
  * Message types sent from the parent frame to the plugin iframe.
  */
-export type HostToPluginMessageType = 'init' | 'response' | 'theme_update' | 'navigate_update' | 'step_navigate' | 'stream_token' | 'preview_state_capture' | 'preview_state_restore' | 'subscription_event' | 'subscription_ended';
+export type HostToPluginMessageType = 'init' | 'response' | 'theme_update' | 'navigate_update' | 'step_navigate' | 'stream_token' | 'preview_state_capture' | 'preview_state_restore' | 'subscription_event' | 'subscription_ended' | 'ai_action_dispatch';
 /**
  * Base message structure for all bridge communication.
  */
@@ -986,6 +1159,11 @@ export interface DataStoreCollection {
     readMinRole?: WorkspaceRole | null;
     /** Who may write (shared-scoped only): see {@link DataStoreWritePolicy}. */
     writePolicy?: DataStoreWritePolicy;
+    /**
+     * Server-enforced constraints (ADR-014); null/absent = none. Returned so a
+     * plugin can VERIFY its declared constraints took effect.
+     */
+    constraints?: DataStoreCollectionConstraints | null;
     createdAt: string;
 }
 /**
@@ -1006,6 +1184,109 @@ export interface DataStoreCollection {
  * loosening is refused.
  */
 export type DataStoreWritePolicy = 'any' | 'author' | 'collaborators';
+/** Numeric comparison operator used by constraints and preconditions. */
+export type DataStoreBoundOp = 'eq' | 'ne' | 'lt' | 'lte' | 'gt' | 'gte';
+/**
+ * One declared numeric bound on a written document: `field <op> bound`, where
+ * the bound is a constant (`value`) or a sibling numeric field on the SAME
+ * document (`valueField`) — exactly one of the two. Skipped when `field` is
+ * absent; fails closed when the bound cannot be evaluated.
+ */
+export interface DataStoreFieldBound {
+    /** Dot-notation path into the document data. */
+    field: string;
+    op: DataStoreBoundOp;
+    /** Constant bound. Exactly one of `value` / `valueField`. */
+    value?: number;
+    /** Sibling field on the same document to compare against. */
+    valueField?: string;
+}
+/**
+ * Server-enforced per-collection constraints, declared at collection creation
+ * (or in the manifest `collections` block) and checked by the platform on
+ * EVERY write — a client cannot bypass them. Tighten-only after creation:
+ * entries can be added (by a collaborator), never removed or changed.
+ *
+ *   - `appendOnly` — the collection is a ledger: no overwrites, no deletes.
+ *   - `nonNegative` — named numeric fields must be ≥ 0 when present.
+ *   - `fieldBounds` — numeric bounds, e.g. `issued lte authorized`.
+ *   - `immutableFields` — set-once fields an overwrite must carry unchanged.
+ *
+ * Violations reject the write with code `CONSTRAINT_VIOLATION`.
+ */
+export interface DataStoreCollectionConstraints {
+    appendOnly?: true;
+    nonNegative?: string[];
+    fieldBounds?: DataStoreFieldBound[];
+    immutableFields?: string[];
+}
+/**
+ * One precondition on an atomic {@link FiasDataStoreApi.batch}: evaluated by
+ * the server against current committed state, inside the batch transaction,
+ * BEFORE any operation applies. Any failure rejects the entire batch —
+ * `version` failures with code `VERSION_CONFLICT`, the rest with
+ * `PRECONDITION_FAILED`. May reference documents the batch does not write.
+ *
+ *   - `version` — compare-and-swap: the document must exist at exactly this
+ *     version (see {@link DataStoreDocument.version}). THE tool for
+ *     read-compute-write flows: assert the versions of every document the
+ *     client math depended on, and a concurrent writer can no longer race you.
+ *   - `absent` — create-once / uniqueness.
+ *   - `exists` — referential integrity.
+ *   - `field_bound` — numeric guard on current state, e.g. `status eq 0`.
+ */
+export type DataStoreBatchPrecondition = {
+    kind: 'version';
+    collection: string;
+    key: string;
+    workspaceId?: string;
+    version: number;
+} | {
+    kind: 'absent';
+    collection: string;
+    key: string;
+    workspaceId?: string;
+} | {
+    kind: 'exists';
+    collection: string;
+    key: string;
+    workspaceId?: string;
+} | {
+    kind: 'field_bound';
+    collection: string;
+    key: string;
+    workspaceId?: string;
+    field: string;
+    op: DataStoreBoundOp;
+    value: number;
+};
+/** Options for {@link FiasDataStoreApi.batch}. */
+export interface DataStoreBatchOptions {
+    /** ADR-014 preconditions, all-or-nothing with the batch (max 10). */
+    preconditions?: DataStoreBatchPrecondition[];
+}
+/**
+ * Result of {@link FiasDataStoreApi.batch}. `written` aligns 1:1 with the
+ * batch's `put` operations in operation order, carrying each document's
+ * post-write {@link DataStoreDocument.version} — assert these in the next
+ * batch's `version` preconditions to chain race-free writes without a
+ * read-back. Absent on platforms without conditional-write support.
+ */
+export interface DataStoreBatchResult {
+    written?: {
+        key: string;
+        version?: number;
+    }[];
+}
+/**
+ * Result of {@link FiasDataStoreApi.put}, carrying the document's post-write
+ * {@link DataStoreDocument.version} — assert it in the next batch's `version`
+ * precondition to chain race-free writes without a read-back. Absent on
+ * platforms without conditional-write support.
+ */
+export interface DataStorePutResult {
+    version?: number;
+}
 /**
  * A document returned from the data store.
  */
@@ -1013,6 +1294,14 @@ export interface DataStoreDocument<T = Record<string, unknown>> {
     key: string;
     data: T;
     updatedAt: string;
+    /**
+     * Server-owned optimistic-concurrency counter (ADR-014): 1 on create,
+     * incremented on every successful put, never client-writable. Assert it in
+     * a batch `version` precondition to make read-compute-write race-free.
+     * Requires a platform version with conditional-write support; absent
+     * otherwise.
+     */
+    version?: number;
     /**
      * Present on SHARED-scope documents only: whether the document's last writer
      * is an active arche collaborator (owner/publisher). The trust signal for
@@ -1077,6 +1366,13 @@ export interface DataStoreSearchMatch<T = Record<string, unknown>> {
     data: T;
     /** Cosine similarity in [0, 1]; higher is closer. */
     similarity: number;
+    /**
+     * Post-write CAS counter (ADR-014) — see {@link DataStoreDocument.version}.
+     * Carried on matches so a document located by search can be asserted in a
+     * follow-up `version` precondition without a second read. Absent on
+     * platforms without conditional-write support.
+     */
+    version?: number;
     /** Present on shared-scope matches: see {@link DataStoreDocument.authoredByCollaborator}. */
     authoredByCollaborator?: boolean;
 }
@@ -1108,6 +1404,8 @@ export interface FiasDataStoreApi {
         readMinRole?: WorkspaceRole;
         /** Shared-scoped only: who may write. See {@link DataStoreWritePolicy}. */
         writePolicy?: DataStoreWritePolicy;
+        /** Server-enforced constraints (ADR-014). Tighten-only after creation. */
+        constraints?: DataStoreCollectionConstraints;
     }) => Promise<DataStoreCollection>;
     /** List all collections for this arche. */
     listCollections: () => Promise<DataStoreCollection[]>;
@@ -1117,8 +1415,11 @@ export interface FiasDataStoreApi {
      * Write (upsert) a document by key. For a `workspace`-scoped collection pass
      * `{ workspaceId }`; the caller must be an active member with write access
      * (owner/admin/member). See {@link FiasWorkspacesApi}.
+     *
+     * Resolves with the document's post-write `version` (ADR-014) so a follow-up
+     * conditional batch can assert it without a read-back.
      */
-    put: <T extends Record<string, unknown> = Record<string, unknown>>(collection: string, key: string, data: T, options?: DataStoreScopeOptions) => Promise<void>;
+    put: <T extends Record<string, unknown> = Record<string, unknown>>(collection: string, key: string, data: T, options?: DataStoreScopeOptions) => Promise<DataStorePutResult>;
     /** Get a document by key. Returns null if not found. Pass `{ workspaceId }`
      *  for a workspace-scoped collection. */
     get: <T extends Record<string, unknown> = Record<string, unknown>>(collection: string, key: string, options?: DataStoreScopeOptions) => Promise<T | null>;
@@ -1150,8 +1451,14 @@ export interface FiasDataStoreApi {
      * updating a running total together) where a sequence of separate calls could
      * leave a half-applied state. A batch may span collections and scopes; any
      * failure (bad key, role denial, quota) rolls the whole batch back.
+     *
+     * Pass `options.preconditions` (ADR-014) to make the batch CONDITIONAL:
+     * every precondition is evaluated server-side against committed state before
+     * any op applies — assert the `version` of each document your computation
+     * read, and a concurrent writer can no longer race you. The result carries
+     * each put's post-write version (see {@link DataStoreBatchResult}).
      */
-    batch: (operations: DataStoreBatchOp[]) => Promise<void>;
+    batch: (operations: DataStoreBatchOp[], options?: DataStoreBatchOptions) => Promise<DataStoreBatchResult>;
 }
 /** Per-call scope options for workspace-scoped Data Store documents. */
 export interface DataStoreScopeOptions {