@dbos-inc/dbos-enterprise 5.4.1-preview → 5.4.2-preview

package/dist/src/sharding/migrations.d.ts

@@ -0,0 +1,20 @@
+// Copyright (c) 2026 DBOS, Inc. All rights reserved.
+//
+// This file is part of Transact Enterprise, proprietary software licensed under the
+// DBOS Conductor Software License: https://www.dbos.dev/conductor-license
+// You may not use, copy, modify, or distribute this file except as that license permits.
+// Disabling or circumventing the entitlement checks in @dbos-inc/dbos-sdk's src/enterprise.ts
+// that gate it is a material breach of that license.
+import type { PoolClient } from 'pg';
+import { type SystemDatabase } from '@dbos-inc/dbos-sdk/internal/system_database';
+export interface Statement {
+    sql: string;
+    creates?: string;
+}
+export declare function getShardedMigrations(schema: string): Statement[][];
+export declare const LATEST_VERSION: number;
+export declare function currentVersion(sysdb: SystemDatabase): Promise<number>;
+export declare function citusInstalled(client: PoolClient): Promise<boolean>;
+export declare function runMigrations(sysdb: SystemDatabase): Promise<void>;
+export declare function verifyMigrations(sysdb: SystemDatabase): Promise<void>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/src/sharding/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/sharding/migrations.ts"],"names":[],"mappings":";;;;;;;AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAQrG,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkXD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,CAGlE;AAED,eAAO,MAAM,cAAc,QAAsC,CAAC;AAOlE,wBAAsB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAO3E;AA0BD,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzE;AAoBD,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCxE;AA4BD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E"}

package/dist/src/sharding/migrations.js

@@ -0,0 +1,486 @@
+// Copyright (c) 2026 DBOS, Inc. All rights reserved.
+//
+// This file is part of Transact Enterprise, proprietary software licensed under the
+// DBOS Conductor Software License: https://www.dbos.dev/conductor-license
+// You may not use, copy, modify, or distribute this file except as that license permits.
+// Disabling or circumventing the entitlement checks in @dbos-inc/dbos-sdk's src/enterprise.ts
+// that gate it is a material breach of that license.
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyMigrations = exports.runMigrations = exports.citusInstalled = exports.currentVersion = exports.LATEST_VERSION = exports.getShardedMigrations = void 0;
+const error_1 = require("@dbos-inc/dbos-sdk/internal/error");
+const system_database_1 = require("@dbos-inc/dbos-sdk/internal/system_database");
+const utils_1 = require("@dbos-inc/dbos-sdk/internal/utils");
+const locks_1 = require("../locks");
+const schema_1 = require("./schema");
+const MIGRATION_LOCK_TIMEOUT_MS = 30_000;
+function migrationOne(s) {
+    return [
+        { sql: `CREATE SCHEMA IF NOT EXISTS ${s}` },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.dbos_migrations (
+    shard_key text NOT NULL,
+    version bigint NOT NULL,
+    PRIMARY KEY (shard_key)
+)`,
+            creates: 'dbos_migrations',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.workflow_status (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    status text,
+    name text,
+    authenticated_user text,
+    assumed_role text,
+    authenticated_roles text,
+    request text,
+    output text,
+    error text,
+    executor_id text,
+    created_at bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    updated_at bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    application_version text,
+    application_id text,
+    class_name character varying(255) DEFAULT NULL,
+    config_name character varying(255) DEFAULT NULL,
+    recovery_attempts bigint DEFAULT 0,
+    queue_name text,
+    workflow_timeout_ms bigint,
+    workflow_deadline_epoch_ms bigint,
+    inputs text,
+    started_at_epoch_ms bigint,
+    deduplication_id text,
+    priority int4 DEFAULT 0 NOT NULL,
+    queue_partition_key text,
+    forked_from text,
+    owner_xid text,
+    parent_workflow_id text,
+    parent_shard_key text,
+    serialization text,
+    delay_until_epoch_ms bigint,
+    was_forked_from boolean DEFAULT false NOT NULL,
+    rate_limited boolean DEFAULT false NOT NULL,
+    completed_at bigint,
+    attributes jsonb,
+    schedule_name text,
+    debounce_deadline_epoch_ms bigint,
+    is_debounced boolean DEFAULT false NOT NULL,
+    application_name text,
+    creator_xid text,
+    PRIMARY KEY (shard_key, workflow_uuid)
+)`,
+            creates: 'workflow_status',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.workflow_input (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    inputs text,
+    retention_timestamp bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    PRIMARY KEY (shard_key, workflow_uuid)
+)`,
+            creates: 'workflow_input',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.workflow_output (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    output text,
+    error text,
+    retention_timestamp bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    PRIMARY KEY (shard_key, workflow_uuid)
+)`,
+            creates: 'workflow_output',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.operation_outputs (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    function_id int4 NOT NULL,
+    function_name text DEFAULT '' NOT NULL,
+    output text,
+    error text,
+    child_workflow_id text,
+    child_shard_key text,
+    started_at_epoch_ms bigint,
+    completed_at_epoch_ms bigint,
+    serialization text,
+    application_name text,
+    retention_timestamp bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    PRIMARY KEY (shard_key, workflow_uuid, function_id)
+)`,
+            creates: 'operation_outputs',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.notifications (
+    shard_key text NOT NULL,
+    message_uuid text DEFAULT gen_random_uuid() NOT NULL,
+    destination_uuid text NOT NULL,
+    topic text,
+    message text NOT NULL,
+    created_at_epoch_ms bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    serialization text,
+    consumed boolean DEFAULT false NOT NULL,
+    consumed_by_function_id int4,
+    PRIMARY KEY (shard_key, message_uuid),
+    FOREIGN KEY (shard_key, destination_uuid)
+        REFERENCES ${s}.workflow_status (shard_key, workflow_uuid) ON DELETE CASCADE
+)`,
+            creates: 'notifications',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.workflow_events (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    key text NOT NULL,
+    value text NOT NULL,
+    serialization text,
+    PRIMARY KEY (shard_key, workflow_uuid, key),
+    FOREIGN KEY (shard_key, workflow_uuid)
+        REFERENCES ${s}.workflow_status (shard_key, workflow_uuid) ON DELETE CASCADE
+)`,
+            creates: 'workflow_events',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.workflow_events_history (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    function_id int4 NOT NULL,
+    key text NOT NULL,
+    value text NOT NULL,
+    serialization text,
+    PRIMARY KEY (shard_key, workflow_uuid, function_id, key),
+    FOREIGN KEY (shard_key, workflow_uuid)
+        REFERENCES ${s}.workflow_status (shard_key, workflow_uuid) ON DELETE CASCADE
+)`,
+            creates: 'workflow_events_history',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.streams (
+    shard_key text NOT NULL,
+    workflow_uuid text NOT NULL,
+    key text NOT NULL,
+    value text NOT NULL,
+    "offset" int4 NOT NULL,
+    function_id int4 DEFAULT 0 NOT NULL,
+    serialization text,
+    PRIMARY KEY (shard_key, workflow_uuid, key, "offset"),
+    FOREIGN KEY (shard_key, workflow_uuid)
+        REFERENCES ${s}.workflow_status (shard_key, workflow_uuid) ON DELETE CASCADE
+)`,
+            creates: 'streams',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.workflow_schedules (
+    shard_key text NOT NULL,
+    schedule_id text NOT NULL,
+    schedule_name text NOT NULL,
+    workflow_name text NOT NULL,
+    workflow_class_name text,
+    schedule text NOT NULL,
+    status text DEFAULT 'ACTIVE' NOT NULL,
+    context text NOT NULL,
+    last_fired_at text,
+    automatic_backfill boolean DEFAULT false NOT NULL,
+    cron_timezone text,
+    queue_name text,
+    application_name text,
+    workflow_shard_key text NOT NULL,
+    PRIMARY KEY (shard_key, schedule_id),
+    UNIQUE (shard_key, schedule_name)
+)`,
+            creates: 'workflow_schedules',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.application_versions (
+    shard_key text NOT NULL,
+    version_id text NOT NULL,
+    version_name text NOT NULL,
+    version_timestamp bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    created_at bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    application_name text,
+    PRIMARY KEY (shard_key, version_id),
+    UNIQUE (shard_key, version_name)
+)`,
+            creates: 'application_versions',
+        },
+        {
+            sql: `CREATE TABLE IF NOT EXISTS ${s}.queues (
+    shard_key text NOT NULL,
+    queue_id text DEFAULT (gen_random_uuid())::text NOT NULL,
+    name text NOT NULL,
+    concurrency int4,
+    worker_concurrency int4,
+    rate_limit_max int4,
+    rate_limit_period_sec double precision,
+    priority_enabled boolean DEFAULT false NOT NULL,
+    partition_queue boolean DEFAULT false NOT NULL,
+    polling_interval_sec double precision DEFAULT 1.0 NOT NULL,
+    created_at bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    updated_at bigint DEFAULT ((EXTRACT(epoch FROM now()) * 1000.0))::bigint NOT NULL,
+    application_name text,
+    partition_concurrency int4,
+    partition_worker_concurrency int4,
+    partition_rate_limit_max int4,
+    partition_rate_limit_period_sec double precision,
+    PRIMARY KEY (shard_key, queue_id),
+    UNIQUE (shard_key, name)
+)`,
+            creates: 'queues',
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_in_flight_v2
+    ON ${s}.workflow_status (shard_key, queue_name, status, priority, created_at)
+    INCLUDE (application_name)
+    WHERE status IN ('ENQUEUED', 'PENDING')`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_partition_dequeue_v3
+    ON ${s}.workflow_status (shard_key, queue_name, status, queue_partition_key, priority, created_at, workflow_uuid)
+    INCLUDE (application_name)
+    WHERE status IN ('ENQUEUED', 'PENDING') AND queue_partition_key IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_rate_limited
+    ON ${s}.workflow_status (shard_key, queue_name, started_at_epoch_ms)
+    WHERE rate_limited = true`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_keyed_created_at
+    ON ${s}.workflow_status (shard_key, created_at)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_queue_keys
+    ON ${s}.workflow_status (queue_name, status, shard_key)
+    INCLUDE (application_name)
+    WHERE status IN ('ENQUEUED', 'PENDING')`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS workflow_status_created_at_index
+    ON ${s}.workflow_status (created_at)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_pending
+    ON ${s}.workflow_status (created_at)
+    WHERE status = 'PENDING'`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_failed
+    ON ${s}.workflow_status (status, created_at)
+    WHERE status IN ('ERROR', 'CANCELLED', 'MAX_RECOVERY_ATTEMPTS_EXCEEDED')`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_delayed
+    ON ${s}.workflow_status (delay_until_epoch_ms)
+    WHERE status = 'DELAYED'`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_deadline
+    ON ${s}.workflow_status (workflow_deadline_epoch_ms)
+    WHERE status IN ('ENQUEUED', 'PENDING', 'DELAYED') AND workflow_deadline_epoch_ms IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_completed_at
+    ON ${s}.workflow_status (completed_at)
+    WHERE completed_at IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_started_at
+    ON ${s}.workflow_status (started_at_epoch_ms)
+    WHERE started_at_epoch_ms IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_parent_workflow_id
+    ON ${s}.workflow_status (parent_workflow_id)
+    WHERE parent_workflow_id IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_forked_from
+    ON ${s}.workflow_status (forked_from)
+    WHERE forked_from IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_schedule_name
+    ON ${s}.workflow_status (schedule_name)
+    WHERE schedule_name IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_status_attributes
+    ON ${s}.workflow_status USING gin (attributes)
+    WHERE attributes IS NOT NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_input_retention
+    ON ${s}.workflow_input (retention_timestamp)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_output_retention
+    ON ${s}.workflow_output (retention_timestamp)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_operation_outputs_retention
+    ON ${s}.operation_outputs (retention_timestamp)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_operation_outputs_completed_at_function_name_v2
+    ON ${s}.operation_outputs (completed_at_epoch_ms, function_name)
+    INCLUDE (application_name)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_workflow_topic
+    ON ${s}.notifications (shard_key, destination_uuid, topic)`,
+        },
+        {
+            sql: `CREATE UNIQUE INDEX IF NOT EXISTS uq_application_versions_owner_version
+    ON ${s}.application_versions (shard_key, application_name, version_name)
+    WHERE application_name IS NOT NULL`,
+        },
+        {
+            sql: `CREATE UNIQUE INDEX IF NOT EXISTS uq_application_versions_unclaimed_version
+    ON ${s}.application_versions (shard_key, version_name)
+    WHERE application_name IS NULL`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_application_versions_timestamp
+    ON ${s}.application_versions (shard_key, version_timestamp DESC)`,
+        },
+        {
+            sql: `CREATE INDEX IF NOT EXISTS idx_application_versions_owner_timestamp
+    ON ${s}.application_versions (shard_key, application_name, version_timestamp DESC)`,
+        },
+    ];
+}
+function migrationTwo(s) {
+    return [
+        {
+            sql: `CREATE OR REPLACE FUNCTION ${s}.claim_gate(name text, slots int4) RETURNS boolean
+    LANGUAGE plpgsql VOLATILE AS $$
+DECLARE
+    first int4 := floor(random() * slots)::int4;
+BEGIN
+    FOR i IN 0 .. slots - 1 LOOP
+        IF pg_try_advisory_xact_lock(hashtext(name), (first + i) % slots) THEN
+            RETURN true;
+        END IF;
+    END LOOP;
+    RETURN false;
+END $$`,
+        },
+    ];
+}
+function getShardedMigrations(schema) {
+    const quotedSchema = quoteIdentifier(schema);
+    return [migrationOne(quotedSchema), migrationTwo(quotedSchema)];
+}
+exports.getShardedMigrations = getShardedMigrations;
+exports.LATEST_VERSION = getShardedMigrations('dbos').length;
+function quoteIdentifier(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+async function currentVersion(sysdb) {
+    const client = await sysdb.connect();
+    try {
+        return await recordedVersion(client, sysdb.schemaName);
+    }
+    finally {
+        client.release();
+    }
+}
+exports.currentVersion = currentVersion;
+async function recordedVersion(client, schema) {
+    const exists = await client.query(`SELECT 1 FROM information_schema.tables WHERE table_schema = $1 AND table_name = 'dbos_migrations'`, [schema]);
+    if (exists.rows.length === 0) {
+        return 0;
+    }
+    try {
+        const { rows } = await client.query(`SELECT version FROM ${quoteIdentifier(schema)}.dbos_migrations WHERE shard_key = $1`, [schema_1.GLOBAL_SHARD_KEY]);
+        return rows.length > 0 && rows[0].version !== null ? Number(rows[0].version) : 0;
+    }
+    catch (e) {
+        if ((0, system_database_1.isPgDatabaseError)(e) && e.code === '42P01') {
+            return 0;
+        }
+        throw e;
+    }
+}
+async function citusInstalled(client) {
+    const { rows } = await client.query(`SELECT 1 FROM pg_extension WHERE extname = 'citus'`);
+    return rows.length > 0;
+}
+exports.citusInstalled = citusInstalled;
+async function distributeOnCitus(client, table) {
+    if (!(await citusInstalled(client))) {
+        return;
+    }
+    const { rows } = await client.query(`SELECT 1 FROM pg_dist_partition WHERE logicalrelid = CAST($1 AS regclass)`, [
+        table,
+    ]);
+    if (rows.length === 0) {
+        const schema = table.slice(0, table.lastIndexOf('.'));
+        const name = table.slice(table.lastIndexOf('.') + 1);
+        const colocateWith = name === 'dbos_migrations' ? 'none' : `${schema}.dbos_migrations`;
+        await client.query(`SELECT create_distributed_table($1, 'shard_key', colocate_with => $2)`, [table, colocateWith]);
+    }
+}
+async function runMigrations(sysdb) {
+    if ((await currentVersion(sysdb)) >= exports.LATEST_VERSION) {
+        return;
+    }
+    const key = (0, locks_1.lockKey)(`dbos.migrations.${sysdb.schemaName}`);
+    const deadline = performance.now() + MIGRATION_LOCK_TIMEOUT_MS;
+    for (;;) {
+        const client = await sysdb.connect();
+        let destroy = true;
+        try {
+            const lock = await (0, locks_1.tryAdvisoryLock)(client, key, { name: 'migration', discard: true, logger: sysdb.logger });
+            try {
+                if (lock.acquired || performance.now() >= deadline) {
+                    if (!lock.acquired) {
+                        sysdb.logger.warn(`Could not acquire the sharded migration lock within ${MIGRATION_LOCK_TIMEOUT_MS / 1000}s. Migrating without it.`);
+                    }
+                    await migrate(sysdb, client);
+                    return;
+                }
+            }
+            finally {
+                destroy = await lock.release();
+            }
+        }
+        finally {
+            client.release(destroy);
+        }
+        await (0, utils_1.sleepms)(1000);
+    }
+}
+exports.runMigrations = runMigrations;
+async function migrate(sysdb, client) {
+    const schema = sysdb.schemaName;
+    const version = await recordedVersion(client, schema);
+    if (version >= exports.LATEST_VERSION) {
+        return;
+    }
+    sysdb.logger.info(`Migrating sharded system database schema ${schema} from version ${version} to ${exports.LATEST_VERSION}`);
+    const quoted = quoteIdentifier(schema);
+    for (const migration of getShardedMigrations(schema).slice(version)) {
+        for (const statement of migration) {
+            await client.query(statement.sql);
+            if (statement.creates !== undefined) {
+                await distributeOnCitus(client, `${quoted}.${statement.creates}`);
+            }
+        }
+    }
+    await client.query(`INSERT INTO ${quoted}.dbos_migrations (shard_key, version) VALUES ($1, $2)
+     ON CONFLICT (shard_key) DO UPDATE SET version = GREATEST(${quoted}.dbos_migrations.version, EXCLUDED.version)`, [schema_1.GLOBAL_SHARD_KEY, exports.LATEST_VERSION]);
+}
+async function verifyMigrations(sysdb) {
+    const current = await currentVersion(sysdb);
+    if (current < exports.LATEST_VERSION) {
+        throw new error_1.DBOSInitializationError(`Sharded system database schema ${sysdb.schemaName} is at version ${current}, but this version of DBOS ` +
+            `requires ${exports.LATEST_VERSION}. This process is configured with runMigrations disabled, so it will not ` +
+            'migrate it: either migrate the system database out of band (`npx dbos schema --sharding`) or launch ' +
+            'with runMigrations enabled.');
+    }
+}
+exports.verifyMigrations = verifyMigrations;
+//# sourceMappingURL=migrations.js.map

package/dist/src/sharding/migrations.js.map

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

package/dist/src/sharding/schema.d.ts

@@ -0,0 +1,9 @@
+// Copyright (c) 2026 DBOS, Inc. All rights reserved.
+//
+// This file is part of Transact Enterprise, proprietary software licensed under the
+// DBOS Conductor Software License: https://www.dbos.dev/conductor-license
+// You may not use, copy, modify, or distribute this file except as that license permits.
+// Disabling or circumventing the entitlement checks in @dbos-inc/dbos-sdk's src/enterprise.ts
+// that gate it is a material breach of that license.
+export declare const GLOBAL_SHARD_KEY = "__dbos_global__";
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/sharding/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/sharding/schema.ts"],"names":[],"mappings":";;;;;;;AAGA,eAAO,MAAM,gBAAgB,oBAAoB,CAAC"}

package/dist/src/sharding/schema.js

@@ -0,0 +1,12 @@
+// Copyright (c) 2026 DBOS, Inc. All rights reserved.
+//
+// This file is part of Transact Enterprise, proprietary software licensed under the
+// DBOS Conductor Software License: https://www.dbos.dev/conductor-license
+// You may not use, copy, modify, or distribute this file except as that license permits.
+// Disabling or circumventing the entitlement checks in @dbos-inc/dbos-sdk's src/enterprise.ts
+// that gate it is a material breach of that license.
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_SHARD_KEY = void 0;
+exports.GLOBAL_SHARD_KEY = '__dbos_global__';
+//# sourceMappingURL=schema.js.map

package/dist/src/sharding/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/sharding/schema.ts"],"names":[],"mappings":";;;;;;;;;;AAGa,QAAA,gBAAgB,GAAG,iBAAiB,CAAC"}

package/dist/src/sharding/sys_db.d.ts

@@ -0,0 +1,101 @@
+// Copyright (c) 2026 DBOS, Inc. All rights reserved.
+//
+// This file is part of Transact Enterprise, proprietary software licensed under the
+// DBOS Conductor Software License: https://www.dbos.dev/conductor-license
+// You may not use, copy, modify, or distribute this file except as that license permits.
+// Disabling or circumventing the entitlement checks in @dbos-inc/dbos-sdk's src/enterprise.ts
+// that gate it is a material breach of that license.
+import type { ClientBase, Pool, PoolClient } from 'pg';
+import type { ShardedSystemDatabaseOptions } from '@dbos-inc/dbos-sdk/internal/enterprise';
+import { SystemDatabase, type ApplicationRowCounts, type DebounceResult, type DequeueStopReason, type InsertWorkflowResult, type RecoveredWorkflow, type SystemDatabaseStoredResult, type WorkflowScheduleInternal, type WorkflowStatusInternal } from '@dbos-inc/dbos-sdk/internal/system_database';
+import { GetWorkflowsInput, WorkflowIDReusePolicy } from '@dbos-inc/dbos-sdk/internal/workflow';
+import type { WorkflowQueue } from '@dbos-inc/dbos-sdk/internal/wfqueue';
+type InitResult = Awaited<ReturnType<SystemDatabase['initWorkflowStatus']>>;
+export declare class ShardedSystemDatabase extends SystemDatabase {
+    #private;
+    discoveryIntervalMs: number;
+    discoveryEmptyIntervalMs: number;
+    claimSlotsPerKey: number;
+    dbPollingIntervalEventMs: number;
+    constructor(options: ShardedSystemDatabaseOptions);
+    get sharded(): boolean;
+    resolvedKey(workflowID: string, explicit?: string): string | undefined;
+    shardKeyOf(workflowID: string, explicit?: string): string;
+    scopeKey(): string;
+    singleKey(keys: Iterable<string>, operation: string): string | undefined;
+    groupByKey(workflowIDs: Iterable<string>): Map<string, string[]>;
+    wf(alias: string | undefined, workflowID: string, params: unknown[], column?: string, shardKey?: string): string;
+    wfIn(alias: string | undefined, workflowIDs: string[], params: unknown[]): string;
+    wfJoin(left: string, right: string): string;
+    wfValues(workflowID: string, shardKey?: string): Record<string, unknown>;
+    parentValues(parentWorkflowID: string | undefined): Record<string, unknown>;
+    childValues(childWorkflowID: string | null | undefined): Record<string, unknown>;
+    wfColumns(workflowID: string, params: unknown[]): [string, string][];
+    keyConflict(...columns: string[]): string;
+    isCitus(): Promise<boolean>;
+    backgroundJobLock<T>(jobName: string, callback: (acquired: boolean) => Promise<T>): Promise<T>;
+    outcomeInOneStatement(): Promise<boolean>;
+    insertRows<T extends object = object>(client: ClientBase | Pool, table: string, columns: string[], rows: unknown[][], suffix?: string): Promise<T[]>;
+    claimGate(queueName: string, partitionKey: string | undefined, params: unknown[]): string;
+    scoped(alias: string | undefined, params: unknown[]): string;
+    scopedColumns(params: unknown[]): [string, string][];
+    global(alias: string | undefined, params: unknown[]): string;
+    globalValues(): Record<string, unknown>;
+    keyIn(alias: string | undefined, shardKeys: string[], params: unknown[], column?: string): string;
+    keyColumn(alias: string | undefined, column?: string): string | undefined;
+    keyHint(workflowID: string): string | undefined;
+    scheduleValues(schedule: WorkflowScheduleInternal): Record<string, unknown>;
+    scheduleKeyColumn(): string | undefined;
+    runMigrations(): Promise<void>;
+    verifyMigrations(): Promise<void>;
+    isSerializationConflict(e: unknown): boolean;
+    static requireKey(status: WorkflowStatusInternal): void;
+    protected insertWorkflowStatus(client: ClientBase, initStatus: WorkflowStatusInternal, creatorXid: string | null): Promise<InsertWorkflowResult>;
+    debounceDelayedWorkflow(): Promise<DebounceResult>;
+    enqueueWorkflows(): Promise<Set<string>>;
+    renameApplication(): Promise<ApplicationRowCounts>;
+    precheckOwner(workflowID: string | undefined): Promise<void>;
+    initChildWorkflowStatus(initStatus: WorkflowStatusInternal, creatorXid: string, parentWorkflowID: string, parentFunctionID: number, startTimeEpochMs: number, endTimeEpochMs: number, reusePolicy?: WorkflowIDReusePolicy): Promise<InitResult>;
+    protected recordChild(client: PoolClient, status: WorkflowStatusInternal, parentWorkflowID: string, parentFunctionID: number, startTimeEpochMs: number, endTimeEpochMs: number): Promise<void>;
+    protected keyedMessage(destinationID: string, shardKey: string | undefined, idempotencyKey: string | undefined, workflowID: string | undefined, functionID: number | undefined): {
+        key: string;
+        idempotencyKey: string | undefined;
+    };
+    send(workflowID: string, functionID: number, destinationID: string, message: string | null, topic: string | undefined, serialization: string | null, idempotencyKey?: string, shardKey?: string): Promise<void>;
+    sendDirect(destinationID: string, message: string | null, topic: string | undefined, serialization: string | null, idempotencyKey?: string, client?: ClientBase, shardKey?: string): Promise<void>;
+    sendFromStep(workflowID: string, destinationID: string, message: string | null, topic: string | undefined, serialization: string | null, idempotencyKey?: string, shardKey?: string): Promise<void>;
+    runTransactionalStep(workflowID: string, functionID: number, functionName: string, callback: (client: PoolClient) => Promise<string | null>): Promise<SystemDatabaseStoredResult | undefined>;
+    getWorkflowStatus(workflowID: string, callerID?: string, callerFN?: number): Promise<WorkflowStatusInternal | null>;
+    keyOfBatch(workflowIDs: string[], operation: string): string | undefined;
+    deadLetterWorkflows(workflowIDs: string[], minRecoveryAttempts: number): Promise<void>;
+    resumeWorkflows(workflowIDs: string[], queueName?: string): Promise<void>;
+    listWorkflows(input: GetWorkflowsInput, options?: {
+        keyedIDs?: boolean;
+    }): Promise<WorkflowStatusInternal[]>;
+    getWorkflowStatuses(workflowIDs: string[]): Promise<Map<string, WorkflowStatusInternal>>;
+    checkFirstWorkflowId(workflowIds: string[]): Promise<string | undefined>;
+    checkCompletedWorkflowIds(workflowIds: string[]): Promise<string[]>;
+    childrenOf(parents: [string, string][]): Promise<[string, string][]>;
+    protected getDirectChildren(): Promise<string[]>;
+    cancelWorkflows(workflowIDs: string[], cancelChildren?: boolean): Promise<void>;
+    deleteWorkflows(workflowIDs: string[], deleteChildren?: boolean): Promise<void>;
+    bulkForkWorkflows(originalWorkflowIDs: string[], forkedWorkflowIDs: string[], startSteps: number[], options?: {
+        applicationVersion?: string;
+        timeoutMS?: number;
+        queueName?: string;
+        queuePartitionKey?: string;
+        replacementChildren?: Record<string, string>;
+    }): Promise<string[]>;
+    dequeueScopes(queueName: string): Promise<(string | undefined)[]>;
+    claimStartableWorkflows(queue: WorkflowQueue, executorID: string, appVersion: string, queuePartitionKey?: string, localRunningCount?: number, partitionLocalRunningCount?: number, ownerXid?: string | null, isLatestVersion?: boolean): Promise<{
+        claimedIDs: string[];
+        stopReason?: DequeueStopReason;
+    }>;
+    findAndMarkStartablePartitionedWorkflows(queue: WorkflowQueue, executorID: string, appVersion: string, maxTasks?: number, ownerXid?: string | null, isLatestVersion?: boolean): Promise<string[]>;
+    getQueuePartitions(queueName: string): Promise<string[]>;
+    discoverScopes(queueName: string): Promise<(string | undefined)[]>;
+    cancelTimedOutWorkflows(limit: number): Promise<string[]>;
+    reenqueueWorkflowsForRecovery(executorID: string, appVersion: string, recoveryQueueName: string): Promise<RecoveredWorkflow[]>;
+}
+export {};
+//# sourceMappingURL=sys_db.d.ts.map