admindb 2.0.0 → 2.1.1

package/dist/utils/common.js

@@ -1,229 +1 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorMessage = errorMessage;
-exports.isPathWithinRoot = isPathWithinRoot;
-exports.parseFilters = parseFilters;
-exports.filtersToQS = filtersToQS;
-exports.isInternalTable = isInternalTable;
-exports.encodePk = encodePk;
-exports.decodePk = decodePk;
-exports.normalizeCell = normalizeCell;
-exports.normalizeRow = normalizeRow;
-exports.coerceFormValue = coerceFormValue;
-exports.formatBytes = formatBytes;
-exports.truncate = truncate;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-function errorMessage(err) {
-    if (err instanceof Error)
-        return err.message;
-    return String(err);
-}
-/**
- * True when `p` is equal to `root` or lives inside it (both treated as
- * absolute). Used to sandbox the filesystem file-browser to an allowed folder.
- * Resolves symlinks and rejects null-byte injections.
- */
-function isPathWithinRoot(root, p) {
-    if (!root || !p || typeof root !== 'string' || typeof p !== 'string')
-        return false;
-    if (p.includes('\0') || root.includes('\0'))
-        return false;
-    const absRoot = node_path_1.default.resolve(root);
-    const absPath = node_path_1.default.resolve(p);
-    let realRoot = absRoot;
-    let realPath = absPath;
-    try {
-        if ((0, node_fs_1.existsSync)(absRoot))
-            realRoot = (0, node_fs_1.realpathSync)(absRoot);
-    }
-    catch { }
-    try {
-        if ((0, node_fs_1.existsSync)(absPath))
-            realPath = (0, node_fs_1.realpathSync)(absPath);
-    }
-    catch { }
-    const rel = node_path_1.default.relative(realRoot, realPath);
-    return rel === '' || (!rel.startsWith('..') && !node_path_1.default.isAbsolute(rel));
-}
-/** Parse the `f` query parameter (URL-encoded JSON object) into row filters. */
-function parseFilters(raw) {
-    const out = {};
-    const add = (obj) => {
-        if (obj && typeof obj === 'object') {
-            for (const [k, v] of Object.entries(obj)) {
-                if (v === undefined || v === null || v === '')
-                    continue;
-                if (Array.isArray(v)) {
-                    if (v.length)
-                        out[k] = v;
-                }
-                else if (typeof v === 'object') {
-                    out[k] = v;
-                }
-                else {
-                    out[k] = String(v);
-                }
-            }
-        }
-    };
-    if (typeof raw === 'string' && raw) {
-        try {
-            add(JSON.parse(raw));
-        }
-        catch {
-            return {};
-        }
-    }
-    else {
-        add(raw);
-    }
-    return out;
-}
-/** Encode filters back into a `f=…` query string (empty when no filters). */
-function filtersToQS(filters) {
-    const out = {};
-    for (const [k, v] of Object.entries(filters ?? {})) {
-        if (v === undefined || v === null)
-            continue;
-        if (Array.isArray(v)) {
-            if (v.length)
-                out[k] = v;
-            continue;
-        }
-        if (typeof v === 'object') {
-            if (Object.keys(v).length)
-                out[k] = v;
-            continue;
-        }
-        if (String(v).trim() !== '')
-            out[k] = String(v).trim();
-    }
-    const keys = Object.keys(out);
-    if (!keys.length)
-        return '';
-    return 'f=' + encodeURIComponent(JSON.stringify(out));
-}
-/** Internal tables (kept out of user-facing pickers) start with an underscore. */
-function isInternalTable(name) {
-    return name.startsWith('_');
-}
-/** Encode primary-key values into a single URL path segment (comma-joined, URL-encoded). */
-function encodePk(values) {
-    return values.map((v) => encodeURIComponent(v == null ? '' : String(v))).join(',');
-}
-/** Decode a primary-key path segment back into individual values. */
-function decodePk(encoded) {
-    return String(encoded)
-        .split(',')
-        .map((s) => {
-        try {
-            return decodeURIComponent(s);
-        }
-        catch {
-            return s;
-        }
-    });
-}
-/** Normalize a single cell for JSON / display (BLOB → 0x-hex string, undefined → null). */
-function normalizeCell(value) {
-    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {
-        return `0x${Buffer.from(value).toString('hex')}`;
-    }
-    if (value instanceof Date) {
-        return value.toISOString();
-    }
-    if (typeof value === 'object' && value !== null) {
-        return JSON.stringify(value);
-    }
-    if (value === undefined)
-        return null;
-    return value;
-}
-/** Normalize every cell in a row. */
-function normalizeRow(row) {
-    const out = {};
-    for (const [k, v] of Object.entries(row ?? {}))
-        out[k] = normalizeCell(v);
-    return out;
-}
-/**
- * Coerce a raw form value into a value suitable for SQLite or Postgres binding.
- * - empty string / null / undefined  → null ("not set")
- * - `0` stays valid
- * - BOOLEAN → 1/0 (SQLite) or boolean (PostgreSQL)
- * - INTEGER/REAL/BIGINT/NUMERIC → number when numeric
- * - BLOB / BYTEA → Buffer (0x-hex, \x-hex, or raw text)
- */
-function coerceFormValue(raw, columnType, dialect = 'sqlite') {
-    const type = (columnType || '').toUpperCase();
-    if (raw === undefined || raw === null)
-        return null;
-    if (type === 'BOOLEAN' || type === 'BOOL') {
-        const s = String(raw).trim().toLowerCase();
-        if (s === '')
-            return null;
-        const boolVal = s === 'true' || s === '1' || s === 'on' || s === 'yes' || s === 'checked';
-        return dialect === 'postgres' ? boolVal : (boolVal ? 1 : 0);
-    }
-    if (type.startsWith('INT') ||
-        type === 'REAL' ||
-        type === 'NUMERIC' ||
-        type.startsWith('DECIMAL') ||
-        type === 'FLOAT' ||
-        type === 'DOUBLE' ||
-        type.startsWith('BIGINT') ||
-        type.startsWith('SMALLINT') ||
-        type.startsWith('SERIAL')) {
-        const s = String(raw).trim();
-        if (s === '')
-            return null;
-        const n = Number(s);
-        return Number.isFinite(n) ? n : s;
-    }
-    if (type === 'BLOB' || type === 'BYTEA') {
-        const s = String(raw);
-        if (/^0x[0-9a-f]*$/i.test(s))
-            return Buffer.from(s.slice(2), 'hex');
-        if (/^\\x[0-9a-f]*$/i.test(s))
-            return Buffer.from(s.slice(2), 'hex');
-        return Buffer.from(s, 'utf8');
-    }
-    if (type === 'JSON' || type === 'JSONB') {
-        const s = String(raw).trim();
-        if (s === '')
-            return null;
-        return s;
-    }
-    if (type.endsWith('[]') || type.startsWith('_') || type.includes('ARRAY')) {
-        if (Array.isArray(raw))
-            return raw;
-        const s = String(raw).trim();
-        if (s === '')
-            return null;
-        return s;
-    }
-    const s = String(raw);
-    if (s === '')
-        return null;
-    return s;
-}
-/** Format byte size to human readable string (e.g. 1.2 MB). */
-function formatBytes(bytes) {
-    if (bytes === 0)
-        return '0 B';
-    const k = 1024;
-    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
-    const i = Math.floor(Math.log(bytes) / Math.log(k));
-    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${sizes[i]}`;
-}
-/** Truncate a string with an ellipsis if it exceeds maxLength. */
-function truncate(str, maxLength) {
-    if (!str || str.length <= maxLength)
-        return str;
-    return `${str.slice(0, maxLength)}…`;
-}
-//# sourceMappingURL=common.js.map
+var __importDefault=this&&this.__importDefault||function(mod){return mod&&mod.__esModule?mod:{default:mod}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.errorMessage=function(err){return err instanceof Error?err.message:String(err)},exports.isPathWithinRoot=function(root,p){if(!root||!p||"string"!=typeof root||"string"!=typeof p)return!1;if(p.includes("\0")||root.includes("\0"))return!1;const absRoot=node_path_1.default.resolve(root),absPath=node_path_1.default.resolve(p);let realRoot=absRoot,realPath=absPath;try{(0,node_fs_1.existsSync)(absRoot)&&(realRoot=(0,node_fs_1.realpathSync)(absRoot))}catch{}try{(0,node_fs_1.existsSync)(absPath)&&(realPath=(0,node_fs_1.realpathSync)(absPath))}catch{}const rel=node_path_1.default.relative(realRoot,realPath);return""===rel||!rel.startsWith("..")&&!node_path_1.default.isAbsolute(rel)},exports.parseFilters=function(raw){const out={},add=obj=>{if(obj&&"object"==typeof obj)for(const[k,v]of Object.entries(obj))null!=v&&""!==v&&(Array.isArray(v)?v.length&&(out[k]=v):out[k]="object"==typeof v?v:String(v))};if("string"==typeof raw&&raw)try{add(JSON.parse(raw))}catch{return{}}else add(raw);return out},exports.filtersToQS=function(filters){const out={};for(const[k,v]of Object.entries(filters??{}))null!=v&&(Array.isArray(v)?v.length&&(out[k]=v):"object"!=typeof v?""!==String(v).trim()&&(out[k]=String(v).trim()):Object.keys(v).length&&(out[k]=v));return Object.keys(out).length?"f="+encodeURIComponent(JSON.stringify(out)):""},exports.isInternalTable=function(name){return name.startsWith("_")},exports.encodePk=function(values){return values.map(v=>encodeURIComponent(null==v?"":String(v))).join(",")},exports.decodePk=function(encoded){return String(encoded).split(",").map(s=>{try{return decodeURIComponent(s)}catch{return s}})},exports.normalizeCell=normalizeCell,exports.normalizeRow=function(row){const out={};for(const[k,v]of Object.entries(row??{}))out[k]=normalizeCell(v);return out},exports.coerceFormValue=function(raw,columnType,dialect="sqlite"){const type=(columnType||"").toUpperCase();if(null==raw)return null;if("BOOLEAN"===type||"BOOL"===type){const s=String(raw).trim().toLowerCase();if(""===s)return null;const boolVal="true"===s||"1"===s||"on"===s||"yes"===s||"checked"===s;return"postgres"===dialect?boolVal:boolVal?1:0}if(type.startsWith("INT")||"REAL"===type||"NUMERIC"===type||type.startsWith("DECIMAL")||"FLOAT"===type||"DOUBLE"===type||type.startsWith("BIGINT")||type.startsWith("SMALLINT")||type.startsWith("SERIAL")){const s=String(raw).trim();if(""===s)return null;const n=Number(s);return Number.isFinite(n)?n:s}if("BLOB"===type||"BYTEA"===type){const s=String(raw);return/^0x[0-9a-f]*$/i.test(s)||/^\\x[0-9a-f]*$/i.test(s)?Buffer.from(s.slice(2),"hex"):Buffer.from(s,"utf8")}if("JSON"===type||"JSONB"===type){const s=String(raw).trim();return""===s?null:s}if(type.endsWith("[]")||type.startsWith("_")||type.includes("ARRAY")){if(Array.isArray(raw))return raw;const s=String(raw).trim();return""===s?null:s}const s=String(raw);return""===s?null:s},exports.formatBytes=function(bytes){if(0===bytes)return"0 B";const i=Math.floor(Math.log(bytes)/Math.log(1024));return`${parseFloat((bytes/Math.pow(1024,i)).toFixed(1))} ${["B","KB","MB","GB","TB"][i]}`},exports.truncate=function(str,maxLength){return!str||str.length<=maxLength?str:`${str.slice(0,maxLength)}…`};const node_fs_1=require("node:fs"),node_path_1=__importDefault(require("node:path"));function normalizeCell(value){return value instanceof Uint8Array||Buffer.isBuffer(value)?`0x${Buffer.from(value).toString("hex")}`:value instanceof Date?value.toISOString():"object"==typeof value&&null!==value?JSON.stringify(value):void 0===value?null:value}

package/dist/utils/csv.d.ts

@@ -1,15 +1 @@
-/**
- * Minimal RFC 4180-style CSV serialization and parsing, used for table and
- * query export/import. Pure functions with no I/O so they are easy to test.
- */
-/** Escape a single CSV field (quote when it contains comma, quote or newline). */
-export declare function csvEscape(value: unknown): string;
-/** Serialize rows to CSV with an explicit column order. */
-export declare function toCsv(rows: Record<string, unknown>[], columns: string[]): string;
-/** Serialize rows to JSON (values are expected to be already normalized). */
-export declare function toJson(rows: Record<string, unknown>[]): string;
-/**
- * Parse CSV text into rows of string fields. Handles quoted fields containing
- * commas, quotes and embedded newlines. Blank lines are skipped.
- */
-export declare function parseCsv(text: string): string[][];
+export declare function csvEscape(value:unknown):string;export declare function toCsv(rows:Record<string,unknown>[],columns:string[]):string;export declare function toJson(rows:Record<string,unknown>[]):string;export declare function parseCsv(text:string):string[][];

package/dist/utils/csv.js

@@ -1,80 +1 @@
-"use strict";
-/**
- * Minimal RFC 4180-style CSV serialization and parsing, used for table and
- * query export/import. Pure functions with no I/O so they are easy to test.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.csvEscape = csvEscape;
-exports.toCsv = toCsv;
-exports.toJson = toJson;
-exports.parseCsv = parseCsv;
-/** Escape a single CSV field (quote when it contains comma, quote or newline). */
-function csvEscape(value) {
-    const s = value === null || value === undefined ? '' : String(value);
-    if (/[",\r\n]/.test(s))
-        return `"${s.replace(/"/g, '""')}"`;
-    return s;
-}
-/** Serialize rows to CSV with an explicit column order. */
-function toCsv(rows, columns) {
-    const header = columns.map(csvEscape).join(',');
-    const body = rows.map((row) => columns.map((c) => csvEscape(row[c])).join(','));
-    return [header, ...body].join('\r\n');
-}
-/** Serialize rows to JSON (values are expected to be already normalized). */
-function toJson(rows) {
-    return JSON.stringify(rows, null, 2);
-}
-/**
- * Parse CSV text into rows of string fields. Handles quoted fields containing
- * commas, quotes and embedded newlines. Blank lines are skipped.
- */
-function parseCsv(text) {
-    const rows = [];
-    let row = [];
-    let field = '';
-    let inQuotes = false;
-    const src = String(text ?? '');
-    for (let i = 0; i < src.length; i++) {
-        const ch = src[i];
-        if (inQuotes) {
-            if (ch === '"') {
-                if (src[i + 1] === '"') {
-                    field += '"';
-                    i++;
-                }
-                else {
-                    inQuotes = false;
-                }
-            }
-            else {
-                field += ch;
-            }
-        }
-        else if (ch === '"') {
-            inQuotes = true;
-        }
-        else if (ch === ',') {
-            row.push(field);
-            field = '';
-        }
-        else if (ch === '\n') {
-            row.push(field);
-            field = '';
-            if (row.length > 1 || row[0] !== '')
-                rows.push(row);
-            row = [];
-        }
-        else if (ch === '\r') {
-            // Ignore — part of CRLF line endings.
-        }
-        else {
-            field += ch;
-        }
-    }
-    row.push(field);
-    if (row.length > 1 || row[0] !== '')
-        rows.push(row);
-    return rows;
-}
-//# sourceMappingURL=csv.js.map
+function csvEscape(value){const s=null==value?"":String(value);return/[",\r\n]/.test(s)?`"${s.replace(/"/g,'""')}"`:s}Object.defineProperty(exports,"__esModule",{value:!0}),exports.csvEscape=csvEscape,exports.toCsv=function(rows,columns){const header=columns.map(csvEscape).join(","),body=rows.map(row=>columns.map(c=>csvEscape(row[c])).join(","));return[header,...body].join("\r\n")},exports.toJson=function(rows){return JSON.stringify(rows,null,2)},exports.parseCsv=function(text){const rows=[];let row=[],field="",inQuotes=!1;const src=String(text??"");for(let i=0;i<src.length;i++){const ch=src[i];inQuotes?'"'===ch?'"'===src[i+1]?(field+='"',i++):inQuotes=!1:field+=ch:'"'===ch?inQuotes=!0:","===ch?(row.push(field),field=""):"\n"===ch?(row.push(field),field="",(row.length>1||""!==row[0])&&rows.push(row),row=[]):"\r"===ch||(field+=ch)}row.push(field),(row.length>1||""!==row[0])&&rows.push(row);return rows};

package/dist/utils/datatype.d.ts

@@ -1,49 +1 @@
-/**
- * Utilities for rich data type detection, MIME sniffing, hex dump generation,
- * and JSON inspection in AdminDB.
- */
-export interface MimeAnalysis {
-    mime: string;
-    ext: string;
-    isImage: boolean;
-    isText: boolean;
-    isPdf: boolean;
-    isAudio: boolean;
-    isVideo: boolean;
-}
-export interface HexDumpLine {
-    offset: string;
-    hex: string;
-    ascii: string;
-}
-export interface HexDumpResult {
-    lines: HexDumpLine[];
-    totalBytes: number;
-    truncated: boolean;
-}
-export interface BlobMetadata extends MimeAnalysis {
-    size: number;
-    sizeFormatted: string;
-    hexDump?: HexDumpResult;
-    textPreview?: string | null;
-}
-/**
- * Sniff MIME type and file extension from magic bytes of a buffer.
- */
-export declare function sniffMimeType(buf: Uint8Array | Buffer): MimeAnalysis;
-/**
- * Generate formatted 3-column Hex Dump (Offset | Hex Bytes | ASCII).
- */
-export declare function generateHexDump(buf: Uint8Array | Buffer, maxBytes?: number, bytesPerLine?: number): HexDumpResult;
-/**
- * Get comprehensive metadata for a binary buffer or hex string.
- */
-export declare function analyzeBlob(data: Uint8Array | Buffer | string): BlobMetadata;
-/**
- * Detect whether a value is a valid JSON string (Object or Array).
- */
-export declare function isJsonString(value: unknown): boolean;
-/**
- * Parse and pretty format JSON string. Returns null if invalid.
- */
-export declare function formatJsonSafely(value: unknown, indent?: number): string | null;
+export interface MimeAnalysis{mime:string;ext:string;isImage:boolean;isText:boolean;isPdf:boolean;isAudio:boolean;isVideo:boolean;}export interface HexDumpLine{offset:string;hex:string;ascii:string;}export interface HexDumpResult{lines:HexDumpLine[];totalBytes:number;truncated:boolean;}export interface BlobMetadata extends MimeAnalysis{size:number;sizeFormatted:string;hexDump?:HexDumpResult;textPreview?:string|null;}export declare function sniffMimeType(buf:Uint8Array|Buffer):MimeAnalysis;export declare function generateHexDump(buf:Uint8Array|Buffer,maxBytes?:number,bytesPerLine?:number):HexDumpResult;export declare function analyzeBlob(data:Uint8Array|Buffer|string):BlobMetadata;export declare function isJsonString(value:unknown):boolean;export declare function formatJsonSafely(value:unknown,indent?:number):string|null;

package/dist/utils/datatype.js

@@ -1,222 +1 @@
-"use strict";
-/**
- * Utilities for rich data type detection, MIME sniffing, hex dump generation,
- * and JSON inspection in AdminDB.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sniffMimeType = sniffMimeType;
-exports.generateHexDump = generateHexDump;
-exports.analyzeBlob = analyzeBlob;
-exports.isJsonString = isJsonString;
-exports.formatJsonSafely = formatJsonSafely;
-const common_js_1 = require("./common.js");
-/**
- * Sniff MIME type and file extension from magic bytes of a buffer.
- */
-function sniffMimeType(buf) {
-    const len = buf.length;
-    if (len === 0) {
-        return { mime: 'application/octet-stream', ext: 'bin', isImage: false, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // PNG: 89 50 4E 47 0D 0A 1A 0A
-    if (len >= 8 && buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47 && buf[4] === 0x0d && buf[5] === 0x0a && buf[6] === 0x1a && buf[7] === 0x0a) {
-        return { mime: 'image/png', ext: 'png', isImage: true, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // JPEG: FF D8 FF
-    if (len >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff) {
-        return { mime: 'image/jpeg', ext: 'jpg', isImage: true, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // GIF: GIF87a or GIF89a (47 49 46 38 37/39 61)
-    if (len >= 6 && buf[0] === 0x47 && buf[1] === 0x49 && buf[2] === 0x46 && buf[3] === 0x38 && (buf[4] === 0x37 || buf[4] === 0x39) && buf[5] === 0x61) {
-        return { mime: 'image/gif', ext: 'gif', isImage: true, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // WebP: RIFF....WEBP (52 49 46 46 ... 57 45 42 50)
-    if (len >= 12 && buf[0] === 0x52 && buf[1] === 0x49 && buf[2] === 0x46 && buf[3] === 0x46 && buf[8] === 0x57 && buf[9] === 0x45 && buf[10] === 0x42 && buf[11] === 0x50) {
-        return { mime: 'image/webp', ext: 'webp', isImage: true, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // BMP: 42 4D
-    if (len >= 2 && buf[0] === 0x42 && buf[1] === 0x4d) {
-        return { mime: 'image/bmp', ext: 'bmp', isImage: true, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // ICO: 00 00 01 00
-    if (len >= 4 && buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x01 && buf[3] === 0x00) {
-        return { mime: 'image/x-icon', ext: 'ico', isImage: true, isText: false, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // PDF: %PDF (25 50 44 46)
-    if (len >= 4 && buf[0] === 0x25 && buf[1] === 0x50 && buf[2] === 0x44 && buf[3] === 0x46) {
-        return { mime: 'application/pdf', ext: 'pdf', isImage: false, isText: false, isPdf: true, isAudio: false, isVideo: false };
-    }
-    // MP3: ID3 (49 44 33) or Sync 0xFF 0xFB/0xF3/0xF2
-    if (len >= 3 && buf[0] === 0x49 && buf[1] === 0x44 && buf[2] === 0x33) {
-        return { mime: 'audio/mpeg', ext: 'mp3', isImage: false, isText: false, isPdf: false, isAudio: true, isVideo: false };
-    }
-    if (len >= 2 && buf[0] === 0xff && (buf[1] & 0xe0) === 0xe0) {
-        return { mime: 'audio/mpeg', ext: 'mp3', isImage: false, isText: false, isPdf: false, isAudio: true, isVideo: false };
-    }
-    // WAV: RIFF....WAVE
-    if (len >= 12 && buf[0] === 0x52 && buf[1] === 0x49 && buf[2] === 0x46 && buf[3] === 0x46 && buf[8] === 0x57 && buf[9] === 0x41 && buf[10] === 0x56 && buf[11] === 0x45) {
-        return { mime: 'audio/wav', ext: 'wav', isImage: false, isText: false, isPdf: false, isAudio: true, isVideo: false };
-    }
-    // OGG: OggS (4F 67 67 53)
-    if (len >= 4 && buf[0] === 0x4f && buf[1] === 0x67 && buf[2] === 0x67 && buf[3] === 0x53) {
-        return { mime: 'audio/ogg', ext: 'ogg', isImage: false, isText: false, isPdf: false, isAudio: true, isVideo: false };
-    }
-    // MP4 video: ....ftyp (66 74 79 70)
-    if (len >= 8 && buf[4] === 0x66 && buf[5] === 0x74 && buf[6] === 0x79 && buf[7] === 0x70) {
-        return { mime: 'video/mp4', ext: 'mp4', isImage: false, isText: false, isPdf: false, isAudio: false, isVideo: true };
-    }
-    // WebM: 1A 45 DF A3
-    if (len >= 4 && buf[0] === 0x1a && buf[1] === 0x45 && buf[2] === 0xdf && buf[3] === 0xa3) {
-        return { mime: 'video/webm', ext: 'webm', isImage: false, isText: false, isPdf: false, isAudio: false, isVideo: true };
-    }
-    // Check for UTF-8 Text / SVG / JSON
-    const sampleLen = Math.min(len, 1024);
-    const sample = Buffer.from(buf.subarray(0, sampleLen)).toString('utf8');
-    const trimmed = sample.trim();
-    // SVG: starts with <?xml or <svg
-    if (trimmed.startsWith('<svg') || (trimmed.startsWith('<?xml') && trimmed.includes('<svg'))) {
-        return { mime: 'image/svg+xml', ext: 'svg', isImage: true, isText: true, isPdf: false, isAudio: false, isVideo: false };
-    }
-    // JSON
-    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
-        try {
-            JSON.parse(sample);
-            return { mime: 'application/json', ext: 'json', isImage: false, isText: true, isPdf: false, isAudio: false, isVideo: false };
-        }
-        catch {
-            /* not valid json in sample */
-        }
-    }
-    // Check if buffer contains mostly printable ASCII / UTF-8
-    let nonPrintable = 0;
-    for (let i = 0; i < sampleLen; i++) {
-        const byte = buf[i];
-        if (byte === 0 || (byte < 7 && byte !== 9 && byte !== 10 && byte !== 13)) {
-            nonPrintable++;
-        }
-    }
-    if (nonPrintable === 0) {
-        return { mime: 'text/plain; charset=utf-8', ext: 'txt', isImage: false, isText: true, isPdf: false, isAudio: false, isVideo: false };
-    }
-    return { mime: 'application/octet-stream', ext: 'bin', isImage: false, isText: false, isPdf: false, isAudio: false, isVideo: false };
-}
-/**
- * Generate formatted 3-column Hex Dump (Offset | Hex Bytes | ASCII).
- */
-function generateHexDump(buf, maxBytes = 4096, bytesPerLine = 16) {
-    const totalBytes = buf.length;
-    const limit = Math.min(totalBytes, maxBytes);
-    const truncated = totalBytes > maxBytes;
-    const lines = [];
-    for (let i = 0; i < limit; i += bytesPerLine) {
-        const offset = i.toString(16).padStart(8, '0');
-        const chunk = buf.subarray(i, Math.min(i + bytesPerLine, limit));
-        const hexParts = [];
-        let asciiPart = '';
-        for (let j = 0; j < bytesPerLine; j++) {
-            if (j < chunk.length) {
-                const byte = chunk[j];
-                hexParts.push(byte.toString(16).padStart(2, '0'));
-                // Printable ASCII between 32 (space) and 126 (~)
-                asciiPart += (byte >= 32 && byte <= 126) ? String.fromCharCode(byte) : '.';
-            }
-            else {
-                hexParts.push('  ');
-                asciiPart += ' ';
-            }
-        }
-        // Insert extra space in the middle for readability (e.g. after 8 bytes)
-        const mid = Math.floor(bytesPerLine / 2);
-        const hexFormatted = hexParts.slice(0, mid).join(' ') + '  ' + hexParts.slice(mid).join(' ');
-        lines.push({
-            offset,
-            hex: hexFormatted,
-            ascii: asciiPart,
-        });
-    }
-    return { lines, totalBytes, truncated };
-}
-/**
- * Get comprehensive metadata for a binary buffer or hex string.
- */
-function analyzeBlob(data) {
-    let buf;
-    if (typeof data === 'string') {
-        if (data.startsWith('0x') || data.startsWith('0X')) {
-            buf = Buffer.from(data.slice(2), 'hex');
-        }
-        else {
-            buf = Buffer.from(data, 'utf8');
-        }
-    }
-    else {
-        buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
-    }
-    const analysis = sniffMimeType(buf);
-    let textPreview = null;
-    if (analysis.isText || buf.length < 2048) {
-        try {
-            const txt = buf.toString('utf8');
-            // If it looks like valid text
-            if (!/[\x00-\x08\x0E-\x1F]/.test(txt.slice(0, 512))) {
-                textPreview = txt.slice(0, 4000);
-            }
-        }
-        catch {
-            /* ignore */
-        }
-    }
-    return {
-        ...analysis,
-        size: buf.length,
-        sizeFormatted: (0, common_js_1.formatBytes)(buf.length),
-        hexDump: generateHexDump(buf),
-        textPreview,
-    };
-}
-/**
- * Detect whether a value is a valid JSON string (Object or Array).
- */
-function isJsonString(value) {
-    if (typeof value !== 'string')
-        return false;
-    const trimmed = value.trim();
-    if (!trimmed)
-        return false;
-    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
-        try {
-            JSON.parse(trimmed);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    return false;
-}
-/**
- * Parse and pretty format JSON string. Returns null if invalid.
- */
-function formatJsonSafely(value, indent = 2) {
-    if (value === null || value === undefined)
-        return null;
-    if (typeof value === 'object') {
-        try {
-            return JSON.stringify(value, null, indent);
-        }
-        catch {
-            return null;
-        }
-    }
-    if (typeof value === 'string') {
-        try {
-            const parsed = JSON.parse(value);
-            return JSON.stringify(parsed, null, indent);
-        }
-        catch {
-            return null;
-        }
-    }
-    return null;
-}
-//# sourceMappingURL=datatype.js.map
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.sniffMimeType=sniffMimeType,exports.generateHexDump=generateHexDump,exports.analyzeBlob=function(data){let buf;buf="string"==typeof data?data.startsWith("0x")||data.startsWith("0X")?Buffer.from(data.slice(2),"hex"):Buffer.from(data,"utf8"):Buffer.isBuffer(data)?data:Buffer.from(data);const analysis=sniffMimeType(buf);let textPreview=null;if(analysis.isText||buf.length<2048)try{const txt=buf.toString("utf8");/[\x00-\x08\x0E-\x1F]/.test(txt.slice(0,512))||(textPreview=txt.slice(0,4e3))}catch{}return{...analysis,size:buf.length,sizeFormatted:(0,common_js_1.formatBytes)(buf.length),hexDump:generateHexDump(buf),textPreview:textPreview}},exports.isJsonString=function(value){if("string"!=typeof value)return!1;const trimmed=value.trim();if(!trimmed)return!1;if(trimmed.startsWith("{")&&trimmed.endsWith("}")||trimmed.startsWith("[")&&trimmed.endsWith("]"))try{return JSON.parse(trimmed),!0}catch{return!1}return!1},exports.formatJsonSafely=function(value,indent=2){if(null==value)return null;if("object"==typeof value)try{return JSON.stringify(value,null,indent)}catch{return null}if("string"==typeof value)try{const parsed=JSON.parse(value);return JSON.stringify(parsed,null,indent)}catch{return null}return null};const common_js_1=require("./common.js");function sniffMimeType(buf){const len=buf.length;if(0===len)return{mime:"application/octet-stream",ext:"bin",isImage:!1,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=8&&137===buf[0]&&80===buf[1]&&78===buf[2]&&71===buf[3]&&13===buf[4]&&10===buf[5]&&26===buf[6]&&10===buf[7])return{mime:"image/png",ext:"png",isImage:!0,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=3&&255===buf[0]&&216===buf[1]&&255===buf[2])return{mime:"image/jpeg",ext:"jpg",isImage:!0,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=6&&71===buf[0]&&73===buf[1]&&70===buf[2]&&56===buf[3]&&(55===buf[4]||57===buf[4])&&97===buf[5])return{mime:"image/gif",ext:"gif",isImage:!0,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=12&&82===buf[0]&&73===buf[1]&&70===buf[2]&&70===buf[3]&&87===buf[8]&&69===buf[9]&&66===buf[10]&&80===buf[11])return{mime:"image/webp",ext:"webp",isImage:!0,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=2&&66===buf[0]&&77===buf[1])return{mime:"image/bmp",ext:"bmp",isImage:!0,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=4&&0===buf[0]&&0===buf[1]&&1===buf[2]&&0===buf[3])return{mime:"image/x-icon",ext:"ico",isImage:!0,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1};if(len>=4&&37===buf[0]&&80===buf[1]&&68===buf[2]&&70===buf[3])return{mime:"application/pdf",ext:"pdf",isImage:!1,isText:!1,isPdf:!0,isAudio:!1,isVideo:!1};if(len>=3&&73===buf[0]&&68===buf[1]&&51===buf[2])return{mime:"audio/mpeg",ext:"mp3",isImage:!1,isText:!1,isPdf:!1,isAudio:!0,isVideo:!1};if(len>=2&&255===buf[0]&&!(224&~buf[1]))return{mime:"audio/mpeg",ext:"mp3",isImage:!1,isText:!1,isPdf:!1,isAudio:!0,isVideo:!1};if(len>=12&&82===buf[0]&&73===buf[1]&&70===buf[2]&&70===buf[3]&&87===buf[8]&&65===buf[9]&&86===buf[10]&&69===buf[11])return{mime:"audio/wav",ext:"wav",isImage:!1,isText:!1,isPdf:!1,isAudio:!0,isVideo:!1};if(len>=4&&79===buf[0]&&103===buf[1]&&103===buf[2]&&83===buf[3])return{mime:"audio/ogg",ext:"ogg",isImage:!1,isText:!1,isPdf:!1,isAudio:!0,isVideo:!1};if(len>=8&&102===buf[4]&&116===buf[5]&&121===buf[6]&&112===buf[7])return{mime:"video/mp4",ext:"mp4",isImage:!1,isText:!1,isPdf:!1,isAudio:!1,isVideo:!0};if(len>=4&&26===buf[0]&&69===buf[1]&&223===buf[2]&&163===buf[3])return{mime:"video/webm",ext:"webm",isImage:!1,isText:!1,isPdf:!1,isAudio:!1,isVideo:!0};const sampleLen=Math.min(len,1024),sample=Buffer.from(buf.subarray(0,sampleLen)).toString("utf8"),trimmed=sample.trim();if(trimmed.startsWith("<svg")||trimmed.startsWith("<?xml")&&trimmed.includes("<svg"))return{mime:"image/svg+xml",ext:"svg",isImage:!0,isText:!0,isPdf:!1,isAudio:!1,isVideo:!1};if(trimmed.startsWith("{")&&trimmed.endsWith("}")||trimmed.startsWith("[")&&trimmed.endsWith("]"))try{return JSON.parse(sample),{mime:"application/json",ext:"json",isImage:!1,isText:!0,isPdf:!1,isAudio:!1,isVideo:!1}}catch{}let nonPrintable=0;for(let i=0;i<sampleLen;i++){const byte=buf[i];(0===byte||byte<7&&9!==byte&&10!==byte&&13!==byte)&&nonPrintable++}return 0===nonPrintable?{mime:"text/plain; charset=utf-8",ext:"txt",isImage:!1,isText:!0,isPdf:!1,isAudio:!1,isVideo:!1}:{mime:"application/octet-stream",ext:"bin",isImage:!1,isText:!1,isPdf:!1,isAudio:!1,isVideo:!1}}function generateHexDump(buf,maxBytes=4096,bytesPerLine=16){const totalBytes=buf.length,limit=Math.min(totalBytes,maxBytes),truncated=totalBytes>maxBytes,lines=[];for(let i=0;i<limit;i+=bytesPerLine){const offset=i.toString(16).padStart(8,"0"),chunk=buf.subarray(i,Math.min(i+bytesPerLine,limit)),hexParts=[];let asciiPart="";for(let j=0;j<bytesPerLine;j++)if(j<chunk.length){const byte=chunk[j];hexParts.push(byte.toString(16).padStart(2,"0")),asciiPart+=byte>=32&&byte<=126?String.fromCharCode(byte):"."}else hexParts.push("  "),asciiPart+=" ";const mid=Math.floor(bytesPerLine/2),hexFormatted=hexParts.slice(0,mid).join(" ")+"  "+hexParts.slice(mid).join(" ");lines.push({offset:offset,hex:hexFormatted,ascii:asciiPart})}return{lines:lines,totalBytes:totalBytes,truncated:truncated}}

package/dist/utils/icons.d.ts

@@ -1,11 +1 @@
-/**
- * SVG Icons registry for AdminDB.
- *
- * Centralizes all SVG icons in a single module, providing consistent
- * styling, clean templates, and zero inline SVG duplication.
- */
-export declare const ICONS: Record<string, string>;
-/**
- * Renders an SVG icon by name with optional custom CSS classes.
- */
-export declare function renderIcon(name: string, customClass?: string): string;
+export declare const ICONS:Record<string,string>;export declare function renderIcon(name:string,customClass?:string):string;