@undefineds.co/linx 0.2.15 → 0.2.17

package/dist/skills/xpod-componentsjs/SKILL.md

@@ -0,0 +1,284 @@
+---
+name: xpod-componentsjs
+description: Xpod Components.js 变量和组件配置专家，处理 CLI 参数、变量解析、组件配置等问题
+allowed-tools: Read, Write, Edit, Grep, Glob, Bash
+---
+
+# Xpod Components.js 配置专家
+
+你是 Xpod 项目的 Components.js 配置专家。Xpod 基于 Community Solid Server (CSS)，使用 Components.js 进行依赖注入。
+
+## 核心知识
+
+### 变量解析流程
+
+```
+环境变量 (CSS_XXX) 
+    ↓
+YargsCliExtractor (cli.json) - 解析 CLI 参数
+    ↓
+ShorthandResolver (resolver.json) - 将参数映射到 Components.js 变量
+    ↓
+Variable (配置文件中) - 在组件配置中引用变量
+```
+
+### 关键文件
+
+| 文件 | 作用 |
+|------|------|
+| `config/cli.json` | 声明 CLI 参数（YargsParameter） |
+| `config/resolver.json` | 将 CLI 参数映射到 Components.js 变量（KeyExtractor） |
+| `config/*.json` | 使用 `"@type": "Variable"` 引用变量 |
+| `dist/components/context.jsonld` | 自动生成的组件 context，包含参数名映射 |
+
+## 添加新变量的完整步骤
+
+### 步骤 1: cli.json 声明参数
+
+```json
+// config/cli.json
+{
+  "@type": "YargsParameter",
+  "name": "myNewParam",
+  "options": { 
+    "type": "string",
+    "hidden": true
+  }
+}
+```
+
+参数名使用 camelCase，对应环境变量自动转换：`myNewParam` → `CSS_MY_NEW_PARAM`
+
+### 步骤 2: resolver.json 添加 KeyExtractor（最容易遗漏！）
+
+```json
+// config/resolver.json
+{
+  "CombinedShorthandResolver:_resolvers_key": "urn:solid-server:default:variable:myNewParam",
+  "CombinedShorthandResolver:_resolvers_value": {
+    "@type": "KeyExtractor",
+    "key": "myNewParam",
+    "defaultValue": ""
+  }
+}
+```
+
+### 步骤 3: 配置文件中使用变量
+
+```json
+{
+  "myConfig": {
+    "@id": "urn:solid-server:default:variable:myNewParam",
+    "@type": "Variable"
+  }
+}
+```
+
+## 抽象类和接口的处理
+
+### 关键规则：Generator 只处理导出的类
+
+Components.js Generator (`componentsjs-generator`) 只会为 **从 `src/index.ts` 导出的类** 生成 `.jsonld` 文件。
+
+### 问题场景
+
+当一个类继承抽象基类或实现接口时：
+
+```typescript
+// 子类生成的 jsonld 会包含 extends 引用
+"extends": ["undefineds:dist/path/to/BaseClass.jsonld#BaseClass"]
+```
+
+如果 `BaseClass` 没有被导出，Generator 不会为它生成 jsonld，启动时会报错：
+
+```
+Error: Resource .../BaseClass.jsonld#BaseClass is not a valid component
+```
+
+### 解决方案
+
+**1. 确保抽象类/基类从 index.ts 导出**
+
+```typescript
+// src/index.ts
+import { MyBaseClass } from './path/to/MyBaseClass';
+import { MyImplClass } from './path/to/MyImplClass';
+
+export default {
+  MyBaseClass,      // ← 必须导出基类！
+  MyImplClass,
+};
+```
+
+**2. 使用 abstract class 而不是 interface**
+
+Generator **不会为 TypeScript interface 生成 jsonld**。如果有类 `implements` 一个 interface，必须将 interface 改为 abstract class：
+
+```typescript
+// ❌ 错误 - interface 不会生成 jsonld
+export interface QuintStore {
+  get(pattern: QuintPattern): Promise<Quint[]>;
+  put(quint: Quint): Promise<void>;
+}
+
+export class MyStore implements QuintStore { ... }
+```
+
+```typescript
+// ✅ 正确 - abstract class 会生成 jsonld
+export abstract class QuintStore {
+  abstract get(pattern: QuintPattern): Promise<Quint[]>;
+  abstract put(quint: Quint): Promise<void>;
+}
+
+export class MyStore extends QuintStore { ... }
+```
+
+**3. 子类继承时添加 super() 和 override**
+
+```typescript
+export class MyStore extends QuintStore {
+  constructor(options: Options) {
+    super();  // ← 必须调用 super()
+    this.options = options;
+  }
+  
+  override async get(pattern: QuintPattern): Promise<Quint[]> {
+    // 如果基类有可选方法的实现，需要 override 修饰符
+  }
+}
+```
+
+### 检查清单
+
+添加新的抽象类/基类时：
+
+- [ ] 使用 `abstract class` 而不是 `interface`
+- [ ] 在 `src/index.ts` 中导出该类
+- [ ] 子类使用 `extends` 而不是 `implements`
+- [ ] 子类构造函数调用 `super()`
+- [ ] 覆盖父类方法时添加 `override` 修饰符
+- [ ] 运行 `yarn build` 验证 jsonld 生成
+
+## 常见错误诊断
+
+### 错误: Resource is not a valid component
+
+```
+Error: Resource .../types.jsonld#QuintStore is not a valid component, 
+either it is not defined, has no type, or is incorrectly referenced
+```
+
+**原因**: 
+1. 使用了 TypeScript interface（Generator 不处理 interface）
+2. 抽象类/基类没有从 index.ts 导出
+
+**解决**: 
+1. 将 interface 改为 abstract class
+2. 在 index.ts 中导出该类
+3. 运行 `yarn build`
+
+### 错误: Could not find (valid) component types
+
+```
+ErrorResourcesContext: Could not find (valid) component types for config "urn:xxx:MyComponent" among its types, or a requireName
+```
+
+**原因**: 新增或重命名了 TypeScript 类，但没有重新生成 Components.js 的 `.jsonld` 组件定义文件
+**解决**: 运行完整编译 `npm run build`（不是 `npm run build:ts`），让 `componentsjs-generator` 生成新的 `.jsonld` 文件
+
+```bash
+# 错误 - 只编译 TypeScript，不会生成 .jsonld
+npm run build:ts
+
+# 正确 - 完整编译，包括 componentsjs-generator
+npm run build
+```
+
+### 错误: Undefined variable
+
+```
+Error: Undefined variable: urn:solid-server:default:variable:xxx
+```
+
+**原因**: resolver.json 中缺少对应的 KeyExtractor
+**解决**: 在 resolver.json 中添加变量映射
+
+### 错误: Multiple values for parameter
+
+```
+ErrorResourcesContext: Detected multiple values for parameter ... YargsCliExtractor_options
+```
+
+**原因**: xpod 的 cli.json 和 CSS 的 cli.json 都定义了 `options` 块
+**解决**: xpod 的 cli.json 不要添加 `options` 块，CSS 已经配置了 `envVarPrefix` 和 `loadFromEnv`
+
+### 错误: xxx.map is not a function
+
+```
+TypeError: options.routes.map is not a function
+```
+
+**原因**: 组件参数名格式不正确
+**解决**: 查看 `dist/components/context.jsonld` 中的正确参数名，使用简写形式
+
+```json
+// 正确
+{ "@type": "MyComponent", "routes": [...], "fallback": {...} }
+
+// 错误
+{ "@type": "MyComponent", "MyComponent:_options_routes": [...] }
+```
+
+## 配置文件 @context 规范
+
+### 正确写法
+
+```json
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ]
+}
+```
+
+### 禁止自定义覆盖
+
+不要在 @context 中添加与 dist/components/context.jsonld 冲突的自定义映射。
+
+## 调试命令
+
+```bash
+# 验证环境变量加载
+node_modules/.bin/dotenv -e .env.cluster -- node -e "console.log(process.env.CSS_MY_PARAM)"
+
+# 直接传递 CLI 参数测试
+community-solid-server -c config/xxx.json -m . --myNewParam test-value
+
+# 查看组件参数名
+grep -A 10 '"MyComponent"' dist/components/context.jsonld
+
+# 检查某个类的 jsonld 是否生成
+ls dist/path/to/MyClass.jsonld
+
+# 检查 components.jsonld 是否包含某个类的 import
+grep "MyClass" dist/components/components.jsonld
+```
+
+## 检查清单
+
+添加新变量时必须完成：
+
+- [ ] `config/cli.json` - 添加 YargsParameter
+- [ ] `config/resolver.json` - 添加 KeyExtractor
+- [ ] `.env.xxx` - 添加环境变量（如需要）
+- [ ] 组件配置文件 - 使用 `"@type": "Variable"` 引用
+- [ ] 运行 `yarn build` 重新生成 components
+
+添加新的抽象类/基类时：
+
+- [ ] 使用 `abstract class` 而不是 `interface`
+- [ ] 在 `src/index.ts` 中导出该类
+- [ ] 子类使用 `extends` 而不是 `implements`
+- [ ] 运行 `yarn build` 验证 jsonld 生成

package/dist/watch-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch-cli.js","sourceRoot":"","sources":["../src/watch-cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"watch-cli.js","sourceRoot":"","sources":["../../../../src/watch-cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/linx",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "private": false,
   "type": "module",
   "bin": {
@@ -12,10 +12,11 @@
     "test": "yarn build && node --test test/**/*.test.mjs"
   },
   "dependencies": {
-    "@undefineds.co/models": "0.2.15",
     "@inrupt/solid-client-authn-node": "^3.1.1",
+    "@inrupt/vocab-common-rdf": "^1.0.5",
     "@mariozechner/pi-coding-agent": "^0.67.6",
-    "n3": "^1.26.0",
+    "@undefineds.co/drizzle-solid": "^0.3.5",
+    "@undefineds.co/models": "0.2.16",
     "yargs": "^17.7.2",
     "@zed-industries/codex-acp": "^0.9.5"
   },
@@ -25,9 +26,15 @@
   },
   "files": [
     "dist",
+    "vendor",
     "README.md",
     "package.json"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/undefinedsco/LinX.git",
+    "directory": "apps/cli"
+  },
   "publishConfig": {
     "access": "public"
   }

package/vendor/client/dist/client/index.d.ts

@@ -0,0 +1,118 @@
+export type LinxAuthType = 'client_credentials' | 'oidc_oauth';
+export interface LinxClientConfig {
+    url: string;
+    webId: string;
+    authType: LinxAuthType;
+}
+export interface LinxClientCredentialsSecrets {
+    clientId: string;
+    clientSecret: string;
+}
+export interface LinxOidcOAuthSecrets {
+    oidcRefreshToken: string;
+    oidcAccessToken: string;
+    oidcExpiresAt: string;
+}
+export type LinxClientSecrets = LinxClientCredentialsSecrets | LinxOidcOAuthSecrets;
+export interface AccountSession {
+    url: string;
+    email: string;
+    token: string;
+    webId?: string;
+    podUrl?: string;
+    createdAt: string;
+}
+export interface LinxAccountControls {
+    pod?: string;
+    clientCredentials?: string;
+}
+export interface LinxAccountData {
+    controls: LinxAccountControls;
+    pods: Record<string, string>;
+    webIds: Record<string, string>;
+    clientCredentials: Record<string, string>;
+}
+export interface LinxClientCredential {
+    id: string;
+    secret?: string;
+    label?: string;
+    webId?: string;
+}
+export interface LinxStoredCredentials {
+    url: string;
+    webId: string;
+    authType: LinxAuthType;
+    secrets: LinxClientSecrets;
+}
+export type LinxCredentialBootstrapStatus = 'reused' | 'created' | 'recreated';
+export interface LinxWhoAmIField {
+    key: 'email' | 'server' | 'webId' | 'pod' | 'session-created-at';
+    value: string;
+}
+export interface PerformLinxPasswordLoginInput {
+    baseUrl?: string | null;
+    fallbackBaseUrl?: string;
+    email: string;
+    password: string;
+    requestedWebId?: string | null;
+    credentialName?: string | null;
+    existingCredentials?: LinxStoredCredentials | null;
+    now?: Date;
+}
+export interface PerformLinxPasswordLoginResult {
+    baseUrl: string;
+    webId: string;
+    account: LinxAccountData;
+    session: AccountSession;
+    credentialStatus: LinxCredentialBootstrapStatus;
+    credentialsToSave?: {
+        url: string;
+        webId: string;
+        authType: 'client_credentials';
+        secrets: LinxClientCredentialsSecrets;
+    };
+}
+export interface PerformLinxPasswordLoginDependencies {
+    checkServer(baseUrl: string): Promise<boolean>;
+    login(email: string, password: string, baseUrl: string): Promise<string | null>;
+    getAccountData(token: string, baseUrl: string): Promise<LinxAccountData | null>;
+    validateClientCredentials?(credentials: LinxStoredCredentials): Promise<boolean>;
+    createClientCredentials(token: string, credentialsUrl: string, webId: string, name?: string): Promise<LinxClientCredential | null>;
+}
+export declare const LINX_HOME_DIRNAME = ".linx";
+export declare const LINX_CONFIG_FILE_NAME = "config.json";
+export declare const LINX_SECRETS_FILE_NAME = "secrets.json";
+export declare const LINX_ACCOUNT_SESSION_FILE_NAME = "account.json";
+export declare const LINX_CLOUD_IDENTITY_ORIGIN = "https://id.undefineds.co";
+export declare const LINX_CLOUD_API_ORIGIN = "https://api.undefineds.co";
+export declare const LINX_CLOUD_ACCOUNT_API_BASE_URL = "https://id.undefineds.co/";
+export declare const LINX_CLOUD_RUNTIME_API_BASE_URL = "https://api.undefineds.co/v1";
+export declare const LINX_CLOUD_API_BASE_URL = "https://id.undefineds.co/";
+export declare const LINX_CLOUD_IDENTITY_HOSTS: readonly ["id.undefineds.co"];
+export declare function resolveLinxBaseUrl(url?: string | null, fallbackBaseUrl?: string): string;
+export declare function resolveLinxRuntimeApiBaseUrl(url?: string | null, fallbackBaseUrl?: string): string;
+export declare function resolveLinxCloudAccountBaseUrl(url?: string | null): string;
+export declare function resolveLinxCloudRuntimeApiBaseUrl(url?: string | null): string;
+export declare function resolveLinxCloudApiBaseUrl(url?: string | null): string;
+export declare function isLinxCloudIdentityBaseUrl(url?: string | null): boolean;
+export declare function resolveLinxRuntimeOriginForIssuerUrl(url?: string | null): string;
+export declare function resolveLinxRuntimeApiBaseUrlForIssuerUrl(url?: string | null): string;
+export declare function resolveLinxPodUrl(webId: string): string;
+export declare function resolveLinxPodBaseUrl(webId: string): string;
+export declare function parseLinxClientConfig(raw: unknown): LinxClientConfig | null;
+export declare function isLinxClientCredentialsSecrets(secrets: LinxClientSecrets): secrets is LinxClientCredentialsSecrets;
+export declare function isLinxOidcOAuthSecrets(secrets: LinxClientSecrets): secrets is LinxOidcOAuthSecrets;
+export declare function parseLinxClientSecrets(raw: unknown): LinxClientSecrets | null;
+export declare function parseLinxAccountData(raw: unknown): LinxAccountData | null;
+export declare function parseLinxClientCredential(raw: unknown): LinxClientCredential | null;
+export declare function parseAccountSession(raw: unknown): AccountSession | null;
+export declare function selectLinxAccountWebId(account: LinxAccountData | null, preferredWebId?: string | null): string | null;
+export declare function hasMatchingLinxStoredCredentials(credentials: Pick<LinxStoredCredentials, 'url' | 'webId'> | null | undefined, baseUrl: string, webId: string): boolean;
+export declare function resolveLinxCredentialBootstrapStatus(input: {
+    reusedExistingCredentials: boolean;
+    hadMatchingStoredCredentials: boolean;
+}): LinxCredentialBootstrapStatus;
+export declare function listLinxWhoAmIFields(session: AccountSession, options?: {
+    verbose?: boolean;
+}): LinxWhoAmIField[];
+export declare function performLinxPasswordLogin(input: PerformLinxPasswordLoginInput, deps: PerformLinxPasswordLoginDependencies): Promise<PerformLinxPasswordLoginResult>;