import { linearGraphql } from './client.ts' import { COMMENT_FIELDS, mapComment } from './models.ts' import type { DryRunResult, JsonRecord, LinearAuthInput, LinearCommentSummary, } from './types.ts' import { compactRecord, optionalBoolean, optionalString, requireRecord, requireString, } from './types.ts' import { requireAuthMode } from './auth.ts' export type CreateCommentInput = LinearAuthInput & { /** Issue UUID or identifier (`ENG-123`). */ issueId: string body: string parentId?: string confirm?: boolean dryRun?: boolean } function commentCreatePayload(input: CreateCommentInput): JsonRecord { return compactRecord({ issueId: requireString(input.issueId, 'issueId'), body: requireString(input.body, 'body'), parentId: optionalString(input.parentId, 'parentId'), }) } /** * Create a Linear comment. Requires `confirm: true`, or use `dryRun: true`. * Needs `comments:create` or `write`. * @example * import createComment from 'kody:@kody/linear/create-comment' * const preview = await createComment({ * issueId: 'ENG-123', * body: 'Shipped in #482.', * dryRun: true, * }) */ export async function createComment( input: CreateCommentInput, ): Promise> { const payload = commentCreatePayload(input) if (input.dryRun) { return { dryRun: true, wouldCall: { mutation: 'commentCreate', input: payload } } } if (input.confirm !== true) { throw new Error( 'Creating a Linear comment requires confirm: true after explicit user approval, or dryRun: true.', ) } const result = await linearGraphql<{ commentCreate: { success?: boolean; comment?: unknown } }>({ ...input, operation: 'commentCreate', query: `mutation CreateComment($input: CommentCreateInput!) { commentCreate(input: $input) { success comment { ${COMMENT_FIELDS} } } }`, variables: { input: payload }, }) if (!result.data.commentCreate?.success || !result.data.commentCreate.comment) { throw new Error('Linear commentCreate did not return a comment.') } return mapComment(result.data.commentCreate.comment) } /** * Create a Linear comment. Requires `confirm: true`, or use `dryRun: true`. * @example * import createComment from 'kody:@kody/linear/create-comment' * const preview = await createComment({ issueId: 'ENG-123', body: 'Noted', dryRun: true }) */ export default async function createCommentEntrypoint( params: Partial & Record = {}, ) { const input = requireRecord(params, 'create-comment') return createComment({ issueId: requireString(input.issueId, 'issueId'), body: requireString(input.body, 'body'), parentId: optionalString(input.parentId, 'parentId'), integrationName: optionalString(input.integrationName, 'integrationName'), integration: optionalString(input.integration, 'integration'), account: optionalString(input.account, 'account'), secretName: optionalString(input.secretName, 'secretName'), auth: requireAuthMode(input.auth), confirm: optionalBoolean(input.confirm, 'confirm'), dryRun: optionalBoolean(input.dryRun, 'dryRun'), }) }