better-ship 0.25.0 → 0.26.0

package/dist/slack-webhook-j1FCPeu8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-webhook-j1FCPeu8.js","names":[],"sources":["../src/infrastructure/slack/ci-message.ts","../src/infrastructure/slack/slack-webhook.ts"],"sourcesContent":["import { z } from 'zod'\n\n/** The result of one CI job or step, in GitHub Actions terms. */\nexport type CiOutcome = 'success' | 'failure' | 'cancelled' | 'skipped'\n\n/** What the run delivers after its checks pass. */\nexport type CiTarget =\n  | { readonly kind: 'check' }\n  | {\n      readonly kind: 'deploy'\n      readonly accountId: string\n      readonly worker: string\n      readonly siteUrl: string\n      /** Absent when the run reached no deploy, such as a pull request. */\n      readonly versionId: string | undefined\n    }\n  | {\n      readonly kind: 'publish'\n      readonly packageName: string\n      /** Absent when npm already has the package version. */\n      readonly version: string | undefined\n    }\n\n/** One CI run, parsed from the environment that the workflow sets. */\nexport interface CiRun {\n  readonly repository: string\n  readonly commitSha: string\n  readonly ref:\n    | { readonly kind: 'branch'; readonly name: string }\n    | {\n        readonly kind: 'pullRequest'\n        readonly number: number\n        readonly url: string\n        readonly title: string\n      }\n  readonly runUrl: string\n  readonly jobs: ReadonlyArray<CiStepResult>\n  readonly steps: ReadonlyArray<CiStepResult>\n  readonly target: CiTarget\n}\n\n/** A named job or step and its outcome. */\nexport interface CiStepResult {\n  readonly name: string\n  readonly outcome: CiOutcome\n}\n\n/** The commit facts that only git knows. */\nexport interface CiCommit {\n  readonly subject: string\n  readonly author: string\n}\n\n/** A Slack incoming-webhook payload. */\nexport interface SlackMessage {\n  readonly text: string\n  readonly blocks: ReadonlyArray<SlackBlock>\n}\n\ntype SlackElement =\n  | { readonly type: 'mrkdwn'; readonly text: string }\n  | { readonly type: 'image'; readonly image_url: string; readonly alt_text: string }\n\ntype SlackBlock =\n  | { readonly type: 'section'; readonly text: { readonly type: 'mrkdwn'; readonly text: string } }\n  | { readonly type: 'context'; readonly elements: ReadonlyArray<SlackElement> }\n\n/** The CI environment could not be parsed. `issues` names each invalid variable. */\nexport class CiRunParseError extends Error {\n  readonly _tag = 'CiRunParseError' as const\n\n  constructor(\n    readonly issues: ReadonlyArray<string>,\n    override readonly cause: unknown,\n  ) {\n    super(`Invalid CI environment: ${issues.join(', ')}`)\n  }\n}\n\nconst OutcomeSchema = z.enum(['success', 'failure', 'cancelled', 'skipped'])\n\nconst jsonRecord = <T extends z.ZodType>(value: T) =>\n  z\n    .string()\n    .transform((text, context) => {\n      try {\n        const value: unknown = JSON.parse(text)\n        return value\n      } catch {\n        context.addIssue({ code: 'custom', message: 'Invalid JSON' })\n        return z.NEVER\n      }\n    })\n    .pipe(z.record(z.string(), value))\n\nconst CiEnvSchema = z.object({\n  REPO: z.string().regex(/^[\\w.-]+\\/[\\w.-]+$/),\n  COMMIT_SHA: z.string().regex(/^[0-9a-f]{40}$/),\n  BRANCH: z.string().min(1),\n  RUN_URL: z.httpUrl(),\n  JOBS_JSON: jsonRecord(z.object({ result: OutcomeSchema })).optional(),\n  STEPS_JSON: jsonRecord(z.object({ outcome: OutcomeSchema })).optional(),\n  PR_NUMBER: z.coerce.number().int().positive().optional(),\n  PR_URL: z.httpUrl().optional(),\n  PR_TITLE: z.string().min(1).optional(),\n  ACTION: z.enum(['check', 'deploy', 'publish']).default('check'),\n  CLOUDFLARE_ACCOUNT_ID: z.string().min(1).optional(),\n  CLOUDFLARE_WORKER: z.string().min(1).optional(),\n  SITE_URL: z.httpUrl().optional(),\n  DEPLOY_VERSION_ID: z.string().min(1).optional(),\n  NPM_PACKAGE: z.string().min(1).optional(),\n  NPM_VERSION: z.string().min(1).optional(),\n})\n\ntype CiEnv = z.infer<typeof CiEnvSchema>\n\n/**\n * Parse the variables that a workflow passes to the notifier. GitHub expressions render a\n * missing value as an empty string, so an empty variable counts as unset.\n * @throws {CiRunParseError} when a variable is missing or invalid.\n */\nexport function parseCiRun(env: Readonly<Record<string, string | undefined>>): CiRun {\n  const present = Object.fromEntries(Object.entries(env).filter(([, value]) => value !== ''))\n  const parsed = CiEnvSchema.safeParse(present)\n  if (!parsed.success) {\n    const issues = parsed.error.issues.map((issue) => issue.path.join('.'))\n    throw new CiRunParseError(issues, parsed.error)\n  }\n  return toCiRun(parsed.data)\n}\n\nfunction toCiRun(env: CiEnv): CiRun {\n  const ref: CiRun['ref'] =\n    env.PR_NUMBER !== undefined && env.PR_URL !== undefined && env.PR_TITLE !== undefined\n      ? { kind: 'pullRequest', number: env.PR_NUMBER, url: env.PR_URL, title: env.PR_TITLE }\n      : { kind: 'branch', name: env.BRANCH }\n  return {\n    repository: env.REPO,\n    commitSha: env.COMMIT_SHA,\n    ref,\n    runUrl: env.RUN_URL,\n    jobs: Object.entries(env.JOBS_JSON ?? {}).map(([id, job]) => ({\n      name: displayName(id),\n      outcome: job.result,\n    })),\n    steps: Object.entries(env.STEPS_JSON ?? {}).map(([id, step]) => ({\n      name: displayName(id),\n      outcome: step.outcome,\n    })),\n    target: toTarget(env),\n  }\n}\n\nfunction toTarget(env: CiEnv): CiTarget {\n  switch (env.ACTION) {\n    case 'check':\n      return { kind: 'check' }\n    case 'deploy': {\n      const { CLOUDFLARE_ACCOUNT_ID: accountId, CLOUDFLARE_WORKER: worker, SITE_URL: siteUrl } = env\n      if (accountId === undefined || worker === undefined || siteUrl === undefined) {\n        throw new CiRunParseError(\n          ['CLOUDFLARE_ACCOUNT_ID', 'CLOUDFLARE_WORKER', 'SITE_URL'],\n          undefined,\n        )\n      }\n      return { kind: 'deploy', accountId, worker, siteUrl, versionId: env.DEPLOY_VERSION_ID }\n    }\n    case 'publish':\n      if (env.NPM_PACKAGE === undefined) throw new CiRunParseError(['NPM_PACKAGE'], undefined)\n      return { kind: 'publish', packageName: env.NPM_PACKAGE, version: env.NPM_VERSION }\n  }\n}\n\n// A job or step id such as `check-and-build` reads as \"Check and build\".\nfunction displayName(id: string): string {\n  const words = id.replaceAll(/[-_]/g, ' ')\n  return words.charAt(0).toUpperCase() + words.slice(1)\n}\n\nconst logos = {\n  depot: 'https://avatars.githubusercontent.com/u/68166601?s=64',\n  github: 'https://avatars.githubusercontent.com/u/9919?s=64',\n  cloudflare: 'https://avatars.githubusercontent.com/u/314135?s=64',\n  npm: 'https://avatars.githubusercontent.com/u/6078720?s=64',\n} as const\n\n/** Build the four-line CI message: result, change, links, and identity. */\nexport function buildCiMessage(run: CiRun, commit: CiCommit): SlackMessage {\n  const headline = headlineFor(run)\n  const change = run.ref.kind === 'pullRequest' ? run.ref.title : commit.subject\n  return {\n    text: `${headline} — ${change}`,\n    blocks: [\n      { type: 'section', text: { type: 'mrkdwn', text: `*${headline}*\\n${escape(change)}` } },\n      { type: 'context', elements: linkElements(run) },\n      { type: 'context', elements: [{ type: 'mrkdwn', text: identityLine(run, commit) }] },\n    ],\n  }\n}\n\nfunction headlineFor(run: CiRun): string {\n  const failedJobs = namesWith(run.jobs, 'failure')\n  if (failedJobs) return `:x: CI failed: ${failedJobs}`\n  const cancelledJobs = namesWith(run.jobs, 'cancelled')\n  if (cancelledJobs) return `:white_circle: CI cancelled: ${cancelledJobs}`\n  const failedSteps = namesWith(run.steps, 'failure')\n  const { target } = run\n  switch (target.kind) {\n    case 'check':\n      return failedSteps ? `:x: CI failed: ${failedSteps}` : ':white_check_mark: CI passed'\n    case 'deploy':\n      if (failedSteps) return `:x: Deploy failed: ${failedSteps}`\n      return target.versionId === undefined\n        ? ':white_check_mark: CI passed'\n        : ':white_check_mark: Deployed to production'\n    case 'publish':\n      if (failedSteps) return `:x: Publish failed: ${failedSteps}`\n      return target.version === undefined\n        ? ':white_check_mark: CI passed, nothing to publish'\n        : `:white_check_mark: Published ${target.packageName} ${target.version}`\n  }\n}\n\nfunction namesWith(results: ReadonlyArray<CiStepResult>, outcome: CiOutcome): string {\n  return results\n    .filter((result) => result.outcome === outcome)\n    .map((result) => result.name)\n    .join(', ')\n}\n\nfunction linkElements(run: CiRun): ReadonlyArray<SlackElement> {\n  const runHost = new URL(run.runUrl).hostname\n  const runLogo = runHost.endsWith('github.com') ? logos.github : logos.depot\n  const elements: SlackElement[] = [\n    { type: 'image', image_url: runLogo, alt_text: runHost },\n    { type: 'mrkdwn', text: `<${run.runUrl}|CI run>` },\n  ]\n  const { target } = run\n  if (target.kind === 'deploy' && target.versionId !== undefined) {\n    const dashboard = `https://dash.cloudflare.com/${target.accountId}/workers/services/view/${target.worker}/production/deployments`\n    const site = new URL(target.siteUrl)\n    elements.push(\n      { type: 'mrkdwn', text: '·' },\n      { type: 'image', image_url: logos.cloudflare, alt_text: 'Cloudflare' },\n      { type: 'mrkdwn', text: `<${dashboard}|Version \\`${target.versionId.slice(0, 8)}\\`>` },\n      { type: 'mrkdwn', text: `·  :globe_with_meridians: <${site.origin}|${site.host}>` },\n    )\n  }\n  if (target.kind === 'publish' && target.version !== undefined) {\n    const npm = `https://www.npmjs.com/package/${target.packageName}/v/${target.version}`\n    elements.push(\n      { type: 'mrkdwn', text: '·' },\n      { type: 'image', image_url: logos.npm, alt_text: 'npm' },\n      { type: 'mrkdwn', text: `<${npm}|${target.packageName}@${target.version}>` },\n    )\n  }\n  return elements\n}\n\nfunction identityLine(run: CiRun, commit: CiCommit): string {\n  const repository = run.repository.split('/').at(-1) ?? run.repository\n  const ref =\n    run.ref.kind === 'pullRequest' ? `<${run.ref.url}|PR #${run.ref.number}>` : run.ref.name\n  const commitUrl = `https://github.com/${run.repository}/commit/${run.commitSha}`\n  return [\n    repository,\n    ref,\n    `<${commitUrl}|\\`${run.commitSha.slice(0, 7)}\\`>`,\n    escape(commit.author),\n  ].join('  ·  ')\n}\n\n// Slack mrkdwn treats these three characters as markup.\nfunction escape(text: string): string {\n  return text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;')\n}\n","import type { SlackMessage } from './ci-message.ts'\n\n/** Slack refused the message or could not be reached. */\nexport class SlackWebhookError extends Error {\n  readonly _tag = 'SlackWebhookError' as const\n\n  constructor(\n    readonly status: number | undefined,\n    override readonly cause: unknown,\n  ) {\n    super(status === undefined ? 'Slack webhook unreachable' : `Slack webhook returned ${status}`)\n  }\n}\n\n/**\n * Post one message to a Slack incoming webhook.\n * @throws {SlackWebhookError} when the request fails or Slack answers with an error status.\n */\nexport async function postSlackMessage(\n  webhookUrl: string,\n  message: SlackMessage,\n  fetcher: typeof fetch = fetch,\n): Promise<void> {\n  let response: Response\n  try {\n    response = await fetcher(webhookUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(message),\n      signal: AbortSignal.timeout(30_000),\n    })\n  } catch (cause) {\n    throw new SlackWebhookError(undefined, cause)\n  }\n  if (!response.ok) throw new SlackWebhookError(response.status, await response.text())\n}\n"],"mappings":";;;;AAoEA,IAAa,kBAAb,cAAqC,MAAM;CAI9B;CACS;CAJpB,AAAS,OAAO;CAEhB,YACE,AAAS,QACT,AAAkB,OAClB;EACA,MAAM,2BAA2B,OAAO,KAAK,IAAI,GAAG;EAH3C;EACS;CAGpB;AACF;AAEA,MAAM,gBAAgB,EAAE,KAAK;CAAC;CAAW;CAAW;CAAa;AAAS,CAAC;AAE3E,MAAM,cAAmC,UACvC,EACG,OAAO,CAAC,CACR,WAAW,MAAM,YAAY;CAC5B,IAAI;EAEF,OADuB,KAAK,MAAM,IACvB;CACb,QAAQ;EACN,QAAQ,SAAS;GAAE,MAAM;GAAU,SAAS;EAAe,CAAC;EAC5D,OAAO,EAAE;CACX;AACF,CAAC,CAAC,CACD,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC;AAErC,MAAM,cAAc,EAAE,OAAO;CAC3B,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,oBAAoB;CAC3C,YAAY,EAAE,OAAO,CAAC,CAAC,MAAM,gBAAgB;CAC7C,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACxB,SAAS,EAAE,QAAQ;CACnB,WAAW,WAAW,EAAE,OAAO,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;CACpE,YAAY,WAAW,EAAE,OAAO,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;CACtE,WAAW,EAAE,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACvD,QAAQ,EAAE,QAAQ,CAAC,CAAC,SAAS;CAC7B,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACrC,QAAQ,EAAE,KAAK;EAAC;EAAS;EAAU;CAAS,CAAC,CAAC,CAAC,QAAQ,OAAO;CAC9D,uBAAuB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CAClD,mBAAmB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CAC9C,UAAU,EAAE,QAAQ,CAAC,CAAC,SAAS;CAC/B,mBAAmB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CAC9C,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACxC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;AAC1C,CAAC;;;;;;AASD,SAAgB,WAAW,KAA0D;CACnF,MAAM,UAAU,OAAO,YAAY,OAAO,QAAQ,GAAG,CAAC,CAAC,QAAQ,GAAG,WAAW,UAAU,EAAE,CAAC;CAC1F,MAAM,SAAS,YAAY,UAAU,OAAO;CAC5C,IAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,UAAU,MAAM,KAAK,KAAK,GAAG,CAAC;EACtE,MAAM,IAAI,gBAAgB,QAAQ,OAAO,KAAK;CAChD;CACA,OAAO,QAAQ,OAAO,IAAI;AAC5B;AAEA,SAAS,QAAQ,KAAmB;CAClC,MAAM,MACJ,IAAI,cAAc,UAAa,IAAI,WAAW,UAAa,IAAI,aAAa,SACxE;EAAE,MAAM;EAAe,QAAQ,IAAI;EAAW,KAAK,IAAI;EAAQ,OAAO,IAAI;CAAS,IACnF;EAAE,MAAM;EAAU,MAAM,IAAI;CAAO;CACzC,OAAO;EACL,YAAY,IAAI;EAChB,WAAW,IAAI;EACf;EACA,QAAQ,IAAI;EACZ,MAAM,OAAO,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,UAAU;GAC5D,MAAM,YAAY,EAAE;GACpB,SAAS,IAAI;EACf,EAAE;EACF,OAAO,OAAO,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,WAAW;GAC/D,MAAM,YAAY,EAAE;GACpB,SAAS,KAAK;EAChB,EAAE;EACF,QAAQ,SAAS,GAAG;CACtB;AACF;AAEA,SAAS,SAAS,KAAsB;CACtC,QAAQ,IAAI,QAAZ;EACE,KAAK,SACH,OAAO,EAAE,MAAM,QAAQ;EACzB,KAAK,UAAU;GACb,MAAM,EAAE,uBAAuB,WAAW,mBAAmB,QAAQ,UAAU,YAAY;GAC3F,IAAI,cAAc,UAAa,WAAW,UAAa,YAAY,QACjE,MAAM,IAAI,gBACR;IAAC;IAAyB;IAAqB;GAAU,GACzD,MACF;GAEF,OAAO;IAAE,MAAM;IAAU;IAAW;IAAQ;IAAS,WAAW,IAAI;GAAkB;EACxF;EACA,KAAK;GACH,IAAI,IAAI,gBAAgB,QAAW,MAAM,IAAI,gBAAgB,CAAC,aAAa,GAAG,MAAS;GACvF,OAAO;IAAE,MAAM;IAAW,aAAa,IAAI;IAAa,SAAS,IAAI;GAAY;CACrF;AACF;AAGA,SAAS,YAAY,IAAoB;CACvC,MAAM,QAAQ,GAAG,WAAW,SAAS,GAAG;CACxC,OAAO,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,MAAM,MAAM,CAAC;AACtD;AAEA,MAAM,QAAQ;CACZ,OAAO;CACP,QAAQ;CACR,YAAY;CACZ,KAAK;AACP;;AAGA,SAAgB,eAAe,KAAY,QAAgC;CACzE,MAAM,WAAW,YAAY,GAAG;CAChC,MAAM,SAAS,IAAI,IAAI,SAAS,gBAAgB,IAAI,IAAI,QAAQ,OAAO;CACvE,OAAO;EACL,MAAM,GAAG,SAAS,KAAK;EACvB,QAAQ;GACN;IAAE,MAAM;IAAW,MAAM;KAAE,MAAM;KAAU,MAAM,IAAI,SAAS,KAAK,OAAO,MAAM;IAAI;GAAE;GACtF;IAAE,MAAM;IAAW,UAAU,aAAa,GAAG;GAAE;GAC/C;IAAE,MAAM;IAAW,UAAU,CAAC;KAAE,MAAM;KAAU,MAAM,aAAa,KAAK,MAAM;IAAE,CAAC;GAAE;EACrF;CACF;AACF;AAEA,SAAS,YAAY,KAAoB;CACvC,MAAM,aAAa,UAAU,IAAI,MAAM,SAAS;CAChD,IAAI,YAAY,OAAO,kBAAkB;CACzC,MAAM,gBAAgB,UAAU,IAAI,MAAM,WAAW;CACrD,IAAI,eAAe,OAAO,gCAAgC;CAC1D,MAAM,cAAc,UAAU,IAAI,OAAO,SAAS;CAClD,MAAM,EAAE,WAAW;CACnB,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO,cAAc,kBAAkB,gBAAgB;EACzD,KAAK;GACH,IAAI,aAAa,OAAO,sBAAsB;GAC9C,OAAO,OAAO,cAAc,SACxB,iCACA;EACN,KAAK;GACH,IAAI,aAAa,OAAO,uBAAuB;GAC/C,OAAO,OAAO,YAAY,SACtB,qDACA,gCAAgC,OAAO,YAAY,GAAG,OAAO;CACrE;AACF;AAEA,SAAS,UAAU,SAAsC,SAA4B;CACnF,OAAO,QACJ,QAAQ,WAAW,OAAO,YAAY,OAAO,CAAC,CAC9C,KAAK,WAAW,OAAO,IAAI,CAAC,CAC5B,KAAK,IAAI;AACd;AAEA,SAAS,aAAa,KAAyC;CAC7D,MAAM,UAAU,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;CAEpC,MAAM,WAA2B,CAC/B;EAAE,MAAM;EAAS,WAFH,QAAQ,SAAS,YAAY,IAAI,MAAM,SAAS,MAAM;EAE/B,UAAU;CAAQ,GACvD;EAAE,MAAM;EAAU,MAAM,IAAI,IAAI,OAAO;CAAU,CACnD;CACA,MAAM,EAAE,WAAW;CACnB,IAAI,OAAO,SAAS,YAAY,OAAO,cAAc,QAAW;EAC9D,MAAM,YAAY,+BAA+B,OAAO,UAAU,yBAAyB,OAAO,OAAO;EACzG,MAAM,OAAO,IAAI,IAAI,OAAO,OAAO;EACnC,SAAS,KACP;GAAE,MAAM;GAAU,MAAM;EAAI,GAC5B;GAAE,MAAM;GAAS,WAAW,MAAM;GAAY,UAAU;EAAa,GACrE;GAAE,MAAM;GAAU,MAAM,IAAI,UAAU,aAAa,OAAO,UAAU,MAAM,GAAG,CAAC,EAAE;EAAK,GACrF;GAAE,MAAM;GAAU,MAAM,8BAA8B,KAAK,OAAO,GAAG,KAAK,KAAK;EAAG,CACpF;CACF;CACA,IAAI,OAAO,SAAS,aAAa,OAAO,YAAY,QAAW;EAC7D,MAAM,MAAM,iCAAiC,OAAO,YAAY,KAAK,OAAO;EAC5E,SAAS,KACP;GAAE,MAAM;GAAU,MAAM;EAAI,GAC5B;GAAE,MAAM;GAAS,WAAW,MAAM;GAAK,UAAU;EAAM,GACvD;GAAE,MAAM;GAAU,MAAM,IAAI,IAAI,GAAG,OAAO,YAAY,GAAG,OAAO,QAAQ;EAAG,CAC7E;CACF;CACA,OAAO;AACT;AAEA,SAAS,aAAa,KAAY,QAA0B;CAK1D,OAAO;EAJY,IAAI,WAAW,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,IAAI;EAEzD,IAAI,IAAI,SAAS,gBAAgB,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI;EAKpF,IAAI,sBAJkC,IAAI,WAAW,UAAU,IAAI,YAIrD,KAAK,IAAI,UAAU,MAAM,GAAG,CAAC,EAAE;EAC7C,OAAO,OAAO,MAAM;CACtB,CAAC,CAAC,KAAK,OAAO;AAChB;AAGA,SAAS,OAAO,MAAsB;CACpC,OAAO,KAAK,WAAW,KAAK,OAAO,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,WAAW,KAAK,MAAM;AACrF;;;;;AChRA,IAAa,oBAAb,cAAuC,MAAM;CAIhC;CACS;CAJpB,AAAS,OAAO;CAEhB,YACE,AAAS,QACT,AAAkB,OAClB;EACA,MAAM,WAAW,SAAY,8BAA8B,0BAA0B,QAAQ;EAHpF;EACS;CAGpB;AACF;;;;;AAMA,eAAsB,iBACpB,YACA,SACA,UAAwB,OACT;CACf,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,QAAQ,YAAY;GACnC,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,OAAO;GAC5B,QAAQ,YAAY,QAAQ,GAAM;EACpC,CAAC;CACH,SAAS,OAAO;EACd,MAAM,IAAI,kBAAkB,QAAW,KAAK;CAC9C;CACA,IAAI,CAAC,SAAS,IAAI,MAAM,IAAI,kBAAkB,SAAS,QAAQ,MAAM,SAAS,KAAK,CAAC;AACtF"}

package/dist/slack.d.ts

@@ -0,0 +1,102 @@
+//#region src/infrastructure/slack/ci-message.d.ts
+/** The result of one CI job or step, in GitHub Actions terms. */
+type CiOutcome = 'success' | 'failure' | 'cancelled' | 'skipped';
+/** What the run delivers after its checks pass. */
+type CiTarget = {
+  readonly kind: 'check';
+} | {
+  readonly kind: 'deploy';
+  readonly accountId: string;
+  readonly worker: string;
+  readonly siteUrl: string;
+  /** Absent when the run reached no deploy, such as a pull request. */
+  readonly versionId: string | undefined;
+} | {
+  readonly kind: 'publish';
+  readonly packageName: string;
+  /** Absent when npm already has the package version. */
+  readonly version: string | undefined;
+};
+/** One CI run, parsed from the environment that the workflow sets. */
+interface CiRun {
+  readonly repository: string;
+  readonly commitSha: string;
+  readonly ref: {
+    readonly kind: 'branch';
+    readonly name: string;
+  } | {
+    readonly kind: 'pullRequest';
+    readonly number: number;
+    readonly url: string;
+    readonly title: string;
+  };
+  readonly runUrl: string;
+  readonly jobs: ReadonlyArray<CiStepResult>;
+  readonly steps: ReadonlyArray<CiStepResult>;
+  readonly target: CiTarget;
+}
+/** A named job or step and its outcome. */
+interface CiStepResult {
+  readonly name: string;
+  readonly outcome: CiOutcome;
+}
+/** The commit facts that only git knows. */
+interface CiCommit {
+  readonly subject: string;
+  readonly author: string;
+}
+/** A Slack incoming-webhook payload. */
+interface SlackMessage {
+  readonly text: string;
+  readonly blocks: ReadonlyArray<SlackBlock>;
+}
+type SlackElement = {
+  readonly type: 'mrkdwn';
+  readonly text: string;
+} | {
+  readonly type: 'image';
+  readonly image_url: string;
+  readonly alt_text: string;
+};
+type SlackBlock = {
+  readonly type: 'section';
+  readonly text: {
+    readonly type: 'mrkdwn';
+    readonly text: string;
+  };
+} | {
+  readonly type: 'context';
+  readonly elements: ReadonlyArray<SlackElement>;
+};
+/** The CI environment could not be parsed. `issues` names each invalid variable. */
+export declare class CiRunParseError extends Error {
+  readonly issues: ReadonlyArray<string>;
+  readonly cause: unknown;
+  readonly _tag: 'CiRunParseError';
+  constructor(issues: ReadonlyArray<string>, cause: unknown);
+}
+/**
+ * Parse the variables that a workflow passes to the notifier. GitHub expressions render a
+ * missing value as an empty string, so an empty variable counts as unset.
+ * @throws {CiRunParseError} when a variable is missing or invalid.
+ */
+export declare function parseCiRun(env: Readonly<Record<string, string | undefined>>): CiRun;
+/** Build the four-line CI message: result, change, links, and identity. */
+export declare function buildCiMessage(run: CiRun, commit: CiCommit): SlackMessage;
+//#endregion
+//#region src/infrastructure/slack/slack-webhook.d.ts
+/** Slack refused the message or could not be reached. */
+export declare class SlackWebhookError extends Error {
+  readonly status: number | undefined;
+  readonly cause: unknown;
+  readonly _tag: 'SlackWebhookError';
+  constructor(status: number | undefined, cause: unknown);
+}
+/**
+ * Post one message to a Slack incoming webhook.
+ * @throws {SlackWebhookError} when the request fails or Slack answers with an error status.
+ */
+export declare function postSlackMessage(webhookUrl: string, message: SlackMessage, fetcher?: typeof fetch): Promise<void>;
+//#endregion
+export type { CiCommit, CiOutcome, CiRun, CiStepResult, CiTarget, SlackMessage };
+//# sourceMappingURL=slack.d.ts.map

package/dist/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","names":[],"sources":["../src/infrastructure/slack/ci-message.ts","../src/infrastructure/slack/slack-webhook.ts"],"mappings":";;KAGY;;KAGA;WACG;;WAEA;WACA;WACA;WACA;;WAEA;;WAGA;WACA;;WAEA;;;UAIE;WACN;WACA;WACA;aACM;aAAyB;;aAEzB;aACA;aACA;aACA;;WAEN;WACA,MAAM,cAAc;WACpB,OAAO,cAAc;WACrB,QAAQ;;;UAIF;WACN;WACA,SAAS;;;UAIH;WACN;WACA;;;UAIM;WACN;WACA,QAAQ,cAAc;;KAG5B;WACU;WAAyB;;WACzB;WAAwB;WAA4B;;KAE9D;WACU;WAA0B;aAAiB;aAAyB;;;WACpE;WAA0B,UAAU,cAAc;;;qBAGpD,wBAAwB;WAIxB,QAAQ;WACC;WAJX;EAET,YACW,QAAQ,uBACC;;;;;;;wBAgDN,WAAW,KAAK,SAAS,sCAAsC;;wBAkE/D,eAAe,KAAK,OAAO,QAAQ,WAAW;;;;qBCxLjD,0BAA0B;WAI1B;WACS;WAJX;EAET,YACW,4BACS;;;;;;wBAUA,iBACpB,oBACA,SAAS,cACT,iBAAgB,QACf"}

package/dist/slack.js

@@ -0,0 +1,3 @@
+import { a as parseCiRun, i as buildCiMessage, n as postSlackMessage, r as CiRunParseError, t as SlackWebhookError } from "./slack-webhook-j1FCPeu8.js";
+
+export { CiRunParseError, SlackWebhookError, buildCiMessage, parseCiRun, postSlackMessage };

package/dist/stripe/client.js

@@ -1,20 +1,3 @@
-import Stripe from "stripe";
+import { n as createStripeClient, t as STRIPE_REQUEST_OPTIONS } from "../client-Dv1Ch7yY.js";
 
-//#region src/infrastructure/stripe/client.ts
-/** Default SDK retries; client configuration and individual requests can override this value. */
-const STRIPE_REQUEST_OPTIONS = Object.freeze({ maxNetworkRetries: 2 });
-/**
-* Construct a native Stripe client with fetch transport and two SDK retries by default.
-* Native configuration overrides these defaults. Inject the client into application services.
-*/
-function createStripeClient(secretKey, options = {}) {
-	return new Stripe(secretKey, {
-		httpClient: Stripe.createFetchHttpClient(),
-		...STRIPE_REQUEST_OPTIONS,
-		...options
-	});
-}
-
-//#endregion
-export { STRIPE_REQUEST_OPTIONS, createStripeClient };
-//# sourceMappingURL=client.js.map
+export { STRIPE_REQUEST_OPTIONS, createStripeClient };

package/dist/stripe/payment-service.d.ts

@@ -1,51 +1,2 @@
-import Stripe from "stripe";
-//#region src/infrastructure/stripe/payment-service.d.ts
-/** Supply the same key and parameters when repeating one durable payment attempt. */
-export type PaymentRequestOptions = Stripe.RequestOptions & Required<Pick<Stripe.RequestOptions, 'idempotencyKey'>>;
-/** Native Checkout parameters; the service selects payment or setup mode. */
-export type CheckoutInput = Omit<Stripe.Checkout.SessionCreateParams, 'mode'>;
-/** A saved customer method; the service confirms the payment off-session. */
-export type SavedMethodCharge = Omit<Stripe.PaymentIntentCreateParams, 'confirm' | 'off_session'> & Required<Pick<Stripe.PaymentIntentCreateParams, 'customer' | 'payment_method'>>;
-/** Native customer response, including Stripe request metadata. */
-export type CustomerResult = Awaited<ReturnType<Stripe['customers']['create']>>;
-/** Native Checkout response. Its URL can be null; this does not confirm payment. */
-export type CheckoutResult = Awaited<ReturnType<Stripe['checkout']['sessions']['create']>>;
-/** Native PaymentIntent response. Applications decide what each status permits. */
-export type PaymentResult = Awaited<ReturnType<Stripe['paymentIntents']['create']>>;
-/**
- * Stripe payment operations, with native types and stable keys for mutations.
- * Rejects with PaymentServiceError for Stripe failures; non-Stripe failures propagate unchanged.
- */
-export interface IPaymentService {
-  /** Create a customer; the application owns persistence and reuse of the customer link. */
-  createCustomer(input: Stripe.CustomerCreateParams, options: PaymentRequestOptions): Promise<CustomerResult>;
-  /** Create one-time payment checkout; application fulfillment requires verified payment confirmation. */
-  createCheckout(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult>;
-  /** Create checkout in setup mode. The application records consent and verifies the saved method's owner. */
-  setupPaymentMethod(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult>;
-  /** Confirm a saved method off-session. PaymentServiceError retains card errors in cause. */
-  chargeSavedMethod(input: SavedMethodCharge, options: PaymentRequestOptions): Promise<PaymentResult>;
-  /** Retrieve an existing payment without starting another payment attempt. */
-  getPayment(paymentId: string, params?: Stripe.PaymentIntentRetrieveParams, options?: Stripe.RequestOptions): Promise<PaymentResult>;
-}
-/**
- * Ported from Typist's StripeClient request boundary; the native SDK now owns retries.
- * The injected client owns retry and timeout defaults. Native request options can override them.
- */
-export declare class StripePaymentService implements IPaymentService {
-  private readonly stripe;
-  /** Inject a native SDK instance; its transport, credentials, and API version remain caller-owned. */
-  constructor(stripe: Stripe);
-  /** Create a customer with a stable application key and preserve the native response. */
-  createCustomer(input: Stripe.CustomerCreateParams, options: PaymentRequestOptions): Promise<CustomerResult>;
-  /** Force payment mode after caller parameters; return the native Checkout Session. */
-  createCheckout(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult>;
-  /** Force setup mode after caller parameters; this operation does not charge the customer. */
-  setupPaymentMethod(input: CheckoutInput, options: PaymentRequestOptions): Promise<CheckoutResult>;
-  /** Force confirmation and off-session use; retain native card failures in PaymentServiceError.cause. */
-  chargeSavedMethod(input: SavedMethodCharge, options: PaymentRequestOptions): Promise<PaymentResult>;
-  /** Preserve every native status and response field when reconciling an existing payment. */
-  getPayment(paymentId: string, params?: Stripe.PaymentIntentRetrieveParams, options?: Stripe.RequestOptions): Promise<PaymentResult>;
-}
-//#endregion
-//# sourceMappingURL=payment-service.d.ts.map
+import { a as PaymentRequestOptions, c as StripePaymentService, i as IPaymentService, n as CheckoutResult, o as PaymentResult, r as CustomerResult, s as SavedMethodCharge, t as CheckoutInput } from "../payment-service-DUYd3Itt.js";
+export { CheckoutInput, CheckoutResult, CustomerResult, IPaymentService, PaymentRequestOptions, PaymentResult, SavedMethodCharge, StripePaymentService };

package/dist/stripe/payment-service.error.js

@@ -1,30 +1,3 @@
-import { nt as AppError } from "../core-BiN6S_cm.js";
-import Stripe from "stripe";
+import { t as PaymentServiceError } from "../payment-service.error-CqF7GkNp.js";
 
-//#region src/infrastructure/stripe/payment-service.error.ts
-/** A final Stripe request failure. The caller logs once; native details remain in cause. */
-var PaymentServiceError = class extends AppError {
-	operation;
-	_tag = "PaymentServiceError";
-	classification;
-	/** Classify the final SDK error without scheduling another payment attempt. */
-	constructor(operation, cause) {
-		super(`Stripe request failed: ${operation}`, { cause });
-		this.operation = operation;
-		this.classification = classifyStripeError(cause);
-	}
-};
-function classifyStripeError(error) {
-	if (error.headers?.["stripe-should-retry"] === "false") return "terminal";
-	const status = error.statusCode;
-	if (status !== void 0 && status >= 400 && status < 500 && status !== 409 && status !== 429) return "terminal";
-	if (error instanceof Stripe.errors.StripeAuthenticationError || error instanceof Stripe.errors.StripePermissionError || error instanceof Stripe.errors.StripeInvalidRequestError || error instanceof Stripe.errors.StripeIdempotencyError || error instanceof Stripe.errors.StripeCardError) return "terminal";
-	if (error.headers?.["stripe-should-retry"] === "true") return "transient";
-	if (status === 409 || status === 429 || status !== void 0 && status >= 500) return "transient";
-	if (error instanceof Stripe.errors.StripeConnectionError || error instanceof Stripe.errors.StripeAPIError || error instanceof Stripe.errors.StripeRateLimitError) return "transient";
-	return "unknown";
-}
-
-//#endregion
-export { PaymentServiceError };
-//# sourceMappingURL=payment-service.error.js.map
+export { PaymentServiceError };

package/dist/stripe/payment-service.js

@@ -1,4 +1,4 @@
-import { stripeRequest } from "./request.js";
+import { t as stripeRequest } from "../request-4vJEWxyZ.js";
 
 //#region src/infrastructure/stripe/payment-service.ts
 /**

package/dist/stripe/request.js

@@ -1,21 +1,3 @@
-import { PaymentServiceError } from "./payment-service.error.js";
-import Stripe from "stripe";
+import { t as stripeRequest } from "../request-4vJEWxyZ.js";
 
-//#region src/infrastructure/stripe/request.ts
-/**
-* Invoke one SDK operation; the SDK owns retries configured on its client or request.
-* Convert every Stripe error to PaymentServiceError without logging; preserve the original error in cause.
-* Non-Stripe failures propagate unchanged.
-*/
-async function stripeRequest(operation, work) {
-	try {
-		return await work();
-	} catch (cause) {
-		if (!(cause instanceof Stripe.errors.StripeError)) throw cause;
-		throw new PaymentServiceError(operation, cause);
-	}
-}
-
-//#endregion
-export { stripeRequest };
-//# sourceMappingURL=request.js.map
+export { stripeRequest };

package/dist/stripe-fixture-yFUknTJO.js

@@ -0,0 +1,33 @@
+import { n as createStripeClient } from "./client-Dv1Ch7yY.js";
+import Stripe from "stripe";
+
+//#region src/infrastructure/testing/stripe-fixture.ts
+/**
+* Construct the real SDK with a fake fetch transport and an ordered record of HTTP attempts.
+* The responder receives an unread request. The shared client factory supplies retry defaults.
+*/
+function stripeFixture(respond) {
+	const requests = [];
+	return {
+		stripe: createStripeClient("sk_test_fixture", { httpClient: Stripe.createFetchHttpClient(async (input, init) => {
+			const request = new Request(input, init);
+			const url = new URL(request.url);
+			const call = {
+				method: request.method,
+				path: url.pathname,
+				query: url.searchParams,
+				body: new URLSearchParams(),
+				headers: new Headers(request.headers)
+			};
+			requests.push(call);
+			const body = new TextDecoder().decode(await request.clone().arrayBuffer());
+			for (const [key, value] of new URLSearchParams(body)) call.body.append(key, value);
+			return respond(request);
+		}) }),
+		requests
+	};
+}
+
+//#endregion
+export { stripeFixture as t };
+//# sourceMappingURL=stripe-fixture-yFUknTJO.js.map

package/dist/stripe-fixture-yFUknTJO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-fixture-yFUknTJO.js","names":[],"sources":["../src/infrastructure/testing/stripe-fixture.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { createStripeClient } from '../stripe/client.ts'\n\n/** One SDK HTTP attempt; query and body expose Stripe's URL-encoded parameters. */\nexport type StripeCall = {\n  readonly method: string\n  readonly path: string\n  readonly query: URLSearchParams\n  readonly body: URLSearchParams\n  readonly headers: Headers\n}\n\ntype StripeFixture = { stripe: Stripe; requests: readonly StripeCall[] }\n\n/**\n * Construct the real SDK with a fake fetch transport and an ordered record of HTTP attempts.\n * The responder receives an unread request. The shared client factory supplies retry defaults.\n */\nexport function stripeFixture(\n  respond: (request: Request) => Response | Promise<Response>,\n): StripeFixture {\n  const requests: StripeCall[] = []\n  const stripe = createStripeClient('sk_test_fixture', {\n    httpClient: Stripe.createFetchHttpClient(async (input, init) => {\n      const request = new Request(input, init)\n      const url = new URL(request.url)\n      const call: StripeCall = {\n        method: request.method,\n        path: url.pathname,\n        query: url.searchParams,\n        body: new URLSearchParams(),\n        headers: new Headers(request.headers),\n      }\n      requests.push(call)\n      const body = new TextDecoder().decode(await request.clone().arrayBuffer())\n      for (const [key, value] of new URLSearchParams(body)) call.body.append(key, value)\n      return respond(request)\n    }),\n  })\n  return { stripe, requests }\n}\n"],"mappings":";;;;;;;;AAmBA,SAAgB,cACd,SACe;CACf,MAAM,WAAyB,CAAC;CAkBhC,OAAO;EAAE,QAjBM,mBAAmB,mBAAmB,EACnD,YAAY,OAAO,sBAAsB,OAAO,OAAO,SAAS;GAC9D,MAAM,UAAU,IAAI,QAAQ,OAAO,IAAI;GACvC,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;GAC/B,MAAM,OAAmB;IACvB,QAAQ,QAAQ;IAChB,MAAM,IAAI;IACV,OAAO,IAAI;IACX,MAAM,IAAI,gBAAgB;IAC1B,SAAS,IAAI,QAAQ,QAAQ,OAAO;GACtC;GACA,SAAS,KAAK,IAAI;GAClB,MAAM,OAAO,IAAI,YAAY,CAAC,CAAC,OAAO,MAAM,QAAQ,MAAM,CAAC,CAAC,YAAY,CAAC;GACzE,KAAK,MAAM,CAAC,KAAK,UAAU,IAAI,gBAAgB,IAAI,GAAG,KAAK,KAAK,OAAO,KAAK,KAAK;GACjF,OAAO,QAAQ,OAAO;EACxB,CAAC,EACH,CACc;EAAG;CAAS;AAC5B"}

package/dist/testing/payment-service.d.ts

@@ -1,4 +1,4 @@
-import { IPaymentService } from "../stripe/payment-service.js";
+import { i as IPaymentService } from "../payment-service-DUYd3Itt.js";
 import Stripe from "stripe";
 //#region src/infrastructure/testing/payment-service-contract.d.ts
 /**

package/dist/testing/payment-service.js

@@ -1,5 +1,5 @@
-import { PaymentServiceError } from "../stripe/payment-service.error.js";
-import { stripeFixture } from "./stripe.js";
+import { t as PaymentServiceError } from "../payment-service.error-CqF7GkNp.js";
+import { t as stripeFixture } from "../stripe-fixture-yFUknTJO.js";
 import Stripe from "stripe";
 import { deepStrictEqual, equal, ok, rejects } from "node:assert/strict";
 

package/dist/testing/stripe.js

@@ -1,33 +1,3 @@
-import { createStripeClient } from "../stripe/client.js";
-import Stripe from "stripe";
+import { t as stripeFixture } from "../stripe-fixture-yFUknTJO.js";
 
-//#region src/infrastructure/testing/stripe-fixture.ts
-/**
-* Construct the real SDK with a fake fetch transport and an ordered record of HTTP attempts.
-* The responder receives an unread request. The shared client factory supplies retry defaults.
-*/
-function stripeFixture(respond) {
-	const requests = [];
-	return {
-		stripe: createStripeClient("sk_test_fixture", { httpClient: Stripe.createFetchHttpClient(async (input, init) => {
-			const request = new Request(input, init);
-			const url = new URL(request.url);
-			const call = {
-				method: request.method,
-				path: url.pathname,
-				query: url.searchParams,
-				body: new URLSearchParams(),
-				headers: new Headers(request.headers)
-			};
-			requests.push(call);
-			const body = new TextDecoder().decode(await request.clone().arrayBuffer());
-			for (const [key, value] of new URLSearchParams(body)) call.body.append(key, value);
-			return respond(request);
-		}) }),
-		requests
-	};
-}
-
-//#endregion
-export { stripeFixture };
-//# sourceMappingURL=stripe.js.map
+export { stripeFixture };

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "better-ship",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Foundation for applications on Cloudflare Workers: logger, errors, message bus, infrastructure adapters, and UI primitives",
   "license": "Apache-2.0",
   "repository": {
@@ -9,6 +9,9 @@
     "url": "git+https://github.com/alexander-zuev/better-ship.git",
     "directory": "packages/better-ship"
   },
+  "bin": {
+    "better-ship-notify-ci": "./dist/bin/notify-ci.js"
+  },
   "files": [
     "dist",
     "src"
@@ -23,6 +26,7 @@
     "./better-auth/secondary-storage": "./dist/better-auth/secondary-storage.js",
     "./better-auth/stripe": "./dist/better-auth/stripe.js",
     "./billing/client": "./dist/billing/client.js",
+    "./bin/notify-ci": "./dist/bin/notify-ci.js",
     "./cloudflare": "./dist/cloudflare.js",
     "./cloudflare/auth-secondary-storage": "./dist/cloudflare/auth-secondary-storage.js",
     "./cloudflare/durable-object-client": "./dist/cloudflare/durable-object-client.js",
@@ -46,6 +50,7 @@
     "./sentry/server": "./dist/sentry/server.js",
     "./sentry/tanstack": "./dist/sentry/tanstack.js",
     "./sentry/vite": "./dist/sentry/vite.js",
+    "./slack": "./dist/slack.js",
     "./stripe/client": "./dist/stripe/client.js",
     "./stripe/event-map": "./dist/stripe/event-map.js",
     "./stripe/payment-service": "./dist/stripe/payment-service.js",