@_linked/s3 1.0.2 → 1.1.0

package/.github/workflows/ci.yml

@@ -8,23 +8,36 @@ on:
 jobs:
   build-and-test:
     name: Build & Test
-    # Skip CI on the automated Release PR created by changesets/action.
-    if: ${{ !(github.event.pull_request.base.ref == 'main' && github.head_ref == 'changeset-release/main') }}
     runs-on: ubuntu-latest
     steps:
+      - name: Detect Release PR
+        id: rpr
+        run: |
+          if [[ "${{ github.event.pull_request.head.ref }}" == "changeset-release/main" ]]; then
+            echo "is_release_pr=true" >> $GITHUB_OUTPUT
+            echo "Release PR from changesets/action detected — skipping build/test (auto-generated version+CHANGELOG only)."
+          else
+            echo "is_release_pr=false" >> $GITHUB_OUTPUT
+          fi
+
       - name: Checkout
+        if: steps.rpr.outputs.is_release_pr == 'false'
         uses: actions/checkout@v4
 
       - name: Setup Node.js
+        if: steps.rpr.outputs.is_release_pr == 'false'
         uses: actions/setup-node@v4
         with:
           node-version: 22.16.0
 
       - name: Install dependencies
+        if: steps.rpr.outputs.is_release_pr == 'false'
         run: npm ci --legacy-peer-deps
 
       - name: Build
+        if: steps.rpr.outputs.is_release_pr == 'false'
         run: npm run build
 
       - name: Test
+        if: steps.rpr.outputs.is_release_pr == 'false'
         run: npm test --if-present

package/.github/workflows/publish.yml

@@ -15,8 +15,20 @@ jobs:
       contents: write
       pull-requests: write
     steps:
+      # Author the changesets "Version Packages" PR as the org release App (not the default
+      # GITHUB_TOKEN) so its CI runs without a manual "Approve and run" gate. Requires the org
+      # App installed on this repo + org secrets RELEASE_APP_ID / RELEASE_APP_PRIVATE_KEY.
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -31,12 +43,35 @@ jobs:
         run: npm run build
 
       - name: Create release Pull Request or Publish
+        id: changesets
         uses: changesets/action@v1
         with:
           publish: npx changeset publish
           title: 'chore: release'
           commit: 'chore: release'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+
+      # When changesets opened/updated the version PR (rather than publishing), merge it so the
+      # release ships without a manual click. App token → the merge's push re-triggers this
+      # workflow, which then runs `changeset publish`. DIRECT-merge (not `--auto`): GitHub
+      # auto-merge ignores branch-protection review-bypass allowances; main is check-only so a
+      # direct merge lands once the required check is green — retry until then.
+      - name: Merge the version PR to publish
+        if: steps.changesets.outputs.hasChangesets == 'true' && steps.changesets.outputs.published != 'true'
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: |
+          pr=$(gh pr list --base main --head changeset-release/main --state open --json number --jq '.[0].number // empty')
+          if [ -z "$pr" ]; then echo "No open version PR (nothing to merge)."; exit 0; fi
+          for i in $(seq 1 40); do
+            if gh pr merge "$pr" --merge 2>/tmp/merge_err; then
+              echo "Merged version PR #$pr on attempt $i."
+              exit 0
+            fi
+            echo "Attempt $i/40: version PR #$pr not mergeable yet ($(tr -d '\n' < /tmp/merge_err)); waiting for the required check…"
+            sleep 15
+          done
+          echo "::warning::Version PR #$pr not merged after retries — merge it manually."

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @\_linked/s3
 
+## 1.1.0
+
+### Minor Changes
+
+- [`cb74e4c`](https://github.com/linked-cm/s3/commit/cb74e4c8e7bd4055b58e568b57aa74886a02b6cd) - ESM-only. Dropped the CommonJS build; ships ES modules only (`type: module`, no `require` export condition, no `lib/cjs`). Fixed the root `types` field. CJS consumers on Node 22+ can `require()` it (sync ESM) or use dynamic `import()`.
+
+## 1.0.3
+
+### Patch Changes
+
+- [#3](https://github.com/linked-cm/s3/pull/3) [`dfb0f0f`](https://github.com/linked-cm/s3/commit/dfb0f0f21e8fb460ed64f12f4486accdf0b78c5f) Thanks [@flyon](https://github.com/flyon)! - loadData: ESM-only JSON import — drop the dead CJS branch, add the `{ with: { type: 'json' } }` import attribute.
+
 ## 1.0.2
 
 ### Patch Changes

package/lib/esm/backend.js

@@ -0,0 +1,2 @@
+//import your providers here (providers only run in the backend)
+//# sourceMappingURL=backend.js.map

package/lib/esm/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/backend.ts"],"names":[],"mappings":"AAAA,gEAAgE"}

package/lib/esm/index.js

@@ -0,0 +1,12 @@
+import './types.js';
+import './ontologies/s3.js';
+//SHAPES FIRST
+import './shapes/S3Bucket.js';
+import './shapes/S3FileStore.js';
+// Old quad-store patterns — depend on N3FileStore/BackendStore (in modules_old)
+// import './shapes/S3FrontendStore.js';
+// import './shapes/S3FrontendStoreProvider.js';
+// import './shapes/S3QuadStore.js';
+//THEN COMPONENTS
+import './utils/accessUrl.js';
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AACpB,OAAO,oBAAoB,CAAC;AAE5B,cAAc;AACd,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,gFAAgF;AAChF,wCAAwC;AACxC,gDAAgD;AAChD,oCAAoC;AAEpC,iBAAiB;AACjB,OAAO,sBAAsB,CAAC"}

package/lib/esm/ontologies/s3.d.ts

@@ -16,23 +16,23 @@ export declare var loadData: () => Promise<{
         "rdfs:label": string;
     }[];
 }>;
-export declare var ns: (term: string) => import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var _self: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var Bucket: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var FileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var FrontendStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var QuadStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var bucket: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var endpoint: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var key: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-export declare var secret: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+export declare var ns: (term: string) => import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var _self: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var Bucket: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var FileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var FrontendStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var QuadStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var bucket: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var endpoint: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var key: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+export declare var secret: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
 export declare const s3: {
-    Bucket: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    FileStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    FrontendStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    QuadStore: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    bucket: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    endpoint: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    key: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
-    secret: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    Bucket: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    FileStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    FrontendStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    QuadStore: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    bucket: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    endpoint: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    key: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    secret: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
 };

package/lib/esm/ontologies/s3.js

@@ -0,0 +1,35 @@
+import { createNameSpace } from '@_linked/core/utils/NameSpace';
+import { linkedOntology } from '../package.js';
+import * as _this from './s3.js';
+export var loadData = () => {
+    //@ts-ignore
+    return import('../data/s3.json', { with: { type: 'json' } }).then((data) => data.default);
+};
+export var ns = createNameSpace('http://lincd.org/ont/s3/');
+export var _self = ns('');
+// Classes
+export var Bucket = ns('Bucket');
+export var FileStore = ns('FileStore');
+export var FrontendStore = ns('FrontendStore');
+export var QuadStore = ns('QuadStore');
+// Properties
+export var bucket = ns('bucket');
+export var endpoint = ns('endpoint');
+export var key = ns('key');
+export var secret = ns('secret');
+//An extra grouping object so all the entities can be accessed from the prefix/name
+export const s3 = {
+    // Classes
+    Bucket,
+    FileStore,
+    FrontendStore,
+    QuadStore,
+    // Properties
+    bucket,
+    endpoint,
+    key,
+    secret,
+};
+//Registers this ontology to LINCD.JS, so that data loading can be automated amongst other things
+linkedOntology(_this, ns, 's3', loadData, '../data/s3.json');
+//# sourceMappingURL=s3.js.map

package/lib/esm/ontologies/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../../src/ontologies/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,IAAI,QAAQ,GAAG,GAAG,EAAE;IACzB,YAAY;IACZ,OAAO,MAAM,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAC/D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CACvB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,IAAI,EAAE,GAAG,eAAe,CAAC,0BAA0B,CAAC,CAAC;AAE5D,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AAE1B,UAAU;AACV,MAAM,CAAC,IAAI,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AACjC,MAAM,CAAC,IAAI,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,CAAC,IAAI,aAAa,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;AAC/C,MAAM,CAAC,IAAI,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;AAEvC,aAAa;AACb,MAAM,CAAC,IAAI,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AACjC,MAAM,CAAC,IAAI,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAC3B,MAAM,CAAC,IAAI,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AAEjC,mFAAmF;AACnF,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,UAAU;IACV,MAAM;IACN,SAAS;IACT,aAAa;IACb,SAAS;IAET,aAAa;IACb,MAAM;IACN,QAAQ;IACR,GAAG;IACH,MAAM;CACP,CAAC;AAEF,iGAAiG;AACjG,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC"}

package/lib/esm/package.js

@@ -0,0 +1,3 @@
+import { linkedPackage } from '@_linked/core/utils/Package';
+export const { linkedShape, linkedUtil, linkedOntology, registerPackageExport, packageExports, packageName, } = linkedPackage('@_linked/s3');
+//# sourceMappingURL=package.js.map

package/lib/esm/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,CAAC,MAAM,EACX,WAAW,EACX,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,WAAW,GACZ,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC"}

package/lib/esm/shapes/S3Bucket.d.ts

@@ -20,7 +20,7 @@ export declare const createS3Client: (config?: S3ClientConfigInput) => S3Client;
  */
 export declare const s3Client: S3Client;
 export declare class S3Bucket extends Shape {
-    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
     protected _client: S3Client;
     label: string;
     private ensureKeyPromise;

package/lib/esm/shapes/S3Bucket.js

@@ -0,0 +1,277 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { CopyObjectCommand, CreateBucketCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsCommand, PutObjectCommand, S3Client, } from '@aws-sdk/client-s3';
+import { Shape } from '@_linked/core/shapes/Shape';
+import { s3 } from '../ontologies/s3.js';
+import { linkedShape } from '../package.js';
+export const endpoint = process.env.S3_BUCKET_ENDPOINT;
+/**
+ * Builds an S3 client from explicit config, falling back to legacy env vars.
+ * This enables multiple S3 stores in one process with independent credentials/endpoints.
+ */
+export const createS3Client = (config = {}) => {
+    var _a, _b, _c, _d, _e;
+    return new S3Client({
+        endpoint: (_a = config.endpoint) !== null && _a !== void 0 ? _a : process.env.S3_BUCKET_ENDPOINT,
+        // https://github.com/aws/aws-sdk-js-v3/issues/3392#issuecomment-1120027821
+        credentials: {
+            accessKeyId: (_b = config.accessKeyId) !== null && _b !== void 0 ? _b : process.env.AWS_ACCESS_KEY_ID,
+            secretAccessKey: (_c = config.secretAccessKey) !== null && _c !== void 0 ? _c : process.env.AWS_SECRET_ACCESS_KEY,
+        },
+        region: (_e = (_d = config.region) !== null && _d !== void 0 ? _d : process.env.AWS_REGION) !== null && _e !== void 0 ? _e : 'us-east-1',
+    });
+};
+/**
+ * Legacy singleton exported for backward compatibility. New code should prefer
+ * per-instance clients by passing config into S3Bucket/S3FileStore.
+ */
+export const s3Client = createS3Client();
+let S3Bucket = class S3Bucket extends Shape {
+    constructor(n, clientConfig) {
+        super(typeof n === 'string' ? null : n);
+        this.ensureKeyPromise = new Map();
+        if (typeof n === 'string') {
+            this.label = n;
+        }
+        this._client = createS3Client(clientConfig);
+    }
+    get endpoint() {
+        return this._client.config.endpoint.toString();
+    }
+    /**
+     * Delete an object from the bucket.
+     * @param key The key of the object to delete
+     * @param options Additional options to pass to the DeleteObjectCommand
+     * @returns The response from the DeleteObjectCommand
+     * @todo Batch delete, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html
+     */
+    async deleteObject(key, options) {
+        let bucketParams = {
+            Bucket: this.label,
+            Key: key,
+            ...options,
+        };
+        try {
+            const data = await this._client.send(new DeleteObjectCommand(bucketParams));
+            // console.log('Successfully deleted object ' + key);
+            return data;
+        }
+        catch (err) {
+            console.log('Could not delete object: ', err);
+        }
+    }
+    async copyObject(sourceKey, destinationKey, options) {
+        let bucketParams = {
+            Bucket: this.label,
+            Key: destinationKey,
+            CopySource: `${this.label}/${sourceKey}`,
+            ...options,
+        };
+        try {
+            const data = await this._client.send(new CopyObjectCommand(bucketParams));
+            // console.log('Successfully copied object ' + sourceKey + ' to ' + destinationKey);
+            return data.$metadata.httpStatusCode === 200;
+        }
+        catch (err) {
+            console.log('Could not copy object: ', err);
+        }
+    }
+    /**
+     * Put an object into the bucket.
+     *
+     * @param key The key of the object to PUT (i.e. file name)
+     * @param value The value of the object to PUT (i.e. file contents)
+     * @param options Additional options to pass to the PutObjectCommand
+     * @returns The response from the PutObjectCommand
+     */
+    async putObject(key, value, options) {
+        let bucketParams = {
+            Bucket: this.label,
+            Key: key,
+            Body: value,
+            ACL: 'public-read',
+            ...options,
+        };
+        try {
+            const data = await this._client.send(new PutObjectCommand(bucketParams));
+            // console.log(
+            //   'Successfully uploaded object: ' +
+            //     bucketParams.Bucket +
+            //     '/' +
+            //     bucketParams.Key,
+            // );
+            return data;
+        }
+        catch (err) {
+            console.log('Error', err);
+        }
+        return null;
+    }
+    /**
+     * Get a list of all object keys in the bucket.
+     * Important to note that only a maximum 1000 keys will be returned.
+     *
+     * @param prefix The prefix to search for in the bucket. This can be a folder or the beginning of a file name.
+     * @returns A list of all object keys in the bucket
+     * @todo Recursive search within directories
+     * @todo Implement pagination
+     */
+    async getAllObjectKeys(prefix = '') {
+        var _a;
+        let bucketParams = {
+            Bucket: this.label,
+            Prefix: prefix,
+        };
+        try {
+            const data = await this._client.send(new ListObjectsCommand(bucketParams));
+            return ((_a = data.Contents) === null || _a === void 0 ? void 0 : _a.map((object) => object.Key)) || [];
+        }
+        catch (err) {
+            console.log('Could not list bucket contents: ', err);
+            return Promise.reject(err);
+        }
+    }
+    /**
+     * Get the contents of an object in the bucket.
+     * @param key The key of the object to get
+     * @returns The contents of the object as a string
+     */
+    async getObject(key) {
+        let bucketParams = {
+            Bucket: this.label,
+            Key: key,
+        };
+        return new Promise(async (resolve, reject) => {
+            const getObjectCommand = new GetObjectCommand(bucketParams);
+            try {
+                const response = await this._client.send(getObjectCommand);
+                // let objectData = response.Body.toString();
+                // resolve(objectData);
+                //for future usecases: use this to stream data or use binary data,
+                // see https://stackoverflow.com/questions/36942442/how-to-get-response-from-s3-getobject-in-node-js
+                // // Store all of data chunks returned from the response data stream
+                // // into an array then use Array#join() to use the returned contents as a String
+                let responseDataChunks = [];
+                // let body:ReadableStream = response.Body as ReadableStream;
+                let body = response.Body;
+                // Handle an error while streaming the response body
+                body.once('error', (err) => reject(err));
+                // Attach a 'data' listener to add the chunks of data to our array
+                // Each chunk is a Buffer instance
+                body.on('data', (chunk) => responseDataChunks.push(chunk));
+                // Once the stream has no more data, join the chunks into a string and return the string
+                body.once('end', () => resolve(responseDataChunks.join('')));
+            }
+            catch (err) {
+                // Handle the error or throw
+                return reject(err);
+            }
+        });
+    }
+    /**
+     * Ensure that the given key exists in the bucket, the file contents
+     * will be an empty json object.
+     *
+     * @param key The key to insert if it does not exist
+     * @returns The promise that will resolve when the key exists
+     */
+    async ensureKeyExists(key) {
+        if (!this.ensureKeyPromise.has(key)) {
+            let promise = this._ensureKeyExists(key);
+            this.ensureKeyPromise.set(key, promise);
+        }
+        return this.ensureKeyPromise.get(key);
+    }
+    async _ensureKeyExists(key) {
+        let bucketParams = {
+            Bucket: this.label,
+            Key: key,
+        };
+        return new Promise(async (resolve, reject) => {
+            //see if the object already exists
+            try {
+                await this._client.send(new HeadObjectCommand(bucketParams));
+                resolve();
+            }
+            catch (error) {
+                if (error.name === 'NotFound') {
+                    // Note with v3 AWS-SDK use error.code
+                    //If the object does not exist, create it,
+                    // with the content being an empty json object
+                    try {
+                        await this._client.send(new PutObjectCommand({
+                            ...bucketParams,
+                            Body: JSON.stringify({}),
+                        }));
+                        // console.log(
+                        //   `Successfully created object "${bucketParams.Key}" in bucket ${bucketParams.Bucket}`,
+                        // );
+                        resolve();
+                    }
+                    catch (err) {
+                        if (err.name === 'NoSuchBucket') {
+                            await this.createBucket();
+                            await this._ensureKeyExists(key);
+                            resolve();
+                        }
+                        reject('Error putting object: ' + err);
+                    }
+                }
+                else {
+                    reject('Error checking existence of object: ' + error);
+                }
+            }
+        });
+    }
+    async keyExists(key) {
+        let bucketParams = {
+            Bucket: this.label,
+            Key: key,
+        };
+        return new Promise(async (resolve, reject) => {
+            //see if the object already exists
+            try {
+                await this._client.send(new HeadObjectCommand(bucketParams));
+                resolve(true);
+            }
+            catch (error) {
+                if (error.name === 'NotFound') {
+                    return false;
+                }
+                else {
+                    console.warn('Error checking existence of object: ' + error);
+                    return false;
+                }
+            }
+        });
+    }
+    /**
+     * Create the bucket if it does not exist.
+     * @returns The promise that will resolve when the bucket exists
+     */
+    async createBucket() {
+        let bucketParams = { Bucket: this.label };
+        try {
+            const data = await this._client.send(new CreateBucketCommand(bucketParams));
+            console.log('Successfully created bucket ' + this.label);
+            return data; // For unit tests.
+        }
+        catch (err) {
+            console.log('Could not create bucket: ', err);
+        }
+    }
+};
+S3Bucket.targetClass = s3.Bucket;
+S3Bucket = __decorate([
+    linkedShape,
+    __metadata("design:paramtypes", [Object, Object])
+], S3Bucket);
+export { S3Bucket };
+//# sourceMappingURL=S3Bucket.js.map

package/lib/esm/shapes/S3Bucket.js.map

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

package/lib/esm/shapes/S3FileStore.d.ts

@@ -9,7 +9,7 @@ export interface S3FileStoreConfig {
     clientConfig?: S3ClientConfigInput;
 }
 export declare class S3FileStore extends Shape implements IFileStore {
-    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
     label: string;
     private _bucket;
     private readonly config;