@zola_do/crud 0.2.16 → 0.2.17

package/README.md

@@ -752,8 +752,25 @@ import {
 } from '@zola_do/crud';
 ```
 
+## Supply chain / Socket.dev
+
+Dependency Alerts on npm reflect **NestJS, Express, TypeORM, and authorization transitives**, not malware in `@zola_do/crud` source. Use subpath imports (`./optional/swagger`, `./optional/rpc`) where possible to keep optional peer trees smaller.
+
+See [docs/SUPPLY_CHAIN.md](../../docs/SUPPLY_CHAIN.md) for per-alert triage.
+
 ## Optional Features
 
+### Swagger OpenAPI helpers
+
+Paginated response decorators and data response DTOs require `@nestjs/swagger`:
+
+```typescript
+import {
+  ApiPaginatedResponse,
+  DataResponseFormat,
+} from '@zola_do/crud/optional/swagger';
+```
+
 ### RPC Exception Filter
 
 For NestJS microservices:

package/dist/{shared/api-data → optional/swagger}/api-paginated-response.js

@@ -8,7 +8,7 @@ const ApiPaginatedResponse = (model) => {
     return (0, common_1.applyDecorators)((0, swagger_1.ApiOkResponse)({
         schema: {
             allOf: [
-                { $ref: (0, swagger_1.getSchemaPath)(data_response_format_1.DataResponseFormat) },
+                { $ref: (0, swagger_1.getSchemaPath)(data_response_format_1.DataResponseFormatSwagger) },
                 {
                     properties: {
                         total: {

package/dist/optional/swagger/api-paginated-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-paginated-response.js","sourceRoot":"","sources":["../../../src/optional/swagger/api-paginated-response.ts"],"names":[],"mappings":";;;AAAA,2CAAuD;AACvD,6CAA+D;AAC/D,iEAAmE;AAE5D,MAAM,oBAAoB,GAAG,CAClC,KAAa,EACb,EAAE;IACF,OAAO,IAAA,wBAAe,EACpB,IAAA,uBAAa,EAAC;QACZ,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,gDAAyB,CAAC,EAAE;gBAClD;oBACE,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;yBACf;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,KAAK,CAAC,EAAE;yBACtC;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,SAAS;4BACf,QAAQ,EAAE,IAAI;yBACf;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,SAAS;4BACf,QAAQ,EAAE,IAAI;yBACf;qBACF;iBACF;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AA/CW,QAAA,oBAAoB,wBA+C/B"}

package/dist/optional/swagger/data-response-format.d.ts

@@ -0,0 +1,11 @@
+export declare class DataResponseFormatSwagger<T> {
+    total: number;
+    items: T[];
+    nextCursor?: string;
+    prevCursor?: string;
+    hasNextPage?: boolean;
+    nc?: string;
+    pc?: string;
+    hn?: boolean;
+}
+export { DataResponseFormatSwagger as DataResponseFormatDto };

package/dist/optional/swagger/data-response-format.js

@@ -0,0 +1,50 @@
+"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.DataResponseFormatDto = exports.DataResponseFormatSwagger = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class DataResponseFormatSwagger {
+}
+exports.DataResponseFormatSwagger = DataResponseFormatSwagger;
+exports.DataResponseFormatDto = DataResponseFormatSwagger;
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", Number)
+], DataResponseFormatSwagger.prototype, "total", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ isArray: true }),
+    __metadata("design:type", Array)
+], DataResponseFormatSwagger.prototype, "items", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], DataResponseFormatSwagger.prototype, "nextCursor", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], DataResponseFormatSwagger.prototype, "prevCursor", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", Boolean)
+], DataResponseFormatSwagger.prototype, "hasNextPage", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], DataResponseFormatSwagger.prototype, "nc", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], DataResponseFormatSwagger.prototype, "pc", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", Boolean)
+], DataResponseFormatSwagger.prototype, "hn", void 0);
+//# sourceMappingURL=data-response-format.js.map

package/dist/optional/swagger/data-response-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-response-format.js","sourceRoot":"","sources":["../../../src/optional/swagger/data-response-format.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAE9C,MAAa,yBAAyB;CAwBrC;AAxBD,8DAwBC;AAGqC,0DAAqB;AAzBzD;IADC,IAAA,qBAAW,GAAE;;wDACC;AAGf;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;wDACnB;AAGZ;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;6DACb;AAGpB;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;6DACb;AAGpB;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;8DACX;AAGtB;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;qDACrB;AAGZ;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;qDACrB;AAGZ;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;qDACpB"}

package/dist/optional/swagger.d.ts

@@ -0,0 +1,2 @@
+export * from './swagger/api-paginated-response';
+export * from './swagger/data-response-format';

package/dist/optional/swagger.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./swagger/api-paginated-response"), exports);
+__exportStar(require("./swagger/data-response-format"), exports);
+//# sourceMappingURL=swagger.js.map

package/dist/optional/swagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../src/optional/swagger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,iEAA+C"}

package/dist/shared/api-data/data-response-format.js

@@ -1,49 +1,7 @@
 "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.DataResponseFormat = void 0;
-const swagger_1 = require("@nestjs/swagger");
 class DataResponseFormat {
 }
 exports.DataResponseFormat = DataResponseFormat;
-__decorate([
-    (0, swagger_1.ApiProperty)(),
-    __metadata("design:type", Number)
-], DataResponseFormat.prototype, "total", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ isArray: true }),
-    __metadata("design:type", Array)
-], DataResponseFormat.prototype, "items", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ required: false }),
-    __metadata("design:type", String)
-], DataResponseFormat.prototype, "nextCursor", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ required: false }),
-    __metadata("design:type", String)
-], DataResponseFormat.prototype, "prevCursor", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ required: false }),
-    __metadata("design:type", Boolean)
-], DataResponseFormat.prototype, "hasNextPage", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ required: false }),
-    __metadata("design:type", String)
-], DataResponseFormat.prototype, "nc", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ required: false }),
-    __metadata("design:type", String)
-], DataResponseFormat.prototype, "pc", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({ required: false }),
-    __metadata("design:type", Boolean)
-], DataResponseFormat.prototype, "hn", void 0);
 //# sourceMappingURL=data-response-format.js.map

package/dist/shared/api-data/data-response-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-response-format.js","sourceRoot":"","sources":["../../../src/shared/api-data/data-response-format.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAE9C,MAAa,kBAAkB;CAiB9B;AAjBD,gDAiBC;AAfC;IADC,IAAA,qBAAW,GAAE;;iDACC;AAEf;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;iDACnB;AAEZ;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;sDACb;AAEpB;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;sDACb;AAEpB;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;uDACX;AAEtB;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;8CACrB;AAEZ;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;8CACrB;AAEZ;IADC,IAAA,qBAAW,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;;8CACpB"}
+{"version":3,"file":"data-response-format.js","sourceRoot":"","sources":["../../../src/shared/api-data/data-response-format.ts"],"names":[],"mappings":";;;AAAA,MAAa,kBAAkB;CAS9B;AATD,gDASC"}

package/dist/shared/api-data/index.d.ts

@@ -1,2 +1 @@
-export * from './api-paginated-response';
 export * from './data-response-format';

package/dist/shared/api-data/index.js

@@ -14,6 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./api-paginated-response"), exports);
 __exportStar(require("./data-response-format"), exports);
 //# sourceMappingURL=index.js.map

package/dist/shared/api-data/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/api-data/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,yDAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/api-data/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zola_do/crud",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "description": "Generic CRUD controllers and services for NestJS",
   "author": "zolaDO",
   "license": "ISC",
@@ -43,6 +43,11 @@
       "types": "./dist/optional/rpc.d.ts",
       "require": "./dist/optional/rpc.js",
       "default": "./dist/optional/rpc.js"
+    },
+    "./optional/swagger": {
+      "types": "./dist/optional/swagger.d.ts",
+      "require": "./dist/optional/swagger.js",
+      "default": "./dist/optional/swagger.js"
     }
   },
   "files": [

package/dist/shared/api-data/api-paginated-response.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-paginated-response.js","sourceRoot":"","sources":["../../../src/shared/api-data/api-paginated-response.ts"],"names":[],"mappings":";;;AAAA,2CAAuD;AACvD,6CAA+D;AAC/D,iEAA4D;AACrD,MAAM,oBAAoB,GAAG,CAClC,KAAa,EACb,EAAE;IACF,OAAO,IAAA,wBAAe,EACpB,IAAA,uBAAa,EAAC;QACZ,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,yCAAkB,CAAC,EAAE;gBAC3C;oBACE,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;yBACf;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,KAAK,CAAC,EAAE;yBACtC;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,SAAS;4BACf,QAAQ,EAAE,IAAI;yBACf;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,IAAI;yBACf;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,SAAS;4BACf,QAAQ,EAAE,IAAI;yBACf;qBACF;iBACF;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AA/CW,QAAA,oBAAoB,wBA+C/B"}