@workerstack/database 0.22.0 → 0.22.1

package/src/query/filter.ts

@@ -16,6 +16,43 @@ import {
 } from "./filter-validate.ts"
 import type { SortDirection, SortField } from "./types.ts"
 
+/** The direction suffix an `order` entry may end in, before any nulls suffix, and what it reads as */
+const SORT_DIRECTIONS = { asc: "asc", desc: "desc" } as const satisfies Record<string, SortDirection>
+/** The nulls suffix an `order` entry may end in, and what it reads as */
+const SORT_NULLS = { nullsfirst: "first", nullslast: "last" } as const
+
+/** The value `suffixes` reads the last of `tokens` as, popping it, or undefined when it is none of them */
+function suffixOf<T extends string>(tokens: string[], suffixes: Readonly<Record<string, T>>): T | undefined {
+	for (const [suffix, value] of Object.entries(suffixes))
+		if (tokens.at(-1) === suffix) {
+			tokens.pop()
+			return value
+		}
+	return undefined
+}
+
+function escapeRegExp(value: string): string {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+}
+
+/** A regular expression taking any one of `names`, each literally */
+function anyOf(names: readonly string[]): string {
+	return `(?:${names.map(escapeRegExp).join("|")})`
+}
+
+/**
+ * A regular expression taking every `order` parseOrder reads over the fields in `sort`, up to
+ * `maxSortKeys` entries: the empty value, which reads as the default order, and each entry the field
+ * and the suffixes orderEntries reads off it. A field named twice is refused, so no order holds more
+ * entries than `sort` has fields; which field repeats needs a lookahead, which RE2 lacks, so the
+ * pattern leaves that to the description
+ */
+function orderPattern(sort: readonly string[], maxSortKeys: number): string {
+	const entry = `${anyOf(sort)}(?:\\.${anyOf(Object.keys(SORT_DIRECTIONS))})?(?:\\.${anyOf(Object.keys(SORT_NULLS))})?`
+	const keys = Math.min(maxSortKeys, sort.length)
+	return `^(?:${entry}(?:,${entry}){0,${Math.max(0, keys - 1)}})?$`
+}
+
 /**
  * Parse PostgREST-style `order` string into SortField array.
  *
@@ -67,24 +104,8 @@ function orderEntries(input: string | null | undefined): Array<SortField | strin
 
 		const tokens = trimmed.split(".")
 
-		let nulls: "first" | "last" | undefined
-		const last = tokens[tokens.length - 1]
-		if (last === "nullsfirst") {
-			nulls = "first"
-			tokens.pop()
-		} else if (last === "nullslast") {
-			nulls = "last"
-			tokens.pop()
-		}
-
-		let direction: SortDirection = "asc"
-		const newLast = tokens[tokens.length - 1]
-		if (newLast === "asc") {
-			tokens.pop()
-		} else if (newLast === "desc") {
-			direction = "desc"
-			tokens.pop()
-		}
+		const nulls = suffixOf(tokens, SORT_NULLS)
+		const direction: SortDirection = suffixOf(tokens, SORT_DIRECTIONS) ?? "asc"
 
 		const field = tokens.join(".")
 		if (!field || part !== trimmed) {
@@ -108,6 +129,7 @@ export {
 	parseFilterNumber,
 	namedTwice,
 	orderEntries,
+	orderPattern,
 	parseOrder,
 	validateFilter,
 	type FilterField,

package/src/query/list-extras.ts

@@ -16,6 +16,7 @@ import {
 	unprintedNumber,
 } from "./held-keys.ts"
 import type { SortField } from "./types.ts"
+import { UnmintableRow } from "./cursor-refusals.ts"
 
 /** The column every built list selects its tiebreak as, which the next cursor's id is minted from */
 const COMB_ID = "_combId" as const
@@ -140,19 +141,15 @@ const FLOAT_MARK = "!f"
  * which the read places nowhere a cursor resumes after
  */
 const storesUnread = (field: string, stored: string): CombError =>
-	new CombError({
-		cause: `${field} stores a ${stored.toUpperCase()} value its column's drizzle mode reads as another, which no cursor of a list that binds the key as read resumes after: store what the mode reads back (a timestamp's epoch number, a boolean's 0 or 1, a finite number), or sort by a column of the list's own table`,
-		errorKey: combErrorKeys.SORT_NOT_WIRED,
-		status: "internal_server_error",
-	})
+	new UnmintableRow(
+		`${field} stores a ${stored.toUpperCase()} value its column's drizzle mode reads as another, which no cursor of a list that binds the key as read resumes after: store what the mode reads back (a timestamp's epoch number, a boolean's 0 or 1, a finite number), or sort by a column of the list's own table`,
+	)
 
 /** The 500 for a SQLite number key no text SQLite prints of reads back as it, which no cursor binds exactly */
 const printsUnread = (field: string): CombError =>
-	new CombError({
-		cause: `${field} holds a REAL no text SQLite prints of it reads back as (D1 misprints some past about 1e100 and below 1e-100), which no cursor resumes after: store a number of fewer significant digits, or sort by another column`,
-		errorKey: combErrorKeys.SORT_NOT_WIRED,
-		status: "internal_server_error",
-	})
+	new UnmintableRow(
+		`${field} holds a REAL no text SQLite prints of it reads back as (D1 misprints some past about 1e100 and below 1e-100), which no cursor resumes after: store a number of fewer significant digits, or sort by another column`,
+	)
 
 /** The 500 for a Postgres float key read under extra_float_digits 0 or below: its read is rounded */
 const printsRounded = (field: string): CombError =>

package/src/query/list-schema.ts

@@ -24,7 +24,6 @@ import {
 	selectQueryFieldFor,
 	sortDirectionEnum,
 } from "./schema-params.ts"
-import { pageTooDeep } from "./trusted.ts"
 import type { ListQueryConfig, ListQueryLimits, ListQueryOutput, OutputStableShape } from "./schema-types.ts"
 import { validateSelectWithConfig } from "./select-validate.ts"
 import type { FieldType } from "./types.ts"
@@ -178,7 +177,6 @@ function createListQuerySchema<
 
 	const { maxLimit = PAGINATION_DEFAULTS.maxLimit, maxPage = PAGINATION_DEFAULTS.maxPage } = config.pagination ?? {}
 	const piped = schema.transform((data, ctx): ExtendedOutput => {
-		if (data.page !== undefined && data.page > maxPage) throw pageTooDeep(data.page, maxPage)
 		/* Optional params exist on `data` only when advertised above. */
 		const optional = data as {
 			filter?: string | undefined

package/src/query/merged.ts

@@ -18,6 +18,7 @@ import {
 	COMB_ID,
 	type ListPagination,
 	type ListRow,
+	nextCursorOf,
 	type PaginationResponse,
 	totalOf,
 } from "./pagination.ts"
@@ -238,8 +239,8 @@ function paginateMerged<T extends object>(
 	const window = rows.slice(start, start + limit + 1)
 	const hasMore = full || window.length > limit
 	const page = hasMore ? window.slice(0, limit) : window
-	/* every row served is one a cursor resumes after; the last one's is sealed */
-	const last = page.map((row) => pagination.fit(row)).at(-1)
+	/* the rows a cursor may be minted from are fitted; the last one's is sealed */
+	const last = nextCursorOf(page, { byCursor: cursor !== undefined, hasMore }, (row) => pagination.fit(row))
 	const meta: PaginationResponse = {
 		count: countOf(rowsPerShard, cursor),
 		hasMore,

package/src/query/pagination.ts

@@ -16,6 +16,7 @@ import { paginationIn, refuseGoneAnchor, refuseOverRead, refuseUnwired } from ".
 import type { paginationResponseSchema } from "./schema.ts"
 import type { ListQueryInput, ParsedFields, SortField } from "./types.ts"
 import type * as z from "zod"
+import { UnmintableRow } from "./cursor-refusals.ts"
 
 /**
  * The name of one column a builder selects for `paginate` to read, which no row it returns keeps: the
@@ -187,6 +188,28 @@ function fitFrom(
 	})
 }
 
+/**
+ * What seals a served page's next cursor, or undefined for none, `check` measuring a row's cursor. On
+ * a page by cursor it runs on every row: its client walks the list one cursor at a time, so a row no
+ * cursor resumes after is refused on the page that serves it, whatever the page size. On a page by
+ * number it runs only on the last row of a page with more, the one the cursor is minted from, as
+ * 0.20.1 did; a row whose own value no cursor holds (UnmintableRow) mints none, and the page serves it,
+ * its `hasMore` still saying a next page by number exists. A refusal of the list's wiring throws on both
+ */
+function nextCursorOf<T>(
+	page: readonly T[],
+	{ byCursor, hasMore }: { byCursor: boolean; hasMore: boolean },
+	check: (row: T) => (() => string) | undefined,
+): (() => string) | undefined {
+	if (byCursor) return page.map(check).at(-1)
+	try {
+		return (hasMore ? page.slice(-1) : []).map(check).at(-1)
+	} catch (error) {
+		if (error instanceof UnmintableRow) return undefined
+		throw error
+	}
+}
+
 /**
  * The page of `items`, read with `built`, and its pagination: count, whether there is more, and
  * the next cursor, sealed under the builder's options; none for a list no cursor can resume
@@ -207,12 +230,12 @@ function paginate<T extends object>(
 	refuseGoneAnchor(items)
 	const hasMore = items.length > pagination.limit
 	const sliced = hasMore ? items.slice(0, pagination.limit) : items
-	/* a key no cursor bound as read places is refused on the page that serves it, wherever its row lands */
-	for (const item of sliced) refuseUnheld(item as Record<string, unknown>, pagination.parsedSort)
-	/* every row served is one a cursor resumes after, checked from the fat row, under the sort the builder
-	   ordered by, so the next request's signature matches; the last one's is sealed */
-	const fitted = pagination.cursorable ? sliced.map((item) => pagination.fit(item)) : []
-	const last = fitted.at(-1)
+	/* a key no cursor bound as read places is refused as a mint is, checked from the fat row, under the
+	   sort the builder ordered by, so the next request's signature matches; the last one's is sealed */
+	const last = nextCursorOf(sliced, { byCursor: pagination.cursor !== undefined, hasMore }, (item) => {
+		refuseUnheld(item as Record<string, unknown>, pagination.parsedSort)
+		return pagination.cursorable ? pagination.fit(item) : undefined
+	})
 	const meta: PaginationResponse = {
 		count: countOf(items, pagination),
 		hasMore,
@@ -229,6 +252,7 @@ function paginate<T extends object>(
 export {
 	applySelect,
 	COMB_ID,
+	nextCursorOf,
 	type ListExtra,
 	type ListPagination,
 	type ListRow,

package/src/query/rounded-key.ts

@@ -7,10 +7,9 @@
  * selected does the value alone. A class is trusted only when it names a double, so one comb cannot
  * place, such as a type no family covers, is refused as an integer is.
  */
-import { CombError } from "../error.ts"
-import { combErrorKeys } from "../types.ts"
 import { storedClasses } from "./list-extras.ts"
 import type { SortField } from "./types.ts"
+import { UnmintableRow } from "./cursor-refusals.ts"
 
 // lookup-table: why a list cannot page an integer sort key the driver rounded, by the list
 const ROUNDED: Readonly<Record<"derived" | "merged" | "unread", string>> = {
@@ -45,7 +44,7 @@ function roundedKey(
 	row: Record<string, unknown>,
 	sort: readonly SortField[],
 	list: "derived" | "merged" | { unread: (field: string) => boolean },
-): CombError | undefined {
+): UnmintableRow | undefined {
 	const [kind, judged] = typeof list === "string" ? [list, () => true] : (["unread", list.unread] as const)
 	const stored = storedClasses(row)
 	const rounded = sort.find(({ field }, i) => {
@@ -60,13 +59,11 @@ function roundedKey(
 	})
 	if (rounded === undefined) return undefined
 	const value = row[rounded.field] as number
-	return new CombError({
-		cause: Number.isInteger(value)
+	return new UnmintableRow(
+		Number.isInteger(value)
 			? `${rounded.field} ${BigInt(value)} is past ±(2^53 − 1), where the driver rounded it: ${ROUNDED[kind]}`
 			: `${rounded.field} ${value} is a fraction under a type no driver reads exactly as a JS number, so the driver may have rounded it: ${FRACTION[kind]}: sort by a Postgres numeric, whose text comb carries, read the key as a string, or sort by a double precision or real`,
-		errorKey: combErrorKeys.SORT_NOT_WIRED,
-		status: "internal_server_error",
-	})
+	)
 }
 
 export { roundedKey }

package/src/query/schema-params.ts

@@ -14,7 +14,7 @@ import {
 import { FILTER_OPERATORS } from "./filter-parse.ts"
 import { PAGINATION_DEFAULTS } from "./schema-limits.ts"
 import type { FieldsConfig, PaginationConfig } from "./schema-types.ts"
-import { invalidPage } from "./trusted.ts"
+import { invalidPage, pageTooDeep } from "./trusted.ts"
 import type { FieldSelection, FilterAST, FilterGroup, ParsedFields } from "./types.ts"
 
 /** The `select` param for an endpoint of these fields, its text and examples theirs */
@@ -88,10 +88,17 @@ function fromDigits(raw: unknown, max: number): unknown {
 	return DECIMAL_DIGITS.test(raw) && !padded ? Number(raw) : Number.NaN
 }
 
-/** `raw` as a page, a whole number from 1; anything else is invalid_page, as the builders answer it */
+/**
+ * `raw` as a page, a whole number from 1 to `maxPage`: past it, whatever its size, is `page_too_deep`,
+ * decided here on the digits before any number the schema could refuse exists; anything else is
+ * invalid_page, as the builders answer it. A digit string past 1e308 reads as Infinity: it is whole
+ */
 function pageFrom(raw: unknown, maxPage: number): unknown {
 	const page = fromDigits(raw, maxPage)
-	if (typeof page !== "number" || !Number.isInteger(page) || page < 1) throw invalidPage(raw)
+	const isDigits = typeof raw === "string"
+	if (typeof page !== "number" || page < 1 || !(Number.isInteger(page) || (isDigits && page === Infinity)))
+		throw invalidPage(raw)
+	if (page > maxPage) throw pageTooDeep(isDigits ? raw.replace(/^0+/, "") : page, maxPage)
 	return page
 }
 
@@ -147,8 +154,8 @@ function limitSchemaFor(pagination: PaginationConfig | undefined): z.ZodDefault<
 /**
  * The `page` param: decimal digits or a number, a whole number from 1. Neither bound is a field
  * error, which would give one condition two contracts: a page that is no whole number from 1 is
- * `invalid_page`, and maxPage, published but not checked here, is the list schema's
- * `page_too_deep`, each as an unbounded list answers it
+ * `invalid_page`, and one past maxPage is `page_too_deep` at any size, each as an unbounded list
+ * answers it
  */
 function pageSchema(maxPage: number): z.ZodOptional<CountParam> {
 	const page = z

package/src/query/select-validate.ts

@@ -13,10 +13,13 @@ type Report = (message: string) => void
 /** A relation by name, and the config that declares its fields */
 type Relation = { fieldsConfig: FieldsConfig; name: string }
 
-/** Report every name in `scalars` that `allowed` lacks; computed `@` fields are the handler's */
+/**
+ * Report every name in `scalars` that `allowed` lacks; computed `@` fields are the handler's, and `*`
+ * is no name: it expands to `allowed` after this check, so a name beside it is held to `allowed` too
+ */
 function checkScalars(scalars: readonly string[], allowed: ReadonlySet<string>, report: Report): void {
 	for (const field of scalars) {
-		if (!allowed.has(field) && !field.startsWith("@")) report(field)
+		if (field !== "*" && !allowed.has(field) && !field.startsWith("@")) report(field)
 	}
 }
 
@@ -30,9 +33,9 @@ function checkRelation(selection: FieldSelection, { fieldsConfig, name }: Relati
 
 	const relationFields = fieldsConfig.relationFields ?? {}
 	const allowed = new Set(Object.hasOwn(relationFields, name) ? relationFields[name] : [])
+	checkScalars(selection.scalars, allowed, (field) => report(`Unknown ${name} field: ${field}`))
 	/* expand nested wildcard to all allowed fields */
 	if (selection.scalars.includes("*")) selection.scalars = [...allowed]
-	checkScalars(selection.scalars, allowed, (field) => report(`Unknown ${name} field: ${field}`))
 }
 
 /** The parsed selection, checked against `fieldsConfig`; null when there is none or it does not parse */
@@ -54,9 +57,9 @@ function validateSelectWithConfig(
 		return null
 	}
 
+	checkScalars(parsed.root.scalars, new Set(fieldsConfig.scalars), (field) => report(`Unknown field: ${field}`))
 	/* Handle * wildcard at top level — expand to all scalars */
 	if (parsed.root.scalars.includes("*")) parsed.root.scalars = [...fieldsConfig.scalars]
-	checkScalars(parsed.root.scalars, new Set(fieldsConfig.scalars), (field) => report(`Unknown field: ${field}`))
 
 	const relations = new Set(fieldsConfig.relations ?? [])
 	/* parseSelect stores a selection for every embed, never null */

package/src/query/sqlite/cursor-fit.ts

@@ -141,6 +141,14 @@ const NUMERIC_TEXT = /^(?:-?\d+(?:\.\d+)?|NaN|-?Infinity)$/
 const carriesOpaque = (column: SQLWrapper | undefined): boolean =>
 	is(column, Column) && column.dataType === "custom" && !is(column, SQLiteColumn)
 
+/**
+ * `cast` as an operand of no affinity, as a bound parameter is: a CAST has its type's affinity, which
+ * SQLite applies to a column of none or BLOB's before it compares, so `k > cast(? as real)` read a
+ * stored TEXT '10' as 10 and paged it out of the column's own order. The unary `+` drops the affinity
+ * and keeps the index search
+ */
+const affinityFree = (cast: SQL): SQL => sql`+${cast}`
+
 /**
  * A cursor value as its key binds it. Stored text the list carried (`carried`, the cursor's flag)
  * binds as itself, past the column's mapper: cast to numeric on a key that reads rounded, and on a
@@ -150,12 +158,12 @@ const carriesOpaque = (column: SQLWrapper | undefined): boolean =>
  */
 function boundCarried(column: SQLWrapper | undefined, value: unknown, carried: boolean): unknown {
 	/* one SQLite parse of the text the list checked reads back as the key, on every driver */
-	if (value instanceof RealText) return sql`cast(${value.text} as real)`
+	if (value instanceof RealText) return affinityFree(sql`cast(${value.text} as real)`)
 	if (carriedText(column, value, { asRead: false, carried })) return sql`${value}`
 	/* a mode's mapper binds the value as another (a boolean's as 0 or 1); D1 binds no bigint, so one past 2^53 goes as its digits */
 	if (carriedStored(column, value, { asRead: false, carried }))
 		return typeof value === "bigint" && !Number.isSafeInteger(Number(value))
-			? sql`cast(${String(value)} as integer)`
+			? affinityFree(sql`cast(${String(value)} as integer)`)
 			: sql`${bindable(value)}`
 	if (!carried || typeof value !== "string" || !NUMERIC_TEXT.test(value)) return value
 	if (readsRounded(column)) return sql`${value}::numeric`

package/src/query/trusted.ts

@@ -84,10 +84,15 @@ function invalidPage(page: unknown): CombError {
 	})
 }
 
+/** The most digits of a page past `maxPage` its message names */
+const PAGE_SHOWN = 24
+
 /** The 400 for a page past `maxPage`, from a list schema or from a list no schema bounded */
-function pageTooDeep(page: number, maxPage: number): CombError {
+function pageTooDeep(page: number | string, maxPage: number): CombError {
+	/* a page of any size reaches here as digits, so the message keeps the front of it, not all */
+	const shown = String(page)
 	return new CombError({
-		cause: `page ${page} is past ${maxPage}; page further by cursor`,
+		cause: `page ${shown.length > PAGE_SHOWN ? `${shown.slice(0, PAGE_SHOWN)}…` : shown} is past ${maxPage}; page further by cursor`,
 		errorKey: combErrorKeys.PAGE_TOO_DEEP,
 		status: "bad_request",
 	})

package/types/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAChB,SAAS,GACT,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,CAAA;AAEnB,MAAM,MAAM,UAAU,GAAG;IACxB,kFAAkF;IAClF,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IACxB,gCAAgC;IAChC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,IAAI,MAAM,EAAE,GAAG,SAAS,CAAA;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,UAAU,EAwDxC,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACtC,CAAA;AA6CD,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAsB/E;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE1E;AAqBD,0GAA0G;AAC1G,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAMtC;AAmBD,8FAA8F;AAC9F,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAIpE;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGpD"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAChB,SAAS,GACT,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,CAAA;AAEnB,MAAM,MAAM,UAAU,GAAG;IACxB,kFAAkF;IAClF,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IACxB,gCAAgC;IAChC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,IAAI,MAAM,EAAE,GAAG,SAAS,CAAA;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,UAAU,EA0DxC,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACtC,CAAA;AA6CD,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAsB/E;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE1E;AAqBD,0GAA0G;AAC1G,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAMtC;AAmBD,8FAA8F;AAC9F,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAIpE;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/types/cli/comb-config.d.ts

@@ -14,8 +14,11 @@ export declare function findCombConfig(cwd: string): Promise<CodegenConfig | und
 export declare function loadCombConfig(cwd: string): Promise<CodegenConfig>;
 /** The database `name` declares, or a CliError naming the ones it does, and `hint` when the caller has one */
 export declare function databaseIn(config: CodegenConfig, name: string, hint?: string): DatabaseCodegen;
-/** The tables file `tables` names, resolved against `cwd`; a CliError when it is missing */
-export declare function tablesFile(cwd: string, tables: string): string;
+/**
+ * The tables file `tables` names, resolved against `cwd`, as `what` gave it (--tables, or
+ * comb.config.ts `tables`); a CliError when it is missing or not a file
+ */
+export declare function tablesFile(cwd: string, tables: string, what: "--tables" | "tables"): string;
 /** A database comb.config.ts declares FTS on: its tables file and the FTS of each table */
 export type DeclaredFts = {
     fts: Record<string, FtsTableConfig>;

package/types/cli/comb-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comb-config.d.ts","sourceRoot":"","sources":["../../src/cli/comb-config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AAElD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAA;AAS9C;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAS7E;AAED,2EAA2E;AAC3E,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CASpF;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAIxE;AAED,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAK9F;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjF;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,MAAM,EACX,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrE,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAKlC;AAED,kGAAkG;AAClG,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3F"}
+{"version":3,"file":"comb-config.d.ts","sourceRoot":"","sources":["../../src/cli/comb-config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAGtE,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AAElD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAA;AAS9C;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAS7E;AAED,2EAA2E;AAC3E,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CASpF;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAIxE;AAED,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAK9F;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAK3F;AAED,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjF;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,MAAM,EACX,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrE,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAKlC;AAED,kGAAkG;AAClG,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3F"}

package/types/cli/file-path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Refuse `file`, which `what` names (an option or a config field), when it exists as other than a
+ * file, saying what it is, then `fix`; a missing one is left to the caller, which refuses it its own way
+ */
+export declare function refuseNotFile(file: string, what: string, fix: string): void;
+/**
+ * Refuse a name a file is made from, `what` naming it, when it would name a path: one holding a
+ * separator, or `.` or `..` alone; then `usage`
+ */
+export declare function refusePathName(name: string, what: string, usage: string): void;
+//# sourceMappingURL=file-path.d.ts.map

package/types/cli/file-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path.d.ts","sourceRoot":"","sources":["../../src/cli/file-path.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG9E"}

package/types/cli/migrate-apply.d.ts

@@ -2,6 +2,7 @@ import { type Peers } from "../migrate/core/optional-peer.ts";
 import type { Command, Provider } from "../migrate/core/peer-needs.ts";
 import { type CliContext } from "./output.ts";
 type Mode = "apply" | "baseline" | "check" | "status";
+/** `migrate apply|baseline|check|status`, with --json as one JSON object (migrate-json.ts) */
 export declare function migrateApply(mode: Mode, argv: readonly string[], io: CliContext): Promise<void>;
 /**
  * Every peer `command` on `provider` needs, Atlas's version read through `io` among them, refused

package/types/cli/migrate-apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-apply.d.ts","sourceRoot":"","sources":["../../src/cli/migrate-apply.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAS,KAAK,KAAK,EAAgB,MAAM,kCAAkC,CAAA;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAQtE,OAAO,EAAyB,KAAK,UAAU,EAAiC,MAAM,aAAa,CAAA;AAEnG,KAAK,IAAI,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAoMrD,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrG;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,OAAO,EAChB,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAClE,OAAO,CAAC,KAAK,CAAC,CAGhB"}
+{"version":3,"file":"migrate-apply.d.ts","sourceRoot":"","sources":["../../src/cli/migrate-apply.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAS,KAAK,KAAK,EAAgB,MAAM,kCAAkC,CAAA;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAQtE,OAAO,EAAyB,KAAK,UAAU,EAAuB,MAAM,aAAa,CAAA;AAEzF,KAAK,IAAI,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AA+LrD,8FAA8F;AAC9F,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrG;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,OAAO,EAChB,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAClE,OAAO,CAAC,KAAK,CAAC,CAGhB"}

package/types/cli/migrate-d1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-d1.d.ts","sourceRoot":"","sources":["../../src/cli/migrate-d1.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,4BAA4B,CAAA;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAyB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAEzF,KAAK,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEvD,8DAA8D;AAC9D,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E,gGAAgG;AAChG,iBAAS,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAepH;AAED,qHAAqH;AACrH,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,wBAAsB,SAAS,CAC9B,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,QAAQ,EAAE,UAAU,GAClB,OAAO,CAAC,cAAc,CAAC,CAmDzB"}
+{"version":3,"file":"migrate-d1.d.ts","sourceRoot":"","sources":["../../src/cli/migrate-d1.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,4BAA4B,CAAA;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,qBAAqB,CAAA;AAErE,OAAO,EAAyB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAEzF,KAAK,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEvD,8DAA8D;AAC9D,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E,gGAAgG;AAChG,iBAAS,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAkBpH;AAED,qHAAqH;AACrH,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,wBAAsB,SAAS,CAC9B,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,QAAQ,EAAE,UAAU,GAClB,OAAO,CAAC,cAAc,CAAC,CAmDzB"}

package/types/cli/migrate-json.d.ts

@@ -0,0 +1,4 @@
+import { type CliContext, type MigrateOutcome } from "./output.ts";
+/** `run` on `db`, its human lines on stderr and its one JSON object on `io.out` */
+export declare function asJson(db: string, io: CliContext, run: (io: CliContext) => Promise<MigrateOutcome>): Promise<void>;
+//# sourceMappingURL=migrate-json.d.ts.map

package/types/cli/migrate-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-json.d.ts","sourceRoot":"","sources":["../../src/cli/migrate-json.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAY,MAAM,aAAa,CAAA;AAK5E,mFAAmF;AACnF,wBAAsB,MAAM,CAC3B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,UAAU,EACd,GAAG,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,OAAO,CAAC,cAAc,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/types/cli/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/cli/migrate.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AA0NvD,wBAAsB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrG"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/cli/migrate.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAY,KAAK,UAAU,EAAY,MAAM,aAAa,CAAA;AA+OjE,wBAAsB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrG"}

package/types/migrate/core/apply.d.ts

@@ -1,7 +1,7 @@
 import type { Connection } from "../types.ts";
 import { type RetryOptions } from "./utils.ts";
 /** Whether a unique index of comb's history holds its hash alone, as comb's table did before 0.13 */
-export declare function hashUnique(conn: Connection): Promise<boolean>;
+export declare const hashUnique: (conn: Connection) => Promise<boolean>;
 /**
  * comb's history, made where it is missing, named from 0.11, and from a history before 0.13
  * rebuilt in one batch: every row and id kept, each row `renamed` lists taking its new name,
@@ -46,7 +46,8 @@ type ApplyOptions = {
  * record it wrote says it ran, so a retry reads the history first and runs nothing again.
  * When no read of `history` answers after a batch that failed transiently, the failure is an Unconfirmed.
  * The record goes first, so a batch whose file another run recorded while it waited for the lock
- * fails on the name at once and runs nothing; the history then says so, and it is that run's.
+ * fails on the name's unique index at once and runs nothing (ensureMigrationsTable keeps one on every
+ * history, whoever made the table); the history then says so, and it is that run's.
  * Returns who applied it.
  */
 export declare function applyRecorded(conn: Pick<Connection, "batch">, migration: Recorded, { history, retry }: ApplyOptions): Promise<"this run" | "another run">;

package/types/migrate/core/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/apply.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7C,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,YAAY,CAAA;AAezD,qGAAqG;AACrG,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAUnE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAM,GACvD,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/G;AAID;;;;GAIG;AACH,eAAO,MAAM,YAAY,+BAA+B,CAAA;AAExD,+GAA+G;AAC/G,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtG;AAED,8EAA8E;AAC9E,KAAK,QAAQ,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEjF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;AAEhE,mHAAmH;AACnH,KAAK,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAAE,CAAA;AAS9F;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,QAAQ,EACnB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,YAAY,GAC9B,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC,CAkCrC;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,EACnC,UAAU,EAAE,SAAS,QAAQ,EAAE,EAC/B,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACzE,OAAO,CAAC,IAAI,CAAC,CAsBf"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/apply.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAM7C,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,YAAY,CAAA;AA4BzD,qGAAqG;AACrG,eAAO,MAAM,UAAU,SAAU,UAAU,KAAG,OAAO,CAAC,OAAO,CAA2B,CAAA;AAmBxF;;;;GAIG;AACH,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAM,GACvD,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/G;AAID;;;;GAIG;AACH,eAAO,MAAM,YAAY,+BAA+B,CAAA;AAExD,+GAA+G;AAC/G,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtG;AAED,8EAA8E;AAC9E,KAAK,QAAQ,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEjF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;AAEhE,mHAAmH;AACnH,KAAK,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAAE,CAAA;AAS9F;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,QAAQ,EACnB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,YAAY,GAC9B,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC,CAkCrC;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,EACnC,UAAU,EAAE,SAAS,QAAQ,EAAE,EAC/B,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACzE,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/types/migrate/core/atlas-apply-runs.d.ts

@@ -1,3 +1,9 @@
+/**
+ * The apply itself, once comb approved the pending files: one Atlas call per file, so
+ * each file runs on a session of its own, as it would alone, as on SQLite and on D1. No
+ * reading of a file proves what it leaves on its session: a trigger, a default, a DO block's EXECUTE
+ * or code the target holds can each run a SET that outlives its COMMIT.
+ */
 import { type Foreign } from "./atlas-foreign.ts";
 import { type AtlasStatus, checkHistory } from "./atlas-history.ts";
 import { type AtlasCommand } from "./atlas-status.ts";

package/types/migrate/core/atlas-apply-runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atlas-apply-runs.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/atlas-apply-runs.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAkB,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEnF,OAAO,EAAS,KAAK,YAAY,EAAe,MAAM,mBAAmB,CAAA;AA6CzE;;;;;;;GAOG;AACH,iBAAe,SAAS,CACvB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChH,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AA+BD,OAAO,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"atlas-apply-runs.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/atlas-apply-runs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAkB,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEnF,OAAO,EAAS,KAAK,YAAY,EAAe,MAAM,mBAAmB,CAAA;AAoCzE;;;;;;;GAOG;AACH,iBAAe,SAAS,CACvB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChH,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AA+BD,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/types/migrate/core/cleanup.d.ts

@@ -1,5 +1,17 @@
-/** A step a signal runs, told which signal came */
-type Step = (signal: NodeJS.Signals) => unknown;
+/**
+ * A step a signal runs, told which signal came and what the steps that ran before it returned, in
+ * that order: a step held first runs last, and reads what the steps held after it found out
+ */
+type Step = (signal: NodeJS.Signals, earlier: readonly unknown[]) => unknown;
+/**
+ * The signals a held step runs on: every one whose default action ends the process and that a
+ * terminal or a supervisor sends. A Ctrl-C (SIGINT), a Ctrl-\ (SIGQUIT), a container stop or a CI
+ * step timeout (SIGTERM), and a terminal's hangup, as an SSH drop sends it (SIGHUP): a child in a
+ * group of its own gets none of them from the terminal, so comb's forward is its only signal.
+ */
+export declare const STOP_SIGNALS: readonly ["SIGHUP", "SIGINT", "SIGQUIT", "SIGTERM"];
+/** One of STOP_SIGNALS */
+export type StopSignal = (typeof STOP_SIGNALS)[number];
 /**
  * Settles once every stop begun so far has ended: asked for the process's end, or let a host that
  * listens keep it. A test that stubs process.kill around a signal restores it only past this, so
@@ -13,7 +25,7 @@ export declare function stopsEnded(): Promise<void>;
  */
 export declare function pastStop(): Promise<void>;
 /**
- * Hold `step` until the release this returns, so SIGINT and SIGTERM run it before the process ends.
+ * Hold `step` until the release this returns, so a stop signal runs it before the process ends.
  * The listener is read from the process, not remembered: a host that removed every listener gets it back.
  */
 export declare function hold(step: Step): () => void;
@@ -49,7 +61,7 @@ export type Scratch = {
 };
 /**
  * A new directory under the temp directory that only this user can open (0700), named `prefix`, this
- * process's pid and host mark, and removed by `remove`, or by SIGINT or SIGTERM before it. A
+ * process's pid and host mark, and removed by `remove`, or by a stop signal before it. A
  * process's first scratch of a prefix sweeps what killed runs left.
  */
 export declare function scratchDir(prefix: string): Scratch;

package/types/migrate/core/cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/cleanup.ts"],"names":[],"mappings":"AAaA,mDAAmD;AACnD,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,OAAO,CAAA;AAsE/C;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExC;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,IAAI,CAI3C;AAKD;;;GAGG;AACH,wBAAgB,WAAW,IAAI;IAAE,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CAAE,CAUpG;AAED,gDAAgD;AAChD,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnG;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED,wHAAwH;AACxH,eAAO,MAAM,gBAAgB,EAAE,MAAwB,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAQjC;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAoB,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAetG;AAKD,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,IAAI,IAAI,CAAA;CAAE,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAelD"}
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/cleanup.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAA;AAK5E;;;;;GAKG;AACH,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAE/E,0BAA0B;AAC1B,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAiEtD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExC;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,IAAI,CAI3C;AAKD;;;GAGG;AACH,wBAAgB,WAAW,IAAI;IAAE,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;CAAE,CAUpG;AAED,gDAAgD;AAChD,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnG;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED,wHAAwH;AACxH,eAAO,MAAM,gBAAgB,EAAE,MAAwB,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAQjC;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAoB,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAetG;AAKD,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,IAAI,IAAI,CAAA;CAAE,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAelD"}

package/types/migrate/core/d1-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d1-history.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/d1-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAI7C,OAAO,EAAqB,KAAK,QAAQ,EAAgB,KAAK,UAAU,EAAkB,MAAM,iBAAiB,CAAA;AAyIjH,KAAK,OAAO,GAAG;IACd,OAAO,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,UAAU,CAAA;CAChB,CAAA;AAED,wGAAwG;AACxG,iBAAe,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqD5E;AAED;;;;;;GAMG;AACH,iBAAe,UAAU,CACxB,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCjD;AAED;;;;;;GAMG;AACH,iBAAe,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQjH;AAED,6GAA6G;AAC7G,iBAAe,QAAQ,CACtB,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAanD;AAED,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"d1-history.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/d1-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAI7C,OAAO,EAAqB,KAAK,QAAQ,EAAgB,KAAK,UAAU,EAAkB,MAAM,iBAAiB,CAAA;AAqHjH,KAAK,OAAO,GAAG;IACd,OAAO,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,UAAU,CAAA;CAChB,CAAA;AAqBD,wGAAwG;AACxG,iBAAe,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmD5E;AAED;;;;;;GAMG;AACH,iBAAe,UAAU,CACxB,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCjD;AAED;;;;;;GAMG;AACH,iBAAe,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQjH;AAED,6GAA6G;AAC7G,iBAAe,QAAQ,CACtB,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAanD;AAED,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA"}

package/types/migrate/core/d1-wrangler-error.d.ts

@@ -10,5 +10,16 @@ export declare function wranglerError({ stderr, stdout }: Ran): string;
  * never waited out, since comb cannot know the batch did nothing, and what the table holds says what is still pending.
  */
 export declare function applyFailure(ran: Ran, locked: boolean): string;
+/** Refuse a failed run, or one whose table gained (`added`) other than the `names` checked, naming a file never checked */
+export declare function refuseUnlike(ran: {
+    code: number;
+    stderr: string;
+    stdout: string;
+}, { added, locked, names, table }: {
+    added: string[];
+    locked: boolean;
+    names: string[];
+    table: string;
+}): void;
 export {};
 //# sourceMappingURL=d1-wrangler-error.d.ts.map

package/types/migrate/core/d1-wrangler-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d1-wrangler-error.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/d1-wrangler-error.ts"],"names":[],"mappings":"AAKA,KAAK,GAAG,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C,2HAA2H;AAC3H,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAI9D"}
+{"version":3,"file":"d1-wrangler-error.d.ts","sourceRoot":"","sources":["../../../src/migrate/core/d1-wrangler-error.ts"],"names":[],"mappings":"AAOA,KAAK,GAAG,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C,2HAA2H;AAC3H,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAI9D;AAED,2HAA2H;AAC3H,wBAAgB,YAAY,CAC3B,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACrD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnG,IAAI,CAeN"}