@org-quicko/silo-client 1.0.0 → 1.1.0

package/dist/index.js

@@ -84,6 +84,9 @@ class ApiPath {
   static mediaAssetUsages(id) {
     return `${ApiPath.mediaAsset(id)}/usages`;
   }
+  static mediaAssetContent(id) {
+    return `${ApiPath.mediaAsset(id)}/content`;
+  }
   static mediaBulkDelete() {
     return "/api/media/delete";
   }
@@ -130,6 +133,22 @@ class MediaAssetMapper {
   }
 }
 
+// src/media/media-file.ts
+class MediaFile {
+  static toBlob(bytes, contentType) {
+    if (bytes instanceof Blob)
+      return bytes;
+    return new Blob([bytes], contentType ? { type: contentType } : undefined);
+  }
+  static nameOf(input, explicit) {
+    if (explicit)
+      return explicit;
+    if (input instanceof File && input.name)
+      return input.name;
+    throw new Error("media: a Blob has no filename — pass { filename } explicitly");
+  }
+}
+
 // src/media/media-reference.ts
 class MediaReference {
   static Scheme = "silo://media/";
@@ -291,6 +310,22 @@ class MediaAsset {
   async setTags(tags, options) {
     return this.patch({ tags: [...tags] }, options);
   }
+  async replace(input, options) {
+    const form = new FormData;
+    if (input instanceof Blob) {
+      form.set("file", input, MediaFile.nameOf(input, options?.filename));
+    } else {
+      form.set("file", MediaFile.toBlob(input.bytes, input.contentType), input.filename);
+    }
+    const payload = await this.transport.upload({
+      method: "POST",
+      path: ApiPath.mediaAssetContent(this.id),
+      signal: options?.signal,
+      timeoutMilliseconds: options?.timeoutMilliseconds
+    }, form);
+    this.record = MediaAssetMapper.toRecord(payload);
+    return this;
+  }
   async delete(options) {
     await this.transport.empty({
       method: "DELETE",
@@ -524,11 +559,11 @@ class Media {
     let options;
     if (input instanceof Blob) {
       const fileOptions = second ?? {};
-      form.set("file", input, Media.filenameOf(input, fileOptions.filename));
+      form.set("file", input, MediaFile.nameOf(input, fileOptions.filename));
       folder = fileOptions.folder;
       options = third ?? fileOptions;
     } else {
-      form.set("file", Media.toBlob(input.bytes, input.contentType), input.filename);
+      form.set("file", MediaFile.toBlob(input.bytes, input.contentType), input.filename);
       folder = input.folder;
       options = second;
     }
@@ -596,18 +631,6 @@ class Media {
       sort: query.sort
     };
   }
-  static toBlob(bytes, contentType) {
-    if (bytes instanceof Blob)
-      return bytes;
-    return new Blob([bytes], contentType ? { type: contentType } : undefined);
-  }
-  static filenameOf(input, explicit) {
-    if (explicit)
-      return explicit;
-    if (input instanceof File && input.name)
-      return input.name;
-    throw new Error("media upload: a Blob has no filename — pass { filename } explicitly");
-  }
 }
 
 // src/variables/variable.ts
@@ -678,96 +701,6 @@ class ProjectVariables {
   }
 }
 
-// src/entries/entry-mapper.ts
-class EntryMapper {
-  static fieldsOf(payload) {
-    const { id: _id, rev: _rev, created_at: _createdAt, updated_at: _updatedAt, ...fields } = payload;
-    return fields;
-  }
-  static toPayload(id, rev, fields, createdAt, updatedAt) {
-    return {
-      id,
-      rev,
-      ...fields,
-      created_at: createdAt.toISOString(),
-      updated_at: updatedAt.toISOString()
-    };
-  }
-}
-
-// src/entries/entry-base.ts
-class EntryBase {
-  context;
-  id;
-  rev;
-  createdAt;
-  updatedAt;
-  fields;
-  constructor(context, payload) {
-    this.context = context;
-    this.id = String(payload.id);
-    this.rev = Number(payload.rev);
-    this.createdAt = new Date(payload.created_at);
-    this.updatedAt = new Date(payload.updated_at);
-    this.fields = EntryMapper.fieldsOf(payload);
-  }
-  toJSON() {
-    return EntryMapper.toPayload(this.id, this.rev, this.fields, this.createdAt, this.updatedAt);
-  }
-  async delete(options = {}) {
-    await this.context.transport.empty({
-      method: "DELETE",
-      path: ApiPath.entry(this.context.project, this.context.environment, this.context.collection, this.id),
-      query: { rev: this.rev },
-      ...options
-    });
-  }
-}
-
-// src/entries/resolved-entry.ts
-class ResolvedEntry extends EntryBase {
-}
-
-// src/entries/entry.ts
-class Entry extends ResolvedEntry {
-  saving = false;
-  async save(options = {}) {
-    if (this.saving) {
-      throw new Error(`cannot save entry "${this.id}": a previous save() on this instance has not finished yet`);
-    }
-    this.saving = true;
-    try {
-      const payload = await this.context.transport.json({
-        method: "PUT",
-        path: ApiPath.entry(this.context.project, this.context.environment, this.context.collection, this.id),
-        query: { rev: this.rev, variables: "raw" },
-        body: this.fields,
-        ...options
-      });
-      this.adopt(payload);
-      return this;
-    } finally {
-      this.saving = false;
-    }
-  }
-  async refresh(options = {}) {
-    const payload = await this.context.transport.json({
-      method: "GET",
-      path: ApiPath.entry(this.context.project, this.context.environment, this.context.collection, this.id),
-      query: { variables: "raw" },
-      ...options
-    });
-    this.adopt(payload);
-    return this;
-  }
-  adopt(payload) {
-    this.rev = Number(payload.rev);
-    this.createdAt = new Date(payload.created_at);
-    this.updatedAt = new Date(payload.updated_at);
-    this.fields = EntryMapper.fieldsOf(payload);
-  }
-}
-
 // src/transport/page-payload.ts
 class PagePayload {
   static read(body) {
@@ -828,40 +761,39 @@ class EntryStream extends RowStream {
 
 // src/entries/entry-reader.ts
 class EntryReader {
-  context;
-  variables;
-  wrap;
-  constructor(context, variables, wrap) {
-    this.context = context;
-    this.variables = variables;
-    this.wrap = wrap;
-  }
-  async get(id, options = {}) {
-    const payload = await this.context.transport.json({
+  scope;
+  collection;
+  constructor(scope, collection) {
+    this.scope = scope;
+    this.collection = collection;
+  }
+  get(id, options = {}) {
+    const { variables, ...request } = options;
+    return this.scope.transport.json({
       method: "GET",
-      path: ApiPath.entry(this.context.project, this.context.environment, this.context.collection, id),
-      query: { variables: this.variables },
-      ...options
+      path: ApiPath.entry(this.scope.project, this.scope.environment, this.collection, id),
+      query: { variables },
+      ...request
     });
-    return this.wrap(payload);
   }
   async list(query = {}, options = {}) {
+    const { variables, ...request } = options;
     const loader = (window2) => this.list({ ...query, limit: window2.limit, offset: window2.offset }, options);
-    const body = await this.context.transport.json({
+    const body = await this.scope.transport.json({
       method: "GET",
-      path: ApiPath.entries(this.context.project, this.context.environment, this.context.collection),
+      path: ApiPath.entries(this.scope.project, this.scope.environment, this.collection),
       query: {
         limit: query.limit,
         offset: query.offset,
         filter: query.where?.toJSON(),
         sort: query.sort === undefined ? undefined : String(query.sort),
-        variables: this.variables
+        variables
       },
-      ...options
+      ...request
     });
     const page = PagePayload.read(body);
     const window = new PageWindow(page.limit ?? query.limit ?? 50, page.offset ?? query.offset ?? 0);
-    return new EntryPage(page.rows.map((payload) => this.wrap(payload)), page.total, window, loader);
+    return new EntryPage(page.rows, page.total, window, loader);
   }
   all(query = {}, options = {}) {
     const loader = async (window) => {
@@ -1035,15 +967,15 @@ class Search {
     const window = new PageWindow(page.limit ?? query.limit ?? 50, page.offset ?? query.offset ?? 0);
     const truncated = body.truncated === true;
     const engine = body.engine;
-    const hits = page.rows.map((hit) => this.toHit(hit));
+    const hits = page.rows.map((hit) => Search.toHit(hit));
     return new SearchPage(hits, page.total, window, truncated, engine, loader);
   }
-  toHit(payload) {
+  static toHit(payload) {
     return {
       project: payload.project,
       environment: payload.env,
       collection: payload.collection,
-      entry: new ResolvedEntry({ transport: this.transport, project: payload.project, environment: payload.env, collection: payload.collection }, payload.entry),
+      entry: payload.entry,
       snippets: payload.snippets
     };
   }
@@ -1106,36 +1038,24 @@ class CollectionHandle {
   name;
   filter = new TypedFilter;
   schema;
-  editable;
-  context;
-  resolved;
+  reader;
   constructor(scope, name) {
     this.scope = scope;
     this.name = name;
     this.schema = new CollectionSchema(scope, name);
-    this.context = {
-      transport: scope.transport,
-      project: scope.project,
-      environment: scope.environment,
-      collection: name
-    };
-    this.resolved = new EntryReader(this.context, undefined, (payload) => new ResolvedEntry(this.context, payload));
-    this.editable = new EntryReader(this.context, "raw", (payload) => new Entry(this.context, payload));
+    this.reader = new EntryReader(scope, name);
   }
   get(id, options = {}) {
-    return this.resolved.get(id, options);
-  }
-  edit(id, options = {}) {
-    return this.editable.get(id, options);
+    return this.reader.get(id, options);
   }
   list(query = {}, options = {}) {
-    return this.resolved.list(query, options);
+    return this.reader.list(query, options);
   }
   all(query = {}, options = {}) {
-    return this.resolved.all(query, options);
+    return this.reader.all(query, options);
   }
   pages(query = {}, options = {}) {
-    return this.resolved.pages(query, options);
+    return this.reader.pages(query, options);
   }
   create(fields, options = {}) {
     return this.write("POST", ApiPath.entries(this.scope.project, this.scope.environment, this.name), fields, undefined, options);
@@ -1165,23 +1085,14 @@ class CollectionHandle {
     });
     return RenameReport.fromWire(payload);
   }
-  async write(method, path, fields, rev, options) {
-    const payload = await this.scope.transport.json({
+  write(method, path, fields, rev, options) {
+    return this.scope.transport.json({
       method,
       path,
       query: { rev, variables: "raw" },
       body: fields,
       ...options
     });
-    return new Entry(this.context, payload);
-  }
-}
-
-// src/collections/reserved-field-names.ts
-class ReservedFieldNames {
-  static all = ["id", "rev", "seq", "created_at", "updated_at"];
-  static isReserved(name) {
-    return ReservedFieldNames.all.includes(name);
   }
 }
 
@@ -1200,7 +1111,6 @@ class Collections {
     return body.items.map(Collections.toSummary);
   }
   async create(name, schema, options = {}) {
-    Collections.warnOnReservedFields(schema);
     return this.scope.transport.json({
       method: "POST",
       path: ApiPath.collections(this.scope.project, this.scope.environment),
@@ -1218,13 +1128,6 @@ class Collections {
       updatedAt: new Date(payload.updated_at)
     };
   }
-  static warnOnReservedFields(schema) {
-    for (const name of Object.keys(schema.properties ?? {})) {
-      if (ReservedFieldNames.isReserved(name)) {
-        console.warn(`@org-quicko/silo-client: collection schema declares reserved field "${name}", which the server never returns`);
-      }
-    }
-  }
 }
 
 // src/variables/environment-variables.ts
@@ -1591,12 +1494,19 @@ class NetworkError extends Error {
   method;
   path;
   constructor(method, path, cause) {
-    super(`network error on ${method} ${path}: the request never reached the server`, { cause });
+    super(`network error on ${method} ${path}: the request never reached the server${NetworkError.reason(cause)}`, { cause });
     this.name = "NetworkError";
     this.method = method;
     this.path = path;
     Object.setPrototypeOf(this, NetworkError.prototype);
   }
+  static reason(cause) {
+    if (cause instanceof Error && cause.message)
+      return ` (${cause.message})`;
+    if (typeof cause === "string" && cause)
+      return ` (${cause})`;
+    return "";
+  }
 }
 
 // src/errors/timeout-error.ts
@@ -1710,7 +1620,7 @@ class Transport {
     this.key = options.key;
     this.headers = options.headers ?? {};
     this.timeoutMilliseconds = options.timeoutMilliseconds;
-    this.fetchFunction = options.fetch ?? fetch;
+    this.fetchFunction = Transport.resolveFetch(options.fetch);
   }
   async json(request) {
     const response = await this.execute(request);
@@ -1746,9 +1656,10 @@ class Transport {
   async execute(request, form) {
     const abortSignals = new AbortSignals(request.signal, request.timeoutMilliseconds ?? this.timeoutMilliseconds);
     const url = `${this.url}${request.path}${QueryString.build(request.query)}`;
+    const sendRequest = this.fetchFunction;
     let response;
     try {
-      response = await this.fetchFunction(url, {
+      response = await sendRequest(url, {
         method: request.method,
         headers: this.buildHeaders(request, Boolean(form)),
         body: form ?? (request.body === undefined ? undefined : JSON.stringify(request.body)),
@@ -1786,6 +1697,14 @@ class Transport {
   static normalizeUrl(url) {
     return url.replace(/\/+$/, "");
   }
+  static resolveFetch(fetchFunction) {
+    if (fetchFunction)
+      return fetchFunction;
+    if (typeof globalThis.fetch !== "function") {
+      throw new Error("this runtime has no global fetch: pass one as SiloOptions.fetch");
+    }
+    return globalThis.fetch.bind(globalThis);
+  }
 }
 
 // src/silo.ts
@@ -1870,6 +1789,7 @@ class RouteInventory {
     "PATCH /api/media/:id",
     "DELETE /api/media/:id",
     "GET /api/media/:id/usages",
+    "POST /api/media/:id/content",
     "POST /api/media/delete",
     "GET /api/media/folders",
     "POST /api/media/folders",
@@ -1880,6 +1800,7 @@ class RouteInventory {
     "GET /api/session": "key introspection, an operator surface",
     "GET /api/keys": "keys and claims are an operator surface",
     "POST /api/keys": "keys and claims are an operator surface",
+    "PATCH /api/keys/:id": "keys and claims are an operator surface",
     "DELETE /api/keys/:id": "keys and claims are an operator surface",
     "GET /api/audit": "an operator surface",
     "GET /api/observability": "an operator surface",
@@ -2007,8 +1928,6 @@ export {
   Search,
   RowStream,
   RouteInventory,
-  ResolvedEntry,
-  ReservedFieldNames,
   RequestAbortedError,
   RenameReport,
   Projects,
@@ -2044,8 +1963,6 @@ export {
   EntryReader,
   EntryPageStream,
   EntryPage,
-  EntryBase,
-  Entry,
   ConflictError,
   Collections,
   CollectionSchema,

package/dist/media/media-asset.d.cts

@@ -1,6 +1,7 @@
 import type { RequestOptions } from "../request-options.cjs";
 import type { Transport } from "../transport/transport.cjs";
 import type { MediaDeleteOptions } from "./media-delete-options.cjs";
+import type { MediaReplace, MediaReplaceOptions } from "./media-replace.cjs";
 import type { MediaUsageQuery } from "./media-usage-page.cjs";
 import { MediaUsagePage } from "./media-usage-page.cjs";
 /** `MediaAsset`'s mapped state — `MediaAssetMapper.toRecord`'s output. */
@@ -53,6 +54,22 @@ export declare class MediaAsset {
     moveTo(folder: string, options?: RequestOptions): Promise<this>;
     /** REPLACES the tag list — `PATCH` replaces, it does not append. */
     setTags(tags: readonly string[], options?: RequestOptions): Promise<this>;
+    /**
+     * Swaps the bytes behind this asset (D67). `id`, `reference`, `url`,
+     * `filename` and `folder` all survive; `hash`, `sizeInBytes` and
+     * `contentType` are re-read from the server's answer.
+     *
+     * Every entry referencing it now resolves to the new file, without any of
+     * them being rewritten — which is the point, and the reason the server asks
+     * for `media:replace` **and** `entries:update` at every scope that refers
+     * to it.
+     *
+     * The new file must keep the current extension: the blob key's suffix is
+     * derived from the filename at upload and is the visible tail of the URL on
+     * a bucket-backed instance, so a `.png` asset takes a `.png` replacement.
+     * Converting a file is a new upload, not a replacement of this one.
+     */
+    replace(input: MediaReplace, options?: MediaReplaceOptions): Promise<this>;
     /** Refused while an entry references it; `{ force: true }` also needs
      * `entries:update` on every scope this asset reaches. */
     delete(options?: MediaDeleteOptions): Promise<void>;

package/dist/media/media-asset.d.ts

@@ -1,6 +1,7 @@
 import type { RequestOptions } from "../request-options.js";
 import type { Transport } from "../transport/transport.js";
 import type { MediaDeleteOptions } from "./media-delete-options.js";
+import type { MediaReplace, MediaReplaceOptions } from "./media-replace.js";
 import type { MediaUsageQuery } from "./media-usage-page.js";
 import { MediaUsagePage } from "./media-usage-page.js";
 /** `MediaAsset`'s mapped state — `MediaAssetMapper.toRecord`'s output. */
@@ -53,6 +54,22 @@ export declare class MediaAsset {
     moveTo(folder: string, options?: RequestOptions): Promise<this>;
     /** REPLACES the tag list — `PATCH` replaces, it does not append. */
     setTags(tags: readonly string[], options?: RequestOptions): Promise<this>;
+    /**
+     * Swaps the bytes behind this asset (D67). `id`, `reference`, `url`,
+     * `filename` and `folder` all survive; `hash`, `sizeInBytes` and
+     * `contentType` are re-read from the server's answer.
+     *
+     * Every entry referencing it now resolves to the new file, without any of
+     * them being rewritten — which is the point, and the reason the server asks
+     * for `media:replace` **and** `entries:update` at every scope that refers
+     * to it.
+     *
+     * The new file must keep the current extension: the blob key's suffix is
+     * derived from the filename at upload and is the visible tail of the URL on
+     * a bucket-backed instance, so a `.png` asset takes a `.png` replacement.
+     * Converting a file is a new upload, not a replacement of this one.
+     */
+    replace(input: MediaReplace, options?: MediaReplaceOptions): Promise<this>;
     /** Refused while an entry references it; `{ force: true }` also needs
      * `entries:update` on every scope this asset reaches. */
     delete(options?: MediaDeleteOptions): Promise<void>;

package/dist/media/media-file.d.cts

@@ -0,0 +1,16 @@
+/**
+ * Turning what a caller passed into the two things a multipart part needs: a
+ * `Blob` and a filename.
+ *
+ * Shared by `Media.upload` and `MediaAsset.replace` (D67) rather than copied
+ * into the second. The filename is not cosmetic on either path — the server
+ * reads the extension off it to decide what the library accepts, and on a
+ * replace to decide whether the file's type is changing at all — so the two
+ * entry points must derive it the same way.
+ */
+export declare class MediaFile {
+    static toBlob(bytes: Uint8Array | ArrayBuffer | Blob, contentType?: string): Blob;
+    /** A `File` carries its own name; a bare `Blob` does not, and sending it
+     * as "blob" is worse than refusing outright. */
+    static nameOf(input: Blob, explicit?: string): string;
+}

package/dist/media/media-file.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Turning what a caller passed into the two things a multipart part needs: a
+ * `Blob` and a filename.
+ *
+ * Shared by `Media.upload` and `MediaAsset.replace` (D67) rather than copied
+ * into the second. The filename is not cosmetic on either path — the server
+ * reads the extension off it to decide what the library accepts, and on a
+ * replace to decide whether the file's type is changing at all — so the two
+ * entry points must derive it the same way.
+ */
+export declare class MediaFile {
+    static toBlob(bytes: Uint8Array | ArrayBuffer | Blob, contentType?: string): Blob;
+    /** A `File` carries its own name; a bare `Blob` does not, and sending it
+     * as "blob" is worse than refusing outright. */
+    static nameOf(input: Blob, explicit?: string): string;
+}

package/dist/media/media-replace.d.cts

@@ -0,0 +1,17 @@
+import type { RequestOptions } from "../request-options.cjs";
+/** The fully-described replacement: raw bytes plus the name whose extension
+ *  the server checks against the one the asset already has. No `folder` — a
+ *  replace changes bytes and nothing else about where the asset sits. */
+export interface MediaReplaceBytes {
+    bytes: Uint8Array | ArrayBuffer | Blob;
+    filename: string;
+    contentType?: string;
+}
+/** The filename to read when the input carries none — a `File` has `.name`,
+ *  a bare `Blob` does not, and the extension is what the server checks. */
+export interface MediaReplaceOptions extends RequestOptions {
+    filename?: string;
+}
+/** `MediaAsset.replace()`'s input: a fully-described replacement, or a
+ *  runtime `File`/`Blob`. */
+export type MediaReplace = MediaReplaceBytes | File | Blob;

package/dist/media/media-replace.d.ts

@@ -0,0 +1,17 @@
+import type { RequestOptions } from "../request-options.js";
+/** The fully-described replacement: raw bytes plus the name whose extension
+ *  the server checks against the one the asset already has. No `folder` — a
+ *  replace changes bytes and nothing else about where the asset sits. */
+export interface MediaReplaceBytes {
+    bytes: Uint8Array | ArrayBuffer | Blob;
+    filename: string;
+    contentType?: string;
+}
+/** The filename to read when the input carries none — a `File` has `.name`,
+ *  a bare `Blob` does not, and the extension is what the server checks. */
+export interface MediaReplaceOptions extends RequestOptions {
+    filename?: string;
+}
+/** `MediaAsset.replace()`'s input: a fully-described replacement, or a
+ *  runtime `File`/`Blob`. */
+export type MediaReplace = MediaReplaceBytes | File | Blob;

package/dist/media/media.d.cts

@@ -30,8 +30,4 @@ export declare class Media {
      * per-id outcomes live in the report, not in a thrown error. */
     deleteMany(ids: readonly string[], options?: MediaDeleteOptions): Promise<MediaDeleteReport>;
     private static toWireQuery;
-    private static toBlob;
-    /** A `File` carries its own name; a bare `Blob` does not, and uploading it
-     * as "blob" is worse than refusing outright. */
-    private static filenameOf;
 }

package/dist/media/media.d.ts

@@ -30,8 +30,4 @@ export declare class Media {
      * per-id outcomes live in the report, not in a thrown error. */
     deleteMany(ids: readonly string[], options?: MediaDeleteOptions): Promise<MediaDeleteReport>;
     private static toWireQuery;
-    private static toBlob;
-    /** A `File` carries its own name; a bare `Blob` does not, and uploading it
-     * as "blob" is worse than refusing outright. */
-    private static filenameOf;
 }

package/dist/search/search-hit.d.cts

@@ -1,18 +1,18 @@
-import type { ResolvedEntry } from "../entries/resolved-entry.cjs";
+import type { Entry } from "../entries/entry.cjs";
 import type { SearchSnippet } from "./search-snippet.cjs";
 /**
  * One result. The location sits on the hit rather than on the entry, which is
  * what lets a caller link to a result found outside the scope on screen, and
  * `environment` is mapped from the wire's `env`.
  *
- * The entry is always a `ResolvedEntry`: a result is not addressed to one
- * typed collection, so there is no `Fields` to give it, and it is not meant to
- * be edited from here — re-read through `collection.edit()` for that.
+ * The entry is untyped: a result is not addressed to one collection, so there
+ * is no `Fields` to give it. Its `{{NAME}}` templates are resolved, so read it
+ * again through `collection.get(id, { variables: "raw" })` before editing.
  */
 export interface SearchHit {
     readonly project: string;
     readonly environment: string;
     readonly collection: string;
-    readonly entry: ResolvedEntry<unknown>;
+    readonly entry: Entry;
     readonly snippets: readonly SearchSnippet[];
 }

package/dist/search/search-hit.d.ts

@@ -1,18 +1,18 @@
-import type { ResolvedEntry } from "../entries/resolved-entry.js";
+import type { Entry } from "../entries/entry.js";
 import type { SearchSnippet } from "./search-snippet.js";
 /**
  * One result. The location sits on the hit rather than on the entry, which is
  * what lets a caller link to a result found outside the scope on screen, and
  * `environment` is mapped from the wire's `env`.
  *
- * The entry is always a `ResolvedEntry`: a result is not addressed to one
- * typed collection, so there is no `Fields` to give it, and it is not meant to
- * be edited from here — re-read through `collection.edit()` for that.
+ * The entry is untyped: a result is not addressed to one collection, so there
+ * is no `Fields` to give it. Its `{{NAME}}` templates are resolved, so read it
+ * again through `collection.get(id, { variables: "raw" })` before editing.
  */
 export interface SearchHit {
     readonly project: string;
     readonly environment: string;
     readonly collection: string;
-    readonly entry: ResolvedEntry<unknown>;
+    readonly entry: Entry;
     readonly snippets: readonly SearchSnippet[];
 }

package/dist/search/search.d.cts

@@ -14,5 +14,8 @@ export declare class Search {
     private readonly reach;
     constructor(transport: Transport, reach: SearchReach);
     run(query: SearchQuery, options?: RequestOptions): Promise<SearchPage>;
-    private toHit;
+    /** `env` is the only rename: the hit's own location, which sits here rather
+     * than on the entry so a result found outside the scope on screen can still
+     * be linked to. */
+    private static toHit;
 }

package/dist/search/search.d.ts

@@ -14,5 +14,8 @@ export declare class Search {
     private readonly reach;
     constructor(transport: Transport, reach: SearchReach);
     run(query: SearchQuery, options?: RequestOptions): Promise<SearchPage>;
-    private toHit;
+    /** `env` is the only rename: the hit's own location, which sits here rather
+     * than on the entry so a result found outside the scope on screen can still
+     * be linked to. */
+    private static toHit;
 }

package/dist/transport/api-path.d.cts

@@ -31,6 +31,7 @@ export declare class ApiPath {
     static mediaExtensions(): string;
     static mediaAsset(id: string): string;
     static mediaAssetUsages(id: string): string;
+    static mediaAssetContent(id: string): string;
     static mediaBulkDelete(): string;
     static mediaFolders(): string;
 }