@argos-js/argosdb 0.0.0-stage → 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/README.md +186 -2
- package/dist/builder.d.ts +97 -0
- package/dist/builder.d.ts.map +1 -0
- package/dist/builder.js +449 -0
- package/dist/builder.js.map +1 -0
- package/dist/client.d.ts +76 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +123 -0
- package/dist/client.js.map +1 -0
- package/dist/errors.d.ts +22 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +42 -0
- package/dist/errors.js.map +1 -0
- package/dist/ids.d.ts +58 -0
- package/dist/ids.d.ts.map +1 -0
- package/dist/ids.js +107 -0
- package/dist/ids.js.map +1 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +78 -0
- package/dist/index.js.map +1 -0
- package/dist/schema.d.ts +173 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +371 -0
- package/dist/schema.js.map +1 -0
- package/dist/transport.d.ts +61 -0
- package/dist/transport.d.ts.map +1 -0
- package/dist/transport.js +465 -0
- package/dist/transport.js.map +1 -0
- package/dist/types.d.ts +81 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +6 -0
- package/dist/types.js.map +1 -0
- package/package.json +28 -3
package/dist/schema.js
ADDED
|
@@ -0,0 +1,371 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Lightweight, decorator-free Schema & Table Builders for ArgosDB.
|
|
4
|
+
*/
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.Table = exports.Column = void 0;
|
|
7
|
+
exports.string = string;
|
|
8
|
+
exports.varchar = varchar;
|
|
9
|
+
exports.text = text;
|
|
10
|
+
exports.integer = integer;
|
|
11
|
+
exports.int = int;
|
|
12
|
+
exports.bigint = bigint;
|
|
13
|
+
exports.float = float;
|
|
14
|
+
exports.double = double;
|
|
15
|
+
exports.boolean = boolean;
|
|
16
|
+
exports.timestamp = timestamp;
|
|
17
|
+
exports.datetime = datetime;
|
|
18
|
+
exports.uuidv7 = uuidv7;
|
|
19
|
+
exports.uuid = uuid;
|
|
20
|
+
exports.ulid = ulid;
|
|
21
|
+
exports.sqid = sqid;
|
|
22
|
+
exports.sequence = sequence;
|
|
23
|
+
exports.id = id;
|
|
24
|
+
exports.json = json;
|
|
25
|
+
exports.table = table;
|
|
26
|
+
const ids_js_1 = require("./ids.js");
|
|
27
|
+
/**
|
|
28
|
+
* Column definition holding schema metadata and condition builders.
|
|
29
|
+
*/
|
|
30
|
+
class Column {
|
|
31
|
+
config;
|
|
32
|
+
constructor(config) {
|
|
33
|
+
this.config = {
|
|
34
|
+
name: config.name || '',
|
|
35
|
+
dataType: config.dataType,
|
|
36
|
+
sqlType: config.sqlType,
|
|
37
|
+
isPrimaryKey: !!config.isPrimaryKey,
|
|
38
|
+
isNotNull: !!config.isNotNull || !!config.isPrimaryKey,
|
|
39
|
+
hasDefault: !!config.hasDefault,
|
|
40
|
+
defaultValue: config.defaultValue,
|
|
41
|
+
isUnique: !!config.isUnique,
|
|
42
|
+
length: config.length,
|
|
43
|
+
tableName: config.tableName,
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
get name() {
|
|
47
|
+
return this.config.name;
|
|
48
|
+
}
|
|
49
|
+
get tableName() {
|
|
50
|
+
return this.config.tableName;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Sets this column as Primary Key (automatically sets notNull).
|
|
54
|
+
*/
|
|
55
|
+
primaryKey() {
|
|
56
|
+
const col = new Column({
|
|
57
|
+
...this.config,
|
|
58
|
+
isPrimaryKey: true,
|
|
59
|
+
isNotNull: true,
|
|
60
|
+
});
|
|
61
|
+
return col;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Marks the column as NOT NULL.
|
|
65
|
+
*/
|
|
66
|
+
notNull() {
|
|
67
|
+
const col = new Column({
|
|
68
|
+
...this.config,
|
|
69
|
+
isNotNull: true,
|
|
70
|
+
});
|
|
71
|
+
return col;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Marks the column as nullable.
|
|
75
|
+
*/
|
|
76
|
+
nullable() {
|
|
77
|
+
const col = new Column({
|
|
78
|
+
...this.config,
|
|
79
|
+
isNotNull: false,
|
|
80
|
+
});
|
|
81
|
+
return col;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Defines a default value or expression (e.g., 'SQID()', UUIDV7(), 'active', 0).
|
|
85
|
+
*/
|
|
86
|
+
default(value) {
|
|
87
|
+
const col = new Column({
|
|
88
|
+
...this.config,
|
|
89
|
+
hasDefault: true,
|
|
90
|
+
defaultValue: value,
|
|
91
|
+
});
|
|
92
|
+
return col;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Convenience modifier for DEFAULT NOW().
|
|
96
|
+
*/
|
|
97
|
+
defaultNow() {
|
|
98
|
+
return this.default('NOW()');
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* Sets a unique constraint on this column.
|
|
102
|
+
*/
|
|
103
|
+
unique() {
|
|
104
|
+
this.config.isUnique = true;
|
|
105
|
+
return this;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Defines a foreign key reference to another column.
|
|
109
|
+
*/
|
|
110
|
+
references(target) {
|
|
111
|
+
this.config.references = target;
|
|
112
|
+
return this;
|
|
113
|
+
}
|
|
114
|
+
// --- Query Condition Helpers ---
|
|
115
|
+
eq(value) {
|
|
116
|
+
return { type: 'binary', column: this, op: '=', value };
|
|
117
|
+
}
|
|
118
|
+
ne(value) {
|
|
119
|
+
return { type: 'binary', column: this, op: '<>', value };
|
|
120
|
+
}
|
|
121
|
+
gt(value) {
|
|
122
|
+
return { type: 'binary', column: this, op: '>', value };
|
|
123
|
+
}
|
|
124
|
+
gte(value) {
|
|
125
|
+
return { type: 'binary', column: this, op: '>=', value };
|
|
126
|
+
}
|
|
127
|
+
lt(value) {
|
|
128
|
+
return { type: 'binary', column: this, op: '<', value };
|
|
129
|
+
}
|
|
130
|
+
lte(value) {
|
|
131
|
+
return { type: 'binary', column: this, op: '<=', value };
|
|
132
|
+
}
|
|
133
|
+
like(pattern) {
|
|
134
|
+
return { type: 'binary', column: this, op: 'LIKE', value: pattern };
|
|
135
|
+
}
|
|
136
|
+
ilike(pattern) {
|
|
137
|
+
return { type: 'binary', column: this, op: 'ILIKE', value: pattern };
|
|
138
|
+
}
|
|
139
|
+
in(values) {
|
|
140
|
+
return { type: 'in', column: this, values, negated: false };
|
|
141
|
+
}
|
|
142
|
+
notIn(values) {
|
|
143
|
+
return { type: 'in', column: this, values, negated: true };
|
|
144
|
+
}
|
|
145
|
+
isNull() {
|
|
146
|
+
return { type: 'null', column: this, negated: false };
|
|
147
|
+
}
|
|
148
|
+
isNotNull() {
|
|
149
|
+
return { type: 'null', column: this, negated: true };
|
|
150
|
+
}
|
|
151
|
+
asc() {
|
|
152
|
+
return { column: this, direction: 'ASC' };
|
|
153
|
+
}
|
|
154
|
+
desc() {
|
|
155
|
+
return { column: this, direction: 'DESC' };
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Generates SQL DDL fragment for column definition.
|
|
159
|
+
*/
|
|
160
|
+
toSQLDefinition() {
|
|
161
|
+
const parts = [this.config.name, this.config.sqlType];
|
|
162
|
+
if (this.config.isPrimaryKey) {
|
|
163
|
+
parts.push('PRIMARY KEY');
|
|
164
|
+
}
|
|
165
|
+
if (this.config.hasDefault && this.config.defaultValue !== undefined) {
|
|
166
|
+
const defVal = this.config.defaultValue;
|
|
167
|
+
if ((0, ids_js_1.isArgosRawExpression)(defVal) || (0, ids_js_1.isArgosNativeFunction)(defVal)) {
|
|
168
|
+
const expr = (0, ids_js_1.isArgosRawExpression)(defVal) ? defVal.expression : String(defVal);
|
|
169
|
+
parts.push(`DEFAULT ${expr}`);
|
|
170
|
+
}
|
|
171
|
+
else if (typeof defVal === 'string') {
|
|
172
|
+
parts.push(`DEFAULT '${defVal.replace(/'/g, "''")}'`);
|
|
173
|
+
}
|
|
174
|
+
else if (typeof defVal === 'boolean') {
|
|
175
|
+
parts.push(`DEFAULT ${defVal ? 'TRUE' : 'FALSE'}`);
|
|
176
|
+
}
|
|
177
|
+
else {
|
|
178
|
+
parts.push(`DEFAULT ${defVal}`);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
if (this.config.isNotNull && !this.config.isPrimaryKey) {
|
|
182
|
+
parts.push('NOT NULL');
|
|
183
|
+
}
|
|
184
|
+
if (this.config.isUnique && !this.config.isPrimaryKey) {
|
|
185
|
+
parts.push('UNIQUE');
|
|
186
|
+
}
|
|
187
|
+
if (this.config.references) {
|
|
188
|
+
try {
|
|
189
|
+
const ref = typeof this.config.references === 'function' ? this.config.references() : this.config.references;
|
|
190
|
+
if (ref && ref.tableName && ref.name) {
|
|
191
|
+
parts.push(`REFERENCES ${ref.tableName}(${ref.name})`);
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
catch {
|
|
195
|
+
// deferred resolution if target not resolved yet
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
return parts.join(' ');
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
exports.Column = Column;
|
|
202
|
+
// --- Column Builders ---
|
|
203
|
+
function string(name) {
|
|
204
|
+
return new Column({
|
|
205
|
+
name,
|
|
206
|
+
dataType: 'string',
|
|
207
|
+
sqlType: 'VARCHAR',
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
function varchar(name, length = 255) {
|
|
211
|
+
return new Column({
|
|
212
|
+
name,
|
|
213
|
+
dataType: 'varchar',
|
|
214
|
+
sqlType: `VARCHAR(${length})`,
|
|
215
|
+
length,
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
function text(name) {
|
|
219
|
+
return new Column({
|
|
220
|
+
name,
|
|
221
|
+
dataType: 'text',
|
|
222
|
+
sqlType: 'TEXT',
|
|
223
|
+
});
|
|
224
|
+
}
|
|
225
|
+
function integer(name) {
|
|
226
|
+
return new Column({
|
|
227
|
+
name,
|
|
228
|
+
dataType: 'integer',
|
|
229
|
+
sqlType: 'INTEGER',
|
|
230
|
+
});
|
|
231
|
+
}
|
|
232
|
+
function int(name) {
|
|
233
|
+
return integer(name);
|
|
234
|
+
}
|
|
235
|
+
function bigint(name) {
|
|
236
|
+
return new Column({
|
|
237
|
+
name,
|
|
238
|
+
dataType: 'bigint',
|
|
239
|
+
sqlType: 'BIGINT',
|
|
240
|
+
});
|
|
241
|
+
}
|
|
242
|
+
function float(name) {
|
|
243
|
+
return new Column({
|
|
244
|
+
name,
|
|
245
|
+
dataType: 'float',
|
|
246
|
+
sqlType: 'FLOAT',
|
|
247
|
+
});
|
|
248
|
+
}
|
|
249
|
+
function double(name) {
|
|
250
|
+
return new Column({
|
|
251
|
+
name,
|
|
252
|
+
dataType: 'double',
|
|
253
|
+
sqlType: 'DOUBLE',
|
|
254
|
+
});
|
|
255
|
+
}
|
|
256
|
+
function boolean(name) {
|
|
257
|
+
return new Column({
|
|
258
|
+
name,
|
|
259
|
+
dataType: 'boolean',
|
|
260
|
+
sqlType: 'BOOLEAN',
|
|
261
|
+
});
|
|
262
|
+
}
|
|
263
|
+
function timestamp(name) {
|
|
264
|
+
return new Column({
|
|
265
|
+
name,
|
|
266
|
+
dataType: 'timestamp',
|
|
267
|
+
sqlType: 'TIMESTAMP',
|
|
268
|
+
});
|
|
269
|
+
}
|
|
270
|
+
function datetime(name) {
|
|
271
|
+
return timestamp(name);
|
|
272
|
+
}
|
|
273
|
+
function uuidv7(name) {
|
|
274
|
+
return new Column({
|
|
275
|
+
name,
|
|
276
|
+
dataType: 'uuidv7',
|
|
277
|
+
sqlType: 'UUIDV7',
|
|
278
|
+
isPrimaryKey: true,
|
|
279
|
+
isNotNull: true,
|
|
280
|
+
hasDefault: true,
|
|
281
|
+
defaultValue: 'UUIDV7()',
|
|
282
|
+
});
|
|
283
|
+
}
|
|
284
|
+
function uuid(name) {
|
|
285
|
+
return uuidv7(name);
|
|
286
|
+
}
|
|
287
|
+
function ulid(name) {
|
|
288
|
+
return new Column({
|
|
289
|
+
name,
|
|
290
|
+
dataType: 'ulid',
|
|
291
|
+
sqlType: 'ULID',
|
|
292
|
+
isPrimaryKey: true,
|
|
293
|
+
isNotNull: true,
|
|
294
|
+
hasDefault: true,
|
|
295
|
+
defaultValue: 'ULID()',
|
|
296
|
+
});
|
|
297
|
+
}
|
|
298
|
+
function sqid(name, length = 12) {
|
|
299
|
+
return new Column({
|
|
300
|
+
name,
|
|
301
|
+
dataType: 'sqid',
|
|
302
|
+
sqlType: `VARCHAR(${length})`,
|
|
303
|
+
length,
|
|
304
|
+
isPrimaryKey: true,
|
|
305
|
+
isNotNull: true,
|
|
306
|
+
hasDefault: true,
|
|
307
|
+
defaultValue: 'SQID()',
|
|
308
|
+
});
|
|
309
|
+
}
|
|
310
|
+
function sequence(name) {
|
|
311
|
+
return new Column({
|
|
312
|
+
name,
|
|
313
|
+
dataType: 'integer',
|
|
314
|
+
sqlType: 'INTEGER',
|
|
315
|
+
isPrimaryKey: true,
|
|
316
|
+
isNotNull: true,
|
|
317
|
+
hasDefault: true,
|
|
318
|
+
defaultValue: 'SEQUENCE()',
|
|
319
|
+
});
|
|
320
|
+
}
|
|
321
|
+
function id(strategy = 'sqid', name) {
|
|
322
|
+
switch (strategy) {
|
|
323
|
+
case 'uuid':
|
|
324
|
+
case 'uuidv7':
|
|
325
|
+
return uuidv7(name);
|
|
326
|
+
case 'ulid':
|
|
327
|
+
return ulid(name);
|
|
328
|
+
case 'sequence':
|
|
329
|
+
return sequence(name);
|
|
330
|
+
case 'sqid':
|
|
331
|
+
default:
|
|
332
|
+
return sqid(name);
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
function json(name) {
|
|
336
|
+
return new Column({
|
|
337
|
+
name,
|
|
338
|
+
dataType: 'json',
|
|
339
|
+
sqlType: 'JSON',
|
|
340
|
+
});
|
|
341
|
+
}
|
|
342
|
+
class Table {
|
|
343
|
+
_name;
|
|
344
|
+
_columns;
|
|
345
|
+
constructor(name, columns) {
|
|
346
|
+
this._name = name;
|
|
347
|
+
this._columns = columns;
|
|
348
|
+
for (const [key, col] of Object.entries(columns)) {
|
|
349
|
+
if (!col.config.name) {
|
|
350
|
+
col.config.name = key;
|
|
351
|
+
}
|
|
352
|
+
col.config.tableName = name;
|
|
353
|
+
this[key] = col;
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
/**
|
|
357
|
+
* Generates native ArgosDB CREATE TABLE DDL.
|
|
358
|
+
*/
|
|
359
|
+
toDDL() {
|
|
360
|
+
const colDefs = Object.values(this._columns).map((c) => c.toSQLDefinition());
|
|
361
|
+
return `CREATE TABLE IF NOT EXISTS ${this._name} (\n ${colDefs.join(',\n ')}\n);`;
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
exports.Table = Table;
|
|
365
|
+
/**
|
|
366
|
+
* Declares an ArgosDB table schema.
|
|
367
|
+
*/
|
|
368
|
+
function table(name, columns) {
|
|
369
|
+
return new Table(name, columns);
|
|
370
|
+
}
|
|
371
|
+
//# sourceMappingURL=schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Network Transports (HTTP & TCP) with Connection Pooling for ArgosDB.
|
|
3
|
+
*/
|
|
4
|
+
import type { ArgosDBConfig, HealthResponse, QueryResult, ServerMetrics } from './types.js';
|
|
5
|
+
export interface Transport {
|
|
6
|
+
query<T = any>(sql: string): Promise<QueryResult<T>>;
|
|
7
|
+
health(): Promise<HealthResponse>;
|
|
8
|
+
metrics(): Promise<ServerMetrics>;
|
|
9
|
+
close(): Promise<void>;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Concurrency semaphore for connection pooling.
|
|
13
|
+
*/
|
|
14
|
+
export declare class ConcurrencyLimiter {
|
|
15
|
+
private readonly maxConcurrent;
|
|
16
|
+
private inFlight;
|
|
17
|
+
private readonly queue;
|
|
18
|
+
constructor(maxConcurrent: number);
|
|
19
|
+
acquire(): Promise<void>;
|
|
20
|
+
release(): void;
|
|
21
|
+
get activeCount(): number;
|
|
22
|
+
get waitingCount(): number;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* HTTP Transport for ArgosDB REST / Stateless SQL API.
|
|
26
|
+
*/
|
|
27
|
+
export declare class HttpTransport implements Transport {
|
|
28
|
+
private readonly config;
|
|
29
|
+
private readonly baseUrl;
|
|
30
|
+
private readonly limiter;
|
|
31
|
+
private readonly fetchFn;
|
|
32
|
+
constructor(config: ArgosDBConfig);
|
|
33
|
+
private buildHeaders;
|
|
34
|
+
query<T = any>(sql: string): Promise<QueryResult<T>>;
|
|
35
|
+
health(): Promise<HealthResponse>;
|
|
36
|
+
metrics(): Promise<ServerMetrics>;
|
|
37
|
+
close(): Promise<void>;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* TCP Transport with Connection Pooling for ArgosDB.
|
|
41
|
+
*/
|
|
42
|
+
export declare class TcpTransport implements Transport {
|
|
43
|
+
private readonly config;
|
|
44
|
+
private readonly host;
|
|
45
|
+
private readonly port;
|
|
46
|
+
private readonly pool;
|
|
47
|
+
private readonly limiter;
|
|
48
|
+
private isClosed;
|
|
49
|
+
constructor(config: ArgosDBConfig);
|
|
50
|
+
private acquireConnection;
|
|
51
|
+
private releaseConnection;
|
|
52
|
+
query<T = any>(sql: string): Promise<QueryResult<T>>;
|
|
53
|
+
health(): Promise<HealthResponse>;
|
|
54
|
+
metrics(): Promise<ServerMetrics>;
|
|
55
|
+
close(): Promise<void>;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Transport Factory creating HTTP or TCP transport based on endpoint URI scheme.
|
|
59
|
+
*/
|
|
60
|
+
export declare function createTransport(config: ArgosDBConfig): Transport;
|
|
61
|
+
//# sourceMappingURL=transport.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAEf,aAAa,EAAE,MAAM;IAE5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,OAAO,IAAI,IAAI;IAQf,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,SAAS;IAKjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAErB,MAAM,EAAE,aAAa;IAMlD,OAAO,CAAC,YAAY;IAuBd,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAkGpD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAsBjC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAejC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AA6GD;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAOhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAS;gBAEI,MAAM,EAAE,aAAa;YAQpC,iBAAiB;IAmB/B,OAAO,CAAC,iBAAiB;IAKnB,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAgDpD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAUjC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAUjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAKhE"}
|