Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/** Typed renderer/main boundary for the auth-server login and account lifecycle flows. */
import type {
AccountDeletionAvailability,
AccountDeletionStatus,
AuthFlowState,
VerificationKind,
} from '@cindy/auth-client';
export type DesktopLoginAction =
| { type: 'reset' }
| { type: 'back' }
| { type: 'cancel-browser' }
| { type: 'discover'; email: string }
| { type: 'discover-sso-org'; org: string }
| { type: 'confirm-sso-realm' }
| { type: 'cancel-sso-realm' }
| { type: 'request-code'; kind: VerificationKind; identifier: string; captchaToken?: string }
| { type: 'verify-code'; kind: VerificationKind; identifier: string; code: string }
| {
type: 'start-browser';
kind: 'social' | 'sso';
providerOrConnectionId: string;
label: string;
}
| { type: 'select-account'; accountId: string }
| { type: 'request-sso-verification-code' }
| { type: 'verify-sso-verification'; code: string }
| { type: 'request-binding-code'; contact: string }
| { type: 'verify-binding'; contact: string; code: string };
/** In-memory presentation metadata; never a persisted cooldown or retry budget. */
export type DesktopLoginState = (AuthFlowState | { step: 'entry' }) & { retryAt?: number };
export type DesktopLoginActionResult =
| { success: true; state: DesktopLoginState }
| { success: false; code: string; state: DesktopLoginState | null; retryAt?: number };
/**
* 登录准备态(「正在连接登录服务」)最多转圈的时长。
* main 的 getProviders 闸与 renderer `loadLoginState` 共用,超时后落到既有 error 步。
*/
export const LOGIN_PREPARING_UNLOCK_TIMEOUT_MS = 30_000;
export type SettledDesktopLoginActionResult =
| { success: true; state: DesktopLoginState }
| { success: false; code: string; state: DesktopLoginState; retryAt?: number };
export function loginPreparingErrorState(
code = 'AUTH_SERVICE_UNAVAILABLE',
retryAt?: number,
): Extract<DesktopLoginState, { step: 'error' }> {
return {
step: 'error',
code,
recoverTo: 'identifier',
...(code === 'RATE_LIMITED' && retryAt !== undefined ? { retryAt } : {}),
};
}
/** IPC 失败且 `state == null` 时不得让 renderer 停在 preparing。 */
export function settleDesktopLoginResult(
result: DesktopLoginActionResult,
): SettledDesktopLoginActionResult {
if (result.state) {
return result.success
? { success: true, state: result.state }
: { ...result, state: result.state };
}
const code = result.success === false ? result.code : 'AUTH_SERVICE_UNAVAILABLE';
return { ...result, success: false, code, state: loginPreparingErrorState(code) };
}
/**
* 限时等待 getLoginState。超时或 throw 都落到可重试 error 步,不 abort 在途请求。
* 迟到 settle 忽略(与 main 准备态闸一致:只解锁 UI)。
*/
export async function awaitDesktopLoginStateLoad(
getLoginState: () => Promise<DesktopLoginActionResult>,
timeoutMs: number = LOGIN_PREPARING_UNLOCK_TIMEOUT_MS,
): Promise<SettledDesktopLoginActionResult> {
const load = getLoginState().then(settleDesktopLoginResult, () => ({
success: false as const,
code: 'AUTH_SERVICE_UNAVAILABLE',
state: loginPreparingErrorState(),
}));
if (timeoutMs <= 0) return load;
let timer: ReturnType<typeof setTimeout> | undefined;
const timeout = new Promise<SettledDesktopLoginActionResult>((resolve) => {
timer = setTimeout(() => {
resolve({
success: false,
code: 'AUTH_SERVICE_UNAVAILABLE',
state: loginPreparingErrorState(),
});
}, timeoutMs);
});
try {
return await Promise.race([load, timeout]);
} finally {
if (timer !== undefined) clearTimeout(timer);
}
}
export interface DesktopSavedAccount {
/** Opaque main-owned identifier. Renderer must not derive realm or membership ids from it. */
accountKey: string;
displayName: string;
email: string | null;
avatarUrl: string | null;
kind: 'personal' | 'org';
orgName: string | null;
orgLogoUrl: string | null;
isCurrent: boolean;
}
export interface DesktopAccountSwitcherSnapshot {
accounts: DesktopSavedAccount[];
mutationAllowed: boolean;
}
/** The receipt token stays in Electron main; renderer only receives display-safe fields. */
export interface DesktopAccountDeletionChallenge {
challengeId: string;
channel: 'email' | 'sms';
maskedTarget: string;
expiresAt: string;
}
export interface DesktopAccountDeletionConfirmInput {
challengeId: string;
code: string;
}
/** Account-deletion IPC keeps auth-server error codes as structured UI metadata. */
export type DesktopAccountDeletionResult<T> =
{ success: true; value: T } | { success: false; code: string };
export type DesktopAccountDeletionAvailabilityResult =
DesktopAccountDeletionResult<AccountDeletionAvailability>;
export type DesktopAccountDeletionChallengeResult =
DesktopAccountDeletionResult<DesktopAccountDeletionChallenge>;
export type DesktopAccountDeletionConfirmResult =
DesktopAccountDeletionResult<AccountDeletionStatus>;
export type DesktopAccountDeletionStatusResult =
DesktopAccountDeletionResult<AccountDeletionStatus | null>;
const MAX_IDENTIFIER_LENGTH = 320;
const MAX_OPAQUE_ID_LENGTH = 256;
const MAX_CODE_LENGTH = 32;
// Turnstile token 官方上限 2048 字符(服务端 schema 同值)。
const MAX_CAPTCHA_TOKEN_LENGTH = 2048;
// 与 auth-server 的企业 ID / slug / 已验证域名统一上限对齐。
const MAX_ORG_IDENTIFIER_LENGTH = 253;
const MAX_ACCOUNT_KEY_LENGTH = 512;
function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === 'object' && value !== null && !Array.isArray(value);
}
function isBoundedString(value: unknown, maxLength: number): value is string {
return typeof value === 'string' && value.length > 0 && value.length <= maxLength;
}
function isVerificationKind(value: unknown): value is VerificationKind {
return value === 'email' || value === 'phone';
}
/**
* Runtime validation for the untrusted renderer-to-main IPC boundary. The
* returned object only contains fields recognized by the selected action.
*/
export function parseDesktopLoginAction(value: unknown): DesktopLoginAction | null {
if (!isRecord(value) || typeof value.type !== 'string') return null;
switch (value.type) {
case 'reset':
return { type: 'reset' };
case 'back':
return { type: 'back' };
case 'cancel-browser':
return { type: 'cancel-browser' };
case 'discover':
return isBoundedString(value.email, MAX_IDENTIFIER_LENGTH)
? { type: 'discover', email: value.email }
: null;
case 'discover-sso-org':
return isBoundedString(value.org, MAX_ORG_IDENTIFIER_LENGTH)
? { type: 'discover-sso-org', org: value.org }
: null;
case 'confirm-sso-realm':
return { type: 'confirm-sso-realm' };
case 'cancel-sso-realm':
return { type: 'cancel-sso-realm' };
case 'request-code': {
if (
!isVerificationKind(value.kind) ||
!isBoundedString(value.identifier, MAX_IDENTIFIER_LENGTH)
) {
return null;
}
// captchaToken 缺省合法(cn 构建 / captcha 未启用);一旦携带必须过界校验,
// 非法则整条 action 拒绝,不做静默剥离。
if (value.captchaToken === undefined) {
return { type: 'request-code', kind: value.kind, identifier: value.identifier };
}
return isBoundedString(value.captchaToken, MAX_CAPTCHA_TOKEN_LENGTH)
? {
type: 'request-code',
kind: value.kind,
identifier: value.identifier,
captchaToken: value.captchaToken,
}
: null;
}
case 'verify-code':
return isVerificationKind(value.kind) &&
isBoundedString(value.identifier, MAX_IDENTIFIER_LENGTH) &&
isBoundedString(value.code, MAX_CODE_LENGTH)
? {
type: 'verify-code',
kind: value.kind,
identifier: value.identifier,
code: value.code,
}
: null;
case 'start-browser':
return (value.kind === 'social' || value.kind === 'sso') &&
isBoundedString(value.providerOrConnectionId, MAX_OPAQUE_ID_LENGTH) &&
isBoundedString(value.label, MAX_OPAQUE_ID_LENGTH)
? {
type: 'start-browser',
kind: value.kind,
providerOrConnectionId: value.providerOrConnectionId,
label: value.label,
}
: null;
case 'select-account':
return isBoundedString(value.accountId, MAX_OPAQUE_ID_LENGTH)
? { type: 'select-account', accountId: value.accountId }
: null;
case 'request-sso-verification-code':
return { type: 'request-sso-verification-code' };
case 'verify-sso-verification':
return isBoundedString(value.code, MAX_CODE_LENGTH)
? { type: 'verify-sso-verification', code: value.code }
: null;
case 'request-binding-code':
return isBoundedString(value.contact, MAX_IDENTIFIER_LENGTH)
? { type: 'request-binding-code', contact: value.contact }
: null;
case 'verify-binding':
return isBoundedString(value.contact, MAX_IDENTIFIER_LENGTH) &&
isBoundedString(value.code, MAX_CODE_LENGTH)
? { type: 'verify-binding', contact: value.contact, code: value.code }
: null;
default:
return null;
}
}
export function parseDesktopAccountKey(value: unknown): string | null {
return isBoundedString(value, MAX_ACCOUNT_KEY_LENGTH) ? value : null;
}
/** Runtime validation for the irreversible account-deletion confirmation boundary. */
export function parseDesktopAccountDeletionConfirmInput(
value: unknown,
): DesktopAccountDeletionConfirmInput | null {
if (!isRecord(value)) return null;
if (!isBoundedString(value.challengeId, MAX_OPAQUE_ID_LENGTH)) return null;
if (typeof value.code !== 'string' || !/^\d{6}$/.test(value.code)) return null;
return { challengeId: value.challengeId, code: value.code };
}