@vacantthinker/firefox-addon-framework-easy 2026.611.821 → 2026.611.1153

package/dist/generate.js

@@ -0,0 +1,99 @@
+/**
+ * Common Node.js script template with interactive error handling.
+ */
+function getMkvMergeNodeScript(videoInfo, mkvMergePath, openCommand) {
+    const { vid, videoTitle } = videoInfo;
+    return `
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+const readline = require('readline');
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+// Interactive helper to wait for user input before exiting
+const waitAndExit = (msg, isError = true) => {
+  if (isError) console.error('\\n[ERROR]: ' + msg);
+  else console.log('\\n[INFO]: ' + msg);
+  
+  rl.question('\\nPress Enter to exit...', () => {
+    rl.close();
+    process.exit(isError ? 1 : 0);
+  });
+};
+
+const { vid, videoTitle } = ${JSON.stringify(videoInfo)};
+const pathDownload = __dirname;
+const pathMKVOutput = path.join(pathDownload, \`\${videoTitle}.mkv\`);
+const pathOutput = path.join(pathDownload, \`\${vid}.mkv\`);
+const pathInputAudio = path.join(pathDownload, \`\${vid}.mp3\`);
+const pathInputVideo = path.join(pathDownload, \`\${vid}.mp4\`);
+
+if (fs.existsSync("${mkvMergePath}")) {
+  console.log('Merging: ' + videoTitle);
+
+  const cmd = [
+    '"${mkvMergePath}"',
+    '-o', '"' + pathOutput + '"',
+    '--no-video', '"' + pathInputAudio + '"',
+    '--no-audio', '"' + pathInputVideo + '"'
+  ].join(' ');
+
+  try {
+    execSync(cmd, { stdio: 'inherit' });
+    
+    // Cleanup temporary files
+    if (fs.existsSync(pathInputVideo)) fs.unlinkSync(pathInputVideo);
+    if (fs.existsSync(pathInputAudio)) fs.unlinkSync(pathInputAudio);
+    
+    // Finalize
+    fs.renameSync(pathOutput, pathMKVOutput);
+    
+    console.log('Merge complete.');
+    // Optional: open the file
+    if ("${openCommand}") {
+      execSync(\`\${"${openCommand}"} "\${pathMKVOutput}"\`);
+    }
+    waitAndExit('Process completed successfully.', false);
+  } catch (err) {
+    waitAndExit('Processing failed: ' + err.message);
+  }
+} else {
+  waitAndExit('mkvmerge not found at: ${mkvMergePath}. Please check installation.');
+}
+`;
+}
+/**
+ * Generates an executable script for Windows.
+ */
+export function generateMkvScriptForSystemWindows(videoInfo) {
+    const nodeScript = getMkvMergeNodeScript(videoInfo, 'C:\\Program Files\\MKVToolNix\\mkvmerge.exe', '');
+    return `(function() {
+  const fs = require('fs');
+  ${nodeScript}
+  
+  // Cleanup script file after user presses enter
+  // (Wait for process exit handled inside getMkvMergeNodeScript)
+})();`;
+}
+/**
+ * Generates a bash script for Fedora.
+ */
+export function generateMkvScriptForSystemFedora(videoInfo) {
+    const nodeScript = getMkvMergeNodeScript(videoInfo, '/usr/bin/mkvmerge', 'xdg-open');
+    return `#!/usr/bin/env bash
+
+# Ensure execution in a visible terminal window
+if [ -z "$VTE_VERSION" ] && [ -z "$ALACRITTY_WINDOW_ID" ] && [ -z "$KITTY_WINDOW_ID" ] && [ "$1" != "--child" ]; then
+    gnome-terminal -- "$0" --child
+    exit 0
+fi
+
+# Run Node.js logic
+node << 'EOF'
+${nodeScript}
+EOF
+
+rm -- "$0"
+`;
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './BaseORM';
+export * from './browserDownload';
+export * from './browserNotification';
+export * from './browserRuntime';
+export * from './browserTab';
+export * from './generate';
+export * from './opStorage';
+export * from './opTab';
+export * from './serviceCommon';
+export * from './serviceFetch';
+export * from './serviceGet';
+export * from './serviceOpContent';
+export * from './serviceOpJavascript';
+export * from './servicePure';
+export * from './serviceUpdateTabStyle';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './BaseORM';
+export * from './browserDownload';
+export * from './browserNotification';
+export * from './browserRuntime';
+export * from './browserTab';
+export * from './generate';
+export * from './opStorage';
+export * from './opTab';
+export * from './serviceCommon';
+export * from './serviceFetch';
+export * from './serviceGet';
+export * from './serviceOpContent';
+export * from './serviceOpJavascript';
+export * from './servicePure';
+export * from './serviceUpdateTabStyle';

package/dist/opStorage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Checks if a key exists in local storage.
+ * @param key The key to check.
+ * @returns Promise resolving to true if key exists, false otherwise.
+ */
+export declare function stoOpCheck(key: string): Promise<boolean>;
+/**
+ * Retrieves a value from local storage by key.
+ * @param key The key to retrieve.
+ * @returns Promise resolving to the stored value or null if not found.
+ */
+export declare function stoOpGet<T = any>(key: string): Promise<T | null>;
+/**
+ * Retrieves all items from local storage.
+ * @returns Promise resolving to an object containing all storage items.
+ */
+export declare function stoOpGetAll<T = Record<string, any>>(): Promise<T>;
+/**
+ * Queries keys that start with a specific prefix.
+ * @param prefix The prefix to filter keys.
+ * @returns Promise resolving to an array of matching keys.
+ */
+export declare function stoOpQueryStartWith(prefix: string): Promise<string[]>;
+/**
+ * Sets a value in local storage.
+ * @param key The key to set.
+ * @param value The value to store.
+ */
+export declare function stoOpSet(key: string, value: any): Promise<void>;
+/**
+ * Removes a key from local storage.
+ * @param key The key to remove.
+ */
+export declare function stoOpRem(key: string): Promise<void>;
+/**
+ * Sets a key to null in local storage.
+ * @param key The key to set to null.
+ */
+export declare function stoOpSetNull(key: string): Promise<void>;
+//# sourceMappingURL=opStorage.d.ts.map

package/dist/opStorage.d.ts.map

@@ -0,0 +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,CAG9D;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAGtE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAGvE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG3E;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;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"}

package/dist/opStorage.js

@@ -0,0 +1,57 @@
+/**
+ * Checks if a key exists in local storage.
+ * @param key The key to check.
+ * @returns Promise resolving to true if key exists, false otherwise.
+ */
+export async function stoOpCheck(key) {
+    const result = await browser.storage.local.get(key);
+    return key in result;
+}
+/**
+ * Retrieves a value from local storage by key.
+ * @param key The key to retrieve.
+ * @returns Promise resolving to the stored value or null if not found.
+ */
+export async function stoOpGet(key) {
+    const result = await browser.storage.local.get(key);
+    return result[key] !== undefined ? result[key] : null;
+}
+/**
+ * Retrieves all items from local storage.
+ * @returns Promise resolving to an object containing all storage items.
+ */
+export async function stoOpGetAll() {
+    const result = await browser.storage.local.get();
+    return result;
+}
+/**
+ * Queries keys that start with a specific prefix.
+ * @param prefix The prefix to filter keys.
+ * @returns Promise resolving to an array of matching keys.
+ */
+export async function stoOpQueryStartWith(prefix) {
+    const allItems = await browser.storage.local.get();
+    return Object.keys(allItems).filter((key) => key.startsWith(prefix));
+}
+/**
+ * Sets a value in local storage.
+ * @param key The key to set.
+ * @param value The value to store.
+ */
+export async function stoOpSet(key, value) {
+    await browser.storage.local.set({ [key]: value });
+}
+/**
+ * Removes a key from local storage.
+ * @param key The key to remove.
+ */
+export async function stoOpRem(key) {
+    await browser.storage.local.remove(key);
+}
+/**
+ * Sets a key to null in local storage.
+ * @param key The key to set to null.
+ */
+export async function stoOpSetNull(key) {
+    await stoOpSet(key, null);
+}

package/dist/opTab.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Interface representing a Tab with an explicitly defined tabId.
+ */
+export interface EnhancedTab extends browser.tabs.Tab {
+    tabId: number;
+}
+/**
+ * Enhances a standard tab object by attaching its ID to the 'tabId' property.
+ */
+export declare function tabOpEnhance(tab: browser.tabs.Tab): EnhancedTab | null;
+/**
+ * Creates a standard tab.
+ */
+export declare function tabOpCreate(properties: browser.tabs._CreateCreateProperties): Promise<EnhancedTab>;
+interface TabOpCreateNearOptions {
+    properties: browser.tabs._CreateCreateProperties;
+    previousTabId: number | undefined;
+}
+/**
+ * Creates a new tab positioned immediately after a specified existing tab.
+ */
+export declare function tabOpCreateNear(options: TabOpCreateNearOptions): Promise<EnhancedTab>;
+/**
+ * Creates a tab in the background (inactive and muted).
+ */
+export declare function tabOpCreateActiveFalse(properties: browser.tabs._CreateCreateProperties): Promise<EnhancedTab>;
+/**
+ * Creates a new window and returns its primary tab.
+ */
+export declare function tabOpCreateByWindow(url: string): Promise<EnhancedTab | undefined>;
+/**
+ * Retrieves details about the specified tab.
+ */
+export declare function tabOpGet(tabId: number): Promise<browser.tabs.Tab>;
+/**
+ * Retrieves all tabs across all windows.
+ */
+export declare function tabOpQueryAll(): Promise<browser.tabs.Tab[]>;
+/**
+ * Retrieves an array of tab IDs matching the URL pattern.
+ */
+export declare function tabOpQueryUrl(urlQuery: string): Promise<number[]>;
+/**
+ * Finds all tabs matching the URL pattern and removes them simultaneously.
+ */
+export declare function tabOpQueryUrlThenRemove(urlQuery: string): Promise<void>;
+/**
+ * Reloads the given tab.
+ * @param tabId The tab ID to reload.
+ * @param bypassCache Whether to bypass the cache.
+ */
+export declare function tabOpReload(tabId: number, bypassCache?: boolean): Promise<void>;
+/**
+ * Closes one or more tabs.
+ */
+export declare function tabOpRemove(tabId: number | number[]): Promise<void>;
+/**
+ * Hides one or more tabs.
+ */
+export declare function tabOpHide(tabId: number | number[]): Promise<number[]>;
+/**
+ * Modifies the properties of a tab.
+ */
+export declare function tabOpUpdate(tabId: number, updateProperties: browser.tabs._UpdateUpdateProperties): Promise<EnhancedTab>;
+/**
+ * Updates a tab to be inactive and muted.
+ */
+export declare function tabOpUpdateActiveFalse(tabId: number): Promise<EnhancedTab>;
+/**
+ * Focuses the window containing the tab, then highlights and activates the tab.
+ */
+export declare function tabOpFocus(tabId: number): Promise<EnhancedTab>;
+/**
+ * Injects CSS code into a page.
+ */
+export declare function tabOpInsertCssCode(tabId: number, code: string): Promise<void>;
+/**
+ * Removes CSS code that was previously injected into a page.
+ */
+export declare function tabOpRemoveCssCode(tabId: number, code: string): Promise<void>;
+export {};
+//# sourceMappingURL=opTab.d.ts.map

package/dist/opTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opTab.d.ts","sourceRoot":"","sources":["../src/opTab.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,IAAI,CAAC,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,WAAW,GAAG,IAAI,CAGtE;AAsBD;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAExG;AAED,UAAU,sBAAsB;IAC9B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC;IACjD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAc3F;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAMnH;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAIvF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAEjE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GACrD,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF"}

package/dist/opTab.js

@@ -0,0 +1,152 @@
+/**
+ * Enhances a standard tab object by attaching its ID to the 'tabId' property.
+ */
+export function tabOpEnhance(tab) {
+    if (!tab || typeof tab.id !== 'number')
+        return null;
+    return { ...tab, tabId: tab.id };
+}
+/**
+ * Internal helper to unify tab creation.
+ */
+async function _create(properties) {
+    const tab = await browser.tabs.create(properties);
+    const enhanced = tabOpEnhance(tab);
+    if (!enhanced)
+        throw new Error('Failed to enhance created tab: tabId is missing.');
+    return enhanced;
+}
+/**
+ * Internal helper to unify tab updates.
+ */
+async function _update(tabId, properties) {
+    const tab = await browser.tabs.update(tabId, properties);
+    const enhanced = tabOpEnhance(tab);
+    if (!enhanced)
+        throw new Error(`Failed to enhance updated tab ${tabId}`);
+    return enhanced;
+}
+/**
+ * Creates a standard tab.
+ */
+export async function tabOpCreate(properties) {
+    return _create(properties);
+}
+/**
+ * Creates a new tab positioned immediately after a specified existing tab.
+ */
+export async function tabOpCreateNear(options) {
+    const { properties, previousTabId } = options;
+    if (previousTabId !== undefined) {
+        try {
+            const previousTab = await tabOpGet(previousTabId);
+            properties.index = previousTab.index + 1;
+            properties.openerTabId = previousTab.id;
+        }
+        catch {
+            // Ignore if source tab is invalid
+        }
+    }
+    return _create(properties);
+}
+/**
+ * Creates a tab in the background (inactive and muted).
+ */
+export async function tabOpCreateActiveFalse(properties) {
+    return _create({
+        ...properties,
+        active: false,
+        muted: true,
+    });
+}
+/**
+ * Creates a new window and returns its primary tab.
+ */
+export async function tabOpCreateByWindow(url) {
+    const window = await browser.windows.create({ url });
+    const tab = window.tabs?.[0];
+    return tab ? tabOpEnhance(tab) ?? undefined : undefined;
+}
+/**
+ * Retrieves details about the specified tab.
+ */
+export async function tabOpGet(tabId) {
+    return await browser.tabs.get(tabId);
+}
+/**
+ * Retrieves all tabs across all windows.
+ */
+export async function tabOpQueryAll() {
+    return await browser.tabs.query({});
+}
+/**
+ * Retrieves an array of tab IDs matching the URL pattern.
+ */
+export async function tabOpQueryUrl(urlQuery) {
+    const tabs = await browser.tabs.query({ url: urlQuery });
+    return tabs.filter((t) => typeof t.id === 'number').map((t) => t.id);
+}
+/**
+ * Finds all tabs matching the URL pattern and removes them simultaneously.
+ */
+export async function tabOpQueryUrlThenRemove(urlQuery) {
+    const ids = await tabOpQueryUrl(urlQuery);
+    if (ids.length > 0) {
+        await browser.tabs.remove(ids);
+    }
+}
+/**
+ * Reloads the given tab.
+ * @param tabId The tab ID to reload.
+ * @param bypassCache Whether to bypass the cache.
+ */
+export async function tabOpReload(tabId, bypassCache = false) {
+    await browser.tabs.reload(tabId, { bypassCache });
+}
+/**
+ * Closes one or more tabs.
+ */
+export async function tabOpRemove(tabId) {
+    await browser.tabs.remove(tabId);
+}
+/**
+ * Hides one or more tabs.
+ */
+export async function tabOpHide(tabId) {
+    return await browser.tabs.hide(tabId);
+}
+/**
+ * Modifies the properties of a tab.
+ */
+export async function tabOpUpdate(tabId, updateProperties) {
+    return _update(tabId, updateProperties);
+}
+/**
+ * Updates a tab to be inactive and muted.
+ */
+export async function tabOpUpdateActiveFalse(tabId) {
+    return _update(tabId, { active: false, muted: true });
+}
+/**
+ * Focuses the window containing the tab, then highlights and activates the tab.
+ */
+export async function tabOpFocus(tabId) {
+    const tab = await browser.tabs.get(tabId);
+    if (!tab || typeof tab.windowId !== 'number') {
+        throw new Error(`Tab ${tabId} not found or has no window.`);
+    }
+    await browser.windows.update(tab.windowId, { focused: true });
+    return _update(tabId, { active: true, highlighted: true });
+}
+/**
+ * Injects CSS code into a page.
+ */
+export async function tabOpInsertCssCode(tabId, code) {
+    await browser.tabs.insertCSS(tabId, { code });
+}
+/**
+ * Removes CSS code that was previously injected into a page.
+ */
+export async function tabOpRemoveCssCode(tabId, code) {
+    await browser.tabs.removeCSS(tabId, { code });
+}

package/dist/serviceCommon.d.ts

@@ -0,0 +1,8 @@
+import { DownloadParams } from './browserDownload';
+/**
+ * Service to handle download operations.
+ * Attempts a full download with filename; if it fails, retries with downlink only.
+ * * @param params The download parameters.
+ */
+export declare function serviceDownloadByDownlink(params: DownloadParams): Promise<void>;
+//# sourceMappingURL=serviceCommon.d.ts.map

package/dist/serviceCommon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceCommon.d.ts","sourceRoot":"","sources":["../src/serviceCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAI5E;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrF"}

package/dist/serviceCommon.js

@@ -0,0 +1,21 @@
+import { browserDownloadByDownlink } from './browserDownload';
+import { browserNotificationCreate } from './browserNotification';
+/**
+ * Service to handle download operations.
+ * Attempts a full download with filename; if it fails, retries with downlink only.
+ * * @param params The download parameters.
+ */
+export async function serviceDownloadByDownlink(params) {
+    const { filename, downlink } = params;
+    try {
+        // Attempt 1: Full download with provided parameters
+        await browserDownloadByDownlink(params);
+        await browserNotificationCreate(`downloading! ${filename ?? 'file'}`);
+    }
+    catch (error) {
+        // Notify about the failure
+        await browserNotificationCreate(`reason=${error}`);
+        // Attempt 2: Fallback retry using only the downlink
+        await browserDownloadByDownlink({ downlink });
+    }
+}

package/dist/serviceFetch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Interface representing the structure of an Aria2 request.
+ */
+export interface Aria2Request {
+    downlink: string;
+    filename?: string | null;
+    rpcSecret: string;
+    rpcPort: string;
+}
+/**
+ * Generic service to perform POST requests with JSON content.
+ * @param url The target URL.
+ * @param body The request payload.
+ * @returns Promise<Response>
+ */
+export declare function servicePostJson(url: string, body: any): Promise<Response>;
+/**
+ * Service to send download data to a local Aria2 instance via JSON-RPC.
+ * @param request The Aria2 request parameters.
+ * @returns Promise<Response>
+ */
+export declare function serviceSendDataToLocalAria2(request: Aria2Request): Promise<Response>;
+//# sourceMappingURL=serviceFetch.d.ts.map

package/dist/serviceFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceFetch.d.ts","sourceRoot":"","sources":["../src/serviceFetch.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAS/E;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoB1F"}

package/dist/serviceFetch.js

@@ -0,0 +1,38 @@
+/**
+ * Generic service to perform POST requests with JSON content.
+ * @param url The target URL.
+ * @param body The request payload.
+ * @returns Promise<Response>
+ */
+export async function servicePostJson(url, body) {
+    return await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json;charset=UTF-8',
+            'Accept': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+}
+/**
+ * Service to send download data to a local Aria2 instance via JSON-RPC.
+ * @param request The Aria2 request parameters.
+ * @returns Promise<Response>
+ */
+export async function serviceSendDataToLocalAria2(request) {
+    const { downlink, filename, rpcSecret, rpcPort } = request;
+    // Construct JSON-RPC parameters
+    const params = [`token:${rpcSecret}`, [downlink]];
+    if (filename) {
+        params.push({ out: filename });
+    }
+    // Construct JSON-RPC payload
+    const payload = {
+        jsonrpc: '2.0',
+        id: 'aria2-service',
+        method: 'aria2.addUri',
+        params,
+    };
+    const url = `http://localhost:${rpcPort}/jsonrpc`;
+    return await servicePostJson(url, payload);
+}

package/dist/serviceGet.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extracts the hostname from a given URL string.
+ * @param url The full URL string.
+ * @returns The domain/hostname.
+ */
+export declare function serviceGetDomainByUrl(url: string): string;
+/**
+ * Generates a timestamp string in the format: YYYY_M_D_Hh_Mm_Ss_ms
+ * e.g., 2026_6_11_10h_30m_15s_450
+ * @returns The formatted timestamp string.
+ */
+export declare function serviceGetCurrentDateYYYYMMDDHHMMSS(): string;
+//# sourceMappingURL=serviceGet.d.ts.map

package/dist/serviceGet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceGet.d.ts","sourceRoot":"","sources":["../src/serviceGet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAY5D"}

package/dist/serviceGet.js

@@ -0,0 +1,24 @@
+/**
+ * Extracts the hostname from a given URL string.
+ * @param url The full URL string.
+ * @returns The domain/hostname.
+ */
+export function serviceGetDomainByUrl(url) {
+    return new URL(url).hostname;
+}
+/**
+ * Generates a timestamp string in the format: YYYY_M_D_Hh_Mm_Ss_ms
+ * e.g., 2026_6_11_10h_30m_15s_450
+ * @returns The formatted timestamp string.
+ */
+export function serviceGetCurrentDateYYYYMMDDHHMMSS() {
+    const date = new Date();
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
+    const hours = date.getHours();
+    const minutes = date.getMinutes();
+    const seconds = date.getSeconds();
+    const milliseconds = date.getMilliseconds();
+    return `${year}_${month}_${day}_${hours}h_${minutes}m_${seconds}s_${milliseconds}`;
+}

package/dist/serviceOpContent.d.ts

@@ -0,0 +1,24 @@
+import { VideoInfo } from './generate';
+/**
+ * Copies text content to the system clipboard.
+ */
+export declare function serviceCopyContentToClipboard(data: string): Promise<void>;
+/**
+ * Saves content to a local file.
+ * @param content The content string.
+ * @param filename The base filename.
+ * @param ext The file extension.
+ */
+export declare function serviceSaveContentToLocal(content: string, filename: string, ext?: string): void;
+/**
+ * Generates an MKVToolNix script based on the current OS.
+ * @param videoInfo - The object containing vid and videoTitle.
+ */
+export declare function serviceGenerateMkvToolNixScript(videoInfo: VideoInfo): Promise<void>;
+/**
+ * Cleans a string to make it a valid filename.
+ * @param value The raw string.
+ * @returns A cleaned filename string.
+ */
+export declare function serviceRemoveIllegalWord(value: string): string;
+//# sourceMappingURL=serviceOpContent.d.ts.map

package/dist/serviceOpContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceOpContent.d.ts","sourceRoot":"","sources":["../src/serviceOpContent.ts"],"names":[],"mappings":"AACA,OAAO,EAE8B,SAAS,EAC7C,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAc,GAAG,IAAI,CActG;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB9D"}