zeed 1.2.4 → 1.3.0

package/AGENTS.md

@@ -89,9 +89,10 @@ The `package.json` exports field automatically selects the right build:
 {
   "exports": {
     ".": {
-      "types": "./dist/index.all.d.ts",
-      "node": "./dist/index.node.js",
-      "default": "./dist/index.browser.js"
+      "types": "./dist/index.all.d.mts",
+      "require": "./dist/index.node.cjs",
+      "node": "./dist/index.node.mjs",
+      "default": "./dist/index.browser.mjs"
     }
   }
 }
@@ -218,12 +219,12 @@ e.on('inc', async count => count + 1)
 
 ## Build System
 
-- **Bundler**: tsup (esbuild-based)
-- **Output**: ESM + CJS in `dist/` with TypeScript declarations
+- **Bundler**: tsdown (rolldown-based)
+- **Output**: ESM + CJS in `dist/` with `.mjs` / `.cjs` entry files and TypeScript declarations
 - **Target**: ES2022
 - **Features**: Tree-shaking, minification, source maps, code splitting
 
-The build creates multiple entry points but maintains a single type definition file (`dist/index.all.d.ts`) for simplicity.
+The build creates multiple entry points and emits matching declaration files such as `dist/index.all.d.mts`, `dist/index.node.d.mts`, and `dist/index.node.d.cts`.
 
 ## Package Management
 

package/README.md

@@ -79,11 +79,11 @@ log.error('Error')
 
 **Terminal output:**
 
-<img src=".assets/node-console@2x.png" width="566" style="max-width:100%">
+<img src=".assets/node-console@2x.png" alt="" width="566" style="max-width:100%">
 
 **Browser output:**
 
-<img src=".assets/safari-console.png" style="max-width:100%">
+<img src=".assets/safari-console.png" alt="" style="max-width:100%">
 
 <details>
 <summary>📖 Learn more about logging features</summary>

package/dist/_experiments/bitcask.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } var _class;var _chunkP7XCQ7WVcjs = require('../chunk-P7XCQ7WV.cjs');var _fs = require('fs'); var s = _interopRequireWildcard(_fs);var _path = require('path'); var B = _interopRequireWildcard(_path);var _promises = require('fs/promises');var l=17,g= exports.Bitcask = (_class =class{static{_chunkP7XCQ7WVcjs.a.call(void 0, this,"Bitcask")}__init() {this.keydir=new Map}__init2() {this.activeFile=null}__init3() {this.activeFileId=0}__init4() {this.activeOffset=0}__init5() {this.openFiles=new Map}constructor(t,e={}){;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);this.dirname=t,this.readWrite=e.readWrite!==!1,this.syncOnPut=e.syncOnPut===!0,s.existsSync(t)||s.mkdirSync(t,{recursive:!0}),this.loadFiles(),this.readWrite&&this.rollover()}listDataFiles(){return s.readdirSync(this.dirname).filter(t=>t.endsWith(".data")).sort()}loadFiles(){for(let t of this.listDataFiles()){let e=parseInt(t.split(".")[0],10),i=B.join(this.dirname,t),n=s.openSync(i,"r"),r=0;for(;;){let f=Buffer.alloc(l);if(s.readSync(n,f,0,l,r)<l)break;let c=f.readUInt32BE(0),d=f.readUInt32BE(4),u=f.readUInt8(8)===1,y=f.readBigUInt64BE(9),m=Buffer.alloc(c);s.readSync(n,m,0,c,r+l);let p=l+c+d;this.keydir.set(m.toString("binary"),{fileId:e,offset:r,size:p,timestamp:y,tombstone:u}),r+=p}s.closeSync(n)}}rollover(){let t=this.listDataFiles().map(r=>parseInt(r.split(".")[0],10)),e=t.length?Math.max(...t)+1:1,i=`${e.toString().padStart(8,"0")}.data`,n=B.join(this.dirname,i);this.activeFile=s.createWriteStream(n,{flags:"a"}),this.activeFileId=e,this.activeOffset=s.existsSync(n)?s.statSync(n).size:0}async put(t,e){if(!this.readWrite)throw new Error("Read-only mode");let i=Buffer.isBuffer(t)?t:Buffer.from(t),n=Buffer.isBuffer(e)?e:Buffer.from(e),r=BigInt(Date.now()),f=0,a=Buffer.alloc(l);a.writeUInt32BE(i.length,0),a.writeUInt32BE(n.length,4),a.writeUInt8(f,8),a.writeBigUInt64BE(r,9);let c=Buffer.concat([a,i,n]),d=this.activeOffset;await new Promise((u,y)=>{this.activeFile.write(c,m=>m?y(m):u())}),this.syncOnPut&&this.activeFile&&s.fsyncSync(this.activeFile.fd),this.keydir.set(i.toString("binary"),{fileId:this.activeFileId,offset:d,size:c.length,timestamp:r,tombstone:!1}),this.activeOffset+=c.length,this.activeOffset>32*1024*1024&&(this.activeFile.close(),this.rollover())}async get(t){let e=Buffer.isBuffer(t)?t:Buffer.from(t),i=this.keydir.get(e.toString("binary"));if(!i||i.tombstone)return null;let n=this.openFiles.get(i.fileId);if(!n){let u=B.join(this.dirname,`${i.fileId.toString().padStart(8,"0")}.data`);n=await _promises.open.call(void 0, u,"r"),this.openFiles.set(i.fileId,n)}let r=Buffer.alloc(l);await n.read(r,0,l,i.offset);let f=r.readUInt32BE(0),a=r.readUInt32BE(4),c=Buffer.alloc(f);await n.read(c,0,f,i.offset+l);let d=Buffer.alloc(a);return await n.read(d,0,a,i.offset+l+f),d}async delete(t){if(!this.readWrite)throw new Error("Read-only mode");let e=Buffer.isBuffer(t)?t:Buffer.from(t),i=BigInt(Date.now()),n=1,r=Buffer.alloc(l);r.writeUInt32BE(e.length,0),r.writeUInt32BE(0,4),r.writeUInt8(n,8),r.writeBigUInt64BE(i,9);let f=Buffer.concat([r,e]),a=this.activeOffset;await new Promise((c,d)=>{this.activeFile.write(f,u=>u?d(u):c())}),this.syncOnPut&&this.activeFile&&s.fsyncSync(this.activeFile.fd),this.keydir.set(e.toString("binary"),{fileId:this.activeFileId,offset:a,size:f.length,timestamp:i,tombstone:!0}),this.activeOffset+=f.length,this.activeOffset>32*1024*1024&&(this.activeFile.close(),this.rollover())}listKeys(){return Array.from(this.keydir.entries()).filter(([t,e])=>!e.tombstone).map(([t,e])=>t)}async fold(t,e){for(let[i,n]of this.keydir.entries())if(!n.tombstone){let r=await this.get(i);e=t(i,r,e)}return e}async merge(){let t=new Map;for(let[a,c]of this.keydir.entries())c.tombstone||t.set(a,c);let e=this.listDataFiles().map(a=>parseInt(a.split(".")[0],10)),i=e.length?Math.max(...e)+1:1,n=`${i.toString().padStart(8,"0")}.data`,r=B.join(this.dirname,n),f=s.createWriteStream(r,{flags:"a"});for(let[a,c]of t.entries()){let d=await this.get(a),u=Buffer.from(a,"binary"),y=Buffer.alloc(l);y.writeUInt32BE(u.length,0),y.writeUInt32BE(d.length,4),y.writeUInt8(0,8),y.writeBigUInt64BE(c.timestamp,9);let m=Buffer.concat([y,u,d]);await new Promise((p,w)=>{f.write(m,v=>v?w(v):p())})}f.close();for(let a of e)if(a!==this.activeFileId&&a!==i)try{s.unlinkSync(B.join(this.dirname,`${a.toString().padStart(8,"0")}.data`))}catch (e2){}this.loadFiles()}sync(){this.activeFile&&s.fsyncSync(this.activeFile.fd)}async close(){this.activeFile&&this.activeFile.end();for(let t of this.openFiles.values())await t.close();this.openFiles.clear()}}, _class);function b(o,t){return new g(o,t)}_chunkP7XCQ7WVcjs.a.call(void 0, b,"open");async function k(o,t){let e=await o.get(t);return e===null?"not found":e}_chunkP7XCQ7WVcjs.a.call(void 0, k,"get");async function E(o,t,e){return await o.put(t,e),"ok"}_chunkP7XCQ7WVcjs.a.call(void 0, E,"put");async function U(o,t){return await o.delete(t),"ok"}_chunkP7XCQ7WVcjs.a.call(void 0, U,"del");function x(o){return o.listKeys()}_chunkP7XCQ7WVcjs.a.call(void 0, x,"listKeys");async function O(o,t,e){return await o.fold(t,e)}_chunkP7XCQ7WVcjs.a.call(void 0, O,"fold");async function P(o){let t=new g(o,{readWrite:!0});return await t.merge(),t.close(),"ok"}_chunkP7XCQ7WVcjs.a.call(void 0, P,"merge");function W(o){return o.sync(),"ok"}_chunkP7XCQ7WVcjs.a.call(void 0, W,"sync");async function z(o){return await o.close(),"ok"}_chunkP7XCQ7WVcjs.a.call(void 0, z,"close");exports.Bitcask = g; exports.close = z; exports.del = U; exports.fold = O; exports.get = k; exports.listKeys = x; exports.merge = P; exports.open = b; exports.put = E; exports.sync = W;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../chunk-D-qHiVGv.cjs`);let t=require(`fs`);t=e.n(t);let n=require(`path`);n=e.n(n);let r=require(`fs/promises`);var i=class{dirname;readWrite;syncOnPut;keydir=new Map;activeFile=null;activeFileId=0;activeOffset=0;openFiles=new Map;constructor(e,n={}){this.dirname=e,this.readWrite=n.readWrite!==!1,this.syncOnPut=n.syncOnPut===!0,t.existsSync(e)||t.mkdirSync(e,{recursive:!0}),this.loadFiles(),this.readWrite&&this.rollover()}listDataFiles(){return t.readdirSync(this.dirname).filter(e=>e.endsWith(`.data`)).sort()}loadFiles(){for(let e of this.listDataFiles()){let r=parseInt(e.split(`.`)[0],10),i=n.join(this.dirname,e),a=t.openSync(i,`r`),o=0;for(;;){let e=Buffer.alloc(17);if(t.readSync(a,e,0,17,o)<17)break;let n=e.readUInt32BE(0),i=e.readUInt32BE(4),s=e.readUInt8(8)===1,c=e.readBigUInt64BE(9),l=Buffer.alloc(n);t.readSync(a,l,0,n,o+17);let u=17+n+i;this.keydir.set(l.toString(`binary`),{fileId:r,offset:o,size:u,timestamp:c,tombstone:s}),o+=u}t.closeSync(a)}}rollover(){let e=this.listDataFiles().map(e=>parseInt(e.split(`.`)[0],10)),r=e.length?Math.max(...e)+1:1,i=`${r.toString().padStart(8,`0`)}.data`,a=n.join(this.dirname,i);this.activeFile=t.createWriteStream(a,{flags:`a`}),this.activeFileId=r,this.activeOffset=t.existsSync(a)?t.statSync(a).size:0}async put(e,n){if(!this.readWrite)throw Error(`Read-only mode`);let r=Buffer.isBuffer(e)?e:Buffer.from(e),i=Buffer.isBuffer(n)?n:Buffer.from(n),a=BigInt(Date.now()),o=Buffer.alloc(17);o.writeUInt32BE(r.length,0),o.writeUInt32BE(i.length,4),o.writeUInt8(0,8),o.writeBigUInt64BE(a,9);let s=Buffer.concat([o,r,i]),c=this.activeOffset;await new Promise((e,t)=>{this.activeFile.write(s,n=>n?t(n):e())}),this.syncOnPut&&this.activeFile&&t.fsyncSync(this.activeFile.fd),this.keydir.set(r.toString(`binary`),{fileId:this.activeFileId,offset:c,size:s.length,timestamp:a,tombstone:!1}),this.activeOffset+=s.length,this.activeOffset>32*1024*1024&&(this.activeFile.close(),this.rollover())}async get(e){let t=Buffer.isBuffer(e)?e:Buffer.from(e),i=this.keydir.get(t.toString(`binary`));if(!i||i.tombstone)return null;let a=this.openFiles.get(i.fileId);a||(a=await(0,r.open)(n.join(this.dirname,`${i.fileId.toString().padStart(8,`0`)}.data`),`r`),this.openFiles.set(i.fileId,a));let o=Buffer.alloc(17);await a.read(o,0,17,i.offset);let s=o.readUInt32BE(0),c=o.readUInt32BE(4),l=Buffer.alloc(s);await a.read(l,0,s,i.offset+17);let u=Buffer.alloc(c);return await a.read(u,0,c,i.offset+17+s),u}async delete(e){if(!this.readWrite)throw Error(`Read-only mode`);let n=Buffer.isBuffer(e)?e:Buffer.from(e),r=BigInt(Date.now()),i=Buffer.alloc(17);i.writeUInt32BE(n.length,0),i.writeUInt32BE(0,4),i.writeUInt8(1,8),i.writeBigUInt64BE(r,9);let a=Buffer.concat([i,n]),o=this.activeOffset;await new Promise((e,t)=>{this.activeFile.write(a,n=>n?t(n):e())}),this.syncOnPut&&this.activeFile&&t.fsyncSync(this.activeFile.fd),this.keydir.set(n.toString(`binary`),{fileId:this.activeFileId,offset:o,size:a.length,timestamp:r,tombstone:!0}),this.activeOffset+=a.length,this.activeOffset>32*1024*1024&&(this.activeFile.close(),this.rollover())}listKeys(){return Array.from(this.keydir.entries()).filter(([e,t])=>!t.tombstone).map(([e,t])=>e)}async fold(e,t){for(let[n,r]of this.keydir.entries())r.tombstone||(t=e(n,await this.get(n),t));return t}async merge(){let e=new Map;for(let[t,n]of this.keydir.entries())n.tombstone||e.set(t,n);let r=this.listDataFiles().map(e=>parseInt(e.split(`.`)[0],10)),i=r.length?Math.max(...r)+1:1,a=`${i.toString().padStart(8,`0`)}.data`,o=n.join(this.dirname,a),s=t.createWriteStream(o,{flags:`a`});for(let[t,n]of e.entries()){let e=await this.get(t),r=Buffer.from(t,`binary`),i=Buffer.alloc(17);i.writeUInt32BE(r.length,0),i.writeUInt32BE(e.length,4),i.writeUInt8(0,8),i.writeBigUInt64BE(n.timestamp,9);let a=Buffer.concat([i,r,e]);await new Promise((e,t)=>{s.write(a,n=>n?t(n):e())})}s.close();for(let e of r)if(e!==this.activeFileId&&e!==i)try{t.unlinkSync(n.join(this.dirname,`${e.toString().padStart(8,`0`)}.data`))}catch{}this.loadFiles()}sync(){this.activeFile&&t.fsyncSync(this.activeFile.fd)}async close(){this.activeFile&&this.activeFile.end();for(let e of this.openFiles.values())await e.close();this.openFiles.clear()}};function a(e,t){return new i(e,t)}async function o(e,t){let n=await e.get(t);return n===null?`not found`:n}async function s(e,t,n){return await e.put(t,n),`ok`}async function c(e,t){return await e.delete(t),`ok`}function l(e){return e.listKeys()}async function u(e,t,n){return await e.fold(t,n)}async function d(e){let t=new i(e,{readWrite:!0});return await t.merge(),t.close(),`ok`}function f(e){return e.sync(),`ok`}async function p(e){return await e.close(),`ok`}exports.Bitcask=i,exports.close=p,exports.del=c,exports.fold=u,exports.get=o,exports.listKeys=l,exports.merge=d,exports.open=a,exports.put=s,exports.sync=f;
 //# sourceMappingURL=bitcask.cjs.map

package/dist/_experiments/bitcask.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/_experiments/bitcask.cjs","../../src/_experiments/bitcask.ts"],"names":["ENTRY_HEADER_SIZE","Bitcask","__name","dirname","opts","f","fname","fileId","filePath","fd","offset","header","keySize","valueSize","tombstone","timestamp","key","entrySize","fileIds","nextId"],"mappings":"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","file":"/Users/dirk/work/github-zeed/dist/_experiments/bitcask.cjs","sourcesContent":[null,"// Bitcask-inspired key-value store (minimal, single-process, single-writer)\n// Copyright 2024\nimport * as fs from 'fs'\nimport * as path from 'path'\nimport { FileHandle, open as openFile } from 'fs/promises'\n\nconst ENTRY_HEADER_SIZE = 17 // 4 (key) + 4 (value) + 1 (tombstone) + 8 (timestamp)\n\ninterface KeyDirEntry {\n  fileId: number\n  offset: number\n  size: number\n  timestamp: bigint\n  tombstone: boolean\n}\n\nexport class Bitcask {\n  private dirname: string\n  private readWrite: boolean\n  private syncOnPut: boolean\n  private keydir: Map<string, KeyDirEntry> = new Map();\n  private activeFile: fs.WriteStream | null = null;\n  private activeFileId: number = 0;\n  private activeOffset: number = 0;\n  private openFiles: Map<number, FileHandle> = new Map();\n\n  constructor(dirname: string, opts: { readWrite?: boolean; syncOnPut?: boolean } = {}) {\n    this.dirname = dirname\n    this.readWrite = opts.readWrite !== false\n    this.syncOnPut = opts.syncOnPut === true\n    if (!fs.existsSync(dirname)) fs.mkdirSync(dirname, { recursive: true })\n    this.loadFiles()\n    if (this.readWrite) this.rollover()\n  }\n\n  private listDataFiles(): string[] {\n    return fs.readdirSync(this.dirname).filter(f => f.endsWith('.data')).sort()\n  }\n\n  private loadFiles() {\n    for (const fname of this.listDataFiles()) {\n      const fileId = parseInt(fname.split('.')[0], 10)\n      const filePath = path.join(this.dirname, fname)\n      const fd = fs.openSync(filePath, 'r')\n      let offset = 0\n      while (true) {\n        const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n        const bytesRead = fs.readSync(fd, header, 0, ENTRY_HEADER_SIZE, offset)\n        if (bytesRead < ENTRY_HEADER_SIZE) break\n        const keySize = header.readUInt32BE(0)\n        const valueSize = header.readUInt32BE(4)\n        const tombstone = header.readUInt8(8) === 1\n        const timestamp = header.readBigUInt64BE(9)\n        const key = Buffer.alloc(keySize)\n        fs.readSync(fd, key, 0, keySize, offset + ENTRY_HEADER_SIZE)\n        // skip value\n        const entrySize = ENTRY_HEADER_SIZE + keySize + valueSize\n        this.keydir.set(key.toString('binary'), {\n          fileId,\n          offset,\n          size: entrySize,\n          timestamp,\n          tombstone,\n        })\n        offset += entrySize\n      }\n      fs.closeSync(fd)\n    }\n  }\n\n  private rollover() {\n    const fileIds = this.listDataFiles().map(f => parseInt(f.split('.')[0], 10))\n    const nextId = fileIds.length ? Math.max(...fileIds) + 1 : 1\n    const fname = `${nextId.toString().padStart(8, '0')}.data`\n    const filePath = path.join(this.dirname, fname)\n    this.activeFile = fs.createWriteStream(filePath, { flags: 'a' })\n    this.activeFileId = nextId\n    this.activeOffset = fs.existsSync(filePath) ? fs.statSync(filePath).size : 0\n  }\n\n  async put(key: string | Buffer, value: string | Buffer) {\n    if (!this.readWrite) throw new Error('Read-only mode')\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const valueBuf = Buffer.isBuffer(value) ? value : Buffer.from(value)\n    const timestamp = BigInt(Date.now())\n    const tombstone = 0\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    header.writeUInt32BE(keyBuf.length, 0)\n    header.writeUInt32BE(valueBuf.length, 4)\n    header.writeUInt8(tombstone, 8)\n    header.writeBigUInt64BE(timestamp, 9)\n    const entry = Buffer.concat([header, keyBuf, valueBuf])\n    const offset = this.activeOffset\n    await new Promise<void>((resolve, reject) => {\n      this.activeFile!.write(entry, err => (err ? reject(err) : resolve()))\n    })\n    if (this.syncOnPut && this.activeFile) {\n      fs.fsyncSync((this.activeFile as any).fd)\n    }\n    this.keydir.set(keyBuf.toString('binary'), {\n      fileId: this.activeFileId,\n      offset,\n      size: entry.length,\n      timestamp,\n      tombstone: false,\n    })\n    this.activeOffset += entry.length\n    if (this.activeOffset > 32 * 1024 * 1024) {\n      this.activeFile!.close()\n      this.rollover()\n    }\n  }\n\n  async get(key: string | Buffer): Promise<Buffer | null> {\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const meta = this.keydir.get(keyBuf.toString('binary'))\n    if (!meta || meta.tombstone) return null\n    let fh = this.openFiles.get(meta.fileId)\n    if (!fh) {\n      const fname = path.join(this.dirname, `${meta.fileId.toString().padStart(8, '0')}.data`)\n      fh = await openFile(fname, 'r')\n      this.openFiles.set(meta.fileId, fh)\n    }\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    await fh.read(header, 0, ENTRY_HEADER_SIZE, meta.offset)\n    const keySize = header.readUInt32BE(0)\n    const valueSize = header.readUInt32BE(4)\n    const keyRead = Buffer.alloc(keySize)\n    await fh.read(keyRead, 0, keySize, meta.offset + ENTRY_HEADER_SIZE)\n    const value = Buffer.alloc(valueSize)\n    await fh.read(value, 0, valueSize, meta.offset + ENTRY_HEADER_SIZE + keySize)\n    return value\n  }\n\n  async delete(key: string | Buffer) {\n    if (!this.readWrite) throw new Error('Read-only mode')\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const timestamp = BigInt(Date.now())\n    const tombstone = 1\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    header.writeUInt32BE(keyBuf.length, 0)\n    header.writeUInt32BE(0, 4)\n    header.writeUInt8(tombstone, 8)\n    header.writeBigUInt64BE(timestamp, 9)\n    const entry = Buffer.concat([header, keyBuf])\n    const offset = this.activeOffset\n    await new Promise<void>((resolve, reject) => {\n      this.activeFile!.write(entry, err => (err ? reject(err) : resolve()))\n    })\n    if (this.syncOnPut && this.activeFile) {\n      fs.fsyncSync((this.activeFile as any).fd)\n    }\n    this.keydir.set(keyBuf.toString('binary'), {\n      fileId: this.activeFileId,\n      offset,\n      size: entry.length,\n      timestamp,\n      tombstone: true,\n    })\n    this.activeOffset += entry.length\n    if (this.activeOffset > 32 * 1024 * 1024) {\n      this.activeFile!.close()\n      this.rollover()\n    }\n  }\n\n  listKeys(): string[] {\n    return Array.from(this.keydir.entries()).filter(([_, v]) => !v.tombstone).map(([k, _]) => k)\n  }\n\n  async fold<T>(fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T> {\n    for (const [k, meta] of this.keydir.entries()) {\n      if (!meta.tombstone) {\n        const v = await this.get(k)\n        acc0 = fn(k, v!, acc0)\n      }\n    }\n    return acc0\n  }\n\n  async merge() {\n    // Compact all but active file\n    const live: Map<string, KeyDirEntry> = new Map()\n    for (const [k, meta] of this.keydir.entries()) {\n      if (!meta.tombstone) live.set(k, meta)\n    }\n    const fileIds = this.listDataFiles().map(f => parseInt(f.split('.')[0], 10))\n    const nextId = fileIds.length ? Math.max(...fileIds) + 1 : 1\n    const fname = `${nextId.toString().padStart(8, '0')}.data`\n    const filePath = path.join(this.dirname, fname)\n    const f = fs.createWriteStream(filePath, { flags: 'a' })\n    for (const [k, meta] of live.entries()) {\n      const v = await this.get(k)\n      const keyBuf = Buffer.from(k, 'binary')\n      const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n      header.writeUInt32BE(keyBuf.length, 0)\n      header.writeUInt32BE(v!.length, 4)\n      header.writeUInt8(0, 8)\n      header.writeBigUInt64BE(meta.timestamp, 9)\n      const entry = Buffer.concat([header, keyBuf, v!])\n      await new Promise<void>((resolve, reject) => {\n        f.write(entry, err => (err ? reject(err) : resolve()))\n      })\n    }\n    f.close()\n    for (const fid of fileIds) {\n      if (fid !== this.activeFileId && fid !== nextId) {\n        try {\n          fs.unlinkSync(path.join(this.dirname, `${fid.toString().padStart(8, '0')}.data`))\n        } catch { }\n      }\n    }\n    this.loadFiles()\n  }\n\n  sync() {\n    if (this.activeFile) fs.fsyncSync((this.activeFile as any).fd)\n  }\n\n  async close() {\n    if (this.activeFile) this.activeFile.end()\n    for (const fh of this.openFiles.values()) await fh.close()\n    this.openFiles.clear()\n  }\n}\n\n// API functions\nexport function open(dirname: string, opts?: { readWrite?: boolean; syncOnPut?: boolean }) {\n  return new Bitcask(dirname, opts)\n}\nexport async function get(handle: Bitcask, key: string | Buffer) {\n  const v = await handle.get(key)\n  return v === null ? 'not found' : v\n}\nexport async function put(handle: Bitcask, key: string | Buffer, value: string | Buffer) {\n  await handle.put(key, value)\n  return 'ok'\n}\nexport async function del(handle: Bitcask, key: string | Buffer) {\n  await handle.delete(key)\n  return 'ok'\n}\nexport function listKeys(handle: Bitcask) {\n  return handle.listKeys()\n}\nexport async function fold<T>(handle: Bitcask, fn: (k: string, v: Buffer, acc: T) => T, acc0: T) {\n  return await handle.fold(fn, acc0)\n}\nexport async function merge(dirname: string) {\n  const h = new Bitcask(dirname, { readWrite: true })\n  await h.merge()\n  h.close()\n  return 'ok'\n}\nexport function sync(handle: Bitcask) {\n  handle.sync()\n  return 'ok'\n}\nexport async function close(handle: Bitcask) {\n  await handle.close()\n  return 'ok'\n}\n"]}
+{"version":3,"file":"bitcask.cjs","names":[],"sources":["../../src/_experiments/bitcask.ts"],"sourcesContent":["// Bitcask-inspired key-value store (minimal, single-process, single-writer)\n// Copyright 2024\nimport * as fs from 'fs'\nimport * as path from 'path'\nimport { FileHandle, open as openFile } from 'fs/promises'\n\nconst ENTRY_HEADER_SIZE = 17 // 4 (key) + 4 (value) + 1 (tombstone) + 8 (timestamp)\n\ninterface KeyDirEntry {\n  fileId: number\n  offset: number\n  size: number\n  timestamp: bigint\n  tombstone: boolean\n}\n\nexport class Bitcask {\n  private dirname: string\n  private readWrite: boolean\n  private syncOnPut: boolean\n  private keydir: Map<string, KeyDirEntry> = new Map();\n  private activeFile: fs.WriteStream | null = null;\n  private activeFileId: number = 0;\n  private activeOffset: number = 0;\n  private openFiles: Map<number, FileHandle> = new Map();\n\n  constructor(dirname: string, opts: { readWrite?: boolean; syncOnPut?: boolean } = {}) {\n    this.dirname = dirname\n    this.readWrite = opts.readWrite !== false\n    this.syncOnPut = opts.syncOnPut === true\n    if (!fs.existsSync(dirname)) fs.mkdirSync(dirname, { recursive: true })\n    this.loadFiles()\n    if (this.readWrite) this.rollover()\n  }\n\n  private listDataFiles(): string[] {\n    return fs.readdirSync(this.dirname).filter(f => f.endsWith('.data')).sort()\n  }\n\n  private loadFiles() {\n    for (const fname of this.listDataFiles()) {\n      const fileId = parseInt(fname.split('.')[0], 10)\n      const filePath = path.join(this.dirname, fname)\n      const fd = fs.openSync(filePath, 'r')\n      let offset = 0\n      while (true) {\n        const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n        const bytesRead = fs.readSync(fd, header, 0, ENTRY_HEADER_SIZE, offset)\n        if (bytesRead < ENTRY_HEADER_SIZE) break\n        const keySize = header.readUInt32BE(0)\n        const valueSize = header.readUInt32BE(4)\n        const tombstone = header.readUInt8(8) === 1\n        const timestamp = header.readBigUInt64BE(9)\n        const key = Buffer.alloc(keySize)\n        fs.readSync(fd, key, 0, keySize, offset + ENTRY_HEADER_SIZE)\n        // skip value\n        const entrySize = ENTRY_HEADER_SIZE + keySize + valueSize\n        this.keydir.set(key.toString('binary'), {\n          fileId,\n          offset,\n          size: entrySize,\n          timestamp,\n          tombstone,\n        })\n        offset += entrySize\n      }\n      fs.closeSync(fd)\n    }\n  }\n\n  private rollover() {\n    const fileIds = this.listDataFiles().map(f => parseInt(f.split('.')[0], 10))\n    const nextId = fileIds.length ? Math.max(...fileIds) + 1 : 1\n    const fname = `${nextId.toString().padStart(8, '0')}.data`\n    const filePath = path.join(this.dirname, fname)\n    this.activeFile = fs.createWriteStream(filePath, { flags: 'a' })\n    this.activeFileId = nextId\n    this.activeOffset = fs.existsSync(filePath) ? fs.statSync(filePath).size : 0\n  }\n\n  async put(key: string | Buffer, value: string | Buffer) {\n    if (!this.readWrite) throw new Error('Read-only mode')\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const valueBuf = Buffer.isBuffer(value) ? value : Buffer.from(value)\n    const timestamp = BigInt(Date.now())\n    const tombstone = 0\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    header.writeUInt32BE(keyBuf.length, 0)\n    header.writeUInt32BE(valueBuf.length, 4)\n    header.writeUInt8(tombstone, 8)\n    header.writeBigUInt64BE(timestamp, 9)\n    const entry = Buffer.concat([header, keyBuf, valueBuf])\n    const offset = this.activeOffset\n    await new Promise<void>((resolve, reject) => {\n      this.activeFile!.write(entry, err => (err ? reject(err) : resolve()))\n    })\n    if (this.syncOnPut && this.activeFile) {\n      fs.fsyncSync((this.activeFile as any).fd)\n    }\n    this.keydir.set(keyBuf.toString('binary'), {\n      fileId: this.activeFileId,\n      offset,\n      size: entry.length,\n      timestamp,\n      tombstone: false,\n    })\n    this.activeOffset += entry.length\n    if (this.activeOffset > 32 * 1024 * 1024) {\n      this.activeFile!.close()\n      this.rollover()\n    }\n  }\n\n  async get(key: string | Buffer): Promise<Buffer | null> {\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const meta = this.keydir.get(keyBuf.toString('binary'))\n    if (!meta || meta.tombstone) return null\n    let fh = this.openFiles.get(meta.fileId)\n    if (!fh) {\n      const fname = path.join(this.dirname, `${meta.fileId.toString().padStart(8, '0')}.data`)\n      fh = await openFile(fname, 'r')\n      this.openFiles.set(meta.fileId, fh)\n    }\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    await fh.read(header, 0, ENTRY_HEADER_SIZE, meta.offset)\n    const keySize = header.readUInt32BE(0)\n    const valueSize = header.readUInt32BE(4)\n    const keyRead = Buffer.alloc(keySize)\n    await fh.read(keyRead, 0, keySize, meta.offset + ENTRY_HEADER_SIZE)\n    const value = Buffer.alloc(valueSize)\n    await fh.read(value, 0, valueSize, meta.offset + ENTRY_HEADER_SIZE + keySize)\n    return value\n  }\n\n  async delete(key: string | Buffer) {\n    if (!this.readWrite) throw new Error('Read-only mode')\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const timestamp = BigInt(Date.now())\n    const tombstone = 1\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    header.writeUInt32BE(keyBuf.length, 0)\n    header.writeUInt32BE(0, 4)\n    header.writeUInt8(tombstone, 8)\n    header.writeBigUInt64BE(timestamp, 9)\n    const entry = Buffer.concat([header, keyBuf])\n    const offset = this.activeOffset\n    await new Promise<void>((resolve, reject) => {\n      this.activeFile!.write(entry, err => (err ? reject(err) : resolve()))\n    })\n    if (this.syncOnPut && this.activeFile) {\n      fs.fsyncSync((this.activeFile as any).fd)\n    }\n    this.keydir.set(keyBuf.toString('binary'), {\n      fileId: this.activeFileId,\n      offset,\n      size: entry.length,\n      timestamp,\n      tombstone: true,\n    })\n    this.activeOffset += entry.length\n    if (this.activeOffset > 32 * 1024 * 1024) {\n      this.activeFile!.close()\n      this.rollover()\n    }\n  }\n\n  listKeys(): string[] {\n    return Array.from(this.keydir.entries()).filter(([_, v]) => !v.tombstone).map(([k, _]) => k)\n  }\n\n  async fold<T>(fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T> {\n    for (const [k, meta] of this.keydir.entries()) {\n      if (!meta.tombstone) {\n        const v = await this.get(k)\n        acc0 = fn(k, v!, acc0)\n      }\n    }\n    return acc0\n  }\n\n  async merge() {\n    // Compact all but active file\n    const live: Map<string, KeyDirEntry> = new Map()\n    for (const [k, meta] of this.keydir.entries()) {\n      if (!meta.tombstone) live.set(k, meta)\n    }\n    const fileIds = this.listDataFiles().map(f => parseInt(f.split('.')[0], 10))\n    const nextId = fileIds.length ? Math.max(...fileIds) + 1 : 1\n    const fname = `${nextId.toString().padStart(8, '0')}.data`\n    const filePath = path.join(this.dirname, fname)\n    const f = fs.createWriteStream(filePath, { flags: 'a' })\n    for (const [k, meta] of live.entries()) {\n      const v = await this.get(k)\n      const keyBuf = Buffer.from(k, 'binary')\n      const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n      header.writeUInt32BE(keyBuf.length, 0)\n      header.writeUInt32BE(v!.length, 4)\n      header.writeUInt8(0, 8)\n      header.writeBigUInt64BE(meta.timestamp, 9)\n      const entry = Buffer.concat([header, keyBuf, v!])\n      await new Promise<void>((resolve, reject) => {\n        f.write(entry, err => (err ? reject(err) : resolve()))\n      })\n    }\n    f.close()\n    for (const fid of fileIds) {\n      if (fid !== this.activeFileId && fid !== nextId) {\n        try {\n          fs.unlinkSync(path.join(this.dirname, `${fid.toString().padStart(8, '0')}.data`))\n        } catch { }\n      }\n    }\n    this.loadFiles()\n  }\n\n  sync() {\n    if (this.activeFile) fs.fsyncSync((this.activeFile as any).fd)\n  }\n\n  async close() {\n    if (this.activeFile) this.activeFile.end()\n    for (const fh of this.openFiles.values()) await fh.close()\n    this.openFiles.clear()\n  }\n}\n\n// API functions\nexport function open(dirname: string, opts?: { readWrite?: boolean; syncOnPut?: boolean }) {\n  return new Bitcask(dirname, opts)\n}\nexport async function get(handle: Bitcask, key: string | Buffer) {\n  const v = await handle.get(key)\n  return v === null ? 'not found' : v\n}\nexport async function put(handle: Bitcask, key: string | Buffer, value: string | Buffer) {\n  await handle.put(key, value)\n  return 'ok'\n}\nexport async function del(handle: Bitcask, key: string | Buffer) {\n  await handle.delete(key)\n  return 'ok'\n}\nexport function listKeys(handle: Bitcask) {\n  return handle.listKeys()\n}\nexport async function fold<T>(handle: Bitcask, fn: (k: string, v: Buffer, acc: T) => T, acc0: T) {\n  return await handle.fold(fn, acc0)\n}\nexport async function merge(dirname: string) {\n  const h = new Bitcask(dirname, { readWrite: true })\n  await h.merge()\n  h.close()\n  return 'ok'\n}\nexport function sync(handle: Bitcask) {\n  handle.sync()\n  return 'ok'\n}\nexport async function close(handle: Bitcask) {\n  await handle.close()\n  return 'ok'\n}\n"],"mappings":"qMAgBA,IAAa,EAAb,KAAqB,CACnB,QACA,UACA,UACA,OAA2C,IAAI,IAC/C,WAA4C,KAC5C,aAA+B,EAC/B,aAA+B,EAC/B,UAA6C,IAAI,IAEjD,YAAY,EAAiB,EAAqD,EAAE,CAAE,CACpF,KAAK,QAAU,EACf,KAAK,UAAY,EAAK,YAAc,GACpC,KAAK,UAAY,EAAK,YAAc,GAC/B,EAAG,WAAW,EAAQ,EAAE,EAAG,UAAU,EAAS,CAAE,UAAW,GAAM,CAAC,CACvE,KAAK,WAAW,CACZ,KAAK,WAAW,KAAK,UAAU,CAGrC,eAAkC,CAChC,OAAO,EAAG,YAAY,KAAK,QAAQ,CAAC,OAAO,GAAK,EAAE,SAAS,QAAQ,CAAC,CAAC,MAAM,CAG7E,WAAoB,CAClB,IAAK,IAAM,KAAS,KAAK,eAAe,CAAE,CACxC,IAAM,EAAS,SAAS,EAAM,MAAM,IAAI,CAAC,GAAI,GAAG,CAC1C,EAAW,EAAK,KAAK,KAAK,QAAS,EAAM,CACzC,EAAK,EAAG,SAAS,EAAU,IAAI,CACjC,EAAS,EACb,OAAa,CACX,IAAM,EAAS,OAAO,MAAM,GAAkB,CAE9C,GADkB,EAAG,SAAS,EAAI,EAAQ,EAAG,GAAmB,EAAO,CACvD,GAAmB,MACnC,IAAM,EAAU,EAAO,aAAa,EAAE,CAChC,EAAY,EAAO,aAAa,EAAE,CAClC,EAAY,EAAO,UAAU,EAAE,GAAK,EACpC,EAAY,EAAO,gBAAgB,EAAE,CACrC,EAAM,OAAO,MAAM,EAAQ,CACjC,EAAG,SAAS,EAAI,EAAK,EAAG,EAAS,EAAS,GAAkB,CAE5D,IAAM,EAAY,GAAoB,EAAU,EAChD,KAAK,OAAO,IAAI,EAAI,SAAS,SAAS,CAAE,CACtC,SACA,SACA,KAAM,EACN,YACA,YACD,CAAC,CACF,GAAU,EAEZ,EAAG,UAAU,EAAG,EAIpB,UAAmB,CACjB,IAAM,EAAU,KAAK,eAAe,CAAC,IAAI,GAAK,SAAS,EAAE,MAAM,IAAI,CAAC,GAAI,GAAG,CAAC,CACtE,EAAS,EAAQ,OAAS,KAAK,IAAI,GAAG,EAAQ,CAAG,EAAI,EACrD,EAAQ,GAAG,EAAO,UAAU,CAAC,SAAS,EAAG,IAAI,CAAC,OAC9C,EAAW,EAAK,KAAK,KAAK,QAAS,EAAM,CAC/C,KAAK,WAAa,EAAG,kBAAkB,EAAU,CAAE,MAAO,IAAK,CAAC,CAChE,KAAK,aAAe,EACpB,KAAK,aAAe,EAAG,WAAW,EAAS,CAAG,EAAG,SAAS,EAAS,CAAC,KAAO,EAG7E,MAAM,IAAI,EAAsB,EAAwB,CACtD,GAAI,CAAC,KAAK,UAAW,MAAU,MAAM,iBAAiB,CACtD,IAAM,EAAS,OAAO,SAAS,EAAI,CAAG,EAAM,OAAO,KAAK,EAAI,CACtD,EAAW,OAAO,SAAS,EAAM,CAAG,EAAQ,OAAO,KAAK,EAAM,CAC9D,EAAY,OAAO,KAAK,KAAK,CAAC,CAE9B,EAAS,OAAO,MAAM,GAAkB,CAC9C,EAAO,cAAc,EAAO,OAAQ,EAAE,CACtC,EAAO,cAAc,EAAS,OAAQ,EAAE,CACxC,EAAO,WAAW,EAAW,EAAE,CAC/B,EAAO,iBAAiB,EAAW,EAAE,CACrC,IAAM,EAAQ,OAAO,OAAO,CAAC,EAAQ,EAAQ,EAAS,CAAC,CACjD,EAAS,KAAK,aACpB,MAAM,IAAI,SAAe,EAAS,IAAW,CAC3C,KAAK,WAAY,MAAM,EAAO,GAAQ,EAAM,EAAO,EAAI,CAAG,GAAS,CAAE,EACrE,CACE,KAAK,WAAa,KAAK,YACzB,EAAG,UAAW,KAAK,WAAmB,GAAG,CAE3C,KAAK,OAAO,IAAI,EAAO,SAAS,SAAS,CAAE,CACzC,OAAQ,KAAK,aACb,SACA,KAAM,EAAM,OACZ,YACA,UAAW,GACZ,CAAC,CACF,KAAK,cAAgB,EAAM,OACvB,KAAK,aAAe,GAAK,KAAO,OAClC,KAAK,WAAY,OAAO,CACxB,KAAK,UAAU,EAInB,MAAM,IAAI,EAA8C,CACtD,IAAM,EAAS,OAAO,SAAS,EAAI,CAAG,EAAM,OAAO,KAAK,EAAI,CACtD,EAAO,KAAK,OAAO,IAAI,EAAO,SAAS,SAAS,CAAC,CACvD,GAAI,CAAC,GAAQ,EAAK,UAAW,OAAO,KACpC,IAAI,EAAK,KAAK,UAAU,IAAI,EAAK,OAAO,CACnC,IAEH,EAAK,MAAA,EAAA,EAAA,MADS,EAAK,KAAK,KAAK,QAAS,GAAG,EAAK,OAAO,UAAU,CAAC,SAAS,EAAG,IAAI,CAAC,OAAO,CAC7D,IAAI,CAC/B,KAAK,UAAU,IAAI,EAAK,OAAQ,EAAG,EAErC,IAAM,EAAS,OAAO,MAAM,GAAkB,CAC9C,MAAM,EAAG,KAAK,EAAQ,EAAG,GAAmB,EAAK,OAAO,CACxD,IAAM,EAAU,EAAO,aAAa,EAAE,CAChC,EAAY,EAAO,aAAa,EAAE,CAClC,EAAU,OAAO,MAAM,EAAQ,CACrC,MAAM,EAAG,KAAK,EAAS,EAAG,EAAS,EAAK,OAAS,GAAkB,CACnE,IAAM,EAAQ,OAAO,MAAM,EAAU,CAErC,OADA,MAAM,EAAG,KAAK,EAAO,EAAG,EAAW,EAAK,OAAS,GAAoB,EAAQ,CACtE,EAGT,MAAM,OAAO,EAAsB,CACjC,GAAI,CAAC,KAAK,UAAW,MAAU,MAAM,iBAAiB,CACtD,IAAM,EAAS,OAAO,SAAS,EAAI,CAAG,EAAM,OAAO,KAAK,EAAI,CACtD,EAAY,OAAO,KAAK,KAAK,CAAC,CAE9B,EAAS,OAAO,MAAM,GAAkB,CAC9C,EAAO,cAAc,EAAO,OAAQ,EAAE,CACtC,EAAO,cAAc,EAAG,EAAE,CAC1B,EAAO,WAAW,EAAW,EAAE,CAC/B,EAAO,iBAAiB,EAAW,EAAE,CACrC,IAAM,EAAQ,OAAO,OAAO,CAAC,EAAQ,EAAO,CAAC,CACvC,EAAS,KAAK,aACpB,MAAM,IAAI,SAAe,EAAS,IAAW,CAC3C,KAAK,WAAY,MAAM,EAAO,GAAQ,EAAM,EAAO,EAAI,CAAG,GAAS,CAAE,EACrE,CACE,KAAK,WAAa,KAAK,YACzB,EAAG,UAAW,KAAK,WAAmB,GAAG,CAE3C,KAAK,OAAO,IAAI,EAAO,SAAS,SAAS,CAAE,CACzC,OAAQ,KAAK,aACb,SACA,KAAM,EAAM,OACZ,YACA,UAAW,GACZ,CAAC,CACF,KAAK,cAAgB,EAAM,OACvB,KAAK,aAAe,GAAK,KAAO,OAClC,KAAK,WAAY,OAAO,CACxB,KAAK,UAAU,EAInB,UAAqB,CACnB,OAAO,MAAM,KAAK,KAAK,OAAO,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAG,KAAO,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,EAAG,KAAO,EAAE,CAG9F,MAAM,KAAQ,EAAyC,EAAqB,CAC1E,IAAK,GAAM,CAAC,EAAG,KAAS,KAAK,OAAO,SAAS,CACtC,EAAK,YAER,EAAO,EAAG,EADA,MAAM,KAAK,IAAI,EAAE,CACV,EAAK,EAG1B,OAAO,EAGT,MAAM,OAAQ,CAEZ,IAAM,EAAiC,IAAI,IAC3C,IAAK,GAAM,CAAC,EAAG,KAAS,KAAK,OAAO,SAAS,CACtC,EAAK,WAAW,EAAK,IAAI,EAAG,EAAK,CAExC,IAAM,EAAU,KAAK,eAAe,CAAC,IAAI,GAAK,SAAS,EAAE,MAAM,IAAI,CAAC,GAAI,GAAG,CAAC,CACtE,EAAS,EAAQ,OAAS,KAAK,IAAI,GAAG,EAAQ,CAAG,EAAI,EACrD,EAAQ,GAAG,EAAO,UAAU,CAAC,SAAS,EAAG,IAAI,CAAC,OAC9C,EAAW,EAAK,KAAK,KAAK,QAAS,EAAM,CACzC,EAAI,EAAG,kBAAkB,EAAU,CAAE,MAAO,IAAK,CAAC,CACxD,IAAK,GAAM,CAAC,EAAG,KAAS,EAAK,SAAS,CAAE,CACtC,IAAM,EAAI,MAAM,KAAK,IAAI,EAAE,CACrB,EAAS,OAAO,KAAK,EAAG,SAAS,CACjC,EAAS,OAAO,MAAM,GAAkB,CAC9C,EAAO,cAAc,EAAO,OAAQ,EAAE,CACtC,EAAO,cAAc,EAAG,OAAQ,EAAE,CAClC,EAAO,WAAW,EAAG,EAAE,CACvB,EAAO,iBAAiB,EAAK,UAAW,EAAE,CAC1C,IAAM,EAAQ,OAAO,OAAO,CAAC,EAAQ,EAAQ,EAAG,CAAC,CACjD,MAAM,IAAI,SAAe,EAAS,IAAW,CAC3C,EAAE,MAAM,EAAO,GAAQ,EAAM,EAAO,EAAI,CAAG,GAAS,CAAE,EACtD,CAEJ,EAAE,OAAO,CACT,IAAK,IAAM,KAAO,EAChB,GAAI,IAAQ,KAAK,cAAgB,IAAQ,EACvC,GAAI,CACF,EAAG,WAAW,EAAK,KAAK,KAAK,QAAS,GAAG,EAAI,UAAU,CAAC,SAAS,EAAG,IAAI,CAAC,OAAO,CAAC,MAC3E,EAGZ,KAAK,WAAW,CAGlB,MAAO,CACD,KAAK,YAAY,EAAG,UAAW,KAAK,WAAmB,GAAG,CAGhE,MAAM,OAAQ,CACR,KAAK,YAAY,KAAK,WAAW,KAAK,CAC1C,IAAK,IAAM,KAAM,KAAK,UAAU,QAAQ,CAAE,MAAM,EAAG,OAAO,CAC1D,KAAK,UAAU,OAAO,GAK1B,SAAgB,EAAK,EAAiB,EAAqD,CACzF,OAAO,IAAI,EAAQ,EAAS,EAAK,CAEnC,eAAsB,EAAI,EAAiB,EAAsB,CAC/D,IAAM,EAAI,MAAM,EAAO,IAAI,EAAI,CAC/B,OAAO,IAAM,KAAO,YAAc,EAEpC,eAAsB,EAAI,EAAiB,EAAsB,EAAwB,CAEvF,OADA,MAAM,EAAO,IAAI,EAAK,EAAM,CACrB,KAET,eAAsB,EAAI,EAAiB,EAAsB,CAE/D,OADA,MAAM,EAAO,OAAO,EAAI,CACjB,KAET,SAAgB,EAAS,EAAiB,CACxC,OAAO,EAAO,UAAU,CAE1B,eAAsB,EAAQ,EAAiB,EAAyC,EAAS,CAC/F,OAAO,MAAM,EAAO,KAAK,EAAI,EAAK,CAEpC,eAAsB,EAAM,EAAiB,CAC3C,IAAM,EAAI,IAAI,EAAQ,EAAS,CAAE,UAAW,GAAM,CAAC,CAGnD,OAFA,MAAM,EAAE,OAAO,CACf,EAAE,OAAO,CACF,KAET,SAAgB,EAAK,EAAiB,CAEpC,OADA,EAAO,MAAM,CACN,KAET,eAAsB,EAAM,EAAiB,CAE3C,OADA,MAAM,EAAO,OAAO,CACb"}

package/dist/_experiments/bitcask.d.cts

@@ -1,31 +1,32 @@
+//#region src/_experiments/bitcask.d.ts
 declare class Bitcask {
-    private dirname;
-    private readWrite;
-    private syncOnPut;
-    private keydir;
-    private activeFile;
-    private activeFileId;
-    private activeOffset;
-    private openFiles;
-    constructor(dirname: string, opts?: {
-        readWrite?: boolean;
-        syncOnPut?: boolean;
-    });
-    private listDataFiles;
-    private loadFiles;
-    private rollover;
-    put(key: string | Buffer, value: string | Buffer): Promise<void>;
-    get(key: string | Buffer): Promise<Buffer | null>;
-    delete(key: string | Buffer): Promise<void>;
-    listKeys(): string[];
-    fold<T>(fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T>;
-    merge(): Promise<void>;
-    sync(): void;
-    close(): Promise<void>;
-}
-declare function open(dirname: string, opts?: {
+  private dirname;
+  private readWrite;
+  private syncOnPut;
+  private keydir;
+  private activeFile;
+  private activeFileId;
+  private activeOffset;
+  private openFiles;
+  constructor(dirname: string, opts?: {
     readWrite?: boolean;
     syncOnPut?: boolean;
+  });
+  private listDataFiles;
+  private loadFiles;
+  private rollover;
+  put(key: string | Buffer, value: string | Buffer): Promise<void>;
+  get(key: string | Buffer): Promise<Buffer | null>;
+  delete(key: string | Buffer): Promise<void>;
+  listKeys(): string[];
+  fold<T>(fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T>;
+  merge(): Promise<void>;
+  sync(): void;
+  close(): Promise<void>;
+}
+declare function open(dirname: string, opts?: {
+  readWrite?: boolean;
+  syncOnPut?: boolean;
 }): Bitcask;
 declare function get(handle: Bitcask, key: string | Buffer): Promise<Buffer<ArrayBufferLike> | "not found">;
 declare function put(handle: Bitcask, key: string | Buffer, value: string | Buffer): Promise<string>;
@@ -35,5 +36,6 @@ declare function fold<T>(handle: Bitcask, fn: (k: string, v: Buffer, acc: T) =>
 declare function merge(dirname: string): Promise<string>;
 declare function sync(handle: Bitcask): string;
 declare function close(handle: Bitcask): Promise<string>;
-
+//#endregion
 export { Bitcask, close, del, fold, get, listKeys, merge, open, put, sync };
+//# sourceMappingURL=bitcask.d.cts.map

package/dist/_experiments/bitcask.d.mts

@@ -0,0 +1,41 @@
+//#region src/_experiments/bitcask.d.ts
+declare class Bitcask {
+  private dirname;
+  private readWrite;
+  private syncOnPut;
+  private keydir;
+  private activeFile;
+  private activeFileId;
+  private activeOffset;
+  private openFiles;
+  constructor(dirname: string, opts?: {
+    readWrite?: boolean;
+    syncOnPut?: boolean;
+  });
+  private listDataFiles;
+  private loadFiles;
+  private rollover;
+  put(key: string | Buffer, value: string | Buffer): Promise<void>;
+  get(key: string | Buffer): Promise<Buffer | null>;
+  delete(key: string | Buffer): Promise<void>;
+  listKeys(): string[];
+  fold<T>(fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T>;
+  merge(): Promise<void>;
+  sync(): void;
+  close(): Promise<void>;
+}
+declare function open(dirname: string, opts?: {
+  readWrite?: boolean;
+  syncOnPut?: boolean;
+}): Bitcask;
+declare function get(handle: Bitcask, key: string | Buffer): Promise<Buffer<ArrayBufferLike> | "not found">;
+declare function put(handle: Bitcask, key: string | Buffer, value: string | Buffer): Promise<string>;
+declare function del(handle: Bitcask, key: string | Buffer): Promise<string>;
+declare function listKeys(handle: Bitcask): string[];
+declare function fold<T>(handle: Bitcask, fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T>;
+declare function merge(dirname: string): Promise<string>;
+declare function sync(handle: Bitcask): string;
+declare function close(handle: Bitcask): Promise<string>;
+//#endregion
+export { Bitcask, close, del, fold, get, listKeys, merge, open, put, sync };
+//# sourceMappingURL=bitcask.d.mts.map

package/dist/_experiments/bitcask.mjs

@@ -0,0 +1,2 @@
+import*as e from"fs";import*as t from"path";import{open as n}from"fs/promises";var r=class{dirname;readWrite;syncOnPut;keydir=new Map;activeFile=null;activeFileId=0;activeOffset=0;openFiles=new Map;constructor(t,n={}){this.dirname=t,this.readWrite=n.readWrite!==!1,this.syncOnPut=n.syncOnPut===!0,e.existsSync(t)||e.mkdirSync(t,{recursive:!0}),this.loadFiles(),this.readWrite&&this.rollover()}listDataFiles(){return e.readdirSync(this.dirname).filter(e=>e.endsWith(`.data`)).sort()}loadFiles(){for(let n of this.listDataFiles()){let r=parseInt(n.split(`.`)[0],10),i=t.join(this.dirname,n),a=e.openSync(i,`r`),o=0;for(;;){let t=Buffer.alloc(17);if(e.readSync(a,t,0,17,o)<17)break;let n=t.readUInt32BE(0),i=t.readUInt32BE(4),s=t.readUInt8(8)===1,c=t.readBigUInt64BE(9),l=Buffer.alloc(n);e.readSync(a,l,0,n,o+17);let u=17+n+i;this.keydir.set(l.toString(`binary`),{fileId:r,offset:o,size:u,timestamp:c,tombstone:s}),o+=u}e.closeSync(a)}}rollover(){let n=this.listDataFiles().map(e=>parseInt(e.split(`.`)[0],10)),r=n.length?Math.max(...n)+1:1,i=`${r.toString().padStart(8,`0`)}.data`,a=t.join(this.dirname,i);this.activeFile=e.createWriteStream(a,{flags:`a`}),this.activeFileId=r,this.activeOffset=e.existsSync(a)?e.statSync(a).size:0}async put(t,n){if(!this.readWrite)throw Error(`Read-only mode`);let r=Buffer.isBuffer(t)?t:Buffer.from(t),i=Buffer.isBuffer(n)?n:Buffer.from(n),a=BigInt(Date.now()),o=Buffer.alloc(17);o.writeUInt32BE(r.length,0),o.writeUInt32BE(i.length,4),o.writeUInt8(0,8),o.writeBigUInt64BE(a,9);let s=Buffer.concat([o,r,i]),c=this.activeOffset;await new Promise((e,t)=>{this.activeFile.write(s,n=>n?t(n):e())}),this.syncOnPut&&this.activeFile&&e.fsyncSync(this.activeFile.fd),this.keydir.set(r.toString(`binary`),{fileId:this.activeFileId,offset:c,size:s.length,timestamp:a,tombstone:!1}),this.activeOffset+=s.length,this.activeOffset>32*1024*1024&&(this.activeFile.close(),this.rollover())}async get(e){let r=Buffer.isBuffer(e)?e:Buffer.from(e),i=this.keydir.get(r.toString(`binary`));if(!i||i.tombstone)return null;let a=this.openFiles.get(i.fileId);a||(a=await n(t.join(this.dirname,`${i.fileId.toString().padStart(8,`0`)}.data`),`r`),this.openFiles.set(i.fileId,a));let o=Buffer.alloc(17);await a.read(o,0,17,i.offset);let s=o.readUInt32BE(0),c=o.readUInt32BE(4),l=Buffer.alloc(s);await a.read(l,0,s,i.offset+17);let u=Buffer.alloc(c);return await a.read(u,0,c,i.offset+17+s),u}async delete(t){if(!this.readWrite)throw Error(`Read-only mode`);let n=Buffer.isBuffer(t)?t:Buffer.from(t),r=BigInt(Date.now()),i=Buffer.alloc(17);i.writeUInt32BE(n.length,0),i.writeUInt32BE(0,4),i.writeUInt8(1,8),i.writeBigUInt64BE(r,9);let a=Buffer.concat([i,n]),o=this.activeOffset;await new Promise((e,t)=>{this.activeFile.write(a,n=>n?t(n):e())}),this.syncOnPut&&this.activeFile&&e.fsyncSync(this.activeFile.fd),this.keydir.set(n.toString(`binary`),{fileId:this.activeFileId,offset:o,size:a.length,timestamp:r,tombstone:!0}),this.activeOffset+=a.length,this.activeOffset>32*1024*1024&&(this.activeFile.close(),this.rollover())}listKeys(){return Array.from(this.keydir.entries()).filter(([e,t])=>!t.tombstone).map(([e,t])=>e)}async fold(e,t){for(let[n,r]of this.keydir.entries())r.tombstone||(t=e(n,await this.get(n),t));return t}async merge(){let n=new Map;for(let[e,t]of this.keydir.entries())t.tombstone||n.set(e,t);let r=this.listDataFiles().map(e=>parseInt(e.split(`.`)[0],10)),i=r.length?Math.max(...r)+1:1,a=`${i.toString().padStart(8,`0`)}.data`,o=t.join(this.dirname,a),s=e.createWriteStream(o,{flags:`a`});for(let[e,t]of n.entries()){let n=await this.get(e),r=Buffer.from(e,`binary`),i=Buffer.alloc(17);i.writeUInt32BE(r.length,0),i.writeUInt32BE(n.length,4),i.writeUInt8(0,8),i.writeBigUInt64BE(t.timestamp,9);let a=Buffer.concat([i,r,n]);await new Promise((e,t)=>{s.write(a,n=>n?t(n):e())})}s.close();for(let n of r)if(n!==this.activeFileId&&n!==i)try{e.unlinkSync(t.join(this.dirname,`${n.toString().padStart(8,`0`)}.data`))}catch{}this.loadFiles()}sync(){this.activeFile&&e.fsyncSync(this.activeFile.fd)}async close(){this.activeFile&&this.activeFile.end();for(let e of this.openFiles.values())await e.close();this.openFiles.clear()}};function i(e,t){return new r(e,t)}async function a(e,t){let n=await e.get(t);return n===null?`not found`:n}async function o(e,t,n){return await e.put(t,n),`ok`}async function s(e,t){return await e.delete(t),`ok`}function c(e){return e.listKeys()}async function l(e,t,n){return await e.fold(t,n)}async function u(e){let t=new r(e,{readWrite:!0});return await t.merge(),t.close(),`ok`}function d(e){return e.sync(),`ok`}async function f(e){return await e.close(),`ok`}export{r as Bitcask,f as close,s as del,l as fold,a as get,c as listKeys,u as merge,i as open,o as put,d as sync};
+//# sourceMappingURL=bitcask.mjs.map

package/dist/_experiments/bitcask.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcask.mjs","names":["openFile"],"sources":["../../src/_experiments/bitcask.ts"],"sourcesContent":["// Bitcask-inspired key-value store (minimal, single-process, single-writer)\n// Copyright 2024\nimport * as fs from 'fs'\nimport * as path from 'path'\nimport { FileHandle, open as openFile } from 'fs/promises'\n\nconst ENTRY_HEADER_SIZE = 17 // 4 (key) + 4 (value) + 1 (tombstone) + 8 (timestamp)\n\ninterface KeyDirEntry {\n  fileId: number\n  offset: number\n  size: number\n  timestamp: bigint\n  tombstone: boolean\n}\n\nexport class Bitcask {\n  private dirname: string\n  private readWrite: boolean\n  private syncOnPut: boolean\n  private keydir: Map<string, KeyDirEntry> = new Map();\n  private activeFile: fs.WriteStream | null = null;\n  private activeFileId: number = 0;\n  private activeOffset: number = 0;\n  private openFiles: Map<number, FileHandle> = new Map();\n\n  constructor(dirname: string, opts: { readWrite?: boolean; syncOnPut?: boolean } = {}) {\n    this.dirname = dirname\n    this.readWrite = opts.readWrite !== false\n    this.syncOnPut = opts.syncOnPut === true\n    if (!fs.existsSync(dirname)) fs.mkdirSync(dirname, { recursive: true })\n    this.loadFiles()\n    if (this.readWrite) this.rollover()\n  }\n\n  private listDataFiles(): string[] {\n    return fs.readdirSync(this.dirname).filter(f => f.endsWith('.data')).sort()\n  }\n\n  private loadFiles() {\n    for (const fname of this.listDataFiles()) {\n      const fileId = parseInt(fname.split('.')[0], 10)\n      const filePath = path.join(this.dirname, fname)\n      const fd = fs.openSync(filePath, 'r')\n      let offset = 0\n      while (true) {\n        const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n        const bytesRead = fs.readSync(fd, header, 0, ENTRY_HEADER_SIZE, offset)\n        if (bytesRead < ENTRY_HEADER_SIZE) break\n        const keySize = header.readUInt32BE(0)\n        const valueSize = header.readUInt32BE(4)\n        const tombstone = header.readUInt8(8) === 1\n        const timestamp = header.readBigUInt64BE(9)\n        const key = Buffer.alloc(keySize)\n        fs.readSync(fd, key, 0, keySize, offset + ENTRY_HEADER_SIZE)\n        // skip value\n        const entrySize = ENTRY_HEADER_SIZE + keySize + valueSize\n        this.keydir.set(key.toString('binary'), {\n          fileId,\n          offset,\n          size: entrySize,\n          timestamp,\n          tombstone,\n        })\n        offset += entrySize\n      }\n      fs.closeSync(fd)\n    }\n  }\n\n  private rollover() {\n    const fileIds = this.listDataFiles().map(f => parseInt(f.split('.')[0], 10))\n    const nextId = fileIds.length ? Math.max(...fileIds) + 1 : 1\n    const fname = `${nextId.toString().padStart(8, '0')}.data`\n    const filePath = path.join(this.dirname, fname)\n    this.activeFile = fs.createWriteStream(filePath, { flags: 'a' })\n    this.activeFileId = nextId\n    this.activeOffset = fs.existsSync(filePath) ? fs.statSync(filePath).size : 0\n  }\n\n  async put(key: string | Buffer, value: string | Buffer) {\n    if (!this.readWrite) throw new Error('Read-only mode')\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const valueBuf = Buffer.isBuffer(value) ? value : Buffer.from(value)\n    const timestamp = BigInt(Date.now())\n    const tombstone = 0\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    header.writeUInt32BE(keyBuf.length, 0)\n    header.writeUInt32BE(valueBuf.length, 4)\n    header.writeUInt8(tombstone, 8)\n    header.writeBigUInt64BE(timestamp, 9)\n    const entry = Buffer.concat([header, keyBuf, valueBuf])\n    const offset = this.activeOffset\n    await new Promise<void>((resolve, reject) => {\n      this.activeFile!.write(entry, err => (err ? reject(err) : resolve()))\n    })\n    if (this.syncOnPut && this.activeFile) {\n      fs.fsyncSync((this.activeFile as any).fd)\n    }\n    this.keydir.set(keyBuf.toString('binary'), {\n      fileId: this.activeFileId,\n      offset,\n      size: entry.length,\n      timestamp,\n      tombstone: false,\n    })\n    this.activeOffset += entry.length\n    if (this.activeOffset > 32 * 1024 * 1024) {\n      this.activeFile!.close()\n      this.rollover()\n    }\n  }\n\n  async get(key: string | Buffer): Promise<Buffer | null> {\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const meta = this.keydir.get(keyBuf.toString('binary'))\n    if (!meta || meta.tombstone) return null\n    let fh = this.openFiles.get(meta.fileId)\n    if (!fh) {\n      const fname = path.join(this.dirname, `${meta.fileId.toString().padStart(8, '0')}.data`)\n      fh = await openFile(fname, 'r')\n      this.openFiles.set(meta.fileId, fh)\n    }\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    await fh.read(header, 0, ENTRY_HEADER_SIZE, meta.offset)\n    const keySize = header.readUInt32BE(0)\n    const valueSize = header.readUInt32BE(4)\n    const keyRead = Buffer.alloc(keySize)\n    await fh.read(keyRead, 0, keySize, meta.offset + ENTRY_HEADER_SIZE)\n    const value = Buffer.alloc(valueSize)\n    await fh.read(value, 0, valueSize, meta.offset + ENTRY_HEADER_SIZE + keySize)\n    return value\n  }\n\n  async delete(key: string | Buffer) {\n    if (!this.readWrite) throw new Error('Read-only mode')\n    const keyBuf = Buffer.isBuffer(key) ? key : Buffer.from(key)\n    const timestamp = BigInt(Date.now())\n    const tombstone = 1\n    const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n    header.writeUInt32BE(keyBuf.length, 0)\n    header.writeUInt32BE(0, 4)\n    header.writeUInt8(tombstone, 8)\n    header.writeBigUInt64BE(timestamp, 9)\n    const entry = Buffer.concat([header, keyBuf])\n    const offset = this.activeOffset\n    await new Promise<void>((resolve, reject) => {\n      this.activeFile!.write(entry, err => (err ? reject(err) : resolve()))\n    })\n    if (this.syncOnPut && this.activeFile) {\n      fs.fsyncSync((this.activeFile as any).fd)\n    }\n    this.keydir.set(keyBuf.toString('binary'), {\n      fileId: this.activeFileId,\n      offset,\n      size: entry.length,\n      timestamp,\n      tombstone: true,\n    })\n    this.activeOffset += entry.length\n    if (this.activeOffset > 32 * 1024 * 1024) {\n      this.activeFile!.close()\n      this.rollover()\n    }\n  }\n\n  listKeys(): string[] {\n    return Array.from(this.keydir.entries()).filter(([_, v]) => !v.tombstone).map(([k, _]) => k)\n  }\n\n  async fold<T>(fn: (k: string, v: Buffer, acc: T) => T, acc0: T): Promise<T> {\n    for (const [k, meta] of this.keydir.entries()) {\n      if (!meta.tombstone) {\n        const v = await this.get(k)\n        acc0 = fn(k, v!, acc0)\n      }\n    }\n    return acc0\n  }\n\n  async merge() {\n    // Compact all but active file\n    const live: Map<string, KeyDirEntry> = new Map()\n    for (const [k, meta] of this.keydir.entries()) {\n      if (!meta.tombstone) live.set(k, meta)\n    }\n    const fileIds = this.listDataFiles().map(f => parseInt(f.split('.')[0], 10))\n    const nextId = fileIds.length ? Math.max(...fileIds) + 1 : 1\n    const fname = `${nextId.toString().padStart(8, '0')}.data`\n    const filePath = path.join(this.dirname, fname)\n    const f = fs.createWriteStream(filePath, { flags: 'a' })\n    for (const [k, meta] of live.entries()) {\n      const v = await this.get(k)\n      const keyBuf = Buffer.from(k, 'binary')\n      const header = Buffer.alloc(ENTRY_HEADER_SIZE)\n      header.writeUInt32BE(keyBuf.length, 0)\n      header.writeUInt32BE(v!.length, 4)\n      header.writeUInt8(0, 8)\n      header.writeBigUInt64BE(meta.timestamp, 9)\n      const entry = Buffer.concat([header, keyBuf, v!])\n      await new Promise<void>((resolve, reject) => {\n        f.write(entry, err => (err ? reject(err) : resolve()))\n      })\n    }\n    f.close()\n    for (const fid of fileIds) {\n      if (fid !== this.activeFileId && fid !== nextId) {\n        try {\n          fs.unlinkSync(path.join(this.dirname, `${fid.toString().padStart(8, '0')}.data`))\n        } catch { }\n      }\n    }\n    this.loadFiles()\n  }\n\n  sync() {\n    if (this.activeFile) fs.fsyncSync((this.activeFile as any).fd)\n  }\n\n  async close() {\n    if (this.activeFile) this.activeFile.end()\n    for (const fh of this.openFiles.values()) await fh.close()\n    this.openFiles.clear()\n  }\n}\n\n// API functions\nexport function open(dirname: string, opts?: { readWrite?: boolean; syncOnPut?: boolean }) {\n  return new Bitcask(dirname, opts)\n}\nexport async function get(handle: Bitcask, key: string | Buffer) {\n  const v = await handle.get(key)\n  return v === null ? 'not found' : v\n}\nexport async function put(handle: Bitcask, key: string | Buffer, value: string | Buffer) {\n  await handle.put(key, value)\n  return 'ok'\n}\nexport async function del(handle: Bitcask, key: string | Buffer) {\n  await handle.delete(key)\n  return 'ok'\n}\nexport function listKeys(handle: Bitcask) {\n  return handle.listKeys()\n}\nexport async function fold<T>(handle: Bitcask, fn: (k: string, v: Buffer, acc: T) => T, acc0: T) {\n  return await handle.fold(fn, acc0)\n}\nexport async function merge(dirname: string) {\n  const h = new Bitcask(dirname, { readWrite: true })\n  await h.merge()\n  h.close()\n  return 'ok'\n}\nexport function sync(handle: Bitcask) {\n  handle.sync()\n  return 'ok'\n}\nexport async function close(handle: Bitcask) {\n  await handle.close()\n  return 'ok'\n}\n"],"mappings":"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"}

package/dist/aes-sealed-CEgjlCzA.d.mts

@@ -0,0 +1,6 @@
+//#region src/common/crypto/aes-sealed.d.ts
+declare function encryptAesGcm(data: Uint8Array, key: CryptoKey, authenticating?: Uint8Array): Promise<Uint8Array>;
+declare function decryptAesGcm(data: Uint8Array, key: CryptoKey, authenticating?: Uint8Array): Promise<Uint8Array>;
+//#endregion
+export { encryptAesGcm as n, decryptAesGcm as t };
+//# sourceMappingURL=aes-sealed-CEgjlCzA.d.mts.map

package/dist/aes-sealed-Q4saTGg2.d.cts

@@ -0,0 +1,6 @@
+//#region src/common/crypto/aes-sealed.d.ts
+declare function encryptAesGcm(data: Uint8Array, key: CryptoKey, authenticating?: Uint8Array): Promise<Uint8Array>;
+declare function decryptAesGcm(data: Uint8Array, key: CryptoKey, authenticating?: Uint8Array): Promise<Uint8Array>;
+//#endregion
+export { encryptAesGcm as n, decryptAesGcm as t };
+//# sourceMappingURL=aes-sealed-Q4saTGg2.d.cts.map

package/dist/args-FLoL3OKJ.d.cts

@@ -0,0 +1,22 @@
+//#region src/node/args.d.ts
+/**
+ * Represents the configuration options for parsing command line arguments.
+ */
+interface ParseConfig {
+  args?: string[];
+  alias?: Record<string, string[]>;
+  normalize?: (value: string) => string;
+  booleanArgs?: string | string[];
+  listArgs?: string | string[];
+  numberArgs?: string | string[];
+}
+/**
+ * Parses command line arguments and returns an object containing the parsed options.
+ *
+ * @param config - Configuration options for parsing the arguments.
+ * @returns An object containing the parsed options.
+ */
+declare function parseArgs(config?: ParseConfig): Record<string, any>;
+//#endregion
+export { parseArgs as n, ParseConfig as t };
+//# sourceMappingURL=args-FLoL3OKJ.d.cts.map

package/dist/args-WC9q5kz2.d.mts

@@ -0,0 +1,22 @@
+//#region src/node/args.d.ts
+/**
+ * Represents the configuration options for parsing command line arguments.
+ */
+interface ParseConfig {
+  args?: string[];
+  alias?: Record<string, string[]>;
+  normalize?: (value: string) => string;
+  booleanArgs?: string | string[];
+  listArgs?: string | string[];
+  numberArgs?: string | string[];
+}
+/**
+ * Parses command line arguments and returns an object containing the parsed options.
+ *
+ * @param config - Configuration options for parsing the arguments.
+ * @returns An object containing the parsed options.
+ */
+declare function parseArgs(config?: ParseConfig): Record<string, any>;
+//#endregion
+export { parseArgs as n, ParseConfig as t };
+//# sourceMappingURL=args-WC9q5kz2.d.mts.map

package/dist/array-22DcyFGC.d.mts

@@ -0,0 +1,197 @@
+import { n as NestedArray } from "./types-ejoFe34F.mjs";
+
+//#region src/common/data/array.d.ts
+/**
+ * Return a new array with duplicate values removed. Maintains first occurrence order.
+ * @typeParam T - element type
+ * @param arr - input array
+ * @returns new array containing unique elements from `arr`
+ */
+declare function arrayUnique<T>(arr: T[]): T[];
+/**
+ * Return elements present in `x` but not in `y`.
+ * @typeParam T - element type
+ * @param left - left-hand array
+ * @param right - array of elements to exclude
+ * @returns new array with elements from `left` that are not included in `right`
+ */
+declare function arrayMinus<T>(left: T[], right: T[]): T[];
+/**
+ * Return the union of multiple arrays (unique elements across all inputs).
+ * @typeParam T - element type
+ * @param arrays - arrays to union
+ * @returns new array with unique elements from all provided arrays
+ */
+declare function arrayUnion<T>(...arrays: T[][]): T[];
+/** `[1,[2,3]]` becomes `[1,2,3]` */
+/**
+ * Flatten nested arrays to a single-level array.
+ * Example: `[1, [2, 3]]` becomes `[1, 2, 3]`.
+ * @typeParam T - element type
+ * @param arrays - one or more nested arrays to flatten
+ * @returns flattened array containing all elements
+ */
+declare function arrayFlatten<T>(...arrays: NestedArray<T>[]): T[];
+/**
+ * Return the intersection of two arrays (elements present in both).
+ * @typeParam T - element type
+ * @param left - first array
+ * @param right - second array
+ * @returns new array with elements present in both `left` and `right`
+ */
+declare function arrayIntersection<T>(left: T[], right: T[]): T[];
+/**
+ * Return the symmetric difference between two arrays (elements in either array but not both).
+ * @typeParam T - element type
+ */
+declare function arraySymmetricDifference<T>(left: T[], right: T[]): T[];
+/**
+ * Remove all occurrences of `el` from `arr` in-place and return the mutated array.
+ * If `arr` is not an array, returns an empty array.
+ * @typeParam T - element type
+ * @param arr - array to modify
+ * @param el - element to remove
+ * @returns the same array instance with `el` removed
+ */
+declare function arrayRemoveElement<T>(arr: T[], el: T): T[];
+/** Only have it once in the set */
+/**
+ * Ensure `el` exists in `arr`. If not present, push it and return the array.
+ * @typeParam T - element type
+ * @param arr - target array
+ * @param el - element to ensure
+ * @returns the same array instance (modified if `el` was added)
+ */
+declare function arraySetElement<T>(arr: T[], el: T): T[];
+/**
+ * Filter an array in-place using `fn` and return the same array instance.
+ * This replaces the array contents with the filtered result.
+ * @typeParam T - element type
+ * @param arr - array to filter in-place
+ * @param fn - predicate to determine which elements to keep
+ * @returns the same array instance after filtering
+ */
+declare function arrayFilterInPlace<T>(arr: T[], fn: (el: T) => boolean): T[];
+/**
+ * Toggle presence of `el` in `array` in-place: remove if present, add if missing.
+ * @typeParam T - element type
+ * @param arr - array to modify
+ * @param el - element to toggle
+ * @returns the same array instance after the toggle
+ */
+declare function arrayToggleInPlace<T>(arr: T[], el: T): T[];
+/**
+ * Empty an array in-place (remove all elements) and return it.
+ * @typeParam T - element type
+ */
+declare function arrayEmptyInPlace<T>(arr: T[]): T[];
+/**
+ * Replace the contents of `array` in-place with `newContent` and return it.
+ * @typeParam T - element type
+ * @param arr - target array to overwrite
+ * @param newContent - new contents to set
+ * @returns the same array instance after replacement
+ */
+declare function arraySetArrayInPlace<T>(arr: T[], newContent: T[]): T[];
+/**
+ * Return a sorted copy of the provided iterable or array-like object.
+ * @typeParam T - element type
+ * @param arr - iterable or array-like input
+ * @param compareFn - optional compare function (defaults to `cmp`)
+ * @returns a new array sorted according to `compareFn`
+ */
+declare function arraySorted<T>(arr: Iterable<T> | ArrayLike<T>, compareFn?: ((a: T, b: T) => number) | undefined): T[];
+/**
+ * Return a new array with numbers sorted in ascending order.
+ * @param arr - array of numbers
+ * @returns sorted array of numbers
+ */
+declare function arraySortedNumbers(arr: number[]): number[];
+/**
+ * Check strict equality of two arrays by length and element-wise === comparison.
+ * @typeParam T - element type
+ * @param array1 - first array
+ * @param array2 - second array
+ * @returns `true` if arrays are same length and all elements strictly equal
+ */
+declare function arrayIsEqual<T>(array1: T[], array2: T[]): boolean;
+/**
+ * Shuffle an array in-place using a secure random source if available.
+ * Note: uses Array.sort with random comparator which is sufficient for many cases but
+ * not perfectly uniform. Returns the same mutated array.
+ * @typeParam T - element type
+ * @param array - array to shuffle in-place
+ * @returns the shuffled array (same instance)
+ */
+declare function arrayShuffleInPlace<T>(arr: T[]): T[];
+/**
+ * Return a shuffled copy of `array` (original array is not modified).
+ * @typeParam T - element type
+ * @param array - input array
+ * @returns a new shuffled array
+ */
+declare function arrayShuffle<T>(arr: T[]): T[];
+/** Randomly shuffle the order of the array's elements. Force to have a different order if array has more than one element. */
+/**
+ * Shuffle `array` and ensure the returned order differs from the original when possible.
+ * If array length is 0 or 1 it is returned unchanged.
+ * @typeParam T - element type
+ * @param array - input array
+ * @returns a shuffled array that's different from the input when feasible
+ */
+declare function arrayShuffleForce<T>(arr: T[]): T[];
+/**
+ * Return a random element from `array` using a secure random source if available.
+ * @typeParam T - element type
+ * @param array - input array (must be non-empty)
+ * @returns a randomly selected element
+ */
+declare function arrayRandomElement<T>(arr: T[]): T;
+/**
+ * Return the maximum value from one or more nested arrays.
+ * Uses the `>` operator for comparison.
+ * @typeParam T - element type (should support `>` comparison)
+ * @param arrays - nested arrays to search
+ * @returns the maximum value or `undefined` if no elements present
+ */
+declare function arrayMax<T>(...arrays: NestedArray<T>[]): T;
+/**
+ * Return the minimum value from one or more nested arrays.
+ * Uses the `<` operator for comparison.
+ * @typeParam T - element type (should support `<` comparison)
+ * @param arrays - nested arrays to search
+ * @returns the minimum value or `undefined` if no elements present
+ */
+declare function arrayMin<T>(...arrays: NestedArray<T>[]): T;
+/**
+ * Sum all numbers in one or more nested arrays.
+ * @param arrays - nested arrays of numbers
+ * @returns the numeric sum (0 for empty input)
+ */
+declare function arraySum(...arrays: NestedArray<number>[]): number;
+/**
+ * Compute the average of numbers across one or more nested arrays.
+ * @param arrays - nested arrays of numbers
+ * @returns arithmetic mean (NaN if there are no elements)
+ */
+declare function arrayAvg(...arrays: NestedArray<number>[]): number;
+/**
+ * Split an array into chunks of `chunkLength` (last chunk may be smaller).
+ * @typeParam T - element type
+ * @param arr - input array
+ * @param chunkLength - chunk size (positive integer)
+ * @returns array of chunk arrays
+ */
+declare function arrayBatches<T>(arr: T[], chunkLength: number): T[][];
+/**
+ * Create an array of given `length` filled with `item` or the result of `item(index)`.
+ * If `length` is <= 0 an empty array is returned.
+ * @typeParam T - element type
+ * @param length - desired length of the array
+ * @param item - value to fill or a function producing a value per index
+ * @returns newly created array of length `length`
+ */
+declare function createArray<T>(length?: number, item?: T | ((index: number) => T)): T[];
+//#endregion
+export { arrayUnion as C, arrayToggleInPlace as S, createArray as T, arrayShuffleInPlace as _, arrayFlatten as a, arraySum as b, arrayMax as c, arrayRandomElement as d, arrayRemoveElement as f, arrayShuffleForce as g, arrayShuffle as h, arrayFilterInPlace as i, arrayMin as l, arraySetElement as m, arrayBatches as n, arrayIntersection as o, arraySetArrayInPlace as p, arrayEmptyInPlace as r, arrayIsEqual as s, arrayAvg as t, arrayMinus as u, arraySorted as v, arrayUnique as w, arraySymmetricDifference as x, arraySortedNumbers as y };
+//# sourceMappingURL=array-22DcyFGC.d.mts.map