@lucern/sdk 1.0.11 → 1.0.12

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 (330) hide show
  1. package/CHANGELOG.md +3 -0
  2. package/dist/.generated +2 -0
  3. package/dist/accessControl.d.ts +19 -26
  4. package/dist/accessControl.js +195 -1423
  5. package/dist/adminClient.d.ts +52 -59
  6. package/dist/adminClient.js +364 -1142
  7. package/dist/answersClient.d.ts +5 -14
  8. package/dist/answersClient.js +19 -737
  9. package/dist/audience/index.d.ts +18 -18
  10. package/dist/audience/index.js +87 -90
  11. package/dist/audiencesClient.d.ts +19 -27
  12. package/dist/audiencesClient.js +107 -868
  13. package/dist/auditClient.d.ts +8 -15
  14. package/dist/auditClient.js +18 -791
  15. package/dist/authContext.d.ts +11 -16
  16. package/dist/authContext.js +122 -154
  17. package/dist/authDeviceClient.d.ts +8 -17
  18. package/dist/authDeviceClient.js +113 -102
  19. package/dist/beliefs/index.d.ts +15 -67
  20. package/dist/beliefs/index.js +17 -10181
  21. package/dist/beliefs/lifecycle.d.ts +10 -11
  22. package/dist/beliefs/lifecycle.js +78 -80
  23. package/dist/beliefsClient.d.ts +26 -32
  24. package/dist/beliefsClient.js +250 -990
  25. package/dist/boundaryClientSurface.d.ts +11 -16
  26. package/dist/boundaryClientSurface.js +49 -68
  27. package/dist/client.d.ts +64 -112
  28. package/dist/client.js +232 -10155
  29. package/dist/clientAssemblyTypes.d.ts +3 -3
  30. package/dist/clientAssemblyTypes.js +1 -2
  31. package/dist/clientConfig.d.ts +45 -59
  32. package/dist/clientConfig.js +1 -2
  33. package/dist/clientEvidenceCompat.d.ts +7 -14
  34. package/dist/clientEvidenceCompat.js +50 -64
  35. package/dist/clientGraphNamespaces.d.ts +3 -5
  36. package/dist/clientGraphNamespaces.js +170 -245
  37. package/dist/clientHelpers.d.ts +20 -25
  38. package/dist/clientHelpers.js +104 -127
  39. package/dist/clientKnowledgeNamespaces.d.ts +6 -53
  40. package/dist/clientKnowledgeNamespaces.js +502 -506
  41. package/dist/clientLocalHelpers.d.ts +11 -56
  42. package/dist/clientLocalHelpers.js +503 -732
  43. package/dist/clientPlatformNamespaces.d.ts +5 -53
  44. package/dist/clientPlatformNamespaces.js +229 -323
  45. package/dist/clientRuntime.d.ts +5 -53
  46. package/dist/clientRuntime.js +26 -30
  47. package/dist/clientWorkflowNamespaces.d.ts +6 -15
  48. package/dist/clientWorkflowNamespaces.js +529 -596
  49. package/dist/contextClient.d.ts +9 -17
  50. package/dist/contextClient.js +92 -805
  51. package/dist/contextFacade.d.ts +11 -2
  52. package/dist/contextFacade.js +10 -81
  53. package/dist/contextPackCompiler.d.ts +10 -11
  54. package/dist/contextPackCompiler.js +494 -1040
  55. package/dist/contextPackPolicy.d.ts +14 -15
  56. package/dist/contextPackPolicy.js +227 -305
  57. package/dist/contextPackSchema.d.ts +3 -3
  58. package/dist/contextPackSchema.js +169 -176
  59. package/dist/contextTypes.d.ts +14 -15
  60. package/dist/contextTypes.js +1 -2
  61. package/dist/contracts/api-enums.contract.d.ts +29 -30
  62. package/dist/contracts/api-enums.contract.js +162 -88
  63. package/dist/contracts/auth-session.contract.d.ts +13 -14
  64. package/dist/contracts/auth-session.contract.js +55 -52
  65. package/dist/contracts/context-pack.contract.d.ts +54 -55
  66. package/dist/contracts/context-pack.contract.js +160 -88
  67. package/dist/contracts/contextPack.d.ts +2 -1
  68. package/dist/contracts/contextPack.js +1 -97
  69. package/dist/contracts/index.d.ts +11 -12
  70. package/dist/contracts/index.js +10 -854
  71. package/dist/contracts/lens-filter.contract.d.ts +9 -10
  72. package/dist/contracts/lens-filter.contract.js +82 -58
  73. package/dist/contracts/lens-workflow.contract.d.ts +21 -23
  74. package/dist/contracts/lens-workflow.contract.js +48 -117
  75. package/dist/contracts/lensFilter.d.ts +2 -1
  76. package/dist/contracts/lensFilter.js +1 -71
  77. package/dist/contracts/lensWorkflow.d.ts +2 -2
  78. package/dist/contracts/lensWorkflow.js +1 -123
  79. package/dist/contracts/mcpTools.d.ts +16 -18
  80. package/dist/contracts/mcpTools.js +89 -123
  81. package/dist/contracts/prompt.contract.d.ts +4 -5
  82. package/dist/contracts/prompt.contract.js +23 -10
  83. package/dist/contracts/prompt.d.ts +2 -1
  84. package/dist/contracts/prompt.js +1 -11
  85. package/dist/contracts/sdk-tools.contract.d.ts +2 -1
  86. package/dist/contracts/sdk-tools.contract.js +1 -2
  87. package/dist/contracts/sdkTools.d.ts +2 -1
  88. package/dist/contracts/sdkTools.js +1 -26
  89. package/dist/contracts/tool-contracts.d.ts +2 -1
  90. package/dist/contracts/tool-contracts.js +1 -2
  91. package/dist/contracts/workflow-runtime.contract.d.ts +45 -46
  92. package/dist/contracts/workflow-runtime.contract.js +241 -228
  93. package/dist/contracts/workflowRuntime.d.ts +2 -1
  94. package/dist/contracts/workflowRuntime.js +1 -244
  95. package/dist/contradictions/index.d.ts +8 -60
  96. package/dist/contradictions/index.js +11 -10175
  97. package/dist/control-plane.d.ts +17 -24
  98. package/dist/control-plane.js +124 -840
  99. package/dist/controlObjectOwnership.d.ts +19 -20
  100. package/dist/controlObjectOwnership.js +207 -201
  101. package/dist/coreClient.d.ts +23 -28
  102. package/dist/coreClient.js +567 -692
  103. package/dist/customTools.d.ts +17 -21
  104. package/dist/customTools.js +221 -221
  105. package/dist/decisions/index.d.ts +7 -58
  106. package/dist/decisions/index.js +14 -10177
  107. package/dist/decisionsClient.d.ts +25 -32
  108. package/dist/decisionsClient.js +113 -913
  109. package/dist/domainContext.d.ts +2 -1
  110. package/dist/domainContext.js +1 -2
  111. package/dist/edges/index.d.ts +21 -73
  112. package/dist/edges/index.js +12 -10176
  113. package/dist/embeddingsClient.d.ts +22 -30
  114. package/dist/embeddingsClient.js +73 -922
  115. package/dist/eventingClient.d.ts +23 -31
  116. package/dist/eventingClient.js +89 -918
  117. package/dist/events.d.ts +48 -49
  118. package/dist/events.js +257 -241
  119. package/dist/eventsCore.d.ts +20 -29
  120. package/dist/eventsCore.js +86 -830
  121. package/dist/evidence/index.d.ts +9 -60
  122. package/dist/evidence/index.js +13 -10176
  123. package/dist/evidenceClient.d.ts +13 -22
  124. package/dist/evidenceClient.js +34 -751
  125. package/dist/facade/context.d.ts +7 -8
  126. package/dist/facade/context.js +73 -72
  127. package/dist/functionSurface.d.ts +2 -156
  128. package/dist/functionSurface.js +1 -1460
  129. package/dist/functionSurfaceClient.d.ts +2 -9
  130. package/dist/functionSurfaceClient.js +1 -1460
  131. package/dist/gatewayFacades.d.ts +79 -296
  132. package/dist/gatewayFacades.factories.d.ts +209 -14
  133. package/dist/gatewayFacades.factories.js +561 -2227
  134. package/dist/gatewayFacades.js +284 -2627
  135. package/dist/generated/functionSurface.d.ts +149 -0
  136. package/dist/generated/functionSurface.js +749 -0
  137. package/dist/graphAnalysisClient.d.ts +41 -49
  138. package/dist/graphAnalysisClient.js +185 -974
  139. package/dist/graphClient.d.ts +53 -60
  140. package/dist/graphClient.js +219 -1090
  141. package/dist/graphIntel.d.ts +2 -4
  142. package/dist/graphIntel.js +1 -2
  143. package/dist/graphIntelligence.d.ts +4 -2
  144. package/dist/graphIntelligence.js +2 -46
  145. package/dist/graphRecommendationsClient.d.ts +15 -23
  146. package/dist/graphRecommendationsClient.js +70 -849
  147. package/dist/graphStateClassifierClient.d.ts +17 -25
  148. package/dist/graphStateClassifierClient.js +67 -908
  149. package/dist/harnessClient.d.ts +40 -47
  150. package/dist/harnessClient.js +198 -993
  151. package/dist/identityClient.d.ts +25 -33
  152. package/dist/identityClient.js +245 -1186
  153. package/dist/index.d.ts +73 -69
  154. package/dist/index.js +72 -13313
  155. package/dist/infisicalRuntime.d.ts +12 -14
  156. package/dist/infisicalRuntime.js +290 -297
  157. package/dist/jobsClient.d.ts +24 -32
  158. package/dist/jobsClient.js +101 -916
  159. package/dist/learningClient.d.ts +8 -16
  160. package/dist/learningClient.js +45 -809
  161. package/dist/lenses/index.d.ts +13 -65
  162. package/dist/lenses/index.js +11 -10175
  163. package/dist/mcpClient.d.ts +14 -23
  164. package/dist/mcpClient.js +115 -856
  165. package/dist/modelRuntimeClient.d.ts +18 -26
  166. package/dist/modelRuntimeClient.js +74 -894
  167. package/dist/nodes/index.d.ts +7 -58
  168. package/dist/nodes/index.js +14 -10177
  169. package/dist/ontologies/index.d.ts +21 -73
  170. package/dist/ontologies/index.js +14 -10178
  171. package/dist/ontologyClient.d.ts +23 -31
  172. package/dist/ontologyClient.js +138 -924
  173. package/dist/ontologyLinksClient.d.ts +16 -24
  174. package/dist/ontologyLinksClient.js +76 -886
  175. package/dist/opinion.d.ts +5 -6
  176. package/dist/opinion.js +21 -25
  177. package/dist/orgGraphSearchClient.d.ts +19 -27
  178. package/dist/orgGraphSearchClient.js +89 -857
  179. package/dist/packRuntime.d.ts +2 -2
  180. package/dist/packRuntime.js +1 -2
  181. package/dist/packsClient.d.ts +30 -37
  182. package/dist/packsClient.js +131 -906
  183. package/dist/policyClient.d.ts +21 -29
  184. package/dist/policyClient.js +267 -1026
  185. package/dist/proof-attestation.json +1 -1
  186. package/dist/questions/index.d.ts +9 -60
  187. package/dist/questions/index.js +15 -10178
  188. package/dist/realtime/index.d.ts +20 -16
  189. package/dist/realtime/index.js +30 -19
  190. package/dist/realtime/refs.d.ts +4 -6
  191. package/dist/realtime/refs.js +12 -7
  192. package/dist/realtime-refs.d.ts +1 -0
  193. package/dist/realtime-refs.js +1 -0
  194. package/dist/realtime.d.ts +1 -0
  195. package/dist/realtime.js +1 -0
  196. package/dist/reportsClient.d.ts +10 -19
  197. package/dist/reportsClient.js +48 -836
  198. package/dist/schemaClient.d.ts +16 -23
  199. package/dist/schemaClient.js +62 -832
  200. package/dist/sdkSurface.d.ts +18 -25
  201. package/dist/sdkSurface.js +135 -106
  202. package/dist/secrets.d.ts +2 -1
  203. package/dist/secrets.js +1 -2
  204. package/dist/sourcesClient.d.ts +11 -18
  205. package/dist/sourcesClient.js +18 -741
  206. package/dist/telemetryClient.d.ts +22 -30
  207. package/dist/telemetryClient.js +107 -931
  208. package/dist/toolRegistryClient.d.ts +27 -35
  209. package/dist/toolRegistryClient.js +116 -954
  210. package/dist/topics/index.d.ts +13 -64
  211. package/dist/topics/index.js +15 -10178
  212. package/dist/topicsClient.d.ts +19 -27
  213. package/dist/topicsClient.js +106 -894
  214. package/dist/types.d.ts +84 -87
  215. package/dist/types.js +1 -2
  216. package/dist/version.d.ts +2 -3
  217. package/dist/version.js +2 -5
  218. package/dist/workflowClient.d.ts +60 -65
  219. package/dist/workflowClient.js +343 -1219
  220. package/dist/worktrees/index.d.ts +16 -68
  221. package/dist/worktrees/index.js +14 -10178
  222. package/package.json +6 -6
  223. package/dist/accessControl.js.map +0 -1
  224. package/dist/adminClient.js.map +0 -1
  225. package/dist/answersClient.js.map +0 -1
  226. package/dist/audience/index.js.map +0 -1
  227. package/dist/audiencesClient.js.map +0 -1
  228. package/dist/auditClient.js.map +0 -1
  229. package/dist/authContext.js.map +0 -1
  230. package/dist/authDeviceClient.js.map +0 -1
  231. package/dist/beliefs/index.js.map +0 -1
  232. package/dist/beliefs/lifecycle.js.map +0 -1
  233. package/dist/beliefsClient.js.map +0 -1
  234. package/dist/boundaryClientSurface.js.map +0 -1
  235. package/dist/client.js.map +0 -1
  236. package/dist/clientAssemblyTypes.js.map +0 -1
  237. package/dist/clientConfig.js.map +0 -1
  238. package/dist/clientEvidenceCompat.js.map +0 -1
  239. package/dist/clientGraphNamespaces.js.map +0 -1
  240. package/dist/clientHelpers.js.map +0 -1
  241. package/dist/clientKnowledgeNamespaces.js.map +0 -1
  242. package/dist/clientLocalHelpers.js.map +0 -1
  243. package/dist/clientPlatformNamespaces.js.map +0 -1
  244. package/dist/clientRuntime.js.map +0 -1
  245. package/dist/clientWorkflowNamespaces.js.map +0 -1
  246. package/dist/contextClient.js.map +0 -1
  247. package/dist/contextFacade.js.map +0 -1
  248. package/dist/contextPackCompiler.js.map +0 -1
  249. package/dist/contextPackPolicy.js.map +0 -1
  250. package/dist/contextPackSchema.js.map +0 -1
  251. package/dist/contextTypes.js.map +0 -1
  252. package/dist/contracts/api-enums.contract.js.map +0 -1
  253. package/dist/contracts/auth-session.contract.js.map +0 -1
  254. package/dist/contracts/context-pack.contract.js.map +0 -1
  255. package/dist/contracts/contextPack.js.map +0 -1
  256. package/dist/contracts/index.js.map +0 -1
  257. package/dist/contracts/lens-filter.contract.js.map +0 -1
  258. package/dist/contracts/lens-workflow.contract.js.map +0 -1
  259. package/dist/contracts/lensFilter.js.map +0 -1
  260. package/dist/contracts/lensWorkflow.js.map +0 -1
  261. package/dist/contracts/mcpTools.js.map +0 -1
  262. package/dist/contracts/prompt.contract.js.map +0 -1
  263. package/dist/contracts/prompt.js.map +0 -1
  264. package/dist/contracts/sdk-tools.contract.js.map +0 -1
  265. package/dist/contracts/sdkTools.js.map +0 -1
  266. package/dist/contracts/tool-contracts.js.map +0 -1
  267. package/dist/contracts/workflow-runtime.contract.js.map +0 -1
  268. package/dist/contracts/workflowRuntime.js.map +0 -1
  269. package/dist/contradictions/index.js.map +0 -1
  270. package/dist/control-plane.js.map +0 -1
  271. package/dist/controlObjectOwnership.js.map +0 -1
  272. package/dist/coreClient.js.map +0 -1
  273. package/dist/customTools.js.map +0 -1
  274. package/dist/decisions/index.js.map +0 -1
  275. package/dist/decisionsClient.js.map +0 -1
  276. package/dist/domainContext.js.map +0 -1
  277. package/dist/edges/index.js.map +0 -1
  278. package/dist/embeddingsClient.js.map +0 -1
  279. package/dist/eventingClient.js.map +0 -1
  280. package/dist/events.js.map +0 -1
  281. package/dist/eventsCore.js.map +0 -1
  282. package/dist/evidence/index.js.map +0 -1
  283. package/dist/evidenceClient.js.map +0 -1
  284. package/dist/facade/context.js.map +0 -1
  285. package/dist/functionSurface.js.map +0 -1
  286. package/dist/functionSurfaceClient.js.map +0 -1
  287. package/dist/gatewayFacades.factories.js.map +0 -1
  288. package/dist/gatewayFacades.js.map +0 -1
  289. package/dist/graphAnalysisClient.js.map +0 -1
  290. package/dist/graphClient.js.map +0 -1
  291. package/dist/graphIntel.js.map +0 -1
  292. package/dist/graphIntelligence.js.map +0 -1
  293. package/dist/graphRecommendationsClient.js.map +0 -1
  294. package/dist/graphStateClassifierClient.js.map +0 -1
  295. package/dist/harnessClient.js.map +0 -1
  296. package/dist/identityClient.js.map +0 -1
  297. package/dist/index.js.map +0 -1
  298. package/dist/infisicalRuntime.js.map +0 -1
  299. package/dist/jobsClient.js.map +0 -1
  300. package/dist/learningClient.js.map +0 -1
  301. package/dist/lenses/index.js.map +0 -1
  302. package/dist/mcpClient.js.map +0 -1
  303. package/dist/modelRuntimeClient.js.map +0 -1
  304. package/dist/nodes/index.js.map +0 -1
  305. package/dist/ontologies/index.js.map +0 -1
  306. package/dist/ontologyClient.js.map +0 -1
  307. package/dist/ontologyLinksClient.js.map +0 -1
  308. package/dist/opinion.js.map +0 -1
  309. package/dist/orgGraphSearchClient.js.map +0 -1
  310. package/dist/packRuntime.js.map +0 -1
  311. package/dist/packsClient.js.map +0 -1
  312. package/dist/policyClient.js.map +0 -1
  313. package/dist/questions/index.js.map +0 -1
  314. package/dist/realtime/index.js.map +0 -1
  315. package/dist/realtime/refs.js.map +0 -1
  316. package/dist/reportsClient.js.map +0 -1
  317. package/dist/schemaClient.js.map +0 -1
  318. package/dist/sdk-tools.contract-B4c1Zr1o.d.ts +0 -22
  319. package/dist/sdkSurface.js.map +0 -1
  320. package/dist/secrets.js.map +0 -1
  321. package/dist/sourcesClient.js.map +0 -1
  322. package/dist/telemetryClient.js.map +0 -1
  323. package/dist/tool-contracts-BUiL9P6z.d.ts +0 -22
  324. package/dist/toolRegistryClient.js.map +0 -1
  325. package/dist/topics/index.js.map +0 -1
  326. package/dist/topicsClient.js.map +0 -1
  327. package/dist/types.js.map +0 -1
  328. package/dist/version.js.map +0 -1
  329. package/dist/workflowClient.js.map +0 -1
  330. package/dist/worktrees/index.js.map +0 -1
@@ -1,747 +1,622 @@
1
- import { createTelemetryExporterFromEnv, emitTelemetrySignal } from '@lucern/transport-core';
2
- import { redactDiagnosticValue } from '@lucern/transport-core/redaction';
3
- import { classifyRetry } from '@lucern/transport-core/transport';
4
- import { Effect, Exit, Cause } from 'effect';
5
-
6
- // src/coreClient.ts
7
-
8
- // src/authContext.ts
9
- var LucernSdkAuthContextError = class extends Error {
10
- reason;
11
- constructor(reason, message) {
12
- super(message);
13
- this.name = "LucernSdkAuthContextError";
14
- this.reason = reason;
15
- }
16
- };
17
- function cleanString(value) {
18
- const normalized = value?.trim();
19
- return normalized ? normalized : void 0;
20
- }
21
- function cleanStringList(values) {
22
- if (!values) {
23
- return [];
24
- }
25
- return values.map((value) => value.trim()).filter(
26
- (value, index, list) => value.length > 0 && list.indexOf(value) === index
27
- );
28
- }
29
- function requireString(value, reason, label) {
30
- const normalized = cleanString(value);
31
- if (!normalized) {
32
- throw new LucernSdkAuthContextError(
33
- reason,
34
- `Canonical Lucern SDK auth context is missing ${label}.`
35
- );
36
- }
37
- return normalized;
38
- }
39
- function requirePrincipalType(principalType) {
40
- if (!principalType) {
41
- throw new LucernSdkAuthContextError(
42
- "principal_missing",
43
- "Canonical Lucern SDK auth context is missing principalType."
44
- );
45
- }
46
- return principalType;
47
- }
48
- function requireAuthMode(authMode) {
49
- if (!authMode) {
50
- throw new LucernSdkAuthContextError(
51
- "principal_missing",
52
- "Canonical Lucern SDK auth context is missing authMode."
53
- );
54
- }
55
- return authMode;
56
- }
57
- function ensurePermitMatch(args) {
58
- const actual = cleanString(args.actual);
59
- if (actual && actual !== args.expected) {
60
- throw new LucernSdkAuthContextError(
61
- "policy_denied",
62
- `Canonical Lucern SDK auth context has conflicting Permit ${args.field}.`
63
- );
64
- }
65
- }
66
- function normalizeCanonicalLucernAuthContext(input) {
67
- if (!input) {
68
- throw new LucernSdkAuthContextError(
69
- "principal_missing",
70
- "Canonical Lucern SDK auth context is required."
71
- );
72
- }
73
- if (input.policyDecision === "deny") {
74
- throw new LucernSdkAuthContextError(
75
- "policy_denied",
76
- "Canonical Lucern SDK auth context carries a denied policy decision."
77
- );
78
- }
79
- const principalId = requireString(
80
- input.principalId,
81
- "principal_missing",
82
- "principalId"
83
- );
84
- const tenantId = requireString(input.tenantId, "tenant_missing", "tenantId");
85
- const workspaceId = requireString(
86
- input.workspaceId,
87
- "workspace_missing",
88
- "workspaceId"
89
- );
90
- const roles = cleanStringList(input.roles);
91
- const scopes = cleanStringList(input.scopes);
92
- const principalType = requirePrincipalType(input.principalType);
93
- const authMode = requireAuthMode(input.authMode);
94
- const roleBasedInteractiveAuth = authMode === "interactive_user" && roles.length > 0;
95
- if (roles.length === 0 || scopes.length === 0 && !roleBasedInteractiveAuth) {
96
- throw new LucernSdkAuthContextError(
97
- "membership_missing",
98
- "Canonical Lucern SDK auth context requires non-empty roles and scopes."
99
- );
100
- }
101
- const subject = cleanString(input.permit?.subject) ?? principalId;
102
- const tenant = cleanString(input.permit?.tenant) ?? tenantId;
103
- const workspace = cleanString(input.permit?.workspace) ?? workspaceId;
104
- ensurePermitMatch({
105
- field: "subject",
106
- expected: principalId,
107
- actual: subject
108
- });
109
- ensurePermitMatch({ field: "tenant", expected: tenantId, actual: tenant });
110
- ensurePermitMatch({
111
- field: "workspace",
112
- expected: workspaceId,
113
- actual: workspace
114
- });
115
- const context = input.permit?.context ? { ...input.permit.context } : void 0;
116
- return {
117
- clerkId: cleanString(input.clerkId),
118
- principalId,
119
- tenantId,
120
- workspaceId,
121
- principalType,
122
- authMode,
123
- roles,
124
- scopes,
125
- delegationChain: input.delegationChain ? [...input.delegationChain] : [],
126
- policyTraceId: cleanString(input.policyTraceId),
127
- correlationId: cleanString(input.correlationId),
128
- membershipId: cleanString(input.membershipId),
129
- permit: {
130
- subject,
131
- tenant,
132
- workspace,
133
- resource: cleanString(input.permit?.resource),
134
- action: cleanString(input.permit?.action),
135
- relation: cleanString(input.permit?.relation),
136
- context
137
- }
138
- };
139
- }
140
- function createCanonicalAuthHeaders(authContext) {
141
- const headers = {
142
- "x-lucern-principal-id": authContext.principalId,
143
- "x-lucern-principal-type": authContext.principalType,
144
- "x-lucern-tenant": authContext.tenantId,
145
- "x-lucern-tenant-id": authContext.tenantId,
146
- "x-lucern-workspace": authContext.workspaceId,
147
- "x-lucern-workspace-id": authContext.workspaceId,
148
- "x-lucern-auth-mode": authContext.authMode,
149
- "x-lucern-roles": authContext.roles.join(","),
150
- "x-lucern-scopes": authContext.scopes.join(","),
151
- "x-lucern-permit-context": JSON.stringify(authContext.permit)
152
- };
153
- if (authContext.clerkId) {
154
- headers["x-lucern-clerk-id"] = authContext.clerkId;
155
- headers["x-lucern-user-id"] = authContext.clerkId;
156
- }
157
- if (authContext.delegationChain.length > 0) {
158
- headers["x-lucern-delegation-chain"] = JSON.stringify(
159
- authContext.delegationChain
160
- );
161
- }
162
- if (authContext.policyTraceId) {
163
- headers["x-lucern-policy-trace-id"] = authContext.policyTraceId;
164
- }
165
- if (authContext.correlationId) {
166
- headers["x-correlation-id"] = authContext.correlationId;
167
- headers["x-lucern-correlation-id"] = authContext.correlationId;
168
- }
169
- if (authContext.membershipId) {
170
- headers["x-lucern-membership-id"] = authContext.membershipId;
171
- }
172
- return headers;
1
+ import { createTelemetryExporterFromEnv, emitTelemetrySignal, } from "@lucern/transport-core";
2
+ import { redactDiagnosticValue } from "@lucern/transport-core/redaction";
3
+ import { classifyRetry } from "@lucern/transport-core/transport";
4
+ import { Cause, Effect, Exit } from "effect";
5
+ import { createCanonicalAuthHeaders, LucernSdkAuthContextError, normalizeCanonicalLucernAuthContext, } from "./authContext.js";
6
+ const DEFAULT_GATEWAY_TIMEOUT_MS = 15_000;
7
+ const DEFAULT_GATEWAY_MAX_RETRIES = 2;
8
+ const DEFAULT_ENV_TIMEOUT_MS = "LUCERN_REQUEST_TIMEOUT_MS";
9
+ const DEFAULT_ENV_MAX_RETRIES = "LUCERN_GATEWAY_MAX_RETRIES";
10
+ const ENV_TIMEOUT_BY_METHOD_PREFIX = "LUCERN_REQUEST_TIMEOUT_MS_";
11
+ export class GatewayTimeoutError extends Error {
12
+ retryable = true;
13
+ timeoutMs;
14
+ constructor(timeoutMs) {
15
+ super(`Request timed out after ${timeoutMs}ms`);
16
+ this.name = "AbortError";
17
+ this.timeoutMs = timeoutMs;
18
+ }
173
19
  }
174
-
175
- // src/coreClient.ts
176
- var DEFAULT_GATEWAY_TIMEOUT_MS = 15e3;
177
- var DEFAULT_GATEWAY_MAX_RETRIES = 2;
178
- var DEFAULT_ENV_TIMEOUT_MS = "LUCERN_REQUEST_TIMEOUT_MS";
179
- var DEFAULT_ENV_MAX_RETRIES = "LUCERN_GATEWAY_MAX_RETRIES";
180
- var ENV_TIMEOUT_BY_METHOD_PREFIX = "LUCERN_REQUEST_TIMEOUT_MS_";
181
- var GatewayTimeoutError = class extends Error {
182
- retryable = true;
183
- timeoutMs;
184
- constructor(timeoutMs) {
185
- super(`Request timed out after ${timeoutMs}ms`);
186
- this.name = "AbortError";
187
- this.timeoutMs = timeoutMs;
188
- }
189
- };
190
- var GatewayTransportError = class extends Error {
191
- retryable;
192
- cause;
193
- constructor(message, options) {
194
- super(message);
195
- this.name = "GatewayTransportError";
196
- this.retryable = options?.retryable ?? true;
197
- this.cause = options?.cause;
198
- }
199
- };
200
- function isGatewayRecoverableError(error) {
201
- return error instanceof GatewayTimeoutError || error instanceof GatewayTransportError;
20
+ export class GatewayTransportError extends Error {
21
+ retryable;
22
+ cause;
23
+ constructor(message, options) {
24
+ super(message);
25
+ this.name = "GatewayTransportError";
26
+ this.retryable = options?.retryable ?? true;
27
+ this.cause = options?.cause;
28
+ }
202
29
  }
203
- function isGatewayRetryableError(error) {
204
- return error instanceof GatewayTimeoutError && error.retryable || error instanceof GatewayTransportError && error.retryable || false;
30
+ export function isGatewayRecoverableError(error) {
31
+ return error instanceof GatewayTimeoutError || error instanceof GatewayTransportError;
32
+ }
33
+ export function isGatewayRetryableError(error) {
34
+ return ((error instanceof GatewayTimeoutError && error.retryable) ||
35
+ (error instanceof GatewayTransportError && error.retryable) ||
36
+ false);
37
+ }
38
+ /**
39
+ * Structured error thrown when a platform API request fails.
40
+ *
41
+ * Includes HTTP status, machine-readable error code, optional invariant
42
+ * reference, and actionable suggestions for common failure modes.
43
+ */
44
+ export class LucernApiError extends Error {
45
+ code;
46
+ status;
47
+ invariant;
48
+ suggestion;
49
+ details;
50
+ requestId;
51
+ correlationId;
52
+ policyTraceId;
53
+ constructor(args) {
54
+ super(args.message);
55
+ this.name = "LucernApiError";
56
+ this.code = args.code;
57
+ this.status = args.status;
58
+ this.invariant = args.invariant;
59
+ this.suggestion = args.suggestion;
60
+ this.details = args.details;
61
+ this.requestId = args.requestId;
62
+ this.correlationId = args.correlationId;
63
+ this.policyTraceId = args.policyTraceId;
64
+ }
205
65
  }
206
- var LucernApiError = class extends Error {
207
- code;
208
- status;
209
- invariant;
210
- suggestion;
211
- details;
212
- requestId;
213
- correlationId;
214
- policyTraceId;
215
- constructor(args) {
216
- super(args.message);
217
- this.name = "LucernApiError";
218
- this.code = args.code;
219
- this.status = args.status;
220
- this.invariant = args.invariant;
221
- this.suggestion = args.suggestion;
222
- this.details = args.details;
223
- this.requestId = args.requestId;
224
- this.correlationId = args.correlationId;
225
- this.policyTraceId = args.policyTraceId;
226
- }
227
- };
228
- function toQueryString(scope) {
229
- const params = new URLSearchParams();
230
- if (scope.tenantId) {
231
- params.set("tenantId", scope.tenantId);
232
- }
233
- if (scope.workspaceId) {
234
- params.set("workspaceId", scope.workspaceId);
235
- }
236
- for (const [key, value] of Object.entries(scope)) {
237
- if (key === "tenantId" || key === "workspaceId") {
238
- continue;
239
- }
240
- if (value === void 0) {
241
- continue;
242
- }
243
- params.set(key, String(value));
244
- }
245
- const serialized = params.toString();
246
- return serialized.length > 0 ? `?${serialized}` : "";
66
+ /**
67
+ * Serialize a gateway query object into a URL query string.
68
+ */
69
+ export function toQueryString(scope) {
70
+ const params = new URLSearchParams();
71
+ if (scope.tenantId) {
72
+ params.set("tenantId", scope.tenantId);
73
+ }
74
+ if (scope.workspaceId) {
75
+ params.set("workspaceId", scope.workspaceId);
76
+ }
77
+ for (const [key, value] of Object.entries(scope)) {
78
+ if (key === "tenantId" || key === "workspaceId") {
79
+ continue;
80
+ }
81
+ if (value === undefined) {
82
+ continue;
83
+ }
84
+ params.set(key, String(value));
85
+ }
86
+ const serialized = params.toString();
87
+ return serialized.length > 0 ? `?${serialized}` : "";
247
88
  }
248
89
  function fillRandomBytes(length) {
249
- const bytes = new Uint8Array(length);
250
- if (typeof globalThis.crypto?.getRandomValues === "function") {
251
- globalThis.crypto.getRandomValues(bytes);
90
+ const bytes = new Uint8Array(length);
91
+ if (typeof globalThis.crypto?.getRandomValues === "function") {
92
+ globalThis.crypto.getRandomValues(bytes);
93
+ return bytes;
94
+ }
95
+ for (let index = 0; index < length; index += 1) {
96
+ bytes[index] = Math.floor(Math.random() * 256);
97
+ }
252
98
  return bytes;
253
- }
254
- for (let index = 0; index < length; index += 1) {
255
- bytes[index] = Math.floor(Math.random() * 256);
256
- }
257
- return bytes;
258
99
  }
259
100
  function generatePortableRequestId() {
260
- if (typeof globalThis.crypto?.randomUUID === "function") {
261
- return globalThis.crypto.randomUUID();
262
- }
263
- const bytes = fillRandomBytes(16);
264
- bytes[6] = bytes[6] & 15 | 64;
265
- bytes[8] = bytes[8] & 63 | 128;
266
- const hex = Array.from(bytes, (value) => value.toString(16).padStart(2, "0"));
267
- return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(
268
- 6,
269
- 8
270
- ).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
101
+ if (typeof globalThis.crypto?.randomUUID === "function") {
102
+ return globalThis.crypto.randomUUID();
103
+ }
104
+ const bytes = fillRandomBytes(16);
105
+ bytes[6] = (bytes[6] & 0x0f) | 0x40;
106
+ bytes[8] = (bytes[8] & 0x3f) | 0x80;
107
+ const hex = Array.from(bytes, (value) => value.toString(16).padStart(2, "0"));
108
+ return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
271
109
  }
272
110
  function resolveEnvironment() {
273
- const processEnv = typeof globalThis === "object" && globalThis !== null && "process" in globalThis ? globalThis.process : void 0;
274
- const env = processEnv !== void 0 && typeof processEnv === "object" && processEnv !== null && typeof processEnv.env === "object" ? processEnv.env : void 0;
275
- return {
276
- get: (name) => {
277
- const value = env?.[name];
278
- return typeof value === "string" && value.length > 0 ? value : void 0;
279
- }
280
- };
111
+ const processEnv = typeof globalThis === "object" &&
112
+ globalThis !== null &&
113
+ "process" in globalThis
114
+ ? globalThis.process
115
+ : undefined;
116
+ const env = processEnv !== undefined &&
117
+ typeof processEnv === "object" &&
118
+ processEnv !== null &&
119
+ typeof processEnv.env === "object"
120
+ ? processEnv.env
121
+ : undefined;
122
+ return {
123
+ get: (name) => {
124
+ const value = env?.[name];
125
+ return typeof value === "string" && value.length > 0 ? value : undefined;
126
+ },
127
+ };
281
128
  }
282
129
  function telemetryEnvironmentRecord(environment) {
283
- const names = [
284
- "LUCERN_TELEMETRY_ENABLED",
285
- "AXIOM_TELEMETRY_ENABLED",
286
- "LUCERN_AXIOM_TOKEN",
287
- "AXIOM_TOKEN",
288
- "LUCERN_AXIOM_EVENTS_DATASET",
289
- "LUCERN_AXIOM_DATASET",
290
- "AXIOM_EVENTS_DATASET",
291
- "AXIOM_DATASET",
292
- "LUCERN_AXIOM_API_URL",
293
- "AXIOM_URL",
294
- "LUCERN_ENVIRONMENT",
295
- "NODE_ENV",
296
- "LUCERN_RELEASE",
297
- "SENTRY_RELEASE",
298
- "VERCEL_GIT_COMMIT_SHA"
299
- ];
300
- return Object.fromEntries(
301
- names.map((name) => [name, environment.get(name)])
302
- );
130
+ const names = [
131
+ "LUCERN_TELEMETRY_ENABLED",
132
+ "AXIOM_TELEMETRY_ENABLED",
133
+ "LUCERN_AXIOM_TOKEN",
134
+ "AXIOM_TOKEN",
135
+ "LUCERN_AXIOM_EVENTS_DATASET",
136
+ "LUCERN_AXIOM_DATASET",
137
+ "AXIOM_EVENTS_DATASET",
138
+ "AXIOM_DATASET",
139
+ "LUCERN_AXIOM_API_URL",
140
+ "AXIOM_URL",
141
+ "LUCERN_ENVIRONMENT",
142
+ "NODE_ENV",
143
+ "LUCERN_RELEASE",
144
+ "SENTRY_RELEASE",
145
+ "VERCEL_GIT_COMMIT_SHA",
146
+ ];
147
+ return Object.fromEntries(names.map((name) => [name, environment.get(name)]));
303
148
  }
304
149
  function resolveRequestProfile(config, environment) {
305
- const requestIdFactory = config.requestIdFactory ?? (() => generatePortableRequestId());
306
- const parsedMaxRetries = parseIntegerFromString(
307
- config.maxRetries,
308
- environment.get(DEFAULT_ENV_MAX_RETRIES)
309
- );
310
- const parsedTimeoutMs = parseIntegerFromString(
311
- config.timeoutMs,
312
- environment.get(DEFAULT_ENV_TIMEOUT_MS)
313
- );
314
- const methodTimeouts = {
315
- ...config.timeoutMsByMethod
316
- };
317
- for (const method of ["GET", "POST", "PUT", "PATCH", "DELETE"]) {
318
- const envKey = `${ENV_TIMEOUT_BY_METHOD_PREFIX}${method}`;
319
- const raw = environment.get(envKey);
320
- if (!raw || methodTimeouts[method] !== void 0) {
321
- continue;
322
- }
323
- const parsed = parseIntegerFromString(void 0, raw);
324
- if (typeof parsed === "number") {
325
- methodTimeouts[method] = parsed;
326
- }
327
- }
328
- return {
329
- maxRetries: parsedMaxRetries ?? DEFAULT_GATEWAY_MAX_RETRIES,
330
- timeoutMs: parsedTimeoutMs ?? DEFAULT_GATEWAY_TIMEOUT_MS,
331
- timeoutMsByMethod: methodTimeouts,
332
- requestIdFactory
333
- };
150
+ const requestIdFactory = config.requestIdFactory ?? (() => generatePortableRequestId());
151
+ const parsedMaxRetries = parseIntegerFromString(config.maxRetries, environment.get(DEFAULT_ENV_MAX_RETRIES));
152
+ const parsedTimeoutMs = parseIntegerFromString(config.timeoutMs, environment.get(DEFAULT_ENV_TIMEOUT_MS));
153
+ const methodTimeouts = {
154
+ ...config.timeoutMsByMethod,
155
+ };
156
+ for (const method of ["GET", "POST", "PUT", "PATCH", "DELETE"]) {
157
+ const envKey = `${ENV_TIMEOUT_BY_METHOD_PREFIX}${method}`;
158
+ const raw = environment.get(envKey);
159
+ if (!raw || methodTimeouts[method] !== undefined) {
160
+ continue;
161
+ }
162
+ const parsed = parseIntegerFromString(undefined, raw);
163
+ if (typeof parsed === "number") {
164
+ methodTimeouts[method] = parsed;
165
+ }
166
+ }
167
+ return {
168
+ maxRetries: parsedMaxRetries ?? DEFAULT_GATEWAY_MAX_RETRIES,
169
+ timeoutMs: parsedTimeoutMs ?? DEFAULT_GATEWAY_TIMEOUT_MS,
170
+ timeoutMsByMethod: methodTimeouts,
171
+ requestIdFactory,
172
+ };
334
173
  }
335
174
  function createGatewayRuntime(config, environment) {
336
- return {
337
- fetch: config.fetchImpl ?? fetch,
338
- now: () => Date.now(),
339
- sleep: (ms) => delay(ms),
340
- env: environment,
341
- redaction: resolveRequestRedactionValue,
342
- profile: resolveRequestProfile(config, environment)
343
- };
175
+ return {
176
+ fetch: config.fetchImpl ?? fetch,
177
+ now: () => Date.now(),
178
+ sleep: (ms) => delay(ms),
179
+ env: environment,
180
+ redaction: resolveRequestRedactionValue,
181
+ profile: resolveRequestProfile(config, environment),
182
+ };
344
183
  }
345
184
  function parseIntegerFromString(value, rawValue) {
346
- if (typeof value === "number" && Number.isInteger(value) && value >= 0) {
347
- return value;
348
- }
349
- if (typeof rawValue !== "string" || !rawValue.trim()) {
350
- return void 0;
351
- }
352
- const parsed = Number.parseInt(rawValue, 10);
353
- return Number.isInteger(parsed) && parsed >= 0 ? parsed : void 0;
185
+ if (typeof value === "number" && Number.isInteger(value) && value >= 0) {
186
+ return value;
187
+ }
188
+ if (typeof rawValue !== "string" || !rawValue.trim()) {
189
+ return undefined;
190
+ }
191
+ const parsed = Number.parseInt(rawValue, 10);
192
+ return Number.isInteger(parsed) && parsed >= 0 ? parsed : undefined;
354
193
  }
355
194
  function resolveRequestRedactionValue(value) {
356
- return redactDiagnosticValue(value);
195
+ return redactDiagnosticValue(value);
357
196
  }
358
197
  function resolveGatewayBaseUrl(configBaseUrl, environment) {
359
- const envBaseUrl = environment.get("LUCERN_API_URL") ?? environment.get("LUCERN_BASE_URL") ?? environment.get("LUCERN_GATEWAY_BASE_URL");
360
- return (configBaseUrl ?? envBaseUrl ?? "").replace(/\/+$/, "");
198
+ const envBaseUrl = environment.get("LUCERN_API_URL") ??
199
+ environment.get("LUCERN_BASE_URL") ??
200
+ environment.get("LUCERN_GATEWAY_BASE_URL");
201
+ return (configBaseUrl ?? envBaseUrl ?? "").replace(/\/+$/, "");
361
202
  }
362
203
  function normalizeGatewayEnvironment(value) {
363
- return value === "sandbox" || value === "production" ? value : void 0;
204
+ return value === "sandbox" || value === "production" ? value : undefined;
364
205
  }
365
- var randomIdempotencyKey = generatePortableRequestId;
206
+ /**
207
+ * Generate a random idempotency key for retry-safe writes.
208
+ */
209
+ export const randomIdempotencyKey = generatePortableRequestId;
366
210
  function fallbackErrorCode(status) {
367
- if (status === 401) {
368
- return "AUTHENTICATION_REQUIRED";
369
- }
370
- if (status === 403) {
371
- return "FORBIDDEN";
372
- }
373
- if (status === 404) {
374
- return "NOT_FOUND";
375
- }
376
- if (status === 408) {
377
- return "UPSTREAM_ERROR";
378
- }
379
- if (status === 409) {
380
- return "CONFLICT";
381
- }
382
- if (status === 429) {
383
- return "RATE_LIMIT_EXCEEDED";
384
- }
385
- if (status >= 500) {
386
- return "UPSTREAM_ERROR";
387
- }
388
- return "INTERNAL_ERROR";
211
+ if (status === 401) {
212
+ return "AUTHENTICATION_REQUIRED";
213
+ }
214
+ if (status === 403) {
215
+ return "FORBIDDEN";
216
+ }
217
+ if (status === 404) {
218
+ return "NOT_FOUND";
219
+ }
220
+ if (status === 408) {
221
+ return "UPSTREAM_ERROR";
222
+ }
223
+ if (status === 409) {
224
+ return "CONFLICT";
225
+ }
226
+ if (status === 429) {
227
+ return "RATE_LIMIT_EXCEEDED";
228
+ }
229
+ if (status >= 500) {
230
+ return "UPSTREAM_ERROR";
231
+ }
232
+ return "INTERNAL_ERROR";
389
233
  }
390
234
  function delay(ms) {
391
- return new Promise((resolve) => setTimeout(resolve, ms));
235
+ return new Promise((resolve) => setTimeout(resolve, ms));
392
236
  }
393
237
  function computeRetryDelayMs(args) {
394
- const baseDelay = args.status === 429 ? Math.max(
395
- args.retryAfterMs ?? 0,
396
- Math.min(1e3 * 2 ** args.attempt, 1e4)
397
- ) : Math.min(1e3 * 2 ** args.attempt, 4e3);
398
- if (args.status !== 429) {
399
- return baseDelay;
400
- }
401
- const jitterWindow = Math.max(250, Math.round(baseDelay * 0.25));
402
- return baseDelay + Math.round(Math.random() * jitterWindow);
238
+ const baseDelay = args.status === 429
239
+ ? Math.max(args.retryAfterMs ?? 0, Math.min(1000 * 2 ** args.attempt, 10_000))
240
+ : Math.min(1000 * 2 ** args.attempt, 4000);
241
+ if (args.status !== 429) {
242
+ return baseDelay;
243
+ }
244
+ const jitterWindow = Math.max(250, Math.round(baseDelay * 0.25));
245
+ return baseDelay + Math.round(Math.random() * jitterWindow);
403
246
  }
404
247
  function classifyGatewayErrorForRetry(error) {
405
- return isGatewayRetryableError(error) || classifyRetry({ error }).retryable;
248
+ return isGatewayRetryableError(error) || classifyRetry({ error }).retryable;
406
249
  }
407
250
  function isRecord(value) {
408
- return value !== null && typeof value === "object" && !Array.isArray(value);
251
+ return value !== null && typeof value === "object" && !Array.isArray(value);
409
252
  }
410
253
  function readPolicySummaryFromDetails(details) {
411
- if (!isRecord(details)) {
412
- return null;
413
- }
414
- const directSummary = details.summary;
415
- if (typeof directSummary === "string" && directSummary.trim().length > 0) {
416
- return directSummary.trim();
417
- }
418
- const policy = details.policy;
419
- if (!isRecord(policy)) {
420
- return null;
421
- }
422
- const explanation = policy.explanation;
423
- if (!isRecord(explanation)) {
254
+ if (!isRecord(details)) {
255
+ return null;
256
+ }
257
+ const directSummary = details.summary;
258
+ if (typeof directSummary === "string" && directSummary.trim().length > 0) {
259
+ return directSummary.trim();
260
+ }
261
+ const policy = details.policy;
262
+ if (!isRecord(policy)) {
263
+ return null;
264
+ }
265
+ const explanation = policy.explanation;
266
+ if (!isRecord(explanation)) {
267
+ return null;
268
+ }
269
+ const nestedSummary = explanation.summary;
270
+ if (typeof nestedSummary === "string" && nestedSummary.trim().length > 0) {
271
+ return nestedSummary.trim();
272
+ }
424
273
  return null;
425
- }
426
- const nestedSummary = explanation.summary;
427
- if (typeof nestedSummary === "string" && nestedSummary.trim().length > 0) {
428
- return nestedSummary.trim();
429
- }
430
- return null;
431
274
  }
432
275
  function redactJsonDiagnosticValue(value) {
433
- return value === void 0 ? void 0 : redactDiagnosticValue(value);
276
+ return value === undefined
277
+ ? undefined
278
+ : redactDiagnosticValue(value);
434
279
  }
435
280
  async function resolveConfiguredAuthContext(authContext) {
436
- if (typeof authContext === "function") {
437
- return await authContext();
438
- }
439
- return authContext;
281
+ if (typeof authContext === "function") {
282
+ return await authContext();
283
+ }
284
+ return authContext;
440
285
  }
441
286
  function mergeHeaderRecord(base, addition) {
442
- const headers = new Headers(base);
443
- for (const [key, value] of Object.entries(addition)) {
444
- const existing = headers.get(key);
445
- if (existing !== null && existing !== value) {
446
- throw new LucernSdkAuthContextError(
447
- "policy_denied",
448
- `Canonical Lucern SDK auth context conflicts with existing ${key} header.`
449
- );
450
- }
451
- headers.set(key, value);
452
- }
453
- return Object.fromEntries(headers.entries());
287
+ const headers = new Headers(base);
288
+ for (const [key, value] of Object.entries(addition)) {
289
+ const existing = headers.get(key);
290
+ if (existing !== null && existing !== value) {
291
+ throw new LucernSdkAuthContextError("policy_denied", `Canonical Lucern SDK auth context conflicts with existing ${key} header.`);
292
+ }
293
+ headers.set(key, value);
294
+ }
295
+ return Object.fromEntries(headers.entries());
454
296
  }
455
297
  function cleanHeaderValue(value) {
456
- const normalized = value?.trim();
457
- return normalized ? normalized : void 0;
458
- }
459
- function createGatewayRequestClient(config = {}) {
460
- const env = resolveEnvironment();
461
- const runtime = createGatewayRuntime(config, env);
462
- const baseUrl = resolveGatewayBaseUrl(config.baseUrl, env);
463
- const maxRetries = runtime.profile.maxRetries;
464
- const requestIdFactory = runtime.profile.requestIdFactory;
465
- const requestTimeoutByMethod = runtime.profile.timeoutMsByMethod;
466
- const defaultRequestTimeoutMs = runtime.profile.timeoutMs;
467
- const normalizedEnvironment = normalizeGatewayEnvironment(config.environment);
468
- const telemetryExporter = config.telemetryEnabled === false ? null : config.telemetryExporter ?? createTelemetryExporterFromEnv(telemetryEnvironmentRecord(env), {
469
- service: "lucern-sdk",
470
- environment: normalizedEnvironment
471
- });
472
- async function resolveAuthHeaders() {
473
- const provided = config.getAuthHeaders ? await config.getAuthHeaders() : {};
474
- const headers = new Headers(provided);
475
- const setIfAbsent = (name, value) => {
476
- const normalized = cleanHeaderValue(value);
477
- if (normalized && !headers.has(name)) {
478
- headers.set(name, normalized);
479
- }
480
- };
481
- setIfAbsent("x-lucern-key", config.apiKey);
482
- setIfAbsent("x-lucern-session-token", config.userToken);
483
- setIfAbsent("x-lucern-environment", normalizedEnvironment);
484
- setIfAbsent("x-lucern-clerk-id", config.clerkId);
485
- setIfAbsent("x-lucern-user-id", config.userId ?? config.clerkId);
486
- setIfAbsent("x-lucern-deployment-host", config.deploymentHost);
487
- const base = Object.fromEntries(headers.entries());
488
- const authContextInput = await resolveConfiguredAuthContext(
489
- config.authContext
490
- );
491
- if (!authContextInput && !config.requireCanonicalAuthContext) {
492
- return base;
493
- }
494
- const authContext = normalizeCanonicalLucernAuthContext(authContextInput);
495
- return mergeHeaderRecord(base, createCanonicalAuthHeaders(authContext));
496
- }
497
- async function fetchWithTimeout(url, init, timeoutMs) {
498
- const normalizeTransportError = (error, isTimeout) => {
499
- if (isTimeout) {
500
- return new GatewayTimeoutError(timeoutMs);
501
- }
502
- return error instanceof GatewayTimeoutError || error instanceof GatewayTransportError ? error : new GatewayTransportError(
503
- error instanceof Error ? error.message : "Gateway transport error",
504
- {
505
- cause: error,
506
- retryable: classifyGatewayErrorForRetry(error)
298
+ const normalized = value?.trim();
299
+ return normalized ? normalized : undefined;
300
+ }
301
+ /**
302
+ * Create the transport client used by all SDK modules.
303
+ */
304
+ export function createGatewayRequestClient(config = {}) {
305
+ const env = resolveEnvironment();
306
+ const runtime = createGatewayRuntime(config, env);
307
+ const baseUrl = resolveGatewayBaseUrl(config.baseUrl, env);
308
+ const maxRetries = runtime.profile.maxRetries;
309
+ const requestIdFactory = runtime.profile.requestIdFactory;
310
+ const requestTimeoutByMethod = runtime.profile.timeoutMsByMethod;
311
+ const defaultRequestTimeoutMs = runtime.profile.timeoutMs;
312
+ const normalizedEnvironment = normalizeGatewayEnvironment(config.environment);
313
+ const telemetryExporter = config.telemetryEnabled === false
314
+ ? null
315
+ : (config.telemetryExporter ??
316
+ createTelemetryExporterFromEnv(telemetryEnvironmentRecord(env), {
317
+ service: "lucern-sdk",
318
+ environment: normalizedEnvironment,
319
+ }));
320
+ async function resolveAuthHeaders() {
321
+ const provided = config.getAuthHeaders ? await config.getAuthHeaders() : {};
322
+ const headers = new Headers(provided);
323
+ const setIfAbsent = (name, value) => {
324
+ const normalized = cleanHeaderValue(value);
325
+ if (normalized && !headers.has(name)) {
326
+ headers.set(name, normalized);
327
+ }
328
+ };
329
+ setIfAbsent("x-lucern-key", config.apiKey);
330
+ setIfAbsent("x-lucern-session-token", config.userToken);
331
+ setIfAbsent("x-lucern-environment", normalizedEnvironment);
332
+ setIfAbsent("x-lucern-clerk-id", config.clerkId);
333
+ setIfAbsent("x-lucern-user-id", config.userId ?? config.clerkId);
334
+ setIfAbsent("x-lucern-deployment-host", config.deploymentHost);
335
+ const base = Object.fromEntries(headers.entries());
336
+ const authContextInput = await resolveConfiguredAuthContext(config.authContext);
337
+ if (!authContextInput && !config.requireCanonicalAuthContext) {
338
+ return base;
507
339
  }
508
- );
509
- };
510
- const controller = new AbortController();
511
- const timer = setTimeout(() => controller.abort(), timeoutMs);
512
- const requestEffect = Effect.tryPromise({
513
- try: () => runtime.fetch(url, { ...init, signal: controller.signal }),
514
- catch: (error) => normalizeTransportError(error, controller.signal.aborted)
515
- });
516
- try {
517
- const exit = await Effect.runPromiseExit(requestEffect);
518
- if (Exit.isSuccess(exit)) {
519
- return exit.value;
520
- }
521
- const failure = Array.from(Cause.failures(exit.cause))[0];
522
- if (failure !== void 0) {
523
- throw failure;
524
- }
525
- throw Cause.squash(exit.cause);
526
- } finally {
527
- clearTimeout(timer);
528
- }
529
- }
530
- async function emitSdkResponseTelemetry(context) {
531
- const retry = classifyRetry({
532
- status: context.status,
533
- error: context.error,
534
- retryAfter: context.retryAfterMs !== null && context.retryAfterMs !== void 0 ? String(context.retryAfterMs / 1e3) : void 0
535
- });
536
- await emitTelemetrySignal(telemetryExporter, {
537
- signalType: "trace",
538
- surface: "sdk-retry",
539
- eventName: context.willRetry ? "sdk.retry" : context.error ? "sdk.request.error" : "sdk.request.complete",
540
- severity: context.error ? context.willRetry ? "warn" : "error" : "info",
541
- durationMs: context.durationMs,
542
- metricName: "sdk.request.duration_ms",
543
- metricValue: context.durationMs,
544
- correlationId: context.correlationId ?? context.requestId,
545
- policyTraceId: context.policyTraceId ?? null,
546
- tenantId: context.headers.get("x-lucern-tenant-id") ?? context.headers.get("x-lucern-tenant") ?? void 0,
547
- workspaceId: context.headers.get("x-lucern-workspace-id") ?? context.headers.get("x-lucern-workspace") ?? void 0,
548
- attributes: {
549
- service: "lucern-sdk",
550
- operation: "gateway.request",
551
- path: context.path,
552
- httpMethod: context.method,
553
- httpStatus: context.status,
554
- attempt: context.attempt,
555
- maxRetries: context.maxRetries,
556
- retryReason: retry.reason,
557
- retryAfterMs: context.retryAfterMs ?? retry.retryAfterMs,
558
- willRetry: context.willRetry,
559
- retryable: retry.retryable,
560
- errorName: context.error instanceof Error ? context.error.name : void 0,
561
- errorMessage: context.error instanceof Error ? context.error.message : void 0
562
- }
563
- });
564
- }
565
- async function parsePayload(response) {
566
- const text = await response.text();
567
- if (!text) {
568
- return null;
569
- }
570
- const parsed = tryParseGatewayEnvelopeJson(text);
571
- if (!parsed.ok) {
572
- return null;
573
- }
574
- return isRecord(parsed.value) ? parsed.value : null;
575
- }
576
- function resolveTimeoutMs(method, requestTimeoutMs) {
577
- if (typeof requestTimeoutMs === "number") {
578
- return requestTimeoutMs;
579
- }
580
- const methodTimeoutMs = requestTimeoutByMethod?.[method];
581
- if (typeof methodTimeoutMs === "number") {
582
- return methodTimeoutMs;
583
- }
584
- return defaultRequestTimeoutMs;
585
- }
586
- function tryParseGatewayEnvelopeJson(text) {
587
- const trimmed = text.trim();
588
- if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
589
- return { ok: false, reason: "non-json" };
590
- }
591
- try {
592
- return { ok: true, value: JSON.parse(trimmed) };
593
- } catch (error) {
594
- if (error instanceof SyntaxError) {
595
- return { ok: false, reason: "invalid-json", error };
596
- }
597
- throw error;
598
- }
599
- }
600
- function buildApiError(args) {
601
- const failure = args.failure;
602
- const legacyError = failure && isRecord(failure.error) ? failure.error : failure?.legacyError;
603
- const correlationId = failure?.correlationId ?? args.response.headers.get("x-lucern-correlation-id")?.trim() ?? args.requestId;
604
- const policyTraceId = failure?.policyTraceId ?? args.response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null;
605
- const details = runtime.redaction(
606
- redactJsonDiagnosticValue(failure?.details ?? legacyError?.details)
607
- );
608
- const policySummary = readPolicySummaryFromDetails(details);
609
- const failureMessage = typeof failure?.error === "string" ? failure.error : legacyError?.message;
610
- return new LucernApiError({
611
- code: failure?.code ?? legacyError?.code ?? fallbackErrorCode(args.response.status),
612
- message: policySummary ?? failureMessage ?? (args.response.ok ? "Platform API returned an invalid success payload." : "Platform API request failed."),
613
- status: args.response.status,
614
- invariant: failure?.invariant,
615
- suggestion: failure?.suggestion,
616
- details,
617
- requestId: args.requestId,
618
- correlationId,
619
- policyTraceId
620
- });
621
- }
622
- async function request(args) {
623
- const authHeaders = await resolveAuthHeaders();
624
- const method = args.method ?? "GET";
625
- const timeoutMs = resolveTimeoutMs(method, args.timeoutMs);
626
- const headers = new Headers({
627
- "content-type": "application/json",
628
- ...authHeaders
629
- });
630
- if (args.idempotencyKey) {
631
- headers.set("idempotency-key", args.idempotencyKey);
632
- }
633
- const requestId = headers.get("x-correlation-id")?.trim() || headers.get("x-request-id")?.trim() || args.requestId || requestIdFactory();
634
- if (!headers.has("x-correlation-id") && !headers.has("x-request-id")) {
635
- headers.set("x-correlation-id", requestId);
636
- }
637
- const url = `${baseUrl}${args.path}`;
638
- const serializedBody = args.body ? JSON.stringify(args.body) : void 0;
639
- const init = {
640
- method,
641
- headers,
642
- body: serializedBody
643
- };
644
- let lastError;
645
- for (let attempt = 0; attempt <= maxRetries; attempt++) {
646
- const hookRequestContext = {
647
- requestId,
648
- attempt,
649
- maxRetries,
650
- method,
651
- path: args.path,
652
- url,
653
- headers: new Headers(headers),
654
- body: serializedBody,
655
- timeoutMs
656
- };
657
- await config.onRequest?.(hookRequestContext);
658
- const startedAt = Date.now();
659
- try {
660
- const response = await fetchWithTimeout(url, init, timeoutMs);
661
- const responseClone = response.clone();
662
- const payload = await parsePayload(response);
340
+ const authContext = normalizeCanonicalLucernAuthContext(authContextInput);
341
+ return mergeHeaderRecord(base, createCanonicalAuthHeaders(authContext));
342
+ }
343
+ async function fetchWithTimeout(url, init, timeoutMs) {
344
+ const normalizeTransportError = (error, isTimeout) => {
345
+ if (isTimeout) {
346
+ return new GatewayTimeoutError(timeoutMs);
347
+ }
348
+ return error instanceof GatewayTimeoutError ||
349
+ error instanceof GatewayTransportError
350
+ ? error
351
+ : new GatewayTransportError(error instanceof Error ? error.message : "Gateway transport error", {
352
+ cause: error,
353
+ retryable: classifyGatewayErrorForRetry(error),
354
+ });
355
+ };
356
+ const controller = new AbortController();
357
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
358
+ const requestEffect = Effect.tryPromise({
359
+ try: () => runtime.fetch(url, { ...init, signal: controller.signal }),
360
+ catch: (error) => normalizeTransportError(error, controller.signal.aborted),
361
+ });
362
+ try {
363
+ const exit = await Effect.runPromiseExit(requestEffect);
364
+ if (Exit.isSuccess(exit)) {
365
+ return exit.value;
366
+ }
367
+ const failure = Array.from(Cause.failures(exit.cause))[0];
368
+ if (failure !== undefined) {
369
+ throw failure;
370
+ }
371
+ throw Cause.squash(exit.cause);
372
+ }
373
+ finally {
374
+ clearTimeout(timer);
375
+ }
376
+ }
377
+ async function emitSdkResponseTelemetry(context) {
663
378
  const retry = classifyRetry({
664
- status: response.status,
665
- retryAfter: response.headers.get("Retry-After")
379
+ status: context.status,
380
+ error: context.error,
381
+ retryAfter: context.retryAfterMs !== null && context.retryAfterMs !== undefined
382
+ ? String(context.retryAfterMs / 1000)
383
+ : undefined,
666
384
  });
667
- const retryAfterMs = retry.retryAfterMs ?? null;
668
- if (!response.ok || !payload?.success) {
669
- const failure = payload && !payload.success ? payload : null;
670
- const apiError = buildApiError({
671
- requestId,
672
- response,
673
- failure
674
- });
675
- const willRetry = attempt < maxRetries && retry.retryable;
676
- const responseContext2 = {
677
- ...hookRequestContext,
678
- durationMs: Date.now() - startedAt,
679
- status: response.status,
680
- response: responseClone,
681
- error: apiError,
682
- correlationId: apiError.correlationId ?? requestId,
683
- policyTraceId: apiError.policyTraceId ?? null,
684
- retryAfterMs,
685
- willRetry
686
- };
687
- await config.onResponse?.(responseContext2);
688
- await emitSdkResponseTelemetry(responseContext2);
689
- if (willRetry) {
690
- lastError = apiError;
691
- await delay(
692
- computeRetryDelayMs({
693
- attempt,
694
- status: response.status,
695
- retryAfterMs
696
- })
697
- );
698
- continue;
699
- }
700
- throw apiError;
385
+ await emitTelemetrySignal(telemetryExporter, {
386
+ signalType: "trace",
387
+ surface: "sdk-retry",
388
+ eventName: context.willRetry
389
+ ? "sdk.retry"
390
+ : context.error
391
+ ? "sdk.request.error"
392
+ : "sdk.request.complete",
393
+ severity: context.error ? (context.willRetry ? "warn" : "error") : "info",
394
+ durationMs: context.durationMs,
395
+ metricName: "sdk.request.duration_ms",
396
+ metricValue: context.durationMs,
397
+ correlationId: context.correlationId ?? context.requestId,
398
+ policyTraceId: context.policyTraceId ?? null,
399
+ tenantId: context.headers.get("x-lucern-tenant-id") ??
400
+ context.headers.get("x-lucern-tenant") ??
401
+ undefined,
402
+ workspaceId: context.headers.get("x-lucern-workspace-id") ??
403
+ context.headers.get("x-lucern-workspace") ??
404
+ undefined,
405
+ attributes: {
406
+ service: "lucern-sdk",
407
+ operation: "gateway.request",
408
+ path: context.path,
409
+ httpMethod: context.method,
410
+ httpStatus: context.status,
411
+ attempt: context.attempt,
412
+ maxRetries: context.maxRetries,
413
+ retryReason: retry.reason,
414
+ retryAfterMs: context.retryAfterMs ?? retry.retryAfterMs,
415
+ willRetry: context.willRetry,
416
+ retryable: retry.retryable,
417
+ errorName: context.error instanceof Error ? context.error.name : undefined,
418
+ errorMessage: context.error instanceof Error ? context.error.message : undefined,
419
+ },
420
+ });
421
+ }
422
+ async function parsePayload(response) {
423
+ const text = await response.text();
424
+ if (!text) {
425
+ return null;
701
426
  }
702
- const successPayload = payload;
703
- const responseContext = {
704
- ...hookRequestContext,
705
- durationMs: Date.now() - startedAt,
706
- status: response.status,
707
- response: responseClone,
708
- correlationId: successPayload.correlationId ?? response.headers.get("x-lucern-correlation-id")?.trim() ?? requestId,
709
- policyTraceId: successPayload.policyTraceId ?? response.headers.get("x-lucern-policy-trace-id")?.trim() ?? null,
710
- idempotentReplay: successPayload.idempotentReplay,
711
- retryAfterMs,
712
- willRetry: false
713
- };
714
- await config.onResponse?.(responseContext);
715
- await emitSdkResponseTelemetry(responseContext);
716
- return successPayload;
717
- } catch (fetchError) {
718
- if (fetchError instanceof LucernApiError) {
719
- throw fetchError;
427
+ const parsed = tryParseGatewayEnvelopeJson(text);
428
+ if (!parsed.ok) {
429
+ return null;
430
+ }
431
+ return isRecord(parsed.value)
432
+ ? parsed.value
433
+ : null;
434
+ }
435
+ function resolveTimeoutMs(method, requestTimeoutMs) {
436
+ if (typeof requestTimeoutMs === "number") {
437
+ return requestTimeoutMs;
438
+ }
439
+ const methodTimeoutMs = requestTimeoutByMethod?.[method];
440
+ if (typeof methodTimeoutMs === "number") {
441
+ return methodTimeoutMs;
442
+ }
443
+ return defaultRequestTimeoutMs;
444
+ }
445
+ function tryParseGatewayEnvelopeJson(text) {
446
+ const trimmed = text.trim();
447
+ if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
448
+ return { ok: false, reason: "non-json" };
449
+ }
450
+ try {
451
+ return { ok: true, value: JSON.parse(trimmed) };
720
452
  }
721
- const willRetry = attempt < maxRetries && classifyGatewayErrorForRetry(fetchError);
722
- const responseContext = {
723
- ...hookRequestContext,
724
- durationMs: Date.now() - startedAt,
725
- error: fetchError,
726
- correlationId: requestId,
727
- policyTraceId: null,
728
- willRetry
453
+ catch (error) {
454
+ if (error instanceof SyntaxError) {
455
+ return { ok: false, reason: "invalid-json", error };
456
+ }
457
+ throw error;
458
+ }
459
+ }
460
+ function buildApiError(args) {
461
+ const failure = args.failure;
462
+ const legacyError = failure && isRecord(failure.error) ? failure.error : failure?.legacyError;
463
+ const correlationId = failure?.correlationId ??
464
+ args.response.headers.get("x-lucern-correlation-id")?.trim() ??
465
+ args.requestId;
466
+ const policyTraceId = failure?.policyTraceId ??
467
+ args.response.headers.get("x-lucern-policy-trace-id")?.trim() ??
468
+ null;
469
+ const details = runtime.redaction(redactJsonDiagnosticValue(failure?.details ?? legacyError?.details));
470
+ const policySummary = readPolicySummaryFromDetails(details);
471
+ const failureMessage = typeof failure?.error === "string"
472
+ ? failure.error
473
+ : legacyError?.message;
474
+ return new LucernApiError({
475
+ code: failure?.code ??
476
+ legacyError?.code ??
477
+ fallbackErrorCode(args.response.status),
478
+ message: policySummary ??
479
+ failureMessage ??
480
+ (args.response.ok
481
+ ? "Platform API returned an invalid success payload."
482
+ : "Platform API request failed."),
483
+ status: args.response.status,
484
+ invariant: failure?.invariant,
485
+ suggestion: failure?.suggestion,
486
+ details,
487
+ requestId: args.requestId,
488
+ correlationId,
489
+ policyTraceId,
490
+ });
491
+ }
492
+ async function request(args) {
493
+ const authHeaders = await resolveAuthHeaders();
494
+ const method = args.method ?? "GET";
495
+ const timeoutMs = resolveTimeoutMs(method, args.timeoutMs);
496
+ const headers = new Headers({
497
+ "content-type": "application/json",
498
+ ...authHeaders,
499
+ });
500
+ if (args.idempotencyKey) {
501
+ headers.set("idempotency-key", args.idempotencyKey);
502
+ }
503
+ const requestId = headers.get("x-correlation-id")?.trim() ||
504
+ headers.get("x-request-id")?.trim() ||
505
+ args.requestId ||
506
+ requestIdFactory();
507
+ if (!headers.has("x-correlation-id") && !headers.has("x-request-id")) {
508
+ headers.set("x-correlation-id", requestId);
509
+ }
510
+ const url = `${baseUrl}${args.path}`;
511
+ const serializedBody = args.body ? JSON.stringify(args.body) : undefined;
512
+ const init = {
513
+ method,
514
+ headers,
515
+ body: serializedBody,
729
516
  };
730
- await config.onResponse?.(responseContext);
731
- await emitSdkResponseTelemetry(responseContext);
732
- lastError = fetchError;
733
- if (willRetry) {
734
- await delay(computeRetryDelayMs({ attempt }));
517
+ let lastError;
518
+ for (let attempt = 0; attempt <= maxRetries; attempt++) {
519
+ const hookRequestContext = {
520
+ requestId,
521
+ attempt,
522
+ maxRetries,
523
+ method,
524
+ path: args.path,
525
+ url,
526
+ headers: new Headers(headers),
527
+ body: serializedBody,
528
+ timeoutMs,
529
+ };
530
+ await config.onRequest?.(hookRequestContext);
531
+ const startedAt = Date.now();
532
+ try {
533
+ const response = await fetchWithTimeout(url, init, timeoutMs);
534
+ const responseClone = response.clone();
535
+ const payload = await parsePayload(response);
536
+ const retry = classifyRetry({
537
+ status: response.status,
538
+ retryAfter: response.headers.get("Retry-After"),
539
+ });
540
+ const retryAfterMs = retry.retryAfterMs ?? null;
541
+ if (!response.ok || !payload?.success) {
542
+ const failure = payload && !payload.success ? payload : null;
543
+ const apiError = buildApiError({
544
+ requestId,
545
+ response,
546
+ failure,
547
+ });
548
+ const willRetry = attempt < maxRetries && retry.retryable;
549
+ const responseContext = {
550
+ ...hookRequestContext,
551
+ durationMs: Date.now() - startedAt,
552
+ status: response.status,
553
+ response: responseClone,
554
+ error: apiError,
555
+ correlationId: apiError.correlationId ?? requestId,
556
+ policyTraceId: apiError.policyTraceId ?? null,
557
+ retryAfterMs,
558
+ willRetry,
559
+ };
560
+ await config.onResponse?.(responseContext);
561
+ await emitSdkResponseTelemetry(responseContext);
562
+ if (willRetry) {
563
+ lastError = apiError;
564
+ await delay(computeRetryDelayMs({
565
+ attempt,
566
+ status: response.status,
567
+ retryAfterMs,
568
+ }));
569
+ continue;
570
+ }
571
+ throw apiError;
572
+ }
573
+ const successPayload = payload;
574
+ const responseContext = {
575
+ ...hookRequestContext,
576
+ durationMs: Date.now() - startedAt,
577
+ status: response.status,
578
+ response: responseClone,
579
+ correlationId: successPayload.correlationId ??
580
+ response.headers.get("x-lucern-correlation-id")?.trim() ??
581
+ requestId,
582
+ policyTraceId: successPayload.policyTraceId ??
583
+ response.headers.get("x-lucern-policy-trace-id")?.trim() ??
584
+ null,
585
+ idempotentReplay: successPayload.idempotentReplay,
586
+ retryAfterMs,
587
+ willRetry: false,
588
+ };
589
+ await config.onResponse?.(responseContext);
590
+ await emitSdkResponseTelemetry(responseContext);
591
+ return successPayload;
592
+ }
593
+ catch (fetchError) {
594
+ if (fetchError instanceof LucernApiError) {
595
+ throw fetchError;
596
+ }
597
+ const willRetry = attempt < maxRetries && classifyGatewayErrorForRetry(fetchError);
598
+ const responseContext = {
599
+ ...hookRequestContext,
600
+ durationMs: Date.now() - startedAt,
601
+ error: fetchError,
602
+ correlationId: requestId,
603
+ policyTraceId: null,
604
+ willRetry,
605
+ };
606
+ await config.onResponse?.(responseContext);
607
+ await emitSdkResponseTelemetry(responseContext);
608
+ lastError = fetchError;
609
+ if (willRetry) {
610
+ await delay(computeRetryDelayMs({ attempt }));
611
+ }
612
+ }
735
613
  }
736
- }
614
+ throw lastError instanceof Error
615
+ ? lastError
616
+ : new Error("Platform API request failed after retries.");
737
617
  }
738
- throw lastError instanceof Error ? lastError : new Error("Platform API request failed after retries.");
739
- }
740
- return {
741
- request
742
- };
618
+ return {
619
+ request,
620
+ };
743
621
  }
744
-
745
- export { GatewayTimeoutError, GatewayTransportError, LucernApiError, createGatewayRequestClient, isGatewayRecoverableError, isGatewayRetryableError, randomIdempotencyKey, toQueryString };
746
- //# sourceMappingURL=coreClient.js.map
747
622
  //# sourceMappingURL=coreClient.js.map