← Public packages
@kody/origin
Inspect Cursor Origin repositories, pull requests, and installations with a saved Origin App.
Files
/**
* @fileoverview Read or update Origin App ids (`appId`, `installationId`) for one account namespace.
* Persist with `confirm: true` (no republish); preview with `dryRun: true`.
*
* @example
* import originSettings from 'kody:@kody/origin/settings'
* const current = await originSettings()
*/
import {
APP_ID_VALUE,
INSTALLATION_ID_VALUE,
readNamedSetting,
resolveOriginAccount,
writeNamedSetting,
} from './token.ts'
import { type OriginAccountInput, type OriginMutationInput } from './types.ts'
/**
* Read or update Origin App ids (`appId`, `installationId`) for one account namespace.
* Persist with `confirm: true` (no republish); preview with `dryRun: true`.
*
* @param input - Account namespace selectors.
* @returns Current Origin app/installation settings for the account.
*
* @example
* import originSettings from 'kody:@kody/origin/settings'
* const current = await originSettings()
*/
export async function readOriginSettings(input: OriginAccountInput = {}) {
const resolved = resolveOriginAccount(input)
const [appId, installationId] = await Promise.all([
readNamedSetting(resolved.appIdKey),
readNamedSetting(resolved.installationIdKey),
])
return {
account: resolved.account,
secretName: resolved.secretName,
appId: appId || null,
installationId: installationId || null,
appIdKey: resolved.appIdKey,
installationIdKey: resolved.installationIdKey,
}
}
/**
* Read or update Origin App ids for one account namespace.
* Pass `appId` and/or `installationId` with `dryRun: true` to preview, or
* `confirm: true` to persist them in this package's storage (no republish).
*
* @param input.account - Account namespace (default `origin`).
* @param input.appId - Origin App id to store (`app_01…`).
* @param input.installationId - Origin installation id to store (`i_01…`).
* @param input.dryRun - Preview a write without persisting.
* @param input.confirm - Persist the write.
* @returns Current or updated settings for the account namespace.
*
* @example
* import originSettings from 'kody:@kody/origin/settings'
* const current = await originSettings()
*/
export default async function originSettings(
input: OriginAccountInput &
OriginMutationInput & { appId?: string; installationId?: string } = {},
) {
const resolved = resolveOriginAccount(input)
const wouldUpdate: Array<string> = []
if (typeof input.appId === 'string' && input.appId.trim()) {
wouldUpdate.push('appId')
}
if (typeof input.installationId === 'string' && input.installationId.trim()) {
wouldUpdate.push('installationId')
}
const settings = await readOriginSettings(input)
if (wouldUpdate.length === 0) return settings
if (input.dryRun === true) {
return {
dryRun: true,
account: resolved.account,
wouldUpdate,
settings,
}
}
if (input.confirm !== true) {
throw new Error(
`Saving Origin settings for account "${resolved.account}" requires dryRun: true or confirm: true.`,
)
}
const updated: Array<string> = []
if (typeof input.appId === 'string' && input.appId.trim()) {
await writeNamedSetting(resolved.appIdKey, input.appId)
updated.push('appId')
}
if (typeof input.installationId === 'string' && input.installationId.trim()) {
await writeNamedSetting(resolved.installationIdKey, input.installationId)
updated.push('installationId')
}
return { updated, settings: await readOriginSettings(input) }
}
export { APP_ID_VALUE, INSTALLATION_ID_VALUE }