openxiangda-devkit-core 2.0.0-alpha.12 → 2.0.0-alpha.121

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (188) hide show
  1. package/README.md +3 -8
  2. package/dist/app-spec.d.ts +228 -0
  3. package/dist/app-spec.d.ts.map +1 -0
  4. package/dist/app-spec.js +1443 -0
  5. package/dist/app-spec.js.map +1 -0
  6. package/dist/application-services.d.ts +996 -49
  7. package/dist/application-services.d.ts.map +1 -1
  8. package/dist/application-services.js +1348 -197
  9. package/dist/application-services.js.map +1 -1
  10. package/dist/application-ui-contract.d.ts +5 -0
  11. package/dist/application-ui-contract.d.ts.map +1 -0
  12. package/dist/application-ui-contract.js +149 -0
  13. package/dist/application-ui-contract.js.map +1 -0
  14. package/dist/backend-image-build.d.ts +23 -0
  15. package/dist/backend-image-build.d.ts.map +1 -0
  16. package/dist/backend-image-build.js +204 -0
  17. package/dist/backend-image-build.js.map +1 -0
  18. package/dist/command-process.d.ts +14 -0
  19. package/dist/command-process.d.ts.map +1 -0
  20. package/dist/command-process.js +51 -0
  21. package/dist/command-process.js.map +1 -0
  22. package/dist/command-registry.d.ts +123 -366
  23. package/dist/command-registry.d.ts.map +1 -1
  24. package/dist/command-registry.js +26 -266
  25. package/dist/command-registry.js.map +1 -1
  26. package/dist/compiler/ai-catalog.d.ts +4 -0
  27. package/dist/compiler/ai-catalog.d.ts.map +1 -0
  28. package/dist/compiler/ai-catalog.js +354 -0
  29. package/dist/compiler/ai-catalog.js.map +1 -0
  30. package/dist/compiler/application-model.d.ts +60 -0
  31. package/dist/compiler/application-model.d.ts.map +1 -0
  32. package/dist/compiler/application-model.js +141 -0
  33. package/dist/compiler/application-model.js.map +1 -0
  34. package/dist/compiler/authorization-transition.d.ts +7 -0
  35. package/dist/compiler/authorization-transition.d.ts.map +1 -0
  36. package/dist/compiler/authorization-transition.js +27 -0
  37. package/dist/compiler/authorization-transition.js.map +1 -0
  38. package/dist/compiler/bundle.d.ts +34 -0
  39. package/dist/compiler/bundle.d.ts.map +1 -0
  40. package/dist/compiler/bundle.js +1910 -0
  41. package/dist/compiler/bundle.js.map +1 -0
  42. package/dist/compiler/config.d.ts +882 -0
  43. package/dist/compiler/config.d.ts.map +1 -0
  44. package/dist/compiler/config.js +4118 -0
  45. package/dist/compiler/config.js.map +1 -0
  46. package/dist/compiler/data-policy-expression.d.ts +12 -0
  47. package/dist/compiler/data-policy-expression.d.ts.map +1 -0
  48. package/dist/compiler/data-policy-expression.js +43 -0
  49. package/dist/compiler/data-policy-expression.js.map +1 -0
  50. package/dist/compiler/field-codec.d.ts +14 -0
  51. package/dist/compiler/field-codec.d.ts.map +1 -0
  52. package/dist/compiler/field-codec.js +131 -0
  53. package/dist/compiler/field-codec.js.map +1 -0
  54. package/dist/compiler/field-physical-plan.d.ts +10 -0
  55. package/dist/compiler/field-physical-plan.d.ts.map +1 -0
  56. package/dist/compiler/field-physical-plan.js +66 -0
  57. package/dist/compiler/field-physical-plan.js.map +1 -0
  58. package/dist/compiler/field-policy-path.d.ts +10 -0
  59. package/dist/compiler/field-policy-path.d.ts.map +1 -0
  60. package/dist/compiler/field-policy-path.js +283 -0
  61. package/dist/compiler/field-policy-path.js.map +1 -0
  62. package/dist/compiler/field-query-plan.d.ts +13 -0
  63. package/dist/compiler/field-query-plan.d.ts.map +1 -0
  64. package/dist/compiler/field-query-plan.js +122 -0
  65. package/dist/compiler/field-query-plan.js.map +1 -0
  66. package/dist/compiler/field-surface.d.ts +15 -0
  67. package/dist/compiler/field-surface.d.ts.map +1 -0
  68. package/dist/compiler/field-surface.js +51 -0
  69. package/dist/compiler/field-surface.js.map +1 -0
  70. package/dist/compiler/index.d.ts +6 -0
  71. package/dist/compiler/index.d.ts.map +1 -0
  72. package/dist/compiler/index.js +6 -0
  73. package/dist/compiler/index.js.map +1 -0
  74. package/dist/compiler/package-compiler.d.ts +22 -0
  75. package/dist/compiler/package-compiler.d.ts.map +1 -0
  76. package/dist/compiler/package-compiler.js +257 -0
  77. package/dist/compiler/package-compiler.js.map +1 -0
  78. package/dist/compiler/permission-review.d.ts +139 -0
  79. package/dist/compiler/permission-review.d.ts.map +1 -0
  80. package/dist/compiler/permission-review.js +131 -0
  81. package/dist/compiler/permission-review.js.map +1 -0
  82. package/dist/compiler/schema-composition.d.ts +21 -0
  83. package/dist/compiler/schema-composition.d.ts.map +1 -0
  84. package/dist/compiler/schema-composition.js +193 -0
  85. package/dist/compiler/schema-composition.js.map +1 -0
  86. package/dist/config.d.ts +1 -1
  87. package/dist/config.js +1 -1
  88. package/dist/configuration-preflight.d.ts +7 -0
  89. package/dist/configuration-preflight.d.ts.map +1 -0
  90. package/dist/configuration-preflight.js +13 -0
  91. package/dist/configuration-preflight.js.map +1 -0
  92. package/dist/connected-development.d.ts +62 -0
  93. package/dist/connected-development.d.ts.map +1 -0
  94. package/dist/connected-development.js +393 -0
  95. package/dist/connected-development.js.map +1 -0
  96. package/dist/control-plane-client.d.ts +353 -123
  97. package/dist/control-plane-client.d.ts.map +1 -1
  98. package/dist/control-plane-client.js +420 -141
  99. package/dist/control-plane-client.js.map +1 -1
  100. package/dist/delivery-cache.d.ts +34 -0
  101. package/dist/delivery-cache.d.ts.map +1 -0
  102. package/dist/delivery-cache.js +186 -0
  103. package/dist/delivery-cache.js.map +1 -0
  104. package/dist/delivery-source.d.ts +17 -0
  105. package/dist/delivery-source.d.ts.map +1 -0
  106. package/dist/delivery-source.js +85 -0
  107. package/dist/delivery-source.js.map +1 -0
  108. package/dist/deployment-observer.d.ts +14 -0
  109. package/dist/deployment-observer.d.ts.map +1 -0
  110. package/dist/deployment-observer.js +68 -0
  111. package/dist/deployment-observer.js.map +1 -0
  112. package/dist/deployment.d.ts +55 -3
  113. package/dist/deployment.d.ts.map +1 -1
  114. package/dist/deployment.js +182 -21
  115. package/dist/deployment.js.map +1 -1
  116. package/dist/design-readiness.d.ts +24 -0
  117. package/dist/design-readiness.d.ts.map +1 -0
  118. package/dist/design-readiness.js +102 -0
  119. package/dist/design-readiness.js.map +1 -0
  120. package/dist/developer-errors.d.ts +11 -0
  121. package/dist/developer-errors.d.ts.map +1 -0
  122. package/dist/developer-errors.js +16 -0
  123. package/dist/developer-errors.js.map +1 -0
  124. package/dist/developer-operations.d.ts +188 -0
  125. package/dist/developer-operations.d.ts.map +1 -0
  126. package/dist/developer-operations.js +58 -0
  127. package/dist/developer-operations.js.map +1 -0
  128. package/dist/development-lifecycle.d.ts +75 -0
  129. package/dist/development-lifecycle.d.ts.map +1 -0
  130. package/dist/development-lifecycle.js +189 -0
  131. package/dist/development-lifecycle.js.map +1 -0
  132. package/dist/documentation.d.ts +111 -0
  133. package/dist/documentation.d.ts.map +1 -0
  134. package/dist/documentation.js +112 -0
  135. package/dist/documentation.js.map +1 -0
  136. package/dist/index.d.ts +16 -0
  137. package/dist/index.d.ts.map +1 -1
  138. package/dist/index.js +16 -0
  139. package/dist/index.js.map +1 -1
  140. package/dist/internal/workflow.d.ts +83 -0
  141. package/dist/internal/workflow.d.ts.map +1 -0
  142. package/dist/internal/workflow.js +419 -0
  143. package/dist/internal/workflow.js.map +1 -0
  144. package/dist/nest-injection-contract.d.ts +4 -0
  145. package/dist/nest-injection-contract.d.ts.map +1 -0
  146. package/dist/nest-injection-contract.js +116 -0
  147. package/dist/nest-injection-contract.js.map +1 -0
  148. package/dist/operation-progress.d.ts +26 -0
  149. package/dist/operation-progress.d.ts.map +1 -0
  150. package/dist/operation-progress.js +92 -0
  151. package/dist/operation-progress.js.map +1 -0
  152. package/dist/optional-backend.d.ts +14 -0
  153. package/dist/optional-backend.d.ts.map +1 -0
  154. package/dist/optional-backend.js +145 -0
  155. package/dist/optional-backend.js.map +1 -0
  156. package/dist/package-compiler.d.ts +1 -1
  157. package/dist/package-compiler.d.ts.map +1 -1
  158. package/dist/package-compiler.js +1 -1
  159. package/dist/package-compiler.js.map +1 -1
  160. package/dist/session.d.ts +149 -4
  161. package/dist/session.d.ts.map +1 -1
  162. package/dist/session.js +362 -23
  163. package/dist/session.js.map +1 -1
  164. package/dist/testing.d.ts +77 -0
  165. package/dist/testing.d.ts.map +1 -0
  166. package/dist/testing.js +213 -0
  167. package/dist/testing.js.map +1 -0
  168. package/dist/toolchain-capsule.d.ts +45 -0
  169. package/dist/toolchain-capsule.d.ts.map +1 -0
  170. package/dist/toolchain-capsule.js +165 -0
  171. package/dist/toolchain-capsule.js.map +1 -0
  172. package/dist/workspace-loader.d.ts +1 -1
  173. package/dist/workspace-loader.d.ts.map +1 -1
  174. package/dist/workspace-loader.js +35 -3
  175. package/dist/workspace-loader.js.map +1 -1
  176. package/dist/workspace-operation.d.ts +3 -0
  177. package/dist/workspace-operation.d.ts.map +1 -0
  178. package/dist/workspace-operation.js +45 -0
  179. package/dist/workspace-operation.js.map +1 -0
  180. package/dist/workspace.d.ts.map +1 -1
  181. package/dist/workspace.js +37 -1
  182. package/dist/workspace.js.map +1 -1
  183. package/package.json +16 -4
  184. package/templates/backend/Dockerfile +20 -0
  185. package/templates/backend/package.json +27 -0
  186. package/templates/backend/src/app.module.ts +23 -0
  187. package/templates/backend/src/main.ts +5 -0
  188. package/templates/backend/tsconfig.json +9 -0
@@ -0,0 +1,92 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+ import { randomUUID } from 'node:crypto';
3
+ const storage = new AsyncLocalStorage();
4
+ /** 每次调用独立;并发 MCP 请求不会共享当前阶段或监听器。 */
5
+ export async function withOperationProgress(operation, listener, execute, heartbeatMs = 10_000) {
6
+ const context = {
7
+ operationId: randomUUID(), operation, started: Date.now(), sequence: 0,
8
+ stages: [], heartbeatMs, ...(listener ? { listener } : {}),
9
+ };
10
+ return storage.run(context, async () => {
11
+ const execution = () => ({
12
+ operationId: context.operationId,
13
+ elapsedMs: Date.now() - context.started,
14
+ stages: context.stages.map(stage => ({ ...stage })),
15
+ });
16
+ try {
17
+ const result = await execute();
18
+ const data = result.data && typeof result.data === 'object' ? result.data : {};
19
+ return { ...result, data: { ...data, execution: execution() } };
20
+ }
21
+ catch (error) {
22
+ if (error && typeof error === 'object') {
23
+ const value = error;
24
+ try {
25
+ value.data = { ...value.data, execution: execution() };
26
+ }
27
+ catch { /* 保留不可扩展的原始异常。 */ }
28
+ }
29
+ throw error;
30
+ }
31
+ });
32
+ }
33
+ function emit(context, stage, heartbeat = false) {
34
+ const event = {
35
+ ...stage, schemaVersion: 'openxiangda.operation-progress/v1',
36
+ operationId: context.operationId, operation: context.operation,
37
+ sequence: ++context.sequence, elapsedMs: Date.now() - context.started, heartbeat,
38
+ };
39
+ // 可观测性传输失败不能改变已提交操作的结果;最终结果仍带阶段摘要。
40
+ try {
41
+ void Promise.resolve(context.listener?.(event)).catch(() => undefined);
42
+ }
43
+ catch { /* 观察者不能改变执行。 */ }
44
+ }
45
+ export async function operationStage(stage, label, execute) {
46
+ const context = storage.getStore();
47
+ if (!context)
48
+ return execute();
49
+ const started = Date.now();
50
+ const record = { stage, label, state: 'running', startedAt: new Date(started).toISOString(), durationMs: 0 };
51
+ context.stages.push(record);
52
+ emit(context, record);
53
+ const heartbeat = setInterval(() => {
54
+ record.durationMs = Date.now() - started;
55
+ emit(context, record, true);
56
+ }, context.heartbeatMs);
57
+ heartbeat.unref();
58
+ try {
59
+ const result = await execute();
60
+ record.state = result && typeof result === 'object' && 'ok' in result && result.ok === false ? 'failed' : 'passed';
61
+ return result;
62
+ }
63
+ catch (error) {
64
+ record.state = 'failed';
65
+ throw error;
66
+ }
67
+ finally {
68
+ clearInterval(heartbeat);
69
+ record.durationMs = Date.now() - started;
70
+ emit(context, record);
71
+ }
72
+ }
73
+ export function skippedOperationStage(stage, label) {
74
+ const context = storage.getStore();
75
+ if (!context)
76
+ return;
77
+ const record = { stage, label, state: 'skipped', startedAt: new Date().toISOString(), durationMs: 0 };
78
+ context.stages.push(record);
79
+ emit(context, record);
80
+ }
81
+ /** 平台仍是运行状态权威;此处只刷新本次观察的标题和运行指针。 */
82
+ export function updateOperationStage(stage, label, details) {
83
+ const context = storage.getStore();
84
+ const record = context?.stages.slice().reverse().find(item => item.stage === stage && item.state === 'running');
85
+ if (!context || !record)
86
+ return;
87
+ record.label = label;
88
+ record.details = details;
89
+ record.durationMs = Date.now() - Date.parse(record.startedAt);
90
+ emit(context, record);
91
+ }
92
+ //# sourceMappingURL=operation-progress.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-progress.js","sourceRoot":"","sources":["../src/operation-progress.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { type OpenXiangdaAppConfig } from './compiler/config.js';
2
+ export interface OptionalBackendInitialization {
3
+ required: boolean;
4
+ created: boolean;
5
+ installed: boolean;
6
+ root: string;
7
+ }
8
+ /** Initialize user-owned source only when the application declares server execution. */
9
+ export declare function initializeOptionalBackend(workspaceRoot: string, config: OpenXiangdaAppConfig, options?: {
10
+ sdkVersion?: string;
11
+ /** Package manager boundary, injectable by deterministic toolchain tests. */
12
+ install?: (root: string) => void;
13
+ }): OptionalBackendInitialization;
14
+ //# sourceMappingURL=optional-backend.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"optional-backend.d.ts","sourceRoot":"","sources":["../src/optional-backend.ts"],"names":[],"mappings":"AAOA,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,GACL,6BAA6B,CAwE/B"}
@@ -0,0 +1,145 @@
1
+ import { spawnSync } from 'node:child_process';
2
+ import { closeSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
3
+ import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { backendRuntimeRequired } from './compiler/config.js';
6
+ /** Initialize user-owned source only when the application declares server execution. */
7
+ export function initializeOptionalBackend(workspaceRoot, config, options = {}) {
8
+ const root = resolve(workspaceRoot);
9
+ const required = backendRuntimeRequired(config);
10
+ const result = { required, created: false, installed: false, root: config.backend.root };
11
+ if (!required)
12
+ return result;
13
+ const target = resolve(root, config.backend.root);
14
+ assertContainedPath(root, target);
15
+ const receiptRoot = join(root, '.openxiangda');
16
+ assertContainedPath(root, receiptRoot);
17
+ const receipt = join(receiptRoot, 'backend-install-pending.json');
18
+ assertContainedPath(root, receipt);
19
+ // Existing authored backends belong to the app; no regeneration or reinstall.
20
+ if (existsSync(target) && !existsSync(receipt))
21
+ return result;
22
+ mkdirSync(receiptRoot, { recursive: true });
23
+ const lock = join(receiptRoot, 'backend-initialization.lock');
24
+ assertContainedPath(root, lock);
25
+ const lockFd = acquireInitializationLock(lock);
26
+ let staging;
27
+ try {
28
+ assertContainedPath(root, target);
29
+ if (!existsSync(target)) {
30
+ const sdkVersion = options.sdkVersion || workspaceSdkVersion(root);
31
+ if (!sdkVersion || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(sdkVersion)) {
32
+ throw initializationError('OPENXIANGDA_BACKEND_SDK_VERSION_REQUIRED', '按需后端需要工作区精确版本的 openxiangda 依赖');
33
+ }
34
+ const source = fileURLToPath(new URL('../templates/backend/', import.meta.url));
35
+ mkdirSync(dirname(target), { recursive: true });
36
+ staging = mkdtempSync(join(dirname(target), '.openxiangda-backend-'));
37
+ cpSync(source, staging, {
38
+ recursive: true,
39
+ filter: path => !/(?:^|\/)(?:node_modules|dist)(?:\/|$)/.test(relative(source, path)),
40
+ });
41
+ const manifestPath = join(staging, 'package.json');
42
+ const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
43
+ manifest.dependencies.openxiangda = sdkVersion;
44
+ writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
45
+ const tsconfigPath = join(staging, 'tsconfig.json');
46
+ const tsconfig = JSON.parse(readFileSync(tsconfigPath, 'utf8'));
47
+ tsconfig.extends = relative(target, join(root, 'tsconfig.base.json')).split(sep).join('/');
48
+ writeFileSync(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
49
+ const dockerfilePath = join(staging, 'Dockerfile');
50
+ writeFileSync(dockerfilePath, readFileSync(dockerfilePath, 'utf8')
51
+ .replaceAll('apps/server', relative(root, target).split(sep).join('/')));
52
+ // Write the retry receipt before committing source so interrupted setup is resumable.
53
+ if (!existsSync(receipt)) {
54
+ writeFileSync(receipt, `${JSON.stringify({ root: config.backend.root })}\n`, { flag: 'wx' });
55
+ }
56
+ else if (JSON.parse(readFileSync(receipt, 'utf8')).root !== config.backend.root) {
57
+ throw initializationError('OPENXIANGDA_BACKEND_INITIALIZATION_CONFLICT', '未完成的后端初始化与当前声明不一致');
58
+ }
59
+ if (existsSync(target))
60
+ throw initializationError('OPENXIANGDA_BACKEND_SOURCE_CONFLICT', '后端目录已由另一操作创建,未覆盖其内容');
61
+ renameSync(staging, target);
62
+ staging = undefined;
63
+ result.created = true;
64
+ }
65
+ if (existsSync(receipt)) {
66
+ const pending = JSON.parse(readFileSync(receipt, 'utf8'));
67
+ if (pending.root !== config.backend.root || !existsSync(join(target, 'package.json'))) {
68
+ throw initializationError('OPENXIANGDA_BACKEND_INITIALIZATION_CONFLICT', '未完成的后端初始化与当前声明不一致;请检查 .openxiangda/backend-install-pending.json');
69
+ }
70
+ (options.install || installBackendDependencies)(root);
71
+ rmSync(receipt);
72
+ result.installed = true;
73
+ }
74
+ return result;
75
+ }
76
+ finally {
77
+ if (staging)
78
+ rmSync(staging, { recursive: true, force: true });
79
+ closeSync(lockFd);
80
+ rmSync(lock, { force: true });
81
+ }
82
+ }
83
+ function acquireInitializationLock(path) {
84
+ for (let attempt = 0; attempt < 2; attempt += 1) {
85
+ try {
86
+ const fd = openSync(path, 'wx');
87
+ writeFileSync(fd, String(process.pid));
88
+ return fd;
89
+ }
90
+ catch (error) {
91
+ if (error.code !== 'EEXIST')
92
+ throw error;
93
+ const owner = readFileSync(path, 'utf8');
94
+ const pid = Number(owner);
95
+ if (Number.isSafeInteger(pid) && pid > 0 && pid <= 2147483647) {
96
+ try {
97
+ process.kill(pid, 0);
98
+ }
99
+ catch (probe) {
100
+ if (probe.code === 'ESRCH' && readFileSync(path, 'utf8') === owner) {
101
+ rmSync(path);
102
+ continue;
103
+ }
104
+ }
105
+ }
106
+ break;
107
+ }
108
+ }
109
+ throw initializationError('OPENXIANGDA_BACKEND_INITIALIZATION_BUSY', '另一进程正在初始化后端;待其完成后重试', true);
110
+ }
111
+ function workspaceSdkVersion(root) {
112
+ const manifest = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
113
+ return manifest.devDependencies?.openxiangda || manifest.dependencies?.openxiangda;
114
+ }
115
+ function installBackendDependencies(root) {
116
+ const installed = spawnSync('pnpm', ['install', '--no-frozen-lockfile', '--ignore-scripts'], {
117
+ cwd: root, encoding: 'utf8', timeout: 180_000, maxBuffer: 4 * 1024 * 1024,
118
+ });
119
+ if (installed.status !== 0 || installed.error) {
120
+ throw initializationError('OPENXIANGDA_BACKEND_INSTALL_FAILED', '后端源码已保留,依赖安装未完成;检查包管理器/网络后重新运行 openxiangda check 或 dev', true);
121
+ }
122
+ }
123
+ function assertContainedPath(root, target) {
124
+ const name = relative(root, target);
125
+ if (!name || name.startsWith(`..${sep}`) || name === '..' || isAbsolute(name)) {
126
+ throw initializationError('OPENXIANGDA_BACKEND_PATH_INVALID', '后端目录必须位于当前工作区内');
127
+ }
128
+ let current = root;
129
+ for (const part of name.split(sep)) {
130
+ current = join(current, part);
131
+ try {
132
+ if (lstatSync(current).isSymbolicLink()) {
133
+ throw initializationError('OPENXIANGDA_BACKEND_PATH_INVALID', '后端目录不能穿过符号链接');
134
+ }
135
+ }
136
+ catch (error) {
137
+ if (error.code !== 'ENOENT')
138
+ throw error;
139
+ }
140
+ }
141
+ }
142
+ function initializationError(code, message, retryable = false) {
143
+ return Object.assign(new Error(`${code}: ${message}`), { code, retryable });
144
+ }
145
+ //# sourceMappingURL=optional-backend.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"optional-backend.js","sourceRoot":"","sources":["../src/optional-backend.ts"],"names":[],"mappings":"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"}
@@ -1,2 +1,2 @@
1
- export * from 'openxiangda-compiler';
1
+ export * from './compiler/package-compiler.js';
2
2
  //# sourceMappingURL=package-compiler.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"package-compiler.d.ts","sourceRoot":"","sources":["../src/package-compiler.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
1
+ {"version":3,"file":"package-compiler.d.ts","sourceRoot":"","sources":["../src/package-compiler.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}
@@ -1,2 +1,2 @@
1
- export * from 'openxiangda-compiler';
1
+ export * from './compiler/package-compiler.js';
2
2
  //# sourceMappingURL=package-compiler.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"package-compiler.js","sourceRoot":"","sources":["../src/package-compiler.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
1
+ {"version":3,"file":"package-compiler.js","sourceRoot":"","sources":["../src/package-compiler.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}
package/dist/session.d.ts CHANGED
@@ -1,20 +1,165 @@
1
+ type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
1
2
  export interface OpenXiangdaSession {
2
3
  schemaVersion: 2;
3
4
  baseUrl: string;
4
- token: string;
5
+ accessToken: string;
6
+ refreshToken?: string;
7
+ accessTokenExpiresAt?: number;
8
+ refreshTokenExpiresAt?: number;
5
9
  savedAt: string;
10
+ source: "file" | "environment";
11
+ }
12
+ export interface DeveloperIdentity {
13
+ user: Record<string, unknown> | null;
14
+ tenant: Record<string, unknown> | null;
15
+ isPlatformAdmin: boolean;
16
+ manageableAppTypes: string[];
17
+ }
18
+ export interface CliAuthorizationStart {
19
+ sessionId: string;
20
+ loginUrl: string;
21
+ qrText: string;
22
+ expireIn: number;
23
+ pollSecret: string;
24
+ }
25
+ export declare class DeveloperSessionError extends Error {
26
+ readonly code: string;
27
+ readonly status?: number | undefined;
28
+ readonly data?: unknown | undefined;
29
+ constructor(code: string, message: string, status?: number | undefined, data?: unknown | undefined);
6
30
  }
7
31
  export declare function defaultSessionPath(): string;
8
- export declare function loadSession(path?: string): Promise<OpenXiangdaSession | null>;
32
+ export declare function normalizePlatformBaseUrl(value: string): string;
33
+ export declare function loadSession(path?: string): Promise<{
34
+ schemaVersion: 2;
35
+ baseUrl: string;
36
+ accessToken: string;
37
+ savedAt: string;
38
+ source: "environment";
39
+ } | {
40
+ savedAt: string;
41
+ source: "file";
42
+ refreshTokenExpiresAt?: number;
43
+ accessTokenExpiresAt?: number;
44
+ refreshToken?: string;
45
+ schemaVersion: 2;
46
+ baseUrl: string;
47
+ accessToken: string;
48
+ } | null>;
9
49
  export declare function saveSession(input: {
10
50
  baseUrl: string;
11
- token: string;
51
+ accessToken?: string;
52
+ token?: string;
53
+ refreshToken?: string;
54
+ accessTokenExpiresAt?: number;
55
+ refreshTokenExpiresAt?: number;
12
56
  }, path?: string): Promise<{
13
- token: string;
14
57
  schemaVersion: 2;
15
58
  baseUrl: string;
59
+ accessToken: string;
60
+ refreshTokenConfigured: boolean;
61
+ accessTokenExpiresAt: number | undefined;
62
+ refreshTokenExpiresAt: number | undefined;
16
63
  savedAt: string;
64
+ source: "file" | "environment";
17
65
  }>;
18
66
  export declare function clearSession(path?: string): Promise<void>;
67
+ /** Read-only snapshot: never refresh, persist, redirect, or initiate authorization. */
68
+ export declare function developerAuthorizationStatus(input: {
69
+ baseUrl: string;
70
+ sessionPath?: string;
71
+ fetch?: FetchLike;
72
+ now?: () => number;
73
+ }): Promise<{
74
+ ok: boolean;
75
+ operation: string;
76
+ workspace: {
77
+ appCode: string;
78
+ root: string;
79
+ };
80
+ data: {
81
+ baseUrl: string;
82
+ observedAt: string;
83
+ state: "unavailable" | "missing" | "authorized" | "platform_mismatch" | "refresh_required" | "unauthorized";
84
+ authorized: boolean;
85
+ };
86
+ diagnostics: never[];
87
+ nextActions: never[];
88
+ }>;
19
89
  export declare function redactToken(token: string): string;
90
+ export declare function sessionSummary(session: OpenXiangdaSession): {
91
+ schemaVersion: 2;
92
+ baseUrl: string;
93
+ accessToken: string;
94
+ refreshTokenConfigured: boolean;
95
+ accessTokenExpiresAt: number | undefined;
96
+ refreshTokenExpiresAt: number | undefined;
97
+ savedAt: string;
98
+ source: "file" | "environment";
99
+ };
100
+ export declare class OpenXiangdaDeveloperSession {
101
+ private session;
102
+ private readonly options;
103
+ private refreshInFlight;
104
+ private validated;
105
+ constructor(session: OpenXiangdaSession, options?: {
106
+ fetch?: FetchLike;
107
+ sessionPath?: string;
108
+ now?: () => number;
109
+ });
110
+ static load(options?: {
111
+ fetch?: FetchLike;
112
+ sessionPath?: string;
113
+ now?: () => number;
114
+ }): Promise<OpenXiangdaDeveloperSession | null>;
115
+ get baseUrl(): string;
116
+ summary(): {
117
+ schemaVersion: 2;
118
+ baseUrl: string;
119
+ accessToken: string;
120
+ refreshTokenConfigured: boolean;
121
+ accessTokenExpiresAt: number | undefined;
122
+ refreshTokenExpiresAt: number | undefined;
123
+ savedAt: string;
124
+ source: "file" | "environment";
125
+ };
126
+ assertPlatform(linkedBaseUrl: string): void;
127
+ getAccessToken(input?: {
128
+ forceRefresh?: boolean;
129
+ }): Promise<string>;
130
+ whoami(): Promise<DeveloperIdentity>;
131
+ logout(): Promise<{
132
+ serverError?: string;
133
+ loggedOut: boolean;
134
+ serverRevoked: boolean;
135
+ }>;
136
+ private shouldRefresh;
137
+ private refresh;
138
+ private performRefresh;
139
+ private requestWhoami;
140
+ private request;
141
+ private isUnauthorized;
142
+ private get fetch();
143
+ private now;
144
+ }
145
+ export declare function authorizeDeveloperSession(input: {
146
+ baseUrl: string;
147
+ fetch?: FetchLike;
148
+ sessionPath?: string;
149
+ pollIntervalMs?: number;
150
+ onAuthorization?: (authorization: CliAuthorizationStart) => void | Promise<void>;
151
+ }): Promise<{
152
+ session: {
153
+ schemaVersion: 2;
154
+ baseUrl: string;
155
+ accessToken: string;
156
+ refreshTokenConfigured: boolean;
157
+ accessTokenExpiresAt: number | undefined;
158
+ refreshTokenExpiresAt: number | undefined;
159
+ savedAt: string;
160
+ source: "file" | "environment";
161
+ };
162
+ identity: DeveloperIdentity;
163
+ }>;
164
+ export {};
20
165
  //# sourceMappingURL=session.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,WAEjC;AAED,wBAAsB,WAAW,CAAC,IAAI,SAAuB,sCAc5D;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACzC,IAAI,SAAuB;;mBA5BZ,CAAC;aACP,MAAM;aAEN,MAAM;GAwChB;AAED,wBAAsB,YAAY,CAAC,IAAI,SAAuB,iBAE7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,UAGxC"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}