@tinyshed/tinystore 0.1.0 → 0.2.0-rc.1

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 (71) hide show
  1. package/dist/blobs.d.ts +1 -1
  2. package/dist/blobs.js +13 -5
  3. package/dist/cancel.d.ts +16 -2
  4. package/dist/cancel.js +36 -2
  5. package/dist/channels.js +20 -6
  6. package/dist/config.d.ts +49 -1
  7. package/dist/config.js +86 -7
  8. package/dist/connection.d.ts +52 -10
  9. package/dist/connection.js +305 -73
  10. package/dist/handles.d.ts +10 -1
  11. package/dist/handles.js +27 -4
  12. package/dist/index.d.ts +5 -5
  13. package/dist/jobs.d.ts +35 -1
  14. package/dist/jobs.js +46 -0
  15. package/dist/logger.d.ts +22 -10
  16. package/dist/logger.js +118 -28
  17. package/dist/metrics.d.ts +24 -1
  18. package/dist/metrics.js +24 -1
  19. package/dist/query.js +33 -9
  20. package/dist/records.d.ts +48 -7
  21. package/dist/records.js +22 -3
  22. package/dist/runtime/addon.js +3 -2
  23. package/dist/runtime/bun.js +33 -12
  24. package/dist/runtime/node.js +30 -8
  25. package/dist/runtime/pipe.d.ts +2 -0
  26. package/dist/runtime/pipe.js +45 -20
  27. package/dist/runtime/shared.d.ts +28 -4
  28. package/dist/runtime/shared.js +125 -13
  29. package/dist/runtime.d.ts +28 -6
  30. package/dist/session.d.ts +9 -5
  31. package/dist/session.js +113 -31
  32. package/dist/sql.d.ts +18 -5
  33. package/dist/sql.js +44 -11
  34. package/dist/store.d.ts +25 -11
  35. package/dist/store.js +67 -9
  36. package/dist/time.d.ts +2 -0
  37. package/dist/wire/codec.d.ts +5 -0
  38. package/dist/wire/codec.js +10 -0
  39. package/dist/wire/frame.d.ts +2 -0
  40. package/dist/wire/frame.js +4 -0
  41. package/dist/wire/msgpack.d.ts +7 -3
  42. package/dist/wire/msgpack.js +11 -4
  43. package/dist/wire/protocol.d.ts +280 -36
  44. package/dist/wire/protocol.js +510 -102
  45. package/package.json +9 -8
  46. package/src/blobs.ts +13 -5
  47. package/src/cancel.ts +44 -2
  48. package/src/channels.ts +21 -6
  49. package/src/config.ts +138 -12
  50. package/src/connection.ts +377 -77
  51. package/src/handles.ts +32 -4
  52. package/src/index.ts +6 -1
  53. package/src/jobs.ts +66 -0
  54. package/src/logger.ts +158 -40
  55. package/src/metrics.ts +53 -2
  56. package/src/query.ts +33 -13
  57. package/src/records.ts +73 -10
  58. package/src/runtime/addon.ts +3 -2
  59. package/src/runtime/bun.ts +44 -9
  60. package/src/runtime/node.ts +30 -5
  61. package/src/runtime/pipe.ts +49 -19
  62. package/src/runtime/shared.ts +137 -16
  63. package/src/runtime.ts +31 -6
  64. package/src/session.ts +129 -30
  65. package/src/sql.ts +48 -14
  66. package/src/store.ts +81 -14
  67. package/src/time.ts +3 -0
  68. package/src/wire/codec.ts +11 -0
  69. package/src/wire/frame.ts +5 -0
  70. package/src/wire/msgpack.ts +11 -4
  71. package/src/wire/protocol.ts +532 -104
@@ -96,6 +96,7 @@ export declare const methods: {
96
96
  readonly 'metrics.delete': 1548;
97
97
  readonly 'metrics.flush': 1549;
98
98
  readonly 'metrics.instruments': 1550;
99
+ readonly 'metrics.ingestPrometheus': 1551;
99
100
  readonly 'records.open': 1281;
100
101
  readonly 'records.append': 1282;
101
102
  readonly 'records.list': 1283;
@@ -400,15 +401,25 @@ export declare const ConfigOpen: import("./codec.ts").Message<{
400
401
  readonly strict: readonly [4, import("./codec.ts").Codec<boolean, boolean>];
401
402
  }>;
402
403
  /**
403
- * A setting's line of explain.
404
+ * Where a value came from: its kind, and only the fields that kind names.
404
405
  */
405
- export declare const ConfigLine: import("./codec.ts").Message<{
406
- readonly path: readonly [1, import("./codec.ts").Codec<string, string>];
407
- /** as JSON, a span spelled, a secret as *** */
408
- readonly value: readonly [2, import("./codec.ts").Codec<string, string>];
409
- readonly from: readonly [3, import("./codec.ts").Codec<string, string>];
410
- /** the values it went over, newest first */
411
- readonly over: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
406
+ export declare const ConfigOrigin: import("./codec.ts").Message<{
407
+ /** declaration, layer, file, env or change */
408
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
409
+ /** a layer's place in the list, the declaration 1 */
410
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
411
+ /** a file's path */
412
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
413
+ /** an env's variable */
414
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
415
+ /** the .env file that set the variable */
416
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
417
+ /** the file a NAME_FILE variable named */
418
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
419
+ /** a change's version */
420
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
421
+ /** when a change was made */
422
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
412
423
  }>;
413
424
  /**
414
425
  * A change of live settings, made on the version the program's value had.
@@ -507,6 +518,8 @@ export declare const StoreOptions: import("./codec.ts").Message<{
507
518
  readonly selfMetrics: readonly [13, import("./codec.ts").Codec<boolean, boolean>];
508
519
  /** with selfMetrics, leaves out the machine it runs on: its process's memory and processor, the system's */
509
520
  readonly withoutSystem: readonly [14, import("./codec.ts").Codec<boolean, boolean>];
521
+ /** the metrics series the store holds at most; 100,000 when absent */
522
+ readonly maxSeries: readonly [15, import("./codec.ts").Codec<number, number>];
510
523
  }>;
511
524
  /**
512
525
  * The last frame of a connection.
@@ -588,6 +601,11 @@ export declare const JobsQueueOpen: import("./codec.ts").Message<{
588
601
  readonly maxWaiting: readonly [9, import("./codec.ts").Codec<number, number>];
589
602
  /** a database's handle: the queue lives in its file; jobs.db when absent */
590
603
  readonly database: readonly [10, import("./codec.ts").Codec<number, number>];
604
+ /** each group's starts, beside the queue's rate */
605
+ readonly groupRate: readonly [11, import("./codec.ts").Message<{
606
+ readonly count: readonly [1, import("./codec.ts").Codec<number, number>];
607
+ readonly per: readonly [2, import("./codec.ts").Codec<number, number>];
608
+ }>];
591
609
  }>;
592
610
  /**
593
611
  * Opens a schedule: one repeating job the code owns, under its name, whose
@@ -1366,6 +1384,10 @@ export declare const MetricsAggregateAsked: import("./codec.ts").Message<{
1366
1384
  readonly without: readonly [5, import("./codec.ts").Codec<string[], readonly string[]>];
1367
1385
  /** a timer's percentile also gives a point between its bounds */
1368
1386
  readonly estimate: readonly [6, import("./codec.ts").Codec<boolean, boolean>];
1387
+ /** day, week or month: buckets of a calendar in timeZone, in place of every */
1388
+ readonly calendar: readonly [7, import("./codec.ts").Codec<string, string>];
1389
+ /** an IANA name, UTC among them, which calendar takes */
1390
+ readonly timeZone: readonly [8, import("./codec.ts").Codec<string, string>];
1369
1391
  }>;
1370
1392
  /**
1371
1393
  * A bucket of an aggregate: its value, or a timer's percentile's bounds.
@@ -1500,7 +1522,7 @@ export declare const MetricsAggregates: import("./codec.ts").Message<{
1500
1522
  }>[]>];
1501
1523
  }>;
1502
1524
  export declare const MetricsExceeds: import("./codec.ts").Message<{
1503
- /** series, bytes read or samples decoded */
1525
+ /** series, bytes read, samples decoded or answer */
1504
1526
  readonly limit: readonly [1, import("./codec.ts").Codec<string, string>];
1505
1527
  readonly wanted: readonly [2, import("./codec.ts").Codec<number, number>];
1506
1528
  readonly bound: readonly [3, import("./codec.ts").Codec<number, number>];
@@ -1548,6 +1570,19 @@ export declare const MetricsIngest: import("./codec.ts").Message<{
1548
1570
  readonly keep: readonly [6, import("./codec.ts").Codec<number, number>];
1549
1571
  }>[]>];
1550
1572
  }>;
1573
+ /**
1574
+ * A text an exporter serves, in Prometheus' format or OpenMetrics', whose
1575
+ * series the store writes every one or none, each with labels beside its own.
1576
+ */
1577
+ export declare const MetricsExposition: import("./codec.ts").Message<{
1578
+ /** UTF-8, read a line at a time, so that an error names its line */
1579
+ readonly text: readonly [1, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1580
+ readonly labels: readonly [2, import("./codec.ts").Codec<Record<string, string>, Record<string, string>>];
1581
+ /** of a sample the text gives no time; now unless given */
1582
+ readonly at: readonly [3, import("./codec.ts").Codec<number, number>];
1583
+ /** how long each name of the text keeps its samples */
1584
+ readonly keep: readonly [4, import("./codec.ts").Codec<number, number>];
1585
+ }>;
1551
1586
  /**
1552
1587
  * A page of names, of a name's labels or of a label's values.
1553
1588
  */
@@ -1816,6 +1851,8 @@ export declare const RecordsNewEvent: import("./codec.ts").Message<{
1816
1851
  readonly traceId: readonly [7, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1817
1852
  /** 8 bytes */
1818
1853
  readonly spanId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1854
+ /** 1 to 128 bytes: an event of an id its stream holds is written as nothing */
1855
+ readonly id: readonly [9, import("./codec.ts").Codec<string, string>];
1819
1856
  }>;
1820
1857
  /**
1821
1858
  * Events to write to a stream, all of them or none.
@@ -1837,6 +1874,8 @@ export declare const RecordsAppend: import("./codec.ts").Message<{
1837
1874
  readonly traceId: readonly [7, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1838
1875
  /** 8 bytes */
1839
1876
  readonly spanId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1877
+ /** 1 to 128 bytes: an event of an id its stream holds is written as nothing */
1878
+ readonly id: readonly [9, import("./codec.ts").Codec<string, string>];
1840
1879
  }>[], readonly import("./codec.ts").Written<{
1841
1880
  readonly name: readonly [1, import("./codec.ts").Codec<string, string>];
1842
1881
  /** the store's clock's now unless given */
@@ -1852,8 +1891,18 @@ export declare const RecordsAppend: import("./codec.ts").Message<{
1852
1891
  readonly traceId: readonly [7, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1853
1892
  /** 8 bytes */
1854
1893
  readonly spanId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1894
+ /** 1 to 128 bytes: an event of an id its stream holds is written as nothing */
1895
+ readonly id: readonly [9, import("./codec.ts").Codec<string, string>];
1855
1896
  }>[]>];
1856
1897
  }>;
1898
+ /**
1899
+ * What an append wrote: none of an event whose id its stream held, or an
1900
+ * earlier event of the append held.
1901
+ */
1902
+ export declare const RecordsAppended: import("./codec.ts").Message<{
1903
+ /** the events written as nothing */
1904
+ readonly held: readonly [1, import("./codec.ts").Codec<number, number>];
1905
+ }>;
1857
1906
  /**
1858
1907
  * An event as a read gives it.
1859
1908
  */
@@ -1868,6 +1917,7 @@ export declare const RecordsEvent: import("./codec.ts").Message<{
1868
1917
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
1869
1918
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1870
1919
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1920
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
1871
1921
  }>;
1872
1922
  /**
1873
1923
  * What a read finds: each condition given holds.
@@ -1904,6 +1954,7 @@ export declare const RecordsPage: import("./codec.ts").Message<{
1904
1954
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
1905
1955
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1906
1956
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1957
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
1907
1958
  }>[], readonly import("./codec.ts").Written<{
1908
1959
  readonly at: readonly [1, import("./codec.ts").Codec<bigint, number | bigint>];
1909
1960
  readonly stream: readonly [2, import("./codec.ts").Codec<string, string>];
@@ -1915,6 +1966,7 @@ export declare const RecordsPage: import("./codec.ts").Message<{
1915
1966
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
1916
1967
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1917
1968
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
1969
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
1918
1970
  }>[]>];
1919
1971
  /** the page after it; the last page has none */
1920
1972
  readonly next: readonly [2, import("./codec.ts").Codec<string, string>];
@@ -1990,6 +2042,10 @@ export declare const RecordsAggregateAsked: import("./codec.ts").Message<{
1990
2042
  readonly by: readonly [3, import("./codec.ts").Codec<string[], readonly string[]>];
1991
2043
  readonly stats: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
1992
2044
  readonly distinct: readonly [5, import("./codec.ts").Codec<string[], readonly string[]>];
2045
+ /** day, week or month: rows of a calendar in timeZone, in place of every */
2046
+ readonly calendar: readonly [6, import("./codec.ts").Codec<string, string>];
2047
+ /** an IANA name, UTC among them, which calendar takes */
2048
+ readonly timeZone: readonly [7, import("./codec.ts").Codec<string, string>];
1993
2049
  }>;
1994
2050
  /**
1995
2051
  * A field's numbers in a row: a sum, a min and a max are JSON numbers, an
@@ -2135,6 +2191,7 @@ export declare const RecordsBatch: import("./codec.ts").Message<{
2135
2191
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
2136
2192
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2137
2193
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2194
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
2138
2195
  }>[], readonly import("./codec.ts").Written<{
2139
2196
  readonly at: readonly [1, import("./codec.ts").Codec<bigint, number | bigint>];
2140
2197
  readonly stream: readonly [2, import("./codec.ts").Codec<string, string>];
@@ -2146,6 +2203,7 @@ export declare const RecordsBatch: import("./codec.ts").Message<{
2146
2203
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
2147
2204
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2148
2205
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2206
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
2149
2207
  }>[]>];
2150
2208
  readonly cursor: readonly [2, import("./codec.ts").Codec<string, string>];
2151
2209
  /** the events keep removed before the cursor reached them */
@@ -2167,6 +2225,7 @@ export declare const RecordsTailBatch: import("./codec.ts").Message<{
2167
2225
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
2168
2226
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2169
2227
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2228
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
2170
2229
  }>[], readonly import("./codec.ts").Written<{
2171
2230
  readonly at: readonly [1, import("./codec.ts").Codec<bigint, number | bigint>];
2172
2231
  readonly stream: readonly [2, import("./codec.ts").Codec<string, string>];
@@ -2178,6 +2237,7 @@ export declare const RecordsTailBatch: import("./codec.ts").Message<{
2178
2237
  readonly context: readonly [7, import("./codec.ts").Codec<string, string>];
2179
2238
  readonly traceId: readonly [8, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2180
2239
  readonly spanId: readonly [9, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2240
+ readonly id: readonly [10, import("./codec.ts").Codec<string, string>];
2181
2241
  }>[]>];
2182
2242
  readonly missed: readonly [2, import("./codec.ts").Codec<number, number>];
2183
2243
  }>;
@@ -2407,11 +2467,16 @@ export declare const SqlOpen: import("./codec.ts").Message<{
2407
2467
  readonly durability: readonly [3, import("./codec.ts").Codec<string, string>];
2408
2468
  }>;
2409
2469
  /**
2410
- * A statement's text and the values of its ?s, in order.
2470
+ * A statement's text and the values of its ?s, in order. In a batch it may
2471
+ * be a call of jobs on a queue kept in the database's file instead, jobs.add
2472
+ * with its request in body and no text, which commits with the batch's rows.
2411
2473
  */
2412
2474
  export declare const SqlText: import("./codec.ts").Message<{
2413
2475
  readonly text: readonly [1, import("./codec.ts").Codec<string, string>];
2414
2476
  readonly values: readonly [2, import("./codec.ts").Codec<(boolean | SqlValue)[], readonly import("./codec.ts").SqlArg[]>];
2477
+ /** in a batch, jobs.add: the call in body */
2478
+ readonly method: readonly [3, import("./codec.ts").Codec<number, number>];
2479
+ readonly body: readonly [4, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2415
2480
  }>;
2416
2481
  /**
2417
2482
  * A statement on a database: a write, or a read answered by its columns.
@@ -2497,18 +2562,29 @@ export declare const SqlDone: import("./codec.ts").Message<{
2497
2562
  readonly lastInsertRowid: readonly [2, import("./codec.ts").Codec<bigint, number | bigint>];
2498
2563
  }>;
2499
2564
  /**
2500
- * Statements known before they run, written as one in a shared commit.
2565
+ * Writes known before they run, written as one in a shared commit: its
2566
+ * statements, and the adds of a queue kept in the database's file.
2501
2567
  */
2502
2568
  export declare const SqlBatch: import("./codec.ts").Message<{
2503
2569
  readonly handle: readonly [1, import("./codec.ts").Codec<number, number>];
2504
2570
  readonly statements: readonly [2, import("./codec.ts").Codec<Read<{
2505
2571
  readonly text: readonly [1, import("./codec.ts").Codec<string, string>];
2506
2572
  readonly values: readonly [2, import("./codec.ts").Codec<(boolean | SqlValue)[], readonly import("./codec.ts").SqlArg[]>];
2573
+ /** in a batch, jobs.add: the call in body */
2574
+ readonly method: readonly [3, import("./codec.ts").Codec<number, number>];
2575
+ readonly body: readonly [4, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2507
2576
  }>[], readonly import("./codec.ts").Written<{
2508
2577
  readonly text: readonly [1, import("./codec.ts").Codec<string, string>];
2509
2578
  readonly values: readonly [2, import("./codec.ts").Codec<(boolean | SqlValue)[], readonly import("./codec.ts").SqlArg[]>];
2579
+ /** in a batch, jobs.add: the call in body */
2580
+ readonly method: readonly [3, import("./codec.ts").Codec<number, number>];
2581
+ readonly body: readonly [4, import("./codec.ts").Codec<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>];
2510
2582
  }>[]>];
2511
2583
  }>;
2584
+ /**
2585
+ * What each write of a batch did, in their order: a job's add changed one
2586
+ * job, or none when its id was taken.
2587
+ */
2512
2588
  export declare const SqlBatched: import("./codec.ts").Message<{
2513
2589
  readonly done: readonly [1, import("./codec.ts").Codec<Read<{
2514
2590
  readonly changes: readonly [1, import("./codec.ts").Codec<number, number>];
@@ -2581,31 +2657,29 @@ export declare const ChannelsBatch: import("./codec.ts").Message<{
2581
2657
  }>[]>];
2582
2658
  }>;
2583
2659
  /**
2584
- * A config's value at a version of its changes, and where each setting's
2585
- * value came from.
2660
+ * A value a setting was given, and where it came from.
2586
2661
  */
2587
- export declare const ConfigValue: import("./codec.ts").Message<{
2588
- readonly handle: readonly [1, import("./codec.ts").Codec<number, number>];
2589
- readonly version: readonly [2, import("./codec.ts").Codec<number, number>];
2590
- /** the settings, each span its milliseconds, each secret its text */
2591
- readonly value: readonly [3, import("./codec.ts").Codec<string, string>];
2592
- readonly lines: readonly [4, import("./codec.ts").Codec<Read<{
2593
- readonly path: readonly [1, import("./codec.ts").Codec<string, string>];
2594
- /** as JSON, a span spelled, a secret as *** */
2595
- readonly value: readonly [2, import("./codec.ts").Codec<string, string>];
2596
- readonly from: readonly [3, import("./codec.ts").Codec<string, string>];
2597
- /** the values it went over, newest first */
2598
- readonly over: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
2599
- }>[], readonly import("./codec.ts").Written<{
2600
- readonly path: readonly [1, import("./codec.ts").Codec<string, string>];
2601
- /** as JSON, a span spelled, a secret as *** */
2602
- readonly value: readonly [2, import("./codec.ts").Codec<string, string>];
2603
- readonly from: readonly [3, import("./codec.ts").Codec<string, string>];
2604
- /** the values it went over, newest first */
2605
- readonly over: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
2606
- }>[]>];
2607
- /** what was read and not used, each with why */
2608
- readonly notes: readonly [5, import("./codec.ts").Codec<string[], readonly string[]>];
2662
+ export declare const ConfigGiven: import("./codec.ts").Message<{
2663
+ /** as JSON, a span spelled, a secret as *** */
2664
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2665
+ readonly from: readonly [2, import("./codec.ts").Message<{
2666
+ /** declaration, layer, file, env or change */
2667
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2668
+ /** a layer's place in the list, the declaration 1 */
2669
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2670
+ /** a file's path */
2671
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2672
+ /** an env's variable */
2673
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2674
+ /** the .env file that set the variable */
2675
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2676
+ /** the file a NAME_FILE variable named */
2677
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2678
+ /** a change's version */
2679
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2680
+ /** when a change was made */
2681
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2682
+ }>];
2609
2683
  }>;
2610
2684
  /**
2611
2685
  * What a call would spend of each bound, and the bound it would stop at.
@@ -2615,7 +2689,7 @@ export declare const MetricsPlan: import("./codec.ts").Message<{
2615
2689
  readonly bytes: readonly [2, import("./codec.ts").Codec<number, number>];
2616
2690
  readonly decoded: readonly [3, import("./codec.ts").Codec<number, number>];
2617
2691
  readonly exceeds: readonly [4, import("./codec.ts").Message<{
2618
- /** series, bytes read or samples decoded */
2692
+ /** series, bytes read, samples decoded or answer */
2619
2693
  readonly limit: readonly [1, import("./codec.ts").Codec<string, string>];
2620
2694
  readonly wanted: readonly [2, import("./codec.ts").Codec<number, number>];
2621
2695
  readonly bound: readonly [3, import("./codec.ts").Codec<number, number>];
@@ -2681,3 +2755,173 @@ export declare const SearchSetMany: import("./codec.ts").Message<{
2681
2755
  readonly noVector: readonly [4, import("./codec.ts").Codec<boolean, boolean>];
2682
2756
  }>[]>];
2683
2757
  }>;
2758
+ /**
2759
+ * A setting's line of explain.
2760
+ */
2761
+ export declare const ConfigLine: import("./codec.ts").Message<{
2762
+ readonly path: readonly [1, import("./codec.ts").Codec<string, string>];
2763
+ /** as JSON, a span spelled, a secret as *** */
2764
+ readonly value: readonly [2, import("./codec.ts").Codec<string, string>];
2765
+ readonly from: readonly [3, import("./codec.ts").Codec<string, string>];
2766
+ /** the values it went over, newest first */
2767
+ readonly over: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
2768
+ /** every value it was given, newest first: its own, then the ones it went over */
2769
+ readonly given: readonly [5, import("./codec.ts").Codec<Read<{
2770
+ /** as JSON, a span spelled, a secret as *** */
2771
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2772
+ readonly from: readonly [2, import("./codec.ts").Message<{
2773
+ /** declaration, layer, file, env or change */
2774
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2775
+ /** a layer's place in the list, the declaration 1 */
2776
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2777
+ /** a file's path */
2778
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2779
+ /** an env's variable */
2780
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2781
+ /** the .env file that set the variable */
2782
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2783
+ /** the file a NAME_FILE variable named */
2784
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2785
+ /** a change's version */
2786
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2787
+ /** when a change was made */
2788
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2789
+ }>];
2790
+ }>[], readonly import("./codec.ts").Written<{
2791
+ /** as JSON, a span spelled, a secret as *** */
2792
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2793
+ readonly from: readonly [2, import("./codec.ts").Message<{
2794
+ /** declaration, layer, file, env or change */
2795
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2796
+ /** a layer's place in the list, the declaration 1 */
2797
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2798
+ /** a file's path */
2799
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2800
+ /** an env's variable */
2801
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2802
+ /** the .env file that set the variable */
2803
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2804
+ /** the file a NAME_FILE variable named */
2805
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2806
+ /** a change's version */
2807
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2808
+ /** when a change was made */
2809
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2810
+ }>];
2811
+ }>[]>];
2812
+ }>;
2813
+ /**
2814
+ * A config's value at a version of its changes, and where each setting's
2815
+ * value came from.
2816
+ */
2817
+ export declare const ConfigValue: import("./codec.ts").Message<{
2818
+ readonly handle: readonly [1, import("./codec.ts").Codec<number, number>];
2819
+ readonly version: readonly [2, import("./codec.ts").Codec<number, number>];
2820
+ /** the settings, each span its milliseconds, each secret its text */
2821
+ readonly value: readonly [3, import("./codec.ts").Codec<string, string>];
2822
+ readonly lines: readonly [4, import("./codec.ts").Codec<Read<{
2823
+ readonly path: readonly [1, import("./codec.ts").Codec<string, string>];
2824
+ /** as JSON, a span spelled, a secret as *** */
2825
+ readonly value: readonly [2, import("./codec.ts").Codec<string, string>];
2826
+ readonly from: readonly [3, import("./codec.ts").Codec<string, string>];
2827
+ /** the values it went over, newest first */
2828
+ readonly over: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
2829
+ /** every value it was given, newest first: its own, then the ones it went over */
2830
+ readonly given: readonly [5, import("./codec.ts").Codec<Read<{
2831
+ /** as JSON, a span spelled, a secret as *** */
2832
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2833
+ readonly from: readonly [2, import("./codec.ts").Message<{
2834
+ /** declaration, layer, file, env or change */
2835
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2836
+ /** a layer's place in the list, the declaration 1 */
2837
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2838
+ /** a file's path */
2839
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2840
+ /** an env's variable */
2841
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2842
+ /** the .env file that set the variable */
2843
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2844
+ /** the file a NAME_FILE variable named */
2845
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2846
+ /** a change's version */
2847
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2848
+ /** when a change was made */
2849
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2850
+ }>];
2851
+ }>[], readonly import("./codec.ts").Written<{
2852
+ /** as JSON, a span spelled, a secret as *** */
2853
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2854
+ readonly from: readonly [2, import("./codec.ts").Message<{
2855
+ /** declaration, layer, file, env or change */
2856
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2857
+ /** a layer's place in the list, the declaration 1 */
2858
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2859
+ /** a file's path */
2860
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2861
+ /** an env's variable */
2862
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2863
+ /** the .env file that set the variable */
2864
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2865
+ /** the file a NAME_FILE variable named */
2866
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2867
+ /** a change's version */
2868
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2869
+ /** when a change was made */
2870
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2871
+ }>];
2872
+ }>[]>];
2873
+ }>[], readonly import("./codec.ts").Written<{
2874
+ readonly path: readonly [1, import("./codec.ts").Codec<string, string>];
2875
+ /** as JSON, a span spelled, a secret as *** */
2876
+ readonly value: readonly [2, import("./codec.ts").Codec<string, string>];
2877
+ readonly from: readonly [3, import("./codec.ts").Codec<string, string>];
2878
+ /** the values it went over, newest first */
2879
+ readonly over: readonly [4, import("./codec.ts").Codec<string[], readonly string[]>];
2880
+ /** every value it was given, newest first: its own, then the ones it went over */
2881
+ readonly given: readonly [5, import("./codec.ts").Codec<Read<{
2882
+ /** as JSON, a span spelled, a secret as *** */
2883
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2884
+ readonly from: readonly [2, import("./codec.ts").Message<{
2885
+ /** declaration, layer, file, env or change */
2886
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2887
+ /** a layer's place in the list, the declaration 1 */
2888
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2889
+ /** a file's path */
2890
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2891
+ /** an env's variable */
2892
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2893
+ /** the .env file that set the variable */
2894
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2895
+ /** the file a NAME_FILE variable named */
2896
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2897
+ /** a change's version */
2898
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2899
+ /** when a change was made */
2900
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2901
+ }>];
2902
+ }>[], readonly import("./codec.ts").Written<{
2903
+ /** as JSON, a span spelled, a secret as *** */
2904
+ readonly value: readonly [1, import("./codec.ts").Codec<string, string>];
2905
+ readonly from: readonly [2, import("./codec.ts").Message<{
2906
+ /** declaration, layer, file, env or change */
2907
+ readonly kind: readonly [1, import("./codec.ts").Codec<string, string>];
2908
+ /** a layer's place in the list, the declaration 1 */
2909
+ readonly place: readonly [2, import("./codec.ts").Codec<number, number>];
2910
+ /** a file's path */
2911
+ readonly path: readonly [3, import("./codec.ts").Codec<string, string>];
2912
+ /** an env's variable */
2913
+ readonly variable: readonly [4, import("./codec.ts").Codec<string, string>];
2914
+ /** the .env file that set the variable */
2915
+ readonly dotenv: readonly [5, import("./codec.ts").Codec<string, string>];
2916
+ /** the file a NAME_FILE variable named */
2917
+ readonly file: readonly [6, import("./codec.ts").Codec<string, string>];
2918
+ /** a change's version */
2919
+ readonly version: readonly [7, import("./codec.ts").Codec<number, number>];
2920
+ /** when a change was made */
2921
+ readonly at: readonly [8, import("./codec.ts").Codec<number, number>];
2922
+ }>];
2923
+ }>[]>];
2924
+ }>[]>];
2925
+ /** what was read and not used, each with why */
2926
+ readonly notes: readonly [5, import("./codec.ts").Codec<string[], readonly string[]>];
2927
+ }>;