@rsdk/cli.cmd.autodoc 6.0.0-next.4 → 6.0.0-next.40

package/src/generators/openapi-json/schemas/config.schema.ts

@@ -0,0 +1,37 @@
+import { OpenApiOptions } from '@rsdk/http.openapi';
+import type { Static } from '@sinclair/typebox';
+import { Type } from '@sinclair/typebox';
+
+/**
+ * Configuration schema for OpenAPI document generation.
+ * @example
+ * {
+ *   "out": "openapi.json",
+ *   "app": "./dist/app.js",
+ *   "title": "My API",
+ *   "version": "1.0.0",
+ *   "description": "API Description",
+ *   "includeZones": ["public"],
+ *   "excludeZones": ["internal"],
+ *   "security": {
+ *     "jwt": {
+ *       "type": "http",
+ *       "scheme": "bearer",
+ *       "bearerFormat": "JWT",
+ *       "name": "JWT Auth"
+ *     }
+ *   }
+ * }
+ */
+export const OpenApiConfigSchema = Type.Intersect([
+  Type.Partial(OpenApiOptions),
+  Type.Object({
+    /** Output file path for the generated OpenAPI document */
+    out: Type.Optional(Type.String()),
+
+    /** Path to the application file (usually `dist/app.js`) */
+    app: Type.Optional(Type.String()),
+  }),
+]);
+
+export type OpenApiConfigSchema = Static<typeof OpenApiConfigSchema>;

package/src/generators/openapi-json/schemas/index.ts

@@ -0,0 +1 @@
+export * from './config.schema';

package/src/generators/rsdk-json/index.ts

@@ -0,0 +1 @@
+export * from './rsdk-json.generator';

package/src/generators/rsdk-json/rsdk-json.generator.ts

@@ -0,0 +1,24 @@
+import type { PlatformApp } from '@rsdk/core';
+import { LoggerFactory } from '@rsdk/logging';
+import type { Resource } from '@rsdk/metadata';
+
+import { FileGenerator } from '../file-generator.interface';
+
+export class RsdkFileGenerator extends FileGenerator {
+  constructor(private readonly app: PlatformApp) {
+    super(LoggerFactory.create(RsdkFileGenerator));
+  }
+
+  protected async getContent(): Promise<string> {
+    const rsdkMetadata = await this.getAllResources();
+    const metadata = await this.app.getMetadata();
+
+    return JSON.stringify({ metadata, rsdkMetadata }, null, 2);
+  }
+
+  private async getAllResources(): Promise<Resource<unknown>[]> {
+    const provider = await this.app.context.getRsdkMetadataProvider();
+
+    return provider.get();
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { AutodocCommand as default } from './commands/autodoc.cmd';

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": [
+    "node_modules",
+    "dist",
+    "test",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.test.e2e.ts",
+    "**/*.test.manual-e2e.ts",
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "@rsdk/tsconfig/base.json",
+  "compilerOptions": {
+    "declaration": true,
+    "outDir": "dist"
+  }
+}