bsprof-cli 1.0.0

package/dist/parser/types.d.ts

@@ -0,0 +1,202 @@
+export interface BsprofHeader {
+    majorVersion: number;
+    minorVersion: number;
+    patchLevel: number;
+    headerSize: number;
+    requestedSampleRatio: number;
+    actualSampleRatio: number;
+    lineSpecificData: boolean;
+    memoryOperations: boolean;
+    timestampStart: bigint;
+    targetName: string;
+    supplementalInfo: string;
+    targetVersion: string;
+    deviceVendor: string;
+    deviceModel: string;
+    deviceFirmware: string;
+}
+export interface PathElement {
+    callingId: number;
+    modId?: number;
+    fileStrId: number;
+    funcStrId: number;
+    lineNumber: number;
+    lineOff?: number;
+    root: boolean;
+}
+export interface ModuleEntry {
+    nameStrId: number;
+}
+export interface MemoryRecord {
+    allocCount: number;
+    freeCount: number;
+    allocBytes: number;
+    freeBytes: number;
+}
+export interface CpuRecord {
+    cpuSelf: number;
+    wallSelf: number;
+    callCount?: number;
+}
+export interface ParseResult {
+    count: number;
+    errors: number;
+    memoryByPE: Map<number, MemoryRecord>;
+    cpuByPE: Map<number, CpuRecord>;
+}
+export interface ParsedProfile {
+    header: BsprofHeader;
+    strings: Map<number, string>;
+    modules: Map<number, ModuleEntry>;
+    pathElements: Map<number, PathElement>;
+    parseResult: ParseResult;
+    timestampEnd?: bigint;
+    fileSize: number;
+}
+export type MemorySortField = 'retained' | 'allocated' | 'allocCount';
+export type CpuSortField = 'cpuSelf' | 'wallSelf' | 'callCount';
+export interface AnalysisOptions {
+    top: number;
+    sortBy?: string;
+    filterModule?: string;
+    excludeModule?: string;
+    filterFile?: string;
+    threshold: number;
+}
+export interface ModuleStats {
+    module: string;
+    allocBytes: number;
+    freeBytes: number;
+    retainedBytes: number;
+    allocCount: number;
+    freeCount: number;
+}
+export interface FileStats {
+    file: string;
+    module: string;
+    allocBytes: number;
+    freeBytes: number;
+    retainedBytes: number;
+    allocCount: number;
+    freeCount: number;
+}
+export interface FunctionStats {
+    function: string;
+    file: string;
+    module: string;
+    allocBytes: number;
+    freeBytes: number;
+    retainedBytes: number;
+    allocCount: number;
+    freeCount: number;
+    cpuSelf: number;
+    wallSelf: number;
+    callCount: number;
+    callStack?: string[];
+}
+export interface HeaderInfo {
+    targetName: string;
+    targetVersion: string;
+    device: string;
+    firmware: string;
+    duration: number;
+    fileSize: number;
+    formatVersion: string;
+    features: string[];
+}
+export interface ParseStats {
+    entries: number;
+    errors: number;
+    strings: number;
+    modules: number;
+    pathElements: number;
+}
+export interface MemorySummary {
+    totalAllocBytes: number;
+    totalFreeBytes: number;
+    totalRetainedBytes: number;
+    totalAllocCount: number;
+    totalFreeCount: number;
+    parseStats: ParseStats;
+}
+export interface MemoryReport {
+    header: HeaderInfo;
+    summary: MemorySummary;
+    byModule: ModuleStats[];
+    byFile: FileStats[];
+    byFunction: FunctionStats[];
+}
+export interface CpuSummary {
+    totalCpuTime: number;
+    totalWallTime: number;
+    totalCallCount: number;
+    parseStats: ParseStats;
+}
+export interface CpuReport {
+    header: HeaderInfo;
+    summary: CpuSummary;
+    byFunction: FunctionStats[];
+}
+export interface FullReport {
+    header: HeaderInfo;
+    memory: MemoryReport;
+    cpu: CpuReport;
+}
+export interface SummaryReport {
+    header: HeaderInfo;
+    parseStats: ParseStats;
+    topMemoryLeaks: FunctionStats[];
+    topCpuConsumers: FunctionStats[];
+    moduleOverview: ModuleStats[];
+}
+export interface FunctionDelta {
+    function: string;
+    file: string;
+    module: string;
+    retainedBefore: number;
+    retainedAfter: number;
+    delta: number;
+    cpuBefore?: number;
+    cpuAfter?: number;
+    cpuDelta?: number;
+}
+export interface DiffReport {
+    before: {
+        file: string;
+        targetVersion: string;
+    };
+    after: {
+        file: string;
+        targetVersion: string;
+    };
+    memoryDelta: {
+        totalRetainedBefore: number;
+        totalRetainedAfter: number;
+        totalRetainedDelta: number;
+        regressions: FunctionDelta[];
+        improvements: FunctionDelta[];
+        newLeaks: string[];
+        resolvedLeaks: string[];
+    };
+    cpuDelta?: {
+        totalCpuBefore: number;
+        totalCpuAfter: number;
+        totalCpuDelta: number;
+        regressions: FunctionDelta[];
+        improvements: FunctionDelta[];
+    };
+}
+export interface ChromeTraceEvent {
+    name: string;
+    cat: string;
+    ph: string;
+    ts: number;
+    dur?: number;
+    pid: number;
+    tid: number;
+    args?: Record<string, unknown>;
+}
+export type OutputFormat = 'text' | 'json' | 'markdown';
+export type ExportFormat = 'chrome-trace' | 'csv' | 'json';
+export type AnalysisMode = 'memory' | 'cpu' | 'full' | 'summary';
+//# sourceMappingURL=types.d.ts.map

package/dist/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/parser/varint.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Buffer reader with varint (LEB128) decoding support for the .bsprof binary format.
+ * Varints use unsigned LEB128 encoding with up to 70-bit shift.
+ */
+export declare class BufferReader {
+    pos: number;
+    private buf;
+    constructor(buffer: Buffer, offset?: number);
+    get length(): number;
+    get remaining(): number;
+    readVarint(): bigint;
+    /** Read varint and return as Number (safe for uint32 values) */
+    vi(): number;
+    /** Read varint and return as BigInt (for uint64 values) */
+    vi64(): bigint;
+    readFloat32LE(): number;
+    /** Read a null-terminated UTF-8 string */
+    readUtf8z(): string;
+    readAscii(length: number): string;
+}
+//# sourceMappingURL=varint.d.ts.map

package/dist/parser/varint.js

@@ -0,0 +1,60 @@
+/**
+ * Buffer reader with varint (LEB128) decoding support for the .bsprof binary format.
+ * Varints use unsigned LEB128 encoding with up to 70-bit shift.
+ */
+export class BufferReader {
+    pos;
+    buf;
+    constructor(buffer, offset = 0) {
+        this.buf = buffer;
+        this.pos = offset;
+    }
+    get length() {
+        return this.buf.length;
+    }
+    get remaining() {
+        return this.buf.length - this.pos;
+    }
+    readVarint() {
+        let result = 0n;
+        let shift = 0n;
+        while (this.pos < this.buf.length) {
+            const byte = this.buf[this.pos++];
+            result |= BigInt(byte & 0x7f) << shift;
+            if ((byte & 0x80) === 0)
+                break;
+            shift += 7n;
+            if (shift > 70n)
+                throw new Error(`Varint overflow at position ${this.pos}`);
+        }
+        return result;
+    }
+    /** Read varint and return as Number (safe for uint32 values) */
+    vi() {
+        return Number(this.readVarint());
+    }
+    /** Read varint and return as BigInt (for uint64 values) */
+    vi64() {
+        return this.readVarint();
+    }
+    readFloat32LE() {
+        const val = this.buf.readFloatLE(this.pos);
+        this.pos += 4;
+        return val;
+    }
+    /** Read a null-terminated UTF-8 string */
+    readUtf8z() {
+        const start = this.pos;
+        while (this.pos < this.buf.length && this.buf[this.pos] !== 0)
+            this.pos++;
+        const str = this.buf.toString('utf8', start, this.pos);
+        this.pos++;
+        return str;
+    }
+    readAscii(length) {
+        const str = this.buf.toString('ascii', this.pos, this.pos + length);
+        this.pos += length;
+        return str;
+    }
+}
+//# sourceMappingURL=varint.js.map

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "bsprof-cli",
+  "version": "1.0.0",
+  "description": "CLI tool for parsing and analyzing BrightScript Profiler (.bsprof) files",
+  "type": "module",
+  "main": "./dist/lib.js",
+  "types": "./dist/lib.d.ts",
+  "bin": {
+    "bsprof": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/lib.js",
+      "types": "./dist/lib.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "roku",
+    "brightscript",
+    "profiler",
+    "bsprof",
+    "performance",
+    "memory",
+    "cpu"
+  ],
+  "author": "Juan Carlos Joya Carvajal",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jack1590/roku-bsprof-cli.git"
+  },
+  "homepage": "https://github.com/jack1590/roku-bsprof-cli#readme",
+  "bugs": {
+    "url": "https://github.com/jack1590/roku-bsprof-cli/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "minimatch": "^10.2.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2"
+  }
+}