@morphql/server 0.1.7 → 0.1.9

package/dist/src/app.module.js

@@ -9,6 +9,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppModule = void 0;
 const common_1 = require("@nestjs/common");
 const morph_controller_js_1 = require("./morph.controller.js");
+const staged_queries_service_js_1 = require("./staged-queries.service.js");
+const documentation_service_js_1 = require("./documentation.service.js");
 let AppModule = class AppModule {
 };
 exports.AppModule = AppModule;
@@ -16,7 +18,7 @@ exports.AppModule = AppModule = __decorate([
     (0, common_1.Module)({
         imports: [],
         controllers: [morph_controller_js_1.MorphController],
-        providers: [],
+        providers: [staged_queries_service_js_1.StagedQueriesService, documentation_service_js_1.DocumentationService],
     })
 ], AppModule);
 //# sourceMappingURL=app.module.js.map

package/dist/src/app.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,+DAAwD;AAOjD,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IALrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,CAAC,qCAAe,CAAC;QAC9B,SAAS,EAAE,EAAE;KACd,CAAC;GACW,SAAS,CAAG"}
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,+DAAwD;AACxD,2EAAmE;AACnE,yEAAkE;AAO3D,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IALrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,CAAC,qCAAe,CAAC;QAC9B,SAAS,EAAE,CAAC,gDAAoB,EAAE,+CAAoB,CAAC;KACxD,CAAC;GACW,SAAS,CAAG"}

package/dist/src/documentation.service.d.ts

@@ -0,0 +1,13 @@
+import { OnModuleInit } from '@nestjs/common';
+import { StagedQueriesService } from './staged-queries.service.js';
+export declare class DocumentationService implements OnModuleInit {
+    private readonly stagedQueriesService;
+    private readonly logger;
+    private readonly docsDir;
+    constructor(stagedQueriesService: StagedQueriesService);
+    onModuleInit(): Promise<void>;
+    refresh(): Promise<void>;
+    private generateQuerySpec;
+    private getMimeType;
+    getDocFragments(): any[];
+}

package/dist/src/documentation.service.js

@@ -0,0 +1,151 @@
+"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 __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 __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;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var DocumentationService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentationService = void 0;
+const common_1 = require("@nestjs/common");
+const staged_queries_service_js_1 = require("./staged-queries.service.js");
+const swagger_helper_js_1 = require("./swagger.helper.js");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+let DocumentationService = DocumentationService_1 = class DocumentationService {
+    stagedQueriesService;
+    logger = new common_1.Logger(DocumentationService_1.name);
+    docsDir = path.join(process.cwd(), 'staged-docs');
+    constructor(stagedQueriesService) {
+        this.stagedQueriesService = stagedQueriesService;
+    }
+    async onModuleInit() {
+        await this.refresh();
+    }
+    async refresh() {
+        await this.stagedQueriesService.waitReady();
+        if (!fs.existsSync(this.docsDir)) {
+            fs.mkdirSync(this.docsDir, { recursive: true });
+        }
+        const queries = this.stagedQueriesService.getQueries();
+        this.logger.log(`Refreshing documentation for ${queries.length} staged queries`);
+        for (const query of queries) {
+            const spec = await this.generateQuerySpec(query);
+            const filePath = path.join(this.docsDir, `${query.name}.json`);
+            fs.writeFileSync(filePath, JSON.stringify(spec, null, 2));
+        }
+    }
+    async generateQuerySpec(query) {
+        const requestSchema = swagger_helper_js_1.SwaggerHelper.schemaNodeToOpenAPI(query.analysis.source, query.meta);
+        const responseSchema = swagger_helper_js_1.SwaggerHelper.schemaNodeToOpenAPI(query.analysis.target, query.meta);
+        try {
+            const sampleInput = swagger_helper_js_1.SwaggerHelper.schemaToSample(requestSchema);
+            const responseExample = await query.engine(sampleInput);
+            responseSchema.example = responseExample;
+        }
+        catch (e) {
+            this.logger.warn(`Failed to generate automatic response example for ${query.name}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        const sourceMime = this.getMimeType(query.analysis.sourceFormat);
+        const targetMime = this.getMimeType(query.analysis.targetFormat);
+        if (sourceMime === 'application/xml') {
+            requestSchema.xml = { name: 'root' };
+        }
+        if (targetMime === 'application/xml') {
+            responseSchema.xml = { name: 'root' };
+        }
+        return {
+            paths: {
+                [`/v1/q/${query.name}`]: {
+                    post: {
+                        tags: ['Staged Queries'],
+                        summary: `Execute staged query: ${query.name}`,
+                        operationId: `execute_${query.name}`,
+                        requestBody: {
+                            required: true,
+                            content: {
+                                [sourceMime]: {
+                                    schema: requestSchema,
+                                },
+                            },
+                        },
+                        responses: {
+                            '200': {
+                                description: 'Successful transformation',
+                                content: {
+                                    [targetMime]: {
+                                        schema: responseSchema,
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    getMimeType(format) {
+        switch (format?.toLowerCase()) {
+            case 'json':
+                return 'application/json';
+            case 'xml':
+                return 'application/xml';
+            default:
+                return 'text/plain';
+        }
+    }
+    getDocFragments() {
+        if (!fs.existsSync(this.docsDir))
+            return [];
+        const files = fs
+            .readdirSync(this.docsDir)
+            .filter((f) => f.endsWith('.json'));
+        return files.map((file) => {
+            const content = fs.readFileSync(path.join(this.docsDir, file), 'utf-8');
+            return JSON.parse(content);
+        });
+    }
+};
+exports.DocumentationService = DocumentationService;
+exports.DocumentationService = DocumentationService = DocumentationService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [staged_queries_service_js_1.StagedQueriesService])
+], DocumentationService);
+//# sourceMappingURL=documentation.service.js.map

package/dist/src/documentation.service.js.map

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

package/dist/src/generate-docs.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/generate-docs.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@nestjs/core");
+const app_module_js_1 = require("../src/app.module.js");
+const documentation_service_js_1 = require("../src/documentation.service.js");
+const staged_queries_service_js_1 = require("../src/staged-queries.service.js");
+async function generate() {
+    console.log('Starting MorphQL Documentation Generation...');
+    const app = await core_1.NestFactory.createApplicationContext(app_module_js_1.AppModule, {
+        logger: ['error', 'warn'],
+    });
+    const stagedQueriesService = app.get(staged_queries_service_js_1.StagedQueriesService);
+    const docService = app.get(documentation_service_js_1.DocumentationService);
+    await stagedQueriesService.loadQueries();
+    await docService.refresh();
+    console.log('Documentation generated successfully in staged-docs/');
+    await app.close();
+}
+generate().catch((err) => {
+    console.error('Failed to generate documentation:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=generate-docs.js.map

package/dist/src/generate-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-docs.js","sourceRoot":"","sources":["../../src/generate-docs.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,wDAAiD;AACjD,8EAAuE;AACvE,gFAAwE;AAExE,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,wBAAwB,CAAC,yBAAS,EAAE;QAChE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IAEH,MAAM,oBAAoB,GAAG,GAAG,CAAC,GAAG,CAAC,gDAAoB,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,+CAAoB,CAAC,CAAC;IAEjD,MAAM,oBAAoB,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;IAE3B,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACpE,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACvB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/main.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@nestjs/core");
 const app_module_js_1 = require("./app.module.js");
 const swagger_1 = require("@nestjs/swagger");
+const documentation_service_js_1 = require("./documentation.service.js");
 async function bootstrap() {
     const app = await core_1.NestFactory.create(app_module_js_1.AppModule);
     const config = new swagger_1.DocumentBuilder()
@@ -12,6 +13,18 @@ async function bootstrap() {
         .addApiKey({ type: 'apiKey', name: 'X-API-KEY', in: 'header' }, 'X-API-KEY')
         .build();
     const document = swagger_1.SwaggerModule.createDocument(app, config);
+    const docService = app.get(documentation_service_js_1.DocumentationService);
+    const fragments = docService.getDocFragments();
+    for (const fragment of fragments) {
+        if (fragment.paths) {
+            Object.assign(document.paths, fragment.paths);
+        }
+        if (fragment.components?.schemas) {
+            document.components = document.components || {};
+            document.components.schemas = document.components.schemas || {};
+            Object.assign(document.components.schemas, fragment.components.schemas);
+        }
+    }
     swagger_1.SwaggerModule.setup('api', app, document);
     await app.listen(process.env.PORT ?? 3000);
 }

package/dist/src/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,mDAA4C;AAC5C,6CAAiE;AAEjE,KAAK,UAAU,SAAS;IACtB,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,yBAAS,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SACjC,QAAQ,CAAC,aAAa,CAAC;SACvB,cAAc,CAAC,iCAAiC,CAAC;SACjD,UAAU,CAAC,KAAK,CAAC;SACjB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC;SAC3E,KAAK,EAAE,CAAC;IACX,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,uBAAa,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE1C,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AAC7C,CAAC;AACD,SAAS,EAAE,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,mDAA4C;AAC5C,6CAAgF;AAChF,yEAAkE;AAElE,KAAK,UAAU,SAAS;IACtB,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,yBAAS,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,IAAI,yBAAe,EAAE;SACjC,QAAQ,CAAC,aAAa,CAAC;SACvB,cAAc,CAAC,iCAAiC,CAAC;SACjD,UAAU,CAAC,KAAK,CAAC;SACjB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC;SAC3E,KAAK,EAAE,CAAC;IACX,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAG3D,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,+CAAoB,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;YACjC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;YAChD,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;YAChE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,uBAAa,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE1C,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AAC7C,CAAC;AACD,SAAS,EAAE,CAAC"}

package/dist/src/morph.controller.d.ts

@@ -1,3 +1,5 @@
+import { StagedQueriesService } from './staged-queries.service.js';
+import { DocumentationService } from './documentation.service.js';
 export declare class ExecuteDto {
     query: string;
     data: Record<string, unknown>;
@@ -15,7 +17,16 @@ export declare class CompileResponseDto {
     code: string;
 }
 export declare class MorphController {
+    private readonly stagedQueriesService;
+    private readonly documentationService;
+    constructor(stagedQueriesService: StagedQueriesService, documentationService: DocumentationService);
     execute(body: ExecuteDto): Promise<ExecuteResponseDto>;
+    executeStaged(name: string, data: Record<string, unknown>, res: any): Promise<any>;
+    private detectMimeType;
+    refreshDocs(): Promise<{
+        success: boolean;
+        timestamp: string;
+    }>;
     compile(body: CompileDto): Promise<CompileResponseDto>;
     health(): {
         status: string;

package/dist/src/morph.controller.js

@@ -16,6 +16,8 @@ exports.MorphController = exports.CompileResponseDto = exports.ExecuteResponseDt
 const common_1 = require("@nestjs/common");
 const auth_guard_js_1 = require("./auth.guard.js");
 const core_1 = require("@morphql/core");
+const staged_queries_service_js_1 = require("./staged-queries.service.js");
+const documentation_service_js_1 = require("./documentation.service.js");
 const cache_services_1 = require("@morphql/core/cache-services");
 const swagger_1 = require("@nestjs/swagger");
 const redisHost = process.env.REDIS_HOST;
@@ -88,6 +90,12 @@ __decorate([
     __metadata("design:type", String)
 ], CompileResponseDto.prototype, "code", void 0);
 let MorphController = class MorphController {
+    stagedQueriesService;
+    documentationService;
+    constructor(stagedQueriesService, documentationService) {
+        this.stagedQueriesService = stagedQueriesService;
+        this.documentationService = documentationService;
+    }
     async execute(body) {
         if (!body.query || !body.data) {
             throw new common_1.BadRequestException('Missing query or data');
@@ -109,6 +117,39 @@ let MorphController = class MorphController {
             throw new common_1.InternalServerErrorException(message);
         }
     }
+    async executeStaged(name, data, res) {
+        const staged = this.stagedQueriesService.getQuery(name);
+        if (!staged) {
+            throw new common_1.BadRequestException(`Staged query not found: ${name}`);
+        }
+        try {
+            const result = await staged.engine(data);
+            const mimeType = this.detectMimeType(result);
+            res.setHeader('Content-Type', mimeType);
+            return result;
+        }
+        catch (e) {
+            console.error('Staged Execute Error:', e);
+            const message = e instanceof Error ? e.message : 'Unknown execution error';
+            throw new common_1.InternalServerErrorException(message);
+        }
+    }
+    detectMimeType(result) {
+        if (typeof result === 'string') {
+            const trimmed = result.trim();
+            if (trimmed.startsWith('<?xml') ||
+                (trimmed.startsWith('<') && trimmed.endsWith('>'))) {
+                return 'application/xml';
+            }
+            return 'text/plain';
+        }
+        return 'application/json';
+    }
+    async refreshDocs() {
+        await this.stagedQueriesService.loadQueries();
+        await this.documentationService.refresh();
+        return { success: true, timestamp: new Date().toISOString() };
+    }
     async compile(body) {
         if (!body.query) {
             throw new common_1.BadRequestException('Missing query');
@@ -148,6 +189,27 @@ __decorate([
     __metadata("design:paramtypes", [ExecuteDto]),
     __metadata("design:returntype", Promise)
 ], MorphController.prototype, "execute", null);
+__decorate([
+    (0, common_1.Post)('q/:name'),
+    (0, swagger_1.ApiOperation)({ summary: 'Execute a staged transformation' }),
+    (0, swagger_1.ApiResponse)({ status: 200 }),
+    __param(0, (0, common_1.Param)('name')),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], MorphController.prototype, "executeStaged", null);
+__decorate([
+    (0, common_1.Post)('admin/refresh-docs'),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Refresh OpenApi documentation from staged queries',
+    }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'Documentation refreshed' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], MorphController.prototype, "refreshDocs", null);
 __decorate([
     (0, common_1.Post)('compile'),
     (0, swagger_1.ApiOperation)({ summary: 'Compile MorphQL to JavaScript' }),
@@ -182,6 +244,8 @@ exports.MorphController = MorphController = __decorate([
         required: false,
     }),
     (0, common_1.Controller)('v1'),
-    (0, common_1.UseGuards)(auth_guard_js_1.ApiKeyGuard)
+    (0, common_1.UseGuards)(auth_guard_js_1.ApiKeyGuard),
+    __metadata("design:paramtypes", [staged_queries_service_js_1.StagedQueriesService,
+        documentation_service_js_1.DocumentationService])
 ], MorphController);
 //# sourceMappingURL=morph.controller.js.map

package/dist/src/morph.controller.js.map

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

package/dist/src/staged-queries.service.d.ts

@@ -0,0 +1,21 @@
+import { OnModuleInit } from '@nestjs/common';
+import { MorphEngine, AnalyzeResult } from '@morphql/core';
+export interface StagedQuery {
+    name: string;
+    query: string;
+    engine: MorphEngine;
+    analysis: AnalyzeResult;
+    meta?: Record<string, any>;
+}
+export declare class StagedQueriesService implements OnModuleInit {
+    private readonly logger;
+    private readonly stagedQueries;
+    private readonly queriesDir;
+    private loadingPromise;
+    onModuleInit(): Promise<void>;
+    waitReady(): Promise<void>;
+    loadQueries(): Promise<void>;
+    private internalLoad;
+    getQueries(): StagedQuery[];
+    getQuery(name: string): StagedQuery | undefined;
+}

package/dist/src/staged-queries.service.js

@@ -0,0 +1,118 @@
+"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 __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 __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;
+    };
+})();
+var StagedQueriesService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StagedQueriesService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@morphql/core");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+let StagedQueriesService = StagedQueriesService_1 = class StagedQueriesService {
+    logger = new common_1.Logger(StagedQueriesService_1.name);
+    stagedQueries = new Map();
+    queriesDir = process.env.MORPHQL_QUERIES_DIR || path.join(process.cwd(), 'queries');
+    loadingPromise = null;
+    async onModuleInit() {
+        await this.loadQueries();
+    }
+    async waitReady() {
+        if (this.loadingPromise) {
+            await this.loadingPromise;
+        }
+    }
+    async loadQueries() {
+        this.loadingPromise = this.internalLoad();
+        await this.loadingPromise;
+    }
+    async internalLoad() {
+        if (!fs.existsSync(this.queriesDir)) {
+            this.logger.warn(`Queries directory not found: ${this.queriesDir}`);
+            return;
+        }
+        const files = fs.readdirSync(this.queriesDir);
+        const morphFiles = files.filter((f) => f.endsWith('.morphql'));
+        this.logger.log(`Loading ${morphFiles.length} staged queries from ${this.queriesDir}`);
+        for (const file of morphFiles) {
+            const name = path.parse(file).name;
+            const filePath = path.join(this.queriesDir, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            try {
+                const engine = await (0, core_1.compile)(content, { analyze: true });
+                if (!engine.analysis) {
+                    this.logger.error(`Failed to analyze query: ${name}`);
+                    continue;
+                }
+                let meta;
+                const yamlPath = path.join(this.queriesDir, `${name}.meta.yaml`);
+                const jsonPath = path.join(this.queriesDir, `${name}.meta.json`);
+                if (fs.existsSync(yamlPath)) {
+                    meta = yaml.load(fs.readFileSync(yamlPath, 'utf-8'));
+                }
+                else if (fs.existsSync(jsonPath)) {
+                    meta = JSON.parse(fs.readFileSync(jsonPath, 'utf-8'));
+                }
+                this.stagedQueries.set(name, {
+                    name,
+                    query: content,
+                    engine,
+                    analysis: engine.analysis,
+                    meta,
+                });
+                this.logger.log(`Loaded staged query: ${name}${meta ? ' with metadata' : ''}`);
+            }
+            catch (e) {
+                this.logger.error(`Error compiling staged query ${name}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+    getQueries() {
+        return Array.from(this.stagedQueries.values());
+    }
+    getQuery(name) {
+        return this.stagedQueries.get(name);
+    }
+};
+exports.StagedQueriesService = StagedQueriesService;
+exports.StagedQueriesService = StagedQueriesService = StagedQueriesService_1 = __decorate([
+    (0, common_1.Injectable)()
+], StagedQueriesService);
+//# sourceMappingURL=staged-queries.service.js.map

package/dist/src/staged-queries.service.js.map

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

package/dist/src/swagger.helper.d.ts

@@ -0,0 +1,6 @@
+import { SchemaNode } from '@morphql/core';
+export declare class SwaggerHelper {
+    static schemaNodeToOpenAPI(node: SchemaNode, meta?: Record<string, any>, path?: string): any;
+    static schemaToSample(schema: any): any;
+    private static applyMeta;
+}

package/dist/src/swagger.helper.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerHelper = void 0;
+class SwaggerHelper {
+    static schemaNodeToOpenAPI(node, meta, path = '') {
+        if (node.type === 'any') {
+            const schema = {};
+            this.applyMeta(schema, path, meta);
+            return schema;
+        }
+        const typeMap = {
+            string: 'string',
+            number: 'number',
+            boolean: 'boolean',
+            object: 'object',
+            array: 'array',
+        };
+        const schema = {};
+        if (node.type === 'null') {
+            schema.nullable = true;
+        }
+        else {
+            schema.type = typeMap[node.type] || 'object';
+        }
+        this.applyMeta(schema, path, meta);
+        if (node.type === 'object') {
+            if (node.properties && Object.keys(node.properties).length > 0) {
+                schema.properties = {};
+                for (const [key, childNode] of Object.entries(node.properties)) {
+                    const childPath = path ? `${path}.${key}` : key;
+                    schema.properties[key] = this.schemaNodeToOpenAPI(childNode, meta, childPath);
+                }
+            }
+            if (node.isOpen) {
+                schema.additionalProperties = true;
+            }
+        }
+        if (node.type === 'array' && node.items) {
+            schema.items = this.schemaNodeToOpenAPI(node.items, meta, path);
+        }
+        return schema;
+    }
+    static schemaToSample(schema) {
+        if (schema.example !== undefined)
+            return schema.example;
+        if (schema.type === 'object') {
+            const obj = {};
+            if (schema.properties) {
+                for (const [key, value] of Object.entries(schema.properties)) {
+                    obj[key] = this.schemaToSample(value);
+                }
+            }
+            return obj;
+        }
+        if (schema.type === 'array') {
+            if (schema.items) {
+                return [this.schemaToSample(schema.items)];
+            }
+            return [];
+        }
+        const defaults = {
+            string: 'string',
+            number: 0,
+            boolean: true,
+        };
+        if (schema.type === undefined) {
+            return 'sample';
+        }
+        return defaults[schema.type] ?? null;
+    }
+    static applyMeta(schema, path, meta) {
+        if (!meta || !path)
+            return;
+        const entry = meta[path];
+        if (entry) {
+            if (entry.type)
+                schema.type = entry.type;
+            if (entry.description)
+                schema.description = entry.description;
+            if (entry.example !== undefined)
+                schema.example = entry.example;
+        }
+    }
+}
+exports.SwaggerHelper = SwaggerHelper;
+//# sourceMappingURL=swagger.helper.js.map