@seamapi/blueprint/src/lib/samples/python.ts

Build tools for the Seam API using this blueprint.

import { pascalCase, snakeCase } from 'change-case'

import type { Json, NonNullJson } from 'lib/json.js'

import type { CodeSampleContext, CodeSampleDefinition } from './code-sample.js'

const responseKeyToPythonResourceNameMap: Readonly<Record<string, string>> = {
  event: 'SeamEvent',
}

export const createPythonRequest = (
  { request }: CodeSampleDefinition,
  _context: CodeSampleContext,
): string => {
  const parts = request.path.split('/')
  const params = formatPythonArgs(request.parameters)

  return `seam${parts.map((p) => snakeCase(p)).join('.')}(${params})`
}

const formatPythonArgs = (jsonParams: NonNullJson): string =>
  Object.entries(jsonParams)
    .map(([paramKey, paramValue]) => {
      const formattedValue =
        paramValue == null ? 'None' : JSON.stringify(paramValue)

      return `${snakeCase(paramKey)}=${formattedValue}`
    })
    .join(', ')

export const createPythonResponse = (
  { response, title }: CodeSampleDefinition,
  context: CodeSampleContext,
): string => {
  const { endpoint } = context

  if (endpoint.response.responseType === 'void') return 'None'

  const { responseKey, resourceType } = endpoint.response
  const responseValue = response?.body?.[responseKey]

  if (responseValue == null) {
    throw new Error(`Missing ${responseKey} for '${title}'`)
  }

  const responsePythonClassName = pascalCase(
    responseKeyToPythonResourceNameMap[resourceType] ?? resourceType,
  )

  return Array.isArray(responseValue)
    ? formatPythonArrayResponse(responseValue, responsePythonClassName, title)
    : formatPythonResponse(responseValue, responsePythonClassName)
}

const formatPythonArrayResponse = (
  responseArray: Json[],
  responsePythonClassName: string,
  title: string,
): string => {
  const formattedItems = responseArray
    .map((v) => {
      if (v == null) {
        throw new Error(`Null value in response array for '${title}'`)
      }
      return formatPythonResponse(v, responsePythonClassName)
    })
    .join(', ')

  return `[${formattedItems}]`
}

const formatPythonResponse = (
  responseParams: NonNullJson,
  responsePythonClassName: string,
): string => {
  const params = formatPythonArgs(responseParams)
  return `${responsePythonClassName}(${params})`
}