@rocicorp/zero 0.10.2025010800 → 0.10.2025011100

package/README.md

@@ -0,0 +1,32 @@
+# Zero
+
+## Documentation
+
+[https://zero.rocicorp.dev/docs/introduction](https://zero.rocicorp.dev/docs/introduction)
+
+## Install
+
+```bash
+npm install @rocicorp/zero
+```
+
+## Contributing
+
+### Building and Installing locally
+
+To build and install the package locally, run the following commands:
+
+```bash
+git clone git@github.com:rocicorp/mono.git
+cd mono
+npm install
+npm run build
+cd packages/zero
+npm pack
+```
+
+This creates a tgz (tarball) file in the `packages/zero` directory. You can then install this package in another project by running:
+
+```bash
+npm install /path/to/rocicorp-zero-<VERSION>.tgz
+```

package/out/change-protocol.js

@@ -0,0 +1,257 @@
+import {
+  readonly,
+  valita_exports
+} from "./chunk-ZRR54VX5.js";
+import {
+  __export
+} from "./chunk-F5QR3K72.js";
+
+// ../zero-cache/src/services/change-source/protocol/current/mod.ts
+var mod_exports = {};
+__export(mod_exports, {
+  CHANGE_SOURCE_PATH: () => CHANGE_SOURCE_PATH,
+  ackRequestedSchema: () => ackRequestedSchema,
+  ackSchema: () => ackSchema,
+  addColumnSchema: () => addColumnSchema,
+  beginSchema: () => beginSchema,
+  changeSourceUpstreamSchema: () => changeSourceUpstreamSchema,
+  changeStreamControlSchema: () => changeStreamControlSchema,
+  changeStreamDataSchema: () => changeStreamDataSchema,
+  changeStreamMessageSchema: () => changeStreamMessageSchema,
+  commitSchema: () => commitSchema,
+  createIndexSchema: () => createIndexSchema,
+  createTableSchema: () => createTableSchema,
+  dataChangeSchema: () => dataChangeSchema,
+  deleteSchema: () => deleteSchema,
+  dropColumnSchema: () => dropColumnSchema,
+  dropIndexSchema: () => dropIndexSchema,
+  dropTableSchema: () => dropTableSchema,
+  insertSchema: () => insertSchema,
+  relationSchema: () => relationSchema,
+  renameTableSchema: () => renameTableSchema,
+  resetRequiredSchema: () => resetRequiredSchema,
+  rollbackSchema: () => rollbackSchema,
+  rowSchema: () => rowSchema,
+  truncateSchema: () => truncateSchema,
+  updateColumnSchema: () => updateColumnSchema,
+  updateSchema: () => updateSchema
+});
+
+// ../zero-cache/src/services/change-source/protocol/current/control.ts
+var ackRequestedSchema = valita_exports.object({
+  tag: valita_exports.literal("ack-requested"),
+  /**
+   * If specified, indicates the latest watermark on upstream, which may encompass
+   * changes that are unrelated to the ChangeStreamer's subscription. If the
+   * ChangeStreamer has consumed and acked all of its data messages, it will include
+   * this watermark in its acknowledgment to indicate that it is caught up and
+   * upstream can purge its logs up to that watermark. If, on the other hand, it is
+   * still processing data messages, it will acknowledge immediately without a
+   * watermark to indicate that it is still "alive" but upstream logs still need to
+   * be preserved.
+   */
+  latestUpstreamWatermark: valita_exports.string().optional()
+});
+var resetRequiredSchema = valita_exports.object({ tag: valita_exports.literal("reset-required") });
+
+// ../zero-cache/src/db/specs.ts
+var pgTypeClassSchema = valita_exports.union(
+  valita_exports.literal("b" /* Base */),
+  valita_exports.literal("c" /* Composite */),
+  valita_exports.literal("d" /* Domain */),
+  valita_exports.literal("e" /* Enum */),
+  valita_exports.literal("p" /* Pseudo */),
+  valita_exports.literal("r" /* Range */),
+  valita_exports.literal("m" /* Multirange */)
+);
+var columnSpec = valita_exports.object({
+  pos: valita_exports.number(),
+  dataType: valita_exports.string(),
+  pgTypeClass: pgTypeClassSchema.optional(),
+  characterMaximumLength: valita_exports.number().nullable().optional(),
+  notNull: valita_exports.boolean().nullable().optional(),
+  dflt: valita_exports.string().nullable().optional()
+});
+var publishedColumnSpec = columnSpec.extend({
+  typeOID: valita_exports.number()
+});
+var liteTableSpec = valita_exports.object({
+  name: valita_exports.string(),
+  columns: valita_exports.record(columnSpec),
+  primaryKey: valita_exports.array(valita_exports.string())
+});
+var tableSpec = liteTableSpec.extend({
+  schema: valita_exports.string()
+});
+var publishedTableSpec = tableSpec.extend({
+  oid: valita_exports.number(),
+  columns: valita_exports.record(publishedColumnSpec),
+  publications: valita_exports.record(valita_exports.object({ rowFilter: valita_exports.string().nullable() }))
+});
+var directionSchema = valita_exports.union(valita_exports.literal("ASC"), valita_exports.literal("DESC"));
+var liteIndexSpec = valita_exports.object({
+  name: valita_exports.string(),
+  tableName: valita_exports.string(),
+  unique: valita_exports.boolean(),
+  columns: valita_exports.record(directionSchema)
+});
+var indexSpec = liteIndexSpec.extend({
+  schema: valita_exports.string()
+});
+
+// ../zero-cache/src/types/bigint-json.ts
+import {
+  parse as customParse,
+  stringify as customStringify
+} from "json-custom-numbers";
+var jsonValueSchema = valita_exports.lazy(() => {
+  const jsonObjectSchema2 = readonly(valita_exports.record(jsonValueSchema));
+  return valita_exports.union(
+    valita_exports.null(),
+    valita_exports.string(),
+    valita_exports.number(),
+    valita_exports.bigint(),
+    valita_exports.boolean(),
+    readonly(valita_exports.array(jsonValueSchema)),
+    jsonObjectSchema2
+  );
+});
+var jsonObjectSchema = readonly(valita_exports.record(jsonValueSchema));
+
+// ../zero-cache/src/services/change-source/protocol/current/data.ts
+var beginSchema = valita_exports.object({
+  tag: valita_exports.literal("begin")
+});
+var commitSchema = valita_exports.object({
+  tag: valita_exports.literal("commit")
+});
+var rollbackSchema = valita_exports.object({
+  tag: valita_exports.literal("rollback")
+});
+var relationSchema = valita_exports.object({
+  tag: valita_exports.literal("relation"),
+  schema: valita_exports.string(),
+  name: valita_exports.string(),
+  replicaIdentity: valita_exports.union(
+    valita_exports.literal("default"),
+    valita_exports.literal("nothing"),
+    valita_exports.literal("full"),
+    valita_exports.literal("index")
+  ),
+  keyColumns: valita_exports.array(valita_exports.string())
+});
+var rowSchema = valita_exports.record(jsonValueSchema);
+var insertSchema = valita_exports.object({
+  tag: valita_exports.literal("insert"),
+  relation: relationSchema,
+  new: rowSchema
+});
+var updateSchema = valita_exports.object({
+  tag: valita_exports.literal("update"),
+  relation: relationSchema,
+  key: rowSchema.nullable(),
+  old: rowSchema.nullable(),
+  new: rowSchema
+});
+var deleteSchema = valita_exports.object({
+  tag: valita_exports.literal("delete"),
+  relation: relationSchema,
+  key: rowSchema
+});
+var truncateSchema = valita_exports.object({
+  tag: valita_exports.literal("truncate"),
+  relations: valita_exports.array(relationSchema)
+});
+var identifierSchema = valita_exports.object({
+  schema: valita_exports.string(),
+  name: valita_exports.string()
+});
+var createTableSchema = valita_exports.object({
+  tag: valita_exports.literal("create-table"),
+  spec: tableSpec
+});
+var renameTableSchema = valita_exports.object({
+  tag: valita_exports.literal("rename-table"),
+  old: identifierSchema,
+  new: identifierSchema
+});
+var columnSchema = valita_exports.object({
+  name: valita_exports.string(),
+  spec: columnSpec
+});
+var addColumnSchema = valita_exports.object({
+  tag: valita_exports.literal("add-column"),
+  table: identifierSchema,
+  column: columnSchema
+});
+var updateColumnSchema = valita_exports.object({
+  tag: valita_exports.literal("update-column"),
+  table: identifierSchema,
+  old: columnSchema,
+  new: columnSchema
+});
+var dropColumnSchema = valita_exports.object({
+  tag: valita_exports.literal("drop-column"),
+  table: identifierSchema,
+  column: valita_exports.string()
+});
+var dropTableSchema = valita_exports.object({
+  tag: valita_exports.literal("drop-table"),
+  id: identifierSchema
+});
+var createIndexSchema = valita_exports.object({
+  tag: valita_exports.literal("create-index"),
+  spec: indexSpec
+});
+var dropIndexSchema = valita_exports.object({
+  tag: valita_exports.literal("drop-index"),
+  id: identifierSchema
+});
+var dataChangeSchema = valita_exports.union(
+  insertSchema,
+  updateSchema,
+  deleteSchema,
+  truncateSchema,
+  createTableSchema,
+  renameTableSchema,
+  addColumnSchema,
+  updateColumnSchema,
+  dropColumnSchema,
+  dropTableSchema,
+  createIndexSchema,
+  dropIndexSchema
+);
+
+// ../zero-cache/src/services/change-source/protocol/current/downstream.ts
+var begin = valita_exports.tuple([valita_exports.literal("begin"), beginSchema]);
+var data = valita_exports.tuple([valita_exports.literal("data"), dataChangeSchema]);
+var commit = valita_exports.tuple([
+  valita_exports.literal("commit"),
+  commitSchema,
+  valita_exports.object({ watermark: valita_exports.string() })
+]);
+var rollback = valita_exports.tuple([valita_exports.literal("rollback"), rollbackSchema]);
+var changeStreamDataSchema = valita_exports.union(begin, data, commit, rollback);
+var changeStreamControlSchema = valita_exports.tuple([
+  valita_exports.literal("control"),
+  resetRequiredSchema
+  // TODO: Add statusRequestedSchema
+]);
+var changeStreamMessageSchema = valita_exports.union(
+  changeStreamDataSchema,
+  changeStreamControlSchema
+);
+
+// ../zero-cache/src/services/change-source/protocol/current/path.ts
+var CHANGE_SOURCE_PATH = "/changes/v0/stream";
+
+// ../zero-cache/src/services/change-source/protocol/current/upstream.ts
+var ackSchema = valita_exports.union(
+  valita_exports.tuple([valita_exports.literal("ack")]),
+  valita_exports.tuple([valita_exports.literal("ack"), valita_exports.object({ watermark: valita_exports.string() })])
+);
+var changeSourceUpstreamSchema = ackSchema;
+export {
+  mod_exports as v0
+};
+//# sourceMappingURL=change-protocol.js.map

package/out/change-protocol.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../zero-cache/src/services/change-source/protocol/current/mod.ts", "../../zero-cache/src/services/change-source/protocol/current/control.ts", "../../zero-cache/src/db/specs.ts", "../../zero-cache/src/types/bigint-json.ts", "../../zero-cache/src/services/change-source/protocol/current/data.ts", "../../zero-cache/src/services/change-source/protocol/current/downstream.ts", "../../zero-cache/src/services/change-source/protocol/current/path.ts", "../../zero-cache/src/services/change-source/protocol/current/upstream.ts"],
+  "sourcesContent": ["export * from './control.js';\nexport * from './data.js';\nexport * from './downstream.js';\nexport * from './path.js';\nexport * from './upstream.js';\n", "/**\n * Control plane messages communicate non-content related signals between a\n * ChangeSource and ChangeStreamer. These are not forwarded to subscribers\n * of the ChangeStreamer.\n */\nimport * as v from '../../../../../../shared/src/valita.js';\n\n/**\n * Indicates that upstream has requested an acknowledgment from the ChangeStreamer,\n * often referred to as a heartbeat or keepalive message. The ChangeStreamer responds\n * to these messages immediately.\n */\nexport const ackRequestedSchema = v.object({\n  tag: v.literal('ack-requested'),\n\n  /**\n   * If specified, indicates the latest watermark on upstream, which may encompass\n   * changes that are unrelated to the ChangeStreamer's subscription. If the\n   * ChangeStreamer has consumed and acked all of its data messages, it will include\n   * this watermark in its acknowledgment to indicate that it is caught up and\n   * upstream can purge its logs up to that watermark. If, on the other hand, it is\n   * still processing data messages, it will acknowledge immediately without a\n   * watermark to indicate that it is still \"alive\" but upstream logs still need to\n   * be preserved.\n   */\n  latestUpstreamWatermark: v.string().optional(),\n});\n\n/**\n * Indicates that replication cannot continue and that the replica must be resynced\n * from scratch. The replication-manager will shutdown in response to this message,\n * and upon being restarted, it will wipe the current replica and resync if the\n * `--auto-reset` option is specified.\n *\n * This signal should only be used in well advertised scenarios, and is not suitable\n * as a common occurrence in production.\n */\nexport const resetRequiredSchema = v.object({tag: v.literal('reset-required')});\n", "import type {DeepReadonly} from '../../../shared/src/json.js';\nimport * as v from '../../../shared/src/valita.js';\nimport type {SchemaValue} from '../../../zero-schema/src/table-schema.js';\n\n// Values of the `typtype` column in https://www.postgresql.org/docs/17/catalog-pg-type.html#CATALOG-PG-TYPE\nexport enum PostgresTypeClass {\n  Base = 'b',\n  Composite = 'c',\n  Domain = 'd',\n  Enum = 'e',\n  Pseudo = 'p',\n  Range = 'r',\n  Multirange = 'm',\n}\n\nexport const pgTypeClassSchema = v.union(\n  v.literal(PostgresTypeClass.Base),\n  v.literal(PostgresTypeClass.Composite),\n  v.literal(PostgresTypeClass.Domain),\n  v.literal(PostgresTypeClass.Enum),\n  v.literal(PostgresTypeClass.Pseudo),\n  v.literal(PostgresTypeClass.Range),\n  v.literal(PostgresTypeClass.Multirange),\n);\n\nexport const columnSpec = v.object({\n  pos: v.number(),\n  dataType: v.string(),\n  pgTypeClass: pgTypeClassSchema.optional(),\n  characterMaximumLength: v.number().nullable().optional(),\n  notNull: v.boolean().nullable().optional(),\n  dflt: v.string().nullable().optional(),\n});\n\nexport type ColumnSpec = Readonly<v.Infer<typeof columnSpec>>;\n\nconst publishedColumnSpec = columnSpec.extend({\n  typeOID: v.number(),\n});\n\nexport const liteTableSpec = v.object({\n  name: v.string(),\n  columns: v.record(columnSpec),\n  primaryKey: v.array(v.string()),\n});\n\nexport const tableSpec = liteTableSpec.extend({\n  schema: v.string(),\n});\n\nexport const publishedTableSpec = tableSpec.extend({\n  oid: v.number(),\n  columns: v.record(publishedColumnSpec),\n  publications: v.record(v.object({rowFilter: v.string().nullable()})),\n});\n\nexport type LiteTableSpec = Readonly<v.Infer<typeof liteTableSpec>>;\n\nexport type LiteAndZqlSpec = {\n  tableSpec: LiteTableSpec;\n  zqlSpec: Record<string, SchemaValue>;\n};\n\nexport type TableSpec = Readonly<v.Infer<typeof tableSpec>>;\n\nexport type PublishedTableSpec = Readonly<v.Infer<typeof publishedTableSpec>>;\n\nexport const directionSchema = v.union(v.literal('ASC'), v.literal('DESC'));\n\nexport const liteIndexSpec = v.object({\n  name: v.string(),\n  tableName: v.string(),\n  unique: v.boolean(),\n  columns: v.record(directionSchema),\n});\n\nexport type MutableLiteIndexSpec = v.Infer<typeof liteIndexSpec>;\n\nexport type LiteIndexSpec = Readonly<MutableLiteIndexSpec>;\n\nexport const indexSpec = liteIndexSpec.extend({\n  schema: v.string(),\n});\n\nexport type IndexSpec = DeepReadonly<v.Infer<typeof indexSpec>>;\n", "/**\n * Background for using `json-custom-numbers`:\n *\n * https://neon.tech/blog/parsing-json-from-postgres-in-js\n */\nimport {\n  parse as customParse,\n  stringify as customStringify,\n} from 'json-custom-numbers';\nimport * as v from '../../../shared/src/valita.js';\n\nfunction numberParser(_: unknown, v: string) {\n  const n = +v;\n  if (n >= Number.MIN_SAFE_INTEGER && n <= Number.MAX_SAFE_INTEGER) return n;\n  if (v.indexOf('.') !== -1 || v.indexOf('e') !== -1 || v.indexOf('E') !== -1)\n    return n;\n  return BigInt(v);\n}\n\n// Variant of postgres.JSONValue adapted to include bigints\nexport type JSONValue =\n  | null\n  | string\n  | number\n  | bigint\n  | boolean\n  | Date // serialized as `string`\n  | readonly JSONValue[]\n  | JSONObject;\n\nexport type JSONObject = {readonly [prop: string]: JSONValue | undefined};\n\nexport const jsonValueSchema: v.Type<JSONValue> = v.lazy(() => {\n  const jsonObjectSchema = v.readonly(v.record(jsonValueSchema));\n\n  return v.union(\n    v.null(),\n    v.string(),\n    v.number(),\n    v.bigint(),\n    v.boolean(),\n    v.readonly(v.array(jsonValueSchema)),\n    jsonObjectSchema,\n  );\n});\n\nexport const jsonObjectSchema = v.readonly(v.record(jsonValueSchema));\n\n/**\n * Parses JSON strings that may contain arbitrarily large integers. Integers\n * larger than {@link Number.MAX_SAFE_INTEGER} are deserialized as a `bigint`.\n */\nexport function parse(\n  str: string,\n  reviver?: (k: string, v: unknown) => unknown,\n): JSONValue {\n  return customParse(str, reviver, numberParser);\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction customSerializer(_: string, v: any, type: string) {\n  if (type === 'bigint') return v.toString();\n}\n\n/**\n * Stringifies objects to JSON, supporting objects containing bigint values.\n * Note that the resulting JSON string may not be deserializable by\n * all environments, but it is supported by Postgres. The string should be\n * deserialized with the corresponding {@link parse} method that will represent\n * large numbers as bigints. From there it is up to the application to suitably\n * handle bigints passed to downstream logic.\n */\nexport function stringify(\n  obj: unknown,\n  replacer?:\n    | (string | number)[]\n    | ((key: string, value: unknown) => unknown)\n    | null,\n  indent?: string | number,\n) {\n  return customStringify(obj, replacer, indent, customSerializer);\n}\n\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const BigIntJSON = {\n  parse,\n  stringify,\n} as const;\n", "/**\n * Data plane messages encapsulate changes that are sent by ChangeSources,\n * forwarded / fanned out to subscribers by the ChangeStreamerService, and\n * stored in the Change DB for catchup of old subscribers.\n */\n\nimport * as v from '../../../../../../shared/src/valita.js';\nimport {columnSpec, indexSpec, tableSpec} from '../../../../db/specs.js';\nimport {\n  jsonValueSchema,\n  type JSONObject,\n} from '../../../../types/bigint-json.js';\nimport type {Satisfies} from '../../../../types/satisfies.js';\n\nexport const beginSchema = v.object({\n  tag: v.literal('begin'),\n});\n\nexport const commitSchema = v.object({\n  tag: v.literal('commit'),\n});\n\nexport const rollbackSchema = v.object({\n  tag: v.literal('rollback'),\n});\n\nexport const relationSchema = v.object({\n  tag: v.literal('relation'),\n  schema: v.string(),\n  name: v.string(),\n  replicaIdentity: v.union(\n    v.literal('default'),\n    v.literal('nothing'),\n    v.literal('full'),\n    v.literal('index'),\n  ),\n  keyColumns: v.array(v.string()),\n});\n\nexport const rowSchema = v.record(jsonValueSchema);\n\nexport const insertSchema = v.object({\n  tag: v.literal('insert'),\n  relation: relationSchema,\n  new: rowSchema,\n});\n\nexport const updateSchema = v.object({\n  tag: v.literal('update'),\n  relation: relationSchema,\n  key: rowSchema.nullable(),\n  old: rowSchema.nullable(),\n  new: rowSchema,\n});\n\nexport const deleteSchema = v.object({\n  tag: v.literal('delete'),\n  relation: relationSchema,\n  key: rowSchema,\n});\n\nexport const truncateSchema = v.object({\n  tag: v.literal('truncate'),\n  relations: v.array(relationSchema),\n});\n\nconst identifierSchema = v.object({\n  schema: v.string(),\n  name: v.string(),\n});\n\nexport type Identifier = v.Infer<typeof identifierSchema>;\n\nexport const createTableSchema = v.object({\n  tag: v.literal('create-table'),\n  spec: tableSpec,\n});\n\nexport const renameTableSchema = v.object({\n  tag: v.literal('rename-table'),\n  old: identifierSchema,\n  new: identifierSchema,\n});\n\nconst columnSchema = v.object({\n  name: v.string(),\n  spec: columnSpec,\n});\n\nexport const addColumnSchema = v.object({\n  tag: v.literal('add-column'),\n  table: identifierSchema,\n  column: columnSchema,\n});\n\nexport const updateColumnSchema = v.object({\n  tag: v.literal('update-column'),\n  table: identifierSchema,\n  old: columnSchema,\n  new: columnSchema,\n});\n\nexport const dropColumnSchema = v.object({\n  tag: v.literal('drop-column'),\n  table: identifierSchema,\n  column: v.string(),\n});\n\nexport const dropTableSchema = v.object({\n  tag: v.literal('drop-table'),\n  id: identifierSchema,\n});\n\nexport const createIndexSchema = v.object({\n  tag: v.literal('create-index'),\n  spec: indexSpec,\n});\n\nexport const dropIndexSchema = v.object({\n  tag: v.literal('drop-index'),\n  id: identifierSchema,\n});\n\nexport type MessageBegin = v.Infer<typeof beginSchema>;\nexport type MessageCommit = v.Infer<typeof commitSchema>;\nexport type MessageRollback = v.Infer<typeof rollbackSchema>;\n\nexport type MessageRelation = v.Infer<typeof relationSchema>;\nexport type MessageInsert = v.Infer<typeof insertSchema>;\nexport type MessageUpdate = v.Infer<typeof updateSchema>;\nexport type MessageDelete = v.Infer<typeof deleteSchema>;\nexport type MessageTruncate = v.Infer<typeof truncateSchema>;\n\nexport type TableCreate = v.Infer<typeof createTableSchema>;\nexport type TableRename = v.Infer<typeof renameTableSchema>;\nexport type ColumnAdd = v.Infer<typeof addColumnSchema>;\nexport type ColumnUpdate = v.Infer<typeof updateColumnSchema>;\nexport type ColumnDrop = v.Infer<typeof dropColumnSchema>;\nexport type TableDrop = v.Infer<typeof dropTableSchema>;\nexport type IndexCreate = v.Infer<typeof createIndexSchema>;\nexport type IndexDrop = v.Infer<typeof dropIndexSchema>;\n\nexport const dataChangeSchema = v.union(\n  insertSchema,\n  updateSchema,\n  deleteSchema,\n  truncateSchema,\n  createTableSchema,\n  renameTableSchema,\n  addColumnSchema,\n  updateColumnSchema,\n  dropColumnSchema,\n  dropTableSchema,\n  createIndexSchema,\n  dropIndexSchema,\n);\n\nexport type DataChange = Satisfies<\n  JSONObject, // guarantees serialization over IPC or network\n  v.Infer<typeof dataChangeSchema>\n>;\n\nexport type Change =\n  | MessageBegin\n  | DataChange\n  | MessageCommit\n  | MessageRollback;\n\nexport type ChangeTag = Change['tag'];\n", "import * as v from '../../../../../../shared/src/valita.js';\nimport {resetRequiredSchema} from './control.js';\nimport {\n  beginSchema,\n  commitSchema,\n  dataChangeSchema,\n  rollbackSchema,\n} from './data.js';\n\nconst begin = v.tuple([v.literal('begin'), beginSchema]);\nconst data = v.tuple([v.literal('data'), dataChangeSchema]);\nconst commit = v.tuple([\n  v.literal('commit'),\n  commitSchema,\n  v.object({watermark: v.string()}),\n]);\nconst rollback = v.tuple([v.literal('rollback'), rollbackSchema]);\n\nexport type Begin = v.Infer<typeof begin>;\nexport type Data = v.Infer<typeof data>;\nexport type Commit = v.Infer<typeof commit>;\nexport type Rollback = v.Infer<typeof rollback>;\n\nexport const changeStreamDataSchema = v.union(begin, data, commit, rollback);\nexport type ChangeStreamData = v.Infer<typeof changeStreamDataSchema>;\n\nexport const changeStreamControlSchema = v.tuple([\n  v.literal('control'),\n  resetRequiredSchema, // TODO: Add statusRequestedSchema\n]);\nexport type ChangeStreamControl = v.Infer<typeof changeStreamControlSchema>;\n\n/** Downstream messages consist of data plane and control plane messages. */\nexport const changeStreamMessageSchema = v.union(\n  changeStreamDataSchema,\n  changeStreamControlSchema,\n);\n\nexport type ChangeStreamMessage = v.Infer<typeof changeStreamMessageSchema>;\n", "/**\n * The path required for a custom Change Source endpoint implementing the\n * Change Source protocol. The version in the path indicates the current\n * (i.e. latest) protocol version of the code, and is the only protocol\n * supported by the code.\n *\n * Eventually, when a backwards incompatible change is made to the protocol,\n * the version will be bumped to ensure that the protocol is only used for an\n * endpoint that explicitly understands it. (While the protocol is in flux\n * and being developed, a starting \"v0\" version will not follow this\n * convention.)\n *\n * Historic versions are kept in the source code (e.g. v1, v2, etc.) to\n * allow Change Source implementations to import and support multiple\n * versions simultaneously. This is necessary to seamlessly transitioning\n * from a `zero-cache` speaking one version to a `zero-cache` speaking\n * another.\n */\nexport const CHANGE_SOURCE_PATH = '/changes/v0/stream';\n", "import * as v from '../../../../../../shared/src/valita.js';\n\n/**\n * An acknowledgement is sent from the Change Streamer to the Change Source to\n * either or both:\n * * Indicate that it is connected and running, e.g. in response to an\n *   \"ack-requested\" message.\n * * Indicate that it is caught up to a specific `watermark`.\n */\nexport const ackSchema = v.union(\n  v.tuple([v.literal('ack')]),\n  v.tuple([v.literal('ack'), v.object({watermark: v.string()})]),\n);\n\n/** At the moment, the only upstream messages are acks.  */\nexport const changeSourceUpstreamSchema = ackSchema;\nexport type ChangeSourceUpstream = v.Infer<typeof changeSourceUpstreamSchema>;\n"],
+  "mappings": "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",
+  "names": ["jsonObjectSchema"]
+}