@functional-systems/memdrive 0.1.1-dev.1 → 0.1.1-dev.3

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 (117) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +20 -250
  3. package/dist/commonjs/chunking.d.ts +1 -2
  4. package/dist/commonjs/chunking.d.ts.map +1 -1
  5. package/dist/commonjs/chunking.js +2 -5
  6. package/dist/commonjs/chunking.js.map +1 -1
  7. package/dist/commonjs/config.d.ts +17 -0
  8. package/dist/commonjs/config.d.ts.map +1 -0
  9. package/dist/commonjs/config.js +116 -0
  10. package/dist/commonjs/config.js.map +1 -0
  11. package/dist/commonjs/errors.d.ts +10 -6
  12. package/dist/commonjs/errors.d.ts.map +1 -1
  13. package/dist/commonjs/errors.js +25 -5
  14. package/dist/commonjs/errors.js.map +1 -1
  15. package/dist/commonjs/index.d.ts +15 -5
  16. package/dist/commonjs/index.d.ts.map +1 -1
  17. package/dist/commonjs/index.js +331 -307
  18. package/dist/commonjs/index.js.map +1 -1
  19. package/dist/commonjs/records.d.ts +44 -0
  20. package/dist/commonjs/records.d.ts.map +1 -0
  21. package/dist/commonjs/records.js +88 -0
  22. package/dist/commonjs/records.js.map +1 -0
  23. package/dist/commonjs/search.d.ts +8 -0
  24. package/dist/commonjs/search.d.ts.map +1 -0
  25. package/dist/commonjs/search.js +56 -0
  26. package/dist/commonjs/search.js.map +1 -0
  27. package/dist/commonjs/types.d.ts +84 -252
  28. package/dist/commonjs/types.d.ts.map +1 -1
  29. package/dist/esm/chunking.d.ts +1 -2
  30. package/dist/esm/chunking.d.ts.map +1 -1
  31. package/dist/esm/chunking.js +2 -4
  32. package/dist/esm/chunking.js.map +1 -1
  33. package/dist/esm/config.d.ts +17 -0
  34. package/dist/esm/config.d.ts.map +1 -0
  35. package/dist/esm/config.js +107 -0
  36. package/dist/esm/config.js.map +1 -0
  37. package/dist/esm/errors.d.ts +10 -6
  38. package/dist/esm/errors.d.ts.map +1 -1
  39. package/dist/esm/errors.js +22 -4
  40. package/dist/esm/errors.js.map +1 -1
  41. package/dist/esm/index.d.ts +15 -5
  42. package/dist/esm/index.d.ts.map +1 -1
  43. package/dist/esm/index.js +331 -305
  44. package/dist/esm/index.js.map +1 -1
  45. package/dist/esm/records.d.ts +44 -0
  46. package/dist/esm/records.d.ts.map +1 -0
  47. package/dist/esm/records.js +77 -0
  48. package/dist/esm/records.js.map +1 -0
  49. package/dist/esm/search.d.ts +8 -0
  50. package/dist/esm/search.d.ts.map +1 -0
  51. package/dist/esm/search.js +52 -0
  52. package/dist/esm/search.js.map +1 -0
  53. package/dist/esm/types.d.ts +84 -252
  54. package/dist/esm/types.d.ts.map +1 -1
  55. package/package.json +10 -32
  56. package/src/chunking.ts +2 -3
  57. package/src/config.ts +121 -0
  58. package/src/errors.ts +20 -6
  59. package/src/index.ts +351 -289
  60. package/src/records.ts +83 -0
  61. package/src/search.ts +57 -0
  62. package/src/types.ts +74 -253
  63. package/dist/commonjs/filter.d.ts +0 -30
  64. package/dist/commonjs/filter.d.ts.map +0 -1
  65. package/dist/commonjs/filter.js +0 -224
  66. package/dist/commonjs/filter.js.map +0 -1
  67. package/dist/commonjs/storage.d.ts +0 -274
  68. package/dist/commonjs/storage.d.ts.map +0 -1
  69. package/dist/commonjs/storage.js +0 -861
  70. package/dist/commonjs/storage.js.map +0 -1
  71. package/dist/commonjs/tools/definitions.d.ts +0 -5
  72. package/dist/commonjs/tools/definitions.d.ts.map +0 -1
  73. package/dist/commonjs/tools/definitions.js +0 -129
  74. package/dist/commonjs/tools/definitions.js.map +0 -1
  75. package/dist/commonjs/tools/index.d.ts +0 -6
  76. package/dist/commonjs/tools/index.d.ts.map +0 -1
  77. package/dist/commonjs/tools/index.js +0 -104
  78. package/dist/commonjs/tools/index.js.map +0 -1
  79. package/dist/commonjs/tools/types.d.ts +0 -50
  80. package/dist/commonjs/tools/types.d.ts.map +0 -1
  81. package/dist/commonjs/tools/types.js +0 -3
  82. package/dist/commonjs/tools/types.js.map +0 -1
  83. package/dist/commonjs/values.d.ts +0 -17
  84. package/dist/commonjs/values.d.ts.map +0 -1
  85. package/dist/commonjs/values.js +0 -90
  86. package/dist/commonjs/values.js.map +0 -1
  87. package/dist/esm/filter.d.ts +0 -30
  88. package/dist/esm/filter.d.ts.map +0 -1
  89. package/dist/esm/filter.js +0 -209
  90. package/dist/esm/filter.js.map +0 -1
  91. package/dist/esm/storage.d.ts +0 -274
  92. package/dist/esm/storage.d.ts.map +0 -1
  93. package/dist/esm/storage.js +0 -845
  94. package/dist/esm/storage.js.map +0 -1
  95. package/dist/esm/tools/definitions.d.ts +0 -5
  96. package/dist/esm/tools/definitions.d.ts.map +0 -1
  97. package/dist/esm/tools/definitions.js +0 -126
  98. package/dist/esm/tools/definitions.js.map +0 -1
  99. package/dist/esm/tools/index.d.ts +0 -6
  100. package/dist/esm/tools/index.d.ts.map +0 -1
  101. package/dist/esm/tools/index.js +0 -101
  102. package/dist/esm/tools/index.js.map +0 -1
  103. package/dist/esm/tools/types.d.ts +0 -50
  104. package/dist/esm/tools/types.d.ts.map +0 -1
  105. package/dist/esm/tools/types.js +0 -2
  106. package/dist/esm/tools/types.js.map +0 -1
  107. package/dist/esm/values.d.ts +0 -17
  108. package/dist/esm/values.d.ts.map +0 -1
  109. package/dist/esm/values.js +0 -87
  110. package/dist/esm/values.js.map +0 -1
  111. package/docs/tools.md +0 -163
  112. package/src/filter.ts +0 -189
  113. package/src/storage.ts +0 -765
  114. package/src/tools/definitions.ts +0 -156
  115. package/src/tools/index.ts +0 -97
  116. package/src/tools/types.ts +0 -45
  117. package/src/values.ts +0 -103
package/src/errors.ts CHANGED
@@ -1,16 +1,14 @@
1
- import type { RequestOptions, Usage } from './types.js';
1
+ import type { RequestOptions } from './types.js';
2
2
 
3
3
  export class MemDriveError extends Error {
4
4
  declare code: string;
5
- declare details?: Record<string, unknown> | undefined;
6
- declare usage?: Usage | undefined;
5
+ declare readonly details?: Record<string, unknown> | undefined;
7
6
  declare status?: number | undefined;
8
- constructor(code: string, message: string, { cause, details, usage }: { cause?: unknown; details?: Record<string, unknown> | undefined; usage?: Usage | undefined } = {}) {
7
+ constructor(code: string, message: string, { cause, details }: { cause?: unknown; details?: Record<string, unknown> | undefined } = {}) {
9
8
  super(message, cause === undefined ? undefined : { cause });
10
9
  this.name = 'MemDriveError';
11
10
  this.code = code;
12
11
  if (details !== undefined) this.details = details;
13
- if (usage !== undefined) this.usage = usage;
14
12
  }
15
13
  }
16
14
 
@@ -32,9 +30,25 @@ export function checkAbort(signal?: AbortSignal) {
32
30
  if (signal?.aborted) throw new MemDriveError('ABORTED', 'Operation aborted.');
33
31
  }
34
32
 
35
- export function abortError(cause: unknown, signal?: AbortSignal): unknown {
33
+ function abortError(cause: unknown, signal?: AbortSignal): unknown {
36
34
  const error = cause as { code?: string; name?: string } | undefined;
37
35
  if (error?.code === 'ABORTED') return cause;
38
36
  return signal?.aborted || error?.name === 'AbortError'
39
37
  ? new MemDriveError('ABORTED', 'Operation aborted.', { cause }) : cause;
40
38
  }
39
+
40
+ export function databaseError(error: unknown, message: string): MemDriveError {
41
+ if (error instanceof MemDriveError) return error;
42
+ const result = new MemDriveError('DATABASE_ERROR', message, { cause: error });
43
+ const remote = error as { statusCode?: unknown; status?: unknown; httpStatus?: unknown } | null | undefined;
44
+ const status = remote?.statusCode ?? remote?.status ?? remote?.httpStatus;
45
+ if (typeof status === 'number' && Number.isInteger(status)) result.status = status;
46
+ return result;
47
+ }
48
+
49
+ export async function nativeRequest<T>(operation: () => Promise<T>, signal?: AbortSignal): Promise<T> {
50
+ checkAbort(signal);
51
+ try { return await operation(); }
52
+ catch (cause) { throw abortError(cause, signal); }
53
+ }
54
+ export const nativeOptions = (signal?: AbortSignal) => signal === undefined ? {} : { signal };