@dbos-inc/dbos-enterprise 0.0.1 → 5.3.2-preview

package/dist/src/observability.js

@@ -0,0 +1,378 @@
+"use strict";
+// Dashboard queries over the system database: aggregates, metrics, and the bulk reads behind a workflow page.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMetrics = exports.getStepAggregates = exports.getWorkflowAggregates = exports.getAllStreamEntries = exports.getAllNotifications = exports.getAllEvents = exports.getPendingWorkflows = void 0;
+const serialization_1 = require("@dbos-inc/dbos-sdk/internal/serialization");
+const system_database_1 = require("@dbos-inc/dbos-sdk/internal/system_database");
+const workflow_1 = require("@dbos-inc/dbos-sdk/internal/workflow");
+async function getPendingWorkflows(sysdb, executorID, appVersion) {
+    const params = [workflow_1.StatusString.PENDING, executorID, appVersion];
+    // executor_id defaults to "local", so it collides across applications.
+    const scope = sysdb.appNameFilter('application_name', sysdb.appName, params);
+    const getWorkflows = await sysdb.pool.query(`SELECT workflow_uuid
+     FROM "${sysdb.schemaName}".workflow_status
+     WHERE status=$1 AND executor_id=$2 AND application_version=$3 AND ${scope}`, params);
+    return getWorkflows.rows.map((i) => ({
+        workflowUUID: i.workflow_uuid,
+    }));
+}
+exports.getPendingWorkflows = getPendingWorkflows;
+async function getAllEvents(sysdb, workflowID) {
+    const { rows } = await sysdb.observabilityQuery((client) => client.query(`SELECT key, value, serialization FROM "${sysdb.schemaName}".workflow_events
+       WHERE workflow_uuid = $1`, [workflowID]));
+    const events = {};
+    for (const row of rows) {
+        events[row.key] = await (0, serialization_1.safeParse)(sysdb.serializer, row.value, row.serialization);
+    }
+    return events;
+}
+exports.getAllEvents = getAllEvents;
+async function getAllNotifications(sysdb, workflowID) {
+    const { rows } = await sysdb.observabilityQuery((client) => client.query(`SELECT topic, message, serialization, created_at_epoch_ms, consumed
+       FROM "${sysdb.schemaName}".notifications
+       WHERE destination_uuid = $1
+       ORDER BY created_at_epoch_ms`, [workflowID]));
+    return await Promise.all(rows.map(async (row) => ({
+        topic: row.topic === sysdb.nullTopic ? null : row.topic,
+        message: await (0, serialization_1.safeParse)(sysdb.serializer, row.message, row.serialization),
+        createdAtEpochMs: Number(row.created_at_epoch_ms),
+        consumed: row.consumed,
+    })));
+}
+exports.getAllNotifications = getAllNotifications;
+async function getAllStreamEntries(sysdb, workflowID) {
+    const { rows } = await sysdb.observabilityQuery((client) => client.query(`SELECT key, value, serialization FROM "${sysdb.schemaName}".streams
+       WHERE workflow_uuid = $1
+       ORDER BY key, "offset"`, [workflowID]));
+    const streams = {};
+    const closed = new Set();
+    for (const row of rows) {
+        if (closed.has(row.key)) {
+            continue;
+        }
+        // safeParse yields the raw string for the legacy unserialized marker, which does not parse.
+        const value = await (0, serialization_1.safeParse)(sysdb.serializer, row.value, row.serialization);
+        if ((0, system_database_1.isStreamClosedSentinel)(value)) {
+            // End the stream where readStream does, so the two never disagree.
+            closed.add(row.key);
+            streams[row.key] ??= [];
+            continue;
+        }
+        (streams[row.key] ??= []).push(value);
+    }
+    return streams;
+}
+exports.getAllStreamEntries = getAllStreamEntries;
+async function getWorkflowAggregates(sysdb, input) {
+    if (input.timeBucketSizeMs !== undefined && input.timeBucketSizeMs <= 0) {
+        throw new Error('time_bucket_size_ms must be > 0');
+    }
+    const groupByFlags = [
+        ['status', input.groupByStatus ?? false, 'status'],
+        ['name', input.groupByName ?? false, 'name'],
+        ['queue_name', input.groupByQueueName ?? false, 'queue_name'],
+        ['executor_id', input.groupByExecutorId ?? false, 'executor_id'],
+        ['application_version', input.groupByApplicationVersion ?? false, 'application_version'],
+        ['application_name', input.groupByApplicationName ?? false, 'application_name'],
+    ];
+    const groupNames = [];
+    const groupColumns = [];
+    const groupSelectColumns = [];
+    for (const [colName, enabled, col] of groupByFlags) {
+        if (enabled) {
+            groupNames.push(colName);
+            groupColumns.push(col);
+            groupSelectColumns.push(col);
+        }
+    }
+    const params = [];
+    if (input.timeBucketSizeMs !== undefined) {
+        // Bucket on created_at — the indexed wall-clock timestamp on workflow_status.
+        // One placeholder shared by SELECT and GROUP BY, so Postgres sees the two expressions as identical.
+        params.push(input.timeBucketSizeMs);
+        const bucket = `$${params.length}::bigint`;
+        const bucketExpr = `(CAST(FLOOR(created_at / ${bucket}) AS BIGINT) * ${bucket})`;
+        groupNames.push('time_bucket');
+        groupColumns.push(bucketExpr);
+        groupSelectColumns.push(`${bucketExpr} AS time_bucket`);
+    }
+    if (groupColumns.length === 0) {
+        throw new Error('At least one group_by flag must be set to True');
+    }
+    // Build select columns from boolean flags. MAX ignores NULLs, so rows
+    // missing started_at_epoch_ms or completed_at naturally drop out of the
+    // latency maxes.
+    const selectFlags = [
+        ['count', input.selectCount ?? false, 'COUNT(*)'],
+        ['min_created_at', input.selectMinCreatedAt ?? false, 'MIN(created_at)'],
+        ['max_queue_wait_ms', input.selectMaxQueueWaitMs ?? false, 'MAX(started_at_epoch_ms - created_at)'],
+        ['max_total_latency_ms', input.selectMaxTotalLatencyMs ?? false, 'MAX(completed_at - created_at)'],
+    ];
+    const selectNames = [];
+    const selectColumns = [];
+    for (const [name, enabled, expr] of selectFlags) {
+        if (enabled) {
+            selectNames.push(name);
+            selectColumns.push(`${expr} AS ${name}`);
+        }
+    }
+    if (selectColumns.length === 0) {
+        throw new Error('At least one select_ flag must be set to True');
+    }
+    const whereClauses = [];
+    let paramIdx = params.length + 1;
+    const addFilter = (column, values) => {
+        if (!values || values.length === 0)
+            return;
+        const placeholders = values.map((_, i) => `$${paramIdx + i}`).join(', ');
+        whereClauses.push(`${column} IN (${placeholders})`);
+        params.push(...values);
+        paramIdx += values.length;
+    };
+    addFilter('status', input.status);
+    addFilter('name', input.name);
+    addFilter('application_version', input.appVersion);
+    addFilter('executor_id', input.executorId);
+    addFilter('queue_name', input.queueName);
+    if (input.workflowIdPrefix && input.workflowIdPrefix.length > 0) {
+        const likeClauses = input.workflowIdPrefix.map((p) => {
+            params.push(`${p}%`);
+            return `workflow_uuid LIKE $${paramIdx++}`;
+        });
+        whereClauses.push(`(${likeClauses.join(' OR ')})`);
+    }
+    addFilter('workflow_uuid', input.workflowIDs);
+    addFilter('authenticated_user', input.authenticatedUser);
+    addFilter('forked_from', input.forkedFrom);
+    addFilter('parent_workflow_id', input.parentWorkflowID);
+    addFilter('schedule_name', input.scheduleName);
+    // Unset scopes to this application, as on every other observability query.
+    whereClauses.push(sysdb.observabilityFilter('application_name', input.applicationName, params));
+    paramIdx = params.length + 1;
+    if (input.wasForkedFrom !== undefined) {
+        whereClauses.push(`was_forked_from = $${paramIdx}`);
+        params.push(input.wasForkedFrom);
+        paramIdx++;
+    }
+    // Matches the forks themselves, as opposed to wasForkedFrom, which matches the workflows they were forked from.
+    if (input.isFork !== undefined) {
+        whereClauses.push(input.isFork ? `forked_from IS NOT NULL` : `forked_from IS NULL`);
+    }
+    if (input.hasParent !== undefined) {
+        whereClauses.push(input.hasParent ? `parent_workflow_id IS NOT NULL` : `parent_workflow_id IS NULL`);
+    }
+    // Match workflows whose attributes JSONB contains all the given key-value pairs.
+    if (input.attributes && Object.keys(input.attributes).length > 0) {
+        whereClauses.push(`attributes @> $${paramIdx}::jsonb`);
+        params.push(JSON.stringify(input.attributes));
+        paramIdx++;
+    }
+    if (input.startTime) {
+        whereClauses.push(`created_at >= $${paramIdx}`);
+        params.push(new Date(input.startTime).getTime());
+        paramIdx++;
+    }
+    if (input.endTime) {
+        whereClauses.push(`created_at <= $${paramIdx}`);
+        params.push(new Date(input.endTime).getTime());
+        paramIdx++;
+    }
+    if (input.completedAfter) {
+        whereClauses.push(`completed_at >= $${paramIdx}`);
+        params.push(new Date(input.completedAfter).getTime());
+        paramIdx++;
+    }
+    if (input.completedBefore) {
+        whereClauses.push(`completed_at <= $${paramIdx}`);
+        params.push(new Date(input.completedBefore).getTime());
+        paramIdx++;
+    }
+    // dequeuedAfter/Before filter on started_at_epoch_ms: that column is
+    // populated on dequeue and surfaced as WorkflowStatus.dequeuedAt.
+    if (input.dequeuedAfter) {
+        whereClauses.push(`started_at_epoch_ms >= $${paramIdx}`);
+        params.push(new Date(input.dequeuedAfter).getTime());
+        paramIdx++;
+    }
+    if (input.dequeuedBefore) {
+        whereClauses.push(`started_at_epoch_ms <= $${paramIdx}`);
+        params.push(new Date(input.dequeuedBefore).getTime());
+        paramIdx++;
+    }
+    const whereClause = whereClauses.length > 0 ? `WHERE ${whereClauses.join(' AND ')}` : '';
+    const groupByClause = groupColumns.join(', ');
+    const selectClause = [...groupSelectColumns, ...selectColumns].join(', ');
+    const query = `
+    SELECT ${selectClause}
+    FROM "${sysdb.schemaName}".workflow_status
+    ${whereClause}
+    GROUP BY ${groupByClause}
+  `;
+    const result = await sysdb.observabilityQuery((client) => client.query(query, params));
+    const toIntOrNull = (v) => (v === null || v === undefined ? null : Number(v));
+    return result.rows.map((row) => {
+        const group = {};
+        for (const name of groupNames) {
+            const v = row[name];
+            group[name] = v === null || v === undefined ? null : String(v);
+        }
+        return {
+            group,
+            count: selectNames.includes('count') ? toIntOrNull(row.count) : null,
+            minCreatedAt: selectNames.includes('min_created_at') ? toIntOrNull(row.min_created_at) : null,
+            maxQueueWaitMs: selectNames.includes('max_queue_wait_ms') ? toIntOrNull(row.max_queue_wait_ms) : null,
+            maxTotalLatencyMs: selectNames.includes('max_total_latency_ms') ? toIntOrNull(row.max_total_latency_ms) : null,
+        };
+    });
+}
+exports.getWorkflowAggregates = getWorkflowAggregates;
+async function getStepAggregates(sysdb, input) {
+    if (input.timeBucketSizeMs !== undefined && input.timeBucketSizeMs <= 0) {
+        throw new Error('time_bucket_size_ms must be > 0');
+    }
+    // operation_outputs has no explicit status column; derive it from whether `error` is populated.
+    // Child-workflow mapping rows have NULL error, so they appear as SUCCESS — callers filter by function_name.
+    const statusExpr = `CASE WHEN error IS NULL THEN 'SUCCESS' ELSE 'ERROR' END`;
+    const groupByFlags = [
+        ['function_name', input.groupByFunctionName ?? false, 'function_name'],
+        ['status', input.groupByStatus ?? false, statusExpr],
+    ];
+    const groupNames = [];
+    const groupColumns = [];
+    const groupSelectColumns = [];
+    for (const [colName, enabled, expr] of groupByFlags) {
+        if (enabled) {
+            groupNames.push(colName);
+            groupColumns.push(expr);
+            groupSelectColumns.push(`${expr} AS ${colName}`);
+        }
+    }
+    const params = [];
+    if (input.timeBucketSizeMs !== undefined) {
+        // Bucket on completed_at_epoch_ms — it's the indexed timestamp on
+        // this table.
+        params.push(input.timeBucketSizeMs);
+        const bucket = `$${params.length}::bigint`;
+        const bucketExpr = `(CAST(FLOOR(completed_at_epoch_ms / ${bucket}) AS BIGINT) * ${bucket})`;
+        groupNames.push('time_bucket');
+        groupColumns.push(bucketExpr);
+        groupSelectColumns.push(`${bucketExpr} AS time_bucket`);
+    }
+    if (groupColumns.length === 0) {
+        throw new Error('At least one group_by flag must be set to True');
+    }
+    // Build select columns from boolean flags. Child-workflow mapping rows record start and
+    // complete at nearly the same instant, so they contribute ~0; DBOS.getResult and DBOS.sleep
+    // rows span their whole wait, so those dominate the duration max.
+    const selectFlags = [
+        ['count', input.selectCount ?? false, 'COUNT(*)'],
+        ['max_duration_ms', input.selectMaxDurationMs ?? false, 'MAX(completed_at_epoch_ms - started_at_epoch_ms)'],
+    ];
+    const selectNames = [];
+    const selectColumns = [];
+    for (const [name, enabled, expr] of selectFlags) {
+        if (enabled) {
+            selectNames.push(name);
+            selectColumns.push(`${expr} AS ${name}`);
+        }
+    }
+    if (selectColumns.length === 0) {
+        throw new Error('At least one select_ flag must be set to True');
+    }
+    const whereClauses = [];
+    let paramIdx = params.length + 1;
+    if (input.status && input.status.length > 0) {
+        const placeholders = input.status.map((_, i) => `$${paramIdx + i}`).join(', ');
+        whereClauses.push(`(${statusExpr}) IN (${placeholders})`);
+        params.push(...input.status);
+        paramIdx += input.status.length;
+    }
+    if (input.functionName && input.functionName.length > 0) {
+        const placeholders = input.functionName.map((_, i) => `$${paramIdx + i}`).join(', ');
+        whereClauses.push(`function_name IN (${placeholders})`);
+        params.push(...input.functionName);
+        paramIdx += input.functionName.length;
+    }
+    if (input.workflowIdPrefix && input.workflowIdPrefix.length > 0) {
+        const likeClauses = input.workflowIdPrefix.map((p) => {
+            params.push(`${p}%`);
+            return `workflow_uuid LIKE $${paramIdx++}`;
+        });
+        whereClauses.push(`(${likeClauses.join(' OR ')})`);
+    }
+    if (input.completedAfter) {
+        whereClauses.push(`completed_at_epoch_ms >= $${paramIdx}`);
+        params.push(new Date(input.completedAfter).getTime());
+        paramIdx++;
+    }
+    if (input.completedBefore) {
+        whereClauses.push(`completed_at_epoch_ms <= $${paramIdx}`);
+        params.push(new Date(input.completedBefore).getTime());
+        paramIdx++;
+    }
+    // Unset scopes to this application, as on every other observability query.
+    whereClauses.push(sysdb.observabilityFilter('application_name', input.applicationName, params));
+    paramIdx = params.length + 1;
+    const whereClause = whereClauses.length > 0 ? `WHERE ${whereClauses.join(' AND ')}` : '';
+    const groupByClause = groupColumns.join(', ');
+    const selectClause = [...groupSelectColumns, ...selectColumns].join(', ');
+    const query = `
+    SELECT ${selectClause}
+    FROM "${sysdb.schemaName}".operation_outputs
+    ${whereClause}
+    GROUP BY ${groupByClause}
+  `;
+    const result = await sysdb.observabilityQuery((client) => client.query(query, params));
+    const toIntOrNull = (v) => (v === null || v === undefined ? null : Number(v));
+    return result.rows.map((row) => {
+        const group = {};
+        for (const name of groupNames) {
+            const v = row[name];
+            group[name] = v === null || v === undefined ? null : String(v);
+        }
+        return {
+            group,
+            count: selectNames.includes('count') ? toIntOrNull(row.count) : null,
+            maxDurationMs: selectNames.includes('max_duration_ms') ? toIntOrNull(row.max_duration_ms) : null,
+        };
+    });
+}
+exports.getStepAggregates = getStepAggregates;
+async function getMetrics(sysdb, startTime, endTime, applicationName) {
+    return (0, system_database_1.withDbRetry)(async () => {
+        const startEpochMs = new Date(startTime).getTime();
+        const endEpochMs = new Date(endTime).getTime();
+        const workflowParams = [startEpochMs, endEpochMs];
+        const workflowScope = sysdb.observabilityFilter('application_name', applicationName, workflowParams);
+        const stepParams = [startEpochMs, endEpochMs];
+        const stepScope = sysdb.observabilityFilter('application_name', applicationName, stepParams);
+        const [workflowResult, stepResult] = await sysdb.observabilityQuery(async (client) => [
+            await client.query(`SELECT name, COUNT(workflow_uuid) as count
+         FROM "${sysdb.schemaName}".workflow_status
+         WHERE created_at >= $1 AND created_at < $2 AND ${workflowScope}
+         GROUP BY name`, workflowParams),
+            await client.query(`SELECT function_name, COUNT(*) as count
+         FROM "${sysdb.schemaName}".operation_outputs
+         WHERE completed_at_epoch_ms >= $1 AND completed_at_epoch_ms < $2 AND ${stepScope}
+         GROUP BY function_name`, stepParams),
+        ]);
+        const metrics = [];
+        for (const row of workflowResult.rows) {
+            metrics.push({
+                metricType: 'workflow_count',
+                metricName: row.name,
+                value: Number(row.count),
+            });
+        }
+        for (const row of stepResult.rows) {
+            metrics.push({
+                metricType: 'step_count',
+                metricName: row.function_name,
+                value: Number(row.count),
+            });
+        }
+        return metrics;
+    });
+}
+exports.getMetrics = getMetrics;
+//# sourceMappingURL=observability.js.map

package/dist/src/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/observability.ts"],"names":[],"mappings":"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"}

package/dist/src/retention.d.ts

@@ -0,0 +1,49 @@
+import { type SystemDatabase } from '@dbos-inc/dbos-sdk/internal/system_database';
+/**
+ * Re-run a batch that lost a deadlock or serialization race. The database already rolled it
+ * back, so replaying it is safe.
+ */
+export declare function retryOnSerializationError<T>(operation: () => Promise<T>): Promise<T>;
+/**
+ * The pg_try_advisory_lock argument for one schema's retention round: the leading 8 bytes of
+ * SHA-256 over a fixed string, read as a signed big-endian 64-bit integer. Separate locks for
+ * separate schemas. Every DBOS SDK derives the key this way, so rounds in different languages
+ * against one system database contend for the same lock; changing it here changes it everywhere.
+ */
+export declare function retentionLockKey(schemaName: string): bigint;
+export declare const DEFAULT_GC_BATCH_SIZE = 50000;
+/**
+ * Take a database-wide lock for one retention round, returning how to release it, or
+ * undefined when another round already holds it. The lock is session-scoped, so a round
+ * that crashes releases it. CockroachDB has no advisory locks and always takes it, so it
+ * collects unprotected rather than not at all.
+ */
+export declare function acquireRetentionLock(sysdb: SystemDatabase): Promise<{
+    release: () => Promise<void>;
+} | undefined>;
+/**
+ * Delete payload and step rows below the cutoff whose workflow is gone, returning the count
+ * removed from each table. Runs after the status sweep, whose orphans all fall in range:
+ * every payload is stamped no later than the completion that made the row collectable.
+ */
+export declare function collectPayloads(sysdb: SystemDatabase, cutoff: number, batchSize?: number): Promise<number[]>;
+/**
+ * Delete old terminal workflows throughout the system database, returning the cutoff
+ * actually used, or undefined when there is nothing to collect.
+ *
+ * Conductor sends cleared retention thresholds as JSON null, so every param is nullish.
+ */
+export declare function collectStatuses(sysdb: SystemDatabase, cutoffEpochTimestampMs?: number | null, rowsThreshold?: number | null, options?: {
+    batchSize?: number | null;
+}): Promise<number | undefined>;
+/**
+ * IDs of this application's in-flight workflows created at or before the cutoff.
+ * Claiming-scoped, so an upgrade still times out its own unclaimed workflows.
+ */
+export declare function listTimedOutWorkflowIds(sysdb: SystemDatabase, cutoffEpochTimestampMs: number): Promise<string[]>;
+/** Enforce retention across the entire system database. */
+export declare function garbageCollect(sysdb: SystemDatabase, cutoffEpochTimestampMs?: number | null, rowsThreshold?: number | null, options?: {
+    batchSize?: number | null;
+}): Promise<void>;
+export declare function globalTimeout(sysdb: SystemDatabase, cutoffEpochTimestampMs: number): Promise<void>;
+//# sourceMappingURL=retention.d.ts.map

package/dist/src/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/retention.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,6CAA6C,CAAC;AAwCrD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA0B1F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAGD,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAoB5C;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,SAAS,CAAC,CA2CvD;AA2GD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAA8B,GACxC,OAAO,CAAC,MAAM,EAAE,CAAC,CA0CnB;AA2DD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,EACtC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC1C,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+D7B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,cAAc,EACrB,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBnB;AAED,2DAA2D;AAC3D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,EACtC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC1C,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxG"}