@proteinjs/db-file-storage-driver-gcs 1.4.33 → 1.5.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.5.0](https://github.com/proteinjs/db/compare/@proteinjs/db-file-storage-driver-gcs@1.4.33...@proteinjs/db-file-storage-driver-gcs@1.5.0) (2026-09-25)
+
+
+### Bug Fixes
+
+* **db-file-storage-driver-gcs:** no storage-client error leaves the driver — its errors carried the access token ([ddb487a](https://github.com/proteinjs/db/commit/ddb487a42568a2a6b9221efc2a5a90d034edf9c9))
+* **file-storage-driver-gcs:** a byte overwrite keeps the object's content type and metadata — updateFileData restates the object's own content type, cache, disposition and language headers and its custom metadata (size restated for the new bytes), pinned to the generation it read ([d16bc4a](https://github.com/proteinjs/db/commit/d16bc4a104291005d8ea66979e3ddfef47b58f3f))
+
+
+### Features
+
+* **db-file-storage-driver-gcs:** an objectPrefix option — several deployments share one bucket, every operation names its object through one owner ([e739875](https://github.com/proteinjs/db/commit/e73987568322dacfc4fdcfd1a84d18b44240329a))
+
+
+
+
+
 ## [1.4.33](https://github.com/proteinjs/db/compare/@proteinjs/db-file-storage-driver-gcs@1.4.32...@proteinjs/db-file-storage-driver-gcs@1.4.33) (2026-09-24)
 
 **Note:** Version bump only for package @proteinjs/db-file-storage-driver-gcs

package/README.md

@@ -34,3 +34,17 @@ export class FileStorageDriverFactory implements DefaultFileStorageDriverFactory
   }
 }
 ```
+
+## Sharing one bucket
+
+Set `objectPrefix` to keep the files of several independent deployments apart inside one bucket. Every object the driver writes, reads, signs or deletes is named `<objectPrefix><file id>`, so one deployment's files can be listed or removed as a group by their prefix. The prefix is used verbatim — include the separator yourself.
+
+```typescript
+new GoogleCloudStorageDriver({
+  projectId: 'your-project-id',
+  bucketName: 'your-bucket-name',
+  objectPrefix: 'deployment-a/',
+});
+```
+
+Leave it unset and an object is named by the file id alone. Changing the prefix of a deployment that already holds files does not move them.

package/dist/generated/index.js

@@ -19,7 +19,7 @@ require("@proteinjs/db");
 require("@proteinjs/db-file");
 require("@proteinjs/logger");
 /** Generate Source Graph */
-var sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory\",\"value\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"DefaultGoogleCloudStorageConfigFactory\",\"filePath\":\"src/DefaultGoogleCloudStorageConfigFactory.ts\",\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory\",\"properties\":[],\"methods\":[{\"name\":\"getConfig\",\"returnType\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"GoogleCloudStorageConfig\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":true,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[]}],\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/reflection\",\"name\":\"Loadable\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/reflection/Loadable\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"sourceType\":3}},{\"v\":\"@proteinjs/reflection/Loadable\"},{\"v\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver\",\"value\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"GoogleCloudStorageDriver\",\"filePath\":\"src/GoogleCloudStorageDriver.ts\",\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"storage\",\"type\":{\"packageName\":\"@google-cloud/storage\",\"name\":\"Storage\",\"filePath\":null,\"qualifiedName\":\"@google-cloud/storage/Storage\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"bucketName\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"}],\"methods\":[{\"name\":\"createFile\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"file\",\"type\":{\"packageName\":\"@proteinjs/db-file\",\"name\":\"File\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/File\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"fileData\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getFileData\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<string>\",\"filePath\":null,\"qualifiedName\":\"/Promise<string>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"updateFileData\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"data\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"updateFile\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"file\",\"type\":{\"packageName\":\"@proteinjs/db-file\",\"name\":\"File\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/File\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getSignedUrl\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<string>\",\"filePath\":null,\"qualifiedName\":\"/Promise<string>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"options\",\"type\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"{ ttlMs?: number }\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/{ ttlMs?: number }\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"deleteFile\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getDefaultConfig\",\"returnType\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"GoogleCloudStorageConfig\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[]}],\"typeParameters\":[],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/db-file\",\"name\":\"FileStorageDriver\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/FileStorageDriver\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/db-file/FileStorageDriver\"}],\"edges\":[{\"v\":\"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory\",\"w\":\"@proteinjs/reflection/Loadable\",\"value\":\"extends interface\"},{\"v\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver\",\"w\":\"@proteinjs/db-file/FileStorageDriver\",\"value\":\"implements interface\"}]}";
+var sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory\",\"value\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"DefaultGoogleCloudStorageConfigFactory\",\"filePath\":\"src/DefaultGoogleCloudStorageConfigFactory.ts\",\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory\",\"properties\":[],\"methods\":[{\"name\":\"getConfig\",\"returnType\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"GoogleCloudStorageConfig\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":true,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[]}],\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/reflection\",\"name\":\"Loadable\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/reflection/Loadable\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"sourceType\":3}},{\"v\":\"@proteinjs/reflection/Loadable\"},{\"v\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver\",\"value\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"GoogleCloudStorageDriver\",\"filePath\":\"src/GoogleCloudStorageDriver.ts\",\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver\",\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"properties\":[{\"name\":\"storage\",\"type\":{\"packageName\":\"@google-cloud/storage\",\"name\":\"Storage\",\"filePath\":null,\"qualifiedName\":\"@google-cloud/storage/Storage\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"bucketName\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"},{\"name\":\"objectPrefix\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null},\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\"}],\"methods\":[{\"name\":\"createFile\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"file\",\"type\":{\"packageName\":\"@proteinjs/db-file\",\"name\":\"File\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/File\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"fileData\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getFileData\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<string>\",\"filePath\":null,\"qualifiedName\":\"/Promise<string>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"updateFileData\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"data\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"updateFile\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"file\",\"type\":{\"packageName\":\"@proteinjs/db-file\",\"name\":\"File\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/File\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getSignedUrl\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<string>\",\"filePath\":null,\"qualifiedName\":\"/Promise<string>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"options\",\"type\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"{ ttlMs?: number }\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/{ ttlMs?: number }\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"deleteFile\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<void>\",\"filePath\":null,\"qualifiedName\":\"/Promise<void>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"object\",\"returnType\":null,\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"guarded\",\"returnType\":{\"packageName\":\"\",\"name\":\"Promise<T>\",\"filePath\":null,\"qualifiedName\":\"/Promise<T>\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":true,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[{\"name\":\"operation\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"call\",\"type\":{\"packageName\":\"\",\"name\":\"() => Promise<T>\",\"filePath\":null,\"qualifiedName\":\"/() => Promise<T>\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"driverError\",\"returnType\":{\"packageName\":\"@proteinjs/db-file\",\"name\":\"FileStorageError\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/FileStorageError\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[{\"name\":\"operation\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"fileId\",\"type\":{\"packageName\":\"\",\"name\":\"string\",\"filePath\":null,\"qualifiedName\":\"/string\",\"typeParameters\":null,\"directParents\":null}},{\"name\":\"clientError\",\"type\":{\"packageName\":\"\",\"name\":\"unknown\",\"filePath\":null,\"qualifiedName\":\"/unknown\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"httpStatus\",\"returnType\":{\"packageName\":\"\",\"name\":\"number | undefined\",\"filePath\":null,\"qualifiedName\":\"/number | undefined\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[{\"name\":\"clientError\",\"type\":{\"packageName\":\"\",\"name\":\"unknown\",\"filePath\":null,\"qualifiedName\":\"/unknown\",\"typeParameters\":null,\"directParents\":null}}]},{\"name\":\"getDefaultConfig\",\"returnType\":{\"packageName\":\"@proteinjs/db-file-storage-driver-gcs\",\"name\":\"GoogleCloudStorageConfig\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":false,\"isStatic\":false,\"visibility\":\"private\",\"parameters\":[]}],\"typeParameters\":[],\"directParentInterfaces\":[{\"packageName\":\"@proteinjs/db-file\",\"name\":\"FileStorageDriver\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/db-file/FileStorageDriver\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"directParentClasses\":[],\"sourceType\":2}},{\"v\":\"@proteinjs/db-file/FileStorageDriver\"}],\"edges\":[{\"v\":\"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory\",\"w\":\"@proteinjs/reflection/Loadable\",\"value\":\"extends interface\"},{\"v\":\"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver\",\"w\":\"@proteinjs/db-file/FileStorageDriver\",\"value\":\"implements interface\"}]}";
 /** Generate Source Links */
 var GoogleCloudStorageDriver_1 = require("../src/GoogleCloudStorageDriver");
 var sourceLinks = {

package/dist/generated/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,yBAAuB;AACvB,8BAA4B;AAC5B,6BAA2B;AAG3B,4BAA4B;AAE5B,IAAM,WAAW,GAAG,4uNAA4uN,CAAC;AAGjwN,4BAA4B;AAE5B,4EAA2E;AAE3E,IAAM,WAAW,GAAG;IACnB,gEAAgE,EAAE,mDAAwB;CAC1F,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,yBAAuB;AACvB,8BAA4B;AAC5B,6BAA2B;AAG3B,4BAA4B;AAE5B,IAAM,WAAW,GAAG,q+SAAq+S,CAAC;AAG1/S,4BAA4B;AAE5B,4EAA2E;AAE3E,IAAM,WAAW,GAAG;IACnB,gEAAgE,EAAE,mDAAwB;CAC1F,CAAC;AAGF,kCAAkC;AAElC,oDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}

package/dist/src/DefaultGoogleCloudStorageConfigFactory.d.ts

@@ -4,6 +4,13 @@ export declare const getDefaultGoogleCloudStorageConfigFactory: () => DefaultGoo
 export type GoogleCloudStorageConfig = {
     bucketName: string;
     projectId: string;
+    /**
+     * Prepended, verbatim, to the name of every object this driver writes, reads, signs or deletes
+     * (`<objectPrefix><file id>`). Lets several independent deployments share one bucket while each
+     * deployment's files stay listable and removable as a group. Include the separator yourself
+     * (`'deployment-a/'`). Unset: an object is named by the file id alone.
+     */
+    objectPrefix?: string;
     storageOptions?: StorageOptions;
 };
 export interface DefaultGoogleCloudStorageConfigFactory extends Loadable {

package/dist/src/DefaultGoogleCloudStorageConfigFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultGoogleCloudStorageConfigFactory.d.ts","sourceRoot":"","sources":["../../src/DefaultGoogleCloudStorageConfigFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,eAAO,MAAM,yCAAyC,8CAGnD,CAAC;AAEJ,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,sCAAuC,SAAQ,QAAQ;IACtE,SAAS,IAAI,wBAAwB,CAAC;CACvC"}
+{"version":3,"file":"DefaultGoogleCloudStorageConfigFactory.d.ts","sourceRoot":"","sources":["../../src/DefaultGoogleCloudStorageConfigFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,eAAO,MAAM,yCAAyC,8CAGnD,CAAC;AAEJ,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,sCAAuC,SAAQ,QAAQ;IACtE,SAAS,IAAI,wBAAwB,CAAC;CACvC"}

package/dist/src/GoogleCloudStorageDriver.d.ts

@@ -1,8 +1,17 @@
 import { File, FileStorageDriver } from '@proteinjs/db-file';
 import { GoogleCloudStorageConfig } from './DefaultGoogleCloudStorageConfigFactory';
+/**
+ * ERRORS: every operation runs inside {@link GoogleCloudStorageDriver.guarded}, so what leaves this
+ * driver on a failure is a `FileStorageError` — a code, a plain message, the HTTP status — and
+ * never the storage client's own error. The client's error holds the request it made (`config`,
+ * `response.request`, `response.config`), and that request holds this driver's access token in its
+ * `Authorization` header: an application that logged the error it caught would write a live
+ * credential. A missing object is the `not-found` code on every read and overwrite.
+ */
 export declare class GoogleCloudStorageDriver implements FileStorageDriver {
     private storage;
     private bucketName;
+    private objectPrefix;
     constructor(config?: GoogleCloudStorageConfig);
     createFile(file: File, fileData: string): Promise<void>;
     getFileData(fileId: string): Promise<string>;
@@ -12,6 +21,24 @@ export declare class GoogleCloudStorageDriver implements FileStorageDriver {
         ttlMs?: number;
     }): Promise<string>;
     deleteFile(fileId: string): Promise<void>;
+    /**
+     * THE one place an object's name is decided (`<objectPrefix><file id>`): every operation
+     * addresses its object through here, so a configured prefix holds for all of them or none.
+     */
+    private object;
+    /**
+     * THE one door a storage-client call leaves through. Whatever the client throws is replaced by
+     * this driver's own error; nothing of the client's error object rides on it.
+     */
+    private guarded;
+    /**
+     * Reads exactly three plain facts off the client's error — an HTTP status, a connection error
+     * code, its message TEXT — and builds the driver's error from them. The client's error itself,
+     * its `config`, `request`, `response` and `errors` are never copied, wrapped or kept as a cause.
+     */
+    private driverError;
+    /** The client reports the HTTP status as its error's `code`; an upload's error carries it as `status` or on its `response`. */
+    private httpStatus;
     private getDefaultConfig;
 }
 //# sourceMappingURL=GoogleCloudStorageDriver.d.ts.map

package/dist/src/GoogleCloudStorageDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GoogleCloudStorageDriver.d.ts","sourceRoot":"","sources":["../../src/GoogleCloudStorageDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,wBAAwB,EAEzB,MAAM,0CAA0C,CAAC;AAMlD,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,CAAC,EAAE,wBAAwB;IAMvC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,OAAO,CAAC,gBAAgB;CAUzB"}
+{"version":3,"file":"GoogleCloudStorageDriver.d.ts","sourceRoot":"","sources":["../../src/GoogleCloudStorageDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,wBAAwB,EAEzB,MAAM,0CAA0C,CAAC;AASlD;;;;;;;GAOG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,CAAC,EAAE,wBAAwB;IAOvC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3D,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C;;;OAGG;IACH,OAAO,CAAC,MAAM;IAId;;;OAGG;YACW,OAAO;IAQrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAWnB,+HAA+H;IAC/H,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/src/GoogleCloudStorageDriver.js

@@ -49,36 +49,49 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoogleCloudStorageDriver = void 0;
 var storage_1 = require("@google-cloud/storage");
+var db_file_1 = require("@proteinjs/db-file");
 var DefaultGoogleCloudStorageConfigFactory_1 = require("./DefaultGoogleCloudStorageConfigFactory");
 /** Signed URLs are short-lived read capabilities minted per serve — long enough to load and seek
  *  a video, short enough that a leaked URL goes stale quickly. */
 var DEFAULT_SIGNED_URL_TTL_MS = 15 * 60 * 1000;
+/** Failures of the connection itself, as Node names them — the store was never reached. */
+var NETWORK_ERROR_CODES = ['ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND', 'EAI_AGAIN', 'EPIPE'];
+/**
+ * ERRORS: every operation runs inside {@link GoogleCloudStorageDriver.guarded}, so what leaves this
+ * driver on a failure is a `FileStorageError` — a code, a plain message, the HTTP status — and
+ * never the storage client's own error. The client's error holds the request it made (`config`,
+ * `response.request`, `response.config`), and that request holds this driver's access token in its
+ * `Authorization` header: an application that logged the error it caught would write a live
+ * credential. A missing object is the `not-found` code on every read and overwrite.
+ */
 var GoogleCloudStorageDriver = /** @class */ (function () {
     function GoogleCloudStorageDriver(config) {
-        var _a = config ? config : this.getDefaultConfig(), projectId = _a.projectId, bucketName = _a.bucketName, storageOptions = _a.storageOptions;
+        var _a = config ? config : this.getDefaultConfig(), projectId = _a.projectId, bucketName = _a.bucketName, objectPrefix = _a.objectPrefix, storageOptions = _a.storageOptions;
         this.storage = new storage_1.Storage(__assign(__assign({}, storageOptions), { projectId: projectId }));
         this.bucketName = bucketName;
+        this.objectPrefix = objectPrefix !== null && objectPrefix !== void 0 ? objectPrefix : '';
     }
     GoogleCloudStorageDriver.prototype.createFile = function (file, fileData) {
         return __awaiter(this, void 0, void 0, function () {
-            var bucket, gcsFile;
+            var gcsFile;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        bucket = this.storage.bucket(this.bucketName);
-                        gcsFile = bucket.file(file.id);
+                        gcsFile = this.object(file.id);
                         // The GCS object stores the file's TRUE bytes (the interface string is base64 transport).
                         // Raw bytes at rest are what make signed-URL serving correct: the browser reads the object
                         // directly, so base64 text at rest would corrupt every binary served that way.
-                        return [4 /*yield*/, gcsFile.save(Buffer.from(fileData, 'base64'), {
-                                metadata: {
-                                    contentType: file.type,
+                        return [4 /*yield*/, this.guarded('createFile', file.id, function () {
+                                return gcsFile.save(Buffer.from(fileData, 'base64'), {
                                     metadata: {
-                                        fileId: file.id,
-                                        fileName: file.name,
-                                        fileSize: file.size.toString(),
+                                        contentType: file.type,
+                                        metadata: {
+                                            fileId: file.id,
+                                            fileName: file.name,
+                                            fileSize: file.size.toString(),
+                                        },
                                     },
-                                },
+                                });
                             })];
                     case 1:
                         // The GCS object stores the file's TRUE bytes (the interface string is base64 transport).
@@ -96,8 +109,8 @@ var GoogleCloudStorageDriver = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        file = this.storage.bucket(this.bucketName).file(fileId);
-                        return [4 /*yield*/, file.download()];
+                        file = this.object(fileId);
+                        return [4 /*yield*/, this.guarded('getFileData', fileId, function () { return file.download(); })];
                     case 1:
                         fileContent = (_a.sent())[0];
                         return [2 /*return*/, fileContent.toString('base64')];
@@ -107,13 +120,31 @@ var GoogleCloudStorageDriver = /** @class */ (function () {
     };
     GoogleCloudStorageDriver.prototype.updateFileData = function (fileId, data) {
         return __awaiter(this, void 0, void 0, function () {
-            var file;
+            var gcsFile, bytes, existing;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        file = this.storage.bucket(this.bucketName).file(fileId);
-                        return [4 /*yield*/, file.save(Buffer.from(data, 'base64'))];
+                        gcsFile = this.object(fileId);
+                        bytes = Buffer.from(data, 'base64');
+                        return [4 /*yield*/, this.guarded('updateFileData', fileId, function () { return gcsFile.getMetadata(); })];
                     case 1:
+                        existing = (_a.sent())[0];
+                        return [4 /*yield*/, this.guarded('updateFileData', fileId, function () {
+                                return gcsFile.save(bytes, {
+                                    metadata: {
+                                        contentType: existing.contentType,
+                                        cacheControl: existing.cacheControl,
+                                        contentDisposition: existing.contentDisposition,
+                                        contentLanguage: existing.contentLanguage,
+                                        metadata: __assign(__assign({}, existing.metadata), { fileSize: bytes.length.toString() }),
+                                    },
+                                    // The metadata read and the byte write are two requests. Pinning the write to the
+                                    // generation that was read makes the pair one decision: an overwrite that raced another
+                                    // writer fails loudly instead of restating metadata that is no longer the object's.
+                                    preconditionOpts: { ifGenerationMatch: existing.generation },
+                                });
+                            })];
+                    case 2:
                         _a.sent();
                         return [2 /*return*/];
                 }
@@ -126,14 +157,16 @@ var GoogleCloudStorageDriver = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        gcsFile = this.storage.bucket(this.bucketName).file(file.id);
-                        return [4 /*yield*/, gcsFile.setMetadata({
-                                contentType: file.type,
-                                metadata: {
-                                    fileId: file.id,
-                                    fileName: file.name,
-                                    fileSize: file.size.toString(),
-                                },
+                        gcsFile = this.object(file.id);
+                        return [4 /*yield*/, this.guarded('updateFile', file.id, function () {
+                                return gcsFile.setMetadata({
+                                    contentType: file.type,
+                                    metadata: {
+                                        fileId: file.id,
+                                        fileName: file.name,
+                                        fileSize: file.size.toString(),
+                                    },
+                                });
                             })];
                     case 1:
                         _a.sent();
@@ -143,20 +176,22 @@ var GoogleCloudStorageDriver = /** @class */ (function () {
         });
     };
     GoogleCloudStorageDriver.prototype.getSignedUrl = function (fileId, options) {
-        var _a;
         return __awaiter(this, void 0, void 0, function () {
             var gcsFile, url;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
                     case 0:
-                        gcsFile = this.storage.bucket(this.bucketName).file(fileId);
-                        return [4 /*yield*/, gcsFile.getSignedUrl({
-                                version: 'v4',
-                                action: 'read',
-                                expires: Date.now() + ((_a = options === null || options === void 0 ? void 0 : options.ttlMs) !== null && _a !== void 0 ? _a : DEFAULT_SIGNED_URL_TTL_MS),
+                        gcsFile = this.object(fileId);
+                        return [4 /*yield*/, this.guarded('getSignedUrl', fileId, function () {
+                                var _a;
+                                return gcsFile.getSignedUrl({
+                                    version: 'v4',
+                                    action: 'read',
+                                    expires: Date.now() + ((_a = options === null || options === void 0 ? void 0 : options.ttlMs) !== null && _a !== void 0 ? _a : DEFAULT_SIGNED_URL_TTL_MS),
+                                });
                             })];
                     case 1:
-                        url = (_b.sent())[0];
+                        url = (_a.sent())[0];
                         return [2 /*return*/, url];
                 }
             });
@@ -168,10 +203,10 @@ var GoogleCloudStorageDriver = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        gcsFile = this.storage.bucket(this.bucketName).file(fileId);
+                        gcsFile = this.object(fileId);
                         // ignoreNotFound implements the driver contract's idempotency: a retried row delete must not
                         // wedge because a prior attempt already removed the blob. Every other failure throws loudly.
-                        return [4 /*yield*/, gcsFile.delete({ ignoreNotFound: true })];
+                        return [4 /*yield*/, this.guarded('deleteFile', fileId, function () { return gcsFile.delete({ ignoreNotFound: true }); })];
                     case 1:
                         // ignoreNotFound implements the driver contract's idempotency: a retried row delete must not
                         // wedge because a prior attempt already removed the blob. Every other failure throws loudly.
@@ -181,6 +216,63 @@ var GoogleCloudStorageDriver = /** @class */ (function () {
             });
         });
     };
+    /**
+     * THE one place an object's name is decided (`<objectPrefix><file id>`): every operation
+     * addresses its object through here, so a configured prefix holds for all of them or none.
+     */
+    GoogleCloudStorageDriver.prototype.object = function (fileId) {
+        return this.storage.bucket(this.bucketName).file("".concat(this.objectPrefix).concat(fileId));
+    };
+    /**
+     * THE one door a storage-client call leaves through. Whatever the client throws is replaced by
+     * this driver's own error; nothing of the client's error object rides on it.
+     */
+    GoogleCloudStorageDriver.prototype.guarded = function (operation, fileId, call) {
+        return __awaiter(this, void 0, void 0, function () {
+            var clientError_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, call()];
+                    case 1: return [2 /*return*/, _a.sent()];
+                    case 2:
+                        clientError_1 = _a.sent();
+                        throw this.driverError(operation, fileId, clientError_1);
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Reads exactly three plain facts off the client's error — an HTTP status, a connection error
+     * code, its message TEXT — and builds the driver's error from them. The client's error itself,
+     * its `config`, `request`, `response` and `errors` are never copied, wrapped or kept as a cause.
+     */
+    GoogleCloudStorageDriver.prototype.driverError = function (operation, fileId, clientError) {
+        var status = this.httpStatus(clientError);
+        var connectionFailed = NETWORK_ERROR_CODES.includes(clientError === null || clientError === void 0 ? void 0 : clientError.code);
+        var message = clientError === null || clientError === void 0 ? void 0 : clientError.message;
+        return new db_file_1.FileStorageError(connectionFailed ? 'unavailable' : db_file_1.FileStorageError.codeForStatus(status), "".concat(operation, " failed for file ").concat(fileId), { status: status, detail: typeof message === 'string' ? message : undefined });
+    };
+    /** The client reports the HTTP status as its error's `code`; an upload's error carries it as `status` or on its `response`. */
+    GoogleCloudStorageDriver.prototype.httpStatus = function (clientError) {
+        var _a, _b;
+        var candidate = clientError;
+        for (var _i = 0, _c = [
+            candidate === null || candidate === void 0 ? void 0 : candidate.code,
+            candidate === null || candidate === void 0 ? void 0 : candidate.status,
+            (_a = candidate === null || candidate === void 0 ? void 0 : candidate.response) === null || _a === void 0 ? void 0 : _a.status,
+            (_b = candidate === null || candidate === void 0 ? void 0 : candidate.response) === null || _b === void 0 ? void 0 : _b.statusCode,
+        ]; _i < _c.length; _i++) {
+            var value = _c[_i];
+            var status_1 = typeof value === 'string' && /^\d{3}$/.test(value) ? Number(value) : value;
+            if (typeof status_1 === 'number' && status_1 >= 100 && status_1 <= 599) {
+                return status_1;
+            }
+        }
+        return undefined;
+    };
     GoogleCloudStorageDriver.prototype.getDefaultConfig = function () {
         var defaultConfigFactory = (0, DefaultGoogleCloudStorageConfigFactory_1.getDefaultGoogleCloudStorageConfigFactory)();
         if (!defaultConfigFactory) {

package/dist/src/GoogleCloudStorageDriver.js.map

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

package/generated/index.ts

@@ -7,7 +7,7 @@ import '@proteinjs/logger';
 /** Generate Source Graph */
 
 const sourceGraph =
-  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory","value":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"DefaultGoogleCloudStorageConfigFactory","filePath":"src/DefaultGoogleCloudStorageConfigFactory.ts","qualifiedName":"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory","properties":[],"methods":[{"name":"getConfig","returnType":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"GoogleCloudStorageConfig","filePath":null,"qualifiedName":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":true,"isStatic":false,"visibility":"public","parameters":[]}],"typeParameters":[],"directParents":[{"packageName":"@proteinjs/reflection","name":"Loadable","filePath":null,"qualifiedName":"@proteinjs/reflection/Loadable","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"sourceType":3}},{"v":"@proteinjs/reflection/Loadable"},{"v":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver","value":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"GoogleCloudStorageDriver","filePath":"src/GoogleCloudStorageDriver.ts","qualifiedName":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"storage","type":{"packageName":"@google-cloud/storage","name":"Storage","filePath":null,"qualifiedName":"@google-cloud/storage/Storage","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"bucketName","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"}],"methods":[{"name":"createFile","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"file","type":{"packageName":"@proteinjs/db-file","name":"File","filePath":null,"qualifiedName":"@proteinjs/db-file/File","typeParameters":null,"directParents":null}},{"name":"fileData","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"getFileData","returnType":{"packageName":"","name":"Promise<string>","filePath":null,"qualifiedName":"/Promise<string>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"updateFileData","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"data","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"updateFile","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"file","type":{"packageName":"@proteinjs/db-file","name":"File","filePath":null,"qualifiedName":"@proteinjs/db-file/File","typeParameters":null,"directParents":null}}]},{"name":"getSignedUrl","returnType":{"packageName":"","name":"Promise<string>","filePath":null,"qualifiedName":"/Promise<string>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"options","type":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"{ ttlMs?: number }","filePath":null,"qualifiedName":"@proteinjs/db-file-storage-driver-gcs/{ ttlMs?: number }","typeParameters":null,"directParents":null}}]},{"name":"deleteFile","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"getDefaultConfig","returnType":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"GoogleCloudStorageConfig","filePath":null,"qualifiedName":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[]}],"typeParameters":[],"directParentInterfaces":[{"packageName":"@proteinjs/db-file","name":"FileStorageDriver","filePath":null,"qualifiedName":"@proteinjs/db-file/FileStorageDriver","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/db-file/FileStorageDriver"}],"edges":[{"v":"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory","w":"@proteinjs/reflection/Loadable","value":"extends interface"},{"v":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver","w":"@proteinjs/db-file/FileStorageDriver","value":"implements interface"}]}';
+  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory","value":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"DefaultGoogleCloudStorageConfigFactory","filePath":"src/DefaultGoogleCloudStorageConfigFactory.ts","qualifiedName":"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory","properties":[],"methods":[{"name":"getConfig","returnType":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"GoogleCloudStorageConfig","filePath":null,"qualifiedName":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":true,"isStatic":false,"visibility":"public","parameters":[]}],"typeParameters":[],"directParents":[{"packageName":"@proteinjs/reflection","name":"Loadable","filePath":null,"qualifiedName":"@proteinjs/reflection/Loadable","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"sourceType":3}},{"v":"@proteinjs/reflection/Loadable"},{"v":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver","value":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"GoogleCloudStorageDriver","filePath":"src/GoogleCloudStorageDriver.ts","qualifiedName":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver","isAbstract":false,"isStatic":false,"visibility":"public","properties":[{"name":"storage","type":{"packageName":"@google-cloud/storage","name":"Storage","filePath":null,"qualifiedName":"@google-cloud/storage/Storage","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"bucketName","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"},{"name":"objectPrefix","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null},"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private"}],"methods":[{"name":"createFile","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"file","type":{"packageName":"@proteinjs/db-file","name":"File","filePath":null,"qualifiedName":"@proteinjs/db-file/File","typeParameters":null,"directParents":null}},{"name":"fileData","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"getFileData","returnType":{"packageName":"","name":"Promise<string>","filePath":null,"qualifiedName":"/Promise<string>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"updateFileData","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"data","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"updateFile","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"file","type":{"packageName":"@proteinjs/db-file","name":"File","filePath":null,"qualifiedName":"@proteinjs/db-file/File","typeParameters":null,"directParents":null}}]},{"name":"getSignedUrl","returnType":{"packageName":"","name":"Promise<string>","filePath":null,"qualifiedName":"/Promise<string>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"options","type":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"{ ttlMs?: number }","filePath":null,"qualifiedName":"@proteinjs/db-file-storage-driver-gcs/{ ttlMs?: number }","typeParameters":null,"directParents":null}}]},{"name":"deleteFile","returnType":{"packageName":"","name":"Promise<void>","filePath":null,"qualifiedName":"/Promise<void>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"public","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"object","returnType":null,"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}}]},{"name":"guarded","returnType":{"packageName":"","name":"Promise<T>","filePath":null,"qualifiedName":"/Promise<T>","typeParameters":null,"directParents":null},"isAsync":true,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[{"name":"operation","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"call","type":{"packageName":"","name":"() => Promise<T>","filePath":null,"qualifiedName":"/() => Promise<T>","typeParameters":null,"directParents":null}}]},{"name":"driverError","returnType":{"packageName":"@proteinjs/db-file","name":"FileStorageError","filePath":null,"qualifiedName":"@proteinjs/db-file/FileStorageError","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[{"name":"operation","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"fileId","type":{"packageName":"","name":"string","filePath":null,"qualifiedName":"/string","typeParameters":null,"directParents":null}},{"name":"clientError","type":{"packageName":"","name":"unknown","filePath":null,"qualifiedName":"/unknown","typeParameters":null,"directParents":null}}]},{"name":"httpStatus","returnType":{"packageName":"","name":"number | undefined","filePath":null,"qualifiedName":"/number | undefined","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[{"name":"clientError","type":{"packageName":"","name":"unknown","filePath":null,"qualifiedName":"/unknown","typeParameters":null,"directParents":null}}]},{"name":"getDefaultConfig","returnType":{"packageName":"@proteinjs/db-file-storage-driver-gcs","name":"GoogleCloudStorageConfig","filePath":null,"qualifiedName":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageConfig","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":false,"isStatic":false,"visibility":"private","parameters":[]}],"typeParameters":[],"directParentInterfaces":[{"packageName":"@proteinjs/db-file","name":"FileStorageDriver","filePath":null,"qualifiedName":"@proteinjs/db-file/FileStorageDriver","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"directParentClasses":[],"sourceType":2}},{"v":"@proteinjs/db-file/FileStorageDriver"}],"edges":[{"v":"@proteinjs/db-file-storage-driver-gcs/DefaultGoogleCloudStorageConfigFactory","w":"@proteinjs/reflection/Loadable","value":"extends interface"},{"v":"@proteinjs/db-file-storage-driver-gcs/GoogleCloudStorageDriver","w":"@proteinjs/db-file/FileStorageDriver","value":"implements interface"}]}';
 
 /** Generate Source Links */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteinjs/db-file-storage-driver-gcs",
-  "version": "1.4.33",
+  "version": "1.5.0",
   "description": "File storage in Google Cloud Storage",
   "publishConfig": {
     "access": "public"
@@ -23,8 +23,8 @@
   },
   "dependencies": {
     "@google-cloud/storage": "7.11.2",
-    "@proteinjs/db": "^1.48.0",
-    "@proteinjs/db-file": "^1.8.4",
+    "@proteinjs/db": "^1.49.0",
+    "@proteinjs/db-file": "^1.9.0",
     "@proteinjs/logger": "^1.0.21",
     "@proteinjs/reflection": "^1.2.0"
   },
@@ -37,11 +37,12 @@
     "eslint": "8.57.0",
     "eslint-config-prettier": "9.1.0",
     "eslint-plugin-prettier": "5.1.3",
+    "google-auth-library": "^9.6.3",
     "jest": "29.7.0",
     "ts-jest": "29.1.1",
     "typescript": "5.2.2"
   },
   "main": "./dist/generated/index.js",
   "types": "./dist/generated/index.d.ts",
-  "gitHead": "ec3fd54430dde18afd406ec70eccd857492272a0"
+  "gitHead": "5ef7c5a2f3eb6ef3b774aa93cc74cc1754cfa011"
 }

package/src/DefaultGoogleCloudStorageConfigFactory.ts

@@ -9,6 +9,13 @@ export const getDefaultGoogleCloudStorageConfigFactory = () =>
 export type GoogleCloudStorageConfig = {
   bucketName: string;
   projectId: string;
+  /**
+   * Prepended, verbatim, to the name of every object this driver writes, reads, signs or deletes
+   * (`<objectPrefix><file id>`). Lets several independent deployments share one bucket while each
+   * deployment's files stay listable and removable as a group. Include the separator yourself
+   * (`'deployment-a/'`). Unset: an object is named by the file id alone.
+   */
+  objectPrefix?: string;
   storageOptions?: StorageOptions;
 };