@stacksjs/storage 0.74.32 → 0.74.33

package/dist/index.d.ts

@@ -38,7 +38,7 @@ export { serveFile } from './static-serve';
 export { Storage, StorageManager } from './facade';
 export { UploadedFile, uploadedFile, uploadedFiles } from './uploaded-file';
 // Filesystem type helpers
-export { backblazeDisk, configFromEnv, filebaseDisk, hetznerDisk, localDisk, r2Disk, s3Disk } from './types/filesystem';
+export { backblazeDisk, configFromEnv, filebaseDisk, gcsDisk, hetznerDisk, localDisk, r2Disk, s3Disk } from './types/filesystem';
 // Signed-URL helpers (used by Storage.disk('local').signedUrl())
 export {
   clearRevokedSignedStorageTokens,

package/dist/index.js

@@ -1 +1 @@
-export*from"./copy";export*from"./delete";export*from"./files";export*from"./folders";export*from"./fs";export*from"./glob";export*from"./hash";export*from"./helpers";export* as storage from"./storage";export*from"./zip";export{ensureBucket,ensureConfiguredBuckets}from"./provision";export*from"./adapters";export*from"./types";export*from"./drivers";export{serveFile}from"./static-serve";export{Storage,StorageManager}from"./facade";export{UploadedFile,uploadedFile,uploadedFiles}from"./uploaded-file";export{backblazeDisk,configFromEnv,filebaseDisk,hetznerDisk,localDisk,r2Disk,s3Disk}from"./types/filesystem";export{clearRevokedSignedStorageTokens,createSignedStorageToken,isSignedStorageTokenRevoked,revokeSignedStorageToken,verifySignedStorageToken}from"./signed-url";export{parseDiskPath,PathSanitizeError,sanitizePresignedDir,sanitizePresignedFilename}from"./path-sanitize";export{detectMimeFromMagicBytes,verifyUploadedMime}from"./mime-verify";export{signS3PresignedPost}from"./s3-presigned-post";
+export*from"./copy";export*from"./delete";export*from"./files";export*from"./folders";export*from"./fs";export*from"./glob";export*from"./hash";export*from"./helpers";export* as storage from"./storage";export*from"./zip";export{ensureBucket,ensureConfiguredBuckets}from"./provision";export*from"./adapters";export*from"./types";export*from"./drivers";export{serveFile}from"./static-serve";export{Storage,StorageManager}from"./facade";export{UploadedFile,uploadedFile,uploadedFiles}from"./uploaded-file";export{backblazeDisk,configFromEnv,filebaseDisk,gcsDisk,hetznerDisk,localDisk,r2Disk,s3Disk}from"./types/filesystem";export{clearRevokedSignedStorageTokens,createSignedStorageToken,isSignedStorageTokenRevoked,revokeSignedStorageToken,verifySignedStorageToken}from"./signed-url";export{parseDiskPath,PathSanitizeError,sanitizePresignedDir,sanitizePresignedFilename}from"./path-sanitize";export{detectMimeFromMagicBytes,verifyUploadedMime}from"./mime-verify";export{signS3PresignedPost}from"./s3-presigned-post";

package/dist/types/filesystem.d.ts

@@ -35,6 +35,33 @@ export declare function backblazeDisk(bucket: string, region: string, options?:
  * via `options.credentials` or the AWS_* env vars.
  */
 export declare function r2Disk(bucket: string, accountId: string, options?: Partial<Omit<S3DiskConfig, 'driver' | 'bucket'>>): S3DiskConfig;
+/**
+ * Helper to create a Google Cloud Storage disk config (stacksjs/stacks#1896).
+ *
+ * GCS publishes an S3-compatible XML API at `storage.googleapis.com`, which
+ * Google calls interoperability mode, so this reuses the `s3` adapter rather
+ * than pulling in `@google-cloud/storage`. That SDK is heavy, it brings its own
+ * auth-flow surface, and - the reason it never landed - there is no way to
+ * exercise it without a real Google account, which is a poor trade for the
+ * common case of reading and writing objects.
+ *
+ * Two things to know, because they are the ways this differs from a bucket you
+ * would drive with the official SDK:
+ *
+ * - **Credentials are HMAC keys, not a service account.** Create them under
+ *   Cloud Storage > Settings > Interoperability; a service-account JSON file
+ *   will not authenticate here. Supply them via `options.credentials` or the
+ *   AWS_* env vars, like every other S3-compatible disk.
+ * - **The interop API is a subset.** Object CRUD, listing and signed URLs work;
+ *   GCS-only features - resumable-upload sessions, object lifecycle management,
+ *   customer-managed encryption keys - do not, because they have no S3 verb. A
+ *   project needing those wants the official SDK and a dedicated adapter.
+ *
+ * `region` defaults to `auto`, which the interop endpoint accepts for a
+ * single-region or multi-region bucket alike. Pass the bucket's real location
+ * (`us-east1`, `europe-west4`) when you have configured one that requires it.
+ */
+export declare function gcsDisk(bucket: string, options?: Partial<Omit<S3DiskConfig, 'driver' | 'bucket'>>): S3DiskConfig;
 /**
  * Helper to create a Hetzner Object Storage disk config (stacksjs/stacks#1897).
  *

package/dist/types/filesystem.js

@@ -1 +1 @@
-export function localDisk(root,options){return{driver:"local",root,visibility:"private",...options}}export function s3Disk(bucket,options){return{driver:"s3",bucket,region:process.env.AWS_DEFAULT_REGION||"us-east-1",visibility:"private",...options}}export function filebaseDisk(bucket,options){return{driver:"s3",bucket,region:"us-east-1",endpoint:"https://s3.filebase.com",visibility:"private",...options}}export function backblazeDisk(bucket,region,options){return{driver:"s3",bucket,region,endpoint:`https://s3.${region}.backblazeb2.com`,visibility:"private",...options}}export function r2Disk(bucket,accountId,options){return{driver:"s3",bucket,region:"auto",endpoint:`https://${accountId}.r2.cloudflarestorage.com`,visibility:"private",...options}}export function hetznerDisk(bucket,location="fsn1",options){return{driver:"s3",bucket,region:location,endpoint:`https://${location}.your-objectstorage.com`,usePathStyleEndpoint:!0,visibility:"private",...options}}export function configFromEnv(base={}){const env=process.env;return{default:env.FILESYSTEM_DISK||base.default||"local",disks:{...base.disks,...env.AWS_ACCESS_KEY_ID&&env.AWS_BUCKET?{s3:{driver:"s3",bucket:env.AWS_BUCKET,region:env.AWS_DEFAULT_REGION||"us-east-1",endpoint:env.AWS_ENDPOINT,url:env.AWS_URL,usePathStyleEndpoint:env.AWS_USE_PATH_STYLE_ENDPOINT==="true",credentials:{key:env.AWS_ACCESS_KEY_ID,secret:env.AWS_SECRET_ACCESS_KEY||""}}}:{}}}}
+export function localDisk(root,options){return{driver:"local",root,visibility:"private",...options}}export function s3Disk(bucket,options){return{driver:"s3",bucket,region:process.env.AWS_DEFAULT_REGION||"us-east-1",visibility:"private",...options}}export function filebaseDisk(bucket,options){return{driver:"s3",bucket,region:"us-east-1",endpoint:"https://s3.filebase.com",visibility:"private",...options}}export function backblazeDisk(bucket,region,options){return{driver:"s3",bucket,region,endpoint:`https://s3.${region}.backblazeb2.com`,visibility:"private",...options}}export function r2Disk(bucket,accountId,options){return{driver:"s3",bucket,region:"auto",endpoint:`https://${accountId}.r2.cloudflarestorage.com`,visibility:"private",...options}}export function gcsDisk(bucket,options){return{driver:"s3",bucket,region:"auto",endpoint:"https://storage.googleapis.com",visibility:"private",...options}}export function hetznerDisk(bucket,location="fsn1",options){return{driver:"s3",bucket,region:location,endpoint:`https://${location}.your-objectstorage.com`,usePathStyleEndpoint:!0,visibility:"private",...options}}export function configFromEnv(base={}){const env=process.env;return{default:env.FILESYSTEM_DISK||base.default||"local",disks:{...base.disks,...env.AWS_ACCESS_KEY_ID&&env.AWS_BUCKET?{s3:{driver:"s3",bucket:env.AWS_BUCKET,region:env.AWS_DEFAULT_REGION||"us-east-1",endpoint:env.AWS_ENDPOINT,url:env.AWS_URL,usePathStyleEndpoint:env.AWS_USE_PATH_STYLE_ENDPOINT==="true",credentials:{key:env.AWS_ACCESS_KEY_ID,secret:env.AWS_SECRET_ACCESS_KEY||""}}}:{}}}}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/storage",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.32",
+  "version": "0.74.33",
   "description": "The Stacks file system.",
   "author": "Chris Breuer",
   "contributors": [
@@ -61,19 +61,19 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/arrays": "0.74.32",
-    "@stacksjs/cli": "0.74.32",
-    "@stacksjs/config": "0.74.32",
-    "@stacksjs/env": "0.74.32",
-    "@stacksjs/error-handling": "0.74.32",
-    "@stacksjs/logging": "0.74.32",
-    "@stacksjs/path": "0.74.32",
-    "@stacksjs/strings": "0.74.32",
+    "@stacksjs/arrays": "0.74.33",
+    "@stacksjs/cli": "0.74.33",
+    "@stacksjs/config": "0.74.33",
+    "@stacksjs/env": "0.74.33",
+    "@stacksjs/error-handling": "0.74.33",
+    "@stacksjs/logging": "0.74.33",
+    "@stacksjs/path": "0.74.33",
+    "@stacksjs/strings": "0.74.33",
     "@stacksjs/ts-cloud": "^0.12.15",
     "ts-images": "^0.2.11"
   },
   "devDependencies": {
-    "@stacksjs/types": "0.74.32",
+    "@stacksjs/types": "0.74.33",
     "better-dx": "^0.2.24"
   }
 }