@espressif/rainmaker-neo-base-sdk 1.0.0

package/dist/types/methods/ESPRMNeoNode/CreateTrigger.d.ts

@@ -0,0 +1,31 @@
+import { ESPRMNeoTrigger } from "../../ESPRMNeoTrigger";
+import { TriggerItem } from "../../types/trigger";
+/**
+ * Augments the ESPRMNeoNode class with the `createTrigger` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Creates triggers on this node.
+         *
+         * - Pass a single {@link TriggerItem} to append it while preserving existing
+         *   triggers (GET current list, then PUT the merged list).
+         * - Pass an array to replace all triggers in one PUT. Pass `[]` to clear.
+         *
+         * Calls `PUT /v1/groups/{groupId}/nodes/{nodeId}/triggers`.
+         *
+         * Single-item append is not safe under concurrent calls to the same node —
+         * two simultaneous creates can read the same existing list and the later
+         * PUT wins. Callers appending many triggers should build the array locally
+         * and pass it once.
+         *
+         * @param triggers - One trigger to append, or the full list to set.
+         * @returns The created trigger, or the full list after a replace-all PUT.
+         * @throws {ESPAPICallValidationError} If the argument is invalid, or a single
+         *   trigger's id is missing / already exists.
+         * @throws {Error} If the API request fails.
+         */
+        createTrigger(trigger: TriggerItem): Promise<ESPRMNeoTrigger>;
+        createTrigger(triggers: TriggerItem[]): Promise<ESPRMNeoTrigger[]>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/Delete.d.ts

@@ -0,0 +1,16 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `delete` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Fully disassociates this node from the cloud account.
+         * Calls `DELETE /v1/groups/{groupId}/nodes/{nodeId}` at the root group.
+         *
+         * @returns A promise that resolves with the API response when the node has been deleted.
+         * @throws {Error} If the deletion fails or the API request fails.
+         */
+        delete(): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/GetConfig.d.ts

@@ -0,0 +1,16 @@
+import { NodeConfig } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `getConfig` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Returns the node configuration currently held on this instance (the last
+         * snapshot loaded from cache or fetched via {@link sync}). Synchronous —
+         * does not hit the cloud. Call {@link sync} for a fresh fetch.
+         *
+         * @returns The current node configuration.
+         */
+        getConfig(): NodeConfig;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/GetCustomParamLatestTSData.d.ts

@@ -0,0 +1,19 @@
+import type { ESPRMNeoTSDataOptions, ESPRMNeoTSDataResult } from "../../types/tsData";
+/**
+ * Augments the ESPRMNeoNode class with the `getCustomParamLatestTSData` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Gets the most recent time-series sample for a device param from
+         * `GET /v1/groups/{groupId}/nodes/{nodeId}/timeseries/latest`.
+         *
+         * @param deviceName - Device name.
+         * @param paramName - Parameter name.
+         * @param options - Query options (only `dataType` override is used).
+         * @returns Promise resolving to time-series data with at most one point
+         *   in `data` (empty when the param has no samples yet).
+         */
+        getCustomParamLatestTSData?(deviceName: string, paramName: string, options?: ESPRMNeoTSDataOptions): Promise<ESPRMNeoTSDataResult>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/GetCustomParamRawTSData.d.ts

@@ -0,0 +1,20 @@
+import type { ESPRMNeoTSDataOptions, ESPRMNeoTSDataResult } from "../../types/tsData";
+/**
+ * Augments the ESPRMNeoNode class with the `getCustomParamRawTSData` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Gets raw time-series samples for a device param (newest first) from
+         * `GET /v1/groups/{groupId}/nodes/{nodeId}/timeseries/raw`.
+         *
+         * @param deviceName - Device name.
+         * @param paramName - Parameter name.
+         * @param options - Query options; `startTs` (Unix ms) is required,
+         *   `endTs` defaults to now. Paginate via `pageSize`/`startKey` or the
+         *   result's `fetchNext()`.
+         * @returns Promise resolving to raw time-series data.
+         */
+        getCustomParamRawTSData?(deviceName: string, paramName: string, options?: ESPRMNeoTSDataOptions): Promise<ESPRMNeoTSDataResult>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/GetCustomParamTSData.d.ts

@@ -0,0 +1,25 @@
+import type { ESPRMNeoTSDataOptions, ESPRMNeoTSDataResult } from "../../types/tsData";
+/**
+ * Augments the ESPRMNeoNode class with the `getCustomParamTSData` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Gets aggregated time-series data for a device param from
+         * `GET /v1/groups/{groupId}/nodes/{nodeId}/timeseries/aggregates`.
+         *
+         * Query modes (all require `options.window`):
+         * - no date options: current (live) window
+         * - `date`: one completed historical window
+         * - `startDate` + `endDate`: paginated range of completed windows
+         *
+         * @param deviceName - Device name.
+         * @param paramName - Parameter name.
+         * @param options - Query options (`window` required; `date` or
+         *   `startDate`/`endDate` for historical windows; paginate via
+         *   `pageSize`/`startKey` or the result's `fetchNext()`).
+         * @returns Promise resolving to time-series data with `aggregates` populated.
+         */
+        getCustomParamTSData?(deviceName: string, paramName: string, options?: ESPRMNeoTSDataOptions): Promise<ESPRMNeoTSDataResult>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/GetSchedules.d.ts

@@ -0,0 +1,17 @@
+import { ESPRMNeoSchedule } from "../../ESPRMNeoSchedule";
+/**
+ * Augments the ESPRMNeoNode class with the `getSchedules` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Retrieves all schedules for this node.
+         *
+         * Calls `GET /v1/groups/{groupId}/nodes/{nodeId}/schedules`.
+         *
+         * @returns A promise that resolves to an array of ESPRMNeoSchedule instances.
+         * @throws {Error} If retrieving schedules fails or the API request fails.
+         */
+        getSchedules(): Promise<ESPRMNeoSchedule[]>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/GetTriggers.d.ts

@@ -0,0 +1,17 @@
+import { ESPRMNeoTrigger } from "../../ESPRMNeoTrigger";
+/**
+ * Augments the ESPRMNeoNode class with the `getTriggers` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Retrieves all triggers for this node.
+         *
+         * Calls `GET /v1/groups/{groupId}/nodes/{nodeId}/triggers`.
+         *
+         * @returns A promise that resolves to an array of ESPRMNeoTrigger instances.
+         * @throws {Error} If the API request fails.
+         */
+        getTriggers(): Promise<ESPRMNeoTrigger[]>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/RemoveAllSchedules.d.ts

@@ -0,0 +1,17 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `removeAllSchedules` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Removes all schedules for this node in a single call.
+         *
+         * Calls `DELETE /v1/groups/{groupId}/nodes/{nodeId}/schedules`.
+         *
+         * @returns A promise that resolves with the API response when all schedules are successfully removed.
+         * @throws {Error} If the API request fails.
+         */
+        removeAllSchedules(): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/RemoveAllTriggers.d.ts

@@ -0,0 +1,17 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `removeAllTriggers` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Removes all triggers for this node in a single call.
+         *
+         * Calls `DELETE /v1/groups/{groupId}/nodes/{nodeId}/triggers`.
+         *
+         * @returns A promise that resolves with the API response when all triggers are successfully removed.
+         * @throws {Error} If the API request fails.
+         */
+        removeAllTriggers(): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/RemoveSchedule.d.ts

@@ -0,0 +1,20 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `removeSchedule` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Removes a schedule from this node by id, preserving other schedules.
+         *
+         * RainMaker's schedules API is replace-all, so this method does two round
+         * trips: a GET to fetch the current list, then a PUT of the filtered list.
+         *
+         * @param scheduleId - Id of the schedule to remove.
+         * @returns A promise that resolves with the API response when the schedule is removed.
+         * @throws {ESPAPICallValidationError} If `scheduleId` is missing or no matching schedule exists.
+         * @throws {Error} If the API request fails.
+         */
+        removeSchedule(scheduleId: string): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/RemoveTrigger.d.ts

@@ -0,0 +1,20 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `removeTrigger` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Removes a trigger from this node by id, preserving other triggers.
+         *
+         * RainMaker's triggers API is replace-all, so this method does two round
+         * trips: a GET to fetch the current list, then a PUT of the filtered list.
+         *
+         * @param triggerId - Id of the trigger to remove.
+         * @returns A promise that resolves with the API response when the trigger is removed.
+         * @throws {ESPAPICallValidationError} If `triggerId` is missing or no matching trigger exists.
+         * @throws {Error} If the API request fails.
+         */
+        removeTrigger(triggerId: string): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/SetParams.d.ts

@@ -0,0 +1,23 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoNode class with the `setParams` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Publishes a parameter update to this node via the best available
+         * transport (local control first when reachable, otherwise MQTT).
+         *
+         * The returned response indicates the publish was accepted by the
+         * transport (local ack or MQTT publish resolved). It does **not**
+         * guarantee that the device received or applied the params — cloud
+         * publishes are fire-and-forget over AWS IoT.
+         *
+         * @param params - A record of device/service names to param maps.
+         * @returns A promise that resolves once the transport publish is accepted.
+         * @throws {ESPAPICallValidationError} If `params` is empty.
+         * @throws If all available transports fail.
+         */
+        setParams(params: Record<string, any>): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoNode/SubscriptionConfig.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Augments {@link ESPRMNeoNode} with per-node subscription channel-order methods.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Sets the subscription channel order for this node, overriding the global
+         * order on {@link ESPRMNeoBase.subscriptionManager}. Channels are tried in
+         * order until one succeeds; only channels that support the node are used.
+         *
+         * @param channelIds - Channel ids in priority order, e.g. `["matter", "mqtt"]`.
+         *
+         * @example
+         * ```typescript
+         * node.setSubscriptionChannelOrder(["matter", "mqtt"]);
+         * ```
+         */
+        setSubscriptionChannelOrder(channelIds: string[]): void;
+        /**
+         * Returns the effective subscription channel order for this node
+         * (node-specific order if set, otherwise the global order).
+         *
+         * @returns Channel ids in priority order.
+         */
+        getSubscriptionChannelOrder(): string[];
+        /**
+         * Clears the node-specific channel order so the node falls back to the
+         * global order.
+         */
+        clearSubscriptionChannelOrder(): void;
+    }
+}
+export {};

package/dist/types/methods/ESPRMNeoNode/Sync.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Augments the ESPRMNeoNode class with the `sync` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Fetches the latest node config from the cloud, applies it to this
+         * instance (config, devices, services), then updates the local cache.
+         *
+         * Calls:
+         * - Root membership: `GET /v1/groups/{groupId}/nodes/{nodeId}/config`
+         * - Subgroup membership: `GET /v1/groups/{groupId}/subgroups/{subGroupId}/nodes/{nodeId}/config`
+         *
+         * @throws {Error} If the API request fails.
+         */
+        sync(): Promise<ESPRMNeoNode>;
+    }
+}
+export {};

package/dist/types/methods/ESPRMNeoNode/UnsubscribeFromMqttUpdates.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Augments the ESPRMNeoNode class with the `unsubscribeFromMqttUpdates` method.
+ */
+declare module "../../ESPRMNeoNode" {
+    interface ESPRMNeoNode {
+        /**
+         * Stops receiving MQTT shadow updates for this node.
+         *
+         * Specifically:
+         * - Unregisters the node from {@link NodeMQTTOrchestrator}
+         * - Removes the node's MQTT shadow listeners
+         * - Unsubscribes the shared shadow MQTT topics if no other registered
+         *   nodes still use them
+         *
+         * Call this before dropping the last reference to the node instance so
+         * orchestrator registrations and MQTT subscriptions are not left behind.
+         * This does not clear local storage, node config cache, or other SDK
+         * resources.
+         */
+        unsubscribeFromMqttUpdates(): void;
+    }
+}
+export {};

package/dist/types/methods/ESPRMNeoNode/index.d.ts

@@ -0,0 +1,17 @@
+import "./GetConfig";
+import "./Sync";
+import "./GetCustomParamTSData";
+import "./GetCustomParamRawTSData";
+import "./GetCustomParamLatestTSData";
+import "./SetParams";
+import "./SubscriptionConfig";
+import "./Delete";
+import "./UnsubscribeFromMqttUpdates";
+import "./GetSchedules";
+import "./CreateSchedule";
+import "./RemoveSchedule";
+import "./RemoveAllSchedules";
+import "./GetTriggers";
+import "./CreateTrigger";
+import "./RemoveTrigger";
+import "./RemoveAllTriggers";

package/dist/types/methods/ESPRMNeoSchedule/Delete.d.ts

@@ -0,0 +1,16 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoSchedule class with the `delete` method.
+ */
+declare module "../../ESPRMNeoSchedule" {
+    interface ESPRMNeoSchedule {
+        /**
+         * Deletes this schedule.
+         *
+         * @returns A promise that resolves with the API response when the schedule is successfully deleted.
+         * @throws {ESPAPICallValidationError} If the node is not found.
+         * @throws {Error} If deletion fails or the API request fails.
+         */
+        delete(): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoSchedule/Enable.d.ts

@@ -0,0 +1,17 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoSchedule class with the `enable` method.
+ */
+declare module "../../ESPRMNeoSchedule" {
+    interface ESPRMNeoSchedule {
+        /**
+         * Enables or disables this schedule.
+         *
+         * @param enabled - `true` to enable the schedule, `false` to disable it.
+         * @returns A promise that resolves with the API response when the change succeeds.
+         * @throws {ESPAPICallValidationError} If the node or schedule is not found.
+         * @throws {Error} If the update fails or the API request fails.
+         */
+        enable(enabled: boolean): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoSchedule/Update.d.ts

@@ -0,0 +1,18 @@
+import { ScheduleItem } from "../../types/schedule";
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoSchedule class with the `update` method.
+ */
+declare module "../../ESPRMNeoSchedule" {
+    interface ESPRMNeoSchedule {
+        /**
+         * Updates this schedule with partial changes.
+         *
+         * @param updates - Partial schedule data containing fields to update.
+         * @returns A promise that resolves with the API response when the schedule is successfully updated.
+         * @throws {ESPAPICallValidationError} If the node or schedule is not found.
+         * @throws {Error} If the update fails or the API request fails.
+         */
+        update(updates: Partial<ScheduleItem>): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoSchedule/index.d.ts

@@ -0,0 +1,3 @@
+import "./Update";
+import "./Delete";
+import "./Enable";

package/dist/types/methods/ESPRMNeoService/GetParams.d.ts

@@ -0,0 +1,17 @@
+import type { ESPRMNeoServiceParam } from "../../ESPRMNeoServiceParam";
+/**
+ * Augments the ESPRMNeoService class with the `getParams` method.
+ */
+declare module "../../ESPRMNeoService" {
+    interface ESPRMNeoService {
+        /**
+         * Fetches live param values for this service via the best available
+         * transport (local control first when reachable, otherwise MQTT) and
+         * updates each {@link ESPRMNeoServiceParam}'s `value`. Returns the same
+         * instances as {@link ESPRMNeoService.params}.
+         *
+         * @throws If the parent node reference has been garbage collected.
+         */
+        getParams(): Promise<ESPRMNeoServiceParam[]>;
+    }
+}

package/dist/types/methods/ESPRMNeoService/index.d.ts

@@ -0,0 +1 @@
+import "./GetParams";

package/dist/types/methods/ESPRMNeoSharingRequest/Accept.d.ts

@@ -0,0 +1,17 @@
+import { SuccessResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoSharingRequest class with the `accept` method.
+ */
+declare module "../../ESPRMNeoSharingRequest" {
+    interface ESPRMNeoSharingRequest {
+        /**
+         * Accepts this sharing request, granting the requester access to the shared group/subgroup.
+         *
+         * Calls `POST /v1/sharing-requests/{requestId}/accept`.
+         *
+         * @returns A promise that resolves when the sharing request is successfully accepted.
+         * @throws If the request fails.
+         */
+        accept(): Promise<SuccessResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoSharingRequest/Decline.d.ts

@@ -0,0 +1,17 @@
+import { SuccessResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoSharingRequest class with the `decline` method.
+ */
+declare module "../../ESPRMNeoSharingRequest" {
+    interface ESPRMNeoSharingRequest {
+        /**
+         * Declines this sharing request, denying access to the shared group/subgroup.
+         *
+         * Calls `POST /v1/sharing-requests/{requestId}/reject`.
+         *
+         * @returns A promise that resolves when the sharing request is successfully declined.
+         * @throws If the request fails.
+         */
+        decline(): Promise<SuccessResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoSharingRequest/index.d.ts

@@ -0,0 +1,2 @@
+import "./Accept";
+import "./Decline";

package/dist/types/methods/ESPRMNeoTrigger/Delete.d.ts

@@ -0,0 +1,15 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoTrigger class with the `delete` method.
+ */
+declare module "../../ESPRMNeoTrigger" {
+    interface ESPRMNeoTrigger {
+        /**
+         * Deletes this trigger.
+         *
+         * @returns A promise that resolves with the API response when the trigger is successfully deleted.
+         * @throws {Error} If deletion fails.
+         */
+        delete(): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoTrigger/Enable.d.ts

@@ -0,0 +1,17 @@
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoTrigger class with the `enable` method.
+ */
+declare module "../../ESPRMNeoTrigger" {
+    interface ESPRMNeoTrigger {
+        /**
+         * Enables or disables this trigger.
+         *
+         * @param enabled - `true` to enable the trigger, `false` to disable it.
+         * @returns A promise that resolves with the API response when the change succeeds.
+         * @throws {ESPAPICallValidationError} If the node is not found.
+         * @throws {Error} If the update fails or the API request fails.
+         */
+        enable(enabled: boolean): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoTrigger/Update.d.ts

@@ -0,0 +1,22 @@
+import { TriggerItem } from "../../types/trigger";
+import { ESPAPIResponse } from "../../types/output";
+/**
+ * Augments the ESPRMNeoTrigger class with the `update` method.
+ */
+declare module "../../ESPRMNeoTrigger" {
+    interface ESPRMNeoTrigger {
+        /**
+         * Updates this trigger with partial changes. Sends a full trigger-list
+         * PUT under the hood (the RainMaker triggers API is replace-all).
+         *
+         * The instance is mutated **only after** the API call succeeds. If the
+         * PUT fails, this trigger's fields are left unchanged.
+         *
+         * @param updates - Partial trigger fields to update.
+         * @returns A promise that resolves with the API response.
+         * @throws {ESPAPICallValidationError} If the node or trigger is not found.
+         * @throws {Error} If the API request fails.
+         */
+        update(updates: Partial<TriggerItem>): Promise<ESPAPIResponse>;
+    }
+}

package/dist/types/methods/ESPRMNeoTrigger/index.d.ts

@@ -0,0 +1,3 @@
+import "./Update";
+import "./Delete";
+import "./Enable";

package/dist/types/methods/ESPRMNeoUser/CreateESPDevice.d.ts

@@ -0,0 +1,20 @@
+import { ESPDevice } from "../../ESPDevice";
+import { ESPSecurity, ESPTransport } from "../../types/provision";
+/**
+ * Augments the ESPRMNeoUser class with the `createESPDevice` method.
+ */
+declare module "../../ESPRMNeoUser" {
+    interface ESPRMNeoUser {
+        /**
+         * Creates an ESP device with the given parameters.
+         * @param name - The name of the device.
+         * @param transport - The transport type to use.
+         * @param security - The security type to use (optional).
+         * @param proofOfPossession - The proof of possession string (optional).
+         * @param softAPPassword - The SoftAP password (optional).
+         * @param username - The username (optional).
+         * @returns A promise that resolves to an ESPDevice instance.
+         */
+        createESPDevice(name: string, transport: ESPTransport, security?: ESPSecurity, proofOfPossession?: string, softAPPassword?: string, username?: string): Promise<ESPDevice>;
+    }
+}

package/dist/types/methods/ESPRMNeoUser/CreateGroup.d.ts

@@ -0,0 +1,17 @@
+import { ESPRMNeoGroup } from "../../ESPRMNeoGroup";
+/**
+ * Augments the ESPRMNeoUser class with the `createGroup` method.
+ */
+declare module "../../ESPRMNeoUser" {
+    interface ESPRMNeoUser {
+        /**
+         * Creates a new group.
+         *
+         * Calls `POST /v1/groups`.
+         *
+         * @param groupName Name of the group
+         * @returns A promise that resolves to the created ESPRMNeoGroup
+         */
+        createGroup(groupName: string): Promise<ESPRMNeoGroup>;
+    }
+}

package/dist/types/methods/ESPRMNeoUser/EventSubscription.d.ts

@@ -0,0 +1,29 @@
+import { DiscoveryParamsInterface, ESPEventCallback, ESPRMNeoEventType } from "../../types/discovery";
+/**
+ * Augments the ESPRMNeoUser class with event subscription methods.
+ *
+ * One callback is held per event — re-subscribing replaces the previous one.
+ * Some events also start a backing source (LAN discovery, node-updates bus,
+ * or custom discovery); that source is torn down on unsubscribe.
+ */
+declare module "../../ESPRMNeoUser" {
+    interface ESPRMNeoUser {
+        /**
+         * Subscribes a callback to an event (replaces any existing one).
+         *
+         * - {@link ESPRMNeoEventType.localDiscovery}: starts LAN discovery; each
+         *   hit is delivered as {@link ESPDiscoveredNodeData}.
+         * - {@link ESPRMNeoEventType.nodeUpdates}: forwards process-wide node
+         *   param updates.
+         * - Custom string event + `discoveryConfig`: starts discovery with that
+         *   config and forwards raw results unchanged.
+         */
+        subscribe(event: ESPRMNeoEventType | string, callback: ESPEventCallback, discoveryConfig?: DiscoveryParamsInterface): void;
+        /** Removes the callback and stops any backing source for the event. */
+        unsubscribe(event: ESPRMNeoEventType | string): void;
+        /** Invokes the registered callback for `event` (if any) with `arg`. */
+        trigger(event: ESPRMNeoEventType | string, arg: unknown): void;
+        /** Clears one event, or every event when `event` is omitted. */
+        removeAllCallbacks(event?: ESPRMNeoEventType | string): void;
+    }
+}

package/dist/types/methods/ESPRMNeoUser/GetGroups.d.ts

@@ -0,0 +1,16 @@
+import { ESPRMNeoGroup } from "../../ESPRMNeoGroup";
+/**
+ * Augments the ESPRMNeoUser class with the `getGroups` method.
+ */
+declare module "../../ESPRMNeoUser" {
+    interface ESPRMNeoUser {
+        /**
+         * Retrieves the list of groups associated with the user.
+         *
+         * Calls `GET /v1/groups`.
+         *
+         * @returns A promise that resolves to an array of ESPRMNeoGroup instances
+         */
+        getGroups(): Promise<ESPRMNeoGroup[]>;
+    }
+}