@maioradv/nestjs-core 2.0.4 → 2.0.6

package/README.md

@@ -1,8 +1,8 @@
-```
-# build
-$ yarn build
-
-# publish
-$ npm publish --access public
-
+```
+# build
+$ yarn build
+
+# publish
+$ npm publish --access public
+
 ```

package/dist/dto/clauses/index.d.ts

@@ -1,2 +1,3 @@
 export * from './standard-clauses.decorator';
 export * from './model';
+export * from './special-clauses.decorator';

package/dist/dto/clauses/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./standard-clauses.decorator"), exports);
 __exportStar(require("./model"), exports);
+__exportStar(require("./special-clauses.decorator"), exports);

package/dist/dto/clauses/special-clauses.decorator.d.ts

@@ -0,0 +1,5 @@
+export declare class MetafieldClauseDto {
+    key: string;
+    value: string;
+}
+export declare const IsMetafieldClause: () => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/dist/dto/clauses/special-clauses.decorator.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsMetafieldClause = exports.MetafieldClauseDto = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class MetafieldClauseDto {
+}
+exports.MetafieldClauseDto = MetafieldClauseDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], MetafieldClauseDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], MetafieldClauseDto.prototype, "value", void 0);
+const IsMetafieldClause = () => {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({
+        description: 'A key:value couple or a comma-separated list of couples. Format: key1:value1,key2:value2'
+    }), (0, class_transformer_1.Transform)(({ value }) => value.split(',').map(pair => {
+        const [key, value] = pair.split(':');
+        return { key: key.trim(), value: value.trim() };
+    })), (0, class_validator_1.IsOptional)(), (0, class_validator_1.IsArray)(), (0, class_validator_1.ValidateNested)({ each: true }), (0, class_transformer_1.Type)(() => MetafieldClauseDto));
+};
+exports.IsMetafieldClause = IsMetafieldClause;

package/dist/guards/resource.guard.d.ts

@@ -14,7 +14,9 @@ export type ResourceGuardOptions = {
     shutdownFn?: () => Promise<void>;
     /** Optional NestJS LoggerService to use for logging. */
     logger?: LoggerService;
-    /** Optional peak logging options: log when CPU/memory exceed thresholds for a sustained period. Default sustain: 3000ms */
+    /** If true, logs each check with CPU/memory usage. Default: false */
+    debug?: boolean;
+    /** Optional peak logging options: log when CPU/memory exceed thresholds for a sustained period. Default sustain: 5000ms */
     logPeaks?: {
         cpuThreshold?: number;
         memoryThresholdMb?: number;

package/dist/guards/resource.guard.js

@@ -14,7 +14,7 @@ class ResourceGuard {
         this.opts.sustainForMs ??= 10000;
         this.opts.hardKillAfterMs ??= 5000;
         if (this.opts.logPeaks) {
-            this.opts.logPeaks.sustainMs ??= 3000;
+            this.opts.logPeaks.sustainMs ??= 5000;
         }
     }
     /** Start monitoring CPU and memory */
@@ -47,6 +47,15 @@ class ResourceGuard {
             if (this.opts.memoryLimitMb && currentMemMb > this.opts.memoryLimitMb)
                 over = true;
         }
+        if (this.opts.debug) {
+            const cpuMsg = this.opts.cpuLimit ? `CPU: ${currentCpuPercent?.toFixed(1)}%;` : '';
+            const memMsg = this.opts.memoryLimitMb ? `MEM: ${currentMemMb?.toFixed(0)}MB;` : '';
+            const msg = `${cpuMsg}${memMsg}`;
+            if (this.opts.logger)
+                this.opts.logger.debug(`${msg}`);
+            else
+                console.debug(`${msg}`);
+        }
         this.lastTime = nowTime;
         if (over) {
             if (!this.overSince)

package/package.json

@@ -1,78 +1,78 @@
-{
-  "name": "@maioradv/nestjs-core",
-  "version": "2.0.4",
-  "description": "NestJS helpers by MaiorADV",
-  "repository": "https://github.com/maioradv/nestjs-core.git",
-  "author": "Maior ADV Srl",
-  "license": "MIT",
-  "private": false,
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "/dist"
-  ],
-  "scripts": {
-    "example": "ts-node example/test.ts",
-    "build": "tsc",
-    "publish:npm": "npm publish --access public"
-  },
-  "dependencies": {
-    "@aws-sdk/client-s3": "^3.899.0",
-    "@maioradv/accounts-lib": "^1.3.3",
-    "@nestjs/cache-manager": "^3.0.1",
-    "@nestjs/common": "^11.1.6",
-    "@nestjs/config": "^4.0.2",
-    "@nestjs/graphql": "^13.2.0",
-    "@nestjs/platform-express": "^11.1.6",
-    "@nestjs/swagger": "^11.2.0",
-    "@nestjs/throttler": "^6.4.0",
-    "@sentry/nestjs": "^10.17.0",
-    "bcrypt": "^6.0.0",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.2",
-    "file-type": "^21.0.0",
-    "handlebars": "^4.7.8",
-    "image-size": "^2.0.2",
-    "nest-winston": "^1.10.2",
-    "nodemailer": "^7.0.6",
-    "request-ip": "^3.3.0",
-    "sharp": "^0.34.4",
-    "winston": "^3.18.3",
-    "winston-daily-rotate-file": "^5.0.0"
-  },
-  "devDependencies": {
-    "@types/multer": "^2.0.0",
-    "@types/node": "^24.6.1",
-    "@types/nodemailer": "^7.0.2",
-    "@types/request-ip": "^0.0.41",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
-  },
-  "peerDependencies": {
-    "@aws-sdk/client-s3": "^3.899.0",
-    "@maioradv/accounts-lib": "^1.3.3",
-    "@nestjs/cache-manager": "^3.0.1",
-    "@nestjs/common": "^11.1.6",
-    "@nestjs/config": "^4.0.2",
-    "@nestjs/graphql": "^13.2.0",
-    "@nestjs/platform-express": "^11.1.6",
-    "@nestjs/swagger": "^11.2.0",
-    "@nestjs/throttler": "^6.4.0",
-    "@sentry/nestjs": "^10.17.0",
-    "bcrypt": "^6.0.0",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.2",
-    "file-type": "^21.0.0",
-    "handlebars": "^4.7.8",
-    "image-size": "^2.0.2",
-    "nest-winston": "^1.10.2",
-    "nodemailer": "^7.0.6",
-    "sharp": "^0.34.4",
-    "winston": "^3.18.3",
-    "winston-daily-rotate-file": "^5.0.0"
-  },
-  "keywords": [
-    "typescript",
-    "nestjs"
-  ]
-}
+{
+  "name": "@maioradv/nestjs-core",
+  "version": "2.0.6",
+  "description": "NestJS helpers by MaiorADV",
+  "repository": "https://github.com/maioradv/nestjs-core.git",
+  "author": "Maior ADV Srl",
+  "license": "MIT",
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "example": "ts-node example/test.ts",
+    "build": "tsc",
+    "publish:npm": "npm publish --access public"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.899.0",
+    "@maioradv/accounts-lib": "^1.3.3",
+    "@nestjs/cache-manager": "^3.0.1",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/graphql": "^13.2.0",
+    "@nestjs/platform-express": "^11.1.6",
+    "@nestjs/swagger": "^11.2.0",
+    "@nestjs/throttler": "^6.4.0",
+    "@sentry/nestjs": "^10.17.0",
+    "bcrypt": "^6.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "file-type": "^21.0.0",
+    "handlebars": "^4.7.8",
+    "image-size": "^2.0.2",
+    "nest-winston": "^1.10.2",
+    "nodemailer": "^7.0.6",
+    "request-ip": "^3.3.0",
+    "sharp": "^0.34.4",
+    "winston": "^3.18.3",
+    "winston-daily-rotate-file": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.6.1",
+    "@types/nodemailer": "^7.0.2",
+    "@types/request-ip": "^0.0.41",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.899.0",
+    "@maioradv/accounts-lib": "^1.3.3",
+    "@nestjs/cache-manager": "^3.0.1",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/graphql": "^13.2.0",
+    "@nestjs/platform-express": "^11.1.6",
+    "@nestjs/swagger": "^11.2.0",
+    "@nestjs/throttler": "^6.4.0",
+    "@sentry/nestjs": "^10.17.0",
+    "bcrypt": "^6.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "file-type": "^21.0.0",
+    "handlebars": "^4.7.8",
+    "image-size": "^2.0.2",
+    "nest-winston": "^1.10.2",
+    "nodemailer": "^7.0.6",
+    "sharp": "^0.34.4",
+    "winston": "^3.18.3",
+    "winston-daily-rotate-file": "^5.0.0"
+  },
+  "keywords": [
+    "typescript",
+    "nestjs"
+  ]
+}

package/dist/instrumentation/sentry.js

@@ -1,13 +0,0 @@
-/*import * as Sentry from "@sentry/nestjs"
-import { nodeProfilingIntegration } from "@sentry/profiling-node";
-
-Sentry.init({
-  dsn: process.env.SENTRY_DSN,
-  serverName: process.env.SENTRY_SERVER_NAME,
-  sendDefaultPii: true,
-  integrations: [
-    nodeProfilingIntegration(),
-  ],
-  tracesSampleRate: 1.0,
-  profilesSampleRate: 1.0,
-});*/ 

package/dist/logger/sentry-instrument.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/logger/sentry-instrument.js

@@ -1,47 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-const Sentry = __importStar(require("@sentry/nestjs"));
-const profiling_node_1 = require("@sentry/profiling-node");
-Sentry.init({
-    dsn: process.env.SENTRY_DSN,
-    serverName: process.env.SENTRY_SERVER_NAME,
-    sendDefaultPii: true,
-    integrations: [
-        (0, profiling_node_1.nodeProfilingIntegration)(),
-    ],
-    tracesSampleRate: 1.0,
-    profilesSampleRate: 1.0,
-});

package/dist/utils/storage.helper.d.ts

@@ -1,15 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-import { Stats } from 'fs';
-import internal from 'stream';
-export declare class StorageHelper {
-    rootPath: string;
-    read(path: string): Promise<Buffer>;
-    write(path: string, data: string | NodeJS.ArrayBufferView | Iterable<string | NodeJS.ArrayBufferView> | AsyncIterable<string | NodeJS.ArrayBufferView> | internal.Stream): Promise<void>;
-    append(path: string, data: string | Uint8Array): Promise<void>;
-    delete(path: string): Promise<void>;
-    stat(path: string): Promise<Stats>;
-    private safeDirectory;
-}

package/dist/utils/storage.helper.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StorageHelper = void 0;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const os_1 = require("os");
-const path_helper_1 = require("./path.helper");
-class StorageHelper {
-    constructor() {
-        this.rootPath = (0, path_helper_1.joinFromRoot)('public');
-    }
-    async read(path) {
-        const realPath = (0, path_1.join)(this.rootPath, path);
-        return await fs_1.promises.readFile(realPath, {});
-    }
-    async write(path, data) {
-        const realPath = (0, path_1.join)(this.rootPath, path);
-        await this.safeDirectory(realPath);
-        return await fs_1.promises.writeFile(realPath, data, 'utf8');
-    }
-    async append(path, data) {
-        const realPath = (0, path_1.join)(this.rootPath, path);
-        await this.safeDirectory(realPath);
-        return await fs_1.promises.appendFile(realPath, data + os_1.EOL);
-    }
-    async delete(path) {
-        const realPath = (0, path_1.join)(this.rootPath, path);
-        try {
-            return await fs_1.promises.unlink(realPath);
-        }
-        catch (e) { }
-    }
-    async stat(path) {
-        const realPath = (0, path_1.join)(this.rootPath, path);
-        return fs_1.promises.stat(realPath);
-    }
-    async safeDirectory(path) {
-        const dirPath = (0, path_1.dirname)(path);
-        try {
-            await fs_1.promises.stat(dirPath);
-        }
-        catch (e) {
-            await fs_1.promises.mkdir(dirPath, { recursive: true });
-        }
-    }
-}
-exports.StorageHelper = StorageHelper;