@dbos-inc/dbos-sdk 0.7.18-preview

package/dist/src/workflow.js

@@ -0,0 +1,446 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetrievedHandle = exports.InvokedHandle = exports.WorkflowContextImpl = exports.StatusString = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const dbos_executor_1 = require("./dbos-executor");
+const transaction_1 = require("./transaction");
+const communicator_1 = require("./communicator");
+const error_1 = require("./error");
+const serialize_error_1 = require("serialize-error");
+const utils_1 = require("./utils");
+const api_1 = require("@opentelemetry/api");
+const context_1 = require("./context");
+const decorators_1 = require("./decorators");
+exports.StatusString = {
+    PENDING: "PENDING",
+    SUCCESS: "SUCCESS",
+    ERROR: "ERROR",
+};
+class WorkflowContextImpl extends context_1.DBOSContextImpl {
+    workflowConfig;
+    functionID = 0;
+    #wfe;
+    resultBuffer = new Map();
+    isTempWorkflow;
+    constructor(wfe, parentCtx, workflowUUID, workflowConfig, workflowName) {
+        const span = wfe.tracer.startSpan(workflowName, {
+            workflowUUID: workflowUUID,
+            operationName: workflowName,
+            runAs: parentCtx?.authenticatedUser ?? "",
+        }, parentCtx?.span);
+        super(workflowName, span, wfe.logger, parentCtx);
+        this.workflowConfig = workflowConfig;
+        this.workflowUUID = workflowUUID;
+        this.#wfe = wfe;
+        this.isTempWorkflow = wfe.tempWorkflowName === workflowName;
+        if (wfe.config.application) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            this.applicationConfig = wfe.config.application;
+        }
+    }
+    functionIDGetIncrement() {
+        return this.functionID++;
+    }
+    /**
+     * Check if an operation has already executed in a workflow.
+     * If it previously executed succesfully, return its output.
+     * If it previously executed and threw an error, throw that error.
+     * Otherwise, return DBOSNull.
+     * Also return the transaction snapshot information of this current transaction.
+     */
+    async checkExecution(client, funcID) {
+        // Note: we read the current snapshot, not the recorded one!
+        const rows = await this.#wfe.userDatabase.queryWithClient(client, "(SELECT output, error, pg_current_snapshot()::text as txn_snapshot, true as recorded FROM dbos.transaction_outputs WHERE workflow_uuid=$1 AND function_id=$2 UNION ALL SELECT null as output, null as error, pg_current_snapshot()::text as txn_snapshot, false as recorded) ORDER BY recorded", this.workflowUUID, funcID);
+        if (rows.length === 0 || rows.length > 2) {
+            this.logger.error("Unexpected! This should never happen. Returned rows: " + rows.toString());
+            throw new error_1.DBOSError("This should never happen. Returned rows: " + rows.toString());
+        }
+        const res = {
+            output: dbos_executor_1.dbosNull,
+            txn_snapshot: ""
+        };
+        // recorded=false row will be first because we used ORDER BY.
+        res.txn_snapshot = rows[0].txn_snapshot;
+        if (rows.length == 2) {
+            if (JSON.parse(rows[1].error) !== null) {
+                throw (0, serialize_error_1.deserializeError)(JSON.parse(rows[1].error));
+            }
+            else {
+                res.output = JSON.parse(rows[1].output);
+            }
+        }
+        return res;
+    }
+    /**
+     * Write all entries in the workflow result buffer to the database.
+     * If it encounters a primary key error, this indicates a concurrent execution with the same UUID, so throw an DBOSError.
+     */
+    async flushResultBuffer(client) {
+        const funcIDs = Array.from(this.resultBuffer.keys());
+        if (funcIDs.length === 0) {
+            return;
+        }
+        funcIDs.sort();
+        try {
+            let sqlStmt = "INSERT INTO dbos.transaction_outputs (workflow_uuid, function_id, output, error, txn_id, txn_snapshot) VALUES ";
+            let paramCnt = 1;
+            const values = [];
+            for (const funcID of funcIDs) {
+                // Capture output and also transaction snapshot information.
+                // Initially, no txn_id because no queries executed.
+                const recorded = this.resultBuffer.get(funcID);
+                const output = recorded.output;
+                const txnSnapshot = recorded.txn_snapshot;
+                if (paramCnt > 1) {
+                    sqlStmt += ", ";
+                }
+                sqlStmt += `($${paramCnt++}, $${paramCnt++}, $${paramCnt++}, $${paramCnt++}, null, $${paramCnt++})`;
+                values.push(this.workflowUUID, funcID, JSON.stringify(output), JSON.stringify(null), txnSnapshot);
+            }
+            this.logger.debug(sqlStmt);
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+            await this.#wfe.userDatabase.queryWithClient(client, sqlStmt, ...values);
+        }
+        catch (error) {
+            if (this.#wfe.userDatabase.isKeyConflictError(error)) {
+                // Serialization and primary key conflict (Postgres).
+                throw new error_1.DBOSWorkflowConflictUUIDError(this.workflowUUID);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Buffer a placeholder value to guard an operation against concurrent executions with the same UUID.
+     */
+    guardOperation(funcID, txnSnapshot) {
+        const guardOutput = {
+            output: null,
+            txn_snapshot: txnSnapshot,
+        };
+        this.resultBuffer.set(funcID, guardOutput);
+    }
+    /**
+     * Write a guarded operation's output to the database.
+     */
+    async recordGuardedOutput(client, funcID, output) {
+        const serialOutput = JSON.stringify(output);
+        const rows = await this.#wfe.userDatabase.queryWithClient(client, "UPDATE dbos.transaction_outputs SET output=$1, txn_id=(select pg_current_xact_id_if_assigned()::text) WHERE workflow_uuid=$2 AND function_id=$3 RETURNING txn_id;", serialOutput, this.workflowUUID, funcID);
+        return rows[0].txn_id; // Must have a transaction ID because we inserted the guard before.
+    }
+    /**
+     * Record an error in a guarded operation to the database.
+     */
+    async recordGuardedError(client, funcID, err) {
+        const serialErr = JSON.stringify((0, serialize_error_1.serializeError)(err));
+        await this.#wfe.userDatabase.queryWithClient(client, "UPDATE dbos.transaction_outputs SET error=$1 WHERE workflow_uuid=$2 AND function_id=$3;", serialErr, this.workflowUUID, funcID);
+    }
+    /**
+     * Invoke another workflow as its child workflow and return a workflow handle.
+     * The child workflow is guaranteed to be executed exactly once, even if the workflow is retried with the same UUID.
+     * We pass in itself as a parent context adn assign the child workflow with a derministic UUID "this.workflowUUID-functionID", which appends a function ID to its own UUID.
+     */
+    async childWorkflow(wf, ...args) {
+        // Note: cannot use invoke for childWorkflow because of potential recursive types on the workflow itself.
+        const funcId = this.functionIDGetIncrement();
+        const childUUID = this.workflowUUID + "-" + funcId;
+        return this.#wfe.workflow(wf, { parentCtx: this, workflowUUID: childUUID }, ...args);
+    }
+    /**
+     * Execute a transactional function.
+     * The transaction is guaranteed to execute exactly once, even if the workflow is retried with the same UUID.
+     * If the transaction encounters a Postgres serialization error, retry it.
+     * If it encounters any other error, throw it.
+     */
+    async transaction(txn, ...args) {
+        const config = this.#wfe.transactionConfigMap.get(txn.name);
+        if (config === undefined) {
+            throw new error_1.DBOSNotRegisteredError(txn.name);
+        }
+        const readOnly = config.readOnly ?? false;
+        let retryWaitMillis = 1;
+        const backoffFactor = 2;
+        const funcId = this.functionIDGetIncrement();
+        const span = this.#wfe.tracer.startSpan(txn.name, {
+            workflowUUID: this.workflowUUID,
+            operationName: txn.name,
+            runAs: this.authenticatedUser,
+            readOnly: readOnly,
+            isolationLevel: config.isolationLevel,
+        }, this.span);
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const wrappedTransaction = async (client) => {
+                // Check if this execution previously happened, returning its original result if it did.
+                const tCtxt = new transaction_1.TransactionContextImpl(this.#wfe.userDatabase.getName(), client, this, span, this.#wfe.logger, funcId, txn.name);
+                const check = await this.checkExecution(client, funcId);
+                if (check.output !== dbos_executor_1.dbosNull) {
+                    tCtxt.span.setAttribute("cached", true);
+                    tCtxt.span.setStatus({ code: api_1.SpanStatusCode.OK });
+                    this.#wfe.tracer.endSpan(tCtxt.span);
+                    return check.output;
+                }
+                // TODO: record snapshot information in result buffer.
+                // Flush the result buffer, setting a guard to block concurrent executions with the same UUID.
+                this.guardOperation(funcId, check.txn_snapshot);
+                if (!readOnly) {
+                    await this.flushResultBuffer(client);
+                }
+                // Execute the user's transaction.
+                const result = await txn(tCtxt, ...args);
+                // Record the execution, commit, and return.
+                if (readOnly) {
+                    // Buffer the output of read-only transactions instead of synchronously writing it.
+                    const guardOutput = {
+                        output: result,
+                        txn_snapshot: check.txn_snapshot,
+                    };
+                    this.resultBuffer.set(funcId, guardOutput);
+                }
+                else {
+                    // Synchronously record the output of write transactions and obtain the transaction ID.
+                    const pg_txn_id = await this.recordGuardedOutput(client, funcId, result);
+                    tCtxt.span.setAttribute("transaction_id", pg_txn_id);
+                    this.resultBuffer.clear();
+                }
+                return result;
+            };
+            try {
+                const result = await this.#wfe.userDatabase.transaction(wrappedTransaction, config);
+                span.setStatus({ code: api_1.SpanStatusCode.OK });
+                return result;
+            }
+            catch (err) {
+                if (this.#wfe.userDatabase.isRetriableTransactionError(err)) {
+                    // serialization_failure in PostgreSQL
+                    span.addEvent("TXN SERIALIZATION FAILURE", { retryWaitMillis });
+                    // Retry serialization failures.
+                    await (0, utils_1.sleep)(retryWaitMillis);
+                    retryWaitMillis *= backoffFactor;
+                    continue;
+                }
+                // Record and throw other errors.
+                const e = err;
+                await this.#wfe.userDatabase.transaction(async (client) => {
+                    await this.flushResultBuffer(client);
+                    await this.recordGuardedError(client, funcId, e);
+                }, { isolationLevel: transaction_1.IsolationLevel.ReadCommitted });
+                this.resultBuffer.clear();
+                span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: e.message });
+                throw err;
+            }
+            finally {
+                this.#wfe.tracer.endSpan(span);
+            }
+        }
+    }
+    /**
+     * Execute a communicator function.
+     * If it encounters any error, retry according to its configured retry policy until the maximum number of attempts is reached, then throw an DBOSError.
+     * The communicator may execute many times, but once it is complete, it will not re-execute.
+     */
+    async external(commFn, ...args) {
+        const commConfig = this.#wfe.communicatorConfigMap.get(commFn.name);
+        if (commConfig === undefined) {
+            throw new error_1.DBOSNotRegisteredError(commFn.name);
+        }
+        const funcID = this.functionIDGetIncrement();
+        const span = this.#wfe.tracer.startSpan(commFn.name, {
+            workflowUUID: this.workflowUUID,
+            operationName: commFn.name,
+            runAs: this.authenticatedUser,
+            retriesAllowed: commConfig.retriesAllowed,
+            intervalSeconds: commConfig.intervalSeconds,
+            maxAttempts: commConfig.maxAttempts,
+            backoffRate: commConfig.backoffRate,
+        }, this.span);
+        const ctxt = new communicator_1.CommunicatorContextImpl(this, funcID, span, this.#wfe.logger, commConfig, commFn.name);
+        await this.#wfe.userDatabase.transaction(async (client) => {
+            await this.flushResultBuffer(client);
+        }, { isolationLevel: transaction_1.IsolationLevel.ReadCommitted });
+        this.resultBuffer.clear();
+        // Check if this execution previously happened, returning its original result if it did.
+        const check = await this.#wfe.systemDatabase.checkOperationOutput(this.workflowUUID, ctxt.functionID);
+        if (check !== dbos_executor_1.dbosNull) {
+            ctxt.span.setAttribute("cached", true);
+            ctxt.span.setStatus({ code: api_1.SpanStatusCode.OK });
+            this.#wfe.tracer.endSpan(ctxt.span);
+            return check;
+        }
+        // Execute the communicator function.  If it throws an exception, retry with exponential backoff.
+        // After reaching the maximum number of retries, throw an DBOSError.
+        let result = dbos_executor_1.dbosNull;
+        let err = dbos_executor_1.dbosNull;
+        if (ctxt.retriesAllowed) {
+            let numAttempts = 0;
+            let intervalSeconds = ctxt.intervalSeconds;
+            while (result === dbos_executor_1.dbosNull && numAttempts++ < ctxt.maxAttempts) {
+                try {
+                    result = await commFn(ctxt, ...args);
+                }
+                catch (error) {
+                    if (numAttempts < ctxt.maxAttempts) {
+                        // Sleep for an interval, then increase the interval by backoffRate.
+                        await (0, utils_1.sleep)(intervalSeconds);
+                        intervalSeconds *= ctxt.backoffRate;
+                    }
+                    ctxt.span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: error.message });
+                    this.#wfe.tracer.endSpan(ctxt.span);
+                }
+            }
+        }
+        else {
+            try {
+                result = await commFn(ctxt, ...args);
+            }
+            catch (error) {
+                err = error;
+                ctxt.span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: error.message });
+                this.#wfe.tracer.endSpan(ctxt.span);
+            }
+        }
+        // `result` can only be dbosNull when the communicator timed out
+        if (result === dbos_executor_1.dbosNull) {
+            // Record the error, then throw it.
+            err = err === dbos_executor_1.dbosNull ? new error_1.DBOSError("Communicator reached maximum retries.", 1) : err;
+            await this.#wfe.systemDatabase.recordOperationError(this.workflowUUID, ctxt.functionID, err);
+            ctxt.span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: err.message });
+            this.#wfe.tracer.endSpan(ctxt.span);
+            throw err;
+        }
+        else {
+            // Record the execution and return.
+            await this.#wfe.systemDatabase.recordOperationOutput(this.workflowUUID, ctxt.functionID, result);
+            ctxt.span.setStatus({ code: api_1.SpanStatusCode.OK });
+            this.#wfe.tracer.endSpan(ctxt.span);
+            return result;
+        }
+    }
+    /**
+     * Send a message to a workflow identified by a UUID.
+     * The message can optionally be tagged with a topic.
+     */
+    async send(destinationUUID, message, topic) {
+        const functionID = this.functionIDGetIncrement();
+        await this.#wfe.userDatabase.transaction(async (client) => {
+            await this.flushResultBuffer(client);
+        }, { isolationLevel: transaction_1.IsolationLevel.ReadCommitted });
+        this.resultBuffer.clear();
+        await this.#wfe.systemDatabase.send(this.workflowUUID, functionID, destinationUUID, message, topic);
+    }
+    /**
+     * Consume and return the oldest unconsumed message sent to your UUID.
+     * If a topic is specified, retrieve the oldest message tagged with that topic.
+     * Otherwise, retrieve the oldest message with no topic.
+     */
+    async recv(topic, timeoutSeconds = dbos_executor_1.DBOSExecutor.defaultNotificationTimeoutSec) {
+        const functionID = this.functionIDGetIncrement();
+        await this.#wfe.userDatabase.transaction(async (client) => {
+            await this.flushResultBuffer(client);
+        }, { isolationLevel: transaction_1.IsolationLevel.ReadCommitted });
+        this.resultBuffer.clear();
+        return this.#wfe.systemDatabase.recv(this.workflowUUID, functionID, topic, timeoutSeconds);
+    }
+    /**
+     * Emit a workflow event, represented as a key-value pair.
+     * Events are immutable once set.
+     */
+    async setEvent(key, value) {
+        const functionID = this.functionIDGetIncrement();
+        await this.#wfe.userDatabase.transaction(async (client) => {
+            await this.flushResultBuffer(client);
+        }, { isolationLevel: transaction_1.IsolationLevel.ReadCommitted });
+        this.resultBuffer.clear();
+        await this.#wfe.systemDatabase.setEvent(this.workflowUUID, functionID, key, value);
+    }
+    /**
+     * Generate a proxy object for the provided class that wraps direct calls (i.e. OpClass.someMethod(param))
+     * to use WorkflowContext.Transaction(OpClass.someMethod, param);
+     */
+    invoke(object) {
+        const ops = (0, decorators_1.getRegisteredOperations)(object);
+        const proxy = {};
+        for (const op of ops) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+            proxy[op.name] = op.txnConfig
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                ? (...args) => this.transaction(op.registeredFunction, ...args)
+                : op.commConfig
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                    ? (...args) => this.external(op.registeredFunction, ...args)
+                    : undefined;
+        }
+        return proxy;
+    }
+    /**
+     * Wait for a workflow to emit an event, then return its value.
+     */
+    getEvent(targetUUID, key, timeoutSeconds = dbos_executor_1.DBOSExecutor.defaultNotificationTimeoutSec) {
+        const functionID = this.functionIDGetIncrement();
+        return this.#wfe.systemDatabase.getEvent(targetUUID, key, timeoutSeconds, this.workflowUUID, functionID);
+    }
+    /**
+     * Retrieve a handle for a workflow UUID.
+     */
+    retrieveWorkflow(targetUUID) {
+        const functionID = this.functionIDGetIncrement();
+        return new RetrievedHandle(this.#wfe.systemDatabase, targetUUID, this.workflowUUID, functionID);
+    }
+}
+exports.WorkflowContextImpl = WorkflowContextImpl;
+/**
+ * The handle returned when invoking a workflow with DBOSExecutor.workflow
+ */
+class InvokedHandle {
+    systemDatabase;
+    workflowPromise;
+    workflowUUID;
+    workflowName;
+    callerUUID;
+    callerFunctionID;
+    constructor(systemDatabase, workflowPromise, workflowUUID, workflowName, callerUUID, callerFunctionID) {
+        this.systemDatabase = systemDatabase;
+        this.workflowPromise = workflowPromise;
+        this.workflowUUID = workflowUUID;
+        this.workflowName = workflowName;
+        this.callerUUID = callerUUID;
+        this.callerFunctionID = callerFunctionID;
+    }
+    getWorkflowUUID() {
+        return this.workflowUUID;
+    }
+    async getStatus() {
+        return this.systemDatabase.getWorkflowStatus(this.workflowUUID, this.callerUUID, this.callerFunctionID);
+    }
+    async getResult() {
+        return this.workflowPromise;
+    }
+}
+exports.InvokedHandle = InvokedHandle;
+/**
+ * The handle returned when retrieving a workflow with DBOSExecutor.retrieve
+ */
+class RetrievedHandle {
+    systemDatabase;
+    workflowUUID;
+    callerUUID;
+    callerFunctionID;
+    constructor(systemDatabase, workflowUUID, callerUUID, callerFunctionID) {
+        this.systemDatabase = systemDatabase;
+        this.workflowUUID = workflowUUID;
+        this.callerUUID = callerUUID;
+        this.callerFunctionID = callerFunctionID;
+    }
+    getWorkflowUUID() {
+        return this.workflowUUID;
+    }
+    async getStatus() {
+        return await this.systemDatabase.getWorkflowStatus(this.workflowUUID, this.callerUUID, this.callerFunctionID);
+    }
+    async getResult() {
+        return await this.systemDatabase.getWorkflowResult(this.workflowUUID);
+    }
+}
+exports.RetrievedHandle = RetrievedHandle;
+//# sourceMappingURL=workflow.js.map

package/dist/src/workflow.js.map

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

package/examples/hello/README.md

@@ -0,0 +1,41 @@
+# DBOS Hello
+
+This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `dbos init`.
+
+## Getting Started
+
+First, start the database.
+DBOS workflow works with any Postgres database, but to make things easier, we've provided a nifty script that starts Postgres locally in a Docker container and creates a database:
+
+```bash
+export PGPASSWORD=dbos
+./start_postgres_docker.sh
+```
+
+Then, create some database tables.
+In this quickstart, we use [knex.js](https://knexjs.org/) to manage database migrations.
+Run our provided migration to create a database table:
+
+```bash
+npx knex migrate:latest
+```
+
+Next, build and run the app:
+
+```bash
+npm run build
+npx dbos start
+```
+
+Finally, curl the server to see that it's working!
+
+```bash
+ curl http://localhost:3000/greeting/dbos
+```
+
+You can add more functionality to the app by modifying `src/operations.ts`, then re-building and re-starting it.
+We can help you get started in our [programming quickstart](https://docs.dbos.dev/getting-started/quickstart-programming-1).
+
+## Learn More
+
+To learn more about DBOS, take a look at [our documentation](https://docs.dbos.dev/) or our [source code](https://github.com/dbos-inc/dbos-sdk).

package/examples/hello/dbos-config.yaml

@@ -0,0 +1,15 @@
+# To enable auto-completion and validation for this file in VSCode, install the RedHat YAML extension 
+# https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml
+
+# yaml-language-server: $schema=https://raw.githubusercontent.com/dbos-inc/dbos-sdk/main/dbos-config.schema.json
+
+database:
+  hostname: 'localhost'
+  port: 5432
+  username: 'postgres'
+  password: ${PGPASSWORD}
+  user_database: 'hello'
+  system_database: 'hello_systemdb'
+  connectionTimeoutMillis: 3000
+  user_dbclient: 'knex'
+version: "1.0"

package/examples/hello/jest.config.js

@@ -0,0 +1,8 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testRegex: '((\\.|/)(test|spec))\\.ts?$',
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  modulePaths: ["./"],
+};

package/examples/hello/knexfile.ts

@@ -0,0 +1,23 @@
+// knexfile.ts
+
+import { Knex } from 'knex';
+import { parseConfigFile } from '@dbos-inc/dbos-sdk/dist/src/dbos-runtime/config'
+import { DBOSConfig } from '@dbos-inc/dbos-sdk/dist/src/dbos-executor';
+
+const [dbosConfig, ]: [DBOSConfig, unknown] = parseConfigFile();
+
+const config: Knex.Config = {
+  client: 'pg',
+  connection: {
+    host: dbosConfig.poolConfig.host,
+    user: dbosConfig.poolConfig.user,
+    password: dbosConfig.poolConfig.password,
+    database: dbosConfig.poolConfig.database,
+    ssl: dbosConfig.poolConfig.ssl,
+  },
+  migrations: {
+    directory: './migrations'
+  }
+};
+
+export default config;

package/examples/hello/migrations/create_dbos_hello_tables.ts

@@ -0,0 +1,12 @@
+import { Knex } from "knex";
+
+export async function up(knex: Knex): Promise<void> {
+  return knex.schema.createTable('dbos_hello', table => {
+    table.text('name').primary();
+    table.integer('greet_count').defaultTo(0);
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  return knex.schema.dropTable('dbos_hello');
+}

package/examples/hello/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "dbos-hello",
+  "version": "0.0.1",
+  "scripts": {
+    "build": "tsc",
+    "test": "npx knex migrate:rollback && npx knex migrate:up && jest"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/supertest": "^2.0.14",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "jest": "^29.7.0",
+    "supertest": "^6.3.3",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "dependencies": {
+    "@dbos-inc/dbos-sdk": "../..",
+    "ts-node": "^10.9.1"
+  }
+}

package/examples/hello/src/operations.test.ts

@@ -0,0 +1,38 @@
+import { TestingRuntime, createTestingRuntime } from "@dbos-inc/dbos-sdk";
+import { Hello, dbos_hello } from "./operations";
+import request from "supertest";
+
+describe("operations-test", () => {
+  let testRuntime: TestingRuntime;
+
+  beforeAll(async () => {
+    testRuntime = await createTestingRuntime([Hello]);
+  });
+
+  afterAll(async () => {
+    await testRuntime.destroy();
+  });
+
+  /**
+   * Test the transaction.
+   */
+  test("test-transaction", async () => {
+    const res = await testRuntime.invoke(Hello).helloTransaction("dbos");
+    expect(res).toMatch("Hello, dbos! You have been greeted");
+
+    // Check the greet count.
+    const rows = await testRuntime.queryUserDB<dbos_hello>("SELECT * FROM dbos_hello WHERE name=$1", "dbos");
+    expect(rows[0].greet_count).toBe(1);
+  });
+
+  /**
+   * Test the HTTP endpoint.
+   */
+  test("test-endpoint", async () => {
+    const res = await request(testRuntime.getHandlersCallback()).get(
+      "/greeting/dbos"
+    );
+    expect(res.statusCode).toBe(200);
+    expect(res.text).toMatch("Hello, dbos! You have been greeted");
+  });
+});

package/examples/hello/src/operations.ts

@@ -0,0 +1,21 @@
+import { TransactionContext, Transaction, GetApi, ArgSource, ArgSources } from '@dbos-inc/dbos-sdk'
+import { Knex } from 'knex';
+
+// The schema of the database table used in this example.
+export interface dbos_hello {
+  name: string;
+  greet_count: number;
+}
+
+export class Hello {
+
+  @GetApi('/greeting/:user') // Serve this function from HTTP GET requests to the /greeting endpoint with 'user' as a path parameter
+  @Transaction()  // Run this function as a database transaction
+  static async helloTransaction(ctxt: TransactionContext<Knex>, @ArgSource(ArgSources.URL) user: string) {
+    // Retrieve and increment the number of times this user has been greeted.
+    const query = "INSERT INTO dbos_hello (name, greet_count) VALUES (?, 1) ON CONFLICT (name) DO UPDATE SET greet_count = dbos_hello.greet_count + 1 RETURNING greet_count;"
+    const { rows } = await ctxt.client.raw(query, [user]) as { rows: dbos_hello[] };
+    const greet_count = rows[0].greet_count;
+    return `Hello, ${user}! You have been greeted ${greet_count} times.\n`;
+  }
+}