@vacantthinker/firefox-addon-framework-easy 2026.610.749 → 2026.611.751

package/README.md

@@ -92,9 +92,9 @@ export class DomainORM extends BaseORM {  }
 
 ### 📄 File: `src/generate.js`
 ```javascript
-export function generateMkvScriptForSystemWindows({  }
+export function generateMkvScriptForSystemWindows(videoInfo) {  }
 
-export function generateMkvScriptForSystemFedora({  }
+export function generateMkvScriptForSystemFedora(videoInfo) {  }
 
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0610.0749",
+  "version": "2026.0611.0751",
   "description": "",
   "main": "index.js",
   "publishConfig": {

package/src/BaseORM.js

@@ -1,21 +1,14 @@
 import {stoOpCheck, stoOpGet, stoOpRem, stoOpSet} from './opStorage.js';
 
 /**
- * Abstract base class BaseORM (similar to Java's Abstract Class).
- * Provides encapsulated CRUD operations for specific Key-Value pairs bound at instantiation.
+ * Abstract base class BaseORM.
+ * Provides encapsulated CRUD operations for JSON-serializable Key-Value pairs.
  */
 export class BaseORM {
-  // Private fields for data encapsulation
-  #id; // Added to store the raw unique identifier
+  #id;
   #fullStorageKey;
   #defaultValue;
 
-  /**
-   * Constructor
-   * @param {string} prefix The prefix for the keys (e.g., 'magnetKey')
-   * @param {string} id The unique identifier for this instance
-   * @param {object} [defaultValue={}] Custom initial value
-   */
   constructor(prefix, id, defaultValue = {}) {
     if (new.target === BaseORM) {
       throw new TypeError(
@@ -25,47 +18,28 @@ export class BaseORM {
       throw new Error('Both prefix and id must be specified.');
     }
 
-    // Save the raw id to the private field
     this.#id = id;
-
     const formattedPrefix = prefix.endsWith(' ') ? prefix : `${prefix} `;
     this.#fullStorageKey = `${formattedPrefix}${id}`;
     this.#defaultValue = JSON.parse(JSON.stringify(defaultValue));
   }
 
-  /**
-   * Public Getter to retrieve the bound unique identifier (id).
-   * Can be accessed as `this.id` inside subclasses or `instance.id` externally.
-   * @return {string} The raw id
-   */
   get id() {
     return this.#id;
   }
 
-  /**
-   * Protected Getter for subclasses to safely access the complete key.
-   * Can be used in subclasses as `this.storageKey`.
-   * @protected
-   * @return {string} The full storage key
-   */
   get storageKey() {
     return this.#fullStorageKey;
   }
 
-  // Private helper method
   async #exists() {
     return await stoOpCheck(this.#fullStorageKey);
   }
 
-  // Private helper method
   async #initDefaultObject() {
     await stoOpSet(this.#fullStorageKey, this.#defaultValue);
   }
 
-  /**
-   * [Read] Retrieve the value associated with the bound key.
-   * @return {Promise<object>}
-   */
   async get() {
     if (!(await this.#exists())) {
       await this.#initDefaultObject();
@@ -73,31 +47,16 @@ export class BaseORM {
     return await stoOpGet(this.#fullStorageKey);
   }
 
-  /**
-   * [Create/Update] Overwrite the value of the bound key completely.
-   * @param {object} value The new Object data to store
-   * @return {Promise<void>}
-   */
   async set(value) {
     await stoOpSet(this.#fullStorageKey, value || this.#defaultValue);
   }
 
-  /**
-   * [Delete] Wipe the bound key from storage.
-   * @return {Promise<object>}
-   */
   async delete() {
     const previousValue = await this.get();
     await stoOpRem(this.#fullStorageKey);
     return previousValue;
   }
 
-  /**
-   * [Partial Update] Modify a single targeted key-value pair nested deep within the stored object.
-   * @param {string} objectKey The internal key path inside the main value object
-   * @param {*} objectValue The new value to map to that key
-   * @return {Promise<object>} Returns the fully updated object structure
-   */
   async updateValueKeyValue(objectKey, objectValue) {
     const currentData = await this.get();
     currentData[objectKey] = objectValue;

package/src/generate.js

@@ -1,6 +1,11 @@
-export function generateMkvScriptForSystemWindows({vid, title}) {
-  let args = {vid, title};
-
+/**
+ *
+ * @param videoInfo
+ * @param videoInfo.vid{string}
+ * @param videoInfo.videoTitle{string}
+ * @return {string}
+ */
+export function generateMkvScriptForSystemWindows(videoInfo) {
   return `if (true) {
   const path = require('path');
   const fs = require('fs');
@@ -9,11 +14,11 @@ export function generateMkvScriptForSystemWindows({vid, title}) {
   let dot = '.';
   let extMKV = 'mkv';
 
-  let {vid, title} = ${JSON.stringify(args)};
+  let {vid, videoTitle} = ${JSON.stringify(videoInfo)};
   let playVideoAfterMerged = true;
   let pathToMkvmerge = 'C:\\\\Program Files\\\\MKVToolNix\\\\mkvmerge.exe';
 
-  let pathMKVOutput = path.join(pathDownload, title.concat(dot, extMKV));
+  let pathMKVOutput = path.join(pathDownload, videoTitle.concat(dot, extMKV));
   let pathOutput = path.join(pathDownload, vid.concat(dot, extMKV));
   let pathInputAudio = path.join(pathDownload, vid.concat(dot, "mp3"));
   let pathInputVideo = path.join(pathDownload, vid.concat(dot, "mp4"));
@@ -24,7 +29,7 @@ export function generateMkvScriptForSystemWindows({vid, title}) {
   ) {
 
     console.log('');
-    console.log(['file check ok!', title].join(' '));
+    console.log(['file check ok!', videoTitle].join(' '));
 
     let cmd_merge = [
       [pathToMkvmerge].map(v => '"' + v + '"').join(''),
@@ -56,7 +61,7 @@ export function generateMkvScriptForSystemWindows({vid, title}) {
       console.log('error', data);
     });
     exec_merge.stdout.on('close', (data) => {
-      console.log(['merge finish!', title].join(' '));
+      console.log(['merge finish!', videoTitle].join(' '));
 
       if (true) {
         console.log('remove inputFile');
@@ -86,9 +91,14 @@ export function generateMkvScriptForSystemWindows({vid, title}) {
   `;
 }
 
-export function generateMkvScriptForSystemFedora({vid, title}) {
-  let args = {vid, title};
-
+/**
+ *
+ * @param videoInfo
+ * @param videoInfo.vid{string}
+ * @param videoInfo.videoTitle{string}
+ * @return {string}
+ */
+export function generateMkvScriptForSystemFedora(videoInfo) {
   // We wrap the Node.js script inside a Linux Shell script block
   return `#!/usr/bin/env bash
 # This header tells Fedora to treat this file as a runnable bash script
@@ -110,17 +120,17 @@ let pathDownload = path.join(__dirname);
 let dot = '.';
 let extMKV = 'mkv';
 
-let {vid, title} = ${JSON.stringify(args)};
+let {vid, videoTitle} = ${JSON.stringify(videoInfo)};
 let playVideoAfterMerged = true;
 let pathToMkvmerge = '/usr/bin/mkvmerge';
 
-let pathMKVOutput = path.join(pathDownload, title.concat(dot, extMKV));
+let pathMKVOutput = path.join(pathDownload, videoTitle.concat(dot, extMKV));
 let pathOutput = path.join(pathDownload, vid.concat(dot, extMKV));
 let pathInputAudio = path.join(pathDownload, vid.concat(dot, "mp3"));
 let pathInputVideo = path.join(pathDownload, vid.concat(dot, "mp4"));
 
 if (fs.existsSync(pathToMkvmerge)) {
-  console.log('\\nfile check ok! ' + title);
+  console.log('\\nfile check ok! ' + videoTitle);
 
   let cmd_merge = [
     '"' + pathToMkvmerge + '"',
@@ -134,7 +144,7 @@ if (fs.existsSync(pathToMkvmerge)) {
   try {
     // Run merge synchronously so stdout pipes directly to the terminal
     execSync(cmd_merge, { stdio: 'inherit' });
-    console.log('merge finish! ' + title);
+    console.log('merge finish! ' + videoTitle);
 
     console.log('remove inputFile');
     if (fs.existsSync(pathInputVideo)) fs.unlinkSync(pathInputVideo);
@@ -164,4 +174,4 @@ read unused_input
 # Deletes the shell script file itself after completion
 rm -- "$0"
 `;
-}
+}