@onroad/core 4.0.0-alpha.29 → 4.0.0-alpha.30

package/README.md

@@ -1012,6 +1012,138 @@ Fix: disable `emitDecoratorMetadata`. @onroad/core uses only custom metadata key
 
 ---
 
+### Custom route service methods must extract params from `req` — not expect primitive arguments
+
+**`AbstractController` always calls custom service methods with the raw `(req, res)` objects.** It only extracts params for the five default CRUD methods (`create`, `read`, `readAll`, `update`, `delete`). Every method registered under `routes:` in the controller config receives `(req, res)` forwarded directly.
+
+If your service method signature expects primitive parameters (`id: number`, `dataInicio: string`, etc.), it will receive the `req` object instead — causing silent failures (empty queries, NaN ids, wrong SQL filters) because the framework does **not** throw, it just passes the wrong value.
+
+```ts
+// ❌ Wrong — service expects primitives; controller passes (req, res)
+// Controller calls: this.service.findByBetweenDates(req, res)
+async findByBetweenDates(dataInicio: string, dataFim: string) {
+  // dataInicio === req object → Sequelize WHERE clause receives an object → returns []
+  return this.repository.findAll({ where: { dataDeAbertura: { [Op.gte]: dataInicio } } })
+}
+```
+
+```ts
+// ✅ Correct — service extracts its own params from req
+async findByBetweenDates(req: any, res?: any) {
+  const dataInicio: string = req.params.dataInicio
+  const dataFim:    string = req.params.dataFim
+  return this.repository.findAll({ where: { dataDeAbertura: { [Op.gte]: dataInicio, [Op.lte]: dataFim } } })
+}
+```
+
+**Affected params by HTTP position:**
+
+| Source           | How to extract              |
+|------------------|-----------------------------|
+| Route param (`:id`) | `req.params.id`          |
+| Query string     | `req.query.field`           |
+| Request body     | `req.body.field`            |
+| Auth / identity  | `req.decoded.userId`        |
+
+> **Rule of thumb:** In a TypeRoad service, if the method is registered as a custom route, **the first argument is always `req`**. Never write `async myMethod(id: number)` for a method that is called through a route config key — always write `async myMethod(req: any, res?: any)` and extract from `req` internally.
+
+**Scope of impact in `teraprox-api-manutencao` (audit — 2025-04-05):**
+
+The following service methods were found with the wrong signature (primitive params instead of `req`). All calls through their controller routes were silently broken:
+
+| Service | Method | Broken params |
+|---------|--------|---------------|
+| `OrdemDeServicoService` | `findByBetweenDates` | `dataInicio`, `dataFim` — **fixed** |
+| `OrdemDeServicoService` | `findByRecursoBetweenDates` | `recursoId`, `dataInicio`, `dataFim` |
+| `OrdemDeServicoService` | `findByBranchIdBetweenDates` | `branchId`, `dataInicio`, `dataFim` |
+| `OrdemDeServicoService` | `findByRecursoId` | `recursoId` |
+| `OrdemDeServicoService` | `findMonitoramentoByCriticidade` | `criticidade` |
+| `OrdemDeServicoService` | `findByModoDeFalhaId` | `modoDeFalhaId` |
+| `OrdemDeServicoService` | `encerraOS` | `id`, `form` |
+| `OrdemDeServicoService` | `setStatusOs` | `id`, `form` |
+| `OrdemDeServicoService` | `setStatusOsBulk` | `osIds`, `status`, `extraData` |
+| `OrdemDeServicoService` | `iniciarOsBulk` | `osIds`, `status` |
+| `OrdemDeServicoService` | `addTarefaToOrdem` | `osId`, `tarefa` |
+| `OrdemDeServicoService` | `updateDescricaoOs` | `osId`, `descricao` |
+| `OrdemDeServicoService` | `shiftRecursoOs` | `osId`, `recId` |
+| `OrdemDeServicoService` | `findInspecoesBetweenDates` | `recursoId`, `dataInicio`, `dataFim` |
+| `OrdemDeServicoService` | `putAnexos` | `id`, `anexos` |
+| `OrdemDeServicoService` | `findOrdensInBatch` | `ids` |
+| `OrdemDeServicoService` | `loadOsForOcpMigration` | `osIds` |
+| `RecursoService` | `findRecursoFatherByRecursoId` | `recursoId` |
+| `RecursoService` | `findByTagDescription` | `tag` |
+| `RecursoService` | `findRecursoByTagId` | `tagId` |
+| `RecursoService` | `findParadasByRecursoId` | `recursoId` |
+| `RecursoService` | `findSemParadasByRecursoId` | `recursoId` |
+| `TarefaService` | `encerrarTarefa` | `id` |
+| `TarefaService` | `addUnidadeMaterialTarefa` | `tarefaId`, `form` |
+| `TarefaService` | `addObservacaoTarefa` | `tarefaId`, `form` |
+| `TarefaService` | `deleteObservacaoTarefa` | `justificativaId` |
+| `TarefaService` | `loadMultipleIds` | `tarefaIds` |
+| `TarefaService` | `removeAnexo` | `id`, `anexoKey` |
+| `SolicitacaoDeServicoService` | `shiftRecursoSs` | `ssId`, `recId` |
+| `SolicitacaoDeServicoService` | `aprovaSolicitacao` | `id`, `form` |
+| `SolicitacaoDeServicoService` | `reprovaSolicitacao` | `id`, `form` |
+| `SolicitacaoDeServicoService` | `updateDescricaoSs` | `ssId`, `descricao` |
+| `SolicitacaoDeServicoService` | `findByRecursoId` | `recursoId` |
+| `SolicitacaoDeServicoService` | `findBetweenDates` | `start`, `end` |
+| `SolicitacaoDeServicoService` | `putAnexos` | `id`, `anexos` |
+
+---
+
+### Custom route key name must exactly match the service method name
+
+When you register a custom route in the controller config, the key name is used **verbatim** as the service method name to call. If the service was later renamed (e.g. during a refactor), the controller silently returns `null` because the `typeof service[methodName] === 'function'` guard evaluates to `false`.
+
+```ts
+// ❌ Wrong — controller key "addModoDeFalhaOS" but service method is "addModoDeFalha"
+routes: { addModoDeFalhaOS: { method: "post", path: "/..." } }
+// → service.addModoDeFalhaOS is undefined → always returns null (no error thrown)
+```
+
+**Known mismatches in `teraprox-api-manutencao` (audit — 2025-04-05):**
+
+| Controller route key | Expected service method (by key) | Actual service method |
+|----------------------|-----------------------------------|-----------------------|
+| `addModoDeFalhaOS` | `addModoDeFalhaOS` | `addModoDeFalha` |
+| `updateTipoDeOrdem` | `updateTipoDeOrdem` | `setTipoOrdem` |
+| `updateTipoDeOrdemBulk` | `updateTipoDeOrdemBulk` | `setTipoOrdemBulk` |
+| `removeAnexo` | `removeAnexo` | `removeAnexoOs` |
+| `readConcluidasCount` | `readConcluidasCount` | `countTarefasConcluidas` |
+| `findPlanned` | `findPlanned` | `findPlannedOrdensBetweenDatesV2` |
+| `findPlannedV3` | `findPlannedV3` | `findPlannedOrdensBetweenDatesV3` |
+| `findPlannedAgregador` | `findPlannedAgregador` | `findPlannedOrdensWithAgregadores` |
+| `findRecorrenciaPlanned` | `findRecorrenciaPlanned` | `findPlannedOrdensFromRecorrenciaBetweenDates` |
+| `findAgregadorPlanned` | `findAgregadorPlanned` | `findPlannedOrdensFromAgregadorBetweenDates` |
+| `createInBulk` | `createInBulk` | `createInBulkOs` |
+| `findDashByOs` | `findDashByOs` | `findWithDashboardAssociation` |
+
+> Fix: either rename the service method to match the route key, or rename the route key to match the service method. Both sides must be in sync.
+
+---
+
+### `BelongsToMany` association returns `null` (not `[]`) when no records exist
+
+Sequelize's `BelongsToMany` association populates the association property with `null` (not an empty array) when no join-table records exist for a given entity. Any code that iterates over that property with `for...of` or `.forEach()` without a guard will throw `TypeError: x is not iterable`.
+
+```ts
+// ❌ Wrong — crashes with "TypeError: o.tarefas is not iterable" when OS has no tarefas
+for (const tarefa of o.tarefas) { ... }
+o.tarefas.forEach(...)
+o.tarefas.flatMap(...)
+```
+
+```ts
+// ✅ Correct — guard with nullish coalescing
+for (const tarefa of (o.tarefas ?? [])) { ... }
+;(o.tarefas ?? []).forEach(...)
+ordens.flatMap((o) => (o.tarefas ?? []).map(...))
+```
+
+> This was the direct cause of `TypeError: o.tarefas is not iterable` at `OrdemDeServicoService.buildTarefa` (line 235) and `findByBetweenDates`. Apply the same `?? []` guard to **all** `BelongsToMany` associations before iterating.
+
+---
+
 ## Migration Guide — Lessons Learned (v3 → v4)
 
 This section documents the key issues found while migrating `teraprox-api-user` from onRoad v3 to TypeRoad v4. Use this as a checklist when migrating other APIs (`api-manutencao`, `api-processo`, etc.).

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,3 @@
-export { StorageProvider } from "./StorageProvider.js";
+export { StorageProvider, type UploadOptions, type SignedUrlOptions, type ObjectMetadata } from "./StorageProvider.js";
+export { GCSStorageProvider } from "./GCSStorageProvider.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,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/storage/index.js

@@ -1,2 +1,3 @@
 export { StorageProvider } from "./StorageProvider.js";
+export { GCSStorageProvider } from "./GCSStorageProvider.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,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onroad/core",
-  "version": "4.0.0-alpha.29",
+  "version": "4.0.0-alpha.30",
   "description": "TypeScript backend framework — DI Container, Filter Chain, EventBus, Provider Pattern",
   "type": "module",
   "main": "dist/index.js",
@@ -148,6 +148,7 @@
     }
   },
   "devDependencies": {
+    "@google-cloud/storage": "^7.19.0",
     "@types/amqplib": "^0.10.0",
     "@types/express": "^5.0.0",
     "@types/node": "^22.0.0",