@cmdoss/file-manager 0.1.0 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,14 +1,14 @@
 
-> @cmdoss/file-manager@0.1.0 build /home/runner/work/ts-sdks/ts-sdks/packages/file-manager
+> @cmdoss/file-manager@0.2.0 build /home/runner/work/ts-sdks/ts-sdks/packages/file-manager
 > tsdown --platform browser --minify
 
-ℹ tsdown v0.15.4 powered by rolldown v1.0.0-beta.43
+ℹ tsdown v0.16.8 powered by rolldown v1.0.0-beta.52
 ℹ entry: src/index.ts
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/index.js        1.87 kB │ gzip: 0.82 kB
-ℹ dist/index.js.map    5.55 kB │ gzip: 1.92 kB
-ℹ dist/index.d.ts.map  0.73 kB │ gzip: 0.35 kB
-ℹ dist/index.d.ts      0.79 kB │ gzip: 0.41 kB
-ℹ 4 files, total: 8.94 kB
-✔ Build complete in 236ms
+ℹ dist/index.js        2.95 kB │ gzip: 1.21 kB
+ℹ dist/index.js.map    8.31 kB │ gzip: 2.72 kB
+ℹ dist/index.d.ts.map  0.87 kB │ gzip: 0.37 kB
+ℹ dist/index.d.ts      1.06 kB │ gzip: 0.50 kB
+ℹ 4 files, total: 13.20 kB
+✔ Build complete in 365ms

package/dist/index.d.ts

@@ -2,18 +2,21 @@ import { FileChangedCallback, IFileManager } from "@cmdoss/site-builder";
 
 //#region src/file-manager.d.ts
 declare class ZenFsFileManager implements IFileManager {
-  private workspaceDir;
-  private backend;
-  private changeListeners;
-  constructor(workspaceDir?: string, backend?: "indexeddb" | "zip" | "iso");
-  mount(data?: ArrayBuffer, force?: boolean): Promise<void>;
-  writeFile(filePath: string, content: string | Uint8Array): Promise<void>;
-  removeFile(filePath: string): Promise<void>;
+  /** The directory of the workspace. Any files within this directory are considered part of the workspace. */
+  readonly workspaceDir: string;
+  /** The directory where the workspace is mounted in the virtual filesystem. */
+  readonly mountDir?: string | undefined;
+  protected changeListeners: Set<FileChangedCallback>;
+  constructor(workspaceDir?: string, mountDir?: string | undefined);
+  initialize(): Promise<void>;
+  writeZipArchive(zipData: ArrayBuffer): Promise<void>;
   readFile(filePath: string): Promise<Uint8Array>;
   listFiles(): Promise<string[]>;
+  getSize(): Promise<number>;
+  writeFile(filePath: string, content: string | Uint8Array): Promise<void>;
+  deleteFile(filePath: string): Promise<void>;
   onFileChange(callback: FileChangedCallback): () => void;
   private notifyChange;
-  clear(): Promise<void>;
   unmount(): void;
 }
 //#endregion

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["backend: 'indexeddb' | 'zip' | 'iso'"],"sources":["../src/file-manager.ts"],"sourcesContent":[],"mappings":";;;cAMa,gBAAA,YAA4B;;EAAzC,QAAa,OAAA;EAAA,QAAA,eAAA;aAQQ,CAAA,YAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,WAAA,GAAA,KAAA,GAAA,KAAA;QAA6B,IAAA,CAAA,EAA7B,WAA6B,EAAA,KAAA,CAAA,EAAA,OAAA,CAAA,EAAA,OAAA,CAAA,IAAA,CAAA;WAuB5B,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,GAAA,UAAA,CAAA,EACjB,OADiB,CAAA,IAAA,CAAA;YACjB,CAAA,QAAA,EAAA,MAAA,CAAA,EAciC,OAdjC,CAAA,IAAA,CAAA;UAciC,CAAA,QAAA,EAAA,MAAA,CAAA,EAOF,OAPE,CAOM,UAPN,CAAA;WAOM,CAAA,CAAA,EAOvB,OAPuB,CAAA,MAAA,EAAA,CAAA;cAAR,CAAA,QAAA,EAmBX,mBAnBW,CAAA,EAAA,GAAA,GAAA,IAAA;UAOf,YAAA;SAYI,EAaR,OAbQ,CAAA,IAAA,CAAA;SAaR,CAAA,CAAA,EAAA,IAAA"}
+{"version":3,"file":"index.d.ts","names":["mountDir?: string"],"sources":["../src/file-manager.ts"],"sourcesContent":[],"mappings":";;;cASa,gBAAA,YAA4B;;EAAzC,SAAa,YAAA,EAAA,MAAA;EACoB;EAAJ,SAAA,QAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAyBP,UAAA,eAAA,EAzBO,GAyBP,CAzBW,mBAyBX,CAAA;EAcW,WAAA,CAAA,YAAA,CAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAc,UAAA,CAAA,CAAA,EAdzB,OAcyB,CAAA,IAAA,CAAA;EAiBH,eAAA,CAAA,OAAA,EAjBX,WAiBW,CAAA,EAjBG,OAiBH,CAAA,IAAA,CAAA;EAAR,QAAA,CAAA,QAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAQ,UAAR,CAAA;EASf,SAAA,CAAA,CAAA,EAAA,OAAA,CAAA,MAAA,EAAA,CAAA;EAcF,OAAA,CAAA,CAAA,EAAA,OAAA,CAAA,MAAA,CAAA;EAwBG,SAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,GAAA,UAAA,CAAA,EACjB,OADiB,CAAA,IAAA,CAAA;EACjB,UAAA,CAAA,QAAA,EAAA,MAAA,CAAA,EAaiC,OAbjC,CAAA,IAAA,CAAA;EAaiC,YAAA,CAAA,QAAA,EASb,mBATa,CAAA,EAAA,GAAA,GAAA,IAAA;EASb,QAAA,YAAA;EA/HgB,OAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import{Iso as e,Zip as t}from"@zenfs/archives";import{configure as n,fs as r}from"@zenfs/core";import*as i from"@zenfs/core/path";import{IndexedDB as a}from"@zenfs/dom";var o=class{changeListeners=new Set;constructor(e=`/workspace`,t=`indexeddb`){this.workspaceDir=e,this.backend=t}async mount(i,o=!1){let s=this.backend===`indexeddb`?a:this.backend===`zip`?t:this.backend===`iso`?e:null;if(!s)throw Error(`Invalid backend specified`);if(await r.promises.access(this.workspaceDir).then(()=>!0).catch(()=>!1)){if(!o)throw Error(`Workspace directory is already mounted`);this.unmount()}await n({mounts:{[this.workspaceDir]:{backend:s,data:i}}})}async writeFile(e,t){e=s(e);let n=i.join(this.workspaceDir,e),a=i.dirname(n);await r.promises.mkdir(a,{recursive:!0});let o=typeof t==`string`?new TextEncoder().encode(t):t;await r.promises.writeFile(n,o),this.notifyChange({type:`updated`,path:e})}async removeFile(e){e=s(e);let t=i.join(this.workspaceDir,e);await r.promises.rm(t),this.notifyChange({type:`removed`,path:e})}async readFile(e){e=s(e);let t=i.join(this.workspaceDir,e);return console.log(`Reading file from path:`,t),await r.promises.readFile(t)}async listFiles(){let e=await r.promises.readdir(this.workspaceDir,{withFileTypes:!0,recursive:!0});return console.log(`Files in workspace:`,e),e.filter(e=>e.isFile()).map(e=>i.resolve(e.parentPath,e.name)).map(s)}onFileChange(e){return this.changeListeners.add(e),()=>{this.changeListeners.delete(e)}}notifyChange(e){for(let t of this.changeListeners)t(e)}async clear(){let e=await r.promises.readdir(this.workspaceDir,{withFileTypes:!0});for(let t of e){let e=i.join(t.parentPath,t.name);await r.promises.rm(e,{recursive:!0,force:!0})}}unmount(){this.changeListeners.clear(),r.umount(this.workspaceDir)}};function s(e){return e.startsWith(`/`)?e:`/${e}`}export{o as ZenFsFileManager};
+import{Zip as e}from"@zenfs/archives";import{configure as t,fs as n}from"@zenfs/core";import*as r from"@zenfs/core/path";import{IndexedDB as i}from"@zenfs/dom";import a from"debug";const o=a(`file-manager`);var s=class{changeListeners=new Set;constructor(e=`/workspace`,t){if(this.workspaceDir=e,this.mountDir=t,this.mountDir||=this.workspaceDir,this.mountDir!==this.workspaceDir){let e=r.normalize(this.workspaceDir),t=r.normalize(this.mountDir);if(!e.startsWith(t+`/`)&&e!==t)throw Error(`workspaceDir (${this.workspaceDir}) must be a subdirectory of mountDir (${this.mountDir})`)}}async initialize(){o(`🔧 Configuring filesystem...`),o(`📁 Mounting workspace at ${this.mountDir}`),await t({mounts:{[this.mountDir??this.workspaceDir]:{backend:i,storeName:this.mountDir??this.workspaceDir}}}),o(`✅ Filesystem configured`)}async writeZipArchive(r){let i=`/tmp/zip-write-${crypto.randomUUID()}`;o(`📦 Mounting ZIP archive to temporary directory...`),await t({mounts:{[i]:{backend:e,data:r,lazy:!1}}}),o(`📂 Copying files from ZIP archive to workspace...`),await n.promises.cp(i,this.workspaceDir,{recursive:!0}),o(`✅ Files copied to workspace from ZIP archive`)}async readFile(e){o(`📂 Reading file from`,e),e=c(e);let t=r.join(this.workspaceDir,e),i=await n.promises.readFile(t);return o(`✅ File read from`,e,`(`,i.byteLength,`bytes )`),i}async listFiles(){o(`📄 Listing files in workspace`);let e=(await n.promises.readdir(this.workspaceDir,{withFileTypes:!0,recursive:!0})).filter(e=>e.isFile()).map(e=>r.join(e.parentPath,e.name)).map(c);return o(`✅ Files currently in workspace`,e),e}async getSize(){o(`📏 Calculating total size of files in workspace`);let e=0,t=await n.promises.readdir(this.workspaceDir,{withFileTypes:!0,recursive:!0});for(let i of t)if(i.isFile()){let t=r.join(this.workspaceDir,i.parentPath,i.name),a=await n.promises.stat(t);e+=a.size}return o(`✅ Total size of files in workspace:`,e,`bytes`),e}async writeFile(e,t){o(`✍️ Writing file to`,e),e=c(e);let i=r.join(this.workspaceDir,e),a=r.dirname(i);await n.promises.mkdir(a,{recursive:!0});let s=typeof t==`string`?new TextEncoder().encode(t):t;await n.promises.writeFile(i,s),o(`✅ File written to`,e,`(`,s.byteLength,`bytes )`),this.notifyChange({type:`updated`,path:e})}async deleteFile(e){o(`🗑️ Deleting file at`,e),e=c(e);let t=r.join(this.workspaceDir,e);await n.promises.rm(t),o(`✅ File deleted at`,e),this.notifyChange({type:`removed`,path:e})}onFileChange(e){return this.changeListeners.add(e),()=>{this.changeListeners.delete(e)}}notifyChange(e){for(let t of this.changeListeners)t(e)}unmount(){o(`🚪 Unmounting workspace directory (`,this.workspaceDir,`)`),this.changeListeners.clear(),this.mountDir===this.workspaceDir?n.umount(this.mountDir):o(`⚠️ Skipping unmount: mountDir and workspaceDir are different`)}};function c(e){return e.startsWith(`/`)?e:`/${e}`}export{s as ZenFsFileManager};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["backend: 'indexeddb' | 'zip' | 'iso'","path"],"sources":["../src/file-manager.ts"],"sourcesContent":["import type { FileChangedCallback, IFileManager } from '@cmdoss/site-builder'\nimport { Iso, Zip } from '@zenfs/archives'\nimport { configure, fs } from '@zenfs/core'\nimport * as path from '@zenfs/core/path'\nimport { IndexedDB } from '@zenfs/dom'\n\nexport class ZenFsFileManager implements IFileManager {\n  private changeListeners = new Set<FileChangedCallback>()\n\n  constructor(\n    private workspaceDir = '/workspace',\n    private backend: 'indexeddb' | 'zip' | 'iso' = 'indexeddb'\n  ) {}\n\n  async mount(data?: ArrayBuffer, force = false): Promise<void> {\n    const backend =\n      this.backend === 'indexeddb'\n        ? IndexedDB\n        : this.backend === 'zip'\n          ? Zip\n          : this.backend === 'iso'\n            ? Iso\n            : null\n    if (!backend) throw new Error('Invalid backend specified')\n    const isAccessible = await fs.promises\n      .access(this.workspaceDir)\n      .then(() => true)\n      .catch(() => false)\n    if (isAccessible) {\n      if (!force) throw new Error('Workspace directory is already mounted')\n      this.unmount() // Unmount existing instance\n    }\n    await configure({ mounts: { [this.workspaceDir]: { backend, data } } })\n  }\n\n  async writeFile(\n    filePath: string,\n    content: string | Uint8Array\n  ): Promise<void> {\n    filePath = ensureLeadingSlash(filePath)\n    const workspaceFilePath = path.join(this.workspaceDir, filePath)\n    const dir = path.dirname(workspaceFilePath)\n    await fs.promises.mkdir(dir, { recursive: true })\n    const contentBytes =\n      typeof content === 'string' ? new TextEncoder().encode(content) : content\n    await fs.promises.writeFile(workspaceFilePath, contentBytes)\n    this.notifyChange({\n      type: 'updated',\n      path: filePath\n    })\n  }\n\n  async removeFile(filePath: string): Promise<void> {\n    filePath = ensureLeadingSlash(filePath)\n    const workspaceFilePath = path.join(this.workspaceDir, filePath)\n    await fs.promises.rm(workspaceFilePath)\n    this.notifyChange({ type: 'removed', path: filePath })\n  }\n\n  async readFile(filePath: string): Promise<Uint8Array> {\n    filePath = ensureLeadingSlash(filePath)\n    const workspaceFilePath = path.join(this.workspaceDir, filePath)\n    console.log('Reading file from path:', workspaceFilePath)\n    return await fs.promises.readFile(workspaceFilePath)\n  }\n\n  async listFiles(): Promise<string[]> {\n    const files = await fs.promises.readdir(this.workspaceDir, {\n      withFileTypes: true,\n      recursive: true\n    })\n    console.log('Files in workspace:', files)\n    return files\n      .filter(f => f.isFile())\n      .map(f => path.resolve(f.parentPath, f.name))\n      .map(ensureLeadingSlash)\n  }\n\n  onFileChange(callback: FileChangedCallback): () => void {\n    this.changeListeners.add(callback)\n    return () => {\n      this.changeListeners.delete(callback)\n    }\n  }\n\n  private notifyChange(arg: Parameters<FileChangedCallback>[0]): void {\n    for (const listener of this.changeListeners) {\n      listener(arg)\n    }\n  }\n\n  async clear(): Promise<void> {\n    const files = await fs.promises.readdir(this.workspaceDir, {\n      withFileTypes: true\n    })\n    for (const file of files) {\n      const filePath = path.join(file.parentPath, file.name)\n      await fs.promises.rm(filePath, { recursive: true, force: true })\n    }\n  }\n\n  unmount(): void {\n    this.changeListeners.clear()\n    fs.umount(this.workspaceDir)\n  }\n}\n\nfunction ensureLeadingSlash(path: string): string {\n  return path.startsWith('/') ? path : `/${path}`\n}\n"],"mappings":"yKAMA,IAAa,EAAb,KAAsD,CACpD,gBAA0B,IAAI,IAE9B,YACE,EAAuB,aACvB,EAA+C,YAC/C,CAFQ,KAAA,aAAA,EACA,KAAA,QAAA,EAGV,MAAM,MAAM,EAAoB,EAAQ,GAAsB,CAC5D,IAAM,EACJ,KAAK,UAAY,YACb,EACA,KAAK,UAAY,MACf,EACA,KAAK,UAAY,MACf,EACA,KACV,GAAI,CAAC,EAAS,MAAU,MAAM,4BAA4B,CAK1D,GAJqB,MAAM,EAAG,SAC3B,OAAO,KAAK,aAAa,CACzB,SAAW,GAAK,CAChB,UAAY,GAAM,CACH,CAChB,GAAI,CAAC,EAAO,MAAU,MAAM,yCAAyC,CACrE,KAAK,SAAS,CAEhB,MAAM,EAAU,CAAE,OAAQ,EAAG,KAAK,cAAe,CAAE,UAAS,OAAM,CAAE,CAAE,CAAC,CAGzE,MAAM,UACJ,EACA,EACe,CACf,EAAW,EAAmB,EAAS,CACvC,IAAM,EAAoB,EAAK,KAAK,KAAK,aAAc,EAAS,CAC1D,EAAM,EAAK,QAAQ,EAAkB,CAC3C,MAAM,EAAG,SAAS,MAAM,EAAK,CAAE,UAAW,GAAM,CAAC,CACjD,IAAM,EACJ,OAAO,GAAY,SAAW,IAAI,aAAa,CAAC,OAAO,EAAQ,CAAG,EACpE,MAAM,EAAG,SAAS,UAAU,EAAmB,EAAa,CAC5D,KAAK,aAAa,CAChB,KAAM,UACN,KAAM,EACP,CAAC,CAGJ,MAAM,WAAW,EAAiC,CAChD,EAAW,EAAmB,EAAS,CACvC,IAAM,EAAoB,EAAK,KAAK,KAAK,aAAc,EAAS,CAChE,MAAM,EAAG,SAAS,GAAG,EAAkB,CACvC,KAAK,aAAa,CAAE,KAAM,UAAW,KAAM,EAAU,CAAC,CAGxD,MAAM,SAAS,EAAuC,CACpD,EAAW,EAAmB,EAAS,CACvC,IAAM,EAAoB,EAAK,KAAK,KAAK,aAAc,EAAS,CAEhE,OADA,QAAQ,IAAI,0BAA2B,EAAkB,CAClD,MAAM,EAAG,SAAS,SAAS,EAAkB,CAGtD,MAAM,WAA+B,CACnC,IAAM,EAAQ,MAAM,EAAG,SAAS,QAAQ,KAAK,aAAc,CACzD,cAAe,GACf,UAAW,GACZ,CAAC,CAEF,OADA,QAAQ,IAAI,sBAAuB,EAAM,CAClC,EACJ,OAAO,GAAK,EAAE,QAAQ,CAAC,CACvB,IAAI,GAAK,EAAK,QAAQ,EAAE,WAAY,EAAE,KAAK,CAAC,CAC5C,IAAI,EAAmB,CAG5B,aAAa,EAA2C,CAEtD,OADA,KAAK,gBAAgB,IAAI,EAAS,KACrB,CACX,KAAK,gBAAgB,OAAO,EAAS,EAIzC,aAAqB,EAA+C,CAClE,IAAK,IAAM,KAAY,KAAK,gBAC1B,EAAS,EAAI,CAIjB,MAAM,OAAuB,CAC3B,IAAM,EAAQ,MAAM,EAAG,SAAS,QAAQ,KAAK,aAAc,CACzD,cAAe,GAChB,CAAC,CACF,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,EAAW,EAAK,KAAK,EAAK,WAAY,EAAK,KAAK,CACtD,MAAM,EAAG,SAAS,GAAG,EAAU,CAAE,UAAW,GAAM,MAAO,GAAM,CAAC,EAIpE,SAAgB,CACd,KAAK,gBAAgB,OAAO,CAC5B,EAAG,OAAO,KAAK,aAAa,GAIhC,SAAS,EAAmB,EAAsB,CAChD,OAAOC,EAAK,WAAW,IAAI,CAAGA,EAAO,IAAIA"}
+{"version":3,"file":"index.js","names":["mountDir?: string","path"],"sources":["../src/file-manager.ts"],"sourcesContent":["import type { FileChangedCallback, IFileManager } from '@cmdoss/site-builder'\nimport { Zip } from '@zenfs/archives'\nimport { configure, fs } from '@zenfs/core'\nimport * as path from '@zenfs/core/path'\nimport { IndexedDB } from '@zenfs/dom'\nimport debug from 'debug'\n\nconst log = debug('file-manager')\n\nexport class ZenFsFileManager implements IFileManager {\n  protected changeListeners: Set<FileChangedCallback> = new Set()\n  constructor(\n    /** The directory of the workspace. Any files within this directory are considered part of the workspace. */\n    public readonly workspaceDir = '/workspace',\n    /** The directory where the workspace is mounted in the virtual filesystem. */\n    public readonly mountDir?: string\n  ) {\n    if (!this.mountDir) {\n      this.mountDir = this.workspaceDir\n    }\n    if (this.mountDir !== this.workspaceDir) {\n      // Ensure workspaceDir is a subdirectory of mountDir\n      const normalizedWorkspace = path.normalize(this.workspaceDir)\n      const normalizedMount = path.normalize(this.mountDir)\n      if (\n        !normalizedWorkspace.startsWith(normalizedMount + '/') &&\n        normalizedWorkspace !== normalizedMount\n      ) {\n        throw new Error(\n          `workspaceDir (${this.workspaceDir}) must be a subdirectory of mountDir (${this.mountDir})`\n        )\n      }\n    }\n  }\n\n  async initialize(): Promise<void> {\n    log('🔧 Configuring filesystem...')\n    log(`📁 Mounting workspace at ${this.mountDir}`)\n    await configure({\n      mounts: {\n        [this.mountDir ?? this.workspaceDir]: {\n          backend: IndexedDB,\n          storeName: this.mountDir ?? this.workspaceDir\n        }\n      }\n    })\n    log('✅ Filesystem configured')\n  }\n\n  async writeZipArchive(zipData: ArrayBuffer): Promise<void> {\n    const tmpDir = `/tmp/zip-write-${crypto.randomUUID()}`\n    log('📦 Mounting ZIP archive to temporary directory...')\n    await configure({\n      mounts: {\n        [tmpDir]: {\n          backend: Zip,\n          data: zipData,\n          lazy: false // Extract all files immediately\n        }\n      }\n    })\n    log('📂 Copying files from ZIP archive to workspace...')\n    await fs.promises.cp(tmpDir, this.workspaceDir, { recursive: true })\n    log('✅ Files copied to workspace from ZIP archive')\n  }\n\n  async readFile(filePath: string): Promise<Uint8Array> {\n    log('📂 Reading file from', filePath)\n    filePath = ensureLeadingSlash(filePath)\n    const workspaceFilePath = path.join(this.workspaceDir, filePath)\n    const content = await fs.promises.readFile(workspaceFilePath)\n    log('✅ File read from', filePath, '(', content.byteLength, 'bytes )')\n    return content\n  }\n\n  async listFiles(): Promise<string[]> {\n    log('📄 Listing files in workspace')\n    const files = await fs.promises.readdir(this.workspaceDir, {\n      withFileTypes: true,\n      recursive: true\n    })\n    const result = files\n      .filter(f => f.isFile())\n      .map(f => path.join(f.parentPath, f.name))\n      .map(ensureLeadingSlash)\n    log('✅ Files currently in workspace', result)\n    return result\n  }\n\n  async getSize(): Promise<number> {\n    log('📏 Calculating total size of files in workspace')\n    let totalSize = 0\n    const files = await fs.promises.readdir(this.workspaceDir, {\n      withFileTypes: true,\n      recursive: true\n    })\n    for (const file of files) {\n      if (file.isFile()) {\n        const filePath = path.join(\n          this.workspaceDir,\n          file.parentPath,\n          file.name\n        )\n        const stats = await fs.promises.stat(filePath)\n        totalSize += stats.size\n      }\n    }\n    log('✅ Total size of files in workspace:', totalSize, 'bytes')\n    return totalSize\n  }\n\n  async writeFile(\n    filePath: string,\n    content: string | Uint8Array\n  ): Promise<void> {\n    log('✍️ Writing file to', filePath)\n    filePath = ensureLeadingSlash(filePath)\n    const workspaceFilePath = path.join(this.workspaceDir, filePath)\n    const dir = path.dirname(workspaceFilePath)\n    await fs.promises.mkdir(dir, { recursive: true })\n    const contentBytes =\n      typeof content === 'string' ? new TextEncoder().encode(content) : content\n    await fs.promises.writeFile(workspaceFilePath, contentBytes)\n    log('✅ File written to', filePath, '(', contentBytes.byteLength, 'bytes )')\n    this.notifyChange({ type: 'updated', path: filePath })\n  }\n\n  async deleteFile(filePath: string): Promise<void> {\n    log('🗑️ Deleting file at', filePath)\n    filePath = ensureLeadingSlash(filePath)\n    const workspaceFilePath = path.join(this.workspaceDir, filePath)\n    await fs.promises.rm(workspaceFilePath)\n    log('✅ File deleted at', filePath)\n    this.notifyChange({ type: 'removed', path: filePath })\n  }\n\n  onFileChange(callback: FileChangedCallback): () => void {\n    this.changeListeners.add(callback)\n    return () => {\n      this.changeListeners.delete(callback)\n    }\n  }\n\n  private notifyChange(arg: Parameters<FileChangedCallback>[0]): void {\n    for (const listener of this.changeListeners) {\n      listener(arg)\n    }\n  }\n\n  unmount(): void {\n    log('🚪 Unmounting workspace directory (', this.workspaceDir, ')')\n    this.changeListeners.clear()\n    if (this.mountDir === this.workspaceDir) {\n      // Unmount only if mountDir and workspaceDir are the same\n      fs.umount(this.mountDir)\n    } else {\n      log('⚠️ Skipping unmount: mountDir and workspaceDir are different')\n    }\n  }\n}\n\nfunction ensureLeadingSlash(path: string): string {\n  return path.startsWith('/') ? path : `/${path}`\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmdoss/file-manager",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "exports": "./dist/index.js",
@@ -15,19 +15,21 @@
     "@zenfs/dom": "^1.2.4"
   },
   "dependencies": {
+    "@types/debug": "^4.1.12",
     "@zenfs/archives": "^1.3.1",
-    "@zenfs/core": "^2.4.2",
+    "@zenfs/core": "^2.4.4",
     "@zenfs/dom": "^1.2.5",
-    "@cmdoss/site-builder": "0.1.0"
+    "debug": "^4.4.3",
+    "@cmdoss/site-builder": "0.2.0"
   },
   "devDependencies": {
-    "@types/node": "^22.13.4",
-    "tsdown": "^0.15.4"
+    "@types/node": "^22.19.1",
+    "tsdown": "^0.16.8"
   },
   "scripts": {
-    "dev": "tsdown --platform browser --watch --ignore-watch .turbo",
+    "dev": "tsdown --platform browser --watch --ignore-watch .turbo --no-clean",
     "test": "node --test",
-    "check-types": "tsc --noEmit",
+    "check:types": "tsc --noEmit",
     "build": "tsdown --platform browser --minify"
   }
 }

package/src/file-manager.ts

@@ -1,42 +1,119 @@
 import type { FileChangedCallback, IFileManager } from '@cmdoss/site-builder'
-import { Iso, Zip } from '@zenfs/archives'
+import { Zip } from '@zenfs/archives'
 import { configure, fs } from '@zenfs/core'
 import * as path from '@zenfs/core/path'
 import { IndexedDB } from '@zenfs/dom'
+import debug from 'debug'
 
-export class ZenFsFileManager implements IFileManager {
-  private changeListeners = new Set<FileChangedCallback>()
+const log = debug('file-manager')
 
+export class ZenFsFileManager implements IFileManager {
+  protected changeListeners: Set<FileChangedCallback> = new Set()
   constructor(
-    private workspaceDir = '/workspace',
-    private backend: 'indexeddb' | 'zip' | 'iso' = 'indexeddb'
-  ) {}
+    /** The directory of the workspace. Any files within this directory are considered part of the workspace. */
+    public readonly workspaceDir = '/workspace',
+    /** The directory where the workspace is mounted in the virtual filesystem. */
+    public readonly mountDir?: string
+  ) {
+    if (!this.mountDir) {
+      this.mountDir = this.workspaceDir
+    }
+    if (this.mountDir !== this.workspaceDir) {
+      // Ensure workspaceDir is a subdirectory of mountDir
+      const normalizedWorkspace = path.normalize(this.workspaceDir)
+      const normalizedMount = path.normalize(this.mountDir)
+      if (
+        !normalizedWorkspace.startsWith(normalizedMount + '/') &&
+        normalizedWorkspace !== normalizedMount
+      ) {
+        throw new Error(
+          `workspaceDir (${this.workspaceDir}) must be a subdirectory of mountDir (${this.mountDir})`
+        )
+      }
+    }
+  }
+
+  async initialize(): Promise<void> {
+    log('🔧 Configuring filesystem...')
+    log(`📁 Mounting workspace at ${this.mountDir}`)
+    await configure({
+      mounts: {
+        [this.mountDir ?? this.workspaceDir]: {
+          backend: IndexedDB,
+          storeName: this.mountDir ?? this.workspaceDir
+        }
+      }
+    })
+    log('✅ Filesystem configured')
+  }
+
+  async writeZipArchive(zipData: ArrayBuffer): Promise<void> {
+    const tmpDir = `/tmp/zip-write-${crypto.randomUUID()}`
+    log('📦 Mounting ZIP archive to temporary directory...')
+    await configure({
+      mounts: {
+        [tmpDir]: {
+          backend: Zip,
+          data: zipData,
+          lazy: false // Extract all files immediately
+        }
+      }
+    })
+    log('📂 Copying files from ZIP archive to workspace...')
+    await fs.promises.cp(tmpDir, this.workspaceDir, { recursive: true })
+    log('✅ Files copied to workspace from ZIP archive')
+  }
+
+  async readFile(filePath: string): Promise<Uint8Array> {
+    log('📂 Reading file from', filePath)
+    filePath = ensureLeadingSlash(filePath)
+    const workspaceFilePath = path.join(this.workspaceDir, filePath)
+    const content = await fs.promises.readFile(workspaceFilePath)
+    log('✅ File read from', filePath, '(', content.byteLength, 'bytes )')
+    return content
+  }
 
-  async mount(data?: ArrayBuffer, force = false): Promise<void> {
-    const backend =
-      this.backend === 'indexeddb'
-        ? IndexedDB
-        : this.backend === 'zip'
-          ? Zip
-          : this.backend === 'iso'
-            ? Iso
-            : null
-    if (!backend) throw new Error('Invalid backend specified')
-    const isAccessible = await fs.promises
-      .access(this.workspaceDir)
-      .then(() => true)
-      .catch(() => false)
-    if (isAccessible) {
-      if (!force) throw new Error('Workspace directory is already mounted')
-      this.unmount() // Unmount existing instance
+  async listFiles(): Promise<string[]> {
+    log('📄 Listing files in workspace')
+    const files = await fs.promises.readdir(this.workspaceDir, {
+      withFileTypes: true,
+      recursive: true
+    })
+    const result = files
+      .filter(f => f.isFile())
+      .map(f => path.join(f.parentPath, f.name))
+      .map(ensureLeadingSlash)
+    log('✅ Files currently in workspace', result)
+    return result
+  }
+
+  async getSize(): Promise<number> {
+    log('📏 Calculating total size of files in workspace')
+    let totalSize = 0
+    const files = await fs.promises.readdir(this.workspaceDir, {
+      withFileTypes: true,
+      recursive: true
+    })
+    for (const file of files) {
+      if (file.isFile()) {
+        const filePath = path.join(
+          this.workspaceDir,
+          file.parentPath,
+          file.name
+        )
+        const stats = await fs.promises.stat(filePath)
+        totalSize += stats.size
+      }
     }
-    await configure({ mounts: { [this.workspaceDir]: { backend, data } } })
+    log('✅ Total size of files in workspace:', totalSize, 'bytes')
+    return totalSize
   }
 
   async writeFile(
     filePath: string,
     content: string | Uint8Array
   ): Promise<void> {
+    log('✍️ Writing file to', filePath)
     filePath = ensureLeadingSlash(filePath)
     const workspaceFilePath = path.join(this.workspaceDir, filePath)
     const dir = path.dirname(workspaceFilePath)
@@ -44,38 +121,19 @@ export class ZenFsFileManager implements IFileManager {
     const contentBytes =
       typeof content === 'string' ? new TextEncoder().encode(content) : content
     await fs.promises.writeFile(workspaceFilePath, contentBytes)
-    this.notifyChange({
-      type: 'updated',
-      path: filePath
-    })
+    log('✅ File written to', filePath, '(', contentBytes.byteLength, 'bytes )')
+    this.notifyChange({ type: 'updated', path: filePath })
   }
 
-  async removeFile(filePath: string): Promise<void> {
+  async deleteFile(filePath: string): Promise<void> {
+    log('🗑️ Deleting file at', filePath)
     filePath = ensureLeadingSlash(filePath)
     const workspaceFilePath = path.join(this.workspaceDir, filePath)
     await fs.promises.rm(workspaceFilePath)
+    log('✅ File deleted at', filePath)
     this.notifyChange({ type: 'removed', path: filePath })
   }
 
-  async readFile(filePath: string): Promise<Uint8Array> {
-    filePath = ensureLeadingSlash(filePath)
-    const workspaceFilePath = path.join(this.workspaceDir, filePath)
-    console.log('Reading file from path:', workspaceFilePath)
-    return await fs.promises.readFile(workspaceFilePath)
-  }
-
-  async listFiles(): Promise<string[]> {
-    const files = await fs.promises.readdir(this.workspaceDir, {
-      withFileTypes: true,
-      recursive: true
-    })
-    console.log('Files in workspace:', files)
-    return files
-      .filter(f => f.isFile())
-      .map(f => path.resolve(f.parentPath, f.name))
-      .map(ensureLeadingSlash)
-  }
-
   onFileChange(callback: FileChangedCallback): () => void {
     this.changeListeners.add(callback)
     return () => {
@@ -89,19 +147,15 @@ export class ZenFsFileManager implements IFileManager {
     }
   }
 
-  async clear(): Promise<void> {
-    const files = await fs.promises.readdir(this.workspaceDir, {
-      withFileTypes: true
-    })
-    for (const file of files) {
-      const filePath = path.join(file.parentPath, file.name)
-      await fs.promises.rm(filePath, { recursive: true, force: true })
-    }
-  }
-
   unmount(): void {
+    log('🚪 Unmounting workspace directory (', this.workspaceDir, ')')
     this.changeListeners.clear()
-    fs.umount(this.workspaceDir)
+    if (this.mountDir === this.workspaceDir) {
+      // Unmount only if mountDir and workspaceDir are the same
+      fs.umount(this.mountDir)
+    } else {
+      log('⚠️ Skipping unmount: mountDir and workspaceDir are different')
+    }
   }
 }
 

package/tsconfig.json

@@ -3,7 +3,7 @@
   "extends": "../../configs/tsconfig.library.json",
   "compilerOptions": {
     "lib": ["ES2021", "DOM"],
-    "outDir": "/dist",
+    "outDir": "dist",
     "emitDeclarationOnly": true,
     "allowImportingTsExtensions": true
   },

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @cmdoss/file-manager@0.1.0 test /home/runner/work/ts-sdks/ts-sdks/packages/file-manager
-> node --test
-
-TAP version 13
-1..0
-# tests 0
-# suites 0
-# pass 0
-# fail 0
-# cancelled 0
-# skipped 0
-# todo 0
-# duration_ms 56.835878