@laburen/delta-sdk 1.3.0 → 1.5.0-canary.11

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 (150) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +3 -0
  3. package/dist/core/config.d.ts +12 -12
  4. package/dist/core/config.d.ts.map +1 -1
  5. package/dist/core/config.js +88 -88
  6. package/dist/core/config.js.map +1 -1
  7. package/dist/core/{constantes.d.ts → constants.d.ts} +3 -3
  8. package/dist/core/constants.d.ts.map +1 -0
  9. package/dist/core/{constantes.js → constants.js} +3 -3
  10. package/dist/core/constants.js.map +1 -0
  11. package/dist/core/{contadores.d.ts → counters.d.ts} +12 -11
  12. package/dist/core/counters.d.ts.map +1 -0
  13. package/dist/core/counters.js +53 -0
  14. package/dist/core/counters.js.map +1 -0
  15. package/dist/core/{sobre.d.ts → envelope.d.ts} +17 -17
  16. package/dist/core/envelope.d.ts.map +1 -0
  17. package/dist/core/envelope.js +198 -0
  18. package/dist/core/envelope.js.map +1 -0
  19. package/dist/core/scrubbing.d.ts +4 -4
  20. package/dist/core/scrubbing.d.ts.map +1 -1
  21. package/dist/core/scrubbing.js +38 -38
  22. package/dist/core/scrubbing.js.map +1 -1
  23. package/dist/core/{sesion.d.ts → session.d.ts} +2 -2
  24. package/dist/core/session.d.ts.map +1 -0
  25. package/dist/core/{sesion.js → session.js} +2 -2
  26. package/dist/core/session.js.map +1 -0
  27. package/dist/core/{transporte.d.ts → transport.d.ts} +9 -9
  28. package/dist/core/transport.d.ts.map +1 -0
  29. package/dist/core/{transporte.js → transport.js} +15 -15
  30. package/dist/core/transport.js.map +1 -0
  31. package/dist/core/{tipos.d.ts → types.d.ts} +4 -4
  32. package/dist/core/{tipos.d.ts.map → types.d.ts.map} +1 -1
  33. package/dist/core/{tipos.js → types.js} +1 -1
  34. package/dist/core/{tipos.js.map → types.js.map} +1 -1
  35. package/dist/index.d.ts +1 -1
  36. package/dist/platform/client.d.ts +8 -0
  37. package/dist/platform/client.d.ts.map +1 -0
  38. package/dist/platform/client.js +30 -0
  39. package/dist/platform/client.js.map +1 -0
  40. package/dist/platform/core/errors.d.ts +150 -0
  41. package/dist/platform/core/errors.d.ts.map +1 -0
  42. package/dist/platform/core/errors.js +265 -0
  43. package/dist/platform/core/errors.js.map +1 -0
  44. package/dist/platform/core/oauth.d.ts +37 -0
  45. package/dist/platform/core/oauth.d.ts.map +1 -0
  46. package/dist/platform/core/oauth.js +144 -0
  47. package/dist/platform/core/oauth.js.map +1 -0
  48. package/dist/platform/core/pagination.d.ts +30 -0
  49. package/dist/platform/core/pagination.d.ts.map +1 -0
  50. package/dist/platform/core/pagination.js +44 -0
  51. package/dist/platform/core/pagination.js.map +1 -0
  52. package/dist/platform/core/request.d.ts +6 -0
  53. package/dist/platform/core/request.d.ts.map +1 -0
  54. package/dist/platform/core/request.js +24 -0
  55. package/dist/platform/core/request.js.map +1 -0
  56. package/dist/platform/core/send.d.ts +36 -0
  57. package/dist/platform/core/send.d.ts.map +1 -0
  58. package/dist/platform/core/send.js +184 -0
  59. package/dist/platform/core/send.js.map +1 -0
  60. package/dist/platform/core/sse.d.ts +8 -0
  61. package/dist/platform/core/sse.d.ts.map +1 -0
  62. package/dist/platform/core/sse.js +72 -0
  63. package/dist/platform/core/sse.js.map +1 -0
  64. package/dist/platform/core/stream.d.ts +21 -0
  65. package/dist/platform/core/stream.d.ts.map +1 -0
  66. package/dist/platform/core/stream.js +268 -0
  67. package/dist/platform/core/stream.js.map +1 -0
  68. package/dist/platform/generated/resources.d.ts +120 -0
  69. package/dist/platform/generated/resources.d.ts.map +1 -0
  70. package/dist/platform/generated/resources.js +65 -0
  71. package/dist/platform/generated/resources.js.map +1 -0
  72. package/dist/platform/generated/schemas.d.ts +88 -0
  73. package/dist/platform/generated/schemas.d.ts.map +1 -0
  74. package/dist/platform/generated/schemas.js +2 -0
  75. package/dist/platform/generated/schemas.js.map +1 -0
  76. package/dist/platform/generated/types.d.ts +5181 -0
  77. package/dist/platform/generated/types.d.ts.map +1 -0
  78. package/dist/platform/generated/types.js +6 -0
  79. package/dist/platform/generated/types.js.map +1 -0
  80. package/dist/platform/index.d.ts +9 -0
  81. package/dist/platform/index.d.ts.map +1 -0
  82. package/dist/platform/index.js +7 -0
  83. package/dist/platform/index.js.map +1 -0
  84. package/dist/telemetry/{captura.d.ts → capture.d.ts} +3 -3
  85. package/dist/telemetry/capture.d.ts.map +1 -0
  86. package/dist/telemetry/{captura.js → capture.js} +54 -54
  87. package/dist/telemetry/capture.js.map +1 -0
  88. package/dist/telemetry/index.d.ts +2 -2
  89. package/dist/telemetry/index.js +1 -1
  90. package/dist/telemetry/{tipos.d.ts → types.d.ts} +2 -2
  91. package/dist/telemetry/types.d.ts.map +1 -0
  92. package/dist/telemetry/types.js +2 -0
  93. package/dist/telemetry/types.js.map +1 -0
  94. package/dist/telemetry/with-telemetry.d.ts +9 -9
  95. package/dist/telemetry/with-telemetry.d.ts.map +1 -1
  96. package/dist/telemetry/with-telemetry.js +31 -31
  97. package/dist/telemetry/with-telemetry.js.map +1 -1
  98. package/dist/telemetry/with-tool.d.ts +2 -2
  99. package/dist/telemetry/with-tool.d.ts.map +1 -1
  100. package/dist/telemetry/with-tool.js +3 -3
  101. package/dist/telemetry/with-tool.js.map +1 -1
  102. package/docs/platform/guide.md +661 -0
  103. package/docs/telemetry/que-se-manda.md +2 -2
  104. package/docs/telemetry/troubleshooting.md +1 -1
  105. package/package.json +15 -5
  106. package/src/core/config.ts +81 -83
  107. package/src/core/{constantes.ts → constants.ts} +2 -2
  108. package/src/core/counters.ts +72 -0
  109. package/src/core/envelope.ts +234 -0
  110. package/src/core/scrubbing.ts +41 -41
  111. package/src/core/{sesion.ts → session.ts} +1 -1
  112. package/src/core/{transporte.ts → transport.ts} +20 -20
  113. package/src/core/{tipos.ts → types.ts} +3 -3
  114. package/src/index.ts +1 -1
  115. package/src/platform/client.ts +32 -0
  116. package/src/platform/core/errors.ts +348 -0
  117. package/src/platform/core/oauth.ts +201 -0
  118. package/src/platform/core/pagination.ts +67 -0
  119. package/src/platform/core/request.ts +27 -0
  120. package/src/platform/core/send.ts +225 -0
  121. package/src/platform/core/sse.ts +68 -0
  122. package/src/platform/core/stream.ts +314 -0
  123. package/src/platform/generated/resources.ts +192 -0
  124. package/src/platform/generated/schemas.ts +84 -0
  125. package/src/platform/generated/types.ts +5181 -0
  126. package/src/platform/index.ts +45 -0
  127. package/src/telemetry/{captura.ts → capture.ts} +57 -57
  128. package/src/telemetry/index.ts +2 -2
  129. package/src/telemetry/{tipos.ts → types.ts} +1 -1
  130. package/src/telemetry/with-telemetry.ts +51 -54
  131. package/src/telemetry/with-tool.ts +5 -5
  132. package/dist/core/constantes.d.ts.map +0 -1
  133. package/dist/core/constantes.js.map +0 -1
  134. package/dist/core/contadores.d.ts.map +0 -1
  135. package/dist/core/contadores.js +0 -53
  136. package/dist/core/contadores.js.map +0 -1
  137. package/dist/core/sesion.d.ts.map +0 -1
  138. package/dist/core/sesion.js.map +0 -1
  139. package/dist/core/sobre.d.ts.map +0 -1
  140. package/dist/core/sobre.js +0 -200
  141. package/dist/core/sobre.js.map +0 -1
  142. package/dist/core/transporte.d.ts.map +0 -1
  143. package/dist/core/transporte.js.map +0 -1
  144. package/dist/telemetry/captura.d.ts.map +0 -1
  145. package/dist/telemetry/captura.js.map +0 -1
  146. package/dist/telemetry/tipos.d.ts.map +0 -1
  147. package/dist/telemetry/tipos.js +0 -2
  148. package/dist/telemetry/tipos.js.map +0 -1
  149. package/src/core/contadores.ts +0 -71
  150. package/src/core/sobre.ts +0 -236
@@ -0,0 +1,45 @@
1
+ // Puerta `/platform`: barrel sin lógica.
2
+ export { createPlatform } from "./client.js";
3
+ export {
4
+ ApiError,
5
+ AuthenticationError,
6
+ BillingError,
7
+ ConflictError,
8
+ type ErrorCode,
9
+ type ErrorType,
10
+ InvalidRequestError,
11
+ isLaburenAbortError,
12
+ isLaburenApiError,
13
+ isLaburenArgumentError,
14
+ isLaburenConnectionError,
15
+ isLaburenOAuthError,
16
+ isLaburenTimeoutError,
17
+ LaburenAbortError,
18
+ LaburenApiError,
19
+ LaburenArgumentError,
20
+ LaburenConnectionError,
21
+ LaburenOAuthError,
22
+ LaburenTimeoutError,
23
+ NotFoundError,
24
+ OverloadedError,
25
+ PermissionError,
26
+ RateLimitError,
27
+ type ResourceInUseVersion,
28
+ resourceInUseVersions,
29
+ } from "./core/errors.js";
30
+ export {
31
+ type OAuthCallOptions,
32
+ type RefreshTokenOptions,
33
+ type RevokeTokenOptions,
34
+ refreshToken,
35
+ revokeToken,
36
+ type StartDeviceLoginOptions,
37
+ startDeviceLogin,
38
+ type WaitForDeviceTokenOptions,
39
+ waitForDeviceToken,
40
+ } from "./core/oauth.js";
41
+ export { type Page, type PageCursor, PagePromise } from "./core/pagination.js";
42
+ export { DEFAULT_BASE_URL, type PlatformConfig, type RequestOptions } from "./core/send.js";
43
+ export type { AgentStream } from "./core/stream.js";
44
+ export type { Resources } from "./generated/resources.js";
45
+ export type * from "./generated/schemas.js";
@@ -1,7 +1,8 @@
1
- import { notifyUsable, validar } from "../core/config.js";
2
- import { contarBeforeSend, contarInterno } from "../core/contadores.js";
3
- import { aplicarBeforeSend, scrubEvento } from "../core/scrubbing.js";
4
- import { armarEvento, armarSobre, extraerException, serializarAcotado } from "../core/sobre.js";
1
+ import { usableNotify, validate } from "../core/config.js";
2
+ import { countBeforeSend, countInternal } from "../core/counters.js";
3
+ import { buildEnvelope, buildEvent, extractException, serializeCapped } from "../core/envelope.js";
4
+ import { applyBeforeSend, scrubEvent } from "../core/scrubbing.js";
5
+ import { BROKEN_CTX_WARNING, probeCtx, send } from "../core/transport.js";
5
6
  import type {
6
7
  CaptureOptions,
7
8
  Notify,
@@ -9,19 +10,18 @@ import type {
9
10
  TelemetryClient,
10
11
  TelemetryConfig,
11
12
  TelemetryEvent,
12
- } from "../core/tipos.js";
13
- import { AVISO_CTX_ROTO, enviar, probarCtx } from "../core/transporte.js";
14
- import { crearWithTool } from "./with-tool.js";
13
+ } from "../core/types.js";
14
+ import { createWithTool } from "./with-tool.js";
15
15
 
16
16
  /** Descarta todo, pero `withTool` sigue corriendo la tool y re-lanzando: un cliente inerte no
17
17
  * puede cambiar el comportamiento de la app. Exportado (pero no re-exportado por ninguna puerta
18
18
  * del `exports` map) para que `with-telemetry.ts` lo use como el cuarto argumento del handler
19
19
  * cuando `configFn` lanza: el invariante es que ese argumento nunca es `null`/`undefined`. */
20
- export function clienteInerte(): TelemetryClient {
20
+ export function inertClient(): TelemetryClient {
21
21
  return {
22
22
  captureException() {},
23
23
  captureEvent() {},
24
- withTool: crearWithTool(() => {}),
24
+ withTool: createWithTool(() => {}),
25
25
  };
26
26
  }
27
27
 
@@ -29,13 +29,13 @@ export function clienteInerte(): TelemetryClient {
29
29
  * del error, y ahí una columna puede venir NULL — el mismo agujero que la validación de la
30
30
  * config, pero por evento. Si el override no es usable se descarta CON AVISO: el evento sale
31
31
  * igual, con el `notify` de la config (que ya se validó), en vez de perderse mudo con un 400. */
32
- function notifyDelEvento(override: Notify | undefined, notifyDeConfig: Notify): Notify {
33
- if (override === undefined) return notifyDeConfig;
34
- if (notifyUsable(override)) return override;
32
+ function eventNotify(override: Notify | undefined, configNotify: Notify): Notify {
33
+ if (override === undefined) return configNotify;
34
+ if (usableNotify(override)) return override;
35
35
  console.error(
36
36
  "[delta-sdk] el notify de CaptureOptions no es usable (revisá channel/to): se descarta y el evento sale con el notify de la config",
37
37
  );
38
- return notifyDeConfig;
38
+ return configNotify;
39
39
  }
40
40
 
41
41
  /** El núcleo explícito, y el camino principal: los dos wrappers se construyen sobre esto y
@@ -44,92 +44,92 @@ function notifyDelEvento(override: Notify | undefined, notifyDeConfig: Notify):
44
44
  * Va llamado DENTRO de una invocación —`init()` de un Durable Object, un handler— y nunca a
45
45
  * nivel de módulo: un valor aleatorio en el scope global hace fallar el deploy. */
46
46
  export function createTelemetry(config: TelemetryConfig): TelemetryClient {
47
- let avisado = false;
47
+ let warned = false;
48
48
  // Una vez por cliente y no una por captura: 40 capturas no pueden ser 40 líneas iguales.
49
- const avisarCtxRoto = (): void => {
50
- if (avisado) return;
51
- avisado = true;
52
- console.error(AVISO_CTX_ROTO);
49
+ const warnBrokenCtx = (): void => {
50
+ if (warned) return;
51
+ warned = true;
52
+ console.error(BROKEN_CTX_WARNING);
53
53
  };
54
54
 
55
- // El único punto de estrangulamiento: `validar` lee `service.name`, `organizationId`, `agentId`,
55
+ // El único punto de estrangulamiento: `validate` lee `service.name`, `organizationId`, `agentId`,
56
56
  // `apiKey`, `surface` y `notify` de un `entrada` que puede ser cualquier cosa en runtime — un
57
57
  // getter roto en CUALQUIERA de esos campos, o el objeto `config` entero armado como un `Proxy`
58
- // hostil, puede lanzar antes de llegar al `try/catch` interno de `motivoNotifyInvalido`. Envolver
58
+ // hostil, puede lanzar antes de llegar al `try/catch` interno de `invalidNotifyReason`. Envolver
59
59
  // acá cierra el invariante para TODO el objeto de entrada de una sola vez, en vez de una lista de
60
60
  // campos que hay que mantener campo por campo.
61
- let resultado: ReturnType<typeof validar>;
61
+ let result: ReturnType<typeof validate>;
62
62
  try {
63
- resultado = validar(config);
63
+ result = validate(config);
64
64
  } catch (error) {
65
65
  console.error(
66
66
  "[delta-sdk] no se pudo leer la config: este worker no va a reportar nada",
67
67
  error,
68
68
  );
69
- return clienteInerte();
69
+ return inertClient();
70
70
  }
71
- if (!resultado.ok) {
71
+ if (!result.ok) {
72
72
  console.error(
73
- `[delta-sdk] config inválida: este worker no va a reportar nada. Falta o está vacío: ${resultado.faltan.join(", ")}`,
73
+ `[delta-sdk] config inválida: este worker no va a reportar nada. Falta o está vacío: ${result.missing.join(", ")}`,
74
74
  );
75
- return clienteInerte();
75
+ return inertClient();
76
76
  }
77
77
 
78
- const cfg = resultado.config;
79
- const ctx = probarCtx(config.ctx, avisarCtxRoto);
78
+ const cfg = result.config;
79
+ const ctx = probeCtx(config.ctx, warnBrokenCtx);
80
80
 
81
- const capturar = (
82
- tipo: "error" | "event",
83
- mensaje: string | undefined,
81
+ const capture = (
82
+ kind: "error" | "event",
83
+ message: string | undefined,
84
84
  exception: TelemetryEvent["exception"] | undefined,
85
85
  severityDefault: Severity,
86
- opciones: CaptureOptions,
86
+ options: CaptureOptions,
87
87
  ): void => {
88
88
  try {
89
- const armado = armarEvento({
90
- tipo,
91
- mensaje,
89
+ const built = buildEvent({
90
+ kind,
91
+ message,
92
92
  exception,
93
93
  agentId: cfg.agentId,
94
94
  surface: cfg.surface,
95
95
  severityDefault,
96
- opciones,
96
+ options,
97
97
  });
98
- const limpio = scrubEvento(armado, cfg.scrub);
99
- const final = aplicarBeforeSend(limpio, cfg.beforeSend);
98
+ const clean = scrubEvent(built, cfg.scrub);
99
+ const final = applyBeforeSend(clean, cfg.beforeSend);
100
100
  if (final === null) {
101
101
  // Un null cuenta como drop con razón `before_send`, que es una de las razones
102
102
  // canónicas de Sentry.
103
- contarBeforeSend();
103
+ countBeforeSend();
104
104
  return;
105
105
  }
106
106
 
107
- const sobre = armarSobre({
108
- evento: final,
107
+ const envelope = buildEnvelope({
108
+ event: final,
109
109
  service: cfg.service,
110
110
  // Los overrides por evento: un worker multi-tenant no conoce estos valores
111
111
  // cuando se arma el cliente. `||` y no `??`: la config ya se validó no
112
112
  // vacía, así que un "" del caller no puede ganarle al fallback bueno.
113
- organizationId: opciones.organizationId || cfg.organizationId,
113
+ organizationId: options.organizationId || cfg.organizationId,
114
114
  surface: cfg.surface,
115
- notify: notifyDelEvento(opciones.notify, cfg.notify),
115
+ notify: eventNotify(options.notify, cfg.notify),
116
116
  });
117
- const { body } = serializarAcotado(sobre);
117
+ const { body } = serializeCapped(envelope);
118
118
 
119
- enviar({
119
+ send({
120
120
  body,
121
121
  apiKey: cfg.apiKey,
122
122
  url: cfg.ingestUrl,
123
123
  ctx,
124
124
  debug: cfg.debug,
125
- avisarCtxRoto,
125
+ warnBrokenCtx,
126
126
  });
127
127
  } catch (error) {
128
128
  // Última red. La superficie pública entera está envuelta: el SDK no puede lanzar ni
129
129
  // con la config más rara. Es la quinta forma de perder un evento, y se
130
130
  // cuenta igual que las otras cuatro: sin esto el sobre siguiente reportaba los cuatro
131
131
  // contadores en cero, como si nada hubiera pasado.
132
- contarInterno();
132
+ countInternal();
133
133
  console.error("[delta-sdk] no se pudo reportar el evento", error);
134
134
  }
135
135
  };
@@ -137,27 +137,27 @@ export function createTelemetry(config: TelemetryConfig): TelemetryClient {
137
137
  /** Devuelve void, nunca una promesa, y nunca lanza. No se puede `await` a propósito:
138
138
  * esperarlo le sumaría 40-150 ms a cada respuesta del agente.
139
139
  *
140
- * El try/catch de acá es una red DISTINTA de la de `capturar`: `extraerException` lee
140
+ * El try/catch de acá es una red DISTINTA de la de `capture`: `extractException` lee
141
141
  * `.name`/`.message`/`.stack` de un valor que viene del cliente y que nadie validó, y un
142
142
  * getter roto (una lib de source maps, un mock) puede lanzar ahí, antes de que exista ningún
143
- * evento que meter en la red de `capturar`. Sin esto el throw se escapa de la superficie
143
+ * evento que meter en la red de `capture`. Sin esto el throw se escapa de la superficie
144
144
  * pública y, peor, `withTool` lo re-lanza a ÉL en vez del error original de la tool. */
145
- const captureException = (error: unknown, opciones: CaptureOptions = {}): void => {
145
+ const captureException = (error: unknown, options: CaptureOptions = {}): void => {
146
146
  let exception: TelemetryEvent["exception"];
147
147
  try {
148
- exception = extraerException(error);
149
- } catch (fallo) {
150
- console.error("[delta-sdk] no se pudo leer el error recibido", fallo);
148
+ exception = extractException(error);
149
+ } catch (failure) {
150
+ console.error("[delta-sdk] no se pudo leer el error recibido", failure);
151
151
  exception = { type: "UnknownError" };
152
152
  }
153
- capturar("error", exception?.message, exception, "error", opciones);
153
+ capture("error", exception?.message, exception, "error", options);
154
154
  };
155
155
 
156
156
  /** El default es `warning` y no `error` porque un captureEvent típico registra una falla que
157
157
  * el código ya manejó: se guarda en D1 y no despierta a nadie. */
158
- const captureEvent = (message: string, opciones: CaptureOptions = {}): void => {
159
- capturar("event", message, undefined, "warning", opciones);
158
+ const captureEvent = (message: string, options: CaptureOptions = {}): void => {
159
+ capture("event", message, undefined, "warning", options);
160
160
  };
161
161
 
162
- return { captureException, captureEvent, withTool: crearWithTool(captureException) };
162
+ return { captureException, captureEvent, withTool: createWithTool(captureException) };
163
163
  }
@@ -1,4 +1,4 @@
1
- export { createTelemetry } from "./captura.js";
1
+ export { createTelemetry } from "./capture.js";
2
2
  export type {
3
3
  CaptureOptions,
4
4
  CtxLike,
@@ -11,6 +11,6 @@ export type {
11
11
  TelemetryClient,
12
12
  TelemetryConfig,
13
13
  TelemetryEvent,
14
- } from "./tipos.js";
14
+ } from "./types.js";
15
15
  export type { Handlers } from "./with-telemetry.js";
16
16
  export { withTelemetry } from "./with-telemetry.js";
@@ -10,4 +10,4 @@ export type {
10
10
  TelemetryClient,
11
11
  TelemetryConfig,
12
12
  TelemetryEvent,
13
- } from "../core/tipos.js";
13
+ } from "../core/types.js";
@@ -5,36 +5,36 @@ import type {
5
5
  HandlerTelemetryConfig,
6
6
  Surface,
7
7
  TelemetryClient,
8
- } from "../core/tipos.js";
9
- import { clienteInerte, createTelemetry } from "./captura.js";
8
+ } from "../core/types.js";
9
+ import { createTelemetry, inertClient } from "./capture.js";
10
10
 
11
11
  /** `(...args: never[]) => unknown` es el supertipo de cualquier función, sin usar `any`: deja
12
12
  * pasar el handler tal como lo escribió el implementador, con SUS tipos de Cloudflare. */
13
- type HandlerCualquiera = (...args: never[]) => unknown;
13
+ type AnyHandler = (...args: never[]) => unknown;
14
14
 
15
15
  export interface Handlers {
16
- fetch?: HandlerCualquiera;
17
- queue?: HandlerCualquiera;
18
- scheduled?: HandlerCualquiera;
16
+ fetch?: AnyHandler;
17
+ queue?: AnyHandler;
18
+ scheduled?: AnyHandler;
19
19
  }
20
20
 
21
21
  /** El nombre del handler ES la superficie. No hay nada que el implementador pueda escribir mal,
22
22
  * y a diferencia de los comentarios del repo, el nombre del handler no miente. */
23
- const SUPERFICIE_POR_HANDLER = {
23
+ const SURFACE_BY_HANDLER = {
24
24
  fetch: "worker",
25
25
  queue: "queue",
26
26
  scheduled: "cron",
27
27
  } as const satisfies Record<keyof Handlers, Surface>;
28
28
 
29
- interface MensajeCola {
29
+ interface QueueMessage {
30
30
  id?: string;
31
31
  attempts?: number;
32
32
  }
33
33
 
34
34
  // El handler tal como lo escribe el implementador: el wrapper lo llama SIEMPRE con el cliente
35
35
  // como cuarto argumento. Un handler que declara solo tres lo ignora y sigue andando igual.
36
- type HandlerInterno = (
37
- primero: unknown,
36
+ type InnerHandler = (
37
+ first: unknown,
38
38
  env: unknown,
39
39
  ctx: CtxLike,
40
40
  telemetry: TelemetryClient,
@@ -43,96 +43,93 @@ type HandlerInterno = (
43
43
  // Lo que expone `withTelemetry`: solo los tres parámetros que el runtime (Cloudflare, o quien
44
44
  // invoque el `export default`) puede llegar a pasar. El cuarto lo agrega `envolver` puertas
45
45
  // adentro, nunca el caller externo, así que el tipo expuesto no puede exigirlo.
46
- type Envuelto = (primero: unknown, env: unknown, ctx: CtxLike) => Promise<unknown>;
46
+ type Wrapped = (first: unknown, env: unknown, ctx: CtxLike) => Promise<unknown>;
47
47
 
48
48
  /** Recorta el tipo de un handler a sus primeros tres parámetros, preservando el resto: es lo
49
49
  * único que un caller externo puede llegar a pasar. Sin esto, un handler que declara el cuarto
50
50
  * parámetro (`telemetry`) haría que `withTelemetry` devolviera un tipo que exige ESE cuarto
51
51
  * argumento también al invocarlo desde afuera — cuando en realidad lo agrega el wrapper. */
52
- type SoloLosPrimerosTres<F> = F extends (...args: infer Args) => infer R
52
+ type FirstThreeOnly<F> = F extends (...args: infer Args) => infer R
53
53
  ? Args extends [infer P1, infer P2, infer P3, ...unknown[]]
54
54
  ? (p1: P1, p2: P2, p3: P3) => R
55
55
  : F
56
56
  : F;
57
57
 
58
- type HandlersEnvueltos<H extends Handlers> = { [K in keyof H]: SoloLosPrimerosTres<H[K]> };
58
+ type WrappedHandlers<H extends Handlers> = { [K in keyof H]: FirstThreeOnly<H[K]> };
59
59
 
60
60
  /** Las opciones de la captura automática: SIEMPRE lleva `workUnit` con el nombre del handler
61
61
  * (`"fetch"`, `"queue"` o `"scheduled"`) — es el mismo rol que cumple `withTool(nombre)`, y dice
62
62
  * qué entrypoint falló, algo que la superficie (que ya viaja en su propio campo del sobre) no
63
63
  * dice por sí sola. Además, en `queue`, suma los números del reintento que el SDK puede leer del
64
64
  * batch; en las otras dos superficies los pone el default de la superficie. */
65
- function opcionesDelHandler(
66
- nombre: keyof Handlers,
65
+ function handlerOptions(
66
+ name: keyof Handlers,
67
67
  surface: Surface,
68
- primero: unknown,
68
+ first: unknown,
69
69
  queueMaxRetries: number | undefined,
70
70
  ): CaptureOptions {
71
- if (surface !== "queue") return { workUnit: nombre };
71
+ if (surface !== "queue") return { workUnit: name };
72
72
 
73
- const mensajes = (primero as { messages?: readonly MensajeCola[] } | null)?.messages ?? [];
74
- if (mensajes.length === 0) return { workUnit: nombre };
73
+ const messages = (first as { messages?: readonly QueueMessage[] } | null)?.messages ?? [];
74
+ if (messages.length === 0) return { workUnit: name };
75
75
 
76
76
  // Un batch se reintenta ENTERO: el máximo es el intento que puede ser el final. Con el
77
77
  // mínimo, la alerta terminal podría no dispararse nunca.
78
- const attempt = Math.max(...mensajes.map((mensaje) => mensaje.attempts ?? 1));
78
+ const attempt = Math.max(...messages.map((message) => message.attempts ?? 1));
79
79
  // Un batch no tiene un único mensaje del que colgar el id. Para capturar por mensaje va
80
80
  // createTelemetry, y está documentado en docs/superficies.md.
81
- const primerMensaje = mensajes.length === 1 ? mensajes[0] : undefined;
82
- const workUnitId = primerMensaje?.id ?? null;
81
+ const firstMessage = messages.length === 1 ? messages[0] : undefined;
82
+ const workUnitId = firstMessage?.id ?? null;
83
83
 
84
84
  // max_retries son los reintentos DESPUÉS de la primera entrega: limit = max_retries + 1. Si
85
85
  // no está, se omite en vez de adivinar.
86
86
  return queueMaxRetries === undefined
87
- ? { workUnit: nombre, retry: { attempt, workUnitId } }
88
- : { workUnit: nombre, retry: { attempt, limit: queueMaxRetries + 1, workUnitId } };
87
+ ? { workUnit: name, retry: { attempt, workUnitId } }
88
+ : { workUnit: name, retry: { attempt, limit: queueMaxRetries + 1, workUnitId } };
89
89
  }
90
90
 
91
- function envolver<Env>(
92
- nombre: keyof Handlers,
91
+ function wrap<Env>(
92
+ name: keyof Handlers,
93
93
  surface: Surface,
94
94
  configFn: (env: Env) => HandlerTelemetryConfig,
95
- handler: HandlerInterno,
96
- ): Envuelto {
97
- return async (primero, env, ctx) => {
95
+ handler: InnerHandler,
96
+ ): Wrapped {
97
+ return async (first, env, ctx) => {
98
98
  // Nunca queda en `null`: si `configFn` lanza, el handler recibe igual el cliente inerte
99
99
  // como cuarto argumento. Pasar `null` obligaría a `telemetry?.captureException(...)` en
100
100
  // cada consumidor, y el que se olvide del `?.` se rompería solo con un TypeError.
101
- let cliente: TelemetryClient;
101
+ let client: TelemetryClient;
102
102
  let cfg: HandlerTelemetryConfig | null = null;
103
103
 
104
104
  try {
105
105
  cfg = configFn(env as Env);
106
106
  // `surface` y `ctx` los pone el wrapper: el tipo se los prohíbe al implementador para
107
107
  // que no pueda pisarlos con un valor equivocado.
108
- const { surface: _surface, ctx: _ctx, ...resto } = cfg;
109
- cliente = createTelemetry({ ...resto, surface, ctx });
108
+ const { surface: _surface, ctx: _ctx, ...rest } = cfg;
109
+ client = createTelemetry({ ...rest, surface, ctx });
110
110
  } catch (error) {
111
111
  // Si la telemetría no arranca, el handler del cliente corre igual.
112
112
  console.error(
113
113
  "[delta-sdk] no se pudo inicializar la telemetría; el handler sigue igual",
114
114
  error,
115
115
  );
116
- cliente = clienteInerte();
116
+ client = inertClient();
117
117
  }
118
118
 
119
119
  try {
120
120
  // El cliente como cuarto argumento: el implementador puede usarlo en su propio catch
121
121
  // sin llamar a createTelemetry de nuevo ni duplicar la config.
122
- return await handler(primero, env, ctx, cliente);
122
+ return await handler(first, env, ctx, client);
123
123
  } catch (error) {
124
- // `cfg` es la config CRUDA que devolvió `configFn`, no la `ConfigValidada` de
125
- // `createTelemetry`: este camino no pasa por `validar`, así que hay que sanearlo acá
124
+ // `cfg` es la config CRUDA que devolvió `configFn`, no la `ValidatedConfig` de
125
+ // `createTelemetry`: este camino no pasa por `validate`, así que hay que sanearlo acá
126
126
  // también. El aviso de un valor inválido ya lo emite `createTelemetry` más arriba,
127
- // al validar la misma config para construir `cliente`.
128
- const queueMaxRetriesCrudo = cfg?.queueMaxRetries;
129
- const queueMaxRetries = queueMaxRetriesUsable(queueMaxRetriesCrudo)
130
- ? queueMaxRetriesCrudo
127
+ // al validar la misma config para construir `client`.
128
+ const queueMaxRetriesRaw = cfg?.queueMaxRetries;
129
+ const queueMaxRetries = queueMaxRetriesUsable(queueMaxRetriesRaw)
130
+ ? queueMaxRetriesRaw
131
131
  : undefined;
132
- cliente.captureException(
133
- error,
134
- opcionesDelHandler(nombre, surface, primero, queueMaxRetries),
135
- );
132
+ client.captureException(error, handlerOptions(name, surface, first, queueMaxRetries));
136
133
  // Se re-lanza igual que en withTool: el runtime tiene que ver el mismo error para
137
134
  // decidir el 500 o el reintento del batch.
138
135
  throw error;
@@ -149,19 +146,19 @@ function envolver<Env>(
149
146
  export function withTelemetry<Env, H extends Handlers>(
150
147
  configFn: (env: Env) => HandlerTelemetryConfig,
151
148
  handlers: H,
152
- ): HandlersEnvueltos<H> {
153
- const salida = { ...handlers } as unknown as HandlersEnvueltos<H>;
149
+ ): WrappedHandlers<H> {
150
+ const output = { ...handlers } as unknown as WrappedHandlers<H>;
154
151
 
155
- for (const nombre of ["fetch", "queue", "scheduled"] as const) {
156
- const handler = handlers[nombre];
152
+ for (const name of ["fetch", "queue", "scheduled"] as const) {
153
+ const handler = handlers[name];
157
154
  if (handler === undefined) continue;
158
- salida[nombre] = envolver(
159
- nombre,
160
- SUPERFICIE_POR_HANDLER[nombre],
155
+ output[name] = wrap(
156
+ name,
157
+ SURFACE_BY_HANDLER[name],
161
158
  configFn,
162
- handler as unknown as HandlerInterno,
163
- ) as HandlersEnvueltos<H>[typeof nombre];
159
+ handler as unknown as InnerHandler,
160
+ ) as WrappedHandlers<H>[typeof name];
164
161
  }
165
162
 
166
- return salida;
163
+ return output;
167
164
  }
@@ -1,4 +1,4 @@
1
- import type { CaptureOptions, TelemetryClient } from "../core/tipos.js";
1
+ import type { CaptureOptions, TelemetryClient } from "../core/types.js";
2
2
 
3
3
  /** Envuelve una tool de MCP. El implementador NO escribe captureException en ninguna tool: lo
4
4
  * hace este wrapper, una vez, para todas las que envuelva. Ese es el aporte.
@@ -6,17 +6,17 @@ import type { CaptureOptions, TelemetryClient } from "../core/tipos.js";
6
6
  * Tres requisitos, no sugerencias: reenvía TODOS los argumentos porque el SDK invoca con
7
7
  * `(args, extra)`; re-lanza EL MISMO objeto de error porque su mensaje es el que ve el usuario
8
8
  * final; y es arrow function para no introducir un `this` propio. */
9
- export function crearWithTool(
10
- capturar: (error: unknown, opciones: CaptureOptions) => void,
9
+ export function createWithTool(
10
+ capture: (error: unknown, options: CaptureOptions) => void,
11
11
  ): TelemetryClient["withTool"] {
12
- return <Args extends unknown[], R>(nombre: string, fn: (...args: Args) => R | Promise<R>) =>
12
+ return <Args extends unknown[], R>(name: string, fn: (...args: Args) => R | Promise<R>) =>
13
13
  async (...args: Args): Promise<R> => {
14
14
  try {
15
15
  return await fn(...args);
16
16
  } catch (error) {
17
17
  // El reporte vive acá y en ningún otro lado. Y solo llega si `fn` LANZA: una tool
18
18
  // que atrapa su propio error y devuelve un valor no pasa por acá.
19
- capturar(error, { workUnit: nombre });
19
+ capture(error, { workUnit: name });
20
20
  throw error;
21
21
  }
22
22
  };
@@ -1 +0,0 @@
1
- {"version":3,"file":"constantes.d.ts","sourceRoot":"","sources":["../../src/core/constantes.ts"],"names":[],"mappings":"AAAA;8DAC8D;AAC9D,eAAO,MAAM,UAAU,yCAAyC,CAAC;AAEjE,eAAO,MAAM,QAAQ,uBAAuB,CAAC;AAE7C,+FAA+F;AAC/F,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;iDACiD;AACjD,eAAO,MAAM,OAAO;;;;;CAKV,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"constantes.js","sourceRoot":"","sources":["../../src/core/constantes.ts"],"names":[],"mappings":"AAAA;8DAC8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,sCAAsC,CAAC;AAEjE,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAE7C,+FAA+F;AAC/F,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;iDACiD;AACjD,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,eAAe,EAAE,CAAC,GAAG,IAAI;IACzB,YAAY,EAAE,CAAC,GAAG,IAAI;IACtB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,GAAG,GAAG,IAAI;CACZ,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"contadores.d.ts","sourceRoot":"","sources":["../../src/core/contadores.ts"],"names":[],"mappings":"AAAA;;0DAE0D;AAC1D,MAAM,WAAW,KAAK;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAWD,wCAAwC;AACxC,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,qCAAqC;AACrC,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;oDAEoD;AACpD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;uFACuF;AACvF,wBAAgB,KAAK,IAAI,KAAK,CAQ7B;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
@@ -1,53 +0,0 @@
1
- const stats = {
2
- disparados: 0,
3
- completados: 0,
4
- fallados: 0,
5
- before_send: 0,
6
- recortados: 0,
7
- internos: 0,
8
- };
9
- /** Veces que el código pidió enviar. */
10
- export function contarDisparado() {
11
- stats.disparados += 1;
12
- }
13
- /** Envíos que terminaron, con cualquier status: un 429 y un 503 salieron y los rechazaron. */
14
- export function contarCompletado() {
15
- stats.completados += 1;
16
- }
17
- /** Envíos que lanzaron: red, DNS. */
18
- export function contarFallado() {
19
- stats.fallados += 1;
20
- }
21
- export function contarBeforeSend() {
22
- stats.before_send += 1;
23
- }
24
- export function contarRecortado() {
25
- stats.recortados += 1;
26
- }
27
- /** La quinta forma de perder un evento: algo entre `armarEvento` y `serializarAcotado` lanzó, y la
28
- * red del `catch` de `capturar` lo atrapó. Sin este contador, ese evento desaparecía sin dejar
29
- * rastro en ningún `drops` del sobre siguiente. */
30
- export function contarInterno() {
31
- stats.internos += 1;
32
- }
33
- /** `incompletos` es la resta, y es el único contador que prueba pérdida por ciclo de vida: sin
34
- * esta separación, un 429 por rate limit y "se perdió el evento" se ven idénticos. */
35
- export function drops() {
36
- return {
37
- incompletos: stats.disparados - stats.completados - stats.fallados,
38
- fallados: stats.fallados,
39
- before_send: stats.before_send,
40
- recortados: stats.recortados,
41
- internos: stats.internos,
42
- };
43
- }
44
- /** Solo para los tests. No sale por ninguna puerta del `exports` map. */
45
- export function reiniciarContadores() {
46
- stats.disparados = 0;
47
- stats.completados = 0;
48
- stats.fallados = 0;
49
- stats.before_send = 0;
50
- stats.recortados = 0;
51
- stats.internos = 0;
52
- }
53
- //# sourceMappingURL=contadores.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"contadores.js","sourceRoot":"","sources":["../../src/core/contadores.ts"],"names":[],"mappings":"AAWA,MAAM,KAAK,GAAG;IACb,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC;CACX,CAAC;AAEF,wCAAwC;AACxC,MAAM,UAAU,eAAe;IAC9B,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,gBAAgB;IAC/B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,aAAa;IAC5B,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC/B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,eAAe;IAC9B,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;oDAEoD;AACpD,MAAM,UAAU,aAAa;IAC5B,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;AACrB,CAAC;AAED;uFACuF;AACvF,MAAM,UAAU,KAAK;IACpB,OAAO;QACN,WAAW,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,QAAQ;QAClE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACxB,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB;IAClC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IACrB,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;IACtB,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;IACnB,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;IACtB,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IACrB,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;AACpB,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"sesion.d.ts","sourceRoot":"","sources":["../../src/core/sesion.ts"],"names":[],"mappings":"AAGA;yDACyD;AACzD,wBAAgB,OAAO,IAAI,MAAM,CAGhC;AAED;+DAC+D;AAC/D,wBAAgB,OAAO,IAAI,MAAM,CAGhC;AAED,yEAAyE;AACzE,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"sesion.js","sourceRoot":"","sources":["../../src/core/sesion.ts"],"names":[],"mappings":"AAAA,IAAI,QAAQ,GAAkB,IAAI,CAAC;AACnC,IAAI,IAAI,GAAG,CAAC,CAAC;AAEb;yDACyD;AACzD,MAAM,UAAU,OAAO;IACtB,gGAAgG;IAChG,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,OAAO;IACtB,IAAI,IAAI,CAAC,CAAC;IACV,OAAO,IAAI,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe;IAC9B,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,GAAG,CAAC,CAAC;AACV,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"sobre.d.ts","sourceRoot":"","sources":["../../src/core/sobre.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,cAAc,EACd,QAAQ,EACR,MAAM,EACN,SAAS,EACT,QAAQ,EACR,OAAO,EACP,cAAc,EACd,MAAM,YAAY,CAAC;AAEpB,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAOD;uCACuC;AACvC,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,GAC1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAIvD;AAWD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,CAW5E;AASD;;sDAEsD;AACtD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,CASxF;AAQD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAaxF;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,QAAQ,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAmD5D;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED;yDACyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAiBpD;AAED;;sCAEsC;AACtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAyCvF"}