@aws-cdk/aws-s3 - npm Package Compare versions

Comparing version 1.37.0 to 1.38.0

lib/bucket.d.ts

@@ -73,2 +73,11 @@ import * as events from '@aws-cdk/aws-events';
     /**
+     * The S3 URL of an S3 object. For example:
+     * @example s3://onlybucket
+     * @example s3://bucket/key
+     * @param key The S3 key of the object. If not specified, the S3 URL of the
+     *      bucket is returned.
+     * @returns an ObjectS3Url token
+     */
+    s3UrlForObject(key?: string): string;
+    /**
      * Returns an ARN that represents all objects within the bucket that match
@@ -344,2 +353,11 @@ * the key pattern specified. To represent all keys, specify ``"*"``.
     /**
+     * The S3 URL of an S3 object. For example:
+     * @example s3://onlybucket
+     * @example s3://bucket/key
+     * @param key The S3 key of the object. If not specified, the S3 URL of the
+     *      bucket is returned.
+     * @returns an ObjectS3Url token
+     */
+    s3UrlForObject(key?: string): string;
+    /**
      * Returns an ARN that represents all objects within the bucket that match
@@ -426,2 +444,3 @@ * the key pattern specified. To represent all keys, specify ``"*"``.
     grantPublicAccess(keyPrefix?: string, ...allowedActions: string[]): iam.Grant;
+    private buildUrl;
     private grant;
@@ -428,0 +447,0 @@ private isGranteeFromAnotherAccount;

package.json

 {
   "name": "@aws-cdk/aws-s3",
-  "version": "1.37.0",
+  "version": "1.38.0",
   "description": "CDK Constructs for AWS S3",
@@ -65,15 +65,15 @@ "main": "lib/index.js",
   "devDependencies": {
-    "@aws-cdk/assert": "1.37.0",
+    "@aws-cdk/assert": "1.38.0",
     "@types/nodeunit": "^0.0.30",
-    "cdk-build-tools": "1.37.0",
-    "cdk-integ-tools": "1.37.0",
-    "cfn2ts": "1.37.0",
+    "cdk-build-tools": "1.38.0",
+    "cdk-integ-tools": "1.38.0",
+    "cfn2ts": "1.38.0",
     "nodeunit": "^0.11.3",
-    "pkglint": "1.37.0"
+    "pkglint": "1.38.0"
   },
   "dependencies": {
-    "@aws-cdk/aws-events": "1.37.0",
-    "@aws-cdk/aws-iam": "1.37.0",
-    "@aws-cdk/aws-kms": "1.37.0",
-    "@aws-cdk/core": "1.37.0",
+    "@aws-cdk/aws-events": "1.38.0",
+    "@aws-cdk/aws-iam": "1.38.0",
+    "@aws-cdk/aws-kms": "1.38.0",
+    "@aws-cdk/core": "1.38.0",
     "constructs": "^3.0.2"
@@ -83,6 +83,6 @@ },
   "peerDependencies": {
-    "@aws-cdk/aws-events": "1.37.0",
-    "@aws-cdk/aws-iam": "1.37.0",
-    "@aws-cdk/aws-kms": "1.37.0",
-    "@aws-cdk/core": "1.37.0",
+    "@aws-cdk/aws-events": "1.38.0",
+    "@aws-cdk/aws-iam": "1.38.0",
+    "@aws-cdk/aws-kms": "1.38.0",
+    "@aws-cdk/core": "1.38.0",
     "constructs": "^3.0.2"
@@ -89,0 +89,0 @@ },

README.md

@@ -32,4 +32,6 @@ ## Amazon S3 Construct Library
    `arn:aws:s3:::bucket_name/Development/*`)
- * `urlForObject(key)` - the URL of an object within the bucket (i.e.
+ * `urlForObject(key)` - the HTTP URL of an object within the bucket (i.e.
    `https://s3.cn-north-1.amazonaws.com.cn/china-bucket/mykey`)
+ * `s3UrlForObject(key)` - the S3 URL of an object within the bucket (i.e.
+   `s3://bucket/mykey`)
 
@@ -36,0 +38,0 @@ ### Encryption

test/integ.bucket.url.lit.expected.json

@@ -39,4 +39,18 @@ {
       }
+    },
+    "S3ObjectURL": {
+      "Value": {
+        "Fn::Join": [
+          "",
+          [
+            "s3://",
+            {
+              "Ref": "MyBucketF68F3FF0"
+            },
+            "/myfolder/myfile.txt"
+          ]
+        ]
+      }
     }
   }
 }

test/integ.bucket.url.lit.js

@@ -14,2 +14,3 @@ "use strict";
         new cdk.CfnOutput(this, 'ObjectURL', { value: bucket.urlForObject('myfolder/myfile.txt') });
+        new cdk.CfnOutput(this, 'S3ObjectURL', { value: bucket.s3UrlForObject('myfolder/myfile.txt') });
         /// !hide
@@ -21,2 +22,2 @@ }
 app.synth();
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZWcuYnVja2V0LnVybC5saXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbnRlZy5idWNrZXQudXJsLmxpdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLHFDQUFxQztBQUNyQyw2QkFBNkI7QUFFN0IsTUFBTSxTQUFVLFNBQVEsR0FBRyxDQUFDLEtBQUs7SUFDL0IsWUFBWSxLQUFjLEVBQUUsRUFBVTtRQUNwQyxLQUFLLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBRWpCLFNBQVM7UUFDVCxNQUFNLE1BQU0sR0FBRyxJQUFJLEVBQUUsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRTtZQUM3QyxhQUFhLEVBQUUsR0FBRyxDQUFDLGFBQWEsQ0FBQyxPQUFPO1NBQ3pDLENBQUMsQ0FBQztRQUVILElBQUksR0FBRyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUUsV0FBVyxFQUFFLEVBQUUsS0FBSyxFQUFFLE1BQU0sQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDLENBQUM7UUFDekUsSUFBSSxHQUFHLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRSxXQUFXLEVBQUUsRUFBRSxLQUFLLEVBQUUsTUFBTSxDQUFDLFlBQVksQ0FBQyxxQkFBcUIsQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUM1RixTQUFTO0lBQ1gsQ0FBQztDQUNGO0FBRUQsTUFBTSxHQUFHLEdBQUcsSUFBSSxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUM7QUFDMUIsSUFBSSxTQUFTLENBQUMsR0FBRyxFQUFFLGlCQUFpQixDQUFDLENBQUM7QUFDdEMsR0FBRyxDQUFDLEtBQUssRUFBRSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgY2RrIGZyb20gJ0Bhd3MtY2RrL2NvcmUnO1xuaW1wb3J0ICogYXMgczMgZnJvbSAnLi4vbGliJztcblxuY2xhc3MgVGVzdFN0YWNrIGV4dGVuZHMgY2RrLlN0YWNrIHtcbiAgY29uc3RydWN0b3Ioc2NvcGU6IGNkay5BcHAsIGlkOiBzdHJpbmcpIHtcbiAgICBzdXBlcihzY29wZSwgaWQpO1xuXG4gICAgLy8vICFzaG93XG4gICAgY29uc3QgYnVja2V0ID0gbmV3IHMzLkJ1Y2tldCh0aGlzLCAnTXlCdWNrZXQnLCB7XG4gICAgICByZW1vdmFsUG9saWN5OiBjZGsuUmVtb3ZhbFBvbGljeS5ERVNUUk9ZLFxuICAgIH0pO1xuXG4gICAgbmV3IGNkay5DZm5PdXRwdXQodGhpcywgJ0J1Y2tldFVSTCcsIHsgdmFsdWU6IGJ1Y2tldC5idWNrZXRXZWJzaXRlVXJsIH0pO1xuICAgIG5ldyBjZGsuQ2ZuT3V0cHV0KHRoaXMsICdPYmplY3RVUkwnLCB7IHZhbHVlOiBidWNrZXQudXJsRm9yT2JqZWN0KCdteWZvbGRlci9teWZpbGUudHh0JykgfSk7XG4gICAgLy8vICFoaWRlXG4gIH1cbn1cblxuY29uc3QgYXBwID0gbmV3IGNkay5BcHAoKTtcbm5ldyBUZXN0U3RhY2soYXBwLCAnYXdzLWNkay1zMy11cmxzJyk7XG5hcHAuc3ludGgoKTtcbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZWcuYnVja2V0LnVybC5saXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbnRlZy5idWNrZXQudXJsLmxpdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLHFDQUFxQztBQUNyQyw2QkFBNkI7QUFFN0IsTUFBTSxTQUFVLFNBQVEsR0FBRyxDQUFDLEtBQUs7SUFDL0IsWUFBWSxLQUFjLEVBQUUsRUFBVTtRQUNwQyxLQUFLLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBRWpCLFNBQVM7UUFDVCxNQUFNLE1BQU0sR0FBRyxJQUFJLEVBQUUsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRTtZQUM3QyxhQUFhLEVBQUUsR0FBRyxDQUFDLGFBQWEsQ0FBQyxPQUFPO1NBQ3pDLENBQUMsQ0FBQztRQUVILElBQUksR0FBRyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUUsV0FBVyxFQUFFLEVBQUUsS0FBSyxFQUFFLE1BQU0sQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDLENBQUM7UUFDekUsSUFBSSxHQUFHLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRSxXQUFXLEVBQUUsRUFBRSxLQUFLLEVBQUUsTUFBTSxDQUFDLFlBQVksQ0FBQyxxQkFBcUIsQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUM1RixJQUFJLEdBQUcsQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLGFBQWEsRUFBRSxFQUFFLEtBQUssRUFBRSxNQUFNLENBQUMsY0FBYyxDQUFDLHFCQUFxQixDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ2hHLFNBQVM7SUFDWCxDQUFDO0NBQ0Y7QUFFRCxNQUFNLEdBQUcsR0FBRyxJQUFJLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQztBQUMxQixJQUFJLFNBQVMsQ0FBQyxHQUFHLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztBQUN0QyxHQUFHLENBQUMsS0FBSyxFQUFFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBjZGsgZnJvbSAnQGF3cy1jZGsvY29yZSc7XG5pbXBvcnQgKiBhcyBzMyBmcm9tICcuLi9saWInO1xuXG5jbGFzcyBUZXN0U3RhY2sgZXh0ZW5kcyBjZGsuU3RhY2sge1xuICBjb25zdHJ1Y3RvcihzY29wZTogY2RrLkFwcCwgaWQ6IHN0cmluZykge1xuICAgIHN1cGVyKHNjb3BlLCBpZCk7XG5cbiAgICAvLy8gIXNob3dcbiAgICBjb25zdCBidWNrZXQgPSBuZXcgczMuQnVja2V0KHRoaXMsICdNeUJ1Y2tldCcsIHtcbiAgICAgIHJlbW92YWxQb2xpY3k6IGNkay5SZW1vdmFsUG9saWN5LkRFU1RST1ksXG4gICAgfSk7XG5cbiAgICBuZXcgY2RrLkNmbk91dHB1dCh0aGlzLCAnQnVja2V0VVJMJywgeyB2YWx1ZTogYnVja2V0LmJ1Y2tldFdlYnNpdGVVcmwgfSk7XG4gICAgbmV3IGNkay5DZm5PdXRwdXQodGhpcywgJ09iamVjdFVSTCcsIHsgdmFsdWU6IGJ1Y2tldC51cmxGb3JPYmplY3QoJ215Zm9sZGVyL215ZmlsZS50eHQnKSB9KTtcbiAgICBuZXcgY2RrLkNmbk91dHB1dCh0aGlzLCAnUzNPYmplY3RVUkwnLCB7IHZhbHVlOiBidWNrZXQuczNVcmxGb3JPYmplY3QoJ215Zm9sZGVyL215ZmlsZS50eHQnKSB9KTtcbiAgICAvLy8gIWhpZGVcbiAgfVxufVxuXG5jb25zdCBhcHAgPSBuZXcgY2RrLkFwcCgpO1xubmV3IFRlc3RTdGFjayhhcHAsICdhd3MtY2RrLXMzLXVybHMnKTtcbmFwcC5zeW50aCgpO1xuIl19

test/test.bucket.d.ts

@@ -41,2 +41,3 @@ import { Test } from 'nodeunit';
     'more grants'(test: Test): void;
+    'grantDelete, with a KMS Key'(test: Test): void;
     'cross-stack permissions': {
@@ -48,2 +49,3 @@ 'in the same account and region'(test: Test): void;
     'urlForObject returns a token with the S3 URL of the token'(test: Test): void;
+    's3UrlForObject returns a token with the S3 URL of the token'(test: Test): void;
     grantPublicAccess: {
@@ -50,0 +52,0 @@ 'by default, grants s3:GetObject to all objects'(test: Test): void;

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

1402361

increased by1.53%

Number of package files

64

increased by4.92%

Lines of code

9321

increased by3.2%

Number of lines in readme file

260

increased by0.78%

Dependency changes

• + Added@aws-cdk/aws-events@1.38.0(transitive)

• + Added@aws-cdk/aws-iam@1.38.0(transitive)

• + Added@aws-cdk/aws-kms@1.38.0(transitive)

• + Added@aws-cdk/cloud-assembly-schema@1.38.0(transitive)

• + Added@aws-cdk/core@1.38.0(transitive)

• + Added@aws-cdk/cx-api@1.38.0(transitive)

• + Added@aws-cdk/region-info@1.38.0(transitive)

• - Removed@aws-cdk/aws-events@1.37.0(transitive)

• - Removed@aws-cdk/aws-iam@1.37.0(transitive)

• - Removed@aws-cdk/aws-kms@1.37.0(transitive)

• - Removed@aws-cdk/cloud-assembly-schema@1.37.0(transitive)

• - Removed@aws-cdk/core@1.37.0(transitive)

• - Removed@aws-cdk/cx-api@1.37.0(transitive)

• - Removed@aws-cdk/region-info@1.37.0(transitive)

• Updated@aws-cdk/aws-events@1.38.0

• Updated@aws-cdk/aws-iam@1.38.0

• Updated@aws-cdk/aws-kms@1.38.0

• Updated@aws-cdk/core@1.38.0