@weconjs/core 1.2.13 → 1.2.14

package/dist/generators/PostmanGenerator.d.ts

@@ -0,0 +1,137 @@
+/**
+ * PostmanGenerator - Intelligent Postman Collection & Environment Generator
+ *
+ * This utility class generates:
+ * 1. Postman Collection v2.1.0 JSON files
+ * 2. Postman Environment JSON files with auto-extracted variables
+ *
+ * Features:
+ * - Automatic variable extraction from route paths (e.g., :userId -> {{userId}})
+ * - Collection of custom variables from PostmanRoute and PostmanGroup configs
+ * - Hierarchical folder structure matching Routes organization
+ * - Smart defaults for missing configurations
+ */
+import Routes from "../routing/Routes.js";
+import type { PostmanInfo, PostmanVariableList, PostmanAuth, PostmanEventList, PostmanProtocolProfileBehavior } from "../types/postman.types.js";
+import type { PostmanItem } from "../routing/PostmanRoute.js";
+import type { PostmanItemGroup } from "../routing/PostmanGroup.js";
+/**
+ * Configuration for PostmanGenerator
+ */
+export interface PostmanGeneratorConfig {
+    /** Name of the Postman collection */
+    name: string;
+    /** Description of the API */
+    description?: string;
+    /** Base URL for all requests (will be added as {{baseUrl}} variable) */
+    baseUrl?: string;
+    /** API version */
+    version?: string;
+    /** Output file paths */
+    output?: {
+        /** Path to save the collection JSON file */
+        collection?: string;
+        /** Path to save the environment JSON file */
+        environment?: string;
+    };
+}
+/**
+ * Postman Collection v2.1.0 structure
+ */
+interface PostmanCollection {
+    info: PostmanInfo;
+    item: (PostmanItemGroup | PostmanItem)[];
+    auth?: PostmanAuth | null;
+    event?: PostmanEventList;
+    variable?: PostmanVariableList;
+    protocolProfileBehavior?: PostmanProtocolProfileBehavior;
+}
+/**
+ * Postman Environment structure
+ */
+interface PostmanEnvironment {
+    id?: string;
+    name: string;
+    values: Array<{
+        key: string;
+        value: string;
+        type?: "default" | "secret";
+        enabled?: boolean;
+        description?: string;
+    }>;
+    _postman_variable_scope?: string;
+    _postman_exported_at?: string;
+    _postman_exported_using?: string;
+}
+/**
+ * PostmanGenerator class
+ */
+declare class PostmanGenerator {
+    private config;
+    private routes;
+    private collectedVariables;
+    private pathVariables;
+    constructor(config: PostmanGeneratorConfig, routes: Routes);
+    /**
+     * Generate both collection and environment files
+     */
+    generate(): Promise<{
+        collection: PostmanCollection;
+        environment: PostmanEnvironment;
+    }>;
+    /**
+     * Extract variables from all routes and their configurations
+     */
+    private extractVariables;
+    /**
+     * Recursively extract variables from Routes instances
+     */
+    private extractVariablesFromRoutes;
+    /**
+     * Recursively scan an object for string values containing {{variable}}
+     */
+    private recursivelyScanForVariables;
+    /**
+     * Extract path parameters from Express-style path
+     * Example: /users/:userId/posts/:postId -> ['userId', 'postId']
+     */
+    private extractPathParams;
+    /**
+     * Extract variable references from strings (e.g., {{authToken}})
+     */
+    private extractVariablesFromString;
+    /**
+     * Generate the Postman Collection
+     */
+    private generateCollection;
+    /**
+     * Convert Routes/Route instances to Postman items/folders
+     */
+    private convertRoutesToItems;
+    /**
+     * Convert a single Route to a PostmanItem
+     */
+    private convertRouteToItem;
+    /**
+     * Convert Express-style path to Postman-style path
+     * Example: /users/:userId -> /users/{{userId}}
+     */
+    private convertPathToPostman;
+    /**
+     * Generate the Postman Environment
+     */
+    private generateEnvironment;
+    /**
+     * Write JSON to file with pretty formatting
+     */
+    private writeJsonFile;
+    /**
+     * Static helper to generate from Wecon configuration
+     */
+    static generateFromWecon(config: PostmanGeneratorConfig, routes: Routes): Promise<{
+        collection: PostmanCollection;
+        environment: PostmanEnvironment;
+    }>;
+}
+export default PostmanGenerator;
+//# sourceMappingURL=PostmanGenerator.d.ts.map

package/dist/generators/PostmanGenerator.d.ts.map

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

package/dist/generators/PostmanGenerator.js

@@ -0,0 +1,318 @@
+/**
+ * PostmanGenerator - Intelligent Postman Collection & Environment Generator
+ *
+ * This utility class generates:
+ * 1. Postman Collection v2.1.0 JSON files
+ * 2. Postman Environment JSON files with auto-extracted variables
+ *
+ * Features:
+ * - Automatic variable extraction from route paths (e.g., :userId -> {{userId}})
+ * - Collection of custom variables from PostmanRoute and PostmanGroup configs
+ * - Hierarchical folder structure matching Routes organization
+ * - Smart defaults for missing configurations
+ */
+import { writeFileSync } from "fs";
+import { dirname } from "path";
+import { mkdirSync } from "fs";
+import Route from "../routing/Route.js";
+import Routes from "../routing/Routes.js";
+// so we can easily change schema version in the future
+const SCHEMA_URL = "https://schema.getpostman.com/json/collection/v2.1.0/collection.json";
+/**
+ * PostmanGenerator class
+ */
+class PostmanGenerator {
+    config;
+    routes;
+    collectedVariables = new Map();
+    pathVariables = new Set();
+    constructor(config, routes) {
+        this.config = config;
+        this.routes = routes;
+    }
+    /**
+     * Generate both collection and environment files
+     */
+    async generate() {
+        // Extract all variables from routes
+        this.extractVariables();
+        // Generate collection
+        const collection = this.generateCollection();
+        // Generate environment
+        const environment = this.generateEnvironment();
+        // Write files if output paths specified
+        if (this.config.output?.collection) {
+            this.writeJsonFile(this.config.output.collection, collection);
+        }
+        if (this.config.output?.environment) {
+            this.writeJsonFile(this.config.output.environment, environment);
+        }
+        return { collection, environment };
+    }
+    /**
+     * Extract variables from all routes and their configurations
+     */
+    extractVariables() {
+        // Add baseUrl as a variable
+        if (this.config.baseUrl) {
+            this.collectedVariables.set("baseUrl", {
+                key: "baseUrl",
+                value: this.config.baseUrl,
+                type: "string",
+                description: "Base URL for all API requests",
+            });
+        }
+        // Recursively extract variables from routes
+        this.extractVariablesFromRoutes(this.routes);
+    }
+    /**
+     * Recursively extract variables from Routes instances
+     */
+    extractVariablesFromRoutes(routes, parentPath = "") {
+        if (routes instanceof Route) {
+            // Extract path parameters (e.g., :userId)
+            const pathParams = this.extractPathParams(routes.path);
+            pathParams.forEach((param) => this.pathVariables.add(param));
+            // Extract variables from PostmanRoute config
+            if (routes.postman) {
+                // Deep scan the entire PostmanRoute configuration object
+                this.recursivelyScanForVariables(routes.postman);
+            }
+        }
+        else if (routes instanceof Routes) {
+            const currentPath = parentPath + routes.prefix;
+            // Extract variables from PostmanGroup config
+            if (routes.postman) {
+                // Deep scan the entire PostmanGroup configuration object
+                this.recursivelyScanForVariables(routes.postman);
+            }
+            // Recursively process child routes
+            routes.routes.forEach((childRoute) => {
+                this.extractVariablesFromRoutes(childRoute, currentPath);
+            });
+        }
+    }
+    /**
+     * Recursively scan an object for string values containing {{variable}}
+     */
+    recursivelyScanForVariables(obj) {
+        if (!obj)
+            return;
+        if (typeof obj === "string") {
+            const variables = this.extractVariablesFromString(obj);
+            variables.forEach((varName) => {
+                if (!this.collectedVariables.has(varName)) {
+                    this.collectedVariables.set(varName, {
+                        key: varName,
+                        value: "",
+                        type: "string",
+                        description: "Extracted from configuration",
+                    });
+                }
+            });
+            return;
+        }
+        if (Array.isArray(obj)) {
+            obj.forEach((item) => this.recursivelyScanForVariables(item));
+            return;
+        }
+        if (typeof obj === "object") {
+            // Special handling for PostmanVariable objects to preserve their metadata
+            // Check if it looks like a PostmanVariable (has key/id and value)
+            const potentialVar = obj;
+            if ((potentialVar.key || potentialVar.id) &&
+                potentialVar.value !== undefined) {
+                const key = potentialVar.key || potentialVar.id;
+                if (key && !this.collectedVariables.has(key)) {
+                    this.collectedVariables.set(key, potentialVar);
+                }
+                // Continue scanning value just in case it has nested vars (unlikely but possible)
+                this.recursivelyScanForVariables(potentialVar.value);
+                return;
+            }
+            // Standard object traversal
+            Object.values(obj).forEach((value) => this.recursivelyScanForVariables(value));
+        }
+    }
+    /**
+     * Extract path parameters from Express-style path
+     * Example: /users/:userId/posts/:postId -> ['userId', 'postId']
+     */
+    extractPathParams(path) {
+        const matches = path.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
+        if (!matches)
+            return [];
+        return matches.map((match) => match.slice(1)); // Remove the ':' prefix
+    }
+    /**
+     * Extract variable references from strings (e.g., {{authToken}})
+     */
+    extractVariablesFromString(str) {
+        const matches = str.match(/\{\{([a-zA-Z_][a-zA-Z0-9_]*)\}\}/g);
+        if (!matches)
+            return [];
+        return matches.map((match) => match.slice(2, -2)); // Remove {{ and }}
+    }
+    /**
+     * Generate the Postman Collection
+     */
+    generateCollection() {
+        const collection = {
+            info: {
+                name: this.config.name,
+                description: this.config.description || "",
+                version: this.config.version || "1.0.0",
+                schema: SCHEMA_URL,
+            },
+            item: [],
+        };
+        // Convert Routes to Postman items
+        collection.item = this.convertRoutesToItems(this.routes);
+        // Add collection-level variables
+        const collectionVars = Array.from(this.collectedVariables.values());
+        if (collectionVars.length > 0) {
+            collection.variable = collectionVars;
+        }
+        return collection;
+    }
+    /**
+     * Convert Routes/Route instances to Postman items/folders
+     */
+    convertRoutesToItems(routes, parentPrefix = "") {
+        const items = [];
+        if (routes instanceof Route) {
+            routes.path = `${parentPrefix}${routes.path}`;
+            // Convert single Route to PostmanItem
+            const item = this.convertRouteToItem(routes);
+            items.push(item);
+        }
+        else if (routes instanceof Routes) {
+            // Check if this Routes instance should be a folder
+            const shouldBeFolder = routes.postman?.folderName || routes.prefix;
+            // Process child routes first
+            const childItems = [];
+            routes.routes.forEach((childRoute) => {
+                const children = this.convertRoutesToItems(childRoute, parentPrefix + routes.prefix);
+                childItems.push(...children);
+            });
+            if (shouldBeFolder) {
+                // Use PostmanGroup to generate the folder
+                if (routes.postman) {
+                    const folder = routes.postman.toPostmanItemGroup(childItems);
+                    items.push(folder);
+                }
+                else {
+                    // Fallback if no PostmanGroup config but has prefix (shouldn't happen with default init)
+                    items.push({
+                        name: routes.prefix || "Routes",
+                        item: childItems,
+                    });
+                }
+            }
+            else {
+                // No folder, just flatten the children
+                items.push(...childItems);
+            }
+        }
+        return items;
+    }
+    /**
+     * Convert a single Route to a PostmanItem
+     */
+    convertRouteToItem(route) {
+        const baseUrl = this.config.baseUrl || "{{baseUrl}}";
+        // Use PostmanRoute's toPostmanItem if configured
+        if (route.postman) {
+            return route.postman.toPostmanItem(route, baseUrl);
+        }
+        // Otherwise, generate a basic item (Fallback)
+        const postmanPath = this.convertPathToPostman(route.path);
+        const item = {
+            name: route.name || `[${route.method}] ${route.path}`,
+            request: {
+                method: route.method.toUpperCase(),
+                header: [],
+                url: {
+                    raw: `${baseUrl}${postmanPath}`,
+                    host: baseUrl.includes("://") ? [baseUrl] : [baseUrl],
+                    path: postmanPath.split("/").filter((segment) => segment !== ""),
+                },
+            },
+        };
+        // Add description if available
+        if (route.description) {
+            item.description = route.description;
+        }
+        return item;
+    }
+    /**
+     * Convert Express-style path to Postman-style path
+     * Example: /users/:userId -> /users/{{userId}}
+     */
+    convertPathToPostman(path) {
+        return path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, "{{$1}}");
+    }
+    /**
+     * Generate the Postman Environment
+     */
+    generateEnvironment() {
+        const environment = {
+            name: `${this.config.name} - Environment`,
+            values: [],
+            _postman_variable_scope: "environment",
+            _postman_exported_at: new Date().toISOString(),
+            _postman_exported_using: "Wecon PostmanGenerator",
+        };
+        // Add collected variables
+        this.collectedVariables.forEach((variable) => {
+            environment.values.push({
+                key: variable.key || variable.id || "",
+                value: String(variable.value || ""),
+                type: "default",
+                enabled: !variable.disabled,
+                description: typeof variable.description === "string"
+                    ? variable.description
+                    : variable.description?.content,
+            });
+        });
+        // Add path variables (from :param) with empty values
+        this.pathVariables.forEach((paramName) => {
+            if (!this.collectedVariables.has(paramName)) {
+                environment.values.push({
+                    key: paramName,
+                    value: "",
+                    type: "default",
+                    enabled: true,
+                    description: `Path parameter extracted from route`,
+                });
+            }
+        });
+        return environment;
+    }
+    /**
+     * Write JSON to file with pretty formatting
+     */
+    writeJsonFile(filePath, data) {
+        try {
+            // Ensure directory exists
+            const dir = dirname(filePath);
+            mkdirSync(dir, { recursive: true });
+            // Write file
+            writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+            console.log(`✓ Generated Postman file: ${filePath}`);
+        }
+        catch (error) {
+            console.error(`✗ Failed to write Postman file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Static helper to generate from Wecon configuration
+     */
+    static async generateFromWecon(config, routes) {
+        const generator = new PostmanGenerator(config, routes);
+        return generator.generate();
+    }
+}
+export default PostmanGenerator;
+//# sourceMappingURL=PostmanGenerator.js.map

package/dist/generators/PostmanGenerator.js.map

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

package/dist/index.d.ts

@@ -13,8 +13,11 @@ export { createWinstonLogger, createConsoleLogger, } from "./logger/index.js";
 export type { LoggerOptions, WinstonBasedLogger } from "./logger/index.js";
 export { createWecon } from "./server/index.js";
 export type { CreateWeconOptions, WeconApp, ApiError, ApiResponse, RespondOptions, } from "./server/index.js";
-export { Wecon, Route, Routes, RoutesParam, RaiMatcher, ErrorCatcher, } from "./routing/index.js";
-export type { WeconDevConfig, RaiRoutesList } from "./routing/index.js";
+export { Wecon, Route, Routes, RoutesParam, PostmanRoute, PostmanGroup, RaiMatcher, ErrorCatcher, } from "./routing/index.js";
+export type { WeconDevConfig, WeconPostmanConfig, PostmanItem, PostmanItemGroup, RaiRoutesList, } from "./routing/index.js";
+export { default as PostmanGenerator } from "./generators/PostmanGenerator.js";
+export type { PostmanGeneratorConfig } from "./generators/PostmanGenerator.js";
+export type { PostmanDescription, PostmanVersion, PostmanInfo, PostmanAuthAttribute, PostmanAuthType, PostmanAuth, PostmanVariableType, PostmanVariable, PostmanVariableList, PostmanScript, PostmanEvent, PostmanEventList, PostmanProtocolProfileBehavior, PostmanGroupConfig, PostmanRouteConfig, PostmanCollectionConfig, } from "./types/postman.types.js";
 export { ConfigError, RequestError } from "./errors/index.js";
 export { initializeI18n, initI18n, i18nNamespaceMiddleware, getI18n, i18next, I18nLoader, translate, getCurrentLanguage, changeLanguage, } from "./i18n/index.js";
 export type { I18nResources } from "./i18n/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,KAAK,EACL,KAAK,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EACL,cAAc,EACd,QAAQ,EACR,uBAAuB,EACvB,OAAO,EACP,OAAO,EACP,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,IAAI,iCAAiC,EAC3D,wBAAwB,IAAI,mCAAmC,EAC/D,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,IAAI,eAAe,EAChC,gBAAgB,IAAI,kBAAkB,EACtC,uBAAuB,EACvB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAG5B,YAAY,EAEV,WAAW,EACX,YAAY,EACZ,GAAG,EACH,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EAGjB,WAAW,EACX,cAAc,EACd,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,EAGV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EAGX,aAAa,EACb,gBAAgB,EAGhB,YAAY,EACZ,WAAW,EACX,aAAa,EAGb,aAAa,EACb,UAAU,EAGV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -17,7 +17,9 @@ export { createWinstonLogger, createConsoleLogger, } from "./logger/index.js";
 // Server
 export { createWecon } from "./server/index.js";
 // Routing
-export { Wecon, Route, Routes, RoutesParam, RaiMatcher, ErrorCatcher, } from "./routing/index.js";
+export { Wecon, Route, Routes, RoutesParam, PostmanRoute, PostmanGroup, RaiMatcher, ErrorCatcher, } from "./routing/index.js";
+// Postman Generator
+export { default as PostmanGenerator } from "./generators/PostmanGenerator.js";
 // Errors
 export { ConfigError, RequestError } from "./errors/index.js";
 // i18n

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtE,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,kDAAkD;AAClD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,UAAU;AACV,OAAO,EACL,KAAK,EACL,KAAK,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO;AACP,OAAO,EACL,cAAc,EACd,QAAQ,EACR,uBAAuB,EACvB,OAAO,EACP,OAAO,EACP,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,WAAW;AACX,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAQ7B,YAAY;AACZ,OAAO,EACL,kBAAkB,EAClB,sBAAsB,IAAI,iCAAiC,EAC3D,wBAAwB,IAAI,mCAAmC,EAC/D,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAU3B,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,yDAAyD;AACzD,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtE,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,kDAAkD;AAClD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,UAAU;AACV,OAAO,EACL,KAAK,EACL,KAAK,EACL,MAAM,EACN,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAS5B,oBAAoB;AACpB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAuB/E,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO;AACP,OAAO,EACL,cAAc,EACd,QAAQ,EACR,uBAAuB,EACvB,OAAO,EACP,OAAO,EACP,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,WAAW;AACX,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAQ7B,YAAY;AACZ,OAAO,EACL,kBAAkB,EAClB,sBAAsB,IAAI,iCAAiC,EAC3D,wBAAwB,IAAI,mCAAmC,EAC/D,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAU3B,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,yDAAyD;AACzD,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC"}

package/dist/routing/PostmanGroup.d.ts

@@ -0,0 +1,56 @@
+import type { PostmanDescription, PostmanAuth, PostmanVariableList, PostmanEventList, PostmanProtocolProfileBehavior, PostmanGroupConfig } from "../types/postman.types.js";
+import type { PostmanItem } from "./PostmanRoute.js";
+/**
+ * Postman Item Group (Folder) structure
+ */
+export interface PostmanItemGroup {
+    name: string;
+    description?: PostmanDescription;
+    item: (PostmanItem | PostmanItemGroup)[];
+    auth?: PostmanAuth | null;
+    event?: PostmanEventList;
+    variable?: PostmanVariableList;
+    protocolProfileBehavior?: PostmanProtocolProfileBehavior;
+}
+/**
+ * PostmanGroup
+ *
+ * Configures how a group of Routes (a folder) is represented in the generated Postman collection.
+ * This class handles the creation of Postman Folders (Item Groups).
+ *
+ * @example
+ * ```typescript
+ * new Routes({
+ *   prefix: '/users',
+ *   postman: new PostmanGroup({
+ *     folderName: 'User Management',
+ *     description: 'Endpoints for managing users',
+ *     auth: { type: 'bearer', ... }
+ *   })
+ * })
+ * ```
+ */
+declare class PostmanGroup {
+    /** Folder name - the display name for this folder in Postman */
+    folderName: string;
+    /** Description of the folder/route group */
+    description?: PostmanDescription;
+    /** Authentication configuration (inherited by child items unless overridden) */
+    auth?: PostmanAuth | null;
+    /** Variables scoped to this folder */
+    variable?: PostmanVariableList;
+    /** Pre-request and test scripts for this folder */
+    event?: PostmanEventList;
+    /** Protocol profile behavior configuration */
+    protocolProfileBehavior?: PostmanProtocolProfileBehavior;
+    constructor(config: PostmanGroupConfig);
+    /**
+     * Converts this configuration and a list of child items into a Postman Folder.
+     *
+     * @param items - The list of child requests (Items) or sub-folders (ItemGroups)
+     * @returns A formatted Postman ItemGroup object
+     */
+    toPostmanItemGroup(items: (PostmanItem | PostmanItemGroup)[]): PostmanItemGroup;
+}
+export default PostmanGroup;
+//# sourceMappingURL=PostmanGroup.d.ts.map

package/dist/routing/PostmanGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostmanGroup.d.ts","sourceRoot":"","sources":["../../src/routing/PostmanGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,8BAA8B,EAC9B,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,IAAI,EAAE,CAAC,WAAW,GAAG,gBAAgB,CAAC,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,8BAA8B,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAM,YAAY;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAEjC,gFAAgF;IAChF,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE1B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,mDAAmD;IACnD,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB,8CAA8C;IAC9C,uBAAuB,CAAC,EAAE,8BAA8B,CAAC;gBAE7C,MAAM,EAAE,kBAAkB;IAStC;;;;;OAKG;IACI,kBAAkB,CACvB,KAAK,EAAE,CAAC,WAAW,GAAG,gBAAgB,CAAC,EAAE,GACxC,gBAAgB;CAgBpB;AAED,eAAe,YAAY,CAAC"}

package/dist/routing/PostmanGroup.js

@@ -0,0 +1,66 @@
+/**
+ * PostmanGroup
+ *
+ * Configures how a group of Routes (a folder) is represented in the generated Postman collection.
+ * This class handles the creation of Postman Folders (Item Groups).
+ *
+ * @example
+ * ```typescript
+ * new Routes({
+ *   prefix: '/users',
+ *   postman: new PostmanGroup({
+ *     folderName: 'User Management',
+ *     description: 'Endpoints for managing users',
+ *     auth: { type: 'bearer', ... }
+ *   })
+ * })
+ * ```
+ */
+class PostmanGroup {
+    /** Folder name - the display name for this folder in Postman */
+    folderName;
+    /** Description of the folder/route group */
+    description;
+    /** Authentication configuration (inherited by child items unless overridden) */
+    auth;
+    /** Variables scoped to this folder */
+    variable;
+    /** Pre-request and test scripts for this folder */
+    event;
+    /** Protocol profile behavior configuration */
+    protocolProfileBehavior;
+    constructor(config) {
+        this.folderName = config.folderName;
+        this.description = config.description;
+        this.auth = config.auth;
+        this.variable = config.variable;
+        this.event = config.event;
+        this.protocolProfileBehavior = config.protocolProfileBehavior;
+    }
+    /**
+     * Converts this configuration and a list of child items into a Postman Folder.
+     *
+     * @param items - The list of child requests (Items) or sub-folders (ItemGroups)
+     * @returns A formatted Postman ItemGroup object
+     */
+    toPostmanItemGroup(items) {
+        const folder = {
+            name: this.folderName,
+            item: items,
+        };
+        if (this.description)
+            folder.description = this.description;
+        if (this.auth !== undefined)
+            folder.auth = this.auth;
+        if (this.variable)
+            folder.variable = this.variable;
+        if (this.event)
+            folder.event = this.event;
+        if (this.protocolProfileBehavior) {
+            folder.protocolProfileBehavior = this.protocolProfileBehavior;
+        }
+        return folder;
+    }
+}
+export default PostmanGroup;
+//# sourceMappingURL=PostmanGroup.js.map

package/dist/routing/PostmanGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostmanGroup.js","sourceRoot":"","sources":["../../src/routing/PostmanGroup.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,YAAY;IAChB,gEAAgE;IAChE,UAAU,CAAS;IAEnB,4CAA4C;IAC5C,WAAW,CAAsB;IAEjC,gFAAgF;IAChF,IAAI,CAAsB;IAE1B,sCAAsC;IACtC,QAAQ,CAAuB;IAE/B,mDAAmD;IACnD,KAAK,CAAoB;IAEzB,8CAA8C;IAC9C,uBAAuB,CAAkC;IAEzD,YAAY,MAA0B;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,uBAAuB,GAAG,MAAM,CAAC,uBAAuB,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CACvB,KAAyC;QAEzC,MAAM,MAAM,GAAqB;YAC/B,IAAI,EAAE,IAAI,CAAC,UAAU;YACrB,IAAI,EAAE,KAAK;SACZ,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrD,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnD,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1C,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACjC,MAAM,CAAC,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,CAAC;QAChE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}