Moving point in time recovery section to SQL Storage chapter.

Author: Oxyjun

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

@@ -14,7 +14,7 @@ SQL API methods accessed with `ctx.storage.sql` are only allowed on [Durable Obj
 
 ## Methods
 
-### exec
+### `exec`
 
 <code>exec(query: <Type text='string'/>, ...bindings: <Type text='any[]'/>)</code>: <Type text='SqlStorageCursor' />
 
@@ -69,7 +69,7 @@ Note that `sql.exec()` cannot execute transaction-related statements like `BEGIN
 
 <Render file="durable-objects-sql" />
 
-### databaseSize
+### `databaseSize`
 
 `databaseSize`: <Type text ='number' />
 
@@ -80,3 +80,36 @@ The current SQLite database size in bytes.
   let size = ctx.storage.sql.databaseSize;
 ```
 
+## Point in time recovery
+
+For [Durable Objects classes with SQL storage](/durable-objects/reference/durable-objects-migrations/#enable-sqlite-storage-backend-on-new-durable-object-class-migration), the following point-in-time-recovery (PITR) API methods are available to restore a Durable Object's embedded SQLite database to any point in time in the past 30 days. These methods apply to the entire SQLite database contents, including both the object's stored SQL data and stored key-value data using the key-value `put()` API. The PITR API is not supported in local development because a durable log of data changes is not stored locally.
+
+The PITR API represents points in times using "bookmarks". A bookmark is a mostly alphanumeric string like `0000007b-0000b26e-00001538-0c3e87bb37b3db5cc52eedb93cd3b96b`. Bookmarks are designed to be lexically comparable: a bookmark representing an earlier point in time compares less than one representing a later point, using regular string comparison.
+
+### `getCurrentBookmark`
+
+<code>ctx.storage.getCurrentBookmark()</code>: <Type text='Promise<string>' />
+
+  * 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>' />
+
+  * 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>' />
+
+  * Configure 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.
+
+
+```ts
+  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

@@ -243,34 +243,6 @@ The `put()` method returns a `Promise`, but most applications can discard this p
 
 * `setAlarm()` and `deleteAlarm()` support the same options as [`put()`](/durable-objects/api/storage-api/#put), but without `noCache`.
 
-### Point in time recovery
-
-For [Durable Objects classes with SQL storage](/durable-objects/reference/durable-objects-migrations/#enable-sqlite-storage-backend-on-new-durable-object-class-migration), the following point-in-time-recovery (PITR) API methods are available to restore a Durable Object's embedded SQLite database to any point in time in the past 30 days. These methods apply to the entire SQLite database contents, including both the object's stored SQL data and stored key-value data using the key-value `put()` API. The PITR API is not supported in local development because a durable log of data changes is not stored locally.
-
-The PITR API represents points in times using "bookmarks". A bookmark is a mostly alphanumeric string like `0000007b-0000b26e-00001538-0c3e87bb37b3db5cc52eedb93cd3b96b`. Bookmarks are designed to be lexically comparable: a bookmark representing an earlier point in time compares less than one representing a later point, using regular string comparison.
-
-`ctx.storage.getCurrentBookmark()`: <Type text='Promise<string>' />
-
-  * Returns a bookmark representing the current point in time in the object's history.
-
-<code>ctx.storage.getBookmarkForTime(timestamp: <Type text='number'/> | <Type text='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)`.
-
-<code>ctx.storage.onNextSessionRestoreBookmark(bookmark: <Type text='string'/>)</code>: <Type text='Promise<string>' />
-
-  * Configure 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.
-
-
-```ts
-  let now = new Date();
-  // restore to 2 days ago
-  let bookmark = ctx.storage.getBookmarkForTime(now - 2);
-  ctx.storage.onNextSessionRestoreBookmark(bookmark);
-```
-
 ### sql
 
 <code>ctx.storage.sql.METHOD</code>: <Type text="SqlStorage"/>