Merge branch 'jun/do/storage-api-separation' of github.com:cloudflare/cloudflare-docs into jun/do/storage-api-separation

Implementing fixes from PCX review.

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,26 +119,26 @@ 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`
 
 <code>ctx.storage.onNextSessionRestoreBookmark(bookmark: <Type text='string'/>)</code>: <Type text='Promise<string>' />
 
   * Configures the Durable Object so that the next time it restarts, it should restore its storage to exactly match what the storage contained at the given bookmark. After calling this, the application should typically invoke `ctx.abort()` to restart the Durable Object, thus completing the point-in-time recovery.
 
-  This method returns a special bookmark representing the point in time immediately before the recovery takes place (even though that point in time is still technically in the future). Thus, after the recovery completes, it can be undone by performing a second recovery to this bookmark.
+This method returns a special bookmark representing the point in time immediately before the recovery takes place (even though that point in time is still technically in the future). Thus, after the recovery completes, it can be undone by performing a second recovery to this bookmark.
 
 
 ```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.