@carlonicora/nestjs-neo4jsonapi 1.22.0 → 1.23.0

package/dist/bootstrap/app.module.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.factory.d.ts","sourceRoot":"","sources":["../../src/bootstrap/app.module.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAkB7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAmHpE"}
+{"version":3,"file":"app.module.factory.d.ts","sourceRoot":"","sources":["../../src/bootstrap/app.module.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAmB7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAsHpE"}

package/dist/bootstrap/app.module.factory.js

@@ -56,6 +56,7 @@ const discord_module_1 = require("../foundations/discord/discord.module");
 const app_mode_module_1 = require("../core/appmode/app.mode.module");
 const core_module_1 = require("../core/core.module");
 const foundations_modules_1 = require("../foundations/foundations.modules");
+const openapi_module_1 = require("../openapi/module/openapi.module");
 /**
  * Creates a dynamic AppModule based on bootstrap options.
  *
@@ -145,6 +146,8 @@ function createAppModule(options) {
                     }),
                     // Library's AI agents (prompts configured via baseConfig.prompts)
                     agents_modules_1.AgentsModule,
+                    // OpenAPI module for Swagger/Redoc documentation
+                    openapi_module_1.OpenApiModule,
                     // User's app-specific modules (MUST be before NecordModule so Necord can discover handlers)
                     ...options.appModules,
                     // Discord bot (only in worker mode when token is configured)

package/dist/bootstrap/app.module.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.factory.js","sourceRoot":"","sources":["../../src/bootstrap/app.module.factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.module.factory.js","sourceRoot":"","sources":["../../src/bootstrap/app.module.factory.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap/bootstrap.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBxE"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap/bootstrap.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBxE"}

package/dist/bootstrap/bootstrap.js

@@ -5,8 +5,10 @@ const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const core_1 = require("@nestjs/core");
 const platform_fastify_1 = require("@nestjs/platform-fastify");
+const swagger_1 = require("@nestjs/swagger");
 const stream_1 = require("stream");
 const http_exception_filter_1 = require("../common/filters/http-exception.filter");
+const openapi_service_1 = require("../openapi/module/openapi.service");
 const app_mode_constant_1 = require("../core/appmode/constants/app.mode.constant");
 const cache_interceptor_1 = require("../core/cache/interceptors/cache.interceptor");
 const cache_service_1 = require("../core/cache/services/cache.service");
@@ -59,7 +61,7 @@ async function bootstrap(options) {
             await bootstrapWorker(AppModule, modeConfig);
         }
         else {
-            await bootstrapAPI(AppModule, modeConfig);
+            await bootstrapAPI(AppModule, modeConfig, options);
         }
     }
     catch (error) {
@@ -70,7 +72,7 @@ async function bootstrap(options) {
 /**
  * Bootstrap the application in API mode with Fastify
  */
-async function bootstrapAPI(AppModule, modeConfig) {
+async function bootstrapAPI(AppModule, modeConfig, options) {
     const app = await core_1.NestFactory.create(AppModule.forRoot(modeConfig), new platform_fastify_1.FastifyAdapter(defaults_1.defaultFastifyOptions), { logger: ["error", "warn"] });
     const configService = app.get((config_1.ConfigService));
     const loggingService = app.get(logging_service_1.AppLoggingService);
@@ -105,6 +107,8 @@ async function bootstrapAPI(AppModule, modeConfig) {
     const corsService = app.get(cors_service_1.CorsService);
     corsService.validateConfiguration();
     app.enableCors(corsService.getCorsConfiguration());
+    // Setup OpenAPI documentation
+    await setupOpenApiDocs(app, options, loggingService);
     // Start server
     const port = configService.get("api").port;
     await app.listen(port, "0.0.0.0");
@@ -157,6 +161,85 @@ function setupFastifyLoggingHook(app, loggingService) {
         return payload;
     });
 }
+/**
+ * Setup OpenAPI documentation (Swagger UI and/or Redoc)
+ */
+async function setupOpenApiDocs(app, options, loggingService) {
+    const openApiConfig = options.openApi;
+    if (!openApiConfig?.enableSwagger && !openApiConfig?.enableRedoc) {
+        return;
+    }
+    const { title = "API Documentation", description = "Auto-generated API documentation", version = "1.0.0", bearerAuth = true, contactEmail, license, licenseUrl, swaggerPath = "/api-docs", redocPath = "/docs", } = openApiConfig;
+    // Build OpenAPI document
+    const documentBuilder = new swagger_1.DocumentBuilder().setTitle(title).setDescription(description).setVersion(version);
+    if (bearerAuth) {
+        documentBuilder.addBearerAuth({
+            type: "http",
+            scheme: "bearer",
+            bearerFormat: "JWT",
+            description: "Enter your JWT token",
+        }, "JWT-auth");
+    }
+    if (contactEmail) {
+        documentBuilder.setContact("API Support", "", contactEmail);
+    }
+    if (license) {
+        documentBuilder.setLicense(license, licenseUrl || "");
+    }
+    const config = documentBuilder.build();
+    // Get schemas from OpenApiService
+    let extraSchemas = {};
+    try {
+        const openApiService = app.get(openapi_service_1.OpenApiService);
+        // Register entity descriptors if provided
+        if (openApiConfig.entityDescriptors && openApiConfig.entityDescriptors.length > 0) {
+            openApiService.registerEntities(openApiConfig.entityDescriptors);
+            loggingService.log(`Registered ${openApiConfig.entityDescriptors.length} entities with OpenAPI`);
+        }
+        extraSchemas = openApiService.getAllSchemas();
+    }
+    catch {
+        loggingService.warn("OpenApiService not available, using base schemas only");
+    }
+    // Create document with extra schemas
+    const document = swagger_1.SwaggerModule.createDocument(app, config, {
+        extraModels: [],
+    });
+    // Merge extra schemas into components
+    document.components = document.components || {};
+    document.components.schemas = {
+        ...document.components.schemas,
+        ...extraSchemas,
+    };
+    // Setup Swagger UI
+    if (openApiConfig.enableSwagger) {
+        swagger_1.SwaggerModule.setup(swaggerPath, app, document, {
+            swaggerOptions: {
+                persistAuthorization: true,
+                docExpansion: "none",
+                filter: true,
+                showRequestDuration: true,
+            },
+        });
+        loggingService.log(`Swagger UI available at ${swaggerPath}`);
+    }
+    // Setup Redoc
+    if (openApiConfig.enableRedoc) {
+        try {
+            const { RedocModule } = await import("nestjs-redoc");
+            await RedocModule.setup(redocPath, app, document, {
+                title: title,
+                sortPropsAlphabetically: true,
+                hideDownloadButton: false,
+                hideHostname: false,
+            });
+            loggingService.log(`Redoc available at ${redocPath}`);
+        }
+        catch {
+            loggingService.warn("Failed to setup Redoc. Make sure nestjs-redoc is installed.");
+        }
+    }
+}
 /**
  * Setup graceful shutdown handlers for SIGTERM and SIGINT
  */

package/dist/bootstrap/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap/bootstrap.options.d.ts

@@ -1,4 +1,5 @@
 import { DynamicModule, Type } from "@nestjs/common";
+import { EntityDescriptor, RelationshipDef } from "../common/interfaces/entity.schema.interface";
 import { ContentExtensionConfig } from "../foundations/content/interfaces/content.extension.interface";
 /**
  * i18n configuration options
@@ -52,5 +53,51 @@ export interface BootstrapOptions {
      * ```
      */
     contentExtension?: ContentExtensionConfig;
+    /**
+     * OpenAPI documentation configuration.
+     * When provided, sets up Swagger UI and/or Redoc documentation endpoints.
+     *
+     * @example
+     * ```typescript
+     * openApi: {
+     *   enableSwagger: true,
+     *   swaggerPath: '/api-docs',
+     *   enableRedoc: true,
+     *   redocPath: '/docs',
+     *   title: 'My API',
+     *   version: '1.0.0',
+     * }
+     * ```
+     */
+    openApi?: OpenApiOptions;
+}
+/**
+ * OpenAPI documentation options
+ */
+export interface OpenApiOptions {
+    /** Enable Swagger UI endpoint (default: false) */
+    enableSwagger?: boolean;
+    /** Path for Swagger UI (default: '/api-docs') */
+    swaggerPath?: string;
+    /** Enable Redoc endpoint (default: false) */
+    enableRedoc?: boolean;
+    /** Path for Redoc (default: '/docs') */
+    redocPath?: string;
+    /** API documentation title */
+    title?: string;
+    /** API documentation description */
+    description?: string;
+    /** API version */
+    version?: string;
+    /** Enable JWT Bearer authentication in docs (default: true) */
+    bearerAuth?: boolean;
+    /** Contact email for API */
+    contactEmail?: string;
+    /** License name */
+    license?: string;
+    /** License URL */
+    licenseUrl?: string;
+    /** Entity descriptors to register for OpenAPI schema generation */
+    entityDescriptors?: EntityDescriptor<any, Record<string, RelationshipDef>>[];
 }
 //# sourceMappingURL=bootstrap.options.d.ts.map

package/dist/bootstrap/bootstrap.options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.options.d.ts","sourceRoot":"","sources":["../../src/bootstrap/bootstrap.options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAEvG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IAE1C;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnC;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}
+{"version":3,"file":"bootstrap.options.d.ts","sourceRoot":"","sources":["../../src/bootstrap/bootstrap.options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAEvG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IAE1C;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnC;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;CAC9E"}

package/dist/bootstrap/index.d.ts

@@ -42,7 +42,7 @@ import { AppMode, AppModeConfig } from "../core/appmode/constants/app.mode.const
 export { AppMode, AppModeConfig };
 export { createAppModule } from "./app.module.factory";
 export { bootstrap } from "./bootstrap";
-export { BootstrapOptions, I18nOptions } from "./bootstrap.options";
+export { BootstrapOptions, I18nOptions, OpenApiOptions } from "./bootstrap.options";
 export { defaultFastifyOptions, defaultMultipartOptions, getAppMode, getAppModeConfig } from "./defaults";
 export { RAW_BODY_ROUTES, setupRawBodyCapture } from "./raw-body.config";
 //# sourceMappingURL=index.d.ts.map

package/dist/bootstrap/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bootstrap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAGlC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG1G,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bootstrap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAGlC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG1G,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -9,4 +9,5 @@ export * from "./core";
 export * from "./foundations";
 export * from "./agents";
 export * from "./bootstrap";
+export * from "./openapi";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAG9B,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -31,4 +31,6 @@ __exportStar(require("./foundations"), exports);
 __exportStar(require("./agents"), exports);
 // Bootstrap utilities
 __exportStar(require("./bootstrap"), exports);
+// OpenAPI module exports
+__exportStar(require("./openapi"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,iBAAiB;AACjB,2CAAyB;AAEzB,iBAAiB;AACjB,2CAAyB;AAEzB,sBAAsB;AACtB,yCAAuB;AAEvB,4BAA4B;AAC5B,gDAA8B;AAE9B,uBAAuB;AACvB,2CAAyB;AAEzB,sBAAsB;AACtB,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,iBAAiB;AACjB,2CAAyB;AAEzB,iBAAiB;AACjB,2CAAyB;AAEzB,sBAAsB;AACtB,yCAAuB;AAEvB,4BAA4B;AAC5B,gDAA8B;AAE9B,uBAAuB;AACvB,2CAAyB;AAEzB,sBAAsB;AACtB,8CAA4B;AAE5B,yBAAyB;AACzB,4CAA0B"}

package/dist/openapi/decorators/api-jsonapi-error.decorator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Options for @ApiJsonApiErrors decorator.
+ */
+export interface ApiJsonApiErrorsOptions {
+    badRequest?: boolean;
+    unauthorized?: boolean;
+    forbidden?: boolean;
+    notFound?: boolean;
+    unprocessable?: boolean;
+    serverError?: boolean;
+}
+/**
+ * Decorator that adds common JSON:API error responses to an endpoint.
+ * By default adds 401 (Unauthorized) and 500 (Server Error).
+ *
+ * @example
+ * @ApiJsonApiErrors()
+ * @Get()
+ * findAll() { ... }
+ *
+ * @example
+ * @ApiJsonApiErrors({ notFound: true })
+ * @Get(':id')
+ * findById() { ... }
+ */
+export declare function ApiJsonApiErrors(options?: ApiJsonApiErrorsOptions): MethodDecorator;
+/**
+ * Convenience decorator for read endpoints (GET by ID).
+ * Adds 401, 404, and 500 error responses.
+ */
+export declare function ApiJsonApiReadErrors(): MethodDecorator;
+/**
+ * Convenience decorator for list endpoints (GET all).
+ * Adds 401 and 500 error responses.
+ */
+export declare function ApiJsonApiListErrors(): MethodDecorator;
+/**
+ * Convenience decorator for create endpoints (POST).
+ * Adds 400, 401, 422, and 500 error responses.
+ */
+export declare function ApiJsonApiCreateErrors(): MethodDecorator;
+/**
+ * Convenience decorator for update endpoints (PUT/PATCH).
+ * Adds 400, 401, 404, 422, and 500 error responses.
+ */
+export declare function ApiJsonApiUpdateErrors(): MethodDecorator;
+/**
+ * Convenience decorator for delete endpoints (DELETE).
+ * Adds 401, 403, 404, and 500 error responses.
+ */
+export declare function ApiJsonApiDeleteErrors(): MethodDecorator;
+//# sourceMappingURL=api-jsonapi-error.decorator.d.ts.map

package/dist/openapi/decorators/api-jsonapi-error.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-jsonapi-error.decorator.d.ts","sourceRoot":"","sources":["../../../src/openapi/decorators/api-jsonapi-error.decorator.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,eAAe,CAmEvF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAEtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAEtD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAExD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAMxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAExD"}

package/dist/openapi/decorators/api-jsonapi-error.decorator.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiJsonApiErrors = ApiJsonApiErrors;
+exports.ApiJsonApiReadErrors = ApiJsonApiReadErrors;
+exports.ApiJsonApiListErrors = ApiJsonApiListErrors;
+exports.ApiJsonApiCreateErrors = ApiJsonApiCreateErrors;
+exports.ApiJsonApiUpdateErrors = ApiJsonApiUpdateErrors;
+exports.ApiJsonApiDeleteErrors = ApiJsonApiDeleteErrors;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+/**
+ * Decorator that adds common JSON:API error responses to an endpoint.
+ * By default adds 401 (Unauthorized) and 500 (Server Error).
+ *
+ * @example
+ * @ApiJsonApiErrors()
+ * @Get()
+ * findAll() { ... }
+ *
+ * @example
+ * @ApiJsonApiErrors({ notFound: true })
+ * @Get(':id')
+ * findById() { ... }
+ */
+function ApiJsonApiErrors(options = {}) {
+    const { badRequest = false, unauthorized = true, forbidden = false, notFound = false, unprocessable = false, serverError = true, } = options;
+    const decorators = [];
+    if (badRequest) {
+        decorators.push((0, swagger_1.ApiBadRequestResponse)({
+            description: "Bad Request - Invalid request parameters",
+            schema: { $ref: "#/components/schemas/JsonApi400ErrorResponse" },
+        }));
+    }
+    if (unauthorized) {
+        decorators.push((0, swagger_1.ApiUnauthorizedResponse)({
+            description: "Unauthorized - Valid JWT token required",
+            schema: { $ref: "#/components/schemas/JsonApi401ErrorResponse" },
+        }));
+    }
+    if (forbidden) {
+        decorators.push((0, swagger_1.ApiForbiddenResponse)({
+            description: "Forbidden - Insufficient permissions",
+            schema: { $ref: "#/components/schemas/JsonApi403ErrorResponse" },
+        }));
+    }
+    if (notFound) {
+        decorators.push((0, swagger_1.ApiNotFoundResponse)({
+            description: "Not Found - Resource does not exist",
+            schema: { $ref: "#/components/schemas/JsonApi404ErrorResponse" },
+        }));
+    }
+    if (unprocessable) {
+        decorators.push((0, swagger_1.ApiUnprocessableEntityResponse)({
+            description: "Unprocessable Entity - Validation failed",
+            schema: { $ref: "#/components/schemas/JsonApi422ErrorResponse" },
+        }));
+    }
+    if (serverError) {
+        decorators.push((0, swagger_1.ApiInternalServerErrorResponse)({
+            description: "Internal Server Error",
+            schema: { $ref: "#/components/schemas/JsonApi500ErrorResponse" },
+        }));
+    }
+    return (0, common_1.applyDecorators)(...decorators);
+}
+/**
+ * Convenience decorator for read endpoints (GET by ID).
+ * Adds 401, 404, and 500 error responses.
+ */
+function ApiJsonApiReadErrors() {
+    return ApiJsonApiErrors({ notFound: true });
+}
+/**
+ * Convenience decorator for list endpoints (GET all).
+ * Adds 401 and 500 error responses.
+ */
+function ApiJsonApiListErrors() {
+    return ApiJsonApiErrors();
+}
+/**
+ * Convenience decorator for create endpoints (POST).
+ * Adds 400, 401, 422, and 500 error responses.
+ */
+function ApiJsonApiCreateErrors() {
+    return ApiJsonApiErrors({ badRequest: true, unprocessable: true });
+}
+/**
+ * Convenience decorator for update endpoints (PUT/PATCH).
+ * Adds 400, 401, 404, 422, and 500 error responses.
+ */
+function ApiJsonApiUpdateErrors() {
+    return ApiJsonApiErrors({
+        badRequest: true,
+        notFound: true,
+        unprocessable: true,
+    });
+}
+/**
+ * Convenience decorator for delete endpoints (DELETE).
+ * Adds 401, 403, 404, and 500 error responses.
+ */
+function ApiJsonApiDeleteErrors() {
+    return ApiJsonApiErrors({ forbidden: true, notFound: true });
+}
+//# sourceMappingURL=api-jsonapi-error.decorator.js.map

package/dist/openapi/decorators/api-jsonapi-error.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-jsonapi-error.decorator.js","sourceRoot":"","sources":["../../../src/openapi/decorators/api-jsonapi-error.decorator.ts"],"names":[],"mappings":";;AAoCA,4CAmEC;AAMD,oDAEC;AAMD,oDAEC;AAMD,wDAEC;AAMD,wDAMC;AAMD,wDAEC;AAnJD,2CAAiD;AACjD,6CAOyB;AAczB;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EACJ,UAAU,GAAG,KAAK,EAClB,YAAY,GAAG,IAAI,EACnB,SAAS,GAAG,KAAK,EACjB,QAAQ,GAAG,KAAK,EAChB,aAAa,GAAG,KAAK,EACrB,WAAW,GAAG,IAAI,GACnB,GAAG,OAAO,CAAC;IAEZ,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,CACb,IAAA,+BAAqB,EAAC;YACpB,WAAW,EAAE,0CAA0C;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CACb,IAAA,iCAAuB,EAAC;YACtB,WAAW,EAAE,yCAAyC;YACtD,MAAM,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,CAAC,IAAI,CACb,IAAA,8BAAoB,EAAC;YACnB,WAAW,EAAE,sCAAsC;YACnD,MAAM,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,UAAU,CAAC,IAAI,CACb,IAAA,6BAAmB,EAAC;YAClB,WAAW,EAAE,qCAAqC;YAClD,MAAM,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,UAAU,CAAC,IAAI,CACb,IAAA,wCAA8B,EAAC;YAC7B,WAAW,EAAE,0CAA0C;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CACb,IAAA,wCAA8B,EAAC;YAC7B,WAAW,EAAE,uBAAuB;YACpC,MAAM,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,wBAAe,EAAC,GAAG,UAAU,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB;IACpC,OAAO,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB;IACpC,OAAO,gBAAgB,CAAC;QACtB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB;IACpC,OAAO,gBAAgB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/openapi/decorators/api-jsonapi-query.decorator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Decorator that documents standard JSON:API list query parameters.
+ * Adds documentation for: page[offset], page[size], orderBy, fetchAll, search
+ *
+ * @example
+ * @ApiJsonApiListQuery()
+ * @Get()
+ * findAll(@Query() query: any) { ... }
+ */
+export declare function ApiJsonApiListQuery(): MethodDecorator;
+/**
+ * Decorator that documents the JSON:API include parameter.
+ * Allows specifying which relationships can be included.
+ *
+ * @example
+ * @ApiJsonApiInclude(['roll', 'metadata', 'faces'])
+ * @Get()
+ * findAll(@Query('include') include?: string) { ... }
+ */
+export declare function ApiJsonApiInclude(allowedRelationships: string[]): MethodDecorator;
+/**
+ * Decorator that documents pagination query parameters only.
+ * Use when you need pagination but not orderBy/search.
+ *
+ * @example
+ * @ApiJsonApiPagination()
+ * @Get()
+ * findAll(@Query() query: any) { ... }
+ */
+export declare function ApiJsonApiPagination(): MethodDecorator;
+/**
+ * Decorator for documenting filter parameters.
+ *
+ * @example
+ * @ApiJsonApiFilter('status', ['active', 'pending', 'completed'])
+ * @Get()
+ * findAll(@Query('filter[status]') status?: string) { ... }
+ */
+export declare function ApiJsonApiFilter(fieldName: string, allowedValues?: string[], options?: {
+    description?: string;
+    required?: boolean;
+}): MethodDecorator;
+//# sourceMappingURL=api-jsonapi-query.decorator.d.ts.map

package/dist/openapi/decorators/api-jsonapi-query.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-jsonapi-query.decorator.d.ts","sourceRoot":"","sources":["../../../src/openapi/decorators/api-jsonapi-query.decorator.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,CAqCrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,oBAAoB,EAAE,MAAM,EAAE,GAAG,eAAe,CAcjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAiBtD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,eAAe,CAejB"}

package/dist/openapi/decorators/api-jsonapi-query.decorator.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiJsonApiListQuery = ApiJsonApiListQuery;
+exports.ApiJsonApiInclude = ApiJsonApiInclude;
+exports.ApiJsonApiPagination = ApiJsonApiPagination;
+exports.ApiJsonApiFilter = ApiJsonApiFilter;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+/**
+ * Decorator that documents standard JSON:API list query parameters.
+ * Adds documentation for: page[offset], page[size], orderBy, fetchAll, search
+ *
+ * @example
+ * @ApiJsonApiListQuery()
+ * @Get()
+ * findAll(@Query() query: any) { ... }
+ */
+function ApiJsonApiListQuery() {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiQuery)({
+        name: "page[offset]",
+        required: false,
+        type: Number,
+        description: "Number of records to skip (for pagination)",
+        example: 0,
+    }), (0, swagger_1.ApiQuery)({
+        name: "page[size]",
+        required: false,
+        type: Number,
+        description: "Number of records per page (default: 20, max: 100)",
+        example: 20,
+    }), (0, swagger_1.ApiQuery)({
+        name: "orderBy",
+        required: false,
+        type: String,
+        description: "Field to order by, prefix with - for descending (e.g., -createdAt)",
+        example: "-createdAt",
+    }), (0, swagger_1.ApiQuery)({
+        name: "fetchAll",
+        required: false,
+        type: Boolean,
+        description: "If true, returns all records without pagination (use with caution)",
+        example: false,
+    }), (0, swagger_1.ApiQuery)({
+        name: "search",
+        required: false,
+        type: String,
+        description: "Full-text search term",
+    }));
+}
+/**
+ * Decorator that documents the JSON:API include parameter.
+ * Allows specifying which relationships can be included.
+ *
+ * @example
+ * @ApiJsonApiInclude(['roll', 'metadata', 'faces'])
+ * @Get()
+ * findAll(@Query('include') include?: string) { ... }
+ */
+function ApiJsonApiInclude(allowedRelationships) {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiQuery)({
+        name: "include",
+        required: false,
+        type: String,
+        description: `Comma-separated list of relationships to include. Allowed: ${allowedRelationships.join(", ")}`,
+        example: allowedRelationships.slice(0, 2).join(","),
+        schema: {
+            type: "string",
+            description: `Allowed values: ${allowedRelationships.join(", ")}`,
+        },
+    }));
+}
+/**
+ * Decorator that documents pagination query parameters only.
+ * Use when you need pagination but not orderBy/search.
+ *
+ * @example
+ * @ApiJsonApiPagination()
+ * @Get()
+ * findAll(@Query() query: any) { ... }
+ */
+function ApiJsonApiPagination() {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiQuery)({
+        name: "page[offset]",
+        required: false,
+        type: Number,
+        description: "Number of records to skip",
+        example: 0,
+    }), (0, swagger_1.ApiQuery)({
+        name: "page[size]",
+        required: false,
+        type: Number,
+        description: "Number of records per page",
+        example: 20,
+    }));
+}
+/**
+ * Decorator for documenting filter parameters.
+ *
+ * @example
+ * @ApiJsonApiFilter('status', ['active', 'pending', 'completed'])
+ * @Get()
+ * findAll(@Query('filter[status]') status?: string) { ... }
+ */
+function ApiJsonApiFilter(fieldName, allowedValues, options = {}) {
+    const queryName = `filter[${fieldName}]`;
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiQuery)({
+        name: queryName,
+        required: options.required || false,
+        type: String,
+        description: options.description || `Filter by ${fieldName}`,
+        ...(allowedValues && {
+            enum: allowedValues,
+            example: allowedValues[0],
+        }),
+    }));
+}
+//# sourceMappingURL=api-jsonapi-query.decorator.js.map

package/dist/openapi/decorators/api-jsonapi-query.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-jsonapi-query.decorator.js","sourceRoot":"","sources":["../../../src/openapi/decorators/api-jsonapi-query.decorator.ts"],"names":[],"mappings":";;AAYA,kDAqCC;AAWD,8CAcC;AAWD,oDAiBC;AAUD,4CAmBC;AAnID,2CAAiD;AACjD,6CAA2C;AAE3C;;;;;;;;GAQG;AACH,SAAgB,mBAAmB;IACjC,OAAO,IAAA,wBAAe,EACpB,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,CAAC;KACX,CAAC,EACF,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,EAAE;KACZ,CAAC,EACF,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oEAAoE;QACjF,OAAO,EAAE,YAAY;KACtB,CAAC,EACF,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,oEAAoE;QACjF,OAAO,EAAE,KAAK;KACf,CAAC,EACF,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,uBAAuB;KACrC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,oBAA8B;IAC9D,OAAO,IAAA,wBAAe,EACpB,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,8DAA8D,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC5G,OAAO,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACnD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mBAAmB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAClE;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,oBAAoB;IAClC,OAAO,IAAA,wBAAe,EACpB,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2BAA2B;QACxC,OAAO,EAAE,CAAC;KACX,CAAC,EACF,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,4BAA4B;QACzC,OAAO,EAAE,EAAE;KACZ,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,SAAiB,EACjB,aAAwB,EACxB,UAAwD,EAAE;IAE1D,MAAM,SAAS,GAAG,UAAU,SAAS,GAAG,CAAC;IAEzC,OAAO,IAAA,wBAAe,EACpB,IAAA,kBAAQ,EAAC;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;QACnC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,aAAa,SAAS,EAAE;QAC5D,GAAG,CAAC,aAAa,IAAI;YACnB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;SAC1B,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC"}