@peers-app/peers-sdk 0.18.8 → 0.19.6

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 (60) hide show
  1. package/README.md +74 -1
  2. package/dist/data/files/file-read-stream.js +7 -0
  3. package/dist/data/files/file.types.d.ts +6 -0
  4. package/dist/data/files/file.types.js +18 -0
  5. package/dist/data/files/files.test.js +50 -7
  6. package/dist/data/package-version-resolver.d.ts +13 -5
  7. package/dist/data/package-version-resolver.js +64 -6
  8. package/dist/data/package-version-resolver.test.d.ts +0 -4
  9. package/dist/data/package-version-resolver.test.js +127 -5
  10. package/dist/data/package-versions.d.ts +3 -0
  11. package/dist/data/package-versions.js +5 -0
  12. package/dist/data/packages.d.ts +6 -29
  13. package/dist/data/packages.js +8 -6
  14. package/dist/index.d.ts +1 -0
  15. package/dist/index.js +1 -0
  16. package/dist/package-installer/index.d.ts +10 -0
  17. package/dist/package-installer/index.js +26 -0
  18. package/dist/package-installer/package-author-signing.d.ts +54 -0
  19. package/dist/package-installer/package-author-signing.js +82 -0
  20. package/dist/package-installer/package-author-signing.test.d.ts +1 -0
  21. package/dist/package-installer/package-author-signing.test.js +189 -0
  22. package/dist/package-installer/package-cloner.d.ts +16 -0
  23. package/dist/package-installer/package-cloner.js +115 -0
  24. package/dist/package-installer/package-cloner.test.d.ts +1 -0
  25. package/dist/package-installer/package-cloner.test.js +276 -0
  26. package/dist/package-installer/package-creator.d.ts +22 -0
  27. package/dist/package-installer/package-creator.js +154 -0
  28. package/dist/package-installer/package-creator.test.d.ts +1 -0
  29. package/dist/package-installer/package-creator.test.js +354 -0
  30. package/dist/package-installer/package-installer.d.ts +32 -0
  31. package/dist/package-installer/package-installer.js +247 -0
  32. package/dist/package-installer/package-installer.test.d.ts +1 -0
  33. package/dist/package-installer/package-installer.test.js +666 -0
  34. package/dist/package-installer/package-propagation.d.ts +29 -0
  35. package/dist/package-installer/package-propagation.js +364 -0
  36. package/dist/package-installer/package-propagation.test.d.ts +1 -0
  37. package/dist/package-installer/package-propagation.test.js +1145 -0
  38. package/dist/package-installer/package-publisher.d.ts +55 -0
  39. package/dist/package-installer/package-publisher.js +71 -0
  40. package/dist/package-installer/package-publisher.test.d.ts +1 -0
  41. package/dist/package-installer/package-publisher.test.js +142 -0
  42. package/dist/package-installer/package-remote-checker.d.ts +54 -0
  43. package/dist/package-installer/package-remote-checker.js +194 -0
  44. package/dist/package-installer/package-remote-checker.test.d.ts +1 -0
  45. package/dist/package-installer/package-remote-checker.test.js +269 -0
  46. package/dist/package-installer/package-seed-installer.d.ts +45 -0
  47. package/dist/package-installer/package-seed-installer.js +108 -0
  48. package/dist/package-installer/package-seed-installer.test.d.ts +1 -0
  49. package/dist/package-installer/package-seed-installer.test.js +123 -0
  50. package/dist/package-installer/package-tarball.d.ts +35 -0
  51. package/dist/package-installer/package-tarball.js +57 -0
  52. package/dist/package-installer/package-tarball.test.d.ts +1 -0
  53. package/dist/package-installer/package-tarball.test.js +75 -0
  54. package/dist/package-installer/types.d.ts +110 -0
  55. package/dist/package-installer/types.js +2 -0
  56. package/dist/rpc-types.d.ts +14 -0
  57. package/dist/rpc-types.js +6 -0
  58. package/dist/system-ids.d.ts +1 -0
  59. package/dist/system-ids.js +2 -1
  60. package/package.json +3 -2
@@ -0,0 +1,666 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const file_types_1 = require("../data/files/file.types");
4
+ const utils_1 = require("../utils");
5
+ const package_installer_1 = require("./package-installer");
6
+ // --- Mocks for SDK internals ---
7
+ const mockFindOnePV = jest.fn();
8
+ const mockSignAndSavePV = jest.fn();
9
+ jest.mock("../data/package-versions", () => {
10
+ const actual = jest.requireActual("../data/package-versions");
11
+ return {
12
+ ...actual,
13
+ PackageVersions: () => ({
14
+ findOne: mockFindOnePV,
15
+ signAndSave: mockSignAndSavePV,
16
+ list: jest.fn().mockResolvedValue([]),
17
+ }),
18
+ };
19
+ });
20
+ const mockGetPkg = jest.fn();
21
+ const mockSignAndSavePkg = jest.fn();
22
+ const mockListPkgs = jest.fn();
23
+ jest.mock("../data/packages", () => ({
24
+ Packages: () => ({
25
+ get: mockGetPkg,
26
+ signAndSave: mockSignAndSavePkg,
27
+ list: mockListPkgs,
28
+ }),
29
+ }));
30
+ const mockFindOneFile = jest.fn();
31
+ const mockSaveFile = jest.fn();
32
+ jest.mock("../data/files/files", () => ({
33
+ Files: () => ({
34
+ findOne: mockFindOneFile,
35
+ saveFile: mockSaveFile,
36
+ }),
37
+ }));
38
+ const mockUpdatePackagePrefs = jest.fn();
39
+ const mockResolveDevicePackageVersion = jest.fn();
40
+ jest.mock("../data/package-version-resolver", () => ({
41
+ updatePackagePrefs: (...args) => mockUpdatePackagePrefs(...args),
42
+ resolveDevicePackageVersion: (...args) => mockResolveDevicePackageVersion(...args),
43
+ }));
44
+ const mockGroupDeviceVar = jest.fn();
45
+ jest.mock("../data/persistent-vars", () => {
46
+ const actual = jest.requireActual("../data/persistent-vars");
47
+ return {
48
+ ...actual,
49
+ groupDeviceVar: (...args) => mockGroupDeviceVar(...args),
50
+ };
51
+ });
52
+ // --- Test utilities ---
53
+ function makeMockDeps(files, shellExec) {
54
+ return {
55
+ fs: {
56
+ readFile: jest.fn(async (path) => {
57
+ if (files[path] !== undefined)
58
+ return files[path];
59
+ throw new Error(`ENOENT: ${path}`);
60
+ }),
61
+ writeFile: jest.fn(async () => { }),
62
+ exists: jest.fn(async (path) => {
63
+ if (path in files)
64
+ return true;
65
+ // Treat as directory if any file has this path as a prefix
66
+ const dirPrefix = path.endsWith("/") ? path : `${path}/`;
67
+ return Object.keys(files).some((f) => f.startsWith(dirPrefix));
68
+ }),
69
+ readJson: jest.fn(async (path) => {
70
+ if (files[path] === undefined)
71
+ throw new Error(`ENOENT: ${path}`);
72
+ return JSON.parse(files[path]);
73
+ }),
74
+ },
75
+ shell: {
76
+ exec: shellExec ?? jest.fn(async () => ({ stdout: "", stderr: "" })),
77
+ },
78
+ resolvePath: (...segments) => segments.join("/"),
79
+ packagesRootDir: "/packages",
80
+ };
81
+ }
82
+ function mockDataContext(overrides = {}) {
83
+ return {
84
+ packageLoader: {
85
+ loadPackage: jest.fn().mockResolvedValue(undefined),
86
+ },
87
+ ...overrides,
88
+ };
89
+ }
90
+ // --- Tests ---
91
+ beforeEach(() => {
92
+ jest.clearAllMocks();
93
+ mockSignAndSavePV.mockImplementation(async (pv) => pv);
94
+ mockSaveFile.mockImplementation(async (metadata, _content) => ({
95
+ fileId: metadata.fileId,
96
+ fileHash: (0, file_types_1.computeFileHash)(typeof _content === "string" ? _content : ""),
97
+ name: metadata.name,
98
+ fileSize: metadata.fileSize,
99
+ mimeType: metadata.mimeType,
100
+ }));
101
+ });
102
+ describe("saveBundleFile", () => {
103
+ it("creates a new File record when none exists with the same hash", async () => {
104
+ mockFindOneFile.mockResolvedValue(undefined);
105
+ const dc = mockDataContext();
106
+ const content = "console.log('hello');";
107
+ const result = await (0, package_installer_1.saveBundleFile)(dc, content, "pkg-package.bundle.js", "pkgId");
108
+ expect(mockFindOneFile).toHaveBeenCalledWith({
109
+ name: "pkg-package.bundle.js",
110
+ fileHash: (0, file_types_1.computeFileHash)(content),
111
+ });
112
+ expect(mockSaveFile).toHaveBeenCalledTimes(1);
113
+ expect(result.fileHash).toBe((0, file_types_1.computeFileHash)(content));
114
+ expect(result.fileId).toBeDefined();
115
+ });
116
+ it("returns existing File when hash matches (deduplication)", async () => {
117
+ const existingFileId = (0, utils_1.newid)();
118
+ const content = "console.log('same');";
119
+ const expectedHash = (0, file_types_1.computeFileHash)(content);
120
+ mockFindOneFile.mockResolvedValue({
121
+ fileId: existingFileId,
122
+ fileHash: expectedHash,
123
+ });
124
+ const dc = mockDataContext();
125
+ const result = await (0, package_installer_1.saveBundleFile)(dc, content, "pkg-package.bundle.js", "pkgId");
126
+ expect(result.fileId).toBe(existingFileId);
127
+ expect(result.fileHash).toBe(expectedHash);
128
+ expect(mockSaveFile).not.toHaveBeenCalled();
129
+ });
130
+ it("creates different file records for different content", async () => {
131
+ mockFindOneFile.mockResolvedValue(undefined);
132
+ const dc = mockDataContext();
133
+ const result1 = await (0, package_installer_1.saveBundleFile)(dc, "content-a", "pkg-bundle.js", "pkgId");
134
+ const result2 = await (0, package_installer_1.saveBundleFile)(dc, "content-b", "pkg-bundle.js", "pkgId");
135
+ expect(result1.fileHash).not.toBe(result2.fileHash);
136
+ expect(mockSaveFile).toHaveBeenCalledTimes(2);
137
+ });
138
+ });
139
+ describe("getPackageInfo", () => {
140
+ it("reads name, version, description, packageId from package.json", async () => {
141
+ const deps = makeMockDeps({
142
+ "/pkg/package.json": JSON.stringify({
143
+ name: "my-package",
144
+ version: "2.1.0",
145
+ description: "A test package",
146
+ peers: { packageId: "abc123" },
147
+ }),
148
+ });
149
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
150
+ expect(info.name).toBe("my-package");
151
+ expect(info.version).toBe("2.1.0");
152
+ expect(info.description).toBe("A test package");
153
+ expect(info.packageId).toBe("abc123");
154
+ });
155
+ it("enriches description from README first paragraph", async () => {
156
+ const deps = makeMockDeps({
157
+ "/pkg/package.json": JSON.stringify({
158
+ name: "my-package",
159
+ description: "short desc",
160
+ }),
161
+ "/pkg/README.md": "# My Package\n\nThis is a richer description from the README.\n\n## Details",
162
+ });
163
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
164
+ expect(info.description).toBe("This is a richer description from the README.");
165
+ });
166
+ it("detects remoteRepo from git remote", async () => {
167
+ const shellExec = jest.fn(async () => ({
168
+ stdout: "https://github.com/org/repo.git\n",
169
+ stderr: "",
170
+ }));
171
+ const deps = makeMockDeps({
172
+ "/pkg/package.json": JSON.stringify({ name: "my-package" }),
173
+ }, shellExec);
174
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
175
+ expect(shellExec).toHaveBeenCalledWith("git remote get-url origin", { cwd: "/pkg" });
176
+ expect(info.remoteRepo).toBe("https://github.com/org/repo.git");
177
+ });
178
+ it("handles missing git remote gracefully", async () => {
179
+ const shellExec = jest.fn(async () => {
180
+ throw new Error("fatal: No remote configured");
181
+ });
182
+ const deps = makeMockDeps({ "/pkg/package.json": JSON.stringify({ name: "test" }) }, shellExec);
183
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
184
+ expect(info.remoteRepo).toBeUndefined();
185
+ expect(info.name).toBe("test");
186
+ });
187
+ it("handles missing README gracefully", async () => {
188
+ const deps = makeMockDeps({
189
+ "/pkg/package.json": JSON.stringify({
190
+ name: "pkg",
191
+ description: "from json",
192
+ }),
193
+ });
194
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
195
+ expect(info.description).toBe("from json");
196
+ });
197
+ it("uses 'unknown' when package.json has no name", async () => {
198
+ const deps = makeMockDeps({
199
+ "/pkg/package.json": JSON.stringify({}),
200
+ });
201
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
202
+ expect(info.name).toBe("unknown");
203
+ });
204
+ });
205
+ describe("extractReadmeDescription", () => {
206
+ // The function is not exported, but we re-exported it for testing.
207
+ // Actually let's test it indirectly via getPackageInfo, but we also
208
+ // re-export it. For now, test through getPackageInfo behavior.
209
+ it("skips headings and returns first paragraph", async () => {
210
+ const deps = makeMockDeps({
211
+ "/pkg/package.json": JSON.stringify({ name: "x" }),
212
+ "/pkg/README.md": "# Title\n\n## Subtitle\n\nActual description here.\nSecond line.\n\n## Another section",
213
+ });
214
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
215
+ expect(info.description).toBe("Actual description here. Second line.");
216
+ });
217
+ it("returns undefined for README with only headings", async () => {
218
+ const deps = makeMockDeps({
219
+ "/pkg/package.json": JSON.stringify({ name: "x", description: "fallback" }),
220
+ "/pkg/README.md": "# Title\n\n## Section 1\n\n## Section 2\n",
221
+ });
222
+ const info = await (0, package_installer_1.getPackageInfo)(deps, "/pkg");
223
+ // Should fall back to package.json description since README has no paragraphs
224
+ expect(info.description).toBe("fallback");
225
+ });
226
+ });
227
+ describe("installPackageFromBundles", () => {
228
+ const packageId = "testpkg1234567890abcde";
229
+ const packageBundle = "module.exports = { init() {} };";
230
+ const routesBundle = "module.exports = { routes: [] };";
231
+ const uiBundle = "module.exports = { components: [] };";
232
+ function setupBasicInstall() {
233
+ const files = {
234
+ [`/packages/${packageId}/package.json`]: JSON.stringify({
235
+ name: "test-pkg",
236
+ version: "1.2.3",
237
+ description: "Test package",
238
+ }),
239
+ [`/packages/${packageId}/dist/package.bundle.js`]: packageBundle,
240
+ [`/packages/${packageId}/dist/routes.bundle.js`]: routesBundle,
241
+ [`/packages/${packageId}/dist/uis.bundle.js`]: uiBundle,
242
+ };
243
+ const deps = makeMockDeps(files);
244
+ // Mock groupDeviceVar to return the local path
245
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => `/packages/${packageId}`, {
246
+ loadingPromise: Promise.resolve(),
247
+ }));
248
+ // No existing PV
249
+ mockFindOnePV.mockResolvedValue(undefined);
250
+ mockFindOneFile.mockResolvedValue(undefined);
251
+ // Package exists
252
+ mockGetPkg.mockResolvedValue({
253
+ packageId,
254
+ name: "test-pkg",
255
+ description: "Old description",
256
+ signature: "",
257
+ createdBy: "user1",
258
+ });
259
+ return { deps, files };
260
+ }
261
+ it("installs a new package version from bundles", async () => {
262
+ const { deps } = setupBasicInstall();
263
+ const dc = mockDataContext();
264
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
265
+ skipLoad: true,
266
+ skipResolve: true,
267
+ });
268
+ expect(result.unchanged).toBe(false);
269
+ expect(result.packageVersion.packageId).toBe(packageId);
270
+ expect(result.packageVersion.version).toBe("1.2.3");
271
+ expect(result.packageVersion.versionTag).toBe("dev");
272
+ expect(result.packageVersion.packageBundleFileId).toBeDefined();
273
+ expect(result.packageVersion.routesBundleFileId).toBeDefined();
274
+ expect(result.packageVersion.uiBundleFileId).toBeDefined();
275
+ expect(mockSignAndSavePV).toHaveBeenCalledTimes(1);
276
+ });
277
+ it("returns unchanged when PV hash matches", async () => {
278
+ const { deps } = setupBasicInstall();
279
+ const dc = mockDataContext();
280
+ const packageHash = (0, file_types_1.computeFileHash)(packageBundle);
281
+ const routesHash = (0, file_types_1.computeFileHash)(routesBundle);
282
+ const uiHash = (0, file_types_1.computeFileHash)(uiBundle);
283
+ // Import the actual function to compute expected hash
284
+ const { computePackageVersionHash } = jest.requireActual("../data/package-versions");
285
+ const expectedPvHash = computePackageVersionHash("1.2.3", "", packageHash, routesHash, uiHash);
286
+ const existingPv = {
287
+ packageVersionId: (0, utils_1.newid)(),
288
+ packageId,
289
+ version: "1.2.3",
290
+ versionTag: "dev",
291
+ packageVersionHash: expectedPvHash,
292
+ packageBundleFileId: (0, utils_1.newid)(),
293
+ packageBundleFileHash: packageHash,
294
+ signature: "",
295
+ createdBy: "user1",
296
+ createdAt: new Date().toISOString(),
297
+ };
298
+ mockFindOnePV.mockResolvedValue(existingPv);
299
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
300
+ skipLoad: true,
301
+ skipResolve: true,
302
+ });
303
+ expect(result.unchanged).toBe(true);
304
+ expect(result.packageVersion).toBe(existingPv);
305
+ expect(mockSaveFile).not.toHaveBeenCalled();
306
+ expect(mockSignAndSavePV).not.toHaveBeenCalled();
307
+ });
308
+ it("reuses existing PV id when updating", async () => {
309
+ const { deps } = setupBasicInstall();
310
+ const dc = mockDataContext();
311
+ const existingPvId = (0, utils_1.newid)();
312
+ mockFindOnePV.mockResolvedValue({
313
+ packageVersionId: existingPvId,
314
+ packageId,
315
+ version: "1.0.0",
316
+ versionTag: "dev",
317
+ packageVersionHash: "old-hash-different",
318
+ packageBundleFileId: (0, utils_1.newid)(),
319
+ packageBundleFileHash: "old-bundle-hash",
320
+ signature: "old-sig",
321
+ createdBy: "original-creator",
322
+ createdAt: "2024-01-01T00:00:00Z",
323
+ });
324
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
325
+ skipLoad: true,
326
+ skipResolve: true,
327
+ });
328
+ expect(result.unchanged).toBe(false);
329
+ expect(result.packageVersion.packageVersionId).toBe(existingPvId);
330
+ expect(result.packageVersion.version).toBe("1.2.3");
331
+ expect(result.packageVersion.createdBy).toBe("original-creator");
332
+ });
333
+ it("throws when package directory does not exist", async () => {
334
+ const deps = makeMockDeps({});
335
+ const dc = mockDataContext();
336
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => "/nonexistent", {
337
+ loadingPromise: Promise.resolve(),
338
+ }));
339
+ await expect((0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, { skipLoad: true, skipResolve: true })).rejects.toThrow("Package directory does not exist");
340
+ });
341
+ it("throws when package.bundle.js is missing", async () => {
342
+ const deps = makeMockDeps({
343
+ [`/packages/${packageId}/package.json`]: JSON.stringify({ name: "x", version: "1.0.0" }),
344
+ });
345
+ const dc = mockDataContext();
346
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => `/packages/${packageId}`, {
347
+ loadingPromise: Promise.resolve(),
348
+ }));
349
+ await expect((0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, { skipLoad: true, skipResolve: true })).rejects.toThrow("Required bundle not found");
350
+ });
351
+ it("handles package with only package.bundle.js (no routes or UI)", async () => {
352
+ const files = {
353
+ [`/packages/${packageId}/package.json`]: JSON.stringify({
354
+ name: "minimal-pkg",
355
+ version: "0.1.0",
356
+ }),
357
+ [`/packages/${packageId}/dist/package.bundle.js`]: packageBundle,
358
+ };
359
+ const deps = makeMockDeps(files);
360
+ const dc = mockDataContext();
361
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => `/packages/${packageId}`, {
362
+ loadingPromise: Promise.resolve(),
363
+ }));
364
+ mockFindOnePV.mockResolvedValue(undefined);
365
+ mockFindOneFile.mockResolvedValue(undefined);
366
+ mockGetPkg.mockResolvedValue({
367
+ packageId,
368
+ name: "minimal-pkg",
369
+ description: "",
370
+ signature: "",
371
+ createdBy: "u",
372
+ });
373
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
374
+ skipLoad: true,
375
+ skipResolve: true,
376
+ });
377
+ expect(result.unchanged).toBe(false);
378
+ expect(result.packageVersion.routesBundleFileId).toBeUndefined();
379
+ expect(result.packageVersion.uiBundleFileId).toBeUndefined();
380
+ expect(mockSaveFile).toHaveBeenCalledTimes(1);
381
+ });
382
+ it("uses opts.localPath when provided instead of device var", async () => {
383
+ const customPath = "/custom/path/to/pkg";
384
+ const files = {
385
+ [`${customPath}/package.json`]: JSON.stringify({ name: "custom", version: "3.0.0" }),
386
+ [`${customPath}/dist/package.bundle.js`]: packageBundle,
387
+ };
388
+ const deps = makeMockDeps(files);
389
+ const dc = mockDataContext();
390
+ mockFindOnePV.mockResolvedValue(undefined);
391
+ mockFindOneFile.mockResolvedValue(undefined);
392
+ mockGetPkg.mockResolvedValue({
393
+ packageId,
394
+ name: "custom",
395
+ description: "",
396
+ signature: "",
397
+ createdBy: "u",
398
+ });
399
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
400
+ localPath: customPath,
401
+ skipLoad: true,
402
+ skipResolve: true,
403
+ });
404
+ expect(result.packageVersion.version).toBe("3.0.0");
405
+ expect(mockGroupDeviceVar).not.toHaveBeenCalled();
406
+ });
407
+ it("uses opts.versionTag when provided", async () => {
408
+ const { deps } = setupBasicInstall();
409
+ const dc = mockDataContext();
410
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
411
+ versionTag: "beta",
412
+ skipLoad: true,
413
+ skipResolve: true,
414
+ });
415
+ expect(result.packageVersion.versionTag).toBe("beta");
416
+ expect(mockFindOnePV).toHaveBeenCalledWith({ packageId, versionTag: "beta" });
417
+ });
418
+ it("loads the package when skipLoad is false", async () => {
419
+ const { deps } = setupBasicInstall();
420
+ const mockLoadPackage = jest.fn().mockResolvedValue({ packageId, appNavs: [] });
421
+ const dc = mockDataContext({
422
+ packageLoader: { loadPackage: mockLoadPackage },
423
+ });
424
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
425
+ skipResolve: true,
426
+ });
427
+ expect(mockLoadPackage).toHaveBeenCalledWith(expect.objectContaining({ packageId }), expect.objectContaining({ force: true }));
428
+ expect(result.loaded).toEqual({ packageId, appNavs: [] });
429
+ });
430
+ it("updates appNavs on PV when loaded package provides them", async () => {
431
+ const { deps } = setupBasicInstall();
432
+ const appNavs = [{ label: "Test", route: "/test" }];
433
+ const mockLoadPackage = jest.fn().mockResolvedValue({ packageId, appNavs });
434
+ const dc = mockDataContext({
435
+ packageLoader: { loadPackage: mockLoadPackage },
436
+ });
437
+ await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, { skipResolve: true });
438
+ // signAndSave should be called twice: once for initial PV, once for appNavs update
439
+ expect(mockSignAndSavePV).toHaveBeenCalledTimes(2);
440
+ const secondCall = mockSignAndSavePV.mock.calls[1][0];
441
+ expect(secondCall.appNavs).toEqual(appNavs);
442
+ });
443
+ it("calls updatePackagePrefs and resolveDevicePackageVersion when skipResolve is false", async () => {
444
+ const { deps } = setupBasicInstall();
445
+ const dc = mockDataContext();
446
+ await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId);
447
+ expect(mockUpdatePackagePrefs).toHaveBeenCalledWith(packageId, expect.objectContaining({ activePackageVersionId: expect.any(String) }), dc);
448
+ expect(mockResolveDevicePackageVersion).toHaveBeenCalledWith(expect.objectContaining({ packageId }), dc, expect.objectContaining({ force: true }));
449
+ });
450
+ it("updates package description when info differs", async () => {
451
+ const { deps } = setupBasicInstall();
452
+ const dc = mockDataContext();
453
+ await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
454
+ skipLoad: true,
455
+ skipResolve: true,
456
+ });
457
+ expect(mockSignAndSavePkg).toHaveBeenCalledWith(expect.objectContaining({ description: "Test package" }));
458
+ });
459
+ it("does not update package description when unchanged", async () => {
460
+ const files = {
461
+ [`/packages/${packageId}/package.json`]: JSON.stringify({
462
+ name: "test-pkg",
463
+ version: "1.0.0",
464
+ description: "Same description",
465
+ }),
466
+ [`/packages/${packageId}/dist/package.bundle.js`]: packageBundle,
467
+ };
468
+ const deps = makeMockDeps(files);
469
+ const dc = mockDataContext();
470
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => `/packages/${packageId}`, {
471
+ loadingPromise: Promise.resolve(),
472
+ }));
473
+ mockFindOnePV.mockResolvedValue(undefined);
474
+ mockFindOneFile.mockResolvedValue(undefined);
475
+ mockGetPkg.mockResolvedValue({
476
+ packageId,
477
+ name: "test-pkg",
478
+ description: "Same description",
479
+ signature: "",
480
+ createdBy: "u",
481
+ });
482
+ await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
483
+ skipLoad: true,
484
+ skipResolve: true,
485
+ });
486
+ expect(mockSignAndSavePkg).not.toHaveBeenCalled();
487
+ });
488
+ it("defaults version to 0.0.1 when package.json has no version", async () => {
489
+ const files = {
490
+ [`/packages/${packageId}/package.json`]: JSON.stringify({ name: "no-version" }),
491
+ [`/packages/${packageId}/dist/package.bundle.js`]: packageBundle,
492
+ };
493
+ const deps = makeMockDeps(files);
494
+ const dc = mockDataContext();
495
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => `/packages/${packageId}`, {
496
+ loadingPromise: Promise.resolve(),
497
+ }));
498
+ mockFindOnePV.mockResolvedValue(undefined);
499
+ mockFindOneFile.mockResolvedValue(undefined);
500
+ mockGetPkg.mockResolvedValue({
501
+ packageId,
502
+ name: "no-version",
503
+ description: "",
504
+ signature: "",
505
+ createdBy: "u",
506
+ });
507
+ const result = await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
508
+ skipLoad: true,
509
+ skipResolve: true,
510
+ });
511
+ expect(result.packageVersion.version).toBe("0.0.1");
512
+ });
513
+ });
514
+ describe("installAllPackageBundles", () => {
515
+ it("installs bundles for all non-disabled packages", async () => {
516
+ const pkg1Id = (0, utils_1.newid)();
517
+ const pkg2Id = (0, utils_1.newid)();
518
+ mockListPkgs.mockResolvedValue([
519
+ { packageId: pkg1Id, name: "pkg1", disabled: false },
520
+ { packageId: pkg2Id, name: "pkg2", disabled: false },
521
+ ]);
522
+ const packageBundle = "exports = {};";
523
+ const files = {
524
+ [`/packages/${pkg1Id}/package.json`]: JSON.stringify({ name: "pkg1", version: "1.0.0" }),
525
+ [`/packages/${pkg1Id}/dist/package.bundle.js`]: packageBundle,
526
+ [`/packages/${pkg2Id}/package.json`]: JSON.stringify({ name: "pkg2", version: "1.0.0" }),
527
+ [`/packages/${pkg2Id}/dist/package.bundle.js`]: packageBundle,
528
+ };
529
+ const deps = makeMockDeps(files);
530
+ const dc = mockDataContext();
531
+ mockGroupDeviceVar.mockImplementation((name) => {
532
+ const id = name.replace("packageLocalPath_", "");
533
+ return Object.assign(() => `/packages/${id}`, {
534
+ loadingPromise: Promise.resolve(),
535
+ });
536
+ });
537
+ mockFindOnePV.mockResolvedValue(undefined);
538
+ mockFindOneFile.mockResolvedValue(undefined);
539
+ mockGetPkg.mockImplementation(async (id) => ({
540
+ packageId: id,
541
+ name: id === pkg1Id ? "pkg1" : "pkg2",
542
+ description: "",
543
+ signature: "",
544
+ createdBy: "u",
545
+ }));
546
+ await (0, package_installer_1.installAllPackageBundles)(dc, deps);
547
+ // signAndSave called for each package's PV
548
+ expect(mockSignAndSavePV).toHaveBeenCalledTimes(2);
549
+ });
550
+ it("skips disabled packages", async () => {
551
+ const enabledId = (0, utils_1.newid)();
552
+ const disabledId = (0, utils_1.newid)();
553
+ mockListPkgs.mockResolvedValue([
554
+ { packageId: enabledId, name: "enabled", disabled: false },
555
+ { packageId: disabledId, name: "disabled", disabled: true },
556
+ ]);
557
+ const files = {
558
+ [`/packages/${enabledId}/package.json`]: JSON.stringify({
559
+ name: "enabled",
560
+ version: "1.0.0",
561
+ }),
562
+ [`/packages/${enabledId}/dist/package.bundle.js`]: "code",
563
+ };
564
+ const deps = makeMockDeps(files);
565
+ const dc = mockDataContext();
566
+ mockGroupDeviceVar.mockImplementation((name) => {
567
+ const id = name.replace("packageLocalPath_", "");
568
+ return Object.assign(() => `/packages/${id}`, {
569
+ loadingPromise: Promise.resolve(),
570
+ });
571
+ });
572
+ mockFindOnePV.mockResolvedValue(undefined);
573
+ mockFindOneFile.mockResolvedValue(undefined);
574
+ mockGetPkg.mockImplementation(async (id) => ({
575
+ packageId: id,
576
+ name: "enabled",
577
+ description: "",
578
+ signature: "",
579
+ createdBy: "u",
580
+ }));
581
+ await (0, package_installer_1.installAllPackageBundles)(dc, deps);
582
+ expect(mockSignAndSavePV).toHaveBeenCalledTimes(1);
583
+ });
584
+ it("continues installing other packages when one fails", async () => {
585
+ const pkg1Id = (0, utils_1.newid)();
586
+ const pkg2Id = (0, utils_1.newid)();
587
+ mockListPkgs.mockResolvedValue([
588
+ { packageId: pkg1Id, name: "failing-pkg" },
589
+ { packageId: pkg2Id, name: "good-pkg" },
590
+ ]);
591
+ // pkg1 has no dist dir (will fail), pkg2 is fine
592
+ const files = {
593
+ [`/packages/${pkg1Id}/package.json`]: JSON.stringify({ name: "failing", version: "1.0.0" }),
594
+ [`/packages/${pkg2Id}/package.json`]: JSON.stringify({ name: "good", version: "1.0.0" }),
595
+ [`/packages/${pkg2Id}/dist/package.bundle.js`]: "code",
596
+ };
597
+ const deps = makeMockDeps(files);
598
+ const dc = mockDataContext();
599
+ mockGroupDeviceVar.mockImplementation((name) => {
600
+ const id = name.replace("packageLocalPath_", "");
601
+ return Object.assign(() => `/packages/${id}`, {
602
+ loadingPromise: Promise.resolve(),
603
+ });
604
+ });
605
+ mockFindOnePV.mockResolvedValue(undefined);
606
+ mockFindOneFile.mockResolvedValue(undefined);
607
+ mockGetPkg.mockImplementation(async (id) => ({
608
+ packageId: id,
609
+ name: id === pkg1Id ? "failing" : "good",
610
+ description: "",
611
+ signature: "",
612
+ createdBy: "u",
613
+ }));
614
+ const consoleSpy = jest.spyOn(console, "error").mockImplementation(() => { });
615
+ await (0, package_installer_1.installAllPackageBundles)(dc, deps);
616
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining("Failed to install bundles for failing-pkg"), expect.any(Error));
617
+ // pkg2 still got installed
618
+ expect(mockSignAndSavePV).toHaveBeenCalledTimes(1);
619
+ consoleSpy.mockRestore();
620
+ });
621
+ });
622
+ describe("getPackageLocalPath (via installPackageFromBundles)", () => {
623
+ it("awaits loadingPromise before reading value", async () => {
624
+ const packageId = (0, utils_1.newid)();
625
+ const resolvedPath = `/custom/${packageId}`;
626
+ let loadingResolved = false;
627
+ const files = {
628
+ [`${resolvedPath}/package.json`]: JSON.stringify({ name: "x", version: "1.0.0" }),
629
+ [`${resolvedPath}/dist/package.bundle.js`]: "code",
630
+ };
631
+ const deps = makeMockDeps(files);
632
+ const dc = mockDataContext();
633
+ // Simulate loadingPromise that resolves asynchronously
634
+ const loadingPromise = new Promise((resolve) => {
635
+ setTimeout(() => {
636
+ loadingResolved = true;
637
+ resolve();
638
+ }, 10);
639
+ });
640
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => resolvedPath, { loadingPromise }));
641
+ mockFindOnePV.mockResolvedValue(undefined);
642
+ mockFindOneFile.mockResolvedValue(undefined);
643
+ mockGetPkg.mockResolvedValue({
644
+ packageId,
645
+ name: "x",
646
+ description: "",
647
+ signature: "",
648
+ createdBy: "u",
649
+ });
650
+ await (0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, {
651
+ skipLoad: true,
652
+ skipResolve: true,
653
+ });
654
+ expect(loadingResolved).toBe(true);
655
+ });
656
+ it("falls back to packagesRootDir when pvar returns undefined", async () => {
657
+ const packageId = (0, utils_1.newid)();
658
+ const deps = makeMockDeps({});
659
+ const dc = mockDataContext();
660
+ mockGroupDeviceVar.mockReturnValue(Object.assign(() => undefined, { loadingPromise: Promise.resolve() }));
661
+ // Since resolvePath just joins, and packagesRootDir = "/packages",
662
+ // the resolved path will be "/packages" — which won't have bundles.
663
+ // This should throw "Package directory does not exist"
664
+ await expect((0, package_installer_1.installPackageFromBundles)(dc, deps, packageId, { skipLoad: true, skipResolve: true })).rejects.toThrow("Package directory does not exist");
665
+ });
666
+ });