client.ts

// Builds the template context for client files
// (lib/seam/routes/{snake_name}.rb).
// Mirrors the output of the nextlove RubyClient#serialize.

import {
  type ClientMethod,
  type ClientModel,
  sortClientMethodParameters,
} from '../ruby-client.js'

export interface ClientMethodLayoutContext {
  description: string
  isDeprecated: boolean
  deprecationMessage: string
  responseDescription: string
  parameters: ClientMethod['parameters']
  name: string
  hasSignature: boolean
  signatureParams: string
  hasParams: boolean
  bodyParams: string
  path: string
  usesRes: boolean
  isResource: boolean
  isPoll: boolean
  isNil: boolean
  returnResource: string
  returnPath: string
}

export interface ClientLayoutContext {
  className: string
  importActionAttempt: boolean
  childClients: Array<{ namespace: string; clientName: string }>
  methods: ClientMethodLayoutContext[]
}

const getMethodLayoutContext = (
  method: ClientMethod,
): ClientMethodLayoutContext => {
  const { methodName, path, parameters, returnResource, returnPath } = method

  const hasReturnValue = returnResource != null && returnPath !== ''
  const canPollActionAttempt = returnPath === 'action_attempt'
  const hasParams = parameters.length > 0

  const sortedParameters = sortClientMethodParameters(parameters)

  const signatureParams = sortedParameters
    .map((p) => `${p.name}${p.required ?? false ? ':' : ': nil'}`)
    .concat(canPollActionAttempt ? ['wait_for_action_attempt: nil'] : [])
    .join(', ')

  const bodyParams = `{${sortedParameters
    .map((p) => `${p.name}: ${p.name}`)
    .join(', ')}}`

  const isResource = hasReturnValue && !canPollActionAttempt
  const isPoll = canPollActionAttempt
  const isNil = !hasReturnValue

  return {
    description: method.description,
    isDeprecated: method.isDeprecated,
    deprecationMessage: method.deprecationMessage,
    responseDescription: method.responseDescription,
    parameters: sortedParameters,
    name: methodName,
    hasSignature: signatureParams.length > 0,
    signatureParams,
    hasParams,
    bodyParams,
    path,
    usesRes: isResource || isPoll,
    isResource,
    isPoll,
    isNil,
    returnResource: returnResource ?? '',
    returnPath,
  }
}

export const setClientLayoutContext = (
  cls: ClientModel,
): ClientLayoutContext => ({
  className: cls.name,
  importActionAttempt: cls.methods.some(
    ({ returnResource }) => returnResource === 'ActionAttempt',
  ),
  childClients: cls.childClientIdentifiers.map((i) => ({
    namespace: i.namespace,
    clientName: i.clientName,
  })),
  methods: cls.methods.map(getMethodLayoutContext),
})