@dbos-inc/create 1.31.13-preview.g4f38e6e769 → 1.31.16-preview

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbos-inc/create",
-  "version": "1.31.13-preview.g4f38e6e769",
+  "version": "1.31.16-preview",
   "description": "Tool for performing project initialization from template",
   "license": "MIT",
   "type": "module",

package/templates/hello/README.md

@@ -1,6 +1,6 @@
 # DBOS Hello
 
-This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create` and using [Knex](https://docs.dbos.dev/tutorials/using-knex).
+This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create` and using [Knex](https://docs.dbos.dev/typescript/tutorials/orms/using-knex).
 
 ## Getting Started
 
@@ -14,11 +14,11 @@ node start_postgres_docker.js
 
 If successful, the script should print `Database started successfully!`.
 
-Next, you can build and run the app in one step under `nodemon`:
-
+To build the app, set up the database, and run, in one step:
 ```bash
 npm run dev
 ```
+This uses `nodemon`, so if you change your app it will automatically restart with changes.
 
 To see that it's working, visit this URL in your browser: [`http://localhost:3000/greeting/dbos`](http://localhost:3000/greeting/dbos).
 You should get this message: `Hello, dbos! You have been greeted 1 times.`
@@ -26,10 +26,9 @@ Each time you refresh the page, the counter should go up by one!
 
 Congratulations! You just launched a DBOS application.
 
-## Production build
-
-In production, instead of using `nodemon`, the following separate steps should be used to build, run database setup, and start the app.
+### Separate Build and Run Steps
 
+To build the app:
 ```bash
 npm run build
 ```
@@ -37,7 +36,7 @@ npm run build
 Then, run a schema migration to create some tables:
 
 ```bash
-npx dbos-sdk migrate
+npx dbos migrate
 ```
 
 If successful, the migration should print `Migration successful!`.
@@ -45,30 +44,12 @@ If successful, the migration should print `Migration successful!`.
 Finally, run the app:
 
 ```bash
-npx dbos-sdk start
-```
-
-## The application
-
-The core of the application resides in `src/operations.ts`. It declares an "hello world" DBOS workflow served at `/greetings/:user`. To add more functionality, modify `src/operations.ts`. If you used `npm run dev`, it will automatically rebuild and restart.
-
-## Running in DBOS Cloud
-
-To deploy this app to DBOS Cloud, first install the DBOS Cloud CLI (example with [npm](https://www.npmjs.com/)):
-
-```shell
-npm i -g @dbos-inc/dbos-cloud
-```
-
-Then, run this command to deploy your app:
-
-```shell
-dbos-cloud app deploy
+npx dbos start
 ```
 
-functionality to this application, modify `src/operations.ts`. If you used `npm run dev`, it will automatically rebuild and restart.
-
 ## Next Steps
 
-- For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/getting-started/quickstart-programming).
-- 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-transact).
+- To add more functionality to this application, modify `src/operations.ts`, and save it.  If you are using, `npm run dev`, `nodemon` will rebuild and restart the app automatically.
+- For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/typescript/programming-guide).
+- To learn how to deploy your application to DBOS Cloud, visit our [cloud quickstart](https://docs.dbos.dev/quickstart)
+- To learn more about DBOS, take a look at [our documentation](https://docs.dbos.dev/) or our [source code](https://github.com/dbos-inc).

package/templates/hello/package.json

@@ -1,19 +1,15 @@
 {
-  "name": "dbos-hello",
+  "name": "dbos-hello-v2",
   "version": "0.0.1",
   "scripts": {
     "build": "tsc",
     "test": "npx dbos rollback && npx dbos migrate && jest",
-    "lint": "eslint src",
-    "lint-fix": "eslint --fix src",
     "dev": "nodemon",
     "start": "npx dbos start"
   },
   "devDependencies": {
-    "@dbos-inc/eslint-plugin": "^3.3.4",
     "@types/jest": "^29.5.12",
     "@types/supertest": "^2.0.16",
-    "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "nodemon": "^3.1.0",
     "supertest": "^7.0.0",

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

@@ -1,27 +1,26 @@
-import { TestingRuntime, createTestingRuntime } from "@dbos-inc/dbos-sdk";
+import { DBOS } 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();
+    await DBOS.launch();
+    await DBOS.launchAppHTTPServer();
   });
 
   afterAll(async () => {
-    await testRuntime.destroy();
+    await DBOS.shutdown();
   });
 
   /**
    * Test the transaction.
    */
   test("test-transaction", async () => {
-    const res = await testRuntime.invoke(Hello).helloTransaction("dbos");
+    const res = await 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");
+    const rows = await DBOS.executor.queryUserDB("SELECT * FROM dbos_hello WHERE name=$1", ["dbos"]) as dbos_hello[];
     expect(rows[0].greet_count).toBe(1);
   });
 
@@ -29,7 +28,7 @@ describe("operations-test", () => {
    * Test the HTTP endpoint.
    */
   test("test-endpoint", async () => {
-    const res = await request(testRuntime.getHandlersCallback()).get(
+    const res = await request(DBOS.getHTTPHandlersCallback()).get(
       "/greeting/dbos"
     );
     expect(res.statusCode).toBe(200);

package/templates/hello/src/operations.ts

@@ -2,36 +2,34 @@
 
 // This is a sample "Hello" app built with DBOS.
 // It greets visitors and keeps track of how many times each visitor has been greeted.
-// To run this app, visit our Quickstart: https://docs.dbos.dev/getting-started/quickstart
 
-import { HandlerContext, TransactionContext, Transaction, GetApi, ArgSource, ArgSources } from "@dbos-inc/dbos-sdk";
-import { Knex } from "knex";
+// First, let's import DBOS
+import { DBOS } from "@dbos-inc/dbos-sdk";
 
-// The schema of the database table used in this example.
+// Then, let's declare a type representing the "dbos_hello" database table
 export interface dbos_hello {
   name: string;
   greet_count: number;
 }
 
+// Now let's define a class with some static functions.
+// DBOS uses TypeScript decorators to automatically make your functions reliable, so they need to be static.
 export class Hello {
   // Serve this function from HTTP GET requests at the /greeting endpoint with 'user' as a path parameter
-  // The @Transaction() decorator ensures that this function runs as a database transaction.
-  @GetApi("/greeting/:user")
-  @Transaction() // Run this function as a database transaction
-  static async helloTransaction(ctxt: TransactionContext<Knex>, @ArgSource(ArgSources.URL) user: string) {
+  @DBOS.getApi("/greeting/:user")
+  @DBOS.transaction() // Run this function as a database transaction
+  static async helloTransaction(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 { rows } = (await DBOS.knexClient.raw(query, [user])) as { rows: dbos_hello[] };
     const greet_count = rows[0].greet_count;
     const greeting = `Hello, ${user}! You have been greeted ${greet_count} times.`;
     return Hello.makeHTML(greeting);
   }
 
-  // Let's declare helper functions to serve static HTML
-
   // Serve a quick readme for the app at the / endpoint
-  @GetApi('/')
-  static async readme(_ctxt: HandlerContext) {
+  @DBOS.getApi("/")
+  static async readme() {
     const message = Hello.makeHTML(
       `Visit the route <code class="bg-gray-100 px-1 rounded">/greeting/{name}</code> to be greeted!<br>
       For example, visit <code class="bg-gray-100 px-1 rounded"><a href="/greeting/Mike" class="text-blue-600 hover:underline">/greeting/Mike</a></code><br>

package/templates/{hello-v2 → hello-contexts}/README.md

@@ -1,6 +1,8 @@
 # DBOS Hello
 
-This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create` and using [Knex](https://docs.dbos.dev/tutorials/using-knex).
+*NOTE:* This is an older version of the DBOS `hello` app that uses a previous API based on passing [DBOS contexts](https://docs.dbos.dev/typescript/reference/transactapi/oldapi/contexts) around as function arguments.
+
+This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create` and using [Knex](https://docs.dbos.dev/typescript/tutorials/orms/using-knex).
 
 ## Getting Started
 
@@ -14,11 +16,11 @@ node start_postgres_docker.js
 
 If successful, the script should print `Database started successfully!`.
 
-To build the app, set up the database, and run, in one step:
+Next, you can build and run the app in one step under `nodemon`:
+
 ```bash
 npm run dev
 ```
-This uses `nodemon`, so if you change your app it will automatically restart with changes.
 
 To see that it's working, visit this URL in your browser: [`http://localhost:3000/greeting/dbos`](http://localhost:3000/greeting/dbos).
 You should get this message: `Hello, dbos! You have been greeted 1 times.`
@@ -26,9 +28,10 @@ Each time you refresh the page, the counter should go up by one!
 
 Congratulations! You just launched a DBOS application.
 
-### Separate Build and Run Steps
+## Production build
+
+In production, instead of using `nodemon`, the following separate steps should be used to build, run database setup, and start the app.
 
-To build the app:
 ```bash
 npm run build
 ```
@@ -36,7 +39,7 @@ npm run build
 Then, run a schema migration to create some tables:
 
 ```bash
-npx dbos-sdk migrate
+npx dbos migrate
 ```
 
 If successful, the migration should print `Migration successful!`.
@@ -44,12 +47,30 @@ If successful, the migration should print `Migration successful!`.
 Finally, run the app:
 
 ```bash
-npx dbos-sdk start
+npx dbos start
 ```
 
+## The application
+
+The core of the application resides in `src/operations.ts`. It declares an "hello world" DBOS workflow served at `/greetings/:user`. To add more functionality, modify `src/operations.ts`. If you used `npm run dev`, it will automatically rebuild and restart.
+
+## Running in DBOS Cloud
+
+To deploy this app to DBOS Cloud, first install the DBOS Cloud CLI (example with [npm](https://www.npmjs.com/)):
+
+```shell
+npm i -g @dbos-inc/dbos-cloud
+```
+
+Then, run this command to deploy your app:
+
+```shell
+dbos-cloud app deploy
+```
+
+functionality to this application, modify `src/operations.ts`. If you used `npm run dev`, it will automatically rebuild and restart.
+
 ## Next Steps
 
-- To add more functionality to this application, modify `src/operations.ts`, and save it.  If you are using, `npm run dev`, `nodemon` will rebuild and restart the app automatically.
 - For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/getting-started/quickstart-programming).
-- To learn how to deploy your application to DBOS Cloud, visit our [cloud quickstart](https://docs.dbos.dev/getting-started/quickstart-cloud/)
 - 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-transact).

package/templates/{hello-v2 → hello-contexts}/package.json

@@ -1,15 +1,19 @@
 {
-  "name": "dbos-hello-v2",
+  "name": "dbos-hello",
   "version": "0.0.1",
   "scripts": {
     "build": "tsc",
     "test": "npx dbos rollback && npx dbos migrate && jest",
+    "lint": "eslint src",
+    "lint-fix": "eslint --fix src",
     "dev": "nodemon",
     "start": "npx dbos start"
   },
   "devDependencies": {
+    "@dbos-inc/eslint-plugin": "^3.3.4",
     "@types/jest": "^29.5.12",
     "@types/supertest": "^2.0.16",
+    "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "nodemon": "^3.1.0",
     "supertest": "^7.0.0",

package/templates/{hello-v2 → hello-contexts}/src/operations.test.ts

@@ -1,26 +1,27 @@
-import { DBOS } from "@dbos-inc/dbos-sdk";
+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 () => {
-    await DBOS.launch();
-    await DBOS.launchAppHTTPServer();
+    testRuntime = await createTestingRuntime();
   });
 
   afterAll(async () => {
-    await DBOS.shutdown();
+    await testRuntime.destroy();
   });
 
   /**
    * Test the transaction.
    */
   test("test-transaction", async () => {
-    const res = await Hello.helloTransaction("dbos");
+    const res = await testRuntime.invoke(Hello).helloTransaction("dbos");
     expect(res).toMatch("Hello, dbos! You have been greeted");
 
     // Check the greet count.
-    const rows = await DBOS.executor.queryUserDB("SELECT * FROM dbos_hello WHERE name=$1", ["dbos"]) as dbos_hello[];
+    const rows = await testRuntime.queryUserDB<dbos_hello>("SELECT * FROM dbos_hello WHERE name=$1", "dbos");
     expect(rows[0].greet_count).toBe(1);
   });
 
@@ -28,7 +29,7 @@ describe("operations-test", () => {
    * Test the HTTP endpoint.
    */
   test("test-endpoint", async () => {
-    const res = await request(DBOS.getHTTPHandlersCallback()).get(
+    const res = await request(testRuntime.getHandlersCallback()).get(
       "/greeting/dbos"
     );
     expect(res.statusCode).toBe(200);

package/templates/{hello-v2 → hello-contexts}/src/operations.ts

@@ -2,34 +2,36 @@
 
 // This is a sample "Hello" app built with DBOS.
 // It greets visitors and keeps track of how many times each visitor has been greeted.
+// To run this app, visit our Quickstart: https://docs.dbos.dev/getting-started/quickstart
 
-// First, let's import DBOS
-import { DBOS } from "@dbos-inc/dbos-sdk";
+import { HandlerContext, TransactionContext, Transaction, GetApi, ArgSource, ArgSources } from "@dbos-inc/dbos-sdk";
+import { Knex } from "knex";
 
-// Then, let's declare a type representing the "dbos_hello" database table
+// The schema of the database table used in this example.
 export interface dbos_hello {
   name: string;
   greet_count: number;
 }
 
-// Now let's define a class with some static functions.
-// DBOS uses TypeScript decorators to automatically make your functions reliable, so they need to be static.
 export class Hello {
   // Serve this function from HTTP GET requests at the /greeting endpoint with 'user' as a path parameter
-  @DBOS.getApi("/greeting/:user")
-  @DBOS.transaction() // Run this function as a database transaction
-  static async helloTransaction(user: string) {
+  // The @Transaction() decorator ensures that this function runs as a database transaction.
+  @GetApi("/greeting/:user")
+  @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 DBOS.knexClient.raw(query, [user])) as { rows: dbos_hello[] };
+    const { rows } = await ctxt.client.raw(query, [user]) as { rows: dbos_hello[] };
     const greet_count = rows[0].greet_count;
     const greeting = `Hello, ${user}! You have been greeted ${greet_count} times.`;
     return Hello.makeHTML(greeting);
   }
 
+  // Let's declare helper functions to serve static HTML
+
   // Serve a quick readme for the app at the / endpoint
-  @DBOS.getApi("/")
-  static async readme() {
+  @GetApi('/')
+  static async readme(_ctxt: HandlerContext) {
     const message = Hello.makeHTML(
       `Visit the route <code class="bg-gray-100 px-1 rounded">/greeting/{name}</code> to be greeted!<br>
       For example, visit <code class="bg-gray-100 px-1 rounded"><a href="/greeting/Mike" class="text-blue-600 hover:underline">/greeting/Mike</a></code><br>

package/templates/hello-drizzle/README.md

@@ -1,6 +1,6 @@
 # DBOS Hello with Drizzle
 
-This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create` and using [Drizzle](https://docs.dbos.dev/tutorials/using-drizzle).
+This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create` and using [Drizzle](https://docs.dbos.dev/typescript/tutorials/orms/using-drizzle).
 
 ## Getting Started
 
@@ -23,7 +23,7 @@ npm run build
 Then, run a schema migration to create some tables:
 
 ```bash
-npx dbos-sdk migrate
+npx dbos migrate
 ```
 
 If successful, the migration should print `Migration successful!`.
@@ -31,7 +31,7 @@ If successful, the migration should print `Migration successful!`.
 Finally, run the app:
 
 ```bash
-npx dbos-sdk start
+npx dbos start
 ```
 
 To see that it's working, visit this URL in your browser: [`http://localhost:3000/greeting/dbos`](http://localhost:3000/greeting/dbos).
@@ -43,6 +43,6 @@ Congratulations! You just launched a DBOS application.
 ## Next Steps
 
 - To add more functionality to this application, modify `src/operations.ts`, then rebuild and restart it.  Alternatively, `npm run dev` uses `nodemon` to automatically rebuild and restart the app when source files change, using instructions specified in `nodemon.json`.
-- For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/getting-started/quickstart-programming).
-- To learn how to deploy your application to DBOS Cloud, visit our [cloud quickstart](https://docs.dbos.dev/getting-started/quickstart-cloud/)
-- 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-transact).
+- For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/typescript/programming-guide).
+- To learn how to deploy your application to DBOS Cloud, visit our [cloud quickstart](https://docs.dbos.dev/quickstart)
+- To learn more about DBOS, take a look at [our documentation](https://docs.dbos.dev/) or our [source code](https://github.com/dbos-inc).

package/templates/hello-drizzle/package.json

@@ -13,7 +13,7 @@
     "@dbos-inc/eslint-plugin": "^3.3.4",
     "@types/jest": "^29.5.12",
     "@types/supertest": "^2.0.16",
-    "drizzle-kit": "^0.23.2",
+    "drizzle-kit": "^0.30.1",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "nodemon": "^3.1.0",
@@ -23,6 +23,6 @@
   },
   "dependencies": {
     "@dbos-inc/dbos-sdk": "file:../../../..",
-    "drizzle-orm": "^0.32.2"
+    "drizzle-orm": "^0.38.3"
   }
 }

package/templates/hello-drizzle/src/operations.test.ts

@@ -1,27 +1,26 @@
-import { TestingRuntime, createTestingRuntime } from "@dbos-inc/dbos-sdk";
+import { DBOS } from "@dbos-inc/dbos-sdk";
 import { Hello } from "./operations";
 import request from "supertest";
 
 describe("operations-test", () => {
-  let testRuntime: TestingRuntime;
-
   beforeAll(async () => {
-    testRuntime = await createTestingRuntime();
+    await DBOS.launch();
+    await DBOS.launchAppHTTPServer();
   });
 
   afterAll(async () => {
-    await testRuntime.destroy();
+    await DBOS.shutdown();
   });
 
   /**
    * Test the transaction.
    */
   test("test-transaction", async () => {
-    const res = await testRuntime.invoke(Hello).helloTransaction("dbos");
+    const res = await Hello.helloTransaction("dbos");
     expect(res).toMatch("Hello, dbos! We have made");
 
     // Check the greet count.
-    const rows = await testRuntime.queryUserDB("SELECT * FROM dbos_hello WHERE greet_count=1");
+    const rows = await DBOS.executor.queryUserDB("SELECT * FROM dbos_hello WHERE greet_count=1");
     expect(rows.length).toEqual(1);
   });
 
@@ -29,7 +28,7 @@ describe("operations-test", () => {
    * Test the HTTP endpoint.
    */
   test("test-endpoint", async () => {
-    const res = await request(testRuntime.getHandlersCallback()).get(
+    const res = await request(DBOS.getHTTPHandlersCallback()).get(
       "/greeting/dbos"
     );
     expect(res.statusCode).toBe(200);

package/templates/hello-drizzle/src/operations.ts

@@ -3,25 +3,25 @@
 // This is the Quickstart Drizzle template app. It greets visitors, counting how many total greetings were made.
 // To learn how to run this app, visit the Drizzle tutorial: https://docs.dbos.dev/tutorials/using-drizzle
 
-import { HandlerContext, TransactionContext, Transaction, GetApi } from '@dbos-inc/dbos-sdk';
+import { DBOS } from '@dbos-inc/dbos-sdk';
 import { dbosHello } from './schema';
 import { NodePgDatabase } from 'drizzle-orm/node-postgres';
 
 export class Hello {
 
   // Serve this function from HTTP GET requests at the /greeting endpoint with 'user' as a path parameter
-  @GetApi('/greeting/:user')
-  @Transaction()
-  static async helloTransaction(ctxt: TransactionContext<NodePgDatabase>, user: string) {
+  @DBOS.getApi('/greeting/:user')
+  @DBOS.transaction()
+  static async helloTransaction(user: string) {
     const greeting = `Hello, ${user}!`;
-    const greetings_output = await ctxt.client.insert(dbosHello).values({greeting}).returning({greet_count: dbosHello.greet_count});
+    const greetings_output = await (DBOS.drizzleClient as NodePgDatabase).insert(dbosHello).values({greeting}).returning({greet_count: dbosHello.greet_count});
     const greeting_message = `${greeting} We have made ${greetings_output[0].greet_count} greetings.`;
     return Hello.makeHTML(greeting_message);
   }
 
   // Serve a quick readme for the app at the / endpoint
-  @GetApi('/')
-  static async readme(_ctxt: HandlerContext) {
+  @DBOS.getApi('/')
+  static async readme() {
     const message = Hello.makeHTML(
       `Visit the route <code class="bg-gray-100 px-1 rounded">/greeting/{name}</code> to be greeted!<br>
       For example, visit <code class="bg-gray-100 px-1 rounded"><a href="/greeting/Mike" class="text-blue-600 hover:underline">/greeting/Mike</a></code><br>

package/templates/hello-express/README.md

@@ -1,6 +1,6 @@
 # DBOS Hello
 
-This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create`, using [Express.js](https://expressjs.com/) and [Knex](https://docs.dbos.dev/tutorials/using-knex) to interact with postgres.
+This is a [DBOS app](https://docs.dbos.dev/) bootstrapped with `npx @dbos-inc/create`, using [Express.js](https://expressjs.com/) and [Knex](https://docs.dbos.dev/typescript/tutorials/orms/using-knex) to interact with postgres.
 
 ## Getting Started
 
@@ -37,7 +37,7 @@ npm run build
 Then, run a schema migration to create some tables:
 
 ```bash
-npx dbos-sdk migrate
+npx dbos migrate
 ```
 
 If successful, the migration should print `Migration successful!`.
@@ -45,15 +45,17 @@ If successful, the migration should print `Migration successful!`.
 Finally, run the app:
 
 ```bash
-npx dbos-sdk start
+npx dbos start
 ```
 
 ## The application
 
-- In `src/operations.ts`, the Express app object is created and configured to serve an "hello world" DBOS workflow on `/greetings/:user`. This file also hosts the code of said DBOS workflow: an `Hello` class with a single `helloTransaction` method.
-- `src/main.ts` declares the code to start a DBOS instance and an Express application. When you pass the Express app object as parameter to `DBOS.launch()`, DBOS will wrap all routes with an [OpenTelemetry](https://opentelemetry.io/) tracing middleware and tie HTTP traces to DBOS workflow traces.
+In `src/main.ts`, the Express app object is created and configured to serve an "hello world" DBOS workflow on `/greetings/:user`. This file also hosts the code of said DBOS workflow: an `Hello` class with a single `helloTransaction` method.
 
-To add more functionality to this application, modify `src/operations.ts`. If you used `npm run dev`, it will automatically rebuild and restart.
+
+Then the `main()` function declares the code to start a DBOS instance and an Express application. When you pass the Express app object as parameter to `DBOS.launch()`, DBOS will wrap all routes with an [OpenTelemetry](https://opentelemetry.io/) tracing middleware and tie HTTP traces to DBOS workflow traces.
+
+To add more functionality to this application, modify `src/main.ts`. If you used `npm run dev`, it will automatically rebuild and restart.
 
 ## Running in DBOS Cloud
 
@@ -71,5 +73,5 @@ dbos-cloud app deploy
 
 ## Next Steps
 
-- For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/getting-started/quickstart-programming).
-- 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-transact).
+- For a detailed tutorial, check out our [programming quickstart](https://docs.dbos.dev/typescript/programming-guide).
+- To learn more about DBOS, take a look at [our documentation](https://docs.dbos.dev/) or our [source code](https://github.com/dbos-inc).

package/templates/hello-express/dbos-config.yaml

@@ -17,4 +17,4 @@ database:
     - npx knex migrate:rollback
 runtimeConfig:
   start:
-    - dist/main.js
+    - node dist/main.js

package/templates/hello-express/src/main.test.ts

@@ -1,5 +1,5 @@
 import { DBOS } from "@dbos-inc/dbos-sdk";
-import { app, dbos_hello, Hello } from "./operations";
+import { app, dbos_hello, Hello } from "./main";
 import request from "supertest";
 
 describe("operations-test", () => {