import type { RailDeckDirectIntegrationClient } from '@raildeck/frontend-sdk/direct-integration';

// Fixture values illustrate the source contract. Use reviewed development records.
// Importing this module performs no requests. Every mutation requires an explicit call.

/**
 * Calls locomotiveCvs.listValues with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsListValues(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.listValues(
    "account-1",
    "loco-1"
  );
}

/**
 * Calls locomotiveCvs.getValue with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsGetValue(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.getValue(
    "account 1",
    "loco 1",
    29
  );
}

/**
 * Calls locomotiveCvs.setValue with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsSetValue(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.setValue(
    "account-1",
    "loco-1",
    3,
    {
      "value": 12,
      "source": "manual",
      "notes": "Demo value"
    }
  );
}

/**
 * Calls locomotiveCvs.deleteValue with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsDeleteValue(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.deleteValue(
    "account 1",
    "loco 1",
    29
  );
}

/**
 * Calls locomotiveCvs.readValue with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsReadValue(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.readValue(
    "account-1",
    "loco-1",
    29,
    {
      "controllerId": "controller-1",
      "idempotencyKey": "read-29"
    }
  );
}

/**
 * Calls locomotiveCvs.writeValue with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsWriteValue(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.writeValue(
    "account-1",
    "loco-1",
    2,
    {
      "controllerId": "controller-1",
      "value": 5
    }
  );
}

/**
 * Calls locomotiveCvs.getTuning with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsGetTuning(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.getTuning(
    "account 1",
    "loco 1"
  );
}

/**
 * Calls locomotiveCvs.updateTuning with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsUpdateTuning(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.updateTuning(
    "account-1",
    "loco-1",
    {
      "values": {
        "acceleration": 12,
        "topSpeed": null
      }
    }
  );
}

/**
 * Calls locomotiveCvs.listProgrammingPresets with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsListProgrammingPresets(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.listProgrammingPresets(
    "account-1",
    "loco-1"
  );
}

/**
 * Calls locomotiveCvs.listProgrammingBatches with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsListProgrammingBatches(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.listProgrammingBatches(
    "account 1",
    "loco 1"
  );
}

/**
 * Calls locomotiveCvs.createProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsCreateProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.createProgrammingBatch(
    "account-1",
    "loco-1",
    {
      "controllerId": "controller-1",
      "presetCode": "smooth-driving",
      "values": {
        "acceleration": 10
      },
      "verifyAfterWrite": true
    }
  );
}

/**
 * Calls locomotiveCvs.getProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsGetProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.getProgrammingBatch(
    "account 1",
    "loco 1",
    "batch 1"
  );
}

/**
 * Calls locomotiveCvs.startProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsStartProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.startProgrammingBatch(
    "account-1",
    "loco-1",
    "batch-1"
  );
}

/**
 * Calls locomotiveCvs.pauseProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsPauseProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.pauseProgrammingBatch(
    "account-1",
    "loco-1",
    "batch-1"
  );
}

/**
 * Calls locomotiveCvs.resumeProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsResumeProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.resumeProgrammingBatch(
    "account 1",
    "loco 1",
    "batch 1"
  );
}

/**
 * Calls locomotiveCvs.retryProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsRetryProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.retryProgrammingBatch(
    "account 1",
    "loco 1",
    "batch 1"
  );
}

/**
 * Calls locomotiveCvs.cancelProgrammingBatch with retained, non-production fixture values.
 * @param client - Configured source client; use an isolated development environment.
 * @returns The SDK result; failures propagate without automatic retry.
 */
export async function exampleLocomotiveCvsCancelProgrammingBatch(client: RailDeckDirectIntegrationClient) {
  return client.locomotiveCvs.cancelProgrammingBatch(
    "account 1",
    "loco 1",
    "batch 1"
  );
}