@gesslar/toolkit 3.32.0 → 3.33.1

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "3.32.0",
+  "version": "3.33.1",
   "license": "Unlicense",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {

package/src/browser/lib/Valid.js

@@ -23,8 +23,7 @@ export default class Valid {
   static type(value, type, options) {
     Valid.assert(
       Data.isType(value, type, options),
-      `Invalid type. Expected ${type}, got ${JSON.stringify(value)}`,
-      1,
+      `Invalid type. Expected ${type}, got ${Data.typeOf(value)}`
     )
   }
 

package/src/node/lib/FileObject.js

@@ -470,6 +470,88 @@ export default class FileObject extends FS {
     return await import(filePath)
   }
 
+  /**
+   * Copies the file to a new location and returns a new FileObject for the copy.
+   * Performs a byte-for-byte copy of the file contents.
+   *
+   * @param {string} destination - The destination file path
+   * @returns {Promise<FileObject>} A new FileObject representing the copied file
+   * @throws {Sass} If the source file does not exist
+   * @throws {Sass} If the copy operation fails
+   * @example
+   * const file = new FileObject('./image.png')
+   * const copied = await file.copy('./backup/image.png')
+   * console.log(copied.path) // /absolute/path/to/backup/image.png
+   */
+  async copy(destination) {
+    Valid.type(destination, "String", {allowEmpty: false})
+
+    const filePath = this.path
+
+    if(!(await this.exists))
+      throw Sass.new(`No such file '${filePath}'`)
+
+    const destFile = new FileObject(destination)
+
+    try {
+      await fs.copyFile(filePath, destFile.path)
+    } catch(error) {
+      throw Sass.new(`Failed to copy file to '${destFile.path}'`, error)
+    }
+
+    return destFile
+  }
+
+  /**
+   * Moves the file to a new location and returns a new FileObject for the
+   * moved file. Uses rename when possible, falling back to copy and delete
+   * for cross-device moves.
+   *
+   * @param {string} destination - The destination file path
+   * @returns {Promise<FileObject>} A new FileObject representing the moved file
+   * @throws {Sass} If the source file does not exist
+   * @throws {Sass} If the move operation fails
+   * @example
+   * const file = new FileObject('./data.json')
+   * const moved = await file.move('./archive/data.json')
+   * console.log(moved.path) // /absolute/path/to/archive/data.json
+   */
+  async move(destination) {
+    Valid.type(destination, "String", {allowEmpty: false})
+
+    const filePath = this.path
+
+    if(!(await this.exists))
+      throw Sass.new(`No such file '${filePath}'`)
+
+    const destFile = new FileObject(destination)
+
+    try {
+      await fs.rename(filePath, destFile.path)
+    } catch(error) {
+      if(error.code === "EXDEV") {
+        try {
+          const stat = await fs.lstat(filePath)
+
+          if(stat.isSymbolicLink()) {
+            const target = await fs.readlink(filePath)
+            await fs.symlink(target, destFile.path)
+          } else {
+            await fs.copyFile(filePath, destFile.path)
+          }
+
+          await fs.unlink(filePath)
+        } catch(fallbackError) {
+          throw Sass.new(`Failed to move file to '${destFile.path}'`, fallbackError)
+        }
+      } else {
+        throw Sass.new(`Failed to move file to '${destFile.path}'`, error)
+      }
+    }
+
+    return destFile
+  }
+
   /**
    * Deletes the file from the filesystem.
    *

package/types/browser/lib/Valid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Valid.js"],"names":[],"mappings":"AAWA;;GAEG;AACH;IACE;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,MAAM,QAQhB;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAkBhB;IAED,+CAAmE;IAEnE;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAYvB;CACF"}
+{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Valid.js"],"names":[],"mappings":"AAWA;;GAEG;AACH;IACE;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,MAAM,QAOhB;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAkBhB;IAED,+CAAmE;IAEnE;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAYvB;CACF"}

package/types/node/lib/FileObject.d.ts

@@ -209,6 +209,35 @@ export default class FileObject extends FS {
      * @returns {Promise<object>} The file contents as a module.
      */
     import(): Promise<object>;
+    /**
+     * Copies the file to a new location and returns a new FileObject for the copy.
+     * Performs a byte-for-byte copy of the file contents.
+     *
+     * @param {string} destination - The destination file path
+     * @returns {Promise<FileObject>} A new FileObject representing the copied file
+     * @throws {Sass} If the source file does not exist
+     * @throws {Sass} If the copy operation fails
+     * @example
+     * const file = new FileObject('./image.png')
+     * const copied = await file.copy('./backup/image.png')
+     * console.log(copied.path) // /absolute/path/to/backup/image.png
+     */
+    copy(destination: string): Promise<FileObject>;
+    /**
+     * Moves the file to a new location and returns a new FileObject for the
+     * moved file. Uses rename when possible, falling back to copy and delete
+     * for cross-device moves.
+     *
+     * @param {string} destination - The destination file path
+     * @returns {Promise<FileObject>} A new FileObject representing the moved file
+     * @throws {Sass} If the source file does not exist
+     * @throws {Sass} If the move operation fails
+     * @example
+     * const file = new FileObject('./data.json')
+     * const moved = await file.move('./archive/data.json')
+     * console.log(moved.path) // /absolute/path/to/archive/data.json
+     */
+    move(destination: string): Promise<FileObject>;
     /**
      * Deletes the file from the filesystem.
      *

package/types/node/lib/FileObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;GAaG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA8bF;;;;;;;;;;;OAWG;IACH,kBAPa,UAAU,CAsCtB;IA/cD;;;;;OAKG;IACH,uBAHW,MAAM,WACN,eAAe,GAAC,MAAM,GAAC,IAAI,EA+DrC;IAWD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IACD;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,cAFa,eAAe,CAI3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,YAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;IAED;;;;;OAKG;IACH,YAFa,OAAO,CAAC,IAAI,OAAC,CAAC,CAU1B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;;;OAWG;IACH,cARa,OAAO,CAAC,MAAM,CAAC,CAe3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAiC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAczB;;CA8CF;eAzgBc,iBAAiB;4BADJ,sBAAsB;kBAPhC,OAAO;iBAER,MAAM"}
+{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;GAaG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IAghBF;;;;;;;;;;;OAWG;IACH,kBAPa,UAAU,CAsCtB;IAjiBD;;;;;OAKG;IACH,uBAHW,MAAM,WACN,eAAe,GAAC,MAAM,GAAC,IAAI,EA+DrC;IAWD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IACD;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,cAFa,eAAe,CAI3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,YAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;IAED;;;;;OAKG;IACH,YAFa,OAAO,CAAC,IAAI,OAAC,CAAC,CAU1B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;;;OAWG;IACH,cARa,OAAO,CAAC,MAAM,CAAC,CAe3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAiC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;;;;OAYG;IACH,kBATW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CAyB/B;IAED;;;;;;;;;;;;;OAaG;IACH,kBATW,MAAM,GACJ,OAAO,CAAC,UAAU,CAAC,CA0C/B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAczB;;CA8CF;eA3lBc,iBAAiB;4BADJ,sBAAsB;kBAPhC,OAAO;iBAER,MAAM"}