@microverse.ts/runtime-capabilities 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QADRAX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/application/ports/CapabilityRegistryPort.d.ts

@@ -0,0 +1,5 @@
+import { CapabilityId } from '../../domain/capabilities/CapabilityId';
+export type CapabilityRegistryPort = {
+    readonly isAllowed: (id: CapabilityId) => boolean;
+};
+//# sourceMappingURL=CapabilityRegistryPort.d.ts.map

package/dist/application/ports/CapabilityRegistryPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityRegistryPort.d.ts","sourceRoot":"","sources":["../../../src/application/ports/CapabilityRegistryPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAE3E,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC;CACnD,CAAC"}

package/dist/application/useCases/evaluateCapability.d.ts

@@ -0,0 +1,9 @@
+import { AsyncUseCase, Result } from '@microverse.ts/shared';
+import { CapabilityRegistryPort } from '../ports/CapabilityRegistryPort';
+import { CapabilityId } from '../../domain/capabilities/CapabilityId';
+export type EvaluateCapabilityPorts = readonly [CapabilityRegistryPort];
+/**
+ * Port tuple order: `[CapabilityRegistryPort]`.
+ */
+export declare const evaluateCapability: AsyncUseCase<EvaluateCapabilityPorts, readonly [CapabilityId], Result<void, 'denied'>>;
+//# sourceMappingURL=evaluateCapability.d.ts.map

package/dist/application/useCases/evaluateCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateCapability.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/evaluateCapability.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,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAE3E,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAC3C,uBAAuB,EACvB,SAAS,CAAC,YAAY,CAAC,EACvB,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAIvB,CAAC"}

package/dist/domain/capabilities/CapabilityDescriptor.d.ts

@@ -0,0 +1,6 @@
+import { CapabilityId } from './CapabilityId';
+export type CapabilityDescriptor = {
+    readonly id: CapabilityId;
+    readonly description: string;
+};
+//# sourceMappingURL=CapabilityDescriptor.d.ts.map

package/dist/domain/capabilities/CapabilityDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityDescriptor.d.ts","sourceRoot":"","sources":["../../../src/domain/capabilities/CapabilityDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC"}

package/dist/domain/capabilities/CapabilityId.d.ts

@@ -0,0 +1,5 @@
+export type CapabilityId = string & {
+    readonly __brand: 'CapabilityId';
+};
+export declare function createCapabilityId(value: `${string}:${string}`): CapabilityId;
+//# sourceMappingURL=CapabilityId.d.ts.map

package/dist/domain/capabilities/CapabilityId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityId.d.ts","sourceRoot":"","sources":["../../../src/domain/capabilities/CapabilityId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,YAAY,CAE7E"}

package/dist/domain/capabilities/CapabilityPolicy.d.ts

@@ -0,0 +1,7 @@
+import { CapabilityId } from './CapabilityId';
+export type CapabilityPolicy = {
+    readonly allow: ReadonlySet<CapabilityId>;
+};
+export declare function createAllowlist(capabilities: readonly CapabilityId[]): CapabilityPolicy;
+export declare function mergePolicies(a: CapabilityPolicy, b: CapabilityPolicy): CapabilityPolicy;
+//# sourceMappingURL=CapabilityPolicy.d.ts.map

package/dist/domain/capabilities/CapabilityPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityPolicy.d.ts","sourceRoot":"","sources":["../../../src/domain/capabilities/CapabilityPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CAC3C,CAAC;AAEF,wBAAgB,eAAe,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,GAAG,gBAAgB,CAEvF;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAGxF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { CapabilityRegistryPort } from './application/ports/CapabilityRegistryPort';
+export type { CapabilityDescriptor } from './domain/capabilities/CapabilityDescriptor';
+export { createCapabilityId, type CapabilityId } from './domain/capabilities/CapabilityId';
+export { createAllowlist, mergePolicies, type CapabilityPolicy, } from './domain/capabilities/CapabilityPolicy';
+export { InMemoryCapabilityRegistry } from './infrastructure/registry/InMemoryCapabilityRegistry';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,YAAY,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+//#region src/domain/capabilities/CapabilityId.ts
+function createCapabilityId(value) {
+	return value;
+}
+//#endregion
+//#region src/domain/capabilities/CapabilityPolicy.ts
+function createAllowlist(capabilities) {
+	return { allow: new Set(capabilities) };
+}
+function mergePolicies(a, b) {
+	return { allow: new Set([...a.allow, ...b.allow]) };
+}
+//#endregion
+//#region src/infrastructure/registry/InMemoryCapabilityRegistry.ts
+var InMemoryCapabilityRegistry = class {
+	policy;
+	constructor(policy) {
+		this.policy = policy;
+	}
+	isAllowed = (id) => this.policy.allow.has(id);
+	setPolicy = (policy) => {
+		this.policy = policy;
+	};
+};
+//#endregion
+export { InMemoryCapabilityRegistry, createAllowlist, createCapabilityId, mergePolicies };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/domain/capabilities/CapabilityId.ts","../src/domain/capabilities/CapabilityPolicy.ts","../src/infrastructure/registry/InMemoryCapabilityRegistry.ts"],"sourcesContent":["export type CapabilityId = string & { readonly __brand: 'CapabilityId' };\n\nexport function createCapabilityId(value: `${string}:${string}`): CapabilityId {\n  return value as CapabilityId;\n}\n","import type { CapabilityId } from './CapabilityId';\n\nexport type CapabilityPolicy = {\n  readonly allow: ReadonlySet<CapabilityId>;\n};\n\nexport function createAllowlist(capabilities: readonly CapabilityId[]): CapabilityPolicy {\n  return { allow: new Set(capabilities) };\n}\n\nexport function mergePolicies(a: CapabilityPolicy, b: CapabilityPolicy): CapabilityPolicy {\n  const merged = new Set<CapabilityId>([...a.allow, ...b.allow]);\n  return { allow: merged };\n}\n","import type { CapabilityRegistryPort } from '../../application/ports/CapabilityRegistryPort';\nimport type { CapabilityId } from '../../domain/capabilities/CapabilityId';\nimport type { CapabilityPolicy } from '../../domain/capabilities/CapabilityPolicy';\n\nexport class InMemoryCapabilityRegistry implements CapabilityRegistryPort {\n  constructor(private policy: CapabilityPolicy) {}\n\n  readonly isAllowed = (id: CapabilityId): boolean => this.policy.allow.has(id);\n\n  readonly setPolicy = (policy: CapabilityPolicy): void => {\n    this.policy = policy;\n  };\n}\n"],"mappings":";AAEA,SAAgB,mBAAmB,OAA4C;CAC7E,OAAO;AACT;;;ACEA,SAAgB,gBAAgB,cAAyD;CACvF,OAAO,EAAE,OAAO,IAAI,IAAI,YAAY,EAAE;AACxC;AAEA,SAAgB,cAAc,GAAqB,GAAuC;CAExF,OAAO,EAAE,OAAO,IADG,IAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,KAAK,CAC5C,EAAO;AACzB;;;ACTA,IAAa,6BAAb,MAA0E;CACpD;CAApB,YAAY,QAAkC;EAA1B,KAAA,SAAA;CAA2B;CAE/C,aAAsB,OAA8B,KAAK,OAAO,MAAM,IAAI,EAAE;CAE5E,aAAsB,WAAmC;EACvD,KAAK,SAAS;CAChB;AACF"}

package/dist/infrastructure/registry/InMemoryCapabilityRegistry.d.ts

@@ -0,0 +1,10 @@
+import { CapabilityRegistryPort } from '../../application/ports/CapabilityRegistryPort';
+import { CapabilityId } from '../../domain/capabilities/CapabilityId';
+import { CapabilityPolicy } from '../../domain/capabilities/CapabilityPolicy';
+export declare class InMemoryCapabilityRegistry implements CapabilityRegistryPort {
+    private policy;
+    constructor(policy: CapabilityPolicy);
+    readonly isAllowed: (id: CapabilityId) => boolean;
+    readonly setPolicy: (policy: CapabilityPolicy) => void;
+}
+//# sourceMappingURL=InMemoryCapabilityRegistry.d.ts.map

package/dist/infrastructure/registry/InMemoryCapabilityRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCapabilityRegistry.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/registry/InMemoryCapabilityRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,qBAAa,0BAA2B,YAAW,sBAAsB;IAC3D,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAE5C,QAAQ,CAAC,SAAS,GAAI,IAAI,YAAY,KAAG,OAAO,CAA8B;IAE9E,QAAQ,CAAC,SAAS,GAAI,QAAQ,gBAAgB,KAAG,IAAI,CAEnD;CACH"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@microverse.ts/runtime-capabilities",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/QADRAX/Microverse.ts.git",
+    "directory": "packages/runtime-capabilities"
+  },
+  "bugs": "https://github.com/QADRAX/Microverse.ts/issues",
+  "homepage": "https://github.com/QADRAX/Microverse.ts/tree/main/packages/runtime-capabilities",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@microverse.ts/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vite": "^8.0.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.1.4"
+  },
+  "scripts": {
+    "build": "vite build",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}