Create app command

src/commands/app/create.ts

@@ -0,0 +1,39 @@
+import { Flags } from '@oclif/core';
+
+import { AuthenticatedCommand } from 'commands-base/authenticated-command';
+import { createApp } from 'services/apps-service';
+import logger from 'utils/logger';
+
+export default class AppCreate extends AuthenticatedCommand {
+  static description = 'Create an app.';
+
+  static withPrintCommand = false;
+
+  static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> -n NEW_APP_NAME'];
+
+  static flags = AppCreate.serializeFlags({
+    port: Flags.integer({
+      char: 'n',
+      description: 'Name your new app.',
+      required: false,
+    }),
+  });
+
+  DEBUG_TAG = 'app_create';
+
+  public async run(): Promise<void> {
+    try {
+      const { flags } = await this.parse(AppCreate);
+      const { name } = flags;
+
+      logger.debug(`invoking create app: name=${name}`, this.DEBUG_TAG);
+      const app = await createApp();
+      logger.success(`App created successfully: ${app.name} (id: ${app.id})`);
+    } catch (error: any) {
+      logger.debug(error, this.DEBUG_TAG);
+
+      // need to signal to the parent process that the command failed
+      process.exit(1);
+    }
+  }
+}

src/consts/urls.ts

@@ -61,6 +61,10 @@ export const listAppsUrl = (): string => {
   return BASE_APPS_URL;
 };
 
+export const createAppUrl = (): string => {
+  return BASE_APPS_URL;
+};
+
 export const listAppVersionsByAppIdUrl = (appId: AppId): string => {
   return `${BASE_APPS_URL}/${appId}/versions`;
 };

src/services/apps-service.ts

@@ -1,9 +1,9 @@
-import { listAppsUrl } from 'consts/urls';
+import { createAppUrl, listAppsUrl } from 'consts/urls';
 import { execute } from 'services/api-service';
-import { listAppSchema } from 'services/schemas/apps-service-schemas';
+import { createAppSchema, listAppSchema } from 'services/schemas/apps-service-schemas';
 import { HttpError } from 'types/errors';
 import { HttpMethodTypes } from 'types/services/api-service';
-import { App, ListAppResponse } from 'types/services/apps-service';
+import { App, CreateAppResponse, ListAppResponse } from 'types/services/apps-service';
 import { appsUrlBuilder } from 'utils/urls-builder';
 
 export const listApps = async (): Promise<Array<App>> => {
@@ -28,3 +28,27 @@ export const listApps = async (): Promise<Array<App>> => {
     throw new Error('Failed to list apps.');
   }
 };
+
+export const createApp = async (name?: string): Promise<App> => {
+  try {
+    const path = createAppUrl();
+    const url = appsUrlBuilder(path);
+    const response = await execute<CreateAppResponse>(
+      {
+        url,
+        headers: { Accept: 'application/json' },
+        method: HttpMethodTypes.POST,
+        body: name ? { name } : undefined,
+      },
+      createAppSchema,
+    );
+
+    return response.app;
+  } catch (error: any) {
+    if (error instanceof HttpError) {
+      throw error;
+    }
+
+    throw new Error('Failed to create app.');
+  }
+};

src/services/schemas/apps-service-schemas.ts

@@ -13,3 +13,9 @@ export const listAppSchema = z
     apps: z.array(appSchema),
   })
   .merge(baseResponseHttpMetaDataSchema);
+
+export const createAppSchema = z
+  .object({
+    app: appSchema,
+  })
+  .merge(baseResponseHttpMetaDataSchema);

src/types/services/apps-service.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 
-import { appSchema, listAppSchema } from 'services/schemas/apps-service-schemas';
+import { appSchema, createAppSchema, listAppSchema } from 'services/schemas/apps-service-schemas';
 
 export type App = z.infer<typeof appSchema>;
 export type ListAppResponse = z.infer<typeof listAppSchema>;
+export type CreateAppResponse = z.infer<typeof createAppSchema>;