import { mutationSpec, parseWithAccount } from '../lib/api.ts' import { granolaRequest } from '../lib/client.ts' import { checkWebhookUrl, echo, mutationMode, preview } from '../lib/guard.ts' import { FOLDER_ID_PATTERN, WEBHOOK_ID_PATTERN } from '../lib/validate.ts' import { checkEnumList, findWebhookEndpoint, WEBHOOK_EVENTS, WEBHOOK_SCOPES } from '../lib/webhooks.ts' /** * Change a webhook endpoint (`PATCH /v1/webhook-endpoints/{id}`): URL, scopes, events, folder * filter, or `enabled` (re-enable one Granola disabled after failed deliveries). Only the fields * you pass change. WRITE: previews unless `confirm: true`; the preview shows the current endpoint. * * @param input.account - Account name (secret `granola-`). Required. @param input.secretName - Secret override. * @param input.webhookId - `whe_…` id (from ./webhooks/list). Required. * @param input.url - New public HTTPS URL. @param input.scopes - personal/public/workspace. @param input.events - Event subset. * @param input.folderIds - Folder filter (`[]` clears it). @param input.enabled - Enable/disable deliveries. * @param input.dryRun - Preview only. @param input.confirm - `true` to apply. * @returns Preview `{ dryRun: true, current, request }`, or `{ executed: true, webhookEndpoint }` * * @example * import updateWebhook from 'kody:@charlesmatte/granola/webhooks/update' * * await updateWebhook({ account: 'work', webhookId: 'whe_2mKr8fQxLp7Ta3', enabled: true, confirm: true }) */ export default async function updateGranolaWebhook(input: unknown) { const p = parseWithAccount<{ webhookId: string; url?: string; scopes?: Array; events?: Array; folderIds?: Array; enabled?: boolean; dryRun?: boolean; confirm?: boolean }>( input, { webhookId: { type: 'string', required: true, pattern: WEBHOOK_ID_PATTERN }, url: { type: 'string', maxLength: 2000 }, scopes: { type: 'stringArray', maxItems: 3 }, events: { type: 'stringArray', maxItems: 3 }, folderIds: { type: 'stringArray', maxItems: 100, allowEmptyArray: true }, enabled: { type: 'boolean' }, ...mutationSpec, }, 'webhooks/update', ) checkEnumList('scopes', p.scopes, WEBHOOK_SCOPES) checkEnumList('events', p.events, WEBHOOK_EVENTS) const badFolder = (p.folderIds ?? []).find((f) => !FOLDER_ID_PATTERN.test(f)) if (badFolder) throw new Error(`webhooks/update: folder id "${badFolder}" is not a fol_… id.`) const body: Record = {} if (p.url !== undefined) body.url = checkWebhookUrl(p.url) if (p.scopes !== undefined) body.scopes = p.scopes if (p.events !== undefined) body.events = p.events if (p.folderIds !== undefined) body.folder_ids = p.folderIds if (p.enabled !== undefined) body.enabled = p.enabled if (Object.keys(body).length === 0) throw new Error('webhooks/update: pass at least one of url, scopes, events, folderIds, enabled.') const mode = mutationMode(p) const path = `/v1/webhook-endpoints/${p.webhookId}` const target = `webhook ${p.webhookId}` if (!mode.execute) { const current = await findWebhookEndpoint(p.acct, p.webhookId).catch(() => null) return preview(p.acct, 'webhooks/update', target, mode, { method: 'PATCH', path, body }, { current: current ?? 'not visible to this key (the update would likely 404)' }) } const res = await granolaRequest(p.acct, { method: 'PATCH', path, json: body, retries: 1 }) return { dryRun: false, executed: true, echo: echo(p.acct, 'webhooks/update', target, mode), webhookEndpoint: res.data } }