@teever/ez-hook 0.3.5

package/dist/classes/Errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Base error class for ez-hook library
+ */
+export declare class EzHookError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when webhook validation fails
+ * @example
+ * ```typescript
+ * try {
+ *   webhook.setContent('a'.repeat(2001)); // Too long
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.log(`Validation failed for field: ${error.field}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class ValidationError extends EzHookError {
+    readonly field?: string | undefined;
+    readonly maxLength?: number | undefined;
+    readonly actualLength?: number | undefined;
+    constructor(message: string, field?: string | undefined, maxLength?: number | undefined, actualLength?: number | undefined);
+}
+/**
+ * Error thrown when webhook HTTP request fails
+ * @example
+ * ```typescript
+ * try {
+ *   await webhook.send();
+ * } catch (error) {
+ *   if (error instanceof WebhookError) {
+ *     console.log(`Request failed with status: ${error.statusCode}`);
+ *     if (error.retryAfter) {
+ *       console.log(`Retry after: ${error.retryAfter}ms`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class WebhookError extends EzHookError {
+    readonly statusCode?: number | undefined;
+    readonly retryAfter?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, retryAfter?: number | undefined);
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+export declare class RateLimitError extends WebhookError {
+    constructor(retryAfter?: number);
+}
+/**
+ * Error thrown when webhook URL is invalid or unreachable
+ */
+export declare class WebhookNotFoundError extends WebhookError {
+    constructor();
+}
+//# sourceMappingURL=Errors.d.ts.map

package/dist/classes/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/classes/Errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,WAAW;aAG9B,KAAK,CAAC,EAAE,MAAM;aACd,SAAS,CAAC,EAAE,MAAM;aAClB,YAAY,CAAC,EAAE,MAAM;gBAHrC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,YAAY,CAAC,EAAE,MAAM,YAAA;CAItC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAa,SAAQ,WAAW;aAG3B,UAAU,CAAC,EAAE,MAAM;aACnB,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,UAAU,CAAC,EAAE,MAAM,YAAA;CAIpC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBACnC,UAAU,CAAC,EAAE,MAAM;CAG/B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;;CAIrD"}

package/dist/classes/Errors.js

@@ -0,0 +1,75 @@
+/**
+ * Base error class for ez-hook library
+ */
+export class EzHookError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+/**
+ * Error thrown when webhook validation fails
+ * @example
+ * ```typescript
+ * try {
+ *   webhook.setContent('a'.repeat(2001)); // Too long
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.log(`Validation failed for field: ${error.field}`);
+ *   }
+ * }
+ * ```
+ */
+export class ValidationError extends EzHookError {
+    field;
+    maxLength;
+    actualLength;
+    constructor(message, field, maxLength, actualLength) {
+        super(message);
+        this.field = field;
+        this.maxLength = maxLength;
+        this.actualLength = actualLength;
+    }
+}
+/**
+ * Error thrown when webhook HTTP request fails
+ * @example
+ * ```typescript
+ * try {
+ *   await webhook.send();
+ * } catch (error) {
+ *   if (error instanceof WebhookError) {
+ *     console.log(`Request failed with status: ${error.statusCode}`);
+ *     if (error.retryAfter) {
+ *       console.log(`Retry after: ${error.retryAfter}ms`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class WebhookError extends EzHookError {
+    statusCode;
+    retryAfter;
+    constructor(message, statusCode, retryAfter) {
+        super(message);
+        this.statusCode = statusCode;
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+export class RateLimitError extends WebhookError {
+    constructor(retryAfter) {
+        super('Rate limit exceeded', 429, retryAfter);
+    }
+}
+/**
+ * Error thrown when webhook URL is invalid or unreachable
+ */
+export class WebhookNotFoundError extends WebhookError {
+    constructor() {
+        super('Webhook not found or invalid URL', 404);
+    }
+}
+//# sourceMappingURL=Errors.js.map

package/dist/classes/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../src/classes/Errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACrC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAClC,CAAC;CACD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAG9B;IACA;IACA;IAJjB,YACC,OAAe,EACC,KAAc,EACd,SAAkB,EAClB,YAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAA;QAJE,UAAK,GAAL,KAAK,CAAS;QACd,cAAS,GAAT,SAAS,CAAS;QAClB,iBAAY,GAAZ,YAAY,CAAS;IAGtC,CAAC;CACD;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAG3B;IACA;IAHjB,YACC,OAAe,EACC,UAAmB,EACnB,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,eAAU,GAAV,UAAU,CAAS;QACnB,eAAU,GAAV,UAAU,CAAS;IAGpC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC/C,YAAY,UAAmB;QAC9B,KAAK,CAAC,qBAAqB,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IAC9C,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACrD;QACC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAA;IAC/C,CAAC;CACD"}

package/dist/classes/RequestClient.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Delays the execution of the code for a specified number of seconds.
+ * @param second - The number of seconds to delay.
+ * @returns A Promise that resolves after the specified number of seconds.
+ */
+export declare function delay(second: number): Promise<void>;
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+}
+export interface RequestResult {
+    ok: boolean;
+    status: number;
+    retryAfter?: number;
+    bodyText?: string;
+    error?: string;
+}
+/**
+ * Class for handling HTTP requests with customizable headers, body, and parameters.
+ *
+ * @class
+ * @internal
+ * @category Internal
+ */
+export declare class RequestClient {
+    private static DEFAULT_RETRY_CONFIG;
+    webhookUrl: string;
+    private retryCount;
+    retryConfig: RetryConfig;
+    constructor(webhookUrl: string, retryConfig?: Partial<RetryConfig>);
+    private calculateBackoff;
+    private shouldRetry;
+    send(method: 'GET' | 'POST' | 'PATCH', data: unknown, init?: Pick<RequestInit, 'signal' | 'headers'> & {
+        timeoutMs?: number;
+    }): Promise<RequestResult>;
+}
+//# sourceMappingURL=RequestClient.d.ts.map

package/dist/classes/RequestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestClient.d.ts","sourceRoot":"","sources":["../../src/classes/RequestClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInD;AAED,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CAChB;AACD,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAIlC;IAEM,UAAU,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,UAAU,CAAI;IACf,WAAW,EAAE,WAAW,CAAA;gBAEnB,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAKlE,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,WAAW;IAQN,IAAI,CAChB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,EAChC,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,aAAa,CAAC;CAmFzB"}

package/dist/classes/RequestClient.js

@@ -0,0 +1,117 @@
+/**
+ * Delays the execution of the code for a specified number of seconds.
+ * @param second - The number of seconds to delay.
+ * @returns A Promise that resolves after the specified number of seconds.
+ */
+export function delay(second) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, second * 1000);
+    });
+}
+/**
+ * Class for handling HTTP requests with customizable headers, body, and parameters.
+ *
+ * @class
+ * @internal
+ * @category Internal
+ */
+export class RequestClient {
+    static DEFAULT_RETRY_CONFIG = {
+        maxRetries: 3,
+        baseDelay: 1000, // 1 second
+        maxDelay: 60000 // 60 seconds
+    };
+    webhookUrl;
+    retryCount = 0;
+    retryConfig;
+    constructor(webhookUrl, retryConfig) {
+        this.webhookUrl = webhookUrl;
+        this.retryConfig = { ...RequestClient.DEFAULT_RETRY_CONFIG, ...retryConfig };
+    }
+    calculateBackoff() {
+        // Exponential backoff with jitter
+        const exponential = Math.min(this.retryConfig.maxDelay, this.retryConfig.baseDelay * 2 ** this.retryCount);
+        // Add random jitter +/- 20%
+        const jitter = exponential * 0.2 * (Math.random() - 0.5);
+        const withJitter = exponential + jitter;
+        return Math.max(0, withJitter);
+    }
+    shouldRetry(status) {
+        // Retry on rate limits and server errors
+        return (this.retryCount < this.retryConfig.maxRetries &&
+            (status === 429 || status === 0 || (status >= 500 && status < 600)));
+    }
+    async send(method, data, init) {
+        const { signal, headers = {}, timeoutMs } = init ?? {};
+        const controller = timeoutMs ? new AbortController() : undefined;
+        const timeout = timeoutMs
+            ? setTimeout(() => controller?.abort(), timeoutMs)
+            : undefined;
+        try {
+            const response = await fetch(this.webhookUrl, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers
+                },
+                body: method === 'GET' ? undefined : JSON.stringify(data),
+                signal: controller?.signal ?? signal
+            });
+            const text = await response.text();
+            const retryAfterHeader = response.headers.get('retry-after') ??
+                response.headers.get('x-ratelimit-reset-after') ??
+                undefined;
+            const retryAfterSeconds = retryAfterHeader
+                ? Number.parseFloat(retryAfterHeader)
+                : undefined;
+            const retryAfterMs = Number.isFinite(retryAfterSeconds) && retryAfterSeconds
+                ? retryAfterSeconds * 1000
+                : undefined;
+            if (response.ok) {
+                this.retryCount = 0;
+                return {
+                    ok: true,
+                    status: response.status,
+                    retryAfter: retryAfterMs,
+                    bodyText: text || undefined
+                };
+            }
+            if (this.shouldRetry(response.status)) {
+                this.retryCount++;
+                const delayMs = response.status === 429
+                    ? (retryAfterMs ?? this.calculateBackoff())
+                    : this.calculateBackoff();
+                await delay(delayMs / 1000);
+                return this.send(method, data, init);
+            }
+            const errorResult = {
+                ok: false,
+                status: response.status,
+                retryAfter: retryAfterMs,
+                bodyText: text || undefined,
+                error: text || response.statusText || `HTTP ${response.status}`
+            };
+            this.retryCount = 0;
+            return errorResult;
+        }
+        catch (_error) {
+            const message = _error instanceof Error ? _error.message : _error ? String(_error) : '';
+            if (this.shouldRetry(0)) {
+                this.retryCount++;
+                await delay(this.calculateBackoff() / 1000);
+                return this.send(method, data, init);
+            }
+            this.retryCount = 0;
+            return {
+                ok: false,
+                status: 0,
+                error: message || 'Network error'
+            };
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=RequestClient.js.map

package/dist/classes/RequestClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestClient.js","sourceRoot":"","sources":["../../src/classes/RequestClient.ts"],"names":[],"mappings":"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"}

package/dist/classes/Webhook.d.ts

@@ -0,0 +1,136 @@
+import type { IEmbed, IWebhook, IWebhookParameter, WebhookFile } from '../types';
+import type { Embed } from './Embed';
+import { RequestClient, type RequestResult, type RetryConfig } from './RequestClient';
+/**
+ * Webhook class
+ *
+ * ```ts
+ * import { Webhook } from '@teever/ez-hook'
+ * const webhook = new Webhook('https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz')
+ * webhook.setUsername('username')
+ * webhook.setContent('Hello world!')
+ *
+ * const success = await webhook.send()
+ * ```
+ */
+export declare class Webhook {
+    protected client: RequestClient;
+    /**
+     * Webhook username override.
+     */
+    protected username?: string;
+    /**
+     * Webhook avatar override.
+     */
+    protected avatar_url?: string;
+    /**
+     * Whether or not this notification should be read as text to speech.
+     */
+    protected tts?: boolean;
+    /**
+     * Message contents.
+     * Max 2000 characters
+     */
+    protected content?: string;
+    /**
+     * Contents of a file being sent.
+     */
+    protected file?: WebhookFile;
+    /**
+     * Embedded "rich" content.
+     */
+    protected embeds?: Array<IEmbed>;
+    /**
+     *
+     * @param webhookUrl
+     */
+    constructor(webhookUrl: string, retryConfig?: Partial<RetryConfig>);
+    /**
+     * Set Webhook username override.
+     *
+     * @param username string
+     * @returns Embed
+     */
+    setUsername(username: string): Webhook;
+    /**
+     * Set Webhook avatar override.
+     *
+     * @param url string
+     * @returns Embed
+     */
+    setAvatarUrl(url: string): Webhook;
+    /**
+     * Set Whether or not this notification should be read as text to speech.
+     *
+     * @param flag boolean
+     * @returns Embed
+     */
+    setTTS(flag: boolean): Webhook;
+    /**
+     * Set Message contents.
+     * Max 2000 characters
+     *
+     * @param content string
+     * @returns Embed
+     */
+    setContent(content: string): Webhook;
+    /**
+     * Add Embedded "rich" content.
+     * Max 10 embeds
+     *
+     * @param embed string
+     * @returns Embed
+     */
+    addEmbed(embed: Embed): Webhook;
+    /**
+     * Set Contents of a file being sent.
+     *
+     * @param file Attachment | string
+     * @returns Embed
+     */
+    setFile(file: WebhookFile): Webhook;
+    /**
+     * Validate the webhook
+     *
+     * @returns void
+     */
+    validate(): void;
+    /**
+     * Send webhook
+     *
+     * @returns Promise<boolean>
+     */
+    send(init?: Parameters<RequestClient['send']>[2]): Promise<RequestResult>;
+    /**
+     * Modify the current webhook.
+     *
+     * @param options IWebHookParameter
+     * @returns Promise<IWebhookResponse>
+     */
+    modify(options: IWebhookParameter, init?: Parameters<RequestClient['send']>[2]): Promise<RequestResult>;
+    /**
+     * Get the current webhook.
+     *
+     * @returns Promise<IWebhookResponse>
+     */
+    get(init?: Parameters<RequestClient['send']>[2]): Promise<RequestResult>;
+    /**
+     * Check whether or not the current webhook is valid.
+     *
+     * @returns Promise<boolean>
+     */
+    isValid(): Promise<boolean>;
+    /**
+     * Generate parameter ready object
+     *
+     * @returns IWebhook
+     */
+    toObject(): IWebhook;
+    /**
+     * Get the current retry configuration.
+     *
+     * @returns RetryConfig
+     */
+    getRetryConfig(): RetryConfig;
+}
+//# sourceMappingURL=Webhook.d.ts.map

package/dist/classes/Webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webhook.d.ts","sourceRoot":"","sources":["../../src/classes/Webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,MAAM,EACN,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,EACN,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,MAAM,iBAAiB,CAAA;AAExB;;;;;;;;;;;GAWG;AAEH,qBAAa,OAAO;IACnB,SAAS,CAAC,MAAM,EAAE,aAAa,CAAA;IAE/B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAE7B;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IAEvB;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAE1B;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;IAE5B;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAEhC;;;OAGG;gBACS,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAIlE;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK7C;;;;;OAKG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzC;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAKrC;;;;;;OAMG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAa3C;;;;;;OAMG;IACI,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAYtC;;;;;OAKG;IACI,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAK1C;;;;OAIG;IACI,QAAQ,IAAI,IAAI;IAyCvB;;;;OAIG;IACU,IAAI,CAChB,IAAI,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,aAAa,CAAC;IAKzB;;;;;OAKG;IACU,MAAM,CAClB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;OAIG;IACU,GAAG,CACf,IAAI,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;OAIG;IACI,QAAQ,IAAI,QAAQ;IAW3B;;;;OAIG;IACI,cAAc,IAAI,WAAW;CAGpC"}

package/dist/classes/Webhook.js

@@ -0,0 +1,208 @@
+import { ValidationError } from './Errors';
+import { RequestClient } from './RequestClient';
+/**
+ * Webhook class
+ *
+ * ```ts
+ * import { Webhook } from '@teever/ez-hook'
+ * const webhook = new Webhook('https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz')
+ * webhook.setUsername('username')
+ * webhook.setContent('Hello world!')
+ *
+ * const success = await webhook.send()
+ * ```
+ */
+export class Webhook {
+    client;
+    /**
+     * Webhook username override.
+     */
+    username;
+    /**
+     * Webhook avatar override.
+     */
+    avatar_url;
+    /**
+     * Whether or not this notification should be read as text to speech.
+     */
+    tts;
+    /**
+     * Message contents.
+     * Max 2000 characters
+     */
+    content;
+    /**
+     * Contents of a file being sent.
+     */
+    file;
+    /**
+     * Embedded "rich" content.
+     */
+    embeds;
+    /**
+     *
+     * @param webhookUrl
+     */
+    constructor(webhookUrl, retryConfig) {
+        this.client = new RequestClient(webhookUrl, retryConfig);
+    }
+    /**
+     * Set Webhook username override.
+     *
+     * @param username string
+     * @returns Embed
+     */
+    setUsername(username) {
+        this.username = username;
+        return this;
+    }
+    /**
+     * Set Webhook avatar override.
+     *
+     * @param url string
+     * @returns Embed
+     */
+    setAvatarUrl(url) {
+        this.avatar_url = url;
+        return this;
+    }
+    /**
+     * Set Whether or not this notification should be read as text to speech.
+     *
+     * @param flag boolean
+     * @returns Embed
+     */
+    setTTS(flag) {
+        this.tts = flag;
+        return this;
+    }
+    /**
+     * Set Message contents.
+     * Max 2000 characters
+     *
+     * @param content string
+     * @returns Embed
+     */
+    setContent(content) {
+        if (content.length > 2000) {
+            throw new ValidationError('Content length exceeds 2000 characters', 'content', 2000, content.length);
+        }
+        this.content = content;
+        return this;
+    }
+    /**
+     * Add Embedded "rich" content.
+     * Max 10 embeds
+     *
+     * @param embed string
+     * @returns Embed
+     */
+    addEmbed(embed) {
+        if (typeof this.embeds === 'undefined') {
+            this.embeds = [embed.toObject()];
+        }
+        else if (this.embeds.length < 10) {
+            this.embeds.push(embed.toObject());
+        }
+        else {
+            throw new ValidationError('Embeds length exceeds 10', 'embeds', 10);
+        }
+        return this;
+    }
+    /**
+     * Set Contents of a file being sent.
+     *
+     * @param file Attachment | string
+     * @returns Embed
+     */
+    setFile(file) {
+        this.file = file;
+        return this;
+    }
+    /**
+     * Validate the webhook
+     *
+     * @returns void
+     */
+    validate() {
+        if ((this.content?.length ?? 0) > 2000) {
+            throw new ValidationError('Content length exceeds 2000 characters', 'content', 2000, this.content?.length);
+        }
+        if ((this.embeds?.length ?? 0) > 10) {
+            throw new ValidationError('Embeds length exceeds 10', 'embeds', 10);
+        }
+        for (const embed of this.embeds ?? []) {
+            if ((embed.fields?.length ?? 0) > 25) {
+                throw new ValidationError('Fields length exceeds 25', 'fields', 25);
+            }
+            for (const field of embed.fields ?? []) {
+                if ((field.name?.length ?? 0) > 255) {
+                    throw new ValidationError('Field name length exceeds 255 characters', 'field.name', 255, field.name?.length);
+                }
+                if ((field.value?.length ?? 0) > 1024) {
+                    throw new ValidationError('Field value length exceeds 1024 characters', 'field.value', 1024, field.value?.length);
+                }
+            }
+        }
+    }
+    /**
+     * Send webhook
+     *
+     * @returns Promise<boolean>
+     */
+    async send(init) {
+        this.validate();
+        return this.client.send('POST', this.toObject(), init);
+    }
+    /**
+     * Modify the current webhook.
+     *
+     * @param options IWebHookParameter
+     * @returns Promise<IWebhookResponse>
+     */
+    async modify(options, init) {
+        return this.client.send('PATCH', options, init);
+    }
+    /**
+     * Get the current webhook.
+     *
+     * @returns Promise<IWebhookResponse>
+     */
+    async get(init) {
+        return this.client.send('GET', '', init);
+    }
+    /**
+     * Check whether or not the current webhook is valid.
+     *
+     * @returns Promise<boolean>
+     */
+    async isValid() {
+        return fetch(this.client.webhookUrl)
+            .then(() => true)
+            .catch(() => false);
+    }
+    /**
+     * Generate parameter ready object
+     *
+     * @returns IWebhook
+     */
+    toObject() {
+        return {
+            username: this.username,
+            avatar_url: this.avatar_url,
+            tts: this.tts,
+            content: this.content,
+            file: this.file,
+            embeds: this.embeds
+        };
+    }
+    /**
+     * Get the current retry configuration.
+     *
+     * @returns RetryConfig
+     */
+    getRetryConfig() {
+        return this.client.retryConfig;
+    }
+}
+//# sourceMappingURL=Webhook.js.map

package/dist/classes/Webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webhook.js","sourceRoot":"","sources":["../../src/classes/Webhook.ts"],"names":[],"mappings":"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"}

package/dist/classes/index.d.ts

@@ -0,0 +1,5 @@
+export { Embed } from './Embed';
+export { EzHookError, RateLimitError, ValidationError, WebhookError, WebhookNotFoundError } from './Errors';
+export { RequestClient } from './RequestClient';
+export { Webhook } from './Webhook';
+//# sourceMappingURL=index.d.ts.map

package/dist/classes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EACN,WAAW,EACX,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/classes/index.js

@@ -0,0 +1,5 @@
+export { Embed } from './Embed';
+export { EzHookError, RateLimitError, ValidationError, WebhookError, WebhookNotFoundError } from './Errors';
+export { RequestClient } from './RequestClient';
+export { Webhook } from './Webhook';
+//# sourceMappingURL=index.js.map