@reldens/skills 0.46.0 → 0.48.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 (40) hide show
  1. package/.claude/architecture.md +472 -0
  2. package/.claude/class-hierarchy.md +982 -0
  3. package/.claude/event-system-architecture.md +475 -0
  4. package/.claude/level-progression.md +1259 -0
  5. package/.claude/skill-execution-flow.md +979 -0
  6. package/.claude/testing-guide.md +356 -0
  7. package/.claude/testing-patterns.md +1096 -0
  8. package/CLAUDE.md +164 -29
  9. package/lib/class-path.js +13 -10
  10. package/lib/client/receiver.js +1 -3
  11. package/lib/levels-set.js +24 -17
  12. package/lib/server/sender.js +1 -1
  13. package/lib/skill.js +19 -16
  14. package/lib/types/attack.js +28 -11
  15. package/lib/types/effect.js +10 -4
  16. package/lib/types/physical-attack.js +2 -2
  17. package/lib/types/physical-effect.js +2 -2
  18. package/lib/types/physical-properties-validator.js +1 -1
  19. package/lib/types/physical-skill-runner.js +5 -5
  20. package/package.json +9 -3
  21. package/tests/fixtures/levels/base-levels.js +89 -0
  22. package/tests/fixtures/mocks/mock-client.js +44 -0
  23. package/tests/fixtures/mocks/mock-owner.js +60 -0
  24. package/tests/fixtures/mocks/mock-target.js +50 -0
  25. package/tests/fixtures/skills/base-skills.js +80 -0
  26. package/tests/run-tests.js +88 -0
  27. package/tests/unit/client/test-receiver.js +249 -0
  28. package/tests/unit/server/test-sender.js +527 -0
  29. package/tests/unit/test-class-path.js +1239 -0
  30. package/tests/unit/test-level.js +176 -0
  31. package/tests/unit/test-levels-set.js +1227 -0
  32. package/tests/unit/test-server.js +266 -0
  33. package/tests/unit/test-skill.js +1302 -0
  34. package/tests/unit/types/test-attack.js +1195 -0
  35. package/tests/unit/types/test-effect.js +587 -0
  36. package/tests/unit/types/test-physical-attack.js +564 -0
  37. package/tests/unit/types/test-physical-effect.js +769 -0
  38. package/tests/unit/types/test-physical-properties-validator.js +203 -0
  39. package/tests/unit/types/test-physical-skill-runner.js +348 -0
  40. package/tests/utils/test-helpers.js +122 -0
@@ -0,0 +1,266 @@
1
+ /**
2
+ *
3
+ * Reldens - SkillsServer Unit Tests
4
+ *
5
+ */
6
+
7
+ const { describe, it, beforeEach, afterEach } = require('node:test');
8
+ const assert = require('node:assert');
9
+ const SkillsServer = require('../../lib/server');
10
+ const ClassPath = require('../../lib/class-path');
11
+ const Sender = require('../../lib/server/sender');
12
+ const { TestHelpers } = require('../utils/test-helpers');
13
+ const { MockOwner } = require('../fixtures/mocks/mock-owner');
14
+ const { BaseLevelsFixtures } = require('../fixtures/levels/base-levels');
15
+
16
+ describe('SkillsServer', () => {
17
+ let mockOwner;
18
+ let mockClient;
19
+
20
+ beforeEach(() => {
21
+ mockOwner = new MockOwner();
22
+ mockClient = TestHelpers.createMockClient();
23
+ TestHelpers.clearEventListeners();
24
+ });
25
+
26
+ afterEach(() => {
27
+ TestHelpers.clearEventListeners();
28
+ });
29
+
30
+ describe('Constructor', () => {
31
+ it('should initialize with default values', () => {
32
+ let props = {
33
+ owner: mockOwner,
34
+ key: 'test',
35
+ levels: BaseLevelsFixtures.createLevelSet()
36
+ };
37
+ let server = new SkillsServer(props);
38
+ assert.ok(server);
39
+ assert.ok(server.classPath instanceof ClassPath);
40
+ assert.strictEqual(server.client, false);
41
+ });
42
+
43
+ it('should call setupServer during construction', () => {
44
+ let props = {
45
+ owner: mockOwner,
46
+ key: 'test',
47
+ levels: BaseLevelsFixtures.createLevelSet()
48
+ };
49
+ let server = new SkillsServer(props);
50
+ assert.ok(server.classPath);
51
+ });
52
+ });
53
+
54
+ describe('setupServer()', () => {
55
+ it('should setup server with valid props', () => {
56
+ let props = {
57
+ owner: mockOwner,
58
+ key: 'test',
59
+ levels: BaseLevelsFixtures.createLevelSet()
60
+ };
61
+ let server = new SkillsServer(props);
62
+ assert.ok(server.classPath);
63
+ assert.ok(server.classPath.owner);
64
+ });
65
+
66
+ it('should return false when owner is missing', () => {
67
+ let props = {
68
+ key: 'test',
69
+ levels: BaseLevelsFixtures.createLevelSet()
70
+ };
71
+ let server = new SkillsServer(props);
72
+ assert.strictEqual(server.classPath, false);
73
+ });
74
+
75
+ it('should return false when owner is null', () => {
76
+ let props = {
77
+ owner: null,
78
+ key: 'test',
79
+ levels: BaseLevelsFixtures.createLevelSet()
80
+ };
81
+ assert.throws(
82
+ () => new SkillsServer(props),
83
+ TypeError
84
+ );
85
+ });
86
+
87
+ it('should return false when owner.getPosition is not a function', () => {
88
+ let invalidOwner = {id: 'test'};
89
+ let props = {
90
+ owner: invalidOwner,
91
+ key: 'test',
92
+ levels: BaseLevelsFixtures.createLevelSet()
93
+ };
94
+ let server = new SkillsServer(props);
95
+ assert.strictEqual(server.classPath, false);
96
+ });
97
+
98
+ it('should return false when owner.getPosition is missing', () => {
99
+ let invalidOwner = {id: 'test', stats: {}};
100
+ let props = {
101
+ owner: invalidOwner,
102
+ key: 'test',
103
+ levels: BaseLevelsFixtures.createLevelSet()
104
+ };
105
+ let server = new SkillsServer(props);
106
+ assert.strictEqual(server.classPath, false);
107
+ });
108
+ });
109
+
110
+ describe('Client Validation', () => {
111
+ it('should return false when client.send is not a function', () => {
112
+ let invalidClient = {broadcast: () => {}};
113
+ let props = {
114
+ owner: mockOwner,
115
+ client: invalidClient,
116
+ key: 'test',
117
+ levels: BaseLevelsFixtures.createLevelSet()
118
+ };
119
+ let server = new SkillsServer(props);
120
+ assert.strictEqual(server.client, false);
121
+ });
122
+
123
+ it('should return false when client.send is missing', () => {
124
+ let invalidClient = {broadcast: () => {}};
125
+ let props = {
126
+ owner: mockOwner,
127
+ client: invalidClient,
128
+ key: 'test',
129
+ levels: BaseLevelsFixtures.createLevelSet()
130
+ };
131
+ let server = new SkillsServer(props);
132
+ assert.strictEqual(server.client, false);
133
+ });
134
+
135
+ it('should return false when client.broadcast is not a function', () => {
136
+ let invalidClient = {send: () => {}, broadcast: 'not-a-function'};
137
+ let props = {
138
+ owner: mockOwner,
139
+ client: invalidClient,
140
+ key: 'test',
141
+ levels: BaseLevelsFixtures.createLevelSet()
142
+ };
143
+ let server = new SkillsServer(props);
144
+ assert.strictEqual(server.client, false);
145
+ });
146
+
147
+ it('should return false when client.broadcast is missing', () => {
148
+ let invalidClient = {send: () => {}};
149
+ let props = {
150
+ owner: mockOwner,
151
+ client: invalidClient,
152
+ key: 'test',
153
+ levels: BaseLevelsFixtures.createLevelSet()
154
+ };
155
+ let server = new SkillsServer(props);
156
+ assert.strictEqual(server.client, false);
157
+ });
158
+
159
+ it('should setup client when valid', () => {
160
+ let props = {
161
+ owner: mockOwner,
162
+ client: mockClient,
163
+ key: 'test',
164
+ levels: BaseLevelsFixtures.createLevelSet()
165
+ };
166
+ let server = new SkillsServer(props);
167
+ assert.ok(server.client instanceof Sender);
168
+ });
169
+ });
170
+
171
+ describe('ClassPath Integration', () => {
172
+ it('should create new ClassPath when not provided', () => {
173
+ let props = {
174
+ owner: mockOwner,
175
+ key: 'test',
176
+ levels: BaseLevelsFixtures.createLevelSet()
177
+ };
178
+ let server = new SkillsServer(props);
179
+ assert.ok(server.classPath instanceof ClassPath);
180
+ });
181
+
182
+ it('should use provided ClassPath', () => {
183
+ let existingClassPath = new ClassPath({owner: mockOwner});
184
+ let props = {
185
+ owner: mockOwner,
186
+ classPath: existingClassPath,
187
+ key: 'test',
188
+ levels: BaseLevelsFixtures.createLevelSet()
189
+ };
190
+ let server = new SkillsServer(props);
191
+ assert.strictEqual(server.classPath, existingClassPath);
192
+ });
193
+
194
+ it('should call setOwner on classPath', () => {
195
+ let props = {
196
+ owner: mockOwner,
197
+ key: 'test',
198
+ levels: BaseLevelsFixtures.createLevelSet()
199
+ };
200
+ let server = new SkillsServer(props);
201
+ assert.strictEqual(server.classPath.owner, mockOwner);
202
+ });
203
+
204
+ it('should call init on classPath', () => {
205
+ let props = {
206
+ owner: mockOwner,
207
+ key: 'test',
208
+ levels: BaseLevelsFixtures.createLevelSet()
209
+ };
210
+ let server = new SkillsServer(props);
211
+ assert.ok(server.classPath);
212
+ });
213
+ });
214
+
215
+ describe('Sender Integration', () => {
216
+ it('should instantiate Sender when client is provided', () => {
217
+ let props = {
218
+ owner: mockOwner,
219
+ client: mockClient,
220
+ key: 'test',
221
+ levels: BaseLevelsFixtures.createLevelSet()
222
+ };
223
+ let server = new SkillsServer(props);
224
+ assert.ok(server.client instanceof Sender);
225
+ });
226
+
227
+ it('should call registerListeners on Sender', () => {
228
+ let props = {
229
+ owner: mockOwner,
230
+ client: mockClient,
231
+ key: 'test',
232
+ levels: BaseLevelsFixtures.createLevelSet()
233
+ };
234
+ let server = new SkillsServer(props);
235
+ assert.ok(server.client instanceof Sender);
236
+ });
237
+
238
+ it('should not create Sender when client is not provided', () => {
239
+ let props = {
240
+ owner: mockOwner,
241
+ key: 'test',
242
+ levels: BaseLevelsFixtures.createLevelSet()
243
+ };
244
+ let server = new SkillsServer(props);
245
+ assert.strictEqual(server.client, false);
246
+ });
247
+ });
248
+
249
+ describe('End-to-End Initialization', () => {
250
+ it('should complete full server initialization with all components', () => {
251
+ let props = {
252
+ owner: mockOwner,
253
+ client: mockClient,
254
+ key: 'warrior',
255
+ label: 'Warrior',
256
+ levels: BaseLevelsFixtures.createLevelSet(),
257
+ currentLevel: 1,
258
+ currentExp: 0
259
+ };
260
+ let server = new SkillsServer(props);
261
+ assert.ok(server.classPath instanceof ClassPath);
262
+ assert.ok(server.client instanceof Sender);
263
+ assert.strictEqual(server.classPath.owner, mockOwner);
264
+ });
265
+ });
266
+ });