@marinoscar/platform-api 0.1.0-next.19 → 0.1.0-next.20

package/dist/webhooks/webhooks.service.d.ts

@@ -0,0 +1,91 @@
+import { type AuditSink } from '../core/index';
+import { JobsService } from '../jobs/index';
+import { MetricsHostService } from '../otel-core/index';
+import type { WebhooksPrisma } from './ports';
+import { WebhooksRepository } from './webhooks.repository';
+/** Where an event happened. @stability experimental */
+export interface WebhookEmitContext {
+    /** The organization the event belongs to; `null` for a deployment-wide (system) event. A user event with none uses the single-mode default organization. */
+    readonly orgId: string | null;
+    /** The user the event is about (audience `user`). */
+    readonly userId?: string;
+    /** A fixed event id: a replayed fan-out passes the original, so the unique key dedupes it. Default: a new UUID. */
+    readonly eventId?: string;
+    /** When the event happened; default now. */
+    readonly occurredAt?: Date;
+}
+/** What one emit did. @stability experimental */
+export interface WebhookEmitResult {
+    /** Endpoints that subscribe to the event and may receive it. */
+    readonly matched: number;
+    /** Delivery rows inserted (and jobs enqueued). */
+    readonly queued: number;
+    /** The event id. */
+    readonly eventId: string;
+}
+/** The payload of a `webhooks.fanout` job. @stability experimental */
+export interface WebhookFanoutPayload {
+    /** Event key. */
+    readonly eventKey: string;
+    /** Data. */
+    readonly data: unknown;
+    /** Org id. */
+    readonly orgId: string | null;
+    /** User id. */
+    readonly userId?: string;
+    /** Event id. */
+    readonly eventId: string;
+    /** Occurred at. */
+    readonly occurredAt: string;
+}
+/**
+ * See the file header.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare class WebhooksService {
+    private readonly repository;
+    private readonly jobs;
+    private readonly prisma;
+    private readonly audit;
+    private readonly metrics?;
+    private readonly logger;
+    constructor(repository: WebhooksRepository, jobs: JobsService, prisma: WebhooksPrisma, audit: AuditSink, metrics?: MetricsHostService | undefined);
+    /**
+     * Raises an event. Never throws for an unknown event, invalid data or a
+     * missing organization; those are logged and counted.
+     *
+     * @param eventKey - a registered key, or `notification.<eventKey>`.
+     * @param data - validated against the event's schema.
+     * @param context - where it happened.
+     * @returns how many endpoints matched and how many deliveries were queued.
+     */
+    emit(eventKey: string, data: unknown, context: WebhookEmitContext): Promise<WebhookEmitResult>;
+    /**
+     * Raises a user event (audience `user`) for one member.
+     *
+     * @param userId - the member.
+     * @param eventKey - a `user`-audience key, typically `notification.<eventKey>`.
+     * @param data - the event's data.
+     * @param options - the member's organization, a fixed event id.
+     * @returns what {@link WebhooksService.emit} returns.
+     */
+    emitForUser(userId: string, eventKey: string, data: unknown, options?: {
+        orgId?: string | null;
+        eventId?: string;
+        occurredAt?: Date;
+    }): Promise<WebhookEmitResult>;
+    /**
+     * Queues the fan-out of an event to a `webhooks.fanout` job. The shape every
+     * event listener uses: one bounded insert, no fan-out inline.
+     *
+     * @param eventKey - the event key.
+     * @param data - the event's data (JSON).
+     * @param context - where it happened.
+     * @returns the event id the job will emit under.
+     */
+    enqueueFanout(eventKey: string, data: unknown, context: WebhookEmitContext): Promise<string>;
+    private disableForLostAccess;
+}
+//# sourceMappingURL=webhooks.service.d.ts.map

package/dist/webhooks/webhooks.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.service.d.ts","sourceRoot":"","sources":["../../src/webhooks/webhooks.service.ts"],"names":[],"mappings":"AA6BA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAY9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,4JAA4J;IAC5J,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;CAC5B;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,cAAc;IACd,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe;IACf,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,qBACa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACI,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAPvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAGxC,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,WAAW,EACQ,MAAM,EAAE,cAAc,EAC3B,KAAK,EAAE,SAAS,EACxB,OAAO,CAAC,EAAE,kBAAkB,YAAA;IAG3D;;;;;;;;OAQG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwEpG;;;;;;;;OAQG;IACH,WAAW,CACT,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,IAAI,CAAA;KAAO,GAC3E,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;YAqBpF,oBAAoB;CAgBnC"}

package/dist/webhooks/webhooks.service.js

@@ -0,0 +1,216 @@
+"use strict";
+// =============================================================================
+// WebhooksService: emit an event to the endpoints subscribed to it (issue #1046)
+// =============================================================================
+//
+// `emit(eventKey, data, { orgId, userId })` is the one entry point a slice or an
+// app calls to raise a webhook event. It:
+//
+//   1. resolves the event (registered, or a bridged `notification.<key>`) and
+//      validates `data` against its schema; an unknown key or invalid data is
+//      logged and counted and NEVER thrown to the caller (an event must not
+//      break the code that raised it);
+//   2. finds the enabled endpoints the event's audience can reach (a user's own,
+//      an organization's, or the deployment's) that subscribe to the key;
+//   3. re-checks each endpoint's OWNER'S access now (`webhooks.access.ts`): an
+//      owner who lost it has the endpoint switched off (`owner_lost_access`);
+//   4. inserts one delivery row per endpoint and enqueues its `webhooks.deliver`
+//      job in ONE transaction. The `(endpointId, eventId)` unique key makes the
+//      whole thing idempotent: a replayed fan-out job inserts nothing twice.
+//
+// MUST be called after the triggering write commits and outside any
+// `$transaction` (like `notify()`): it opens its own short transaction. It
+// performs no outbound HTTP: deliveries are made only by the `webhooks.deliver`
+// job.
+// =============================================================================
+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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var WebhooksService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhooksService = void 0;
+const node_crypto_1 = require("node:crypto");
+const common_1 = require("@nestjs/common");
+const index_1 = require("../core/index");
+const index_2 = require("../identity/index");
+const index_3 = require("../jobs/index");
+const index_4 = require("../otel-core/index");
+const webhook_catalog_1 = require("./registry/webhook-catalog");
+const webhook_event_registry_1 = require("./registry/webhook-event.registry");
+const webhook_envelope_1 = require("./webhook-envelope");
+const webhooks_access_1 = require("./webhooks.access");
+const webhooks_constants_1 = require("./webhooks.constants");
+const webhooks_metrics_1 = require("./webhooks.metrics");
+const webhooks_repository_1 = require("./webhooks.repository");
+/**
+ * See the file header.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+let WebhooksService = WebhooksService_1 = class WebhooksService {
+    repository;
+    jobs;
+    prisma;
+    audit;
+    metrics;
+    logger = new common_1.Logger(WebhooksService_1.name);
+    constructor(repository, jobs, prisma, audit, metrics) {
+        this.repository = repository;
+        this.jobs = jobs;
+        this.prisma = prisma;
+        this.audit = audit;
+        this.metrics = metrics;
+    }
+    /**
+     * Raises an event. Never throws for an unknown event, invalid data or a
+     * missing organization; those are logged and counted.
+     *
+     * @param eventKey - a registered key, or `notification.<eventKey>`.
+     * @param data - validated against the event's schema.
+     * @param context - where it happened.
+     * @returns how many endpoints matched and how many deliveries were queued.
+     */
+    async emit(eventKey, data, context) {
+        const eventId = context.eventId ?? (0, node_crypto_1.randomUUID)();
+        const none = { matched: 0, queued: 0, eventId };
+        const group = (0, webhook_envelope_1.eventGroupOf)(eventKey);
+        const event = (0, webhook_catalog_1.resolveWebhookEvent)(eventKey);
+        if (!event) {
+            this.logger.warn(`Webhook event "${eventKey}" is not registered; nothing was sent`);
+            this.metrics?.add(webhooks_metrics_1.WEBHOOK_EVENTS_METRIC, 1, { outcome: 'unknown', event_group: group });
+            return none;
+        }
+        const parsed = event.payloadSchema.safeParse(data);
+        if (!parsed.success) {
+            this.logger.warn(`Webhook event "${eventKey}" has invalid data (${parsed.error.issues.length} issue(s)); nothing was sent`);
+            this.metrics?.add(webhooks_metrics_1.WEBHOOK_EVENTS_METRIC, 1, { outcome: 'invalid', event_group: group });
+            return none;
+        }
+        let orgId;
+        try {
+            orgId = event.audience === 'system' ? null : await (0, index_2.resolveOrgId)(this.prisma, context.orgId, `Webhook event ${eventKey}`);
+        }
+        catch (error) {
+            this.logger.debug(`Webhook event "${eventKey}" has no organization to deliver in: ${error instanceof Error ? error.message : String(error)}`);
+            this.metrics?.add(webhooks_metrics_1.WEBHOOK_EVENTS_METRIC, 1, { outcome: 'no_match', event_group: group });
+            return none;
+        }
+        if (event.audience === 'user' && !context.userId) {
+            this.logger.warn(`Webhook event "${eventKey}" is a user event and was emitted without a user`);
+            this.metrics?.add(webhooks_metrics_1.WEBHOOK_EVENTS_METRIC, 1, { outcome: 'invalid', event_group: group });
+            return none;
+        }
+        const candidates = (await this.repository.enabledEndpoints(orgId, {
+            scope: event.audience,
+            ...(event.audience === 'user' ? { ownerUserId: context.userId } : {}),
+        })).filter((endpoint) => (0, webhook_event_registry_1.isSubscribed)(endpoint.eventKeys, eventKey));
+        const allowed = [];
+        const owners = new Map();
+        for (const endpoint of candidates) {
+            const ownerId = (0, webhooks_access_1.ownerIdOf)(endpoint);
+            if (ownerId === null) {
+                allowed.push(endpoint);
+                continue;
+            }
+            if (!owners.has(ownerId))
+                owners.set(ownerId, await this.repository.loadOwner(orgId, ownerId));
+            if ((0, webhooks_access_1.ownerMayReceive)(owners.get(ownerId) ?? null, endpoint, event))
+                allowed.push(endpoint);
+            else
+                await this.disableForLostAccess(endpoint);
+        }
+        if (allowed.length === 0) {
+            this.metrics?.add(webhooks_metrics_1.WEBHOOK_EVENTS_METRIC, 1, { outcome: 'no_match', event_group: group });
+            return { ...none, matched: 0 };
+        }
+        const envelope = (0, webhook_envelope_1.buildEnvelope)({
+            eventId,
+            eventKey,
+            orgId: event.audience === 'system' ? null : orgId,
+            data: parsed.data,
+            occurredAt: context.occurredAt ?? new Date(),
+        });
+        const inserted = await this.repository.insertDeliveries(orgId, allowed.map((endpoint) => ({ endpointId: endpoint.id, eventKey, eventId, payload: envelope })));
+        this.metrics?.add(webhooks_metrics_1.WEBHOOK_EVENTS_METRIC, 1, { outcome: 'queued', event_group: group });
+        return { matched: allowed.length, queued: inserted.length, eventId };
+    }
+    /**
+     * Raises a user event (audience `user`) for one member.
+     *
+     * @param userId - the member.
+     * @param eventKey - a `user`-audience key, typically `notification.<eventKey>`.
+     * @param data - the event's data.
+     * @param options - the member's organization, a fixed event id.
+     * @returns what {@link WebhooksService.emit} returns.
+     */
+    emitForUser(userId, eventKey, data, options = {}) {
+        return this.emit(eventKey, data, { orgId: options.orgId ?? null, userId, ...(options.eventId ? { eventId: options.eventId } : {}), ...(options.occurredAt ? { occurredAt: options.occurredAt } : {}) });
+    }
+    /**
+     * Queues the fan-out of an event to a `webhooks.fanout` job. The shape every
+     * event listener uses: one bounded insert, no fan-out inline.
+     *
+     * @param eventKey - the event key.
+     * @param data - the event's data (JSON).
+     * @param context - where it happened.
+     * @returns the event id the job will emit under.
+     */
+    async enqueueFanout(eventKey, data, context) {
+        const eventId = context.eventId ?? (0, node_crypto_1.randomUUID)();
+        const payload = {
+            eventKey,
+            data,
+            orgId: context.orgId,
+            ...(context.userId ? { userId: context.userId } : {}),
+            eventId,
+            occurredAt: (context.occurredAt ?? new Date()).toISOString(),
+        };
+        await this.jobs.enqueue({
+            type: webhooks_constants_1.WEBHOOK_FANOUT_JOB_TYPE,
+            reason: 'upload',
+            subjectType: 'webhook_event',
+            subjectId: eventId,
+            orgId: context.orgId,
+            payload: payload,
+        });
+        return eventId;
+    }
+    async disableForLostAccess(endpoint) {
+        try {
+            const switched = await this.repository.disableEndpoint(endpoint.orgId, endpoint.id, webhooks_constants_1.WEBHOOK_DISABLED_REASONS.OWNER_LOST_ACCESS);
+            if (!switched)
+                return;
+            this.logger.warn(`Webhook endpoint ${endpoint.id} disabled: its owner no longer has access to the event`);
+            await this.audit.record({
+                action: webhooks_constants_1.WEBHOOK_AUDIT_ACTIONS.DISABLE,
+                actorUserId: null,
+                targetType: webhooks_constants_1.WEBHOOK_AUDIT_TARGET,
+                targetId: endpoint.id,
+                meta: { scope: endpoint.scope, reason: webhooks_constants_1.WEBHOOK_DISABLED_REASONS.OWNER_LOST_ACCESS },
+            });
+        }
+        catch (error) {
+            this.logger.error(`Could not disable webhook endpoint ${endpoint.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+};
+exports.WebhooksService = WebhooksService;
+exports.WebhooksService = WebhooksService = WebhooksService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __param(3, (0, common_1.Inject)(index_1.AUDIT_SINK)),
+    __param(4, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [webhooks_repository_1.WebhooksRepository,
+        index_3.JobsService, Object, Object, index_4.MetricsHostService])
+], WebhooksService);
+//# sourceMappingURL=webhooks.service.js.map

package/dist/webhooks/webhooks.service.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marinoscar/platform-api",
-  "version": "0.1.0-next.19",
+  "version": "0.1.0-next.20",
   "description": "NestJS dynamic modules of the platform (CommonJS, built with tsc for decorator metadata).",
   "license": "MIT",
   "type": "commonjs",
@@ -158,6 +158,14 @@
       "types": "./dist/db-backup/testing/index.d.ts",
       "default": "./dist/db-backup/testing/index.js"
     },
+    "./alerts": {
+      "types": "./dist/alerts/index.d.ts",
+      "default": "./dist/alerts/index.js"
+    },
+    "./alerts/testing": {
+      "types": "./dist/alerts/testing/index.d.ts",
+      "default": "./dist/alerts/testing/index.js"
+    },
     "./android-app": {
       "types": "./dist/android-app/index.d.ts",
       "default": "./dist/android-app/index.js"
@@ -166,6 +174,14 @@
       "types": "./dist/android-app/testing/index.d.ts",
       "default": "./dist/android-app/testing/index.js"
     },
+    "./webhooks": {
+      "types": "./dist/webhooks/index.d.ts",
+      "default": "./dist/webhooks/index.js"
+    },
+    "./webhooks/testing": {
+      "types": "./dist/webhooks/testing/index.d.ts",
+      "default": "./dist/webhooks/testing/index.js"
+    },
     "./user-data": {
       "types": "./dist/user-data/index.d.ts",
       "default": "./dist/user-data/index.js"
@@ -212,8 +228,8 @@
     "@aws-sdk/lib-storage": "^3.975.0",
     "@aws-sdk/s3-request-presigner": "^3.975.0",
     "@google/genai": "^2.24.0",
-    "@marinoscar/platform-ai-providers": "0.1.0-next.19",
-    "@marinoscar/platform-contract": "0.1.0-next.19",
+    "@marinoscar/platform-ai-providers": "0.1.0-next.20",
+    "@marinoscar/platform-contract": "0.1.0-next.20",
     "@opentelemetry/auto-instrumentations-node": "^0.79.0",
     "@opentelemetry/core": "^2.10.0",
     "@opentelemetry/exporter-logs-otlp-http": "^0.221.0",