@brightchain/brightchain-lib 0.1.0

package/src/lib/cpus/x86Cpu.js

@@ -0,0 +1,89 @@
+// https://gist.githubusercontent.com/tadeuzagallo/3853299f033bf9b746e4/raw/43467ba1bee7251e1b653123f29e6ff5643a0735/x86.js
+// https://gist.github.com/tadeuzagallo/3853299f033bf9b746e4
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X86Cpu = void 0;
+const cpuRegisters_1 = require("../enumerations/cpuRegisters");
+const instructionTables_1 = require("./instructionTables");
+class X86Cpu {
+    constructor(memory, registers, pc) {
+        this.NG = false;
+        this.NZ = false;
+        this.Interrupts = new Map();
+        this.Stack = new Uint32Array(X86Cpu.StackSize);
+        if (memory instanceof Uint8Array) {
+            this.Program = memory;
+        }
+        else if (memory instanceof ArrayBuffer) {
+            this.Program = new Uint8Array(memory);
+        }
+        else {
+            this.Program = new Uint8Array(memory);
+        }
+        if (registers instanceof Uint32Array) {
+            this.Registers = registers;
+        }
+        else {
+            this.Registers = new Uint32Array(registers);
+        }
+        this.PC = pc;
+        this.Instructions = (0, instructionTables_1.buildInstructionArray)(this);
+        this.Syscalls = (0, instructionTables_1.syscallInstructions)(this);
+    }
+    read(size) {
+        let value;
+        switch (size) {
+            case 1:
+                value = this.Program[this.PC];
+                break;
+            case 2:
+                value = (this.Program[this.PC + 1] << 8) | this.Program[this.PC];
+                break;
+            case 4:
+                value =
+                    (this.Program[this.PC + 3] << 24) |
+                        (this.Program[this.PC + 2] << 16) |
+                        (this.Program[this.PC + 1] << 8) |
+                        this.Program[this.PC];
+                break;
+            case -1:
+                // http://blog.vjeux.com/2013/javascript/conversion-from-uint8-to-int8-x-24.html
+                value = (this.Program[this.PC] << 24) >> 24;
+                break;
+            default:
+                throw new Error('Invalid read size');
+        }
+        this.PC += Math.abs(size); // & 127; // abs
+        return value;
+    }
+    pop() {
+        return this.Stack[this.Registers[cpuRegisters_1.CpuRegisters.ESP]++];
+    }
+    push(value) {
+        this.Stack[--this.Registers[cpuRegisters_1.CpuRegisters.ESP]] = value;
+    }
+    static new(memory, registers, pc = -1) {
+        const cpu = new X86Cpu(memory, registers, pc);
+        cpu.Registers[cpuRegisters_1.CpuRegisters.ESP] = 1023;
+        return cpu;
+    }
+    run() {
+        let op;
+        while (this.PC !== -1 && (op = this.read(1))) {
+            this.Instructions[op]();
+        }
+    }
+    static run(memory, registers, pc) {
+        const cpu = new X86Cpu(memory, registers, pc);
+        cpu.Registers[cpuRegisters_1.CpuRegisters.ESP] = 1023;
+        let op;
+        while (cpu.PC !== -1 && (op = cpu.read(1))) {
+            cpu.Instructions[op]();
+        }
+        return cpu;
+    }
+}
+exports.X86Cpu = X86Cpu;
+X86Cpu.StackSize = 1024;
+X86Cpu.RegisterCount = 8;
+//# sourceMappingURL=x86Cpu.js.map

package/src/lib/cpus/x86Cpu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x86Cpu.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/cpus/x86Cpu.ts"],"names":[],"mappings":"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"}

package/src/lib/currencyCode.d.ts

@@ -0,0 +1,8 @@
+export declare class CurrencyCode {
+    private _value;
+    get value(): string;
+    set value(value: string);
+    static get values(): string[];
+    constructor(value?: string);
+}
+//# sourceMappingURL=currencyCode.d.ts.map

package/src/lib/currencyCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencyCode.d.ts","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/currencyCode.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA+B;IAC7C,IAAW,KAAK,IAAI,MAAM,CAEzB;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED,WAAkB,MAAM,IAAI,MAAM,EAAE,CAEnC;gBAEW,KAAK,GAAE,MAA4B;CAGhD"}

package/src/lib/currencyCode.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencyCode = void 0;
+const currency_codes_1 = require("currency-codes");
+const sharedTypes_1 = require("./sharedTypes");
+class CurrencyCode {
+    get value() {
+        return this._value;
+    }
+    set value(value) {
+        if (!CurrencyCode.values.includes(value)) {
+            throw new Error('Invalid currency code');
+        }
+        this._value = value;
+    }
+    static get values() {
+        return (0, currency_codes_1.codes)();
+    }
+    constructor(value = sharedTypes_1.DefaultCurrencyCode) {
+        this._value = sharedTypes_1.DefaultCurrencyCode;
+        this.value = value;
+    }
+}
+exports.CurrencyCode = CurrencyCode;
+//# sourceMappingURL=currencyCode.js.map

package/src/lib/currencyCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencyCode.js","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/currencyCode.ts"],"names":[],"mappings":";;;AAAA,mDAAuC;AACvC,+CAAoD;AAEpD,MAAa,YAAY;IAEvB,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAW,KAAK,CAAC,KAAa;QAC5B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEM,MAAM,KAAK,MAAM;QACtB,OAAO,IAAA,sBAAK,GAAE,CAAC;IACjB,CAAC;IAED,YAAY,QAAgB,iCAAmB;QAfvC,WAAM,GAAW,iCAAmB,CAAC;QAgB3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAnBD,oCAmBC"}

package/src/lib/debug/HanselGretelBreadCrumbTrail.d.ts

@@ -0,0 +1,30 @@
+import { BreadCrumbTraceLevel } from '../enumerations/breadCrumbTraceLevel';
+import { IBreadCrumbContext } from '../interfaces/breadCrumbContext';
+import { IBreadCrumbTrace } from '../interfaces/breadCrumbTrace';
+export declare class HanselGretelBreadCrumbTrail implements IBreadCrumbTrace {
+    readonly context: IBreadCrumbContext;
+    readonly traceLevel: BreadCrumbTraceLevel;
+    readonly traceLog: Array<IBreadCrumbTrace>;
+    readonly date: Date;
+    readonly functionName: string;
+    readonly functionArgs: ReadonlyArray<unknown>;
+    readonly emitConsoleOnAdd: boolean;
+    readonly maxEntries: number;
+    constructor(context: IBreadCrumbContext, emitConsoleOnAdd: boolean, traceLog: Array<IBreadCrumbTrace>, functionName: string, traceLevel: BreadCrumbTraceLevel, maxEntries: number, ...args: ReadonlyArray<unknown>);
+    private addLogEntry;
+    get IBreadCrumbTrace(): IBreadCrumbTrace;
+    static addCrumb(context: IBreadCrumbContext, emitConsoleOnAdd: boolean, traceLog: Array<IBreadCrumbTrace>, functionName: string, traceLevel: BreadCrumbTraceLevel, maxEntries: number, ...args: Array<unknown>): HanselGretelBreadCrumbTrail;
+    addCrumb(...args: Array<unknown>): HanselGretelBreadCrumbTrail;
+    addCrumbAsync(asyncOperation: Promise<any>, ...args: Array<unknown>): Promise<HanselGretelBreadCrumbTrail>;
+    forkAndAddCrumb(functionName: string, ...args: Array<unknown>): HanselGretelBreadCrumbTrail;
+    addCrumbWithCallback(doCallback: (crumbResult: HanselGretelBreadCrumbTrail) => HanselGretelBreadCrumbTrail, ...args: Array<unknown>): HanselGretelBreadCrumbTrail;
+    forkAndAddCrumbWithCallback(functionName: string, doCallback: (crumbResult: HanselGretelBreadCrumbTrail) => HanselGretelBreadCrumbTrail, ...args: Array<unknown>): HanselGretelBreadCrumbTrail;
+    static IBreadCrumbTrace(trace: IBreadCrumbTrace): IBreadCrumbTrace;
+    clearTrace(): void;
+    pruneOldEntries(maxAge: number): void;
+    exportTrace(format: 'json' | 'csv'): string;
+    private formatAsCSV;
+    private isEqual;
+    findTraces(criteria: Partial<IBreadCrumbTrace>): Array<IBreadCrumbTrace>;
+}
+//# sourceMappingURL=HanselGretelBreadCrumbTrail.d.ts.map

package/src/lib/debug/HanselGretelBreadCrumbTrail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HanselGretelBreadCrumbTrail.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/debug/HanselGretelBreadCrumbTrail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,UAAU,EAAE,oBAAoB,CAAC;IACjD,SAAgB,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAClD,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACrD,SAAgB,gBAAgB,EAAE,OAAO,CAAC;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEjC,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,OAAO,EACzB,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,EACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,oBAAoB,EAChC,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC;IAYjC,OAAO,CAAC,WAAW;IAsBnB,IAAW,gBAAgB,IAAI,gBAAgB,CAM9C;WACa,QAAQ,CACpB,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,OAAO,EACzB,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,EACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,oBAAoB,EAChC,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GACtB,2BAA2B;IAWvB,QAAQ,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,2BAA2B;IAWxD,aAAa,CACxB,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,EAC5B,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GACtB,OAAO,CAAC,2BAA2B,CAAC;IAShC,eAAe,CACpB,YAAY,EAAE,MAAM,EACpB,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GACtB,2BAA2B;IAWvB,oBAAoB,CACzB,UAAU,EAAE,CACV,WAAW,EAAE,2BAA2B,KACrC,2BAA2B,EAChC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GACtB,2BAA2B;IAIvB,2BAA2B,CAChC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,CACV,WAAW,EAAE,2BAA2B,KACrC,2BAA2B,EAChC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GACtB,2BAA2B;WAIhB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB;IAGlE,UAAU,IAAI,IAAI;IAIlB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM;IAUlD,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,OAAO;IA8BR,UAAU,CACf,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,KAAK,CAAC,gBAAgB,CAAC;CAW3B"}

package/src/lib/debug/HanselGretelBreadCrumbTrail.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HanselGretelBreadCrumbTrail = void 0;
+class HanselGretelBreadCrumbTrail {
+    constructor(context, emitConsoleOnAdd, traceLog, functionName, traceLevel, maxEntries, ...args) {
+        this.date = new Date();
+        this.context = context;
+        this.functionName = functionName;
+        this.functionArgs = args;
+        this.traceLog = traceLog;
+        this.emitConsoleOnAdd = emitConsoleOnAdd;
+        this.traceLevel = traceLevel;
+        this.maxEntries = maxEntries;
+        this.addLogEntry();
+    }
+    addLogEntry() {
+        const breadCrumb = this.IBreadCrumbTrace;
+        if (this.traceLog.length >= this.maxEntries) {
+            this.traceLog.shift(); // Remove oldest entry
+        }
+        this.traceLog.push(breadCrumb);
+        if (this.emitConsoleOnAdd) {
+            console.log(JSON.stringify({
+                timestamp: this.date.toISOString(),
+                level: this.traceLevel,
+                function: this.functionName,
+                args: this.functionArgs,
+                context: this.context,
+            }, null, 2));
+        }
+    }
+    get IBreadCrumbTrace() {
+        return {
+            date: this.date,
+            functionName: this.functionName,
+            functionArgs: this.functionArgs,
+        };
+    }
+    static addCrumb(context, emitConsoleOnAdd, traceLog, functionName, traceLevel, maxEntries, ...args) {
+        return new HanselGretelBreadCrumbTrail(context, emitConsoleOnAdd, traceLog, functionName, traceLevel, maxEntries, ...args);
+    }
+    addCrumb(...args) {
+        return new HanselGretelBreadCrumbTrail(this.context, this.emitConsoleOnAdd, this.traceLog, this.functionName, this.traceLevel, this.maxEntries, ...args);
+    }
+    async addCrumbAsync(asyncOperation, ...args) {
+        const startCrumb = this.addCrumb('start', ...args);
+        try {
+            const result = await asyncOperation;
+            return startCrumb.addCrumb('complete', result);
+        }
+        catch (error) {
+            return startCrumb.addCrumb('error', error);
+        }
+    }
+    forkAndAddCrumb(functionName, ...args) {
+        return new HanselGretelBreadCrumbTrail(this.context, this.emitConsoleOnAdd, this.traceLog, [this.functionName, functionName].join('>'), this.traceLevel, this.maxEntries, ...args);
+    }
+    addCrumbWithCallback(doCallback, ...args) {
+        const newCrumb = this.addCrumb(...args);
+        return doCallback(newCrumb);
+    }
+    forkAndAddCrumbWithCallback(functionName, doCallback, ...args) {
+        const newCrumb = this.forkAndAddCrumb(functionName, ...args);
+        return doCallback(newCrumb);
+    }
+    static IBreadCrumbTrace(trace) {
+        return trace;
+    }
+    clearTrace() {
+        this.traceLog.length = 0;
+    }
+    pruneOldEntries(maxAge) {
+        const now = new Date();
+        // Iterate backwards to avoid issues with index shifting when removing elements
+        for (let i = this.traceLog.length - 1; i >= 0; i--) {
+            if (now.getTime() - this.traceLog[i].date.getTime() > maxAge) {
+                this.traceLog.splice(i, 1);
+            }
+        }
+    }
+    exportTrace(format) {
+        switch (format) {
+            case 'json':
+                return JSON.stringify(this.traceLog, null, 2);
+            case 'csv':
+                return this.formatAsCSV();
+            default:
+                throw new Error('Unsupported format');
+        }
+    }
+    formatAsCSV() {
+        const headers = Object.keys(this.traceLog[0]).join(',');
+        const rows = this.traceLog
+            .map((trace) => Object.values(trace).join(','))
+            .join('\n');
+        return `${headers}\n${rows}`;
+    }
+    isEqual(value, other) {
+        if (value === other) {
+            return true;
+        }
+        if (typeof value !== 'object' ||
+            value === null ||
+            typeof other !== 'object' ||
+            other === null) {
+            return false;
+        }
+        const keysA = Object.keys(value);
+        const keysB = Object.keys(other);
+        if (keysA.length !== keysB.length) {
+            return false;
+        }
+        for (const key of keysA) {
+            if (!keysB.includes(key) || !this.isEqual(value[key], other[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    findTraces(criteria) {
+        return this.traceLog.filter((trace) => Object.entries(criteria).every(([key, value]) => {
+            const traceValue = trace[key];
+            if (Array.isArray(traceValue)) {
+                return this.isEqual(traceValue, value);
+            }
+            return traceValue === value;
+        }));
+    }
+}
+exports.HanselGretelBreadCrumbTrail = HanselGretelBreadCrumbTrail;
+//# sourceMappingURL=HanselGretelBreadCrumbTrail.js.map

package/src/lib/debug/HanselGretelBreadCrumbTrail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HanselGretelBreadCrumbTrail.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/debug/HanselGretelBreadCrumbTrail.ts"],"names":[],"mappings":"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"}

package/src/lib/debug/index.d.ts

@@ -0,0 +1,2 @@
+export * from './HanselGretelBreadCrumbTrail';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/debug/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/src/lib/debug/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./HanselGretelBreadCrumbTrail"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/debug/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C"}

package/src/lib/documents/base/document.d.ts

@@ -0,0 +1,52 @@
+import { IHydrationSchema, IOperationalFactory, IPrivateDataProvider } from '../../interfaces/document/base';
+import { BlockService } from '../../services/blockService';
+import { MemberCblService } from '../../services/member/memberCblService';
+import { InstanceMethods, SchemaDefinition, SchemaType, StaticMethods } from '../../sharedTypes';
+/**
+ * Unified Document base class combining schema validation, serialization, and convertible patterns
+ * Built for BrightChain's owner-free filesystem blockstore
+ */
+export declare class Document<T> {
+    private data;
+    private schema?;
+    private instanceMethods;
+    private staticMethods;
+    protected static blockService: BlockService | undefined;
+    private _dirty;
+    private _deleted;
+    constructor(data: Partial<T>, schema?: SchemaDefinition<T>, instanceMethods?: InstanceMethods<T>, staticMethods?: StaticMethods<T>);
+    static initialize(blockService: BlockService, _memberService?: MemberCblService): void;
+    applyDefaults(data: Partial<T>): T;
+    validateType(value: unknown, type: SchemaType): boolean;
+    validateSchema(data: Partial<T> | undefined): void;
+    get<K extends keyof T>(key: K): T[K];
+    set<K extends keyof T>(key: K, value: T[K] | undefined): void;
+    getData(): T;
+    setData(data: T): void;
+    hydrateData(data: Partial<T>): void;
+    toJson(): string;
+    static fromJson<U>(json: string, schema?: SchemaDefinition<U>, instanceMethods?: InstanceMethods<U>, staticMethods?: StaticMethods<U>): Document<U>;
+    save(): Promise<void>;
+    load(): Promise<void>;
+    delete(): Promise<void>;
+    get dirty(): boolean;
+    get deleted(): boolean;
+    static new<U>(data: Partial<U>, schema?: SchemaDefinition<U>, instanceMethods?: InstanceMethods<U>, staticMethods?: StaticMethods<U>): Document<U>;
+}
+/**
+ * Convertible Document class for advanced transformation patterns
+ */
+export declare class ConvertibleDocument<TStorage, THydrated, TOperational> {
+    protected readonly hydrationSchema: IHydrationSchema<TStorage, THydrated>;
+    protected readonly operationalFactory: IOperationalFactory<THydrated, TOperational>;
+    private privateDataProvider?;
+    constructor(hydrationSchema: IHydrationSchema<TStorage, THydrated>, operationalFactory: IOperationalFactory<THydrated, TOperational>);
+    fromStorage(storage: TStorage): TOperational;
+    toStorage(operational: TOperational): TStorage;
+    setPrivateDataProvider(provider: IPrivateDataProvider<THydrated>): void;
+    clearPrivateDataProvider(): void;
+    save(_operational?: TOperational): Promise<void>;
+    load(): Promise<TOperational>;
+    delete(_operational: TOperational): Promise<void>;
+}
+//# sourceMappingURL=document.d.ts.map

package/src/lib/documents/base/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/documents/base/document.ts"],"names":[],"mappings":"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"}