@antelopejs/interface-database 0.1.6 → 0.1.8

package/dist/schema.d.ts

@@ -1,124 +1,7 @@
 import { RegisteringProxy } from "@antelopejs/interface-core";
-import { Query } from "./query";
-import { Table } from "./selection";
-import { StagedObject } from "./common";
-/**
- * Secondary table index definition
- */
-export interface IndexDefinition {
-    /**
-     * Fields to use for compound indexes
-     */
-    fields?: string[];
-    /**
-     * Whether or not this is a multi index
-     */
-    multi?: boolean;
-}
-export type StringFieldType = string | Array<StringFieldType> | {
-    [subfield: string]: StringFieldType;
-};
-interface IoTsCodec {
-    readonly _A: unknown;
-    readonly _O: unknown;
-    readonly _I: unknown;
-    readonly name: string;
-    is(u: unknown): boolean;
-    encode(a: never): unknown;
-    decode(i: unknown): unknown;
-}
-export type FieldType = StringFieldType | IoTsCodec;
-/**
- * Schema table definition
- */
-export interface TableDefinition {
-    /**
-     * Field names and their data types
-     */
-    fields: Record<string, FieldType>;
-    /**
-     * List of secondary indexes
-     */
-    indexes: Record<string, IndexDefinition>;
-}
-/**
- * Table names and their definitions
- */
-export interface SchemaDefinition {
-    [tableName: string]: TableDefinition;
-}
-/**
- * Sentinel instance id meaning "operate across all instances of the schema".
- */
-export declare const CROSS_INSTANCE: unique symbol;
-/**
- * Instance identifier accepted by {@link Schema.instance}.
- */
-export type InstanceId = string | typeof CROSS_INSTANCE;
+import { Schema as StagedSchema, type SchemaDefinition } from "./staged-query/schema";
 export declare const Schemas: RegisteringProxy<(name: string, def: SchemaDefinition) => void>;
-/**
- * A schema determines the structure of a database
- *
- * Each schema can have multiple instances. The internal organization of these
- * instances is left up to the module implementation.
- */
-export declare class Schema<T = any> extends StagedObject {
-    readonly id: string;
-    readonly definition: SchemaDefinition;
-    private static readonly registry;
-    /**
-     * Retrieves a previously defined schema by its ID
-     *
-     * @param id Schema ID
-     * @returns The schema instance, or undefined if not found
-     */
-    static get(id: string): Schema | undefined;
-    /**
-     * Define a new schema with the given ID
-     *
-     * @param id ID of this schema, changing this will leave previous data inaccessible
-     * @param definition Schema definition (tables, fields, indexes..)
-     */
+export declare class Schema<T = any> extends StagedSchema<T, SchemaDefinition> {
     constructor(id: string, definition: SchemaDefinition);
-    /**
-     * Gets a specific instance of the schema
-     *
-     * @param id Instance ID, or {@link CROSS_INSTANCE} for a cross-instance query
-     * @returns Schema instance
-     */
-    instance(id?: InstanceId): SchemaInstance<T>;
-    /**
-     * Creates a new instance of the schema
-     *
-     * @param id Instance ID
-     * @returns Created instance ID
-     */
-    createInstance(id?: string): Query<string>;
-    /**
-     * Destroys an existing instance of the schema
-     *
-     * @param id Instance ID
-     */
-    destroyInstance(id?: string): Query<void>;
-    /**
-     * Lists the IDs of named instances of this schema.
-     *
-     * The default (unnamed) instance is not included.
-     *
-     * @returns IDs of named instances of this schema
-     */
-    listInstances(): Query<string[]>;
-}
-/**
- * Schema instance, could be a database or a filtered portion of one depending on the implementation
- */
-export declare class SchemaInstance<T> extends StagedObject {
-    /**
-     * Gets a table from the instance
-     *
-     * @param id Table name
-     * @returns Table
-     */
-    table<TK extends keyof T>(id: TK): Table<T[TK]>;
 }
-export {};
+export { CROSS_INSTANCE, type FieldType, type IndexDefinition, type InstanceId, type SchemaDefinition, SchemaInstance, type StringFieldType, type TableDefinition, } from "./staged-query/schema";

package/dist/schema.js

@@ -1,99 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaInstance = exports.Schema = exports.Schemas = exports.CROSS_INSTANCE = void 0;
+exports.SchemaInstance = exports.CROSS_INSTANCE = exports.Schema = exports.Schemas = void 0;
 const interface_core_1 = require("@antelopejs/interface-core");
-const query_1 = require("./query");
-const selection_1 = require("./selection");
-const common_1 = require("./common");
-/**
- * Sentinel instance id meaning "operate across all instances of the schema".
- */
-exports.CROSS_INSTANCE = Symbol("antelopejs:cross-instance");
+const schema_1 = require("./staged-query/schema");
 //@internal
 exports.Schemas = new interface_core_1.RegisteringProxy();
-/**
- * A schema determines the structure of a database
- *
- * Each schema can have multiple instances. The internal organization of these
- * instances is left up to the module implementation.
- */
-class Schema extends common_1.StagedObject {
-    id;
-    definition;
-    static registry = new Map();
-    /**
-     * Retrieves a previously defined schema by its ID
-     *
-     * @param id Schema ID
-     * @returns The schema instance, or undefined if not found
-     */
-    static get(id) {
-        return Schema.registry.get(id);
-    }
-    /**
-     * Define a new schema with the given ID
-     *
-     * @param id ID of this schema, changing this will leave previous data inaccessible
-     * @param definition Schema definition (tables, fields, indexes..)
-     */
+class Schema extends schema_1.Schema {
     constructor(id, definition) {
-        super((0, common_1.QueryStage)("schema", { id }));
-        this.id = id;
-        this.definition = definition;
+        super(id, definition);
         exports.Schemas.register(id, definition);
-        Schema.registry.set(id, this);
-    }
-    /**
-     * Gets a specific instance of the schema
-     *
-     * @param id Instance ID, or {@link CROSS_INSTANCE} for a cross-instance query
-     * @returns Schema instance
-     */
-    instance(id) {
-        return this.stage((SchemaInstance), "instance", { id });
-    }
-    /**
-     * Creates a new instance of the schema
-     *
-     * @param id Instance ID
-     * @returns Created instance ID
-     */
-    createInstance(id) {
-        return this.stage((query_1.Query), "createInstance", { id });
-    }
-    /**
-     * Destroys an existing instance of the schema
-     *
-     * @param id Instance ID
-     */
-    destroyInstance(id) {
-        return this.stage((query_1.Query), "destroyInstance", { id });
-    }
-    /**
-     * Lists the IDs of named instances of this schema.
-     *
-     * The default (unnamed) instance is not included.
-     *
-     * @returns IDs of named instances of this schema
-     */
-    listInstances() {
-        return this.stage((query_1.Query), "listInstances");
     }
 }
 exports.Schema = Schema;
-/**
- * Schema instance, could be a database or a filtered portion of one depending on the implementation
- */
-class SchemaInstance extends common_1.StagedObject {
-    /**
-     * Gets a table from the instance
-     *
-     * @param id Table name
-     * @returns Table
-     */
-    table(id) {
-        return this.stage((selection_1.Table), "table", { id });
-    }
-}
-exports.SchemaInstance = SchemaInstance;
+var schema_2 = require("./staged-query/schema");
+Object.defineProperty(exports, "CROSS_INSTANCE", { enumerable: true, get: function () { return schema_2.CROSS_INSTANCE; } });
+Object.defineProperty(exports, "SchemaInstance", { enumerable: true, get: function () { return schema_2.SchemaInstance; } });
 //# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":";;;AAAA,+DAA8D;AAE9D,mCAAgC;AAChC,2CAAoC;AACpC,qCAAoD;AAwDpD;;GAEG;AACU,QAAA,cAAc,GAAkB,MAAM,CACjD,2BAA2B,CAC5B,CAAC;AAOF,WAAW;AACE,QAAA,OAAO,GAAG,IAAI,iCAAgB,EAExC,CAAC;AAEJ;;;;;GAKG;AACH,MAAa,MAAgB,SAAQ,qBAAY;IAoB7B;IACA;IApBV,MAAM,CAAU,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7D;;;;;OAKG;IACI,MAAM,CAAC,GAAG,CAAC,EAAU;QAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,YACkB,EAAU,EACV,UAA4B;QAE5C,KAAK,CAAC,IAAA,mBAAU,EAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAHpB,OAAE,GAAF,EAAE,CAAQ;QACV,eAAU,GAAV,UAAU,CAAkB;QAG5C,eAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,EAAe;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA,cAAiB,CAAA,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,EAAW;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA,aAAa,CAAA,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,EAAW;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA,aAAW,CAAA,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACI,aAAa;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA,aAAe,CAAA,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;;AAlEH,wBAmEC;AAED;;GAEG;AACH,MAAa,cAAkB,SAAQ,qBAAY;IACjD;;;;;OAKG;IACI,KAAK,CAAqB,EAAM;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA,iBAAY,CAAA,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;CACF;AAVD,wCAUC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":";;;AAAA,+DAA8D;AAE9D,kDAG+B;AAE/B,WAAW;AACE,QAAA,OAAO,GAAG,IAAI,iCAAgB,EAExC,CAAC;AAEJ,MAAa,MAAgB,SAAQ,eAAiC;IACpE,YAAmB,EAAU,EAAE,UAA4B;QACzD,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACtB,eAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC;CACF;AALD,wBAKC;AAED,gDAS+B;AAR7B,wGAAA,cAAc,OAAA;AAKd,wGAAA,cAAc,OAAA"}

package/dist/selection.d.ts

@@ -1,104 +1 @@
-import { Datum } from "./datum";
-import { Query } from "./query";
-import { Stream } from "./stream";
-import { ValueProxy, type ValueProxyOrValue } from "./valueproxy";
-import type { Changes, DeepPartial, ExtractType, InsertOptions } from "./common";
-import { type AtomicMutation, type AtomicMutationOutcome } from "./atomic";
-type SelectionKey = string | number | boolean;
-/**
- * Selection containing a single element
- */
-export declare class SingleSelection<T> extends Datum<T> {
-    /**
-     * Update fields of this selection with the given values
-     *
-     * @param document Partial document with new values
-     * @returns Number of modified documents
-     */
-    update(document: DeepPartial<T>): Query<number>;
-    update<U>(document: (val: ValueProxy<T>) => U): ExtractType<U> extends DeepPartial<T> ? Query<number> : never;
-    /**
-     * Replace documents of this selection
-     *
-     * @param document Partial document to replace with
-     * @returns Number of modified documents
-     */
-    replace(document: DeepPartial<T>): Query<number>;
-    /**
-     * Delete selected documents
-     *
-     * @returns Number of deleted documents
-     */
-    delete(): Query<number>;
-    /**
-     * Turns this selection into a change feed
-     *
-     * @returns Change feed
-     */
-    changes(): Query<Changes<T>[]>;
-}
-/**
- * Selection containing any number of elements
- */
-export declare class Selection<T> extends Stream<T> {
-    /**
-     * Update fields of this selection with the given values
-     *
-     * @param document Partial document with new values
-     * @returns Number of modified documents
-     */
-    update(document: DeepPartial<T>): Query<number>;
-    update<U>(document: (val: ValueProxy<T>) => U): ExtractType<U> extends DeepPartial<T> ? Query<number> : never;
-    /**
-     * Replace documents of this selection
-     *
-     * @param document Partial document to replace with
-     * @returns Number of modified documents
-     */
-    replace(document: DeepPartial<T>): Query<number>;
-    /**
-     * Delete selected documents
-     *
-     * @returns Number of deleted documents
-     */
-    delete(): Query<number>;
-}
-/**
- * Database table
- */
-export declare class Table<T> extends Selection<T> {
-    /** Atomically checks one record's revision and patches or deletes it without upsert. */
-    atomicMutation(key: string, request: AtomicMutation<T>): Query<AtomicMutationOutcome>;
-    /**
-     * Inserts one or more documents into this table
-     *
-     * @param obj Document(s) to insert
-     * @returns Inserted IDs
-     */
-    insert(obj: DeepPartial<T> | DeepPartial<T>[], options?: InsertOptions): Query<string[]>;
-    /**
-     * Gets a document using its primary key
-     *
-     * @param key Primary key value
-     * @returns Single document selection
-     */
-    get(key: ValueProxyOrValue<string>): SingleSelection<T>;
-    /**
-     * Gets multiple documents using a secondary index
-     *
-     * @param keys Key value(s)
-     * @param index Secondary index, will use the primary key if undefined
-     * @returns Multiple document selection
-     */
-    getAll(keys: ValueProxyOrValue<SelectionKey> | ValueProxyOrValue<SelectionKey>[], index?: string): Selection<T>;
-    /**
-     * Gets multiple documents using a secondary index and bounding values
-     *
-     * @param index Secondary index
-     * @param low Lowest value of the range
-     * @param high Highest value of the range (excluded)
-     * @returns Multiple document selection
-     */
-    between<TK extends keyof T>(index: TK, low: T[TK], high: T[TK]): Selection<T>;
-}
-export {};
+export { Selection, SingleSelection, Table } from "./staged-query/selection";

package/dist/selection.js

@@ -1,126 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Table = exports.Selection = exports.SingleSelection = void 0;
-const datum_1 = require("./datum");
-const query_1 = require("./query");
-const stream_1 = require("./stream");
-const valueproxy_1 = require("./valueproxy");
-const atomic_1 = require("./atomic");
-/**
- * Selection containing a single element
- */
-class SingleSelection extends datum_1.Datum {
-    update(document) {
-        if (typeof document === "function") {
-            return this.stage((query_1.Query), "update", undefined, this.callfunc(document, (valueproxy_1.ValueProxy)));
-        }
-        return this.stage((query_1.Query), "update", undefined, document);
-    }
-    /**
-     * Replace documents of this selection
-     *
-     * @param document Partial document to replace with
-     * @returns Number of modified documents
-     */
-    replace(document) {
-        return this.stage((query_1.Query), "replace", undefined, document);
-    }
-    /**
-     * Delete selected documents
-     *
-     * @returns Number of deleted documents
-     */
-    delete() {
-        return this.stage((query_1.Query), "delete");
-    }
-    /**
-     * Turns this selection into a change feed
-     *
-     * @returns Change feed
-     */
-    changes() {
-        return this.stage((query_1.Query), "changes");
-    }
-}
-exports.SingleSelection = SingleSelection;
-/**
- * Selection containing any number of elements
- */
-class Selection extends stream_1.Stream {
-    update(document) {
-        if (typeof document === "function") {
-            return this.stage((query_1.Query), "update", undefined, this.callfunc(document, (valueproxy_1.ValueProxy)));
-        }
-        return this.stage((query_1.Query), "update", undefined, document);
-    }
-    /**
-     * Replace documents of this selection
-     *
-     * @param document Partial document to replace with
-     * @returns Number of modified documents
-     */
-    replace(document) {
-        return this.stage((query_1.Query), "replace", undefined, document);
-    }
-    /**
-     * Delete selected documents
-     *
-     * @returns Number of deleted documents
-     */
-    delete() {
-        return this.stage((query_1.Query), "delete");
-    }
-}
-exports.Selection = Selection;
-/**
- * Database table
- */
-class Table extends Selection {
-    /** Atomically checks one record's revision and patches or deletes it without upsert. */
-    atomicMutation(key, request) {
-        (0, atomic_1.ValidateAtomicMutationTable)(this.stages);
-        (0, atomic_1.ValidateAtomicMutation)(key, request);
-        return this.stage(atomic_1.AtomicMutationQuery, "atomicMutation", undefined, key, request);
-    }
-    /**
-     * Inserts one or more documents into this table
-     *
-     * @param obj Document(s) to insert
-     * @returns Inserted IDs
-     */
-    insert(obj, options) {
-        return this.stage((query_1.Query), "insert", options, obj);
-    }
-    /**
-     * Gets a document using its primary key
-     *
-     * @param key Primary key value
-     * @returns Single document selection
-     */
-    get(key) {
-        return this.stage((SingleSelection), "get", undefined, key);
-    }
-    /**
-     * Gets multiple documents using a secondary index
-     *
-     * @param keys Key value(s)
-     * @param index Secondary index, will use the primary key if undefined
-     * @returns Multiple document selection
-     */
-    getAll(keys, index) {
-        return this.stage((Selection), "getAll", { index }, keys);
-    }
-    /**
-     * Gets multiple documents using a secondary index and bounding values
-     *
-     * @param index Secondary index
-     * @param low Lowest value of the range
-     * @param high Highest value of the range (excluded)
-     * @returns Multiple document selection
-     */
-    between(index, low, high) {
-        return this.stage((Selection), "between", { index }, low, high);
-    }
-}
-exports.Table = Table;
+exports.Table = exports.SingleSelection = exports.Selection = void 0;
+var selection_1 = require("./staged-query/selection");
+Object.defineProperty(exports, "Selection", { enumerable: true, get: function () { return selection_1.Selection; } });
+Object.defineProperty(exports, "SingleSelection", { enumerable: true, get: function () { return selection_1.SingleSelection; } });
+Object.defineProperty(exports, "Table", { enumerable: true, get: function () { return selection_1.Table; } });
 //# sourceMappingURL=selection.js.map

package/dist/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":";;;AAAA,sDAA6E;AAApE,sGAAA,SAAS,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,kGAAA,KAAK,OAAA"}

package/dist/staged-query/atomic.d.ts

@@ -0,0 +1,34 @@
+import { Query } from "./query";
+import type { QueryStage } from "./common";
+/** Matches an absent revision field on an existing record, not stored null. */
+export interface MissingRevision {
+    kind: "missing";
+}
+export interface AtomicCondition<T> {
+    revisionField: keyof T & string;
+    expectedRevision: string | MissingRevision;
+}
+/** Replaces supplied top-level fields and atomically installs a fresh revision. */
+export interface AtomicUpdate<T> extends AtomicCondition<T> {
+    type: "update";
+    nextRevision: string;
+    patch: Partial<T>;
+}
+export interface AtomicDelete<T> extends AtomicCondition<T> {
+    type: "delete";
+}
+export type AtomicEqualityValue = string | number | boolean | Date;
+/** Deletes by one observed scalar value; does not provide revision or ABA protection. */
+export interface AtomicDeleteIfEqual<T> {
+    type: "deleteIfEqual";
+    field: keyof T & string;
+    expectedValue: AtomicEqualityValue;
+}
+export type AtomicMutation<T> = AtomicUpdate<T> | AtomicDelete<T> | AtomicDeleteIfEqual<T>;
+export type AtomicMutationOutcome = "applied" | "not-applied" | "unknown";
+/** Validates literal input; adapters must additionally supply scope fields. */
+export declare function ValidateAtomicMutation<T>(key: string, request: AtomicMutation<T>, protectedFields?: readonly string[]): void;
+/** Rejects selections and cross-instance operations before adapter dispatch. */
+export declare function ValidateAtomicMutationTable(stages: QueryStage[]): void;
+export declare class AtomicMutationQuery extends Query<AtomicMutationOutcome> {
+}

package/dist/staged-query/atomic.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtomicMutationQuery = void 0;
+exports.ValidateAtomicMutation = ValidateAtomicMutation;
+exports.ValidateAtomicMutationTable = ValidateAtomicMutationTable;
+const query_1 = require("./query");
+const tableStages = ["schema", "instance", "table"];
+const identityFields = ["id", "_id"];
+function isRecord(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        [Object.prototype, null].includes(Object.getPrototypeOf(value)));
+}
+function isToken(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function validateField(field) {
+    if (!isToken(field) || field.includes(".") || field.startsWith("$")) {
+        throw new TypeError("Atomic mutation fields must be literal field names");
+    }
+}
+function validateConstant(value, ancestors = new Set()) {
+    if (value === null || ["string", "boolean"].includes(typeof value))
+        return;
+    if (typeof value === "number" && Number.isFinite(value))
+        return;
+    if (value instanceof Date && Number.isFinite(value.getTime()))
+        return;
+    if ((!Array.isArray(value) && !isRecord(value)) || ancestors.has(value)) {
+        throw new TypeError("Atomic mutation patches must contain constant data");
+    }
+    if (Array.isArray(value) && Object.keys(value).length !== value.length) {
+        throw new TypeError("Atomic mutation arrays must not contain holes");
+    }
+    ancestors.add(value);
+    for (const [field, child] of Object.entries(value)) {
+        validateField(field);
+        validateConstant(child, ancestors);
+    }
+    ancestors.delete(value);
+}
+/** Validates literal input; adapters must additionally supply scope fields. */
+function ValidateAtomicMutation(key, request, protectedFields = []) {
+    if (!isToken(key) || !isRecord(request)) {
+        throw new TypeError("Atomic mutation requires one literal record identity");
+    }
+    const forbidden = [...identityFields, ...protectedFields];
+    if (request.type === "deleteIfEqual") {
+        validateEquality(request, forbidden);
+        return;
+    }
+    validateField(request.revisionField);
+    if (forbidden.includes(request.revisionField)) {
+        throw new TypeError("Atomic mutation revision cannot be an identity field");
+    }
+    const expected = request.expectedRevision;
+    const isMissing = isRecord(expected) &&
+        expected.kind === "missing" &&
+        Object.keys(expected).length === 1;
+    if (!isToken(expected) && !isMissing) {
+        throw new TypeError("Expected revision must be a token or missing tag");
+    }
+    if (request.type === "delete")
+        return;
+    if (request.type !== "update") {
+        throw new TypeError("Unknown atomic mutation operation");
+    }
+    validateUpdate(request, forbidden);
+}
+function validateEquality(request, forbidden) {
+    validateField(request.field);
+    if (forbidden.includes(request.field)) {
+        throw new TypeError("Atomic equality field cannot be an identity field");
+    }
+    const value = request.expectedValue;
+    if (!["string", "number", "boolean"].includes(typeof value) &&
+        !(value instanceof Date)) {
+        throw new TypeError("Atomic equality requires a scalar or Date");
+    }
+    validateConstant(value);
+}
+function validateUpdate(request, forbidden) {
+    if (!isToken(request.nextRevision) ||
+        request.nextRevision === request.expectedRevision) {
+        throw new TypeError("Atomic mutation requires a changed revision token");
+    }
+    if (!isRecord(request.patch)) {
+        throw new TypeError("Atomic mutation patch must be an object");
+    }
+    forbidden.push(request.revisionField);
+    if (Object.keys(request.patch).some((field) => forbidden.includes(field))) {
+        throw new TypeError("Atomic mutation patch cannot change identity or revision");
+    }
+    validateConstant(request.patch);
+}
+/** Rejects selections and cross-instance operations before adapter dispatch. */
+function ValidateAtomicMutationTable(stages) {
+    if (stages.length !== tableStages.length ||
+        stages.some((stage, index) => stage.stage !== tableStages[index]) ||
+        (stages[1].options?.id !== undefined &&
+            typeof stages[1].options.id !== "string")) {
+        throw new TypeError("Atomic mutation requires one instance-scoped table");
+    }
+}
+class AtomicMutationQuery extends query_1.Query {
+}
+exports.AtomicMutationQuery = AtomicMutationQuery;
+//# sourceMappingURL=atomic.js.map

package/dist/staged-query/atomic.js.map

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