miravo 0.6.0 → 0.6.1

package/src/lib/le/le-devicehub.ts

@@ -1,213 +0,0 @@
-/**
- * Litmus Edge DeviceHub GraphQL operations.
- */
-
-import type { LEClient } from "./le-client.ts";
-
-// --- Types ---
-
-/** InputItem for GraphQL mutations (Key/Value). */
-export interface LEItem {
-  readonly Key: string;
-  readonly Value: string;
-}
-
-/** Item returned from GraphQL queries (Name/Value). */
-export interface LEItemOutput {
-  readonly Name: string;
-  readonly Value: string;
-}
-
-interface LEDriver {
-  readonly ID: string;
-  readonly Name: string;
-}
-
-interface LEDriverGroup {
-  readonly ID: string;
-  readonly Name: string;
-  readonly Drivers: readonly LEDriver[] | null;
-}
-
-export interface LEDevice {
-  readonly ID: string;
-  readonly Name: string;
-  readonly DriverID: string;
-  readonly Properties: readonly LEItemOutput[];
-  readonly MetaData: readonly LEItemOutput[];
-  readonly Description: string;
-}
-
-interface LERegister {
-  readonly ID: string;
-  readonly DeviceID: string;
-  readonly Name: string;
-  readonly TagName: string;
-  readonly ValueType: string;
-  readonly Properties: readonly LEItemOutput[];
-  readonly MetaData: readonly LEItemOutput[];
-  readonly Description: string;
-}
-
-// --- Queries ---
-
-const LIST_DRIVER_GROUPS = `query {
-  ListDriverGroups(input: {}) {
-    ID Name
-    Drivers { ID Name }
-  }
-}`;
-
-const LIST_DEVICES = `query {
-  ListDevices { ID Name DriverID Properties { Name Value } MetaData { Name Value } Description }
-}`;
-
-const LIST_REGISTERS = `query ListRegisters($deviceId: UUID!) {
-  ListRegisters(input: { DeviceID: $deviceId, Limit: 1000 }) {
-    Registers { ID DeviceID Name TagName ValueType Properties { Name Value } MetaData { Name Value } Description }
-  }
-}`;
-
-// --- Mutations ---
-
-const CREATE_DEVICE = `mutation CreateDevice($input: CreateDeviceRequest!) {
-  CreateDevice(input: $input) { ID Name DriverID Properties { Name Value } MetaData { Name Value } Description }
-}`;
-
-const UPDATE_DEVICE = `mutation UpdateDevice($input: UpdateDeviceRequest!) {
-  UpdateDevice(input: $input) { ID Name DriverID Properties { Name Value } MetaData { Name Value } Description }
-}`;
-
-const DELETE_DEVICES = `mutation DeleteDevices($ids: [UUID!]!) {
-  DeleteDevices(input: { IDs: $ids })
-}`;
-
-const CREATE_REGISTERS = `mutation CreateRegisters($input: CreateRegistersRequest!) {
-  CreateRegisters(input: $input) { ID DeviceID Name TagName ValueType Properties { Name Value } MetaData { Name Value } Description }
-}`;
-
-const DELETE_REGISTERS = `mutation DeleteRegisters($ids: [UUID!]!) {
-  DeleteRegisters(input: { IDs: $ids })
-}`;
-
-const DELETE_DEVICE_REGISTERS = `mutation DeleteDeviceRegisters($deviceId: UUID!) {
-  DeleteDeviceRegisters(input: { DevID: $deviceId })
-}`;
-
-// --- API ---
-
-export class LEDeviceHub {
-  constructor(private readonly client: LEClient) {}
-
-  async listDriverGroups(): Promise<readonly LEDriverGroup[]> {
-    const data = await this.client.gql<{ ListDriverGroups: LEDriverGroup[] }>(
-      "/devicehub/v2",
-      LIST_DRIVER_GROUPS,
-    );
-    return data.ListDriverGroups;
-  }
-
-  async resolveDriverByName(name: string): Promise<LEDriver> {
-    const groups = await this.listDriverGroups();
-    for (const group of groups) {
-      if (!group.Drivers) continue;
-      for (const driver of group.Drivers) {
-        if (driver.Name === name) return driver;
-      }
-    }
-    throw new Error(
-      `LE driver "${name}" not found. Available drivers: ${groups.flatMap((g) => g.Drivers?.map((d) => d.Name) ?? []).join(", ")}`,
-    );
-  }
-
-  async listDevices(): Promise<readonly LEDevice[]> {
-    const data = await this.client.gql<{ ListDevices: LEDevice[] | null }>(
-      "/devicehub/v2",
-      LIST_DEVICES,
-    );
-    return data.ListDevices ?? [];
-  }
-
-  async listRegisters(deviceId: string): Promise<readonly LERegister[]> {
-    const data = await this.client.gql<{
-      ListRegisters: { Registers: LERegister[] } | null;
-    }>("/devicehub/v2", LIST_REGISTERS, { deviceId });
-    return data.ListRegisters?.Registers ?? [];
-  }
-
-  async createDevice(input: {
-    DriverID: string;
-    Name: string;
-    Properties: readonly LEItem[];
-    MetaData?: readonly LEItem[];
-    Description?: string;
-  }): Promise<LEDevice> {
-    const data = await this.client.gql<{ CreateDevice: LEDevice }>("/devicehub/v2", CREATE_DEVICE, {
-      input: {
-        ...input,
-        Description: input.Description ?? "",
-        AliasTopics: true,
-      },
-    });
-    return data.CreateDevice;
-  }
-
-  async updateDevice(input: {
-    ID: string;
-    Name: string;
-    Properties: readonly LEItem[];
-    MetaData?: readonly LEItem[];
-    Description?: string;
-  }): Promise<LEDevice> {
-    const data = await this.client.gql<{ UpdateDevice: LEDevice }>("/devicehub/v2", UPDATE_DEVICE, {
-      input: {
-        ...input,
-        Description: input.Description ?? "",
-        AliasTopics: true,
-      },
-    });
-    return data.UpdateDevice;
-  }
-
-  async deleteDevices(ids: readonly string[]): Promise<void> {
-    if (ids.length === 0) return;
-    await this.client.gql("/devicehub/v2", DELETE_DEVICES, { ids });
-  }
-
-  async createRegisters(
-    registers: readonly {
-      DeviceID: string;
-      Name: string;
-      TagName: string;
-      ValueType: string;
-      Properties: readonly LEItem[];
-      MetaData?: readonly LEItem[];
-      Description?: string;
-    }[],
-  ): Promise<readonly LERegister[]> {
-    if (registers.length === 0) return [];
-    const data = await this.client.gql<{ CreateRegisters: LERegister[] }>(
-      "/devicehub/v2",
-      CREATE_REGISTERS,
-      {
-        input: {
-          Registers: registers.map((r) => ({
-            ...r,
-            Description: r.Description ?? "",
-            PublishCoV: false,
-          })),
-        },
-      },
-    );
-    return data.CreateRegisters;
-  }
-
-  async deleteRegisters(ids: readonly string[]): Promise<void> {
-    if (ids.length === 0) return;
-    await this.client.gql("/devicehub/v2", DELETE_REGISTERS, { ids });
-  }
-
-  async deleteDeviceRegisters(deviceId: string): Promise<void> {
-    await this.client.gql("/devicehub/v2", DELETE_DEVICE_REGISTERS, { deviceId });
-  }
-}

package/src/lib/le/le-digital-twins.ts

@@ -1,285 +0,0 @@
-/**
- * Litmus Edge Digital Twins GraphQL operations.
- */
-
-import type { LEClient } from "./le-client.ts";
-
-// --- Types ---
-
-export interface LEModel {
-  readonly ID: string;
-  readonly Name: string;
-  readonly Description: string;
-  readonly Version: number;
-}
-
-export interface LEInstance {
-  readonly ID: string;
-  readonly ModelID: string;
-  readonly Name: string;
-  readonly Topic: string;
-  readonly Interval: number;
-  readonly FlatHierarchy: boolean | null;
-  readonly Version: number;
-}
-
-interface LEStaticAttribute {
-  readonly ID: string;
-  readonly ModelID: string | null;
-  readonly InstanceID: string | null;
-  readonly Key: string;
-  readonly Value: string;
-}
-
-interface LEParameter {
-  readonly ID: string;
-  readonly OwnerID: string;
-  readonly Name: string;
-  readonly Value: string;
-}
-
-// --- Queries ---
-
-const LIST_MODELS = `query { ListModels { ID Name Description Version } }`;
-
-const LIST_INSTANCES = `query ListInstances($input: ListInstancesRequest) {
-  ListInstances(input: $input) { ID ModelID Name Topic Interval FlatHierarchy Version }
-}`;
-
-const LIST_STATIC_ATTRIBUTES = `query ListStaticAttributes($modelId: UUID, $instanceId: UUID) {
-  ListStaticAttributes(input: { ModelID: $modelId, InstanceID: $instanceId }) {
-    ID ModelID InstanceID Key Value
-  }
-}`;
-
-const LIST_PARAMETERS = `query ListParameters($ownerId: UUID) {
-  ListParameters(input: { OwnerID: $ownerId }) { ID OwnerID Name Value }
-}`;
-
-// --- Mutations ---
-
-const IMPORT_MODEL = `mutation ImportModel($input: Any!) {
-  ImportModel(input: $input)
-}`;
-
-const DELETE_MODEL = `mutation DeleteModel($id: UUID) {
-  DeleteModel(input: { ID: $id })
-}`;
-
-const CREATE_INSTANCE = `mutation CreateInstance($input: CreateInstanceRequest!) {
-  CreateInstance(input: $input) { ID ModelID Name Topic Interval FlatHierarchy Version }
-}`;
-
-const UPDATE_INSTANCE = `mutation UpdateInstance($input: UpdateInstanceRequest!) {
-  UpdateInstance(input: $input) { ID ModelID Name Topic Interval FlatHierarchy Version }
-}`;
-
-const DELETE_INSTANCE = `mutation DeleteInstance($id: UUID) {
-  DeleteInstance(input: { ID: $id })
-}`;
-
-const TRANSACTIONAL_INSTANCE_UPDATE = `mutation TransactionalInstanceUpdate($input: TransactionalInstanceUpdateRequest!) {
-  TransactionalInstanceUpdate(input: $input)
-}`;
-
-const SET_INSTANCE_STATE = `mutation SetInstanceState($input: SetInstanceStateRequest!) {
-  SetInstanceState(input: $input)
-}`;
-
-const CREATE_STATIC_ATTRIBUTES = `mutation CreateStaticAttributes($input: CreateStaticAttributesRequest!) {
-  CreateStaticAttributes(input: $input) { ID ModelID InstanceID Key Value }
-}`;
-
-const UPDATE_STATIC_ATTRIBUTES = `mutation UpdateStaticAttributes($input: UpdateStaticAttributesRequest!) {
-  UpdateStaticAttributes(input: $input) { ID ModelID InstanceID Key Value }
-}`;
-
-interface LETransactionalInstanceUpdateInput {
-  readonly instanceID: string;
-  readonly updateStaticAttributes?: {
-    readonly Items: readonly {
-      readonly ID: string;
-      readonly ModelID?: string | null;
-      readonly InstanceID?: string | null;
-      readonly Key: string;
-      readonly Value: string;
-    }[];
-  };
-  readonly updateDynamicAttributes?: { readonly Items: readonly unknown[] };
-  readonly setParameters?: {
-    readonly Items: readonly {
-      readonly ID?: string;
-      readonly Name: string;
-      readonly Value: string;
-    }[];
-  };
-}
-
-// --- API ---
-
-export class LEDigitalTwins {
-  constructor(private readonly client: LEClient) {}
-
-  private async transactionalInstanceUpdate(
-    input: LETransactionalInstanceUpdateInput,
-  ): Promise<void> {
-    await this.client.gql("/digital-twins/v2", TRANSACTIONAL_INSTANCE_UPDATE, { input });
-  }
-
-  async listModels(): Promise<readonly LEModel[]> {
-    const data = await this.client.gql<{ ListModels: LEModel[] }>("/digital-twins/v2", LIST_MODELS);
-    return data.ListModels;
-  }
-
-  async listInstances(modelId?: string): Promise<readonly LEInstance[]> {
-    const data = await this.client.gql<{ ListInstances: LEInstance[] }>(
-      "/digital-twins/v2",
-      LIST_INSTANCES,
-      { input: modelId ? { ModelID: modelId } : {} },
-    );
-    return data.ListInstances;
-  }
-
-  async listStaticAttributes(opts: {
-    modelId?: string | undefined;
-    instanceId?: string | undefined;
-  }): Promise<readonly LEStaticAttribute[]> {
-    const data = await this.client.gql<{ ListStaticAttributes: LEStaticAttribute[] }>(
-      "/digital-twins/v2",
-      LIST_STATIC_ATTRIBUTES,
-      { modelId: opts.modelId ?? null, instanceId: opts.instanceId ?? null },
-    );
-    return data.ListStaticAttributes;
-  }
-
-  async listParameters(ownerId: string): Promise<readonly LEParameter[]> {
-    const data = await this.client.gql<{ ListParameters: LEParameter[] }>(
-      "/digital-twins/v2",
-      LIST_PARAMETERS,
-      { ownerId },
-    );
-    return data.ListParameters;
-  }
-
-  async importModel(modelJson: unknown): Promise<boolean> {
-    const data = await this.client.gql<{ ImportModel: boolean }>(
-      "/digital-twins/v2",
-      IMPORT_MODEL,
-      { input: modelJson },
-    );
-    return data.ImportModel;
-  }
-
-  async deleteModel(id: string): Promise<void> {
-    await this.client.gql("/digital-twins/v2", DELETE_MODEL, { id });
-  }
-
-  async createInstance(input: {
-    ModelID: string;
-    Name: string;
-    Topic: string;
-    Interval: number;
-    FlatHierarchy?: boolean;
-  }): Promise<LEInstance> {
-    const data = await this.client.gql<{ CreateInstance: LEInstance }>(
-      "/digital-twins/v2",
-      CREATE_INSTANCE,
-      { input },
-    );
-    return data.CreateInstance;
-  }
-
-  async updateInstance(input: {
-    ID: string;
-    ModelID: string;
-    Name: string;
-    Topic: string;
-    Interval: number;
-    FlatHierarchy?: boolean;
-  }): Promise<LEInstance> {
-    const data = await this.client.gql<{ UpdateInstance: LEInstance }>(
-      "/digital-twins/v2",
-      UPDATE_INSTANCE,
-      { input },
-    );
-    return data.UpdateInstance;
-  }
-
-  async deleteInstance(id: string): Promise<void> {
-    await this.client.gql("/digital-twins/v2", DELETE_INSTANCE, { id });
-  }
-
-  async setInstanceParameters(
-    instanceId: string,
-    params: readonly { Name: string; Value: string }[],
-  ): Promise<void> {
-    // TransactionalInstanceUpdate requires SetParameterRequest.ID to be set.
-    // LE auto-creates default parameters when an instance is created, so the
-    // lookup is always needed — even for brand-new instances.
-    const existing = await this.listParameters(instanceId);
-    const byName = new Map(existing.map((p) => [p.Name, p]));
-
-    await this.transactionalInstanceUpdate({
-      instanceID: instanceId,
-      updateStaticAttributes: { Items: [] },
-      updateDynamicAttributes: { Items: [] },
-      setParameters: {
-        Items: params.map((p) => {
-          const existingParamId = byName.get(p.Name)?.ID;
-          return existingParamId
-            ? { ID: existingParamId, Name: p.Name, Value: p.Value }
-            : { Name: p.Name, Value: p.Value };
-        }),
-      },
-    });
-  }
-
-  async updateInstanceStaticAttributes(
-    instanceId: string,
-    attrs: readonly {
-      ID: string;
-      ModelID?: string | null;
-      InstanceID?: string | null;
-      Key: string;
-      Value: string;
-    }[],
-  ): Promise<void> {
-    if (attrs.length === 0) return;
-    await this.transactionalInstanceUpdate({
-      instanceID: instanceId,
-      updateStaticAttributes: { Items: attrs },
-      updateDynamicAttributes: { Items: [] },
-      setParameters: { Items: [] },
-    });
-  }
-
-  async setInstanceState(instanceId: string, enabled: boolean): Promise<void> {
-    await this.client.gql("/digital-twins/v2", SET_INSTANCE_STATE, {
-      input: { ID: instanceId, State: enabled },
-    });
-  }
-
-  async createStaticAttributes(
-    attrs: readonly { ModelID?: string; InstanceID?: string; Key: string; Value: string }[],
-  ): Promise<readonly LEStaticAttribute[]> {
-    if (attrs.length === 0) return [];
-    const data = await this.client.gql<{ CreateStaticAttributes: LEStaticAttribute[] }>(
-      "/digital-twins/v2",
-      CREATE_STATIC_ATTRIBUTES,
-      { input: { Items: attrs } },
-    );
-    return data.CreateStaticAttributes;
-  }
-
-  async updateStaticAttributes(
-    attrs: readonly { ID: string; Key: string; Value: string }[],
-  ): Promise<readonly LEStaticAttribute[]> {
-    if (attrs.length === 0) return [];
-    const data = await this.client.gql<{ UpdateStaticAttributes: LEStaticAttribute[] }>(
-      "/digital-twins/v2",
-      UPDATE_STATIC_ATTRIBUTES,
-      { input: { Items: attrs } },
-    );
-    return data.UpdateStaticAttributes;
-  }
-}

package/src/lib/le/le-drivers.ts

@@ -1,23 +0,0 @@
-/**
- * LE driver resolution by stable name and ID.
- */
-
-import type { ProtocolName } from "@miravo/shared";
-
-/** Stable driver names per protocol. */
-export const LE_DRIVER_NAMES: Record<ProtocolName, string> = {
-  opcua: "OPC UA Client Advanced",
-  modbus: "Modbus TCP",
-  mqtt: "MQTT Client",
-};
-
-/** Fixed DeviceHub driver UUIDs per protocol for LE 4.x. */
-export const LE_DRIVER_IDS: Record<ProtocolName, string> = {
-  opcua: "2372E68F-BA1B-46E9-BC07-E92CA006B377",
-  modbus: "2AF1FA08-D638-11E9-BB65-2A2AE2DBCCE4",
-  mqtt: "236E3A53-E133-48D6-96F4-D95E61C7592A",
-};
-
-export function getDriverName(protocol: ProtocolName): string {
-  return LE_DRIVER_NAMES[protocol];
-}

package/src/lib/le/le-endpoint.ts

@@ -1,40 +0,0 @@
-/**
- * LE endpoint resolution.
- *
- * Determines the host:port that LE devices should use to reach
- * Miravo's protocol servers.
- */
-
-import type { ProtocolName } from "@miravo/shared";
-import { DEFAULT_MODBUS_PORT, DEFAULT_MQTT_PORT, DEFAULT_OPCUA_PORT } from "@miravo/shared";
-
-interface EndpointInfo {
-  readonly host: string;
-  readonly port: number;
-}
-
-export function resolveProtocolPort(
-  protocol: ProtocolName,
-  protocolConfig?: {
-    mqtt?: { port?: number };
-    opcua?: { port?: number };
-    modbus?: { port?: number };
-  },
-): number {
-  switch (protocol) {
-    case "mqtt":
-      return protocolConfig?.mqtt?.port ?? DEFAULT_MQTT_PORT;
-    case "opcua":
-      return protocolConfig?.opcua?.port ?? DEFAULT_OPCUA_PORT;
-    case "modbus":
-      return protocolConfig?.modbus?.port ?? DEFAULT_MODBUS_PORT;
-    default: {
-      const _never: never = protocol;
-      throw new Error(`Unknown protocol: ${_never}`);
-    }
-  }
-}
-
-export function formatEndpoint(info: EndpointInfo): string {
-  return `${info.host}:${info.port}`;
-}

package/src/lib/le/le-environments.test.ts

@@ -1,73 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdtemp, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import {
-  addEnvironment,
-  environmentsFilePath,
-  getDefaultEnvironment,
-  loadEnvironments,
-  operationsFilePath,
-  platformsDirPath,
-} from "./le-environments.ts";
-
-let testHome = "";
-let prevMiravoHome: string | undefined;
-
-beforeEach(async () => {
-  prevMiravoHome = Bun.env["MIRAVO_HOME"];
-  testHome = await mkdtemp(join(tmpdir(), "miravo-platforms-test-"));
-  Bun.env["MIRAVO_HOME"] = testHome;
-});
-
-afterEach(async () => {
-  if (prevMiravoHome === undefined) {
-    delete Bun.env["MIRAVO_HOME"];
-  } else {
-    Bun.env["MIRAVO_HOME"] = prevMiravoHome;
-  }
-  await rm(testHome, { recursive: true, force: true });
-});
-
-describe("le-environments storage layout", () => {
-  test("writes environments under ~/.miravo/platforms/environments.json", async () => {
-    await addEnvironment({
-      platformId: "litmus-edge",
-      label: "Production LE",
-      hostname: "10.1.2.3",
-      apiToken: "token-1",
-      sourceHostname: "host.docker.internal",
-    });
-
-    const envs = await loadEnvironments();
-    expect(envs).toHaveLength(1);
-    expect(envs[0]?.label).toBe("Production LE");
-
-    const envFileExists = await Bun.file(environmentsFilePath()).exists();
-    const oldPathExists = await Bun.file(`${testHome}/platforms.json`).exists();
-    expect(platformsDirPath()).toBe(`${testHome}/platforms`);
-    expect(envFileExists).toBe(true);
-    expect(oldPathExists).toBe(false);
-  });
-
-  test("default environment is first entry in environments file", async () => {
-    await addEnvironment({
-      platformId: "litmus-edge",
-      label: "First",
-      hostname: "10.0.0.1",
-      apiToken: "first-token",
-      sourceHostname: "host.docker.internal",
-    });
-    await addEnvironment({
-      platformId: "litmus-edge",
-      label: "Second",
-      hostname: "10.0.0.2",
-      apiToken: "second-token",
-      sourceHostname: "host.docker.internal",
-    });
-
-    const defaultEnv = await getDefaultEnvironment();
-    expect(defaultEnv?.label).toBe("First");
-    expect(operationsFilePath()).toBe(`${testHome}/platforms/operations.jsonl`);
-  });
-});