@inneropen/marvin-sdk 4.1.0 → 4.2.0

package/dist/index.cjs

@@ -915,6 +915,12 @@ var init_http2 = __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"() {
@@ -1010,19 +1016,21 @@ 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,
           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
@@ -1134,6 +1142,7 @@ var init_collections = __esm({
   "src/collections/collections.ts"() {
     "use strict";
     init_collection();
+    init_entry();
     init_errors();
     CollectionsModule = class {
       constructor(http, workspaceSlug) {
@@ -1166,18 +1175,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;
+        }
+        const entries = data.entries ?? [];
+        if (entries.every(isFullEntryData)) {
+          return data.entries.map((entry) => new Entry(entry));
         }
-        return collection.entries;
+        return new Collection(data).entries;
       }
       /**
        * Try multiple collection slugs in fallback order.
@@ -1665,6 +1681,7 @@ __export(index_exports, {
   createMarvinClient: () => createMarvinClient,
   createPaginatedResponse: () => createPaginatedResponse,
   extractData: () => extractData,
+  isFullEntryData: () => isFullEntryData,
   isPaginatedResponse: () => isPaginatedResponse,
   offsetToPage: () => offsetToPage,
   pageToOffset: () => pageToOffset
@@ -1766,6 +1783,7 @@ function createMarvinClient(config) {
   createMarvinClient,
   createPaginatedResponse,
   extractData,
+  isFullEntryData,
   isPaginatedResponse,
   offsetToPage,
   pageToOffset

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { M as MarvinConfig, a as MarvinClient } from './marvin-6keK-yvS.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 isPaginatedResponse, q as offsetToPage, r as pageToOffset } from './marvin-6keK-yvS.cjs';
+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 { A as AuthToken$1 } from './index-CX4jvPAA.cjs';
-export { C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, G as GetAssetsOptions, e as GetEntriesOptions, f as GetResourcesOptions, L as ListEntry, M as MarvinAsset, g as MarvinCollection, h as MarvinEntry, i as MarvinEntryListItem, j as MarvinEntryType, k as MarvinPublishResponse, l as MarvinResource, m as MarvinSite, P as PublishedAssetRead, n as PublishedCollectionSummary, o as PublishedEntryAsset, p as PublishedEntryResource, q as PublishedEntryType, S as SiteConfiguration, W as WorkspaceInfo } from './index-CX4jvPAA.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';
 
 /**
  * Authentication & User Registration

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { M as MarvinConfig, a as MarvinClient } from './marvin-Cndwz82G.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 isPaginatedResponse, q as offsetToPage, r as pageToOffset } from './marvin-Cndwz82G.js';
+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 { A as AuthToken$1 } from './index-CX4jvPAA.js';
-export { C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, G as GetAssetsOptions, e as GetEntriesOptions, f as GetResourcesOptions, L as ListEntry, M as MarvinAsset, g as MarvinCollection, h as MarvinEntry, i as MarvinEntryListItem, j as MarvinEntryType, k as MarvinPublishResponse, l as MarvinResource, m as MarvinSite, P as PublishedAssetRead, n as PublishedCollectionSummary, o as PublishedEntryAsset, p as PublishedEntryResource, q as PublishedEntryType, S as SiteConfiguration, W as WorkspaceInfo } from './index-CX4jvPAA.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';
 
 /**
  * Authentication & User Registration

package/dist/index.js

@@ -12,8 +12,9 @@ import {
   init_marvin,
   init_resource,
   init_workspace,
+  isFullEntryData,
   marvin_exports
-} from "./chunk-VS6R3V3K.js";
+} from "./chunk-HFNIFS2A.js";
 import {
   BearerTokenAuth,
   HttpClient,
@@ -134,6 +135,7 @@ export {
   createMarvinClient,
   createPaginatedResponse,
   extractData,
+  isFullEntryData,
   isPaginatedResponse,
   offsetToPage,
   pageToOffset

package/dist/{marvin-6keK-yvS.d.cts → marvin-BiXcixLB.d.cts}

@@ -1,4 +1,4 @@
-import { q as PublishedEntryType, l as MarvinResource, M as MarvinAsset, g as MarvinCollection, a as CollectionEntry, n as PublishedCollectionSummary, h as MarvinEntry, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, L as ListEntry, m as MarvinSite, f as GetResourcesOptions$1 } from './index-CX4jvPAA.cjs';
+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';
 
 /**
@@ -316,42 +316,15 @@ declare class Collection {
 }
 
 /**
- * Collections Module - Manage collections
+ * Entry - Rich object representing a single entry
  */
 
-declare class CollectionsModule {
-    private http;
-    private workspaceSlug;
-    constructor(http: MarvinHttpClient, workspaceSlug: string);
-    /**
-     * Get all collections
-     */
-    list(): Promise<PublishedCollectionSummary[]>;
-    /**
-     * Get a single collection by slug.
-     * Returns an empty array if the collection is not found (404).
-     */
-    get(slug: string): Promise<Collection | []>;
-    /**
-     * 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.
-     */
-    entries(slug: string): Promise<CollectionEntry[]>;
-    /**
-     * Try multiple collection slugs in fallback order.
-     * Returns entries from the first collection that exists and has entries.
-     */
-    fallback(slugs: string[], options?: {
-        requireEntries?: boolean;
-    }): Promise<CollectionEntry[]>;
-}
-
 /**
- * Entry - Rich object representing a single entry
+ * True for a full entry as the API sends it (`PublishedEntryRead`): `assets[]` placements and no
+ * `assetSlugs`/`resourceSlugs`. A list item (`PublishedEntryListItem`) has only the slugs. Lets an
+ * `expand: 'full'` read tell an expanded response from an older server's list items.
  */
-
+declare function isFullEntryData(raw: unknown): raw is MarvinEntry;
 declare class Entry {
     private raw;
     constructor(raw: MarvinEntry);
@@ -389,6 +362,46 @@ declare class Entry {
     toJSON(): MarvinEntry;
 }
 
+/**
+ * Collections Module - Manage collections
+ */
+
+declare class CollectionsModule {
+    private http;
+    private workspaceSlug;
+    constructor(http: MarvinHttpClient, workspaceSlug: string);
+    /**
+     * Get all collections
+     */
+    list(): Promise<PublishedCollectionSummary[]>;
+    /**
+     * Get a single collection by slug.
+     * Returns an empty array if the collection is not found (404).
+     */
+    get(slug: string): Promise<Collection | []>;
+    /**
+     * 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.
+     *
+     * With `{ expand: 'full' }` the whole collection comes back as full entries in one request:
+     * `Entry` objects, the same as `entry(slug)` returns, each with its `order` in this collection
+     * and every membership under `collections`. A server without `expand` support (or a collection
+     * past the server's expand cap) returns list items instead; those come back as
+     * `CollectionEntry[]`, exactly as without the option, so check with `instanceof Entry`.
+     */
+    entries(slug: string): Promise<CollectionEntry[]>;
+    entries(slug: string, options?: ExpandOptions): Promise<Entry[] | CollectionEntry[]>;
+    /**
+     * Try multiple collection slugs in fallback order.
+     * Returns entries from the first collection that exists and has entries.
+     */
+    fallback(slugs: string[], options?: {
+        requireEntries?: boolean;
+    }): Promise<CollectionEntry[]>;
+}
+
 /**
  * Entries Module - Manage entries
  */
@@ -406,8 +419,13 @@ declare class EntriesModule {
     constructor(http: MarvinHttpClient, workspaceSlug: string);
     /**
      * Get all published entries
+     *
+     * With `{ expand: 'full' }` each entry on the page comes back as a full `Entry` (the
+     * single-entry read), so no per-entry reads are needed. A server without `expand` support
+     * returns list items instead; those come back as `ListEntry[]`, as without the option.
      */
     list(options?: GetEntriesOptions): Promise<ListEntry[]>;
+    list(options: GetEntriesOptions & ExpandOptions): Promise<Entry[] | ListEntry[]>;
     /**
      * Get a single entry by slug
      * Returns null if entry is not found (404)
@@ -580,4 +598,4 @@ declare class MarvinClient {
     getResourceEntries(slug: string): Promise<string[]>;
 }
 
-export { Collection as C, Entry as E, type MarvinConfig as M, type PaginatedResponse as P, Resource as R, Workspace as W, MarvinClient as a, MarvinApiError as b, MarvinAuthError as c, MarvinCache as d, MarvinConfigError as e, MarvinError as f, MarvinNetworkError as g, MarvinNotFoundError as h, MarvinServerError as i, MarvinValidationError as j, type PaginationMeta as k, type PaginationParams as l, createConfigFromEnv as m, createPaginatedResponse as n, extractData as o, isPaginatedResponse as p, offsetToPage as q, pageToOffset as r };
+export { Collection as C, Entry as E, type MarvinConfig as M, type PaginatedResponse as P, Resource as R, Workspace as W, MarvinClient as a, MarvinApiError as b, MarvinAuthError as c, MarvinCache as d, MarvinConfigError as e, MarvinError as f, MarvinNetworkError as g, MarvinNotFoundError as h, MarvinServerError as i, MarvinValidationError as j, type PaginationMeta as k, type PaginationParams as l, createConfigFromEnv as m, createPaginatedResponse as n, extractData as o, isFullEntryData as p, isPaginatedResponse as q, offsetToPage as r, pageToOffset as s };

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

@@ -1,4 +1,4 @@
-import { q as PublishedEntryType, l as MarvinResource, M as MarvinAsset, g as MarvinCollection, a as CollectionEntry, n as PublishedCollectionSummary, h as MarvinEntry, E as EntryAsset, c as EntryCollectionContext, d as EntryResource, L as ListEntry, m as MarvinSite, f as GetResourcesOptions$1 } from './index-CX4jvPAA.js';
+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';
 
 /**
@@ -316,42 +316,15 @@ declare class Collection {
 }
 
 /**
- * Collections Module - Manage collections
+ * Entry - Rich object representing a single entry
  */
 
-declare class CollectionsModule {
-    private http;
-    private workspaceSlug;
-    constructor(http: MarvinHttpClient, workspaceSlug: string);
-    /**
-     * Get all collections
-     */
-    list(): Promise<PublishedCollectionSummary[]>;
-    /**
-     * Get a single collection by slug.
-     * Returns an empty array if the collection is not found (404).
-     */
-    get(slug: string): Promise<Collection | []>;
-    /**
-     * 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.
-     */
-    entries(slug: string): Promise<CollectionEntry[]>;
-    /**
-     * Try multiple collection slugs in fallback order.
-     * Returns entries from the first collection that exists and has entries.
-     */
-    fallback(slugs: string[], options?: {
-        requireEntries?: boolean;
-    }): Promise<CollectionEntry[]>;
-}
-
 /**
- * Entry - Rich object representing a single entry
+ * True for a full entry as the API sends it (`PublishedEntryRead`): `assets[]` placements and no
+ * `assetSlugs`/`resourceSlugs`. A list item (`PublishedEntryListItem`) has only the slugs. Lets an
+ * `expand: 'full'` read tell an expanded response from an older server's list items.
  */
-
+declare function isFullEntryData(raw: unknown): raw is MarvinEntry;
 declare class Entry {
     private raw;
     constructor(raw: MarvinEntry);
@@ -389,6 +362,46 @@ declare class Entry {
     toJSON(): MarvinEntry;
 }
 
+/**
+ * Collections Module - Manage collections
+ */
+
+declare class CollectionsModule {
+    private http;
+    private workspaceSlug;
+    constructor(http: MarvinHttpClient, workspaceSlug: string);
+    /**
+     * Get all collections
+     */
+    list(): Promise<PublishedCollectionSummary[]>;
+    /**
+     * Get a single collection by slug.
+     * Returns an empty array if the collection is not found (404).
+     */
+    get(slug: string): Promise<Collection | []>;
+    /**
+     * 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.
+     *
+     * With `{ expand: 'full' }` the whole collection comes back as full entries in one request:
+     * `Entry` objects, the same as `entry(slug)` returns, each with its `order` in this collection
+     * and every membership under `collections`. A server without `expand` support (or a collection
+     * past the server's expand cap) returns list items instead; those come back as
+     * `CollectionEntry[]`, exactly as without the option, so check with `instanceof Entry`.
+     */
+    entries(slug: string): Promise<CollectionEntry[]>;
+    entries(slug: string, options?: ExpandOptions): Promise<Entry[] | CollectionEntry[]>;
+    /**
+     * Try multiple collection slugs in fallback order.
+     * Returns entries from the first collection that exists and has entries.
+     */
+    fallback(slugs: string[], options?: {
+        requireEntries?: boolean;
+    }): Promise<CollectionEntry[]>;
+}
+
 /**
  * Entries Module - Manage entries
  */
@@ -406,8 +419,13 @@ declare class EntriesModule {
     constructor(http: MarvinHttpClient, workspaceSlug: string);
     /**
      * Get all published entries
+     *
+     * With `{ expand: 'full' }` each entry on the page comes back as a full `Entry` (the
+     * single-entry read), so no per-entry reads are needed. A server without `expand` support
+     * returns list items instead; those come back as `ListEntry[]`, as without the option.
      */
     list(options?: GetEntriesOptions): Promise<ListEntry[]>;
+    list(options: GetEntriesOptions & ExpandOptions): Promise<Entry[] | ListEntry[]>;
     /**
      * Get a single entry by slug
      * Returns null if entry is not found (404)
@@ -580,4 +598,4 @@ declare class MarvinClient {
     getResourceEntries(slug: string): Promise<string[]>;
 }
 
-export { Collection as C, Entry as E, type MarvinConfig as M, type PaginatedResponse as P, Resource as R, Workspace as W, MarvinClient as a, MarvinApiError as b, MarvinAuthError as c, MarvinCache as d, MarvinConfigError as e, MarvinError as f, MarvinNetworkError as g, MarvinNotFoundError as h, MarvinServerError as i, MarvinValidationError as j, type PaginationMeta as k, type PaginationParams as l, createConfigFromEnv as m, createPaginatedResponse as n, extractData as o, isPaginatedResponse as p, offsetToPage as q, pageToOffset as r };
+export { Collection as C, Entry as E, type MarvinConfig as M, type PaginatedResponse as P, Resource as R, Workspace as W, MarvinClient as a, MarvinApiError as b, MarvinAuthError as c, MarvinCache as d, MarvinConfigError as e, MarvinError as f, MarvinNetworkError as g, MarvinNotFoundError as h, MarvinServerError as i, MarvinValidationError as j, type PaginationMeta as k, type PaginationParams as l, createConfigFromEnv as m, createPaginatedResponse as n, extractData as o, isFullEntryData as p, isPaginatedResponse as q, offsetToPage as r, pageToOffset as s };

package/dist/platform.d.cts

@@ -1,5 +1,5 @@
 import { H as HttpClient } from './HttpClient-B_rEmJuO.cjs';
-import { r as components, A as AuthToken } from './index-CX4jvPAA.cjs';
+import { t as components, A as AuthToken } from './index-BEEbnrXV.cjs';
 
 /**
  * Platform API Types

package/dist/platform.d.ts

@@ -1,5 +1,5 @@
 import { H as HttpClient } from './HttpClient-B_rEmJuO.js';
-import { r as components, A as AuthToken } from './index-CX4jvPAA.js';
+import { t as components, A as AuthToken } from './index-BEEbnrXV.js';
 
 /**
  * Platform API Types

package/dist/publish.cjs

@@ -169,6 +169,7 @@ __export(publish_exports, {
   createMarvinClient: () => createMarvinClient,
   createPaginatedResponse: () => createPaginatedResponse,
   extractData: () => extractData,
+  isFullEntryData: () => isFullEntryData,
   isPaginatedResponse: () => isPaginatedResponse,
   offsetToPage: () => offsetToPage,
   pageToOffset: () => pageToOffset
@@ -774,6 +775,12 @@ var MarvinHttpClient = class extends HttpClient {
 };
 
 // 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 = class {
   constructor(raw) {
     this.raw = raw;
@@ -857,19 +864,21 @@ var EntriesModule = class {
   }
   http;
   workspaceSlug;
-  /**
-   * Get all published entries
-   */
   async list(options = {}) {
     const queryString = this.http.buildQueryString({
       entry_type: options.entryType,
       collection: options.collection,
       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
@@ -999,18 +1008,25 @@ var CollectionsModule = class {
       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;
+    }
+    const entries = data.entries ?? [];
+    if (entries.every(isFullEntryData)) {
+      return data.entries.map((entry) => new Entry(entry));
     }
-    return collection.entries;
+    return new Collection(data).entries;
   }
   /**
    * Try multiple collection slugs in fallback order.
@@ -1449,6 +1465,7 @@ function createMarvinClient(config) {
   createMarvinClient,
   createPaginatedResponse,
   extractData,
+  isFullEntryData,
   isPaginatedResponse,
   offsetToPage,
   pageToOffset

package/dist/publish.d.cts

@@ -1,6 +1,6 @@
-import { M as MarvinConfig, a as MarvinClient } from './marvin-6keK-yvS.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 isPaginatedResponse, q as offsetToPage, r as pageToOffset } from './marvin-6keK-yvS.cjs';
-export { G as GetAssetsOptions, e as GetEntriesOptions, f as GetResourcesOptions, M as MarvinAsset, g as MarvinCollection, h as MarvinEntry, i as MarvinEntryListItem, j as MarvinEntryType, k as MarvinPublishResponse, l as MarvinResource, m as MarvinSite, P as PublishedAssetRead, n as PublishedCollectionSummary, o as PublishedEntryAsset, p as PublishedEntryResource, S as SiteConfiguration, W as WorkspaceInfo } from './index-CX4jvPAA.cjs';
+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';
+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';
 
 /**

package/dist/publish.d.ts

@@ -1,6 +1,6 @@
-import { M as MarvinConfig, a as MarvinClient } from './marvin-Cndwz82G.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 isPaginatedResponse, q as offsetToPage, r as pageToOffset } from './marvin-Cndwz82G.js';
-export { G as GetAssetsOptions, e as GetEntriesOptions, f as GetResourcesOptions, M as MarvinAsset, g as MarvinCollection, h as MarvinEntry, i as MarvinEntryListItem, j as MarvinEntryType, k as MarvinPublishResponse, l as MarvinResource, m as MarvinSite, P as PublishedAssetRead, n as PublishedCollectionSummary, o as PublishedEntryAsset, p as PublishedEntryResource, S as SiteConfiguration, W as WorkspaceInfo } from './index-CX4jvPAA.js';
+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';
+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';
 
 /**

package/dist/publish.js

@@ -11,8 +11,9 @@ import {
   init_entry,
   init_marvin,
   init_resource,
-  init_workspace
-} from "./chunk-VS6R3V3K.js";
+  init_workspace,
+  isFullEntryData
+} from "./chunk-HFNIFS2A.js";
 import {
   BearerTokenAuth,
   HttpClient,
@@ -69,6 +70,7 @@ export {
   createMarvinClient,
   createPaginatedResponse,
   extractData,
+  isFullEntryData,
   isPaginatedResponse,
   offsetToPage,
   pageToOffset

package/dist/types/index.d.cts

@@ -1 +1 @@
-export { s as AssetAttachment, t as AssetUploadRequest, A as AuthToken, u as CollectionAttachment, C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, v as EntryCollectionRead, d as EntryResource, G as GetAssetsOptions, e as GetEntriesOptions, f as GetResourcesOptions, L as ListEntry, M as MarvinAsset, w as MarvinClientConfig, g as MarvinCollection, h as MarvinEntry, i as MarvinEntryListItem, j as MarvinEntryType, k as MarvinPublishResponse, l as MarvinResource, m as MarvinSite, P as PublishedAssetRead, n as PublishedCollectionSummary, o as PublishedEntryAsset, x as PublishedEntryCollection, p as PublishedEntryResource, q as PublishedEntryType, y as PublishedResourceSummary, R as ResourceAttachment, S as SiteConfiguration, z as SiteSeo, B as SiteSeoVerification, W as WorkspaceInfo } from '../index-CX4jvPAA.cjs';
+export { u as AssetAttachment, v as AssetUploadRequest, A as AuthToken, w as CollectionAttachment, C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, x as EntryCollectionRead, d as EntryResource, e as ExpandOptions, G as GetAssetsOptions, f as GetEntriesOptions, g as GetResourcesOptions, L as ListEntry, M as MarvinAsset, y as MarvinClientConfig, 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, z as PublishedEntryCollection, r as PublishedEntryResource, s as PublishedEntryType, B as PublishedResourceSummary, R as ResourceAttachment, S as SiteConfiguration, D as SiteSeo, F as SiteSeoVerification, W as WorkspaceInfo } from '../index-BEEbnrXV.cjs';

package/dist/types/index.d.ts

@@ -1 +1 @@
-export { s as AssetAttachment, t as AssetUploadRequest, A as AuthToken, u as CollectionAttachment, C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, v as EntryCollectionRead, d as EntryResource, G as GetAssetsOptions, e as GetEntriesOptions, f as GetResourcesOptions, L as ListEntry, M as MarvinAsset, w as MarvinClientConfig, g as MarvinCollection, h as MarvinEntry, i as MarvinEntryListItem, j as MarvinEntryType, k as MarvinPublishResponse, l as MarvinResource, m as MarvinSite, P as PublishedAssetRead, n as PublishedCollectionSummary, o as PublishedEntryAsset, x as PublishedEntryCollection, p as PublishedEntryResource, q as PublishedEntryType, y as PublishedResourceSummary, R as ResourceAttachment, S as SiteConfiguration, z as SiteSeo, B as SiteSeoVerification, W as WorkspaceInfo } from '../index-CX4jvPAA.js';
+export { u as AssetAttachment, v as AssetUploadRequest, A as AuthToken, w as CollectionAttachment, C as CollectionContext, a as CollectionEntry, b as CollectionEntryMetadata, E as EntryAsset, c as EntryCollectionContext, x as EntryCollectionRead, d as EntryResource, e as ExpandOptions, G as GetAssetsOptions, f as GetEntriesOptions, g as GetResourcesOptions, L as ListEntry, M as MarvinAsset, y as MarvinClientConfig, 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, z as PublishedEntryCollection, r as PublishedEntryResource, s as PublishedEntryType, B as PublishedResourceSummary, R as ResourceAttachment, S as SiteConfiguration, D as SiteSeo, F as SiteSeoVerification, W as WorkspaceInfo } from '../index-BEEbnrXV.js';

package/package.json

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