@iota-uz/sdk 0.4.13 → 0.4.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -52,9 +52,13 @@ applet rpc gen --name <applet-name>
52
52
  applet rpc check --name <applet-name>
53
53
  applet deps check
54
54
  applet check # deps + RPC drift for all applets
55
+ applet schema export --name <applet>
55
56
  applet dev # start dev environment (all configured applets)
56
57
  applet build [name] # build production bundle
57
58
  applet list # list configured applets
59
+ applet secrets set --name <applet> --key OPENAI_API_KEY --value ...
60
+ applet secrets list --name <applet>
61
+ applet secrets delete --name <applet> --key OPENAI_API_KEY
58
62
  ```
59
63
 
60
64
  - **Specific version:** `go install github.com/iota-uz/applets/cmd/applet@v0.4.4`
@@ -64,11 +68,13 @@ applet list # list configured applets
64
68
 
65
69
  ## Configuration
66
70
 
67
- The CLI expects a project root where `.applets/config.toml` exists (or, for `applet deps check`, a repo with a `go.mod` for `github.com/iota-uz/iota-sdk` or `github.com/iota-uz/eai`).
71
+ The CLI expects a project root where `.applets/config.toml` exists.
68
72
 
69
- Minimal `.applets/config.toml` only `base_path` is required per applet:
73
+ Minimal `.applets/config.toml` (schema v2):
70
74
 
71
75
  ```toml
76
+ version = 2
77
+
72
78
  # Project-level dev processes
73
79
  [[dev.processes]]
74
80
  name = "air"
@@ -83,6 +89,20 @@ args = ["generate", "--watch"]
83
89
  # Applets: only base_path is required. Everything else is convention.
84
90
  [applets.bichat]
85
91
  base_path = "/bi-chat"
92
+ hosts = ["chat.example.com"] # optional
93
+
94
+ [applets.bichat.engine]
95
+ runtime = "off"
96
+
97
+ [applets.bichat.engine.backends]
98
+ kv = "memory"
99
+ db = "memory"
100
+ jobs = "memory"
101
+ files = "local"
102
+ secrets = "env"
103
+
104
+ [applets.bichat.frontend]
105
+ type = "static" # static|ssr
86
106
  ```
87
107
 
88
108
  **Convention defaults:**
@@ -94,5 +114,9 @@ base_path = "/bi-chat"
94
114
  **Optional overrides:**
95
115
  - `web` — custom web directory path (rare)
96
116
  - `[applets.<name>.rpc] needs_reexport_shim = true` — for SDK applets that re-export RPC contracts
117
+ - `hosts` — additional host-based mounts (subdomain/custom-domain)
118
+ - `[applets.<name>.frontend] type = "static"|"ssr"` — SSR mode requires `engine.runtime = "bun"`
119
+ - `[applets.<name>.engine.s3]` — required when `engine.backends.files = "s3"`
120
+ - `[applets.<name>.engine.secrets] required = ["OPENAI_API_KEY"]` — startup-required secret keys
97
121
 
98
122
  Run `applet doctor` to validate config and environment.