@auv-js/cli 0.0.24 → 0.0.27

package/README.md

@@ -83,6 +83,35 @@ entrypoint at runtime, keep `*.node` files outside the ASAR with the packager's
 native-module/`asarUnpack` support. Keep the SDK independent of packaging policy
 so browser and remote-client consumers do not install a native executable.
 
+### Shipping your own macOS helper
+
+An application may ship the macOS helper under its own name, icon, bundle
+identifier, and Developer ID team instead of the official `AUV Helper`. Build
+it with `crates/auv-device-helper-macos/package/package.sh` and its
+`AUV_MACOS_HELPER_*` overrides, notarize and staple it, and embed the unpacked
+app in the application bundle without re-signing it (for example
+`YourApp.app/Contents/Library/Helpers/`). Pass that absolute path to both the
+daemon and setup:
+
+```ts
+import path from 'node:path'
+import process from 'node:process'
+
+import { installMacosHelper } from '@auv-js/cli'
+import { startAuv } from '@auv-js/sdk/node'
+
+const helperApp = path.join(process.resourcesPath, '..', 'Library', 'Helpers', 'Your Computer Use.app')
+
+const status = await installMacosHelper({ helperApp })
+const daemon = await startAuv({ binaryPath, platforms: { macos: { helperApp } } })
+```
+
+AUV reads the bundle identifier and Team ID from that app's signature, installs
+a copy under `~/Library/Application Support/<bundle identifier>/`, and the
+daemon trusts only that identity. The CLI equivalent is
+`auv setup macos-helper install --helper-app <path>`. See the
+[helper setup reference](../../../docs/ai/references/session-api/2026-10-01-macos-helper-setup.md#shipped-helper-identity).
+
 Supported packages currently cover macOS arm64/x64, glibc Linux arm64/x64, and
-Windows x64. Installing with optional dependencies disabled leaves no binary;
-`binaryPath()` reports that case with an actionable error.
+Windows arm64/x64. Installing with optional dependencies disabled leaves no
+binary; `binaryPath()` reports that case with an actionable error.

package/binding.d.ts

@@ -1,12 +1,24 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
 /**
- * Install and register the signed AUV Helper embedded in this build.
+ * Install and register the signed AUV Helper embedded in this build, or
+ * `helperApp` when the embedding application ships its own helper.
  *
  * The work runs off the JavaScript thread because archive verification and
  * ServiceManagement registration perform blocking platform calls.
  */
-export declare function installMacosHelper(): Promise<MacosHelperStatus>
+export declare function installMacosHelper(options?: MacosHelperOptions | undefined | null): Promise<MacosHelperStatus>
+
+/** Which helper app setup manages. */
+export interface MacosHelperOptions {
+  /**
+   * Absolute path of the unpacked, notarized helper app shipped by the
+   * application embedding AUV. Omit it to manage the official AUV Helper
+   * embedded in release builds. Pass the same path to `startAuv({ platforms:
+   * { macos: { helperApp } } })` so the daemon trusts that helper.
+   */
+  helperApp?: string
+}
 
 /**
  * Inspect the AUV Helper installation used for locked macOS sessions.
@@ -14,11 +26,15 @@ export declare function installMacosHelper(): Promise<MacosHelperStatus>
  * Signature validation and ServiceManagement inspection run off the
  * JavaScript thread because they perform blocking platform calls.
  */
-export declare function macosHelperStatus(): Promise<MacosHelperStatus>
+export declare function macosHelperStatus(options?: MacosHelperOptions | undefined | null): Promise<MacosHelperStatus>
 
 export interface MacosHelperStatus {
   state: string
   detail?: string
+  /**
+   * Whether this binding can install a helper: one embedded by a release
+   * build, or `helperApp`.
+   */
   helperEmbedded: boolean
 }
 
@@ -34,7 +50,7 @@ export declare function nativePackageVersion(): string
 export declare function openMacosHelperAccessibilitySettings(): void
 
 /** Open System Settings at General > Login Items & Extensions. */
-export declare function openMacosHelperBackgroundItemsSettings(): void
+export declare function openMacosHelperBackgroundItemsSettings(options?: MacosHelperOptions | undefined | null): void
 
 /**
  * Unregister the helper, reset its Accessibility decision, and remove its app.
@@ -43,4 +59,4 @@ export declare function openMacosHelperBackgroundItemsSettings(): void
  * the JavaScript thread because it waits for ServiceManagement termination and
  * performs filesystem and TCC operations.
  */
-export declare function uninstallMacosHelper(): Promise<MacosHelperStatus>
+export declare function uninstallMacosHelper(options?: MacosHelperOptions | undefined | null): Promise<MacosHelperStatus>

package/dist/binary.js

@@ -9,6 +9,7 @@ const PLATFORM_PACKAGES = /* @__PURE__ */ new Map([
 	["darwin-x64", ["@auv-js/cli-darwin-x64", "bin/auv"]],
 	["linux-arm64", ["@auv-js/cli-linux-arm64-gnu", "bin/auv"]],
 	["linux-x64", ["@auv-js/cli-linux-x64-gnu", "bin/auv"]],
+	["win32-arm64", ["@auv-js/cli-win32-arm64-msvc", "bin/auv.exe"]],
 	["win32-x64", ["@auv-js/cli-win32-x64-msvc", "bin/auv.exe"]]
 ]);
 var AuvBinaryError = class extends Error {

package/dist/binary.js.map

@@ -1 +1 @@
-{"version":3,"file":"binary.js","names":[],"sources":["../src-js/binary.ts"],"sourcesContent":["import process from 'node:process'\n\nimport { accessSync, constants } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, join } from 'node:path'\n\nconst require = createRequire(import.meta.url)\n\nconst PLATFORM_PACKAGES = new Map<string, readonly [string, string]>([\n  ['darwin-arm64', ['@auv-js/cli-darwin-arm64', 'bin/auv']],\n  ['darwin-x64', ['@auv-js/cli-darwin-x64', 'bin/auv']],\n  ['linux-arm64', ['@auv-js/cli-linux-arm64-gnu', 'bin/auv']],\n  ['linux-x64', ['@auv-js/cli-linux-x64-gnu', 'bin/auv']],\n  ['win32-x64', ['@auv-js/cli-win32-x64-msvc', 'bin/auv.exe']],\n])\n\ninterface DiagnosticReport {\n  header?: {\n    glibcVersionRuntime?: string\n  }\n}\n\nexport class AuvBinaryError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'AuvBinaryError'\n  }\n}\n\n/** Return the absolute path of the AUV executable installed for this host. */\nexport function binaryPath(): string {\n  const platformKey = `${process.platform}-${process.arch}`\n\n  const platformPackage = PLATFORM_PACKAGES.get(platformKey)\n  if (!platformPackage) {\n    throw new AuvBinaryError(`AUV does not publish an executable for ${process.platform}/${process.arch}.`)\n  }\n  if (process.platform === 'linux' && isMusl()) {\n    throw new AuvBinaryError('AUV currently publishes glibc Linux executables only; musl Linux is not supported.')\n  }\n\n  const [packageName, executable] = platformPackage\n  let manifestPath: string\n\n  try {\n    manifestPath = require.resolve(`${packageName}/package.json`)\n  }\n  catch (cause) {\n    throw new AuvBinaryError(`The optional package ${packageName} is missing. Reinstall @auv-js/cli without omitting optional dependencies.`, { cause })\n  }\n\n  const resolvedPath = join(dirname(manifestPath), executable)\n  try {\n    accessSync(resolvedPath, process.platform === 'win32' ? constants.F_OK : constants.X_OK)\n  }\n  catch (cause) {\n    throw new AuvBinaryError(`The ${packageName} package does not contain an executable AUV binary at ${resolvedPath}.`, { cause })\n  }\n\n  return resolvedPath\n}\n\nfunction isMusl(): boolean {\n  const report = process.report?.getReport?.() as DiagnosticReport | undefined\n  return report?.header?.glibcVersionRuntime === undefined\n}\n"],"mappings":";;;;;AAMA,MAAM,UAAU,cAAc,OAAO,KAAK,GAAG;AAE7C,MAAM,oCAAoB,IAAI,IAAuC;CACnE,CAAC,gBAAgB,CAAC,4BAA4B,SAAS,CAAC;CACxD,CAAC,cAAc,CAAC,0BAA0B,SAAS,CAAC;CACpD,CAAC,eAAe,CAAC,+BAA+B,SAAS,CAAC;CAC1D,CAAC,aAAa,CAAC,6BAA6B,SAAS,CAAC;CACtD,CAAC,aAAa,CAAC,8BAA8B,aAAa,CAAC;AAC7D,CAAC;AAQD,IAAa,iBAAb,cAAoC,MAAM;CACxC,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,aAAqB;CACnC,MAAM,cAAc,GAAG,QAAQ,SAAS,GAAG,QAAQ;CAEnD,MAAM,kBAAkB,kBAAkB,IAAI,WAAW;CACzD,IAAI,CAAC,iBACH,MAAM,IAAI,eAAe,0CAA0C,QAAQ,SAAS,GAAG,QAAQ,KAAK,EAAE;CAExG,IAAI,QAAQ,aAAa,WAAW,OAAO,GACzC,MAAM,IAAI,eAAe,oFAAoF;CAG/G,MAAM,CAAC,aAAa,cAAc;CAClC,IAAI;CAEJ,IAAI;EACF,eAAe,QAAQ,QAAQ,GAAG,YAAY,cAAc;CAC9D,SACO,OAAO;EACZ,MAAM,IAAI,eAAe,wBAAwB,YAAY,6EAA6E,EAAE,MAAM,CAAC;CACrJ;CAEA,MAAM,eAAe,KAAK,QAAQ,YAAY,GAAG,UAAU;CAC3D,IAAI;EACF,WAAW,cAAc,QAAQ,aAAa,UAAU,UAAU,OAAO,UAAU,IAAI;CACzF,SACO,OAAO;EACZ,MAAM,IAAI,eAAe,OAAO,YAAY,wDAAwD,aAAa,IAAI,EAAE,MAAM,CAAC;CAChI;CAEA,OAAO;AACT;AAEA,SAAS,SAAkB;CAEzB,QADe,QAAQ,QAAQ,YAAY,EAAA,EAC5B,QAAQ,wBAAwB,KAAA;AACjD"}
+{"version":3,"file":"binary.js","names":[],"sources":["../src-js/binary.ts"],"sourcesContent":["import process from 'node:process'\n\nimport { accessSync, constants } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, join } from 'node:path'\n\nconst require = createRequire(import.meta.url)\n\nconst PLATFORM_PACKAGES = new Map<string, readonly [string, string]>([\n  ['darwin-arm64', ['@auv-js/cli-darwin-arm64', 'bin/auv']],\n  ['darwin-x64', ['@auv-js/cli-darwin-x64', 'bin/auv']],\n  ['linux-arm64', ['@auv-js/cli-linux-arm64-gnu', 'bin/auv']],\n  ['linux-x64', ['@auv-js/cli-linux-x64-gnu', 'bin/auv']],\n  ['win32-arm64', ['@auv-js/cli-win32-arm64-msvc', 'bin/auv.exe']],\n  ['win32-x64', ['@auv-js/cli-win32-x64-msvc', 'bin/auv.exe']],\n])\n\ninterface DiagnosticReport {\n  header?: {\n    glibcVersionRuntime?: string\n  }\n}\n\nexport class AuvBinaryError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'AuvBinaryError'\n  }\n}\n\n/** Return the absolute path of the AUV executable installed for this host. */\nexport function binaryPath(): string {\n  const platformKey = `${process.platform}-${process.arch}`\n\n  const platformPackage = PLATFORM_PACKAGES.get(platformKey)\n  if (!platformPackage) {\n    throw new AuvBinaryError(`AUV does not publish an executable for ${process.platform}/${process.arch}.`)\n  }\n  if (process.platform === 'linux' && isMusl()) {\n    throw new AuvBinaryError('AUV currently publishes glibc Linux executables only; musl Linux is not supported.')\n  }\n\n  const [packageName, executable] = platformPackage\n  let manifestPath: string\n\n  try {\n    manifestPath = require.resolve(`${packageName}/package.json`)\n  }\n  catch (cause) {\n    throw new AuvBinaryError(`The optional package ${packageName} is missing. Reinstall @auv-js/cli without omitting optional dependencies.`, { cause })\n  }\n\n  const resolvedPath = join(dirname(manifestPath), executable)\n  try {\n    accessSync(resolvedPath, process.platform === 'win32' ? constants.F_OK : constants.X_OK)\n  }\n  catch (cause) {\n    throw new AuvBinaryError(`The ${packageName} package does not contain an executable AUV binary at ${resolvedPath}.`, { cause })\n  }\n\n  return resolvedPath\n}\n\nfunction isMusl(): boolean {\n  const report = process.report?.getReport?.() as DiagnosticReport | undefined\n  return report?.header?.glibcVersionRuntime === undefined\n}\n"],"mappings":";;;;;AAMA,MAAM,UAAU,cAAc,OAAO,KAAK,GAAG;AAE7C,MAAM,oCAAoB,IAAI,IAAuC;CACnE,CAAC,gBAAgB,CAAC,4BAA4B,SAAS,CAAC;CACxD,CAAC,cAAc,CAAC,0BAA0B,SAAS,CAAC;CACpD,CAAC,eAAe,CAAC,+BAA+B,SAAS,CAAC;CAC1D,CAAC,aAAa,CAAC,6BAA6B,SAAS,CAAC;CACtD,CAAC,eAAe,CAAC,gCAAgC,aAAa,CAAC;CAC/D,CAAC,aAAa,CAAC,8BAA8B,aAAa,CAAC;AAC7D,CAAC;AAQD,IAAa,iBAAb,cAAoC,MAAM;CACxC,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,aAAqB;CACnC,MAAM,cAAc,GAAG,QAAQ,SAAS,GAAG,QAAQ;CAEnD,MAAM,kBAAkB,kBAAkB,IAAI,WAAW;CACzD,IAAI,CAAC,iBACH,MAAM,IAAI,eAAe,0CAA0C,QAAQ,SAAS,GAAG,QAAQ,KAAK,EAAE;CAExG,IAAI,QAAQ,aAAa,WAAW,OAAO,GACzC,MAAM,IAAI,eAAe,oFAAoF;CAG/G,MAAM,CAAC,aAAa,cAAc;CAClC,IAAI;CAEJ,IAAI;EACF,eAAe,QAAQ,QAAQ,GAAG,YAAY,cAAc;CAC9D,SACO,OAAO;EACZ,MAAM,IAAI,eAAe,wBAAwB,YAAY,6EAA6E,EAAE,MAAM,CAAC;CACrJ;CAEA,MAAM,eAAe,KAAK,QAAQ,YAAY,GAAG,UAAU;CAC3D,IAAI;EACF,WAAW,cAAc,QAAQ,aAAa,UAAU,UAAU,OAAO,UAAU,IAAI;CACzF,SACO,OAAO;EACZ,MAAM,IAAI,eAAe,OAAO,YAAY,wDAAwD,aAAa,IAAI,EAAE,MAAM,CAAC;CAChI;CAEA,OAAO;AACT;AAEA,SAAS,SAAkB;CAEzB,QADe,QAAQ,QAAQ,YAAY,EAAA,EAC5B,QAAQ,wBAAwB,KAAA;AACjD"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { AuvBinaryError, binaryPath } from "./binary.js";
-import { MacosHelperState, MacosHelperStatus, installMacosHelper, macosHelperStatus, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper } from "./setup.js";
+import { MacosHelperOptions, MacosHelperState, MacosHelperStatus, installMacosHelper, macosHelperStatus, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper } from "./setup.js";
 import { nativePackageVersion } from "../binding.js";
-export { AuvBinaryError, MacosHelperState, MacosHelperStatus, binaryPath, installMacosHelper, macosHelperStatus, nativePackageVersion, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper };
+export { AuvBinaryError, type MacosHelperOptions, MacosHelperState, MacosHelperStatus, binaryPath, installMacosHelper, macosHelperStatus, nativePackageVersion, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper };

package/dist/setup.d.ts

@@ -1,19 +1,22 @@
-import { MacosHelperStatus as MacosHelperStatus$1 } from "../binding.js";
+import { MacosHelperOptions, MacosHelperStatus as MacosHelperStatus$1 } from "../binding.js";
 //#region src-js/setup.d.ts
 type MacosHelperState = 'busy' | 'frontend-outdated' | 'installed' | 'invalid' | 'not-installed' | 'requires-approval' | 'running' | 'unsupported' | 'update-required';
 interface MacosHelperStatus extends Omit<MacosHelperStatus$1, 'state'> {
   state: MacosHelperState;
 }
-/** Install and register the signed helper embedded in this build. */
-declare function installMacosHelper(): Promise<MacosHelperStatus>;
-/** Inspect the installed AUV Helper identity and current-user readiness. */
-declare function macosHelperStatus(): Promise<MacosHelperStatus>;
+/**
+ * Install and register the signed helper embedded in this build, or
+ * `options.helperApp` when the embedding application ships its own helper.
+ */
+declare function installMacosHelper(options?: MacosHelperOptions): Promise<MacosHelperStatus>;
+/** Inspect the installed helper identity and current-user readiness. */
+declare function macosHelperStatus(options?: MacosHelperOptions): Promise<MacosHelperStatus>;
 /** Open System Settings at Privacy & Security > Accessibility. */
 declare function openMacosHelperAccessibilitySettings(): void;
 /** Open System Settings at General > Login Items & Extensions. */
-declare function openMacosHelperBackgroundItemsSettings(): void;
+declare function openMacosHelperBackgroundItemsSettings(options?: MacosHelperOptions): void;
 /** Unregister the helper, reset Accessibility, and remove only its app bundle. */
-declare function uninstallMacosHelper(): Promise<MacosHelperStatus>;
+declare function uninstallMacosHelper(options?: MacosHelperOptions): Promise<MacosHelperStatus>;
 //#endregion
-export { MacosHelperState, MacosHelperStatus, installMacosHelper, macosHelperStatus, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper };
+export { type MacosHelperOptions, MacosHelperState, MacosHelperStatus, installMacosHelper, macosHelperStatus, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper };
 //# sourceMappingURL=setup.d.ts.map

package/dist/setup.js

@@ -1,15 +1,18 @@
 import { installMacosHelper as installMacosHelper$1, macosHelperStatus as macosHelperStatus$1, openMacosHelperAccessibilitySettings as openMacosHelperAccessibilitySettings$1, openMacosHelperBackgroundItemsSettings as openMacosHelperBackgroundItemsSettings$1, uninstallMacosHelper as uninstallMacosHelper$1 } from "../binding.js";
 import { isMacOS } from "std-env";
 //#region src-js/setup.ts
-/** Install and register the signed helper embedded in this build. */
-async function installMacosHelper() {
+/**
+* Install and register the signed helper embedded in this build, or
+* `options.helperApp` when the embedding application ships its own helper.
+*/
+async function installMacosHelper(options) {
 	requireMacOS();
-	return installMacosHelper$1();
+	return installMacosHelper$1(options);
 }
-/** Inspect the installed AUV Helper identity and current-user readiness. */
-async function macosHelperStatus() {
+/** Inspect the installed helper identity and current-user readiness. */
+async function macosHelperStatus(options) {
 	requireMacOS();
-	return macosHelperStatus$1();
+	return macosHelperStatus$1(options);
 }
 /** Open System Settings at Privacy & Security > Accessibility. */
 function openMacosHelperAccessibilitySettings() {
@@ -17,17 +20,17 @@ function openMacosHelperAccessibilitySettings() {
 	openMacosHelperAccessibilitySettings$1();
 }
 /** Open System Settings at General > Login Items & Extensions. */
-function openMacosHelperBackgroundItemsSettings() {
+function openMacosHelperBackgroundItemsSettings(options) {
 	requireMacOS();
-	openMacosHelperBackgroundItemsSettings$1();
+	openMacosHelperBackgroundItemsSettings$1(options);
 }
 /** Unregister the helper, reset Accessibility, and remove only its app bundle. */
-async function uninstallMacosHelper() {
+async function uninstallMacosHelper(options) {
 	requireMacOS();
-	return uninstallMacosHelper$1();
+	return uninstallMacosHelper$1(options);
 }
 function requireMacOS() {
-	if (!isMacOS) throw new Error("AUV Helper setup is available only on macOS.");
+	if (!isMacOS) throw new Error("macOS helper setup is available only on macOS.");
 }
 //#endregion
 export { installMacosHelper, macosHelperStatus, openMacosHelperAccessibilitySettings, openMacosHelperBackgroundItemsSettings, uninstallMacosHelper };

package/dist/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","names":["installNativeMacosHelper","nativeMacosHelperStatus","uninstallNativeMacosHelper"],"sources":["../src-js/setup.ts"],"sourcesContent":["import type { MacosHelperStatus as NativeMacosHelperStatus } from '../binding.js'\n\nimport { isMacOS } from 'std-env'\n\nimport {\n  installMacosHelper as installNativeMacosHelper,\n  macosHelperStatus as nativeMacosHelperStatus,\n  openMacosHelperAccessibilitySettings as openNativeMacosHelperAccessibilitySettings,\n  openMacosHelperBackgroundItemsSettings as openNativeMacosHelperBackgroundItemsSettings,\n  uninstallMacosHelper as uninstallNativeMacosHelper,\n} from '../binding.js'\n\nexport type MacosHelperState\n  = | 'busy'\n    | 'frontend-outdated'\n    | 'installed'\n    | 'invalid'\n    | 'not-installed'\n    | 'requires-approval'\n    | 'running'\n    | 'unsupported'\n    | 'update-required'\n\nexport interface MacosHelperStatus extends Omit<NativeMacosHelperStatus, 'state'> {\n  state: MacosHelperState\n}\n\n/** Install and register the signed helper embedded in this build. */\nexport async function installMacosHelper(): Promise<MacosHelperStatus> {\n  requireMacOS()\n  return installNativeMacosHelper() as Promise<MacosHelperStatus>\n}\n\n/** Inspect the installed AUV Helper identity and current-user readiness. */\nexport async function macosHelperStatus(): Promise<MacosHelperStatus> {\n  requireMacOS()\n  return nativeMacosHelperStatus() as Promise<MacosHelperStatus>\n}\n\n/** Open System Settings at Privacy & Security > Accessibility. */\nexport function openMacosHelperAccessibilitySettings(): void {\n  requireMacOS()\n  openNativeMacosHelperAccessibilitySettings()\n}\n\n/** Open System Settings at General > Login Items & Extensions. */\nexport function openMacosHelperBackgroundItemsSettings(): void {\n  requireMacOS()\n  openNativeMacosHelperBackgroundItemsSettings()\n}\n\n/** Unregister the helper, reset Accessibility, and remove only its app bundle. */\nexport async function uninstallMacosHelper(): Promise<MacosHelperStatus> {\n  requireMacOS()\n  return uninstallNativeMacosHelper() as Promise<MacosHelperStatus>\n}\n\nfunction requireMacOS(): void {\n  if (!isMacOS) {\n    throw new Error('AUV Helper setup is available only on macOS.')\n  }\n}\n"],"mappings":";;;;AA4BA,eAAsB,qBAAiD;CACrE,aAAa;CACb,OAAOA,qBAAyB;AAClC;;AAGA,eAAsB,oBAAgD;CACpE,aAAa;CACb,OAAOC,oBAAwB;AACjC;;AAGA,SAAgB,uCAA6C;CAC3D,aAAa;CACb,uCAA2C;AAC7C;;AAGA,SAAgB,yCAA+C;CAC7D,aAAa;CACb,yCAA6C;AAC/C;;AAGA,eAAsB,uBAAmD;CACvE,aAAa;CACb,OAAOC,uBAA2B;AACpC;AAEA,SAAS,eAAqB;CAC5B,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,8CAA8C;AAElE"}
+{"version":3,"file":"setup.js","names":["installNativeMacosHelper","nativeMacosHelperStatus","uninstallNativeMacosHelper"],"sources":["../src-js/setup.ts"],"sourcesContent":["import type { MacosHelperOptions, MacosHelperStatus as NativeMacosHelperStatus } from '../binding.js'\n\nimport { isMacOS } from 'std-env'\n\nimport {\n  installMacosHelper as installNativeMacosHelper,\n  macosHelperStatus as nativeMacosHelperStatus,\n  openMacosHelperAccessibilitySettings as openNativeMacosHelperAccessibilitySettings,\n  openMacosHelperBackgroundItemsSettings as openNativeMacosHelperBackgroundItemsSettings,\n  uninstallMacosHelper as uninstallNativeMacosHelper,\n} from '../binding.js'\n\nexport type MacosHelperState\n  = | 'busy'\n    | 'frontend-outdated'\n    | 'installed'\n    | 'invalid'\n    | 'not-installed'\n    | 'requires-approval'\n    | 'running'\n    | 'unsupported'\n    | 'update-required'\n\nexport type { MacosHelperOptions }\n\nexport interface MacosHelperStatus extends Omit<NativeMacosHelperStatus, 'state'> {\n  state: MacosHelperState\n}\n\n/**\n * Install and register the signed helper embedded in this build, or\n * `options.helperApp` when the embedding application ships its own helper.\n */\nexport async function installMacosHelper(options?: MacosHelperOptions): Promise<MacosHelperStatus> {\n  requireMacOS()\n  return installNativeMacosHelper(options) as Promise<MacosHelperStatus>\n}\n\n/** Inspect the installed helper identity and current-user readiness. */\nexport async function macosHelperStatus(options?: MacosHelperOptions): Promise<MacosHelperStatus> {\n  requireMacOS()\n  return nativeMacosHelperStatus(options) as Promise<MacosHelperStatus>\n}\n\n/** Open System Settings at Privacy & Security > Accessibility. */\nexport function openMacosHelperAccessibilitySettings(): void {\n  requireMacOS()\n  openNativeMacosHelperAccessibilitySettings()\n}\n\n/** Open System Settings at General > Login Items & Extensions. */\nexport function openMacosHelperBackgroundItemsSettings(options?: MacosHelperOptions): void {\n  requireMacOS()\n  openNativeMacosHelperBackgroundItemsSettings(options)\n}\n\n/** Unregister the helper, reset Accessibility, and remove only its app bundle. */\nexport async function uninstallMacosHelper(options?: MacosHelperOptions): Promise<MacosHelperStatus> {\n  requireMacOS()\n  return uninstallNativeMacosHelper(options) as Promise<MacosHelperStatus>\n}\n\nfunction requireMacOS(): void {\n  if (!isMacOS) {\n    throw new Error('macOS helper setup is available only on macOS.')\n  }\n}\n"],"mappings":";;;;;;;AAiCA,eAAsB,mBAAmB,SAA0D;CACjG,aAAa;CACb,OAAOA,qBAAyB,OAAO;AACzC;;AAGA,eAAsB,kBAAkB,SAA0D;CAChG,aAAa;CACb,OAAOC,oBAAwB,OAAO;AACxC;;AAGA,SAAgB,uCAA6C;CAC3D,aAAa;CACb,uCAA2C;AAC7C;;AAGA,SAAgB,uCAAuC,SAAoC;CACzF,aAAa;CACb,yCAA6C,OAAO;AACtD;;AAGA,eAAsB,qBAAqB,SAA0D;CACnG,aAAa;CACb,OAAOC,uBAA2B,OAAO;AAC3C;AAEA,SAAS,eAAqB;CAC5B,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,gDAAgD;AAEpE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@auv-js/cli",
   "type": "module",
-  "version": "0.0.24",
+  "version": "0.0.27",
   "description": "NAPI bindings and the platform-matched AUV command-line executable",
   "license": "Apache-2.0",
   "repository": {
@@ -50,6 +50,7 @@
     "rootPublisher": "pnpm",
     "targets": [
       "aarch64-apple-darwin",
+      "aarch64-pc-windows-msvc",
       "aarch64-unknown-linux-gnu",
       "x86_64-apple-darwin",
       "x86_64-pc-windows-msvc",
@@ -60,11 +61,12 @@
     "std-env": "4.2.0"
   },
   "optionalDependencies": {
-    "@auv-js/cli-darwin-arm64": "0.0.24",
-    "@auv-js/cli-linux-arm64-gnu": "0.0.24",
-    "@auv-js/cli-darwin-x64": "0.0.24",
-    "@auv-js/cli-win32-x64-msvc": "0.0.24",
-    "@auv-js/cli-linux-x64-gnu": "0.0.24"
+    "@auv-js/cli-darwin-arm64": "0.0.27",
+    "@auv-js/cli-win32-arm64-msvc": "0.0.27",
+    "@auv-js/cli-linux-arm64-gnu": "0.0.27",
+    "@auv-js/cli-darwin-x64": "0.0.27",
+    "@auv-js/cli-win32-x64-msvc": "0.0.27",
+    "@auv-js/cli-linux-x64-gnu": "0.0.27"
   },
   "devDependencies": {
     "@emnapi/core": "^1.11.2",