@hraness/oh 0.3.1 → 0.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 (72) hide show
  1. package/README.md +194 -127
  2. package/dist/cli.d.ts +1 -1
  3. package/dist/cli.d.ts.map +1 -1
  4. package/dist/cli.js +811 -97
  5. package/dist/errors.d.ts +39 -0
  6. package/dist/errors.d.ts.map +1 -0
  7. package/dist/graph.d.ts.map +1 -1
  8. package/dist/index.js +676 -61
  9. package/dist/libsql-semantic-v2.d.ts +160 -0
  10. package/dist/libsql-semantic-v2.d.ts.map +1 -0
  11. package/dist/libsql.d.ts.map +1 -1
  12. package/dist/libsql.js +162 -35
  13. package/dist/memory-page.js +2 -2
  14. package/dist/memory.d.ts +87 -6
  15. package/dist/memory.d.ts.map +1 -1
  16. package/dist/memory.js +1106 -148
  17. package/dist/operation.d.ts +3 -1
  18. package/dist/operation.d.ts.map +1 -1
  19. package/dist/projection-public.js +2 -2
  20. package/dist/projection-suss.js +2 -2
  21. package/dist/sdk.js +780 -88
  22. package/dist/semantic-cloud.d.ts +1 -0
  23. package/dist/semantic-cloud.d.ts.map +1 -1
  24. package/dist/semantic-cloud.js +1545 -2
  25. package/dist/semantic.js +2 -2
  26. package/dist/sqlite/index.js +1251 -306
  27. package/dist/sqlite/port.d.ts +31 -3
  28. package/dist/sqlite/port.d.ts.map +1 -1
  29. package/dist/sqlite/store.d.ts +18 -2
  30. package/dist/sqlite/store.d.ts.map +1 -1
  31. package/dist/store.d.ts +3 -12
  32. package/dist/store.d.ts.map +1 -1
  33. package/dist/store.js +154 -32
  34. package/dist/sync.d.ts +7 -1
  35. package/dist/sync.d.ts.map +1 -1
  36. package/dist/sync.js +668 -35
  37. package/package.json +5 -1
  38. package/skills/oh/SKILL.md +42 -16
  39. package/spec/README.md +10 -3
  40. package/spec/manifest.json +5 -1
  41. package/spec/v1/libsql-semantic-cache-schema-v1.sql +114 -0
  42. package/spec/v1/libsql-semantic-digest-fixture-v1.json +13 -0
  43. package/spec/v1/memory.md +134 -16
  44. package/spec/v1/storage.md +8 -5
  45. package/spec/v1/store.md +20 -0
  46. package/spec/v1/sync.md +77 -8
  47. package/spec/v2/libsql-semantic-cache-schema-v2.sql +175 -0
  48. package/spec/v2/libsql-semantic-digest-fixture-v2.json +14 -0
  49. package/spec/v2/manifest.json +11 -0
  50. package/spec/v2/semantic-cloud.md +106 -0
  51. package/src/cli.test.ts +53 -1
  52. package/src/cli.ts +34 -8
  53. package/src/errors.test.ts +87 -0
  54. package/src/errors.ts +185 -0
  55. package/src/graph.ts +2 -2
  56. package/src/libsql-semantic-v2.test.ts +1114 -0
  57. package/src/libsql-semantic-v2.ts +1891 -0
  58. package/src/libsql-semantic.test.ts +50 -1
  59. package/src/libsql.test.ts +36 -0
  60. package/src/libsql.ts +26 -5
  61. package/src/memory.test.ts +1488 -18
  62. package/src/memory.ts +1199 -122
  63. package/src/operation.ts +13 -3
  64. package/src/semantic-cloud.ts +1 -0
  65. package/src/sqlite/port.test.ts +209 -0
  66. package/src/sqlite/port.ts +118 -4
  67. package/src/sqlite/store.test.ts +106 -1
  68. package/src/sqlite/store.ts +168 -30
  69. package/src/store.test.ts +12 -0
  70. package/src/store.ts +30 -20
  71. package/src/sync.test.ts +570 -2
  72. package/src/sync.ts +586 -36
@@ -0,0 +1,39 @@
1
+ export declare const OH_OPERATION_SIZE_ERROR_CODE_V1: "oh.operation-size.v1";
2
+ /** Recognizes a compare-and-swap conflict across separately bundled Oh entrypoints. */
3
+ export declare function isOhConflictError(value: unknown): value is OhConflictError;
4
+ export declare class OhConflictError extends Error {
5
+ static [Symbol.hasInstance](value: unknown): boolean;
6
+ constructor(message: string);
7
+ }
8
+ /** Recognizes an authority-integrity failure across separately bundled Oh entrypoints. */
9
+ export declare function isOhIntegrityError(value: unknown): value is OhIntegrityError;
10
+ export declare class OhIntegrityError extends Error {
11
+ static [Symbol.hasInstance](value: unknown): boolean;
12
+ constructor(message: string);
13
+ }
14
+ /** Recognizes a missing-dependency failure across separately bundled Oh entrypoints. */
15
+ export declare function isOhDependencyError(value: unknown): value is OhDependencyError;
16
+ export declare class OhDependencyError extends Error {
17
+ static [Symbol.hasInstance](value: unknown): boolean;
18
+ constructor(message: string);
19
+ }
20
+ /** Recognizes a store-profile refusal across separately bundled Oh entrypoints. */
21
+ export declare function isOhProfileError(value: unknown): value is OhProfileError;
22
+ export declare class OhProfileError extends Error {
23
+ static [Symbol.hasInstance](value: unknown): boolean;
24
+ constructor(message: string);
25
+ }
26
+ /**
27
+ * Recognizes this precommit refusal across separately bundled Oh entrypoints.
28
+ * Native Error identity plus immutable branded fields excludes copied plain
29
+ * objects while preserving one stable discriminator for package consumers.
30
+ */
31
+ export declare function isOhOperationSizeError(value: unknown): value is OhOperationSizeError;
32
+ export declare class OhOperationSizeError extends RangeError {
33
+ readonly code: typeof OH_OPERATION_SIZE_ERROR_CODE_V1;
34
+ readonly maximumOperationBytes: number;
35
+ readonly operationBytes: number;
36
+ static [Symbol.hasInstance](value: unknown): boolean;
37
+ constructor(operationBytes: number, maximumOperationBytes: number);
38
+ }
39
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,EAAG,sBAA+B,CAAC;AAwC/E,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,qBAAa,eAAgB,SAAQ,KAAK;WACxB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;gBAMjD,OAAO,EAAE,MAAM;CAK5B;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;WACzB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;gBAMjD,OAAO,EAAE,MAAM;CAK5B;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,qBAAa,iBAAkB,SAAQ,KAAK;WAC1B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;gBAMjD,OAAO,EAAE,MAAM;CAK5B;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,qBAAa,cAAe,SAAQ,KAAK;WACvB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;gBAMjD,OAAO,EAAE,MAAM;CAK5B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAepF;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,SAAiB,IAAI,EAAE,OAAO,+BAA+B,CAAC;IAC9D,SAAiB,qBAAqB,EAAE,MAAM,CAAC;IAC/C,SAAiB,cAAc,EAAE,MAAM,CAAC;WAExB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;gBAMjD,cAAc,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM;CAmClE"}
@@ -1 +1 @@
1
- {"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}