transit-kit 0.5.0 → 0.6.1

package/dist/{cli → generator}/generateOpenApi.d.ts

@@ -3,8 +3,13 @@ import { ApiEndpointDefinition } from "../server/handlers/api/EndpointDefinition
 import { GenericResponseSchemaMap } from "../server/handlers/api/responses";
 import { ZodType } from "zod";
 import { OpenAPIV3 } from "openapi-types";
+import { Server } from "../server";
 declare function translateToOpenAPIPathItem(definition: ApiEndpointDefinition<string, HttpMethod, ZodType | undefined, ZodType | undefined, GenericResponseSchemaMap>): [string, OpenAPIV3.PathItemObject];
-export declare function generateOpenApiDoc(targetPath: string): Promise<OpenAPIV3.Document<{}>>;
+interface GeneratorOptions {
+    title: string;
+    version: string;
+}
+export declare function generateOpenApiDoc(server: Server, options: GeneratorOptions): Promise<OpenAPIV3.Document>;
 export declare const __TEST_EXPORTS: {
     translateToOpenAPIPathItem: typeof translateToOpenAPIPathItem;
 };

package/dist/{cli → generator}/generateOpenApi.js

@@ -1,6 +1,5 @@
 import z from "zod";
 import { hasValue } from "../server/utils/typeGuards";
-import path from "path";
 import { isJsonResponseSchema } from "../server/handlers/api/responses/jsonResponse";
 function extractPathAndParameters(path) {
     const parameters = path.match(/:([a-zA-Z0-9_]+)/g)?.map((param) => {
@@ -137,43 +136,34 @@ function extractSecuritySchemes(endpointDefinitions) {
         return { ...acc, ...scheme };
     }, {});
 }
-export async function generateOpenApiDoc(targetPath) {
-    const serverModule = await import(path.resolve(process.cwd(), targetPath));
-    const server = serverModule.default;
-    if (hasValue(server) &&
-        hasValue(server.endpointDefinitions) &&
-        Array.isArray(server.endpointDefinitions)) {
-        const endpointDefinitions = server.endpointDefinitions;
-        const paths = endpointDefinitions.reduce((acc, def) => {
-            const [openApiPath, pathItem] = translateToOpenAPIPathItem(def);
-            if (acc[openApiPath]) {
-                acc[openApiPath] = {
-                    ...acc[openApiPath],
-                    ...pathItem,
-                };
-            }
-            else {
-                acc[openApiPath] = pathItem;
-            }
-            return acc;
-        }, {});
-        const securitySchemes = extractSecuritySchemes(endpointDefinitions);
-        const openApiDocument = {
-            openapi: "3.0.0",
-            info: {
-                title: "Generated API",
-                version: "1.0.0",
-            },
-            paths: paths,
-            components: {
-                securitySchemes,
-            },
-        };
-        return openApiDocument;
-    }
-    else {
-        throw new Error("The specified module does not export a valid server instance.");
-    }
+export async function generateOpenApiDoc(server, options) {
+    const endpointDefinitions = server.endpointDefinitions;
+    const paths = endpointDefinitions.reduce((acc, def) => {
+        const [openApiPath, pathItem] = translateToOpenAPIPathItem(def);
+        if (acc[openApiPath]) {
+            acc[openApiPath] = {
+                ...acc[openApiPath],
+                ...pathItem,
+            };
+        }
+        else {
+            acc[openApiPath] = pathItem;
+        }
+        return acc;
+    }, {});
+    const securitySchemes = extractSecuritySchemes(endpointDefinitions);
+    const openApiDocument = {
+        openapi: "3.0.0",
+        info: {
+            title: options.title,
+            version: options.version,
+        },
+        paths: paths,
+        components: {
+            securitySchemes,
+        },
+    };
+    return openApiDocument;
 }
 export const __TEST_EXPORTS = {
     translateToOpenAPIPathItem,

package/dist/generator/index.d.ts

@@ -0,0 +1 @@
+export { generateOpenApiDoc } from "./generateOpenApi";

package/dist/generator/index.js

@@ -0,0 +1 @@
+export { generateOpenApiDoc } from "./generateOpenApi";

package/dist/server/server.js

@@ -42,6 +42,7 @@ export function createServer(config) {
         endpointDefinitions: [],
         registerApiEndpoint(endpoint) {
             registerApiEndpoint(app, endpoint);
+            this.endpointDefinitions.push(endpoint.definition);
         },
         start() {
             app.listen(port);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transit-kit",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "A declarative TypeScript framework for building type-safe Express.js APIs with automatic OpenAPI generation",
   "keywords": [
     "express",
@@ -31,9 +31,13 @@
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.js",
       "require": "./dist/server/index.js"
+    },
+    "./generator": {
+      "types": "./dist/generator/index.d.ts",
+      "import": "./dist/generator/index.js",
+      "require": "./dist/generator/index.js"
     }
   },
-  "bin": "./dist/cli/cli.js",
   "scripts": {
     "lint": "eslint",
     "test": "vitest",
@@ -59,7 +63,6 @@
   },
   "dependencies": {
     "colors": "^1.4.0",
-    "commander": "^14.0.2",
     "cookie-parser": "^1.4.7",
     "express": "^4.21.1",
     "express-async-handler": "^1.2.0",

package/dist/cli/cli.d.ts

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

package/dist/cli/cli.js

@@ -1,21 +0,0 @@
-import { Command } from "commander";
-import fs from "fs";
-import { generateOpenApiDoc } from "./generateOpenApi";
-const program = new Command();
-program
-    .name("transit-kit")
-    .description("CLI of the transitKit backend framework")
-    .version("1.0.0");
-program
-    .command("generate-openapi")
-    .option("-o, --output <path>", "Output path for the generated OpenAPI document", "openapi.json")
-    .option("-t, --target <path>", "Target path to search for endpoint definitions", ".")
-    .action(async (options) => {
-    const { output, target } = options;
-    const generatedDoc = await generateOpenApiDoc(target);
-    fs.writeFileSync(output, JSON.stringify(generatedDoc, null, 2), {
-        encoding: "utf-8",
-    });
-    console.log(`OpenAPI document generated at: ${output}`);
-});
-program.parse();