@klerick/json-api-nestjs 10.0.0-beta.9 → 10.0.0

package/CHANGELOG.md

@@ -1,3 +1,160 @@
+# 10.0.0 (2026-08-13)
+
+### 🚀 Features
+
+- **json-api-nestjs-microorm:** migrate to MikroORM 7 ([85b3855](https://github.com/klerick/nestjs-json-api/commit/85b3855))
+- **json-api-nestjs:** add support for `meta` object in various operations ([3c09413](https://github.com/klerick/nestjs-json-api/commit/3c09413))
+- **json-api-nestjs:** enhance Zod schema definitions with metadata, refactor Swagger integration, and improve reusability of schema registrations ([9ecb739](https://github.com/klerick/nestjs-json-api/commit/9ecb739))
+- **json-api-nestjs:** refactor query parameter schemas with Zod, improve Swagger definitions, and add reusable transformers ([70e955f](https://github.com/klerick/nestjs-json-api/commit/70e955f))
+- **json-api-nestjs:** add primary key handling for relations and improve query schema generation ([7caea1a](https://github.com/klerick/nestjs-json-api/commit/7caea1a))
+- **json-api-nestjs-shared,json-api-nestjs:** im did mistake in commit msg ([56c483a](https://github.com/klerick/nestjs-json-api/commit/56c483a))
+- **json-api-nestjs:** enhance ZodIncludeQuery with improved type definitions and utility functions ([c4a5856](https://github.com/klerick/nestjs-json-api/commit/c4a5856))
+- **json-api-nestjs:** add JsonApiResponseFrom decorator for reusing response schemas across methods ([f1f49c1](https://github.com/klerick/nestjs-json-api/commit/f1f49c1))
+- **json-api-nestjs:** replace `errorSchema` with `JsonApiErrorResponseModel`, update response schema handling across Swagger methods ([4e7f481](https://github.com/klerick/nestjs-json-api/commit/4e7f481))
+- **json-api-nestjs:** add support for excluding controllers during module initialization ([5e2de06](https://github.com/klerick/nestjs-json-api/commit/5e2de06))
+- **json-api-nestjs:** optimize and memoize Zod schema generation ([611da19](https://github.com/klerick/nestjs-json-api/commit/611da19))
+- **json-api-nestjs:** enhance Patch and Post schema handling, add utility for merging patch data and refine type definitions for attributes and relationships ([2887603](https://github.com/klerick/nestjs-json-api/commit/2887603))
+- **json-api-nestjs:** add read-only and immutable field decorators with validation schema updates and inheritance support ([fccf757](https://github.com/klerick/nestjs-json-api/commit/fccf757))
+- **json-api-nestjs,json-api-nestjs-microorm,json-api-nestjs-typeorm:** add support for automatic resource linkage in to-one relations, update FK field detection and handling ([0dd670d](https://github.com/klerick/nestjs-json-api/commit/0dd670d))
+- **json-api-nestjs:** add hooks support and enhance guards handling with `afterCreateController` hook and guards logic - prepare for acl libs ([5059530](https://github.com/klerick/nestjs-json-api/commit/5059530))
+- **json-api-nestjs:** add `allowSetId` option for enhanced control over entity ID assignment during POST operations ([ce269ad](https://github.com/klerick/nestjs-json-api/commit/ce269ad))
+- **json-api-nestjs:** fix after update nx ([e51f07c](https://github.com/klerick/nestjs-json-api/commit/e51f07c))
+- **json-api-nestjs:** bump zod to v4 ([19888e9](https://github.com/klerick/nestjs-json-api/commit/19888e9))
+- **json-api-nestjs:** Add JSON_API_DECORATOR_ENTITY metadata to controller ([d2deb39](https://github.com/klerick/nestjs-json-api/commit/d2deb39))
+- **json-api-nestjs:** fix after update nx ([5d87f95](https://github.com/klerick/nestjs-json-api/commit/5d87f95))
+- **json-api-nestjs:** bump zod to v4 ([23709bd](https://github.com/klerick/nestjs-json-api/commit/23709bd))
+- **json-api-nestjs:** Export `Params` type in index.ts ([bd509a5](https://github.com/klerick/nestjs-json-api/commit/bd509a5))
+- **json-api-nestjs:** Update package.json dep ([87519a0](https://github.com/klerick/nestjs-json-api/commit/87519a0))
+- **json-api-nestjs,json-api-nestjs-microorm,json-api-nestjs-sdk,json-api-nestjs-shared,json-api-nestjs-typeorm:** up nestjs ([77c7bf4](https://github.com/klerick/nestjs-json-api/commit/77c7bf4))
+- **json-api-nestjs,json-api-nestjs-microorm,json-api-nestjs-sdk,json-api-nestjs-shared,json-api-nestjs-typeorm:** up nestjs ([42b6b82](https://github.com/klerick/nestjs-json-api/commit/42b6b82))
+- **json-api-nestjs,json-api-nestjs-microorm,json-api-nestjs-sdk,json-api-nestjs-shared,json-api-nestjs-typeorm:** up nestjs ([4c559e2](https://github.com/klerick/nestjs-json-api/commit/4c559e2))
+- **json-api-nestjs,json-api-nestjs-microorm,json-api-nestjs-sdk,json-api-nestjs-shared,json-api-nestjs-typeorm:** up nestjs ([b590802](https://github.com/klerick/nestjs-json-api/commit/b590802))
+- ⚠️  **json-api-nestjs:** remove module and refactoring ([f202ebc](https://github.com/klerick/nestjs-json-api/commit/f202ebc))
+
+### 🩹 Fixes
+
+- **json-api-nestjs:** replace `id` with `lid` in atomic operation references for JSON:API compliance ([579ed01](https://github.com/klerick/nestjs-json-api/commit/579ed01))
+- **json-api-nestjs:** replace `tmpIds` with `lids` for improved clarity in atomic operation logic and related tests ([81e7da9](https://github.com/klerick/nestjs-json-api/commit/81e7da9))
+- **json-api-nestjs:** replace deprecated faker methods, enhance zod schemas with transformations and update constants with METHOD_NAME. change name for method function ([e382bce](https://github.com/klerick/nestjs-json-api/commit/e382bce))
+- **json-api-nestjs:** use ErrorFormatService for format error in AtomicOperationModule fix work with tmpId ([6d166ba](https://github.com/klerick/nestjs-json-api/commit/6d166ba))
+- **json-api-nestjs:** Some fix for swagger ([9a0f190](https://github.com/klerick/nestjs-json-api/commit/9a0f190))
+- **json-api-nestjs:** Use correct options for check is debug or not ([e52cc92](https://github.com/klerick/nestjs-json-api/commit/e52cc92))
+- **json-api-nestjs:** fix type in some place ([61f45e6](https://github.com/klerick/nestjs-json-api/commit/61f45e6))
+
+### ⚠️  Breaking Changes
+
+- **json-api-nestjs:** remove module and refactoring  ([f202ebc](https://github.com/klerick/nestjs-json-api/commit/f202ebc))
+  Change type signature, rename npm package
+
+### 🧱 Updated Dependencies
+
+- Updated json-api-nestjs-shared to 1.0.0-beta.8
+
+### ❤️ Thank You
+
+- Alex H
+- Claude Opus 5 (1M context)
+
+## 10.0.0-beta.18 (2026-02-16)
+
+### 🚀 Features
+
+- **json-api-nestjs:** add support for `meta` object in various operations ([3c09413](https://github.com/klerick/nestjs-json-api/commit/3c09413))
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.17 (2026-02-11)
+
+### 🩹 Fixes
+
+- **json-api-nestjs:** replace `id` with `lid` in atomic operation references for JSON:API compliance ([579ed01](https://github.com/klerick/nestjs-json-api/commit/579ed01))
+- **json-api-nestjs:** replace `tmpIds` with `lids` for improved clarity in atomic operation logic and related tests ([81e7da9](https://github.com/klerick/nestjs-json-api/commit/81e7da9))
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.16 (2026-02-05)
+
+### 🚀 Features
+
+- **json-api-nestjs:** enhance Zod schema definitions with metadata, refactor Swagger integration, and improve reusability of schema registrations ([9ecb739](https://github.com/klerick/nestjs-json-api/commit/9ecb739))
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.15 (2026-02-01)
+
+### 🚀 Features
+
+- **json-api-nestjs:** refactor query parameter schemas with Zod, improve Swagger definitions, and add reusable transformers ([70e955f](https://github.com/klerick/nestjs-json-api/commit/70e955f))
+- **json-api-nestjs:** add primary key handling for relations and improve query schema generation ([7caea1a](https://github.com/klerick/nestjs-json-api/commit/7caea1a))
+
+### 🧱 Updated Dependencies
+
+- Updated json-api-nestjs-shared to 1.0.0-beta.7
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.14 (2026-01-23)
+
+### 🚀 Features
+
+- **json-api-nestjs-shared,json-api-nestjs:** im did mistake in commit msg ([56c483a](https://github.com/klerick/nestjs-json-api/commit/56c483a))
+
+### 🧱 Updated Dependencies
+
+- Updated json-api-nestjs-shared to 1.0.0-beta.6
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.13 (2026-01-23)
+
+This was a version bump only for json-api-nestjs to align it with other projects, there were no code changes.
+
+## 10.0.0-beta.12 (2026-01-23)
+
+### 🚀 Features
+
+- **json-api-nestjs:** enhance ZodIncludeQuery with improved type definitions and utility functions ([c4a5856](https://github.com/klerick/nestjs-json-api/commit/c4a5856))
+- **json-api-nestjs:** add JsonApiResponseFrom decorator for reusing response schemas across methods ([f1f49c1](https://github.com/klerick/nestjs-json-api/commit/f1f49c1))
+- **json-api-nestjs:** replace `errorSchema` with `JsonApiErrorResponseModel`, update response schema handling across Swagger methods ([4e7f481](https://github.com/klerick/nestjs-json-api/commit/4e7f481))
+
+### 🧱 Updated Dependencies
+
+- Updated json-api-nestjs-shared to 1.0.0-beta.5
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.11 (2026-01-22)
+
+### 🚀 Features
+
+- **json-api-nestjs:** add support for excluding controllers during module initialization ([5e2de06](https://github.com/klerick/nestjs-json-api/commit/5e2de06))
+
+### ❤️ Thank You
+
+- Alex H
+
+## 10.0.0-beta.10 (2026-01-21)
+
+### 🚀 Features
+
+- **json-api-nestjs:** optimize and memoize Zod schema generation ([611da19](https://github.com/klerick/nestjs-json-api/commit/611da19))
+
+### ❤️ Thank You
+
+- Alex H
+
 ## 10.0.0-beta.9 (2026-01-20)
 
 ### 🚀 Features

package/README.md

@@ -79,8 +79,9 @@ The following interface is using for the configuration:
 ```typescript
 export interface ModuleOptions {
   entities: Entity[]; // List of typeOrm Entity
+  excludeControllers?: Entity[]; // List of entities to exclude from automatic controller generation
   controllers?: NestController[];  // List of controller, if you need extend default present
-  connectionName?: string; // Type orm connection name: "default" is default name  
+  connectionName?: string; // Type orm connection name: "default" is default name
   providers?: NestProvider[]; // List of addition provider for useing in custom controller
   imports?: NestImport[]; // List of addition module for useing in custom controller
   options?: {
@@ -88,11 +89,38 @@ export interface ModuleOptions {
     debug?: boolean; // Debug info in result object, like error message
     pipeForId?: Type<PipeTransform> // Nestjs pipe for validate id params, by default ParseIntPipe
     operationUrl?: string // Url for atomic operation https://jsonapi.org/ext/atomic/
-    // You can add params for MicroOrm or TypeOrm adapter  
+    allowSetId?: boolean // Allow client to set id on POST requests, false by default
+    // You can add params for MicroOrm or TypeOrm adapter
   } ;
 }
 ```
 
+### Excluding Controllers
+
+If you need to register entities for relationships but don't want automatic controller generation for some of them, use `excludeControllers`:
+
+```typescript
+import {Module} from '@nestjs/common';
+import {JsonApiModule} from '@klerick/json-api-nestjs';
+import {TypeOrmJsonApiModule} from '@klerick/json-api-nestjs-typeorm';
+import {Users, Roles, AuditLog} from 'database';
+
+@Module({
+  imports: [
+    JsonApiModule.forRoot(TypeOrmJsonApiModule, {
+      entities: [Users, Roles, AuditLog],
+      excludeControllers: [AuditLog], // AuditLog entity will not have auto-generated controller
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+This is useful when:
+- You want to manage certain entities only through relationships
+- You need custom controller implementation without the auto-generated one
+- Some entities should be internal and not exposed via REST API
+
 You can extend the default controller:
 
 ```typescript
@@ -335,6 +363,42 @@ type FilterOperand
   }
 }
 ```
+
+### Client-Generated IDs
+
+By default, the server generates IDs for new resources. If you need clients to provide their own IDs (e.g., UUIDs), enable the `allowSetId` option:
+
+```typescript
+@Module({
+  imports: [
+    JsonApiModule.forRoot(TypeOrmJsonApiModule, {
+      entities: [Users],
+      options: {
+        allowSetId: true,
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+With this option enabled, clients can include the `id` field in POST requests:
+
+```json
+{
+  "data": {
+    "id": "550e8400-e29b-41d4-a716-446655440000",
+    "type": "users",
+    "attributes": {
+      "login": "johndoe",
+      "firstName": "John",
+      "lastName": "Doe"
+    }
+  }
+}
+```
+
+**Note:** When `allowSetId` is `false` (default), any `id` provided in the POST body will be ignored and the server will generate a new ID.
 ### Update item of Users
   ```
   PATCH /users/:id
@@ -371,30 +435,169 @@ type FilterOperand
 
 ```
 
-### Atomic operation
-You can more information find [here](https://jsonapi.org/ext/atomic/)
-But you have additinal feature.
-For example: you will need create new **Roles**, then - create new **Users** and assign new **Roles** to new **Users**.
-If use native json api you need send 3 http request:
-- POST /roles
-- POST /users
+### Meta Support
+
+The library supports the `meta` member in JSON:API requests and responses according to the [JSON:API specification](https://jsonapi.org/format/#document-meta). Meta allows passing additional non-standard information that doesn't belong to resource attributes.
+
+**Use cases:**
+- Request tracking (correlation IDs, client versions, timestamps)
+- Business logic metadata (import source, batch IDs, priority levels)
+- Audit information (user context, operation reason)
+
+#### Meta in Regular Operations
+
+Meta is supported in POST, PATCH, and relationship operations:
 
-but [Atomic operation](https://jsonapi.org/ext/atomic/) allow for one request.
+**POST Request with Meta:**
 ```json
+POST /users
+{
+  "data": {
+    "type": "users",
+    "attributes": {
+      "login": "johndoe",
+      "firstName": "John"
+    }
+  },
+  "meta": {
+    "source": "mobile-app",
+    "version": "1.0.2",
+    "correlationId": "abc-123"
+  }
+}
+```
 
+**PATCH Request with Meta:**
+```json
+PATCH /users/1
+{
+  "data": {
+    "id": "1",
+    "type": "users",
+    "attributes": {
+      "firstName": "Jane"
+    }
+  },
+  "meta": {
+    "reason": "name-change-request",
+    "approvedBy": "admin"
+  }
+}
+```
+
+**Relationship Operations with Meta:**
+```json
+POST /users/1/relationships/roles
+{
+  "data": [
+    { "type": "roles", "id": "2" }
+  ],
+  "meta": {
+    "assignedBy": "admin",
+    "expiresAt": "2024-12-31"
+  }
+}
+```
+
+**Note:** DELETE operations do not support meta as per JSON:API specification.
+
+#### Accessing Meta in Controllers
+
+Meta is automatically extracted and passed as a parameter to controller methods:
+
+```typescript
+import { JsonApi, JsonBaseController } from '@klerick/json-api-nestjs';
+import { Body } from '@nestjs/common';
+
+@JsonApi(Users)
+export class UsersController extends JsonBaseController<Users> {
+  override async postOne(
+    @Body() inputData: PostData<Users>,
+    @Body() meta: Record<string, unknown>
+  ) {
+    // Access meta fields
+    console.log('Source:', meta.source);
+    console.log('Correlation ID:', meta.correlationId);
+
+    // Return response with meta
+    const response = await super.postOne(inputData);
+    return {
+      ...response,
+      meta: {
+        ...meta,
+        processedAt: Date.now(),
+        processedBy: 'server'
+      }
+    };
+  }
+}
+```
+
+#### Custom Meta Validation
+
+You can add custom validation for meta using NestJS pipes:
+
+```typescript
+import { PipeTransform, BadRequestException } from '@nestjs/common';
+import { z } from 'zod';
+
+// Define meta schema
+const CustomMetaSchema = z.object({
+  source: z.string(),
+  version: z.string().regex(/^\d+\.\d+\.\d+$/),
+  correlationId: z.string().uuid().optional()
+});
+
+type CustomMeta = z.infer<typeof CustomMetaSchema>;
+
+// Custom validation pipe
+export class MetaValidationPipe implements PipeTransform<unknown, CustomMeta> {
+  transform(value: unknown): CustomMeta {
+    try {
+      return CustomMetaSchema.parse(value);
+    } catch (e) {
+      throw new BadRequestException('Invalid meta format');
+    }
+  }
+}
+
+// Use in controller
+@JsonApi(Users)
+export class UsersController extends JsonBaseController<Users> {
+  override async postOne(
+    @Body() inputData: PostData<Users>,
+    @Body(MetaValidationPipe) meta: CustomMeta
+  ) {
+    // meta is now validated and typed
+    console.log(meta.version); // TypeScript knows this exists
+    return super.postOne(inputData);
+  }
+}
+```
+
+### Atomic Operations
+
+The library implements the [JSON:API Atomic Operations Extension](https://jsonapi.org/ext/atomic/), allowing you to execute multiple operations in a single HTTP request with transaction support.
+
+**Use case:** Create multiple related resources in one atomic request instead of multiple sequential HTTP requests.
+
+Example: Create a new **Role**, create a new **User**, and assign the role to the user - all in one request instead of three separate requests.
+
+**Request Example:**
+```json
 {
    "atomic:operations":[
       {
          "op":"add",
          "ref":{
             "type":"roles",
-            "tmpId":10000
+            "lid":10000
          },
          "data":{
             "type":"roles",
             "attributes":{
-               "name":"testRolesAgain",
-               "key":"testRolesAgain"
+               "name":"admin",
+               "key":"admin_role"
             }
          }
       },
@@ -406,27 +609,100 @@ but [Atomic operation](https://jsonapi.org/ext/atomic/) allow for one request.
          "data":{
             "type":"users",
             "attributes":{
-               "login":"newLogin"
+               "login":"johndoe",
+               "firstName":"John",
+               "lastName":"Doe"
             },
             "relationships":{
                "addresses":{
-                  "type":"addresses",
-                  "id":"1"
-               },
-               "roles":[
-                  {
-                     "type":"roles",
-                     "id":"10000"
+                  "data":{
+                     "type":"addresses",
+                     "id":"1"
                   }
-               ]
+               },
+               "roles":{
+                  "data":[
+                     {
+                        "type":"roles",
+                        "id":"10000"
+                     }
+                  ]
+               }
             }
          }
       }
    ]
 }
+```
+
+**Local Identifiers (lid):**
+- The `lid` (local identifier) parameter allows referencing resources created within the same atomic request
+- Must be unique across all operations in the request
+- Used in the `ref.lid` field for the operation creating the resource
+- Referenced in `relationships.{relation}.data.id` to establish relationships
+- Automatically replaced with real database IDs by the server
+
+**Meta Support in Atomic Operations:**
+
+Each operation can include a `meta` object for additional metadata:
 
+```json
+{
+  "atomic:operations": [
+    {
+      "op": "add",
+      "ref": { "type": "users", "lid": 1000 },
+      "data": {
+        "type": "users",
+        "attributes": { "login": "john" }
+      },
+      "meta": {
+        "source": "bulk-import",
+        "batchId": "batch-123",
+        "priority": "high"
+      }
+    },
+    {
+      "op": "update",
+      "ref": { "type": "users", "id": "5" },
+      "data": {
+        "type": "users",
+        "attributes": { "isActive": false }
+      },
+      "meta": {
+        "reason": "account-suspension",
+        "requestedBy": "admin"
+      }
+    }
+  ]
+}
+```
+
+Meta is passed to controller methods just like in regular operations, allowing you to:
+- Track operation context
+- Apply business logic based on metadata
+- Include metadata in response
+
+**Supported Operations:**
+- `add` - Create a new resource (equivalent to POST)
+- `update` - Update an existing resource (equivalent to PATCH)
+- `remove` - Delete a resource (equivalent to DELETE)
+
+**Transaction Guarantees:**
+All operations in an atomic request execute within a single database transaction:
+- If all operations succeed → transaction commits
+- If any operation fails → entire transaction rolls back (no partial changes)
+
+**Configuration:**
+```typescript
+JsonApiModule.forRoot(TypeOrmJsonApiModule, {
+  entities: [Users, Roles],
+  options: {
+    operationUrl: 'operation', // Default endpoint: POST /operation
+    allowSetId: true,          // Allow clients to set IDs (useful for UUIDs)
+  }
+})
 ```
-**tmpId** - is params for operation **add**, should be unique for all operations.
 
 If you have Interceptor you can check call it from **AtomicOperation**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klerick/json-api-nestjs",
-  "version": "10.0.0-beta.9",
+  "version": "10.0.0",
   "type": "commonjs",
   "description": "JsonApi Plugin for NestJs",
   "keywords": [
@@ -21,15 +21,11 @@
     "tslib": ">2.3.0"
   },
   "dependencies": {
-    "@klerick/json-api-nestjs-shared": "^1.0.0-beta.4",
+    "@klerick/json-api-nestjs-shared": "^1.0.0-beta.8",
+    "ts-toolbelt": "^9.6.0",
     "zod": "^4.1.0",
     "zod-validation-error": "^4.0.0"
   },
-  "overrides": {
-    "mikro-orm-pglite": {
-      "@mikro-orm/postgresql": "^6.4.0"
-    }
-  },
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -51,7 +47,7 @@
     "url": "https://github.com/klerick/nestjs-json-api.git"
   },
   "engines": {
-    "node": ">= 20.0.0"
+    "node": "^22.22.3 || ^24.15.0 || >=26.0.0"
   },
   "files": [
     "**/*"

package/src/index.d.ts

@@ -1,6 +1,6 @@
 export { JsonApiModule } from './lib/json-api.module';
 export { JsonBaseController } from './lib/modules/mixin/controllers/json-base.controller';
-export { JsonApi, InjectService, JsonApiReadOnly, JsonApiImmutable } from './lib/modules/mixin/decorators';
+export { JsonApi, InjectService, JsonApiReadOnly, JsonApiImmutable, JsonApiResponseFrom } from './lib/modules/mixin/decorators';
 export { entityForClass, excludeMethod, patchInputData, } from './lib/modules/mixin/helpers/utils';
 export { PrepareParams, NestProvider, ValidateQueryError, UnionToTuple, EntityParam, TypeField, Params, JsonApiReadOnlyField, JsonApiImmutableField, } from './lib/types';
 export { JsonApiTransformerService, ErrorFormatService, EntityParamMapService } from './lib/modules/mixin/service';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.METHOD_NAME = exports.CURRENT_ENTITY = exports.DEFAULT_QUERY_PAGE = exports.DEFAULT_PAGE_SIZE = exports.ENTITY_PARAM_MAP = exports.ORM_SERVICE = exports.RUN_IN_TRANSACTION_FUNCTION = exports.CHECK_RELATION_NAME = exports.FIND_ONE_ROW_ENTITY = exports.DESC = exports.ASC = exports.CONTROLLER_OPTIONS_TOKEN = exports.MODULE_OPTIONS_TOKEN = exports.EntityParamMapService = exports.ErrorFormatService = exports.JsonApiTransformerService = exports.TypeField = exports.patchInputData = exports.excludeMethod = exports.entityForClass = exports.JsonApiImmutable = exports.JsonApiReadOnly = exports.InjectService = exports.JsonApi = exports.JsonBaseController = exports.JsonApiModule = void 0;
+exports.METHOD_NAME = exports.CURRENT_ENTITY = exports.DEFAULT_QUERY_PAGE = exports.DEFAULT_PAGE_SIZE = exports.ENTITY_PARAM_MAP = exports.ORM_SERVICE = exports.RUN_IN_TRANSACTION_FUNCTION = exports.CHECK_RELATION_NAME = exports.FIND_ONE_ROW_ENTITY = exports.DESC = exports.ASC = exports.CONTROLLER_OPTIONS_TOKEN = exports.MODULE_OPTIONS_TOKEN = exports.EntityParamMapService = exports.ErrorFormatService = exports.JsonApiTransformerService = exports.TypeField = exports.patchInputData = exports.excludeMethod = exports.entityForClass = exports.JsonApiResponseFrom = exports.JsonApiImmutable = exports.JsonApiReadOnly = exports.InjectService = exports.JsonApi = exports.JsonBaseController = exports.JsonApiModule = void 0;
 var json_api_module_1 = require("./lib/json-api.module");
 Object.defineProperty(exports, "JsonApiModule", { enumerable: true, get: function () { return json_api_module_1.JsonApiModule; } });
 var json_base_controller_1 = require("./lib/modules/mixin/controllers/json-base.controller");
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "JsonApi", { enumerable: true, get: function () {
 Object.defineProperty(exports, "InjectService", { enumerable: true, get: function () { return decorators_1.InjectService; } });
 Object.defineProperty(exports, "JsonApiReadOnly", { enumerable: true, get: function () { return decorators_1.JsonApiReadOnly; } });
 Object.defineProperty(exports, "JsonApiImmutable", { enumerable: true, get: function () { return decorators_1.JsonApiImmutable; } });
+Object.defineProperty(exports, "JsonApiResponseFrom", { enumerable: true, get: function () { return decorators_1.JsonApiResponseFrom; } });
 var utils_1 = require("./lib/modules/mixin/helpers/utils");
 Object.defineProperty(exports, "entityForClass", { enumerable: true, get: function () { return utils_1.entityForClass; } });
 Object.defineProperty(exports, "excludeMethod", { enumerable: true, get: function () { return utils_1.excludeMethod; } });

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/json-api/json-api-nestjs/src/index.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAA7C,gHAAA,aAAa,OAAA;AAEtB,6FAA0F;AAAjF,0HAAA,kBAAkB,OAAA;AAC3B,6DAA2G;AAAlG,qGAAA,OAAO,OAAA;AAAE,2GAAA,aAAa,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAClE,2DAI2C;AAHzC,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AAEhB,qCAUqB;AAJnB,kGAAA,SAAS,OAAA;AAKX,uDAIqC;AAHnC,oHAAA,yBAAyB,OAAA;AACzB,6GAAA,kBAAkB,OAAA;AAClB,gHAAA,qBAAqB,OAAA;AAEvB,6CAcyB;AAbvB,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AACxB,gGAAA,GAAG,OAAA;AACH,iGAAA,IAAI,OAAA;AACJ,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,wHAAA,2BAA2B,OAAA;AAC3B,wGAAA,WAAW,OAAA;AACX,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,2GAAA,cAAc,OAAA;AACd,wGAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/json-api/json-api-nestjs/src/index.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAA7C,gHAAA,aAAa,OAAA;AAEtB,6FAA0F;AAAjF,0HAAA,kBAAkB,OAAA;AAC3B,6DAAgI;AAAvH,qGAAA,OAAO,OAAA;AAAE,2GAAA,aAAa,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AACvF,2DAI2C;AAHzC,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AAEhB,qCAUqB;AAJnB,kGAAA,SAAS,OAAA;AAKX,uDAIqC;AAHnC,oHAAA,yBAAyB,OAAA;AACzB,6GAAA,kBAAkB,OAAA;AAClB,gHAAA,qBAAqB,OAAA;AAEvB,6CAcyB;AAbvB,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AACxB,gGAAA,GAAG,OAAA;AACH,iGAAA,IAAI,OAAA;AACJ,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,wHAAA,2BAA2B,OAAA;AAC3B,wGAAA,WAAW,OAAA;AACX,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,2GAAA,cAAc,OAAA;AACd,wGAAA,WAAW,OAAA"}

package/src/lib/constants/di.d.ts

@@ -9,6 +9,7 @@ export declare const ZOD_POST_SCHEMA: unique symbol;
 export declare const ZOD_PATCH_SCHEMA: unique symbol;
 export declare const ZOD_POST_RELATIONSHIP_SCHEMA: unique symbol;
 export declare const ZOD_PATCH_RELATIONSHIP_SCHEMA: unique symbol;
+export declare const ZOD_META_SCHEMA: unique symbol;
 export declare const FIND_ONE_ROW_ENTITY: unique symbol;
 export declare const CHECK_RELATION_NAME: unique symbol;
 export declare const RUN_IN_TRANSACTION_FUNCTION: unique symbol;

package/src/lib/constants/di.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RUN_IN_TRANSACTION_FUNCTION = exports.CHECK_RELATION_NAME = exports.FIND_ONE_ROW_ENTITY = exports.ZOD_PATCH_RELATIONSHIP_SCHEMA = exports.ZOD_POST_RELATIONSHIP_SCHEMA = exports.ZOD_PATCH_SCHEMA = exports.ZOD_POST_SCHEMA = exports.ZOD_QUERY_SCHEMA = exports.ZOD_INPUT_QUERY_SCHEMA = exports.ENTITY_PARAM_MAP = exports.CURRENT_ENTITY = exports.CONTROLLER_OPTIONS_TOKEN = exports.MODULE_OPTIONS_TOKEN = exports.ORM_SERVICE = void 0;
+exports.RUN_IN_TRANSACTION_FUNCTION = exports.CHECK_RELATION_NAME = exports.FIND_ONE_ROW_ENTITY = exports.ZOD_META_SCHEMA = exports.ZOD_PATCH_RELATIONSHIP_SCHEMA = exports.ZOD_POST_RELATIONSHIP_SCHEMA = exports.ZOD_PATCH_SCHEMA = exports.ZOD_POST_SCHEMA = exports.ZOD_QUERY_SCHEMA = exports.ZOD_INPUT_QUERY_SCHEMA = exports.ENTITY_PARAM_MAP = exports.CURRENT_ENTITY = exports.CONTROLLER_OPTIONS_TOKEN = exports.MODULE_OPTIONS_TOKEN = exports.ORM_SERVICE = void 0;
 exports.ORM_SERVICE = Symbol('ORM_SERVICE');
 exports.MODULE_OPTIONS_TOKEN = Symbol('MODULE_OPTIONS_TOKEN');
 exports.CONTROLLER_OPTIONS_TOKEN = Symbol('CONTROLLER_OPTIONS_TOKEN');
@@ -12,6 +12,7 @@ exports.ZOD_POST_SCHEMA = Symbol('ZOD_POST_SCHEMA');
 exports.ZOD_PATCH_SCHEMA = Symbol('ZOD_PATCH_SCHEMA');
 exports.ZOD_POST_RELATIONSHIP_SCHEMA = Symbol('ZOD_POST_RELATIONSHIP_SCHEMA');
 exports.ZOD_PATCH_RELATIONSHIP_SCHEMA = Symbol('ZOD_PATCH_RELATIONSHIP_SCHEMA');
+exports.ZOD_META_SCHEMA = Symbol('ZOD_META_SCHEMA');
 exports.FIND_ONE_ROW_ENTITY = Symbol('FIND_ONE_ROW_ENTITY');
 exports.CHECK_RELATION_NAME = Symbol('CHECK_RELATION_NAME');
 exports.RUN_IN_TRANSACTION_FUNCTION = Symbol('RUN_IN_TRANSACTION_FUNCTION');

package/src/lib/constants/di.js.map

@@ -1 +1 @@
-{"version":3,"file":"di.js","sourceRoot":"","sources":["../../../../../../../libs/json-api/json-api-nestjs/src/lib/constants/di.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEpC,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AACtD,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE9D,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC1C,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE9C,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAC1D,QAAA,gBAAgB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AACpD,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC5C,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC9C,QAAA,4BAA4B,GAAG,MAAM,CAChD,8BAA8B,CAC/B,CAAC;AACW,QAAA,6BAA6B,GAAG,MAAM,CACjD,+BAA+B,CAChC,CAAC;AAEW,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACpD,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACpD,QAAA,2BAA2B,GAAG,MAAM,CAC/C,6BAA6B,CAC9B,CAAC"}
+{"version":3,"file":"di.js","sourceRoot":"","sources":["../../../../../../../libs/json-api/json-api-nestjs/src/lib/constants/di.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEpC,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AACtD,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE9D,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC1C,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE9C,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAC1D,QAAA,gBAAgB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AACpD,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC5C,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC9C,QAAA,4BAA4B,GAAG,MAAM,CAChD,8BAA8B,CAC/B,CAAC;AACW,QAAA,6BAA6B,GAAG,MAAM,CACjD,+BAA+B,CAChC,CAAC;AACW,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAE5C,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACpD,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACpD,QAAA,2BAA2B,GAAG,MAAM,CAC/C,6BAA6B,CAC9B,CAAC"}

package/src/lib/json-api.module.js

@@ -17,7 +17,8 @@ let JsonApiModule = JsonApiModule_1 = class JsonApiModule {
         if (!commonOrmModule.providers ||
             !commonOrmModule.providers.find((i) => 'provide' in i && i.provide === constants_1.ENTITY_PARAM_MAP))
             throw new Error(`The module ${module.name} should be provide ${constants_1.ENTITY_PARAM_MAP.description}`);
-        const entitiesModules = prepareOptions.entities.map((entityItem) => modules_1.MixinModule.forRoot({
+        const entitiesForControllers = prepareOptions.entities.filter((entity) => !prepareOptions.excludeControllers.includes(entity));
+        const entitiesModules = entitiesForControllers.map((entityItem) => modules_1.MixinModule.forRoot({
             entity: entityItem,
             imports: [commonOrmModule, ...prepareOptions.imports],
             ormModule: module,
@@ -25,7 +26,7 @@ let JsonApiModule = JsonApiModule_1 = class JsonApiModule {
             config: prepareOptions,
         }));
         const atomicOperation = prepareOptions.options.operationUrl
-            ? modules_1.AtomicOperationModule.forRoot(prepareOptions.options.operationUrl, prepareOptions.entities, entitiesModules, commonOrmModule)
+            ? modules_1.AtomicOperationModule.forRoot(prepareOptions.options.operationUrl, entitiesModules, commonOrmModule)
             : [];
         return {
             module: JsonApiModule_1,