@technomoron/api-server-base 1.1.5 → 1.1.6

package/dist/cjs/api-server-base.cjs

@@ -325,7 +325,7 @@ function fillConfig(config) {
         accessCookie: config.accessCookie ?? 'dat',
         refreshCookie: config.refreshCookie ?? 'drt',
         accessExpiry: config.accessExpiry ?? 60 * 15,
-        refreshExpiry: config.refreshExpiry ?? 30 * 24 * 60 * 60 * 1000,
+        refreshExpiry: config.refreshExpiry ?? 30 * 24 * 60 * 60,
         authApi: config.authApi ?? false,
         devMode: config.devMode ?? false,
         hydrateGetBody: config.hydrateGetBody ?? true,
@@ -628,18 +628,18 @@ class ApiServer {
     handle_request(handler, auth) {
         return async (req, res, next) => {
             void next;
+            const apiReq = {
+                server: this,
+                req,
+                res,
+                token: '',
+                tokenData: null,
+                getClientInfo: () => ensureClientInfo(apiReq),
+                getClientIp: () => ensureClientInfo(apiReq).ip,
+                getClientIpChain: () => ensureClientInfo(apiReq).ipchain
+            };
+            this.currReq = apiReq;
             try {
-                const apiReq = {
-                    server: this,
-                    req,
-                    res,
-                    token: '',
-                    tokenData: null,
-                    getClientInfo: () => ensureClientInfo(apiReq),
-                    getClientIp: () => ensureClientInfo(apiReq).ip,
-                    getClientIpChain: () => ensureClientInfo(apiReq).ipchain
-                };
-                this.currReq = apiReq;
                 if (this.config.hydrateGetBody) {
                     hydrateGetBody(apiReq.req);
                 }
@@ -660,7 +660,11 @@ class ApiServer {
                     throw new ApiError({ code: 500, message: 'Handler result must start with a numeric status code' });
                 }
                 const message = typeof rawMessage === 'string' ? rawMessage : 'Success';
-                res.status(code).json({ code, message, data });
+                const responsePayload = { code, message, data };
+                if (this.config.debug) {
+                    this.dumpResponse(apiReq, responsePayload, code);
+                }
+                res.status(code).json(responsePayload);
             }
             catch (error) {
                 if (error instanceof ApiError || isApiErrorLike(error)) {
@@ -668,20 +672,28 @@ class ApiServer {
                     const normalizedErrors = apiError.errors && typeof apiError.errors === 'object' && !Array.isArray(apiError.errors)
                         ? apiError.errors
                         : {};
-                    res.status(apiError.code).json({
+                    const errorPayload = {
                         code: apiError.code,
                         message: apiError.message,
                         data: apiError.data ?? null,
                         errors: normalizedErrors
-                    });
+                    };
+                    if (this.config.debug) {
+                        this.dumpResponse(apiReq, errorPayload, apiError.code);
+                    }
+                    res.status(apiError.code).json(errorPayload);
                 }
                 else {
-                    res.status(500).json({
+                    const errorPayload = {
                         code: 500,
                         message: this.guessExceptionText(error),
                         data: null,
                         errors: {}
-                    });
+                    };
+                    if (this.config.debug) {
+                        this.dumpResponse(apiReq, errorPayload, 500);
+                    }
+                    res.status(500).json(errorPayload);
                 }
             }
         };
@@ -719,6 +731,59 @@ class ApiServer {
         console.log('Headers:', req.headers);
         console.log('------------------------');
     }
+    formatDebugValue(value, maxLength = 50, seen = new WeakSet()) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            return value.length <= maxLength
+                ? value
+                : `${value.slice(0, maxLength)}… [truncated ${value.length - maxLength} chars]`;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+            return value;
+        }
+        if (typeof value === 'symbol') {
+            return value.toString();
+        }
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value)) {
+            return `<Buffer length=${value.length}>`;
+        }
+        if (typeof value === 'function') {
+            return `[Function ${value.name || 'anonymous'}]`;
+        }
+        if (typeof value === 'object') {
+            const obj = value;
+            if (seen.has(obj)) {
+                return '[Circular]';
+            }
+            seen.add(obj);
+            if (Array.isArray(value)) {
+                const arr = value.map((item) => this.formatDebugValue(item, maxLength, seen));
+                seen.delete(obj);
+                return arr;
+            }
+            const recordValue = value;
+            const entries = Object.entries(recordValue).reduce((acc, [key, val]) => {
+                acc[key] = this.formatDebugValue(val, maxLength, seen);
+                return acc;
+            }, {});
+            seen.delete(obj);
+            return entries;
+        }
+        return value;
+    }
+    dumpResponse(apiReq, payload, status) {
+        const url = apiReq.req.originalUrl || apiReq.req.url;
+        console.log('--- Outgoing Response! ---');
+        console.log('URL:', url);
+        console.log('Status:', status);
+        console.log('Payload:', this.formatDebugValue(payload));
+        console.log('--------------------------');
+    }
 }
 exports.ApiServer = ApiServer;
 exports.default = ApiServer;

package/dist/cjs/api-server-base.d.ts

@@ -9,7 +9,7 @@ import jwt, { JwtPayload, SignOptions, VerifyOptions } from 'jsonwebtoken';
 import { ApiModule } from './api-module.js';
 import type { ApiAuthClass, ApiKey } from './api-module.js';
 import type { AuthProviderModule } from './auth-module.js';
-import type { AuthStorage, AuthTokenData } from './auth-storage.js';
+import type { AuthStorage, AuthTokenData, AuthTokenMetadata } from './auth-storage.js';
 export type { Application, Request, Response, NextFunction, Router } from 'express';
 export type { Multer } from 'multer';
 export type { JwtPayload, SignOptions, VerifyOptions } from 'jsonwebtoken';
@@ -35,7 +35,7 @@ interface JwtDecodeResult<T> {
     data?: T;
     error?: string;
 }
-export interface ApiTokenData extends JwtPayload {
+export interface ApiTokenData extends JwtPayload, AuthTokenMetadata {
     uid: unknown;
     iat?: number;
     exp?: number;
@@ -144,5 +144,7 @@ export declare class ApiServer {
     private handle_request;
     api<T extends ApiModule<any>>(module: T): this;
     dumpRequest(apiReq: ApiRequest): void;
+    private formatDebugValue;
+    dumpResponse(apiReq: ApiRequest, payload: unknown, status: number): void;
 }
 export default ApiServer;

package/dist/cjs/auth-storage.d.ts

@@ -9,6 +9,7 @@ export interface AuthTokenMetadata {
     ip?: string;
     os?: string;
     scope?: string | string[];
+    loginType?: string;
     revokeSessions?: 'device' | 'domain' | 'client' | 'user';
 }
 export interface AuthTokenData extends AuthTokenMetadata {

package/dist/esm/api-server-base.d.ts

@@ -9,7 +9,7 @@ import jwt, { JwtPayload, SignOptions, VerifyOptions } from 'jsonwebtoken';
 import { ApiModule } from './api-module.js';
 import type { ApiAuthClass, ApiKey } from './api-module.js';
 import type { AuthProviderModule } from './auth-module.js';
-import type { AuthStorage, AuthTokenData } from './auth-storage.js';
+import type { AuthStorage, AuthTokenData, AuthTokenMetadata } from './auth-storage.js';
 export type { Application, Request, Response, NextFunction, Router } from 'express';
 export type { Multer } from 'multer';
 export type { JwtPayload, SignOptions, VerifyOptions } from 'jsonwebtoken';
@@ -35,7 +35,7 @@ interface JwtDecodeResult<T> {
     data?: T;
     error?: string;
 }
-export interface ApiTokenData extends JwtPayload {
+export interface ApiTokenData extends JwtPayload, AuthTokenMetadata {
     uid: unknown;
     iat?: number;
     exp?: number;
@@ -144,5 +144,7 @@ export declare class ApiServer {
     private handle_request;
     api<T extends ApiModule<any>>(module: T): this;
     dumpRequest(apiReq: ApiRequest): void;
+    private formatDebugValue;
+    dumpResponse(apiReq: ApiRequest, payload: unknown, status: number): void;
 }
 export default ApiServer;

package/dist/esm/api-server-base.js

@@ -317,7 +317,7 @@ function fillConfig(config) {
         accessCookie: config.accessCookie ?? 'dat',
         refreshCookie: config.refreshCookie ?? 'drt',
         accessExpiry: config.accessExpiry ?? 60 * 15,
-        refreshExpiry: config.refreshExpiry ?? 30 * 24 * 60 * 60 * 1000,
+        refreshExpiry: config.refreshExpiry ?? 30 * 24 * 60 * 60,
         authApi: config.authApi ?? false,
         devMode: config.devMode ?? false,
         hydrateGetBody: config.hydrateGetBody ?? true,
@@ -620,18 +620,18 @@ export class ApiServer {
     handle_request(handler, auth) {
         return async (req, res, next) => {
             void next;
+            const apiReq = {
+                server: this,
+                req,
+                res,
+                token: '',
+                tokenData: null,
+                getClientInfo: () => ensureClientInfo(apiReq),
+                getClientIp: () => ensureClientInfo(apiReq).ip,
+                getClientIpChain: () => ensureClientInfo(apiReq).ipchain
+            };
+            this.currReq = apiReq;
             try {
-                const apiReq = {
-                    server: this,
-                    req,
-                    res,
-                    token: '',
-                    tokenData: null,
-                    getClientInfo: () => ensureClientInfo(apiReq),
-                    getClientIp: () => ensureClientInfo(apiReq).ip,
-                    getClientIpChain: () => ensureClientInfo(apiReq).ipchain
-                };
-                this.currReq = apiReq;
                 if (this.config.hydrateGetBody) {
                     hydrateGetBody(apiReq.req);
                 }
@@ -652,7 +652,11 @@ export class ApiServer {
                     throw new ApiError({ code: 500, message: 'Handler result must start with a numeric status code' });
                 }
                 const message = typeof rawMessage === 'string' ? rawMessage : 'Success';
-                res.status(code).json({ code, message, data });
+                const responsePayload = { code, message, data };
+                if (this.config.debug) {
+                    this.dumpResponse(apiReq, responsePayload, code);
+                }
+                res.status(code).json(responsePayload);
             }
             catch (error) {
                 if (error instanceof ApiError || isApiErrorLike(error)) {
@@ -660,20 +664,28 @@ export class ApiServer {
                     const normalizedErrors = apiError.errors && typeof apiError.errors === 'object' && !Array.isArray(apiError.errors)
                         ? apiError.errors
                         : {};
-                    res.status(apiError.code).json({
+                    const errorPayload = {
                         code: apiError.code,
                         message: apiError.message,
                         data: apiError.data ?? null,
                         errors: normalizedErrors
-                    });
+                    };
+                    if (this.config.debug) {
+                        this.dumpResponse(apiReq, errorPayload, apiError.code);
+                    }
+                    res.status(apiError.code).json(errorPayload);
                 }
                 else {
-                    res.status(500).json({
+                    const errorPayload = {
                         code: 500,
                         message: this.guessExceptionText(error),
                         data: null,
                         errors: {}
-                    });
+                    };
+                    if (this.config.debug) {
+                        this.dumpResponse(apiReq, errorPayload, 500);
+                    }
+                    res.status(500).json(errorPayload);
                 }
             }
         };
@@ -711,5 +723,58 @@ export class ApiServer {
         console.log('Headers:', req.headers);
         console.log('------------------------');
     }
+    formatDebugValue(value, maxLength = 50, seen = new WeakSet()) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            return value.length <= maxLength
+                ? value
+                : `${value.slice(0, maxLength)}… [truncated ${value.length - maxLength} chars]`;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+            return value;
+        }
+        if (typeof value === 'symbol') {
+            return value.toString();
+        }
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value)) {
+            return `<Buffer length=${value.length}>`;
+        }
+        if (typeof value === 'function') {
+            return `[Function ${value.name || 'anonymous'}]`;
+        }
+        if (typeof value === 'object') {
+            const obj = value;
+            if (seen.has(obj)) {
+                return '[Circular]';
+            }
+            seen.add(obj);
+            if (Array.isArray(value)) {
+                const arr = value.map((item) => this.formatDebugValue(item, maxLength, seen));
+                seen.delete(obj);
+                return arr;
+            }
+            const recordValue = value;
+            const entries = Object.entries(recordValue).reduce((acc, [key, val]) => {
+                acc[key] = this.formatDebugValue(val, maxLength, seen);
+                return acc;
+            }, {});
+            seen.delete(obj);
+            return entries;
+        }
+        return value;
+    }
+    dumpResponse(apiReq, payload, status) {
+        const url = apiReq.req.originalUrl || apiReq.req.url;
+        console.log('--- Outgoing Response! ---');
+        console.log('URL:', url);
+        console.log('Status:', status);
+        console.log('Payload:', this.formatDebugValue(payload));
+        console.log('--------------------------');
+    }
 }
 export default ApiServer;

package/dist/esm/auth-storage.d.ts

@@ -9,6 +9,7 @@ export interface AuthTokenMetadata {
     ip?: string;
     os?: string;
     scope?: string | string[];
+    loginType?: string;
     revokeSessions?: 'device' | 'domain' | 'client' | 'user';
 }
 export interface AuthTokenData extends AuthTokenMetadata {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@technomoron/api-server-base",
-	"version": "1.1.5",
+	"version": "1.1.6",
 	"description": "Api Server Skeleton / Base Class",
 	"type": "module",
 	"main": "./dist/cjs/index.cjs",