@elsikora/nestjs-crud-automator 1.16.0-dev.1 → 1.17.0-dev.1

package/dist/esm/type/class/api/subscriber/route/after/get/context.type.d.ts

@@ -1,4 +1,4 @@
 import type { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import type { IApiSubscriberRouteExecutionContextDataExtended } from '../../../../../../../interface/class/api/subscriber/route-execution-context-data.interface';
 import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route-execution-context.interface';
-export type TApiSubscriberRouteAfterGetContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E>>;
+export type TApiSubscriberRouteAfterGetContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>;

package/dist/esm/type/class/api/subscriber/route/after/get/list-context.type.d.ts

@@ -1,4 +1,5 @@
 import type { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import type { IApiSubscriberRouteExecutionContextDataExtended } from '../../../../../../../interface/class/api/subscriber/route-execution-context-data.interface';
 import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route-execution-context.interface';
-export type TApiSubscriberRouteAfterGetListContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, Array<E>, IApiSubscriberRouteExecutionContextDataExtended<E>>;
+import type { IApiGetListResponseResult } from '../../../../../../../interface/decorator/api/get-list-response-result.interface';
+export type TApiSubscriberRouteAfterGetListContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, IApiGetListResponseResult<E>, IApiSubscriberRouteExecutionContextDataExtended<E, IApiGetListResponseResult<E>>>;

package/dist/esm/type/class/api/subscriber/route/after/get/many-context.type.d.ts

@@ -1,4 +1,4 @@
 import type { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import type { IApiSubscriberRouteExecutionContextDataExtended } from '../../../../../../../interface/class/api/subscriber/route-execution-context-data.interface';
 import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route-execution-context.interface';
-export type TApiSubscriberRouteAfterGetManyContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, Array<E>, IApiSubscriberRouteExecutionContextDataExtended<E>>;
+export type TApiSubscriberRouteAfterGetManyContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, Array<E>, IApiSubscriberRouteExecutionContextDataExtended<E, Array<E>>>;

package/dist/esm/type/class/api/subscriber/route/after/update-context.type.d.ts

@@ -1,4 +1,4 @@
 import type { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import type { IApiSubscriberRouteExecutionContextDataExtended } from '../../../../../../interface/class/api/subscriber/route-execution-context-data.interface';
 import type { IApiSubscriberRouteExecutionContext } from '../../../../../../interface/class/api/subscriber/route-execution-context.interface';
-export type TApiSubscriberRouteAfterUpdateContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E>>;
+export type TApiSubscriberRouteAfterUpdateContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>;

package/dist/esm/type/index.d.ts

@@ -1,5 +1,6 @@
 export { type TApiRequestTransformer } from './api-request-transformer.type';
 export type * from './class/index';
+export type * from './class/api/authorization/index';
 export type * from './decorator/api/controller/index';
 export type * from './decorator/api/filter/index';
 export type * from './decorator/api/function/index';

package/dist/esm/utility/api/controller/apply-metadata.utility.js

@@ -74,11 +74,9 @@ function ApiControllerApplyMetadata(target, targetPrototype, entity, properties,
     routeArgumentsMetadata = assignMetadata(routeArgumentsMetadata, RouteParamtypes.IP, parameterIndex);
     parameterTypes.push(Object);
     parameterIndex++;
-    if (routeConfig.authentication) {
-        routeArgumentsMetadata = assignMetadata(routeArgumentsMetadata, RouteParamtypes.REQUEST, parameterIndex);
-        parameterTypes.push(Object);
-        parameterIndex++;
-    }
+    routeArgumentsMetadata = assignMetadata(routeArgumentsMetadata, RouteParamtypes.REQUEST, parameterIndex);
+    parameterTypes.push(Object);
+    parameterIndex++;
     Reflect.defineMetadata(ROUTE_ARGS_METADATA, routeArgumentsMetadata, target, methodName);
     Reflect.defineMetadata(PARAMTYPES_METADATA, parameterTypes, targetPrototype, methodName);
 }

package/dist/esm/utility/api/controller/apply-metadata.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply-metadata.utility.js","sources":["../../../../../../src/utility/api/controller/apply-metadata.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA;;;;;;;;;;;;AAYG;AACG,SAAU,0BAA0B,CAAI,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAA;IAC7P,IAAI,cAAc,GAAW,CAAC;IAC9B,IAAI,sBAAsB,GAAY,EAAE;IACxC,MAAM,cAAc,GAAmB,EAAE;AAEzC,IAAA,MAAM,UAAU,GAA8B,WAAW,CAAC,GAAG,EAAE,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AAC5N,IAAA,MAAM,QAAQ,GAA8B,WAAW,CAAC,GAAG,EAAE,KAAK,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AACpN,IAAA,MAAM,OAAO,GAA8B,WAAW,CAAC,GAAG,EAAE,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;IAEhN,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;AAC/B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,QAAQ,EAAE;QACb,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,OAAO,EAAE;QACZ,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC;AACrG,QAAA,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AAC5B,QAAA,cAAc,EAAE;IACjB;IAEA,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;AAEhB,IAAA,IAAI,WAAW,CAAC,cAAc,EAAE;QAC/B,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,QAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,QAAA,cAAc,EAAE;IACjB;IAEA,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;AACzF;;;;"}
+{"version":3,"file":"apply-metadata.utility.js","sources":["../../../../../../src/utility/api/controller/apply-metadata.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA;;;;;;;;;;;;AAYG;AACG,SAAU,0BAA0B,CAAI,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAA;IAC7P,IAAI,cAAc,GAAW,CAAC;IAC9B,IAAI,sBAAsB,GAAY,EAAE;IACxC,MAAM,cAAc,GAAmB,EAAE;AAEzC,IAAA,MAAM,UAAU,GAA8B,WAAW,CAAC,GAAG,EAAE,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AAC5N,IAAA,MAAM,QAAQ,GAA8B,WAAW,CAAC,GAAG,EAAE,KAAK,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AACpN,IAAA,MAAM,OAAO,GAA8B,WAAW,CAAC,GAAG,EAAE,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;IAEhN,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;AAC/B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,QAAQ,EAAE;QACb,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,OAAO,EAAE;QACZ,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC;AACrG,QAAA,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AAC5B,QAAA,cAAc,EAAE;IACjB;IAEA,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;AACzF;;;;"}

package/dist/esm/utility/authorization/decision/apply-result.utility.d.ts

@@ -0,0 +1,12 @@
+import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
+import type { IApiAuthorizationDecision } from '../../../interface/authorization/index';
+import type { TApiAuthorizationRuleTransformPayload } from '../../../type/class/api/authorization/rule/transform-payload.type';
+/**
+ * Applies decision result transforms sequentially to a response payload.
+ * @template E - Entity type
+ * @template R - Result payload type
+ * @param {IApiAuthorizationDecision<E, R> | undefined} decision - Evaluated decision.
+ * @param {R} result - Result to transform.
+ * @returns {Promise<R>} Transformed payload.
+ */
+export declare function AuthorizationDecisionApplyResult<E extends IApiBaseEntity, R extends TApiAuthorizationRuleTransformPayload<E>>(decision: IApiAuthorizationDecision<E, R> | undefined, result: R): Promise<R>;

package/dist/esm/utility/authorization/decision/apply-result.utility.js

@@ -0,0 +1,25 @@
+/**
+ * Applies decision result transforms sequentially to a response payload.
+ * @template E - Entity type
+ * @template R - Result payload type
+ * @param {IApiAuthorizationDecision<E, R> | undefined} decision - Evaluated decision.
+ * @param {R} result - Result to transform.
+ * @returns {Promise<R>} Transformed payload.
+ */
+async function AuthorizationDecisionApplyResult(decision, result) {
+    if (!decision?.transforms.length) {
+        return result;
+    }
+    let transformedResult = result;
+    const context = {
+        resource: decision.resource,
+        subject: decision.subject,
+    };
+    for (const transform of decision.transforms) {
+        transformedResult = await transform(transformedResult, context);
+    }
+    return transformedResult;
+}
+
+export { AuthorizationDecisionApplyResult };
+//# sourceMappingURL=apply-result.utility.js.map

package/dist/esm/utility/authorization/decision/apply-result.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-result.utility.js","sources":["../../../../../../src/utility/authorization/decision/apply-result.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAKA;;;;;;;AAOG;AACI,eAAe,gCAAgC,CAA+E,QAAqD,EAAE,MAAS,EAAA;AACpM,IAAA,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,EAAE;AACjC,QAAA,OAAO,MAAM;IACd;IAEA,IAAI,iBAAiB,GAAM,MAAM;AAEjC,IAAA,MAAM,OAAO,GAAoC;QAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;KACzB;AAED,IAAA,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE;QAC5C,iBAAiB,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAChE;AAEA,IAAA,OAAO,iBAAiB;AACzB;;;;"}

package/dist/esm/utility/authorization/decision/attach-resource.utility.d.ts

@@ -0,0 +1,11 @@
+import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
+import type { IApiAuthorizationDecision } from '../../../interface/authorization/index';
+/**
+ * Mutates authorization decision to include the resolved entity resource.
+ * @template E - Entity type
+ * @template R - Result payload type
+ * @param {IApiAuthorizationDecision<E, R> | undefined} decision - Decision to enrich.
+ * @param {E | undefined} resource - Entity instance to attach.
+ * @returns {IApiAuthorizationDecision<E, R> | undefined} Updated decision reference.
+ */
+export declare function AuthorizationDecisionAttachResource<E extends IApiBaseEntity, R>(decision: IApiAuthorizationDecision<E, R> | undefined, resource: E | undefined): IApiAuthorizationDecision<E, R> | undefined;

package/dist/esm/utility/authorization/decision/attach-resource.utility.js

@@ -0,0 +1,18 @@
+/**
+ * Mutates authorization decision to include the resolved entity resource.
+ * @template E - Entity type
+ * @template R - Result payload type
+ * @param {IApiAuthorizationDecision<E, R> | undefined} decision - Decision to enrich.
+ * @param {E | undefined} resource - Entity instance to attach.
+ * @returns {IApiAuthorizationDecision<E, R> | undefined} Updated decision reference.
+ */
+function AuthorizationDecisionAttachResource(decision, resource) {
+    if (!decision || resource === undefined) {
+        return decision;
+    }
+    decision.resource = resource;
+    return decision;
+}
+
+export { AuthorizationDecisionAttachResource };
+//# sourceMappingURL=attach-resource.utility.js.map

package/dist/esm/utility/authorization/decision/attach-resource.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-resource.utility.js","sources":["../../../../../../src/utility/authorization/decision/attach-resource.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;;;;AAOG;AACG,SAAU,mCAAmC,CAA8B,QAAqD,EAAE,QAAuB,EAAA;AAC9J,IAAA,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE;AACxC,QAAA,OAAO,QAAQ;IAChB;AAEA,IAAA,QAAQ,CAAC,QAAQ,GAAG,QAAQ;AAE5B,IAAA,OAAO,QAAQ;AAChB;;;;"}

package/dist/esm/utility/authorization/decision/index.d.ts

@@ -0,0 +1,3 @@
+export { AuthorizationDecisionApplyResult } from './apply-result.utility';
+export { AuthorizationDecisionAttachResource } from './attach-resource.utility';
+export { AuthorizationDecisionResolveFromRequest } from './resolve-from-request.utility';

package/dist/esm/utility/authorization/decision/resolve-from-request.utility.d.ts

@@ -0,0 +1,12 @@
+import type { IApiAuthenticationRequest } from '../../../interface/api-authentication-request.interface';
+import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
+import type { IApiAuthorizationDecision } from '../../../interface/authorization/decision.interface';
+import type { TApiAuthorizationRuleTransformPayload } from '../../../type/class/api/authorization/rule/transform-payload.type';
+/**
+ * Extracts an authorization decision from the authentication request metadata stored on the HTTP request.
+ * @template E - Entity type
+ * @template R - Result payload type
+ * @param {IApiAuthenticationRequest} [authenticationRequest] - Request object bound to the route handler.
+ * @returns {IApiAuthorizationDecision<E, R> | undefined} Authorization decision if present.
+ */
+export declare function AuthorizationDecisionResolveFromRequest<E extends IApiBaseEntity, R extends TApiAuthorizationRuleTransformPayload<E> = TApiAuthorizationRuleTransformPayload<E>>(authenticationRequest?: IApiAuthenticationRequest): IApiAuthorizationDecision<E, R> | undefined;

package/dist/esm/utility/authorization/decision/resolve-from-request.utility.js

@@ -0,0 +1,20 @@
+import { AUTHORIZATION_DECISION_METADATA_CONSTANT } from '../../../constant/authorization/metadata/decision.constant.js';
+
+/**
+ * Extracts an authorization decision from the authentication request metadata stored on the HTTP request.
+ * @template E - Entity type
+ * @template R - Result payload type
+ * @param {IApiAuthenticationRequest} [authenticationRequest] - Request object bound to the route handler.
+ * @returns {IApiAuthorizationDecision<E, R> | undefined} Authorization decision if present.
+ */
+function AuthorizationDecisionResolveFromRequest(authenticationRequest) {
+    if (!authenticationRequest) {
+        return undefined;
+    }
+    const requestRecord = authenticationRequest;
+    const decision = requestRecord[AUTHORIZATION_DECISION_METADATA_CONSTANT.REQUEST_KEY] ?? requestRecord.authorizationDecision;
+    return decision;
+}
+
+export { AuthorizationDecisionResolveFromRequest };
+//# sourceMappingURL=resolve-from-request.utility.js.map

package/dist/esm/utility/authorization/decision/resolve-from-request.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-from-request.utility.js","sources":["../../../../../../src/utility/authorization/decision/resolve-from-request.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA;;;;;;AAMG;AACG,SAAU,uCAAuC,CAA0H,qBAAiD,EAAA;IACjO,IAAI,CAAC,qBAAqB,EAAE;AAC3B,QAAA,OAAO,SAAS;IACjB;IAEA,MAAM,aAAa,GAA4B,qBAA2D;AAC1G,IAAA,MAAM,QAAQ,GAAY,aAAa,CAAC,wCAAwC,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,qBAAqB;AAEpI,IAAA,OAAO,QAAuD;AAC/D;;;;"}

package/dist/esm/utility/authorization/index.d.ts

@@ -0,0 +1,3 @@
+export * from './decision/index';
+export * from './scope/index';
+export * from './subject/index';

package/dist/esm/utility/authorization/scope/index.d.ts

@@ -0,0 +1 @@
+export * from './merge/index';

package/dist/esm/utility/authorization/scope/merge/index.d.ts

@@ -0,0 +1 @@
+export { AuthorizationScopeMergeWhere } from './where.utility';

package/dist/esm/utility/authorization/scope/merge/where.utility.d.ts

@@ -0,0 +1,10 @@
+import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import type { TApiAuthorizationScopeWhere } from '../../../../type/class/api/authorization/scope-where.type';
+/**
+ * Merges two WHERE expressions by building a Cartesian product of OR branches.
+ * @template E - Entity type
+ * @param {TApiAuthorizationScopeWhere<E>} baseWhere - Existing filter.
+ * @param {TApiAuthorizationScopeWhere<E>} scopedWhere - Additional scope filter.
+ * @returns {TApiAuthorizationScopeWhere<E>} Combined filter.
+ */
+export declare function AuthorizationScopeMergeWhere<E extends IApiBaseEntity>(baseWhere: TApiAuthorizationScopeWhere<E>, scopedWhere: TApiAuthorizationScopeWhere<E>): TApiAuthorizationScopeWhere<E>;

package/dist/esm/utility/authorization/scope/merge/where.utility.js

@@ -0,0 +1,30 @@
+/**
+ * Merges two WHERE expressions by building a Cartesian product of OR branches.
+ * @template E - Entity type
+ * @param {TApiAuthorizationScopeWhere<E>} baseWhere - Existing filter.
+ * @param {TApiAuthorizationScopeWhere<E>} scopedWhere - Additional scope filter.
+ * @returns {TApiAuthorizationScopeWhere<E>} Combined filter.
+ */
+function AuthorizationScopeMergeWhere(baseWhere, scopedWhere) {
+    if (!baseWhere) {
+        return scopedWhere;
+    }
+    if (!scopedWhere) {
+        return baseWhere;
+    }
+    const baseVariants = Array.isArray(baseWhere) ? baseWhere : [baseWhere];
+    const scopedVariants = Array.isArray(scopedWhere) ? scopedWhere : [scopedWhere];
+    const mergedVariants = [];
+    for (const baseVariant of baseVariants) {
+        for (const scopedVariant of scopedVariants) {
+            mergedVariants.push({
+                ...baseVariant,
+                ...scopedVariant,
+            });
+        }
+    }
+    return mergedVariants.length === 1 ? mergedVariants[0] : mergedVariants;
+}
+
+export { AuthorizationScopeMergeWhere };
+//# sourceMappingURL=where.utility.js.map

package/dist/esm/utility/authorization/scope/merge/where.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.utility.js","sources":["../../../../../../../src/utility/authorization/scope/merge/where.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAIA;;;;;;AAMG;AACG,SAAU,4BAA4B,CAA2B,SAAyC,EAAE,WAA2C,EAAA;IAC5J,IAAI,CAAC,SAAS,EAAE;AACf,QAAA,OAAO,WAAW;IACnB;IAEA,IAAI,CAAC,WAAW,EAAE;AACjB,QAAA,OAAO,SAAS;IACjB;AAEA,IAAA,MAAM,YAAY,GAA+B,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,CAAC,SAAS,CAAC;AACnG,IAAA,MAAM,cAAc,GAA+B,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,CAAC,WAAW,CAAC;IAC3G,MAAM,cAAc,GAA+B,EAAE;AAErD,IAAA,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;AACvC,QAAA,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;YAC3C,cAAc,CAAC,IAAI,CAAC;AACnB,gBAAA,GAAG,WAAW;AACd,gBAAA,GAAG,aAAa;AAChB,aAAA,CAAC;QACH;IACD;AAEA,IAAA,OAAO,cAAc,CAAC,MAAM,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc;AACxE;;;;"}

package/dist/esm/utility/authorization/subject/index.d.ts

@@ -0,0 +1 @@
+export { AuthorizationResolveDefaultSubject } from './resolve-default-subject.utility';

package/dist/esm/utility/authorization/subject/resolve-default-subject.utility.d.ts

@@ -0,0 +1,7 @@
+import type { IApiAuthorizationSubject } from '../../../interface/authorization/subject.interface';
+/**
+ * Resolves a subject from request.user with smart fallbacks.
+ * @param {unknown} user - Request user payload.
+ * @returns {IApiAuthorizationSubject} Normalized authorization subject.
+ */
+export declare function AuthorizationResolveDefaultSubject(user: unknown): IApiAuthorizationSubject;

package/dist/esm/utility/authorization/subject/resolve-default-subject.utility.js

@@ -0,0 +1,50 @@
+/**
+ * Resolves a subject from request.user with smart fallbacks.
+ * @param {unknown} user - Request user payload.
+ * @returns {IApiAuthorizationSubject} Normalized authorization subject.
+ */
+function AuthorizationResolveDefaultSubject(user) {
+    const baseSubject = {
+        attributes: {},
+        id: "anonymous",
+        permissions: [],
+        roles: [],
+    };
+    if (!user || typeof user !== "object") {
+        return baseSubject;
+    }
+    const record = user;
+    const idFields = ["id", "uuid", "email"];
+    for (const field of idFields) {
+        const value = record[field];
+        if (typeof value === "string" && value.length > 0) {
+            baseSubject.id = value;
+            break;
+        }
+    }
+    baseSubject.roles = resolveStringArray(record, ["roles", "role"]);
+    baseSubject.permissions = resolveStringArray(record, ["permissions", "permission"]);
+    baseSubject.attributes = record;
+    return baseSubject;
+}
+/**
+ * Resolves the first string array found in the provided record for the given field candidates.
+ * @param {Record<string, unknown>} record - Object containing candidate fields.
+ * @param {Array<string>} fields - Candidate field names to inspect in order.
+ * @returns {Array<string>} Normalized array of string values.
+ */
+function resolveStringArray(record, fields) {
+    for (const field of fields) {
+        const value = record[field];
+        if (typeof value === "string") {
+            return [value];
+        }
+        if (Array.isArray(value)) {
+            return value.filter((item) => typeof item === "string");
+        }
+    }
+    return [];
+}
+
+export { AuthorizationResolveDefaultSubject };
+//# sourceMappingURL=resolve-default-subject.utility.js.map

package/dist/esm/utility/authorization/subject/resolve-default-subject.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-default-subject.utility.js","sources":["../../../../../../src/utility/authorization/subject/resolve-default-subject.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;AAIG;AACG,SAAU,kCAAkC,CAAC,IAAa,EAAA;AAC/D,IAAA,MAAM,WAAW,GAA6B;AAC7C,QAAA,UAAU,EAAE,EAAE;AACd,QAAA,EAAE,EAAE,WAAW;AACf,QAAA,WAAW,EAAE,EAAE;AACf,QAAA,KAAK,EAAE,EAAE;KACT;IAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACtC,QAAA,OAAO,WAAW;IACnB;IAEA,MAAM,MAAM,GAA4B,IAA+B;IACvE,MAAM,QAAQ,GAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;AAEvD,IAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC7B,QAAA,MAAM,KAAK,GAAY,MAAM,CAAC,KAAK,CAAC;QAEpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;AAClD,YAAA,WAAW,CAAC,EAAE,GAAG,KAAK;YAEtB;QACD;IACD;AAEA,IAAA,WAAW,CAAC,KAAK,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACjE,IAAA,WAAW,CAAC,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACnF,IAAA,WAAW,CAAC,UAAU,GAAG,MAAM;AAE/B,IAAA,OAAO,WAAW;AACnB;AAEA;;;;;AAKG;AACH,SAAS,kBAAkB,CAAC,MAA+B,EAAE,MAAqB,EAAA;AACjF,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC3B,QAAA,MAAM,KAAK,GAAY,MAAM,CAAC,KAAK,CAAC;AAEpC,QAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC;QACf;AAEA,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACzB,YAAA,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAa,KAAqB,OAAO,IAAI,KAAK,QAAQ,CAAC;QACjF;IACD;AAEA,IAAA,OAAO,EAAE;AACV;;;;"}

package/dist/esm/utility/index.d.ts

@@ -1,4 +1,5 @@
 export * from './api/index';
+export * from './authorization/index';
 export { CamelCaseString } from './camel-case-string.utility';
 export { CapitalizeString } from './capitalize-string.utility';
 export * from './dto/index';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsikora/nestjs-crud-automator",
-	"version": "1.16.0-dev.1",
+	"version": "1.17.0-dev.1",
 	"description": "A library for automating the creation of CRUD operations in NestJS.",
 	"keywords": [
 		"NestJS",

package/dist/cjs/module/api-subscriber.module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-subscriber.module.js","sources":["../../../../src/module/api-subscriber.module.ts"],"sourcesContent":[null],"names":["ApiSubscriberModule","__decorate","Module","ApiSubscriberDiscoveryService","DiscoveryModule"],"mappings":";;;;;;;AAIA;;;;;AAKG;AAMUA,2BAAmB,GAAzB,MAAM,mBAAmB,CAAA;;AAAnBA,2BAAmB,GAAAC,oBAAA,CAAA;AAL/B,IAAAC,aAAM,CAAC;QACP,OAAO,EAAE,CAACC,oDAA6B,CAAC;QACxC,OAAO,EAAE,CAACC,oBAAe,CAAC;QAC1B,SAAS,EAAE,CAACD,oDAA6B,CAAC;KAC1C;AACY,CAAA,EAAAH,2BAAmB,CAAG;;"}

package/dist/esm/module/api-subscriber.module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-subscriber.module.js","sources":["../../../../src/module/api-subscriber.module.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAIA;;;;;AAKG;AAMI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB,CAAA;;AAAnB,mBAAmB,GAAA,UAAA,CAAA;AAL/B,IAAA,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,6BAA6B,CAAC;QACxC,OAAO,EAAE,CAAC,eAAe,CAAC;QAC1B,SAAS,EAAE,CAAC,6BAA6B,CAAC;KAC1C;AACY,CAAA,EAAA,mBAAmB,CAAG;;;;"}