@haverstack/core 0.37.0 → 0.39.0

package/dist/wire-request.d.ts

@@ -20,11 +20,11 @@
  *   `Stack`'s to judge, and judging it twice would let the two answers
  *   drift.
  *
- * Everything here throws `StackQueryError` on malformed input, which
+ * Everything here throws `StackBadRequestError` on malformed input, which
  * 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, 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;
 /**
@@ -85,10 +87,41 @@ export declare function parseChangeParams(url: URL): ParsedChangeParams;
  * omitting `limit` reads the whole log by contract, so supplying a page
  * size here would truncate exactly the caller that omitted it.
  *
- * `sinceSeq` is a journal `seq` — a dense per-record integer, never the
+ * `afterSeq` is a journal `seq` — a dense per-record integer, never the
  * change feed's opaque cursor. See docs/spec/wire-format.md § Journal.
  */
 export declare function parseJournalParams(url: URL): JournalQuery;
+/**
+ * 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,EAMZ,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;AA+FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAE1D;AAsGD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CA0ErD;AAaD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA6DvD;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,CA8B9D;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,EAOZ,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;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"}