@salespark/route-utils 1.0.0

package/README.md

@@ -0,0 +1,217 @@
+# SalesPark Route Utils v1 - Documentation
+
+## @salespark/route-utils
+
+Vendor-agnostic helpers for **Express.js** routes.  
+Provides a unified way to wrap async route handlers, normalize responses, and handle logging without binding to a specific vendor (e.g., Rollbar, Sentry, Console).
+
+By default, if no logger is provided, **no logs are emitted** (silent mode).
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @salespark/route-utils
+# or
+yarn add @salespark/route-utils
+```
+
+Supports both **CommonJS** and **ESM** imports.
+
+```ts
+// ESM
+import { wrapRoute, createResponder, makeRouteUtils, resolveRouteResponse } from "@salespark/route-utils";
+
+// CommonJS
+const { wrapRoute, createResponder, makeRouteUtils, resolveRouteResponse } = require("@salespark/route-utils");
+```
+
+---
+
+## 🚀 Introduction
+
+This utility reduces boilerplate in Express.js routes by enforcing:
+
+- Consistent response shape across all endpoints
+- Safe error handling with `try/catch` wrappers
+- Prevention of double responses (`res.headersSent`)
+- Configurable vendor-agnostic logging (console, Rollbar, Sentry, etc.)
+- Predictable HTTP status codes for both success and error cases
+
+---
+
+## 📐 Response Shape Specification
+
+All route handlers must return an object with the following structure:
+
+```ts
+{
+  status: boolean;             // required: true for success, false for failure
+  data?: any;                  // optional: payload for success or error
+  http?: number;               // optional: explicit HTTP status code
+  headers?: Record<string,any>;// optional: extra HTTP headers to set
+  meta?: any;                  // optional: metadata (e.g., pagination info)
+}
+```
+
+### Status Rules
+
+- ✅ `status: true` → Success
+- ❌ `status: false` → Failure
+- 🚨 Missing `status` → treated as malformed response (`500` with `MissingStatus`)
+
+### Default HTTP Mapping
+
+- Success with data → `200 OK`
+- Success without data (`null`, `undefined`, `""`) → `204 No Content`
+- Failure → `400 Bad Request`
+- Explicit `http` value (100–599) always overrides
+
+---
+
+## 🏗️ Factory: `makeRouteUtils`
+
+```ts
+import { makeRouteUtils } from "@salespark/route-utils";
+
+const { wrapRoute, createResponder, resolveRouteResponse } = makeRouteUtils({
+  logger: console.error, // or rollbar.error, sentry.captureException, etc.
+  tagPrefix: "/routes/producers", // optional prefix for logs
+});
+```
+
+### Parameters
+
+- **`logger`**: `(payload, tag) => void`
+- **`tagPrefix`**: string (optional)
+
+### Returns
+
+- `wrapRoute`
+- `createResponder`
+- `resolveRouteResponse`
+
+---
+
+## ⚡ Functions
+
+### `wrapRoute`
+
+```ts
+router.get(
+  "/achievements",
+  validateAuth,
+  wrapRoute(
+    async (req, res) => {
+      const producerId = res.locals.auth.producer_id;
+      return ops.getProducerAchievements(producerId);
+    },
+    { tag: "GET /achievements" }
+  )
+);
+```
+
+---
+
+### `createResponder`
+
+```ts
+router.get("/achievements", validateAuth, async (req, res) => {
+  const respond = createResponder(res, { tag: "GET /achievements" });
+  await respond(() => ops.getProducerAchievements(res.locals.auth.producer_id));
+});
+```
+
+---
+
+### `resolveRouteResponse`
+
+```ts
+const response = await ops.doSomething();
+if (!resolveRouteResponse(res, response)) {
+  res.status(500).json({ status: false, error: "No response sent" });
+}
+```
+
+---
+
+## 🧪 Usage Examples
+
+### Example 1: Silent Mode (default)
+
+```ts
+app.get(
+  "/ping",
+  wrapRoute(async () => ({ status: true, data: "pong" }))
+);
+```
+
+### Example 2: With Console Logger
+
+```ts
+const { wrapRoute } = makeRouteUtils({
+  logger: (payload, tag) => console.log("[LOG]", tag, payload),
+});
+```
+
+### Example 3: With Rollbar
+
+```ts
+const rollbar = require("./rollbar");
+
+const { wrapRoute } = makeRouteUtils({
+  logger: rollbar.error.bind(rollbar),
+  tagPrefix: "[API] ",
+});
+```
+
+### Example 4: POST with Validation
+
+```ts
+app.post(
+  "/items",
+  wrapRoute(async (req) => {
+    if (!req.body.name) {
+      return { status: false, data: { error: "ValidationError", message: "Name required" }, http: 422 };
+    }
+    return { status: true, data: { id: 1, name: req.body.name }, http: 201 };
+  })
+);
+```
+
+### Example 5: Using Sentry
+
+```ts
+import * as Sentry from "@sentry/node";
+
+Sentry.init({ dsn: process.env.SENTRY_DSN });
+
+const { wrapRoute } = makeRouteUtils({
+  logger: (payload, tag) => {
+    Sentry.captureException(payload instanceof Error ? payload : new Error(JSON.stringify(payload)));
+  },
+});
+```
+
+---
+
+## 📦 NPM Package
+
+This module is published as:  
+👉 [`@salespark/route-utils`](https://www.npmjs.com/package/@salespark/route-utils)
+
+```bash
+npm install @salespark/route-utils
+```
+
+---
+
+## 📄 License
+
+MIT © [SalesPark](https://salespark.io)
+
+---
+
+_Document version: 1_  
+_Last update: 16-08-2025_

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+/****************************************************************************************************************
+ * ##: Route Utils (TypeScript)
+ * Vendor-agnostic helpers for Express-like route handlers.
+ *
+ * What you get:
+ *  - Normalized responses: { status:boolean, data?, http?, headers?, meta? }
+ *  - Safe guards against double responses (res.headersSent)
+ *  - No vendor lock-in for logging (optional logger function, silent by default)
+ *  - Two ergonomics:
+ *      a) wrapRoute(handler, { tag?, logger? }) -> middleware
+ *      b) createResponder(res, { tag?, logger? }) -> in-route responder
+ *  - Core primitive: resolveRouteResponse(res, response) -> boolean
+ *
+ * Logging:
+ *  - Provide a function logger(payload, tag?) if you want logs (e.g. rollbar.error.bind(rollbar))
+ *  - If omitted, nothing is logged (silent mode)
+ *
+ * History:
+ * 16-08-2025: Initial version
+ ****************************************************************************************************************/
+export type LoggerFn = (payload: unknown, tag?: unknown) => void;
+/**
+ * Minimal response interface to avoid a hard dependency on Express types.
+ * Any Express-like object with these methods/properties is supported.
+ */
+export interface ResLike {
+    status: (code: number) => ResLike;
+    json: (body?: unknown) => ResLike;
+    send: (body?: unknown) => ResLike;
+    setHeader?: (name: string, value: string) => void;
+    headersSent?: boolean;
+    [key: string]: any;
+}
+/**
+ * Normalized API response contract used throughout the utilities.
+ * - `status` is mandatory and must be boolean.
+ * - `http` is optional and, when valid, overrides default status code mapping.
+ * - `headers` are optional additional response headers to apply.
+ */
+export interface ApiResponse<T = unknown, M = unknown> {
+    status: boolean;
+    data?: T;
+    http?: number;
+    headers?: Record<string, string>;
+    meta?: M;
+}
+/****************************************************************************************************************
+ * ##: Factory
+ * makeRouteUtils({ logger?, tagPrefix? })
+ *
+ * Creates helpers bound to provided defaults, so you can avoid passing the same logger/tag repeatedly.
+ *
+ * @param logger    Optional function `(payload, tag?) => void`. If omitted, no logs are emitted.
+ * @param tagPrefix Optional prefix applied to all generated tags (e.g., a file or module path).
+ *
+ * @returns { wrapRoute, createResponder, resolveRouteResponse }
+ * History:
+ * 16-08-2025: Created
+ ****************************************************************************************************************/
+export declare const makeRouteUtils: ({ logger, tagPrefix, }?: {
+    logger?: LoggerFn | undefined;
+    tagPrefix?: string | undefined;
+}) => {
+    wrapRoute: (handler: (req: any, res: ResLike) => Promise<ApiResponse> | ApiResponse, options?: {
+        tag?: string | undefined;
+        logger?: LoggerFn | undefined;
+    }) => (req: any, res: ResLike, _next?: any) => Promise<void>;
+    createResponder: (res: ResLike, options?: {
+        tag?: string | undefined;
+        logger?: LoggerFn | undefined;
+    }) => (workFn: () => Promise<ApiResponse> | ApiResponse) => Promise<boolean>;
+    resolveRouteResponse: (res: ResLike, response: any) => boolean;
+};
+/****************************************************************************************************************
+ * ##: Core Primitive - Resolve Route Response
+ * resolveRouteResponse(res, response) => boolean
+ *
+ * Normalizes and sends the HTTP response based on the ApiResponse contract:
+ *   - Validates the `res` object
+ *   - Prevents double responses (`headersSent`)
+ *   - Applies optional headers
+ *   - Chooses HTTP status code (custom `http` if valid; else 200/204/400 defaults)
+ *   - Serializes success/error shapes predictably
+ *
+ * @param res       Express-like response object
+ * @param response  Expected ApiResponse (must include boolean `status`)
+ * @returns         true if a response was sent; false if `res` looked invalid (no send)
+ * History:
+ * 16-08-2025: Created
+ ****************************************************************************************************************/
+export declare const resolveRouteResponse: (res: ResLike, response: any) => boolean;
+export declare const wrapRoute: (handler: (req: any, res: ResLike) => Promise<ApiResponse> | ApiResponse, options?: {
+    tag?: string | undefined;
+    logger?: LoggerFn | undefined;
+}) => (req: any, res: ResLike, _next?: any) => Promise<void>;
+export declare const createResponder: (res: ResLike, options?: {
+    tag?: string | undefined;
+    logger?: LoggerFn | undefined;
+}) => (workFn: () => Promise<ApiResponse> | ApiResponse) => Promise<boolean>;
+/** Default export bundle (optional convenience) */
+declare const _default: {
+    makeRouteUtils: ({ logger, tagPrefix, }?: {
+        logger?: LoggerFn | undefined;
+        tagPrefix?: string | undefined;
+    }) => {
+        wrapRoute: (handler: (req: any, res: ResLike) => ApiResponse<unknown, unknown> | Promise<ApiResponse<unknown, unknown>>, options?: {
+            tag?: string | undefined;
+            logger?: LoggerFn | undefined;
+        }) => (req: any, res: ResLike, _next?: any) => Promise<void>;
+        createResponder: (res: ResLike, options?: {
+            tag?: string | undefined;
+            logger?: LoggerFn | undefined;
+        }) => (workFn: () => ApiResponse<unknown, unknown> | Promise<ApiResponse<unknown, unknown>>) => Promise<boolean>;
+        resolveRouteResponse: (res: ResLike, response: any) => boolean;
+    };
+    wrapRoute: (handler: (req: any, res: ResLike) => ApiResponse<unknown, unknown> | Promise<ApiResponse<unknown, unknown>>, options?: {
+        tag?: string | undefined;
+        logger?: LoggerFn | undefined;
+    }) => (req: any, res: ResLike, _next?: any) => Promise<void>;
+    createResponder: (res: ResLike, options?: {
+        tag?: string | undefined;
+        logger?: LoggerFn | undefined;
+    }) => (workFn: () => ApiResponse<unknown, unknown> | Promise<ApiResponse<unknown, unknown>>) => Promise<boolean>;
+    resolveRouteResponse: (res: ResLike, response: any) => boolean;
+};
+export default _default;
+//# 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;;;;;;;;;;;;;;;;;;;kHAmBkH;AAElH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAClC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAKD;;;;;;;;;;;;kHAYkH;AAClH,eAAO,MAAM,cAAc;;;;+BAoBS,GAAG,OAAO,OAAO,KAAK,QAAQ,WAAW,CAAC,GAAG,WAAW;;;gBAGrE,GAAG,OAAO,OAAO,UAAU,GAAG;2BAuCrB,OAAO;;;mBAIb,MAAM,QAAQ,WAAW,CAAC,GAAG,WAAW;gCA4CxB,OAAO,YAAY,GAAG,KAAG,OAAO;CAnBzE,CAAC;AAEF;;;;;;;;;;;;;;;;kHAgBkH;AAClH,eAAO,MAAM,oBAAoB,QAAS,OAAO,YAAY,GAAG,KAAG,OAiFlE,CAAC;AAOF,eAAO,MAAM,SAAS,kBAlLc,GAAG,OAAO,OAAO,KAAK,QAAQ,WAAW,CAAC,GAAG,WAAW;;;YAGrE,GAAG,OAAO,OAAO,UAAU,GAAG,kBA+KZ,CAAC;AAC1C,eAAO,MAAM,eAAe,QAzII,OAAO;;;eAIb,MAAM,QAAQ,WAAW,CAAC,GAAG,WAAW,qBAqIb,CAAC;AAEtD,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;AACnD,wBAKE"}

package/dist/index.js

@@ -0,0 +1,232 @@
+"use strict";
+/****************************************************************************************************************
+ * ##: Route Utils (TypeScript)
+ * Vendor-agnostic helpers for Express-like route handlers.
+ *
+ * What you get:
+ *  - Normalized responses: { status:boolean, data?, http?, headers?, meta? }
+ *  - Safe guards against double responses (res.headersSent)
+ *  - No vendor lock-in for logging (optional logger function, silent by default)
+ *  - Two ergonomics:
+ *      a) wrapRoute(handler, { tag?, logger? }) -> middleware
+ *      b) createResponder(res, { tag?, logger? }) -> in-route responder
+ *  - Core primitive: resolveRouteResponse(res, response) -> boolean
+ *
+ * Logging:
+ *  - Provide a function logger(payload, tag?) if you want logs (e.g. rollbar.error.bind(rollbar))
+ *  - If omitted, nothing is logged (silent mode)
+ *
+ * History:
+ * 16-08-2025: Initial version
+ ****************************************************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createResponder = exports.wrapRoute = exports.resolveRouteResponse = exports.makeRouteUtils = void 0;
+/** No-op logger (silent). Used when no logger function is provided. */
+const noopLogger = () => { };
+/****************************************************************************************************************
+ * ##: Factory
+ * makeRouteUtils({ logger?, tagPrefix? })
+ *
+ * Creates helpers bound to provided defaults, so you can avoid passing the same logger/tag repeatedly.
+ *
+ * @param logger    Optional function `(payload, tag?) => void`. If omitted, no logs are emitted.
+ * @param tagPrefix Optional prefix applied to all generated tags (e.g., a file or module path).
+ *
+ * @returns { wrapRoute, createResponder, resolveRouteResponse }
+ * History:
+ * 16-08-2025: Created
+ ****************************************************************************************************************/
+const makeRouteUtils = ({ logger = noopLogger, tagPrefix = "", } = {}) => {
+    /****************************************************************************************************************
+     * ##: wrapRoute(handler, options?)
+     * Express-style middleware wrapper:
+     *  - Executes your async handler and expects an ApiResponse
+     *  - Uses resolveRouteResponse to send output
+     *  - Catches and logs unexpected shapes/errors (only if a logger is provided)
+     *
+     * @param handler  Async route handler: (req, res) => ApiResponse | Promise<ApiResponse>
+     * @param options  { tag?: string; logger?: LoggerFn }
+     * @returns        (req, res, next) => Promise<void>
+     * History:
+     * 16-08-2025: Created
+     ****************************************************************************************************************/
+    const wrapRoute = (handler, options = {}) => {
+        const routeLogger = typeof options.logger === "function" ? options.logger : logger;
+        return async (req, res, _next) => {
+            // Build a tag for logging; default to METHOD + originalUrl
+            const baseTag = options.tag || `${req?.method ?? "?"} ${req?.originalUrl ?? "?"}`;
+            const tag = tagPrefix ? `${tagPrefix}${baseTag}` : baseTag;
+            try {
+                const response = await handler(req, res);
+                if ((0, exports.resolveRouteResponse)(res, response))
+                    return; // Early exit: a response has been sent
+                // If we got here, the handler returned an unexpected shape
+                routeLogger({ message: "Unexpected response shape", response, route: tag }, tag);
+                if (!res.headersSent) {
+                    res.status(500).json({ status: false, error: "UnexpectedResponseShape" });
+                }
+            }
+            catch (err) {
+                // Unhandled error in the handler
+                routeLogger(err, `${tag}/catch`);
+                if (!res.headersSent) {
+                    res.status(500).json({ status: false, error: err?.message || "Unexpected error" });
+                }
+            }
+        };
+    };
+    /****************************************************************************************************************
+     * ##: createResponder(res, options?)
+     * In-route responder:
+     *  - Lets you keep the route signature untouched
+     *  - You call it with a work function returning an ApiResponse
+     *  - Ensures normalized output and consistent error handling
+     *
+     * @param res      Express-like response object
+     * @param options  { tag?: string; logger?: LoggerFn }
+     * @returns        (workFn) => Promise<true>
+     * History:
+     * 16-08-2025: Created
+     ****************************************************************************************************************/
+    const createResponder = (res, options = {}) => {
+        const tagBase = options.tag;
+        const routeLogger = typeof options.logger === "function" ? options.logger : logger;
+        return async (workFn) => {
+            try {
+                const response = await workFn();
+                if ((0, exports.resolveRouteResponse)(res, response))
+                    return true; // Responded successfully
+                // Unexpected shape
+                routeLogger({ message: "Unexpected response shape", response }, tagBase || "createResponder");
+                if (!res.headersSent) {
+                    res.status(500).json({ status: false, error: "UnexpectedResponseShape" });
+                }
+                return true;
+            }
+            catch (error) {
+                // Unhandled error inside workFn
+                routeLogger(error, `${tagBase || "createResponder"}/catch`);
+                if (!res.headersSent) {
+                    res.status(500).json({ status: false, error: error?.message || "Unexpected error" });
+                }
+                return true;
+            }
+        };
+    };
+    return { wrapRoute, createResponder, resolveRouteResponse: exports.resolveRouteResponse };
+};
+exports.makeRouteUtils = makeRouteUtils;
+/****************************************************************************************************************
+ * ##: Core Primitive - Resolve Route Response
+ * resolveRouteResponse(res, response) => boolean
+ *
+ * Normalizes and sends the HTTP response based on the ApiResponse contract:
+ *   - Validates the `res` object
+ *   - Prevents double responses (`headersSent`)
+ *   - Applies optional headers
+ *   - Chooses HTTP status code (custom `http` if valid; else 200/204/400 defaults)
+ *   - Serializes success/error shapes predictably
+ *
+ * @param res       Express-like response object
+ * @param response  Expected ApiResponse (must include boolean `status`)
+ * @returns         true if a response was sent; false if `res` looked invalid (no send)
+ * History:
+ * 16-08-2025: Created
+ ****************************************************************************************************************/
+const resolveRouteResponse = (res, response) => {
+    try {
+        // Guard: ensure `res` looks like a valid Express-like response object
+        if (!res || typeof res.status !== "function" || typeof res.send !== "function")
+            return false;
+        // Prevent double responses
+        if (res.headersSent)
+            return true;
+        // Validate presence of `status`
+        const hasStatus = response && typeof response === "object" && Object.prototype.hasOwnProperty.call(response, "status");
+        if (!hasStatus) {
+            res.status(500).json({ status: false, error: "MissingStatus", message: "Missing `status` on response object" });
+            return true;
+        }
+        const isOk = response.status === true;
+        const isFail = response.status === false;
+        // Compute HTTP code:
+        //  - If a valid custom `http` is provided (100–599), use it.
+        //  - Otherwise:
+        //    - Success with undefined/null/empty-string data => 204
+        //    - Success with data => 200
+        //    - Failure => 400
+        const explicit = Number.isInteger(response?.http) && response.http >= 100 && response.http <= 599;
+        const http = explicit ? response.http : isOk ? (response.data === undefined || response.data === null || response.data === "" ? 204 : 200) : 400;
+        // Apply optional headers
+        if (response?.headers && typeof response.headers === "object") {
+            for (const [k, v] of Object.entries(response.headers)) {
+                try {
+                    res.setHeader?.(k, String(v));
+                }
+                catch {
+                    /* ignore header errors */
+                }
+            }
+        }
+        // Success path
+        if (isOk) {
+            if (http === 204) {
+                res.status(http).send();
+            }
+            else {
+                const out = { status: true };
+                if (response.data !== undefined)
+                    out.data = response.data;
+                if (response.meta !== undefined)
+                    out.meta = response.meta;
+                res.status(http).json(out);
+            }
+            return true;
+        }
+        // Error path
+        if (isFail) {
+            const raw = response.data;
+            const errBody = raw instanceof Error
+                ? { error: raw.name || "Error", message: raw.message }
+                : raw && typeof raw === "object"
+                    ? {
+                        ...(raw.error ? { error: raw.error } : {}),
+                        ...(raw.message ? { message: raw.message } : {}),
+                    }
+                    : { error: "RequestFailed", message: typeof raw === "string" ? raw : "Request failed" };
+            res.status(http).json({ status: false, ...errBody, ...(response.meta !== undefined ? { meta: response.meta } : {}) });
+            return true;
+        }
+        // Fallback: `status` is neither true nor false
+        res.status(500).json({ status: false, error: "InvalidStatusField", message: "`status` must be boolean" });
+        return true;
+    }
+    catch (error) {
+        // Absolute last resort: catch unexpected errors inside the responder
+        try {
+            if (!res.headersSent)
+                res.status(500).json({ status: false, error: "UnhandledResponderError", message: error?.message || "Unexpected error" });
+            return true;
+        }
+        catch {
+            // If even this fails, we assume there's nothing else we can safely do
+            return true;
+        }
+    }
+};
+exports.resolveRouteResponse = resolveRouteResponse;
+/****************************************************************************************************************
+ * Pre-bound (silent) helpers
+ * These export a default, no-logger configuration so consumers can import directly without a factory.
+ ****************************************************************************************************************/
+const silent = (0, exports.makeRouteUtils)(); // logger: noop (silent)
+exports.wrapRoute = silent.wrapRoute;
+exports.createResponder = silent.createResponder;
+/** Default export bundle (optional convenience) */
+exports.default = {
+    makeRouteUtils: exports.makeRouteUtils,
+    wrapRoute: exports.wrapRoute,
+    createResponder: exports.createResponder,
+    resolveRouteResponse: exports.resolveRouteResponse,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@salespark/route-utils",
+  "version": "1.0.0",
+  "description": "Vendor-agnostic helpers for Express route handlers with normalized responses and optional logging.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "yarn run clean && yarn run build"
+  },
+  "keywords": [
+    "express",
+    "middleware",
+    "http",
+    "routes",
+    "api",
+    "response",
+    "logger",
+    "salespark"
+  ],
+  "author": "SalesPark",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/salespark/route-utils.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/express": "^4.17.21"
+  },
+  "peerDependencies": {
+    "express": ">=4"
+  }
+}