@modern-admin/feature-upload 0.1.0

package/dist/graphql.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GraphQL extension for the upload feature — mirrors the REST upload
+ * controller (`POST /admin/api/resources/:id/actions/upload` and `DELETE`)
+ * with two mutations:
+ *
+ *   - `adminUpload(resourceId, field, file)` — upload a single file via the
+ *     `Upload` scalar (multipart/form-data per the GraphQL multipart spec).
+ *     Returns `UploadedFileInfo`.
+ *   - `adminCancelUpload(resourceId, field, key)` — cancel a still-pending
+ *     upload (file uploaded but record not yet saved). Returns `Boolean`.
+ *
+ * The extension is wired in the host application:
+ *   ```ts
+ *   ModernAdminGraphqlModule.forRoot({
+ *     extensions: [uploadGraphqlExtension()],
+ *   })
+ *   ```
+ *
+ * Authorisation re-uses the same `ModernAdmin.invoke()` access checks via
+ * `findResource(resourceId, currentAdmin)`.
+ *
+ * `@modern-admin/graphql` is an *optional peer dependency* of feature-upload —
+ * if you do not use the GraphQL transport you do not need to import this
+ * module at all.
+ */
+import { type ExtensionContext, type GraphqlSchemaExtension } from '@modern-admin/graphql';
+export interface UploadGraphqlExtensionOptions {
+    /**
+     * TTL applied when registering an uploaded key as pending. Mirrors the
+     * `pendingTtlMs` option on `ModernAdminUploadModule.forRoot()` — set both
+     * to the same value to keep REST and GraphQL behaviour identical.
+     */
+    pendingTtlMs?: number;
+}
+export declare function uploadGraphqlExtension(options?: UploadGraphqlExtensionOptions): (ctx: ExtensionContext) => GraphqlSchemaExtension;
+//# sourceMappingURL=graphql.d.ts.map

package/dist/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAA;AAS9B,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,6BAAkC,GAC1C,CAAC,GAAG,EAAE,gBAAgB,KAAK,sBAAsB,CAwFnD"}

package/dist/graphql.js

@@ -0,0 +1,141 @@
+/**
+ * GraphQL extension for the upload feature — mirrors the REST upload
+ * controller (`POST /admin/api/resources/:id/actions/upload` and `DELETE`)
+ * with two mutations:
+ *
+ *   - `adminUpload(resourceId, field, file)` — upload a single file via the
+ *     `Upload` scalar (multipart/form-data per the GraphQL multipart spec).
+ *     Returns `UploadedFileInfo`.
+ *   - `adminCancelUpload(resourceId, field, key)` — cancel a still-pending
+ *     upload (file uploaded but record not yet saved). Returns `Boolean`.
+ *
+ * The extension is wired in the host application:
+ *   ```ts
+ *   ModernAdminGraphqlModule.forRoot({
+ *     extensions: [uploadGraphqlExtension()],
+ *   })
+ *   ```
+ *
+ * Authorisation re-uses the same `ModernAdmin.invoke()` access checks via
+ * `findResource(resourceId, currentAdmin)`.
+ *
+ * `@modern-admin/graphql` is an *optional peer dependency* of feature-upload —
+ * if you do not use the GraphQL transport you do not need to import this
+ * module at all.
+ */
+import { GraphQLBoolean, GraphQLNonNull, GraphQLObjectType, GraphQLString, GraphQLInt, } from 'graphql';
+import { ForbiddenError, ResourceNotFoundError } from '@modern-admin/core';
+import { UploadProviderRegistry } from './registry.js';
+import { PendingUploadsRegistry } from './pending-registry.js';
+/** Default TTL for pending upload entries, mirrored from the controller. */
+const DEFAULT_PENDING_TTL_MS = 60 * 60 * 1000;
+export function uploadGraphqlExtension(options = {}) {
+    const ttlMs = options.pendingTtlMs ?? DEFAULT_PENDING_TTL_MS;
+    return ({ Upload }) => {
+        const UploadedFileInfoType = new GraphQLObjectType({
+            name: 'UploadedFileInfo',
+            description: 'Metadata returned for one successfully uploaded file.',
+            fields: () => ({
+                key: { type: new GraphQLNonNull(GraphQLString) },
+                url: { type: new GraphQLNonNull(GraphQLString) },
+                name: { type: new GraphQLNonNull(GraphQLString) },
+                size: { type: new GraphQLNonNull(GraphQLInt) },
+                mimeType: { type: new GraphQLNonNull(GraphQLString) },
+            }),
+        });
+        return {
+            name: 'feature-upload',
+            types: [UploadedFileInfoType],
+            mutations: {
+                adminUpload: {
+                    type: new GraphQLNonNull(UploadedFileInfoType),
+                    description: 'Upload a single file for an upload-enabled property. Multi-file ' +
+                        'properties accept one mutation invocation per file.',
+                    args: {
+                        resourceId: { type: new GraphQLNonNull(GraphQLString) },
+                        field: { type: new GraphQLNonNull(GraphQLString) },
+                        file: { type: new GraphQLNonNull(Upload) },
+                    },
+                    async resolve(_src, args, ctx) {
+                        const { resourceId, field } = args;
+                        const { providerId, registered } = resolveProperty(ctx, resourceId, field);
+                        const upload = args.file;
+                        const computedKey = registered.uploadPath
+                            ? registered.uploadPath(upload.filename)
+                            : undefined;
+                        const key = await registered.provider.upload({
+                            originalName: upload.filename,
+                            mimeType: upload.mimeType,
+                            size: upload.size,
+                            buffer: upload.buffer,
+                        }, computedKey);
+                        PendingUploadsRegistry.track(key, providerId, ttlMs);
+                        const url = await registered.provider.getUrl(key);
+                        const info = {
+                            key,
+                            url,
+                            name: upload.filename,
+                            size: upload.size,
+                            mimeType: upload.mimeType,
+                        };
+                        return info;
+                    },
+                },
+                adminCancelUpload: {
+                    type: new GraphQLNonNull(GraphQLBoolean),
+                    description: 'Cancel a still-pending upload (file uploaded but record not yet ' +
+                        'saved). Returns false when the key is no longer pending.',
+                    args: {
+                        resourceId: { type: new GraphQLNonNull(GraphQLString) },
+                        field: { type: new GraphQLNonNull(GraphQLString) },
+                        key: { type: new GraphQLNonNull(GraphQLString) },
+                    },
+                    async resolve(_src, args, ctx) {
+                        const { resourceId, field, key } = args;
+                        // Validate the resource/field exists & is upload-enabled. Mirrors
+                        // the REST controller's check — prevents leaking arbitrary
+                        // resource ids to authenticated clients.
+                        resolveProperty(ctx, resourceId, field);
+                        return PendingUploadsRegistry.cancel(key);
+                    },
+                },
+            },
+        };
+    };
+}
+/**
+ * Resolve the resource + property and ensure it is wired to an upload
+ * provider. Mirrors the private helper in the REST upload controller — kept
+ * private to this module to avoid coupling. Throws GraphQL-friendly Error
+ * objects (not Nest exceptions) so they surface as standard GraphQL errors.
+ */
+function resolveProperty(ctx, resourceId, field) {
+    let resource;
+    try {
+        resource = ctx.admin.findResource(resourceId);
+    }
+    catch (err) {
+        if (err instanceof ResourceNotFoundError)
+            throw new Error(err.message);
+        if (err instanceof ForbiddenError)
+            throw new Error(err.message);
+        throw err;
+    }
+    const decorator = resource.decorate();
+    const prop = decorator.getPropertyByKey(field);
+    if (!prop) {
+        throw new Error(`Property "${field}" not found on resource "${resourceId}"`);
+    }
+    const propJson = prop.toJSON();
+    const providerId = propJson.custom?.uploadProviderId;
+    if (!providerId) {
+        throw new Error(`Property "${field}" on resource "${resourceId}" is not configured for upload. ` +
+            'Apply uploadFeature() to the resource.');
+    }
+    const registered = UploadProviderRegistry.get(providerId);
+    if (!registered) {
+        throw new Error(`Upload provider "${providerId}" is not registered.`);
+    }
+    return { providerId, registered };
+}
+//# sourceMappingURL=graphql.js.map

package/dist/graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { uploadFeature } from './upload-feature.js';
+export { UploadProviderRegistry } from './registry.js';
+export { PendingUploadsRegistry } from './pending-registry.js';
+export { LocalUploadProvider, type LocalUploadOptions } from './providers/local.js';
+export { S3UploadProvider, type S3UploadOptions } from './providers/s3.js';
+export type { IUploadProvider, UploadedFile, UploadedFileInfo, UploadFeatureOptions, UploadPropertyConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAG1E,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// @modern-admin/feature-upload — file upload plugin for modern-admin resources.
+//
+// Usage:
+//   import { uploadFeature, LocalUploadProvider, S3UploadProvider } from '@modern-admin/feature-upload'
+//   import { ModernAdminUploadModule } from '@modern-admin/feature-upload/nest'
+export { uploadFeature } from './upload-feature.js';
+export { UploadProviderRegistry } from './registry.js';
+export { PendingUploadsRegistry } from './pending-registry.js';
+// Built-in providers
+export { LocalUploadProvider } from './providers/local.js';
+export { S3UploadProvider } from './providers/s3.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,SAAS;AACT,wGAAwG;AACxG,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,qBAAqB;AACrB,OAAO,EAAE,mBAAmB,EAA2B,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAA"}

package/dist/nest/index.d.ts

@@ -0,0 +1,3 @@
+export { ModernAdminUploadModule, type ModernAdminUploadModuleOptions } from './upload.module.js';
+export { UploadController } from './upload.controller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/nest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nest/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/nest/index.js

@@ -0,0 +1,4 @@
+// @modern-admin/feature-upload/nest — NestJS module + controller for file uploads.
+export { ModernAdminUploadModule } from './upload.module.js';
+export { UploadController } from './upload.controller.js';
+//# sourceMappingURL=index.js.map

package/dist/nest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nest/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAAE,uBAAuB,EAAuC,MAAM,oBAAoB,CAAA;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/nest/upload-sweeper.service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UploadSweeperService — periodic background task that purges expired entries
+ * from `PendingUploadsRegistry`.
+ *
+ * The interval starts when Nest calls `onModuleInit` and stops on
+ * `onModuleDestroy`. Set `sweepIntervalMs: 0` in the module options to
+ * disable scheduling (useful for tests that drive `sweep()` manually).
+ *
+ * TODO(roadmap): replace the in-process `setInterval` driver with a BullMQ
+ * (Redis-backed) job queue. Reasons:
+ *   - the registry will move to Redis in the multi-instance deployment story,
+ *     and the sweeper job belongs in the same place;
+ *   - BullMQ gives us cron scheduling, retries on transient storage errors,
+ *     visibility/metrics through Bull Board, and crash safety (a process
+ *     restart resumes scheduled sweeps instead of forgetting them);
+ *   - per-key cancel can become a delayed job (`removeJob` on confirm) which
+ *     is more efficient than a periodic full-table scan once we have many
+ *     pending entries.
+ * The migration should keep the same `PendingUploadsRegistry` API surface so
+ * call sites (controller, hooks) do not need to change — only the storage
+ * (Map → Redis) and the sweeper driver (setInterval → BullMQ Worker) flip.
+ */
+import { type OnModuleDestroy, type OnModuleInit } from '@nestjs/common';
+import { type ModernAdminUploadModuleOptions } from './upload.tokens.js';
+export declare class UploadSweeperService implements OnModuleInit, OnModuleDestroy {
+    private readonly options;
+    private timer;
+    constructor(options: ModernAdminUploadModuleOptions);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+}
+//# sourceMappingURL=upload-sweeper.service.d.ts.map

package/dist/nest/upload-sweeper.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-sweeper.service.d.ts","sourceRoot":"","sources":["../../src/nest/upload-sweeper.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE5F,OAAO,EAAyB,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AAI/F,qBACa,oBAAqB,YAAW,YAAY,EAAE,eAAe;IAG7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFnE,OAAO,CAAC,KAAK,CAA8C;gBAEC,OAAO,EAAE,8BAA8B;IAEnG,YAAY,IAAI,IAAI;IAUpB,eAAe,IAAI,IAAI;CAMxB"}

package/dist/nest/upload-sweeper.service.js

@@ -0,0 +1,68 @@
+/**
+ * UploadSweeperService — periodic background task that purges expired entries
+ * from `PendingUploadsRegistry`.
+ *
+ * The interval starts when Nest calls `onModuleInit` and stops on
+ * `onModuleDestroy`. Set `sweepIntervalMs: 0` in the module options to
+ * disable scheduling (useful for tests that drive `sweep()` manually).
+ *
+ * TODO(roadmap): replace the in-process `setInterval` driver with a BullMQ
+ * (Redis-backed) job queue. Reasons:
+ *   - the registry will move to Redis in the multi-instance deployment story,
+ *     and the sweeper job belongs in the same place;
+ *   - BullMQ gives us cron scheduling, retries on transient storage errors,
+ *     visibility/metrics through Bull Board, and crash safety (a process
+ *     restart resumes scheduled sweeps instead of forgetting them);
+ *   - per-key cancel can become a delayed job (`removeJob` on confirm) which
+ *     is more efficient than a periodic full-table scan once we have many
+ *     pending entries.
+ * The migration should keep the same `PendingUploadsRegistry` API surface so
+ * call sites (controller, hooks) do not need to change — only the storage
+ * (Map → Redis) and the sweeper driver (setInterval → BullMQ Worker) flip.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Inject, Injectable } from '@nestjs/common';
+import { PendingUploadsRegistry } from '../pending-registry.js';
+import { UPLOAD_MODULE_OPTIONS } from './upload.tokens.js';
+const DEFAULT_SWEEP_INTERVAL_MS = 5 * 60 * 1000;
+let UploadSweeperService = class UploadSweeperService {
+    constructor(options) {
+        this.options = options;
+        this.timer = null;
+    }
+    onModuleInit() {
+        const interval = this.options.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS;
+        if (interval <= 0)
+            return;
+        this.timer = setInterval(() => {
+            void PendingUploadsRegistry.sweep();
+        }, interval);
+        // Allow the Node.js process to exit even if the timer is still scheduled.
+        if (typeof this.timer.unref === 'function')
+            this.timer.unref();
+    }
+    onModuleDestroy() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+};
+UploadSweeperService = __decorate([
+    Injectable(),
+    __param(0, Inject(UPLOAD_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], UploadSweeperService);
+export { UploadSweeperService };
+//# sourceMappingURL=upload-sweeper.service.js.map

package/dist/nest/upload-sweeper.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-sweeper.service.js","sourceRoot":"","sources":["../../src/nest/upload-sweeper.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;;;;;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAA2C,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAuC,MAAM,oBAAoB,CAAA;AAE/F,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAGxC,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAG/B,YAA2C,OAAwD;QAAvC,YAAO,GAAP,OAAO,CAAgC;QAF3F,UAAK,GAA0C,IAAI,CAAA;IAE2C,CAAC;IAEvG,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAA;QAC1E,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAM;QACzB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,KAAK,sBAAsB,CAAC,KAAK,EAAE,CAAA;QACrC,CAAC,EAAE,QAAQ,CAAC,CAAA;QACZ,0EAA0E;QAC1E,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IAChE,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;CACF,CAAA;AArBY,oBAAoB;IADhC,UAAU,EAAE;IAIE,WAAA,MAAM,CAAC,qBAAqB,CAAC,CAAA;;GAH/B,oBAAoB,CAqBhC"}

package/dist/nest/upload.controller.d.ts

@@ -0,0 +1,51 @@
+/**
+ * UploadController — handles file uploads for `type: 'file'` properties.
+ *
+ * Endpoints
+ * ---------
+ *   POST   /admin/api/resources/:resourceId/actions/upload?field=<propertyPath>
+ *     Content-Type: multipart/form-data
+ *     Accepts one or more files (any field names). Returns `UploadedFileInfo[]` —
+ *     callers writing to a single-value `'file'` property take the first item;
+ *     `isArray: true` properties consume the whole array.
+ *
+ *   DELETE /admin/api/resources/:resourceId/actions/upload?field=<path>&key=<key>
+ *     Cancels a still-pending upload (uploaded but not yet saved). Calls
+ *     `PendingUploadsRegistry.cancel(key)` which deletes the file from
+ *     storage. No-op (404) if the key is no longer pending — protects already
+ *     persisted files from being deleted via this endpoint.
+ *
+ * Authorisation re-uses `ModernAdminAuthGuard` from `@modern-admin/nest` —
+ * requires `ModernAdminModule.forRoot()` to be registered (globally or as a
+ * parent module).
+ */
+import type { IncomingMessage } from 'node:http';
+import { type ModernAdmin } from '@modern-admin/core';
+import { type ModernAdminUploadModuleOptions } from './upload.tokens.js';
+import type { UploadedFileInfo } from '../types.js';
+export declare class UploadController {
+    private readonly admin;
+    private readonly moduleOptions;
+    constructor(admin: ModernAdmin, moduleOptions: ModernAdminUploadModuleOptions);
+    /**
+     * Upload one or more files for a specific resource property.
+     *
+     * @param resourceId  Admin resource id (e.g. `'users'`)
+     * @param field       Property path (e.g. `'avatar'` / `'gallery'`)
+     * @param req         Raw Express / Node.js `IncomingMessage`
+     */
+    upload(resourceId: string, field: string, req: IncomingMessage): Promise<UploadedFileInfo[]>;
+    /**
+     * Cancel a still-pending upload — delete the file from storage immediately.
+     * Used by the editor when the user removes a file *before* saving the form.
+     *
+     * Returns 204 if the cancel succeeded, 404 if the key is not pending.
+     * The "not pending" branch protects already-persisted files: once a file
+     * has been confirmed via the action hooks it can no longer be removed via
+     * this endpoint — only via the regular edit/delete actions.
+     */
+    cancel(resourceId: string, field: string, key: string): Promise<void>;
+    /** Resolve the resource + property and ensure it is wired to an upload provider. */
+    private resolveProperty;
+}
+//# sourceMappingURL=upload.controller.d.ts.map

package/dist/nest/upload.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.controller.d.ts","sourceRoot":"","sources":["../../src/nest/upload.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAkBH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EAAyB,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AAC/F,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAiEjE,qBAIa,gBAAgB;IAEH,OAAO,CAAC,QAAQ,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADtB,KAAK,EAAE,WAAW,EACT,aAAa,EAAE,8BAA8B;IAG/F;;;;;;OAMG;IAEG,MAAM,CACW,UAAU,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACtB,GAAG,EAAE,eAAe,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA2B9B;;;;;;;;OAQG;IAGG,MAAM,CACW,UAAU,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAchB,oFAAoF;IACpF,OAAO,CAAC,eAAe;CAkCxB"}

package/dist/nest/upload.controller.js

@@ -0,0 +1,220 @@
+/**
+ * UploadController — handles file uploads for `type: 'file'` properties.
+ *
+ * Endpoints
+ * ---------
+ *   POST   /admin/api/resources/:resourceId/actions/upload?field=<propertyPath>
+ *     Content-Type: multipart/form-data
+ *     Accepts one or more files (any field names). Returns `UploadedFileInfo[]` —
+ *     callers writing to a single-value `'file'` property take the first item;
+ *     `isArray: true` properties consume the whole array.
+ *
+ *   DELETE /admin/api/resources/:resourceId/actions/upload?field=<path>&key=<key>
+ *     Cancels a still-pending upload (uploaded but not yet saved). Calls
+ *     `PendingUploadsRegistry.cancel(key)` which deletes the file from
+ *     storage. No-op (404) if the key is no longer pending — protects already
+ *     persisted files from being deleted via this endpoint.
+ *
+ * Authorisation re-uses `ModernAdminAuthGuard` from `@modern-admin/nest` —
+ * requires `ModernAdminModule.forRoot()` to be registered (globally or as a
+ * parent module).
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { BadRequestException, Controller, Delete, ForbiddenException, HttpCode, Inject, InternalServerErrorException, NotFoundException, Post, Param, Query, Req, UseGuards, } from '@nestjs/common';
+import { ApiCookieAuth, ApiTags } from '@nestjs/swagger';
+import Busboy from 'busboy';
+import { ForbiddenError, ResourceNotFoundError, } from '@modern-admin/core';
+import { MODERN_ADMIN, ModernAdminAuthGuard } from '@modern-admin/nest';
+import { UploadProviderRegistry } from '../registry.js';
+import { PendingUploadsRegistry } from '../pending-registry.js';
+import { UPLOAD_MODULE_OPTIONS } from './upload.tokens.js';
+/** Reads every file from a multipart/form-data stream using busboy. */
+function parseAllFiles(req) {
+    return new Promise((resolve, reject) => {
+        let bb;
+        try {
+            bb = Busboy({ headers: req.headers });
+        }
+        catch {
+            reject(new BadRequestException('Request is not multipart/form-data'));
+            return;
+        }
+        const files = [];
+        /** Number of streams that have started but not yet ended. */
+        let pending = 0;
+        let finished = false;
+        let settled = false;
+        let firstError;
+        const tryResolve = () => {
+            if (settled || !finished || pending > 0)
+                return;
+            settled = true;
+            if (firstError)
+                reject(firstError);
+            else if (files.length === 0)
+                reject(new BadRequestException('No file found in request body'));
+            else
+                resolve(files);
+        };
+        bb.on('file', (_fieldname, stream, info) => {
+            pending++;
+            const chunks = [];
+            stream.on('data', (chunk) => chunks.push(chunk));
+            stream.on('end', () => {
+                const buffer = Buffer.concat(chunks);
+                files.push({
+                    originalName: info.filename || 'upload',
+                    mimeType: info.mimeType || 'application/octet-stream',
+                    size: buffer.length,
+                    buffer,
+                });
+                pending--;
+                tryResolve();
+            });
+            stream.on('error', (err) => {
+                firstError = firstError ?? err;
+                pending--;
+                tryResolve();
+            });
+        });
+        bb.on('finish', () => {
+            finished = true;
+            tryResolve();
+        });
+        bb.on('error', (err) => {
+            firstError = firstError ?? err;
+            finished = true;
+            tryResolve();
+        });
+        req.pipe(bb);
+    });
+}
+let UploadController = class UploadController {
+    constructor(admin, moduleOptions) {
+        this.admin = admin;
+        this.moduleOptions = moduleOptions;
+    }
+    /**
+     * Upload one or more files for a specific resource property.
+     *
+     * @param resourceId  Admin resource id (e.g. `'users'`)
+     * @param field       Property path (e.g. `'avatar'` / `'gallery'`)
+     * @param req         Raw Express / Node.js `IncomingMessage`
+     */
+    async upload(resourceId, field, req) {
+        const { providerId, registered } = this.resolveProperty(resourceId, field);
+        // 1 — Parse the multipart body (collect every file).
+        const files = await parseAllFiles(req);
+        // 2 — If the property is single-value, only the first file is honoured.
+        //     The frontend sends one anyway; this is a safety bound.
+        const accepted = registered.isArray ? files : files.slice(0, 1);
+        // 3 — Upload each file, computing the storage key per-file so a custom
+        //     `uploadPath` generator can produce unique keys for each upload.
+        const ttlMs = this.moduleOptions.pendingTtlMs ?? 60 * 60 * 1000;
+        const results = [];
+        for (const file of accepted) {
+            const computedKey = registered.uploadPath ? registered.uploadPath(file.originalName) : undefined;
+            const key = await registered.provider.upload(file, computedKey);
+            // Track as pending — it will be confirmed by `new.after`/`edit.after`
+            // when the form is saved, or cleaned up by the sweeper when the TTL
+            // expires (whichever comes first).
+            PendingUploadsRegistry.track(key, providerId, ttlMs);
+            const url = await registered.provider.getUrl(key);
+            results.push({ key, url, name: file.originalName, size: file.size, mimeType: file.mimeType });
+        }
+        return results;
+    }
+    /**
+     * Cancel a still-pending upload — delete the file from storage immediately.
+     * Used by the editor when the user removes a file *before* saving the form.
+     *
+     * Returns 204 if the cancel succeeded, 404 if the key is not pending.
+     * The "not pending" branch protects already-persisted files: once a file
+     * has been confirmed via the action hooks it can no longer be removed via
+     * this endpoint — only via the regular edit/delete actions.
+     */
+    async cancel(resourceId, field, key) {
+        if (!key)
+            throw new BadRequestException('Missing "key" query parameter');
+        // Validate that the resource/field is actually upload-enabled. This avoids
+        // leaking the existence of arbitrary resource ids to unauthenticated callers
+        // (the auth guard already requires authentication).
+        this.resolveProperty(resourceId, field);
+        const cancelled = await PendingUploadsRegistry.cancel(key);
+        if (!cancelled) {
+            throw new NotFoundException('Key is not pending — already saved or unknown');
+        }
+    }
+    // ─── Internals ─────────────────────────────────────────────────────────────
+    /** Resolve the resource + property and ensure it is wired to an upload provider. */
+    resolveProperty(resourceId, field) {
+        let resource;
+        try {
+            resource = this.admin.findResource(resourceId);
+        }
+        catch (err) {
+            if (err instanceof ResourceNotFoundError)
+                throw new NotFoundException(err.message);
+            if (err instanceof ForbiddenError)
+                throw new ForbiddenException(err.message);
+            throw err;
+        }
+        const decorator = resource.decorate();
+        const prop = decorator.getPropertyByKey(field);
+        if (!prop) {
+            throw new NotFoundException(`Property "${field}" not found on resource "${resourceId}"`);
+        }
+        const propJson = prop.toJSON();
+        const providerId = propJson.custom?.uploadProviderId;
+        if (!providerId) {
+            throw new BadRequestException(`Property "${field}" on resource "${resourceId}" is not configured for upload. ` +
+                'Apply uploadFeature() to the resource.');
+        }
+        const registered = UploadProviderRegistry.get(providerId);
+        if (!registered) {
+            throw new InternalServerErrorException(`Upload provider "${providerId}" is not registered.`);
+        }
+        return { providerId, registered };
+    }
+};
+__decorate([
+    Post('upload'),
+    __param(0, Param('resourceId')),
+    __param(1, Query('field')),
+    __param(2, Req()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Function]),
+    __metadata("design:returntype", Promise)
+], UploadController.prototype, "upload", null);
+__decorate([
+    Delete('upload'),
+    HttpCode(204),
+    __param(0, Param('resourceId')),
+    __param(1, Query('field')),
+    __param(2, Query('key')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], UploadController.prototype, "cancel", null);
+UploadController = __decorate([
+    ApiTags('Admin / Uploads'),
+    ApiCookieAuth('session'),
+    Controller('admin/api/resources/:resourceId/actions'),
+    UseGuards(ModernAdminAuthGuard),
+    __param(0, Inject(MODERN_ADMIN)),
+    __param(1, Inject(UPLOAD_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Function, Object])
+], UploadController);
+export { UploadController };
+//# sourceMappingURL=upload.controller.js.map

package/dist/nest/upload.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.controller.js","sourceRoot":"","sources":["../../src/nest/upload.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;AAEH,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,MAAM,EACN,4BAA4B,EAC5B,iBAAiB,EACjB,IAAI,EACJ,KAAK,EACL,KAAK,EACL,GAAG,EACH,SAAS,GACV,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAExD,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EACL,cAAc,EACd,qBAAqB,GAEtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAuC,MAAM,oBAAoB,CAAA;AAG/F,uEAAuE;AACvE,SAAS,aAAa,CAAC,GAAoB;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,EAA6B,CAAA;QACjC,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAiC,EAAE,CAAC,CAAA;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,mBAAmB,CAAC,oCAAoC,CAAC,CAAC,CAAA;YACrE,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAmB,EAAE,CAAA;QAChC,6DAA6D;QAC7D,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,UAAmB,CAAA;QAEvB,MAAM,UAAU,GAAG,GAAS,EAAE;YAC5B,IAAI,OAAO,IAAI,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAM;YAC/C,OAAO,GAAG,IAAI,CAAA;YACd,IAAI,UAAU;gBAAE,MAAM,CAAC,UAAU,CAAC,CAAA;iBAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,CAAC,IAAI,mBAAmB,CAAC,+BAA+B,CAAC,CAAC,CAAA;;gBACxF,OAAO,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC,CAAA;QAED,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACzC,OAAO,EAAE,CAAA;YACT,MAAM,MAAM,GAAa,EAAE,CAAA;YAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;YACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBACpC,KAAK,CAAC,IAAI,CAAC;oBACT,YAAY,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;oBACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,0BAA0B;oBACrD,IAAI,EAAE,MAAM,CAAC,MAAM;oBACnB,MAAM;iBACP,CAAC,CAAA;gBACF,OAAO,EAAE,CAAA;gBACT,UAAU,EAAE,CAAA;YACd,CAAC,CAAC,CAAA;YACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,UAAU,GAAG,UAAU,IAAI,GAAG,CAAA;gBAC9B,OAAO,EAAE,CAAA;gBACT,UAAU,EAAE,CAAA;YACd,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACnB,QAAQ,GAAG,IAAI,CAAA;YACf,UAAU,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAY,EAAE,EAAE;YAC9B,UAAU,GAAG,UAAU,IAAI,GAAG,CAAA;YAC9B,QAAQ,GAAG,IAAI,CAAA;YACf,UAAU,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QAEF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC;AAMM,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YACyC,KAAkB,EACT,aAA6C;QADtD,UAAK,GAAL,KAAK,CAAa;QACT,kBAAa,GAAb,aAAa,CAAgC;IAC5F,CAAC;IAEJ;;;;;;OAMG;IAEG,AAAN,KAAK,CAAC,MAAM,CACW,UAAkB,EACvB,KAAa,EACtB,GAAoB;QAE3B,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QAE1E,qDAAqD;QACrD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QAEtC,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAE/D,uEAAuE;QACvE,sEAAsE;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;QAC/D,MAAM,OAAO,GAAuB,EAAE,CAAA;QACtC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAChG,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;YAC/D,sEAAsE;YACtE,oEAAoE;YACpE,mCAAmC;YACnC,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,CAAA;YACpD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC/F,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;;;;;OAQG;IAGG,AAAN,KAAK,CAAC,MAAM,CACW,UAAkB,EACvB,KAAa,EACf,GAAW;QAEzB,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,mBAAmB,CAAC,+BAA+B,CAAC,CAAA;QACxE,2EAA2E;QAC3E,6EAA6E;QAC7E,oDAAoD;QACpD,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,iBAAiB,CAAC,+CAA+C,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,oFAAoF;IAC5E,eAAe,CACrB,UAAkB,EAClB,KAAa;QAEb,IAAI,QAAoD,CAAA;QACxD,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,qBAAqB;gBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAClF,IAAI,GAAG,YAAY,cAAc;gBAAE,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAC5E,MAAM,GAAG,CAAA;QACX,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,iBAAiB,CAAC,aAAa,KAAK,4BAA4B,UAAU,GAAG,CAAC,CAAA;QAC1F,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,gBAAsC,CAAA;QAC1E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,mBAAmB,CAC3B,aAAa,KAAK,kBAAkB,UAAU,kCAAkC;gBAC9E,wCAAwC,CAC3C,CAAA;QACH,CAAC;QAED,MAAM,UAAU,GAAG,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACzD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,4BAA4B,CAAC,oBAAoB,UAAU,sBAAsB,CAAC,CAAA;QAC9F,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAA;IACnC,CAAC;CACF,CAAA;AA/FO;IADL,IAAI,CAAC,QAAQ,CAAC;IAEZ,WAAA,KAAK,CAAC,YAAY,CAAC,CAAA;IACnB,WAAA,KAAK,CAAC,OAAO,CAAC,CAAA;IACd,WAAA,GAAG,EAAE,CAAA;;;;8CA0BP;AAaK;IAFL,MAAM,CAAC,QAAQ,CAAC;IAChB,QAAQ,CAAC,GAAG,CAAC;IAEX,WAAA,KAAK,CAAC,YAAY,CAAC,CAAA;IACnB,WAAA,KAAK,CAAC,OAAO,CAAC,CAAA;IACd,WAAA,KAAK,CAAC,KAAK,CAAC,CAAA;;;;8CAWd;AAtEU,gBAAgB;IAJ5B,OAAO,CAAC,iBAAiB,CAAC;IAC1B,aAAa,CAAC,SAAS,CAAC;IACxB,UAAU,CAAC,yCAAyC,CAAC;IACrD,SAAS,CAAC,oBAAoB,CAAC;IAG3B,WAAA,MAAM,CAAC,YAAY,CAAC,CAAA;IACpB,WAAA,MAAM,CAAC,qBAAqB,CAAC,CAAA;;GAHrB,gBAAgB,CA6G5B"}