@vacantthinker/firefox-addon-framework-easy 2026.619.1137 → 2026.619.1302

package/dist/opStorage.d.ts

@@ -42,4 +42,47 @@ export declare function stoOpRem(key: string): Promise<void>;
  * @param key The key to set to null.
  */
 export declare function stoOpSetNull(key: string): Promise<void>;
+/**
+ * Checks if a key exists in sync storage.
+ * @param key The key to check.
+ * @returns Promise resolving to true if key exists, false otherwise.
+ */
+export declare function syncStoOpCheck(key: string): Promise<boolean>;
+/**
+ * Retrieves a value from sync storage by key.
+ * @param key The key to retrieve.
+ * @returns Promise resolving to the stored value or null if not found.
+ */
+export declare function syncStoOpGet<T>(key: string): Promise<T | null>;
+/**
+ * Retrieves all items from sync storage.
+ * @returns Promise resolving to an object containing all storage items.
+ */
+export declare function syncStoOpGetAll<T extends Record<string, unknown>>(): Promise<T>;
+/**
+ * Clears all data from sync storage.
+ */
+export declare function syncStoOpClear(): Promise<void>;
+/**
+ * Queries keys that start with a specific prefix in sync storage.
+ * @param prefix The prefix to filter keys.
+ * @returns Promise resolving to an array of matching keys.
+ */
+export declare function syncStoOpQueryStartWith(prefix: string): Promise<string[]>;
+/**
+ * Sets a value in sync storage.
+ * @param key The key to set.
+ * @param value The value to store. Must be JSON-serializable.
+ */
+export declare function syncStoOpSet<T = unknown>(key: string, value: T): Promise<void>;
+/**
+ * Removes a key from sync storage.
+ * @param key The key to remove.
+ */
+export declare function syncStoOpRem(key: string): Promise<void>;
+/**
+ * Sets a key to null in sync storage.
+ * @param key The key to set to null.
+ */
+export declare function syncStoOpSetNull(key: string): Promise<void>;
 //# sourceMappingURL=opStorage.d.ts.map

package/dist/opStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opStorage.d.ts","sourceRoot":"","sources":["../src/opStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9D;AAED;;;;GAIG;AAEH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKhE;AAED;;;GAGG;AAEH,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ3E;AAED;;;;GAIG;AAGH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}
+{"version":3,"file":"opStorage.d.ts","sourceRoot":"","sources":["../src/opStorage.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9D;AAED;;;;GAIG;AAEH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKhE;AAED;;;GAGG;AAEH,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ3E;AAED;;;;GAIG;AAGH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGlE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKpE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAGrF;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ/E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE"}

package/dist/opStorage.js

@@ -1,3 +1,6 @@
+// ==========================================
+// LOCAL STORAGE OPERATIONS
+// ==========================================
 /**
  * Checks if a key exists in local storage.
  * @param key The key to check.
@@ -83,3 +86,83 @@ export async function stoOpRem(key) {
 export async function stoOpSetNull(key) {
     await stoOpSet(key, null);
 }
+// ==========================================
+// SYNC STORAGE OPERATIONS
+// ==========================================
+/**
+ * Checks if a key exists in sync storage.
+ * @param key The key to check.
+ * @returns Promise resolving to true if key exists, false otherwise.
+ */
+export async function syncStoOpCheck(key) {
+    const result = await browser.storage.sync.get(key);
+    return Object.prototype.hasOwnProperty.call(result, key);
+}
+/**
+ * Retrieves a value from sync storage by key.
+ * @param key The key to retrieve.
+ * @returns Promise resolving to the stored value or null if not found.
+ */
+export async function syncStoOpGet(key) {
+    const result = await browser.storage.sync.get(key);
+    return Object.prototype.hasOwnProperty.call(result, key) ?
+        result[key] :
+        null;
+}
+/**
+ * Retrieves all items from sync storage.
+ * @returns Promise resolving to an object containing all storage items.
+ */
+export async function syncStoOpGetAll() {
+    const result = await browser.storage.sync.get(null);
+    return result;
+}
+/**
+ * Clears all data from sync storage.
+ */
+export async function syncStoOpClear() {
+    await browser.storage.sync.clear();
+}
+/**
+ * Queries keys that start with a specific prefix in sync storage.
+ * @param prefix The prefix to filter keys.
+ * @returns Promise resolving to an array of matching keys.
+ */
+export async function syncStoOpQueryStartWith(prefix) {
+    try {
+        const allItems = await browser.storage.sync.get(null);
+        return Object.keys(allItems).filter((key) => key.startsWith(prefix));
+    }
+    catch (error) {
+        console.error(`syncStoOpQueryStartWith failed. Storage might be too large:`, error);
+        return [];
+    }
+}
+/**
+ * Sets a value in sync storage.
+ * @param key The key to set.
+ * @param value The value to store. Must be JSON-serializable.
+ */
+export async function syncStoOpSet(key, value) {
+    try {
+        await browser.storage.sync.set({ [key]: value });
+    }
+    catch (error) {
+        console.error(`syncStoOpSet failed to write key "${key}". Quota exceeded?`, error);
+        throw error;
+    }
+}
+/**
+ * Removes a key from sync storage.
+ * @param key The key to remove.
+ */
+export async function syncStoOpRem(key) {
+    await browser.storage.sync.remove(key);
+}
+/**
+ * Sets a key to null in sync storage.
+ * @param key The key to set to null.
+ */
+export async function syncStoOpSetNull(key) {
+    await syncStoOpSet(key, null);
+}

package/dist/serviceOperationYTB.d.ts

@@ -21,7 +21,13 @@ export interface VideoInfoBase {
     videolink: string;
     title: string;
 }
-export declare function serviceGetVideoInfoBaseYTB(videolinkOrigin: string, titleOrigin: string): VideoInfoBase | undefined;
+export declare function serviceGetVideoInfoBaseYTB(videolinkOrigin: string, titleOrigin: string, imageQuality: ImageQualityYTB): VideoInfoBase | undefined;
+export declare function serviceGetVideoInfoYTB(videolinkOrigin: string, titleOrigin: string, imageQuality: ImageQualityYTB): VideoInfoYTB | undefined;
+export interface VideoInfoYTB extends VideoInfoBase {
+    filenameVideo: string;
+    filenameImg: string;
+    imageUrl: string;
+}
 /**
  * Extracts video ID and creates a clean YouTube URL.
  * Supports: youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/

package/dist/serviceOperationYTB.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceOperationYTB.d.ts","sourceRoot":"","sources":["../src/serviceOperationYTB.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,aAAa,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,WAAW,GACX,WAAW,GACX,WAAW,CAAA;AAEf,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,eAAe,GAC5B,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,6BAMtF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAmCxF;AAED;;GAEG;AACH,iBAAS,+BAA+B,CAAC,kBAAkB,EAAE,MAAM,GACjE,mBAAmB,GAAG,IAAI,CAqB3B;AAED,eAAe,+BAA+B,CAAA"}
+{"version":3,"file":"serviceOperationYTB.d.ts","sourceRoot":"","sources":["../src/serviceOperationYTB.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,aAAa,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,WAAW,GACX,WAAW,GACX,WAAW,CAAA;AAEf,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,eAAe,GAC5B,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,GAC1E,aAAa,GAAG,SAAS,CAM3B;AAED,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,GAC1E,YAAY,GAAG,SAAS,CAS1B;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAmCxF;AAED;;GAEG;AACH,iBAAS,+BAA+B,CAAC,kBAAkB,EAAE,MAAM,GACjE,mBAAmB,GAAG,IAAI,CAqB3B;AAED,eAAe,+BAA+B,CAAA"}

package/dist/serviceOperationYTB.js

@@ -9,7 +9,7 @@ export function serviceGetImageURLYTB(vid, imageQuality) {
 export function serviceGetVideolinkByVid(vid) {
     return `https://www.youtube.com/watch?v=${vid}`;
 }
-export function serviceGetVideoInfoBaseYTB(videolinkOrigin, titleOrigin) {
+export function serviceGetVideoInfoBaseYTB(videolinkOrigin, titleOrigin, imageQuality) {
     const videolinkYTB = servicePureVideolinkYTB(videolinkOrigin);
     if (!videolinkYTB)
         return;
@@ -17,6 +17,16 @@ export function serviceGetVideoInfoBaseYTB(videolinkOrigin, titleOrigin) {
     const title = serviceRemoveIllegalWord(titleOrigin);
     return { vid, videolink, title };
 }
+export function serviceGetVideoInfoYTB(videolinkOrigin, titleOrigin, imageQuality) {
+    const infoBase = serviceGetVideoInfoBaseYTB(videolinkOrigin, titleOrigin, imageQuality);
+    if (!infoBase)
+        return;
+    const { vid, title } = infoBase;
+    const filenameVideo = `${title}.mp4`;
+    const filenameImg = `${title}.jpg`;
+    const imageUrl = serviceGetImageURLYTB(vid, imageQuality);
+    return { ...infoBase, filenameVideo, filenameImg, imageUrl };
+}
 /**
  * Extracts video ID and creates a clean YouTube URL.
  * Supports: youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0619.1137",
+  "version": "2026.0619.1302",
   "description": "",
   "type": "module",
   "main": "dist/index.js",