@adviser/cement 0.4.61 → 0.4.63

package/esm/utils/string2stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"string2stream.js","sourceRoot":"","sources":["../../../../src/utils/string2stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,IAAI,GAAiB,qBAAqB,EAAE,EAA8B;IACnH,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAAA,CAC5C;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAe,EAA8B;IAC7E,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,UAAU,EAAQ;YACtB,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxB,UAAU,CAAC,KAAK,EAAE,CAAC;QAAA,CACpB;KACF,CAAC,CAAC;AAAA,CACJ"}
+{"version":3,"file":"string2stream.js","sourceRoot":"","sources":["../../../../src/utils/string2stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAkB3E,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,IAAI,GAAiB,qBAAqB,EAAE,EAA8B;IACnH,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAAA,CAC5C;AAgBD,MAAM,UAAU,iBAAiB,CAAC,GAAe,EAA8B;IAC7E,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,UAAU,EAAQ;YACtB,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxB,UAAU,CAAC,KAAK,EAAE,CAAC;QAAA,CACpB;KACF,CAAC,CAAC;AAAA,CACJ"}

package/esm/utils/stripper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripper.d.ts","sourceRoot":"","sources":["../../../../src/utils/stripper.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EACpD,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,EACpC,GAAG,EAAE,CAAC,GACL,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAapF"}
+{"version":3,"file":"stripper.d.ts","sourceRoot":"","sources":["../../../../src/utils/stripper.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAoC3C,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EACpD,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,EACpC,GAAG,EAAE,CAAC,GACL,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAapF"}

package/esm/utils/stripper.js.map

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

package/esm/utils/to-sorted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-sorted.d.ts","sourceRoot":"","sources":["../../../../src/utils/to-sorted.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;AAChI,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,OAAO,UAAU,KAAK,IAAI,CAAC;AAEhF,eAAO,MAAM,UAAU;;;;;;;;;;;CAWtB,CAAC;AAmEF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAElE"}
+{"version":3,"file":"to-sorted.d.ts","sourceRoot":"","sources":["../../../../src/utils/to-sorted.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;AAChI,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,OAAO,UAAU,KAAK,IAAI,CAAC;AAEhF,eAAO,MAAM,UAAU;;;;;;;;;;;CAWtB,CAAC;AAqGF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAElE"}

package/esm/utils/to-sorted.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-sorted.js","sourceRoot":"","sources":["../../../../src/utils/to-sorted.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"to-sorted.js","sourceRoot":"","sources":["../../../../src/utils/to-sorted.ts"],"names":[],"mappings":"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"}

package/esm/utils/uint8array-equal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uint8array-equal.d.ts","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAUrE"}
+{"version":3,"file":"uint8array-equal.d.ts","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAoBA,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAUrE"}

package/esm/utils/uint8array-equal.js.map

@@ -1 +1 @@
-{"version":3,"file":"uint8array-equal.js","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,CAAa,EAAE,CAAa,EAAW;IACrE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACb"}
+{"version":3,"file":"uint8array-equal.js","sourceRoot":"","sources":["../../../../src/utils/uint8array-equal.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,eAAe,CAAC,CAAa,EAAE,CAAa,EAAW;IACrE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACb"}

package/esm/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.4.61";
+export const VERSION = "0.4.63";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adviser/cement",
-  "version": "0.4.61",
+  "version": "0.4.63",
   "description": "better try/catch/finally handling",
   "main": "./cjs/index.js",
   "type": "module",
@@ -66,7 +66,9 @@
     "smoke": "bash ./smoke/it.sh",
     "lint": "eslint .",
     "prettier": "prettier .",
-    "format": "prettier ."
+    "format": "prettier .",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch"
   },
   "keywords": [],
   "author": "Meno Abels <meno.abels@adviser.com>",
@@ -104,6 +106,7 @@
     "semver": "^7.7.3",
     "tsup": "^8.3.0",
     "tsx": "^4.19.1",
+    "typedoc": "^0.28.14",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.46.3",
     "vite": "^7.0.4",

package/src/app-context.ts

@@ -1,20 +1,71 @@
-/*
- * Context class to store and retrieve values
- * it's used to store user runtime values like
- * the url to the ledger
+/**
+ * Type guard to check if a value is an AppContext instance.
+ *
+ * @param ctx - Value to check
+ * @returns True if value is an AppContext instance
+ *
+ * @example
+ * ```typescript
+ * const ctx = new AppContext();
+ * if (isAppContext(ctx)) {
+ *   ctx.set('key', 'value');
+ * }
+ * ```
  */
-
 export function isAppContext(ctx: unknown): ctx is AppContext {
   return AppContext.is(ctx);
 }
 
+/**
+ * Context container for storing and retrieving runtime values.
+ *
+ * AppContext provides a type-safe key-value store for application configuration
+ * and runtime state. Useful for passing configuration like URLs, credentials,
+ * or other runtime parameters through an application.
+ *
+ * @example
+ * ```typescript
+ * const ctx = new AppContext();
+ * ctx.set('apiUrl', 'https://api.example.com');
+ * ctx.set('timeout', 5000);
+ *
+ * const url = ctx.get<string>('apiUrl');
+ * const timeout = ctx.get<number>('timeout');
+ * ```
+ */
 export class AppContext {
   private readonly ctx: Map<string, unknown> = new Map<string, unknown>();
 
+  /**
+   * Type guard to check if a value is an AppContext instance.
+   *
+   * @param ctx - Value to check
+   * @returns True if value is an AppContext instance
+   */
   static is(ctx: unknown): ctx is AppContext {
     return ctx instanceof AppContext && "ctx" in ctx && ctx.ctx instanceof Map;
   }
 
+  /**
+   * Merges multiple contexts or objects into a single AppContext.
+   *
+   * Combines values from multiple AppContext instances or plain objects.
+   * Later values overwrite earlier ones for duplicate keys. Undefined values
+   * are skipped.
+   *
+   * @param ctxs - AppContext instances, plain objects, or undefined values to merge
+   * @returns New AppContext containing merged values
+   *
+   * @example
+   * ```typescript
+   * const ctx1 = new AppContext().set('a', 1).set('b', 2);
+   * const ctx2 = new AppContext().set('b', 3).set('c', 4);
+   * const obj = { d: 5 };
+   *
+   * const merged = AppContext.merge(ctx1, ctx2, obj);
+   * // Contains: { a: 1, b: 3, c: 4, d: 5 }
+   * ```
+   */
   static merge(...ctxs: (AppContext | undefined | Record<string, unknown>)[]): AppContext {
     const merged = new AppContext();
     for (const ctx of ctxs) {
@@ -32,17 +83,72 @@ export class AppContext {
     return merged;
   }
 
+  /**
+   * Sets a value in the context.
+   *
+   * @template T - Type of the value being stored
+   * @param key - Key to store the value under
+   * @param value - Value to store
+   * @returns This AppContext instance for chaining
+   *
+   * @example
+   * ```typescript
+   * ctx.set('apiUrl', 'https://api.example.com')
+   *    .set('timeout', 5000)
+   *    .set('retries', 3);
+   * ```
+   */
   set<T>(key: string, value: T): AppContext {
     this.ctx.set(key, value);
     return this;
   }
+
+  /**
+   * Retrieves a value from the context.
+   *
+   * @template T - Expected type of the value
+   * @param key - Key to retrieve
+   * @returns The value if present, undefined otherwise
+   *
+   * @example
+   * ```typescript
+   * const url = ctx.get<string>('apiUrl');
+   * const timeout = ctx.get<number>('timeout');
+   * ```
+   */
   get<T>(key: string): T | undefined {
     return this.ctx.get(key) as T;
   }
+
+  /**
+   * Deletes a value from the context.
+   *
+   * @param key - Key to delete
+   *
+   * @example
+   * ```typescript
+   * ctx.delete('temporaryKey');
+   * ```
+   */
   delete(key: string): void {
     this.ctx.delete(key);
   }
 
+  /**
+   * Converts the context to a plain object.
+   *
+   * @returns Plain object containing all key-value pairs
+   *
+   * @example
+   * ```typescript
+   * const ctx = new AppContext()
+   *   .set('a', 1)
+   *   .set('b', 2);
+   *
+   * const obj = ctx.asObj();
+   * // { a: 1, b: 2 }
+   * ```
+   */
   asObj(): Record<string, unknown> {
     return Object.fromEntries(this.ctx.entries());
   }

package/src/base-sys-abstraction.ts

@@ -17,6 +17,11 @@ import { CFBasicSysAbstraction } from "./cf/cf-basic-sys-abstraction.js";
 import { DenoBasicSysAbstraction } from "./deno/deno-basic-sys-abstraction.js";
 import { NodeBasicSysAbstraction } from "./node/node-basic-sys-abstraction.js";
 
+/**
+ * Real-time implementation using system clock.
+ *
+ * Provides actual current time and real delays. Use for production code.
+ */
 export class SysTime extends Time {
   Now(): Date {
     return new Date();
@@ -30,6 +35,12 @@ export class SysTime extends Time {
   }
 }
 
+/**
+ * Constant time implementation for deterministic testing.
+ *
+ * Always returns the same fixed date (2021-02-01). Sleep operations
+ * complete immediately without delay. Useful for reproducible tests.
+ */
 export class ConstTime extends Time {
   Now(): Date {
     return new Date(2021, 1, 1, 0, 0, 0, 0);
@@ -40,6 +51,12 @@ export class ConstTime extends Time {
   }
 }
 
+/**
+ * Stepped time implementation for controlled testing.
+ *
+ * Advances time in 1-second increments on each Now() call. Sleep operations
+ * advance time without delay. Useful for testing time-dependent behavior.
+ */
 export class StepTime extends Time {
   _step: Date;
   readonly _start: Date;
@@ -68,6 +85,24 @@ export class StepTime extends Time {
   }
 }
 
+/**
+ * Creates a Time implementation based on the specified mode.
+ *
+ * @param timeMode - Time behavior mode (REAL, CONST, or STEP)
+ * @returns Time implementation matching the mode
+ *
+ * @example
+ * ```typescript
+ * // Production: uses real system time
+ * const realTime = TimeFactory(TimeMode.REAL);
+ *
+ * // Testing: constant time
+ * const constTime = TimeFactory(TimeMode.CONST);
+ *
+ * // Testing: stepped time
+ * const stepTime = TimeFactory(TimeMode.STEP);
+ * ```
+ */
 export function TimeFactory(timeMode: TimeMode): Time {
   switch (timeMode) {
     case TimeMode.REAL:
@@ -80,12 +115,42 @@ export function TimeFactory(timeMode: TimeMode): Time {
   return new SysTime();
 }
 
+/**
+ * Random number generator with deterministic modes for testing.
+ *
+ * Provides random number generation that can operate in different modes:
+ * - RANDOM: Uses Math.random() for real random values
+ * - CONST: Always returns a constant value (0.5 * max) for reproducible tests
+ * - STEP: Returns incrementing values for predictable test sequences
+ *
+ * @example
+ * ```typescript
+ * // Production: real randomness
+ * const random = new RandomService(RandomMode.RANDOM);
+ * const value = random.Random0ToValue(100); // 0-100
+ *
+ * // Testing: constant value
+ * const constRandom = new RandomService(RandomMode.CONST);
+ * const value = constRandom.Random0ToValue(100); // Always 50
+ *
+ * // Testing: stepped sequence
+ * const stepRandom = new RandomService(RandomMode.STEP);
+ * const v1 = stepRandom.Random0ToValue(100); // 0.01
+ * const v2 = stepRandom.Random0ToValue(100); // 0.02
+ * ```
+ */
 export class RandomService {
   readonly _mode: RandomMode;
   _step = 0;
   constructor(mode: RandomMode) {
     this._mode = mode;
   }
+  /**
+   * Generates a random number between 0 and the specified value.
+   *
+   * @param value - Maximum value (exclusive upper bound)
+   * @returns Random number in range [0, value)
+   */
   Random0ToValue(value: number): number {
     switch (this._mode) {
       case RandomMode.CONST:
@@ -101,6 +166,31 @@ export class RandomService {
   }
 }
 
+/**
+ * ID generator with deterministic modes for testing.
+ *
+ * Generates unique identifiers with support for different modes:
+ * - UUID: Uses crypto.randomUUID() for real UUIDs (default)
+ * - CONST: Always returns the same constant ID for reproducible tests
+ * - STEP: Returns incrementing IDs (STEPId-0, STEPId-1, etc.) for predictable sequences
+ *
+ * @example
+ * ```typescript
+ * // Production: real UUIDs
+ * const idService = new IdService(IDMode.UUID);
+ * const id = idService.NextId(); // "550e8400-e29b-41d4-a716-446655440000"
+ *
+ * // Testing: constant ID
+ * const constId = new IdService(IDMode.CONST);
+ * const id1 = constId.NextId(); // "VeryUniqueID"
+ * const id2 = constId.NextId(); // "VeryUniqueID"
+ *
+ * // Testing: stepped sequence
+ * const stepId = new IdService(IDMode.STEP);
+ * const id1 = stepId.NextId(); // "STEPId-0"
+ * const id2 = stepId.NextId(); // "STEPId-1"
+ * ```
+ */
 export class IdService {
   readonly _mode: IDMode;
   _step = 0;
@@ -110,6 +200,11 @@ export class IdService {
     }
     this._mode = mode;
   }
+  /**
+   * Generates the next unique identifier.
+   *
+   * @returns Unique ID string based on the configured mode
+   */
   NextId(): string {
     switch (this._mode) {
       case IDMode.UUID:
@@ -145,6 +240,29 @@ export interface ExitService {
 
 // some black magic to make it work with CF workers
 
+/**
+ * Base system abstraction for platform-independent services.
+ *
+ * Provides core services that work across all JavaScript runtimes:
+ * - Time: Real system time implementation
+ * - ID Generation: UUID-based unique identifiers
+ * - Random Numbers: Math.random()-based generation
+ * - Text Encoding/Decoding: UTF-8 conversion utilities
+ *
+ * This is the foundation for both basic and full system abstractions,
+ * containing services that don't require filesystem or system access.
+ *
+ * @example
+ * ```typescript
+ * const base = new BaseBasicSysAbstraction({
+ *   TxtEnDecoder: new TxtEnDecoder()
+ * });
+ *
+ * const now = base._time.Now();
+ * const id = base._idService.NextId();
+ * const random = base._randomService.Random0ToValue(100);
+ * ```
+ */
 export class BaseBasicSysAbstraction {
   readonly _time: SysTime = new SysTime();
 
@@ -158,6 +276,31 @@ export class BaseBasicSysAbstraction {
   }
 }
 
+/**
+ * Full system abstraction with filesystem and system service access.
+ *
+ * Extends BaseBasicSysAbstraction with platform-specific services:
+ * - FileSystem: File I/O operations
+ * - SystemService: Process, environment, and system-level operations
+ *
+ * Used in Node.js and Deno environments where full system access is available.
+ * Not suitable for browser or Cloudflare Workers environments.
+ *
+ * @example
+ * ```typescript
+ * const sys = new BaseSysAbstraction({
+ *   TxtEnDecoder: new TxtEnDecoder(),
+ *   FileSystem: new NodeFileService(),
+ *   SystemService: new NodeSystemService()
+ * });
+ *
+ * // Access filesystem
+ * const content = await sys._fileSystem.readFile('/path/to/file');
+ *
+ * // Access environment
+ * const env = sys._systemService.getEnv();
+ * ```
+ */
 export class BaseSysAbstraction extends BaseBasicSysAbstraction {
   // system related services
   readonly _fileSystem: FileService;
@@ -182,6 +325,36 @@ export interface BasicSysAbstractionParams {
 
 export type WrapperBasicSysAbstractionParams = Partial<BasicRuntimeService & BasicSysAbstractionParams>;
 
+/**
+ * Creates a BasicSysAbstraction instance for the current runtime environment.
+ *
+ * Automatically detects the JavaScript runtime (Browser, Node.js, Deno, or
+ * Cloudflare Workers) and returns the appropriate system abstraction implementation.
+ * Supports optional configuration for time, ID, and random number generation modes,
+ * useful for testing with deterministic behavior.
+ *
+ * @param params - Optional configuration for time, ID, and random modes
+ * @returns BasicSysAbstraction instance for the current runtime
+ * @throws Error if the runtime cannot be detected
+ *
+ * @example
+ * ```typescript
+ * // Production: auto-detect runtime with defaults
+ * const sys = BasicSysAbstractionFactory();
+ * const now = sys.Time().Now();
+ * const id = sys.NextId();
+ *
+ * // Testing: deterministic behavior
+ * const testSys = BasicSysAbstractionFactory({
+ *   TimeMode: TimeMode.CONST,
+ *   IdMode: IDMode.STEP,
+ *   RandomMode: RandomMode.CONST
+ * });
+ * const constTime = testSys.Time().Now(); // Always 2021-02-01
+ * const id1 = testSys.NextId(); // "STEPId-0"
+ * const id2 = testSys.NextId(); // "STEPId-1"
+ * ```
+ */
 export function BasicSysAbstractionFactory(params?: WrapperBasicSysAbstractionParams): BasicSysAbstraction {
   const fn = runtimeFn();
   switch (true) {
@@ -198,6 +371,44 @@ export function BasicSysAbstractionFactory(params?: WrapperBasicSysAbstractionPa
   }
 }
 
+/**
+ * BasicSysAbstraction implementation with configurable service modes.
+ *
+ * Wraps a base system abstraction and allows overriding time, ID, and random
+ * number generation modes. This is the primary implementation returned by
+ * BasicSysAbstractionFactory and provides the unified interface for all
+ * platform-independent system services.
+ *
+ * Delegates runtime-specific operations (Stdout, Stderr, Env, Args) to the
+ * underlying runtime service while providing configurable implementations for
+ * testable services (Time, ID, Random).
+ *
+ * @example
+ * ```typescript
+ * // Created via factory
+ * const sys = BasicSysAbstractionFactory({
+ *   TimeMode: TimeMode.STEP,
+ *   IdMode: IDMode.UUID,
+ *   RandomMode: RandomMode.RANDOM
+ * });
+ *
+ * // Use time service
+ * const time = sys.Time();
+ * const now = time.Now();
+ * await time.Sleep(1000);
+ *
+ * // Use ID service
+ * const id = sys.NextId();
+ *
+ * // Use random service
+ * const random = sys.Random0ToValue(100);
+ *
+ * // Access runtime services
+ * const stdout = sys.Stdout();
+ * const env = sys.Env();
+ * const args = sys.Args();
+ * ```
+ */
 export class WrapperBasicSysAbstraction implements BasicSysAbstraction {
   readonly _time: Time;
   readonly _idService: IdService;
@@ -253,6 +464,39 @@ export class WrapperBasicSysAbstraction implements BasicSysAbstraction {
 }
 // export const BaseSysAbstraction = new BaseSysAbstractionImpl()
 
+/**
+ * Full system abstraction with filesystem and system service access.
+ *
+ * Extends WrapperBasicSysAbstraction with filesystem and system services,
+ * providing the complete system abstraction interface. Used in environments
+ * with full system access (Node.js, Deno) where filesystem operations,
+ * process management, and environment access are available.
+ *
+ * Inherits all configurable services from WrapperBasicSysAbstraction (Time,
+ * ID, Random) and adds FileSystem and SystemService access.
+ *
+ * @example
+ * ```typescript
+ * // Created via runtime-specific factory
+ * const sys = NodeSysAbstraction({
+ *   TimeMode: TimeMode.REAL,
+ *   IdMode: IDMode.UUID
+ * });
+ *
+ * // Use basic services
+ * const time = sys.Time();
+ * const id = sys.NextId();
+ *
+ * // Use filesystem
+ * const fs = sys.FileSystem();
+ * const content = await fs.readFile('/path/to/file');
+ *
+ * // Use system services
+ * const system = sys.System();
+ * const env = system.getEnv();
+ * system.exit(0);
+ * ```
+ */
 export class WrapperRuntimeSysAbstraction extends WrapperBasicSysAbstraction {
   readonly _systemService: SystemService;
   readonly _fileSystem: FileService;

package/src/bin2text.ts

@@ -1,3 +1,22 @@
+/**
+ * Formats binary data as hexdump output with ASCII representation.
+ *
+ * Produces hexdump-style output similar to `xxd` or `hexdump` commands,
+ * showing hex values and ASCII characters side-by-side. Each line shows
+ * 16 bytes with offset, hex values, and printable ASCII characters.
+ *
+ * @param hex - Binary data to format (any ArrayBufferView)
+ * @param lineFn - Callback function invoked for each formatted line
+ * @param size - Maximum number of bytes to format (0 = all bytes)
+ *
+ * @example
+ * ```typescript
+ * const data = new Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]);
+ * bin2text(data, (line) => console.log(line));
+ * // Output:
+ * // 0000   48 65 6c 6c 6f 20 57 6f 72 6c 64       Hello World
+ * ```
+ */
 export function bin2text(hex: ArrayBufferView, lineFn: (line: string) => void, size = 0): void {
   const arr = new Uint8Array(hex.buffer, hex.byteOffset, hex.byteLength);
   let cutted = "  ";
@@ -34,6 +53,24 @@ export function bin2text(hex: ArrayBufferView, lineFn: (line: string) => void, s
   }
 }
 
+/**
+ * Formats binary data as a hexdump string.
+ *
+ * Convenience wrapper around bin2text that returns a single string with
+ * newline-separated hexdump lines. Useful for logging or display purposes.
+ *
+ * @param hex - Binary data to format (any ArrayBufferView)
+ * @param size - Maximum number of bytes to format (0 = all bytes)
+ * @returns Formatted hexdump as a string
+ *
+ * @example
+ * ```typescript
+ * const data = new Uint8Array([72, 101, 108, 108, 111]);
+ * const dump = bin2string(data);
+ * console.log(dump);
+ * // 0000   48 65 6c 6c 6f                       Hello
+ * ```
+ */
 export function bin2string(hex: ArrayBufferView, size = 0): string {
   const collector: string[] = [];
   bin2text(