@catbee/utils
Version:
A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications (including Express-based services). All utilities are tree-shakable and can be imported independently.
312 lines • 15.9 kB
JavaScript
/* eslint-disable @typescript-eslint/no-unused-vars */
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
return new (P || (P = Promise))(function (resolve, reject) {
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
step((generator = generator.apply(thisArg, _arguments || [])).next());
});
};
var __generator = (this && this.__generator) || function (thisArg, body) {
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
function verb(n) { return function (v) { return step([n, v]); }; }
function step(op) {
if (f) throw new TypeError("Generator is already executing.");
while (g && (g = 0, op[0] && (_ = 0)), _) try {
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
if (y = 0, t) op = [op[0] & 2, t.value];
switch (op[0]) {
case 0: case 1: t = op; break;
case 4: _.label++; return { value: op[1], done: false };
case 5: _.label++; y = op[1]; op = [0]; continue;
case 7: op = _.ops.pop(); _.trys.pop(); continue;
default:
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
if (t[2]) _.ops.pop();
_.trys.pop(); continue;
}
op = body.call(thisArg, _);
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
}
};
var __read = (this && this.__read) || function (o, n) {
var m = typeof Symbol === "function" && o[Symbol.iterator];
if (!m) return o;
var i = m.call(o), r, ar = [], e;
try {
while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
}
catch (error) { e = { error: error }; }
finally {
try {
if (r && !r.done && (m = i["return"])) m.call(i);
}
finally { if (e) throw e.error; }
}
return ar;
};
var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
if (ar || !(i in from)) {
if (!ar) ar = Array.prototype.slice.call(from, 0, i);
ar[i] = from[i];
}
}
return to.concat(ar || Array.prototype.slice.call(from));
};
var __values = (this && this.__values) || function(o) {
var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
if (m) return m.call(o);
if (o && typeof o.length === "number") return {
next: function () {
if (o && i >= o.length) o = void 0;
return { value: o && o[i++], done: !o };
}
};
throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
};
import "reflect-metadata";
// --- End sample Express interfaces ---
var ROUTES_KEY = Symbol("routes");
var MIDDLEWARE_KEY = Symbol("middlewares");
var PARAMS_KEY = Symbol("params");
// ---- Route Decorators ----
function createRouteDecorator(method) {
return function (path) {
return function (target, propertyKey, descriptor) {
var routes = Reflect.getMetadata(ROUTES_KEY, target.constructor) || [];
routes.push({
path: path,
method: method,
handlerName: propertyKey,
});
Reflect.defineMetadata(ROUTES_KEY, routes, target.constructor);
};
};
}
export var Get = createRouteDecorator("get");
export var Post = createRouteDecorator("post");
export var Put = createRouteDecorator("put");
export var Patch = createRouteDecorator("patch");
export var Delete = createRouteDecorator("delete");
export var Options = createRouteDecorator("options");
export var Head = createRouteDecorator("head");
export var Trace = createRouteDecorator("trace");
export var Connect = createRouteDecorator("connect");
// ---- Controller Decorator ----
export function Controller(basePath) {
return function (target) {
Reflect.defineMetadata("basePath", basePath, target);
};
}
// ---- Middleware Decorator ----
export function Use() {
var middlewares = [];
for (var _i = 0; _i < arguments.length; _i++) {
middlewares[_i] = arguments[_i];
}
return function (target, propertyKey, descriptor) {
var existing = Reflect.getMetadata(MIDDLEWARE_KEY, target, propertyKey) || [];
Reflect.defineMetadata(MIDDLEWARE_KEY, __spreadArray(__spreadArray([], __read(existing), false), __read(middlewares), false), target, propertyKey);
};
}
// ---- Parameter Decorators ----
function createParamDecorator(type, key) {
return function (paramKey) {
return function (target, propertyKey, parameterIndex) {
var params = Reflect.getMetadata(PARAMS_KEY, target, propertyKey) || [];
// Ensure parameters are ordered by index
params.push({ index: parameterIndex, type: type, key: paramKey || key });
params.sort(function (a, b) { return a.index - b.index; });
Reflect.defineMetadata(PARAMS_KEY, params, target, propertyKey);
};
};
}
export var Query = createParamDecorator("query");
export var Param = createParamDecorator("param");
export var Body = createParamDecorator("body");
export var Req = createParamDecorator("req");
export var Res = createParamDecorator("res");
// Custom HTTP status code decorator
var HTTP_CODE_KEY = Symbol("httpCode");
export function HttpCode(status) {
return function (target, propertyKey, descriptor) {
Reflect.defineMetadata(HTTP_CODE_KEY, status, target, propertyKey);
};
}
// Custom header decorator
var HEADER_KEY = Symbol("headers");
export function Header(name, value) {
return function (target, propertyKey, descriptor) {
var headers = Reflect.getMetadata(HEADER_KEY, target, propertyKey) || {};
headers[name] = value;
Reflect.defineMetadata(HEADER_KEY, headers, target, propertyKey);
};
}
// Before/After hooks (not Express middleware, but can be used for logging, etc.)
var BEFORE_KEY = Symbol("before");
var AFTER_KEY = Symbol("after");
export function Before(fn) {
return function (target, propertyKey, descriptor) {
var hooks = Reflect.getMetadata(BEFORE_KEY, target, propertyKey) || [];
hooks.push(fn);
Reflect.defineMetadata(BEFORE_KEY, hooks, target, propertyKey);
};
}
export function After(fn) {
return function (target, propertyKey, descriptor) {
var hooks = Reflect.getMetadata(AFTER_KEY, target, propertyKey) || [];
hooks.push(fn);
Reflect.defineMetadata(AFTER_KEY, hooks, target, propertyKey);
};
}
// ---- Register Controllers ----
export function registerControllers(router, controllers) {
var _this = this;
controllers.forEach(function (ControllerClass) {
var instance = new ControllerClass();
var basePath = Reflect.getMetadata("basePath", ControllerClass) || "";
var routes = Reflect.getMetadata(ROUTES_KEY, ControllerClass) || [];
routes.forEach(function (_a) {
var _b;
var path = _a.path, method = _a.method, handlerName = _a.handlerName;
var middlewares = Reflect.getMetadata(MIDDLEWARE_KEY, instance, handlerName) || [];
var params = Reflect.getMetadata(PARAMS_KEY, instance, handlerName) || [];
var httpCode = Reflect.getMetadata(HTTP_CODE_KEY, instance, handlerName);
var headers = Reflect.getMetadata(HEADER_KEY, instance, handlerName) || {};
var beforeHooks = Reflect.getMetadata(BEFORE_KEY, instance, handlerName) || [];
var afterHooks = Reflect.getMetadata(AFTER_KEY, instance, handlerName) || [];
var handler = function (req, res, next) { return __awaiter(_this, void 0, void 0, function () {
var beforeHooks_1, beforeHooks_1_1, fn, e_1_1, args_1, result, awaited, _a, _b, _c, _d, k, v, afterHooks_1, afterHooks_1_1, fn, e_2_1, err_1;
var e_1, _e, _f, e_3, _g, e_2, _h;
var _j, _k;
return __generator(this, function (_l) {
switch (_l.label) {
case 0:
_l.trys.push([0, 20, , 21]);
_l.label = 1;
case 1:
_l.trys.push([1, 6, 7, 8]);
beforeHooks_1 = __values(beforeHooks), beforeHooks_1_1 = beforeHooks_1.next();
_l.label = 2;
case 2:
if (!!beforeHooks_1_1.done) return [3 /*break*/, 5];
fn = beforeHooks_1_1.value;
return [4 /*yield*/, fn(req, res)];
case 3:
_l.sent();
_l.label = 4;
case 4:
beforeHooks_1_1 = beforeHooks_1.next();
return [3 /*break*/, 2];
case 5: return [3 /*break*/, 8];
case 6:
e_1_1 = _l.sent();
e_1 = { error: e_1_1 };
return [3 /*break*/, 8];
case 7:
try {
if (beforeHooks_1_1 && !beforeHooks_1_1.done && (_e = beforeHooks_1.return)) _e.call(beforeHooks_1);
}
finally { if (e_1) throw e_1.error; }
return [7 /*endfinally*/];
case 8:
args_1 = [];
if (params.length) {
params.forEach(function (_a) {
var _b;
var index = _a.index, type = _a.type, key = _a.key;
switch (type) {
case "query":
args_1[index] = key ? req.query[key] : req.query;
break;
case "param":
args_1[index] = key ? req.params[key] : req.params;
break;
case "body":
args_1[index] = key ? (_b = req.body) === null || _b === void 0 ? void 0 : _b[key] : req.body;
break;
case "req":
args_1[index] = req;
break;
case "res":
args_1[index] = res;
break;
}
});
}
result = (_f = instance)[handlerName].apply(_f, __spreadArray([], __read(args_1), false));
if (!(result instanceof Promise)) return [3 /*break*/, 10];
return [4 /*yield*/, result];
case 9:
_a = _l.sent();
return [3 /*break*/, 11];
case 10:
_a = result;
_l.label = 11;
case 11:
awaited = _a;
if (!res.headersSent && typeof awaited !== "undefined") {
if (httpCode)
(_j = res.status) === null || _j === void 0 ? void 0 : _j.call(res, httpCode);
try {
for (_b = __values(Object.entries(headers)), _c = _b.next(); !_c.done; _c = _b.next()) {
_d = __read(_c.value, 2), k = _d[0], v = _d[1];
(_k = res.set) === null || _k === void 0 ? void 0 : _k.call(res, k, v);
}
}
catch (e_3_1) { e_3 = { error: e_3_1 }; }
finally {
try {
if (_c && !_c.done && (_g = _b.return)) _g.call(_b);
}
finally { if (e_3) throw e_3.error; }
}
res.json(awaited);
}
_l.label = 12;
case 12:
_l.trys.push([12, 17, 18, 19]);
afterHooks_1 = __values(afterHooks), afterHooks_1_1 = afterHooks_1.next();
_l.label = 13;
case 13:
if (!!afterHooks_1_1.done) return [3 /*break*/, 16];
fn = afterHooks_1_1.value;
return [4 /*yield*/, fn(req, res, awaited)];
case 14:
_l.sent();
_l.label = 15;
case 15:
afterHooks_1_1 = afterHooks_1.next();
return [3 /*break*/, 13];
case 16: return [3 /*break*/, 19];
case 17:
e_2_1 = _l.sent();
e_2 = { error: e_2_1 };
return [3 /*break*/, 19];
case 18:
try {
if (afterHooks_1_1 && !afterHooks_1_1.done && (_h = afterHooks_1.return)) _h.call(afterHooks_1);
}
finally { if (e_2) throw e_2.error; }
return [7 /*endfinally*/];
case 19: return [3 /*break*/, 21];
case 20:
err_1 = _l.sent();
next(err_1);
return [3 /*break*/, 21];
case 21: return [2 /*return*/];
}
});
}); };
(_b = router)[method].apply(_b, __spreadArray(__spreadArray([basePath + path], __read(middlewares), false), [handler], false));
});
});
}
//# sourceMappingURL=decorators.utils.js.map