mirror of
https://github.com/Start9Labs/start-os.git
synced 2026-03-26 10:21:52 +00:00
* add documentation for ai agents * docs: consolidate CLAUDE.md and CONTRIBUTING.md, add style guidelines - Refactor CLAUDE.md to reference CONTRIBUTING.md for build/test/format info - Expand CONTRIBUTING.md with comprehensive build targets, env vars, and testing - Add code style guidelines section with conventional commits - Standardize SDK prettier config to use single quotes (matching web) - Add project-level Claude Code settings to disable co-author attribution * style(sdk): apply prettier with single quotes Run prettier across sdk/base and sdk/package to apply the standardized quote style (single quotes matching web). * docs: add USER.md for per-developer TODO filtering - Add agents/USER.md to .gitignore (contains user identifier) - Document session startup flow in CLAUDE.md: - Create USER.md if missing, prompting for identifier - Filter TODOs by @username tags - Offer relevant TODOs on session start * docs: add i18n documentation task to agent TODOs * docs: document i18n ID patterns in core/ Add agents/i18n-patterns.md covering rust-i18n setup, translation file format, t!() macro usage, key naming conventions, and locale selection. Remove completed TODO item and add reference in CLAUDE.md. * chore: clarify that all builds work on any OS with Docker
111 lines
3.0 KiB
TypeScript
111 lines
3.0 KiB
TypeScript
import { Effects } from '../Effects'
|
|
import * as T from '../types'
|
|
import { DropGenerator, DropPromise } from './Drop'
|
|
|
|
export class GetSystemSmtp {
|
|
constructor(readonly effects: Effects) {}
|
|
|
|
/**
|
|
* Returns the system SMTP credentials. Reruns the context from which it has been called if the underlying value changes
|
|
*/
|
|
const() {
|
|
return this.effects.getSystemSmtp({
|
|
callback:
|
|
this.effects.constRetry &&
|
|
(() => this.effects.constRetry && this.effects.constRetry()),
|
|
})
|
|
}
|
|
/**
|
|
* Returns the system SMTP credentials. Does nothing if the credentials change
|
|
*/
|
|
once() {
|
|
return this.effects.getSystemSmtp({})
|
|
}
|
|
|
|
private async *watchGen(abort?: AbortSignal) {
|
|
const resolveCell = { resolve: () => {} }
|
|
this.effects.onLeaveContext(() => {
|
|
resolveCell.resolve()
|
|
})
|
|
abort?.addEventListener('abort', () => resolveCell.resolve())
|
|
while (this.effects.isInContext && !abort?.aborted) {
|
|
let callback: () => void = () => {}
|
|
const waitForNext = new Promise<void>((resolve) => {
|
|
callback = resolve
|
|
resolveCell.resolve = resolve
|
|
})
|
|
yield await this.effects.getSystemSmtp({
|
|
callback: () => callback(),
|
|
})
|
|
await waitForNext
|
|
}
|
|
return new Promise<never>((_, rej) => rej(new Error('aborted')))
|
|
}
|
|
|
|
/**
|
|
* Watches the system SMTP credentials. Returns an async iterator that yields whenever the value changes
|
|
*/
|
|
watch(
|
|
abort?: AbortSignal,
|
|
): AsyncGenerator<T.SmtpValue | null, never, unknown> {
|
|
const ctrl = new AbortController()
|
|
abort?.addEventListener('abort', () => ctrl.abort())
|
|
return DropGenerator.of(this.watchGen(ctrl.signal), () => ctrl.abort())
|
|
}
|
|
|
|
/**
|
|
* Watches the system SMTP credentials. Takes a custom callback function to run whenever the credentials change
|
|
*/
|
|
onChange(
|
|
callback: (
|
|
value: T.SmtpValue | null,
|
|
error?: Error,
|
|
) => { cancel: boolean } | Promise<{ cancel: boolean }>,
|
|
) {
|
|
;(async () => {
|
|
const ctrl = new AbortController()
|
|
for await (const value of this.watch(ctrl.signal)) {
|
|
try {
|
|
const res = await callback(value)
|
|
if (res.cancel) {
|
|
ctrl.abort()
|
|
break
|
|
}
|
|
} catch (e) {
|
|
console.error(
|
|
'callback function threw an error @ GetSystemSmtp.onChange',
|
|
e,
|
|
)
|
|
}
|
|
}
|
|
})()
|
|
.catch((e) => callback(null, e))
|
|
.catch((e) =>
|
|
console.error(
|
|
'callback function threw an error @ GetSystemSmtp.onChange',
|
|
e,
|
|
),
|
|
)
|
|
}
|
|
|
|
/**
|
|
* Watches the system SMTP credentials. Returns when the predicate is true
|
|
*/
|
|
waitFor(
|
|
pred: (value: T.SmtpValue | null) => boolean,
|
|
): Promise<T.SmtpValue | null> {
|
|
const ctrl = new AbortController()
|
|
return DropPromise.of(
|
|
Promise.resolve().then(async () => {
|
|
for await (const next of this.watchGen(ctrl.signal)) {
|
|
if (pred(next)) {
|
|
return next
|
|
}
|
|
}
|
|
return null
|
|
}),
|
|
() => ctrl.abort(),
|
|
)
|
|
}
|
|
}
|