[do] SQL module

r

Author: jamesgpearce

site/build.ts

@@ -231,6 +231,9 @@ const addApi = (docs: Docs): Docs =>
     .addApiFile(
       'dist/@types/persisters/persister-durable-object-storage/index.d.ts',
     )
+    .addApiFile(
+      'dist/@types/persisters/persister-durable-object-sql-storage/index.d.ts',
+    )
     .addApiFile('dist/@types/persisters/persister-electric-sql/index.d.ts')
     .addApiFile('dist/@types/persisters/persister-expo-sqlite/index.d.ts')
     .addApiFile('dist/@types/persisters/persister-file/index.d.ts')

site/guides/06_integrations/1_cloudflare_durable_objects.md

@@ -193,9 +193,11 @@ new_sqlite_classes = ["TinyBaseDurableObject"]
 Then create the persister using the recommended SQL storage. The
 `createDurableObjectSqlStoragePersister` supports several persistence modes:
 
-**JSON Mode (Default)**: Stores the entire Store as JSON in a single database
-row. This is efficient for smaller stores and uses fewer database writes, but
-may hit Cloudflare's 2MB row limit for very large stores.
+#### JSON Mode (Default)
+
+Stores the entire Store as JSON in a single database row. This is efficient for
+smaller stores and uses fewer database writes, but may hit Cloudflare's 2MB row
+limit for very large stores.
 
 ```js yolo
 // ...
@@ -208,10 +210,12 @@ createPersister() {
 // ...
 ```
 
-**Fragmented Mode**: Stores each table, row, cell, and value as separate database
-rows. Use this mode if you're concerned about hitting Cloudflare's 2MB row
-limit with large stores in JSON mode. This mode creates more database writes
-but avoids row size limitations:
+#### Fragmented Mode
+
+Stores each table, row, cell, and value as separate database rows. Use this mode
+if you're concerned about hitting Cloudflare's 2MB row limit with large stores
+in JSON mode. This mode creates more database writes but avoids row size
+limitations:
 
 ```js yolo
 // ...
@@ -226,10 +230,10 @@ createPersister() {
 ```
 
 The `createDurableObjectSqlStoragePersister` function supports several optional
-parameters for more advanced use cases:
+parameters for more advanced use cases.
 
-- **Custom table name**: You can specify a custom table name for JSON
-  serialization mode:
+If you need a custom table name, you can specify a custom table name for the
+JSON serialization mode:
 
 ```js yolo
 // ...
@@ -243,8 +247,7 @@ createPersister() {
 // ...
 ```
 
-- **Fragmented mode with custom prefix**: You can use fragmented mode with a
-  custom storage prefix:
+You can use fragmented mode with a custom storage prefix:
 
 ```js yolo
 // ...
@@ -258,8 +261,8 @@ createPersister() {
 // ...
 ```
 
-- **Debugging and logging**: You can add SQL command logging and error handling
-  for development:
+And for debugging and logging, you can add SQL command logging and error
+handling. This is useful for development:
 
 ```js yolo
 // ...

src/@types/omni/index.d.ts

@@ -12,6 +12,7 @@ export * from '../persisters/index.d.ts';
 export * from '../persisters/persister-automerge/index.d.ts';
 export * from '../persisters/persister-browser/index.d.ts';
 export * from '../persisters/persister-cr-sqlite-wasm/index.d.ts';
+export * from '../persisters/persister-durable-object-sql-storage/index.d.ts';
 export * from '../persisters/persister-durable-object-storage/index.d.ts';
 export * from '../persisters/persister-electric-sql/index.d.ts';
 export * from '../persisters/persister-expo-sqlite/index.d.ts';

src/@types/omni/with-schemas/index.d.ts

@@ -11,6 +11,7 @@ export * from '../../metrics/with-schemas/index.d.ts';
 export * from '../../persisters/persister-automerge/with-schemas/index.d.ts';
 export * from '../../persisters/persister-browser/with-schemas/index.d.ts';
 export * from '../../persisters/persister-cr-sqlite-wasm/with-schemas/index.d.ts';
+export * from '../../persisters/persister-durable-object-sql-storage/with-schemas/index.d.ts';
 export * from '../../persisters/persister-durable-object-storage/with-schemas/index.d.ts';
 export * from '../../persisters/persister-electric-sql/with-schemas/index.d.ts';
 export * from '../../persisters/persister-expo-sqlite/with-schemas/index.d.ts';

src/@types/persisters/persister-durable-object-sql-storage/docs.js

@@ -216,14 +216,14 @@
  * mode that stores each piece of data separately to avoid Cloudflare's 2MB row
  * limit.
  *
- * **JSON Mode (Default)**: Stores the entire Store as JSON in a single database
- * row. This is efficient for smaller stores but may hit Cloudflare's 2MB row
- * limit for very large stores and uses fewer database writes.
+ * - **JSON Mode (Default)**: Stores the entire Store as JSON in a single
+ *   database row. This is efficient for smaller stores but may hit Cloudflare's
+ *   2MB row limit for very large stores and uses fewer database writes.
  *
- * **Fragmented Mode**: Stores each table, row, cell, and value as separate
- * database rows. Use this mode if you're concerned about hitting Cloudflare's
- * 2MB row limit with large stores in JSON mode. This mode creates more database
- * writes but avoids row size limitations.
+ * - **Fragmented Mode**: Stores each table, row, cell, and value as separate
+ *   database rows. Use this mode if you're concerned about hitting Cloudflare's
+ *   2MB row limit with large stores in JSON mode. This mode creates more
+ *   database writes but avoids row size limitations.
  *
  * The third argument is a DatabasePersisterConfig object that configures which
  * of those modes to use, and settings for each. If the third argument is simply