@omnitron-dev/titan-database 0.1.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 (83) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +27 -0
  3. package/dist/database.constants.d.ts +32 -0
  4. package/dist/database.constants.d.ts.map +1 -0
  5. package/dist/database.constants.js +37 -0
  6. package/dist/database.constants.js.map +1 -0
  7. package/dist/database.decorators.d.ts +86 -0
  8. package/dist/database.decorators.d.ts.map +1 -0
  9. package/dist/database.decorators.js +239 -0
  10. package/dist/database.decorators.js.map +1 -0
  11. package/dist/database.health.d.ts +22 -0
  12. package/dist/database.health.d.ts.map +1 -0
  13. package/dist/database.health.js +140 -0
  14. package/dist/database.health.js.map +1 -0
  15. package/dist/database.internal-types.d.ts +83 -0
  16. package/dist/database.internal-types.d.ts.map +1 -0
  17. package/dist/database.internal-types.js +38 -0
  18. package/dist/database.internal-types.js.map +1 -0
  19. package/dist/database.manager.d.ts +97 -0
  20. package/dist/database.manager.d.ts.map +1 -0
  21. package/dist/database.manager.js +833 -0
  22. package/dist/database.manager.js.map +1 -0
  23. package/dist/database.module.d.ts +15 -0
  24. package/dist/database.module.d.ts.map +1 -0
  25. package/dist/database.module.js +195 -0
  26. package/dist/database.module.js.map +1 -0
  27. package/dist/database.types.d.ts +326 -0
  28. package/dist/database.types.d.ts.map +1 -0
  29. package/dist/database.types.js +15 -0
  30. package/dist/database.types.js.map +1 -0
  31. package/dist/exports/dialects.d.ts +2 -0
  32. package/dist/exports/dialects.d.ts.map +1 -0
  33. package/dist/exports/dialects.js +2 -0
  34. package/dist/exports/dialects.js.map +1 -0
  35. package/dist/exports/kysera.d.ts +16 -0
  36. package/dist/exports/kysera.d.ts.map +1 -0
  37. package/dist/exports/kysera.js +9 -0
  38. package/dist/exports/kysera.js.map +1 -0
  39. package/dist/exports/migration.d.ts +4 -0
  40. package/dist/exports/migration.d.ts.map +1 -0
  41. package/dist/exports/migration.js +2 -0
  42. package/dist/exports/migration.js.map +1 -0
  43. package/dist/exports/plugins.d.ts +9 -0
  44. package/dist/exports/plugins.d.ts.map +1 -0
  45. package/dist/exports/plugins.js +5 -0
  46. package/dist/exports/plugins.js.map +1 -0
  47. package/dist/exports/repository.d.ts +3 -0
  48. package/dist/exports/repository.d.ts.map +1 -0
  49. package/dist/exports/repository.js +2 -0
  50. package/dist/exports/repository.js.map +1 -0
  51. package/dist/exports/rls.d.ts +10 -0
  52. package/dist/exports/rls.d.ts.map +1 -0
  53. package/dist/exports/rls.js +6 -0
  54. package/dist/exports/rls.js.map +1 -0
  55. package/dist/exports/transaction.d.ts +3 -0
  56. package/dist/exports/transaction.d.ts.map +1 -0
  57. package/dist/exports/transaction.js +2 -0
  58. package/dist/exports/transaction.js.map +1 -0
  59. package/dist/index.d.ts +41 -0
  60. package/dist/index.d.ts.map +1 -0
  61. package/dist/index.js +26 -0
  62. package/dist/index.js.map +1 -0
  63. package/dist/plugins/sqlite-date-serializer.plugin.d.ts +9 -0
  64. package/dist/plugins/sqlite-date-serializer.plugin.d.ts.map +1 -0
  65. package/dist/plugins/sqlite-date-serializer.plugin.js +61 -0
  66. package/dist/plugins/sqlite-date-serializer.plugin.js.map +1 -0
  67. package/dist/repository/transaction-aware.repository.d.ts +90 -0
  68. package/dist/repository/transaction-aware.repository.d.ts.map +1 -0
  69. package/dist/repository/transaction-aware.repository.js +210 -0
  70. package/dist/repository/transaction-aware.repository.js.map +1 -0
  71. package/dist/transaction/transaction.context.d.ts +31 -0
  72. package/dist/transaction/transaction.context.d.ts.map +1 -0
  73. package/dist/transaction/transaction.context.js +81 -0
  74. package/dist/transaction/transaction.context.js.map +1 -0
  75. package/dist/utils/type-guards.d.ts +29 -0
  76. package/dist/utils/type-guards.d.ts.map +1 -0
  77. package/dist/utils/type-guards.js +75 -0
  78. package/dist/utils/type-guards.js.map +1 -0
  79. package/dist/uuid-v7.d.ts +5 -0
  80. package/dist/uuid-v7.d.ts.map +1 -0
  81. package/dist/uuid-v7.js +22 -0
  82. package/dist/uuid-v7.js.map +1 -0
  83. package/package.json +92 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 LuxQuant
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.
package/README.md ADDED
@@ -0,0 +1,27 @@
1
+ # @omnitron-dev/titan-database
2
+
3
+ > Database module for the Titan framework — Kysely, migrations, RLS, multi-dialect
4
+
5
+ Part of the [Omni](../../README.md) monorepo — Fullstack Type-Safe RPC Framework.
6
+
7
+ ## Installation
8
+
9
+ ```bash
10
+ pnpm add @omnitron-dev/titan-database
11
+ ```
12
+
13
+ ## Overview
14
+
15
+ Provides database connectivity for Titan applications using Kysely as the query builder. Supports PostgreSQL and SQLite dialects, declarative migrations, and row-level security (RLS) via `AsyncLocalStorage` context propagation.
16
+
17
+ ### Key Features
18
+
19
+ - Kysely-based typed query builder
20
+ - Declarative migration system
21
+ - Row-level security (RLS) with async context
22
+ - Multi-dialect support (PostgreSQL, SQLite)
23
+ - Connection pooling and health checks
24
+
25
+ ## License
26
+
27
+ MIT
@@ -0,0 +1,32 @@
1
+ export declare const DATABASE_DEFAULT_CONNECTION = "default";
2
+ export declare const DATABASE_MANAGER: unique symbol;
3
+ export declare const DATABASE_MODULE_OPTIONS: unique symbol;
4
+ export declare const DATABASE_CONNECTION: unique symbol;
5
+ export declare const DATABASE_HEALTH_INDICATOR: unique symbol;
6
+ export declare function getDatabaseConnectionToken(name?: string): string | symbol;
7
+ export declare function getRepositoryToken(target: any): string;
8
+ export declare const DEFAULT_POOL_CONFIG: {
9
+ min: number;
10
+ max: number;
11
+ idleTimeoutMillis: number;
12
+ acquireTimeoutMillis: number;
13
+ };
14
+ export declare const DEFAULT_TIMEOUTS: {
15
+ query: number;
16
+ transaction: number;
17
+ shutdown: number;
18
+ health: number;
19
+ };
20
+ export declare const METADATA_KEYS: {
21
+ readonly REPOSITORY: "database:repository";
22
+ readonly MIGRATION: "database:migration";
23
+ readonly SOFT_DELETE: "database:plugin:soft-delete";
24
+ readonly TIMESTAMPS: "database:plugin:timestamps";
25
+ readonly AUDIT: "database:plugin:audit";
26
+ readonly RLS_POLICY: "database:rls:policy";
27
+ readonly RLS_ALLOW: "database:rls:allow";
28
+ readonly RLS_DENY: "database:rls:deny";
29
+ readonly RLS_FILTER: "database:rls:filter";
30
+ readonly RLS_BYPASS: "database:rls:bypass";
31
+ };
32
+ //# sourceMappingURL=database.constants.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.constants.d.ts","sourceRoot":"","sources":["../src/database.constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAMrD,eAAO,MAAM,gBAAgB,eAAuC,CAAC;AACrE,eAAO,MAAM,uBAAuB,eAA8C,CAAC;AACnF,eAAO,MAAM,mBAAmB,eAA0C,CAAC;AAC3E,eAAO,MAAM,yBAAyB,eAAgD,CAAC;AAKvF,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,MAAoC,GAAG,MAAM,GAAG,MAAM,CAEtG;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAGtD;AAMD,eAAO,MAAM,mBAAmB;;;;;CAK/B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAMF,eAAO,MAAM,aAAa;;;;;;;;;;;CAWhB,CAAC"}
@@ -0,0 +1,37 @@
1
+ export const DATABASE_DEFAULT_CONNECTION = 'default';
2
+ export const DATABASE_MANAGER = Symbol.for('titan:DATABASE_MANAGER');
3
+ export const DATABASE_MODULE_OPTIONS = Symbol.for('titan:DATABASE_MODULE_OPTIONS');
4
+ export const DATABASE_CONNECTION = Symbol.for('titan:DATABASE_CONNECTION');
5
+ export const DATABASE_HEALTH_INDICATOR = Symbol.for('titan:DATABASE_HEALTH_INDICATOR');
6
+ export function getDatabaseConnectionToken(name = DATABASE_DEFAULT_CONNECTION) {
7
+ return name === DATABASE_DEFAULT_CONNECTION ? DATABASE_CONNECTION : `DATABASE_CONNECTION:${name}`;
8
+ }
9
+ export function getRepositoryToken(target) {
10
+ const name = typeof target === 'string' ? target : target.name;
11
+ return `REPOSITORY:${name}`;
12
+ }
13
+ export const DEFAULT_POOL_CONFIG = {
14
+ min: 2,
15
+ max: 20,
16
+ idleTimeoutMillis: 30000,
17
+ acquireTimeoutMillis: 60000,
18
+ };
19
+ export const DEFAULT_TIMEOUTS = {
20
+ query: 30000,
21
+ transaction: 60000,
22
+ shutdown: 10000,
23
+ health: 5000,
24
+ };
25
+ export const METADATA_KEYS = {
26
+ REPOSITORY: 'database:repository',
27
+ MIGRATION: 'database:migration',
28
+ SOFT_DELETE: 'database:plugin:soft-delete',
29
+ TIMESTAMPS: 'database:plugin:timestamps',
30
+ AUDIT: 'database:plugin:audit',
31
+ RLS_POLICY: 'database:rls:policy',
32
+ RLS_ALLOW: 'database:rls:allow',
33
+ RLS_DENY: 'database:rls:deny',
34
+ RLS_FILTER: 'database:rls:filter',
35
+ RLS_BYPASS: 'database:rls:bypass',
36
+ };
37
+ //# sourceMappingURL=database.constants.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.constants.js","sourceRoot":"","sources":["../src/database.constants.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAMrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAKvF,MAAM,UAAU,0BAA0B,CAAC,OAAe,2BAA2B;IACnF,OAAO,IAAI,KAAK,2BAA2B,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,uBAAuB,IAAI,EAAE,CAAC;AACpG,CAAC;AAKD,MAAM,UAAU,kBAAkB,CAAC,MAAW;IAC5C,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAC/D,OAAO,cAAc,IAAI,EAAE,CAAC;AAC9B,CAAC;AAMD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,IAAI;CACb,CAAC;AAMF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,qBAAqB;IACjC,SAAS,EAAE,oBAAoB;IAC/B,WAAW,EAAE,6BAA6B;IAC1C,UAAU,EAAE,4BAA4B;IACxC,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,qBAAqB;IACjC,SAAS,EAAE,oBAAoB;IAC/B,QAAQ,EAAE,mBAAmB;IAC7B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,qBAAqB;CACzB,CAAC"}
@@ -0,0 +1,86 @@
1
+ import type { RepositoryConfig } from './database.types.js';
2
+ import type { Constructor } from '@omnitron-dev/titan/nexus';
3
+ import type { RepositoryConstructor } from './database.internal-types.js';
4
+ export declare function InjectConnection(name?: string): ParameterDecorator;
5
+ export declare function InjectDatabaseManager(): ParameterDecorator;
6
+ export declare function InjectRepository<T = unknown>(target: RepositoryConstructor<T>): ParameterDecorator;
7
+ export declare function Repository<Entity = unknown>(configOrTableName: RepositoryConfig<Entity> | string): ClassDecorator;
8
+ export declare function Migration(config: {
9
+ version: string;
10
+ description?: string;
11
+ dependencies?: string[];
12
+ connection?: string;
13
+ transactional?: boolean;
14
+ timeout?: number;
15
+ }): ClassDecorator;
16
+ export interface SoftDeleteConfig {
17
+ column?: string;
18
+ includeDeleted?: boolean;
19
+ tables?: string[];
20
+ }
21
+ export interface TimestampsConfig {
22
+ createdAt?: string;
23
+ updatedAt?: string;
24
+ }
25
+ export interface AuditConfig {
26
+ table?: string;
27
+ captureOldValues?: boolean;
28
+ captureNewValues?: boolean;
29
+ }
30
+ export declare function SoftDelete(config?: SoftDeleteConfig): ClassDecorator;
31
+ export declare function Timestamps(config?: TimestampsConfig): ClassDecorator;
32
+ export declare function Audit(config?: AuditConfig): ClassDecorator;
33
+ export declare function getRepositoryMetadata<Entity = unknown>(target: Constructor | RepositoryConstructor<Entity>): RepositoryConfig<Entity> | undefined;
34
+ export declare function isRepository(target: Constructor | RepositoryConstructor): boolean;
35
+ export declare function getMigrationMetadata(target: Constructor): {
36
+ version: string;
37
+ description?: string;
38
+ } | undefined;
39
+ export declare function isMigration(target: unknown): target is Constructor;
40
+ export declare function hasSoftDelete(target: Constructor | RepositoryConstructor): boolean;
41
+ export declare function getSoftDeleteConfig(target: Constructor | RepositoryConstructor): SoftDeleteConfig | undefined;
42
+ export declare function hasTimestamps(target: Constructor | RepositoryConstructor): boolean;
43
+ export declare function getTimestampsConfig(target: Constructor | RepositoryConstructor): TimestampsConfig | undefined;
44
+ export declare function hasAudit(target: Constructor | RepositoryConstructor): boolean;
45
+ export declare function getAuditConfig(target: Constructor | RepositoryConstructor): AuditConfig | undefined;
46
+ export declare function getDecoratorPlugins(target: Constructor | RepositoryConstructor): string[];
47
+ export interface RLSPolicyConfig {
48
+ table?: string;
49
+ skipFor?: string[];
50
+ defaultPolicy?: 'allow' | 'deny';
51
+ }
52
+ export interface RLSRuleConfig {
53
+ operations: Array<'select' | 'insert' | 'update' | 'delete'>;
54
+ priority?: number;
55
+ name?: string;
56
+ }
57
+ export interface RLSFilterConfig {
58
+ operations?: Array<'select' | 'insert' | 'update' | 'delete'>;
59
+ name?: string;
60
+ }
61
+ export declare function Policy(config?: RLSPolicyConfig): ClassDecorator;
62
+ export declare function Allow(config: RLSRuleConfig): MethodDecorator;
63
+ export declare function Deny(config: RLSRuleConfig): MethodDecorator;
64
+ export declare function Filter(config?: RLSFilterConfig): MethodDecorator;
65
+ export declare function BypassRLS(): MethodDecorator;
66
+ export declare function getRLSPolicyMetadata(target: Constructor): RLSPolicyConfig | undefined;
67
+ export declare function getRLSAllowRules(target: Constructor): Array<{
68
+ name: string;
69
+ method: string | symbol;
70
+ operations: string[];
71
+ priority: number;
72
+ }>;
73
+ export declare function getRLSDenyRules(target: Constructor): Array<{
74
+ name: string;
75
+ method: string | symbol;
76
+ operations: string[];
77
+ priority: number;
78
+ }>;
79
+ export declare function getRLSFilters(target: Constructor): Array<{
80
+ name: string;
81
+ method: string | symbol;
82
+ operations: string[];
83
+ }>;
84
+ export declare function getRLSBypassedMethods(target: Constructor): Array<string | symbol>;
85
+ export declare function isRLSEnabled(target: Constructor): boolean;
86
+ //# sourceMappingURL=database.decorators.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.decorators.d.ts","sourceRoot":"","sources":["../src/database.decorators.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,239 @@
1
+ import { Inject } from '@omnitron-dev/titan/decorators';
2
+ import { getDatabaseConnectionToken, getRepositoryToken, DATABASE_MANAGER, METADATA_KEYS, } from './database.constants.js';
3
+ export function InjectConnection(name) {
4
+ return Inject(getDatabaseConnectionToken(name));
5
+ }
6
+ export function InjectDatabaseManager() {
7
+ return Inject(DATABASE_MANAGER);
8
+ }
9
+ export function InjectRepository(target) {
10
+ return Inject(getRepositoryToken(target));
11
+ }
12
+ export function Repository(configOrTableName) {
13
+ return (target) => {
14
+ const config = typeof configOrTableName === 'string' ? { table: configOrTableName } : configOrTableName;
15
+ Reflect.defineMetadata(METADATA_KEYS.REPOSITORY, config, target);
16
+ Reflect.defineMetadata('database:is-repository', true, target);
17
+ Reflect.defineMetadata('database:table-name', config.table, target);
18
+ if (config.connection) {
19
+ Reflect.defineMetadata('database:connection-name', config.connection, target);
20
+ }
21
+ if (config.softDelete) {
22
+ Reflect.defineMetadata('database:has-soft-delete', true, target);
23
+ const softDeleteConfig = typeof config.softDelete === 'object' ? config.softDelete : { column: 'deletedAt' };
24
+ Reflect.defineMetadata(METADATA_KEYS.SOFT_DELETE, softDeleteConfig, target);
25
+ }
26
+ if (config.timestamps) {
27
+ Reflect.defineMetadata('database:has-timestamps', true, target);
28
+ const timestampsConfig = typeof config.timestamps === 'object' ? config.timestamps : { createdAt: 'createdAt', updatedAt: 'updatedAt' };
29
+ Reflect.defineMetadata(METADATA_KEYS.TIMESTAMPS, timestampsConfig, target);
30
+ }
31
+ if (config.audit) {
32
+ Reflect.defineMetadata('database:has-audit', true, target);
33
+ const auditConfig = typeof config.audit === 'object' ? config.audit : { table: 'audit_logs' };
34
+ Reflect.defineMetadata(METADATA_KEYS.AUDIT, auditConfig, target);
35
+ }
36
+ const globalRepos = Reflect.getMetadata('database:repositories', global) || [];
37
+ globalRepos.push({
38
+ target,
39
+ metadata: {
40
+ table: config.table,
41
+ connection: config.connection,
42
+ schema: config.schema,
43
+ createSchema: config.createSchema,
44
+ updateSchema: config.updateSchema,
45
+ plugins: config.plugins,
46
+ softDelete: config.softDelete,
47
+ timestamps: config.timestamps,
48
+ audit: config.audit,
49
+ },
50
+ });
51
+ Reflect.defineMetadata('database:repositories', globalRepos, global);
52
+ return target;
53
+ };
54
+ }
55
+ export function Migration(config) {
56
+ return (target) => {
57
+ const metadata = {
58
+ version: config.version,
59
+ description: config.description,
60
+ name: target.name,
61
+ dependencies: config.dependencies,
62
+ connection: config.connection,
63
+ transactional: config.transactional !== false,
64
+ timeout: config.timeout,
65
+ createdAt: new Date(),
66
+ };
67
+ Reflect.defineMetadata(METADATA_KEYS.MIGRATION, metadata, target);
68
+ Reflect.defineMetadata('database:is-migration', true, target);
69
+ Reflect.defineMetadata('database:migration-version', config.version, target);
70
+ const migrations = Reflect.getMetadata('database:migrations', global) || [];
71
+ migrations.push({ target, metadata });
72
+ Reflect.defineMetadata('database:migrations', migrations, global);
73
+ return target;
74
+ };
75
+ }
76
+ export function SoftDelete(config) {
77
+ return (target) => {
78
+ const existingConfig = Reflect.getMetadata(METADATA_KEYS.REPOSITORY, target) || {};
79
+ Reflect.defineMetadata(METADATA_KEYS.SOFT_DELETE, config || {}, target);
80
+ Reflect.defineMetadata('database:has-soft-delete', true, target);
81
+ Reflect.defineMetadata(METADATA_KEYS.REPOSITORY, {
82
+ ...existingConfig,
83
+ softDelete: config || true,
84
+ }, target);
85
+ return target;
86
+ };
87
+ }
88
+ export function Timestamps(config) {
89
+ return (target) => {
90
+ const existingConfig = Reflect.getMetadata(METADATA_KEYS.REPOSITORY, target) || {};
91
+ Reflect.defineMetadata(METADATA_KEYS.TIMESTAMPS, config || {}, target);
92
+ Reflect.defineMetadata('database:has-timestamps', true, target);
93
+ Reflect.defineMetadata(METADATA_KEYS.REPOSITORY, {
94
+ ...existingConfig,
95
+ timestamps: config || true,
96
+ }, target);
97
+ return target;
98
+ };
99
+ }
100
+ export function Audit(config) {
101
+ return (target) => {
102
+ const existingConfig = Reflect.getMetadata(METADATA_KEYS.REPOSITORY, target) || {};
103
+ Reflect.defineMetadata(METADATA_KEYS.AUDIT, config || {}, target);
104
+ Reflect.defineMetadata('database:has-audit', true, target);
105
+ Reflect.defineMetadata(METADATA_KEYS.REPOSITORY, {
106
+ ...existingConfig,
107
+ audit: config || true,
108
+ }, target);
109
+ return target;
110
+ };
111
+ }
112
+ export function getRepositoryMetadata(target) {
113
+ return Reflect.getMetadata(METADATA_KEYS.REPOSITORY, target);
114
+ }
115
+ export function isRepository(target) {
116
+ return Reflect.getMetadata('database:is-repository', target) === true;
117
+ }
118
+ export function getMigrationMetadata(target) {
119
+ return Reflect.getMetadata(METADATA_KEYS.MIGRATION, target);
120
+ }
121
+ export function isMigration(target) {
122
+ if (typeof target !== 'function')
123
+ return false;
124
+ return Reflect.getMetadata('database:is-migration', target) === true;
125
+ }
126
+ export function hasSoftDelete(target) {
127
+ return Reflect.getMetadata('database:has-soft-delete', target) === true;
128
+ }
129
+ export function getSoftDeleteConfig(target) {
130
+ if (!hasSoftDelete(target))
131
+ return undefined;
132
+ return Reflect.getMetadata(METADATA_KEYS.SOFT_DELETE, target);
133
+ }
134
+ export function hasTimestamps(target) {
135
+ return Reflect.getMetadata('database:has-timestamps', target) === true;
136
+ }
137
+ export function getTimestampsConfig(target) {
138
+ if (!hasTimestamps(target))
139
+ return undefined;
140
+ return Reflect.getMetadata(METADATA_KEYS.TIMESTAMPS, target);
141
+ }
142
+ export function hasAudit(target) {
143
+ return Reflect.getMetadata('database:has-audit', target) === true;
144
+ }
145
+ export function getAuditConfig(target) {
146
+ if (!hasAudit(target))
147
+ return undefined;
148
+ return Reflect.getMetadata(METADATA_KEYS.AUDIT, target);
149
+ }
150
+ export function getDecoratorPlugins(target) {
151
+ const plugins = [];
152
+ if (hasSoftDelete(target)) {
153
+ plugins.push('soft-delete');
154
+ }
155
+ if (hasTimestamps(target)) {
156
+ plugins.push('timestamps');
157
+ }
158
+ if (hasAudit(target)) {
159
+ plugins.push('audit');
160
+ }
161
+ return plugins;
162
+ }
163
+ export function Policy(config) {
164
+ return (target) => {
165
+ const existingConfig = Reflect.getMetadata(METADATA_KEYS.REPOSITORY, target) || {};
166
+ Reflect.defineMetadata(METADATA_KEYS.REPOSITORY, {
167
+ ...existingConfig,
168
+ rls: config || {},
169
+ }, target);
170
+ Reflect.defineMetadata(METADATA_KEYS.RLS_POLICY, config || {}, target);
171
+ Reflect.defineMetadata('database:rls-enabled', true, target);
172
+ return target;
173
+ };
174
+ }
175
+ export function Allow(config) {
176
+ return (target, propertyKey, descriptor) => {
177
+ const rules = Reflect.getMetadata(METADATA_KEYS.RLS_ALLOW, target.constructor) || [];
178
+ rules.push({
179
+ name: config.name || String(propertyKey),
180
+ method: propertyKey,
181
+ operations: config.operations,
182
+ priority: config.priority ?? 0,
183
+ });
184
+ Reflect.defineMetadata(METADATA_KEYS.RLS_ALLOW, rules, target.constructor);
185
+ return descriptor;
186
+ };
187
+ }
188
+ export function Deny(config) {
189
+ return (target, propertyKey, descriptor) => {
190
+ const rules = Reflect.getMetadata(METADATA_KEYS.RLS_DENY, target.constructor) || [];
191
+ rules.push({
192
+ name: config.name || String(propertyKey),
193
+ method: propertyKey,
194
+ operations: config.operations,
195
+ priority: config.priority ?? 0,
196
+ });
197
+ Reflect.defineMetadata(METADATA_KEYS.RLS_DENY, rules, target.constructor);
198
+ return descriptor;
199
+ };
200
+ }
201
+ export function Filter(config) {
202
+ return (target, propertyKey, descriptor) => {
203
+ const filters = Reflect.getMetadata(METADATA_KEYS.RLS_FILTER, target.constructor) || [];
204
+ filters.push({
205
+ name: config?.name || String(propertyKey),
206
+ method: propertyKey,
207
+ operations: config?.operations || ['select'],
208
+ });
209
+ Reflect.defineMetadata(METADATA_KEYS.RLS_FILTER, filters, target.constructor);
210
+ return descriptor;
211
+ };
212
+ }
213
+ export function BypassRLS() {
214
+ return (target, propertyKey, descriptor) => {
215
+ const bypassed = Reflect.getMetadata(METADATA_KEYS.RLS_BYPASS, target.constructor) || [];
216
+ bypassed.push(propertyKey);
217
+ Reflect.defineMetadata(METADATA_KEYS.RLS_BYPASS, bypassed, target.constructor);
218
+ return descriptor;
219
+ };
220
+ }
221
+ export function getRLSPolicyMetadata(target) {
222
+ return Reflect.getMetadata(METADATA_KEYS.RLS_POLICY, target);
223
+ }
224
+ export function getRLSAllowRules(target) {
225
+ return Reflect.getMetadata(METADATA_KEYS.RLS_ALLOW, target) || [];
226
+ }
227
+ export function getRLSDenyRules(target) {
228
+ return Reflect.getMetadata(METADATA_KEYS.RLS_DENY, target) || [];
229
+ }
230
+ export function getRLSFilters(target) {
231
+ return Reflect.getMetadata(METADATA_KEYS.RLS_FILTER, target) || [];
232
+ }
233
+ export function getRLSBypassedMethods(target) {
234
+ return Reflect.getMetadata(METADATA_KEYS.RLS_BYPASS, target) || [];
235
+ }
236
+ export function isRLSEnabled(target) {
237
+ return Reflect.getMetadata('database:rls-enabled', target) === true;
238
+ }
239
+ //# sourceMappingURL=database.decorators.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.decorators.js","sourceRoot":"","sources":["../src/database.decorators.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAQjC,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAKD,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAClC,CAAC;AAKD,MAAM,UAAU,gBAAgB,CAAc,MAAgC;IAC5E,OAAO,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC;AAoBD,MAAM,UAAU,UAAU,CAAmB,iBAAoD;IAE/F,OAAO,CAA6B,MAAiB,EAAa,EAAE;QAElE,MAAM,MAAM,GACV,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAG3F,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAGjE,OAAO,CAAC,cAAc,CAAC,wBAAwB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAG/D,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAGpE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,cAAc,CAAC,0BAA0B,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChF,CAAC;QAID,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,cAAc,CAAC,0BAA0B,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACjE,MAAM,gBAAgB,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC7G,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC9E,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,cAAc,CAAC,yBAAyB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChE,MAAM,gBAAgB,GACpB,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;YACjH,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YAC9F,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAGD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC/E,WAAW,CAAC,IAAI,CAAC;YACf,MAAM;YACN,QAAQ,EAAE;gBACR,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAErE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,SAAS,CAAC,MAOzB;IAEC,OAAO,CAA6B,MAAiB,EAAa,EAAE;QAClE,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,aAAa,EAAE,MAAM,CAAC,aAAa,KAAK,KAAK;YAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAGF,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAGlE,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAG9D,OAAO,CAAC,cAAc,CAAC,4BAA4B,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAG7E,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5E,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAElE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAyED,MAAM,UAAU,UAAU,CAAC,MAAyB;IAElD,OAAO,CAA6B,MAAiB,EAAa,EAAE;QAClE,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAGnF,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAGxE,OAAO,CAAC,cAAc,CAAC,0BAA0B,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAGjE,OAAO,CAAC,cAAc,CACpB,aAAa,CAAC,UAAU,EACxB;YACE,GAAG,cAAc;YACjB,UAAU,EAAE,MAAM,IAAI,IAAI;SAC3B,EACD,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AA0BD,MAAM,UAAU,UAAU,CAAC,MAAyB;IAElD,OAAO,CAA6B,MAAiB,EAAa,EAAE;QAClE,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAGnF,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAGvE,OAAO,CAAC,cAAc,CAAC,yBAAyB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAGhE,OAAO,CAAC,cAAc,CACpB,aAAa,CAAC,UAAU,EACxB;YACE,GAAG,cAAc;YACjB,UAAU,EAAE,MAAM,IAAI,IAAI;SAC3B,EACD,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AA0BD,MAAM,UAAU,KAAK,CAAC,MAAoB;IAExC,OAAO,CAA6B,MAAiB,EAAa,EAAE;QAClE,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAGnF,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAGlE,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAG3D,OAAO,CAAC,cAAc,CACpB,aAAa,CAAC,UAAU,EACxB;YACE,GAAG,cAAc;YACjB,KAAK,EAAE,MAAM,IAAI,IAAI;SACtB,EACD,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,qBAAqB,CACnC,MAAmD;IAEnD,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAKD,MAAM,UAAU,YAAY,CAAC,MAA2C;IACtE,OAAO,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACxE,CAAC;AAKD,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAKD,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACvE,CAAC;AAKD,MAAM,UAAU,aAAa,CAAC,MAA2C;IACvE,OAAO,OAAO,CAAC,WAAW,CAAC,0BAA0B,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC1E,CAAC;AAKD,MAAM,UAAU,mBAAmB,CAAC,MAA2C;IAC7E,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAKD,MAAM,UAAU,aAAa,CAAC,MAA2C;IACvE,OAAO,OAAO,CAAC,WAAW,CAAC,yBAAyB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACzE,CAAC;AAKD,MAAM,UAAU,mBAAmB,CAAC,MAA2C;IAC7E,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAKD,MAAM,UAAU,QAAQ,CAAC,MAA2C;IAClE,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACpE,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,MAA2C;IACxE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAKD,MAAM,UAAU,mBAAmB,CAAC,MAA2C;IAC7E,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAmDD,MAAM,UAAU,MAAM,CAAC,MAAwB;IAE7C,OAAO,CAA6B,MAAiB,EAAa,EAAE;QAClE,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAEnF,OAAO,CAAC,cAAc,CACpB,aAAa,CAAC,UAAU,EACxB;YACE,GAAG,cAAc;YACjB,GAAG,EAAE,MAAM,IAAI,EAAE;SAClB,EACD,MAAM,CACP,CAAC;QAGF,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAGvE,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAE7D,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,KAAK,CAAC,MAAqB;IACzC,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAErF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC;YACxC,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;SAC/B,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE3E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,IAAI,CAAC,MAAqB;IACxC,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEpF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC;YACxC,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;SAC/B,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE1E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,MAAM,CAAC,MAAwB;IAC7C,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAExF,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC;YACzC,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,CAAC,QAAQ,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE9E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACzF,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE/E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAKD,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAKD,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAMlD,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,MAAmB;IAMjD,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC;AAKD,MAAM,UAAU,aAAa,CAAC,MAAmB;IAK/C,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC;AAKD,MAAM,UAAU,qBAAqB,CAAC,MAAmB;IACvD,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC;AAKD,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACtE,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { DatabaseManager } from './database.manager.js';
2
+ import type { DatabaseHealthCheckResult, ConnectionHealthStatus } from './database.types.js';
3
+ import { type ILogger } from '@omnitron-dev/titan/module/logger';
4
+ import { type HealthCheckResult } from '@kysera/infra';
5
+ export declare class DatabaseHealthIndicator {
6
+ private manager;
7
+ private logger;
8
+ constructor(manager: DatabaseManager, logger?: ILogger);
9
+ check(): Promise<DatabaseHealthCheckResult>;
10
+ checkConnection(name: string): Promise<ConnectionHealthStatus>;
11
+ private getPoolStatistics;
12
+ private getMetrics;
13
+ isHealthy(): Promise<boolean>;
14
+ testConnection(name?: string): Promise<boolean>;
15
+ kyseraHealthCheck(name?: string): Promise<HealthCheckResult>;
16
+ getCircuitBreakerState(name?: string): Promise<{
17
+ state: string;
18
+ failures: number;
19
+ isOpen: boolean;
20
+ } | undefined>;
21
+ }
22
+ //# sourceMappingURL=database.health.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database.health.d.ts","sourceRoot":"","sources":["../src/database.health.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,qBACa,uBAAuB;IAIN,OAAO,CAAC,OAAO;IAH3C,OAAO,CAAC,MAAM,CAAU;gBAGY,OAAO,EAAE,eAAe,EAC1D,MAAM,CAAC,EAAE,OAAO;IAKZ,KAAK,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAkB3C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA4BpE,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,UAAU;IA4BZ,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAK7B,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/C,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAK5D,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAChD;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GACpD,SAAS,CACZ;CAOF"}
@@ -0,0 +1,140 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
11
+ return function (target, key) { decorator(target, key, paramIndex); }
12
+ };
13
+ import { Injectable, Inject } from '@omnitron-dev/titan/decorators';
14
+ import { Pool } from 'pg';
15
+ import { sql } from 'kysely';
16
+ import { Errors } from '@omnitron-dev/titan/errors';
17
+ import { DatabaseManager } from './database.manager.js';
18
+ import { DATABASE_MANAGER, DEFAULT_TIMEOUTS, } from './database.constants.js';
19
+ import { createNullLogger } from '@omnitron-dev/titan/module/logger';
20
+ import { checkDatabaseHealth } from '@kysera/infra';
21
+ let DatabaseHealthIndicator = class DatabaseHealthIndicator {
22
+ constructor(manager, logger) {
23
+ this.manager = manager;
24
+ this.logger = logger ? logger.child({ module: 'DatabaseHealthIndicator' }) : createNullLogger();
25
+ }
26
+ async check() {
27
+ const connections = {};
28
+ const connectionNames = this.manager.getConnectionNames();
29
+ for (const name of connectionNames) {
30
+ connections[name] = await this.checkConnection(name);
31
+ }
32
+ const statuses = Object.values(connections).map((c) => c.status);
33
+ const hasError = statuses.some((s) => s === 'error' || s === 'disconnected');
34
+ const allHealthy = statuses.every((s) => s === 'connected');
35
+ const status = hasError ? 'unhealthy' : allHealthy ? 'healthy' : 'degraded';
36
+ const metrics = this.getMetrics();
37
+ return { status, connections, metrics };
38
+ }
39
+ async checkConnection(name) {
40
+ const startTime = Date.now();
41
+ try {
42
+ if (!this.manager.isConnected(name)) {
43
+ return { name, status: 'disconnected', error: 'Connection not established' };
44
+ }
45
+ const db = await this.manager.getConnection(name);
46
+ const timeout = DEFAULT_TIMEOUTS.health;
47
+ await Promise.race([
48
+ sql `SELECT 1`.execute(db),
49
+ new Promise((_, reject) => setTimeout(() => reject(Errors.timeout('database health check', timeout)), timeout)),
50
+ ]);
51
+ const latency = Date.now() - startTime;
52
+ const pool = this.manager.getPool(name);
53
+ const poolStats = this.getPoolStatistics(pool);
54
+ return { name, status: 'connected', latency, pool: poolStats };
55
+ }
56
+ catch (error) {
57
+ const latency = Date.now() - startTime;
58
+ this.logger.warn({ name, error, latency }, 'Database health check failed');
59
+ return { name, status: 'error', latency, error: error.message };
60
+ }
61
+ }
62
+ getPoolStatistics(pool) {
63
+ if (!pool)
64
+ return undefined;
65
+ try {
66
+ if (pool instanceof Pool) {
67
+ return {
68
+ total: pool.totalCount,
69
+ active: pool.totalCount - pool.idleCount,
70
+ idle: pool.idleCount,
71
+ waiting: pool.waitingCount,
72
+ };
73
+ }
74
+ if (pool && typeof pool._allConnections !== 'undefined') {
75
+ const allConnections = pool._allConnections;
76
+ return { total: allConnections?.length || 0, active: 0, idle: 0, waiting: 0 };
77
+ }
78
+ return undefined;
79
+ }
80
+ catch {
81
+ return undefined;
82
+ }
83
+ }
84
+ getMetrics() {
85
+ const allMetrics = this.manager.getMetrics();
86
+ const aggregated = {
87
+ queryCount: 0,
88
+ slowQueryCount: 0,
89
+ errorCount: 0,
90
+ averageQueryTime: 0,
91
+ connectionCount: this.manager.getConnectionNames().length,
92
+ transactionCount: 0,
93
+ rollbackCount: 0,
94
+ };
95
+ let totalQueryTime = 0;
96
+ for (const metrics of Object.values(allMetrics)) {
97
+ const m = metrics;
98
+ aggregated.queryCount += m['queryCount'] || 0;
99
+ aggregated.errorCount += m['errorCount'] || 0;
100
+ totalQueryTime += m['totalQueryTime'] || 0;
101
+ }
102
+ if (aggregated.queryCount > 0) {
103
+ aggregated.averageQueryTime = totalQueryTime / aggregated.queryCount;
104
+ }
105
+ return aggregated;
106
+ }
107
+ async isHealthy() {
108
+ const result = await this.check();
109
+ return result.status === 'healthy';
110
+ }
111
+ async testConnection(name) {
112
+ try {
113
+ const db = await this.manager.getConnection(name);
114
+ await sql `SELECT 1`.execute(db);
115
+ return true;
116
+ }
117
+ catch (error) {
118
+ this.logger.error({ name, error }, 'Connection test failed');
119
+ return false;
120
+ }
121
+ }
122
+ async kyseraHealthCheck(name) {
123
+ const db = await this.manager.getConnection(name);
124
+ return checkDatabaseHealth(db);
125
+ }
126
+ async getCircuitBreakerState(name) {
127
+ const breaker = this.manager.getCircuitBreaker(name);
128
+ if (!breaker)
129
+ return undefined;
130
+ const state = await breaker.getState();
131
+ return { state: state.state, failures: state.failures, isOpen: state.state === 'open' };
132
+ }
133
+ };
134
+ DatabaseHealthIndicator = __decorate([
135
+ Injectable(),
136
+ __param(0, Inject(DATABASE_MANAGER)),
137
+ __metadata("design:paramtypes", [DatabaseManager, Object])
138
+ ], DatabaseHealthIndicator);
139
+ export { DatabaseHealthIndicator };
140
+ //# sourceMappingURL=database.health.js.map