@tinyshed/tinystore 0.2.0-rc.1 → 0.3.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.
@@ -119,6 +119,13 @@ export const methods = {
119
119
  'metrics.flush': 0x060d,
120
120
  'metrics.instruments': 0x060e,
121
121
  'metrics.ingestPrometheus': 0x060f,
122
+ /**
123
+ * Answers its RESPONSE at once; the store's memory for the whole text is
124
+ * taken before a piece is kept, and the last piece is answered once the text
125
+ * is written, every series or none. A cancel or a lost connection leaves
126
+ * nothing written and lets go of what came.
127
+ */
128
+ 'metrics.uploadPrometheus': 0x0610,
122
129
  'records.open': 0x0501,
123
130
  'records.append': 0x0502,
124
131
  'records.list': 0x0503,
@@ -1658,6 +1665,8 @@ export const ConfigOpen = message(
1658
1665
  layers: [3, str],
1659
1666
  /** a kept change that no longer fits refuses the open */
1660
1667
  strict: [4, bool],
1668
+ /** as kv.db keeps it, for a command: the last declaration a program opened it with, */
1669
+ kept: [5, bool],
1661
1670
  },
1662
1671
  {
1663
1672
  write(w, v) {
@@ -1683,6 +1692,11 @@ export const ConfigOpen = message(
1683
1692
  w.bool(v.strict)
1684
1693
  n++
1685
1694
  }
1695
+ if (v.kept !== undefined) {
1696
+ w.field(5)
1697
+ w.bool(v.kept)
1698
+ n++
1699
+ }
1686
1700
  w.closeMap(head, n)
1687
1701
  },
1688
1702
  read(r) {
@@ -1690,6 +1704,7 @@ export const ConfigOpen = message(
1690
1704
  let $declaration: string | undefined
1691
1705
  let $layers: string | undefined
1692
1706
  let $strict: boolean | undefined
1707
+ let $kept: boolean | undefined
1693
1708
  for (let n = r.message(); n > 0; n--) {
1694
1709
  switch (r.field()) {
1695
1710
  case 1:
@@ -1704,12 +1719,21 @@ export const ConfigOpen = message(
1704
1719
  case 4:
1705
1720
  $strict = r.bool()
1706
1721
  break
1722
+ case 5:
1723
+ $kept = r.bool()
1724
+ break
1707
1725
  default:
1708
1726
  r.skip()
1709
1727
  }
1710
1728
  }
1711
1729
  r.leave()
1712
- return { name: $name, declaration: $declaration, layers: $layers, strict: $strict }
1730
+ return {
1731
+ name: $name,
1732
+ declaration: $declaration,
1733
+ layers: $layers,
1734
+ strict: $strict,
1735
+ kept: $kept,
1736
+ }
1713
1737
  },
1714
1738
  },
1715
1739
  )
@@ -5818,6 +5842,10 @@ export const MetricsQuery = message(
5818
5842
  from: [4, int],
5819
5843
  /** excluded; now, a sample taken now in the range, unless given */
5820
5844
  to: [5, int],
5845
+ /** a page's samples or buckets at most, 100,000 at most: a page, which read and aggregate take */
5846
+ limit: [6, uint],
5847
+ /** a page's next, with limit */
5848
+ after: [7, str],
5821
5849
  },
5822
5850
  {
5823
5851
  write(w, v) {
@@ -5848,6 +5876,16 @@ export const MetricsQuery = message(
5848
5876
  w.int(v.to)
5849
5877
  n++
5850
5878
  }
5879
+ if (v.limit !== undefined) {
5880
+ w.field(6)
5881
+ w.uint(v.limit)
5882
+ n++
5883
+ }
5884
+ if (v.after !== undefined) {
5885
+ w.field(7)
5886
+ w.str(v.after)
5887
+ n++
5888
+ }
5851
5889
  w.closeMap(head, n)
5852
5890
  },
5853
5891
  read(r) {
@@ -5856,6 +5894,8 @@ export const MetricsQuery = message(
5856
5894
  let $since: number | undefined
5857
5895
  let $from: number | undefined
5858
5896
  let $to: number | undefined
5897
+ let $limit: number | undefined
5898
+ let $after: string | undefined
5859
5899
  for (let n = r.message(); n > 0; n--) {
5860
5900
  switch (r.field()) {
5861
5901
  case 1:
@@ -5873,12 +5913,26 @@ export const MetricsQuery = message(
5873
5913
  case 5:
5874
5914
  $to = r.int()
5875
5915
  break
5916
+ case 6:
5917
+ $limit = r.uint()
5918
+ break
5919
+ case 7:
5920
+ $after = r.str()
5921
+ break
5876
5922
  default:
5877
5923
  r.skip()
5878
5924
  }
5879
5925
  }
5880
5926
  r.leave()
5881
- return { name: $name, where: $where, since: $since, from: $from, to: $to }
5927
+ return {
5928
+ name: $name,
5929
+ where: $where,
5930
+ since: $since,
5931
+ from: $from,
5932
+ to: $to,
5933
+ limit: $limit,
5934
+ after: $after,
5935
+ }
5882
5936
  },
5883
5937
  },
5884
5938
  )
@@ -5898,7 +5952,7 @@ export const MetricsSeries = message(
5898
5952
  times: [4, bin],
5899
5953
  /** a float64 a sample */
5900
5954
  values: [5, bin],
5901
- /** the next part goes on with this series */
5955
+ /** the next part goes on with this series; on a page's last, the next page's first */
5902
5956
  more: [6, bool],
5903
5957
  },
5904
5958
  {
@@ -5985,6 +6039,8 @@ export const MetricsRead = message(
5985
6039
  'metrics.Read',
5986
6040
  {
5987
6041
  series: [1, list(MetricsSeries)],
6042
+ /** on the last part of a page that has more, to a request that gave limit */
6043
+ next: [2, str],
5988
6044
  },
5989
6045
  {
5990
6046
  write(w, v) {
@@ -5998,10 +6054,16 @@ export const MetricsRead = message(
5998
6054
  }
5999
6055
  n++
6000
6056
  }
6057
+ if (v.next !== undefined) {
6058
+ w.field(2)
6059
+ w.str(v.next)
6060
+ n++
6061
+ }
6001
6062
  w.closeMap(head, n)
6002
6063
  },
6003
6064
  read(r) {
6004
6065
  let $series: Read<typeof MetricsSeries.fields>[] | undefined
6066
+ let $next: string | undefined
6005
6067
  for (let n = r.message(); n > 0; n--) {
6006
6068
  switch (r.field()) {
6007
6069
  case 1: {
@@ -6013,12 +6075,15 @@ export const MetricsRead = message(
6013
6075
  $series = items0
6014
6076
  break
6015
6077
  }
6078
+ case 2:
6079
+ $next = r.str()
6080
+ break
6016
6081
  default:
6017
6082
  r.skip()
6018
6083
  }
6019
6084
  }
6020
6085
  r.leave()
6021
- return { series: $series }
6086
+ return { series: $series, next: $next }
6022
6087
  },
6023
6088
  },
6024
6089
  )
@@ -6411,6 +6476,7 @@ export const MetricsGroup = message(
6411
6476
  name: [1, str],
6412
6477
  labels: [2, names(str)],
6413
6478
  buckets: [3, list(MetricsBucket)],
6479
+ /** the next part goes on with this group; on a page's last, the next page's first */
6414
6480
  more: [4, bool],
6415
6481
  },
6416
6482
  {
@@ -6481,6 +6547,8 @@ export const MetricsAggregates = message(
6481
6547
  'metrics.Aggregates',
6482
6548
  {
6483
6549
  groups: [1, list(MetricsGroup)],
6550
+ /** on the last part of a page that has more, to a request that gave limit */
6551
+ next: [2, str],
6484
6552
  },
6485
6553
  {
6486
6554
  write(w, v) {
@@ -6494,10 +6562,16 @@ export const MetricsAggregates = message(
6494
6562
  }
6495
6563
  n++
6496
6564
  }
6565
+ if (v.next !== undefined) {
6566
+ w.field(2)
6567
+ w.str(v.next)
6568
+ n++
6569
+ }
6497
6570
  w.closeMap(head, n)
6498
6571
  },
6499
6572
  read(r) {
6500
6573
  let $groups: Read<typeof MetricsGroup.fields>[] | undefined
6574
+ let $next: string | undefined
6501
6575
  for (let n = r.message(); n > 0; n--) {
6502
6576
  switch (r.field()) {
6503
6577
  case 1: {
@@ -6509,12 +6583,15 @@ export const MetricsAggregates = message(
6509
6583
  $groups = items0
6510
6584
  break
6511
6585
  }
6586
+ case 2:
6587
+ $next = r.str()
6588
+ break
6512
6589
  default:
6513
6590
  r.skip()
6514
6591
  }
6515
6592
  }
6516
6593
  r.leave()
6517
- return { groups: $groups }
6594
+ return { groups: $groups, next: $next }
6518
6595
  },
6519
6596
  },
6520
6597
  )
@@ -6785,6 +6862,110 @@ export const MetricsExposition = message(
6785
6862
  },
6786
6863
  )
6787
6864
 
6865
+ /**
6866
+ * A text past what one message holds: what metrics.Exposition carries but
6867
+ * the text, whose bytes follow as the client's DATA, a metrics.Piece each.
6868
+ */
6869
+ export const MetricsUpload = message(
6870
+ 'metrics.Upload',
6871
+ {
6872
+ /** the text's bytes, 32 MiB at most: pieces that come to more or fewer are refused */
6873
+ size: [1, uint],
6874
+ labels: [2, names(str)],
6875
+ at: [3, int],
6876
+ keep: [4, uint],
6877
+ },
6878
+ {
6879
+ write(w, v) {
6880
+ const head = w.openMap()
6881
+ let n = 0
6882
+ if (v.size !== undefined) {
6883
+ w.field(1)
6884
+ w.uint(v.size)
6885
+ n++
6886
+ }
6887
+ if (v.labels !== undefined) {
6888
+ w.field(2)
6889
+ writeNames(w, v.labels, str.write)
6890
+ n++
6891
+ }
6892
+ if (v.at !== undefined) {
6893
+ w.field(3)
6894
+ w.int(v.at)
6895
+ n++
6896
+ }
6897
+ if (v.keep !== undefined) {
6898
+ w.field(4)
6899
+ w.uint(v.keep)
6900
+ n++
6901
+ }
6902
+ w.closeMap(head, n)
6903
+ },
6904
+ read(r) {
6905
+ let $size: number | undefined
6906
+ let $labels: Record<string, string> | undefined
6907
+ let $at: number | undefined
6908
+ let $keep: number | undefined
6909
+ for (let n = r.message(); n > 0; n--) {
6910
+ switch (r.field()) {
6911
+ case 1:
6912
+ $size = r.uint()
6913
+ break
6914
+ case 2:
6915
+ $labels = readNames(r, str.read)
6916
+ break
6917
+ case 3:
6918
+ $at = r.int()
6919
+ break
6920
+ case 4:
6921
+ $keep = r.uint()
6922
+ break
6923
+ default:
6924
+ r.skip()
6925
+ }
6926
+ }
6927
+ r.leave()
6928
+ return { size: $size, labels: $labels, at: $at, keep: $keep }
6929
+ },
6930
+ },
6931
+ )
6932
+
6933
+ /**
6934
+ * A piece of an uploaded text, cut anywhere.
6935
+ */
6936
+ export const MetricsPiece = message(
6937
+ 'metrics.Piece',
6938
+ {
6939
+ bytes: [1, bin],
6940
+ },
6941
+ {
6942
+ write(w, v) {
6943
+ const head = w.openMap()
6944
+ let n = 0
6945
+ if (v.bytes !== undefined) {
6946
+ w.field(1)
6947
+ w.bin(v.bytes)
6948
+ n++
6949
+ }
6950
+ w.closeMap(head, n)
6951
+ },
6952
+ read(r) {
6953
+ let $bytes: Uint8Array | undefined
6954
+ for (let n = r.message(); n > 0; n--) {
6955
+ switch (r.field()) {
6956
+ case 1:
6957
+ $bytes = r.bytes()
6958
+ break
6959
+ default:
6960
+ r.skip()
6961
+ }
6962
+ }
6963
+ r.leave()
6964
+ return { bytes: $bytes }
6965
+ },
6966
+ },
6967
+ )
6968
+
6788
6969
  /**
6789
6970
  * A page of names, of a name's labels or of a label's values.
6790
6971
  */