feat: api gateway management api on /_arc/ws

[reconbot]

Works! I've tested this outside of our library.

TODO

• make it work
• Update arc/functions feat: switch websockets to use ApiGatewayManagementApi in sandbox and production functions#499
• write some tests
• complain about how any consumer of this thing needs to set multiple env vars like ARC_INTERNAL in addition to PORT and whatever else, there's no easy way to change the port range on the producer or consumer side of the sandbox, you got to set everything.

references

• https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html
• https://unpkg.com/browse/aws-sdk@2.973.0/clients/apigatewaymanagementapi.d.ts
• https://unpkg.com/browse/aws-sdk@2.973.0/apis/apigatewaymanagementapi-2018-11-29.min.json

Working code for arc functions (only sandbox tested)

const makeManagementAPI = () => {
  const ARC_WSS_URL = process.env.ARC_WSS_URL
  const port = process.env.ARC_INTERNAL || '3332'

  if (process.env.NODE_ENV === 'testing') {
    return new ApiGatewayManagementApi({
      apiVersion: '2018-11-29',
      endpoint: `http://localhost:${port}/_arc/ws`,
      region: process.env.AWS_REGION || 'us-west-2',
    })
  }
  return new ApiGatewayManagementApi({
    apiVersion: '2018-11-29',
    endpoint: `${ARC_WSS_URL.replace(/$ws/, 'http')}`,
  })
}

closes architect/architect#1204

Thank you for helping out! ✨

We really appreciate your commitment to improving Architect

To maintain a high standard of quality in our releases, before merging every pull request we ask that you've completed the following:

• Forked the repo and created your branch from master
• Made sure tests pass (run npm it from the repo root)
• Expanded test coverage related to your changes:
  • Added and/or updated unit tests (if appropriate)
  • Added and/or updated integration tests (if appropriate)
• Updated relevant documentation:
  • Internal to this repo (e.g. readme.md, help docs, inline docs & comments, etc.)
  • Architect docs (arc.codes)
• Summarized your changes in changelog.md
• Linked to any related issues, PRs, etc. below that may relate to, consume, or necessitate these changes

Please also be sure to completed the CLA (if you haven't already).

Learn more about contributing to Architect here.

Thanks again!

[reconbot]

I couldn't find anything in ws that lets us know this.

[reconbot]

rebased

[reconbot]

rebased again 🤞