@ohos-ports/parcel-watcher-linux-arm-glibc 2.6.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-present Devon Govett
+
+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

@@ -0,0 +1,42 @@
+# @ohos-ports/parcel-watcher-linux-arm-glibc
+
+OpenHarmony (arm64) port of the `@parcel/watcher-linux-arm-glibc@2.6.0` platform-specific
+native addon from [parcel-bundler/watcher](https://github.com/parcel-bundler/watcher).
+
+The original package ships only a prebuilt 32-bit ARM glibc `watcher.node`, which cannot be
+loaded by the 64-bit arm64 OpenHarmony (musl) Node.js runtime. This port replaces it with a
+`watcher.node` compiled from the upstream v2.6.0 source (Rust/C++ napi addon, inotify backend)
+using the OHOS SDK `aarch64-unknown-linux-ohos` clang toolchain via node-gyp.
+
+## Usage
+
+This is a platform-specific binary package consumed by `@parcel/watcher`'s optional dependency
+resolution. It can also be loaded directly:
+
+```js
+const watcher = require('@ohos-ports/parcel-watcher-linux-arm-glibc');
+await watcher.writeSnapshot('/some/dir', '/tmp/snapshot.bin');
+const events = await watcher.getEventsSince('/some/dir', '/tmp/snapshot.bin');
+const subscription = await watcher.subscribe('/some/dir', (err, events) => { ... });
+await subscription.unsubscribe();
+```
+
+Notes for OpenHarmony:
+- No JS wrapper is shipped (like upstream); `subscribe(dir, cb)` works without an `opts` object.
+- The Watchman backend is unavailable (watchman does not exist on OpenHarmony); the default
+  inotify backend is used.
+
+## Build
+
+Rebuilt natively on OpenHarmony: symbol visibility hidden + linker version script
+(`local.map`) statically binding libc++abi/libunwind from the OHOS NDK, avoiding the
+mixed-unwinder crash caused by harmonybrew node's own statically-linked libc++abi.
+Binary signed with `binary-sign-tool` (selfSign, SHA256withECDSA). All 8 functional
+tests passed (subscribe/unsubscribe inotify events, writeSnapshot, getEventsSince,
+ignorePaths, error paths).
+
+See https://github.com/ohos-ports/ohos-ports/tree/main/ports for build scripts and patches.
+
+## License
+
+MIT (upstream parcel-bundler/watcher)

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@ohos-ports/parcel-watcher-linux-arm-glibc",
+  "version": "2.6.0-beta.0",
+  "main": "watcher.node",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ohos-ports/ohos-ports.git",
+    "directory": "ports/@parcel/watcher-linux-arm-glibc/2.6.0"
+  },
+  "description": "A native C++ Node module for querying and subscribing to filesystem events. Used by Parcel 2.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "watcher.node",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">= 10.0.0"
+  },
+  "os": [
+    "openharmony"
+  ],
+  "cpu": [
+    "arm64"
+  ]
+}