serverless.yml

service: sync-games

frameworkVersion: "4"

package:
  individually: true

# Stage = entorno separado: cada uno tiene su propio stack (API Gateway, Lambda, S3 bucket).
# deploy --stage dev  → stack sync-games-dev, bucket y API de desarrollo.
# deploy --stage live → stack sync-games-live, bucket y API de producción.

provider:
  name: aws
  runtime: nodejs24.x
  region: us-east-2
  stage: ${opt:stage, 'dev'}
  architecture: arm64
  environment:
    BUCKET_NAME: { Ref: SavesBucket }
    API_KEY: ${env:SYNC_GAMES_API_KEY, ''}
    DOWNLOAD_BASE_URL: ${self:custom.downloadBaseUrl.${sls:stage}, ''}
    CONNECTIONS_TABLE: { Ref: ActiveConnectionsTable }
    GAME_STATS_TABLE: { Ref: GameStatsTable }
    SAVE_FILES_INDEX_TABLE: { Ref: SaveFilesIndexTable }
    WS_ENDPOINT:
      Fn::Join:
        - ""
        - - "https://"
          - Ref: WebsocketsApi
          - ".execute-api.${self:provider.region}.amazonaws.com/${sls:stage}"

  httpApi:
    authorizers:
      apiKeyAuthorizer:
        type: request
        functionName: apiAuthorizer
        enableSimpleResponses: true
        authorizerPayloadFormatVersion: "2.0"
        resultTtlInSeconds: 0
        identitySource:
          - "$request.header.host"

  iam:
    role:
      statements:
        - Effect: Allow
          Action:
            - s3:GetObject
            - s3:PutObject
            - s3:DeleteObject
            - s3:ListBucket
            - s3:CreateMultipartUpload
            - s3:AbortMultipartUpload
            - s3:CompleteMultipartUpload
            - s3:ListMultipartUploadParts
          Resource:
            - Fn::Sub: "arn:aws:s3:::${SavesBucket}"
            - Fn::Sub: "arn:aws:s3:::${SavesBucket}/*"

        - Effect: Allow
          Action:
            - dynamodb:PutItem
            - dynamodb:GetItem
            - dynamodb:DeleteItem
            - dynamodb:UpdateItem
            - dynamodb:Query
          Resource:
            - Fn::GetAtt: [ActiveConnectionsTable, Arn]
            - Fn::Join: ["/", [Fn::GetAtt: [ActiveConnectionsTable, Arn], "index", "*"]]
            - Fn::GetAtt: [GameStatsTable, Arn]
            - Fn::GetAtt: [SaveFilesIndexTable, Arn]

        - Effect: Allow
          Action:
            - execute-api:ManageConnections
          Resource:
            - "arn:aws:execute-api:*:*:**/@connections/*"

build:
  esbuild:
    bundle: true
    minify: true
    sourcemap: false
    target: "node24"

custom:
  downloadBaseUrl:
    dev: ""
    live: ${cf:sync-games-live.CloudFrontDistributionUrl, ''}
  # Seed Steam: dev sin schedule por defecto; live con regla (ajustar rate si hace falta).
  steamSeedScheduleEnabled:
    dev: false
    live: true
  steamSeedScheduleRate:
    dev: rate(24 hours)
    live: rate(5 minutes)
  # Valor por defecto de filtros appdetails.
  steamSeedFiltersDefault: "basic,developers,publishers,genres,categories,release_date,screenshots,movies"

resources:
  - ${file(infra/resources.${sls:stage, 'dev'}.yml)}

functions:
  apiAuthorizer:
    handler: apps/api/src/interfaces/lambda/authorizer.handler
    description: Autorizador por API key para savecloud - entorno ${sls:stage, 'dev'}
    environment:
      API_KEY: ${env:SYNC_GAMES_API_KEY, ''}

  api:
    handler: apps/api/src/interfaces/lambda/handler.handler
    description: API de guardados en la nube (savecloud) - entorno ${sls:stage, 'dev'}
    timeout: 30
    memorySize: 1536
    events:
      - httpApi:
          path: /{proxy+}
          method: ANY
          authorizer:
            name: apiKeyAuthorizer
      - httpApi:
          path: /
          method: ANY
          authorizer:
            name: apiKeyAuthorizer

  steamSeedWorker:
    handler: apps/api/src/interfaces/lambda/steam-seed/handler.handler
    description: Seed incremental Steam appdetails (S3 + EventBridge) - ${sls:stage, 'dev'}
    timeout: 900
    memorySize: 256
    reservedConcurrency: 1
    environment:
      STEAM_SEED_PREFIX: steam-seed
      STEAM_DELAY_MS: "1200"
      STEAM_BATCH_SIZE: "60"
      STEAM_MAX_CONCURRENCY: "4"
      STEAM_429_RETRIES: "2"
      STEAM_429_BASE_DELAY_MS: "1500"
      STEAM_BACKOFF_MINUTES: "30"
      STEAM_LANG: spanish
    events:
      - schedule:
          rate: ${self:custom.steamSeedScheduleRate.${sls:stage}, 'rate(15 minutes)'}
          enabled: ${self:custom.steamSeedScheduleEnabled.${sls:stage}, false}

  syncGameStats:
    handler: apps/api/src/interfaces/lambda/s3-events/syncGameStats.handler
    description: Actualiza DynamoDB cuando se sube/borra un save en S3 - ${sls:stage}
    timeout: 30
    events:
      - eventBridge:
          pattern:
            source:
              - aws.s3
            detail-type:
              - "Object Created"
              - "Object Deleted"
            detail:
              bucket:
                name:
                  - Ref: SavesBucket

  wsConnect:
    handler: apps/api/src/interfaces/lambda/websocket/connect.handler
    description: Maneja conexiones WebSocket entrantes - ${sls:stage}
    events:
      - websocket:
          route: $connect

  wsDisconnect:
    handler: apps/api/src/interfaces/lambda/websocket/disconnect.handler
    description: Limpia conexiones en DynamoDB - ${sls:stage}
    events:
      - websocket:
          route: $disconnect

  wsBroadcast:
    handler: apps/api/src/interfaces/lambda/websocket/broadcast.handler
    description: Recibe el evento "playing" y lo reparte a amigos - ${sls:stage}
    events:
      - websocket:
          route: broadcast