@vacantthinker/firefox-addon-framework-easy 2026.630.1239 → 2026.630.2330

package/dist/backgroundJs.d.ts

@@ -9,4 +9,16 @@ export declare function bkJsCreateActionBaseHandlers<T extends string = MessageA
  * Dispatcher also accepts the generic map
  */
 export declare function bkJsRegisterRuntimeActionDispatcher<T extends string>(handlersMap: Map<T, ActHandlerFunc>, logTag?: string): void;
+export type AlarmHandlerFunc = (alarm: browser.alarms.Alarm) => Promise<void>;
+/**
+ * Uses <T extends string> so the app can pass its own union type.
+ * It defaults to FrameworkBaseAction if no type is passed.
+ */
+export declare function bkJsCreateAlarmBaseHandlers<T extends string>(): Map<T, AlarmHandlerFunc>;
+/**
+ * Dispatcher also accepts the generic map
+ */
+export declare function bkJsRegisterAlarmDispatcher<T extends string>(handlersMap: Map<T, AlarmHandlerFunc>, logTag?: string): void;
+export type AlarmSetupFunc = (name: string) => Promise<browser.alarms._CreateAlarmInfo | void>;
+export declare function bkJsCreateAlarmSetupMap<T extends string>(): Map<T, AlarmSetupFunc>;
 //# sourceMappingURL=backgroundJs.d.ts.map

package/dist/backgroundJs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundJs.d.ts","sourceRoot":"","sources":["../src/backgroundJs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,wBAAwB,EAA6B,MAAM,SAAS,CAAC;AAI7E,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,GAAG,EACT,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,CAAC,SAAS,MAAM,GAAG,wBAAwB,KACzC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAmCzB;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,CAAC,SAAS,MAAM,EAClE,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,EACnC,MAAM,GAAE,MAAyB,QAyBlC"}
+{"version":3,"file":"backgroundJs.d.ts","sourceRoot":"","sources":["../src/backgroundJs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,wBAAwB,EAA6B,MAAM,SAAS,CAAC;AAI7E,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,GAAG,EACT,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,CAAC,SAAS,MAAM,GAAG,wBAAwB,KACzC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAmCzB;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,CAAC,SAAS,MAAM,EAClE,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,EACnC,MAAM,GAAE,MAAyB,QAyBlC;AAOD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,CAAC,SAAS,MAAM,KACd,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAG3B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAC1D,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,EACrC,MAAM,GAAE,MAA2B,QAapC;AAKD,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAErD,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAuBlF"}

package/dist/backgroundJs.js

@@ -70,3 +70,45 @@ export function bkJsRegisterRuntimeActionDispatcher(handlersMap, logTag = "backg
         }
     });
 }
+/**
+ * Uses <T extends string> so the app can pass its own union type.
+ * It defaults to FrameworkBaseAction if no type is passed.
+ */
+export function bkJsCreateAlarmBaseHandlers() {
+    const map = new Map();
+    return map;
+}
+/**
+ * Dispatcher also accepts the generic map
+ */
+export function bkJsRegisterAlarmDispatcher(handlersMap, logTag = "initialAlarm.ts ") {
+    browser.alarms.onAlarm.addListener(async (alarm) => {
+        const { name } = alarm;
+        const handler = handlersMap.get(name);
+        console.info(logTag, "name=", name, " triggered");
+        if (handler) {
+            await handler(alarm);
+        }
+        else {
+            console.info(logTag, "name=", name, " not match!");
+        }
+    });
+}
+export function bkJsCreateAlarmSetupMap() {
+    const map = new Map();
+    const originalSet = map.set.bind(map);
+    map.set = (key, originalFunc) => {
+        // 2. Wrap the function to intercept its return value
+        const wrappedFunc = async (name) => {
+            // Execute the user's complex logic to get the alarm info
+            const alarmInfo = await originalFunc(name);
+            // 3. Auto-inject the creation logic ONLY if they returned valid info
+            if (alarmInfo) {
+                await browser.alarms.create(name, alarmInfo);
+                console.info(`[Framework] Auto-created alarm: ${name}`);
+            }
+        };
+        return originalSet(key, wrappedFunc);
+    };
+    return map;
+}

package/package.json

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