@dudousxd/nestjs-notifications-preferences 0.2.0

package/dist/in-memory.store.d.ts

@@ -0,0 +1,13 @@
+import type { PreferenceKey, PreferenceScope, PreferenceStore } from './interfaces';
+/**
+ * In-memory {@link PreferenceStore} for tests and prototyping. Holds the set of muted
+ * (tenant, notifiable, channel) tuples. Not for production — state is lost on restart.
+ */
+export declare class InMemoryPreferenceStore implements PreferenceStore {
+    private readonly muted;
+    isMuted(key: PreferenceKey): Promise<boolean>;
+    mute(key: PreferenceKey): Promise<void>;
+    unmute(key: PreferenceKey): Promise<void>;
+    mutedChannels(scope: PreferenceScope): Promise<string[]>;
+}
+//# sourceMappingURL=in-memory.store.d.ts.map

package/dist/in-memory.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.store.d.ts","sourceRoot":"","sources":["../src/in-memory.store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpF;;;GAGG;AACH,qBACa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAErC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAa/D"}

package/dist/in-memory.store.js

@@ -0,0 +1,48 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryPreferenceStore = void 0;
+const common_1 = require("@nestjs/common");
+/** Serialize a key to a stable string for set membership. */
+function serialize(key) {
+    return JSON.stringify([key.tenant ?? null, key.notifiableType, key.notifiableId, key.channel]);
+}
+/**
+ * In-memory {@link PreferenceStore} for tests and prototyping. Holds the set of muted
+ * (tenant, notifiable, channel) tuples. Not for production — state is lost on restart.
+ */
+let InMemoryPreferenceStore = class InMemoryPreferenceStore {
+    muted = new Set();
+    async isMuted(key) {
+        return this.muted.has(serialize(key));
+    }
+    async mute(key) {
+        this.muted.add(serialize(key));
+    }
+    async unmute(key) {
+        this.muted.delete(serialize(key));
+    }
+    async mutedChannels(scope) {
+        const prefix = JSON.stringify([scope.tenant ?? null, scope.notifiableType, scope.notifiableId]);
+        // Each stored entry is [tenant, type, id, channel]; reuse the 3-element prefix.
+        const head = prefix.slice(0, -1); // drop the closing ']'
+        const channels = [];
+        for (const entry of this.muted) {
+            if (entry.startsWith(`${head},`)) {
+                const [, , , channel] = JSON.parse(entry);
+                channels.push(channel);
+            }
+        }
+        return channels;
+    }
+};
+exports.InMemoryPreferenceStore = InMemoryPreferenceStore;
+exports.InMemoryPreferenceStore = InMemoryPreferenceStore = __decorate([
+    (0, common_1.Injectable)()
+], InMemoryPreferenceStore);
+//# sourceMappingURL=in-memory.store.js.map

package/dist/in-memory.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.store.js","sourceRoot":"","sources":["../src/in-memory.store.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAG5C,6DAA6D;AAC7D,SAAS,SAAS,CAAC,GAAkB;IACnC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACjG,CAAC;AAED;;;GAGG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IACjB,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAkB;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAkB;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAsB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QAChG,gFAAgF;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;QACzD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;gBACjC,MAAM,CAAC,EAAE,AAAD,EAAG,AAAD,EAAG,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA4C,CAAC;gBACrF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAA;AA5BY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;GACA,uBAAuB,CA4BnC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { PreferenceKey, PreferenceScope, PreferenceStore } from './interfaces';
+export { NOTIFICATION_PREFERENCE_STORE } from './tokens';
+export { InMemoryPreferenceStore } from './in-memory.store';
+export { NotificationPreferences, type PreferenceTarget, type ScopedPreferences, } from './notification-preferences';
+export { PreferenceGateAdapter } from './preference-gate.adapter';
+export { PreferencesModule, type PreferencesModuleOptions, } from './preferences.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferencesModule = exports.PreferenceGateAdapter = exports.NotificationPreferences = exports.InMemoryPreferenceStore = exports.NOTIFICATION_PREFERENCE_STORE = void 0;
+var tokens_1 = require("./tokens");
+Object.defineProperty(exports, "NOTIFICATION_PREFERENCE_STORE", { enumerable: true, get: function () { return tokens_1.NOTIFICATION_PREFERENCE_STORE; } });
+var in_memory_store_1 = require("./in-memory.store");
+Object.defineProperty(exports, "InMemoryPreferenceStore", { enumerable: true, get: function () { return in_memory_store_1.InMemoryPreferenceStore; } });
+var notification_preferences_1 = require("./notification-preferences");
+Object.defineProperty(exports, "NotificationPreferences", { enumerable: true, get: function () { return notification_preferences_1.NotificationPreferences; } });
+var preference_gate_adapter_1 = require("./preference-gate.adapter");
+Object.defineProperty(exports, "PreferenceGateAdapter", { enumerable: true, get: function () { return preference_gate_adapter_1.PreferenceGateAdapter; } });
+var preferences_module_1 = require("./preferences.module");
+Object.defineProperty(exports, "PreferencesModule", { enumerable: true, get: function () { return preferences_module_1.PreferencesModule; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,mCAAyD;AAAhD,uHAAA,6BAA6B,OAAA;AACtC,qDAA4D;AAAnD,0HAAA,uBAAuB,OAAA;AAChC,uEAIoC;AAHlC,mIAAA,uBAAuB,OAAA;AAIzB,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAC9B,2DAG8B;AAF5B,uHAAA,iBAAiB,OAAA"}

package/dist/interfaces.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A fully-qualified preference entry: which channel is muted for which notifiable, optionally
+ * scoped to a tenant. Used by the {@link PreferenceStore}.
+ */
+export interface PreferenceKey {
+    /** Tenant scope; undefined in single-tenant apps. */
+    tenant?: string;
+    /** The notifiable's morph type (e.g. the class name or `@Notifiable({ type })`). */
+    notifiableType: string;
+    /** The notifiable's id, stringified. */
+    notifiableId: string;
+    /** The channel name (e.g. `mail`, `sms`). */
+    channel: string;
+}
+/** A notifiable+tenant scope without a specific channel — used to list muted channels. */
+export interface PreferenceScope {
+    tenant?: string;
+    notifiableType: string;
+    notifiableId: string;
+}
+/**
+ * Persistence for channel preferences. Models an **opt-out** policy: a channel is allowed
+ * unless it has been explicitly muted. Implement this against your datastore, or use the
+ * bundled {@link InMemoryPreferenceStore}.
+ */
+export interface PreferenceStore {
+    /** Whether `key.channel` is currently muted for the given notifiable (and tenant). */
+    isMuted(key: PreferenceKey): Promise<boolean>;
+    /** Mute a channel for a notifiable (and tenant). Idempotent. */
+    mute(key: PreferenceKey): Promise<void>;
+    /** Un-mute a previously muted channel. Idempotent. */
+    unmute(key: PreferenceKey): Promise<void>;
+    /** List all channels currently muted for the notifiable within the scope. */
+    mutedChannels(scope: PreferenceScope): Promise<string[]>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,gEAAgE;IAChE,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,sDAAsD;IACtD,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,6EAA6E;IAC7E,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1D"}

package/dist/interfaces.js

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

package/dist/interfaces.js.map

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

package/dist/notification-preferences.d.ts

@@ -0,0 +1,39 @@
+import { type Notifiable, type NotifiableRef } from '@dudousxd/nestjs-notifications-core';
+import type { PreferenceStore } from './interfaces';
+/** A notifiable instance or a pre-built reference to one. */
+export type PreferenceTarget = Notifiable | NotifiableRef;
+/**
+ * The set of preference operations, optionally pre-scoped to a tenant. Returned both directly by
+ * {@link NotificationPreferences} (tenant undefined) and by {@link NotificationPreferences.forTenant}.
+ */
+export interface ScopedPreferences {
+    /** Mute a channel for the target. */
+    mute(target: PreferenceTarget, channel: string): Promise<void>;
+    /** Un-mute a channel for the target. */
+    unmute(target: PreferenceTarget, channel: string): Promise<void>;
+    /** Whether the channel is muted for the target. */
+    isMuted(target: PreferenceTarget, channel: string): Promise<boolean>;
+    /** List the channels currently muted for the target. */
+    muted(target: PreferenceTarget): Promise<string[]>;
+}
+/**
+ * Ergonomic façade over a {@link PreferenceStore}. Accepts a {@link Notifiable} (deriving its
+ * reference via the core `notifiableRef`) or a {@link NotifiableRef} directly.
+ *
+ * ```ts
+ * await prefs.mute(user, 'mail');
+ * await prefs.forTenant('acme').mute(user, 'sms');
+ * ```
+ */
+export declare class NotificationPreferences implements ScopedPreferences {
+    private readonly store;
+    constructor(store: PreferenceStore);
+    mute(target: PreferenceTarget, channel: string): Promise<void>;
+    unmute(target: PreferenceTarget, channel: string): Promise<void>;
+    isMuted(target: PreferenceTarget, channel: string): Promise<boolean>;
+    muted(target: PreferenceTarget): Promise<string[]>;
+    /** Return the same operations scoped to a tenant (every key carries `tenant`). */
+    forTenant(tenant: string): ScopedPreferences;
+    private scoped;
+}
+//# sourceMappingURL=notification-preferences.d.ts.map

package/dist/notification-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-preferences.d.ts","sourceRoot":"","sources":["../src/notification-preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAEnB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,aAAa,CAAC;AAkB1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,wCAAwC;IACxC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,mDAAmD;IACnD,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,wDAAwD;IACxD,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,qBACa,uBAAwB,YAAW,iBAAiB;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE1F,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIlD,kFAAkF;IAClF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAI5C,OAAO,CAAC,MAAM;CASf"}

package/dist/notification-preferences.js

@@ -0,0 +1,77 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationPreferences = void 0;
+const nestjs_notifications_core_1 = require("@dudousxd/nestjs-notifications-core");
+const common_1 = require("@nestjs/common");
+const tokens_1 = require("./tokens");
+/** Discriminate a {@link NotifiableRef} from a full {@link Notifiable}. */
+function isRef(target) {
+    return (typeof target.type === 'string' &&
+        target.id !== undefined &&
+        typeof target.routeNotificationFor !== 'function' &&
+        typeof target.toNotifiableRef !== 'function');
+}
+/** Normalize either input into a `{ notifiableType, notifiableId }` pair. */
+function resolve(target) {
+    const ref = isRef(target) ? target : (0, nestjs_notifications_core_1.notifiableRef)(target);
+    return { notifiableType: ref.type, notifiableId: String(ref.id) };
+}
+/**
+ * Ergonomic façade over a {@link PreferenceStore}. Accepts a {@link Notifiable} (deriving its
+ * reference via the core `notifiableRef`) or a {@link NotifiableRef} directly.
+ *
+ * ```ts
+ * await prefs.mute(user, 'mail');
+ * await prefs.forTenant('acme').mute(user, 'sms');
+ * ```
+ */
+let NotificationPreferences = class NotificationPreferences {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    mute(target, channel) {
+        return this.scoped(undefined).mute(target, channel);
+    }
+    unmute(target, channel) {
+        return this.scoped(undefined).unmute(target, channel);
+    }
+    isMuted(target, channel) {
+        return this.scoped(undefined).isMuted(target, channel);
+    }
+    muted(target) {
+        return this.scoped(undefined).muted(target);
+    }
+    /** Return the same operations scoped to a tenant (every key carries `tenant`). */
+    forTenant(tenant) {
+        return this.scoped(tenant);
+    }
+    scoped(tenant) {
+        const store = this.store;
+        return {
+            mute: (target, channel) => store.mute({ tenant, ...resolve(target), channel }),
+            unmute: (target, channel) => store.unmute({ tenant, ...resolve(target), channel }),
+            isMuted: (target, channel) => store.isMuted({ tenant, ...resolve(target), channel }),
+            muted: (target) => store.mutedChannels({ tenant, ...resolve(target) }),
+        };
+    }
+};
+exports.NotificationPreferences = NotificationPreferences;
+exports.NotificationPreferences = NotificationPreferences = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.NOTIFICATION_PREFERENCE_STORE)),
+    __metadata("design:paramtypes", [Object])
+], NotificationPreferences);
+//# sourceMappingURL=notification-preferences.js.map

package/dist/notification-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-preferences.js","sourceRoot":"","sources":["../src/notification-preferences.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,mFAI6C;AAC7C,2CAAoD;AAEpD,qCAAyD;AAKzD,2EAA2E;AAC3E,SAAS,KAAK,CAAC,MAAwB;IACrC,OAAO,CACL,OAAQ,MAAwB,CAAC,IAAI,KAAK,QAAQ;QACjD,MAAwB,CAAC,EAAE,KAAK,SAAS;QAC1C,OAAQ,MAAqB,CAAC,oBAAoB,KAAK,UAAU;QACjE,OAAQ,MAAqB,CAAC,eAAe,KAAK,UAAU,CAC7D,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,OAAO,CAAC,MAAwB;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAwB,CAAC,CAAC,CAAC,IAAA,yCAAa,EAAC,MAAoB,CAAC,CAAC;IAC5F,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAiBD;;;;;;;;GAQG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IACkC;IAApE,YAAoE,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAE9F,IAAI,CAAC,MAAwB,EAAE,OAAe;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,MAAwB,EAAE,OAAe;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,MAAwB,EAAE,OAAe;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAwB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,kFAAkF;IAClF,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,MAA0B;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;YAC9E,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;YAClF,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;YACpF,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;SACvE,CAAC;IACJ,CAAC;CACF,CAAA;AAjCY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;IAEE,WAAA,IAAA,eAAM,EAAC,sCAA6B,CAAC,CAAA;;GADvC,uBAAuB,CAiCnC"}

package/dist/preference-gate.adapter.d.ts

@@ -0,0 +1,13 @@
+import { type ChannelGateContext, type PreferenceGate } from '@dudousxd/nestjs-notifications-core';
+import type { PreferenceStore } from './interfaces';
+/**
+ * Core {@link PreferenceGate} backed by a {@link PreferenceStore}. Bound to the core
+ * `NOTIFICATION_PREFERENCE_GATE` token by {@link PreferencesModule} so the ChannelRunner
+ * consults it before every delivery. Opt-out: a channel is allowed unless explicitly muted.
+ */
+export declare class PreferenceGateAdapter implements PreferenceGate {
+    private readonly store;
+    constructor(store: PreferenceStore);
+    isAllowed({ notifiable, channel, tenant }: ChannelGateContext): Promise<boolean>;
+}
+//# sourceMappingURL=preference-gate.adapter.d.ts.map

package/dist/preference-gate.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-gate.adapter.d.ts","sourceRoot":"","sources":["../src/preference-gate.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAEpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD;;;;GAIG;AACH,qBACa,qBAAsB,YAAW,cAAc;IACP,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAEpF,SAAS,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;CAevF"}

package/dist/preference-gate.adapter.js

@@ -0,0 +1,52 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferenceGateAdapter = void 0;
+const nestjs_notifications_core_1 = require("@dudousxd/nestjs-notifications-core");
+const common_1 = require("@nestjs/common");
+const tokens_1 = require("./tokens");
+/**
+ * Core {@link PreferenceGate} backed by a {@link PreferenceStore}. Bound to the core
+ * `NOTIFICATION_PREFERENCE_GATE` token by {@link PreferencesModule} so the ChannelRunner
+ * consults it before every delivery. Opt-out: a channel is allowed unless explicitly muted.
+ */
+let PreferenceGateAdapter = class PreferenceGateAdapter {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async isAllowed({ notifiable, channel, tenant }) {
+        let ref;
+        try {
+            ref = (0, nestjs_notifications_core_1.notifiableRef)(notifiable);
+        }
+        catch {
+            // No stable reference (e.g. an anonymous notifiable) — nothing to mute against; allow.
+            return true;
+        }
+        return !(await this.store.isMuted({
+            tenant,
+            notifiableType: ref.type,
+            notifiableId: String(ref.id),
+            channel,
+        }));
+    }
+};
+exports.PreferenceGateAdapter = PreferenceGateAdapter;
+exports.PreferenceGateAdapter = PreferenceGateAdapter = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(tokens_1.NOTIFICATION_PREFERENCE_STORE)),
+    __metadata("design:paramtypes", [Object])
+], PreferenceGateAdapter);
+//# sourceMappingURL=preference-gate.adapter.js.map

package/dist/preference-gate.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-gate.adapter.js","sourceRoot":"","sources":["../src/preference-gate.adapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,mFAI6C;AAC7C,2CAAoD;AAEpD,qCAAyD;AAEzD;;;;GAIG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACoC;IAApE,YAAoE,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAE9F,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAsB;QACjE,IAAI,GAA0C,CAAC;QAC/C,IAAI,CAAC;YACH,GAAG,GAAG,IAAA,yCAAa,EAAC,UAAU,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,uFAAuF;YACvF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAChC,MAAM;YACN,cAAc,EAAE,GAAG,CAAC,IAAI;YACxB,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO;SACR,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAA;AAlBY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAEE,WAAA,IAAA,eAAM,EAAC,sCAA6B,CAAC,CAAA;;GADvC,qBAAqB,CAkBjC"}

package/dist/preferences.module.d.ts

@@ -0,0 +1,22 @@
+import { type DynamicModule, type Type } from '@nestjs/common';
+import type { PreferenceStore } from './interfaces';
+/** Options for {@link PreferencesModule.forRoot}. */
+export interface PreferencesModuleOptions {
+    /** A {@link PreferenceStore} class to instantiate; defaults to {@link InMemoryPreferenceStore}. */
+    store?: Type<PreferenceStore>;
+    /** Register globally so the preferences service and gate are available app-wide. Default true. */
+    global?: boolean;
+}
+/**
+ * Registers channel preferences. Binds the core `NOTIFICATION_PREFERENCE_GATE` token to a
+ * store-backed gate so the ChannelRunner automatically skips muted channels.
+ *
+ * ```ts
+ * PreferencesModule.forRoot()                          // in-memory store
+ * PreferencesModule.forRoot({ store: PrismaPrefStore }) // your store
+ * ```
+ */
+export declare class PreferencesModule {
+    static forRoot(options?: PreferencesModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=preferences.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.module.d.ts","sourceRoot":"","sources":["../src/preferences.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAyB,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,qDAAqD;AACrD,MAAM,WAAW,wBAAwB;IACvC,mGAAmG;IACnG,KAAK,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9B,kGAAkG;IAClG,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBACa,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,wBAA6B,GAAG,aAAa;CAgBtE"}

package/dist/preferences.module.js

@@ -0,0 +1,48 @@
+"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 PreferencesModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferencesModule = void 0;
+const nestjs_notifications_core_1 = require("@dudousxd/nestjs-notifications-core");
+const common_1 = require("@nestjs/common");
+const in_memory_store_1 = require("./in-memory.store");
+const notification_preferences_1 = require("./notification-preferences");
+const preference_gate_adapter_1 = require("./preference-gate.adapter");
+const tokens_1 = require("./tokens");
+/**
+ * Registers channel preferences. Binds the core `NOTIFICATION_PREFERENCE_GATE` token to a
+ * store-backed gate so the ChannelRunner automatically skips muted channels.
+ *
+ * ```ts
+ * PreferencesModule.forRoot()                          // in-memory store
+ * PreferencesModule.forRoot({ store: PrismaPrefStore }) // your store
+ * ```
+ */
+let PreferencesModule = PreferencesModule_1 = class PreferencesModule {
+    static forRoot(options = {}) {
+        const storeClass = options.store ?? in_memory_store_1.InMemoryPreferenceStore;
+        const providers = [
+            storeClass,
+            { provide: tokens_1.NOTIFICATION_PREFERENCE_STORE, useExisting: storeClass },
+            notification_preferences_1.NotificationPreferences,
+            preference_gate_adapter_1.PreferenceGateAdapter,
+            { provide: nestjs_notifications_core_1.NOTIFICATION_PREFERENCE_GATE, useExisting: preference_gate_adapter_1.PreferenceGateAdapter },
+        ];
+        return {
+            module: PreferencesModule_1,
+            global: options.global ?? true,
+            providers,
+            exports: [notification_preferences_1.NotificationPreferences, tokens_1.NOTIFICATION_PREFERENCE_STORE],
+        };
+    }
+};
+exports.PreferencesModule = PreferencesModule;
+exports.PreferencesModule = PreferencesModule = PreferencesModule_1 = __decorate([
+    (0, common_1.Module)({})
+], PreferencesModule);
+//# sourceMappingURL=preferences.module.js.map

package/dist/preferences.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.module.js","sourceRoot":"","sources":["../src/preferences.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,mFAAmF;AACnF,2CAAsF;AACtF,uDAA4D;AAE5D,yEAAqE;AACrE,uEAAkE;AAClE,qCAAyD;AAUzD;;;;;;;;GAQG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,UAAoC,EAAE;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,IAAI,yCAAuB,CAAC;QAC5D,MAAM,SAAS,GAAe;YAC5B,UAAU;YACV,EAAE,OAAO,EAAE,sCAA6B,EAAE,WAAW,EAAE,UAAU,EAAE;YACnE,kDAAuB;YACvB,+CAAqB;YACrB,EAAE,OAAO,EAAE,wDAA4B,EAAE,WAAW,EAAE,+CAAqB,EAAE;SAC9E,CAAC;QACF,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,SAAS;YACT,OAAO,EAAE,CAAC,kDAAuB,EAAE,sCAA6B,CAAC;SAClE,CAAC;IACJ,CAAC;CACF,CAAA;AAjBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAiB7B"}

package/dist/tokens.d.ts

@@ -0,0 +1,3 @@
+/** DI token for the {@link PreferenceStore} implementation backing the preferences package. */
+export declare const NOTIFICATION_PREFERENCE_STORE: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,eAAO,MAAM,6BAA6B,eAA0C,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTIFICATION_PREFERENCE_STORE = void 0;
+/** DI token for the {@link PreferenceStore} implementation backing the preferences package. */
+exports.NOTIFICATION_PREFERENCE_STORE = Symbol('NOTIFICATION_PREFERENCE_STORE');
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":";;;AAAA,+FAA+F;AAClF,QAAA,6BAA6B,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@dudousxd/nestjs-notifications-preferences",
+  "version": "0.2.0",
+  "description": "Per-user, per-tenant channel preferences for nestjs-notifications — opt-out muting enforced via the core PreferenceGate",
+  "license": "MIT",
+  "author": "Davide Carvalho",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DavideCarvalho/nestjs-notifications.git",
+    "directory": "packages/preferences"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@dudousxd/nestjs-notifications-core": ">=0.1.0 <1.0.0",
+    "@nestjs/common": "^10.0.0 || ^11.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "reflect-metadata": "^0.2.2",
+    "typescript": "^5.7.2",
+    "@dudousxd/nestjs-notifications-core": "^0.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}