@microverse.ts/runtime-bridge 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.
- package/LICENSE +21 -0
- package/dist/application/composition/buildDeclarativeBridgeTable.d.ts +6 -0
- package/dist/application/composition/buildDeclarativeBridgeTable.d.ts.map +1 -0
- package/dist/application/ports/BridgeRegistryPort.d.ts +3 -0
- package/dist/application/ports/BridgeRegistryPort.d.ts.map +1 -0
- package/dist/application/useCases/registerBridgeHandler.d.ts +10 -0
- package/dist/application/useCases/registerBridgeHandler.d.ts.map +1 -0
- package/dist/domain/bridge/BridgeCapabilityAssertion.d.ts +5 -0
- package/dist/domain/bridge/BridgeCapabilityAssertion.d.ts.map +1 -0
- package/dist/domain/bridge/BridgeChannelId.d.ts +5 -0
- package/dist/domain/bridge/BridgeChannelId.d.ts.map +1 -0
- package/dist/domain/bridge/BridgeMessage.d.ts +25 -0
- package/dist/domain/bridge/BridgeMessage.d.ts.map +1 -0
- package/dist/domain/bridge/BridgeRegistry.d.ts +7 -0
- package/dist/domain/bridge/BridgeRegistry.d.ts.map +1 -0
- package/dist/domain/bridge/DeclarativeBridge.d.ts +17 -0
- package/dist/domain/bridge/DeclarativeBridge.d.ts.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +73 -0
- package/dist/index.js.map +1 -0
- package/dist/infrastructure/facade/BridgeCoordinator.d.ts +14 -0
- package/dist/infrastructure/facade/BridgeCoordinator.d.ts.map +1 -0
- package/dist/infrastructure/gates/RegistryBackedAssertion.d.ts +6 -0
- package/dist/infrastructure/gates/RegistryBackedAssertion.d.ts.map +1 -0
- package/dist/infrastructure/registry/InMemoryBridgeRegistry.d.ts +9 -0
- package/dist/infrastructure/registry/InMemoryBridgeRegistry.d.ts.map +1 -0
- package/package.json +44 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 QADRAX
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { BridgeApiObject, DeclarativeBridgeDeclaration } from '../../domain/bridge/DeclarativeBridge';
|
|
2
|
+
/**
|
|
3
|
+
* Builds a frozen bridge table: bridge name → API object, ready to pass into a Lua host.
|
|
4
|
+
*/
|
|
5
|
+
export declare function buildDeclarativeBridgeTable<THostContext, TSlotKey extends string>(host: THostContext, slotKey: TSlotKey, declarations: readonly DeclarativeBridgeDeclaration<THostContext, TSlotKey>[]): Readonly<Record<string, BridgeApiObject>>;
|
|
6
|
+
//# sourceMappingURL=buildDeclarativeBridgeTable.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"buildDeclarativeBridgeTable.d.ts","sourceRoot":"","sources":["../../../src/application/composition/buildDeclarativeBridgeTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC7B,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,QAAQ,SAAS,MAAM,EAC/E,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,QAAQ,EACjB,YAAY,EAAE,SAAS,4BAA4B,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,GAC5E,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAS3C"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BridgeRegistryPort.d.ts","sourceRoot":"","sources":["../../../src/application/ports/BridgeRegistryPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { AsyncUseCase, Result } from '@microverse.ts/shared';
|
|
2
|
+
import { BridgeRegistryPort } from '../ports/BridgeRegistryPort';
|
|
3
|
+
import { BridgeCapabilityAssertion } from '../../domain/bridge/BridgeCapabilityAssertion';
|
|
4
|
+
import { BridgeHandler, BridgeRegistration } from '../../domain/bridge/BridgeMessage';
|
|
5
|
+
export type RegisterBridgeHandlerPorts = readonly [BridgeRegistryPort, BridgeCapabilityAssertion];
|
|
6
|
+
/**
|
|
7
|
+
* Port tuple order: `[BridgeRegistryPort, BridgeCapabilityAssertion]`.
|
|
8
|
+
*/
|
|
9
|
+
export declare const registerBridgeHandler: AsyncUseCase<RegisterBridgeHandlerPorts, readonly [BridgeRegistration, BridgeHandler], Result<void, 'duplicate' | 'capability_denied'>>;
|
|
10
|
+
//# sourceMappingURL=registerBridgeHandler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registerBridgeHandler.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/registerBridgeHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE3F,MAAM,MAAM,0BAA0B,GAAG,SAAS,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAC9C,0BAA0B,EAC1B,SAAS,CAAC,kBAAkB,EAAE,aAAa,CAAC,EAC5C,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC,CAgBhD,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BridgeCapabilityAssertion.d.ts","sourceRoot":"","sources":["../../../src/domain/bridge/BridgeCapabilityAssertion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BridgeChannelId.d.ts","sourceRoot":"","sources":["../../../src/domain/bridge/BridgeChannelId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE/E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEpE"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { CapabilityId } from '@microverse.ts/runtime-capabilities';
|
|
2
|
+
import { BridgeChannelId } from './BridgeChannelId';
|
|
3
|
+
export type BridgeRegistration = {
|
|
4
|
+
readonly channel: BridgeChannelId;
|
|
5
|
+
readonly requiredCapability?: CapabilityId | undefined;
|
|
6
|
+
};
|
|
7
|
+
export type BridgeHandler = (payload: unknown) => Promise<unknown>;
|
|
8
|
+
export type BridgeInvokeMessage = {
|
|
9
|
+
readonly _tag: 'invoke';
|
|
10
|
+
readonly channel: BridgeChannelId;
|
|
11
|
+
readonly requestId: string;
|
|
12
|
+
readonly payload: unknown;
|
|
13
|
+
};
|
|
14
|
+
export type BridgeResultMessage = {
|
|
15
|
+
readonly _tag: 'result';
|
|
16
|
+
readonly requestId: string;
|
|
17
|
+
readonly payload: unknown;
|
|
18
|
+
};
|
|
19
|
+
export type BridgeErrorMessage = {
|
|
20
|
+
readonly _tag: 'error';
|
|
21
|
+
readonly requestId: string;
|
|
22
|
+
readonly message: string;
|
|
23
|
+
};
|
|
24
|
+
export type BridgeMessage = BridgeInvokeMessage | BridgeResultMessage | BridgeErrorMessage;
|
|
25
|
+
//# sourceMappingURL=BridgeMessage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BridgeMessage.d.ts","sourceRoot":"","sources":["../../../src/domain/bridge/BridgeMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { BridgeChannelId } from './BridgeChannelId';
|
|
2
|
+
import { BridgeHandler } from './BridgeMessage';
|
|
3
|
+
export type BridgeRegistry = {
|
|
4
|
+
readonly register: (channel: BridgeChannelId, handler: BridgeHandler) => void;
|
|
5
|
+
readonly invoke: (channel: BridgeChannelId, payload: unknown) => Promise<unknown>;
|
|
6
|
+
};
|
|
7
|
+
//# sourceMappingURL=BridgeRegistry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BridgeRegistry.d.ts","sourceRoot":"","sources":["../../../src/domain/bridge/BridgeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnF,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Object exposed to Lua under one bridge name (e.g. `Transform`, `Scene`).
|
|
3
|
+
* Keys are method names; values are typically functions.
|
|
4
|
+
*/
|
|
5
|
+
export type BridgeApiObject = Record<string, unknown>;
|
|
6
|
+
/**
|
|
7
|
+
* Builds one bridge API for a host-defined context and slot key.
|
|
8
|
+
* When `perEntity` is false on the declaration, implementations may ignore `slotKey`.
|
|
9
|
+
*/
|
|
10
|
+
export type DeclarativeBridgeFactory<THostContext, TSlotKey extends string = string> = (host: THostContext, slotKey: TSlotKey) => BridgeApiObject;
|
|
11
|
+
export type DeclarativeBridgeDeclaration<THostContext, TSlotKey extends string = string> = {
|
|
12
|
+
readonly name: string;
|
|
13
|
+
/** When true, factories should scope APIs using `slotKey` (e.g. entity id). */
|
|
14
|
+
readonly perEntity: boolean;
|
|
15
|
+
readonly createApi: DeclarativeBridgeFactory<THostContext, TSlotKey>;
|
|
16
|
+
};
|
|
17
|
+
//# sourceMappingURL=DeclarativeBridge.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DeclarativeBridge.d.ts","sourceRoot":"","sources":["../../../src/domain/bridge/DeclarativeBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,YAAY,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,CACrF,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,QAAQ,KACd,eAAe,CAAC;AAErB,MAAM,MAAM,4BAA4B,CAAC,YAAY,EAAE,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CACtE,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export type { BridgeCapabilityAssertion } from './domain/bridge/BridgeCapabilityAssertion';
|
|
2
|
+
export { createBridgeChannelId, type BridgeChannelId } from './domain/bridge/BridgeChannelId';
|
|
3
|
+
export type { BridgeErrorMessage, BridgeHandler, BridgeInvokeMessage, BridgeMessage, BridgeRegistration, BridgeResultMessage, } from './domain/bridge/BridgeMessage';
|
|
4
|
+
export type { BridgeRegistry } from './domain/bridge/BridgeRegistry';
|
|
5
|
+
export type { BridgeApiObject, DeclarativeBridgeDeclaration, DeclarativeBridgeFactory, } from './domain/bridge/DeclarativeBridge';
|
|
6
|
+
export { buildDeclarativeBridgeTable } from './application/composition/buildDeclarativeBridgeTable';
|
|
7
|
+
export { createRegistryBackedAssertion } from './infrastructure/gates/RegistryBackedAssertion';
|
|
8
|
+
export { BridgeCoordinator, type BridgeCoordinatorDeps } from './infrastructure/facade/BridgeCoordinator';
|
|
9
|
+
export { InMemoryBridgeRegistry } from './infrastructure/registry/InMemoryBridgeRegistry';
|
|
10
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAC9F,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EACV,eAAe,EACf,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AACpG,OAAO,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { err, ok } from "@microverse.ts/shared";
|
|
2
|
+
//#region src/domain/bridge/BridgeChannelId.ts
|
|
3
|
+
function createBridgeChannelId(value) {
|
|
4
|
+
return value;
|
|
5
|
+
}
|
|
6
|
+
//#endregion
|
|
7
|
+
//#region src/application/composition/buildDeclarativeBridgeTable.ts
|
|
8
|
+
/**
|
|
9
|
+
* Builds a frozen bridge table: bridge name → API object, ready to pass into a Lua host.
|
|
10
|
+
*/
|
|
11
|
+
function buildDeclarativeBridgeTable(host, slotKey, declarations) {
|
|
12
|
+
const out = {};
|
|
13
|
+
for (const d of declarations) {
|
|
14
|
+
if (Object.prototype.hasOwnProperty.call(out, d.name)) throw new Error(`duplicate bridge name: ${d.name}`);
|
|
15
|
+
out[d.name] = Object.freeze(d.createApi(host, slotKey));
|
|
16
|
+
}
|
|
17
|
+
return Object.freeze(out);
|
|
18
|
+
}
|
|
19
|
+
//#endregion
|
|
20
|
+
//#region src/infrastructure/gates/RegistryBackedAssertion.ts
|
|
21
|
+
function createRegistryBackedAssertion(input) {
|
|
22
|
+
return { assertAllowed: async (id) => {
|
|
23
|
+
if (!input.isAllowed(id)) throw new Error("denied");
|
|
24
|
+
} };
|
|
25
|
+
}
|
|
26
|
+
//#endregion
|
|
27
|
+
//#region src/application/useCases/registerBridgeHandler.ts
|
|
28
|
+
/**
|
|
29
|
+
* Port tuple order: `[BridgeRegistryPort, BridgeCapabilityAssertion]`.
|
|
30
|
+
*/
|
|
31
|
+
var registerBridgeHandler = async (ports, registration, handler) => {
|
|
32
|
+
const [registry, gate] = ports;
|
|
33
|
+
if (registration.requiredCapability) try {
|
|
34
|
+
await gate.assertAllowed(registration.requiredCapability);
|
|
35
|
+
} catch {
|
|
36
|
+
return err("capability_denied");
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
registry.register(registration.channel, handler);
|
|
40
|
+
} catch {
|
|
41
|
+
return err("duplicate");
|
|
42
|
+
}
|
|
43
|
+
return ok(void 0);
|
|
44
|
+
};
|
|
45
|
+
//#endregion
|
|
46
|
+
//#region src/infrastructure/facade/BridgeCoordinator.ts
|
|
47
|
+
var BridgeCoordinator = class {
|
|
48
|
+
deps;
|
|
49
|
+
constructor(deps) {
|
|
50
|
+
this.deps = deps;
|
|
51
|
+
}
|
|
52
|
+
register = async (registration, handler) => {
|
|
53
|
+
return registerBridgeHandler([this.deps.registry, this.deps.capabilityAssertion], registration, handler);
|
|
54
|
+
};
|
|
55
|
+
};
|
|
56
|
+
//#endregion
|
|
57
|
+
//#region src/infrastructure/registry/InMemoryBridgeRegistry.ts
|
|
58
|
+
var InMemoryBridgeRegistry = class {
|
|
59
|
+
handlers = /* @__PURE__ */ new Map();
|
|
60
|
+
register = (channel, handler) => {
|
|
61
|
+
if (this.handlers.has(channel)) throw new Error("duplicate");
|
|
62
|
+
this.handlers.set(channel, handler);
|
|
63
|
+
};
|
|
64
|
+
invoke = async (channel, payload) => {
|
|
65
|
+
const handler = this.handlers.get(channel);
|
|
66
|
+
if (!handler) throw new Error("unknown_channel");
|
|
67
|
+
return handler(payload);
|
|
68
|
+
};
|
|
69
|
+
};
|
|
70
|
+
//#endregion
|
|
71
|
+
export { BridgeCoordinator, InMemoryBridgeRegistry, buildDeclarativeBridgeTable, createBridgeChannelId, createRegistryBackedAssertion };
|
|
72
|
+
|
|
73
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/domain/bridge/BridgeChannelId.ts","../src/application/composition/buildDeclarativeBridgeTable.ts","../src/infrastructure/gates/RegistryBackedAssertion.ts","../src/application/useCases/registerBridgeHandler.ts","../src/infrastructure/facade/BridgeCoordinator.ts","../src/infrastructure/registry/InMemoryBridgeRegistry.ts"],"sourcesContent":["export type BridgeChannelId = string & { readonly __brand: 'BridgeChannelId' };\n\nexport function createBridgeChannelId(value: string): BridgeChannelId {\n return value as BridgeChannelId;\n}\n","import type {\n BridgeApiObject,\n DeclarativeBridgeDeclaration,\n} from '../../domain/bridge/DeclarativeBridge';\n\n/**\n * Builds a frozen bridge table: bridge name → API object, ready to pass into a Lua host.\n */\nexport function buildDeclarativeBridgeTable<THostContext, TSlotKey extends string>(\n host: THostContext,\n slotKey: TSlotKey,\n declarations: readonly DeclarativeBridgeDeclaration<THostContext, TSlotKey>[],\n): Readonly<Record<string, BridgeApiObject>> {\n const out: Record<string, BridgeApiObject> = {};\n for (const d of declarations) {\n if (Object.prototype.hasOwnProperty.call(out, d.name)) {\n throw new Error(`duplicate bridge name: ${d.name}`);\n }\n out[d.name] = Object.freeze(d.createApi(host, slotKey));\n }\n return Object.freeze(out);\n}\n","import type { CapabilityId } from '@microverse.ts/runtime-capabilities';\n\nimport type { BridgeCapabilityAssertion } from '../../domain/bridge/BridgeCapabilityAssertion';\n\nexport function createRegistryBackedAssertion(input: {\n readonly isAllowed: (id: CapabilityId) => boolean;\n}): BridgeCapabilityAssertion {\n return {\n assertAllowed: async (id) => {\n if (!input.isAllowed(id)) {\n throw new Error('denied');\n }\n },\n };\n}\n","import type { AsyncUseCase } from '@microverse.ts/shared';\nimport { err, ok, type Result } from '@microverse.ts/shared';\n\nimport type { BridgeRegistryPort } from '../ports/BridgeRegistryPort';\nimport type { BridgeCapabilityAssertion } from '../../domain/bridge/BridgeCapabilityAssertion';\nimport type { BridgeHandler, BridgeRegistration } from '../../domain/bridge/BridgeMessage';\n\nexport type RegisterBridgeHandlerPorts = readonly [BridgeRegistryPort, BridgeCapabilityAssertion];\n\n/**\n * Port tuple order: `[BridgeRegistryPort, BridgeCapabilityAssertion]`.\n */\nexport const registerBridgeHandler: AsyncUseCase<\n RegisterBridgeHandlerPorts,\n readonly [BridgeRegistration, BridgeHandler],\n Result<void, 'duplicate' | 'capability_denied'>\n> = async (ports, registration, handler) => {\n const [registry, gate] = ports;\n if (registration.requiredCapability) {\n try {\n await gate.assertAllowed(registration.requiredCapability);\n } catch {\n return err('capability_denied');\n }\n }\n try {\n registry.register(registration.channel, handler);\n } catch {\n return err('duplicate');\n }\n return ok(undefined);\n};\n","import type { Result } from '@microverse.ts/shared';\n\nimport { registerBridgeHandler } from '../../application/useCases/registerBridgeHandler';\nimport type { BridgeCapabilityAssertion } from '../../domain/bridge/BridgeCapabilityAssertion';\nimport type { BridgeRegistry } from '../../domain/bridge/BridgeRegistry';\nimport type { BridgeHandler, BridgeRegistration } from '../../domain/bridge/BridgeMessage';\n\nexport type BridgeCoordinatorDeps = {\n readonly registry: BridgeRegistry;\n readonly capabilityAssertion: BridgeCapabilityAssertion;\n};\n\nexport class BridgeCoordinator {\n constructor(private readonly deps: BridgeCoordinatorDeps) {}\n\n readonly register = async (\n registration: BridgeRegistration,\n handler: BridgeHandler,\n ): Promise<Result<void, 'duplicate' | 'capability_denied'>> => {\n return registerBridgeHandler([this.deps.registry, this.deps.capabilityAssertion], registration, handler);\n };\n}\n","import type { BridgeRegistry } from '../../domain/bridge/BridgeRegistry';\nimport type { BridgeChannelId } from '../../domain/bridge/BridgeChannelId';\nimport type { BridgeHandler } from '../../domain/bridge/BridgeMessage';\n\nexport class InMemoryBridgeRegistry implements BridgeRegistry {\n private readonly handlers = new Map<BridgeChannelId, BridgeHandler>();\n\n readonly register = (channel: BridgeChannelId, handler: BridgeHandler): void => {\n if (this.handlers.has(channel)) {\n throw new Error('duplicate');\n }\n this.handlers.set(channel, handler);\n };\n\n readonly invoke = async (channel: BridgeChannelId, payload: unknown): Promise<unknown> => {\n const handler = this.handlers.get(channel);\n if (!handler) {\n throw new Error('unknown_channel');\n }\n return handler(payload);\n };\n}\n"],"mappings":";;AAEA,SAAgB,sBAAsB,OAAgC;CACpE,OAAO;AACT;;;;;;ACIA,SAAgB,4BACd,MACA,SACA,cAC2C;CAC3C,MAAM,MAAuC,CAAC;CAC9C,KAAK,MAAM,KAAK,cAAc;EAC5B,IAAI,OAAO,UAAU,eAAe,KAAK,KAAK,EAAE,IAAI,GAClD,MAAM,IAAI,MAAM,0BAA0B,EAAE,MAAM;EAEpD,IAAI,EAAE,QAAQ,OAAO,OAAO,EAAE,UAAU,MAAM,OAAO,CAAC;CACxD;CACA,OAAO,OAAO,OAAO,GAAG;AAC1B;;;ACjBA,SAAgB,8BAA8B,OAEhB;CAC5B,OAAO,EACL,eAAe,OAAO,OAAO;EAC3B,IAAI,CAAC,MAAM,UAAU,EAAE,GACrB,MAAM,IAAI,MAAM,QAAQ;CAE5B,EACF;AACF;;;;;;ACFA,IAAa,wBAIT,OAAO,OAAO,cAAc,YAAY;CAC1C,MAAM,CAAC,UAAU,QAAQ;CACzB,IAAI,aAAa,oBACf,IAAI;EACF,MAAM,KAAK,cAAc,aAAa,kBAAkB;CAC1D,QAAQ;EACN,OAAO,IAAI,mBAAmB;CAChC;CAEF,IAAI;EACF,SAAS,SAAS,aAAa,SAAS,OAAO;CACjD,QAAQ;EACN,OAAO,IAAI,WAAW;CACxB;CACA,OAAO,GAAG,KAAA,CAAS;AACrB;;;ACnBA,IAAa,oBAAb,MAA+B;CACA;CAA7B,YAAY,MAA8C;EAA7B,KAAA,OAAA;CAA8B;CAE3D,WAAoB,OAClB,cACA,YAC6D;EAC7D,OAAO,sBAAsB,CAAC,KAAK,KAAK,UAAU,KAAK,KAAK,mBAAmB,GAAG,cAAc,OAAO;CACzG;AACF;;;ACjBA,IAAa,yBAAb,MAA8D;CAC5D,2BAA4B,IAAI,IAAoC;CAEpE,YAAqB,SAA0B,YAAiC;EAC9E,IAAI,KAAK,SAAS,IAAI,OAAO,GAC3B,MAAM,IAAI,MAAM,WAAW;EAE7B,KAAK,SAAS,IAAI,SAAS,OAAO;CACpC;CAEA,SAAkB,OAAO,SAA0B,YAAuC;EACxF,MAAM,UAAU,KAAK,SAAS,IAAI,OAAO;EACzC,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,iBAAiB;EAEnC,OAAO,QAAQ,OAAO;CACxB;AACF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Result } from '@microverse.ts/shared';
|
|
2
|
+
import { BridgeCapabilityAssertion } from '../../domain/bridge/BridgeCapabilityAssertion';
|
|
3
|
+
import { BridgeRegistry } from '../../domain/bridge/BridgeRegistry';
|
|
4
|
+
import { BridgeHandler, BridgeRegistration } from '../../domain/bridge/BridgeMessage';
|
|
5
|
+
export type BridgeCoordinatorDeps = {
|
|
6
|
+
readonly registry: BridgeRegistry;
|
|
7
|
+
readonly capabilityAssertion: BridgeCapabilityAssertion;
|
|
8
|
+
};
|
|
9
|
+
export declare class BridgeCoordinator {
|
|
10
|
+
private readonly deps;
|
|
11
|
+
constructor(deps: BridgeCoordinatorDeps);
|
|
12
|
+
readonly register: (registration: BridgeRegistration, handler: BridgeHandler) => Promise<Result<void, "duplicate" | "capability_denied">>;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=BridgeCoordinator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BridgeCoordinator.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/facade/BridgeCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE3F,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;CACzD,CAAC;AAEF,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAExD,QAAQ,CAAC,QAAQ,GACf,cAAc,kBAAkB,EAChC,SAAS,aAAa,KACrB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC,CAAC,CAEzD;CACH"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { CapabilityId } from '@microverse.ts/runtime-capabilities';
|
|
2
|
+
import { BridgeCapabilityAssertion } from '../../domain/bridge/BridgeCapabilityAssertion';
|
|
3
|
+
export declare function createRegistryBackedAssertion(input: {
|
|
4
|
+
readonly isAllowed: (id: CapabilityId) => boolean;
|
|
5
|
+
}): BridgeCapabilityAssertion;
|
|
6
|
+
//# sourceMappingURL=RegistryBackedAssertion.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RegistryBackedAssertion.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/gates/RegistryBackedAssertion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAE/F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC;CACnD,GAAG,yBAAyB,CAQ5B"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { BridgeRegistry } from '../../domain/bridge/BridgeRegistry';
|
|
2
|
+
import { BridgeChannelId } from '../../domain/bridge/BridgeChannelId';
|
|
3
|
+
import { BridgeHandler } from '../../domain/bridge/BridgeMessage';
|
|
4
|
+
export declare class InMemoryBridgeRegistry implements BridgeRegistry {
|
|
5
|
+
private readonly handlers;
|
|
6
|
+
readonly register: (channel: BridgeChannelId, handler: BridgeHandler) => void;
|
|
7
|
+
readonly invoke: (channel: BridgeChannelId, payload: unknown) => Promise<unknown>;
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=InMemoryBridgeRegistry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"InMemoryBridgeRegistry.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/registry/InMemoryBridgeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IAEtE,QAAQ,CAAC,QAAQ,GAAI,SAAS,eAAe,EAAE,SAAS,aAAa,KAAG,IAAI,CAK1E;IAEF,QAAQ,CAAC,MAAM,GAAU,SAAS,eAAe,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,OAAO,CAAC,CAMpF;CACH"}
|
package/package.json
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@microverse.ts/runtime-bridge",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"sideEffects": false,
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/QADRAX/Microverse.ts.git",
|
|
10
|
+
"directory": "packages/runtime-bridge"
|
|
11
|
+
},
|
|
12
|
+
"bugs": "https://github.com/QADRAX/Microverse.ts/issues",
|
|
13
|
+
"homepage": "https://github.com/QADRAX/Microverse.ts/tree/main/packages/runtime-bridge",
|
|
14
|
+
"publishConfig": {
|
|
15
|
+
"access": "public",
|
|
16
|
+
"provenance": true
|
|
17
|
+
},
|
|
18
|
+
"exports": {
|
|
19
|
+
".": {
|
|
20
|
+
"types": "./dist/index.d.ts",
|
|
21
|
+
"import": "./dist/index.js"
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"files": [
|
|
25
|
+
"dist"
|
|
26
|
+
],
|
|
27
|
+
"dependencies": {
|
|
28
|
+
"@microverse.ts/runtime-capabilities": "0.1.0",
|
|
29
|
+
"@microverse.ts/runtime-core": "0.1.0",
|
|
30
|
+
"@microverse.ts/shared": "0.1.0"
|
|
31
|
+
},
|
|
32
|
+
"devDependencies": {
|
|
33
|
+
"typescript": "^5.8.3",
|
|
34
|
+
"vite": "^8.0.0",
|
|
35
|
+
"vite-plugin-dts": "^4.5.4",
|
|
36
|
+
"vitest": "^3.1.4"
|
|
37
|
+
},
|
|
38
|
+
"scripts": {
|
|
39
|
+
"build": "vite build",
|
|
40
|
+
"lint": "eslint .",
|
|
41
|
+
"test": "vitest run",
|
|
42
|
+
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
43
|
+
}
|
|
44
|
+
}
|