mirror of
https://github.com/Start9Labs/start-os.git
synced 2026-03-26 02:11:53 +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
92 lines
2.2 KiB
TypeScript
92 lines
2.2 KiB
TypeScript
import { AddressInfo } from '../types'
|
|
import { AddressReceipt } from './AddressReceipt'
|
|
import { MultiHost, Scheme } from './Host'
|
|
import { ServiceInterfaceBuilder } from './ServiceInterfaceBuilder'
|
|
|
|
export class Origin {
|
|
constructor(
|
|
readonly host: MultiHost,
|
|
readonly internalPort: number,
|
|
readonly scheme: string | null,
|
|
readonly sslScheme: string | null,
|
|
) {}
|
|
|
|
build({
|
|
username,
|
|
path,
|
|
query: search,
|
|
schemeOverride,
|
|
}: BuildOptions): AddressInfo {
|
|
const qpEntries = Object.entries(search)
|
|
.map(
|
|
([key, val]) => `${encodeURIComponent(key)}=${encodeURIComponent(val)}`,
|
|
)
|
|
.join('&')
|
|
|
|
const qp = qpEntries.length ? `?${qpEntries}` : ''
|
|
|
|
return {
|
|
hostId: this.host.options.id,
|
|
internalPort: this.internalPort,
|
|
scheme: schemeOverride ? schemeOverride.noSsl : this.scheme,
|
|
sslScheme: schemeOverride ? schemeOverride.ssl : this.sslScheme,
|
|
suffix: `${path}${qp}`,
|
|
username,
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @description A function to register a group of origins (<PROTOCOL> :// <HOSTNAME> : <PORT>) with StartOS
|
|
*
|
|
* The returned addressReceipt serves as proof that the addresses were registered
|
|
*
|
|
* @param addressInfo
|
|
* @returns
|
|
*/
|
|
async export(
|
|
serviceInterfaces: ServiceInterfaceBuilder[],
|
|
): Promise<AddressInfo[] & AddressReceipt> {
|
|
const addressesInfo = []
|
|
for (let serviceInterface of serviceInterfaces) {
|
|
const {
|
|
name,
|
|
description,
|
|
id,
|
|
type,
|
|
username,
|
|
path,
|
|
query: search,
|
|
schemeOverride,
|
|
masked,
|
|
} = serviceInterface.options
|
|
|
|
const addressInfo = this.build({
|
|
username,
|
|
path,
|
|
query: search,
|
|
schemeOverride,
|
|
})
|
|
|
|
await serviceInterface.options.effects.exportServiceInterface({
|
|
id,
|
|
name,
|
|
description,
|
|
addressInfo,
|
|
type,
|
|
masked,
|
|
})
|
|
|
|
addressesInfo.push(addressInfo)
|
|
}
|
|
|
|
return addressesInfo as AddressInfo[] & AddressReceipt
|
|
}
|
|
}
|
|
|
|
type BuildOptions = {
|
|
schemeOverride: { ssl: Scheme; noSsl: Scheme } | null
|
|
username: string | null
|
|
path: string
|
|
query: Record<string, string>
|
|
}
|