@storyshelf/notify-chat 0.5.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddhant Gupta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @storyshelf/notify-chat
+
+Chat notification providers for StoryShelf: formatted build and admin alerts over Slack and Teams incoming webhooks (plus a log provider for tests/dev). Zero runtime dependencies — all sends go through `@storyshelf/core/utils` (`httpText`: timeout + retry with `Retry-After`).
+
+## Install
+
+```sh
+nub add @storyshelf/notify-chat
+```
+
+## Quick start
+
+```ts
+import { createShelfApp } from "@storyshelf/app";
+import { chatNotifiers } from "@storyshelf/notify-chat";
+
+const app = createShelfApp({ database, storage, notifiers: chatNotifiers });
+```
+
+## Subpaths
+
+Each provider is importable on its own (root aggregates all three):
+
+```ts
+import { slackWebhookNotifier } from "@storyshelf/notify-chat/slack";
+import { teamsWorkflowNotifier } from "@storyshelf/notify-chat/teams";
+import { logNotifier } from "@storyshelf/notify-chat/log";
+```
+
+Project admins then add channels (`slack-webhook`, `teams-workflow`, `log`) with an event filter and display toggles. Webhook URLs are channel secrets (AES-256-GCM at rest, decrypted in memory at send time). See [Notifications](/guides/notifications/).

package/dist/index.d.mts

@@ -0,0 +1,12 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { logConfigSchema, logNotifier } from "./log.mjs";
+import { ChatToggles, chatTogglesSchema } from "./types.mjs";
+import { slackWebhookConfigSchema, slackWebhookNotifier } from "./slack.mjs";
+import { teamsWorkflowConfigSchema, teamsWorkflowNotifier } from "./teams.mjs";
+//#region src/index.d.ts
+/** All chat providers in one list for `ShelfOptions.notifiers`. */
+declare const chatNotifiers: import("@storyshelf/core/adapter/notifier").NotifierProvider[];
+//#endregion
+export { type ChatToggles, chatNotifiers, chatTogglesSchema, logConfigSchema, logNotifier, slackWebhookConfigSchema, slackWebhookNotifier, teamsWorkflowConfigSchema, teamsWorkflowNotifier };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,22 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { logConfigSchema, logNotifier } from "./log.mjs";
+import { chatTogglesSchema } from "./types.mjs";
+import { slackWebhookConfigSchema, slackWebhookNotifier } from "./slack.mjs";
+import { teamsWorkflowConfigSchema, teamsWorkflowNotifier } from "./teams.mjs";
+//#region src/index.ts
+/**
+* Chat notification providers: formatted build and admin alerts over
+* Slack and Teams incoming webhooks (plus a log provider for tests/dev).
+*/
+/** All chat providers in one list for `ShelfOptions.notifiers`. */
+const chatNotifiers = [
+	slackWebhookNotifier,
+	teamsWorkflowNotifier,
+	logNotifier
+];
+//#endregion
+export { chatNotifiers, chatTogglesSchema, logConfigSchema, logNotifier, slackWebhookConfigSchema, slackWebhookNotifier, teamsWorkflowConfigSchema, teamsWorkflowNotifier };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Chat notification providers: formatted build and admin alerts over\n * Slack and Teams incoming webhooks (plus a log provider for tests/dev).\n */\nimport { logNotifier } from \"./log.ts\";\nimport { slackWebhookNotifier } from \"./slack.ts\";\nimport { teamsWorkflowNotifier } from \"./teams.ts\";\n\n/** Slack incoming-webhook provider (`slack-webhook`). */\nexport { slackWebhookNotifier };\n/** Teams workflow-webhook provider (`teams-workflow`). */\nexport { teamsWorkflowNotifier };\n/** Log-only provider for tests, dev, and unconfigured servers (`log`). */\nexport { logNotifier };\n\n/** All chat providers in one list for `ShelfOptions.notifiers`. */\nexport const chatNotifiers = [slackWebhookNotifier, teamsWorkflowNotifier, logNotifier];\n\nexport type { ChatToggles } from \"./types.ts\";\nexport { chatTogglesSchema } from \"./types.ts\";\nexport { logConfigSchema } from \"./log.ts\";\nexport { slackWebhookConfigSchema } from \"./slack.ts\";\nexport { teamsWorkflowConfigSchema } from \"./teams.ts\";\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,gBAAgB;CAAC;CAAsB;CAAuB;AAAW"}

package/dist/log.d.mts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { z } from "zod";
+import { NotifierProvider } from "@storyshelf/core/adapter/notifier";
+//#region src/log.d.ts
+/** Validation schema for the log provider config (accepts anything). */
+declare const logConfigSchema: z.ZodObject<{}, z.core.$loose>;
+/** Log-only chat provider for tests, dev, and unconfigured servers. */
+declare const logNotifier: NotifierProvider;
+/** Describe the log provider (name, version, config schema). */
+declare function getMetadata(): NotifierProvider["metadata"];
+//#endregion
+export { getMetadata, logConfigSchema, logNotifier };
+//# sourceMappingURL=log.d.mts.map

package/dist/log.mjs

@@ -0,0 +1,39 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { z } from "zod";
+//#region src/log.ts
+/** Validation schema for the log provider config (accepts anything). */
+const logConfigSchema = z.object({}).loose();
+/** Log-only chat provider for tests, dev, and unconfigured servers. */
+const logNotifier = {
+	metadata: getMetadata(),
+	create(opts) {
+		logConfigSchema.parse(opts.config);
+		const logger = opts.logger?.child({ component: "notify-chat-log" }) ?? opts.logger;
+		return {
+			metadata: getMetadata(),
+			async send(input) {
+				logger?.info({
+					channelId: input.channel.id,
+					subject: input.formatted.subject
+				}, "chat notification (log)");
+			}
+		};
+	}
+};
+/** Describe the log provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "Log",
+		version: globalThis.__PKG_VERSION__ ?? "0.0.0",
+		description: "Chat notifications to the server log (tests and dev)",
+		kind: "log",
+		category: "notifier",
+		schema: logConfigSchema
+	};
+}
+//#endregion
+export { getMetadata, logConfigSchema, logNotifier };
+
+//# sourceMappingURL=log.mjs.map

package/dist/log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.mjs","names":[],"sources":["../src/log.ts"],"sourcesContent":["import type { NotifierAdapter, NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { z } from \"zod\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Validation schema for the log provider config (accepts anything). */\nexport const logConfigSchema = z.object({}).loose();\n\n/** Log-only chat provider for tests, dev, and unconfigured servers. */\nexport const logNotifier: NotifierProvider = {\n  metadata: getMetadata(),\n  create(opts: { config: unknown; secret?: string; logger?: Logger }): NotifierAdapter {\n    logConfigSchema.parse(opts.config);\n    const logger = opts.logger?.child({ component: \"notify-chat-log\" }) ?? opts.logger;\n    return {\n      metadata: getMetadata(),\n      // oxlint-disable-next-line eslint/require-await -- send is async by contract\n      async send(input): Promise<void> {\n        logger?.info(\n          { channelId: input.channel.id, subject: input.formatted.subject },\n          \"chat notification (log)\",\n        );\n      },\n    };\n  },\n};\n\n/** Describe the log provider (name, version, config schema). */\nexport function getMetadata(): NotifierProvider[\"metadata\"] {\n  return {\n    name: \"Log\",\n    version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n    description: \"Chat notifications to the server log (tests and dev)\",\n    kind: \"log\",\n    category: \"notifier\",\n    schema: logConfigSchema,\n  };\n}\n"],"mappings":";;;;;;AAOA,MAAa,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM;;AAGlD,MAAa,cAAgC;CAC3C,UAAU,YAAY;CACtB,OAAO,MAA8E;EACnF,gBAAgB,MAAM,KAAK,MAAM;EACjC,MAAM,SAAS,KAAK,QAAQ,MAAM,EAAE,WAAW,kBAAkB,CAAC,KAAK,KAAK;EAC5E,OAAO;GACL,UAAU,YAAY;GAEtB,MAAM,KAAK,OAAsB;IAC/B,QAAQ,KACN;KAAE,WAAW,MAAM,QAAQ;KAAI,SAAS,MAAM,UAAU;IAAQ,GAChE,yBACF;GACF;EACF;CACF;AACF;;AAGA,SAAgB,cAA4C;CAC1D,OAAO;EACL,MAAM;EACN,SAAU,WAAuD,mBAAmB;EACpF,aAAa;EACb,MAAM;EACN,UAAU;EACV,QAAQ;CACV;AACF"}

package/dist/slack.d.mts

@@ -0,0 +1,24 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ChatToggles } from "./types.mjs";
+import { NotifierProvider } from "@storyshelf/core/adapter/notifier";
+//#region src/slack.d.ts
+/** Validation schema for the Slack incoming-webhook config. */
+declare const slackWebhookConfigSchema: import("zod").ZodObject<{
+  style: import("zod").ZodOptional<import("zod").ZodEnum<{
+    compact: "compact";
+    verbose: "verbose";
+  }>>;
+  subjectPrefix: import("zod").ZodOptional<import("zod").ZodString>;
+  includeAuthor: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  includeMessage: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  includeCounts: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  username: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+/** Slack incoming-webhook chat provider (Block Kit section + fallback text). */
+declare const slackWebhookNotifier: NotifierProvider;
+/** Describe the Slack provider (name, version, config schema). */
+declare function getMetadata(): NotifierProvider["metadata"];
+//#endregion
+export { type ChatToggles, getMetadata, slackWebhookConfigSchema, slackWebhookNotifier };
+//# sourceMappingURL=slack.d.mts.map

package/dist/slack.mjs

@@ -0,0 +1,67 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { chatTogglesSchema } from "./types.mjs";
+import { httpText } from "@storyshelf/core/utils";
+//#region src/slack.ts
+/** Validation schema for the Slack incoming-webhook config. */
+const slackWebhookConfigSchema = chatTogglesSchema;
+/** Slack incoming-webhook chat provider (Block Kit section + fallback text). */
+const slackWebhookNotifier = {
+	metadata: getMetadata(),
+	create(opts) {
+		return createSlackAdapter({
+			config: slackWebhookConfigSchema.parse(opts.config),
+			webhookUrl: opts.secret,
+			logger: opts.logger
+		});
+	}
+};
+/** Describe the Slack provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "Slack",
+		version: globalThis.__PKG_VERSION__ ?? "0.0.0",
+		description: "Chat messages via Slack incoming webhooks",
+		kind: "slack-webhook",
+		category: "notifier",
+		logo: "slack",
+		schema: slackWebhookConfigSchema
+	};
+}
+function createSlackAdapter(options) {
+	const logger = options.logger?.child({ component: "notify-chat-slack" });
+	return {
+		metadata: getMetadata(),
+		async send(input) {
+			const url = requireWebhookUrl(options.webhookUrl);
+			const payload = {
+				text: input.formatted.subject,
+				username: options.config.username,
+				blocks: [{
+					type: "section",
+					text: {
+						type: "mrkdwn",
+						text: input.formatted.markdown
+					}
+				}]
+			};
+			logger?.debug({ channelId: input.channel.id }, "posting slack message");
+			await httpText(url, {
+				method: "POST",
+				json: payload,
+				logger
+			});
+			logger?.info({ channelId: input.channel.id }, "slack message posted");
+		}
+	};
+}
+/** Incoming-webhook URL arrives as the decrypted channel secret. */
+function requireWebhookUrl(secret) {
+	if (!secret) throw new Error("Slack channel is missing its webhook URL secret");
+	return secret;
+}
+//#endregion
+export { getMetadata, slackWebhookConfigSchema, slackWebhookNotifier };
+
+//# sourceMappingURL=slack.mjs.map

package/dist/slack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.mjs","names":[],"sources":["../src/slack.ts"],"sourcesContent":["import type { NotifierAdapter, NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { httpText } from \"@storyshelf/core/utils\";\nimport { chatTogglesSchema, type ChatToggles } from \"./types.ts\";\n\nexport type { ChatToggles };\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Validation schema for the Slack incoming-webhook config. */\nexport const slackWebhookConfigSchema = chatTogglesSchema;\n\n/** Slack incoming-webhook chat provider (Block Kit section + fallback text). */\nexport const slackWebhookNotifier: NotifierProvider = {\n  metadata: getMetadata(),\n  create(opts: { config: unknown; secret?: string; logger?: Logger }): NotifierAdapter {\n    const config = slackWebhookConfigSchema.parse(opts.config);\n    return createSlackAdapter({ config, webhookUrl: opts.secret, logger: opts.logger });\n  },\n};\n\ninterface SlackAdapterOptions {\n  config: ChatToggles;\n  webhookUrl?: string;\n  logger?: Logger;\n}\n\n/** Describe the Slack provider (name, version, config schema). */\nexport function getMetadata(): NotifierProvider[\"metadata\"] {\n  return {\n    name: \"Slack\",\n    version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n    description: \"Chat messages via Slack incoming webhooks\",\n    kind: \"slack-webhook\",\n    category: \"notifier\",\n    logo: \"slack\",\n    schema: slackWebhookConfigSchema,\n  };\n}\n\nfunction createSlackAdapter(options: SlackAdapterOptions): NotifierAdapter {\n  const logger = options.logger?.child({ component: \"notify-chat-slack\" });\n  return {\n    metadata: getMetadata(),\n    async send(input): Promise<void> {\n      const url = requireWebhookUrl(options.webhookUrl);\n      const payload = {\n        text: input.formatted.subject,\n        username: options.config.username,\n        blocks: [\n          {\n            type: \"section\",\n            text: { type: \"mrkdwn\", text: input.formatted.markdown },\n          },\n        ],\n      };\n      logger?.debug({ channelId: input.channel.id }, \"posting slack message\");\n      await httpText(url, { method: \"POST\", json: payload, logger });\n      logger?.info({ channelId: input.channel.id }, \"slack message posted\");\n    },\n  };\n}\n\n/** Incoming-webhook URL arrives as the decrypted channel secret. */\nfunction requireWebhookUrl(secret: string | undefined): string {\n  if (!secret) {\n    throw new Error(\"Slack channel is missing its webhook URL secret\");\n  }\n  return secret;\n}\n"],"mappings":";;;;;;;AAUA,MAAa,2BAA2B;;AAGxC,MAAa,uBAAyC;CACpD,UAAU,YAAY;CACtB,OAAO,MAA8E;EAEnF,OAAO,mBAAmB;GAAE,QADb,yBAAyB,MAAM,KAAK,MAClB;GAAG,YAAY,KAAK;GAAQ,QAAQ,KAAK;EAAO,CAAC;CACpF;AACF;;AASA,SAAgB,cAA4C;CAC1D,OAAO;EACL,MAAM;EACN,SAAU,WAAuD,mBAAmB;EACpF,aAAa;EACb,MAAM;EACN,UAAU;EACV,MAAM;EACN,QAAQ;CACV;AACF;AAEA,SAAS,mBAAmB,SAA+C;CACzE,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,oBAAoB,CAAC;CACvE,OAAO;EACL,UAAU,YAAY;EACtB,MAAM,KAAK,OAAsB;GAC/B,MAAM,MAAM,kBAAkB,QAAQ,UAAU;GAChD,MAAM,UAAU;IACd,MAAM,MAAM,UAAU;IACtB,UAAU,QAAQ,OAAO;IACzB,QAAQ,CACN;KACE,MAAM;KACN,MAAM;MAAE,MAAM;MAAU,MAAM,MAAM,UAAU;KAAS;IACzD,CACF;GACF;GACA,QAAQ,MAAM,EAAE,WAAW,MAAM,QAAQ,GAAG,GAAG,uBAAuB;GACtE,MAAM,SAAS,KAAK;IAAE,QAAQ;IAAQ,MAAM;IAAS;GAAO,CAAC;GAC7D,QAAQ,KAAK,EAAE,WAAW,MAAM,QAAQ,GAAG,GAAG,sBAAsB;EACtE;CACF;AACF;;AAGA,SAAS,kBAAkB,QAAoC;CAC7D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,iDAAiD;CAEnE,OAAO;AACT"}

package/dist/teams.d.mts

@@ -0,0 +1,24 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { ChatToggles } from "./types.mjs";
+import { NotifierProvider } from "@storyshelf/core/adapter/notifier";
+//#region src/teams.d.ts
+/** Validation schema for the Teams workflow-webhook config. */
+declare const teamsWorkflowConfigSchema: import("zod").ZodObject<{
+  style: import("zod").ZodOptional<import("zod").ZodEnum<{
+    compact: "compact";
+    verbose: "verbose";
+  }>>;
+  subjectPrefix: import("zod").ZodOptional<import("zod").ZodString>;
+  includeAuthor: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  includeMessage: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  includeCounts: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  username: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+/** Teams workflow-webhook chat provider (Adaptive Card message). */
+declare const teamsWorkflowNotifier: NotifierProvider;
+/** Describe the Teams provider (name, version, config schema). */
+declare function getMetadata(): NotifierProvider["metadata"];
+//#endregion
+export { type ChatToggles, getMetadata, teamsWorkflowConfigSchema, teamsWorkflowNotifier };
+//# sourceMappingURL=teams.d.mts.map

package/dist/teams.mjs

@@ -0,0 +1,75 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { chatTogglesSchema } from "./types.mjs";
+import { httpText } from "@storyshelf/core/utils";
+//#region src/teams.ts
+/** Validation schema for the Teams workflow-webhook config. */
+const teamsWorkflowConfigSchema = chatTogglesSchema;
+/** Teams workflow-webhook chat provider (Adaptive Card message). */
+const teamsWorkflowNotifier = {
+	metadata: getMetadata(),
+	create(opts) {
+		return createTeamsAdapter({
+			config: teamsWorkflowConfigSchema.parse(opts.config),
+			webhookUrl: opts.secret,
+			logger: opts.logger
+		});
+	}
+};
+/** Describe the Teams provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "Microsoft Teams",
+		version: globalThis.__PKG_VERSION__ ?? "0.0.0",
+		description: "Chat messages via Teams workflow webhooks",
+		kind: "teams-workflow",
+		category: "notifier",
+		logo: "teams",
+		schema: teamsWorkflowConfigSchema
+	};
+}
+function createTeamsAdapter(options) {
+	const logger = options.logger?.child({ component: "notify-chat-teams" });
+	return {
+		metadata: getMetadata(),
+		async send(input) {
+			const url = requireWebhookUrl(options.webhookUrl);
+			const payload = {
+				type: "message",
+				attachments: [{
+					contentType: "application/vnd.microsoft.card.adaptive",
+					content: {
+						type: "AdaptiveCard",
+						version: "1.4",
+						body: [{
+							type: "TextBlock",
+							text: input.formatted.subject,
+							weight: "Bolder"
+						}, {
+							type: "TextBlock",
+							text: input.formatted.text,
+							wrap: true
+						}]
+					}
+				}]
+			};
+			logger?.debug({ channelId: input.channel.id }, "posting teams message");
+			await httpText(url, {
+				method: "POST",
+				json: payload,
+				logger
+			});
+			logger?.info({ channelId: input.channel.id }, "teams message posted");
+		}
+	};
+}
+/** Workflow URL arrives as the decrypted channel secret. */
+function requireWebhookUrl(secret) {
+	if (!secret) throw new Error("Teams channel is missing its workflow URL secret");
+	return secret;
+}
+//#endregion
+export { getMetadata, teamsWorkflowConfigSchema, teamsWorkflowNotifier };
+
+//# sourceMappingURL=teams.mjs.map

package/dist/teams.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.mjs","names":[],"sources":["../src/teams.ts"],"sourcesContent":["import type { NotifierAdapter, NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { httpText } from \"@storyshelf/core/utils\";\nimport { chatTogglesSchema, type ChatToggles } from \"./types.ts\";\n\nexport type { ChatToggles };\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Validation schema for the Teams workflow-webhook config. */\nexport const teamsWorkflowConfigSchema = chatTogglesSchema;\n\n/** Teams workflow-webhook chat provider (Adaptive Card message). */\nexport const teamsWorkflowNotifier: NotifierProvider = {\n  metadata: getMetadata(),\n  create(opts: { config: unknown; secret?: string; logger?: Logger }): NotifierAdapter {\n    const config = teamsWorkflowConfigSchema.parse(opts.config);\n    return createTeamsAdapter({ config, webhookUrl: opts.secret, logger: opts.logger });\n  },\n};\n\ninterface TeamsAdapterOptions {\n  config: ChatToggles;\n  webhookUrl?: string;\n  logger?: Logger;\n}\n\n/** Describe the Teams provider (name, version, config schema). */\nexport function getMetadata(): NotifierProvider[\"metadata\"] {\n  return {\n    name: \"Microsoft Teams\",\n    version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n    description: \"Chat messages via Teams workflow webhooks\",\n    kind: \"teams-workflow\",\n    category: \"notifier\",\n    logo: \"teams\",\n    schema: teamsWorkflowConfigSchema,\n  };\n}\n\nfunction createTeamsAdapter(options: TeamsAdapterOptions): NotifierAdapter {\n  const logger = options.logger?.child({ component: \"notify-chat-teams\" });\n  return {\n    metadata: getMetadata(),\n    async send(input): Promise<void> {\n      const url = requireWebhookUrl(options.webhookUrl);\n      const payload = {\n        type: \"message\",\n        attachments: [\n          {\n            contentType: \"application/vnd.microsoft.card.adaptive\",\n            content: {\n              type: \"AdaptiveCard\",\n              version: \"1.4\",\n              body: [\n                { type: \"TextBlock\", text: input.formatted.subject, weight: \"Bolder\" },\n                { type: \"TextBlock\", text: input.formatted.text, wrap: true },\n              ],\n            },\n          },\n        ],\n      };\n      logger?.debug({ channelId: input.channel.id }, \"posting teams message\");\n      await httpText(url, { method: \"POST\", json: payload, logger });\n      logger?.info({ channelId: input.channel.id }, \"teams message posted\");\n    },\n  };\n}\n\n/** Workflow URL arrives as the decrypted channel secret. */\nfunction requireWebhookUrl(secret: string | undefined): string {\n  if (!secret) {\n    throw new Error(\"Teams channel is missing its workflow URL secret\");\n  }\n  return secret;\n}\n"],"mappings":";;;;;;;AAUA,MAAa,4BAA4B;;AAGzC,MAAa,wBAA0C;CACrD,UAAU,YAAY;CACtB,OAAO,MAA8E;EAEnF,OAAO,mBAAmB;GAAE,QADb,0BAA0B,MAAM,KAAK,MACnB;GAAG,YAAY,KAAK;GAAQ,QAAQ,KAAK;EAAO,CAAC;CACpF;AACF;;AASA,SAAgB,cAA4C;CAC1D,OAAO;EACL,MAAM;EACN,SAAU,WAAuD,mBAAmB;EACpF,aAAa;EACb,MAAM;EACN,UAAU;EACV,MAAM;EACN,QAAQ;CACV;AACF;AAEA,SAAS,mBAAmB,SAA+C;CACzE,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,oBAAoB,CAAC;CACvE,OAAO;EACL,UAAU,YAAY;EACtB,MAAM,KAAK,OAAsB;GAC/B,MAAM,MAAM,kBAAkB,QAAQ,UAAU;GAChD,MAAM,UAAU;IACd,MAAM;IACN,aAAa,CACX;KACE,aAAa;KACb,SAAS;MACP,MAAM;MACN,SAAS;MACT,MAAM,CACJ;OAAE,MAAM;OAAa,MAAM,MAAM,UAAU;OAAS,QAAQ;MAAS,GACrE;OAAE,MAAM;OAAa,MAAM,MAAM,UAAU;OAAM,MAAM;MAAK,CAC9D;KACF;IACF,CACF;GACF;GACA,QAAQ,MAAM,EAAE,WAAW,MAAM,QAAQ,GAAG,GAAG,uBAAuB;GACtE,MAAM,SAAS,KAAK;IAAE,QAAQ;IAAQ,MAAM;IAAS;GAAO,CAAC;GAC7D,QAAQ,KAAK,EAAE,WAAW,MAAM,QAAQ,GAAG,GAAG,sBAAsB;EACtE;CACF;AACF;;AAGA,SAAS,kBAAkB,QAAoC;CAC7D,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,kDAAkD;CAEpE,OAAO;AACT"}

package/dist/types.d.mts

@@ -0,0 +1,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { z } from "zod";
+//#region src/types.d.ts
+/** Display toggles shared by chat providers (Brand + toggles v1). */
+declare const chatTogglesSchema: z.ZodObject<{
+  style: z.ZodOptional<z.ZodEnum<{
+    compact: "compact";
+    verbose: "verbose";
+  }>>;
+  subjectPrefix: z.ZodOptional<z.ZodString>;
+  includeAuthor: z.ZodOptional<z.ZodBoolean>;
+  includeMessage: z.ZodOptional<z.ZodBoolean>;
+  includeCounts: z.ZodOptional<z.ZodBoolean>;
+  username: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Display toggles shared by chat providers. */
+type ChatToggles = z.infer<typeof chatTogglesSchema>;
+//#endregion
+export { ChatToggles, chatTogglesSchema };
+//# sourceMappingURL=types.d.mts.map

package/dist/types.mjs

@@ -0,0 +1,18 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { z } from "zod";
+//#region src/types.ts
+/** Display toggles shared by chat providers (Brand + toggles v1). */
+const chatTogglesSchema = z.object({
+	style: z.enum(["compact", "verbose"]).optional(),
+	subjectPrefix: z.string().min(1).optional(),
+	includeAuthor: z.boolean().optional(),
+	includeMessage: z.boolean().optional(),
+	includeCounts: z.boolean().optional(),
+	username: z.string().min(1).optional()
+});
+//#endregion
+export { chatTogglesSchema };
+
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Display toggles shared by chat providers (Brand + toggles v1). */\nexport const chatTogglesSchema = z.object({\n  style: z.enum([\"compact\", \"verbose\"]).optional(),\n  subjectPrefix: z.string().min(1).optional(),\n  includeAuthor: z.boolean().optional(),\n  includeMessage: z.boolean().optional(),\n  includeCounts: z.boolean().optional(),\n  username: z.string().min(1).optional(),\n});\n\n/** Display toggles shared by chat providers. */\nexport type ChatToggles = z.infer<typeof chatTogglesSchema>;\n"],"mappings":";;;;;;AAGA,MAAa,oBAAoB,EAAE,OAAO;CACxC,OAAO,EAAE,KAAK,CAAC,WAAW,SAAS,CAAC,CAAC,CAAC,SAAS;CAC/C,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CAC1C,eAAe,EAAE,QAAQ,CAAC,CAAC,SAAS;CACpC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,SAAS;CACrC,eAAe,EAAE,QAAQ,CAAC,CAAC,SAAS;CACpC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@storyshelf/notify-chat",
+  "version": "0.5.3",
+  "description": "Chat notification providers for StoryShelf (Slack and Teams incoming webhooks).",
+  "keywords": [
+    "notifications",
+    "self-hosted",
+    "slack",
+    "storybook",
+    "teams"
+  ],
+  "homepage": "https://github.com/GuptaSiddhant/StoryShelf#readme",
+  "bugs": {
+    "url": "https://github.com/GuptaSiddhant/StoryShelf/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Siddhant Gupta",
+    "url": "https://guptasiddhant.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuptaSiddhant/StoryShelf.git",
+    "directory": "packages/notify-chat"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./log": {
+      "source": "./src/log.ts",
+      "default": "./dist/log.mjs"
+    },
+    "./slack": {
+      "source": "./src/slack.ts",
+      "default": "./dist/slack.mjs"
+    },
+    "./teams": {
+      "source": "./src/teams.ts",
+      "default": "./dist/teams.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.mjs",
+      "./log": "./dist/log.mjs",
+      "./slack": "./dist/slack.mjs",
+      "./teams": "./dist/teams.mjs",
+      "./package.json": "./package.json"
+    },
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown -w",
+    "fmt": "oxfmt ./src",
+    "lint": "oxlint --type-aware --type-check ./src",
+    "test": "vitest run",
+    "prepublishOnly": "nub run build"
+  },
+  "dependencies": {
+    "@storyshelf/core": "0.5.3",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@vitest/coverage-v8": "^4.0.0",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "jsr": {
+    "runtimeCompat": {
+      "node": true,
+      "deno": true,
+      "browser": false,
+      "workerd": true,
+      "bun": true
+    }
+  }
+}