nucleus-core-ts 0.9.946 → 0.9.948

package/dist/.build-ok

@@ -1 +1 @@
-0.9.946
+0.9.948

package/dist/index.js

@@ -71,7 +71,7 @@ and limitations under the License.
 				</div>
 			</body>
 			</html>
-		`}getActiveAlerts(){return Array.from(this.state.activeAlerts.values())}acknowledgeAlert(alertId){for(let[_type,alert]of this.state.activeAlerts)if(alert.id===alertId)return alert.acknowledged=!0,!0;return!1}clearAlert(type){this.state.activeAlerts.delete(type)}}var init_AlertService=()=>{};class ApplicationCollector{config;requestCount=0;responseTimes=[];errorCount=0;rateLimitBlocks=0;byEndpoint={};byMethod={};byStatus={};byErrorType={};lastCollectTime=Date.now();constructor(config){this.config=config}recordRequest(params){if(!this.config?.enabled)return;if(this.requestCount++,this.config.metrics?.responseTime!==!1){if(this.responseTimes.push(params.responseTimeMs),this.responseTimes.length>1e4)this.responseTimes=this.responseTimes.slice(-5000)}if(this.config.metrics?.requests!==!1)this.byEndpoint[params.endpoint]=(this.byEndpoint[params.endpoint]||0)+1,this.byMethod[params.method]=(this.byMethod[params.method]||0)+1,this.byStatus[String(params.status)]=(this.byStatus[String(params.status)]||0)+1;if(this.config.metrics?.errors!==!1&&params.isError){if(this.errorCount++,params.errorType)this.byErrorType[params.errorType]=(this.byErrorType[params.errorType]||0)+1}}recordRateLimitBlock(){if(!this.config?.enabled||this.config.metrics?.rateLimits===!1)return;this.rateLimitBlocks++}collect(){if(!this.config?.enabled)return null;let elapsed=(Date.now()-this.lastCollectTime)/1000/60,perMinute=elapsed>0?Math.round(this.requestCount/elapsed):0,blockedPerMinute=elapsed>0?Math.round(this.rateLimitBlocks/elapsed):0,sortedTimes=[...this.responseTimes].sort((a,b)=>a-b),len=sortedTimes.length;return{requests:{total:this.requestCount,perMinute,byEndpoint:{...this.byEndpoint},byMethod:{...this.byMethod},byStatus:{...this.byStatus}},responseTime:{avg:len>0?Math.round(sortedTimes.reduce((a,b)=>a+b,0)/len*100)/100:0,min:len>0?sortedTimes[0]??0:0,max:len>0?sortedTimes[len-1]??0:0,p50:len>0?sortedTimes[Math.floor(len*0.5)]??0:0,p95:len>0?sortedTimes[Math.floor(len*0.95)]??0:0,p99:len>0?sortedTimes[Math.floor(len*0.99)]??0:0},errors:{total:this.errorCount,rate:this.requestCount>0?Math.round(this.errorCount/this.requestCount*100*100)/100:0,byType:{...this.byErrorType}},rateLimits:{blocked:this.rateLimitBlocks,blockedPerMinute}}}reset(){this.requestCount=0,this.responseTimes=[],this.errorCount=0,this.rateLimitBlocks=0,this.byEndpoint={},this.byMethod={},this.byStatus={},this.byErrorType={},this.lastCollectTime=Date.now()}getRequestsPerMinute(){let elapsed=(Date.now()-this.lastCollectTime)/1000/60;return elapsed>0?Math.round(this.requestCount/elapsed):0}getErrorRate(){return this.requestCount>0?this.errorCount/this.requestCount*100:0}getRateLimitBlocksPerMinute(){let elapsed=(Date.now()-this.lastCollectTime)/1000/60;return elapsed>0?Math.round(this.rateLimitBlocks/elapsed):0}getAvgResponseTime(){if(this.responseTimes.length===0)return 0;return this.responseTimes.reduce((a,b)=>a+b,0)/this.responseTimes.length}}class DatabaseCollector{config;execute;lastTotals=null;activeTimeSupported=!0;constructor(config,execute){this.config=config,this.execute=execute}async collect(){if(!this.config.enabled)return null;let metrics={connections:{active:0,idle:0,total:0},queries:{total:0,avgTime:0,slowQueries:0}};if(this.config.metrics?.connections!==!1)metrics.connections=await this.collectConnections();if(this.config.metrics?.queryTime!==!1)metrics.queries=await this.collectQueries();return metrics}toNumber(value){let num=Number.parseFloat(String(value??0));return Number.isNaN(num)?0:num}async collectConnections(){try{let row=(await this.execute(`SELECT
+		`}getActiveAlerts(){return Array.from(this.state.activeAlerts.values())}acknowledgeAlert(alertId){for(let[_type,alert]of this.state.activeAlerts)if(alert.id===alertId)return alert.acknowledged=!0,!0;return!1}clearAlert(type){this.state.activeAlerts.delete(type)}}var init_AlertService=()=>{};class ApplicationCollector{config;requestCount=0;responseTimes=[];errorCount=0;rateLimitBlocks=0;byEndpoint={};byMethod={};byStatus={};byErrorType={};lastCollectTime=Date.now();buckets=[];constructor(config){this.config=config}bucketFor(second){let index=second%60,bucket=this.buckets[index];if(!bucket)return bucket={second,requests:0,errors:0,blocks:0},this.buckets[index]=bucket,bucket;if(bucket.second!==second)bucket.second=second,bucket.requests=0,bucket.errors=0,bucket.blocks=0;return bucket}windowed(pick){let oldest=Math.floor(Date.now()/1000)-60,total=0;for(let bucket of this.buckets)if(bucket&&bucket.second>oldest)total+=pick(bucket);return total}recordRequest(params){if(!this.config?.enabled)return;this.requestCount++;let bucket=this.bucketFor(Math.floor(Date.now()/1000));if(bucket.requests+=1,params.isError)bucket.errors+=1;if(this.config.metrics?.responseTime!==!1){if(this.responseTimes.push({at:Date.now(),ms:params.responseTimeMs}),this.responseTimes.length>50000)this.pruneResponseTimes()}if(this.config.metrics?.requests!==!1)this.byEndpoint[params.endpoint]=(this.byEndpoint[params.endpoint]||0)+1,this.byMethod[params.method]=(this.byMethod[params.method]||0)+1,this.byStatus[String(params.status)]=(this.byStatus[String(params.status)]||0)+1;if(this.config.metrics?.errors!==!1&&params.isError){if(this.errorCount++,params.errorType)this.byErrorType[params.errorType]=(this.byErrorType[params.errorType]||0)+1}}recordRateLimitBlock(){if(!this.config?.enabled||this.config.metrics?.rateLimits===!1)return;this.rateLimitBlocks++,this.bucketFor(Math.floor(Date.now()/1000)).blocks+=1}pruneResponseTimes(){let oldest=Date.now()-60000,kept=this.responseTimes.filter((sample)=>sample.at>oldest);if(kept.length>50000)kept=kept.slice(-50000);this.responseTimes=kept}collect(){if(!this.config?.enabled)return null;let perMinute=this.windowed((b)=>b.requests),blockedPerMinute=this.windowed((b)=>b.blocks);this.pruneResponseTimes();let sortedTimes=this.responseTimes.map((s)=>s.ms).sort((a,b)=>a-b),len=sortedTimes.length;return{requests:{total:this.requestCount,perMinute,byEndpoint:{...this.byEndpoint},byMethod:{...this.byMethod},byStatus:{...this.byStatus}},responseTime:{avg:len>0?Math.round(sortedTimes.reduce((a,b)=>a+b,0)/len*100)/100:0,min:len>0?sortedTimes[0]??0:0,max:len>0?sortedTimes[len-1]??0:0,p50:len>0?sortedTimes[Math.floor(len*0.5)]??0:0,p95:len>0?sortedTimes[Math.floor(len*0.95)]??0:0,p99:len>0?sortedTimes[Math.floor(len*0.99)]??0:0},errors:{total:this.errorCount,rate:(()=>{let requests=perMinute;if(requests===0)return 0;let errors=this.windowed((b)=>b.errors);return Math.round(errors/requests*100*100)/100})(),byType:{...this.byErrorType}},rateLimits:{blocked:this.rateLimitBlocks,blockedPerMinute}}}reset(){this.requestCount=0,this.responseTimes=[],this.errorCount=0,this.rateLimitBlocks=0,this.byEndpoint={},this.byMethod={},this.byStatus={},this.byErrorType={},this.buckets=[],this.lastCollectTime=Date.now()}getRequestsPerMinute(){return this.windowed((b)=>b.requests)}getErrorRate(){let requests=this.windowed((b)=>b.requests);return requests>0?this.windowed((b)=>b.errors)/requests*100:0}getRateLimitBlocksPerMinute(){return this.windowed((b)=>b.blocks)}getAvgResponseTime(){if(this.pruneResponseTimes(),this.responseTimes.length===0)return 0;return this.responseTimes.reduce((total,s)=>total+s.ms,0)/this.responseTimes.length}}class DatabaseCollector{config;execute;lastTotals=null;activeTimeSupported=!0;constructor(config,execute){this.config=config,this.execute=execute}async collect(){if(!this.config.enabled)return null;let metrics={connections:{active:0,idle:0,total:0},queries:{total:0,avgTime:0,slowQueries:0}};if(this.config.metrics?.connections!==!1)metrics.connections=await this.collectConnections();if(this.config.metrics?.queryTime!==!1)metrics.queries=await this.collectQueries();return metrics}toNumber(value){let num=Number.parseFloat(String(value??0));return Number.isNaN(num)?0:num}async collectConnections(){try{let row=(await this.execute(`SELECT
            count(*) FILTER (WHERE state = 'active') AS active,
            count(*) FILTER (WHERE state = 'idle') AS idle,
            count(*) AS total

package/dist/src/Services/Monitoring/collectors/ApplicationCollector.d.ts

@@ -2,6 +2,16 @@ import type { ApplicationMetrics, MonitoringConfig } from '../types';
 export declare class ApplicationCollector {
     private config;
     private requestCount;
+    /**
+     * Response times with the moment they happened, so percentiles describe NOW.
+     *
+     * They used to be a plain list of the last 5–10.000 numbers. On a quiet
+     * install that is not a window, it is a memory: run a load test at lunchtime
+     * and the p95 on the screen still describes the load test at six in the
+     * evening, because nothing has come along to push those samples out. The
+     * peak recorder then writes that stale p95 into a peak's context as "what
+     * the response time was at the time", which it was not.
+     */
     private responseTimes;
     private errorCount;
     private rateLimitBlocks;
@@ -10,7 +20,34 @@ export declare class ApplicationCollector {
     private byStatus;
     private byErrorType;
     private lastCollectTime;
+    /**
+     * The last sixty seconds, one bucket each.
+     *
+     * ## What this replaces, and why it is not a detail
+     *
+     * `perMinute` used to be `requestCount / minutesSinceBoot` — the lifetime
+     * AVERAGE, presented as the current rate, on a chart labelled "requests per
+     * minute" and in the alert thresholds. `reset()` exists to make that
+     * arithmetic correct and is called from nowhere, so the divisor kept growing
+     * for as long as the pod lived.
+     *
+     * What that does to a real number: measured on 6 August 2026, a load run
+     * driving roughly fifty API requests a SECOND was recorded as a peak of 273
+     * per MINUTE, in the same snapshot that reported 370 cumulative hits on the
+     * busiest endpoint alone — two figures that cannot both be true. A pod up for
+     * a week would have flattened a genuine incident into nothing at all, which
+     * is the same failure in the direction that matters: the alert that never
+     * fires.
+     *
+     * A rolling window costs sixty small objects and answers the question the
+     * metric's name promises.
+     */
+    private buckets;
     constructor(config: MonitoringConfig['application']);
+    /** The bucket for `now`, recycled if this slot belongs to an expired second. */
+    private bucketFor;
+    /** Sums the buckets still inside the window. */
+    private windowed;
     recordRequest(params: {
         endpoint: string;
         method: string;
@@ -20,10 +57,26 @@ export declare class ApplicationCollector {
         errorType?: string;
     }): void;
     recordRateLimitBlock(): void;
+    /** Drops samples that have fallen out of the window, then out of the cap. */
+    private pruneResponseTimes;
     collect(): ApplicationMetrics | null;
+    /**
+     * Clears the cumulative counters.
+     *
+     * Kept for callers that want a fresh baseline, but nothing on the boot path
+     * calls it — and that used to be a silent bug rather than a choice, because
+     * the rate arithmetic depended on it. The rates no longer do: they read the
+     * rolling window, which expires on its own.
+     */
     reset(): void;
+    /** Requests in the last sixty seconds. */
     getRequestsPerMinute(): number;
+    /**
+     * Error rate over the last minute — the same window the alert thresholds
+     * should be judging, and the same one `collect()` reports.
+     */
     getErrorRate(): number;
     getRateLimitBlocksPerMinute(): number;
+    /** Mean response time over the same minute the other rates describe. */
     getAvgResponseTime(): number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.946",
+	"version": "0.9.948",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",