@mblaney/holster 0.1.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 (46) hide show
  1. package/.github/workflows/node.js.yml +31 -0
  2. package/LICENSE.md +55 -0
  3. package/README.md +24 -0
  4. package/build/holster.js +4 -0
  5. package/build/holster.js.map +7 -0
  6. package/examples/index.html +33 -0
  7. package/examples/index.js +49 -0
  8. package/examples/user.html +31 -0
  9. package/examples/user.js +88 -0
  10. package/examples/wire.html +27 -0
  11. package/examples/wire.js +55 -0
  12. package/package.json +44 -0
  13. package/src/array.js +34 -0
  14. package/src/buffer.js +83 -0
  15. package/src/dup.js +23 -0
  16. package/src/get.js +19 -0
  17. package/src/ham.js +151 -0
  18. package/src/holster.js +502 -0
  19. package/src/index.js +21 -0
  20. package/src/radisk.js +438 -0
  21. package/src/radix.js +106 -0
  22. package/src/sea-utils.js +65 -0
  23. package/src/sea.js +224 -0
  24. package/src/store.js +225 -0
  25. package/src/user.js +330 -0
  26. package/src/utils.js +124 -0
  27. package/src/wire.js +290 -0
  28. package/test/holster.get.test.js +60 -0
  29. package/test/holster.lex.test.js +196 -0
  30. package/test/holster.off.test.js +53 -0
  31. package/test/holster.on.test.js +168 -0
  32. package/test/holster.put.test.js +278 -0
  33. package/test/holster.secure.test.js +210 -0
  34. package/test/holster.user.get.test.js +86 -0
  35. package/test/holster.user.lex.test.js +148 -0
  36. package/test/holster.user.off.test.js +72 -0
  37. package/test/holster.user.on.test.js +185 -0
  38. package/test/holster.user.put.test.js +381 -0
  39. package/test/kitty/! +9 -0
  40. package/test/names.js +225 -0
  41. package/test/radisk.test.js +191 -0
  42. package/test/radix.test.js +117 -0
  43. package/test/sea.test.js +284 -0
  44. package/test/store.test.js +316 -0
  45. package/test/user.test.js +173 -0
  46. package/test/wire.test.js +159 -0
@@ -0,0 +1,86 @@
1
+ import fs from "fs"
2
+ import {Server} from "mock-socket"
3
+ import {describe, test} from "node:test"
4
+ import assert from "node:assert/strict"
5
+ import Holster from "../src/holster.js"
6
+
7
+ describe("holster.user.get", () => {
8
+ const wss = new Server("ws://localhost:1234")
9
+ const holster = Holster({
10
+ file: "test/holster.user.get",
11
+ wss: wss,
12
+ maxAge: 100,
13
+ })
14
+ const user = holster.user()
15
+
16
+ test("user is not authenticated", (t, done) => {
17
+ user.get("test", data => {
18
+ assert.equal(data, null)
19
+ done()
20
+ })
21
+ })
22
+
23
+ test("user create", (t, done) => {
24
+ user.create("alice", "password", err => {
25
+ assert.equal(err, null)
26
+ done()
27
+ })
28
+ })
29
+
30
+ test("user auth", (t, done) => {
31
+ user.auth("alice", "password", err => {
32
+ assert.equal(err, null)
33
+ done()
34
+ })
35
+ })
36
+
37
+ test("empty key callback null", (t, done) => {
38
+ user.get("", data => {
39
+ assert.equal(data, null)
40
+ done()
41
+ })
42
+ })
43
+
44
+ test("null key callback null", (t, done) => {
45
+ user.get(null, data => {
46
+ assert.equal(data, null)
47
+ done()
48
+ })
49
+ })
50
+
51
+ test("underscore as key callback null", (t, done) => {
52
+ user.get("_", data => {
53
+ assert.equal(data, null)
54
+ done()
55
+ })
56
+ })
57
+
58
+ test("get unknown key callback null", (t, done) => {
59
+ user.get("unknown", data => {
60
+ assert.equal(data, null)
61
+ done()
62
+ })
63
+ })
64
+
65
+ // Chaining get creates a new context for each call.
66
+ test("get chained unknown keys callback null", (t, done) => {
67
+ user.get("chained").get("unknown", data => {
68
+ assert.equal(data, null)
69
+ done()
70
+ })
71
+ })
72
+
73
+ test("next chained unknown keys callback null", (t, done) => {
74
+ user.get("chained").next("unknown", data => {
75
+ assert.equal(data, null)
76
+ done()
77
+ })
78
+ })
79
+
80
+ test("cleanup", (t, done) => {
81
+ fs.rm("test/holster.user.get", {recursive: true, force: true}, err => {
82
+ assert.equal(err, null)
83
+ done()
84
+ })
85
+ })
86
+ })
@@ -0,0 +1,148 @@
1
+ import fs from "fs"
2
+ import {Server} from "mock-socket"
3
+ import {describe, test} from "node:test"
4
+ import assert from "node:assert/strict"
5
+ import Holster from "../src/holster.js"
6
+
7
+ describe("holster.user.lex", () => {
8
+ const wss = new Server("ws://localhost:1234")
9
+ const holster = Holster({
10
+ file: "test/holster.user.lex",
11
+ wss: wss,
12
+ maxAge: 100,
13
+ })
14
+ const user = holster.user()
15
+ let alice = ""
16
+
17
+ test("user create", (t, done) => {
18
+ user.create("alice", "password", err => {
19
+ assert.equal(err, null)
20
+ done()
21
+ })
22
+ })
23
+
24
+ test("user auth", (t, done) => {
25
+ user.auth("alice", "password", err => {
26
+ assert.equal(err, null)
27
+ assert.equal(user.is.username, "alice")
28
+ alice = user.is.pub
29
+ done()
30
+ })
31
+ })
32
+
33
+ test("put and get object in graph format", (t, done) => {
34
+ const plain = {
35
+ key: "plain value",
36
+ true: true,
37
+ false: false,
38
+ number: 42,
39
+ }
40
+ user.get("plain").put(plain, err => {
41
+ assert.equal(err, null)
42
+
43
+ // Prefix tests. (Need to be sequential to match return values.)
44
+ user.get("plain", {".": {"*": "k"}}, data => {
45
+ assert.deepEqual(data, {key: "plain value"})
46
+
47
+ user.get("plain", {".": {"*": "t"}}, data => {
48
+ assert.deepEqual(data, {true: true})
49
+
50
+ user.get("plain", {".": {"*": "f"}}, data => {
51
+ assert.deepEqual(data, {false: false})
52
+
53
+ user.get("plain", {".": {"*": "n"}}, data => {
54
+ assert.deepEqual(data, {number: 42})
55
+ })
56
+
57
+ // Both less than and greater than.
58
+ user.get("plain", {".": {"<": "n", ">": "falsy"}}, data => {
59
+ assert.deepEqual(data, {key: "plain value"})
60
+
61
+ // Only less than.
62
+ user.get("plain", {".": {"<": "k"}}, data => {
63
+ assert.deepEqual(data, {false: false})
64
+
65
+ // Only greater than.
66
+ user.get("plain", {".": {">": "numbers"}}, data => {
67
+ assert.deepEqual(data, {true: true})
68
+ done()
69
+ })
70
+ })
71
+ })
72
+ })
73
+ })
74
+ })
75
+ })
76
+ })
77
+
78
+ test("put and get nested object", (t, done) => {
79
+ const nested = {
80
+ key: "nested value",
81
+ other: "other value",
82
+ child: {
83
+ has: "child value",
84
+ other: "other child value",
85
+ },
86
+ }
87
+ user.get("nested").put(nested, err => {
88
+ assert.equal(err, null)
89
+
90
+ // Getting a nested object requires waiting for radisk to write to disk,
91
+ // as it will batch the writes. (Default wait is 1 millisecond.)
92
+ setTimeout(() => {
93
+ user.get("nested", {".": {"*": "k"}}, data => {
94
+ assert.deepEqual(data, {key: "nested value"})
95
+
96
+ user.get("nested").next("child", {".": {"*": "h"}}, data => {
97
+ assert.deepEqual(data, {has: "child value"})
98
+
99
+ user.get("nested").next("child", {".": {"<": "has"}}, data => {
100
+ // Less than means less than or equal to in lex.
101
+ assert.deepEqual(data, {has: "child value"})
102
+ done()
103
+ })
104
+ })
105
+ })
106
+ }, 2)
107
+ })
108
+ })
109
+
110
+ test("on and put nested object", (t, done) => {
111
+ const nested = {
112
+ key: "nested key",
113
+ child: {
114
+ has: "child key",
115
+ },
116
+ }
117
+ // The node needs to exist before it can be listend to for updates.
118
+ user.get("on-nested").put(nested, err => {
119
+ assert.equal(err, null)
120
+
121
+ const update = {
122
+ child: {
123
+ has: "child update",
124
+ },
125
+ }
126
+ user
127
+ .get("on-nested")
128
+ .next("child")
129
+ .on({".": {">": "h"}}, data => {
130
+ assert.deepEqual(data, update.child)
131
+ done()
132
+ })
133
+
134
+ setTimeout(() => {
135
+ user.get("on-nested").put(update, err => {
136
+ assert.equal(err, null)
137
+ })
138
+ }, 10)
139
+ })
140
+ })
141
+
142
+ test("cleanup", (t, done) => {
143
+ fs.rm("test/holster.user.lex", {recursive: true, force: true}, err => {
144
+ assert.equal(err, null)
145
+ done()
146
+ })
147
+ })
148
+ })
@@ -0,0 +1,72 @@
1
+ import fs from "fs"
2
+ import {Server} from "mock-socket"
3
+ import {describe, test} from "node:test"
4
+ import assert from "node:assert/strict"
5
+ import Holster from "../src/holster.js"
6
+
7
+ describe("holster.user.off", () => {
8
+ const wss = new Server("ws://localhost:1234")
9
+ const holster = Holster({
10
+ file: "test/holster.user.off",
11
+ wss: wss,
12
+ maxAge: 100,
13
+ })
14
+ const user = holster.user()
15
+
16
+ test("user create", (t, done) => {
17
+ user.create("alice", "password", err => {
18
+ assert.equal(err, null)
19
+ done()
20
+ })
21
+ })
22
+
23
+ test("user auth", (t, done) => {
24
+ user.auth("alice", "password", err => {
25
+ assert.equal(err, null)
26
+ done()
27
+ })
28
+ })
29
+
30
+ test("calling off without get callback null", (t, done) => {
31
+ user.off(data => {
32
+ assert.equal(data, null)
33
+ done()
34
+ })
35
+ })
36
+
37
+ test("off with cb for property then update - no event", (t, done) => {
38
+ const cb = data => {
39
+ console.log("should not be called for key:", data)
40
+ done()
41
+ }
42
+ user.get("key").on(cb)
43
+ user.get("key").off(cb)
44
+
45
+ user.get("key").put("value", err => {
46
+ assert.equal(err, null)
47
+ done()
48
+ })
49
+ })
50
+
51
+ test("off no cb for property then update - no event", (t, done) => {
52
+ user.get("key1").on(data => {
53
+ console.log("should not be called for key1:", data)
54
+ done()
55
+ })
56
+ setTimeout(() => {
57
+ user.get("key1").off()
58
+
59
+ user.get("key1").put("value1", err => {
60
+ assert.equal(err, null)
61
+ done()
62
+ })
63
+ }, 10)
64
+ })
65
+
66
+ test("cleanup", (t, done) => {
67
+ fs.rm("test/holster.user.off", {recursive: true, force: true}, err => {
68
+ assert.equal(err, null)
69
+ done()
70
+ })
71
+ })
72
+ })
@@ -0,0 +1,185 @@
1
+ import fs from "fs"
2
+ import {Server} from "mock-socket"
3
+ import {describe, test} from "node:test"
4
+ import assert from "node:assert/strict"
5
+ import Holster from "../src/holster.js"
6
+
7
+ describe("holster.user.on", () => {
8
+ const wss = new Server("ws://localhost:1234")
9
+ const holster = Holster({file: "test/holster.user.on", wss: wss, maxAge: 100})
10
+ const user = holster.user()
11
+
12
+ test("user create", (t, done) => {
13
+ user.create("alice", "password", err => {
14
+ assert.equal(err, null)
15
+ done()
16
+ })
17
+ })
18
+
19
+ test("user auth", (t, done) => {
20
+ user.auth("alice", "password", err => {
21
+ assert.equal(err, null)
22
+ done()
23
+ })
24
+ })
25
+
26
+ test("calling on without get callback null", (t, done) => {
27
+ user.on(data => {
28
+ assert.equal(data, null)
29
+ done()
30
+ })
31
+ })
32
+
33
+ test("on for property then update - event", (t, done) => {
34
+ // The property needs to exist before it can be listend to for updates.
35
+ user.get("key").put("value", err => {
36
+ assert.equal(err, null)
37
+
38
+ user.get("key").on(data => {
39
+ assert.equal(data, "update")
40
+ user.get("key").off()
41
+ done()
42
+ })
43
+
44
+ user.get("key").put("update", err => {
45
+ assert.equal(err, null)
46
+ })
47
+ })
48
+ })
49
+
50
+ test("on for different property - no event", (t, done) => {
51
+ user.get("key1").on(data => {
52
+ console.log("should not be called for key1:", data)
53
+ done() // This done is not called and test would fail if it was.
54
+ })
55
+
56
+ user.get("key2").put("value2", err => {
57
+ assert.equal(err, null)
58
+ done()
59
+ })
60
+ })
61
+
62
+ test("on for property two updates - two events", (t, done) => {
63
+ user.get("key3").put("value3", err => {
64
+ assert.equal(err, null)
65
+
66
+ let first = true
67
+ user.get("key3").on(data => {
68
+ if (first) {
69
+ assert.equal(data, "update1")
70
+ } else {
71
+ assert.equal(data, "update2")
72
+ done()
73
+ }
74
+ })
75
+
76
+ user.get("key3").put("update1", err => {
77
+ assert.equal(err, null)
78
+ })
79
+
80
+ setTimeout(() => {
81
+ first = false
82
+ user.get("key3").put("update2", err => {
83
+ assert.equal(err, null)
84
+ })
85
+ }, 200)
86
+ })
87
+ })
88
+
89
+ test("chained next before on", (t, done) => {
90
+ // The node needs to exist before it can be listend to for updates.
91
+ user
92
+ .get("hello")
93
+ .next("world!")
94
+ .put("ok", err => {
95
+ assert.equal(err, null)
96
+
97
+ user
98
+ .get("hello")
99
+ .next("world!")
100
+ .on(data => {
101
+ assert.equal(data, "update")
102
+ user.get("hello").next("world!").off()
103
+ done()
104
+ })
105
+
106
+ setTimeout(() => {
107
+ user
108
+ .get("hello")
109
+ .next("world!")
110
+ .put("update", err => {
111
+ assert.equal(err, null)
112
+ })
113
+ }, 10)
114
+ })
115
+ })
116
+
117
+ test("on and put object in graph format", (t, done) => {
118
+ const plain = {
119
+ key: "plain value",
120
+ number: 42,
121
+ }
122
+ user.get("plain").put(plain, err => {
123
+ assert.equal(err, null)
124
+
125
+ const update = {
126
+ key: "update",
127
+ number: 42,
128
+ }
129
+ user.get("plain").on(data => {
130
+ assert.deepEqual(data, update)
131
+ done()
132
+ })
133
+
134
+ setTimeout(() => {
135
+ user.get("plain").put(update, err => {
136
+ assert.equal(err, null)
137
+ })
138
+ }, 10)
139
+ })
140
+ })
141
+
142
+ test("on and put nested object", (t, done) => {
143
+ const nested = {
144
+ key: "nested key",
145
+ child: {
146
+ has: "child key",
147
+ },
148
+ }
149
+ // The node needs to exist before it can be listend to for updates.
150
+ user.get("nested").put(nested, err => {
151
+ assert.equal(err, null)
152
+
153
+ const update = {
154
+ key: "nested update",
155
+ child: {
156
+ has: "child update",
157
+ },
158
+ }
159
+ user.get("nested").on(data => {
160
+ assert.deepEqual(data, update)
161
+ })
162
+
163
+ user
164
+ .get("nested")
165
+ .next("child")
166
+ .on(data => {
167
+ assert.deepEqual(data, update.child)
168
+ done()
169
+ })
170
+
171
+ setTimeout(() => {
172
+ user.get("nested").put(update, err => {
173
+ assert.equal(err, null)
174
+ })
175
+ }, 10)
176
+ })
177
+ })
178
+
179
+ test("cleanup", (t, done) => {
180
+ fs.rm("test/holster.user.on", {recursive: true, force: true}, err => {
181
+ assert.equal(err, null)
182
+ done()
183
+ })
184
+ })
185
+ })