@xyteai/cli 0.1.0

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 (251) hide show
  1. package/LICENSE +176 -0
  2. package/README.md +245 -0
  3. package/dist/bin/xyte-cli.d.ts +3 -0
  4. package/dist/bin/xyte-cli.d.ts.map +1 -0
  5. package/dist/bin/xyte-cli.js +18 -0
  6. package/dist/bin/xyte-cli.js.map +1 -0
  7. package/dist/cli/index.d.ts +24 -0
  8. package/dist/cli/index.d.ts.map +1 -0
  9. package/dist/cli/index.js +1185 -0
  10. package/dist/cli/index.js.map +1 -0
  11. package/dist/client/catalog.d.ts +6 -0
  12. package/dist/client/catalog.d.ts.map +1 -0
  13. package/dist/client/catalog.js +32 -0
  14. package/dist/client/catalog.js.map +1 -0
  15. package/dist/client/create-client.d.ts +3 -0
  16. package/dist/client/create-client.d.ts.map +1 -0
  17. package/dist/client/create-client.js +235 -0
  18. package/dist/client/create-client.js.map +1 -0
  19. package/dist/config/connectivity.d.ts +19 -0
  20. package/dist/config/connectivity.d.ts.map +1 -0
  21. package/dist/config/connectivity.js +166 -0
  22. package/dist/config/connectivity.js.map +1 -0
  23. package/dist/config/readiness.d.ts +32 -0
  24. package/dist/config/readiness.d.ts.map +1 -0
  25. package/dist/config/readiness.js +96 -0
  26. package/dist/config/readiness.js.map +1 -0
  27. package/dist/config/retry-policy.d.ts +16 -0
  28. package/dist/config/retry-policy.d.ts.map +1 -0
  29. package/dist/config/retry-policy.js +24 -0
  30. package/dist/config/retry-policy.js.map +1 -0
  31. package/dist/contracts/call-envelope.d.ts +74 -0
  32. package/dist/contracts/call-envelope.d.ts.map +1 -0
  33. package/dist/contracts/call-envelope.js +72 -0
  34. package/dist/contracts/call-envelope.js.map +1 -0
  35. package/dist/contracts/problem.d.ts +11 -0
  36. package/dist/contracts/problem.d.ts.map +1 -0
  37. package/dist/contracts/problem.js +55 -0
  38. package/dist/contracts/problem.js.map +1 -0
  39. package/dist/contracts/versions.d.ts +6 -0
  40. package/dist/contracts/versions.d.ts.map +1 -0
  41. package/dist/contracts/versions.js +9 -0
  42. package/dist/contracts/versions.js.map +1 -0
  43. package/dist/http/errors.d.ts +24 -0
  44. package/dist/http/errors.d.ts.map +1 -0
  45. package/dist/http/errors.js +39 -0
  46. package/dist/http/errors.js.map +1 -0
  47. package/dist/http/transport.d.ts +35 -0
  48. package/dist/http/transport.d.ts.map +1 -0
  49. package/dist/http/transport.js +129 -0
  50. package/dist/http/transport.js.map +1 -0
  51. package/dist/index.d.ts +10 -0
  52. package/dist/index.d.ts.map +1 -0
  53. package/dist/index.js +23 -0
  54. package/dist/index.js.map +1 -0
  55. package/dist/mcp/server.d.ts +12 -0
  56. package/dist/mcp/server.d.ts.map +1 -0
  57. package/dist/mcp/server.js +404 -0
  58. package/dist/mcp/server.js.map +1 -0
  59. package/dist/namespaces/device.d.ts +38 -0
  60. package/dist/namespaces/device.d.ts.map +1 -0
  61. package/dist/namespaces/device.js +36 -0
  62. package/dist/namespaces/device.js.map +1 -0
  63. package/dist/namespaces/organization.d.ts +27 -0
  64. package/dist/namespaces/organization.d.ts.map +1 -0
  65. package/dist/namespaces/organization.js +30 -0
  66. package/dist/namespaces/organization.js.map +1 -0
  67. package/dist/namespaces/partner.d.ts +18 -0
  68. package/dist/namespaces/partner.d.ts.map +1 -0
  69. package/dist/namespaces/partner.js +21 -0
  70. package/dist/namespaces/partner.js.map +1 -0
  71. package/dist/observability/logger.d.ts +3 -0
  72. package/dist/observability/logger.d.ts.map +1 -0
  73. package/dist/observability/logger.js +21 -0
  74. package/dist/observability/logger.js.map +1 -0
  75. package/dist/observability/tracing.d.ts +3 -0
  76. package/dist/observability/tracing.d.ts.map +1 -0
  77. package/dist/observability/tracing.js +26 -0
  78. package/dist/observability/tracing.js.map +1 -0
  79. package/dist/secure/key-slots.d.ts +8 -0
  80. package/dist/secure/key-slots.d.ts.map +1 -0
  81. package/dist/secure/key-slots.js +47 -0
  82. package/dist/secure/key-slots.js.map +1 -0
  83. package/dist/secure/keychain.d.ts +20 -0
  84. package/dist/secure/keychain.d.ts.map +1 -0
  85. package/dist/secure/keychain.js +170 -0
  86. package/dist/secure/keychain.js.map +1 -0
  87. package/dist/secure/profile-store.d.ts +66 -0
  88. package/dist/secure/profile-store.d.ts.map +1 -0
  89. package/dist/secure/profile-store.js +309 -0
  90. package/dist/secure/profile-store.js.map +1 -0
  91. package/dist/spec/public-endpoints.json +1175 -0
  92. package/dist/tui/animation.d.ts +12 -0
  93. package/dist/tui/animation.d.ts.map +1 -0
  94. package/dist/tui/animation.js +41 -0
  95. package/dist/tui/animation.js.map +1 -0
  96. package/dist/tui/app.d.ts +27 -0
  97. package/dist/tui/app.d.ts.map +1 -0
  98. package/dist/tui/app.js +711 -0
  99. package/dist/tui/app.js.map +1 -0
  100. package/dist/tui/assets/logo.d.ts +5 -0
  101. package/dist/tui/assets/logo.d.ts.map +1 -0
  102. package/dist/tui/assets/logo.js +24 -0
  103. package/dist/tui/assets/logo.js.map +1 -0
  104. package/dist/tui/data-loaders.d.ts +33 -0
  105. package/dist/tui/data-loaders.d.ts.map +1 -0
  106. package/dist/tui/data-loaders.js +250 -0
  107. package/dist/tui/data-loaders.js.map +1 -0
  108. package/dist/tui/dispatch.d.ts +14 -0
  109. package/dist/tui/dispatch.d.ts.map +1 -0
  110. package/dist/tui/dispatch.js +44 -0
  111. package/dist/tui/dispatch.js.map +1 -0
  112. package/dist/tui/headless-renderer.d.ts +20 -0
  113. package/dist/tui/headless-renderer.d.ts.map +1 -0
  114. package/dist/tui/headless-renderer.js +598 -0
  115. package/dist/tui/headless-renderer.js.map +1 -0
  116. package/dist/tui/input-controller.d.ts +29 -0
  117. package/dist/tui/input-controller.d.ts.map +1 -0
  118. package/dist/tui/input-controller.js +76 -0
  119. package/dist/tui/input-controller.js.map +1 -0
  120. package/dist/tui/key-wizard.d.ts +29 -0
  121. package/dist/tui/key-wizard.d.ts.map +1 -0
  122. package/dist/tui/key-wizard.js +177 -0
  123. package/dist/tui/key-wizard.js.map +1 -0
  124. package/dist/tui/keymap.d.ts +9 -0
  125. package/dist/tui/keymap.d.ts.map +1 -0
  126. package/dist/tui/keymap.js +29 -0
  127. package/dist/tui/keymap.js.map +1 -0
  128. package/dist/tui/layout.d.ts +16 -0
  129. package/dist/tui/layout.d.ts.map +1 -0
  130. package/dist/tui/layout.js +99 -0
  131. package/dist/tui/layout.js.map +1 -0
  132. package/dist/tui/logger.d.ts +12 -0
  133. package/dist/tui/logger.d.ts.map +1 -0
  134. package/dist/tui/logger.js +83 -0
  135. package/dist/tui/logger.js.map +1 -0
  136. package/dist/tui/navigation.d.ts +26 -0
  137. package/dist/tui/navigation.d.ts.map +1 -0
  138. package/dist/tui/navigation.js +136 -0
  139. package/dist/tui/navigation.js.map +1 -0
  140. package/dist/tui/panes.d.ts +7 -0
  141. package/dist/tui/panes.d.ts.map +1 -0
  142. package/dist/tui/panes.js +34 -0
  143. package/dist/tui/panes.js.map +1 -0
  144. package/dist/tui/runtime.d.ts +34 -0
  145. package/dist/tui/runtime.d.ts.map +1 -0
  146. package/dist/tui/runtime.js +100 -0
  147. package/dist/tui/runtime.js.map +1 -0
  148. package/dist/tui/scene.d.ts +160 -0
  149. package/dist/tui/scene.d.ts.map +1 -0
  150. package/dist/tui/scene.js +424 -0
  151. package/dist/tui/scene.js.map +1 -0
  152. package/dist/tui/screens/config.d.ts +3 -0
  153. package/dist/tui/screens/config.d.ts.map +1 -0
  154. package/dist/tui/screens/config.js +406 -0
  155. package/dist/tui/screens/config.js.map +1 -0
  156. package/dist/tui/screens/dashboard.d.ts +3 -0
  157. package/dist/tui/screens/dashboard.d.ts.map +1 -0
  158. package/dist/tui/screens/dashboard.js +176 -0
  159. package/dist/tui/screens/dashboard.js.map +1 -0
  160. package/dist/tui/screens/devices.d.ts +3 -0
  161. package/dist/tui/screens/devices.d.ts.map +1 -0
  162. package/dist/tui/screens/devices.js +297 -0
  163. package/dist/tui/screens/devices.js.map +1 -0
  164. package/dist/tui/screens/incidents.d.ts +4 -0
  165. package/dist/tui/screens/incidents.d.ts.map +1 -0
  166. package/dist/tui/screens/incidents.js +304 -0
  167. package/dist/tui/screens/incidents.js.map +1 -0
  168. package/dist/tui/screens/setup.d.ts +3 -0
  169. package/dist/tui/screens/setup.d.ts.map +1 -0
  170. package/dist/tui/screens/setup.js +299 -0
  171. package/dist/tui/screens/setup.js.map +1 -0
  172. package/dist/tui/screens/spaces.d.ts +7 -0
  173. package/dist/tui/screens/spaces.d.ts.map +1 -0
  174. package/dist/tui/screens/spaces.js +422 -0
  175. package/dist/tui/screens/spaces.js.map +1 -0
  176. package/dist/tui/screens/tickets.d.ts +9 -0
  177. package/dist/tui/screens/tickets.d.ts.map +1 -0
  178. package/dist/tui/screens/tickets.js +418 -0
  179. package/dist/tui/screens/tickets.js.map +1 -0
  180. package/dist/tui/serialize.d.ts +31 -0
  181. package/dist/tui/serialize.d.ts.map +1 -0
  182. package/dist/tui/serialize.js +183 -0
  183. package/dist/tui/serialize.js.map +1 -0
  184. package/dist/tui/table-format.d.ts +11 -0
  185. package/dist/tui/table-format.d.ts.map +1 -0
  186. package/dist/tui/table-format.js +77 -0
  187. package/dist/tui/table-format.js.map +1 -0
  188. package/dist/tui/tabs.d.ts +4 -0
  189. package/dist/tui/tabs.d.ts.map +1 -0
  190. package/dist/tui/tabs.js +13 -0
  191. package/dist/tui/tabs.js.map +1 -0
  192. package/dist/tui/types.d.ts +37 -0
  193. package/dist/tui/types.d.ts.map +1 -0
  194. package/dist/tui/types.js +3 -0
  195. package/dist/tui/types.js.map +1 -0
  196. package/dist/types/client.d.ts +54 -0
  197. package/dist/types/client.d.ts.map +1 -0
  198. package/dist/types/client.js +3 -0
  199. package/dist/types/client.js.map +1 -0
  200. package/dist/types/endpoints.d.ts +29 -0
  201. package/dist/types/endpoints.d.ts.map +1 -0
  202. package/dist/types/endpoints.js +3 -0
  203. package/dist/types/endpoints.js.map +1 -0
  204. package/dist/types/profile.d.ts +29 -0
  205. package/dist/types/profile.d.ts.map +1 -0
  206. package/dist/types/profile.js +3 -0
  207. package/dist/types/profile.js.map +1 -0
  208. package/dist/utils/config-dir.d.ts +2 -0
  209. package/dist/utils/config-dir.d.ts.map +1 -0
  210. package/dist/utils/config-dir.js +23 -0
  211. package/dist/utils/config-dir.js.map +1 -0
  212. package/dist/utils/error-format.d.ts +4 -0
  213. package/dist/utils/error-format.d.ts.map +1 -0
  214. package/dist/utils/error-format.js +34 -0
  215. package/dist/utils/error-format.js.map +1 -0
  216. package/dist/utils/install-skills.d.ts +38 -0
  217. package/dist/utils/install-skills.d.ts.map +1 -0
  218. package/dist/utils/install-skills.js +117 -0
  219. package/dist/utils/install-skills.js.map +1 -0
  220. package/dist/utils/json-output.d.ts +6 -0
  221. package/dist/utils/json-output.d.ts.map +1 -0
  222. package/dist/utils/json-output.js +30 -0
  223. package/dist/utils/json-output.js.map +1 -0
  224. package/dist/utils/json.d.ts +4 -0
  225. package/dist/utils/json.d.ts.map +1 -0
  226. package/dist/utils/json.js +36 -0
  227. package/dist/utils/json.js.map +1 -0
  228. package/dist/utils/version.d.ts +2 -0
  229. package/dist/utils/version.d.ts.map +1 -0
  230. package/dist/utils/version.js +28 -0
  231. package/dist/utils/version.js.map +1 -0
  232. package/dist/workflows/fleet-insights.d.ts +122 -0
  233. package/dist/workflows/fleet-insights.d.ts.map +1 -0
  234. package/dist/workflows/fleet-insights.js +938 -0
  235. package/dist/workflows/fleet-insights.js.map +1 -0
  236. package/docs/schemas/call-envelope.v1.schema.json +140 -0
  237. package/docs/schemas/headless-frame.v1.schema.json +159 -0
  238. package/docs/schemas/inspect-deep-dive.v1.schema.json +251 -0
  239. package/docs/schemas/inspect-fleet.v1.schema.json +111 -0
  240. package/docs/schemas/report.v1.schema.json +39 -0
  241. package/package.json +75 -0
  242. package/skills/xyte-cli/SKILL.md +181 -0
  243. package/skills/xyte-cli/agents/openai.yaml +4 -0
  244. package/skills/xyte-cli/references/endpoints.md +106 -0
  245. package/skills/xyte-cli/references/headless-contract.md +96 -0
  246. package/skills/xyte-cli/references/tui-flows.md +126 -0
  247. package/skills/xyte-cli/scripts/check_headless.sh +83 -0
  248. package/skills/xyte-cli/scripts/endpoint_filters_report.sh +33 -0
  249. package/skills/xyte-cli/scripts/run_xyte_cli.sh +12 -0
  250. package/skills/xyte-cli/scripts/validate_agent_contracts.sh +72 -0
  251. package/skills/xyte-cli/scripts/validate_with_schema.js +30 -0
@@ -0,0 +1,96 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.evaluateReadiness = evaluateReadiness;
4
+ const connectivity_1 = require("./connectivity");
5
+ const XYTE_PROVIDERS = ['xyte-org', 'xyte-partner', 'xyte-device'];
6
+ function defaultConnectivity() {
7
+ return {
8
+ state: 'not_checked',
9
+ message: 'Connectivity not checked.',
10
+ retriable: false
11
+ };
12
+ }
13
+ function connectionToState(connection) {
14
+ if (connection.state === 'connected' || connection.state === 'not_checked') {
15
+ return 'ready';
16
+ }
17
+ if (connection.state === 'auth_required' || connection.state === 'missing_key') {
18
+ return 'needs_setup';
19
+ }
20
+ return 'degraded';
21
+ }
22
+ async function evaluateReadiness(options) {
23
+ const profile = await options.profileStore.getData();
24
+ const tenantId = options.tenantId ?? profile.activeTenantId;
25
+ const missingItems = [];
26
+ const recommendedActions = [];
27
+ const providers = [];
28
+ if (!tenantId) {
29
+ missingItems.push('No active tenant is configured.');
30
+ recommendedActions.push('Run "xyte-cli" for guided first-run setup, or "xyte-cli setup run --non-interactive --tenant default --key <value>".');
31
+ return {
32
+ state: 'needs_setup',
33
+ missingItems,
34
+ recommendedActions,
35
+ providers,
36
+ connectionState: 'not_checked',
37
+ connectivity: defaultConnectivity()
38
+ };
39
+ }
40
+ const tenant = await options.profileStore.getTenant(tenantId);
41
+ if (!tenant) {
42
+ missingItems.push(`Active tenant "${tenantId}" does not exist in profile.`);
43
+ recommendedActions.push('Run "xyte-cli setup run" (or "xyte-cli" in a TTY) to recreate the active tenant profile.');
44
+ return {
45
+ state: 'needs_setup',
46
+ tenantId,
47
+ missingItems,
48
+ recommendedActions,
49
+ providers,
50
+ connectionState: 'not_checked',
51
+ connectivity: defaultConnectivity()
52
+ };
53
+ }
54
+ for (const provider of XYTE_PROVIDERS) {
55
+ const [slots, active] = await Promise.all([
56
+ options.profileStore.listKeySlots(tenant.id, provider),
57
+ options.profileStore.getActiveKeySlot(tenant.id, provider)
58
+ ]);
59
+ const hasActiveSecret = active ? Boolean(await options.keychain.getSlotSecret(tenant.id, provider, active.slotId)) : false;
60
+ providers.push({
61
+ provider,
62
+ slotCount: slots.length,
63
+ activeSlotId: active?.slotId,
64
+ activeSlotName: active?.name,
65
+ hasActiveSecret
66
+ });
67
+ }
68
+ const hasXyteCredential = providers.some((provider) => XYTE_PROVIDERS.includes(provider.provider) && provider.hasActiveSecret);
69
+ if (!hasXyteCredential) {
70
+ missingItems.push('No active Xyte API key slot is configured (xyte-org / xyte-partner / xyte-device).');
71
+ recommendedActions.push('Run "xyte-cli" for guided setup, or "xyte-cli setup run --tenant <tenant-id> --key <value>".');
72
+ }
73
+ let connectivity = defaultConnectivity();
74
+ if (options.client && options.checkConnectivity && hasXyteCredential) {
75
+ connectivity = await (0, connectivity_1.probeConnectivity)({ client: options.client, tenantId: tenant.id });
76
+ if (connectivity.state === 'auth_required' || connectivity.state === 'missing_key') {
77
+ missingItems.push(`Connectivity check requires updated credentials: ${connectivity.message}`);
78
+ recommendedActions.push('Use "xyte-cli auth key list/use/update" to select or update the active slot.');
79
+ }
80
+ else if (connectivity.state !== 'connected') {
81
+ recommendedActions.push('Use retry/reconnect actions in TUI or run "xyte-cli config doctor".');
82
+ }
83
+ }
84
+ const baseState = missingItems.length > 0 ? 'needs_setup' : connectionToState(connectivity);
85
+ return {
86
+ state: baseState,
87
+ activeTenant: tenant,
88
+ tenantId: tenant.id,
89
+ missingItems,
90
+ recommendedActions,
91
+ providers,
92
+ connectionState: connectivity.state,
93
+ connectivity
94
+ };
95
+ }
96
+ //# sourceMappingURL=readiness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/config/readiness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { ConnectionErrorClass } from './connectivity';
2
+ export interface RetryPolicyOptions {
3
+ maxAttempts?: number;
4
+ baseDelayMs?: number;
5
+ maxDelayMs?: number;
6
+ jitterRatio?: number;
7
+ }
8
+ export interface RetryState {
9
+ attempts: number;
10
+ retried: boolean;
11
+ nextRetryMs?: number;
12
+ }
13
+ export declare const DEFAULT_RETRY_POLICY: Required<RetryPolicyOptions>;
14
+ export declare function isRetryableErrorClass(kind: ConnectionErrorClass | undefined): boolean;
15
+ export declare function computeRetryDelayMs(attempt: number, options?: RetryPolicyOptions): number;
16
+ //# sourceMappingURL=retry-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../src/config/retry-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,kBAAkB,CAK7D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAKrF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAK7F"}
@@ -0,0 +1,24 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DEFAULT_RETRY_POLICY = void 0;
4
+ exports.isRetryableErrorClass = isRetryableErrorClass;
5
+ exports.computeRetryDelayMs = computeRetryDelayMs;
6
+ exports.DEFAULT_RETRY_POLICY = {
7
+ maxAttempts: 3,
8
+ baseDelayMs: 250,
9
+ maxDelayMs: 5_000,
10
+ jitterRatio: 0.2
11
+ };
12
+ function isRetryableErrorClass(kind) {
13
+ if (!kind) {
14
+ return false;
15
+ }
16
+ return !['auth', 'missing_key'].includes(kind);
17
+ }
18
+ function computeRetryDelayMs(attempt, options = {}) {
19
+ const merged = { ...exports.DEFAULT_RETRY_POLICY, ...options };
20
+ const expDelay = Math.min(merged.maxDelayMs, merged.baseDelayMs * 2 ** Math.max(0, attempt - 1));
21
+ const jitter = expDelay * merged.jitterRatio * Math.random();
22
+ return Math.round(expDelay + jitter);
23
+ }
24
+ //# sourceMappingURL=retry-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry-policy.js","sourceRoot":"","sources":["../../src/config/retry-policy.ts"],"names":[],"mappings":";;;AAsBA,sDAKC;AAED,kDAKC;AAnBY,QAAA,oBAAoB,GAAiC;IAChE,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,GAAG;CACjB,CAAC;AAEF,SAAgB,qBAAqB,CAAC,IAAsC;IAC1E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAe,EAAE,UAA8B,EAAE;IACnF,MAAM,MAAM,GAAG,EAAE,GAAG,4BAAoB,EAAE,GAAG,OAAO,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;AACvC,CAAC"}
@@ -0,0 +1,74 @@
1
+ import { z } from 'zod';
2
+ import type { ProblemDetails } from './problem';
3
+ export declare const CallGuardSchema: z.ZodObject<{
4
+ allowWrite: z.ZodBoolean;
5
+ confirm: z.ZodOptional<z.ZodString>;
6
+ }, z.core.$strip>;
7
+ export declare const CallEnvelopeResponseSchema: z.ZodObject<{
8
+ status: z.ZodNumber;
9
+ durationMs: z.ZodNumber;
10
+ retryCount: z.ZodNumber;
11
+ data: z.ZodUnknown;
12
+ }, z.core.$strip>;
13
+ export declare const CallEnvelopeRequestSchema: z.ZodObject<{
14
+ path: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
15
+ query: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
16
+ body: z.ZodOptional<z.ZodUnknown>;
17
+ }, z.core.$strip>;
18
+ export declare const CallEnvelopeSchema: z.ZodObject<{
19
+ schemaVersion: z.ZodLiteral<"xyte.call.envelope.v1">;
20
+ timestamp: z.ZodString;
21
+ requestId: z.ZodString;
22
+ tenantId: z.ZodOptional<z.ZodString>;
23
+ endpointKey: z.ZodString;
24
+ method: z.ZodString;
25
+ guard: z.ZodObject<{
26
+ allowWrite: z.ZodBoolean;
27
+ confirm: z.ZodOptional<z.ZodString>;
28
+ }, z.core.$strip>;
29
+ request: z.ZodObject<{
30
+ path: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
31
+ query: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
32
+ body: z.ZodOptional<z.ZodUnknown>;
33
+ }, z.core.$strip>;
34
+ response: z.ZodOptional<z.ZodObject<{
35
+ status: z.ZodNumber;
36
+ durationMs: z.ZodNumber;
37
+ retryCount: z.ZodNumber;
38
+ data: z.ZodUnknown;
39
+ }, z.core.$strip>>;
40
+ error: z.ZodOptional<z.ZodObject<{
41
+ type: z.ZodString;
42
+ title: z.ZodString;
43
+ status: z.ZodOptional<z.ZodNumber>;
44
+ detail: z.ZodString;
45
+ instance: z.ZodOptional<z.ZodString>;
46
+ xyteCode: z.ZodString;
47
+ retriable: z.ZodBoolean;
48
+ }, z.core.$strip>>;
49
+ }, z.core.$strip>;
50
+ export type CallEnvelopeV1 = z.infer<typeof CallEnvelopeSchema>;
51
+ export interface BuildCallEnvelopeArgs {
52
+ requestId: string;
53
+ tenantId?: string;
54
+ endpointKey: string;
55
+ method: string;
56
+ guard: {
57
+ allowWrite: boolean;
58
+ confirm?: string;
59
+ };
60
+ request: {
61
+ path?: Record<string, string | number>;
62
+ query?: Record<string, string | number | boolean | null | undefined>;
63
+ body?: unknown;
64
+ };
65
+ response?: {
66
+ status: number;
67
+ durationMs: number;
68
+ retryCount: number;
69
+ data: unknown;
70
+ };
71
+ error?: ProblemDetails;
72
+ }
73
+ export declare function buildCallEnvelope(args: BuildCallEnvelopeArgs): CallEnvelopeV1;
74
+ //# sourceMappingURL=call-envelope.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call-envelope.d.ts","sourceRoot":"","sources":["../../src/contracts/call-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqB7B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QACL,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CA4B7E"}
@@ -0,0 +1,72 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CallEnvelopeSchema = exports.CallEnvelopeRequestSchema = exports.CallEnvelopeResponseSchema = exports.CallGuardSchema = void 0;
4
+ exports.buildCallEnvelope = buildCallEnvelope;
5
+ const zod_1 = require("zod");
6
+ const versions_1 = require("./versions");
7
+ exports.CallGuardSchema = zod_1.z.object({
8
+ allowWrite: zod_1.z.boolean(),
9
+ confirm: zod_1.z.string().optional()
10
+ });
11
+ exports.CallEnvelopeResponseSchema = zod_1.z.object({
12
+ status: zod_1.z.number().int().nonnegative(),
13
+ durationMs: zod_1.z.number().int().nonnegative(),
14
+ retryCount: zod_1.z.number().int().nonnegative(),
15
+ data: zod_1.z.unknown()
16
+ });
17
+ exports.CallEnvelopeRequestSchema = zod_1.z.object({
18
+ path: zod_1.z.record(zod_1.z.string(), zod_1.z.union([zod_1.z.string(), zod_1.z.number()])).default({}),
19
+ query: zod_1.z.record(zod_1.z.string(), zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.null()])).default({}),
20
+ body: zod_1.z.unknown().optional()
21
+ });
22
+ exports.CallEnvelopeSchema = zod_1.z.object({
23
+ schemaVersion: zod_1.z.literal(versions_1.CALL_ENVELOPE_SCHEMA_VERSION),
24
+ timestamp: zod_1.z.string(),
25
+ requestId: zod_1.z.string(),
26
+ tenantId: zod_1.z.string().optional(),
27
+ endpointKey: zod_1.z.string(),
28
+ method: zod_1.z.string(),
29
+ guard: exports.CallGuardSchema,
30
+ request: exports.CallEnvelopeRequestSchema,
31
+ response: exports.CallEnvelopeResponseSchema.optional(),
32
+ error: zod_1.z
33
+ .object({
34
+ type: zod_1.z.string(),
35
+ title: zod_1.z.string(),
36
+ status: zod_1.z.number().int().optional(),
37
+ detail: zod_1.z.string(),
38
+ instance: zod_1.z.string().optional(),
39
+ xyteCode: zod_1.z.string(),
40
+ retriable: zod_1.z.boolean()
41
+ })
42
+ .optional()
43
+ });
44
+ function buildCallEnvelope(args) {
45
+ const query = {};
46
+ for (const [key, value] of Object.entries(args.request.query ?? {})) {
47
+ if (value === undefined) {
48
+ continue;
49
+ }
50
+ query[key] = value;
51
+ }
52
+ return {
53
+ schemaVersion: versions_1.CALL_ENVELOPE_SCHEMA_VERSION,
54
+ timestamp: new Date().toISOString(),
55
+ requestId: args.requestId,
56
+ tenantId: args.tenantId,
57
+ endpointKey: args.endpointKey,
58
+ method: args.method,
59
+ guard: {
60
+ allowWrite: args.guard.allowWrite,
61
+ confirm: args.guard.confirm
62
+ },
63
+ request: {
64
+ path: args.request.path ?? {},
65
+ query,
66
+ body: args.request.body
67
+ },
68
+ response: args.response,
69
+ error: args.error
70
+ };
71
+ }
72
+ //# sourceMappingURL=call-envelope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call-envelope.js","sourceRoot":"","sources":["../../src/contracts/call-envelope.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export interface ProblemDetails {
2
+ type: string;
3
+ title: string;
4
+ status?: number;
5
+ detail: string;
6
+ instance?: string;
7
+ xyteCode: string;
8
+ retriable: boolean;
9
+ }
10
+ export declare function toProblemDetails(error: unknown, instance?: string): ProblemDetails;
11
+ //# sourceMappingURL=problem.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"problem.d.ts","sourceRoot":"","sources":["../../src/contracts/problem.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AASD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CA8ClF"}
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.toProblemDetails = toProblemDetails;
4
+ const errors_1 = require("../http/errors");
5
+ function toMessage(error) {
6
+ if (error instanceof Error) {
7
+ return error.message;
8
+ }
9
+ return String(error);
10
+ }
11
+ function toProblemDetails(error, instance) {
12
+ if (error instanceof errors_1.XyteHttpError) {
13
+ return {
14
+ type: 'https://xyte.dev/problems/http-error',
15
+ title: 'HTTP request failed',
16
+ status: error.status,
17
+ detail: error.message,
18
+ instance,
19
+ xyteCode: error.code,
20
+ retriable: error.status >= 500
21
+ };
22
+ }
23
+ if (error instanceof errors_1.XyteAuthError) {
24
+ return {
25
+ type: 'https://xyte.dev/problems/auth-error',
26
+ title: 'Authentication required',
27
+ status: 401,
28
+ detail: error.message,
29
+ instance,
30
+ xyteCode: error.code,
31
+ retriable: false
32
+ };
33
+ }
34
+ if (error instanceof errors_1.XyteValidationError) {
35
+ return {
36
+ type: 'https://xyte.dev/problems/validation-error',
37
+ title: 'Invalid request',
38
+ status: 400,
39
+ detail: error.message,
40
+ instance,
41
+ xyteCode: error.code,
42
+ retriable: false
43
+ };
44
+ }
45
+ return {
46
+ type: 'about:blank',
47
+ title: 'Unhandled error',
48
+ status: 500,
49
+ detail: toMessage(error),
50
+ instance,
51
+ xyteCode: 'XYTE_UNHANDLED_ERROR',
52
+ retriable: false
53
+ };
54
+ }
55
+ //# sourceMappingURL=problem.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"problem.js","sourceRoot":"","sources":["../../src/contracts/problem.ts"],"names":[],"mappings":";;AAmBA,4CA8CC;AAjED,2CAAmF;AAYnF,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAc,EAAE,QAAiB;IAChE,IAAI,KAAK,YAAY,sBAAa,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,sCAAsC;YAC5C,KAAK,EAAE,qBAAqB;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,OAAO;YACrB,QAAQ;YACR,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,sBAAa,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,sCAAsC;YAC5C,KAAK,EAAE,yBAAyB;YAChC,MAAM,EAAE,GAAG;YACX,MAAM,EAAE,KAAK,CAAC,OAAO;YACrB,QAAQ;YACR,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,4BAAmB,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,4CAA4C;YAClD,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,GAAG;YACX,MAAM,EAAE,KAAK,CAAC,OAAO;YACrB,QAAQ;YACR,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC;QACxB,QAAQ;QACR,QAAQ,EAAE,sBAAsB;QAChC,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,6 @@
1
+ export declare const CALL_ENVELOPE_SCHEMA_VERSION = "xyte.call.envelope.v1";
2
+ export declare const HEADLESS_FRAME_SCHEMA_VERSION = "xyte.headless.frame.v1";
3
+ export declare const INSPECT_FLEET_SCHEMA_VERSION = "xyte.inspect.fleet.v1";
4
+ export declare const INSPECT_DEEP_DIVE_SCHEMA_VERSION = "xyte.inspect.deep-dive.v1";
5
+ export declare const REPORT_SCHEMA_VERSION = "xyte.report.v1";
6
+ //# sourceMappingURL=versions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/contracts/versions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AACpE,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AACpE,eAAO,MAAM,gCAAgC,8BAA8B,CAAC;AAC5E,eAAO,MAAM,qBAAqB,mBAAmB,CAAC"}
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.REPORT_SCHEMA_VERSION = exports.INSPECT_DEEP_DIVE_SCHEMA_VERSION = exports.INSPECT_FLEET_SCHEMA_VERSION = exports.HEADLESS_FRAME_SCHEMA_VERSION = exports.CALL_ENVELOPE_SCHEMA_VERSION = void 0;
4
+ exports.CALL_ENVELOPE_SCHEMA_VERSION = 'xyte.call.envelope.v1';
5
+ exports.HEADLESS_FRAME_SCHEMA_VERSION = 'xyte.headless.frame.v1';
6
+ exports.INSPECT_FLEET_SCHEMA_VERSION = 'xyte.inspect.fleet.v1';
7
+ exports.INSPECT_DEEP_DIVE_SCHEMA_VERSION = 'xyte.inspect.deep-dive.v1';
8
+ exports.REPORT_SCHEMA_VERSION = 'xyte.report.v1';
9
+ //# sourceMappingURL=versions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/contracts/versions.ts"],"names":[],"mappings":";;;AAAa,QAAA,4BAA4B,GAAG,uBAAuB,CAAC;AACvD,QAAA,6BAA6B,GAAG,wBAAwB,CAAC;AACzD,QAAA,4BAA4B,GAAG,uBAAuB,CAAC;AACvD,QAAA,gCAAgC,GAAG,2BAA2B,CAAC;AAC/D,QAAA,qBAAqB,GAAG,gBAAgB,CAAC"}
@@ -0,0 +1,24 @@
1
+ export declare class XyteError extends Error {
2
+ readonly code: string;
3
+ constructor(message: string, code?: string);
4
+ }
5
+ export declare class XyteHttpError extends XyteError {
6
+ readonly status: number;
7
+ readonly statusText: string;
8
+ readonly endpointKey?: string;
9
+ readonly details?: unknown;
10
+ constructor(args: {
11
+ message: string;
12
+ status: number;
13
+ statusText: string;
14
+ endpointKey?: string;
15
+ details?: unknown;
16
+ });
17
+ }
18
+ export declare class XyteAuthError extends XyteError {
19
+ constructor(message: string);
20
+ }
21
+ export declare class XyteValidationError extends XyteError {
22
+ constructor(message: string);
23
+ }
24
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAe;CAKjD;AAED,qBAAa,aAAc,SAAQ,SAAS;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB;CAOF;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAG5B"}
@@ -0,0 +1,39 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.XyteValidationError = exports.XyteAuthError = exports.XyteHttpError = exports.XyteError = void 0;
4
+ class XyteError extends Error {
5
+ code;
6
+ constructor(message, code = 'XYTE_ERROR') {
7
+ super(message);
8
+ this.name = this.constructor.name;
9
+ this.code = code;
10
+ }
11
+ }
12
+ exports.XyteError = XyteError;
13
+ class XyteHttpError extends XyteError {
14
+ status;
15
+ statusText;
16
+ endpointKey;
17
+ details;
18
+ constructor(args) {
19
+ super(args.message, 'XYTE_HTTP_ERROR');
20
+ this.status = args.status;
21
+ this.statusText = args.statusText;
22
+ this.endpointKey = args.endpointKey;
23
+ this.details = args.details;
24
+ }
25
+ }
26
+ exports.XyteHttpError = XyteHttpError;
27
+ class XyteAuthError extends XyteError {
28
+ constructor(message) {
29
+ super(message, 'XYTE_AUTH_ERROR');
30
+ }
31
+ }
32
+ exports.XyteAuthError = XyteAuthError;
33
+ class XyteValidationError extends XyteError {
34
+ constructor(message) {
35
+ super(message, 'XYTE_VALIDATION_ERROR');
36
+ }
37
+ }
38
+ exports.XyteValidationError = XyteValidationError;
39
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAI,GAAG,YAAY;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,8BAQC;AAED,MAAa,aAAc,SAAQ,SAAS;IACjC,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,WAAW,CAAU;IACrB,OAAO,CAAW;IAE3B,YAAY,IAMX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;CACF;AAnBD,sCAmBC;AAED,MAAa,aAAc,SAAQ,SAAS;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACpC,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,mBAAoB,SAAQ,SAAS;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1C,CAAC;CACF;AAJD,kDAIC"}
@@ -0,0 +1,35 @@
1
+ export interface TransportOptions {
2
+ timeoutMs?: number;
3
+ retryAttempts?: number;
4
+ retryBackoffMs?: number;
5
+ }
6
+ export interface TransportRequest {
7
+ requestId?: string;
8
+ endpointKey?: string;
9
+ method: string;
10
+ url: string;
11
+ headers?: Record<string, string>;
12
+ body?: string | FormData;
13
+ idempotent?: boolean;
14
+ timeoutMs?: number;
15
+ }
16
+ export interface TransportMeta {
17
+ durationMs: number;
18
+ attempts: number;
19
+ retryCount: number;
20
+ }
21
+ export interface TransportResponse<T = unknown> {
22
+ status: number;
23
+ headers: Record<string, string>;
24
+ data: T;
25
+ meta: TransportMeta;
26
+ }
27
+ export declare class HttpTransport {
28
+ private readonly timeoutMs;
29
+ private readonly retryAttempts;
30
+ private readonly retryBackoffMs;
31
+ private readonly logger;
32
+ constructor(options?: TransportOptions);
33
+ request<T = unknown>(request: TransportRequest): Promise<TransportResponse<T>>;
34
+ }
35
+ //# sourceMappingURL=transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/http/transport.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,aAAa,CAAC;CACrB;AAkCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,OAAO,GAAE,gBAAqB;IAMpC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAoGrF"}