standard-api-core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Standard API Core
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,522 @@
+# @standard-api/core
+
+A production-ready NPM package that standardizes API responses and automatically generates best-practice Swagger (OpenAPI) documentation for Express.js applications.
+
+## Features
+
+- **Standardized Response Format** - Consistent success/error responses across your entire API
+- **Auto-Generated Swagger UI** - Beautiful, interactive API documentation
+- **Configuration-Based** - Flexible configuration file support
+- **Downloadable Specs** - Download full or per-endpoint OpenAPI specs in JSON/YAML
+- **Headers & Security** - Built-in support for authentication headers
+- **Type-Safe** - Full TypeScript support with Zod schemas
+- **Zero Boilerplate** - Minimal setup, maximum productivity
+
+## Installation
+
+```bash
+npm install @standard-api/core express zod
+```
+
+## Quick Start
+
+### 1. Create Configuration File
+
+Create `standard-api.config.ts` in your project root:
+
+```typescript
+import { StandardApiConfig } from "@standard-api/core";
+
+const config: StandardApiConfig = {
+  api: {
+    title: "User Service API",
+    description: "API documentation for User Service",
+    version: "1.0.0",
+    baseUrl: "/api/v1",
+  },
+  headers: {
+    Authorization: {
+      description: "JWT Bearer token",
+      required: true,
+    },
+  },
+  swagger: {
+    path: "/docs",
+    enableDownload: true,
+  },
+};
+
+export default config;
+```
+
+### 2. Setup Express App
+
+```typescript
+import express from "express";
+import {
+  setupSwagger,
+  responseMiddleware,
+  apiDoc,
+  loadConfig,
+} from "@standard-api/core";
+import { z } from "zod";
+
+const app = express();
+app.use(express.json());
+
+// Load configuration
+const config = loadConfig("./standard-api.config.ts");
+
+// Setup response handlers (adds sendSuccess/sendError methods)
+app.use(responseMiddleware);
+
+// Setup Swagger documentation
+setupSwagger(app, config);
+
+// Define schemas
+const UserSchema = z.object({
+  success: z.literal(true),
+  message: z.string(),
+  data: z.object({
+    id: z.string(),
+    name: z.string(),
+    email: z.string().email(),
+    role: z.enum(["ADMIN", "USER"]),
+  }),
+  meta: z.object({
+    timestamp: z.string(),
+    requestId: z.string(),
+  }),
+});
+
+// Create documented endpoints
+app.get(
+  "/api/v1/users/:id",
+  apiDoc({
+    method: "get",
+    path: "/api/v1/users/{id}",
+    summary: "Get user by ID",
+    description: "Returns a single user",
+    tags: ["Users"],
+    request: {
+      params: z.object({
+        id: z.string().describe("User ID"),
+      }),
+    },
+    response: UserSchema,
+  }),
+  (req, res) => {
+    const user = {
+      id: req.params.id,
+      name: "John Doe",
+      email: "john@example.com",
+      role: "USER",
+    };
+
+    res.sendSuccess({
+      message: "User fetched successfully",
+      data: user,
+    });
+  }
+);
+
+app.listen(3000, () => {
+  console.log("Server running on http://localhost:3000");
+  console.log("Swagger docs available at http://localhost:3000/docs");
+});
+```
+
+## API Reference
+
+### Response Handlers
+
+#### `res.sendSuccess(options)`
+
+Send a standardized success response.
+
+```typescript
+res.sendSuccess({
+  message: "Operation successful",
+  data: { id: 1, name: "John" },
+  meta: { customField: "value" }, // optional
+});
+```
+
+**Response Format:**
+
+```json
+{
+  "success": true,
+  "message": "Operation successful",
+  "data": { "id": 1, "name": "John" },
+  "meta": {
+    "timestamp": "2026-01-01T00:00:00.000Z",
+    "requestId": "uuid-here",
+    "customField": "value"
+  }
+}
+```
+
+#### `res.sendError(options)`
+
+Send a standardized error response.
+
+```typescript
+res.sendError({
+  message: "Validation failed",
+  code: "VALIDATION_ERROR",
+  error: { field: "email", issue: "invalid format" },
+  status: 400,
+});
+```
+
+**Response Format:**
+
+```json
+{
+  "success": false,
+  "message": "Validation failed",
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "details": { "field": "email", "issue": "invalid format" }
+  },
+  "meta": {
+    "timestamp": "2026-01-01T00:00:00.000Z",
+    "requestId": "uuid-here"
+  }
+}
+```
+
+### Middleware
+
+#### `responseMiddleware`
+
+Middleware that adds `sendSuccess` and `sendError` methods to Express response object.
+
+```typescript
+app.use(responseMiddleware);
+```
+
+#### `apiDoc(config)`
+
+Middleware that registers route documentation with Swagger.
+
+```typescript
+app.get(
+  "/users",
+  apiDoc({
+    method: "get",
+    path: "/users",
+    summary: "Get all users",
+    description: "Returns a list of users",
+    tags: ["Users"],
+    request: {
+      query: z.object({
+        page: z.string().optional(),
+        limit: z.string().optional(),
+      }),
+    },
+    response: UserListSchema,
+  }),
+  handler
+);
+```
+
+**Configuration Parameters:**
+
+- `method` - HTTP method (get, post, put, delete, patch)
+- `path` - Route path matching Express route
+- `summary` - Short description of the endpoint
+- `description` - Detailed description (optional)
+- `tags` - Array of tags for grouping endpoints
+- `request` - Request schema (query, params, body)
+- `response` - Response schema (Zod schema)
+
+### Setup Functions
+
+#### `setupSwagger(app, config)`
+
+Initializes Swagger UI and documentation endpoints.
+
+```typescript
+setupSwagger(app, config);
+**Auto-discovery:** If no path is provided, the loader searches in the following order:
+1. `standard-api.config.ts` (root)
+2. `standard-api.config.js` (root)
+3. `config/standard-api.config.ts`
+4. `config/standard-api.config.js`
+
+##
+
+#### `loadConfig(path?)`
+
+Loads configuration from file. Auto-discovers if path not provided.
+
+```typescript
+const config = loadConfig("./standard-api.config.ts");
+```
+
+## 🔧 Configuration Options
+
+```typescript
+interface StandardApiConfig {
+  api: {
+    title: string; // API title
+    description: string; // API description
+    version: string; // API version
+   seUrl: string; // Base URL for all endpoints
+  };
+  headers?: {
+    [headerName: string]: {
+      description: string;
+      required: boolean;
+      example?: string;
+    };
+  };
+  swagger: {
+    path: string; // Swagger UI path (e.g., '/docs')
+    enableDownload: boolean; // Enable spec downloads
+  };
+}
+```
+
+## 📥 Download Endpoints
+
+WheenableDownload: true`, the following endpoints are available:
+
+- `GET /docs/openapi.json` - Download full OpenAPI spec (JSON)
+- `GET /docs/openapi.yaml` - Download full OpenAPI spec (YAML)
+- `GET /docs/endpoint/:method/:path?format=json` - Download single endpoint spec
+
+Example:
+
+```bash
+# Download full spec
+curl http://localhost:3000/docs/openapi.json > openapi.json
+
+# Download single endpoint
+curl http://localhost:3000/docs/endpoint/get/users?format=yaml
+```
+
+## 🎨 Schema Definition
+
+Use Zod for type-safe schema definitions:
+
+```typescript
+const CreateUserSchema = z.object({
+  success: z.literal(true),
+  message: z.string(),
+  data: z.object({
+    name: z.string().min(3),
+    email: z.string().email(),
+    role: z.enum(["ADMIN", "USER", "MODERATOR"]),
+    age: z.number().min(18).optional(),
+  }),
+  meta: z.object({
+   mestamp: z.string(),
+    requestId: z.string(),
+  }),
+});
+```
+
+## 🔐 Authentication Headers
+
+Configure global authentication headers:
+
+```typescript
+{
+  headers: {
+    Authorization: {
+      description: "Bearer JWT token",
+      required: true
+    },
+    "X-API-Key": {
+      description: "API Key for service authentication",
+      required: false,
+   example: "your-api-key-here"
+    }
+  }
+}
+```
+
+## 📝 Advanced Example
+
+```typescript
+import express from "express";
+import { z } from "zod";
+import {
+  setupSwagger,
+  responseMiddleware,
+  apiDoc,
+  loadConfig,
+} from "@standard-api/core";
+
+const app = express();
+app.use(express.json());
+
+const config = loadConfig();
+app.use(responseMiddleware);
+setupSwagger(app, config);
+
+// Response schema
+const UserListSchema = z.object({
+  success: z.literal(true),
+  message: z.string(),
+  data: z.array(
+    z.object({
+      id: z.string(),
+      name: z.string(),
+      email: z.string().email(),
+      role: z.enum(["ADMIN", "USER"]),
+    })
+  ),
+  meta: z.object({
+    timestamp: z.string(),
+    requestId: z.string(),
+    pagination: z.object({
+      page: z.number(),
+      limit: z.number(),
+      total: z.number(),
+    }),
+  }),
+});
+
+// GET endpoint with query params
+app.get(
+  "/api/v1/users",
+  apiDoc({
+    method: "get",
+    path: "/api/v1/users",
+    summary: "List all users",
+    description: "Get paginated list of users",
+    tags: ["Users"],
+    request: {
+      query: z.object({
+        page: z.string().optional().describe("Page number"),
+        limit: z.string().optional().describe("Items per page"),
+      }),
+    },
+    response: UserListSchema,
+  }),
+  (req, res) => {
+    const page = parseInt(req.query.page as string) || 1;
+    const limit = parseInt(req.query.limit as string) || 10;
+
+    res.sendSuccess({
+      message: "Users fetched successfully",
+      data: users,
+      meta: {
+        pagination: { page, limit, total: 100 },
+      },
+    });
+  }
+);
+
+// POST endpoint with body
+const CreateUserRequestSchema = z.object({
+  name: z.string().min(3),
+  email: z.string().email(),
+  role: z.enum(["ADMIN", "USER"]),
+});
+
+app.post(
+  "/api/v1/users",
+  apiDoc({
+    method: "post",
+    path: "/api/v1/users",
+    summary: "Create new user",
+    tags: ["Users"],
+    request: {
+      body: CreateUserRequestSchema,
+    },
+    response: UserSchema,
+  }),
+  (req, res) => {
+    // Validation happens automatically via Zod
+    const newUser = {
+      id: "123",
+      ...req.body,
+    };
+
+    res.sendSuccess({
+      message: "User created successfully",
+      data: newUser,
+    });
+  }
+);
+
+// Error handling
+app.use((err, req, res, next) => {
+  res.sendError({
+    message: err.message || "Internal server error",
+    code: err.code || "INTERNAL_ERROR",
+    error: process.env.NODE_ENV === "development" ? err.stack : {},
+    status: err.status || 500,
+  });
+});
+
+app.listen(3000);
+```
+
+## TypeScript Configuration
+
+Ensure your `tsconfig.json` includes:
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "strict": true,
+   Error Handling
+
+The package provides standardized error responses. Implement a global error handler:
+
+```typescript
+app.use((err: any, req: express.Request, res: express.Response, next: express.NextFunction) => {
+  res.sendError({
+    message: err.message || "Internal server error",
+    code: err.code || "INTERNAL_ERROR",
+    error: process.env.NODE_ENV === "development" ? err.stack : undefined,
+    status: err.status || 500,
+  });
+});
+```
+
+## Requirements
+
+- Node.js >= 16.0.0
+- Express.js >= 4.18.0
+- Zod >= 3.22.0
+- TypeScript >= 5.0.0 (for TypeScript projects)
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For issues and questions, please open an issue on the GitHub repository.
+}
+```
+
+## 📄 License
+
+MIT
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📧 Support
+
+For issues and questions, please open an issue on the GitHub repository.
+
+---
+
+Made with ❤️ for the Express.js community

package/dist/core/response-handler.d.ts

@@ -0,0 +1,3 @@
+import { Request, Response, NextFunction } from 'express';
+export declare const responseMiddleware: (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=response-handler.d.ts.map

package/dist/core/response-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-handler.d.ts","sourceRoot":"","sources":["../../src/core/response-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D,eAAO,MAAM,kBAAkB,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,SAuBjF,CAAC"}

package/dist/core/response-handler.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responseMiddleware = void 0;
+const uuid_1 = require("uuid");
+const responseMiddleware = (req, res, next) => {
+    const requestId = (0, uuid_1.v4)();
+    const timestamp = new Date().toISOString();
+    res.sendSuccess = ({ message, data = {}, meta = {} }) => {
+        res.status(200).json({
+            success: true,
+            message,
+            data,
+            meta: { ...meta, timestamp, requestId }
+        });
+    };
+    res.sendError = ({ message, error = {}, code = 'INTERNAL_ERROR', status = 500 }) => {
+        res.status(status).json({
+            success: false,
+            message,
+            error: { code, details: error },
+            meta: { timestamp, requestId }
+        });
+    };
+    next();
+};
+exports.responseMiddleware = responseMiddleware;
+//# sourceMappingURL=response-handler.js.map

package/dist/core/response-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-handler.js","sourceRoot":"","sources":["../../src/core/response-handler.ts"],"names":[],"mappings":";;;AACA,+BAAoC;AAE7B,MAAM,kBAAkB,GAAG,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;IACpF,MAAM,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,GAAG,CAAC,WAAW,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,EAAE;QACtD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;YACJ,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE;SACxC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,GAAG,EAAE,EAAE,IAAI,GAAG,gBAAgB,EAAE,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE;QACjF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YACtB,OAAO,EAAE,KAAK;YACd,OAAO;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;YAC/B,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,EAAE,CAAC;AACT,CAAC,CAAC;AAvBW,QAAA,kBAAkB,sBAuB7B"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./types";
+export * from "./core/response-handler";
+export * from "./swagger/builder";
+export * from "./swagger/registry";
+export * from "./middleware/api-documenter";
+export * from "./utils/config-loader";
+export { responseMiddleware as setupResponseHandlers } from "./core/response-handler";
+export { apiDoc as apiResponse } from "./middleware/api-documenter";
+//# 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,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,kBAAkB,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiResponse = exports.setupResponseHandlers = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./core/response-handler"), exports);
+__exportStar(require("./swagger/builder"), exports);
+__exportStar(require("./swagger/registry"), exports);
+__exportStar(require("./middleware/api-documenter"), exports);
+__exportStar(require("./utils/config-loader"), exports);
+// Re-export commonly used items for convenience
+var response_handler_1 = require("./core/response-handler");
+Object.defineProperty(exports, "setupResponseHandlers", { enumerable: true, get: function () { return response_handler_1.responseMiddleware; } });
+var api_documenter_1 = require("./middleware/api-documenter");
+Object.defineProperty(exports, "apiResponse", { enumerable: true, get: function () { return api_documenter_1.apiDoc; } });
+//# 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,0CAAwB;AACxB,0DAAwC;AACxC,oDAAkC;AAClC,qDAAmC;AACnC,8DAA4C;AAC5C,wDAAsC;AAEtC,gDAAgD;AAChD,4DAAsF;AAA7E,yHAAA,kBAAkB,OAAyB;AACpD,8DAAoE;AAA3D,6GAAA,MAAM,OAAe"}

package/dist/middleware/api-documenter.d.ts

@@ -0,0 +1,4 @@
+import { RouteDoc } from "../types";
+import { Request, Response, NextFunction } from "express";
+export declare const apiDoc: (doc: RouteDoc) => (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=api-documenter.d.ts.map

package/dist/middleware/api-documenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-documenter.d.ts","sourceRoot":"","sources":["../../src/middleware/api-documenter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,MAAM,GAAI,KAAK,QAAQ,MAwB1B,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,SACxD,CAAC"}

package/dist/middleware/api-documenter.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiDoc = void 0;
+const registry_1 = require("../swagger/registry");
+const apiDoc = (doc) => {
+    registry_1.registry.registerPath({
+        method: doc.method,
+        path: doc.path,
+        summary: doc.summary,
+        description: doc.description,
+        tags: doc.tags,
+        request: {
+            params: doc.request?.params,
+            query: doc.request?.query,
+            body: doc.request?.body
+                ? {
+                    content: { "application/json": { schema: doc.request.body } },
+                }
+                : undefined,
+        },
+        responses: {
+            200: {
+                description: "Successful Response",
+                content: { "application/json": { schema: doc.response } },
+            },
+        },
+    });
+    return (req, res, next) => next();
+};
+exports.apiDoc = apiDoc;
+//# sourceMappingURL=api-documenter.js.map

package/dist/middleware/api-documenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-documenter.js","sourceRoot":"","sources":["../../src/middleware/api-documenter.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAIxC,MAAM,MAAM,GAAG,CAAC,GAAa,EAAE,EAAE;IACtC,mBAAQ,CAAC,YAAY,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE;YACP,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,MAAa;YAClC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,KAAY;YAChC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI;gBACrB,CAAC,CAAC;oBACE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE;iBAC9D;gBACH,CAAC,CAAC,SAAS;SACd;QACD,SAAS,EAAE;YACT,GAAG,EAAE;gBACH,WAAW,EAAE,qBAAqB;gBAClC,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE;aAC1D;SACF;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC,CAAC;AAzBW,QAAA,MAAM,UAyBjB"}

package/dist/swagger/builder.d.ts

@@ -0,0 +1,4 @@
+import { StandardApiConfig } from "../types";
+import { Express } from "express";
+export declare const setupSwagger: (app: Express, config: StandardApiConfig) => void;
+//# sourceMappingURL=builder.d.ts.map

package/dist/swagger/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/swagger/builder.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,eAAO,MAAM,YAAY,GAAI,KAAK,OAAO,EAAE,QAAQ,iBAAiB,SAqHnE,CAAC"}

package/dist/swagger/builder.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupSwagger = void 0;
+const zod_to_openapi_1 = require("@asteasolutions/zod-to-openapi");
+const registry_1 = require("./registry");
+const swagger_ui_express_1 = __importDefault(require("swagger-ui-express"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const setupSwagger = (app, config) => {
+    const generator = new zod_to_openapi_1.OpenApiGeneratorV3(registry_1.registry.definitions);
+    // Build security schemes from headers
+    const components = {};
+    const security = [];
+    if (config.headers) {
+        components.securitySchemes = {};
+        Object.entries(config.headers).forEach(([name, headerConfig]) => {
+            const schemeName = name.toLowerCase();
+            if (name.toLowerCase() === "authorization") {
+                components.securitySchemes[schemeName] = {
+                    type: "http",
+                    scheme: "bearer",
+                    bearerFormat: "JWT",
+                    description: headerConfig.description,
+                };
+            }
+            else {
+                components.securitySchemes[schemeName] = {
+                    type: "apiKey",
+                    in: "header",
+                    name: name,
+                    description: headerConfig.description,
+                };
+            }
+            if (headerConfig.required) {
+                security.push({ [schemeName]: [] });
+            }
+        });
+    }
+    const docConfig = {
+        openapi: "3.0.0",
+        info: {
+            title: config.api.title,
+            version: config.api.version,
+            description: config.api.description,
+        },
+        servers: [{ url: config.api.baseUrl }],
+    };
+    if (Object.keys(components).length > 0) {
+        docConfig.components = components;
+    }
+    if (security.length > 0) {
+        docConfig.security = security;
+    }
+    const spec = generator.generateDocument(docConfig);
+    // Serve Swagger UI
+    app.use(config.swagger.path, swagger_ui_express_1.default.serve, swagger_ui_express_1.default.setup(spec, {
+        customSiteTitle: config.api.title,
+        customCss: ".swagger-ui .topbar { display: none }",
+    }));
+    // Download endpoints
+    if (config.swagger.enableDownload) {
+        // Full API spec - JSON
+        app.get(`${config.swagger.path}/openapi.json`, (req, res) => {
+            res.setHeader("Content-Type", "application/json");
+            res.setHeader("Content-Disposition", 'attachment; filename="openapi.json"');
+            res.json(spec);
+        });
+        // Full API spec - YAML
+        app.get(`${config.swagger.path}/openapi.yaml`, (req, res) => {
+            res.setHeader("Content-Type", "application/x-yaml");
+            res.setHeader("Content-Disposition", 'attachment; filename="openapi.yaml"');
+            res.send(js_yaml_1.default.dump(spec));
+        });
+        // Single endpoint spec
+        app.get(`${config.swagger.path}/endpoint/:method/:path(*)?`, (req, res) => {
+            const { method, path } = req.params;
+            const format = req.query.format || "json";
+            const fullPath = path ? `/${path}` : "/";
+            const pathSpec = spec.paths?.[fullPath];
+            const methodLower = method.toLowerCase();
+            if (!pathSpec || !pathSpec[methodLower]) {
+                return res.status(404).json({ error: "Endpoint not found" });
+            }
+            const endpointSpec = {
+                openapi: spec.openapi,
+                info: spec.info,
+                servers: spec.servers,
+                components: spec.components,
+                paths: {
+                    [fullPath]: {
+                        [methodLower]: pathSpec[methodLower],
+                    },
+                },
+            };
+            if (format === "yaml") {
+                res.setHeader("Content-Type", "application/x-yaml");
+                res.send(js_yaml_1.default.dump(endpointSpec));
+            }
+            else {
+                res.json(endpointSpec);
+            }
+        });
+    }
+};
+exports.setupSwagger = setupSwagger;
+//# sourceMappingURL=builder.js.map

package/dist/swagger/builder.js.map

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

package/dist/swagger/registry.d.ts

@@ -0,0 +1,3 @@
+import { OpenAPIRegistry } from '@asteasolutions/zod-to-openapi';
+export declare const registry: OpenAPIRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/swagger/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/swagger/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,eAAO,MAAM,QAAQ,iBAAwB,CAAC"}

package/dist/swagger/registry.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registry = void 0;
+const zod_to_openapi_1 = require("@asteasolutions/zod-to-openapi");
+exports.registry = new zod_to_openapi_1.OpenAPIRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/swagger/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/swagger/registry.ts"],"names":[],"mappings":";;;AAAA,mEAAiE;AAEpD,QAAA,QAAQ,GAAG,IAAI,gCAAe,EAAE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,59 @@
+import { ZodSchema } from "zod";
+export interface HeaderConfig {
+    description: string;
+    required: boolean;
+    example?: string;
+}
+export interface StandardApiConfig {
+    api: {
+        title: string;
+        description: string;
+        version: string;
+        baseUrl: string;
+    };
+    headers?: Record<string, HeaderConfig>;
+    swagger: {
+        path: string;
+        enableDownload: boolean;
+    };
+}
+export interface RouteDoc {
+    method: "get" | "post" | "put" | "delete" | "patch";
+    path: string;
+    summary: string;
+    description?: string;
+    tags?: string[];
+    request?: {
+        body?: ZodSchema;
+        query?: ZodSchema;
+        params?: ZodSchema;
+        headers?: ZodSchema;
+    };
+    response: ZodSchema;
+    errors?: {
+        [statusCode: number]: {
+            description: string;
+            schema?: ZodSchema;
+        };
+    };
+}
+export interface SuccessOptions {
+    message: string;
+    data?: any;
+    meta?: any;
+}
+export interface ErrorOptions {
+    message: string;
+    error?: any;
+    code?: string;
+    status?: number;
+}
+declare global {
+    namespace Express {
+        interface Response {
+            sendSuccess: (options: SuccessOptions) => void;
+            sendError: (options: ErrorOptions) => void;
+        }
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,KAAK,CAAC,EAAE,SAAS,CAAC;QAClB,MAAM,CAAC,EAAE,SAAS,CAAC;QACnB,OAAO,CAAC,EAAE,SAAS,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,CAAC,UAAU,EAAE,MAAM,GAAG;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,SAAS,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO,CAAC;QAChB,UAAU,QAAQ;YAChB,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;YAC/C,SAAS,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;SAC5C;KACF;CACF"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,3 @@
+import { StandardApiConfig } from "../types";
+export declare const loadConfig: (configPath?: string) => StandardApiConfig;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAI7C,eAAO,MAAM,UAAU,GAAI,aAAa,MAAM,KAAG,iBAsChD,CAAC"}

package/dist/utils/config-loader.js

@@ -0,0 +1,73 @@
+"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 __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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const loadConfig = (configPath) => {
+    if (!configPath) {
+        // Try to find config file in common locations
+        const possiblePaths = [
+            "standard-api.config.ts",
+            "standard-api.config.js",
+            "./config/standard-api.config.ts",
+            "./config/standard-api.config.js",
+        ];
+        for (const p of possiblePaths) {
+            const fullPath = path.resolve(process.cwd(), p);
+            if (fs.existsSync(fullPath)) {
+                configPath = fullPath;
+                break;
+            }
+        }
+    }
+    if (!configPath) {
+        throw new Error("Config file not found. Please provide a configPath or create standard-api.config.ts/js");
+    }
+    const fullPath = path.resolve(process.cwd(), configPath);
+    if (!fs.existsSync(fullPath)) {
+        throw new Error(`Config file not found at: ${fullPath}`);
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const config = require(fullPath);
+        return config.default || config;
+    }
+    catch (error) {
+        throw new Error(`Failed to load config from ${fullPath}: ${error}`);
+    }
+};
+exports.loadConfig = loadConfig;
+//# sourceMappingURL=config-loader.js.map

package/dist/utils/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,2CAA6B;AAC7B,uCAAyB;AAElB,MAAM,UAAU,GAAG,CAAC,UAAmB,EAAqB,EAAE;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,8CAA8C;QAC9C,MAAM,aAAa,GAAG;YACpB,wBAAwB;YACxB,wBAAwB;YACxB,iCAAiC;YACjC,iCAAiC;SAClC,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,UAAU,GAAG,QAAQ,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC,CAAC;AAtCW,QAAA,UAAU,cAsCrB"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "standard-api-core",
+  "version": "1.0.0",
+  "description": "Production-ready NPM package for standardized API responses and automatic Swagger documentation generation for Express.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@asteasolutions/zod-to-openapi": "^8.2.0",
+    "express": "^4.22.1",
+    "js-yaml": "^4.1.0",
+    "swagger-ui-express": "^5.0.0",
+    "uuid": "^9.0.1",
+    "zod": "^4.3.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.3",
+    "@types/supertest": "^6.0.2",
+    "@types/swagger-ui-express": "^4.1.6",
+    "@types/uuid": "^9.0.8",
+    "jest": "^30.2.0",
+    "supertest": "^7.1.4",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "express": "^4.22.0",
+    "zod": "^4.3.0"
+  },
+  "keywords": [
+    "api",
+    "rest",
+    "swagger",
+    "openapi",
+    "express",
+    "middleware",
+    "response",
+    "standardization",
+    "documentation",
+    "zod",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inaumanmajeed/standard-api-core"
+  },
+  "bugs": {
+    "url": "https://github.com/inaumanmajeed/standard-api-core/issues"
+  },
+  "homepage": "https://github.com/inaumanmajeed/standard-api-core#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "commonjs"
+}