@dimah-s3/db 1.6.0 → 1.7.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/dist/cli.js +1 -1
- package/dist/client/db-object-list-accessors.d.ts +9 -1
- package/dist/client/db-object-list-accessors.d.ts.map +1 -1
- package/dist/client/index.d.ts +1 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +3 -2
- package/dist/client/index.js.map +1 -1
- package/dist/hooks/create-object-access-guard.d.ts +9 -1
- package/dist/hooks/create-object-access-guard.d.ts.map +1 -1
- package/dist/hooks/create-quota-guard.d.ts +4 -0
- package/dist/hooks/create-quota-guard.d.ts.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +105 -33
- package/dist/index.js.map +1 -1
- package/dist/plugin/create-database-endpoints.d.ts.map +1 -1
- package/dist/plugin/create-database-lifecycle-hooks.d.ts +7 -0
- package/dist/plugin/create-database-lifecycle-hooks.d.ts.map +1 -1
- package/dist/plugin/db.d.ts +8 -2
- package/dist/plugin/db.d.ts.map +1 -1
- package/dist/plugin/memoize-scope-resolver.d.ts +8 -0
- package/dist/plugin/memoize-scope-resolver.d.ts.map +1 -0
- package/dist/types/storage-object.d.ts +25 -2
- package/dist/types/storage-object.d.ts.map +1 -1
- package/package.json +4 -4
package/dist/cli.js
CHANGED
|
@@ -13,6 +13,14 @@ export type DbObjectListAccessors = {
|
|
|
13
13
|
/** Verified size. `null` while the object is still pending. */
|
|
14
14
|
getDescription: (object: DbClientObject) => string | null;
|
|
15
15
|
};
|
|
16
|
+
/** Options for {@link dbObjectListAccessors}. */
|
|
17
|
+
export type DbObjectListAccessorsOptions = {
|
|
18
|
+
/**
|
|
19
|
+
* Size label for `getDescription`. In React, pass `useFormatFileSize()`
|
|
20
|
+
* from `@dimah-s3/react` to follow the `S3Provider` `locale`.
|
|
21
|
+
*/
|
|
22
|
+
formatSize?: (bytes: number) => string;
|
|
23
|
+
};
|
|
16
24
|
/**
|
|
17
25
|
* Map `api.db.listObjects` rows onto `ObjectList` accessors.
|
|
18
26
|
*
|
|
@@ -24,5 +32,5 @@ export type DbObjectListAccessors = {
|
|
|
24
32
|
* <ObjectList list={list} {...files} />
|
|
25
33
|
* ```
|
|
26
34
|
*/
|
|
27
|
-
export declare function dbObjectListAccessors(): DbObjectListAccessors;
|
|
35
|
+
export declare function dbObjectListAccessors(options?: DbObjectListAccessorsOptions): DbObjectListAccessors;
|
|
28
36
|
//# sourceMappingURL=db-object-list-accessors.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"db-object-list-accessors.d.ts","sourceRoot":"","sources":["../../src/client/db-object-list-accessors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc;IACd,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IAC3C,gDAAgD;IAChD,YAAY,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IACjD,gDAAgD;IAChD,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IAC7C,qCAAqC;IACrC,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IAChD,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;IACvD,+DAA+D;IAC/D,cAAc,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;CAC3D,CAAC;AAMF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,
|
|
1
|
+
{"version":3,"file":"db-object-list-accessors.d.ts","sourceRoot":"","sources":["../../src/client/db-object-list-accessors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc;IACd,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IAC3C,gDAAgD;IAChD,YAAY,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IACjD,gDAAgD;IAChD,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IAC7C,qCAAqC;IACrC,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IAChD,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;IACvD,+DAA+D;IAC/D,cAAc,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;CAC3D,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG;IACzC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC,CAAC;AAMF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAYvB"}
|
package/dist/client/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { dbClient } from "./db-client";
|
|
2
2
|
export { dbObjectQuery, type DbObjectListSource, type DbObjectQueryInput, type DbObjectQueryOptions, type DbObjectQueryPage, } from "./db-object-query";
|
|
3
|
-
export { dbObjectListAccessors, type DbObjectListAccessors, } from "./db-object-list-accessors";
|
|
3
|
+
export { dbObjectListAccessors, type DbObjectListAccessors, type DbObjectListAccessorsOptions, } from "./db-object-list-accessors";
|
|
4
4
|
export type { DbClientGetInput, DbClientListInput, DbClientListResponse, DbClientObject, } from "./db-client";
|
|
5
5
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC"}
|
package/dist/client/index.js
CHANGED
|
@@ -45,14 +45,15 @@ function dbObjectQuery(listObjects, options) {
|
|
|
45
45
|
function displayName(object) {
|
|
46
46
|
return object.filename || fileNameFromKey(object.key) || object.key;
|
|
47
47
|
}
|
|
48
|
-
function dbObjectListAccessors() {
|
|
48
|
+
function dbObjectListAccessors(options = {}) {
|
|
49
|
+
const formatSize = options.formatSize ?? ((bytes) => formatFileSize(bytes));
|
|
49
50
|
return {
|
|
50
51
|
getKey: (object) => object.id,
|
|
51
52
|
getObjectKey: (object) => object.key,
|
|
52
53
|
getLabel: displayName,
|
|
53
54
|
getFileName: displayName,
|
|
54
55
|
getFileType: (object) => object.contentType,
|
|
55
|
-
getDescription: (object) => object.size != null ?
|
|
56
|
+
getDescription: (object) => object.size != null ? formatSize(object.size) : null
|
|
56
57
|
};
|
|
57
58
|
}
|
|
58
59
|
|
package/dist/client/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/client/db-client.ts","../../src/client/db-object-query.ts","../../src/client/db-object-list-accessors.ts"],"names":[],"mappings":";;;AAkCO,SAAS,QAAA,GAAW;AACzB,EAAA,OAAO,kBAAA,CAAmB;AAAA,IACxB,EAAA,EAAI,IAAA;AAAA,IACJ,oBAAoB,EAAC;AAAA,IACrB,UAAA,EAAY,CAAC,MAAA,MAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMvB,WAAA,EAAa,CACX,KAAA,EACA,IAAA,KAEA,OAA6B,UAAA,CAAW,IAAA,EAAM,SAAS,CAAA,EAAG;AAAA,QACxD,MAAA,EAAQ,KAAA;AAAA,QACR,KAAA,EAAO,KAAA;AAAA,QACP,QAAQ,IAAA,EAAM;AAAA,OACf,CAAA;AAAA,MACH,WAAW,CAAC,KAAA,KACV,OAAmC,UAAA,CAAW,IAAA,EAAM,QAAQ,CAAA,EAAG;AAAA,QAC7D,MAAA,EAAQ,KAAA;AAAA,QACR,KAAA,EAAO;AAAA,OACR;AAAA,KACL;AAAA,GACD,CAAA;AACH;;;ACXO,SAAS,aAAA,CACd,aACA,OAAA,EACA;AACA,EAAA,OAAO,eAAe,MACpB,KAAA,EAC4B;AAC5B,IAAA,MAAM,aAAgC,EAAC;AACvC,IAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,UAAA,CAAW,MAAA,GAAS,KAAA,CAAM,MAAA;AAC5C,IAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,UAAA,CAAW,MAAA,GAAS,KAAA,CAAM,MAAA;AAC5C,IAAA,IAAI,OAAA,EAAS,KAAA,EAAO,UAAA,CAAW,KAAA,GAAQ,OAAA,CAAQ,KAAA;AAC/C,IAAA,IAAI,OAAA,EAAS,MAAA,EAAQ,UAAA,CAAW,MAAA,GAAS,OAAA,CAAQ,MAAA;AACjD,IAAA,IAAI,OAAA,EAAS,WAAA,EAAa,UAAA,CAAW,WAAA,GAAc,OAAA,CAAQ,WAAA;AAC3D,IAAA,IAAI,OAAA,EAAS,KAAA,IAAS,IAAA,EAAM,UAAA,CAAW,QAAQ,OAAA,CAAQ,KAAA;AAEvD,IAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,UAAA,EAAY,EAAE,MAAA,EAAQ,KAAA,CAAM,QAAQ,CAAA;AACnE,IAAA,OAAO;AAAA,MACL,OAAO,IAAA,CAAK,OAAA;AAAA,MACZ,UAAA,EAAY,KAAK,UAAA,IAAc,IAAA;AAAA,MAC/B,OAAO,IAAA,CAAK;AAAA,KACd;AAAA,EACF,CAAA;AACF;
|
|
1
|
+
{"version":3,"sources":["../../src/client/db-client.ts","../../src/client/db-object-query.ts","../../src/client/db-object-list-accessors.ts"],"names":[],"mappings":";;;AAkCO,SAAS,QAAA,GAAW;AACzB,EAAA,OAAO,kBAAA,CAAmB;AAAA,IACxB,EAAA,EAAI,IAAA;AAAA,IACJ,oBAAoB,EAAC;AAAA,IACrB,UAAA,EAAY,CAAC,MAAA,MAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMvB,WAAA,EAAa,CACX,KAAA,EACA,IAAA,KAEA,OAA6B,UAAA,CAAW,IAAA,EAAM,SAAS,CAAA,EAAG;AAAA,QACxD,MAAA,EAAQ,KAAA;AAAA,QACR,KAAA,EAAO,KAAA;AAAA,QACP,QAAQ,IAAA,EAAM;AAAA,OACf,CAAA;AAAA,MACH,WAAW,CAAC,KAAA,KACV,OAAmC,UAAA,CAAW,IAAA,EAAM,QAAQ,CAAA,EAAG;AAAA,QAC7D,MAAA,EAAQ,KAAA;AAAA,QACR,KAAA,EAAO;AAAA,OACR;AAAA,KACL;AAAA,GACD,CAAA;AACH;;;ACXO,SAAS,aAAA,CACd,aACA,OAAA,EACA;AACA,EAAA,OAAO,eAAe,MACpB,KAAA,EAC4B;AAC5B,IAAA,MAAM,aAAgC,EAAC;AACvC,IAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,UAAA,CAAW,MAAA,GAAS,KAAA,CAAM,MAAA;AAC5C,IAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,UAAA,CAAW,MAAA,GAAS,KAAA,CAAM,MAAA;AAC5C,IAAA,IAAI,OAAA,EAAS,KAAA,EAAO,UAAA,CAAW,KAAA,GAAQ,OAAA,CAAQ,KAAA;AAC/C,IAAA,IAAI,OAAA,EAAS,MAAA,EAAQ,UAAA,CAAW,MAAA,GAAS,OAAA,CAAQ,MAAA;AACjD,IAAA,IAAI,OAAA,EAAS,WAAA,EAAa,UAAA,CAAW,WAAA,GAAc,OAAA,CAAQ,WAAA;AAC3D,IAAA,IAAI,OAAA,EAAS,KAAA,IAAS,IAAA,EAAM,UAAA,CAAW,QAAQ,OAAA,CAAQ,KAAA;AAEvD,IAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,UAAA,EAAY,EAAE,MAAA,EAAQ,KAAA,CAAM,QAAQ,CAAA;AACnE,IAAA,OAAO;AAAA,MACL,OAAO,IAAA,CAAK,OAAA;AAAA,MACZ,UAAA,EAAY,KAAK,UAAA,IAAc,IAAA;AAAA,MAC/B,OAAO,IAAA,CAAK;AAAA,KACd;AAAA,EACF,CAAA;AACF;AC5CA,SAAS,YAAY,MAAA,EAAgC;AACnD,EAAA,OAAO,OAAO,QAAA,IAAY,eAAA,CAAgB,MAAA,CAAO,GAAG,KAAK,MAAA,CAAO,GAAA;AAClE;AAaO,SAAS,qBAAA,CACd,OAAA,GAAwC,EAAC,EAClB;AACvB,EAAA,MAAM,aACJ,OAAA,CAAQ,UAAA,KAAe,CAAC,KAAA,KAAkB,eAAe,KAAK,CAAA,CAAA;AAChE,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,CAAC,MAAA,KAAW,MAAA,CAAO,EAAA;AAAA,IAC3B,YAAA,EAAc,CAAC,MAAA,KAAW,MAAA,CAAO,GAAA;AAAA,IACjC,QAAA,EAAU,WAAA;AAAA,IACV,WAAA,EAAa,WAAA;AAAA,IACb,WAAA,EAAa,CAAC,MAAA,KAAW,MAAA,CAAO,WAAA;AAAA,IAChC,cAAA,EAAgB,CAAC,MAAA,KACf,MAAA,CAAO,QAAQ,IAAA,GAAO,UAAA,CAAW,MAAA,CAAO,IAAI,CAAA,GAAI;AAAA,GACpD;AACF","file":"index.js","sourcesContent":["import { defineClientPlugin, pluginPath } from \"@dimah-s3/core\";\nimport type { db } from \"@/plugin/db\";\nimport type {\n DbClientGetInput,\n DbClientListInput,\n DbClientListResponse,\n DbClientObject,\n} from \"@/types/storage-object\";\n\nexport type {\n DbClientGetInput,\n DbClientListInput,\n DbClientListResponse,\n DbClientObject,\n} from \"@/types/storage-object\";\n\n/**\n * Client plugin for the server `db()` endpoints.\n *\n * ```ts\n * import { createS3Client } from \"@dimah-s3/react\";\n * import { dbClient } from \"@dimah-s3/db/client\";\n *\n * export const { api, useApi } = createS3Client({\n * plugins: [dbClient()],\n * });\n *\n * await api.db.listObjects({ limit: 50 });\n * ```\n *\n * Server code does not use `listObjects` — it calls `s3.db.objects.listByScope`\n * and `getScopeUsage` directly (no HTTP round-trip). `listObjects` is the browser\n * wrapper for `GET /db/objects`.\n */\nexport function dbClient() {\n return defineClientPlugin({\n id: \"db\",\n $InferServerPlugin: {} as ReturnType<typeof db>,\n getActions: ($fetch) => ({\n /**\n * List the caller's objects and usage. Scope comes from server `resolveScope`\n * — not a parameter here. For another scope, use `listByScope` on the server.\n * Pass `init.signal` to cancel the request.\n */\n listObjects: (\n input?: DbClientListInput,\n init?: { signal?: AbortSignal },\n ) =>\n $fetch<DbClientListResponse>(pluginPath(\"db\", \"objects\"), {\n method: \"GET\",\n query: input,\n signal: init?.signal,\n }),\n getObject: (input: DbClientGetInput) =>\n $fetch<{ object: DbClientObject }>(pluginPath(\"db\", \"object\"), {\n method: \"GET\",\n query: input,\n }),\n }),\n });\n}\n","import type {\n DbClientListInput,\n DbClientListResponse,\n DbClientObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\n\n/** `listObjects` plus an optional abort signal. Matches `dbClient()`. */\nexport type DbObjectListSource = (\n input?: DbClientListInput,\n init?: { signal?: AbortSignal },\n) => Promise<DbClientListResponse>;\n\nexport type DbObjectQueryOptions = {\n route?: string;\n status?: StorageObjectStatus;\n contentType?: string;\n limit?: number;\n};\n\nexport type DbObjectQueryInput = {\n parent: string | null;\n cursor: string | null;\n signal: AbortSignal;\n};\n\nexport type DbObjectQueryPage = {\n items: DbClientObject[];\n nextCursor: string | null;\n /** Scope totals from `listObjects`. Not limited to the open folder. */\n usage: DbClientListResponse[\"usage\"];\n};\n\n/**\n * Adapt `api.db.listObjects` to a `useObjectList` query.\n *\n * `parent` is sent as the key `prefix`. This does not invent folder rows:\n * default object keys contain a uuid segment, so a delimiter over the key\n * is not a folder tree. Return `folders` from your own query when the\n * catalog has them. `usage` is the scope total from `listObjects`, not the\n * open folder.\n *\n * ```ts\n * const list = useObjectList({\n * query: dbObjectQuery(api.db.listObjects, { route: \"docs\" }),\n * queryKey: [\"docs\"],\n * });\n * ```\n */\nexport function dbObjectQuery(\n listObjects: DbObjectListSource,\n options?: DbObjectQueryOptions,\n) {\n return async function query(\n input: DbObjectQueryInput,\n ): Promise<DbObjectQueryPage> {\n const queryInput: DbClientListInput = {};\n if (input.parent) queryInput.prefix = input.parent;\n if (input.cursor) queryInput.cursor = input.cursor;\n if (options?.route) queryInput.route = options.route;\n if (options?.status) queryInput.status = options.status;\n if (options?.contentType) queryInput.contentType = options.contentType;\n if (options?.limit != null) queryInput.limit = options.limit;\n\n const page = await listObjects(queryInput, { signal: input.signal });\n return {\n items: page.objects,\n nextCursor: page.nextCursor ?? null,\n usage: page.usage,\n };\n };\n}\n","import { fileNameFromKey, formatFileSize } from \"@dimah-s3/core\";\nimport type { DbClientObject } from \"@/types/storage-object\";\n\n/** Accessors that map a `listObjects` row onto `ObjectList`. */\nexport type DbObjectListAccessors = {\n /** Row id. */\n getKey: (object: DbClientObject) => string;\n /** Stored object key. Bulk delete uses this. */\n getObjectKey: (object: DbClientObject) => string;\n /** Filename, or the last segment of the key. */\n getLabel: (object: DbClientObject) => string;\n /** Same name the type glyph uses. */\n getFileName: (object: DbClientObject) => string;\n getFileType: (object: DbClientObject) => string | null;\n /** Verified size. `null` while the object is still pending. */\n getDescription: (object: DbClientObject) => string | null;\n};\n\n/** Options for {@link dbObjectListAccessors}. */\nexport type DbObjectListAccessorsOptions = {\n /**\n * Size label for `getDescription`. In React, pass `useFormatFileSize()`\n * from `@dimah-s3/react` to follow the `S3Provider` `locale`.\n */\n formatSize?: (bytes: number) => string;\n};\n\nfunction displayName(object: DbClientObject): string {\n return object.filename || fileNameFromKey(object.key) || object.key;\n}\n\n/**\n * Map `api.db.listObjects` rows onto `ObjectList` accessors.\n *\n * This does not invent folders. Pass the result of `dbObjectQuery` as `list`.\n *\n * ```tsx\n * const files = dbObjectListAccessors();\n *\n * <ObjectList list={list} {...files} />\n * ```\n */\nexport function dbObjectListAccessors(\n options: DbObjectListAccessorsOptions = {},\n): DbObjectListAccessors {\n const formatSize =\n options.formatSize ?? ((bytes: number) => formatFileSize(bytes));\n return {\n getKey: (object) => object.id,\n getObjectKey: (object) => object.key,\n getLabel: displayName,\n getFileName: displayName,\n getFileType: (object) => object.contentType,\n getDescription: (object) =>\n object.size != null ? formatSize(object.size) : null,\n };\n}\n"]}
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
import { type DimahS3DbClient, type StorageObjectStore } from "../store/storage-object-store.js";
|
|
2
|
-
import type { ScopeResolver, StorageObject, StorageObjectStatus } from "../types/storage-object.js";
|
|
2
|
+
import type { ScopeOperation, ScopeResolver, StorageObject, StorageObjectStatus } from "../types/storage-object.js";
|
|
3
3
|
/** Minimal context the guard needs — matches every key-bearing server hook context. */
|
|
4
4
|
export type ObjectAccessGuardContext = {
|
|
5
5
|
request: Request;
|
|
6
6
|
key: string;
|
|
7
7
|
bucket: string;
|
|
8
|
+
/** Named route. Passed on to `resolveScope`. */
|
|
9
|
+
route?: string;
|
|
8
10
|
/** Multipart session id — required when {@link CreateObjectAccessGuardOptions.requireUploadId} is set. */
|
|
9
11
|
uploadId?: string;
|
|
10
12
|
};
|
|
@@ -12,6 +14,12 @@ export type CreateObjectAccessGuardOptions = {
|
|
|
12
14
|
/** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt objects store. */
|
|
13
15
|
client: DimahS3DbClient | StorageObjectStore;
|
|
14
16
|
resolveScope: ScopeResolver;
|
|
17
|
+
/**
|
|
18
|
+
* The operation this guard protects, passed to `resolveScope`. Create one
|
|
19
|
+
* guard per hook, such as `"download"` for `download.guard` and
|
|
20
|
+
* `"delete"` for `delete.guard`.
|
|
21
|
+
*/
|
|
22
|
+
operation: ScopeOperation;
|
|
15
23
|
/**
|
|
16
24
|
* Which rows count as accessible.
|
|
17
25
|
* `"any"` means pending or active (not deleted).
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-object-access-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/create-object-access-guard.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAEhC,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,+EAA+E;IAC/E,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC7C,YAAY,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IAC5C;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,wBAAwB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAClD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAC3C,kBAAkB,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"create-object-access-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/create-object-access-guard.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAEhC,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,+EAA+E;IAC/E,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC7C,YAAY,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IAC5C;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,CACV,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,wBAAwB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAClD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAC3C,kBAAkB,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAiCtD"}
|
|
@@ -8,6 +8,10 @@ export type CreateQuotaGuardOptions = {
|
|
|
8
8
|
};
|
|
9
9
|
export type QuotaGuardContext = {
|
|
10
10
|
request: Request;
|
|
11
|
+
/** Named route. Passed on to `resolveScope`. */
|
|
12
|
+
route?: string;
|
|
13
|
+
/** Client extras from the presign body. Passed on to `resolveScope`. */
|
|
14
|
+
clientMetadata?: Record<string, string>;
|
|
11
15
|
file?: {
|
|
12
16
|
size?: number;
|
|
13
17
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-quota-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/create-quota-guard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC7C,YAAY,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"create-quota-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/create-quota-guard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC7C,YAAY,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAwC/C"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { DimahS3DB, v1 } from "./fuma-db";
|
|
2
|
-
export type { DbClientGetInput, DbClientListInput, DbClientListResponse, DbClientObject, ScopeResolver, StorageObject, StorageObjectStatus, } from "./types/storage-object";
|
|
2
|
+
export type { DbClientGetInput, DbClientListInput, DbClientListResponse, DbClientObject, ScopeContext, ScopeOperation, ScopeResolver, StorageObject, StorageObjectStatus, } from "./types/storage-object";
|
|
3
3
|
export { conflict, forbidden, notFound, unauthorized } from "./errors";
|
|
4
4
|
export { createStorageObjectStore, toPendingMultipartResume, } from "./store/storage-object-store";
|
|
5
5
|
export type { DimahS3DbClient, FindPendingMultipartInput, ListByScopeInput, MarkActiveInput, ObjectRef, PendingMultipartResume, ScopeUsage, StorageObjectStore, UpsertPendingInput, } from "./store/storage-object-store";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAG1C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGvE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EACV,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAG1C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGvE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EACV,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -406,7 +406,11 @@ function createObjectAccessGuard(options) {
|
|
|
406
406
|
const store = resolveStore(options.client);
|
|
407
407
|
const requireStatus = options.requireStatus ?? "active";
|
|
408
408
|
return async (context) => {
|
|
409
|
-
const scope = await options.resolveScope(context.request
|
|
409
|
+
const scope = await options.resolveScope(context.request, {
|
|
410
|
+
operation: options.operation,
|
|
411
|
+
route: context.route,
|
|
412
|
+
key: context.key
|
|
413
|
+
});
|
|
410
414
|
if (scope === null) throw unauthorized();
|
|
411
415
|
const object2 = await store.find({
|
|
412
416
|
bucket: context.bucket,
|
|
@@ -435,7 +439,12 @@ function quotaExceeded(message) {
|
|
|
435
439
|
function createQuotaGuard(options) {
|
|
436
440
|
const objects = resolveStore(options.client);
|
|
437
441
|
return async (context) => {
|
|
438
|
-
const scope = await options.resolveScope(context.request
|
|
442
|
+
const scope = await options.resolveScope(context.request, {
|
|
443
|
+
operation: "upload",
|
|
444
|
+
route: context.route,
|
|
445
|
+
key: context.key,
|
|
446
|
+
clientMetadata: context.clientMetadata
|
|
447
|
+
});
|
|
439
448
|
if (scope === null) throw unauthorized();
|
|
440
449
|
const usage = await objects.getScopeUsage(scope);
|
|
441
450
|
const incoming = context.file?.size ?? 0;
|
|
@@ -511,8 +520,6 @@ function createDatabaseEndpoints(options) {
|
|
|
511
520
|
pluginPath("db", "objects"),
|
|
512
521
|
{ method: "GET", query: dbListQuerySchema },
|
|
513
522
|
async (ctx) => {
|
|
514
|
-
const scope = await options.resolveScope(ctx.context.request);
|
|
515
|
-
if (scope === null) throw unauthorized();
|
|
516
523
|
const {
|
|
517
524
|
status,
|
|
518
525
|
limit = DB_LIST_DEFAULT_LIMIT,
|
|
@@ -522,6 +529,11 @@ function createDatabaseEndpoints(options) {
|
|
|
522
529
|
contentType,
|
|
523
530
|
prefix
|
|
524
531
|
} = ctx.query ?? {};
|
|
532
|
+
const scope = await options.resolveScope(ctx.context.request, {
|
|
533
|
+
operation: "list",
|
|
534
|
+
route
|
|
535
|
+
});
|
|
536
|
+
if (scope === null) throw unauthorized();
|
|
525
537
|
const fetchLimit = limit + 1;
|
|
526
538
|
const [rows, usage] = await Promise.all([
|
|
527
539
|
options.objects.listByScope({
|
|
@@ -552,7 +564,10 @@ function createDatabaseEndpoints(options) {
|
|
|
552
564
|
pluginPath("db", "object"),
|
|
553
565
|
{ method: "GET", query: dbGetQuerySchema },
|
|
554
566
|
async (ctx) => {
|
|
555
|
-
const scope = await options.resolveScope(ctx.context.request
|
|
567
|
+
const scope = await options.resolveScope(ctx.context.request, {
|
|
568
|
+
operation: "list",
|
|
569
|
+
key: ctx.query.key
|
|
570
|
+
});
|
|
556
571
|
if (scope === null) throw unauthorized();
|
|
557
572
|
const found = await options.objects.findByScopeKey({
|
|
558
573
|
scope,
|
|
@@ -566,24 +581,51 @@ function createDatabaseEndpoints(options) {
|
|
|
566
581
|
};
|
|
567
582
|
}
|
|
568
583
|
|
|
584
|
+
// src/plugin/memoize-scope-resolver.ts
|
|
585
|
+
function memoizeScopeResolver(resolve) {
|
|
586
|
+
const cache = /* @__PURE__ */ new WeakMap();
|
|
587
|
+
return (request, context) => {
|
|
588
|
+
let byContext = cache.get(request);
|
|
589
|
+
if (!byContext) {
|
|
590
|
+
byContext = /* @__PURE__ */ new Map();
|
|
591
|
+
cache.set(request, byContext);
|
|
592
|
+
}
|
|
593
|
+
const id = JSON.stringify([
|
|
594
|
+
context.operation,
|
|
595
|
+
context.route ?? null,
|
|
596
|
+
context.key ?? null
|
|
597
|
+
]);
|
|
598
|
+
let scope = byContext.get(id);
|
|
599
|
+
if (scope === void 0) {
|
|
600
|
+
scope = resolve(request, context);
|
|
601
|
+
byContext.set(id, scope);
|
|
602
|
+
}
|
|
603
|
+
return scope;
|
|
604
|
+
};
|
|
605
|
+
}
|
|
606
|
+
|
|
569
607
|
// src/plugin/create-database-lifecycle-hooks.ts
|
|
570
608
|
var DEFAULT_PENDING_TTL_MS = 24 * 60 * 60 * 1e3;
|
|
571
609
|
function createDatabaseLifecycleHooks(options) {
|
|
572
610
|
const objects = resolveStore(options.client);
|
|
573
611
|
const pendingTtlMs = options.pendingTtlMs ?? DEFAULT_PENDING_TTL_MS;
|
|
574
612
|
const deleteMode = options.deleteMode ?? "soft";
|
|
575
|
-
const
|
|
576
|
-
async function requireScope(request) {
|
|
577
|
-
|
|
578
|
-
if (scope === void 0) {
|
|
579
|
-
scope = await options.resolveScope(request);
|
|
580
|
-
scopeCache.set(request, scope);
|
|
581
|
-
}
|
|
613
|
+
const resolveScope = memoizeScopeResolver(options.resolveScope);
|
|
614
|
+
async function requireScope(request, context) {
|
|
615
|
+
const scope = await resolveScope(request, context);
|
|
582
616
|
if (scope === null) throw unauthorized();
|
|
583
617
|
return scope;
|
|
584
618
|
}
|
|
619
|
+
function uploadScope(context) {
|
|
620
|
+
return requireScope(context.request, {
|
|
621
|
+
operation: "upload",
|
|
622
|
+
route: context.route,
|
|
623
|
+
key: context.key,
|
|
624
|
+
clientMetadata: context.clientMetadata
|
|
625
|
+
});
|
|
626
|
+
}
|
|
585
627
|
async function guardKeyOwnership(context) {
|
|
586
|
-
const scope = await
|
|
628
|
+
const scope = await uploadScope(context);
|
|
587
629
|
const existing = await objects.find({
|
|
588
630
|
bucket: context.bucket,
|
|
589
631
|
key: context.key
|
|
@@ -593,7 +635,7 @@ function createDatabaseLifecycleHooks(options) {
|
|
|
593
635
|
}
|
|
594
636
|
}
|
|
595
637
|
async function trackPending(context) {
|
|
596
|
-
const scope = await
|
|
638
|
+
const scope = await uploadScope(context);
|
|
597
639
|
if (context.replace === "overwrite") {
|
|
598
640
|
const existing = await objects.find({
|
|
599
641
|
bucket: context.bucket,
|
|
@@ -629,36 +671,62 @@ function createDatabaseLifecycleHooks(options) {
|
|
|
629
671
|
metadata: context.metadata
|
|
630
672
|
});
|
|
631
673
|
}
|
|
674
|
+
async function abortPendingMultipart(context) {
|
|
675
|
+
const row = await objects.find({
|
|
676
|
+
bucket: context.bucket,
|
|
677
|
+
key: context.key
|
|
678
|
+
});
|
|
679
|
+
if (row?.status !== "pending" || !row.uploadId) return;
|
|
680
|
+
const s3 = options.s3Client?.(context.route);
|
|
681
|
+
if (!s3) return;
|
|
682
|
+
try {
|
|
683
|
+
await s3.send(
|
|
684
|
+
new AbortMultipartUploadCommand({
|
|
685
|
+
Bucket: context.bucket,
|
|
686
|
+
Key: context.key,
|
|
687
|
+
UploadId: row.uploadId
|
|
688
|
+
})
|
|
689
|
+
);
|
|
690
|
+
} catch {
|
|
691
|
+
}
|
|
692
|
+
}
|
|
693
|
+
const guardOptions = { client: objects, resolveScope };
|
|
632
694
|
const pendingObjectGuard = createObjectAccessGuard({
|
|
633
|
-
|
|
634
|
-
|
|
695
|
+
...guardOptions,
|
|
696
|
+
operation: "confirm",
|
|
635
697
|
requireStatus: "pending"
|
|
636
698
|
});
|
|
699
|
+
const ownedObjectConfirmGuard = createObjectAccessGuard({
|
|
700
|
+
...guardOptions,
|
|
701
|
+
operation: "confirm",
|
|
702
|
+
requireStatus: "any"
|
|
703
|
+
});
|
|
637
704
|
const multipartSessionGuard = createObjectAccessGuard({
|
|
638
|
-
|
|
639
|
-
|
|
705
|
+
...guardOptions,
|
|
706
|
+
operation: "multipart",
|
|
640
707
|
requireStatus: "pending",
|
|
641
708
|
requireUploadId: true
|
|
642
709
|
});
|
|
643
710
|
const activeObjectGuard = createObjectAccessGuard({
|
|
644
|
-
|
|
645
|
-
|
|
711
|
+
...guardOptions,
|
|
712
|
+
operation: "download",
|
|
646
713
|
requireStatus: "active"
|
|
647
714
|
});
|
|
648
|
-
const
|
|
649
|
-
|
|
650
|
-
|
|
715
|
+
const ownedObjectDeleteGuard = createObjectAccessGuard({
|
|
716
|
+
...guardOptions,
|
|
717
|
+
operation: "delete",
|
|
651
718
|
requireStatus: "any"
|
|
652
719
|
});
|
|
653
720
|
return {
|
|
654
721
|
objects,
|
|
722
|
+
resolveScope,
|
|
655
723
|
hooks: {
|
|
656
724
|
upload: {
|
|
657
725
|
guard: guardKeyOwnership,
|
|
658
726
|
onPresigned: trackPending,
|
|
659
727
|
confirmGuard: async (context) => {
|
|
660
728
|
if (context.replace === "overwrite") {
|
|
661
|
-
await
|
|
729
|
+
await ownedObjectConfirmGuard(context);
|
|
662
730
|
return;
|
|
663
731
|
}
|
|
664
732
|
await pendingObjectGuard(context);
|
|
@@ -680,8 +748,9 @@ function createDatabaseLifecycleHooks(options) {
|
|
|
680
748
|
guard: activeObjectGuard
|
|
681
749
|
},
|
|
682
750
|
delete: {
|
|
683
|
-
guard:
|
|
751
|
+
guard: ownedObjectDeleteGuard,
|
|
684
752
|
onDeleted: async (context) => {
|
|
753
|
+
if (!context.existed) await abortPendingMultipart(context);
|
|
685
754
|
const ref = { bucket: context.bucket, key: context.key };
|
|
686
755
|
if (deleteMode === "hard") await objects.hardDelete(ref);
|
|
687
756
|
else await objects.softDelete(ref);
|
|
@@ -693,11 +762,16 @@ function createDatabaseLifecycleHooks(options) {
|
|
|
693
762
|
|
|
694
763
|
// src/plugin/db.ts
|
|
695
764
|
function db(options) {
|
|
696
|
-
|
|
765
|
+
let config;
|
|
766
|
+
const s3Client = (route) => config?.routes[route]?.client ?? config?.client;
|
|
767
|
+
const { objects, hooks, resolveScope } = createDatabaseLifecycleHooks({
|
|
768
|
+
...options,
|
|
769
|
+
s3Client
|
|
770
|
+
});
|
|
697
771
|
if (options.quota && hooks.upload) {
|
|
698
772
|
const quotaGuard = createQuotaGuard({
|
|
699
773
|
client: objects,
|
|
700
|
-
resolveScope
|
|
774
|
+
resolveScope,
|
|
701
775
|
maxBytes: options.quota.maxBytes,
|
|
702
776
|
maxFiles: options.quota.maxFiles
|
|
703
777
|
});
|
|
@@ -705,8 +779,9 @@ function db(options) {
|
|
|
705
779
|
}
|
|
706
780
|
return definePlugin({
|
|
707
781
|
id: "db",
|
|
708
|
-
init(
|
|
709
|
-
|
|
782
|
+
init(env) {
|
|
783
|
+
config = env.config;
|
|
784
|
+
const routes = Object.values(env.config.routes);
|
|
710
785
|
const hasLifecycle = routes.some(
|
|
711
786
|
(r) => isFeatureOn(r.upload) || isFeatureOn(r.download) || isFeatureOn(r.delete)
|
|
712
787
|
);
|
|
@@ -717,10 +792,7 @@ function db(options) {
|
|
|
717
792
|
}
|
|
718
793
|
},
|
|
719
794
|
hooks,
|
|
720
|
-
endpoints: createDatabaseEndpoints({
|
|
721
|
-
objects,
|
|
722
|
-
resolveScope: options.resolveScope
|
|
723
|
-
}),
|
|
795
|
+
endpoints: createDatabaseEndpoints({ objects, resolveScope }),
|
|
724
796
|
context: {
|
|
725
797
|
objects,
|
|
726
798
|
client: options.client
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/schema/v1.ts","../src/fuma-db.ts","../src/errors.ts","../src/store/map-row.ts","../src/store/list-cursor.ts","../src/store/storage-object-store.ts","../src/hooks/create-object-access-guard.ts","../src/hooks/create-quota-guard.ts","../src/plugin/list-query-schema.ts","../src/plugin/to-db-client-object.ts","../src/plugin/create-database-endpoints.ts","../src/plugin/create-database-lifecycle-hooks.ts","../src/plugin/db.ts","../src/jobs/purge-stale-pending.ts"],"names":["object","db","APIError","S3_ERROR_CODES","schema"],"mappings":"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","file":"index.js","sourcesContent":["import { column, idColumn, schema, table } from \"fumadb/schema\";\n\n/**\n * Single-table object lifecycle:\n * pending (presign) → active (HeadObject confirmed) → deleted (soft)\n *\n * Cron: delete stale pending rows (AbortMultipartUpload if uploadId set).\n * Ownership is expressed via `scope` (e.g. `user:…` / `org:…`).\n *\n * FumaDB only emits the `(bucket, key)` unique constraint. Secondary indexes\n * for listByScope / getScopeUsage / findStalePending are consumer-side after\n * CLI generate — see `./examples/` (Drizzle + Prisma) and README\n * \"Recommended indexes\".\n */\nconst storageObject = table(\"storage_object\", {\n id: idColumn(\"id\", \"varchar(255)\").defaultTo$(\"auto\"),\n scope: column(\"scope\", \"string\"),\n bucket: column(\"bucket\", \"string\"),\n key: column(\"key\", \"string\"),\n /** Named dimah-s3 route that created the object. */\n route: column(\"route\", \"string\"),\n contentType: column(\"content_type\", \"string\").nullable(),\n /** Verified size from HeadObject after confirm. */\n size: column(\"size\", \"bigint\").nullable(),\n eTag: column(\"e_tag\", \"string\").nullable(),\n filename: column(\"filename\", \"string\").nullable(),\n status: column(\"status\", \"string\"),\n /** App-specific labels, visibility, publicUrl, etc. */\n metadata: column(\"metadata\", \"json\").nullable(),\n acl: column(\"acl\", \"string\").nullable(),\n /** Multipart upload ID while status = pending. */\n uploadId: column(\"upload_id\", \"string\").nullable(),\n /** Client-declared size before confirm (quota reservation). */\n declaredSize: column(\"declared_size\", \"bigint\").nullable(),\n confirmedAt: column(\"confirmed_at\", \"timestamp\").nullable(),\n /** Pending TTL or temporary object expiry. */\n expiresAt: column(\"expires_at\", \"timestamp\").nullable(),\n createdAt: column(\"created_at\", \"timestamp\").defaultTo$(\"now\"),\n updatedAt: column(\"updated_at\", \"timestamp\").defaultTo$(\"now\"),\n deletedAt: column(\"deleted_at\", \"timestamp\").nullable(),\n}).unique(\"storage_object_bucket_key_uk\", [\"bucket\", \"key\"]);\n\nexport const v1 = schema({\n version: \"1.0.0\",\n tables: {\n storageObject,\n },\n});\n\nexport type { StorageObjectStatus } from \"@/types/storage-object\";\n","import { fumadb } from \"fumadb\";\nimport { v1 } from \"./schema/v1\";\n\nexport const DimahS3DB = fumadb({\n namespace: \"dimah_s3\",\n schemas: [v1],\n});\n\nexport { v1 };\n","import { APIError, S3_ERROR_CODES } from \"@dimah-s3/core\";\n\nexport function unauthorized(\n message: string = S3_ERROR_CODES.UNAUTHORIZED.message,\n): APIError {\n return APIError.from(\"UNAUTHORIZED\", {\n ...S3_ERROR_CODES.UNAUTHORIZED,\n message,\n });\n}\n\nexport function forbidden(\n message: string = S3_ERROR_CODES.FORBIDDEN.message,\n): APIError {\n return APIError.from(\"FORBIDDEN\", {\n ...S3_ERROR_CODES.FORBIDDEN,\n message,\n });\n}\n\nexport function notFound(\n message: string = S3_ERROR_CODES.OBJECT_NOT_FOUND.message,\n): APIError {\n return APIError.from(\"NOT_FOUND\", {\n ...S3_ERROR_CODES.OBJECT_NOT_FOUND,\n message,\n });\n}\n\nexport function conflict(\n message: string = S3_ERROR_CODES.CONFLICT.message,\n): APIError {\n return APIError.from(\"CONFLICT\", {\n ...S3_ERROR_CODES.CONFLICT,\n message,\n });\n}\n","import type {\n StorageObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\n\n/** Raw `storage_object` row as returned by the FumaDB ORM. */\nexport type StorageObjectRow = {\n id: string;\n scope: string;\n bucket: string;\n key: string;\n route: string;\n contentType: string | null;\n size: bigint | null;\n eTag: string | null;\n filename: string | null;\n status: string;\n metadata: unknown;\n acl: string | null;\n uploadId: string | null;\n declaredSize: bigint | null;\n confirmedAt: Date | null;\n expiresAt: Date | null;\n createdAt: Date;\n updatedAt: Date;\n deletedAt: Date | null;\n};\n\nfunction toNumber(value: bigint | number | null): number | null {\n if (value === null) return null;\n return typeof value === \"bigint\" ? Number(value) : value;\n}\n\n/** Normalize a raw row: bigint → number, status narrowing, metadata cast. */\nexport function mapStorageObjectRow(row: StorageObjectRow): StorageObject {\n return {\n id: row.id,\n scope: row.scope,\n bucket: row.bucket,\n key: row.key,\n route: row.route,\n contentType: row.contentType,\n size: toNumber(row.size),\n eTag: row.eTag,\n filename: row.filename,\n status: row.status as StorageObjectStatus,\n metadata: (row.metadata ?? null) as Record<string, unknown> | null,\n acl: row.acl,\n uploadId: row.uploadId,\n declaredSize: toNumber(row.declaredSize),\n confirmedAt: row.confirmedAt,\n expiresAt: row.expiresAt,\n createdAt: row.createdAt,\n updatedAt: row.updatedAt,\n deletedAt: row.deletedAt,\n };\n}\n","export function encodeListCursor(createdAt: Date, id: string): string {\n return Buffer.from(`${createdAt.toISOString()}\\t${id}`, \"utf8\").toString(\n \"base64url\",\n );\n}\n\nexport function decodeListCursor(\n cursor: string,\n): { createdAt: Date; id: string } | null {\n try {\n const raw = Buffer.from(cursor, \"base64url\").toString(\"utf8\");\n const sep = raw.indexOf(\"\\t\");\n if (sep < 1) return null;\n const createdAt = new Date(raw.slice(0, sep));\n const id = raw.slice(sep + 1);\n if (!id || Number.isNaN(createdAt.getTime())) return null;\n return { createdAt, id };\n } catch {\n return null;\n }\n}\n","import type { InferFumaDB } from \"fumadb\";\nimport type { DimahS3DB } from \"@/fuma-db\";\nimport { conflict, notFound } from \"@/errors\";\nimport type {\n StorageObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\nimport { mapStorageObjectRow } from \"./map-row\";\nimport { decodeListCursor } from \"./list-cursor\";\n\n/** FumaDB uses `false` as a type-level sentinel for invalid operators. */\nfunction condition<T>(value: T): Exclude<T, boolean> {\n if (typeof value === \"boolean\") {\n throw new TypeError(\"[dimah-s3/db] invalid query condition\");\n }\n return value as Exclude<T, boolean>;\n}\n\n/** FumaDB client for the @dimah-s3/db schema. */\nexport type DimahS3DbClient = InferFumaDB<typeof DimahS3DB>;\n\n/** Identifies one object row — `(bucket, key)` is unique. */\nexport type ObjectRef = {\n bucket: string;\n key: string;\n};\n\nexport type UpsertPendingInput = ObjectRef & {\n scope: string;\n route: string;\n contentType?: string | null;\n /** Client-declared size in bytes (quota reservation — not verified). */\n declaredSize?: number | null;\n metadata?: Record<string, unknown> | null;\n acl?: string | null;\n filename?: string | null;\n /** Multipart upload ID, when the pending upload is multipart. */\n uploadId?: string | null;\n /** Pending TTL — stale rows past this are eligible for purge. */\n expiresAt?: Date | null;\n};\n\nexport type MarkActiveInput = ObjectRef & {\n /** Verified size in bytes (from HeadObject). */\n size: number;\n eTag?: string | null;\n contentType?: string | null;\n acl?: string | null;\n filename?: string | null;\n metadata?: Record<string, unknown> | null;\n};\n\nexport type ListByScopeInput = {\n scope: string;\n /**\n * Filter by exact status. When omitted, only `active` rows are returned.\n */\n status?: StorageObjectStatus;\n route?: string;\n contentType?: string;\n /** Key prefix. Applied in the query (`starts with`), so pages stay full. */\n prefix?: string;\n limit?: number;\n offset?: number;\n cursor?: string;\n};\n\nexport type ScopeUsage = {\n /** Sum of verified size (fallback: declared size) of non-deleted rows. */\n totalBytes: number;\n /** Non-deleted row count. */\n objectCount: number;\n};\n\n/**\n * Minimal multipart resume payload — structurally matches\n * `@dimah-s3/react` `StoredUpload` so a custom client `UploadStore` can\n * return it from `get()` without importing react types.\n */\nexport type PendingMultipartResume = {\n uploadId: string;\n key: string;\n /** Declared file size in bytes (must match the File being resumed). */\n fileSize: number;\n bucket: string;\n};\n\nexport type FindPendingMultipartInput = ObjectRef & {\n /** Must equal the pending row's `declaredSize`. */\n fileSize: number;\n};\n\n/**\n * Map a `storage_object` row to a client resume payload.\n * Returns `null` unless the row is `pending` with `uploadId` and `declaredSize`.\n */\nexport function toPendingMultipartResume(\n object: StorageObject,\n): PendingMultipartResume | null {\n if (\n object.status !== \"pending\" ||\n object.uploadId == null ||\n object.declaredSize == null\n ) {\n return null;\n }\n return {\n uploadId: object.uploadId,\n key: object.key,\n fileSize: object.declaredSize,\n bucket: object.bucket,\n };\n}\n\n/** Data-access layer for the `storage_object` table. */\nexport type StorageObjectStore = {\n /**\n * Insert or reset a row to `pending` (presign / multipart init).\n * Returns the written row.\n */\n upsertPending: (input: UpsertPendingInput) => Promise<StorageObject>;\n /**\n * Promote a pending row to `active` with verified fields (confirm / complete).\n * Also refreshes an already-active row (overwrite). Returns the active row.\n */\n markActive: (input: MarkActiveInput) => Promise<StorageObject>;\n /** Load one row by `bucket` + `key` (any status). */\n find: (ref: ObjectRef) => Promise<StorageObject | null>;\n /** Load one row by scope + key (any status). */\n findByScopeKey: (input: {\n scope: string;\n key: string;\n bucket?: string;\n }) => Promise<StorageObject | null>;\n /** Load one row — only when `status` is `active`. */\n findActive: (ref: ObjectRef) => Promise<StorageObject | null>;\n /**\n * Pending multipart row for resume: `pending` + `uploadId` + matching\n * `declaredSize`. Returns the full row so callers can enforce scope.\n */\n findPendingMultipart: (\n input: FindPendingMultipartInput,\n ) => Promise<StorageObject | null>;\n /**\n * List rows for a scope (pass `scope` explicitly — admin routes, jobs, etc.).\n * Defaults to `active`. Server-side listing; browser apps use\n * `api.db.listObjects` instead (scope from `resolveScope`, no HTTP from server code).\n */\n listByScope: (input: ListByScopeInput) => Promise<StorageObject[]>;\n /** Total bytes and row count for a scope — quota checks (`pending` uses `declaredSize`). */\n getScopeUsage: (scope: string) => Promise<ScopeUsage>;\n /** Row count for a scope; optional `status` filter (same defaults as `listByScope`). */\n countByScope: (\n scope: string,\n status?: StorageObjectStatus,\n ) => Promise<number>;\n /**\n * Mark a row `deleted` (keeps the record). DB-only — does not delete from S3.\n * Not a substitute for `api.delete`; the plugin calls this from `onDeleted`\n * when `deleteMode` is `\"soft\"`.\n */\n softDelete: (ref: ObjectRef) => Promise<void>;\n /**\n * Remove the row entirely. DB-only — does not delete from S3.\n * Not a substitute for `api.delete`; used by the plugin when `deleteMode` is\n * `\"hard\"`, or by admin jobs to prune soft-deleted audit rows.\n */\n hardDelete: (ref: ObjectRef) => Promise<void>;\n /** Remove a `pending` row (multipart abort path). Optional `uploadId` must match. */\n deletePending: (ref: ObjectRef & { uploadId?: string }) => Promise<void>;\n /** Pending rows past `expiresAt`, or with no TTL and `createdAt` before `olderThan`. */\n findStalePending: (input: { olderThan: Date }) => Promise<StorageObject[]>;\n /** Delete rows by ID (used by the purge job after `findStalePending`). */\n deleteByIds: (ids: string[]) => Promise<void>;\n};\n\nfunction toBigInt(value: number | null | undefined): bigint | null {\n return value === null || value === undefined\n ? null\n : BigInt(Math.trunc(value));\n}\n\nfunction confirmedFields(input: MarkActiveInput, now: Date) {\n return {\n size: toBigInt(input.size),\n eTag: input.eTag ?? null,\n ...(input.contentType !== undefined && {\n contentType: input.contentType,\n }),\n ...(input.acl !== undefined && { acl: input.acl }),\n ...(input.filename !== undefined && { filename: input.filename }),\n ...(input.metadata !== undefined && { metadata: input.metadata }),\n uploadId: null,\n declaredSize: null,\n expiresAt: null,\n confirmedAt: now,\n updatedAt: now,\n };\n}\n\nfunction toActiveObject(\n existing: StorageObject,\n input: MarkActiveInput,\n now: Date,\n): StorageObject {\n return {\n ...existing,\n status: \"active\",\n size: input.size,\n eTag: input.eTag ?? null,\n contentType:\n input.contentType !== undefined\n ? input.contentType\n : existing.contentType,\n acl: input.acl !== undefined ? input.acl : existing.acl,\n filename: input.filename !== undefined ? input.filename : existing.filename,\n metadata: input.metadata !== undefined ? input.metadata : existing.metadata,\n uploadId: null,\n declaredSize: null,\n expiresAt: null,\n confirmedAt: now,\n updatedAt: now,\n deletedAt: null,\n };\n}\n\n/** Create a store bound to schema v1 (`db.orm(\"1.0.0\")`). */\nexport function createStorageObjectStore(\n db: DimahS3DbClient,\n): StorageObjectStore {\n const orm = db.orm(\"1.0.0\");\n\n const store: StorageObjectStore = {\n async upsertPending(input) {\n const now = new Date();\n const pendingFields = {\n scope: input.scope,\n route: input.route,\n contentType: input.contentType ?? null,\n declaredSize: toBigInt(input.declaredSize),\n metadata: input.metadata ?? null,\n acl: input.acl ?? null,\n filename: input.filename ?? null,\n uploadId: input.uploadId ?? null,\n expiresAt: input.expiresAt ?? null,\n status: \"pending\" as const,\n size: null,\n eTag: null,\n confirmedAt: null,\n deletedAt: null,\n };\n const row = await orm\n .upsert(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", input.bucket), b(\"key\", \"=\", input.key)),\n update: { ...pendingFields, updatedAt: now },\n create: {\n ...pendingFields,\n bucket: input.bucket,\n key: input.key,\n updatedAt: now,\n },\n })\n .forceReturning();\n return mapStorageObjectRow(row);\n },\n\n async markActive(input) {\n const existing = await store.find(input);\n if (!existing || existing.status === \"deleted\") {\n throw notFound(\"No pending object to confirm\");\n }\n const now = new Date();\n const fields = confirmedFields(input, now);\n if (existing.status === \"active\") {\n await orm.updateMany(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", input.bucket),\n b(\"key\", \"=\", input.key),\n b(\"status\", \"=\", \"active\"),\n ),\n set: fields,\n });\n return toActiveObject(existing, input, now);\n }\n if (existing.status !== \"pending\") {\n throw conflict(\"Object is not pending confirmation\");\n }\n await orm.updateMany(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", input.bucket),\n b(\"key\", \"=\", input.key),\n b(\"status\", \"=\", \"pending\"),\n ),\n set: {\n status: \"active\" as const,\n ...fields,\n deletedAt: null,\n },\n });\n return toActiveObject(existing, input, now);\n },\n\n async find(ref) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", ref.bucket), b(\"key\", \"=\", ref.key)),\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async findByScopeKey(input) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) => {\n const parts = [\n b(\"scope\", \"=\", input.scope),\n b(\"key\", \"=\", input.key),\n ];\n if (input.bucket) {\n parts.push(b(\"bucket\", \"=\", input.bucket));\n }\n return b.and(...parts);\n },\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async findActive(ref) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", ref.bucket),\n b(\"key\", \"=\", ref.key),\n b(\"status\", \"=\", \"active\"),\n ),\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async findPendingMultipart(input) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", input.bucket),\n b(\"key\", \"=\", input.key),\n b(\"status\", \"=\", \"pending\"),\n b.isNotNull(\"uploadId\"),\n b(\"declaredSize\", \"=\", BigInt(Math.trunc(input.fileSize))),\n ),\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async listByScope(input) {\n const status = input.status ?? \"active\";\n const parsed = input.cursor ? decodeListCursor(input.cursor) : null;\n const rows = await orm.findMany(\"storageObject\", {\n where: (b) => {\n const parts = [\n b(\"scope\", \"=\", input.scope),\n b(\"status\", \"=\", status),\n ];\n if (input.route) parts.push(b(\"route\", \"=\", input.route));\n if (input.contentType) {\n parts.push(b(\"contentType\", \"=\", input.contentType));\n }\n if (input.prefix) {\n parts.push(b(\"key\", \"starts with\", input.prefix));\n }\n if (parsed) {\n parts.push(\n condition(\n b.or(\n condition(b(\"createdAt\", \"<\", parsed.createdAt)),\n condition(\n b.and(\n b(\"createdAt\", \"=\", parsed.createdAt),\n b(\"id\", \"<\", parsed.id),\n ),\n ),\n ),\n ),\n );\n }\n return b.and(...parts);\n },\n orderBy: [\"createdAt\", \"desc\"],\n limit: input.limit,\n offset: parsed ? undefined : input.offset,\n });\n return rows.map(mapStorageObjectRow);\n },\n\n async getScopeUsage(scope) {\n const rows = await orm.findMany(\"storageObject\", {\n select: [\"size\", \"declaredSize\"],\n where: (b) =>\n b.and(b(\"scope\", \"=\", scope), b(\"status\", \"!=\", \"deleted\")),\n });\n let totalBytes = 0;\n for (const row of rows) {\n totalBytes += Number(row.size ?? row.declaredSize ?? 0n);\n }\n return { totalBytes, objectCount: rows.length };\n },\n\n async countByScope(scope, status = \"active\") {\n return orm.count(\"storageObject\", {\n where: (b) => b.and(b(\"scope\", \"=\", scope), b(\"status\", \"=\", status)),\n });\n },\n\n async softDelete(ref) {\n const now = new Date();\n await orm.updateMany(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", ref.bucket), b(\"key\", \"=\", ref.key)),\n set: { status: \"deleted\", deletedAt: now, updatedAt: now },\n });\n },\n\n async hardDelete(ref) {\n await orm.deleteMany(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", ref.bucket), b(\"key\", \"=\", ref.key)),\n });\n },\n\n async deletePending(ref) {\n await orm.deleteMany(\"storageObject\", {\n where: (b) => {\n if (ref.uploadId != null) {\n return b.and(\n b(\"bucket\", \"=\", ref.bucket),\n b(\"key\", \"=\", ref.key),\n b(\"status\", \"=\", \"pending\"),\n b(\"uploadId\", \"=\", ref.uploadId),\n );\n }\n return b.and(\n b(\"bucket\", \"=\", ref.bucket),\n b(\"key\", \"=\", ref.key),\n b(\"status\", \"=\", \"pending\"),\n );\n },\n });\n },\n\n async findStalePending({ olderThan }) {\n const now = new Date();\n const rows = await orm.findMany(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"status\", \"=\", \"pending\"),\n b.or(\n b(\"expiresAt\", \"<\", now),\n condition(\n b.and(b.isNull(\"expiresAt\"), b(\"createdAt\", \"<\", olderThan)),\n ),\n ),\n ),\n orderBy: [\"createdAt\", \"asc\"],\n });\n return rows.map(mapStorageObjectRow);\n },\n\n async deleteByIds(ids) {\n if (ids.length === 0) return;\n await orm.deleteMany(\"storageObject\", {\n where: (b) => b(\"id\", \"in\", ids),\n });\n },\n };\n\n return store;\n}\n","import { forbidden, notFound, unauthorized } from \"@/errors\";\nimport {\n createStorageObjectStore,\n type DimahS3DbClient,\n type StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type {\n ScopeResolver,\n StorageObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\n\n/** Minimal context the guard needs — matches every key-bearing server hook context. */\nexport type ObjectAccessGuardContext = {\n request: Request;\n key: string;\n bucket: string;\n /** Multipart session id — required when {@link CreateObjectAccessGuardOptions.requireUploadId} is set. */\n uploadId?: string;\n};\n\nexport type CreateObjectAccessGuardOptions = {\n /** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt objects store. */\n client: DimahS3DbClient | StorageObjectStore;\n resolveScope: ScopeResolver;\n /**\n * Which rows count as accessible.\n * `\"any\"` means pending or active (not deleted).\n * @default \"active\"\n */\n requireStatus?: StorageObjectStatus | \"any\";\n /**\n * Require `context.uploadId` to match the pending row's `uploadId`.\n * Use for `upload.multipart.guard`.\n */\n requireUploadId?: boolean;\n /**\n * Replace the default `object.scope === scope` ownership check —\n * e.g. also allow objects whose metadata marks them public.\n */\n authorize?: (\n object: StorageObject,\n context: ObjectAccessGuardContext & { scope: string },\n ) => boolean | Promise<boolean>;\n};\n\nexport function resolveStore(\n client: DimahS3DbClient | StorageObjectStore,\n): StorageObjectStore {\n return \"upsertPending\" in client ? client : createStorageObjectStore(client);\n}\n\n/**\n * Guard that checks the requested object exists in the DB and belongs to the\n * caller's scope. Throws `APIError` (401 / 404 / 403) to reject.\n *\n * Usable as `download.guard`, `delete.guard`,\n * `upload.confirmGuard`, `upload.multipart.guard`, or in your own routes.\n */\nexport function createObjectAccessGuard(\n options: CreateObjectAccessGuardOptions,\n): (context: ObjectAccessGuardContext) => Promise<void> {\n const store = resolveStore(options.client);\n const requireStatus = options.requireStatus ?? \"active\";\n\n return async (context) => {\n const scope = await options.resolveScope(context.request);\n if (scope === null) throw unauthorized();\n\n const object = await store.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (!object || object.status === \"deleted\") throw notFound();\n\n const allowed = options.authorize\n ? await options.authorize(object, { ...context, scope })\n : object.scope === scope;\n if (!allowed) throw forbidden();\n\n const statusOk =\n requireStatus === \"any\" ? true : object.status === requireStatus;\n if (!statusOk) throw notFound();\n\n if (options.requireUploadId) {\n if (!context.uploadId || object.uploadId !== context.uploadId) {\n throw forbidden(\"Upload session does not match\");\n }\n }\n };\n}\n","import { APIError, S3_ERROR_CODES } from \"@dimah-s3/core\";\nimport { unauthorized } from \"@/errors\";\nimport { resolveStore } from \"@/hooks/create-object-access-guard\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { ScopeResolver } from \"@/types/storage-object\";\n\nexport type CreateQuotaGuardOptions = {\n client: DimahS3DbClient | StorageObjectStore;\n resolveScope: ScopeResolver;\n maxBytes?: number;\n maxFiles?: number;\n};\n\nexport type QuotaGuardContext = {\n request: Request;\n file?: { size?: number };\n replace?: \"overwrite\";\n key?: string;\n bucket?: string;\n};\n\nfunction quotaExceeded(message: string) {\n return APIError.from(\"PAYLOAD_TOO_LARGE\", {\n ...S3_ERROR_CODES.QUOTA_EXCEEDED,\n message,\n });\n}\n\n/**\n * Reject uploads that would exceed scope usage.\n * Wire as `upload.guard` (after `db()` so ownership still runs), or pass\n * `quota` on {@link db}.\n */\nexport function createQuotaGuard(\n options: CreateQuotaGuardOptions,\n): (context: QuotaGuardContext) => Promise<void> {\n const objects = resolveStore(options.client);\n\n return async (context) => {\n const scope = await options.resolveScope(context.request);\n if (scope === null) throw unauthorized();\n const usage = await objects.getScopeUsage(scope);\n const incoming = context.file?.size ?? 0;\n const replacing = context.replace === \"overwrite\";\n\n if (\n typeof options.maxFiles === \"number\" &&\n !replacing &&\n usage.objectCount >= options.maxFiles\n ) {\n throw quotaExceeded(\"File count quota exceeded\");\n }\n if (typeof options.maxBytes === \"number\") {\n let projected = usage.totalBytes + incoming;\n if (replacing && context.key && context.bucket) {\n const existing = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n const oldSize =\n existing && existing.status !== \"deleted\"\n ? (existing.size ?? existing.declaredSize ?? 0)\n : 0;\n projected = usage.totalBytes - oldSize + incoming;\n }\n if (projected > options.maxBytes) {\n throw quotaExceeded(\"Storage byte quota exceeded\");\n }\n }\n };\n}\n","import * as z from \"zod\";\nimport { routeNameSchema, trimmedString } from \"@dimah-s3/core\";\n\nexport const DB_LIST_DEFAULT_LIMIT = 50;\nexport const DB_LIST_MAX_LIMIT = 100;\n\n/**\n * Query-string integers arrive as strings; `s3.api` may pass numbers.\n * A codec stays compilable (`z.coerce` is not).\n */\nfunction queryInt(schema: z.ZodInt) {\n return z.codec(\n z.union([z.string().trim().regex(z.regexes.integer), schema]),\n schema,\n {\n decode: (value) =>\n typeof value === \"number\" ? value : Number.parseInt(value, 10),\n encode: (value) => value,\n },\n );\n}\n\nexport const dbListQuerySchema = z.object({\n status: z.enum([\"pending\", \"active\", \"deleted\"]).optional(),\n limit: queryInt(z.int().min(1).max(DB_LIST_MAX_LIMIT)).default(\n DB_LIST_DEFAULT_LIMIT,\n ),\n offset: queryInt(z.int().nonnegative()).optional(),\n cursor: trimmedString.optional(),\n route: routeNameSchema.optional(),\n contentType: trimmedString.optional(),\n prefix: trimmedString.optional(),\n});\n\nexport const dbGetQuerySchema = z.object({\n key: trimmedString,\n bucket: trimmedString.optional(),\n});\n","import type { DbClientObject, StorageObject } from \"@/types/storage-object\";\n\n/**\n * Map a full store row to the browser wire contract for `GET /db/objects`.\n * Drops server-only fields (`scope`, `eTag`, `metadata`, `acl`, …).\n */\nexport function toDbClientObject(object: StorageObject): DbClientObject {\n return {\n id: object.id,\n bucket: object.bucket,\n key: object.key,\n route: object.route,\n filename: object.filename,\n contentType: object.contentType,\n size: object.size,\n declaredSize: object.declaredSize,\n status: object.status,\n createdAt: object.createdAt.toISOString(),\n };\n}\n","import { pluginPath } from \"@dimah-s3/core\";\nimport { createS3Endpoint } from \"@dimah-s3/server\";\nimport { notFound, unauthorized } from \"@/errors\";\nimport type { StorageObjectStore } from \"@/store/storage-object-store\";\nimport { encodeListCursor } from \"@/store/list-cursor\";\nimport type {\n DbClientListResponse,\n DbClientObject,\n ScopeResolver,\n} from \"@/types/storage-object\";\nimport {\n dbGetQuerySchema,\n dbListQuerySchema,\n DB_LIST_DEFAULT_LIMIT,\n} from \"./list-query-schema\";\nimport { toDbClientObject } from \"./to-db-client-object\";\n\nexport {\n dbListQuerySchema,\n dbGetQuerySchema,\n DB_LIST_DEFAULT_LIMIT,\n DB_LIST_MAX_LIMIT,\n} from \"./list-query-schema\";\n\n/**\n * HTTP endpoints for the `db` plugin — `GET /db/objects` and `GET /db/object`.\n */\nexport function createDatabaseEndpoints(options: {\n objects: StorageObjectStore;\n resolveScope: ScopeResolver;\n}) {\n return {\n /** List objects + usage for the request scope (`resolveScope`). */\n objects: createS3Endpoint(\n pluginPath(\"db\", \"objects\"),\n { method: \"GET\", query: dbListQuerySchema },\n async (ctx): Promise<DbClientListResponse> => {\n const scope = await options.resolveScope(ctx.context.request);\n if (scope === null) throw unauthorized();\n\n const {\n status,\n limit = DB_LIST_DEFAULT_LIMIT,\n offset,\n cursor,\n route,\n contentType,\n prefix,\n } = ctx.query ?? {};\n\n const fetchLimit = limit + 1;\n const [rows, usage] = await Promise.all([\n options.objects.listByScope({\n scope,\n status: status ?? \"active\",\n limit: fetchLimit,\n offset,\n cursor,\n route,\n contentType,\n prefix,\n }),\n options.objects.getScopeUsage(scope),\n ]);\n\n const hasMore = rows.length > limit;\n const page = hasMore ? rows.slice(0, limit) : rows;\n const last = page.at(-1);\n const nextCursor =\n hasMore && last ? encodeListCursor(last.createdAt, last.id) : null;\n\n return {\n scope,\n usage,\n objects: page.map(toDbClientObject),\n nextCursor,\n };\n },\n ),\n object: createS3Endpoint(\n pluginPath(\"db\", \"object\"),\n { method: \"GET\", query: dbGetQuerySchema },\n async (ctx): Promise<{ object: DbClientObject }> => {\n const scope = await options.resolveScope(ctx.context.request);\n if (scope === null) throw unauthorized();\n const found = await options.objects.findByScopeKey({\n scope,\n key: ctx.query.key,\n bucket: ctx.query.bucket,\n });\n if (!found || found.status === \"deleted\") throw notFound();\n return { object: toDbClientObject(found) };\n },\n ),\n };\n}\n","import type { DimahS3PluginHooks } from \"@dimah-s3/server\";\nimport { forbidden, unauthorized } from \"@/errors\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { ScopeResolver } from \"@/types/storage-object\";\nimport {\n createObjectAccessGuard,\n resolveStore,\n} from \"@/hooks/create-object-access-guard\";\n\nconst DEFAULT_PENDING_TTL_MS = 24 * 60 * 60 * 1000;\n\nexport type CreateDatabaseLifecycleHooksOptions = {\n client: DimahS3DbClient | StorageObjectStore;\n resolveScope: ScopeResolver;\n pendingTtlMs?: number;\n deleteMode?: \"soft\" | \"hard\";\n};\n\n/**\n * Internal lifecycle hooks for the `db` plugin.\n * Keep the `storage_object` table in sync with S3 and enforce scope ownership.\n */\nexport function createDatabaseLifecycleHooks(\n options: CreateDatabaseLifecycleHooksOptions,\n): { objects: StorageObjectStore; hooks: DimahS3PluginHooks } {\n const objects = resolveStore(options.client);\n const pendingTtlMs = options.pendingTtlMs ?? DEFAULT_PENDING_TTL_MS;\n const deleteMode = options.deleteMode ?? \"soft\";\n\n const scopeCache = new WeakMap<Request, string | null>();\n async function requireScope(request: Request): Promise<string> {\n let scope = scopeCache.get(request);\n if (scope === undefined) {\n scope = await options.resolveScope(request);\n scopeCache.set(request, scope);\n }\n if (scope === null) throw unauthorized();\n return scope;\n }\n\n async function guardKeyOwnership(context: {\n request: Request;\n bucket: string;\n key: string;\n }): Promise<void> {\n const scope = await requireScope(context.request);\n const existing = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (existing && existing.status !== \"deleted\" && existing.scope !== scope) {\n throw forbidden(\"Key belongs to another scope\");\n }\n }\n\n async function trackPending(context: {\n request: Request;\n route: string;\n bucket: string;\n key: string;\n file: { name: string; size?: number; type?: string };\n metadata?: Record<string, string>;\n acl?: string;\n uploadId?: string;\n replace?: \"overwrite\";\n }): Promise<void> {\n const scope = await requireScope(context.request);\n if (context.replace === \"overwrite\") {\n const existing = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (existing?.status === \"active\" && existing.scope === scope) {\n return;\n }\n }\n await objects.upsertPending({\n scope,\n bucket: context.bucket,\n key: context.key,\n route: context.route,\n contentType: context.file.type ?? null,\n declaredSize: context.file.size ?? null,\n metadata: context.metadata ?? null,\n acl: context.acl ?? null,\n filename: context.file.name,\n uploadId: context.uploadId ?? null,\n expiresAt: new Date(Date.now() + pendingTtlMs),\n });\n }\n\n async function trackConfirmed(context: {\n bucket: string;\n key: string;\n contentLength: number;\n eTag?: string;\n contentType?: string;\n acl?: string;\n fileName?: string;\n metadata?: Record<string, string>;\n }): Promise<void> {\n await objects.markActive({\n bucket: context.bucket,\n key: context.key,\n size: context.contentLength,\n eTag: context.eTag ?? null,\n contentType: context.contentType,\n acl: context.acl,\n filename: context.fileName,\n metadata: context.metadata,\n });\n }\n\n const pendingObjectGuard = createObjectAccessGuard({\n client: objects,\n resolveScope: options.resolveScope,\n requireStatus: \"pending\",\n });\n const multipartSessionGuard = createObjectAccessGuard({\n client: objects,\n resolveScope: options.resolveScope,\n requireStatus: \"pending\",\n requireUploadId: true,\n });\n const activeObjectGuard = createObjectAccessGuard({\n client: objects,\n resolveScope: options.resolveScope,\n requireStatus: \"active\",\n });\n const ownedObjectGuard = createObjectAccessGuard({\n client: objects,\n resolveScope: options.resolveScope,\n requireStatus: \"any\",\n });\n\n return {\n objects,\n hooks: {\n upload: {\n guard: guardKeyOwnership,\n onPresigned: trackPending,\n confirmGuard: async (context) => {\n if (context.replace === \"overwrite\") {\n await ownedObjectGuard(context);\n return;\n }\n await pendingObjectGuard(context);\n },\n onConfirmed: trackConfirmed,\n multipart: {\n onInit: trackPending,\n guard: multipartSessionGuard,\n onAbort: async (context) => {\n await objects.deletePending({\n bucket: context.bucket,\n key: context.key,\n uploadId: context.uploadId,\n });\n },\n },\n },\n download: {\n guard: activeObjectGuard,\n },\n delete: {\n guard: ownedObjectGuard,\n onDeleted: async (context) => {\n const ref = { bucket: context.bucket, key: context.key };\n if (deleteMode === \"hard\") await objects.hardDelete(ref);\n else await objects.softDelete(ref);\n },\n },\n },\n };\n}\n","import { definePlugin, isFeatureOn, chainHooks } from \"@dimah-s3/server\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { ScopeResolver } from \"@/types/storage-object\";\nimport { createQuotaGuard } from \"@/hooks/create-quota-guard\";\nimport { createDatabaseEndpoints } from \"./create-database-endpoints\";\nimport { createDatabaseLifecycleHooks } from \"./create-database-lifecycle-hooks\";\n\nexport type DbPluginOptions = {\n /** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt objects store. */\n client: DimahS3DbClient | StorageObjectStore;\n /** Maps a request to its owning scope. `null` rejects with 401. */\n resolveScope: ScopeResolver;\n /**\n * How long a `pending` row stays valid before the purge job may remove it.\n * @default 86_400_000 (24h)\n */\n pendingTtlMs?: number;\n /**\n * After a normal server delete (`api.delete` → S3 `DeleteObject`), how the\n * plugin updates the DB row in `onDeleted`: `soft` keeps it with\n * `status = \"deleted\"`; `hard` removes it. Does not change the S3 delete\n * path — callers still use `api.delete`, not store helpers.\n * @default \"soft\"\n */\n deleteMode?: \"soft\" | \"hard\";\n /**\n * Optional scope usage caps. Numbers come from you — the plugin only\n * checks. Wired as `upload.guard` after ownership.\n */\n quota?: {\n maxBytes?: number;\n maxFiles?: number;\n };\n};\n\nexport type DbPluginContext = {\n /** `storage_object` data-access layer — listings, quota, resume, custom routes. */\n objects: StorageObjectStore;\n /** Underlying FumaDB client (or the store when one was passed as `client`). */\n client: DimahS3DbClient | StorageObjectStore;\n};\n\n/**\n * Persistence plugin for {@link dimahS3} — keeps rows in sync with upload /\n * multipart / download / delete lifecycle and enforces scope ownership.\n *\n * Hooks attach to every route unless the route sets `plugins: { db: false }`.\n *\n * Exposes `GET /db/objects` and `GET /db/object` for the browser via\n * {@link dbClient}.\n *\n * ```ts\n * const s3 = dimahS3({\n * client: awsS3,\n * bucket,\n * plugins: [\n * db({ client: dimahS3Db, resolveScope }),\n * ],\n * routes: {\n * uploads: route({\n * upload: true,\n * }),\n * },\n * });\n *\n * s3.db.objects.listByScope({ scope });\n * s3.context.db === s3.db;\n * ```\n */\nexport function db(options: DbPluginOptions) {\n const { objects, hooks } = createDatabaseLifecycleHooks(options);\n if (options.quota && hooks.upload) {\n const quotaGuard = createQuotaGuard({\n client: objects,\n resolveScope: options.resolveScope,\n maxBytes: options.quota.maxBytes,\n maxFiles: options.quota.maxFiles,\n });\n hooks.upload.guard = chainHooks(hooks.upload.guard, quotaGuard);\n }\n\n return definePlugin({\n id: \"db\",\n init({ config }) {\n const routes = Object.values(config.routes);\n const hasLifecycle = routes.some(\n (r) =>\n isFeatureOn(r.upload) ||\n isFeatureOn(r.download) ||\n isFeatureOn(r.delete),\n );\n if (!hasLifecycle) {\n throw new Error(\n \"[dimah-s3] db plugin requires at least one route with upload, download, or delete enabled.\",\n );\n }\n },\n hooks,\n endpoints: createDatabaseEndpoints({\n objects,\n resolveScope: options.resolveScope,\n }),\n context: {\n objects,\n client: options.client,\n } satisfies DbPluginContext,\n });\n}\n","import {\n AbortMultipartUploadCommand,\n DeleteObjectCommand,\n type S3Client,\n} from \"@aws-sdk/client-s3\";\nimport { resolveStore } from \"@/hooks/create-object-access-guard\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { StorageObject } from \"@/types/storage-object\";\n\nconst DEFAULT_OLDER_THAN_MS = 24 * 60 * 60 * 1000;\n\nexport type PurgeStalePendingOptions = {\n /** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt store. */\n client: DimahS3DbClient | StorageObjectStore;\n /**\n * Fallback age for pending rows that have no `expiresAt`.\n * @default 86_400_000 (24h)\n */\n olderThanMs?: number;\n /**\n * When set, abort in-progress multipart uploads and `DeleteObject` for\n * each stale pending key before rows are removed.\n */\n s3?: S3Client;\n /**\n * Runs before rows are deleted. Throwing keeps all rows for the next run.\n * Prefer `s3` unless you need a custom cleanup.\n */\n onBeforePurge?: (objects: StorageObject[]) => Promise<void> | void;\n};\n\nexport type PurgeStalePendingResult = {\n purged: StorageObject[];\n};\n\nasync function abortAndDelete(\n s3: S3Client,\n objects: StorageObject[],\n): Promise<void> {\n for (const object of objects) {\n if (object.uploadId) {\n try {\n await s3.send(\n new AbortMultipartUploadCommand({\n Bucket: object.bucket,\n Key: object.key,\n UploadId: object.uploadId,\n }),\n );\n } catch {\n // Best-effort.\n }\n }\n try {\n await s3.send(\n new DeleteObjectCommand({\n Bucket: object.bucket,\n Key: object.key,\n }),\n );\n } catch {\n // Best-effort.\n }\n }\n}\n\n/**\n * Delete stale `pending` rows — uploads that were presigned but never\n * confirmed. Run it on a schedule (cron, queue worker, route handler).\n */\nexport async function purgeStalePendingObjects(\n options: PurgeStalePendingOptions,\n): Promise<PurgeStalePendingResult> {\n const store = resolveStore(options.client);\n const olderThan = new Date(\n Date.now() - (options.olderThanMs ?? DEFAULT_OLDER_THAN_MS),\n );\n\n const stale = await store.findStalePending({ olderThan });\n if (stale.length === 0) return { purged: [] };\n\n if (options.s3) await abortAndDelete(options.s3, stale);\n await options.onBeforePurge?.(stale);\n await store.deleteByIds(stale.map((object) => object.id));\n\n return { purged: stale };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/schema/v1.ts","../src/fuma-db.ts","../src/errors.ts","../src/store/map-row.ts","../src/store/list-cursor.ts","../src/store/storage-object-store.ts","../src/hooks/create-object-access-guard.ts","../src/hooks/create-quota-guard.ts","../src/plugin/list-query-schema.ts","../src/plugin/to-db-client-object.ts","../src/plugin/create-database-endpoints.ts","../src/plugin/memoize-scope-resolver.ts","../src/plugin/create-database-lifecycle-hooks.ts","../src/plugin/db.ts","../src/jobs/purge-stale-pending.ts"],"names":["object","db","APIError","S3_ERROR_CODES","schema","AbortMultipartUploadCommand"],"mappings":";;;;;;;;AAcA,IAAM,aAAA,GAAgB,MAAM,gBAAA,EAAkB;AAAA,EAC5C,IAAI,QAAA,CAAS,IAAA,EAAM,cAAc,CAAA,CAAE,WAAW,MAAM,CAAA;AAAA,EACpD,KAAA,EAAO,MAAA,CAAO,OAAA,EAAS,QAAQ,CAAA;AAAA,EAC/B,MAAA,EAAQ,MAAA,CAAO,QAAA,EAAU,QAAQ,CAAA;AAAA,EACjC,GAAA,EAAK,MAAA,CAAO,KAAA,EAAO,QAAQ,CAAA;AAAA;AAAA,EAE3B,KAAA,EAAO,MAAA,CAAO,OAAA,EAAS,QAAQ,CAAA;AAAA,EAC/B,WAAA,EAAa,MAAA,CAAO,cAAA,EAAgB,QAAQ,EAAE,QAAA,EAAS;AAAA;AAAA,EAEvD,IAAA,EAAM,MAAA,CAAO,MAAA,EAAQ,QAAQ,EAAE,QAAA,EAAS;AAAA,EACxC,IAAA,EAAM,MAAA,CAAO,OAAA,EAAS,QAAQ,EAAE,QAAA,EAAS;AAAA,EACzC,QAAA,EAAU,MAAA,CAAO,UAAA,EAAY,QAAQ,EAAE,QAAA,EAAS;AAAA,EAChD,MAAA,EAAQ,MAAA,CAAO,QAAA,EAAU,QAAQ,CAAA;AAAA;AAAA,EAEjC,QAAA,EAAU,MAAA,CAAO,UAAA,EAAY,MAAM,EAAE,QAAA,EAAS;AAAA,EAC9C,GAAA,EAAK,MAAA,CAAO,KAAA,EAAO,QAAQ,EAAE,QAAA,EAAS;AAAA;AAAA,EAEtC,QAAA,EAAU,MAAA,CAAO,WAAA,EAAa,QAAQ,EAAE,QAAA,EAAS;AAAA;AAAA,EAEjD,YAAA,EAAc,MAAA,CAAO,eAAA,EAAiB,QAAQ,EAAE,QAAA,EAAS;AAAA,EACzD,WAAA,EAAa,MAAA,CAAO,cAAA,EAAgB,WAAW,EAAE,QAAA,EAAS;AAAA;AAAA,EAE1D,SAAA,EAAW,MAAA,CAAO,YAAA,EAAc,WAAW,EAAE,QAAA,EAAS;AAAA,EACtD,WAAW,MAAA,CAAO,YAAA,EAAc,WAAW,CAAA,CAAE,WAAW,KAAK,CAAA;AAAA,EAC7D,WAAW,MAAA,CAAO,YAAA,EAAc,WAAW,CAAA,CAAE,WAAW,KAAK,CAAA;AAAA,EAC7D,SAAA,EAAW,MAAA,CAAO,YAAA,EAAc,WAAW,EAAE,QAAA;AAC/C,CAAC,EAAE,MAAA,CAAO,8BAAA,EAAgC,CAAC,QAAA,EAAU,KAAK,CAAC,CAAA;AAEpD,IAAM,KAAK,MAAA,CAAO;AAAA,EACvB,OAAA,EAAS,OAAA;AAAA,EACT,MAAA,EAAQ;AAAA,IACN;AAAA;AAEJ,CAAC;;;AC5CM,IAAM,YAAY,MAAA,CAAO;AAAA,EAC9B,SAAA,EAAW,UAAA;AAAA,EACX,OAAA,EAAS,CAAC,EAAE;AACd,CAAC;ACJM,SAAS,YAAA,CACd,OAAA,GAAkB,cAAA,CAAe,YAAA,CAAa,OAAA,EACpC;AACV,EAAA,OAAO,QAAA,CAAS,KAAK,cAAA,EAAgB;AAAA,IACnC,GAAG,cAAA,CAAe,YAAA;AAAA,IAClB;AAAA,GACD,CAAA;AACH;AAEO,SAAS,SAAA,CACd,OAAA,GAAkB,cAAA,CAAe,SAAA,CAAU,OAAA,EACjC;AACV,EAAA,OAAO,QAAA,CAAS,KAAK,WAAA,EAAa;AAAA,IAChC,GAAG,cAAA,CAAe,SAAA;AAAA,IAClB;AAAA,GACD,CAAA;AACH;AAEO,SAAS,QAAA,CACd,OAAA,GAAkB,cAAA,CAAe,gBAAA,CAAiB,OAAA,EACxC;AACV,EAAA,OAAO,QAAA,CAAS,KAAK,WAAA,EAAa;AAAA,IAChC,GAAG,cAAA,CAAe,gBAAA;AAAA,IAClB;AAAA,GACD,CAAA;AACH;AAEO,SAAS,QAAA,CACd,OAAA,GAAkB,cAAA,CAAe,QAAA,CAAS,OAAA,EAChC;AACV,EAAA,OAAO,QAAA,CAAS,KAAK,UAAA,EAAY;AAAA,IAC/B,GAAG,cAAA,CAAe,QAAA;AAAA,IAClB;AAAA,GACD,CAAA;AACH;;;ACRA,SAAS,SAAS,KAAA,EAA8C;AAC9D,EAAA,IAAI,KAAA,KAAU,MAAM,OAAO,IAAA;AAC3B,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,MAAA,CAAO,KAAK,CAAA,GAAI,KAAA;AACrD;AAGO,SAAS,oBAAoB,GAAA,EAAsC;AACxE,EAAA,OAAO;AAAA,IACL,IAAI,GAAA,CAAI,EAAA;AAAA,IACR,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,KAAK,GAAA,CAAI,GAAA;AAAA,IACT,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,IAAA,EAAM,QAAA,CAAS,GAAA,CAAI,IAAI,CAAA;AAAA,IACvB,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,UAAU,GAAA,CAAI,QAAA;AAAA,IACd,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,QAAA,EAAW,IAAI,QAAA,IAAY,IAAA;AAAA,IAC3B,KAAK,GAAA,CAAI,GAAA;AAAA,IACT,UAAU,GAAA,CAAI,QAAA;AAAA,IACd,YAAA,EAAc,QAAA,CAAS,GAAA,CAAI,YAAY,CAAA;AAAA,IACvC,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,WAAW,GAAA,CAAI;AAAA,GACjB;AACF;;;ACxDO,SAAS,gBAAA,CAAiB,WAAiB,EAAA,EAAoB;AACpE,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,CAAA,EAAG,SAAA,CAAU,WAAA,EAAa,CAAA,CAAA,EAAK,EAAE,CAAA,CAAA,EAAI,MAAM,CAAA,CAAE,QAAA;AAAA,IAC9D;AAAA,GACF;AACF;AAEO,SAAS,iBACd,MAAA,EACwC;AACxC,EAAA,IAAI;AACF,IAAA,MAAM,MAAM,MAAA,CAAO,IAAA,CAAK,QAAQ,WAAW,CAAA,CAAE,SAAS,MAAM,CAAA;AAC5D,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,OAAA,CAAQ,GAAI,CAAA;AAC5B,IAAA,IAAI,GAAA,GAAM,GAAG,OAAO,IAAA;AACpB,IAAA,MAAM,YAAY,IAAI,IAAA,CAAK,IAAI,KAAA,CAAM,CAAA,EAAG,GAAG,CAAC,CAAA;AAC5C,IAAA,MAAM,EAAA,GAAK,GAAA,CAAI,KAAA,CAAM,GAAA,GAAM,CAAC,CAAA;AAC5B,IAAA,IAAI,CAAC,MAAM,MAAA,CAAO,KAAA,CAAM,UAAU,OAAA,EAAS,GAAG,OAAO,IAAA;AACrD,IAAA,OAAO,EAAE,WAAW,EAAA,EAAG;AAAA,EACzB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;;;ACTA,SAAS,UAAa,KAAA,EAA+B;AACnD,EAAA,IAAI,OAAO,UAAU,SAAA,EAAW;AAC9B,IAAA,MAAM,IAAI,UAAU,uCAAuC,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,KAAA;AACT;AAgFO,SAAS,yBACdA,OAAAA,EAC+B;AAC/B,EAAA,IACEA,OAAAA,CAAO,WAAW,SAAA,IAClBA,OAAAA,CAAO,YAAY,IAAA,IACnBA,OAAAA,CAAO,gBAAgB,IAAA,EACvB;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO;AAAA,IACL,UAAUA,OAAAA,CAAO,QAAA;AAAA,IACjB,KAAKA,OAAAA,CAAO,GAAA;AAAA,IACZ,UAAUA,OAAAA,CAAO,YAAA;AAAA,IACjB,QAAQA,OAAAA,CAAO;AAAA,GACjB;AACF;AAgEA,SAAS,SAAS,KAAA,EAAiD;AACjE,EAAA,OAAO,KAAA,KAAU,QAAQ,KAAA,KAAU,MAAA,GAC/B,OACA,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,KAAK,CAAC,CAAA;AAC9B;AAEA,SAAS,eAAA,CAAgB,OAAwB,GAAA,EAAW;AAC1D,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA,CAAS,KAAA,CAAM,IAAI,CAAA;AAAA,IACzB,IAAA,EAAM,MAAM,IAAA,IAAQ,IAAA;AAAA,IACpB,GAAI,KAAA,CAAM,WAAA,KAAgB,MAAA,IAAa;AAAA,MACrC,aAAa,KAAA,CAAM;AAAA,KACrB;AAAA,IACA,GAAI,KAAA,CAAM,GAAA,KAAQ,UAAa,EAAE,GAAA,EAAK,MAAM,GAAA,EAAI;AAAA,IAChD,GAAI,KAAA,CAAM,QAAA,KAAa,UAAa,EAAE,QAAA,EAAU,MAAM,QAAA,EAAS;AAAA,IAC/D,GAAI,KAAA,CAAM,QAAA,KAAa,UAAa,EAAE,QAAA,EAAU,MAAM,QAAA,EAAS;AAAA,IAC/D,QAAA,EAAU,IAAA;AAAA,IACV,YAAA,EAAc,IAAA;AAAA,IACd,SAAA,EAAW,IAAA;AAAA,IACX,WAAA,EAAa,GAAA;AAAA,IACb,SAAA,EAAW;AAAA,GACb;AACF;AAEA,SAAS,cAAA,CACP,QAAA,EACA,KAAA,EACA,GAAA,EACe;AACf,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,MAAA,EAAQ,QAAA;AAAA,IACR,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,IAAA,EAAM,MAAM,IAAA,IAAQ,IAAA;AAAA,IACpB,aACE,KAAA,CAAM,WAAA,KAAgB,MAAA,GAClB,KAAA,CAAM,cACN,QAAA,CAAS,WAAA;AAAA,IACf,KAAK,KAAA,CAAM,GAAA,KAAQ,MAAA,GAAY,KAAA,CAAM,MAAM,QAAA,CAAS,GAAA;AAAA,IACpD,UAAU,KAAA,CAAM,QAAA,KAAa,MAAA,GAAY,KAAA,CAAM,WAAW,QAAA,CAAS,QAAA;AAAA,IACnE,UAAU,KAAA,CAAM,QAAA,KAAa,MAAA,GAAY,KAAA,CAAM,WAAW,QAAA,CAAS,QAAA;AAAA,IACnE,QAAA,EAAU,IAAA;AAAA,IACV,YAAA,EAAc,IAAA;AAAA,IACd,SAAA,EAAW,IAAA;AAAA,IACX,WAAA,EAAa,GAAA;AAAA,IACb,SAAA,EAAW,GAAA;AAAA,IACX,SAAA,EAAW;AAAA,GACb;AACF;AAGO,SAAS,yBACdC,GAAAA,EACoB;AACpB,EAAA,MAAM,GAAA,GAAMA,GAAAA,CAAG,GAAA,CAAI,OAAO,CAAA;AAE1B,EAAA,MAAM,KAAA,GAA4B;AAAA,IAChC,MAAM,cAAc,KAAA,EAAO;AACzB,MAAA,MAAM,GAAA,uBAAU,IAAA,EAAK;AACrB,MAAA,MAAM,aAAA,GAAgB;AAAA,QACpB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,WAAA,EAAa,MAAM,WAAA,IAAe,IAAA;AAAA,QAClC,YAAA,EAAc,QAAA,CAAS,KAAA,CAAM,YAAY,CAAA;AAAA,QACzC,QAAA,EAAU,MAAM,QAAA,IAAY,IAAA;AAAA,QAC5B,GAAA,EAAK,MAAM,GAAA,IAAO,IAAA;AAAA,QAClB,QAAA,EAAU,MAAM,QAAA,IAAY,IAAA;AAAA,QAC5B,QAAA,EAAU,MAAM,QAAA,IAAY,IAAA;AAAA,QAC5B,SAAA,EAAW,MAAM,SAAA,IAAa,IAAA;AAAA,QAC9B,MAAA,EAAQ,SAAA;AAAA,QACR,IAAA,EAAM,IAAA;AAAA,QACN,IAAA,EAAM,IAAA;AAAA,QACN,WAAA,EAAa,IAAA;AAAA,QACb,SAAA,EAAW;AAAA,OACb;AACA,MAAA,MAAM,GAAA,GAAM,MAAM,GAAA,CACf,MAAA,CAAO,eAAA,EAAiB;AAAA,QACvB,OAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA,CAAI,EAAE,QAAA,EAAU,GAAA,EAAK,KAAA,CAAM,MAAM,GAAG,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAG,CAAC,CAAA;AAAA,QAChE,MAAA,EAAQ,EAAE,GAAG,aAAA,EAAe,WAAW,GAAA,EAAI;AAAA,QAC3C,MAAA,EAAQ;AAAA,UACN,GAAG,aAAA;AAAA,UACH,QAAQ,KAAA,CAAM,MAAA;AAAA,UACd,KAAK,KAAA,CAAM,GAAA;AAAA,UACX,SAAA,EAAW;AAAA;AACb,OACD,EACA,cAAA,EAAe;AAClB,MAAA,OAAO,oBAAoB,GAAG,CAAA;AAAA,IAChC,CAAA;AAAA,IAEA,MAAM,WAAW,KAAA,EAAO;AACtB,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,IAAA,CAAK,KAAK,CAAA;AACvC,MAAA,IAAI,CAAC,QAAA,IAAY,QAAA,CAAS,MAAA,KAAW,SAAA,EAAW;AAC9C,QAAA,MAAM,SAAS,8BAA8B,CAAA;AAAA,MAC/C;AACA,MAAA,MAAM,GAAA,uBAAU,IAAA,EAAK;AACrB,MAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,KAAA,EAAO,GAAG,CAAA;AACzC,MAAA,IAAI,QAAA,CAAS,WAAW,QAAA,EAAU;AAChC,QAAA,MAAM,GAAA,CAAI,WAAW,eAAA,EAAiB;AAAA,UACpC,KAAA,EAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA;AAAA,YACA,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,KAAA,CAAM,MAAM,CAAA;AAAA,YAC7B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAG,CAAA;AAAA,YACvB,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,QAAQ;AAAA,WAC3B;AAAA,UACF,GAAA,EAAK;AAAA,SACN,CAAA;AACD,QAAA,OAAO,cAAA,CAAe,QAAA,EAAU,KAAA,EAAO,GAAG,CAAA;AAAA,MAC5C;AACA,MAAA,IAAI,QAAA,CAAS,WAAW,SAAA,EAAW;AACjC,QAAA,MAAM,SAAS,oCAAoC,CAAA;AAAA,MACrD;AACA,MAAA,MAAM,GAAA,CAAI,WAAW,eAAA,EAAiB;AAAA,QACpC,KAAA,EAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA;AAAA,UACA,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,KAAA,CAAM,MAAM,CAAA;AAAA,UAC7B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAG,CAAA;AAAA,UACvB,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,SAAS;AAAA,SAC5B;AAAA,QACF,GAAA,EAAK;AAAA,UACH,MAAA,EAAQ,QAAA;AAAA,UACR,GAAG,MAAA;AAAA,UACH,SAAA,EAAW;AAAA;AACb,OACD,CAAA;AACD,MAAA,OAAO,cAAA,CAAe,QAAA,EAAU,KAAA,EAAO,GAAG,CAAA;AAAA,IAC5C,CAAA;AAAA,IAEA,MAAM,KAAK,GAAA,EAAK;AACd,MAAA,MAAM,GAAA,GAAM,MAAM,GAAA,CAAI,SAAA,CAAU,eAAA,EAAiB;AAAA,QAC/C,OAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA,CAAI,EAAE,QAAA,EAAU,GAAA,EAAK,GAAA,CAAI,MAAM,GAAG,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,GAAA,CAAI,GAAG,CAAC;AAAA,OAC7D,CAAA;AACD,MAAA,OAAO,GAAA,GAAM,mBAAA,CAAoB,GAAG,CAAA,GAAI,IAAA;AAAA,IAC1C,CAAA;AAAA,IAEA,MAAM,eAAe,KAAA,EAAO;AAC1B,MAAA,MAAM,GAAA,GAAM,MAAM,GAAA,CAAI,SAAA,CAAU,eAAA,EAAiB;AAAA,QAC/C,KAAA,EAAO,CAAC,CAAA,KAAM;AACZ,UAAA,MAAM,KAAA,GAAQ;AAAA,YACZ,CAAA,CAAE,OAAA,EAAS,GAAA,EAAK,KAAA,CAAM,KAAK,CAAA;AAAA,YAC3B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAG;AAAA,WACzB;AACA,UAAA,IAAI,MAAM,MAAA,EAAQ;AAChB,YAAA,KAAA,CAAM,KAAK,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,KAAA,CAAM,MAAM,CAAC,CAAA;AAAA,UAC3C;AACA,UAAA,OAAO,CAAA,CAAE,GAAA,CAAI,GAAG,KAAK,CAAA;AAAA,QACvB;AAAA,OACD,CAAA;AACD,MAAA,OAAO,GAAA,GAAM,mBAAA,CAAoB,GAAG,CAAA,GAAI,IAAA;AAAA,IAC1C,CAAA;AAAA,IAEA,MAAM,WAAW,GAAA,EAAK;AACpB,MAAA,MAAM,GAAA,GAAM,MAAM,GAAA,CAAI,SAAA,CAAU,eAAA,EAAiB;AAAA,QAC/C,KAAA,EAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA;AAAA,UACA,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,GAAA,CAAI,MAAM,CAAA;AAAA,UAC3B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,GAAA,CAAI,GAAG,CAAA;AAAA,UACrB,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,QAAQ;AAAA;AAC3B,OACH,CAAA;AACD,MAAA,OAAO,GAAA,GAAM,mBAAA,CAAoB,GAAG,CAAA,GAAI,IAAA;AAAA,IAC1C,CAAA;AAAA,IAEA,MAAM,qBAAqB,KAAA,EAAO;AAChC,MAAA,MAAM,GAAA,GAAM,MAAM,GAAA,CAAI,SAAA,CAAU,eAAA,EAAiB;AAAA,QAC/C,KAAA,EAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA;AAAA,UACA,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,KAAA,CAAM,MAAM,CAAA;AAAA,UAC7B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAG,CAAA;AAAA,UACvB,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,SAAS,CAAA;AAAA,UAC1B,CAAA,CAAE,UAAU,UAAU,CAAA;AAAA,UACtB,CAAA,CAAE,gBAAgB,GAAA,EAAK,MAAA,CAAO,KAAK,KAAA,CAAM,KAAA,CAAM,QAAQ,CAAC,CAAC;AAAA;AAC3D,OACH,CAAA;AACD,MAAA,OAAO,GAAA,GAAM,mBAAA,CAAoB,GAAG,CAAA,GAAI,IAAA;AAAA,IAC1C,CAAA;AAAA,IAEA,MAAM,YAAY,KAAA,EAAO;AACvB,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,IAAU,QAAA;AAC/B,MAAA,MAAM,SAAS,KAAA,CAAM,MAAA,GAAS,gBAAA,CAAiB,KAAA,CAAM,MAAM,CAAA,GAAI,IAAA;AAC/D,MAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,QAAA,CAAS,eAAA,EAAiB;AAAA,QAC/C,KAAA,EAAO,CAAC,CAAA,KAAM;AACZ,UAAA,MAAM,KAAA,GAAQ;AAAA,YACZ,CAAA,CAAE,OAAA,EAAS,GAAA,EAAK,KAAA,CAAM,KAAK,CAAA;AAAA,YAC3B,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,MAAM;AAAA,WACzB;AACA,UAAA,IAAI,KAAA,CAAM,OAAO,KAAA,CAAM,IAAA,CAAK,EAAE,OAAA,EAAS,GAAA,EAAK,KAAA,CAAM,KAAK,CAAC,CAAA;AACxD,UAAA,IAAI,MAAM,WAAA,EAAa;AACrB,YAAA,KAAA,CAAM,KAAK,CAAA,CAAE,aAAA,EAAe,GAAA,EAAK,KAAA,CAAM,WAAW,CAAC,CAAA;AAAA,UACrD;AACA,UAAA,IAAI,MAAM,MAAA,EAAQ;AAChB,YAAA,KAAA,CAAM,KAAK,CAAA,CAAE,KAAA,EAAO,aAAA,EAAe,KAAA,CAAM,MAAM,CAAC,CAAA;AAAA,UAClD;AACA,UAAA,IAAI,MAAA,EAAQ;AACV,YAAA,KAAA,CAAM,IAAA;AAAA,cACJ,SAAA;AAAA,gBACE,CAAA,CAAE,EAAA;AAAA,kBACA,UAAU,CAAA,CAAE,WAAA,EAAa,GAAA,EAAK,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA,kBAC/C,SAAA;AAAA,oBACE,CAAA,CAAE,GAAA;AAAA,sBACA,CAAA,CAAE,WAAA,EAAa,GAAA,EAAK,MAAA,CAAO,SAAS,CAAA;AAAA,sBACpC,CAAA,CAAE,IAAA,EAAM,GAAA,EAAK,MAAA,CAAO,EAAE;AAAA;AACxB;AACF;AACF;AACF,aACF;AAAA,UACF;AACA,UAAA,OAAO,CAAA,CAAE,GAAA,CAAI,GAAG,KAAK,CAAA;AAAA,QACvB,CAAA;AAAA,QACA,OAAA,EAAS,CAAC,WAAA,EAAa,MAAM,CAAA;AAAA,QAC7B,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,MAAA,EAAQ,MAAA,GAAS,MAAA,GAAY,KAAA,CAAM;AAAA,OACpC,CAAA;AACD,MAAA,OAAO,IAAA,CAAK,IAAI,mBAAmB,CAAA;AAAA,IACrC,CAAA;AAAA,IAEA,MAAM,cAAc,KAAA,EAAO;AACzB,MAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,QAAA,CAAS,eAAA,EAAiB;AAAA,QAC/C,MAAA,EAAQ,CAAC,MAAA,EAAQ,cAAc,CAAA;AAAA,QAC/B,KAAA,EAAO,CAAC,CAAA,KACN,CAAA,CAAE,IAAI,CAAA,CAAE,OAAA,EAAS,GAAA,EAAK,KAAK,CAAA,EAAG,CAAA,CAAE,QAAA,EAAU,IAAA,EAAM,SAAS,CAAC;AAAA,OAC7D,CAAA;AACD,MAAA,IAAI,UAAA,GAAa,CAAA;AACjB,MAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,QAAA,UAAA,IAAc,MAAA,CAAO,GAAA,CAAI,IAAA,IAAQ,GAAA,CAAI,gBAAgB,EAAE,CAAA;AAAA,MACzD;AACA,MAAA,OAAO,EAAE,UAAA,EAAY,WAAA,EAAa,IAAA,CAAK,MAAA,EAAO;AAAA,IAChD,CAAA;AAAA,IAEA,MAAM,YAAA,CAAa,KAAA,EAAO,MAAA,GAAS,QAAA,EAAU;AAC3C,MAAA,OAAO,GAAA,CAAI,MAAM,eAAA,EAAiB;AAAA,QAChC,KAAA,EAAO,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI,CAAA,CAAE,OAAA,EAAS,GAAA,EAAK,KAAK,CAAA,EAAG,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,MAAM,CAAC;AAAA,OACrE,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,MAAM,WAAW,GAAA,EAAK;AACpB,MAAA,MAAM,GAAA,uBAAU,IAAA,EAAK;AACrB,MAAA,MAAM,GAAA,CAAI,WAAW,eAAA,EAAiB;AAAA,QACpC,OAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA,CAAI,EAAE,QAAA,EAAU,GAAA,EAAK,GAAA,CAAI,MAAM,GAAG,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,QAC5D,KAAK,EAAE,MAAA,EAAQ,WAAW,SAAA,EAAW,GAAA,EAAK,WAAW,GAAA;AAAI,OAC1D,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,MAAM,WAAW,GAAA,EAAK;AACpB,MAAA,MAAM,GAAA,CAAI,WAAW,eAAA,EAAiB;AAAA,QACpC,OAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA,CAAI,EAAE,QAAA,EAAU,GAAA,EAAK,GAAA,CAAI,MAAM,GAAG,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,GAAA,CAAI,GAAG,CAAC;AAAA,OAC7D,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,MAAM,cAAc,GAAA,EAAK;AACvB,MAAA,MAAM,GAAA,CAAI,WAAW,eAAA,EAAiB;AAAA,QACpC,KAAA,EAAO,CAAC,CAAA,KAAM;AACZ,UAAA,IAAI,GAAA,CAAI,YAAY,IAAA,EAAM;AACxB,YAAA,OAAO,CAAA,CAAE,GAAA;AAAA,cACP,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,GAAA,CAAI,MAAM,CAAA;AAAA,cAC3B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,GAAA,CAAI,GAAG,CAAA;AAAA,cACrB,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,SAAS,CAAA;AAAA,cAC1B,CAAA,CAAE,UAAA,EAAY,GAAA,EAAK,GAAA,CAAI,QAAQ;AAAA,aACjC;AAAA,UACF;AACA,UAAA,OAAO,CAAA,CAAE,GAAA;AAAA,YACP,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,GAAA,CAAI,MAAM,CAAA;AAAA,YAC3B,CAAA,CAAE,KAAA,EAAO,GAAA,EAAK,GAAA,CAAI,GAAG,CAAA;AAAA,YACrB,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,SAAS;AAAA,WAC5B;AAAA,QACF;AAAA,OACD,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,MAAM,gBAAA,CAAiB,EAAE,SAAA,EAAU,EAAG;AACpC,MAAA,MAAM,GAAA,uBAAU,IAAA,EAAK;AACrB,MAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,QAAA,CAAS,eAAA,EAAiB;AAAA,QAC/C,KAAA,EAAO,CAAC,CAAA,KACN,CAAA,CAAE,GAAA;AAAA,UACA,CAAA,CAAE,QAAA,EAAU,GAAA,EAAK,SAAS,CAAA;AAAA,UAC1B,CAAA,CAAE,EAAA;AAAA,YACA,CAAA,CAAE,WAAA,EAAa,GAAA,EAAK,GAAG,CAAA;AAAA,YACvB,SAAA;AAAA,cACE,CAAA,CAAE,GAAA,CAAI,CAAA,CAAE,MAAA,CAAO,WAAW,GAAG,CAAA,CAAE,WAAA,EAAa,GAAA,EAAK,SAAS,CAAC;AAAA;AAC7D;AACF,SACF;AAAA,QACF,OAAA,EAAS,CAAC,WAAA,EAAa,KAAK;AAAA,OAC7B,CAAA;AACD,MAAA,OAAO,IAAA,CAAK,IAAI,mBAAmB,CAAA;AAAA,IACrC,CAAA;AAAA,IAEA,MAAM,YAAY,GAAA,EAAK;AACrB,MAAA,IAAI,GAAA,CAAI,WAAW,CAAA,EAAG;AACtB,MAAA,MAAM,GAAA,CAAI,WAAW,eAAA,EAAiB;AAAA,QACpC,OAAO,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,EAAM,MAAM,GAAG;AAAA,OAChC,CAAA;AAAA,IACH;AAAA,GACF;AAEA,EAAA,OAAO,KAAA;AACT;;;ACtaO,SAAS,aACd,MAAA,EACoB;AACpB,EAAA,OAAO,eAAA,IAAmB,MAAA,GAAS,MAAA,GAAS,wBAAA,CAAyB,MAAM,CAAA;AAC7E;AASO,SAAS,wBACd,OAAA,EACsD;AACtD,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,OAAA,CAAQ,MAAM,CAAA;AACzC,EAAA,MAAM,aAAA,GAAgB,QAAQ,aAAA,IAAiB,QAAA;AAE/C,EAAA,OAAO,OAAO,OAAA,KAAY;AACxB,IAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,CAAQ,YAAA,CAAa,QAAQ,OAAA,EAAS;AAAA,MACxD,WAAW,OAAA,CAAQ,SAAA;AAAA,MACnB,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,KAAK,OAAA,CAAQ;AAAA,KACd,CAAA;AACD,IAAA,IAAI,KAAA,KAAU,IAAA,EAAM,MAAM,YAAA,EAAa;AAEvC,IAAA,MAAMD,OAAAA,GAAS,MAAM,KAAA,CAAM,IAAA,CAAK;AAAA,MAC9B,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAK,OAAA,CAAQ;AAAA,KACd,CAAA;AACD,IAAA,IAAI,CAACA,OAAAA,IAAUA,OAAAA,CAAO,MAAA,KAAW,SAAA,QAAiB,QAAA,EAAS;AAE3D,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,SAAA,GACpB,MAAM,QAAQ,SAAA,CAAUA,OAAAA,EAAQ,EAAE,GAAG,OAAA,EAAS,KAAA,EAAO,CAAA,GACrDA,QAAO,KAAA,KAAU,KAAA;AACrB,IAAA,IAAI,CAAC,OAAA,EAAS,MAAM,SAAA,EAAU;AAE9B,IAAA,MAAM,QAAA,GACJ,aAAA,KAAkB,KAAA,GAAQ,IAAA,GAAOA,QAAO,MAAA,KAAW,aAAA;AACrD,IAAA,IAAI,CAAC,QAAA,EAAU,MAAM,QAAA,EAAS;AAE9B,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,IAAI,CAAC,OAAA,CAAQ,QAAA,IAAYA,OAAAA,CAAO,QAAA,KAAa,QAAQ,QAAA,EAAU;AAC7D,QAAA,MAAM,UAAU,+BAA+B,CAAA;AAAA,MACjD;AAAA,IACF;AAAA,EACF,CAAA;AACF;;;AC3EA,SAAS,cAAc,OAAA,EAAiB;AACtC,EAAA,OAAOE,QAAAA,CAAS,KAAK,mBAAA,EAAqB;AAAA,IACxC,GAAGC,cAAAA,CAAe,cAAA;AAAA,IAClB;AAAA,GACD,CAAA;AACH;AAOO,SAAS,iBACd,OAAA,EAC+C;AAC/C,EAAA,MAAM,OAAA,GAAU,YAAA,CAAa,OAAA,CAAQ,MAAM,CAAA;AAE3C,EAAA,OAAO,OAAO,OAAA,KAAY;AACxB,IAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,CAAQ,YAAA,CAAa,QAAQ,OAAA,EAAS;AAAA,MACxD,SAAA,EAAW,QAAA;AAAA,MACX,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AACD,IAAA,IAAI,KAAA,KAAU,IAAA,EAAM,MAAM,YAAA,EAAa;AACvC,IAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,CAAQ,aAAA,CAAc,KAAK,CAAA;AAC/C,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,IAAA,EAAM,IAAA,IAAQ,CAAA;AACvC,IAAA,MAAM,SAAA,GAAY,QAAQ,OAAA,KAAY,WAAA;AAEtC,IAAA,IACE,OAAO,QAAQ,QAAA,KAAa,QAAA,IAC5B,CAAC,SAAA,IACD,KAAA,CAAM,WAAA,IAAe,OAAA,CAAQ,QAAA,EAC7B;AACA,MAAA,MAAM,cAAc,2BAA2B,CAAA;AAAA,IACjD;AACA,IAAA,IAAI,OAAO,OAAA,CAAQ,QAAA,KAAa,QAAA,EAAU;AACxC,MAAA,IAAI,SAAA,GAAY,MAAM,UAAA,GAAa,QAAA;AACnC,MAAA,IAAI,SAAA,IAAa,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,MAAA,EAAQ;AAC9C,QAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,IAAA,CAAK;AAAA,UAClC,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,KAAK,OAAA,CAAQ;AAAA,SACd,CAAA;AACD,QAAA,MAAM,OAAA,GACJ,YAAY,QAAA,CAAS,MAAA,KAAW,YAC3B,QAAA,CAAS,IAAA,IAAQ,QAAA,CAAS,YAAA,IAAgB,CAAA,GAC3C,CAAA;AACN,QAAA,SAAA,GAAY,KAAA,CAAM,aAAa,OAAA,GAAU,QAAA;AAAA,MAC3C;AACA,MAAA,IAAI,SAAA,GAAY,QAAQ,QAAA,EAAU;AAChC,QAAA,MAAM,cAAc,6BAA6B,CAAA;AAAA,MACnD;AAAA,IACF;AAAA,EACF,CAAA;AACF;AC/EO,IAAM,qBAAA,GAAwB,EAAA;AAC9B,IAAM,iBAAA,GAAoB,GAAA;AAMjC,SAAS,SAASC,OAAAA,EAAkB;AAClC,EAAA,OAAS,CAAA,CAAA,KAAA;AAAA,IACL,CAAA,CAAA,KAAA,CAAM,CAAG,CAAA,CAAA,MAAA,EAAO,CAAE,IAAA,EAAK,CAAE,KAAA,CAAQ,CAAA,CAAA,OAAA,CAAQ,OAAO,CAAA,EAAGA,OAAM,CAAC,CAAA;AAAA,IAC5DA,OAAAA;AAAA,IACA;AAAA,MACE,MAAA,EAAQ,CAAC,KAAA,KACP,OAAO,KAAA,KAAU,WAAW,KAAA,GAAQ,MAAA,CAAO,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA;AAAA,MAC/D,MAAA,EAAQ,CAAC,KAAA,KAAU;AAAA;AACrB,GACF;AACF;AAEO,IAAM,oBAAsB,CAAA,CAAA,MAAA,CAAO;AAAA,EACxC,MAAA,EAAU,OAAK,CAAC,SAAA,EAAW,UAAU,SAAS,CAAC,EAAE,QAAA,EAAS;AAAA,EAC1D,KAAA,EAAO,QAAA,CAAW,CAAA,CAAA,GAAA,EAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,iBAAiB,CAAC,CAAA,CAAE,OAAA;AAAA,IACrD;AAAA,GACF;AAAA,EACA,QAAQ,QAAA,CAAW,CAAA,CAAA,GAAA,GAAM,WAAA,EAAa,EAAE,QAAA,EAAS;AAAA,EACjD,MAAA,EAAQ,cAAc,QAAA,EAAS;AAAA,EAC/B,KAAA,EAAO,gBAAgB,QAAA,EAAS;AAAA,EAChC,WAAA,EAAa,cAAc,QAAA,EAAS;AAAA,EACpC,MAAA,EAAQ,cAAc,QAAA;AACxB,CAAC,CAAA;AAEM,IAAM,mBAAqB,CAAA,CAAA,MAAA,CAAO;AAAA,EACvC,GAAA,EAAK,aAAA;AAAA,EACL,MAAA,EAAQ,cAAc,QAAA;AACxB,CAAC,CAAA;;;AC/BM,SAAS,iBAAiBJ,OAAAA,EAAuC;AACtE,EAAA,OAAO;AAAA,IACL,IAAIA,OAAAA,CAAO,EAAA;AAAA,IACX,QAAQA,OAAAA,CAAO,MAAA;AAAA,IACf,KAAKA,OAAAA,CAAO,GAAA;AAAA,IACZ,OAAOA,OAAAA,CAAO,KAAA;AAAA,IACd,UAAUA,OAAAA,CAAO,QAAA;AAAA,IACjB,aAAaA,OAAAA,CAAO,WAAA;AAAA,IACpB,MAAMA,OAAAA,CAAO,IAAA;AAAA,IACb,cAAcA,OAAAA,CAAO,YAAA;AAAA,IACrB,QAAQA,OAAAA,CAAO,MAAA;AAAA,IACf,SAAA,EAAWA,OAAAA,CAAO,SAAA,CAAU,WAAA;AAAY,GAC1C;AACF;;;ACQO,SAAS,wBAAwB,OAAA,EAGrC;AACD,EAAA,OAAO;AAAA;AAAA,IAEL,OAAA,EAAS,gBAAA;AAAA,MACP,UAAA,CAAW,MAAM,SAAS,CAAA;AAAA,MAC1B,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,iBAAA,EAAkB;AAAA,MAC1C,OAAO,GAAA,KAAuC;AAC5C,QAAA,MAAM;AAAA,UACJ,MAAA;AAAA,UACA,KAAA,GAAQ,qBAAA;AAAA,UACR,MAAA;AAAA,UACA,MAAA;AAAA,UACA,KAAA;AAAA,UACA,WAAA;AAAA,UACA;AAAA,SACF,GAAI,GAAA,CAAI,KAAA,IAAS,EAAC;AAElB,QAAA,MAAM,QAAQ,MAAM,OAAA,CAAQ,YAAA,CAAa,GAAA,CAAI,QAAQ,OAAA,EAAS;AAAA,UAC5D,SAAA,EAAW,MAAA;AAAA,UACX;AAAA,SACD,CAAA;AACD,QAAA,IAAI,KAAA,KAAU,IAAA,EAAM,MAAM,YAAA,EAAa;AAEvC,QAAA,MAAM,aAAa,KAAA,GAAQ,CAAA;AAC3B,QAAA,MAAM,CAAC,IAAA,EAAM,KAAK,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,UACtC,OAAA,CAAQ,QAAQ,WAAA,CAAY;AAAA,YAC1B,KAAA;AAAA,YACA,QAAQ,MAAA,IAAU,QAAA;AAAA,YAClB,KAAA,EAAO,UAAA;AAAA,YACP,MAAA;AAAA,YACA,MAAA;AAAA,YACA,KAAA;AAAA,YACA,WAAA;AAAA,YACA;AAAA,WACD,CAAA;AAAA,UACD,OAAA,CAAQ,OAAA,CAAQ,aAAA,CAAc,KAAK;AAAA,SACpC,CAAA;AAED,QAAA,MAAM,OAAA,GAAU,KAAK,MAAA,GAAS,KAAA;AAC9B,QAAA,MAAM,OAAO,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA,GAAI,IAAA;AAC9C,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,EAAA,CAAG,EAAE,CAAA;AACvB,QAAA,MAAM,UAAA,GACJ,WAAW,IAAA,GAAO,gBAAA,CAAiB,KAAK,SAAA,EAAW,IAAA,CAAK,EAAE,CAAA,GAAI,IAAA;AAEhE,QAAA,OAAO;AAAA,UACL,KAAA;AAAA,UACA,KAAA;AAAA,UACA,OAAA,EAAS,IAAA,CAAK,GAAA,CAAI,gBAAgB,CAAA;AAAA,UAClC;AAAA,SACF;AAAA,MACF;AAAA,KACF;AAAA,IACA,MAAA,EAAQ,gBAAA;AAAA,MACN,UAAA,CAAW,MAAM,QAAQ,CAAA;AAAA,MACzB,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,gBAAA,EAAiB;AAAA,MACzC,OAAO,GAAA,KAA6C;AAClD,QAAA,MAAM,QAAQ,MAAM,OAAA,CAAQ,YAAA,CAAa,GAAA,CAAI,QAAQ,OAAA,EAAS;AAAA,UAC5D,SAAA,EAAW,MAAA;AAAA,UACX,GAAA,EAAK,IAAI,KAAA,CAAM;AAAA,SAChB,CAAA;AACD,QAAA,IAAI,KAAA,KAAU,IAAA,EAAM,MAAM,YAAA,EAAa;AACvC,QAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,CAAQ,OAAA,CAAQ,cAAA,CAAe;AAAA,UACjD,KAAA;AAAA,UACA,GAAA,EAAK,IAAI,KAAA,CAAM,GAAA;AAAA,UACf,MAAA,EAAQ,IAAI,KAAA,CAAM;AAAA,SACnB,CAAA;AACD,QAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,MAAA,KAAW,SAAA,QAAiB,QAAA,EAAS;AACzD,QAAA,OAAO,EAAE,MAAA,EAAQ,gBAAA,CAAiB,KAAK,CAAA,EAAE;AAAA,MAC3C;AAAA;AACF,GACF;AACF;;;AC9FO,SAAS,qBAAqB,OAAA,EAAuC;AAC1E,EAAA,MAAM,KAAA,uBAAY,OAAA,EAAyD;AAC3E,EAAA,OAAO,CAAC,SAAkB,OAAA,KAA0B;AAClD,IAAA,IAAI,SAAA,GAAY,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AACjC,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,SAAA,uBAAgB,GAAA,EAAI;AACpB,MAAA,KAAA,CAAM,GAAA,CAAI,SAAS,SAAS,CAAA;AAAA,IAC9B;AACA,IAAA,MAAM,EAAA,GAAK,KAAK,SAAA,CAAU;AAAA,MACxB,OAAA,CAAQ,SAAA;AAAA,MACR,QAAQ,KAAA,IAAS,IAAA;AAAA,MACjB,QAAQ,GAAA,IAAO;AAAA,KAChB,CAAA;AACD,IAAA,IAAI,KAAA,GAAQ,SAAA,CAAU,GAAA,CAAI,EAAE,CAAA;AAC5B,IAAA,IAAI,UAAU,MAAA,EAAW;AACvB,MAAA,KAAA,GAAQ,OAAA,CAAQ,SAAS,OAAO,CAAA;AAChC,MAAA,SAAA,CAAU,GAAA,CAAI,IAAI,KAAK,CAAA;AAAA,IACzB;AACA,IAAA,OAAO,KAAA;AAAA,EACT,CAAA;AACF;;;ACbA,IAAM,sBAAA,GAAyB,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,GAAA;AAkBvC,SAAS,6BACd,OAAA,EAKA;AACA,EAAA,MAAM,OAAA,GAAU,YAAA,CAAa,OAAA,CAAQ,MAAM,CAAA;AAC3C,EAAA,MAAM,YAAA,GAAe,QAAQ,YAAA,IAAgB,sBAAA;AAC7C,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,MAAA;AACzC,EAAA,MAAM,YAAA,GAAe,oBAAA,CAAqB,OAAA,CAAQ,YAAY,CAAA;AAE9D,EAAA,eAAe,YAAA,CACb,SACA,OAAA,EACiB;AACjB,IAAA,MAAM,KAAA,GAAQ,MAAM,YAAA,CAAa,OAAA,EAAS,OAAO,CAAA;AACjD,IAAA,IAAI,KAAA,KAAU,IAAA,EAAM,MAAM,YAAA,EAAa;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,SAAS,YAAY,OAAA,EAKD;AAClB,IAAA,OAAO,YAAA,CAAa,QAAQ,OAAA,EAAS;AAAA,MACnC,SAAA,EAAW,QAAA;AAAA,MACX,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAEA,EAAA,eAAe,kBAAkB,OAAA,EAMf;AAChB,IAAA,MAAM,KAAA,GAAQ,MAAM,WAAA,CAAY,OAAO,CAAA;AACvC,IAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,IAAA,CAAK;AAAA,MAClC,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAK,OAAA,CAAQ;AAAA,KACd,CAAA;AACD,IAAA,IAAI,YAAY,QAAA,CAAS,MAAA,KAAW,SAAA,IAAa,QAAA,CAAS,UAAU,KAAA,EAAO;AACzE,MAAA,MAAM,UAAU,8BAA8B,CAAA;AAAA,IAChD;AAAA,EACF;AAEA,EAAA,eAAe,aAAa,OAAA,EAWV;AAChB,IAAA,MAAM,KAAA,GAAQ,MAAM,WAAA,CAAY,OAAO,CAAA;AACvC,IAAA,IAAI,OAAA,CAAQ,YAAY,WAAA,EAAa;AACnC,MAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,IAAA,CAAK;AAAA,QAClC,QAAQ,OAAA,CAAQ,MAAA;AAAA,QAChB,KAAK,OAAA,CAAQ;AAAA,OACd,CAAA;AACD,MAAA,IAAI,QAAA,EAAU,MAAA,KAAW,QAAA,IAAY,QAAA,CAAS,UAAU,KAAA,EAAO;AAC7D,QAAA;AAAA,MACF;AAAA,IACF;AACA,IAAA,MAAM,QAAQ,aAAA,CAAc;AAAA,MAC1B,KAAA;AAAA,MACA,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,WAAA,EAAa,OAAA,CAAQ,IAAA,CAAK,IAAA,IAAQ,IAAA;AAAA,MAClC,YAAA,EAAc,OAAA,CAAQ,IAAA,CAAK,IAAA,IAAQ,IAAA;AAAA,MACnC,QAAA,EAAU,QAAQ,QAAA,IAAY,IAAA;AAAA,MAC9B,GAAA,EAAK,QAAQ,GAAA,IAAO,IAAA;AAAA,MACpB,QAAA,EAAU,QAAQ,IAAA,CAAK,IAAA;AAAA,MACvB,QAAA,EAAU,QAAQ,QAAA,IAAY,IAAA;AAAA,MAC9B,WAAW,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,KAAQ,YAAY;AAAA,KAC9C,CAAA;AAAA,EACH;AAEA,EAAA,eAAe,eAAe,OAAA,EASZ;AAChB,IAAA,MAAM,QAAQ,UAAA,CAAW;AAAA,MACvB,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,MAAM,OAAA,CAAQ,aAAA;AAAA,MACd,IAAA,EAAM,QAAQ,IAAA,IAAQ,IAAA;AAAA,MACtB,aAAa,OAAA,CAAQ,WAAA;AAAA,MACrB,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,UAAU,OAAA,CAAQ;AAAA,KACnB,CAAA;AAAA,EACH;AAGA,EAAA,eAAe,sBAAsB,OAAA,EAInB;AAChB,IAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,IAAA,CAAK;AAAA,MAC7B,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAK,OAAA,CAAQ;AAAA,KACd,CAAA;AACD,IAAA,IAAI,GAAA,EAAK,MAAA,KAAW,SAAA,IAAa,CAAC,IAAI,QAAA,EAAU;AAChD,IAAA,MAAM,EAAA,GAAK,OAAA,CAAQ,QAAA,GAAW,OAAA,CAAQ,KAAK,CAAA;AAC3C,IAAA,IAAI,CAAC,EAAA,EAAI;AACT,IAAA,IAAI;AACF,MAAA,MAAM,EAAA,CAAG,IAAA;AAAA,QACP,IAAI,2BAAA,CAA4B;AAAA,UAC9B,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,KAAK,OAAA,CAAQ,GAAA;AAAA,UACb,UAAU,GAAA,CAAI;AAAA,SACf;AAAA,OACH;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAEA,EAAA,MAAM,YAAA,GAAe,EAAE,MAAA,EAAQ,OAAA,EAAS,YAAA,EAAa;AACrD,EAAA,MAAM,qBAAqB,uBAAA,CAAwB;AAAA,IACjD,GAAG,YAAA;AAAA,IACH,SAAA,EAAW,SAAA;AAAA,IACX,aAAA,EAAe;AAAA,GAChB,CAAA;AACD,EAAA,MAAM,0BAA0B,uBAAA,CAAwB;AAAA,IACtD,GAAG,YAAA;AAAA,IACH,SAAA,EAAW,SAAA;AAAA,IACX,aAAA,EAAe;AAAA,GAChB,CAAA;AACD,EAAA,MAAM,wBAAwB,uBAAA,CAAwB;AAAA,IACpD,GAAG,YAAA;AAAA,IACH,SAAA,EAAW,WAAA;AAAA,IACX,aAAA,EAAe,SAAA;AAAA,IACf,eAAA,EAAiB;AAAA,GAClB,CAAA;AACD,EAAA,MAAM,oBAAoB,uBAAA,CAAwB;AAAA,IAChD,GAAG,YAAA;AAAA,IACH,SAAA,EAAW,UAAA;AAAA,IACX,aAAA,EAAe;AAAA,GAChB,CAAA;AACD,EAAA,MAAM,yBAAyB,uBAAA,CAAwB;AAAA,IACrD,GAAG,YAAA;AAAA,IACH,SAAA,EAAW,QAAA;AAAA,IACX,aAAA,EAAe;AAAA,GAChB,CAAA;AAED,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA,YAAA;AAAA,IACA,KAAA,EAAO;AAAA,MACL,MAAA,EAAQ;AAAA,QACN,KAAA,EAAO,iBAAA;AAAA,QACP,WAAA,EAAa,YAAA;AAAA,QACb,YAAA,EAAc,OAAO,OAAA,KAAY;AAC/B,UAAA,IAAI,OAAA,CAAQ,YAAY,WAAA,EAAa;AACnC,YAAA,MAAM,wBAAwB,OAAO,CAAA;AACrC,YAAA;AAAA,UACF;AACA,UAAA,MAAM,mBAAmB,OAAO,CAAA;AAAA,QAClC,CAAA;AAAA,QACA,WAAA,EAAa,cAAA;AAAA,QACb,SAAA,EAAW;AAAA,UACT,MAAA,EAAQ,YAAA;AAAA,UACR,KAAA,EAAO,qBAAA;AAAA,UACP,OAAA,EAAS,OAAO,OAAA,KAAY;AAC1B,YAAA,MAAM,QAAQ,aAAA,CAAc;AAAA,cAC1B,QAAQ,OAAA,CAAQ,MAAA;AAAA,cAChB,KAAK,OAAA,CAAQ,GAAA;AAAA,cACb,UAAU,OAAA,CAAQ;AAAA,aACnB,CAAA;AAAA,UACH;AAAA;AACF,OACF;AAAA,MACA,QAAA,EAAU;AAAA,QACR,KAAA,EAAO;AAAA,OACT;AAAA,MACA,MAAA,EAAQ;AAAA,QACN,KAAA,EAAO,sBAAA;AAAA,QACP,SAAA,EAAW,OAAO,OAAA,KAAY;AAC5B,UAAA,IAAI,CAAC,OAAA,CAAQ,OAAA,EAAS,MAAM,sBAAsB,OAAO,CAAA;AACzD,UAAA,MAAM,MAAM,EAAE,MAAA,EAAQ,QAAQ,MAAA,EAAQ,GAAA,EAAK,QAAQ,GAAA,EAAI;AACvD,UAAA,IAAI,UAAA,KAAe,MAAA,EAAQ,MAAM,OAAA,CAAQ,WAAW,GAAG,CAAA;AAAA,eAClD,MAAM,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA;AAAA,QACnC;AAAA;AACF;AACF,GACF;AACF;;;AC1JO,SAAS,GAAG,OAAA,EAA0B;AAC3C,EAAA,IAAI,MAAA;AACJ,EAAA,MAAM,QAAA,GAAW,CAAC,KAAA,KAChB,MAAA,EAAQ,OAAO,KAAK,CAAA,EAAG,UAAU,MAAA,EAAQ,MAAA;AAC3C,EAAA,MAAM,EAAE,OAAA,EAAS,KAAA,EAAO,YAAA,KAAiB,4BAAA,CAA6B;AAAA,IACpE,GAAG,OAAA;AAAA,IACH;AAAA,GACD,CAAA;AACD,EAAA,IAAI,OAAA,CAAQ,KAAA,IAAS,KAAA,CAAM,MAAA,EAAQ;AACjC,IAAA,MAAM,aAAa,gBAAA,CAAiB;AAAA,MAClC,MAAA,EAAQ,OAAA;AAAA,MACR,YAAA;AAAA,MACA,QAAA,EAAU,QAAQ,KAAA,CAAM,QAAA;AAAA,MACxB,QAAA,EAAU,QAAQ,KAAA,CAAM;AAAA,KACzB,CAAA;AACD,IAAA,KAAA,CAAM,OAAO,KAAA,GAAQ,UAAA,CAAW,KAAA,CAAM,MAAA,CAAO,OAAO,UAAU,CAAA;AAAA,EAChE;AAEA,EAAA,OAAO,YAAA,CAAa;AAAA,IAClB,EAAA,EAAI,IAAA;AAAA,IACJ,KAAK,GAAA,EAAK;AACR,MAAA,MAAA,GAAS,GAAA,CAAI,MAAA;AACb,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,OAAO,MAAM,CAAA;AAC9C,MAAA,MAAM,eAAe,MAAA,CAAO,IAAA;AAAA,QAC1B,CAAC,CAAA,KACC,WAAA,CAAY,CAAA,CAAE,MAAM,CAAA,IACpB,WAAA,CAAY,CAAA,CAAE,QAAQ,CAAA,IACtB,WAAA,CAAY,CAAA,CAAE,MAAM;AAAA,OACxB;AACA,MAAA,IAAI,CAAC,YAAA,EAAc;AACjB,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SACF;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IACA,KAAA;AAAA,IACA,SAAA,EAAW,uBAAA,CAAwB,EAAE,OAAA,EAAS,cAAc,CAAA;AAAA,IAC5D,OAAA,EAAS;AAAA,MACP,OAAA;AAAA,MACA,QAAQ,OAAA,CAAQ;AAAA;AAClB,GACD,CAAA;AACH;AClHA,IAAM,qBAAA,GAAwB,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,GAAA;AA0B7C,eAAe,cAAA,CACb,IACA,OAAA,EACe;AACf,EAAA,KAAA,MAAWA,WAAU,OAAA,EAAS;AAC5B,IAAA,IAAIA,QAAO,QAAA,EAAU;AACnB,MAAA,IAAI;AACF,QAAA,MAAM,EAAA,CAAG,IAAA;AAAA,UACP,IAAIK,2BAAAA,CAA4B;AAAA,YAC9B,QAAQL,OAAAA,CAAO,MAAA;AAAA,YACf,KAAKA,OAAAA,CAAO,GAAA;AAAA,YACZ,UAAUA,OAAAA,CAAO;AAAA,WAClB;AAAA,SACH;AAAA,MACF,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,MAAM,EAAA,CAAG,IAAA;AAAA,QACP,IAAI,mBAAA,CAAoB;AAAA,UACtB,QAAQA,OAAAA,CAAO,MAAA;AAAA,UACf,KAAKA,OAAAA,CAAO;AAAA,SACb;AAAA,OACH;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACF;AAMA,eAAsB,yBACpB,OAAA,EACkC;AAClC,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,OAAA,CAAQ,MAAM,CAAA;AACzC,EAAA,MAAM,YAAY,IAAI,IAAA;AAAA,IACpB,IAAA,CAAK,GAAA,EAAI,IAAK,OAAA,CAAQ,WAAA,IAAe,qBAAA;AAAA,GACvC;AAEA,EAAA,MAAM,QAAQ,MAAM,KAAA,CAAM,gBAAA,CAAiB,EAAE,WAAW,CAAA;AACxD,EAAA,IAAI,MAAM,MAAA,KAAW,CAAA,SAAU,EAAE,MAAA,EAAQ,EAAC,EAAE;AAE5C,EAAA,IAAI,QAAQ,EAAA,EAAI,MAAM,cAAA,CAAe,OAAA,CAAQ,IAAI,KAAK,CAAA;AACtD,EAAA,MAAM,OAAA,CAAQ,gBAAgB,KAAK,CAAA;AACnC,EAAA,MAAM,KAAA,CAAM,YAAY,KAAA,CAAM,GAAA,CAAI,CAACA,OAAAA,KAAWA,OAAAA,CAAO,EAAE,CAAC,CAAA;AAExD,EAAA,OAAO,EAAE,QAAQ,KAAA,EAAM;AACzB","file":"index.js","sourcesContent":["import { column, idColumn, schema, table } from \"fumadb/schema\";\n\n/**\n * Single-table object lifecycle:\n * pending (presign) → active (HeadObject confirmed) → deleted (soft)\n *\n * Cron: delete stale pending rows (AbortMultipartUpload if uploadId set).\n * Ownership is expressed via `scope` (e.g. `user:…` / `org:…`).\n *\n * FumaDB only emits the `(bucket, key)` unique constraint. Secondary indexes\n * for listByScope / getScopeUsage / findStalePending are consumer-side after\n * CLI generate — see `./examples/` (Drizzle + Prisma) and README\n * \"Recommended indexes\".\n */\nconst storageObject = table(\"storage_object\", {\n id: idColumn(\"id\", \"varchar(255)\").defaultTo$(\"auto\"),\n scope: column(\"scope\", \"string\"),\n bucket: column(\"bucket\", \"string\"),\n key: column(\"key\", \"string\"),\n /** Named dimah-s3 route that created the object. */\n route: column(\"route\", \"string\"),\n contentType: column(\"content_type\", \"string\").nullable(),\n /** Verified size from HeadObject after confirm. */\n size: column(\"size\", \"bigint\").nullable(),\n eTag: column(\"e_tag\", \"string\").nullable(),\n filename: column(\"filename\", \"string\").nullable(),\n status: column(\"status\", \"string\"),\n /** App-specific labels, visibility, publicUrl, etc. */\n metadata: column(\"metadata\", \"json\").nullable(),\n acl: column(\"acl\", \"string\").nullable(),\n /** Multipart upload ID while status = pending. */\n uploadId: column(\"upload_id\", \"string\").nullable(),\n /** Client-declared size before confirm (quota reservation). */\n declaredSize: column(\"declared_size\", \"bigint\").nullable(),\n confirmedAt: column(\"confirmed_at\", \"timestamp\").nullable(),\n /** Pending TTL or temporary object expiry. */\n expiresAt: column(\"expires_at\", \"timestamp\").nullable(),\n createdAt: column(\"created_at\", \"timestamp\").defaultTo$(\"now\"),\n updatedAt: column(\"updated_at\", \"timestamp\").defaultTo$(\"now\"),\n deletedAt: column(\"deleted_at\", \"timestamp\").nullable(),\n}).unique(\"storage_object_bucket_key_uk\", [\"bucket\", \"key\"]);\n\nexport const v1 = schema({\n version: \"1.0.0\",\n tables: {\n storageObject,\n },\n});\n\nexport type { StorageObjectStatus } from \"@/types/storage-object\";\n","import { fumadb } from \"fumadb\";\nimport { v1 } from \"./schema/v1\";\n\nexport const DimahS3DB = fumadb({\n namespace: \"dimah_s3\",\n schemas: [v1],\n});\n\nexport { v1 };\n","import { APIError, S3_ERROR_CODES } from \"@dimah-s3/core\";\n\nexport function unauthorized(\n message: string = S3_ERROR_CODES.UNAUTHORIZED.message,\n): APIError {\n return APIError.from(\"UNAUTHORIZED\", {\n ...S3_ERROR_CODES.UNAUTHORIZED,\n message,\n });\n}\n\nexport function forbidden(\n message: string = S3_ERROR_CODES.FORBIDDEN.message,\n): APIError {\n return APIError.from(\"FORBIDDEN\", {\n ...S3_ERROR_CODES.FORBIDDEN,\n message,\n });\n}\n\nexport function notFound(\n message: string = S3_ERROR_CODES.OBJECT_NOT_FOUND.message,\n): APIError {\n return APIError.from(\"NOT_FOUND\", {\n ...S3_ERROR_CODES.OBJECT_NOT_FOUND,\n message,\n });\n}\n\nexport function conflict(\n message: string = S3_ERROR_CODES.CONFLICT.message,\n): APIError {\n return APIError.from(\"CONFLICT\", {\n ...S3_ERROR_CODES.CONFLICT,\n message,\n });\n}\n","import type {\n StorageObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\n\n/** Raw `storage_object` row as returned by the FumaDB ORM. */\nexport type StorageObjectRow = {\n id: string;\n scope: string;\n bucket: string;\n key: string;\n route: string;\n contentType: string | null;\n size: bigint | null;\n eTag: string | null;\n filename: string | null;\n status: string;\n metadata: unknown;\n acl: string | null;\n uploadId: string | null;\n declaredSize: bigint | null;\n confirmedAt: Date | null;\n expiresAt: Date | null;\n createdAt: Date;\n updatedAt: Date;\n deletedAt: Date | null;\n};\n\nfunction toNumber(value: bigint | number | null): number | null {\n if (value === null) return null;\n return typeof value === \"bigint\" ? Number(value) : value;\n}\n\n/** Normalize a raw row: bigint → number, status narrowing, metadata cast. */\nexport function mapStorageObjectRow(row: StorageObjectRow): StorageObject {\n return {\n id: row.id,\n scope: row.scope,\n bucket: row.bucket,\n key: row.key,\n route: row.route,\n contentType: row.contentType,\n size: toNumber(row.size),\n eTag: row.eTag,\n filename: row.filename,\n status: row.status as StorageObjectStatus,\n metadata: (row.metadata ?? null) as Record<string, unknown> | null,\n acl: row.acl,\n uploadId: row.uploadId,\n declaredSize: toNumber(row.declaredSize),\n confirmedAt: row.confirmedAt,\n expiresAt: row.expiresAt,\n createdAt: row.createdAt,\n updatedAt: row.updatedAt,\n deletedAt: row.deletedAt,\n };\n}\n","export function encodeListCursor(createdAt: Date, id: string): string {\n return Buffer.from(`${createdAt.toISOString()}\\t${id}`, \"utf8\").toString(\n \"base64url\",\n );\n}\n\nexport function decodeListCursor(\n cursor: string,\n): { createdAt: Date; id: string } | null {\n try {\n const raw = Buffer.from(cursor, \"base64url\").toString(\"utf8\");\n const sep = raw.indexOf(\"\\t\");\n if (sep < 1) return null;\n const createdAt = new Date(raw.slice(0, sep));\n const id = raw.slice(sep + 1);\n if (!id || Number.isNaN(createdAt.getTime())) return null;\n return { createdAt, id };\n } catch {\n return null;\n }\n}\n","import type { InferFumaDB } from \"fumadb\";\nimport type { DimahS3DB } from \"@/fuma-db\";\nimport { conflict, notFound } from \"@/errors\";\nimport type {\n StorageObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\nimport { mapStorageObjectRow } from \"./map-row\";\nimport { decodeListCursor } from \"./list-cursor\";\n\n/** FumaDB uses `false` as a type-level sentinel for invalid operators. */\nfunction condition<T>(value: T): Exclude<T, boolean> {\n if (typeof value === \"boolean\") {\n throw new TypeError(\"[dimah-s3/db] invalid query condition\");\n }\n return value as Exclude<T, boolean>;\n}\n\n/** FumaDB client for the @dimah-s3/db schema. */\nexport type DimahS3DbClient = InferFumaDB<typeof DimahS3DB>;\n\n/** Identifies one object row — `(bucket, key)` is unique. */\nexport type ObjectRef = {\n bucket: string;\n key: string;\n};\n\nexport type UpsertPendingInput = ObjectRef & {\n scope: string;\n route: string;\n contentType?: string | null;\n /** Client-declared size in bytes (quota reservation — not verified). */\n declaredSize?: number | null;\n metadata?: Record<string, unknown> | null;\n acl?: string | null;\n filename?: string | null;\n /** Multipart upload ID, when the pending upload is multipart. */\n uploadId?: string | null;\n /** Pending TTL — stale rows past this are eligible for purge. */\n expiresAt?: Date | null;\n};\n\nexport type MarkActiveInput = ObjectRef & {\n /** Verified size in bytes (from HeadObject). */\n size: number;\n eTag?: string | null;\n contentType?: string | null;\n acl?: string | null;\n filename?: string | null;\n metadata?: Record<string, unknown> | null;\n};\n\nexport type ListByScopeInput = {\n scope: string;\n /**\n * Filter by exact status. When omitted, only `active` rows are returned.\n */\n status?: StorageObjectStatus;\n route?: string;\n contentType?: string;\n /** Key prefix. Applied in the query (`starts with`), so pages stay full. */\n prefix?: string;\n limit?: number;\n offset?: number;\n cursor?: string;\n};\n\nexport type ScopeUsage = {\n /** Sum of verified size (fallback: declared size) of non-deleted rows. */\n totalBytes: number;\n /** Non-deleted row count. */\n objectCount: number;\n};\n\n/**\n * Minimal multipart resume payload — structurally matches\n * `@dimah-s3/react` `StoredUpload` so a custom client `UploadStore` can\n * return it from `get()` without importing react types.\n */\nexport type PendingMultipartResume = {\n uploadId: string;\n key: string;\n /** Declared file size in bytes (must match the File being resumed). */\n fileSize: number;\n bucket: string;\n};\n\nexport type FindPendingMultipartInput = ObjectRef & {\n /** Must equal the pending row's `declaredSize`. */\n fileSize: number;\n};\n\n/**\n * Map a `storage_object` row to a client resume payload.\n * Returns `null` unless the row is `pending` with `uploadId` and `declaredSize`.\n */\nexport function toPendingMultipartResume(\n object: StorageObject,\n): PendingMultipartResume | null {\n if (\n object.status !== \"pending\" ||\n object.uploadId == null ||\n object.declaredSize == null\n ) {\n return null;\n }\n return {\n uploadId: object.uploadId,\n key: object.key,\n fileSize: object.declaredSize,\n bucket: object.bucket,\n };\n}\n\n/** Data-access layer for the `storage_object` table. */\nexport type StorageObjectStore = {\n /**\n * Insert or reset a row to `pending` (presign / multipart init).\n * Returns the written row.\n */\n upsertPending: (input: UpsertPendingInput) => Promise<StorageObject>;\n /**\n * Promote a pending row to `active` with verified fields (confirm / complete).\n * Also refreshes an already-active row (overwrite). Returns the active row.\n */\n markActive: (input: MarkActiveInput) => Promise<StorageObject>;\n /** Load one row by `bucket` + `key` (any status). */\n find: (ref: ObjectRef) => Promise<StorageObject | null>;\n /** Load one row by scope + key (any status). */\n findByScopeKey: (input: {\n scope: string;\n key: string;\n bucket?: string;\n }) => Promise<StorageObject | null>;\n /** Load one row — only when `status` is `active`. */\n findActive: (ref: ObjectRef) => Promise<StorageObject | null>;\n /**\n * Pending multipart row for resume: `pending` + `uploadId` + matching\n * `declaredSize`. Returns the full row so callers can enforce scope.\n */\n findPendingMultipart: (\n input: FindPendingMultipartInput,\n ) => Promise<StorageObject | null>;\n /**\n * List rows for a scope (pass `scope` explicitly — admin routes, jobs, etc.).\n * Defaults to `active`. Server-side listing; browser apps use\n * `api.db.listObjects` instead (scope from `resolveScope`, no HTTP from server code).\n */\n listByScope: (input: ListByScopeInput) => Promise<StorageObject[]>;\n /** Total bytes and row count for a scope — quota checks (`pending` uses `declaredSize`). */\n getScopeUsage: (scope: string) => Promise<ScopeUsage>;\n /** Row count for a scope; optional `status` filter (same defaults as `listByScope`). */\n countByScope: (\n scope: string,\n status?: StorageObjectStatus,\n ) => Promise<number>;\n /**\n * Mark a row `deleted` (keeps the record). DB-only — does not delete from S3.\n * Not a substitute for `api.delete`; the plugin calls this from `onDeleted`\n * when `deleteMode` is `\"soft\"`.\n */\n softDelete: (ref: ObjectRef) => Promise<void>;\n /**\n * Remove the row entirely. DB-only — does not delete from S3.\n * Not a substitute for `api.delete`; used by the plugin when `deleteMode` is\n * `\"hard\"`, or by admin jobs to prune soft-deleted audit rows.\n */\n hardDelete: (ref: ObjectRef) => Promise<void>;\n /** Remove a `pending` row (multipart abort path). Optional `uploadId` must match. */\n deletePending: (ref: ObjectRef & { uploadId?: string }) => Promise<void>;\n /** Pending rows past `expiresAt`, or with no TTL and `createdAt` before `olderThan`. */\n findStalePending: (input: { olderThan: Date }) => Promise<StorageObject[]>;\n /** Delete rows by ID (used by the purge job after `findStalePending`). */\n deleteByIds: (ids: string[]) => Promise<void>;\n};\n\nfunction toBigInt(value: number | null | undefined): bigint | null {\n return value === null || value === undefined\n ? null\n : BigInt(Math.trunc(value));\n}\n\nfunction confirmedFields(input: MarkActiveInput, now: Date) {\n return {\n size: toBigInt(input.size),\n eTag: input.eTag ?? null,\n ...(input.contentType !== undefined && {\n contentType: input.contentType,\n }),\n ...(input.acl !== undefined && { acl: input.acl }),\n ...(input.filename !== undefined && { filename: input.filename }),\n ...(input.metadata !== undefined && { metadata: input.metadata }),\n uploadId: null,\n declaredSize: null,\n expiresAt: null,\n confirmedAt: now,\n updatedAt: now,\n };\n}\n\nfunction toActiveObject(\n existing: StorageObject,\n input: MarkActiveInput,\n now: Date,\n): StorageObject {\n return {\n ...existing,\n status: \"active\",\n size: input.size,\n eTag: input.eTag ?? null,\n contentType:\n input.contentType !== undefined\n ? input.contentType\n : existing.contentType,\n acl: input.acl !== undefined ? input.acl : existing.acl,\n filename: input.filename !== undefined ? input.filename : existing.filename,\n metadata: input.metadata !== undefined ? input.metadata : existing.metadata,\n uploadId: null,\n declaredSize: null,\n expiresAt: null,\n confirmedAt: now,\n updatedAt: now,\n deletedAt: null,\n };\n}\n\n/** Create a store bound to schema v1 (`db.orm(\"1.0.0\")`). */\nexport function createStorageObjectStore(\n db: DimahS3DbClient,\n): StorageObjectStore {\n const orm = db.orm(\"1.0.0\");\n\n const store: StorageObjectStore = {\n async upsertPending(input) {\n const now = new Date();\n const pendingFields = {\n scope: input.scope,\n route: input.route,\n contentType: input.contentType ?? null,\n declaredSize: toBigInt(input.declaredSize),\n metadata: input.metadata ?? null,\n acl: input.acl ?? null,\n filename: input.filename ?? null,\n uploadId: input.uploadId ?? null,\n expiresAt: input.expiresAt ?? null,\n status: \"pending\" as const,\n size: null,\n eTag: null,\n confirmedAt: null,\n deletedAt: null,\n };\n const row = await orm\n .upsert(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", input.bucket), b(\"key\", \"=\", input.key)),\n update: { ...pendingFields, updatedAt: now },\n create: {\n ...pendingFields,\n bucket: input.bucket,\n key: input.key,\n updatedAt: now,\n },\n })\n .forceReturning();\n return mapStorageObjectRow(row);\n },\n\n async markActive(input) {\n const existing = await store.find(input);\n if (!existing || existing.status === \"deleted\") {\n throw notFound(\"No pending object to confirm\");\n }\n const now = new Date();\n const fields = confirmedFields(input, now);\n if (existing.status === \"active\") {\n await orm.updateMany(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", input.bucket),\n b(\"key\", \"=\", input.key),\n b(\"status\", \"=\", \"active\"),\n ),\n set: fields,\n });\n return toActiveObject(existing, input, now);\n }\n if (existing.status !== \"pending\") {\n throw conflict(\"Object is not pending confirmation\");\n }\n await orm.updateMany(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", input.bucket),\n b(\"key\", \"=\", input.key),\n b(\"status\", \"=\", \"pending\"),\n ),\n set: {\n status: \"active\" as const,\n ...fields,\n deletedAt: null,\n },\n });\n return toActiveObject(existing, input, now);\n },\n\n async find(ref) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", ref.bucket), b(\"key\", \"=\", ref.key)),\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async findByScopeKey(input) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) => {\n const parts = [\n b(\"scope\", \"=\", input.scope),\n b(\"key\", \"=\", input.key),\n ];\n if (input.bucket) {\n parts.push(b(\"bucket\", \"=\", input.bucket));\n }\n return b.and(...parts);\n },\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async findActive(ref) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", ref.bucket),\n b(\"key\", \"=\", ref.key),\n b(\"status\", \"=\", \"active\"),\n ),\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async findPendingMultipart(input) {\n const row = await orm.findFirst(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"bucket\", \"=\", input.bucket),\n b(\"key\", \"=\", input.key),\n b(\"status\", \"=\", \"pending\"),\n b.isNotNull(\"uploadId\"),\n b(\"declaredSize\", \"=\", BigInt(Math.trunc(input.fileSize))),\n ),\n });\n return row ? mapStorageObjectRow(row) : null;\n },\n\n async listByScope(input) {\n const status = input.status ?? \"active\";\n const parsed = input.cursor ? decodeListCursor(input.cursor) : null;\n const rows = await orm.findMany(\"storageObject\", {\n where: (b) => {\n const parts = [\n b(\"scope\", \"=\", input.scope),\n b(\"status\", \"=\", status),\n ];\n if (input.route) parts.push(b(\"route\", \"=\", input.route));\n if (input.contentType) {\n parts.push(b(\"contentType\", \"=\", input.contentType));\n }\n if (input.prefix) {\n parts.push(b(\"key\", \"starts with\", input.prefix));\n }\n if (parsed) {\n parts.push(\n condition(\n b.or(\n condition(b(\"createdAt\", \"<\", parsed.createdAt)),\n condition(\n b.and(\n b(\"createdAt\", \"=\", parsed.createdAt),\n b(\"id\", \"<\", parsed.id),\n ),\n ),\n ),\n ),\n );\n }\n return b.and(...parts);\n },\n orderBy: [\"createdAt\", \"desc\"],\n limit: input.limit,\n offset: parsed ? undefined : input.offset,\n });\n return rows.map(mapStorageObjectRow);\n },\n\n async getScopeUsage(scope) {\n const rows = await orm.findMany(\"storageObject\", {\n select: [\"size\", \"declaredSize\"],\n where: (b) =>\n b.and(b(\"scope\", \"=\", scope), b(\"status\", \"!=\", \"deleted\")),\n });\n let totalBytes = 0;\n for (const row of rows) {\n totalBytes += Number(row.size ?? row.declaredSize ?? 0n);\n }\n return { totalBytes, objectCount: rows.length };\n },\n\n async countByScope(scope, status = \"active\") {\n return orm.count(\"storageObject\", {\n where: (b) => b.and(b(\"scope\", \"=\", scope), b(\"status\", \"=\", status)),\n });\n },\n\n async softDelete(ref) {\n const now = new Date();\n await orm.updateMany(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", ref.bucket), b(\"key\", \"=\", ref.key)),\n set: { status: \"deleted\", deletedAt: now, updatedAt: now },\n });\n },\n\n async hardDelete(ref) {\n await orm.deleteMany(\"storageObject\", {\n where: (b) =>\n b.and(b(\"bucket\", \"=\", ref.bucket), b(\"key\", \"=\", ref.key)),\n });\n },\n\n async deletePending(ref) {\n await orm.deleteMany(\"storageObject\", {\n where: (b) => {\n if (ref.uploadId != null) {\n return b.and(\n b(\"bucket\", \"=\", ref.bucket),\n b(\"key\", \"=\", ref.key),\n b(\"status\", \"=\", \"pending\"),\n b(\"uploadId\", \"=\", ref.uploadId),\n );\n }\n return b.and(\n b(\"bucket\", \"=\", ref.bucket),\n b(\"key\", \"=\", ref.key),\n b(\"status\", \"=\", \"pending\"),\n );\n },\n });\n },\n\n async findStalePending({ olderThan }) {\n const now = new Date();\n const rows = await orm.findMany(\"storageObject\", {\n where: (b) =>\n b.and(\n b(\"status\", \"=\", \"pending\"),\n b.or(\n b(\"expiresAt\", \"<\", now),\n condition(\n b.and(b.isNull(\"expiresAt\"), b(\"createdAt\", \"<\", olderThan)),\n ),\n ),\n ),\n orderBy: [\"createdAt\", \"asc\"],\n });\n return rows.map(mapStorageObjectRow);\n },\n\n async deleteByIds(ids) {\n if (ids.length === 0) return;\n await orm.deleteMany(\"storageObject\", {\n where: (b) => b(\"id\", \"in\", ids),\n });\n },\n };\n\n return store;\n}\n","import { forbidden, notFound, unauthorized } from \"@/errors\";\nimport {\n createStorageObjectStore,\n type DimahS3DbClient,\n type StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type {\n ScopeOperation,\n ScopeResolver,\n StorageObject,\n StorageObjectStatus,\n} from \"@/types/storage-object\";\n\n/** Minimal context the guard needs — matches every key-bearing server hook context. */\nexport type ObjectAccessGuardContext = {\n request: Request;\n key: string;\n bucket: string;\n /** Named route. Passed on to `resolveScope`. */\n route?: string;\n /** Multipart session id — required when {@link CreateObjectAccessGuardOptions.requireUploadId} is set. */\n uploadId?: string;\n};\n\nexport type CreateObjectAccessGuardOptions = {\n /** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt objects store. */\n client: DimahS3DbClient | StorageObjectStore;\n resolveScope: ScopeResolver;\n /**\n * The operation this guard protects, passed to `resolveScope`. Create one\n * guard per hook, such as `\"download\"` for `download.guard` and\n * `\"delete\"` for `delete.guard`.\n */\n operation: ScopeOperation;\n /**\n * Which rows count as accessible.\n * `\"any\"` means pending or active (not deleted).\n * @default \"active\"\n */\n requireStatus?: StorageObjectStatus | \"any\";\n /**\n * Require `context.uploadId` to match the pending row's `uploadId`.\n * Use for `upload.multipart.guard`.\n */\n requireUploadId?: boolean;\n /**\n * Replace the default `object.scope === scope` ownership check —\n * e.g. also allow objects whose metadata marks them public.\n */\n authorize?: (\n object: StorageObject,\n context: ObjectAccessGuardContext & { scope: string },\n ) => boolean | Promise<boolean>;\n};\n\nexport function resolveStore(\n client: DimahS3DbClient | StorageObjectStore,\n): StorageObjectStore {\n return \"upsertPending\" in client ? client : createStorageObjectStore(client);\n}\n\n/**\n * Guard that checks the requested object exists in the DB and belongs to the\n * caller's scope. Throws `APIError` (401 / 404 / 403) to reject.\n *\n * Usable as `download.guard`, `delete.guard`,\n * `upload.confirmGuard`, `upload.multipart.guard`, or in your own routes.\n */\nexport function createObjectAccessGuard(\n options: CreateObjectAccessGuardOptions,\n): (context: ObjectAccessGuardContext) => Promise<void> {\n const store = resolveStore(options.client);\n const requireStatus = options.requireStatus ?? \"active\";\n\n return async (context) => {\n const scope = await options.resolveScope(context.request, {\n operation: options.operation,\n route: context.route,\n key: context.key,\n });\n if (scope === null) throw unauthorized();\n\n const object = await store.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (!object || object.status === \"deleted\") throw notFound();\n\n const allowed = options.authorize\n ? await options.authorize(object, { ...context, scope })\n : object.scope === scope;\n if (!allowed) throw forbidden();\n\n const statusOk =\n requireStatus === \"any\" ? true : object.status === requireStatus;\n if (!statusOk) throw notFound();\n\n if (options.requireUploadId) {\n if (!context.uploadId || object.uploadId !== context.uploadId) {\n throw forbidden(\"Upload session does not match\");\n }\n }\n };\n}\n","import { APIError, S3_ERROR_CODES } from \"@dimah-s3/core\";\nimport { unauthorized } from \"@/errors\";\nimport { resolveStore } from \"@/hooks/create-object-access-guard\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { ScopeResolver } from \"@/types/storage-object\";\n\nexport type CreateQuotaGuardOptions = {\n client: DimahS3DbClient | StorageObjectStore;\n resolveScope: ScopeResolver;\n maxBytes?: number;\n maxFiles?: number;\n};\n\nexport type QuotaGuardContext = {\n request: Request;\n /** Named route. Passed on to `resolveScope`. */\n route?: string;\n /** Client extras from the presign body. Passed on to `resolveScope`. */\n clientMetadata?: Record<string, string>;\n file?: { size?: number };\n replace?: \"overwrite\";\n key?: string;\n bucket?: string;\n};\n\nfunction quotaExceeded(message: string) {\n return APIError.from(\"PAYLOAD_TOO_LARGE\", {\n ...S3_ERROR_CODES.QUOTA_EXCEEDED,\n message,\n });\n}\n\n/**\n * Reject uploads that would exceed scope usage.\n * Wire as `upload.guard` (after `db()` so ownership still runs), or pass\n * `quota` on {@link db}.\n */\nexport function createQuotaGuard(\n options: CreateQuotaGuardOptions,\n): (context: QuotaGuardContext) => Promise<void> {\n const objects = resolveStore(options.client);\n\n return async (context) => {\n const scope = await options.resolveScope(context.request, {\n operation: \"upload\",\n route: context.route,\n key: context.key,\n clientMetadata: context.clientMetadata,\n });\n if (scope === null) throw unauthorized();\n const usage = await objects.getScopeUsage(scope);\n const incoming = context.file?.size ?? 0;\n const replacing = context.replace === \"overwrite\";\n\n if (\n typeof options.maxFiles === \"number\" &&\n !replacing &&\n usage.objectCount >= options.maxFiles\n ) {\n throw quotaExceeded(\"File count quota exceeded\");\n }\n if (typeof options.maxBytes === \"number\") {\n let projected = usage.totalBytes + incoming;\n if (replacing && context.key && context.bucket) {\n const existing = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n const oldSize =\n existing && existing.status !== \"deleted\"\n ? (existing.size ?? existing.declaredSize ?? 0)\n : 0;\n projected = usage.totalBytes - oldSize + incoming;\n }\n if (projected > options.maxBytes) {\n throw quotaExceeded(\"Storage byte quota exceeded\");\n }\n }\n };\n}\n","import * as z from \"zod\";\nimport { routeNameSchema, trimmedString } from \"@dimah-s3/core\";\n\nexport const DB_LIST_DEFAULT_LIMIT = 50;\nexport const DB_LIST_MAX_LIMIT = 100;\n\n/**\n * Query-string integers arrive as strings; `s3.api` may pass numbers.\n * A codec stays compilable (`z.coerce` is not).\n */\nfunction queryInt(schema: z.ZodInt) {\n return z.codec(\n z.union([z.string().trim().regex(z.regexes.integer), schema]),\n schema,\n {\n decode: (value) =>\n typeof value === \"number\" ? value : Number.parseInt(value, 10),\n encode: (value) => value,\n },\n );\n}\n\nexport const dbListQuerySchema = z.object({\n status: z.enum([\"pending\", \"active\", \"deleted\"]).optional(),\n limit: queryInt(z.int().min(1).max(DB_LIST_MAX_LIMIT)).default(\n DB_LIST_DEFAULT_LIMIT,\n ),\n offset: queryInt(z.int().nonnegative()).optional(),\n cursor: trimmedString.optional(),\n route: routeNameSchema.optional(),\n contentType: trimmedString.optional(),\n prefix: trimmedString.optional(),\n});\n\nexport const dbGetQuerySchema = z.object({\n key: trimmedString,\n bucket: trimmedString.optional(),\n});\n","import type { DbClientObject, StorageObject } from \"@/types/storage-object\";\n\n/**\n * Map a full store row to the browser wire contract for `GET /db/objects`.\n * Drops server-only fields (`scope`, `eTag`, `metadata`, `acl`, …).\n */\nexport function toDbClientObject(object: StorageObject): DbClientObject {\n return {\n id: object.id,\n bucket: object.bucket,\n key: object.key,\n route: object.route,\n filename: object.filename,\n contentType: object.contentType,\n size: object.size,\n declaredSize: object.declaredSize,\n status: object.status,\n createdAt: object.createdAt.toISOString(),\n };\n}\n","import { pluginPath } from \"@dimah-s3/core\";\nimport { createS3Endpoint } from \"@dimah-s3/server\";\nimport { notFound, unauthorized } from \"@/errors\";\nimport type { StorageObjectStore } from \"@/store/storage-object-store\";\nimport { encodeListCursor } from \"@/store/list-cursor\";\nimport type {\n DbClientListResponse,\n DbClientObject,\n ScopeResolver,\n} from \"@/types/storage-object\";\nimport {\n dbGetQuerySchema,\n dbListQuerySchema,\n DB_LIST_DEFAULT_LIMIT,\n} from \"./list-query-schema\";\nimport { toDbClientObject } from \"./to-db-client-object\";\n\nexport {\n dbListQuerySchema,\n dbGetQuerySchema,\n DB_LIST_DEFAULT_LIMIT,\n DB_LIST_MAX_LIMIT,\n} from \"./list-query-schema\";\n\n/**\n * HTTP endpoints for the `db` plugin — `GET /db/objects` and `GET /db/object`.\n */\nexport function createDatabaseEndpoints(options: {\n objects: StorageObjectStore;\n resolveScope: ScopeResolver;\n}) {\n return {\n /** List objects + usage for the request scope (`resolveScope`). */\n objects: createS3Endpoint(\n pluginPath(\"db\", \"objects\"),\n { method: \"GET\", query: dbListQuerySchema },\n async (ctx): Promise<DbClientListResponse> => {\n const {\n status,\n limit = DB_LIST_DEFAULT_LIMIT,\n offset,\n cursor,\n route,\n contentType,\n prefix,\n } = ctx.query ?? {};\n\n const scope = await options.resolveScope(ctx.context.request, {\n operation: \"list\",\n route,\n });\n if (scope === null) throw unauthorized();\n\n const fetchLimit = limit + 1;\n const [rows, usage] = await Promise.all([\n options.objects.listByScope({\n scope,\n status: status ?? \"active\",\n limit: fetchLimit,\n offset,\n cursor,\n route,\n contentType,\n prefix,\n }),\n options.objects.getScopeUsage(scope),\n ]);\n\n const hasMore = rows.length > limit;\n const page = hasMore ? rows.slice(0, limit) : rows;\n const last = page.at(-1);\n const nextCursor =\n hasMore && last ? encodeListCursor(last.createdAt, last.id) : null;\n\n return {\n scope,\n usage,\n objects: page.map(toDbClientObject),\n nextCursor,\n };\n },\n ),\n object: createS3Endpoint(\n pluginPath(\"db\", \"object\"),\n { method: \"GET\", query: dbGetQuerySchema },\n async (ctx): Promise<{ object: DbClientObject }> => {\n const scope = await options.resolveScope(ctx.context.request, {\n operation: \"list\",\n key: ctx.query.key,\n });\n if (scope === null) throw unauthorized();\n const found = await options.objects.findByScopeKey({\n scope,\n key: ctx.query.key,\n bucket: ctx.query.bucket,\n });\n if (!found || found.status === \"deleted\") throw notFound();\n return { object: toDbClientObject(found) };\n },\n ),\n };\n}\n","import type { ScopeContext, ScopeResolver } from \"@/types/storage-object\";\n\n/**\n * Resolve each (request, operation, route, key) once. Presign runs the\n * ownership guard, the quota guard, and `onPresigned` on one request; they\n * share a single `resolveScope` call. A batch delete still resolves per key.\n */\nexport function memoizeScopeResolver(resolve: ScopeResolver): ScopeResolver {\n const cache = new WeakMap<Request, Map<string, ReturnType<ScopeResolver>>>();\n return (request: Request, context: ScopeContext) => {\n let byContext = cache.get(request);\n if (!byContext) {\n byContext = new Map();\n cache.set(request, byContext);\n }\n const id = JSON.stringify([\n context.operation,\n context.route ?? null,\n context.key ?? null,\n ]);\n let scope = byContext.get(id);\n if (scope === undefined) {\n scope = resolve(request, context);\n byContext.set(id, scope);\n }\n return scope;\n };\n}\n","import { AbortMultipartUploadCommand, type S3Client } from \"@aws-sdk/client-s3\";\nimport type { DimahS3PluginHooks } from \"@dimah-s3/server\";\nimport { forbidden, unauthorized } from \"@/errors\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { ScopeContext, ScopeResolver } from \"@/types/storage-object\";\nimport {\n createObjectAccessGuard,\n resolveStore,\n} from \"@/hooks/create-object-access-guard\";\nimport { memoizeScopeResolver } from \"./memoize-scope-resolver\";\n\nconst DEFAULT_PENDING_TTL_MS = 24 * 60 * 60 * 1000;\n\nexport type CreateDatabaseLifecycleHooksOptions = {\n client: DimahS3DbClient | StorageObjectStore;\n resolveScope: ScopeResolver;\n pendingTtlMs?: number;\n deleteMode?: \"soft\" | \"hard\";\n /**\n * S3 client for a route. Deleting a pending multipart row aborts its\n * upload through this client.\n */\n s3Client?: (route: string) => S3Client | undefined;\n};\n\n/**\n * Internal lifecycle hooks for the `db` plugin.\n * Keep the `storage_object` table in sync with S3 and enforce scope ownership.\n */\nexport function createDatabaseLifecycleHooks(\n options: CreateDatabaseLifecycleHooksOptions,\n): {\n objects: StorageObjectStore;\n hooks: DimahS3PluginHooks;\n resolveScope: ScopeResolver;\n} {\n const objects = resolveStore(options.client);\n const pendingTtlMs = options.pendingTtlMs ?? DEFAULT_PENDING_TTL_MS;\n const deleteMode = options.deleteMode ?? \"soft\";\n const resolveScope = memoizeScopeResolver(options.resolveScope);\n\n async function requireScope(\n request: Request,\n context: ScopeContext,\n ): Promise<string> {\n const scope = await resolveScope(request, context);\n if (scope === null) throw unauthorized();\n return scope;\n }\n\n function uploadScope(context: {\n request: Request;\n route: string;\n key: string;\n clientMetadata?: Record<string, string>;\n }): Promise<string> {\n return requireScope(context.request, {\n operation: \"upload\",\n route: context.route,\n key: context.key,\n clientMetadata: context.clientMetadata,\n });\n }\n\n async function guardKeyOwnership(context: {\n request: Request;\n route: string;\n bucket: string;\n key: string;\n clientMetadata?: Record<string, string>;\n }): Promise<void> {\n const scope = await uploadScope(context);\n const existing = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (existing && existing.status !== \"deleted\" && existing.scope !== scope) {\n throw forbidden(\"Key belongs to another scope\");\n }\n }\n\n async function trackPending(context: {\n request: Request;\n route: string;\n bucket: string;\n key: string;\n file: { name: string; size?: number; type?: string };\n metadata?: Record<string, string>;\n clientMetadata?: Record<string, string>;\n acl?: string;\n uploadId?: string;\n replace?: \"overwrite\";\n }): Promise<void> {\n const scope = await uploadScope(context);\n if (context.replace === \"overwrite\") {\n const existing = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (existing?.status === \"active\" && existing.scope === scope) {\n return;\n }\n }\n await objects.upsertPending({\n scope,\n bucket: context.bucket,\n key: context.key,\n route: context.route,\n contentType: context.file.type ?? null,\n declaredSize: context.file.size ?? null,\n metadata: context.metadata ?? null,\n acl: context.acl ?? null,\n filename: context.file.name,\n uploadId: context.uploadId ?? null,\n expiresAt: new Date(Date.now() + pendingTtlMs),\n });\n }\n\n async function trackConfirmed(context: {\n bucket: string;\n key: string;\n contentLength: number;\n eTag?: string;\n contentType?: string;\n acl?: string;\n fileName?: string;\n metadata?: Record<string, string>;\n }): Promise<void> {\n await objects.markActive({\n bucket: context.bucket,\n key: context.key,\n size: context.contentLength,\n eTag: context.eTag ?? null,\n contentType: context.contentType,\n acl: context.acl,\n filename: context.fileName,\n metadata: context.metadata,\n });\n }\n\n /** Delete is idempotent, so the row may be a pending multipart upload. */\n async function abortPendingMultipart(context: {\n route: string;\n bucket: string;\n key: string;\n }): Promise<void> {\n const row = await objects.find({\n bucket: context.bucket,\n key: context.key,\n });\n if (row?.status !== \"pending\" || !row.uploadId) return;\n const s3 = options.s3Client?.(context.route);\n if (!s3) return;\n try {\n await s3.send(\n new AbortMultipartUploadCommand({\n Bucket: context.bucket,\n Key: context.key,\n UploadId: row.uploadId,\n }),\n );\n } catch {\n // Best-effort, like the purge job. A lifecycle rule catches the rest.\n }\n }\n\n const guardOptions = { client: objects, resolveScope };\n const pendingObjectGuard = createObjectAccessGuard({\n ...guardOptions,\n operation: \"confirm\",\n requireStatus: \"pending\",\n });\n const ownedObjectConfirmGuard = createObjectAccessGuard({\n ...guardOptions,\n operation: \"confirm\",\n requireStatus: \"any\",\n });\n const multipartSessionGuard = createObjectAccessGuard({\n ...guardOptions,\n operation: \"multipart\",\n requireStatus: \"pending\",\n requireUploadId: true,\n });\n const activeObjectGuard = createObjectAccessGuard({\n ...guardOptions,\n operation: \"download\",\n requireStatus: \"active\",\n });\n const ownedObjectDeleteGuard = createObjectAccessGuard({\n ...guardOptions,\n operation: \"delete\",\n requireStatus: \"any\",\n });\n\n return {\n objects,\n resolveScope,\n hooks: {\n upload: {\n guard: guardKeyOwnership,\n onPresigned: trackPending,\n confirmGuard: async (context) => {\n if (context.replace === \"overwrite\") {\n await ownedObjectConfirmGuard(context);\n return;\n }\n await pendingObjectGuard(context);\n },\n onConfirmed: trackConfirmed,\n multipart: {\n onInit: trackPending,\n guard: multipartSessionGuard,\n onAbort: async (context) => {\n await objects.deletePending({\n bucket: context.bucket,\n key: context.key,\n uploadId: context.uploadId,\n });\n },\n },\n },\n download: {\n guard: activeObjectGuard,\n },\n delete: {\n guard: ownedObjectDeleteGuard,\n onDeleted: async (context) => {\n if (!context.existed) await abortPendingMultipart(context);\n const ref = { bucket: context.bucket, key: context.key };\n if (deleteMode === \"hard\") await objects.hardDelete(ref);\n else await objects.softDelete(ref);\n },\n },\n },\n };\n}\n","import type { S3Client } from \"@aws-sdk/client-s3\";\nimport {\n chainHooks,\n definePlugin,\n isFeatureOn,\n type DimahS3Config,\n} from \"@dimah-s3/server\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { ScopeResolver } from \"@/types/storage-object\";\nimport { createQuotaGuard } from \"@/hooks/create-quota-guard\";\nimport { createDatabaseEndpoints } from \"./create-database-endpoints\";\nimport { createDatabaseLifecycleHooks } from \"./create-database-lifecycle-hooks\";\n\nexport type DbPluginOptions = {\n /** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt objects store. */\n client: DimahS3DbClient | StorageObjectStore;\n /**\n * Maps a request to its owning scope. `null` rejects with 401. The second\n * argument carries the operation, route, and object key the endpoint\n * already validated.\n */\n resolveScope: ScopeResolver;\n /**\n * How long a `pending` row stays valid before the purge job may remove it.\n * @default 86_400_000 (24h)\n */\n pendingTtlMs?: number;\n /**\n * After a normal server delete (`api.delete` → S3 `DeleteObject`), how the\n * plugin updates the DB row in `onDeleted`: `soft` keeps it with\n * `status = \"deleted\"`; `hard` removes it. Does not change the S3 delete\n * path — callers still use `api.delete`, not store helpers. Delete also\n * clears a row whose object never landed, and aborts a pending multipart\n * upload by its `uploadId`.\n * @default \"soft\"\n */\n deleteMode?: \"soft\" | \"hard\";\n /**\n * Optional scope usage caps. Numbers come from you — the plugin only\n * checks. Wired as `upload.guard` after ownership.\n */\n quota?: {\n maxBytes?: number;\n maxFiles?: number;\n };\n};\n\nexport type DbPluginContext = {\n /** `storage_object` data-access layer — listings, quota, resume, custom routes. */\n objects: StorageObjectStore;\n /** Underlying FumaDB client (or the store when one was passed as `client`). */\n client: DimahS3DbClient | StorageObjectStore;\n};\n\n/**\n * Persistence plugin for {@link dimahS3} — keeps rows in sync with upload /\n * multipart / download / delete lifecycle and enforces scope ownership.\n *\n * Hooks attach to every route unless the route sets `plugins: { db: false }`.\n *\n * Exposes `GET /db/objects` and `GET /db/object` for the browser via\n * {@link dbClient}.\n *\n * ```ts\n * const s3 = dimahS3({\n * client: awsS3,\n * bucket,\n * plugins: [\n * db({ client: dimahS3Db, resolveScope }),\n * ],\n * routes: {\n * uploads: route({\n * upload: true,\n * }),\n * },\n * });\n *\n * s3.db.objects.listByScope({ scope });\n * s3.context.db === s3.db;\n * ```\n */\nexport function db(options: DbPluginOptions) {\n let config: Readonly<DimahS3Config> | undefined;\n const s3Client = (route: string): S3Client | undefined =>\n config?.routes[route]?.client ?? config?.client;\n const { objects, hooks, resolveScope } = createDatabaseLifecycleHooks({\n ...options,\n s3Client,\n });\n if (options.quota && hooks.upload) {\n const quotaGuard = createQuotaGuard({\n client: objects,\n resolveScope,\n maxBytes: options.quota.maxBytes,\n maxFiles: options.quota.maxFiles,\n });\n hooks.upload.guard = chainHooks(hooks.upload.guard, quotaGuard);\n }\n\n return definePlugin({\n id: \"db\",\n init(env) {\n config = env.config;\n const routes = Object.values(env.config.routes);\n const hasLifecycle = routes.some(\n (r) =>\n isFeatureOn(r.upload) ||\n isFeatureOn(r.download) ||\n isFeatureOn(r.delete),\n );\n if (!hasLifecycle) {\n throw new Error(\n \"[dimah-s3] db plugin requires at least one route with upload, download, or delete enabled.\",\n );\n }\n },\n hooks,\n endpoints: createDatabaseEndpoints({ objects, resolveScope }),\n context: {\n objects,\n client: options.client,\n } satisfies DbPluginContext,\n });\n}\n","import {\n AbortMultipartUploadCommand,\n DeleteObjectCommand,\n type S3Client,\n} from \"@aws-sdk/client-s3\";\nimport { resolveStore } from \"@/hooks/create-object-access-guard\";\nimport type {\n DimahS3DbClient,\n StorageObjectStore,\n} from \"@/store/storage-object-store\";\nimport type { StorageObject } from \"@/types/storage-object\";\n\nconst DEFAULT_OLDER_THAN_MS = 24 * 60 * 60 * 1000;\n\nexport type PurgeStalePendingOptions = {\n /** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt store. */\n client: DimahS3DbClient | StorageObjectStore;\n /**\n * Fallback age for pending rows that have no `expiresAt`.\n * @default 86_400_000 (24h)\n */\n olderThanMs?: number;\n /**\n * When set, abort in-progress multipart uploads and `DeleteObject` for\n * each stale pending key before rows are removed.\n */\n s3?: S3Client;\n /**\n * Runs before rows are deleted. Throwing keeps all rows for the next run.\n * Prefer `s3` unless you need a custom cleanup.\n */\n onBeforePurge?: (objects: StorageObject[]) => Promise<void> | void;\n};\n\nexport type PurgeStalePendingResult = {\n purged: StorageObject[];\n};\n\nasync function abortAndDelete(\n s3: S3Client,\n objects: StorageObject[],\n): Promise<void> {\n for (const object of objects) {\n if (object.uploadId) {\n try {\n await s3.send(\n new AbortMultipartUploadCommand({\n Bucket: object.bucket,\n Key: object.key,\n UploadId: object.uploadId,\n }),\n );\n } catch {\n // Best-effort.\n }\n }\n try {\n await s3.send(\n new DeleteObjectCommand({\n Bucket: object.bucket,\n Key: object.key,\n }),\n );\n } catch {\n // Best-effort.\n }\n }\n}\n\n/**\n * Delete stale `pending` rows — uploads that were presigned but never\n * confirmed. Run it on a schedule (cron, queue worker, route handler).\n */\nexport async function purgeStalePendingObjects(\n options: PurgeStalePendingOptions,\n): Promise<PurgeStalePendingResult> {\n const store = resolveStore(options.client);\n const olderThan = new Date(\n Date.now() - (options.olderThanMs ?? DEFAULT_OLDER_THAN_MS),\n );\n\n const stale = await store.findStalePending({ olderThan });\n if (stale.length === 0) return { purged: [] };\n\n if (options.s3) await abortAndDelete(options.s3, stale);\n await options.onBeforePurge?.(stale);\n await store.deleteByIds(stale.map((object) => object.id));\n\n return { purged: stale };\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-database-endpoints.d.ts","sourceRoot":"","sources":["../../src/plugin/create-database-endpoints.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,EAAE,aAAa,CAAC;CAC7B;IAEG,mEAAmE;IACnE,OAAO;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"create-database-endpoints.d.ts","sourceRoot":"","sources":["../../src/plugin/create-database-endpoints.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,EAAE,aAAa,CAAC;CAC7B;IAEG,mEAAmE;IACnE,OAAO;;;;;;;;;;;;;;;;;;;;;;;IAiDP,MAAM;;;;;;;;;;;;;gBAG2B,cAAc;;EAgBlD"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type S3Client } from "@aws-sdk/client-s3";
|
|
1
2
|
import type { DimahS3PluginHooks } from "@dimah-s3/server";
|
|
2
3
|
import type { DimahS3DbClient, StorageObjectStore } from "../store/storage-object-store.js";
|
|
3
4
|
import type { ScopeResolver } from "../types/storage-object.js";
|
|
@@ -6,6 +7,11 @@ export type CreateDatabaseLifecycleHooksOptions = {
|
|
|
6
7
|
resolveScope: ScopeResolver;
|
|
7
8
|
pendingTtlMs?: number;
|
|
8
9
|
deleteMode?: "soft" | "hard";
|
|
10
|
+
/**
|
|
11
|
+
* S3 client for a route. Deleting a pending multipart row aborts its
|
|
12
|
+
* upload through this client.
|
|
13
|
+
*/
|
|
14
|
+
s3Client?: (route: string) => S3Client | undefined;
|
|
9
15
|
};
|
|
10
16
|
/**
|
|
11
17
|
* Internal lifecycle hooks for the `db` plugin.
|
|
@@ -14,5 +20,6 @@ export type CreateDatabaseLifecycleHooksOptions = {
|
|
|
14
20
|
export declare function createDatabaseLifecycleHooks(options: CreateDatabaseLifecycleHooksOptions): {
|
|
15
21
|
objects: StorageObjectStore;
|
|
16
22
|
hooks: DimahS3PluginHooks;
|
|
23
|
+
resolveScope: ScopeResolver;
|
|
17
24
|
};
|
|
18
25
|
//# sourceMappingURL=create-database-lifecycle-hooks.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-database-lifecycle-hooks.d.ts","sourceRoot":"","sources":["../../src/plugin/create-database-lifecycle-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"create-database-lifecycle-hooks.d.ts","sourceRoot":"","sources":["../../src/plugin/create-database-lifecycle-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAS1E,MAAM,MAAM,mCAAmC,GAAG;IAChD,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC7C,YAAY,EAAE,aAAa,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;CACpD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C;IACD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,YAAY,EAAE,aAAa,CAAC;CAC7B,CAwMA"}
|
package/dist/plugin/db.d.ts
CHANGED
|
@@ -3,7 +3,11 @@ import type { ScopeResolver } from "../types/storage-object.js";
|
|
|
3
3
|
export type DbPluginOptions = {
|
|
4
4
|
/** FumaDB client (`DimahS3DB.client(adapter)`) or a prebuilt objects store. */
|
|
5
5
|
client: DimahS3DbClient | StorageObjectStore;
|
|
6
|
-
/**
|
|
6
|
+
/**
|
|
7
|
+
* Maps a request to its owning scope. `null` rejects with 401. The second
|
|
8
|
+
* argument carries the operation, route, and object key the endpoint
|
|
9
|
+
* already validated.
|
|
10
|
+
*/
|
|
7
11
|
resolveScope: ScopeResolver;
|
|
8
12
|
/**
|
|
9
13
|
* How long a `pending` row stays valid before the purge job may remove it.
|
|
@@ -14,7 +18,9 @@ export type DbPluginOptions = {
|
|
|
14
18
|
* After a normal server delete (`api.delete` → S3 `DeleteObject`), how the
|
|
15
19
|
* plugin updates the DB row in `onDeleted`: `soft` keeps it with
|
|
16
20
|
* `status = "deleted"`; `hard` removes it. Does not change the S3 delete
|
|
17
|
-
* path — callers still use `api.delete`, not store helpers.
|
|
21
|
+
* path — callers still use `api.delete`, not store helpers. Delete also
|
|
22
|
+
* clears a row whose object never landed, and aborts a pending multipart
|
|
23
|
+
* upload by its `uploadId`.
|
|
18
24
|
* @default "soft"
|
|
19
25
|
*/
|
|
20
26
|
deleteMode?: "soft" | "hard";
|
package/dist/plugin/db.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/plugin/db.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/plugin/db.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK5D,MAAM,MAAM,eAAe,GAAG;IAC5B,+EAA+E;IAC/E,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC7C;;;;OAIG;IACH,YAAY,EAAE,aAAa,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,mFAAmF;IACnF,OAAO,EAAE,kBAAkB,CAAC;IAC5B,+EAA+E;IAC/E,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0C1C"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ScopeResolver } from "../types/storage-object.js";
|
|
2
|
+
/**
|
|
3
|
+
* Resolve each (request, operation, route, key) once. Presign runs the
|
|
4
|
+
* ownership guard, the quota guard, and `onPresigned` on one request; they
|
|
5
|
+
* share a single `resolveScope` call. A batch delete still resolves per key.
|
|
6
|
+
*/
|
|
7
|
+
export declare function memoizeScopeResolver(resolve: ScopeResolver): ScopeResolver;
|
|
8
|
+
//# sourceMappingURL=memoize-scope-resolver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memoize-scope-resolver.d.ts","sourceRoot":"","sources":["../../src/plugin/memoize-scope-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAoB1E"}
|
|
@@ -32,11 +32,34 @@ export type StorageObject = {
|
|
|
32
32
|
updatedAt: Date;
|
|
33
33
|
deletedAt: Date | null;
|
|
34
34
|
};
|
|
35
|
+
/**
|
|
36
|
+
* Endpoint a scope is resolved for.
|
|
37
|
+
* - `upload`: presign and multipart init
|
|
38
|
+
* - `confirm`: confirm, and the confirm step of multipart complete
|
|
39
|
+
* - `multipart`: part, list, abort, and complete
|
|
40
|
+
* - `download`: presigned download and `GET /file`
|
|
41
|
+
* - `delete`: delete, and each key of a batch delete
|
|
42
|
+
* - `list`: `GET /db/objects` and `GET /db/object`
|
|
43
|
+
*/
|
|
44
|
+
export type ScopeOperation = "upload" | "confirm" | "multipart" | "download" | "delete" | "list";
|
|
45
|
+
/** Values the endpoint already validated, passed to {@link ScopeResolver}. */
|
|
46
|
+
export type ScopeContext = {
|
|
47
|
+
operation: ScopeOperation;
|
|
48
|
+
/** Named route. On `list`, set only when the client filtered by route. */
|
|
49
|
+
route?: string;
|
|
50
|
+
/** Object key. Absent on `GET /db/objects`. */
|
|
51
|
+
key?: string;
|
|
52
|
+
/** Client extras from presign or multipart init. Set on `upload` only. */
|
|
53
|
+
clientMetadata?: Record<string, string>;
|
|
54
|
+
};
|
|
35
55
|
/**
|
|
36
56
|
* Resolves the owning scope for a request (e.g. from a session cookie).
|
|
37
|
-
*
|
|
57
|
+
* `context` carries the operation, route, and key, so a scope that depends
|
|
58
|
+
* on the object key does not have to parse the request. A batch delete
|
|
59
|
+
* resolves once per key. Return `null` to reject the request as
|
|
60
|
+
* unauthenticated (401).
|
|
38
61
|
*/
|
|
39
|
-
export type ScopeResolver = (request: Request) => string | null | Promise<string | null>;
|
|
62
|
+
export type ScopeResolver = (request: Request, context: ScopeContext) => string | null | Promise<string | null>;
|
|
40
63
|
/**
|
|
41
64
|
* Browser-facing object row from `GET /db/objects`.
|
|
42
65
|
* Deliberately narrower than {@link StorageObject} — omits server-only fields.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"storage-object.d.ts","sourceRoot":"","sources":["../../src/types/storage-object.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF
|
|
1
|
+
{"version":3,"file":"storage-object.d.ts","sourceRoot":"","sources":["../../src/types/storage-object.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dimah-s3/db",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "Optional database plugin for dimah-s3 — track S3 object ownership, listings, and resumable uploads",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"s3",
|
|
@@ -50,14 +50,14 @@
|
|
|
50
50
|
"src/schema/examples"
|
|
51
51
|
],
|
|
52
52
|
"dependencies": {
|
|
53
|
-
"@dimah-s3/core": "1.
|
|
53
|
+
"@dimah-s3/core": "1.7.0",
|
|
54
54
|
"@paralleldrive/cuid2": "^3.3.0",
|
|
55
55
|
"fumadb": "^0.6.0",
|
|
56
56
|
"zod": "^4.6.7"
|
|
57
57
|
},
|
|
58
58
|
"devDependencies": {
|
|
59
59
|
"@aws-sdk/client-s3": "^3.1158.0",
|
|
60
|
-
"@dimah-s3/server": "1.
|
|
60
|
+
"@dimah-s3/server": "1.7.0",
|
|
61
61
|
"@types/node": "^26.6.5",
|
|
62
62
|
"@workspace/eslint-config": "0.0.1",
|
|
63
63
|
"@workspace/tsup-config": "0.0.0",
|
|
@@ -72,7 +72,7 @@
|
|
|
72
72
|
},
|
|
73
73
|
"peerDependencies": {
|
|
74
74
|
"@aws-sdk/client-s3": ">=3",
|
|
75
|
-
"@dimah-s3/server": "1.
|
|
75
|
+
"@dimah-s3/server": "1.7.0",
|
|
76
76
|
"drizzle-orm": "^0.44.0 || ^0.45.0 || >=1.0.0-rc.1 <2.0.0"
|
|
77
77
|
},
|
|
78
78
|
"peerDependenciesMeta": {
|