@g9tm/lynxcontrols-sqlite 1.4.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 +12 -0
- package/contract/cases.json +463 -0
- package/dist/.tsbuildinfo +1 -0
- package/dist/codecs/codecs.d.ts +68 -0
- package/dist/codecs/codecs.d.ts.map +1 -0
- package/dist/codecs/codecs.js +201 -0
- package/dist/codecs/codecs.js.map +1 -0
- package/dist/contract/run-contract.d.ts +94 -0
- package/dist/contract/run-contract.d.ts.map +1 -0
- package/dist/contract/run-contract.js +159 -0
- package/dist/contract/run-contract.js.map +1 -0
- package/dist/driver/types.d.ts +87 -0
- package/dist/driver/types.d.ts.map +1 -0
- package/dist/driver/types.js +14 -0
- package/dist/driver/types.js.map +1 -0
- package/dist/errors.d.ts +39 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +57 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +22 -0
- package/dist/query/builders.d.ts +216 -0
- package/dist/query/builders.d.ts.map +1 -0
- package/dist/query/builders.js +490 -0
- package/dist/query/builders.js.map +1 -0
- package/dist/query/compile.d.ts +42 -0
- package/dist/query/compile.d.ts.map +1 -0
- package/dist/query/compile.js +307 -0
- package/dist/query/compile.js.map +1 -0
- package/dist/query/expr.d.ts +201 -0
- package/dist/query/expr.d.ts.map +1 -0
- package/dist/query/expr.js +247 -0
- package/dist/query/expr.js.map +1 -0
- package/dist/repo/audit.d.ts +19 -0
- package/dist/repo/audit.d.ts.map +1 -0
- package/dist/repo/audit.js +36 -0
- package/dist/repo/audit.js.map +1 -0
- package/dist/repo/repository.d.ts +233 -0
- package/dist/repo/repository.d.ts.map +1 -0
- package/dist/repo/repository.js +715 -0
- package/dist/repo/repository.js.map +1 -0
- package/dist/schema/columns.d.ts +115 -0
- package/dist/schema/columns.d.ts.map +1 -0
- package/dist/schema/columns.js +112 -0
- package/dist/schema/columns.js.map +1 -0
- package/dist/schema/entity.d.ts +135 -0
- package/dist/schema/entity.d.ts.map +1 -0
- package/dist/schema/entity.js +227 -0
- package/dist/schema/entity.js.map +1 -0
- package/dist/schema/policies.d.ts +89 -0
- package/dist/schema/policies.d.ts.map +1 -0
- package/dist/schema/policies.js +54 -0
- package/dist/schema/policies.js.map +1 -0
- package/dist/session/ambient.d.ts +32 -0
- package/dist/session/ambient.d.ts.map +1 -0
- package/dist/session/ambient.js +28 -0
- package/dist/session/ambient.js.map +1 -0
- package/dist/session/cache.d.ts +62 -0
- package/dist/session/cache.d.ts.map +1 -0
- package/dist/session/cache.js +239 -0
- package/dist/session/cache.js.map +1 -0
- package/dist/session/database.d.ts +221 -0
- package/dist/session/database.d.ts.map +1 -0
- package/dist/session/database.js +430 -0
- package/dist/session/database.js.map +1 -0
- package/dist/session/locator.d.ts +33 -0
- package/dist/session/locator.d.ts.map +1 -0
- package/dist/session/locator.js +39 -0
- package/dist/session/locator.js.map +1 -0
- package/dist/session/migrations.d.ts +75 -0
- package/dist/session/migrations.d.ts.map +1 -0
- package/dist/session/migrations.js +88 -0
- package/dist/session/migrations.js.map +1 -0
- package/dist/session/mutex.d.ts +7 -0
- package/dist/session/mutex.d.ts.map +1 -0
- package/dist/session/mutex.js +27 -0
- package/dist/session/mutex.js.map +1 -0
- package/dist/session/rows.d.ts +17 -0
- package/dist/session/rows.d.ts.map +1 -0
- package/dist/session/rows.js +52 -0
- package/dist/session/rows.js.map +1 -0
- package/dist/session/schema-setup.d.ts +21 -0
- package/dist/session/schema-setup.d.ts.map +1 -0
- package/dist/session/schema-setup.js +227 -0
- package/dist/session/schema-setup.js.map +1 -0
- package/dist/session/scope.d.ts +117 -0
- package/dist/session/scope.d.ts.map +1 -0
- package/dist/session/scope.js +233 -0
- package/dist/session/scope.js.map +1 -0
- package/dist/session/write-hooks.d.ts +84 -0
- package/dist/session/write-hooks.d.ts.map +1 -0
- package/dist/session/write-hooks.js +55 -0
- package/dist/session/write-hooks.js.map +1 -0
- package/dist/values/ids.d.ts +46 -0
- package/dist/values/ids.d.ts.map +1 -0
- package/dist/values/ids.js +84 -0
- package/dist/values/ids.js.map +1 -0
- package/dist/values/int64.d.ts +33 -0
- package/dist/values/int64.d.ts.map +1 -0
- package/dist/values/int64.js +105 -0
- package/dist/values/int64.js.map +1 -0
- package/dist/values/local-date-time.d.ts +61 -0
- package/dist/values/local-date-time.d.ts.map +1 -0
- package/dist/values/local-date-time.js +122 -0
- package/dist/values/local-date-time.js.map +1 -0
- package/dist/values/sql-value.d.ts +36 -0
- package/dist/values/sql-value.d.ts.map +1 -0
- package/dist/values/sql-value.js +70 -0
- package/dist/values/sql-value.js.map +1 -0
- package/package.json +27 -0
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
import { G9SqliteError } from "../errors.js";
|
|
2
|
+
import { normalizeRequiredId } from "../values/ids.js";
|
|
3
|
+
import { formatLegacyDateTime, parseLegacyDateTime } from "../values/local-date-time.js";
|
|
4
|
+
import { describeSqlValue, int64FromSqlValue, int64ToSqlValue, isInt64Tag, toArrayBuffer } from "../values/sql-value.js";
|
|
5
|
+
const g9DefaultCodecContext = Object.freeze({
|
|
6
|
+
idCase: 'lower',
|
|
7
|
+
dateTimeProfile: 'provider'
|
|
8
|
+
});
|
|
9
|
+
function reject(kind, problem) {
|
|
10
|
+
throw new G9SqliteError('misuse', `${kind} codec: ${problem}`);
|
|
11
|
+
}
|
|
12
|
+
const textCodec = Object.freeze({
|
|
13
|
+
kind: 'text',
|
|
14
|
+
sqlType: 'TEXT',
|
|
15
|
+
encode (value) {
|
|
16
|
+
if ('string' != typeof value) reject('text', `expected a string, got ${typeof value}.`);
|
|
17
|
+
return value;
|
|
18
|
+
},
|
|
19
|
+
decode (value) {
|
|
20
|
+
if ('string' == typeof value) return value;
|
|
21
|
+
if ('number' == typeof value) return String(value);
|
|
22
|
+
if (isInt64Tag(value)) return value.int64;
|
|
23
|
+
return reject('text', `cannot read ${describeSqlValue(value)} as text.`);
|
|
24
|
+
}
|
|
25
|
+
});
|
|
26
|
+
const intCodec = Object.freeze({
|
|
27
|
+
kind: 'int',
|
|
28
|
+
sqlType: 'INTEGER',
|
|
29
|
+
encode (value) {
|
|
30
|
+
if (!Number.isSafeInteger(value)) reject('int', `${String(value)} is not a safe integer; use int64().`);
|
|
31
|
+
return value;
|
|
32
|
+
},
|
|
33
|
+
decode (value) {
|
|
34
|
+
if ('number' == typeof value && Number.isSafeInteger(value)) return value;
|
|
35
|
+
if (isInt64Tag(value)) return reject('int', `stored value ${value.int64} exceeds ±(2^53 − 1); use int64().`);
|
|
36
|
+
return reject('int', `cannot read ${describeSqlValue(value)} as an integer.`);
|
|
37
|
+
}
|
|
38
|
+
});
|
|
39
|
+
const int64Codec = Object.freeze({
|
|
40
|
+
kind: 'int64',
|
|
41
|
+
sqlType: 'INTEGER',
|
|
42
|
+
encode (value) {
|
|
43
|
+
return int64ToSqlValue(value);
|
|
44
|
+
},
|
|
45
|
+
decode (value) {
|
|
46
|
+
return int64FromSqlValue(value);
|
|
47
|
+
}
|
|
48
|
+
});
|
|
49
|
+
const realCodec = Object.freeze({
|
|
50
|
+
kind: 'real',
|
|
51
|
+
sqlType: 'REAL',
|
|
52
|
+
encode (value) {
|
|
53
|
+
if ('number' != typeof value || Number.isNaN(value)) reject('real', 'expected a number (NaN is not storable).');
|
|
54
|
+
return value;
|
|
55
|
+
},
|
|
56
|
+
decode (value) {
|
|
57
|
+
if ('number' == typeof value) return value;
|
|
58
|
+
return reject('real', `cannot read ${describeSqlValue(value)} as a number.`);
|
|
59
|
+
}
|
|
60
|
+
});
|
|
61
|
+
const DECIMAL = /^-?\d+(?:\.\d+)?$/;
|
|
62
|
+
const decimalTextCodec = Object.freeze({
|
|
63
|
+
kind: 'decimalText',
|
|
64
|
+
sqlType: 'TEXT',
|
|
65
|
+
encode (value) {
|
|
66
|
+
if ('string' != typeof value || !DECIMAL.test(value)) reject('decimalText', `'${String(value)}' is not a plain decimal (digits, optional sign and fraction).`);
|
|
67
|
+
return value;
|
|
68
|
+
},
|
|
69
|
+
decode (value) {
|
|
70
|
+
if ('string' == typeof value && DECIMAL.test(value)) return value;
|
|
71
|
+
if ('number' == typeof value && Number.isFinite(value)) return String(value);
|
|
72
|
+
if (isInt64Tag(value)) return value.int64;
|
|
73
|
+
return reject('decimalText', `cannot read ${describeSqlValue(value)} as a decimal.`);
|
|
74
|
+
}
|
|
75
|
+
});
|
|
76
|
+
const boolCodec = Object.freeze({
|
|
77
|
+
kind: 'bool',
|
|
78
|
+
sqlType: 'INTEGER',
|
|
79
|
+
encode (value) {
|
|
80
|
+
if ('boolean' != typeof value) reject('bool', `expected a boolean, got ${typeof value}.`);
|
|
81
|
+
return value ? 1 : 0;
|
|
82
|
+
},
|
|
83
|
+
decode (value) {
|
|
84
|
+
if (0 === value || 1 === value) return 1 === value;
|
|
85
|
+
return reject('bool', `stored value ${describeSqlValue(value)} ${'number' == typeof value ? value : ''} is not 0 or 1.`);
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
const guidCodec = Object.freeze({
|
|
89
|
+
kind: 'guid',
|
|
90
|
+
sqlType: 'TEXT',
|
|
91
|
+
encode (value, context) {
|
|
92
|
+
if ('string' != typeof value) reject('guid', `expected a string, got ${typeof value}.`);
|
|
93
|
+
return normalizeRequiredId(value, context.idCase);
|
|
94
|
+
},
|
|
95
|
+
decode (value) {
|
|
96
|
+
if ('string' == typeof value) return value;
|
|
97
|
+
return reject('guid', `cannot read ${describeSqlValue(value)} as an id.`);
|
|
98
|
+
}
|
|
99
|
+
});
|
|
100
|
+
const blobCodec = Object.freeze({
|
|
101
|
+
kind: 'blob',
|
|
102
|
+
sqlType: 'BLOB',
|
|
103
|
+
encode (value) {
|
|
104
|
+
if (value instanceof ArrayBuffer) return value;
|
|
105
|
+
if (ArrayBuffer.isView(value)) return toArrayBuffer(value);
|
|
106
|
+
return reject('blob', 'expected an ArrayBuffer or typed array.');
|
|
107
|
+
},
|
|
108
|
+
decode (value) {
|
|
109
|
+
if (value instanceof ArrayBuffer) return value;
|
|
110
|
+
return reject('blob', `cannot read ${describeSqlValue(value)} as bytes.`);
|
|
111
|
+
}
|
|
112
|
+
});
|
|
113
|
+
function legacyDateTimeCodec(profile) {
|
|
114
|
+
return Object.freeze({
|
|
115
|
+
kind: 'legacyDateTime',
|
|
116
|
+
sqlType: 'TEXT',
|
|
117
|
+
encode (value, context) {
|
|
118
|
+
if ('object' != typeof value || null === value || 'number' != typeof value.year) reject('legacyDateTime', 'expected a G9LocalDateTime.');
|
|
119
|
+
return formatLegacyDateTime(value, null != profile ? profile : context.dateTimeProfile);
|
|
120
|
+
},
|
|
121
|
+
decode (value) {
|
|
122
|
+
if ('string' == typeof value) return parseLegacyDateTime(value);
|
|
123
|
+
return reject('legacyDateTime', `cannot read ${describeSqlValue(value)} as a date/time.`);
|
|
124
|
+
}
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
function jsonCodec() {
|
|
128
|
+
return Object.freeze({
|
|
129
|
+
kind: 'json',
|
|
130
|
+
sqlType: 'TEXT',
|
|
131
|
+
encode (value) {
|
|
132
|
+
const text = JSON.stringify(value);
|
|
133
|
+
if (void 0 === text) reject('json', 'value is not JSON-serialisable.');
|
|
134
|
+
return text;
|
|
135
|
+
},
|
|
136
|
+
decode (value) {
|
|
137
|
+
if ('string' != typeof value) return reject('json', `cannot read ${describeSqlValue(value)} as JSON text.`);
|
|
138
|
+
try {
|
|
139
|
+
return JSON.parse(value);
|
|
140
|
+
} catch (error) {
|
|
141
|
+
throw new G9SqliteError('misuse', 'json codec: stored text is not valid JSON.', {
|
|
142
|
+
cause: error
|
|
143
|
+
});
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
function enumIntCodec(members) {
|
|
149
|
+
const byValue = new Map();
|
|
150
|
+
const byName = new Map();
|
|
151
|
+
for (const name of Object.keys(members)){
|
|
152
|
+
const n = members[name];
|
|
153
|
+
if (!Number.isSafeInteger(n) || byValue.has(n)) reject('enumInt', `member '${name}' needs a unique integer.`);
|
|
154
|
+
byValue.set(n, name);
|
|
155
|
+
byName.set(name, n);
|
|
156
|
+
}
|
|
157
|
+
return Object.freeze({
|
|
158
|
+
kind: 'enumInt',
|
|
159
|
+
sqlType: 'INTEGER',
|
|
160
|
+
encode (value) {
|
|
161
|
+
const n = byName.get(value);
|
|
162
|
+
if (void 0 === n) return reject('enumInt', `'${String(value)}' is not a member.`);
|
|
163
|
+
return n;
|
|
164
|
+
},
|
|
165
|
+
decode (value) {
|
|
166
|
+
const name = 'number' == typeof value ? byValue.get(value) : void 0;
|
|
167
|
+
if (void 0 === name) return reject('enumInt', `stored ${describeSqlValue(value)} is not a member.`);
|
|
168
|
+
return name;
|
|
169
|
+
}
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
function enumTextCodec(members) {
|
|
173
|
+
const set = new Set(members);
|
|
174
|
+
return Object.freeze({
|
|
175
|
+
kind: 'enumText',
|
|
176
|
+
sqlType: 'TEXT',
|
|
177
|
+
encode (value) {
|
|
178
|
+
if (!set.has(value)) reject('enumText', `'${String(value)}' is not a member.`);
|
|
179
|
+
return value;
|
|
180
|
+
},
|
|
181
|
+
decode (value) {
|
|
182
|
+
if ('string' == typeof value && set.has(value)) return value;
|
|
183
|
+
return reject('enumText', `stored ${describeSqlValue(value)} is not a member.`);
|
|
184
|
+
}
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
function convertedCodec(store, converter, kind = `converted:${store.kind}`) {
|
|
188
|
+
return Object.freeze({
|
|
189
|
+
kind,
|
|
190
|
+
sqlType: store.sqlType,
|
|
191
|
+
encode (value, context) {
|
|
192
|
+
return store.encode(converter.toStore(value), context);
|
|
193
|
+
},
|
|
194
|
+
decode (value, context) {
|
|
195
|
+
return converter.fromStore(store.decode(value, context));
|
|
196
|
+
}
|
|
197
|
+
});
|
|
198
|
+
}
|
|
199
|
+
export { blobCodec, boolCodec, convertedCodec, decimalTextCodec, enumIntCodec, enumTextCodec, g9DefaultCodecContext, guidCodec, int64Codec, intCodec, jsonCodec, legacyDateTimeCodec, realCodec, textCodec };
|
|
200
|
+
|
|
201
|
+
//# sourceMappingURL=codecs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codecs/codecs.js","sources":["../../src/codecs/codecs.ts"],"sourcesContent":["import { G9SqliteError } from '../errors';\nimport { type G9IdCase, normalizeRequiredId } from '../values/ids';\nimport type { G9Int64 } from '../values/int64';\nimport {\n formatLegacyDateTime,\n type G9DateTimeWriteProfile,\n type G9LocalDateTime,\n parseLegacyDateTime,\n} from '../values/local-date-time';\nimport {\n describeSqlValue,\n type G9SqlValue,\n int64FromSqlValue,\n int64ToSqlValue,\n isInt64Tag,\n toArrayBuffer,\n} from '../values/sql-value';\n\n/** Database-wide settings a codec reads while converting (fixed per `createG9Sqlite`). */\nexport interface G9CodecContext {\n readonly idCase: G9IdCase;\n readonly dateTimeProfile: G9DateTimeWriteProfile;\n}\n\n/** The codec context of a default database: lowercase GUIDs, the provider date-time profile. */\nexport const g9DefaultCodecContext: G9CodecContext = Object.freeze({ idCase: 'lower', dateTimeProfile: 'provider' });\n\n/** SQLite storage class a codec declares in DDL (`CREATE TABLE` affinity). */\nexport type G9SqlType = 'TEXT' | 'INTEGER' | 'REAL' | 'BLOB' | 'NUMERIC';\n\n/**\n * Converts one column between the model value and the stored {@link G9SqlValue} (MAUI `IG9ValueConverter` plus the\n * mapping sqlite-net did by reflection). Codecs never see NULL: the column decides nullability.\n */\nexport interface G9Codec<T> {\n /** Stable name (`'text'`, `'int64'`, …) for diagnostics and descriptor checks. */\n readonly kind: string;\n readonly sqlType: G9SqlType;\n /** Model → stored. Throws `misuse` for a value outside the codec's domain (never stores a wrong value). */\n encode(value: T, context: G9CodecContext): G9SqlValue;\n /** Stored → model. Throws `misuse` for a stored value the codec cannot represent exactly. */\n decode(value: Exclude<G9SqlValue, null>, context: G9CodecContext): T;\n}\n\nfunction reject(kind: string, problem: string): never {\n throw new G9SqliteError('misuse', `${kind} codec: ${problem}`);\n}\n\n/** TEXT. Reads numbers stored in a TEXT column (affinity drift) as their exact decimal text. */\nexport const textCodec: G9Codec<string> = Object.freeze({\n kind: 'text',\n sqlType: 'TEXT' as const,\n encode(value: string) {\n if (typeof value !== 'string') reject('text', `expected a string, got ${typeof value}.`);\n return value;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'string') return value;\n if (typeof value === 'number') return String(value);\n if (isInt64Tag(value)) return value.int64;\n return reject('text', `cannot read ${describeSqlValue(value)} as text.`);\n },\n});\n\n/** INTEGER within ±(2^53 − 1). Larger stored values fail loudly: declare the column `int64()`. */\nexport const intCodec: G9Codec<number> = Object.freeze({\n kind: 'int',\n sqlType: 'INTEGER' as const,\n encode(value: number) {\n if (!Number.isSafeInteger(value)) reject('int', `${String(value)} is not a safe integer; use int64().`);\n return value;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'number' && Number.isSafeInteger(value)) return value;\n if (isInt64Tag(value)) return reject('int', `stored value ${value.int64} exceeds ±(2^53 − 1); use int64().`);\n return reject('int', `cannot read ${describeSqlValue(value)} as an integer.`);\n },\n});\n\n/** Signed 64-bit INTEGER, lossless: the model value is a {@link G9Int64} decimal string. */\nexport const int64Codec: G9Codec<G9Int64> = Object.freeze({\n kind: 'int64',\n sqlType: 'INTEGER' as const,\n encode(value: G9Int64) {\n return int64ToSqlValue(value);\n },\n decode(value: Exclude<G9SqlValue, null>) {\n return int64FromSqlValue(value);\n },\n});\n\n/** REAL (double). */\nexport const realCodec: G9Codec<number> = Object.freeze({\n kind: 'real',\n sqlType: 'REAL' as const,\n encode(value: number) {\n if (typeof value !== 'number' || Number.isNaN(value)) reject('real', 'expected a number (NaN is not storable).');\n return value;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'number') return value;\n return reject('real', `cannot read ${describeSqlValue(value)} as a number.`);\n },\n});\n\nconst DECIMAL = /^-?\\d+(?:\\.\\d+)?$/;\n\n/**\n * A decimal kept as exact text (`\"12.3400\"` keeps its scale). Declare the column TEXT: a NUMERIC/REAL affinity\n * column converts the text to a double on store, which is exactly the loss this codec exists to avoid; such a value\n * is read back as the double's shortest decimal text.\n */\nexport const decimalTextCodec: G9Codec<string> = Object.freeze({\n kind: 'decimalText',\n sqlType: 'TEXT' as const,\n encode(value: string) {\n if (typeof value !== 'string' || !DECIMAL.test(value)) {\n reject('decimalText', `'${String(value)}' is not a plain decimal (digits, optional sign and fraction).`);\n }\n return value;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'string' && DECIMAL.test(value)) return value;\n if (typeof value === 'number' && Number.isFinite(value)) return String(value);\n if (isInt64Tag(value)) return value.int64;\n return reject('decimalText', `cannot read ${describeSqlValue(value)} as a decimal.`);\n },\n});\n\n/** Boolean stored as 0/1. Any other stored value fails (a NULL is not false: make the column nullable). */\nexport const boolCodec: G9Codec<boolean> = Object.freeze({\n kind: 'bool',\n sqlType: 'INTEGER' as const,\n encode(value: boolean) {\n if (typeof value !== 'boolean') reject('bool', `expected a boolean, got ${typeof value}.`);\n return value ? 1 : 0;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (value === 0 || value === 1) return value === 1;\n return reject(\n 'bool',\n `stored value ${describeSqlValue(value)} ${typeof value === 'number' ? value : ''} is not 0 or 1.`,\n );\n },\n});\n\n/**\n * A GUID string: normalised to the canonical `D` form in the database's id case on write (and in predicates);\n * read back exactly as stored. Non-GUID text passes through trimmed, as MAUI did.\n */\nexport const guidCodec: G9Codec<string> = Object.freeze({\n kind: 'guid',\n sqlType: 'TEXT' as const,\n encode(value: string, context: G9CodecContext) {\n if (typeof value !== 'string') reject('guid', `expected a string, got ${typeof value}.`);\n return normalizeRequiredId(value, context.idCase);\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'string') return value;\n return reject('guid', `cannot read ${describeSqlValue(value)} as an id.`);\n },\n});\n\n/** BLOB as `ArrayBuffer` (typed arrays are copied in). Empty ≠ NULL. */\nexport const blobCodec: G9Codec<ArrayBuffer> = Object.freeze({\n kind: 'blob',\n sqlType: 'BLOB' as const,\n encode(value: ArrayBuffer) {\n if (value instanceof ArrayBuffer) return value;\n if (ArrayBuffer.isView(value)) return toArrayBuffer(value);\n return reject('blob', 'expected an ArrayBuffer or typed array.');\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (value instanceof ArrayBuffer) return value;\n return reject('blob', `cannot read ${describeSqlValue(value)} as bytes.`);\n },\n});\n\n/** A MAUI-format TEXT date/time (both separators, 0–7 fraction digits) as {@link G9LocalDateTime}. */\nexport function legacyDateTimeCodec(profile?: G9DateTimeWriteProfile): G9Codec<G9LocalDateTime> {\n return Object.freeze({\n kind: 'legacyDateTime',\n sqlType: 'TEXT' as const,\n encode(value: G9LocalDateTime, context: G9CodecContext) {\n if (typeof value !== 'object' || value === null || typeof value.year !== 'number') {\n reject('legacyDateTime', 'expected a G9LocalDateTime.');\n }\n return formatLegacyDateTime(value, profile ?? context.dateTimeProfile);\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'string') return parseLegacyDateTime(value);\n return reject('legacyDateTime', `cannot read ${describeSqlValue(value)} as a date/time.`);\n },\n });\n}\n\n/** Any JSON value stored as TEXT. */\nexport function jsonCodec<T>(): G9Codec<T> {\n return Object.freeze({\n kind: 'json',\n sqlType: 'TEXT' as const,\n encode(value: T) {\n const text = JSON.stringify(value);\n if (text === undefined) reject('json', 'value is not JSON-serialisable.');\n return text;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value !== 'string') return reject('json', `cannot read ${describeSqlValue(value)} as JSON text.`);\n try {\n return JSON.parse(value) as T;\n } catch (error) {\n throw new G9SqliteError('misuse', 'json codec: stored text is not valid JSON.', { cause: error });\n }\n },\n });\n}\n\n/**\n * An enum stored as its integer (MAUI `NormalizeParam`: `Convert.ToInt32(enum)`). The model value is the name; an\n * unknown stored number fails rather than inventing a member.\n */\nexport function enumIntCodec<K extends string>(members: Readonly<Record<K, number>>): G9Codec<K> {\n const byValue = new Map<number, K>();\n // A Map, not `members[value]`: an inherited key ('toString') must never look like a member.\n const byName = new Map<string, number>();\n for (const name of Object.keys(members) as K[]) {\n const n = members[name];\n if (!Number.isSafeInteger(n) || byValue.has(n)) reject('enumInt', `member '${name}' needs a unique integer.`);\n byValue.set(n, name);\n byName.set(name, n);\n }\n return Object.freeze({\n kind: 'enumInt',\n sqlType: 'INTEGER' as const,\n encode(value: K) {\n const n = byName.get(value);\n if (n === undefined) return reject('enumInt', `'${String(value)}' is not a member.`);\n return n;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n const name = typeof value === 'number' ? byValue.get(value) : undefined;\n if (name === undefined) return reject('enumInt', `stored ${describeSqlValue(value)} is not a member.`);\n return name;\n },\n });\n}\n\n/** An enum stored as its name (TEXT). */\nexport function enumTextCodec<K extends string>(members: readonly K[]): G9Codec<K> {\n const set = new Set<string>(members);\n return Object.freeze({\n kind: 'enumText',\n sqlType: 'TEXT' as const,\n encode(value: K) {\n if (!set.has(value)) reject('enumText', `'${String(value)}' is not a member.`);\n return value;\n },\n decode(value: Exclude<G9SqlValue, null>) {\n if (typeof value === 'string' && set.has(value)) return value as K;\n return reject('enumText', `stored ${describeSqlValue(value)} is not a member.`);\n },\n });\n}\n\n/** MAUI `IG9ValueConverter<TModel, TStore>`: model ↔ store, layered over a store codec. */\nexport interface G9ValueConverter<TModel, TStore> {\n toStore(value: TModel): TStore;\n fromStore(value: TStore): TModel;\n}\n\n/** Wraps a store codec with a {@link G9ValueConverter}. */\nexport function convertedCodec<TModel, TStore>(\n store: G9Codec<TStore>,\n converter: G9ValueConverter<TModel, TStore>,\n kind = `converted:${store.kind}`,\n): G9Codec<TModel> {\n return Object.freeze({\n kind,\n sqlType: store.sqlType,\n encode(value: TModel, context: G9CodecContext) {\n return store.encode(converter.toStore(value), context);\n },\n decode(value: Exclude<G9SqlValue, null>, context: G9CodecContext) {\n return converter.fromStore(store.decode(value, context));\n },\n });\n}\n"],"names":["g9DefaultCodecContext","Object","reject","kind","problem","G9SqliteError","textCodec","value","String","isInt64Tag","describeSqlValue","intCodec","Number","int64Codec","int64ToSqlValue","int64FromSqlValue","realCodec","DECIMAL","decimalTextCodec","boolCodec","guidCodec","context","normalizeRequiredId","blobCodec","ArrayBuffer","toArrayBuffer","legacyDateTimeCodec","profile","formatLegacyDateTime","parseLegacyDateTime","jsonCodec","text","JSON","undefined","error","enumIntCodec","members","byValue","Map","byName","name","n","enumTextCodec","set","Set","convertedCodec","store","converter"],"mappings":"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"}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import type { G9OpenOptions, G9SqliteDriver } from '../driver/types.js';
|
|
2
|
+
import { type G9SqlValue } from '../values/sql-value.js';
|
|
3
|
+
/** A value as written in `cases.json`. */
|
|
4
|
+
export type G9ContractValue = null | number | string | {
|
|
5
|
+
readonly int64: string;
|
|
6
|
+
} | {
|
|
7
|
+
readonly blob: string;
|
|
8
|
+
} | {
|
|
9
|
+
readonly blobRepeat: {
|
|
10
|
+
readonly byte: number;
|
|
11
|
+
readonly count: number;
|
|
12
|
+
};
|
|
13
|
+
} | {
|
|
14
|
+
readonly real: 'Infinity' | '-Infinity';
|
|
15
|
+
} | {
|
|
16
|
+
readonly undefined: true;
|
|
17
|
+
};
|
|
18
|
+
/** One statement of a contract step. */
|
|
19
|
+
export interface G9ContractStatement {
|
|
20
|
+
readonly sql: string;
|
|
21
|
+
readonly params?: readonly G9ContractValue[];
|
|
22
|
+
}
|
|
23
|
+
/** What one statement must return; only the fields given are compared. */
|
|
24
|
+
export interface G9ContractExpectation {
|
|
25
|
+
readonly columns?: readonly string[];
|
|
26
|
+
readonly rows?: readonly (readonly G9ContractValue[])[];
|
|
27
|
+
readonly changes?: number;
|
|
28
|
+
readonly lastInsertRowId?: G9ContractValue;
|
|
29
|
+
}
|
|
30
|
+
/** One step of a case. Exactly one of `run`, `open`, `begin`, `commit`, `rollback`, `close` is set. */
|
|
31
|
+
export interface G9ContractStep {
|
|
32
|
+
readonly run?: readonly G9ContractStatement[];
|
|
33
|
+
readonly session?: string;
|
|
34
|
+
readonly tx?: string;
|
|
35
|
+
readonly options?: {
|
|
36
|
+
readonly atomic?: boolean;
|
|
37
|
+
readonly maxRows?: number;
|
|
38
|
+
readonly abortedSignal?: boolean;
|
|
39
|
+
readonly readOnly?: boolean;
|
|
40
|
+
readonly create?: boolean;
|
|
41
|
+
readonly pragmas?: G9OpenOptions['pragmas'];
|
|
42
|
+
};
|
|
43
|
+
readonly expect?: readonly G9ContractExpectation[];
|
|
44
|
+
readonly expectError?: string;
|
|
45
|
+
readonly expectCompletedStatements?: number;
|
|
46
|
+
readonly open?: string;
|
|
47
|
+
readonly missingPath?: boolean;
|
|
48
|
+
readonly nestedPath?: boolean;
|
|
49
|
+
readonly begin?: string;
|
|
50
|
+
readonly mode?: 'deferred' | 'immediate';
|
|
51
|
+
readonly commit?: string;
|
|
52
|
+
readonly rollback?: string;
|
|
53
|
+
readonly close?: string;
|
|
54
|
+
}
|
|
55
|
+
/** One contract case: an id, its group, and the steps run against a fresh database. */
|
|
56
|
+
export interface G9ContractCase {
|
|
57
|
+
readonly id: string;
|
|
58
|
+
readonly group: string;
|
|
59
|
+
readonly steps: readonly G9ContractStep[];
|
|
60
|
+
}
|
|
61
|
+
/** The shared contract file (`@g9tm/lynxcontrols-sqlite/contract/cases.json`) every driver runs. */
|
|
62
|
+
export interface G9ContractCases {
|
|
63
|
+
readonly version: number;
|
|
64
|
+
readonly cases: readonly G9ContractCase[];
|
|
65
|
+
}
|
|
66
|
+
/** A failed case: which case, which step, and why. */
|
|
67
|
+
export interface G9ContractFailure {
|
|
68
|
+
readonly id: string;
|
|
69
|
+
readonly step: number;
|
|
70
|
+
readonly message: string;
|
|
71
|
+
}
|
|
72
|
+
/** Outcome of {@link runContractSuite}. A runner that cannot execute reports `blocked-by-runner` itself, never pass. */
|
|
73
|
+
export interface G9ContractReport {
|
|
74
|
+
readonly driver: string;
|
|
75
|
+
readonly total: number;
|
|
76
|
+
readonly passed: number;
|
|
77
|
+
readonly failed: readonly G9ContractFailure[];
|
|
78
|
+
readonly groups: readonly string[];
|
|
79
|
+
}
|
|
80
|
+
/** Options of a contract run against one driver. */
|
|
81
|
+
export interface G9ContractRunOptions {
|
|
82
|
+
/** A fresh database path for a case (`missing` = a path that must not exist). */
|
|
83
|
+
readonly databasePath: (caseId: string, kind: 'main' | 'missing' | 'nested') => string;
|
|
84
|
+
/** Only run these case ids (default: all). */
|
|
85
|
+
readonly only?: readonly string[];
|
|
86
|
+
}
|
|
87
|
+
/** Turns a contract value into a driver value. */
|
|
88
|
+
export declare function contractToSqlValue(value: G9ContractValue): G9SqlValue;
|
|
89
|
+
/**
|
|
90
|
+
* Runs the driver contract (`@g9tm/lynxcontrols-sqlite/contract/cases.json`) against a driver and reports every failure. The
|
|
91
|
+
* same data drives the Node reference driver, the Lynxtron worker, the Android JVM core and the iOS XCTest suite.
|
|
92
|
+
*/
|
|
93
|
+
export declare function runContractSuite(driver: G9SqliteDriver, cases: G9ContractCases, options: G9ContractRunOptions): Promise<G9ContractReport>;
|
|
94
|
+
//# sourceMappingURL=run-contract.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-contract.d.ts","sourceRoot":"","sources":["../../src/contract/run-contract.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
import { createAbortController } from "@g9tm/lynxcontrols-foundation";
|
|
2
|
+
import { G9SqliteError } from "../errors.js";
|
|
3
|
+
import { bytesToHex, hexToBytes, isInt64Tag } from "../values/sql-value.js";
|
|
4
|
+
function contractToSqlValue(value) {
|
|
5
|
+
if (null === value || 'number' == typeof value || 'string' == typeof value) return value;
|
|
6
|
+
if ('int64' in value) return {
|
|
7
|
+
int64: value.int64
|
|
8
|
+
};
|
|
9
|
+
if ('blob' in value) return hexToBytes(value.blob);
|
|
10
|
+
if ('blobRepeat' in value) return new Uint8Array(value.blobRepeat.count).fill(value.blobRepeat.byte).buffer;
|
|
11
|
+
if ('real' in value) return 'Infinity' === value.real ? 1 / 0 : -1 / 0;
|
|
12
|
+
}
|
|
13
|
+
function describe(value) {
|
|
14
|
+
if (value instanceof ArrayBuffer) return value.byteLength > 32 ? `blob(${value.byteLength})` : `blob(${bytesToHex(value)})`;
|
|
15
|
+
if (isInt64Tag(value)) return `int64(${value.int64})`;
|
|
16
|
+
return JSON.stringify(value);
|
|
17
|
+
}
|
|
18
|
+
function same(actual, expected) {
|
|
19
|
+
const e = contractToSqlValue(expected);
|
|
20
|
+
if (e instanceof ArrayBuffer) {
|
|
21
|
+
if (!(actual instanceof ArrayBuffer) || actual.byteLength !== e.byteLength) return false;
|
|
22
|
+
const a = new Uint8Array(actual);
|
|
23
|
+
const b = new Uint8Array(e);
|
|
24
|
+
for(let i = 0; i < a.length; i++)if (a[i] !== b[i]) return false;
|
|
25
|
+
return true;
|
|
26
|
+
}
|
|
27
|
+
if (isInt64Tag(e)) return isInt64Tag(actual) && actual.int64 === e.int64;
|
|
28
|
+
return Object.is(actual, e);
|
|
29
|
+
}
|
|
30
|
+
function checkResult(result, expected, index) {
|
|
31
|
+
if (void 0 !== expected.changes && result.changes !== expected.changes) return `statement ${index}: changes ${result.changes}, expected ${expected.changes}`;
|
|
32
|
+
if (void 0 !== expected.lastInsertRowId && !same(result.lastInsertRowId, expected.lastInsertRowId)) return `statement ${index}: lastInsertRowId ${describe(result.lastInsertRowId)}`;
|
|
33
|
+
if (expected.columns && result.columns.join('|') !== expected.columns.join('|')) return `statement ${index}: columns ${result.columns.join(',')}, expected ${expected.columns.join(',')}`;
|
|
34
|
+
if (expected.rows) {
|
|
35
|
+
if (result.rows.length !== expected.rows.length) return `statement ${index}: ${result.rows.length} rows, expected ${expected.rows.length}`;
|
|
36
|
+
for(let r = 0; r < expected.rows.length; r++){
|
|
37
|
+
const want = expected.rows[r];
|
|
38
|
+
const got = result.rows[r];
|
|
39
|
+
if (got.length !== want.length) return `statement ${index} row ${r}: ${got.length} values`;
|
|
40
|
+
for(let c = 0; c < want.length; c++)if (!same(got[c], want[c])) return `statement ${index} row ${r} col ${c}: ${describe(got[c])}`;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
return null;
|
|
44
|
+
}
|
|
45
|
+
async function runCase(driver, testCase, options) {
|
|
46
|
+
const sessions = new Map();
|
|
47
|
+
const txs = new Map();
|
|
48
|
+
const path = options.databasePath(testCase.id, 'main');
|
|
49
|
+
const fail = (step, message)=>({
|
|
50
|
+
id: testCase.id,
|
|
51
|
+
step,
|
|
52
|
+
message
|
|
53
|
+
});
|
|
54
|
+
try {
|
|
55
|
+
sessions.set('a', await driver.open({
|
|
56
|
+
path,
|
|
57
|
+
create: true,
|
|
58
|
+
pragmas: {
|
|
59
|
+
journalMode: 'wal',
|
|
60
|
+
busyTimeoutMs: 0
|
|
61
|
+
}
|
|
62
|
+
}));
|
|
63
|
+
for(let i = 0; i < testCase.steps.length; i++){
|
|
64
|
+
const step = testCase.steps[i];
|
|
65
|
+
let outcome = null;
|
|
66
|
+
try {
|
|
67
|
+
if (step.run) {
|
|
68
|
+
var _sessions_get, _step_session, _txs_get;
|
|
69
|
+
var _step_options, _step_options1, _step_options2;
|
|
70
|
+
const token = null != (_sessions_get = sessions.get(null != (_step_session = step.session) ? _step_session : 'a')) ? _sessions_get : 'closed';
|
|
71
|
+
const statements = step.run.map((s)=>{
|
|
72
|
+
var _s_params;
|
|
73
|
+
return {
|
|
74
|
+
sql: s.sql,
|
|
75
|
+
params: (null != (_s_params = s.params) ? _s_params : []).map(contractToSqlValue)
|
|
76
|
+
};
|
|
77
|
+
});
|
|
78
|
+
const runOptions = {};
|
|
79
|
+
const mutable = runOptions;
|
|
80
|
+
if (step.tx) mutable.tx = null != (_txs_get = txs.get(step.tx)) ? _txs_get : `finished-${step.tx}`;
|
|
81
|
+
if (null == (_step_options = step.options) ? void 0 : _step_options.atomic) mutable.atomic = true;
|
|
82
|
+
if ((null == (_step_options1 = step.options) ? void 0 : _step_options1.maxRows) !== void 0) mutable.maxRows = step.options.maxRows;
|
|
83
|
+
if (null == (_step_options2 = step.options) ? void 0 : _step_options2.abortedSignal) {
|
|
84
|
+
const controller = createAbortController();
|
|
85
|
+
controller.abort();
|
|
86
|
+
mutable.signal = controller.signal;
|
|
87
|
+
}
|
|
88
|
+
outcome = await driver.run(token, statements, runOptions);
|
|
89
|
+
} else if (step.open) {
|
|
90
|
+
var _ref;
|
|
91
|
+
var _step_options3, _step_options4, _step_options5;
|
|
92
|
+
const openOptions = {
|
|
93
|
+
path: step.missingPath ? options.databasePath(testCase.id, 'missing') : step.nestedPath ? options.databasePath(testCase.id, 'nested') : path,
|
|
94
|
+
create: null != (_ref = null == (_step_options3 = step.options) ? void 0 : _step_options3.create) ? _ref : !step.missingPath,
|
|
95
|
+
...(null == (_step_options4 = step.options) ? void 0 : _step_options4.readOnly) ? {
|
|
96
|
+
readOnly: true
|
|
97
|
+
} : {},
|
|
98
|
+
...(null == (_step_options5 = step.options) ? void 0 : _step_options5.pragmas) ? {
|
|
99
|
+
pragmas: step.options.pragmas
|
|
100
|
+
} : {}
|
|
101
|
+
};
|
|
102
|
+
sessions.set(step.open, await driver.open(openOptions));
|
|
103
|
+
} else if (step.begin) {
|
|
104
|
+
var _sessions_get1, _step_session1, _step_mode;
|
|
105
|
+
const token = null != (_sessions_get1 = sessions.get(null != (_step_session1 = step.session) ? _step_session1 : 'a')) ? _sessions_get1 : 'closed';
|
|
106
|
+
txs.set(step.begin, await driver.begin(token, null != (_step_mode = step.mode) ? _step_mode : 'deferred'));
|
|
107
|
+
} else if (step.commit) {
|
|
108
|
+
await driver.commit(txs.get(step.commit));
|
|
109
|
+
txs.delete(step.commit);
|
|
110
|
+
} else if (step.rollback) {
|
|
111
|
+
await driver.rollback(txs.get(step.rollback));
|
|
112
|
+
txs.delete(step.rollback);
|
|
113
|
+
} else if (step.close) {
|
|
114
|
+
const token = sessions.get(step.close);
|
|
115
|
+
sessions.delete(step.close);
|
|
116
|
+
await driver.close(token);
|
|
117
|
+
}
|
|
118
|
+
} catch (error) {
|
|
119
|
+
if (!step.expectError) return fail(i, `unexpected error: ${error.message}`);
|
|
120
|
+
const code = error instanceof G9SqliteError ? error.code : `foreign:${String(error)}`;
|
|
121
|
+
if (code !== step.expectError) return fail(i, `error code ${code}, expected ${step.expectError}`);
|
|
122
|
+
if (void 0 !== step.expectCompletedStatements && error.completedStatements !== step.expectCompletedStatements) return fail(i, `completedStatements ${error.completedStatements}`);
|
|
123
|
+
continue;
|
|
124
|
+
}
|
|
125
|
+
if (step.expectError) return fail(i, `expected error ${step.expectError}, got success`);
|
|
126
|
+
if (step.expect && outcome) {
|
|
127
|
+
if (outcome.length !== step.expect.length) return fail(i, `${outcome.length} results`);
|
|
128
|
+
for(let k = 0; k < step.expect.length; k++){
|
|
129
|
+
const problem = checkResult(outcome[k], step.expect[k], k);
|
|
130
|
+
if (problem) return fail(i, problem);
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
return null;
|
|
135
|
+
} catch (error) {
|
|
136
|
+
return fail(-1, `case setup failed: ${error.message}`);
|
|
137
|
+
} finally{
|
|
138
|
+
for (const tx of txs.values())await driver.rollback(tx).catch(()=>void 0);
|
|
139
|
+
for (const token of sessions.values())await driver.close(token).catch(()=>void 0);
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
async function runContractSuite(driver, cases, options) {
|
|
143
|
+
const selected = cases.cases.filter((c)=>!options.only || options.only.indexOf(c.id) >= 0);
|
|
144
|
+
const failed = [];
|
|
145
|
+
for (const testCase of selected){
|
|
146
|
+
const failure = await runCase(driver, testCase, options);
|
|
147
|
+
if (failure) failed.push(failure);
|
|
148
|
+
}
|
|
149
|
+
return Object.freeze({
|
|
150
|
+
driver: driver.name,
|
|
151
|
+
total: selected.length,
|
|
152
|
+
passed: selected.length - failed.length,
|
|
153
|
+
failed: Object.freeze(failed),
|
|
154
|
+
groups: Object.freeze(Array.from(new Set(selected.map((c)=>c.group))))
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
export { contractToSqlValue, runContractSuite };
|
|
158
|
+
|
|
159
|
+
//# sourceMappingURL=run-contract.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contract/run-contract.js","sources":["../../src/contract/run-contract.ts"],"sourcesContent":["import { createAbortController } from '@g9tm/lynxcontrols-foundation';\nimport type {\n G9DriverStatement,\n G9OpenOptions,\n G9RunOptions,\n G9SessionToken,\n G9SqliteDriver,\n G9SqlResult,\n G9TxToken,\n} from '../driver/types';\nimport { G9SqliteError } from '../errors';\nimport { bytesToHex, type G9SqlValue, hexToBytes, isInt64Tag } from '../values/sql-value';\n\n/** A value as written in `cases.json`. */\nexport type G9ContractValue =\n | null\n | number\n | string\n | { readonly int64: string }\n | { readonly blob: string }\n | { readonly blobRepeat: { readonly byte: number; readonly count: number } }\n | { readonly real: 'Infinity' | '-Infinity' }\n | { readonly undefined: true };\n\n/** One statement of a contract step. */\nexport interface G9ContractStatement {\n readonly sql: string;\n readonly params?: readonly G9ContractValue[];\n}\n\n/** What one statement must return; only the fields given are compared. */\nexport interface G9ContractExpectation {\n readonly columns?: readonly string[];\n readonly rows?: readonly (readonly G9ContractValue[])[];\n readonly changes?: number;\n readonly lastInsertRowId?: G9ContractValue;\n}\n\n/** One step of a case. Exactly one of `run`, `open`, `begin`, `commit`, `rollback`, `close` is set. */\nexport interface G9ContractStep {\n readonly run?: readonly G9ContractStatement[];\n readonly session?: string;\n readonly tx?: string;\n readonly options?: {\n readonly atomic?: boolean;\n readonly maxRows?: number;\n readonly abortedSignal?: boolean;\n readonly readOnly?: boolean;\n readonly create?: boolean;\n readonly pragmas?: G9OpenOptions['pragmas'];\n };\n readonly expect?: readonly G9ContractExpectation[];\n readonly expectError?: string;\n readonly expectCompletedStatements?: number;\n readonly open?: string;\n readonly missingPath?: boolean;\n readonly nestedPath?: boolean;\n readonly begin?: string;\n readonly mode?: 'deferred' | 'immediate';\n readonly commit?: string;\n readonly rollback?: string;\n readonly close?: string;\n}\n\n/** One contract case: an id, its group, and the steps run against a fresh database. */\nexport interface G9ContractCase {\n readonly id: string;\n readonly group: string;\n readonly steps: readonly G9ContractStep[];\n}\n\n/** The shared contract file (`@g9tm/lynxcontrols-sqlite/contract/cases.json`) every driver runs. */\nexport interface G9ContractCases {\n readonly version: number;\n readonly cases: readonly G9ContractCase[];\n}\n\n/** A failed case: which case, which step, and why. */\nexport interface G9ContractFailure {\n readonly id: string;\n readonly step: number;\n readonly message: string;\n}\n\n/** Outcome of {@link runContractSuite}. A runner that cannot execute reports `blocked-by-runner` itself, never pass. */\nexport interface G9ContractReport {\n readonly driver: string;\n readonly total: number;\n readonly passed: number;\n readonly failed: readonly G9ContractFailure[];\n readonly groups: readonly string[];\n}\n\n/** Options of a contract run against one driver. */\nexport interface G9ContractRunOptions {\n /** A fresh database path for a case (`missing` = a path that must not exist). */\n readonly databasePath: (caseId: string, kind: 'main' | 'missing' | 'nested') => string;\n /** Only run these case ids (default: all). */\n readonly only?: readonly string[];\n}\n\n/** Turns a contract value into a driver value. */\nexport function contractToSqlValue(value: G9ContractValue): G9SqlValue {\n if (value === null || typeof value === 'number' || typeof value === 'string') return value;\n if ('int64' in value) return { int64: value.int64 } as G9SqlValue;\n if ('blob' in value) return hexToBytes(value.blob);\n if ('blobRepeat' in value) return new Uint8Array(value.blobRepeat.count).fill(value.blobRepeat.byte).buffer;\n if ('real' in value) return value.real === 'Infinity' ? Number.POSITIVE_INFINITY : Number.NEGATIVE_INFINITY;\n return undefined as unknown as G9SqlValue;\n}\n\nfunction describe(value: G9SqlValue): string {\n if (value instanceof ArrayBuffer) {\n return value.byteLength > 32 ? `blob(${value.byteLength})` : `blob(${bytesToHex(value)})`;\n }\n if (isInt64Tag(value)) return `int64(${value.int64})`;\n return JSON.stringify(value);\n}\n\nfunction same(actual: G9SqlValue, expected: G9ContractValue): boolean {\n const e = contractToSqlValue(expected);\n if (e instanceof ArrayBuffer) {\n if (!(actual instanceof ArrayBuffer) || actual.byteLength !== e.byteLength) return false;\n const a = new Uint8Array(actual);\n const b = new Uint8Array(e);\n for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;\n return true;\n }\n if (isInt64Tag(e)) return isInt64Tag(actual) && actual.int64 === e.int64;\n return Object.is(actual, e);\n}\n\nfunction checkResult(result: G9SqlResult, expected: G9ContractExpectation, index: number): string | null {\n if (expected.changes !== undefined && result.changes !== expected.changes) {\n return `statement ${index}: changes ${result.changes}, expected ${expected.changes}`;\n }\n if (expected.lastInsertRowId !== undefined && !same(result.lastInsertRowId, expected.lastInsertRowId)) {\n return `statement ${index}: lastInsertRowId ${describe(result.lastInsertRowId)}`;\n }\n if (expected.columns && result.columns.join('|') !== expected.columns.join('|')) {\n return `statement ${index}: columns ${result.columns.join(',')}, expected ${expected.columns.join(',')}`;\n }\n if (expected.rows) {\n if (result.rows.length !== expected.rows.length) {\n return `statement ${index}: ${result.rows.length} rows, expected ${expected.rows.length}`;\n }\n for (let r = 0; r < expected.rows.length; r++) {\n const want = expected.rows[r] as readonly G9ContractValue[];\n const got = result.rows[r] as readonly G9SqlValue[];\n if (got.length !== want.length) return `statement ${index} row ${r}: ${got.length} values`;\n for (let c = 0; c < want.length; c++) {\n if (!same(got[c] as G9SqlValue, want[c] as G9ContractValue)) {\n return `statement ${index} row ${r} col ${c}: ${describe(got[c] as G9SqlValue)}`;\n }\n }\n }\n }\n return null;\n}\n\nasync function runCase(\n driver: G9SqliteDriver,\n testCase: G9ContractCase,\n options: G9ContractRunOptions,\n): Promise<G9ContractFailure | null> {\n const sessions = new Map<string, G9SessionToken>();\n const txs = new Map<string, G9TxToken>();\n const path = options.databasePath(testCase.id, 'main');\n const fail = (step: number, message: string): G9ContractFailure => ({ id: testCase.id, step, message });\n try {\n sessions.set('a', await driver.open({ path, create: true, pragmas: { journalMode: 'wal', busyTimeoutMs: 0 } }));\n for (let i = 0; i < testCase.steps.length; i++) {\n const step = testCase.steps[i] as G9ContractStep;\n let outcome: G9SqlResult[] | null = null;\n try {\n if (step.run) {\n const token = sessions.get(step.session ?? 'a') ?? ('closed' as G9SessionToken);\n const statements: G9DriverStatement[] = step.run.map((s) => ({\n sql: s.sql,\n params: (s.params ?? []).map(contractToSqlValue),\n }));\n const runOptions: G9RunOptions = {};\n const mutable = runOptions as { -readonly [K in keyof G9RunOptions]: G9RunOptions[K] };\n if (step.tx) mutable.tx = txs.get(step.tx) ?? (`finished-${step.tx}` as G9TxToken);\n if (step.options?.atomic) mutable.atomic = true;\n if (step.options?.maxRows !== undefined) mutable.maxRows = step.options.maxRows;\n if (step.options?.abortedSignal) {\n const controller = createAbortController();\n controller.abort();\n mutable.signal = controller.signal;\n }\n outcome = await driver.run(token, statements, runOptions);\n } else if (step.open) {\n const openOptions: G9OpenOptions = {\n path: step.missingPath\n ? options.databasePath(testCase.id, 'missing')\n : step.nestedPath\n ? options.databasePath(testCase.id, 'nested')\n : path,\n create: step.options?.create ?? !step.missingPath,\n ...(step.options?.readOnly ? { readOnly: true } : {}),\n ...(step.options?.pragmas ? { pragmas: step.options.pragmas } : {}),\n };\n sessions.set(step.open, await driver.open(openOptions));\n } else if (step.begin) {\n const token = sessions.get(step.session ?? 'a') ?? ('closed' as G9SessionToken);\n txs.set(step.begin, await driver.begin(token, step.mode ?? 'deferred'));\n } else if (step.commit) {\n await driver.commit(txs.get(step.commit) as G9TxToken);\n txs.delete(step.commit);\n } else if (step.rollback) {\n await driver.rollback(txs.get(step.rollback) as G9TxToken);\n txs.delete(step.rollback);\n } else if (step.close) {\n const token = sessions.get(step.close) as G9SessionToken;\n sessions.delete(step.close);\n await driver.close(token);\n }\n } catch (error) {\n if (!step.expectError) return fail(i, `unexpected error: ${(error as Error).message}`);\n const code = error instanceof G9SqliteError ? error.code : `foreign:${String(error)}`;\n if (code !== step.expectError) return fail(i, `error code ${code}, expected ${step.expectError}`);\n if (\n step.expectCompletedStatements !== undefined &&\n (error as G9SqliteError).completedStatements !== step.expectCompletedStatements\n ) {\n return fail(i, `completedStatements ${(error as G9SqliteError).completedStatements}`);\n }\n continue;\n }\n if (step.expectError) return fail(i, `expected error ${step.expectError}, got success`);\n if (step.expect && outcome) {\n if (outcome.length !== step.expect.length) return fail(i, `${outcome.length} results`);\n for (let k = 0; k < step.expect.length; k++) {\n const problem = checkResult(outcome[k] as G9SqlResult, step.expect[k] as G9ContractExpectation, k);\n if (problem) return fail(i, problem);\n }\n }\n }\n return null;\n } catch (error) {\n return fail(-1, `case setup failed: ${(error as Error).message}`);\n } finally {\n for (const tx of txs.values()) await driver.rollback(tx).catch(() => undefined);\n for (const token of sessions.values()) await driver.close(token).catch(() => undefined);\n }\n}\n\n/**\n * Runs the driver contract (`@g9tm/lynxcontrols-sqlite/contract/cases.json`) against a driver and reports every failure. The\n * same data drives the Node reference driver, the Lynxtron worker, the Android JVM core and the iOS XCTest suite.\n */\nexport async function runContractSuite(\n driver: G9SqliteDriver,\n cases: G9ContractCases,\n options: G9ContractRunOptions,\n): Promise<G9ContractReport> {\n const selected = cases.cases.filter((c) => !options.only || options.only.indexOf(c.id) >= 0);\n const failed: G9ContractFailure[] = [];\n for (const testCase of selected) {\n const failure = await runCase(driver, testCase, options);\n if (failure) failed.push(failure);\n }\n return Object.freeze({\n driver: driver.name,\n total: selected.length,\n passed: selected.length - failed.length,\n failed: Object.freeze(failed),\n groups: Object.freeze(Array.from(new Set(selected.map((c) => c.group)))),\n });\n}\n"],"names":["contractToSqlValue","value","hexToBytes","Uint8Array","Number","describe","ArrayBuffer","bytesToHex","isInt64Tag","JSON","same","actual","expected","e","a","b","i","Object","checkResult","result","index","undefined","r","want","got","c","runCase","driver","testCase","options","sessions","Map","txs","path","fail","step","message","outcome","_sessions_get","_step_session","_txs_get","_step_options","_step_options1","_step_options2","token","statements","s","_s_params","runOptions","mutable","controller","createAbortController","_step_options3","_step_options4","_step_options5","openOptions","_sessions_get1","_step_session1","_step_mode","error","code","G9SqliteError","String","k","problem","tx","runContractSuite","cases","selected","failed","failure","Array","Set"],"mappings":"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"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import type { G9AbortSignal } from '@g9tm/lynxcontrols-foundation';
|
|
2
|
+
import type { G9SqlValue } from '../values/sql-value.js';
|
|
3
|
+
/** One statement of a batch: SQL with `?` placeholders and its positional parameters. */
|
|
4
|
+
export interface G9DriverStatement {
|
|
5
|
+
readonly sql: string;
|
|
6
|
+
readonly params: readonly G9SqlValue[];
|
|
7
|
+
}
|
|
8
|
+
/** The result of one statement (plan/specs/05-Persistence.md §3). */
|
|
9
|
+
export interface G9SqlResult {
|
|
10
|
+
/** Result column names in order (empty for a statement that returns no rows). */
|
|
11
|
+
readonly columns: readonly string[];
|
|
12
|
+
/** Row-major values in column order. */
|
|
13
|
+
readonly rows: readonly (readonly G9SqlValue[])[];
|
|
14
|
+
/** Rows changed by an INSERT/UPDATE/DELETE (0 otherwise). */
|
|
15
|
+
readonly changes: number;
|
|
16
|
+
/** Rowid of the last insert on this connection (number or int64 tag). */
|
|
17
|
+
readonly lastInsertRowId: G9SqlValue;
|
|
18
|
+
}
|
|
19
|
+
/** Opaque session handle; invalid after `close` (and after a user switch the session layer performs). */
|
|
20
|
+
export type G9SessionToken = string & {
|
|
21
|
+
readonly __g9Session: true;
|
|
22
|
+
};
|
|
23
|
+
/** Opaque transaction handle; invalid after `commit`/`rollback`. */
|
|
24
|
+
export type G9TxToken = string & {
|
|
25
|
+
readonly __g9Tx: true;
|
|
26
|
+
};
|
|
27
|
+
/** Durability of committed writes (D13): `full` (default) survives power loss; `normal` may lose the last commits. */
|
|
28
|
+
export type G9Durability = 'full' | 'normal';
|
|
29
|
+
/** Per-connection PRAGMA values a driver applies on open, before any statement (names are whitelisted). */
|
|
30
|
+
export interface G9ConnectionPragmas {
|
|
31
|
+
readonly journalMode?: 'wal' | 'delete' | 'truncate' | 'memory';
|
|
32
|
+
readonly busyTimeoutMs?: number;
|
|
33
|
+
readonly foreignKeys?: boolean;
|
|
34
|
+
readonly tempStore?: 'memory' | 'file' | 'default';
|
|
35
|
+
/** `PRAGMA cache_size`: negative = KiB, positive = pages. */
|
|
36
|
+
readonly cacheSize?: number;
|
|
37
|
+
readonly mmapSize?: number;
|
|
38
|
+
}
|
|
39
|
+
/** How a driver opens a database session. */
|
|
40
|
+
export interface G9OpenOptions {
|
|
41
|
+
/** Database file path, or `':memory:'`. */
|
|
42
|
+
readonly path: string;
|
|
43
|
+
readonly readOnly?: boolean;
|
|
44
|
+
/** Create the file when it does not exist. Without it, a missing file fails with `not-found`. */
|
|
45
|
+
readonly create?: boolean;
|
|
46
|
+
readonly durability?: G9Durability;
|
|
47
|
+
readonly pragmas?: G9ConnectionPragmas;
|
|
48
|
+
}
|
|
49
|
+
/** Options of one driver batch: transaction, cancellation, row cap and atomicity. */
|
|
50
|
+
export interface G9RunOptions {
|
|
51
|
+
/** Run inside this transaction. */
|
|
52
|
+
readonly tx?: G9TxToken;
|
|
53
|
+
/** Cancels statements that have not started (and the rest of a batch). */
|
|
54
|
+
readonly signal?: G9AbortSignal;
|
|
55
|
+
/** Maximum rows any one statement may return; more fails with `too-many-rows` (never truncated). */
|
|
56
|
+
readonly maxRows?: number;
|
|
57
|
+
/** Without `tx`: wrap the batch in one transaction, so it applies entirely or not at all. */
|
|
58
|
+
readonly atomic?: boolean;
|
|
59
|
+
}
|
|
60
|
+
/** What a driver supports (negotiated once per database). */
|
|
61
|
+
export interface G9DriverCapabilities {
|
|
62
|
+
readonly sqliteVersion: string;
|
|
63
|
+
/** SQLite's per-statement variable limit. */
|
|
64
|
+
readonly maxVariables: number;
|
|
65
|
+
readonly json1: boolean;
|
|
66
|
+
readonly returning: boolean;
|
|
67
|
+
readonly upsert: boolean;
|
|
68
|
+
/** Whether a running statement can be interrupted (`sqlite3_interrupt`). */
|
|
69
|
+
readonly interrupt: boolean;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The platform boundary (plan/specs/05-Persistence.md §3): native (Android/iOS), Lynxtron (desktop) and the Node
|
|
73
|
+
* reference driver implement it; `cases.json` is its contract. One `run` = one bridge round trip for N statements.
|
|
74
|
+
*/
|
|
75
|
+
export interface G9SqliteDriver {
|
|
76
|
+
readonly name: string;
|
|
77
|
+
capabilities(): Promise<G9DriverCapabilities>;
|
|
78
|
+
open(options: G9OpenOptions): Promise<G9SessionToken>;
|
|
79
|
+
run(session: G9SessionToken, statements: readonly G9DriverStatement[], options?: G9RunOptions): Promise<G9SqlResult[]>;
|
|
80
|
+
begin(session: G9SessionToken, mode: 'deferred' | 'immediate'): Promise<G9TxToken>;
|
|
81
|
+
commit(tx: G9TxToken): Promise<void>;
|
|
82
|
+
rollback(tx: G9TxToken): Promise<void>;
|
|
83
|
+
close(session: G9SessionToken): Promise<void>;
|
|
84
|
+
}
|
|
85
|
+
/** The PRAGMA statements for {@link G9ConnectionPragmas}, in application order (for drivers). */
|
|
86
|
+
export declare function pragmaStatements(pragmas: G9ConnectionPragmas, durability: G9Durability | undefined): string[];
|
|
87
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/driver/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,UAAU,EAAE,CAAC,EAAE,CAAC;IAClD,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;CACtC;AAED,yGAAyG;AACzG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAA;CAAE,CAAC;AACrE,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC;AAE3D,sHAAsH;AACtH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,2GAA2G;AAC3G,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,oGAAoG;IACpG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtD,GAAG,CACD,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1B,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnF,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAW7G"}
|