菜单
How to use @owlmeans/config — typed configuration object construction, service() registration, AppType enum, security helpers (makeSecurityHelper). Auto-invoked when importing from this package or building a config.ts for a new app.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | config |
| description | How to use @owlmeans/config — typed configuration object construction, service() registration, AppType enum, security helpers (makeSecurityHelper). Auto-invoked when importing from this package or building a config.ts for a new app. |
| user-invocable | false |
Layer: Core
Install: "@owlmeans/config": "^0.1.11" in dependencies
| Export | Description |
|---|---|
config(options) | Build a typed config object |
service(options, cfg?) | Register a client-callable service in the config |
AppType | Enum of application types (Backend, Web, Native, etc.) |
makeSecurityHelper(context) | Build URLs, resolve secrets, sign payloads |
Config types | Base config interface — extend in your app |
| Plugins | Pluggable config sources |
| Security types | Trusted entities, secrets, certificate types |
./utils — config helper utilitiesBuild the base config in config.ts, then add services and storage:
import { AppType, config, service } from '@owlmeans/config'
import { sservice } from '@owlmeans/server-app'
import { AGENT, MANAGER_API } from 'my-common'
const cfg = config({ service: MANAGER_API, type: AppType.Backend, port: 8080 }) as AppConfig
cfg.trusted = []
sservice({ service: AGENT, internalHost: 'kluster:service:agent', internalPort: 8081 }, cfg)
service({ service: MANAGER_API, host: 'manager.example.com' }, cfg)
export default cfg
Use makeSecurityHelper inside handlers to construct URLs that point at trusted services:
import { makeSecurityHelper } from '@owlmeans/config'
const helper = makeSecurityHelper<Config, Context>(ctx)
const url = helper.makeUrl(VIB_ALIAS, '/checkout/success')
On the client side, prefer context.entrypoint<ClientEntrypoint<string>>(alias).call({ full: true }) which delegates to makeSecurityHelper internally — see @owlmeans/client-entrypoint.
@owlmeans/auth — trusted entity / signing primitives@owlmeans/context — for the security helper to resolve servicesPK-based supervisor authentication — a development-only login where a holder of one of the project's trusted private keys mints a token for any user id/email (registering them on first use), bypassing external IdPs. Primary use is end-to-end tests. Covers appendSupervisorAuth (server + web), the supervisor plugin, and the @owlmeans/test-ui helpers. Use when wiring or testing supervisor auth.
How to use @owlmeans/web-auth — web client auth plugins that register into @owlmeans/client-auth/manager. Currently ships the development-only PK-based supervisor login form (appendSupervisorAuth). Auto-invoked when importing @owlmeans/web-auth.
Discovery-first, reuse-first workflow for OwlMeans projects. Use BEFORE planning or building any feature, before proposing a third-party library or a custom solution, and after writing code. Find an existing @owlmeans/* package or existing code first; extend before writing new; simplify what you write.
How to scaffold a new OwlMeans Common project — the @owlmeans/create-app CLI (npm/bun/yarn create), its flags, what it generates, and the manual alternative. Use when asked to create/bootstrap/start a new OwlMeans app or set up a fresh project.
Discovery-first, reuse-first workflow for OwlMeans projects. Use BEFORE planning or building any feature, before proposing a third-party library or a custom solution, and after writing code. Find an existing @owlmeans/* package or existing code first; extend before writing new; simplify what you write.
How to scaffold a new OwlMeans Common project — the @owlmeans/create-app CLI (npm/bun/yarn create), its flags, what it generates, and the manual alternative. Use when asked to create/bootstrap/start a new OwlMeans app or set up a fresh project.