@rocicorp/zero 0.0.0-202410031711

package/out/zero-cache/src/types/error-for-client.js

@@ -0,0 +1,17 @@
+export class ErrorForClient extends Error {
+    errorMessage;
+    constructor(errorMessage, options) {
+        super(JSON.stringify(errorMessage), options);
+        this.errorMessage = errorMessage;
+    }
+}
+export function findErrorForClient(error) {
+    if (error instanceof ErrorForClient) {
+        return error;
+    }
+    if (error instanceof Error && error.cause) {
+        return findErrorForClient(error.cause);
+    }
+    return undefined;
+}
+//# sourceMappingURL=error-for-client.js.map

package/out/zero-cache/src/types/error-for-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-for-client.js","sourceRoot":"","sources":["../../../../../zero-cache/src/types/error-for-client.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,YAAY,CAAC;IACtB,YAAY,YAA0B,EAAE,OAAsB;QAC5D,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1C,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/out/zero-cache/src/types/lexi-version.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A LexiVersion is a lexicographically sortable representation of
+ * numbers from 0 to Number.MAX_SAFE_INTEGER (which is the safe range of
+ * Version values used in Zero).
+ *
+ * The Version is first encoded in base36, and then prepended by a single
+ * base36 character representing the length (of the base36 version) minus 1.
+ * This encoding can encode numbers up to 185 bits, with the maximum encoded
+ * number being `"z".repeat(37)`, or 36^36-1 (approximately 1.0638735892371651e+56).
+ *
+ * Examples:
+ * * 0 => "00"
+ * * 10 => "0a"
+ * * 35 => "0z"
+ * * 36 => "110"
+ * * 46655 => "2zzz"
+ * * 2^64 => "c3w5e11264sgsg"
+ *
+ * Note that when using the `number` type, the library will assert if attempting
+ * to encode a Version larger than Number.MAX_SAFE_INTEGER. For large numbers,
+ * use the `bigint` type.
+ */
+export type LexiVersion = string;
+export declare function versionToLexi(v: number | bigint): LexiVersion;
+export declare function versionFromLexi(lexiVersion: LexiVersion): bigint;
+export declare function max(a: LexiVersion, ...more: LexiVersion[]): LexiVersion;
+export declare function min(a: LexiVersion, ...more: LexiVersion[]): LexiVersion;
+export declare function oneAfter(version: LexiVersion): string;
+//# sourceMappingURL=lexi-version.d.ts.map

package/out/zero-cache/src/types/lexi-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexi-version.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/lexi-version.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAc7D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAShE;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,WAAW,CAMvE;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,WAAW,CAMvE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,UAE5C"}

package/out/zero-cache/src/types/lexi-version.js

@@ -0,0 +1,36 @@
+import { assert } from '../../../shared/src/asserts.js';
+import { parseBigInt } from '../../../shared/src/parse-big-int.js';
+export function versionToLexi(v) {
+    assert(v >= 0, 'Negative versions are not supported');
+    assert(typeof v === 'bigint' ||
+        (v <= Number.MAX_SAFE_INTEGER && Number.isInteger(v)), `Invalid or unsafe version ${v}`);
+    const base36Version = BigInt(v).toString(36);
+    const length = BigInt(base36Version.length - 1).toString(36);
+    assert(length.length === 1, `Value is too large to be encoded as a LexiVersion: ${v.toString()}`);
+    return `${length}${base36Version}`;
+}
+export function versionFromLexi(lexiVersion) {
+    assert(lexiVersion.length >= 2);
+    const length = lexiVersion.substring(0, 1);
+    const base36Version = lexiVersion.substring(1);
+    assert(base36Version.length === parseInt(length, 36) + 1, `Invalid LexiVersion: ${lexiVersion}`);
+    return parseBigInt(base36Version, 36);
+}
+export function max(a, ...more) {
+    let winner = a;
+    for (const b of more) {
+        winner = winner > b ? winner : b;
+    }
+    return winner;
+}
+export function min(a, ...more) {
+    let winner = a;
+    for (const b of more) {
+        winner = winner < b ? winner : b;
+    }
+    return winner;
+}
+export function oneAfter(version) {
+    return versionToLexi(versionFromLexi(version) + 1n);
+}
+//# sourceMappingURL=lexi-version.js.map

package/out/zero-cache/src/types/lexi-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexi-version.js","sourceRoot":"","sources":["../../../../../zero-cache/src/types/lexi-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AA0BxD,MAAM,UAAU,aAAa,CAAC,CAAkB;IAC9C,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,qCAAqC,CAAC,CAAC;IACtD,MAAM,CACJ,OAAO,CAAC,KAAK,QAAQ;QACnB,CAAC,CAAC,IAAI,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EACvD,6BAA6B,CAAC,EAAE,CACjC,CAAC;IACF,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7D,MAAM,CACJ,MAAM,CAAC,MAAM,KAAK,CAAC,EACnB,sDAAsD,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrE,CAAC;IACF,OAAO,GAAG,MAAM,GAAG,aAAa,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAwB;IACtD,MAAM,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,CACJ,aAAa,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,EACjD,wBAAwB,WAAW,EAAE,CACtC,CAAC;IACF,OAAO,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAc,EAAE,GAAG,IAAmB;IACxD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAc,EAAE,GAAG,IAAmB;IACxD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAoB;IAC3C,OAAO,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/out/zero-cache/src/types/lite.d.ts

@@ -0,0 +1,11 @@
+import type { SchemaValue } from '../../../zql/src/zql/ivm/schema.js';
+import type { RowValue } from './row-key.js';
+export declare const INTEGER = "INTEGER";
+export declare const REAL = "REAL";
+export declare const BLOB = "BLOB";
+export declare const TEXT = "TEXT";
+export declare const BOOL = "BOOL";
+export type LiteDataType = 'INTEGER' | 'REAL' | 'BLOB' | 'TEXT' | 'BOOL';
+export declare function liteValues(row: RowValue): (string | number | bigint | Date | readonly import("./bigint-json.js").JSONValue[] | import("./bigint-json.js").JSONObject | null)[];
+export declare function mapLiteDataTypeToZqlSchemaValue(liteDataType: string): SchemaValue;
+//# sourceMappingURL=lite.d.ts.map

package/out/zero-cache/src/types/lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/lite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAY,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,IAAI,SAAS,CAAC;AAE3B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzE,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,wIAEvC;AAED,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,GACnB,WAAW,CAEb"}

package/out/zero-cache/src/types/lite.js

@@ -0,0 +1,26 @@
+export const INTEGER = 'INTEGER';
+export const REAL = 'REAL';
+export const BLOB = 'BLOB';
+export const TEXT = 'TEXT';
+export const BOOL = 'BOOL';
+export function liteValues(row) {
+    return Object.values(row).map(v => (typeof v !== 'boolean' ? v : v ? 1 : 0));
+}
+export function mapLiteDataTypeToZqlSchemaValue(liteDataType) {
+    return { type: mapLiteDataTypeToZqlValueType(liteDataType) };
+}
+function mapLiteDataTypeToZqlValueType(liteDataType) {
+    switch (liteDataType) {
+        case INTEGER:
+            return 'number';
+        case REAL:
+            return 'number';
+        case TEXT:
+            return 'string';
+        case BOOL:
+            return 'boolean';
+        default: // Note: BLOB is not supported.
+            throw new Error(`Unsupported data type ${liteDataType}`);
+    }
+}
+//# sourceMappingURL=lite.js.map

package/out/zero-cache/src/types/lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.js","sourceRoot":"","sources":["../../../../../zero-cache/src/types/lite.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAI3B,MAAM,UAAU,UAAU,CAAC,GAAa;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,YAAoB;IAEpB,OAAO,EAAC,IAAI,EAAE,6BAA6B,CAAC,YAAY,CAAC,EAAC,CAAC;AAC7D,CAAC;AAED,SAAS,6BAA6B,CAAC,YAAoB;IACzD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,QAAQ,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,QAAQ,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,SAAS,CAAC;QACnB,SAAS,+BAA+B;YACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/out/zero-cache/src/types/names.d.ts

@@ -0,0 +1,5 @@
+export declare function liteTableName(t: {
+    schema: string;
+    name: string;
+}): string;
+//# sourceMappingURL=names.d.ts.map

package/out/zero-cache/src/types/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/names.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,CAAC,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,UAE9D"}

package/out/zero-cache/src/types/names.js

@@ -0,0 +1,4 @@
+export function liteTableName(t) {
+    return t.schema === 'public' ? t.name : `${t.schema}.${t.name}`;
+}
+//# sourceMappingURL=names.js.map

package/out/zero-cache/src/types/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../../../zero-cache/src/types/names.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,CAAiC;IAC7D,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/out/zero-cache/src/types/pg.d.ts

@@ -0,0 +1,31 @@
+import { LogContext } from '@rocicorp/logger';
+import postgres, { type PostgresType } from 'postgres';
+import { type JSONValue } from './bigint-json.js';
+/** Registers types for the 'pg' library used by `pg-logical-replication`. */
+export declare function registerPostgresTypeParsers(): void;
+/** Configures types for the Postgres.js client library (`postgres`). */
+export declare const postgresTypeConfig: () => {
+    types: {
+        bigint: postgres.PostgresType<bigint>;
+        json: {
+            to: number;
+            from: number[];
+            serialize: typeof import("./bigint-json.js").stringify;
+            parse: typeof import("./bigint-json.js").parse;
+        };
+    };
+};
+export type PostgresDB = postgres.Sql<{
+    bigint: bigint;
+    json: JSONValue;
+}>;
+export type PostgresTransaction = postgres.TransactionSql<{
+    bigint: bigint;
+    json: JSONValue;
+}>;
+export declare function pgClient(lc: LogContext, connectionURI: string, options?: postgres.Options<{
+    bigint: PostgresType<bigint>;
+    json: PostgresType<JSONValue>;
+}>): PostgresDB;
+export declare const typeNameByOID: Record<number, string>;
+//# sourceMappingURL=pg.d.ts.map

package/out/zero-cache/src/types/pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/pg.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,OAAO,QAAQ,EAAE,EAAc,KAAK,YAAY,EAAC,MAAM,UAAU,CAAC;AAElE,OAAO,EAAa,KAAK,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAQ5D,6EAA6E;AAC7E,wBAAgB,2BAA2B,SAG1C;AAOD,wEAAwE;AACxE,eAAO,MAAM,kBAAkB;;;;;;;;;;CAU7B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,cAAc,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC,CAAC;AAEH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,UAAU,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;CAC/B,CAAC,GACD,UAAU,CAwBZ;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKhD,CAAC"}

package/out/zero-cache/src/types/pg.js

@@ -0,0 +1,60 @@
+import { OID } from '@postgresql-typed/oids';
+import { LogContext } from '@rocicorp/logger';
+import pg from 'pg';
+import postgres, {} from 'postgres';
+import array from 'postgres-array';
+import { BigIntJSON } from './bigint-json.js';
+const { types: { builtins, setTypeParser }, } = pg;
+const builtinsINT8ARRAY = 1016; // No definition in builtins for int8[]
+/** Registers types for the 'pg' library used by `pg-logical-replication`. */
+export function registerPostgresTypeParsers() {
+    setTypeParser(builtins.INT8, val => BigInt(val));
+    setTypeParser(builtinsINT8ARRAY, val => array.parse(val, val => BigInt(val)));
+}
+// Type these as `number` so that Typescript doesn't complain about
+// referencing external types during type inference.
+const builtinsJSON = builtins.JSON;
+const builtinsJSONB = builtins.JSONB;
+/** Configures types for the Postgres.js client library (`postgres`). */
+export const postgresTypeConfig = () => ({
+    types: {
+        bigint: postgres.BigInt,
+        json: {
+            to: builtinsJSON,
+            from: [builtinsJSON, builtinsJSONB],
+            serialize: BigIntJSON.stringify,
+            parse: BigIntJSON.parse,
+        },
+    },
+});
+export function pgClient(lc, connectionURI, options) {
+    const onnotice = (n) => {
+        // https://www.postgresql.org/docs/current/plpgsql-errors-and-messages.html#PLPGSQL-STATEMENTS-RAISE
+        switch (n.severity) {
+            case 'NOTICE':
+                return; // silenced
+            case 'DEBUG':
+                lc.debug?.(n);
+                return;
+            case 'WARNING':
+            case 'EXCEPTION':
+                lc.error?.(n);
+                return;
+            case 'LOG':
+            case 'INFO':
+            default:
+                lc.info?.(n);
+        }
+    };
+    return postgres(connectionURI, {
+        ...postgresTypeConfig(),
+        onnotice,
+        ...options,
+    });
+}
+export const typeNameByOID = Object.fromEntries(Object.entries(OID).map(([name, oid]) => [
+    oid,
+    name.startsWith('_') ? `${name.substring(1)}[]` : name,
+]));
+Object.freeze(typeNameByOID);
+//# sourceMappingURL=pg.js.map

package/out/zero-cache/src/types/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../../../../../zero-cache/src/types/pg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,QAAQ,EAAE,EAAgC,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAC,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAE5D,MAAM,EACJ,KAAK,EAAE,EAAC,QAAQ,EAAE,aAAa,EAAC,GACjC,GAAG,EAAE,CAAC;AAEP,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,uCAAuC;AAEvE,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B;IACzC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,aAAa,CAAC,iBAAiB,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,mEAAmE;AACnE,oDAAoD;AACpD,MAAM,YAAY,GAAW,QAAQ,CAAC,IAAI,CAAC;AAC3C,MAAM,aAAa,GAAW,QAAQ,CAAC,KAAK,CAAC;AAE7C,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE;YACJ,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;YACnC,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB;KACF;CACF,CAAC,CAAC;AAYH,MAAM,UAAU,QAAQ,CACtB,EAAc,EACd,aAAqB,EACrB,OAGE;IAEF,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE;QAC7B,oGAAoG;QACpG,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,QAAQ;gBACX,OAAO,CAAC,WAAW;YACrB,KAAK,OAAO;gBACV,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBACd,OAAO;YACT,KAAK,SAAS,CAAC;YACf,KAAK,WAAW;gBACd,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBACd,OAAO;YACT,KAAK,KAAK,CAAC;YACX,KAAK,MAAM,CAAC;YACZ;gBACE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IACF,OAAO,QAAQ,CAAC,aAAa,EAAE;QAC7B,GAAG,kBAAkB,EAAE;QACvB,QAAQ;QACR,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA2B,MAAM,CAAC,WAAW,CACrE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IACvC,GAAG;IACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;CACvD,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/out/zero-cache/src/types/processes.d.ts

@@ -0,0 +1,57 @@
+import { type SendHandle } from 'node:child_process';
+import EventEmitter from 'node:events';
+/**
+ * Central registry of message type names, which are used to identify
+ * the payload in {@link Message} objects sent between processes. The
+ * payloads themselves are implementation specific and defined in each
+ * component; only the type name is reserved here to avoid collisions.
+ *
+ * Receiving logic can call {@link getMessage()} with the name of
+ * the message of interest to filter messages to those of interest.
+ */
+export declare const MESSAGE_TYPES: {
+    readonly handoff: "handoff";
+    readonly status: "status";
+    readonly subscribe: "subscribe";
+    readonly notify: "notify";
+    readonly ackNotify: "ackNotify";
+    readonly ready: "ready";
+};
+export type Message<Payload> = [keyof typeof MESSAGE_TYPES, Payload];
+export interface Receiver {
+    send<M extends Message<unknown>>(message: M, sendHandle?: SendHandle, callback?: (error: Error | null) => void): boolean;
+}
+export interface Sender extends EventEmitter {
+    /**
+     * The receiving side of {@link Receiver.send()} that is a wrapper around
+     * {@link on}('message', ...) that invokes the `handler` for messages of
+     * the specified `type`.
+     */
+    onMessageType<M extends Message<unknown>>(type: M[0], handler: (msg: M[1], sendHandle?: SendHandle) => void): this;
+    /**
+     * The receiving side of {@link Receiver.send()} that behaves like
+     * {@link once}('message', ...) that invokes the `handler` for the next
+     * message of the specified `type` and then unsubscribes.
+     */
+    onceMessageType<M extends Message<unknown>>(type: M[0], handler: (msg: M[1], sendHandle?: SendHandle) => void): this;
+}
+export interface Worker extends Sender, Receiver {
+}
+/**
+ * The parentWorker for forked processes, or `null` if the process was not forked.
+ * (Analogous to the `parentPort: MessagePort | null` of the `"workers"` library).
+ */
+export declare const parentWorker: Worker | null;
+export declare function singleProcessMode(): boolean;
+export declare function childWorker(absModulePath: string, ...args: string[]): Worker;
+/**
+ * Creates two connected `Worker` instances such that messages sent to one
+ * via the {@link Worker.send()} method are received by the other's
+ * `on('message', ...)` handler.
+ *
+ * This is analogous to the two `MessagePort`s of a `MessageChannel`, and
+ * is useful for executing code written for inter-process communication
+ * in a single process.
+ */
+export declare function inProcChannel(): [Worker, Worker];
+//# sourceMappingURL=processes.d.ts.map

package/out/zero-cache/src/types/processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/processes.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,YAAY,MAAM,aAAa,CAAC;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX,MAAM,MAAM,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,OAAO,aAAa,EAAE,OAAO,CAAC,CAAC;AAwCrE,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,CAAC,EACV,UAAU,CAAC,EAAE,UAAU,EACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GACvC,OAAO,CAAC;CACZ;AAED,MAAM,WAAW,MAAO,SAAQ,YAAY;IAC1C;;;;OAIG;IACH,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EACtC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EACV,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,KAAK,IAAI,GACpD,IAAI,CAAC;IAER;;;;OAIG;IACH,eAAe,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,EACxC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EACV,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,KAAK,IAAI,GACpD,IAAI,CAAC;CACT;AAED,MAAM,WAAW,MAAO,SAAQ,MAAM,EAAE,QAAQ;CAAG;AAkCnD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,GAAG,IAE5B,CAAC;AAIT,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBhD"}

package/out/zero-cache/src/types/processes.js

@@ -0,0 +1,121 @@
+import { ChildProcess, fork, } from 'node:child_process';
+import EventEmitter from 'node:events';
+/**
+ * Central registry of message type names, which are used to identify
+ * the payload in {@link Message} objects sent between processes. The
+ * payloads themselves are implementation specific and defined in each
+ * component; only the type name is reserved here to avoid collisions.
+ *
+ * Receiving logic can call {@link getMessage()} with the name of
+ * the message of interest to filter messages to those of interest.
+ */
+export const MESSAGE_TYPES = {
+    handoff: 'handoff',
+    status: 'status',
+    subscribe: 'subscribe',
+    notify: 'notify',
+    ackNotify: 'ackNotify',
+    ready: 'ready',
+};
+function getMessage(type, data) {
+    if (Array.isArray(data) && data.length === 2 && data[0] === type) {
+        return data[1];
+    }
+    return null;
+}
+function onMessageType(e, type, handler) {
+    return e.on('message', (data, sendHandle) => {
+        const msg = getMessage(type, data);
+        if (msg) {
+            handler(msg, sendHandle);
+        }
+    });
+}
+function onceMessageType(e, type, handler) {
+    const listener = (data, sendHandle) => {
+        const msg = getMessage(type, data);
+        if (msg) {
+            e.off('message', listener);
+            handler(msg, sendHandle);
+        }
+    };
+    return e.on('message', listener);
+}
+/**
+ * Adds the {@link Sender.onMessageType()} and {@link Sender.onceMessageType()}
+ * methods to convert the given `EventEmitter` to a `Sender`.
+ */
+function wrap(proc) {
+    return new Proxy(proc, {
+        get(target, prop, receiver) {
+            switch (prop) {
+                case 'onMessageType':
+                    return (type, handler) => {
+                        onMessageType(target, type, handler);
+                        return receiver; // this
+                    };
+                case 'onceMessageType':
+                    return (type, handler) => {
+                        onceMessageType(target, type, handler);
+                        return receiver; // this
+                    };
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+/**
+ * The parentWorker for forked processes, or `null` if the process was not forked.
+ * (Analogous to the `parentPort: MessagePort | null` of the `"workers"` library).
+ */
+export const parentWorker = process.send
+    ? wrap(process)
+    : null;
+const SINGLE_PROCESS = 'SINGLE_PROCESS';
+export function singleProcessMode() {
+    return (process.env[SINGLE_PROCESS] ?? '0') !== '0';
+}
+export function childWorker(absModulePath, ...args) {
+    if (singleProcessMode()) {
+        const [parent, child] = inProcChannel();
+        import(absModulePath)
+            .then(({ default: runWorker }) => runWorker(parent, ...args))
+            .catch(err => child.emit('error', err));
+        return child;
+    }
+    const worker = wrap(fork(absModulePath, args, { serialization: 'advanced' }));
+    // Propagate all listenable termination signals to the workers.
+    // Note: https://nodejs.org/api/process.html#process_signal_events
+    // > * 'SIGKILL' cannot have a listener installed, it will unconditionally terminate Node.js on all platforms.
+    // > * 'SIGSTOP' cannot have a listener installed.
+    for (const sig of ['SIGINT', 'SIGQUIT', 'SIGTERM']) {
+        process.on(sig, () => worker.kill(sig));
+    }
+    process.on('exit', () => worker.kill());
+    return worker;
+}
+/**
+ * Creates two connected `Worker` instances such that messages sent to one
+ * via the {@link Worker.send()} method are received by the other's
+ * `on('message', ...)` handler.
+ *
+ * This is analogous to the two `MessagePort`s of a `MessageChannel`, and
+ * is useful for executing code written for inter-process communication
+ * in a single process.
+ */
+export function inProcChannel() {
+    const worker1 = new EventEmitter();
+    const worker2 = new EventEmitter();
+    const sendTo = (dest) => (message, sendHandle, callback) => {
+        dest.emit('message', message, sendHandle);
+        if (callback) {
+            callback(null);
+        }
+        return true;
+    };
+    return [
+        wrap(Object.assign(worker1, { send: sendTo(worker2) })),
+        wrap(Object.assign(worker2, { send: sendTo(worker1) })),
+    ];
+}
+//# sourceMappingURL=processes.js.map

package/out/zero-cache/src/types/processes.js.map

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

package/out/zero-cache/src/types/row-key.d.ts

@@ -0,0 +1,37 @@
+import { type JSONValue } from './bigint-json.js';
+export type ColumnType = {
+    readonly typeOid: number;
+};
+export type RowKeyType = Readonly<Record<string, ColumnType>>;
+export type RowKey = Readonly<Record<string, JSONValue>>;
+export type RowID = Readonly<{
+    schema: string;
+    table: string;
+    rowKey: RowKey;
+}>;
+export type RowType = RowKeyType;
+export type RowValue = RowKey;
+/**
+ * Returns the `RowKey` such that key iteration produces a sorted sequence. If the
+ * keys are already sorted, the input is returned as is.
+ */
+export declare function normalizedKeyOrder(rowKey: RowKey): Readonly<Record<string, JSONValue>>;
+/**
+ * Returns a normalized string suitable for representing a row key in a form
+ * that can be used as a Map key.
+ */
+export declare function rowKeyString(key: RowKey): string;
+/**
+ * A RowIDHash is a 128-bit column-order-agnostic hash of the schema, table name, and
+ * column name / value tuples of a row key. It serves as a compact identifier for
+ * a row in the database that:
+ *
+ * * is guaranteed to fit within the constraints of the CVR store (Durable Object
+ *   storage keys cannot exceed 2KiB)
+ * * can be used to compactly encode (and lookup) the rows of query results for CVR
+ *   bookkeeping.
+ *
+ * The hash is encoded in `base36`, with the maximum 128-bit value being 25 characters long.
+ */
+export declare function rowIDHash(id: RowID): string;
+//# sourceMappingURL=row-key.d.ts.map

package/out/zero-cache/src/types/row-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-key.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/row-key.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAEzD,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC;AAI9E,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC;AACjC,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,uCAahD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,KAAK,GAAG,MAAM,CAgB3C"}

package/out/zero-cache/src/types/row-key.js

@@ -0,0 +1,64 @@
+import { h64 } from '../../../shared/src/xxhash.js';
+import { stringify } from './bigint-json.js';
+/**
+ * Returns the `RowKey` such that key iteration produces a sorted sequence. If the
+ * keys are already sorted, the input is returned as is.
+ */
+export function normalizedKeyOrder(rowKey) {
+    let last = '';
+    for (const col in rowKey) {
+        if (last > col) {
+            return Object.fromEntries(Object.entries(rowKey).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)));
+        }
+        last = col;
+    }
+    // This case iterates over columns and avoids object allocations, which is
+    // expected to be the common case (e.g. single column key).
+    return rowKey;
+}
+/**
+ * Returns a normalized string suitable for representing a row key in a form
+ * that can be used as a Map key.
+ */
+export function rowKeyString(key) {
+    return stringify(tuples(key));
+}
+function tuples(key) {
+    return Object.entries(normalizedKeyOrder(key)).flat();
+}
+const rowIDHashes = new WeakMap();
+/**
+ * A RowIDHash is a 128-bit column-order-agnostic hash of the schema, table name, and
+ * column name / value tuples of a row key. It serves as a compact identifier for
+ * a row in the database that:
+ *
+ * * is guaranteed to fit within the constraints of the CVR store (Durable Object
+ *   storage keys cannot exceed 2KiB)
+ * * can be used to compactly encode (and lookup) the rows of query results for CVR
+ *   bookkeeping.
+ *
+ * The hash is encoded in `base36`, with the maximum 128-bit value being 25 characters long.
+ */
+export function rowIDHash(id) {
+    let hash = rowIDHashes.get(id);
+    if (hash) {
+        return hash;
+    }
+    const str = stringify([id.schema, id.table, ...tuples(id.rowKey)]);
+    // xxhash only computes 64-bit values. Run it on the forward and reverse string
+    // to get better collision resistance.
+    const forward = h64(str);
+    const backward = h64(reverse(str));
+    const full = (forward << 64n) + backward;
+    hash = full.toString(36);
+    rowIDHashes.set(id, hash);
+    return hash;
+}
+function reverse(str) {
+    let reversed = '';
+    for (let i = str.length - 1; i >= 0; i--) {
+        reversed += str[i];
+    }
+    return reversed;
+}
+//# sourceMappingURL=row-key.js.map

package/out/zero-cache/src/types/row-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-key.js","sourceRoot":"","sources":["../../../../../zero-cache/src/types/row-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,sBAAsB,CAAC;AACzC,OAAO,EAAC,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAa3D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IACD,0EAA0E;IAC1E,2DAA2D;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,OAAO,EAAiB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,EAAS;IACjC,IAAI,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEnE,+EAA+E;IAC/E,sCAAsC;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;IACzC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzB,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/out/zero-cache/src/types/satisfies.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility type that statically confirms that a defined type T
+ * satisfies a wider type U.
+ *
+ * Example:
+ *
+ * ```ts
+ * export MyType = Satisfies<JSONValue, {
+ *  // type definition
+ * }>;
+ * ```
+ */
+export type Satisfies<U, T extends U> = T;
+//# sourceMappingURL=satisfies.d.ts.map

package/out/zero-cache/src/types/satisfies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satisfies.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/satisfies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC"}

package/out/zero-cache/src/types/satisfies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=satisfies.js.map

package/out/zero-cache/src/types/satisfies.js.map

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

package/out/zero-cache/src/types/specs.d.ts

@@ -0,0 +1,29 @@
+export type ColumnSpec = {
+    readonly pos: number;
+    readonly dataType: string;
+    readonly characterMaximumLength: number | null;
+    readonly notNull: boolean;
+    readonly dflt: string | null;
+};
+export type TableSpec = {
+    readonly schema: string;
+    readonly name: string;
+    readonly columns: Readonly<Record<string, ColumnSpec>>;
+    readonly primaryKey: readonly string[];
+};
+export type FilteredTableSpec = TableSpec & {
+    readonly publications: Readonly<Record<string, {
+        rowFilter: string | null;
+    }>>;
+};
+export type IndexSpec = {
+    readonly schemaName: string;
+    readonly tableName: string;
+    readonly name: string;
+    readonly unique: boolean;
+    readonly columns: readonly string[];
+};
+export type MutableIndexSpec = IndexSpec & {
+    readonly columns: string[];
+};
+//# sourceMappingURL=specs.d.ts.map

package/out/zero-cache/src/types/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/types/specs.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG;IAC1C,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,CAAC,CAAC,CAAC;CAC7E,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC"}