docs/sdks/s3/js: move examples into separate files

The examples have also been amended to explain themselves better
and have all been tested to ensure they work.

Author: Xe

docs/sdks/s3/aws-go-sdk.mdx

@@ -20,7 +20,7 @@ ListObjectsV2, and GetObject.
 
 import gettingStarted from "!!raw-loader!../../../examples/go/cmd/getting-started/main.go";
 
-<CodeBlock language="go">{gettingStarted}</CodeBlock>;
+<CodeBlock language="go">{gettingStarted}</CodeBlock>
 
 Run it with:
 
@@ -38,7 +38,7 @@ since it was read.
 
 import conditionalOperations from "!!raw-loader!../../../examples/go/cmd/conditional-operations/main.go";
 
-<CodeBlock language="go">{conditionalOperations}</CodeBlock>;
+<CodeBlock language="go">{conditionalOperations}</CodeBlock>
 
 Run it with:
 
@@ -52,7 +52,7 @@ Presigned URLs can be used with the AWS Go SDK as follows:
 
 import presignedUrls from "!!raw-loader!../../../examples/go/cmd/presigned-urls/main.go";
 
-<CodeBlock language="go">{presignedUrls}</CodeBlock>;
+<CodeBlock language="go">{presignedUrls}</CodeBlock>
 
 You can now use the URL returned by the `presignedPutReq.URL` and
 `presignedGetReq.URL` to upload or download objects.
@@ -70,7 +70,7 @@ Below is an example of how to use the AWS Go SDK to restrict
 
 import objectRegions from "!!raw-loader!../../../examples/go/cmd/object-regions/main.go";
 
-<CodeBlock language="go">{objectRegions}</CodeBlock>;
+<CodeBlock language="go">{objectRegions}</CodeBlock>
 
 Run it with:
 
@@ -85,7 +85,7 @@ Below is an example of how to use
 
 import metadataQuerying from "!!raw-loader!../../../examples/go/cmd/metadata-querying/main.go";
 
-<CodeBlock language="go">{metadataQuerying}</CodeBlock>;
+<CodeBlock language="go">{metadataQuerying}</CodeBlock>
 
 ## Object Notifications
 
@@ -96,4 +96,4 @@ so you can take action when an object is created or deleted.
 
 import webhook from "!!raw-loader!../../../examples/go/cmd/webhook/main.go";
 
-<CodeBlock language="go">{webhook}</CodeBlock>;
+<CodeBlock language="go">{webhook}</CodeBlock>

docs/sdks/s3/aws-js-sdk.md

@@ -0,0 +1,32 @@
+# AWS JavaScript SDK
+
+import CodeBlock from "@theme/CodeBlock";
+
+This guide assumes that you have followed the steps in the
+[Getting Started](/docs/get-started/index.md) guide, and have the access keys
+available.
+
+You may continue to use the AWS JS SDK as you normally would, but with the
+endpoint set to `https://fly.storage.tigris.dev`.
+
+## Getting started
+
+This example uses the
+[AWS Node.js SDK v3](https://www.npmjs.com/package/@aws-sdk/client-s3) and reads
+the default credentials file or the environment variables `AWS_ACCESS_KEY_ID`
+and `AWS_SECRET_ACCESS_KEY`.
+
+import gettingStarted from "!!raw-loader!../../../examples/js/getting-started.js";
+
+<CodeBlock language="js">{gettingStarted}</CodeBlock>
+
+## Using presigned URLs
+
+Presigned URLs can be used with the AWS Node.js SDK as follows:
+
+import presignedUrls from "!!raw-loader!../../../examples/js/presigned-urls.js";
+
+<CodeBlock language="js">{presignedUrls}</CodeBlock>
+
+You can now use the URL returned by the `getSignedUrl` function to download or
+upload objects to the bucket using the `https` package.

docs/sdks/s3/aws-js-sdk.mdx

@@ -0,0 +1 @@
+node_modules

examples/js/.gitignore

@@ -0,0 +1,71 @@
+import {
+  S3Client,
+  paginateListBuckets,
+  paginateListObjectsV2,
+  PutObjectCommand,
+} from "@aws-sdk/client-s3";
+import { readFile } from "node:fs/promises";
+
+// listBuckets returns a list of all S3 buckets in the account with
+// metadata such as creation date and owner.
+export const listBuckets = async (S3) => {
+  const buckets = [];
+  for await (const page of paginateListBuckets({ client: S3 }, {})) {
+    if (page.Buckets) {
+      buckets.push(...page.Buckets);
+    }
+  }
+  return buckets;
+};
+
+// listObjects returns a list of all objects in a bucket. This only returns
+// the keys of the objects, not the objects themselves. Customize the
+// objects.push line to return more metadata about the objects.
+export const listObjects = async (S3, bucketName) => {
+  const paginator = paginateListObjectsV2(
+    { client: S3, pageSize: 100 },
+    { Bucket: bucketName }
+  );
+  const objects = [];
+
+  for await (const page of paginator) {
+    if (page.Contents) {
+      objects.push(page.Contents.map((o) => o.Key)); // only get object keys
+    }
+  }
+  return objects;
+};
+
+// uploadObjectFromFS uploads a file from the local filesystem to an S3 bucket.
+// This does not handle large files or multipart uploads.
+export const uploadObjectFromFS = async (S3, bucket, key, filePath) => {
+  const command = new PutObjectCommand({
+    Bucket: bucket,
+    Key: key,
+    Body: await readFile(filePath),
+  });
+
+  const response = await S3.send(command);
+  return response;
+};
+
+const S3 = new S3Client({ region: "auto" });
+
+console.log("List buckets");
+const buckets = await listBuckets(S3);
+console.log("Buckets:", buckets);
+
+console.log("List objects in a bucket");
+const objects = await listObjects(S3, "tigris-example");
+objects.forEach((objects, pageNum) => {
+  console.log(`Page ${pageNum + 1}:`, objects);
+});
+
+console.log("Upload an object");
+const response = await uploadObjectFromFS(
+  S3,
+  "tigris-example",
+  "examples/js/getting-started.js",
+  "getting-started.js"
+);
+console.log("Upload response:", response);