@proveanything/smartlinks 2.0.29 → 2.0.31

package/dist/openapi.yaml

@@ -4334,6 +4334,35 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/getUsers:
+    get:
+      tags:
+        - collection
+      summary: List the users with access to a collection, each with their access level (admin only).
+      operationId: collection_getUsers
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/CollectionUser"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/hub:
     post:
       tags:
@@ -4415,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:
@@ -8694,6 +8755,38 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TranslationUpdateRequest"
+  /admin/collection/{collectionId}/updateUserAccess:
+    post:
+      tags:
+        - collection
+      summary: "Grant, change, or remove a user's access level on a collection (admin only)."
+      operationId: collection_setUserAccess
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema: {}
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CollectionAccessLevel"
   /admin/collection/{encodedCollectionId}/comm/send:
     post:
       tags:
@@ -22709,6 +22802,38 @@ components:
             $ref: "#/components/schemas/AppConfig"
       required:
         - apps
+    CollectionUser:
+      type: object
+      properties:
+        uid:
+          type: string
+        access:
+          type: object
+          additionalProperties: true
+        name:
+          type: string
+        email:
+          type: string
+      required:
+        - uid
+        - access
+    InviteUserInput:
+      type: object
+      properties:
+        email:
+          type: string
+        name:
+          type: string
+        access:
+          type: object
+          additionalProperties: true
+        loginCollectionId:
+          type: string
+        consoleOrigin:
+          type: string
+      required:
+        - email
+        - access
     CollectionResponse:
       $ref: "#/components/schemas/Collection"
     CollectionCreateRequest:
@@ -22718,6 +22843,15 @@ components:
     DomainTarget:
       type: object
       additionalProperties: true
+    CollectionAccessLevel:
+      type: string
+      enum:
+        - Owner
+        - Admin
+        - Assigner
+        - Reporter
+        - User
+        - None
     IdField:
       type: string
       enum:
@@ -25148,6 +25282,8 @@ components:
       properties:
         entityId:
           type: string
+        trigger:
+          $ref: "#/components/schemas/RunTrigger"
     RunFlowSummary:
       type: object
       properties:
@@ -25163,6 +25299,8 @@ components:
           type: number
         status:
           $ref: "#/components/schemas/RunStatus"
+        runId:
+          type: string
       required:
         - flowId
         - direction
@@ -25170,6 +25308,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:
@@ -25308,6 +25649,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/collection.d.ts

@@ -153,3 +153,33 @@ export interface AppsConfigResponse extends Omit<AppConfigSettings, 'id' | 'apps
     /** Array of app catalog definitions for this collection. */
     apps: AppConfig[];
 }
+/**
+ * A user's access level on a collection. Access is stored in the collection's `roles` map
+ * (userId → level). Server-enforced tiers are `User` < `Admin` < `Owner`; `Reporter` / `Assigner`
+ * are legacy values still accepted but not part of the enforced hierarchy. `None` removes access.
+ */
+export type CollectionAccessLevel = 'Owner' | 'Admin' | 'Assigner' | 'Reporter' | 'User' | 'None';
+/** A user who has access to a collection (as returned by {@link collection.getUsers}). */
+export interface CollectionUser {
+    /** The user's id (auth uid). */
+    uid: string;
+    /** The user's access level on this collection. */
+    access: CollectionAccessLevel | string;
+    /** Display name, if known. */
+    name?: string;
+    /** Email address, if known. */
+    email?: string;
+}
+/** Input for {@link collection.inviteUser}. */
+export interface InviteUserInput {
+    /** Email address to invite. */
+    email: string;
+    /** Optional display name (used when creating a brand-new account). */
+    name?: string;
+    /** Access level to grant on the collection. Apply it with {@link collection.setUserAccess} after inviting. */
+    access: CollectionAccessLevel | string;
+    /** The login / auth-kit collection the account lives in (for branding + where the login is created). Default `'global'`. */
+    loginCollectionId?: string;
+    /** Origin used to build the branded invite link. Defaults to `window.location.origin` in the browser. */
+    consoleOrigin?: 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 {