Merge pull request #3497 from ItalyPaleAle/crypto-js

[Draft] Crypto how-to: add JavaScript SDK examples

daprdocs/content/en/developing-applications/building-blocks/cryptography/howto-cryptography.md

@@ -15,14 +15,54 @@ Now that you've read about [Cryptography as a Dapr building block]({{< ref crypt
 
 ## Encrypt
 
-Using the Dapr gRPC APIs in your project, you can encrypt a stream of data, such as a file.
+{{< tabs "JavaScript" "Go" >}}
 
-{{< tabs "Go" >}}
+{{% codetab %}}
+
+<!--JavaScript-->
+
+Using the Dapr SDK in your project, with the gRPC APIs, you can encrypt data in a buffer or a string:
+
+```js
+// When passing data (a buffer or string), `encrypt` returns a Buffer with the encrypted message
+const ciphertext = await client.crypto.encrypt(plaintext, {
+    // Name of the Dapr component (required)
+    componentName: "mycryptocomponent",
+    // Name of the key stored in the component (required)
+    keyName: "mykey",
+    // Algorithm used for wrapping the key, which must be supported by the key named above.
+    // Options include: "RSA", "AES"
+    keyWrapAlgorithm: "RSA",
+});
+```
+
+The APIs can also be used with streams, to encrypt data more efficiently when it comes from a stream. The example below encrypts a file, writing to another file, using streams:
+
+```js
+// `encrypt` can be used as a Duplex stream
+await pipeline(
+    fs.createReadStream("plaintext.txt"),
+    await client.crypto.encrypt({
+        // Name of the Dapr component (required)
+        componentName: "mycryptocomponent",
+        // Name of the key stored in the component (required)
+        keyName: "mykey",
+        // Algorithm used for wrapping the key, which must be supported by the key named above.
+        // Options include: "RSA", "AES"
+        keyWrapAlgorithm: "RSA",
+    }),
+    fs.createWriteStream("ciphertext.out"),
+);
+```
+
+{{% /codetab %}}
 
 {{% codetab %}}
 
 <!--go-->
 
+Using the Dapr SDK in your project, you can encrypt a stream of data, such as a file.
+
 ```go
 out, err := sdkClient.Encrypt(context.Background(), rf, dapr.EncryptOptions{
 	// Name of the Dapr component (required)
@@ -35,18 +75,8 @@ out, err := sdkClient.Encrypt(context.Background(), rf, dapr.EncryptOptions{
 })
 ```
 
-{{% /codetab %}}
-
-{{< /tabs >}}
-
 The following example puts the `Encrypt` API in context, with code that reads the file, encrypts it, then stores the result in another file.
 
-{{< tabs "Go" >}}
-
-{{% codetab %}}
-
-<!--go-->
-
 ```go
 // Input file, clear-text
 rf, err := os.Open("input")
@@ -81,18 +111,8 @@ if err != nil {
 fmt.Println("Written", n, "bytes")
 ```
 
-{{% /codetab %}}
-
-{{< /tabs >}}
-
 The following example uses the `Encrypt` API to encrypt a string.
 
-{{< tabs "Go" >}}
-
-{{% codetab %}}
-
-<!--go-->
-
 ```go
 // Input string
 rf := strings.NewReader("Amor, ch’a nullo amato amar perdona, mi prese del costui piacer sì forte, che, come vedi, ancor non m’abbandona")
@@ -121,14 +141,40 @@ if err != nil {
 
 ## Decrypt
 
-To decrypt a file, add the `Decrypt` gRPC API to your project.
+{{< tabs "JavaScript" "Go" >}}
 
-{{< tabs "Go" >}}
+{{% codetab %}}
+
+<!--JavaScript-->
+
+Using the Dapr SDK, you can decrypt data in a buffer or using streams.
+
+```js
+// When passing data as a buffer, `decrypt` returns a Buffer with the decrypted message
+const plaintext = await client.crypto.decrypt(ciphertext, {
+    // Only required option is the component name
+    componentName: "mycryptocomponent",
+});
+
+// `decrypt` can also be used as a Duplex stream
+await pipeline(
+    fs.createReadStream("ciphertext.out"),
+    await client.crypto.decrypt({
+        // Only required option is the component name
+        componentName: "mycryptocomponent",
+    }),
+    fs.createWriteStream("plaintext.out"),
+);
+```
+
+{{% /codetab %}}
 
 {{% codetab %}}
 
 <!--go-->
 
+To decrypt a file, use the `Decrypt` gRPC API to your project.
+
 In the following example, `out` is a stream that can be written to file or read in memory, as in the examples above.
 
 ```go

daprdocs/content/en/developing-applications/building-blocks/pubsub/howto-publish-subscribe.md

@@ -186,7 +186,7 @@ Place `subscription.yaml` in the same directory as your `pubsub.yaml` component.
 
 Below are code examples that leverage Dapr SDKs to subscribe to the topic you defined in `subscription.yaml`.
 
-{{< tabs Dotnet Java Python Go Javascript>}}
+{{< tabs Dotnet Java Python Go JavaScript>}}
 
 {{% codetab %}}
 

daprdocs/content/en/getting-started/quickstarts/cryptography-quickstart.md

@@ -64,6 +64,7 @@ cd ./crypto-quickstart
 ```
 
 The application code defines two required keys:
+
 - Private RSA key 
 - A 256-bit symmetric (AES) key