@proveanything/smartlinks 2.0.30 → 2.0.32

package/dist/api/appObjects.js

@@ -421,15 +421,30 @@ export var app;
  * Build a query string from an object of parameters
  */
 function buildQueryString(params) {
-    const entries = Object.entries(params).filter(([_, value]) => value !== undefined && value !== null);
-    if (entries.length === 0)
-        return '';
-    const queryString = entries
-        .map(([key, value]) => {
-        const encodedKey = encodeURIComponent(key);
-        const encodedValue = encodeURIComponent(String(value));
-        return `${encodedKey}=${encodedValue}`;
-    })
-        .join('&');
-    return `?${queryString}`;
+    const parts = [];
+    const add = (key, value) => {
+        if (value === undefined || value === null)
+            return;
+        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    };
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            add(key, value.join(',')); // unchanged: top-level arrays are sent comma-joined
+        }
+        else if (typeof value === 'object' && !(value instanceof Date)) {
+            // Nested filter objects (e.g. dataFilter: { versionId: 'x', zone: 'in:a,b' }) → dataFilter[versionId]=x
+            for (const [sub, subValue] of Object.entries(value)) {
+                if (Array.isArray(subValue))
+                    subValue.forEach((v) => add(`${key}[${sub}]`, v));
+                else
+                    add(`${key}[${sub}]`, subValue);
+            }
+        }
+        else {
+            add(key, value instanceof Date ? value.toISOString() : value);
+        }
+    }
+    return parts.length ? `?${parts.join('&')}` : '';
 }

package/dist/api/integrations.d.ts

@@ -1,4 +1,4 @@
-import type { IntegrationFlow, CreateFlowInput, UpdateFlowInput, ListFlowsQuery, FlowList, RunFlowInput, RunFlowResult, RunFlowSummary, RunFlowEnqueued, RecordTypesResponse } from "../types/integrations.js";
+import type { IntegrationFlow, CreateFlowInput, UpdateFlowInput, ListFlowsQuery, FlowList, RunFlowInput, RunFlowResult, RunFlowSummary, RunFlowEnqueued, RecordTypesResponse, FlowRun, ListRunsQuery, RunList, ListRunItemsQuery, RunItemList, LoggingWindow, SetLoggingInput } from "../types/integrations.js";
 export declare namespace integrations {
     /** List flows in a collection. GET /integrations/flows */
     function listFlows(collectionId: string, query?: ListFlowsQuery): Promise<FlowList>;
@@ -31,4 +31,30 @@ export declare namespace integrations {
     function isRunSummary(r: RunFlowResult): r is RunFlowSummary;
     /** Type guard: the run was enqueued (async). */
     function isRunEnqueued(r: RunFlowResult): r is RunFlowEnqueued;
+    /** List a flow's runs, newest first. GET /integrations/flows/:id/runs */
+    function listRuns(collectionId: string, flowId: string, query?: ListRunsQuery): Promise<RunList>;
+    /** Get one run's summary. GET /integrations/flows/:id/runs/:runId */
+    function getRun(collectionId: string, flowId: string, runId: string): Promise<FlowRun>;
+    /**
+     * List a run's per-record items. GET /integrations/flows/:id/runs/:runId/items
+     * `request`/`response` are populated only for items captured while enhanced logging
+     * was active (and before the 24h body purge).
+     */
+    function listRunItems(collectionId: string, flowId: string, runId: string, query?: ListRunItemsQuery): Promise<RunItemList>;
+    /** Every run touching an entity (e.g. a product), across flows. GET /integrations/runs/entity/:entityId */
+    function listEntityRuns(collectionId: string, entityId: string, query?: {
+        limit?: number;
+    }): Promise<RunList>;
+    /** Is enhanced logging active for a connection? GET /integrations/logging/:connectionId */
+    function getLogging(collectionId: string, connectionId: string): Promise<{
+        window: LoggingWindow | null;
+    }>;
+    /** Enable enhanced logging. POST /integrations/logging/:connectionId (omit ttlMinutes = until cancelled) */
+    function setLogging(collectionId: string, connectionId: string, input?: SetLoggingInput): Promise<{
+        window: LoggingWindow;
+    }>;
+    /** Cancel enhanced logging now. DELETE /integrations/logging/:connectionId */
+    function cancelLogging(collectionId: string, connectionId: string): Promise<{
+        canceled: boolean;
+    }>;
 }

package/dist/api/integrations.js

@@ -88,4 +88,51 @@ export var integrations;
         return r.enqueued === true;
     }
     integrations.isRunEnqueued = isRunEnqueued;
+    // --- Run logs -----------------------------------------------------------
+    // A run row is written for every execution (manual, event, scheduled, test). Per-record
+    // request/response detail is captured only while enhanced logging is active for the
+    // connection (see setLogging); otherwise runs carry metadata only.
+    /** List a flow's runs, newest first. GET /integrations/flows/:id/runs */
+    async function listRuns(collectionId, flowId, query = {}) {
+        return request(`${base(collectionId)}/${enc(flowId)}/runs${encodeQuery(query)}`);
+    }
+    integrations.listRuns = listRuns;
+    /** Get one run's summary. GET /integrations/flows/:id/runs/:runId */
+    async function getRun(collectionId, flowId, runId) {
+        return request(`${base(collectionId)}/${enc(flowId)}/runs/${enc(runId)}`);
+    }
+    integrations.getRun = getRun;
+    /**
+     * List a run's per-record items. GET /integrations/flows/:id/runs/:runId/items
+     * `request`/`response` are populated only for items captured while enhanced logging
+     * was active (and before the 24h body purge).
+     */
+    async function listRunItems(collectionId, flowId, runId, query = {}) {
+        return request(`${base(collectionId)}/${enc(flowId)}/runs/${enc(runId)}/items${encodeQuery(query)}`);
+    }
+    integrations.listRunItems = listRunItems;
+    /** Every run touching an entity (e.g. a product), across flows. GET /integrations/runs/entity/:entityId */
+    async function listEntityRuns(collectionId, entityId, query = {}) {
+        return request(`/admin/collection/${enc(collectionId)}/integrations/runs/entity/${enc(entityId)}${encodeQuery(query)}`);
+    }
+    integrations.listEntityRuns = listEntityRuns;
+    // --- Enhanced logging window (per connection) ---------------------------
+    // Full request/response capture is off by default. Turn it on for a connection while
+    // debugging; it applies to every flow on that connection and auto-expires (or runs until
+    // cancelled). Bodies are redacted at capture and purged after 24h.
+    /** Is enhanced logging active for a connection? GET /integrations/logging/:connectionId */
+    async function getLogging(collectionId, connectionId) {
+        return request(`/admin/collection/${enc(collectionId)}/integrations/logging/${enc(connectionId)}`);
+    }
+    integrations.getLogging = getLogging;
+    /** Enable enhanced logging. POST /integrations/logging/:connectionId (omit ttlMinutes = until cancelled) */
+    async function setLogging(collectionId, connectionId, input = {}) {
+        return post(`/admin/collection/${enc(collectionId)}/integrations/logging/${enc(connectionId)}`, input);
+    }
+    integrations.setLogging = setLogging;
+    /** Cancel enhanced logging now. DELETE /integrations/logging/:connectionId */
+    async function cancelLogging(collectionId, connectionId) {
+        return del(`/admin/collection/${enc(collectionId)}/integrations/logging/${enc(connectionId)}`);
+    }
+    integrations.cancelLogging = cancelLogging;
 })(integrations || (integrations = {}));

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.30  |  Generated: 2026-09-29T17:13:26.956Z
+Version: 2.0.32  |  Generated: 2026-10-01T17:18:44.658Z
 
 This is a concise summary of all available API functions and types.
 
@@ -6562,6 +6562,7 @@ interface FlowList {
 ```typescript
 interface RunFlowInput {
   entityId?: string
+  trigger?: RunTrigger
 }
 ```
 
@@ -6574,6 +6575,128 @@ interface RunFlowSummary {
   sent: number
   failed: number
   status: RunStatus
+  runId?: string
+}
+```
+
+**CapturedRequest** (interface)
+```typescript
+interface CapturedRequest {
+  transport: string
+  method: string
+  url: string
+  headers: Record<string, string>
+  partitionKey?: string
+  body: unknown
+  bodyBytes: number
+  truncated: boolean
+}
+```
+
+**CapturedResponse** (interface)
+```typescript
+interface CapturedResponse {
+  status: number | null
+  ok: boolean | null
+  headers: Record<string, string>
+  body: unknown
+  bodyBytes: number
+  truncated: boolean
+  error: string | null
+}
+```
+
+**FlowRun** (interface)
+```typescript
+interface FlowRun {
+  id: string
+  flowId: string
+  connectionId?: string | null
+  trigger: RunTrigger
+  triggerEvent?: string | null
+  triggerEntityId?: string | null
+  status: FlowRunStatus
+  records: number
+  sent: number
+  failed: number
+  error?: string | null
+  correlationId?: string | null
+  captureLevel: CaptureLevel
+  bodiesPurged: boolean
+  startedAt: string
+  completedAt?: string | null
+  durationMs?: number | null
+}
+```
+
+**FlowRunItem** (interface)
+```typescript
+interface FlowRunItem {
+  id: string
+  runId: string
+  entityType: string
+  entityId?: string | null
+  entityLabel?: string | null
+  status: FlowRunItemStatus
+  skipReason?: string | null
+  request?: CapturedRequest | null
+  response?: CapturedResponse | null
+  attempt: number
+  durationMs?: number | null
+  createdAt: string
+}
+```
+
+**ListRunsQuery** (interface)
+```typescript
+interface ListRunsQuery {
+  status?: FlowRunStatus
+  trigger?: RunTrigger
+  entityId?: string
+  limit?: number
+  cursor?: string
+}
+```
+
+**RunList** (interface)
+```typescript
+interface RunList {
+  runs: FlowRun[]; nextCursor?: string
+}
+```
+
+**ListRunItemsQuery** (interface)
+```typescript
+interface ListRunItemsQuery {
+  status?: FlowRunItemStatus; limit?: number; cursor?: string
+}
+```
+
+**RunItemList** (interface)
+```typescript
+interface RunItemList {
+  items: FlowRunItem[]; nextCursor?: string
+}
+```
+
+**LoggingWindow** (interface)
+```typescript
+interface LoggingWindow {
+  id: string
+  connectionId: string
+  level: CaptureLevel
+  enabledBy?: string | null
+  enabledAt: string
+  expiresAt?: string | null
+  canceledAt?: string | null
+}
+```
+
+**SetLoggingInput** (interface)
+```typescript
+interface SetLoggingInput {
+  ttlMinutes?: number
+  level?: 'full' | 'errors_only'
 }
 ```
 
@@ -6660,6 +6783,14 @@ interface RecordTypesResponse {
 
 **UpdateFlowInput** = `Partial<Omit<CreateFlowInput, 'direction'>> & {`
 
+**RunTrigger** = `'manual' | 'event' | 'schedule' | 'test'`
+
+**FlowRunStatus** = `'running' | 'success' | 'partial' | 'failed' | 'skipped'`
+
+**FlowRunItemStatus** = `'sent' | 'failed' | 'skipped'`
+
+**CaptureLevel** = `'metadata' | 'errors_only' | 'full'`
+
 **RunFlowResult** = `RunFlowSummary | RunFlowEnqueued`
 
 ### interaction
@@ -10850,6 +10981,27 @@ Type guard: the run executed inline and returned a summary.
 **isRunEnqueued**(r: RunFlowResult) → `r is RunFlowEnqueued`
 Type guard: the run was enqueued (async).
 
+**listRuns**(collectionId: string, flowId: string, query: ListRunsQuery = {}) → `Promise<RunList>`
+List a flow's runs, newest first. GET /integrations/flows/:id/runs
+
+**getRun**(collectionId: string, flowId: string, runId: string) → `Promise<FlowRun>`
+Get one run's summary. GET /integrations/flows/:id/runs/:runId
+
+**listRunItems**(collectionId: string, flowId: string, runId: string, query: ListRunItemsQuery = {}) → `Promise<RunItemList>`
+List a run's per-record items. GET /integrations/flows/:id/runs/:runId/items `request`/`response` are populated only for items captured while enhanced logging was active (and before the 24h body purge).
+
+**listEntityRuns**(collectionId: string, entityId: string, query: { limit?: number } = {}) → `Promise<RunList>`
+Every run touching an entity (e.g. a product), across flows. GET /integrations/runs/entity/:entityId
+
+**getLogging**(collectionId: string, connectionId: string) → `Promise<`
+Is enhanced logging active for a connection? GET /integrations/logging/:connectionId
+
+**setLogging**(collectionId: string, connectionId: string, input: SetLoggingInput = {}) → `Promise<`
+Enable enhanced logging. POST /integrations/logging/:connectionId (omit ttlMinutes = until cancelled)
+
+**cancelLogging**(collectionId: string, connectionId: string) → `Promise<`
+Cancel enhanced logging now. DELETE /integrations/logging/:connectionId
+
 ### interactions
 
 **query**(collectionId: string,

package/dist/openapi.yaml

@@ -4444,6 +4444,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/integrations/runs/entity/{entityId}:
+    get:
+      tags:
+        - integrations
+      summary: Every run touching an entity (e.g.
+      operationId: integrations_listEntityRuns
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: entityId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RunList"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/interactions:
     get:
       tags:
@@ -14477,6 +14509,21 @@ paths:
           required: false
           schema:
             type: string
+        - name: qFields
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: dataFilter
+          in: query
+          required: false
+          schema:
+            type: object
+            additionalProperties:
+              type: array
+              items:
+                type: object
+                additionalProperties: true
         - name: authorId
           in: query
           required: false
@@ -20020,6 +20067,15 @@ components:
           type: string
         q:
           type: string
+        qFields:
+          type: string
+        dataFilter:
+          type: object
+          additionalProperties:
+            type: array
+            items:
+              type: object
+              additionalProperties: true
         authorId:
           type: string
         parentType:
@@ -25250,6 +25306,8 @@ components:
       properties:
         entityId:
           type: string
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
     RunFlowSummary:
       type: object
       properties:
@@ -25265,6 +25323,8 @@ components:
           type: number
         status:
           $ref: "#/components/schemas/RunStatus"
+        runId:
+          type: string
       required:
         - flowId
         - direction
@@ -25272,6 +25332,209 @@ components:
         - sent
         - failed
         - status
+    CapturedRequest:
+      type: object
+      properties:
+        transport:
+          type: string
+        method:
+          type: string
+        url:
+          type: string
+        headers:
+          type: object
+          additionalProperties:
+            type: string
+        partitionKey:
+          type: string
+        body: {}
+        bodyBytes:
+          type: number
+        truncated:
+          type: boolean
+      required:
+        - transport
+        - method
+        - url
+        - headers
+        - body
+        - bodyBytes
+        - truncated
+    CapturedResponse:
+      type: object
+      properties:
+        status:
+          type: number
+        ok:
+          type: boolean
+        headers:
+          type: object
+          additionalProperties:
+            type: string
+        body: {}
+        bodyBytes:
+          type: number
+        truncated:
+          type: boolean
+        error:
+          type: string
+      required:
+        - status
+        - ok
+        - headers
+        - body
+        - bodyBytes
+        - truncated
+        - error
+    FlowRun:
+      type: object
+      properties:
+        id:
+          type: string
+        flowId:
+          type: string
+        connectionId:
+          type: string
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
+        triggerEvent:
+          type: string
+        triggerEntityId:
+          type: string
+        status:
+          $ref: "#/components/schemas/FlowRunStatus"
+        records:
+          type: number
+        sent:
+          type: number
+        failed:
+          type: number
+        error:
+          type: string
+        correlationId:
+          type: string
+        captureLevel:
+          $ref: "#/components/schemas/CaptureLevel"
+        bodiesPurged:
+          type: boolean
+        startedAt:
+          type: string
+        completedAt:
+          type: string
+        durationMs:
+          type: number
+      required:
+        - id
+        - flowId
+        - trigger
+        - status
+        - records
+        - sent
+        - failed
+        - captureLevel
+        - bodiesPurged
+        - startedAt
+    FlowRunItem:
+      type: object
+      properties:
+        id:
+          type: string
+        runId:
+          type: string
+        entityType:
+          type: string
+        entityId:
+          type: string
+        entityLabel:
+          type: string
+        status:
+          $ref: "#/components/schemas/FlowRunItemStatus"
+        skipReason:
+          type: string
+        request:
+          $ref: "#/components/schemas/CapturedRequest"
+        response:
+          $ref: "#/components/schemas/CapturedResponse"
+        attempt:
+          type: number
+        durationMs:
+          type: number
+        createdAt:
+          type: string
+      required:
+        - id
+        - runId
+        - entityType
+        - status
+        - attempt
+        - createdAt
+    ListRunsQuery:
+      type: object
+      properties:
+        status:
+          $ref: "#/components/schemas/FlowRunStatus"
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
+        entityId:
+          type: string
+        limit:
+          type: number
+        cursor:
+          type: string
+    RunList:
+      type: object
+      properties:
+        runs:
+          type: object
+          additionalProperties: true
+      required:
+        - runs
+    ListRunItemsQuery:
+      type: object
+      properties:
+        status:
+          type: object
+          additionalProperties: true
+    RunItemList:
+      type: object
+      properties:
+        items:
+          type: object
+          additionalProperties: true
+      required:
+        - items
+    LoggingWindow:
+      type: object
+      properties:
+        id:
+          type: string
+        connectionId:
+          type: string
+        level:
+          $ref: "#/components/schemas/CaptureLevel"
+        enabledBy:
+          type: string
+        enabledAt:
+          type: string
+        expiresAt:
+          type: string
+        canceledAt:
+          type: string
+      required:
+        - id
+        - connectionId
+        - level
+        - enabledAt
+    SetLoggingInput:
+      type: object
+      properties:
+        ttlMinutes:
+          type: number
+        level:
+          type: string
+          enum:
+            - full
+            - errors_only
     RunFlowEnqueued:
       type: object
       properties:
@@ -25410,6 +25673,33 @@ components:
         - none
     UpdateFlowInput:
       $ref: "#/components/schemas/CreateFlowInput"
+    RunTrigger:
+      type: string
+      enum:
+        - manual
+        - event
+        - schedule
+        - test
+    FlowRunStatus:
+      type: string
+      enum:
+        - running
+        - success
+        - partial
+        - failed
+        - skipped
+    FlowRunItemStatus:
+      type: string
+      enum:
+        - sent
+        - failed
+        - skipped
+    CaptureLevel:
+      type: string
+      enum:
+        - metadata
+        - errors_only
+        - full
     RunFlowResult:
       anyOf:
         - $ref: "#/components/schemas/RunFlowSummary"

package/dist/types/appObjects.d.ts

@@ -620,8 +620,19 @@ export interface RecordListQueryParams extends ListQueryParams {
     variantId?: string;
     /** Filter by batchId (indexed flat column) */
     batchId?: string;
-    /** Full-text filter on data.label (case-insensitive substring) */
+    /** Full-text filter (case-insensitive substring) on data.label — or on `qFields` (admin) */
     q?: string;
+    /**
+     * Admin only: which top-level `data` keys `q` searches (comma-separated, max 5).
+     * Default `label`. Example: `'value,label'`.
+     */
+    qFields?: string;
+    /**
+     * Admin only: filter on top-level `data` keys. Each value is an exact match, an
+     * `in:a,b,c` list, or an array of values (any match). Max 10 keys.
+     * Example: `{ versionId: 'v1', zone: 'in:on_pack,unclear' }`.
+     */
+    dataFilter?: Record<string, string | string[]>;
     authorId?: string;
     parentType?: string;
     parentId?: string;

package/dist/types/integrations.d.ts

@@ -87,6 +87,8 @@ export interface FlowList {
 export interface RunFlowInput {
     /** Run for a single source entity; omit for the flow's scheduled gather. */
     entityId?: string;
+    /** Trigger label recorded on the run (e.g. 'test' for a test send). Default 'manual'. */
+    trigger?: RunTrigger;
 }
 /** Inline (synchronous) run summary. */
 export interface RunFlowSummary {
@@ -96,6 +98,104 @@ export interface RunFlowSummary {
     sent: number;
     failed: number;
     status: RunStatus;
+    /** Id of the persisted run row (deep-link into its detail). */
+    runId?: string;
+}
+export type RunTrigger = 'manual' | 'event' | 'schedule' | 'test';
+export type FlowRunStatus = 'running' | 'success' | 'partial' | 'failed' | 'skipped';
+export type FlowRunItemStatus = 'sent' | 'failed' | 'skipped';
+export type CaptureLevel = 'metadata' | 'errors_only' | 'full';
+/** A redacted outbound request as captured in a run item (secrets masked, body size-capped). */
+export interface CapturedRequest {
+    transport: string;
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    partitionKey?: string;
+    body: unknown;
+    bodyBytes: number;
+    truncated: boolean;
+}
+/** A redacted response as captured in a run item. */
+export interface CapturedResponse {
+    status: number | null;
+    ok: boolean | null;
+    headers: Record<string, string>;
+    body: unknown;
+    bodyBytes: number;
+    truncated: boolean;
+    error: string | null;
+}
+/** One run of a flow. */
+export interface FlowRun {
+    id: string;
+    flowId: string;
+    connectionId?: string | null;
+    trigger: RunTrigger;
+    triggerEvent?: string | null;
+    triggerEntityId?: string | null;
+    status: FlowRunStatus;
+    records: number;
+    sent: number;
+    failed: number;
+    error?: string | null;
+    correlationId?: string | null;
+    captureLevel: CaptureLevel;
+    bodiesPurged: boolean;
+    startedAt: string;
+    completedAt?: string | null;
+    durationMs?: number | null;
+}
+/** One record's attempt within a run (request/response present only when captured at 'full'). */
+export interface FlowRunItem {
+    id: string;
+    runId: string;
+    entityType: string;
+    entityId?: string | null;
+    entityLabel?: string | null;
+    status: FlowRunItemStatus;
+    skipReason?: string | null;
+    request?: CapturedRequest | null;
+    response?: CapturedResponse | null;
+    attempt: number;
+    durationMs?: number | null;
+    createdAt: string;
+}
+export interface ListRunsQuery {
+    status?: FlowRunStatus;
+    trigger?: RunTrigger;
+    entityId?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface RunList {
+    runs: FlowRun[];
+    nextCursor?: string;
+}
+export interface ListRunItemsQuery {
+    status?: FlowRunItemStatus;
+    limit?: number;
+    cursor?: string;
+}
+export interface RunItemList {
+    items: FlowRunItem[];
+    nextCursor?: string;
+}
+/** A per-connection enhanced-logging window (full capture) while active. */
+export interface LoggingWindow {
+    id: string;
+    connectionId: string;
+    level: CaptureLevel;
+    enabledBy?: string | null;
+    enabledAt: string;
+    expiresAt?: string | null;
+    canceledAt?: string | null;
+}
+export interface SetLoggingInput {
+    /** Minutes until the window auto-expires; omit for on-until-cancelled. */
+    ttlMinutes?: number;
+    /** Capture level while active (default 'full'). */
+    level?: 'full' | 'errors_only';
 }
 /** Response when a run is enqueued (?async=true). */
 export interface RunFlowEnqueued {

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.30  |  Generated: 2026-09-29T17:13:26.956Z
+Version: 2.0.32  |  Generated: 2026-10-01T17:18:44.658Z
 
 This is a concise summary of all available API functions and types.
 
@@ -6562,6 +6562,7 @@ interface FlowList {
 ```typescript
 interface RunFlowInput {
   entityId?: string
+  trigger?: RunTrigger
 }
 ```
 
@@ -6574,6 +6575,128 @@ interface RunFlowSummary {
   sent: number
   failed: number
   status: RunStatus
+  runId?: string
+}
+```
+
+**CapturedRequest** (interface)
+```typescript
+interface CapturedRequest {
+  transport: string
+  method: string
+  url: string
+  headers: Record<string, string>
+  partitionKey?: string
+  body: unknown
+  bodyBytes: number
+  truncated: boolean
+}
+```
+
+**CapturedResponse** (interface)
+```typescript
+interface CapturedResponse {
+  status: number | null
+  ok: boolean | null
+  headers: Record<string, string>
+  body: unknown
+  bodyBytes: number
+  truncated: boolean
+  error: string | null
+}
+```
+
+**FlowRun** (interface)
+```typescript
+interface FlowRun {
+  id: string
+  flowId: string
+  connectionId?: string | null
+  trigger: RunTrigger
+  triggerEvent?: string | null
+  triggerEntityId?: string | null
+  status: FlowRunStatus
+  records: number
+  sent: number
+  failed: number
+  error?: string | null
+  correlationId?: string | null
+  captureLevel: CaptureLevel
+  bodiesPurged: boolean
+  startedAt: string
+  completedAt?: string | null
+  durationMs?: number | null
+}
+```
+
+**FlowRunItem** (interface)
+```typescript
+interface FlowRunItem {
+  id: string
+  runId: string
+  entityType: string
+  entityId?: string | null
+  entityLabel?: string | null
+  status: FlowRunItemStatus
+  skipReason?: string | null
+  request?: CapturedRequest | null
+  response?: CapturedResponse | null
+  attempt: number
+  durationMs?: number | null
+  createdAt: string
+}
+```
+
+**ListRunsQuery** (interface)
+```typescript
+interface ListRunsQuery {
+  status?: FlowRunStatus
+  trigger?: RunTrigger
+  entityId?: string
+  limit?: number
+  cursor?: string
+}
+```
+
+**RunList** (interface)
+```typescript
+interface RunList {
+  runs: FlowRun[]; nextCursor?: string
+}
+```
+
+**ListRunItemsQuery** (interface)
+```typescript
+interface ListRunItemsQuery {
+  status?: FlowRunItemStatus; limit?: number; cursor?: string
+}
+```
+
+**RunItemList** (interface)
+```typescript
+interface RunItemList {
+  items: FlowRunItem[]; nextCursor?: string
+}
+```
+
+**LoggingWindow** (interface)
+```typescript
+interface LoggingWindow {
+  id: string
+  connectionId: string
+  level: CaptureLevel
+  enabledBy?: string | null
+  enabledAt: string
+  expiresAt?: string | null
+  canceledAt?: string | null
+}
+```
+
+**SetLoggingInput** (interface)
+```typescript
+interface SetLoggingInput {
+  ttlMinutes?: number
+  level?: 'full' | 'errors_only'
 }
 ```
 
@@ -6660,6 +6783,14 @@ interface RecordTypesResponse {
 
 **UpdateFlowInput** = `Partial<Omit<CreateFlowInput, 'direction'>> & {`
 
+**RunTrigger** = `'manual' | 'event' | 'schedule' | 'test'`
+
+**FlowRunStatus** = `'running' | 'success' | 'partial' | 'failed' | 'skipped'`
+
+**FlowRunItemStatus** = `'sent' | 'failed' | 'skipped'`
+
+**CaptureLevel** = `'metadata' | 'errors_only' | 'full'`
+
 **RunFlowResult** = `RunFlowSummary | RunFlowEnqueued`
 
 ### interaction
@@ -10850,6 +10981,27 @@ Type guard: the run executed inline and returned a summary.
 **isRunEnqueued**(r: RunFlowResult) → `r is RunFlowEnqueued`
 Type guard: the run was enqueued (async).
 
+**listRuns**(collectionId: string, flowId: string, query: ListRunsQuery = {}) → `Promise<RunList>`
+List a flow's runs, newest first. GET /integrations/flows/:id/runs
+
+**getRun**(collectionId: string, flowId: string, runId: string) → `Promise<FlowRun>`
+Get one run's summary. GET /integrations/flows/:id/runs/:runId
+
+**listRunItems**(collectionId: string, flowId: string, runId: string, query: ListRunItemsQuery = {}) → `Promise<RunItemList>`
+List a run's per-record items. GET /integrations/flows/:id/runs/:runId/items `request`/`response` are populated only for items captured while enhanced logging was active (and before the 24h body purge).
+
+**listEntityRuns**(collectionId: string, entityId: string, query: { limit?: number } = {}) → `Promise<RunList>`
+Every run touching an entity (e.g. a product), across flows. GET /integrations/runs/entity/:entityId
+
+**getLogging**(collectionId: string, connectionId: string) → `Promise<`
+Is enhanced logging active for a connection? GET /integrations/logging/:connectionId
+
+**setLogging**(collectionId: string, connectionId: string, input: SetLoggingInput = {}) → `Promise<`
+Enable enhanced logging. POST /integrations/logging/:connectionId (omit ttlMinutes = until cancelled)
+
+**cancelLogging**(collectionId: string, connectionId: string) → `Promise<`
+Cancel enhanced logging now. DELETE /integrations/logging/:connectionId
+
 ### interactions
 
 **query**(collectionId: string,

package/openapi.yaml

@@ -4444,6 +4444,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/integrations/runs/entity/{entityId}:
+    get:
+      tags:
+        - integrations
+      summary: Every run touching an entity (e.g.
+      operationId: integrations_listEntityRuns
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: entityId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RunList"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/interactions:
     get:
       tags:
@@ -14477,6 +14509,21 @@ paths:
           required: false
           schema:
             type: string
+        - name: qFields
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: dataFilter
+          in: query
+          required: false
+          schema:
+            type: object
+            additionalProperties:
+              type: array
+              items:
+                type: object
+                additionalProperties: true
         - name: authorId
           in: query
           required: false
@@ -20020,6 +20067,15 @@ components:
           type: string
         q:
           type: string
+        qFields:
+          type: string
+        dataFilter:
+          type: object
+          additionalProperties:
+            type: array
+            items:
+              type: object
+              additionalProperties: true
         authorId:
           type: string
         parentType:
@@ -25250,6 +25306,8 @@ components:
       properties:
         entityId:
           type: string
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
     RunFlowSummary:
       type: object
       properties:
@@ -25265,6 +25323,8 @@ components:
           type: number
         status:
           $ref: "#/components/schemas/RunStatus"
+        runId:
+          type: string
       required:
         - flowId
         - direction
@@ -25272,6 +25332,209 @@ components:
         - sent
         - failed
         - status
+    CapturedRequest:
+      type: object
+      properties:
+        transport:
+          type: string
+        method:
+          type: string
+        url:
+          type: string
+        headers:
+          type: object
+          additionalProperties:
+            type: string
+        partitionKey:
+          type: string
+        body: {}
+        bodyBytes:
+          type: number
+        truncated:
+          type: boolean
+      required:
+        - transport
+        - method
+        - url
+        - headers
+        - body
+        - bodyBytes
+        - truncated
+    CapturedResponse:
+      type: object
+      properties:
+        status:
+          type: number
+        ok:
+          type: boolean
+        headers:
+          type: object
+          additionalProperties:
+            type: string
+        body: {}
+        bodyBytes:
+          type: number
+        truncated:
+          type: boolean
+        error:
+          type: string
+      required:
+        - status
+        - ok
+        - headers
+        - body
+        - bodyBytes
+        - truncated
+        - error
+    FlowRun:
+      type: object
+      properties:
+        id:
+          type: string
+        flowId:
+          type: string
+        connectionId:
+          type: string
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
+        triggerEvent:
+          type: string
+        triggerEntityId:
+          type: string
+        status:
+          $ref: "#/components/schemas/FlowRunStatus"
+        records:
+          type: number
+        sent:
+          type: number
+        failed:
+          type: number
+        error:
+          type: string
+        correlationId:
+          type: string
+        captureLevel:
+          $ref: "#/components/schemas/CaptureLevel"
+        bodiesPurged:
+          type: boolean
+        startedAt:
+          type: string
+        completedAt:
+          type: string
+        durationMs:
+          type: number
+      required:
+        - id
+        - flowId
+        - trigger
+        - status
+        - records
+        - sent
+        - failed
+        - captureLevel
+        - bodiesPurged
+        - startedAt
+    FlowRunItem:
+      type: object
+      properties:
+        id:
+          type: string
+        runId:
+          type: string
+        entityType:
+          type: string
+        entityId:
+          type: string
+        entityLabel:
+          type: string
+        status:
+          $ref: "#/components/schemas/FlowRunItemStatus"
+        skipReason:
+          type: string
+        request:
+          $ref: "#/components/schemas/CapturedRequest"
+        response:
+          $ref: "#/components/schemas/CapturedResponse"
+        attempt:
+          type: number
+        durationMs:
+          type: number
+        createdAt:
+          type: string
+      required:
+        - id
+        - runId
+        - entityType
+        - status
+        - attempt
+        - createdAt
+    ListRunsQuery:
+      type: object
+      properties:
+        status:
+          $ref: "#/components/schemas/FlowRunStatus"
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
+        entityId:
+          type: string
+        limit:
+          type: number
+        cursor:
+          type: string
+    RunList:
+      type: object
+      properties:
+        runs:
+          type: object
+          additionalProperties: true
+      required:
+        - runs
+    ListRunItemsQuery:
+      type: object
+      properties:
+        status:
+          type: object
+          additionalProperties: true
+    RunItemList:
+      type: object
+      properties:
+        items:
+          type: object
+          additionalProperties: true
+      required:
+        - items
+    LoggingWindow:
+      type: object
+      properties:
+        id:
+          type: string
+        connectionId:
+          type: string
+        level:
+          $ref: "#/components/schemas/CaptureLevel"
+        enabledBy:
+          type: string
+        enabledAt:
+          type: string
+        expiresAt:
+          type: string
+        canceledAt:
+          type: string
+      required:
+        - id
+        - connectionId
+        - level
+        - enabledAt
+    SetLoggingInput:
+      type: object
+      properties:
+        ttlMinutes:
+          type: number
+        level:
+          type: string
+          enum:
+            - full
+            - errors_only
     RunFlowEnqueued:
       type: object
       properties:
@@ -25410,6 +25673,33 @@ components:
         - none
     UpdateFlowInput:
       $ref: "#/components/schemas/CreateFlowInput"
+    RunTrigger:
+      type: string
+      enum:
+        - manual
+        - event
+        - schedule
+        - test
+    FlowRunStatus:
+      type: string
+      enum:
+        - running
+        - success
+        - partial
+        - failed
+        - skipped
+    FlowRunItemStatus:
+      type: string
+      enum:
+        - sent
+        - failed
+        - skipped
+    CaptureLevel:
+      type: string
+      enum:
+        - metadata
+        - errors_only
+        - full
     RunFlowResult:
       anyOf:
         - $ref: "#/components/schemas/RunFlowSummary"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.30",
+  "version": "2.0.32",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",