simstudioai--sim/apps/sim/app/api/tools/onepassword/update-item/route.ts

import { createLogger } from '@sim/logger'
import { getErrorMessage } from '@sim/utils/errors'
import { generateId } from '@sim/utils/id'
import { type NextRequest, NextResponse } from 'next/server'
import { onePasswordUpdateItemContract } from '@/lib/api/contracts/tools/onepassword'
import { parseRequest, validationErrorResponse } from '@/lib/api/server'
import { checkInternalAuth } from '@/lib/auth/hybrid'
import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
import {
  connectItemToSdkItem,
  connectRequest,
  createOnePasswordClient,
  normalizeSdkItem,
  resolveCredentials,
} from '../utils'

const logger = createLogger('OnePasswordUpdateItemAPI')

export const POST = withRouteHandler(async (request: NextRequest) => {
  const requestId = generateId().slice(0, 8)

  const auth = await checkInternalAuth(request)
  if (!auth.success || !auth.userId) {
    logger.warn(`[${requestId}] Unauthorized 1Password update-item attempt`)
    return NextResponse.json({ error: auth.error || 'Unauthorized' }, { status: 401 })
  }

  try {
    const parsed = await parseRequest(
      onePasswordUpdateItemContract,
      request,
      {},
      {
        validationErrorResponse: (error) => validationErrorResponse(error, 'Invalid request data'),
      }
    )
    if (!parsed.success) return parsed.response
    const params = parsed.data.body
    const creds = resolveCredentials(params)
    const ops = JSON.parse(params.operations) as JsonPatchOperation[]

    logger.info(
      `[${requestId}] Updating item ${params.itemId} in vault ${params.vaultId} (${creds.mode} mode)`
    )

    if (creds.mode === 'service_account') {
      const client = await createOnePasswordClient(creds.serviceAccountToken!)

      const existing = await client.items.get(params.vaultId, params.itemId)

      // Patch operations are documented and typed against the Connect-shaped
      // vocabulary (label/type/section.id) that get_item/create_item/replace_item
      // return — apply them to that normalized view, then convert back to the
      // SDK's vocabulary (title/fieldType/sectionId) before writing. Patching the
      // raw SDK item directly would silently no-op most field/category writes.
      // eslint-disable-next-line @typescript-eslint/no-explicit-any
      const connectItem = normalizeSdkItem(existing) as Record<string, any>
      for (const op of ops) {
        applyPatch(connectItem, op)
      }

      const sdkItem = connectItemToSdkItem(connectItem, existing)
      const result = await client.items.put(sdkItem)
      return NextResponse.json(normalizeSdkItem(result))
    }

    const response = await connectRequest({
      serverUrl: creds.serverUrl!,
      apiKey: creds.apiKey!,
      path: `/v1/vaults/${params.vaultId}/items/${params.itemId}`,
      method: 'PATCH',
      body: ops,
    })

    const data = await response.json()
    if (!response.ok) {
      return NextResponse.json(
        { error: data.message || 'Failed to update item' },
        { status: response.status }
      )
    }

    return NextResponse.json(data)
  } catch (error) {
    const message = getErrorMessage(error, 'Unknown error')
    logger.error(`[${requestId}] Update item failed:`, error)
    return NextResponse.json({ error: `Failed to update item: ${message}` }, { status: 500 })
  }
})

interface JsonPatchOperation {
  op: 'add' | 'remove' | 'replace'
  path: string
  value?: unknown
}

/** Apply a single RFC6902 JSON Patch operation to a mutable object. */
// eslint-disable-next-line @typescript-eslint/no-explicit-any
function applyPatch(item: Record<string, any>, op: JsonPatchOperation) {
  const segments = op.path.split('/').filter(Boolean)

  if (segments.length === 1) {
    const key = segments[0]
    if (op.op === 'replace' || op.op === 'add') {
      item[key] = op.value
    } else if (op.op === 'remove') {
      delete item[key]
    }
    return
  }

  let target = item
  for (let i = 0; i < segments.length - 1; i++) {
    const seg = segments[i]
    if (Array.isArray(target)) {
      target = arrayElementForSegment(target, seg)
    } else {
      target = target[seg]
    }
    if (target === undefined || target === null) return
  }

  const lastSeg = segments[segments.length - 1]

  if (op.op === 'replace' || op.op === 'add') {
    if (Array.isArray(target) && lastSeg === '-') {
      target.push(op.value)
    } else if (Array.isArray(target)) {
      const index = arrayIndexForSegment(target, lastSeg)
      if (index !== -1) target[index] = op.value
    } else {
      target[lastSeg] = op.value
    }
  } else if (op.op === 'remove') {
    if (Array.isArray(target)) {
      const index = arrayIndexForSegment(target, lastSeg)
      if (index !== -1) target.splice(index, 1)
    } else {
      delete target[lastSeg]
    }
  }
}

/**
 * Resolves an array element for a JSON Patch path segment. 1Password's PATCH API
 * addresses items in the `fields`/`sections` arrays by their `id`, not by numeric
 * array index (e.g. `/fields/{fieldId}/value`), so a numeric-looking segment is
 * only treated as a literal index when no element's `id` matches it.
 */
// eslint-disable-next-line @typescript-eslint/no-explicit-any
function arrayIndexForSegment(target: any[], segment: string): number {
  const byId = target.findIndex((el) => el && typeof el === 'object' && el.id === segment)
  if (byId !== -1) return byId
  const index = Number(segment)
  return Number.isInteger(index) && index >= 0 && index < target.length ? index : -1
}

// eslint-disable-next-line @typescript-eslint/no-explicit-any
function arrayElementForSegment(target: any[], segment: string): any {
  const index = arrayIndexForSegment(target, segment)
  return index === -1 ? undefined : target[index]
}