@adviser/cement 0.3.6 → 0.3.8

package/node/index.js

@@ -2,10 +2,10 @@ import {
   BaseSysAbstraction,
   WrapperSysAbstraction,
   envFactory
-} from "../chunk-4QRZPFED.js";
+} from "../chunk-GVZIH356.js";
 import {
-  Utf8EnDecoderSingleton
-} from "../chunk-QDDO6NOK.js";
+  TxtEnDecoderSingleton
+} from "../chunk-A57BAYWU.js";
 
 // src/node/node-file-service.ts
 import path from "node:path";
@@ -54,7 +54,7 @@ var NodeFileService = class {
   isAbsolute(fname) {
     return path.isAbsolute(fname);
   }
-  async writeFileString(fname, content, ende = Utf8EnDecoderSingleton()) {
+  async writeFileString(fname, content, ende = TxtEnDecoderSingleton()) {
     const o = await this.create(fname);
     const wr = o.stream.getWriter();
     await wr.write(ende.encode(content));
@@ -171,7 +171,7 @@ var my = void 0;
 function NodeSysAbstraction(param) {
   if (!my) {
     my = new BaseSysAbstraction({
-      TxtEnDecoder: (param == null ? void 0 : param.TxtEnDecoder) || Utf8EnDecoderSingleton(),
+      TxtEnDecoder: (param == null ? void 0 : param.TxtEnDecoder) || TxtEnDecoderSingleton(),
       FileSystem: new NodeFileService(),
       SystemService: new NodeSystemService()
     });

package/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/node/node-file-service.ts","../../../src/node/node-sys-abstraction.ts","../../../src/node/mock-file-service.ts"],"sourcesContent":["import path from \"node:path\";\nimport fs from \"node:fs\";\nimport process from \"node:process\";\nimport { FileService, NamedWritableStream } from \"../file-service.js\";\nimport { TxtEnDecoder, Utf8EnDecoderSingleton } from \"../txt-en-decoder.js\";\n\nexport class NodeFileService implements FileService {\n  readonly baseDir: string;\n  constructor(baseDir: string = process.cwd()) {\n    this.baseDir = this.abs(baseDir);\n  }\n\n  // nodeImport(fname: string): string {\n  //   // console.log('nodeImport:'+ fname);\n  //   if (path.isAbsolute(fname)) {\n  //     return fname;\n  //   } else {\n  //     return \"./\" + path.normalize(fname);\n  //   }\n  // }\n\n  readFileString(fname: string): Promise<string> {\n    return fs.promises.readFile(fname, { encoding: \"utf-8\" });\n  }\n\n  dirname(fname: string): string {\n    return path.dirname(fname);\n  }\n  basename(fname: string): string {\n    return path.basename(fname);\n  }\n\n  join(...paths: string[]): string {\n    return path.join(...paths);\n  }\n\n  relative(from: string, to?: string): string {\n    if (to === undefined) {\n      to = from;\n      from = process.cwd();\n    }\n    const ret = path.relative(from, to);\n    // console.log('relative:'+ from + \" -> \" + to +   \"= \" + ret);\n    return ret;\n  }\n\n  abs(fname: string): string {\n    if (path.isAbsolute(fname)) {\n      return fname;\n    } else {\n      const cwd = process.cwd();\n      return path.resolve(cwd, fname);\n    }\n  }\n\n  isAbsolute(fname: string): boolean {\n    return path.isAbsolute(fname);\n  }\n\n  async writeFileString(fname: string, content: string, ende: TxtEnDecoder = Utf8EnDecoderSingleton()): Promise<void> {\n    const o = await this.create(fname);\n    const wr = o.stream.getWriter();\n    await wr.write(ende.encode(content));\n    await wr.close();\n  }\n\n  async create(fname: string): Promise<NamedWritableStream> {\n    let oName = fname;\n    if (!path.isAbsolute(fname)) {\n      oName = this.abs(fname);\n    }\n\n    const base = path.dirname(oName);\n    await fs.promises.mkdir(base, { recursive: true });\n    const out = fs.createWriteStream(oName);\n    return {\n      name: oName,\n      stream: new WritableStream<Uint8Array>({\n        write(chunk): void {\n          out.write(chunk);\n        },\n        close(): void {\n          out.close();\n        },\n        abort(): void {\n          throw new Error(\"not implemented\");\n        },\n      }),\n    };\n  }\n}\n","import { SysAbstraction, SystemService, VoidFunc } from \"../sys-abstraction.js\";\nimport {\n  BaseSysAbstraction,\n  ExitHandler,\n  ExitService,\n  WrapperSysAbstraction,\n  WrapperSysAbstractionParams,\n} from \"../base-sys-abstraction.js\";\nimport { NodeFileService } from \"./node-file-service.js\";\nimport { Env, envFactory } from \"../sys-env.js\";\nimport { Utf8EnDecoderSingleton } from \"../txt-en-decoder.js\";\nimport process from \"node:process\";\n\nexport class NodeExitServiceImpl implements ExitService {\n  constructor() {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    process.on(\"unhandledRejection\", (reason: string, p: Promise<unknown>) => {\n      this.exit(19);\n    });\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    process.on(\"uncaughtException\", (error: Error) => {\n      this.exit(18);\n    });\n    process.on(\"close\", () => {\n      this.exit(0);\n    });\n    process.on(\"exit\", () => {\n      this.exit(0);\n    });\n    process.on(\"SIGQUIT\", () => {\n      this.exit(3);\n    });\n    process.on(\"SIGINT\", () => {\n      this.exit(2);\n    });\n    process.on(\"SIGTERM\", () => {\n      this.exit(9);\n    });\n  }\n  _exitHandlers: ExitHandler[] = [];\n  injectExitHandlers(hdls: ExitHandler[]): void {\n    // console.log(\"ExitService: injecting exit handlers\", hdls)\n    this._exitHandlers = hdls;\n  }\n  invoked = false;\n  readonly _handleExit = async (): Promise<void> => {\n    if (this.invoked) {\n      // console.error(\"ExitService: already invoked\");\n      return;\n    }\n    this.invoked = true;\n    for (const h of this._exitHandlers) {\n      try {\n        // console.log(`ExitService: calling handler ${h.id}`)\n        const ret = h.hdl();\n        // console.log(`ExitService: called handler ${h.id}`, ret)\n        if (typeof (ret as Promise<void>).then === \"function\") {\n          await ret;\n        }\n      } finally {\n        // ignore\n      }\n    }\n  };\n\n  exit(code: number): void {\n    // console.log(\"ExitService: exit called\", code)\n    this._handleExit()\n      .then(() => {\n        process.exit(code);\n      })\n      .catch((err) => {\n        // eslint-disable-next-line no-console\n        console.error(\"ExitService: failed to handle exit\", err);\n        process.exit(code);\n      });\n  }\n}\n\nexport class NodeSystemService implements SystemService {\n  static readonly _exitHandlers: ExitHandler[] = [];\n  readonly _exitService: ExitService = new NodeExitServiceImpl();\n  constructor() {\n    this._exitService.injectExitHandlers(NodeSystemService._exitHandlers);\n  }\n\n  Env(): Env {\n    return envFactory();\n  }\n\n  Args(): string[] {\n    return process.argv;\n  }\n\n  OnExit(hdl: VoidFunc): VoidFunc {\n    const id = crypto.randomUUID();\n    NodeSystemService._exitHandlers.push({ hdl, id });\n    return () => {\n      const idx = NodeSystemService._exitHandlers.findIndex((h) => h.id === id);\n      if (idx >= 0) {\n        NodeSystemService._exitHandlers.splice(idx, 1);\n      }\n    };\n  }\n\n  Exit(code: number): void {\n    this._exitService.exit(code);\n  }\n}\n\nlet my: BaseSysAbstraction | undefined = undefined;\nexport function NodeSysAbstraction(param?: WrapperSysAbstractionParams): SysAbstraction {\n  if (!my) {\n    my = new BaseSysAbstraction({\n      TxtEnDecoder: param?.TxtEnDecoder || Utf8EnDecoderSingleton(),\n      FileSystem: new NodeFileService(),\n      SystemService: new NodeSystemService(),\n    });\n  }\n  return new WrapperSysAbstraction(my, param);\n}\n","import { NamedWritableStream } from \"../file-service.js\";\nimport { NodeFileService } from \"./node-file-service.js\";\n\nexport interface FileCollector {\n  readonly name: string;\n  content: string;\n}\n\nexport class MockFileService extends NodeFileService {\n  readonly files = {} as Record<string, FileCollector>;\n\n  // override abs(fname: string): string {\n  //   return this.join(\"/mock/\", fname);\n  // }\n\n  override create(fname: string): Promise<NamedWritableStream> {\n    let oName = fname;\n    if (!this.isAbsolute(fname)) {\n      oName = this.abs(fname);\n    }\n\n    const fc = {\n      name: oName,\n      content: \"\",\n    };\n    this.files[oName] = fc;\n    this.files[fname] = fc;\n    const decoder = new TextDecoder();\n\n    return Promise.resolve({\n      name: oName,\n      stream: new WritableStream<Uint8Array>({\n        write(chunk): void {\n          fc.content = fc.content + decoder.decode(chunk);\n        },\n        close(): void {\n          // do nothing\n        },\n        abort(): void {\n          throw new Error(\"not implemented\");\n        },\n      }),\n    });\n  }\n}\n"],"mappings":"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","names":["process"]}
+{"version":3,"sources":["../../../src/node/node-file-service.ts","../../../src/node/node-sys-abstraction.ts","../../../src/node/mock-file-service.ts"],"sourcesContent":["import path from \"node:path\";\nimport fs from \"node:fs\";\nimport process from \"node:process\";\nimport { FileService, NamedWritableStream } from \"../file-service.js\";\nimport { TxtEnDecoder, TxtEnDecoderSingleton } from \"../txt-en-decoder.js\";\n\nexport class NodeFileService implements FileService {\n  readonly baseDir: string;\n  constructor(baseDir: string = process.cwd()) {\n    this.baseDir = this.abs(baseDir);\n  }\n\n  // nodeImport(fname: string): string {\n  //   // console.log('nodeImport:'+ fname);\n  //   if (path.isAbsolute(fname)) {\n  //     return fname;\n  //   } else {\n  //     return \"./\" + path.normalize(fname);\n  //   }\n  // }\n\n  readFileString(fname: string): Promise<string> {\n    return fs.promises.readFile(fname, { encoding: \"utf-8\" });\n  }\n\n  dirname(fname: string): string {\n    return path.dirname(fname);\n  }\n  basename(fname: string): string {\n    return path.basename(fname);\n  }\n\n  join(...paths: string[]): string {\n    return path.join(...paths);\n  }\n\n  relative(from: string, to?: string): string {\n    if (to === undefined) {\n      to = from;\n      from = process.cwd();\n    }\n    const ret = path.relative(from, to);\n    // console.log('relative:'+ from + \" -> \" + to +   \"= \" + ret);\n    return ret;\n  }\n\n  abs(fname: string): string {\n    if (path.isAbsolute(fname)) {\n      return fname;\n    } else {\n      const cwd = process.cwd();\n      return path.resolve(cwd, fname);\n    }\n  }\n\n  isAbsolute(fname: string): boolean {\n    return path.isAbsolute(fname);\n  }\n\n  async writeFileString(fname: string, content: string, ende: TxtEnDecoder = TxtEnDecoderSingleton()): Promise<void> {\n    const o = await this.create(fname);\n    const wr = o.stream.getWriter();\n    await wr.write(ende.encode(content));\n    await wr.close();\n  }\n\n  async create(fname: string): Promise<NamedWritableStream> {\n    let oName = fname;\n    if (!path.isAbsolute(fname)) {\n      oName = this.abs(fname);\n    }\n\n    const base = path.dirname(oName);\n    await fs.promises.mkdir(base, { recursive: true });\n    const out = fs.createWriteStream(oName);\n    return {\n      name: oName,\n      stream: new WritableStream<Uint8Array>({\n        write(chunk): void {\n          out.write(chunk);\n        },\n        close(): void {\n          out.close();\n        },\n        abort(): void {\n          throw new Error(\"not implemented\");\n        },\n      }),\n    };\n  }\n}\n","import { SysAbstraction, SystemService, VoidFunc } from \"../sys-abstraction.js\";\nimport {\n  BaseSysAbstraction,\n  ExitHandler,\n  ExitService,\n  WrapperSysAbstraction,\n  WrapperSysAbstractionParams,\n} from \"../base-sys-abstraction.js\";\nimport { NodeFileService } from \"./node-file-service.js\";\nimport { Env, envFactory } from \"../sys-env.js\";\nimport { TxtEnDecoderSingleton } from \"../txt-en-decoder.js\";\nimport process from \"node:process\";\n\nexport class NodeExitServiceImpl implements ExitService {\n  constructor() {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    process.on(\"unhandledRejection\", (reason: string, p: Promise<unknown>) => {\n      this.exit(19);\n    });\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    process.on(\"uncaughtException\", (error: Error) => {\n      this.exit(18);\n    });\n    process.on(\"close\", () => {\n      this.exit(0);\n    });\n    process.on(\"exit\", () => {\n      this.exit(0);\n    });\n    process.on(\"SIGQUIT\", () => {\n      this.exit(3);\n    });\n    process.on(\"SIGINT\", () => {\n      this.exit(2);\n    });\n    process.on(\"SIGTERM\", () => {\n      this.exit(9);\n    });\n  }\n  _exitHandlers: ExitHandler[] = [];\n  injectExitHandlers(hdls: ExitHandler[]): void {\n    // console.log(\"ExitService: injecting exit handlers\", hdls)\n    this._exitHandlers = hdls;\n  }\n  invoked = false;\n  readonly _handleExit = async (): Promise<void> => {\n    if (this.invoked) {\n      // console.error(\"ExitService: already invoked\");\n      return;\n    }\n    this.invoked = true;\n    for (const h of this._exitHandlers) {\n      try {\n        // console.log(`ExitService: calling handler ${h.id}`)\n        const ret = h.hdl();\n        // console.log(`ExitService: called handler ${h.id}`, ret)\n        if (typeof (ret as Promise<void>).then === \"function\") {\n          await ret;\n        }\n      } finally {\n        // ignore\n      }\n    }\n  };\n\n  exit(code: number): void {\n    // console.log(\"ExitService: exit called\", code)\n    this._handleExit()\n      .then(() => {\n        process.exit(code);\n      })\n      .catch((err) => {\n        // eslint-disable-next-line no-console\n        console.error(\"ExitService: failed to handle exit\", err);\n        process.exit(code);\n      });\n  }\n}\n\nexport class NodeSystemService implements SystemService {\n  static readonly _exitHandlers: ExitHandler[] = [];\n  readonly _exitService: ExitService = new NodeExitServiceImpl();\n  constructor() {\n    this._exitService.injectExitHandlers(NodeSystemService._exitHandlers);\n  }\n\n  Env(): Env {\n    return envFactory();\n  }\n\n  Args(): string[] {\n    return process.argv;\n  }\n\n  OnExit(hdl: VoidFunc): VoidFunc {\n    const id = crypto.randomUUID();\n    NodeSystemService._exitHandlers.push({ hdl, id });\n    return () => {\n      const idx = NodeSystemService._exitHandlers.findIndex((h) => h.id === id);\n      if (idx >= 0) {\n        NodeSystemService._exitHandlers.splice(idx, 1);\n      }\n    };\n  }\n\n  Exit(code: number): void {\n    this._exitService.exit(code);\n  }\n}\n\nlet my: BaseSysAbstraction | undefined = undefined;\nexport function NodeSysAbstraction(param?: WrapperSysAbstractionParams): SysAbstraction {\n  if (!my) {\n    my = new BaseSysAbstraction({\n      TxtEnDecoder: param?.TxtEnDecoder || TxtEnDecoderSingleton(),\n      FileSystem: new NodeFileService(),\n      SystemService: new NodeSystemService(),\n    });\n  }\n  return new WrapperSysAbstraction(my, param);\n}\n","import { NamedWritableStream } from \"../file-service.js\";\nimport { NodeFileService } from \"./node-file-service.js\";\n\nexport interface FileCollector {\n  readonly name: string;\n  content: string;\n}\n\nexport class MockFileService extends NodeFileService {\n  readonly files = {} as Record<string, FileCollector>;\n\n  // override abs(fname: string): string {\n  //   return this.join(\"/mock/\", fname);\n  // }\n\n  override create(fname: string): Promise<NamedWritableStream> {\n    let oName = fname;\n    if (!this.isAbsolute(fname)) {\n      oName = this.abs(fname);\n    }\n\n    const fc = {\n      name: oName,\n      content: \"\",\n    };\n    this.files[oName] = fc;\n    this.files[fname] = fc;\n    const decoder = new TextDecoder();\n\n    return Promise.resolve({\n      name: oName,\n      stream: new WritableStream<Uint8Array>({\n        write(chunk): void {\n          fc.content = fc.content + decoder.decode(chunk);\n        },\n        close(): void {\n          // do nothing\n        },\n        abort(): void {\n          throw new Error(\"not implemented\");\n        },\n      }),\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,OAAO,aAAa;AAIb,IAAM,kBAAN,MAA6C;AAAA,EAElD,YAAY,UAAkB,QAAQ,IAAI,GAAG;AAC3C,SAAK,UAAU,KAAK,IAAI,OAAO;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,eAAe,OAAgC;AAC7C,WAAO,GAAG,SAAS,SAAS,OAAO,EAAE,UAAU,QAAQ,CAAC;AAAA,EAC1D;AAAA,EAEA,QAAQ,OAAuB;AAC7B,WAAO,KAAK,QAAQ,KAAK;AAAA,EAC3B;AAAA,EACA,SAAS,OAAuB;AAC9B,WAAO,KAAK,SAAS,KAAK;AAAA,EAC5B;AAAA,EAEA,QAAQ,OAAyB;AAC/B,WAAO,KAAK,KAAK,GAAG,KAAK;AAAA,EAC3B;AAAA,EAEA,SAAS,MAAc,IAAqB;AAC1C,QAAI,OAAO,QAAW;AACpB,WAAK;AACL,aAAO,QAAQ,IAAI;AAAA,IACrB;AACA,UAAM,MAAM,KAAK,SAAS,MAAM,EAAE;AAElC,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,OAAuB;AACzB,QAAI,KAAK,WAAW,KAAK,GAAG;AAC1B,aAAO;AAAA,IACT,OAAO;AACL,YAAM,MAAM,QAAQ,IAAI;AACxB,aAAO,KAAK,QAAQ,KAAK,KAAK;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,WAAW,OAAwB;AACjC,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,MAAM,gBAAgB,OAAe,SAAiB,OAAqB,sBAAsB,GAAkB;AACjH,UAAM,IAAI,MAAM,KAAK,OAAO,KAAK;AACjC,UAAM,KAAK,EAAE,OAAO,UAAU;AAC9B,UAAM,GAAG,MAAM,KAAK,OAAO,OAAO,CAAC;AACnC,UAAM,GAAG,MAAM;AAAA,EACjB;AAAA,EAEA,MAAM,OAAO,OAA6C;AACxD,QAAI,QAAQ;AACZ,QAAI,CAAC,KAAK,WAAW,KAAK,GAAG;AAC3B,cAAQ,KAAK,IAAI,KAAK;AAAA,IACxB;AAEA,UAAM,OAAO,KAAK,QAAQ,KAAK;AAC/B,UAAM,GAAG,SAAS,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;AACjD,UAAM,MAAM,GAAG,kBAAkB,KAAK;AACtC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ,IAAI,eAA2B;AAAA,QACrC,MAAM,OAAa;AACjB,cAAI,MAAM,KAAK;AAAA,QACjB;AAAA,QACA,QAAc;AACZ,cAAI,MAAM;AAAA,QACZ;AAAA,QACA,QAAc;AACZ,gBAAM,IAAI,MAAM,iBAAiB;AAAA,QACnC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;;;AC/EA,OAAOA,cAAa;AAEb,IAAM,sBAAN,MAAiD;AAAA,EACtD,cAAc;AAyBd,yBAA+B,CAAC;AAKhC,mBAAU;AACV,SAAS,cAAc,YAA2B;AAChD,UAAI,KAAK,SAAS;AAEhB;AAAA,MACF;AACA,WAAK,UAAU;AACf,iBAAW,KAAK,KAAK,eAAe;AAClC,YAAI;AAEF,gBAAM,MAAM,EAAE,IAAI;AAElB,cAAI,OAAQ,IAAsB,SAAS,YAAY;AACrD,kBAAM;AAAA,UACR;AAAA,QACF,UAAE;AAAA,QAEF;AAAA,MACF;AAAA,IACF;AA/CE,IAAAA,SAAQ,GAAG,sBAAsB,CAAC,QAAgB,MAAwB;AACxE,WAAK,KAAK,EAAE;AAAA,IACd,CAAC;AAED,IAAAA,SAAQ,GAAG,qBAAqB,CAAC,UAAiB;AAChD,WAAK,KAAK,EAAE;AAAA,IACd,CAAC;AACD,IAAAA,SAAQ,GAAG,SAAS,MAAM;AACxB,WAAK,KAAK,CAAC;AAAA,IACb,CAAC;AACD,IAAAA,SAAQ,GAAG,QAAQ,MAAM;AACvB,WAAK,KAAK,CAAC;AAAA,IACb,CAAC;AACD,IAAAA,SAAQ,GAAG,WAAW,MAAM;AAC1B,WAAK,KAAK,CAAC;AAAA,IACb,CAAC;AACD,IAAAA,SAAQ,GAAG,UAAU,MAAM;AACzB,WAAK,KAAK,CAAC;AAAA,IACb,CAAC;AACD,IAAAA,SAAQ,GAAG,WAAW,MAAM;AAC1B,WAAK,KAAK,CAAC;AAAA,IACb,CAAC;AAAA,EACH;AAAA,EAEA,mBAAmB,MAA2B;AAE5C,SAAK,gBAAgB;AAAA,EACvB;AAAA,EAsBA,KAAK,MAAoB;AAEvB,SAAK,YAAY,EACd,KAAK,MAAM;AACV,MAAAA,SAAQ,KAAK,IAAI;AAAA,IACnB,CAAC,EACA,MAAM,CAAC,QAAQ;AAEd,cAAQ,MAAM,sCAAsC,GAAG;AACvD,MAAAA,SAAQ,KAAK,IAAI;AAAA,IACnB,CAAC;AAAA,EACL;AACF;AAEO,IAAM,qBAAN,MAAM,mBAA2C;AAAA,EAGtD,cAAc;AADd,SAAS,eAA4B,IAAI,oBAAoB;AAE3D,SAAK,aAAa,mBAAmB,mBAAkB,aAAa;AAAA,EACtE;AAAA,EAEA,MAAW;AACT,WAAO,WAAW;AAAA,EACpB;AAAA,EAEA,OAAiB;AACf,WAAOA,SAAQ;AAAA,EACjB;AAAA,EAEA,OAAO,KAAyB;AAC9B,UAAM,KAAK,OAAO,WAAW;AAC7B,uBAAkB,cAAc,KAAK,EAAE,KAAK,GAAG,CAAC;AAChD,WAAO,MAAM;AACX,YAAM,MAAM,mBAAkB,cAAc,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE;AACxE,UAAI,OAAO,GAAG;AACZ,2BAAkB,cAAc,OAAO,KAAK,CAAC;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,KAAK,MAAoB;AACvB,SAAK,aAAa,KAAK,IAAI;AAAA,EAC7B;AACF;AA7Ba,mBACK,gBAA+B,CAAC;AAD3C,IAAM,oBAAN;AA+BP,IAAI,KAAqC;AAClC,SAAS,mBAAmB,OAAqD;AACtF,MAAI,CAAC,IAAI;AACP,SAAK,IAAI,mBAAmB;AAAA,MAC1B,eAAc,+BAAO,iBAAgB,sBAAsB;AAAA,MAC3D,YAAY,IAAI,gBAAgB;AAAA,MAChC,eAAe,IAAI,kBAAkB;AAAA,IACvC,CAAC;AAAA,EACH;AACA,SAAO,IAAI,sBAAsB,IAAI,KAAK;AAC5C;;;AChHO,IAAM,kBAAN,cAA8B,gBAAgB;AAAA,EAA9C;AAAA;AACL,SAAS,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,OAAO,OAA6C;AAC3D,QAAI,QAAQ;AACZ,QAAI,CAAC,KAAK,WAAW,KAAK,GAAG;AAC3B,cAAQ,KAAK,IAAI,KAAK;AAAA,IACxB;AAEA,UAAM,KAAK;AAAA,MACT,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AACA,SAAK,MAAM,KAAK,IAAI;AACpB,SAAK,MAAM,KAAK,IAAI;AACpB,UAAM,UAAU,IAAI,YAAY;AAEhC,WAAO,QAAQ,QAAQ;AAAA,MACrB,MAAM;AAAA,MACN,QAAQ,IAAI,eAA2B;AAAA,QACrC,MAAM,OAAa;AACjB,aAAG,UAAU,GAAG,UAAU,QAAQ,OAAO,KAAK;AAAA,QAChD;AAAA,QACA,QAAc;AAAA,QAEd;AAAA,QACA,QAAc;AACZ,gBAAM,IAAI,MAAM,iBAAiB;AAAA,QACnC;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;","names":["process"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adviser/cement",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "better try/catch/finally handling",
   "main": "index.js",
   "type": "module",
@@ -73,7 +73,7 @@
     "build": "pnpm run build:tsc; pnpm run build:js; pnpm run build:deno",
     "build:tsc": "tsc",
     "xbuild:js": "tsup",
-    "build:js": "tsup --out-dir dist/pkg src/index.ts src/*/index.ts --sourcemap --format cjs,esm --dts --clean --external node:fs --external node:path",
+    "build:js": "tsup --metafile --out-dir dist/pkg src/index.ts src/*/index.ts --sourcemap --format cjs,esm --dts --clean --external node:fs --external node:path",
     "build:deno": "deno publish --dry-run --unstable-sloppy-imports --allow-dirty",
     "test": "pnpm run test:js; pnpm run test:deno",
     "test:deno": "deno run --quiet --allow-net --allow-write --allow-run  --allow-sys --allow-ffi  --allow-read --allow-env  ./node_modules/vitest/vitest.mjs --run --project node",

package/src/cf/cf-sys-abstraction.ts

@@ -1,7 +1,7 @@
 import { BaseSysAbstraction, WrapperSysAbstraction, WrapperSysAbstractionParams } from "../base-sys-abstraction.js";
 import { SysAbstraction, SystemService, VoidFunc } from "../sys-abstraction.js";
 import { Env, envFactory } from "../sys-env.js";
-import { Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 import { WebFileService } from "../web/web-sys-abstraction.js";
 
 export class CFSystemService implements SystemService {
@@ -25,7 +25,7 @@ let my: BaseSysAbstraction | undefined = undefined;
 export function CFSysAbstraction(param?: WrapperSysAbstractionParams): SysAbstraction {
   if (!my) {
     my = new BaseSysAbstraction({
-      TxtEnDecoder: param?.TxtEnDecoder || Utf8EnDecoderSingleton(),
+      TxtEnDecoder: param?.TxtEnDecoder || TxtEnDecoderSingleton(),
       FileSystem: new WebFileService(),
       SystemService: new CFSystemService(),
     });

package/src/cf/index.ts

@@ -1 +1,2 @@
 export * from "./cf-sys-abstraction.js";
+export * from "./cf-env-actions.js";

package/src/deno/deno-file-service.ts

@@ -1,6 +1,6 @@
 import * as path from "node:path";
 import { FileService, NamedWritableStream } from "../file-service.js";
-import { TxtEnDecoder, Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoder, TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 
 const Deno = (globalThis as unknown as { Deno: unknown }).Deno as {
   cwd(): string;
@@ -12,7 +12,7 @@ const Deno = (globalThis as unknown as { Deno: unknown }).Deno as {
 export class DenoFileService implements FileService {
   readonly baseDir: string;
   readonly txtEnde: TxtEnDecoder;
-  constructor(baseDir: string = Deno.cwd(), txtEnde: TxtEnDecoder = Utf8EnDecoderSingleton()) {
+  constructor(baseDir: string = Deno.cwd(), txtEnde: TxtEnDecoder = TxtEnDecoderSingleton()) {
     this.baseDir = this.abs(baseDir);
     this.txtEnde = txtEnde;
   }
@@ -64,7 +64,7 @@ export class DenoFileService implements FileService {
     return path.isAbsolute(fname);
   }
 
-  async writeFileString(fname: string, content: string, ende: TxtEnDecoder = Utf8EnDecoderSingleton()): Promise<void> {
+  async writeFileString(fname: string, content: string, ende: TxtEnDecoder = TxtEnDecoderSingleton()): Promise<void> {
     const o = await this.create(fname);
     const wr = o.stream.getWriter();
     await wr.write(ende.encode(content));

package/src/deno/deno-sys-abstraction.ts

@@ -7,7 +7,7 @@ import {
 } from "../base-sys-abstraction.js";
 import { SysAbstraction, SystemService, VoidFunc } from "../sys-abstraction.js";
 import { Env, envFactory } from "../sys-env.js";
-import { Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 // import * as process from "node:process";
 import { DenoFileService } from "./deno-file-service.js";
 
@@ -125,7 +125,7 @@ let my: BaseSysAbstraction | undefined = undefined;
 export function DenoSysAbstraction(param?: WrapperSysAbstractionParams): SysAbstraction {
   if (!my) {
     my = new BaseSysAbstraction({
-      TxtEnDecoder: param?.TxtEnDecoder || Utf8EnDecoderSingleton(),
+      TxtEnDecoder: param?.TxtEnDecoder || TxtEnDecoderSingleton(),
       FileSystem: new DenoFileService(),
       SystemService: new DenoSystemService(),
     });

package/src/http_header.ts

@@ -37,7 +37,7 @@ export class HeadersImpl extends Headers {
 export class HttpHeader {
   readonly _headers: Map<string, string[]> = new Map<string, string[]>();
 
-  static from(headers?: HeadersInit | NodeJS.Dict<string | string[]> | Headers | HttpHeader): HttpHeader {
+  static from(headers?: HeadersInit | Headers | HttpHeader): HttpHeader {
     if (headers instanceof HttpHeader) {
       return headers.Clone();
     }

package/src/index.ts

@@ -19,7 +19,11 @@ export * from "./base-sys-abstraction.js";
 export * from "./bin2text.js";
 export * from "./version.js";
 export * from "./http_header.js";
-export * as utils from "./utils/index.js";
+export * from "./path-ops.js";
+export * from "./json-en-decoder.js";
+
 // ugly
+export * as utils from "./utils/index.js";
 import * as utils from "./utils/index.js";
+
 export const param = utils.param;

package/src/json-en-decoder.ts

@@ -0,0 +1,83 @@
+import { exception2Result, Result } from "./result.js";
+import { AsyncToEnDecoder, ToEnDecoder, TxtEnDecoder, TxtEnDecoderSingleton as TxtEnDecoderSingleton } from "./txt-en-decoder.js";
+
+export interface JSONEnDecoder {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  stringify<T>(input: Result<T> | T, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
+  asyncStringify<T>(
+    input: Promise<Result<T> | T>,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    replacer?: (this: any, key: string, value: any) => any,
+    space?: string | number,
+  ): Promise<string>;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  uint8ify<T>(input: Result<T> | T, replacer?: (this: any, key: string, value: any) => any, space?: string | number): Uint8Array;
+  asyncUint8ify<T>(
+    input: Promise<Result<T> | T>,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    replacer?: (this: any, key: string, value: any) => any,
+    space?: string | number,
+  ): Promise<Uint8Array>;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  parse<T>(input: ToEnDecoder, reviver?: (this: any, key: string, value: any) => any): Result<T>;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  asyncParse<T>(input: AsyncToEnDecoder, reviver?: (this: any, key: string, value: any) => any): Promise<Result<T>>;
+}
+
+class JSONOps implements JSONEnDecoder {
+  readonly txtOps: TxtEnDecoder;
+  constructor(txtOps: TxtEnDecoder) {
+    this.txtOps = txtOps;
+  }
+  async asyncStringify<T>(
+    input: Promise<Result<T> | T>,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    replacer?: (this: any, key: string, value: any) => any,
+    space?: string | number,
+  ): Promise<string> {
+    const resolved = await input;
+    return this.stringify(resolved, replacer, space);
+  }
+  async asyncUint8ify<T>(
+    input: Promise<Result<T> | T>,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    replacer?: (this: any, key: string, value: any) => any,
+    space?: string | number,
+  ): Promise<Uint8Array> {
+    const resolved = await input;
+    return this.uint8ify(resolved, replacer, space);
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async asyncParse<T>(input: AsyncToEnDecoder, reviver?: (this: any, key: string, value: any) => any): Promise<Result<T>> {
+    return this.parse(await this.txtOps.asyncDecode(input), reviver);
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  stringify<T>(input: Result<T> | T, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string {
+    return JSON.stringify(Result.Is(input) ? input.unwrap() : input, replacer, space);
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  uint8ify<T>(input: Result<T> | T, replacer?: (this: any, key: string, value: any) => any, space?: string | number): Uint8Array {
+    return this.txtOps.encode(this.stringify(input, replacer, space));
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  parse<T>(input: ToEnDecoder, reviver?: (this: any, key: string, value: any) => any): Result<T> {
+    return exception2Result(() => JSON.parse(this.txtOps.decode(input), reviver) as T) as Result<T>;
+  }
+}
+
+let jsonEnDecoder: JSONEnDecoder;
+export function JSONEnDecoderSingleton(txtEnde?: TxtEnDecoder): JSONEnDecoder {
+  let needNew = false;
+  if (txtEnde && txtEnde !== TxtEnDecoderSingleton()) {
+    needNew = !!txtEnde;
+    txtEnde = txtEnde ?? TxtEnDecoderSingleton();
+  }
+  if (needNew && txtEnde) {
+    return new JSONOps(txtEnde);
+  }
+  jsonEnDecoder = jsonEnDecoder ?? new JSONOps(TxtEnDecoderSingleton());
+  return jsonEnDecoder;
+}

package/src/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@adviser/cement",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "exports": {
     ".": "./index.ts",
     "./web": "./web/index.ts",

package/src/logger-impl.ts

@@ -26,7 +26,7 @@ import { CoerceURI, URI } from "./uri.js";
 import { runtimeFn } from "./runtime.js";
 import { ConsoleWriterStream } from "./utils/console-write-stream.js";
 import { LogWriterStream } from "./log-writer-impl.js";
-import { TxtEnDecoder, Utf8EnDecoderSingleton } from "./txt-en-decoder.js";
+import { TxtEnDecoder, TxtEnDecoderSingleton } from "./txt-en-decoder.js";
 import { LevelHandlerSingleton } from "./log-level-impl.js";
 
 function getLen(value: unknown, lvs: LogValueState): LogValue {
@@ -126,7 +126,7 @@ export class LoggerImpl implements Logger {
       this._sys = params.sys;
     }
     if (!params.txtEnDe) {
-      this._txtEnDe = Utf8EnDecoderSingleton();
+      this._txtEnDe = TxtEnDecoderSingleton();
     } else {
       this._txtEnDe = params.txtEnDe;
     }

package/src/node/node-file-service.ts

@@ -2,7 +2,7 @@ import path from "node:path";
 import fs from "node:fs";
 import process from "node:process";
 import { FileService, NamedWritableStream } from "../file-service.js";
-import { TxtEnDecoder, Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoder, TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 
 export class NodeFileService implements FileService {
   readonly baseDir: string;
@@ -57,7 +57,7 @@ export class NodeFileService implements FileService {
     return path.isAbsolute(fname);
   }
 
-  async writeFileString(fname: string, content: string, ende: TxtEnDecoder = Utf8EnDecoderSingleton()): Promise<void> {
+  async writeFileString(fname: string, content: string, ende: TxtEnDecoder = TxtEnDecoderSingleton()): Promise<void> {
     const o = await this.create(fname);
     const wr = o.stream.getWriter();
     await wr.write(ende.encode(content));

package/src/node/node-sys-abstraction.ts

@@ -8,7 +8,7 @@ import {
 } from "../base-sys-abstraction.js";
 import { NodeFileService } from "./node-file-service.js";
 import { Env, envFactory } from "../sys-env.js";
-import { Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 import process from "node:process";
 
 export class NodeExitServiceImpl implements ExitService {
@@ -112,7 +112,7 @@ let my: BaseSysAbstraction | undefined = undefined;
 export function NodeSysAbstraction(param?: WrapperSysAbstractionParams): SysAbstraction {
   if (!my) {
     my = new BaseSysAbstraction({
-      TxtEnDecoder: param?.TxtEnDecoder || Utf8EnDecoderSingleton(),
+      TxtEnDecoder: param?.TxtEnDecoder || TxtEnDecoderSingleton(),
       FileSystem: new NodeFileService(),
       SystemService: new NodeSystemService(),
     });

package/src/path-ops.ts

@@ -0,0 +1,30 @@
+export interface PathOps {
+  join(...args: string[]): string;
+  dirname(path: string): string;
+  basename(path: string): string;
+}
+
+class pathOpsImpl implements PathOps {
+  join(...paths: string[]): string {
+    return paths.map((i) => i.replace(/\/+$/, "")).join("/");
+  }
+  #parts(path: string): { dirname: string; basename: string } {
+    const splitted = path.split("/");
+    const last = splitted.pop();
+    if (splitted.length && last === "") {
+      return this.#parts(this.join(...splitted));
+    }
+    return {
+      dirname: this.join(...splitted),
+      basename: last ?? "",
+    };
+  }
+  dirname(path: string): string {
+    return this.#parts(path).dirname;
+  }
+  basename(path: string): string {
+    return this.#parts(path).basename;
+  }
+}
+
+export const pathOps: PathOps = new pathOpsImpl();

package/src/test/log-write-stream.ts

@@ -1,6 +1,6 @@
 import { FanoutWriteStream } from "../utils/fanout-write-stream.js";
 import { Future } from "../future.js";
-import { TxtEnDecoder, Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoder, TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 
 export class LogWriteStream implements WritableStreamDefaultWriter<Uint8Array> {
   private readonly _bufferArr: Uint8Array[];
@@ -42,7 +42,7 @@ export class LogCollector implements WritableStream<Uint8Array> {
 
   constructor(pass?: WritableStreamDefaultWriter<Uint8Array>, txtEnDe?: TxtEnDecoder) {
     this._pass = pass;
-    this._txtEnDe = txtEnDe || Utf8EnDecoderSingleton();
+    this._txtEnDe = txtEnDe || TxtEnDecoderSingleton();
   }
 
   // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/src/txt-en-decoder.ts

@@ -1,21 +1,50 @@
+import { Result } from "./result.js";
+import { coerceIntoUint8, ToUInt8 } from "./utils/coerce-uint8.js";
+
+export type ToEnDecoder = ToUInt8 | string | Result<string>;
+export type AsyncToEnDecoder = ToEnDecoder | Blob | Promise<ToEnDecoder | Blob>;
+
 export interface TxtEnDecoder {
-  encode(str: string): Uint8Array;
-  decode(data: Uint8Array): string;
+  encode(input: string): Uint8Array;
+  decode(input: ToEnDecoder): string;
+  asyncDecode(input: AsyncToEnDecoder): Promise<string>;
 }
 
-const encoder = new TextEncoder();
-const decoder = new TextDecoder();
+class TxtOps implements TxtEnDecoder {
+  readonly encoder = new TextEncoder();
+  readonly decoder = new TextDecoder();
 
-export class Utf8EnDecoder implements TxtEnDecoder {
   encode(str: string): Uint8Array {
-    return encoder.encode(str);
+    return this.encoder.encode(str);
   }
-  decode(data: Uint8Array): string {
-    return decoder.decode(data);
+  decode(data: ToEnDecoder): string {
+    if (Result.Is(data)) {
+      if (data.isErr()) {
+        throw data.Err();
+      }
+      // only for string let do coerceInto the work
+      const unwrapped = data.unwrap();
+      if (typeof unwrapped === "string") {
+        return this.decode(unwrapped);
+      }
+    }
+    if (typeof data === "string") {
+      return data;
+    }
+    return this.decoder.decode(coerceIntoUint8(data as ToUInt8).Ok());
+  }
+
+  async asyncDecode(data: AsyncToEnDecoder): Promise<string> {
+    let resolved = await data;
+    if (resolved instanceof Blob) {
+      resolved = await resolved.arrayBuffer();
+    }
+    return this.decode(resolved);
   }
 }
 
-const utf8EnDecoder = new Utf8EnDecoder();
-export function Utf8EnDecoderSingleton(): TxtEnDecoder {
-  return utf8EnDecoder;
+let txtEnDecoder: TxtEnDecoder;
+export function TxtEnDecoderSingleton(): TxtEnDecoder {
+  txtEnDecoder = txtEnDecoder ?? new TxtOps();
+  return txtEnDecoder;
 }

package/src/utils/coerce-uint8.ts

@@ -0,0 +1,53 @@
+import { Result } from "../result.js";
+
+// Tested in txt-en-decoder.test.ts
+
+interface GlobalBuffer {
+  Buffer?: {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isBuffer: (obj: any) => obj is {
+      buffer: ArrayBufferLike;
+      byteOffset: number;
+      byteLength: number;
+    };
+  };
+}
+const globalBuffer = globalThis as GlobalBuffer;
+
+export type ToUInt8Plain = Uint8Array | ArrayBuffer | ArrayBufferView;
+export type ToUInt8Async = ToUInt8Plain | Blob;
+export type ToUInt8 = ToUInt8Plain | Result<ToUInt8Plain>;
+export type AsyncToUInt8 = ToUInt8Async | Result<ToUInt8Async> | Promise<ToUInt8Async> | Promise<Result<ToUInt8Async>>;
+
+export function coerceIntoUint8(raw: ToUInt8): Result<Uint8Array> {
+  if (raw instanceof ArrayBuffer) {
+    return Result.Ok(new Uint8Array(raw));
+  }
+  if (ArrayBuffer.isView(raw)) {
+    return Result.Ok(new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength));
+  }
+  if (raw instanceof Blob) {
+    return Result.Err("Blob not supported");
+  }
+  if (globalBuffer.Buffer && globalBuffer.Buffer.isBuffer(raw)) {
+    return Result.Ok(new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength));
+  }
+  if (raw instanceof Uint8Array) {
+    return Result.Ok(raw);
+  }
+  if (Result.Is(raw)) {
+    if (raw.isErr()) {
+      return Result.Err(raw);
+    }
+    return coerceIntoUint8(raw.unwrap());
+  }
+  return Result.Err("Not a Uint8Array");
+}
+
+export async function asyncCoerceIntoUint8(raw: AsyncToUInt8): Promise<Result<Uint8Array>> {
+  let resolved = await raw;
+  if (resolved instanceof Blob) {
+    resolved = await resolved.arrayBuffer();
+  }
+  return coerceIntoUint8(resolved as ToUInt8);
+}

package/src/utils/index.ts

@@ -6,3 +6,6 @@ export * from "./console-write-stream.js";
 export * from "./fanout-write-stream.js";
 export * from "./get-params-result.js";
 export * from "./stripper.js";
+export * from "./sorted-object.js";
+export * from "./uint8array-equal.js";
+export * from "./coerce-uint8.js";

package/src/utils/sorted-object.ts

@@ -0,0 +1,18 @@
+export function toSortedObjectArray<T>(set?: T): Record<string, unknown>[] {
+  if (!set) return [];
+  return toSortedArray(set).map(([k, v]) => ({ [k]: v }));
+}
+
+export function toSortedArray<T>(set?: T): [string, unknown][] {
+  if (!set) return [];
+  return Object.entries(set).sort(([a], [b]) => a.localeCompare(b));
+}
+
+export function toSortedObject<S, T extends NonNullable<S>>(set?: T): T {
+  if (!set) return set as T;
+  return Object.fromEntries(toSortedArray(set)) as T;
+  // return toSortedArray(set).reduce((acc, cur) => {
+  //     acc[cur[0]] = cur[1];
+  //     return acc
+  // }, {} as Record<string, unknown>) as T;
+}

package/src/utils/string2stream.ts

@@ -1,6 +1,6 @@
-import { TxtEnDecoder, Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoder, TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 
-export function string2stream(str: string, ende: TxtEnDecoder = Utf8EnDecoderSingleton()): ReadableStream<Uint8Array> {
+export function string2stream(str: string, ende: TxtEnDecoder = TxtEnDecoderSingleton()): ReadableStream<Uint8Array> {
   return uint8array2stream(ende.encode(str));
 }
 

package/src/utils/uint8array-equal.ts

@@ -0,0 +1,11 @@
+export function UInt8ArrayEqual(a: Uint8Array, b: Uint8Array): boolean {
+  if (a.length !== b.length) {
+    return false;
+  }
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) {
+      return false;
+    }
+  }
+  return true;
+}

package/src/web/web-sys-abstraction.ts

@@ -2,7 +2,7 @@ import { BaseSysAbstraction, WrapperSysAbstraction, WrapperSysAbstractionParams
 import { FileService, NamedWritableStream } from "../file-service.js";
 import { SysAbstraction, SystemService, VoidFunc } from "../sys-abstraction.js";
 import { Env, envFactory } from "../sys-env.js";
-import { Utf8EnDecoderSingleton } from "../txt-en-decoder.js";
+import { TxtEnDecoderSingleton } from "../txt-en-decoder.js";
 
 export class WebFileService implements FileService {
   get baseDir(): string {
@@ -71,7 +71,7 @@ let my: BaseSysAbstraction | undefined = undefined;
 export function WebSysAbstraction(param?: WrapperSysAbstractionParams): SysAbstraction {
   if (!my) {
     my = new BaseSysAbstraction({
-      TxtEnDecoder: param?.TxtEnDecoder || Utf8EnDecoderSingleton(),
+      TxtEnDecoder: param?.TxtEnDecoder || TxtEnDecoderSingleton(),
       FileSystem: new WebFileService(),
       SystemService: new WebSystemService(),
     });

package/{sys-abstraction-BRDT_TIU.d.cts → sys-abstraction-3OXhCVsu.d.cts}

@@ -1,4 +1,4 @@
-import { K as KeysParam, R as Result } from './get-params-result-Bhy5997x.cjs';
+import { K as KeysParam, R as Result } from './get-params-result-C2cbgB78.cjs';
 
 interface NamedWritableStream {
     readonly name: string;
@@ -106,4 +106,4 @@ interface SysAbstraction {
     FileSystem(): FileService;
 }
 
-export { type Duration as D, type Env as E, type FileService as F, IDMode as I, type NamedWritableStream as N, type OnSetItem as O, RandomMode as R, type SystemService as S, Time as T, type VoidFunc as V, type SysAbstraction as a, TimeMode as b, String2TimeMode as c, type EnvTuple as d, type EnvMap as e, type EnvActions as f, type EnvFactoryOpts as g, type EnvFactoryFn as h, envFactory as i, EnvImpl as j, TimeUnits as k, registerEnvAction as r };
+export { type Duration as D, type Env as E, type FileService as F, IDMode as I, type NamedWritableStream as N, type OnSetItem as O, RandomMode as R, type SysAbstraction as S, Time as T, type VoidFunc as V, TimeMode as a, type SystemService as b, type EnvActions as c, EnvImpl as d, type EnvFactoryOpts as e, String2TimeMode as f, type EnvTuple as g, type EnvMap as h, type EnvFactoryFn as i, envFactory as j, TimeUnits as k, registerEnvAction as r };

package/{sys-abstraction-Bd0EzwO6.d.ts → sys-abstraction-DXeSUn9x.d.ts}

@@ -1,4 +1,4 @@
-import { K as KeysParam, R as Result } from './get-params-result-Bhy5997x.js';
+import { K as KeysParam, R as Result } from './get-params-result-C2cbgB78.js';
 
 interface NamedWritableStream {
     readonly name: string;
@@ -106,4 +106,4 @@ interface SysAbstraction {
     FileSystem(): FileService;
 }
 
-export { type Duration as D, type Env as E, type FileService as F, IDMode as I, type NamedWritableStream as N, type OnSetItem as O, RandomMode as R, type SystemService as S, Time as T, type VoidFunc as V, type SysAbstraction as a, TimeMode as b, String2TimeMode as c, type EnvTuple as d, type EnvMap as e, type EnvActions as f, type EnvFactoryOpts as g, type EnvFactoryFn as h, envFactory as i, EnvImpl as j, TimeUnits as k, registerEnvAction as r };
+export { type Duration as D, type Env as E, type FileService as F, IDMode as I, type NamedWritableStream as N, type OnSetItem as O, RandomMode as R, type SysAbstraction as S, Time as T, type VoidFunc as V, TimeMode as a, type SystemService as b, type EnvActions as c, EnvImpl as d, type EnvFactoryOpts as e, String2TimeMode as f, type EnvTuple as g, type EnvMap as h, type EnvFactoryFn as i, envFactory as j, TimeUnits as k, registerEnvAction as r };