seahaven-ap/packages/api/openapi/openapi.yaml

openapi: 3.1.0
info:
  title: Sea Haven AP API
  version: 1.0.0
  description: "Accounts payable HTTP API for Sea Haven Industries. Liveness, readiness, and authenticated session smoke under local and AWS runtimes."
  license:
    name: Proprietary
servers:
  - url: http://127.0.0.1:8787
    description: Local API process used by Vite proxy and unit tests.
tags:
  - name: Health
    description: Liveness and readiness checks for the API process.
  - name: Session
    description: Authenticated caller identity after JWT or local dev auth.
paths:
  /api/health:
    $ref: ./paths/health.yaml
  /api/ready:
    $ref: ./paths/ready.yaml
  /api/me:
    $ref: ./paths/me.yaml
components:
  securitySchemes:
    bearerAuth:
      $ref: ./components/security.yaml#/bearerAuth
  schemas:
    Error:
      $ref: ./components/schemas.yaml#/Error
    HealthResponse:
      $ref: ./components/schemas.yaml#/HealthResponse
    ReadyResponse:
      $ref: ./components/schemas.yaml#/ReadyResponse
    MeResponse:
      $ref: ./components/schemas.yaml#/MeResponse