@inneropen/marvin-sdk 4.2.0 → 4.3.0

package/dist/platform.js

@@ -3,7 +3,7 @@ import {
   MarvinValidationError,
   SessionAuth,
   init_core
-} from "./chunk-DSVYCVQD.js";
+} from "./chunk-LTX3MAUE.js";
 
 // src/platform/client.ts
 init_core();
@@ -20,6 +20,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
    */
@@ -73,6 +79,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
@@ -113,6 +151,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
    */
@@ -286,6 +340,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
@@ -401,11 +469,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
@@ -416,6 +492,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
@@ -666,6 +756,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
    */
@@ -2364,6 +2461,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}`);
@@ -2392,6 +2493,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 {
@@ -2458,6 +2612,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
@@ -2502,6 +2658,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);
@@ -2536,6 +2693,7 @@ export {
   AssetsModule,
   AuthModule,
   AutomationsModule,
+  BlueprintsModule,
   CollectionsModule,
   EmailEventSubscriptionsModule,
   EmailTemplatesClient,

package/dist/publish.cjs

@@ -524,6 +524,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);
@@ -569,12 +572,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
    */
@@ -847,6 +872,11 @@ var Entry = class {
 };
 
 // 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 {
@@ -868,6 +898,9 @@ var EntriesModule = class {
     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
@@ -1080,6 +1113,14 @@ var AssetsModule = class {
     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/publish.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 { 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';
 export { e as ExpandOptions, G as GetAssetsOptions, f as GetEntriesOptions, g as GetResourcesOptions, 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 SiteConfiguration, W as WorkspaceInfo } from './index-BEEbnrXV.cjs';
-export { A as AuthStrategy, B as BearerTokenAuth, H as HttpClient, a as HttpClientConfig } from './HttpClient-B_rEmJuO.cjs';
+export { A as AuthStrategy, B as BearerTokenAuth, H as HttpClient, b as HttpClientConfig } from './HttpClient-DXMNOPqu.cjs';
 
 /**
  * Publishing API Entry Point

package/dist/publish.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 { 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';
 export { e as ExpandOptions, G as GetAssetsOptions, f as GetEntriesOptions, g as GetResourcesOptions, 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 SiteConfiguration, W as WorkspaceInfo } from './index-BEEbnrXV.js';
-export { A as AuthStrategy, B as BearerTokenAuth, H as HttpClient, a as HttpClientConfig } from './HttpClient-B_rEmJuO.js';
+export { A as AuthStrategy, B as BearerTokenAuth, H as HttpClient, b as HttpClientConfig } from './HttpClient-DXMNOPqu.js';
 
 /**
  * Publishing API Entry Point

package/dist/publish.js

@@ -13,7 +13,7 @@ import {
   init_resource,
   init_workspace,
   isFullEntryData
-} from "./chunk-HFNIFS2A.js";
+} from "./chunk-KXI2FQSO.js";
 import {
   BearerTokenAuth,
   HttpClient,
@@ -33,7 +33,7 @@ import {
   isPaginatedResponse,
   offsetToPage,
   pageToOffset
-} from "./chunk-DSVYCVQD.js";
+} from "./chunk-LTX3MAUE.js";
 
 // src/publish.ts
 init_marvin();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneropen/marvin-sdk",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Official TypeScript SDK for Marvin CMS",
   "type": "module",
   "main": "./dist/index.cjs",