@nivaro/sdk 0.1.23 → 0.1.25

package/README.md

@@ -825,6 +825,80 @@ These hooks work alongside `useNivaroForm` and require a form returned by that h
 
 ---
 
+## SDK — React Live Data (@nivaro/react)
+
+`useLiveRecord` and `useLiveList` are react-query reads that stay current. When the host mounts a realtime adapter, other people's writes are patched into the cached data in place; without one (or while the socket reconnects) the read polls instead. Nothing to wire by hand: no socket events, no invalidation.
+
+### Connect the socket once
+
+`createSocketRealtime` turns the Socket.io connection your app already holds into the adapter every live surface reads (`RealtimeContext`). Your app keeps owning the socket: it connects, sends `auth {token}` and its `client:hello`. The adapter joins and leaves collection rooms, admin watch rooms and live operations topics (reference counted), joins them again after every reconnect, replays missed events, and raises the same window events the admin app does (`nvr:catchup-full`, `nvr:access-changed`, `nvr:config-update`, `nvr:force-refresh`).
+
+```typescript
+import { io } from 'socket.io-client'
+import { createSocketRealtime, RealtimeContext } from '@nivaro/react'
+
+const socket = io(API_URL, { transports: ['websocket', 'polling'], withCredentials: true })
+socket.on('connect', async () => socket.emit('auth', { token: await wsToken() }))
+
+// Once, at module level — the adapter is shared by every component.
+const realtime = createSocketRealtime({ socket })
+
+<NivaroProvider client={client}>
+  <RealtimeContext.Provider value={realtime}>
+    <App />
+  </RealtimeContext.Provider>
+</NivaroProvider>
+```
+
+> **Note:** Shared components (My Work, Notes, tasks, record pages, collection lists, queues) read the same context, so mounting the adapter makes them live too. Set `windowEvents: { forceRefresh: false }` (or another key) when your app already raises that window event itself.
+
+### useLiveRecord
+
+```typescript
+const { data: order, deleted, live, isLoading } = useLiveRecord('orders', id, {
+  fields: ['title', 'status', 'customer.name']
+})
+if (deleted) return <p>This order was deleted.</p>
+```
+
+With an explicit `fields` list a change re-reads only the requested fields it touched (`customer` changed → `customer.name` is read again) and merges them into the cached record; a change to a field you did not ask for costs no request. Without `fields` the whole record is re-read, because a virtual computed field may depend on any column. `data` is null when the record does not exist or the viewer cannot read it.
+
+### useLiveList
+
+```typescript
+const { data: page, live } = useLiveList('orders', {
+  filter: { status: { _eq: 'open' } },
+  sort: ['-created_at'],
+  fields: ['title', 'status'],
+  limit: 25
+})
+```
+
+| Someone else… | What the list does |
+| --- | --- |
+| changes a row on the page | Re-reads that row as the viewer under the list's own filter and search, and patches it in place. |
+| changes a row so it no longer matches | The re-read returns nothing, so the row leaves (a paged list refetches to fill the gap). |
+| creates or changes a record so it now matches | Refetches the page quietly; where it belongs in the sort order is the server's to decide. |
+| changes a sort field of a row on the page | Refetches the page (the order may have moved). |
+| deletes a row on the page | Drops it from the cached page. |
+| runs a bulk or raw write | Refetches the page quietly. |
+| changes a record the filter cannot see | Nothing: an update that touches no field the filter reads cannot bring a record in. |
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| enabled | true | Pause the read and the live feed. |
+| pollMs | 30000 | Poll interval while there is no live socket (0 = never). |
+| safetyPollMs | none | A slow poll while the socket is live. |
+| debounceMs | 250 | Events inside this window are handled as one patch. |
+| includeOwn | false | Also react to this tab's own writes (a save never echoes back by default). |
+| fields (useLiveRecord) | all | Fields to read; enables the partial re-read. |
+
+> **Note:** The socket only says THAT a record changed (its id, the action and the changed field names). Values always come from a fresh read through the viewer's own permission-checked `/items` route, so row filters, User Scopes and field policies apply exactly as on the first load. A list read always carries `id` (it is added to an explicit `fields` list) so rows can be matched to events. Changes to a related record (a filter on `customer.region`) do not reach a list of orders; pass `safetyPollMs` when that matters.
+
+Query keys are `liveRecordKey(collection, id, fields)` and `liveListKey(collection, query)` — invalidate them yourself after a write if you set `includeOwn: false` and want the list re-sorted at once.
+
+---
+
 ## SDK — Notifications & Inbox
 
 Manage your notification inbox. Notifications are created by rules, workflows, comments (@mentions), and alerts — use these endpoints to read, mark as read, and delete them.

package/dist/index.d.ts

@@ -2111,8 +2111,8 @@ declare function listTasks(query?: {
     item?: string;
     assignee?: string;
     created_by?: string;
-    /** 'active' = open + in progress. */
-    status?: TaskStatus | 'active';
+    /** 'active' = open + in progress; 'all' = every status. */
+    status?: TaskStatus | 'active' | 'all';
     priority?: TaskPriority;
     due?: 'overdue' | 'today' | 'week' | 'none';
     search?: string;
@@ -4469,6 +4469,13 @@ declare function listFiles(options?: {
 }): Command<{
     data: FileRecord[];
 }>;
+/** Metadata for a known set of file ids (the shape the file fields batch-resolve with). */
+declare function readFilesByIds(ids: string[]): Command<{
+    data: Array<FileRecord & {
+        uploaded_by_name?: string | null;
+    }>;
+    total: number;
+}>;
 declare function readFileMeta(id: string): Command<{
     data: FileRecord;
 }>;
@@ -5446,6 +5453,267 @@ declare function listRetentionRuns(policyId: number): Command<{
     data: RetentionRun[];
 }>;
 
+/**
+ * Operations reads (admin): readiness, detailed health, this process's runtime
+ * stats, the instance roster, the DB connection pool, expensive SQL, the
+ * Traffic Map snapshot, the background-job registry + run history, and a
+ * summarized CPU profile of the replica that answers.
+ */
+
+interface ReadyReport {
+    ready: boolean;
+    checks: Array<{
+        id: string;
+        ok: boolean;
+        summary: string;
+    }>;
+}
+/** May traffic be routed here? Public; answers 503 (with the same body) when not ready. */
+declare function readReadiness(): Command<ReadyReport>;
+interface HealthDetailed {
+    db: {
+        ok: boolean;
+        latency_ms: number;
+    };
+    redis: {
+        ok: boolean;
+        latency_ms: number;
+    };
+    migrations: {
+        latest: string | null;
+        count: number;
+    };
+    sockets: {
+        connections: number | null;
+    };
+    read_gate?: Record<string, unknown>;
+    redis_degradation?: {
+        redis_ok: boolean;
+        consumers: Array<Record<string, unknown>>;
+    };
+    db_posture?: unknown;
+    uptime_s: number;
+    version: string;
+    node_version: string;
+    memory_mb: number;
+}
+/** Subsystem diagnostics for the replica that answers (admin). */
+declare function readHealthDetailed(): Command<{
+    data: HealthDetailed;
+}>;
+interface PoolStats {
+    used: number;
+    free: number;
+    pending_acquires: number;
+    pending_creates: number;
+    max: number;
+}
+interface RuntimeStats {
+    uptime_seconds: number;
+    rss_mb: number;
+    heap_used_mb: number;
+    heap_total_mb: number;
+    event_loop_lag_ms: {
+        current: number;
+        max_1m: number;
+    };
+    pool: PoolStats;
+}
+/** Memory, event-loop lag and pool of the replica that answers (admin). */
+declare function readRuntimeStats(): Command<{
+    data: RuntimeStats;
+}>;
+/** Every registered API process, plus which one holds the scheduler lease (admin). */
+declare function readInstanceRoster(): Command<{
+    data: Array<Record<string, unknown>>;
+    scheduler: Record<string, unknown> | null;
+}>;
+interface CpuProfileSummary {
+    /** The saved .cpuprofile, downloadable from /ops-runtime/cpu-profile/:name. */
+    name: string;
+    seconds: number;
+    busy_ms: number;
+    idle_ms: number;
+    gc_ms: number;
+    self: Array<{
+        fn: string;
+        where: string;
+        ms: number;
+    }>;
+    files: Array<{
+        where: string;
+        ms: number;
+    }>;
+    ours: Array<{
+        fn: string;
+        where: string;
+        ms: number;
+    }>;
+}
+/** Sample the answering replica's CPU for `seconds` (1–30, default 10) and summarize it
+ *  (admin). One at a time (409); refused in cloud mode (403). */
+declare function captureCpuProfile(seconds?: number): Command<{
+    data: CpuProfileSummary;
+}>;
+/** A DMV panel: rows, or why the database login cannot read them. */
+type DmvResult<T> = {
+    data: T;
+} | {
+    unavailable: string;
+};
+/** The connection pool right now, with the requests holding connections (admin). */
+declare function readDbPool(): Command<{
+    data: PoolStats & {
+        held: Array<{
+            held_ms: number;
+            hint: string | null;
+        }>;
+        pressure: Record<string, unknown>;
+    };
+}>;
+interface ExpensiveStatement {
+    total_cpu_ms: number;
+    execution_count: number;
+    avg_cpu_ms: number;
+    avg_elapsed_ms: number;
+    last_execution_time: ISODate;
+    statement_text: string;
+}
+/** The 15 statements with the most total CPU since the plan cache last cleared (admin). */
+declare function readExpensiveSql(): Command<DmvResult<ExpensiveStatement[]>>;
+interface TrafficSnapshotEntity {
+    key: string;
+    lane: string;
+    entity: string;
+    label: string;
+    system: boolean;
+    req: number;
+    read: number;
+    create: number;
+    update: number;
+    delete: number;
+    error: number;
+    p50: number;
+    p95: number;
+    routes: Array<{
+        route: string;
+        n: number;
+    }>;
+    callers: Array<{
+        key: string;
+        n: number;
+    }>;
+    [key: string]: unknown;
+}
+interface TrafficSnapshot {
+    instance: string;
+    node_scope: string;
+    at: ISODate;
+    window_s: number;
+    uptime_s: number;
+    entities: TrafficSnapshotEntity[];
+    callers: Array<{
+        key: string;
+        req: number;
+        error: number;
+    }>;
+    down: Array<{
+        id: string;
+        label: string;
+        kind: string;
+        req: number;
+        error: number;
+        p95: number;
+    }>;
+    totals: {
+        req: number;
+        read: number;
+        create: number;
+        update: number;
+        delete: number;
+        error: number;
+        p50: number;
+        p95: number;
+        outbound_req: number;
+        outbound_error: number;
+    };
+    sockets: {
+        count: number;
+        users: number;
+    };
+    sources?: Array<{
+        id: string;
+        label: string;
+        kind: string;
+        req: number;
+        error: number;
+    }>;
+    [key: string]: unknown;
+}
+/** The live Traffic Map over the last `window` seconds (60, 300 or 900; admin). */
+declare function readTrafficSnapshot(window?: 60 | 300 | 900): Command<{
+    data: TrafficSnapshot;
+}>;
+interface JobRun {
+    id: number;
+    kind: string;
+    job_id: string;
+    label: string | null;
+    extension_id: string | null;
+    status: string;
+    started_at: ISODate;
+    finished_at: ISODate | null;
+    duration_ms: number | null;
+    outcome: string | null;
+    error: string | null;
+    progress: string | null;
+    triggered_by: UUID | null;
+    triggered_by_name?: string | null;
+}
+interface JobRegistryCron {
+    id: string;
+    expression: string;
+    default_expression: string;
+    overridden: boolean;
+    extension_id: string | null;
+    next_run: ISODate | null;
+    paused: boolean;
+    heavy: boolean;
+    idempotent: boolean | 'unknown';
+    description: string | null;
+    timezone: string | null;
+    last: {
+        status: string;
+        started_at: ISODate;
+        duration_ms: number | null;
+        outcome: string | null;
+        error: string | null;
+    } | null;
+    errors_7d: number;
+    [key: string]: unknown;
+}
+/** Every scheduled job with its latest run and 7-day error count, plus what is running now
+ *  (admin). */
+declare function readJobRegistry(): Command<{
+    data: {
+        crons: JobRegistryCron[];
+        ticks_enabled: boolean;
+        scheduler: Record<string, unknown> | null;
+        running: JobRun[];
+    };
+}>;
+/** Background-job run history, newest first (admin). `job_id` is a contains-match. */
+declare function listJobRuns(query?: {
+    kind?: string;
+    job_id?: string;
+    status?: string;
+    page?: number;
+    limit?: number;
+}): Command<{
+    data: JobRun[];
+    total: number;
+}>;
+
 /**
  * Queue commands: cross-collection worklists — queue CRUD, source config,
  * item resolution (scoped/filtered/sorted/paginated), claims, saved views,
@@ -6156,6 +6424,19 @@ interface Comment {
         id: number;
         user: string;
     }>;
+    /** True once the text has been changed after posting. */
+    edited?: boolean;
+    version_count?: number;
+    /** Tombstone: the comment was deleted (text is empty). */
+    deleted?: boolean;
+    deleted_by_name?: string | null;
+}
+interface CommentVersion {
+    version: number;
+    text: string;
+    user: string | null;
+    user_name: string | null;
+    created_at: ISODate;
 }
 interface CustomQuery {
     id: number;
@@ -6753,6 +7034,10 @@ declare function updateComment(id: string, body: {
     data: Comment;
 }>;
 declare function deleteComment(id: string): Command<void>;
+/** Earlier versions of a comment, oldest first. Admins, record owners and the author only. */
+declare function getCommentHistory(id: string): Command<{
+    data: CommentVersion[];
+}>;
 declare function listFlowRuns(flowId: string, params?: {
     limit?: number;
     offset?: number;
@@ -6766,6 +7051,23 @@ declare function getFlowRun(runId: string): Command<{
 declare function listCustomQueries(): Command<{
     data: CustomQuery[];
 }>;
+interface CustomQueryCatalogEntry {
+    id: number;
+    slug: string;
+    name: string;
+    description: string | null;
+    params: Array<{
+        name: string;
+        type: string;
+        required: boolean;
+        default?: unknown;
+    }>;
+}
+/** The queries any signed-in user may run (enabled, access 'authenticated'), with
+ *  their parameter definitions. Never carries the SQL. */
+declare function listCustomQueryCatalog(): Command<{
+    data: CustomQueryCatalogEntry[];
+}>;
 declare function executeCustomQuery(slug: string, params?: Record<string, unknown>): Command<{
     data: unknown[];
     cached: boolean;
@@ -7638,4 +7940,4 @@ declare function submitFormItem(collection: string, values: Record<string, unkno
     data: Record<string, unknown>;
 }>;
 
-export { type AccessAudit, type AccessAuditFinding, type AccessAuditRun, type AccessAuditSubject, type AccessReason, type ActivityEntry, type ActivityQuery, type ActivityReportQuery, type ActivityReportRow, type ActivityReportSummary, type Addendum, type AddendumStatus, type AggregateQuery, type AggregateRow, type AiChatTraceEntry, type AiCollectionSettings, type AiColumnMapping, type AiDuplicateMatch, type AiQueryFilter, type AiQueryResult, type AiReviewFinding, type AiViolation, type AlertDefinition, type AlertLogEntry, type AlertSubscription, type AnomalyDefinition, type AnomalyRule, type ApiAnalyticsBucket, type ApiAnalyticsCollection, type ApiAnalyticsPath, type ApiAnalyticsSummary, type ApiErrorLog, type ApiKey, type ApiKeyScope, type ApprovalBrief, type ApprovalChain, type ApprovalChainStep, type ApprovalDecision, type ApprovalInstance, type ApprovalInstanceDetail, type ApprovalStatus, type ApprovalStepInput, type AtRiskCondition, type AtRiskOp, type AtRiskResult, type AtRiskRule, type AtRiskSummaryEntry, type AttributeDefinition, type AttributeValue, type BatchRead, type BatchReadResult, type BlackoutDate, type BoolFilterOps, type CMSCollection, type CascadeFilterRule, type ChangeOrder, type ChatChannel, type ChatChannelMember, type ChatDirectoryChannel, type ChatMessage, type ChatPin, type ChatReaction, type ChatRoomKind, type ChatRoomSummary, type ChatRoomType, type ChatSearchHit, type CollectionLayout, type CollectionPresetSummary, type Command, type Comment, type ConfigSnapshot, type ConfigTableClassification, type ContentBundle, type ContentExportFormat, type ContentExportOptions, type CoverageGapItem, type CoverageGapOwner, type CoverageGapReport, type CronJob, type CustomQuery, type DataQualityRule, type DataQualityRuleResult, type DataQualityRuleType, type DataQualityRun, type DataQualitySeverity, type DeadLetter, type DraftPublishConfig, type DraftStatus, type DryRunReport, type ErpSubmission, type ErpSubmissionStatus, type ExtensionManifest, type ExternalApi, type ExternalApiEndpoint, type ExternalApiSchema, type ExternalApiSlotContext, type ExternalApiSpecImportResult, type ExternalApiTestResult, type FieldChangeEntry, type FieldCondition, type FieldConfig, type FieldDependencyConfig, type FieldFilter, type FieldGroup, type FieldTranslations, type FieldVisibilityRules, type FieldWatch, type FileRecord, type FileUploadResult, type FileUsageEntry, type Filter, type FlowReplayResult, type FlowRun, type FlowTestStep, type FormFieldDescriptor, type FormFieldRelation, type FormGroupDescriptor, type FormLockCondition, type FormSchema, type FormValidationRule, type FormVisibilityRule, type GlobalSearchRecord, type GlobalSearchResults, type GraphQLResponse, type HelpVideo, type HelpVideoClick, type HelpVideoContext, type HelpVideoDownloadUrls, type HelpVideoFinalizedUpload, type HelpVideoProgress, type HelpVideoUploadSession, type HelpVideoVersion, type HelpVideoVisibility, type HelpVideoWalkStep, type HelpVideoWhatsNew, type HierarchyConfigDef, type HierarchyFlatNode, type HierarchyLevelDef, type HierarchyNestedNode, type IDFilterOps, type ISODate, type ImportDefinition, type ImportJob, type ImportParseResponse, type ImportPreview, type ImportPreviewDiff, type ImportTemplateSummary, type InstanceOwner, type IntegrationApiHealth, type InternalWidget, type Issue, type IssueSeverity, type IssueStatus, type IssueSummary, type ItemLock, type LastTouch, type LayoutAssignment, type LayoutGroup, type LayoutVersion, type ListResponse, type ManagedUser, type MetricAlertRule, type MetricAlertSubscription, type MetricDefinition, type MyTask, type MyWorkOwnedEntry, type MyWorkSla, type MyWorkSummary, type NivaroClient, type NivaroClientOptions, type NivaroExtensionPlugin, type NivaroRealtime, type NivaroRuntime, type NotificationItem, type NotificationPage, type NotificationSubscription, type NumberFilterOps, type OmniSearchHit, type OnlinePresenceConfig, type OnlinePresenceUser, type Page, type PageLayout, type PageSlotKey, type PageWidget, type PdfTemplate, type PermissionSimulation, type PersistedQuery, type PickerExclusionStatus, type PipelineFlowEdge, type PipelineFlowState, type PipelineImpactResult, type PipelineOwnerGroup, type PipelineOwnerGroupUser, type PipelineSimulation, type PipelineState, type PipelineVersionEntry, type PluginSlots, type Policy, type PreflightCheck, type PreflightReport, type PreflightSeverity, type PresenceClient, type PresenceOptions, type PresenceSession, type PresenceSessionInfo, type PresenceViewer, type PromotionApplyResult, type PromotionPreview, type Query, type Queue, type QueueColumnPrefs, type QueueCondition, type QueueDetail, type QueueDisplayConfig, type QueueItem, type QueueItemsResult, type QueueOwner, type QueueRowClickMode, type QueueScope, type QueueSource, type QueueSourceType, type QueueStats, type QueueTrendPoint, type QueueView, type QueueViewKind, type QueueWorkloadRow, READ_MANY_MAX, type RealtimeEvent, type RecordGraphEdge, type RecordGraphNode, type RecordLink, type RecordLinkType, type RecordTemplate, type RecordViewRecap, type RegisteredAction, type RelatedCommentEntry, type RelationFilter, type RelationOption, type ReportAlert, type ReportAlertCondition, type ReportAlertLogEntry, type ReportAnnotation, type ReportColumnFormat, type ReportDateRange, type ReportDef, type ReportEntityFilter, type ReportFilterPreset, type ReportQueryColumn, type ReportQueryWidgetConfig, type ReportSnapshotEntry, type ReportSubscription, type ReportTemplateEntry, type ReportVersionEntry, type ReportWidget, type ReportWidgetConfig, type ReportWidgetData, type ReportWidgetPreset, type ReportWidgetType, type RequestTrace, type ResolvedOwner, type RetentionPolicy, type RetentionRun, type RetentionRunResult, type Revision, type Role, type Rule, type SavedView, type ScheduledChange, type ScheduledReport, type ScopeDimension, type ScopeDimensionInfo, type SemanticSearchMatch, type SessionRecording, type SessionReplayMasking, type ShareLink, type SlaBatchStatus, type SlaRule, type SlaStatus, type StagedImportRun, type StagedImportStats, type StringFilterOps, type SubRow, type SubRowTemplate, type SyncJob, type Task, type TaskDoneWhenRule, type TaskPriority, type TaskStatus, type TimelineEvent, type TraceSpan, type TreeFlatNode, type TreeNestedNode, type TreeNodeConfig, type TreePermission, type TreePermissionAction, type UUID, type UserActivityEntry, type UserActivitySummary, type UserScopesInfo, type ViewSubscription, type VirtualCollection, type Webhook, type WebhookDelivery, type WidgetFeed, type WorkflowBinding, type WorkflowHistoryEntry, type WorkflowInstance, type WorkflowInstanceData, type WorkflowState, type WorkflowTransition, type Workspace, type WorkspaceQuotas, type WorkspaceTemplate, type WorkspaceUsage, _and, _contains, _ends_with, _eq, _gt, _gte, _in, _lt, _lte, _ncontains, _neq, _nin, _nnull, _none, _null, _or, _some, _starts_with, abandonHelpVideoUpload, acquireItemLock, activateLayout, addChatChannelMember, addInstanceOwner, addSubRow, aggregateItems, aiBrief, aiBuildReport, aiChat, aiCheckDuplicates, aiGenerate, aiMapColumns, aiQuery, aiReportFilters, aiReview, aiSummarize, aiValidate, appendSessionRecordingEvents, applyContentBundle, applyHelpVideoPackageImport, applyRecordTemplate, applySubRowTemplate, approveAddendum, approveAiProposal, archiveHelpVideo, asc, backupExportPath, batchPickerExclusionStatus, bulkPickerExclusion, callExternalApi, callExternalApiEndpoint, cancelScheduledChange, cancelStagedImport, cascadeFieldDependencies, checkBlackoutDate, claimQueueItem, claimTask, clearTraces, cloneItem, cloneLayout, cloneReport, compareConfigSnapshot, completeTask, copyReportWidget, createAccessAudit, createAddendum, createAlertDefinition, createAlertSubscription, createAnomalyRule, createApiKey, createApprovalChain, createAtRiskRule, createAttributeDefinition, createBlackoutDate, createChatChannel, createChatRoomType, createCollectionLayout, createComment, createDataQualityRule, createExternalApi, createExternalApiEndpoint, createFieldGroup, createFieldWatch, createGroupDm, createHelpVideo, createHierarchyConfig, createImportDefinition, createImportJob, createImportJobFromUrl, createInternalWidget, createIssue, createItem, createMetricAlertRule, createNivaro, createNotification, createNotificationSubscription, createPage, createPdfTemplate, createPersistedQuery, createPresence, createQueue, createQueueView, createRealtime, createRecordLink, createRecordTemplate, createReport, createReportAlert, createReportAnnotation, createReportFromTemplate, createReportSnapshot, createReportWidgetPreset, createRetentionPolicy, createRole, createRolePolicy, createRule, createSavedView, createScheduledChange, createScheduledReport, createShareLink, createSlaRule, createSubRowTemplate, createSyncJob, createTask, createTreePermission, createUser, createViewSubscription, createVirtualCollection, createWebhook, createWidgetFeed, createWorkspace, createWorkspaceTemplate, decideApproval, deleteAccessAudit, deleteAddendum, deleteAlertDefinition, deleteAlertSubscription, deleteAnomalyRule, deleteApiKey, deleteApprovalChain, deleteAtRiskRule, deleteAttributeDefinition, deleteBlackoutDate, deleteChatMessage, deleteCollectionLayout, deleteComment, deleteDataQualityRule, deleteExternalApi, deleteExternalApiEndpoint, deleteExternalApiSchema, deleteFieldGroup, deleteFieldTranslations, deleteFieldWatch, deleteFile, deleteHierarchyConfig, deleteImportJob, deleteInternalWidget, deleteIssue, deleteItem, deleteMetricAlertRule, deleteNotification, deleteNotificationSubscription, deletePage, deletePdfTemplate, deletePersistedQuery, deleteQueue, deleteQueueView, deleteRecordLink, deleteRecordTemplate, deleteReport, deleteReportAlert, deleteReportAnnotation, deleteReportFilterPreset, deleteReportSnapshot, deleteReportTemplate, deleteReportWidgetPreset, deleteRetentionPolicy, deleteRole, deleteRolePolicy, deleteRule, deleteSavedView, deleteScheduledReport, deleteSessionRecording, deleteSlaRule, deleteSubRow, deleteSubRowTemplate, deleteSyncJob, deleteTask, deleteTreePermission, deleteUser, deleteViewSubscription, deleteVirtualCollection, deleteWebhook, deleteWidgetFeed, deleteWorkspace, deleteWorkspaceTemplate, deployImportProcedure, desc, disableTwoFactor, discardHelpVideoPackageImport, drillReportRow, editChatMessage, endSessionRecording, evaluateAlerts, evaluateAtRisk, evaluateFieldDefaults, evaluateFieldLock, evaluateFieldRules, evaluateFieldVisibility, excludeFromPicker, executeBulkAction, executeCustomQuery, executeImportTemplate, executeItemAction, executeScheduledChange, explainRecordAccess, explainReportTrend, exportBlueprint, exportConfigSnapshot, exportContent, exportContentBundle, exportHelpVideoPackage, exportSchemaSnapshot, fetchFormSchema, fileDownloadPath, fileTransformPath, finalizeHelpVideoUpload, generateToken, generateUserToken, getAlertDefinition, getAttributeValues, getBrunoCollection, getExternalApi, getExternalApiEndpoint, getFieldTranslations, getFlowRun, getLocales, getOpenApi, getPickerExclusionStatus, getPostmanCollection, getPresence, getRetentionPolicy, getSlaRule, getSlaStatus, getTranslations, getTypes, getWebhook, globalSearch, heartbeatItemLock, helpVideosFor, importExternalApiSpec, importSchemaSnapshot, includeInPicker, installBlueprint, installCollectionPreset, invokeInternalWidgetAction, isPageSlot, joinChatRoom, leaveChatRoom, listAccessAuditRuns, listAccessAudits, listActiveAtRiskRules, listActivePresence, listAddendums, listAlertDefinitions, listAlertSubscriptions, listAllNotificationSubscriptions, listAnomalyDefinitions, listAnomalyRules, listApiKeys, listApprovalChains, listApprovalInstances, listAtRiskRules, listAttributeDefinitions, listBlackoutDates, listBulkActions, listChangeOrders, listChatChannelMembers, listChatMessages, listChatPins, listChatRoles, listChatRoomTypes, listChatRooms, listCollectionPresets, listCollectionRecordTemplates, listComments, listCronJobs, listCustomQueries, listDataQualityRules, listDataQualityRuns, listDeadLetters, listExternalApiEndpoints, listExternalApiSchemas, listExternalApis, listFieldGroups, listFieldWatches, listFiles, listFlowRuns, listHelpVideoPages, listHelpVideoVersions, listHelpVideos, listHierarchyConfigs, listImportDefinitionVersions, listImportDefinitions, listImportJobs, listImportTemplates, listInternalWidgets, listIssues, listItemActions, listItemScheduledChanges, listLayoutVersions, listMetricAlertRules, listMetricAlertSubscriptions, listMetricDefinitions, listMyHelpVideoUploads, listMyTasks, listNotificationSubscriptions, listNotifications, listOrphanFiles, listPages, listPdfTemplates, listPersistedQueries, listPinnedItems, listPipelineVersions, listQueueViews, listQueues, listRecordLinks, listRecordTemplates, listRegisteredExtensions, listRegisteredFlowOperations, listRegisteredFlowTriggers, listRelatedComments, listReportAlerts, listReportAnnotations, listReportFilterPresets, listReportSnapshots, listReportTemplates, listReportVersions, listReportWidgetPresets, listReports, listRequestedTasks, listRetentionPolicies, listRetentionRuns, listRolePolicies, listRoleUsers, listRoles, listRules, listSavedViews, listScheduledChanges, listScheduledReports, listScopeDimensions, listSessionRecordings, listShareLinks, listSlaRules, listStagedImports, listSubRowTemplates, listSubRows, listSyncJobs, listTasks, listTeamTasks, listThroughputCollections, listTraces, listTreePermissions, listViewSubscriptions, listVirtualCollections, listWebhookDeliveries, listWebhooks, listWidgetFeeds, listWorkspaceTemplates, listWorkspaces, markAllNotificationsRead, markChatRoomRead, markNotificationRead, markNotificationsRead, moveTreeNode, nudgeTask, omniSearch, openHelpVideoPackageImport, openHelpVideoUpload, presignFileUpload, previewContentBundle, previewHelpVideoPackageImport, previewImportJob, previewReportWidget, publishHelpVideo, publishItem, queryVirtualCollection, readAccessAuditFindings, readActiveLayout, readActivity, readActivityReportSummary, readAddendum, readAiSettings, readAlertLog, readAllStateOwners, readAnomalyLog, readApiAnalyticsErrors, readApiAnalyticsSummary, readApiAnalyticsTimeseries, readApiAnalyticsTopCollections, readApiAnalyticsTopPaths, readApiKey, readApprovalBrief, readApprovalChain, readAtRiskSummary, readBackupManifest, readChatConfig, readChatDirectory, readChatPeerRead, readCollection, readCollectionLayout, readCollectionLayouts, readCollections, readConfigInventory, readCoverageGaps, readDataQualityRun, readDetailLayout, readDistinctValues, readDraftPublishConfig, readErpSubmissionHistory, readFieldChangeHistory, readFieldConfig, readFieldImpact, readFieldWatch, readFileMeta, readFileUsage, readHelpVideo, readHelpVideoAnalytics, readHelpVideoDownloadLink, readHelpVideoDraft, readHelpVideoWalk, readHierarchyConfig, readHierarchyNodeAncestors, readHierarchyNodeChildren, readHierarchyNodes, readHierarchyTree, readImportJob, readImportProcedure, readInstanceOwners, readIntegrationHealth, readInternalWidget, readIssue, readIssueSummary, readItem, readItemLock, readItemLockConfig, readItems, readLastTouch, readLayoutAssignments, readLayoutGroups, readMany, readMe, readMetricAlertLog, readMyScopes, readMyWork, readNotificationCount, readNotificationSubscriptionStats, readOnlinePresence, readOwnerGroups, readPage, readPageWidgetData, readPdfTemplate, readPersistedQuery, readPipelineFlowMap, readPipelineReplay, readPipelineTemplate, readPipelineTemplates, readPipelineVersion, readPreflight, readQueue, readQueueCollectionStates, readQueueColumnPrefs, readQueueItems, readQueueTrends, readQueueWorkload, readRecordGraph, readRelationOptions, readReport, readReportAlertLog, readReportAlertsLog, readReportFilterOptions, readReportFiring, readReportSnapshot, readReportSubscription, readReportUsage, readReportWidgetData, readRequiredHelpVideos, readRevision, readRevisions, readRole, readScopeDimensionCoverage, readSessionRecordingEvents, readSettings, readSingleton, readSlaStatusBatch, readStagedImport, readStagedImportStats, readStateOwnerGroups, readStateOwners, readStateOwnersBatch, readSyncJob, readTask, readTaskCounts, readTaskHistory, readThroughputReport, readTimeline, readTrace, readTreeAncestors, readTreeChildren, readTreeConfig, readTreeDescendants, readTreeNested, readTreeNodes, readTwoFactorStatus, readUnreadNotificationCount, readUser, readUserActivity, readUserActivitySummary, readUserCard, readUserScopes, readUsers, readWorkflowBindings, readWorkflowInstance, readWorkflowInstances, readWorkspace, readWorkspaceUsage, rebuildTreePaths, recordHelpVideoProgress, registerHelpVideoPage, rehearseCreateItem, reindexSemanticSearch, rejectAddendum, rejectAiProposal, releaseItemLock, releaseQueueItem, rematerializeQueue, removeChatChannelMember, removeInstanceOwner, renderInternalWidget, renderPdfTemplate, reorderFieldGroups, reorderSubRows, reorderTreeSiblings, replaceSubRows, replayActivityEvent, replayFlow, reportClientError, requestRecordAccess, requeueStagedImport, rerecordHelpVideo, rerenderHelpVideo, resetReportCache, resolveReportAlert, restoreHelpVideoVersion, restoreImportDefinitionVersion, restoreLayoutVersion, restorePipelineVersion, restoreReportVersion, retryDeadLetter, retryErpSubmission, retryWebhookDelivery, revokeApiKey, revokeShareLink, revokeToken, revokeUserToken, rollbackRevision, rotateWidgetFeedToken, runAccessAudit, runActivityReport, runActivityReportCsv, runCronJob, runDataQuality, runRetentionPolicy, runScheduledReport, runSyncJob, saveHelpVideoDraft, saveMyScopeDefaults, saveReportFilterPreset, saveReportTemplate, saveReportWidgets, saveUserScope, searchChatMessages, semanticSearch, sendBulkNotification, sendChatMessage, sendTestMail, sessionRecordingEnabled, setHelpVideoContexts, setHelpVideoRequirements, setMyDelegate, setQueueDefaultView, setReportSubscription, setTranslations, setupTwoFactor, simulatePermissions, simulatePipeline, simulatePipelineImpact, startApproval, startMasquerade, startSessionRecording, startWorkflow, stopMasquerade, submitAddendum, submitFormItem, submitItemForReview, submitToErp, subscribeFieldWatch, subscribeMetricAlert, suggestImportValidation, suggestQueueLabels, switchWorkspace, testExternalApi, testFlow, testWebhook, toggleChatPin, toggleChatReaction, togglePinnedItem, toggleReportAlert, touchRecordView, transitionWorkflow, unpublishItem, unsubscribeFieldWatch, unsubscribeMetricAlert, updateAccessAudit, updateAddendum, updateAiSettings, updateAlertDefinition, updateAnomalyLogEntry, updateAnomalyRule, updateApiKey, updateApprovalChain, updateAtRiskRule, updateAttributeDefinition, updateAttributeValues, updateChatChannel, updateChatRoom, updateChatRoomType, updateCollectionLayout, updateComment, updateDataQualityRule, updateDraftPublishConfig, updateErpSubmissionStatus, updateExternalApi, updateExternalApiEndpoint, updateFieldConfig, updateFieldGroup, updateFieldWatch, updateFileMeta, updateHelpVideo, updateHierarchyConfig, updateImportDefinition, updateInternalWidget, updateIssue, updateItem, updateItemLockConfig, updateLayoutAssignments, updateLayoutUngroupedSort, updateMe, updateMetricAlertRule, updateMetricAlertSubscription, updateNotificationSubscription, updatePage, updatePdfTemplate, updatePersistedQuery, updateQueue, updateQueueSources, updateQueueView, updateRecordTemplate, updateReport, updateReportAlert, updateReportWidgetPreset, updateRetentionPolicy, updateRole, updateRolePolicy, updateRoleUiPermissions, updateRule, updateSavedView, updateScheduledReport, updateSettings, updateSingleton, updateSlaRule, updateSyncJob, updateTask, updateTreePermission, updateUser, updateVirtualCollection, updateWebhook, updateWidgetFeed, updateWorkflowBinding, updateWorkspace, validateVirtualCollectionSql, verifyTwoFactor };
+export { type AccessAudit, type AccessAuditFinding, type AccessAuditRun, type AccessAuditSubject, type AccessReason, type ActivityEntry, type ActivityQuery, type ActivityReportQuery, type ActivityReportRow, type ActivityReportSummary, type Addendum, type AddendumStatus, type AggregateQuery, type AggregateRow, type AiChatTraceEntry, type AiCollectionSettings, type AiColumnMapping, type AiDuplicateMatch, type AiQueryFilter, type AiQueryResult, type AiReviewFinding, type AiViolation, type AlertDefinition, type AlertLogEntry, type AlertSubscription, type AnomalyDefinition, type AnomalyRule, type ApiAnalyticsBucket, type ApiAnalyticsCollection, type ApiAnalyticsPath, type ApiAnalyticsSummary, type ApiErrorLog, type ApiKey, type ApiKeyScope, type ApprovalBrief, type ApprovalChain, type ApprovalChainStep, type ApprovalDecision, type ApprovalInstance, type ApprovalInstanceDetail, type ApprovalStatus, type ApprovalStepInput, type AtRiskCondition, type AtRiskOp, type AtRiskResult, type AtRiskRule, type AtRiskSummaryEntry, type AttributeDefinition, type AttributeValue, type BatchRead, type BatchReadResult, type BlackoutDate, type BoolFilterOps, type CMSCollection, type CascadeFilterRule, type ChangeOrder, type ChatChannel, type ChatChannelMember, type ChatDirectoryChannel, type ChatMessage, type ChatPin, type ChatReaction, type ChatRoomKind, type ChatRoomSummary, type ChatRoomType, type ChatSearchHit, type CollectionLayout, type CollectionPresetSummary, type Command, type Comment, type CommentVersion, type ConfigSnapshot, type ConfigTableClassification, type ContentBundle, type ContentExportFormat, type ContentExportOptions, type CoverageGapItem, type CoverageGapOwner, type CoverageGapReport, type CpuProfileSummary, type CronJob, type CustomQuery, type CustomQueryCatalogEntry, type DataQualityRule, type DataQualityRuleResult, type DataQualityRuleType, type DataQualityRun, type DataQualitySeverity, type DeadLetter, type DmvResult, type DraftPublishConfig, type DraftStatus, type DryRunReport, type ErpSubmission, type ErpSubmissionStatus, type ExpensiveStatement, type ExtensionManifest, type ExternalApi, type ExternalApiEndpoint, type ExternalApiSchema, type ExternalApiSlotContext, type ExternalApiSpecImportResult, type ExternalApiTestResult, type FieldChangeEntry, type FieldCondition, type FieldConfig, type FieldDependencyConfig, type FieldFilter, type FieldGroup, type FieldTranslations, type FieldVisibilityRules, type FieldWatch, type FileRecord, type FileUploadResult, type FileUsageEntry, type Filter, type FlowReplayResult, type FlowRun, type FlowTestStep, type FormFieldDescriptor, type FormFieldRelation, type FormGroupDescriptor, type FormLockCondition, type FormSchema, type FormValidationRule, type FormVisibilityRule, type GlobalSearchRecord, type GlobalSearchResults, type GraphQLResponse, type HealthDetailed, type HelpVideo, type HelpVideoClick, type HelpVideoContext, type HelpVideoDownloadUrls, type HelpVideoFinalizedUpload, type HelpVideoProgress, type HelpVideoUploadSession, type HelpVideoVersion, type HelpVideoVisibility, type HelpVideoWalkStep, type HelpVideoWhatsNew, type HierarchyConfigDef, type HierarchyFlatNode, type HierarchyLevelDef, type HierarchyNestedNode, type IDFilterOps, type ISODate, type ImportDefinition, type ImportJob, type ImportParseResponse, type ImportPreview, type ImportPreviewDiff, type ImportTemplateSummary, type InstanceOwner, type IntegrationApiHealth, type InternalWidget, type Issue, type IssueSeverity, type IssueStatus, type IssueSummary, type ItemLock, type JobRegistryCron, type JobRun, type LastTouch, type LayoutAssignment, type LayoutGroup, type LayoutVersion, type ListResponse, type ManagedUser, type MetricAlertRule, type MetricAlertSubscription, type MetricDefinition, type MyTask, type MyWorkOwnedEntry, type MyWorkSla, type MyWorkSummary, type NivaroClient, type NivaroClientOptions, type NivaroExtensionPlugin, type NivaroRealtime, type NivaroRuntime, type NotificationItem, type NotificationPage, type NotificationSubscription, type NumberFilterOps, type OmniSearchHit, type OnlinePresenceConfig, type OnlinePresenceUser, type Page, type PageLayout, type PageSlotKey, type PageWidget, type PdfTemplate, type PermissionSimulation, type PersistedQuery, type PickerExclusionStatus, type PipelineFlowEdge, type PipelineFlowState, type PipelineImpactResult, type PipelineOwnerGroup, type PipelineOwnerGroupUser, type PipelineSimulation, type PipelineState, type PipelineVersionEntry, type PluginSlots, type Policy, type PoolStats, type PreflightCheck, type PreflightReport, type PreflightSeverity, type PresenceClient, type PresenceOptions, type PresenceSession, type PresenceSessionInfo, type PresenceViewer, type PromotionApplyResult, type PromotionPreview, type Query, type Queue, type QueueColumnPrefs, type QueueCondition, type QueueDetail, type QueueDisplayConfig, type QueueItem, type QueueItemsResult, type QueueOwner, type QueueRowClickMode, type QueueScope, type QueueSource, type QueueSourceType, type QueueStats, type QueueTrendPoint, type QueueView, type QueueViewKind, type QueueWorkloadRow, READ_MANY_MAX, type ReadyReport, type RealtimeEvent, type RecordGraphEdge, type RecordGraphNode, type RecordLink, type RecordLinkType, type RecordTemplate, type RecordViewRecap, type RegisteredAction, type RelatedCommentEntry, type RelationFilter, type RelationOption, type ReportAlert, type ReportAlertCondition, type ReportAlertLogEntry, type ReportAnnotation, type ReportColumnFormat, type ReportDateRange, type ReportDef, type ReportEntityFilter, type ReportFilterPreset, type ReportQueryColumn, type ReportQueryWidgetConfig, type ReportSnapshotEntry, type ReportSubscription, type ReportTemplateEntry, type ReportVersionEntry, type ReportWidget, type ReportWidgetConfig, type ReportWidgetData, type ReportWidgetPreset, type ReportWidgetType, type RequestTrace, type ResolvedOwner, type RetentionPolicy, type RetentionRun, type RetentionRunResult, type Revision, type Role, type Rule, type RuntimeStats, type SavedView, type ScheduledChange, type ScheduledReport, type ScopeDimension, type ScopeDimensionInfo, type SemanticSearchMatch, type SessionRecording, type SessionReplayMasking, type ShareLink, type SlaBatchStatus, type SlaRule, type SlaStatus, type StagedImportRun, type StagedImportStats, type StringFilterOps, type SubRow, type SubRowTemplate, type SyncJob, type Task, type TaskDoneWhenRule, type TaskPriority, type TaskStatus, type TimelineEvent, type TraceSpan, type TrafficSnapshot, type TrafficSnapshotEntity, type TreeFlatNode, type TreeNestedNode, type TreeNodeConfig, type TreePermission, type TreePermissionAction, type UUID, type UserActivityEntry, type UserActivitySummary, type UserScopesInfo, type ViewSubscription, type VirtualCollection, type Webhook, type WebhookDelivery, type WidgetFeed, type WorkflowBinding, type WorkflowHistoryEntry, type WorkflowInstance, type WorkflowInstanceData, type WorkflowState, type WorkflowTransition, type Workspace, type WorkspaceQuotas, type WorkspaceTemplate, type WorkspaceUsage, _and, _contains, _ends_with, _eq, _gt, _gte, _in, _lt, _lte, _ncontains, _neq, _nin, _nnull, _none, _null, _or, _some, _starts_with, abandonHelpVideoUpload, acquireItemLock, activateLayout, addChatChannelMember, addInstanceOwner, addSubRow, aggregateItems, aiBrief, aiBuildReport, aiChat, aiCheckDuplicates, aiGenerate, aiMapColumns, aiQuery, aiReportFilters, aiReview, aiSummarize, aiValidate, appendSessionRecordingEvents, applyContentBundle, applyHelpVideoPackageImport, applyRecordTemplate, applySubRowTemplate, approveAddendum, approveAiProposal, archiveHelpVideo, asc, backupExportPath, batchPickerExclusionStatus, bulkPickerExclusion, callExternalApi, callExternalApiEndpoint, cancelScheduledChange, cancelStagedImport, captureCpuProfile, cascadeFieldDependencies, checkBlackoutDate, claimQueueItem, claimTask, clearTraces, cloneItem, cloneLayout, cloneReport, compareConfigSnapshot, completeTask, copyReportWidget, createAccessAudit, createAddendum, createAlertDefinition, createAlertSubscription, createAnomalyRule, createApiKey, createApprovalChain, createAtRiskRule, createAttributeDefinition, createBlackoutDate, createChatChannel, createChatRoomType, createCollectionLayout, createComment, createDataQualityRule, createExternalApi, createExternalApiEndpoint, createFieldGroup, createFieldWatch, createGroupDm, createHelpVideo, createHierarchyConfig, createImportDefinition, createImportJob, createImportJobFromUrl, createInternalWidget, createIssue, createItem, createMetricAlertRule, createNivaro, createNotification, createNotificationSubscription, createPage, createPdfTemplate, createPersistedQuery, createPresence, createQueue, createQueueView, createRealtime, createRecordLink, createRecordTemplate, createReport, createReportAlert, createReportAnnotation, createReportFromTemplate, createReportSnapshot, createReportWidgetPreset, createRetentionPolicy, createRole, createRolePolicy, createRule, createSavedView, createScheduledChange, createScheduledReport, createShareLink, createSlaRule, createSubRowTemplate, createSyncJob, createTask, createTreePermission, createUser, createViewSubscription, createVirtualCollection, createWebhook, createWidgetFeed, createWorkspace, createWorkspaceTemplate, decideApproval, deleteAccessAudit, deleteAddendum, deleteAlertDefinition, deleteAlertSubscription, deleteAnomalyRule, deleteApiKey, deleteApprovalChain, deleteAtRiskRule, deleteAttributeDefinition, deleteBlackoutDate, deleteChatMessage, deleteCollectionLayout, deleteComment, deleteDataQualityRule, deleteExternalApi, deleteExternalApiEndpoint, deleteExternalApiSchema, deleteFieldGroup, deleteFieldTranslations, deleteFieldWatch, deleteFile, deleteHierarchyConfig, deleteImportJob, deleteInternalWidget, deleteIssue, deleteItem, deleteMetricAlertRule, deleteNotification, deleteNotificationSubscription, deletePage, deletePdfTemplate, deletePersistedQuery, deleteQueue, deleteQueueView, deleteRecordLink, deleteRecordTemplate, deleteReport, deleteReportAlert, deleteReportAnnotation, deleteReportFilterPreset, deleteReportSnapshot, deleteReportTemplate, deleteReportWidgetPreset, deleteRetentionPolicy, deleteRole, deleteRolePolicy, deleteRule, deleteSavedView, deleteScheduledReport, deleteSessionRecording, deleteSlaRule, deleteSubRow, deleteSubRowTemplate, deleteSyncJob, deleteTask, deleteTreePermission, deleteUser, deleteViewSubscription, deleteVirtualCollection, deleteWebhook, deleteWidgetFeed, deleteWorkspace, deleteWorkspaceTemplate, deployImportProcedure, desc, disableTwoFactor, discardHelpVideoPackageImport, drillReportRow, editChatMessage, endSessionRecording, evaluateAlerts, evaluateAtRisk, evaluateFieldDefaults, evaluateFieldLock, evaluateFieldRules, evaluateFieldVisibility, excludeFromPicker, executeBulkAction, executeCustomQuery, executeImportTemplate, executeItemAction, executeScheduledChange, explainRecordAccess, explainReportTrend, exportBlueprint, exportConfigSnapshot, exportContent, exportContentBundle, exportHelpVideoPackage, exportSchemaSnapshot, fetchFormSchema, fileDownloadPath, fileTransformPath, finalizeHelpVideoUpload, generateToken, generateUserToken, getAlertDefinition, getAttributeValues, getBrunoCollection, getCommentHistory, getExternalApi, getExternalApiEndpoint, getFieldTranslations, getFlowRun, getLocales, getOpenApi, getPickerExclusionStatus, getPostmanCollection, getPresence, getRetentionPolicy, getSlaRule, getSlaStatus, getTranslations, getTypes, getWebhook, globalSearch, heartbeatItemLock, helpVideosFor, importExternalApiSpec, importSchemaSnapshot, includeInPicker, installBlueprint, installCollectionPreset, invokeInternalWidgetAction, isPageSlot, joinChatRoom, leaveChatRoom, listAccessAuditRuns, listAccessAudits, listActiveAtRiskRules, listActivePresence, listAddendums, listAlertDefinitions, listAlertSubscriptions, listAllNotificationSubscriptions, listAnomalyDefinitions, listAnomalyRules, listApiKeys, listApprovalChains, listApprovalInstances, listAtRiskRules, listAttributeDefinitions, listBlackoutDates, listBulkActions, listChangeOrders, listChatChannelMembers, listChatMessages, listChatPins, listChatRoles, listChatRoomTypes, listChatRooms, listCollectionPresets, listCollectionRecordTemplates, listComments, listCronJobs, listCustomQueries, listCustomQueryCatalog, listDataQualityRules, listDataQualityRuns, listDeadLetters, listExternalApiEndpoints, listExternalApiSchemas, listExternalApis, listFieldGroups, listFieldWatches, listFiles, listFlowRuns, listHelpVideoPages, listHelpVideoVersions, listHelpVideos, listHierarchyConfigs, listImportDefinitionVersions, listImportDefinitions, listImportJobs, listImportTemplates, listInternalWidgets, listIssues, listItemActions, listItemScheduledChanges, listJobRuns, listLayoutVersions, listMetricAlertRules, listMetricAlertSubscriptions, listMetricDefinitions, listMyHelpVideoUploads, listMyTasks, listNotificationSubscriptions, listNotifications, listOrphanFiles, listPages, listPdfTemplates, listPersistedQueries, listPinnedItems, listPipelineVersions, listQueueViews, listQueues, listRecordLinks, listRecordTemplates, listRegisteredExtensions, listRegisteredFlowOperations, listRegisteredFlowTriggers, listRelatedComments, listReportAlerts, listReportAnnotations, listReportFilterPresets, listReportSnapshots, listReportTemplates, listReportVersions, listReportWidgetPresets, listReports, listRequestedTasks, listRetentionPolicies, listRetentionRuns, listRolePolicies, listRoleUsers, listRoles, listRules, listSavedViews, listScheduledChanges, listScheduledReports, listScopeDimensions, listSessionRecordings, listShareLinks, listSlaRules, listStagedImports, listSubRowTemplates, listSubRows, listSyncJobs, listTasks, listTeamTasks, listThroughputCollections, listTraces, listTreePermissions, listViewSubscriptions, listVirtualCollections, listWebhookDeliveries, listWebhooks, listWidgetFeeds, listWorkspaceTemplates, listWorkspaces, markAllNotificationsRead, markChatRoomRead, markNotificationRead, markNotificationsRead, moveTreeNode, nudgeTask, omniSearch, openHelpVideoPackageImport, openHelpVideoUpload, presignFileUpload, previewContentBundle, previewHelpVideoPackageImport, previewImportJob, previewReportWidget, publishHelpVideo, publishItem, queryVirtualCollection, readAccessAuditFindings, readActiveLayout, readActivity, readActivityReportSummary, readAddendum, readAiSettings, readAlertLog, readAllStateOwners, readAnomalyLog, readApiAnalyticsErrors, readApiAnalyticsSummary, readApiAnalyticsTimeseries, readApiAnalyticsTopCollections, readApiAnalyticsTopPaths, readApiKey, readApprovalBrief, readApprovalChain, readAtRiskSummary, readBackupManifest, readChatConfig, readChatDirectory, readChatPeerRead, readCollection, readCollectionLayout, readCollectionLayouts, readCollections, readConfigInventory, readCoverageGaps, readDataQualityRun, readDbPool, readDetailLayout, readDistinctValues, readDraftPublishConfig, readErpSubmissionHistory, readExpensiveSql, readFieldChangeHistory, readFieldConfig, readFieldImpact, readFieldWatch, readFileMeta, readFileUsage, readFilesByIds, readHealthDetailed, readHelpVideo, readHelpVideoAnalytics, readHelpVideoDownloadLink, readHelpVideoDraft, readHelpVideoWalk, readHierarchyConfig, readHierarchyNodeAncestors, readHierarchyNodeChildren, readHierarchyNodes, readHierarchyTree, readImportJob, readImportProcedure, readInstanceOwners, readInstanceRoster, readIntegrationHealth, readInternalWidget, readIssue, readIssueSummary, readItem, readItemLock, readItemLockConfig, readItems, readJobRegistry, readLastTouch, readLayoutAssignments, readLayoutGroups, readMany, readMe, readMetricAlertLog, readMyScopes, readMyWork, readNotificationCount, readNotificationSubscriptionStats, readOnlinePresence, readOwnerGroups, readPage, readPageWidgetData, readPdfTemplate, readPersistedQuery, readPipelineFlowMap, readPipelineReplay, readPipelineTemplate, readPipelineTemplates, readPipelineVersion, readPreflight, readQueue, readQueueCollectionStates, readQueueColumnPrefs, readQueueItems, readQueueTrends, readQueueWorkload, readReadiness, readRecordGraph, readRelationOptions, readReport, readReportAlertLog, readReportAlertsLog, readReportFilterOptions, readReportFiring, readReportSnapshot, readReportSubscription, readReportUsage, readReportWidgetData, readRequiredHelpVideos, readRevision, readRevisions, readRole, readRuntimeStats, readScopeDimensionCoverage, readSessionRecordingEvents, readSettings, readSingleton, readSlaStatusBatch, readStagedImport, readStagedImportStats, readStateOwnerGroups, readStateOwners, readStateOwnersBatch, readSyncJob, readTask, readTaskCounts, readTaskHistory, readThroughputReport, readTimeline, readTrace, readTrafficSnapshot, readTreeAncestors, readTreeChildren, readTreeConfig, readTreeDescendants, readTreeNested, readTreeNodes, readTwoFactorStatus, readUnreadNotificationCount, readUser, readUserActivity, readUserActivitySummary, readUserCard, readUserScopes, readUsers, readWorkflowBindings, readWorkflowInstance, readWorkflowInstances, readWorkspace, readWorkspaceUsage, rebuildTreePaths, recordHelpVideoProgress, registerHelpVideoPage, rehearseCreateItem, reindexSemanticSearch, rejectAddendum, rejectAiProposal, releaseItemLock, releaseQueueItem, rematerializeQueue, removeChatChannelMember, removeInstanceOwner, renderInternalWidget, renderPdfTemplate, reorderFieldGroups, reorderSubRows, reorderTreeSiblings, replaceSubRows, replayActivityEvent, replayFlow, reportClientError, requestRecordAccess, requeueStagedImport, rerecordHelpVideo, rerenderHelpVideo, resetReportCache, resolveReportAlert, restoreHelpVideoVersion, restoreImportDefinitionVersion, restoreLayoutVersion, restorePipelineVersion, restoreReportVersion, retryDeadLetter, retryErpSubmission, retryWebhookDelivery, revokeApiKey, revokeShareLink, revokeToken, revokeUserToken, rollbackRevision, rotateWidgetFeedToken, runAccessAudit, runActivityReport, runActivityReportCsv, runCronJob, runDataQuality, runRetentionPolicy, runScheduledReport, runSyncJob, saveHelpVideoDraft, saveMyScopeDefaults, saveReportFilterPreset, saveReportTemplate, saveReportWidgets, saveUserScope, searchChatMessages, semanticSearch, sendBulkNotification, sendChatMessage, sendTestMail, sessionRecordingEnabled, setHelpVideoContexts, setHelpVideoRequirements, setMyDelegate, setQueueDefaultView, setReportSubscription, setTranslations, setupTwoFactor, simulatePermissions, simulatePipeline, simulatePipelineImpact, startApproval, startMasquerade, startSessionRecording, startWorkflow, stopMasquerade, submitAddendum, submitFormItem, submitItemForReview, submitToErp, subscribeFieldWatch, subscribeMetricAlert, suggestImportValidation, suggestQueueLabels, switchWorkspace, testExternalApi, testFlow, testWebhook, toggleChatPin, toggleChatReaction, togglePinnedItem, toggleReportAlert, touchRecordView, transitionWorkflow, unpublishItem, unsubscribeFieldWatch, unsubscribeMetricAlert, updateAccessAudit, updateAddendum, updateAiSettings, updateAlertDefinition, updateAnomalyLogEntry, updateAnomalyRule, updateApiKey, updateApprovalChain, updateAtRiskRule, updateAttributeDefinition, updateAttributeValues, updateChatChannel, updateChatRoom, updateChatRoomType, updateCollectionLayout, updateComment, updateDataQualityRule, updateDraftPublishConfig, updateErpSubmissionStatus, updateExternalApi, updateExternalApiEndpoint, updateFieldConfig, updateFieldGroup, updateFieldWatch, updateFileMeta, updateHelpVideo, updateHierarchyConfig, updateImportDefinition, updateInternalWidget, updateIssue, updateItem, updateItemLockConfig, updateLayoutAssignments, updateLayoutUngroupedSort, updateMe, updateMetricAlertRule, updateMetricAlertSubscription, updateNotificationSubscription, updatePage, updatePdfTemplate, updatePersistedQuery, updateQueue, updateQueueSources, updateQueueView, updateRecordTemplate, updateReport, updateReportAlert, updateReportWidgetPreset, updateRetentionPolicy, updateRole, updateRolePolicy, updateRoleUiPermissions, updateRule, updateSavedView, updateScheduledReport, updateSettings, updateSingleton, updateSlaRule, updateSyncJob, updateTask, updateTreePermission, updateUser, updateVirtualCollection, updateWebhook, updateWidgetFeed, updateWorkflowBinding, updateWorkspace, validateVirtualCollectionSql, verifyTwoFactor };

package/dist/index.js

@@ -1339,6 +1339,12 @@ function stopMasquerade() {
 function listFiles(options = {}) {
   return cmd("GET", "/files", options);
 }
+function readFilesByIds(ids) {
+  return cmd("GET", "/files", {
+    filter: JSON.stringify({ id: { _in: ids } }),
+    limit: Math.max(1, ids.length)
+  });
+}
 function readFileMeta(id) {
   return cmd("GET", `/files/${id}/meta`);
 }
@@ -1634,6 +1640,40 @@ function listRetentionRuns(policyId) {
   return cmd("GET", `/retention/${policyId}/runs`);
 }
 
+// src/commands/ops.ts
+function readReadiness() {
+  return cmd("GET", "/ready");
+}
+function readHealthDetailed() {
+  return cmd("GET", "/health/detailed");
+}
+function readRuntimeStats() {
+  return cmd("GET", "/ops-runtime/runtime");
+}
+function readInstanceRoster() {
+  return cmd("GET", "/ops-runtime/roster");
+}
+function captureCpuProfile(seconds) {
+  return cmd("POST", "/ops-runtime/cpu-profile", void 0, seconds ? { seconds } : {});
+}
+function readDbPool() {
+  return cmd("GET", "/ops-db/pool");
+}
+function readExpensiveSql() {
+  return cmd("GET", "/ops-db/expensive-sql");
+}
+function readTrafficSnapshot(window2 = 60) {
+  return cmd("GET", "/traffic-map/snapshot", { window: window2 });
+}
+function readJobRegistry() {
+  return cmd("GET", "/job-runs/registry");
+}
+function listJobRuns(query) {
+  const params = {};
+  for (const [k, v] of Object.entries(query ?? {})) if (v !== void 0 && v !== "") params[k] = v;
+  return cmd("GET", "/job-runs", params);
+}
+
 // src/commands/queues.ts
 function listQueues() {
   return cmd("GET", "/queues");
@@ -2161,6 +2201,9 @@ function updateComment(id, body) {
 function deleteComment(id) {
   return cmd("DELETE", `/comments/${id}`);
 }
+function getCommentHistory(id) {
+  return cmd("GET", `/comments/${id}/history`);
+}
 function listFlowRuns(flowId, params) {
   const p = {};
   if (params?.limit != null) p.limit = params.limit;
@@ -2174,6 +2217,9 @@ function getFlowRun(runId) {
 function listCustomQueries() {
   return cmd("GET", "/custom-queries");
 }
+function listCustomQueryCatalog() {
+  return cmd("GET", "/custom-queries/catalog");
+}
 function executeCustomQuery(slug, params) {
   return cmd("POST", `/custom-queries/${slug}/execute`, void 0, { params });
 }
@@ -2712,6 +2758,7 @@ export {
   callExternalApiEndpoint,
   cancelScheduledChange,
   cancelStagedImport,
+  captureCpuProfile,
   cascadeFieldDependencies,
   checkBlackoutDate,
   claimQueueItem,
@@ -2890,6 +2937,7 @@ export {
   getAlertDefinition,
   getAttributeValues,
   getBrunoCollection,
+  getCommentHistory,
   getExternalApi,
   getExternalApiEndpoint,
   getFieldTranslations,
@@ -2946,6 +2994,7 @@ export {
   listComments,
   listCronJobs,
   listCustomQueries,
+  listCustomQueryCatalog,
   listDataQualityRules,
   listDataQualityRuns,
   listDeadLetters,
@@ -2968,6 +3017,7 @@ export {
   listIssues,
   listItemActions,
   listItemScheduledChanges,
+  listJobRuns,
   listLayoutVersions,
   listMetricAlertRules,
   listMetricAlertSubscriptions,
@@ -3074,16 +3124,20 @@ export {
   readConfigInventory,
   readCoverageGaps,
   readDataQualityRun,
+  readDbPool,
   readDetailLayout,
   readDistinctValues,
   readDraftPublishConfig,
   readErpSubmissionHistory,
+  readExpensiveSql,
   readFieldChangeHistory,
   readFieldConfig,
   readFieldImpact,
   readFieldWatch,
   readFileMeta,
   readFileUsage,
+  readFilesByIds,
+  readHealthDetailed,
   readHelpVideo,
   readHelpVideoAnalytics,
   readHelpVideoDownloadLink,
@@ -3097,6 +3151,7 @@ export {
   readImportJob,
   readImportProcedure,
   readInstanceOwners,
+  readInstanceRoster,
   readIntegrationHealth,
   readInternalWidget,
   readIssue,
@@ -3105,6 +3160,7 @@ export {
   readItemLock,
   readItemLockConfig,
   readItems,
+  readJobRegistry,
   readLastTouch,
   readLayoutAssignments,
   readLayoutGroups,
@@ -3133,6 +3189,7 @@ export {
   readQueueItems,
   readQueueTrends,
   readQueueWorkload,
+  readReadiness,
   readRecordGraph,
   readRelationOptions,
   readReport,
@@ -3148,6 +3205,7 @@ export {
   readRevision,
   readRevisions,
   readRole,
+  readRuntimeStats,
   readScopeDimensionCoverage,
   readSessionRecordingEvents,
   readSettings,
@@ -3165,6 +3223,7 @@ export {
   readThroughputReport,
   readTimeline,
   readTrace,
+  readTrafficSnapshot,
   readTreeAncestors,
   readTreeChildren,
   readTreeConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nivaro/sdk",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "TypeScript SDK for Nivaro CMS — typed REST client, GraphQL, realtime subscriptions, and presence.",
   "type": "module",
   "main": "./dist/index.js",