apiVersion: naftiko/v1
kind: Capability
metadata:
  name: uplink-to-cloud
  provider: the-things-network
  description: Stream end-device uplinks from The Things Stack to a downstream cloud or analytics system via webhooks, MQTT, or Pub/Sub integrations, and optionally persist to the Storage Integration for replay.
  tags:
    - LoRaWAN
    - Integrations
    - Webhooks
    - MQTT
    - Pub/Sub
spec:
  inputs:
    application_id:
      type: string
    webhook:
      type: object
      description: ApplicationWebhook including base_url, headers, format (json/protobuf), and per-message enable flags (uplink_message, join_accept, downlink_ack, etc.).
  steps:
    - id: create-webhook
      operation: ApplicationServer.ApplicationWebhookRegistry.Set
      path: /as/webhooks/{application_id}/{webhook_id}
    - id: create-pubsub
      operation: ApplicationServer.ApplicationPubSubRegistry.Set
      path: /as/pubsub/{application_id}/{pub_sub_id}
    - id: query-storage
      operation: ApplicationServer.ApplicationUpStorage.GetStoredApplicationUp
      path: /as/applications/{application_id}/packages/storage/uplink_message
    - id: subscribe-events
      operation: Events.Stream
      path: /events
  outputs:
    delivery_target:
      type: string
    last_uplink_at:
      type: string
      format: date-time