Advanced templating SDK Support

.github/workflows/ci.yml

@@ -118,3 +118,47 @@ jobs:
 
       - name: Run tests
         run: mvn test -B
+
+  test-rust:
+    name: Test Rust SDK
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/rust-sdk
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: stable
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/registry
+          key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache cargo index
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/git
+          key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache target directory
+        uses: actions/cache@v4
+        with:
+          path: packages/rust-sdk/target
+          key: ${{ runner.os }}-cargo-target-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Check formatting
+        run: cargo fmt -- --check
+
+      - name: Run clippy
+        run: cargo clippy -- -D warnings
+
+      - name: Build
+        run: cargo build --verbose
+
+      - name: Run tests
+        run: cargo test --verbose

.github/workflows/publish-rust.yml

@@ -0,0 +1,50 @@
+name: Publish Rust SDK
+
+on:
+  push:
+    tags:
+      - 'rust-v*'
+
+jobs:
+  publish:
+    name: Publish to crates.io
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/rust-sdk
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: stable
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/registry
+          key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache cargo index
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/git
+          key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Check formatting
+        run: cargo fmt -- --check
+
+      - name: Run clippy
+        run: cargo clippy -- -D warnings
+
+      - name: Build
+        run: cargo build --release --verbose
+
+      - name: Run tests
+        run: cargo test --verbose
+
+      - name: Publish to crates.io
+        run: cargo publish --token ${{ secrets.CARGO_TOKEN }}
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_TOKEN }}

packages/go-sdk/README.md

@@ -232,6 +232,95 @@ err := client.TurboSign.Resend(ctx, "doc-uuid-here", []string{"recipient-uuid-1"
 
 ---
 
+### TurboTemplate
+
+Generate documents from templates with advanced variable substitution.
+
+#### `TurboTemplate.Generate`
+
+Generate a document from a template with variables.
+
+```go
+result, err := client.TurboTemplate.Generate(ctx, &turbodocx.GenerateTemplateRequest{
+    TemplateID: "your-template-uuid",
+    Name:       stringPtr("Generated Contract"),
+    Description: stringPtr("Contract for Q4 2024"),
+    Variables: []turbodocx.TemplateVariable{
+        {Placeholder: "{customer_name}", Name: "customer_name", Value: "Acme Corp"},
+        {Placeholder: "{contract_date}", Name: "contract_date", Value: "2024-01-15"},
+        {Placeholder: "{total_amount}", Name: "total_amount", Value: 50000},
+    },
+})
+
+fmt.Printf("Document ID: %s\n", *result.DeliverableID)
+```
+
+#### Helper Functions
+
+Use helper functions for cleaner variable creation:
+
+```go
+result, err := client.TurboTemplate.Generate(ctx, &turbodocx.GenerateTemplateRequest{
+    TemplateID: "invoice-template-uuid",
+    Name:       stringPtr("Invoice #1234"),
+    Description: stringPtr("Monthly invoice"),
+    Variables: []turbodocx.TemplateVariable{
+        // Simple text/number variables
+        turbodocx.NewSimpleVariable("invoice_number", "INV-2024-001"),
+        turbodocx.NewSimpleVariable("total", 1500),
+
+        // Advanced engine variable (access with dot notation: {customer.name}, {customer.address.city})
+        turbodocx.NewAdvancedEngineVariable("customer", map[string]interface{}{
+            "name":  "Acme Corp",
+            "email": "[email protected]",
+            "address": map[string]interface{}{
+                "street": "123 Main St",
+                "city":   "New York",
+                "state":  "NY",
+            },
+        }),
+
+        // Arrays for loops ({#items}...{/items})
+        turbodocx.NewLoopVariable("items", []interface{}{
+            map[string]interface{}{"name": "Widget A", "quantity": 5, "price": 100},
+            map[string]interface{}{"name": "Widget B", "quantity": 3, "price": 200},
+        }),
+
+        // Conditionals ({#is_premium}...{/is_premium})
+        turbodocx.NewConditionalVariable("is_premium", true),
+
+        // Images
+        turbodocx.NewImageVariable("logo", "https://example.com/logo.png"),
+    },
+})
+```
+
+#### Advanced Templating Features
+
+TurboTemplate supports Angular-like expressions:
+
+| Feature | Template Syntax | Example |
+|:--------|:----------------|:--------|
+| Simple substitution | `{variable}` | `{customer_name}` |
+| Nested objects | `{object.property}` | `{user.address.city}` |
+| Loops | `{#array}...{/array}` | `{#items}{name}: ${price}{/items}` |
+| Conditionals | `{#condition}...{/condition}` | `{#is_premium}Premium Member{/is_premium}` |
+| Expressions | `{expression}` | `{price * quantity}` |
+
+#### Variable Configuration
+
+| Field | Type | Required | Description |
+|:------|:-----|:---------|:------------|
+| `Placeholder` | string | Yes | The placeholder in template (e.g., `{name}`) |
+| `Name` | string | Yes | Variable name for the templating engine |
+| `Value` | interface{} | Yes* | The value to substitute |
+| `MimeType` | VariableMimeType | Yes | `MimeTypeText`, `MimeTypeJSON`, `MimeTypeHTML`, `MimeTypeImage`, `MimeTypeMarkdown` |
+| `UsesAdvancedTemplatingEngine` | *bool | No | Enable for loops, conditionals, expressions |
+
+*Either `Value` or `Text` must be provided.
+
+---
+
 ## Field Types
 
 | Type | Description | Required | Auto-filled |