monastery 2.2.7 → 2.2.8

package/changelog.md

@@ -2,6 +2,8 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [2.2.8](https://github.com/boycce/monastery/compare/2.2.7...2.2.8) (2024-05-01)
+
 ### [2.2.7](https://github.com/boycce/monastery/compare/2.2.6...2.2.7) (2024-05-01)
 
 ### [2.2.6](https://github.com/boycce/monastery/compare/2.2.5...2.2.6) (2024-04-30)

package/docs/manager/index.md

@@ -54,6 +54,7 @@ monastery('localhost/mydb,192.168.1.1').then((db) => {
 - `manager.isId(String|ObjectId)`: Checks if the passed variable is a valid MongoDB ObjectId or ObjectId string
 - `manager.model()`: [see model](./model.html)
 - `manager.models()`: [see models](./models.html)
+- `manager.getSignedUrl(path, expires, bucket)`: You can sign AWS S3 paths using this image plugin helper
 
 ### Dates
 

package/lib/index.js

@@ -64,7 +64,8 @@ module.exports = function(uri, opts, fn) {
   }
 
   // Initiate any plugins
-  manager._getSignedUrl = manager.imagePluginFile._getSignedUrl
+
+manager.getSignedUrl = manager._getSignedUrl = manager.imagePluginFile.getSignedUrl
   if (manager.imagePlugin) {
     manager.imagePluginFile.setup(manager, util.isObject(manager.imagePlugin)? manager.imagePlugin : {})
   }

package/package.json

@@ -2,7 +2,7 @@
   "name": "monastery",
   "description": "⛪ A straight forward MongoDB ODM built around Monk",
   "author": "Ricky Boyce",
-  "version": "2.2.7",
+  "version": "2.2.8",
   "license": "MIT",
   "repository": "github:boycce/monastery",
   "homepage": "https://boycce.github.io/monastery/",

package/plugins/images/index.js

@@ -31,7 +31,7 @@ let plugin = module.exports = {
     this.bucketDir = options.bucketDir || 'full' // depreciated > 1.36.2
     this.filesize = options.filesize
     this.formats = options.formats || ['bmp', 'gif', 'jpg', 'jpeg', 'png', 'tiff']
-    this.getSignedUrl = options.getSignedUrl
+    this.getSignedUrlOption = options.getSignedUrl
     this.manager = manager
     this.metadata = options.metadata ? util.deepCopy(options.metadata) : undefined,
     this.params = options.params ? util.deepCopy(options.params) : {},
@@ -41,17 +41,18 @@ let plugin = module.exports = {
       throw new Error('Monastery imagePlugin: awsRegion, awsBucket, awsAccessKeyId, or awsSecretAccessKey is not defined')
     }
     if (!options.awsRegion) {
-      throw new Error('Monastery imagePlugin: v3 requires awsRegion to be defined for signing urls, e.g. "ap-southeast-2"')
+      throw new Error('Monastery imagePlugin: v3 requires awsRegion to be defined for signing urls, e.g. \'ap-southeast-2\'')
     }
 
     // Create s3 'service' instance (defer require since it takes 120ms to load)
     // v2: https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#constructor-property
     // v3: https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3/
     // v3 examples: https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/javascript_s3_code_examples.html
-    this.getS3Client = () => {
+    this.getS3Client = (useRegion) => {
       const { S3 } = require('@aws-sdk/client-s3')
-      return this._s3Client || (this._s3Client = new S3({
-        region: this.awsRegion,
+      const key  = useRegion ? '_s3ClientRegional' : '_s3Client'
+      return this[key] || (this[key] = new S3({
+        region: useRegion ? this.awsRegion : undefined,
         credentials: {
           accessKeyId: this.awsAccessKeyId,
           secretAccessKey: this.awsSecretAccessKey
@@ -230,11 +231,11 @@ let plugin = module.exports = {
     for (let doc of util.toArray(data)) {
       for (let imageField of this.imageFields) {
         if (options.getSignedUrls
-            || (util.isDefined(imageField.getSignedUrl) ? imageField.getSignedUrl : plugin.getSignedUrl)) {
+            || (util.isDefined(imageField.getSignedUrl) ? imageField.getSignedUrl : plugin.getSignedUrlOption)) {
           let images = plugin._findImagesInData(doc, imageField, 0, '').filter(o => o.image)
           // todo: we could do this in parallel
           for (let image of images) {
-            image.image.signedUrl = await plugin._getSignedUrl(image.image.path, 3600, imageField.awsBucket)
+            image.image.signedUrl = await plugin.getSignedUrl(image.image.path, 3600, imageField.awsBucket)
           }
         }
       }
@@ -589,24 +590,24 @@ let plugin = module.exports = {
     return list
   },
 
-  _getSignedUrl: async (path, expires=3600, bucket) => {
+  getSignedUrl: async (path, expires=3600, bucket) => {
     /**
      * @param {string} path - aws file path
      * @param {number} <expires> - seconds
-     * @param {number} <bucket>
+     * @param {string} <bucket>
      * @return {promise} signedUrl
      * @see v2: https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getSignedUrl-property
      * @see v3: https://github.com/aws/aws-sdk-js-v3/blob/main/UPGRADING.md#s3-presigned-url
      */
     if (!plugin.getS3Client) {
       throw new Error(
-        'To use db._getSignedUrl(), the imagePlugin manager option must be defined, e.g. `monastery(..., { imagePlugin })`'
+        'To use db.getSignedUrl(), the imagePlugin manager option must be defined, e.g. `monastery(..., { imagePlugin })`'
       )
     }
     const { GetObjectCommand } = require('@aws-sdk/client-s3')
     const params = { Bucket: bucket || plugin.awsBucket, Key: path }
     const command = new GetObjectCommand(params)
-    let signedUrl = await getSignedUrl(plugin.getS3Client(), command, { expiresIn: expires })
+    let signedUrl = await getSignedUrl(plugin.getS3Client(true), command, { expiresIn: expires })
     // console.log(signedUrl)
     return signedUrl
   },

package/test/plugin-images.js

@@ -642,7 +642,7 @@ module.exports = function(monastery, opendb) {
     expect(plugin.awsAcl).toEqual('public-read')
     expect(plugin.filesize).toEqual(undefined)
     expect(plugin.formats).toEqual(['bmp', 'gif', 'jpg', 'jpeg', 'png', 'tiff'])
-    expect(plugin.getSignedUrl).toEqual(undefined)
+    expect(plugin.getSignedUrlOption).toEqual(undefined)
     expect(plugin.metadata).toEqual(undefined)
     expect(plugin.path).toEqual(expect.any(Function))
     expect(plugin.params).toEqual({})
@@ -796,7 +796,7 @@ module.exports = function(monastery, opendb) {
       serverSelectionTimeoutMS: 2000,
       imagePlugin: {
         ...imagePluginFakeOpts,
-        awsRegion: 's3-ap-southeast-2',
+        awsRegion: 'ap-southeast-2',
         getSignedUrl: true,
       },
     })).db