@inneropen/marvin-sdk 4.2.0 → 4.3.0

package/dist/{HttpClient-B_rEmJuO.d.cts → HttpClient-DXMNOPqu.d.cts}

@@ -79,6 +79,11 @@ interface RetryConfig {
      */
     retryableStatuses: number[];
 }
+/** A successful binary read: the body's bytes and the server's content type. */
+interface BinaryResponse {
+    data: Uint8Array;
+    contentType: string | null;
+}
 interface HttpClientConfig {
     baseUrl: string;
     auth: AuthStrategy;
@@ -158,6 +163,11 @@ declare class HttpClient {
          * Still clamped to MAX_TIMEOUT.
          */
         timeout?: number;
+        /**
+         * `'binary'` hands back a {@link BinaryResponse} (the raw bytes) instead of parsing JSON. Retries,
+         * redirects and errors behave exactly as for a JSON read.
+         */
+        responseType?: 'json' | 'binary';
     }, retryAttempt?: number): Promise<T>;
     /**
      * A successful response's JSON body, or `undefined` when there is none: 204/205, `content-length: 0`,
@@ -165,10 +175,16 @@ declare class HttpClient {
      * JSON is a `MarvinApiError` naming the request — never a network error, and never retried.
      */
     private readBody;
+    /** A successful response's bytes; a 204/205 is an empty array. A failed read is a network error. */
+    private readBinary;
     /**
      * GET request
      */
     get<T>(endpoint: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    /**
+     * GET a binary body (a file download). Follows redirects; retried like any GET.
+     */
+    getBinary(endpoint: string, params?: Record<string, string | number | boolean | undefined>): Promise<BinaryResponse>;
     /**
      * POST request
      */
@@ -189,4 +205,4 @@ declare class HttpClient {
     delete<T>(endpoint: string): Promise<T>;
 }
 
-export { type AuthStrategy as A, BearerTokenAuth as B, HttpClient as H, NoAuth as N, SessionAuth as S, type HttpClientConfig as a };
+export { type AuthStrategy as A, BearerTokenAuth as B, HttpClient as H, NoAuth as N, SessionAuth as S, type BinaryResponse as a, type HttpClientConfig as b };

package/dist/{HttpClient-B_rEmJuO.d.ts → HttpClient-DXMNOPqu.d.ts}

@@ -79,6 +79,11 @@ interface RetryConfig {
      */
     retryableStatuses: number[];
 }
+/** A successful binary read: the body's bytes and the server's content type. */
+interface BinaryResponse {
+    data: Uint8Array;
+    contentType: string | null;
+}
 interface HttpClientConfig {
     baseUrl: string;
     auth: AuthStrategy;
@@ -158,6 +163,11 @@ declare class HttpClient {
          * Still clamped to MAX_TIMEOUT.
          */
         timeout?: number;
+        /**
+         * `'binary'` hands back a {@link BinaryResponse} (the raw bytes) instead of parsing JSON. Retries,
+         * redirects and errors behave exactly as for a JSON read.
+         */
+        responseType?: 'json' | 'binary';
     }, retryAttempt?: number): Promise<T>;
     /**
      * A successful response's JSON body, or `undefined` when there is none: 204/205, `content-length: 0`,
@@ -165,10 +175,16 @@ declare class HttpClient {
      * JSON is a `MarvinApiError` naming the request — never a network error, and never retried.
      */
     private readBody;
+    /** A successful response's bytes; a 204/205 is an empty array. A failed read is a network error. */
+    private readBinary;
     /**
      * GET request
      */
     get<T>(endpoint: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    /**
+     * GET a binary body (a file download). Follows redirects; retried like any GET.
+     */
+    getBinary(endpoint: string, params?: Record<string, string | number | boolean | undefined>): Promise<BinaryResponse>;
     /**
      * POST request
      */
@@ -189,4 +205,4 @@ declare class HttpClient {
     delete<T>(endpoint: string): Promise<T>;
 }
 
-export { type AuthStrategy as A, BearerTokenAuth as B, HttpClient as H, NoAuth as N, SessionAuth as S, type HttpClientConfig as a };
+export { type AuthStrategy as A, BearerTokenAuth as B, HttpClient as H, NoAuth as N, SessionAuth as S, type BinaryResponse as a, type HttpClientConfig as b };

package/dist/{chunk-HFNIFS2A.js → chunk-KXI2FQSO.js}

@@ -6,7 +6,7 @@ import {
   __export,
   init_core,
   init_errors
-} from "./chunk-DSVYCVQD.js";
+} from "./chunk-LTX3MAUE.js";
 
 // src/client/config.ts
 var config_exports = {};
@@ -320,6 +320,11 @@ var init_resource = __esm({
 });
 
 // src/entries/entries.ts
+function csv(value) {
+  if (value === void 0) return void 0;
+  const joined = (Array.isArray(value) ? value : [value]).map((v) => v.trim()).filter(Boolean).join(",");
+  return joined || void 0;
+}
 function toListEntry(raw) {
   const { collections, ...rest } = raw;
   return {
@@ -347,6 +352,9 @@ var init_entries = __esm({
         const queryString = this.http.buildQueryString({
           entry_type: options.entryType,
           collection: options.collection,
+          tag: csv(options.tag),
+          slug: csv(options.slug),
+          updated_since: options.updatedSince instanceof Date ? options.updatedSince.toISOString() : options.updatedSince,
           limit: options.limit,
           offset: options.offset,
           expand: options.expand
@@ -514,6 +522,14 @@ var init_assets = __esm({
         const endpoint = `/api/publish/${this.workspaceSlug}/assets/${slugOrId}`;
         return this.http.fetch(endpoint);
       }
+      /**
+       * Download a published asset's file by slug: its bytes and content type. The file route
+       * redirects to storage; the redirect is followed. Needs the `read:assets` permission.
+       */
+      async download(slug) {
+        const validSlug = this.http.validatePathParam(slug, "asset slug");
+        return this.http.getBinary(`/api/publish/${this.workspaceSlug}/assets/${validSlug}/file`);
+      }
       /**
        * Convenience: Get all images
        */

package/dist/{chunk-DSVYCVQD.js → chunk-LTX3MAUE.js}

@@ -383,6 +383,9 @@ var init_HttpClient = __esm({
             errorText
           );
         }
+        if (options?.responseType === "binary") {
+          return await this.readBinary(response, method, endpoint);
+        }
         const data = await this.readBody(response, method, endpoint);
         if (this.debug && data !== void 0) {
           const sanitized = this.sanitizeForLogging(data);
@@ -428,12 +431,34 @@ var init_HttpClient = __esm({
           );
         }
       }
+      /** A successful response's bytes; a 204/205 is an empty array. A failed read is a network error. */
+      async readBinary(response, method, endpoint) {
+        const contentType = response.headers.get("content-type");
+        if (response.status === 204 || response.status === 205) {
+          return { data: new Uint8Array(0), contentType };
+        }
+        try {
+          return { data: new Uint8Array(await response.arrayBuffer()), contentType };
+        } catch (error) {
+          const cause = error instanceof Error ? error : void 0;
+          throw new MarvinNetworkError(
+            `Reading the ${response.status} response to ${method} ${endpoint} failed: ${cause?.message ?? String(error)}`,
+            cause
+          );
+        }
+      }
       /**
        * GET request
        */
       async get(endpoint, params) {
         return this.request("GET", endpoint, { params });
       }
+      /**
+       * GET a binary body (a file download). Follows redirects; retried like any GET.
+       */
+      async getBinary(endpoint, params) {
+        return this.request("GET", endpoint, { params, responseType: "binary" });
+      }
       /**
        * POST request
        */

package/dist/index.cjs

@@ -510,6 +510,9 @@ var init_HttpClient = __esm({
             errorText
           );
         }
+        if (options?.responseType === "binary") {
+          return await this.readBinary(response, method, endpoint);
+        }
         const data = await this.readBody(response, method, endpoint);
         if (this.debug && data !== void 0) {
           const sanitized = this.sanitizeForLogging(data);
@@ -555,12 +558,34 @@ var init_HttpClient = __esm({
           );
         }
       }
+      /** A successful response's bytes; a 204/205 is an empty array. A failed read is a network error. */
+      async readBinary(response, method, endpoint) {
+        const contentType = response.headers.get("content-type");
+        if (response.status === 204 || response.status === 205) {
+          return { data: new Uint8Array(0), contentType };
+        }
+        try {
+          return { data: new Uint8Array(await response.arrayBuffer()), contentType };
+        } catch (error) {
+          const cause = error instanceof Error ? error : void 0;
+          throw new MarvinNetworkError(
+            `Reading the ${response.status} response to ${method} ${endpoint} failed: ${cause?.message ?? String(error)}`,
+            cause
+          );
+        }
+      }
       /**
        * GET request
        */
       async get(endpoint, params) {
         return this.request("GET", endpoint, { params });
       }
+      /**
+       * GET a binary body (a file download). Follows redirects; retried like any GET.
+       */
+      async getBinary(endpoint, params) {
+        return this.request("GET", endpoint, { params, responseType: "binary" });
+      }
       /**
        * POST request
        */
@@ -993,6 +1018,11 @@ var init_entry = __esm({
 });
 
 // src/entries/entries.ts
+function csv(value) {
+  if (value === void 0) return void 0;
+  const joined = (Array.isArray(value) ? value : [value]).map((v) => v.trim()).filter(Boolean).join(",");
+  return joined || void 0;
+}
 function toListEntry(raw) {
   const { collections, ...rest } = raw;
   return {
@@ -1020,6 +1050,9 @@ var init_entries = __esm({
         const queryString = this.http.buildQueryString({
           entry_type: options.entryType,
           collection: options.collection,
+          tag: csv(options.tag),
+          slug: csv(options.slug),
+          updated_since: options.updatedSince instanceof Date ? options.updatedSince.toISOString() : options.updatedSince,
           limit: options.limit,
           offset: options.offset,
           expand: options.expand
@@ -1253,6 +1286,14 @@ var init_assets = __esm({
         const endpoint = `/api/publish/${this.workspaceSlug}/assets/${slugOrId}`;
         return this.http.fetch(endpoint);
       }
+      /**
+       * Download a published asset's file by slug: its bytes and content type. The file route
+       * redirects to storage; the redirect is followed. Needs the `read:assets` permission.
+       */
+      async download(slug) {
+        const validSlug = this.http.validatePathParam(slug, "asset slug");
+        return this.http.getBinary(`/api/publish/${this.workspaceSlug}/assets/${validSlug}/file`);
+      }
       /**
        * Convenience: Get all images
        */

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { M as MarvinConfig, a as MarvinClient } from './marvin-BiXcixLB.cjs';
-export { C as Collection, E as Entry, b as MarvinApiError, c as MarvinAuthError, d as MarvinCache, e as MarvinConfigError, f as MarvinError, g as MarvinNetworkError, h as MarvinNotFoundError, i as MarvinServerError, j as MarvinValidationError, P as PaginatedResponse, k as PaginationMeta, l as PaginationParams, R as Resource, W as Workspace, m as createConfigFromEnv, n as createPaginatedResponse, o as extractData, p as isFullEntryData, q as isPaginatedResponse, r as offsetToPage, s as pageToOffset } from './marvin-BiXcixLB.cjs';
-import { H as HttpClient } from './HttpClient-B_rEmJuO.cjs';
-export { A as AuthStrategy, B as BearerTokenAuth, a as HttpClientConfig, N as NoAuth, S as SessionAuth } from './HttpClient-B_rEmJuO.cjs';
+import { M as MarvinConfig, a as MarvinClient } from './marvin-gZtGa576.cjs';
+export { C as Collection, E as Entry, b as MarvinApiError, c as MarvinAuthError, d as MarvinCache, e as MarvinConfigError, f as MarvinError, g as MarvinNetworkError, h as MarvinNotFoundError, i as MarvinServerError, j as MarvinValidationError, P as PaginatedResponse, k as PaginationMeta, l as PaginationParams, R as Resource, W as Workspace, m as createConfigFromEnv, n as createPaginatedResponse, o as extractData, p as isFullEntryData, q as isPaginatedResponse, r as offsetToPage, s as pageToOffset } from './marvin-gZtGa576.cjs';
+import { H as HttpClient } from './HttpClient-DXMNOPqu.cjs';
+export { A as AuthStrategy, B as BearerTokenAuth, a as BinaryResponse, b as HttpClientConfig, N as NoAuth, S as SessionAuth } from './HttpClient-DXMNOPqu.cjs';
 import { A as AuthToken$1 } from './index-BEEbnrXV.cjs';
 export { C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, e as ExpandOptions, G as GetAssetsOptions, f as GetEntriesOptions, g as GetResourcesOptions, L as ListEntry, M as MarvinAsset, h as MarvinCollection, i as MarvinCollectionExpanded, j as MarvinEntry, k as MarvinEntryListItem, l as MarvinEntryType, m as MarvinPublishResponse, n as MarvinResource, o as MarvinSite, P as PublishedAssetRead, p as PublishedCollectionSummary, q as PublishedEntryAsset, r as PublishedEntryResource, s as PublishedEntryType, S as SiteConfiguration, W as WorkspaceInfo } from './index-BEEbnrXV.cjs';
 

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { M as MarvinConfig, a as MarvinClient } from './marvin-BjJXe-YT.js';
-export { C as Collection, E as Entry, b as MarvinApiError, c as MarvinAuthError, d as MarvinCache, e as MarvinConfigError, f as MarvinError, g as MarvinNetworkError, h as MarvinNotFoundError, i as MarvinServerError, j as MarvinValidationError, P as PaginatedResponse, k as PaginationMeta, l as PaginationParams, R as Resource, W as Workspace, m as createConfigFromEnv, n as createPaginatedResponse, o as extractData, p as isFullEntryData, q as isPaginatedResponse, r as offsetToPage, s as pageToOffset } from './marvin-BjJXe-YT.js';
-import { H as HttpClient } from './HttpClient-B_rEmJuO.js';
-export { A as AuthStrategy, B as BearerTokenAuth, a as HttpClientConfig, N as NoAuth, S as SessionAuth } from './HttpClient-B_rEmJuO.js';
+import { M as MarvinConfig, a as MarvinClient } from './marvin-CdsjwIyH.js';
+export { C as Collection, E as Entry, b as MarvinApiError, c as MarvinAuthError, d as MarvinCache, e as MarvinConfigError, f as MarvinError, g as MarvinNetworkError, h as MarvinNotFoundError, i as MarvinServerError, j as MarvinValidationError, P as PaginatedResponse, k as PaginationMeta, l as PaginationParams, R as Resource, W as Workspace, m as createConfigFromEnv, n as createPaginatedResponse, o as extractData, p as isFullEntryData, q as isPaginatedResponse, r as offsetToPage, s as pageToOffset } from './marvin-CdsjwIyH.js';
+import { H as HttpClient } from './HttpClient-DXMNOPqu.js';
+export { A as AuthStrategy, B as BearerTokenAuth, a as BinaryResponse, b as HttpClientConfig, N as NoAuth, S as SessionAuth } from './HttpClient-DXMNOPqu.js';
 import { A as AuthToken$1 } from './index-BEEbnrXV.js';
 export { C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, e as ExpandOptions, G as GetAssetsOptions, f as GetEntriesOptions, g as GetResourcesOptions, L as ListEntry, M as MarvinAsset, h as MarvinCollection, i as MarvinCollectionExpanded, j as MarvinEntry, k as MarvinEntryListItem, l as MarvinEntryType, m as MarvinPublishResponse, n as MarvinResource, o as MarvinSite, P as PublishedAssetRead, p as PublishedCollectionSummary, q as PublishedEntryAsset, r as PublishedEntryResource, s as PublishedEntryType, S as SiteConfiguration, W as WorkspaceInfo } from './index-BEEbnrXV.js';
 

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   init_workspace,
   isFullEntryData,
   marvin_exports
-} from "./chunk-HFNIFS2A.js";
+} from "./chunk-KXI2FQSO.js";
 import {
   BearerTokenAuth,
   HttpClient,
@@ -37,7 +37,7 @@ import {
   offsetToPage,
   pageToOffset,
   validateEmail
-} from "./chunk-DSVYCVQD.js";
+} from "./chunk-LTX3MAUE.js";
 
 // src/index.ts
 init_marvin();

package/dist/{marvin-BjJXe-YT.d.ts → marvin-CdsjwIyH.d.ts}

@@ -1,5 +1,5 @@
 import { s as PublishedEntryType, n as MarvinResource, M as MarvinAsset, h as MarvinCollection, a as CollectionEntry, j as MarvinEntry, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, p as PublishedCollectionSummary, e as ExpandOptions, L as ListEntry, o as MarvinSite, g as GetResourcesOptions$1 } from './index-BEEbnrXV.js';
-import { H as HttpClient } from './HttpClient-B_rEmJuO.js';
+import { H as HttpClient, a as BinaryResponse } from './HttpClient-DXMNOPqu.js';
 
 /**
  * Marvin SDK Configuration
@@ -274,6 +274,11 @@ declare class AssetsModule {
      * Get a single published asset by slug or ID
      */
     get(slugOrId: string): Promise<MarvinAsset>;
+    /**
+     * Download a published asset's file by slug: its bytes and content type. The file route
+     * redirects to storage; the redirect is followed. Needs the `read:assets` permission.
+     */
+    download(slug: string): Promise<BinaryResponse>;
     /**
      * Convenience: Get all images
      */
@@ -409,6 +414,12 @@ declare class CollectionsModule {
 interface GetEntriesOptions {
     entryType?: string;
     collection?: string;
+    /** Only entries carrying any of these tag slugs. */
+    tag?: string | string[];
+    /** Only entries with these slugs. */
+    slug?: string | string[];
+    /** Only entries updated at or after this time (ISO 8601, or a Date). */
+    updatedSince?: string | Date;
     limit?: number;
     offset?: number;
     status?: string;

package/dist/{marvin-BiXcixLB.d.cts → marvin-gZtGa576.d.cts}

@@ -1,5 +1,5 @@
 import { s as PublishedEntryType, n as MarvinResource, M as MarvinAsset, h as MarvinCollection, a as CollectionEntry, j as MarvinEntry, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, p as PublishedCollectionSummary, e as ExpandOptions, L as ListEntry, o as MarvinSite, g as GetResourcesOptions$1 } from './index-BEEbnrXV.cjs';
-import { H as HttpClient } from './HttpClient-B_rEmJuO.cjs';
+import { H as HttpClient, a as BinaryResponse } from './HttpClient-DXMNOPqu.cjs';
 
 /**
  * Marvin SDK Configuration
@@ -274,6 +274,11 @@ declare class AssetsModule {
      * Get a single published asset by slug or ID
      */
     get(slugOrId: string): Promise<MarvinAsset>;
+    /**
+     * Download a published asset's file by slug: its bytes and content type. The file route
+     * redirects to storage; the redirect is followed. Needs the `read:assets` permission.
+     */
+    download(slug: string): Promise<BinaryResponse>;
     /**
      * Convenience: Get all images
      */
@@ -409,6 +414,12 @@ declare class CollectionsModule {
 interface GetEntriesOptions {
     entryType?: string;
     collection?: string;
+    /** Only entries carrying any of these tag slugs. */
+    tag?: string | string[];
+    /** Only entries with these slugs. */
+    slug?: string | string[];
+    /** Only entries updated at or after this time (ISO 8601, or a Date). */
+    updatedSince?: string | Date;
     limit?: number;
     offset?: number;
     status?: string;

package/dist/platform.cjs

@@ -39,6 +39,7 @@ __export(platform_exports, {
   AssetsModule: () => AssetsModule,
   AuthModule: () => AuthModule,
   AutomationsModule: () => AutomationsModule,
+  BlueprintsModule: () => BlueprintsModule,
   CollectionsModule: () => CollectionsModule,
   EmailEventSubscriptionsModule: () => EmailEventSubscriptionsModule,
   EmailTemplatesClient: () => EmailTemplatesClient,
@@ -403,6 +404,9 @@ var HttpClient = class _HttpClient {
         errorText
       );
     }
+    if (options?.responseType === "binary") {
+      return await this.readBinary(response, method, endpoint);
+    }
     const data = await this.readBody(response, method, endpoint);
     if (this.debug && data !== void 0) {
       const sanitized = this.sanitizeForLogging(data);
@@ -448,12 +452,34 @@ var HttpClient = class _HttpClient {
       );
     }
   }
+  /** A successful response's bytes; a 204/205 is an empty array. A failed read is a network error. */
+  async readBinary(response, method, endpoint) {
+    const contentType = response.headers.get("content-type");
+    if (response.status === 204 || response.status === 205) {
+      return { data: new Uint8Array(0), contentType };
+    }
+    try {
+      return { data: new Uint8Array(await response.arrayBuffer()), contentType };
+    } catch (error) {
+      const cause = error instanceof Error ? error : void 0;
+      throw new MarvinNetworkError(
+        `Reading the ${response.status} response to ${method} ${endpoint} failed: ${cause?.message ?? String(error)}`,
+        cause
+      );
+    }
+  }
   /**
    * GET request
    */
   async get(endpoint, params) {
     return this.request("GET", endpoint, { params });
   }
+  /**
+   * GET a binary body (a file download). Follows redirects; retried like any GET.
+   */
+  async getBinary(endpoint, params) {
+    return this.request("GET", endpoint, { params, responseType: "binary" });
+  }
   /**
    * POST request
    */
@@ -534,6 +560,12 @@ var EntriesModule = class {
   async list() {
     return this.http.get("/api/platform/entries");
   }
+  /**
+   * Entry counts by status, zero-filled, plus `total` (what the sidebar's inbox badge reads).
+   */
+  async counts() {
+    return this.http.get("/api/platform/entries/counts");
+  }
   /**
    * Get a single entry by ID
    */
@@ -587,6 +619,38 @@ var EntriesModule = class {
     const validCollectionId = this.http.validatePathParam(collectionId, "collection ID");
     return this.http.delete(`/api/platform/entries/${validEntryId}/collections/${validCollectionId}`);
   }
+  /**
+   * Apply the entry's staged AI suggestion (`suggestionJson`) and clear it — the approval half of
+   * AI write-back. Returns the updated entry.
+   */
+  async applySuggestion(id) {
+    const validId = this.http.validatePathParam(id, "entry ID");
+    return this.http.post(`/api/platform/entries/${validId}/apply-suggestion`, {});
+  }
+  /**
+   * Discard the entry's staged AI suggestion without applying it.
+   */
+  async rejectSuggestion(id) {
+    const validId = this.http.validatePathParam(id, "entry ID");
+    return this.http.post(`/api/platform/entries/${validId}/reject-suggestion`, {});
+  }
+  /**
+   * Approve an AI-suggested asset on an entry: it becomes a normal attached asset (and reaches
+   * published output).
+   */
+  async approveSuggestedAsset(entryId, assetId) {
+    const e = this.http.validatePathParam(entryId, "entry ID");
+    const a = this.http.validatePathParam(assetId, "asset ID");
+    return this.http.post(`/api/platform/entries/${e}/suggested-assets/${a}/approve`, {});
+  }
+  /**
+   * Reject an AI-suggested asset: unlink it, and delete the asset if nothing else uses it.
+   */
+  async rejectSuggestedAsset(entryId, assetId) {
+    const e = this.http.validatePathParam(entryId, "entry ID");
+    const a = this.http.validatePathParam(assetId, "asset ID");
+    return this.http.post(`/api/platform/entries/${e}/suggested-assets/${a}/reject`, {});
+  }
 };
 
 // src/platform/collections.ts
@@ -627,6 +691,22 @@ var CollectionsModule = class {
       smartRules: rules
     });
   }
+  /**
+   * Preview unsaved smart-collection rules: how many items they match (`total`) and the first
+   * `limit` of them (default 10, at most 50), evaluated by the same code that materializes
+   * membership on save. Saves nothing. Needs EDITOR.
+   */
+  async preview(request) {
+    return this.http.post("/api/platform/collections/preview", request);
+  }
+  /**
+   * A collection's members, whatever it groups — entries, assets or resources — as
+   * `{id, label, slug, type}`, ordered by label.
+   */
+  async members(id) {
+    const validId = this.http.validatePathParam(id, "collection ID");
+    return this.http.get(`/api/platform/collections/${validId}/members`);
+  }
   /**
    * Update a collection
    */
@@ -800,6 +880,20 @@ var ResourcesModule = class {
   async getEntries(id) {
     return this.http.get(`/api/platform/resources/${id}/entries`);
   }
+  /**
+   * Apply the resource's staged AI suggestion (`suggestionJson`) and clear it. Needs EDITOR.
+   */
+  async applySuggestion(id) {
+    const validId = this.http.validatePathParam(id, "resource ID");
+    return this.http.post(`/api/platform/resources/${validId}/apply-suggestion`, {});
+  }
+  /**
+   * Discard the resource's staged AI suggestion without applying it. Needs EDITOR.
+   */
+  async rejectSuggestion(id) {
+    const validId = this.http.validatePathParam(id, "resource ID");
+    return this.http.post(`/api/platform/resources/${validId}/reject-suggestion`, {});
+  }
 };
 
 // src/platform/assets.ts
@@ -914,11 +1008,19 @@ var AssetsModule = class {
     return this.http.delete(`/api/platform/assets/${validId}`);
   }
   /**
-   * Fetch the raw file for an asset
+   * Download an asset's file: its bytes and content type. A redirect to storage is followed.
    */
-  async getFile(id) {
+  async download(id) {
     const validId = this.http.validatePathParam(id, "asset ID");
-    return this.http.get(`/api/platform/assets/${validId}/file`);
+    return this.http.getBinary(`/api/platform/assets/${validId}/file`);
+  }
+  /**
+   * Fetch the raw file for an asset.
+   * @deprecated Use {@link download}, which is typed. (Before 4.3 this resolved to `undefined` for
+   * any file that wasn't JSON; it now returns the same `BinaryResponse` as `download`.)
+   */
+  async getFile(id) {
+    return this.download(id);
   }
   /**
    * Get download URL for an asset file
@@ -929,6 +1031,20 @@ var AssetsModule = class {
     const base = baseUrl || (typeof window !== "undefined" && window.location ? window.location.origin : "");
     return `${base}/api/platform/assets/${validId}/file`;
   }
+  /**
+   * Apply the asset's staged AI suggestion (`suggestionJson`) and clear it. Needs EDITOR.
+   */
+  async applySuggestion(id) {
+    const validId = this.http.validatePathParam(id, "asset ID");
+    return this.http.post(`/api/platform/assets/${validId}/apply-suggestion`, {});
+  }
+  /**
+   * Discard the asset's staged AI suggestion without applying it. Needs EDITOR.
+   */
+  async rejectSuggestion(id) {
+    const validId = this.http.validatePathParam(id, "asset ID");
+    return this.http.post(`/api/platform/assets/${validId}/reject-suggestion`, {});
+  }
 };
 
 // src/platform/apiClients.ts
@@ -1179,6 +1295,13 @@ var WorkspacesModule = class {
   async getStats() {
     return this.http.get("/api/platform/stats");
   }
+  /**
+   * The current workspace's dashboard: recent activity and the "needs attention" counts (inbox,
+   * drafts, entries needing review, pending AI suggestions, failures in the last 7 days).
+   */
+  async getDashboard() {
+    return this.http.get("/api/platform/stats/dashboard");
+  }
   /**
    * List available workspace backups
    */
@@ -2875,6 +2998,10 @@ var IncomingWebhooksModule = class {
   async list() {
     return this.http.get("/api/incoming-webhooks");
   }
+  /** The signature schemes a webhook can pick (`signatureScheme`). */
+  async signatureSchemes() {
+    return this.http.get("/api/incoming-webhooks/signature-schemes");
+  }
   async get(id) {
     const validId = this.http.validatePathParam(id, "incoming webhook id");
     return this.http.get(`/api/incoming-webhooks/${validId}`);
@@ -2903,6 +3030,59 @@ var IncomingWebhooksModule = class {
   }
 };
 
+// src/platform/blueprints.ts
+var BASE2 = "/api/groups/blueprints";
+var BlueprintsModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  query(options = {}) {
+    return this.http.buildQueryString({ source: options.source, integration_id: options.integrationId });
+  }
+  /** The catalog, annotated with what this workspace can do about each blueprint. */
+  async list(options = {}) {
+    return this.http.get(BASE2, {
+      kind: options.kind,
+      category: options.category,
+      source: options.source,
+      integration_id: options.integrationId
+    });
+  }
+  /** Category names in catalog order: core's first, then each provider's. */
+  async categories() {
+    return this.http.get(`${BASE2}/categories`);
+  }
+  /** One blueprint, including its payload. */
+  async get(slug, options = {}) {
+    const validSlug = this.http.validatePathParam(slug, "blueprint slug");
+    return this.http.get(`${BASE2}/${validSlug}`, { source: options.source });
+  }
+  /**
+   * Create this blueprint's object in the workspace if it isn't there yet. `params` fills the
+   * parameters the blueprint declares, e.g. `{ entry_type: 'post' }`. Needs ADMIN.
+   */
+  async apply(slug, params, options = {}) {
+    const validSlug = this.http.validatePathParam(slug, "blueprint slug");
+    return this.http.post(`${BASE2}/${validSlug}/apply${this.query(options)}`, params);
+  }
+  /**
+   * Apply several blueprints at once; entry types are created before the collections and tasks that
+   * use them, whatever the order here. `params` is keyed by blueprint slug. Needs ADMIN.
+   */
+  async applyMany(slugs, params, options = {}) {
+    return this.http.post(`${BASE2}/apply${this.query(options)}`, {
+      slugs,
+      ...params ? { params } : {}
+    });
+  }
+  /** Replace an applied workflow's steps with what its integration declares now. Needs ADMIN. */
+  async update(slug, params, options = {}) {
+    const validSlug = this.http.validatePathParam(slug, "blueprint slug");
+    return this.http.post(`${BASE2}/${validSlug}/update${this.query(options)}`, params);
+  }
+};
+
 // src/platform/site.ts
 var REBUILD = "/api/platform/site/rebuild";
 var SiteModule = class {
@@ -2969,6 +3149,8 @@ var PlatformClient = class extends HttpClient {
   automations;
   // Incoming (ingress) webhooks — tokened endpoints that drop events on the bus.
   incomingWebhooks;
+  /** Blueprint catalog: browse and apply collections, entry types, tasks and workflows */
+  blueprints;
   // Site — request a rebuild of the workspace's static site and read its status.
   site;
   // Admin modules
@@ -3013,6 +3195,7 @@ var PlatformClient = class extends HttpClient {
     this.ai = new AIModule(this);
     this.automations = new AutomationsModule(this);
     this.incomingWebhooks = new IncomingWebhooksModule(this);
+    this.blueprints = new BlueprintsModule(this);
     this.site = new SiteModule(this);
     this.adminUsers = new AdminUsersModule(this);
     this.adminSystem = new AdminSystemModule(this);
@@ -3048,6 +3231,7 @@ function createPlatformClient(config) {
   AssetsModule,
   AuthModule,
   AutomationsModule,
+  BlueprintsModule,
   CollectionsModule,
   EmailEventSubscriptionsModule,
   EmailTemplatesClient,