@0layimika/api-response-kit 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# api-response-kit
+
+> A small, TypeScript-first toolkit for **consistent API success and error responses**.
+
+---
+
+## Why This Exists
+
+Most APIs suffer from the same problems:
+
+- Inconsistent response shapes across endpoints
+- Ad-hoc error handling (`throw new Error`, random JSON)
+- Frontend has to guess response structures
+- Documentation drifts away from reality
+- Boilerplate `res.status().json()` everywhere
+
+**api-response-kit** fixes this by enforcing a **predictable response contract** for **both success and error responses** while keeping your code clean and framework-agnostic.
+
+---
+
+## Core Idea
+
+Instead of:
+
+```ts
+res.status(200).json(user)
+res.status(400).json({ error: "Invalid input" })
+```
+
+You write:
+```ts
+return Ok(user)
+return BadRequest("Invalid input")
+```
+## Response Contract
+### Success Response
+```ts
+type ApiSuccess<T> = {
+  success: true
+  data: T
+  message?: string
+  meta?: Record<string, unknown>
+}
+```
+### Error Response
+```ts
+type ApiError = {
+  success: false
+  error: {
+    code: string
+    message: string
+    details?: unknown
+  }
+}
+```
+## Installation
+```bash
+npm install api-response-kit
+
+yarn add api-response-kit
+
+pnpm add api-response-kit
+```
+## Basic Usage
+### Success Helpers
+```ts
+import { Ok, Created, NoContent } from "api-response-kit"
+
+return Ok(user)
+return Created(newUser)
+return NoContent()
+```
+### Error Helpers
+```ts
+import { BadRequest, NotFound, Unauthorized } from "api-response-kit"
+
+if (!user) return NotFound("User not found")
+if (!email) return BadRequest("Email is required")
+if (!token) return Unauthorized()
+```
+
+## Controller Example
+```ts
+export function getUser(id: string) {
+  const user = findUser(id)
+
+  if (!user) {
+    return NotFound("User")
+  }
+
+  return Ok(user)
+}
+```
+
+## Express Adapter Example
+```ts
+import { sendResponse } from "api-response-kit/express"
+
+app.get("/users/:id", (req, res) => {
+  const response = getUser(req.params.id)
+  sendResponse(res, response)
+})
+```
+## Custom Errors
+```ts
+import { CustomError } from "api-response-kit"
+
+return CustomError({
+  code: "PAYMENT_FAILED",
+  status: 402,
+  message: "Payment authorization failed"
+})
+```
+

package/dist/adapters/express.d.mts

@@ -0,0 +1,6 @@
+import { Response } from 'express';
+import { b as ApiResponse } from '../response-DV8HnqXP.mjs';
+
+declare function sendResponse(res: Response, response: ApiResponse<unknown>): void;
+
+export { sendResponse };

package/dist/adapters/express.d.ts

@@ -0,0 +1,6 @@
+import { Response } from 'express';
+import { b as ApiResponse } from '../response-DV8HnqXP.js';
+
+declare function sendResponse(res: Response, response: ApiResponse<unknown>): void;
+
+export { sendResponse };

package/dist/adapters/express.js

@@ -0,0 +1,55 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/express.ts
+var express_exports = {};
+__export(express_exports, {
+  sendResponse: () => sendResponse
+});
+module.exports = __toCommonJS(express_exports);
+
+// src/core/status-map.ts
+var statusMap = {
+  Ok: 200,
+  Created: 201,
+  NoContent: 204,
+  BadRequest: 400,
+  Unauthorized: 401,
+  Forbidden: 403,
+  NotFound: 404,
+  Conflict: 409,
+  InternalError: 500
+};
+
+// src/adapters/express.ts
+function sendResponse(res, response) {
+  let status = 200;
+  if (response.success) {
+    status = 200;
+  } else {
+    const errorCode = response.error.code;
+    status = statusMap[errorCode] || 500;
+  }
+  res.status(status).json(response);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sendResponse
+});
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/express.ts","../../src/core/status-map.ts"],"sourcesContent":["import {Response as ExResponse} from \"express\"\nimport {ApiResponse} from \"../core/response\";\nimport {statusMap} from \"../core/status-map\";\n\nexport function sendResponse(res: ExResponse, response: ApiResponse<unknown>): void {\n    let status = 200\n    if (response.success) {\n        status = 200\n    } else {\n        const errorCode = response.error.code\n        status = statusMap[errorCode] || 500\n    }\n    res.status(status).json(response)\n}","export const statusMap: Record<string, number> = {\n    Ok: 200,\n    Created: 201,\n    NoContent: 204,\n    BadRequest: 400,\n    Unauthorized: 401,\n    Forbidden: 403,\n    NotFound: 404,\n    Conflict: 409,\n    InternalError: 500,\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,YAAoC;AAAA,EAC7C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,eAAe;AACnB;;;ADNO,SAAS,aAAa,KAAiB,UAAsC;AAChF,MAAI,SAAS;AACb,MAAI,SAAS,SAAS;AAClB,aAAS;AAAA,EACb,OAAO;AACH,UAAM,YAAY,SAAS,MAAM;AACjC,aAAS,UAAU,SAAS,KAAK;AAAA,EACrC;AACA,MAAI,OAAO,MAAM,EAAE,KAAK,QAAQ;AACpC;","names":[]}

package/dist/adapters/express.mjs

@@ -0,0 +1,8 @@
+import {
+  sendResponse
+} from "../chunk-5HL56LEG.mjs";
+import "../chunk-VJJRPHMZ.mjs";
+export {
+  sendResponse
+};
+//# sourceMappingURL=express.mjs.map

package/dist/adapters/express.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/adapters/fastify.d.mts

@@ -0,0 +1,6 @@
+import { FastifyReply } from 'fastify';
+import { b as ApiResponse } from '../response-DV8HnqXP.mjs';
+
+declare function sendResponse(reply: FastifyReply, response: ApiResponse<unknown>): void;
+
+export { sendResponse };

package/dist/adapters/fastify.d.ts

@@ -0,0 +1,6 @@
+import { FastifyReply } from 'fastify';
+import { b as ApiResponse } from '../response-DV8HnqXP.js';
+
+declare function sendResponse(reply: FastifyReply, response: ApiResponse<unknown>): void;
+
+export { sendResponse };

package/dist/adapters/fastify.js

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/fastify.ts
+var fastify_exports = {};
+__export(fastify_exports, {
+  sendResponse: () => sendResponse
+});
+module.exports = __toCommonJS(fastify_exports);
+
+// src/core/status-map.ts
+var statusMap = {
+  Ok: 200,
+  Created: 201,
+  NoContent: 204,
+  BadRequest: 400,
+  Unauthorized: 401,
+  Forbidden: 403,
+  NotFound: 404,
+  Conflict: 409,
+  InternalError: 500
+};
+
+// src/adapters/fastify.ts
+function sendResponse(reply, response) {
+  let status = 200;
+  if (!response.success) {
+    const errorCode = response.error.code;
+    status = statusMap[errorCode] || 500;
+  }
+  reply.status(status).send(response);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sendResponse
+});
+//# sourceMappingURL=fastify.js.map

package/dist/adapters/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/fastify.ts","../../src/core/status-map.ts"],"sourcesContent":["import {FastifyReply} from \"fastify\"\nimport { ApiResponse } from \"../core/response\"\nimport { statusMap } from \"../core/status-map\"\n\nexport function sendResponse(reply: FastifyReply, response: ApiResponse<unknown>): void {\n    let status = 200\n\n    if (!response.success) {\n        const errorCode = response.error.code\n        status = statusMap[errorCode] || 500\n    }\n\n    reply.status(status).send(response)\n}\n","export const statusMap: Record<string, number> = {\n    Ok: 200,\n    Created: 201,\n    NoContent: 204,\n    BadRequest: 400,\n    Unauthorized: 401,\n    Forbidden: 403,\n    NotFound: 404,\n    Conflict: 409,\n    InternalError: 500,\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,YAAoC;AAAA,EAC7C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,eAAe;AACnB;;;ADNO,SAAS,aAAa,OAAqB,UAAsC;AACpF,MAAI,SAAS;AAEb,MAAI,CAAC,SAAS,SAAS;AACnB,UAAM,YAAY,SAAS,MAAM;AACjC,aAAS,UAAU,SAAS,KAAK;AAAA,EACrC;AAEA,QAAM,OAAO,MAAM,EAAE,KAAK,QAAQ;AACtC;","names":[]}

package/dist/adapters/fastify.mjs

@@ -0,0 +1,8 @@
+import {
+  sendResponse
+} from "../chunk-OD5AKNUG.mjs";
+import "../chunk-VJJRPHMZ.mjs";
+export {
+  sendResponse
+};
+//# sourceMappingURL=fastify.mjs.map

package/dist/adapters/fastify.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-5HL56LEG.mjs

@@ -0,0 +1,20 @@
+import {
+  statusMap
+} from "./chunk-VJJRPHMZ.mjs";
+
+// src/adapters/express.ts
+function sendResponse(res, response) {
+  let status = 200;
+  if (response.success) {
+    status = 200;
+  } else {
+    const errorCode = response.error.code;
+    status = statusMap[errorCode] || 500;
+  }
+  res.status(status).json(response);
+}
+
+export {
+  sendResponse
+};
+//# sourceMappingURL=chunk-5HL56LEG.mjs.map

package/dist/chunk-5HL56LEG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/express.ts"],"sourcesContent":["import {Response as ExResponse} from \"express\"\nimport {ApiResponse} from \"../core/response\";\nimport {statusMap} from \"../core/status-map\";\n\nexport function sendResponse(res: ExResponse, response: ApiResponse<unknown>): void {\n    let status = 200\n    if (response.success) {\n        status = 200\n    } else {\n        const errorCode = response.error.code\n        status = statusMap[errorCode] || 500\n    }\n    res.status(status).json(response)\n}"],"mappings":";;;;;AAIO,SAAS,aAAa,KAAiB,UAAsC;AAChF,MAAI,SAAS;AACb,MAAI,SAAS,SAAS;AAClB,aAAS;AAAA,EACb,OAAO;AACH,UAAM,YAAY,SAAS,MAAM;AACjC,aAAS,UAAU,SAAS,KAAK;AAAA,EACrC;AACA,MAAI,OAAO,MAAM,EAAE,KAAK,QAAQ;AACpC;","names":[]}

package/dist/chunk-OD5AKNUG.mjs

@@ -0,0 +1,18 @@
+import {
+  statusMap
+} from "./chunk-VJJRPHMZ.mjs";
+
+// src/adapters/fastify.ts
+function sendResponse(reply, response) {
+  let status = 200;
+  if (!response.success) {
+    const errorCode = response.error.code;
+    status = statusMap[errorCode] || 500;
+  }
+  reply.status(status).send(response);
+}
+
+export {
+  sendResponse
+};
+//# sourceMappingURL=chunk-OD5AKNUG.mjs.map

package/dist/chunk-OD5AKNUG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/fastify.ts"],"sourcesContent":["import {FastifyReply} from \"fastify\"\nimport { ApiResponse } from \"../core/response\"\nimport { statusMap } from \"../core/status-map\"\n\nexport function sendResponse(reply: FastifyReply, response: ApiResponse<unknown>): void {\n    let status = 200\n\n    if (!response.success) {\n        const errorCode = response.error.code\n        status = statusMap[errorCode] || 500\n    }\n\n    reply.status(status).send(response)\n}\n"],"mappings":";;;;;AAIO,SAAS,aAAa,OAAqB,UAAsC;AACpF,MAAI,SAAS;AAEb,MAAI,CAAC,SAAS,SAAS;AACnB,UAAM,YAAY,SAAS,MAAM;AACjC,aAAS,UAAU,SAAS,KAAK;AAAA,EACrC;AAEA,QAAM,OAAO,MAAM,EAAE,KAAK,QAAQ;AACtC;","names":[]}

package/dist/chunk-VJJRPHMZ.mjs

@@ -0,0 +1,17 @@
+// src/core/status-map.ts
+var statusMap = {
+  Ok: 200,
+  Created: 201,
+  NoContent: 204,
+  BadRequest: 400,
+  Unauthorized: 401,
+  Forbidden: 403,
+  NotFound: 404,
+  Conflict: 409,
+  InternalError: 500
+};
+
+export {
+  statusMap
+};
+//# sourceMappingURL=chunk-VJJRPHMZ.mjs.map

package/dist/chunk-VJJRPHMZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/status-map.ts"],"sourcesContent":["export const statusMap: Record<string, number> = {\n    Ok: 200,\n    Created: 201,\n    NoContent: 204,\n    BadRequest: 400,\n    Unauthorized: 401,\n    Forbidden: 403,\n    NotFound: 404,\n    Conflict: 409,\n    InternalError: 500,\n}"],"mappings":";AAAO,IAAM,YAAoC;AAAA,EAC7C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,eAAe;AACnB;","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,26 @@
+import { A as ApiSuccess, a as ApiError } from './response-DV8HnqXP.mjs';
+export { b as ApiResponse } from './response-DV8HnqXP.mjs';
+export { sendResponse as ExpressResponse } from './adapters/express.mjs';
+export { sendResponse as FastifyResponse } from './adapters/fastify.mjs';
+import 'express';
+import 'fastify';
+
+declare function Ok<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>;
+declare function Created<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>;
+declare function NoContent(message?: string): ApiSuccess<null>;
+declare function CustomSuccess<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>;
+
+declare function BadRequest(message: string, details?: unknown): ApiError;
+declare function Unauthorized(message?: string): ApiError;
+declare function Forbidden(message?: string): ApiError;
+declare function NotFound(resource?: string): ApiError;
+declare function Conflict(message: string): ApiError;
+declare function InternalError(message?: string, details?: unknown): ApiError;
+interface CustomErrorParams {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+declare function CustomError({ code, message, details }: CustomErrorParams): ApiError;
+
+export { ApiError, ApiSuccess, BadRequest, Conflict, Created, CustomError, CustomSuccess, Forbidden, InternalError, NoContent, NotFound, Ok, Unauthorized };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { A as ApiSuccess, a as ApiError } from './response-DV8HnqXP.js';
+export { b as ApiResponse } from './response-DV8HnqXP.js';
+export { sendResponse as ExpressResponse } from './adapters/express.js';
+export { sendResponse as FastifyResponse } from './adapters/fastify.js';
+import 'express';
+import 'fastify';
+
+declare function Ok<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>;
+declare function Created<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>;
+declare function NoContent(message?: string): ApiSuccess<null>;
+declare function CustomSuccess<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>;
+
+declare function BadRequest(message: string, details?: unknown): ApiError;
+declare function Unauthorized(message?: string): ApiError;
+declare function Forbidden(message?: string): ApiError;
+declare function NotFound(resource?: string): ApiError;
+declare function Conflict(message: string): ApiError;
+declare function InternalError(message?: string, details?: unknown): ApiError;
+interface CustomErrorParams {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+declare function CustomError({ code, message, details }: CustomErrorParams): ApiError;
+
+export { ApiError, ApiSuccess, BadRequest, Conflict, Created, CustomError, CustomSuccess, Forbidden, InternalError, NoContent, NotFound, Ok, Unauthorized };

package/dist/index.js

@@ -0,0 +1,133 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BadRequest: () => BadRequest,
+  Conflict: () => Conflict,
+  Created: () => Created,
+  CustomError: () => CustomError,
+  CustomSuccess: () => CustomSuccess,
+  ExpressResponse: () => sendResponse,
+  FastifyResponse: () => sendResponse2,
+  Forbidden: () => Forbidden,
+  InternalError: () => InternalError,
+  NoContent: () => NoContent,
+  NotFound: () => NotFound,
+  Ok: () => Ok,
+  Unauthorized: () => Unauthorized
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/success.ts
+function Ok(data, message, meta) {
+  return { success: true, data, message, meta };
+}
+function Created(data, message, meta) {
+  return { success: true, data, message, meta };
+}
+function NoContent(message) {
+  return { success: true, data: null, message };
+}
+function CustomSuccess(data, message, meta) {
+  return { success: true, data, message, meta };
+}
+
+// src/core/error.ts
+function BadRequest(message, details) {
+  return { success: false, error: { code: "BAD_REQUEST", message, details } };
+}
+function Unauthorized(message = "Unauthorized") {
+  return { success: false, error: { code: "UNAUTHORIZED", message } };
+}
+function Forbidden(message = "Forbidden") {
+  return { success: false, error: { code: "FORBIDDEN", message } };
+}
+function NotFound(resource = "Resource") {
+  return { success: false, error: { code: "NOT_FOUND", message: `${resource} not found` } };
+}
+function Conflict(message) {
+  return { success: false, error: { code: "CONFLICT", message } };
+}
+function InternalError(message = "Internal server error", details) {
+  return { success: false, error: { code: "INTERNAL_ERROR", message, details } };
+}
+function CustomError({ code, message, details }) {
+  return {
+    success: false,
+    error: {
+      code,
+      message,
+      details
+    }
+  };
+}
+
+// src/core/status-map.ts
+var statusMap = {
+  Ok: 200,
+  Created: 201,
+  NoContent: 204,
+  BadRequest: 400,
+  Unauthorized: 401,
+  Forbidden: 403,
+  NotFound: 404,
+  Conflict: 409,
+  InternalError: 500
+};
+
+// src/adapters/express.ts
+function sendResponse(res, response) {
+  let status = 200;
+  if (response.success) {
+    status = 200;
+  } else {
+    const errorCode = response.error.code;
+    status = statusMap[errorCode] || 500;
+  }
+  res.status(status).json(response);
+}
+
+// src/adapters/fastify.ts
+function sendResponse2(reply, response) {
+  let status = 200;
+  if (!response.success) {
+    const errorCode = response.error.code;
+    status = statusMap[errorCode] || 500;
+  }
+  reply.status(status).send(response);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BadRequest,
+  Conflict,
+  Created,
+  CustomError,
+  CustomSuccess,
+  ExpressResponse,
+  FastifyResponse,
+  Forbidden,
+  InternalError,
+  NoContent,
+  NotFound,
+  Ok,
+  Unauthorized
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core/success.ts","../src/core/error.ts","../src/core/status-map.ts","../src/adapters/express.ts","../src/adapters/fastify.ts"],"sourcesContent":["export type { ApiSuccess, ApiError, ApiResponse } from \"./core/response\"\n\nexport { Ok, Created, NoContent, CustomSuccess } from \"./core/success\"\n\nexport { BadRequest, Unauthorized, Forbidden, NotFound, Conflict, InternalError, CustomError } from \"./core/error\"\n\nexport {sendResponse as ExpressResponse} from \"./adapters/express\"\nexport {sendResponse as FastifyResponse} from \"./adapters/fastify\"","import {ApiSuccess} from \"./response\";\n\nexport function Ok<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>{\n    return {success:true, data, message, meta}\n}\n\nexport function Created<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T> {\n    return { success: true, data, message, meta }\n}\n\nexport function NoContent(message?: string): ApiSuccess<null> {\n    return { success: true, data: null, message }\n}\n\nexport function CustomSuccess<T>(\n    data: T,\n    message?: string,\n    meta?: Record<string, unknown>\n): ApiSuccess<T> {\n    return { success: true, data, message, meta }\n}","import { ApiError } from \"./response\"\n\nexport function BadRequest(message: string, details?: unknown): ApiError {\n    return { success: false, error: { code: \"BAD_REQUEST\", message, details } }\n}\n\nexport function Unauthorized(message = \"Unauthorized\"): ApiError {\n    return { success: false, error: { code: \"UNAUTHORIZED\", message } }\n}\n\nexport function Forbidden(message = \"Forbidden\"): ApiError {\n    return { success: false, error: { code: \"FORBIDDEN\", message } }\n}\n\nexport function NotFound(resource = \"Resource\"): ApiError {\n    return { success: false, error: { code: \"NOT_FOUND\", message: `${resource} not found` } }\n}\n\nexport function Conflict(message: string): ApiError {\n    return { success: false, error: { code: \"CONFLICT\", message } }\n}\n\nexport function InternalError(message = \"Internal server error\", details?: unknown): ApiError {\n    return { success: false, error: { code: \"INTERNAL_ERROR\", message, details } }\n}\n\ninterface CustomErrorParams {\n    code: string\n    message: string\n    details?: unknown\n}\nexport function CustomError({ code, message, details }: CustomErrorParams): ApiError {\n    return {\n        success: false,\n        error: {\n            code,\n            message,\n            details,\n        },\n    }\n}\n","export const statusMap: Record<string, number> = {\n    Ok: 200,\n    Created: 201,\n    NoContent: 204,\n    BadRequest: 400,\n    Unauthorized: 401,\n    Forbidden: 403,\n    NotFound: 404,\n    Conflict: 409,\n    InternalError: 500,\n}","import {Response as ExResponse} from \"express\"\nimport {ApiResponse} from \"../core/response\";\nimport {statusMap} from \"../core/status-map\";\n\nexport function sendResponse(res: ExResponse, response: ApiResponse<unknown>): void {\n    let status = 200\n    if (response.success) {\n        status = 200\n    } else {\n        const errorCode = response.error.code\n        status = statusMap[errorCode] || 500\n    }\n    res.status(status).json(response)\n}","import {FastifyReply} from \"fastify\"\nimport { ApiResponse } from \"../core/response\"\nimport { statusMap } from \"../core/status-map\"\n\nexport function sendResponse(reply: FastifyReply, response: ApiResponse<unknown>): void {\n    let status = 200\n\n    if (!response.success) {\n        const errorCode = response.error.code\n        status = statusMap[errorCode] || 500\n    }\n\n    reply.status(status).send(response)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,SAAS,GAAM,MAAS,SAAkB,MAA8C;AAC3F,SAAO,EAAC,SAAQ,MAAM,MAAM,SAAS,KAAI;AAC7C;AAEO,SAAS,QAAW,MAAS,SAAkB,MAA+C;AACjG,SAAO,EAAE,SAAS,MAAM,MAAM,SAAS,KAAK;AAChD;AAEO,SAAS,UAAU,SAAoC;AAC1D,SAAO,EAAE,SAAS,MAAM,MAAM,MAAM,QAAQ;AAChD;AAEO,SAAS,cACZ,MACA,SACA,MACa;AACb,SAAO,EAAE,SAAS,MAAM,MAAM,SAAS,KAAK;AAChD;;;AClBO,SAAS,WAAW,SAAiB,SAA6B;AACrE,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,eAAe,SAAS,QAAQ,EAAE;AAC9E;AAEO,SAAS,aAAa,UAAU,gBAA0B;AAC7D,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,gBAAgB,QAAQ,EAAE;AACtE;AAEO,SAAS,UAAU,UAAU,aAAuB;AACvD,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,aAAa,QAAQ,EAAE;AACnE;AAEO,SAAS,SAAS,WAAW,YAAsB;AACtD,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,aAAa,SAAS,GAAG,QAAQ,aAAa,EAAE;AAC5F;AAEO,SAAS,SAAS,SAA2B;AAChD,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,YAAY,QAAQ,EAAE;AAClE;AAEO,SAAS,cAAc,UAAU,yBAAyB,SAA6B;AAC1F,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,QAAQ,EAAE;AACjF;AAOO,SAAS,YAAY,EAAE,MAAM,SAAS,QAAQ,GAAgC;AACjF,SAAO;AAAA,IACH,SAAS;AAAA,IACT,OAAO;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AACJ;;;ACxCO,IAAM,YAAoC;AAAA,EAC7C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,eAAe;AACnB;;;ACNO,SAAS,aAAa,KAAiB,UAAsC;AAChF,MAAI,SAAS;AACb,MAAI,SAAS,SAAS;AAClB,aAAS;AAAA,EACb,OAAO;AACH,UAAM,YAAY,SAAS,MAAM;AACjC,aAAS,UAAU,SAAS,KAAK;AAAA,EACrC;AACA,MAAI,OAAO,MAAM,EAAE,KAAK,QAAQ;AACpC;;;ACTO,SAASC,cAAa,OAAqB,UAAsC;AACpF,MAAI,SAAS;AAEb,MAAI,CAAC,SAAS,SAAS;AACnB,UAAM,YAAY,SAAS,MAAM;AACjC,aAAS,UAAU,SAAS,KAAK;AAAA,EACrC;AAEA,QAAM,OAAO,MAAM,EAAE,KAAK,QAAQ;AACtC;","names":["sendResponse","sendResponse"]}

package/dist/index.mjs

@@ -0,0 +1,67 @@
+import {
+  sendResponse
+} from "./chunk-5HL56LEG.mjs";
+import {
+  sendResponse as sendResponse2
+} from "./chunk-OD5AKNUG.mjs";
+import "./chunk-VJJRPHMZ.mjs";
+
+// src/core/success.ts
+function Ok(data, message, meta) {
+  return { success: true, data, message, meta };
+}
+function Created(data, message, meta) {
+  return { success: true, data, message, meta };
+}
+function NoContent(message) {
+  return { success: true, data: null, message };
+}
+function CustomSuccess(data, message, meta) {
+  return { success: true, data, message, meta };
+}
+
+// src/core/error.ts
+function BadRequest(message, details) {
+  return { success: false, error: { code: "BAD_REQUEST", message, details } };
+}
+function Unauthorized(message = "Unauthorized") {
+  return { success: false, error: { code: "UNAUTHORIZED", message } };
+}
+function Forbidden(message = "Forbidden") {
+  return { success: false, error: { code: "FORBIDDEN", message } };
+}
+function NotFound(resource = "Resource") {
+  return { success: false, error: { code: "NOT_FOUND", message: `${resource} not found` } };
+}
+function Conflict(message) {
+  return { success: false, error: { code: "CONFLICT", message } };
+}
+function InternalError(message = "Internal server error", details) {
+  return { success: false, error: { code: "INTERNAL_ERROR", message, details } };
+}
+function CustomError({ code, message, details }) {
+  return {
+    success: false,
+    error: {
+      code,
+      message,
+      details
+    }
+  };
+}
+export {
+  BadRequest,
+  Conflict,
+  Created,
+  CustomError,
+  CustomSuccess,
+  sendResponse as ExpressResponse,
+  sendResponse2 as FastifyResponse,
+  Forbidden,
+  InternalError,
+  NoContent,
+  NotFound,
+  Ok,
+  Unauthorized
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/success.ts","../src/core/error.ts"],"sourcesContent":["import {ApiSuccess} from \"./response\";\n\nexport function Ok<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>{\n    return {success:true, data, message, meta}\n}\n\nexport function Created<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T> {\n    return { success: true, data, message, meta }\n}\n\nexport function NoContent(message?: string): ApiSuccess<null> {\n    return { success: true, data: null, message }\n}\n\nexport function CustomSuccess<T>(\n    data: T,\n    message?: string,\n    meta?: Record<string, unknown>\n): ApiSuccess<T> {\n    return { success: true, data, message, meta }\n}","import { ApiError } from \"./response\"\n\nexport function BadRequest(message: string, details?: unknown): ApiError {\n    return { success: false, error: { code: \"BAD_REQUEST\", message, details } }\n}\n\nexport function Unauthorized(message = \"Unauthorized\"): ApiError {\n    return { success: false, error: { code: \"UNAUTHORIZED\", message } }\n}\n\nexport function Forbidden(message = \"Forbidden\"): ApiError {\n    return { success: false, error: { code: \"FORBIDDEN\", message } }\n}\n\nexport function NotFound(resource = \"Resource\"): ApiError {\n    return { success: false, error: { code: \"NOT_FOUND\", message: `${resource} not found` } }\n}\n\nexport function Conflict(message: string): ApiError {\n    return { success: false, error: { code: \"CONFLICT\", message } }\n}\n\nexport function InternalError(message = \"Internal server error\", details?: unknown): ApiError {\n    return { success: false, error: { code: \"INTERNAL_ERROR\", message, details } }\n}\n\ninterface CustomErrorParams {\n    code: string\n    message: string\n    details?: unknown\n}\nexport function CustomError({ code, message, details }: CustomErrorParams): ApiError {\n    return {\n        success: false,\n        error: {\n            code,\n            message,\n            details,\n        },\n    }\n}\n"],"mappings":";;;;;;;;;AAEO,SAAS,GAAM,MAAS,SAAkB,MAA8C;AAC3F,SAAO,EAAC,SAAQ,MAAM,MAAM,SAAS,KAAI;AAC7C;AAEO,SAAS,QAAW,MAAS,SAAkB,MAA+C;AACjG,SAAO,EAAE,SAAS,MAAM,MAAM,SAAS,KAAK;AAChD;AAEO,SAAS,UAAU,SAAoC;AAC1D,SAAO,EAAE,SAAS,MAAM,MAAM,MAAM,QAAQ;AAChD;AAEO,SAAS,cACZ,MACA,SACA,MACa;AACb,SAAO,EAAE,SAAS,MAAM,MAAM,SAAS,KAAK;AAChD;;;AClBO,SAAS,WAAW,SAAiB,SAA6B;AACrE,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,eAAe,SAAS,QAAQ,EAAE;AAC9E;AAEO,SAAS,aAAa,UAAU,gBAA0B;AAC7D,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,gBAAgB,QAAQ,EAAE;AACtE;AAEO,SAAS,UAAU,UAAU,aAAuB;AACvD,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,aAAa,QAAQ,EAAE;AACnE;AAEO,SAAS,SAAS,WAAW,YAAsB;AACtD,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,aAAa,SAAS,GAAG,QAAQ,aAAa,EAAE;AAC5F;AAEO,SAAS,SAAS,SAA2B;AAChD,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,YAAY,QAAQ,EAAE;AAClE;AAEO,SAAS,cAAc,UAAU,yBAAyB,SAA6B;AAC1F,SAAO,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,QAAQ,EAAE;AACjF;AAOO,SAAS,YAAY,EAAE,MAAM,SAAS,QAAQ,GAAgC;AACjF,SAAO;AAAA,IACH,SAAS;AAAA,IACT,OAAO;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AACJ;","names":[]}

package/dist/response-DV8HnqXP.d.mts

@@ -0,0 +1,17 @@
+type ApiSuccess<T> = {
+    success: true;
+    data: T;
+    message?: string;
+    meta?: Record<string, unknown>;
+};
+type ApiError = {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+};
+type ApiResponse<T> = ApiSuccess<T> | ApiError;
+
+export type { ApiSuccess as A, ApiError as a, ApiResponse as b };

package/dist/response-DV8HnqXP.d.ts

@@ -0,0 +1,17 @@
+type ApiSuccess<T> = {
+    success: true;
+    data: T;
+    message?: string;
+    meta?: Record<string, unknown>;
+};
+type ApiError = {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+};
+type ApiResponse<T> = ApiSuccess<T> | ApiError;
+
+export type { ApiSuccess as A, ApiError as a, ApiResponse as b };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@0layimika/api-response-kit",
+  "version": "0.1.0",
+  "description": "A typed toolkit for consistent API success and error responses",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./express": {
+      "import": "./dist/adapters/express.js",
+      "require": "./dist/adapters/express.cjs"
+    },
+    "./fastify": {
+      "import": "./dist/adapters/fastify.js",
+      "require": "./dist/adapters/fastify.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "express": "^5.2.1",
+    "fastify": "^5.6.2",
+    "tsup": "^8.5.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "private": false
+}

package/src/adapters/express.ts

@@ -0,0 +1,14 @@
+import {Response as ExResponse} from "express"
+import {ApiResponse} from "../core/response";
+import {statusMap} from "../core/status-map";
+
+export function sendResponse(res: ExResponse, response: ApiResponse<unknown>): void {
+    let status = 200
+    if (response.success) {
+        status = 200
+    } else {
+        const errorCode = response.error.code
+        status = statusMap[errorCode] || 500
+    }
+    res.status(status).json(response)
+}

package/src/adapters/fastify.ts

@@ -0,0 +1,14 @@
+import {FastifyReply} from "fastify"
+import { ApiResponse } from "../core/response"
+import { statusMap } from "../core/status-map"
+
+export function sendResponse(reply: FastifyReply, response: ApiResponse<unknown>): void {
+    let status = 200
+
+    if (!response.success) {
+        const errorCode = response.error.code
+        status = statusMap[errorCode] || 500
+    }
+
+    reply.status(status).send(response)
+}

package/src/core/error.ts

@@ -0,0 +1,41 @@
+import { ApiError } from "./response"
+
+export function BadRequest(message: string, details?: unknown): ApiError {
+    return { success: false, error: { code: "BAD_REQUEST", message, details } }
+}
+
+export function Unauthorized(message = "Unauthorized"): ApiError {
+    return { success: false, error: { code: "UNAUTHORIZED", message } }
+}
+
+export function Forbidden(message = "Forbidden"): ApiError {
+    return { success: false, error: { code: "FORBIDDEN", message } }
+}
+
+export function NotFound(resource = "Resource"): ApiError {
+    return { success: false, error: { code: "NOT_FOUND", message: `${resource} not found` } }
+}
+
+export function Conflict(message: string): ApiError {
+    return { success: false, error: { code: "CONFLICT", message } }
+}
+
+export function InternalError(message = "Internal server error", details?: unknown): ApiError {
+    return { success: false, error: { code: "INTERNAL_ERROR", message, details } }
+}
+
+interface CustomErrorParams {
+    code: string
+    message: string
+    details?: unknown
+}
+export function CustomError({ code, message, details }: CustomErrorParams): ApiError {
+    return {
+        success: false,
+        error: {
+            code,
+            message,
+            details,
+        },
+    }
+}

package/src/core/response.ts

@@ -0,0 +1,17 @@
+export type ApiSuccess<T> = {
+    success:true,
+    data:T,
+    message?:string,
+    meta?: Record<string, unknown>
+}
+
+export type ApiError = {
+    success:false,
+    error:{
+        code:string,
+        message:string,
+        details?:unknown
+    }
+}
+
+export type ApiResponse<T> = ApiSuccess<T> | ApiError

package/src/core/status-map.ts

@@ -0,0 +1,11 @@
+export const statusMap: Record<string, number> = {
+    Ok: 200,
+    Created: 201,
+    NoContent: 204,
+    BadRequest: 400,
+    Unauthorized: 401,
+    Forbidden: 403,
+    NotFound: 404,
+    Conflict: 409,
+    InternalError: 500,
+}

package/src/core/success.ts

@@ -0,0 +1,21 @@
+import {ApiSuccess} from "./response";
+
+export function Ok<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T>{
+    return {success:true, data, message, meta}
+}
+
+export function Created<T>(data: T, message?: string, meta?: Record<string, unknown>): ApiSuccess<T> {
+    return { success: true, data, message, meta }
+}
+
+export function NoContent(message?: string): ApiSuccess<null> {
+    return { success: true, data: null, message }
+}
+
+export function CustomSuccess<T>(
+    data: T,
+    message?: string,
+    meta?: Record<string, unknown>
+): ApiSuccess<T> {
+    return { success: true, data, message, meta }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export type { ApiSuccess, ApiError, ApiResponse } from "./core/response"
+
+export { Ok, Created, NoContent, CustomSuccess } from "./core/success"
+
+export { BadRequest, Unauthorized, Forbidden, NotFound, Conflict, InternalError, CustomError } from "./core/error"
+
+export {sendResponse as ExpressResponse} from "./adapters/express"
+export {sendResponse as FastifyResponse} from "./adapters/fastify"

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import {defineConfig} from "tsup";
+export default defineConfig({
+    entry: [
+        "src/index.ts",
+        "src/adapters/express.ts",
+        "src/adapters/fastify.ts",
+    ],
+    format: ["cjs", "esm"],
+    dts: true,
+    clean: true,
+    sourcemap: true,
+})