@neohm/nestend 6.3.0 → 6.5.0

package/dist/webhook/enums/webhook.enum.d.ts

@@ -0,0 +1,38 @@
+export declare enum WebhookEventStatus {
+    RECEIVED = "received",
+    PROCESSING = "processing",
+    PROCESSED = "processed",
+    IGNORED = "ignored",
+    FAILED = "failed"
+}
+export declare enum WebhookOutcome {
+    PROCESSED = "processed",
+    IGNORED = "ignored"
+}
+export declare enum WebhookDefault {
+    PROCESS_JOB = "process.webhook.event.job",
+    PURGE_JOB = "purge.webhook.events.job",
+    RETENTION_PROPERTY = "webhook_event_retention_days"
+}
+export declare enum WebhookBound {
+    RETENTION_DAYS = 90,
+    PROVIDER_MAX_LENGTH = 50,
+    EVENT_ID_MAX_LENGTH = 255,
+    TYPE_MAX_LENGTH = 150,
+    ERROR_MAX_LENGTH = 2000,
+    JOB_ATTEMPTS = 5,
+    JOB_BACKOFF_MS = 30000,
+    STALE_PROCESSING_MS = 600000,
+    MS_PER_DAY = 86400000
+}
+export declare enum WebhookMessage {
+    UNKNOWN_PROVIDER = "Unknown webhook provider",
+    INVALID_SIGNATURE = "Invalid webhook signature",
+    INVALID_EVENT = "The webhook handler returned an event without a valid id or type",
+    NOT_FOUND = "No webhook event exists for this id",
+    NOT_REPLAYABLE = "Only a failed, ignored, processed or stuck event can be replayed",
+    NO_HANDLER = "No handler is registered for provider",
+    PROVIDER_INVALID = "A webhook provider is lowercase letters, digits, hyphens and underscores"
+}
+export declare const WEBHOOK_PROVIDER_PATTERN: RegExp;
+//# sourceMappingURL=webhook.enum.d.ts.map

package/dist/webhook/enums/webhook.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.enum.d.ts","sourceRoot":"","sources":["../../../src/webhook/enums/webhook.enum.ts"],"names":[],"mappings":"AACA,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,SAAS,cAAc;IAEvB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAGD,oBAAY,cAAc;IACxB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,oBAAY,cAAc;IACxB,WAAW,8BAA8B;IACzC,SAAS,6BAA6B;IAEtC,kBAAkB,iCAAiC;CACpD;AAED,oBAAY,YAAY;IAEtB,cAAc,KAAK;IACnB,mBAAmB,KAAK;IACxB,mBAAmB,MAAM;IACzB,eAAe,MAAM;IACrB,gBAAgB,OAAO;IAEvB,YAAY,IAAI;IAChB,cAAc,QAAS;IAEvB,mBAAmB,SAAU;IAC7B,UAAU,WAAa;CACxB;AAED,oBAAY,cAAc;IACxB,gBAAgB,6BAA6B;IAC7C,iBAAiB,8BAA8B;IAC/C,aAAa,qEAAqE;IAClF,SAAS,wCAAwC;IACjD,cAAc,qEAAqE;IACnF,UAAU,0CAA0C;IACpD,gBAAgB,6EAA6E;CAC9F;AAGD,eAAO,MAAM,wBAAwB,QAA+B,CAAC"}

package/dist/webhook/enums/webhook.enum.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_PROVIDER_PATTERN = exports.WebhookMessage = exports.WebhookBound = exports.WebhookDefault = exports.WebhookOutcome = exports.WebhookEventStatus = void 0;
+var WebhookEventStatus;
+(function (WebhookEventStatus) {
+    WebhookEventStatus["RECEIVED"] = "received";
+    WebhookEventStatus["PROCESSING"] = "processing";
+    WebhookEventStatus["PROCESSED"] = "processed";
+    WebhookEventStatus["IGNORED"] = "ignored";
+    WebhookEventStatus["FAILED"] = "failed";
+})(WebhookEventStatus || (exports.WebhookEventStatus = WebhookEventStatus = {}));
+var WebhookOutcome;
+(function (WebhookOutcome) {
+    WebhookOutcome["PROCESSED"] = "processed";
+    WebhookOutcome["IGNORED"] = "ignored";
+})(WebhookOutcome || (exports.WebhookOutcome = WebhookOutcome = {}));
+var WebhookDefault;
+(function (WebhookDefault) {
+    WebhookDefault["PROCESS_JOB"] = "process.webhook.event.job";
+    WebhookDefault["PURGE_JOB"] = "purge.webhook.events.job";
+    WebhookDefault["RETENTION_PROPERTY"] = "webhook_event_retention_days";
+})(WebhookDefault || (exports.WebhookDefault = WebhookDefault = {}));
+var WebhookBound;
+(function (WebhookBound) {
+    WebhookBound[WebhookBound["RETENTION_DAYS"] = 90] = "RETENTION_DAYS";
+    WebhookBound[WebhookBound["PROVIDER_MAX_LENGTH"] = 50] = "PROVIDER_MAX_LENGTH";
+    WebhookBound[WebhookBound["EVENT_ID_MAX_LENGTH"] = 255] = "EVENT_ID_MAX_LENGTH";
+    WebhookBound[WebhookBound["TYPE_MAX_LENGTH"] = 150] = "TYPE_MAX_LENGTH";
+    WebhookBound[WebhookBound["ERROR_MAX_LENGTH"] = 2000] = "ERROR_MAX_LENGTH";
+    WebhookBound[WebhookBound["JOB_ATTEMPTS"] = 5] = "JOB_ATTEMPTS";
+    WebhookBound[WebhookBound["JOB_BACKOFF_MS"] = 30000] = "JOB_BACKOFF_MS";
+    WebhookBound[WebhookBound["STALE_PROCESSING_MS"] = 600000] = "STALE_PROCESSING_MS";
+    WebhookBound[WebhookBound["MS_PER_DAY"] = 86400000] = "MS_PER_DAY";
+})(WebhookBound || (exports.WebhookBound = WebhookBound = {}));
+var WebhookMessage;
+(function (WebhookMessage) {
+    WebhookMessage["UNKNOWN_PROVIDER"] = "Unknown webhook provider";
+    WebhookMessage["INVALID_SIGNATURE"] = "Invalid webhook signature";
+    WebhookMessage["INVALID_EVENT"] = "The webhook handler returned an event without a valid id or type";
+    WebhookMessage["NOT_FOUND"] = "No webhook event exists for this id";
+    WebhookMessage["NOT_REPLAYABLE"] = "Only a failed, ignored, processed or stuck event can be replayed";
+    WebhookMessage["NO_HANDLER"] = "No handler is registered for provider";
+    WebhookMessage["PROVIDER_INVALID"] = "A webhook provider is lowercase letters, digits, hyphens and underscores";
+})(WebhookMessage || (exports.WebhookMessage = WebhookMessage = {}));
+exports.WEBHOOK_PROVIDER_PATTERN = /^[a-z0-9][a-z0-9_-]{0,49}$/;
+//# sourceMappingURL=webhook.enum.js.map

package/dist/webhook/enums/webhook.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.enum.js","sourceRoot":"","sources":["../../../src/webhook/enums/webhook.enum.ts"],"names":[],"mappings":";;;AACA,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,+CAAyB,CAAA;IACzB,6CAAuB,CAAA;IAEvB,yCAAmB,CAAA;IACnB,uCAAiB,CAAA;AACnB,CAAC,EAPW,kBAAkB,kCAAlB,kBAAkB,QAO7B;AAGD,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,yCAAuB,CAAA;IACvB,qCAAmB,CAAA;AACrB,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB;AAED,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,2DAAyC,CAAA;IACzC,wDAAsC,CAAA;IAEtC,qEAAmD,CAAA;AACrD,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB;AAED,IAAY,YAaX;AAbD,WAAY,YAAY;IAEtB,oEAAmB,CAAA;IACnB,8EAAwB,CAAA;IACxB,+EAAyB,CAAA;IACzB,uEAAqB,CAAA;IACrB,0EAAuB,CAAA;IAEvB,+DAAgB,CAAA;IAChB,uEAAuB,CAAA;IAEvB,kFAA6B,CAAA;IAC7B,kEAAuB,CAAA;AACzB,CAAC,EAbW,YAAY,4BAAZ,YAAY,QAavB;AAED,IAAY,cAQX;AARD,WAAY,cAAc;IACxB,+DAA6C,CAAA;IAC7C,iEAA+C,CAAA;IAC/C,oGAAkF,CAAA;IAClF,mEAAiD,CAAA;IACjD,qGAAmF,CAAA;IACnF,sEAAoD,CAAA;IACpD,+GAA6F,CAAA;AAC/F,CAAC,EARW,cAAc,8BAAd,cAAc,QAQzB;AAGY,QAAA,wBAAwB,GAAG,4BAA4B,CAAC"}

package/dist/webhook/es6.classes.d.ts

@@ -0,0 +1,13 @@
+import { WebhookController } from './controllers/webhook.controller';
+import { WebhookService } from './services/webhook.service';
+import { ProcessWebhookEventJob } from './jobs/process.webhook.event.job';
+import { PurgeWebhookEventsJob } from './jobs/purge.webhook.events.job';
+export declare const es6Classes: {
+    controllers: (typeof WebhookController)[];
+    services: readonly [typeof WebhookService];
+    libraries: any[];
+    dtos: any[];
+    jobs: readonly [typeof ProcessWebhookEventJob, typeof PurgeWebhookEventsJob];
+    subscribers: any[];
+};
+//# sourceMappingURL=es6.classes.d.ts.map

package/dist/webhook/es6.classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es6.classes.d.ts","sourceRoot":"","sources":["../../src/webhook/es6.classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,eAAO,MAAM,UAAU;;;;;;;CAOtB,CAAC"}

package/dist/webhook/es6.classes.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.es6Classes = void 0;
+const webhook_controller_1 = require("./controllers/webhook.controller");
+const webhook_service_1 = require("./services/webhook.service");
+const process_webhook_event_job_1 = require("./jobs/process.webhook.event.job");
+const purge_webhook_events_job_1 = require("./jobs/purge.webhook.events.job");
+exports.es6Classes = {
+    controllers: [webhook_controller_1.WebhookController],
+    services: [webhook_service_1.WebhookService],
+    libraries: [],
+    dtos: [],
+    jobs: [process_webhook_event_job_1.ProcessWebhookEventJob, purge_webhook_events_job_1.PurgeWebhookEventsJob],
+    subscribers: [],
+};
+//# sourceMappingURL=es6.classes.js.map

package/dist/webhook/es6.classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"es6.classes.js","sourceRoot":"","sources":["../../src/webhook/es6.classes.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AACrE,gEAA4D;AAC5D,gFAA0E;AAC1E,8EAAwE;AAE3D,QAAA,UAAU,GAAG;IACxB,WAAW,EAAE,CAAC,sCAAiB,CAAC;IAChC,QAAQ,EAAE,CAAC,gCAAc,CAAU;IACnC,SAAS,EAAE,EAAE;IACb,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,CAAC,kDAAsB,EAAE,gDAAqB,CAAU;IAC9D,WAAW,EAAE,EAAE;CAChB,CAAC"}

package/dist/webhook/jobs/process.webhook.event.job.d.ts

@@ -0,0 +1,11 @@
+import { CommonJob } from '../../common/jobs/common.job';
+import { QueueService } from '../../common/services/queue.service';
+import { WebhookService } from '../services/webhook.service';
+import { ProcessWebhookEventJobData } from '../types/webhook.types';
+export declare class ProcessWebhookEventJob extends CommonJob {
+    protected readonly queueService: QueueService;
+    private readonly webhookService;
+    constructor(queueService: QueueService, webhookService: WebhookService);
+    handle(data: ProcessWebhookEventJobData): Promise<void>;
+}
+//# sourceMappingURL=process.webhook.event.job.d.ts.map

package/dist/webhook/jobs/process.webhook.event.job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.webhook.event.job.d.ts","sourceRoot":"","sources":["../../../src/webhook/jobs/process.webhook.event.job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGpE,qBACa,sBAAuB,SAAQ,SAAS;IAEjD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADZ,YAAY,EAAE,YAAY,EAC5B,cAAc,EAAE,cAAc;IAK3C,MAAM,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/dist/webhook/jobs/process.webhook.event.job.js

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessWebhookEventJob = void 0;
+const common_1 = require("@nestjs/common");
+const common_job_1 = require("../../common/jobs/common.job");
+const queue_service_1 = require("../../common/services/queue.service");
+const webhook_enum_1 = require("../enums/webhook.enum");
+const webhook_service_1 = require("../services/webhook.service");
+let ProcessWebhookEventJob = class ProcessWebhookEventJob extends common_job_1.CommonJob {
+    constructor(queueService, webhookService) {
+        super(webhook_enum_1.WebhookDefault.PROCESS_JOB);
+        this.queueService = queueService;
+        this.webhookService = webhookService;
+    }
+    async handle(data) {
+        await this.webhookService.process(data.event_id);
+    }
+};
+exports.ProcessWebhookEventJob = ProcessWebhookEventJob;
+exports.ProcessWebhookEventJob = ProcessWebhookEventJob = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [queue_service_1.QueueService,
+        webhook_service_1.WebhookService])
+], ProcessWebhookEventJob);
+//# sourceMappingURL=process.webhook.event.job.js.map

package/dist/webhook/jobs/process.webhook.event.job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.webhook.event.job.js","sourceRoot":"","sources":["../../../src/webhook/jobs/process.webhook.event.job.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,6DAAyD;AACzD,uEAAmE;AACnE,wDAAuD;AACvD,iEAA6D;AAKtD,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,sBAAS;IACnD,YACqB,YAA0B,EAC5B,cAA8B;QAE/C,KAAK,CAAC,6BAAc,CAAC,WAAW,CAAC,CAAC;QAHf,iBAAY,GAAZ,YAAY,CAAc;QAC5B,mBAAc,GAAd,cAAc,CAAgB;IAGjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAgC;QAC3C,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF,CAAA;AAXY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAGwB,4BAAY;QACZ,gCAAc;GAHtC,sBAAsB,CAWlC"}

package/dist/webhook/jobs/purge.webhook.events.job.d.ts

@@ -0,0 +1,11 @@
+import { CommonJob } from '../../common/jobs/common.job';
+import { QueueService } from '../../common/services/queue.service';
+import { WebhookService } from '../services/webhook.service';
+export declare class PurgeWebhookEventsJob extends CommonJob {
+    protected readonly queueService: QueueService;
+    private readonly webhookService;
+    schedulable: boolean;
+    constructor(queueService: QueueService, webhookService: WebhookService);
+    handle(): Promise<void>;
+}
+//# sourceMappingURL=purge.webhook.events.job.d.ts.map

package/dist/webhook/jobs/purge.webhook.events.job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.webhook.events.job.d.ts","sourceRoot":"","sources":["../../../src/webhook/jobs/purge.webhook.events.job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAO7D,qBACa,qBAAsB,SAAQ,SAAS;IAIhD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc;IAJ1B,WAAW,UAAQ;gBAGL,YAAY,EAAE,YAAY,EAC5B,cAAc,EAAE,cAAc;IAK3C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}

package/dist/webhook/jobs/purge.webhook.events.job.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurgeWebhookEventsJob = void 0;
+const common_1 = require("@nestjs/common");
+const common_job_1 = require("../../common/jobs/common.job");
+const queue_service_1 = require("../../common/services/queue.service");
+const webhook_enum_1 = require("../enums/webhook.enum");
+const webhook_service_1 = require("../services/webhook.service");
+let PurgeWebhookEventsJob = class PurgeWebhookEventsJob extends common_job_1.CommonJob {
+    constructor(queueService, webhookService) {
+        super(webhook_enum_1.WebhookDefault.PURGE_JOB);
+        this.queueService = queueService;
+        this.webhookService = webhookService;
+        this.schedulable = true;
+    }
+    async handle() {
+        const removed = await this.webhookService.purge();
+        if (removed)
+            this.logger.log(`Soft-deleted ${removed} webhook event(s).`);
+    }
+};
+exports.PurgeWebhookEventsJob = PurgeWebhookEventsJob;
+exports.PurgeWebhookEventsJob = PurgeWebhookEventsJob = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [queue_service_1.QueueService,
+        webhook_service_1.WebhookService])
+], PurgeWebhookEventsJob);
+//# sourceMappingURL=purge.webhook.events.job.js.map

package/dist/webhook/jobs/purge.webhook.events.job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.webhook.events.job.js","sourceRoot":"","sources":["../../../src/webhook/jobs/purge.webhook.events.job.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,6DAAyD;AACzD,uEAAmE;AACnE,wDAAuD;AACvD,iEAA6D;AAQtD,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,sBAAS;IAGlD,YACqB,YAA0B,EAC5B,cAA8B;QAE/C,KAAK,CAAC,6BAAc,CAAC,SAAS,CAAC,CAAC;QAHb,iBAAY,GAAZ,YAAY,CAAc;QAC5B,mBAAc,GAAd,cAAc,CAAgB;QAJ1C,gBAAW,GAAG,IAAI,CAAC;IAO1B,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAClD,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,OAAO,oBAAoB,CAAC,CAAC;IAC5E,CAAC;CACF,CAAA;AAdY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAKwB,4BAAY;QACZ,gCAAc;GALtC,qBAAqB,CAcjC"}

package/dist/webhook/services/webhook.service.d.ts

@@ -0,0 +1,26 @@
+import { DataSource } from 'typeorm';
+import { QueueService } from '../../common/services/queue.service';
+import { SystemPropertyService } from '../../common/services/system.property.service';
+import { WebhookEventEntity } from '../entities/webhook.event.entity';
+import { WebhookHandler, WebhookReceipt, WebhookRequest } from '../types/webhook.types';
+export declare class WebhookService {
+    private readonly dataSource;
+    private readonly queueService;
+    private readonly systemPropertyService;
+    private readonly logger;
+    private readonly handlers;
+    constructor(dataSource: DataSource, queueService: QueueService, systemPropertyService: SystemPropertyService);
+    register(handler: WebhookHandler): void;
+    providers(): string[];
+    receive(provider: string, request: WebhookRequest): Promise<WebhookReceipt>;
+    process(eventId: string): Promise<void>;
+    replay(eventId: string): Promise<WebhookEventEntity>;
+    detail(eventId: string): Promise<WebhookEventEntity>;
+    purge(days?: number): Promise<number>;
+    retentionDays(): Promise<number>;
+    private enqueue;
+    private static ipAllowed;
+    private static isValid;
+    private get repository();
+}
+//# sourceMappingURL=webhook.service.d.ts.map

package/dist/webhook/services/webhook.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.service.d.ts","sourceRoot":"","sources":["../../../src/webhook/services/webhook.service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAItF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAStE,OAAO,EAGL,cAAc,EACd,cAAc,EACd,cAAc,EACf,MAAM,wBAAwB,CAAC;AAShC,qBACa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IANxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAG3C,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,qBAAqB,EAAE,qBAAqB;IAI/D,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IASvC,SAAS,IAAI,MAAM,EAAE;IASf,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC;IAgEpB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DvC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBpD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAepD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBrC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;YAOxB,OAAO;IASrB,OAAO,CAAC,MAAM,CAAC,SAAS;IAUxB,OAAO,CAAC,MAAM,CAAC,OAAO;IAatB,OAAO,KAAK,UAAU,GAErB;CACF"}

package/dist/webhook/services/webhook.service.js

@@ -0,0 +1,217 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var WebhookService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+const queue_service_1 = require("../../common/services/queue.service");
+const system_property_service_1 = require("../../common/services/system.property.service");
+const not_found_exception_1 = require("../../global/exceptions/not.found.exception");
+const operation_exception_1 = require("../../global/exceptions/operation.exception");
+const environment_util_1 = require("../../global/utilities/environment.util");
+const webhook_event_entity_1 = require("../entities/webhook.event.entity");
+const webhook_enum_1 = require("../enums/webhook.enum");
+let WebhookService = WebhookService_1 = class WebhookService {
+    constructor(dataSource, queueService, systemPropertyService) {
+        this.dataSource = dataSource;
+        this.queueService = queueService;
+        this.systemPropertyService = systemPropertyService;
+        this.logger = new common_1.Logger(WebhookService_1.name);
+        this.handlers = new Map();
+    }
+    register(handler) {
+        if (!webhook_enum_1.WEBHOOK_PROVIDER_PATTERN.test(handler.provider))
+            throw new Error(`${webhook_enum_1.WebhookMessage.PROVIDER_INVALID}: '${handler.provider}'`);
+        this.handlers.set(handler.provider, handler);
+    }
+    providers() {
+        return [...this.handlers.keys()].sort();
+    }
+    async receive(provider, request) {
+        const handler = webhook_enum_1.WEBHOOK_PROVIDER_PATTERN.test(provider)
+            ? this.handlers.get(provider)
+            : undefined;
+        if (!handler)
+            throw new not_found_exception_1.NotFoundException(webhook_enum_1.WebhookMessage.UNKNOWN_PROVIDER);
+        let genuine = false;
+        try {
+            genuine =
+                WebhookService_1.ipAllowed(handler, request.ip) &&
+                    (await handler.verify(request)) === true;
+        }
+        catch (error) {
+            this.logger.warn(`Webhook verification failed for ${provider}: ${error.message}`);
+        }
+        if (!genuine)
+            throw new common_1.UnauthorizedException(webhook_enum_1.WebhookMessage.INVALID_SIGNATURE);
+        const parsed = await handler.parse(request);
+        const events = Array.isArray(parsed) ? parsed : [parsed];
+        if (!events.every((event) => WebhookService_1.isValid(event)))
+            throw new common_1.BadRequestException(webhook_enum_1.WebhookMessage.INVALID_EVENT);
+        const receipt = { received: 0, duplicates: 0 };
+        for (const event of events) {
+            const inserted = await this.repository
+                .createQueryBuilder()
+                .insert()
+                .into(webhook_event_entity_1.WebhookEventEntity)
+                .values({
+                provider,
+                event_id: event.event_id,
+                type: event.type,
+                payload: event.payload,
+                status: webhook_enum_1.WebhookEventStatus.RECEIVED,
+            })
+                .orIgnore()
+                .returning(['id'])
+                .execute();
+            const id = inserted.raw[0]?.id;
+            if (id) {
+                receipt.received++;
+                await this.enqueue(id);
+                continue;
+            }
+            receipt.duplicates++;
+            const stored = await this.repository.findOne({
+                where: { provider, event_id: event.event_id },
+                select: { id: true, status: true },
+            });
+            if (stored?.status === webhook_enum_1.WebhookEventStatus.RECEIVED)
+                await this.enqueue(stored.id);
+        }
+        return receipt;
+    }
+    async process(eventId) {
+        const staleBefore = new Date(Date.now() - webhook_enum_1.WebhookBound.STALE_PROCESSING_MS);
+        const claim = await this.repository
+            .createQueryBuilder()
+            .update(webhook_event_entity_1.WebhookEventEntity)
+            .set({
+            status: webhook_enum_1.WebhookEventStatus.PROCESSING,
+            attempts: () => 'attempts + 1',
+        })
+            .where('id = :eventId', { eventId })
+            .andWhere('(status in (:...claimable) or (status = :processing and updated_at < :staleBefore))', {
+            claimable: [webhook_enum_1.WebhookEventStatus.RECEIVED, webhook_enum_1.WebhookEventStatus.FAILED],
+            processing: webhook_enum_1.WebhookEventStatus.PROCESSING,
+            staleBefore,
+        })
+            .execute();
+        if (claim.affected !== 1)
+            return;
+        const event = await this.repository
+            .createQueryBuilder('e')
+            .addSelect('e.payload')
+            .where('e.id = :eventId', { eventId })
+            .getOneOrFail();
+        try {
+            const handler = this.handlers.get(event.provider);
+            if (!handler)
+                throw new Error(`${webhook_enum_1.WebhookMessage.NO_HANDLER} '${event.provider}'`);
+            const outcome = await handler.handle(event);
+            await this.repository.update({ id: event.id }, {
+                status: outcome === webhook_enum_1.WebhookOutcome.IGNORED
+                    ? webhook_enum_1.WebhookEventStatus.IGNORED
+                    : webhook_enum_1.WebhookEventStatus.PROCESSED,
+                processed_at: new Date(),
+                last_error: null,
+            });
+        }
+        catch (error) {
+            await this.repository.update({ id: event.id }, {
+                status: webhook_enum_1.WebhookEventStatus.FAILED,
+                last_error: (error instanceof Error
+                    ? error.message
+                    : String(error)).slice(0, webhook_enum_1.WebhookBound.ERROR_MAX_LENGTH),
+            });
+            throw error;
+        }
+    }
+    async replay(eventId) {
+        if (!(await this.repository.existsBy({ id: eventId })))
+            throw new not_found_exception_1.NotFoundException(webhook_enum_1.WebhookMessage.NOT_FOUND);
+        const staleBefore = new Date(Date.now() - webhook_enum_1.WebhookBound.STALE_PROCESSING_MS);
+        const reset = await this.repository
+            .createQueryBuilder()
+            .update(webhook_event_entity_1.WebhookEventEntity)
+            .set({ status: webhook_enum_1.WebhookEventStatus.RECEIVED, last_error: null })
+            .where('id = :eventId', { eventId })
+            .andWhere('(status <> :processing or updated_at < :staleBefore)', {
+            processing: webhook_enum_1.WebhookEventStatus.PROCESSING,
+            staleBefore,
+        })
+            .execute();
+        if (reset.affected !== 1)
+            throw new operation_exception_1.OperationException(webhook_enum_1.WebhookMessage.NOT_REPLAYABLE);
+        await this.enqueue(eventId);
+        return this.repository.findOneByOrFail({ id: eventId });
+    }
+    async detail(eventId) {
+        const event = await this.repository
+            .createQueryBuilder('e')
+            .addSelect('e.payload')
+            .where('e.id = :eventId', { eventId })
+            .getOne();
+        if (!event)
+            throw new not_found_exception_1.NotFoundException(webhook_enum_1.WebhookMessage.NOT_FOUND);
+        return event;
+    }
+    async purge(days) {
+        const retention = days ?? (await this.retentionDays());
+        if (!(retention > 0))
+            return 0;
+        const { affected } = await this.repository.softDelete({
+            status: (0, typeorm_1.In)([webhook_enum_1.WebhookEventStatus.PROCESSED, webhook_enum_1.WebhookEventStatus.IGNORED]),
+            created_at: (0, typeorm_1.LessThan)(new Date(Date.now() - retention * webhook_enum_1.WebhookBound.MS_PER_DAY)),
+        });
+        return affected ?? 0;
+    }
+    async retentionDays() {
+        const value = await this.systemPropertyService.get(webhook_enum_1.WebhookDefault.RETENTION_PROPERTY);
+        return (0, environment_util_1.envInt)(value ?? undefined, webhook_enum_1.WebhookBound.RETENTION_DAYS);
+    }
+    async enqueue(eventId) {
+        const data = { event_id: eventId };
+        await this.queueService.addJob(webhook_enum_1.WebhookDefault.PROCESS_JOB, data, {
+            attempts: webhook_enum_1.WebhookBound.JOB_ATTEMPTS,
+            backoff: { type: 'exponential', delay: webhook_enum_1.WebhookBound.JOB_BACKOFF_MS },
+        });
+    }
+    static ipAllowed(handler, ip) {
+        if (!handler.allowedIps?.length)
+            return true;
+        if (!ip)
+            return false;
+        const normalised = ip.startsWith('::ffff:') ? ip.slice(7) : ip;
+        return handler.allowedIps.includes(normalised);
+    }
+    static isValid(event) {
+        return (typeof event?.event_id === 'string' &&
+            event.event_id.length > 0 &&
+            event.event_id.length <= Number(webhook_enum_1.WebhookBound.EVENT_ID_MAX_LENGTH) &&
+            typeof event.type === 'string' &&
+            event.type.length > 0 &&
+            event.type.length <= Number(webhook_enum_1.WebhookBound.TYPE_MAX_LENGTH) &&
+            !!event.payload &&
+            typeof event.payload === 'object');
+    }
+    get repository() {
+        return this.dataSource.getRepository(webhook_event_entity_1.WebhookEventEntity);
+    }
+};
+exports.WebhookService = WebhookService;
+exports.WebhookService = WebhookService = WebhookService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource,
+        queue_service_1.QueueService,
+        system_property_service_1.SystemPropertyService])
+], WebhookService);
+//# sourceMappingURL=webhook.service.js.map

package/dist/webhook/services/webhook.service.js.map

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

package/dist/webhook/types/webhook.types.d.ts

@@ -0,0 +1,39 @@
+import type { IncomingHttpHeaders } from 'http';
+import type { WebhookEventEntity } from '../entities/webhook.event.entity';
+import type { WebhookOutcome } from '../enums/webhook.enum';
+export interface WebhookModuleOptions {
+    dataSourceName?: string;
+}
+export interface WebhookRequest {
+    provider: string;
+    headers: IncomingHttpHeaders;
+    rawBody: Buffer | undefined;
+    body: unknown;
+    query: Record<string, unknown>;
+    ip: string | undefined;
+}
+export interface ParsedWebhookEvent {
+    event_id: string;
+    type: string;
+    payload: Record<string, unknown>;
+}
+export interface WebhookHandler {
+    readonly provider: string;
+    readonly allowedIps?: readonly string[];
+    verify(request: WebhookRequest): boolean | Promise<boolean>;
+    parse(request: WebhookRequest): ParsedWebhookEvent | ParsedWebhookEvent[] | Promise<ParsedWebhookEvent | ParsedWebhookEvent[]>;
+    handle(event: WebhookEventEntity): Promise<WebhookOutcome>;
+}
+export interface WebhookReceipt {
+    received: number;
+    duplicates: number;
+}
+export interface ProcessWebhookEventJobData {
+    event_id: string;
+}
+export interface WebhookHmacOptions {
+    algorithm?: string;
+    encoding?: 'hex' | 'base64';
+    prefix?: string;
+}
+//# sourceMappingURL=webhook.types.d.ts.map

package/dist/webhook/types/webhook.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.types.d.ts","sourceRoot":"","sources":["../../../src/webhook/types/webhook.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,mBAAmB,CAAC;IAE7B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CACxB;AAGD,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAQD,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,CACH,OAAO,EAAE,cAAc,GAErB,kBAAkB,GAClB,kBAAkB,EAAE,GACpB,OAAO,CAAC,kBAAkB,GAAG,kBAAkB,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5D;AAGD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,kBAAkB;IAEjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/webhook/types/webhook.types.js

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

package/dist/webhook/types/webhook.types.js.map

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

package/dist/webhook/utilities/webhook.signature.d.ts

@@ -0,0 +1,6 @@
+import { WebhookHmacOptions } from '../types/webhook.types';
+export declare class WebhookSignature {
+    static verifyHmac(payload: Buffer | string | undefined, signature: string | string[] | undefined, secret: string | undefined, options?: WebhookHmacOptions): boolean;
+    static isFresh(timestamp: number | string | undefined, toleranceSeconds: number, now?: number): boolean;
+}
+//# sourceMappingURL=webhook.signature.d.ts.map

package/dist/webhook/utilities/webhook.signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.signature.d.ts","sourceRoot":"","sources":["../../../src/webhook/utilities/webhook.signature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAO5D,qBAAa,gBAAgB;IAE3B,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACxC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,OAAO;IAmBV,MAAM,CAAC,OAAO,CACZ,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACtC,gBAAgB,EAAE,MAAM,EACxB,GAAG,SAAa,GACf,OAAO;CAOX"}

package/dist/webhook/utilities/webhook.signature.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookSignature = void 0;
+const crypto_1 = require("crypto");
+class WebhookSignature {
+    static verifyHmac(payload, signature, secret, options = {}) {
+        const given = Array.isArray(signature) ? signature[0] : signature;
+        if (!payload || !given || !secret)
+            return false;
+        const encoding = options.encoding ?? 'hex';
+        const expected = (0, crypto_1.createHmac)(options.algorithm ?? 'sha256', secret)
+            .update(payload)
+            .digest(encoding);
+        const received = options.prefix && given.startsWith(options.prefix)
+            ? given.slice(options.prefix.length)
+            : given;
+        const a = Buffer.from(expected);
+        const b = Buffer.from(received.trim());
+        return a.length === b.length && (0, crypto_1.timingSafeEqual)(a, b);
+    }
+    static isFresh(timestamp, toleranceSeconds, now = Date.now()) {
+        const value = Number(timestamp);
+        if (!Number.isFinite(value) || value <= 0)
+            return false;
+        const ms = value < 1e12 ? value * 1000 : value;
+        return Math.abs(now - ms) <= toleranceSeconds * 1000;
+    }
+}
+exports.WebhookSignature = WebhookSignature;
+//# sourceMappingURL=webhook.signature.js.map

package/dist/webhook/utilities/webhook.signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.signature.js","sourceRoot":"","sources":["../../../src/webhook/utilities/webhook.signature.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAQrD,MAAa,gBAAgB;IAE3B,MAAM,CAAC,UAAU,CACf,OAAoC,EACpC,SAAwC,EACxC,MAA0B,EAC1B,UAA8B,EAAE;QAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEhD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAA,mBAAU,EAAC,OAAO,CAAC,SAAS,IAAI,QAAQ,EAAE,MAAM,CAAC;aAC/D,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpB,MAAM,QAAQ,GACZ,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;YAChD,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,CAAC,CAAC,KAAK,CAAC;QAEZ,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,IAAA,wBAAe,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAGD,MAAM,CAAC,OAAO,CACZ,SAAsC,EACtC,gBAAwB,EACxB,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QAEhB,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAExD,MAAM,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,gBAAgB,GAAG,IAAI,CAAC;IACvD,CAAC;CACF;AArCD,4CAqCC"}

package/dist/webhook/webhook.module.d.ts

@@ -0,0 +1,7 @@
+import { DynamicModule } from '@nestjs/common';
+import type { WebhookModuleOptions } from './types/webhook.types';
+export type { WebhookModuleOptions } from './types/webhook.types';
+export declare class WebhookModule {
+    static register(options?: WebhookModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=webhook.module.d.ts.map

package/dist/webhook/webhook.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.module.d.ts","sourceRoot":"","sources":["../../src/webhook/webhook.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAQjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAuClE,qBAOa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa;CAcnE"}