@serve.zone/dcrouter 11.13.0 → 11.14.0

package/dist_ts/opsserver/helpers/guards.d.ts

@@ -1,27 +0,0 @@
-import * as plugins from '../../plugins.js';
-import type { AdminHandler } from '../handlers/admin.handler.js';
-import * as interfaces from '../../../dist_ts_interfaces/index.js';
-/**
- * Helper function to use identity guards in handlers
- *
- * @example
- * // In a handler:
- * await passGuards(toolsArg, this.opsServerRef.adminHandler.validIdentityGuard, dataArg);
- */
-export declare function passGuards<T extends {
-    identity?: any;
-}>(toolsArg: any, guard: plugins.smartguard.Guard<T>, dataArg: T): Promise<void>;
-/**
- * Helper to check admin identity in handlers and middleware.
- * Accepts both optional and required identity for flexibility.
- */
-export declare function requireAdminIdentity(adminHandler: AdminHandler, dataArg: {
-    identity?: interfaces.data.IIdentity;
-}): Promise<void>;
-/**
- * Helper to check valid identity in handlers and middleware.
- * Accepts both optional and required identity for flexibility.
- */
-export declare function requireValidIdentity(adminHandler: AdminHandler, dataArg: {
-    identity?: interfaces.data.IIdentity;
-}): Promise<void>;

package/dist_ts/opsserver/helpers/guards.js

@@ -1,43 +0,0 @@
-import * as plugins from '../../plugins.js';
-import * as interfaces from '../../../dist_ts_interfaces/index.js';
-/**
- * Helper function to use identity guards in handlers
- *
- * @example
- * // In a handler:
- * await passGuards(toolsArg, this.opsServerRef.adminHandler.validIdentityGuard, dataArg);
- */
-export async function passGuards(toolsArg, guard, dataArg) {
-    const result = await guard.exec(dataArg);
-    if (!result) {
-        const failedHint = await guard.getFailedHint(dataArg);
-        throw new plugins.typedrequest.TypedResponseError(failedHint || 'Guard check failed');
-    }
-}
-/**
- * Helper to check admin identity in handlers and middleware.
- * Accepts both optional and required identity for flexibility.
- */
-export async function requireAdminIdentity(adminHandler, dataArg) {
-    if (!dataArg.identity) {
-        throw new plugins.typedrequest.TypedResponseError('No identity provided');
-    }
-    const passed = await adminHandler.adminIdentityGuard.exec({ identity: dataArg.identity });
-    if (!passed) {
-        throw new plugins.typedrequest.TypedResponseError('Admin access required');
-    }
-}
-/**
- * Helper to check valid identity in handlers and middleware.
- * Accepts both optional and required identity for flexibility.
- */
-export async function requireValidIdentity(adminHandler, dataArg) {
-    if (!dataArg.identity) {
-        throw new plugins.typedrequest.TypedResponseError('No identity provided');
-    }
-    const passed = await adminHandler.validIdentityGuard.exec({ identity: dataArg.identity });
-    if (!passed) {
-        throw new plugins.typedrequest.TypedResponseError('Valid identity required');
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ3VhcmRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvb3Bzc2VydmVyL2hlbHBlcnMvZ3VhcmRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFFNUMsT0FBTyxLQUFLLFVBQVUsTUFBTSxpQ0FBaUMsQ0FBQztBQUU5RDs7Ozs7O0dBTUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFVBQVUsQ0FDOUIsUUFBYSxFQUNiLEtBQWtDLEVBQ2xDLE9BQVU7SUFFVixNQUFNLE1BQU0sR0FBRyxNQUFNLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDekMsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ1osTUFBTSxVQUFVLEdBQUcsTUFBTSxLQUFLLENBQUMsYUFBYSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3RELE1BQU0sSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLGtCQUFrQixDQUFDLFVBQVUsSUFBSSxvQkFBb0IsQ0FBQyxDQUFDO0lBQ3hGLENBQUM7QUFDSCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxvQkFBb0IsQ0FDeEMsWUFBMEIsRUFDMUIsT0FBaUQ7SUFFakQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztRQUN0QixNQUFNLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxrQkFBa0IsQ0FBQyxzQkFBc0IsQ0FBQyxDQUFDO0lBQzVFLENBQUM7SUFFRCxNQUFNLE1BQU0sR0FBRyxNQUFNLFlBQVksQ0FBQyxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsRUFBRSxRQUFRLEVBQUUsT0FBTyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7SUFDMUYsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ1osTUFBTSxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsa0JBQWtCLENBQUMsdUJBQXVCLENBQUMsQ0FBQztJQUM3RSxDQUFDO0FBQ0gsQ0FBQztBQUVEOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsb0JBQW9CLENBQ3hDLFlBQTBCLEVBQzFCLE9BQWlEO0lBRWpELElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDdEIsTUFBTSxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsa0JBQWtCLENBQUMsc0JBQXNCLENBQUMsQ0FBQztJQUM1RSxDQUFDO0lBRUQsTUFBTSxNQUFNLEdBQUcsTUFBTSxZQUFZLENBQUMsa0JBQWtCLENBQUMsSUFBSSxDQUFDLEVBQUUsUUFBUSxFQUFFLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDO0lBQzFGLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUNaLE1BQU0sSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLGtCQUFrQixDQUFDLHlCQUF5QixDQUFDLENBQUM7SUFDL0UsQ0FBQztBQUNILENBQUMifQ==

package/dist_ts/opsserver/index.d.ts

@@ -1 +0,0 @@
-export * from './classes.opsserver.js';

package/dist_ts/opsserver/index.js

@@ -1,2 +0,0 @@
-export * from './classes.opsserver.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9vcHNzZXJ2ZXIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyx3QkFBd0IsQ0FBQyJ9

package/dist_ts/paths.d.ts

@@ -1,26 +0,0 @@
-export declare const packageDir: string;
-export declare const distServe: string;
-export declare const dcrouterHomeDir: string;
-export declare const dataDir: string;
-export declare const defaultTsmDbPath: string;
-export declare const dnsRecordsDir: string;
-/**
- * Resolve all data paths from a given baseDir.
- * When no baseDir is provided, falls back to ~/.serve.zone/dcrouter.
- * Specific overrides (e.g. DATA_DIR env) take precedence.
- */
-export declare function resolvePaths(baseDir?: string): {
-    dcrouterHomeDir: string;
-    dataDir: string;
-    defaultTsmDbPath: string;
-    defaultStoragePath: string;
-    dnsRecordsDir: string;
-};
-/**
- * Ensure only the data directories that are actually used exist.
- */
-export declare function ensureDataDirectories(resolvedPaths: ReturnType<typeof resolvePaths>): void;
-/**
- * Legacy wrapper — delegates to ensureDataDirectories with module-level defaults.
- */
-export declare function ensureDirectories(): void;

package/dist_ts/paths.js

@@ -1,45 +0,0 @@
-import * as plugins from './plugins.js';
-// Code/asset paths (not affected by baseDir)
-export const packageDir = plugins.path.join(plugins.smartpath.get.dirnameFromImportMetaUrl(import.meta.url), '../');
-export const distServe = plugins.path.join(packageDir, './dist_serve');
-// Default base for all dcrouter data (always user-writable)
-export const dcrouterHomeDir = plugins.path.join(plugins.os.homedir(), '.serve.zone', 'dcrouter');
-// Configure data directory with environment variable or default to ~/.serve.zone/dcrouter/data
-const DEFAULT_DATA_PATH = plugins.path.join(dcrouterHomeDir, 'data');
-export const dataDir = process.env.DATA_DIR
-    ? process.env.DATA_DIR
-    : DEFAULT_DATA_PATH;
-// Default TsmDB path for CacheDb
-export const defaultTsmDbPath = plugins.path.join(dcrouterHomeDir, 'tsmdb');
-// DNS records directory (only surviving MTA directory reference)
-export const dnsRecordsDir = plugins.path.join(dataDir, 'dns');
-/**
- * Resolve all data paths from a given baseDir.
- * When no baseDir is provided, falls back to ~/.serve.zone/dcrouter.
- * Specific overrides (e.g. DATA_DIR env) take precedence.
- */
-export function resolvePaths(baseDir) {
-    const root = baseDir ?? plugins.path.join(plugins.os.homedir(), '.serve.zone', 'dcrouter');
-    const resolvedDataDir = process.env.DATA_DIR ?? plugins.path.join(root, 'data');
-    return {
-        dcrouterHomeDir: root,
-        dataDir: resolvedDataDir,
-        defaultTsmDbPath: plugins.path.join(root, 'tsmdb'),
-        defaultStoragePath: plugins.path.join(root, 'storage'),
-        dnsRecordsDir: plugins.path.join(resolvedDataDir, 'dns'),
-    };
-}
-/**
- * Ensure only the data directories that are actually used exist.
- */
-export function ensureDataDirectories(resolvedPaths) {
-    plugins.fsUtils.ensureDirSync(resolvedPaths.dataDir);
-    plugins.fsUtils.ensureDirSync(resolvedPaths.dnsRecordsDir);
-}
-/**
- * Legacy wrapper — delegates to ensureDataDirectories with module-level defaults.
- */
-export function ensureDirectories() {
-    ensureDataDirectories(resolvePaths());
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9wYXRocy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4Qyw2Q0FBNkM7QUFDN0MsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUN6QyxPQUFPLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyx3QkFBd0IsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUMvRCxLQUFLLENBQ04sQ0FBQztBQUNGLE1BQU0sQ0FBQyxNQUFNLFNBQVMsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsY0FBYyxDQUFDLENBQUM7QUFFdkUsNERBQTREO0FBQzVELE1BQU0sQ0FBQyxNQUFNLGVBQWUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxFQUFFLGFBQWEsRUFBRSxVQUFVLENBQUMsQ0FBQztBQUVsRywrRkFBK0Y7QUFDL0YsTUFBTSxpQkFBaUIsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsTUFBTSxDQUFDLENBQUM7QUFDckUsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUTtJQUN6QyxDQUFDLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFRO0lBQ3RCLENBQUMsQ0FBQyxpQkFBaUIsQ0FBQztBQUV0QixpQ0FBaUM7QUFDakMsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0FBRTVFLGlFQUFpRTtBQUNqRSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO0FBRS9EOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsWUFBWSxDQUFDLE9BQWdCO0lBQzNDLE1BQU0sSUFBSSxHQUFHLE9BQU8sSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxFQUFFLGFBQWEsRUFBRSxVQUFVLENBQUMsQ0FBQztJQUMzRixNQUFNLGVBQWUsR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDLFFBQVEsSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDaEYsT0FBTztRQUNMLGVBQWUsRUFBRSxJQUFJO1FBQ3JCLE9BQU8sRUFBRSxlQUFlO1FBQ3hCLGdCQUFnQixFQUFFLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxPQUFPLENBQUM7UUFDbEQsa0JBQWtCLEVBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLFNBQVMsQ0FBQztRQUN0RCxhQUFhLEVBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLEtBQUssQ0FBQztLQUN6RCxDQUFDO0FBQ0osQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLGFBQThDO0lBQ2xGLE9BQU8sQ0FBQyxPQUFPLENBQUMsYUFBYSxDQUFDLGFBQWEsQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUNyRCxPQUFPLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxhQUFhLENBQUMsYUFBYSxDQUFDLENBQUM7QUFDN0QsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLGlCQUFpQjtJQUMvQixxQkFBcUIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxDQUFDO0FBQ3hDLENBQUMifQ==

package/dist_ts/plugins.d.ts

@@ -1,81 +0,0 @@
-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, };
-import * as servezoneInterfaces from '@serve.zone/interfaces';
-import * as remoteingress from '@serve.zone/remoteingress';
-export { servezoneInterfaces, remoteingress, };
-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, };
-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 };
-export type TLogLevel = 'error' | 'warn' | 'info' | 'success' | 'debug';
-import * as cloudflare from '@apiclient.xyz/cloudflare';
-export { cloudflare, };
-import * as tsclass from '@tsclass/tsclass';
-export { tsclass, };
-import * as uuid from 'uuid';
-export { uuid, };
-export declare const fsUtils: {
-    /**
-     * Ensure a directory exists, creating it recursively if needed (sync)
-     */
-    ensureDirSync: (dirPath: string) => void;
-    /**
-     * Ensure a directory exists, creating it recursively if needed (async)
-     */
-    ensureDir: (dirPath: string) => Promise<void>;
-    /**
-     * Write JSON content to a file synchronously
-     */
-    toFsSync: (content: any, filePath: string) => void;
-    /**
-     * Write JSON content to a file asynchronously
-     */
-    toFs: (content: any, filePath: string) => Promise<void>;
-    /**
-     * Check if a file or directory exists
-     */
-    fileExistsSync: (filePath: string) => boolean;
-    /**
-     * Check if a file or directory exists (async)
-     */
-    fileExists: (filePath: string) => Promise<boolean>;
-    /**
-     * Read a JSON file synchronously
-     */
-    toObjectSync: <T = any>(filePath: string) => T;
-    /**
-     * Read a JSON file asynchronously
-     */
-    toObject: <T = any>(filePath: string) => Promise<T>;
-};

package/dist_ts/plugins.js

@@ -1,115 +0,0 @@
-// 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

@@ -1,231 +0,0 @@
-import type { StorageManager } from '../storage/index.js';
-/**
- * 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 {
-    /** Storage key prefix */
-    storagePrefix?: string;
-    /** 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 storageManager?;
-    private staleSessionSweepTimer?;
-    private stats;
-    constructor(config?: IAccountingManagerConfig, storageManager?: StorageManager);
-    /**
-     * 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 storage
-     */
-    private loadActiveSessions;
-    /**
-     * Persist a session to storage
-     */
-    private persistSession;
-    /**
-     * Archive a completed session
-     */
-    private archiveSession;
-    /**
-     * Get archived sessions for a time period
-     */
-    private getArchivedSessions;
-}