@carlonicora/nestjs-neo4jsonapi 0.0.1

package/dist/core/jsonapi/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * JSON:API module exports
+ *
+ * Provides JSON:API specification compliant serialization with support for
+ * resources, relationships, pagination, sparse fieldsets, and included resources.
+ */
+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 });
+exports.DynamicRelationshipFactory = exports.JsonApiSerialiserFactory = void 0;
+// Module
+__exportStar(require("./jsonapi.module"), exports);
+// Services
+__exportStar(require("./services/jsonapi.service"), exports);
+// Factories
+var jsonapi_serialiser_factory_1 = require("./factories/jsonapi.serialiser.factory");
+Object.defineProperty(exports, "JsonApiSerialiserFactory", { enumerable: true, get: function () { return jsonapi_serialiser_factory_1.JsonApiSerialiserFactory; } });
+var dynamic_relationship_factory_1 = require("./factories/dynamic.relationship.factory");
+Object.defineProperty(exports, "DynamicRelationshipFactory", { enumerable: true, get: function () { return dynamic_relationship_factory_1.DynamicRelationshipFactory; } });
+// Abstracts
+__exportStar(require("./abstracts/abstract.jsonapi.serialiser"), exports);
+// Serialisers
+__exportStar(require("./serialisers/jsonapi.paginator"), exports);
+__exportStar(require("./serialisers/descriptor.based.serialiser"), exports);
+// Interfaces
+__exportStar(require("./interfaces/jsonapi.service.interface"), exports);
+__exportStar(require("./interfaces/jsonapi.data.interface"), exports);
+__exportStar(require("./interfaces/jsonapi.pagination.interface"), exports);
+__exportStar(require("./interfaces/jsonapi.cursor.interface"), exports);
+__exportStar(require("./interfaces/jsonapi.relationship.builder.interface"), exports);
+// Types
+__exportStar(require("./types/JsonApiIncludedFields"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/jsonapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/jsonapi/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,SAAS;AACT,mDAAiC;AAEjC,WAAW;AACX,6DAA2C;AAE3C,YAAY;AACZ,qFAAkF;AAAzE,sIAAA,wBAAwB,OAAA;AACjC,yFAAsF;AAA7E,0IAAA,0BAA0B,OAAA;AAEnC,YAAY;AACZ,0EAAwD;AAExD,cAAc;AACd,kEAAgD;AAChD,4EAA0D;AAE1D,aAAa;AACb,yEAAuD;AACvD,sEAAoD;AACpD,4EAA0D;AAC1D,wEAAsD;AACtD,sFAAoE;AAEpE,QAAQ;AACR,gEAA8C"}

package/dist/core/jsonapi/interfaces/jsonapi.cursor.interface.d.ts

@@ -0,0 +1,5 @@
+export interface JsonApiCursorInterface {
+    cursor?: number;
+    take?: number;
+}
+//# sourceMappingURL=jsonapi.cursor.interface.d.ts.map

package/dist/core/jsonapi/interfaces/jsonapi.cursor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.cursor.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.cursor.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/core/jsonapi/interfaces/jsonapi.cursor.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jsonapi.cursor.interface.js.map

package/dist/core/jsonapi/interfaces/jsonapi.cursor.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.cursor.interface.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.cursor.interface.ts"],"names":[],"mappings":""}

package/dist/core/jsonapi/interfaces/jsonapi.data.interface.d.ts

@@ -0,0 +1,31 @@
+import { JsonApiServiceInterface } from "./jsonapi.service.interface";
+export type transformFunction<T> = (data: T) => any;
+export interface JsonApiDataInterface {
+    type: string;
+    id: string | transformFunction<any>;
+    attributes: {
+        [key: string]: any;
+    };
+    meta?: {
+        [key: string]: any;
+    };
+    links?: {
+        self: transformFunction<any>;
+    };
+    relationships?: {
+        [key: string]: {
+            resourceIdentifier?: {
+                type: string;
+                id: string | transformFunction<any>;
+            };
+            data?: JsonApiServiceInterface;
+            forceSingle?: boolean;
+            excluded?: boolean;
+            name?: string;
+            links?: {
+                related?: transformFunction<any>;
+            };
+        };
+    };
+}
+//# sourceMappingURL=jsonapi.data.interface.d.ts.map

package/dist/core/jsonapi/interfaces/jsonapi.data.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.data.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.data.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;KAC9B,CAAC;IACF,aAAa,CAAC,EAAE;QACd,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,kBAAkB,CAAC,EAAE;gBACnB,IAAI,EAAE,MAAM,CAAC;gBACb,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;aACrC,CAAC;YACF,IAAI,CAAC,EAAE,uBAAuB,CAAC;YAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE;gBACN,OAAO,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;aAClC,CAAC;SACH,CAAC;KACH,CAAC;CACH"}

package/dist/core/jsonapi/interfaces/jsonapi.data.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jsonapi.data.interface.js.map

package/dist/core/jsonapi/interfaces/jsonapi.data.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.data.interface.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.data.interface.ts"],"names":[],"mappings":""}

package/dist/core/jsonapi/interfaces/jsonapi.pagination.interface.d.ts

@@ -0,0 +1,8 @@
+export interface JsonApiPaginationInterface {
+    size?: number;
+    offsetPrevious?: number;
+    offsetNext?: number;
+    offset?: number;
+    forcedNext?: string;
+}
+//# sourceMappingURL=jsonapi.pagination.interface.d.ts.map

package/dist/core/jsonapi/interfaces/jsonapi.pagination.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.pagination.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.pagination.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/core/jsonapi/interfaces/jsonapi.pagination.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jsonapi.pagination.interface.js.map

package/dist/core/jsonapi/interfaces/jsonapi.pagination.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.pagination.interface.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.pagination.interface.ts"],"names":[],"mappings":""}

package/dist/core/jsonapi/interfaces/jsonapi.relationship.builder.interface.d.ts

@@ -0,0 +1,5 @@
+export interface JsonApiRelationshipBuilderInterface {
+    type: string;
+    id: string;
+}
+//# sourceMappingURL=jsonapi.relationship.builder.interface.d.ts.map

package/dist/core/jsonapi/interfaces/jsonapi.relationship.builder.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.relationship.builder.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.relationship.builder.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/core/jsonapi/interfaces/jsonapi.relationship.builder.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jsonapi.relationship.builder.interface.js.map

package/dist/core/jsonapi/interfaces/jsonapi.relationship.builder.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.relationship.builder.interface.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.relationship.builder.interface.ts"],"names":[],"mappings":""}

package/dist/core/jsonapi/interfaces/jsonapi.service.interface.d.ts

@@ -0,0 +1,8 @@
+export type JsonApiServiceInterface = {
+    get type(): string;
+    get id(): string;
+    get endpoint(): string;
+    get endpointParameters(): string;
+    create(): any;
+};
+//# sourceMappingURL=jsonapi.service.interface.d.ts.map

package/dist/core/jsonapi/interfaces/jsonapi.service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.service.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.service.interface.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,IAAI,IAAI,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,MAAM,CAAC;IACjB,IAAI,QAAQ,IAAI,MAAM,CAAC;IACvB,IAAI,kBAAkB,IAAI,MAAM,CAAC;IAEjC,MAAM,IAAI,GAAG,CAAC;CACf,CAAC"}

package/dist/core/jsonapi/interfaces/jsonapi.service.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jsonapi.service.interface.js.map

package/dist/core/jsonapi/interfaces/jsonapi.service.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.service.interface.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/interfaces/jsonapi.service.interface.ts"],"names":[],"mappings":""}

package/dist/core/jsonapi/jsonapi.module.d.ts

@@ -0,0 +1,12 @@
+import { DynamicModule } from "@nestjs/common";
+export interface JsonApiModuleOptions {
+}
+export declare class JsonApiModule {
+    static forRoot(_options?: JsonApiModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        imports?: any[];
+        useFactory: (...args: any[]) => Promise<JsonApiModuleOptions> | JsonApiModuleOptions;
+        inject?: any[];
+    }): DynamicModule;
+}
+//# sourceMappingURL=jsonapi.module.d.ts.map

package/dist/core/jsonapi/jsonapi.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.module.d.ts","sourceRoot":"","sources":["../../../src/core/jsonapi/jsonapi.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/D,MAAM,WAAW,oBAAoB;CAEpC;AAID,qBAKa,aAAa;IACxB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAS9D,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;QACrF,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,GAAG,aAAa;CAgBlB"}

package/dist/core/jsonapi/jsonapi.module.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 JsonApiModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonApiModule = void 0;
+const common_1 = require("@nestjs/common");
+const jsonapi_service_1 = require("./services/jsonapi.service");
+const jsonapi_serialiser_factory_1 = require("./factories/jsonapi.serialiser.factory");
+const dynamic_relationship_factory_1 = require("./factories/dynamic.relationship.factory");
+const JSONAPI_SERVICES = [jsonapi_service_1.JsonApiService, jsonapi_serialiser_factory_1.JsonApiSerialiserFactory, dynamic_relationship_factory_1.DynamicRelationshipFactory];
+let JsonApiModule = JsonApiModule_1 = class JsonApiModule {
+    static forRoot(_options) {
+        return {
+            module: JsonApiModule_1,
+            providers: JSONAPI_SERVICES,
+            exports: JSONAPI_SERVICES,
+            global: true,
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: JsonApiModule_1,
+            imports: options.imports || [],
+            providers: [
+                {
+                    provide: "JSON_API_OPTIONS",
+                    useFactory: options.useFactory,
+                    inject: options.inject || [],
+                },
+                ...JSONAPI_SERVICES,
+            ],
+            exports: JSONAPI_SERVICES,
+            global: true,
+        };
+    }
+};
+exports.JsonApiModule = JsonApiModule;
+exports.JsonApiModule = JsonApiModule = JsonApiModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: JSONAPI_SERVICES,
+        exports: JSONAPI_SERVICES,
+    })
+], JsonApiModule);
+//# sourceMappingURL=jsonapi.module.js.map

package/dist/core/jsonapi/jsonapi.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.module.js","sourceRoot":"","sources":["../../../src/core/jsonapi/jsonapi.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+D;AAC/D,gEAA4D;AAC5D,uFAAkF;AAClF,2FAAsF;AAMtF,MAAM,gBAAgB,GAAG,CAAC,gCAAc,EAAE,qDAAwB,EAAE,yDAA0B,CAAC,CAAC;AAOzF,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB,MAAM,CAAC,OAAO,CAAC,QAA+B;QAC5C,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE,gBAAgB;YAC3B,OAAO,EAAE,gBAAgB;YACzB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAInB;QACC,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,kBAAkB;oBAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;iBAC7B;gBACD,GAAG,gBAAgB;aACpB;YACD,OAAO,EAAE,gBAAgB;YACzB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AA9BY,sCAAa;wBAAb,aAAa;IALzB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,gBAAgB;KAC1B,CAAC;GACW,aAAa,CA8BzB"}

package/dist/core/jsonapi/serialisers/descriptor.based.serialiser.d.ts

@@ -0,0 +1,28 @@
+import { ConfigService } from "@nestjs/config";
+import { ModuleRef } from "@nestjs/core";
+import { BaseConfigInterface } from "../../../config/interfaces";
+import { EntityDescriptor } from "../../../common/interfaces/entity.schema.interface";
+import { AbstractJsonApiSerialiser } from "../abstracts/abstract.jsonapi.serialiser";
+import { JsonApiSerialiserFactory } from "../factories/jsonapi.serialiser.factory";
+import { JsonApiDataInterface } from "../interfaces/jsonapi.data.interface";
+import { JsonApiServiceInterface } from "../interfaces/jsonapi.service.interface";
+/**
+ * Base class for auto-generated serialisers from EntityDescriptor.
+ * Derives attributes, meta, and relationships from the descriptor configuration.
+ *
+ * Subclasses should call `setDescriptor()` in their constructor.
+ */
+export declare class DescriptorBasedSerialiser extends AbstractJsonApiSerialiser implements JsonApiServiceInterface {
+    protected readonly moduleRef: ModuleRef;
+    protected descriptor: EntityDescriptor<any, any>;
+    protected injectedServices: Record<string, any>;
+    constructor(serialiserFactory: JsonApiSerialiserFactory, moduleRef: ModuleRef, configService: ConfigService<BaseConfigInterface>);
+    /**
+     * Set the descriptor and inject required services.
+     * Must be called by subclasses in their constructor.
+     */
+    protected setDescriptor(descriptor: EntityDescriptor<any, any>): void;
+    get type(): string;
+    create(): JsonApiDataInterface;
+}
+//# sourceMappingURL=descriptor.based.serialiser.d.ts.map

package/dist/core/jsonapi/serialisers/descriptor.based.serialiser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.based.serialiser.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/serialisers/descriptor.based.serialiser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAmB,MAAM,oDAAoD,CAAC;AAEvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAElF;;;;;GAKG;AACH,qBACa,yBAA0B,SAAQ,yBAA0B,YAAW,uBAAuB;IAMvG,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;IALzC,SAAS,CAAC,UAAU,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjD,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;gBAGnD,iBAAiB,EAAE,wBAAwB,EACxB,SAAS,EAAE,SAAS,EACvC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAKnD;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAcrE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,MAAM,IAAI,oBAAoB;CA+D/B"}

package/dist/core/jsonapi/serialisers/descriptor.based.serialiser.js

@@ -0,0 +1,121 @@
+"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.DescriptorBasedSerialiser = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const core_1 = require("@nestjs/core");
+const registry_1 = require("../../../common/registries/registry");
+const abstract_jsonapi_serialiser_1 = require("../abstracts/abstract.jsonapi.serialiser");
+const jsonapi_serialiser_factory_1 = require("../factories/jsonapi.serialiser.factory");
+/**
+ * Base class for auto-generated serialisers from EntityDescriptor.
+ * Derives attributes, meta, and relationships from the descriptor configuration.
+ *
+ * Subclasses should call `setDescriptor()` in their constructor.
+ */
+let DescriptorBasedSerialiser = class DescriptorBasedSerialiser extends abstract_jsonapi_serialiser_1.AbstractJsonApiSerialiser {
+    constructor(serialiserFactory, moduleRef, configService) {
+        super(serialiserFactory, configService);
+        this.moduleRef = moduleRef;
+        this.injectedServices = {};
+    }
+    /**
+     * Set the descriptor and inject required services.
+     * Must be called by subclasses in their constructor.
+     */
+    setDescriptor(descriptor) {
+        this.descriptor = descriptor;
+        // Inject requested services using ModuleRef
+        for (const ServiceClass of descriptor.injectServices || []) {
+            try {
+                this.injectedServices[ServiceClass.name] = this.moduleRef.get(ServiceClass, { strict: false });
+            }
+            catch {
+                // Service not available - transformer will receive undefined
+                console.warn(`Service ${ServiceClass.name} not available for injection in serialiser`);
+            }
+        }
+    }
+    get type() {
+        return this.descriptor.model.type;
+    }
+    create() {
+        // 1. Build attributes from fields (non-meta)
+        const attributes = {};
+        for (const [fieldName, fieldDef] of Object.entries(this.descriptor.fields || {})) {
+            if (!fieldDef.meta) {
+                if (fieldDef.transform) {
+                    // Wrap transformer with injected services
+                    const transformer = fieldDef.transform;
+                    const services = this.injectedServices;
+                    attributes[fieldName] = async (data) => {
+                        return await transformer(data, services);
+                    };
+                }
+                else {
+                    // Direct mapping
+                    attributes[fieldName] = fieldName;
+                }
+            }
+        }
+        this.attributes = attributes;
+        // 2. Build meta from fields + computed (where meta: true)
+        const meta = {};
+        for (const [fieldName, fieldDef] of Object.entries(this.descriptor.fields || {})) {
+            if (fieldDef.meta) {
+                if (fieldDef.transform) {
+                    const transformer = fieldDef.transform;
+                    const services = this.injectedServices;
+                    meta[fieldName] = async (data) => {
+                        return await transformer(data, services);
+                    };
+                }
+                else {
+                    meta[fieldName] = fieldName;
+                }
+            }
+        }
+        for (const [fieldName, computedDef] of Object.entries(this.descriptor.computed || {})) {
+            if (computedDef.meta) {
+                // Computed value already calculated by mapper
+                meta[fieldName] = fieldName;
+            }
+        }
+        this.meta = meta;
+        // 3. Build relationships - resolve Models from registry at serialisation time
+        const relationships = {};
+        for (const [relName, relDef] of Object.entries(this.descriptor.relationships)) {
+            // Get the related model from registry using nodeName
+            const relatedModel = registry_1.modelRegistry.get(relDef.model.nodeName);
+            if (relatedModel) {
+                const relationship = {
+                    data: this.serialiserFactory.create(relatedModel),
+                };
+                // Use dtoKey if provided (e.g., 'topics' instead of 'topic')
+                if (relDef.dtoKey && relDef.dtoKey !== relName) {
+                    relationship.name = relDef.dtoKey;
+                }
+                relationships[relName] = relationship;
+            }
+        }
+        this.relationships = relationships;
+        return super.create();
+    }
+};
+exports.DescriptorBasedSerialiser = DescriptorBasedSerialiser;
+exports.DescriptorBasedSerialiser = DescriptorBasedSerialiser = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_serialiser_factory_1.JsonApiSerialiserFactory,
+        core_1.ModuleRef,
+        config_1.ConfigService])
+], DescriptorBasedSerialiser);
+//# sourceMappingURL=descriptor.based.serialiser.js.map

package/dist/core/jsonapi/serialisers/descriptor.based.serialiser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.based.serialiser.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/serialisers/descriptor.based.serialiser.ts"],"names":[],"mappings":"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"}

package/dist/core/jsonapi/serialisers/jsonapi.paginator.d.ts

@@ -0,0 +1,29 @@
+import { JsonApiCursorInterface } from "../interfaces/jsonapi.cursor.interface";
+import { JsonApiPaginationInterface } from "../interfaces/jsonapi.pagination.interface";
+import { JsonApiIncludedFields } from "../types/JsonApiIncludedFields";
+export declare class JsonApiPaginator {
+    private _paginationCount;
+    private _pagination;
+    private _additionalParams;
+    private _includedType;
+    private _includedFields;
+    private _includeSpecified;
+    private _fetchAll;
+    constructor(query?: any);
+    set forceNext(forceNext: string);
+    generateLinks(data: any[], url: string): {
+        self: string;
+        next?: string;
+        previous?: string;
+    };
+    updatePagination(data: any[]): void;
+    get paginationCount(): number;
+    get size(): number;
+    get pagination(): JsonApiPaginationInterface;
+    get includedFields(): JsonApiIncludedFields[];
+    get includedType(): string[];
+    get includeSpecified(): boolean;
+    get fetchAll(): boolean;
+    generateCursor(): JsonApiCursorInterface | undefined;
+}
+//# sourceMappingURL=jsonapi.paginator.d.ts.map

package/dist/core/jsonapi/serialisers/jsonapi.paginator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.paginator.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/serialisers/jsonapi.paginator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,WAAW,CAMjB;IACF,OAAO,CAAC,iBAAiB,CAAc;IAEvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,SAAS,CAAkB;gBAEvB,KAAK,CAAC,EAAE,GAAG;IAwCvB,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,EAE9B;IAED,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAsD3F,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IASnC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,UAAU,IAAI,0BAA0B,CAE3C;IAED,IAAI,cAAc,IAAI,qBAAqB,EAAE,CAE5C;IAED,IAAI,YAAY,IAAI,MAAM,EAAE,CAE3B;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,cAAc,IAAI,sBAAsB,GAAG,SAAS;CAYrD"}

package/dist/core/jsonapi/serialisers/jsonapi.paginator.js

@@ -0,0 +1,183 @@
+"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 });
+exports.JsonApiPaginator = void 0;
+const qs = __importStar(require("qs"));
+class JsonApiPaginator {
+    constructor(query) {
+        this._paginationCount = 25;
+        this._pagination = {
+            size: this._paginationCount,
+            offset: 0,
+            offsetNext: undefined,
+            offsetPrevious: undefined,
+            forcedNext: undefined,
+        };
+        this._additionalParams = "";
+        this._includedType = [];
+        this._includedFields = [];
+        this._includeSpecified = false;
+        this._fetchAll = false;
+        if (!query)
+            return;
+        const parsedQuery = qs.parse(query);
+        if (parsedQuery?.include !== undefined) {
+            this._includeSpecified = true;
+            if (parsedQuery.include) {
+                parsedQuery.include.split(",").forEach((type) => {
+                    this._includedType.push(type);
+                });
+            }
+        }
+        if (parsedQuery?.fields) {
+            Object.entries(parsedQuery.fields).forEach(([key, value]) => {
+                this._includedFields.push({ type: key, fields: value.split(",") });
+            });
+        }
+        if (parsedQuery.page?.size)
+            this._pagination.size = +parsedQuery.page.size;
+        if (parsedQuery.page?.offset)
+            this._pagination.offset = +parsedQuery.page.offset;
+        if (parsedQuery.page?.forcedNext)
+            this._pagination.forcedNext = parsedQuery.page.forcedNext;
+        if (parsedQuery.fetchAll === "true" || parsedQuery.fetchAll === true)
+            this._fetchAll = true;
+        this._additionalParams = Object.keys(query)
+            .filter((key) => key !== "page[size]" &&
+            key !== "page[offset]" &&
+            key !== "page[before]" &&
+            key !== "page[after]" &&
+            (typeof query[key] !== "object" || query[key] === null))
+            .map((key) => `${key}=${query[key]}`)
+            .join("&");
+        if (this._additionalParams.length > 0)
+            this._additionalParams = "&" + this._additionalParams;
+    }
+    set forceNext(forceNext) {
+        this._pagination.forcedNext = forceNext;
+    }
+    generateLinks(data, url) {
+        if (this._fetchAll) {
+            return { self: url };
+        }
+        const response = {
+            self: "",
+            next: undefined,
+            previous: undefined,
+        };
+        this.updatePagination(data);
+        if (!this._pagination.size)
+            this._pagination.size = this._paginationCount;
+        // Check if URL already has query parameters (from CLS request URL)
+        // If so, don't append _additionalParams as they're already in the URL
+        const urlHasQueryParams = url.includes("?");
+        if (data.length === this.size) {
+            const urlSelf = new URL(url);
+            urlSelf.searchParams.set("page[size]", this._pagination.size.toString());
+            urlSelf.searchParams.delete("page[offset]");
+            response.self = urlSelf.toString().replace(/%5B/g, "[").replace(/%5D/g, "]").replace(/%2C/g, ",");
+            if (this._additionalParams && !urlHasQueryParams)
+                response.self += this._additionalParams;
+            if (this._pagination.forcedNext) {
+                const urlNext = new URL(url);
+                urlNext.searchParams.set("page[size]", this._pagination.size.toString());
+                urlNext.searchParams.set("page[offset]", this._pagination.forcedNext);
+                response.next = urlNext.toString().replace(/%5B/g, "[").replace(/%5D/g, "]").replace(/%2C/g, ",");
+                if (this._additionalParams && !urlHasQueryParams)
+                    response.next += this._additionalParams;
+            }
+            else if (this._pagination.offsetNext) {
+                const urlNext = new URL(url);
+                urlNext.searchParams.set("page[size]", this._pagination.size.toString());
+                urlNext.searchParams.set("page[offset]", this._pagination.offsetNext.toString());
+                response.next = urlNext.toString().replace(/%5B/g, "[").replace(/%5D/g, "]").replace(/%2C/g, ",");
+                if (this._additionalParams && !urlHasQueryParams)
+                    response.next += this._additionalParams;
+            }
+            data.splice(this._pagination.size, 1);
+        }
+        if (this._pagination.offsetPrevious) {
+            const urlPrev = new URL(url);
+            urlPrev.searchParams.set("page[size]", this._pagination.size.toString());
+            urlPrev.searchParams.set("page[offset]", (this._pagination.offset - this._pagination.size).toString());
+            response.previous = urlPrev.toString().replace(/%5B/g, "[").replace(/%5D/g, "]").replace(/%2C/g, ",");
+            if (this._additionalParams && !urlHasQueryParams)
+                response.previous += this._additionalParams;
+        }
+        return response;
+    }
+    updatePagination(data) {
+        const hasEnoughData = data.length >= this.size;
+        if (!this._pagination.forcedNext) {
+            if (hasEnoughData)
+                this._pagination.offsetNext = (this._pagination.offset ?? 0) + this._pagination.size;
+            if (this._pagination.offset)
+                this._pagination.offsetPrevious = this._pagination.offset - this.size;
+        }
+    }
+    get paginationCount() {
+        return this._paginationCount;
+    }
+    get size() {
+        return (this._pagination?.size ?? this._paginationCount) + 1;
+    }
+    get pagination() {
+        return this._pagination;
+    }
+    get includedFields() {
+        return this._includedFields;
+    }
+    get includedType() {
+        return this._includedType;
+    }
+    get includeSpecified() {
+        return this._includeSpecified;
+    }
+    get fetchAll() {
+        return this._fetchAll;
+    }
+    generateCursor() {
+        if (this._fetchAll) {
+            return undefined;
+        }
+        const cursor = {
+            cursor: this._pagination.offset,
+            take: this.size,
+        };
+        return cursor;
+    }
+}
+exports.JsonApiPaginator = JsonApiPaginator;
+//# sourceMappingURL=jsonapi.paginator.js.map