@anievo-id/rbac-evolution-mongoose 0.0.0-stage → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AniEvo-ID
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,104 @@
1
- # Temporary Holding Version
1
+ # @anievo-id/rbac-evolution-mongoose
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ [Mongoose](https://mongoosejs.com) (MongoDB) storage adapter for [rbac-evolution](https://github.com/AniEvo-ID/rbac-evolution) — roles & permissions for JS/TS, inspired by spatie/laravel-permission.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm i @anievo-id/rbac-evolution @anievo-id/rbac-evolution-mongoose mongoose
9
+ ```
10
+
11
+ `mongoose` 8 or later is a peer dependency.
12
+
13
+ ## Collections
14
+
15
+ Five collections mirror spatie/laravel-permission's five tables:
16
+
17
+ | Collection | Fields | Indexes |
18
+ | ----------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- |
19
+ | `permissions` | `_id`, `name`, `guardName`, `createdAt`, `updatedAt` | unique `(name, guardName)` |
20
+ | `roles` | `_id`, `name`, `guardName`, `teamId`, `createdAt`, `updatedAt` | unique `(name, guardName, teamId)` |
21
+ | `role_has_permissions` | `_id`, `roleId`, `permissionId` | unique `(roleId, permissionId)`, `(permissionId)` |
22
+ | `model_has_roles` | `_id`, `roleId`, `subjectType`, `subjectId`, `teamId` | unique `(subjectType, subjectId, teamId, roleId)`, `(roleId, subjectType, teamId)` |
23
+ | `model_has_permissions` | `_id`, `permissionId`, `subjectType`, `subjectId`, `teamId` | unique `(subjectType, subjectId, teamId, permissionId)`, `(permissionId, subjectType, teamId)` |
24
+
25
+ - **Ids are ObjectIds.** Role and permission ids are returned as 24-character hex **strings**
26
+ (`'65f1c0...'`). Ids that aren't valid ObjectId hex strings are ignored (no document could match them).
27
+ - `subjectId` is a string, so subjects may have numeric, UUID or ObjectId ids. Reverse lookups return strings.
28
+ - `teamId` is a string; `''` means "global / no team". `Role.teamId` is `null` for global roles and a **string**
29
+ otherwise (`teamId: 1` → `'1'`).
30
+ - `createdAt` / `updatedAt` are Mongoose timestamps on `permissions` and `roles`.
31
+ - Links live in their own collections (not embedded arrays), so they stay small, indexable and easy to query in both
32
+ directions.
33
+
34
+ ## Usage
35
+
36
+ ```ts
37
+ import mongoose from 'mongoose'
38
+ import { createRbac } from '@anievo-id/rbac-evolution'
39
+ import { mongooseAdapter } from '@anievo-id/rbac-evolution-mongoose'
40
+
41
+ await mongoose.connect(process.env.MONGO_URL!)
42
+
43
+ export const rbac = createRbac({ adapter: mongooseAdapter() })
44
+ ```
45
+
46
+ Options:
47
+
48
+ ```ts
49
+ mongooseAdapter({
50
+ connection: conn, // a mongoose.createConnection() connection; default: mongoose.connection
51
+ prefix: 'rbac_', // rbac_permissions, rbac_roles, ...; default: ''
52
+ })
53
+ ```
54
+
55
+ Then:
56
+
57
+ ```ts
58
+ await rbac.createPermission('edit articles')
59
+ await rbac.createRole('writer')
60
+ await rbac.role('writer').givePermissionTo('edit articles')
61
+
62
+ const user = rbac.for({ type: 'user', id: 1 })
63
+ await user.assignRole('writer')
64
+ await user.can('edit articles') // true
65
+ ```
66
+
67
+ ### Models
68
+
69
+ The models are registered on the connection under the names `rbac:<collection>` (e.g. `rbac:roles`), so they never
70
+ clash with your own `Role` or `Permission` models. Use them directly for admin screens or reports:
71
+
72
+ ```ts
73
+ import { createRbacModels, MongooseRbacAdapter } from '@anievo-id/rbac-evolution-mongoose'
74
+
75
+ const models = createRbacModels({ prefix: 'rbac_' }) // registers or reuses the models
76
+ const adapter = new MongooseRbacAdapter(models)
77
+
78
+ await models.Role.find({ teamId: '' }).lean()
79
+ ```
80
+
81
+ `rbacSchemas()` returns the unregistered schemas if you want to add plugins first.
82
+
83
+ ### Indexes
84
+
85
+ The unique indexes enforce name uniqueness and make `attach*` safe under concurrency. With Mongoose's `autoIndex`
86
+ on (the default) the adapter waits for them before its first operation. If you turn `autoIndex` off in production,
87
+ create them once at deploy time:
88
+
89
+ ```ts
90
+ import { createRbacModels, syncRbacIndexes } from '@anievo-id/rbac-evolution-mongoose'
91
+
92
+ await syncRbacIndexes(createRbacModels())
93
+ ```
94
+
95
+ ## Notes
96
+
97
+ - `attach*` calls are idempotent: each link is an upsert with `$setOnInsert` on its unique key; a duplicate-key
98
+ error from a concurrent insert of the same link is ignored.
99
+ - `deleteRole` / `deletePermission` delete the link documents first, then the role / permission. They don't use a
100
+ transaction (which would require a replica set).
101
+
102
+ ## License
103
+
104
+ MIT
package/dist/index.cjs ADDED
@@ -0,0 +1,336 @@
1
+ 'use strict';
2
+
3
+ var mongoose = require('mongoose');
4
+
5
+ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
6
+
7
+ var mongoose__default = /*#__PURE__*/_interopDefault(mongoose);
8
+
9
+ // src/adapter.ts
10
+ var collectionNames = (options = {}) => {
11
+ const prefix = options.prefix ?? "";
12
+ return {
13
+ permissions: `${prefix}permissions`,
14
+ roles: `${prefix}roles`,
15
+ roleHasPermissions: `${prefix}role_has_permissions`,
16
+ modelHasRoles: `${prefix}model_has_roles`,
17
+ modelHasPermissions: `${prefix}model_has_permissions`
18
+ };
19
+ };
20
+ var linkOptions = { versionKey: false };
21
+ function rbacSchemas() {
22
+ const permission = new mongoose.Schema(
23
+ {
24
+ name: { type: String, required: true },
25
+ guardName: { type: String, required: true }
26
+ },
27
+ { timestamps: true, versionKey: false }
28
+ );
29
+ permission.index({ name: 1, guardName: 1 }, { unique: true });
30
+ const role = new mongoose.Schema(
31
+ {
32
+ name: { type: String, required: true },
33
+ guardName: { type: String, required: true },
34
+ teamId: { type: String, default: "" }
35
+ },
36
+ { timestamps: true, versionKey: false }
37
+ );
38
+ role.index({ name: 1, guardName: 1, teamId: 1 }, { unique: true });
39
+ const roleHasPermission = new mongoose.Schema(
40
+ {
41
+ roleId: { type: mongoose.Schema.Types.ObjectId, required: true },
42
+ permissionId: { type: mongoose.Schema.Types.ObjectId, required: true }
43
+ },
44
+ linkOptions
45
+ );
46
+ roleHasPermission.index({ roleId: 1, permissionId: 1 }, { unique: true });
47
+ roleHasPermission.index({ permissionId: 1 });
48
+ const modelHasRole = new mongoose.Schema(
49
+ {
50
+ roleId: { type: mongoose.Schema.Types.ObjectId, required: true },
51
+ subjectType: { type: String, required: true },
52
+ subjectId: { type: String, required: true },
53
+ teamId: { type: String, default: "" }
54
+ },
55
+ linkOptions
56
+ );
57
+ modelHasRole.index({ subjectType: 1, subjectId: 1, teamId: 1, roleId: 1 }, { unique: true });
58
+ modelHasRole.index({ roleId: 1, subjectType: 1, teamId: 1 });
59
+ const modelHasPermission = new mongoose.Schema(
60
+ {
61
+ permissionId: { type: mongoose.Schema.Types.ObjectId, required: true },
62
+ subjectType: { type: String, required: true },
63
+ subjectId: { type: String, required: true },
64
+ teamId: { type: String, default: "" }
65
+ },
66
+ linkOptions
67
+ );
68
+ modelHasPermission.index({ subjectType: 1, subjectId: 1, teamId: 1, permissionId: 1 }, { unique: true });
69
+ modelHasPermission.index({ permissionId: 1, subjectType: 1, teamId: 1 });
70
+ return { permission, role, roleHasPermission, modelHasRole, modelHasPermission };
71
+ }
72
+ var register = (connection, collection, schema) => {
73
+ const name = `rbac:${collection}`;
74
+ const existing = connection.models[name];
75
+ return existing ?? connection.model(name, schema, collection);
76
+ };
77
+ function createRbacModels(options = {}) {
78
+ const connection = options.connection ?? mongoose__default.default.connection;
79
+ const names = collectionNames(options);
80
+ const schemas = rbacSchemas();
81
+ return {
82
+ Permission: register(connection, names.permissions, schemas.permission),
83
+ Role: register(connection, names.roles, schemas.role),
84
+ RoleHasPermission: register(connection, names.roleHasPermissions, schemas.roleHasPermission),
85
+ ModelHasRole: register(connection, names.modelHasRoles, schemas.modelHasRole),
86
+ ModelHasPermission: register(connection, names.modelHasPermissions, schemas.modelHasPermission)
87
+ };
88
+ }
89
+ async function syncRbacIndexes(models) {
90
+ await Promise.all(Object.values(models).map((model) => model.createIndexes()));
91
+ }
92
+
93
+ // src/adapter.ts
94
+ var GLOBAL_TEAM = "";
95
+ var teamKey = (teamId) => teamId === null ? GLOBAL_TEAM : String(teamId);
96
+ var teamFromKey = (key) => key === void 0 || key === GLOBAL_TEAM ? null : key;
97
+ var OBJECT_ID = /^[0-9a-f]{24}$/i;
98
+ var toObjectId = (id) => {
99
+ const s = String(id);
100
+ return OBJECT_ID.test(s) ? new mongoose.Types.ObjectId(s) : null;
101
+ };
102
+ var toObjectIds = (ids) => {
103
+ const out = /* @__PURE__ */ new Map();
104
+ for (const id of ids) {
105
+ const oid = toObjectId(id);
106
+ if (oid !== null) out.set(oid.toHexString(), oid);
107
+ }
108
+ return [...out.values()];
109
+ };
110
+ var onlyDuplicates = (error) => {
111
+ const e = error;
112
+ if (e === null || typeof e !== "object") return false;
113
+ const writeErrors = Array.isArray(e.writeErrors) ? e.writeErrors : [];
114
+ if (Array.isArray(e.writeConcernErrors) && e.writeConcernErrors.length > 0) return false;
115
+ if (writeErrors.length > 0) return writeErrors.every((w) => w.code === 11e3);
116
+ return e.code === 11e3;
117
+ };
118
+ var MongooseRbacAdapter = class _MongooseRbacAdapter {
119
+ constructor(models) {
120
+ this.models = models;
121
+ }
122
+ models;
123
+ ready;
124
+ /** Waits for the models' indexes (unique constraints) once, before the first operation. */
125
+ init() {
126
+ this.ready ??= Promise.all(Object.values(this.models).map((model) => model.init()));
127
+ return this.ready;
128
+ }
129
+ // ---------------------------------------------------------------- permissions
130
+ async createPermission(data) {
131
+ await this.init();
132
+ const doc = await this.models.Permission.create({ name: data.name, guardName: data.guardName });
133
+ return { id: doc._id.toHexString(), name: doc.name, guardName: doc.guardName };
134
+ }
135
+ async findPermissions(query = {}) {
136
+ await this.init();
137
+ const filter = {};
138
+ if (query.ids !== void 0) {
139
+ const ids = toObjectIds(query.ids);
140
+ if (ids.length === 0) return [];
141
+ filter._id = { $in: ids };
142
+ }
143
+ if (query.names !== void 0) {
144
+ if (query.names.length === 0) return [];
145
+ filter.name = { $in: [...query.names] };
146
+ }
147
+ if (query.guardName !== void 0) filter.guardName = query.guardName;
148
+ const docs = await this.models.Permission.find(filter, { name: 1, guardName: 1 }).sort({ _id: 1 }).lean();
149
+ return docs.map((d) => ({ id: d._id.toHexString(), name: d.name, guardName: d.guardName }));
150
+ }
151
+ async deletePermission(id) {
152
+ const pid = toObjectId(id);
153
+ if (pid === null) return;
154
+ await this.init();
155
+ await this.models.RoleHasPermission.deleteMany({ permissionId: pid });
156
+ await this.models.ModelHasPermission.deleteMany({ permissionId: pid });
157
+ await this.models.Permission.deleteOne({ _id: pid });
158
+ }
159
+ // ---------------------------------------------------------------------- roles
160
+ async createRole(data) {
161
+ await this.init();
162
+ const doc = await this.models.Role.create({ name: data.name, guardName: data.guardName, teamId: teamKey(data.teamId) });
163
+ return { id: doc._id.toHexString(), name: doc.name, guardName: doc.guardName, teamId: teamFromKey(doc.teamId) };
164
+ }
165
+ async findRoles(query = {}) {
166
+ await this.init();
167
+ const filter = {};
168
+ if (query.ids !== void 0) {
169
+ const ids = toObjectIds(query.ids);
170
+ if (ids.length === 0) return [];
171
+ filter._id = { $in: ids };
172
+ }
173
+ if (query.names !== void 0) {
174
+ if (query.names.length === 0) return [];
175
+ filter.name = { $in: [...query.names] };
176
+ }
177
+ if (query.guardName !== void 0) filter.guardName = query.guardName;
178
+ if (query.teamIds !== void 0) {
179
+ if (query.teamIds.length === 0) return [];
180
+ const teams = [...new Set(query.teamIds.map(teamKey))];
181
+ filter.teamId = teams.includes(GLOBAL_TEAM) ? { $in: [...teams, null] } : { $in: teams };
182
+ }
183
+ const docs = await this.models.Role.find(filter, { name: 1, guardName: 1, teamId: 1 }).sort({ _id: 1 }).lean();
184
+ return docs.map((d) => ({
185
+ id: d._id.toHexString(),
186
+ name: d.name,
187
+ guardName: d.guardName,
188
+ teamId: teamFromKey(d.teamId)
189
+ }));
190
+ }
191
+ async deleteRole(id) {
192
+ const rid = toObjectId(id);
193
+ if (rid === null) return;
194
+ await this.init();
195
+ await this.models.RoleHasPermission.deleteMany({ roleId: rid });
196
+ await this.models.ModelHasRole.deleteMany({ roleId: rid });
197
+ await this.models.Role.deleteOne({ _id: rid });
198
+ }
199
+ // ---------------------------------------------------------- role ↔ permission
200
+ async getRolePermissionLinks(roleIds) {
201
+ const ids = toObjectIds(roleIds);
202
+ if (ids.length === 0) return [];
203
+ await this.init();
204
+ const docs = await this.models.RoleHasPermission.find({ roleId: { $in: ids } }, { roleId: 1, permissionId: 1 }).lean();
205
+ return docs.map((d) => ({ roleId: d.roleId.toHexString(), permissionId: d.permissionId.toHexString() }));
206
+ }
207
+ async attachRolePermissions(roleId, permissionIds) {
208
+ const rid = toObjectId(roleId);
209
+ const ids = toObjectIds(permissionIds);
210
+ if (rid === null || ids.length === 0) return;
211
+ await this.init();
212
+ await _MongooseRbacAdapter.upsertAll(
213
+ this.models.RoleHasPermission,
214
+ ids.map((permissionId) => ({ roleId: rid, permissionId }))
215
+ );
216
+ }
217
+ async detachRolePermissions(roleId, permissionIds) {
218
+ const rid = toObjectId(roleId);
219
+ if (rid === null) return;
220
+ const filter = { roleId: rid };
221
+ if (permissionIds !== void 0) {
222
+ const ids = toObjectIds(permissionIds);
223
+ if (ids.length === 0) return;
224
+ filter.permissionId = { $in: ids };
225
+ }
226
+ await this.init();
227
+ await this.models.RoleHasPermission.deleteMany(filter);
228
+ }
229
+ // ------------------------------------------------------------- subject links
230
+ async getSubjectRoleIds(subject, teamId) {
231
+ await this.init();
232
+ const docs = await this.models.ModelHasRole.find(_MongooseRbacAdapter.subjectFilter(subject, teamId), {
233
+ roleId: 1
234
+ }).lean();
235
+ return docs.map((d) => d.roleId.toHexString());
236
+ }
237
+ async attachSubjectRoles(subject, roleIds, teamId) {
238
+ const ids = toObjectIds(roleIds);
239
+ if (ids.length === 0) return;
240
+ await this.init();
241
+ const base = _MongooseRbacAdapter.subjectFilter(subject, teamId);
242
+ await _MongooseRbacAdapter.upsertAll(
243
+ this.models.ModelHasRole,
244
+ ids.map((roleId) => ({ ...base, roleId }))
245
+ );
246
+ }
247
+ async detachSubjectRoles(subject, roleIds, teamId) {
248
+ const filter = _MongooseRbacAdapter.subjectFilter(subject, teamId);
249
+ if (roleIds !== void 0) {
250
+ const ids = toObjectIds(roleIds);
251
+ if (ids.length === 0) return;
252
+ filter.roleId = { $in: ids };
253
+ }
254
+ await this.init();
255
+ await this.models.ModelHasRole.deleteMany(filter);
256
+ }
257
+ async getSubjectPermissionIds(subject, teamId) {
258
+ await this.init();
259
+ const docs = await this.models.ModelHasPermission.find(_MongooseRbacAdapter.subjectFilter(subject, teamId), {
260
+ permissionId: 1
261
+ }).lean();
262
+ return docs.map((d) => d.permissionId.toHexString());
263
+ }
264
+ async attachSubjectPermissions(subject, permissionIds, teamId) {
265
+ const ids = toObjectIds(permissionIds);
266
+ if (ids.length === 0) return;
267
+ await this.init();
268
+ const base = _MongooseRbacAdapter.subjectFilter(subject, teamId);
269
+ await _MongooseRbacAdapter.upsertAll(
270
+ this.models.ModelHasPermission,
271
+ ids.map((permissionId) => ({ ...base, permissionId }))
272
+ );
273
+ }
274
+ async detachSubjectPermissions(subject, permissionIds, teamId) {
275
+ const filter = _MongooseRbacAdapter.subjectFilter(subject, teamId);
276
+ if (permissionIds !== void 0) {
277
+ const ids = toObjectIds(permissionIds);
278
+ if (ids.length === 0) return;
279
+ filter.permissionId = { $in: ids };
280
+ }
281
+ await this.init();
282
+ await this.models.ModelHasPermission.deleteMany(filter);
283
+ }
284
+ async getSubjectIdsWithRoles(subjectType, roleIds, teamId) {
285
+ const ids = toObjectIds(roleIds);
286
+ if (ids.length === 0) return [];
287
+ await this.init();
288
+ const subjectIds = await this.models.ModelHasRole.distinct("subjectId", {
289
+ subjectType,
290
+ teamId: teamKey(teamId),
291
+ roleId: { $in: ids }
292
+ });
293
+ return subjectIds.map(String);
294
+ }
295
+ async getSubjectIdsWithPermissions(subjectType, permissionIds, teamId) {
296
+ const ids = toObjectIds(permissionIds);
297
+ if (ids.length === 0) return [];
298
+ await this.init();
299
+ const subjectIds = await this.models.ModelHasPermission.distinct("subjectId", {
300
+ subjectType,
301
+ teamId: teamKey(teamId),
302
+ permissionId: { $in: ids }
303
+ });
304
+ return subjectIds.map(String);
305
+ }
306
+ // -------------------------------------------------------------------- helpers
307
+ static subjectFilter(subject, teamId) {
308
+ return { subjectType: subject.type, subjectId: String(subject.id), teamId: teamKey(teamId) };
309
+ }
310
+ /**
311
+ * Idempotent insert: one upsert per link (`$setOnInsert`), matched on the unique key.
312
+ * A concurrent insert of the same link surfaces as a duplicate-key error, which is ignored.
313
+ */
314
+ static async upsertAll(model, docs) {
315
+ try {
316
+ await model.bulkWrite(
317
+ docs.map((doc) => ({ updateOne: { filter: doc, update: { $setOnInsert: doc }, upsert: true } })),
318
+ { ordered: false }
319
+ );
320
+ } catch (error) {
321
+ if (!onlyDuplicates(error)) throw error;
322
+ }
323
+ }
324
+ };
325
+ function mongooseAdapter(options = {}) {
326
+ return new MongooseRbacAdapter(createRbacModels(options));
327
+ }
328
+
329
+ exports.MongooseRbacAdapter = MongooseRbacAdapter;
330
+ exports.collectionNames = collectionNames;
331
+ exports.createRbacModels = createRbacModels;
332
+ exports.mongooseAdapter = mongooseAdapter;
333
+ exports.rbacSchemas = rbacSchemas;
334
+ exports.syncRbacIndexes = syncRbacIndexes;
335
+ //# sourceMappingURL=index.cjs.map
336
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/models.ts","../src/adapter.ts"],"names":["Schema","mongoose","Types"],"mappings":"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","file":"index.cjs","sourcesContent":["import mongoose, { type Connection, type Model, Schema, type Types } from 'mongoose'\n\nexport interface PermissionDoc {\n _id: Types.ObjectId\n name: string\n guardName: string\n createdAt: Date\n updatedAt: Date\n}\n\nexport interface RoleDoc {\n _id: Types.ObjectId\n name: string\n guardName: string\n /** `''` = global (no team). */\n teamId: string\n createdAt: Date\n updatedAt: Date\n}\n\nexport interface RoleHasPermissionDoc {\n _id: Types.ObjectId\n roleId: Types.ObjectId\n permissionId: Types.ObjectId\n}\n\nexport interface ModelHasRoleDoc {\n _id: Types.ObjectId\n roleId: Types.ObjectId\n subjectType: string\n subjectId: string\n /** `''` = global (no team). */\n teamId: string\n}\n\nexport interface ModelHasPermissionDoc {\n _id: Types.ObjectId\n permissionId: Types.ObjectId\n subjectType: string\n subjectId: string\n /** `''` = global (no team). */\n teamId: string\n}\n\n/** The five Mongoose models used by the adapter. */\nexport interface RbacModels {\n Permission: Model<PermissionDoc>\n Role: Model<RoleDoc>\n RoleHasPermission: Model<RoleHasPermissionDoc>\n ModelHasRole: Model<ModelHasRoleDoc>\n ModelHasPermission: Model<ModelHasPermissionDoc>\n}\n\nexport interface RbacModelOptions {\n /** Connection to register the models on. Default: the default `mongoose.connection`. */\n connection?: Connection\n /** Prepended to every collection name, e.g. `'rbac_'` → `rbac_permissions`. Default: `''`. */\n prefix?: string\n}\n\nexport interface RbacCollectionNames {\n permissions: string\n roles: string\n roleHasPermissions: string\n modelHasRoles: string\n modelHasPermissions: string\n}\n\nexport const collectionNames = (options: Pick<RbacModelOptions, 'prefix'> = {}): RbacCollectionNames => {\n const prefix = options.prefix ?? ''\n return {\n permissions: `${prefix}permissions`,\n roles: `${prefix}roles`,\n roleHasPermissions: `${prefix}role_has_permissions`,\n modelHasRoles: `${prefix}model_has_roles`,\n modelHasPermissions: `${prefix}model_has_permissions`,\n }\n}\n\nconst linkOptions = { versionKey: false } as const\n\n/** Schemas (unregistered). Useful to add plugins or hooks before calling `createRbacModels`. */\nexport function rbacSchemas() {\n const permission = new Schema<PermissionDoc>(\n {\n name: { type: String, required: true },\n guardName: { type: String, required: true },\n },\n { timestamps: true, versionKey: false },\n )\n permission.index({ name: 1, guardName: 1 }, { unique: true })\n\n const role = new Schema<RoleDoc>(\n {\n name: { type: String, required: true },\n guardName: { type: String, required: true },\n teamId: { type: String, default: '' },\n },\n { timestamps: true, versionKey: false },\n )\n role.index({ name: 1, guardName: 1, teamId: 1 }, { unique: true })\n\n const roleHasPermission = new Schema<RoleHasPermissionDoc>(\n {\n roleId: { type: Schema.Types.ObjectId, required: true },\n permissionId: { type: Schema.Types.ObjectId, required: true },\n },\n linkOptions,\n )\n roleHasPermission.index({ roleId: 1, permissionId: 1 }, { unique: true })\n roleHasPermission.index({ permissionId: 1 })\n\n const modelHasRole = new Schema<ModelHasRoleDoc>(\n {\n roleId: { type: Schema.Types.ObjectId, required: true },\n subjectType: { type: String, required: true },\n subjectId: { type: String, required: true },\n teamId: { type: String, default: '' },\n },\n linkOptions,\n )\n modelHasRole.index({ subjectType: 1, subjectId: 1, teamId: 1, roleId: 1 }, { unique: true })\n modelHasRole.index({ roleId: 1, subjectType: 1, teamId: 1 })\n\n const modelHasPermission = new Schema<ModelHasPermissionDoc>(\n {\n permissionId: { type: Schema.Types.ObjectId, required: true },\n subjectType: { type: String, required: true },\n subjectId: { type: String, required: true },\n teamId: { type: String, default: '' },\n },\n linkOptions,\n )\n modelHasPermission.index({ subjectType: 1, subjectId: 1, teamId: 1, permissionId: 1 }, { unique: true })\n modelHasPermission.index({ permissionId: 1, subjectType: 1, teamId: 1 })\n\n return { permission, role, roleHasPermission, modelHasRole, modelHasPermission }\n}\n\nconst register = <T>(connection: Connection, collection: string, schema: Schema<T>): Model<T> => {\n // Model names are derived from the collection, so they never clash with your own `Role` / `Permission` models.\n const name = `rbac:${collection}`\n const existing = connection.models[name]\n return (existing as Model<T> | undefined) ?? connection.model<T>(name, schema, collection)\n}\n\n/**\n * Registers (or reuses) the rbac-evolution models on a connection.\n *\n * ```ts\n * const models = createRbacModels() // default connection\n * const models = createRbacModels({ connection: conn, prefix: 'rbac_' })\n * ```\n */\nexport function createRbacModels(options: RbacModelOptions = {}): RbacModels {\n const connection = options.connection ?? mongoose.connection\n const names = collectionNames(options)\n const schemas = rbacSchemas()\n return {\n Permission: register(connection, names.permissions, schemas.permission),\n Role: register(connection, names.roles, schemas.role),\n RoleHasPermission: register(connection, names.roleHasPermissions, schemas.roleHasPermission),\n ModelHasRole: register(connection, names.modelHasRoles, schemas.modelHasRole),\n ModelHasPermission: register(connection, names.modelHasPermissions, schemas.modelHasPermission),\n }\n}\n\n/**\n * Creates the collections' indexes (unique constraints included). Call it once at deploy/startup when\n * Mongoose `autoIndex` is disabled; with `autoIndex` on (the default) the adapter waits for them itself.\n */\nexport async function syncRbacIndexes(models: RbacModels): Promise<void> {\n await Promise.all(Object.values(models).map((model: Model<unknown>) => model.createIndexes()))\n}\n","import type {\n FindPermissionsQuery,\n FindRolesQuery,\n Id,\n Permission,\n RbacAdapter,\n Role,\n RolePermissionLink,\n Subject,\n TeamId,\n} from '@anievo-id/rbac-evolution'\nimport { type Model, Types } from 'mongoose'\nimport { type RbacModelOptions, type RbacModels, createRbacModels } from './models'\n\n/** Team ids are stored as strings; `''` represents \"no team\" so it can be part of a unique index. */\nconst GLOBAL_TEAM = ''\nconst teamKey = (teamId: TeamId): string => (teamId === null ? GLOBAL_TEAM : String(teamId))\nconst teamFromKey = (key: string | undefined): TeamId => (key === undefined || key === GLOBAL_TEAM ? null : key)\n\n/** Role / permission ids are ObjectIds (24 hex chars). Anything else can never match a document, so it is dropped. */\nconst OBJECT_ID = /^[0-9a-f]{24}$/i\nconst toObjectId = (id: Id): Types.ObjectId | null => {\n const s = String(id)\n return OBJECT_ID.test(s) ? new Types.ObjectId(s) : null\n}\nconst toObjectIds = (ids: readonly Id[]): Types.ObjectId[] => {\n const out = new Map<string, Types.ObjectId>()\n for (const id of ids) {\n const oid = toObjectId(id)\n if (oid !== null) out.set(oid.toHexString(), oid)\n }\n return [...out.values()]\n}\n\n/** True when every failure of a (bulk) write is a duplicate-key error, i.e. the link already existed. */\nconst onlyDuplicates = (error: unknown): boolean => {\n const e = error as { code?: unknown; writeErrors?: unknown; writeConcernErrors?: unknown } | null\n if (e === null || typeof e !== 'object') return false\n const writeErrors = Array.isArray(e.writeErrors) ? (e.writeErrors as { code?: unknown }[]) : []\n if (Array.isArray(e.writeConcernErrors) && e.writeConcernErrors.length > 0) return false\n if (writeErrors.length > 0) return writeErrors.every((w) => w.code === 11000)\n return e.code === 11000\n}\n\ntype SubjectLinkDoc = {\n subjectType: string\n subjectId: string\n teamId: string\n}\n\n/**\n * Mongoose (MongoDB) implementation of `RbacAdapter`.\n * Construct it with `mongooseAdapter(options?)` or `new MongooseRbacAdapter(createRbacModels(...))`.\n */\nexport class MongooseRbacAdapter implements RbacAdapter {\n private ready: Promise<unknown> | undefined\n\n constructor(readonly models: RbacModels) {}\n\n /** Waits for the models' indexes (unique constraints) once, before the first operation. */\n private init(): Promise<unknown> {\n this.ready ??= Promise.all(Object.values(this.models).map((model: Model<unknown>) => model.init()))\n return this.ready\n }\n\n // ---------------------------------------------------------------- permissions\n\n async createPermission(data: { name: string; guardName: string }): Promise<Permission> {\n await this.init()\n const doc = await this.models.Permission.create({ name: data.name, guardName: data.guardName })\n return { id: doc._id.toHexString(), name: doc.name, guardName: doc.guardName }\n }\n\n async findPermissions(query: FindPermissionsQuery = {}): Promise<Permission[]> {\n await this.init()\n const filter: Record<string, unknown> = {}\n if (query.ids !== undefined) {\n const ids = toObjectIds(query.ids)\n if (ids.length === 0) return []\n filter._id = { $in: ids }\n }\n if (query.names !== undefined) {\n if (query.names.length === 0) return []\n filter.name = { $in: [...query.names] }\n }\n if (query.guardName !== undefined) filter.guardName = query.guardName\n const docs = await this.models.Permission.find(filter, { name: 1, guardName: 1 }).sort({ _id: 1 }).lean()\n return docs.map((d) => ({ id: d._id.toHexString(), name: d.name, guardName: d.guardName }))\n }\n\n async deletePermission(id: Id): Promise<void> {\n const pid = toObjectId(id)\n if (pid === null) return\n await this.init()\n await this.models.RoleHasPermission.deleteMany({ permissionId: pid })\n await this.models.ModelHasPermission.deleteMany({ permissionId: pid })\n await this.models.Permission.deleteOne({ _id: pid })\n }\n\n // ---------------------------------------------------------------------- roles\n\n async createRole(data: { name: string; guardName: string; teamId: TeamId }): Promise<Role> {\n await this.init()\n const doc = await this.models.Role.create({ name: data.name, guardName: data.guardName, teamId: teamKey(data.teamId) })\n return { id: doc._id.toHexString(), name: doc.name, guardName: doc.guardName, teamId: teamFromKey(doc.teamId) }\n }\n\n async findRoles(query: FindRolesQuery = {}): Promise<Role[]> {\n await this.init()\n const filter: Record<string, unknown> = {}\n if (query.ids !== undefined) {\n const ids = toObjectIds(query.ids)\n if (ids.length === 0) return []\n filter._id = { $in: ids }\n }\n if (query.names !== undefined) {\n if (query.names.length === 0) return []\n filter.name = { $in: [...query.names] }\n }\n if (query.guardName !== undefined) filter.guardName = query.guardName\n if (query.teamIds !== undefined) {\n if (query.teamIds.length === 0) return []\n const teams = [...new Set(query.teamIds.map(teamKey))]\n // Documents written without the field (e.g. by hand) count as global.\n filter.teamId = teams.includes(GLOBAL_TEAM) ? { $in: [...teams, null] } : { $in: teams }\n }\n const docs = await this.models.Role.find(filter, { name: 1, guardName: 1, teamId: 1 }).sort({ _id: 1 }).lean()\n return docs.map((d) => ({\n id: d._id.toHexString(),\n name: d.name,\n guardName: d.guardName,\n teamId: teamFromKey(d.teamId),\n }))\n }\n\n async deleteRole(id: Id): Promise<void> {\n const rid = toObjectId(id)\n if (rid === null) return\n await this.init()\n await this.models.RoleHasPermission.deleteMany({ roleId: rid })\n await this.models.ModelHasRole.deleteMany({ roleId: rid })\n await this.models.Role.deleteOne({ _id: rid })\n }\n\n // ---------------------------------------------------------- role ↔ permission\n\n async getRolePermissionLinks(roleIds: readonly Id[]): Promise<RolePermissionLink[]> {\n const ids = toObjectIds(roleIds)\n if (ids.length === 0) return []\n await this.init()\n const docs = await this.models.RoleHasPermission.find({ roleId: { $in: ids } }, { roleId: 1, permissionId: 1 }).lean()\n return docs.map((d) => ({ roleId: d.roleId.toHexString(), permissionId: d.permissionId.toHexString() }))\n }\n\n async attachRolePermissions(roleId: Id, permissionIds: readonly Id[]): Promise<void> {\n const rid = toObjectId(roleId)\n const ids = toObjectIds(permissionIds)\n if (rid === null || ids.length === 0) return\n await this.init()\n await MongooseRbacAdapter.upsertAll(\n this.models.RoleHasPermission,\n ids.map((permissionId) => ({ roleId: rid, permissionId })),\n )\n }\n\n async detachRolePermissions(roleId: Id, permissionIds?: readonly Id[]): Promise<void> {\n const rid = toObjectId(roleId)\n if (rid === null) return\n const filter: Record<string, unknown> = { roleId: rid }\n if (permissionIds !== undefined) {\n const ids = toObjectIds(permissionIds)\n if (ids.length === 0) return\n filter.permissionId = { $in: ids }\n }\n await this.init()\n await this.models.RoleHasPermission.deleteMany(filter)\n }\n\n // ------------------------------------------------------------- subject links\n\n async getSubjectRoleIds(subject: Subject, teamId: TeamId): Promise<Id[]> {\n await this.init()\n const docs = await this.models.ModelHasRole.find(MongooseRbacAdapter.subjectFilter(subject, teamId), {\n roleId: 1,\n }).lean()\n return docs.map((d) => d.roleId.toHexString())\n }\n\n async attachSubjectRoles(subject: Subject, roleIds: readonly Id[], teamId: TeamId): Promise<void> {\n const ids = toObjectIds(roleIds)\n if (ids.length === 0) return\n await this.init()\n const base = MongooseRbacAdapter.subjectFilter(subject, teamId)\n await MongooseRbacAdapter.upsertAll(\n this.models.ModelHasRole,\n ids.map((roleId) => ({ ...base, roleId })),\n )\n }\n\n async detachSubjectRoles(subject: Subject, roleIds: readonly Id[] | undefined, teamId: TeamId): Promise<void> {\n const filter: Record<string, unknown> = MongooseRbacAdapter.subjectFilter(subject, teamId)\n if (roleIds !== undefined) {\n const ids = toObjectIds(roleIds)\n if (ids.length === 0) return\n filter.roleId = { $in: ids }\n }\n await this.init()\n await this.models.ModelHasRole.deleteMany(filter)\n }\n\n async getSubjectPermissionIds(subject: Subject, teamId: TeamId): Promise<Id[]> {\n await this.init()\n const docs = await this.models.ModelHasPermission.find(MongooseRbacAdapter.subjectFilter(subject, teamId), {\n permissionId: 1,\n }).lean()\n return docs.map((d) => d.permissionId.toHexString())\n }\n\n async attachSubjectPermissions(subject: Subject, permissionIds: readonly Id[], teamId: TeamId): Promise<void> {\n const ids = toObjectIds(permissionIds)\n if (ids.length === 0) return\n await this.init()\n const base = MongooseRbacAdapter.subjectFilter(subject, teamId)\n await MongooseRbacAdapter.upsertAll(\n this.models.ModelHasPermission,\n ids.map((permissionId) => ({ ...base, permissionId })),\n )\n }\n\n async detachSubjectPermissions(\n subject: Subject,\n permissionIds: readonly Id[] | undefined,\n teamId: TeamId,\n ): Promise<void> {\n const filter: Record<string, unknown> = MongooseRbacAdapter.subjectFilter(subject, teamId)\n if (permissionIds !== undefined) {\n const ids = toObjectIds(permissionIds)\n if (ids.length === 0) return\n filter.permissionId = { $in: ids }\n }\n await this.init()\n await this.models.ModelHasPermission.deleteMany(filter)\n }\n\n async getSubjectIdsWithRoles(subjectType: string, roleIds: readonly Id[], teamId: TeamId): Promise<Id[]> {\n const ids = toObjectIds(roleIds)\n if (ids.length === 0) return []\n await this.init()\n const subjectIds: unknown[] = await this.models.ModelHasRole.distinct('subjectId', {\n subjectType,\n teamId: teamKey(teamId),\n roleId: { $in: ids },\n })\n return subjectIds.map(String)\n }\n\n async getSubjectIdsWithPermissions(subjectType: string, permissionIds: readonly Id[], teamId: TeamId): Promise<Id[]> {\n const ids = toObjectIds(permissionIds)\n if (ids.length === 0) return []\n await this.init()\n const subjectIds: unknown[] = await this.models.ModelHasPermission.distinct('subjectId', {\n subjectType,\n teamId: teamKey(teamId),\n permissionId: { $in: ids },\n })\n return subjectIds.map(String)\n }\n\n // -------------------------------------------------------------------- helpers\n\n private static subjectFilter(subject: Subject, teamId: TeamId): SubjectLinkDoc {\n return { subjectType: subject.type, subjectId: String(subject.id), teamId: teamKey(teamId) }\n }\n\n /**\n * Idempotent insert: one upsert per link (`$setOnInsert`), matched on the unique key.\n * A concurrent insert of the same link surfaces as a duplicate-key error, which is ignored.\n */\n private static async upsertAll<T>(model: Model<T>, docs: Record<string, unknown>[]): Promise<void> {\n try {\n await model.bulkWrite(\n docs.map((doc) => ({ updateOne: { filter: doc, update: { $setOnInsert: doc }, upsert: true } })) as never,\n { ordered: false },\n )\n } catch (error) {\n if (!onlyDuplicates(error)) throw error\n }\n }\n}\n\n/**\n * Creates a Mongoose-backed `RbacAdapter` (registers the models on the connection if needed).\n *\n * ```ts\n * await mongoose.connect(process.env.MONGO_URL!)\n * const rbac = createRbac({ adapter: mongooseAdapter() })\n * const rbac = createRbac({ adapter: mongooseAdapter({ connection: conn, prefix: 'rbac_' }) })\n * ```\n */\nexport function mongooseAdapter(options: RbacModelOptions = {}): MongooseRbacAdapter {\n return new MongooseRbacAdapter(createRbacModels(options))\n}\n"]}