@c9up/archive 0.1.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.
- package/LICENSE +21 -0
- package/README.md +35 -0
- package/dist/ArchiveProvider.d.ts +32 -0
- package/dist/ArchiveProvider.d.ts.map +1 -0
- package/dist/ArchiveProvider.js +91 -0
- package/dist/ArchiveProvider.js.map +1 -0
- package/dist/GcsDriver.d.ts +41 -0
- package/dist/GcsDriver.d.ts.map +1 -0
- package/dist/GcsDriver.js +387 -0
- package/dist/GcsDriver.js.map +1 -0
- package/dist/S3Driver.d.ts +50 -0
- package/dist/S3Driver.d.ts.map +1 -0
- package/dist/S3Driver.js +642 -0
- package/dist/S3Driver.js.map +1 -0
- package/dist/StaticMiddleware.d.ts +46 -0
- package/dist/StaticMiddleware.d.ts.map +1 -0
- package/dist/StaticMiddleware.js +121 -0
- package/dist/StaticMiddleware.js.map +1 -0
- package/dist/StorageManager.d.ts +178 -0
- package/dist/StorageManager.d.ts.map +1 -0
- package/dist/StorageManager.js +405 -0
- package/dist/StorageManager.js.map +1 -0
- package/dist/errors.d.ts +11 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +14 -0
- package/dist/errors.js.map +1 -0
- package/dist/expiry.d.ts +15 -0
- package/dist/expiry.d.ts.map +1 -0
- package/dist/expiry.js +26 -0
- package/dist/expiry.js.map +1 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +17 -0
- package/dist/index.js.map +1 -0
- package/dist/mime-types.d.ts +17 -0
- package/dist/mime-types.d.ts.map +1 -0
- package/dist/mime-types.js +47 -0
- package/dist/mime-types.js.map +1 -0
- package/dist/services/main.d.ts +19 -0
- package/dist/services/main.d.ts.map +1 -0
- package/dist/services/main.js +33 -0
- package/dist/services/main.js.map +1 -0
- package/dist/signed-route.d.ts +61 -0
- package/dist/signed-route.d.ts.map +1 -0
- package/dist/signed-route.js +155 -0
- package/dist/signed-route.js.map +1 -0
- package/dist/testing/FakeStorage.d.ts +72 -0
- package/dist/testing/FakeStorage.d.ts.map +1 -0
- package/dist/testing/FakeStorage.js +266 -0
- package/dist/testing/FakeStorage.js.map +1 -0
- package/package.json +67 -0
- package/src/ArchiveProvider.ts +134 -0
- package/src/GcsDriver.ts +490 -0
- package/src/S3Driver.ts +791 -0
- package/src/StaticMiddleware.ts +175 -0
- package/src/StorageManager.ts +627 -0
- package/src/errors.ts +14 -0
- package/src/expiry.ts +41 -0
- package/src/index.ts +41 -0
- package/src/mime-types.ts +51 -0
- package/src/services/main.ts +41 -0
- package/src/signed-route.ts +223 -0
- package/src/testing/FakeStorage.ts +372 -0
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* S3Driver — S3-compatible cloud storage (AWS S3, Cloudflare R2, MinIO).
|
|
3
|
+
*
|
|
4
|
+
* Uses fetch API — no external SDK dependency.
|
|
5
|
+
* Implements the StorageDriver interface.
|
|
6
|
+
*
|
|
7
|
+
* @implements MISS-24
|
|
8
|
+
*/
|
|
9
|
+
import type { Metadata, PutStreamOptions, SignedUrlOptions, StorageDriver, StorageEntry, Visibility } from "./StorageManager.js";
|
|
10
|
+
export interface S3Config {
|
|
11
|
+
bucket: string;
|
|
12
|
+
region?: string;
|
|
13
|
+
endpoint?: string;
|
|
14
|
+
accessKeyId: string;
|
|
15
|
+
secretAccessKey: string;
|
|
16
|
+
publicUrl?: string;
|
|
17
|
+
}
|
|
18
|
+
export declare class S3Driver implements StorageDriver {
|
|
19
|
+
#private;
|
|
20
|
+
constructor(config: S3Config);
|
|
21
|
+
put(filePath: string, content: Buffer | string): Promise<void>;
|
|
22
|
+
putStream(filePath: string, readable: NodeJS.ReadableStream, options?: PutStreamOptions): Promise<void>;
|
|
23
|
+
getStream(filePath: string): Promise<NodeJS.ReadableStream>;
|
|
24
|
+
get(filePath: string): Promise<Buffer | null>;
|
|
25
|
+
delete(filePath: string): Promise<boolean>;
|
|
26
|
+
exists(filePath: string): Promise<boolean>;
|
|
27
|
+
publicUrl(filePath: string): string;
|
|
28
|
+
url(filePath: string): Promise<string>;
|
|
29
|
+
getMetadata(filePath: string): Promise<Metadata>;
|
|
30
|
+
setVisibility(filePath: string, visibility: Visibility): Promise<void>;
|
|
31
|
+
/**
|
|
32
|
+
* Generate a presigned GET URL per AWS SigV4 query-parameter spec.
|
|
33
|
+
*
|
|
34
|
+
* The returned URL always targets the **signing endpoint**
|
|
35
|
+
* (`config.endpoint` or the derived AWS endpoint), *not*
|
|
36
|
+
* `config.publicUrl` — presigned URLs only validate against the
|
|
37
|
+
* host that signed them. For a CDN-fronted bucket, serve unsigned
|
|
38
|
+
* reads via {@link url} instead of presigning.
|
|
39
|
+
*
|
|
40
|
+
* Canonical differences from header-signed requests:
|
|
41
|
+
* - SignedHeaders is `host` only (no `x-amz-date`/content-hash).
|
|
42
|
+
* - Payload hash is the literal `UNSIGNED-PAYLOAD`.
|
|
43
|
+
* - Credentials and expiry live in query params, not headers.
|
|
44
|
+
*/
|
|
45
|
+
getSignedUrl(filePath: string, options?: SignedUrlOptions): string;
|
|
46
|
+
copy(from: string, to: string): Promise<void>;
|
|
47
|
+
move(from: string, to: string): Promise<void>;
|
|
48
|
+
list(prefix: string): AsyncIterable<StorageEntry>;
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=S3Driver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"S3Driver.d.ts","sourceRoot":"","sources":["../src/S3Driver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACX,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,MAAM,qBAAqB,CAAC;AA4B7B,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,QAAS,YAAW,aAAa;;gBAIjC,MAAM,EAAE,QAAQ;IAoBtB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9D,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAiEV,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAyB3D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY7C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQhD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAS7B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuDhD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5E;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IAoD5D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;CA4RxD"}
|