Apply suggestions from code review

Co-authored-by: Pedro Sousa <[email protected]>

Author: Oxyjun

src/content/docs/durable-objects/api/sql-storage.mdx

@@ -12,11 +12,11 @@ The `SqlStorage` interface encapsulates methods that modify the SQLite database
 
 For example, using `sql.exec()`, a user can create a table, then insert rows into the table.
 
-```js
+```ts
 import { DurableObject } from "cloudflare:workers";
 
 export class MyDurableObject extends DurableObject {
-  sql: SqlStorage
+  sql: SqlStorage;
   constructor(ctx: DurableObjectState, env: Env) {
     super(ctx, env);
     this.sql = ctx.storage.sql;
@@ -59,7 +59,7 @@ A cursor (`SqlStorageCursor`) to iterate over query row results as objects. `Sql
 `SqlStorageCursor` supports the following methods:
 
 * `next()`
-  * Returns an object representing the next value of the cursor. The returned object has  `done` and `value` properties adhering to the JavaScript [Iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_iterator_protocol). `done` is set to `false` when a next value is present, and `value` is set to the next row object in the query result. `done` is set to `true` when the entire cursor is consumed, and no `value` is set.
+  * Returns an object representing the next value of the cursor. The returned object has `done` and `value` properties adhering to the JavaScript [Iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_iterator_protocol). `done` is set to `false` when a next value is present, and `value` is set to the next row object in the query result. `done` is set to `true` when the entire cursor is consumed, and no `value` is set.
 * `toArray()`
   * Iterates through remaining cursor value(s) and returns an array of returned row objects.
 * `one()`
@@ -70,17 +70,18 @@ A cursor (`SqlStorageCursor`) to iterate over query row results as objects. `Sql
   * Returned cursor and `raw()` iterator iterate over the same query results and can be combined. For example:
 
 ```ts
-  let cursor = this.sql.exec("SELECT * FROM artist ORDER BY artistname ASC;");
-  let rawResult = cursor.raw().next();
+let cursor = this.sql.exec("SELECT * FROM artist ORDER BY artistname ASC;");
+let rawResult = cursor.raw().next();
 
-  if (!rawResult.done) {
-    console.log(rawResult.value); // prints [ 123, 'Alice' ]
-  } else {
-    // query returned zero results
-  }
+if (!rawResult.done) {
+  console.log(rawResult.value); // prints [ 123, 'Alice' ]
+} else {
+  // query returned zero results
+}
 
-  console.log(cursor.toArray()); // prints [{ artistid: 456, artistname: 'Bob' },{ artistid: 789, artistname: 'Charlie' }]
+console.log(cursor.toArray()); // prints [{ artistid: 456, artistname: 'Bob' },{ artistid: 789, artistname: 'Charlie' }]
 ```
+
 `SqlStorageCursor` had the following properties:
 
 * `columnNames`: <Type text='string[]' />
@@ -101,10 +102,11 @@ Note that `sql.exec()` cannot execute transaction-related statements like `BEGIN
 `databaseSize`: <Type text ='number' />
 
 #### Returns
+
 The current SQLite database size in bytes.
 
 ```ts
-  let size = ctx.storage.sql.databaseSize;
+let size = ctx.storage.sql.databaseSize;
 ```
 
 ## Point in time recovery
@@ -117,13 +119,13 @@ The PITR API represents points in times using "bookmarks". A bookmark is a mostl
 
 <code>ctx.storage.getCurrentBookmark()</code>: <Type text='Promise<string>' />
 
-  * Returns a bookmark representing the current point in time in the object's history.
+* Returns a bookmark representing the current point in time in the object's history.
 
 ### `getBookmarkForTime`
 
-<code>ctx.storage.getBookmarkForTime(timestamp: <Type text='number'/> | <Type text='Date'/>)</code>: <Type text='Promise<string>' />
+<code>ctx.storage.getBookmarkForTime(timestamp: <Type text='number | Date'/>)</code>: <Type text='Promise<string>' />
 
-  * Returns a bookmark representing approximately the given point in time, which must be within the last 30 days. If the timestamp is represented as a number, it is converted to a date as if using `new Date(timestamp)`.
+* Returns a bookmark representing approximately the given point in time, which must be within the last 30 days. If the timestamp is represented as a number, it is converted to a date as if using `new Date(timestamp)`.
 
 ### `onNextSessionRestoreBookmark`
 
@@ -135,8 +137,8 @@ The PITR API represents points in times using "bookmarks". A bookmark is a mostl
 
 
 ```ts
-  let now = new Date();
-  // restore to 2 days ago
-  let bookmark = ctx.storage.getBookmarkForTime(now - 2);
-  ctx.storage.onNextSessionRestoreBookmark(bookmark);
+let now = new Date();
+// restore to 2 days ago
+let bookmark = ctx.storage.getBookmarkForTime(now - 2);
+ctx.storage.onNextSessionRestoreBookmark(bookmark);
 ```

src/content/docs/durable-objects/api/storage-api.mdx

@@ -43,7 +43,7 @@ export class Counter {
 
 :::note[SQLite in Durable Objects Beta]
 
-The new beta version of Durable Objects is available where each Durable Object has a private, embedded SQLite database. When deploying a new Durable Object class, users can [opt-in to a SQLite storage backend](/durable-objects/best-practices/access-durable-objects-storage/#sqlite-storage-backend) in order to access new [SQL API](/durable-objects/api/sql-storage/#exec). Otherwise, a Durable Object class has a key-value storage backend.
+The new beta version of Durable Objects is available where each Durable Object has a private, embedded SQLite database. When deploying a new Durable Object class, users can [opt-in to a SQLite storage backend](/durable-objects/best-practices/access-durable-objects-storage/#sqlite-storage-backend) to access the new [SQL API](/durable-objects/api/sql-storage/#exec). Otherwise, a Durable Object class has a key-value storage backend.
 
 :::
 
@@ -209,7 +209,7 @@ The `put()` method returns a `Promise`, but most applications can discard this p
 
 ### `sync`
 
-* `sync()` : <Type text='Promise' />
+* `sync()`: <Type text='Promise' />
 
   * Synchronizes any pending writes to disk.
 
@@ -247,7 +247,7 @@ The `put()` method returns a `Promise`, but most applications can discard this p
 
 ### `sql`
 
-`sql` is a readonly property of type `DurableObjectStorage` encapsulating the [SQL API](/durable-objects/api/sql-storage).
+`sql` is a readonly property of type `DurableObjectStorage` encapsulating the [SQL API](/durable-objects/api/sql-storage/).
 
 ## Related resources
 

src/content/docs/durable-objects/api/websockets.mdx

@@ -43,7 +43,7 @@ To learn more about WebSocket Hibernation, refer to [Build a WebSocket server wi
 
 ### `acceptWebSocket`
 
-- <code>acceptWebSocket(ws <Type text="WebSocket" />, tags{" "}<Type text="Array<string>" /> <MetaInfo text="optional" />)</code>: <Type text="void" />
+- <code>acceptWebSocket(ws <Type text="WebSocket" />, tags <Type text="Array<string>" /> <MetaInfo text="optional" />)</code>: <Type text="void" />
 
   - Adds a WebSocket to the set attached to this Durable Object. `ws.accept()` must not have been called separately. Once called, any incoming messages will be delivered by calling the Durable Object's `webSocketMessage()` handler, and `webSocketClose()` will be invoked upon disconnect.