@c9up/archive 0.1.19 → 0.1.21

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 (87) hide show
  1. package/README.md +96 -3
  2. package/dist/ArchiveProvider.d.ts +8 -2
  3. package/dist/ArchiveProvider.d.ts.map +1 -1
  4. package/dist/ArchiveProvider.js +73 -1
  5. package/dist/ArchiveProvider.js.map +1 -1
  6. package/dist/DriveManager.d.ts +16 -6
  7. package/dist/DriveManager.d.ts.map +1 -1
  8. package/dist/DriveManager.js +23 -6
  9. package/dist/DriveManager.js.map +1 -1
  10. package/dist/GcsDriver.d.ts +14 -9
  11. package/dist/GcsDriver.d.ts.map +1 -1
  12. package/dist/GcsDriver.js +202 -98
  13. package/dist/GcsDriver.js.map +1 -1
  14. package/dist/S3Driver.d.ts +11 -7
  15. package/dist/S3Driver.d.ts.map +1 -1
  16. package/dist/S3Driver.js +73 -110
  17. package/dist/S3Driver.js.map +1 -1
  18. package/dist/StaticMiddleware.d.ts +5 -1
  19. package/dist/StaticMiddleware.d.ts.map +1 -1
  20. package/dist/StaticMiddleware.js +114 -13
  21. package/dist/StaticMiddleware.js.map +1 -1
  22. package/dist/StorageManager.d.ts +36 -4
  23. package/dist/StorageManager.d.ts.map +1 -1
  24. package/dist/StorageManager.js +360 -137
  25. package/dist/StorageManager.js.map +1 -1
  26. package/dist/augmentations.d.ts +17 -0
  27. package/dist/augmentations.d.ts.map +1 -1
  28. package/dist/errno.d.ts +6 -0
  29. package/dist/errno.d.ts.map +1 -0
  30. package/dist/errno.js +11 -0
  31. package/dist/errno.js.map +1 -0
  32. package/dist/index.d.ts +2 -1
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js.map +1 -1
  35. package/dist/keys.d.ts +34 -0
  36. package/dist/keys.d.ts.map +1 -0
  37. package/dist/keys.js +88 -0
  38. package/dist/keys.js.map +1 -0
  39. package/dist/local-signature.d.ts +32 -0
  40. package/dist/local-signature.d.ts.map +1 -0
  41. package/dist/local-signature.js +58 -0
  42. package/dist/local-signature.js.map +1 -0
  43. package/dist/move-to-disk.d.ts +24 -0
  44. package/dist/move-to-disk.d.ts.map +1 -0
  45. package/dist/move-to-disk.js +167 -0
  46. package/dist/move-to-disk.js.map +1 -0
  47. package/dist/objects.d.ts.map +1 -1
  48. package/dist/objects.js +5 -2
  49. package/dist/objects.js.map +1 -1
  50. package/dist/provider-fetch.d.ts +36 -0
  51. package/dist/provider-fetch.d.ts.map +1 -0
  52. package/dist/provider-fetch.js +158 -0
  53. package/dist/provider-fetch.js.map +1 -0
  54. package/dist/services/main.d.ts +1 -1
  55. package/dist/services/main.d.ts.map +1 -1
  56. package/dist/services/main.js +14 -1
  57. package/dist/services/main.js.map +1 -1
  58. package/dist/signed-route.d.ts +18 -6
  59. package/dist/signed-route.d.ts.map +1 -1
  60. package/dist/signed-route.js +186 -31
  61. package/dist/signed-route.js.map +1 -1
  62. package/dist/streams.d.ts +36 -0
  63. package/dist/streams.d.ts.map +1 -0
  64. package/dist/streams.js +108 -0
  65. package/dist/streams.js.map +1 -0
  66. package/dist/testing/FakeStorage.d.ts.map +1 -1
  67. package/dist/testing/FakeStorage.js +2 -1
  68. package/dist/testing/FakeStorage.js.map +1 -1
  69. package/package.json +7 -3
  70. package/src/ArchiveProvider.ts +106 -4
  71. package/src/DriveManager.ts +38 -8
  72. package/src/GcsDriver.ts +256 -139
  73. package/src/S3Driver.ts +87 -130
  74. package/src/StaticMiddleware.ts +124 -13
  75. package/src/StorageManager.ts +433 -147
  76. package/src/augmentations.ts +24 -1
  77. package/src/errno.ts +10 -0
  78. package/src/index.ts +2 -0
  79. package/src/keys.ts +104 -0
  80. package/src/local-signature.ts +76 -0
  81. package/src/move-to-disk.ts +234 -0
  82. package/src/objects.ts +5 -2
  83. package/src/provider-fetch.ts +171 -0
  84. package/src/services/main.ts +15 -2
  85. package/src/signed-route.ts +216 -36
  86. package/src/streams.ts +118 -0
  87. package/src/testing/FakeStorage.ts +2 -3
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # @c9up/archive
2
2
 
3
- > File storage abstraction for the Ream framework — Local + S3-compatible drivers, signed URLs, expiry.
3
+ > File storage abstraction for the Ream framework — local, S3-compatible and GCS drivers, signed URLs, expiry.
4
4
 
5
- Part of **[Ream](https://github.com/C9up/ream)** — a Rust-powered, AdonisJS-compatible Node.js framework. Independent, publishable package.
5
+ Part of **[Ream](https://github.com/C9up/ream)** — a Rust-powered Node.js framework. Independent, publishable package.
6
6
 
7
7
  ## Installation
8
8
 
@@ -25,12 +25,105 @@ providers: [
25
25
  ]
26
26
  ```
27
27
 
28
+ ## Visibility and signed URLs
29
+
30
+ Every stored object is `public` or `private`. Pass `visibility` when writing,
31
+ or change it afterwards:
32
+
33
+ ```ts
34
+ await disk.put('invoices/42.pdf', bytes, { visibility: 'private' })
35
+ await disk.setVisibility('avatars/1.png', 'public')
36
+ const visibility = await disk.getVisibility('invoices/42.pdf') // 'private'
37
+ ```
38
+
39
+ On the local disk a file with no visibility marker is `public`; a file made
40
+ private carries a marker beside it. On S3 the visibility is the object's ACL
41
+ (`public-read` or `private`), and an object whose ACL cannot be read counts as
42
+ private.
43
+
44
+ `url(path)` follows the visibility: a public file gets its plain URL, a
45
+ private one a signed URL. `getSignedUrl(path, { expiresIn })` signs
46
+ explicitly; `expiresIn` is a number of seconds or a duration string (`'30m'`,
47
+ `'7 days'`), 5 minutes by default, between 1 second and 7 days:
48
+
49
+ ```ts
50
+ const link = await disk.getSignedUrl('invoices/42.pdf', { expiresIn: '30m' })
51
+ ```
52
+
53
+ The local disk signs with its `signingSecret` (HMAC-SHA256). Without one,
54
+ `getSignedUrl` throws `E_ARCHIVE_SIGNING_DISABLED`; the other methods still
55
+ work.
56
+
57
+ ## Serving the local disk
58
+
59
+ A local disk builds its URLs under its `routeBasePath`: `/storage` unless
60
+ `services.fs({ routeBasePath })` says otherwise. Nothing serves that path until
61
+ you mount the signed route from `@c9up/archive/signed-route`. It reads the
62
+ prefix from the driver, serves public files, refuses a private file unless the
63
+ URL carries a valid signature, and streams the file with an ETag, so a client
64
+ revalidating its copy gets a 304:
65
+
66
+ ```ts
67
+ // start/storage.ts
68
+ import { LocalDriver, StorageManager } from '@c9up/archive'
69
+ import { createSignedRouteHandler } from '@c9up/archive/signed-route'
70
+ import env from '#start/env'
71
+
72
+ export const driver = new LocalDriver('storage/uploads', {
73
+ signingSecret: env.get('APP_KEY'),
74
+ })
75
+ export const uploads = new StorageManager(driver)
76
+ export const serveUploads = createSignedRouteHandler({ storage: uploads, driver })
77
+ ```
78
+
79
+ ```ts
80
+ // start/kernel.ts
81
+ import { serveUploads } from '#start/storage'
82
+
83
+ server.use([serveUploads])
84
+ ```
85
+
86
+ `createSignedRouteHandler` throws at construction when the driver has no
87
+ `signingSecret`, and throws `E_ARCHIVE_PREFIX_MISMATCH` when a `prefix` option
88
+ disagrees with the driver's `routeBasePath`: configure the path on the driver
89
+ and leave `prefix` out. A refused request gets a JSON body
90
+ `{ error: { code, message } }`:
91
+
92
+ | Status | Code | When |
93
+ | --- | --- | --- |
94
+ | 403 | `E_ARCHIVE_INVALID_SIGNATURE` | The signature, its expiry or a signed header override is malformed or does not match |
95
+ | 403 | `E_ARCHIVE_EXPIRED_SIGNATURE` | The signature is valid but its `exp` has passed |
96
+ | 403 | `E_ARCHIVE_ACCESS_DENIED` | An unsigned request for a private file |
97
+ | 403 | `E_ARCHIVE_INVALID_KEY` | The path names no key the disk will address |
98
+ | 404 | `E_ARCHIVE_NOT_FOUND` | A valid signature for a file that is not stored |
99
+
100
+ An unsigned request for a name that is not stored falls through to the next
101
+ middleware.
102
+
103
+ ## Static files
104
+
105
+ `StaticMiddleware` serves a directory of assets (`root`), under `prefix`
106
+ (default `/static`), with `max-age` set by `maxAge` (default 0: the browser
107
+ keeps the bytes and revalidates them through the ETag):
108
+
109
+ ```ts
110
+ import { StaticMiddleware } from '@c9up/archive'
111
+
112
+ const assets = new StaticMiddleware({ root: 'public', prefix: '/assets' })
113
+ server.use([assets.handle.bind(assets)])
114
+ ```
115
+
116
+ Point it at public assets only, never at a local disk's directory. It has no
117
+ signature check: it refuses a file whose visibility marker says private and
118
+ never serves the markers themselves, but everything else under `root` is
119
+ served to anyone who asks. Private files are served through the signed route.
120
+
28
121
  ## Entry points
29
122
 
30
123
  - `@c9up/archive` — main API
31
124
  - `@c9up/archive/provider` — Ream IoC provider
32
125
  - `@c9up/archive/services/main` — container service accessor
33
- - `@c9up/archive/signed-route` — signed-URL route helper
126
+ - `@c9up/archive/signed-route` — the route that serves a local disk (see above)
34
127
  - `@c9up/archive/testing` — test fakes & helpers
35
128
 
36
129
  ## License
@@ -5,7 +5,9 @@
5
5
  * `archive` config key.
6
6
  *
7
7
  * Duck-typed against `ArchiveAppContext` so archive does NOT import
8
- * `@c9up/ream` — keeps the package publishable standalone.
8
+ * `@c9up/ream` statically — keeps the package publishable standalone. At
9
+ * boot it gives ream's uploads `moveToDisk(key, disk?, options?)` when ream
10
+ * is installed (see `move-to-disk.ts`).
9
11
  *
10
12
  * @example
11
13
  * // reamrc.ts
@@ -24,6 +26,7 @@
24
26
  import "./augmentations.js";
25
27
  import { type GcsConfig } from "./GcsDriver.js";
26
28
  import { type S3Config } from "./S3Driver.js";
29
+ import { type ReleasableSecret } from "./StorageManager.js";
27
30
  interface ArchiveContainer {
28
31
  singleton(token: unknown, factory: () => unknown): void;
29
32
  resolve<T = unknown>(token: unknown): Promise<T>;
@@ -34,6 +37,8 @@ interface ArchiveConfigStore {
34
37
  export interface ArchiveAppContext {
35
38
  container: ArchiveContainer;
36
39
  config: ArchiveConfigStore;
40
+ /** Set by inker's provider when the app renders views with it. */
41
+ usingInker?: boolean;
37
42
  }
38
43
  /**
39
44
  * Legacy single-disk config shape (pre-parity). Still accepted: the
@@ -45,7 +50,8 @@ export interface ArchiveConfig {
45
50
  driver: "local" | "s3" | "gcs";
46
51
  local?: {
47
52
  root: string;
48
- signingSecret?: string;
53
+ signingSecret?: string | ReleasableSecret;
54
+ routeBasePath?: string;
49
55
  };
50
56
  s3?: S3Config;
51
57
  gcs?: GcsConfig;
@@ -1 +1 @@
1
- {"version":3,"file":"ArchiveProvider.d.ts","sourceRoot":"","sources":["../src/ArchiveProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,oBAAoB,CAAC;AAI5B,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,eAAe,CAAC;AAaxD,UAAU,gBAAgB;IACzB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjD;AACD,UAAU,kBAAkB;IAC3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC;IAC/B,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,GAAG,CAAC,EAAE,SAAS,CAAC;CAChB;AAOD,MAAM,CAAC,OAAO,OAAO,eAAe;;IAUvB,SAAS,CAAC,GAAG,EAAE,iBAAiB;gBAAtB,GAAG,EAAE,iBAAiB;IAE5C,QAAQ,IAAI,IAAI;IA2CV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}
1
+ {"version":3,"file":"ArchiveProvider.d.ts","sourceRoot":"","sources":["../src/ArchiveProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,oBAAoB,CAAC;AAI5B,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,eAAe,CAAC;AACxD,OAAO,EAEN,KAAK,gBAAgB,EAIrB,MAAM,qBAAqB,CAAC;AAQ7B,UAAU,gBAAgB;IACzB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjD;AACD,UAAU,kBAAkB;IAC3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC;IAC/B,KAAK,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;QAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,GAAG,CAAC,EAAE,SAAS,CAAC;CAChB;AAOD,MAAM,CAAC,OAAO,OAAO,eAAe;;IAavB,SAAS,CAAC,GAAG,EAAE,iBAAiB;gBAAtB,GAAG,EAAE,iBAAiB;IAE5C,QAAQ,IAAI,IAAI;IA4CV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkGrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}
@@ -5,7 +5,9 @@
5
5
  * `archive` config key.
6
6
  *
7
7
  * Duck-typed against `ArchiveAppContext` so archive does NOT import
8
- * `@c9up/ream` — keeps the package publishable standalone.
8
+ * `@c9up/ream` statically — keeps the package publishable standalone. At
9
+ * boot it gives ream's uploads `moveToDisk(key, disk?, options?)` when ream
10
+ * is installed (see `move-to-disk.ts`).
9
11
  *
10
12
  * @example
11
13
  * // reamrc.ts
@@ -25,6 +27,7 @@ import "./augmentations.js";
25
27
  import { DriveManager } from "./DriveManager.js";
26
28
  import { ArchiveError } from "./errors.js";
27
29
  import { GcsDriver } from "./GcsDriver.js";
30
+ import { extendMultipartFile } from "./move-to-disk.js";
28
31
  import { S3Driver } from "./S3Driver.js";
29
32
  import { LocalDriver, StorageManager, } from "./StorageManager.js";
30
33
  import { clearStorage, getStorage, setStorage, setStorageResolver, } from "./services/main.js";
@@ -41,6 +44,8 @@ export default class ArchiveProvider {
41
44
  * {@link register}, which always runs before {@link boot}.
42
45
  */
43
46
  #storage;
47
+ /** The lazily-built disk manager behind it, likewise set by register(). */
48
+ #drive;
44
49
  constructor(app) {
45
50
  this.app = app;
46
51
  }
@@ -67,6 +72,7 @@ export default class ArchiveProvider {
67
72
  return manager;
68
73
  };
69
74
  this.#storage = storageManager;
75
+ this.#drive = driveManager;
70
76
  this.app.container.singleton(DriveManager, () => driveManager());
71
77
  // Backward-compatible bindings — the default disk is what apps
72
78
  // previously resolved via `StorageManager` / the `storage` token.
@@ -91,6 +97,12 @@ export default class ArchiveProvider {
91
97
  // The accessor reads the same cell the container's bindings read, so
92
98
  // however storage is reached there is one manager behind it.
93
99
  setStorageResolver(storage);
100
+ await this.#registerViewHelpers();
101
+ // Lazy like the helpers: the macro resolves the disk when an upload is
102
+ // moved, so an unconfigured app builds nothing here.
103
+ const drive = this.#drive;
104
+ if (drive !== undefined)
105
+ await extendMultipartFile(drive);
94
106
  // No eager construction when archive is unconfigured: an app that
95
107
  // registers this provider and never uses storage should not trigger
96
108
  // LocalDriver's mkdir of './storage' at boot, which fails on a
@@ -109,6 +121,51 @@ export default class ArchiveProvider {
109
121
  this.#owned = manager;
110
122
  setStorage(manager);
111
123
  }
124
+ /**
125
+ * Publish `driveUrl` and `driveSignedUrl` to templates, as upstream's
126
+ * provider does for its view engine:
127
+ *
128
+ * {{ await driveUrl(user.avatar) }}
129
+ * {{ await driveSignedUrl(invoice.pdf, 'invoices', { expiresIn: '1h' }) }}
130
+ *
131
+ * Only when the app renders with inker (its provider sets `usingInker`),
132
+ * through inker's module singleton — the same way the i18n package
133
+ * publishes its globals, for the same reason: the engine's container
134
+ * binding is not resolvable during boot, while the singleton's `use()`
135
+ * queues the plugin until the first render. Nothing is built here: each
136
+ * helper resolves the disk when a template calls it.
137
+ */
138
+ async #registerViewHelpers() {
139
+ const drive = this.#drive;
140
+ if (this.app.usingInker !== true || drive === undefined)
141
+ return;
142
+ // Computed: inker is an optional peer, so a bundler must not try to
143
+ // resolve it for an application that does not install it.
144
+ const specifier = "@c9up/inker";
145
+ const loaded = await import(/* @vite-ignore */ specifier);
146
+ const engine = typeof loaded === "object" && loaded !== null
147
+ ? Reflect.get(loaded, "default")
148
+ : undefined;
149
+ const plugin = (target) => {
150
+ if (!publishesGlobals(target))
151
+ return;
152
+ target.global("driveUrl", (key, disk) => drive().use(disk).getUrl(key));
153
+ target.global("driveSignedUrl", (key, diskOrOptions, options) => typeof diskOrOptions === "string"
154
+ ? drive().use(diskOrOptions).getSignedUrl(key, options)
155
+ : drive()
156
+ .use()
157
+ .getSignedUrl(key, diskOrOptions ?? options));
158
+ };
159
+ if (isPluggable(engine))
160
+ engine.use(plugin);
161
+ else if (publishesGlobals(engine))
162
+ plugin(engine);
163
+ else {
164
+ throw new ArchiveError("E_ARCHIVE_TEMPLATE_ENGINE", "The app renders with inker, but its module exposes neither use() nor global(): the drive template helpers cannot be published.", {
165
+ hint: "Install a @c9up/inker version whose default export has use(plugin) or global(name, value).",
166
+ });
167
+ }
168
+ }
112
169
  async start() { }
113
170
  async ready() { }
114
171
  async shutdown() {
@@ -121,6 +178,20 @@ export default class ArchiveProvider {
121
178
  this.#owned = undefined;
122
179
  }
123
180
  }
181
+ /** An engine that queues plugins until it renders: inker's module singleton. */
182
+ function isPluggable(value) {
183
+ return (typeof value === "object" &&
184
+ value !== null &&
185
+ "use" in value &&
186
+ typeof value.use === "function");
187
+ }
188
+ /** An engine that publishes template globals. */
189
+ function publishesGlobals(value) {
190
+ return (typeof value === "object" &&
191
+ value !== null &&
192
+ "global" in value &&
193
+ typeof value.global === "function");
194
+ }
124
195
  /** Narrow an unknown config value to the multi-disk {@link DriveConfig} shape. */
125
196
  function isDriveConfig(config) {
126
197
  return (typeof config === "object" &&
@@ -165,6 +236,7 @@ function buildDriver(config) {
165
236
  const root = config.local?.root ?? "./storage";
166
237
  return new LocalDriver(root, {
167
238
  signingSecret: config.local?.signingSecret,
239
+ routeBasePath: config.local?.routeBasePath,
168
240
  });
169
241
  }
170
242
  // Reject unknown driver values explicitly so a typo like
@@ -1 +1 @@
1
- {"version":3,"file":"ArchiveProvider.js","sourceRoot":"","sources":["../src/ArchiveProvider.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ArchiveProvider.js","sourceRoot":"","sources":["../src/ArchiveProvider.ts"],"names":[],"mappings":"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"}
@@ -19,7 +19,7 @@
19
19
  */
20
20
  import type { GcsConfig } from "./GcsDriver.js";
21
21
  import type { S3Config } from "./S3Driver.js";
22
- import { type StorageDriver, StorageManager } from "./StorageManager.js";
22
+ import { type ReleasableSecret, type StorageDriver, StorageManager } from "./StorageManager.js";
23
23
  import { FakeStorageManager } from "./testing/FakeStorage.js";
24
24
  /** A factory that constructs a fresh driver for a named disk. */
25
25
  export type DriveServiceFactory = () => StorageDriver;
@@ -43,16 +43,26 @@ export interface FsServiceOptions {
43
43
  location?: string;
44
44
  /** Storage root (ream alias of `location`). */
45
45
  root?: string;
46
- /** HMAC secret enabling `getSignedUrl` on the LocalDriver. */
47
- signingSecret?: string;
46
+ /**
47
+ * HMAC secret enabling `getSignedUrl` on the LocalDriver: a string or a
48
+ * `Secret`, kept wrapped here and released by the driver.
49
+ */
50
+ signingSecret?: string | ReleasableSecret;
51
+ /**
52
+ * URL path the disk's files are served under (default `/storage`): the
53
+ * driver's URLs and the signed route both derive from it.
54
+ */
55
+ routeBasePath?: string;
48
56
  }
49
57
  /**
50
58
  * Config helpers mirroring AdonisJS Drive's `services.fs/s3/gcs`. Each
51
59
  * returns a factory consumed by {@link DriveConfig.services}.
52
60
  *
53
- * DIVERGENCE (documented, deliberate): the ream `services.fs` builds URLs
54
- * in-package via the LocalDriver + signed-route handler — it does NOT
55
- * couple to the ream router the way Adonis wires `serveFiles`/`routeBasePath`.
61
+ * NAMED DEVIATION: the ream `services.fs` builds URLs in-package via the
62
+ * LocalDriver + signed-route handler — it does NOT couple to the router,
63
+ * so there is no `serveFiles` that registers the route for you. Its
64
+ * `routeBasePath` plays the upstream role all the same: the driver's URLs
65
+ * and the signed route's prefix both derive from it.
56
66
  */
57
67
  export declare const services: {
58
68
  fs(options?: FsServiceOptions): DriveServiceFactory;
@@ -1 +1 @@
1
- {"version":3,"file":"DriveManager.d.ts","sourceRoot":"","sources":["../src/DriveManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAEN,KAAK,aAAa,EAClB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,MAAM,aAAa,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC9C,qFAAqF;IACrF,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAChC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE;IACtB,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IACpD,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,mBAAmB,CAAC;IAC1C,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAAC;CAa5C,CAAC;AAEF,qBAAa,YAAY;;gBAKZ,MAAM,EAAE,WAAW;IAa/B;;;;OAIG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;IAqBrC;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAQ1C,6EAA6E;IAC7E,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAQ/B"}
1
+ {"version":3,"file":"DriveManager.d.ts","sourceRoot":"","sources":["../src/DriveManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,MAAM,aAAa,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC9C,qFAAqF;IACrF,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAChC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC1C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,EAAE;IACtB,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IACpD,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,mBAAmB,CAAC;IAC1C,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAAC;CAgB5C,CAAC;AAkBF,qBAAa,YAAY;;gBAKZ,MAAM,EAAE,WAAW;IAa/B;;;;OAIG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;IAqBrC;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAQ1C,6EAA6E;IAC7E,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAQ/B"}
@@ -26,14 +26,19 @@ import { FakeStorageManager } from "./testing/FakeStorage.js";
26
26
  * Config helpers mirroring AdonisJS Drive's `services.fs/s3/gcs`. Each
27
27
  * returns a factory consumed by {@link DriveConfig.services}.
28
28
  *
29
- * DIVERGENCE (documented, deliberate): the ream `services.fs` builds URLs
30
- * in-package via the LocalDriver + signed-route handler — it does NOT
31
- * couple to the ream router the way Adonis wires `serveFiles`/`routeBasePath`.
29
+ * NAMED DEVIATION: the ream `services.fs` builds URLs in-package via the
30
+ * LocalDriver + signed-route handler — it does NOT couple to the router,
31
+ * so there is no `serveFiles` that registers the route for you. Its
32
+ * `routeBasePath` plays the upstream role all the same: the driver's URLs
33
+ * and the signed route's prefix both derive from it.
32
34
  */
33
35
  export const services = {
34
36
  fs(options) {
35
37
  const root = options?.location ?? options?.root ?? "./storage";
36
- return () => new LocalDriver(root, { signingSecret: options?.signingSecret });
38
+ return () => new LocalDriver(root, {
39
+ signingSecret: options?.signingSecret,
40
+ routeBasePath: options?.routeBasePath,
41
+ });
37
42
  },
38
43
  s3(config) {
39
44
  return () => new S3Driver(config);
@@ -42,12 +47,24 @@ export const services = {
42
47
  return () => new GcsDriver(config);
43
48
  },
44
49
  };
50
+ /**
51
+ * The factory configured for a disk, or `undefined` when there is none. Only
52
+ * OWN entries of `services` are disks: a plain lookup would answer
53
+ * `constructor`, `toString` or `hasOwnProperty` with the function inherited
54
+ * from `Object.prototype` and build a broken disk out of it.
55
+ *
56
+ * NAMED DEVIATION (stricter than flydrive's `DriveManager.use`, which reads
57
+ * `services[name]` directly): an inherited name is an unknown disk.
58
+ */
59
+ function serviceFactory(services, name) {
60
+ return Object.hasOwn(services, name) ? services[name] : undefined;
61
+ }
45
62
  export class DriveManager {
46
63
  #config;
47
64
  #cache = new Map();
48
65
  #fakes = new Map();
49
66
  constructor(config) {
50
- if (config.services[config.default] === undefined) {
67
+ if (serviceFactory(config.services, config.default) === undefined) {
51
68
  throw new ArchiveError("E_ARCHIVE_UNKNOWN_DISK", `Archive default disk '${config.default}' is not present in config.services`, {
52
69
  hint: `Add a '${config.default}' entry to config.services, or point config.default at an existing disk.`,
53
70
  });
@@ -67,7 +84,7 @@ export class DriveManager {
67
84
  const cached = this.#cache.get(name);
68
85
  if (cached)
69
86
  return cached;
70
- const factory = this.#config.services[name];
87
+ const factory = serviceFactory(this.#config.services, name);
71
88
  if (factory === undefined) {
72
89
  throw new ArchiveError("E_ARCHIVE_UNKNOWN_DISK", `Archive disk '${name}' is not configured`, {
73
90
  hint: `Known disks: ${Object.keys(this.#config.services).join(", ") || "(none)"}.`,
@@ -1 +1 @@
1
- {"version":3,"file":"DriveManager.js","sourceRoot":"","sources":["../src/DriveManager.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"DriveManager.js","sourceRoot":"","sources":["../src/DriveManager.ts"],"names":[],"mappings":"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"}
@@ -18,13 +18,18 @@ export interface GcsConfig {
18
18
  bucket: string;
19
19
  serviceAccount: GcsServiceAccount;
20
20
  /** Optional CDN prefix for public URLs (e.g. `https://cdn.example.com`). */
21
- publicUrl?: string /**
22
- * How long one request to the provider may take, in ms. Default 30 000.
21
+ publicUrl?: string;
22
+ /**
23
+ * How long the provider may stay silent during one request, in ms.
24
+ * Default 30 000.
23
25
  *
24
- * Without a bound a hung connection never settles: the handler awaiting it
25
- * waits forever, and enough of them stop the server from serving. Set 0 to
26
- * disable, which only makes sense behind an outer timeout.
27
- */;
26
+ * An idle bound, not a deadline: it runs while the provider is awaited
27
+ * (taking the request body, sending headers, sending the next chunk), so a
28
+ * long transfer that keeps moving is never cut. Without a bound a hung
29
+ * connection never settles: the handler awaiting it waits forever, and
30
+ * enough of them stop the server from serving. Set 0 to disable, which
31
+ * only makes sense behind an outer timeout.
32
+ */
28
33
  requestTimeoutMs?: number;
29
34
  }
30
35
  export declare class GcsDriver implements StorageDriver {
@@ -44,9 +49,9 @@ export declare class GcsDriver implements StorageDriver {
44
49
  setVisibility(filePath: string, visibility: Visibility): Promise<void>;
45
50
  copy(from: string, to: string, options?: WriteOptions): Promise<void>;
46
51
  move(from: string, to: string, options?: WriteOptions): Promise<void>;
47
- deleteAll(prefix: string): Promise<void>;
48
- listAll(prefix: string, options?: ListAllOptions): Promise<ListAllResult>;
49
- list(prefix: string): AsyncIterable<StorageEntry>;
52
+ deleteAll(given: string): Promise<void>;
53
+ listAll(given: string, options?: ListAllOptions): Promise<ListAllResult>;
54
+ list(given: string): AsyncIterable<StorageEntry>;
50
55
  getSignedUrl(filePath: string, options?: SignedUrlOptions): string;
51
56
  /**
52
57
  * Presigned PUT URL for direct-to-GCS uploads. AdonisJS Drive parity.
@@ -1 +1 @@
1
- {"version":3,"file":"GcsDriver.d.ts","sourceRoot":"","sources":["../src/GcsDriver.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAaH,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,MAAM,qBAAqB,CAAC;AAwD7B,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,iBAAiB,CAAC;IAClC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;;;;;;OAMhB,CAAC;IACJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,qBAAa,SAAU,YAAW,aAAa;;gBA6BlC,MAAM,EAAE,SAAS;IAevB,GAAG,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;IA6BV,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAc/C,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAwBV,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY7C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAqB3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ7B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8ChD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAuDlB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;IA6BxD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IAclE;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;CA0HxE"}
1
+ {"version":3,"file":"GcsDriver.d.ts","sourceRoot":"","sources":["../src/GcsDriver.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAcH,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,MAAM,qBAAqB,CAAC;AAmD7B,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,iBAAiB,CAAC;IAClC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAcD,qBAAa,SAAU,YAAW,aAAa;;gBAkBlC,MAAM,EAAE,SAAS;IAevB,GAAG,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;IA6BV,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAc/C,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAmIV,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY7C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAqB3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ7B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyChD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavC,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IA+ClB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;IA4BvD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IAclE;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;CA0HxE"}