@smart-data-engines/sde 0.1.0-dev.0

package/dist/watermark.js

@@ -0,0 +1,170 @@
+/**
+ * Refusing a placement map that goes backwards, and the durable state that makes it possible.
+ *
+ * A signed map for version 3 verifies correctly forever - that is what a signature is. So replacing
+ * the client's map file with an older signed one loads cleanly, routes writes to the previous
+ * placement, and **nothing protests**. Today that costs a client a stale schema. Once the migration
+ * state travels in the map, it costs them writes: a library reverted from dual-write to
+ * single-write in the middle of a migration drops exactly the rows the migration exists not to
+ * drop.
+ *
+ * Refusing it needs one thing a library has never had: **memory**. Everything else here is a pure
+ * function of a document, a model and a key, which is why it can be verified by reading it. This
+ * module is the exception, and each of the three obvious places to keep that memory is worse than
+ * the one chosen:
+ *
+ * - **in the process** protects until the first restart, and a restart is when a swapped file is
+ *   read. A protection that lapses exactly when it is needed;
+ * - **in a file** needs a configured path, and in a container that path is usually ephemeral - so it
+ *   degrades to the first option while continuing to look like the third. The worst property
+ *   available: a guarantee present in the code and absent in production;
+ * - **with us** would mean the library asking our service whether it may start, which is the one
+ *   thing this product promises it will never need to do. Our outage would become the client's.
+ *
+ * So it lives **in the client's own engines**, in a table this library owns. Four properties, and
+ * the first two are what make it safe rather than merely present.
+ *
+ * **Append-only, and the watermark is `max(map_version)`.** No update, no key enforcement, no
+ * row-level contention - and therefore identical semantics in PostgreSQL and in ClickHouse, which is
+ * the engine that has no unique constraint to offer. A stale row can never lower the bar.
+ *
+ * **Every participating engine is written, and the watermark is the maximum over all of them.**
+ * Losing an engine cannot lose the protection, and one engine lagging cannot weaken it.
+ *
+ * **An engine that cannot store it does not participate, and that is reported rather than hidden.**
+ * A protection whose state cannot be read is a protection taken on trust.
+ *
+ * **Only signed maps are checked.** An unsigned map is the client's own document: hand-writing one
+ * and pointing a library at it is the no-account mode, and their business what they replace it with.
+ * In pure no-account mode this module does nothing at all - no table, no query, no cost.
+ *
+ * The escape hatch is deliberately not a parameter. A legitimate rollback - we issued a bad map -
+ * means clearing the bookkeeping, and the refusal says how. A parameter called `allowRollback` would
+ * be set once during an incident and left set.
+ */
+import { compareCodePoints } from './canonical.js';
+import { satisfies, WATERMARK_MEMBERS } from './capabilities.js';
+import { MapRolledBack } from './errors.js';
+import { WATERMARK_TABLE } from './placement.js';
+/**
+ * A compile-time ratchet between the interface and the list the runtime check uses.
+ *
+ * Add a method to `WatermarkStore` and forget `WATERMARK_MEMBERS`, and this stops being assignable.
+ * The runtime list cannot be derived from the interface - types are erased - so the compiler holds
+ * the other direction instead.
+ */
+export const WATERMARK_STORE_IS_TOTAL = true;
+export function watermarkRecord(check) {
+    return {
+        protection: check.protection,
+        map_version: check.mapVersion,
+        highest_seen: check.highestSeen,
+        participating: [...check.participating],
+        unable: [...check.unable],
+        why: check.why,
+    };
+}
+function split(engines) {
+    const able = [];
+    const unable = [];
+    for (const name of Object.keys(engines).sort(compareCodePoints)) {
+        if (satisfies(engines[name], WATERMARK_MEMBERS))
+            able.push(name);
+        else
+            unable.push(name);
+    }
+    return { able, unable };
+}
+/**
+ * Refuse a signed map older than the newest one these engines have seen.
+ *
+ * Throws {@link MapRolledBack}. Equal is allowed - restarting a process against the same map is the
+ * ordinary case - and only strictly lower is refused.
+ *
+ * Asynchronous because reading a watermark is a query, and split in two inside: this gathers the
+ * numbers and {@link decide} makes the decision from them. The decision is therefore a pure
+ * function of a document and a set of integers, which is what lets the `migration/` vectors check
+ * it, and what lets a reader confirm by reading that nothing here depends on the order the engines
+ * answered in.
+ *
+ * **Nothing is read for an unsigned map.** The no-account mode promises no table, no query and no
+ * cost, and this function gathered every watermark and *then* asked whether the map was signed
+ * until `migration/001` existed - the right answer, with the promise broken, which is the one shape
+ * of defect a record of the decision cannot show.
+ */
+export async function enforceForwardOnly(placement, engines) {
+    if (!placement.signed)
+        return decide(placement, engines, new Map());
+    const { able } = split(engines);
+    const seen = new Map();
+    for (const name of able) {
+        const store = engines[name];
+        seen.set(name, await store.mapWatermark());
+    }
+    const check = decide(placement, engines, seen);
+    if (check.protection === 'enforced' &&
+        (check.highestSeen === null || placement.mapVersion > check.highestSeen)) {
+        // Written only when it moves, and only after the decision - so a refusal writes nothing.
+        // Recording every start would grow the table by one row per process restart and the watermark
+        // would say nothing more than it does now.
+        for (const name of check.participating) {
+            const store = engines[name];
+            await store.recordMapVersion(placement.mapVersion, { modelVersion: placement.modelVersion });
+        }
+    }
+    return check;
+}
+function decide(placement, engines, seen) {
+    if (!placement.signed) {
+        return {
+            protection: 'not_applicable',
+            mapVersion: placement.mapVersion,
+            highestSeen: null,
+            participating: [],
+            unable: Object.keys(engines).sort(compareCodePoints),
+            why: 'this map is unsigned, so it is your own document rather than one we issued. Replacing it ' +
+                'with another is the no-account mode working as documented, and there is no newest ' +
+                'version for us to be the authority on.',
+        };
+    }
+    const { able, unable } = split(engines);
+    if (able.length === 0) {
+        return {
+            protection: 'unavailable',
+            mapVersion: placement.mapVersion,
+            highestSeen: null,
+            participating: [],
+            unable,
+            why: `none of the engines in this map can keep bookkeeping ([${unable.join(', ')}]), so a map ` +
+                `that goes backwards cannot be recognised. An engine whose schema is fixed in its own ` +
+                `source - ours is - has nowhere to put it. Nothing is wrong with your configuration; this ` +
+                `protection simply does not exist for it.`,
+        };
+    }
+    const known = able
+        .map((name) => seen.get(name) ?? null)
+        .filter((value) => value !== null);
+    const highest = known.length === 0 ? null : Math.max(...known);
+    if (highest !== null && placement.mapVersion < highest) {
+        throw new MapRolledBack(`this map is version ${placement.mapVersion} and version ${highest} has already been ` +
+            `applied against these engines. Refusing to go backwards: an older signed map verifies ` +
+            `perfectly - that is what a signature is - so nothing else here would notice that the ` +
+            `file was replaced, and the writes would go to the previous placement. If this is ` +
+            `deliberate, because the newer map was wrong, clear the bookkeeping: DELETE FROM ` +
+            `${WATERMARK_TABLE} WHERE map_version > ${placement.mapVersion}; in ` +
+            `[${able.join(', ')}], and on an engine that deletes asynchronously, let the deletion ` +
+            `finish before restarting. That is a deliberate act with a stated consequence, which is ` +
+            `why it is not a flag.`);
+    }
+    return {
+        protection: 'enforced',
+        mapVersion: placement.mapVersion,
+        highestSeen: highest,
+        participating: able,
+        unable,
+        why: `the highest map version applied against these engines is ` +
+            `${highest ?? placement.mapVersion}, kept in ${WATERMARK_TABLE} in [${able.join(', ')}]. ` +
+            `A map older than that is refused.`,
+    };
+}
+//# sourceMappingURL=watermark.js.map

package/dist/watermark.js.map

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

package/dist/write-fence.d.ts

@@ -0,0 +1,58 @@
+export { DRAIN_TABLE, EPOCH_COLUMN, checkEpoch } from './generation.js';
+export declare const FENCE_PREFIX = "__sde_f_";
+export type ColumnState = 'absent' | 'valid' | 'conflict';
+export interface FenceMetadata {
+    readonly identity: string;
+    readonly column: ColumnState;
+    readonly constraints: Readonly<Record<string, string>>;
+}
+/** Provisioning/execution capability, separate from a runtime role's INSERT permission. */
+export interface FenceBackend {
+    metadata(table: string): Promise<FenceMetadata>;
+    addColumn(table: string): Promise<void>;
+    addConstraint(table: string, name: string, expression: string): Promise<void>;
+    dropConstraint(table: string, name: string): Promise<void>;
+    drain(table: string, options: {
+        projectId: string;
+        hold: string;
+    }): Promise<void>;
+    restore(table: string, options: {
+        projectId: string;
+        hold: string;
+    }): Promise<void>;
+}
+export declare class FenceState {
+    readonly identity: string;
+    readonly projectId: string | undefined;
+    readonly column: ColumnState;
+    readonly minimums: readonly number[];
+    readonly maximums: readonly number[];
+    readonly holds: readonly string[];
+    readonly retired: readonly string[];
+    constructor(identity: string, projectId: string | undefined, column: ColumnState, minimums: readonly number[], maximums: readonly number[], holds: readonly string[], retired: readonly string[]);
+    get lowerEpoch(): number | undefined;
+    get upperEpoch(): number | undefined;
+    get complete(): boolean;
+    get closed(): boolean;
+    get epoch(): number | undefined;
+    asRecord(): Record<string, unknown>;
+}
+export declare function fenceState(metadata: FenceMetadata): FenceState;
+/** Serialize administrative calls per project. A partial command may leave the table closed. */
+export declare class WriteFence {
+    private readonly backend;
+    readonly table: string;
+    readonly projectId: string;
+    constructor(backend: FenceBackend, table: string, options: {
+        projectId: string;
+    });
+    state(): Promise<FenceState>;
+    private ready;
+    prepare(epoch: number): Promise<FenceState>;
+    freeze(requestId: string): Promise<FenceState>;
+    resume(requestId: string): Promise<FenceState>;
+    resumePrepare(epoch: number): Promise<FenceState>;
+    advance(epoch: number): Promise<FenceState>;
+    private bounds;
+    release(requestId: string): Promise<FenceState>;
+}

package/dist/write-fence.js

@@ -0,0 +1,225 @@
+/** Native write generations and named barriers. These primitives do not authorize a cutover. */
+import { MigrationRefused } from './errors.js';
+import { DRAIN_TABLE, EPOCH_COLUMN, checkEpoch } from './generation.js';
+export { DRAIN_TABLE, EPOCH_COLUMN, checkEpoch } from './generation.js';
+import { BACKFILL_TABLE, WATERMARK_TABLE } from './placement.js';
+export const FENCE_PREFIX = '__sde_f_';
+const SETUP = FENCE_PREFIX + 'setup';
+function identity(value, label) {
+    if (typeof value !== 'string' || !/^[0-9a-f]{32}$/.test(value)) {
+        throw new MigrationRefused(`write fence ${label} must be 32 lowercase hexadecimal digits`);
+    }
+}
+function predicate(raw) {
+    let value = raw.trim();
+    if (value.startsWith('CHECK'))
+        value = value.slice(5).trim();
+    value = value.replace(/\s+NOT\s+VALID$/, '');
+    while (value.startsWith('(') && value.endsWith(')'))
+        value = value.slice(1, -1).trim();
+    if (value === 'true' || value === '1')
+        return '1';
+    if (value === 'false' || value === '0')
+        return '0';
+    const matched = /^\(*\s*(?:"__sde_write_epoch"|`__sde_write_epoch`|__sde_write_epoch)\s*\)*\s*(>=|<=)\s*\(*\s*(?:([0-9]+)|'([0-9]+)'::bigint)\s*\)*$/.exec(value);
+    if (matched === null)
+        return '<unrecognized>';
+    const number = BigInt(matched[2] ?? matched[3]);
+    return EPOCH_COLUMN + matched[1] + number.toString();
+}
+export class FenceState {
+    identity;
+    projectId;
+    column;
+    minimums;
+    maximums;
+    holds;
+    retired;
+    constructor(identity, projectId, column, minimums, maximums, holds, retired) {
+        this.identity = identity;
+        this.projectId = projectId;
+        this.column = column;
+        this.minimums = Object.freeze([...minimums].sort((a, b) => a - b));
+        this.maximums = Object.freeze([...maximums].sort((a, b) => a - b));
+        this.holds = Object.freeze([...holds].sort());
+        this.retired = Object.freeze([...retired].sort());
+        Object.freeze(this);
+    }
+    get lowerEpoch() { return this.minimums.at(-1); }
+    get upperEpoch() { return this.maximums[0]; }
+    get complete() {
+        return this.projectId !== undefined && this.column === 'valid' &&
+            this.minimums.length > 0 && this.maximums.length > 0;
+    }
+    get closed() {
+        return this.holds.length > 0 || (this.lowerEpoch !== undefined && this.upperEpoch !== undefined &&
+            this.lowerEpoch > this.upperEpoch);
+    }
+    get epoch() {
+        return this.complete && this.lowerEpoch === this.upperEpoch ? this.lowerEpoch : undefined;
+    }
+    asRecord() {
+        return {
+            identity: this.identity, project_id: this.projectId ?? null, column: this.column,
+            lower_epoch: this.lowerEpoch ?? null, upper_epoch: this.upperEpoch ?? null,
+            holds: [...this.holds], retired: [...this.retired], closed: this.closed,
+        };
+    }
+}
+export function fenceState(metadata) {
+    const owners = [], minima = [], maxima = [], holds = [], retired = [];
+    for (const name of Object.keys(metadata.constraints).sort()) {
+        if (!name.startsWith(FENCE_PREFIX))
+            continue;
+        const suffix = name.slice(FENCE_PREFIX.length);
+        const actual = predicate(metadata.constraints[name]);
+        let expected;
+        if (/^owner_[0-9a-f]{32}$/.test(suffix)) {
+            owners.push(suffix.slice(6));
+            expected = '1';
+        }
+        else if (/^retired_[0-9a-f]{32}$/.test(suffix)) {
+            retired.push(suffix.slice(8));
+            expected = '1';
+        }
+        else if (suffix === 'setup' || /^hold_[0-9a-f]{32}$/.test(suffix)) {
+            holds.push(suffix === 'setup' ? 'setup' : suffix.slice(5));
+            expected = '0';
+        }
+        else if (/^(?:min|max)_[1-9][0-9]*$/.test(suffix)) {
+            const value = checkEpoch(Number(suffix.slice(4)));
+            (suffix.startsWith('min_') ? minima : maxima).push(value);
+            expected = EPOCH_COLUMN + (suffix.startsWith('min_') ? '>=' : '<=') + String(value);
+        }
+        else {
+            throw new MigrationRefused('unrecognized constraint in the reserved write-fence namespace');
+        }
+        if (actual !== expected) {
+            throw new MigrationRefused(`write fence constraint ${name} has an unexpected predicate`);
+        }
+    }
+    if (owners.length > 1) {
+        throw new MigrationRefused('the table carries write fences from more than one project');
+    }
+    if (owners.length === 0 && (minima.length > 0 || maxima.length > 0 || holds.length > 0 || retired.length > 0)) {
+        throw new MigrationRefused('write fence constraints have no project owner');
+    }
+    return new FenceState(metadata.identity, owners[0], metadata.column, minima, maxima, holds, retired);
+}
+/** Serialize administrative calls per project. A partial command may leave the table closed. */
+export class WriteFence {
+    backend;
+    table;
+    projectId;
+    constructor(backend, table, options) {
+        this.backend = backend;
+        this.table = table;
+        identity(options.projectId, 'project_id');
+        if (typeof table !== 'string' || table.length === 0 || table.includes('\0')) {
+            throw new MigrationRefused('write fence table must be a nonempty identifier');
+        }
+        if ([DRAIN_TABLE, BACKFILL_TABLE, WATERMARK_TABLE].includes(table)) {
+            throw new MigrationRefused('write fences cannot take over an SDK metadata table');
+        }
+        this.projectId = options.projectId;
+    }
+    async state() {
+        const state = fenceState(await this.backend.metadata(this.table));
+        if (state.projectId !== undefined && state.projectId !== this.projectId) {
+            throw new MigrationRefused('the write fence belongs to another project');
+        }
+        if (state.column === 'conflict') {
+            throw new MigrationRefused('the reserved write-epoch column has an incompatible definition');
+        }
+        return state;
+    }
+    async ready() {
+        const state = await this.state();
+        if (!state.complete)
+            throw new MigrationRefused('the write fence is not fully provisioned');
+        return state;
+    }
+    async prepare(epoch) {
+        checkEpoch(epoch);
+        const state = await this.state();
+        if (state.complete && !state.holds.includes('setup')) {
+            if (state.epoch !== epoch)
+                throw new MigrationRefused('provisioning cannot change an existing write epoch');
+            return state;
+        }
+        if (state.projectId === undefined && state.column !== 'absent') {
+            throw new MigrationRefused('the reserved write-epoch column is not owned by this project');
+        }
+        if (state.lowerEpoch !== undefined && state.lowerEpoch > epoch) {
+            throw new MigrationRefused('a write epoch cannot move backwards');
+        }
+        if (state.projectId === undefined) {
+            await this.backend.addConstraint(this.table, FENCE_PREFIX + 'owner_' + this.projectId, '1');
+        }
+        await this.backend.addConstraint(this.table, SETUP, '0');
+        await this.backend.addColumn(this.table);
+        await this.bounds(epoch);
+        await this.backend.drain(this.table, { projectId: this.projectId, hold: 'setup' });
+        await this.backend.dropConstraint(this.table, SETUP);
+        return this.ready();
+    }
+    async freeze(requestId) {
+        identity(requestId, 'request_id');
+        const state = await this.ready();
+        if (state.retired.includes(requestId))
+            throw new MigrationRefused('a completed write barrier id cannot be reused');
+        await this.backend.addConstraint(this.table, FENCE_PREFIX + 'hold_' + requestId, '0');
+        // Constraint existence closes admission, not INSERTs using an older metadata snapshot.
+        await this.backend.drain(this.table, { projectId: this.projectId, hold: requestId });
+        return this.ready();
+    }
+    async resume(requestId) {
+        identity(requestId, 'request_id');
+        await this.backend.restore(this.table, { projectId: this.projectId, hold: requestId });
+        return this.freeze(requestId);
+    }
+    async resumePrepare(epoch) {
+        checkEpoch(epoch);
+        await this.backend.restore(this.table, { projectId: this.projectId, hold: 'setup' });
+        return this.prepare(epoch);
+    }
+    async advance(epoch) {
+        checkEpoch(epoch);
+        const state = await this.ready();
+        if (state.holds.length === 0)
+            throw new MigrationRefused('changing a write epoch needs a named write barrier');
+        if (state.lowerEpoch !== undefined && epoch < state.lowerEpoch) {
+            throw new MigrationRefused('a write epoch cannot move backwards');
+        }
+        await this.bounds(epoch);
+        return this.ready();
+    }
+    async bounds(epoch) {
+        await this.backend.addConstraint(this.table, FENCE_PREFIX + 'min_' + epoch, `${EPOCH_COLUMN} >= ${epoch}`);
+        await this.backend.addConstraint(this.table, FENCE_PREFIX + 'max_' + epoch, `${EPOCH_COLUMN} <= ${epoch}`);
+        const state = await this.state();
+        if (state.lowerEpoch !== undefined && state.lowerEpoch > epoch) {
+            throw new MigrationRefused('another executor installed a newer write epoch; table stays closed');
+        }
+        for (const old of state.maximums) {
+            if (old < epoch)
+                await this.backend.dropConstraint(this.table, FENCE_PREFIX + 'max_' + old);
+        }
+        for (const old of state.minimums) {
+            if (old < epoch)
+                await this.backend.dropConstraint(this.table, FENCE_PREFIX + 'min_' + old);
+        }
+    }
+    async release(requestId) {
+        identity(requestId, 'request_id');
+        const state = await this.ready();
+        if (state.epoch === undefined)
+            throw new MigrationRefused('cannot release a barrier with an incomplete epoch change');
+        if (!state.holds.includes(requestId))
+            return state;
+        await this.backend.addConstraint(this.table, FENCE_PREFIX + 'retired_' + requestId, '1');
+        await this.backend.dropConstraint(this.table, FENCE_PREFIX + 'hold_' + requestId);
+        return this.ready();
+    }
+}
+//# sourceMappingURL=write-fence.js.map

package/dist/write-fence.js.map

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

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@smart-data-engines/sde",
+  "version": "0.1.0-dev.0",
+  "description": "Smart Data Engine client library: declare a data model, we place it and move it",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/Smart-Data-Engines/smart-data-engine-sdk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Smart-Data-Engines/smart-data-engine-sdk.git",
+    "directory": "typescript"
+  },
+  "bugs": {
+    "url": "https://github.com/Smart-Data-Engines/smart-data-engine-sdk/issues"
+  },
+  "keywords": [
+    "database",
+    "placement",
+    "polystore",
+    "postgresql",
+    "clickhouse"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./engines/postgres": {
+      "types": "./dist/engines/postgres.d.ts",
+      "import": "./dist/engines/postgres.js"
+    },
+    "./engines/clickhouse": {
+      "types": "./dist/engines/clickhouse.d.ts",
+      "import": "./dist/engines/clickhouse.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/memory.d.ts",
+      "import": "./dist/testing/memory.js"
+    },
+    "./weather": {
+      "types": "./dist/demo/weather.d.ts",
+      "import": "./dist/demo/weather.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18 <27"
+  },
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "tsc -p tsconfig.build.json && tsc --noEmit --allowJs --checkJs --strict --target ES2022 --module NodeNext --types node --skipLibCheck bin/weather.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests --max-warnings 0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/pg": "^8.23.1",
+    "pg": "^8.23.0",
+    "typescript": "^5.4.0",
+    "vite": "^6.4.3",
+    "vitest": "^3.2.7"
+  },
+  "peerDependencies": {
+    "pg": ">=8"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    }
+  },
+  "bin": {
+    "sde-weather-ts": "./bin/weather.mjs"
+  }
+}