@inneropen/marvin-sdk 4.2.0 → 4.4.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-BEEbnrXV.d.cts → index-7sv2m2Pe.d.cts}

@@ -700,6 +700,167 @@ interface components {
             /** Buildid */
             buildId: string;
         };
+        /**
+         * AdminEventConnections
+         * @description A platform event type's story across the platform: what sends it, what happens (built in, plus each
+         *     workspace's own subscriptions, grouped by workspace), and its newest events in any workspace.
+         */
+        AdminEventConnections: {
+            /** Eventtype */
+            eventType: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description: string;
+            /** Category */
+            category: string;
+            /** Senders */
+            senders: components["schemas"]["EventSender"][];
+            /** Reactions */
+            reactions: components["schemas"]["EventReaction"][];
+            /** Workspaces */
+            workspaces: components["schemas"]["WorkspaceEventReactions"][];
+            /** Recent */
+            recent: components["schemas"]["AdminEventSummary"][];
+            /** Leadsto */
+            leadsTo: components["schemas"]["EventTypeRef"][];
+            /** Causedby */
+            causedBy: components["schemas"]["EventTypeRef"][];
+        };
+        /**
+         * AdminEventPagination
+         * @description One page of platform events, newest first.
+         */
+        AdminEventPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["AdminEventSummary"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * AdminEventRead
+         * @description A platform event with its full payload.
+         */
+        AdminEventRead: {
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /** Eventname */
+            eventName: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+            /** Workspaceid */
+            workspaceId?: string | null;
+            /** Workspacename */
+            workspaceName?: string | null;
+            /** Workspaceslug */
+            workspaceSlug?: string | null;
+            /** Userid */
+            userId?: string | null;
+            /** Username */
+            userName?: string | null;
+            /** Useremail */
+            userEmail?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Integrationid */
+            integrationId: string;
+            /** Correlationid */
+            correlationId?: string | null;
+            /** Eventdata */
+            eventData: {
+                [key: string]: unknown;
+            };
+        };
+        /**
+         * AdminEventSummary
+         * @description A platform event as the admin Events page lists it, with the names a super admin needs to read it.
+         */
+        AdminEventSummary: {
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /** Eventname */
+            eventName: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+            /** Workspaceid */
+            workspaceId?: string | null;
+            /** Workspacename */
+            workspaceName?: string | null;
+            /** Workspaceslug */
+            workspaceSlug?: string | null;
+            /** Userid */
+            userId?: string | null;
+            /** Username */
+            userName?: string | null;
+            /** Useremail */
+            userEmail?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+        };
+        /**
+         * AdminEventType
+         * @description A platform-scope event type, for the Events page's filter.
+         */
+        AdminEventType: {
+            /** Eventtype */
+            eventType: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description: string;
+            /** Category */
+            category: string;
+        };
         /** AgentCreate */
         AgentCreate: {
             /** Name */
@@ -1389,6 +1550,47 @@ interface components {
              */
             failures: number;
         };
+        /**
+         * AuditEventSetting
+         * @description One catalog event type and whether this workspace's Event Log records it.
+         */
+        AuditEventSetting: {
+            /** Eventtype */
+            eventType: string;
+            /** Name */
+            name: string;
+            /** Category */
+            category: string;
+            /** Defaultaudited */
+            defaultAudited: boolean;
+            /** Audited */
+            audited: boolean;
+            /** Locked */
+            locked: boolean;
+        };
+        /**
+         * AuditExcludedEvent
+         * @description An event type this workspace's Event Log does not record.
+         */
+        AuditExcludedEvent: {
+            /** Eventtype */
+            eventType: string;
+            /** Name */
+            name: string;
+            /** Category */
+            category: string;
+        };
+        /**
+         * AuditSettingsUpdate
+         * @description Overrides to merge: `{event_type: true | false}` to record or skip a type, `null` for its default.
+         *     Types left out keep their current setting.
+         */
+        AuditSettingsUpdate: {
+            /** Overrides */
+            overrides?: {
+                [key: string]: boolean | null;
+            };
+        };
         /**
          * AuthMethod
          * @description Enumeration for the authentication methods a user can be associated with.
@@ -1696,6 +1898,11 @@ interface components {
             triggerGroups: {
                 [key: string]: string[];
             };
+            /**
+             * Emittable
+             * @default []
+             */
+            emittable: string[];
             /**
              * Conditionops
              * @default []
@@ -1834,6 +2041,10 @@ interface components {
             };
             /** Createdby */
             createdBy?: string | null;
+            /** Sourceintegrationid */
+            sourceIntegrationId?: string | null;
+            /** Sourceblueprint */
+            sourceBlueprint?: string | null;
         };
         /**
          * AutomationTargetOption
@@ -2498,6 +2709,10 @@ interface components {
             metadataJson?: {
                 [key: string]: unknown;
             } | null;
+            /** Sourceintegrationid */
+            sourceIntegrationId?: string | null;
+            /** Sourceblueprint */
+            sourceBlueprint?: string | null;
         };
         /**
          * CollectionUpdate
@@ -3418,6 +3633,50 @@ interface components {
             /** Tag Ids */
             tag_ids?: string[] | null;
         };
+        /**
+         * EventConnectionCounts
+         * @description One row of the Events catalog: how connected an event type is, in both directions.
+         */
+        EventConnectionCounts: {
+            /** Eventtype */
+            eventType: string;
+            /** Senders */
+            senders: number;
+            /** Reactions */
+            reactions: number;
+            /** Activereactions */
+            activeReactions: number;
+            /** Builtinreactions */
+            builtinReactions: number;
+            /** Lastoccurredat */
+            lastOccurredAt?: string | null;
+        };
+        /**
+         * EventConnections
+         * @description An event type's whole story in one workspace: what sends it, what happens, and when it last did.
+         */
+        EventConnections: {
+            /** Eventtype */
+            eventType: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description: string;
+            /** Category */
+            category: string;
+            /** Senders */
+            senders: components["schemas"]["EventSender"][];
+            /** Reactions */
+            reactions: components["schemas"]["EventReaction"][];
+            /** Audited */
+            audited: boolean;
+            /** Recent */
+            recent: components["schemas"]["EventLogSummary"][];
+            /** Leadsto */
+            leadsTo: components["schemas"]["EventTypeRef"][];
+            /** Causedby */
+            causedBy: components["schemas"]["EventTypeRef"][];
+        };
         /**
          * EventFeed
          * @description Events since a cursor, oldest first, plus the server's clock to poll from next.
@@ -3596,6 +3855,63 @@ interface components {
             /** Relatedentitylabel */
             relatedEntityLabel?: string | null;
         };
+        /**
+         * EventReaction
+         * @description One thing that runs when the event happens.
+         */
+        EventReaction: {
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: "workflow" | "integration_action" | "email" | "webhook" | "builtin";
+            /** Id */
+            id?: string | null;
+            /** Name */
+            name: string;
+            /** Enabled */
+            enabled: boolean;
+            /** Detail */
+            detail?: string | null;
+            /** Triggertype */
+            triggerType?: string | null;
+            /** Managedat */
+            managedAt?: string | null;
+            installedBy?: components["schemas"]["InstalledBy"] | null;
+        };
+        /**
+         * EventSender
+         * @description One thing that sends the event: Marvin itself (a line from the catalog) or a row in this workspace.
+         */
+        EventSender: {
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: "marvin" | "workflow" | "incoming_webhook" | "scheduled_task";
+            /** Id */
+            id?: string | null;
+            /** Name */
+            name: string;
+            /** Enabled */
+            enabled: boolean;
+            /** Detail */
+            detail?: string | null;
+            /** Viaworkflowid */
+            viaWorkflowId?: string | null;
+            /** Viaworkflowname */
+            viaWorkflowName?: string | null;
+            /** Managedat */
+            managedAt?: string | null;
+            installedBy?: components["schemas"]["InstalledBy"] | null;
+        };
+        /** EventTypeRef */
+        EventTypeRef: {
+            /** Eventtype */
+            eventType: string;
+            /** Name */
+            name: string;
+        };
         /**
          * ForgotPassword
          * @description Schema for the "forgot password" request.
@@ -4127,6 +4443,10 @@ interface components {
             receivedCount: number;
             /** Lastreceivedat */
             lastReceivedAt?: string | null;
+            /** Sourceintegrationid */
+            sourceIntegrationId?: string | null;
+            /** Sourceblueprint */
+            sourceBlueprint?: string | null;
         };
         /** IncomingWebhookUpdate */
         IncomingWebhookUpdate: {
@@ -4149,6 +4469,23 @@ interface components {
                 [key: string]: unknown;
             } | null;
         };
+        /**
+         * InstalledBy
+         * @description The integration whose blueprint created a workflow, task, incoming webhook or integration action.
+         */
+        InstalledBy: {
+            /**
+             * Integrationid
+             * Format: uuid4
+             */
+            integrationId: string;
+            /** Name */
+            name: string;
+            /** Provider */
+            provider: string;
+            /** Blueprint */
+            blueprint?: string | null;
+        };
         /**
          * InstalledModels
          * @description The models actually present in the workspace's active provider (e.g. Ollama's /api/tags).
@@ -4359,6 +4696,10 @@ interface components {
             } | null;
             /** Enabled */
             enabled: boolean;
+            /** Sourceintegrationid */
+            sourceIntegrationId?: string | null;
+            /** Sourceblueprint */
+            sourceBlueprint?: string | null;
         };
         /** IntegrationEventSubscriptionUpdate */
         IntegrationEventSubscriptionUpdate: {
@@ -6070,6 +6411,10 @@ interface components {
             } | null;
             /** Lastdurationms */
             lastDurationMs?: number | null;
+            /** Sourceintegrationid */
+            sourceIntegrationId?: string | null;
+            /** Sourceblueprint */
+            sourceBlueprint?: string | null;
         };
         /**
          * ScheduledTaskUpdate
@@ -7490,6 +7835,20 @@ interface components {
             /** Workspace */
             workspace: string;
         };
+        /** WorkspaceEventReactions */
+        WorkspaceEventReactions: {
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Workspacename */
+            workspaceName?: string | null;
+            /** Workspaceslug */
+            workspaceSlug?: string | null;
+            /** Reactions */
+            reactions: components["schemas"]["EventReaction"][];
+        };
         /**
          * WorkspaceInfo
          * @description Public workspace information for publishing API.