@gusto/baerly-storage 0.3.0 → 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 (141) hide show
  1. package/README.md +157 -92
  2. package/dist/API.md +64 -32
  3. package/dist/CHANGELOG.md +295 -5
  4. package/dist/RECIPES.md +125 -0
  5. package/dist/THIRD-PARTY-LICENSES.txt +22 -96
  6. package/dist/{app-config-BIzyAKzy.d.ts → app-config-DyiFK3_k.d.ts} +43 -11
  7. package/dist/app-config.d.ts +1 -1
  8. package/dist/auth.d.ts +1 -1
  9. package/dist/auth.js +13 -13
  10. package/dist/auth.js.map +1 -1
  11. package/dist/aws4fetch.esm-p7eEzLCs.js +1702 -0
  12. package/dist/aws4fetch.esm-p7eEzLCs.js.map +1 -0
  13. package/dist/baerly.js +35 -15
  14. package/dist/baerly.js.map +1 -1
  15. package/dist/baerly.spec.json +342 -0
  16. package/dist/{client-BJXF3XJA.d.ts → client-Fe8CwB73.d.ts} +3 -3
  17. package/dist/client-react.d.ts +3 -3
  18. package/dist/client-react.js +4 -4
  19. package/dist/client-react.js.map +1 -1
  20. package/dist/client.d.ts +4 -4
  21. package/dist/client.js +3 -3
  22. package/dist/{cloudflare-Cn2ibODt.js → cloudflare-DzKBrUlg.js} +2 -2
  23. package/dist/{cloudflare-Cn2ibODt.js.map → cloudflare-DzKBrUlg.js.map} +1 -1
  24. package/dist/cloudflare.d.ts +49 -6
  25. package/dist/cloudflare.js +55 -21
  26. package/dist/cloudflare.js.map +1 -1
  27. package/dist/config-1tv0-Yzm.js +2693 -0
  28. package/dist/config-1tv0-Yzm.js.map +1 -0
  29. package/dist/constants-CfeMWQWk.js +222 -0
  30. package/dist/constants-CfeMWQWk.js.map +1 -0
  31. package/dist/{cost-BZ_MDBmn.js → cost-DSMIVqzL.js} +42 -43
  32. package/dist/cost-DSMIVqzL.js.map +1 -0
  33. package/dist/{current-json-DsN7FNY1.js → current-json-C6nhPOm1.js} +6 -204
  34. package/dist/current-json-C6nhPOm1.js.map +1 -0
  35. package/dist/{db-CCT6tDfY.d.ts → db-DsPkOVEH.d.ts} +3 -3
  36. package/dist/{deploy-BKKyGlSJ.js → deploy-DonTr-CV.js} +4 -4
  37. package/dist/{deploy-BKKyGlSJ.js.map → deploy-DonTr-CV.js.map} +1 -1
  38. package/dist/dev-vite.d.ts +9 -5
  39. package/dist/dev-vite.js +5 -4
  40. package/dist/dev-vite.js.map +1 -1
  41. package/dist/dev.d.ts +1 -1
  42. package/dist/dev.js +1 -1
  43. package/dist/{doctor-BVU4GNXN.js → doctor-DSIyCDg_.js} +5 -8
  44. package/dist/{doctor-BVU4GNXN.js.map → doctor-DSIyCDg_.js.map} +1 -1
  45. package/dist/{dump-DPEAKub6.js → dump-Bh5k26VQ.js} +9 -32
  46. package/dist/dump-Bh5k26VQ.js.map +1 -0
  47. package/dist/{errors-DOdL95kK.js → errors-Dfa3p78c.js} +25 -5
  48. package/dist/errors-Dfa3p78c.js.map +1 -0
  49. package/dist/{export-BcuCLFFe.js → export-DtF5tDIM.js} +9 -32
  50. package/dist/{export-BcuCLFFe.js.map → export-DtF5tDIM.js.map} +1 -1
  51. package/dist/{fsck-RXgLOaJG.js → fsck-D_djMO5D.js} +10 -33
  52. package/dist/fsck-D_djMO5D.js.map +1 -0
  53. package/dist/{http-Bd4byR4n.js → http-DxM9MflO.js} +123 -35
  54. package/dist/http-DxM9MflO.js.map +1 -0
  55. package/dist/http.d.ts +42 -26
  56. package/dist/http.js +3 -2
  57. package/dist/{index-DnBGSeuU.d.ts → index-0rZcMBwy.d.ts} +2 -2
  58. package/dist/{index-Cmsxx-ZN.d.ts → index-B6oexfOB.d.ts} +7 -7
  59. package/dist/{index-BDceQQi-.d.ts → index-BNRh23K9.d.ts} +4 -4
  60. package/dist/{index-DW7GT6M2.d.ts → index-BYk9oCNf.d.ts} +193 -163
  61. package/dist/index.d.ts +6 -6
  62. package/dist/index.js +4 -4
  63. package/dist/{indexes-Cx7uMXm0.d.ts → indexes-Dn9hbGQG.d.ts} +2 -2
  64. package/dist/{inspect-DhI49PSi.js → inspect-6WZ-pC7-.js} +10 -33
  65. package/dist/inspect-6WZ-pC7-.js.map +1 -0
  66. package/dist/key-Di6yyxFu.js +35 -0
  67. package/dist/key-Di6yyxFu.js.map +1 -0
  68. package/dist/{log-tail-DXeDkWEp.js → log-tail-D98U1JBo.js} +31 -7
  69. package/dist/log-tail-D98U1JBo.js.map +1 -0
  70. package/dist/{maintenance-CWBQpZ2y.js → maintenance-B4Dki6Ig.js} +77 -22
  71. package/dist/maintenance-B4Dki6Ig.js.map +1 -0
  72. package/dist/{maintenance-BkhUr72A.d.ts → maintenance-B_e0T99L.d.ts} +28 -5
  73. package/dist/{maintenance-C_KSkVjd.js → maintenance-C7coQp4c.js} +17 -16
  74. package/dist/maintenance-C7coQp4c.js.map +1 -0
  75. package/dist/maintenance.d.ts +3 -3
  76. package/dist/maintenance.js +3 -3
  77. package/dist/node.d.ts +168 -65
  78. package/dist/node.js +3 -2
  79. package/dist/{normalize-XWY25_sG.js → normalize-rjnZLwS4.js} +2 -2
  80. package/dist/normalize-rjnZLwS4.js.map +1 -0
  81. package/dist/{observability-BYd-RzEx.js → observability-wzs3-BL_.js} +233 -71
  82. package/dist/observability-wzs3-BL_.js.map +1 -0
  83. package/dist/observability.d.ts +2 -2
  84. package/dist/observability.js +1 -1
  85. package/dist/{plan-DIu_B6fy.js → plan-a7PJHBCy.js} +2 -2
  86. package/dist/{plan-DIu_B6fy.js.map → plan-a7PJHBCy.js.map} +1 -1
  87. package/dist/{query-sQNO5vU_.js → query-rAtXNQQB.js} +96 -207
  88. package/dist/query-rAtXNQQB.js.map +1 -0
  89. package/dist/{rebuild-index-DP4CqSSs.js → rebuild-index-BVzQSZlm.js} +9 -32
  90. package/dist/rebuild-index-BVzQSZlm.js.map +1 -0
  91. package/dist/{request-BEF_OvMh.js → request-u0M51mhJ.js} +3 -3
  92. package/dist/{request-BEF_OvMh.js.map → request-u0M51mhJ.js.map} +1 -1
  93. package/dist/{restore-DpQYef6r.js → restore-R-4rbciV.js} +73 -100
  94. package/dist/restore-R-4rbciV.js.map +1 -0
  95. package/dist/runtime-spec-qL3_lTTU.js +391 -0
  96. package/dist/runtime-spec-qL3_lTTU.js.map +1 -0
  97. package/dist/s3-http-B-z8th6O.d.ts +60 -0
  98. package/dist/s3.d.ts +47 -0
  99. package/dist/s3.js +45 -0
  100. package/dist/s3.js.map +1 -0
  101. package/dist/{shared-secret-BJdSwpgw.js → shared-secret-DgEicd3x.js} +13 -5
  102. package/dist/shared-secret-DgEicd3x.js.map +1 -0
  103. package/dist/src-BG20LZs7.js +2271 -0
  104. package/dist/src-BG20LZs7.js.map +1 -0
  105. package/dist/{src-Db4-qVtM.js → src-CYHFDrKz.js} +51 -8
  106. package/dist/src-CYHFDrKz.js.map +1 -0
  107. package/dist/{src-CWpkSbvJ.js → src-DYZ4H1aF.js} +6 -5
  108. package/dist/src-DYZ4H1aF.js.map +1 -0
  109. package/dist/{subcommand-CP9NY2J4.js → subcommand-DoDA-K7d.js} +44 -6
  110. package/dist/subcommand-DoDA-K7d.js.map +1 -0
  111. package/dist/time-DUqvFMHq.js +119 -0
  112. package/dist/time-DUqvFMHq.js.map +1 -0
  113. package/dist/{usage-CTfDq9HR.js → usage-DBV1eQHC.js} +7 -22
  114. package/dist/usage-DBV1eQHC.js.map +1 -0
  115. package/dist/wire-izfGZDvr.js.map +1 -1
  116. package/package.json +52 -28
  117. package/dist/config-CGyBopy3.js +0 -5326
  118. package/dist/config-CGyBopy3.js.map +0 -1
  119. package/dist/cost-BZ_MDBmn.js.map +0 -1
  120. package/dist/current-json-DsN7FNY1.js.map +0 -1
  121. package/dist/dump-DPEAKub6.js.map +0 -1
  122. package/dist/errors-DOdL95kK.js.map +0 -1
  123. package/dist/fsck-RXgLOaJG.js.map +0 -1
  124. package/dist/http-Bd4byR4n.js.map +0 -1
  125. package/dist/inspect-DhI49PSi.js.map +0 -1
  126. package/dist/log-tail-DXeDkWEp.js.map +0 -1
  127. package/dist/maintenance-CWBQpZ2y.js.map +0 -1
  128. package/dist/maintenance-C_KSkVjd.js.map +0 -1
  129. package/dist/normalize-XWY25_sG.js.map +0 -1
  130. package/dist/observability-BYd-RzEx.js.map +0 -1
  131. package/dist/query-sQNO5vU_.js.map +0 -1
  132. package/dist/rebuild-index-DP4CqSSs.js.map +0 -1
  133. package/dist/restore-DpQYef6r.js.map +0 -1
  134. package/dist/shared-secret-BJdSwpgw.js.map +0 -1
  135. package/dist/src-CWpkSbvJ.js.map +0 -1
  136. package/dist/src-D24wDpzR.js +0 -6247
  137. package/dist/src-D24wDpzR.js.map +0 -1
  138. package/dist/src-Db4-qVtM.js.map +0 -1
  139. package/dist/subcommand-CP9NY2J4.js.map +0 -1
  140. package/dist/usage-CTfDq9HR.js.map +0 -1
  141. /package/dist/{chunk-EAsCxrDo.js → rolldown-runtime-EAsCxrDo.js} +0 -0
package/package.json CHANGED
@@ -1,18 +1,22 @@
1
1
  {
2
2
  "name": "@gusto/baerly-storage",
3
- "version": "0.3.0",
4
- "description": "Vendorless document database that runs over any S3-compatible storage API.",
3
+ "version": "0.4.0",
4
+ "description": "Document database for S3 and Cloudflare R2 that runs in your request handler — tiny, LLM-friendly TypeScript API, no database server",
5
5
  "keywords": [
6
+ "append-only-log",
7
+ "aws-s3",
6
8
  "cloudflare-workers",
7
- "database",
9
+ "content-addressable-storage",
8
10
  "document-database",
9
- "edge",
11
+ "edge-computing",
10
12
  "http-api",
13
+ "minio",
14
+ "multi-tenant",
11
15
  "nosql",
16
+ "object-storage",
12
17
  "r2",
13
18
  "s3",
14
19
  "s3-compatible",
15
- "self-hosted",
16
20
  "serverless",
17
21
  "typescript"
18
22
  ],
@@ -56,6 +60,10 @@
56
60
  "types": "./dist/node.d.ts",
57
61
  "import": "./dist/node.js"
58
62
  },
63
+ "./s3": {
64
+ "types": "./dist/s3.d.ts",
65
+ "import": "./dist/s3.js"
66
+ },
59
67
  "./maintenance": {
60
68
  "types": "./dist/maintenance.d.ts",
61
69
  "import": "./dist/maintenance.js"
@@ -89,32 +97,36 @@
89
97
  "access": "public"
90
98
  },
91
99
  "dependencies": {
92
- "@logtape/logtape": "2.1.3"
100
+ "@logtape/logtape": "2.2.2"
93
101
  },
94
102
  "devDependencies": {
103
+ "@arethetypeswrong/cli": "^0.18.4",
95
104
  "@changesets/cli": "^2.31.0",
96
105
  "@cloudflare/vitest-pool-workers": "0.16.14",
97
- "@cloudflare/workers-types": "^4.20260610.1",
106
+ "@cloudflare/workers-types": "^4.20260630.1",
98
107
  "@fast-check/vitest": "^0.4.1",
99
- "@hono/node-server": "^2.0.4",
108
+ "@hono/node-server": "^2.0.6",
100
109
  "@stryker-mutator/core": "9.6.1",
101
110
  "@stryker-mutator/vitest-runner": "9.6.1",
102
111
  "@testing-library/react": "^16.3.2",
103
- "@types/node": "^25.9.2",
112
+ "@types/node": "^26.0.1",
104
113
  "@types/pg": "^8.20.0",
105
114
  "@types/react": "^19.2.17",
106
115
  "@types/react-dom": "^19.2.3",
107
116
  "@typescript/native-preview": "7.0.0-dev.20260610.1",
108
117
  "@vitest/coverage-v8": "^4.1.8",
118
+ "ajv": "^8.20.0",
109
119
  "aws4fetch": "1.0.20",
110
120
  "esbuild": "^0.28.1",
111
121
  "execa": "^9.6.1",
112
122
  "fast-check": "^4.8.0",
113
- "happy-dom": "^20.10.2",
123
+ "happy-dom": "^20.10.6",
114
124
  "lefthook": "^2.1.9",
125
+ "mermaid": "^11.15.0",
115
126
  "oxfmt": "^0.54.0",
116
127
  "oxlint": "^1.69.0",
117
128
  "pg": "^8.21.0",
129
+ "publint": "^0.3.21",
118
130
  "react": "^19.2.7",
119
131
  "react-dom": "^19.2.7",
120
132
  "remark-cli": "^12.0.1",
@@ -123,15 +135,15 @@
123
135
  "rolldown": "^1.1.0",
124
136
  "rolldown-plugin-dts": "^0.25.2",
125
137
  "rollup-license-plugin": "3.2.1",
126
- "vite": "^8.0.16",
127
- "vitest": "^4.1.8",
138
+ "vite": "^8.1.2",
139
+ "vitest": "^4.1.9",
128
140
  "yaml": "2.9.0",
129
- "@baerly/adapter-node": "0.1.0",
130
141
  "@baerly/adapter-cloudflare": "0.1.0",
131
- "@baerly/protocol": "0.1.0",
132
- "@baerly/dev": "0.1.0",
142
+ "@baerly/adapter-node": "0.1.0",
133
143
  "@baerly/client": "0.1.0",
134
- "@baerly/server": "0.1.0"
144
+ "@baerly/dev": "0.1.0",
145
+ "@baerly/server": "0.1.0",
146
+ "@baerly/protocol": "0.1.0"
135
147
  },
136
148
  "peerDependencies": {
137
149
  "@cloudflare/workers-types": "^4",
@@ -154,7 +166,7 @@
154
166
  },
155
167
  "scripts": {
156
168
  "typecheck": "tsgo --noEmit",
157
- "pretest": "pnpm run build",
169
+ "pretest": "node scripts/build-if-needed.mjs",
158
170
  "test": "vitest run --project=default",
159
171
  "test:agent": "vitest run --project=default --reporter=minimal --silent=passed-only",
160
172
  "test:one": "pnpm run build && vitest run --project=default",
@@ -168,31 +180,40 @@
168
180
  "release": "node scripts/publish.mjs",
169
181
  "changeset": "changeset",
170
182
  "changeset:version": "changeset version && rm -f packages/create-baerly-storage/CHANGELOG.md",
171
- "format": "oxfmt tests packages",
172
- "format:check": "oxfmt --check tests packages",
183
+ "format": "oxfmt .",
184
+ "format:check": "oxfmt --check .",
173
185
  "lint": "oxlint tests packages",
174
186
  "test:randomize": "FC_NUM_RUNS=10000 vitest run --project=default",
175
- "test:fuzz-phase5": "FC_NUM_RUNS=10000 vitest run --project=default tests/integration/phase5-crash-fuzz.test.ts",
187
+ "test:fuzz-maintenance": "FC_NUM_RUNS=10000 vitest run --project=default tests/integration/maintenance-crash-fuzz.test.ts",
176
188
  "test:adapter-cloudflare": "ADAPTER_CLOUDFLARE=1 vitest run --project=cloudflare-pool",
177
189
  "test:http-conformance": "vitest run --project=default tests/integration/http-conformance.test.ts",
178
190
  "test:adapter-node": "MINIO=1 vitest run --project=default packages/adapter-node",
179
191
  "test:adapters": "pnpm test:adapter-cloudflare && pnpm test:adapter-node",
192
+ "test:parity": "vitest run --project=default packages/protocol/src/storage/memory.test.ts packages/dev/src/local-fs.test.ts packages/adapter-node/src/s3-http.conformance.test.ts tests/integration/collection-api.test.ts tests/integration/randomized.test.ts",
180
193
  "test:manual-e2e": "vitest run --project=default manual-e2e/cloudflare/e2e.test.ts manual-e2e/node/e2e.test.ts",
181
194
  "test:mutate": "stryker run",
182
195
  "mutate:survivors": "node scripts/mutation-survivors.mjs",
183
196
  "test:coverage:protocol": "vitest run --config stryker.vitest.config.ts --coverage --coverage.provider=v8 --coverage.include='packages/protocol/src/**/*.ts' --coverage.exclude='**/*.test.ts' --coverage.exclude='**/*.test-d.ts' --coverage.exclude='**/index.ts'",
184
197
  "gate:day-one": "vitest run --project=default tests/integration/day-one-handshake.test.ts",
198
+ "gen:spec": "node scripts/gen-spec.ts",
199
+ "gen:version-matrix": "node scripts/check-version-matrix.ts --write",
185
200
  "bundle-sizes": "node scripts/bundle-sizes.mjs",
186
- "verify": "pnpm run typecheck && pnpm run verify:examples && pnpm run lint && pnpm run format:check && node scripts/add-ts-extensions.mjs --check && node scripts/lint-use-query.mjs && node scripts/lint-package-layers.mjs && pnpm run verify:docs",
187
- "verify:agent": "tsgo --noEmit --pretty false && pnpm run verify:examples && oxlint --format=unix --quiet tests packages && pnpm run format:check && node scripts/add-ts-extensions.mjs --check && node scripts/lint-use-query.mjs && node scripts/lint-package-layers.mjs && pnpm run verify:docs",
188
- "verify:docs": "node scripts/verify-docs.mjs && remark docs --quiet --frail --no-stdout",
189
- "verify:doc-links": "remark docs --quiet --frail --no-stdout",
201
+ "check:exports": "node scripts/check-exports.mjs",
202
+ "check:publint": "node scripts/check-publint.mjs",
203
+ "verify:package": "node scripts/build-if-needed.mjs && BAERLY_SKIP_BUILD=1 pnpm run check:exports && BAERLY_SKIP_BUILD=1 pnpm run check:publint",
204
+ "verify:rest": "pnpm run verify:examples && pnpm run format:check && node scripts/add-ts-extensions.mjs --check && node scripts/lint-use-query.mjs && node scripts/lint-package-layers.mjs && node scripts/lint-format-coverage.mjs && node scripts/check-spec-drift.ts && node scripts/check-version-matrix.ts",
205
+ "verify:code": "pnpm run typecheck && pnpm run lint && pnpm run verify:rest",
206
+ "verify": "pnpm run verify:code && pnpm run verify:docs",
207
+ "verify:agent": "tsgo --noEmit --pretty false && oxlint --format=unix --quiet tests packages && pnpm run verify:rest && pnpm run verify:docs",
208
+ "verify:spec": "node scripts/check-spec-drift.ts",
209
+ "verify:version-matrix": "node scripts/check-version-matrix.ts",
210
+ "verify:docs": "node scripts/verify-docs.mjs && node scripts/verify-docs-taxonomy.mjs && remark . --quiet --frail --no-stdout && node scripts/verify-mermaid.mjs",
211
+ "verify:doc-taxonomy": "node scripts/verify-docs-taxonomy.mjs",
212
+ "verify:doc-links": "remark . --quiet --frail --no-stdout",
213
+ "verify:mermaid": "node scripts/verify-mermaid.mjs",
190
214
  "verify:examples": "pnpm --filter minimal-cloudflare typecheck && pnpm --filter minimal-node typecheck && pnpm --filter react-cloudflare typecheck && pnpm --filter react-node typecheck",
191
215
  "dev:storage": "docker compose up -d --wait",
192
216
  "dev:storage:stop": "docker compose down",
193
- "verdaccio:reset": "./scripts/verdaccio-reset.sh",
194
- "verdaccio:publish": "node scripts/verdaccio-publish.mjs",
195
- "dlx:bust-cache": "node scripts/dlx-bust-cache.mjs",
196
217
  "worktree:bootstrap": "node scripts/worktree-bootstrap.mjs",
197
218
  "bench:r2": "node --import ./bench/register-hooks.mjs bench/r2-contention.ts",
198
219
  "bench:r2:matrix": "node --import ./bench/register-hooks.mjs bench/r2-contention-matrix.ts",
@@ -202,6 +223,9 @@
202
223
  "bench:load:matrix": "node --import ./bench/register-hooks.mjs bench/load-harness/matrix.ts",
203
224
  "bench:lsn-reverse-walk": "node --import ./bench/register-hooks.mjs bench/lsn-reverse-walk.ts",
204
225
  "bench:fold-cost": "node --import ./bench/register-hooks.mjs bench/fold-cost.ts",
205
- "bench:maintenance-backlog": "node --import ./bench/register-hooks.mjs bench/maintenance-backlog.ts"
226
+ "bench:maintenance-backlog": "node --import ./bench/register-hooks.mjs bench/maintenance-backlog.ts",
227
+ "bench:amortized-write-cost": "node --import ./bench/register-hooks.mjs bench/amortized-write-cost.ts",
228
+ "bench:write-amp-stress": "node --import ./bench/register-hooks.mjs bench/write-amp-stress.ts",
229
+ "bench:collection-fanout": "node --import ./bench/register-hooks.mjs bench/collection-fanout.ts"
206
230
  }
207
231
  }