apiVersion: naftiko/v1
kind: Capability
metadata:
  name: gateway-onboarding
  provider: the-things-network
  description: Register, claim, and configure a LoRaWAN gateway on The Things Stack including frequency plan assignment, location, and managed-gateway WiFi/Ethernet profiles where applicable.
  tags:
    - LoRaWAN
    - Gateway
    - Onboarding
spec:
  inputs:
    gateway:
      type: object
      description: Gateway record with ids (gateway_id, eui), frequency_plan_id, location, and antenna gain.
    claim_token:
      type: string
      description: Optional secure claim token for managed gateways.
  steps:
    - id: create-gateway
      operation: IdentityServer.GatewayRegistry.Create
      path: /users/{user_id}/gateways
    - id: claim-gateway
      operation: GatewayClaimingServer.Claim
      path: /gcls/claim
    - id: set-managed-config
      operation: ManagedGatewayConfigurationService.Set
      path: /gcs/gateways/managed/{gateway_id}/configuration
    - id: assign-frequency-plan
      operation: NetworkServer.GatewayConfigurationService.GetGatewayConfiguration
      path: /api/v3/gcs/gateways/configuration/{gateway_id}/{filename}
    - id: monitor-status
      operation: GatewayServer.Gs.GetGatewayConnectionStats
      path: /gs/gateways/{gateway_id}/connection/stats
  outputs:
    gateway_id:
      type: string
    online:
      type: boolean