@haverstack/core 0.41.0 → 0.43.0

package/dist/{wire-body.js → wire/body.js}

@@ -2,7 +2,7 @@
  * Stack — Wire Request Bodies
  * -------------------------------------------------------
  * The JSON bodies of the endpoints core specifies but runs no server for:
- * the auth handshake, `PATCH /entity`, `POST /types`,
+ * the auth handshake, the per-aspect record writes, `POST /types`,
  * `POST /records/:id/migrate` and `POST /installs`. Each parser names every key its endpoint
  * defines, so a server refuses the rest without keeping its own copy of
  * the list — a copy that drifts the first time core adds a field.
@@ -16,8 +16,8 @@
  * DID's form — so judging them here would let two answers drift.
  * See docs/spec/wire-format.md § Unrecognized input.
  */
-import { StackBadRequestError, StackValidationError } from './errors.js';
-import { assertKnownKeys, validateAssociation } from './query-validation.js';
+import { ARGUMENTS_INVALID, StackBadRequestError, StackValidationError } from '../errors.js';
+import { assertKnownKeys, validateAssociation } from '../associations/validation.js';
 export function requireBody(body, label) {
     if (typeof body !== 'object' || body === null || Array.isArray(body))
         throw new StackBadRequestError(`Invalid ${label}: expected an object`);
@@ -29,7 +29,7 @@ export function requireBody(body, label) {
  * class carries the path.
  */
 export function fieldError(path, message) {
-    throw new StackValidationError([{ path, message }]);
+    throw new StackValidationError([{ path, message }], ARGUMENTS_INVALID);
 }
 /** A body carrying only `keys`; anything else is refused rather than ignored. */
 function requireKnownBody(body, keys, label) {
@@ -79,18 +79,79 @@ export function parseAuthTokenBody(body) {
         signature: requiredString(b, 'signature', label),
     };
 }
-/** Parse a `PATCH /entity` body. See docs/spec/wire-format.md § Entity. */
-export function parseEntityPatchBody(body) {
-    const label = 'entity body';
-    const b = requireKnownBody(body, ['contentPatch'], label);
-    return { contentPatch: requiredObject(b, 'contentPatch', label) };
+// -------------------------------------------------------
+// PATCH /records/:id/content, PATCH /entity/content
+// -------------------------------------------------------
+/**
+ * Parse a content patch body: the bare patch, every key a content key.
+ * Which keys the record's type declares is `patchContent()`'s to judge, so
+ * an undeclared one is its 422 rather than a 400 here.
+ * See docs/spec/wire-format.md § Content.
+ */
+export function parseContentPatchBody(body) {
+    return requireBody(body, 'content patch');
+}
+// -------------------------------------------------------
+// PUT /records/:id/parent, PUT /records/:id/unlisted
+// -------------------------------------------------------
+/**
+ * Parse a `PUT /records/:id/parent` body. `null` is the root, not a
+ * removal spelling. See docs/spec/wire-format.md § Parent.
+ */
+export function parseParentBody(body) {
+    const label = 'parent body';
+    const b = requireKnownBody(body, ['parentId'], label);
+    const { parentId } = b;
+    if (parentId === undefined)
+        throw new StackBadRequestError(`Invalid ${label}: parentId is required`);
+    if (parentId !== null && typeof parentId !== 'string')
+        fieldError('parentId', 'parentId must be a string or null');
+    return { parentId };
+}
+/** Parse a `PUT /records/:id/unlisted` body. See docs/spec/wire-format.md § Unlisted. */
+export function parseUnlistedBody(body) {
+    const label = 'unlisted body';
+    const b = requireKnownBody(body, ['unlisted'], label);
+    const { unlisted } = b;
+    if (unlisted === undefined)
+        throw new StackBadRequestError(`Invalid ${label}: unlisted is required`);
+    if (typeof unlisted !== 'boolean')
+        fieldError('unlisted', 'unlisted must be a boolean');
+    return { unlisted };
+}
+// -------------------------------------------------------
+// PUT /records/:id/associations, PUT /records/:id/permissions
+// -------------------------------------------------------
+/**
+ * Parse a `PUT /records/:id/associations` body into the set
+ * `setAssociations()` takes. Elements are `setAssociations()`'s to judge.
+ * See docs/spec/wire-format.md § Associations.
+ */
+export function parseAssociationsBody(body) {
+    return requiredList(body, 'associations', 'associations body');
+}
+/**
+ * Parse a `PUT /records/:id/permissions` body into the set `setAccess()`
+ * takes; `[]` makes the record private. See docs/spec/wire-format.md § Permissions.
+ */
+export function parsePermissionsBody(body) {
+    return requiredList(body, 'permissions', 'permissions body');
+}
+function requiredList(body, key, label) {
+    const b = requireKnownBody(body, [key], label);
+    const value = b[key];
+    if (value === undefined)
+        throw new StackBadRequestError(`Invalid ${label}: ${key} is required`);
+    if (!Array.isArray(value))
+        fieldError(key, `${key} must be an array`);
+    return value;
 }
 // -------------------------------------------------------
 // POST /records/:id/associations, POST /records/:id/permissions
 // -------------------------------------------------------
 /**
- * Parse an association or permission amend body into the edits
- * `amendAssociations()` takes. `repoint` is something the journal records,
+ * Parse an association or permission edit body into the edits
+ * `editAssociations()` and `editAccess()` take. `repoint` is something the journal records,
  * never something a caller sends, so it is refused with the other unknown
  * ops. Which surface an element belongs to is the endpoint's to judge.
  * See docs/spec/wire-format.md § Associations.
@@ -119,7 +180,7 @@ export function parseAssociationEditsBody(body) {
         const association = requiredObject(edit, 'association', `${label} ${path}`);
         const errors = validateAssociation(association, `${path}.association`);
         if (errors.length > 0)
-            throw new StackValidationError(errors);
+            throw new StackValidationError(errors, ARGUMENTS_INVALID);
         return { op: edit.op, association };
     });
 }
@@ -232,4 +293,4 @@ function nestedArray(obj, at, key) {
         fieldError(`${at}.${key}`, `${key} must be an array`);
     return value;
 }
-//# sourceMappingURL=wire-body.js.map
+//# sourceMappingURL=body.js.map

package/dist/wire/body.js.map

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

package/dist/{wire-entry.d.ts → wire/index.d.ts}

@@ -16,15 +16,15 @@ export { authOriginFromUrl } from './auth.js';
 export { InvalidAuthChallengeError } from './auth.js';
 export { isSafeAttachmentContentType, inferContentTypeFromFilename, resolveAttachmentDownloadContentType, NOSNIFF_HEADER_NAME, NOSNIFF_HEADER_VALUE, } from './attachment-download.js';
 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, parseVersionsParams, parseGetRecordParams, parseDeleteParams, parseDownloadParams, parseAssociationParams, parseIfMatch, parseUploadFilename, parsePositiveInt, } from './wire-request.js';
-export { assertQueryTravels } 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, parseInstallBody, } 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
+export { firstRecordedAttachment, resolveReferencedAttachment } from '../attachment-records.js';
+export type { StackTokenStore, TokenInfo, TokenSession } from '../types/index.js';
+export { parseQueryParams, parseQueryBody, parseChangeParams, parseJournalParams, parseVersionsParams, parseGetRecordParams, parseDeleteParams, parseDownloadParams, parseAssociationParams, parseIfMatch, parseUploadFilename, parseUnsignedInt, } from './request.js';
+export { assertQueryTravels } from './request.js';
+export type { ParsedChangeParams, ParsedDownloadParams, ParsedAssociationParams, } from './request.js';
+export { parseDate } from './request.js';
+export { createOptionsFromWireRecord } from './record.js';
+export type { WireCreateRequest } from './record.js';
+export { parseContentPatchBody, parseParentBody, parseUnlistedBody, parseAssociationEditsBody, parseAssociationsBody, parsePermissionsBody, parseAuthChallengeBody, parseAuthTokenBody, parseTypeBody, parseMigrationBody, parseInstallBody, } from './body.js';
+export type { WireAuthChallengeRequest, WireAuthTokenRequest, WireMigrationRequest, } from './body.js';
+export { isOwnerActingAlone } from '../access.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/wire/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.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;AAI9D,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,mBAAmB,CAAC;AAMlF,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,cAAc,CAAC;AAKtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKrD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/{wire-entry.js → wire/index.js}

@@ -12,8 +12,7 @@
  */
 export { buildAuthChallengePayload, signAuthChallenge, verifyAuthChallenge, didCredentialFromKeypair, base64urlEncode, base64urlDecode, } from './auth.js';
 // No in-repo caller: a server must derive the signing origin from its own
-// configured public origin (haverstack/server#53) — this is the primitive
-// it does that with.
+// configured public origin — this is the primitive it does that with.
 export { authOriginFromUrl } from './auth.js';
 // Thrown by authOriginFromUrl, buildAuthChallengePayload and
 // base64urlDecode above — all public, so a caller needs this to
@@ -23,33 +22,30 @@ export { isSafeAttachmentContentType, inferContentTypeFromFilename, resolveAttac
 // No in-repo caller: resolveAttachmentDownloadContentType() takes
 // storedMimeType as an input rather than selecting the record itself — a
 // server must call these to pick the record a download describes and pass
-// the winner in. Contract, not internal. haverstack/server#37
-export { firstRecordedAttachment, resolveReferencedAttachment } from './attachment-download.js';
+// the winner in. Contract, not internal.
+export { firstRecordedAttachment, resolveReferencedAttachment } from '../attachment-records.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, 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, parseVersionsParams, parseGetRecordParams, parseDeleteParams, parseDownloadParams, parseAssociationParams, parseIfMatch, parseUploadFilename, parsePositiveInt, } from './wire-request.js';
+// builds, so a server decodes every query-bearing route with these rather
+// than transcribing the parameter table. Contract, not internal — the
+// round trip against the builders is pinned by a test.
+export { parseQueryParams, parseQueryBody, parseChangeParams, parseJournalParams, parseVersionsParams, parseGetRecordParams, parseDeleteParams, parseDownloadParams, parseAssociationParams, parseIfMatch, parseUploadFilename, parseUnsignedInt, } from './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.
-export { assertQueryTravels } from './wire-request.js';
+export { assertQueryTravels } from './request.js';
 // Re-exported by @haverstack/wire-types for the response side: one wire
 // date decoding, used by both halves.
-export { parseDate } from './wire-request.js';
+export { parseDate } from './request.js';
 // No in-repo caller: the create half of the same contract, so a server
 // 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';
+export { createOptionsFromWireRecord } from './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, parseInstallBody, } from './wire-body.js';
+export { parseContentPatchBody, parseParentBody, parseUnlistedBody, parseAssociationEditsBody, parseAssociationsBody, parsePermissionsBody, parseAuthChallengeBody, parseAuthTokenBody, parseTypeBody, parseMigrationBody, parseInstallBody, } from './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.
-export { isOwnerActingAlone } from './access.js';
-//# sourceMappingURL=wire-entry.js.map
+export { isOwnerActingAlone } from '../access.js';
+//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wire/index.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,sEAAsE;AACtE,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,yCAAyC;AACzC,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAMhG,wEAAwE;AACxE,0EAA0E;AAC1E,sEAAsE;AACtE,uDAAuD;AACvD,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,cAAc,CAAC;AAEtB,2EAA2E;AAC3E,2EAA2E;AAC3E,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAOlD,wEAAwE;AACxE,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,uEAAuE;AACvE,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAG1D,2EAA2E;AAC3E,uEAAuE;AACvE,+EAA+E;AAC/E,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAOnB,sEAAsE;AACtE,wEAAwE;AACxE,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/wire/record.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Stack — Wire Record Bodies
+ * -------------------------------------------------------
+ * `POST /records` is the one endpoint where a client sends a whole record
+ * and the server may trust only part of it. This module turns that body
+ * into the arguments `ScopedStack.create()` takes, so the disposition of
+ * each field — stamped, conditionally dropped, forwarded — is structural
+ * rather than a property of how carefully a route was written. Which field
+ * gets which is not derivable from its name, and the rules are normative
+ * for servers in other languages, so they live in the spec rather than
+ * here: docs/spec/wire-format.md § Records.
+ */
+import type { BackdatableCreateRecordOptions } from '../stack/client.js';
+import type { EntityId, TokenSession, TypeId } from '../types/index.js';
+/**
+ * A `POST /records` body as the three arguments `ScopedStack.create()`
+ * takes. Not spread-ready, so a call site reads as three deliberate things.
+ */
+export type WireCreateRequest = {
+    typeId: TypeId;
+    content: Record<string, unknown>;
+    /** Omitted, not optional: a caller cannot forward what the type lacks. */
+    options: Omit<BackdatableCreateRecordOptions, 'createdBy'>;
+};
+/**
+ * Read a `POST /records` body as a create. Takes the session, not a
+ * precomputed boolean, so the owner-acting-alone decision stays with its
+ * rule. Values beyond shape are `Stack`'s to judge, or two answers drift.
+ */
+export declare function createOptionsFromWireRecord(body: unknown, session: TokenSession, ownerEntityId: EntityId): WireCreateRequest;
+//# sourceMappingURL=record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/wire/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EACV,QAAQ,EAIR,YAAY,EACZ,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B;;;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;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,QAAQ,GACtB,iBAAiB,CAyCnB"}

package/dist/{wire-record.js → wire/record.js}

@@ -10,10 +10,9 @@
  * for servers in other languages, so they live in the spec rather than
  * here: docs/spec/wire-format.md § Records.
  */
-import { isOwnerActingAlone } from './access.js';
-import { StackBadRequestError } from './errors.js';
-import { fieldError, requireBody } from './wire-body.js';
-import { RECORD_CHANGE_SET_KEYS } from './types.js';
+import { isOwnerActingAlone } from '../access.js';
+import { StackBadRequestError } from '../errors.js';
+import { fieldError, requireBody } from './body.js';
 /**
  * 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
@@ -69,13 +68,9 @@ function ownerDate(body, key) {
     return date;
 }
 /**
- * Read a `POST /records` body as a create. Takes the session rather than a
- * pre-computed boolean so the owner-acting-alone determination stays with
- * the rule that needs it.
- *
- * Beyond shape, values are `Stack`'s to judge — an id's legality, a
- * permission's contents, the content's schema — since judging them twice
- * would let the two answers drift.
+ * Read a `POST /records` body as a create. Takes the session, not a
+ * precomputed boolean, so the owner-acting-alone decision stays with its
+ * rule. Values beyond shape are `Stack`'s to judge, or two answers drift.
  */
 export function createOptionsFromWireRecord(body, session, ownerEntityId) {
     const record = requireBody(body, 'record body');
@@ -118,59 +113,4 @@ export function createOptionsFromWireRecord(body, session, ownerEntityId) {
     }
     return { typeId, content: content, options };
 }
-/**
- * Read a `PATCH /records/:id` body as a change set. The envelope's keys
- * are native aspects, so an unrecognized one is a client reaching for
- * something this endpoint does not have — refused rather than ignored,
- * since a dropped `permissions` silently fails to share and a dropped
- * `unlisted` silently fails to publish.
- *
- * `StackBadRequestError` (400) for a key that addresses nothing and
- * `StackValidationError` (422) for one whose value is the wrong shape —
- * the same split every other write endpoint makes. Content keys are
- * `Stack`'s to judge, so `contentPatch` is checked for being an object and
- * nothing more.
- * See docs/spec/wire-format.md § Records.
- */
-export function changesFromWireBody(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(', ')}. ` +
-            `A change set names one or more of: ${RECORD_CHANGE_SET_KEYS.join(', ')}.`);
-    }
-    const changes = {};
-    if (envelope.contentPatch !== undefined) {
-        const patch = envelope.contentPatch;
-        if (typeof patch !== 'object' || patch === null || Array.isArray(patch))
-            fieldError('contentPatch', 'contentPatch must be an object');
-        changes.contentPatch = patch;
-    }
-    // The one key `null` is a value for rather than a removal spelling: it
-    // is the root, the same sentinel `?parentId=null` carries.
-    if (envelope.parentId !== undefined) {
-        const parentId = envelope.parentId;
-        if (parentId !== null && typeof parentId !== 'string')
-            fieldError('parentId', 'parentId must be a string or null');
-        changes.parentId = parentId;
-    }
-    const permissions = optionalArray(envelope, 'permissions');
-    if (permissions !== undefined)
-        changes.permissions = permissions;
-    const associations = optionalArray(envelope, 'associations');
-    if (associations !== undefined)
-        changes.associations = associations;
-    if (envelope.unlisted !== undefined) {
-        if (typeof envelope.unlisted !== 'boolean')
-            fieldError('unlisted', 'unlisted must be a boolean');
-        changes.unlisted = envelope.unlisted;
-    }
-    // Every key was absent. Refused here rather than left to mutate(), so a
-    // server answers 400 without a storage round trip; mutate() refuses it
-    // again for callers that never went through the wire.
-    if (Object.keys(changes).length === 0) {
-        throw new StackBadRequestError(`An empty change set addresses nothing. Name one or more of: ${RECORD_CHANGE_SET_KEYS.join(', ')}.`);
-    }
-    return changes;
-}
-//# sourceMappingURL=wire-record.js.map
+//# sourceMappingURL=record.js.map

package/dist/wire/record.js.map

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

package/dist/{wire-request.d.ts → wire/request.d.ts}

@@ -24,56 +24,48 @@
  * servers already map to 400 — see docs/spec/wire-format.md § Error
  * responses.
  */
-import type { DataAssociation, ChangeFilter, JournalQuery, VersionsQuery, StackQuery } from './types.js';
+import type { DataAssociation, ChangeFilter, JournalQuery, VersionsQuery, StackQuery, PlainQuery } from '../types/index.js';
 /** Parse an ISO date string from a wire body; undefined if absent or invalid. */
 export declare function parseDate(val: unknown): Date | undefined;
 /**
- * Strict positive-integer parse for a URL param — rejects "1abc", "2.7",
- * "-5". Also serves the `:version` path params, which share this
- * "malformed, don't silently coerce" requirement.
+ * Strict digits-only parse for a URL param — rejects "1abc", "2.7", "-5".
+ * Shape only: whether 0 is in range is `Stack`'s to judge. Also serves the
+ * `:version` path params, which share this "malformed, don't silently
+ * coerce" requirement.
  */
-export declare function parsePositiveInt(raw: string, label: string): number;
+export declare function parseUnsignedInt(raw: string, label: string): number;
 /**
- * The client half of the same refusal, applied before a request is built
- * rather than after one arrives. `Stack.query()` resolves `filter.baseId`
- * against registered Types and applies `presentAt` itself, so neither
- * reaches an adapter through it — this catches the direct adapter call,
- * where the encoding would otherwise decide the answer: a query body
- * carries both fields to a server that refuses them, while search params
- * have nowhere to put them and would drop them into a wider result set.
- *
- * Absent and explicitly `undefined` are the same thing here, as they are
- * to `Stack.query()`. The parsers above test key presence instead, because
- * over the wire writing the key at all is a client that meant to send it.
+ * The client half of the same refusal, before a request is built.
+ * `Stack.query()` applies `presentAt` itself, so this catches the direct
+ * adapter call, where search params would drop it. Absent and `undefined`
+ * are one here; the parsers test presence, since over the wire a written
+ * key is one the client meant to send.
  */
 export declare function assertQueryTravels(query: StackQuery): void;
 /**
- * Build a `StackQuery` from `GET /records` search params — the inverse of
+ * Build a `PlainQuery` from `GET /records` search params — the inverse of
  * what `APIAdapter` encodes for a server that reaches no content.
  * `parentId=null` is the literal string, the sentinel for "top level":
  * Crockford base-32 excludes `u` and `l`, so no record ID can collide
  * with it. See docs/spec/wire-format.md § Records.
  */
-export declare function parseQueryParams(url: URL): StackQuery;
+export declare function parseQueryParams(url: URL): PlainQuery;
 /**
- * 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`. `undefined` is the absent body; `null` or any other non-object
- * is refused, so a server hands over no body as `undefined`.
+ * Build a `PlainQuery` from a `POST /records/query` body — the superset
+ * form, which also carries `filter.content`, with ISO date strings decoded.
+ * `undefined` is the absent body; any other non-object is refused.
  * See docs/spec/wire-format.md § Records.
  */
-export declare function parseQueryBody(raw: unknown): StackQuery;
+export declare function parseQueryBody(raw: unknown): PlainQuery;
 /**
- * What `GET /changes`' query params carry. One object rather than three
- * exports because `includeUnlisted` sits on `SubscribeOptions` rather than
- * `ChangeFilter`, and a server needs it before the stream opens to answer
- * the owner-only 403. See docs/spec/change-feed.md.
+ * What `GET /changes`' query params carry: the filter, and `includeRecords`,
+ * which sits on `SubscribeOptions` beside it. A server reads
+ * `filter.includeUnlisted` before the stream opens to answer the
+ * owner-only 403. See docs/spec/change-feed.md.
  */
 export type ParsedChangeParams = {
     filter: ChangeFilter;
     includeRecords: boolean;
-    includeUnlisted: boolean;
 };
 /**
  * Parse `GET /changes`' query params. The resume cursor is deliberately
@@ -82,21 +74,15 @@ export type ParsedChangeParams = {
  */
 export declare function parseChangeParams(url: URL): ParsedChangeParams;
 /**
- * Parse `GET /records/:id/journal`'s query params into the `JournalQuery`
- * `getJournal()` takes. Absent params stay absent rather than defaulting:
- * omitting `limit` reads the whole log by contract, so supplying a page
- * size here would truncate exactly the caller that omitted it.
- *
- * `afterSeq` is a journal `seq` — a dense per-record integer, never the
- * change feed's opaque cursor. See docs/spec/wire-format.md § Journal.
+ * Parse `GET /records/:id/journal`'s params into a `JournalQuery`. Absent
+ * stays absent: omitting `limit` reads the whole log, which a default page
+ * size would truncate. `afterSeq` is a journal `seq`, never a feed 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.
+ * Parse `GET /records/:id/versions`'s params into a `VersionsQuery`; absent
+ * stays absent, as in parseJournalParams(). `beforeVersion` is exclusive.
  * See docs/spec/wire-format.md § Versions.
  */
 export declare function parseVersionsParams(url: URL): VersionsQuery;
@@ -140,13 +126,10 @@ export type ParsedAssociationParams = {
  */
 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
- * than read as absent: the header exists to fence a write, so degrading a
- * malformed one to an unconditional last-writer-wins mutation defeats the
- * only thing it was sent to do. Weak comparators (`W/"5"`) are refused for
- * the same reason — a version match is exact or it is nothing.
- * See docs/spec/wire-format.md § Records.
+ * Parse `If-Match: "5"` into `ifVersion`. Anything but a bare, optionally
+ * quoted version — weak `W/"5"` included — is refused, not read as absent:
+ * degrading the fence to last-writer-wins defeats the one thing it was
+ * sent for. See docs/spec/wire-format.md § Records.
  */
 export declare function parseIfMatch(header: string | undefined): number | undefined;
 /**
@@ -156,4 +139,4 @@ export declare function parseIfMatch(header: string | undefined): number | undef
  * quoted form. See docs/spec/wire-format.md § Upload.
  */
 export declare function parseUploadFilename(header: string | undefined): string | undefined;
-//# sourceMappingURL=wire-request.d.ts.map
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/wire/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEZ,YAAY,EACZ,aAAa,EASb,UAAU,EACV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAM3B,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAIxD;AA6ED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAwKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAE1D;AA2ID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CA0ErD;AAmDD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA4EvD;AAMD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAmC9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,CAQzD;AAED;;;;GAIG;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;;;;;GAKG;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"}