@crossbind/extension-power 0.0.0-bootstrap.0 → 2.0.0-beta.69

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Buğra Sarı and crossbind contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,24 @@
 # @crossbind/extension-power
 
-This version, 0.0.0-bootstrap.0, holds no code. npm lets a trusted publisher be configured only for a
-package that exists, so it reserves the name for the crossbind release workflow.
+Tells a desktop page when the system sleeps and wakes.
 
-Install the real package: `npm install @crossbind/extension-power@beta`. Source: https://github.com/crossbind/crossbind
+An app has it by having `@crossbind/core-app-host`, which lists it as a dependency: there is nothing to install or list.
+
+## Use
+
+```js
+import { events } from 'crossbind/app';
+
+events.on('suspend', () => saveDraft());
+events.on('resume', () => reconnect());
+```
+
+## Platforms
+
+macOS, Linux and Windows, from the time the app's first window opens.
+
+## Replace or leave out
+
+It holds the role `power`. An extension that gives `replaces: 'power'` takes it; `app: { without: ['power'] }` in `crossbind.config.js` leaves it out. [The guide](https://crossbind.dev/guide/extensions/#replace) shows how, and [extensions.md](https://github.com/crossbind/crossbind/blob/main/docs/api/extensions.md#the-hosts-own-extensions) what a replacement answers.
+
+[app.md](https://github.com/crossbind/crossbind/blob/main/docs/api/app.md#events-and-callbacks) has the app's other events.

package/crossbind.extension.js

@@ -0,0 +1,12 @@
+export default function power() {
+    return {
+        name: 'power',
+        contract: 1,
+        root: import.meta.dirname,
+        app: {
+            macos: { sources: ['native/power.cpp', 'native/darwin.mm'] },
+            linux: { sources: ['native/power.cpp', 'native/linux.cpp'] },
+            windows: { sources: ['native/power.cpp', 'native/windows.cpp'], libraries: ['comctl32'] },
+        },
+    };
+}

package/native/darwin.mm

@@ -0,0 +1,21 @@
+#import <Cocoa/Cocoa.h>
+
+#include "power.h"
+
+#include "crossbind/app.h"
+
+void crossbind::power::listen() {
+    NSNotificationCenter *center = NSWorkspace.sharedWorkspace.notificationCenter;
+    [center addObserverForName:NSWorkspaceWillSleepNotification
+                        object:nil
+                         queue:nil
+                    usingBlock:^(NSNotification *) {
+                      crossbind::app::emitEvent("suspend");
+                    }];
+    [center addObserverForName:NSWorkspaceDidWakeNotification
+                        object:nil
+                         queue:nil
+                    usingBlock:^(NSNotification *) {
+                      crossbind::app::emitEvent("resume");
+                    }];
+}

package/native/linux.cpp

@@ -0,0 +1,22 @@
+#include "power.h"
+
+#include "crossbind/app.h"
+
+#include <gio/gio.h>
+
+// logind says the system goes to sleep and wakes over the system bus, which a container may not have. It sleeps without
+// waiting for the page.
+void crossbind::power::listen() {
+    GDBusConnection *bus = g_bus_get_sync(G_BUS_TYPE_SYSTEM, nullptr, nullptr);
+    if (!bus) return;
+    // GDBus ends the app by default when the bus goes away.
+    g_dbus_connection_set_exit_on_close(bus, FALSE);
+    g_dbus_connection_signal_subscribe(
+        bus, "org.freedesktop.login1", "org.freedesktop.login1.Manager", "PrepareForSleep", "/org/freedesktop/login1", nullptr, G_DBUS_SIGNAL_FLAGS_NONE,
+        +[](GDBusConnection *, const gchar *, const gchar *, const gchar *, const gchar *, GVariant *parameters, gpointer) {
+            gboolean isSleeping = FALSE;
+            g_variant_get(parameters, "(b)", &isSleeping);
+            crossbind::app::emitEvent(isSleeping ? "suspend" : "resume");
+        },
+        nullptr, nullptr);
+}

package/native/power.cpp

@@ -0,0 +1,15 @@
+// The system's sleep and waking, which a desktop app's pages hear of as the events suspend and resume: each platform
+// hears of them its own way, once, from the time the app's first window opens.
+#include "power.h"
+
+#include <utility>
+
+void crossbind_extension_power(crossbind::Registry &registry) {
+    registry.onWindow([](const crossbind::Window &) {
+        static bool isListening = false;
+        if (!std::exchange(isListening, true)) crossbind::power::listen();
+    });
+#ifdef _WIN32
+    registry.onWindowClosed([](const crossbind::Window &window) { crossbind::power::windowClosed(window.native()); });
+#endif
+}

package/native/power.h

@@ -0,0 +1,17 @@
+#pragma once
+
+// What each desktop platform does to tell the page when the system goes to sleep and when it wakes, as the events suspend
+// and resume.
+#include "crossbind/extension.h"
+
+namespace crossbind::power {
+
+// Starts hearing of them, on the main thread once the app's first window has opened.
+void listen();
+
+#ifdef _WIN32
+// The window that hears of them for the app closed, on the main thread: the oldest left hears of them from now on.
+void windowClosed(void *window);
+#endif
+
+}  // namespace crossbind::power

package/native/windows.cpp

@@ -0,0 +1,45 @@
+#include "power.h"
+
+#include "crossbind/app.h"
+
+#include <windows.h>
+
+#include <commctrl.h>
+
+#include <cstdio>
+
+namespace crossbind::power {
+namespace {
+
+constexpr UINT_PTR SUBCLASS = 1;
+
+// Windows tells the app's windows the system goes to sleep and wakes; one with Modern Standby may tell neither.
+LRESULT CALLBACK powerProcedure(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam, UINT_PTR, DWORD_PTR) {
+    if (message == WM_POWERBROADCAST && (wParam == PBT_APMSUSPEND || wParam == PBT_APMRESUMEAUTOMATIC)) {
+        crossbind::app::emitEvent(wParam == PBT_APMSUSPEND ? "suspend" : "resume");
+    }
+    return DefSubclassProc(hwnd, message, wParam, lParam);
+}
+
+// The one window that hears of them, as each of the app's would.
+HWND listener = nullptr;
+
+void listenOn(HWND window) {
+    listener = nullptr;
+    if (!window) return;
+    if (!SetWindowSubclass(window, powerProcedure, SUBCLASS, 0)) {
+        std::fprintf(stderr, "crossbind: the app cannot hear of the system's sleep: Windows error %lu\n", GetLastError());
+        return;
+    }
+    listener = window;
+}
+
+}  // namespace
+
+void listen() { listenOn(static_cast<HWND>(appWindow())); }
+
+void windowClosed(void *window) {
+    if (window == listener) listenOn(static_cast<HWND>(appWindow()));
+}
+
+}  // namespace crossbind::power

package/package.json

@@ -1,7 +1,39 @@
 {
-    "name": "@crossbind/extension-power",
-    "version": "0.0.0-bootstrap.0",
-    "description": "Placeholder that let npm trust the crossbind release workflow; install @crossbind/extension-power@beta.",
-    "license": "MIT",
-    "repository": "https://github.com/crossbind/crossbind.git"
-}
+  "name": "@crossbind/extension-power",
+  "version": "2.0.0-beta.69",
+  "description": "crossbind app extension: tells a desktop page when the system sleeps and wakes.",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/extensions/power#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crossbind/crossbind.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "./page": {
+      "types": "./page.d.ts"
+    },
+    "./crossbind.extension.js": "./crossbind.extension.js"
+  },
+  "files": [
+    "crossbind.extension.js",
+    "native",
+    "page.d.ts"
+  ],
+  "crossbind": {
+    "extension": "./crossbind.extension.js"
+  },
+  "peerDependencies": {
+    "crossbind": "^2.0.0-beta.69"
+  },
+  "devDependencies": {
+    "crossbind": "^2.0.0-beta.69"
+  },
+  "keywords": [
+    "crossbind-extension",
+    "crossbind",
+    "system",
+    "power",
+    "app"
+  ]
+}

package/page.d.ts

@@ -0,0 +1,10 @@
+export {};
+
+declare module 'crossbind/app/core' {
+    interface AppEvents {
+        /** Calls listener as the system of a desktop app goes to sleep, which it may do before the page has run, until the function it returns is called. */
+        suspend: void;
+        /** Calls listener as the system of a desktop app wakes from sleep, until the function it returns is called. */
+        resume: void;
+    }
+}