Files
marqdo/plugins/web/internal/httpx/view_resources.go
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

186 lines
5.8 KiB
Go
Executable File

package httpx
import (
"fmt"
"net/http"
"regexp"
"strings"
"github.com/marqdo/marqdo/plugins/web/internal/artifact"
"github.com/marqdo/marqdo/plugins/web/internal/db"
"github.com/marqdo/marqdo/plugins/web/internal/form"
"github.com/marqdo/marqdo/plugins/web/internal/render"
"github.com/marqdo/marqdo/plugins/web/internal/tenant"
)
// ValidateViewResource validates the closed Resource contracts without IO.
// Assembly calls this before listening; request rendering validates again.
func ValidateViewResource(resource map[string]any) (string, error) {
kind, _ := resource["_type"].(string)
switch kind {
case "document_head":
_, err := artifact.ParseDocumentHead(resource)
return "", err
case "data_query":
if source, ok := resource["source"].(string); !ok || strings.TrimSpace(source) == "" {
return "", fmt.Errorf("data_query: source must be a nonempty table name")
}
for _, key := range []string{"order", "link_prefix"} {
if value, exists := resource[key]; exists {
if _, ok := value.(string); !ok {
return "", fmt.Errorf("data_query: %s must be text", key)
}
}
}
for _, key := range []string{"detail", "tenant_scope"} {
if value, exists := resource[key]; exists {
if _, ok := value.(bool); !ok {
return "", fmt.Errorf("data_query: %s must be boolean", key)
}
}
}
if raw, exists := resource["limit"]; exists {
n, ok := raw.(float64)
if !ok || n < 1 || n > 1000 || n != float64(int64(n)) {
return "", fmt.Errorf("data_query: limit must be an integer in 1..1000")
}
}
if prefix, _ := resource["link_prefix"].(string); prefix != "" && (!strings.HasPrefix(prefix, "/") || strings.HasPrefix(prefix, "//")) {
return "", fmt.Errorf("data_query: link_prefix must be site-relative")
}
if where := resource["where"]; where != nil {
switch where.(type) {
case map[string]any, []any:
default:
return "", fmt.Errorf("data_query: where must be a native condition map or list")
}
}
case "form_ref":
if id, ok := resource["id"].(string); !ok || strings.TrimSpace(id) == "" {
return "", fmt.Errorf("form_ref: id must name an explicitly mounted form")
}
case "view_navigation":
region, _ := resource["region"].(string)
if region != "nav" && region != "sidebar" && region != "footer" {
return "", fmt.Errorf("view_navigation: region must be nav, sidebar or footer")
}
switch resource["items"].(type) {
case map[string]any, []any:
default:
return "", fmt.Errorf("view_navigation: items must be link records")
}
default:
return "", fmt.Errorf("unsupported View Resource %q", kind)
}
return "", nil
}
var viewParameter = regexp.MustCompile(`\{([^{}]+)\}`)
// Copy parameterized conditions without mutating the retained startup nodes.
func resourceWhere(value any, params map[string]any) (any, error) {
switch value := value.(type) {
case string:
var missing string
out := viewParameter.ReplaceAllStringFunc(value, func(token string) string {
key := token[1 : len(token)-1]
actual, ok := params[key]
if !ok {
missing = key
return token
}
return fmt.Sprint(actual)
})
if missing != "" {
return nil, fmt.Errorf("data_query: missing route parameter %q", missing)
}
return out, nil
case map[string]any:
out := make(map[string]any, len(value))
for key, item := range value {
resolved, err := resourceWhere(item, params)
if err != nil {
return nil, err
}
out[key] = resolved
}
return out, nil
case []any:
out := make([]any, len(value))
for i, item := range value {
resolved, err := resourceWhere(item, params)
if err != nil {
return nil, err
}
out[i] = resolved
}
return out, nil
default:
return value, nil
}
}
func (st *state) renderViewResource(resource, page map[string]any, request *http.Request) (string, error) {
if _, err := ValidateViewResource(resource); err != nil {
return "", err
}
switch resource["_type"] {
case "document_head":
return "", nil
case "data_query":
if st.dbURL == "" {
return "", fmt.Errorf("data_query: the application has no database resource")
}
params, _ := page["params"].(map[string]any)
where, err := resourceWhere(resource["where"], params)
if err != nil {
return "", err
}
scoped, _ := resource["tenant_scope"].(bool)
if scoped && !st.tenant.Enabled() {
return "", fmt.Errorf("data_query: scoped query requires a tenant policy")
}
if scoped || st.tenant.DefaultScope {
id := tenant.FromContext(request.Context())
if id == "" {
return "", fmt.Errorf("data_query: tenant required")
}
where = tenant.MergeWhere(where, st.tenant.Column, id)
}
limit := int64(50)
if n, ok := resource["limit"].(float64); ok {
limit = int64(n)
}
order, _ := resource["order"].(string)
rows, err := db.Select(st.dbURL, resource["source"].(string), limit, db.SelectOpts{Where: where, Order: order})
if err != nil {
return "", err
}
detail, _ := resource["detail"].(bool)
prefix, _ := resource["link_prefix"].(string)
return render.RenderQueryRows(rows["rows"], detail, prefix), nil
case "form_ref":
id := resource["id"].(string)
selected, ok := st.forms[id].(map[string]any)
if !ok {
return "", fmt.Errorf("form_ref: form %q was not explicitly mounted", id)
}
csrf, _ := page["_csrf"].(string)
return form.RenderBodyCtx(selected, id, nil, nil, csrf, st.requestContext(request, nil)), nil
case "view_navigation":
region := resource["region"].(string)
navigation := map[string]any{region: resource["items"]}
if region == "nav" {
navigation["nav"] = resource["items"]
}
if logged, ok := page["_logged_in"]; ok {
navigation["_logged_in"] = logged
}
if user, ok := page["_nav_user"]; ok {
navigation["_nav_user"] = user
}
return render.RenderPage(navigation, "", region), nil
}
return "", fmt.Errorf("unsupported View Resource")
}