sharetribe-cli 1.15.0

package/src/commands/listing-approval.ts

@@ -0,0 +1,121 @@
+/**
+ * Listing approval command - DEPRECATED
+ *
+ * This command is deprecated and should not be used.
+ * Use the Sharetribe Console instead.
+ */
+
+import { Command } from 'commander';
+import {
+  getListingApprovalStatus as sdkGetStatus,
+  enableListingApproval as sdkEnable,
+  disableListingApproval as sdkDisable,
+} from 'sharetribe-flex-build-sdk';
+import { printError } from '../util/output.js';
+
+/**
+ * Gets current listing approval status
+ */
+async function getStatus(marketplace: string): Promise<void> {
+  try {
+    const result = await sdkGetStatus(undefined, marketplace);
+
+    if (result.enabled) {
+      console.log(`Listing approvals are enabled in ${marketplace}`);
+    } else {
+      console.log(`Listing approvals are disabled in ${marketplace}`);
+    }
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to get listing approval status');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Enables listing approvals
+ */
+async function enableApprovals(marketplace: string): Promise<void> {
+  try {
+    await sdkEnable(undefined, marketplace);
+    console.log(`Successfully enabled listing approvals in ${marketplace}`);
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to enable listing approvals');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Disables listing approvals
+ */
+async function disableApprovals(marketplace: string): Promise<void> {
+  try {
+    await sdkDisable(undefined, marketplace);
+    console.log(`Successfully disabled listing approvals in ${marketplace}`);
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to disable listing approvals');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Registers listing-approval command
+ */
+export function registerListingApprovalCommand(program: Command): void {
+  const cmd = program
+    .command('listing-approval')
+    .description('manage listing approvals (DEPRECATED - use Console instead)')
+    .option('-m, --marketplace <MARKETPLACE_ID>', 'marketplace identifier');
+
+  // Default action - show status
+  cmd.action(async (opts) => {
+    console.warn('Warning: CLI command `listing-approval` is deprecated. Use Console instead.');
+    const marketplace = opts.marketplace || program.opts().marketplace;
+    if (!marketplace) {
+      console.error('Error: --marketplace is required');
+      process.exit(1);
+    }
+    await getStatus(marketplace);
+  });
+
+  // Enable subcommand
+  cmd
+    .command('enable')
+    .description('enable listing approvals')
+    .option('-m, --marketplace <MARKETPLACE_ID>', 'marketplace identifier')
+    .action(async (opts) => {
+      console.warn('Warning: CLI command `listing-approval` is deprecated. Use Console instead.');
+      const marketplace = opts.marketplace || program.opts().marketplace;
+      if (!marketplace) {
+        console.error('Error: --marketplace is required');
+        process.exit(1);
+      }
+      await enableApprovals(marketplace);
+    });
+
+  // Disable subcommand
+  cmd
+    .command('disable')
+    .description('disable listing approvals')
+    .option('-m, --marketplace <MARKETPLACE_ID>', 'marketplace identifier')
+    .action(async (opts) => {
+      console.warn('Warning: CLI command `listing-approval` is deprecated. Use Console instead.');
+      const marketplace = opts.marketplace || program.opts().marketplace;
+      if (!marketplace) {
+        console.error('Error: --marketplace is required');
+        process.exit(1);
+      }
+      await disableApprovals(marketplace);
+    });
+}

package/src/commands/login.ts

@@ -0,0 +1,43 @@
+/**
+ * Login command - interactive API key authentication
+ *
+ * Must match flex-cli behavior exactly:
+ * - Prompt for API key
+ * - Store in ~/.config/flex-cli/auth.edn
+ * - Display admin email on success
+ */
+
+import inquirer from 'inquirer';
+import { writeAuth } from 'sharetribe-flex-build-sdk';
+
+/**
+ * Executes the login command
+ *
+ * Prompts for API key and stores it in auth.edn
+ */
+export async function login(): Promise<void> {
+  const answers = await inquirer.prompt([
+    {
+      type: 'password',
+      name: 'apiKey',
+      message: 'Enter API key:',
+      mask: '*',
+      validate: (input: string) => {
+        if (!input || input.trim().length === 0) {
+          return 'API key cannot be empty';
+        }
+        return true;
+      },
+    },
+  ]);
+
+  // Store the API key
+  writeAuth({ apiKey: answers.apiKey });
+
+  // TODO: Validate API key by making a test request to get admin email
+  // For now, just confirm storage
+  console.log('Successfully logged in.');
+
+  // Note: flex-cli displays admin email after successful login
+  // We'll need to implement API client to fetch this
+}

package/src/commands/logout.ts

@@ -0,0 +1,17 @@
+/**
+ * Logout command - clears authentication
+ *
+ * Must match flex-cli behavior exactly
+ */
+
+import { clearAuth } from 'sharetribe-flex-build-sdk';
+
+/**
+ * Executes the logout command
+ *
+ * Clears auth.edn file
+ */
+export async function logout(): Promise<void> {
+  await clearAuth();
+  console.log('Successfully logged out.');
+}

package/src/commands/notifications/index.ts

@@ -0,0 +1,221 @@
+/**
+ * Notifications commands - manage email notifications
+ */
+
+import { Command } from 'commander';
+import {
+  sendNotification as sdkSendNotification,
+  previewNotification as sdkPreviewNotification,
+} from 'sharetribe-flex-build-sdk';
+import { printError } from '../../util/output.js';
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { createServer, IncomingMessage, ServerResponse } from 'node:http';
+
+
+/**
+ * Reads a notification template from a directory
+ */
+function readTemplate(templatePath: string): { html: string; subject: string } {
+  if (!existsSync(templatePath) || !statSync(templatePath).isDirectory()) {
+    throw new Error(`Template directory not found: ${templatePath}`);
+  }
+
+  const htmlPath = join(templatePath, 'template.html');
+  const subjectPath = join(templatePath, 'template-subject.txt');
+
+  if (!existsSync(htmlPath)) {
+    throw new Error(`template.html not found in ${templatePath}`);
+  }
+
+  if (!existsSync(subjectPath)) {
+    throw new Error(`template-subject.txt not found in ${templatePath}`);
+  }
+
+  const html = readFileSync(htmlPath, 'utf-8');
+  const subject = readFileSync(subjectPath, 'utf-8').trim();
+
+  return { html, subject };
+}
+
+/**
+ * Reads template context JSON file
+ */
+function readContext(contextPath?: string): unknown {
+  if (!contextPath) {
+    return undefined;
+  }
+
+  if (!existsSync(contextPath)) {
+    throw new Error(`Context file not found: ${contextPath}`);
+  }
+
+  const content = readFileSync(contextPath, 'utf-8');
+  try {
+    return JSON.parse(content);
+  } catch (error) {
+    throw new Error(`Invalid JSON in context file: ${error}`);
+  }
+}
+
+/**
+ * Sends a preview email to the marketplace admin
+ */
+async function sendNotification(
+  marketplace: string,
+  templatePath: string,
+  contextPath?: string
+): Promise<void> {
+  try {
+    const template = readTemplate(templatePath);
+    const context = readContext(contextPath);
+
+    const result = await sdkSendNotification(undefined, marketplace, { template, context });
+
+    console.log(`Preview successfully sent to ${result.adminEmail}`);
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to send notification');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Previews a notification in the browser
+ */
+async function previewNotification(
+  marketplace: string,
+  templatePath: string,
+  contextPath?: string
+): Promise<void> {
+  try {
+    const template = readTemplate(templatePath);
+    const context = readContext(contextPath);
+
+    console.log(`Template: ${templatePath}`);
+    console.log(`Subject: ${template.subject}`);
+    console.log('');
+    console.log('Starting preview server at http://localhost:3535');
+    console.log('Press Ctrl+C to stop');
+    console.log('');
+
+    let previewHtml: string | null = null;
+
+    // Fetch preview from API
+    const fetchPreview = async () => {
+      try {
+        const result = await sdkPreviewNotification(undefined, marketplace, { template, context });
+
+        // Inject title into HTML
+        const html = result.html;
+        const titleTag = `<title>${template.subject}</title>`;
+
+        if (html.includes('<head>')) {
+          previewHtml = html.replace('<head>', `<head>\n${titleTag}`);
+        } else if (html.includes('<html>')) {
+          previewHtml = html.replace('<html>', `<html>\n<head>${titleTag}</head>`);
+        } else {
+          previewHtml = `<html><head>${titleTag}</head><body>${html}</body></html>`;
+        }
+      } catch (error) {
+        const errorMessage = error && typeof error === 'object' && 'message' in error
+          ? (error.message as string)
+          : 'Failed to preview notification';
+
+        previewHtml = `
+          <html>
+            <head><title>Error</title></head>
+            <body style="font-family: sans-serif; padding: 20px;">
+              <h1 style="color: #d32f2f;">Error</h1>
+              <pre style="background: #f5f5f5; padding: 15px; border-radius: 4px;">${errorMessage}</pre>
+            </body>
+          </html>
+        `;
+      }
+    };
+
+    // Initial fetch
+    await fetchPreview();
+
+    // Create HTTP server
+    const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {
+      if (req.url === '/' || req.url === '') {
+        // Refresh preview on each request
+        await fetchPreview();
+
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(previewHtml);
+      } else {
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not Found');
+      }
+    });
+
+    server.listen(3535, () => {
+      console.log('Preview server started. Open http://localhost:3535 in your browser.');
+    });
+
+    // Handle graceful shutdown
+    const shutdown = () => {
+      console.log('\nShutting down preview server...');
+      server.close(() => {
+        process.exit(0);
+      });
+    };
+
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to preview notification');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Registers notifications commands
+ */
+export function registerNotificationsCommands(program: Command): void {
+  const notificationsCmd = program
+    .command('notifications')
+    .description('manage email notifications');
+
+  // notifications preview
+  notificationsCmd
+    .command('preview')
+    .description('render a preview of an email template')
+    .requiredOption('--template <TEMPLATE_DIR>', 'path to template directory')
+    .option('--context <CONTEXT_FILE>', 'path to email rendering context JSON file')
+    .option('-m, --marketplace <MARKETPLACE_ID>', 'marketplace identifier')
+    .action(async (opts) => {
+      const marketplace = opts.marketplace || program.opts().marketplace;
+      if (!marketplace) {
+        console.error('Error: --marketplace is required');
+        process.exit(1);
+      }
+      await previewNotification(marketplace, opts.template, opts.context);
+    });
+
+  // notifications send
+  notificationsCmd
+    .command('send')
+    .description('send a preview of an email template to the logged in admin')
+    .requiredOption('--template <TEMPLATE_DIR>', 'path to template directory')
+    .option('--context <CONTEXT_FILE>', 'path to email rendering context JSON file')
+    .option('-m, --marketplace <MARKETPLACE_ID>', 'marketplace identifier')
+    .action(async (opts) => {
+      const marketplace = opts.marketplace || program.opts().marketplace;
+      if (!marketplace) {
+        console.error('Error: --marketplace is required');
+        process.exit(1);
+      }
+      await sendNotification(marketplace, opts.template, opts.context);
+    });
+}

package/src/commands/process/aliases.ts

@@ -0,0 +1,82 @@
+/**
+ * Process alias commands
+ */
+
+import {
+  createAlias as sdkCreateAlias,
+  updateAlias as sdkUpdateAlias,
+  deleteAlias as sdkDeleteAlias
+} from 'sharetribe-flex-build-sdk';
+import { printError, printSuccess } from '../../util/output.js';
+
+/**
+ * Creates a process alias
+ */
+export async function createAlias(
+  marketplace: string,
+  processName: string,
+  version: number,
+  alias: string
+): Promise<void> {
+  try {
+    const result = await sdkCreateAlias(undefined, marketplace, processName, version, alias);
+
+    printSuccess(
+      `Alias ${result.alias} successfully created to point to version ${result.version}.`
+    );
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to create alias');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Updates a process alias
+ */
+export async function updateAlias(
+  marketplace: string,
+  processName: string,
+  version: number,
+  alias: string
+): Promise<void> {
+  try {
+    const result = await sdkUpdateAlias(undefined, marketplace, processName, version, alias);
+
+    printSuccess(
+      `Alias ${result.alias} successfully updated to point to version ${result.version}.`
+    );
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to update alias');
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Deletes a process alias
+ */
+export async function deleteAlias(
+  marketplace: string,
+  processName: string,
+  alias: string
+): Promise<void> {
+  try {
+    const result = await sdkDeleteAlias(undefined, marketplace, processName, alias);
+
+    printSuccess(`Alias ${result.alias} successfully deleted.`);
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to delete alias');
+    }
+    process.exit(1);
+  }
+}

package/src/commands/process/combined.ts

@@ -0,0 +1,62 @@
+/**
+ * Combined process command - create-or-push-and-create-or-update-alias
+ *
+ * This is the enhanced "superset" feature that combines multiple operations
+ * into one atomic command
+ */
+
+import { deployProcess as sdkDeployProcess, parseProcessFile } from 'sharetribe-flex-build-sdk';
+import { printError, printSuccess } from '../../util/output.js';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * Creates or pushes a process and creates or updates an alias
+ *
+ * This is an atomic operation that:
+ * 1. Tries to push a new version (create-version)
+ * 2. If process doesn't exist, creates it
+ * 3. Then creates or updates the alias
+ */
+export async function createOrPushAndCreateOrUpdateAlias(
+  marketplace: string,
+  processName: string,
+  path: string,
+  alias: string
+): Promise<void> {
+  try {
+    const processFilePath = join(path, 'process.edn');
+    const processContent = readFileSync(processFilePath, 'utf-8');
+    const processDefinition = parseProcessFile(processContent);
+
+    const result = await sdkDeployProcess(
+      undefined, // Use auth from file
+      marketplace,
+      {
+        process: processName,
+        alias,
+        path: processFilePath,
+        processDefinition,
+      }
+    );
+
+    if (result.processCreated) {
+      printSuccess(`Process ${processName} successfully created.`);
+    }
+
+    printSuccess(`Version ${result.version} successfully saved for process ${processName}.`);
+
+    if (result.aliasCreated) {
+      printSuccess(`Alias ${result.alias} successfully created to point to version ${result.version}.`);
+    } else {
+      printSuccess(`Alias ${result.alias} successfully updated to point to version ${result.version}.`);
+    }
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to create/push process and alias');
+    }
+    process.exit(1);
+  }
+}

package/src/commands/process/create.ts

@@ -0,0 +1,35 @@
+/**
+ * Process create command
+ */
+
+import { createProcess as sdkCreateProcess } from 'sharetribe-flex-build-sdk';
+import { printError, printSuccess } from '../../util/output.js';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * Creates a new transaction process
+ */
+export async function createProcess(
+  marketplace: string,
+  processName: string,
+  path: string
+): Promise<void> {
+  try {
+    const processFilePath = join(path, 'process.edn');
+    const processContent = readFileSync(processFilePath, 'utf-8');
+
+    const result = await sdkCreateProcess(undefined, marketplace, processName, processContent);
+
+    printSuccess(
+      `Process ${result.name} successfully created with version ${result.version}.`
+    );
+  } catch (error) {
+    if (error && typeof error === 'object' && 'message' in error) {
+      printError(error.message as string);
+    } else {
+      printError('Failed to create process');
+    }
+    process.exit(1);
+  }
+}