@inneropen/marvin-sdk 4.1.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-VS6R3V3K.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 = {};
@@ -135,6 +135,12 @@ var init_config = __esm({
 });
 
 // src/entries/entry.ts
+function isFullEntryData(raw) {
+  if (!raw || typeof raw !== "object") return false;
+  const record = raw;
+  if ("assetSlugs" in record || "resourceSlugs" in record) return false;
+  return Array.isArray(record.assets) || Array.isArray(record.resources);
+}
 var Entry;
 var init_entry = __esm({
   "src/entries/entry.ts"() {
@@ -314,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 {
@@ -337,19 +348,24 @@ var init_entries = __esm({
       }
       http;
       workspaceSlug;
-      /**
-       * Get all published entries
-       */
       async list(options = {}) {
         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
+          offset: options.offset,
+          expand: options.expand
         });
         const endpoint = `/api/publish/${this.workspaceSlug}/entries${queryString}`;
         const response = await this.http.fetch(endpoint);
-        return (response.data || []).map(toListEntry);
+        const data = response.data || [];
+        if (options.expand === "full" && data.every(isFullEntryData)) {
+          return data.map((entry) => new Entry(entry));
+        }
+        return data.map(toListEntry);
       }
       /**
        * Get a single entry by slug
@@ -395,6 +411,7 @@ var init_collections = __esm({
   "src/collections/collections.ts"() {
     "use strict";
     init_collection();
+    init_entry();
     init_errors();
     CollectionsModule = class {
       constructor(http, workspaceSlug) {
@@ -427,18 +444,25 @@ var init_collections = __esm({
           throw error;
         }
       }
-      /**
-       * Get entries in a collection with junction context surfaced directly.
-       * Each entry has role/position/junctionMetadata from this collection's junction,
-       * and collections reduced to slugs of other memberships.
-       * Returns empty array if collection is not found.
-       */
-      async entries(slug) {
-        const collection = await this.get(slug);
-        if (Array.isArray(collection)) {
-          return collection;
+      async entries(slug, options = {}) {
+        if (options.expand !== "full") {
+          const collection = await this.get(slug);
+          return Array.isArray(collection) ? collection : collection.entries;
+        }
+        let data;
+        try {
+          data = await this.http.fetch(
+            `/api/publish/${this.workspaceSlug}/collections/${slug}?expand=full`
+          );
+        } catch (error) {
+          if (error instanceof MarvinNotFoundError) return [];
+          throw error;
         }
-        return collection.entries;
+        const entries = data.entries ?? [];
+        if (entries.every(isFullEntryData)) {
+          return data.entries.map((entry) => new Entry(entry));
+        }
+        return new Collection(data).entries;
       }
       /**
        * Try multiple collection slugs in fallback order.
@@ -498,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
        */
@@ -888,6 +920,7 @@ export {
   createConfigFromEnv,
   config_exports,
   init_config,
+  isFullEntryData,
   Entry,
   init_entry,
   Collection,

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
        */