@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.
Files changed (111) hide show
  1. package/README.md +12 -0
  2. package/contract/cases.json +463 -0
  3. package/dist/.tsbuildinfo +1 -0
  4. package/dist/codecs/codecs.d.ts +68 -0
  5. package/dist/codecs/codecs.d.ts.map +1 -0
  6. package/dist/codecs/codecs.js +201 -0
  7. package/dist/codecs/codecs.js.map +1 -0
  8. package/dist/contract/run-contract.d.ts +94 -0
  9. package/dist/contract/run-contract.d.ts.map +1 -0
  10. package/dist/contract/run-contract.js +159 -0
  11. package/dist/contract/run-contract.js.map +1 -0
  12. package/dist/driver/types.d.ts +87 -0
  13. package/dist/driver/types.d.ts.map +1 -0
  14. package/dist/driver/types.js +14 -0
  15. package/dist/driver/types.js.map +1 -0
  16. package/dist/errors.d.ts +39 -0
  17. package/dist/errors.d.ts.map +1 -0
  18. package/dist/errors.js +57 -0
  19. package/dist/errors.js.map +1 -0
  20. package/dist/index.d.ts +25 -0
  21. package/dist/index.d.ts.map +1 -0
  22. package/dist/index.js +22 -0
  23. package/dist/query/builders.d.ts +216 -0
  24. package/dist/query/builders.d.ts.map +1 -0
  25. package/dist/query/builders.js +490 -0
  26. package/dist/query/builders.js.map +1 -0
  27. package/dist/query/compile.d.ts +42 -0
  28. package/dist/query/compile.d.ts.map +1 -0
  29. package/dist/query/compile.js +307 -0
  30. package/dist/query/compile.js.map +1 -0
  31. package/dist/query/expr.d.ts +201 -0
  32. package/dist/query/expr.d.ts.map +1 -0
  33. package/dist/query/expr.js +247 -0
  34. package/dist/query/expr.js.map +1 -0
  35. package/dist/repo/audit.d.ts +19 -0
  36. package/dist/repo/audit.d.ts.map +1 -0
  37. package/dist/repo/audit.js +36 -0
  38. package/dist/repo/audit.js.map +1 -0
  39. package/dist/repo/repository.d.ts +233 -0
  40. package/dist/repo/repository.d.ts.map +1 -0
  41. package/dist/repo/repository.js +715 -0
  42. package/dist/repo/repository.js.map +1 -0
  43. package/dist/schema/columns.d.ts +115 -0
  44. package/dist/schema/columns.d.ts.map +1 -0
  45. package/dist/schema/columns.js +112 -0
  46. package/dist/schema/columns.js.map +1 -0
  47. package/dist/schema/entity.d.ts +135 -0
  48. package/dist/schema/entity.d.ts.map +1 -0
  49. package/dist/schema/entity.js +227 -0
  50. package/dist/schema/entity.js.map +1 -0
  51. package/dist/schema/policies.d.ts +89 -0
  52. package/dist/schema/policies.d.ts.map +1 -0
  53. package/dist/schema/policies.js +54 -0
  54. package/dist/schema/policies.js.map +1 -0
  55. package/dist/session/ambient.d.ts +32 -0
  56. package/dist/session/ambient.d.ts.map +1 -0
  57. package/dist/session/ambient.js +28 -0
  58. package/dist/session/ambient.js.map +1 -0
  59. package/dist/session/cache.d.ts +62 -0
  60. package/dist/session/cache.d.ts.map +1 -0
  61. package/dist/session/cache.js +239 -0
  62. package/dist/session/cache.js.map +1 -0
  63. package/dist/session/database.d.ts +221 -0
  64. package/dist/session/database.d.ts.map +1 -0
  65. package/dist/session/database.js +430 -0
  66. package/dist/session/database.js.map +1 -0
  67. package/dist/session/locator.d.ts +33 -0
  68. package/dist/session/locator.d.ts.map +1 -0
  69. package/dist/session/locator.js +39 -0
  70. package/dist/session/locator.js.map +1 -0
  71. package/dist/session/migrations.d.ts +75 -0
  72. package/dist/session/migrations.d.ts.map +1 -0
  73. package/dist/session/migrations.js +88 -0
  74. package/dist/session/migrations.js.map +1 -0
  75. package/dist/session/mutex.d.ts +7 -0
  76. package/dist/session/mutex.d.ts.map +1 -0
  77. package/dist/session/mutex.js +27 -0
  78. package/dist/session/mutex.js.map +1 -0
  79. package/dist/session/rows.d.ts +17 -0
  80. package/dist/session/rows.d.ts.map +1 -0
  81. package/dist/session/rows.js +52 -0
  82. package/dist/session/rows.js.map +1 -0
  83. package/dist/session/schema-setup.d.ts +21 -0
  84. package/dist/session/schema-setup.d.ts.map +1 -0
  85. package/dist/session/schema-setup.js +227 -0
  86. package/dist/session/schema-setup.js.map +1 -0
  87. package/dist/session/scope.d.ts +117 -0
  88. package/dist/session/scope.d.ts.map +1 -0
  89. package/dist/session/scope.js +233 -0
  90. package/dist/session/scope.js.map +1 -0
  91. package/dist/session/write-hooks.d.ts +84 -0
  92. package/dist/session/write-hooks.d.ts.map +1 -0
  93. package/dist/session/write-hooks.js +55 -0
  94. package/dist/session/write-hooks.js.map +1 -0
  95. package/dist/values/ids.d.ts +46 -0
  96. package/dist/values/ids.d.ts.map +1 -0
  97. package/dist/values/ids.js +84 -0
  98. package/dist/values/ids.js.map +1 -0
  99. package/dist/values/int64.d.ts +33 -0
  100. package/dist/values/int64.d.ts.map +1 -0
  101. package/dist/values/int64.js +105 -0
  102. package/dist/values/int64.js.map +1 -0
  103. package/dist/values/local-date-time.d.ts +61 -0
  104. package/dist/values/local-date-time.d.ts.map +1 -0
  105. package/dist/values/local-date-time.js +122 -0
  106. package/dist/values/local-date-time.js.map +1 -0
  107. package/dist/values/sql-value.d.ts +36 -0
  108. package/dist/values/sql-value.d.ts.map +1 -0
  109. package/dist/values/sql-value.js +70 -0
  110. package/dist/values/sql-value.js.map +1 -0
  111. package/package.json +27 -0
@@ -0,0 +1,70 @@
1
+ import { G9SqliteError } from "../errors.js";
2
+ import { isInt64, isSafeInt64, parseInt64 } from "./int64.js";
3
+ function isInt64Tag(value) {
4
+ return 'object' == typeof value && null !== value && !(value instanceof ArrayBuffer) && isInt64(value.int64);
5
+ }
6
+ function isSqlValue(value) {
7
+ if (null === value || 'string' == typeof value || value instanceof ArrayBuffer) return true;
8
+ if ('number' == typeof value) return !Number.isNaN(value);
9
+ return isInt64Tag(value);
10
+ }
11
+ function int64ToSqlValue(value) {
12
+ const canonical = parseInt64(value);
13
+ return isSafeInt64(canonical) ? Number(canonical) : {
14
+ int64: canonical
15
+ };
16
+ }
17
+ function int64FromSqlValue(value) {
18
+ if ('number' == typeof value) {
19
+ if (!Number.isSafeInteger(value)) throw new G9SqliteError('misuse', `Value ${value} is not an exact integer.`);
20
+ return parseInt64(value);
21
+ }
22
+ if (isInt64Tag(value)) return value.int64;
23
+ throw new G9SqliteError('misuse', `Expected an integer, got ${describeSqlValue(value)}.`);
24
+ }
25
+ function toArrayBuffer(bytes) {
26
+ if (bytes instanceof ArrayBuffer) return bytes;
27
+ const copy = new Uint8Array(bytes.byteLength);
28
+ copy.set(new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength));
29
+ return copy.buffer;
30
+ }
31
+ function describeSqlValue(value) {
32
+ if (null === value) return 'NULL';
33
+ if (void 0 === value) return 'undefined';
34
+ if (value instanceof ArrayBuffer) return `BLOB(${value.byteLength})`;
35
+ if (isInt64Tag(value)) return 'INT64';
36
+ if ('number' == typeof value) return Number.isInteger(value) ? 'INTEGER' : 'REAL';
37
+ if ('string' == typeof value) return 'TEXT';
38
+ return typeof value;
39
+ }
40
+ function bytesEqual(a, b) {
41
+ if (a.byteLength !== b.byteLength) return false;
42
+ const x = new Uint8Array(a);
43
+ const y = new Uint8Array(b);
44
+ for(let i = 0; i < x.length; i++)if (x[i] !== y[i]) return false;
45
+ return true;
46
+ }
47
+ function sqlValueEquals(a, b) {
48
+ if (a instanceof ArrayBuffer || b instanceof ArrayBuffer) return a instanceof ArrayBuffer && b instanceof ArrayBuffer && bytesEqual(a, b);
49
+ if (isInt64Tag(a) || isInt64Tag(b)) return isInt64Tag(a) && isInt64Tag(b) && a.int64 === b.int64;
50
+ return Object.is(a, b) || a === b;
51
+ }
52
+ const HEX = '0123456789abcdef';
53
+ function bytesToHex(bytes) {
54
+ const view = new Uint8Array(bytes);
55
+ let out = '';
56
+ for(let i = 0; i < view.length; i++){
57
+ const b = view[i];
58
+ out += HEX[b >> 4] + HEX[15 & b];
59
+ }
60
+ return out;
61
+ }
62
+ function hexToBytes(hex) {
63
+ if (hex.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(hex)) throw new G9SqliteError('misuse', 'Hex text must have an even number of hex digits.');
64
+ const out = new Uint8Array(hex.length / 2);
65
+ for(let i = 0; i < out.length; i++)out[i] = Number.parseInt(hex.substr(2 * i, 2), 16);
66
+ return out.buffer;
67
+ }
68
+ export { bytesToHex, describeSqlValue, hexToBytes, int64FromSqlValue, int64ToSqlValue, isInt64Tag, isSqlValue, sqlValueEquals, toArrayBuffer };
69
+
70
+ //# sourceMappingURL=sql-value.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"values/sql-value.js","sources":["../../src/values/sql-value.ts"],"sourcesContent":["import { G9SqliteError } from '../errors';\nimport { type G9Int64, isInt64, isSafeInt64, parseInt64 } from './int64';\n\n/** An int64 outside ±(2^53 − 1), tagged so it is never mistaken for text. */\nexport interface G9Int64Tag {\n readonly int64: G9Int64;\n}\n\n/**\n * A value crossing the driver boundary (plan/specs/05-Persistence.md §3). Integers inside ±(2^53 − 1) are plain\n * numbers (the fast path); larger ones are {@link G9Int64Tag}s. `null` is SQL NULL. A BLOB is an `ArrayBuffer`\n * (empty ≠ NULL ≠ empty text).\n */\nexport type G9SqlValue = null | number | string | ArrayBuffer | G9Int64Tag;\n\n/** `true` for a {@link G9Int64Tag}. */\nexport function isInt64Tag(value: unknown): value is G9Int64Tag {\n return (\n typeof value === 'object' &&\n value !== null &&\n !(value instanceof ArrayBuffer) &&\n isInt64((value as { int64?: unknown }).int64)\n );\n}\n\n/** `true` when `value` is a valid {@link G9SqlValue}. `NaN` is not (SQLite stores it as NULL, silently). */\nexport function isSqlValue(value: unknown): value is G9SqlValue {\n if (value === null || typeof value === 'string' || value instanceof ArrayBuffer) return true;\n if (typeof value === 'number') return !Number.isNaN(value);\n return isInt64Tag(value);\n}\n\n/**\n * The driver-boundary form of an int64: a plain number when safe, a tag otherwise. Accepts a canonical\n * {@link G9Int64}, any decimal integer string, or a safe integer.\n */\nexport function int64ToSqlValue(value: G9Int64 | string | number): number | G9Int64Tag {\n const canonical = parseInt64(value);\n return isSafeInt64(canonical) ? Number(canonical) : { int64: canonical };\n}\n\n/**\n * Reads an integer {@link G9SqlValue} as a canonical {@link G9Int64}. Throws `misuse` for anything that is not an\n * integer (a REAL with a fraction, text, a BLOB).\n */\nexport function int64FromSqlValue(value: G9SqlValue): G9Int64 {\n if (typeof value === 'number') {\n if (!Number.isSafeInteger(value)) {\n throw new G9SqliteError('misuse', `Value ${value} is not an exact integer.`);\n }\n return parseInt64(value);\n }\n if (isInt64Tag(value)) return value.int64;\n throw new G9SqliteError('misuse', `Expected an integer, got ${describeSqlValue(value)}.`);\n}\n\n/** Copies the bytes of a typed array or buffer into a standalone `ArrayBuffer`. */\nexport function toArrayBuffer(bytes: ArrayBuffer | ArrayBufferView): ArrayBuffer {\n if (bytes instanceof ArrayBuffer) return bytes;\n const copy = new Uint8Array(bytes.byteLength);\n copy.set(new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength));\n return copy.buffer;\n}\n\n/** A short, privacy-safe description of a value's kind for error messages. */\nexport function describeSqlValue(value: unknown): string {\n if (value === null) return 'NULL';\n if (value === undefined) return 'undefined';\n if (value instanceof ArrayBuffer) return `BLOB(${value.byteLength})`;\n if (isInt64Tag(value)) return 'INT64';\n if (typeof value === 'number') return Number.isInteger(value) ? 'INTEGER' : 'REAL';\n if (typeof value === 'string') return 'TEXT';\n return typeof value;\n}\n\nfunction bytesEqual(a: ArrayBuffer, b: ArrayBuffer): boolean {\n if (a.byteLength !== b.byteLength) return false;\n const x = new Uint8Array(a);\n const y = new Uint8Array(b);\n for (let i = 0; i < x.length; i++) if (x[i] !== y[i]) return false;\n return true;\n}\n\n/** Structural equality of two {@link G9SqlValue}s (BLOBs by bytes, int64 tags by value). */\nexport function sqlValueEquals(a: G9SqlValue, b: G9SqlValue): boolean {\n if (a instanceof ArrayBuffer || b instanceof ArrayBuffer) {\n return a instanceof ArrayBuffer && b instanceof ArrayBuffer && bytesEqual(a, b);\n }\n if (isInt64Tag(a) || isInt64Tag(b)) {\n return isInt64Tag(a) && isInt64Tag(b) && a.int64 === b.int64;\n }\n return Object.is(a, b) || a === b;\n}\n\nconst HEX = '0123456789abcdef';\n\n/** Lower-case hex of a BLOB (diagnostics and SQL literals). */\nexport function bytesToHex(bytes: ArrayBuffer): string {\n const view = new Uint8Array(bytes);\n let out = '';\n for (let i = 0; i < view.length; i++) {\n const b = view[i] as number;\n out += HEX[b >> 4] + (HEX[b & 15] as string);\n }\n return out;\n}\n\n/** Parses hex (any case, even length) into an `ArrayBuffer`. */\nexport function hexToBytes(hex: string): ArrayBuffer {\n if (hex.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(hex)) {\n throw new G9SqliteError('misuse', 'Hex text must have an even number of hex digits.');\n }\n const out = new Uint8Array(hex.length / 2);\n for (let i = 0; i < out.length; i++) out[i] = Number.parseInt(hex.substr(i * 2, 2), 16);\n return out.buffer;\n}\n"],"names":["isInt64Tag","value","ArrayBuffer","isInt64","isSqlValue","Number","int64ToSqlValue","canonical","parseInt64","isSafeInt64","int64FromSqlValue","G9SqliteError","describeSqlValue","toArrayBuffer","bytes","copy","Uint8Array","undefined","bytesEqual","a","b","x","y","i","sqlValueEquals","Object","HEX","bytesToHex","view","out","hexToBytes","hex"],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,27 @@
1
+ {
2
+ "name": "@g9tm/lynxcontrols-sqlite",
3
+ "version": "1.4.0",
4
+ "description": "SQLite persistence: lossless value codecs, driver contract, queries with C# null semantics, repositories, caches, migrations, interceptors, soft delete, filters. Drivers are separate packages.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "sideEffects": false,
8
+ "exports": {
9
+ ".": {
10
+ "source": "./src/index.ts",
11
+ "types": "./dist/index.d.ts",
12
+ "default": "./dist/index.js"
13
+ },
14
+ "./contract/cases.json": "./contract/cases.json"
15
+ },
16
+ "files": [
17
+ "dist",
18
+ "contract",
19
+ "README.md"
20
+ ],
21
+ "scripts": {
22
+ "build": "rslib build"
23
+ },
24
+ "dependencies": {
25
+ "@g9tm/lynxcontrols-foundation": "1.4.0"
26
+ }
27
+ }