@rapidrest/service-core 1.0.0-rc.7 → 1.0.0

package/dist/lib/decorators/DatabaseDecorators.js

@@ -1,15 +1,40 @@
 ///////////////////////////////////////////////////////////////////////////////
 // Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
 ///////////////////////////////////////////////////////////////////////////////
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ConnectionManager } from "../database/ConnectionManager.js";
+import { isSqlDataSource } from "../database/ConnectionKinds.js";
+import { MongoConnection } from "../database/MongoConnection.js";
 /**
- * Apply this to a property to have the TypeORM `MongoRepository` for the given entity type injected at instantiation.
+ * Carries the transactional context established by `@Transactional` through the async call chain of the
+ * decorated method, keyed to that specific invocation rather than to the object instance the method runs on.
+ */
+export const transactionContext = new AsyncLocalStorage();
+/**
+ * Registers a best-effort compensating action to run if the currently active transaction (the one owning the
+ * ambient `transactionContext`) ultimately fails. Intended for code that just committed a write on a *different*
+ * connection than the active transaction's own (e.g. one that can't be rolled back by that transaction's own
+ * abort) and needs its own explicit cleanup to avoid an orphaned write if the active transaction later fails.
+ * A no-op if there's no active transaction to register against.
  *
- * @param {any} type The entity type whose repository will be injected.
+ * The hook is responsible for catching and logging its own errors; if it throws anyway, that's swallowed (via
+ * `Promise.allSettled`) rather than masking the original failure that triggered the rollback.
+ *
+ * @param hook The compensating action to run.
+ */
+export function registerRollbackHook(hook) {
+    transactionContext.getStore()?.onRollback?.push(hook);
+}
+/**
+ * Apply this to a property to have the datasource connection with the given name injected at instantiation.
+ *
+ * @param name The name of the datasource or class type.
+ * @param required Set to `true` to indicate this injection must resolve, otherwise set to `false`. Default is `true`.
  */
-export function MongoRepository(type) {
+export function DataSource(name, required = true) {
     return function (target, propertyKey) {
-        Reflect.defineMetadata("rrst:injectMongoRepo", type, target, propertyKey);
-        const key = `__${String(propertyKey)}`;
+        Reflect.defineMetadata("rrst:injectDataSource", { name, required }, target, propertyKey);
         Object.defineProperty(target, propertyKey, {
             enumerable: true,
             writable: true,
@@ -18,14 +43,41 @@ export function MongoRepository(type) {
     };
 }
 /**
- * Apply this to a property to have the TypeORM `Repository` for the given entity type injected at instantiation.
+ * Injects the entity manager as the value of the decorated argument.
+ *
+ * @param name The name of the datasource or class type.
+ */
+export function EntityManager(nameOrType) {
+    return function (target, propertyKey, index) {
+        const datasource = typeof nameOrType === "string" ? nameOrType : nameOrType?.datasource;
+        // Falls back to a fresh object rather than assuming some other parameter decorator (e.g. `@Param`)
+        // already initialized this metadata — a `@Transactional` method using only `@EntityManager` has no
+        // such decorator, and indexing into `undefined` here would throw at class-definition time.
+        const args = Reflect.getMetadata("rrst:args", target, propertyKey) ?? {};
+        args[index] = ["entityManager", datasource];
+        Reflect.defineMetadata("rrst:args", args, target, propertyKey);
+    };
+}
+/**
+ * Injects the MongoDB session (used by @Transactional) as the value of the decorated argument.
+ */
+export function MongoSession(nameOrType) {
+    return function (target, propertyKey, index) {
+        const datasource = typeof nameOrType === "string" ? nameOrType : nameOrType?.datasource;
+        const args = Reflect.getMetadata("rrst:args", target, propertyKey) ?? {};
+        args[index] = ["mongoSession", datasource];
+        Reflect.defineMetadata("rrst:args", args, target, propertyKey);
+    };
+}
+/**
+ * Apply this to a property to have the datasource repository for the given entity type injected at instantiation.
  *
  * @param {any} type The entity type whose repository will be injected.
+ * @param required Set to `true` to indicate this injection must resolve, otherwise set to `false`. Default is `true`.
  */
-export function Repository(type) {
+export function Repository(type, required = true) {
     return function (target, propertyKey) {
-        Reflect.defineMetadata("rrst:injectRepo", type, target, propertyKey);
-        const key = `__${String(propertyKey)}`;
+        Reflect.defineMetadata("rrst:injectRepository", { type, required }, target, propertyKey);
         Object.defineProperty(target, propertyKey, {
             enumerable: true,
             writable: true,
@@ -34,19 +86,211 @@ export function Repository(type) {
     };
 }
 /**
- * Apply this to a property to have the `Redis` connection injected at instantiation.
+ * Apply this to a property to have the `Redis` connection with the given name injected at instantiation.
  *
- * @param {string} name The name of the database connection to inject.
+ * @param {string} name The name of the datasource connection to inject.
+ * @param required Set to `true` to indicate this injection must resolve, otherwise set to `false`. Default is `true`.
  */
-export function RedisConnection(name) {
-    return function (target, propertyKey) {
-        Reflect.defineMetadata("rrst:injectRedisRepo", name, target, propertyKey);
-        const key = `__${String(propertyKey)}`;
-        Object.defineProperty(target, propertyKey, {
-            enumerable: true,
-            writable: true,
-            value: undefined,
-        });
+export function Redis(name = "redis", required = true) {
+    return DataSource(name, required);
+}
+/**
+ * Describes the opertaing mode for transaction support and how existing context should be
+ * reconciled. When @Transactional is used multiple times in a single callstack, the
+ * context can either be merged in a single transaction and nested.
+ */
+export var TransactionalMode;
+(function (TransactionalMode) {
+    /** Always creates a new transactional context for the current function. */
+    TransactionalMode[TransactionalMode["CREATE"] = 0] = "CREATE";
+    /** Merges existing transactional context instead of creating a new one. */
+    TransactionalMode[TransactionalMode["MERGE"] = 1] = "MERGE";
+})(TransactionalMode || (TransactionalMode = {}));
+/**
+ * Apply this to perform all operations in a single transaction. The specified `source` can
+ * be the name of a connection or the class type of a persistent data model. If no `source` is specified it is inferred
+ * by lookup via `this.modelClass` which is injected when `@Model` is added to a class.
+ *
+ * For MongoDB, this has the effect of creating a new session and wrapping the function call in
+ * `session.withTransaction()`. Note that you must pass in the `session` to each `MongoRepository` function you wish
+ * to use the transaction. The `session` is automatically made available for the duration of the call via
+ * `transactionContext` (an `AsyncLocalStorage` that is scoped to this call). Optionally, it can also be injected to a
+ * function argument that is decorated with `@MongoSession`.
+ *
+ * For TypeORM, this has the effect of creating a new transaction and wrapping the function call in
+ * `datasource.transaction()`. Note that you must use the provided `EntityManager` for all database actions. The
+ * `entityManager` is automatically made available for the duration of the call via `transactionContext`. Optionally,
+ * it can be injected to a function argument that is decorated with `@EntityManager`.
+ *
+ * If `@Transactional` was already in effect earlier in the current call stack (e.g. a `RepoUtils` method called
+ * from a `ModelRoute` method that's also `@Transactional`), the existing transaction is reused by default rather
+ * than opening a second, nested one. See `TransactionalOptions.mode`.
+ *
+ * Note: A `@Transactional` method *MUST* always return a promise (e.g. is async).
+ *
+ * @example
+ * ```ts
+ * @Model(MongoModel)
+ * class MyClass {
+ *   @Repository(MongoModel)
+ *   private myRepo: MongoRepository<MongoModel>;
+ *
+ *   @Transactional()
+ *   public myFunc(obj: MongoModel, @MongoSession() session) {
+ *     await this.myRepo.save(obj, { session });
+ *   }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * class MyClass {
+ *   @Repository(MongoModel)
+ *   private myRepo: MongoRepository<MongoModel>;
+ *
+ *   @Repository(MongoModel2)
+ *   private myRepo2: MongoRepository<MongoModel2>;
+ *
+ *   @Transactional(MongoModel)
+ *   public myFunc(obj: MongoModel, @MongoSession() session) {
+ *     await this.myRepo.save(obj, { session });
+ *   }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * class MyClass {
+ *   @Repository(SQLModel)
+ *   private myRepo: Repository<SQLModel>;
+ *
+ *   @Transactional(SQLModel)
+ *   public myFunc(obj: SQLModel, @EntityManager() em) {
+ *     await em.save(obj);
+ *   }
+ * }
+ * ```
+ * @param source The name of the datasource or the class type that a transaction will be created for. If none specified,
+ * the source is inferred using `this.modelClass`.
+ * @param options The transcation options to pass to the underlying datasource connection.
+ */
+export function Transactional(source, options) {
+    return function (target, propertyKey, descriptor) {
+        const original = descriptor.value;
+        const argMetadata = Reflect.getMetadata("rrst:args", target, propertyKey);
+        descriptor.value = async function (...args) {
+            // Resolved into a local rather than reassigning the closed-over `source` param, which is shared by
+            // every invocation of this decorated method across every instance it's ever called on.
+            const resolvedSource = source ?? this.modelClass;
+            const datasource = typeof resolvedSource === "string" ? resolvedSource : resolvedSource?.datasource;
+            // Resolve the datasource directly from the ConnectionManager using `this._objectFactory`
+            // which ObjectFactory always injects into every object it manages.
+            const connectionManager = this._objectFactory?.getInstance(ConnectionManager);
+            const conn = datasource ? connectionManager?.connections.get(datasource) : undefined;
+            // Check if the connection supports transactions. If it doesn't we will fallback to the default
+            // (non-transactional) behavior. A log message warns the developer at startup about the missing
+            // transaction support.
+            const canUseMongoTransaction = conn instanceof MongoConnection && conn.supportsTransactions;
+            const canUseSqlTransaction = isSqlDataSource(conn) && typeof conn.transaction === "function";
+            if (!canUseMongoTransaction && !canUseSqlTransaction) {
+                // A connection WAS resolved for this call's own datasource but it doesn't support
+                // transactions. If an ambient context from an *different* datasource is active (e.g. this call
+                // is `acl`, nested inside an outer `mongodb` transaction), that context's session/entityManager
+                // belongs to a different connection and must not leak into this call.
+                const existingContext = transactionContext.getStore();
+                if (conn !== undefined && existingContext !== undefined && existingContext.datasource !== datasource) {
+                    return await transactionContext.run({ datasource }, () => original.apply(this, args));
+                }
+                return await original.apply(this, args);
+            }
+            // Injects the active session/entityManager into any @MongoSession/@EntityManager-decorated argument
+            // whose named datasource (if any) matches the one this call resolved above.
+            const injectContextArgs = (ctx) => {
+                for (const key in argMetadata) {
+                    const i = Number(key);
+                    const [kind, argDatasource] = argMetadata[i];
+                    if (argDatasource && argDatasource !== datasource) {
+                        continue;
+                    }
+                    if (kind === "mongoSession" && ctx.session !== undefined) {
+                        args[i] = ctx.session;
+                    }
+                    else if (kind === "entityManager" && ctx.entityManager !== undefined) {
+                        args[i] = ctx.entityManager;
+                    }
+                }
+            };
+            // Also check if @Transactional was already used earlier in the call stack. By default (i.e. when
+            // `options.mode` is omitted, or explicitly TransactionalMode.MERGE) that existing context is reused
+            // instead of opening a second, nested transaction of its own. Pass `{ mode: TransactionalMode.CREATE }`
+            // to always start a fresh transaction regardless of any outer one.
+            //
+            // Only merge when the existing context actually belongs to *this* call's resolved datasource — an
+            // outer @Transactional("datasourceA") whose context is still active when an inner call resolves
+            // "datasourceB" must not merge into it (that would silently run the inner call's writes against the
+            // wrong connection, or leave it non-transactional if the shapes don't line up). In that case fall
+            // through below and open a genuinely independent transaction for this call's own datasource instead.
+            const existingContext = transactionContext.getStore();
+            if (existingContext !== undefined &&
+                existingContext.datasource === datasource &&
+                options?.mode !== TransactionalMode.CREATE) {
+                injectContextArgs(existingContext);
+                return await original.apply(this, args);
+            }
+            let result = undefined;
+            if (canUseMongoTransaction) {
+                // Implement transactions according to the MongoDB docs:
+                // https://www.mongodb.com/docs/manual/core/transactions/?language-no-dependencies=nodejs
+                const session = conn.startSession(options?.driverOptions);
+                const onRollback = [];
+                try {
+                    // `withTransaction()` already aborts the transaction automatically if the callback throws
+                    // or its returned promise rejects, so no explicit `abortTransaction()` call is needed here
+                    // — and the error must be allowed to propagate to the caller rather than being swallowed.
+                    await session.withTransaction(async () => {
+                        injectContextArgs({ session });
+                        // Scope the session to this call's async context (see `transactionContext`) rather than
+                        // stashing it on `this`, which may be a singleton shared with concurrent, unrelated calls.
+                        result = await transactionContext.run({ session, datasource, onRollback }, () => original.apply(this, args));
+                    });
+                }
+                catch (err) {
+                    // Best-effort: undo whatever independently-committed side effects nested code registered
+                    // against this transaction (see `registerRollbackHook`) before propagating the failure.
+                    await Promise.allSettled(onRollback.map((hook) => hook()));
+                    throw err;
+                }
+                finally {
+                    await session.endSession();
+                }
+            }
+            else {
+                // Implement transaction according to the TypeORM docs:
+                // https://typeorm.io/docs/transactions/
+                // TODO Use QueryRunner instead
+                const onRollback = [];
+                try {
+                    await conn.transaction(async (entityManager) => {
+                        injectContextArgs({ entityManager });
+                        // Scope the entityManager to this call's async context (see `transactionContext`) rather
+                        // than stashing it on `this`, which may be a singleton shared with concurrent, unrelated
+                        // calls.
+                        result = await transactionContext.run({ entityManager, datasource, onRollback }, () => original.apply(this, args));
+                    });
+                }
+                catch (err) {
+                    await Promise.allSettled(onRollback.map((hook) => hook()));
+                    throw err;
+                }
+            }
+            return result;
+        };
+        // A plain `descriptor.value = async function (...) {}` assignment doesn't trigger JS's function-name
+        // inference (that only applies to identifier/object-literal-property assignment, not this kind of
+        // member expression), so the wrapper would otherwise have `.name === ""`. That breaks
+        // `RouteUtils.wrapMiddleware`, which looks up @Param/@Query/@User/etc. argument metadata via
+        // `Reflect.getMetadata("rrst:args", proto, func.name)` — losing the name silently drops every HTTP
+        // route handler's arguments the moment it's also decorated with `@Transactional`.
+        Object.defineProperty(descriptor.value, "name", { value: propertyKey, configurable: true });
+        return descriptor;
     };
 }
 //# sourceMappingURL=DatabaseDecorators.js.map

package/dist/lib/decorators/DatabaseDecorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatabaseDecorators.js","sourceRoot":"","sources":["../../../src/decorators/DatabaseDecorators.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAS;IACrC,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAS;IAChC,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"DatabaseDecorators.js","sourceRoot":"","sources":["../../../src/decorators/DatabaseDecorators.ts"],"names":[],"mappings":"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"}

package/dist/lib/decorators/DocDecorators.js

@@ -1,5 +1,6 @@
 ///////////////////////////////////////////////////////////////////////////////
 // Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
 ///////////////////////////////////////////////////////////////////////////////
 import "reflect-metadata";
 /**
@@ -10,8 +11,10 @@ import "reflect-metadata";
 export function Document(value) {
     return function (target, propertyKey) {
         const docs = {
-            ...(propertyKey ? Reflect.getMetadata("rrst:docs", target, propertyKey) : Reflect.getMetadata("rrst:docs", target)),
-            ...value
+            ...(propertyKey
+                ? Reflect.getMetadata("rrst:docs", target, propertyKey)
+                : Reflect.getMetadata("rrst:docs", target)),
+            ...value,
         };
         if (propertyKey) {
             Reflect.defineMetadata("rrst:docs", docs, target, propertyKey);
@@ -28,7 +31,7 @@ export function Document(value) {
  */
 export function Default(value) {
     return Document({
-        default: value
+        default: value,
     });
 }
 /**
@@ -38,7 +41,7 @@ export function Default(value) {
  */
 export function Description(value) {
     return Document({
-        description: value
+        description: value,
     });
 }
 /**
@@ -48,7 +51,7 @@ export function Description(value) {
  */
 export function Example(value) {
     return Document({
-        example: value
+        example: value,
     });
 }
 /**
@@ -58,7 +61,7 @@ export function Example(value) {
  */
 export function Format(value) {
     return Document({
-        format: value
+        format: value,
     });
 }
 /**
@@ -68,7 +71,7 @@ export function Format(value) {
  */
 export function Summary(value) {
     return Document({
-        summary: value
+        summary: value,
     });
 }
 /**
@@ -78,7 +81,7 @@ export function Summary(value) {
  */
 export function Tags(value) {
     return Document({
-        tags: value
+        tags: value,
     });
 }
 /**
@@ -99,6 +102,12 @@ export function Returns(types) {
         Reflect.defineMetadata("design:returntype", types !== undefined ? types : [designInfo], target, propertyKey);
     };
 }
+/**
+ * The metadata key that `@TypeInfo` stores its type information under. Kept distinct from `design:type` (the
+ * metadata TypeScript itself emits) so that other consumers of `design:type` — such as the `@Column` decorator's
+ * SQL type inference — are never affected by the richer, API-facing type description `@TypeInfo` provides.
+ */
+const TYPE_INFO_KEY = "rrst:typeInfo";
 /**
  * Stores runtime metadata about the typing information of a class property.
  *
@@ -114,7 +123,19 @@ export function TypeInfo(types) {
             // Make sure we always store an array
             types = Array.isArray(types) ? types : [types];
         }
-        Reflect.defineMetadata("design:type", types !== undefined ? types : [designInfo], target, propertyKey);
+        Reflect.defineMetadata(TYPE_INFO_KEY, types !== undefined ? types : [designInfo], target, propertyKey);
     };
 }
+/**
+ * Retrieves the typing information of a class property or function, preferring the richer description provided by
+ * `@TypeInfo` and falling back to TypeScript's own `design:type` reflection metadata when `@TypeInfo` was not
+ * applied.
+ *
+ * @param target The class prototype (or class, for static members) to retrieve type information for.
+ * @param propertyKey The name of the property or function to retrieve type information for.
+ */
+export function getTypeInfo(target, propertyKey) {
+    const typeInfo = Reflect.getMetadata(TYPE_INFO_KEY, target, propertyKey);
+    return typeInfo !== undefined ? typeInfo : Reflect.getMetadata("design:type", target, propertyKey);
+}
 //# sourceMappingURL=DocDecorators.js.map

package/dist/lib/decorators/DocDecorators.js.map

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

package/dist/lib/decorators/EventDecorators.js

@@ -1,5 +1,6 @@
 ///////////////////////////////////////////////////////////////////////////////
 // Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
 ///////////////////////////////////////////////////////////////////////////////
 import "reflect-metadata";
 /**

package/dist/lib/decorators/EventDecorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventDecorators.js","sourceRoot":"","sources":["../../../src/decorators/EventDecorators.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAC/E,OAAO,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAwB;IAC5C,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;QAC7E,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACnF,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,UAAU,MAAW;QACxB,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"EventDecorators.js","sourceRoot":"","sources":["../../../src/decorators/EventDecorators.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAwB;IAC5C,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;QAC7E,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACnF,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,UAAU,MAAW;QACxB,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC;AACN,CAAC"}

package/dist/lib/decorators/ModelDecorators.js

@@ -1,7 +1,9 @@
 ///////////////////////////////////////////////////////////////////////////////
 // Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
 ///////////////////////////////////////////////////////////////////////////////
 import "reflect-metadata";
+import { ACLAction } from "../security/AccessControlList.js";
 /**
  * The list of column registrations waiting to be bridged into TypeORM's metadata storage. This list is drained by
  * the TypeORM support module when a SQL connection is created.
@@ -23,7 +25,7 @@ export function Cache(ttl = 30) {
     };
 }
 /**
- * Indicates that a class is a child entity to some parent. Child entities will inherit all datastore configuration
+ * Indicates that a class is a child entity to some parent. Child entities will inherit all datasource configuration
  * of the parent, including cache settings.
  */
 export function ChildEntity() {
@@ -50,17 +52,17 @@ export function ChildEntity() {
     };
 }
 /**
- * Indicates that the class describes an entity that will be persisted in the datastore with the given name.
+ * Indicates that the class describes an entity that will be persisted in the datasource with the given name.
  *
- * @param datastore The name of the datastore to store records of the decorated class.
+ * @param datasource The name of the datasource to store records of the decorated class.
  */
-export function DataStore(datastore) {
+export function DataStore(datasource) {
     return function (target) {
-        Reflect.defineMetadata("rrst:datastore", datastore, target);
-        Object.defineProperty(target, "datastore", {
+        Reflect.defineMetadata("rrst:datasource", datasource, target);
+        Object.defineProperty(target, "datasource", {
             enumerable: true,
             writable: true,
-            value: datastore,
+            value: datasource,
         });
     };
 }
@@ -76,6 +78,23 @@ export function Identifier(target, propertyKey) {
         value: undefined,
     });
 }
+/**
+ * Apply this to a property that must never be settable by a client. `RepoUtils.create()`/`update()` strip any
+ * client-supplied value for a `@ReadOnly` property before persisting — the property's existing/declared-default
+ * value is kept instead, regardless of what the request body contains. Use this for fields that should only ever
+ * be changed by application/business logic (e.g. `roles`, ownership fields, computed/derived state).
+ */
+export function ReadOnly(target, propertyKey) {
+    Reflect.defineMetadata("rrst:readOnly", true, target, propertyKey);
+    // Class field initializers are compiled as own-instance assignments, so the property never otherwise
+    // appears on the prototype — forcing a placeholder onto the prototype (same technique @Identifier uses)
+    // is what makes it discoverable via Object.getOwnPropertyNames() in ModelUtils.getReadOnlyPropertyNames().
+    Object.defineProperty(target, propertyKey, {
+        enumerable: true,
+        writable: true,
+        value: undefined,
+    });
+}
 /**
  * Apply this to a model class to indicate that it should be protected by the AccessControlList security system.
  * The `classACL` parameter specifies the default ACL governing access to general operations against the model class
@@ -91,33 +110,30 @@ export function Protect(classACL = {
     records: [
         {
             userOrRoleId: "anonymous",
-            create: false,
-            read: true,
-            update: false,
-            delete: false,
-            special: false,
-            full: false,
+            actions: [ACLAction.COUNT, ACLAction.EXISTS, ACLAction.LIST, ACLAction.READ],
         },
         {
             userOrRoleId: ".*",
-            create: false,
-            read: true,
-            update: false,
-            delete: false,
-            special: false,
-            full: false,
+            actions: [ACLAction.COUNT, ACLAction.EXISTS, ACLAction.LIST, ACLAction.READ],
         },
     ],
 }, recordACL = false) {
     return function (target) {
-        if (!classACL.uid || classACL.uid === "<ClassName>") {
-            classACL.uid = target.name;
+        // Clone rather than mutate the caller-supplied ACL: applying @Protect(sharedAcl) to more than one class
+        // without an explicit `uid` must not let a later class's default uid overwrite an earlier class's `uid`
+        // on the very same shared object (classACL is stored by reference on each decorated class).
+        const resolvedACL = {
+            ...classACL,
+            records: classACL.records.map((record) => ({ ...record, actions: [...record.actions] })),
+        };
+        if (!resolvedACL.uid || resolvedACL.uid === "<ClassName>") {
+            resolvedACL.uid = target.name;
         }
-        Reflect.defineMetadata("rrst:classACL", classACL, target);
+        Reflect.defineMetadata("rrst:classACL", resolvedACL, target);
         Object.defineProperty(target, "classACL", {
             enumerable: true,
             writable: false,
-            value: classACL,
+            value: resolvedACL,
         });
         Reflect.defineMetadata("rrst:recordACL", recordACL, target);
         Object.defineProperty(target, "recordACL", {

package/dist/lib/decorators/ModelDecorators.js.map

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

package/dist/lib/decorators/PersistenceDecorators.js

@@ -1,5 +1,6 @@
 ///////////////////////////////////////////////////////////////////////////////
 // Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
 ///////////////////////////////////////////////////////////////////////////////
 import "reflect-metadata";
 import { snakeCase } from "../database/NamingUtils.js";
@@ -32,7 +33,7 @@ function collectOwnMetadata(key, target) {
     return results;
 }
 /**
- * Indicates that the decorated property will be persisted as a column/property in the datastore.
+ * Indicates that the decorated property will be persisted as a column/property in the datasource.
  *
  * @param options The options describing the column.
  */
@@ -47,7 +48,7 @@ export function Column(options = {}) {
     };
 }
 /**
- * Indicates that the decorated property is a primary key column in the datastore.
+ * Indicates that the decorated property is a primary key column in the datasource.
  *
  * @param options The options describing the column.
  */
@@ -100,7 +101,7 @@ export function Unique(nameOrFields, maybeFields) {
 }
 /* eslint-enable no-redeclare */
 /**
- * Indicates that the class describes an entity that is persisted to a datastore.
+ * Indicates that the class describes an entity that is persisted to a datasource.
  *
  * @param options The options to set.
  */