@org-quicko/silo-client 1.0.0

package/dist/entries/entry-list-query.d.ts

@@ -0,0 +1,11 @@
+import type { FilterExpression } from "../query/filter-expression.js";
+import type { SortTerm } from "../query/sort-term.js";
+/** Everything `collection.list()` accepts, all optional. `where`
+ * builds through `collection.filter`; `sort` takes a built `SortTerm` or a
+ * raw string. */
+export interface EntryListQuery {
+    where?: FilterExpression;
+    sort?: SortTerm | string;
+    limit?: number;
+    offset?: number;
+}

package/dist/entries/entry-mapper.d.cts

@@ -0,0 +1,13 @@
+import type { EntryPayload } from "./entry-payload.cjs";
+/**
+ * The one place an entry's envelope (`id`, `rev`, `created_at`, `updated_at`)
+ * is split from its content. Never touches a field name either direction
+ *: whatever is left after the four known keys are removed is handed
+ * back exactly as it arrived.
+ */
+export declare class EntryMapper {
+    static fieldsOf<Fields>(payload: EntryPayload): Fields;
+    /** The flat wire shape `toJSON()` answers: the envelope rebuilt around
+     * whatever `fields` currently holds. */
+    static toPayload<Fields>(id: string, rev: number, fields: Fields, createdAt: Date, updatedAt: Date): EntryPayload;
+}

package/dist/entries/entry-mapper.d.ts

@@ -0,0 +1,13 @@
+import type { EntryPayload } from "./entry-payload.js";
+/**
+ * The one place an entry's envelope (`id`, `rev`, `created_at`, `updated_at`)
+ * is split from its content. Never touches a field name either direction
+ *: whatever is left after the four known keys are removed is handed
+ * back exactly as it arrived.
+ */
+export declare class EntryMapper {
+    static fieldsOf<Fields>(payload: EntryPayload): Fields;
+    /** The flat wire shape `toJSON()` answers: the envelope rebuilt around
+     * whatever `fields` currently holds. */
+    static toPayload<Fields>(id: string, rev: number, fields: Fields, createdAt: Date, updatedAt: Date): EntryPayload;
+}

package/dist/entries/entry-page-stream.d.cts

@@ -0,0 +1,14 @@
+import type { RequestOptions } from "../request-options.cjs";
+import type { EntryPage } from "./entry-page.cjs";
+/**
+ * `collection.pages()`'s return type: whole pages, one at a time, advancing
+ * by each page's own echoed window and stopping on the first short or empty
+ * one — the same termination rule `RowStream` uses, applied one page
+ * up.
+ */
+export declare class EntryPageStream<Row> implements AsyncIterable<EntryPage<Row>> {
+    private readonly loadFirst;
+    private readonly options;
+    constructor(loadFirst: () => Promise<EntryPage<Row>>, options?: RequestOptions);
+    [Symbol.asyncIterator](): AsyncIterator<EntryPage<Row>>;
+}

package/dist/entries/entry-page-stream.d.ts

@@ -0,0 +1,14 @@
+import type { RequestOptions } from "../request-options.js";
+import type { EntryPage } from "./entry-page.js";
+/**
+ * `collection.pages()`'s return type: whole pages, one at a time, advancing
+ * by each page's own echoed window and stopping on the first short or empty
+ * one — the same termination rule `RowStream` uses, applied one page
+ * up.
+ */
+export declare class EntryPageStream<Row> implements AsyncIterable<EntryPage<Row>> {
+    private readonly loadFirst;
+    private readonly options;
+    constructor(loadFirst: () => Promise<EntryPage<Row>>, options?: RequestOptions);
+    [Symbol.asyncIterator](): AsyncIterator<EntryPage<Row>>;
+}

package/dist/entries/entry-page.d.cts

@@ -0,0 +1,16 @@
+import { Page } from "../pagination/page.cjs";
+import type { PageWindow } from "../pagination/page-window.cjs";
+/** Loads the page at `window`, keeping whatever filter and sort produced
+ * this page in the first place. */
+export type EntryPageLoader<Row> = (window: PageWindow) => Promise<EntryPage<Row>>;
+/**
+ * One page of entries, navigated by the window the server echoed
+ * rather than the one requested.
+ */
+export declare class EntryPage<Row> extends Page<Row> {
+    private readonly loader;
+    constructor(rows: readonly Row[], total: number, window: PageWindow, loader: EntryPageLoader<Row>);
+    get entries(): readonly Row[];
+    next(): Promise<EntryPage<Row> | null>;
+    previous(): Promise<EntryPage<Row> | null>;
+}

package/dist/entries/entry-page.d.ts

@@ -0,0 +1,16 @@
+import { Page } from "../pagination/page.js";
+import type { PageWindow } from "../pagination/page-window.js";
+/** Loads the page at `window`, keeping whatever filter and sort produced
+ * this page in the first place. */
+export type EntryPageLoader<Row> = (window: PageWindow) => Promise<EntryPage<Row>>;
+/**
+ * One page of entries, navigated by the window the server echoed
+ * rather than the one requested.
+ */
+export declare class EntryPage<Row> extends Page<Row> {
+    private readonly loader;
+    constructor(rows: readonly Row[], total: number, window: PageWindow, loader: EntryPageLoader<Row>);
+    get entries(): readonly Row[];
+    next(): Promise<EntryPage<Row> | null>;
+    previous(): Promise<EntryPage<Row> | null>;
+}

package/dist/entries/entry-payload.d.cts

@@ -0,0 +1,12 @@
+/**
+ * One entry exactly as the wire answers it: flattened, with the user's
+ * fields alongside the four envelope keys. `EntryUtils.toApiResponse` is
+ * where the server builds this shape.
+ */
+export interface EntryPayload {
+    id: string;
+    rev: number;
+    created_at: string;
+    updated_at: string;
+    [field: string]: unknown;
+}

package/dist/entries/entry-payload.d.ts

@@ -0,0 +1,12 @@
+/**
+ * One entry exactly as the wire answers it: flattened, with the user's
+ * fields alongside the four envelope keys. `EntryUtils.toApiResponse` is
+ * where the server builds this shape.
+ */
+export interface EntryPayload {
+    id: string;
+    rev: number;
+    created_at: string;
+    updated_at: string;
+    [field: string]: unknown;
+}

package/dist/entries/entry-reader.d.cts

@@ -0,0 +1,26 @@
+import type { RequestOptions } from "../request-options.cjs";
+import type { EntryContext } from "./entry-base.cjs";
+import type { EntryListQuery } from "./entry-list-query.cjs";
+import { EntryPage } from "./entry-page.cjs";
+import { EntryPageStream } from "./entry-page-stream.cjs";
+import type { EntryPayload } from "./entry-payload.cjs";
+import { EntryStream } from "./entry-stream.cjs";
+/**
+ * Reads entries out of one collection and hands each answer to `wrap`.
+ *
+ * A collection holds two: one asks for substituted values and answers
+ * snapshots, the other asks for the stored templates and answers editable
+ * entries. Both read the same routes, so the paging is written once here.
+ */
+export declare class EntryReader<Row> {
+    private readonly context;
+    private readonly variables;
+    private readonly wrap;
+    constructor(context: EntryContext, variables: "raw" | undefined, wrap: (payload: EntryPayload) => Row);
+    get(id: string, options?: RequestOptions): Promise<Row>;
+    list(query?: EntryListQuery, options?: RequestOptions): Promise<EntryPage<Row>>;
+    /** Every matching entry, one at a time, `limit` rows per request. */
+    all(query?: EntryListQuery, options?: RequestOptions): EntryStream<Row>;
+    /** Every matching page, one at a time. */
+    pages(query?: EntryListQuery, options?: RequestOptions): EntryPageStream<Row>;
+}

package/dist/entries/entry-reader.d.ts

@@ -0,0 +1,26 @@
+import type { RequestOptions } from "../request-options.js";
+import type { EntryContext } from "./entry-base.js";
+import type { EntryListQuery } from "./entry-list-query.js";
+import { EntryPage } from "./entry-page.js";
+import { EntryPageStream } from "./entry-page-stream.js";
+import type { EntryPayload } from "./entry-payload.js";
+import { EntryStream } from "./entry-stream.js";
+/**
+ * Reads entries out of one collection and hands each answer to `wrap`.
+ *
+ * A collection holds two: one asks for substituted values and answers
+ * snapshots, the other asks for the stored templates and answers editable
+ * entries. Both read the same routes, so the paging is written once here.
+ */
+export declare class EntryReader<Row> {
+    private readonly context;
+    private readonly variables;
+    private readonly wrap;
+    constructor(context: EntryContext, variables: "raw" | undefined, wrap: (payload: EntryPayload) => Row);
+    get(id: string, options?: RequestOptions): Promise<Row>;
+    list(query?: EntryListQuery, options?: RequestOptions): Promise<EntryPage<Row>>;
+    /** Every matching entry, one at a time, `limit` rows per request. */
+    all(query?: EntryListQuery, options?: RequestOptions): EntryStream<Row>;
+    /** Every matching page, one at a time. */
+    pages(query?: EntryListQuery, options?: RequestOptions): EntryPageStream<Row>;
+}

package/dist/entries/entry-stream.d.cts

@@ -0,0 +1,5 @@
+import { RowStream } from "../pagination/row-stream.cjs";
+/** `collection.all()`'s return type: entries one at a time. Named for what
+ *  it yields, though the paging behaviour is entirely {@link RowStream}'s. */
+export declare class EntryStream<Row> extends RowStream<Row> {
+}

package/dist/entries/entry-stream.d.ts

@@ -0,0 +1,5 @@
+import { RowStream } from "../pagination/row-stream.js";
+/** `collection.all()`'s return type: entries one at a time. Named for what
+ *  it yields, though the paging behaviour is entirely {@link RowStream}'s. */
+export declare class EntryStream<Row> extends RowStream<Row> {
+}

package/dist/entries/entry.d.cts

@@ -0,0 +1,25 @@
+import type { RequestOptions } from "../request-options.cjs";
+import { ResolvedEntry } from "./resolved-entry.cjs";
+/**
+ * An editable entry, from a raw read: `posts.edit(id)`, a create, a
+ * replace, or any read on a client constructed with `variables: "raw"`.
+ * `fields` is mutable again here, undoing `ResolvedEntry`'s narrowing.
+ */
+export declare class Entry<Fields> extends ResolvedEntry<Fields> {
+    rev: number;
+    createdAt: Date;
+    updatedAt: Date;
+    fields: Fields;
+    private saving;
+    /**
+     * Sends `PUT` with the rev this instance holds, adopts the rev and
+     * timestamps the response answers, and mutates in place. A second
+     * overlapping call on the same instance is refused locally — it would
+     * send a rev already known to be stale.
+     */
+    save(options?: RequestOptions): Promise<this>;
+    /** Re-reads this entry raw, and replaces `fields`, `rev` and the
+     * timestamps in place — what a `ConflictError` from `save()` calls for. */
+    refresh(options?: RequestOptions): Promise<this>;
+    private adopt;
+}

package/dist/entries/entry.d.ts

@@ -0,0 +1,25 @@
+import type { RequestOptions } from "../request-options.js";
+import { ResolvedEntry } from "./resolved-entry.js";
+/**
+ * An editable entry, from a raw read: `posts.edit(id)`, a create, a
+ * replace, or any read on a client constructed with `variables: "raw"`.
+ * `fields` is mutable again here, undoing `ResolvedEntry`'s narrowing.
+ */
+export declare class Entry<Fields> extends ResolvedEntry<Fields> {
+    rev: number;
+    createdAt: Date;
+    updatedAt: Date;
+    fields: Fields;
+    private saving;
+    /**
+     * Sends `PUT` with the rev this instance holds, adopts the rev and
+     * timestamps the response answers, and mutates in place. A second
+     * overlapping call on the same instance is refused locally — it would
+     * send a rev already known to be stale.
+     */
+    save(options?: RequestOptions): Promise<this>;
+    /** Re-reads this entry raw, and replaces `fields`, `rev` and the
+     * timestamps in place — what a `ConflictError` from `save()` calls for. */
+    refresh(options?: RequestOptions): Promise<this>;
+    private adopt;
+}

package/dist/entries/resolved-entry.d.cts

@@ -0,0 +1,11 @@
+import { EntryBase } from "./entry-base.cjs";
+/**
+ * A read whose variables have been substituted. Adds nothing over
+ * {@link EntryBase}: no `save()`, no `refresh()` — writing a resolved value
+ * back would overwrite whatever `{{NAME}}` template produced it. `fields` is
+ * narrowed to `Readonly<Fields>` at the type level; `Entry` is what an
+ * editor asks for instead.
+ */
+export declare class ResolvedEntry<Fields> extends EntryBase<Fields> {
+    readonly fields: Readonly<Fields>;
+}

package/dist/entries/resolved-entry.d.ts

@@ -0,0 +1,11 @@
+import { EntryBase } from "./entry-base.js";
+/**
+ * A read whose variables have been substituted. Adds nothing over
+ * {@link EntryBase}: no `save()`, no `refresh()` — writing a resolved value
+ * back would overwrite whatever `{{NAME}}` template produced it. `fields` is
+ * narrowed to `Readonly<Fields>` at the type level; `Entry` is what an
+ * editor asks for instead.
+ */
+export declare class ResolvedEntry<Fields> extends EntryBase<Fields> {
+    readonly fields: Readonly<Fields>;
+}

package/dist/errors/conflict-error.d.cts

@@ -0,0 +1,6 @@
+import { SiloError } from "./silo-error.cjs";
+/** A `409`. `code` defaults to `"conflict"` (a stale revision); a subclass
+ *  like {@link MediaInUseError} passes its own more specific wire code. */
+export declare class ConflictError extends SiloError {
+    constructor(message: string, method: string, path: string, code?: string);
+}

package/dist/errors/conflict-error.d.ts

@@ -0,0 +1,6 @@
+import { SiloError } from "./silo-error.js";
+/** A `409`. `code` defaults to `"conflict"` (a stale revision); a subclass
+ *  like {@link MediaInUseError} passes its own more specific wire code. */
+export declare class ConflictError extends SiloError {
+    constructor(message: string, method: string, path: string, code?: string);
+}

package/dist/errors/error-code.d.cts

@@ -0,0 +1,4 @@
+/** The wire's `error.code` values this client maps to a class. An
+ *  unrecognised string still arrives as `string` from the wire; `ErrorFactory`
+ *  falls back to HTTP status when it sees one. */
+export type ErrorCode = "validation_failed" | "unauthorized" | "forbidden" | "not_found" | "conflict" | "media_in_use" | "media_delete_stalled" | "internal";

package/dist/errors/error-code.d.ts

@@ -0,0 +1,4 @@
+/** The wire's `error.code` values this client maps to a class. An
+ *  unrecognised string still arrives as `string` from the wire; `ErrorFactory`
+ *  falls back to HTTP status when it sees one. */
+export type ErrorCode = "validation_failed" | "unauthorized" | "forbidden" | "not_found" | "conflict" | "media_in_use" | "media_delete_stalled" | "internal";

package/dist/errors/error-factory.d.cts

@@ -0,0 +1,15 @@
+import { SiloError } from "./silo-error.cjs";
+/**
+ * Turns a non-2xx response body into the right error class. Reads
+ * the wire's `code` first and falls back to HTTP status when the code is
+ * missing or unrecognised, so it survives a body that is not JSON at all —
+ * an HTML proxy error page, say — without throwing.
+ */
+export declare class ErrorFactory {
+    static fromResponseBody(status: number, method: string, path: string, rawBody: string): SiloError;
+    /** An unrecognised code, or none at all: fall back on the HTTP status, and
+     * on `SiloError` itself when even the status is not one this client
+     * otherwise names a class for. */
+    private static byStatus;
+    private static parse;
+}

package/dist/errors/error-factory.d.ts

@@ -0,0 +1,15 @@
+import { SiloError } from "./silo-error.js";
+/**
+ * Turns a non-2xx response body into the right error class. Reads
+ * the wire's `code` first and falls back to HTTP status when the code is
+ * missing or unrecognised, so it survives a body that is not JSON at all —
+ * an HTML proxy error page, say — without throwing.
+ */
+export declare class ErrorFactory {
+    static fromResponseBody(status: number, method: string, path: string, rawBody: string): SiloError;
+    /** An unrecognised code, or none at all: fall back on the HTTP status, and
+     * on `SiloError` itself when even the status is not one this client
+     * otherwise names a class for. */
+    private static byStatus;
+    private static parse;
+}

package/dist/errors/error-payload.d.cts

@@ -0,0 +1,13 @@
+/**
+ * The wire's error body: `{"error": {"code", "message", "details"}}`.
+ * `details` is left as `unknown` here because its shape is code-specific — an
+ * array for `validation_failed`, an object for `media_in_use` and
+ * `media_delete_stalled`, absent otherwise.
+ */
+export interface ErrorPayload {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}

package/dist/errors/error-payload.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The wire's error body: `{"error": {"code", "message", "details"}}`.
+ * `details` is left as `unknown` here because its shape is code-specific — an
+ * array for `validation_failed`, an object for `media_in_use` and
+ * `media_delete_stalled`, absent otherwise.
+ */
+export interface ErrorPayload {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}

package/dist/errors/forbidden-error.d.cts

@@ -0,0 +1,5 @@
+import { SiloError } from "./silo-error.cjs";
+/** A `403`: the key is valid but does not hold the claim this call needs. */
+export declare class ForbiddenError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}

package/dist/errors/forbidden-error.d.ts

@@ -0,0 +1,5 @@
+import { SiloError } from "./silo-error.js";
+/** A `403`: the key is valid but does not hold the claim this call needs. */
+export declare class ForbiddenError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}

package/dist/errors/internal-error.d.cts

@@ -0,0 +1,6 @@
+import { SiloError } from "./silo-error.cjs";
+/** A `500` with no more specific code: the server has a bug, or hit a
+ *  failure it does not describe further. */
+export declare class InternalError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}

package/dist/errors/internal-error.d.ts

@@ -0,0 +1,6 @@
+import { SiloError } from "./silo-error.js";
+/** A `500` with no more specific code: the server has a bug, or hit a
+ *  failure it does not describe further. */
+export declare class InternalError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}

package/dist/errors/invalid-response-error.d.cts

@@ -0,0 +1,11 @@
+/**
+ * A `2xx` carried a body its route does not promise — an HTML proxy page in
+ * front of a JSON route, say. Distinct from `SiloError`: the request
+ * succeeded, and what is wrong is the shape of the answer, not a refusal.
+ */
+export declare class InvalidResponseError extends Error {
+    readonly method: string;
+    readonly path: string;
+    readonly contentType: string;
+    constructor(method: string, path: string, contentType: string);
+}

package/dist/errors/invalid-response-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A `2xx` carried a body its route does not promise — an HTML proxy page in
+ * front of a JSON route, say. Distinct from `SiloError`: the request
+ * succeeded, and what is wrong is the shape of the answer, not a refusal.
+ */
+export declare class InvalidResponseError extends Error {
+    readonly method: string;
+    readonly path: string;
+    readonly contentType: string;
+    constructor(method: string, path: string, contentType: string);
+}

package/dist/errors/media-delete-stalled-error.d.cts

@@ -0,0 +1,14 @@
+import { SiloError } from "./silo-error.cjs";
+/**
+ * A `500` where the asset was staged for deletion but the blob store refused
+ * to remove its bytes. Not a refusal like {@link MediaInUseError} — it is a
+ * storage failure the caller fixes by fixing the blob store, or by running
+ * the remedy this error names.
+ */
+export declare class MediaDeleteStalledError extends SiloError {
+    readonly remedy: string;
+    constructor(message: string, method: string, path: string, remedy: string);
+    /** Builds from the wire's `error.details` object, which carries `remedy`
+     *  alongside fields this client does not otherwise surface. */
+    static fromWireDetails(message: string, method: string, path: string, details: unknown): MediaDeleteStalledError;
+}

package/dist/errors/media-delete-stalled-error.d.ts

@@ -0,0 +1,14 @@
+import { SiloError } from "./silo-error.js";
+/**
+ * A `500` where the asset was staged for deletion but the blob store refused
+ * to remove its bytes. Not a refusal like {@link MediaInUseError} — it is a
+ * storage failure the caller fixes by fixing the blob store, or by running
+ * the remedy this error names.
+ */
+export declare class MediaDeleteStalledError extends SiloError {
+    readonly remedy: string;
+    constructor(message: string, method: string, path: string, remedy: string);
+    /** Builds from the wire's `error.details` object, which carries `remedy`
+     *  alongside fields this client does not otherwise surface. */
+    static fromWireDetails(message: string, method: string, path: string, details: unknown): MediaDeleteStalledError;
+}

package/dist/errors/media-in-use-error.d.cts

@@ -0,0 +1,21 @@
+import type { MediaUsage } from "../media/media-usage.cjs";
+import { ConflictError } from "./conflict-error.cjs";
+/**
+ * A `409` refusing to delete a media asset still referenced by entries
+ *. Distinct from a plain `ConflictError` because it carries structured
+ * facts a caller can act on: the true usage count, how much of it this key
+ * may see, and the visible referrers themselves — mapped through
+ * `MediaAssetMapper` so the client has one referrer type (`MediaUsage`)
+ * rather than a second one local to this error.
+ */
+export declare class MediaInUseError extends ConflictError {
+    readonly usageCount: number;
+    readonly visibleCount: number;
+    readonly visibleCapped: boolean;
+    readonly referrers: MediaUsage[];
+    constructor(message: string, method: string, path: string, usageCount: number, visibleCount: number, visibleCapped: boolean, referrers: MediaUsage[]);
+    /** Builds from the wire's `error.details`, which for this code is an
+     * OBJECT (`usage_count`, `visible_count`, `visible_capped`, `referrers`),
+     * unlike every other error's array-shaped `details`. */
+    static fromWireDetails(message: string, method: string, path: string, details: unknown): MediaInUseError;
+}

package/dist/errors/media-in-use-error.d.ts

@@ -0,0 +1,21 @@
+import type { MediaUsage } from "../media/media-usage.js";
+import { ConflictError } from "./conflict-error.js";
+/**
+ * A `409` refusing to delete a media asset still referenced by entries
+ *. Distinct from a plain `ConflictError` because it carries structured
+ * facts a caller can act on: the true usage count, how much of it this key
+ * may see, and the visible referrers themselves — mapped through
+ * `MediaAssetMapper` so the client has one referrer type (`MediaUsage`)
+ * rather than a second one local to this error.
+ */
+export declare class MediaInUseError extends ConflictError {
+    readonly usageCount: number;
+    readonly visibleCount: number;
+    readonly visibleCapped: boolean;
+    readonly referrers: MediaUsage[];
+    constructor(message: string, method: string, path: string, usageCount: number, visibleCount: number, visibleCapped: boolean, referrers: MediaUsage[]);
+    /** Builds from the wire's `error.details`, which for this code is an
+     * OBJECT (`usage_count`, `visible_count`, `visible_capped`, `referrers`),
+     * unlike every other error's array-shaped `details`. */
+    static fromWireDetails(message: string, method: string, path: string, details: unknown): MediaInUseError;
+}

package/dist/errors/network-error.d.cts

@@ -0,0 +1,11 @@
+/**
+ * `fetch` itself rejected: the request never reached the server. Does
+ * NOT extend `SiloError`, because nothing answered. A `NetworkError` on a
+ * write does not prove the write did not commit — reconcile by re-reading,
+ * do not blindly retry.
+ */
+export declare class NetworkError extends Error {
+    readonly method: string;
+    readonly path: string;
+    constructor(method: string, path: string, cause: unknown);
+}

package/dist/errors/network-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `fetch` itself rejected: the request never reached the server. Does
+ * NOT extend `SiloError`, because nothing answered. A `NetworkError` on a
+ * write does not prove the write did not commit — reconcile by re-reading,
+ * do not blindly retry.
+ */
+export declare class NetworkError extends Error {
+    readonly method: string;
+    readonly path: string;
+    constructor(method: string, path: string, cause: unknown);
+}

package/dist/errors/not-found-error.d.cts

@@ -0,0 +1,6 @@
+import { SiloError } from "./silo-error.cjs";
+/** A `404`: the project, environment, collection, entry, or asset named in
+ *  the path does not exist. */
+export declare class NotFoundError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}

package/dist/errors/not-found-error.d.ts

@@ -0,0 +1,6 @@
+import { SiloError } from "./silo-error.js";
+/** A `404`: the project, environment, collection, entry, or asset named in
+ *  the path does not exist. */
+export declare class NotFoundError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}

package/dist/errors/request-aborted-error.d.cts

@@ -0,0 +1,10 @@
+/**
+ * The caller's own `AbortSignal` fired. Distinct from
+ * {@link TimeoutError}: this one is the caller changing its mind, not a
+ * deadline the client imposed.
+ */
+export declare class RequestAbortedError extends Error {
+    readonly method: string;
+    readonly path: string;
+    constructor(method: string, path: string);
+}

package/dist/errors/request-aborted-error.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The caller's own `AbortSignal` fired. Distinct from
+ * {@link TimeoutError}: this one is the caller changing its mind, not a
+ * deadline the client imposed.
+ */
+export declare class RequestAbortedError extends Error {
+    readonly method: string;
+    readonly path: string;
+    constructor(method: string, path: string);
+}

package/dist/errors/silo-error.d.cts

@@ -0,0 +1,12 @@
+/**
+ * The base for every error the server itself answered: it received the
+ * request and refused it. `status` and `code` are the wire's;
+ * `method` and `path` say what was being attempted.
+ */
+export declare class SiloError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly method: string;
+    readonly path: string;
+    constructor(status: number, code: string, message: string, method: string, path: string);
+}

package/dist/errors/silo-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The base for every error the server itself answered: it received the
+ * request and refused it. `status` and `code` are the wire's;
+ * `method` and `path` say what was being attempted.
+ */
+export declare class SiloError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly method: string;
+    readonly path: string;
+    constructor(status: number, code: string, message: string, method: string, path: string);
+}

package/dist/errors/timeout-error.d.cts

@@ -0,0 +1,11 @@
+/**
+ * The deadline `AbortSignals` composed fired before an answer came back
+ *. Distinct from {@link RequestAbortedError} so a caller can tell "I
+ * cancelled this" from "this took too long" without inspecting a reason.
+ */
+export declare class TimeoutError extends Error {
+    readonly method: string;
+    readonly path: string;
+    readonly timeoutMilliseconds: number;
+    constructor(method: string, path: string, timeoutMilliseconds: number);
+}

package/dist/errors/timeout-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The deadline `AbortSignals` composed fired before an answer came back
+ *. Distinct from {@link RequestAbortedError} so a caller can tell "I
+ * cancelled this" from "this took too long" without inspecting a reason.
+ */
+export declare class TimeoutError extends Error {
+    readonly method: string;
+    readonly path: string;
+    readonly timeoutMilliseconds: number;
+    constructor(method: string, path: string, timeoutMilliseconds: number);
+}

package/dist/errors/unauthorized-error.d.cts

@@ -0,0 +1,5 @@
+import { SiloError } from "./silo-error.cjs";
+/** A `401`: no key, or a key the server does not recognise. */
+export declare class UnauthorizedError extends SiloError {
+    constructor(message: string, method: string, path: string);
+}