Function parseEndpoint

apps/sim/connectors/s3/s3.ts:150–187

* Parses and validates a custom S3-compatible endpoint string. * * Accepts a full origin such as `https://accountid.r2.cloudflarestorage.com` or * `http://localhost:9000`. Trailing slashes are stripped. Throws when the value * is not a valid URL, carries a path/query/fragment beyond `/` (which w

(raw: string)

 * the SigV4 canonical Host byte-identical to the wire Host.
 */
function parseEndpoint(raw: string): S3Endpoint {
  let url: URL
  try {
    url = new URL(raw)
  } catch {
    throw new Error('Endpoint must be a valid URL, e.g. https://accountid.r2.cloudflarestorage.com')
  }

  if (url.protocol !== 'https:' && url.protocol !== 'http:') {
    throw new Error('Endpoint must use http:// or https://')
  }
  const scheme = url.protocol === 'https:' ? 'https' : 'http'

  if (url.username || url.password) {
    throw new Error('Endpoint must not contain credentials')
  }
  if (url.search || url.hash) {
    throw new Error('Endpoint must not contain a query string or fragment')
  }
  const path = url.pathname.replace(/\/+$/, '')
  if (path !== '') {
    throw new Error('Endpoint must not contain a path — provide only the host, e.g. https://host')
  }

  const host = url.hostname
  if (!host) throw new Error('Endpoint is missing a host')
  if (scheme === 'http' && !(isLoopbackHost(host) && !isHosted)) {
    throw new Error(
      'Plain http:// endpoints are only allowed for localhost on self-hosted deployments — use https:// otherwise'
    )
  }

  const defaultPort = scheme === 'https' ? '443' : '80'
  const port = url.port && url.port !== defaultPort ? url.port : ''
  const hostHeader = port ? `${host}:${port}` : host

  return { scheme, host, hostHeader }
}

/**
 * Resolves AWS credentials and the target bucket from the connector's