@rocicorp/zero 0.26.1 → 0.26.2-canary.1

package/out/zero-cache/src/services/change-source/protocol/current/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/data.ts"],"sourcesContent":["/**\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 {\n  jsonValueSchema,\n  type JSONObject,\n} from '../../../../../../shared/src/bigint-json.ts';\nimport {must} from '../../../../../../shared/src/must.ts';\nimport * as v from '../../../../../../shared/src/valita.ts';\nimport {columnSpec, indexSpec, tableSpec} from '../../../../db/specs.ts';\nimport type {Satisfies} from '../../../../types/satisfies.ts';\nimport {jsonObjectSchema} from './json.ts';\n\nexport const beginSchema = v.object({\n  tag: v.literal('begin'),\n  // The format of values of \"json\"-typed columns (e.g. \"JSON\" and \"JSONB\").\n  // - 'p' is for parsed JSON, which may include JSON values or JSON objects.\n  //   These values are parsed and stringified at every process boundary\n  //   between the change-source and the replica.\n  // - 's' is for stringified JSON. These values skip the parsing and\n  //   stringification, and are directly ferried to the replica as a JSON\n  //   string. For JSON values this improves performance by 20~25% in the\n  //   change-streamer and 25~30% in the replicator.\n  //\n  // If absent, the format is assumed to be 'p' (parsed JSON objects/values).\n  json: v.literalUnion('p', 's').optional(),\n\n  // Directs the change-streamer to skip the ACK for the corresponding commit.\n  skipAck: v.boolean().optional(),\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\nconst rowKeySchema = v.object({\n  // The columns used to identify a row in insert, update, and delete changes.\n  columns: v.array(v.string()),\n\n  // An optional qualifier identifying how the key is chosen. Currently this\n  // is postgres-specific, describing the REPLICA IDENTITY, for which replica\n  // identity 'full' (FULL) is handled differently; the replicator handles\n  // these tables by extracting a row key from the full row based on the\n  // table's PRIMARY KEY or UNIQUE INDEX.\n  type: v.literalUnion('default', 'nothing', 'full', 'index').optional(),\n});\n\nexport const relationSchema = v\n  .object({\n    schema: v.string(),\n    name: v.string(),\n\n    // This will become required.\n    rowKey: rowKeySchema.optional(),\n\n    /** Deprecated: set the rowKey.columns instead. */\n    keyColumns: v.array(v.string()).optional(),\n    /** Deprecated: set the rowKey.columns instead. */\n    replicaIdentity: v\n      .literalUnion('default', 'nothing', 'full', 'index')\n      .optional(),\n  })\n  .map(rel => {\n    const {rowKey, ...rest} = rel;\n    if (rowKey) {\n      return {...rest, rowKey};\n    }\n    return {\n      ...rest,\n      rowKey: {\n        columns: must(rel.keyColumns),\n        type: rel.replicaIdentity,\n      },\n    };\n  });\n\n// The eventual fate of relationSchema\nexport const newRelationSchema = v.object({\n  schema: v.string(),\n  name: v.string(),\n\n  rowKey: rowKeySchema,\n});\n\n// TableMetadata contains table-related configuration that does not affect the\n// actual data in the table, but rather how the table's change messages are\n// handled. The is an opaque object that clients must track (and update) based\n// on `create-table`, `add-column`, and `table-update-metadata` messages, and\n// pass in BackfillRequests when there are columns to be backfilled.\n//\n// Note that the backfill-related change-source implementation does, however,\n// rely on the rowKey (columns) being specified in the message.\nexport const tableMetadataSchema = v\n  .object({rowKey: v.record(jsonValueSchema)})\n  .rest(jsonValueSchema);\n\nexport type TableMetadata = v.Infer<typeof tableMetadataSchema>;\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` is present if the update changed the key of the row, or if the\n  // table's replicaIdentity === 'full'\n  key: rowSchema.nullable(),\n  // `new` is the full row (and not just the updated columns). This is\n  // necessary for \"catchup\" replication scenarios such as adding tables\n  // to a publication, or resharding.\n  new: rowSchema,\n});\n\nexport const deleteSchema = v.object({\n  tag: v.literal('delete'),\n  relation: relationSchema,\n  // key is the full row if replicaIdentity === 'full'\n  key: rowSchema,\n});\n\nexport const truncateSchema = v.object({\n  tag: v.literal('truncate'),\n  relations: v.array(relationSchema),\n});\n\nexport const identifierSchema = v.object({\n  schema: v.string(),\n  name: v.string(),\n});\n\nexport type Identifier = v.Infer<typeof identifierSchema>;\n\n// A BackfillID is an upstream specific stable identifier for a column\n// that needs backfilling. This id is used to ensure that the schema, table,\n// and column names of a requested backfill still match the original\n// underlying upstream ID.\n//\n// The change-streamer stores these IDs as opaque values while a column is\n// being backfilled, and initiates new change-source streams with the IDs\n// in order to restart backfills that did not complete in previous sessions.\nexport const backfillIDSchema = jsonObjectSchema;\n\nexport type BackfillID = v.Infer<typeof backfillIDSchema>;\n\nexport const createTableSchema = v.object({\n  tag: v.literal('create-table'),\n  spec: tableSpec,\n\n  // This must be set by change source implementations that support\n  // table/column backfill.\n  //\n  // TODO: to simplify the protocol, see if we can make this required\n  metadata: tableMetadataSchema.optional(),\n\n  // Indicate that columns of the table require backfilling. These columns\n  // should be created on the replica but not yet synced the clients.\n  //\n  // ## State Persistence\n  //\n  // To obviate the need for change-source implementations to persist state\n  // related to backfill progress, the change-source only tracks backfills\n  // **for the current session**. In the event that the session is interrupted\n  // before columns have been fully backfilled, it is the responsibility of the\n  // change-streamer to send {@link BackfillRequest}s when it reconnects.\n  //\n  // This means that the change-streamer must track and persist:\n  // * the backfill IDs of the columns requiring backfilling\n  // * the most current table metadata of the associated table(s)\n  //\n  // The change-streamer then uses this information to send backfill requests\n  // when it reconnects.\n  backfill: v.record(backfillIDSchema).optional(),\n});\n\nexport const renameTableSchema = v.object({\n  tag: v.literal('rename-table'),\n  old: identifierSchema,\n  new: identifierSchema,\n});\n\nexport const updateTableMetadataSchema = v.object({\n  tag: v.literal('update-table-metadata'),\n  table: identifierSchema,\n  old: tableMetadataSchema,\n  new: tableMetadataSchema,\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  // This must be set by change source implementations that support\n  // table/column backfill.\n  //\n  // TODO: to simplify the protocol, see if we can make this required\n  tableMetadata: tableMetadataSchema.optional(),\n\n  // See documentation for the `backfill` field of the `create-table` change.\n  backfill: backfillIDSchema.optional(),\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 const downloadStatusSchema = v.object({\n  rows: v.number(),\n  totalRows: v.number(),\n  totalBytes: v.number().optional(),\n});\n\nexport type DownloadStatus = v.Infer<typeof downloadStatusSchema>;\n\n// A batch of rows from a single table containing column values\n// to be backfilled.\nexport const backfillSchema = v.object({\n  tag: v.literal('backfill'),\n\n  relation: newRelationSchema,\n\n  // The columns to be backfilled. `rowKey` columns are automatically excluded,\n  // which means that this field may be empty.\n  columns: v.array(v.string()),\n\n  // The watermark at which the backfill data was queried. Note that this\n  // generally will be different from the commit watermarks of the main change\n  // stream, and in particular, the commit watermark of the backfill change's\n  // enclosing transaction.\n  watermark: v.string(),\n\n  // A batch of row values, each row consisting of the `rowKey`\n  // values, followed by the `column` values, in the same order in which\n  // the column names appear in their respective fields, e.g.\n  //\n  // ```\n  // [\n  //   [...rowKeyValues, ...columnValues],  // row 1\n  //   [...rowKeyValues, ...columnValues],  // row 2\n  // ]\n  // ```\n  rowValues: v.array(v.array(jsonValueSchema)),\n\n  // Optionally includes the progress of the backfill operation,\n  // for display purposes.\n  status: downloadStatusSchema.optional(),\n});\n\n// Indicates that the backfill for the specified columns have\n// been successfully backfilled and can be published to clients.\nexport const backfillCompletedSchema = v.object({\n  tag: v.literal('backfill-completed'),\n\n  relation: newRelationSchema,\n\n  // The columns to be backfilled. `rowKey` columns are automatically excluded,\n  // which means that this field may be empty.\n  columns: v.array(v.string()),\n\n  // The watermark at which the backfill data was queried. Note that this\n  // generally will be different from the commit watermarks of the main change\n  // stream, and in particular, the commit watermark of the backfill change's\n  // enclosing transaction.\n  watermark: v.string(),\n\n  // Optionally includes the final status of the backfill operation,\n  // for display purposes.\n  status: downloadStatusSchema.optional(),\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 MessageBackfill = v.Infer<typeof backfillSchema>;\n\nexport type TableCreate = v.Infer<typeof createTableSchema>;\nexport type TableRename = v.Infer<typeof renameTableSchema>;\nexport type TableUpdateMetadata = v.Infer<typeof updateTableMetadataSchema>;\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>;\nexport type BackfillCompleted = v.Infer<typeof backfillCompletedSchema>;\n\nexport const dataChangeSchema = v.union(\n  insertSchema,\n  updateSchema,\n  deleteSchema,\n  truncateSchema,\n  backfillSchema,\n);\n\n// Note: keep in sync or the tag tests will fail\nconst dataChangeTags = [\n  'insert',\n  'update',\n  'delete',\n  'truncate',\n  'backfill',\n] as const;\n\nconst dataChangeTagsSchema = v.literalUnion(...dataChangeTags);\n\nexport type DataChange = Satisfies<\n  JSONObject, // guarantees serialization over IPC or network\n  v.Infer<typeof dataChangeSchema>\n>;\n\nexport type DataChangeTag = v.Infer<typeof dataChangeTagsSchema>;\n\nconst schemaChanges = [\n  createTableSchema,\n  renameTableSchema,\n  updateTableMetadataSchema,\n  addColumnSchema,\n  updateColumnSchema,\n  dropColumnSchema,\n  dropTableSchema,\n  createIndexSchema,\n  dropIndexSchema,\n  backfillCompletedSchema,\n] as const;\n\n// Note: keep in sync or the tag tests will fail\nconst schemaChangeTags = [\n  'create-table',\n  'rename-table',\n  'update-table-metadata',\n  'add-column',\n  'update-column',\n  'drop-column',\n  'drop-table',\n  'create-index',\n  'drop-index',\n  'backfill-completed',\n] as const;\n\nexport const schemaChangeSchema = v.union(...schemaChanges);\n\nconst schemaChangeTagsSchema = v.literalUnion(...schemaChangeTags);\n\nexport type SchemaChange = Satisfies<\n  JSONObject,\n  v.Infer<typeof schemaChangeSchema>\n>;\n\nexport type SchemaChangeTag = v.Infer<typeof schemaChangeTagsSchema>;\n\nexport type DataOrSchemaChange = DataChange | SchemaChange;\n\nexport type Change =\n  | MessageBegin\n  | DataOrSchemaChange\n  | MessageCommit\n  | MessageRollback;\n\nexport type ChangeTag = Change['tag'];\n\nconst schemaChangeTagSet = new Set<string>(schemaChangeTags);\n\nexport function isSchemaChange(change: Change): change is SchemaChange {\n  return schemaChangeTagSet.has(change.tag);\n}\n\nconst dataChangeTagSet = new Set<string>(dataChangeTags);\n\nexport function isDataChange(change: Change): change is DataChange {\n  return dataChangeTagSet.has(change.tag);\n}\n"],"names":["v.object","v.literal","v.literalUnion","v.boolean","v.array","v.string","v.record","v.number","v.union"],"mappings":"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"}
+{"version":3,"file":"data.js","names":[],"sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/data.ts"],"sourcesContent":["/**\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 {\n  jsonValueSchema,\n  type JSONObject,\n} from '../../../../../../shared/src/bigint-json.ts';\nimport {must} from '../../../../../../shared/src/must.ts';\nimport * as v from '../../../../../../shared/src/valita.ts';\nimport {columnSpec, indexSpec, tableSpec} from '../../../../db/specs.ts';\nimport type {Satisfies} from '../../../../types/satisfies.ts';\nimport {jsonObjectSchema} from './json.ts';\n\nexport const beginSchema = v.object({\n  tag: v.literal('begin'),\n  // The format of values of \"json\"-typed columns (e.g. \"JSON\" and \"JSONB\").\n  // - 'p' is for parsed JSON, which may include JSON values or JSON objects.\n  //   These values are parsed and stringified at every process boundary\n  //   between the change-source and the replica.\n  // - 's' is for stringified JSON. These values skip the parsing and\n  //   stringification, and are directly ferried to the replica as a JSON\n  //   string. For JSON values this improves performance by 20~25% in the\n  //   change-streamer and 25~30% in the replicator.\n  //\n  // If absent, the format is assumed to be 'p' (parsed JSON objects/values).\n  json: v.literalUnion('p', 's').optional(),\n\n  // Directs the change-streamer to skip the ACK for the corresponding commit.\n  skipAck: v.boolean().optional(),\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\nconst rowKeySchema = v.object({\n  // The columns used to identify a row in insert, update, and delete changes.\n  columns: v.array(v.string()),\n\n  // An optional qualifier identifying how the key is chosen. Currently this\n  // is postgres-specific, describing the REPLICA IDENTITY, for which replica\n  // identity 'full' (FULL) is handled differently; the replicator handles\n  // these tables by extracting a row key from the full row based on the\n  // table's PRIMARY KEY or UNIQUE INDEX.\n  type: v.literalUnion('default', 'nothing', 'full', 'index').optional(),\n});\n\nexport const relationSchema = v\n  .object({\n    schema: v.string(),\n    name: v.string(),\n\n    // This will become required.\n    rowKey: rowKeySchema.optional(),\n\n    /** Deprecated: set the rowKey.columns instead. */\n    keyColumns: v.array(v.string()).optional(),\n    /** Deprecated: set the rowKey.columns instead. */\n    replicaIdentity: v\n      .literalUnion('default', 'nothing', 'full', 'index')\n      .optional(),\n  })\n  .map(rel => {\n    const {rowKey, ...rest} = rel;\n    if (rowKey) {\n      return {...rest, rowKey};\n    }\n    return {\n      ...rest,\n      rowKey: {\n        columns: must(rel.keyColumns),\n        type: rel.replicaIdentity,\n      },\n    };\n  });\n\n// The eventual fate of relationSchema\nexport const newRelationSchema = v.object({\n  schema: v.string(),\n  name: v.string(),\n\n  rowKey: rowKeySchema,\n});\n\n// TableMetadata contains table-related configuration that does not affect the\n// actual data in the table, but rather how the table's change messages are\n// handled. The is an opaque object that clients must track (and update) based\n// on `create-table`, `add-column`, and `table-update-metadata` messages, and\n// pass in BackfillRequests when there are columns to be backfilled.\n//\n// Note that the backfill-related change-source implementation does, however,\n// rely on the rowKey (columns) being specified in the message.\nexport const tableMetadataSchema = v\n  .object({rowKey: v.record(jsonValueSchema)})\n  .rest(jsonValueSchema);\n\nexport type TableMetadata = v.Infer<typeof tableMetadataSchema>;\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` is present if the update changed the key of the row, or if the\n  // table's replicaIdentity === 'full'\n  key: rowSchema.nullable(),\n  // `new` is the full row (and not just the updated columns). This is\n  // necessary for \"catchup\" replication scenarios such as adding tables\n  // to a publication, or resharding.\n  new: rowSchema,\n});\n\nexport const deleteSchema = v.object({\n  tag: v.literal('delete'),\n  relation: relationSchema,\n  // key is the full row if replicaIdentity === 'full'\n  key: rowSchema,\n});\n\nexport const truncateSchema = v.object({\n  tag: v.literal('truncate'),\n  relations: v.array(relationSchema),\n});\n\nexport const identifierSchema = v.object({\n  schema: v.string(),\n  name: v.string(),\n});\n\nexport type Identifier = v.Infer<typeof identifierSchema>;\n\n// A BackfillID is an upstream specific stable identifier for a column\n// that needs backfilling. This id is used to ensure that the schema, table,\n// and column names of a requested backfill still match the original\n// underlying upstream ID.\n//\n// The change-streamer stores these IDs as opaque values while a column is\n// being backfilled, and initiates new change-source streams with the IDs\n// in order to restart backfills that did not complete in previous sessions.\nexport const backfillIDSchema = jsonObjectSchema;\n\nexport type BackfillID = v.Infer<typeof backfillIDSchema>;\n\nexport const createTableSchema = v.object({\n  tag: v.literal('create-table'),\n  spec: tableSpec,\n\n  // This must be set by change source implementations that support\n  // table/column backfill.\n  //\n  // TODO: to simplify the protocol, see if we can make this required\n  metadata: tableMetadataSchema.optional(),\n\n  // Indicate that columns of the table require backfilling. These columns\n  // should be created on the replica but not yet synced the clients.\n  //\n  // ## State Persistence\n  //\n  // To obviate the need for change-source implementations to persist state\n  // related to backfill progress, the change-source only tracks backfills\n  // **for the current session**. In the event that the session is interrupted\n  // before columns have been fully backfilled, it is the responsibility of the\n  // change-streamer to send {@link BackfillRequest}s when it reconnects.\n  //\n  // This means that the change-streamer must track and persist:\n  // * the backfill IDs of the columns requiring backfilling\n  // * the most current table metadata of the associated table(s)\n  //\n  // The change-streamer then uses this information to send backfill requests\n  // when it reconnects.\n  backfill: v.record(backfillIDSchema).optional(),\n});\n\nexport const renameTableSchema = v.object({\n  tag: v.literal('rename-table'),\n  old: identifierSchema,\n  new: identifierSchema,\n});\n\nexport const updateTableMetadataSchema = v.object({\n  tag: v.literal('update-table-metadata'),\n  table: identifierSchema,\n  old: tableMetadataSchema,\n  new: tableMetadataSchema,\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  // This must be set by change source implementations that support\n  // table/column backfill.\n  //\n  // TODO: to simplify the protocol, see if we can make this required\n  tableMetadata: tableMetadataSchema.optional(),\n\n  // See documentation for the `backfill` field of the `create-table` change.\n  backfill: backfillIDSchema.optional(),\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 const downloadStatusSchema = v.object({\n  rows: v.number(),\n  totalRows: v.number(),\n  totalBytes: v.number().optional(),\n});\n\nexport type DownloadStatus = v.Infer<typeof downloadStatusSchema>;\n\n// A batch of rows from a single table containing column values\n// to be backfilled.\nexport const backfillSchema = v.object({\n  tag: v.literal('backfill'),\n\n  relation: newRelationSchema,\n\n  // The columns to be backfilled. `rowKey` columns are automatically excluded,\n  // which means that this field may be empty.\n  columns: v.array(v.string()),\n\n  // The watermark at which the backfill data was queried. Note that this\n  // generally will be different from the commit watermarks of the main change\n  // stream, and in particular, the commit watermark of the backfill change's\n  // enclosing transaction.\n  watermark: v.string(),\n\n  // A batch of row values, each row consisting of the `rowKey`\n  // values, followed by the `column` values, in the same order in which\n  // the column names appear in their respective fields, e.g.\n  //\n  // ```\n  // [\n  //   [...rowKeyValues, ...columnValues],  // row 1\n  //   [...rowKeyValues, ...columnValues],  // row 2\n  // ]\n  // ```\n  rowValues: v.array(v.array(jsonValueSchema)),\n\n  // Optionally includes the progress of the backfill operation,\n  // for display purposes.\n  status: downloadStatusSchema.optional(),\n});\n\n// Indicates that the backfill for the specified columns have\n// been successfully backfilled and can be published to clients.\nexport const backfillCompletedSchema = v.object({\n  tag: v.literal('backfill-completed'),\n\n  relation: newRelationSchema,\n\n  // The columns to be backfilled. `rowKey` columns are automatically excluded,\n  // which means that this field may be empty.\n  columns: v.array(v.string()),\n\n  // The watermark at which the backfill data was queried. Note that this\n  // generally will be different from the commit watermarks of the main change\n  // stream, and in particular, the commit watermark of the backfill change's\n  // enclosing transaction.\n  watermark: v.string(),\n\n  // Optionally includes the final status of the backfill operation,\n  // for display purposes.\n  status: downloadStatusSchema.optional(),\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 MessageBackfill = v.Infer<typeof backfillSchema>;\n\nexport type TableCreate = v.Infer<typeof createTableSchema>;\nexport type TableRename = v.Infer<typeof renameTableSchema>;\nexport type TableUpdateMetadata = v.Infer<typeof updateTableMetadataSchema>;\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>;\nexport type BackfillCompleted = v.Infer<typeof backfillCompletedSchema>;\n\nexport const dataChangeSchema = v.union(\n  insertSchema,\n  updateSchema,\n  deleteSchema,\n  truncateSchema,\n  backfillSchema,\n);\n\n// Note: keep in sync or the tag tests will fail\nconst dataChangeTags = [\n  'insert',\n  'update',\n  'delete',\n  'truncate',\n  'backfill',\n] as const;\n\nconst dataChangeTagsSchema = v.literalUnion(...dataChangeTags);\n\nexport type DataChange = Satisfies<\n  JSONObject, // guarantees serialization over IPC or network\n  v.Infer<typeof dataChangeSchema>\n>;\n\nexport type DataChangeTag = v.Infer<typeof dataChangeTagsSchema>;\n\nconst schemaChanges = [\n  createTableSchema,\n  renameTableSchema,\n  updateTableMetadataSchema,\n  addColumnSchema,\n  updateColumnSchema,\n  dropColumnSchema,\n  dropTableSchema,\n  createIndexSchema,\n  dropIndexSchema,\n  backfillCompletedSchema,\n] as const;\n\n// Note: keep in sync or the tag tests will fail\nconst schemaChangeTags = [\n  'create-table',\n  'rename-table',\n  'update-table-metadata',\n  'add-column',\n  'update-column',\n  'drop-column',\n  'drop-table',\n  'create-index',\n  'drop-index',\n  'backfill-completed',\n] as const;\n\nexport const schemaChangeSchema = v.union(...schemaChanges);\n\nconst schemaChangeTagsSchema = v.literalUnion(...schemaChangeTags);\n\nexport type SchemaChange = Satisfies<\n  JSONObject,\n  v.Infer<typeof schemaChangeSchema>\n>;\n\nexport type SchemaChangeTag = v.Infer<typeof schemaChangeTagsSchema>;\n\nexport type DataOrSchemaChange = DataChange | SchemaChange;\n\nexport type Change =\n  | MessageBegin\n  | DataOrSchemaChange\n  | MessageCommit\n  | MessageRollback;\n\nexport type ChangeTag = Change['tag'];\n\nconst schemaChangeTagSet = new Set<string>(schemaChangeTags);\n\nexport function isSchemaChange(change: Change): change is SchemaChange {\n  return schemaChangeTagSet.has(change.tag);\n}\n\nconst dataChangeTagSet = new Set<string>(dataChangeTags);\n\nexport function isDataChange(change: Change): change is DataChange {\n  return dataChangeTagSet.has(change.tag);\n}\n"],"mappings":"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"}

package/out/zero-cache/src/services/change-source/protocol/current/downstream.js

@@ -1,37 +1,25 @@
-import "../../../../../../shared/src/valita.js";
+import { valita_exports } from "../../../../../../shared/src/valita.js";
 import { resetRequiredSchema } from "./control.js";
-import { beginSchema, dataChangeSchema, schemaChangeSchema, commitSchema, rollbackSchema } from "./data.js";
+import { beginSchema, commitSchema, dataChangeSchema, rollbackSchema, schemaChangeSchema } from "./data.js";
 import { downstreamStatusMessageSchema } from "./status.js";
-import { tuple, literal, object, string, union } from "@badrap/valita";
-const begin = tuple([
-  literal("begin"),
-  beginSchema,
-  object({ commitWatermark: string() })
+//#region ../zero-cache/src/services/change-source/protocol/current/downstream.ts
+var begin = valita_exports.tuple([
+	valita_exports.literal("begin"),
+	beginSchema,
+	valita_exports.object({ commitWatermark: valita_exports.string() })
 ]);
-const data = tuple([
-  literal("data"),
-  union(dataChangeSchema, schemaChangeSchema)
+var data = valita_exports.tuple([valita_exports.literal("data"), valita_exports.union(dataChangeSchema, schemaChangeSchema)]);
+var commit = valita_exports.tuple([
+	valita_exports.literal("commit"),
+	commitSchema,
+	valita_exports.object({ watermark: valita_exports.string() })
 ]);
-const commit = tuple([
-  literal("commit"),
-  commitSchema,
-  object({ watermark: string() })
-]);
-const rollback = tuple([literal("rollback"), rollbackSchema]);
-const changeStreamDataSchema = union(begin, data, commit, rollback);
-const changeStreamControlSchema = tuple([
-  literal("control"),
-  resetRequiredSchema
-  // TODO: Add statusRequestedSchema
-]);
-const changeStreamMessageSchema = union(
-  changeStreamDataSchema,
-  changeStreamControlSchema,
-  downstreamStatusMessageSchema
-);
-export {
-  changeStreamControlSchema,
-  changeStreamDataSchema,
-  changeStreamMessageSchema
-};
-//# sourceMappingURL=downstream.js.map
+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]);
+/** Downstream messages consist of data plane and control plane messages. */
+var changeStreamMessageSchema = valita_exports.union(changeStreamDataSchema, changeStreamControlSchema, downstreamStatusMessageSchema);
+//#endregion
+export { changeStreamControlSchema, changeStreamDataSchema, changeStreamMessageSchema };
+
+//# sourceMappingURL=downstream.js.map

package/out/zero-cache/src/services/change-source/protocol/current/downstream.js.map

@@ -1 +1 @@
-{"version":3,"file":"downstream.js","sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/downstream.ts"],"sourcesContent":["import * as v from '../../../../../../shared/src/valita.ts';\nimport {resetRequiredSchema} from './control.ts';\nimport {\n  beginSchema,\n  commitSchema,\n  dataChangeSchema,\n  rollbackSchema,\n  schemaChangeSchema,\n} from './data.ts';\nimport {downstreamStatusMessageSchema} from './status.ts';\n\nconst begin = v.tuple([\n  v.literal('begin'),\n  beginSchema,\n  v.object({commitWatermark: v.string()}),\n]);\nconst data = v.tuple([\n  v.literal('data'),\n  v.union(dataChangeSchema, schemaChangeSchema),\n]);\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  downstreamStatusMessageSchema,\n);\n\nexport type ChangeStreamMessage = v.Infer<typeof changeStreamMessageSchema>;\n"],"names":["v.tuple","v.literal","v.object","v.string","v.union"],"mappings":";;;;;AAWA,MAAM,QAAQA,MAAQ;AAAA,EACpBC,QAAU,OAAO;AAAA,EACjB;AAAA,EACAC,OAAS,EAAC,iBAAiBC,UAAW;AACxC,CAAC;AACD,MAAM,OAAOH,MAAQ;AAAA,EACnBC,QAAU,MAAM;AAAA,EAChBG,MAAQ,kBAAkB,kBAAkB;AAC9C,CAAC;AACD,MAAM,SAASJ,MAAQ;AAAA,EACrBC,QAAU,QAAQ;AAAA,EAClB;AAAA,EACAC,OAAS,EAAC,WAAWC,UAAW;AAClC,CAAC;AACD,MAAM,WAAWH,MAAQ,CAACC,QAAU,UAAU,GAAG,cAAc,CAAC;AAOzD,MAAM,yBAAyBG,MAAQ,OAAO,MAAM,QAAQ,QAAQ;AAGpE,MAAM,4BAA4BJ,MAAQ;AAAA,EAC/CC,QAAU,SAAS;AAAA,EACnB;AAAA;AACF,CAAC;AAIM,MAAM,4BAA4BG;AAAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF;"}
+{"version":3,"file":"downstream.js","names":[],"sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/downstream.ts"],"sourcesContent":["import * as v from '../../../../../../shared/src/valita.ts';\nimport {resetRequiredSchema} from './control.ts';\nimport {\n  beginSchema,\n  commitSchema,\n  dataChangeSchema,\n  rollbackSchema,\n  schemaChangeSchema,\n} from './data.ts';\nimport {downstreamStatusMessageSchema} from './status.ts';\n\nconst begin = v.tuple([\n  v.literal('begin'),\n  beginSchema,\n  v.object({commitWatermark: v.string()}),\n]);\nconst data = v.tuple([\n  v.literal('data'),\n  v.union(dataChangeSchema, schemaChangeSchema),\n]);\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  downstreamStatusMessageSchema,\n);\n\nexport type ChangeStreamMessage = v.Infer<typeof changeStreamMessageSchema>;\n"],"mappings":";;;;;AAWA,IAAM,QAAQ,eAAE,MAAM;CACpB,eAAE,QAAQ,QAAQ;CAClB;CACA,eAAE,OAAO,EAAC,iBAAiB,eAAE,QAAQ,EAAC,CAAC;CACxC,CAAC;AACF,IAAM,OAAO,eAAE,MAAM,CACnB,eAAE,QAAQ,OAAO,EACjB,eAAE,MAAM,kBAAkB,mBAAmB,CAC9C,CAAC;AACF,IAAM,SAAS,eAAE,MAAM;CACrB,eAAE,QAAQ,SAAS;CACnB;CACA,eAAE,OAAO,EAAC,WAAW,eAAE,QAAQ,EAAC,CAAC;CAClC,CAAC;AACF,IAAM,WAAW,eAAE,MAAM,CAAC,eAAE,QAAQ,WAAW,EAAE,eAAe,CAAC;AAOjE,IAAa,yBAAyB,eAAE,MAAM,OAAO,MAAM,QAAQ,SAAS;AAG5E,IAAa,4BAA4B,eAAE,MAAM,CAC/C,eAAE,QAAQ,UAAU,EACpB,oBACD,CAAC;;AAIF,IAAa,4BAA4B,eAAE,MACzC,wBACA,2BACA,8BACD"}

package/out/zero-cache/src/services/change-source/protocol/current/json.js

@@ -1,19 +1,8 @@
 import * as v from "@badrap/valita";
-const jsonValueSchema = v.lazy(
-  () => v.union(
-    v.null(),
-    v.string(),
-    v.boolean(),
-    v.number(),
-    v.array(jsonValueSchema),
-    jsonObjectSchema
-  )
-);
-const jsonObjectSchema = v.record(
-  v.union(jsonValueSchema, v.undefined())
-);
-export {
-  jsonObjectSchema,
-  jsonValueSchema
-};
-//# sourceMappingURL=json.js.map
+//#region ../zero-cache/src/services/change-source/protocol/current/json.ts
+var jsonValueSchema = v.lazy(() => v.union(v.null(), v.string(), v.boolean(), v.number(), v.array(jsonValueSchema), jsonObjectSchema));
+var jsonObjectSchema = v.record(v.union(jsonValueSchema, v.undefined()));
+//#endregion
+export { jsonObjectSchema, jsonValueSchema };
+
+//# sourceMappingURL=json.js.map

package/out/zero-cache/src/services/change-source/protocol/current/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/json.ts"],"sourcesContent":["import * as v from '@badrap/valita';\n\nexport type JSONValue =\n  | null\n  | string\n  | boolean\n  | number\n  | Array<JSONValue>\n  | JSONObject;\n\nexport type JSONObject = {[key: string]: JSONValue | undefined};\n\nexport const jsonValueSchema: v.Type<JSONValue> = v.lazy(() =>\n  v.union(\n    v.null(),\n    v.string(),\n    v.boolean(),\n    v.number(),\n    v.array(jsonValueSchema),\n    jsonObjectSchema,\n  ),\n);\n\nexport const jsonObjectSchema = v.record(\n  v.union(jsonValueSchema, v.undefined()),\n);\n"],"names":[],"mappings":";AAYO,MAAM,kBAAqC,EAAE;AAAA,EAAK,MACvD,EAAE;AAAA,IACA,EAAE,KAAA;AAAA,IACF,EAAE,OAAA;AAAA,IACF,EAAE,QAAA;AAAA,IACF,EAAE,OAAA;AAAA,IACF,EAAE,MAAM,eAAe;AAAA,IACvB;AAAA,EAAA;AAEJ;AAEO,MAAM,mBAAmB,EAAE;AAAA,EAChC,EAAE,MAAM,iBAAiB,EAAE,WAAW;AACxC;"}
+{"version":3,"file":"json.js","names":[],"sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/json.ts"],"sourcesContent":["import * as v from '@badrap/valita';\n\nexport type JSONValue =\n  | null\n  | string\n  | boolean\n  | number\n  | Array<JSONValue>\n  | JSONObject;\n\nexport type JSONObject = {[key: string]: JSONValue | undefined};\n\nexport const jsonValueSchema: v.Type<JSONValue> = v.lazy(() =>\n  v.union(\n    v.null(),\n    v.string(),\n    v.boolean(),\n    v.number(),\n    v.array(jsonValueSchema),\n    jsonObjectSchema,\n  ),\n);\n\nexport const jsonObjectSchema = v.record(\n  v.union(jsonValueSchema, v.undefined()),\n);\n"],"mappings":";;AAYA,IAAa,kBAAqC,EAAE,WAClD,EAAE,MACA,EAAE,MAAM,EACR,EAAE,QAAQ,EACV,EAAE,SAAS,EACX,EAAE,QAAQ,EACV,EAAE,MAAM,gBAAgB,EACxB,iBACD,CACF;AAED,IAAa,mBAAmB,EAAE,OAChC,EAAE,MAAM,iBAAiB,EAAE,WAAW,CAAC,CACxC"}

package/out/zero-cache/src/services/change-source/protocol/current/path.js

@@ -1,5 +1,24 @@
-const CHANGE_SOURCE_PATH = "/changes/v0/stream";
-export {
-  CHANGE_SOURCE_PATH
-};
-//# sourceMappingURL=path.js.map
+//#region ../zero-cache/src/services/change-source/protocol/current/path.ts
+/**
+* The path required for a custom Change Source endpoint implementing the
+* Change Source protocol. The version in the path indicates the current
+* (i.e. latest) protocol version of the code, and is the only protocol
+* supported by the code.
+*
+* Eventually, when a backwards incompatible change is made to the protocol,
+* the version will be bumped to ensure that the protocol is only used for an
+* endpoint that explicitly understands it. (While the protocol is in flux
+* and being developed, a starting "v0" version will not follow this
+* convention.)
+*
+* Historic versions are kept in the source code (e.g. v1, v2, etc.) to
+* allow Change Source implementations to import and support multiple
+* versions simultaneously. This is necessary to seamlessly transitioning
+* from a `zero-cache` speaking one version to a `zero-cache` speaking
+* another.
+*/
+var CHANGE_SOURCE_PATH = "/changes/v0/stream";
+//#endregion
+export { CHANGE_SOURCE_PATH };
+
+//# sourceMappingURL=path.js.map

package/out/zero-cache/src/services/change-source/protocol/current/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/path.ts"],"sourcesContent":["/**\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"],"names":[],"mappings":"AAkBO,MAAM,qBAAqB;"}
+{"version":3,"file":"path.js","names":[],"sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/path.ts"],"sourcesContent":["/**\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"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,IAAa,qBAAqB"}

package/out/zero-cache/src/services/change-source/protocol/current/status.js

@@ -1,22 +1,28 @@
-import "../../../../../../shared/src/valita.js";
+import { valita_exports } from "../../../../../../shared/src/valita.js";
 import { commitSchema } from "./data.js";
-import { object, boolean, tuple, literal, string, union } from "@badrap/valita";
-const downstreamStatusSchema = object({
-  ack: boolean().optional(() => true)
-});
-const downstreamStatusMessageSchema = tuple([
-  literal("status"),
-  downstreamStatusSchema,
-  object({ watermark: string() })
+//#region ../zero-cache/src/services/change-source/protocol/current/status.ts
+/**
+* The downstream status message indicates whether it should be echoed
+* back in an upstream status message.
+*/
+var downstreamStatusSchema = valita_exports.object({ ack: valita_exports.boolean().optional(() => true) });
+var downstreamStatusMessageSchema = valita_exports.tuple([
+	valita_exports.literal("status"),
+	downstreamStatusSchema,
+	valita_exports.object({ watermark: valita_exports.string() })
 ]);
-const upstreamStatusMessageSchema = tuple([
-  literal("status"),
-  union(downstreamStatusSchema, commitSchema),
-  object({ watermark: string() })
+/**
+* The `zero-cache` will send the Commit payload to acknowledge a completed
+* transaction (unless the `skipAck` field was specified in the Begin message
+* of the transaction), and will echo back the downstream `status` message if
+* `ack` is true.
+*/
+var upstreamStatusMessageSchema = valita_exports.tuple([
+	valita_exports.literal("status"),
+	valita_exports.union(downstreamStatusSchema, commitSchema),
+	valita_exports.object({ watermark: valita_exports.string() })
 ]);
-export {
-  downstreamStatusMessageSchema,
-  downstreamStatusSchema,
-  upstreamStatusMessageSchema
-};
-//# sourceMappingURL=status.js.map
+//#endregion
+export { downstreamStatusMessageSchema, downstreamStatusSchema, upstreamStatusMessageSchema };
+
+//# sourceMappingURL=status.js.map

package/out/zero-cache/src/services/change-source/protocol/current/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/status.ts"],"sourcesContent":["import * as v from '../../../../../../shared/src/valita.ts';\nimport {commitSchema} from './data.ts';\n\n/**\n * The downstream status message indicates whether it should be echoed\n * back in an upstream status message.\n */\nexport const downstreamStatusSchema = v.object({\n  ack: v.boolean().optional(() => true),\n});\n\nexport type DownstreamStatus = v.Infer<typeof downstreamStatusSchema>;\n\nexport const downstreamStatusMessageSchema = v.tuple([\n  v.literal('status'),\n  downstreamStatusSchema,\n  v.object({watermark: v.string()}),\n]);\n\n/**\n * The `zero-cache` will send the Commit payload to acknowledge a completed\n * transaction (unless the `skipAck` field was specified in the Begin message\n * of the transaction), and will echo back the downstream `status` message if\n * `ack` is true.\n */\nexport const upstreamStatusMessageSchema = v.tuple([\n  v.literal('status'),\n  v.union(downstreamStatusSchema, commitSchema),\n  v.object({watermark: v.string()}),\n]);\n\n/**\n * Status messages convey positional information from both the ChangeSource\n * and the `zero-cache`.\n *\n * A StatusMessage from the ChangeSource indicates a position in its change\n * log. Generally, the watermarks sent in `Commit` messages already convey\n * this information, but a StatusMessage may also be sent to indicate that the\n * log has progressed without any corresponding changes relevant to the\n * subscriber. The watermarks of commit messages and status messages must be\n * monotonic in the stream of messages from the ChangeSource.\n *\n * The `zero-cache` sends StatusMessages to the ChangeSource:\n *\n * * when it has processed a `Commit` received from the ChangeSource,\n *   unless the `Begin` message specified `skipAck`.\n *\n * * when it receives a `StatusMessage` and all preceding `Commit` messages\n *   have been processed\n *\n * This allows the ChangeSource to clean up change log entries appropriately.\n *\n * Note that StatusMessages from the ChangeSource are optional. If a\n * ChangeSource implementation can track subscriber progress and clean up\n * its change log purely from Commit-driven StatusMessages there is no need\n * for the ChangeSource to send StatusMessages.\n */\nexport type DownstreamStatusMessage = v.Infer<\n  typeof downstreamStatusMessageSchema\n>;\nexport type UpstreamStatusMessage = v.Infer<typeof upstreamStatusMessageSchema>;\n"],"names":["v.object","v.boolean","v.tuple","v.literal","v.string","v.union"],"mappings":";;;AAOO,MAAM,yBAAyBA,OAAS;AAAA,EAC7C,KAAKC,QAAE,EAAU,SAAS,MAAM,IAAI;AACtC,CAAC;AAIM,MAAM,gCAAgCC,MAAQ;AAAA,EACnDC,QAAU,QAAQ;AAAA,EAClB;AAAA,EACAH,OAAS,EAAC,WAAWI,UAAW;AAClC,CAAC;AAQM,MAAM,8BAA8BF,MAAQ;AAAA,EACjDC,QAAU,QAAQ;AAAA,EAClBE,MAAQ,wBAAwB,YAAY;AAAA,EAC5CL,OAAS,EAAC,WAAWI,UAAW;AAClC,CAAC;"}
+{"version":3,"file":"status.js","names":[],"sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/status.ts"],"sourcesContent":["import * as v from '../../../../../../shared/src/valita.ts';\nimport {commitSchema} from './data.ts';\n\n/**\n * The downstream status message indicates whether it should be echoed\n * back in an upstream status message.\n */\nexport const downstreamStatusSchema = v.object({\n  ack: v.boolean().optional(() => true),\n});\n\nexport type DownstreamStatus = v.Infer<typeof downstreamStatusSchema>;\n\nexport const downstreamStatusMessageSchema = v.tuple([\n  v.literal('status'),\n  downstreamStatusSchema,\n  v.object({watermark: v.string()}),\n]);\n\n/**\n * The `zero-cache` will send the Commit payload to acknowledge a completed\n * transaction (unless the `skipAck` field was specified in the Begin message\n * of the transaction), and will echo back the downstream `status` message if\n * `ack` is true.\n */\nexport const upstreamStatusMessageSchema = v.tuple([\n  v.literal('status'),\n  v.union(downstreamStatusSchema, commitSchema),\n  v.object({watermark: v.string()}),\n]);\n\n/**\n * Status messages convey positional information from both the ChangeSource\n * and the `zero-cache`.\n *\n * A StatusMessage from the ChangeSource indicates a position in its change\n * log. Generally, the watermarks sent in `Commit` messages already convey\n * this information, but a StatusMessage may also be sent to indicate that the\n * log has progressed without any corresponding changes relevant to the\n * subscriber. The watermarks of commit messages and status messages must be\n * monotonic in the stream of messages from the ChangeSource.\n *\n * The `zero-cache` sends StatusMessages to the ChangeSource:\n *\n * * when it has processed a `Commit` received from the ChangeSource,\n *   unless the `Begin` message specified `skipAck`.\n *\n * * when it receives a `StatusMessage` and all preceding `Commit` messages\n *   have been processed\n *\n * This allows the ChangeSource to clean up change log entries appropriately.\n *\n * Note that StatusMessages from the ChangeSource are optional. If a\n * ChangeSource implementation can track subscriber progress and clean up\n * its change log purely from Commit-driven StatusMessages there is no need\n * for the ChangeSource to send StatusMessages.\n */\nexport type DownstreamStatusMessage = v.Infer<\n  typeof downstreamStatusMessageSchema\n>;\nexport type UpstreamStatusMessage = v.Infer<typeof upstreamStatusMessageSchema>;\n"],"mappings":";;;;;;;AAOA,IAAa,yBAAyB,eAAE,OAAO,EAC7C,KAAK,eAAE,SAAS,CAAC,eAAe,KAAK,EACtC,CAAC;AAIF,IAAa,gCAAgC,eAAE,MAAM;CACnD,eAAE,QAAQ,SAAS;CACnB;CACA,eAAE,OAAO,EAAC,WAAW,eAAE,QAAQ,EAAC,CAAC;CAClC,CAAC;;;;;;;AAQF,IAAa,8BAA8B,eAAE,MAAM;CACjD,eAAE,QAAQ,SAAS;CACnB,eAAE,MAAM,wBAAwB,aAAa;CAC7C,eAAE,OAAO,EAAC,WAAW,eAAE,QAAQ,EAAC,CAAC;CAClC,CAAC"}

package/out/zero-cache/src/services/change-source/protocol/current/upstream.js

@@ -1,18 +1,26 @@
-import "../../../../../../shared/src/valita.js";
-import { identifierSchema, backfillIDSchema, tableMetadataSchema } from "./data.js";
+import { valita_exports } from "../../../../../../shared/src/valita.js";
+import { backfillIDSchema, identifierSchema, tableMetadataSchema } from "./data.js";
 import { upstreamStatusMessageSchema } from "./status.js";
-import { object, record } from "@badrap/valita";
-const changeSourceUpstreamSchema = upstreamStatusMessageSchema;
-const backfillRequestSchema = object({
-  table: identifierSchema.extend({
-    // The table metadata is set to null if it is never specified by the
-    // change-source.
-    metadata: tableMetadataSchema.nullable()
-  }),
-  columns: record(backfillIDSchema)
+//#region ../zero-cache/src/services/change-source/protocol/current/upstream.ts
+/** At the moment, the only upstream messages are status messages.  */
+var changeSourceUpstreamSchema = upstreamStatusMessageSchema;
+/**
+* Contains the information for requesting a backfill of columns in a table.
+* Backfills are automatically started for new tables and columns in a given
+* change stream session; however, if the session is terminated before the
+* backfill completes, it must be restarted with appropriate
+* {@link BackfillRequest}s when creating a new session.
+*
+* The `change-streamer` is responsible for tracking any changes to the table
+* name, column names, or table metadata, and constructing a BackfillRequest
+* based on the current values (which may be different from when the
+* tables/columns were originally added).
+*/
+var backfillRequestSchema = valita_exports.object({
+	table: identifierSchema.extend({ metadata: tableMetadataSchema.nullable() }),
+	columns: valita_exports.record(backfillIDSchema)
 });
-export {
-  backfillRequestSchema,
-  changeSourceUpstreamSchema
-};
-//# sourceMappingURL=upstream.js.map
+//#endregion
+export { backfillRequestSchema, changeSourceUpstreamSchema };
+
+//# sourceMappingURL=upstream.js.map

package/out/zero-cache/src/services/change-source/protocol/current/upstream.js.map

@@ -1 +1 @@
-{"version":3,"file":"upstream.js","sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/upstream.ts"],"sourcesContent":["import * as v from '../../../../../../shared/src/valita.ts';\nimport {\n  backfillIDSchema,\n  identifierSchema,\n  tableMetadataSchema,\n} from './data.ts';\nimport {upstreamStatusMessageSchema} from './status.ts';\n\n/** At the moment, the only upstream messages are status messages.  */\nexport const changeSourceUpstreamSchema = upstreamStatusMessageSchema;\nexport type ChangeSourceUpstream = v.Infer<typeof changeSourceUpstreamSchema>;\n\n/**\n * Contains the information for requesting a backfill of columns in a table.\n * Backfills are automatically started for new tables and columns in a given\n * change stream session; however, if the session is terminated before the\n * backfill completes, it must be restarted with appropriate\n * {@link BackfillRequest}s when creating a new session.\n *\n * The `change-streamer` is responsible for tracking any changes to the table\n * name, column names, or table metadata, and constructing a BackfillRequest\n * based on the current values (which may be different from when the\n * tables/columns were originally added).\n */\nexport const backfillRequestSchema = v.object({\n  table: identifierSchema.extend({\n    // The table metadata is set to null if it is never specified by the\n    // change-source.\n    metadata: tableMetadataSchema.nullable(),\n  }),\n  columns: v.record(backfillIDSchema),\n});\n\nexport type BackfillRequest = v.Infer<typeof backfillRequestSchema>;\n"],"names":["v.object","v.record"],"mappings":";;;;AASO,MAAM,6BAA6B;AAenC,MAAM,wBAAwBA,OAAS;AAAA,EAC5C,OAAO,iBAAiB,OAAO;AAAA;AAAA;AAAA,IAG7B,UAAU,oBAAoB,SAAA;AAAA,EAAS,CACxC;AAAA,EACD,SAASC,OAAS,gBAAgB;AACpC,CAAC;"}
+{"version":3,"file":"upstream.js","names":[],"sources":["../../../../../../../../zero-cache/src/services/change-source/protocol/current/upstream.ts"],"sourcesContent":["import * as v from '../../../../../../shared/src/valita.ts';\nimport {\n  backfillIDSchema,\n  identifierSchema,\n  tableMetadataSchema,\n} from './data.ts';\nimport {upstreamStatusMessageSchema} from './status.ts';\n\n/** At the moment, the only upstream messages are status messages.  */\nexport const changeSourceUpstreamSchema = upstreamStatusMessageSchema;\nexport type ChangeSourceUpstream = v.Infer<typeof changeSourceUpstreamSchema>;\n\n/**\n * Contains the information for requesting a backfill of columns in a table.\n * Backfills are automatically started for new tables and columns in a given\n * change stream session; however, if the session is terminated before the\n * backfill completes, it must be restarted with appropriate\n * {@link BackfillRequest}s when creating a new session.\n *\n * The `change-streamer` is responsible for tracking any changes to the table\n * name, column names, or table metadata, and constructing a BackfillRequest\n * based on the current values (which may be different from when the\n * tables/columns were originally added).\n */\nexport const backfillRequestSchema = v.object({\n  table: identifierSchema.extend({\n    // The table metadata is set to null if it is never specified by the\n    // change-source.\n    metadata: tableMetadataSchema.nullable(),\n  }),\n  columns: v.record(backfillIDSchema),\n});\n\nexport type BackfillRequest = v.Infer<typeof backfillRequestSchema>;\n"],"mappings":";;;;;AASA,IAAa,6BAA6B;;;;;;;;;;;;;AAe1C,IAAa,wBAAwB,eAAE,OAAO;CAC5C,OAAO,iBAAiB,OAAO,EAG7B,UAAU,oBAAoB,UAAU,EACzC,CAAC;CACF,SAAS,eAAE,OAAO,iBAAiB;CACpC,CAAC"}

package/out/zero-cache/src/services/change-source/protocol/current.js

@@ -1,51 +1,56 @@
+import { __exportAll } from "../../../../../_virtual/_rolldown/runtime.js";
+import { jsonObjectSchema, jsonValueSchema } from "./current/json.js";
 import { resetRequiredSchema } from "./current/control.js";
 import { addColumnSchema, backfillCompletedSchema, backfillIDSchema, backfillSchema, beginSchema, commitSchema, createIndexSchema, createTableSchema, dataChangeSchema, deleteSchema, downloadStatusSchema, dropColumnSchema, dropIndexSchema, dropTableSchema, identifierSchema, insertSchema, isDataChange, isSchemaChange, newRelationSchema, relationSchema, renameTableSchema, rollbackSchema, rowSchema, schemaChangeSchema, tableMetadataSchema, truncateSchema, updateColumnSchema, updateSchema, updateTableMetadataSchema } from "./current/data.js";
+import { downstreamStatusMessageSchema, downstreamStatusSchema, upstreamStatusMessageSchema } from "./current/status.js";
 import { changeStreamControlSchema, changeStreamDataSchema, changeStreamMessageSchema } from "./current/downstream.js";
-import { jsonObjectSchema, jsonValueSchema } from "./current/json.js";
 import { CHANGE_SOURCE_PATH } from "./current/path.js";
-import { downstreamStatusMessageSchema, downstreamStatusSchema, upstreamStatusMessageSchema } from "./current/status.js";
 import { backfillRequestSchema, changeSourceUpstreamSchema } from "./current/upstream.js";
-export {
-  CHANGE_SOURCE_PATH,
-  addColumnSchema,
-  backfillCompletedSchema,
-  backfillIDSchema,
-  backfillRequestSchema,
-  backfillSchema,
-  beginSchema,
-  changeSourceUpstreamSchema,
-  changeStreamControlSchema,
-  changeStreamDataSchema,
-  changeStreamMessageSchema,
-  commitSchema,
-  createIndexSchema,
-  createTableSchema,
-  dataChangeSchema,
-  deleteSchema,
-  downloadStatusSchema,
-  downstreamStatusMessageSchema,
-  downstreamStatusSchema,
-  dropColumnSchema,
-  dropIndexSchema,
-  dropTableSchema,
-  identifierSchema,
-  insertSchema,
-  isDataChange,
-  isSchemaChange,
-  jsonObjectSchema,
-  jsonValueSchema,
-  newRelationSchema,
-  relationSchema,
-  renameTableSchema,
-  resetRequiredSchema,
-  rollbackSchema,
-  rowSchema,
-  schemaChangeSchema,
-  tableMetadataSchema,
-  truncateSchema,
-  updateColumnSchema,
-  updateSchema,
-  updateTableMetadataSchema,
-  upstreamStatusMessageSchema
-};
-//# sourceMappingURL=current.js.map
+//#region ../zero-cache/src/services/change-source/protocol/current.ts
+var current_exports = /* @__PURE__ */ __exportAll({
+	CHANGE_SOURCE_PATH: () => CHANGE_SOURCE_PATH,
+	addColumnSchema: () => addColumnSchema,
+	backfillCompletedSchema: () => backfillCompletedSchema,
+	backfillIDSchema: () => backfillIDSchema,
+	backfillRequestSchema: () => backfillRequestSchema,
+	backfillSchema: () => backfillSchema,
+	beginSchema: () => beginSchema,
+	changeSourceUpstreamSchema: () => changeSourceUpstreamSchema,
+	changeStreamControlSchema: () => changeStreamControlSchema,
+	changeStreamDataSchema: () => changeStreamDataSchema,
+	changeStreamMessageSchema: () => changeStreamMessageSchema,
+	commitSchema: () => commitSchema,
+	createIndexSchema: () => createIndexSchema,
+	createTableSchema: () => createTableSchema,
+	dataChangeSchema: () => dataChangeSchema,
+	deleteSchema: () => deleteSchema,
+	downloadStatusSchema: () => downloadStatusSchema,
+	downstreamStatusMessageSchema: () => downstreamStatusMessageSchema,
+	downstreamStatusSchema: () => downstreamStatusSchema,
+	dropColumnSchema: () => dropColumnSchema,
+	dropIndexSchema: () => dropIndexSchema,
+	dropTableSchema: () => dropTableSchema,
+	identifierSchema: () => identifierSchema,
+	insertSchema: () => insertSchema,
+	isDataChange: () => isDataChange,
+	isSchemaChange: () => isSchemaChange,
+	jsonObjectSchema: () => jsonObjectSchema,
+	jsonValueSchema: () => jsonValueSchema,
+	newRelationSchema: () => newRelationSchema,
+	relationSchema: () => relationSchema,
+	renameTableSchema: () => renameTableSchema,
+	resetRequiredSchema: () => resetRequiredSchema,
+	rollbackSchema: () => rollbackSchema,
+	rowSchema: () => rowSchema,
+	schemaChangeSchema: () => schemaChangeSchema,
+	tableMetadataSchema: () => tableMetadataSchema,
+	truncateSchema: () => truncateSchema,
+	updateColumnSchema: () => updateColumnSchema,
+	updateSchema: () => updateSchema,
+	updateTableMetadataSchema: () => updateTableMetadataSchema,
+	upstreamStatusMessageSchema: () => upstreamStatusMessageSchema
+});
+//#endregion
+export { current_exports };
+
+//# sourceMappingURL=current.js.map

package/out/zero-cache/src/services/change-source/protocol/current.js.map

@@ -1 +1 @@
-{"version":3,"file":"current.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}
+{"version":3,"file":"current.js","names":[],"sources":["../../../../../../../zero-cache/src/services/change-source/protocol/current.ts"],"sourcesContent":["export * from './current/control.ts';\nexport * from './current/data.ts';\nexport * from './current/downstream.ts';\nexport * from './current/json.ts';\nexport * from './current/path.ts';\nexport * from './current/status.ts';\nexport * from './current/upstream.ts';\n"],"mappings":""}

package/out/zero-cache/src/services/change-source/protocol/mod.js

@@ -0,0 +1,2 @@
+import "./current.js";
+export {};