@zola_do/crud 0.2.2 → 0.2.4

package/dist/shared/types/crud-option.type.d.ts

@@ -1,4 +1,35 @@
 export type CrudContextPayload = Record<string, any>;
+export type CrudWherePayload = Record<string, any>;
+export type CrudEntityOperationHookName = 'create' | 'findAll' | 'findOne' | 'update' | 'delete' | 'restore';
+export type CrudAuthorizeResult = boolean | void | Promise<boolean | void>;
+export type CrudHookContext = {
+    req?: any;
+    params?: Record<string, any>;
+    query?: Record<string, any>;
+    id?: string;
+    itemData?: CrudContextPayload;
+    where?: CrudWherePayload;
+    entity?: CrudContextPayload;
+    result?: any;
+    operation: CrudEntityOperationHookName;
+    service?: any;
+    repository?: any;
+    setMeta?: (key: string, value: any) => void;
+    getMeta?: <T = any>(key: string) => T | undefined;
+};
+export type CrudOperationHook = (context: CrudHookContext) => void | Partial<CrudContextPayload> | {
+    itemData?: Partial<CrudContextPayload>;
+    where?: Partial<CrudWherePayload>;
+    result?: any;
+    entity?: Partial<CrudContextPayload>;
+} | Promise<void | Partial<CrudContextPayload> | {
+    itemData?: Partial<CrudContextPayload>;
+    where?: Partial<CrudWherePayload>;
+    result?: any;
+    entity?: Partial<CrudContextPayload>;
+}>;
+export type CrudAuthorizeHook = (context: CrudHookContext) => CrudAuthorizeResult;
+export type CrudOperationAuthorizeHook = (context: CrudHookContext) => CrudAuthorizeResult;
 export type CrudCreateContextHook = (params: {
     itemData: CrudContextPayload;
     req?: any;
@@ -17,6 +48,15 @@ export type CrudWriteFilterOptions = {
     allowedWriteFields?: string[];
     blockedWriteFields?: string[];
 };
+export type CrudDeleteMode = 'auto' | 'soft' | 'hard';
+export type CrudEndpointDisableMode = 'hide' | 'block';
+export type CrudEndpointDisableConfig = CrudEndpointDisableMode | {
+    mode: CrudEndpointDisableMode;
+    reason?: string;
+};
+export type CrudEntityOperationName = 'create' | 'findAll' | 'findOne' | 'update' | 'delete' | 'restore' | 'findAllArchived';
+export type CrudExtraOperationName = CrudEntityOperationName;
+export type CrudRelationOperationName = 'bulkSaveFirst' | 'bulkSaveSecond' | 'findAllFirst' | 'findAllSecond';
 export type EntityCrudOptions = {
     createDto?: {
         new (): NonNullable<unknown>;
@@ -34,14 +74,29 @@ export type EntityCrudOptions = {
     mapUpdateContext?: CrudUpdateContextHook;
     allowedWriteFields?: string[];
     blockedWriteFields?: string[];
-    beforeCreate?: CrudMutationHook;
-    afterCreate?: CrudMutationHook;
-    beforeUpdate?: CrudMutationHook;
-    afterUpdate?: CrudMutationHook;
+    beforeCreate?: CrudMutationHook | CrudOperationHook;
+    afterCreate?: CrudMutationHook | CrudOperationHook;
+    beforeFindAll?: CrudOperationHook;
+    afterFindAll?: CrudOperationHook;
+    beforeFindOne?: CrudOperationHook;
+    afterFindOne?: CrudOperationHook;
+    beforeUpdate?: CrudMutationHook | CrudOperationHook;
+    afterUpdate?: CrudMutationHook | CrudOperationHook;
+    beforeDelete?: CrudOperationHook;
+    afterDelete?: CrudOperationHook;
     beforeSoftDelete?: CrudMutationHook;
     afterSoftDelete?: CrudMutationHook;
-    beforeRestore?: CrudMutationHook;
-    afterRestore?: CrudMutationHook;
+    deleteMode?: CrudDeleteMode;
+    beforeRestore?: CrudMutationHook | CrudOperationHook;
+    afterRestore?: CrudMutationHook | CrudOperationHook;
+    authorize?: CrudAuthorizeHook;
+    canCreate?: CrudOperationAuthorizeHook;
+    canFindAll?: CrudOperationAuthorizeHook;
+    canFindOne?: CrudOperationAuthorizeHook;
+    canUpdate?: CrudOperationAuthorizeHook;
+    canDelete?: CrudOperationAuthorizeHook;
+    canRestore?: CrudOperationAuthorizeHook;
+    operations?: Partial<Record<CrudEntityOperationName, CrudEndpointDisableConfig>>;
 };
 export type ExtraCrudOptions = {
     entityIdName: string;
@@ -61,14 +116,29 @@ export type ExtraCrudOptions = {
     mapUpdateContext?: CrudUpdateContextHook;
     allowedWriteFields?: string[];
     blockedWriteFields?: string[];
-    beforeCreate?: CrudMutationHook;
-    afterCreate?: CrudMutationHook;
-    beforeUpdate?: CrudMutationHook;
-    afterUpdate?: CrudMutationHook;
+    beforeCreate?: CrudMutationHook | CrudOperationHook;
+    afterCreate?: CrudMutationHook | CrudOperationHook;
+    beforeFindAll?: CrudOperationHook;
+    afterFindAll?: CrudOperationHook;
+    beforeFindOne?: CrudOperationHook;
+    afterFindOne?: CrudOperationHook;
+    beforeUpdate?: CrudMutationHook | CrudOperationHook;
+    afterUpdate?: CrudMutationHook | CrudOperationHook;
+    beforeDelete?: CrudOperationHook;
+    afterDelete?: CrudOperationHook;
     beforeSoftDelete?: CrudMutationHook;
     afterSoftDelete?: CrudMutationHook;
-    beforeRestore?: CrudMutationHook;
-    afterRestore?: CrudMutationHook;
+    deleteMode?: CrudDeleteMode;
+    beforeRestore?: CrudMutationHook | CrudOperationHook;
+    afterRestore?: CrudMutationHook | CrudOperationHook;
+    authorize?: CrudAuthorizeHook;
+    canCreate?: CrudOperationAuthorizeHook;
+    canFindAll?: CrudOperationAuthorizeHook;
+    canFindOne?: CrudOperationAuthorizeHook;
+    canUpdate?: CrudOperationAuthorizeHook;
+    canDelete?: CrudOperationAuthorizeHook;
+    canRestore?: CrudOperationAuthorizeHook;
+    operations?: Partial<Record<CrudExtraOperationName, CrudEndpointDisableConfig>>;
 };
 export interface RelationCrudOptions {
     firstEntityIdName: string;
@@ -87,4 +157,5 @@ export interface RelationCrudOptions {
     afterAssignFirst?: CrudMutationHook;
     beforeAssignSecond?: CrudMutationHook;
     afterAssignSecond?: CrudMutationHook;
+    operations?: Partial<Record<CrudRelationOperationName, CrudEndpointDisableConfig>>;
 }

package/dist/shared/utils/crud-hooks.helper.d.ts

@@ -1,10 +1,39 @@
-import { CrudContextPayload, CrudWriteFilterOptions } from '../types';
-type HookName = 'beforeCreate' | 'afterCreate' | 'beforeUpdate' | 'afterUpdate' | 'beforeSoftDelete' | 'afterSoftDelete' | 'beforeRestore' | 'afterRestore' | 'beforeAssignFirst' | 'afterAssignFirst' | 'beforeAssignSecond' | 'afterAssignSecond';
+import { CollectionQuery } from '@zola_do/collection-query';
+import { CrudContextPayload, CrudEntityOperationHookName, CrudHookContext, CrudWherePayload, CrudWriteFilterOptions, EntityCrudOptions, ExtraCrudOptions } from '../types';
+import { CrudRequestContextResolver } from '../request-context';
+type HookName = 'beforeCreate' | 'afterCreate' | 'beforeFindAll' | 'afterFindAll' | 'beforeFindOne' | 'afterFindOne' | 'beforeUpdate' | 'afterUpdate' | 'beforeDelete' | 'afterDelete' | 'beforeSoftDelete' | 'afterSoftDelete' | 'beforeRestore' | 'afterRestore' | 'beforeAssignFirst' | 'afterAssignFirst' | 'beforeAssignSecond' | 'afterAssignSecond';
 export declare const runCrudHook: (options: Record<string, any> | undefined, hookName: HookName, params: {
     id?: string;
     itemData?: CrudContextPayload;
     entity?: CrudContextPayload;
     req?: any;
 }) => Promise<void>;
+type CreateOptions = EntityCrudOptions | ExtraCrudOptions | undefined;
+type EntityOptions = EntityCrudOptions | ExtraCrudOptions | undefined;
+export declare const createCrudHookContext: (params: {
+    operation: CrudEntityOperationHookName;
+    req?: any;
+    params?: Record<string, any>;
+    query?: Record<string, any>;
+    id?: string;
+    itemData?: CrudContextPayload;
+    where?: CrudWherePayload;
+    entity?: CrudContextPayload;
+    result?: any;
+    service?: any;
+    repository?: any;
+}) => CrudHookContext;
+export declare const runBeforeOperationHooks: (options: EntityOptions, context: CrudHookContext) => Promise<void>;
+export declare const runAfterOperationHooks: (options: EntityOptions, context: CrudHookContext) => Promise<void>;
+export declare const runOperationAuthorization: (options: EntityOptions, context: CrudHookContext) => Promise<void>;
+export declare const applyWhereToCollectionQuery: (query: CollectionQuery, where?: CrudWherePayload) => void;
+export declare const runBeforeCreatePipeline: (params: {
+    itemData: CrudContextPayload;
+    req?: any;
+    options?: CreateOptions;
+    resolver?: CrudRequestContextResolver;
+    service?: any;
+    repository?: any;
+}) => Promise<void>;
 export declare const sanitizeWritePayload: (itemData: CrudContextPayload, options?: CrudWriteFilterOptions) => CrudContextPayload;
 export {};

package/dist/shared/utils/crud-hooks.helper.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sanitizeWritePayload = exports.runCrudHook = void 0;
+exports.sanitizeWritePayload = exports.runBeforeCreatePipeline = exports.applyWhereToCollectionQuery = exports.runOperationAuthorization = exports.runAfterOperationHooks = exports.runBeforeOperationHooks = exports.createCrudHookContext = exports.runCrudHook = void 0;
 const common_1 = require("@nestjs/common");
+const collection_query_1 = require("@zola_do/collection-query");
+const request_context_1 = require("../request-context");
 const mergeHookResult = (payload, hookResult) => {
     if (!payload || !hookResult || typeof hookResult !== 'object') {
         return;
@@ -17,6 +19,175 @@ const runCrudHook = async (options, hookName, params) => {
     mergeHookResult(params.itemData, hookResult);
 };
 exports.runCrudHook = runCrudHook;
+const OPERATION_HOOK_NAMES = {
+    create: {
+        before: ['beforeCreate'],
+        after: ['afterCreate'],
+        can: 'canCreate',
+    },
+    findAll: {
+        before: ['beforeFindAll'],
+        after: ['afterFindAll'],
+        can: 'canFindAll',
+    },
+    findOne: {
+        before: ['beforeFindOne'],
+        after: ['afterFindOne'],
+        can: 'canFindOne',
+    },
+    update: {
+        before: ['beforeUpdate'],
+        after: ['afterUpdate'],
+        can: 'canUpdate',
+    },
+    delete: {
+        before: ['beforeSoftDelete', 'beforeDelete'],
+        after: ['afterSoftDelete', 'afterDelete'],
+        can: 'canDelete',
+    },
+    restore: {
+        before: ['beforeRestore'],
+        after: ['afterRestore'],
+        can: 'canRestore',
+    },
+};
+const hasOperationHookResultKeys = (value) => 'itemData' in value ||
+    'where' in value ||
+    'entity' in value ||
+    'result' in value;
+const mergeOperationHookResult = (context, hookResult) => {
+    if (!hookResult || typeof hookResult !== 'object') {
+        return;
+    }
+    const isOperationShape = hasOperationHookResultKeys(hookResult);
+    if (hookResult.itemData && context.itemData) {
+        Object.assign(context.itemData, hookResult.itemData);
+    }
+    if (hookResult.where) {
+        context.where = context.where || {};
+        Object.assign(context.where, hookResult.where);
+    }
+    if (hookResult.entity && context.entity) {
+        Object.assign(context.entity, hookResult.entity);
+    }
+    if ('result' in hookResult) {
+        context.result = hookResult.result;
+    }
+    if (isOperationShape) {
+        return;
+    }
+    if (context.itemData) {
+        Object.assign(context.itemData, hookResult);
+        return;
+    }
+    if (context.where) {
+        Object.assign(context.where, hookResult);
+        return;
+    }
+    if (context.entity) {
+        Object.assign(context.entity, hookResult);
+    }
+};
+const createCrudHookContext = (params) => {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const meta = new Map();
+    return {
+        operation: params.operation,
+        req: params.req,
+        params: (_c = (_a = params.params) !== null && _a !== void 0 ? _a : (_b = params.req) === null || _b === void 0 ? void 0 : _b.params) !== null && _c !== void 0 ? _c : {},
+        query: (_f = (_d = params.query) !== null && _d !== void 0 ? _d : (_e = params.req) === null || _e === void 0 ? void 0 : _e.query) !== null && _f !== void 0 ? _f : {},
+        id: params.id,
+        itemData: params.itemData,
+        where: (_g = params.where) !== null && _g !== void 0 ? _g : {},
+        entity: params.entity,
+        result: params.result,
+        service: params.service,
+        repository: params.repository,
+        setMeta: (key, value) => {
+            meta.set(key, value);
+        },
+        getMeta: (key) => meta.get(key),
+    };
+};
+exports.createCrudHookContext = createCrudHookContext;
+const runOperationHook = async (options, hookName, context) => {
+    const hook = options === null || options === void 0 ? void 0 : options[hookName];
+    if (!hook) {
+        return;
+    }
+    const hookResult = await hook(context);
+    mergeOperationHookResult(context, hookResult);
+};
+const runBeforeOperationHooks = async (options, context) => {
+    const hookNames = OPERATION_HOOK_NAMES[context.operation].before;
+    for (const hookName of hookNames) {
+        await runOperationHook(options, hookName, context);
+    }
+};
+exports.runBeforeOperationHooks = runBeforeOperationHooks;
+const runAfterOperationHooks = async (options, context) => {
+    const hookNames = OPERATION_HOOK_NAMES[context.operation].after;
+    for (const hookName of hookNames) {
+        await runOperationHook(options, hookName, context);
+    }
+};
+exports.runAfterOperationHooks = runAfterOperationHooks;
+const assertAuthorized = (allowed) => {
+    if (allowed === false) {
+        throw new common_1.ForbiddenException('crud_operation_forbidden');
+    }
+};
+const runOperationAuthorization = async (options, context) => {
+    const authorize = options === null || options === void 0 ? void 0 : options.authorize;
+    if (authorize) {
+        const allowed = await authorize(context);
+        assertAuthorized(allowed);
+    }
+    const canKey = OPERATION_HOOK_NAMES[context.operation].can;
+    const canHook = canKey
+        ? options === null || options === void 0 ? void 0 : options[canKey]
+        : undefined;
+    if (!canHook) {
+        return;
+    }
+    const allowed = await canHook(context);
+    assertAuthorized(allowed);
+};
+exports.runOperationAuthorization = runOperationAuthorization;
+const applyWhereToCollectionQuery = (query, where) => {
+    if (!where || typeof where !== 'object') {
+        return;
+    }
+    const whereEntries = Object.entries(where).filter(([, value]) => value !== undefined);
+    if (whereEntries.length === 0) {
+        return;
+    }
+    query.where = query.where || [];
+    query.where.push(whereEntries.map(([column, value]) => ({
+        column,
+        value,
+        operator: collection_query_1.FilterOperators.EqualTo,
+    })));
+};
+exports.applyWhereToCollectionQuery = applyWhereToCollectionQuery;
+const runBeforeCreatePipeline = async (params) => {
+    const { itemData, req, options, resolver, service, repository } = params;
+    await (0, request_context_1.applyCreateContext)({
+        itemData,
+        req,
+        options,
+        resolver,
+    });
+    const context = (0, exports.createCrudHookContext)({
+        operation: 'create',
+        req,
+        itemData,
+        service,
+        repository,
+    });
+    await (0, exports.runBeforeOperationHooks)(options, context);
+};
+exports.runBeforeCreatePipeline = runBeforeCreatePipeline;
 const hasAllowedFields = (allowedWriteFields) => Array.isArray(allowedWriteFields) && allowedWriteFields.length > 0;
 const sanitizeWritePayload = (itemData, options) => {
     if (!itemData || typeof itemData !== 'object') {

package/dist/shared/utils/crud-hooks.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"crud-hooks.helper.js","sourceRoot":"","sources":["../../../src/shared/utils/crud-hooks.helper.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAqBrD,MAAM,eAAe,GAAG,CACtB,OAAuC,EACvC,UAA8C,EAC9C,EAAE;IACF,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC,CAAC;AAEK,MAAM,WAAW,GAAG,KAAK,EAC9B,OAAwC,EACxC,QAAkB,EAClB,MAKC,EACD,EAAE;IACF,MAAM,IAAI,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,QAAQ,CAAiC,CAAC;IACjE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC,CAAC;AAjBW,QAAA,WAAW,eAiBtB;AAEF,MAAM,gBAAgB,GAAG,CAAC,kBAA6B,EAAE,EAAE,CACzD,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;AAE9D,MAAM,oBAAoB,GAAG,CAClC,QAA4B,EAC5B,OAAgC,EAChC,EAAE;IACF,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,4BAAmB,CAAC,iBAAiB,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,aAAa,qBAA4B,QAAQ,CAAE,CAAC;IAC1D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,kBAAkB,KAAI,EAAE,CAAC,CAAC;IAEtE,KAAK,MAAM,YAAY,IAAI,kBAAkB,EAAE,CAAC;QAC9C,OAAO,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,kBAAkB,CAAC,EAAE,CAAC;QACnD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,kBAAkB,KAAI,EAAE,CAAC,CAAC;IAEjE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AA5BW,QAAA,oBAAoB,wBA4B/B"}
+{"version":3,"file":"crud-hooks.helper.js","sourceRoot":"","sources":["../../../src/shared/utils/crud-hooks.helper.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils/cursor-query.helper.d.ts

@@ -0,0 +1,6 @@
+import { CollectionQuery } from '@zola_do/collection-query';
+export declare const mergeCursorQueryParams: (query: CollectionQuery, params: {
+    cursor?: string;
+    limit?: string;
+    direction?: string;
+}) => CollectionQuery;

package/dist/shared/utils/cursor-query.helper.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeCursorQueryParams = void 0;
+const common_1 = require("@nestjs/common");
+const parseLimit = (limit) => {
+    if (limit === undefined || limit === null || limit === '') {
+        return undefined;
+    }
+    const parsed = parseInt(limit, 10);
+    if (Number.isNaN(parsed) || parsed < 1) {
+        throw new common_1.BadRequestException('limit must be a positive integer');
+    }
+    return parsed;
+};
+const parseDirection = (direction) => {
+    if (!direction) {
+        return undefined;
+    }
+    if (direction === 'next' || direction === 'n') {
+        return 'n';
+    }
+    if (direction === 'prev' || direction === 'p') {
+        return 'p';
+    }
+    throw new common_1.BadRequestException('direction must be one of n, p, next, prev');
+};
+const mergeCursorQueryParams = (query, params) => {
+    const merged = Object.assign({}, query);
+    const hasPlainParams = params.cursor !== undefined ||
+        params.limit !== undefined ||
+        params.direction !== undefined;
+    if (params.cursor !== undefined) {
+        merged.cursor = params.cursor || undefined;
+    }
+    const parsedLimit = parseLimit(params.limit);
+    if (parsedLimit !== undefined) {
+        merged.take = parsedLimit;
+    }
+    const parsedDirection = parseDirection(params.direction);
+    if (parsedDirection !== undefined) {
+        merged.cursorDirection = parsedDirection;
+    }
+    if (hasPlainParams && !merged.cursorDirection) {
+        merged.cursorDirection = 'n';
+    }
+    return merged;
+};
+exports.mergeCursorQueryParams = mergeCursorQueryParams;
+//# sourceMappingURL=cursor-query.helper.js.map

package/dist/shared/utils/cursor-query.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-query.helper.js","sourceRoot":"","sources":["../../../src/shared/utils/cursor-query.helper.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAQrD,MAAM,UAAU,GAAG,CAAC,KAAc,EAAsB,EAAE;IACxD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,4BAAmB,CAAC,kCAAkC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,SAAkB,EACK,EAAE;IACzB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,IAAI,4BAAmB,CAAC,2CAA2C,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEK,MAAM,sBAAsB,GAAG,CACpC,KAAsB,EACtB,MAIC,EACgB,EAAE;IACnB,MAAM,MAAM,qBACP,KAAK,CACT,CAAC;IAEF,MAAM,cAAc,GAClB,MAAM,CAAC,MAAM,KAAK,SAAS;QAC3B,MAAM,CAAC,KAAK,KAAK,SAAS;QAC1B,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC;IAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC;IAC7C,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC;IAC3C,CAAC;IAED,IAAI,cAAc,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,MAAM,CAAC,eAAe,GAAG,GAAG,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AApCW,QAAA,sBAAsB,0BAoCjC"}

package/dist/shared/utils/index.d.ts

@@ -1,3 +1,4 @@
 export * from './numeric.transformer';
 export * from './validate-dto';
 export * from './crud-hooks.helper';
+export * from './cursor-query.helper';

package/dist/shared/utils/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./numeric.transformer"), exports);
 __exportStar(require("./validate-dto"), exports);
 __exportStar(require("./crud-hooks.helper"), exports);
+__exportStar(require("./cursor-query.helper"), exports);
 //# sourceMappingURL=index.js.map

package/dist/shared/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,iDAA+B;AAC/B,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,iDAA+B;AAC/B,sDAAoC;AACpC,wDAAsC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zola_do/crud",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Generic CRUD controllers and services for NestJS",
   "author": "zolaDO",
   "license": "ISC",
@@ -18,6 +18,31 @@
       "types": "./dist/index.d.ts",
       "require": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./controller": {
+      "types": "./dist/controller/index.d.ts",
+      "require": "./dist/controller/index.js",
+      "default": "./dist/controller/index.js"
+    },
+    "./service": {
+      "types": "./dist/service/index.d.ts",
+      "require": "./dist/service/index.js",
+      "default": "./dist/service/index.js"
+    },
+    "./repository": {
+      "types": "./dist/repository/index.d.ts",
+      "require": "./dist/repository/index.js",
+      "default": "./dist/repository/index.js"
+    },
+    "./request-context": {
+      "types": "./dist/request-context/index.d.ts",
+      "require": "./dist/request-context/index.js",
+      "default": "./dist/request-context/index.js"
+    },
+    "./optional/rpc": {
+      "types": "./dist/optional/rpc.d.ts",
+      "require": "./dist/optional/rpc.js",
+      "default": "./dist/optional/rpc.js"
     }
   },
   "files": [
@@ -32,6 +57,7 @@
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/microservices": "^10.0.0 || ^11.0.0",
     "@nestjs/swagger": "^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0",
     "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
     "class-validator": "^0.14.2 || ^0.15.1",
@@ -41,6 +67,9 @@
     "typeorm-extension": "^3.7.1"
   },
   "peerDependenciesMeta": {
+    "@nestjs/microservices": {
+      "optional": true
+    },
     "@nestjs/swagger": {
       "optional": true
     }