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

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.3",
+  "version": "4.0.0-alpha.30",
   "description": "TypeScript backend framework — DI Container, Filter Chain, EventBus, Provider Pattern",
   "type": "module",
   "main": "dist/index.js",
@@ -61,6 +61,10 @@
     "./migrations": {
       "import": "./dist/database/migrations/index.js",
       "types": "./dist/database/migrations/index.d.ts"
+    },
+    "./dev": {
+      "import": "./dist/dev/index.js",
+      "types": "./dist/dev/index.d.ts"
     }
   },
   "files": [
@@ -144,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",