@xemahq/biome-database-nest 0.34.0 → 0.35.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/README.md
CHANGED
|
@@ -75,7 +75,7 @@ import {
|
|
|
75
75
|
// `ORG_DATABASE_POOL_WORKER_DESCRIPTOR`),
|
|
76
76
|
// which publish the manifest's `maximumPerInstance` the pool is sized from.
|
|
77
77
|
// Without one the boot is refused; the number is never typed here.
|
|
78
|
-
// The pool is exactly requests + activities + 2 (the SDK's own connections).
|
|
78
|
+
// The pool is exactly requests + activities + nexus + 2 (the SDK's own connections).
|
|
79
79
|
// `DB_POOL_MAX_<KEY>` / `DB_POOL_MAX` is a feasibility ceiling only: below that
|
|
80
80
|
// size the boot is refused with a `BiomeDatabasePoolOptionsError`, never shrunk.
|
|
81
81
|
BiomeDatabaseModule.forRoot({
|
|
@@ -2,6 +2,7 @@ export declare const PLATFORM_CONNECTION_HEADROOM = 2;
|
|
|
2
2
|
export interface BiomeProcessConcurrency {
|
|
3
3
|
readonly requests?: number;
|
|
4
4
|
readonly activities?: number;
|
|
5
|
+
readonly nexus?: number;
|
|
5
6
|
}
|
|
6
7
|
export declare const BIOME_PROCESS_CONCURRENCY: unique symbol;
|
|
7
8
|
export interface BiomeDatabasePoolOptions {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pool-sizing.d.ts","sourceRoot":"","sources":["../../src/lib/pool-sizing.ts"],"names":[],"mappings":"AAwDA,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IAEtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"pool-sizing.d.ts","sourceRoot":"","sources":["../../src/lib/pool-sizing.ts"],"names":[],"mappings":"AAwDA,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IAEtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD,eAAO,MAAM,yBAAyB,eAAyC,CAAC;AAGhF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAC/C;AAED,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAeD,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,wBAAwB,CAa1B;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,IAAI,wBAAwB,CAqC1C;AASD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAMD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,wBAAwB,GAAG,SAAS,CAetC;AAMD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,wBAAwB,GAAG,SAAS,GAC5C,MAAM,CAYR;AAiBD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,wBAAwB,GAC7B,IAAI,CAUN;AAGD,wBAAgB,6BAA6B,IACzC,wBAAwB,GACxB,SAAS,CAIZ;AAGD,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}
|
package/dist/lib/pool-sizing.js
CHANGED
|
@@ -21,6 +21,9 @@ exports.BiomeDatabasePoolOptionsError = BiomeDatabasePoolOptionsError;
|
|
|
21
21
|
function isPositiveInteger(value) {
|
|
22
22
|
return typeof value === 'number' && Number.isInteger(value) && value > 0;
|
|
23
23
|
}
|
|
24
|
+
function isNonNegativeInteger(value) {
|
|
25
|
+
return typeof value === 'number' && Number.isInteger(value) && value >= 0;
|
|
26
|
+
}
|
|
24
27
|
function resolveBiomeDatabasePoolOptions(concurrency) {
|
|
25
28
|
if (concurrency === undefined) {
|
|
26
29
|
throw new BiomeDatabasePoolOptionsError('no process concurrency is declared: the pool is sized from the manifest ' +
|
|
@@ -43,7 +46,7 @@ function validateBiomeDatabasePoolOptions(opts) {
|
|
|
43
46
|
Array.isArray(concurrency)) {
|
|
44
47
|
throw new BiomeDatabasePoolOptionsError(`pool.concurrency is required and must be an object, got ${String(concurrency)}.`);
|
|
45
48
|
}
|
|
46
|
-
const { requests, activities } = concurrency;
|
|
49
|
+
const { requests, activities, nexus } = concurrency;
|
|
47
50
|
for (const [field, value] of [
|
|
48
51
|
['requests', requests],
|
|
49
52
|
['activities', activities],
|
|
@@ -52,6 +55,9 @@ function validateBiomeDatabasePoolOptions(opts) {
|
|
|
52
55
|
throw new BiomeDatabasePoolOptionsError(`pool.concurrency.${field} must be a positive integer, got ${String(value)}.`);
|
|
53
56
|
}
|
|
54
57
|
}
|
|
58
|
+
if (nexus !== undefined && !isNonNegativeInteger(nexus)) {
|
|
59
|
+
throw new BiomeDatabasePoolOptionsError(`pool.concurrency.nexus must be a non-negative integer, got ${String(nexus)}.`);
|
|
60
|
+
}
|
|
55
61
|
if (requests === undefined && activities === undefined) {
|
|
56
62
|
throw new BiomeDatabasePoolOptionsError('pool.concurrency must declare at least one of `requests` or `activities`.');
|
|
57
63
|
}
|
|
@@ -76,11 +82,11 @@ function biomeDatabasePoolCeilingFromEnv(env, dbKey) {
|
|
|
76
82
|
}
|
|
77
83
|
function resolveBiomeDatabasePoolMax(opts, ceiling) {
|
|
78
84
|
validateBiomeDatabasePoolOptions(opts);
|
|
79
|
-
const { requests = 0, activities = 0 } = opts.concurrency;
|
|
80
|
-
const required = requests + activities + exports.PLATFORM_CONNECTION_HEADROOM;
|
|
85
|
+
const { requests = 0, activities = 0, nexus = 0 } = opts.concurrency;
|
|
86
|
+
const required = requests + activities + nexus + exports.PLATFORM_CONNECTION_HEADROOM;
|
|
81
87
|
if (ceiling !== undefined && ceiling.value < required) {
|
|
82
88
|
throw new BiomeDatabasePoolOptionsError(`the pool needs ${required} connections but ${ceiling.variable} caps it at ${ceiling.value}. ` +
|
|
83
|
-
`Required = requests ${requests} + activities ${activities} + platform headroom ${exports.PLATFORM_CONNECTION_HEADROOM}. ` +
|
|
89
|
+
`Required = requests ${requests} + activities ${activities} + nexus ${nexus} + platform headroom ${exports.PLATFORM_CONNECTION_HEADROOM}. ` +
|
|
84
90
|
`Raise ${ceiling.variable} to at least ${required} or lower the declared concurrency.`);
|
|
85
91
|
}
|
|
86
92
|
return required;
|
|
@@ -88,7 +94,8 @@ function resolveBiomeDatabasePoolMax(opts, ceiling) {
|
|
|
88
94
|
const declaredPools = new Map();
|
|
89
95
|
function samePool(a, b) {
|
|
90
96
|
return (a.concurrency.requests === b.concurrency.requests &&
|
|
91
|
-
a.concurrency.activities === b.concurrency.activities
|
|
97
|
+
a.concurrency.activities === b.concurrency.activities &&
|
|
98
|
+
a.concurrency.nexus === b.concurrency.nexus);
|
|
92
99
|
}
|
|
93
100
|
function publishDeclaredBiomeDatabasePool(pool) {
|
|
94
101
|
const slot = (0, scoped_env_1.currentMountKey)('Publishing a declared biome database pool');
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pool-sizing.js","sourceRoot":"","sources":["../../src/lib/pool-sizing.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"pool-sizing.js","sourceRoot":"","sources":["../../src/lib/pool-sizing.ts"],"names":[],"mappings":";;;AAyGA,0EAeC;AAED,4EAuCC;AAmBD,0EAkBC;AAMD,kEAeC;AAiBD,4EAYC;AAGD,sEAMC;AAGD,0EAEC;AAlOD,6CAA+C;AAoBlC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAsBjC,QAAA,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAOhF,MAAa,6BAA8B,SAAQ,KAAK;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AALD,sEAKC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAOD,SAAgB,+BAA+B,CAC7C,WAAgD;IAEhD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,6BAA6B,CACrC,0EAA0E;YACxE,iGAAiG;YACjG,0EAA0E;YAC1E,yEAAyE;YACzE,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;IAC7B,gCAAgC,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,gCAAgC,CAC9C,IAAa;IAEb,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,6BAA6B,CACrC,+CAA+C,MAAM,CAAC,IAAI,CAAC,GAAG,CAC/D,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,WAAW,EAAE,GAAG,IAA+B,CAAC;IACxD,IACE,WAAW,KAAK,IAAI;QACpB,OAAO,WAAW,KAAK,QAAQ;QAC/B,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC1B,CAAC;QACD,MAAM,IAAI,6BAA6B,CACrC,2DAA2D,MAAM,CAAC,WAAW,CAAC,GAAG,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,WAAsC,CAAC;IAC/E,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI;QAC3B,CAAC,UAAU,EAAE,QAAQ,CAAC;QACtB,CAAC,YAAY,EAAE,UAAU,CAAC;KAClB,EAAE,CAAC;QACX,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,6BAA6B,CACrC,oBAAoB,KAAK,oCAAoC,MAAM,CAAC,KAAK,CAAC,GAAG,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,6BAA6B,CACrC,8DAA8D,MAAM,CAAC,KAAK,CAAC,GAAG,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACvD,MAAM,IAAI,6BAA6B,CACrC,2EAA2E,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC;AAGD,SAAS,YAAY,CAAC,KAAyB;IAC7C,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,SAAS,CAAC;IAC7E,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC;AAaD,SAAgB,+BAA+B,CAC7C,GAAsB,EACtB,KAAc;IAEd,MAAM,IAAI,GAAG,cAAc,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IAC5E,MAAM,GAAG,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,6BAA6B,CACrC,GAAG,QAAQ,qCAAqC,GAAG,IAAI,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAMD,SAAgB,2BAA2B,CACzC,IAA8B,EAC9B,OAA6C;IAE7C,gCAAgC,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;IACrE,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,oCAA4B,CAAC;IAC9E,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,GAAG,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,6BAA6B,CACrC,kBAAkB,QAAQ,oBAAoB,OAAO,CAAC,QAAQ,eAAe,OAAO,CAAC,KAAK,IAAI;YAC5F,uBAAuB,QAAQ,iBAAiB,UAAU,YAAY,KAAK,wBAAwB,oCAA4B,IAAI;YACnI,SAAS,OAAO,CAAC,QAAQ,gBAAgB,QAAQ,qCAAqC,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAGD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoC,CAAC;AAElE,SAAS,QAAQ,CAAC,CAA2B,EAAE,CAA2B;IACxE,OAAO,CACL,CAAC,CAAC,WAAW,CAAC,QAAQ,KAAK,CAAC,CAAC,WAAW,CAAC,QAAQ;QACjD,CAAC,CAAC,WAAW,CAAC,UAAU,KAAK,CAAC,CAAC,WAAW,CAAC,UAAU;QACrD,CAAC,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,CAAC,KAAK,CAC5C,CAAC;AACJ,CAAC;AAMD,SAAgB,gCAAgC,CAC9C,IAA8B;IAE9B,MAAM,IAAI,GAAG,IAAA,4BAAe,EAAC,2CAA2C,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,6BAA6B,CACrC,wDAAwD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;YACjF,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kDAAkD,CAC/E,CAAC;IACJ,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAGD,SAAgB,6BAA6B;IAG3C,OAAO,aAAa,CAAC,GAAG,CACtB,IAAA,4BAAe,EAAC,wCAAwC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAGD,SAAgB,+BAA+B;IAC7C,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xemahq/biome-database-nest",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.35.0",
|
|
4
4
|
"description": "Explicit database migration ownership, least-privilege runtime verification, and schema-qualified Prisma wiring for Xema biome services.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
|
|
@@ -39,9 +39,9 @@
|
|
|
39
39
|
"prisma": "7.8.0",
|
|
40
40
|
"ts-jest": "^29.4.9",
|
|
41
41
|
"typescript": "5.9.3",
|
|
42
|
-
"@xemahq/xema-decorators": "0.24.0",
|
|
43
42
|
"@xemahq/eslint-config": "0.12.1",
|
|
44
|
-
"@xemahq/service-registry-nest": "0.21.0"
|
|
43
|
+
"@xemahq/service-registry-nest": "0.21.0",
|
|
44
|
+
"@xemahq/xema-decorators": "0.24.0"
|
|
45
45
|
},
|
|
46
46
|
"peerDependencies": {
|
|
47
47
|
"@nestjs/common": "^10 || ^11",
|
|
@@ -78,6 +78,6 @@
|
|
|
78
78
|
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
79
79
|
},
|
|
80
80
|
"xemaRelease": {
|
|
81
|
-
"sourceDigest": "sha256:
|
|
81
|
+
"sourceDigest": "sha256:98e3b4b91926488bf6b003ad8f5fb25086bb474c12b969976861c55bb7a9bd4b"
|
|
82
82
|
}
|
|
83
83
|
}
|