From 77e4313363d9c5664dc58e7a7001872d68df92a8 Mon Sep 17 00:00:00 2001
From: Tim Leung <tleung@palantir.com>
Date: Wed, 7 Feb 2024 11:10:58 +0000
Subject: [PATCH] Refactor create-app prompts with tests (#32)

---
 .../changelog/@unreleased/pr-32.v2.yml        |   5 +
 packages/create-app/src/cli.ts                | 226 +-----------------
 .../src/prompts/promptApplicationUrl.test.ts  |  76 ++++++
 .../src/prompts/promptApplicationUrl.ts       |  63 +++++
 .../src/prompts/promptClientId.test.ts        |  49 ++++
 .../create-app/src/prompts/promptClientId.ts  |  37 +++
 .../src/prompts/promptFoundryUrl.test.ts      |  59 +++++
 .../src/prompts/promptFoundryUrl.ts           |  37 +++
 .../src/prompts/promptOsdkPackage.test.ts     |  54 +++++
 .../src/prompts/promptOsdkPackage.ts          |  37 +++
 .../src/prompts/promptOsdkRegistryUrl.test.ts |  63 +++++
 .../src/prompts/promptOsdkRegistryUrl.ts      |  45 ++++
 .../src/prompts/promptOverwrite.test.ts       |  52 ++++
 .../create-app/src/prompts/promptOverwrite.ts |  66 +++++
 .../src/prompts/promptProject.test.ts         |  53 ++++
 .../create-app/src/prompts/promptProject.ts   |  36 +++
 .../src/prompts/promptTemplate.test.ts        |  47 ++++
 .../create-app/src/prompts/promptTemplate.ts  |  52 ++++
 18 files changed, 841 insertions(+), 216 deletions(-)
 create mode 100644 packages/create-app/changelog/@unreleased/pr-32.v2.yml
 create mode 100644 packages/create-app/src/prompts/promptApplicationUrl.test.ts
 create mode 100644 packages/create-app/src/prompts/promptApplicationUrl.ts
 create mode 100644 packages/create-app/src/prompts/promptClientId.test.ts
 create mode 100644 packages/create-app/src/prompts/promptClientId.ts
 create mode 100644 packages/create-app/src/prompts/promptFoundryUrl.test.ts
 create mode 100644 packages/create-app/src/prompts/promptFoundryUrl.ts
 create mode 100644 packages/create-app/src/prompts/promptOsdkPackage.test.ts
 create mode 100644 packages/create-app/src/prompts/promptOsdkPackage.ts
 create mode 100644 packages/create-app/src/prompts/promptOsdkRegistryUrl.test.ts
 create mode 100644 packages/create-app/src/prompts/promptOsdkRegistryUrl.ts
 create mode 100644 packages/create-app/src/prompts/promptOverwrite.test.ts
 create mode 100644 packages/create-app/src/prompts/promptOverwrite.ts
 create mode 100644 packages/create-app/src/prompts/promptProject.test.ts
 create mode 100644 packages/create-app/src/prompts/promptProject.ts
 create mode 100644 packages/create-app/src/prompts/promptTemplate.test.ts
 create mode 100644 packages/create-app/src/prompts/promptTemplate.ts

diff --git a/packages/create-app/changelog/@unreleased/pr-32.v2.yml b/packages/create-app/changelog/@unreleased/pr-32.v2.yml
new file mode 100644
index 000000000..49727a65d
--- /dev/null
+++ b/packages/create-app/changelog/@unreleased/pr-32.v2.yml
@@ -0,0 +1,5 @@
+type: improvement
+improvement:
+  description: Refactor create-app prompts and add unit tests
+  links:
+  - https://github.com/palantir/osdk-ts/pull/32
diff --git a/packages/create-app/src/cli.ts b/packages/create-app/src/cli.ts
index 9614f6a54..1db28479f 100644
--- a/packages/create-app/src/cli.ts
+++ b/packages/create-app/src/cli.ts
@@ -28,9 +28,16 @@ import {
   generateEnvProduction,
 } from "./generate/generateEnv.js";
 import { generateNpmRc } from "./generate/generateNpmRc.js";
-import { green, italic } from "./highlight.js";
+import { green } from "./highlight.js";
+import { promptApplicationUrl } from "./prompts/promptApplicationUrl.js";
+import { promptClientId } from "./prompts/promptClientId.js";
+import { promptFoundryUrl } from "./prompts/promptFoundryUrl.js";
+import { promptOsdkPackage } from "./prompts/promptOsdkPackage.js";
+import { promptOsdkRegistryUrl } from "./prompts/promptOsdkRegistryUrl.js";
+import { promptOverwrite } from "./prompts/promptOverwrite.js";
+import { promptProject } from "./prompts/promptProject.js";
+import { promptTemplate } from "./prompts/promptTemplate.js";
 import type { Template, TemplateContext } from "./templates.js";
-import { TEMPLATES } from "./templates.js";
 
 interface CliArgs {
   project?: string;
@@ -95,7 +102,7 @@ export async function cli(args: string[] = process.argv) {
 
   const parsed: CliArgs = base.parseSync();
   const project: string = await promptProject(parsed);
-  const overwrite: boolean = await promptOverwrite(parsed, project);
+  const overwrite: boolean = await promptOverwrite({ ...parsed, project });
   const template: Template = await promptTemplate(parsed);
   const foundryUrl: string = await promptFoundryUrl(parsed);
   const applicationUrl: string | undefined = await promptApplicationUrl(parsed);
@@ -194,216 +201,3 @@ export async function cli(args: string[] = process.argv) {
     },
   });
 }
-
-async function promptProject(parsed: CliArgs): Promise<string> {
-  let project = parsed.project;
-  while (project == null || !/^[a-zA-Z0-9-_]+$/.test(project)) {
-    if (project != null) {
-      consola.fail(
-        "Project name can only contain alphanumeric characters, hyphens and underscores",
-      );
-    }
-    project = await consola.prompt("Project name:", {
-      type: "text",
-      placeholder: "my-osdk-app",
-      default: "my-osdk-app",
-    });
-  }
-
-  return project;
-}
-
-async function promptOverwrite(
-  parsed: CliArgs,
-  project: string,
-): Promise<boolean> {
-  if (!fs.existsSync(path.join(process.cwd(), project))) {
-    return true;
-  }
-
-  if (parsed.overwrite != null) {
-    return parsed.overwrite;
-  }
-
-  const result = (await consola.prompt(
-    `The directory ${
-      green(
-        project,
-      )
-    } already exists do you want to overwrite or ignore it?`,
-    {
-      type: "select",
-      options: [
-        { label: "Remove existing files and continue", value: "overwrite" },
-        { label: "Ignore files and continue", value: "ignore" },
-        { label: "Cancel", value: "cancel" },
-      ],
-    },
-    // Types for "select" are wrong the value is returned rather than the option object
-    // https://github.com/unjs/consola/pull/238
-  )) as unknown as "overwrite" | "ignore" | "cancel";
-
-  switch (result) {
-    case "overwrite":
-      return true;
-    case "ignore":
-      return false;
-    case "cancel":
-      consola.fail("Operation cancelled");
-      process.exit(0);
-  }
-}
-
-async function promptTemplate(parsed: CliArgs): Promise<Template> {
-  let template = TEMPLATES.find((t) => t.id === parsed.template);
-  if (template == null) {
-    const templateId = (await consola.prompt(
-      parsed.template != null
-        ? `The provided template ${
-          green(
-            parsed.template,
-          )
-        } is invalid please select a framework:`
-        : "Select a framework:",
-      {
-        type: "select",
-        options: TEMPLATES.map((template) => ({
-          value: template.id,
-          label: template.label,
-        })),
-        // Types for "select" are wrong the value is returned rather than the option object
-        // https://github.com/unjs/consola/pull/238
-      },
-    )) as unknown as string;
-
-    template = TEMPLATES.find((t) => t.id === templateId);
-    if (template == null) {
-      throw new Error(`Template ${templateId} should be found`);
-    }
-  }
-
-  return template;
-}
-
-async function promptFoundryUrl(parsed: CliArgs): Promise<string> {
-  let foundryUrl = parsed.foundryUrl;
-  while (foundryUrl == null || !foundryUrl.startsWith("https://")) {
-    if (foundryUrl != null) {
-      consola.fail("Please enter a valid Foundry URL");
-    }
-    foundryUrl = await consola.prompt(
-      `Enter the URL for your Foundry stack:\n${
-        italic(
-          "(Example https://example.palantirfoundry.com/)",
-        )
-      }`,
-      { type: "text" },
-    );
-  }
-  return foundryUrl.replace(/\/$/, "");
-}
-
-async function promptApplicationUrl(
-  parsed: CliArgs,
-): Promise<string | undefined> {
-  if (parsed.skipApplicationUrl) {
-    return undefined;
-  }
-
-  let applicationUrl = parsed.applicationUrl;
-  if (applicationUrl == null) {
-    const skip = (await consola.prompt(
-      `Do you know the URL your production application will be hosted on? This is required to create a production build of your application with the correct OAuth redirect URL.`,
-      {
-        type: "select",
-        options: [
-          { label: "Yes, prefill it for me", value: "yes" },
-          { label: "No, I will fill it in myself later", value: "no" },
-        ],
-      },
-      // Types for "select" are wrong the value is returned rather than the option object
-      // https://github.com/unjs/consola/pull/238
-    )) as unknown as "yes" | "no";
-
-    if (skip === "no") {
-      return undefined;
-    }
-  }
-
-  while (applicationUrl == null || !/^https?:\/\//.test(applicationUrl)) {
-    if (applicationUrl != null) {
-      consola.fail("Please enter a valid application URL");
-    }
-    applicationUrl = await consola.prompt(
-      `Enter the URL your production application will be hosted on:\n${
-        italic(
-          "(Example https://myapp.example.palantirfoundry.com/)",
-        )
-      }`,
-      { type: "text" },
-    );
-  }
-  return applicationUrl.replace(/\/$/, "");
-}
-
-async function promptClientId(parsed: CliArgs): Promise<string> {
-  let clientId = parsed.clientId;
-  while (clientId == null || !/^[0-9a-f]+$/.test(clientId)) {
-    if (clientId != null) {
-      consola.fail("Please enter a valid OAuth client ID");
-    }
-    clientId = await consola.prompt(
-      `Enter the OAuth client ID for your application from Developer Console:\n${
-        italic(
-          "(Example 2650385ab6c5e0df3b44aff776b00a42)",
-        )
-      }`,
-      { type: "text" },
-    );
-  }
-  return clientId;
-}
-
-async function promptOsdkPackage(parsed: CliArgs): Promise<string> {
-  let osdkPackage = parsed.osdkPackage;
-  while (osdkPackage == null || !/^@[a-z0-9-]+\/sdk$/.test(osdkPackage)) {
-    if (osdkPackage != null) {
-      consola.fail("Please enter a valid OSDK package name");
-    }
-    osdkPackage = await consola.prompt(
-      `Enter the OSDK package name for your application from Developer Console:\n${
-        italic(
-          "(Example @my-app/sdk)",
-        )
-      }`,
-      { type: "text" },
-    );
-  }
-  return osdkPackage;
-}
-
-async function promptOsdkRegistryUrl(parsed: CliArgs): Promise<string> {
-  let osdkRegistryUrl = parsed.osdkRegistryUrl;
-  while (
-    osdkRegistryUrl == null
-    || !/^https:\/\/[^/]+\/artifacts\/api\/repositories\/ri\.artifacts\.[^/]+\/contents\/release\/npm\/?$/
-      .test(
-        osdkRegistryUrl,
-      )
-  ) {
-    if (osdkRegistryUrl != null) {
-      consola.fail(
-        "Please enter a valid NPM registry URL to install your OSDK package",
-      );
-    }
-    osdkRegistryUrl = await consola.prompt(
-      `Enter the NPM registry URL to install your OSDK package from Developer Console:\n${
-        italic(
-          "(Example https://example.palantirfoundry.com/artifacts/api/repositories/ri.artifacts.main.repository.a4a7fe1c-486f-4226-b706-7b90005f527d/contents/release/npm)",
-        )
-      }`,
-      { type: "text" },
-    );
-  }
-  return osdkRegistryUrl.replace(/\/$/, "");
-}
diff --git a/packages/create-app/src/prompts/promptApplicationUrl.test.ts b/packages/create-app/src/prompts/promptApplicationUrl.test.ts
new file mode 100644
index 000000000..5bc4a9619
--- /dev/null
+++ b/packages/create-app/src/prompts/promptApplicationUrl.test.ts
@@ -0,0 +1,76 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptApplicationUrl } from "./promptApplicationUrl.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+const valid = "https://app.com";
+
+test("it accepts valid application url from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("yes");
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptApplicationUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(2);
+});
+
+test("it prompts again if answered value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("yes");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("invalid");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("ftp://abc.com");
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptApplicationUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(4);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptApplicationUrl({ applicationUrl: valid })).toEqual(valid);
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptApplicationUrl({ applicationUrl: "invalid" })).toEqual(
+    valid,
+  );
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it strips trailing slash from url", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("yes");
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid + "/");
+  expect(await promptApplicationUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(2);
+});
+
+test("it skips prompting application url if told to fill in later", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("no");
+  expect(await promptApplicationUrl({})).toEqual(undefined);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it skips prompting completely if told to", async () => {
+  expect(await promptApplicationUrl({ skipApplicationUrl: true })).toEqual(
+    undefined,
+  );
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
diff --git a/packages/create-app/src/prompts/promptApplicationUrl.ts b/packages/create-app/src/prompts/promptApplicationUrl.ts
new file mode 100644
index 000000000..dd7550081
--- /dev/null
+++ b/packages/create-app/src/prompts/promptApplicationUrl.ts
@@ -0,0 +1,63 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+import { italic } from "../highlight.js";
+
+export async function promptApplicationUrl(
+  { skipApplicationUrl, applicationUrl }: {
+    skipApplicationUrl?: boolean;
+    applicationUrl?: string;
+  },
+): Promise<string | undefined> {
+  if (skipApplicationUrl) {
+    return undefined;
+  }
+
+  if (applicationUrl == null) {
+    const skip = (await consola.prompt(
+      `Do you know the URL your production application will be hosted on? This is required to create a production build of your application with the correct OAuth redirect URL.`,
+      {
+        type: "select",
+        options: [
+          { label: "Yes, prefill it for me", value: "yes" },
+          { label: "No, I will fill it in myself later", value: "no" },
+        ],
+      },
+      // Types for "select" are wrong the value is returned rather than the option object
+      // https://github.com/unjs/consola/pull/238
+    )) as unknown as "yes" | "no";
+
+    if (skip === "no") {
+      return undefined;
+    }
+  }
+
+  while (applicationUrl == null || !/^https?:\/\//.test(applicationUrl)) {
+    if (applicationUrl != null) {
+      consola.fail("Please enter a valid application URL");
+    }
+    applicationUrl = await consola.prompt(
+      `Enter the URL your production application will be hosted on:\n${
+        italic(
+          "(Example https://myapp.example.palantirfoundry.com/)",
+        )
+      }`,
+      { type: "text" },
+    );
+  }
+  return applicationUrl.replace(/\/$/, "");
+}
diff --git a/packages/create-app/src/prompts/promptClientId.test.ts b/packages/create-app/src/prompts/promptClientId.test.ts
new file mode 100644
index 000000000..62a67d6f6
--- /dev/null
+++ b/packages/create-app/src/prompts/promptClientId.test.ts
@@ -0,0 +1,49 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptClientId } from "./promptClientId.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test("it accepts valid client id from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("123abc");
+  expect(await promptClientId({})).toEqual("123abc");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it prompts again if answered value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("***invalid***");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("123abc");
+  expect(await promptClientId({})).toEqual("123abc");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(2);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptClientId({ clientId: "123abc" })).toEqual("123abc");
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("123abc");
+  expect(await promptClientId({ clientId: "***invalid***" })).toEqual("123abc");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
diff --git a/packages/create-app/src/prompts/promptClientId.ts b/packages/create-app/src/prompts/promptClientId.ts
new file mode 100644
index 000000000..5b07821be
--- /dev/null
+++ b/packages/create-app/src/prompts/promptClientId.ts
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+import { italic } from "../highlight.js";
+
+export async function promptClientId(
+  { clientId }: { clientId?: string },
+): Promise<string> {
+  while (clientId == null || !/^[0-9a-f]+$/.test(clientId)) {
+    if (clientId != null) {
+      consola.fail("Please enter a valid OAuth client ID");
+    }
+    clientId = await consola.prompt(
+      `Enter the OAuth client ID for your application from Developer Console:\n${
+        italic(
+          "(Example 2650385ab6c5e0df3b44aff776b00a42)",
+        )
+      }`,
+      { type: "text" },
+    );
+  }
+  return clientId;
+}
diff --git a/packages/create-app/src/prompts/promptFoundryUrl.test.ts b/packages/create-app/src/prompts/promptFoundryUrl.test.ts
new file mode 100644
index 000000000..0484bde8c
--- /dev/null
+++ b/packages/create-app/src/prompts/promptFoundryUrl.test.ts
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptFoundryUrl } from "./promptFoundryUrl.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+const valid = "https://example.palantirfoundry.com";
+
+test("it accepts valid foundry url from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptFoundryUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it prompts again if answered value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("invalid");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("ftp://abc.com");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("http://abc.com");
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptFoundryUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(4);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptFoundryUrl({ foundryUrl: valid })).toEqual(valid);
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptFoundryUrl({ foundryUrl: "invalid" })).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it strips trailing slash from url", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid + "/");
+  expect(await promptFoundryUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
diff --git a/packages/create-app/src/prompts/promptFoundryUrl.ts b/packages/create-app/src/prompts/promptFoundryUrl.ts
new file mode 100644
index 000000000..d7e16b24f
--- /dev/null
+++ b/packages/create-app/src/prompts/promptFoundryUrl.ts
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+import { italic } from "../highlight.js";
+
+export async function promptFoundryUrl(
+  { foundryUrl }: { foundryUrl?: string },
+): Promise<string> {
+  while (foundryUrl == null || !foundryUrl.startsWith("https://")) {
+    if (foundryUrl != null) {
+      consola.fail("Please enter a valid Foundry URL");
+    }
+    foundryUrl = await consola.prompt(
+      `Enter the URL for your Foundry stack:\n${
+        italic(
+          "(Example https://example.palantirfoundry.com/)",
+        )
+      }`,
+      { type: "text" },
+    );
+  }
+  return foundryUrl.replace(/\/$/, "");
+}
diff --git a/packages/create-app/src/prompts/promptOsdkPackage.test.ts b/packages/create-app/src/prompts/promptOsdkPackage.test.ts
new file mode 100644
index 000000000..9ad5af732
--- /dev/null
+++ b/packages/create-app/src/prompts/promptOsdkPackage.test.ts
@@ -0,0 +1,54 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptOsdkPackage } from "./promptOsdkPackage.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test("it accepts valid osdk package from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("@myapp/sdk");
+  expect(await promptOsdkPackage({})).toEqual("@myapp/sdk");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it prompts again if answered value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("some-package");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("@some/package");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("@myapp/sdk");
+  expect(await promptOsdkPackage({})).toEqual("@myapp/sdk");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(3);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptOsdkPackage({ osdkPackage: "@myapp/sdk" })).toEqual(
+    "@myapp/sdk",
+  );
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("@myapp/sdk");
+  expect(await promptOsdkPackage({ osdkPackage: "some-package" })).toEqual(
+    "@myapp/sdk",
+  );
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
diff --git a/packages/create-app/src/prompts/promptOsdkPackage.ts b/packages/create-app/src/prompts/promptOsdkPackage.ts
new file mode 100644
index 000000000..ded0f1f08
--- /dev/null
+++ b/packages/create-app/src/prompts/promptOsdkPackage.ts
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+import { italic } from "../highlight.js";
+
+export async function promptOsdkPackage(
+  { osdkPackage }: { osdkPackage?: string },
+): Promise<string> {
+  while (osdkPackage == null || !/^@[a-z0-9-]+\/sdk$/.test(osdkPackage)) {
+    if (osdkPackage != null) {
+      consola.fail("Please enter a valid OSDK package name");
+    }
+    osdkPackage = await consola.prompt(
+      `Enter the OSDK package name for your application from Developer Console:\n${
+        italic(
+          "(Example @my-app/sdk)",
+        )
+      }`,
+      { type: "text" },
+    );
+  }
+  return osdkPackage;
+}
diff --git a/packages/create-app/src/prompts/promptOsdkRegistryUrl.test.ts b/packages/create-app/src/prompts/promptOsdkRegistryUrl.test.ts
new file mode 100644
index 000000000..3cc0c75de
--- /dev/null
+++ b/packages/create-app/src/prompts/promptOsdkRegistryUrl.test.ts
@@ -0,0 +1,63 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptOsdkRegistryUrl } from "./promptOsdkRegistryUrl.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+const valid =
+  "https://example.palantirfoundry.com/artifacts/api/repositories/ri.artifacts.main.repository.fake/contents/release/npm";
+
+test("it accepts valid osdk registry url from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptOsdkRegistryUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it prompts again if answered value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("invalid");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("https://abc.com/something");
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptOsdkRegistryUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(3);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptOsdkRegistryUrl({ osdkRegistryUrl: valid })).toEqual(
+    valid,
+  );
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid);
+  expect(await promptOsdkRegistryUrl({ osdkRegistryUrl: "invalid" })).toEqual(
+    valid,
+  );
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it strips trailing slash from url", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(valid + "/");
+  expect(await promptOsdkRegistryUrl({})).toEqual(valid);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
diff --git a/packages/create-app/src/prompts/promptOsdkRegistryUrl.ts b/packages/create-app/src/prompts/promptOsdkRegistryUrl.ts
new file mode 100644
index 000000000..afa62b4fd
--- /dev/null
+++ b/packages/create-app/src/prompts/promptOsdkRegistryUrl.ts
@@ -0,0 +1,45 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+import { italic } from "../highlight.js";
+
+export async function promptOsdkRegistryUrl(
+  { osdkRegistryUrl }: { osdkRegistryUrl?: string },
+): Promise<string> {
+  while (
+    osdkRegistryUrl == null
+    || !/^https:\/\/[^/]+\/artifacts\/api\/repositories\/ri\.artifacts\.[^/]+\/contents\/release\/npm\/?$/
+      .test(
+        osdkRegistryUrl,
+      )
+  ) {
+    if (osdkRegistryUrl != null) {
+      consola.fail(
+        "Please enter a valid NPM registry URL to install your OSDK package",
+      );
+    }
+    osdkRegistryUrl = await consola.prompt(
+      `Enter the NPM registry URL to install your OSDK package from Developer Console:\n${
+        italic(
+          "(Example https://example.palantirfoundry.com/artifacts/api/repositories/ri.artifacts.main.repository.a4a7fe1c-486f-4226-b706-7b90005f527d/contents/release/npm)",
+        )
+      }`,
+      { type: "text" },
+    );
+  }
+  return osdkRegistryUrl.replace(/\/$/, "");
+}
diff --git a/packages/create-app/src/prompts/promptOverwrite.test.ts b/packages/create-app/src/prompts/promptOverwrite.test.ts
new file mode 100644
index 000000000..226c0dd7d
--- /dev/null
+++ b/packages/create-app/src/prompts/promptOverwrite.test.ts
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import fs from "node:fs";
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptOverwrite } from "./promptOverwrite.js";
+
+vi.mock("../consola.js");
+vi.mock("node:fs");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test("it accepts valid 'overwrite' from prompt", async () => {
+  vi.mocked(fs.existsSync).mockReturnValueOnce(true);
+  vi.mocked(consola).prompt.mockResolvedValueOnce("overwrite");
+  expect(await promptOverwrite({ project: "abc" })).toBe(true);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it accepts valid 'ignore' from prompt", async () => {
+  vi.mocked(fs.existsSync).mockReturnValueOnce(true);
+  vi.mocked(consola).prompt.mockResolvedValueOnce("ignore");
+  expect(await promptOverwrite({ project: "abc" })).toBe(false);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it accepts initial value without prompt", async () => {
+  expect(await promptOverwrite({ project: "abc", overwrite: true })).toBe(true);
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it returns true if project does not already exist", async () => {
+  vi.mocked(fs.existsSync).mockReturnValueOnce(false);
+  expect(await promptOverwrite({ project: "abc" })).toBe(true);
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
diff --git a/packages/create-app/src/prompts/promptOverwrite.ts b/packages/create-app/src/prompts/promptOverwrite.ts
new file mode 100644
index 000000000..daefdd91d
--- /dev/null
+++ b/packages/create-app/src/prompts/promptOverwrite.ts
@@ -0,0 +1,66 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { consola } from "../consola.js";
+import { green } from "../highlight.js";
+
+export async function promptOverwrite(
+  {
+    project,
+    overwrite,
+  }: {
+    project: string;
+    overwrite?: boolean;
+  },
+): Promise<boolean> {
+  if (overwrite != null) {
+    return overwrite;
+  }
+
+  if (!fs.existsSync(path.join(process.cwd(), project))) {
+    return true;
+  }
+
+  const result = (await consola.prompt(
+    `The directory ${
+      green(
+        project,
+      )
+    } already exists do you want to overwrite or ignore it?`,
+    {
+      type: "select",
+      options: [
+        { label: "Remove existing files and continue", value: "overwrite" },
+        { label: "Ignore files and continue", value: "ignore" },
+        { label: "Cancel", value: "cancel" },
+      ],
+    },
+    // Types for "select" are wrong the value is returned rather than the option object
+    // https://github.com/unjs/consola/pull/238
+  )) as unknown as "overwrite" | "ignore" | "cancel";
+
+  switch (result) {
+    case "overwrite":
+      return true;
+    case "ignore":
+      return false;
+    case "cancel":
+      consola.fail("Operation cancelled");
+      process.exit(0);
+  }
+}
diff --git a/packages/create-app/src/prompts/promptProject.test.ts b/packages/create-app/src/prompts/promptProject.test.ts
new file mode 100644
index 000000000..edb50d28e
--- /dev/null
+++ b/packages/create-app/src/prompts/promptProject.test.ts
@@ -0,0 +1,53 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { promptProject } from "./promptProject.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test("it accepts valid project from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("my-osdk-app");
+  expect(await promptProject({})).toEqual("my-osdk-app");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it prompts again if answered value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("!@#$%^&*()_+");
+  vi.mocked(consola).prompt.mockResolvedValueOnce("my-osdk-app");
+  expect(await promptProject({})).toEqual("my-osdk-app");
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(2);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptProject({ project: "my-osdk-app" })).toEqual(
+    "my-osdk-app",
+  );
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce("my-osdk-app");
+  expect(await promptProject({ project: "!@#$%^&*()_+" })).toEqual(
+    "my-osdk-app",
+  );
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
diff --git a/packages/create-app/src/prompts/promptProject.ts b/packages/create-app/src/prompts/promptProject.ts
new file mode 100644
index 000000000..a881e1855
--- /dev/null
+++ b/packages/create-app/src/prompts/promptProject.ts
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+
+export async function promptProject(
+  { project }: { project?: string },
+): Promise<string> {
+  while (project == null || !/^[a-zA-Z0-9-_]+$/.test(project)) {
+    if (project != null) {
+      consola.fail(
+        "Project name can only contain alphanumeric characters, hyphens and underscores",
+      );
+    }
+    project = await consola.prompt("Project name:", {
+      type: "text",
+      placeholder: "my-osdk-app",
+      default: "my-osdk-app",
+    });
+  }
+
+  return project;
+}
diff --git a/packages/create-app/src/prompts/promptTemplate.test.ts b/packages/create-app/src/prompts/promptTemplate.test.ts
new file mode 100644
index 000000000..8c321aef1
--- /dev/null
+++ b/packages/create-app/src/prompts/promptTemplate.test.ts
@@ -0,0 +1,47 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { afterEach, expect, test, vi } from "vitest";
+import { consola } from "../consola.js";
+import { TEMPLATES } from "../templates.js";
+import { promptTemplate } from "./promptTemplate.js";
+
+vi.mock("../consola.js");
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test("it accepts valid template from prompt", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(TEMPLATES[0].id);
+  expect(await promptTemplate({})).toEqual(TEMPLATES[0]);
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
+
+test("it accepts valid initial value without prompt", async () => {
+  expect(await promptTemplate({ template: TEMPLATES[0].id })).toEqual(
+    TEMPLATES[0],
+  );
+  expect(vi.mocked(consola).prompt).not.toHaveBeenCalled();
+});
+
+test("it prompts if initial value is invalid", async () => {
+  vi.mocked(consola).prompt.mockResolvedValueOnce(TEMPLATES[0].id);
+  expect(await promptTemplate({ template: "missing" })).toEqual(
+    TEMPLATES[0],
+  );
+  expect(vi.mocked(consola).prompt).toHaveBeenCalledTimes(1);
+});
diff --git a/packages/create-app/src/prompts/promptTemplate.ts b/packages/create-app/src/prompts/promptTemplate.ts
new file mode 100644
index 000000000..fb7e5fe9e
--- /dev/null
+++ b/packages/create-app/src/prompts/promptTemplate.ts
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { consola } from "../consola.js";
+import { green } from "../highlight.js";
+import { type Template, TEMPLATES } from "../templates.js";
+
+export async function promptTemplate(
+  parsed: { template?: string },
+): Promise<Template> {
+  let template = TEMPLATES.find((t) => t.id === parsed.template);
+  if (template == null) {
+    const templateId = (await consola.prompt(
+      parsed.template != null
+        ? `The provided template ${
+          green(
+            parsed.template,
+          )
+        } is invalid please select a framework:`
+        : "Select a framework:",
+      {
+        type: "select",
+        options: TEMPLATES.map((template) => ({
+          value: template.id,
+          label: template.label,
+        })),
+        // Types for "select" are wrong the value is returned rather than the option object
+        // https://github.com/unjs/consola/pull/238
+      },
+    )) as unknown as string;
+
+    template = TEMPLATES.find((t) => t.id === templateId);
+    if (template == null) {
+      throw new Error(`Template ${templateId} should be found`);
+    }
+  }
+
+  return template;
+}