@gadicc/loom 0.0.0-oidc-bootstrap.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.
- package/LICENSE +201 -0
- package/NOTICE +6 -0
- package/README.md +448 -0
- package/THIRD_PARTY_NOTICES.md +25 -0
- package/db/drizzle-config.d.ts +20 -0
- package/db/drizzle-config.js +34 -0
- package/db/fixtures.d.ts +31 -0
- package/db/fixtures.js +52 -0
- package/db/neon.d.ts +3 -0
- package/db/neon.js +20 -0
- package/db/neonFull.d.ts +12 -0
- package/db/neonFull.js +33 -0
- package/db/package.json +3 -0
- package/db/testing.d.ts +26 -0
- package/db/testing.js +76 -0
- package/db/testing.test.ts +28 -0
- package/db/valibot.d.ts +23 -0
- package/db/valibot.js +8 -0
- package/esm/_dnt.polyfills.d.ts +149 -0
- package/esm/_dnt.polyfills.d.ts.map +1 -0
- package/esm/_dnt.polyfills.js +163 -0
- package/esm/_dnt.shims.d.ts +2 -0
- package/esm/_dnt.shims.d.ts.map +1 -0
- package/esm/_dnt.shims.js +57 -0
- package/esm/bin/loom.d.ts +2 -0
- package/esm/bin/loom.d.ts.map +1 -0
- package/esm/bin/loom.js +11 -0
- package/esm/mod.d.ts +9 -0
- package/esm/mod.d.ts.map +1 -0
- package/esm/mod.js +8 -0
- package/esm/package.json +3 -0
- package/esm/src/apiKeys/authorize.d.ts +4 -0
- package/esm/src/apiKeys/authorize.d.ts.map +1 -0
- package/esm/src/apiKeys/authorize.js +184 -0
- package/esm/src/apiKeys/country.d.ts +3 -0
- package/esm/src/apiKeys/country.d.ts.map +1 -0
- package/esm/src/apiKeys/country.js +7 -0
- package/esm/src/apiKeys/credentials.d.ts +4 -0
- package/esm/src/apiKeys/credentials.d.ts.map +1 -0
- package/esm/src/apiKeys/credentials.js +55 -0
- package/esm/src/apiKeys/fingerprint.d.ts +3 -0
- package/esm/src/apiKeys/fingerprint.d.ts.map +1 -0
- package/esm/src/apiKeys/fingerprint.js +5 -0
- package/esm/src/apiKeys/mod.d.ts +9 -0
- package/esm/src/apiKeys/mod.d.ts.map +1 -0
- package/esm/src/apiKeys/mod.js +8 -0
- package/esm/src/apiKeys/policy.d.ts +59 -0
- package/esm/src/apiKeys/policy.d.ts.map +1 -0
- package/esm/src/apiKeys/policy.js +88 -0
- package/esm/src/apiKeys/retention.d.ts +55 -0
- package/esm/src/apiKeys/retention.d.ts.map +1 -0
- package/esm/src/apiKeys/retention.js +65 -0
- package/esm/src/apiKeys/types.d.ts +175 -0
- package/esm/src/apiKeys/types.d.ts.map +1 -0
- package/esm/src/apiKeys/types.js +1 -0
- package/esm/src/cli/externalSkills.d.ts +39 -0
- package/esm/src/cli/externalSkills.d.ts.map +1 -0
- package/esm/src/cli/externalSkills.js +177 -0
- package/esm/src/cli/mod.d.ts +337 -0
- package/esm/src/cli/mod.d.ts.map +1 -0
- package/esm/src/cli/mod.js +9268 -0
- package/esm/src/cli/projectSkills.d.ts +102 -0
- package/esm/src/cli/projectSkills.d.ts.map +1 -0
- package/esm/src/cli/projectSkills.js +592 -0
- package/esm/src/files/client.d.ts +29 -0
- package/esm/src/files/client.d.ts.map +1 -0
- package/esm/src/files/client.js +41 -0
- package/esm/src/files/errors.d.ts +37 -0
- package/esm/src/files/errors.d.ts.map +1 -0
- package/esm/src/files/errors.js +66 -0
- package/esm/src/files/hash.d.ts +15 -0
- package/esm/src/files/hash.d.ts.map +1 -0
- package/esm/src/files/hash.js +82 -0
- package/esm/src/files/memory.d.ts +29 -0
- package/esm/src/files/memory.d.ts.map +1 -0
- package/esm/src/files/memory.js +109 -0
- package/esm/src/files/metadata.d.ts +10 -0
- package/esm/src/files/metadata.d.ts.map +1 -0
- package/esm/src/files/metadata.js +186 -0
- package/esm/src/files/mod.d.ts +10 -0
- package/esm/src/files/mod.d.ts.map +1 -0
- package/esm/src/files/mod.js +9 -0
- package/esm/src/files/s3.d.ts +29 -0
- package/esm/src/files/s3.d.ts.map +1 -0
- package/esm/src/files/s3.js +107 -0
- package/esm/src/files/service.d.ts +27 -0
- package/esm/src/files/service.d.ts.map +1 -0
- package/esm/src/files/service.js +136 -0
- package/esm/src/files/types.d.ts +134 -0
- package/esm/src/files/types.d.ts.map +1 -0
- package/esm/src/files/types.js +1 -0
- package/esm/src/jobs/catalog.d.ts +32 -0
- package/esm/src/jobs/catalog.d.ts.map +1 -0
- package/esm/src/jobs/catalog.js +208 -0
- package/esm/src/jobs/controller.d.ts +28 -0
- package/esm/src/jobs/controller.d.ts.map +1 -0
- package/esm/src/jobs/controller.js +95 -0
- package/esm/src/jobs/direct.d.ts +36 -0
- package/esm/src/jobs/direct.d.ts.map +1 -0
- package/esm/src/jobs/direct.js +122 -0
- package/esm/src/jobs/events.d.ts +15 -0
- package/esm/src/jobs/events.d.ts.map +1 -0
- package/esm/src/jobs/events.js +30 -0
- package/esm/src/jobs/format.d.ts +16 -0
- package/esm/src/jobs/format.d.ts.map +1 -0
- package/esm/src/jobs/format.js +183 -0
- package/esm/src/jobs/http.d.ts +22 -0
- package/esm/src/jobs/http.d.ts.map +1 -0
- package/esm/src/jobs/http.js +44 -0
- package/esm/src/jobs/log.d.ts +2 -0
- package/esm/src/jobs/log.d.ts.map +1 -0
- package/esm/src/jobs/log.js +10 -0
- package/esm/src/jobs/mod.d.ts +10 -0
- package/esm/src/jobs/mod.d.ts.map +1 -0
- package/esm/src/jobs/mod.js +9 -0
- package/esm/src/jobs/run.d.ts +20 -0
- package/esm/src/jobs/run.d.ts.map +1 -0
- package/esm/src/jobs/run.js +57 -0
- package/esm/src/jobs/types.d.ts +31 -0
- package/esm/src/jobs/types.d.ts.map +1 -0
- package/esm/src/jobs/types.js +1 -0
- package/esm/src/mui/apiKeys.d.ts +65 -0
- package/esm/src/mui/apiKeys.d.ts.map +1 -0
- package/esm/src/mui/apiKeys.js +301 -0
- package/esm/src/mui/apiKeysView.d.ts +48 -0
- package/esm/src/mui/apiKeysView.d.ts.map +1 -0
- package/esm/src/mui/apiKeysView.js +34 -0
- package/esm/src/mui/confirm.d.ts +12 -0
- package/esm/src/mui/confirm.d.ts.map +1 -0
- package/esm/src/mui/confirm.js +78 -0
- package/esm/src/mui/mod.d.ts +4 -0
- package/esm/src/mui/mod.d.ts.map +1 -0
- package/esm/src/mui/mod.js +2 -0
- package/esm/src/next/apiKeys/mod.d.ts +64 -0
- package/esm/src/next/apiKeys/mod.d.ts.map +1 -0
- package/esm/src/next/apiKeys/mod.js +217 -0
- package/esm/src/next/auth/config.d.ts +34 -0
- package/esm/src/next/auth/config.d.ts.map +1 -0
- package/esm/src/next/auth/config.js +103 -0
- package/esm/src/next/auth/mod.d.ts +3 -0
- package/esm/src/next/auth/mod.d.ts.map +1 -0
- package/esm/src/next/auth/mod.js +2 -0
- package/esm/src/next/auth/server.d.ts +28 -0
- package/esm/src/next/auth/server.d.ts.map +1 -0
- package/esm/src/next/auth/server.js +24 -0
- package/esm/src/next/files/mod.d.ts +3 -0
- package/esm/src/next/files/mod.d.ts.map +1 -0
- package/esm/src/next/files/mod.js +2 -0
- package/esm/src/next/files/route.d.ts +99 -0
- package/esm/src/next/files/route.d.ts.map +1 -0
- package/esm/src/next/files/route.js +349 -0
- package/esm/src/next/jobs/list.d.ts +25 -0
- package/esm/src/next/jobs/list.d.ts.map +1 -0
- package/esm/src/next/jobs/list.js +39 -0
- package/esm/src/next/jobs/mod.d.ts +6 -0
- package/esm/src/next/jobs/mod.d.ts.map +1 -0
- package/esm/src/next/jobs/mod.js +5 -0
- package/esm/src/next/jobs/paths.d.ts +14 -0
- package/esm/src/next/jobs/paths.d.ts.map +1 -0
- package/esm/src/next/jobs/paths.js +40 -0
- package/esm/src/next/jobs/route.d.ts +48 -0
- package/esm/src/next/jobs/route.d.ts.map +1 -0
- package/esm/src/next/jobs/route.js +101 -0
- package/esm/src/next/jobs/run.d.ts +51 -0
- package/esm/src/next/jobs/run.d.ts.map +1 -0
- package/esm/src/next/jobs/run.js +563 -0
- package/esm/src/next/jobs/stream.d.ts +3 -0
- package/esm/src/next/jobs/stream.d.ts.map +1 -0
- package/esm/src/next/jobs/stream.js +25 -0
- package/esm/src/next/pwa/mod.d.ts +104 -0
- package/esm/src/next/pwa/mod.d.ts.map +1 -0
- package/esm/src/next/pwa/mod.js +169 -0
- package/esm/src/next/pwa/worker.d.ts +27 -0
- package/esm/src/next/pwa/worker.d.ts.map +1 -0
- package/esm/src/next/pwa/worker.js +27 -0
- package/package.json +293 -0
- package/script/_dnt.polyfills.d.ts +149 -0
- package/script/_dnt.polyfills.d.ts.map +1 -0
- package/script/_dnt.polyfills.js +166 -0
- package/script/_dnt.shims.d.ts +2 -0
- package/script/_dnt.shims.d.ts.map +1 -0
- package/script/_dnt.shims.js +60 -0
- package/script/bin/loom.d.ts +2 -0
- package/script/bin/loom.d.ts.map +1 -0
- package/script/bin/loom.js +17 -0
- package/script/mod.d.ts +9 -0
- package/script/mod.d.ts.map +1 -0
- package/script/mod.js +24 -0
- package/script/package.json +3 -0
- package/script/src/apiKeys/authorize.d.ts +4 -0
- package/script/src/apiKeys/authorize.d.ts.map +1 -0
- package/script/src/apiKeys/authorize.js +187 -0
- package/script/src/apiKeys/country.d.ts +3 -0
- package/script/src/apiKeys/country.d.ts.map +1 -0
- package/script/src/apiKeys/country.js +10 -0
- package/script/src/apiKeys/credentials.d.ts +4 -0
- package/script/src/apiKeys/credentials.d.ts.map +1 -0
- package/script/src/apiKeys/credentials.js +58 -0
- package/script/src/apiKeys/fingerprint.d.ts +3 -0
- package/script/src/apiKeys/fingerprint.d.ts.map +1 -0
- package/script/src/apiKeys/fingerprint.js +8 -0
- package/script/src/apiKeys/mod.d.ts +9 -0
- package/script/src/apiKeys/mod.d.ts.map +1 -0
- package/script/src/apiKeys/mod.js +24 -0
- package/script/src/apiKeys/policy.d.ts +59 -0
- package/script/src/apiKeys/policy.d.ts.map +1 -0
- package/script/src/apiKeys/policy.js +92 -0
- package/script/src/apiKeys/retention.d.ts +55 -0
- package/script/src/apiKeys/retention.d.ts.map +1 -0
- package/script/src/apiKeys/retention.js +70 -0
- package/script/src/apiKeys/types.d.ts +175 -0
- package/script/src/apiKeys/types.d.ts.map +1 -0
- package/script/src/apiKeys/types.js +2 -0
- package/script/src/cli/externalSkills.d.ts +39 -0
- package/script/src/cli/externalSkills.d.ts.map +1 -0
- package/script/src/cli/externalSkills.js +181 -0
- package/script/src/cli/mod.d.ts +337 -0
- package/script/src/cli/mod.d.ts.map +1 -0
- package/script/src/cli/mod.js +9337 -0
- package/script/src/cli/projectSkills.d.ts +102 -0
- package/script/src/cli/projectSkills.d.ts.map +1 -0
- package/script/src/cli/projectSkills.js +606 -0
- package/script/src/files/client.d.ts +29 -0
- package/script/src/files/client.d.ts.map +1 -0
- package/script/src/files/client.js +45 -0
- package/script/src/files/errors.d.ts +37 -0
- package/script/src/files/errors.d.ts.map +1 -0
- package/script/src/files/errors.js +76 -0
- package/script/src/files/hash.d.ts +15 -0
- package/script/src/files/hash.d.ts.map +1 -0
- package/script/src/files/hash.js +89 -0
- package/script/src/files/memory.d.ts +29 -0
- package/script/src/files/memory.d.ts.map +1 -0
- package/script/src/files/memory.js +113 -0
- package/script/src/files/metadata.d.ts +10 -0
- package/script/src/files/metadata.d.ts.map +1 -0
- package/script/src/files/metadata.js +189 -0
- package/script/src/files/mod.d.ts +10 -0
- package/script/src/files/mod.d.ts.map +1 -0
- package/script/src/files/mod.js +25 -0
- package/script/src/files/s3.d.ts +29 -0
- package/script/src/files/s3.d.ts.map +1 -0
- package/script/src/files/s3.js +110 -0
- package/script/src/files/service.d.ts +27 -0
- package/script/src/files/service.d.ts.map +1 -0
- package/script/src/files/service.js +139 -0
- package/script/src/files/types.d.ts +134 -0
- package/script/src/files/types.d.ts.map +1 -0
- package/script/src/files/types.js +2 -0
- package/script/src/jobs/catalog.d.ts +32 -0
- package/script/src/jobs/catalog.d.ts.map +1 -0
- package/script/src/jobs/catalog.js +223 -0
- package/script/src/jobs/controller.d.ts +28 -0
- package/script/src/jobs/controller.d.ts.map +1 -0
- package/script/src/jobs/controller.js +100 -0
- package/script/src/jobs/direct.d.ts +36 -0
- package/script/src/jobs/direct.d.ts.map +1 -0
- package/script/src/jobs/direct.js +128 -0
- package/script/src/jobs/events.d.ts +15 -0
- package/script/src/jobs/events.d.ts.map +1 -0
- package/script/src/jobs/events.js +37 -0
- package/script/src/jobs/format.d.ts +16 -0
- package/script/src/jobs/format.d.ts.map +1 -0
- package/script/src/jobs/format.js +193 -0
- package/script/src/jobs/http.d.ts +22 -0
- package/script/src/jobs/http.d.ts.map +1 -0
- package/script/src/jobs/http.js +50 -0
- package/script/src/jobs/log.d.ts +2 -0
- package/script/src/jobs/log.d.ts.map +1 -0
- package/script/src/jobs/log.js +13 -0
- package/script/src/jobs/mod.d.ts +10 -0
- package/script/src/jobs/mod.d.ts.map +1 -0
- package/script/src/jobs/mod.js +25 -0
- package/script/src/jobs/run.d.ts +20 -0
- package/script/src/jobs/run.d.ts.map +1 -0
- package/script/src/jobs/run.js +61 -0
- package/script/src/jobs/types.d.ts +31 -0
- package/script/src/jobs/types.d.ts.map +1 -0
- package/script/src/jobs/types.js +2 -0
- package/script/src/mui/apiKeys.d.ts +65 -0
- package/script/src/mui/apiKeys.d.ts.map +1 -0
- package/script/src/mui/apiKeys.js +327 -0
- package/script/src/mui/apiKeysView.d.ts +48 -0
- package/script/src/mui/apiKeysView.d.ts.map +1 -0
- package/script/src/mui/apiKeysView.js +40 -0
- package/script/src/mui/confirm.d.ts +12 -0
- package/script/src/mui/confirm.d.ts.map +1 -0
- package/script/src/mui/confirm.js +85 -0
- package/script/src/mui/mod.d.ts +4 -0
- package/script/src/mui/mod.d.ts.map +1 -0
- package/script/src/mui/mod.js +19 -0
- package/script/src/next/apiKeys/mod.d.ts +64 -0
- package/script/src/next/apiKeys/mod.d.ts.map +1 -0
- package/script/src/next/apiKeys/mod.js +224 -0
- package/script/src/next/auth/config.d.ts +34 -0
- package/script/src/next/auth/config.d.ts.map +1 -0
- package/script/src/next/auth/config.js +142 -0
- package/script/src/next/auth/mod.d.ts +3 -0
- package/script/src/next/auth/mod.d.ts.map +1 -0
- package/script/src/next/auth/mod.js +18 -0
- package/script/src/next/auth/server.d.ts +28 -0
- package/script/src/next/auth/server.d.ts.map +1 -0
- package/script/src/next/auth/server.js +27 -0
- package/script/src/next/files/mod.d.ts +3 -0
- package/script/src/next/files/mod.d.ts.map +1 -0
- package/script/src/next/files/mod.js +18 -0
- package/script/src/next/files/route.d.ts +99 -0
- package/script/src/next/files/route.d.ts.map +1 -0
- package/script/src/next/files/route.js +353 -0
- package/script/src/next/jobs/list.d.ts +25 -0
- package/script/src/next/jobs/list.d.ts.map +1 -0
- package/script/src/next/jobs/list.js +48 -0
- package/script/src/next/jobs/mod.d.ts +6 -0
- package/script/src/next/jobs/mod.d.ts.map +1 -0
- package/script/src/next/jobs/mod.js +21 -0
- package/script/src/next/jobs/paths.d.ts +14 -0
- package/script/src/next/jobs/paths.d.ts.map +1 -0
- package/script/src/next/jobs/paths.js +47 -0
- package/script/src/next/jobs/route.d.ts +48 -0
- package/script/src/next/jobs/route.d.ts.map +1 -0
- package/script/src/next/jobs/route.js +105 -0
- package/script/src/next/jobs/run.d.ts +51 -0
- package/script/src/next/jobs/run.d.ts.map +1 -0
- package/script/src/next/jobs/run.js +570 -0
- package/script/src/next/jobs/stream.d.ts +3 -0
- package/script/src/next/jobs/stream.d.ts.map +1 -0
- package/script/src/next/jobs/stream.js +28 -0
- package/script/src/next/pwa/mod.d.ts +104 -0
- package/script/src/next/pwa/mod.d.ts.map +1 -0
- package/script/src/next/pwa/mod.js +192 -0
- package/script/src/next/pwa/worker.d.ts +27 -0
- package/script/src/next/pwa/worker.d.ts.map +1 -0
- package/script/src/next/pwa/worker.js +33 -0
- package/skills/loom/SKILL.md +200 -0
- package/skills/loom-api-keys/SKILL.md +123 -0
- package/skills/loom-auth/SKILL.md +70 -0
- package/skills/loom-db/SKILL.md +94 -0
- package/skills/loom-db/references/db-stack.md +39 -0
- package/skills/loom-files/SKILL.md +97 -0
- package/skills/loom-jobs/SKILL.md +148 -0
- package/skills/upgrade-deps/SKILL.md +165 -0
- package/skills/upgrade-deps/agents/openai.yaml +4 -0
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.createS3FileStorage = createS3FileStorage;
|
|
4
|
+
const errors_js_1 = require("./errors.js");
|
|
5
|
+
function joinS3Key(prefix, key) {
|
|
6
|
+
const cleanPrefix = prefix?.replaceAll(/^\/+|\/+$/g, "");
|
|
7
|
+
const cleanKey = key.replaceAll(/^\/+/g, "");
|
|
8
|
+
return cleanPrefix ? `${cleanPrefix}/${cleanKey}` : cleanKey;
|
|
9
|
+
}
|
|
10
|
+
async function s3BodyToBodyInit(body) {
|
|
11
|
+
if (body instanceof Blob || body instanceof ReadableStream) {
|
|
12
|
+
return body;
|
|
13
|
+
}
|
|
14
|
+
if (body instanceof ArrayBuffer) {
|
|
15
|
+
return body;
|
|
16
|
+
}
|
|
17
|
+
if (ArrayBuffer.isView(body)) {
|
|
18
|
+
return new Blob([
|
|
19
|
+
new Uint8Array(body.buffer, body.byteOffset, body.byteLength).slice(),
|
|
20
|
+
]);
|
|
21
|
+
}
|
|
22
|
+
if (typeof body === "string") {
|
|
23
|
+
return body;
|
|
24
|
+
}
|
|
25
|
+
const transformable = body;
|
|
26
|
+
if (transformable?.transformToWebStream) {
|
|
27
|
+
return transformable.transformToWebStream();
|
|
28
|
+
}
|
|
29
|
+
if (transformable?.transformToByteArray) {
|
|
30
|
+
return new Blob([(await transformable.transformToByteArray()).slice()]);
|
|
31
|
+
}
|
|
32
|
+
throw new TypeError("Unsupported S3 object body.");
|
|
33
|
+
}
|
|
34
|
+
function optionalString(value) {
|
|
35
|
+
return typeof value === "string" && value ? value : null;
|
|
36
|
+
}
|
|
37
|
+
function optionalNumber(value) {
|
|
38
|
+
return typeof value === "number" ? value : undefined;
|
|
39
|
+
}
|
|
40
|
+
function isObjectAlreadyExistsError(error) {
|
|
41
|
+
if (typeof error !== "object" || error === null) {
|
|
42
|
+
return false;
|
|
43
|
+
}
|
|
44
|
+
const candidate = error;
|
|
45
|
+
return (candidate.$metadata?.httpStatusCode === 409 ||
|
|
46
|
+
candidate.$metadata?.httpStatusCode === 412 ||
|
|
47
|
+
candidate.name === "ConditionalRequestConflict" ||
|
|
48
|
+
candidate.name === "PreconditionFailed");
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Creates an S3-compatible storage adapter without making AWS SDK v3 a Loom
|
|
52
|
+
* dependency. Consumers pass their own client and command constructors.
|
|
53
|
+
*/
|
|
54
|
+
function createS3FileStorage(options) {
|
|
55
|
+
const provider = options.provider ?? "s3";
|
|
56
|
+
return {
|
|
57
|
+
bucket: options.bucket,
|
|
58
|
+
provider,
|
|
59
|
+
deleteObject(input) {
|
|
60
|
+
if (!options.commands.DeleteObjectCommand) {
|
|
61
|
+
return Promise.resolve();
|
|
62
|
+
}
|
|
63
|
+
return options.client.send(new options.commands.DeleteObjectCommand({
|
|
64
|
+
Bucket: input.bucket ?? options.bucket,
|
|
65
|
+
Key: input.objectKey,
|
|
66
|
+
})).then(() => undefined);
|
|
67
|
+
},
|
|
68
|
+
async getObject(input) {
|
|
69
|
+
const result = await options.client.send(new options.commands.GetObjectCommand({
|
|
70
|
+
Bucket: input.bucket ?? options.bucket,
|
|
71
|
+
Key: input.objectKey,
|
|
72
|
+
}));
|
|
73
|
+
if (!("Body" in result) || result.Body === undefined) {
|
|
74
|
+
return null;
|
|
75
|
+
}
|
|
76
|
+
return {
|
|
77
|
+
body: await s3BodyToBodyInit(result.Body),
|
|
78
|
+
byteSize: optionalNumber(result.ContentLength),
|
|
79
|
+
contentType: optionalString(result.ContentType),
|
|
80
|
+
etag: optionalString(result.ETag) ?? undefined,
|
|
81
|
+
};
|
|
82
|
+
},
|
|
83
|
+
async putObject(input) {
|
|
84
|
+
const objectKey = joinS3Key(options.keyPrefix, input.objectKey);
|
|
85
|
+
try {
|
|
86
|
+
await options.client.send(new options.commands.PutObjectCommand({
|
|
87
|
+
Body: input.body,
|
|
88
|
+
Bucket: options.bucket,
|
|
89
|
+
ContentLength: input.byteSize,
|
|
90
|
+
ContentType: input.detectedContentType ?? input.contentType ??
|
|
91
|
+
undefined,
|
|
92
|
+
IfNoneMatch: options.preventOverwrite ? "*" : undefined,
|
|
93
|
+
Key: objectKey,
|
|
94
|
+
Metadata: input.metadata,
|
|
95
|
+
}));
|
|
96
|
+
}
|
|
97
|
+
catch (error) {
|
|
98
|
+
if (options.preventOverwrite && isObjectAlreadyExistsError(error)) {
|
|
99
|
+
throw new errors_js_1.LoomFileDuplicateError("Stored file object already exists.");
|
|
100
|
+
}
|
|
101
|
+
throw error;
|
|
102
|
+
}
|
|
103
|
+
return {
|
|
104
|
+
bucket: options.bucket,
|
|
105
|
+
objectKey,
|
|
106
|
+
storageProvider: provider,
|
|
107
|
+
};
|
|
108
|
+
},
|
|
109
|
+
};
|
|
110
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { LoomFileRecord, LoomFileRepository, LoomFileService, LoomFileStorageAdapter } from "./types.js";
|
|
2
|
+
export interface CreateLoomFileServiceOptions<TRecord extends LoomFileRecord = LoomFileRecord> {
|
|
3
|
+
/**
|
|
4
|
+
* Controls what happens when the same SHA-256 digest already has an active
|
|
5
|
+
* record. `reuse` preserves content-addressed dedupe, `reject` returns a
|
|
6
|
+
* 409-style LoomFileDuplicateError, and `store` preserves the legacy
|
|
7
|
+
* `reuseExisting: false` behavior of attempting another storage/DB write.
|
|
8
|
+
*/
|
|
9
|
+
duplicatePolicy?: "reject" | "reuse" | "store";
|
|
10
|
+
objectKey?: (input: {
|
|
11
|
+
byteSize: number;
|
|
12
|
+
sha256: string;
|
|
13
|
+
}) => string;
|
|
14
|
+
repository: LoomFileRepository<TRecord>;
|
|
15
|
+
/**
|
|
16
|
+
* @deprecated Use duplicatePolicy instead. `false` maps to `store` unless
|
|
17
|
+
* duplicatePolicy is explicitly provided.
|
|
18
|
+
*/
|
|
19
|
+
reuseExisting?: boolean;
|
|
20
|
+
storage: LoomFileStorageAdapter;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Creates the core files service used by route handlers and app-local adapters.
|
|
24
|
+
* It dedupes by SHA-256 before writing to object storage by default.
|
|
25
|
+
*/
|
|
26
|
+
export declare function createLoomFileService<TRecord extends LoomFileRecord = LoomFileRecord>(options: CreateLoomFileServiceOptions<TRecord>): LoomFileService<TRecord>;
|
|
27
|
+
//# sourceMappingURL=service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/src/files/service.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B,CAC3C,OAAO,SAAS,cAAc,GAAG,cAAc;IAE/C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAC/C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IACpE,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACxC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAkDD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,cAAc,GAAG,cAAc,EAE/C,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC7C,eAAe,CAAC,OAAO,CAAC,CAgH1B"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.createLoomFileService = createLoomFileService;
|
|
4
|
+
const errors_js_1 = require("./errors.js");
|
|
5
|
+
const hash_js_1 = require("./hash.js");
|
|
6
|
+
const metadata_js_1 = require("./metadata.js");
|
|
7
|
+
function normalizeNullableText(value) {
|
|
8
|
+
const normalized = value?.trim();
|
|
9
|
+
return normalized ? normalized : null;
|
|
10
|
+
}
|
|
11
|
+
function isActiveRecord(record) {
|
|
12
|
+
return !record.deletedAt;
|
|
13
|
+
}
|
|
14
|
+
const visibilityRank = {
|
|
15
|
+
private: 0,
|
|
16
|
+
authenticated: 1,
|
|
17
|
+
public: 2,
|
|
18
|
+
};
|
|
19
|
+
function normalizeVisibility(visibility) {
|
|
20
|
+
return visibility ?? "private";
|
|
21
|
+
}
|
|
22
|
+
function mostPermissiveVisibility(a, b) {
|
|
23
|
+
const normalizedA = normalizeVisibility(a);
|
|
24
|
+
const normalizedB = normalizeVisibility(b);
|
|
25
|
+
return visibilityRank[normalizedB] > visibilityRank[normalizedA]
|
|
26
|
+
? normalizedB
|
|
27
|
+
: normalizedA;
|
|
28
|
+
}
|
|
29
|
+
async function maybeUpgradeExistingVisibility(repository, record, requestedVisibility) {
|
|
30
|
+
const nextVisibility = mostPermissiveVisibility(record.visibility, requestedVisibility);
|
|
31
|
+
if (nextVisibility === record.visibility)
|
|
32
|
+
return record;
|
|
33
|
+
return await repository.updateVisibility?.(record.id, nextVisibility) ??
|
|
34
|
+
record;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Creates the core files service used by route handlers and app-local adapters.
|
|
38
|
+
* It dedupes by SHA-256 before writing to object storage by default.
|
|
39
|
+
*/
|
|
40
|
+
function createLoomFileService(options) {
|
|
41
|
+
const duplicatePolicy = options.duplicatePolicy ??
|
|
42
|
+
(options.reuseExisting === false ? "store" : "reuse");
|
|
43
|
+
return {
|
|
44
|
+
async getDownloadObject(record) {
|
|
45
|
+
if (!options.storage.getObject) {
|
|
46
|
+
throw new errors_js_1.LoomFileStorageReadUnsupportedError();
|
|
47
|
+
}
|
|
48
|
+
const object = await options.storage.getObject({
|
|
49
|
+
bucket: record.bucket,
|
|
50
|
+
objectKey: record.objectKey,
|
|
51
|
+
record,
|
|
52
|
+
});
|
|
53
|
+
if (!object) {
|
|
54
|
+
throw new errors_js_1.LoomFileNotFoundError("Stored file object not found.");
|
|
55
|
+
}
|
|
56
|
+
return object;
|
|
57
|
+
},
|
|
58
|
+
async getFileById(id) {
|
|
59
|
+
if (!options.repository.findById) {
|
|
60
|
+
throw new errors_js_1.LoomFileNotFoundError("This files repository does not support id lookups.");
|
|
61
|
+
}
|
|
62
|
+
const record = await options.repository.findById(id);
|
|
63
|
+
return record && isActiveRecord(record) ? record : null;
|
|
64
|
+
},
|
|
65
|
+
async getFileBySha256(sha256) {
|
|
66
|
+
const record = await options.repository.findBySha256(sha256);
|
|
67
|
+
return record && isActiveRecord(record) ? record : null;
|
|
68
|
+
},
|
|
69
|
+
async saveFile(input) {
|
|
70
|
+
const bytes = await (0, hash_js_1.readLoomFileBodyBytes)(input.body, {
|
|
71
|
+
maxBytes: input.maxBytes,
|
|
72
|
+
});
|
|
73
|
+
const sha256 = await (0, hash_js_1.sha256Hex)(bytes);
|
|
74
|
+
(0, hash_js_1.assertExpectedSha256)(sha256, input.expectedSha256 ?? null);
|
|
75
|
+
const existing = await options.repository.findBySha256(sha256);
|
|
76
|
+
if (existing && isActiveRecord(existing)) {
|
|
77
|
+
if (duplicatePolicy === "reject") {
|
|
78
|
+
throw new errors_js_1.LoomFileDuplicateError();
|
|
79
|
+
}
|
|
80
|
+
if (duplicatePolicy === "reuse") {
|
|
81
|
+
const record = await maybeUpgradeExistingVisibility(options.repository, existing, input.visibility);
|
|
82
|
+
return {
|
|
83
|
+
byteSize: record.byteSize,
|
|
84
|
+
created: false,
|
|
85
|
+
detectedContentType: record.detectedContentType,
|
|
86
|
+
kind: record.kind,
|
|
87
|
+
record,
|
|
88
|
+
reusedExisting: true,
|
|
89
|
+
sha256,
|
|
90
|
+
stored: false,
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
const contentType = normalizeNullableText(input.contentType);
|
|
95
|
+
const detected = (0, metadata_js_1.detectLoomFileMetadata)(bytes, { contentType });
|
|
96
|
+
const objectKey = input.objectKey ??
|
|
97
|
+
options.objectKey?.({ byteSize: bytes.byteLength, sha256 }) ??
|
|
98
|
+
sha256;
|
|
99
|
+
const storageReference = await options.storage.putObject({
|
|
100
|
+
body: bytes,
|
|
101
|
+
byteSize: bytes.byteLength,
|
|
102
|
+
contentType,
|
|
103
|
+
detectedContentType: detected.detectedContentType,
|
|
104
|
+
metadata: {
|
|
105
|
+
sha256,
|
|
106
|
+
},
|
|
107
|
+
objectKey,
|
|
108
|
+
sha256,
|
|
109
|
+
});
|
|
110
|
+
const record = await options.repository.insert({
|
|
111
|
+
bucket: storageReference.bucket ?? options.storage.bucket ?? null,
|
|
112
|
+
byteSize: bytes.byteLength,
|
|
113
|
+
contentType,
|
|
114
|
+
detectedContentType: detected.detectedContentType,
|
|
115
|
+
imageMeta: detected.imageMeta,
|
|
116
|
+
kind: detected.kind,
|
|
117
|
+
meta: input.meta ?? {},
|
|
118
|
+
objectKey: storageReference.objectKey,
|
|
119
|
+
originalFilename: normalizeNullableText(input.originalFilename),
|
|
120
|
+
ownerId: normalizeNullableText(input.ownerId),
|
|
121
|
+
ownerType: normalizeNullableText(input.ownerType),
|
|
122
|
+
sha256,
|
|
123
|
+
storageProvider: storageReference.storageProvider ??
|
|
124
|
+
options.storage.provider,
|
|
125
|
+
visibility: normalizeVisibility(input.visibility),
|
|
126
|
+
});
|
|
127
|
+
return {
|
|
128
|
+
byteSize: bytes.byteLength,
|
|
129
|
+
created: true,
|
|
130
|
+
detectedContentType: detected.detectedContentType,
|
|
131
|
+
kind: detected.kind,
|
|
132
|
+
record,
|
|
133
|
+
reusedExisting: false,
|
|
134
|
+
sha256,
|
|
135
|
+
stored: true,
|
|
136
|
+
};
|
|
137
|
+
},
|
|
138
|
+
};
|
|
139
|
+
}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
export type LoomFileKind = "archive" | "audio" | "image" | "other" | "pdf" | "text" | "video";
|
|
2
|
+
export type LoomFileBody = ArrayBuffer | ArrayBufferView | Blob | ReadableStream<Uint8Array>;
|
|
3
|
+
export interface LoomFileOwner {
|
|
4
|
+
ownerId: string;
|
|
5
|
+
ownerType: string;
|
|
6
|
+
}
|
|
7
|
+
export type LoomFileVisibility = "authenticated" | "private" | "public";
|
|
8
|
+
export interface LoomImageMetadata extends Record<string, unknown> {
|
|
9
|
+
format: string;
|
|
10
|
+
height: number;
|
|
11
|
+
width: number;
|
|
12
|
+
}
|
|
13
|
+
export interface LoomFileDetectedMetadata {
|
|
14
|
+
detectedContentType: string | null;
|
|
15
|
+
imageMeta: LoomImageMetadata | null;
|
|
16
|
+
kind: LoomFileKind;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Canonical file metadata shape mirrored by the managed `files` schema
|
|
20
|
+
* blueprint. Apps may add domain associations in separate local tables.
|
|
21
|
+
*/
|
|
22
|
+
export interface LoomFileRecord {
|
|
23
|
+
audioMeta: Record<string, unknown> | null;
|
|
24
|
+
bucket: string | null;
|
|
25
|
+
byteSize: number;
|
|
26
|
+
contentType: string | null;
|
|
27
|
+
createdAt?: Date;
|
|
28
|
+
deletedAt?: Date | null;
|
|
29
|
+
detectedContentType: string | null;
|
|
30
|
+
id: string;
|
|
31
|
+
imageMeta: Record<string, unknown> | null;
|
|
32
|
+
kind: LoomFileKind;
|
|
33
|
+
meta: Record<string, unknown>;
|
|
34
|
+
objectKey: string;
|
|
35
|
+
originalFilename: string | null;
|
|
36
|
+
ownerId: string | null;
|
|
37
|
+
ownerType: string | null;
|
|
38
|
+
sha256: string;
|
|
39
|
+
storageProvider: string;
|
|
40
|
+
updatedAt?: Date;
|
|
41
|
+
visibility: LoomFileVisibility;
|
|
42
|
+
}
|
|
43
|
+
export interface LoomFileCreateInput {
|
|
44
|
+
audioMeta?: Record<string, unknown> | null;
|
|
45
|
+
bucket?: string | null;
|
|
46
|
+
byteSize: number;
|
|
47
|
+
contentType?: string | null;
|
|
48
|
+
detectedContentType?: string | null;
|
|
49
|
+
imageMeta?: Record<string, unknown> | null;
|
|
50
|
+
kind: LoomFileKind;
|
|
51
|
+
meta?: Record<string, unknown>;
|
|
52
|
+
objectKey: string;
|
|
53
|
+
originalFilename?: string | null;
|
|
54
|
+
ownerId?: string | null;
|
|
55
|
+
ownerType?: string | null;
|
|
56
|
+
sha256: string;
|
|
57
|
+
storageProvider: string;
|
|
58
|
+
visibility?: LoomFileVisibility;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Persistence adapter for the app-local Drizzle table materialized by
|
|
62
|
+
* `loom add files`.
|
|
63
|
+
*/
|
|
64
|
+
export interface LoomFileRepository<TRecord extends LoomFileRecord = LoomFileRecord> {
|
|
65
|
+
findById?(id: string): Promise<TRecord | null>;
|
|
66
|
+
findBySha256(sha256: string): Promise<TRecord | null>;
|
|
67
|
+
insert(input: LoomFileCreateInput): Promise<TRecord>;
|
|
68
|
+
updateVisibility?(id: string, visibility: LoomFileVisibility): Promise<TRecord>;
|
|
69
|
+
}
|
|
70
|
+
export interface LoomFileStorageReference {
|
|
71
|
+
bucket?: string | null;
|
|
72
|
+
objectKey: string;
|
|
73
|
+
storageProvider?: string;
|
|
74
|
+
}
|
|
75
|
+
export interface LoomFileStoragePutInput {
|
|
76
|
+
body: Uint8Array;
|
|
77
|
+
byteSize: number;
|
|
78
|
+
contentType?: string | null;
|
|
79
|
+
detectedContentType?: string | null;
|
|
80
|
+
metadata?: Record<string, string>;
|
|
81
|
+
objectKey: string;
|
|
82
|
+
sha256: string;
|
|
83
|
+
}
|
|
84
|
+
export interface LoomFileStorageGetInput {
|
|
85
|
+
bucket?: string | null;
|
|
86
|
+
objectKey: string;
|
|
87
|
+
record?: LoomFileRecord;
|
|
88
|
+
}
|
|
89
|
+
export interface LoomFileStorageGetResult {
|
|
90
|
+
body: BodyInit;
|
|
91
|
+
byteSize?: number;
|
|
92
|
+
contentType?: string | null;
|
|
93
|
+
etag?: string;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Object-storage adapter boundary. Provider-specific packages such as S3 should
|
|
97
|
+
* implement this instead of leaking SDK types through the core runtime.
|
|
98
|
+
*/
|
|
99
|
+
export interface LoomFileStorageAdapter {
|
|
100
|
+
readonly bucket?: string | null;
|
|
101
|
+
readonly provider: string;
|
|
102
|
+
deleteObject?(input: LoomFileStorageGetInput): Promise<void>;
|
|
103
|
+
getObject?(input: LoomFileStorageGetInput): Promise<LoomFileStorageGetResult | null>;
|
|
104
|
+
putObject(input: LoomFileStoragePutInput): Promise<LoomFileStorageReference>;
|
|
105
|
+
}
|
|
106
|
+
export interface SaveLoomFileInput {
|
|
107
|
+
body: LoomFileBody;
|
|
108
|
+
contentType?: string | null;
|
|
109
|
+
expectedSha256?: string | null;
|
|
110
|
+
maxBytes?: number;
|
|
111
|
+
meta?: Record<string, unknown>;
|
|
112
|
+
objectKey?: string;
|
|
113
|
+
originalFilename?: string | null;
|
|
114
|
+
ownerId?: string | null;
|
|
115
|
+
ownerType?: string | null;
|
|
116
|
+
visibility?: LoomFileVisibility;
|
|
117
|
+
}
|
|
118
|
+
export interface SaveLoomFileResult<TRecord extends LoomFileRecord = LoomFileRecord> {
|
|
119
|
+
byteSize: number;
|
|
120
|
+
created: boolean;
|
|
121
|
+
detectedContentType: string | null;
|
|
122
|
+
kind: LoomFileKind;
|
|
123
|
+
record: TRecord;
|
|
124
|
+
reusedExisting: boolean;
|
|
125
|
+
sha256: string;
|
|
126
|
+
stored: boolean;
|
|
127
|
+
}
|
|
128
|
+
export interface LoomFileService<TRecord extends LoomFileRecord = LoomFileRecord> {
|
|
129
|
+
getDownloadObject(record: TRecord): Promise<LoomFileStorageGetResult>;
|
|
130
|
+
getFileById(id: string): Promise<TRecord | null>;
|
|
131
|
+
getFileBySha256(sha256: string): Promise<TRecord | null>;
|
|
132
|
+
saveFile(input: SaveLoomFileInput): Promise<SaveLoomFileResult<TRecord>>;
|
|
133
|
+
}
|
|
134
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/files/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { JobCatalog, JobDefinition, JobMeta, JobParams, JobParamsDefinition } from "./types.js";
|
|
2
|
+
type JobModule<TParams extends Record<string, any>> = Pick<JobDefinition<TParams>, "handler" | "meta">;
|
|
3
|
+
/**
|
|
4
|
+
* Create a catalog entry that exposes metadata immediately and loads its job
|
|
5
|
+
* implementation only when selected for execution.
|
|
6
|
+
*
|
|
7
|
+
* This prevents HTTP routes and direct runners from evaluating every job's
|
|
8
|
+
* transitive dependencies while constructing a catalog.
|
|
9
|
+
*/
|
|
10
|
+
export declare function createLazyJob<TParams extends Record<string, any> = Record<string, any>>(meta: JobDefinition<TParams>["meta"], load: () => Promise<JobModule<TParams>>): JobDefinition<TParams>;
|
|
11
|
+
export declare function createJobCatalog<const TJobs extends readonly JobDefinition[]>(jobs: TJobs): JobCatalog<TJobs[number]>;
|
|
12
|
+
export declare function getJob<TJob extends JobDefinition>(catalog: JobCatalog<TJob>, id: string): TJob | undefined;
|
|
13
|
+
export declare function isJobMeta(value: unknown): value is JobMeta;
|
|
14
|
+
export declare function isJobDefinition(value: unknown): value is JobDefinition;
|
|
15
|
+
export declare function isJobCatalog<TJob extends JobDefinition>(value: unknown): value is JobCatalog<TJob>;
|
|
16
|
+
export declare function collectJobDefinitions(source: Record<string, unknown> | Iterable<unknown>): JobDefinition[];
|
|
17
|
+
export declare function collectJobMetas(source: Record<string, unknown> | Iterable<unknown>): JobMeta[];
|
|
18
|
+
export declare function createJobCatalogFromSource<TJob extends JobDefinition>(source: JobCatalog<TJob> | Record<string, unknown> | Iterable<unknown>): JobCatalog<TJob>;
|
|
19
|
+
export interface ResolvedJobSelection<TJob extends JobDefinition> {
|
|
20
|
+
id: string;
|
|
21
|
+
job: TJob;
|
|
22
|
+
index: number | null;
|
|
23
|
+
}
|
|
24
|
+
export declare function resolveJobSelection<TJob extends JobDefinition>(catalog: JobCatalog<TJob>, selection: string): ResolvedJobSelection<TJob>;
|
|
25
|
+
export declare function createJobUsageText<TJob extends JobDefinition>(catalog: JobCatalog<TJob>, command?: string): string;
|
|
26
|
+
export declare function validateAndParseParams(rawParams: Record<string, string>, paramsDef?: JobParamsDefinition): {
|
|
27
|
+
parsed: JobParams;
|
|
28
|
+
errors: string[];
|
|
29
|
+
};
|
|
30
|
+
export declare function createJobHelpText(meta: JobMeta, command?: string): string;
|
|
31
|
+
export {};
|
|
32
|
+
//# sourceMappingURL=catalog.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,KAAK,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CACxD,aAAa,CAAC,OAAO,CAAC,EACtB,SAAS,GAAG,MAAM,CACnB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAEzD,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EACpC,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GACtC,aAAa,CAAC,OAAO,CAAC,CAkBxB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,aAAa,EAAE,EAC3E,IAAI,EAAE,KAAK,GACV,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAsB3B;AAED,wBAAgB,MAAM,CAAC,IAAI,SAAS,aAAa,EAC/C,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,EACzB,EAAE,EAAE,MAAM,GACT,IAAI,GAAG,SAAS,CAElB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAO1D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAS,aAAa,EACrD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,CAY3B;AAUD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAClD,aAAa,EAAE,CAEjB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAClD,OAAO,EAAE,CAEX;AAED,wBAAgB,0BAA0B,CAAC,IAAI,SAAS,aAAa,EACnE,MAAM,EACF,UAAU,CAAC,IAAI,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,QAAQ,CAAC,OAAO,CAAC,GACpB,UAAU,CAAC,IAAI,CAAC,CAMlB;AAED,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,aAAa;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,IAAI,CAAC;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,aAAa,EAC5D,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,EACzB,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAAC,IAAI,CAAC,CA6B5B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,aAAa,EAC3D,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,EACzB,OAAO,SAAa,GACnB,MAAM,CAgBR;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,SAAS,CAAC,EAAE,mBAAmB,GAC9B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsDzC;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,OAAO,SAAa,GACnB,MAAM,CAmCR"}
|