@vantail/api 0.1.0

package/dist/error.d.ts

@@ -0,0 +1,27 @@
+import { type VantailErrorPayload } from "./protocol.js";
+/**
+ * Every failure from the native side arrives as one of these.
+ *
+ * `code` is the part worth branching on - the message is for humans and may
+ * change between releases.
+ *
+ * ```ts
+ * try {
+ *   await filesystem.readText(path);
+ * } catch (error) {
+ *   if (VantailError.is(error, "PERMISSION_DENIED")) {
+ *     // ask the user to pick the file instead
+ *   }
+ * }
+ * ```
+ */
+export declare class VantailError extends Error {
+    readonly code: string;
+    readonly data: unknown;
+    constructor(code: string, message: string, data?: unknown);
+    static from(payload: VantailErrorPayload): VantailError;
+    /** Type guard, optionally narrowing to a specific code. */
+    static is(error: unknown, code?: string): error is VantailError;
+}
+export declare const noRuntime: () => VantailError;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAKxD;IAED,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAEtD;IAED,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAG9D;CACF;AAED,eAAO,MAAM,SAAS,QAAO,YAK1B,CAAC"}

package/dist/error.js

@@ -0,0 +1,39 @@
+import { ErrorCode } from "./protocol.js";
+/**
+ * Every failure from the native side arrives as one of these.
+ *
+ * `code` is the part worth branching on - the message is for humans and may
+ * change between releases.
+ *
+ * ```ts
+ * try {
+ *   await filesystem.readText(path);
+ * } catch (error) {
+ *   if (VantailError.is(error, "PERMISSION_DENIED")) {
+ *     // ask the user to pick the file instead
+ *   }
+ * }
+ * ```
+ */
+export class VantailError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = "VantailError";
+        this.code = code;
+        this.data = data;
+    }
+    static from(payload) {
+        return new VantailError(payload.code, payload.message, payload.data);
+    }
+    /** Type guard, optionally narrowing to a specific code. */
+    static is(error, code) {
+        if (!(error instanceof VantailError))
+            return false;
+        return code === undefined || error.code === code;
+    }
+}
+export const noRuntime = () => new VantailError(ErrorCode.NO_RUNTIME, "No Vantail runtime found. `@vantail/api` only works inside a Vantail window - " +
+    "run your app with `vantail dev` instead of opening it in a browser.");
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA4B,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAS;IACb,IAAI,CAAU;IAEvB,YAAY,IAAY,EAAE,OAAe,EAAE,IAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAA4B;QACtC,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,KAAc,EAAE,IAAa;QACrC,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC;YAAE,OAAO,KAAK,CAAC;QACnD,OAAO,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;IACnD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,GAAiB,EAAE,CAC1C,IAAI,YAAY,CACd,SAAS,CAAC,UAAU,EACpB,gFAAgF;IAC9E,qEAAqE,CACxE,CAAC"}

package/dist/filesystem.d.ts

@@ -0,0 +1,99 @@
+import { type BinaryInput } from "./binary.js";
+export interface FileChange {
+    /** The watch that reported it, as returned by {@link filesystem.watch}. */
+    id: string;
+    kind: "created" | "modified" | "removed" | "renamed";
+    /** What changed. For a recursive watch this is below the watched path. */
+    path: string;
+    /** The path the watch was placed on. */
+    watching: string;
+}
+export interface Watch {
+    id: string;
+    path: string;
+    recursive: boolean;
+}
+export interface DirEntry {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+    isFile: boolean;
+    isSymlink: boolean;
+}
+export interface FileInfo {
+    path: string;
+    isDirectory: boolean;
+    isFile: boolean;
+    isSymlink: boolean;
+    size: number;
+    readonly: boolean;
+    /** Milliseconds since the epoch, or `null` where the platform has none. */
+    modifiedAt: number | null;
+    createdAt: number | null;
+}
+/**
+ * Scoped file access.
+ *
+ * Every call is checked against the `permissions.filesystem` scopes in
+ * `vantail.config.ts`, plus anything the user has picked in a native dialog
+ * during this session. A refusal throws a `VantailError` with code
+ * `PERMISSION_DENIED`.
+ */
+export declare const filesystem: {
+    readText: (path: string) => Promise<string>;
+    writeText: (path: string, contents: string, options?: {
+        createDirs?: boolean;
+    }) => Promise<null>;
+    appendText: (path: string, contents: string) => Promise<null>;
+    /**
+     * Read a file as bytes.
+     *
+     * Limited to 64 MB: the data crosses the IPC boundary as base64 inside a
+     * JSON string, which is fine for icons and documents and wrong for video.
+     */
+    readBinary: (path: string) => Promise<Uint8Array>;
+    writeBinary: (path: string, data: BinaryInput, options?: {
+        createDirs?: boolean;
+    }) => Promise<null>;
+    /** Directories first, then files, both case-insensitively by name. */
+    readDir: (path: string) => Promise<DirEntry[]>;
+    exists: (path: string) => Promise<boolean>;
+    stat: (path: string) => Promise<FileInfo>;
+    mkdir: (path: string, options?: {
+        recursive?: boolean;
+    }) => Promise<null>;
+    /** Removing a non-empty directory needs `{ recursive: true }`. */
+    remove: (path: string, options?: {
+        recursive?: boolean;
+    }) => Promise<null>;
+    copy: (from: string, to: string) => Promise<null>;
+    rename: (from: string, to: string) => Promise<null>;
+    /**
+     * Be told when a path changes, instead of polling it.
+     *
+     * Scoped exactly like a read: watching a path you cannot read is denied.
+     * A directory reports its own children; pass `{ recursive: true }` for
+     * everything below it.
+     *
+     * ```ts
+     * const { id } = await filesystem.watch(dir, { recursive: true });
+     * filesystem.onChange((change) => console.log(change.kind, change.path));
+     * // later
+     * await filesystem.unwatch(id);
+     * ```
+     */
+    watch: (path: string, options?: {
+        recursive?: boolean;
+    }) => Promise<Watch>;
+    /** Stop a watch. Throws `NOT_FOUND` if it is not running. */
+    unwatch: (id: string) => Promise<null>;
+    /** The ids of every watch this application has running. */
+    watches: () => Promise<string[]>;
+    /**
+     * Every watch reports here. Filter on `id` if you have more than one.
+     *
+     * Returns an unsubscribe function.
+     */
+    onChange: (handler: (change: FileChange) => void) => () => void;
+};
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/D,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACrD,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;IACrB,QAAQ,SAAS,MAAM;IAEvB,SAAS,SACD,MAAM,YACF,MAAM,YACN;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAQpC,UAAU,SAAS,MAAM,YAAY,MAAM;IAG3C;;;;;OAKG;IACH,UAAU,SAAe,MAAM,KAAG,OAAO,CAAC,UAAU,CAAC;IAGrD,WAAW,SACH,MAAM,QACN,WAAW,YACP;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAQpC,sEAAsE;IACtE,OAAO,SAAS,MAAM;IAEtB,MAAM,SAAS,MAAM;IAErB,IAAI,SAAS,MAAM;IAEnB,KAAK,SAAS,MAAM,YAAY;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;IAMvD,kEAAkE;IAClE,MAAM,SAAS,MAAM,YAAY;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;IAMxD,IAAI,SAAS,MAAM,MAAM,MAAM;IAG/B,MAAM,SAAS,MAAM,MAAM,MAAM;IAGjC;;;;;;;;;;;;;OAaG;IACH,KAAK,SAAS,MAAM,YAAY;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;IAMvD,6DAA6D;IAC7D,OAAO,OAAO,MAAM;IAEpB,2DAA2D;IAC3D,OAAO;IAEP;;;;OAIG;IACH,QAAQ,YAAY,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;CAEjD,CAAC"}

package/dist/filesystem.js

@@ -0,0 +1,75 @@
+import { decode, encode } from "./binary.js";
+import { invoke, listen } from "./transport.js";
+/**
+ * Scoped file access.
+ *
+ * Every call is checked against the `permissions.filesystem` scopes in
+ * `vantail.config.ts`, plus anything the user has picked in a native dialog
+ * during this session. A refusal throws a `VantailError` with code
+ * `PERMISSION_DENIED`.
+ */
+export const filesystem = {
+    readText: (path) => invoke("filesystem.readText", { path }),
+    writeText: (path, contents, options) => invoke("filesystem.writeText", {
+        path,
+        contents,
+        createDirs: options?.createDirs ?? false,
+    }),
+    appendText: (path, contents) => invoke("filesystem.appendText", { path, contents }),
+    /**
+     * Read a file as bytes.
+     *
+     * Limited to 64 MB: the data crosses the IPC boundary as base64 inside a
+     * JSON string, which is fine for icons and documents and wrong for video.
+     */
+    readBinary: async (path) => decode(await invoke("filesystem.readBinary", { path })),
+    writeBinary: (path, data, options) => invoke("filesystem.writeBinary", {
+        path,
+        data: encode(data),
+        createDirs: options?.createDirs ?? false,
+    }),
+    /** Directories first, then files, both case-insensitively by name. */
+    readDir: (path) => invoke("filesystem.readDir", { path }),
+    exists: (path) => invoke("filesystem.exists", { path }),
+    stat: (path) => invoke("filesystem.stat", { path }),
+    mkdir: (path, options) => invoke("filesystem.mkdir", {
+        path,
+        recursive: options?.recursive ?? false,
+    }),
+    /** Removing a non-empty directory needs `{ recursive: true }`. */
+    remove: (path, options) => invoke("filesystem.remove", {
+        path,
+        recursive: options?.recursive ?? false,
+    }),
+    copy: (from, to) => invoke("filesystem.copy", { from, to }),
+    rename: (from, to) => invoke("filesystem.rename", { from, to }),
+    /**
+     * Be told when a path changes, instead of polling it.
+     *
+     * Scoped exactly like a read: watching a path you cannot read is denied.
+     * A directory reports its own children; pass `{ recursive: true }` for
+     * everything below it.
+     *
+     * ```ts
+     * const { id } = await filesystem.watch(dir, { recursive: true });
+     * filesystem.onChange((change) => console.log(change.kind, change.path));
+     * // later
+     * await filesystem.unwatch(id);
+     * ```
+     */
+    watch: (path, options) => invoke("filesystem.watch", {
+        path,
+        recursive: options?.recursive ?? false,
+    }),
+    /** Stop a watch. Throws `NOT_FOUND` if it is not running. */
+    unwatch: (id) => invoke("filesystem.unwatch", { id }),
+    /** The ids of every watch this application has running. */
+    watches: () => invoke("filesystem.watches"),
+    /**
+     * Every watch reports here. Filter on `id` if you have more than one.
+     *
+     * Returns an unsubscribe function.
+     */
+    onChange: (handler) => listen("filesystem.changed", handler),
+};
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAsChD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAS,qBAAqB,EAAE,EAAE,IAAI,EAAE,CAAC;IAE3E,SAAS,EAAE,CACT,IAAY,EACZ,QAAgB,EAChB,OAAkC,EAClC,EAAE,CACF,MAAM,CAAO,sBAAsB,EAAE;QACnC,IAAI;QACJ,QAAQ;QACR,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,KAAK;KACzC,CAAC;IAEJ,UAAU,EAAE,CAAC,IAAY,EAAE,QAAgB,EAAE,EAAE,CAC7C,MAAM,CAAO,uBAAuB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAE3D;;;;;OAKG;IACH,UAAU,EAAE,KAAK,EAAE,IAAY,EAAuB,EAAE,CACtD,MAAM,CAAC,MAAM,MAAM,CAAS,uBAAuB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,WAAW,EAAE,CACX,IAAY,EACZ,IAAiB,EACjB,OAAkC,EAClC,EAAE,CACF,MAAM,CAAO,wBAAwB,EAAE;QACrC,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,KAAK;KACzC,CAAC;IAEJ,sEAAsE;IACtE,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAa,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC;IAE7E,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAU,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC;IAExE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAW,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC;IAErE,KAAK,EAAE,CAAC,IAAY,EAAE,OAAiC,EAAE,EAAE,CACzD,MAAM,CAAO,kBAAkB,EAAE;QAC/B,IAAI;QACJ,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;KACvC,CAAC;IAEJ,kEAAkE;IAClE,MAAM,EAAE,CAAC,IAAY,EAAE,OAAiC,EAAE,EAAE,CAC1D,MAAM,CAAO,mBAAmB,EAAE;QAChC,IAAI;QACJ,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;KACvC,CAAC;IAEJ,IAAI,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CACjC,MAAM,CAAO,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAE/C,MAAM,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CACnC,MAAM,CAAO,mBAAmB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAEjD;;;;;;;;;;;;;OAaG;IACH,KAAK,EAAE,CAAC,IAAY,EAAE,OAAiC,EAAE,EAAE,CACzD,MAAM,CAAQ,kBAAkB,EAAE;QAChC,IAAI;QACJ,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;KACvC,CAAC;IAEJ,6DAA6D;IAC7D,OAAO,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAO,oBAAoB,EAAE,EAAE,EAAE,EAAE,CAAC;IAEnE,2DAA2D;IAC3D,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAW,oBAAoB,CAAC;IAErD;;;;OAIG;IACH,QAAQ,EAAE,CAAC,OAAqC,EAAE,EAAE,CAClD,MAAM,CAAa,oBAAoB,EAAE,OAAO,CAAC;CACpD,CAAC"}

package/dist/hid.d.ts

@@ -0,0 +1,69 @@
+import { type BinaryInput } from "./binary.js";
+export interface HidDeviceInfo {
+    /** Opaque, platform-specific, and what `open` takes. */
+    id: string;
+    vendorId: number;
+    productId: number;
+    manufacturer: string | null;
+    product: string | null;
+    serialNumber: string | null;
+    usagePage: number;
+    usage: number;
+    interface: number;
+}
+export interface HidConnection {
+    /** The handle every call below takes. Not an OS handle. */
+    readonly handle: number;
+    readonly vendorId: number;
+    readonly productId: number;
+    /**
+     * Send an output report. The **first byte is the report id** - use `0` for
+     * devices that do not use numbered reports. Resolves with the byte count
+     * the device accepted.
+     */
+    write(data: BinaryInput): Promise<number>;
+    /** Send a feature report. Same report-id convention as `write`. */
+    sendFeatureReport(data: BinaryInput): Promise<null>;
+    /** Read a feature report. `length` excludes the report id. */
+    getFeatureReport(reportId: number, length: number): Promise<Uint8Array>;
+    close(): Promise<boolean>;
+    /** Input reports as they arrive, including the report id byte. */
+    onInput(handler: (data: Uint8Array) => void): () => void;
+    /** The device closed - because you asked, or because it was unplugged. */
+    onClosed(handler: (event: {
+        reason: "closed" | "disconnected";
+    }) => void): () => void;
+}
+/**
+ * Raw access to USB HID devices.
+ *
+ * WebHID does not exist in the webviews Vantail runs on, so a control pad, a
+ * foot pedal or a macro pad is simply unreachable from a page. This is the
+ * one capability that is device-shaped, which is exactly why it stays generic:
+ * Vantail knows what a HID report is and has never heard of any particular device. Your
+ * application implements the protocol; the platform hands it bytes.
+ *
+ * ```ts
+ * const [deck] = await hid.list();          // already filtered by permission
+ * const connection = await hid.open(deck.id);
+ *
+ * connection.onInput((report) => decodeButtons(report));
+ * await connection.write(new Uint8Array([0x02, 0x0b, 0x01]));
+ * ```
+ *
+ * `list()` returns only devices `permissions.hid` allows - an application
+ * permitted to talk to one vendor's hardware has no business learning what
+ * else is plugged in.
+ */
+export declare const hid: {
+    list: () => Promise<HidDeviceInfo[]>;
+    open: (id: string) => Promise<HidConnection>;
+    /** Everything this application currently has open. */
+    opened: () => Promise<{
+        handle: number;
+        id: string;
+        vendorId: number;
+        productId: number;
+    }[]>;
+};
+//# sourceMappingURL=hid.d.ts.map

package/dist/hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../src/hid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/D,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C,mEAAmE;IACnE,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,8DAA8D;IAC9D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1B,kEAAkE;IAClE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEzD,0EAA0E;IAC1E,QAAQ,CACN,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAA;KAAE,KAAK,IAAI,GAC9D,MAAM,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,GAAG;IACd,IAAI;IAEJ,IAAI,OAAa,MAAM,KAAG,OAAO,CAAC,aAAa,CAAC;IAShD,sDAAsD;IACtD,MAAM;gBAEQ,MAAM;YAAM,MAAM;kBAAY,MAAM;mBAAa,MAAM;;CAEtE,CAAC"}

package/dist/hid.js

@@ -0,0 +1,54 @@
+import { decode, encode } from "./binary.js";
+import { invoke, listen } from "./transport.js";
+/**
+ * Raw access to USB HID devices.
+ *
+ * WebHID does not exist in the webviews Vantail runs on, so a control pad, a
+ * foot pedal or a macro pad is simply unreachable from a page. This is the
+ * one capability that is device-shaped, which is exactly why it stays generic:
+ * Vantail knows what a HID report is and has never heard of any particular device. Your
+ * application implements the protocol; the platform hands it bytes.
+ *
+ * ```ts
+ * const [deck] = await hid.list();          // already filtered by permission
+ * const connection = await hid.open(deck.id);
+ *
+ * connection.onInput((report) => decodeButtons(report));
+ * await connection.write(new Uint8Array([0x02, 0x0b, 0x01]));
+ * ```
+ *
+ * `list()` returns only devices `permissions.hid` allows - an application
+ * permitted to talk to one vendor's hardware has no business learning what
+ * else is plugged in.
+ */
+export const hid = {
+    list: () => invoke("hid.list"),
+    open: async (id) => {
+        const opened = await invoke("hid.open", { id });
+        return connection(opened.handle, opened.vendorId, opened.productId);
+    },
+    /** Everything this application currently has open. */
+    opened: () => invoke("hid.opened"),
+};
+function connection(handle, vendorId, productId) {
+    const forHandle = (event, fn) => listen(event, (payload) => {
+        if (payload.handle === handle)
+            fn(payload);
+    });
+    return {
+        handle,
+        vendorId,
+        productId,
+        write: (data) => invoke("hid.write", { handle, data: encode(data) }),
+        sendFeatureReport: (data) => invoke("hid.sendFeatureReport", { handle, data: encode(data) }),
+        getFeatureReport: async (reportId, length) => decode(await invoke("hid.getFeatureReport", {
+            handle,
+            reportId,
+            length,
+        })),
+        close: () => invoke("hid.close", { handle }),
+        onInput: (fn) => forHandle("hid.input", ({ data }) => fn(decode(data))),
+        onClosed: (fn) => forHandle("hid.closed", ({ reason }) => fn({ reason })),
+    };
+}
+//# sourceMappingURL=hid.js.map

package/dist/hid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid.js","sourceRoot":"","sources":["../src/hid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AA6ChD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAkB,UAAU,CAAC;IAE/C,IAAI,EAAE,KAAK,EAAE,EAAU,EAA0B,EAAE;QACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAIxB,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;IAED,sDAAsD;IACtD,MAAM,EAAE,GAAG,EAAE,CACX,MAAM,CAEJ,YAAY,CAAC;CAClB,CAAC;AAEF,SAAS,UAAU,CACjB,MAAc,EACd,QAAgB,EAChB,SAAiB;IAEjB,MAAM,SAAS,GAAG,CAChB,KAAa,EACb,EAAwB,EACxB,EAAE,CACF,MAAM,CAAI,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;QAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,MAAM;QACN,QAAQ;QACR,SAAS;QAET,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CACd,MAAM,CAAS,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC1B,MAAM,CAAO,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAC3C,MAAM,CACJ,MAAM,MAAM,CAAS,sBAAsB,EAAE;YAC3C,MAAM;YACN,QAAQ;YACR,MAAM;SACP,CAAC,CACH;QACH,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAU,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC;QAErD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CACd,SAAS,CAAmC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACpE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CACjB;QACH,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CACf,SAAS,CACP,YAAY,EACZ,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAC/B;KACJ,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `@vantail/api` - the native surface of a Vantail application.
+ *
+ * ```ts
+ * import { dialog, filesystem } from "@vantail/api";
+ *
+ * const path = await dialog.openFile();
+ * if (path) console.log(await filesystem.readText(path));
+ * ```
+ *
+ * There is no Node.js here: no `node:fs`, no `require`, no npm package with a
+ * native addon. Just the browser you already know, plus these calls.
+ */
+export { app, type AppInfo, type ProgressOptions, type ProgressState, } from "./app.js";
+export { autostart } from "./autostart.js";
+export { clipboard, type ClipboardImage } from "./clipboard.js";
+export { deepLink } from "./deeplink.js";
+export { fileDrop, type DropEvent } from "./drop.js";
+export { dialog, type ConfirmOptions, type FileFilter, type MessageOptions, type OpenOptions, type SaveOptions, } from "./dialog.js";
+export { filesystem, type DirEntry, type FileChange, type FileInfo, type Watch, } from "./filesystem.js";
+export { hid, type HidConnection, type HidDeviceInfo } from "./hid.js";
+export { mdns, type DiscoveredService, type DiscoverOptions } from "./mdns.js";
+export { menu, type MenuItem, type PredefinedMenuItem } from "./menu.js";
+export { network, type NetworkRequestOptions, type NetworkResponse, } from "./network.js";
+export { notification, type NotificationOptions } from "./notification.js";
+export { os, type OsInfo, type Platform } from "./os.js";
+export { process, type Child, type ExecuteOptions, type ExecuteResult, type ExitEvent, type RunOptions, } from "./process.js";
+export { screen, type Screen } from "./screen.js";
+export { power } from "./power.js";
+export { secrets } from "./secrets.js";
+export { shell } from "./shell.js";
+export { shortcut, type RegisterOptions, type Shortcut } from "./shortcut.js";
+export { tray, type TrayClick, type TrayOptions } from "./tray.js";
+export { updater, type DownloadProgress, type DownloadResult, type NoUpdate, type UpdateAvailable, type UpdateCheck, } from "./updater.js";
+export { appWindow, appWindow as window, createWindow, currentWindow, getWindow, listWindows, onWindowClosed, onWindowCreated, onWindowReady, type CloseBehavior, type Position, type Size, type WindowHandle, type WindowOptions, } from "./window.js";
+export { type BinaryInput } from "./binary.js";
+export { VantailError } from "./error.js";
+export { invoke, isVantail, listen, runtimeVersion, windowLabel, } from "./transport.js";
+export { ErrorCode } from "./protocol.js";
+export type { VantailBridge, VantailErrorPayload, VantailIncoming, VantailRequest, VantailResponse, } from "./protocol.js";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * `@vantail/api` - the native surface of a Vantail application.
+ *
+ * ```ts
+ * import { dialog, filesystem } from "@vantail/api";
+ *
+ * const path = await dialog.openFile();
+ * if (path) console.log(await filesystem.readText(path));
+ * ```
+ *
+ * There is no Node.js here: no `node:fs`, no `require`, no npm package with a
+ * native addon. Just the browser you already know, plus these calls.
+ */
+export { app, } from "./app.js";
+export { autostart } from "./autostart.js";
+export { clipboard } from "./clipboard.js";
+export { deepLink } from "./deeplink.js";
+export { fileDrop } from "./drop.js";
+export { dialog, } from "./dialog.js";
+export { filesystem, } from "./filesystem.js";
+export { hid } from "./hid.js";
+export { mdns } from "./mdns.js";
+export { menu } from "./menu.js";
+export { network, } from "./network.js";
+export { notification } from "./notification.js";
+export { os } from "./os.js";
+export { process, } from "./process.js";
+export { screen } from "./screen.js";
+export { power } from "./power.js";
+export { secrets } from "./secrets.js";
+export { shell } from "./shell.js";
+export { shortcut } from "./shortcut.js";
+export { tray } from "./tray.js";
+export { updater, } from "./updater.js";
+export { appWindow, appWindow as window, createWindow, currentWindow, getWindow, listWindows, onWindowClosed, onWindowCreated, onWindowReady, } from "./window.js";
+export {} from "./binary.js";
+export { VantailError } from "./error.js";
+export { invoke, isVantail, listen, runtimeVersion, windowLabel, } from "./transport.js";
+export { ErrorCode } from "./protocol.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,GAAG,GAIJ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAkB,MAAM,WAAW,CAAC;AACrD,OAAO,EACL,MAAM,GAMP,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,UAAU,GAKX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,GAAG,EAA0C,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,IAAI,EAAgD,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,IAAI,EAA0C,MAAM,WAAW,CAAC;AACzE,OAAO,EACL,OAAO,GAGR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,EAAE,EAA8B,MAAM,SAAS,CAAC;AACzD,OAAO,EACL,OAAO,GAMR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAuC,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAoC,MAAM,WAAW,CAAC;AACnE,OAAO,EACL,OAAO,GAMR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,SAAS,IAAI,MAAM,EACnB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,GAMd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAoB,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,MAAM,EACN,SAAS,EACT,MAAM,EACN,cAAc,EACd,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/mdns.d.ts

@@ -0,0 +1,65 @@
+export interface DiscoveredService {
+    /** The service type that was searched for, e.g. `_hub._tcp.local.` */
+    service: string;
+    /** The instance name, with the service type stripped: `Living Room Hub`. */
+    name: string;
+    /** The full record name, which is what identifies it uniquely. */
+    fullname: string;
+    /** The advertised host, e.g. `hub.local.` */
+    host: string;
+    port: number;
+    /** Every address the device answers on, sorted. IPv4 and IPv6. */
+    addresses: string[];
+    /** TXT record properties, which is where devices put their model and id. */
+    txt: Record<string, string>;
+}
+export interface DiscoverOptions {
+    /** A service type such as `_hub._tcp.local`. The trailing dot is optional. */
+    service: string;
+    /** How long to listen. Default 3000, capped at 60000. */
+    timeoutMs?: number;
+}
+/**
+ * Finding devices on the local network.
+ *
+ * Every device worth talking to announces itself over multicast DNS, and no
+ * browser can hear it. The alternative is asking your user to type in an IP
+ * address, which is why this is a platform capability.
+ *
+ * Vantail knows what a service type is and nothing about what answers to it -
+ * discovering `_hub._tcp.local` is generic; knowing the result speaks CLIP v2
+ * is your application's business.
+ *
+ * ```ts
+ * const bridges = await mdns.discover({ service: "_hub._tcp.local" });
+ * for (const bridge of bridges) {
+ *   console.log(bridge.name, bridge.addresses[0], bridge.txt["bridgeid"]);
+ * }
+ * ```
+ */
+export declare const mdns: {
+    /**
+     * Listen for a fixed period and return everything that answered, deduplicated
+     * by full name. Resolves when the time is up, not when the first device
+     * replies - devices answer at their own pace.
+     */
+    discover: (options: DiscoverOptions) => Promise<DiscoveredService[]>;
+    /**
+     * Keep watching, and report devices as they appear and disappear.
+     *
+     * Use this when the list is on screen; use {@link mdns.discover} when you
+     * just need the answer once. Resolves `{ started: false }` if that service
+     * type is already being watched.
+     */
+    browse: (service: string) => Promise<{
+        service: string;
+        started: boolean;
+    }>;
+    /** Stop watching. `false` if it was not being watched. */
+    stop: (service: string) => Promise<boolean>;
+    /** Service types currently being watched. */
+    browsing: () => Promise<string[]>;
+    onFound: (handler: (service: DiscoveredService) => void) => () => void;
+    onLost: (handler: (service: Pick<DiscoveredService, "service" | "name" | "fullname">) => void) => () => void;
+};
+//# sourceMappingURL=mdns.d.ts.map

package/dist/mdns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns.d.ts","sourceRoot":"","sources":["../src/mdns.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,IAAI;IACf;;;;OAIG;IACH,QAAQ,YAAY,eAAe;IAGnC;;;;;;OAMG;IACH,MAAM,YAAY,MAAM;iBACJ,MAAM;iBAAW,OAAO;;IAE5C,0DAA0D;IAC1D,IAAI,YAAY,MAAM;IAEtB,6CAA6C;IAC7C,QAAQ;IAER,OAAO,YAAY,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI;IAGvD,MAAM,YACK,CACP,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,KAC9D,IAAI;CAMZ,CAAC"}

package/dist/mdns.js

@@ -0,0 +1,42 @@
+import { invoke, listen } from "./transport.js";
+/**
+ * Finding devices on the local network.
+ *
+ * Every device worth talking to announces itself over multicast DNS, and no
+ * browser can hear it. The alternative is asking your user to type in an IP
+ * address, which is why this is a platform capability.
+ *
+ * Vantail knows what a service type is and nothing about what answers to it -
+ * discovering `_hub._tcp.local` is generic; knowing the result speaks CLIP v2
+ * is your application's business.
+ *
+ * ```ts
+ * const bridges = await mdns.discover({ service: "_hub._tcp.local" });
+ * for (const bridge of bridges) {
+ *   console.log(bridge.name, bridge.addresses[0], bridge.txt["bridgeid"]);
+ * }
+ * ```
+ */
+export const mdns = {
+    /**
+     * Listen for a fixed period and return everything that answered, deduplicated
+     * by full name. Resolves when the time is up, not when the first device
+     * replies - devices answer at their own pace.
+     */
+    discover: (options) => invoke("mdns.discover", options),
+    /**
+     * Keep watching, and report devices as they appear and disappear.
+     *
+     * Use this when the list is on screen; use {@link mdns.discover} when you
+     * just need the answer once. Resolves `{ started: false }` if that service
+     * type is already being watched.
+     */
+    browse: (service) => invoke("mdns.browse", { service }),
+    /** Stop watching. `false` if it was not being watched. */
+    stop: (service) => invoke("mdns.stop", { service }),
+    /** Service types currently being watched. */
+    browsing: () => invoke("mdns.browsing"),
+    onFound: (handler) => listen("mdns.found", handler),
+    onLost: (handler) => listen("mdns.lost", handler),
+};
+//# sourceMappingURL=mdns.js.map

package/dist/mdns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdns.js","sourceRoot":"","sources":["../src/mdns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAyBhD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,OAAwB,EAAE,EAAE,CACrC,MAAM,CAAsB,eAAe,EAAE,OAAO,CAAC;IAEvD;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,OAAe,EAAE,EAAE,CAC1B,MAAM,CAAwC,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC;IAE3E,0DAA0D;IAC1D,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAU,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC;IAEpE,6CAA6C;IAC7C,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAW,eAAe,CAAC;IAEjD,OAAO,EAAE,CAAC,OAA6C,EAAE,EAAE,CACzD,MAAM,CAAoB,YAAY,EAAE,OAAO,CAAC;IAElD,MAAM,EAAE,CACN,OAES,EACT,EAAE,CACF,MAAM,CACJ,WAAW,EACX,OAAO,CACR;CACJ,CAAC"}