@serve.zone/dcrouter 13.17.0 → 13.17.3

package/dist_ts/plugins.js

@@ -0,0 +1,115 @@
+// node native
+import * as dns from 'dns';
+import * as fs from 'fs';
+import * as crypto from 'crypto';
+import * as http from 'http';
+import * as net from 'net';
+import * as os from 'os';
+import * as path from 'path';
+import * as tls from 'tls';
+import * as util from 'util';
+export { dns, fs, crypto, http, net, os, path, tls, util, };
+// @serve.zone scope
+import * as servezoneInterfaces from '@serve.zone/interfaces';
+import * as remoteingress from '@serve.zone/remoteingress';
+export { servezoneInterfaces, remoteingress, };
+// @api.global scope
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedserver from '@api.global/typedserver';
+import * as typedsocket from '@api.global/typedsocket';
+export { typedrequest, typedserver, typedsocket, };
+// @push.rocks scope
+import * as projectinfo from '@push.rocks/projectinfo';
+import * as qenv from '@push.rocks/qenv';
+import * as smartacme from '@push.rocks/smartacme';
+import * as smartdata from '@push.rocks/smartdata';
+import * as smartdns from '@push.rocks/smartdns';
+import * as smartfs from '@push.rocks/smartfs';
+import * as smartguard from '@push.rocks/smartguard';
+import * as smartjwt from '@push.rocks/smartjwt';
+import * as smartlog from '@push.rocks/smartlog';
+import * as smartmetrics from '@push.rocks/smartmetrics';
+import * as smartmta from '@push.rocks/smartmta';
+import * as smartdb from '@push.rocks/smartdb';
+import * as smartnetwork from '@push.rocks/smartnetwork';
+import * as smartpath from '@push.rocks/smartpath';
+import * as smartproxy from '@push.rocks/smartproxy';
+import * as smartpromise from '@push.rocks/smartpromise';
+import * as smartvpn from '@push.rocks/smartvpn';
+import * as smartradius from '@push.rocks/smartradius';
+import * as smartrequest from '@push.rocks/smartrequest';
+import * as smartrx from '@push.rocks/smartrx';
+import * as smartunique from '@push.rocks/smartunique';
+import * as taskbuffer from '@push.rocks/taskbuffer';
+export { projectinfo, qenv, smartacme, smartdata, smartdns, smartfs, smartguard, smartjwt, smartlog, smartmetrics, smartdb, smartmta, smartnetwork, smartpath, smartproxy, smartpromise, smartradius, smartrequest, smartrx, smartunique, smartvpn, taskbuffer };
+// apiclient.xyz scope
+import * as cloudflare from '@apiclient.xyz/cloudflare';
+export { cloudflare, };
+// tsclass scope
+import * as tsclass from '@tsclass/tsclass';
+export { tsclass, };
+// third party
+import * as uuid from 'uuid';
+export { uuid, };
+// Filesystem utilities
+export const fsUtils = {
+    /**
+     * Ensure a directory exists, creating it recursively if needed (sync)
+     */
+    ensureDirSync: (dirPath) => {
+        fs.mkdirSync(dirPath, { recursive: true });
+    },
+    /**
+     * Ensure a directory exists, creating it recursively if needed (async)
+     */
+    ensureDir: async (dirPath) => {
+        await fs.promises.mkdir(dirPath, { recursive: true });
+    },
+    /**
+     * Write JSON content to a file synchronously
+     */
+    toFsSync: (content, filePath) => {
+        const data = typeof content === 'string' ? content : JSON.stringify(content, null, 2);
+        fs.writeFileSync(filePath, data);
+    },
+    /**
+     * Write JSON content to a file asynchronously
+     */
+    toFs: async (content, filePath) => {
+        const data = typeof content === 'string' ? content : JSON.stringify(content, null, 2);
+        await fs.promises.writeFile(filePath, data);
+    },
+    /**
+     * Check if a file or directory exists
+     */
+    fileExistsSync: (filePath) => {
+        return fs.existsSync(filePath);
+    },
+    /**
+     * Check if a file or directory exists (async)
+     */
+    fileExists: async (filePath) => {
+        try {
+            await fs.promises.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Read a JSON file synchronously
+     */
+    toObjectSync: (filePath) => {
+        const content = fs.readFileSync(filePath, 'utf8');
+        return JSON.parse(content);
+    },
+    /**
+     * Read a JSON file asynchronously
+     */
+    toObject: async (filePath) => {
+        const content = await fs.promises.readFile(filePath, 'utf8');
+        return JSON.parse(content);
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYztBQUNkLE9BQU8sS0FBSyxHQUFHLE1BQU0sS0FBSyxDQUFDO0FBQzNCLE9BQU8sS0FBSyxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBQ3pCLE9BQU8sS0FBSyxNQUFNLE1BQU0sUUFBUSxDQUFDO0FBQ2pDLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBQzdCLE9BQU8sS0FBSyxHQUFHLE1BQU0sS0FBSyxDQUFDO0FBQzNCLE9BQU8sS0FBSyxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBQ3pCLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBQzdCLE9BQU8sS0FBSyxHQUFHLE1BQU0sS0FBSyxDQUFDO0FBQzNCLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBRTdCLE9BQU8sRUFDTCxHQUFHLEVBQ0gsRUFBRSxFQUNGLE1BQU0sRUFDTixJQUFJLEVBQ0osR0FBRyxFQUNILEVBQUUsRUFDRixJQUFJLEVBQ0osR0FBRyxFQUNILElBQUksR0FDTCxDQUFBO0FBRUQsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxtQkFBbUIsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEtBQUssYUFBYSxNQUFNLDJCQUEyQixDQUFDO0FBRTNELE9BQU8sRUFDTCxtQkFBbUIsRUFDbkIsYUFBYSxHQUNkLENBQUE7QUFFRCxvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEtBQUssV0FBVyxNQUFNLHlCQUF5QixDQUFDO0FBQ3ZELE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFFdkQsT0FBTyxFQUNMLFlBQVksRUFDWixXQUFXLEVBQ1gsV0FBVyxHQUNaLENBQUE7QUFFRCxvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLFdBQVcsTUFBTSx5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

package/dist_ts/radius/classes.accounting.manager.d.ts

@@ -0,0 +1,223 @@
+/**
+ * RADIUS accounting session
+ */
+export interface IAccountingSession {
+    /** Unique session ID from RADIUS */
+    sessionId: string;
+    /** Username (often MAC address for MAB) */
+    username: string;
+    /** MAC address of the device */
+    macAddress?: string;
+    /** NAS IP address (switch/AP) */
+    nasIpAddress: string;
+    /** NAS port (physical or virtual) */
+    nasPort?: number;
+    /** NAS port type */
+    nasPortType?: string;
+    /** NAS identifier (name) */
+    nasIdentifier?: string;
+    /** Assigned VLAN */
+    vlanId?: number;
+    /** Assigned IP address (if any) */
+    framedIpAddress?: string;
+    /** Called station ID (usually BSSID for wireless) */
+    calledStationId?: string;
+    /** Calling station ID (usually client MAC) */
+    callingStationId?: string;
+    /** Session start time */
+    startTime: number;
+    /** Session end time (0 if active) */
+    endTime: number;
+    /** Last update time (interim accounting) */
+    lastUpdateTime: number;
+    /** Session status */
+    status: 'active' | 'stopped' | 'terminated';
+    /** Termination cause (if stopped) */
+    terminateCause?: string;
+    /** Input octets (bytes received by NAS from client) */
+    inputOctets: number;
+    /** Output octets (bytes sent by NAS to client) */
+    outputOctets: number;
+    /** Input packets */
+    inputPackets: number;
+    /** Output packets */
+    outputPackets: number;
+    /** Session duration in seconds */
+    sessionTime: number;
+    /** Service type */
+    serviceType?: string;
+}
+/**
+ * Accounting summary for a time period
+ */
+export interface IAccountingSummary {
+    /** Time period start */
+    periodStart: number;
+    /** Time period end */
+    periodEnd: number;
+    /** Total sessions */
+    totalSessions: number;
+    /** Active sessions */
+    activeSessions: number;
+    /** Total input bytes */
+    totalInputBytes: number;
+    /** Total output bytes */
+    totalOutputBytes: number;
+    /** Total session time (seconds) */
+    totalSessionTime: number;
+    /** Average session duration (seconds) */
+    averageSessionDuration: number;
+    /** Unique users/devices */
+    uniqueUsers: number;
+    /** Sessions by VLAN */
+    sessionsByVlan: Record<number, number>;
+    /** Top users by traffic */
+    topUsersByTraffic: Array<{
+        username: string;
+        totalBytes: number;
+    }>;
+}
+/**
+ * Accounting manager configuration
+ */
+export interface IAccountingManagerConfig {
+    /** Session retention period in days (default: 30) */
+    retentionDays?: number;
+    /** Enable detailed session logging */
+    detailedLogging?: boolean;
+    /** Maximum active sessions to track in memory */
+    maxActiveSessions?: number;
+    /** Stale session timeout in hours — sessions with no update for this long are evicted (default: 24) */
+    staleSessionTimeoutHours?: number;
+}
+/**
+ * Manages RADIUS accounting data including:
+ * - Session tracking (start/stop/interim)
+ * - Data usage tracking (bytes in/out)
+ * - Session history and retention
+ * - Billing reports and summaries
+ */
+export declare class AccountingManager {
+    private activeSessions;
+    private config;
+    private staleSessionSweepTimer?;
+    private stats;
+    constructor(config?: IAccountingManagerConfig);
+    /**
+     * Initialize the accounting manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Stop the accounting manager and clean up timers
+     */
+    stop(): void;
+    /**
+     * Sweep stale active sessions that have not received any update
+     * within the configured timeout. These are orphaned sessions where
+     * the Stop packet was never received.
+     */
+    private sweepStaleSessions;
+    /**
+     * Handle accounting start request
+     */
+    handleAccountingStart(data: {
+        sessionId: string;
+        username: string;
+        macAddress?: string;
+        nasIpAddress: string;
+        nasPort?: number;
+        nasPortType?: string;
+        nasIdentifier?: string;
+        vlanId?: number;
+        framedIpAddress?: string;
+        calledStationId?: string;
+        callingStationId?: string;
+        serviceType?: string;
+    }): Promise<void>;
+    /**
+     * Handle accounting interim update request
+     */
+    handleAccountingUpdate(data: {
+        sessionId: string;
+        inputOctets?: number;
+        outputOctets?: number;
+        inputPackets?: number;
+        outputPackets?: number;
+        sessionTime?: number;
+    }): Promise<void>;
+    /**
+     * Handle accounting stop request
+     */
+    handleAccountingStop(data: {
+        sessionId: string;
+        terminateCause?: string;
+        inputOctets?: number;
+        outputOctets?: number;
+        inputPackets?: number;
+        outputPackets?: number;
+        sessionTime?: number;
+    }): Promise<void>;
+    /**
+     * Get an active session by ID
+     */
+    getSession(sessionId: string): IAccountingSession | undefined;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): IAccountingSession[];
+    /**
+     * Get active sessions by username
+     */
+    getSessionsByUsername(username: string): IAccountingSession[];
+    /**
+     * Get active sessions by NAS IP
+     */
+    getSessionsByNas(nasIpAddress: string): IAccountingSession[];
+    /**
+     * Get active sessions by VLAN
+     */
+    getSessionsByVlan(vlanId: number): IAccountingSession[];
+    /**
+     * Get accounting summary for a time period
+     */
+    getSummary(startTime: number, endTime: number): Promise<IAccountingSummary>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        activeSessions: number;
+        totalSessionsStarted: number;
+        totalSessionsStopped: number;
+        totalInputBytes: number;
+        totalOutputBytes: number;
+        interimUpdatesReceived: number;
+    };
+    /**
+     * Disconnect a session (admin action)
+     */
+    disconnectSession(sessionId: string, reason?: string): Promise<boolean>;
+    /**
+     * Clean up old archived sessions based on retention policy
+     */
+    cleanupOldSessions(): Promise<number>;
+    /**
+     * Find the oldest active session
+     */
+    private findOldestSession;
+    /**
+     * Evict a session from memory
+     */
+    private evictSession;
+    /**
+     * Load active sessions from database
+     */
+    private loadActiveSessions;
+    /**
+     * Persist a session to the database (create or update)
+     */
+    private persistSession;
+    /**
+     * Get archived (stopped/terminated) sessions for a time period
+     */
+    private getArchivedSessions;
+}