@rawdash/core 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/index.d.ts +821 -191
  2. package/dist/index.js +672 -33
  3. package/dist/index.js.map +1 -1
  4. package/dist/libsql.d.ts +23 -0
  5. package/dist/libsql.js +509 -0
  6. package/dist/libsql.js.map +1 -0
  7. package/dist/server-storage-BGSLkDoF.d.ts +209 -0
  8. package/package.json +22 -8
  9. package/LICENSE +0 -202
package/dist/index.d.ts CHANGED
@@ -1,176 +1,7 @@
1
+ import { E as Event, M as Metric, D as Distribution, S as StorageHandle, C as Connector, a as ServerStorage, W as WidgetEntry, b as SyncState } from './server-storage-BGSLkDoF.js';
2
+ export { B as BaseConnector, c as CredentialEntry, d as CredentialSchema, e as DistributionQuery, f as Edge, g as EdgeQuery, h as Entity, i as EntityQuery, j as EnvSecretsResolver, k as EventQuery, I as InferCredentialInput, l as InferCredentials, J as JSONValue, m as MetricQuery, n as SecretRef, o as SecretsResolver, p as SyncRequest, q as defineConnector, r as isSecretRef, s as resolveSecretRefs, t as secret } from './server-storage-BGSLkDoF.js';
1
3
  import { z } from 'zod';
2
4
 
3
- type SecretRef = {
4
- $secret: string;
5
- };
6
- declare function secret(name: string): SecretRef;
7
- declare function isSecretRef(value: unknown): value is SecretRef;
8
- interface SecretsResolver {
9
- resolve(name: string): string | undefined;
10
- }
11
- declare class EnvSecretsResolver implements SecretsResolver {
12
- resolve(name: string): string | undefined;
13
- }
14
- declare function resolveSecretRefs<T>(obj: T, resolver: SecretsResolver): T;
15
-
16
- type JSONValue = string | number | boolean | null | JSONValue[] | {
17
- [key: string]: JSONValue;
18
- };
19
- interface Event {
20
- name: string;
21
- start_ts: number;
22
- end_ts: number | null;
23
- attributes: Record<string, JSONValue>;
24
- }
25
- interface Entity {
26
- type: string;
27
- id: string;
28
- attributes: Record<string, JSONValue>;
29
- updated_at: number;
30
- }
31
- interface Metric {
32
- name: string;
33
- ts: number;
34
- value: number;
35
- attributes: Record<string, JSONValue>;
36
- }
37
- interface Edge {
38
- from_type: string;
39
- from_id: string;
40
- kind: string;
41
- to_type: string;
42
- to_id: string;
43
- attributes: Record<string, JSONValue>;
44
- updated_at: number;
45
- }
46
- type Distribution = {
47
- name: string;
48
- ts: number;
49
- kind: 'histogram';
50
- data: {
51
- buckets: Array<{
52
- le: number;
53
- count: number;
54
- }>;
55
- count: number;
56
- sum: number;
57
- };
58
- attributes: Record<string, JSONValue>;
59
- } | {
60
- name: string;
61
- ts: number;
62
- kind: 'summary';
63
- data: {
64
- quantiles: Array<{
65
- q: number;
66
- value: number;
67
- }>;
68
- count: number;
69
- sum: number;
70
- };
71
- attributes: Record<string, JSONValue>;
72
- };
73
- interface EventQuery {
74
- name?: string;
75
- start?: number;
76
- end?: number;
77
- }
78
- interface EntityQuery {
79
- type: string;
80
- }
81
- interface MetricQuery {
82
- name?: string;
83
- start?: number;
84
- end?: number;
85
- }
86
- interface EdgeQuery {
87
- fromType?: string;
88
- fromId?: string;
89
- kind?: string;
90
- toType?: string;
91
- toId?: string;
92
- }
93
- interface DistributionQuery {
94
- name?: string;
95
- start?: number;
96
- end?: number;
97
- }
98
- interface StorageHandle {
99
- event(e: Event): Promise<void>;
100
- entity(e: Entity): Promise<void>;
101
- metric(m: Metric): Promise<void>;
102
- edge(e: Edge): Promise<void>;
103
- distribution(d: Distribution): Promise<void>;
104
- events(es: Event[], scope?: {
105
- names?: string[];
106
- }): Promise<void>;
107
- entities(es: Entity[], scope?: {
108
- types?: string[];
109
- }): Promise<void>;
110
- metrics(ms: Metric[], scope?: {
111
- names?: string[];
112
- }): Promise<void>;
113
- edges(es: Edge[], scope?: {
114
- kinds?: string[];
115
- }): Promise<void>;
116
- distributions(ds: Distribution[], scope?: {
117
- names?: string[];
118
- }): Promise<void>;
119
- queryEvents(q: EventQuery): Promise<Event[]>;
120
- getEntity(type: string, id: string): Promise<Entity | null>;
121
- queryEntities(q: EntityQuery): Promise<Entity[]>;
122
- queryMetrics(q: MetricQuery): Promise<Metric[]>;
123
- traverse(q: EdgeQuery): Promise<Edge[]>;
124
- queryDistributions(q: DistributionQuery): Promise<Distribution[]>;
125
- deleteOlderThan(shape: 'events' | 'metrics' | 'distributions', tsUnixMs: number): Promise<{
126
- rowsDeleted: number;
127
- }>;
128
- }
129
- interface CredentialEntry {
130
- description: string;
131
- auth?: 'none' | 'optional' | 'required';
132
- }
133
- type CredentialSchema = Record<string, CredentialEntry>;
134
- type InferCredentials<TCreds extends CredentialSchema> = {
135
- [K in keyof TCreds]: TCreds[K] extends {
136
- auth: 'required';
137
- } ? string : string | undefined;
138
- };
139
- type InferCredentialInput<TCreds extends CredentialSchema> = {
140
- [K in keyof TCreds]: TCreds[K] extends {
141
- auth: 'required';
142
- } ? string | SecretRef : string | SecretRef | undefined;
143
- };
144
- interface SyncRequest {
145
- mode: 'full' | 'latest';
146
- since?: string;
147
- }
148
- interface Connector {
149
- readonly id: string;
150
- readonly credentials?: CredentialSchema;
151
- sync(request: SyncRequest, storage: StorageHandle, signal?: AbortSignal): Promise<void>;
152
- }
153
- declare abstract class BaseConnector<TSettings = unknown, TCreds extends CredentialSchema = CredentialSchema> implements Connector {
154
- abstract readonly id: string;
155
- readonly credentials?: TCreds;
156
- protected settings: TSettings;
157
- protected creds: InferCredentials<TCreds>;
158
- constructor(settings: TSettings, creds?: InferCredentialInput<TCreds>);
159
- abstract sync(request: SyncRequest, storage: StorageHandle, signal?: AbortSignal): Promise<void>;
160
- }
161
- declare function defineConnector<TSettings>(): <TCreds extends CredentialSchema = Record<string, never>>(def: {
162
- id: string;
163
- credentials?: TCreds;
164
- sync: (this: {
165
- settings: TSettings;
166
- creds: InferCredentials<TCreds>;
167
- }, request: SyncRequest, storage: StorageHandle, signal?: AbortSignal) => Promise<void>;
168
- }) => {
169
- new (settings: TSettings, creds?: InferCredentialInput<TCreds>): Connector;
170
- readonly id: string;
171
- readonly credentials: TCreds | undefined;
172
- };
173
-
174
5
  interface RetentionConfig {
175
6
  maxAge?: number;
176
7
  maxSize?: number;
@@ -185,10 +16,368 @@ interface RetentionCandidates {
185
16
  declare function selectForDeletion<T>(rows: T[], getTs: (row: T) => number, config: RetentionConfig, nowMs?: number): T[];
186
17
  declare function computeRetention(handle: StorageHandle, config: RetentionConfig, nowMs?: number): Promise<RetentionCandidates>;
187
18
 
19
+ declare const shapeSchema: z.ZodEnum<{
20
+ event: "event";
21
+ entity: "entity";
22
+ metric: "metric";
23
+ edge: "edge";
24
+ distribution: "distribution";
25
+ }>;
26
+ declare const aggFnSchema: z.ZodEnum<{
27
+ latest: "latest";
28
+ count: "count";
29
+ sum: "sum";
30
+ avg: "avg";
31
+ min: "min";
32
+ max: "max";
33
+ first: "first";
34
+ }>;
35
+ declare const filterOperatorSchema: z.ZodEnum<{
36
+ eq: "eq";
37
+ neq: "neq";
38
+ gt: "gt";
39
+ gte: "gte";
40
+ lt: "lt";
41
+ lte: "lte";
42
+ contains: "contains";
43
+ }>;
44
+ declare const filterConditionSchema: z.ZodObject<{
45
+ field: z.ZodString;
46
+ op: z.ZodEnum<{
47
+ eq: "eq";
48
+ neq: "neq";
49
+ gt: "gt";
50
+ gte: "gte";
51
+ lt: "lt";
52
+ lte: "lte";
53
+ contains: "contains";
54
+ }>;
55
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
56
+ }, z.core.$strip>;
57
+ declare const filterClauseSchema: z.ZodUnion<readonly [z.ZodObject<{
58
+ field: z.ZodString;
59
+ op: z.ZodEnum<{
60
+ eq: "eq";
61
+ neq: "neq";
62
+ gt: "gt";
63
+ gte: "gte";
64
+ lt: "lt";
65
+ lte: "lte";
66
+ contains: "contains";
67
+ }>;
68
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
69
+ }, z.core.$strip>, z.ZodObject<{
70
+ or: z.ZodArray<z.ZodObject<{
71
+ field: z.ZodString;
72
+ op: z.ZodEnum<{
73
+ eq: "eq";
74
+ neq: "neq";
75
+ gt: "gt";
76
+ gte: "gte";
77
+ lt: "lt";
78
+ lte: "lte";
79
+ contains: "contains";
80
+ }>;
81
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
82
+ }, z.core.$strip>>;
83
+ }, z.core.$strip>]>;
84
+ declare const groupBySchema: z.ZodObject<{
85
+ field: z.ZodString;
86
+ granularity: z.ZodEnum<{
87
+ hour: "hour";
88
+ day: "day";
89
+ week: "week";
90
+ month: "month";
91
+ }>;
92
+ }, z.core.$strip>;
93
+ declare const resolvedMetricSchema: z.ZodObject<{
94
+ connectorId: z.ZodString;
95
+ shape: z.ZodEnum<{
96
+ event: "event";
97
+ entity: "entity";
98
+ metric: "metric";
99
+ edge: "edge";
100
+ distribution: "distribution";
101
+ }>;
102
+ name: z.ZodOptional<z.ZodString>;
103
+ entityType: z.ZodOptional<z.ZodString>;
104
+ field: z.ZodString;
105
+ fn: z.ZodString;
106
+ window: z.ZodOptional<z.ZodString>;
107
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
108
+ field: z.ZodString;
109
+ op: z.ZodEnum<{
110
+ eq: "eq";
111
+ neq: "neq";
112
+ gt: "gt";
113
+ gte: "gte";
114
+ lt: "lt";
115
+ lte: "lte";
116
+ contains: "contains";
117
+ }>;
118
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
119
+ }, z.core.$strip>, z.ZodObject<{
120
+ or: z.ZodArray<z.ZodObject<{
121
+ field: z.ZodString;
122
+ op: z.ZodEnum<{
123
+ eq: "eq";
124
+ neq: "neq";
125
+ gt: "gt";
126
+ gte: "gte";
127
+ lt: "lt";
128
+ lte: "lte";
129
+ contains: "contains";
130
+ }>;
131
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
132
+ }, z.core.$strip>>;
133
+ }, z.core.$strip>]>>>;
134
+ groupBy: z.ZodOptional<z.ZodObject<{
135
+ field: z.ZodString;
136
+ granularity: z.ZodEnum<{
137
+ hour: "hour";
138
+ day: "day";
139
+ week: "week";
140
+ month: "month";
141
+ }>;
142
+ }, z.core.$strip>>;
143
+ }, z.core.$strip>;
144
+ declare const statWidgetSchema: z.ZodObject<{
145
+ kind: z.ZodLiteral<"stat">;
146
+ title: z.ZodString;
147
+ metric: z.ZodObject<{
148
+ connectorId: z.ZodString;
149
+ shape: z.ZodEnum<{
150
+ event: "event";
151
+ entity: "entity";
152
+ metric: "metric";
153
+ edge: "edge";
154
+ distribution: "distribution";
155
+ }>;
156
+ name: z.ZodOptional<z.ZodString>;
157
+ entityType: z.ZodOptional<z.ZodString>;
158
+ field: z.ZodString;
159
+ fn: z.ZodString;
160
+ window: z.ZodOptional<z.ZodString>;
161
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
162
+ field: z.ZodString;
163
+ op: z.ZodEnum<{
164
+ eq: "eq";
165
+ neq: "neq";
166
+ gt: "gt";
167
+ gte: "gte";
168
+ lt: "lt";
169
+ lte: "lte";
170
+ contains: "contains";
171
+ }>;
172
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
173
+ }, z.core.$strip>, z.ZodObject<{
174
+ or: z.ZodArray<z.ZodObject<{
175
+ field: z.ZodString;
176
+ op: z.ZodEnum<{
177
+ eq: "eq";
178
+ neq: "neq";
179
+ gt: "gt";
180
+ gte: "gte";
181
+ lt: "lt";
182
+ lte: "lte";
183
+ contains: "contains";
184
+ }>;
185
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
186
+ }, z.core.$strip>>;
187
+ }, z.core.$strip>]>>>;
188
+ groupBy: z.ZodOptional<z.ZodObject<{
189
+ field: z.ZodString;
190
+ granularity: z.ZodEnum<{
191
+ hour: "hour";
192
+ day: "day";
193
+ week: "week";
194
+ month: "month";
195
+ }>;
196
+ }, z.core.$strip>>;
197
+ }, z.core.$strip>;
198
+ window: z.ZodOptional<z.ZodString>;
199
+ compare: z.ZodDefault<z.ZodEnum<{
200
+ none: "none";
201
+ "previous-period": "previous-period";
202
+ }>>;
203
+ }, z.core.$strip>;
204
+ declare const statusWidgetSchema: z.ZodObject<{
205
+ kind: z.ZodLiteral<"status">;
206
+ title: z.ZodString;
207
+ source: z.ZodString;
208
+ }, z.core.$strip>;
209
+ declare const timeseriesWidgetSchema: z.ZodObject<{
210
+ kind: z.ZodLiteral<"timeseries">;
211
+ title: z.ZodString;
212
+ metric: z.ZodObject<{
213
+ connectorId: z.ZodString;
214
+ shape: z.ZodEnum<{
215
+ event: "event";
216
+ entity: "entity";
217
+ metric: "metric";
218
+ edge: "edge";
219
+ distribution: "distribution";
220
+ }>;
221
+ name: z.ZodOptional<z.ZodString>;
222
+ entityType: z.ZodOptional<z.ZodString>;
223
+ field: z.ZodString;
224
+ fn: z.ZodString;
225
+ window: z.ZodOptional<z.ZodString>;
226
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
227
+ field: z.ZodString;
228
+ op: z.ZodEnum<{
229
+ eq: "eq";
230
+ neq: "neq";
231
+ gt: "gt";
232
+ gte: "gte";
233
+ lt: "lt";
234
+ lte: "lte";
235
+ contains: "contains";
236
+ }>;
237
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
238
+ }, z.core.$strip>, z.ZodObject<{
239
+ or: z.ZodArray<z.ZodObject<{
240
+ field: z.ZodString;
241
+ op: z.ZodEnum<{
242
+ eq: "eq";
243
+ neq: "neq";
244
+ gt: "gt";
245
+ gte: "gte";
246
+ lt: "lt";
247
+ lte: "lte";
248
+ contains: "contains";
249
+ }>;
250
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
251
+ }, z.core.$strip>>;
252
+ }, z.core.$strip>]>>>;
253
+ groupBy: z.ZodOptional<z.ZodObject<{
254
+ field: z.ZodString;
255
+ granularity: z.ZodEnum<{
256
+ hour: "hour";
257
+ day: "day";
258
+ week: "week";
259
+ month: "month";
260
+ }>;
261
+ }, z.core.$strip>>;
262
+ }, z.core.$strip>;
263
+ window: z.ZodString;
264
+ granularity: z.ZodDefault<z.ZodEnum<{
265
+ hour: "hour";
266
+ day: "day";
267
+ week: "week";
268
+ }>>;
269
+ }, z.core.$strip>;
270
+ declare const distributionWidgetSchema: z.ZodObject<{
271
+ kind: z.ZodLiteral<"distribution">;
272
+ title: z.ZodString;
273
+ metric: z.ZodObject<{
274
+ connectorId: z.ZodString;
275
+ shape: z.ZodEnum<{
276
+ event: "event";
277
+ entity: "entity";
278
+ metric: "metric";
279
+ edge: "edge";
280
+ distribution: "distribution";
281
+ }>;
282
+ name: z.ZodOptional<z.ZodString>;
283
+ entityType: z.ZodOptional<z.ZodString>;
284
+ field: z.ZodString;
285
+ fn: z.ZodString;
286
+ window: z.ZodOptional<z.ZodString>;
287
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
288
+ field: z.ZodString;
289
+ op: z.ZodEnum<{
290
+ eq: "eq";
291
+ neq: "neq";
292
+ gt: "gt";
293
+ gte: "gte";
294
+ lt: "lt";
295
+ lte: "lte";
296
+ contains: "contains";
297
+ }>;
298
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
299
+ }, z.core.$strip>, z.ZodObject<{
300
+ or: z.ZodArray<z.ZodObject<{
301
+ field: z.ZodString;
302
+ op: z.ZodEnum<{
303
+ eq: "eq";
304
+ neq: "neq";
305
+ gt: "gt";
306
+ gte: "gte";
307
+ lt: "lt";
308
+ lte: "lte";
309
+ contains: "contains";
310
+ }>;
311
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
312
+ }, z.core.$strip>>;
313
+ }, z.core.$strip>]>>>;
314
+ groupBy: z.ZodOptional<z.ZodObject<{
315
+ field: z.ZodString;
316
+ granularity: z.ZodEnum<{
317
+ hour: "hour";
318
+ day: "day";
319
+ week: "week";
320
+ month: "month";
321
+ }>;
322
+ }, z.core.$strip>>;
323
+ }, z.core.$strip>;
324
+ window: z.ZodString;
325
+ }, z.core.$strip>;
188
326
  declare const widgetSchemas: {
189
327
  readonly stat: z.ZodObject<{
328
+ kind: z.ZodLiteral<"stat">;
190
329
  title: z.ZodString;
191
- metric: z.ZodString;
330
+ metric: z.ZodObject<{
331
+ connectorId: z.ZodString;
332
+ shape: z.ZodEnum<{
333
+ event: "event";
334
+ entity: "entity";
335
+ metric: "metric";
336
+ edge: "edge";
337
+ distribution: "distribution";
338
+ }>;
339
+ name: z.ZodOptional<z.ZodString>;
340
+ entityType: z.ZodOptional<z.ZodString>;
341
+ field: z.ZodString;
342
+ fn: z.ZodString;
343
+ window: z.ZodOptional<z.ZodString>;
344
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
345
+ field: z.ZodString;
346
+ op: z.ZodEnum<{
347
+ eq: "eq";
348
+ neq: "neq";
349
+ gt: "gt";
350
+ gte: "gte";
351
+ lt: "lt";
352
+ lte: "lte";
353
+ contains: "contains";
354
+ }>;
355
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
356
+ }, z.core.$strip>, z.ZodObject<{
357
+ or: z.ZodArray<z.ZodObject<{
358
+ field: z.ZodString;
359
+ op: z.ZodEnum<{
360
+ eq: "eq";
361
+ neq: "neq";
362
+ gt: "gt";
363
+ gte: "gte";
364
+ lt: "lt";
365
+ lte: "lte";
366
+ contains: "contains";
367
+ }>;
368
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
369
+ }, z.core.$strip>>;
370
+ }, z.core.$strip>]>>>;
371
+ groupBy: z.ZodOptional<z.ZodObject<{
372
+ field: z.ZodString;
373
+ granularity: z.ZodEnum<{
374
+ hour: "hour";
375
+ day: "day";
376
+ week: "week";
377
+ month: "month";
378
+ }>;
379
+ }, z.core.$strip>>;
380
+ }, z.core.$strip>;
192
381
  window: z.ZodOptional<z.ZodString>;
193
382
  compare: z.ZodDefault<z.ZodEnum<{
194
383
  none: "none";
@@ -196,12 +385,64 @@ declare const widgetSchemas: {
196
385
  }>>;
197
386
  }, z.core.$strip>;
198
387
  readonly status: z.ZodObject<{
388
+ kind: z.ZodLiteral<"status">;
199
389
  title: z.ZodString;
200
390
  source: z.ZodString;
201
391
  }, z.core.$strip>;
202
392
  readonly timeseries: z.ZodObject<{
393
+ kind: z.ZodLiteral<"timeseries">;
203
394
  title: z.ZodString;
204
- metric: z.ZodString;
395
+ metric: z.ZodObject<{
396
+ connectorId: z.ZodString;
397
+ shape: z.ZodEnum<{
398
+ event: "event";
399
+ entity: "entity";
400
+ metric: "metric";
401
+ edge: "edge";
402
+ distribution: "distribution";
403
+ }>;
404
+ name: z.ZodOptional<z.ZodString>;
405
+ entityType: z.ZodOptional<z.ZodString>;
406
+ field: z.ZodString;
407
+ fn: z.ZodString;
408
+ window: z.ZodOptional<z.ZodString>;
409
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
410
+ field: z.ZodString;
411
+ op: z.ZodEnum<{
412
+ eq: "eq";
413
+ neq: "neq";
414
+ gt: "gt";
415
+ gte: "gte";
416
+ lt: "lt";
417
+ lte: "lte";
418
+ contains: "contains";
419
+ }>;
420
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
421
+ }, z.core.$strip>, z.ZodObject<{
422
+ or: z.ZodArray<z.ZodObject<{
423
+ field: z.ZodString;
424
+ op: z.ZodEnum<{
425
+ eq: "eq";
426
+ neq: "neq";
427
+ gt: "gt";
428
+ gte: "gte";
429
+ lt: "lt";
430
+ lte: "lte";
431
+ contains: "contains";
432
+ }>;
433
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
434
+ }, z.core.$strip>>;
435
+ }, z.core.$strip>]>>>;
436
+ groupBy: z.ZodOptional<z.ZodObject<{
437
+ field: z.ZodString;
438
+ granularity: z.ZodEnum<{
439
+ hour: "hour";
440
+ day: "day";
441
+ week: "week";
442
+ month: "month";
443
+ }>;
444
+ }, z.core.$strip>>;
445
+ }, z.core.$strip>;
205
446
  window: z.ZodString;
206
447
  granularity: z.ZodDefault<z.ZodEnum<{
207
448
  hour: "hour";
@@ -210,26 +451,359 @@ declare const widgetSchemas: {
210
451
  }>>;
211
452
  }, z.core.$strip>;
212
453
  readonly distribution: z.ZodObject<{
454
+ kind: z.ZodLiteral<"distribution">;
213
455
  title: z.ZodString;
214
- metric: z.ZodString;
456
+ metric: z.ZodObject<{
457
+ connectorId: z.ZodString;
458
+ shape: z.ZodEnum<{
459
+ event: "event";
460
+ entity: "entity";
461
+ metric: "metric";
462
+ edge: "edge";
463
+ distribution: "distribution";
464
+ }>;
465
+ name: z.ZodOptional<z.ZodString>;
466
+ entityType: z.ZodOptional<z.ZodString>;
467
+ field: z.ZodString;
468
+ fn: z.ZodString;
469
+ window: z.ZodOptional<z.ZodString>;
470
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
471
+ field: z.ZodString;
472
+ op: z.ZodEnum<{
473
+ eq: "eq";
474
+ neq: "neq";
475
+ gt: "gt";
476
+ gte: "gte";
477
+ lt: "lt";
478
+ lte: "lte";
479
+ contains: "contains";
480
+ }>;
481
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
482
+ }, z.core.$strip>, z.ZodObject<{
483
+ or: z.ZodArray<z.ZodObject<{
484
+ field: z.ZodString;
485
+ op: z.ZodEnum<{
486
+ eq: "eq";
487
+ neq: "neq";
488
+ gt: "gt";
489
+ gte: "gte";
490
+ lt: "lt";
491
+ lte: "lte";
492
+ contains: "contains";
493
+ }>;
494
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
495
+ }, z.core.$strip>>;
496
+ }, z.core.$strip>]>>>;
497
+ groupBy: z.ZodOptional<z.ZodObject<{
498
+ field: z.ZodString;
499
+ granularity: z.ZodEnum<{
500
+ hour: "hour";
501
+ day: "day";
502
+ week: "week";
503
+ month: "month";
504
+ }>;
505
+ }, z.core.$strip>>;
506
+ }, z.core.$strip>;
215
507
  window: z.ZodString;
216
508
  }, z.core.$strip>;
217
509
  };
510
+ declare const widgetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
511
+ kind: z.ZodLiteral<"stat">;
512
+ title: z.ZodString;
513
+ metric: z.ZodObject<{
514
+ connectorId: z.ZodString;
515
+ shape: z.ZodEnum<{
516
+ event: "event";
517
+ entity: "entity";
518
+ metric: "metric";
519
+ edge: "edge";
520
+ distribution: "distribution";
521
+ }>;
522
+ name: z.ZodOptional<z.ZodString>;
523
+ entityType: z.ZodOptional<z.ZodString>;
524
+ field: z.ZodString;
525
+ fn: z.ZodString;
526
+ window: z.ZodOptional<z.ZodString>;
527
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
528
+ field: z.ZodString;
529
+ op: z.ZodEnum<{
530
+ eq: "eq";
531
+ neq: "neq";
532
+ gt: "gt";
533
+ gte: "gte";
534
+ lt: "lt";
535
+ lte: "lte";
536
+ contains: "contains";
537
+ }>;
538
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
539
+ }, z.core.$strip>, z.ZodObject<{
540
+ or: z.ZodArray<z.ZodObject<{
541
+ field: z.ZodString;
542
+ op: z.ZodEnum<{
543
+ eq: "eq";
544
+ neq: "neq";
545
+ gt: "gt";
546
+ gte: "gte";
547
+ lt: "lt";
548
+ lte: "lte";
549
+ contains: "contains";
550
+ }>;
551
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
552
+ }, z.core.$strip>>;
553
+ }, z.core.$strip>]>>>;
554
+ groupBy: z.ZodOptional<z.ZodObject<{
555
+ field: z.ZodString;
556
+ granularity: z.ZodEnum<{
557
+ hour: "hour";
558
+ day: "day";
559
+ week: "week";
560
+ month: "month";
561
+ }>;
562
+ }, z.core.$strip>>;
563
+ }, z.core.$strip>;
564
+ window: z.ZodOptional<z.ZodString>;
565
+ compare: z.ZodDefault<z.ZodEnum<{
566
+ none: "none";
567
+ "previous-period": "previous-period";
568
+ }>>;
569
+ }, z.core.$strip>, z.ZodObject<{
570
+ kind: z.ZodLiteral<"status">;
571
+ title: z.ZodString;
572
+ source: z.ZodString;
573
+ }, z.core.$strip>, z.ZodObject<{
574
+ kind: z.ZodLiteral<"timeseries">;
575
+ title: z.ZodString;
576
+ metric: z.ZodObject<{
577
+ connectorId: z.ZodString;
578
+ shape: z.ZodEnum<{
579
+ event: "event";
580
+ entity: "entity";
581
+ metric: "metric";
582
+ edge: "edge";
583
+ distribution: "distribution";
584
+ }>;
585
+ name: z.ZodOptional<z.ZodString>;
586
+ entityType: z.ZodOptional<z.ZodString>;
587
+ field: z.ZodString;
588
+ fn: z.ZodString;
589
+ window: z.ZodOptional<z.ZodString>;
590
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
591
+ field: z.ZodString;
592
+ op: z.ZodEnum<{
593
+ eq: "eq";
594
+ neq: "neq";
595
+ gt: "gt";
596
+ gte: "gte";
597
+ lt: "lt";
598
+ lte: "lte";
599
+ contains: "contains";
600
+ }>;
601
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
602
+ }, z.core.$strip>, z.ZodObject<{
603
+ or: z.ZodArray<z.ZodObject<{
604
+ field: z.ZodString;
605
+ op: z.ZodEnum<{
606
+ eq: "eq";
607
+ neq: "neq";
608
+ gt: "gt";
609
+ gte: "gte";
610
+ lt: "lt";
611
+ lte: "lte";
612
+ contains: "contains";
613
+ }>;
614
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
615
+ }, z.core.$strip>>;
616
+ }, z.core.$strip>]>>>;
617
+ groupBy: z.ZodOptional<z.ZodObject<{
618
+ field: z.ZodString;
619
+ granularity: z.ZodEnum<{
620
+ hour: "hour";
621
+ day: "day";
622
+ week: "week";
623
+ month: "month";
624
+ }>;
625
+ }, z.core.$strip>>;
626
+ }, z.core.$strip>;
627
+ window: z.ZodString;
628
+ granularity: z.ZodDefault<z.ZodEnum<{
629
+ hour: "hour";
630
+ day: "day";
631
+ week: "week";
632
+ }>>;
633
+ }, z.core.$strip>, z.ZodObject<{
634
+ kind: z.ZodLiteral<"distribution">;
635
+ title: z.ZodString;
636
+ metric: z.ZodObject<{
637
+ connectorId: z.ZodString;
638
+ shape: z.ZodEnum<{
639
+ event: "event";
640
+ entity: "entity";
641
+ metric: "metric";
642
+ edge: "edge";
643
+ distribution: "distribution";
644
+ }>;
645
+ name: z.ZodOptional<z.ZodString>;
646
+ entityType: z.ZodOptional<z.ZodString>;
647
+ field: z.ZodString;
648
+ fn: z.ZodString;
649
+ window: z.ZodOptional<z.ZodString>;
650
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
651
+ field: z.ZodString;
652
+ op: z.ZodEnum<{
653
+ eq: "eq";
654
+ neq: "neq";
655
+ gt: "gt";
656
+ gte: "gte";
657
+ lt: "lt";
658
+ lte: "lte";
659
+ contains: "contains";
660
+ }>;
661
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
662
+ }, z.core.$strip>, z.ZodObject<{
663
+ or: z.ZodArray<z.ZodObject<{
664
+ field: z.ZodString;
665
+ op: z.ZodEnum<{
666
+ eq: "eq";
667
+ neq: "neq";
668
+ gt: "gt";
669
+ gte: "gte";
670
+ lt: "lt";
671
+ lte: "lte";
672
+ contains: "contains";
673
+ }>;
674
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
675
+ }, z.core.$strip>>;
676
+ }, z.core.$strip>]>>>;
677
+ groupBy: z.ZodOptional<z.ZodObject<{
678
+ field: z.ZodString;
679
+ granularity: z.ZodEnum<{
680
+ hour: "hour";
681
+ day: "day";
682
+ week: "week";
683
+ month: "month";
684
+ }>;
685
+ }, z.core.$strip>>;
686
+ }, z.core.$strip>;
687
+ window: z.ZodString;
688
+ }, z.core.$strip>], "kind">;
218
689
  type WidgetKind = keyof typeof widgetSchemas;
219
690
  declare function getWidgetSchema(kind: WidgetKind): z.ZodObject<{
691
+ kind: z.ZodLiteral<"stat">;
220
692
  title: z.ZodString;
221
- metric: z.ZodString;
693
+ metric: z.ZodObject<{
694
+ connectorId: z.ZodString;
695
+ shape: z.ZodEnum<{
696
+ event: "event";
697
+ entity: "entity";
698
+ metric: "metric";
699
+ edge: "edge";
700
+ distribution: "distribution";
701
+ }>;
702
+ name: z.ZodOptional<z.ZodString>;
703
+ entityType: z.ZodOptional<z.ZodString>;
704
+ field: z.ZodString;
705
+ fn: z.ZodString;
706
+ window: z.ZodOptional<z.ZodString>;
707
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
708
+ field: z.ZodString;
709
+ op: z.ZodEnum<{
710
+ eq: "eq";
711
+ neq: "neq";
712
+ gt: "gt";
713
+ gte: "gte";
714
+ lt: "lt";
715
+ lte: "lte";
716
+ contains: "contains";
717
+ }>;
718
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
719
+ }, z.core.$strip>, z.ZodObject<{
720
+ or: z.ZodArray<z.ZodObject<{
721
+ field: z.ZodString;
722
+ op: z.ZodEnum<{
723
+ eq: "eq";
724
+ neq: "neq";
725
+ gt: "gt";
726
+ gte: "gte";
727
+ lt: "lt";
728
+ lte: "lte";
729
+ contains: "contains";
730
+ }>;
731
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
732
+ }, z.core.$strip>>;
733
+ }, z.core.$strip>]>>>;
734
+ groupBy: z.ZodOptional<z.ZodObject<{
735
+ field: z.ZodString;
736
+ granularity: z.ZodEnum<{
737
+ hour: "hour";
738
+ day: "day";
739
+ week: "week";
740
+ month: "month";
741
+ }>;
742
+ }, z.core.$strip>>;
743
+ }, z.core.$strip>;
222
744
  window: z.ZodOptional<z.ZodString>;
223
745
  compare: z.ZodDefault<z.ZodEnum<{
224
746
  none: "none";
225
747
  "previous-period": "previous-period";
226
748
  }>>;
227
749
  }, z.core.$strip> | z.ZodObject<{
750
+ kind: z.ZodLiteral<"status">;
228
751
  title: z.ZodString;
229
752
  source: z.ZodString;
230
753
  }, z.core.$strip> | z.ZodObject<{
754
+ kind: z.ZodLiteral<"timeseries">;
231
755
  title: z.ZodString;
232
- metric: z.ZodString;
756
+ metric: z.ZodObject<{
757
+ connectorId: z.ZodString;
758
+ shape: z.ZodEnum<{
759
+ event: "event";
760
+ entity: "entity";
761
+ metric: "metric";
762
+ edge: "edge";
763
+ distribution: "distribution";
764
+ }>;
765
+ name: z.ZodOptional<z.ZodString>;
766
+ entityType: z.ZodOptional<z.ZodString>;
767
+ field: z.ZodString;
768
+ fn: z.ZodString;
769
+ window: z.ZodOptional<z.ZodString>;
770
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
771
+ field: z.ZodString;
772
+ op: z.ZodEnum<{
773
+ eq: "eq";
774
+ neq: "neq";
775
+ gt: "gt";
776
+ gte: "gte";
777
+ lt: "lt";
778
+ lte: "lte";
779
+ contains: "contains";
780
+ }>;
781
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
782
+ }, z.core.$strip>, z.ZodObject<{
783
+ or: z.ZodArray<z.ZodObject<{
784
+ field: z.ZodString;
785
+ op: z.ZodEnum<{
786
+ eq: "eq";
787
+ neq: "neq";
788
+ gt: "gt";
789
+ gte: "gte";
790
+ lt: "lt";
791
+ lte: "lte";
792
+ contains: "contains";
793
+ }>;
794
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
795
+ }, z.core.$strip>>;
796
+ }, z.core.$strip>]>>>;
797
+ groupBy: z.ZodOptional<z.ZodObject<{
798
+ field: z.ZodString;
799
+ granularity: z.ZodEnum<{
800
+ hour: "hour";
801
+ day: "day";
802
+ week: "week";
803
+ month: "month";
804
+ }>;
805
+ }, z.core.$strip>>;
806
+ }, z.core.$strip>;
233
807
  window: z.ZodString;
234
808
  granularity: z.ZodDefault<z.ZodEnum<{
235
809
  hour: "hour";
@@ -237,8 +811,59 @@ declare function getWidgetSchema(kind: WidgetKind): z.ZodObject<{
237
811
  week: "week";
238
812
  }>>;
239
813
  }, z.core.$strip> | z.ZodObject<{
814
+ kind: z.ZodLiteral<"distribution">;
240
815
  title: z.ZodString;
241
- metric: z.ZodString;
816
+ metric: z.ZodObject<{
817
+ connectorId: z.ZodString;
818
+ shape: z.ZodEnum<{
819
+ event: "event";
820
+ entity: "entity";
821
+ metric: "metric";
822
+ edge: "edge";
823
+ distribution: "distribution";
824
+ }>;
825
+ name: z.ZodOptional<z.ZodString>;
826
+ entityType: z.ZodOptional<z.ZodString>;
827
+ field: z.ZodString;
828
+ fn: z.ZodString;
829
+ window: z.ZodOptional<z.ZodString>;
830
+ filter: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
831
+ field: z.ZodString;
832
+ op: z.ZodEnum<{
833
+ eq: "eq";
834
+ neq: "neq";
835
+ gt: "gt";
836
+ gte: "gte";
837
+ lt: "lt";
838
+ lte: "lte";
839
+ contains: "contains";
840
+ }>;
841
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
842
+ }, z.core.$strip>, z.ZodObject<{
843
+ or: z.ZodArray<z.ZodObject<{
844
+ field: z.ZodString;
845
+ op: z.ZodEnum<{
846
+ eq: "eq";
847
+ neq: "neq";
848
+ gt: "gt";
849
+ gte: "gte";
850
+ lt: "lt";
851
+ lte: "lte";
852
+ contains: "contains";
853
+ }>;
854
+ value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
855
+ }, z.core.$strip>>;
856
+ }, z.core.$strip>]>>>;
857
+ groupBy: z.ZodOptional<z.ZodObject<{
858
+ field: z.ZodString;
859
+ granularity: z.ZodEnum<{
860
+ hour: "hour";
861
+ day: "day";
862
+ week: "week";
863
+ month: "month";
864
+ }>;
865
+ }, z.core.$strip>>;
866
+ }, z.core.$strip>;
242
867
  window: z.ZodString;
243
868
  }, z.core.$strip>;
244
869
 
@@ -325,20 +950,25 @@ declare function defineDashboard(options: {
325
950
  declare function defineMetric(options: MetricDef): ResolvedMetric;
326
951
  declare function defineConfig(config: DashboardConfig): DashboardConfig;
327
952
 
328
- interface WidgetEntry {
329
- id: string;
330
- widgetId: string;
331
- connectorId: string;
332
- data: unknown;
333
- cachedAt: string | null;
334
- }
335
- interface SyncState {
336
- status: 'idle' | 'syncing' | 'error';
337
- lastSyncAt: string | null;
338
- lastError: string | null;
339
- }
340
-
341
953
  type ConfigFieldsSchema = z.ZodObject<z.ZodRawShape>;
342
954
  declare function defineConfigFields<T extends z.ZodRawShape>(schema: z.ZodObject<T>): z.ZodObject<T>;
343
955
 
344
- export { type AggFn, BaseConnector, type ConfigFieldsSchema, type Connector, type ConnectorEntry, type CredentialEntry, type CredentialSchema, type Dashboard, type DashboardConfig, type Distribution, type DistributionQuery, type DistributionWidget, type Edge, type EdgeQuery, type Entity, type EntityQuery, EnvSecretsResolver, type Event, type EventQuery, type FilterClause, type FilterCondition, type FilterOperator, type GroupBy, type InferCredentialInput, type InferCredentials, type JSONValue, type Metric, type MetricDef, type MetricQuery, type ResolvedMetric, type RetentionCandidates, type RetentionConfig, type SecretRef, type SecretsResolver, type Shape, type StatWidget, type StatusWidget, type StorageHandle, type SyncRequest, type SyncState, type TimeseriesWidget, type Widget, type WidgetEntry, type WidgetKind, computeRetention, defineConfig, defineConfigFields, defineConnector, defineDashboard, defineMetric, getWidgetSchema, isSecretRef, resolveSecretRefs, secret, selectForDeletion, widgetSchemas };
956
+ declare function computeMetric(storage: StorageHandle, metric: ResolvedMetric): Promise<unknown>;
957
+
958
+ declare function resolveWidget(id: string, widget: Widget, connectors: ConnectorEntry[], storage: ServerStorage): Promise<WidgetEntry | undefined>;
959
+
960
+ declare class InMemoryStorage implements ServerStorage {
961
+ private eventStore;
962
+ private entityStore;
963
+ private metricStore;
964
+ private edgeStore;
965
+ private distributionStore;
966
+ private syncState;
967
+ getStorageHandle(connectorId: string): StorageHandle;
968
+ getSyncState(): Promise<SyncState>;
969
+ setSyncing(): Promise<boolean>;
970
+ setSyncSuccess(): Promise<void>;
971
+ setSyncError(error: string): Promise<void>;
972
+ }
973
+
974
+ export { type AggFn, type ConfigFieldsSchema, Connector, type ConnectorEntry, type Dashboard, type DashboardConfig, Distribution, type DistributionWidget, Event, type FilterClause, type FilterCondition, type FilterOperator, type GroupBy, InMemoryStorage, Metric, type MetricDef, type ResolvedMetric, type RetentionCandidates, type RetentionConfig, ServerStorage, type Shape, type StatWidget, type StatusWidget, StorageHandle, SyncState, type TimeseriesWidget, type Widget, WidgetEntry, type WidgetKind, aggFnSchema, computeMetric, computeRetention, defineConfig, defineConfigFields, defineDashboard, defineMetric, distributionWidgetSchema, filterClauseSchema, filterConditionSchema, filterOperatorSchema, getWidgetSchema, groupBySchema, resolveWidget, resolvedMetricSchema, selectForDeletion, shapeSchema, statWidgetSchema, statusWidgetSchema, timeseriesWidgetSchema, widgetSchema, widgetSchemas };