@ikalogic/at1000 0.2.2 → 0.4.0

package/build/at1000-C6w5G8L4.d.cts

@@ -0,0 +1,109 @@
+import { s as ComApi } from "./com-BLw4CGid.cjs";
+import { i as EventsApi } from "./events-CBVQfojK.cjs";
+import { Information, ManagementApi } from "./management.cjs";
+import { s as GpioApi } from "./gpio-BuvDysYa.cjs";
+import { r as HmiApi } from "./hmi-BrdqKB3o.cjs";
+import { i as PowerApi } from "./power-FmknBUz2.cjs";
+import { n as RelaysApi } from "./relays-8EGNIK1T.cjs";
+import { t as SessionApi } from "./session-D7TpUd6L.cjs";
+
+//#region src/at1000.d.ts
+/** Structured error thrown for AT1000 API responses carrying `{ code, message, suggestion, path }`. */
+declare class ApiError extends Error {
+  readonly code: string;
+  /** Raw human-readable server message (without code/suggestion/path). */
+  readonly detail: string;
+  readonly suggestion: string;
+  readonly path: string;
+  constructor(body: {
+    code: string;
+    message: string;
+    suggestion: string;
+    path: string;
+  });
+}
+/**
+ * Formats a host into a URL authority. Returns `host` unchanged when it already
+ * carries an explicit port; otherwise appends `fallbackPort` (the device's
+ * mDNS-advertised port when known, else the default 8080). Bare IPv6 literals
+ * are bracketed. Idempotent: re-formatting an authority is a no-op.
+ */
+declare function format_host_for_url(host: string, fallbackPort?: number): string;
+/** Returns the bare host (IP or hostname) from a URL authority, dropping any port. */
+declare function host_without_port(host: string): string;
+/** A device discovered on the network but not yet opened. */
+interface DiscoveredDevice {
+  host: string;
+  info: Information;
+}
+/** Options for opening a device. */
+interface OpenOptions {
+  /** Open read-only: skip `session/open`, mint no token, send no session header. */
+  readonly?: boolean;
+  /** Human-readable holder label shown to other clients and on the front panel. */
+  label?: string;
+}
+/** @hideconstructor */
+declare class AT1000Base {
+  /**
+   * IP address or hostname of the AT1000 device
+   */
+  readonly host: string;
+  /**
+   * Device information
+   */
+  readonly info: Information;
+  /**
+   * Session token minted by `open()`, or `undefined` for a read-only or legacy
+   * (pre-session) client. Sent as the `X-AT1000-Session` header on every request.
+   */
+  readonly token: string | undefined;
+  /**
+   * `false` only when a pre-session server was detected during an exclusive
+   * `open()` (no `/v0/session/*` routes). Read-only opens never probe and report `true`.
+   */
+  readonly sessionSupported: boolean;
+  private fetch;
+  /**
+   * COM API
+   */
+  readonly com: ComApi;
+  /**
+   * HMI API
+   */
+  readonly hmi: HmiApi;
+  /**
+   * GPIO API
+   */
+  readonly gpio: GpioApi;
+  /**
+   * Management API
+   */
+  readonly management: ManagementApi;
+  /**
+   * Power management API
+   */
+  readonly power: PowerApi;
+  /**
+   * Relays API
+   */
+  readonly relays: RelaysApi;
+  /**
+   * Real-time events API (WebSocket). Call `events.connect()` then `events.on(...)`.
+   */
+  readonly events: EventsApi;
+  /**
+   * Session API. Read the current holder via `session.state()`.
+   */
+  readonly session: SessionApi;
+  constructor(host: string, info: Information, token?: string, sessionSupported?: boolean);
+  reset(): Promise<void>;
+  protected static openBase(device: DiscoveredDevice | string, options?: OpenOptions, session?: {
+    kind: 'remote' | 'project';
+    project?: string;
+    defaultLabel?: string;
+  }): Promise<AT1000Base>;
+}
+//#endregion
+export { format_host_for_url as a, OpenOptions as i, ApiError as n, host_without_port as o, DiscoveredDevice as r, AT1000Base as t };
+//# sourceMappingURL=at1000-C6w5G8L4.d.cts.map

package/build/at1000-C6w5G8L4.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"at1000-C6w5G8L4.d.cts","names":[],"sources":["../src/at1000.ts"],"mappings":";;;;;;;;;;;cAYa,QAAA,SAAiB,KAAK;EAAA,SACxB,IAAA;EADW;EAAA,SAGX,MAAA;EAAA,SACA,UAAA;EAAA,SACA,IAAA;cAEG,IAAA;IAAQ,IAAA;IAAc,OAAA;IAAiB,UAAA;IAAoB,IAAA;EAAA;AAAA;;;;;AAAc;AAoBvF;iBAAgB,mBAAA,CAAoB,IAAA,UAAc,YAAqB;;iBAgBvD,iBAAA,CAAkB,IAAY;;UAoD7B,gBAAA;EACf,IAAA;EACA,IAAA,EAAM,WAAW;AAAA;;UAIF,WAAA;EAJE;EAMjB,QAAA;EAF0B;EAI1B,KAAK;AAAA;AAAA;AAAA,cAIM,UAAA;EAAU;;;EAAA,SAIL,IAAA;EAwBK;;;EAAA,SApBL,IAAA,EAAM,WAAA;EAoCE;;;;EAAA,SA/BR,KAAA;EA8EN;;;;EAAA,SAzEM,gBAAA;EAAA,QAER,KAAA;EAhBQ;;;EAAA,SAoBA,GAAA,EAAK,MAAA;EANL;;;EAAA,SAUA,GAAA,EAAK,MAAA;EAAL;;;EAAA,SAIA,IAAA,EAAM,OAAA;EAIN;;;EAAA,SAAA,UAAA,EAAY,aAAA;EAQZ;;;EAAA,SAJA,KAAA,EAAO,QAAA;EAYP;;;EAAA,SARA,MAAA,EAAQ,SAAA;EAUQ;;;EAAA,SANhB,MAAA,EAAQ,SAAA;EAkClB;;;EAAA,SA9BU,OAAA,EAAS,UAAA;cAEb,IAAA,UAAc,IAAA,EAAM,WAAA,EAAa,KAAA,WAAgB,gBAAA;EA4BvD,KAAA,IAAK,OAAA;EAAA,iBAQY,QAAA,CACrB,MAAA,EAAQ,gBAAA,WACR,OAAA,GAAU,WAAA,EACV,OAAA;IAAY,IAAA;IAA4B,OAAA;IAAkB,YAAA;EAAA,IACzD,OAAA,CAAQ,UAAA;AAAA"}

package/build/browser.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./at1000-BuI_g7jF.cjs");var t=class extends e.t{static apiVersion=e.n};exports.AT1000=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./package-Bcvmz2Lx.cjs"),t=require("./at1000-B_udjy0I.cjs");var n=class extends t.t{static apiVersion=e.t;static async open(e,n){return await t.t.openBase(e,n)}};exports.AT1000=n,exports.ApiError=t.n,exports.format_host_for_url=t.r,exports.host_without_port=t.i;
 //# sourceMappingURL=browser.cjs.map

package/build/browser.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"browser.cjs","names":["AT1000Base","version"],"sources":["../src/browser.ts"],"sourcesContent":["import { version } from '../package.json';\nimport { AT1000Base } from './at1000';\n\n/** @hideconstructor */\nexport class AT1000 extends AT1000Base {\n  static readonly apiVersion = version;\n}\n"],"mappings":"4GAIA,IAAa,EAAb,cAA4BA,EAAAA,CAAW,CACrC,OAAgB,WAAaC,EAAAA,CAC/B"}
+{"version":3,"file":"browser.cjs","names":["AT1000Base","version"],"sources":["../src/browser.ts"],"sourcesContent":["import { version } from '../package.json';\nimport { AT1000Base, type DiscoveredDevice, type OpenOptions } from './at1000';\n\nexport type { ProjectTemplate } from './api/management';\nexport { ApiError } from './at1000';\nexport { format_host_for_url, host_without_port } from './at1000';\nexport type { DiscoveredDevice, OpenOptions } from './at1000';\n\n/** @hideconstructor */\nexport class AT1000 extends AT1000Base {\n  static readonly apiVersion = version;\n\n  /**\n   * Opens a device, taking exclusive (remote-kind) access. The browser entry has\n   * no in-container detection and no label default; the server falls back to the\n   * client IP for the holder label.\n   */\n  static async open(device: DiscoveredDevice | string, options?: OpenOptions): Promise<AT1000> {\n    // AT1000 adds no instance state over AT1000Base; the cast is the create-era convention.\n    return (await AT1000Base.openBase(device, options)) as AT1000;\n  }\n}\n"],"mappings":"gJASA,IAAa,EAAb,cAA4BA,EAAAA,CAAW,CACrC,OAAgB,WAAaC,EAAAA,EAO7B,aAAa,KAAK,EAAmC,EAAwC,CAE3F,OAAQ,MAAMD,EAAAA,EAAW,SAAS,EAAQ,CAAO,CACnD,CACF"}

package/build/browser.d.cts

@@ -1,10 +1,17 @@
-import { t as AT1000Base } from "./at1000-BXtrf8Rt.cjs";
+import { ProjectTemplate } from "./management.cjs";
+import { a as format_host_for_url, i as OpenOptions, n as ApiError, o as host_without_port, r as DiscoveredDevice, t as AT1000Base } from "./at1000-C6w5G8L4.cjs";
 
 //#region src/browser.d.ts
 /** @hideconstructor */
 declare class AT1000 extends AT1000Base {
   static readonly apiVersion: string;
+  /**
+   * Opens a device, taking exclusive (remote-kind) access. The browser entry has
+   * no in-container detection and no label default; the server falls back to the
+   * client IP for the holder label.
+   */
+  static open(device: DiscoveredDevice | string, options?: OpenOptions): Promise<AT1000>;
 }
 //#endregion
-export { AT1000 };
+export { AT1000, ApiError, type DiscoveredDevice, type OpenOptions, type ProjectTemplate, format_host_for_url, host_without_port };
 //# sourceMappingURL=browser.d.cts.map

package/build/browser.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.cts","names":[],"sources":["../src/browser.ts"],"mappings":";;;;cAIa,MAAA,SAAe,UAAU;EAAA,gBACpB,UAAU;AAAA"}
+{"version":3,"file":"browser.d.cts","names":[],"sources":["../src/browser.ts"],"mappings":";;;;;cASa,MAAA,SAAe,UAAA;EAAA,gBACV,UAAA;EAO+C;;;;;EAAA,OAAlD,IAAA,CAAK,MAAA,EAAQ,gBAAA,WAA2B,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,MAAA;AAAA"}

package/build/browser.d.mts

@@ -1,10 +1,17 @@
-import { t as AT1000Base } from "./at1000-D_rOUVFH.mjs";
+import { ProjectTemplate } from "./management.mjs";
+import { a as format_host_for_url, i as OpenOptions, n as ApiError, o as host_without_port, r as DiscoveredDevice, t as AT1000Base } from "./at1000-B3HgANSi.mjs";
 
 //#region src/browser.d.ts
 /** @hideconstructor */
 declare class AT1000 extends AT1000Base {
   static readonly apiVersion: string;
+  /**
+   * Opens a device, taking exclusive (remote-kind) access. The browser entry has
+   * no in-container detection and no label default; the server falls back to the
+   * client IP for the holder label.
+   */
+  static open(device: DiscoveredDevice | string, options?: OpenOptions): Promise<AT1000>;
 }
 //#endregion
-export { AT1000 };
+export { AT1000, ApiError, type DiscoveredDevice, type OpenOptions, type ProjectTemplate, format_host_for_url, host_without_port };
 //# sourceMappingURL=browser.d.mts.map

package/build/browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/browser.ts"],"mappings":";;;;cAIa,MAAA,SAAe,UAAU;EAAA,gBACpB,UAAU;AAAA"}
+{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/browser.ts"],"mappings":";;;;;cASa,MAAA,SAAe,UAAA;EAAA,gBACV,UAAA;EAO+C;;;;;EAAA,OAAlD,IAAA,CAAK,MAAA,EAAQ,gBAAA,WAA2B,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,MAAA;AAAA"}

package/build/browser.mjs

@@ -1,2 +1,2 @@
-import{n as e,t}from"./at1000-DVDltAyk.mjs";var n=class extends t{static apiVersion=e};export{n as AT1000};
+import{t as e}from"./package-CN49oc-F.mjs";import{i as t,n,r,t as i}from"./at1000-BjVj0Ujk.mjs";var a=class extends i{static apiVersion=e;static async open(e,t){return await i.openBase(e,t)}};export{a as AT1000,n as ApiError,r as format_host_for_url,t as host_without_port};
 //# sourceMappingURL=browser.mjs.map

package/build/browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"browser.mjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["import { version } from '../package.json';\nimport { AT1000Base } from './at1000';\n\n/** @hideconstructor */\nexport class AT1000 extends AT1000Base {\n  static readonly apiVersion = version;\n}\n"],"mappings":"4CAIA,IAAa,EAAb,cAA4B,CAAW,CACrC,OAAgB,WAAa,CAC/B"}
+{"version":3,"file":"browser.mjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["import { version } from '../package.json';\nimport { AT1000Base, type DiscoveredDevice, type OpenOptions } from './at1000';\n\nexport type { ProjectTemplate } from './api/management';\nexport { ApiError } from './at1000';\nexport { format_host_for_url, host_without_port } from './at1000';\nexport type { DiscoveredDevice, OpenOptions } from './at1000';\n\n/** @hideconstructor */\nexport class AT1000 extends AT1000Base {\n  static readonly apiVersion = version;\n\n  /**\n   * Opens a device, taking exclusive (remote-kind) access. The browser entry has\n   * no in-container detection and no label default; the server falls back to the\n   * client IP for the holder label.\n   */\n  static async open(device: DiscoveredDevice | string, options?: OpenOptions): Promise<AT1000> {\n    // AT1000 adds no instance state over AT1000Base; the cast is the create-era convention.\n    return (await AT1000Base.openBase(device, options)) as AT1000;\n  }\n}\n"],"mappings":"gGASA,IAAa,EAAb,cAA4B,CAAW,CACrC,OAAgB,WAAa,EAO7B,aAAa,KAAK,EAAmC,EAAwC,CAE3F,OAAQ,MAAM,EAAW,SAAS,EAAQ,CAAO,CACnD,CACF"}