@zhin.js/database 1.0.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.
Files changed (109) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +93 -0
  3. package/lib/base/database.d.ts +71 -0
  4. package/lib/base/database.d.ts.map +1 -0
  5. package/lib/base/database.js +101 -0
  6. package/lib/base/database.js.map +1 -0
  7. package/lib/base/dialect.d.ts +34 -0
  8. package/lib/base/dialect.d.ts.map +1 -0
  9. package/lib/base/dialect.js +21 -0
  10. package/lib/base/dialect.js.map +1 -0
  11. package/lib/base/index.d.ts +6 -0
  12. package/lib/base/index.d.ts.map +1 -0
  13. package/lib/base/index.js +6 -0
  14. package/lib/base/index.js.map +1 -0
  15. package/lib/base/model.d.ts +53 -0
  16. package/lib/base/model.d.ts.map +1 -0
  17. package/lib/base/model.js +65 -0
  18. package/lib/base/model.js.map +1 -0
  19. package/lib/base/query-classes.d.ts +68 -0
  20. package/lib/base/query-classes.d.ts.map +1 -0
  21. package/lib/base/query-classes.js +178 -0
  22. package/lib/base/query-classes.js.map +1 -0
  23. package/lib/base/thenable.d.ts +15 -0
  24. package/lib/base/thenable.d.ts.map +1 -0
  25. package/lib/base/thenable.js +33 -0
  26. package/lib/base/thenable.js.map +1 -0
  27. package/lib/dialects/memory.d.ts +52 -0
  28. package/lib/dialects/memory.d.ts.map +1 -0
  29. package/lib/dialects/memory.js +772 -0
  30. package/lib/dialects/memory.js.map +1 -0
  31. package/lib/dialects/mongodb.d.ts +85 -0
  32. package/lib/dialects/mongodb.d.ts.map +1 -0
  33. package/lib/dialects/mongodb.js +461 -0
  34. package/lib/dialects/mongodb.js.map +1 -0
  35. package/lib/dialects/mysql.d.ts +33 -0
  36. package/lib/dialects/mysql.d.ts.map +1 -0
  37. package/lib/dialects/mysql.js +132 -0
  38. package/lib/dialects/mysql.js.map +1 -0
  39. package/lib/dialects/pg.d.ts +33 -0
  40. package/lib/dialects/pg.d.ts.map +1 -0
  41. package/lib/dialects/pg.js +132 -0
  42. package/lib/dialects/pg.js.map +1 -0
  43. package/lib/dialects/redis.d.ts +87 -0
  44. package/lib/dialects/redis.d.ts.map +1 -0
  45. package/lib/dialects/redis.js +500 -0
  46. package/lib/dialects/redis.js.map +1 -0
  47. package/lib/dialects/sqlite.d.ts +46 -0
  48. package/lib/dialects/sqlite.d.ts.map +1 -0
  49. package/lib/dialects/sqlite.js +201 -0
  50. package/lib/dialects/sqlite.js.map +1 -0
  51. package/lib/index.d.ts +18 -0
  52. package/lib/index.d.ts.map +1 -0
  53. package/lib/index.js +18 -0
  54. package/lib/index.js.map +1 -0
  55. package/lib/registry.d.ts +37 -0
  56. package/lib/registry.d.ts.map +1 -0
  57. package/lib/registry.js +21 -0
  58. package/lib/registry.js.map +1 -0
  59. package/lib/type/document/database.d.ts +60 -0
  60. package/lib/type/document/database.d.ts.map +1 -0
  61. package/lib/type/document/database.js +242 -0
  62. package/lib/type/document/database.js.map +1 -0
  63. package/lib/type/document/model.d.ts +42 -0
  64. package/lib/type/document/model.d.ts.map +1 -0
  65. package/lib/type/document/model.js +65 -0
  66. package/lib/type/document/model.js.map +1 -0
  67. package/lib/type/keyvalue/database.d.ts +64 -0
  68. package/lib/type/keyvalue/database.d.ts.map +1 -0
  69. package/lib/type/keyvalue/database.js +214 -0
  70. package/lib/type/keyvalue/database.js.map +1 -0
  71. package/lib/type/keyvalue/model.d.ts +107 -0
  72. package/lib/type/keyvalue/model.d.ts.map +1 -0
  73. package/lib/type/keyvalue/model.js +261 -0
  74. package/lib/type/keyvalue/model.js.map +1 -0
  75. package/lib/type/related/database.d.ts +32 -0
  76. package/lib/type/related/database.d.ts.map +1 -0
  77. package/lib/type/related/database.js +334 -0
  78. package/lib/type/related/database.js.map +1 -0
  79. package/lib/type/related/model.d.ts +43 -0
  80. package/lib/type/related/model.d.ts.map +1 -0
  81. package/lib/type/related/model.js +108 -0
  82. package/lib/type/related/model.js.map +1 -0
  83. package/lib/types.d.ts +251 -0
  84. package/lib/types.d.ts.map +1 -0
  85. package/lib/types.js +28 -0
  86. package/lib/types.js.map +1 -0
  87. package/package.json +54 -0
  88. package/src/base/database.ts +128 -0
  89. package/src/base/dialect.ts +76 -0
  90. package/src/base/index.ts +5 -0
  91. package/src/base/model.ts +89 -0
  92. package/src/base/query-classes.ts +217 -0
  93. package/src/base/thenable.ts +54 -0
  94. package/src/dialects/memory.ts +880 -0
  95. package/src/dialects/mongodb.ts +533 -0
  96. package/src/dialects/mysql.ts +157 -0
  97. package/src/dialects/pg.ts +157 -0
  98. package/src/dialects/redis.ts +598 -0
  99. package/src/dialects/sqlite.ts +233 -0
  100. package/src/index.ts +20 -0
  101. package/src/registry.ts +59 -0
  102. package/src/type/document/database.ts +283 -0
  103. package/src/type/document/model.ts +86 -0
  104. package/src/type/keyvalue/database.ts +261 -0
  105. package/src/type/keyvalue/model.ts +339 -0
  106. package/src/type/related/database.ts +392 -0
  107. package/src/type/related/model.ts +117 -0
  108. package/src/types.ts +403 -0
  109. package/tsconfig.json +24 -0
@@ -0,0 +1,157 @@
1
+ import {Dialect} from '../base';
2
+ import {RelatedDatabase} from "../type/related/database";
3
+ import {Database} from "../base";
4
+ import {Registry} from "../registry";
5
+ import type { ClientConfig } from 'pg';
6
+ import {Column} from "../types";
7
+
8
+ export interface PostgreSQLDialectConfig extends ClientConfig {}
9
+
10
+ export class PostgreSQLDialect extends Dialect<PostgreSQLDialectConfig, string> {
11
+ private connection: any = null;
12
+
13
+ constructor(config: PostgreSQLDialectConfig) {
14
+ super('pg', config);
15
+ }
16
+
17
+ // Connection management
18
+ isConnected(): boolean {
19
+ return this.connection !== null;
20
+ }
21
+
22
+ async connect(): Promise<void> {
23
+ try {
24
+ const { Client } = await import('pg');
25
+ this.connection = new Client(this.config);
26
+ await this.connection.connect();
27
+ } catch (error) {
28
+ console.error('forgot install pg ?');
29
+ throw new Error(`PostgreSQL 连接失败: ${error}`);
30
+ }
31
+ }
32
+
33
+ async disconnect(): Promise<void> {
34
+ this.connection = null;
35
+ }
36
+
37
+ async healthCheck(): Promise<boolean> {
38
+ return this.isConnected();
39
+ }
40
+
41
+ async query<U = any>(sql: string, params?: any[]): Promise<U> {
42
+ const result = await this.connection.query(sql, params);
43
+ return result.rows as U;
44
+ }
45
+
46
+ async dispose(): Promise<void> {
47
+ if (this.connection) {
48
+ await this.connection.end();
49
+ this.connection = null;
50
+ }
51
+ }
52
+
53
+ // SQL generation methods
54
+ mapColumnType(type: string): string {
55
+ const typeMap: Record<string, string> = {
56
+ 'text': 'TEXT',
57
+ 'integer': 'INTEGER',
58
+ 'float': 'REAL',
59
+ 'boolean': 'BOOLEAN',
60
+ 'date': 'TIMESTAMP',
61
+ 'json': 'JSONB'
62
+ };
63
+ return typeMap[type.toLowerCase()] || 'TEXT';
64
+ }
65
+
66
+ quoteIdentifier(identifier: string): string {
67
+ return `"${identifier}"`;
68
+ }
69
+
70
+ getParameterPlaceholder(index: number): string {
71
+ return `$${index + 1}`;
72
+ }
73
+
74
+ getStatementTerminator(): string {
75
+ return ';';
76
+ }
77
+
78
+ formatBoolean(value: boolean): string {
79
+ return value ? 'TRUE' : 'FALSE';
80
+ }
81
+
82
+ formatDate(value: Date): string {
83
+ return `'${value.toISOString()}'::TIMESTAMP`;
84
+ }
85
+
86
+ formatJson(value: any): string {
87
+ return `'${JSON.stringify(value).replace(/'/g, "''")}'::JSONB`;
88
+ }
89
+
90
+ escapeString(value: string): string {
91
+ return value.replace(/'/g, "''");
92
+ }
93
+
94
+ formatDefaultValue(value: any): string {
95
+ if (typeof value === 'string') {
96
+ return `'${this.escapeString(value)}'`;
97
+ } else if (typeof value === 'number' || typeof value === 'boolean') {
98
+ return value.toString();
99
+ } else if (value instanceof Date) {
100
+ return this.formatDate(value);
101
+ } else if (value === null) {
102
+ return 'NULL';
103
+ } else if (typeof value === 'object') {
104
+ return this.formatJson(value);
105
+ } else {
106
+ throw new Error(`Unsupported default value type: ${typeof value}`);
107
+ }
108
+ }
109
+
110
+ formatLimit(limit: number): string {
111
+ return `LIMIT ${limit}`;
112
+ }
113
+
114
+ formatOffset(offset: number): string {
115
+ return `OFFSET ${offset}`;
116
+ }
117
+
118
+ formatLimitOffset(limit: number, offset: number): string {
119
+ return `LIMIT ${limit} OFFSET ${offset}`;
120
+ }
121
+
122
+ formatCreateTable(tableName: string, columns: string[]): string {
123
+ return `CREATE TABLE IF NOT EXISTS ${this.quoteIdentifier(tableName)} (${columns.join(', ')})`;
124
+ }
125
+
126
+ formatColumnDefinition(field: string, column: Column<any>): string {
127
+ const name = this.quoteIdentifier(String(field));
128
+ const type = this.mapColumnType(column.type);
129
+ const length = column.length ? `(${column.length})` : '';
130
+ const nullable = column.nullable === false ? ' NOT NULL' : '';
131
+ const primary = column.primary ? ' PRIMARY KEY' : '';
132
+ const unique = column.unique ? ' UNIQUE' : '';
133
+ const defaultVal = column.default !== undefined
134
+ ? ` DEFAULT ${this.formatDefaultValue(column.default)}`
135
+ : '';
136
+
137
+ return `${name} ${type}${length}${primary}${unique}${nullable}${defaultVal}`;
138
+ }
139
+
140
+ formatAlterTable(tableName: string, alterations: string[]): string {
141
+ return `ALTER TABLE ${this.quoteIdentifier(tableName)} ${alterations.join(', ')}`;
142
+ }
143
+
144
+ formatDropTable(tableName: string, ifExists?: boolean): string {
145
+ const ifExistsClause = ifExists ? 'IF EXISTS ' : '';
146
+ return `DROP TABLE ${ifExistsClause}${this.quoteIdentifier(tableName)}`;
147
+ }
148
+
149
+ formatDropIndex(indexName: string, tableName: string, ifExists?: boolean): string {
150
+ const ifExistsClause = ifExists ? 'IF EXISTS ' : '';
151
+ return `DROP INDEX ${ifExistsClause}${this.quoteIdentifier(indexName)}`;
152
+ }
153
+ }
154
+
155
+ Registry.register('pg', (config: PostgreSQLDialectConfig, schemas?: Database.Schemas<Record<string, object>>) => {
156
+ return new RelatedDatabase(new PostgreSQLDialect(config), schemas);
157
+ });