@bjornpagen/bumbledb-log 0.20.2 → 0.20.3
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.
- package/dist/keys.d.ts +5 -6
- package/dist/keys.d.ts.map +1 -1
- package/dist/keys.js +6 -53
- package/dist/keys.js.map +1 -1
- package/package.json +2 -2
- package/dist/tilde-family.json +0 -21
package/dist/keys.d.ts
CHANGED
|
@@ -4,12 +4,11 @@
|
|
|
4
4
|
* StoreKey is parsed here, once — the verbs take the proof and never
|
|
5
5
|
* re-check. An empty prefix joins as the rest alone, so a leading
|
|
6
6
|
* slash is unrepresentable. Temps and leases live under a reserved
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
* containing one is refused outright.
|
|
7
|
+
* `~` first segment no StoreKey can spell, so those namespaces stay
|
|
8
|
+
* disjoint from every honest key. Format characters, line and
|
|
9
|
+
* paragraph separators, and space separators cannot hide a reserved
|
|
10
|
+
* prefix or a `.lock` suffix: a segment containing one is refused
|
|
11
|
+
* outright.
|
|
13
12
|
*/
|
|
14
13
|
import type { Digest32 } from "./bytes.js";
|
|
15
14
|
import type { Braid } from "./descriptor.js";
|
package/dist/keys.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAK3C,sFAAsF;AACtF,QAAA,MAAM,cAAc,SAAS,CAAA;AAC7B,QAAA,MAAM,eAAe,WAAW,CAAA;AAKhC,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAA;AAC1C,KAAK,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAA;CAAE,CAAA;AAE3E,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAA;AAC5C,KAAK,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,OAAO,eAAe,CAAA;CAAE,CAAA;AAajF,iBAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAMvC;AAED,8FAA8F;AAC9F,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKxC;AAED,iBAAS,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,8EAA8E;AAC9E,iBAAS,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUzC;AAED,sEAAsE;AACtE,QAAA,MAAM,kBAAkB,iBAAiB,CAAA;AAEzC,wDAAwD;AACxD,iBAAS,eAAe,IAAI,MAAM,CAEjC;AAED,kFAAkF;AAClF,iBAAS,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAEvD;AAED;8DAC8D;AAC9D,iBAAS,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAM5D;AAED,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAK3C;AAUD,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAE7C;AAED,iBAAS,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,GAAG,QAAQ,CAErE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAEpE;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAE9D;AAED,iBAAS,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEzE;AAED,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;AACpC,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,eAAe,EACf,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,CAAA"}
|
package/dist/keys.js
CHANGED
|
@@ -4,70 +4,23 @@
|
|
|
4
4
|
* StoreKey is parsed here, once — the verbs take the proof and never
|
|
5
5
|
* re-check. An empty prefix joins as the rest alone, so a leading
|
|
6
6
|
* slash is unrepresentable. Temps and leases live under a reserved
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
* containing one is refused outright.
|
|
7
|
+
* `~` first segment no StoreKey can spell, so those namespaces stay
|
|
8
|
+
* disjoint from every honest key. Format characters, line and
|
|
9
|
+
* paragraph separators, and space separators cannot hide a reserved
|
|
10
|
+
* prefix or a `.lock` suffix: a segment containing one is refused
|
|
11
|
+
* outright.
|
|
13
12
|
*/
|
|
14
13
|
import { internalLogParseCkptScratch, internalLogRenderCkptScratch } from "@bjornpagen/bumbledb";
|
|
15
14
|
import * as errors from "@superbuilders/errors";
|
|
16
15
|
import { regex } from "arkregex";
|
|
17
16
|
import { digest32, hex32, U64_MAX } from "#bytes.ts";
|
|
18
|
-
import tildeTable from "./tilde-family.json" with { type: "json" };
|
|
19
17
|
/** A segment wearing this suffix is not a key. */
|
|
20
18
|
const LOCK_SUFFIX = ".lock";
|
|
21
19
|
/** Reserved first-segment names no StoreKey can spell. Temps and leases live here. */
|
|
22
20
|
const TEMP_NAMESPACE = "~tmp";
|
|
23
21
|
const LEASE_NAMESPACE = "~lease";
|
|
24
|
-
/**
|
|
25
|
-
* The one tilde table both drivers consume: ASCII `~`, its lookalikes, and
|
|
26
|
-
* the NFKC preimage of U+007E. The packaged copy is the census-pinned
|
|
27
|
-
* byte-identical twin of the generator's output at
|
|
28
|
-
* crates/bumbledb-log/conformance/v3/keys/tilde-family.json. A JSON
|
|
29
|
-
* import inlines under bundlers (nitro will not relocate the sidecar)
|
|
30
|
-
* and still resolves beside dist/keys.js when the package stays external.
|
|
31
|
-
*/
|
|
32
|
-
const CODE_POINT_SPELLING = regex("^U\\+[0-9A-F]{4,6}$");
|
|
33
|
-
function loadTildeFamily() {
|
|
34
|
-
const table = tildeTable;
|
|
35
|
-
if (typeof table !== "object" || table === null || !("codePoints" in table)) {
|
|
36
|
-
throw errors.new("tilde table is not a codePoints document");
|
|
37
|
-
}
|
|
38
|
-
const { codePoints } = table;
|
|
39
|
-
if (!Array.isArray(codePoints) || codePoints.length === 0) {
|
|
40
|
-
throw errors.new("tilde table codePoints is not a nonempty array");
|
|
41
|
-
}
|
|
42
|
-
const family = new Set();
|
|
43
|
-
for (const spelling of codePoints) {
|
|
44
|
-
if (typeof spelling !== "string" || !CODE_POINT_SPELLING.test(spelling)) {
|
|
45
|
-
throw errors.new(`tilde table entry is not a U+XXXX code point: ${String(spelling)}`);
|
|
46
|
-
}
|
|
47
|
-
family.add(String.fromCodePoint(Number.parseInt(spelling.slice(2), 16)));
|
|
48
|
-
}
|
|
49
|
-
if (!family.has("~")) {
|
|
50
|
-
throw errors.new("tilde table does not reserve ASCII tilde");
|
|
51
|
-
}
|
|
52
|
-
return family;
|
|
53
|
-
}
|
|
54
|
-
/** First-segment code points that spell a reserved name. The table is the set; no local spelling. */
|
|
55
|
-
const TILDE_FAMILY = loadTildeFamily();
|
|
56
22
|
const FORMAT_OR_SEPARATOR = regex("[\\p{Cc}\\p{Cf}\\p{Zl}\\p{Zp}\\p{Zs}]", "u");
|
|
57
23
|
const SLASH_TRIM = regex("^/+|/+$", "g");
|
|
58
|
-
function firstCodePoint(seg) {
|
|
59
|
-
for (const ch of seg) {
|
|
60
|
-
return ch;
|
|
61
|
-
}
|
|
62
|
-
return undefined;
|
|
63
|
-
}
|
|
64
|
-
function tildeFamilyPrefix(seg) {
|
|
65
|
-
const first = firstCodePoint(seg);
|
|
66
|
-
if (first === undefined) {
|
|
67
|
-
return false;
|
|
68
|
-
}
|
|
69
|
-
return TILDE_FAMILY.has(first);
|
|
70
|
-
}
|
|
71
24
|
/** One path segment of a key or a tenant id: the same grammar. */
|
|
72
25
|
function segmentOk(seg) {
|
|
73
26
|
if (seg.length === 0 || seg.includes("/") || seg === "." || seg === "..") {
|
|
@@ -76,7 +29,7 @@ function segmentOk(seg) {
|
|
|
76
29
|
if (FORMAT_OR_SEPARATOR.test(seg)) {
|
|
77
30
|
return false;
|
|
78
31
|
}
|
|
79
|
-
return !
|
|
32
|
+
return !seg.startsWith("~") && !seg.endsWith(LOCK_SUFFIX);
|
|
80
33
|
}
|
|
81
34
|
function storeKey(raw) {
|
|
82
35
|
const wellFormed = raw.length > 0 && !raw.startsWith("/") && !raw.endsWith("/") && raw.split("/").every(segmentOk);
|
package/dist/keys.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAA;AAChG,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAEhC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGpD,kDAAkD;AAClD,MAAM,WAAW,GAAG,OAAO,CAAA;AAE3B,sFAAsF;AACtF,MAAM,cAAc,GAAG,MAAM,CAAA;AAC7B,MAAM,eAAe,GAAG,QAAQ,CAAA;AAEhC,MAAM,mBAAmB,GAAG,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAA;AAC/E,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;AAQxC,kEAAkE;AAClE,SAAS,SAAS,CAAC,GAAW;IAC7B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAA;IACb,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAA;IACb,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC5B,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAClH,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,GAAG,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,GAAe,CAAA;AACvB,CAAC;AAED,8FAA8F;AAC9F,SAAS,WAAW,CAAC,GAAW;IAC/B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAA;IACV,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,GAAW;IAC7C,OAAO,GAAG,cAAc,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,KAAa;IAChD,OAAO,GAAG,eAAe,IAAI,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AACpD,CAAC;AAED,8EAA8E;AAC9E,SAAS,YAAY,CAAC,GAAW;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9F,MAAM,MAAM,CAAC,GAAG,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACrB,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;QAC3D,MAAM,MAAM,CAAC,GAAG,CAAC,8BAA8B,cAAc,OAAO,eAAe,KAAK,GAAG,EAAE,CAAC,CAAA;IAC/F,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,sEAAsE;AACtE,MAAM,kBAAkB,GAAG,cAAc,CAAA;AAEzC,wDAAwD;AACxD,SAAS,eAAe;IACvB,OAAO,YAAY,CAAC,GAAG,eAAe,IAAI,kBAAkB,EAAE,CAAC,CAAA;AAChE,CAAC;AAED,kFAAkF;AAClF,SAAS,iBAAiB,CAAC,MAAgB;IAC1C,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAA;AAC5C,CAAC;AAED;8DAC8D;AAC9D,SAAS,gBAAgB,CAAC,KAAiB;IAC1C,MAAM,KAAK,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAA;IAChD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC9B,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,OAAO,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,GAAG,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,GAAiB,CAAA;AACzB,CAAC;AAED,SAAS,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,IAAY;IAC7C,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAA;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IAClC,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AACpC,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,KAAY,EAAE,CAAa;IAC1D,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACpD,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,MAAgB;IACzD,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AACrD,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,MAAgB;IACnD,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAa;IAC9D,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;AAChH,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,MAAc;IACjD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,CAAC,GAAG,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC,CAAA;AACrC,CAAC;AAGD,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,eAAe,EACf,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,CAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bjornpagen/bumbledb-log",
|
|
3
|
-
"version": "0.20.
|
|
3
|
+
"version": "0.20.3",
|
|
4
4
|
"description": "Braided object-store replication for bumbledb: the command codec, theory-derived braids, and replica/writer over five store verbs",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"exports": {
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"arkregex": "^0.0.8"
|
|
42
42
|
},
|
|
43
43
|
"peerDependencies": {
|
|
44
|
-
"@bjornpagen/bumbledb": "^0.20.
|
|
44
|
+
"@bjornpagen/bumbledb": "^0.20.3"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"@biomejs/biome": "2.5.4",
|
package/dist/tilde-family.json
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"surface": "key-grammar/tilde-family",
|
|
3
|
-
"rule": "a segment whose first code point is in this set is reserved; the set is ASCII tilde, its lookalikes, and the NFKC preimage of U+007E, one closed table both drivers consume",
|
|
4
|
-
"codePoints": [
|
|
5
|
-
"U+007E",
|
|
6
|
-
"U+02DC",
|
|
7
|
-
"U+02F7",
|
|
8
|
-
"U+1FC0",
|
|
9
|
-
"U+2053",
|
|
10
|
-
"U+223C",
|
|
11
|
-
"U+223D",
|
|
12
|
-
"U+223F",
|
|
13
|
-
"U+2E1E",
|
|
14
|
-
"U+2E1F",
|
|
15
|
-
"U+301C",
|
|
16
|
-
"U+3030",
|
|
17
|
-
"U+FE4B",
|
|
18
|
-
"U+FE4F",
|
|
19
|
-
"U+FF5E"
|
|
20
|
-
]
|
|
21
|
-
}
|