spider-farmer-api-client 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 factro
+
+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,45 @@
+# spider-farmer-api-client
+
+Typisierter HTTP-Client für kompatible Spider-Farmer-HTTP-Endpunkte. Das Paket
+ist unabhängig installierbar und öffnet selbst keine BLE- oder MQTT-Verbindung
+zum Controller.
+
+Vorausgesetzt werden Node.js 20 oder neuer und ein kompatibler HTTP-Dienst mit
+der `/v1`-Schnittstelle.
+
+## Installation
+
+```sh
+npm install spider-farmer-api-client
+```
+
+## Verwendung
+
+```ts
+import { SpiderFarmerApiClient } from "spider-farmer-api-client";
+
+const ggs = new SpiderFarmerApiClient({
+  baseUrl: "http://127.0.0.1:8787",
+  token: process.env.SPIDER_FARMER_API_TOKEN,
+});
+
+const state = await ggs.getState();
+console.log(state.sensors.airTemperature);
+
+await ggs.setLight("light", { on: true, level: 70 });
+await ggs.setCirculationFan({ on: true, level: 4 });
+```
+
+`baseUrl` enthält Schema, Host und optional den Port (ein vorhandener Pfad bleibt erhalten); der Client ergänzt `/v1` automatisch.
+
+Mehrere Anwendungen können denselben HTTP-Dienst verwenden. `watch()` fragt
+nur dessen Zustand ab und erzeugt keine zusätzliche Verbindung zum Gerät:
+
+```ts
+const stop = ggs.watch(
+  (nextState) => console.log(nextState.sensors),
+  { intervalMs: 2_000, onError: console.error },
+);
+
+// stop();
+```

package/dist/index.cjs

@@ -0,0 +1,160 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/contract.ts
+const SPIDER_FARMER_API_PATH = "/v1";
+//#endregion
+//#region src/client.ts
+var SpiderFarmerApiError = class extends Error {
+	status;
+	code;
+	details;
+	constructor(message, status, code, details) {
+		super(message);
+		this.name = "SpiderFarmerApiError";
+		this.status = status;
+		this.code = code;
+		this.details = details;
+	}
+};
+var SpiderFarmerApiClient = class {
+	#baseUrl;
+	#token;
+	#headers;
+	#timeoutMs;
+	#fetch;
+	constructor(options) {
+		if (!options.baseUrl.trim()) throw new TypeError("baseUrl must not be empty");
+		this.#baseUrl = options.baseUrl.replace(/\/+$/, "");
+		this.#token = options.token;
+		this.#headers = options.headers ?? {};
+		this.#timeoutMs = options.timeoutMs ?? 3e4;
+		this.#fetch = options.fetch ?? globalThis.fetch;
+		if (!this.#fetch) throw new TypeError("No fetch implementation is available");
+	}
+	health() {
+		return this.#request("/health");
+	}
+	getState() {
+		return this.#request("/state");
+	}
+	refresh() {
+		return this.#request("/refresh", { method: "POST" });
+	}
+	getConfiguration() {
+		return this.#request("/configuration");
+	}
+	setConfiguration(configuration, options = {}) {
+		return this.#write("/configuration", {
+			configuration,
+			options
+		}, "PUT");
+	}
+	setConfigField(keyPath, value, options = {}) {
+		return this.#write("/configuration/field", {
+			keyPath,
+			value,
+			options
+		}, "PATCH");
+	}
+	setLight(module, patch, options = {}) {
+		return this.#write(`/lights/${module}`, {
+			patch,
+			options
+		});
+	}
+	setFan(module, patch, options = {}) {
+		return this.#write(`/fans/${module}`, {
+			patch,
+			options
+		});
+	}
+	setCirculationFan(patch, options = {}) {
+		return this.setFan("fan", patch, options);
+	}
+	setExhaustFan(patch, options = {}) {
+		return this.setFan("blower", patch, options);
+	}
+	setClimate(module, patch, options = {}) {
+		return this.#write(`/climate/${module}`, {
+			patch,
+			options
+		});
+	}
+	setOutlet(outlet, patch, options = {}) {
+		const id = typeof outlet === "number" ? `O${outlet}` : outlet.toUpperCase();
+		return this.#write(`/outlets/${id}`, {
+			patch,
+			options
+		});
+	}
+	request(message, options = {}) {
+		return this.#request("/request", {
+			method: "POST",
+			body: JSON.stringify({
+				message,
+				options
+			})
+		});
+	}
+	/** Poll the central API without opening another controller connection. */
+	watch(listener, options = {}) {
+		const intervalMs = options.intervalMs ?? 2e3;
+		if (!Number.isFinite(intervalMs) || intervalMs < 100) throw new RangeError("watch intervalMs must be at least 100 ms");
+		let active = true;
+		let running = false;
+		const poll = async () => {
+			if (!active || running) return;
+			running = true;
+			try {
+				await listener(await this.getState());
+			} catch (error) {
+				options.onError?.(asError(error));
+			} finally {
+				running = false;
+			}
+		};
+		poll();
+		const timer = setInterval(() => void poll(), intervalMs);
+		return () => {
+			active = false;
+			clearInterval(timer);
+		};
+	}
+	async #write(path, body, method = "POST") {
+		await this.#request(path, {
+			method,
+			body: JSON.stringify(body)
+		});
+	}
+	async #request(path, init = {}) {
+		const headers = new Headers(this.#headers);
+		headers.set("accept", "application/json");
+		if (init.body !== void 0) headers.set("content-type", "application/json");
+		if (this.#token) headers.set("authorization", `Bearer ${this.#token}`);
+		let response;
+		try {
+			response = await this.#fetch(`${this.#baseUrl}/v1${path}`, {
+				...init,
+				headers,
+				signal: AbortSignal.timeout(this.#timeoutMs)
+			});
+		} catch (error) {
+			throw new SpiderFarmerApiError(asError(error).message, 0, "NETWORK_ERROR", error);
+		}
+		const payload = await response.json().catch(() => void 0);
+		if (!response.ok) {
+			const failure = payload && "error" in payload ? payload.error : void 0;
+			throw new SpiderFarmerApiError(failure?.message ?? `API request failed with HTTP ${response.status}`, response.status, failure?.code ?? "HTTP_ERROR", failure?.details);
+		}
+		if (!payload || !("data" in payload)) throw new SpiderFarmerApiError("API returned an invalid response", response.status, "INVALID_RESPONSE");
+		return payload.data;
+	}
+};
+function asError(value) {
+	return value instanceof Error ? value : new Error(String(value));
+}
+//#endregion
+exports.SPIDER_FARMER_API_PATH = SPIDER_FARMER_API_PATH;
+exports.SpiderFarmerApiClient = SpiderFarmerApiClient;
+exports.SpiderFarmerApiError = SpiderFarmerApiError;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["#baseUrl","#token","#headers","#timeoutMs","#fetch","#request","#write"],"sources":["../src/contract.ts","../src/client.ts"],"sourcesContent":["export const SPIDER_FARMER_API_PATH = \"/v1\";\n\nexport interface ApiSuccess<T> {\n  data: T;\n}\n\nexport interface ApiFailure {\n  error: {\n    code: string;\n    message: string;\n    details?: unknown;\n  };\n}\n","import { SPIDER_FARMER_API_PATH, type ApiFailure, type ApiSuccess } from \"./contract.js\";\nimport type {\n  ApiHealth,\n  ClimateControl,\n  ClimateModule,\n  FanControl,\n  FanModule,\n  JsonObject,\n  LightControl,\n  LightModule,\n  OutletControl,\n  RawRequestOptions,\n  SetConfigurationOptions,\n  SpiderFarmerMessage,\n  SpiderFarmerState,\n  WriteOptions,\n} from \"./types.js\";\n\nexport interface SpiderFarmerApiClientOptions {\n  /** Base URL of the central API, for example `http://127.0.0.1:8787`. */\n  baseUrl: string;\n  /** Optional bearer token configured on the API server. */\n  token?: string;\n  /** Additional headers sent with every request. */\n  headers?: Readonly<Record<string, string>>;\n  /** Request timeout. Default: 30000 ms. */\n  timeoutMs?: number;\n  /** Custom fetch implementation, primarily for tests or runtimes without global fetch. */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport interface WatchOptions {\n  /** Polling interval against the API. Default: 2000 ms. */\n  intervalMs?: number;\n  onError?: (error: Error) => void;\n}\n\nexport class SpiderFarmerApiError extends Error {\n  public readonly status: number;\n  public readonly code: string;\n  public readonly details: unknown;\n\n  public constructor(message: string, status: number, code: string, details?: unknown) {\n    super(message);\n    this.name = \"SpiderFarmerApiError\";\n    this.status = status;\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport class SpiderFarmerApiClient {\n  readonly #baseUrl: string;\n  readonly #token: string | undefined;\n  readonly #headers: Readonly<Record<string, string>>;\n  readonly #timeoutMs: number;\n  readonly #fetch: typeof globalThis.fetch;\n\n  public constructor(options: SpiderFarmerApiClientOptions) {\n    if (!options.baseUrl.trim()) throw new TypeError(\"baseUrl must not be empty\");\n    this.#baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.#token = options.token;\n    this.#headers = options.headers ?? {};\n    this.#timeoutMs = options.timeoutMs ?? 30_000;\n    this.#fetch = options.fetch ?? globalThis.fetch;\n    if (!this.#fetch) throw new TypeError(\"No fetch implementation is available\");\n  }\n\n  public health(): Promise<ApiHealth> {\n    return this.#request(\"/health\");\n  }\n\n  public getState(): Promise<SpiderFarmerState> {\n    return this.#request(\"/state\");\n  }\n\n  public refresh(): Promise<SpiderFarmerState> {\n    return this.#request(\"/refresh\", { method: \"POST\" });\n  }\n\n  public getConfiguration(): Promise<JsonObject> {\n    return this.#request(\"/configuration\");\n  }\n\n  public setConfiguration(\n    configuration: JsonObject,\n    options: SetConfigurationOptions = {},\n  ): Promise<void> {\n    return this.#write(\"/configuration\", { configuration, options }, \"PUT\");\n  }\n\n  public setConfigField(\n    keyPath: readonly string[],\n    value: JsonObject,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(\"/configuration/field\", { keyPath, value, options }, \"PATCH\");\n  }\n\n  public setLight(\n    module: LightModule,\n    patch: LightControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(`/lights/${module}`, { patch, options });\n  }\n\n  public setFan(\n    module: FanModule,\n    patch: FanControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(`/fans/${module}`, { patch, options });\n  }\n\n  public setCirculationFan(patch: FanControl, options: WriteOptions = {}): Promise<void> {\n    return this.setFan(\"fan\", patch, options);\n  }\n\n  public setExhaustFan(patch: FanControl, options: WriteOptions = {}): Promise<void> {\n    return this.setFan(\"blower\", patch, options);\n  }\n\n  public setClimate(\n    module: ClimateModule,\n    patch: ClimateControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(`/climate/${module}`, { patch, options });\n  }\n\n  public setOutlet(\n    outlet: number | `O${number}`,\n    patch: boolean | OutletControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    const id = typeof outlet === \"number\" ? `O${outlet}` : outlet.toUpperCase();\n    return this.#write(`/outlets/${id}`, { patch, options });\n  }\n\n  public request(\n    message: SpiderFarmerMessage,\n    options: RawRequestOptions = {},\n  ): Promise<SpiderFarmerMessage> {\n    return this.#request(\"/request\", {\n      method: \"POST\",\n      body: JSON.stringify({ message, options }),\n    });\n  }\n\n  /** Poll the central API without opening another controller connection. */\n  public watch(\n    listener: (state: SpiderFarmerState) => void | Promise<void>,\n    options: WatchOptions = {},\n  ): () => void {\n    const intervalMs = options.intervalMs ?? 2_000;\n    if (!Number.isFinite(intervalMs) || intervalMs < 100) {\n      throw new RangeError(\"watch intervalMs must be at least 100 ms\");\n    }\n    let active = true;\n    let running = false;\n    const poll = async (): Promise<void> => {\n      if (!active || running) return;\n      running = true;\n      try {\n        await listener(await this.getState());\n      } catch (error) {\n        options.onError?.(asError(error));\n      } finally {\n        running = false;\n      }\n    };\n    void poll();\n    const timer = setInterval(() => void poll(), intervalMs);\n    return () => {\n      active = false;\n      clearInterval(timer);\n    };\n  }\n\n  async #write(path: string, body: unknown, method = \"POST\"): Promise<void> {\n    await this.#request<null>(path, { method, body: JSON.stringify(body) });\n  }\n\n  async #request<T>(path: string, init: RequestInit = {}): Promise<T> {\n    const headers = new Headers(this.#headers);\n    headers.set(\"accept\", \"application/json\");\n    if (init.body !== undefined) headers.set(\"content-type\", \"application/json\");\n    if (this.#token) headers.set(\"authorization\", `Bearer ${this.#token}`);\n\n    let response: Response;\n    try {\n      response = await this.#fetch(`${this.#baseUrl}${SPIDER_FARMER_API_PATH}${path}`, {\n        ...init,\n        headers,\n        signal: AbortSignal.timeout(this.#timeoutMs),\n      });\n    } catch (error) {\n      throw new SpiderFarmerApiError(asError(error).message, 0, \"NETWORK_ERROR\", error);\n    }\n\n    const payload = (await response.json().catch(() => undefined)) as\n      | ApiSuccess<T>\n      | ApiFailure\n      | undefined;\n    if (!response.ok) {\n      const failure = payload && \"error\" in payload ? payload.error : undefined;\n      throw new SpiderFarmerApiError(\n        failure?.message ?? `API request failed with HTTP ${response.status}`,\n        response.status,\n        failure?.code ?? \"HTTP_ERROR\",\n        failure?.details,\n      );\n    }\n    if (!payload || !(\"data\" in payload)) {\n      throw new SpiderFarmerApiError(\"API returned an invalid response\", response.status, \"INVALID_RESPONSE\");\n    }\n    return payload.data;\n  }\n}\n\nfunction asError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value));\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,235 @@
+//#region src/types.d.ts
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+  [key: string]: JsonValue | undefined;
+}
+type LightModule = "light" | "light2";
+type FanModule = "fan" | "blower";
+type ClimateModule = "heater" | "humidifier" | "dehumidifier";
+interface TimePeriod extends JsonObject {
+  enabled?: number;
+  weekmask?: number;
+  startTime?: number;
+  endTime?: number;
+  brightness?: number;
+  fadeTime?: number;
+}
+interface CyclePeriod extends JsonObject {
+  weekmask?: number;
+  startTime?: number;
+  openDur?: number;
+  closeDur?: number;
+  times?: number;
+}
+interface SensorState {
+  airTemperature?: number;
+  humidity?: number;
+  vpd?: number;
+  co2?: number;
+  ppfd?: number;
+  soilTemperature?: number;
+  soilMoisture?: number;
+  soilEc?: number;
+  raw: JsonObject;
+}
+interface SoilSensorState {
+  id: string;
+  temperature?: number;
+  moisture?: number;
+  ec?: number;
+  name?: string;
+  raw: JsonObject;
+}
+interface LightState {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  lastAutoMode?: number;
+  schedule?: TimePeriod;
+  ppfdSchedule?: TimePeriod;
+  ppfdMinBrightness?: number;
+  ppfdMaxBrightness?: number;
+  dimThreshold?: number;
+  offThreshold?: number;
+  raw: JsonObject;
+}
+interface FanState {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  minSpeed?: number;
+  maxSpeed?: number;
+  oscillation?: number;
+  naturalWind?: boolean;
+  closeCo2?: boolean;
+  schedule?: TimePeriod;
+  cycle?: CyclePeriod;
+  raw: JsonObject;
+}
+interface ClimateState {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  raw: JsonObject;
+}
+interface OutletState {
+  id: string;
+  on?: boolean;
+  mode?: number;
+  raw: JsonObject;
+}
+interface SystemState {
+  firmwareVersion?: string;
+  wifiRssi?: number;
+  uptime?: number;
+  freeMemory?: number;
+  raw: JsonObject;
+}
+interface SpiderFarmerMessage extends JsonObject {
+  method: string;
+  code?: number;
+  data?: JsonObject;
+  params?: JsonObject;
+  msgId?: string;
+  pid?: string;
+  uid?: string;
+  pcode?: number;
+  UTC?: number;
+}
+/** JSON representation returned by the central HTTP API. */
+interface SpiderFarmerState {
+  device: {
+    pid: string;
+    uid?: string;
+    pcode?: number;
+    online: boolean;
+    lastSeen?: string;
+  };
+  sensors: SensorState;
+  soilSensors: Record<string, SoilSensorState>;
+  actuators: {
+    lights: Partial<Record<LightModule, LightState>>;
+    fans: Partial<Record<FanModule, FanState>>;
+    climate: Partial<Record<ClimateModule, ClimateState>>;
+    outlets: Record<string, OutletState>;
+  };
+  system?: SystemState;
+  configuration?: JsonObject;
+  lastMessage?: SpiderFarmerMessage;
+}
+type LightMode = "manual" | "schedule" | "ppfd" | number;
+type FanMode = "manual" | "schedule" | "cycle" | "temperature" | "humidity" | "prioritize-temperature" | "prioritize-humidity" | "temperature-and-humidity" | number;
+interface LightControl {
+  on?: boolean;
+  level?: number;
+  mode?: LightMode;
+  schedule?: Partial<TimePeriod>;
+  ppfdSchedule?: Partial<TimePeriod>;
+  ppfdMinBrightness?: number;
+  ppfdMaxBrightness?: number;
+  dimThreshold?: number;
+  offThreshold?: number;
+  raw?: JsonObject;
+}
+interface FanControl {
+  on?: boolean;
+  level?: number;
+  mode?: FanMode;
+  minSpeed?: number;
+  maxSpeed?: number;
+  oscillation?: number;
+  naturalWind?: boolean;
+  closeCo2?: boolean;
+  schedule?: Partial<TimePeriod>;
+  cycle?: Partial<CyclePeriod>;
+  raw?: JsonObject;
+}
+interface ClimateControl {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  raw?: JsonObject;
+}
+interface OutletControl {
+  on?: boolean;
+  mode?: number;
+  raw?: JsonObject;
+}
+interface WriteOptions {
+  verify?: boolean;
+  strategy?: "field" | "file" | "auto";
+}
+interface SetConfigurationOptions {
+  unsafeAllowPartial?: boolean;
+  verify?: boolean;
+}
+interface RawRequestOptions {
+  timeoutMs?: number;
+  awaitResponse?: boolean;
+}
+interface ApiHealth {
+  status: "ok";
+  connected: boolean;
+  deviceOnline: boolean;
+}
+//#endregion
+//#region src/client.d.ts
+interface SpiderFarmerApiClientOptions {
+  /** Base URL of the central API, for example `http://127.0.0.1:8787`. */
+  baseUrl: string;
+  /** Optional bearer token configured on the API server. */
+  token?: string;
+  /** Additional headers sent with every request. */
+  headers?: Readonly<Record<string, string>>;
+  /** Request timeout. Default: 30000 ms. */
+  timeoutMs?: number;
+  /** Custom fetch implementation, primarily for tests or runtimes without global fetch. */
+  fetch?: typeof globalThis.fetch;
+}
+interface WatchOptions {
+  /** Polling interval against the API. Default: 2000 ms. */
+  intervalMs?: number;
+  onError?: (error: Error) => void;
+}
+declare class SpiderFarmerApiError extends Error {
+  readonly status: number;
+  readonly code: string;
+  readonly details: unknown;
+  constructor(message: string, status: number, code: string, details?: unknown);
+}
+declare class SpiderFarmerApiClient {
+  #private;
+  constructor(options: SpiderFarmerApiClientOptions);
+  health(): Promise<ApiHealth>;
+  getState(): Promise<SpiderFarmerState>;
+  refresh(): Promise<SpiderFarmerState>;
+  getConfiguration(): Promise<JsonObject>;
+  setConfiguration(configuration: JsonObject, options?: SetConfigurationOptions): Promise<void>;
+  setConfigField(keyPath: readonly string[], value: JsonObject, options?: WriteOptions): Promise<void>;
+  setLight(module: LightModule, patch: LightControl, options?: WriteOptions): Promise<void>;
+  setFan(module: FanModule, patch: FanControl, options?: WriteOptions): Promise<void>;
+  setCirculationFan(patch: FanControl, options?: WriteOptions): Promise<void>;
+  setExhaustFan(patch: FanControl, options?: WriteOptions): Promise<void>;
+  setClimate(module: ClimateModule, patch: ClimateControl, options?: WriteOptions): Promise<void>;
+  setOutlet(outlet: number | `O${number}`, patch: boolean | OutletControl, options?: WriteOptions): Promise<void>;
+  request(message: SpiderFarmerMessage, options?: RawRequestOptions): Promise<SpiderFarmerMessage>;
+  /** Poll the central API without opening another controller connection. */
+  watch(listener: (state: SpiderFarmerState) => void | Promise<void>, options?: WatchOptions): () => void;
+}
+//#endregion
+//#region src/contract.d.ts
+declare const SPIDER_FARMER_API_PATH = "/v1";
+interface ApiSuccess<T> {
+  data: T;
+}
+interface ApiFailure {
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}
+//#endregion
+export { type ApiFailure, ApiHealth, type ApiSuccess, ClimateControl, ClimateModule, ClimateState, CyclePeriod, FanControl, FanMode, FanModule, FanState, JsonObject, JsonPrimitive, JsonValue, LightControl, LightMode, LightModule, LightState, OutletControl, OutletState, RawRequestOptions, SPIDER_FARMER_API_PATH, SensorState, SetConfigurationOptions, SoilSensorState, SpiderFarmerApiClient, type SpiderFarmerApiClientOptions, SpiderFarmerApiError, SpiderFarmerMessage, SpiderFarmerState, SystemState, TimePeriod, type WatchOptions, WriteOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/contract.ts"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,235 @@
+//#region src/types.d.ts
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+  [key: string]: JsonValue | undefined;
+}
+type LightModule = "light" | "light2";
+type FanModule = "fan" | "blower";
+type ClimateModule = "heater" | "humidifier" | "dehumidifier";
+interface TimePeriod extends JsonObject {
+  enabled?: number;
+  weekmask?: number;
+  startTime?: number;
+  endTime?: number;
+  brightness?: number;
+  fadeTime?: number;
+}
+interface CyclePeriod extends JsonObject {
+  weekmask?: number;
+  startTime?: number;
+  openDur?: number;
+  closeDur?: number;
+  times?: number;
+}
+interface SensorState {
+  airTemperature?: number;
+  humidity?: number;
+  vpd?: number;
+  co2?: number;
+  ppfd?: number;
+  soilTemperature?: number;
+  soilMoisture?: number;
+  soilEc?: number;
+  raw: JsonObject;
+}
+interface SoilSensorState {
+  id: string;
+  temperature?: number;
+  moisture?: number;
+  ec?: number;
+  name?: string;
+  raw: JsonObject;
+}
+interface LightState {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  lastAutoMode?: number;
+  schedule?: TimePeriod;
+  ppfdSchedule?: TimePeriod;
+  ppfdMinBrightness?: number;
+  ppfdMaxBrightness?: number;
+  dimThreshold?: number;
+  offThreshold?: number;
+  raw: JsonObject;
+}
+interface FanState {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  minSpeed?: number;
+  maxSpeed?: number;
+  oscillation?: number;
+  naturalWind?: boolean;
+  closeCo2?: boolean;
+  schedule?: TimePeriod;
+  cycle?: CyclePeriod;
+  raw: JsonObject;
+}
+interface ClimateState {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  raw: JsonObject;
+}
+interface OutletState {
+  id: string;
+  on?: boolean;
+  mode?: number;
+  raw: JsonObject;
+}
+interface SystemState {
+  firmwareVersion?: string;
+  wifiRssi?: number;
+  uptime?: number;
+  freeMemory?: number;
+  raw: JsonObject;
+}
+interface SpiderFarmerMessage extends JsonObject {
+  method: string;
+  code?: number;
+  data?: JsonObject;
+  params?: JsonObject;
+  msgId?: string;
+  pid?: string;
+  uid?: string;
+  pcode?: number;
+  UTC?: number;
+}
+/** JSON representation returned by the central HTTP API. */
+interface SpiderFarmerState {
+  device: {
+    pid: string;
+    uid?: string;
+    pcode?: number;
+    online: boolean;
+    lastSeen?: string;
+  };
+  sensors: SensorState;
+  soilSensors: Record<string, SoilSensorState>;
+  actuators: {
+    lights: Partial<Record<LightModule, LightState>>;
+    fans: Partial<Record<FanModule, FanState>>;
+    climate: Partial<Record<ClimateModule, ClimateState>>;
+    outlets: Record<string, OutletState>;
+  };
+  system?: SystemState;
+  configuration?: JsonObject;
+  lastMessage?: SpiderFarmerMessage;
+}
+type LightMode = "manual" | "schedule" | "ppfd" | number;
+type FanMode = "manual" | "schedule" | "cycle" | "temperature" | "humidity" | "prioritize-temperature" | "prioritize-humidity" | "temperature-and-humidity" | number;
+interface LightControl {
+  on?: boolean;
+  level?: number;
+  mode?: LightMode;
+  schedule?: Partial<TimePeriod>;
+  ppfdSchedule?: Partial<TimePeriod>;
+  ppfdMinBrightness?: number;
+  ppfdMaxBrightness?: number;
+  dimThreshold?: number;
+  offThreshold?: number;
+  raw?: JsonObject;
+}
+interface FanControl {
+  on?: boolean;
+  level?: number;
+  mode?: FanMode;
+  minSpeed?: number;
+  maxSpeed?: number;
+  oscillation?: number;
+  naturalWind?: boolean;
+  closeCo2?: boolean;
+  schedule?: Partial<TimePeriod>;
+  cycle?: Partial<CyclePeriod>;
+  raw?: JsonObject;
+}
+interface ClimateControl {
+  on?: boolean;
+  level?: number;
+  mode?: number;
+  raw?: JsonObject;
+}
+interface OutletControl {
+  on?: boolean;
+  mode?: number;
+  raw?: JsonObject;
+}
+interface WriteOptions {
+  verify?: boolean;
+  strategy?: "field" | "file" | "auto";
+}
+interface SetConfigurationOptions {
+  unsafeAllowPartial?: boolean;
+  verify?: boolean;
+}
+interface RawRequestOptions {
+  timeoutMs?: number;
+  awaitResponse?: boolean;
+}
+interface ApiHealth {
+  status: "ok";
+  connected: boolean;
+  deviceOnline: boolean;
+}
+//#endregion
+//#region src/client.d.ts
+interface SpiderFarmerApiClientOptions {
+  /** Base URL of the central API, for example `http://127.0.0.1:8787`. */
+  baseUrl: string;
+  /** Optional bearer token configured on the API server. */
+  token?: string;
+  /** Additional headers sent with every request. */
+  headers?: Readonly<Record<string, string>>;
+  /** Request timeout. Default: 30000 ms. */
+  timeoutMs?: number;
+  /** Custom fetch implementation, primarily for tests or runtimes without global fetch. */
+  fetch?: typeof globalThis.fetch;
+}
+interface WatchOptions {
+  /** Polling interval against the API. Default: 2000 ms. */
+  intervalMs?: number;
+  onError?: (error: Error) => void;
+}
+declare class SpiderFarmerApiError extends Error {
+  readonly status: number;
+  readonly code: string;
+  readonly details: unknown;
+  constructor(message: string, status: number, code: string, details?: unknown);
+}
+declare class SpiderFarmerApiClient {
+  #private;
+  constructor(options: SpiderFarmerApiClientOptions);
+  health(): Promise<ApiHealth>;
+  getState(): Promise<SpiderFarmerState>;
+  refresh(): Promise<SpiderFarmerState>;
+  getConfiguration(): Promise<JsonObject>;
+  setConfiguration(configuration: JsonObject, options?: SetConfigurationOptions): Promise<void>;
+  setConfigField(keyPath: readonly string[], value: JsonObject, options?: WriteOptions): Promise<void>;
+  setLight(module: LightModule, patch: LightControl, options?: WriteOptions): Promise<void>;
+  setFan(module: FanModule, patch: FanControl, options?: WriteOptions): Promise<void>;
+  setCirculationFan(patch: FanControl, options?: WriteOptions): Promise<void>;
+  setExhaustFan(patch: FanControl, options?: WriteOptions): Promise<void>;
+  setClimate(module: ClimateModule, patch: ClimateControl, options?: WriteOptions): Promise<void>;
+  setOutlet(outlet: number | `O${number}`, patch: boolean | OutletControl, options?: WriteOptions): Promise<void>;
+  request(message: SpiderFarmerMessage, options?: RawRequestOptions): Promise<SpiderFarmerMessage>;
+  /** Poll the central API without opening another controller connection. */
+  watch(listener: (state: SpiderFarmerState) => void | Promise<void>, options?: WatchOptions): () => void;
+}
+//#endregion
+//#region src/contract.d.ts
+declare const SPIDER_FARMER_API_PATH = "/v1";
+interface ApiSuccess<T> {
+  data: T;
+}
+interface ApiFailure {
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}
+//#endregion
+export { type ApiFailure, ApiHealth, type ApiSuccess, ClimateControl, ClimateModule, ClimateState, CyclePeriod, FanControl, FanMode, FanModule, FanState, JsonObject, JsonPrimitive, JsonValue, LightControl, LightMode, LightModule, LightState, OutletControl, OutletState, RawRequestOptions, SPIDER_FARMER_API_PATH, SensorState, SetConfigurationOptions, SoilSensorState, SpiderFarmerApiClient, type SpiderFarmerApiClientOptions, SpiderFarmerApiError, SpiderFarmerMessage, SpiderFarmerState, SystemState, TimePeriod, type WatchOptions, WriteOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/contract.ts"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,157 @@
+//#region src/contract.ts
+const SPIDER_FARMER_API_PATH = "/v1";
+//#endregion
+//#region src/client.ts
+var SpiderFarmerApiError = class extends Error {
+	status;
+	code;
+	details;
+	constructor(message, status, code, details) {
+		super(message);
+		this.name = "SpiderFarmerApiError";
+		this.status = status;
+		this.code = code;
+		this.details = details;
+	}
+};
+var SpiderFarmerApiClient = class {
+	#baseUrl;
+	#token;
+	#headers;
+	#timeoutMs;
+	#fetch;
+	constructor(options) {
+		if (!options.baseUrl.trim()) throw new TypeError("baseUrl must not be empty");
+		this.#baseUrl = options.baseUrl.replace(/\/+$/, "");
+		this.#token = options.token;
+		this.#headers = options.headers ?? {};
+		this.#timeoutMs = options.timeoutMs ?? 3e4;
+		this.#fetch = options.fetch ?? globalThis.fetch;
+		if (!this.#fetch) throw new TypeError("No fetch implementation is available");
+	}
+	health() {
+		return this.#request("/health");
+	}
+	getState() {
+		return this.#request("/state");
+	}
+	refresh() {
+		return this.#request("/refresh", { method: "POST" });
+	}
+	getConfiguration() {
+		return this.#request("/configuration");
+	}
+	setConfiguration(configuration, options = {}) {
+		return this.#write("/configuration", {
+			configuration,
+			options
+		}, "PUT");
+	}
+	setConfigField(keyPath, value, options = {}) {
+		return this.#write("/configuration/field", {
+			keyPath,
+			value,
+			options
+		}, "PATCH");
+	}
+	setLight(module, patch, options = {}) {
+		return this.#write(`/lights/${module}`, {
+			patch,
+			options
+		});
+	}
+	setFan(module, patch, options = {}) {
+		return this.#write(`/fans/${module}`, {
+			patch,
+			options
+		});
+	}
+	setCirculationFan(patch, options = {}) {
+		return this.setFan("fan", patch, options);
+	}
+	setExhaustFan(patch, options = {}) {
+		return this.setFan("blower", patch, options);
+	}
+	setClimate(module, patch, options = {}) {
+		return this.#write(`/climate/${module}`, {
+			patch,
+			options
+		});
+	}
+	setOutlet(outlet, patch, options = {}) {
+		const id = typeof outlet === "number" ? `O${outlet}` : outlet.toUpperCase();
+		return this.#write(`/outlets/${id}`, {
+			patch,
+			options
+		});
+	}
+	request(message, options = {}) {
+		return this.#request("/request", {
+			method: "POST",
+			body: JSON.stringify({
+				message,
+				options
+			})
+		});
+	}
+	/** Poll the central API without opening another controller connection. */
+	watch(listener, options = {}) {
+		const intervalMs = options.intervalMs ?? 2e3;
+		if (!Number.isFinite(intervalMs) || intervalMs < 100) throw new RangeError("watch intervalMs must be at least 100 ms");
+		let active = true;
+		let running = false;
+		const poll = async () => {
+			if (!active || running) return;
+			running = true;
+			try {
+				await listener(await this.getState());
+			} catch (error) {
+				options.onError?.(asError(error));
+			} finally {
+				running = false;
+			}
+		};
+		poll();
+		const timer = setInterval(() => void poll(), intervalMs);
+		return () => {
+			active = false;
+			clearInterval(timer);
+		};
+	}
+	async #write(path, body, method = "POST") {
+		await this.#request(path, {
+			method,
+			body: JSON.stringify(body)
+		});
+	}
+	async #request(path, init = {}) {
+		const headers = new Headers(this.#headers);
+		headers.set("accept", "application/json");
+		if (init.body !== void 0) headers.set("content-type", "application/json");
+		if (this.#token) headers.set("authorization", `Bearer ${this.#token}`);
+		let response;
+		try {
+			response = await this.#fetch(`${this.#baseUrl}/v1${path}`, {
+				...init,
+				headers,
+				signal: AbortSignal.timeout(this.#timeoutMs)
+			});
+		} catch (error) {
+			throw new SpiderFarmerApiError(asError(error).message, 0, "NETWORK_ERROR", error);
+		}
+		const payload = await response.json().catch(() => void 0);
+		if (!response.ok) {
+			const failure = payload && "error" in payload ? payload.error : void 0;
+			throw new SpiderFarmerApiError(failure?.message ?? `API request failed with HTTP ${response.status}`, response.status, failure?.code ?? "HTTP_ERROR", failure?.details);
+		}
+		if (!payload || !("data" in payload)) throw new SpiderFarmerApiError("API returned an invalid response", response.status, "INVALID_RESPONSE");
+		return payload.data;
+	}
+};
+function asError(value) {
+	return value instanceof Error ? value : new Error(String(value));
+}
+//#endregion
+export { SPIDER_FARMER_API_PATH, SpiderFarmerApiClient, SpiderFarmerApiError };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#baseUrl","#token","#headers","#timeoutMs","#fetch","#request","#write"],"sources":["../src/contract.ts","../src/client.ts"],"sourcesContent":["export const SPIDER_FARMER_API_PATH = \"/v1\";\n\nexport interface ApiSuccess<T> {\n  data: T;\n}\n\nexport interface ApiFailure {\n  error: {\n    code: string;\n    message: string;\n    details?: unknown;\n  };\n}\n","import { SPIDER_FARMER_API_PATH, type ApiFailure, type ApiSuccess } from \"./contract.js\";\nimport type {\n  ApiHealth,\n  ClimateControl,\n  ClimateModule,\n  FanControl,\n  FanModule,\n  JsonObject,\n  LightControl,\n  LightModule,\n  OutletControl,\n  RawRequestOptions,\n  SetConfigurationOptions,\n  SpiderFarmerMessage,\n  SpiderFarmerState,\n  WriteOptions,\n} from \"./types.js\";\n\nexport interface SpiderFarmerApiClientOptions {\n  /** Base URL of the central API, for example `http://127.0.0.1:8787`. */\n  baseUrl: string;\n  /** Optional bearer token configured on the API server. */\n  token?: string;\n  /** Additional headers sent with every request. */\n  headers?: Readonly<Record<string, string>>;\n  /** Request timeout. Default: 30000 ms. */\n  timeoutMs?: number;\n  /** Custom fetch implementation, primarily for tests or runtimes without global fetch. */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport interface WatchOptions {\n  /** Polling interval against the API. Default: 2000 ms. */\n  intervalMs?: number;\n  onError?: (error: Error) => void;\n}\n\nexport class SpiderFarmerApiError extends Error {\n  public readonly status: number;\n  public readonly code: string;\n  public readonly details: unknown;\n\n  public constructor(message: string, status: number, code: string, details?: unknown) {\n    super(message);\n    this.name = \"SpiderFarmerApiError\";\n    this.status = status;\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport class SpiderFarmerApiClient {\n  readonly #baseUrl: string;\n  readonly #token: string | undefined;\n  readonly #headers: Readonly<Record<string, string>>;\n  readonly #timeoutMs: number;\n  readonly #fetch: typeof globalThis.fetch;\n\n  public constructor(options: SpiderFarmerApiClientOptions) {\n    if (!options.baseUrl.trim()) throw new TypeError(\"baseUrl must not be empty\");\n    this.#baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.#token = options.token;\n    this.#headers = options.headers ?? {};\n    this.#timeoutMs = options.timeoutMs ?? 30_000;\n    this.#fetch = options.fetch ?? globalThis.fetch;\n    if (!this.#fetch) throw new TypeError(\"No fetch implementation is available\");\n  }\n\n  public health(): Promise<ApiHealth> {\n    return this.#request(\"/health\");\n  }\n\n  public getState(): Promise<SpiderFarmerState> {\n    return this.#request(\"/state\");\n  }\n\n  public refresh(): Promise<SpiderFarmerState> {\n    return this.#request(\"/refresh\", { method: \"POST\" });\n  }\n\n  public getConfiguration(): Promise<JsonObject> {\n    return this.#request(\"/configuration\");\n  }\n\n  public setConfiguration(\n    configuration: JsonObject,\n    options: SetConfigurationOptions = {},\n  ): Promise<void> {\n    return this.#write(\"/configuration\", { configuration, options }, \"PUT\");\n  }\n\n  public setConfigField(\n    keyPath: readonly string[],\n    value: JsonObject,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(\"/configuration/field\", { keyPath, value, options }, \"PATCH\");\n  }\n\n  public setLight(\n    module: LightModule,\n    patch: LightControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(`/lights/${module}`, { patch, options });\n  }\n\n  public setFan(\n    module: FanModule,\n    patch: FanControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(`/fans/${module}`, { patch, options });\n  }\n\n  public setCirculationFan(patch: FanControl, options: WriteOptions = {}): Promise<void> {\n    return this.setFan(\"fan\", patch, options);\n  }\n\n  public setExhaustFan(patch: FanControl, options: WriteOptions = {}): Promise<void> {\n    return this.setFan(\"blower\", patch, options);\n  }\n\n  public setClimate(\n    module: ClimateModule,\n    patch: ClimateControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    return this.#write(`/climate/${module}`, { patch, options });\n  }\n\n  public setOutlet(\n    outlet: number | `O${number}`,\n    patch: boolean | OutletControl,\n    options: WriteOptions = {},\n  ): Promise<void> {\n    const id = typeof outlet === \"number\" ? `O${outlet}` : outlet.toUpperCase();\n    return this.#write(`/outlets/${id}`, { patch, options });\n  }\n\n  public request(\n    message: SpiderFarmerMessage,\n    options: RawRequestOptions = {},\n  ): Promise<SpiderFarmerMessage> {\n    return this.#request(\"/request\", {\n      method: \"POST\",\n      body: JSON.stringify({ message, options }),\n    });\n  }\n\n  /** Poll the central API without opening another controller connection. */\n  public watch(\n    listener: (state: SpiderFarmerState) => void | Promise<void>,\n    options: WatchOptions = {},\n  ): () => void {\n    const intervalMs = options.intervalMs ?? 2_000;\n    if (!Number.isFinite(intervalMs) || intervalMs < 100) {\n      throw new RangeError(\"watch intervalMs must be at least 100 ms\");\n    }\n    let active = true;\n    let running = false;\n    const poll = async (): Promise<void> => {\n      if (!active || running) return;\n      running = true;\n      try {\n        await listener(await this.getState());\n      } catch (error) {\n        options.onError?.(asError(error));\n      } finally {\n        running = false;\n      }\n    };\n    void poll();\n    const timer = setInterval(() => void poll(), intervalMs);\n    return () => {\n      active = false;\n      clearInterval(timer);\n    };\n  }\n\n  async #write(path: string, body: unknown, method = \"POST\"): Promise<void> {\n    await this.#request<null>(path, { method, body: JSON.stringify(body) });\n  }\n\n  async #request<T>(path: string, init: RequestInit = {}): Promise<T> {\n    const headers = new Headers(this.#headers);\n    headers.set(\"accept\", \"application/json\");\n    if (init.body !== undefined) headers.set(\"content-type\", \"application/json\");\n    if (this.#token) headers.set(\"authorization\", `Bearer ${this.#token}`);\n\n    let response: Response;\n    try {\n      response = await this.#fetch(`${this.#baseUrl}${SPIDER_FARMER_API_PATH}${path}`, {\n        ...init,\n        headers,\n        signal: AbortSignal.timeout(this.#timeoutMs),\n      });\n    } catch (error) {\n      throw new SpiderFarmerApiError(asError(error).message, 0, \"NETWORK_ERROR\", error);\n    }\n\n    const payload = (await response.json().catch(() => undefined)) as\n      | ApiSuccess<T>\n      | ApiFailure\n      | undefined;\n    if (!response.ok) {\n      const failure = payload && \"error\" in payload ? payload.error : undefined;\n      throw new SpiderFarmerApiError(\n        failure?.message ?? `API request failed with HTTP ${response.status}`,\n        response.status,\n        failure?.code ?? \"HTTP_ERROR\",\n        failure?.details,\n      );\n    }\n    if (!payload || !(\"data\" in payload)) {\n      throw new SpiderFarmerApiError(\"API returned an invalid response\", response.status, \"INVALID_RESPONSE\");\n    }\n    return payload.data;\n  }\n}\n\nfunction asError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value));\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "spider-farmer-api-client",
+  "version": "0.0.1",
+  "description": "Typed HTTP client for the Spider Farmer API",
+  "keywords": [
+    "spider-farmer",
+    "spiderfarmer",
+    "ggs",
+    "api-client",
+    "typescript"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "npm run typecheck && npm test && npm run build",
+    "prepublishOnly": "npm run check"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.15",
+    "tsdown": "^0.21.8",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}