Upgrade SpacetimeDB to 1.10.0, add procedure support, fix hook docs, add prelude (#101)

* Fixes #88

* Upgrade SpacetimeDB to 1.10.0 and use unstable feature, bump version to v0.15.0

* Fixes #99

* Fixes #100

* fix grammar, fix trait code docs

* Expose LocalReadOnly in ReadOnlyDSL and context

* Refactor imports to use spacetimedsl prelude

Author: tamaro-skaljic

Cargo.lock

@@ -1,7 +1,7 @@
 [package]
 authors = ["Tamaro Skaljic<mail@tamaro-skaljic.de>"]
 name = "spacetimedsl"
-version = "0.14.0"
+version = "0.15.0"
 edition = "2024"
 description = "Ergonomic DSL for SpacetimeDB"
 documentation = "https://docs.rs/spacetimedsl"
@@ -14,10 +14,10 @@ readme = "README.md"
 
 [dependencies]
 # https://crates.io/crates/spacetimedb Easy support for interacting between SpacetimeDB and Rust.
-spacetimedb = "1.9.0"
+spacetimedb = { version = "1.10.0", features = [ "unstable" ] }
 
 # https://crates.io/crates/spacetimedsl_derive Macros to extend SpacetimeDSL
-spacetimedsl_derive = { version = "0.14.0", path = "derive" }
+spacetimedsl_derive = { version = "0.15.0", path = "derive" }
 
 # https://crates.io/crates/itertools Extra iterator adaptors, iterator methods, free functions, and macros.
 itertools = "^0.14"

Cargo.toml

@@ -175,7 +175,7 @@ pub fn create_example(ctx: &spacetimedb::ReducerContext) -> Result<(), String> {
     )?;
 
     // SpacetimeDB with SpacetimeDSL
-    let dsl: spacetimedsl::DSL<'_> = spacetimedsl::dsl(ctx);
+    let dsl: spacetimedsl::DSL<'_, spacetimedb::ReducerContext> = spacetimedsl::dsl(ctx);
 
     // Without the question mark it would return a Result<Entity, spacetimedsl::SpacetimeDSLError>
     let entity: Entity = dsl.create_entity()?;
@@ -212,7 +212,7 @@ pub fn create_example(ctx: &spacetimedb::ReducerContext) -> Result<(), String> {
 Here is the implementation:
 
 ```rust
-pub trait CreateEntityRow : spacetimedsl::DSLContext {
+pub trait CreateEntityRow<T: spacetimedsl::WriteContext>: spacetimedsl::DSLContext<T> {
     fn create_entity<'a>(&'a self) -> Result<Entity, spacetimedsl::SpacetimeDSLError> {
         use spacetimedsl::Wrapper;
         use spacetimedb::{DbContext, Table};
@@ -249,7 +249,7 @@ pub trait CreateEntityRow : spacetimedsl::DSLContext {
     }
 }
 
-impl CreateEntityRow for spacetimedsl::DSL<'_> {}
+impl<T: spacetimedsl::WriteContext> CreateEntityRow<T> for spacetimedsl::DSL<'_, T> {}
 ```
 
 ### 🚨 The `SpacetimeDSLError` Type
@@ -819,7 +819,7 @@ pub struct Invalid {
 <summary>📄 Here is the `Delete One` DSL method of the Entity table</summary>
 
 ```rust
-pub trait DeleteEntityRowById: spacetimedsl::DSLContext {
+pub trait DeleteEntityRowById<T: spacetimedsl::WriteContext>: spacetimedsl::DSLContext<T> {
     fn delete_entity_by_id(
         &self,
         id: impl Into<EntityId> + Clone,
@@ -962,7 +962,7 @@ pub trait DeleteEntityRowById: spacetimedsl::DSLContext {
         });
     }
 }
-impl DeleteEntityRowById for spacetimedsl::DSL<'_> {}
+impl<T: spacetimedsl::WriteContext> DeleteEntityRowById<T> for spacetimedsl::DSL<'_, T> {}
 ```
 
 </details>
@@ -1583,15 +1583,15 @@ use spacetimedsl::hook;
 
 // After insert hook
 #[hook]
-pub fn after_entity_insert(dsl: &impl spacetimedsl::DSLContext, row: &Entity) -> Result<(), SpacetimeDSLError> {
+pub fn after_entity_insert(dsl: &spacetimedsl::DSL<'_, T>, row: &Entity) -> Result<(), SpacetimeDSLError> {
     log::info!("Inserted entity with id={}", row.id());
     Ok(())
 }
 
 // Before update hook - has access to both old and new values and can Mutate the new row before the update occurs
 #[hook]
 pub fn before_entity_update(
-    dsl: &impl spacetimedsl::DSLContext,
+    dsl: &spacetimedsl::DSL<'_, T>,
     old_row: &Entity,
     mut new_row: Entity
 ) -> Result<Entity, SpacetimeDSLError> {
@@ -1605,7 +1605,7 @@ pub fn before_entity_update(
 
 // Before delete hook
 #[hook]
-pub fn before_entity_delete(dsl: &impl spacetimedsl::DSLContext, row: &Entity) -> Result<(), SpacetimeDSLError> {
+pub fn before_entity_delete(dsl: &spacetimedsl::DSL<'_, T>, row: &Entity) -> Result<(), SpacetimeDSLError> {
     log::info!("Deleting entity with id={}", row.id());
     Ok(())
 }
@@ -1778,13 +1778,15 @@ spacetimedsl = { version = "*" }
 
 - [Using IndexScanRangeBounds / FilterableValue](https://github.com/tamaro-skaljic/SpacetimeDSL/issues/21) 🔄
 
-- SpacetimeDSL is not available in `#[spacetimedb::view]` functions, because SpacetimeDB uses structs instead of traits for Contexts - We are not really able to generate code which use `ReducerContext`, `ViewContext` and `AnonymousViewContext` at the same time, so we would need to generate each read-only DSL method 3 times.
-  - If you encounter that you can't access a method on the (Anonymous)ViewContext type because it's private, please follow these instructions: <https://github.com/tamaro-skaljic/SpacetimeDSL/issues/90#issuecomment-3573925117> until <https://github.com/clockworklabs/SpacetimeDB/issues/3754> is resolved.
+- SpacetimeDSL is not available in `#[spacetimedb::view]` functions until [SpacetimeDB#3787](https://github.com/clockworklabs/SpacetimeDB/pull/3787) is merged and released.
+  - If you encounter that you can't access a method on the `(Anonymous)ViewContext` type because it's private, please follow these instructions: <https://github.com/tamaro-skaljic/SpacetimeDSL/issues/90#issuecomment-3573925117> until [SpacetimeDB#3754](https://github.com/clockworklabs/SpacetimeDB/issues/3754) is resolved and released.
 
 ## ❓ FAQ
 
 **❔ Why must `#[primary_key]` columns be private?**
 
+> Currently, they are allowed to be public, until [SpacetimeDB#3754](https://github.com/clockworklabs/SpacetimeDB/issues/3754) is resolved and released.
+
 - 🔒 They should never change after insertion
 - DSL generates [setters](#-accessors-getters-and-setters) for non-private columns
 - Making them public would:

README.md

@@ -1,7 +1,7 @@
 [package]
 authors = ["Tamaro Skaljic<mail@tamaro-skaljic.de>"]
 name = "spacetimedsl_derive-input"
-version = "0.14.0"
+version = "0.15.0"
 edition = "2024"
 description = "Contains structs which represent the input and output of SpacetimeDSL. Can be used by other proc-macro crates to build Macros which utilize SpacetimeDSL under the hood."
 documentation = "https://docs.rs/spacetimedsl_derive-input"
@@ -10,6 +10,7 @@ repository = "https://github.com/tamaro-skaljic/SpacetimeDSL/tree/main/derive-in
 publish = true
 include = ["/src/**"]
 keywords = ["dsl", "spacetime", "macro", "codegen", "boilerplate"]
+readme = "../README.md"
 
 [dependencies]
 # https://crates.io/crates/ident_case Utility for applying case rules to Rust identifiers.
@@ -28,7 +29,7 @@ quote = "1"
 itertools = "0.14.0"
 
 # https://crates.io/crates/spacetimedb Easy support for interacting between SpacetimeDB and Rust.
-spacetimedb = "1.9.0"
+spacetimedb = { version = "1.10.0", features = [ "unstable" ] }
 
 # https://crates.io/crates/spacetime-bindings-macro-input Unofficial Input Crate for the SpacetimeDB Macro Bindings.
 spacetime-bindings-macro-input = "1.6.0"

derive-input/Cargo.toml

@@ -241,7 +241,7 @@ fn build_dsl_function_arg() -> SpacetimeDSLArg {
         is_option: false,
         arg_name: format_ident!("dsl"),
         arg_type: SpacetimeDSLArgType::Normal(quote! {
-            &spacetimedsl::DSL
+            &spacetimedsl::DSL<'_, T>
         }),
     }
 }