@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/notifications/m2m/webhook-config.shared.resources-config.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-config.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../../src/notifications/m2m/webhook-config.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * M2M Webhook Config Resource Configuration — Polymorphic dual-scope\n *\n * Produces 2 factory functions (ORG + APP) via the polymorphic factory.\n * Spread into the registry factory map:\n *   ...webhookConfigPolymorphicFactories\n *\n * Operation set (mirrors SIEM Export Config singleton precedent):\n *   - READ   (API)              : admin reads the config + derived public key\n *   - CREATE (REPOSITORY_ONLY)  : seeded once per scope; not externally callable\n *   - UPDATE (REPOSITORY_ONLY)  : admin edits via dedicated endpoint flow (not a public REST PUT)\n *   - TEST_ENDPOINT (custom)    : fires a synthetic delivery to verify URL reachability\n *\n * @see m2m-webhook-organization-delivery.md — Phase 2 / Step 5\n * @see security/authentications/siem/siem-export-config.shared.resources-config.schemas.ts\n */\n\nimport { z } from 'zod';\nimport {\n  CoreResourceOperation,\n  CoreResourceType,\n} from '../../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n} from '../../resources/resources.shared.schemas';\nimport { createPolymorphicResourceConfigurations } from '../../resources/utils/resource-polymorphism.factory';\nimport { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas';\nimport { CORE_ORG_ROLES, CORE_APP_ROLES } from '../../security/authorizations/roles.shared.schemas';\nimport { webhookConfigPolymorphicDeclaration, WebhookEndpointProbeOutcome } from './webhook-config.shared.schemas';\n\n// =============================================================================\n// CUSTOM OPERATIONS\n// =============================================================================\n\nexport enum WebhookConfig_Operations {\n  /**\n   * Synthetic delivery to verify URL reachability + signature\n   * verification on the consumer side. Targets a single endpoint\n   * (selected by `endpointId` in the request body); does not write to\n   * `M2MWebhookDeliveryLog` (test deliveries are excluded from the user\n   * event log to keep the log clean).\n   *\n   * The probe is `resourceOperationLike: UPDATE`, NOT `READ`. It performs no\n   * database write, but it DOES have an external side effect — a live signed\n   * POST leaves the platform and arrives at a customer-controlled URL. Borrowing\n   * READ made this a `GET` whose OpenAPI entry had to declare `x-idempotent: false`,\n   * a self-contradiction, and pushed `endpointId` into a query string. Borrowing\n   * UPDATE yields a `PUT` on the same custom-op sub-path, matching the\n   * `M2MWebhookDeliveryLog.retry` precedent (also a no-DB-write-of-its-own verb\n   * that triggers a delivery).\n   */\n  TEST_ENDPOINT = 'testEndpoint',\n}\n\n// =============================================================================\n// REQUEST DTOs\n// =============================================================================\n\nexport const WebhookConfig_TestEndpointRequestDto = z.object({\n  endpointId: z.string().min(1),\n});\n\n// =============================================================================\n// RESPONSE DTOs\n// =============================================================================\n\n/**\n * Diagnostic returned synchronously by `testEndpoint`.\n *\n * A transport-level failure at the customer endpoint is a successful PROBE and\n * therefore answers HTTP 200 carrying `outcome: UNREACHABLE` — it is not an API\n * error. API errors are reserved for faults in the request itself (unknown\n * `endpointId`, no config row, rate limit exceeded).\n */\nexport const WebhookConfig_TestEndpointResponseDto = z.object({\n  endpointId: z.string(),\n  /** Destination actually contacted, echoed so the admin can confirm the stored URL. */\n  url: z.string(),\n  outcome: z.enum(WebhookEndpointProbeOutcome),\n  /** HTTP status returned by the endpoint. Absent for `UNREACHABLE` / `NOT_SENT`. */\n  responseStatus: z.number().int().optional(),\n  /** Truncated response body, to let an admin read the consumer's own error text. */\n  responseBodyTruncated: z.string().optional(),\n  /** Network / timeout / signing failure detail. Absent when the endpoint answered. */\n  failureReason: z.string().optional(),\n  durationMs: z.number().int().nonnegative(),\n  /**\n   * `jti` of the signed probe. Stated so an admin can correlate this attempt with\n   * the entry in their own consumer's logs — the same dedup key a real delivery\n   * carries.\n   */\n  signatureJti: z.string(),\n  attemptedAt: z.date(),\n});\n\n// =============================================================================\n// POLYMORPHIC FACTORY\n// =============================================================================\n\nexport const webhookConfigPolymorphicFactories = createPolymorphicResourceConfigurations(\n  webhookConfigPolymorphicDeclaration,\n  {\n    isSystemResource: true,\n    // Server-internal webhook delivery loads the (org/app) endpoint config via\n    // `readAsSystem`, independent of the triggering user's roles — the config\n    // governs runtime delivery behaviour, not user-facing data. READ-only.\n    systemAccessPolicy: { read: ResourceSystemAccessMode.ALLOWED },\n    customOperation: WebhookConfig_Operations,\n    coreOperations: [\n      CoreResourceOperation.READ,\n      CoreResourceOperation.CREATE,\n      CoreResourceOperation.UPDATE,\n      CoreResourceOperation.DELETE,\n    ],\n    operationsConfiguration: {\n      [CoreResourceOperation.READ]: {\n        variants: [\n          {\n            variantType: ResourceOperationVariantType.API_CALL,\n            isDefault: true,\n            polymorphicRole: {\n              [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_ADMIN],\n              [CoreResourceType.APPLICATION]: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n            },\n            riskLevel: ResourceOperationRiskLevel.LOW,\n          },\n        ],\n      },\n      [CoreResourceOperation.CREATE]: {\n        variants: [\n          {\n            variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n            isDefault: true,\n            polymorphicRole: {\n              [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_ADMIN],\n              [CoreResourceType.APPLICATION]: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n            },\n            riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          },\n        ],\n      },\n      [CoreResourceOperation.UPDATE]: {\n        variants: [\n          {\n            variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n            isDefault: true,\n            polymorphicRole: {\n              [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_ADMIN],\n              [CoreResourceType.APPLICATION]: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n            },\n            riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          },\n        ],\n      },\n      // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition\n      // onParentDelete cascade so this one-per-scope webhook-config row is physically\n      // removed when its owning org/app is deleted. Without a DELETE op the cascade\n      // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any scope with a\n      // config row. Admin tier (ORG_ADMIN / APP super-admin) / HIGH.\n      [CoreResourceOperation.DELETE]: {\n        variants: [\n          {\n            variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n            isDefault: true,\n            polymorphicRole: {\n              [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_ADMIN],\n              [CoreResourceType.APPLICATION]: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n            },\n            riskLevel: ResourceOperationRiskLevel.HIGH,\n          },\n        ],\n      },\n      [WebhookConfig_Operations.TEST_ENDPOINT]: {\n        variants: [\n          {\n            variantType: ResourceOperationVariantType.API_CALL,\n            isDefault: true,\n            polymorphicRole: {\n              [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_ADMIN],\n              [CoreResourceType.APPLICATION]: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n            },\n            riskLevel: ResourceOperationRiskLevel.MEDIUM,\n            // UPDATE-like, not READ-like — see the JSDoc on `TEST_ENDPOINT`. The\n            // operation writes nothing, but it emits a live outbound request.\n            resourceOperationLike: CoreResourceOperation.UPDATE,\n            requestDto: WebhookConfig_TestEndpointRequestDto,\n            // Implemented by `createWebhookConfigTestEndpointFactories()` in\n            // saas-backend-lib (REPLACE_CORE_OPERATIONS): the core write is\n            // replaced by the synthetic delivery, and this diagnostic — NOT the\n            // config row — is what the caller receives. Keep this contract in\n            // lockstep with that implementation.\n            customResponseDto: WebhookConfig_TestEndpointResponseDto,\n          },\n        ],\n      },\n    },\n  },\n);\n"]}

package/dist/esm/notifications/m2m/webhook-config.shared.schemas.d.ts

@@ -0,0 +1,134 @@
+/**
+ * M2M Webhook Config Schema (Shared) — Polymorphic dual-scope
+ *
+ * Configures outbound webhook delivery for M2M notifications fired by
+ * resource operations carrying a `WEBHOOK_ORGANIZATION` or
+ * `WEBHOOK_APPLICATION` channel in their spec. Holds:
+ *   - a master `enabled` switch
+ *   - an array of admin-managed endpoints (URL + description + per-endpoint enabled flag)
+ *   - a derived `applicationPublicKeyPem` (READ-only, populated by a
+ *     postfix hook from `JwtPrivateKeys.APPLICATION_WEBHOOK` so external
+ *     consumers can verify our JWT-signed deliveries)
+ *
+ * Scope FK (`organizationId` / `applicationId`) is injected by the
+ * polymorphism engine — NOT declared on the base schema.
+ *
+ * @see m2m-webhook-organization-delivery.md — Phase 2 / Step 3
+ * @see security/authentications/siem/siem-export-config.shared.schemas.ts
+ *   for the dual-scope polymorphic precedent this mirrors.
+ */
+import { z } from 'zod';
+import { type PolymorphicVariantDefinition } from '../../resources/utils/resource-polymorphism.schemas';
+/**
+ * Verdict of a single synthetic delivery fired by `webhookConfig.testEndpoint`.
+ * A probe that cannot fail is worse than no probe, so every terminal state an
+ * outbound attempt can reach is named here rather than collapsed into a boolean.
+ *
+ * The transport verdict and the HTTP status are deliberately SEPARATE axes:
+ * `REJECTED` still carries a response status, because "the endpoint answered 403"
+ * and "the endpoint never answered" are different problems with different fixes.
+ *
+ * Declared in this light schema module (not alongside the operation DTO) so the
+ * audit-event vocabulary can name the same enum without pulling the resource-config
+ * factory graph into `auditable-events.shared.schema.ts`.
+ */
+export declare enum WebhookEndpointProbeOutcome {
+    /**
+     * The endpoint answered with 2xx. This is the only outcome that evidences
+     * consumer-side signature verification: the platform cannot observe the
+     * consumer's verification step directly, so a 2xx from an endpoint that
+     * verifies before responding is the available proof.
+     */
+    ACCEPTED = "accepted",
+    /** The endpoint answered, but not with 2xx. Reachable; it refused or errored. */
+    REJECTED = "rejected",
+    /** No HTTP response at all — DNS/TLS/connection failure, or the attempt timed out. */
+    UNREACHABLE = "unreachable",
+    /**
+     * Nothing left the platform. The payload could not be signed, which is an
+     * operator-side key/configuration fault, not a statement about the endpoint.
+     * Reported distinctly so an admin never reads a local misconfiguration as a
+     * broken customer endpoint.
+     */
+    NOT_SENT = "not_sent"
+}
+/**
+ * The 2 M2M webhook scope variants — shared by `WebhookConfig` and
+ * `M2MWebhookDeliveryLog`. Centralised here so both polymorphic
+ * declarations stay in lock-step.
+ *
+ * Notes:
+ * - We deliberately define a domain-local constant (mirroring
+ *   `BILLING_SCOPE_VARIANTS` in the billing domain) instead of reusing
+ *   `AUTH_SCOPE_VARIANTS` from `authentications/`. The variant *shape*
+ *   is identical — `(ORGANIZATIONS, APPLICATION)` with `isPrimaryScope:
+ *   true` — but the auth constant is documented as "shared across all
+ *   AUTH polymorphic resources" and webhooks are notification resources,
+ *   not auth resources. Keeping a domain-local constant prevents the
+ *   semantic drift the framework-mindset rule warns about.
+ * - Both variants are primary scopes: there is no "child of an
+ *   organization unit" or "child of a user" variant — webhooks are a
+ *   tenant-level concern, not an entity-attached one.
+ */
+export declare const M2M_WEBHOOK_SCOPE_VARIANTS: PolymorphicVariantDefinition[];
+/**
+ * A single admin-configured webhook destination.
+ *
+ * v1 deliberately keeps endpoint config minimal (URL + description +
+ * enabled flag) — per user direction: "as a first implementation, we
+ * need just an url and a description, not more." Per-endpoint secrets
+ * are NOT used: signing happens with a single per-application JWT
+ * private key (`JwtPrivateKeys.APPLICATION_WEBHOOK`) and consumers
+ * verify with the matching public key surfaced via the parent config's
+ * derived `applicationPublicKeyPem` field.
+ */
+export declare const WebhookEndpointSchema: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodURL;
+    description: z.ZodDefault<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodDefault<z.ZodDate>;
+    updatedAt: z.ZodDefault<z.ZodDate>;
+}, z.core.$strip>;
+export type WebhookEndpoint = z.infer<typeof WebhookEndpointSchema>;
+export declare const WebhookConfigBaseSchema: z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    enabled: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodURL;
+        description: z.ZodDefault<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        createdAt: z.ZodDefault<z.ZodDate>;
+        updatedAt: z.ZodDefault<z.ZodDate>;
+    }, z.core.$strip>>>;
+    applicationPublicKeyPem: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+}, z.core.$strip>;
+export type WebhookConfigBase = z.infer<typeof WebhookConfigBaseSchema>;
+/**
+ * Yields two `CoreResourceType` variants:
+ *   - `organizationWebhookConfig` (FK: `organizationId`)
+ *   - `applicationWebhookConfig` (FK: `applicationId`)
+ *
+ * Both are singletons per scope (cardinality ONE) — wired in
+ * `resources-registry.shared.core.definitions.ts` via
+ * `createPolymorphicScopeRelationships(...)`.
+ */
+export declare const webhookConfigPolymorphicDeclaration: import("../..").PolymorphicSchemaDeclaration<z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    enabled: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodURL;
+        description: z.ZodDefault<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        createdAt: z.ZodDefault<z.ZodDate>;
+        updatedAt: z.ZodDefault<z.ZodDate>;
+    }, z.core.$strip>>>;
+    applicationPublicKeyPem: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=webhook-config.shared.schemas.d.ts.map

package/dist/esm/notifications/m2m/webhook-config.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/notifications/m2m/webhook-config.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,qDAAqD,CAAC;AAM7D;;;;;;;;;;;;GAYG;AACH,oBAAY,2BAA2B;IACrC;;;;;OAKG;IACH,QAAQ,aAAa;IACrB,iFAAiF;IACjF,QAAQ,aAAa;IACrB,sFAAsF;IACtF,WAAW,gBAAgB;IAC3B;;;;;OAKG;IACH,QAAQ,aAAa;CACtB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,EAAE,4BAA4B,EAWpE,CAAC;AAMF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;;;;;iBAWhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAqBlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE;;;;;;;;GAQG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;kBAM9C,CAAC"}

package/dist/esm/notifications/m2m/webhook-config.shared.schemas.js

@@ -0,0 +1,159 @@
+/**
+ * M2M Webhook Config Schema (Shared) — Polymorphic dual-scope
+ *
+ * Configures outbound webhook delivery for M2M notifications fired by
+ * resource operations carrying a `WEBHOOK_ORGANIZATION` or
+ * `WEBHOOK_APPLICATION` channel in their spec. Holds:
+ *   - a master `enabled` switch
+ *   - an array of admin-managed endpoints (URL + description + per-endpoint enabled flag)
+ *   - a derived `applicationPublicKeyPem` (READ-only, populated by a
+ *     postfix hook from `JwtPrivateKeys.APPLICATION_WEBHOOK` so external
+ *     consumers can verify our JWT-signed deliveries)
+ *
+ * Scope FK (`organizationId` / `applicationId`) is injected by the
+ * polymorphism engine — NOT declared on the base schema.
+ *
+ * @see m2m-webhook-organization-delivery.md — Phase 2 / Step 3
+ * @see security/authentications/siem/siem-export-config.shared.schemas.ts
+ *   for the dual-scope polymorphic precedent this mirrors.
+ */
+import { z } from 'zod';
+import { CoreResourceType, coreResourceShared_FieldIdentifier, } from '../../resources/resources.shared.core.definitions.js';
+import { declarePolymorphicSchemas, } from '../../resources/utils/resource-polymorphism.schemas.js';
+// =============================================================================
+// ENDPOINT PROBE VOCABULARY
+// =============================================================================
+/**
+ * Verdict of a single synthetic delivery fired by `webhookConfig.testEndpoint`.
+ * A probe that cannot fail is worse than no probe, so every terminal state an
+ * outbound attempt can reach is named here rather than collapsed into a boolean.
+ *
+ * The transport verdict and the HTTP status are deliberately SEPARATE axes:
+ * `REJECTED` still carries a response status, because "the endpoint answered 403"
+ * and "the endpoint never answered" are different problems with different fixes.
+ *
+ * Declared in this light schema module (not alongside the operation DTO) so the
+ * audit-event vocabulary can name the same enum without pulling the resource-config
+ * factory graph into `auditable-events.shared.schema.ts`.
+ */
+export var WebhookEndpointProbeOutcome;
+(function (WebhookEndpointProbeOutcome) {
+    /**
+     * The endpoint answered with 2xx. This is the only outcome that evidences
+     * consumer-side signature verification: the platform cannot observe the
+     * consumer's verification step directly, so a 2xx from an endpoint that
+     * verifies before responding is the available proof.
+     */
+    WebhookEndpointProbeOutcome["ACCEPTED"] = "accepted";
+    /** The endpoint answered, but not with 2xx. Reachable; it refused or errored. */
+    WebhookEndpointProbeOutcome["REJECTED"] = "rejected";
+    /** No HTTP response at all — DNS/TLS/connection failure, or the attempt timed out. */
+    WebhookEndpointProbeOutcome["UNREACHABLE"] = "unreachable";
+    /**
+     * Nothing left the platform. The payload could not be signed, which is an
+     * operator-side key/configuration fault, not a statement about the endpoint.
+     * Reported distinctly so an admin never reads a local misconfiguration as a
+     * broken customer endpoint.
+     */
+    WebhookEndpointProbeOutcome["NOT_SENT"] = "not_sent";
+})(WebhookEndpointProbeOutcome || (WebhookEndpointProbeOutcome = {}));
+// =============================================================================
+// SHARED VARIANT DEFINITIONS
+// =============================================================================
+/**
+ * The 2 M2M webhook scope variants — shared by `WebhookConfig` and
+ * `M2MWebhookDeliveryLog`. Centralised here so both polymorphic
+ * declarations stay in lock-step.
+ *
+ * Notes:
+ * - We deliberately define a domain-local constant (mirroring
+ *   `BILLING_SCOPE_VARIANTS` in the billing domain) instead of reusing
+ *   `AUTH_SCOPE_VARIANTS` from `authentications/`. The variant *shape*
+ *   is identical — `(ORGANIZATIONS, APPLICATION)` with `isPrimaryScope:
+ *   true` — but the auth constant is documented as "shared across all
+ *   AUTH polymorphic resources" and webhooks are notification resources,
+ *   not auth resources. Keeping a domain-local constant prevents the
+ *   semantic drift the framework-mindset rule warns about.
+ * - Both variants are primary scopes: there is no "child of an
+ *   organization unit" or "child of a user" variant — webhooks are a
+ *   tenant-level concern, not an entity-attached one.
+ */
+export const M2M_WEBHOOK_SCOPE_VARIANTS = [
+    {
+        parentResourceType: CoreResourceType.ORGANIZATIONS,
+        parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS],
+        isPrimaryScope: true,
+    },
+    {
+        parentResourceType: CoreResourceType.APPLICATION,
+        parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION],
+        isPrimaryScope: true,
+    },
+];
+// =============================================================================
+// ENDPOINT SUB-SCHEMA
+// =============================================================================
+/**
+ * A single admin-configured webhook destination.
+ *
+ * v1 deliberately keeps endpoint config minimal (URL + description +
+ * enabled flag) — per user direction: "as a first implementation, we
+ * need just an url and a description, not more." Per-endpoint secrets
+ * are NOT used: signing happens with a single per-application JWT
+ * private key (`JwtPrivateKeys.APPLICATION_WEBHOOK`) and consumers
+ * verify with the matching public key surfaced via the parent config's
+ * derived `applicationPublicKeyPem` field.
+ */
+export const WebhookEndpointSchema = z.object({
+    /** Stable per-endpoint identifier (ULID). Used as the `endpointId` FK on every delivery log row. */
+    id: z.string().min(1),
+    /** Destination URL receiving POST deliveries. */
+    url: z.url(),
+    /** Free-form admin label (visible in the management UI). */
+    description: z.string().max(500).default(''),
+    /** Per-endpoint master switch — disabled endpoints are skipped by the dispatcher. */
+    enabled: z.boolean().default(true),
+    createdAt: z.date().default(() => new Date()),
+    updatedAt: z.date().default(() => new Date()),
+});
+// =============================================================================
+// BASE CONFIG SCHEMA (polymorphism injects the scope FK at variant time)
+// =============================================================================
+export const WebhookConfigBaseSchema = z.object({
+    _id: z.string().min(1).isPrimaryKey().isSummaryField(),
+    /** Master kill-switch — when `false`, the dispatcher short-circuits with no deliveries. */
+    enabled: z.boolean().default(false).isSummaryField(),
+    /** Admin-managed list of destinations. Empty array = no deliveries even when `enabled: true`. */
+    endpoints: z.array(WebhookEndpointSchema).default([]),
+    /**
+     * Derived field — populated by `postfixCoreOperations[READ]` from
+     * `appConfig.jwtConfig.config.publicKey[JwtPrivateKeys.APPLICATION_WEBHOOK]`.
+     * Excluded from CREATE/UPDATE so clients cannot set it; the value is
+     * regenerated on every read from the canonical app config so key
+     * rotation is reflected immediately. Phase 3 wires the postfix hook
+     * (Step 9 of the plan).
+     */
+    applicationPublicKeyPem: z.string().optional().excludeFromCreate().excludeFromUpdate(),
+    createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+    updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+});
+// =============================================================================
+// POLYMORPHIC DECLARATION
+// =============================================================================
+/**
+ * Yields two `CoreResourceType` variants:
+ *   - `organizationWebhookConfig` (FK: `organizationId`)
+ *   - `applicationWebhookConfig` (FK: `applicationId`)
+ *
+ * Both are singletons per scope (cardinality ONE) — wired in
+ * `resources-registry.shared.core.definitions.ts` via
+ * `createPolymorphicScopeRelationships(...)`.
+ */
+export const webhookConfigPolymorphicDeclaration = declarePolymorphicSchemas({
+    baseResourceType: 'webhookConfig',
+    baseFieldIdentifier: 'webhookConfigId',
+    baseEnumKey: 'WEBHOOK_CONFIG',
+    baseSchema: WebhookConfigBaseSchema,
+    variants: M2M_WEBHOOK_SCOPE_VARIANTS,
+});
+//# sourceMappingURL=webhook-config.shared.schemas.js.map

package/dist/esm/notifications/m2m/webhook-config.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-config.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/notifications/m2m/webhook-config.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * M2M Webhook Config Schema (Shared) — Polymorphic dual-scope\n *\n * Configures outbound webhook delivery for M2M notifications fired by\n * resource operations carrying a `WEBHOOK_ORGANIZATION` or\n * `WEBHOOK_APPLICATION` channel in their spec. Holds:\n *   - a master `enabled` switch\n *   - an array of admin-managed endpoints (URL + description + per-endpoint enabled flag)\n *   - a derived `applicationPublicKeyPem` (READ-only, populated by a\n *     postfix hook from `JwtPrivateKeys.APPLICATION_WEBHOOK` so external\n *     consumers can verify our JWT-signed deliveries)\n *\n * Scope FK (`organizationId` / `applicationId`) is injected by the\n * polymorphism engine — NOT declared on the base schema.\n *\n * @see m2m-webhook-organization-delivery.md — Phase 2 / Step 3\n * @see security/authentications/siem/siem-export-config.shared.schemas.ts\n *   for the dual-scope polymorphic precedent this mirrors.\n */\n\nimport { z } from 'zod';\nimport {\n  CoreResourceType,\n  coreResourceShared_FieldIdentifier,\n} from '../../resources/resources.shared.core.definitions';\nimport {\n  declarePolymorphicSchemas,\n  type PolymorphicVariantDefinition,\n} from '../../resources/utils/resource-polymorphism.schemas';\n\n// =============================================================================\n// ENDPOINT PROBE VOCABULARY\n// =============================================================================\n\n/**\n * Verdict of a single synthetic delivery fired by `webhookConfig.testEndpoint`.\n * A probe that cannot fail is worse than no probe, so every terminal state an\n * outbound attempt can reach is named here rather than collapsed into a boolean.\n *\n * The transport verdict and the HTTP status are deliberately SEPARATE axes:\n * `REJECTED` still carries a response status, because \"the endpoint answered 403\"\n * and \"the endpoint never answered\" are different problems with different fixes.\n *\n * Declared in this light schema module (not alongside the operation DTO) so the\n * audit-event vocabulary can name the same enum without pulling the resource-config\n * factory graph into `auditable-events.shared.schema.ts`.\n */\nexport enum WebhookEndpointProbeOutcome {\n  /**\n   * The endpoint answered with 2xx. This is the only outcome that evidences\n   * consumer-side signature verification: the platform cannot observe the\n   * consumer's verification step directly, so a 2xx from an endpoint that\n   * verifies before responding is the available proof.\n   */\n  ACCEPTED = 'accepted',\n  /** The endpoint answered, but not with 2xx. Reachable; it refused or errored. */\n  REJECTED = 'rejected',\n  /** No HTTP response at all — DNS/TLS/connection failure, or the attempt timed out. */\n  UNREACHABLE = 'unreachable',\n  /**\n   * Nothing left the platform. The payload could not be signed, which is an\n   * operator-side key/configuration fault, not a statement about the endpoint.\n   * Reported distinctly so an admin never reads a local misconfiguration as a\n   * broken customer endpoint.\n   */\n  NOT_SENT = 'not_sent',\n}\n\n// =============================================================================\n// SHARED VARIANT DEFINITIONS\n// =============================================================================\n\n/**\n * The 2 M2M webhook scope variants — shared by `WebhookConfig` and\n * `M2MWebhookDeliveryLog`. Centralised here so both polymorphic\n * declarations stay in lock-step.\n *\n * Notes:\n * - We deliberately define a domain-local constant (mirroring\n *   `BILLING_SCOPE_VARIANTS` in the billing domain) instead of reusing\n *   `AUTH_SCOPE_VARIANTS` from `authentications/`. The variant *shape*\n *   is identical — `(ORGANIZATIONS, APPLICATION)` with `isPrimaryScope:\n *   true` — but the auth constant is documented as \"shared across all\n *   AUTH polymorphic resources\" and webhooks are notification resources,\n *   not auth resources. Keeping a domain-local constant prevents the\n *   semantic drift the framework-mindset rule warns about.\n * - Both variants are primary scopes: there is no \"child of an\n *   organization unit\" or \"child of a user\" variant — webhooks are a\n *   tenant-level concern, not an entity-attached one.\n */\nexport const M2M_WEBHOOK_SCOPE_VARIANTS: PolymorphicVariantDefinition[] = [\n  {\n    parentResourceType: CoreResourceType.ORGANIZATIONS,\n    parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS],\n    isPrimaryScope: true,\n  },\n  {\n    parentResourceType: CoreResourceType.APPLICATION,\n    parentFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION],\n    isPrimaryScope: true,\n  },\n];\n\n// =============================================================================\n// ENDPOINT SUB-SCHEMA\n// =============================================================================\n\n/**\n * A single admin-configured webhook destination.\n *\n * v1 deliberately keeps endpoint config minimal (URL + description +\n * enabled flag) — per user direction: \"as a first implementation, we\n * need just an url and a description, not more.\" Per-endpoint secrets\n * are NOT used: signing happens with a single per-application JWT\n * private key (`JwtPrivateKeys.APPLICATION_WEBHOOK`) and consumers\n * verify with the matching public key surfaced via the parent config's\n * derived `applicationPublicKeyPem` field.\n */\nexport const WebhookEndpointSchema = z.object({\n  /** Stable per-endpoint identifier (ULID). Used as the `endpointId` FK on every delivery log row. */\n  id: z.string().min(1),\n  /** Destination URL receiving POST deliveries. */\n  url: z.url(),\n  /** Free-form admin label (visible in the management UI). */\n  description: z.string().max(500).default(''),\n  /** Per-endpoint master switch — disabled endpoints are skipped by the dispatcher. */\n  enabled: z.boolean().default(true),\n  createdAt: z.date().default(() => new Date()),\n  updatedAt: z.date().default(() => new Date()),\n});\n\nexport type WebhookEndpoint = z.infer<typeof WebhookEndpointSchema>;\n\n// =============================================================================\n// BASE CONFIG SCHEMA (polymorphism injects the scope FK at variant time)\n// =============================================================================\n\nexport const WebhookConfigBaseSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /** Master kill-switch — when `false`, the dispatcher short-circuits with no deliveries. */\n  enabled: z.boolean().default(false).isSummaryField(),\n\n  /** Admin-managed list of destinations. Empty array = no deliveries even when `enabled: true`. */\n  endpoints: z.array(WebhookEndpointSchema).default([]),\n\n  /**\n   * Derived field — populated by `postfixCoreOperations[READ]` from\n   * `appConfig.jwtConfig.config.publicKey[JwtPrivateKeys.APPLICATION_WEBHOOK]`.\n   * Excluded from CREATE/UPDATE so clients cannot set it; the value is\n   * regenerated on every read from the canonical app config so key\n   * rotation is reflected immediately. Phase 3 wires the postfix hook\n   * (Step 9 of the plan).\n   */\n  applicationPublicKeyPem: z.string().optional().excludeFromCreate().excludeFromUpdate(),\n\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\n\nexport type WebhookConfigBase = z.infer<typeof WebhookConfigBaseSchema>;\n\n// =============================================================================\n// POLYMORPHIC DECLARATION\n// =============================================================================\n\n/**\n * Yields two `CoreResourceType` variants:\n *   - `organizationWebhookConfig` (FK: `organizationId`)\n *   - `applicationWebhookConfig` (FK: `applicationId`)\n *\n * Both are singletons per scope (cardinality ONE) — wired in\n * `resources-registry.shared.core.definitions.ts` via\n * `createPolymorphicScopeRelationships(...)`.\n */\nexport const webhookConfigPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'webhookConfig',\n  baseFieldIdentifier: 'webhookConfigId',\n  baseEnumKey: 'WEBHOOK_CONFIG',\n  baseSchema: WebhookConfigBaseSchema,\n  variants: M2M_WEBHOOK_SCOPE_VARIANTS,\n});\n"]}

package/dist/esm/notifications/notification-badges.core.definitions.d.ts

@@ -1,3 +1,12 @@
-import { NotificationBadgeDefinition } from "./notification-badges.schemas.js";
+import { NotificationBadgeDefinition } from "./notification-badges.schemas";
+/**
+ * Canonical (framework-shipped) notification badge definitions.
+ *
+ * Intentionally empty: the two aspirational placeholders (`new messages` /
+ * `unpaid invoices`) were removed because nothing produced them and the launcher
+ * surfacing was retracted (see `.claude/plans/badge-launcher-retract.md`). Real
+ * definitions return with their producer per the Reintroduction Contract (R1),
+ * carrying a typed `source` (EVENT_COUNTER | DERIVED_QUERY) + `display`.
+ */
 export declare const coreNotificationBadgeDefinitions: NotificationBadgeDefinition[];
 //# sourceMappingURL=notification-badges.core.definitions.d.ts.map

package/dist/esm/notifications/notification-badges.core.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-badges.core.definitions.d.ts","sourceRoot":"","sources":["../../../src/notifications/notification-badges.core.definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAoC,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE9G,eAAO,MAAM,gCAAgC,EAAG,2BAA2B,EAS1E,CAAA"}
+{"version":3,"file":"notification-badges.core.definitions.d.ts","sourceRoot":"","sources":["../../../../src/notifications/notification-badges.core.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,EAAE,2BAA2B,EAAO,CAAC"}

package/dist/esm/notifications/notification-badges.core.definitions.js

@@ -1,13 +1,11 @@
-import { ResourcePrimaryScope } from "../resources/resources.shared.schemas.js";
-import { CoreNotificationBadgeIdentifiers } from "./notification-badges.schemas.js";
-export const coreNotificationBadgeDefinitions = [
-    {
-        identifier: CoreNotificationBadgeIdentifiers.USER_SELF_NEW_MESSAGES,
-        scope: ResourcePrimaryScope.USER_SELF,
-    },
-    {
-        identifier: CoreNotificationBadgeIdentifiers.ORGANIZATION_UNPAID_INVOICES,
-        scope: ResourcePrimaryScope.ORGANIZATIONS,
-    },
-];
-//# sourceMappingURL=notification-badges.core.definitions.js.map
+/**
+ * Canonical (framework-shipped) notification badge definitions.
+ *
+ * Intentionally empty: the two aspirational placeholders (`new messages` /
+ * `unpaid invoices`) were removed because nothing produced them and the launcher
+ * surfacing was retracted (see `.claude/plans/badge-launcher-retract.md`). Real
+ * definitions return with their producer per the Reintroduction Contract (R1),
+ * carrying a typed `source` (EVENT_COUNTER | DERIVED_QUERY) + `display`.
+ */
+export const coreNotificationBadgeDefinitions = [];
+//# sourceMappingURL=notification-badges.core.definitions.js.map

package/dist/esm/notifications/notification-badges.core.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-badges.core.definitions.js","sourceRoot":"","sources":["../../../src/notifications/notification-badges.core.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gCAAgC,EAA+B,MAAM,+BAA+B,CAAC;AAE9G,MAAM,CAAC,MAAM,gCAAgC,GAAmC;IAC5E;QACI,UAAU,EAAE,gCAAgC,CAAC,sBAAsB;QACnE,KAAK,EAAE,oBAAoB,CAAC,SAAS;KACxC;IACD;QACI,UAAU,EAAE,gCAAgC,CAAC,4BAA4B;QACzE,KAAK,EAAE,oBAAoB,CAAC,aAAa;KAC5C;CACJ,CAAA"}
+{"version":3,"file":"notification-badges.core.definitions.js","sourceRoot":"","sources":["../../../../src/notifications/notification-badges.core.definitions.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAkC,EAAE,CAAC","sourcesContent":["import { NotificationBadgeDefinition } from \"./notification-badges.schemas\";\n\n/**\n * Canonical (framework-shipped) notification badge definitions.\n *\n * Intentionally empty: the two aspirational placeholders (`new messages` /\n * `unpaid invoices`) were removed because nothing produced them and the launcher\n * surfacing was retracted (see `.claude/plans/badge-launcher-retract.md`). Real\n * definitions return with their producer per the Reintroduction Contract (R1),\n * carrying a typed `source` (EVENT_COUNTER | DERIVED_QUERY) + `display`.\n */\nexport const coreNotificationBadgeDefinitions: NotificationBadgeDefinition[] = [];\n"]}