@onroad/core 4.0.0-alpha.4 → 4.0.0-alpha.40

package/dist/storage/AnexoController.d.ts

@@ -0,0 +1,11 @@
+import { AbstractController } from "../core/AbstractController.js";
+import { AnexoService } from "./AnexoService.js";
+export declare class AnexoController extends AbstractController<AnexoService> {
+    constructor();
+    intent(req: unknown, res: unknown): Promise<void>;
+    confirm(req: unknown, res: unknown): Promise<void>;
+    readByData(req: unknown, res: unknown): Promise<void>;
+    signedUrl(req: unknown, res: unknown): Promise<void>;
+    delete(req: unknown, res: unknown): Promise<void>;
+}
+//# sourceMappingURL=AnexoController.d.ts.map

package/dist/storage/AnexoController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnexoController.d.ts","sourceRoot":"","sources":["../../src/storage/AnexoController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,qBACa,eAAgB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;;IAmC7D,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAKjE"}

package/dist/storage/AnexoController.js

@@ -0,0 +1,79 @@
+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);
+};
+import { Controller } from "../container/index.js";
+import { AbstractController } from "../core/AbstractController.js";
+import { AnexoService } from "./AnexoService.js";
+let AnexoController = class AnexoController extends AbstractController {
+    constructor() {
+        super({
+            service: AnexoService,
+            prefix: "anexo",
+            routes: {
+                intent: {
+                    method: "post",
+                    path: "/anexo/intent",
+                    hasMessagingEvent: false,
+                },
+                confirm: {
+                    method: "post",
+                    path: "/anexo/confirm",
+                    hasMessagingEvent: true,
+                },
+                readByData: {
+                    method: "post",
+                    path: "/anexo/readByData",
+                    hasMessagingEvent: false,
+                },
+                signedUrl: {
+                    method: "post",
+                    path: "/anexo/signedUrl",
+                    hasMessagingEvent: false,
+                },
+                delete: {
+                    method: "delete",
+                    path: "/anexo/:id",
+                    hasMessagingEvent: true,
+                },
+            },
+        });
+    }
+    async intent(req, res) {
+        const { body } = req;
+        const json = res.json.bind(res);
+        json(await this.service.createUploadIntent(body));
+    }
+    async confirm(req, res) {
+        const { body, sentinel } = req;
+        const json = res.json.bind(res);
+        json(await this.service.confirmUpload(body, sentinel));
+    }
+    async readByData(req, res) {
+        const { body } = req;
+        const json = res.json.bind(res);
+        json(await this.service.readByDataId(body.dataId, body.dataContext));
+    }
+    async signedUrl(req, res) {
+        const { body } = req;
+        const json = res.json.bind(res);
+        const url = await this.service.getSignedUrl(body.key);
+        json({ signedUrl: url });
+    }
+    async delete(req, res) {
+        const { params, query } = req;
+        const json = res.json.bind(res);
+        json(await this.service.delete(Number(params.id), query?.key));
+    }
+};
+AnexoController = __decorate([
+    Controller("/"),
+    __metadata("design:paramtypes", [])
+], AnexoController);
+export { AnexoController };
+//# sourceMappingURL=AnexoController.js.map

package/dist/storage/AnexoController.js.map

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

package/dist/storage/AnexoEntity.d.ts

@@ -0,0 +1,12 @@
+export declare class Anexo {
+    key: string;
+    author: string;
+    dataContext: string;
+    fileType: string;
+    dataId: string;
+    originalName: string;
+    contentType: string;
+    size: number;
+    bucket: string;
+}
+//# sourceMappingURL=AnexoEntity.d.ts.map

package/dist/storage/AnexoEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnexoEntity.d.ts","sourceRoot":"","sources":["../../src/storage/AnexoEntity.ts"],"names":[],"mappings":"AAEA,qBACa,KAAK;IAEhB,GAAG,EAAG,MAAM,CAAA;IAGZ,MAAM,EAAG,MAAM,CAAA;IAGf,WAAW,EAAG,MAAM,CAAA;IAGpB,QAAQ,EAAG,MAAM,CAAA;IAGjB,MAAM,EAAG,MAAM,CAAA;IAGf,YAAY,EAAG,MAAM,CAAA;IAGrB,WAAW,EAAG,MAAM,CAAA;IAGpB,IAAI,EAAG,MAAM,CAAA;IAGb,MAAM,EAAG,MAAM,CAAA;CAChB"}

package/dist/storage/AnexoEntity.js

@@ -0,0 +1,62 @@
+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);
+};
+import { Entity, Column, DataType } from "../entity/index.js";
+let Anexo = class Anexo {
+    key;
+    author;
+    dataContext;
+    fileType;
+    dataId;
+    originalName;
+    contentType;
+    size;
+    bucket;
+};
+__decorate([
+    Column({ type: DataType.STRING, allowNull: false }),
+    __metadata("design:type", String)
+], Anexo.prototype, "key", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "author", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "dataContext", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "fileType", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "dataId", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "originalName", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "contentType", void 0);
+__decorate([
+    Column({ type: DataType.INTEGER }),
+    __metadata("design:type", Number)
+], Anexo.prototype, "size", void 0);
+__decorate([
+    Column({ type: DataType.STRING }),
+    __metadata("design:type", String)
+], Anexo.prototype, "bucket", void 0);
+Anexo = __decorate([
+    Entity("anexo", { engine: "sequelize", timestamps: true })
+], Anexo);
+export { Anexo };
+//# sourceMappingURL=AnexoEntity.js.map

package/dist/storage/AnexoEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnexoEntity.js","sourceRoot":"","sources":["../../src/storage/AnexoEntity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAGtD,IAAM,KAAK,GAAX,MAAM,KAAK;IAEhB,GAAG,CAAS;IAGZ,MAAM,CAAS;IAGf,WAAW,CAAS;IAGpB,QAAQ,CAAS;IAGjB,MAAM,CAAS;IAGf,YAAY,CAAS;IAGrB,WAAW,CAAS;IAGpB,IAAI,CAAS;IAGb,MAAM,CAAS;CAChB,CAAA;AAzBC;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;;kCACxC;AAGZ;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;qCACnB;AAGf;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;0CACd;AAGpB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;uCACjB;AAGjB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;qCACnB;AAGf;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;2CACb;AAGrB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;0CACd;AAGpB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;;mCACtB;AAGb;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;;qCACnB;AA1BJ,KAAK;IADjB,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;GAC9C,KAAK,CA2BjB"}

package/dist/storage/AnexoRepository.d.ts

@@ -0,0 +1,5 @@
+import { SequelizeRepository } from "../core/SequelizeRepository.js";
+import { Anexo } from "./AnexoEntity.js";
+export declare class AnexoRepository extends SequelizeRepository<Anexo> {
+}
+//# sourceMappingURL=AnexoRepository.d.ts.map

package/dist/storage/AnexoRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnexoRepository.d.ts","sourceRoot":"","sources":["../../src/storage/AnexoRepository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAExC,qBACa,eAAgB,SAAQ,mBAAmB,CAAC,KAAK,CAAC;CAAG"}

package/dist/storage/AnexoRepository.js

@@ -0,0 +1,16 @@
+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;
+};
+import { Repository } from "../container/index.js";
+import { SequelizeRepository } from "../core/SequelizeRepository.js";
+import { Anexo } from "./AnexoEntity.js";
+let AnexoRepository = class AnexoRepository extends SequelizeRepository {
+};
+AnexoRepository = __decorate([
+    Repository({ entity: Anexo })
+], AnexoRepository);
+export { AnexoRepository };
+//# sourceMappingURL=AnexoRepository.js.map

package/dist/storage/AnexoRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnexoRepository.js","sourceRoot":"","sources":["../../src/storage/AnexoRepository.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAGjC,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,mBAA0B;CAAG,CAAA;AAArD,eAAe;IAD3B,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;GACjB,eAAe,CAAsC"}

package/dist/storage/AnexoService.d.ts

@@ -0,0 +1,56 @@
+import { AbstractService } from "../core/AbstractService.js";
+import { Sentinel } from "../core/Sentinel.js";
+import { StorageProvider } from "./StorageProvider.js";
+import { AnexoRepository } from "./AnexoRepository.js";
+export declare class AnexoService extends AbstractService<AnexoRepository> {
+    protected storage: StorageProvider;
+    constructor();
+    /** Lazily initialise the StorageProvider. Override to use a custom provider. */
+    protected getStorage(): Promise<StorageProvider>;
+    /** Allow external configuration of the storage provider. */
+    setStorageProvider(provider: StorageProvider): void;
+    createUploadIntent(payload: {
+        fileName: string;
+        contentType: string;
+        dataId: number;
+        dataContext: string;
+    }): Promise<{
+        uploadUrl: string;
+        key: string;
+        dataId: number;
+        dataContext: string;
+        fileName: string;
+        contentType: string;
+    }>;
+    confirmUpload(payload: {
+        key: string;
+        dataId: number;
+        dataContext: string;
+        fileName: string;
+        contentType: string;
+    }, sentinel?: Sentinel): Promise<{
+        id: number;
+        dataValues?: Record<string, unknown>;
+    }>;
+    create(form: Record<string, unknown>, sentinel?: Sentinel): Promise<{
+        id: number;
+        dataValues?: Record<string, unknown>;
+    }>;
+    /**
+     * Read anexos by dataId + dataContext, enriching each with a signed read URL.
+     * Overrides AbstractService.read so downstream callers work transparently.
+     */
+    read(dataId: unknown, ...args: unknown[]): Promise<unknown>;
+    readByDataId(dataId: number, dataContext: string): Promise<Record<string, unknown>[]>;
+    readAnexosInBatch(dataIds: number[], dataContext: string): Promise<Map<string, unknown[]>>;
+    delete(id: number, key?: string): Promise<unknown>;
+    /** @deprecated Use the upload intent flow instead. */
+    createByData(anexos: Array<{
+        buffer: Buffer;
+        originalname: string;
+        mimetype: string;
+    }>, dataId: number, dataContext: string, sentinel?: Sentinel): Promise<void>;
+    findByKey(key: string): Promise<unknown>;
+    getSignedUrl(key: string): Promise<string>;
+}
+//# sourceMappingURL=AnexoService.d.ts.map

package/dist/storage/AnexoService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnexoService.d.ts","sourceRoot":"","sources":["../../src/storage/AnexoService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAItD,qBACa,YAAa,SAAQ,eAAe,CAAC,eAAe,CAAC;IAChE,SAAS,CAAC,OAAO,EAAG,eAAe,CAAA;;IAMnC,gFAAgF;cAChE,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAQtD,4DAA4D;IAC5D,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI7C,kBAAkB,CAAC,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,WAAW,EAAE,MAAM,CAAA;KACpB;;;;;;;;IAsBK,aAAa,CACjB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,EAAE,MAAM,CAAA;QACd,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;KACpB,EACD,QAAQ,CAAC,EAAE,QAAQ;YAaK,MAAM;qBAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;IASvD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ;YAEhE,MAAM;qBACG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;IAQxC;;;OAGG;IACY,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAQjD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IA6BhD,iBAAiB,CACrB,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IA6BnB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAc9C,sDAAsD;IAChD,YAAY,CAChB,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EACzE,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,QAAQ;IAyBf,SAAS,CAAC,GAAG,EAAE,MAAM;IAIrB,YAAY,CAAC,GAAG,EAAE,MAAM;CAI/B"}

package/dist/storage/AnexoService.js

@@ -0,0 +1,182 @@
+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);
+};
+import { Service } from "../container/index.js";
+import { AbstractService } from "../core/AbstractService.js";
+import { MatchingObject } from "../messaging/index.js";
+import { getRequestContext } from "../context/RequestContext.js";
+import { AnexoRepository } from "./AnexoRepository.js";
+const ANEXO_CONTEXT = "anexos";
+let AnexoService = class AnexoService extends AbstractService {
+    storage;
+    constructor() {
+        super({ repository: AnexoRepository });
+    }
+    /** Lazily initialise the StorageProvider. Override to use a custom provider. */
+    async getStorage() {
+        if (!this.storage) {
+            const { GCSStorageProvider } = await import("./GCSStorageProvider.js");
+            this.storage = new GCSStorageProvider(process.env.GCS_BUCKET || "teraprox-storage");
+        }
+        return this.storage;
+    }
+    /** Allow external configuration of the storage provider. */
+    setStorageProvider(provider) {
+        this.storage = provider;
+    }
+    async createUploadIntent(payload) {
+        const { tenant } = getRequestContext();
+        const { fileName, contentType, dataId, dataContext } = payload;
+        const storage = await this.getStorage();
+        const key = storage.buildObjectKey({
+            tenant,
+            dataContext,
+            originalName: fileName,
+            contentType,
+            author: "system",
+        });
+        const url = await storage.generateSignedUrl(key, {
+            action: "write",
+            contentType,
+            expiresMs: 3600_000,
+        });
+        return { uploadUrl: url, key, dataId, dataContext, fileName, contentType };
+    }
+    async confirmUpload(payload, sentinel) {
+        const storage = await this.getStorage();
+        const metadata = await storage.getObjectMetadata(payload.key);
+        const anexo = (await this.repository.create({
+            key: payload.key,
+            dataId: payload.dataId,
+            dataContext: payload.dataContext,
+            originalName: payload.fileName,
+            contentType: payload.contentType,
+            size: metadata?.size ?? 0,
+            author: "system",
+        }));
+        sentinel?.appendMo(new MatchingObject(ANEXO_CONTEXT, "registroDeTarefaForm", { content: anexo }));
+        return anexo;
+    }
+    async create(form, sentinel) {
+        const anexo = (await this.repository.create(form));
+        sentinel?.appendMo(new MatchingObject(ANEXO_CONTEXT, "registroDeTarefaForm", { content: anexo }));
+        return anexo;
+    }
+    /**
+     * Read anexos by dataId + dataContext, enriching each with a signed read URL.
+     * Overrides AbstractService.read so downstream callers work transparently.
+     */
+    async read(dataId, ...args) {
+        const dataContext = args[0];
+        if (dataContext) {
+            return this.readByDataId(dataId, dataContext);
+        }
+        return super.read(dataId);
+    }
+    async readByDataId(dataId, dataContext) {
+        try {
+            const anexos = (await this.repository.findAll({
+                where: { dataId: String(dataId), dataContext },
+            }));
+            return await Promise.all(anexos.map(async (anexo) => {
+                const data = (anexo.dataValues ?? anexo);
+                try {
+                    const s = await this.getStorage();
+                    data.signedUrl = await s.generateSignedUrl(data.key, {
+                        action: "read",
+                    });
+                }
+                catch {
+                    data.signedUrl = null;
+                }
+                return data;
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async readAnexosInBatch(dataIds, dataContext) {
+        const anexosMap = new Map();
+        try {
+            const stringIds = dataIds.map(String);
+            const anexos = (await this.repository.findAll({
+                where: { dataId: stringIds, dataContext },
+            }));
+            for (const anexo of anexos) {
+                const data = (anexo.dataValues ?? anexo);
+                const dId = String(data.dataId);
+                try {
+                    const s = await this.getStorage();
+                    data.signedUrl = await s.generateSignedUrl(data.key, {
+                        action: "read",
+                    });
+                }
+                catch {
+                    data.signedUrl = null;
+                }
+                const current = anexosMap.get(dId);
+                if (current)
+                    current.push(data);
+                else
+                    anexosMap.set(dId, [data]);
+            }
+        }
+        catch {
+            // anexo table unavailable
+        }
+        return anexosMap;
+    }
+    async delete(id, key) {
+        let anexoId = id;
+        if (!id && key) {
+            const anexo = (await this.findByKey(key));
+            if (!anexo)
+                return false;
+            anexoId = anexo.id;
+        }
+        if (key) {
+            const storage = await this.getStorage();
+            await storage.deleteObject(key);
+        }
+        return await this.repository.destroy(anexoId);
+    }
+    /** @deprecated Use the upload intent flow instead. */
+    async createByData(anexos, dataId, dataContext, sentinel) {
+        const { tenant } = getRequestContext();
+        const author = sentinel?.req?.decoded?.userName ??
+            "unknown";
+        for (const anx of anexos) {
+            const { buffer, originalname, mimetype } = anx;
+            const storage = await this.getStorage();
+            const key = storage.buildObjectKey({
+                tenant,
+                dataContext,
+                originalName: originalname,
+                contentType: mimetype,
+                author,
+            });
+            await storage.upload("", key, buffer, mimetype);
+            await this.create({ key, originalName: originalname, mimetype, dataContext, dataId, author }, sentinel);
+        }
+    }
+    async findByKey(key) {
+        return await this.repository.findOne({ where: { key } });
+    }
+    async getSignedUrl(key) {
+        const storage = await this.getStorage();
+        return await storage.generateSignedUrl(key, { action: "read" });
+    }
+};
+AnexoService = __decorate([
+    Service(),
+    __metadata("design:paramtypes", [])
+], AnexoService);
+export { AnexoService };
+//# sourceMappingURL=AnexoService.js.map

package/dist/storage/AnexoService.js.map

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

package/dist/storage/GCSStorageProvider.d.ts

@@ -0,0 +1,15 @@
+import { StorageProvider, UploadOptions, SignedUrlOptions, ObjectMetadata } from "./StorageProvider.js";
+export declare class GCSStorageProvider extends StorageProvider {
+    private storage;
+    private bucketName;
+    constructor(bucketName: string);
+    buildObjectKey(opts: UploadOptions): string;
+    generateSignedUrl(key: string, opts: SignedUrlOptions): Promise<string>;
+    getObjectMetadata(key: string): Promise<ObjectMetadata | null>;
+    deleteObject(key: string): Promise<void>;
+    upload(_bucketName: string, _filePath: string, _data: Buffer, _contentType?: string): Promise<string>;
+    download(_bucketName: string, _filePath: string): Promise<Buffer>;
+    delete(_bucketName: string, filePath: string): Promise<void>;
+    getSignedUrl(_bucketName: string, filePath: string, expiresMs: number): Promise<string>;
+}
+//# sourceMappingURL=GCSStorageProvider.d.ts.map

package/dist/storage/GCSStorageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GCSStorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/GCSStorageProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEvG,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAQ;gBAEd,UAAU,EAAE,MAAM;IAM9B,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAMrC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvE,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAY9D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGrG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGjE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG5D,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG9F"}

package/dist/storage/GCSStorageProvider.js

@@ -0,0 +1,58 @@
+import { Storage } from "@google-cloud/storage";
+import { randomUUID } from "node:crypto";
+import { StorageProvider } from "./StorageProvider.js";
+export class GCSStorageProvider extends StorageProvider {
+    storage;
+    bucketName;
+    constructor(bucketName) {
+        super();
+        this.storage = new Storage(); // ADC - Assumes Cloud Run SA context
+        this.bucketName = bucketName;
+    }
+    buildObjectKey(opts) {
+        const uuid = randomUUID();
+        const safeName = opts.originalName.replace(/[^a-zA-Z0-9._-]/g, "_");
+        return `${opts.tenant}/${opts.dataContext}/${uuid}/${safeName}`;
+    }
+    async generateSignedUrl(key, opts) {
+        const file = this.storage.bucket(this.bucketName).file(key);
+        const defaultExpiry = opts.action === "write" ? 15 * 60_000 : 60 * 60_000;
+        const expires = opts.expiresMs ?? defaultExpiry;
+        const [url] = await file.getSignedUrl({
+            version: "v4",
+            action: opts.action,
+            expires: Date.now() + expires,
+            ...(opts.contentType && { contentType: opts.contentType }),
+        });
+        return url;
+    }
+    async getObjectMetadata(key) {
+        try {
+            const [metadata] = await this.storage.bucket(this.bucketName).file(key).getMetadata();
+            return {
+                size: Number(metadata.size),
+                contentType: metadata.contentType ?? ""
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async deleteObject(key) {
+        await this.storage.bucket(this.bucketName).file(key).delete({ ignoreNotFound: true });
+    }
+    // Deprecated stubs to satisfy abstract class until full migration
+    async upload(_bucketName, _filePath, _data, _contentType) {
+        throw new Error("GCSStorageProvider.upload is deprecated. Use client-side direct upload via generateSignedUrl.");
+    }
+    async download(_bucketName, _filePath) {
+        throw new Error("GCSStorageProvider.download is deprecated. Use client-side fetch via generateSignedUrl.");
+    }
+    async delete(_bucketName, filePath) {
+        return this.deleteObject(filePath);
+    }
+    async getSignedUrl(_bucketName, filePath, expiresMs) {
+        return this.generateSignedUrl(filePath, { action: "read", expiresMs });
+    }
+}
+//# sourceMappingURL=GCSStorageProvider.js.map

package/dist/storage/GCSStorageProvider.js.map

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

package/dist/storage/StorageProvider.d.ts

@@ -1,7 +1,35 @@
+export interface UploadOptions {
+    tenant: string;
+    dataContext: string;
+    originalName: string;
+    contentType: string;
+    author: string;
+}
+export interface SignedUrlOptions {
+    action: "read" | "write";
+    contentType?: string;
+    expiresMs?: number;
+}
+export interface ObjectMetadata {
+    size: number;
+    contentType: string;
+}
 export declare abstract class StorageProvider {
+    /** Generates a signed URL for reading or writing. */
+    abstract generateSignedUrl(key: string, opts: SignedUrlOptions): Promise<string>;
+    /** Retrieves object metadata (size, content-type) from storage. */
+    abstract getObjectMetadata(key: string): Promise<ObjectMetadata | null>;
+    /** Deletes an object from storage. */
+    abstract deleteObject(key: string): Promise<void>;
+    /** Builds a standardized object key: {tenant}/{dataContext}/{uuid}/{fileName} */
+    abstract buildObjectKey(opts: UploadOptions): string;
+    /** @deprecated Use generateSignedUrl for read or direct client-side upload */
     abstract upload(bucketName: string, filePath: string, data: Buffer, contentType?: string): Promise<string>;
+    /** @deprecated Use generateSignedUrl and fetch client-side */
     abstract download(bucketName: string, filePath: string): Promise<Buffer>;
+    /** @deprecated Use deleteObject */
     abstract delete(bucketName: string, filePath: string): Promise<void>;
+    /** @deprecated Use generateSignedUrl */
     abstract getSignedUrl(bucketName: string, filePath: string, expiresMs: number): Promise<string>;
 }
 //# sourceMappingURL=StorageProvider.d.ts.map

package/dist/storage/StorageProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":"AAAA,8BAAsB,eAAe;IACnC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1G,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACxE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAChG"}
+{"version":3,"file":"StorageProvider.d.ts","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,8BAAsB,eAAe;IACnC,qDAAqD;IACrD,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhF,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAEvE,sCAAsC;IACtC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjD,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAEpD,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1G,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACxE,mCAAmC;IACnC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpE,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAChG"}

package/dist/storage/StorageProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageProvider.js","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,eAAe;CAKpC"}
+{"version":3,"file":"StorageProvider.js","sourceRoot":"","sources":["../../src/storage/StorageProvider.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAgB,eAAe;CAqBpC"}

package/dist/storage/index.d.ts

@@ -1,2 +1,6 @@
-export { StorageProvider } from "./StorageProvider.js";
+export { StorageProvider, type UploadOptions, type SignedUrlOptions, type ObjectMetadata } from "./StorageProvider.js";
+export { Anexo } from "./AnexoEntity.js";
+export { AnexoRepository } from "./AnexoRepository.js";
+export { AnexoService } from "./AnexoService.js";
+export { AnexoController } from "./AnexoController.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACtH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/storage/index.js

@@ -1,2 +1,6 @@
 export { StorageProvider } from "./StorageProvider.js";
+export { Anexo } from "./AnexoEntity.js";
+export { AnexoRepository } from "./AnexoRepository.js";
+export { AnexoService } from "./AnexoService.js";
+export { AnexoController } from "./AnexoController.js";
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkE,MAAM,sBAAsB,CAAA;AACtH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}