@haverstack/core 0.38.0 → 0.40.0

package/dist/wire-entry.d.ts

@@ -18,11 +18,13 @@ export { isSafeAttachmentContentType, inferContentTypeFromFilename, resolveAttac
 export type { AttachmentDownloadContentType } from './attachment-download.js';
 export { firstRecordedAttachment, resolveReferencedAttachment } from './attachment-download.js';
 export type { StackTokenStore, TokenInfo, TokenSession } from './types.js';
-export { parseQueryParams, parseQueryBody, parseChangeParams, parseJournalParams, parseIfMatch, parseUploadFilename, parsePositiveInt, } from './wire-request.js';
+export { parseQueryParams, parseQueryBody, parseChangeParams, parseJournalParams, parseVersionsParams, parseGetRecordParams, parseDeleteParams, parseDownloadParams, parseAssociationParams, parseIfMatch, parseUploadFilename, parsePositiveInt, } from './wire-request.js';
 export { assertQueryTravels } from './wire-request.js';
-export type { ParsedChangeParams } from './wire-request.js';
+export type { ParsedChangeParams, ParsedDownloadParams, ParsedAssociationParams, } from './wire-request.js';
 export { parseDate } from './wire-request.js';
 export { createOptionsFromWireRecord, changesFromWireBody } from './wire-record.js';
 export type { WireCreateRequest } from './wire-record.js';
+export { parseAssociationEditsBody, parseAuthChallengeBody, parseAuthTokenBody, parseEntityPatchBody, parseTypeBody, parseMigrationBody, } from './wire-body.js';
+export type { WireAuthChallengeRequest, WireAuthTokenRequest, WireEntityPatch, WireMigrationRequest, } from './wire-body.js';
 export { isOwnerActingAlone } from './access.js';
 //# sourceMappingURL=wire-entry.d.ts.map

package/dist/wire-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire-entry.d.ts","sourceRoot":"","sources":["../src/wire-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAK9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAK9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAM9E,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAIhG,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"wire-entry.d.ts","sourceRoot":"","sources":["../src/wire-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAK9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAK9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAM9E,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAIhG,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/wire-entry.js

@@ -27,11 +27,12 @@ export { isSafeAttachmentContentType, inferContentTypeFromFilename, resolveAttac
 export { firstRecordedAttachment, resolveReferencedAttachment } from './attachment-download.js';
 // No in-repo caller: the parse half of the request encoding adapter-api
 // builds, so a server decodes GET /records, POST /records/query,
-// GET /changes and GET /records/:id/journal with these rather than
-// transcribing the parameter table.
+// GET /changes, GET /records/:id/journal, GET /records/:id/versions, GET /records/:id,
+// DELETE /records/:id, GET /attachments/:fileId and GET /records/:id/associations with these
+// rather than transcribing the parameter table.
 // Contract, not internal — and the round trip against the builders is
 // pinned by a test, which is what having both halves here buys.
-export { parseQueryParams, parseQueryBody, parseChangeParams, parseJournalParams, parseIfMatch, parseUploadFilename, parsePositiveInt, } from './wire-request.js';
+export { parseQueryParams, parseQueryBody, parseChangeParams, parseJournalParams, parseVersionsParams, parseGetRecordParams, parseDeleteParams, parseDownloadParams, parseAssociationParams, parseIfMatch, parseUploadFilename, parsePositiveInt, } from './wire-request.js';
 // The build-side half of the fields that never travel: adapter-api refuses
 // them before encoding, so which encoding a server's content reach selects
 // never decides whether a family query widens or is refused.
@@ -43,6 +44,10 @@ export { parseDate } from './wire-request.js';
 // inherits which half of a record body it may trust rather than deciding
 // field by field. See docs/spec/wire-format.md § Records.
 export { createOptionsFromWireRecord, changesFromWireBody } from './wire-record.js';
+// No in-repo caller: the bodies of the remaining endpoints core specifies,
+// so a server refuses a key they do not define without keeping its own
+// list of the ones they do. See docs/spec/wire-format.md § Unrecognized input.
+export { parseAssociationEditsBody, parseAuthChallengeBody, parseAuthTokenBody, parseEntityPatchBody, parseTypeBody, parseMigrationBody, } from './wire-body.js';
 // The tier gating purge, commitMigration() and includeUnlisted, which
 // a server must decide for those routes itself. Computing it as "is the
 // owner" is a privilege bug with no symptom.

package/dist/wire-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire-entry.js","sourceRoot":"","sources":["../src/wire-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,0EAA0E;AAC1E,0EAA0E;AAC1E,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,6DAA6D;AAC7D,gEAAgE;AAChE,oDAAoD;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,kEAAkE;AAClE,yEAAyE;AACzE,0EAA0E;AAC1E,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAMhG,wEAAwE;AACxE,iEAAiE;AACjE,mEAAmE;AACnE,oCAAoC;AACpC,sEAAsE;AACtE,gEAAgE;AAChE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,2EAA2E;AAC3E,2EAA2E;AAC3E,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,wEAAwE;AACxE,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,uEAAuE;AACvE,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGpF,sEAAsE;AACtE,wEAAwE;AACxE,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"wire-entry.js","sourceRoot":"","sources":["../src/wire-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,0EAA0E;AAC1E,0EAA0E;AAC1E,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,6DAA6D;AAC7D,gEAAgE;AAChE,oDAAoD;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,kEAAkE;AAClE,yEAAyE;AACzE,0EAA0E;AAC1E,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAMhG,wEAAwE;AACxE,iEAAiE;AACjE,uFAAuF;AACvF,6FAA6F;AAC7F,gDAAgD;AAChD,sEAAsE;AACtE,gEAAgE;AAChE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,2EAA2E;AAC3E,2EAA2E;AAC3E,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAOvD,wEAAwE;AACxE,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,uEAAuE;AACvE,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGpF,2EAA2E;AAC3E,uEAAuE;AACvE,+EAA+E;AAC/E,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAQxB,sEAAsE;AACtE,wEAAwE;AACxE,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/wire-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire-record.d.ts","sourceRoot":"","sources":["../src/wire-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,EACV,QAAQ,EAGR,eAAe,EACf,YAAY,EACZ,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0EAA0E;IAC1E,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,WAAW,CAAC,CAAC;CAC5D,CAAC;AA8CF;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,QAAQ,GACtB,iBAAiB,CAoCnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAoDlE"}
+{"version":3,"file":"wire-record.d.ts","sourceRoot":"","sources":["../src/wire-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,EACV,QAAQ,EAGR,eAAe,EAEf,YAAY,EACZ,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0EAA0E;IAC1E,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,WAAW,CAAC,CAAC;CAC5D,CAAC;AAsDF;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,QAAQ,GACtB,iBAAiB,CAyCnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAoDlE"}

package/dist/wire-record.js

@@ -11,21 +11,31 @@
  * here: docs/spec/wire-format.md § Records.
  */
 import { isOwnerActingAlone } from './access.js';
-import { StackBadRequestError, StackValidationError } from './errors.js';
+import { StackBadRequestError } from './errors.js';
+import { fieldError, requireBody } from './wire-body.js';
 import { RECORD_CHANGE_SET_KEYS } from './types.js';
-function requireBody(body) {
-    if (typeof body !== 'object' || body === null || Array.isArray(body))
-        throw new StackBadRequestError('Invalid record body: expected an object');
-    return body;
-}
 /**
- * The refusal a present field earns when its value is the wrong shape.
- * `StackValidationError` because the failure names a field of the record
- * being written, and only that class carries the path.
+ * Every top-level key a wire record carries — a `StackRecord`'s, so a new
+ * field fails to compile here until it is listed. A create body is a whole
+ * record, so each of these is accepted — stamped ones are then dropped —
+ * and anything else is refused. See docs/spec/wire-format.md § Unrecognized input.
  */
-function fieldError(path, message) {
-    throw new StackValidationError([{ path, message }]);
-}
+const WIRE_RECORD_KEYS = Object.keys({
+    id: true,
+    typeId: true,
+    createdAt: true,
+    updatedAt: true,
+    content: true,
+    version: true,
+    parentId: true,
+    appId: true,
+    createdBy: true,
+    updatedBy: true,
+    deletedAt: true,
+    unlistedAt: true,
+    permissions: true,
+    associations: true,
+});
 function optionalString(body, key) {
     const value = body[key];
     if (value === undefined)
@@ -68,7 +78,10 @@ function ownerDate(body, key) {
  * would let the two answers drift.
  */
 export function createOptionsFromWireRecord(body, session, ownerEntityId) {
-    const record = requireBody(body);
+    const record = requireBody(body, 'record body');
+    const unknown = Object.keys(record).filter((key) => !WIRE_RECORD_KEYS.includes(key));
+    if (unknown.length > 0)
+        throw new StackBadRequestError(`Unknown record key${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')}`);
     const typeId = record.typeId;
     if (typeof typeId !== 'string' || typeId === '')
         throw new StackBadRequestError('Invalid record body: typeId is required');
@@ -120,7 +133,7 @@ export function createOptionsFromWireRecord(body, session, ownerEntityId) {
  * See docs/spec/wire-format.md § Records.
  */
 export function changesFromWireBody(body) {
-    const envelope = requireBody(body);
+    const envelope = requireBody(body, 'record body');
     const unknown = Object.keys(envelope).filter((key) => !RECORD_CHANGE_SET_KEYS.includes(key));
     if (unknown.length > 0) {
         throw new StackBadRequestError(`Unknown change-set key${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')}. ` +

package/dist/wire-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire-record.js","sourceRoot":"","sources":["../src/wire-record.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wire-record.js","sourceRoot":"","sources":["../src/wire-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAsBpD;;;;;GAKG;AACH,MAAM,gBAAgB,GAAsB,MAAM,CAAC,IAAI,CAAC;IACtD,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;CACuB,CAAC,CAAC;AAE7C,SAAS,cAAc,CAAC,IAA6B,EAAE,GAAW;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,mBAAmB,CAAC,CAAC;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAI,IAA6B,EAAE,GAAW;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,mBAAmB,CAAC,CAAC;IACtE,OAAO,KAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAA6B,EAAE,GAAW;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QACxD,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,wBAAwB,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAwB,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAa,EACb,OAAqB,EACrB,aAAuB;IAEvB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACrF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,MAAM,IAAI,oBAAoB,CAC5B,qBAAqB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAC;IAEJ,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE;QAC7C,MAAM,IAAI,oBAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3E,MAAM,IAAI,oBAAoB,CAAC,0CAA0C,CAAC,CAAC;IAE7E,MAAM,OAAO,GAAiC,EAAE,CAAC;IAEjD,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACxD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IAE/C,MAAM,WAAW,GAAG,aAAa,CAAuB,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/E,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;IACjE,MAAM,YAAY,GAAG,aAAa,CAAkB,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5E,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IAEpE,oEAAoE;IACpE,6DAA6D;IAC7D,IAAI,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEhF,IAAI,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3D,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAkC,EAAE,OAAO,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC1C,CAAC,GAAG,EAAE,EAAE,CAAC,CAAE,sBAA4C,CAAC,QAAQ,CAAC,GAAG,CAAC,CACtE,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,oBAAoB,CAC5B,yBAAyB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC/E,sCAAsC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC;QACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrE,UAAU,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAC;QAC/D,OAAO,CAAC,YAAY,GAAG,KAAuC,CAAC;IACjE,CAAC;IAED,uEAAuE;IACvE,2DAA2D;IAC3D,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACnC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;YACnD,UAAU,CAAC,UAAU,EAAE,mCAAmC,CAAC,CAAC;QAC9D,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAuB,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjF,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;IACjE,MAAM,YAAY,GAAG,aAAa,CAAkB,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC9E,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IAEpE,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,SAAS;YACxC,UAAU,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,sDAAsD;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,oBAAoB,CAC5B,+DAA+D,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpG,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/wire-request.d.ts

@@ -24,7 +24,7 @@
  * servers already map to 400 — see docs/spec/wire-format.md § Error
  * responses.
  */
-import type { ChangeFilter, JournalQuery, StackQuery } from './types.js';
+import type { DataAssociation, ChangeFilter, JournalQuery, VersionsQuery, StackQuery } from './types.js';
 /** Parse an ISO date string from a wire body; undefined if absent or invalid. */
 export declare function parseDate(val: unknown): Date | undefined;
 /**
@@ -59,7 +59,9 @@ export declare function parseQueryParams(url: URL): StackQuery;
  * Build a `StackQuery` from a `POST /records/query` JSON body — the
  * superset form, which additionally carries `filter.content`. Dates arrive
  * as the ISO strings `JSON.stringify` made of them and are decoded back to
- * `Date`. See docs/spec/wire-format.md § Records.
+ * `Date`. `undefined` is the absent body; `null` or any other non-object
+ * is refused, so a server hands over no body as `undefined`.
+ * See docs/spec/wire-format.md § Records.
  */
 export declare function parseQueryBody(raw: unknown): StackQuery;
 /**
@@ -89,6 +91,54 @@ export declare function parseChangeParams(url: URL): ParsedChangeParams;
  * change feed's opaque cursor. See docs/spec/wire-format.md § Journal.
  */
 export declare function parseJournalParams(url: URL): JournalQuery;
+/**
+ * Parse `GET /records/:id/versions`'s query params into the `VersionsQuery`
+ * `getVersions()` takes. Absent params stay absent, for the reason
+ * parseJournalParams() leaves them so.
+ *
+ * `beforeVersion` is a snapshot's `version`, exclusive.
+ * See docs/spec/wire-format.md § Versions.
+ */
+export declare function parseVersionsParams(url: URL): VersionsQuery;
+/**
+ * Parse `GET /records/:id`'s query params into the `includeDeleted` flag. A
+ * misspelled or non-boolean value is refused rather than read as absent.
+ * See docs/spec/wire-format.md § Records.
+ */
+export declare function parseGetRecordParams(url: URL): {
+    includeDeleted: boolean;
+};
+/**
+ * Parse `DELETE /records/:id`'s query params into the `purge` flag. A
+ * misspelled or non-boolean `purge` is refused rather than read as a soft
+ * delete. See docs/spec/wire-format.md § Records.
+ */
+export declare function parseDeleteParams(url: URL): {
+    purge: boolean;
+};
+/**
+ * The download params, in the names `resolveAttachmentDownloadContentType()`
+ * takes them by. An empty value stays empty rather than absent, so the
+ * resolution treats it exactly as it would an omitted one.
+ */
+export type ParsedDownloadParams = {
+    contentTypeParam?: string;
+    filenameParam?: string;
+};
+/** Parse `GET /attachments/:fileId`'s query params. See docs/spec/wire-format.md § Download. */
+export declare function parseDownloadParams(url: URL): ParsedDownloadParams;
+export type ParsedAssociationParams = {
+    kind?: DataAssociation['kind'];
+    label?: string;
+};
+/**
+ * Parse `GET /records/:id/associations`' query params. An unrecognized
+ * `kind` is refused, since reading it as absent would answer with every
+ * kind. `kind` repeats on `GET /changes` but names one value here, so a
+ * repeat is refused rather than read as its first.
+ * See docs/spec/wire-format.md § Associations.
+ */
+export declare function parseAssociationParams(url: URL): ParsedAssociationParams;
 /**
  * Parse an `If-Match: "5"` header into the version for `ifVersion`.
  * A value that is not a bare, optionally quoted version is refused rather

package/dist/wire-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire-request.d.ts","sourceRoot":"","sources":["../src/wire-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EACV,YAAY,EAEZ,YAAY,EAOZ,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAIxD;AAQD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAkGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAE1D;AA6ID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAsErD;AAaD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAmEvD;AAMD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAiC9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,CAOzD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAYlF"}
+{"version":3,"file":"wire-request.d.ts","sourceRoot":"","sources":["../src/wire-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEZ,YAAY,EACZ,aAAa,EAOb,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAIxD;AA0ED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAmKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAE1D;AA6ID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAuErD;AAaD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAqEvD;AAMD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAkC9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,CAQzD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAU3D;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,CAG1E;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAG9D;AAMD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,oBAAoB,CAQlE;AAMD,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,uBAAuB,CAYxE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAYlF"}

package/dist/wire-request.js

@@ -25,6 +25,7 @@
  * responses.
  */
 import { StackBadRequestError } from './errors.js';
+import { TARGET_KEYS } from './query-validation.js';
 import { NATIVE_SORT_FIELDS } from './types.js';
 // -------------------------------------------------------
 // Shared primitives
@@ -39,8 +40,71 @@ export function parseDate(val) {
 const POSITIVE_INTEGER = /^\d+$/;
 const SORT_FIELDS = new Set(NATIVE_SORT_FIELDS);
 const SORT_DIRECTIONS = new Set(['asc', 'desc']);
-const CHANGE_KINDS = new Set(['created', 'changed', 'deleted', 'purged']);
+const CHANGE_KINDS = new Set(['created', 'changed', 'removed', 'purged']);
+const ASSOCIATION_KINDS = new Set(['tag', 'attachment', 'relationship']);
 const TARGET_KINDS = new Set(['record', 'entity', 'external']);
+/** Every param `GET /records` defines. See docs/spec/wire-format.md § Records. */
+const RECORD_QUERY_PARAMS = [
+    'typeId',
+    'parentId',
+    'appId',
+    'createdBySubject',
+    'createdByPrincipal',
+    'tag',
+    'attachmentLabel',
+    'attachmentFileId',
+    'referencesFileId',
+    'relatedTo',
+    'relatedToStack',
+    'relatedToEntity',
+    'relatedToNs',
+    'relatedToId',
+    'relatedToLabel',
+    'search',
+    'createdBefore',
+    'createdAfter',
+    'updatedBefore',
+    'updatedAfter',
+    'includeDeleted',
+    'includeUnlisted',
+    'sort',
+    'sortContent',
+    'direction',
+    'limit',
+    'cursor',
+];
+const QUERY_BODY_FILTER_KEYS = [
+    'typeId',
+    'parentId',
+    'appId',
+    'createdBy',
+    'tags',
+    'attachment',
+    'referencesFileId',
+    'relatedTo',
+    'content',
+    'contentPresent',
+    'search',
+    'includeDeleted',
+    'includeUnlisted',
+    'createdAt',
+    'updatedAt',
+];
+/**
+ * Every param `GET /changes` defines. `since` is the resume cursor, which
+ * the server reads itself — see parseChangeParams().
+ */
+const CHANGE_PARAMS = [
+    'typeId',
+    'baseId',
+    'parentId',
+    'createdBySubject',
+    'createdByPrincipal',
+    'kind',
+    'include',
+    'includeUnlisted',
+    'since',
+];
 /**
  * Strict positive-integer parse for a URL param — rejects "1abc", "2.7",
  * "-5". Also serves the `:version` path params, which share this
@@ -110,6 +174,57 @@ function requirePlainObject(raw, label) {
         throw new StackBadRequestError(`Invalid ${label}: expected an object`);
     return raw;
 }
+/**
+ * A plain object carrying only `keys`. An unrecognized key is refused
+ * rather than ignored, since ignoring it answers a different request than
+ * the one sent. See docs/spec/wire-format.md § Unrecognized input.
+ */
+function requireKnownKeys(raw, keys, label) {
+    const obj = requirePlainObject(raw, label);
+    const unknown = Object.keys(obj).filter((key) => !keys.includes(key));
+    if (unknown.length > 0)
+        throw new StackBadRequestError(`Unknown key${unknown.length > 1 ? 's' : ''} in ${label}: ${unknown.join(', ')}`);
+    return obj;
+}
+/**
+ * Params a filter repeats to name several values. Any other param names
+ * one value, so a repeat of it is refused rather than read as its first.
+ */
+const REPEATABLE_PARAMS = new Set([
+    'typeId',
+    'baseId',
+    'appId',
+    'createdBySubject',
+    'createdByPrincipal',
+    'tag',
+    'kind',
+]);
+/** The URL-param form of requireKnownKeys(), which also refuses a repeat. */
+function requireKnownParams(url, names) {
+    const present = [...new Set(url.searchParams.keys())];
+    const unknown = present.filter((name) => !names.includes(name));
+    if (unknown.length > 0)
+        throw new StackBadRequestError(`Unknown query param${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')}`);
+    const repeated = present.filter((name) => !REPEATABLE_PARAMS.has(name) && url.searchParams.getAll(name).length > 1);
+    if (repeated.length > 0)
+        throw new StackBadRequestError(`Repeated query param${repeated.length > 1 ? 's' : ''}: ${repeated.join(', ')}`);
+}
+/** A boolean URL param: absent is false, and only `true`/`false` are values. */
+function booleanParam(url, name) {
+    const value = url.searchParams.get(name);
+    if (value === null || value === 'false')
+        return false;
+    if (value === 'true')
+        return true;
+    throw new StackBadRequestError(`Invalid ${name}: expected true or false, got "${value}"`);
+}
+function optionalBoolean(raw, label) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw !== 'boolean')
+        throw new StackBadRequestError(`Invalid ${label}: expected a boolean`);
+    return raw;
+}
 // -------------------------------------------------------
 // Filter fields that never travel
 // -------------------------------------------------------
@@ -156,9 +271,11 @@ export function assertQueryTravels(query) {
  * a kind it does not recognize.
  */
 function parseRelatedToTarget(raw) {
-    const t = requirePlainObject(raw, 'filter.relatedTo.target');
-    if (typeof t.kind !== 'string' || !TARGET_KINDS.has(t.kind))
-        throw new StackBadRequestError(`Invalid filter.relatedTo.target.kind: ${JSON.stringify(t.kind)}`);
+    const label = 'filter.relatedTo.target';
+    const kind = requirePlainObject(raw, label).kind;
+    if (typeof kind !== 'string' || !TARGET_KINDS.has(kind))
+        throw new StackBadRequestError(`Invalid filter.relatedTo.target.kind: ${JSON.stringify(kind)}`);
+    const t = requireKnownKeys(raw, TARGET_KEYS[kind], label);
     if (t.kind === 'record') {
         return {
             kind: 'record',
@@ -182,7 +299,7 @@ function parseRelatedToTarget(raw) {
 }
 /** A label, a target, or both — the body form of the same filter. */
 function parseRelatedToBody(raw) {
-    const r = requirePlainObject(raw, 'filter.relatedTo');
+    const r = requireKnownKeys(raw, ['label', 'target'], 'filter.relatedTo');
     const label = r.label !== undefined ? requireString(r.label, 'filter.relatedTo.label') : undefined;
     const target = r.target !== undefined ? parseRelatedToTarget(r.target) : undefined;
     return {
@@ -253,7 +370,7 @@ function parseAttachmentParams(url) {
     };
 }
 function parseAttachmentBody(raw) {
-    const a = requirePlainObject(raw, 'filter.attachment');
+    const a = requireKnownKeys(raw, ['label', 'fileId'], 'filter.attachment');
     return {
         ...(a.label !== undefined && { label: requireString(a.label, 'filter.attachment.label') }),
         ...(a.fileId !== undefined && { fileId: requireString(a.fileId, 'filter.attachment.fileId') }),
@@ -284,6 +401,7 @@ function parseCreatedByParams(url) {
  */
 export function parseQueryParams(url) {
     assertNoUntravelableFields(url.searchParams.has('baseId'), url.searchParams.has('presentAt'));
+    requireKnownParams(url, RECORD_QUERY_PARAMS);
     const filter = {};
     const typeIds = url.searchParams.getAll('typeId');
     if (typeIds.length)
@@ -328,9 +446,9 @@ export function parseQueryParams(url) {
             ...(updatedAfter && { after: requireDate(updatedAfter, 'updatedAfter') }),
         };
     }
-    if (url.searchParams.get('includeDeleted') === 'true')
+    if (booleanParam(url, 'includeDeleted'))
         filter.includeDeleted = true;
-    if (url.searchParams.get('includeUnlisted') === 'true')
+    if (booleanParam(url, 'includeUnlisted'))
         filter.includeUnlisted = true;
     const query = {};
     if (Object.keys(filter).length)
@@ -359,14 +477,19 @@ function parseLimitValue(raw) {
  * Build a `StackQuery` from a `POST /records/query` JSON body — the
  * superset form, which additionally carries `filter.content`. Dates arrive
  * as the ISO strings `JSON.stringify` made of them and are decoded back to
- * `Date`. See docs/spec/wire-format.md § Records.
+ * `Date`. `undefined` is the absent body; `null` or any other non-object
+ * is refused, so a server hands over no body as `undefined`.
+ * See docs/spec/wire-format.md § Records.
  */
 export function parseQueryBody(raw) {
-    if (!raw || typeof raw !== 'object')
+    if (raw === undefined)
         return {};
-    const body = raw;
+    const body = requirePlainObject(raw, 'query body');
     const f = body.filter !== undefined ? requirePlainObject(body.filter, 'filter') : undefined;
     assertNoUntravelableFields(f !== undefined && 'baseId' in f, 'presentAt' in body);
+    requireKnownKeys(body, ['filter', 'sort', 'limit', 'cursor'], 'query body');
+    if (f)
+        requireKnownKeys(f, QUERY_BODY_FILTER_KEYS, 'filter');
     const query = {};
     if (f) {
         const filter = {};
@@ -377,7 +500,7 @@ export function parseQueryBody(raw) {
         if (f.appId !== undefined)
             filter.appId = requireStringOrArray(f.appId, 'filter.appId');
         if (f.createdBy !== undefined) {
-            const by = requirePlainObject(f.createdBy, 'filter.createdBy');
+            const by = requireKnownKeys(f.createdBy, ['subjectId', 'principalId'], 'filter.createdBy');
             filter.createdBy = {
                 ...(by.subjectId !== undefined && {
                     subjectId: requireStringOrArray(by.subjectId, 'filter.createdBy.subjectId'),
@@ -401,19 +524,19 @@ export function parseQueryBody(raw) {
             filter.contentPresent = requireStringArray(f.contentPresent, 'filter.contentPresent');
         if (f.search !== undefined)
             filter.search = requireString(f.search, 'filter.search');
-        if (f.includeDeleted)
+        if (optionalBoolean(f.includeDeleted, 'filter.includeDeleted'))
             filter.includeDeleted = true;
-        if (f.includeUnlisted)
+        if (optionalBoolean(f.includeUnlisted, 'filter.includeUnlisted'))
             filter.includeUnlisted = true;
-        if (f.createdAt) {
-            const r = requirePlainObject(f.createdAt, 'filter.createdAt');
+        if (f.createdAt !== undefined) {
+            const r = requireKnownKeys(f.createdAt, ['before', 'after'], 'filter.createdAt');
             filter.createdAt = {
                 ...(r.before !== undefined && { before: requireDate(r.before, 'filter.createdAt.before') }),
                 ...(r.after !== undefined && { after: requireDate(r.after, 'filter.createdAt.after') }),
             };
         }
-        if (f.updatedAt) {
-            const r = requirePlainObject(f.updatedAt, 'filter.updatedAt');
+        if (f.updatedAt !== undefined) {
+            const r = requireKnownKeys(f.updatedAt, ['before', 'after'], 'filter.updatedAt');
             filter.updatedAt = {
                 ...(r.before !== undefined && { before: requireDate(r.before, 'filter.updatedAt.before') }),
                 ...(r.after !== undefined && { after: requireDate(r.after, 'filter.updatedAt.after') }),
@@ -421,8 +544,8 @@ export function parseQueryBody(raw) {
         }
         query.filter = filter;
     }
-    if (body.sort) {
-        const s = requirePlainObject(body.sort, 'sort');
+    if (body.sort !== undefined) {
+        const s = requireKnownKeys(body.sort, ['field', 'contentField', 'direction'], 'sort');
         const sort = buildSort(s.field, s.contentField, s.direction);
         if (!sort)
             throw new StackBadRequestError('Invalid sort: expected a field or a contentField.');
@@ -430,8 +553,8 @@ export function parseQueryBody(raw) {
     }
     if (body.limit !== undefined)
         query.limit = parseLimitValue(body.limit);
-    if (typeof body.cursor === 'string')
-        query.cursor = body.cursor;
+    if (body.cursor !== undefined)
+        query.cursor = requireString(body.cursor, 'cursor');
     return query;
 }
 /**
@@ -440,6 +563,7 @@ export function parseQueryBody(raw) {
  * the server's own resumption machinery rather than request encoding.
  */
 export function parseChangeParams(url) {
+    requireKnownParams(url, CHANGE_PARAMS);
     const filter = {};
     const typeIds = url.searchParams.getAll('typeId');
     if (typeIds.length)
@@ -467,7 +591,7 @@ export function parseChangeParams(url) {
     return {
         filter,
         includeRecords: include === 'record',
-        includeUnlisted: url.searchParams.get('includeUnlisted') === 'true',
+        includeUnlisted: booleanParam(url, 'includeUnlisted'),
     };
 }
 /**
@@ -480,6 +604,7 @@ export function parseChangeParams(url) {
  * change feed's opaque cursor. See docs/spec/wire-format.md § Journal.
  */
 export function parseJournalParams(url) {
+    requireKnownParams(url, ['afterSeq', 'limit']);
     const query = {};
     const afterSeq = url.searchParams.get('afterSeq');
     if (afterSeq !== null)
@@ -489,6 +614,80 @@ export function parseJournalParams(url) {
         query.limit = parsePositiveInt(limit, 'limit');
     return query;
 }
+/**
+ * Parse `GET /records/:id/versions`'s query params into the `VersionsQuery`
+ * `getVersions()` takes. Absent params stay absent, for the reason
+ * parseJournalParams() leaves them so.
+ *
+ * `beforeVersion` is a snapshot's `version`, exclusive.
+ * See docs/spec/wire-format.md § Versions.
+ */
+export function parseVersionsParams(url) {
+    requireKnownParams(url, ['beforeVersion', 'limit']);
+    const query = {};
+    const beforeVersion = url.searchParams.get('beforeVersion');
+    if (beforeVersion !== null) {
+        query.beforeVersion = parsePositiveInt(beforeVersion, 'beforeVersion');
+    }
+    const limit = url.searchParams.get('limit');
+    if (limit !== null)
+        query.limit = parsePositiveInt(limit, 'limit');
+    return query;
+}
+// -------------------------------------------------------
+// GET /records/:id
+// -------------------------------------------------------
+/**
+ * Parse `GET /records/:id`'s query params into the `includeDeleted` flag. A
+ * misspelled or non-boolean value is refused rather than read as absent.
+ * See docs/spec/wire-format.md § Records.
+ */
+export function parseGetRecordParams(url) {
+    requireKnownParams(url, ['includeDeleted']);
+    return { includeDeleted: booleanParam(url, 'includeDeleted') };
+}
+// -------------------------------------------------------
+// DELETE /records/:id
+// -------------------------------------------------------
+/**
+ * Parse `DELETE /records/:id`'s query params into the `purge` flag. A
+ * misspelled or non-boolean `purge` is refused rather than read as a soft
+ * delete. See docs/spec/wire-format.md § Records.
+ */
+export function parseDeleteParams(url) {
+    requireKnownParams(url, ['purge']);
+    return { purge: booleanParam(url, 'purge') };
+}
+/** Parse `GET /attachments/:fileId`'s query params. See docs/spec/wire-format.md § Download. */
+export function parseDownloadParams(url) {
+    requireKnownParams(url, ['contentType', 'filename']);
+    const contentType = url.searchParams.get('contentType');
+    const filename = url.searchParams.get('filename');
+    return {
+        ...(contentType !== null && { contentTypeParam: contentType }),
+        ...(filename !== null && { filenameParam: filename }),
+    };
+}
+/**
+ * Parse `GET /records/:id/associations`' query params. An unrecognized
+ * `kind` is refused, since reading it as absent would answer with every
+ * kind. `kind` repeats on `GET /changes` but names one value here, so a
+ * repeat is refused rather than read as its first.
+ * See docs/spec/wire-format.md § Associations.
+ */
+export function parseAssociationParams(url) {
+    requireKnownParams(url, ['kind', 'label']);
+    if (url.searchParams.getAll('kind').length > 1)
+        throw new StackBadRequestError('Repeated query param: kind');
+    const kind = url.searchParams.get('kind');
+    if (kind !== null && !ASSOCIATION_KINDS.has(kind))
+        throw new StackBadRequestError(`Invalid kind: "${kind}"`);
+    const label = url.searchParams.get('label');
+    return {
+        ...(kind !== null && { kind: kind }),
+        ...(label !== null && { label }),
+    };
+}
 // -------------------------------------------------------
 // Headers
 // -------------------------------------------------------