devcodes-webhook 1.0.0

package/README.md

@@ -0,0 +1,239 @@
+# devcodes-webhook
+
+Send Discord and Slack webhooks with a clean, typed API — no boilerplate, built-in retries, full TypeScript support.
+
+Built on top of [devcodes-http-tool](https://www.npmjs.com/package/devcodes-http-tool).
+
+## Install
+
+```bash
+npm install devcodes-webhook
+```
+
+## Quick Start
+
+```js
+const { sendWebhook } = require('devcodes-webhook');
+
+await sendWebhook('https://discord.com/api/webhooks/...', {
+  content: 'Hello from devcodes-webhook!'
+});
+```
+
+---
+
+## Discord
+
+### Basic message
+
+```js
+const { DiscordWebhook } = require('devcodes-webhook');
+
+const hook = new DiscordWebhook('https://discord.com/api/webhooks/ID/TOKEN');
+
+await hook.sendText('Server is back online ✅');
+```
+
+### Send an embed
+
+```js
+await hook.sendEmbed({
+  title: '🚀 Deployment Complete',
+  description: 'Version **1.4.2** is now live.',
+  color: 0x57F287, // green
+  timestamp: new Date().toISOString(),
+  footer: { text: 'Dev Codes CI' },
+});
+```
+
+### Send multiple embeds
+
+```js
+await hook.sendEmbeds([
+  { title: 'Service A', description: '✅ Healthy', color: 0x57F287 },
+  { title: 'Service B', description: '⚠️ Degraded', color: 0xFEE75C },
+  { title: 'Service C', description: '❌ Down',    color: 0xED4245 },
+]);
+```
+
+### Override webhook name & avatar
+
+```js
+await hook.send({
+  content: 'Ping!',
+  username: 'Alert Bot',
+  avatar_url: 'https://example.com/avatar.png',
+});
+```
+
+### Full embed example
+
+```js
+await hook.sendEmbed({
+  author: {
+    name: 'azaresw',
+    url: 'https://github.com/azaresw',
+    icon_url: 'https://github.com/azaresw.png',
+  },
+  title: 'New Pull Request',
+  url: 'https://github.com/azaresw/repo/pull/42',
+  description: 'Fix memory leak in cache layer',
+  color: 0x5865F2,
+  fields: [
+    { name: 'Branch',   value: '`fix/cache-leak`', inline: true },
+    { name: 'Status',   value: 'Open',             inline: true },
+    { name: 'Changed',  value: '3 files',          inline: true },
+  ],
+  thumbnail: { url: 'https://github.com/azaresw.png' },
+  footer:    { text: 'GitHub • devcodes-webhook' },
+  timestamp: new Date().toISOString(),
+});
+```
+
+---
+
+## Slack
+
+### Plain text
+
+```js
+const { SlackWebhook } = require('devcodes-webhook');
+
+const hook = new SlackWebhook('https://hooks.slack.com/services/...');
+
+await hook.sendText('Deployment finished successfully!');
+```
+
+### Block Kit
+
+```js
+await hook.sendBlocks([
+  {
+    type: 'header',
+    text: { type: 'plain_text', text: '🚨 Alert' },
+  },
+  {
+    type: 'section',
+    text: { type: 'mrkdwn', text: '*Service:* API Gateway\n*Status:* Down' },
+  },
+]);
+```
+
+### Send to a specific channel
+
+```js
+await hook.send({
+  text: 'Hello #dev!',
+  channel: '#dev',
+  icon_emoji: ':rocket:',
+});
+```
+
+---
+
+## Generic `sendWebhook`
+
+Works with any service that accepts a JSON webhook body.
+
+```js
+const { sendWebhook } = require('devcodes-webhook');
+
+await sendWebhook('https://your-endpoint.com/hook', {
+  event: 'user.signup',
+  userId: '123',
+});
+```
+
+---
+
+## TypeScript
+
+Full type support out of the box.
+
+```ts
+import { DiscordWebhook, DiscordEmbed, WebhookConfig } from 'devcodes-webhook';
+
+const config: WebhookConfig = { timeout: 5000, retries: 3 };
+const hook = new DiscordWebhook('https://discord.com/api/webhooks/...', config);
+
+const embed: DiscordEmbed = {
+  title: 'Alert',
+  description: 'Something happened.',
+  color: 0xED4245,
+};
+
+await hook.sendEmbed(embed);
+```
+
+---
+
+## API Reference
+
+### `new DiscordWebhook(url, config?)`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `send` | `(payload: DiscordWebhookPayload) => Promise<WebhookResponse>` | Send a raw payload |
+| `sendText` | `(content: string, extras?) => Promise<WebhookResponse>` | Send a plain text message |
+| `sendEmbed` | `(embed: DiscordEmbed, extras?) => Promise<WebhookResponse>` | Send a single embed |
+| `sendEmbeds` | `(embeds: DiscordEmbed[], extras?) => Promise<WebhookResponse>` | Send up to 10 embeds |
+
+### `new SlackWebhook(url, config?)`
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `send` | `(payload: SlackWebhookPayload) => Promise<WebhookResponse>` | Send a raw payload |
+| `sendText` | `(text: string, extras?) => Promise<WebhookResponse>` | Send a plain text message |
+| `sendBlocks` | `(blocks: unknown[], extras?) => Promise<WebhookResponse>` | Send Block Kit blocks |
+
+### `sendWebhook(url, payload, config?)`
+
+Generic function that POSTs any JSON payload to a URL.
+
+### `WebhookConfig`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `timeout` | `number` | `10000` | Request timeout in ms |
+| `retries` | `number` | `2` | Retry attempts on failure |
+| `retryDelay` | `number` | `500` | Delay between retries in ms |
+
+### `WebhookResponse`
+
+```ts
+interface WebhookResponse {
+  ok: boolean;     // true if status 2xx
+  status: number;  // HTTP status code
+}
+```
+
+---
+
+## Discord bot integration example
+
+```js
+const { DiscordWebhook } = require('devcodes-webhook');
+
+const logs = new DiscordWebhook(process.env.LOG_WEBHOOK_URL);
+
+client.on('guildMemberAdd', async (member) => {
+  await logs.sendEmbed({
+    title: '👋 New Member',
+    description: `${member.user.tag} joined **${member.guild.name}**`,
+    color: 0x57F287,
+    thumbnail: { url: member.user.displayAvatarURL() },
+    timestamp: new Date().toISOString(),
+    footer: { text: `Members: ${member.guild.memberCount}` },
+  });
+});
+```
+
+---
+
+## License
+
+MIT © [azaresw](https://github.com/azaresw)
+
+## Support
+
+Join our Discord for help and updates: [discord.gg/ESh2Dp2xX9](https://discord.gg/ESh2Dp2xX9)

package/dist/discord.d.ts

@@ -0,0 +1,19 @@
+import type { DiscordWebhookPayload, DiscordEmbed, WebhookConfig, WebhookResponse } from './types';
+export declare class DiscordWebhook {
+    private readonly url;
+    private readonly http;
+    /**
+     * @param url  Your Discord webhook URL
+     * @param config  Optional timeout/retry settings
+     */
+    constructor(url: string, config?: WebhookConfig);
+    /** Send a raw Discord webhook payload */
+    send(payload: DiscordWebhookPayload): Promise<WebhookResponse>;
+    /** Send a single embed, with optional extras (content, username, …) */
+    sendEmbed(embed: DiscordEmbed, extras?: Omit<DiscordWebhookPayload, 'embeds'>): Promise<WebhookResponse>;
+    /** Send multiple embeds at once (max 10 per Discord limits) */
+    sendEmbeds(embeds: DiscordEmbed[], extras?: Omit<DiscordWebhookPayload, 'embeds'>): Promise<WebhookResponse>;
+    /** Send a plain text message */
+    sendText(content: string, extras?: Omit<DiscordWebhookPayload, 'content'>): Promise<WebhookResponse>;
+}
+//# sourceMappingURL=discord.d.ts.map

package/dist/discord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../src/discord.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAEjD;;;OAGG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB;IASnD,yCAAyC;IACnC,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAKpE,uEAAuE;IACjE,SAAS,CACb,KAAK,EAAE,YAAY,EACnB,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,GAC7C,OAAO,CAAC,eAAe,CAAC;IAI3B,+DAA+D;IACzD,UAAU,CACd,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,GAC7C,OAAO,CAAC,eAAe,CAAC;IAI3B,gCAAgC;IAC1B,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,GAC9C,OAAO,CAAC,eAAe,CAAC;CAG5B"}

package/dist/discord.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscordWebhook = void 0;
+const devcodes_http_tool_1 = require("devcodes-http-tool");
+class DiscordWebhook {
+    /**
+     * @param url  Your Discord webhook URL
+     * @param config  Optional timeout/retry settings
+     */
+    constructor(url, config = {}) {
+        this.url = url;
+        this.http = (0, devcodes_http_tool_1.create)({
+            timeout: config.timeout ?? 10000,
+            retries: config.retries ?? 2,
+            retryDelay: config.retryDelay ?? 500,
+        });
+    }
+    /** Send a raw Discord webhook payload */
+    async send(payload) {
+        const res = await this.http.post(this.url, payload);
+        return { ok: res.status >= 200 && res.status < 300, status: res.status };
+    }
+    /** Send a single embed, with optional extras (content, username, …) */
+    async sendEmbed(embed, extras) {
+        return this.send({ ...extras, embeds: [embed] });
+    }
+    /** Send multiple embeds at once (max 10 per Discord limits) */
+    async sendEmbeds(embeds, extras) {
+        return this.send({ ...extras, embeds });
+    }
+    /** Send a plain text message */
+    async sendText(content, extras) {
+        return this.send({ ...extras, content });
+    }
+}
+exports.DiscordWebhook = DiscordWebhook;
+//# sourceMappingURL=discord.js.map

package/dist/discord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.js","sourceRoot":"","sources":["../src/discord.ts"],"names":[],"mappings":";;;AAAA,2DAA4C;AAQ5C,MAAa,cAAc;IAIzB;;;OAGG;IACH,YAAY,GAAW,EAAE,SAAwB,EAAE;QACjD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAA,2BAAM,EAAC;YACjB,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,KAAM;YACvC,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,CAAC;YAClC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;SACrC,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI,CAAC,OAA8B;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3E,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,SAAS,CACb,KAAmB,EACnB,MAA8C;QAE9C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,UAAU,CACd,MAAsB,EACtB,MAA8C;QAE9C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,MAA+C;QAE/C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AA9CD,wCA8CC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { DiscordWebhook } from './discord';
+export { SlackWebhook } from './slack';
+export { sendWebhook } from './utils';
+export type { WebhookConfig, WebhookResponse, DiscordWebhookPayload, DiscordEmbed, DiscordEmbedFooter, DiscordEmbedImage, DiscordEmbedThumbnail, DiscordEmbedAuthor, DiscordEmbedField, DiscordAllowedMentions, SlackWebhookPayload, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAQ,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAS,SAAS,CAAC;AAEzC,YAAY,EACV,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendWebhook = exports.SlackWebhook = exports.DiscordWebhook = void 0;
+var discord_1 = require("./discord");
+Object.defineProperty(exports, "DiscordWebhook", { enumerable: true, get: function () { return discord_1.DiscordWebhook; } });
+var slack_1 = require("./slack");
+Object.defineProperty(exports, "SlackWebhook", { enumerable: true, get: function () { return slack_1.SlackWebhook; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "sendWebhook", { enumerable: true, get: function () { return utils_1.sendWebhook; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AACvB,iCAAyC;AAAhC,qGAAA,YAAY,OAAA;AACrB,iCAAyC;AAAhC,oGAAA,WAAW,OAAA"}

package/dist/slack.d.ts

@@ -0,0 +1,17 @@
+import type { SlackWebhookPayload, WebhookConfig, WebhookResponse } from './types';
+export declare class SlackWebhook {
+    private readonly url;
+    private readonly http;
+    /**
+     * @param url  Your Slack incoming webhook URL
+     * @param config  Optional timeout/retry settings
+     */
+    constructor(url: string, config?: WebhookConfig);
+    /** Send a raw Slack webhook payload */
+    send(payload: SlackWebhookPayload): Promise<WebhookResponse>;
+    /** Send a plain text message */
+    sendText(text: string, extras?: Omit<SlackWebhookPayload, 'text'>): Promise<WebhookResponse>;
+    /** Send a Block Kit payload */
+    sendBlocks(blocks: unknown[], extras?: Omit<SlackWebhookPayload, 'blocks'>): Promise<WebhookResponse>;
+}
+//# sourceMappingURL=slack.d.ts.map

package/dist/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../src/slack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEnF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAEjD;;;OAGG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB;IASnD,uCAAuC;IACjC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAKlE,gCAAgC;IAC1B,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GACzC,OAAO,CAAC,eAAe,CAAC;IAI3B,+BAA+B;IACzB,UAAU,CACd,MAAM,EAAE,OAAO,EAAE,EACjB,MAAM,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAC3C,OAAO,CAAC,eAAe,CAAC;CAG5B"}

package/dist/slack.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlackWebhook = void 0;
+const devcodes_http_tool_1 = require("devcodes-http-tool");
+class SlackWebhook {
+    /**
+     * @param url  Your Slack incoming webhook URL
+     * @param config  Optional timeout/retry settings
+     */
+    constructor(url, config = {}) {
+        this.url = url;
+        this.http = (0, devcodes_http_tool_1.create)({
+            timeout: config.timeout ?? 10000,
+            retries: config.retries ?? 2,
+            retryDelay: config.retryDelay ?? 500,
+        });
+    }
+    /** Send a raw Slack webhook payload */
+    async send(payload) {
+        const res = await this.http.post(this.url, payload);
+        return { ok: res.status >= 200 && res.status < 300, status: res.status };
+    }
+    /** Send a plain text message */
+    async sendText(text, extras) {
+        return this.send({ ...extras, text });
+    }
+    /** Send a Block Kit payload */
+    async sendBlocks(blocks, extras) {
+        return this.send({ ...extras, blocks });
+    }
+}
+exports.SlackWebhook = SlackWebhook;
+//# sourceMappingURL=slack.js.map

package/dist/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../src/slack.ts"],"names":[],"mappings":";;;AAAA,2DAA4C;AAG5C,MAAa,YAAY;IAIvB;;;OAGG;IACH,YAAY,GAAW,EAAE,SAAwB,EAAE;QACjD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAA,2BAAM,EAAC;YACjB,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,KAAM;YACvC,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,CAAC;YAClC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;SACrC,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,IAAI,CAAC,OAA4B;QACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3E,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,MAA0C;QAE1C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,UAAU,CACd,MAAiB,EACjB,MAA4C;QAE5C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAtCD,oCAsCC"}

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+export interface WebhookConfig {
+    /** Request timeout in ms. Default: 10000 */
+    timeout?: number;
+    /** Number of retries on failure. Default: 2 */
+    retries?: number;
+    /** Delay between retries in ms. Default: 500 */
+    retryDelay?: number;
+}
+export interface WebhookResponse {
+    /** Whether the request was successful (2xx) */
+    ok: boolean;
+    /** HTTP status code */
+    status: number;
+}
+export interface DiscordEmbedFooter {
+    text: string;
+    icon_url?: string;
+}
+export interface DiscordEmbedImage {
+    url: string;
+}
+export interface DiscordEmbedThumbnail {
+    url: string;
+}
+export interface DiscordEmbedAuthor {
+    name: string;
+    url?: string;
+    icon_url?: string;
+}
+export interface DiscordEmbedField {
+    name: string;
+    value: string;
+    inline?: boolean;
+}
+export interface DiscordEmbed {
+    title?: string;
+    description?: string;
+    url?: string;
+    /** ISO8601 timestamp */
+    timestamp?: string;
+    /** Decimal colour value */
+    color?: number;
+    footer?: DiscordEmbedFooter;
+    image?: DiscordEmbedImage;
+    thumbnail?: DiscordEmbedThumbnail;
+    author?: DiscordEmbedAuthor;
+    fields?: DiscordEmbedField[];
+}
+export interface DiscordAllowedMentions {
+    parse?: ('roles' | 'users' | 'everyone')[];
+    roles?: string[];
+    users?: string[];
+    replied_user?: boolean;
+}
+export interface DiscordWebhookPayload {
+    content?: string;
+    username?: string;
+    avatar_url?: string;
+    tts?: boolean;
+    embeds?: DiscordEmbed[];
+    allowed_mentions?: DiscordAllowedMentions;
+    /** Thread name to create (forum channels) */
+    thread_name?: string;
+    /** Message flags */
+    flags?: number;
+}
+export interface SlackWebhookPayload {
+    text?: string;
+    username?: string;
+    icon_emoji?: string;
+    icon_url?: string;
+    /** Override the default channel */
+    channel?: string;
+    /** Block Kit blocks */
+    blocks?: unknown[];
+    /** Legacy attachments */
+    attachments?: unknown[];
+    mrkdwn?: boolean;
+    unfurl_links?: boolean;
+    unfurl_media?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,EAAE,EAAE,OAAO,CAAC;IACZ,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,CAAC,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Shared ───────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,iFAAiF"}

package/dist/utils.d.ts

@@ -0,0 +1,10 @@
+import type { WebhookConfig, WebhookResponse } from './types';
+/**
+ * Send any JSON payload to any webhook URL (Discord, Slack, or custom).
+ *
+ * @param url     Webhook URL
+ * @param payload Any JSON-serialisable object
+ * @param config  Optional timeout/retry settings
+ */
+export declare function sendWebhook(url: string, payload: unknown, config?: WebhookConfig): Promise<WebhookResponse>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

package/dist/utils.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendWebhook = sendWebhook;
+const devcodes_http_tool_1 = require("devcodes-http-tool");
+/**
+ * Send any JSON payload to any webhook URL (Discord, Slack, or custom).
+ *
+ * @param url     Webhook URL
+ * @param payload Any JSON-serialisable object
+ * @param config  Optional timeout/retry settings
+ */
+async function sendWebhook(url, payload, config = {}) {
+    const http = (0, devcodes_http_tool_1.create)({
+        timeout: config.timeout ?? 10000,
+        retries: config.retries ?? 2,
+        retryDelay: config.retryDelay ?? 500,
+    });
+    const res = await http.post(url, payload);
+    return { ok: res.status >= 200 && res.status < 300, status: res.status };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAUA,kCAYC;AAtBD,2DAA4C;AAG5C;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,OAAgB,EAChB,SAAwB,EAAE;IAE1B,MAAM,IAAI,GAAG,IAAA,2BAAM,EAAC;QAClB,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,KAAM;QACvC,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;KACrC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;AAC3E,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "devcodes-webhook",
+  "version": "1.0.0",
+  "description": "Send Discord and Slack webhooks with a simple, typed API. Built on devcodes-http-tool.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "keywords": [
+    "webhook",
+    "discord",
+    "slack",
+    "discord-webhook",
+    "slack-webhook",
+    "embed",
+    "notification",
+    "devcodes",
+    "typescript"
+  ],
+  "author": "Dev Codes",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/azaresw/devcodes-webhook.git"
+  },
+  "dependencies": {
+    "devcodes-http-tool": "^1.0.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  }
+}