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 signalSetups.start 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 exampleSignalSetupsStart(client: RailDeckDirectIntegrationClient) {
  return client.signalSetups.start(
    "1",
    "18",
    {
      "requestId": "11111111-1111-4111-8111-111111111111",
      "configuration": {
        "displayName": "{{fixtureDisplayName}}",
        "definition": {
          "design": "four-aspect",
          "quadrant": null
        },
        "controllerId": "21",
        "firstAddress": 86,
        "notes": "Platform end\nFaces the approach track."
      }
    },
    {}
  );
}

/**
 * Calls signalSetups.get 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 exampleSignalSetupsGet(client: RailDeckDirectIntegrationClient) {
  return client.signalSetups.get(
    "1",
    "18",
    "11111111-1111-4111-8111-111111111111",
    {}
  );
}

/**
 * Calls signalSetups.trySetting 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 exampleSignalSetupsTrySetting(client: RailDeckDirectIntegrationClient) {
  return client.signalSetups.trySetting(
    "1",
    "18",
    {
      "requestId": "22222222-2222-4222-8222-222222222222",
      "setupId": "11111111-1111-4111-8111-111111111111",
      "expectedRevision": 1,
      "connection": {
        "address": 86,
        "output": 0
      }
    },
    {}
  );
}

/**
 * Calls signalSetups.cancel 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 exampleSignalSetupsCancel(client: RailDeckDirectIntegrationClient) {
  return client.signalSetups.cancel(
    "1",
    "18",
    {
      "requestId": "33333333-3333-4333-8333-333333333333",
      "setupId": "11111111-1111-4111-8111-111111111111",
      "expectedRevision": 1
    },
    {}
  );
}

/**
 * Calls signalSetups.save 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 exampleSignalSetupsSave(client: RailDeckDirectIntegrationClient) {
  return client.signalSetups.save(
    "1",
    "18",
    {
      "requestId": "33333333-3333-4333-8333-333333333333",
      "setupId": "11111111-1111-4111-8111-111111111111",
      "expectedRevision": 1,
      "completion": "finish-later",
      "observations": []
    },
    {}
  );
}