Function createChannel

server/src/slack/client.ts:1047–1090

(
  name: string
)

 * @returns The created channel info, or null on error
 */
export async function createChannel(
  name: string
): Promise<{ channel: SlackChannel; url: string } | null> {
  try {
    // Normalize name: lowercase, replace spaces with hyphens, remove invalid chars
    const normalizedName = name
      .toLowerCase()
      .replace(/\s+/g, '-')
      .replace(/[^a-z0-9-_]/g, '')
      .slice(0, 80);

    const response = await slackPostRequest<{ channel: SlackChannel }>('conversations.create', {
      name: normalizedName,
      is_private: false,
    });

    // Get workspace info for URL
    const authInfo = await testSlackConnection();
    const workspaceUrl = authInfo.team_id
      ? `https://app.slack.com/client/${authInfo.team_id}/${response.channel.id}`
      : `https://agenticads.slack.com/archives/${response.channel.id}`;

    logger.info(
      { channelId: response.channel.id, name: normalizedName },
      'Created Slack channel'
    );

    return {
      channel: response.channel,
      url: workspaceUrl,
    };
  } catch (error) {
    const errorMessage = error instanceof Error ? error.message : 'Unknown error';

    // Handle "name_taken" error specifically
    if (errorMessage.includes('name_taken')) {
      logger.warn({ name }, 'Channel name already taken');
    } else {
      logger.error({ error: errorMessage, name }, 'Failed to create Slack channel');
    }

    return null;
  }
}

/**
 * Invite users to a channel