Function sendChannelMessage

server/src/slack/client.ts:540–574

(
  channelId: string,
  message: SlackBlockMessage,
  options: { requirePrivate?: boolean | 'strict-public-only' } = {},
)

 * `requirePrivate` unset — behavior is unchanged.
 */
export async function sendChannelMessage(
  channelId: string,
  message: SlackBlockMessage,
  options: { requirePrivate?: boolean | 'strict-public-only' } = {},
): Promise<{ ok: boolean; ts?: string; error?: string; skipped?: SendSkipReason }> {
  if (options.requirePrivate) {
    const state = await verifyChannelStillPrivate(channelId);
    if (state === 'public') {
      return { ok: false, error: 'channel_no_longer_private', skipped: 'not_private' };
    }
    if (state === 'unknown' && options.requirePrivate !== 'strict-public-only') {
      return { ok: false, error: 'channel_privacy_unknown', skipped: 'privacy_unknown' };
    }
    // state === 'private' → fall through; state === 'unknown' with
    // 'strict-public-only' → fall through with the warn log already
    // emitted by verifyChannelStillPrivate.
  }

  try {
    const response = await slackPostRequest<{ ts: string }>('chat.postMessage', {
      channel: channelId,
      text: message.text,
      blocks: message.blocks,
      thread_ts: message.thread_ts,
      reply_broadcast: message.reply_broadcast,
    });

    logger.info({ channelId, ts: response.ts }, 'Sent Slack channel message');
    return { ok: true, ts: response.ts };
  } catch (error) {
    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
    logger.error({ error, channelId }, 'Failed to send Slack channel message');
    return { ok: false, error: errorMessage };
  }
}

/**
 * Update (edit in place) a previously posted channel message.