@attraccess/plugins-backend-sdk 1.10.0 → 1.11.0-beta.1

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 (56) hide show
  1. package/package.json +13 -8
  2. package/src/index.d.ts +8 -0
  3. package/src/index.js +8 -0
  4. package/src/index.js.map +1 -1
  5. package/src/internal.d.ts +6 -0
  6. package/src/internal.js +11 -0
  7. package/src/internal.js.map +1 -0
  8. package/src/lib/auth.types.d.ts +3 -1
  9. package/src/lib/dual-auth.guard.js +4 -0
  10. package/src/lib/dual-auth.guard.js.map +1 -1
  11. package/src/lib/plugin-audit.d.ts +34 -33
  12. package/src/lib/plugin-audit.js +9 -9
  13. package/src/lib/plugin-audit.js.map +1 -1
  14. package/src/lib/plugin-backend-module.d.ts +71 -0
  15. package/src/lib/plugin-backend-module.js +3 -0
  16. package/src/lib/plugin-backend-module.js.map +1 -0
  17. package/src/lib/plugin-ble-fake-clock.d.ts +15 -0
  18. package/src/lib/plugin-ble-fake-clock.js +52 -0
  19. package/src/lib/plugin-ble-fake-clock.js.map +1 -0
  20. package/src/lib/plugin-ble-fake.d.ts +94 -0
  21. package/src/lib/plugin-ble-fake.js +406 -0
  22. package/src/lib/plugin-ble-fake.js.map +1 -0
  23. package/src/lib/plugin-ble-notification-stream.d.ts +28 -0
  24. package/src/lib/plugin-ble-notification-stream.js +119 -0
  25. package/src/lib/plugin-ble-notification-stream.js.map +1 -0
  26. package/src/lib/plugin-ble-session-engine.d.ts +119 -0
  27. package/src/lib/plugin-ble-session-engine.js +410 -0
  28. package/src/lib/plugin-ble-session-engine.js.map +1 -0
  29. package/src/lib/plugin-ble-validation.d.ts +71 -0
  30. package/src/lib/plugin-ble-validation.js +453 -0
  31. package/src/lib/plugin-ble-validation.js.map +1 -0
  32. package/src/lib/plugin-ble.d.ts +249 -0
  33. package/src/lib/plugin-ble.js +85 -0
  34. package/src/lib/plugin-ble.js.map +1 -0
  35. package/src/lib/plugin-context.d.ts +58 -54
  36. package/src/lib/plugin-context.js +6 -6
  37. package/src/lib/plugin-context.js.map +1 -1
  38. package/src/lib/plugin-flow-node.d.ts +52 -3
  39. package/src/lib/plugin-live-updates.d.ts +21 -0
  40. package/src/lib/plugin-live-updates.js +3 -0
  41. package/src/lib/plugin-live-updates.js.map +1 -0
  42. package/src/lib/plugin-notifications.d.ts +83 -0
  43. package/src/lib/plugin-notifications.js +3 -0
  44. package/src/lib/plugin-notifications.js.map +1 -0
  45. package/src/lib/plugin-resource-access.d.ts +89 -0
  46. package/src/lib/plugin-resource-access.js +3 -0
  47. package/src/lib/plugin-resource-access.js.map +1 -0
  48. package/src/lib/plugin.interface.d.ts +92 -5
  49. package/src/lib/plugin.interface.js +28 -1
  50. package/src/lib/plugin.interface.js.map +1 -1
  51. package/src/lib/reader-ui.d.ts +359 -0
  52. package/src/lib/reader-ui.js +115 -0
  53. package/src/lib/reader-ui.js.map +1 -0
  54. package/src/lib/shared-live-sampler.d.ts +11 -0
  55. package/src/lib/shared-live-sampler.js +33 -0
  56. package/src/lib/shared-live-sampler.js.map +1 -0
package/package.json CHANGED
@@ -1,6 +1,11 @@
1
1
  {
2
2
  "name": "@attraccess/plugins-backend-sdk",
3
- "version": "1.10.0",
3
+ "version": "1.11.0-beta.1",
4
+ "repository": {
5
+ "type": "git",
6
+ "url": "git+https://github.com/Attraccess/Attraccess.git",
7
+ "directory": "libs/plugins-backend-sdk"
8
+ },
4
9
  "type": "commonjs",
5
10
  "main": "./src/index.js",
6
11
  "types": "./src/index.d.ts",
@@ -21,15 +26,15 @@
21
26
  ],
22
27
  "dependencies": {
23
28
  "tslib": "^2.8.1",
24
- "@attraccess/database-entities": "*",
25
- "@nestjs/common": "^11.1.0",
26
- "@nestjs/event-emitter": "^3.1.0",
29
+ "@attraccess/database-entities": "1.11.0-beta.1",
30
+ "@nestjs/common": "^12.0.0",
31
+ "@nestjs/event-emitter": "^12.0.0",
27
32
  "rxjs": "^7.8.2",
28
- "@nestjs/core": "^11.1.0",
33
+ "@nestjs/core": "^12.0.0",
29
34
  "typeorm": "0.3.31",
30
- "@nestjs/swagger": "^11.2.0",
31
- "express": "4.22.2",
32
- "@nestjs/passport": "^11.0.5",
35
+ "@nestjs/swagger": "^12.0.0",
36
+ "express": "5.3.0",
37
+ "@nestjs/passport": "^12.0.0",
33
38
  "@attraccess/shared": "*"
34
39
  }
35
40
  }
package/src/index.d.ts CHANGED
@@ -1,11 +1,19 @@
1
1
  export * from './lib/plugin.interface';
2
2
  export * from './lib/plugin-flow-node';
3
3
  export * from './lib/plugin-context';
4
+ export * from './lib/plugin-live-updates';
5
+ export * from './lib/shared-live-sampler';
4
6
  export * from './lib/plugin-audit';
5
7
  export * from './lib/mqtt-credential-provisioning';
6
8
  export * from './lib/plugin-migrations';
7
9
  export * from './lib/entity';
8
10
  export * from './lib/semver';
11
+ export * from './lib/reader-ui';
12
+ export * from './lib/plugin-notifications';
13
+ export * from './lib/plugin-resource-access';
14
+ export * from './lib/plugin-ble';
15
+ export * from './lib/plugin-ble-validation';
16
+ export * from './lib/plugin-ble-fake';
9
17
  export * from './lib/auth-decorator';
10
18
  export * from '@attraccess/database-entities';
11
19
  export * as entities from '@attraccess/database-entities';
package/src/index.js CHANGED
@@ -5,11 +5,19 @@ const tslib_1 = require("tslib");
5
5
  tslib_1.__exportStar(require("./lib/plugin.interface"), exports);
6
6
  tslib_1.__exportStar(require("./lib/plugin-flow-node"), exports);
7
7
  tslib_1.__exportStar(require("./lib/plugin-context"), exports);
8
+ tslib_1.__exportStar(require("./lib/plugin-live-updates"), exports);
9
+ tslib_1.__exportStar(require("./lib/shared-live-sampler"), exports);
8
10
  tslib_1.__exportStar(require("./lib/plugin-audit"), exports);
9
11
  tslib_1.__exportStar(require("./lib/mqtt-credential-provisioning"), exports);
10
12
  tslib_1.__exportStar(require("./lib/plugin-migrations"), exports);
11
13
  tslib_1.__exportStar(require("./lib/entity"), exports);
12
14
  tslib_1.__exportStar(require("./lib/semver"), exports);
15
+ tslib_1.__exportStar(require("./lib/reader-ui"), exports);
16
+ tslib_1.__exportStar(require("./lib/plugin-notifications"), exports);
17
+ tslib_1.__exportStar(require("./lib/plugin-resource-access"), exports);
18
+ tslib_1.__exportStar(require("./lib/plugin-ble"), exports);
19
+ tslib_1.__exportStar(require("./lib/plugin-ble-validation"), exports);
20
+ tslib_1.__exportStar(require("./lib/plugin-ble-fake"), exports);
13
21
  tslib_1.__exportStar(require("./lib/auth-decorator"), exports);
14
22
  tslib_1.__exportStar(require("@attraccess/database-entities"), exports);
15
23
  exports.entities = tslib_1.__importStar(require("@attraccess/database-entities"));
package/src/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/plugins-backend-sdk/src/index.ts"],"names":[],"mappings":";;;;AAAA,iEAAuC;AACvC,iEAAuC;AACvC,+DAAqC;AACrC,6DAAmC;AACnC,6EAAmD;AACnD,kEAAwC;AACxC,uDAA6B;AAC7B,uDAA6B;AAE7B,+DAAqC;AACrC,wEAA8C;AAC9C,kFAA0D;AAC1D,2DAAiC;AACjC,gEAAsC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/plugins-backend-sdk/src/index.ts"],"names":[],"mappings":";;;;AAAA,iEAAuC;AACvC,iEAAuC;AACvC,+DAAqC;AACrC,oEAA0C;AAC1C,oEAA0C;AAC1C,6DAAmC;AACnC,6EAAmD;AACnD,kEAAwC;AACxC,uDAA6B;AAC7B,uDAA6B;AAC7B,0DAAgC;AAChC,qEAA2C;AAC3C,uEAA6C;AAC7C,2DAAiC;AACjC,sEAA4C;AAC5C,gEAAsC;AAEtC,+DAAqC;AACrC,wEAA8C;AAC9C,kFAA0D;AAC1D,2DAAiC;AACjC,gEAAsC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Host-internal building blocks shared by the API host and the SDK fake. This entry is reachable only through the
3
+ * workspace path alias `@attraccess/plugins-backend-sdk/internal`; it is not part of the published package
4
+ * exports, so plugins cannot import it. Plugins use `context.ble` instead.
5
+ */
6
+ export { BleSessionEngine, type BleSessionClock, type BleSessionEngineDeps, type BleSessionLink, } from './lib/plugin-ble-session-engine';
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BleSessionEngine = void 0;
4
+ /**
5
+ * Host-internal building blocks shared by the API host and the SDK fake. This entry is reachable only through the
6
+ * workspace path alias `@attraccess/plugins-backend-sdk/internal`; it is not part of the published package
7
+ * exports, so plugins cannot import it. Plugins use `context.ble` instead.
8
+ */
9
+ var plugin_ble_session_engine_1 = require("./lib/plugin-ble-session-engine");
10
+ Object.defineProperty(exports, "BleSessionEngine", { enumerable: true, get: function () { return plugin_ble_session_engine_1.BleSessionEngine; } });
11
+ //# sourceMappingURL=internal.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../../libs/plugins-backend-sdk/src/internal.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,6EAKyC;AAJvC,6HAAA,gBAAgB,OAAA"}
@@ -1,8 +1,10 @@
1
+ import type { AuthenticationMethod } from '@attraccess/database-entities';
1
2
  import { User } from '@attraccess/database-entities';
3
+ export type { AuthenticationMethod };
2
4
  import { Request as BaseRequest } from 'express';
3
5
  export interface AuthenticatedUser extends User {
4
6
  jwtTokenId: string;
5
- authenticationMethod?: 'session' | 'api-token';
7
+ authenticationMethod?: AuthenticationMethod;
6
8
  apiTokenId?: number;
7
9
  /**
8
10
  * Effective permissions for this user. Stored as a Set for O(1) has() lookups.
@@ -39,6 +39,10 @@ let DualAuthGuard = DualAuthGuard_1 = class DualAuthGuard extends (0, passport_1
39
39
  */
40
40
  handleRequest(err, user, info, context) {
41
41
  var _a, _b;
42
+ // A server-side failure (e.g. 503 while the session store is unreachable) is not a failed sign-in.
43
+ if (err instanceof common_1.HttpException && err.getStatus() >= 500) {
44
+ throw err;
45
+ }
42
46
  if (err || !user) {
43
47
  const request = context.switchToHttp().getRequest();
44
48
  const hasAuthHeader = (_a = request.headers.authorization) === null || _a === void 0 ? void 0 : _a.startsWith('Bearer ');
@@ -1 +1 @@
1
- {"version":3,"file":"dual-auth.guard.js","sourceRoot":"","sources":["../../../../../libs/plugins-backend-sdk/src/lib/dual-auth.guard.ts"],"names":[],"mappings":";;;;;AAAA,2CAA6F;AAC7F,+CAA6C;AAGtC,IAAM,aAAa,qBAAnB,MAAM,aAAc,SAAQ,IAAA,oBAAS,EAAC,SAAS,CAAC;IAAhD;;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IAmD3D,CAAC;IAjDC;;;;OAIG;IACG,WAAW,CAAC,OAAyB;;;;;YACzC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAM,WAAW,YAAC,OAAO,CAAC,CAAC;gBAChD,OAAO,MAAiB,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAE7D,6EAA6E;gBAC7E,IAAI,KAAK,YAAY,8BAAqB,EAAE,CAAC;oBAC3C,MAAM,IAAI,8BAAqB,CAAC,yBAAyB,CAAC,CAAC;gBAC7D,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KAAA;IAED;;OAEG;IACH,aAAa,CACX,GAAY,EACZ,IAAa,EACb,IAAa,EACb,OAAyB;;QAEzB,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,MAAA,OAAO,CAAC,OAAO,CAAC,aAAa,0CAAE,UAAU,CAAC,SAAS,CAAC,CAAC;YAC3E,MAAM,SAAS,GAAG,MAAA,OAAO,CAAC,OAAO,0CAAG,cAAc,CAAC,CAAC;YAEpD,IAAI,YAAY,GAAG,yBAAyB,CAAC;YAE7C,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,GAAG,wCAAwC,CAAC;YAC1D,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACrB,YAAY,GAAG,mCAAmC,CAAC;YACrD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;YAC5D,MAAM,IAAI,8BAAqB,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAa,CAAC;IACvB,CAAC;CACF,CAAA;AApDY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;GACA,aAAa,CAoDzB"}
1
+ {"version":3,"file":"dual-auth.guard.js","sourceRoot":"","sources":["../../../../../libs/plugins-backend-sdk/src/lib/dual-auth.guard.ts"],"names":[],"mappings":";;;;;AAAA,2CAA4G;AAC5G,+CAA6C;AAGtC,IAAM,aAAa,qBAAnB,MAAM,aAAc,SAAQ,IAAA,oBAAS,EAAC,SAAS,CAAC;IAAhD;;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IAmD3D,CAAC;IAjDC;;;;OAIG;IACG,WAAW,CAAC,OAAyB;;;;;YACzC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAM,WAAW,YAAC,OAAO,CAAC,CAAC;gBAChD,OAAO,MAAiB,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAE7D,6EAA6E;gBAC7E,IAAI,KAAK,YAAY,8BAAqB,EAAE,CAAC;oBAC3C,MAAM,IAAI,8BAAqB,CAAC,yBAAyB,CAAC,CAAC;gBAC7D,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KAAA;IAED;;OAEG;IACH,aAAa,CAAkB,GAAY,EAAE,IAAa,EAAE,IAAa,EAAE,OAAyB;;QAClG,mGAAmG;QACnG,IAAI,GAAG,YAAY,sBAAa,IAAI,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC;YAC3D,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,MAAA,OAAO,CAAC,OAAO,CAAC,aAAa,0CAAE,UAAU,CAAC,SAAS,CAAC,CAAC;YAC3E,MAAM,SAAS,GAAG,MAAA,OAAO,CAAC,OAAO,0CAAG,cAAc,CAAC,CAAC;YAEpD,IAAI,YAAY,GAAG,yBAAyB,CAAC;YAE7C,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,GAAG,wCAAwC,CAAC;YAC1D,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACrB,YAAY,GAAG,mCAAmC,CAAC;YACrD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;YAC5D,MAAM,IAAI,8BAAqB,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAa,CAAC;IACvB,CAAC;CACF,CAAA;AApDY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;GACA,aAAa,CAoDzB"}
@@ -1,36 +1,4 @@
1
- /** Implemented by the generic audit foundation, not by individual plugins. */
2
- export declare const PLUGIN_AUDIT_HOST_PROVIDER: unique symbol;
3
- export interface PluginAuditPrincipal {
4
- userId: number;
5
- authenticationMethod: 'session' | 'api-token';
6
- apiTokenId?: number;
7
- }
8
- export interface PluginAuditEvent {
9
- action: string;
10
- operationId: string;
11
- principal: PluginAuditPrincipal;
12
- outcome: 'attempted' | 'succeeded' | 'failed';
13
- subject: {
14
- type: string;
15
- id: number;
16
- };
17
- /** Callers must project domain data through an explicit allowlist. */
18
- details: Readonly<Record<string, string | number | boolean | null>>;
19
- }
20
- /** Only `recorded` means the host durably accepted the event. */
21
- export type PluginAuditReceipt = {
22
- status: 'recorded';
23
- } | {
24
- status: 'unavailable';
25
- };
26
- export interface PluginAuditContext {
27
- record(event: PluginAuditEvent): Promise<PluginAuditReceipt>;
28
- }
29
- export interface PluginAuditHostProvider {
30
- record(event: PluginAuditEvent & {
31
- pluginId: string;
32
- }): Promise<PluginAuditReceipt>;
33
- }
1
+ import type { AuthenticationMethod } from './auth.types';
34
2
  /**
35
3
  * Declarative audit policy a plugin contributes through `PluginBackendModule.auditDomains`.
36
4
  * The host registers the declaration, then enforces it on every event the plugin records:
@@ -86,6 +54,39 @@ export interface PluginAuditDomainDeclaration {
86
54
  readonly labels?: Readonly<Record<string, string>>;
87
55
  readonly actions: readonly PluginAuditActionPolicy[];
88
56
  }
57
+ /** Implemented by the generic audit foundation, not by individual plugins. */
58
+ export declare const PLUGIN_AUDIT_HOST_PROVIDER: unique symbol;
59
+ export interface PluginAuditPrincipal {
60
+ userId: number;
61
+ authenticationMethod: AuthenticationMethod;
62
+ apiTokenId?: number;
63
+ }
64
+ export interface PluginAuditEvent {
65
+ action: string;
66
+ operationId: string;
67
+ principal: PluginAuditPrincipal;
68
+ outcome: 'attempted' | 'succeeded' | 'failed';
69
+ subject: {
70
+ type: string;
71
+ id: number;
72
+ };
73
+ /** Callers must project domain data through an explicit allowlist. */
74
+ details: Readonly<Record<string, string | number | boolean | null>>;
75
+ }
76
+ /** Only `recorded` means the host durably accepted the event. */
77
+ export type PluginAuditReceipt = {
78
+ status: 'recorded';
79
+ } | {
80
+ status: 'unavailable';
81
+ };
82
+ export interface PluginAuditContext {
83
+ record(event: PluginAuditEvent): Promise<PluginAuditReceipt>;
84
+ }
85
+ export interface PluginAuditHostProvider {
86
+ record(event: PluginAuditEvent & {
87
+ pluginId: string;
88
+ }): Promise<PluginAuditReceipt>;
89
+ }
89
90
  /**
90
91
  * Validates one plugin-contributed audit domain declaration and returns it unchanged.
91
92
  * Throws a descriptive error on any violation; hosts quarantine the plugin in that case.
@@ -1,9 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.PLUGIN_AUDIT_LIMITS = exports.PLUGIN_AUDIT_FIELD_PATTERN = exports.PLUGIN_AUDIT_SEGMENT_PATTERN = exports.PLUGIN_AUDIT_DOMAIN_PATTERN = exports.PLUGIN_AUDIT_HOST_PROVIDER = void 0;
3
+ exports.PLUGIN_AUDIT_HOST_PROVIDER = exports.PLUGIN_AUDIT_LIMITS = exports.PLUGIN_AUDIT_FIELD_PATTERN = exports.PLUGIN_AUDIT_SEGMENT_PATTERN = exports.PLUGIN_AUDIT_DOMAIN_PATTERN = void 0;
4
4
  exports.validatePluginAuditDomainDeclaration = validatePluginAuditDomainDeclaration;
5
- /** Implemented by the generic audit foundation, not by individual plugins. */
6
- exports.PLUGIN_AUDIT_HOST_PROVIDER = Symbol.for('attraccess.plugin.auditHostProvider');
7
5
  /**
8
6
  * Declarative audit policy a plugin contributes through `PluginBackendModule.auditDomains`.
9
7
  * The host registers the declaration, then enforces it on every event the plugin records:
@@ -36,12 +34,6 @@ const isPlainRecord = (value) => {
36
34
  const prototype = Object.getPrototypeOf(value);
37
35
  return prototype === Object.prototype || prototype === null;
38
36
  };
39
- const dottedName = (prefix, value, maxLength) => {
40
- if (typeof value !== 'string' || value.length > maxLength || !value.startsWith(`${prefix}.`))
41
- return false;
42
- const segments = value.slice(prefix.length + 1).split('.');
43
- return segments.length > 0 && segments.every((segment) => exports.PLUGIN_AUDIT_SEGMENT_PATTERN.test(segment));
44
- };
45
37
  function validateFieldChoices(path, policy, declared) {
46
38
  if (policy.pattern !== undefined) {
47
39
  if (declared !== 'string')
@@ -93,6 +85,14 @@ function validateFieldPolicy(path, policy) {
93
85
  throw new Error(`${path}: maxLength requires an integer 1-${exports.PLUGIN_AUDIT_LIMITS.maxLengthCeiling} and type 'string'`);
94
86
  }
95
87
  }
88
+ /** Implemented by the generic audit foundation, not by individual plugins. */
89
+ exports.PLUGIN_AUDIT_HOST_PROVIDER = Symbol.for('attraccess.plugin.auditHostProvider');
90
+ const dottedName = (prefix, value, maxLength) => {
91
+ if (typeof value !== 'string' || value.length > maxLength || !value.startsWith(`${prefix}.`))
92
+ return false;
93
+ const segments = value.slice(prefix.length + 1).split('.');
94
+ return segments.length > 0 && segments.every((segment) => exports.PLUGIN_AUDIT_SEGMENT_PATTERN.test(segment));
95
+ };
96
96
  function validateDomainLabels(declaration, prefix) {
97
97
  if (declaration.labels !== undefined) {
98
98
  if (!isPlainRecord(declaration.labels))
@@ -1 +1 @@
1
- {"version":3,"file":"plugin-audit.js","sourceRoot":"","sources":["../../../../../libs/plugins-backend-sdk/src/lib/plugin-audit.ts"],"names":[],"mappings":";;;AAsLA,oFAyDC;AA/OD,8EAA8E;AACjE,QAAA,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AA6B5F;;;;;;;GAOG;AAEH,4FAA4F;AAC/E,QAAA,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,mEAAmE;AACtD,QAAA,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,4FAA4F;AAC/E,QAAA,0BAA0B,GAAG,6CAA6C,CAAC;AAE3E,QAAA,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,CAAC;IACnB,gBAAgB,EAAE,EAAE;IACpB,qBAAqB,EAAE,CAAC;IACxB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,GAAG;IAClB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,GAAG;IAChB,YAAY,EAAE,GAAG;CACT,CAAC;AAkCX,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE;IACzE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAc,EAAE,SAAiB,EAAW,EAAE;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3G,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3D,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,oCAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,SAAS,oBAAoB,CAAC,IAAY,EAAE,MAA+B,EAAE,QAAgB;IAC3F,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kCAAkC,CAAC,CAAC;QACtF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,2BAAmB,CAAC,aAAa;YACjG,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yCAAyC,2BAAmB,CAAC,aAAa,aAAa,CAAC,CAAC;QAClH,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,WAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6CAA6C,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;QAC7B,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YACvB,OAAO,CAAC,MAAM,KAAK,CAAC;YACpB,OAAO,CAAC,MAAM,GAAG,2BAAmB,CAAC,YAAY;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;YAElD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qBAAqB,2BAAmB,CAAC,YAAY,oBAAoB,QAAQ,GAAG,CAAC,CAAC;IACjH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,MAAe;IACxD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAC7B,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS;QAC1E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sDAAsD,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,IAAI;QACpB,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oCAAoC,GAAG,GAAG,CAAC,CAAC;IACvE,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,CAAU;QACzC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAW,CAAC;gBACzG,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,KAAK,6CAA6C,CAAC,CAAC;QACpF,CAAC;IACH,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS;YAC9D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gDAAgD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,IACE,QAAQ,KAAK,QAAQ;YACrB,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC;YACvC,MAAM,CAAC,SAAS,GAAG,CAAC;YACpB,MAAM,CAAC,SAAS,GAAG,2BAAmB,CAAC,gBAAgB;YAEvD,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,qCAAqC,2BAAmB,CAAC,gBAAgB,oBAAoB,CACrG,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAyC,EAAE,MAAc;IACrF,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,kCAAkC,CAAC,CAAC;QACnH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,MAAM,GAAG,2BAAmB,CAAC,YAAY;YACnD,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,2BAAmB,CAAC,YAAY,gBAAgB,CAAC,CAAC;QACzG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,MAAM,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,4BAA4B,MAAM,GAAG,CAAC,CAAC;YAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,2BAAmB,CAAC,WAAW;gBAC1G,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,iBAAiB,MAAM,eAAe,2BAAmB,CAAC,WAAW,aAAa,CAC1G,CAAC;QACN,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oCAAoC,CAAyC,WAAc;IACzG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACpG,MAAM,KAAK,GAAG,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IACxF,IAAI,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,mCAA2B,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACjG,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,wBAAwB,mCAA2B,CAAC,MAAM,EAAE,CAAC,CAAC;IACtG,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAClC,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,sCAAsC,CAAC,CAAC;IACjF,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,2BAAmB,CAAC,gBAAgB;QACnE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,2BAAmB,CAAC,gBAAgB,UAAU,CAAC,CAAC;IACvG,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,yCAAyC,CAAC,CAAC;QAC7G,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,2BAAmB,CAAC,YAAY,CAAC;YAC7F,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,wBAAwB,MAAM,mCAAmC,CAAC,CAAC;QAC5G,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,wBAAwB,MAAM,GAAG,CAAC,CAAC;QACvG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,SAAS;YACzB,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,MAAM,wBAAwB,GAAG,GAAG,CAAC,CAAC;QAC/F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,MAAM,2CAA2C,CAAC,CAAC;QAC1G,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,2BAAmB,CAAC,qBAAqB;YACvE,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,cAAc,MAAM,cAAc,2BAAmB,CAAC,qBAAqB,gBAAgB,CACnH,CAAC;QACJ,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,2BAAmB,CAAC,YAAY,CAAC;gBACpE,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,cAAc,MAAM,8BAA8B,MAAM,mCAAmC,CACnH,CAAC;YACJ,IAAI,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,MAAM,8BAA8B,WAAW,GAAG,CAAC,CAAC;YAC3G,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,cAAc,MAAM,mCAAmC,CAAC,CAAC;YAClG,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,MAAM,CAAC,MAAM,GAAG,2BAAmB,CAAC,eAAe;gBACrD,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,cAAc,MAAM,cAAc,2BAAmB,CAAC,eAAe,gBAAgB,CAC7G,CAAC;YACJ,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,kCAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;oBACzC,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,cAAc,MAAM,oBAAoB,KAAK,gBAAgB,kCAA0B,CAAC,MAAM,EAAE,CACxH,CAAC;gBACJ,mBAAmB,CAAC,iBAAiB,MAAM,cAAc,MAAM,aAAa,KAAK,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9G,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"plugin-audit.js","sourceRoot":"","sources":["../../../../../libs/plugins-backend-sdk/src/lib/plugin-audit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ import type { PluginContext } from './plugin-context';
2
+ import { DynamicModule } from '@nestjs/common';
3
+ import type { PluginEntityClass } from './entity';
4
+ import type { MqttCredentialProvisioningProviderFactory } from './mqtt-credential-provisioning';
5
+ import type { PluginAuditDomainDeclaration } from './plugin-audit';
6
+ import type { PluginFlowNodeDefinition } from './plugin-flow-node';
7
+ import type { PluginEmailTemplate, PluginNotificationCategory } from './plugin-notifications';
8
+ import type { PreStartHook, ReaderUiProvider, SessionEndHook, StartBlockedQuery, StartCapacityHook } from './reader-ui';
9
+ /**
10
+ * Shape every backend plugin's default export must satisfy. The host calls
11
+ * register(context) at load time to obtain the plugin's Nest module definition.
12
+ */
13
+ export interface PluginBackendModule {
14
+ register(context: PluginContext): DynamicModule;
15
+ /**
16
+ * Optional TypeORM entity classes this plugin owns. The host registers their
17
+ * metadata into the shared DataSource at load time so the plugin can query
18
+ * them through {@link PluginContext.getRepository}. The schema itself is owned
19
+ * by the plugin's migrations (the host runs with `synchronize: false`), so an
20
+ * entity here describes an existing table rather than creating one. Requires
21
+ * the DATABASE_ACCESS permission. See `docs/en/plugins/database-migrations.md`.
22
+ */
23
+ entities?: PluginEntityClass[];
24
+ /**
25
+ * Optional custom flow node types this plugin contributes. The host registers
26
+ * them into the flow engine so they appear in the frontend node catalog and
27
+ * can be executed like built-in node types. No extra permission is required.
28
+ *
29
+ * Type naming convention: "plugin.<pluginName>.<nodeName>".
30
+ */
31
+ flowNodes?: PluginFlowNodeDefinition[] | ((context: PluginContext) => PluginFlowNodeDefinition[]);
32
+ /**
33
+ * Optional audit domains this plugin contributes. The host registers the
34
+ * declarations at load time and enforces them on every event the plugin
35
+ * records through {@link PluginContext.audit}: only declared actions, subject
36
+ * types and detail fields are accepted, and events are stored under the
37
+ * declared domain. Domains must not collide with host domains or with other
38
+ * plugins. No extra permission is required.
39
+ */
40
+ auditDomains?: PluginAuditDomainDeclaration[] | ((context: PluginContext) => PluginAuditDomainDeclaration[]);
41
+ /** Optional broker credential provider offered to other integrations by this plugin. */
42
+ credentialProvisioningProvider?: MqttCredentialProvisioningProviderFactory;
43
+ /** Optional reader UI slot provider. Requires the READER_UI permission. */
44
+ readerUi?: ReaderUiProvider | ((context: PluginContext) => ReaderUiProvider);
45
+ /** Optional pre-start hook (allow / confirm / block). Requires ACCESS_HOOKS. */
46
+ preStartHook?: PreStartHook;
47
+ /**
48
+ * Optional query-side counterpart of `preStartHook`: reports a "start currently blocked" state the resource UI
49
+ * shows in place of the start button. Informational; the pre-start hook stays the gate. Requires ACCESS_HOOKS.
50
+ */
51
+ startBlockedQuery?: StartBlockedQuery;
52
+ /**
53
+ * Optional atomic capacity hook: tells the host how many slots of a shared machine the plugin holds back from the
54
+ * starter. The host evaluates it inside its serialized start transaction. Requires ACCESS_HOOKS and DATABASE_ACCESS.
55
+ */
56
+ startCapacityHook?: StartCapacityHook;
57
+ /** Optional advisory hook after a session ended. Requires ACCESS_HOOKS. */
58
+ sessionEndHook?: SessionEndHook;
59
+ /**
60
+ * Optional notification categories this plugin dispatches under. They appear in user notification
61
+ * preferences grouped under the plugin name as `plugin.<pluginName>.<id>`. Dispatching requires the
62
+ * SEND_NOTIFICATIONS permission; declaring categories without it quarantines the plugin.
63
+ */
64
+ notificationCategories?: PluginNotificationCategory[];
65
+ /**
66
+ * Optional email templates, stored and edited like core templates (key `plugin.<pluginName>.<id>`) and sent
67
+ * through `notifications.dispatch({ email: { template, variables } })`. Declaring them requires the
68
+ * SEND_NOTIFICATIONS permission; without it the plugin is quarantined.
69
+ */
70
+ emailTemplates?: PluginEmailTemplate[];
71
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=plugin-backend-module.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-backend-module.js","sourceRoot":"","sources":["../../../../../libs/plugins-backend-sdk/src/lib/plugin-backend-module.ts"],"names":[],"mappings":""}
@@ -0,0 +1,15 @@
1
+ /** Deterministic clock for the fake BLE transport: time only moves when a test calls `advance`. */
2
+ export declare class FakeBleClock {
3
+ private readonly epoch;
4
+ private current;
5
+ private sequence;
6
+ /** `epoch` is the wall-clock time (ms since 1970) at which the clock starts. */
7
+ constructor(epoch?: number);
8
+ private timers;
9
+ now(): number;
10
+ /** Schedules `fn`; returns a function that cancels it. */
11
+ setTimeout(fn: () => void, ms: number): () => void;
12
+ /** Moves time forward, firing due timers in order and letting their promise chains settle in between. */
13
+ advance(ms: number): Promise<void>;
14
+ }
15
+ export declare function flushMicrotasks(rounds?: number): Promise<void>;
@@ -0,0 +1,52 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.FakeBleClock = void 0;
4
+ exports.flushMicrotasks = flushMicrotasks;
5
+ const tslib_1 = require("tslib");
6
+ /** Deterministic clock for the fake BLE transport: time only moves when a test calls `advance`. */
7
+ class FakeBleClock {
8
+ /** `epoch` is the wall-clock time (ms since 1970) at which the clock starts. */
9
+ constructor(epoch = 0) {
10
+ this.epoch = epoch;
11
+ this.current = 0;
12
+ this.sequence = 0;
13
+ this.timers = [];
14
+ }
15
+ now() {
16
+ return this.epoch + this.current;
17
+ }
18
+ /** Schedules `fn`; returns a function that cancels it. */
19
+ setTimeout(fn, ms) {
20
+ const timer = { due: this.current + ms, seq: this.sequence++, fn };
21
+ this.timers.push(timer);
22
+ return () => {
23
+ this.timers = this.timers.filter((candidate) => candidate !== timer);
24
+ };
25
+ }
26
+ /** Moves time forward, firing due timers in order and letting their promise chains settle in between. */
27
+ advance(ms) {
28
+ return tslib_1.__awaiter(this, void 0, void 0, function* () {
29
+ const target = this.current + ms;
30
+ yield flushMicrotasks();
31
+ for (;;) {
32
+ const next = this.timers.filter((timer) => timer.due <= target).sort((a, b) => a.due - b.due || a.seq - b.seq)[0];
33
+ if (!next)
34
+ break;
35
+ this.timers = this.timers.filter((timer) => timer !== next);
36
+ this.current = Math.max(this.current, next.due);
37
+ next.fn();
38
+ yield flushMicrotasks();
39
+ }
40
+ this.current = target;
41
+ yield flushMicrotasks();
42
+ });
43
+ }
44
+ }
45
+ exports.FakeBleClock = FakeBleClock;
46
+ function flushMicrotasks() {
47
+ return tslib_1.__awaiter(this, arguments, void 0, function* (rounds = 100) {
48
+ for (let index = 0; index < rounds; index++)
49
+ yield Promise.resolve();
50
+ });
51
+ }
52
+ //# sourceMappingURL=plugin-ble-fake-clock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-ble-fake-clock.js","sourceRoot":"","sources":["../../../../../libs/plugins-backend-sdk/src/lib/plugin-ble-fake-clock.ts"],"names":[],"mappings":";;;AAuCA,0CAEC;;AAzCD,mGAAmG;AACnG,MAAa,YAAY;IAIvB,gFAAgF;IAChF,YAA6B,QAAQ,CAAC;QAAT,UAAK,GAAL,KAAK,CAAI;QAJ9B,YAAO,GAAG,CAAC,CAAC;QACZ,aAAQ,GAAG,CAAC,CAAC;QAIb,WAAM,GAAwD,EAAE,CAAC;IADhC,CAAC;IAG1C,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;IACnC,CAAC;IAED,0DAA0D;IAC1D,UAAU,CAAC,EAAc,EAAE,EAAU;QACnC,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;QACvE,CAAC,CAAC;IACJ,CAAC;IAED,yGAAyG;IACnG,OAAO,CAAC,EAAU;;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YACjC,MAAM,eAAe,EAAE,CAAC;YACxB,SAAS,CAAC;gBACR,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClH,IAAI,CAAC,IAAI;oBAAE,MAAM;gBACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;gBAC5D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChD,IAAI,CAAC,EAAE,EAAE,CAAC;gBACV,MAAM,eAAe,EAAE,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;YACtB,MAAM,eAAe,EAAE,CAAC;QAC1B,CAAC;KAAA;CACF;AApCD,oCAoCC;AAED,SAAsB,eAAe;iEAAC,MAAM,GAAG,GAAG;QAChD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE;YAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACvE,CAAC;CAAA"}
@@ -0,0 +1,94 @@
1
+ import { PluginBleAddressType, PluginBleContext, PluginBleErrorCode } from './plugin-ble';
2
+ /**
3
+ * Deterministic fake of the host BLE transport for plugin unit and integration tests. It has no Nest, database
4
+ * or network dependency, enforces the same validation and error codes as the host, and moves time only when a
5
+ * test calls `advance`.
6
+ */
7
+ export type FakeBleOperation = 'scan' | 'connect' | 'disconnect' | 'read' | 'write' | 'subscribe' | 'unsubscribe';
8
+ export interface FakeBleCharacteristic {
9
+ /** Current value returned by reads (and updated by writes without an `onWrite`). */
10
+ value?: Uint8Array;
11
+ onRead?: () => Uint8Array | Promise<Uint8Array>;
12
+ onWrite?: (value: Uint8Array, options: {
13
+ withoutResponse: boolean;
14
+ }) => void | Promise<void>;
15
+ /** Answers only after this many ms of fake time. Use it to provoke timeouts. */
16
+ delayMs?: number;
17
+ }
18
+ export interface FakeBlePeripheral {
19
+ readerId?: number;
20
+ readerIds?: number[];
21
+ address: string;
22
+ addressType: PluginBleAddressType;
23
+ advertisement: {
24
+ name?: string;
25
+ rssi?: number;
26
+ serviceUuids?: string[];
27
+ manufacturerData?: Array<{
28
+ companyId: number;
29
+ data: Uint8Array;
30
+ }>;
31
+ };
32
+ /** Keyed by characteristic UUID (any accepted form). */
33
+ characteristics?: Record<string, FakeBleCharacteristic>;
34
+ }
35
+ export interface FakeBleReaderInput {
36
+ readerId: number;
37
+ name: string;
38
+ /** Default false, like production. */
39
+ allowPluginBle?: boolean;
40
+ /** Default true. */
41
+ available?: boolean;
42
+ }
43
+ /** One validated primitive that reached the (fake) transport. */
44
+ export interface FakeBleTranscriptEntry {
45
+ op: FakeBleOperation;
46
+ readerId: number;
47
+ address?: string;
48
+ addressType?: PluginBleAddressType;
49
+ serviceUuid?: string;
50
+ characteristicUuid?: string;
51
+ bytes?: Uint8Array;
52
+ withoutResponse?: boolean;
53
+ durationMs?: number;
54
+ indicate?: boolean;
55
+ }
56
+ export interface FakeBleOpenSession {
57
+ id: string;
58
+ pluginId: string;
59
+ endpointId: string;
60
+ readerId: number;
61
+ address: string;
62
+ }
63
+ export interface FakeBleHostOptions {
64
+ /** Default true. Use false to simulate calls before the host finished bootstrapping (`NOT_READY`). */
65
+ ready?: boolean;
66
+ /** Wall-clock start of the fake clock (ms since 1970). Default 2026-01-01T00:00:00Z. */
67
+ startTime?: number;
68
+ }
69
+ export interface FakeBleHost {
70
+ contextFor(pluginId: string): PluginBleContext;
71
+ addReader(reader: FakeBleReaderInput): void;
72
+ removeReader(readerId: number): Promise<void>;
73
+ setReaderAccess(readerId: number, allowed: boolean): Promise<void>;
74
+ setReaderAvailable(readerId: number, available: boolean): void;
75
+ /** `false` simulates a host without a transport driver (`TRANSPORT_UNAVAILABLE`). */
76
+ setTransportAvailable(available: boolean): void;
77
+ setReady(ready: boolean): void;
78
+ addPeripheral(peripheral: FakeBlePeripheral): void;
79
+ notify(address: string, uuid: string, bytes: Uint8Array): void;
80
+ /** The peripheral drops the link: sessions to it close with `disconnected`. */
81
+ disconnect(address: string): Promise<void>;
82
+ /** Makes the next occurrence of `op` fail with `code`. */
83
+ failNext(op: FakeBleOperation, code: PluginBleErrorCode, options?: {
84
+ detail?: string;
85
+ }): void;
86
+ advance(ms: number): Promise<void>;
87
+ /** Simulates the plugin module being destroyed: closes its sessions with `shutdown`. */
88
+ shutdownPlugin(pluginId: string): Promise<void>;
89
+ /** Simulates plugin uninstall: closes its sessions and deletes its endpoints. */
90
+ uninstallPlugin(pluginId: string): Promise<void>;
91
+ readonly transcript: FakeBleTranscriptEntry[];
92
+ openSessions(): FakeBleOpenSession[];
93
+ }
94
+ export declare function createFakeBleHost(options?: FakeBleHostOptions): FakeBleHost;