@openapi-studio/nestjs 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './openapi-studio.module.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './openapi-studio.module.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/openapi-studio.module.d.ts

@@ -0,0 +1,82 @@
+import type { INestApplication } from '@nestjs/common';
+import type { HttpServer } from '@nestjs/common';
+import type { OpenAPIObject } from '@nestjs/swagger';
+/**
+ * Options for OpenApiStudio setup
+ */
+export interface OpenApiStudioOptions {
+    /**
+     * URL path where the OpenAPI JSON document will be served
+     * @default '/openapi.json'
+     */
+    jsonDocumentUrl?: string;
+    /**
+     * Clerk publishable key for authentication
+     */
+    clerkPublishableKey?: string;
+    /**
+     * Service host URL for API requests
+     */
+    serviceHost?: string;
+    /**
+     * OpenAPI spec URL (full URL to the OpenAPI JSON document)
+     * If not provided, will be constructed from serviceHost + jsonDocumentUrl
+     */
+    openApiSpecUrl?: string;
+    /**
+     * Whether to use the global prefix
+     * @default true
+     */
+    useGlobalPrefix?: boolean;
+    /**
+     * Custom path to the static assets directory
+     * If not provided, will use the default from @openapi-studio/core
+     */
+    customStaticPath?: string;
+    /**
+     * Custom path for the config.json file
+     * @default '/openapi-studio-config.json'
+     */
+    configJsonPath?: string;
+}
+/**
+ * @publicApi
+ */
+export declare class OpenApiStudioModule {
+    /**
+     * Sets up OpenApiStudio to serve the static application and OpenAPI document
+     * @param path - The path where OpenApiStudio will be served
+     * @param app - The NestJS application instance
+     * @param document - The OpenAPI document object
+     * @param options - Configuration options
+     */
+    static setup(path: string, app: INestApplication, document: OpenAPIObject, options?: OpenApiStudioOptions): void;
+    /**
+     * Serves static assets from the core/dist directory
+     */
+    protected static serveStatic(finalPath: string, app: INestApplication, customStaticPath?: string): void;
+    /**
+     * Serves the config.json file with the provided configuration
+     */
+    protected static serveConfigJson(httpAdapter: HttpServer, configJsonPath: string, options: OpenApiStudioOptions): void;
+    /**
+     * Serves the OpenAPI document at the specified path
+     */
+    protected static serveOpenApiDocument(httpAdapter: HttpServer, jsonDocumentUrl: string, document: OpenAPIObject): void;
+    /**
+     * Serves the index.html file for SPA routing
+     * This ensures that all routes under the finalPath serve the Vue app
+     */
+    protected static serveIndexHtml(finalPath: string, httpAdapter: HttpServer): void;
+    /**
+     * Registers a catch-all route for SPA routing
+     * This should be called after all other routes are registered
+     * to ensure that any unmatched routes serve the Vue app
+     *
+     * @param setupPath - The path prefix where OpenApiStudio is served
+     * @param app - The NestJS application instance
+     * @param options - Configuration options (must match the options used in setup)
+     */
+    static registerCatchAllRoute(setupPath: string, app: INestApplication, options?: OpenApiStudioOptions): void;
+}
+//# sourceMappingURL=openapi-studio.module.d.ts.map

package/dist/openapi-studio.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-studio.module.d.ts","sourceRoot":"","sources":["../src/openapi-studio.module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AASrD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC5B;;;;;;OAMG;WACW,KAAK,CACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,oBAAoB;IA4ClC;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,WAAW,CACxB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,EACrB,gBAAgB,CAAC,EAAE,MAAM;IAqB7B;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,eAAe,CAC5B,WAAW,EAAE,UAAU,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,oBAAoB;IAcjC;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,oBAAoB,CACjC,WAAW,EAAE,UAAU,EACvB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,aAAa;IAS3B;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,cAAc,CAC3B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU;IAgC3B;;;;;;;;OAQG;WACW,qBAAqB,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,oBAAoB;CA8BrC"}

package/dist/openapi-studio.module.js

@@ -0,0 +1,158 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { getGlobalPrefix } from './utils/get-global-prefix.util.js';
+import { validateGlobalPrefix } from './utils/validate-global-prefix.util.js';
+import { validatePath } from './utils/validate-path.util.js';
+import { getCoreDistAbsoluteFSPath } from './utils/get-core-dist-path.util.js';
+import { resolvePath } from './utils/resolve-path.util.js';
+/**
+ * @publicApi
+ */
+export class OpenApiStudioModule {
+    /**
+     * Sets up OpenApiStudio to serve the static application and OpenAPI document
+     * @param path - The path where OpenApiStudio will be served
+     * @param app - The NestJS application instance
+     * @param document - The OpenAPI document object
+     * @param options - Configuration options
+     */
+    static setup(path, app, document, options) {
+        console.log('options', options);
+        const globalPrefix = getGlobalPrefix(app);
+        const finalPath = validatePath(options?.useGlobalPrefix !== false && validateGlobalPrefix(globalPrefix)
+            ? `${globalPrefix}${validatePath(path)}`
+            : path);
+        const validatedGlobalPrefix = options?.useGlobalPrefix !== false && validateGlobalPrefix(globalPrefix)
+            ? validatePath(globalPrefix)
+            : '';
+        const jsonDocumentUrl = options?.jsonDocumentUrl
+            ? `${validatedGlobalPrefix}${validatePath(options.jsonDocumentUrl)}`
+            : `${validatedGlobalPrefix}/openapi.json`;
+        console.log('jsonDocumentUrl', jsonDocumentUrl);
+        const configJsonPath = options?.configJsonPath
+            ? `${validatedGlobalPrefix}${validatePath(options.configJsonPath)}`
+            : `${validatedGlobalPrefix}/openapi-studio-config.json`;
+        const httpAdapter = app.getHttpAdapter();
+        // Serve static files
+        OpenApiStudioModule.serveStatic(finalPath, app, options?.customStaticPath);
+        // Serve config.json
+        OpenApiStudioModule.serveConfigJson(httpAdapter, configJsonPath, options || {});
+        // Serve OpenAPI document
+        OpenApiStudioModule.serveOpenApiDocument(httpAdapter, jsonDocumentUrl, document);
+        // Serve the main HTML file for all routes (SPA routing)
+        OpenApiStudioModule.serveIndexHtml(finalPath, httpAdapter);
+    }
+    /**
+     * Serves static assets from the core/dist directory
+     */
+    static serveStatic(finalPath, app, customStaticPath) {
+        const httpAdapter = app.getHttpAdapter();
+        const staticAssetsPath = customStaticPath
+            ? resolvePath(customStaticPath)
+            : getCoreDistAbsoluteFSPath();
+        if (httpAdapter && httpAdapter.getType() === 'fastify') {
+            app.useStaticAssets({
+                root: staticAssetsPath,
+                prefix: finalPath,
+                decorateReply: false
+            });
+        }
+        else {
+            app.useStaticAssets(staticAssetsPath, {
+                prefix: finalPath
+            });
+        }
+    }
+    /**
+     * Serves the config.json file with the provided configuration
+     */
+    static serveConfigJson(httpAdapter, configJsonPath, options) {
+        const normalizedPath = validatePath(configJsonPath);
+        httpAdapter.get(normalizedPath, (_req, res) => {
+            res.type('application/json');
+            const config = {
+                ...(options.serviceHost && { serviceHost: options.serviceHost }),
+                ...(options.clerkPublishableKey && { clerkKey: options.clerkPublishableKey }),
+                ...(options.openApiSpecUrl && { openApiSpecUrl: options.openApiSpecUrl })
+            };
+            res.send(JSON.stringify(config));
+        });
+    }
+    /**
+     * Serves the OpenAPI document at the specified path
+     */
+    static serveOpenApiDocument(httpAdapter, jsonDocumentUrl, document) {
+        const normalizedPath = validatePath(jsonDocumentUrl);
+        httpAdapter.get(normalizedPath, (_req, res) => {
+            res.type('application/json');
+            res.send(JSON.stringify(document));
+        });
+    }
+    /**
+     * Serves the index.html file for SPA routing
+     * This ensures that all routes under the finalPath serve the Vue app
+     */
+    static serveIndexHtml(finalPath, httpAdapter) {
+        const distPath = getCoreDistAbsoluteFSPath();
+        const indexHtmlPath = path.join(distPath, 'index.html');
+        // Read index.html once
+        let indexHtml = null;
+        try {
+            indexHtml = fs.readFileSync(indexHtmlPath, 'utf-8');
+        }
+        catch (err) {
+            console.warn(`Could not read index.html from ${indexHtmlPath}`);
+            return;
+        }
+        const serveIndex = (_req, res) => {
+            res.type('text/html');
+            res.send(indexHtml);
+        };
+        // Serve index.html for the root path
+        httpAdapter.get(finalPath, serveIndex);
+        // Also serve for paths that might not match static files (SPA routing)
+        // This is a catch-all for the SPA - Vue Router will handle routing client-side
+        try {
+            const pathWithSlash = validatePath(`${finalPath}/`);
+            httpAdapter.get(pathWithSlash, serveIndex);
+        }
+        catch {
+            // Ignore errors if route already exists
+        }
+    }
+    /**
+     * Registers a catch-all route for SPA routing
+     * This should be called after all other routes are registered
+     * to ensure that any unmatched routes serve the Vue app
+     *
+     * @param setupPath - The path prefix where OpenApiStudio is served
+     * @param app - The NestJS application instance
+     * @param options - Configuration options (must match the options used in setup)
+     */
+    static registerCatchAllRoute(setupPath, app, options) {
+        const globalPrefix = getGlobalPrefix(app);
+        const finalPath = validatePath(options?.useGlobalPrefix !== false && validateGlobalPrefix(globalPrefix)
+            ? `${globalPrefix}${validatePath(setupPath)}`
+            : setupPath);
+        const httpAdapter = app.getHttpAdapter();
+        const distPath = getCoreDistAbsoluteFSPath();
+        const indexHtmlPath = path.join(distPath, 'index.html');
+        // Read index.html
+        let indexHtml = null;
+        try {
+            indexHtml = fs.readFileSync(indexHtmlPath, 'utf-8');
+        }
+        catch (err) {
+            console.warn(`Could not read index.html from ${indexHtmlPath}`);
+            return;
+        }
+        // Register catch-all route for SPA
+        // This matches any route under finalPath that doesn't match a static file
+        const catchAllPattern = `${finalPath}/*`;
+        httpAdapter.get(catchAllPattern, (_req, res) => {
+            res.type('text/html');
+            res.send(indexHtml);
+        });
+    }
+}
+//# sourceMappingURL=openapi-studio.module.js.map

package/dist/openapi-studio.module.js.map

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

package/dist/utils/get-core-dist-path.util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Gets the absolute filesystem path to the @openapi-studio/core dist directory
+ * Uses require.resolve to find the package location
+ */
+export declare function getCoreDistAbsoluteFSPath(): string;
+//# sourceMappingURL=get-core-dist-path.util.d.ts.map

package/dist/utils/get-core-dist-path.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-core-dist-path.util.d.ts","sourceRoot":"","sources":["../../src/utils/get-core-dist-path.util.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAmBlD"}

package/dist/utils/get-core-dist-path.util.js

@@ -0,0 +1,23 @@
+import * as path from 'path';
+import { createRequire } from 'module';
+/**
+ * Gets the absolute filesystem path to the @openapi-studio/core dist directory
+ * Uses require.resolve to find the package location
+ */
+export function getCoreDistAbsoluteFSPath() {
+    try {
+        // Use createRequire to get require in ES module context
+        const require = createRequire(import.meta.url);
+        // Resolve the @openapi-studio/core package
+        const corePackagePath = require.resolve('@openapi-studio/core/package.json');
+        // Get the directory containing package.json
+        const corePackageDir = path.dirname(corePackagePath);
+        // Return the dist directory path
+        return path.join(corePackageDir, 'dist');
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve @openapi-studio/core package path. ` +
+            `Make sure @openapi-studio/core is installed. Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=get-core-dist-path.util.js.map

package/dist/utils/get-core-dist-path.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-core-dist-path.util.js","sourceRoot":"","sources":["../../src/utils/get-core-dist-path.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACrC,IAAI,CAAC;QACD,wDAAwD;QACxD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/C,2CAA2C;QAC3C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAE7E,4CAA4C;QAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAErD,iCAAiC;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,uDAAuD;YACvD,uDAAuD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClH,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/utils/get-global-prefix.util.d.ts

@@ -0,0 +1,6 @@
+import type { INestApplication } from '@nestjs/common';
+/**
+ * Gets the global prefix from the NestJS application
+ */
+export declare function getGlobalPrefix(app: INestApplication): string;
+//# sourceMappingURL=get-global-prefix.util.d.ts.map

package/dist/utils/get-global-prefix.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-global-prefix.util.d.ts","sourceRoot":"","sources":["../../src/utils/get-global-prefix.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAM7D"}

package/dist/utils/get-global-prefix.util.js

@@ -0,0 +1,11 @@
+/**
+ * Gets the global prefix from the NestJS application
+ */
+export function getGlobalPrefix(app) {
+    const config = app.config;
+    if (config && config.getGlobalPrefix) {
+        return config.getGlobalPrefix() || '';
+    }
+    return '';
+}
+//# sourceMappingURL=get-global-prefix.util.js.map

package/dist/utils/get-global-prefix.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-global-prefix.util.js","sourceRoot":"","sources":["../../src/utils/get-global-prefix.util.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAqB;IACnD,MAAM,MAAM,GAAI,GAAW,CAAC,MAAM,CAAC;IACnC,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/utils/normalize-rel-path.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Normalizes a relative path for use in URLs
+ */
+export declare function normalizeRelPath(path: string): string;
+//# sourceMappingURL=normalize-rel-path.util.d.ts.map

package/dist/utils/normalize-rel-path.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-rel-path.util.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-rel-path.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBrD"}

package/dist/utils/normalize-rel-path.util.js

@@ -0,0 +1,22 @@
+/**
+ * Normalizes a relative path for use in URLs
+ */
+export function normalizeRelPath(path) {
+    if (!path) {
+        return './';
+    }
+    // Remove leading slash if present
+    if (path.startsWith('/')) {
+        path = path.slice(1);
+    }
+    // Ensure it ends with / if it's a directory
+    if (!path.endsWith('/') && !path.includes('.')) {
+        path = `${path}/`;
+    }
+    // Add ./ prefix for relative paths
+    if (!path.startsWith('./') && !path.startsWith('../')) {
+        path = `./${path}`;
+    }
+    return path;
+}
+//# sourceMappingURL=normalize-rel-path.util.js.map

package/dist/utils/normalize-rel-path.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-rel-path.util.js","sourceRoot":"","sources":["../../src/utils/normalize-rel-path.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC;IACpB,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/resolve-path.util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves a custom path to an absolute filesystem path
+ * @param customPath - The custom path to resolve (can be relative or absolute)
+ * @returns The absolute filesystem path
+ */
+export declare function resolvePath(customPath: string): string;
+//# sourceMappingURL=resolve-path.util.d.ts.map

package/dist/utils/resolve-path.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path.util.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-path.util.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/utils/resolve-path.util.js

@@ -0,0 +1,18 @@
+import * as path from 'path';
+/**
+ * Resolves a custom path to an absolute filesystem path
+ * @param customPath - The custom path to resolve (can be relative or absolute)
+ * @returns The absolute filesystem path
+ */
+export function resolvePath(customPath) {
+    if (typeof customPath !== 'string' || !customPath.trim()) {
+        throw new Error('Custom path must be a non-empty string');
+    }
+    // If it's already an absolute path, return it as-is
+    if (path.isAbsolute(customPath)) {
+        return customPath;
+    }
+    // Otherwise, resolve it relative to the current working directory
+    return path.resolve(process.cwd(), customPath);
+}
+//# sourceMappingURL=resolve-path.util.js.map

package/dist/utils/resolve-path.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path.util.js","sourceRoot":"","sources":["../../src/utils/resolve-path.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC1C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;IAED,oDAAoD;IACpD,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,kEAAkE;IAClE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC"}

package/dist/utils/validate-global-prefix.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validates that a global prefix is properly formatted
+ */
+export declare function validateGlobalPrefix(globalPrefix: string): boolean;
+//# sourceMappingURL=validate-global-prefix.util.d.ts.map

package/dist/utils/validate-global-prefix.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-global-prefix.util.d.ts","sourceRoot":"","sources":["../../src/utils/validate-global-prefix.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAKlE"}

package/dist/utils/validate-global-prefix.util.js

@@ -0,0 +1,10 @@
+/**
+ * Validates that a global prefix is properly formatted
+ */
+export function validateGlobalPrefix(globalPrefix) {
+    if (!globalPrefix) {
+        return false;
+    }
+    return globalPrefix.startsWith('/');
+}
+//# sourceMappingURL=validate-global-prefix.util.js.map

package/dist/utils/validate-global-prefix.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-global-prefix.util.js","sourceRoot":"","sources":["../../src/utils/validate-global-prefix.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/utils/validate-path.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validates and normalizes a path string
+ */
+export declare function validatePath(path: string): string;
+//# sourceMappingURL=validate-path.util.d.ts.map

package/dist/utils/validate-path.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-path.util.d.ts","sourceRoot":"","sources":["../../src/utils/validate-path.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBjD"}

package/dist/utils/validate-path.util.js

@@ -0,0 +1,18 @@
+/**
+ * Validates and normalizes a path string
+ */
+export function validatePath(path) {
+    if (typeof path !== 'string') {
+        throw new Error('Path must be a string');
+    }
+    // Ensure path starts with /
+    if (!path.startsWith('/')) {
+        path = `/${path}`;
+    }
+    // Remove trailing slash except for root
+    if (path.length > 1 && path.endsWith('/')) {
+        path = path.slice(0, -1);
+    }
+    return path;
+}
+//# sourceMappingURL=validate-path.util.js.map

package/dist/utils/validate-path.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-path.util.js","sourceRoot":"","sources":["../../src/utils/validate-path.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,wCAAwC;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@openapi-studio/nestjs",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b -v"
+  },
+  "dependencies": {
+    "@openapi-studio/core": "0.0.1",
+    "openapi-types": "^12.1.3"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.0",
+    "@nestjs/platform-fastify": "^11.0.0",
+    "@nestjs/swagger": "^11.2.3",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.3"
+  }
+}