@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.
Files changed (63) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +35 -0
  3. package/dist/ArchiveProvider.d.ts +32 -0
  4. package/dist/ArchiveProvider.d.ts.map +1 -0
  5. package/dist/ArchiveProvider.js +91 -0
  6. package/dist/ArchiveProvider.js.map +1 -0
  7. package/dist/GcsDriver.d.ts +41 -0
  8. package/dist/GcsDriver.d.ts.map +1 -0
  9. package/dist/GcsDriver.js +387 -0
  10. package/dist/GcsDriver.js.map +1 -0
  11. package/dist/S3Driver.d.ts +50 -0
  12. package/dist/S3Driver.d.ts.map +1 -0
  13. package/dist/S3Driver.js +642 -0
  14. package/dist/S3Driver.js.map +1 -0
  15. package/dist/StaticMiddleware.d.ts +46 -0
  16. package/dist/StaticMiddleware.d.ts.map +1 -0
  17. package/dist/StaticMiddleware.js +121 -0
  18. package/dist/StaticMiddleware.js.map +1 -0
  19. package/dist/StorageManager.d.ts +178 -0
  20. package/dist/StorageManager.d.ts.map +1 -0
  21. package/dist/StorageManager.js +405 -0
  22. package/dist/StorageManager.js.map +1 -0
  23. package/dist/errors.d.ts +11 -0
  24. package/dist/errors.d.ts.map +1 -0
  25. package/dist/errors.js +14 -0
  26. package/dist/errors.js.map +1 -0
  27. package/dist/expiry.d.ts +15 -0
  28. package/dist/expiry.d.ts.map +1 -0
  29. package/dist/expiry.js +26 -0
  30. package/dist/expiry.js.map +1 -0
  31. package/dist/index.d.ts +17 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +17 -0
  34. package/dist/index.js.map +1 -0
  35. package/dist/mime-types.d.ts +17 -0
  36. package/dist/mime-types.d.ts.map +1 -0
  37. package/dist/mime-types.js +47 -0
  38. package/dist/mime-types.js.map +1 -0
  39. package/dist/services/main.d.ts +19 -0
  40. package/dist/services/main.d.ts.map +1 -0
  41. package/dist/services/main.js +33 -0
  42. package/dist/services/main.js.map +1 -0
  43. package/dist/signed-route.d.ts +61 -0
  44. package/dist/signed-route.d.ts.map +1 -0
  45. package/dist/signed-route.js +155 -0
  46. package/dist/signed-route.js.map +1 -0
  47. package/dist/testing/FakeStorage.d.ts +72 -0
  48. package/dist/testing/FakeStorage.d.ts.map +1 -0
  49. package/dist/testing/FakeStorage.js +266 -0
  50. package/dist/testing/FakeStorage.js.map +1 -0
  51. package/package.json +67 -0
  52. package/src/ArchiveProvider.ts +134 -0
  53. package/src/GcsDriver.ts +490 -0
  54. package/src/S3Driver.ts +791 -0
  55. package/src/StaticMiddleware.ts +175 -0
  56. package/src/StorageManager.ts +627 -0
  57. package/src/errors.ts +14 -0
  58. package/src/expiry.ts +41 -0
  59. package/src/index.ts +41 -0
  60. package/src/mime-types.ts +51 -0
  61. package/src/services/main.ts +41 -0
  62. package/src/signed-route.ts +223 -0
  63. package/src/testing/FakeStorage.ts +372 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"S3Driver.js","sourceRoot":"","sources":["../src/S3Driver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Static file serving middleware.
3
+ *
4
+ * Serves files from a directory with cache headers and ETag support.
5
+ *
6
+ * Usage:
7
+ * const staticMiddleware = new StaticMiddleware({ root: 'public' })
8
+ * middleware.use(staticMiddleware.handle.bind(staticMiddleware))
9
+ *
10
+ * @implements MISS-25
11
+ */
12
+ /**
13
+ * Minimal request/response contract the static-file handler needs.
14
+ * Matches Ream's `HttpContext` structurally (public surface only) —
15
+ * avoids importing the concrete class so tests can build plain-object
16
+ * mocks without `as unknown as T` double-casts.
17
+ */
18
+ export interface StaticMiddlewareResponse {
19
+ status(code: number): StaticMiddlewareResponse;
20
+ header(name: string, value: string): StaticMiddlewareResponse;
21
+ sendBuffer(buf: Buffer): void;
22
+ }
23
+ export interface StaticMiddlewareHttpContext {
24
+ request: {
25
+ method(): string;
26
+ path(): string;
27
+ header(name: string): string | undefined;
28
+ };
29
+ response: StaticMiddlewareResponse;
30
+ }
31
+ export interface StaticConfig {
32
+ /** Root directory to serve files from. */
33
+ root: string;
34
+ /** URL prefix (default: /static). */
35
+ prefix?: string;
36
+ /** Max-age for Cache-Control header in seconds (default: 86400 = 1 day). */
37
+ maxAge?: number;
38
+ /** File extensions to serve (default: common web assets). */
39
+ extensions?: string[];
40
+ }
41
+ export declare class StaticMiddleware {
42
+ #private;
43
+ constructor(config: StaticConfig);
44
+ handle(ctx: StaticMiddlewareHttpContext, next: () => Promise<void>): Promise<void>;
45
+ }
46
+ //# sourceMappingURL=StaticMiddleware.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StaticMiddleware.d.ts","sourceRoot":"","sources":["../src/StaticMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAC9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE;QACR,MAAM,IAAI,MAAM,CAAC;QACjB,IAAI,IAAI,MAAM,CAAC;QACf,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACzC,CAAC;IACF,QAAQ,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,gBAAgB;;gBAMhB,MAAM,EAAE,YAAY;IAoB1B,MAAM,CACX,GAAG,EAAE,2BAA2B,EAChC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACvB,OAAO,CAAC,IAAI,CAAC;CA8FhB"}
@@ -0,0 +1,121 @@
1
+ /**
2
+ * Static file serving middleware.
3
+ *
4
+ * Serves files from a directory with cache headers and ETag support.
5
+ *
6
+ * Usage:
7
+ * const staticMiddleware = new StaticMiddleware({ root: 'public' })
8
+ * middleware.use(staticMiddleware.handle.bind(staticMiddleware))
9
+ *
10
+ * @implements MISS-25
11
+ */
12
+ import { createHash } from "node:crypto";
13
+ import * as fs from "node:fs";
14
+ import * as fsp from "node:fs/promises";
15
+ import * as path from "node:path";
16
+ import { DEFAULT_EXTENSIONS, inferMimeType } from "./mime-types.js";
17
+ import { VISIBILITY_SIDECAR_SUFFIX } from "./StorageManager.js";
18
+ export class StaticMiddleware {
19
+ #root;
20
+ #prefix;
21
+ #maxAge;
22
+ #extensions;
23
+ constructor(config) {
24
+ const prefix = config.prefix ?? "/static";
25
+ // Reject an empty-string prefix — it would make every GET on an
26
+ // allow-listed extension resolve to a file under `root`, which
27
+ // is rarely what a caller wants and always a misconfiguration
28
+ // risk. Require the caller to pick a real URL prefix.
29
+ if (prefix === "") {
30
+ throw new Error("StaticMiddleware: prefix cannot be empty. Use '/static' (default) or a specific path like '/assets'.");
31
+ }
32
+ const resolved = path.resolve(config.root);
33
+ // Canonicalise the root so the realpath check in handle() can
34
+ // detect symlink-based escapes consistently.
35
+ this.#root = fs.existsSync(resolved) ? fs.realpathSync(resolved) : resolved;
36
+ this.#prefix = prefix;
37
+ this.#maxAge = config.maxAge ?? 86400;
38
+ this.#extensions = new Set(config.extensions ?? DEFAULT_EXTENSIONS);
39
+ }
40
+ async handle(ctx, next) {
41
+ if (ctx.request.method() !== "GET" && ctx.request.method() !== "HEAD") {
42
+ return next();
43
+ }
44
+ const reqPath = ctx.request.path();
45
+ // Match the prefix exactly: `/static/foo` matches prefix `/static`, but
46
+ // `/staticx/foo` must NOT match. Require the char after the prefix to be
47
+ // `/` or end-of-string.
48
+ if (!reqPath.startsWith(this.#prefix)) {
49
+ return next();
50
+ }
51
+ const afterPrefix = reqPath[this.#prefix.length];
52
+ if (afterPrefix !== undefined && afterPrefix !== "/") {
53
+ return next();
54
+ }
55
+ // Strip prefix and resolve file path
56
+ const relativePath = reqPath.slice(this.#prefix.length) || "/index.html";
57
+ // Visibility sidecars are an implementation detail of LocalDriver
58
+ // — never serve them, even if the static root happens to overlap
59
+ // the storage root. Check BEFORE the extension allow-list because
60
+ // `.archive-visibility.json` has a `.json` extension that would
61
+ // otherwise pass. Case-insensitive to defeat
62
+ // `.ARCHIVE-VISIBILITY.JSON` variants on case-insensitive
63
+ // filesystems (macOS default, Windows).
64
+ if (relativePath.toLowerCase().endsWith(VISIBILITY_SIDECAR_SUFFIX)) {
65
+ return next();
66
+ }
67
+ const ext = path.extname(relativePath).toLowerCase();
68
+ if (!this.#extensions.has(ext)) {
69
+ return next();
70
+ }
71
+ // Prevent path traversal (lexical check first).
72
+ const filePath = path.resolve(this.#root, relativePath.replace(/^\//, ""));
73
+ if (!filePath.startsWith(this.#root + path.sep) &&
74
+ filePath !== this.#root) {
75
+ return next();
76
+ }
77
+ let stat;
78
+ let realPath;
79
+ try {
80
+ stat = await fsp.stat(filePath);
81
+ if (!stat.isFile())
82
+ return next();
83
+ // Realpath guard — defeats symlink-based escapes where a
84
+ // symlink inside `root` points to a file outside it.
85
+ realPath = await fsp.realpath(filePath);
86
+ if (!realPath.startsWith(this.#root + path.sep) &&
87
+ realPath !== this.#root) {
88
+ return next();
89
+ }
90
+ }
91
+ catch {
92
+ return next();
93
+ }
94
+ const etag = createHash("md5")
95
+ .update(`${stat.size}-${stat.mtimeMs}`)
96
+ .digest("hex");
97
+ // ETag check — 304 Not Modified
98
+ const ifNoneMatch = ctx.request.header("if-none-match");
99
+ if (ifNoneMatch === etag) {
100
+ ctx.response.status(304);
101
+ return;
102
+ }
103
+ const mime = inferMimeType(ext);
104
+ ctx.response.header("Content-Type", mime);
105
+ ctx.response.header("Content-Length", String(stat.size));
106
+ ctx.response.header("Cache-Control", `public, max-age=${this.#maxAge}`);
107
+ ctx.response.header("ETag", etag);
108
+ if (ctx.request.method() === "HEAD") {
109
+ ctx.response.status(200);
110
+ return;
111
+ }
112
+ // Read the canonicalised path — closes the symlink TOCTOU window
113
+ // between the realpath check above and the read. `filePath` could
114
+ // resolve through a symlink that was swapped after we validated it.
115
+ const content = await fsp.readFile(realPath);
116
+ // Send the raw Buffer — NOT content.toString() which would destroy binary
117
+ // data (PNG, PDF, ZIP, etc.) by interpreting it as UTF-8.
118
+ ctx.response.status(200).sendBuffer(content);
119
+ }
120
+ }
121
+ //# sourceMappingURL=StaticMiddleware.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StaticMiddleware.js","sourceRoot":"","sources":["../src/StaticMiddleware.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,178 @@
1
+ /**
2
+ * Storage — file storage abstraction with driver pattern.
3
+ *
4
+ * @implements MISS-24
5
+ */
6
+ /** Options for {@link StorageDriver.getSignedUrl}. */
7
+ export interface SignedUrlOptions {
8
+ /** URL lifetime in seconds. Default: 300 (5 minutes). Bounds: 1–604800. */
9
+ expiresIn?: number;
10
+ }
11
+ /** Options for {@link StorageDriver.putStream}. */
12
+ export interface PutStreamOptions {
13
+ /** MIME type — sent as unsigned `Content-Type` on S3 uploads. Local ignores it. */
14
+ contentType?: string;
15
+ /**
16
+ * Declared byte length. S3 uses this to pick single-PUT (≤ 5 MiB) vs
17
+ * multipart (> 5 MiB). Undefined → always multipart. Local ignores it.
18
+ */
19
+ contentLength?: number;
20
+ }
21
+ /** Public/private visibility for a stored object. */
22
+ export type Visibility = "public" | "private";
23
+ /** Suffix appended to the target filename to store its visibility marker
24
+ * on the LocalDriver. Kept as a package-internal constant so the static
25
+ * middleware can exclude it by the same name. */
26
+ export declare const VISIBILITY_SIDECAR_SUFFIX = ".archive-visibility.json";
27
+ /**
28
+ * Metadata surfaced by {@link StorageDriver.getMetadata}. Shape is driver-
29
+ * agnostic: S3 returns HEAD-derived values, Local reads `fs.stat` + the
30
+ * MIME table + a sidecar for visibility.
31
+ */
32
+ /** One entry yielded by {@link StorageDriver.list}. */
33
+ export interface StorageEntry {
34
+ /** Full path (includes the prefix argument). */
35
+ path: string;
36
+ /** Size in bytes. */
37
+ size: number;
38
+ /** Last-modified timestamp. */
39
+ lastModified: Date;
40
+ }
41
+ export interface Metadata {
42
+ /** Size in bytes. */
43
+ size: number;
44
+ /** Content type. Driver-inferred for Local (extension-based), server-
45
+ * reported for S3. Falls back to `application/octet-stream`. */
46
+ mimeType: string;
47
+ /** Last-modified timestamp as a `Date` — not a string, not epoch ms. */
48
+ lastModified: Date;
49
+ /** Strong or weak ETag with surrounding quotes stripped. `W/` prefix
50
+ * is preserved when the origin reports a weak tag. */
51
+ etag: string;
52
+ /** Public/private visibility. Missing-sidecar on Local = `'public'`. */
53
+ visibility: Visibility;
54
+ }
55
+ /**
56
+ * StorageDriver contract — frozen at v1.0 (Epic 43, 2026-05-05).
57
+ *
58
+ * Driver authors implement this interface verbatim. The interface is treated
59
+ * as a stable contract: new methods are NOT added without a version-bump + a
60
+ * 2-epic deprecation window. Optional fields are added in minor versions.
61
+ * Method signatures never change in-place — a renamed method ships as a new
62
+ * method + the old one delegating, deprecated for ≥1 epic.
63
+ */
64
+ export interface StorageDriver {
65
+ put(filePath: string, content: Buffer | string): Promise<void>;
66
+ /**
67
+ * Upload from a readable stream. Local pipes to disk; S3 uses
68
+ * single-PUT if `contentLength ≤ 5 MiB`, otherwise multipart.
69
+ */
70
+ putStream(filePath: string, readable: NodeJS.ReadableStream, options?: PutStreamOptions): Promise<void>;
71
+ get(filePath: string): Promise<Buffer | null>;
72
+ /**
73
+ * Download as a readable stream. Throws `ARCHIVE_NOT_FOUND` when
74
+ * the object is missing — streams can't express absence as a value.
75
+ */
76
+ getStream(filePath: string): Promise<NodeJS.ReadableStream>;
77
+ delete(filePath: string): Promise<boolean>;
78
+ exists(filePath: string): Promise<boolean>;
79
+ /**
80
+ * Visibility-aware URL. `public` → {@link publicUrl}, `private` →
81
+ * {@link getSignedUrl} (default 5 min expiry). Async because reading
82
+ * visibility may require a driver round-trip (S3 GET ?acl).
83
+ */
84
+ url(filePath: string): Promise<string>;
85
+ /**
86
+ * Unsigned, direct URL that ignores visibility. Useful when the
87
+ * caller already knows the object is public or wants to build a
88
+ * template before visibility is set.
89
+ */
90
+ publicUrl(filePath: string): string;
91
+ /**
92
+ * Return a time-boxed URL that grants read access to `filePath`.
93
+ * Implementations must validate `options.expiresIn` via
94
+ * {@link assertValidExpiry} and reject out-of-range values with
95
+ * `ARCHIVE_INVALID_EXPIRY`.
96
+ */
97
+ getSignedUrl(filePath: string, options?: SignedUrlOptions): string | Promise<string>;
98
+ /**
99
+ * Resolve object metadata. Throws `ArchiveError('ARCHIVE_NOT_FOUND', ...)`
100
+ * when the object does not exist.
101
+ */
102
+ getMetadata(filePath: string): Promise<Metadata>;
103
+ /**
104
+ * Set `public` / `private` visibility. Idempotent — re-applying the
105
+ * same visibility succeeds silently.
106
+ */
107
+ setVisibility(filePath: string, visibility: Visibility): Promise<void>;
108
+ /**
109
+ * Duplicate an object. Throws `ARCHIVE_NOT_FOUND` if `from` is
110
+ * missing. Target is overwritten if it exists. Visibility is NOT
111
+ * carried over — the new object takes default visibility.
112
+ */
113
+ copy(from: string, to: string): Promise<void>;
114
+ /**
115
+ * Relocate an object. Equivalent to `copy` + `delete` on cloud
116
+ * drivers (non-atomic between the two steps); atomic `rename` on
117
+ * Local. Visibility IS preserved because identity is preserved.
118
+ */
119
+ move(from: string, to: string): Promise<void>;
120
+ /**
121
+ * Yield one {@link StorageEntry} per object whose path starts with
122
+ * `prefix`. Pagination (S3/GCS) and filesystem walk (Local) happen
123
+ * lazily — callers can `break` early and no further requests are
124
+ * issued.
125
+ */
126
+ list(prefix: string): AsyncIterable<StorageEntry>;
127
+ }
128
+ export interface LocalDriverOptions {
129
+ /**
130
+ * HMAC-SHA256 secret used by {@link LocalDriver.getSignedUrl}.
131
+ * When omitted, signing is disabled and `getSignedUrl` throws
132
+ * `ARCHIVE_SIGNING_DISABLED`. The non-signing methods
133
+ * (`put`/`get`/`delete`/`exists`/`url`) work either way.
134
+ */
135
+ signingSecret?: string;
136
+ }
137
+ export declare class LocalDriver implements StorageDriver {
138
+ #private;
139
+ constructor(root: string, options?: LocalDriverOptions);
140
+ put(filePath: string, content: Buffer | string): Promise<void>;
141
+ putStream(filePath: string, readable: NodeJS.ReadableStream, _options?: PutStreamOptions): Promise<void>;
142
+ get(filePath: string): Promise<Buffer | null>;
143
+ getStream(filePath: string): Promise<NodeJS.ReadableStream>;
144
+ delete(filePath: string): Promise<boolean>;
145
+ exists(filePath: string): Promise<boolean>;
146
+ publicUrl(filePath: string): string;
147
+ url(filePath: string): Promise<string>;
148
+ getMetadata(filePath: string): Promise<Metadata>;
149
+ setVisibility(filePath: string, visibility: Visibility): Promise<void>;
150
+ getSignedUrl(filePath: string, options?: SignedUrlOptions): string;
151
+ /**
152
+ * @internal Used by the signed-route middleware to re-compute the
153
+ * HMAC server-side. Not part of the public `StorageDriver` contract.
154
+ */
155
+ getSigningSecret(): string | null;
156
+ copy(from: string, to: string): Promise<void>;
157
+ move(from: string, to: string): Promise<void>;
158
+ list(prefix: string): AsyncIterable<StorageEntry>;
159
+ }
160
+ export declare class StorageManager {
161
+ #private;
162
+ constructor(driver: StorageDriver);
163
+ put(filePath: string, content: Buffer | string): Promise<void>;
164
+ putStream(filePath: string, readable: NodeJS.ReadableStream, options?: PutStreamOptions): Promise<void>;
165
+ get(filePath: string): Promise<Buffer | null>;
166
+ getStream(filePath: string): Promise<NodeJS.ReadableStream>;
167
+ delete(filePath: string): Promise<boolean>;
168
+ exists(filePath: string): Promise<boolean>;
169
+ url(filePath: string): Promise<string>;
170
+ publicUrl(filePath: string): string;
171
+ getSignedUrl(filePath: string, options?: SignedUrlOptions): string | Promise<string>;
172
+ getMetadata(filePath: string): Promise<Metadata>;
173
+ setVisibility(filePath: string, visibility: Visibility): Promise<void>;
174
+ copy(from: string, to: string): Promise<void>;
175
+ move(from: string, to: string): Promise<void>;
176
+ list(prefix: string): AsyncIterable<StorageEntry>;
177
+ }
178
+ //# sourceMappingURL=StorageManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../src/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAChC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAChC,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C;;kDAEkD;AAClD,eAAO,MAAM,yBAAyB,6BAA6B,CAAC;AAEpE;;;;GAIG;AACH,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,YAAY,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACxB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb;qEACiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,YAAY,EAAE,IAAI,CAAC;IACnB;2DACuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,UAAU,EAAE,UAAU,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D;;;OAGG;IACH,SAAS,CACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC;;;;;OAKG;IACH,YAAY,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,GACxB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IAClC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,WAAY,YAAW,aAAa;;gBAIpC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IA4EhD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAG/B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAWV,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM7C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAY3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAY7B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA+BhD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD5E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IA0BlE;;;OAGG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE5C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;CA2BxD;AAED,qBAAa,cAAc;;gBAGd,MAAM,EAAE,aAAa;IAIjC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,SAAS,CACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAIhB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAI3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAItC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAInC,YAAY,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,GACxB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIhD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;CAGjD"}