Compare commits

...
24 Commits
Author SHA1 Message Date
cflmyandCursor 8e23a5395a release: ext pack 1.0.6 — OIDC, form delete, quiet admin
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 16:46:01 +08:00
cflmyandCursor cab609ee91 fix(web): logout to home instead of OIDC login bounce
Clear the session and land on / when logout_redirect is an OIDC entry
path; also exclude */logout from RBAC gates so exit always runs locally.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 16:13:06 +08:00
cflmyandCursor b752cd49b7 fix(web): keep admin and RBAC desk quiet until opted in
Skip auto-gating admin_prefix when admin=false, and mount /_rbac/* only
when enable_rbac sets desk/管理台 so custom desks are not interfered with.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 16:01:40 +08:00
cflmyandCursor 2c91b5cc7b feat(web): OIDC login, form delete, and route-param intros
Add authorization-code OIDC for site auth, treat form action delete as a
generic CRUD primitive, and resolve {param} placeholders in page intros so
custom admin desks can stay in .mq.md without site-specific plugin patches.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 15:57:33 +08:00
cflmyandCursor 453321c8c2 perf(web): cache static assets and defer wasm boot
Add long Cache-Control for /static, version client embed URLs from
asset_version, and delay WASM mount until after load so LCP images win.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 15:07:54 +08:00
cflmyandCursor 981d754133 feat(web): allow Redis session URL separate from app DB
Wire session_url through app.auth/listen so sites can store sessions in
Redis while keeping Postgres/SQLite for application data.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 14:59:50 +08:00
cflmyandCursor 410f36f719 feat(web): Postgres CRUD and fix stale-session CSRF login
Wire pgx for postgres:// DB URLs, dialect-aware RBAC/sessions, and replace dead marqdo_sid cookies so login forms always get a fresh CSRF token.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 14:53:16 +08:00
cflmyandCursor bd06aedb90 fix(browser): pass optional then= through store_set
Theme toggle wrote localStorage but never chained to apply_theme because store_set dropped then.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 14:22:54 +08:00
cflmyandCursor 42ddeb14e7 fix(wasm): custom getrandom so browser wasm loads without wbindgen
The js feature pulled __wbindgen_* imports that marqdo-bridge cannot satisfy, breaking theme toggle and all client WASM.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 13:46:49 +08:00
cflmyandCursor 6bd127a313 feat(web): live markdown preview via POST /_md host glue
Markdown form fields render a dual-pane shell; official boot posts textarea input to /_md for GFM HTML without author business JS.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 13:01:43 +08:00
cflmyandCursor 4b7643d833 fix(web): prefer form redirect and soft-default now_if_empty
Desk 文案 cancel links stamp redirect so POST leaves the compose page; empty date fields can opt into 空则现在 without blocking custom values.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 12:58:24 +08:00
cflmyandCursor 3f96592c99 feat(web): form_load SSR prefill and safe {id} desk routes
Edit pages can stamp compose_form_load to hydrate forms from DB by route id without author JS. Part slots use {part} so pathParamNames can inject {id} again.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 12:50:59 +08:00
cflmyandCursor 98018fc63b feat(web): SSR nav brand/client embed and form markdown labels
Replace author theme.js with framework chrome (nav brand, theme boot,
client mount) plus bridge scroll/observe helpers; add form submit copy
and type=markdown textareas so sites can drop business JS.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 12:42:50 +08:00
cflmyandCursor aeac4d6d20 feat(web): SSR news rail via list target=rail and KaTeX boot glue
List binds with 插槽=rail render aside.side-rail and set has-rail; cards honor pinned; pages that load KaTeX auto-render get an official deferred math boot so authors need no volume.js.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 11:41:52 +08:00
cflmyandCursor 9e9a80df31 feat(web): progressive-enhancement auth forms for branded login pages
Custom /login and /desk/login can POST natively: CSRF/next are injected server-side, failures re-render the same site page with localized flash, and compose_auth_form / 鉴权表单 removes the need for author JS.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 11:30:33 +08:00
cflmyandCursor 5f07b1c3b1 fix(web): preserve absolute URLs in card hrefs
News and other cards with http(s) or root-relative links were incorrectly prefixed with link_prefix, breaking SSR /news.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 11:03:15 +08:00
cflmyandCursor bfea2204eb fix(web): inject CSRF meta on custom login pages
Site-owned GET /login no longer serves the framework form; stamp
csrf-token + session cookie on page render so JS can still POST /login.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 10:49:56 +08:00
cflmyandCursor fb30cd3db3 release: ext pack 1.0.5 — request context and list binds
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 10:24:34 +08:00
cflmyandCursor 584cb9ac9d feat(web): request-context field sources and page list binds
Replace domain comment hacks with generic session/route/now stamps,
server-only form fields, compose_list for detail+child lists, and a live gold.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-18 10:17:39 +08:00
cflmy 428ee141e1 fix(ppa): keep vendor checksums and reuse published orig on debian bumps
dh_clean was stripping Cargo.toml.orig and breaking Launchpad offline
builds; debian-only uploads now reuse the PPA orig with debuild -sd.
2026-09-18 09:02:53 +08:00
cflmyandCursor ec9718466d release: ext pack 1.0.4 — RBAC, tenant, WS hooks, SPA, collab
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 21:10:50 +08:00
cflmyandCursor c5bb08022a feat(web): collaborative notepad MVP over WS rooms
Add LWW text sync demo (DOC\\t protocol + presence) on route_ws rooms,
with design note and bag smoke.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 21:00:10 +08:00
cflmyandCursor b710745e88 feat(web): native SPA helpers, memory store, and demo
Add bridge scope=memory, lib/browser store_set/spa_goto, web-spa-app
list/detail/edit client routes demo, and helper smoke.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 20:58:21 +08:00
cflmyandCursor 5cf84fe9b7 feat(web): RBAC, tenant scope, and WS room hooks
Add configurable role⊥permission (five tables, gate permissions, register,
/_rbac desk), multi-tenant path/header resolution with JSON tenant_scope,
and route_ws on_message/presence/dynamic room_key — with author surfaces,
demos, and smokes.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-17 20:54:02 +08:00
87 changed files with 7503 additions and 349 deletions

No files matched your search

+19 -1
View File
@@ -236,7 +236,25 @@ git push https://proxy.cflmy.top/github.com/cflmy/marqdo.git vVER
Short GETs via the proxy often work; **long `git push` may still time out**. If push hangs or drops, skip Clash retries and go to **HK SSH jump** below.
`gh` against `api.github.com` may still need a direct path or HK jump (the reverse proxy is for `github.com` git, not always the API).
`gh` / Release API can use the same path reverse-proxy:
| Path prefix | Upstream |
|-------------|----------|
| `/github.com/` | `https://github.com/` |
| `/api.github.com/` | `https://api.github.com/` |
| `/uploads.github.com/` | `https://uploads.github.com/` (Release asset POST; OpenResty on HK) |
```bash
# Upload a Release asset through proxy.cflmy.top (Content-Type: application/octet-stream)
curl -X POST \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json" \
-H "Content-Type: application/octet-stream" \
--data-binary @dist/FILE.zip \
"https://proxy.cflmy.top/uploads.github.com/repos/cflmy/marqdo/releases/RELEASE_ID/assets?name=FILE.zip"
```
Do **not** rewrite `Host: uploads.github.com` against `proxy.cflmy.top` without the `/uploads.github.com/` path prefix — that returns 404.
### Diagnose
+62
View File
@@ -8,6 +8,68 @@
### Changed
## Ext pack v1.0.6 — 2026-09-18
### Highlights
**ext/web OIDC、表单删除与安静管理台(CLI 仍为 v1.0.3)**:OIDC 登录/登出回首页、表单 `删除` 动作、默认关闭内置 admin/RBAC desk、独立 Redis 会话 URL、Postgres CRUD。安装:
```bash
marqdo ext add web # CDN latest → 1.0.6
```
### Added
- **OIDC**:`auth.oidc` / 网页鉴权 OIDC;登录入口与 `next` 回跳。
- **表单删除**:`form` 动作 `删除`/`delete`(通用 CRUD,无站点特判)。
- **列表/路由**:请求上下文、列表装配延续;注销默认回 `/` 避免 IdP 再登录环。
### Fixed
- 内置 admin / RBAC desk 默认安静,直至显式 `admin` / `enable_rbac`。
- 静态资源缓存与 WASM 启动延迟;会话 CSRF 与 Postgres 方言。
### Changed
- 扩展包 SemVer **1.0.6**(`ext/VERSION`);与 CLI **v1.0.3** 可独立安装。
## Ext pack v1.0.5 — 2026-09-18
### Highlights
**ext/web 请求上下文与表单来源(CLI 仍为 v1.0.3)**:字段 `来源`/`source`(session / route / now)、server-only 盖戳、页面 `列表装配`/`compose_list`;禁止按业务表特判。安装:
```bash
marqdo ext add web # CDN latest → 1.0.5
```
### Added
- **Request context**:表单提交携带 `_mq_params` / `_mq_return`;`ApplySources` 从 session/route/now 写入。
- **字段来源列**:`client`(默认)/ `session.username` / `route.NAME` / `now`;非 client 不渲染且覆盖客户端伪造。
- **列表装配**:`compose_list` / `列表装配`(副绑定 + 条件/排序/插槽),详情页可同页渲染子列表。
- 设计文:[ext-web-request-context.md](doc/design/ext-web-request-context.md);金样 `ext_web_form_source_live`。
### Changed
- 扩展包 SemVer **1.0.5**(`ext/VERSION`);与 CLI **v1.0.3** 可独立安装。
- 移除评论表名特判(`enrichCommentSubmit`)。
## Ext pack v1.0.4 — 2026-09-17
### Highlights
**ext/web 能力面扩展(CLI 仍为 v1.0.3)**:可配置 RBAC、租户作用域、WS `on_message`/presence、原生 SPA 内存路由、协同记事本 MVP。安装:
```bash
marqdo ext add web # CDN latest → 1.0.4
```
### Added
- **RBAC**:五表(`web_permissions` / `web_roles` / `web_role_permissions` / `web_users` / `web_user_roles`);`app.enable_rbac`、`app.gate permissions=`、`rbac.can`、注册页、`/_rbac/*` 管理 API/desk。
- **Tenant**:`app.tenant`(path/header/subdomain)+ `tenant_scope` 自动过滤/盖戳。
- **WebSocket G-WS2**:`route_ws` 支持 `on_message` 钩子、动态 room、`presence` 通道。
- **Native SPA**:内存 `store_set` / `spa_goto` 与全页 WASM SPA 样站。
- **Collab MVP**:LWW 文档协议(`DOC\t`)双端协同记事本样站。
### Changed
- 扩展包 SemVer **1.0.4**(`ext/VERSION`);与 CLI **v1.0.3** 可独立安装。
## v1.0.3 — 2026-09-17
### Highlights
+2 -1
View File
@@ -50,8 +50,9 @@ include_dir = "0.7"
libc = { version = "0.2", optional = true }
[target.'cfg(target_arch = "wasm32")'.dependencies]
# No `wasmbind`: keeps cdylib free of wasm-bindgen imports (raw mq_* ABI).
# Custom entropy — no `js`/wasm-bindgen imports (raw mq_* ABI + marqdo-bridge.js).
chrono = { version = "0.4", default-features = false, features = ["alloc", "std"] }
getrandom = { version = "=0.2.17", default-features = false, features = ["custom"] }
[workspace]
members = [
+118 -64
View File
@@ -197,6 +197,20 @@ export function eventArgsFromDom(ev, valueFromSel) {
args.fields = fields;
}
}
if (ev && (ev.type === "scroll" || ev.type === "resize")) {
try {
const doc = typeof document !== "undefined" ? document.documentElement : null;
const body = typeof document !== "undefined" ? document.body : null;
const scrollTop = (doc && (doc.scrollTop || 0)) || (body && body.scrollTop) || 0;
const height = doc ? (doc.scrollHeight - doc.clientHeight) || 1 : 1;
const ratio = Math.max(0, Math.min(1, scrollTop / height));
args.scroll_top = scrollTop;
args.scroll_max = height;
args.scroll_ratio = ratio;
} catch (_) {
/* ignore */
}
}
return args;
}
@@ -721,75 +735,88 @@ function runObserveEffect(exports, spec, onError) {
const kind = String(spec.kind || spec.type || "intersect").toLowerCase();
const sel = String(spec.sel || "");
const thenFn = spec.then;
const id = String(spec.id || `obs${++observeSeq}`);
const el = qsOne(sel);
if (!el || !thenFn) return;
const baseId = String(spec.id || `obs${++observeSeq}`);
const nodes = qsAll(sel);
if (!nodes.length || (!thenFn && !spec.add_class)) return;
const prev = observeHandles.get(id);
if (prev) {
try {
prev.disconnect();
} catch (_) {
/* ignore */
}
}
const fire = (payload) => {
try {
const result = call(exports, thenFn, payload);
if (!result.ok) {
if (onError) onError(result.error);
return;
nodes.forEach((el, idx) => {
const id = nodes.length === 1 ? baseId : `${baseId}_${idx}`;
const prev = observeHandles.get(id);
if (prev) {
try {
prev.disconnect();
} catch (_) {
/* ignore */
}
applyEffects(exports, result.value, { onError });
} catch (e) {
if (onError) onError(String(e));
}
};
if (kind === "resize" && typeof ResizeObserver !== "undefined") {
const ro = new ResizeObserver((entries) => {
const en = entries[0];
const cr = en?.contentRect;
fire({
ok: true,
kind: "resize",
id,
width: cr ? cr.width : 0,
height: cr ? cr.height : 0,
});
});
ro.observe(el);
observeHandles.set(id, ro);
return;
}
const fire = (payload) => {
try {
const result = call(exports, thenFn, payload);
if (!result.ok) {
if (onError) onError(result.error);
return;
}
applyEffects(exports, result.value, { onError });
} catch (e) {
if (onError) onError(String(e));
}
};
if (typeof IntersectionObserver !== "undefined") {
const io = new IntersectionObserver(
(entries) => {
if (kind === "resize" && typeof ResizeObserver !== "undefined") {
const ro = new ResizeObserver((entries) => {
const en = entries[0];
if (!en) return;
const cr = en?.contentRect;
fire({
ok: true,
kind: "intersect",
kind: "resize",
id,
intersecting: !!en.isIntersecting,
ratio: en.intersectionRatio,
width: cr ? cr.width : 0,
height: cr ? cr.height : 0,
});
if (spec.once && en.isIntersecting) {
try {
io.disconnect();
} catch (_) {
/* ignore */
});
ro.observe(el);
observeHandles.set(id, ro);
return;
}
if (typeof IntersectionObserver !== "undefined") {
const opts = { threshold: spec.threshold != null ? Number(spec.threshold) : 0.1 };
if (spec.rootMargin != null) opts.rootMargin = String(spec.rootMargin);
const io = new IntersectionObserver(
(entries) => {
const en = entries[0];
if (!en) return;
if (en.isIntersecting && spec.add_class) {
for (const c of String(spec.add_class).split(/\s+/).filter(Boolean)) {
el.classList.add(c);
}
}
observeHandles.delete(id);
}
},
{ threshold: spec.threshold != null ? Number(spec.threshold) : 0.1 },
);
io.observe(el);
observeHandles.set(id, io);
}
if (thenFn) {
fire({
ok: true,
kind: "intersect",
id,
intersecting: !!en.isIntersecting,
ratio: en.intersectionRatio,
target_id: el.id || "",
});
}
if (spec.once && en.isIntersecting) {
try {
io.disconnect();
} catch (_) {
/* ignore */
}
observeHandles.delete(id);
}
},
opts,
);
io.observe(el);
observeHandles.set(id, io);
}
});
}
function buildFetchInit(spec) {
@@ -921,8 +948,23 @@ function runIntervalEffect(exports, spec, onError) {
intervalHandles.set(id, handle);
}
const memoryKV = new Map();
function storageStore(scope) {
if (scope === "cookie") return null;
if (scope === "memory" || scope === "mem" || scope === "内存") {
return {
getItem(key) {
return memoryKV.has(key) ? memoryKV.get(key) : null;
},
setItem(key, value) {
memoryKV.set(key, String(value));
},
removeItem(key) {
memoryKV.delete(key);
},
};
}
if (typeof localStorage === "undefined") return null;
return scope === "session" ? sessionStorage : localStorage;
}
@@ -1371,12 +1413,24 @@ export async function autoMount(doc) {
const g = typeof globalThis !== "undefined" ? globalThis : undefined;
if (g && g.document) {
// Defer WASM boot until after first paint / load so LCP images are not
// contending with a ~1.6MB wasm download on the critical path.
const start = () => {
autoMount(g.document).catch((e) => console.error("marqdo autoMount:", e));
const run = () => {
autoMount(g.document).catch((e) => console.error("marqdo autoMount:", e));
};
const schedule = () => {
if (typeof g.requestIdleCallback === "function") {
g.requestIdleCallback(() => run(), { timeout: 1500 });
} else {
g.setTimeout(run, 0);
}
};
if (g.document.readyState === "complete") {
schedule();
} else {
g.addEventListener("load", schedule, { once: true });
}
};
if (g.document.readyState === "loading") {
g.document.addEventListener("DOMContentLoaded", start);
} else {
queueMicrotask(start);
}
start();
}
+32 -1
View File
@@ -185,7 +185,38 @@ fn pack_json(v: &serde_json::Value) -> *mut u8 {
ptr::copy_nonoverlapping(len.to_le_bytes().as_ptr(), out, 4);
ptr::copy_nonoverlapping(bytes.as_ptr(), out.add(4), bytes.len());
}
out
out
}
/// getrandom `custom` backend for wasm32 — no wasm-bindgen / JS glue imports.
/// Preferable to the `js` feature which pulls `__wbindgen_*` and breaks raw mq_* ABI.
#[cfg(target_arch = "wasm32")]
#[no_mangle]
unsafe extern "Rust" fn __getrandom_custom(dest: *mut u8, len: usize) -> u32 {
// xorshift64* seeded once; fine for uuid/non-crypto browser host helpers.
use std::cell::Cell;
thread_local! {
static STATE: Cell<u64> = const { Cell::new(0x4d51_5241_4e44_4f21) };
}
if dest.is_null() || len == 0 {
return 0;
}
let mut s = STATE.with(|c| {
let mut v = c.get();
if v == 0 {
v = 0x4d51_5241_4e44_4f21;
}
v
});
let buf = unsafe { std::slice::from_raw_parts_mut(dest, len) };
for b in buf.iter_mut() {
s ^= s << 13;
s ^= s >> 7;
s ^= s << 17;
*b = (s >> 8) as u8;
}
STATE.with(|c| c.set(s));
0
}
#[cfg(test)]
+7
View File
@@ -1,3 +1,10 @@
marqdo (1.0.3-1ppa2) noble; urgency=medium
* Fix Launchpad build: dh_clean -Xvendor/ so cargo vendor checksums keep
Cargo.toml.orig (debian-only; reuse published 1.0.3.orig.tar.xz).
-- cflmy <pingan@cflmy.cn> Thu, 17 Sep 2026 21:28:00 +0800
marqdo (1.0.3-1ppa1) noble; urgency=medium
* Marqdo 1.0.3: PPA + ext CDN; unbound GFM tables; bundled Rust for noble.
+5
View File
@@ -46,6 +46,11 @@ override_dh_auto_install:
install -m 0755 $(CURDIR)/target/release/marqdo \
$(CURDIR)/debian/marqdo/usr/bin/marqdo
# dh_clean deletes *.orig by default; cargo vendor checksums require
# vendor/**/Cargo.toml.orig. Exclude the vendored tree from that purge.
override_dh_clean:
dh_clean -Xvendor/
override_dh_auto_clean:
dh_auto_clean
rm -rf debian/cargo_home
+19
View File
@@ -0,0 +1,19 @@
# Collaborative document MVP
| | |
|---|---|
| 状态 | **Accepted · MVP (LWW)** |
| 日期 | 2026-09-17 |
## Approach
Not a full CRDT. Peers sync plain text over `route_ws mode=room` with:
- Client → server: `DOC\\t<body>`
- Server fan-out (existing G-WS1/2)
- Apply remote if body ≠ local; `applying` flag suppresses echo
- Presence JSON on `room.presence` (`presence=True`)
## Demo
`examples/web-collab-doc/` — open two browsers on the same room.
+81
View File
@@ -0,0 +1,81 @@
# `ext/web` 可配置 RBAC(角色 ⊥ 权限)
| | |
|---|---|
| 验收 | qdqc:门禁 `desk:access` + 评论权限;`tests/ext/web-rbac-*-smoke.mq.md` |
| 状态 | **Accepted · 已落地核心**(gate permissions;`/_rbac/*` 管理台 **opt-in** `管理台=真`) |
---
## 0. 一句话
权限是原子能力(`resource:action`);角色是权限包;用户通过 `user_roles` 获得角色。门禁与业务都问 `can(user, permission)`。管理员可在后台新建角色、勾选权限、赋给用户——**禁止**只靠写死的 `role=admin|user` 字符串作为唯一模型(兼容期仍可读旧 `roles=` gate)。
---
## 1. 表结构(SQLite / Postgres 同构)
| 表 | 列 |
|----|-----|
| `web_permissions` | `code` PK, `resource`, `action`, `description` |
| `web_roles` | `id` PK, `name` UNIQUE, `is_system` INT, `tenant_id` TEXT NULL |
| `web_role_permissions` | `role_id`, `permission_code` PK(role_id, permission_code) |
| `web_user_roles` | `user_id`, `role_id`, `tenant_id` TEXT NULL, PK(user_id, role_id, tenant_id) |
| `web_users` | `id` PK, `username` UNIQUE, `password_hash`, `created_at` |
命名带 `web_` 前缀,避免与业务表冲突。站点也可映射自定义表名(后期);首版固定。
---
## 2. 权限码约定
形如 `comments:create`、`desk:access`、`roles:manage`。内置种子见 `DefaultCatalog`。`*` 或角色名 `superadmin` / 兼容 `admin`:登录时展开为目录全集。
---
## 3. 作者 API
```markdown
**`应用` = > `应用`.权限 确保结构=真 目录=`权限目录`**
**`应用` = > `应用`.门禁 路径="/desk" 权限="desk:access" 匹配="prefix" 拒绝="redirect"**
**`应用` = > `应用`.鉴权 用户表=`管理员` 注册=真 注册路径="/register" …**
```
| 方法 | ABI | 说明 |
|------|-----|------|
| `app.rbac` / `启用权限` | `web_app_rbac` | ensure schema;可选 `目录`;`管理台=真` 才挂 `/_rbac/*` |
| `app.gate` | `web_app_gate` | 新增 `permissions`/`权限`(CSV);与 `roles` 可并存:有 permissions 时按权限判定 |
| `rbac.can` | `web_rbac_can` | `{ok, allowed}` |
| `rbac.assign_role` | `web_rbac_assign_role` | 用户←角色 |
| `rbac.set_role_permissions` | `web_rbac_set_role_permissions` | 角色←权限列表 |
防提权:`set_role_permissions` / `assign_role` 在 HTTP 管理面检查操作者 `roles:manage` 且不能授予自身没有的 permission。
---
## 4. 运行时
1. `listen`:若 `auth.rbac=true` 或调用过 `app.rbac`,对 `db` URL `EnsureSchema` + 种子。
2. 仅当 `auth.rbac_desk=true`(`启用权限 管理台=真`)时挂载 `/_rbac/*` API 与 desk。
3. 登录成功:解析角色 → DB `user_roles` ∪ GFM 角色展开 → session `permissions`(CSV)+ 兼容 `role`。
4. `withRBAC`:gate 含 `permissions` 则 `PermissionAllowed`;否则旧 `RoleAllowed`。
5. 注册:`POST /register` 写入 `web_users`,默认赋 `member` 角色。
---
## 5. qdqc 映射
| 产品 | 权限码 |
|------|--------|
| 发评论 | `comments:create` |
| 删任意评论 | `comments:delete` |
| 进 desk | `desk:access` |
| 管角色 | `roles:manage` |
首个 GFM `admin` 用户登录后视为 `superadmin`(全权限);DB 迁移后绑定 `superadmin` 角色。
---
## 6. 非目标(本切片)
对象级 ACL 全图、ABAC;租户列先可空,多租户波次再启用。
+91
View File
@@ -0,0 +1,91 @@
# ext/web:请求上下文与表单字段来源
| | |
|---|---|
| 状态 | **Accepted** |
| 日期 | 2026-09-18 |
| 相关 | [ext-web.md](ext-web.md) §5.5 · 对照 Django `request.user` / URL kwargs |
| 动机 | 禁止扩展库按业务表名(如 `comments`)特判填字段;身份与路由键属于请求上下文 |
---
## 0. 原则
1. **扩展库提供机制,站点表达领域** — 不得出现 `if table == "comments"`。
2. **身份只从 session 来,且服务端盖戳** — 客户端提交的 `author` 等不可信。
3. **资源键从路由参数来** — 页面已在 `/post/{slug}` 时,表单继承该页 `params`,不解析 Referer 猜 slug。
4. **非 `client` 来源的字段默认不渲染** — 服务端在校验前写入;若 POST 带同名键,一律覆盖丢弃。
---
## 1. 请求上下文(Request)
每次处理 HTTP 请求时,框架逻辑上持有:
| 键 | 含义 |
|----|------|
| `user` / `username` | 登录名;访客为空 |
| `params` | 动态路由捕获(如 `{slug}`) |
| `path` | 请求路径 |
| `method` | GET / POST / … |
| `query` | URL 查询(可选) |
与 Django 对应:`request.user`、`request.resolver_match.kwargs`、`request.path`。
页面渲染时已有 `page.params`(`injectParams`)。表单提交时通过隐藏字段 `_mq_params`(JSON)与 `_mq_return`(回跳路径)把**渲染该表单时的页上下文**带回 POST,避免依赖 Referer。
---
## 2. 字段表「来源」列
字段表增加可选列 `来源` / `source`(缺省 = `client`):
```markdown
| 字段 | 标签 | 类型 | 必填 | 默认 | 来源 |
|------|------|------|------|------|------|
| body | 写下你的想法 | textarea | true | | client |
| author | | | true | | session.username |
| post_slug | | | true | | route.slug |
| created_at | | | false | | now |
```
| 来源值 | 含义 | 渲染 |
|--------|------|------|
| `client` / 空 | 用户填写 | 正常控件 |
| `session.username` / `session.user` / `user` | 当前登录用户名 | 不渲染 |
| `route.NAME` / `param.NAME` / `params.NAME` | `params[NAME]` | 不渲染 |
| `now` / `utc.now` / `server.now` | UTC `YYYY-MM-DD HH:MM:SS` | 不渲染 |
`类型=hidden` 仍可显式使用;与 `来源≠client` 叠加时仍不依赖客户端值(服务端覆盖)。
---
## 3. 提交管线
```
ParseForm → 去掉来源≠client 的 POST 键
→ 按字段来源从 Request 写入
→ validate → insert/update
→ 回跳:优先 _mq_return(同站路径),否则 form.redirect
```
伪造 `author` / `post_slug` 无效。
---
## 4. 页面列表装配(副绑定)
详情页可附加与主主体**不同查询条件**的列表绑定(如评论):
```markdown
**post = > post.列表装配 主体=`评论卡片` 条件=`评论条件` 排序="-created_at"**
```
条件值同样支持 `{slug}`。渲染在主文章/卡片区之后,无需为子资源单独写 JSON API + 前端过滤。
---
## 5. 非目标
- 不在扩展库内实现「评论」领域类型。
- 不把 Referer 解析当作正式 params 来源(仅兼容期可作 `_mq_params` 缺失时的弱回退,金样不依赖)。
+24
View File
@@ -0,0 +1,24 @@
# Native SPA(Marqdo WASM 全页客户端)
| | |
|---|---|
| 状态 | **Accepted · MVP** |
| 日期 | 2026-09-17 |
| 相关 | [browser-marqdo-wasm.md](browser-marqdo-wasm.md) · route D/E |
## 约定
| 表 | 列 | 用途 |
|----|-----|------|
| 客户端路由 | `路径` / `面板` / `标题` | 文档化视图;运行时用 `path` + `set_attr(hidden)` 切换 |
| 客户端状态 | `browser.store_set` / `store_get` `scope=memory` | 页内状态(列表 JSON、当前 id) |
作者零业务 JS:`web.client_embed` + `static/client.mq.md` + `lib/browser`。
## Bridge
`storage` effect 支持 `scope=memory`(进程内 `Map`),与 `local` / `session` / `cookie` 并列。
## Demo
`examples/web-spa-app/` — 列表 → 详情 → 编辑,全客户端路由。
+23
View File
@@ -0,0 +1,23 @@
# ext/web multi-tenant (path / subdomain / header)
| | |
|---|---|
| 状态 | **Accepted · MVP** |
| 日期 | 2026-09-17 |
| 相关 | [ext-web-rbac.md](ext-web-rbac.md) · full-ambition plan |
## Author API
```markdown
**应用 = > `应用`.tenant mode="path" param="t" column="tenant_id" default_scope=False**
```
JSON route table may set `tenant_scope` / `租户作用域` = true so `GET /api/items?t=acme` only returns rows with `tenant_id=acme`.
## Runtime
1. `withTenant` resolves id into request context.
2. Scoped JSON selects `AND tenant_id=?`; missing tenant → 400.
3. `default_scope=True` also stamps form POST bodies.
Demo: `examples/web-tenant-saas/`.
+7 -3
View File
@@ -3,8 +3,8 @@
| | |
|---|---|
| 状态 | **Accepted · W0–W7 + P3 + W8(站点图标/Head/图片装配)完结**(SQLite/Postgres 作者面:页面装配 / db CRUD+`where` / form / 嵌入主区 / `app.route` / 路由 `/_part` / admin UI / RBAC / 上传相册 / SEO·RSS·sitemap / **favicon·头资源·图片装配**;Postgres 等见 §9) |
| 日期 | 2026-08-11(W8:2026-08-29) |
| 相关 | [markdown-mapping.md](markdown-mapping.md) · [module-namespace.md](module-namespace.md) · [objects.md](objects.md) · [ext-abi.md](ext-abi.md) · [ext-cli.md](ext-cli.md) · [stdlib-i18n.md](stdlib-i18n.md) · [web-assets-and-images.md](web-assets-and-images.md) |
| 日期 | 2026-08-11(W8:2026-08-29;请求上下文:2026-09-18) |
| 相关 | [markdown-mapping.md](markdown-mapping.md) · [module-namespace.md](module-namespace.md) · [objects.md](objects.md) · [ext-abi.md](ext-abi.md) · [ext-cli.md](ext-cli.md) · [stdlib-i18n.md](stdlib-i18n.md) · [web-assets-and-images.md](web-assets-and-images.md) · **[ext-web-request-context.md](ext-web-request-context.md)** |
| 安装(目标) | `marqdo ext add web`(中英:`web` / `网页`) |
| 本文目的 | 锁定**作者面**与**类 API**;指导实现 |
@@ -247,6 +247,7 @@ import db:db/index.mq.md
|------|------|
| compose_components / 组件装配 | 解析组件·样式路径 → 填 nav/sidebar/footer → CSS → 登记 part |
| compose_main / 主体装配 | 解析库字段与样式路径 → 填 main → 登记 part(如 id=`index`) |
| compose_list / 列表装配 | 副绑定(独立 query/order);可选 target 注入引言元素;见 [ext-web-request-context.md](ext-web-request-context.md) |
**槽位推断:** 由组件导出名决定(`nav`→顶栏,`side`→侧栏,`foot`→底栏;其余→main)。
@@ -423,6 +424,7 @@ import db:db/index.mq.md
| `类型` | 控件/值类型:`text` `textarea` `number` `email` `url` `checkbox` `select` … |
| `必填` | 是否必填 |
| `默认` | 可选默认值 |
| `来源` / `source` | 可选;见 [ext-web-request-context.md](ext-web-request-context.md):`client`(默认)/ `session.username` / `route.NAME` / `now`;非 client 不渲染且服务端盖戳 |
#### 5.5.2 校验表(作者面)
@@ -580,7 +582,9 @@ submit → action=insert → db.insert;action=update → db.update
## 9. 非本波次(可记入路线图)
- Postgres / Redis / S3 驱动细节(SQLite 已落地);
- 复杂权限与多租户;
- ~~复杂权限与多租户~~ → **可配置 RBAC** 见 [ext-web-rbac.md](ext-web-rbac.md);**多租户** 见 [ext-web-tenant.md](ext-web-tenant.md)(path/subdomain/header + `tenant_scope`);
- ~~重客户端 SPA~~ → **Native SPA** 见 [ext-web-spa.md](ext-web-spa.md)(WASM + 路由表 + `store_set` memory);
- ~~实时协同编辑~~ → **Collab MVP** 见 [ext-web-collab.md](ext-web-collab.md)(WS room LWW 文本 + presence);
- 子页路由糖的更多约定(`# 应用.route` 已够用)。
---
+2
View File
@@ -74,6 +74,8 @@ Watch: https://launchpad.net/~cflmy/+archive/ubuntu/marqdo/+builds
| Symptom | Fix |
|---------|-----|
| `lock file version 4 requires -Znext-lockfile-bump` | Rebuild with current `ppa-build-source.sh` (bundles Rust); bump `1ppaN` |
| `failed to calculate checksum of: …/vendor/…/Cargo.toml.orig` | `dh_clean` purged `*.orig`; fixed via `dh_clean -Xvendor/` (+ strip `.orig` only when **creating a new** orig); bump `1ppaN` with **`-sd`** |
| `orig.tar.xz already exists … different contents` | Never rewrite an uploaded upstream `.orig`; reuse PPA file (`ppa-build-source.sh` downloads it) and `debuild -S -sd` |
| Same version rejected by Launchpad | Bump `debian/changelog` (`1ppa2`, …) |
| Wrong series | Enable series on PPA; rebuild with that series name |
+12
View File
@@ -0,0 +1,12 @@
# web-collab-doc
Two-browser collaborative notepad over WebSocket room (last-write-wins text).
```bash
marqdo wasm build -o examples/web-collab-doc/static
cd examples/web-collab-doc
marqdo run index.mq.md
# open http://127.0.0.1:18094 twice
```
Design: [ext-web-collab.md](../../doc/design/ext-web-collab.md).
+24
View File
@@ -0,0 +1,24 @@
---
title: web-collab-doc
description: Two-browser collaborative plain-text editor over WS room (LWW snapshot sync)
import web:ext/web/web.mq.md
---
# main
Collaborative notepad: open the page in two browsers; edits fan out via
`/live/{room}` WebSocket (mode=room + presence). Build WASM first:
```
marqdo wasm build -o examples/web-collab-doc/static
```
**`embed` = > web.client_embed bridge="/static/marqdo-bridge.js" wasm="/static/marqdo_wasm.wasm" source="/static/client.mq.md" boot=True**
**`intro` = "<p class='lede'>Room <code>demo</code> · open twice to co-edit.</p><p id='presence'>presence: —</p><textarea id='doc' rows='16' cols='72' placeholder='Type together…'></textarea><pre id='log'></pre>" + embed**
**page = > web.page title="Collab doc" intro=intro layout="bare"**
**app = > web.app page=page host="127.0.0.1" port=18094**
**app = > app.static dir="static" mount="/static"**
**app = > `app`.route_ws path="/live/{id}" mode="room" room_key="doc.{id}" presence=True**
> `app`.listen
@@ -0,0 +1,85 @@
---
title: collab client
description: LWW text sync over WS room + presence (DOC\\t protocol)
import browser:lib/browser.mq.md
import table:lib/table.mq.md
import text:lib/text.mq.md
---
# main
**`ws_id` = "doc"**
**`applying` = False**
**`doc` = ""**
`wire` =
| @ | 选择器 | 事件 | 调用 | 值选择器 |
|---|--------|------|------|----------|
| 1 | "#doc" | input | on_edit | "#doc" |
`open` =
| op | id | url | then_open | then_message | then_error | then_close |
|----|----|-----|-----------|--------------|------------|------------|
| open | `ws_id` | "ws://127.0.0.1:18094/live/demo" | on_open | on_msg | on_err | on_close |
**`w` = > table.put in=None at="wire" value=wire**
**`ws` = > browser.ws spec=open**
**`boot` = > browser.merge a=w b=ws**
**`ready` = > browser.set_text sel="#log" text="connecting…"**
*> browser.merge a=boot b=ready*
## on_open
+ `ok`=True
*> browser.set_text sel="#log" text="ws open · room demo"*
## on_err
+ `error`=""
**`msg` = "ws error: " + error**
*> browser.set_text sel="#log" text=msg*
## on_close
*> browser.set_text sel="#log" text="ws closed"*
## on_edit
+ `value`=""
1. `applying`
**`applying` = False**
****
2. *
**`doc` = value**
**`payload` = "DOC\t" + value**
`send` =
| op | id | data |
|----|----|------|
| send | `ws_id` | `payload` |
*> browser.ws spec=send*
## on_msg
+ `data`=""
1. `data` != ""
**`is_pres` = > text.starts_with text=data prefix="{"**
1. `is_pres`
**`msg` = "presence: " + data**
*> browser.set_text sel="#presence" text=msg*
2. *
**`is_doc` = > text.starts_with text=data prefix="DOC\t"**
1. `is_doc`
**`remote` = > text.replace text=data old="DOC\t" new="" count=1**
1. `remote` != `doc`
**`doc` = remote**
**`applying` = True**
*> browser.set_value sel="#doc" value=remote*
2. *
****
2. *
****
2. *
****
+14
View File
@@ -0,0 +1,14 @@
# web-spa-app
Marqdo **native SPA**: list → detail → edit with client routes + `scope=memory` store. Zero author JS.
## Run
```bash
marqdo wasm build -o examples/web-spa-app/static
cd examples/web-spa-app
marqdo run index.mq.md
# http://127.0.0.1:18093
```
Design: [ext-web-spa.md](../../doc/design/ext-web-spa.md).
+23
View File
@@ -0,0 +1,23 @@
---
title: web-spa-app
description: Native Marqdo SPA — list/detail/edit via WASM client routes + memory store
import web:ext/web/web.mq.md
---
# main
Full-page client app (zero author JS). Build assets first:
```
marqdo wasm build -o examples/web-spa-app/static
```
**`embed` = > web.client_embed bridge="/static/marqdo-bridge.js" wasm="/static/marqdo_wasm.wasm" source="/static/client.mq.md" boot=True**
**`intro` = "<nav class='spa-nav'><button type='button' id='nav-list'>Items</button> <button type='button' id='nav-new'>New</button></nav><p id='title' class='spa-title'>Items</p><section id='view-list'><ul id='items'></ul><p class='hint'>Click an item for detail.</p></section><section id='view-detail' hidden><p id='detail-body'></p><p><button type='button' id='btn-edit'>Edit</button> <button type='button' id='btn-back'>Back</button></p></section><section id='view-edit' hidden><label>Title <input id='edit-title' /></label><p><button type='button' id='btn-save'>Save</button> <button type='button' id='btn-cancel'>Cancel</button></p></section><pre id='log'></pre>" + embed**
**page = > web.page title="Marqdo SPA" intro=intro layout="bare"**
**app = > web.app page=page host="127.0.0.1" port=18093**
**app = > app.static dir="static" mount="/static"**
**app = > app.redirect from="/item" to="/" permanent=False**
> `app`.listen
+174
View File
@@ -0,0 +1,174 @@
---
title: spa client
description: routes table + memory store; list / detail / edit
import browser:lib/browser.mq.md
import table:lib/table.mq.md
import text:lib/text.mq.md
---
# main
Routes (documentation + titles). Runtime switches panels by `path`.
`routes` =
| @ | 路径 | 面板 | 标题 |
|---|------|------|------|
| 1 | / | #view-list | Items |
| 2 | /item | #view-detail | Detail |
| 3 | /edit | #view-edit | Edit |
**`path` = "/"**
**`cur_id` = ""**
**`items` = "Alpha\nBeta"**
`wire` =
| @ | 选择器 | 事件 | 调用 | 委托 | 值选择器 |
|---|--------|------|------|------|----------|
| 1 | "#nav-list" | click | go_list | | |
| 2 | "#nav-new" | click | go_new | | |
| 3 | "#items" | click | open_item | "li[data-id]" | |
| 4 | "#btn-edit" | click | go_edit | | |
| 5 | "#btn-back" | click | go_list | | |
| 6 | "#btn-save" | click | save_item | | "#edit-title" |
| 7 | "#btn-cancel" | click | go_list | | |
| 8 | "window" | popstate | on_pop | | |
`seed` =
| op | key | value | scope |
|----|-----|-------|-------|
| set | spa-items | `items` | memory |
**`w` = > table.put in=None at="wire" value=wire**
**`s` = > browser.storage spec=seed**
**`boot` = > browser.merge a=w b=s**
**`ready` = > browser.set_text sel="#log" text="spa ready — click Items"**
*> browser.merge a=boot b=ready*
## on_pop
+ `path`=""
1. `path` != ""
**`path` = path**
2. *
****
*> spa_render*
## go_list
**`path` = "/"**
**`cur_id` = ""**
*> spa_render*
## go_new
**`path` = "/edit"**
**`cur_id` = ""**
*> spa_render*
## go_edit
**`path` = "/edit"**
*> spa_render*
## open_item
+ `data_id`=""
1. `data_id` != ""
**`cur_id` = data_id**
**`path` = "/item"**
*> spa_render*
2. *
****
## save_item
+ `value`=""
1. `value` != ""
1. `cur_id` != ""
**`parts` = > text.str_split s=items sep="\n"**
**`next` = ""**
- [item](parts)
1. `item` != ""
1. `item` == `cur_id`
1. `next` == ""
**`next` = value**
2. *
**`next` = next + "\n" + value**
2. *
1. `next` == ""
**`next` = item**
2. *
**`next` = next + "\n" + item**
**`items` = next**
**`cur_id` = value**
2. *
1. `items` == ""
**`items` = value**
2. *
**`items` = items + "\n" + value**
**`cur_id` = value**
**`path` = "/item"**
*> spa_render*
2. *
*> browser.set_text sel="#log" text="title required"*
## spa_render
*> spa_paint*
## spa_paint
**`hide` = > table.put in=None at="hidden" value=""**
**`show` = > table.put in=None at="hidden" value=False**
1. `path` == "/item"
`attrs` =
| #view-detail | #view-list | #view-edit |
|--------------|------------|------------|
| `show` | `hide` | `hide` |
**`title` = "Detail"**
**`body` = cur_id**
2. *
1. `path` == "/edit"
`attrs` =
| #view-edit | #view-list | #view-detail |
|------------|------------|--------------|
| `show` | `hide` | `hide` |
**`title` = "Edit"**
**`body` = cur_id**
2. *
`attrs` =
| #view-list | #view-detail | #view-edit |
|------------|--------------|------------|
| `show` | `hide` | `hide` |
**`title` = "Items"**
**`body` = ""**
**`parts` = > text.str_split s=items sep="\n"**
**`html` = ""**
- [item](parts)
1. `item` != ""
**`html` = html + "<li data-id=\"" + item + "\">" + item + "</li>"**
`persist` =
| op | key | value | scope |
|----|-----|-------|-------|
| set | spa-items | `items` | memory |
**`t` = > browser.set_text sel="#title" text=title**
**`a` = > browser.wrap key="set_attr" value=attrs**
**`ret` = > browser.merge a=t b=a**
**`list` = > browser.set_html sel="#items" html=html**
**`ret` = > browser.merge a=ret b=list**
**`d` = > browser.set_text sel="#detail-body" text=body**
**`ret` = > browser.merge a=ret b=d**
1. `path` == "/edit"
**`v` = > browser.set_value sel="#edit-title" value=cur_id**
**`ret` = > browser.merge a=ret b=v**
2. *
****
**`nav` = > browser.spa_goto url=path**
**`ret` = > browser.merge a=ret b=nav**
**`log` = > browser.set_text sel="#log" text=path**
**`ret` = > browser.merge a=ret b=log**
**`sav` = > browser.storage spec=persist**
*> browser.merge a=ret b=sav*
+33
View File
@@ -0,0 +1,33 @@
---
title: web-tenant-saas demo
description: Dual-tenant isolation via ?t= query + tenant_scope JSON API.
import web:ext/web/web.mq.md
---
# main
`items_schema` =
| name | type | nullable |
|------|------|----------|
| id | integer | false |
| title | text | false |
| tenant_id | text | false |
`api` =
| path | method | table | order | limit | tenant_scope |
|------|--------|-------|-------|-------|--------------|
| api/items | GET | items | id | 50 | true |
**db = > web.db url="sqlite:data/tenant-saas.db"**
> `db`.init name=items fields=`items_schema`
> `db`.exec sql="DELETE FROM items"
> `db`.exec sql="INSERT INTO items(title, tenant_id) VALUES('Acme note','acme')"
> `db`.exec sql="INSERT INTO items(title, tenant_id) VALUES('Beta note','beta')"
**page = > web.page title="Tenant SaaS" intro="<p>Try <a href='/api/items?t=acme'>/api/items?t=acme</a> vs <a href='/api/items?t=beta'>/api/items?t=beta</a>.</p>"**
**app = > web.app page=`page` db=`db` host="127.0.0.1" port=18092 admin=False**
**app = > `app`.tenant mode="path" param="t" default_scope=False**
**app = > `app`.configure json=`api`**
> `app`.listen
+12
View File
@@ -0,0 +1,12 @@
---
title: web-ws-room demo
description: Dynamic room WS with presence (G-WS1/2 bag). Open / and connect via bridge or wscat.
import web:ext/web/web.mq.md
---
# main
**page = > web.page title="WS room" intro="<p class='lede'>Chat room <code>lobby</code> via <code>/chat/lobby</code>. Presence joins <code>chat.room.lobby.presence</code>.</p><pre id='log'></pre>"**
**app = > web.app page=`page` host="127.0.0.1" port=18091 admin=False**
**app = > `app`.route_ws path="/chat/{id}" mode="room" room_key="chat.room.{id}" presence=True**
> `app`.listen
+1 -1
View File
@@ -1 +1 @@
1.0.3
1.0.6
+155 -7
View File
@@ -242,6 +242,17 @@ Assemble main from a bind table (`|属性|值|样式|` or `|front|back|css|`).
*> web_compose_main page=`self` main=`main`*
## compose_list
+ `main`
+ `query`=None
+ `order`=""
+ `target`=""
Secondary list bind (e.g. comments on a detail page). Same bind shape as compose_main.
Optional query supports route param placeholders; optional target injects into an intro element id.
*> web_compose_list page=`self` main=`main` query=`query` order=`order` target=`target`*
## compose_intro
+ `intro`
@@ -345,6 +356,50 @@ Embed a form into the page main slot. Optional `target` / `form_slot` (CSS id, e
*> web_compose_form page=`self` form=`form` id=`id` target=`target`*
## compose_form_load
+ `table`
+ `id_param`="id"
Prefill the composed form from DB using route/query `id` (desk edit pages).
*> web_compose_form_load page=`self` table=`table` id_param=`id_param`*
## compose_auth_form
+ `action`
+ `submit`=""
+ `form_id`=""
+ `err_id`=""
+ `target`=None
+ `next`=""
+ `kind`=""
Progressive-enhancement login/register form: server injects `_csrf` / `next`,
re-renders the same branded page on failure. No author JS.
*> web_compose_auth_form page=`self` action=`action` submit=`submit` form_id=`form_id` err_id=`err_id` target=`target` next=`next` kind=`kind`*
## compose_nav_brand
+ `title`=""
+ `href`="/"
+ `logo`=""
+ `logo_light`=""
+ `theme_key`="mq-theme"
SSR topnav brand (logo + title), theme toggle, and drawer button. Interactive
behavior stays in `client.mq.md` via `compose_client` / `client_embed`.
*> web_compose_nav_brand page=`self` title=`title` href=`href` logo=`logo` logo_light=`logo_light` theme_key=`theme_key`*
## compose_client
+ `source`
+ `bridge`="/static/marqdo-bridge.js"
+ `wasm`="/static/marqdo_wasm.wasm"
Stamp `page.client` so render injects official bridge auto-mount (`data-mq-wasm` /
`data-mq-source-url`). Build with `marqdo wasm build -o static` first.
*> web_compose_client page=`self` source=`source` bridge=`bridge` wasm=`wasm`*
## render
+ `db`=None
@@ -610,6 +665,15 @@ Field table + rules table; submit writes through `# db`.
*> web_form_rules form=`self` rules=`rules`*
## labels
+ `submit`="Submit"
+ `cancel`="cancel"
+ `cancel_href`=""
Localized submit / cancel copy for rendered forms.
*> web_form_labels form=`self` submit=`submit` cancel=`cancel` cancel_href=`cancel_href`*
## validate
+ `rules`=None
+ `data`
@@ -643,7 +707,7 @@ Field table + rules table; submit writes through `# db`.
+ `layout`=None
+ `asset_version`=None
Construct an app. `admin=True` mounts the built-in CRUD UI under `admin_prefix` (default `/admin`). When `admin=False`, that prefix is not reserved — you may `route` your own pages there. Optional `login_redirect` / `logout_redirect` override post-auth landing. Optional `shell_css` / `layout` / `asset_version` become defaults for pages that do not set their own (see `page.shell_css` / `page.layout` / `page.asset_version`).
Construct an app. `admin=True` mounts the built-in **table browser** (not a CMS) under `admin_prefix` (default `/admin`). When `admin=False`, that prefix is not reserved and is not auto-gated — declare your own `route` + `gate` desk. Optional `login_redirect` / `logout_redirect` override post-auth landing. Optional `shell_css` / `layout` / `asset_version` become defaults for pages that do not set their own (see `page.shell_css` / `page.layout` / `page.asset_version`).
> ensure_plugin
*> web_app_new page=`page` db=`db` admin=`admin` host=`host` port=`port` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` shell_css=`shell_css` layout=`layout` asset_version=`asset_version`*
@@ -733,10 +797,13 @@ Serve `/`, routed pages, `/_part/{id}` (home) and `{path}/_part/{id}` (routes),
+ `path`
+ `echo`=True
+ `mode`=None
+ `room_key`=None
+ `on_message`=None
+ `presence`=False
Register a WebSocket endpoint at `path` (e.g. `/live`). `mode` is `echo` (default), `broadcast` (fan-out text to all sockets on this path), or `drain`. Legacy `echo=False` maps to `drain`. Connect from a client with `web.ws.connect`.
Register a WebSocket endpoint at `path` (e.g. `/live` or `/chat/{id}`). `mode` is `echo` (default), `broadcast` (fan-out text to all sockets on this path), `room` (named room via `room_key`, supports `{id}` from the path), or `drain`. Legacy `echo=False` maps to `drain`. `on_message` is an optional `lib.member` hook (G-WS2): called before fan-out with `message`/`room`/`user`; return `{skip:true}` to drop or `{message:…}` to rewrite. `presence=True` also joins `room.presence` and emits join/leave JSON. Connect from a client with `web.ws.connect`.
*> web_app_route_ws app=`self` path=`path` echo=`echo` mode=`mode`*
*> web_app_route_ws app=`self` path=`path` echo=`echo` mode=`mode` room_key=`room_key` on_message=`on_message` presence=`presence`*
## auth
+ `users`
@@ -745,21 +812,59 @@ Register a WebSocket endpoint at `path` (e.g. `/live`). `mode` is `echo` (defaul
+ `login_redirect`=None
+ `logout_redirect`=None
+ `login_path`=None
+ `register`=False
+ `register_path`=/register
+ `default_role`="member"
+ `session_url`=None
Keep the app's `admin=True`, and gate `{admin_prefix}` (segment-boundary prefix) behind a login page (default `/admin`). Unauthenticated requests redirect to `login_path` (default `{admin_prefix}/login`, auto-excluded). Does not match `/admin-publish`-style siblings.
Keep the app's `admin=True`, and gate `{admin_prefix}` (segment-boundary prefix) behind a login page (default `/admin`). Unauthenticated requests redirect to `login_path` (default `{admin_prefix}/login`, auto-excluded). Does not match `/admin-publish`-style siblings. With `register=True` and `enable_rbac`, exposes `register_path` (writes `web_users` + default role). Optional `session_url` (`redis://…` / `rediss://…`) stores sessions in Redis separately from the Postgres/SQLite app DB; omit to keep `_marqdo_sessions` (or in-memory). With OIDC, do not set `logout_redirect` to a login path (it would bounce to the IdP); conflicting values fall back to `/`.
*> web_app_auth app=`self` users=`users` session_ttl=`session_ttl` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` login_path=`login_path`*
*> web_app_auth app=`self` users=`users` session_ttl=`session_ttl` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` login_path=`login_path` register=`register` register_path=`register_path` default_role=`default_role` session_url=`session_url`*
## oidc
+ `issuer`=None
+ `client_id`
+ `client_secret`
+ `redirect_uri`
+ `scopes`="openid profile email"
+ `callback_path`=None
+ `authorize_url`=None
+ `token_url`=None
+ `userinfo_url`=None
Enable OAuth 2.0 authorization-code / OIDC login (e.g. CFLMY IdP). When set, `login_path` / `register_path` / desk login redirect to the IdP; the `redirect_uri` callback exchanges the code and opens a local session. userinfo `is_admin` / `admin_role` map to local role `admin`; otherwise `default_role`. Secrets stay server-side; PKCE S256 is always sent.
*> web_app_oidc app=`self` issuer=`issuer` client_id=`client_id` client_secret=`client_secret` redirect_uri=`redirect_uri` scopes=`scopes` callback_path=`callback_path` authorize_url=`authorize_url` token_url=`token_url` userinfo_url=`userinfo_url`*
## gate
+ `path`
+ `roles`=admin
+ `permissions`=""
+ `match`=prefix
+ `on_deny`=forbid
+ `exclude`=None
Require one of `roles` (CSV) for `path`. `match=prefix` uses segment boundaries; `exact` is equality. Trailing `*` on `path` means prefix. `on_deny=redirect` sends visitors to `login_path` (with `?next=`); `forbid` returns 403. `exclude` is CSV or list of open paths.
Require access for `path`. Prefer `permissions` (CSV of `resource:action` codes such as `desk:access`); when non-empty, authorization uses the session permission set. Otherwise require one of `roles` (legacy). `match=prefix` uses segment boundaries; `exact` is equality. Trailing `*` on `path` means prefix. `on_deny=redirect` sends visitors to `login_path` (with `?next=`); `forbid` returns 403. `exclude` is CSV or list of open paths.
*> web_app_gate app=`self` path=`path` roles=`roles` match=`match` on_deny=`on_deny` exclude=`exclude`*
*> web_app_gate app=`self` path=`path` roles=`roles` permissions=`permissions` match=`match` on_deny=`on_deny` exclude=`exclude`*
## enable_rbac
+ `catalog`=None
+ `desk`=False
Enable database-backed RBAC (role ⊥ permission). On listen, ensures `web_permissions` / `web_roles` / `web_role_permissions` / `web_users` / `web_user_roles` and seeds system roles `superadmin` and `member`. See `doc/design/ext-web-rbac.md`. By default **no** `/_rbac/*` routes; set `desk=True` to mount the API and `GET /_rbac/desk` (needs `roles:manage`). Permission gates work either way.
*> web_app_rbac app=`self` catalog=`catalog` desk=`desk`*
## tenant
+ `mode`
+ `param`=None
+ `column`=tenant_id
+ `default_scope`=False
Enable multi-tenant resolution: `mode` is `path` (query/`/t/{id}/…`), `subdomain`, or `header`. `param` is the path/query key or header name. When `default_scope=True`, JSON routes and form inserts auto-filter/stamp `column` (default `tenant_id`). Per-route override: JSON table column `tenant_scope` / `租户作用域`.
*> web_app_tenant app=`self` mode=`mode` param=`param` column=`column` default_scope=`default_scope`*
## gallery
+ `path`=/gallery
@@ -843,6 +948,49 @@ Mount `GET path` to stream an object. Path must capture `key` (use `{*key}` for
*> web_app_download app=`self` path=`path` storage=`storage` disposition=`disposition`*
# rbac
Offline helpers for role ⊥ permission. Prefer `app.enable_rbac` + gates for HTTP; use these for scripts/tests.
## can
+ `permissions`
+ `needed`
Return `{ok, allowed}` — whether held permission CSV includes any of `needed` (CSV). Held `*` allows all.
> ensure_plugin
*> web_rbac_can permissions=`permissions` needed=`needed`*
## assign_role
+ `url`
+ `username`
+ `role`
Bind `username` (in `web_users`) to role name.
> ensure_plugin
*> web_rbac_assign_role url=`url` username=`username` role=`role`*
## create_role
+ `url`
+ `name`
Create a non-system role; returns `{ok, id, name}`.
> ensure_plugin
*> web_rbac_create_role url=`url` name=`name`*
## set_role_permissions
+ `url`
+ `role`
+ `permissions`
+ `grantable`=""
Replace permissions on a non-system role (CSV). `grantable` restricts grants (anti-escalation); empty = full catalog.
> ensure_plugin
*> web_rbac_set_role_permissions url=`url` role=`role` permissions=`permissions` grantable=`grantable`*
# auth
+ `users`
+ `session_ttl`=3600
+158 -8
View File
@@ -227,6 +227,18 @@ import table:lib/table.mq.md
*> web_compose_main page=`self` main=`主体`*
## 列表装配
+ `主体`
+ `条件`=None
+ `排序`=""
+ `插槽`=""
详情页副绑定(如评论列表)。绑定表形同 `主体装配`;`条件` 支持 `{参数}`;
可选 `插槽`(元素 id)把列表注入引言 HTML(同表单插槽)。
`插槽=rail` / `轨` / `新闻轨` 时渲染为右侧 `aside.side-rail`(量子新闻轨),并为 body 加上 `has-rail`。
*> web_compose_list page=`self` main=`主体` query=`条件` order=`排序` target=`插槽`*
## 引言装配
+ `引言`
@@ -323,6 +335,51 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
*> web_compose_form page=`self` form=`表单` id=`id` target=`表单插槽`*
## 表单载入
+ `表`
+ `id参数`="id"
编辑页:按路由/查询参数中的 id 从数据库预填已装配表单,无需作者 JS 拉行。
*> web_compose_form_load page=`self` table=`表` id_param=`id参数`*
## 鉴权表单
+ `动作`
+ `提交`=""
+ `表单id`=""
+ `错误id`=""
+ `表单插槽`=None
+ `回跳`=""
+ `种类`=""
装配原生登录/注册表单(隐藏 `_csrf` / `next`,失败时服务端回渲同一页 flash)。
`动作` 为 POST 路径(如 `/login`、`/desk/login`、`/register`)。可选 `表单插槽`
把表单注入引言 HTML;`回跳` 为默认 `next`(写作台登录用 `/desk`)。
无需站点业务 JS。
*> web_compose_auth_form page=`self` action=`动作` submit=`提交` form_id=`表单id` err_id=`错误id` target=`表单插槽` next=`回跳` kind=`种类`*
## 导航品牌
+ `标题`=""
+ `链接`="/"
+ `标志`=""
+ `浅色标志`=""
+ `主题键`="mq-theme"
SSR 顶栏刊名 Logo、主题切换钮与目录抽屉钮。交互写在 `client.mq.md`,配合 `客户端`。
*> web_compose_nav_brand page=`self` title=`标题` href=`链接` logo=`标志` logo_light=`浅色标志` theme_key=`主题键`*
## 客户端
+ `源`
+ `桥`="/static/marqdo-bridge.js"
+ `wasm`="/static/marqdo_wasm.wasm"
写入 `page.client`,渲染时注入官方 bridge 自启(`data-mq-wasm` / `data-mq-source-url`)。
先 `marqdo wasm build -o public`(或站点 static 目录)。
*> web_compose_client page=`self` source=`源` bridge=`桥` wasm=`wasm`*
## 渲染
+ `数据库`=None
@@ -566,7 +623,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `动作`=插入
+ `id`=None
字段表 + 校验表;提交经 `# 数据库` 写入。
字段表 + 校验表;提交经 `# 数据库` 写入。`动作` 为 `插入` / `更新` / `删除`(英:`insert` / `update` / `delete`)。删除按 `id` 删行,字段表可只读展示上下文。站点后台用「列表 + 表单页」声明即可,不必改插件。
> 确保插件
*> web_form_new table=`表` action=`动作` id=`id`*
@@ -581,6 +638,15 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
*> web_form_rules form=`self` rules=`规则`*
## 文案
+ `提交`="提交"
+ `取消`="取消"
+ `取消链接`=""
表单提交钮 / 取消链接文案(默认英文 Submit/cancel 由渲染层回退)。
*> web_form_labels form=`self` submit=`提交` cancel=`取消` cancel_href=`取消链接`*
## 校验
+ `规则`=None
+ `数据`
@@ -614,7 +680,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `布局`=None
+ `资源版本`=None
构造应用。`后台=真` 时在 `后台前缀`(默认 `/admin`)挂载内置 CRUD。`后台=假` 时该前缀不再保留,可自行 `路由` 到 `/admin…`。可选 `登录回跳` / `登出回跳`。可选 `壳样式` / `布局` / `资源版本` 作为未自设页面的默认(见 `页面.壳样式` / `页面.布局` / `页面.资源版本`)。
构造应用。`后台=真` 时在 `后台前缀`(默认 `/admin`)挂载**内置表浏览器**(不是 CMS)。`后台=假` 时该前缀不保留、不自动门禁,可自行 `路由` + `门禁` 做写作台。可选 `登录回跳` / `登出回跳`。可选 `壳样式` / `布局` / `资源版本` 作为未自设页面的默认(见 `页面.壳样式` / `页面.布局` / `页面.资源版本`)。
> 确保插件
*> web_app_new page=`页面` db=`数据库` admin=`后台` host=`主机` port=`端口` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` shell_css=`壳样式` layout=`布局` asset_version=`资源版本`*
@@ -699,10 +765,13 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `路径`
+ `回显`=真
+ `模式`=None
+ `房间`=None
+ `消息钩子`=None
+ `在场`=假
在 `路径`(如 `/live`)注册 WebSocket 端点。`模式` 为 `echo`(默认)、`broadcast`(同路径全体广播)或 `drain`。旧参数 `回显=假` 等价于 `drain`。客户端用 `网页.实时` 的 `连接` 接入。
在 `路径`(如 `/live` 或 `/chat/{id}`)注册 WebSocket。`模式` 为 `echo`(默认)、`broadcast`、`room`(需 `房间` 键,可含 `{id}`)或 `drain`。旧参数 `回显=假` 等价于 `drain`。`消息钩子` 为可选 `库.成员`(G-WS2):广播前调用,入参含 `message`/`room`/`user`;返回 `{skip:真}` 丢弃或 `{message:…}` 改写。`在场=真` 时另进 `房间.presence` 并推送 join/leave。客户端用 `网页.实时` 的 `连接` 接入。
*> web_app_route_ws app=`self` path=`路径` echo=`回显` mode=`模式`*
*> web_app_route_ws app=`self` path=`路径` echo=`回显` mode=`模式` room_key=`房间` on_message=`消息钩子` presence=`在场`*
## 鉴权
+ `用户表`
@@ -711,21 +780,59 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `登录回跳`=None
+ `登出回跳`=None
+ `登录路径`=None
+ `注册`=假
+ `注册路径`=/register
+ `默认角色`="member"
+ `会话地址`=None
在保持 `后台=真` 的同时,为 `{后台前缀}` 加段边界前缀门禁(默认 `/admin`)。未登录 重定向 到 `登录路径`(默认 `{前缀}/login`,自动排除)。不会匹配 `/admin-publish` 这类旁系路径。
在保持 `后台=真` 的同时,为 `{后台前缀}` 加段边界前缀门禁(默认 `/admin`)。未登录 重定向 到 `登录路径`(默认 `{前缀}/login`,自动排除)。不会匹配 `/admin-publish` 这类旁系路径。`注册=真` 且已 `启用权限` 时开放 `注册路径`(写入 `web_users` 并赋默认角色)。`会话地址` 可选:`redis://…` / `rediss://…` 将会话存 Redis(与 Postgres/SQLite 业务库分离);缺省仍落在业务库的 `_marqdo_sessions` 或内存。启用统一身份时,`登出回跳` 勿设为登录页(会立刻再跳 IdP);默认/冲突时落首页 `/`。
*> web_app_auth app=`self` users=`用户表` session_ttl=`会话时长` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` login_path=`登录路径`*
*> web_app_auth app=`self` users=`用户表` session_ttl=`会话时长` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` login_path=`登录路径` register=`注册` register_path=`注册路径` default_role=`默认角色` session_url=`会话地址`*
## 统一身份
+ `发行方`=None
+ `客户端编号`
+ `客户端密钥`
+ `回调`
+ `范围`="openid profile email"
+ `回调路径`=None
+ `授权地址`=None
+ `令牌地址`=None
+ `用户信息地址`=None
接入 OIDC / OAuth 2.0 授权码(如 [CFLMY 统一身份](https://id.cflmy.cn/api-docs))。listen 后:`登录路径` / `注册路径` / 后台登录页 302 到 IdP;回调 `回调`(默认 `/oidc/callback`)换票并建本地会话。userinfo 的 `is_admin` / `admin_role` 映射为本地角色 `admin`(写作台权限),否则为 `默认角色`。`client_secret` 仅服务端;推荐配 PKCE(框架已启用 S256)。
*> web_app_oidc app=`self` issuer=`发行方` client_id=`客户端编号` client_secret=`客户端密钥` redirect_uri=`回调` scopes=`范围` callback_path=`回调路径` authorize_url=`授权地址` token_url=`令牌地址` userinfo_url=`用户信息地址`*
## 门禁
+ `路径`
+ `角色`=admin
+ `权限`=""
+ `匹配`=prefix
+ `拒绝`=forbid
+ `排除`=None
要求会话角色落在 `角色`(CSV)之一。`匹配=prefix` 为段边界前缀;`exact` 为精确路径。路径末尾 `*` 亦表示前缀。`拒绝=redirect` 时访客跳转登录页(带 `?next=`);`forbid` 返回 403。`排除` 为 CSV/列表(如登录页)。
为 `路径` 要求访问权。优先使用 `权限`(CSV,如 `desk:access`);非空时按会话权限集判定。否则要求会话角色落在 `角色`(CSV)之一。`匹配=prefix` 为段边界前缀;`exact` 为精确路径。路径末尾 `*` 亦表示前缀。`拒绝=redirect` 时访客跳转登录页(带 `?next=`);`forbid` 返回 403。`排除` 为 CSV/列表(如登录页)。
*> web_app_gate app=`self` path=`路径` roles=`角色` match=`匹配` on_deny=`拒绝` exclude=`排除`*
*> web_app_gate app=`self` path=`路径` roles=`角色` permissions=`权限` match=`匹配` on_deny=`拒绝` exclude=`排除`*
## 启用权限
+ `目录`=None
+ `管理台`=假
启用库表 RBAC(角色 ⊥ 权限)。listen 时确保五表并种子 `superadmin` / `member`。见 `doc/design/ext-web-rbac.md`。默认**不**挂 `/_rbac/*`;`管理台=真` 时才开放 API 与 `GET /_rbac/desk`(需 `roles:manage`)。门禁 `权限=` 在两种模式下均可用。
*> web_app_rbac app=`self` catalog=`目录` desk=`管理台`*
## 租户
+ `模式`
+ `参数`=None
+ `列`=tenant_id
+ `默认作用域`=假
启用多租户解析:`模式` 为 `path`(查询参数或 `/t/{id}/…`)、`subdomain` 或 `header`。`参数` 为路径/查询键或请求头名。`默认作用域=真` 时 JSON 路由与表单插入自动按 `列`(默认 `tenant_id`)过滤/盖戳。单路由可用表列 `租户作用域` 覆盖。
*> web_app_tenant app=`self` mode=`模式` param=`参数` column=`列` default_scope=`默认作用域`*
## 相册
+ `路径`=/gallery
@@ -809,6 +916,49 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
*> web_app_download app=`self` path=`路径` storage=`存储` disposition=`处置`*
# 权限
角色 ⊥ 权限的离线助手。HTTP 侧优先 `应用.启用权限` + 门禁;脚本/测试可用本类。
## 可否
+ `权限`
+ `需要`
返回 `{ok, allowed}`:持有权限 CSV 是否包含 `需要`(CSV)中任一码。持有 `*` 则全允许。
> 确保插件
*> web_rbac_can permissions=`权限` needed=`需要`*
## 赋角色
+ `数据库`
+ `用户名`
+ `角色`
将 `用户名`(须已在 `web_users`)绑定到角色名。
> 确保插件
*> web_rbac_assign_role url=`数据库` username=`用户名` role=`角色`*
## 建角色
+ `数据库`
+ `名称`
新建非系统角色;返回 `{ok, id, name}`。
> 确保插件
*> web_rbac_create_role url=`数据库` name=`名称`*
## 设角色权限
+ `数据库`
+ `角色`
+ `权限`
+ `可授`=""
覆盖非系统角色的权限(CSV)。`可授` 限制可授予码(防提权);空则允许整份目录。
> 确保插件
*> web_rbac_set_role_permissions url=`数据库` role=`角色` permissions=`权限` grantable=`可授`*
# 鉴权
+ `用户表`
+ `会话时长`=3600
+84
View File
@@ -44,6 +44,42 @@ Build set_class effect map.
**`m` = > table.put in=None at=sel value=class**
*> table.put in=None at="set_class" value=m*
## add_class
+ `sel`
+ `class`
Build add_class effect map (classList.add; space-separated names OK).
**`m` = > table.put in=None at=sel value=class**
*> table.put in=None at="add_class" value=m*
## remove_class
+ `sel`
+ `class`
Build remove_class effect map.
**`m` = > table.put in=None at=sel value=class**
*> table.put in=None at="remove_class" value=m*
## toggle_class
+ `sel`
+ `class`
Build toggle_class effect map.
**`m` = > table.put in=None at=sel value=class**
*> table.put in=None at="toggle_class" value=m*
## set_style
+ `sel`
+ `style`
Build set_style effect map; style is a map of CSS properties or a cssText string.
**`m` = > table.put in=None at=sel value=style**
*> table.put in=None at="set_style" value=m*
## set_attr
+ `sel`
+ `attrs`
@@ -154,6 +190,54 @@ focus.
*> table.put in=None at="navigate" value=spec*
## store_set
+ `key`
+ `value`
+ `scope`="memory"
+ `then`=""
In-memory (or local/session) key write for SPA client state. Prefer `scope=memory` for tab-local app state.
Optional `then` is called after the write with `{ok, op, key, scope}`.
`spec` =
| op | key | value | scope |
|----|-----|-------|-------|
| set | `key` | `value` | `scope` |
1. `then` != ""
**`spec` = > table.put in=spec at="then" value=then**
*> table.put in=None at="storage" value=spec*
## store_get
+ `key`
+ `then`
+ `scope`="memory"
Read a key then call `then` with `{ok, value, found, key, scope}`.
`spec` =
| op | key | then | scope |
|----|-----|------|-------|
| get | `key` | `then` | `scope` |
*> table.put in=None at="storage" value=spec*
## spa_goto
+ `url`
+ `replace`=False
SPA navigation: `history.pushState` / `replaceState` via bridge `navigate` effect.
`spec` =
| url | replace |
|-----|---------|
| `url` | `replace` |
*> table.put in=None at="navigate" value=spec*
## storage
+ `spec`
+84
View File
@@ -43,6 +43,42 @@ import table:lib/table.mq.md
**`m` = > table.put in=None at=选择器 value=类**
*> table.put in=None at="set_class" value=m*
## 加类
+ `选择器`
+ `类`
构造 add_class 效应(classList.add;可用空格分隔多个类名)。
**`m` = > table.put in=None at=选择器 value=类**
*> table.put in=None at="add_class" value=m*
## 去类
+ `选择器`
+ `类`
构造 remove_class 效应。
**`m` = > table.put in=None at=选择器 value=类**
*> table.put in=None at="remove_class" value=m*
## 切类
+ `选择器`
+ `类`
构造 toggle_class 效应。
**`m` = > table.put in=None at=选择器 value=类**
*> table.put in=None at="toggle_class" value=m*
## 设样式
+ `选择器`
+ `样式`
构造 set_style 效应;样式为属性表或 cssText 字符串。
**`m` = > table.put in=None at=选择器 value=样式**
*> table.put in=None at="set_style" value=m*
## 设属性
+ `选择器`
+ `属性`
@@ -153,6 +189,54 @@ import table:lib/table.mq.md
*> table.put in=None at="navigate" value=spec*
## 存设
+ `键`
+ `值`
+ `作用域`="memory"
+ `然后`=""
SPA 客户端状态写入。优先 `作用域=memory`(页内内存)。
可选 `然后`:写入后回调,参数含 `{ok, op, key, scope}`。
`spec` =
| op | key | value | scope |
|----|-----|-------|-------|
| set | `键` | `值` | `作用域` |
1. `然后` != ""
**`spec` = > table.put in=spec at="then" value=然后**
*> table.put in=None at="storage" value=spec*
## 存取
+ `键`
+ `然后`
+ `作用域`="memory"
读取键并回调 `然后`,参数含 `{ok, value, found, key, scope}`。
`spec` =
| op | key | then | scope |
|----|-----|------|-------|
| get | `键` | `然后` | `作用域` |
*> table.put in=None at="storage" value=spec*
## 页跳
+ `url`
+ `替换`=False
SPA 导航(bridge `navigate`)。
`spec` =
| url | replace |
|-----|---------|
| `url` | `替换` |
*> table.put in=None at="navigate" value=spec*
## 存储
+ `规格`
+183
View File
@@ -17,6 +17,7 @@ import (
"github.com/marqdo/marqdo/plugins/web/internal/httpx"
"github.com/marqdo/marqdo/plugins/web/internal/middleware"
"github.com/marqdo/marqdo/plugins/web/internal/password"
"github.com/marqdo/marqdo/plugins/web/internal/rbac"
"github.com/marqdo/marqdo/plugins/web/internal/session"
)
@@ -173,6 +174,27 @@ func web_form_rules(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
return replyJSON(outJSON, errMsg, form.SetRules(formBag, args["rules"]), nil)
}
//export web_form_labels
func web_form_labels(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
submit, _ := argStr(args, "submit")
if submit == "" {
submit, _ = argStr(args, "提交")
}
cancel, _ := argStr(args, "cancel")
if cancel == "" {
cancel, _ = argStr(args, "取消")
}
cancelHref, _ := argStr(args, "cancel_href")
if cancelHref == "" {
cancelHref, _ = argStr(args, "取消链接")
}
return replyJSON(outJSON, errMsg, form.SetLabels(asPageMap(args["form"]), submit, cancel, cancelHref), nil)
}
//export web_form_validate
func web_form_validate(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
@@ -480,6 +502,16 @@ func web_app_auth(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
return replyJSON(outJSON, errMsg, out, err)
}
//export web_app_oidc
func web_app_oidc(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
out, err := app.OIDC(asPageMap(args["app"]), args)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_app_gate
func web_app_gate(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
@@ -493,3 +525,154 @@ func web_app_gate(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
out, err := app.Gate(asPageMap(args["app"]), path, args)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_app_rbac
func web_app_rbac(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
out, err := app.Rbac(asPageMap(args["app"]), args)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_app_tenant
func web_app_tenant(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
out, err := app.Tenant(asPageMap(args["app"]), args)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_rbac_can
func web_rbac_can(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
heldRaw, _ := argStrReq(args, "permissions", "权限", "held")
neededRaw, _ := argStrReq(args, "needed", "需要")
if neededRaw == "" {
neededRaw, _ = argStrReq(args, "permission", "权限码")
}
ok := rbac.HasAny(rbac.ParseCSV(heldRaw), rbac.ParseCSV(neededRaw))
return replyJSON(outJSON, errMsg, map[string]any{"ok": true, "allowed": ok}, nil)
}
//export web_rbac_ensure
func web_rbac_ensure(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
url, err := dbURLOf(args)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
if err := rbac.EnsureSchema(url); err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
return replyJSON(outJSON, errMsg, map[string]any{"ok": true}, nil)
}
//export web_rbac_assign_role
func web_rbac_assign_role(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
url, err := dbURLOf(args)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
user, err := argStrReq(args, "username", "用户名", "user")
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
role, err := argStrReq(args, "role", "角色")
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
err = rbac.AssignRole(url, user, role)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
return replyJSON(outJSON, errMsg, map[string]any{"ok": true}, nil)
}
//export web_rbac_create_role
func web_rbac_create_role(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
url, err := dbURLOf(args)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
name, err := argStrReq(args, "name", "名称")
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
id, err := rbac.CreateRole(url, name)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
return replyJSON(outJSON, errMsg, map[string]any{"ok": true, "id": id, "name": name}, nil)
}
//export web_rbac_set_role_permissions
func web_rbac_set_role_permissions(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
url, err := dbURLOf(args)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
roleName, _ := argStrReq(args, "role", "角色")
permsRaw, _ := argStrReq(args, "permissions", "权限")
grantRaw, _ := argStrReq(args, "grantable", "可授")
err = rbac.SetRolePermissionsByName(url, roleName, rbac.ParseCSV(permsRaw), rbac.ParseCSV(grantRaw))
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
return replyJSON(outJSON, errMsg, map[string]any{"ok": true}, nil)
}
//export web_rbac_list_roles
func web_rbac_list_roles(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
url, err := dbURLOf(args)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
roles, err := rbac.ListRoles(url)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
return replyJSON(outJSON, errMsg, map[string]any{"ok": true, "roles": roles}, nil)
}
//export web_rbac_list_permissions
func web_rbac_list_permissions(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
url, err := dbURLOf(args)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
perms, err := rbac.ListPermissions(url)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
return replyJSON(outJSON, errMsg, map[string]any{"ok": true, "permissions": perms}, nil)
}
+6
View File
@@ -15,13 +15,19 @@ require (
github.com/cespare/xxhash/v2 v2.3.0 // indirect
github.com/dustin/go-humanize v1.0.1 // indirect
github.com/google/uuid v1.6.0 // indirect
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
github.com/jackc/pgx/v5 v5.7.4 // indirect
github.com/jackc/puddle/v2 v2.2.2 // indirect
github.com/mattn/go-isatty v0.0.24 // indirect
github.com/ncruces/go-strftime v1.0.0 // indirect
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
github.com/yuin/goldmark v1.7.8 // indirect
github.com/yuin/gopher-lua v1.1.1 // indirect
go.uber.org/atomic v1.11.0 // indirect
golang.org/x/sync v0.22.0 // indirect
golang.org/x/sys v0.47.0 // indirect
golang.org/x/text v0.28.0 // indirect
modernc.org/libc v1.75.6 // indirect
modernc.org/mathutil v1.7.1 // indirect
modernc.org/memory v1.12.1 // indirect
+16
View File
@@ -8,6 +8,7 @@ github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
@@ -20,6 +21,14 @@ github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aN
github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k=
github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM=
github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
github.com/jackc/pgx/v5 v5.7.4 h1:9wKznZrhWa2QiHL+NjTSPP6yjl3451BX3imWDnokYlg=
github.com/jackc/pgx/v5 v5.7.4/go.mod h1:ncY89UGWxg82EykZUwSpUKEfccBGGYq1xjrOpsbsfGQ=
github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
github.com/mattn/go-isatty v0.0.24 h1:tGZZoVgT/KiqK1c8ocVLeDS8BSWMRd47J3Lbz7vsReI=
@@ -32,8 +41,11 @@ github.com/redis/go-redis/v9 v9.22.0 h1:laDvpYXTJtZLloinw1fA5Kqd6HAEH2XKxOkG/PDq
github.com/redis/go-redis/v9 v9.22.0/go.mod h1:y2g0Wj8rQvuK0ELM+oxSudcLtC09JScs98I/X9gRWY4=
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/testify v1.3.0 h1:TivCn/peBQ7UY8ooIcPgZFpTNSz0Q2U6UrFlUfqbe0Q=
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.8.1 h1:w7B6lhMri9wdJUVmEZPGGhZzrYTPvgJArz7wNPgYKsk=
github.com/yuin/goldmark v1.7.8 h1:iERMLn0/QJeHFhxSt3p6PeN9mGnvIKSpG9YYorDMnic=
github.com/yuin/goldmark v1.7.8/go.mod h1:uzxRWxtg69N339t3louHJ7+O03ezfj6PlliRlaOzY1E=
github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M=
@@ -50,8 +62,12 @@ golang.org/x/sync v0.22.0 h1:SZjpbeLmrCk4xhRSZFNZW5gFUeCeFgjekvI/+gfScek=
golang.org/x/sync v0.22.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
golang.org/x/text v0.28.0 h1:rhazDwis8INMIwQ4tpjLDzUhx6RlXqZNPEM0huQojng=
golang.org/x/text v0.28.0/go.mod h1:U8nCwOR8jO/marOQ0QbDiOngZVEBB7MAiitBuMjXiNU=
golang.org/x/tools v0.48.0 h1:3+hClM1aLL5mjMKm5ovokw9epgRXPuu2tILgismM6RE=
golang.org/x/tools v0.48.0/go.mod h1:08xX0orndb/F7jJxGDicx061tyd5pcMto75YMAXr6lk=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
modernc.org/cc/v4 v4.29.2 h1:h6+9ciCnPKutf4I03CvheAvDLX7+IHlqR6Iy6J+cgd8=
modernc.org/cc/v4 v4.29.2/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI=
modernc.org/ccgo/v4 v4.35.0 h1:F+TUsmw09QxLzmi3aeYYGxjAXarmZaKgj3mKQHNaA8w=
+113 -9
View File
@@ -6,7 +6,9 @@ import (
"strings"
"github.com/marqdo/marqdo/plugins/web/internal/assets"
"github.com/marqdo/marqdo/plugins/web/internal/oidc"
"github.com/marqdo/marqdo/plugins/web/internal/session"
"github.com/marqdo/marqdo/plugins/web/internal/tenant"
)
// New builds an app bag matching Rust web_app_new defaults used by zh-smoke.
@@ -194,12 +196,33 @@ func Auth(appBag map[string]any, users any, opts map[string]any) (map[string]any
loginPath = prefix + "/login"
}
out["login_path"] = loginPath
out["auth"] = map[string]any{
"users": users,
"session_ttl": float64(sessionTTL),
authBag, _ := out["auth"].(map[string]any)
if authBag == nil {
authBag = map[string]any{}
} else {
authBag = clone(authBag)
}
authBag["users"] = users
authBag["session_ttl"] = float64(sessionTTL)
if v, ok := first(opts, "register", "注册"); ok {
authBag["register"] = boolish(v)
}
if v := firstStr(opts, "register_path", "注册路径"); v != "" {
authBag["register_path"] = v
out["register_path"] = v
}
if v := firstStr(opts, "default_role", "默认角色"); v != "" {
authBag["default_role"] = v
}
if v := firstStr(opts, "session_url", "会话地址", "redis_url", "Redis"); v != "" {
out["session_url"] = v
authBag["session_url"] = v
}
out["auth"] = authBag
gates := gatesOf(out)
if !hasAdminGate(gates, prefix) {
// Auto-gate the built-in admin prefix only when admin=true. Custom desks
// (admin=false) declare their own gates and must not inherit /admin noise.
if boolish(out["admin"]) && !hasAdminGate(gates, prefix) {
gates = append(gates, map[string]any{
"path": prefix,
"roles": []any{"admin"},
@@ -207,15 +230,62 @@ func Auth(appBag map[string]any, users any, opts map[string]any) (map[string]any
"on_deny": "redirect",
"exclude": []any{loginPath},
})
out["gates"] = gates
} else {
out["gates"] = gates
}
out["gates"] = gates
return out, nil
}
// OIDC configures OAuth2/OIDC authorization-code login (CFLMY IdP or compatible).
// When enabled, GET/POST on login_path and register_path redirect to the IdP;
// callback at redirect_uri path establishes the local session. IdP is_admin /
// admin_role map to local role "admin".
func OIDC(appBag map[string]any, opts map[string]any) (map[string]any, error) {
if opts == nil {
opts = map[string]any{}
}
cfg := oidc.ParseConfig(opts)
if !cfg.Enabled() {
return nil, fmt.Errorf("oidc: need client_id, client_secret, redirect_uri, and issuer (or authorize_url)")
}
out := clone(appBag)
bag := map[string]any{
"issuer": cfg.Issuer,
"client_id": cfg.ClientID,
"client_secret": cfg.ClientSecret,
"redirect_uri": cfg.RedirectURI,
"scopes": cfg.ScopesCSV(),
"callback_path": cfg.Callback(),
}
if cfg.AuthorizeURL != "" {
bag["authorize_url"] = cfg.AuthorizeURL
}
if cfg.TokenURL != "" {
bag["token_url"] = cfg.TokenURL
}
if cfg.UserInfoURL != "" {
bag["userinfo_url"] = cfg.UserInfoURL
}
out["oidc"] = bag
authBag, _ := out["auth"].(map[string]any)
if authBag == nil {
authBag = map[string]any{}
} else {
authBag = clone(authBag)
}
authBag["oidc"] = true
out["auth"] = authBag
return out, nil
}
// Tenant configures multi-tenant resolution on the app bag (path|subdomain|header).
func Tenant(appBag map[string]any, opts map[string]any) (map[string]any, error) {
return tenant.Configure(appBag, opts)
}
// Gate appends an RBAC gate (Rust web_app_gate).
// opts: roles/角色, match/匹配, on_deny/拒绝, exclude/排除.
// opts: roles/角色, permissions/权限, match/匹配, on_deny/拒绝, exclude/排除.
// When permissions is non-empty, the HTTP middleware authorizes by permission codes;
// otherwise it falls back to roles (legacy).
func Gate(appBag map[string]any, path string, opts map[string]any) (map[string]any, error) {
if opts == nil {
opts = map[string]any{}
@@ -225,7 +295,8 @@ func Gate(appBag map[string]any, path string, opts map[string]any) (map[string]a
return nil, fmt.Errorf("missing `path`")
}
rolesRaw := firstStr(opts, "roles", "角色")
if rolesRaw == "" {
permsRaw := firstStr(opts, "permissions", "权限")
if rolesRaw == "" && permsRaw == "" {
rolesRaw = "admin"
}
roles := session.ParseRolesCSV(rolesRaw)
@@ -233,6 +304,11 @@ func Gate(appBag map[string]any, path string, opts map[string]any) (map[string]a
for i, r := range roles {
roleAny[i] = r
}
perms := session.ParseRolesCSV(permsRaw)
permAny := make([]any, len(perms))
for i, p := range perms {
permAny[i] = p
}
matchMode := firstStr(opts, "match", "匹配")
if matchMode == "" {
matchMode = "prefix"
@@ -247,6 +323,9 @@ func Gate(appBag map[string]any, path string, opts map[string]any) (map[string]a
"match": matchMode,
"on_deny": onDeny,
}
if len(permAny) > 0 {
entry["permissions"] = permAny
}
if v, ok := first(opts, "exclude", "排除"); ok && v != nil {
entry["exclude"] = v
}
@@ -257,6 +336,31 @@ func Gate(appBag map[string]any, path string, opts map[string]any) (map[string]a
return out, nil
}
// Rbac enables DB-backed RBAC on the app (ensure schema at listen).
// opts: catalog/目录 (optional seed table); desk/管理台 (bool, default false) —
// when true, listen mounts /_rbac/* API + desk UI; permission gates work either way.
func Rbac(appBag map[string]any, opts map[string]any) (map[string]any, error) {
out := clone(appBag)
authBag, _ := out["auth"].(map[string]any)
if authBag == nil {
authBag = map[string]any{}
} else {
authBag = clone(authBag)
}
authBag["rbac"] = true
authBag["rbac_desk"] = false
if opts != nil {
if v, ok := first(opts, "catalog", "目录"); ok && v != nil {
authBag["permission_catalog"] = v
}
if v, ok := first(opts, "desk", "管理台"); ok {
authBag["rbac_desk"] = boolish(v)
}
}
out["auth"] = authBag
return out, nil
}
// NormalizeAdminPrefix cleans and validates admin_prefix.
func NormalizeAdminPrefix(raw string) (string, error) {
path, err := cleanMountPath(raw)
+44
View File
@@ -114,6 +114,50 @@ func TestAuthDefaultGate(t *testing.T) {
}
}
func TestAuthNoAutoGateWhenAdminOff(t *testing.T) {
a := app.New(map[string]any{"admin": false})
out, err := app.Auth(a, []any{}, map[string]any{"login_path": "/login"})
if err != nil {
t.Fatal(err)
}
if gates, ok := out["gates"].([]any); ok && len(gates) != 0 {
t.Fatalf("expected no auto gate when admin=false, got %v", gates)
}
}
func TestRbacDeskOptIn(t *testing.T) {
a := app.New(map[string]any{"admin": false})
out, err := app.Rbac(a, nil)
if err != nil {
t.Fatal(err)
}
authBag := out["auth"].(map[string]any)
if !boolishTest(authBag["rbac"]) || boolishTest(authBag["rbac_desk"]) {
t.Fatalf("default rbac_desk should be false: %v", authBag)
}
out2, err := app.Rbac(a, map[string]any{"管理台": true})
if err != nil {
t.Fatal(err)
}
if !boolishTest(out2["auth"].(map[string]any)["rbac_desk"]) {
t.Fatal("expected rbac_desk true")
}
}
func boolishTest(v any) bool {
switch x := v.(type) {
case bool:
return x
case string:
s := strings.ToLower(strings.TrimSpace(x))
return s == "1" || s == "true" || s == "yes" || s == "真"
case float64:
return x != 0
default:
return false
}
}
func TestAuthCustomPrefix(t *testing.T) {
a := app.New(map[string]any{"admin": true})
out, err := app.Auth(a, []any{}, map[string]any{
+15 -2
View File
@@ -86,7 +86,7 @@ func cellStr(v any) string {
}
// Login validates credentials and creates a session.
// Success: {"ok":true,"session_id":…,"username":…,"role":…}
// Success: {"ok":true,"session_id":…,"username":…,"role":…,"permissions":…}
// Failure: {"ok":false}
func Login(username, pass string, users any, sessionTTL uint64) map[string]any {
u, role, ok := CheckCredentials(users, username, pass)
@@ -104,6 +104,14 @@ func Login(username, pass string, users any, sessionTTL uint64) map[string]any {
}
}
// AttachPermissions writes permission codes onto an existing login session.
func AttachPermissions(sessionID string, codes []string) {
if sessionID == "" {
return
}
session.SetPermissions(sessionID, codes)
}
// Check returns session auth state (web_auth_check).
func Check(sessionID string) map[string]any {
v, ok := session.GetValue(sessionID, "username")
@@ -120,7 +128,12 @@ func Check(sessionID string) map[string]any {
role = s
}
}
return map[string]any{"ok": true, "username": u, "role": role}
perms := session.PermissionsFromSession(sessionID)
out := map[string]any{"ok": true, "username": u, "role": role}
if len(perms) > 0 {
out["permissions"] = perms
}
return out
}
// Logout destroys the session (web_auth_logout).
+49 -7
View File
@@ -152,14 +152,10 @@ func ComposeComponents(page any, layout any, callLib CallLib) (any, error) {
return obj, nil
}
// ComposeMain merges a main bind table into a page bag.
func ComposeMain(page any, mainTable any, callLib CallLib) (any, error) {
obj := asObject(page)
func resolveBinds(mainTable any, callLib CallLib) (binds []any, css string, err error) {
raw := table.AsBind(mainTable)
arr, _ := raw.([]any)
binds := make([]any, 0, len(arr))
css := strField(obj, "styles_css")
binds = make([]any, 0, len(arr))
for _, b := range arr {
bm, ok := b.(map[string]any)
if !ok {
@@ -191,7 +187,7 @@ func ComposeMain(page any, mainTable any, callLib CallLib) (any, error) {
case table.SitePathLibMember:
st, err := callLib(sp.Lib + "." + sp.Member)
if err != nil {
return nil, err
return nil, "", err
}
css += table.AsCSSNamed(sp.Member, st)
cssName = sp.Member
@@ -207,6 +203,17 @@ func ComposeMain(page any, mainTable any, callLib CallLib) (any, error) {
"css": cssName,
})
}
return binds, css, nil
}
// ComposeMain merges a main bind table into a page bag.
func ComposeMain(page any, mainTable any, callLib CallLib) (any, error) {
obj := asObject(page)
binds, cssExtra, err := resolveBinds(mainTable, callLib)
if err != nil {
return nil, err
}
css := strField(obj, "styles_css") + cssExtra
if t, ok := table.BindTableName(binds); ok {
obj["table"] = t
@@ -234,6 +241,41 @@ func ComposeMain(page any, mainTable any, callLib CallLib) (any, error) {
return obj, nil
}
// ComposeList appends a secondary bind (detail + child list), with optional
// query/order/target (inject into intro element id, same as form_target).
func ComposeList(page any, mainTable any, query any, order, target string, callLib CallLib) (any, error) {
obj := asObject(page)
binds, cssExtra, err := resolveBinds(mainTable, callLib)
if err != nil {
return nil, err
}
if cssExtra != "" {
prev := strField(obj, "styles_css")
if prev != "" {
obj["styles_css"] = prev + cssExtra
} else {
obj["styles_css"] = cssExtra
}
}
entry := map[string]any{"main": binds}
if query != nil {
entry["query"] = query
}
if strings.TrimSpace(order) != "" {
entry["order"] = strings.TrimSpace(order)
}
if t := strings.TrimSpace(target); t != "" {
entry["target"] = t
}
lists := []any{}
if existing, ok := obj["lists"].([]any); ok {
lists = append(lists, existing...)
}
lists = append(lists, entry)
obj["lists"] = lists
return obj, nil
}
// ComposeForm embeds a form into the page main slot.
func ComposeForm(page any, form any, formID string, formTarget *string) (any, error) {
id := strings.TrimSpace(formID)
@@ -0,0 +1,45 @@
package compose
import (
"fmt"
"strings"
)
// ComposeAuthForm stamps page.auth_form for progressive-enhancement login/register.
// action is the form POST path (e.g. /login, /desk/login, /register).
func ComposeAuthForm(page any, action, submit, formID, errID, target, nextDefault, kind string) (any, error) {
action = strings.TrimSpace(action)
if action == "" {
return nil, fmt.Errorf("compose_auth_form requires non-empty action")
}
obj := asObject(page)
kind = strings.TrimSpace(strings.ToLower(kind))
if kind == "" {
if strings.Contains(strings.ToLower(action), "register") {
kind = "register"
} else {
kind = "login"
}
}
spec := map[string]any{
"action": action,
"kind": kind,
}
if s := strings.TrimSpace(submit); s != "" {
spec["submit"] = s
}
if s := strings.TrimSpace(formID); s != "" {
spec["form_id"] = s
}
if s := strings.TrimSpace(errID); s != "" {
spec["err_id"] = s
}
if s := strings.TrimSpace(target); s != "" {
spec["target"] = s
}
if s := strings.TrimSpace(nextDefault); s != "" {
spec["next"] = s
}
obj["auth_form"] = spec
return obj, nil
}
@@ -0,0 +1,24 @@
package compose
import (
"fmt"
"strings"
)
// ComposeFormLoad stamps page.form_load so render prefills the composed form
// from DB by route/query id (desk edit pages without author JS).
func ComposeFormLoad(page any, table, idParam string) (any, error) {
obj := asObject(page)
table = strings.TrimSpace(table)
if table == "" {
return nil, fmt.Errorf("compose_form_load requires non-empty table")
}
spec := map[string]any{"table": table}
if s := strings.TrimSpace(idParam); s != "" {
spec["id_param"] = s
} else {
spec["id_param"] = "id"
}
obj["form_load"] = spec
return obj, nil
}
@@ -0,0 +1,32 @@
package compose
import "testing"
func TestComposeFormLoad(t *testing.T) {
page := map[string]any{"title": "Edit"}
out, err := ComposeFormLoad(page, "posts", "")
if err != nil {
t.Fatal(err)
}
obj, ok := out.(map[string]any)
if !ok {
t.Fatalf("want map, got %T", out)
}
load, ok := obj["form_load"].(map[string]any)
if !ok {
t.Fatalf("missing form_load: %#v", obj)
}
if load["table"] != "posts" {
t.Fatalf("table=%v", load["table"])
}
if load["id_param"] != "id" {
t.Fatalf("id_param=%v", load["id_param"])
}
}
func TestComposeFormLoadRequiresTable(t *testing.T) {
_, err := ComposeFormLoad(map[string]any{}, " ", "id")
if err == nil {
t.Fatal("expected error for empty table")
}
}
@@ -0,0 +1,30 @@
package compose
import "testing"
func TestComposeListAppends(t *testing.T) {
page := map[string]any{"title": "p"}
main := []any{
map[string]any{"front": "title", "back": "comments.author", "css": ""},
map[string]any{"front": "body", "back": "comments.body", "css": ""},
}
q := []any{map[string]any{"field": "post_slug", "op": "=", "value": "{slug}"}}
out, err := ComposeList(page, main, q, "-created_at", "#comment-list", func(string) (any, error) {
return nil, nil
})
if err != nil {
t.Fatal(err)
}
m := out.(map[string]any)
lists, ok := m["lists"].([]any)
if !ok || len(lists) != 1 {
t.Fatalf("lists=%v", m["lists"])
}
entry := lists[0].(map[string]any)
if entry["order"] != "-created_at" || entry["target"] != "#comment-list" {
t.Fatalf("entry=%v", entry)
}
if entry["query"] == nil {
t.Fatal("missing query")
}
}
@@ -0,0 +1,55 @@
package compose
import (
"strings"
)
// ComposeNavBrand stamps page.nav_brand for SSR topnav lockup (logo + title),
// theme toggle, and drawer button chrome. Client WASM only wires behavior.
func ComposeNavBrand(page any, title, href, logo, logoLight, themeKey string) (any, error) {
obj := asObject(page)
spec := map[string]any{}
if s := strings.TrimSpace(title); s != "" {
spec["title"] = s
}
if s := strings.TrimSpace(href); s != "" {
spec["href"] = s
} else {
spec["href"] = "/"
}
if s := strings.TrimSpace(logo); s != "" {
spec["logo"] = s
}
if s := strings.TrimSpace(logoLight); s != "" {
spec["logo_light"] = s
}
if s := strings.TrimSpace(themeKey); s != "" {
spec["theme_key"] = s
} else {
spec["theme_key"] = "mq-theme"
}
obj["nav_brand"] = spec
return obj, nil
}
// ComposeClient stamps page.client so render injects official bridge auto-mount
// (data-mq-wasm / data-mq-source-url). Authors ship client.mq.md, not business JS.
func ComposeClient(page any, bridge, wasm, source string) (any, error) {
obj := asObject(page)
spec := map[string]any{}
if s := strings.TrimSpace(bridge); s != "" {
spec["bridge"] = s
} else {
spec["bridge"] = "/static/marqdo-bridge.js"
}
if s := strings.TrimSpace(wasm); s != "" {
spec["wasm"] = s
} else {
spec["wasm"] = "/static/marqdo_wasm.wasm"
}
if s := strings.TrimSpace(source); s != "" {
spec["source"] = s
}
obj["client"] = spec
return obj, nil
}
@@ -0,0 +1,32 @@
package compose_test
import (
"testing"
"github.com/marqdo/marqdo/plugins/web/internal/compose"
)
func TestComposeNavBrandAndClient(t *testing.T) {
page := map[string]any{"title": "t"}
out, err := compose.ComposeNavBrand(page, "求道量子", "/", "/static/logo.png", "/static/logo-light.png", "mq-theme")
if err != nil {
t.Fatal(err)
}
m := out.(map[string]any)
b, ok := m["nav_brand"].(map[string]any)
if !ok || b["title"] != "求道量子" || b["logo"] != "/static/logo.png" {
t.Fatalf("nav_brand: %#v", m["nav_brand"])
}
out, err = compose.ComposeClient(m, "", "", "/static/client.mq.md")
if err != nil {
t.Fatal(err)
}
m = out.(map[string]any)
c, ok := m["client"].(map[string]any)
if !ok || c["source"] != "/static/client.mq.md" {
t.Fatalf("client: %#v", m["client"])
}
if c["bridge"] != "/static/marqdo-bridge.js" {
t.Fatalf("bridge default: %#v", c)
}
}
+101 -11
View File
@@ -12,6 +12,7 @@ import (
"time"
"github.com/marqdo/marqdo/plugins/web/internal/table"
_ "github.com/jackc/pgx/v5/stdlib"
_ "modernc.org/sqlite"
)
@@ -54,13 +55,27 @@ func pathOf(url string) string {
}
func open(url string) (*sql.DB, error) {
path := pathOf(url)
poolMu.Lock()
defer poolMu.Unlock()
key := ResolveURL(url)
if db, ok := pool[key]; ok {
return db, nil
}
if IsPostgres(url) {
db, err := sql.Open("pgx", key)
if err != nil {
return nil, err
}
db.SetMaxOpenConns(16)
db.SetMaxIdleConns(4)
if err := db.Ping(); err != nil {
_ = db.Close()
return nil, fmt.Errorf("postgres ping: %w", err)
}
pool[key] = db
return db, nil
}
path := pathOf(url)
if parent := filepath.Dir(path); parent != "" && parent != "." {
if err := os.MkdirAll(parent, 0o755); err != nil {
return nil, err
@@ -78,6 +93,12 @@ func open(url string) (*sql.DB, error) {
return db, nil
}
// OpenSQL returns a pooled *sql.DB (sqlite or postgres). Prefer OpenSQLDB when
// issuing `?` placeholders against Postgres (RBAC).
func OpenSQL(url string) (*sql.DB, error) {
return open(url)
}
// ResetPool closes pooled connections and open transactions (tests).
func ResetPool() {
resetTxns()
@@ -117,6 +138,17 @@ func sqlType(t string) string {
}
}
func sqlTypeFor(url, t string) string {
ty := sqlType(t)
if IsPostgres(url) && ty == "REAL" {
return "DOUBLE PRECISION"
}
if IsPostgres(url) && ty == "BLOB" {
return "BYTEA"
}
return ty
}
func cellStr(v any) string {
switch t := v.(type) {
case nil:
@@ -236,11 +268,15 @@ func Init(url, name string, fields any) (map[string]any, error) {
nullable := boolField(m, []string{"nullable", "可空"}, true)
unique := boolField(m, []string{"unique", "唯一"}, false)
index := boolField(m, []string{"index", "索引"}, false)
col := fmt.Sprintf(`"%s" %s`, colName, sqlType(ty))
col := fmt.Sprintf(`"%s" %s`, colName, sqlTypeFor(url, ty))
if colName == "id" && !hasPK {
col += " PRIMARY KEY"
if sqlType(ty) == "INTEGER" {
col += " AUTOINCREMENT"
if IsPostgres(url) && sqlType(ty) == "INTEGER" {
col = fmt.Sprintf(`"%s" INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY`, colName)
} else {
col += " PRIMARY KEY"
if sqlType(ty) == "INTEGER" {
col += " AUTOINCREMENT"
}
}
hasPK = true
} else if !nullable {
@@ -292,7 +328,26 @@ func Init(url, name string, fields any) (map[string]any, error) {
}, nil
}
func columnNames(c dbConn, tableName string) ([]string, error) {
func columnNames(c dbConn, tableName string, dbURL string) ([]string, error) {
if IsPostgres(dbURL) {
rows, err := c.Query(`
SELECT column_name FROM information_schema.columns
WHERE table_schema = current_schema() AND table_name = ?
ORDER BY ordinal_position`, tableName)
if err != nil {
return nil, err
}
defer rows.Close()
var out []string
for rows.Next() {
var name string
if err := rows.Scan(&name); err != nil {
return nil, err
}
out = append(out, name)
}
return out, rows.Err()
}
rows, err := c.Query(fmt.Sprintf(`PRAGMA table_info("%s")`, tableName))
if err != nil {
return nil, err
@@ -374,7 +429,7 @@ func Insert(url, tableName string, rows any, txnID ...string) (map[string]any, e
if err != nil {
return nil, err
}
colsPresent, err := columnNames(c, tn)
colsPresent, err := columnNames(c, tn, url)
if err != nil {
return nil, err
}
@@ -869,7 +924,7 @@ func Update(url, tableName, id string, row any, txnID ...string) (map[string]any
if err != nil {
return nil, err
}
colsPresent, err := columnNames(c, tn)
colsPresent, err := columnNames(c, tn, url)
if err != nil {
return nil, err
}
@@ -990,17 +1045,52 @@ type ColumnInfo struct {
PK bool
}
// TableInfo returns column metadata for a SQLite table.
// TableInfo returns column metadata for a table (SQLite or Postgres).
func TableInfo(url, tableName string) ([]ColumnInfo, error) {
tn, err := ident(tableName)
if err != nil {
return nil, err
}
db, err := open(url)
c, err := connFor(url, "")
if err != nil {
return nil, err
}
rows, err := db.Query(fmt.Sprintf(`PRAGMA table_info("%s")`, tn))
if IsPostgres(url) {
rows, err := c.Query(`
SELECT c.column_name, c.data_type, c.is_nullable,
CASE WHEN tc.constraint_type = 'PRIMARY KEY' THEN 1 ELSE 0 END AS is_pk
FROM information_schema.columns c
LEFT JOIN information_schema.key_column_usage kcu
ON c.table_schema = kcu.table_schema AND c.table_name = kcu.table_name AND c.column_name = kcu.column_name
LEFT JOIN information_schema.table_constraints tc
ON kcu.constraint_name = tc.constraint_name AND kcu.table_schema = tc.table_schema
AND tc.constraint_type = 'PRIMARY KEY'
WHERE c.table_schema = current_schema() AND c.table_name = ?
ORDER BY c.ordinal_position`, tn)
if err != nil {
return nil, err
}
defer rows.Close()
var out []ColumnInfo
for rows.Next() {
var name, dtype, nullable string
var pk int
if err := rows.Scan(&name, &dtype, &nullable, &pk); err != nil {
return nil, err
}
if dtype == "" {
dtype = "TEXT"
}
out = append(out, ColumnInfo{
Name: name,
SQLType: dtype,
NotNull: strings.EqualFold(nullable, "NO"),
PK: pk != 0,
})
}
return out, rows.Err()
}
rows, err := c.Query(fmt.Sprintf(`PRAGMA table_info("%s")`, tn))
if err != nil {
return nil, err
}
+144
View File
@@ -0,0 +1,144 @@
package db
import (
"database/sql"
"strings"
)
// IsPostgres reports whether url selects the Postgres backend.
func IsPostgres(url string) bool {
lower := strings.ToLower(strings.TrimSpace(url))
return strings.HasPrefix(lower, "postgres://") || strings.HasPrefix(lower, "postgresql://")
}
// RewritePlaceholdersPG turns `?` into `$1,$2,…` for Postgres.
func RewritePlaceholdersPG(sqlStmt string) string {
var b strings.Builder
b.Grow(len(sqlStmt) + 8)
n := 0
for _, c := range sqlStmt {
if c == '?' {
n++
b.WriteByte('$')
b.WriteString(itoa(n))
} else {
b.WriteRune(c)
}
}
return b.String()
}
func itoa(n int) string {
// small positive ints only
if n < 10 {
return string(rune('0' + n))
}
var buf [12]byte
i := len(buf)
for n > 0 {
i--
buf[i] = byte('0' + n%10)
n /= 10
}
return string(buf[i:])
}
// rewritingDB rewrites `?` placeholders when talking to Postgres.
type rewritingDB struct {
db *sql.DB
pg bool
}
func (d *rewritingDB) Exec(query string, args ...any) (sql.Result, error) {
if d.pg {
query = RewritePlaceholdersPG(query)
}
return d.db.Exec(query, args...)
}
func (d *rewritingDB) Query(query string, args ...any) (*sql.Rows, error) {
if d.pg {
query = RewritePlaceholdersPG(query)
}
return d.db.Query(query, args...)
}
func (d *rewritingDB) QueryRow(query string, args ...any) *sql.Row {
if d.pg {
query = RewritePlaceholdersPG(query)
}
return d.db.QueryRow(query, args...)
}
func (d *rewritingDB) Begin() (*sql.Tx, error) {
return d.db.Begin()
}
func (d *rewritingDB) Underlying() *sql.DB { return d.db }
type rewritingTx struct {
tx *sql.Tx
pg bool
}
func (t *rewritingTx) Exec(query string, args ...any) (sql.Result, error) {
if t.pg {
query = RewritePlaceholdersPG(query)
}
return t.tx.Exec(query, args...)
}
func (t *rewritingTx) Query(query string, args ...any) (*sql.Rows, error) {
if t.pg {
query = RewritePlaceholdersPG(query)
}
return t.tx.Query(query, args...)
}
func (t *rewritingTx) QueryRow(query string, args ...any) *sql.Row {
if t.pg {
query = RewritePlaceholdersPG(query)
}
return t.tx.QueryRow(query, args...)
}
func (t *rewritingTx) Commit() error { return t.tx.Commit() }
func (t *rewritingTx) Rollback() error { return t.tx.Rollback() }
// SQLDB is *sql.DB with optional Postgres `?` rewrite (RBAC / admin).
type SQLDB interface {
Exec(query string, args ...any) (sql.Result, error)
Query(query string, args ...any) (*sql.Rows, error)
QueryRow(query string, args ...any) *sql.Row
Begin() (SQLTx, error)
}
// SQLTx is a transaction with optional placeholder rewrite.
type SQLTx interface {
Exec(query string, args ...any) (sql.Result, error)
Query(query string, args ...any) (*sql.Rows, error)
QueryRow(query string, args ...any) *sql.Row
Commit() error
Rollback() error
}
type sqlDBHandle struct {
*rewritingDB
}
func (h *sqlDBHandle) Begin() (SQLTx, error) {
tx, err := h.rewritingDB.Begin()
if err != nil {
return nil, err
}
return &rewritingTx{tx: tx, pg: h.pg}, nil
}
// OpenSQLDB returns a pooled handle that rewrites `?` on Postgres.
func OpenSQLDB(url string) (SQLDB, error) {
raw, err := open(url)
if err != nil {
return nil, err
}
return &sqlDBHandle{rewritingDB: &rewritingDB{db: raw, pg: IsPostgres(url)}}, nil
}
+20 -3
View File
@@ -23,14 +23,23 @@ type txnConn struct {
}
func (t *txnConn) Exec(query string, args ...any) (sql.Result, error) {
if IsPostgres(t.url) {
query = RewritePlaceholdersPG(query)
}
return t.conn.ExecContext(context.Background(), query, args...)
}
func (t *txnConn) Query(query string, args ...any) (*sql.Rows, error) {
if IsPostgres(t.url) {
query = RewritePlaceholdersPG(query)
}
return t.conn.QueryContext(context.Background(), query, args...)
}
func (t *txnConn) QueryRow(query string, args ...any) *sql.Row {
if IsPostgres(t.url) {
query = RewritePlaceholdersPG(query)
}
return t.conn.QueryRowContext(context.Background(), query, args...)
}
@@ -74,7 +83,11 @@ func connFor(url, txnID string) (dbConn, error) {
}
return t, nil
}
return open(url)
raw, err := open(url)
if err != nil {
return nil, err
}
return &rewritingDB{db: raw, pg: IsPostgres(url)}, nil
}
func takeTxn(txnID string) (*txnConn, error) {
@@ -98,7 +111,7 @@ func resetTxns() {
}
}
// Begin starts a SQLite transaction (BEGIN IMMEDIATE).
// Begin starts a transaction (BEGIN IMMEDIATE on SQLite, BEGIN on Postgres).
// Returns {"_type":"txn","txn":id,"url":url,"事务":id,"地址":url}.
func Begin(url string) (map[string]any, error) {
db, err := open(url)
@@ -109,7 +122,11 @@ func Begin(url string) (map[string]any, error) {
if err != nil {
return nil, err
}
if _, err := conn.ExecContext(context.Background(), "BEGIN IMMEDIATE"); err != nil {
beginSQL := "BEGIN IMMEDIATE"
if IsPostgres(url) {
beginSQL = "BEGIN"
}
if _, err := conn.ExecContext(context.Background(), beginSQL); err != nil {
_ = conn.Close()
return nil, err
}
+151 -22
View File
@@ -2,6 +2,7 @@
package form
import (
"encoding/json"
"fmt"
"strconv"
"strings"
@@ -17,6 +18,7 @@ var (
typeKeys = []string{"类型", "type"}
reqKeys = []string{"必填", "required"}
defKeys = []string{"默认", "default"}
sourceKeys = []string{"来源", "source"}
ruleFieldKeys = []string{"字段", "field", "name"}
ruleKeys = []string{"规则", "rule"}
msgKeys = []string{"消息", "message", "msg"}
@@ -45,6 +47,8 @@ func normalizeAction(action string) string {
switch action {
case "update", "更新":
return "update"
case "delete", "删除":
return "delete"
case "":
return "insert"
default:
@@ -66,6 +70,24 @@ func SetRules(formBag map[string]any, rules any) map[string]any {
return out
}
// SetLabels stamps localized submit / cancel button copy (and optional cancel href).
// When cancelHref is set, also stamps redirect so successful POST lands on the list
// (or other cancel target) instead of the composing page's _mq_return path.
func SetLabels(formBag map[string]any, submit, cancel, cancelHref string) map[string]any {
out := cloneMap(formBag)
if s := strings.TrimSpace(submit); s != "" {
out["submit"] = s
}
if s := strings.TrimSpace(cancel); s != "" {
out["cancel"] = s
}
if s := strings.TrimSpace(cancelHref); s != "" {
out["cancel_href"] = s
out["redirect"] = s
}
return out
}
func cloneMap(m map[string]any) map[string]any {
out := map[string]any{}
for k, v := range m {
@@ -177,12 +199,19 @@ func asFormFields(fields any) []any {
if v, ok := pick(m, defKeys); ok {
def = cellStr(v)
}
source := "client"
if v, ok := pick(m, sourceKeys); ok {
if s := strings.TrimSpace(cellStr(v)); s != "" {
source = s
}
}
item := map[string]any{
"name": name,
"label": label,
"type": ty,
"required": required,
"default": def,
"source": normalizeSource(source),
}
if v, ok := m["pk"]; ok {
item["pk"] = boolish(v)
@@ -211,6 +240,10 @@ func asFormFields(fields any) []any {
if v, ok := pick(t, defKeys); ok {
defs = asStrList(v)
}
sources := []string{}
if v, ok := pick(t, sourceKeys); ok {
sources = asStrList(v)
}
var out []any
for i, nameRaw := range names {
name := table.NormalizeRef(nameRaw)
@@ -233,12 +266,17 @@ func asFormFields(fields any) []any {
if i < len(defs) {
def = defs[i]
}
source := "client"
if i < len(sources) && strings.TrimSpace(sources[i]) != "" {
source = sources[i]
}
out = append(out, map[string]any{
"name": name,
"label": label,
"type": ty,
"required": required,
"default": def,
"source": normalizeSource(source),
})
}
return out
@@ -614,6 +652,11 @@ func strOf(m map[string]any, key, def string) string {
// RenderBody emits form markup only (no document shell).
func RenderBody(formBag map[string]any, formID string, data, errors any, csrf string) string {
return RenderBodyCtx(formBag, formID, data, errors, csrf, nil)
}
// RenderBodyCtx is RenderBody plus request-context hidden fields for POST.
func RenderBodyCtx(formBag map[string]any, formID string, data, errors any, csrf string, ctx *RequestContext) string {
fields := fieldSlice(formBag)
dataM := map[string]any{}
if data != nil {
@@ -646,6 +689,9 @@ func RenderBody(formBag map[string]any, formID string, data, errors any, csrf st
if formBag != nil {
rowID = cellStr(formBag["id"])
}
if rowID == "" {
rowID = fieldText(dataM, "id")
}
showMeta := true
if formBag != nil {
if v, ok := formBag["show_meta"].(bool); ok {
@@ -654,21 +700,28 @@ func RenderBody(formBag map[string]any, formID string, data, errors any, csrf st
}
var body strings.Builder
body.WriteString(`<div class="site-form">`)
if showMeta {
fmt.Fprintf(&body, `<p class="meta">table=<code>%s</code> · action=<code>%s</code> · id=<code>%s</code></p>`,
esc(tableName), esc(action), esc(heading))
}
hasFile := false
hasMarkdown := false
for _, f := range fields {
if fm, ok := f.(map[string]any); ok {
ty, _ := fm["type"].(string)
if strings.EqualFold(ty, "file") {
hasFile = true
break
}
if strings.EqualFold(ty, "markdown") {
hasMarkdown = true
}
}
}
formClass := "site-form"
if hasMarkdown {
formClass += " editor-skin"
}
body.WriteString(`<div class="` + formClass + `">`)
if showMeta {
fmt.Fprintf(&body, `<p class="meta">table=<code>%s</code> · action=<code>%s</code> · id=<code>%s</code></p>`,
esc(tableName), esc(action), esc(heading))
}
body.WriteString(`<form method="post" action="` + esc(postTo) + `"`)
if hasFile {
body.WriteString(` enctype="multipart/form-data"`)
@@ -677,9 +730,32 @@ func RenderBody(formBag map[string]any, formID string, data, errors any, csrf st
if csrf != "" {
fmt.Fprintf(&body, `<input type="hidden" name="_csrf" value="%s"/>`, esc(csrf))
}
if action == "update" && rowID != "" {
hasIDField := false
for _, f := range fields {
if fm, ok := f.(map[string]any); ok {
if strOf(fm, "name", "") == "id" && IsClientSource(strOf(fm, "source", "client")) {
hasIDField = true
break
}
}
}
if (action == "update" || action == "delete") && rowID != "" && !hasIDField {
fmt.Fprintf(&body, `<input type="hidden" name="id" value="%s"/>`, esc(rowID))
}
if ctx != nil {
if len(ctx.Params) > 0 {
if b, err := json.Marshal(ctx.Params); err == nil {
fmt.Fprintf(&body, `<input type="hidden" name="_mq_params" value="%s"/>`, esc(string(b)))
}
}
ret := strings.TrimSpace(ctx.ReturnPath)
if ret == "" {
ret = strings.TrimSpace(ctx.Path)
}
if ret != "" && strings.HasPrefix(ret, "/") && !strings.HasPrefix(ret, "//") {
fmt.Fprintf(&body, `<input type="hidden" name="_mq_return" value="%s"/>`, esc(ret))
}
}
for _, f := range fields {
fm, ok := f.(map[string]any)
if !ok {
@@ -689,6 +765,9 @@ func RenderBody(formBag map[string]any, formID string, data, errors any, csrf st
if name == "" {
continue
}
if !IsClientSource(strOf(fm, "source", "client")) {
continue
}
label := strOf(fm, "label", name)
ty := strOf(fm, "type", "text")
required, _ := fm["required"].(bool)
@@ -712,11 +791,26 @@ func RenderBody(formBag map[string]any, formID string, data, errors any, csrf st
if required {
reqAttr = " required"
}
if ty == "hidden" {
fmt.Fprintf(&body, `<input type="hidden" name="%s" value="%s"/>`, esc(name), esc(value))
continue
}
body.WriteString("<label>")
body.WriteString(esc(label))
if ty == "textarea" {
fmt.Fprintf(&body, `<textarea name="%s" rows="5"%s>%s</textarea>`,
esc(name), reqAttr, esc(value))
if ty == "textarea" || ty == "markdown" {
rows := "5"
cls := ""
if ty == "markdown" {
rows = "18"
cls = ` class="mq-markdown" data-mq-field="markdown"`
body.WriteString(`<div class="md-field">`)
fmt.Fprintf(&body, `<textarea name="%s" rows="%s"%s%s>%s</textarea>`,
esc(name), rows, cls, reqAttr, esc(value))
body.WriteString(`<div class="mq-md-preview md-pane-preview" aria-live="polite"></div></div>`)
} else {
fmt.Fprintf(&body, `<textarea name="%s" rows="%s"%s%s>%s</textarea>`,
esc(name), rows, cls, reqAttr, esc(value))
}
} else {
inputType := "text"
switch ty {
@@ -743,8 +837,28 @@ func RenderBody(formBag map[string]any, formID string, data, errors any, csrf st
}
body.WriteString("</label>")
}
fmt.Fprintf(&body, `<div class="actions"><button type="submit">Submit</button><a href="%s">cancel</a></div>`,
esc(cancel))
submitLabel := strOf(formBag, "submit", "")
if submitLabel == "" {
submitLabel = strOf(formBag, "提交", "")
}
if submitLabel == "" {
submitLabel = "Submit"
}
cancelLabel := strOf(formBag, "cancel", "")
if cancelLabel == "" {
cancelLabel = strOf(formBag, "取消", "")
}
if cancelLabel == "" {
cancelLabel = "cancel"
}
cancelHref := cancel
if c := strOf(formBag, "cancel_href", ""); c != "" {
cancelHref = c
} else if c := strOf(formBag, "取消链接", ""); c != "" {
cancelHref = c
}
fmt.Fprintf(&body, `<div class="actions"><button type="submit">%s</button><a href="%s">%s</a></div>`,
esc(submitLabel), esc(cancelHref), esc(cancelLabel))
body.WriteString(`</form></div>`)
return body.String()
}
@@ -784,7 +898,7 @@ body{font-family:"IBM Plex Sans","Noto Sans SC",sans-serif;margin:1.5rem;backgro
func Submit(formBag map[string]any, data any, dbURL string) (map[string]any, error) {
action := strOf(formBag, "action", "insert")
rowMap := dataMap(data)
if action == "update" {
if action == "update" || action == "delete" {
if formBag != nil {
if fid := cellStr(formBag["id"]); fid != "" {
if _, ok := rowMap["id"]; !ok {
@@ -793,14 +907,16 @@ func Submit(formBag map[string]any, data any, dbURL string) (map[string]any, err
}
}
}
v := Validate(formBag, nil, rowMap)
ok, _ := v["ok"].(bool)
if !ok {
errs := v["errors"]
if errs == nil {
errs = []any{}
if action != "delete" {
v := Validate(formBag, nil, rowMap)
ok, _ := v["ok"].(bool)
if !ok {
errs := v["errors"]
if errs == nil {
errs = []any{}
}
return map[string]any{"ok": false, "errors": errs}, nil
}
return map[string]any{"ok": false, "errors": errs}, nil
}
tableName := ""
if formBag != nil {
@@ -811,7 +927,20 @@ func Submit(formBag map[string]any, data any, dbURL string) (map[string]any, err
}
var result map[string]any
var err error
if action == "update" {
switch action {
case "delete":
id := ""
if formBag != nil {
id = cellStr(formBag["id"])
}
if id == "" {
id = cellStr(rowMap["id"])
}
if id == "" {
return nil, fmt.Errorf("delete requires `id`")
}
result, err = db.Delete(dbURL, tableName, id)
case "update":
id := ""
if formBag != nil {
id = cellStr(formBag["id"])
@@ -823,7 +952,7 @@ func Submit(formBag map[string]any, data any, dbURL string) (map[string]any, err
return nil, fmt.Errorf("update requires `id`")
}
result, err = db.Update(dbURL, tableName, id, rowMap)
} else {
default:
result, err = db.Insert(dbURL, tableName, []any{rowMap})
}
if err != nil {
+25
View File
@@ -68,3 +68,28 @@ func TestRenderContainsInputFields(t *testing.T) {
}
}
}
func TestRenderMarkdownAndLabels(t *testing.T) {
f := form.New("posts", "insert", "")
f = form.SetFields(f, []any{
map[string]any{"字段": "content", "标签": "正文", "类型": "markdown", "必填": true},
})
f = form.SetLabels(f, "发布文章", "返回列表", "/desk/posts")
if f["redirect"] != "/desk/posts" || f["cancel_href"] != "/desk/posts" {
t.Fatalf("labels should stamp redirect/cancel_href, got %#v %#v", f["redirect"], f["cancel_href"])
}
html := form.Render(f, "post", nil, nil, "")
for _, want := range []string{
`data-mq-field="markdown"`,
`class="mq-markdown"`,
`class="md-field"`,
`mq-md-preview`,
">发布文章</button>",
`href="/desk/posts"`,
">返回列表</a>",
} {
if !strings.Contains(html, want) {
t.Fatalf("missing %q in:\n%s", want, html)
}
}
}
+128
View File
@@ -0,0 +1,128 @@
package form
import (
"encoding/json"
"strings"
"time"
)
func normalizeSource(raw string) string {
s := strings.TrimSpace(raw)
if s == "" {
return "client"
}
switch strings.ToLower(s) {
case "client", "用户", "input", "form":
return "client"
case "user", "username", "session.user", "session.username", "用户名":
return "session.username"
case "now", "utc.now", "server.now", "时间", "utc":
return "now"
case "now_if_empty", "空则现在", "now?":
return "now_if_empty"
default:
return s
}
}
// IsClientSource reports whether the field is filled by the browser.
func IsClientSource(source string) bool {
src := normalizeSource(source)
return src == "client" || src == "now_if_empty"
}
// RequestContext carries session user and route params for form source stamping
// (design: ext-web-request-context.md). Domain-agnostic — no table-name branches.
type RequestContext struct {
Username string
Params map[string]any
ReturnPath string
Path string
Method string
}
// ApplySources strips client-supplied values for non-client fields, then stamps
// from ctx. Always overwrites server-owned keys. `now_if_empty` keeps a non-empty
// client value and only stamps UTC now when the field was left blank.
func ApplySources(formBag map[string]any, data map[string]any, ctx *RequestContext) {
if data == nil {
return
}
if ctx == nil {
ctx = &RequestContext{}
}
for _, f := range fieldSlice(formBag) {
fm, ok := f.(map[string]any)
if !ok {
continue
}
name, _ := fm["name"].(string)
if name == "" {
continue
}
src := normalizeSource(strOf(fm, "source", "client"))
switch src {
case "client":
continue
case "now_if_empty":
if data[name] != nil && strings.TrimSpace(cellStr(data[name])) != "" {
continue
}
if v, ok := resolveSource("now", ctx); ok {
data[name] = v
}
default:
delete(data, name)
if v, ok := resolveSource(src, ctx); ok {
data[name] = v
}
}
}
}
func resolveSource(src string, ctx *RequestContext) (any, bool) {
src = normalizeSource(src)
switch src {
case "client":
return nil, false
case "session.username":
if ctx.Username == "" {
return nil, false
}
return ctx.Username, true
case "now":
return time.Now().UTC().Format("2006-01-02 15:04:05"), true
}
lower := strings.ToLower(src)
for _, prefix := range []string{"route.", "param.", "params."} {
if strings.HasPrefix(lower, prefix) {
key := src[len(prefix):]
if key == "" || ctx.Params == nil {
return nil, false
}
if v, ok := ctx.Params[key]; ok {
return v, true
}
for k, v := range ctx.Params {
if strings.EqualFold(k, key) {
return v, true
}
}
return nil, false
}
}
return nil, false
}
// ParseMQParams decodes the hidden `_mq_params` JSON posted with forms.
func ParseMQParams(raw string) map[string]any {
raw = strings.TrimSpace(raw)
if raw == "" {
return nil
}
var out map[string]any
if err := json.Unmarshal([]byte(raw), &out); err != nil {
return nil
}
return out
}
+83
View File
@@ -0,0 +1,83 @@
package form
import "testing"
func TestApplySourcesOverwritesClient(t *testing.T) {
frm := SetFields(New("comments", "insert", "c"), []any{
map[string]any{"字段": "body", "标签": "body", "类型": "textarea", "必填": true, "来源": "client"},
map[string]any{"字段": "author", "标签": "a", "类型": "text", "必填": true, "来源": "session.username"},
map[string]any{"字段": "post_slug", "标签": "s", "类型": "text", "必填": true, "来源": "route.slug"},
map[string]any{"字段": "created_at", "标签": "t", "类型": "text", "来源": "now"},
})
data := map[string]any{
"body": "hi",
"author": "forged",
"post_slug": "evil",
}
ApplySources(frm, data, &RequestContext{
Username: "alice",
Params: map[string]any{"slug": "hello"},
})
if data["author"] != "alice" {
t.Fatalf("author=%v", data["author"])
}
if data["post_slug"] != "hello" {
t.Fatalf("slug=%v", data["post_slug"])
}
if data["body"] != "hi" {
t.Fatalf("body=%v", data["body"])
}
if data["created_at"] == nil || data["created_at"] == "" {
t.Fatalf("created_at missing")
}
}
func TestApplySourcesNowIfEmpty(t *testing.T) {
frm := SetFields(New("news", "insert", "n"), []any{
map[string]any{"字段": "title", "标签": "t", "类型": "text", "必填": true},
map[string]any{"字段": "published_at", "标签": "d", "类型": "text", "来源": "空则现在"},
})
empty := map[string]any{"title": "x", "published_at": ""}
ApplySources(frm, empty, &RequestContext{})
if empty["published_at"] == nil || empty["published_at"] == "" {
t.Fatalf("expected stamp, got %#v", empty["published_at"])
}
kept := map[string]any{"title": "x", "published_at": "2020-01-02"}
ApplySources(frm, kept, &RequestContext{})
if kept["published_at"] != "2020-01-02" {
t.Fatalf("should keep client date, got %#v", kept["published_at"])
}
}
func TestRenderSkipsServerSources(t *testing.T) {
frm := SetFields(New("comments", "insert", "c"), []any{
map[string]any{"字段": "body", "标签": "Body", "类型": "textarea", "必填": true},
map[string]any{"字段": "author", "标签": "Author", "类型": "text", "来源": "session.username"},
})
html := RenderBodyCtx(frm, "c", nil, nil, "", &RequestContext{
Username: "alice",
Params: map[string]any{"slug": "x"},
ReturnPath: "/post/x",
})
if stringsContains(html, `name="author"`) {
t.Fatalf("author field should not render: %s", html)
}
if !stringsContains(html, `name="body"`) {
t.Fatalf("body missing")
}
if !stringsContains(html, `_mq_params`) || !stringsContains(html, `_mq_return`) {
t.Fatalf("missing mq context fields: %s", html)
}
}
func stringsContains(s, sub string) bool {
return len(s) >= len(sub) && (s == sub || len(sub) == 0 ||
(func() bool {
for i := 0; i+len(sub) <= len(s); i++ {
if s[i:i+len(sub)] == sub {
return true
}
}
return false
})())
}
+501 -49
View File
@@ -1,15 +1,19 @@
package httpx
import (
"encoding/json"
"fmt"
"io"
"net"
"net/http"
"strconv"
"strings"
"github.com/marqdo/marqdo/plugins/web/internal/app"
"github.com/marqdo/marqdo/plugins/web/internal/auth"
"github.com/marqdo/marqdo/plugins/web/internal/password"
"github.com/marqdo/marqdo/plugins/web/internal/ratelimit"
"github.com/marqdo/marqdo/plugins/web/internal/rbac"
"github.com/marqdo/marqdo/plugins/web/internal/session"
)
@@ -28,23 +32,29 @@ const (
)
type gate struct {
path string
roles []string
matchMode gateMatch
onDeny onDeny
exclude []string
path string
roles []string
permissions []string
matchMode gateMatch
onDeny onDeny
exclude []string
}
type authConfig struct {
users any
sessionTTL uint64
cookieSecure bool
admin bool
adminPrefix string
loginPath string
loginRedirect string
logoutRedirect string
gates []gate
users any
sessionTTL uint64
cookieSecure bool
admin bool
adminPrefix string
loginPath string
loginRedirect string
logoutRedirect string
gates []gate
rbac bool
rbacDesk bool
register bool
registerPath string
defaultRole string
}
func authConfigOf(appBag map[string]any) authConfig {
@@ -68,6 +78,7 @@ func authConfigOf(appBag map[string]any) authConfig {
if v, ok := appBag["cookie_secure"].(bool); ok {
cfg.cookieSecure = v
}
cfg.registerPath = strOpt(appBag, "register_path", "")
if authBag, ok := appBag["auth"].(map[string]any); ok {
cfg.users = authBag["users"]
if n, ok := asUint64(authBag["session_ttl"]); ok && n > 0 {
@@ -75,6 +86,19 @@ func authConfigOf(appBag map[string]any) authConfig {
} else if n, ok := asUint64(authBag["ttl"]); ok && n > 0 {
cfg.sessionTTL = n
}
cfg.rbac = boolish(authBag["rbac"])
cfg.rbacDesk = boolish(authBag["rbac_desk"])
cfg.register = boolish(authBag["register"])
if p := strOpt(authBag, "register_path", ""); p != "" {
cfg.registerPath = p
}
cfg.defaultRole = strOpt(authBag, "default_role", "")
if cfg.defaultRole == "" {
cfg.defaultRole = "member"
}
}
if cfg.registerPath == "" {
cfg.registerPath = "/register"
}
cfg.gates = parseGates(appBag["gates"])
return cfg
@@ -106,7 +130,11 @@ func parseGates(v any) []gate {
if roles == nil {
roles = parseGateRoles(m["角色"])
}
if len(roles) == 0 {
perms := parseGateRoles(m["permissions"])
if perms == nil {
perms = parseGateRoles(m["权限"])
}
if len(roles) == 0 && len(perms) == 0 {
roles = []string{"admin"}
}
matchS := strings.ToLower(strings.TrimSpace(strOpt(m, "match", "")))
@@ -136,11 +164,12 @@ func parseGates(v any) []gate {
on = onDenyForbid
}
out = append(out, gate{
path: path,
roles: roles,
matchMode: matchMode,
onDeny: on,
exclude: parseExclude(m["exclude"], m["排除"]),
path: path,
roles: roles,
permissions: perms,
matchMode: matchMode,
onDeny: on,
exclude: parseExclude(m["exclude"], m["排除"]),
})
}
return out
@@ -218,6 +247,13 @@ func pathExcluded(path string, exclude []string, loginPath string) bool {
if path == loginPath || strings.HasPrefix(path, loginPath+"?") {
return true
}
if strings.HasPrefix(path, "/oidc/") {
return true
}
// Local logout must always run; never bounce visitors to login→IdP first.
if path == "/logout" || strings.HasSuffix(path, "/logout") {
return true
}
for _, ex := range exclude {
ex = strings.TrimRight(strings.TrimSuffix(ex, "*"), "/")
if ex == "" {
@@ -245,7 +281,17 @@ func withRBAC(next http.Handler, gates []gate, loginPath string) http.Handler {
break
}
role := session.RoleFromCookie(cookie)
if !session.RoleAllowed(role, g.roles) {
allowed := false
if len(g.permissions) > 0 {
held := session.PermissionsFromCookie(cookie)
if len(held) == 0 && role != "visitor" {
held = expandLegacyRole(role)
}
allowed = session.PermissionAllowed(held, g.permissions)
} else {
allowed = session.RoleAllowed(role, g.roles)
}
if !allowed {
if role == "visitor" && g.onDeny == onDenyRedirect {
nextQ := urlEncodePath(path)
dest := loginPath
@@ -268,6 +314,22 @@ func withRBAC(next http.Handler, gates []gate, loginPath string) http.Handler {
})
}
func expandLegacyRole(role string) []string {
switch strings.ToLower(strings.TrimSpace(role)) {
case "superadmin", "admin":
return []string{
"comments:create", "comments:delete", "comments:delete_own",
"desk:access", "roles:manage", "posts:edit", "users:manage",
}
case "member", "user":
return []string{"comments:create", "comments:delete_own"}
case "editor", "author":
return []string{"comments:create", "comments:delete_own", "posts:edit", "desk:access"}
default:
return nil
}
}
func urlEncodePath(path string) string {
var out strings.Builder
for _, b := range []byte(path) {
@@ -302,21 +364,53 @@ func withNavAuth(page map[string]any, cookieHeader string) {
}
}
func (st *state) hasPageRoute(path string) bool {
if path == "" || st.routes == nil {
return false
}
_, ok := st.routes[path]
return ok
}
func (st *state) mountAuthRoutes(mux *http.ServeMux) {
if st.auth.users == nil {
st.mountOIDCRoutes(mux)
if st.auth.users == nil && !(st.auth.rbac && st.auth.register) && !st.oidcEnabled() {
return
}
lp := st.auth.loginPath
mux.HandleFunc("GET "+lp, st.handleLoginGet)
mux.HandleFunc("POST "+lp, st.handleLoginPost)
altLogin := strings.TrimRight(st.auth.adminPrefix, "/") + "/login"
if altLogin != lp {
mux.HandleFunc("GET "+altLogin, st.handleLoginGet)
mux.HandleFunc("POST "+altLogin, st.handleLoginPost)
if st.auth.users != nil || st.auth.rbac || st.oidcEnabled() {
lp := st.auth.loginPath
// Site pages may own GET /login (or /desk/login); always keep POST for auth.
if !st.hasPageRoute(lp) {
mux.HandleFunc("GET "+lp, st.handleLoginGet)
}
mux.HandleFunc("POST "+lp, st.handleLoginPost)
altLogin := strings.TrimRight(st.auth.adminPrefix, "/") + "/login"
if altLogin != lp {
if !st.hasPageRoute(altLogin) {
mux.HandleFunc("GET "+altLogin, st.handleLoginGet)
}
mux.HandleFunc("POST "+altLogin, st.handleLoginPost)
}
st.mountExtraLoginPosts(mux, map[string]bool{lp: true, altLogin: true})
logoutPath := strings.TrimRight(st.auth.adminPrefix, "/") + "/logout"
mux.HandleFunc("GET "+logoutPath, st.handleLogout)
}
if st.auth.register && st.auth.rbac && !st.oidcEnabled() {
rp := st.auth.registerPath
if !st.hasPageRoute(rp) {
mux.HandleFunc("GET "+rp, st.handleRegisterGet)
}
mux.HandleFunc("POST "+rp, st.handleRegisterPost)
}
// Opt-in: enable_rbac alone wires gates/schema; /_rbac HTTP surface needs desk=true.
if st.auth.rbac && st.auth.rbacDesk && st.dbURL != "" {
mux.HandleFunc("GET /_rbac/roles", st.handleRbacListRoles)
mux.HandleFunc("GET /_rbac/permissions", st.handleRbacListPermissions)
mux.HandleFunc("POST /_rbac/roles", st.handleRbacCreateRole)
mux.HandleFunc("POST /_rbac/roles/{id}/permissions", st.handleRbacSetRolePerms)
mux.HandleFunc("POST /_rbac/assign", st.handleRbacAssign)
mux.HandleFunc("GET /_rbac/desk", st.handleRbacDesk)
}
// Logout is part of session auth, not only built-in admin=True chrome.
logoutPath := strings.TrimRight(st.auth.adminPrefix, "/") + "/logout"
mux.HandleFunc("GET "+logoutPath, st.handleLogout)
if st.auth.admin {
adminHome := strings.TrimRight(st.auth.adminPrefix, "/")
if adminHome == "" {
@@ -327,7 +421,11 @@ func (st *state) mountAuthRoutes(mux *http.ServeMux) {
}
func (st *state) handleLoginGet(w http.ResponseWriter, r *http.Request) {
if st.auth.users == nil {
if st.oidcEnabled() {
st.handleOIDCStart(w, r)
return
}
if st.auth.users == nil && !st.auth.rbac {
http.Redirect(w, r, st.auth.loginRedirect, http.StatusSeeOther)
return
}
@@ -344,7 +442,11 @@ func (st *state) handleLoginGet(w http.ResponseWriter, r *http.Request) {
}
func (st *state) handleLoginPost(w http.ResponseWriter, r *http.Request) {
if st.auth.users == nil {
if st.oidcEnabled() {
st.handleOIDCStart(w, r)
return
}
if st.auth.users == nil && !st.auth.rbac {
http.Redirect(w, r, st.auth.loginRedirect, http.StatusSeeOther)
return
}
@@ -353,14 +455,12 @@ func (st *state) handleLoginPost(w http.ResponseWriter, r *http.Request) {
return
}
cookieHdr := r.Header.Get("Cookie")
sid, csrf, setCookie := resolveSession(r)
sid, _, _ := resolveSession(r)
_, hadCookie := session.IDFromCookie(cookieHdr)
csrfToken := r.FormValue("_csrf")
if csrfToken != "" || hadCookie {
if !session.ValidateCSRF(sid, csrfToken) {
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
_, _ = io.WriteString(w, "<p class=\"flash err\">Invalid or missing CSRF token. Refresh and try again.</p>")
st.writeAuthFailure(w, r, "Invalid or missing CSRF token. Refresh and try again.")
return
}
}
@@ -368,34 +468,93 @@ func (st *state) handleLoginPost(w http.ResponseWriter, r *http.Request) {
password := r.FormValue("password")
ip := clientIP(r)
if err := ratelimit.Check(ip, username); err != nil {
msg := err.Error()
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
_, _ = io.WriteString(w, loginPageHTML(st.auth.loginPath, &msg, csrf, r.FormValue("next")))
st.writeAuthFailure(w, r, err.Error())
return
}
res := auth.Login(username, password, st.auth.users, st.auth.sessionTTL)
res := st.tryLogin(username, password)
if ok, _ := res["ok"].(bool); !ok {
ratelimit.RecordFailure(ip, username)
errMsg := "Invalid username or password."
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
_, _ = io.WriteString(w, loginPageHTML(st.auth.loginPath, &errMsg, csrf, r.FormValue("next")))
st.writeAuthFailure(w, r, "Invalid username or password.")
return
}
ratelimit.ClearSuccess(ip, username)
sessID, _ := res["session_id"].(string)
dest := loginDest(r, st.auth.loginRedirect)
role, _ := res["role"].(string)
st.attachLoginPermissions(sessID, username, role)
fallback := st.auth.loginRedirect
if page := st.pageForAuthPath(r.URL.Path); page != nil {
if af, ok := page["auth_form"].(map[string]any); ok {
if n, ok := af["next"].(string); ok {
if n = strings.TrimSpace(n); n != "" {
fallback = n
}
}
}
}
dest := loginDest(r, fallback)
held := session.PermissionsFromSession(sessID)
if (strings.HasPrefix(dest, "/desk") || strings.HasPrefix(dest, "/admin")) &&
!session.PermissionAllowed(held, []string{"desk:access"}) {
dest = "/"
}
w.Header().Add("Set-Cookie", session.IssueCookie(sessID))
http.Redirect(w, r, dest, http.StatusSeeOther)
}
// tryLogin: GFM users first, then web_users when RBAC is on.
func (st *state) tryLogin(username, password string) map[string]any {
if st.auth.users != nil {
res := auth.Login(username, password, st.auth.users, st.auth.sessionTTL)
if ok, _ := res["ok"].(bool); ok {
u, _ := res["username"].(string)
role, _ := res["role"].(string)
st.seedGFMUserIntoRBAC(u, password, role)
return res
}
}
if st.auth.rbac && st.dbURL != "" {
role, ok, err := rbac.Authenticate(st.dbURL, username, password, passwordVerify)
if err == nil && ok {
id := session.NewID(st.auth.sessionTTL)
session.SetValue(id, "username", username)
session.SetValue(id, "role", role)
return map[string]any{
"ok": true, "session_id": id, "username": username, "role": role,
}
}
}
return map[string]any{"ok": false}
}
func (st *state) attachLoginPermissions(sessID, username, role string) {
var perms []string
if st.dbURL != "" && st.auth.rbac {
if dbPerms, err := rbac.PermissionsForUser(st.dbURL, username); err == nil && len(dbPerms) > 0 {
perms = dbPerms
}
}
if len(perms) == 0 {
perms = rbac.ExpandRole(role)
}
if len(perms) == 0 {
perms = expandLegacyRole(role)
}
auth.AttachPermissions(sessID, perms)
}
func (st *state) handleLogout(w http.ResponseWriter, r *http.Request) {
if sid, ok := session.IDFromCookie(r.Header.Get("Cookie")); ok {
auth.Logout(sid)
}
w.Header().Add("Set-Cookie", session.ClearCookie())
http.Redirect(w, r, st.auth.logoutRedirect, http.StatusSeeOther)
dest := strings.TrimSpace(st.auth.logoutRedirect)
// With OIDC, /login (and siblings) immediately bounce to the IdP — that is
// re-auth, not logout. Land on a public page instead.
if dest == "" || (st.oidcEnabled() && st.isOIDCEntryPath(dest)) {
dest = "/"
}
http.Redirect(w, r, dest, http.StatusSeeOther)
}
func (st *state) handleAdminHome(w http.ResponseWriter, r *http.Request) {
@@ -469,6 +628,299 @@ a.back:hover { color:#f5e6c8; }
</body></html>`, errHTML, esc(loginAction), csrfField, nextField)
}
func passwordVerify(pass, encoded string) bool {
return password.Verify(pass, encoded)
}
func (st *state) seedGFMUserIntoRBAC(username, plaintext, role string) {
if !st.auth.rbac || st.dbURL == "" || username == "" {
return
}
exists, err := rbac.UserExists(st.dbURL, username)
if err != nil || exists {
return
}
hash, err := password.Hash(plaintext)
if err != nil {
return
}
target := "member"
switch strings.ToLower(role) {
case "admin", "superadmin":
target = "superadmin"
case "editor", "author":
// custom roles may not exist yet; fall back to member + ExpandRole at session
target = "member"
}
_ = rbac.EnsureUserWithRole(st.dbURL, username, hash, target)
}
func (st *state) handleRegisterGet(w http.ResponseWriter, r *http.Request) {
_, csrf, setCookie := resolveSession(r)
html := registerPageHTML(st.auth.registerPath, nil, csrf)
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
_, _ = io.WriteString(w, html)
}
func (st *state) handleRegisterPost(w http.ResponseWriter, r *http.Request) {
if err := r.ParseForm(); err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
sid, _, _ := resolveSession(r)
_, hadCookie := session.IDFromCookie(r.Header.Get("Cookie"))
csrfToken := r.FormValue("_csrf")
if csrfToken != "" || hadCookie {
if !session.ValidateCSRF(sid, csrfToken) {
st.writeRegisterFailure(w, r, "Invalid CSRF token.")
return
}
}
username := strings.TrimSpace(r.FormValue("username"))
pass := r.FormValue("password")
if len(username) < 2 || len(pass) < 4 {
st.writeRegisterFailure(w, r, "Username (≥2) and password (≥4) required.")
return
}
hash, err := password.Hash(pass)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
if err := rbac.RegisterUser(st.dbURL, username, hash, st.auth.defaultRole); err != nil {
st.writeRegisterFailure(w, r, err.Error())
return
}
res := st.tryLogin(username, pass)
if ok, _ := res["ok"].(bool); ok {
sessID, _ := res["session_id"].(string)
role, _ := res["role"].(string)
st.attachLoginPermissions(sessID, username, role)
w.Header().Add("Set-Cookie", session.IssueCookie(sessID))
dest := st.auth.loginRedirect
held := session.PermissionsFromSession(sessID)
if !session.PermissionAllowed(held, []string{"desk:access"}) {
dest = "/"
}
http.Redirect(w, r, dest, http.StatusSeeOther)
return
}
http.Redirect(w, r, st.auth.loginPath, http.StatusSeeOther)
}
func registerPageHTML(action string, errMsg *string, csrf string) string {
errHTML := ""
if errMsg != nil && *errMsg != "" {
errHTML = fmt.Sprintf("<p class=\"flash err\">%s</p>", esc(*errMsg))
}
csrfField := ""
if csrf != "" {
csrfField = fmt.Sprintf("<input type=\"hidden\" name=\"_csrf\" value=\"%s\"/>", esc(csrf))
}
return fmt.Sprintf(`<!DOCTYPE html>
<html lang="en"><head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Register</title>
<style>
:root { --ink:#0a0809; --paper:#f5e6c8; --gold:#d4af37; --err:#b91c1c; }
* { box-sizing:border-box; }
body { margin:0; min-height:100vh; display:grid; place-items:center; color:var(--paper); font-family:"Noto Sans SC","IBM Plex Sans",system-ui,sans-serif;
background: radial-gradient(ellipse 90%% 55%% at 50%% -15%%, rgba(107,30,58,.5), transparent 58%%), linear-gradient(180deg,#0a0809,#120c10 45%%,#0a0809); }
.login { background:rgba(0,0,0,.45); border:1px solid rgba(212,175,55,.28); border-radius:12px; padding:2rem 2.25rem; width:min(92vw,22rem); }
.login h1 { margin:0 0 .25rem; font-size:1.55rem; color:var(--gold); }
.login .sub { color:rgba(245,230,200,.72); margin:0 0 1.25rem; font-size:.9rem; }
.login form { display:grid; gap:.9rem; }
.login label { display:grid; gap:.25rem; font-size:.85rem; }
.login input { padding:.6rem .75rem; border:1px solid rgba(212,175,55,.35); border-radius:8px; font:inherit; color:var(--paper); background:rgba(10,8,9,.7); }
.login button { background:linear-gradient(135deg,#f5e6c8,var(--gold)); color:var(--ink); border:0; padding:.65rem 1rem; border-radius:999px; cursor:pointer; font:inherit; font-weight:600; }
.flash.err { background:rgba(185,28,28,.15); color:#fecaca; border:1px solid rgba(185,28,28,.45); padding:.6rem .8rem; border-radius:8px; margin:0 0 .9rem; font-size:.9rem; }
a.back { color:var(--gold); text-decoration:none; font-size:.85rem; }
</style>
</head>
<body>
<div class="login">
<h1>Create account</h1>
<p class="sub">New members get the default role (comments).</p>
%s
<form method="post" action="%s">
%s
<label>Username<input name="username" autocomplete="username" required autofocus/></label>
<label>Password<input name="password" type="password" autocomplete="new-password" required/></label>
<button type="submit">Register</button>
</form>
<p style="margin:1.1rem 0 0"><a class="back" href="/login">← Sign in</a></p>
</div>
</body></html>`, errHTML, esc(action), csrfField)
}
func (st *state) requireRolesManage(w http.ResponseWriter, r *http.Request) bool {
held := session.PermissionsFromCookie(r.Header.Get("Cookie"))
if !session.PermissionAllowed(held, []string{"roles:manage"}) {
http.Error(w, "forbidden", http.StatusForbidden)
return false
}
return true
}
func (st *state) writeJSON(w http.ResponseWriter, status int, v any) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.WriteHeader(status)
_ = json.NewEncoder(w).Encode(v)
}
func (st *state) handleRbacListRoles(w http.ResponseWriter, r *http.Request) {
if !st.requireRolesManage(w, r) {
return
}
roles, err := rbac.ListRoles(st.dbURL)
if err != nil {
st.writeJSON(w, http.StatusInternalServerError, map[string]any{"ok": false, "error": err.Error()})
return
}
st.writeJSON(w, http.StatusOK, map[string]any{"ok": true, "roles": roles})
}
func (st *state) handleRbacListPermissions(w http.ResponseWriter, r *http.Request) {
if !st.requireRolesManage(w, r) {
return
}
perms, err := rbac.ListPermissions(st.dbURL)
if err != nil {
st.writeJSON(w, http.StatusInternalServerError, map[string]any{"ok": false, "error": err.Error()})
return
}
st.writeJSON(w, http.StatusOK, map[string]any{"ok": true, "permissions": perms})
}
func (st *state) handleRbacCreateRole(w http.ResponseWriter, r *http.Request) {
if !st.requireRolesManage(w, r) {
return
}
var body struct {
Name string `json:"name"`
}
if err := json.NewDecoder(r.Body).Decode(&body); err != nil || strings.TrimSpace(body.Name) == "" {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": "name required"})
return
}
id, err := rbac.CreateRole(st.dbURL, strings.TrimSpace(body.Name))
if err != nil {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": err.Error()})
return
}
st.writeJSON(w, http.StatusOK, map[string]any{"ok": true, "id": id, "name": body.Name})
}
func (st *state) handleRbacSetRolePerms(w http.ResponseWriter, r *http.Request) {
if !st.requireRolesManage(w, r) {
return
}
idStr := r.PathValue("id")
roleID, err := strconv.ParseInt(idStr, 10, 64)
if err != nil {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": "bad id"})
return
}
var body struct {
Permissions []string `json:"permissions"`
}
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": "bad json"})
return
}
grantable := session.PermissionsFromCookie(r.Header.Get("Cookie"))
if err := rbac.SetRolePermissions(st.dbURL, roleID, body.Permissions, grantable); err != nil {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": err.Error()})
return
}
st.writeJSON(w, http.StatusOK, map[string]any{"ok": true})
}
func (st *state) handleRbacAssign(w http.ResponseWriter, r *http.Request) {
if !st.requireRolesManage(w, r) {
return
}
var body struct {
Username string `json:"username"`
Role string `json:"role"`
}
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": "bad json"})
return
}
if err := rbac.AssignRole(st.dbURL, body.Username, body.Role); err != nil {
st.writeJSON(w, http.StatusBadRequest, map[string]any{"ok": false, "error": err.Error()})
return
}
st.writeJSON(w, http.StatusOK, map[string]any{"ok": true})
}
func (st *state) handleRbacDesk(w http.ResponseWriter, r *http.Request) {
if !st.requireRolesManage(w, r) {
return
}
roles, _ := rbac.ListRoles(st.dbURL)
perms, _ := rbac.ListPermissions(st.dbURL)
var roleOpts, permChecks strings.Builder
for _, role := range roles {
name, _ := role["name"].(string)
id := role["id"]
sys, _ := role["is_system"].(bool)
tag := ""
if sys {
tag = " (system)"
}
fmt.Fprintf(&roleOpts, `<option value="%v">%s%s</option>`, id, esc(name), tag)
}
for _, p := range perms {
code, _ := p["code"].(string)
desc, _ := p["description"].(string)
fmt.Fprintf(&permChecks, `<label style="display:block;margin:.25rem 0"><input type="checkbox" name="perm" value="%s"/> %s — %s</label>`,
esc(code), esc(code), esc(desc))
}
html := fmt.Sprintf(`<!DOCTYPE html>
<html lang="zh"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Roles · RBAC</title>
<style>
body{font-family:"Noto Sans SC",system-ui,sans-serif;max-width:42rem;margin:2rem auto;padding:0 1rem;line-height:1.5}
h1{font-size:1.4rem} section{margin:1.5rem 0;padding:1rem;border:1px solid #ddd;border-radius:8px}
button{padding:.5rem 1rem;cursor:pointer} input,select{padding:.4rem;margin:.25rem 0;width:100%%;max-width:20rem}
#msg{min-height:1.2rem;color:#b91c1c}
</style></head><body>
<h1>角色与权限</h1>
<p>需 <code>roles:manage</code>。系统角色权限不可在此改写;可新建角色并勾选权限,或给用户赋角色。</p>
<p id="msg"></p>
<section>
<h2>新建角色</h2>
<input id="new-role" placeholder="角色名"/><button type="button" id="btn-create">创建</button>
</section>
<section>
<h2>设置角色权限</h2>
<select id="role-sel">%s</select>
<div>%s</div>
<button type="button" id="btn-set">保存权限</button>
</section>
<section>
<h2>赋角色给用户</h2>
<input id="assign-user" placeholder="用户名"/>
<input id="assign-role" placeholder="角色名(如 member)"/>
<button type="button" id="btn-assign">赋权</button>
</section>
<p><a href="/desk">← 后台</a></p>
<script>
const msg=document.getElementById('msg');
async function j(url,opt){const r=await fetch(url,Object.assign({credentials:'same-origin',headers:{'Content-Type':'application/json'}},opt||{}));const d=await r.json();if(!d.ok)throw new Error(d.error||r.status);return d;}
document.getElementById('btn-create').onclick=async()=>{try{const name=document.getElementById('new-role').value.trim();await j('/_rbac/roles',{method:'POST',body:JSON.stringify({name})});msg.textContent='已创建 '+name;location.reload();}catch(e){msg.textContent=e.message;}};
document.getElementById('btn-set').onclick=async()=>{try{const id=document.getElementById('role-sel').value;const permissions=[...document.querySelectorAll('input[name=perm]:checked')].map(x=>x.value);await j('/_rbac/roles/'+id+'/permissions',{method:'POST',body:JSON.stringify({permissions})});msg.textContent='权限已保存';}catch(e){msg.textContent=e.message;}};
document.getElementById('btn-assign').onclick=async()=>{try{const username=document.getElementById('assign-user').value.trim();const role=document.getElementById('assign-role').value.trim();await j('/_rbac/assign',{method:'POST',body:JSON.stringify({username,role})});msg.textContent='已赋 '+role+' → '+username;}catch(e){msg.textContent=e.message;}};
</script>
</body></html>`, roleOpts.String(), permChecks.String())
w.Header().Set("Content-Type", "text/html; charset=utf-8")
_, _ = io.WriteString(w, html)
}
func clientIP(r *http.Request) string {
if xff := r.Header.Get("X-Forwarded-For"); xff != "" {
if i := strings.Index(xff, ","); i >= 0 {
+164
View File
@@ -0,0 +1,164 @@
package httpx
import (
"fmt"
"io"
"net/http"
"strings"
"github.com/marqdo/marqdo/plugins/web/internal/session"
)
func isLoginAuthPage(page any) bool {
m, ok := page.(map[string]any)
if !ok || m == nil {
return false
}
af, ok := m["auth_form"].(map[string]any)
if !ok || af == nil {
return false
}
kind := strings.ToLower(strings.TrimSpace(fmt.Sprint(af["kind"])))
action := strings.ToLower(strings.TrimSpace(fmt.Sprint(af["action"])))
if kind == "register" || strings.Contains(action, "register") {
return false
}
return true
}
func (st *state) pageForAuthPath(path string) map[string]any {
if path == "" || st.routes == nil {
return nil
}
if p, ok := st.routes[path].(map[string]any); ok && p != nil {
return p
}
alt := strings.TrimRight(st.auth.adminPrefix, "/") + "/login"
if path == alt {
if p, ok := st.routes["/desk/login"].(map[string]any); ok {
return p
}
}
return nil
}
func localizeAuthErr(msg string) string {
s := strings.TrimSpace(msg)
lower := strings.ToLower(s)
switch {
case s == "":
return "操作失败,请重试。"
case strings.Contains(s, "Too many failed"):
return "尝试次数过多,请约 15 分钟后再试。"
case strings.Contains(s, "Invalid username or password"):
return "用户名或密码错误。"
case strings.Contains(s, "Invalid or missing CSRF"), strings.Contains(s, "Invalid CSRF"):
return "登录令牌失效,请刷新页面后重试。"
case strings.Contains(s, "Username") && strings.Contains(lower, "password"):
return "请填写有效的用户名(≥2)与密码(≥4)。"
case strings.Contains(lower, "already"), strings.Contains(lower, "exists"), strings.Contains(s, "存在"):
return "该用户名已被注册,请换一个。"
default:
return s
}
}
func safeAuthNext(raw string) string {
next := strings.TrimSpace(raw)
if next != "" && strings.HasPrefix(next, "/") && !strings.HasPrefix(next, "//") {
return next
}
return ""
}
func (st *state) writeAuthFailure(w http.ResponseWriter, r *http.Request, msg string) {
path := r.URL.Path
page := st.pageForAuthPath(path)
if page == nil && path == strings.TrimRight(st.auth.adminPrefix, "/")+"/login" {
page = st.pageForAuthPath("/desk/login")
}
if page != nil {
p := cloneMap(page)
p["_flash_err"] = localizeAuthErr(msg)
if next := safeAuthNext(r.FormValue("next")); next != "" {
p["_auth_next"] = next
} else if next := safeAuthNext(r.URL.Query().Get("next")); next != "" {
p["_auth_next"] = next
}
st.writePage(w, r, p)
return
}
_, csrf, setCookie := resolveSession(r)
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
loc := localizeAuthErr(msg)
_, _ = io.WriteString(w, loginPageHTML(st.auth.loginPath, &loc, csrf, r.FormValue("next")))
}
func (st *state) writeRegisterFailure(w http.ResponseWriter, r *http.Request, msg string) {
path := r.URL.Path
page := st.pageForAuthPath(path)
if page == nil {
page = st.pageForAuthPath(st.auth.registerPath)
}
if page != nil {
p := cloneMap(page)
p["_flash_err"] = localizeAuthErr(msg)
st.writePage(w, r, p)
return
}
_, csrf, setCookie := resolveSession(r)
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
loc := localizeAuthErr(msg)
_, _ = io.WriteString(w, registerPageHTML(st.auth.registerPath, &loc, csrf))
}
func (st *state) mountExtraLoginPosts(mux *http.ServeMux, already map[string]bool) {
for path, pageV := range st.routes {
if already[path] {
continue
}
if isLoginAuthPage(pageV) {
mux.HandleFunc("POST "+path, st.handleLoginPost)
already[path] = true
}
}
}
func (st *state) authEntryRedirect(w http.ResponseWriter, r *http.Request, page map[string]any) bool {
if page == nil || r == nil {
return false
}
path := r.URL.Path
isEntry := false
if path == st.auth.loginPath || path == st.auth.registerPath {
isEntry = true
}
alt := strings.TrimRight(st.auth.adminPrefix, "/") + "/login"
if path == alt {
isEntry = true
}
if _, ok := page["auth_form"]; ok {
isEntry = true
}
if !isEntry {
return false
}
if session.RoleFromCookie(r.Header.Get("Cookie")) == "visitor" {
return false
}
fallback := st.auth.loginRedirect
if af, ok := page["auth_form"].(map[string]any); ok {
if n, ok := af["next"].(string); ok {
if n = strings.TrimSpace(n); n != "" {
fallback = n
}
}
}
if path == st.auth.registerPath {
fallback = st.auth.loginRedirect
}
http.Redirect(w, r, loginDest(r, fallback), http.StatusSeeOther)
return true
}
+245
View File
@@ -0,0 +1,245 @@
package httpx
import (
"fmt"
"net/http"
"strings"
"sync"
"time"
"github.com/marqdo/marqdo/plugins/web/internal/auth"
"github.com/marqdo/marqdo/plugins/web/internal/oidc"
"github.com/marqdo/marqdo/plugins/web/internal/rbac"
"github.com/marqdo/marqdo/plugins/web/internal/session"
)
const oidcPasswordSentinel = "!oidc!"
var (
oidcHTTPOnce sync.Once
oidcHTTP *http.Client
)
func oidcClient() *http.Client {
oidcHTTPOnce.Do(func() {
oidcHTTP = &http.Client{Timeout: 20 * time.Second}
})
return oidcHTTP
}
func (st *state) oidcEnabled() bool {
return st.oidc.Enabled()
}
func (st *state) ensureOIDCEndpoints() error {
if !st.oidc.Enabled() {
return fmt.Errorf("oidc not configured")
}
return st.oidc.ResolveEndpoints(oidcClient())
}
func (st *state) isOIDCEntryPath(path string) bool {
if !st.oidcEnabled() || path == "" {
return false
}
if path == st.auth.loginPath || path == st.auth.registerPath {
return true
}
alt := strings.TrimRight(st.auth.adminPrefix, "/") + "/login"
if path == alt || path == "/desk/login" || path == "/admin/login" {
return true
}
return false
}
// oidcFallbackNext picks where to land after IdP login when ?next= is absent.
// Admin entry pages must not fall back to the public homepage.
func (st *state) oidcFallbackNext(r *http.Request) string {
path := ""
if r != nil {
path = r.URL.Path
}
switch path {
case "/desk/login", "/admin/login", "/oidc/login":
return "/admin"
case "/desk", "/admin":
return "/admin"
}
if strings.HasPrefix(path, "/desk/") || strings.HasPrefix(path, "/admin/") {
return "/admin"
}
if st.auth.loginRedirect != "" {
return st.auth.loginRedirect
}
return "/"
}
func (st *state) mountOIDCRoutes(mux *http.ServeMux) {
if !st.oidcEnabled() {
return
}
cb := st.oidc.Callback()
mux.HandleFunc("GET "+cb, st.handleOIDCCallback)
mux.HandleFunc("GET /oidc/login", st.handleOIDCStart)
mux.HandleFunc("GET /oidc/register", st.handleOIDCStart)
}
func (st *state) handleOIDCStart(w http.ResponseWriter, r *http.Request) {
if !st.oidcEnabled() {
http.NotFound(w, r)
return
}
// Already signed in → skip IdP round-trip when destination is allowed.
cookie := r.Header.Get("Cookie")
if session.RoleFromCookie(cookie) != "visitor" {
next := loginDest(r, st.oidcFallbackNext(r))
needsDesk := strings.HasPrefix(next, "/admin") || strings.HasPrefix(next, "/desk")
held := session.PermissionsFromCookie(cookie)
if needsDesk && !session.PermissionAllowed(held, []string{"desk:access"}) {
http.Redirect(w, r, "/", http.StatusSeeOther)
return
}
http.Redirect(w, r, next, http.StatusSeeOther)
return
}
if err := st.ensureOIDCEndpoints(); err != nil {
http.Error(w, "oidc discovery failed: "+err.Error(), http.StatusBadGateway)
return
}
sid, _, setCookie := resolveSession(r)
state, err := oidc.RandomURLString(24)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
verifier, err := oidc.RandomURLString(32)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
session.SetValue(sid, "oidc_state", state)
session.SetValue(sid, "oidc_verifier", verifier)
next := loginDest(r, st.oidcFallbackNext(r))
session.SetValue(sid, "oidc_next", next)
loc, err := st.oidc.AuthorizeRedirect(state, oidc.PKCEChallengeS256(verifier))
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
appendSetCookie(w, setCookie)
w.Header().Add("Set-Cookie", session.IssueCookie(sid))
http.Redirect(w, r, loc, http.StatusFound)
}
func (st *state) handleOIDCCallback(w http.ResponseWriter, r *http.Request) {
if !st.oidcEnabled() {
http.NotFound(w, r)
return
}
if err := st.ensureOIDCEndpoints(); err != nil {
http.Error(w, "oidc discovery failed: "+err.Error(), http.StatusBadGateway)
return
}
q := r.URL.Query()
if errCode := q.Get("error"); errCode != "" {
msg := errCode
if d := q.Get("error_description"); d != "" {
msg = errCode + ": " + d
}
http.Error(w, "oidc: "+msg, http.StatusBadRequest)
return
}
code := q.Get("code")
state := q.Get("state")
if code == "" || state == "" {
http.Error(w, "oidc: missing code or state", http.StatusBadRequest)
return
}
sid, _, setCookie := resolveSession(r)
want, _ := session.GetValue(sid, "oidc_state")
wantS, _ := want.(string)
if wantS == "" || wantS != state {
http.Error(w, "oidc: state mismatch", http.StatusBadRequest)
return
}
verifier, _ := session.GetValue(sid, "oidc_verifier")
verifierS, _ := verifier.(string)
nextVal, _ := session.GetValue(sid, "oidc_next")
next, _ := nextVal.(string)
if next == "" {
next = st.auth.loginRedirect
}
session.DelKey(sid, "oidc_state")
session.DelKey(sid, "oidc_verifier")
session.DelKey(sid, "oidc_next")
tok, err := st.oidc.ExchangeCode(oidcClient(), code, verifierS)
if err != nil {
http.Error(w, "oidc token exchange: "+err.Error(), http.StatusBadGateway)
return
}
info, err := st.oidc.FetchUserInfo(oidcClient(), tok.AccessToken)
if err != nil {
http.Error(w, "oidc userinfo: "+err.Error(), http.StatusBadGateway)
return
}
username := info.LocalUsername()
if username == "" {
http.Error(w, "oidc: empty username", http.StatusBadGateway)
return
}
role := info.LocalRole(st.auth.defaultRole)
if role == "admin" {
// System RBAC seed uses superadmin; keep session role "admin" for ExpandRole.
if st.dbURL != "" && st.auth.rbac {
_ = rbac.EnsureUserWithRole(st.dbURL, username, oidcPasswordSentinel, "superadmin")
}
} else if st.dbURL != "" && st.auth.rbac {
_ = rbac.EnsureUserWithRole(st.dbURL, username, oidcPasswordSentinel, role)
}
newID := session.NewID(st.auth.sessionTTL)
session.SetValue(newID, "username", username)
session.SetValue(newID, "role", role)
session.SetValue(newID, "oidc_sub", info.Sub)
if info.Email != "" {
session.SetValue(newID, "email", info.Email)
}
if info.AdminRole != "" {
session.SetValue(newID, "admin_role", info.AdminRole)
}
st.attachOIDCPermissions(newID, username, role)
held := session.PermissionsFromSession(newID)
if (strings.HasPrefix(next, "/desk") || strings.HasPrefix(next, "/admin")) &&
!session.PermissionAllowed(held, []string{"desk:access"}) {
next = "/"
}
appendSetCookie(w, setCookie)
w.Header().Add("Set-Cookie", session.IssueCookie(newID))
http.Redirect(w, r, next, http.StatusSeeOther)
}
func (st *state) attachOIDCPermissions(sessID, username, role string) {
// Prefer IdP-derived role expansion so platform admins always get desk access
// even before local RBAC rows catch up.
perms := rbac.ExpandRole(role)
if len(perms) == 0 {
perms = expandLegacyRole(role)
}
if st.dbURL != "" && st.auth.rbac {
if dbPerms, err := rbac.PermissionsForUser(st.dbURL, username); err == nil && len(dbPerms) > 0 {
// Union IdP role perms with any local grants.
seen := map[string]bool{}
var out []string
for _, p := range append(perms, dbPerms...) {
if p == "" || seen[p] {
continue
}
seen[p] = true
out = append(out, p)
}
perms = out
}
}
auth.AttachPermissions(sessID, perms)
}
+22
View File
@@ -70,3 +70,25 @@ func TestWithNavAuth(t *testing.T) {
t.Fatalf("nav user=%v", page["_nav_user"])
}
}
func TestLogoutPathExcludedFromGate(t *testing.T) {
gates := []gate{{
path: "/admin",
permissions: []string{"desk:access"},
matchMode: gateMatchPrefix,
onDeny: onDenyRedirect,
exclude: []string{"/admin/login"},
}}
mux := http.NewServeMux()
mux.HandleFunc("GET /admin/logout", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNoContent)
})
handler := withRBAC(mux, gates, "/login")
req := httptest.NewRequest(http.MethodGet, "/admin/logout", nil)
rec := httptest.NewRecorder()
handler.ServeHTTP(rec, req)
if rec.Code != http.StatusNoContent {
t.Fatalf("visitor /admin/logout should reach handler, got %d loc=%s", rec.Code, rec.Header().Get("Location"))
}
}
+6 -8
View File
@@ -67,15 +67,13 @@ func goMuxPattern(path string) string {
func resolveSession(r *http.Request) (sid, csrf string, setCookie *string) {
cookieHdr := r.Header.Get("Cookie")
id, hadCookie := session.IDFromCookie(cookieHdr)
if hadCookie {
ok := true
if ok && id != "" {
sid = id
if tok, ok := session.CSRFFor(sid); ok {
csrf = tok
}
return sid, csrf, nil
if hadCookie && id != "" {
if tok, ok := session.CSRFFor(id); ok && tok != "" {
return id, tok, nil
}
// Stale/expired/missing session: mint a fresh session and replace the cookie.
// Previously we returned the dead sid with empty CSRF, so login forms had no
// _csrf while POST still saw hadCookie=true → "登录令牌失效".
}
sid = session.NewID(0)
tok, _ := session.CSRFFor(sid)
+48 -1
View File
@@ -1,6 +1,12 @@
package httpx
import "testing"
import (
"net/http/httptest"
"strings"
"testing"
"github.com/marqdo/marqdo/plugins/web/internal/session"
)
func TestGoMuxPattern(t *testing.T) {
if got := goMuxPattern("/_media/{*key}"); got != "/_media/{key...}" {
@@ -10,3 +16,44 @@ func TestGoMuxPattern(t *testing.T) {
t.Fatalf("got %q", got)
}
}
func TestPathParamNamesIncludesID(t *testing.T) {
got := pathParamNames("/desk/posts/{id}")
if len(got) != 1 || got[0] != "id" {
t.Fatalf("got %#v", got)
}
got = pathParamNames("/post/{slug}")
if len(got) != 1 || got[0] != "slug" {
t.Fatalf("got %#v", got)
}
}
func TestResolveSessionReplacesStaleCookie(t *testing.T) {
session.Configure(session.Config{TTLSec: 3600})
session.Reset(3600)
req := httptest.NewRequest("GET", "/login", nil)
req.Header.Set("Cookie", "marqdo_sid="+strings.Repeat("ab", 32))
sid, csrf, setCookie := resolveSession(req)
if sid == "" || csrf == "" {
t.Fatalf("expected fresh sid+csrf, got sid=%q csrf=%q", sid, csrf)
}
if setCookie == nil || !strings.Contains(*setCookie, "marqdo_sid=") {
t.Fatalf("expected Set-Cookie for replacement session, got %#v", setCookie)
}
if !session.ValidateCSRF(sid, csrf) {
t.Fatal("csrf should validate for new session")
}
// Live session should keep the same id without re-issuing cookie.
req2 := httptest.NewRequest("GET", "/login", nil)
req2.Header.Set("Cookie", "marqdo_sid="+sid)
sid2, csrf2, setCookie2 := resolveSession(req2)
if sid2 != sid || csrf2 != csrf {
t.Fatalf("live session should be stable: %q/%q vs %q/%q", sid, csrf, sid2, csrf2)
}
if setCookie2 != nil {
t.Fatalf("live session should not Set-Cookie again")
}
}
+212 -22
View File
@@ -9,6 +9,7 @@ import (
"io"
"net"
"net/http"
"net/url"
"os"
"os/signal"
"path/filepath"
@@ -21,10 +22,13 @@ import (
"github.com/marqdo/marqdo/plugins/web/internal/db"
"github.com/marqdo/marqdo/plugins/web/internal/form"
"github.com/marqdo/marqdo/plugins/web/internal/middleware"
"github.com/marqdo/marqdo/plugins/web/internal/oidc"
"github.com/marqdo/marqdo/plugins/web/internal/ratelimit"
"github.com/marqdo/marqdo/plugins/web/internal/rbac"
"github.com/marqdo/marqdo/plugins/web/internal/render"
"github.com/marqdo/marqdo/plugins/web/internal/session"
"github.com/marqdo/marqdo/plugins/web/internal/sitemap"
"github.com/marqdo/marqdo/plugins/web/internal/tenant"
)
// NewHandler builds the HTTP handler for an app bag (no listen).
@@ -35,8 +39,14 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
}
authCfg := authConfigOf(appBag)
dbURL := dbURLOf(appBag)
if authCfg.rbac && dbURL != "" {
if err := rbac.EnsureSchema(dbURL); err != nil {
return nil, fmt.Errorf("rbac ensure: %w", err)
}
}
session.Configure(session.Config{
DBURL: dbURL,
RedisURL: sessionURLOf(appBag),
TTLSec: authCfg.sessionTTL,
CookieSecure: authCfg.cookieSecure,
})
@@ -47,10 +57,24 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
if page == nil {
page = map[string]any{}
}
if _, ok := page["asset_version"]; !ok {
if v := strOpt(appBag, "asset_version", ""); v != "" {
page["asset_version"] = v
}
}
routes := map[string]any{}
if r, ok := appBag["routes"].(map[string]any); ok {
routes = r
}
if av, ok := page["asset_version"]; ok {
for _, p := range routes {
if pm, ok := p.(map[string]any); ok {
if _, has := pm["asset_version"]; !has {
pm["asset_version"] = av
}
}
}
}
forms := map[string]any{}
if f, ok := appBag["forms"].(map[string]any); ok {
forms = cloneMap(f)
@@ -99,13 +123,18 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
proxyRoutes: routeMapOf(appBag, "proxy_routes"),
invokeRoutes: routeMapOf(appBag, "invoke_routes"),
auth: authCfg,
oidc: oidc.ParseConfig(appBag),
tenant: tenant.FromBag(appBag),
}
mux := http.NewServeMux()
mux.HandleFunc("GET /{$}", st.handleHome)
mux.HandleFunc("GET /_part/{id}", st.handleHomePart)
// Part slot uses {part} (not {id}) so dynamic routes like /desk/posts/{id}
// do not collide with Go ServeMux duplicate wildcard names.
mux.HandleFunc("GET /_part/{part}", st.handleHomePart)
mux.HandleFunc("GET /_form/{id}", st.handleFormGet)
mux.HandleFunc("POST /_form/{id}", st.handleFormPost)
mux.HandleFunc("POST /_md", st.handleMarkdownPreview)
paths := sortedKeys(routes)
for _, p := range paths {
@@ -116,14 +145,14 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
}
if strings.Contains(routePath, "{") {
mux.HandleFunc("GET "+goMuxPattern(routePath), st.makeDynamicPage(pageV, routePath))
mux.HandleFunc("GET "+goMuxPattern(routePath)+"/_part/{id}", st.makeDynamicPart(pageV, routePath))
mux.HandleFunc("GET "+goMuxPattern(routePath)+"/_part/{part}", st.makeDynamicPart(pageV, routePath))
} else {
pv := pageV
mux.HandleFunc("GET "+routePath, func(w http.ResponseWriter, r *http.Request) {
st.writePage(w, r, pv)
})
mux.HandleFunc("GET "+routePath+"/_part/{id}", func(w http.ResponseWriter, r *http.Request) {
st.writePart(w, r, pv, r.PathValue("id"))
mux.HandleFunc("GET "+routePath+"/_part/{part}", func(w http.ResponseWriter, r *http.Request) {
st.writePart(w, r, pv, r.PathValue("part"))
})
}
}
@@ -132,7 +161,7 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
route := jr
pattern := route.Method + " " + route.Path
mux.HandleFunc(pattern, func(w http.ResponseWriter, r *http.Request) {
st.handleJSON(w, route)
st.handleJSON(w, r, route)
})
}
@@ -161,20 +190,18 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
fs := http.StripPrefix(staticMount, http.FileServer(http.Dir(staticDir)))
// Register without method so GET+HEAD share one pattern (avoids conflicts
// with more-specific GET/HEAD icon paths under the same prefix).
mux.Handle(staticMount+"/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
serveStatic := func(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodGet && r.Method != http.MethodHead {
http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
return
}
// Long browser cache; FileServer still honors Last-Modified / 304.
// Prefer ?v= / asset_version on HTML refs when assets change.
w.Header().Set("Cache-Control", "public, max-age=604800")
fs.ServeHTTP(w, r)
}))
mux.Handle(staticMount, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodGet && r.Method != http.MethodHead {
http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
return
}
fs.ServeHTTP(w, r)
}))
}
mux.Handle(staticMount+"/", http.HandlerFunc(serveStatic))
mux.Handle(staticMount, http.HandlerFunc(serveStatic))
}
for _, from := range sortedKeys(st.redirects) {
@@ -217,6 +244,7 @@ func NewHandler(appBag map[string]any, entryDir string) (http.Handler, error) {
handler := withMiddleware(mux, mw)
handler = withRBAC(handler, authCfg.gates, authCfg.loginPath)
handler = withTenant(handler, st.tenant)
return handler, nil
}
@@ -280,6 +308,8 @@ type state struct {
proxyRoutes map[string]any
invokeRoutes map[string]any
auth authConfig
oidc oidc.Config
tenant tenant.Config
}
func (st *state) handleHome(w http.ResponseWriter, r *http.Request) {
@@ -287,7 +317,21 @@ func (st *state) handleHome(w http.ResponseWriter, r *http.Request) {
}
func (st *state) handleHomePart(w http.ResponseWriter, r *http.Request) {
st.writePart(w, r, st.page, r.PathValue("id"))
st.writePart(w, r, st.page, r.PathValue("part"))
}
func (st *state) handleMarkdownPreview(w http.ResponseWriter, r *http.Request) {
body, err := io.ReadAll(io.LimitReader(r.Body, 1<<20))
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
html := render.MarkdownToHTML(string(body))
if html == "" {
html = `<p class="lede mq-md-empty">预览</p>`
}
w.Header().Set("Content-Type", "text/html; charset=utf-8")
_, _ = io.WriteString(w, html)
}
func (st *state) preparePage(page map[string]any, r *http.Request) map[string]any {
@@ -295,19 +339,66 @@ func (st *state) preparePage(page map[string]any, r *http.Request) map[string]an
assets.MergeSiteHead(p, st.siteHead)
if r != nil {
withNavAuth(p, r.Header.Get("Cookie"))
params, _ := p["params"].(map[string]any)
if params == nil {
params = map[string]any{}
} else {
params = cloneMap(params)
}
for k, vs := range r.URL.Query() {
if len(vs) == 0 {
continue
}
if _, exists := params[k]; !exists {
params[k] = vs[0]
}
}
p["params"] = params
}
return p
}
// attachCSRF stamps page._csrf so custom login/register pages expose a token
// in meta and (via InjectAuthFields) in POST forms — progressive enhancement, no author JS.
func (st *state) attachCSRF(page map[string]any, r *http.Request) *string {
if page == nil || r == nil {
return nil
}
if st.auth.users == nil && !st.auth.rbac && !st.oidcEnabled() {
return nil
}
_, csrf, setCookie := resolveSession(r)
if csrf != "" {
page["_csrf"] = csrf
}
return setCookie
}
func (st *state) writePage(w http.ResponseWriter, r *http.Request, page map[string]any) {
html := render.RenderPage(st.preparePage(page, r), st.dbURL, "")
if st.oidcEnabled() && st.isOIDCEntryPath(r.URL.Path) {
st.handleOIDCStart(w, r)
return
}
p := st.preparePage(page, r)
if st.authEntryRedirect(w, r, p) {
return
}
if next := safeAuthNext(r.URL.Query().Get("next")); next != "" {
p["_auth_next"] = next
}
setCookie := st.attachCSRF(p, r)
html := render.RenderPage(p, st.dbURL, "")
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
_, _ = io.WriteString(w, html)
}
func (st *state) writePart(w http.ResponseWriter, r *http.Request, page map[string]any, id string) {
html := render.RenderPage(st.preparePage(page, r), st.dbURL, id)
p := st.preparePage(page, r)
setCookie := st.attachCSRF(p, r)
html := render.RenderPage(p, st.dbURL, id)
w.Header().Set("Content-Type", "text/html; charset=utf-8")
appendSetCookie(w, setCookie)
_, _ = io.WriteString(w, html)
}
@@ -392,7 +483,7 @@ func (st *state) makeDynamicPart(page map[string]any, pattern string) http.Handl
params[name] = r.PathValue(name)
}
injectParams(p, params)
st.writePart(w, r, p, r.PathValue("id"))
st.writePart(w, r, p, r.PathValue("part"))
}
}
@@ -432,27 +523,102 @@ func (st *state) handleFormPost(w http.ResponseWriter, r *http.Request) {
data[k] = vs[0]
}
}
if st.tenant.Enabled() && st.tenant.DefaultScope {
if tid := tenant.FromContext(r.Context()); tid != "" {
data = tenant.StampRow(data, st.tenant.Column, tid)
}
}
ctx := st.requestContext(r, data)
delete(data, "_mq_params")
delete(data, "_mq_return")
delete(data, "_csrf")
form.ApplySources(frm, data, ctx)
res, err := form.Submit(frm, data, st.dbURL)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
if ok, _ := res["ok"].(bool); ok {
// Prefer an explicit form redirect (e.g. cancel_href list URL) over the
// composing page path stamped as _mq_return.
redir := strOpt(res, "redirect", "/")
if (redir == "" || redir == "/") && ctx.ReturnPath != "" {
redir = ctx.ReturnPath
}
http.Redirect(w, r, redir, http.StatusSeeOther)
return
}
html := form.Render(frm, id, data, res["errors"], "")
html := form.RenderBodyCtx(frm, id, data, res["errors"], "", ctx)
w.Header().Set("Content-Type", "text/html; charset=utf-8")
_, _ = io.WriteString(w, html)
}
func (st *state) handleJSON(w http.ResponseWriter, route middleware.JSONRouteMount) {
func (st *state) requestContext(r *http.Request, data map[string]any) *form.RequestContext {
ctx := &form.RequestContext{
Username: session.UsernameFromCookie(r.Header.Get("Cookie")),
Path: r.URL.Path,
Method: r.Method,
}
if data != nil {
if p := form.ParseMQParams(fmt.Sprint(data["_mq_params"])); len(p) > 0 {
ctx.Params = p
}
if ret, ok := data["_mq_return"].(string); ok {
if back := sameHostPath(ret, r.Host); back != "" {
ctx.ReturnPath = back
} else if strings.HasPrefix(ret, "/") && !strings.HasPrefix(ret, "//") {
ctx.ReturnPath = ret
}
}
}
if ctx.ReturnPath == "" {
if back := sameHostPath(r.Referer(), r.Host); back != "" {
ctx.ReturnPath = back
}
}
return ctx
}
func sameHostPath(raw, host string) string {
raw = strings.TrimSpace(raw)
if raw == "" {
return ""
}
u, err := url.Parse(raw)
if err != nil || u == nil {
return ""
}
if u.Host != "" && host != "" && !strings.EqualFold(u.Host, host) {
return ""
}
path := u.Path
if path == "" {
path = "/"
}
if u.RawQuery != "" {
path += "?" + u.RawQuery
}
if !strings.HasPrefix(path, "/") || strings.HasPrefix(path, "//") {
return ""
}
return path
}
func (st *state) handleJSON(w http.ResponseWriter, r *http.Request, route middleware.JSONRouteMount) {
if st.dbURL == "" {
writeJSON(w, http.StatusInternalServerError, map[string]any{"error": "no database"})
return
}
opts := db.SelectOpts{Where: route.Where, Order: route.Order}
where := route.Where
if (route.TenantScope || st.tenant.DefaultScope) && st.tenant.Enabled() {
tid := tenant.FromContext(r.Context())
if tid == "" {
writeJSON(w, http.StatusBadRequest, map[string]any{"error": "tenant required"})
return
}
where = tenant.MergeWhere(where, st.tenant.Column, tid)
}
opts := db.SelectOpts{Where: where, Order: route.Order}
out, err := db.Select(st.dbURL, route.Table, route.Limit, opts)
if err != nil {
writeJSON(w, http.StatusInternalServerError, map[string]any{"error": err.Error()})
@@ -461,6 +627,17 @@ func (st *state) handleJSON(w http.ResponseWriter, route middleware.JSONRouteMou
writeJSON(w, http.StatusOK, out)
}
func withTenant(next http.Handler, cfg tenant.Config) http.Handler {
if !cfg.Enabled() {
return next
}
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
id := tenant.Resolve(r, cfg)
ctx := tenant.WithContext(r.Context(), id)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
func withMiddleware(next http.Handler, mw middleware.Config) http.Handler {
h := next
if mw.BodyLimit != nil && *mw.BodyLimit > 0 {
@@ -668,7 +845,8 @@ func pathParamNames(pattern string) []string {
if strings.HasPrefix(seg, "{") && strings.HasSuffix(seg, "}") {
name := strings.TrimSuffix(strings.TrimPrefix(seg, "{"), "}")
name = strings.TrimPrefix(name, "*")
if name != "" && name != "id" {
// Include "id" — part slots use {part}, so route {id} is safe for PathValue.
if name != "" {
names = append(names, name)
}
}
@@ -688,6 +866,18 @@ func dbURLOf(appBag map[string]any) string {
return ""
}
func sessionURLOf(appBag map[string]any) string {
if s, ok := appBag["session_url"].(string); ok && s != "" {
return s
}
if auth, ok := appBag["auth"].(map[string]any); ok {
if s, ok := auth["session_url"].(string); ok && s != "" {
return s
}
}
return ""
}
func resolvePath(p, entryDir string) string {
if filepath.IsAbs(p) {
return p
@@ -58,6 +58,9 @@ func TestNewHandlerHomeRoutesStatic(t *testing.T) {
if rec.Code != 200 {
t.Fatalf("static code=%d", rec.Code)
}
if cc := rec.Header().Get("Cache-Control"); !strings.Contains(cc, "max-age=") {
t.Fatalf("static cache-control=%q", cc)
}
b, _ := io.ReadAll(rec.Result().Body)
if string(b) != "hello-static" {
// httptest body is already in rec.Body
+130 -4
View File
@@ -1,9 +1,14 @@
package httpx
import (
"encoding/json"
"fmt"
"net/http"
"strings"
"github.com/gorilla/websocket"
"github.com/marqdo/marqdo/plugins/web/internal/plugin"
"github.com/marqdo/marqdo/plugins/web/internal/session"
"github.com/marqdo/marqdo/plugins/web/internal/ws"
)
@@ -13,14 +18,44 @@ var wsUpgrader = websocket.Upgrader{
func (st *state) mountWSRoutes(mux *http.ServeMux) {
for _, path := range sortedKeys(st.wsRoutes) {
spec := ws.ParseRouteSpec(st.wsRoutes[path]) // mode + optional room_key
spec := ws.ParseRouteSpec(st.wsRoutes[path]) // mode + optional room_key / on_message
routePath := path
mux.HandleFunc("GET "+routePath, func(w http.ResponseWriter, r *http.Request) {
pattern := routePath
if strings.Contains(routePath, "{") {
pattern = goMuxPattern(routePath)
}
mux.HandleFunc("GET "+pattern, func(w http.ResponseWriter, r *http.Request) {
st.handleWS(w, r, routePath, spec)
})
}
}
func pathValuesOf(r *http.Request, routePath string) map[string]string {
out := map[string]string{}
// Collect {name} tokens from the route template.
rest := routePath
for {
i := strings.Index(rest, "{")
if i < 0 {
break
}
rest = rest[i+1:]
j := strings.Index(rest, "}")
if j < 0 {
break
}
name := rest[:j]
name = strings.TrimPrefix(name, "*")
if name != "" {
if v := r.PathValue(name); v != "" {
out[name] = v
}
}
rest = rest[j+1:]
}
return out
}
func (st *state) handleWS(w http.ResponseWriter, r *http.Request, path string, spec ws.RouteSpec) {
conn, err := wsUpgrader.Upgrade(w, r, nil)
if err != nil {
@@ -28,6 +63,7 @@ func (st *state) handleWS(w http.ResponseWriter, r *http.Request, path string, s
}
defer conn.Close()
vals := pathValuesOf(r, path)
switch spec.Mode {
case ws.ModeEcho:
for {
@@ -53,11 +89,26 @@ func (st *state) handleWS(w http.ResponseWriter, r *http.Request, path string, s
case ws.ModeBroadcast, ws.ModeRoom:
room := path
if spec.RoomKey != "" {
room = spec.RoomKey
room = ws.ExpandTemplate(spec.RoomKey, vals)
} else if len(vals) > 0 {
room = ws.ExpandTemplate(path, vals)
}
user := session.UsernameFromCookie(r.Header.Get("Cookie"))
if user == "" {
user = "anon"
}
ch := ws.JoinRoom(room)
defer ws.LeaveRoom(room, ch)
presenceRoom := room + ".presence"
var presenceCh chan string
if spec.Presence {
presenceCh = ws.JoinRoom(presenceRoom)
defer ws.LeaveRoom(presenceRoom, presenceCh)
ws.PublishRoom(presenceRoom, presenceJSON("join", user, room))
defer ws.PublishRoom(presenceRoom, presenceJSON("leave", user, room))
}
done := make(chan struct{})
go func() {
defer close(done)
@@ -67,7 +118,25 @@ func (st *state) handleWS(w http.ResponseWriter, r *http.Request, path string, s
return
}
if mt == websocket.TextMessage {
ws.PublishRoom(room, string(data))
text := string(data)
if spec.OnMessage != "" {
out, err := plugin.CallLibPath(spec.OnMessage, map[string]any{
"message": text,
"room": room,
"path": path,
"user": user,
})
if err != nil {
_ = conn.WriteMessage(websocket.TextMessage, []byte(`{"error":`+jsonQuote(err.Error())+`}`))
continue
}
skip, rewritten := interpretOnMessage(out, text)
if skip {
continue
}
text = rewritten
}
ws.PublishRoom(room, text)
} else if mt == websocket.CloseMessage {
return
}
@@ -85,9 +154,66 @@ func (st *state) handleWS(w http.ResponseWriter, r *http.Request, path string, s
if err := conn.WriteMessage(websocket.TextMessage, []byte(text)); err != nil {
return
}
case text, ok := <-presenceOrNil(presenceCh):
if presenceCh == nil {
continue
}
if !ok {
return
}
if err := conn.WriteMessage(websocket.TextMessage, []byte(text)); err != nil {
return
}
}
}
default:
return
}
}
func presenceOrNil(ch chan string) <-chan string {
if ch == nil {
return nil
}
return ch
}
func presenceJSON(event, user, room string) string {
b, _ := json.Marshal(map[string]any{
"type": "presence",
"event": event,
"user": user,
"room": room,
})
return string(b)
}
func jsonQuote(s string) string {
b, _ := json.Marshal(s)
return string(b)
}
func interpretOnMessage(out any, original string) (skip bool, text string) {
text = original
m, ok := out.(map[string]any)
if !ok {
if s, ok := out.(string); ok && s != "" {
return false, s
}
return false, original
}
if v, ok := m["skip"]; ok && boolish(v) {
return true, ""
}
if v, ok := m["drop"]; ok && boolish(v) {
return true, ""
}
if v, ok := m["message"]; ok {
text = fmt.Sprint(v)
} else if v, ok := m["消息"]; ok {
text = fmt.Sprint(v)
} else if v, ok := m["text"]; ok {
text = fmt.Sprint(v)
}
return false, text
}
+16 -7
View File
@@ -34,12 +34,13 @@ type CORSConfig struct {
// JSONRouteMount is one JSON API route with leading-slash path.
type JSONRouteMount struct {
Path string
Method string
Table string
Where any
Order string
Limit int64
Path string
Method string
Table string
Where any
Order string
Limit int64
TenantScope bool
}
// Configure merges configure tables into app.middleware (Rust web_app_middleware).
@@ -178,6 +179,11 @@ func parseJSONRoute(path string, spec any) (JSONRouteMount, bool) {
if w, ok := m["where"]; ok && w != nil {
r.Where = w
}
if v, ok := m["tenant_scope"]; ok {
r.TenantScope = boolish(v)
} else if v, ok := m["租户作用域"]; ok {
r.TenantScope = boolish(v)
}
return r, true
}
@@ -255,7 +261,7 @@ func SecurityFromTable(tableV any) map[string]any {
return out
}
// JSONRoutesFromTable normalizes `|路径|方法|表|条件|排序|上限|` into json_routes.
// JSONRoutesFromTable normalizes `|路径|方法|表|条件|排序|上限|租户作用域|` into json_routes.
func JSONRoutesFromTable(tableV any) map[string]any {
rows, _ := table.AsRows(tableV).([]any)
out := map[string]any{}
@@ -291,6 +297,9 @@ func JSONRoutesFromTable(tableV any) map[string]any {
if order != "" {
spec["order"] = order
}
if scope := col(m, "租户作用域", "tenant_scope", "TenantScope"); scope != "" {
spec["tenant_scope"] = boolish(scope)
}
out[path] = spec
}
return out
+341
View File
@@ -0,0 +1,341 @@
// Package oidc implements OAuth 2.0 authorization-code + OIDC userinfo for ext/web.
package oidc
import (
"crypto/rand"
"crypto/sha256"
"encoding/base64"
"encoding/json"
"fmt"
"io"
"net/http"
"net/url"
"strings"
"time"
)
// Config is the relying-party settings (CFLMY IdP or any OIDC provider).
type Config struct {
Issuer string
ClientID string
ClientSecret string
RedirectURI string
Scopes string
CallbackPath string
// AuthorizeURL / TokenURL / UserInfoURL override discovery when set.
AuthorizeURL string
TokenURL string
UserInfoURL string
}
// Enabled reports whether the minimum OIDC fields are present.
func (c Config) Enabled() bool {
return strings.TrimSpace(c.ClientID) != "" &&
strings.TrimSpace(c.ClientSecret) != "" &&
strings.TrimSpace(c.RedirectURI) != "" &&
(strings.TrimSpace(c.Issuer) != "" || strings.TrimSpace(c.AuthorizeURL) != "")
}
// Callback reports the local path (default /oidc/callback).
func (c Config) Callback() string {
p := strings.TrimSpace(c.CallbackPath)
if p == "" {
if u, err := url.Parse(c.RedirectURI); err == nil && u.Path != "" {
return u.Path
}
return "/oidc/callback"
}
if !strings.HasPrefix(p, "/") {
p = "/" + p
}
return p
}
type discoveryDoc struct {
AuthorizationEndpoint string `json:"authorization_endpoint"`
TokenEndpoint string `json:"token_endpoint"`
UserinfoEndpoint string `json:"userinfo_endpoint"`
}
// ResolveEndpoints fills Authorize/Token/UserInfo from discovery when missing.
func (c *Config) ResolveEndpoints(client *http.Client) error {
if c.AuthorizeURL != "" && c.TokenURL != "" && c.UserInfoURL != "" {
return nil
}
issuer := strings.TrimRight(strings.TrimSpace(c.Issuer), "/")
if issuer == "" {
return fmt.Errorf("oidc: issuer or explicit endpoints required")
}
if client == nil {
client = &http.Client{Timeout: 15 * time.Second}
}
discURL := issuer + "/.well-known/openid-configuration"
res, err := client.Get(discURL)
if err != nil {
return fmt.Errorf("oidc discovery: %w", err)
}
defer res.Body.Close()
body, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
if err != nil {
return err
}
if res.StatusCode >= 300 {
return fmt.Errorf("oidc discovery HTTP %d: %s", res.StatusCode, truncate(string(body), 200))
}
var doc discoveryDoc
if err := json.Unmarshal(body, &doc); err != nil {
return fmt.Errorf("oidc discovery json: %w", err)
}
if c.AuthorizeURL == "" {
c.AuthorizeURL = doc.AuthorizationEndpoint
}
if c.TokenURL == "" {
c.TokenURL = doc.TokenEndpoint
}
if c.UserInfoURL == "" {
c.UserInfoURL = doc.UserinfoEndpoint
}
if c.AuthorizeURL == "" || c.TokenURL == "" || c.UserInfoURL == "" {
return fmt.Errorf("oidc: incomplete discovery endpoints")
}
return nil
}
// ScopesCSV returns space-separated scopes (default openid profile email).
func (c Config) ScopesCSV() string {
s := strings.TrimSpace(c.Scopes)
if s == "" {
return "openid profile email"
}
return s
}
// RandomURLString returns a URL-safe random string of n bytes (base64url, no pad).
func RandomURLString(n int) (string, error) {
b := make([]byte, n)
if _, err := rand.Read(b); err != nil {
return "", err
}
return base64.RawURLEncoding.EncodeToString(b), nil
}
// PKCEChallengeS256 returns code_challenge for a verifier.
func PKCEChallengeS256(verifier string) string {
sum := sha256.Sum256([]byte(verifier))
return base64.RawURLEncoding.EncodeToString(sum[:])
}
// AuthorizeRedirect builds the browser redirect to the IdP authorize endpoint.
func (c Config) AuthorizeRedirect(state, codeChallenge string) (string, error) {
if c.AuthorizeURL == "" {
return "", fmt.Errorf("oidc: authorize URL not resolved")
}
q := url.Values{}
q.Set("response_type", "code")
q.Set("client_id", c.ClientID)
q.Set("redirect_uri", c.RedirectURI)
q.Set("scope", c.ScopesCSV())
q.Set("state", state)
if codeChallenge != "" {
q.Set("code_challenge", codeChallenge)
q.Set("code_challenge_method", "S256")
}
sep := "?"
if strings.Contains(c.AuthorizeURL, "?") {
sep = "&"
}
return c.AuthorizeURL + sep + q.Encode(), nil
}
// TokenResponse is the OAuth token endpoint JSON.
type TokenResponse struct {
AccessToken string `json:"access_token"`
TokenType string `json:"token_type"`
ExpiresIn int `json:"expires_in"`
RefreshToken string `json:"refresh_token"`
IDToken string `json:"id_token"`
Scope string `json:"scope"`
Error string `json:"error"`
ErrorDesc string `json:"error_description"`
}
// ExchangeCode swaps authorization code for tokens (client_secret_post).
func (c Config) ExchangeCode(client *http.Client, code, codeVerifier string) (*TokenResponse, error) {
if c.TokenURL == "" {
return nil, fmt.Errorf("oidc: token URL not resolved")
}
if client == nil {
client = &http.Client{Timeout: 15 * time.Second}
}
form := url.Values{}
form.Set("grant_type", "authorization_code")
form.Set("code", code)
form.Set("redirect_uri", c.RedirectURI)
form.Set("client_id", c.ClientID)
form.Set("client_secret", c.ClientSecret)
if codeVerifier != "" {
form.Set("code_verifier", codeVerifier)
}
req, err := http.NewRequest(http.MethodPost, c.TokenURL, strings.NewReader(form.Encode()))
if err != nil {
return nil, err
}
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
req.Header.Set("Accept", "application/json")
res, err := client.Do(req)
if err != nil {
return nil, fmt.Errorf("oidc token: %w", err)
}
defer res.Body.Close()
body, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
if err != nil {
return nil, err
}
var tok TokenResponse
if err := json.Unmarshal(body, &tok); err != nil {
return nil, fmt.Errorf("oidc token json: %w (%s)", err, truncate(string(body), 200))
}
if tok.Error != "" {
return nil, fmt.Errorf("oidc token: %s (%s)", tok.Error, tok.ErrorDesc)
}
if tok.AccessToken == "" {
return nil, fmt.Errorf("oidc token: empty access_token (HTTP %d)", res.StatusCode)
}
return &tok, nil
}
// UserInfo is the subset we need from /oauth2/userinfo (CFLMY + standard OIDC).
type UserInfo struct {
Sub string `json:"sub"`
Email string `json:"email"`
PreferredUsername string `json:"preferred_username"`
Name string `json:"name"`
Picture string `json:"picture"`
IsAdmin bool `json:"is_admin"`
AdminRole string `json:"admin_role"`
}
// FetchUserInfo calls the userinfo endpoint with a bearer access token.
func (c Config) FetchUserInfo(client *http.Client, accessToken string) (*UserInfo, error) {
if c.UserInfoURL == "" {
return nil, fmt.Errorf("oidc: userinfo URL not resolved")
}
if client == nil {
client = &http.Client{Timeout: 15 * time.Second}
}
req, err := http.NewRequest(http.MethodGet, c.UserInfoURL, nil)
if err != nil {
return nil, err
}
req.Header.Set("Authorization", "Bearer "+accessToken)
req.Header.Set("Accept", "application/json")
res, err := client.Do(req)
if err != nil {
return nil, fmt.Errorf("oidc userinfo: %w", err)
}
defer res.Body.Close()
body, err := io.ReadAll(io.LimitReader(res.Body, 1<<20))
if err != nil {
return nil, err
}
if res.StatusCode >= 300 {
return nil, fmt.Errorf("oidc userinfo HTTP %d: %s", res.StatusCode, truncate(string(body), 200))
}
var info UserInfo
if err := json.Unmarshal(body, &info); err != nil {
return nil, fmt.Errorf("oidc userinfo json: %w", err)
}
if info.Sub == "" {
return nil, fmt.Errorf("oidc userinfo: missing sub")
}
return &info, nil
}
// LocalUsername picks a stable display username for sessions / RBAC.
func (u *UserInfo) LocalUsername() string {
if u == nil {
return ""
}
if s := strings.TrimSpace(u.PreferredUsername); s != "" {
return s
}
if s := strings.TrimSpace(u.Email); s != "" {
if i := strings.IndexByte(s, '@'); i > 0 {
return s[:i]
}
return s
}
if s := strings.TrimSpace(u.Name); s != "" {
return s
}
sub := strings.TrimSpace(u.Sub)
if len(sub) > 32 {
return sub[:32]
}
return sub
}
// IsIdPAdmin reports whether CFLMY IdP marks this user as an administrator.
func (u *UserInfo) IsIdPAdmin() bool {
if u == nil {
return false
}
if u.IsAdmin {
return true
}
return strings.TrimSpace(u.AdminRole) != ""
}
// LocalRole maps IdP admin → site admin; otherwise defaultRole (member).
func (u *UserInfo) LocalRole(defaultRole string) string {
if defaultRole == "" {
defaultRole = "member"
}
if u.IsIdPAdmin() {
return "admin"
}
return defaultRole
}
func truncate(s string, n int) string {
if len(s) <= n {
return s
}
return s[:n] + "…"
}
// ParseConfig reads oidc bag from app / auth options (EN + ZH keys).
func ParseConfig(m map[string]any) Config {
if m == nil {
return Config{}
}
if nested, ok := m["oidc"].(map[string]any); ok {
m = nested
}
c := Config{
Issuer: firstStr(m, "issuer", "发行方", "issuer_url"),
ClientID: firstStr(m, "client_id", "客户端编号", "客户端id", "clientId"),
ClientSecret: firstStr(m, "client_secret", "客户端密钥", "clientSecret"),
RedirectURI: firstStr(m, "redirect_uri", "回调", "回调地址", "redirect"),
Scopes: firstStr(m, "scopes", "范围", "scope"),
CallbackPath: firstStr(m, "callback_path", "回调路径"),
AuthorizeURL: firstStr(m, "authorize_url", "授权地址"),
TokenURL: firstStr(m, "token_url", "令牌地址"),
UserInfoURL: firstStr(m, "userinfo_url", "用户信息地址"),
}
return c
}
func firstStr(m map[string]any, keys ...string) string {
for _, k := range keys {
if v, ok := m[k]; ok {
switch t := v.(type) {
case string:
if s := strings.TrimSpace(t); s != "" && !strings.EqualFold(s, "none") {
return s
}
}
}
}
return ""
}
+49
View File
@@ -0,0 +1,49 @@
package oidc_test
import (
"testing"
"github.com/marqdo/marqdo/plugins/web/internal/oidc"
)
func TestUserInfoLocalRole(t *testing.T) {
u := &oidc.UserInfo{PreferredUsername: "alice", IsAdmin: false}
if u.LocalRole("member") != "member" {
t.Fatal("expected member")
}
u.IsAdmin = true
if u.LocalRole("member") != "admin" {
t.Fatal("expected admin from is_admin")
}
u.IsAdmin = false
u.AdminRole = "super_admin"
if u.LocalRole("member") != "admin" {
t.Fatal("expected admin from admin_role")
}
if u.LocalUsername() != "alice" {
t.Fatalf("username=%s", u.LocalUsername())
}
}
func TestPKCEAndParse(t *testing.T) {
v, err := oidc.RandomURLString(32)
if err != nil || v == "" {
t.Fatal(err)
}
ch := oidc.PKCEChallengeS256(v)
if len(ch) < 20 {
t.Fatalf("challenge=%q", ch)
}
c := oidc.ParseConfig(map[string]any{
"发行方": "https://id.example.com",
"客户端编号": "app_x",
"客户端密钥": "secret",
"回调": "http://localhost:18085/oidc/callback",
})
if !c.Enabled() {
t.Fatal("expected enabled")
}
if c.Callback() != "/oidc/callback" {
t.Fatalf("callback=%s", c.Callback())
}
}
+575
View File
@@ -0,0 +1,575 @@
// Package rbac implements configurable role ⊥ permission for ext/web.
package rbac
import (
"database/sql"
"fmt"
"strings"
"github.com/marqdo/marqdo/plugins/web/internal/db"
)
// Perm is one catalog entry.
type Perm struct {
Code string
Resource string
Action string
Description string
}
// DefaultCatalog is seeded when EnsureSchema runs.
func DefaultCatalog() []Perm {
return []Perm{
{"comments:create", "comments", "create", "Create a comment"},
{"comments:delete", "comments", "delete", "Delete any comment"},
{"comments:delete_own", "comments", "delete_own", "Delete own comment"},
{"desk:access", "desk", "access", "Access writing desk / admin chrome"},
{"roles:manage", "roles", "manage", "Create roles and assign permissions"},
{"posts:edit", "posts", "edit", "Create or edit posts"},
{"users:manage", "users", "manage", "Manage user accounts"},
}
}
// AllCodes returns every default permission code.
func AllCodes() []string {
cat := DefaultCatalog()
out := make([]string, len(cat))
for i, p := range cat {
out[i] = p.Code
}
return out
}
// ExpandRole maps legacy/system role names to permission codes when DB grants are empty.
func ExpandRole(role string) []string {
switch strings.ToLower(strings.TrimSpace(role)) {
case "superadmin", "admin":
return AllCodes()
case "member", "user":
return []string{"comments:create", "comments:delete_own"}
case "editor", "author":
return []string{"comments:create", "comments:delete_own", "posts:edit", "desk:access"}
default:
return nil
}
}
// ParseCSV splits a CSV of permission or role tokens.
func ParseCSV(s string) []string {
var out []string
for _, part := range strings.Split(s, ",") {
part = strings.ToLower(strings.TrimSpace(part))
if part != "" {
out = append(out, part)
}
}
return out
}
// HasAny reports whether held contains any of needed (case-insensitive).
// Empty needed → false. Held containing "*" → true.
func HasAny(held, needed []string) bool {
if len(needed) == 0 {
return false
}
set := map[string]struct{}{}
for _, h := range held {
h = strings.ToLower(strings.TrimSpace(h))
if h == "*" {
return true
}
if h != "" {
set[h] = struct{}{}
}
}
for _, n := range needed {
n = strings.ToLower(strings.TrimSpace(n))
if _, ok := set[n]; ok {
return true
}
}
return false
}
// MergeUnique concatenates permission lists.
func MergeUnique(lists ...[]string) []string {
seen := map[string]struct{}{}
var out []string
for _, list := range lists {
for _, p := range list {
p = strings.ToLower(strings.TrimSpace(p))
if p == "" {
continue
}
if _, ok := seen[p]; ok {
continue
}
seen[p] = struct{}{}
out = append(out, p)
}
}
return out
}
const schemaSQLSqlite = `
CREATE TABLE IF NOT EXISTS web_permissions (
code TEXT PRIMARY KEY,
resource TEXT NOT NULL,
action TEXT NOT NULL,
description TEXT
);
CREATE TABLE IF NOT EXISTS web_roles (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL UNIQUE,
is_system INTEGER NOT NULL DEFAULT 0,
tenant_id TEXT
);
CREATE TABLE IF NOT EXISTS web_role_permissions (
role_id INTEGER NOT NULL,
permission_code TEXT NOT NULL,
PRIMARY KEY (role_id, permission_code),
FOREIGN KEY (role_id) REFERENCES web_roles(id) ON DELETE CASCADE,
FOREIGN KEY (permission_code) REFERENCES web_permissions(code) ON DELETE CASCADE
);
CREATE TABLE IF NOT EXISTS web_users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
username TEXT NOT NULL UNIQUE,
password_hash TEXT NOT NULL,
created_at TEXT
);
CREATE TABLE IF NOT EXISTS web_user_roles (
user_id INTEGER NOT NULL,
role_id INTEGER NOT NULL,
tenant_id TEXT NOT NULL DEFAULT '',
PRIMARY KEY (user_id, role_id, tenant_id),
FOREIGN KEY (user_id) REFERENCES web_users(id) ON DELETE CASCADE,
FOREIGN KEY (role_id) REFERENCES web_roles(id) ON DELETE CASCADE
);
`
var schemaSQLPostgres = []string{
`CREATE TABLE IF NOT EXISTS web_permissions (
code TEXT PRIMARY KEY,
resource TEXT NOT NULL,
action TEXT NOT NULL,
description TEXT
)`,
`CREATE TABLE IF NOT EXISTS web_roles (
id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
name TEXT NOT NULL UNIQUE,
is_system INTEGER NOT NULL DEFAULT 0,
tenant_id TEXT
)`,
`CREATE TABLE IF NOT EXISTS web_role_permissions (
role_id INTEGER NOT NULL,
permission_code TEXT NOT NULL,
PRIMARY KEY (role_id, permission_code),
FOREIGN KEY (role_id) REFERENCES web_roles(id) ON DELETE CASCADE,
FOREIGN KEY (permission_code) REFERENCES web_permissions(code) ON DELETE CASCADE
)`,
`CREATE TABLE IF NOT EXISTS web_users (
id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
username TEXT NOT NULL UNIQUE,
password_hash TEXT NOT NULL,
created_at TEXT
)`,
`CREATE TABLE IF NOT EXISTS web_user_roles (
user_id INTEGER NOT NULL,
role_id INTEGER NOT NULL,
tenant_id TEXT NOT NULL DEFAULT '',
PRIMARY KEY (user_id, role_id, tenant_id),
FOREIGN KEY (user_id) REFERENCES web_users(id) ON DELETE CASCADE,
FOREIGN KEY (role_id) REFERENCES web_roles(id) ON DELETE CASCADE
)`,
}
func insertIgnoreSQL(dbURL, table, cols, placeholders, conflict string) string {
if db.IsPostgres(dbURL) {
return fmt.Sprintf(`INSERT INTO %s(%s) VALUES(%s) ON CONFLICT %s DO NOTHING`, table, cols, placeholders, conflict)
}
return fmt.Sprintf(`INSERT OR IGNORE INTO %s(%s) VALUES(%s)`, table, cols, placeholders)
}
// EnsureSchema creates RBAC tables and seeds default catalog + system roles.
func EnsureSchema(dbURL string) error {
if strings.TrimSpace(dbURL) == "" {
return fmt.Errorf("rbac: empty db url")
}
sqlDB, err := openDB(dbURL)
if err != nil {
return err
}
if db.IsPostgres(dbURL) {
for _, stmt := range schemaSQLPostgres {
if _, err := sqlDB.Exec(stmt); err != nil {
return err
}
}
} else if _, err := sqlDB.Exec(schemaSQLSqlite); err != nil {
return err
}
permSQL := insertIgnoreSQL(dbURL, "web_permissions", "code, resource, action, description", "?,?,?,?", "(code)")
for _, p := range DefaultCatalog() {
_, _ = sqlDB.Exec(permSQL, p.Code, p.Resource, p.Action, p.Description)
}
if err := ensureSystemRole(sqlDB, dbURL, "superadmin", true, AllCodes()); err != nil {
return err
}
if err := ensureSystemRole(sqlDB, dbURL, "member", true, []string{"comments:create", "comments:delete_own"}); err != nil {
return err
}
return nil
}
func ensureSystemRole(sqlDB db.SQLDB, dbURL, name string, isSystem bool, perms []string) error {
var id int64
err := sqlDB.QueryRow(`SELECT id FROM web_roles WHERE name = ?`, name).Scan(&id)
if err == sql.ErrNoRows {
sys := 0
if isSystem {
sys = 1
}
if db.IsPostgres(dbURL) {
err = sqlDB.QueryRow(`INSERT INTO web_roles(name, is_system) VALUES(?,?) RETURNING id`, name, sys).Scan(&id)
if err != nil {
return err
}
} else {
res, err := sqlDB.Exec(`INSERT INTO web_roles(name, is_system) VALUES(?,?)`, name, sys)
if err != nil {
return err
}
id, err = res.LastInsertId()
if err != nil {
return err
}
}
} else if err != nil {
return err
}
rpSQL := insertIgnoreSQL(dbURL, "web_role_permissions", "role_id, permission_code", "?,?", "(role_id, permission_code)")
for _, code := range perms {
_, _ = sqlDB.Exec(rpSQL, id, code)
}
return nil
}
// PermissionsForUser returns permission codes granted via user_roles for username.
func PermissionsForUser(dbURL, username string) ([]string, error) {
sqlDB, err := openDB(dbURL)
if err != nil {
return nil, err
}
rows, err := sqlDB.Query(`
SELECT DISTINCT rp.permission_code
FROM web_users u
JOIN web_user_roles ur ON ur.user_id = u.id
JOIN web_role_permissions rp ON rp.role_id = ur.role_id
WHERE u.username = ?`, username)
if err != nil {
return nil, err
}
defer rows.Close()
var out []string
for rows.Next() {
var code string
if err := rows.Scan(&code); err != nil {
return nil, err
}
out = append(out, strings.ToLower(code))
}
return out, rows.Err()
}
// AssignRole binds username to role name (creates user row link only; user must exist in web_users).
func AssignRole(dbURL, username, roleName string) error {
sqlDB, err := openDB(dbURL)
if err != nil {
return err
}
var uid, rid int64
if err := sqlDB.QueryRow(`SELECT id FROM web_users WHERE username = ?`, username).Scan(&uid); err != nil {
return fmt.Errorf("rbac assign: user %q: %w", username, err)
}
if err := sqlDB.QueryRow(`SELECT id FROM web_roles WHERE name = ?`, roleName).Scan(&rid); err != nil {
return fmt.Errorf("rbac assign: role %q: %w", roleName, err)
}
_, err = sqlDB.Exec(
insertIgnoreSQL(dbURL, "web_user_roles", "user_id, role_id, tenant_id", "?,?,?", "(user_id, role_id, tenant_id)"),
uid, rid, "",
)
return err
}
// CreateRole inserts a non-system role; returns role id.
func CreateRole(dbURL, name string) (int64, error) {
if err := EnsureSchema(dbURL); err != nil {
return 0, err
}
sqlDB, err := openDB(dbURL)
if err != nil {
return 0, err
}
if db.IsPostgres(dbURL) {
var id int64
err = sqlDB.QueryRow(`INSERT INTO web_roles(name, is_system) VALUES(?,0) RETURNING id`, name).Scan(&id)
return id, err
}
res, err := sqlDB.Exec(`INSERT INTO web_roles(name, is_system) VALUES(?,0)`, name)
if err != nil {
return 0, err
}
return res.LastInsertId()
}
// SetRolePermissions replaces role's permissions. grantable restricts what can be set (anti-escalation);
// empty grantable means allow all catalog codes.
func SetRolePermissions(dbURL string, roleID int64, codes, grantable []string) error {
sqlDB, err := openDB(dbURL)
if err != nil {
return err
}
var isSystem int
if err := sqlDB.QueryRow(`SELECT is_system FROM web_roles WHERE id = ?`, roleID).Scan(&isSystem); err != nil {
return err
}
if isSystem == 1 {
return fmt.Errorf("rbac: cannot rewrite system role permissions via set")
}
allow := map[string]struct{}{}
if len(grantable) == 0 {
for _, c := range AllCodes() {
allow[c] = struct{}{}
}
} else {
for _, c := range grantable {
allow[strings.ToLower(c)] = struct{}{}
}
}
tx, err := sqlDB.Begin()
if err != nil {
return err
}
defer func() { _ = tx.Rollback() }()
if _, err := tx.Exec(`DELETE FROM web_role_permissions WHERE role_id = ?`, roleID); err != nil {
return err
}
for _, code := range codes {
code = strings.ToLower(strings.TrimSpace(code))
if code == "" {
continue
}
if _, ok := allow[code]; !ok {
return fmt.Errorf("rbac: cannot grant permission %q (not held by actor)", code)
}
if _, err := tx.Exec(
`INSERT INTO web_role_permissions(role_id, permission_code) VALUES(?,?)`,
roleID, code,
); err != nil {
return err
}
}
return tx.Commit()
}
// CreateUser inserts a web_users row with hashed password; returns user id.
func CreateUser(dbURL, username, passwordHash string) (int64, error) {
username = strings.TrimSpace(username)
if username == "" || passwordHash == "" {
return 0, fmt.Errorf("rbac: username and password_hash required")
}
sqlDB, err := openDB(dbURL)
if err != nil {
return 0, err
}
now := "datetime('now')"
if db.IsPostgres(dbURL) {
var id int64
err = sqlDB.QueryRow(
`INSERT INTO web_users(username, password_hash, created_at) VALUES(?,?,to_char(now() AT TIME ZONE 'UTC','YYYY-MM-DD HH24:MI:SS')) RETURNING id`,
username, passwordHash,
).Scan(&id)
return id, err
}
res, err := sqlDB.Exec(
`INSERT INTO web_users(username, password_hash, created_at) VALUES(?,?,`+now+`)`,
username, passwordHash,
)
if err != nil {
return 0, err
}
return res.LastInsertId()
}
// UserExists reports whether username is in web_users.
func UserExists(dbURL, username string) (bool, error) {
sqlDB, err := openDB(dbURL)
if err != nil {
return false, err
}
var id int64
err = sqlDB.QueryRow(`SELECT id FROM web_users WHERE username = ?`, username).Scan(&id)
if err == sql.ErrNoRows {
return false, nil
}
if err != nil {
return false, err
}
return true, nil
}
// Authenticate checks username/password against web_users; returns primary role name.
func Authenticate(dbURL, username, pass string, verify func(password, encoded string) bool) (role string, ok bool, err error) {
sqlDB, err := openDB(dbURL)
if err != nil {
return "", false, err
}
var hash string
var uid int64
err = sqlDB.QueryRow(`SELECT id, password_hash FROM web_users WHERE username = ?`, username).Scan(&uid, &hash)
if err == sql.ErrNoRows {
return "", false, nil
}
if err != nil {
return "", false, err
}
if verify == nil || !verify(pass, hash) {
return "", false, nil
}
var roleName string
err = sqlDB.QueryRow(`
SELECT r.name FROM web_user_roles ur
JOIN web_roles r ON r.id = ur.role_id
WHERE ur.user_id = ?
ORDER BY r.is_system DESC, r.name
LIMIT 1`, uid).Scan(&roleName)
if err == sql.ErrNoRows {
return "member", true, nil
}
if err != nil {
return "", false, err
}
return strings.ToLower(roleName), true, nil
}
// RegisterUser creates web_users + assigns defaultRole (default member).
func RegisterUser(dbURL, username, passwordHash, defaultRole string) error {
if defaultRole == "" {
defaultRole = "member"
}
exists, err := UserExists(dbURL, username)
if err != nil {
return err
}
if exists {
return fmt.Errorf("rbac: username already taken")
}
if _, err := CreateUser(dbURL, username, passwordHash); err != nil {
return err
}
return AssignRole(dbURL, username, defaultRole)
}
// EnsureUserWithRole creates user if missing (hash may be empty → skip create) and assigns role.
func EnsureUserWithRole(dbURL, username, passwordHash, roleName string) error {
exists, err := UserExists(dbURL, username)
if err != nil {
return err
}
if !exists {
if passwordHash == "" {
return fmt.Errorf("rbac: cannot create user %q without hash", username)
}
if _, err := CreateUser(dbURL, username, passwordHash); err != nil {
return err
}
}
return AssignRole(dbURL, username, roleName)
}
// ListRoles returns [{id,name,is_system}, …].
func ListRoles(dbURL string) ([]map[string]any, error) {
sqlDB, err := openDB(dbURL)
if err != nil {
return nil, err
}
rows, err := sqlDB.Query(`SELECT id, name, is_system FROM web_roles ORDER BY name`)
if err != nil {
return nil, err
}
defer rows.Close()
var out []map[string]any
for rows.Next() {
var id int64
var name string
var sys int
if err := rows.Scan(&id, &name, &sys); err != nil {
return nil, err
}
out = append(out, map[string]any{"id": id, "name": name, "is_system": sys == 1})
}
return out, rows.Err()
}
// ListPermissions returns catalog rows.
func ListPermissions(dbURL string) ([]map[string]any, error) {
sqlDB, err := openDB(dbURL)
if err != nil {
return nil, err
}
rows, err := sqlDB.Query(`SELECT code, resource, action, description FROM web_permissions ORDER BY code`)
if err != nil {
return nil, err
}
defer rows.Close()
var out []map[string]any
for rows.Next() {
var code, resource, action, desc string
if err := rows.Scan(&code, &resource, &action, &desc); err != nil {
return nil, err
}
out = append(out, map[string]any{
"code": code, "resource": resource, "action": action, "description": desc,
})
}
return out, rows.Err()
}
// RolePermissionCodes returns permission codes for a role id.
func RolePermissionCodes(dbURL string, roleID int64) ([]string, error) {
sqlDB, err := openDB(dbURL)
if err != nil {
return nil, err
}
rows, err := sqlDB.Query(`SELECT permission_code FROM web_role_permissions WHERE role_id = ? ORDER BY permission_code`, roleID)
if err != nil {
return nil, err
}
defer rows.Close()
var out []string
for rows.Next() {
var code string
if err := rows.Scan(&code); err != nil {
return nil, err
}
out = append(out, code)
}
return out, rows.Err()
}
// SetRolePermissionsByName looks up role by name then SetRolePermissions.
func SetRolePermissionsByName(dbURL, roleName string, codes, grantable []string) error {
sqlDB, err := openDB(dbURL)
if err != nil {
return err
}
var id int64
if err := sqlDB.QueryRow(`SELECT id FROM web_roles WHERE name = ?`, roleName).Scan(&id); err != nil {
return fmt.Errorf("rbac role %q: %w", roleName, err)
}
return SetRolePermissions(dbURL, id, codes, grantable)
}
func openDB(dbURL string) (db.SQLDB, error) {
return db.OpenSQLDB(dbURL)
}
+58
View File
@@ -0,0 +1,58 @@
package rbac_test
import (
"path/filepath"
"testing"
"github.com/marqdo/marqdo/plugins/web/internal/db"
"github.com/marqdo/marqdo/plugins/web/internal/rbac"
)
func TestHasAnyAndExpandRole(t *testing.T) {
if !rbac.HasAny([]string{"desk:access", "comments:create"}, []string{"desk:access"}) {
t.Fatal("expected desk:access held")
}
if rbac.HasAny([]string{"comments:create"}, []string{"desk:access"}) {
t.Fatal("member should not have desk")
}
if !rbac.HasAny([]string{"*"}, []string{"roles:manage"}) {
t.Fatal("star should allow all")
}
admin := rbac.ExpandRole("admin")
if !rbac.HasAny(admin, []string{"roles:manage", "desk:access"}) {
t.Fatalf("admin expand incomplete: %v", admin)
}
member := rbac.ExpandRole("member")
if rbac.HasAny(member, []string{"desk:access"}) {
t.Fatal("member must not get desk:access")
}
}
func TestEnsureSchemaAndAssign(t *testing.T) {
dir := t.TempDir()
url := "sqlite:" + filepath.Join(dir, "rbac.db")
if err := rbac.EnsureSchema(url); err != nil {
t.Fatal(err)
}
sqlDB, err := db.OpenSQL(url)
if err != nil {
t.Fatal(err)
}
_, err = sqlDB.Exec(`INSERT INTO web_users(username, password_hash, created_at) VALUES('alice','x','now')`)
if err != nil {
t.Fatal(err)
}
if err := rbac.AssignRole(url, "alice", "member"); err != nil {
t.Fatal(err)
}
perms, err := rbac.PermissionsForUser(url, "alice")
if err != nil {
t.Fatal(err)
}
if !rbac.HasAny(perms, []string{"comments:create"}) {
t.Fatalf("alice perms=%v", perms)
}
if rbac.HasAny(perms, []string{"roles:manage"}) {
t.Fatal("member should not manage roles")
}
}
+225
View File
@@ -0,0 +1,225 @@
package render
import (
"fmt"
"regexp"
"strings"
)
var (
rePostForm = regexp.MustCompile(`(?is)<form\b([^>]*\bmethod\s*=\s*["']post["'][^>]*)>([\s\S]*?)</form>`)
reAction = regexp.MustCompile(`(?i)\baction\s*=\s*["']([^"']*)["']`)
reCSRFIn = regexp.MustCompile(`(?i)\bname\s*=\s*["']_csrf["']`)
reNextIn = regexp.MustCompile(`(?i)\bname\s*=\s*["']next["']`)
)
// AuthFormSpec describes a progressive-enhancement login/register form.
type AuthFormSpec struct {
Action string
Submit string
FormID string
ErrID string
Target string
NextDefault string
Kind string // login | register
}
// AuthFormFromPage reads page["auth_form"].
func AuthFormFromPage(page map[string]any) *AuthFormSpec {
if page == nil {
return nil
}
raw, ok := page["auth_form"].(map[string]any)
if !ok || raw == nil {
return nil
}
spec := &AuthFormSpec{
Action: strings.TrimSpace(text(raw["action"])),
Submit: strings.TrimSpace(text(raw["submit"])),
FormID: strings.TrimSpace(text(raw["form_id"])),
ErrID: strings.TrimSpace(text(raw["err_id"])),
Target: strings.TrimSpace(text(raw["target"])),
NextDefault: strings.TrimSpace(text(raw["next"])),
Kind: strings.TrimSpace(strings.ToLower(text(raw["kind"]))),
}
if spec.Action == "" {
return nil
}
if spec.Submit == "" {
if spec.Kind == "register" {
spec.Submit = "注册"
} else {
spec.Submit = "登录"
}
}
if spec.FormID == "" {
if spec.Kind == "register" {
spec.FormID = "site-register-form"
} else {
spec.FormID = "site-login-form"
}
}
if spec.ErrID == "" {
spec.ErrID = "site-auth-err"
}
if spec.Kind == "" {
if strings.Contains(spec.Action, "register") {
spec.Kind = "register"
} else {
spec.Kind = "login"
}
}
return spec
}
// RenderAuthFormHTML builds a complete auth form (CSRF/next filled at inject time too).
func RenderAuthFormHTML(spec *AuthFormSpec, csrf, next, flash string) string {
if spec == nil {
return ""
}
next = strings.TrimSpace(next)
if next == "" {
next = strings.TrimSpace(spec.NextDefault)
}
var b strings.Builder
fmt.Fprintf(&b, `<form id="%s" class="auth-form mq-auth-form" method="post" action="%s">`, esc(spec.FormID), esc(spec.Action))
if csrf != "" {
fmt.Fprintf(&b, `<input type="hidden" name="_csrf" value="%s"/>`, esc(csrf))
}
if next != "" && spec.Kind != "register" {
fmt.Fprintf(&b, `<input type="hidden" name="next" value="%s"/>`, esc(next))
}
b.WriteString(`<label>用户名<input name="username" autocomplete="username" required autofocus/></label>`)
b.WriteString(`<label>密码<input name="password" type="password" autocomplete="`)
if spec.Kind == "register" {
b.WriteString(`new-password`)
} else {
b.WriteString(`current-password`)
}
b.WriteString(`" required`)
if spec.Kind == "register" {
b.WriteString(` minlength="4"`)
}
b.WriteString(`/></label>`)
fmt.Fprintf(&b, `<button type="submit">%s</button>`, esc(spec.Submit))
b.WriteString(`</form>`)
flashAttr := ` hidden`
flashText := ""
if strings.TrimSpace(flash) != "" {
flashAttr = ""
flashText = strings.TrimSpace(flash)
}
fmt.Fprintf(&b, `<p id="%s" class="auth-err"%s>%s</p>`, esc(spec.ErrID), flashAttr, esc(flashText))
return b.String()
}
// ApplyAuthFormIntoIntro injects generated form into intro HTML target, or appends it.
func ApplyAuthFormIntoIntro(intro string, spec *AuthFormSpec, csrf, next, flash string) string {
if spec == nil {
return intro
}
formHTML := RenderAuthFormHTML(spec, csrf, next, flash)
target := strings.TrimSpace(spec.Target)
if target != "" {
if injected, ok := injectHTMLIntoID(intro, target, formHTML); ok {
return injected
}
}
if intro == "" {
return formHTML
}
return intro + formHTML
}
// IsAuthAction reports whether a form action path is a login/register endpoint.
func IsAuthAction(action string) bool {
a := strings.TrimSpace(action)
if a == "" {
return false
}
// Absolute same-origin paths only.
if strings.HasPrefix(a, "http://") || strings.HasPrefix(a, "https://") || strings.HasPrefix(a, "//") {
return false
}
path := a
if i := strings.IndexByte(path, '?'); i >= 0 {
path = path[:i]
}
path = strings.TrimRight(path, "/")
if path == "" {
path = "/"
}
base := path
if i := strings.LastIndexByte(path, '/'); i >= 0 {
base = path[i+1:]
}
return base == "login" || base == "register" ||
strings.HasSuffix(path, "/login") || strings.HasSuffix(path, "/register")
}
// InjectAuthFields ensures POST auth forms carry _csrf / next, and surfaces flash errors.
func InjectAuthFields(html, csrf, next, flash string) string {
csrf = strings.TrimSpace(csrf)
next = strings.TrimSpace(next)
flash = strings.TrimSpace(flash)
if csrf == "" && next == "" && flash == "" {
return html
}
out := rePostForm.ReplaceAllStringFunc(html, func(full string) string {
m := rePostForm.FindStringSubmatch(full)
if len(m) < 3 {
return full
}
attrs, body := m[1], m[2]
am := reAction.FindStringSubmatch(attrs)
action := ""
if len(am) > 1 {
action = am[1]
}
if !IsAuthAction(action) {
return full
}
var inject strings.Builder
if csrf != "" && !reCSRFIn.MatchString(body) {
fmt.Fprintf(&inject, `<input type="hidden" name="_csrf" value="%s"/>`, esc(csrf))
}
if next != "" && !reNextIn.MatchString(body) && !strings.Contains(strings.ToLower(action), "register") {
fmt.Fprintf(&inject, `<input type="hidden" name="next" value="%s"/>`, esc(next))
}
if inject.Len() == 0 {
return full
}
return `<form` + attrs + `>` + inject.String() + body + `</form>`
})
if flash != "" {
out = surfaceAuthFlash(out, flash)
}
return out
}
var reErrSlot = regexp.MustCompile(`(?is)(<(?:p|div)\b[^>]*\bid\s*=\s*["'](?:site-auth-err|desk-login-err|auth-err)["'][^>]*)(>)([^<]*)(</(?:p|div)>)`)
func surfaceAuthFlash(html, flash string) string {
replaced := false
out := reErrSlot.ReplaceAllStringFunc(html, func(full string) string {
m := reErrSlot.FindStringSubmatch(full)
if len(m) < 5 {
return full
}
replaced = true
open := m[1]
open = regexp.MustCompile(`(?i)\s*\bhidden\b`).ReplaceAllString(open, "")
return open + m[2] + esc(flash) + m[4]
})
if replaced {
return out
}
flashHTML := `<p class="flash err auth-err">` + esc(flash) + `</p>`
if i := strings.Index(out, `<main`); i >= 0 {
if j := strings.Index(out[i:], `>`); j >= 0 {
at := i + j + 1
return out[:at] + flashHTML + out[at:]
}
}
return flashHTML + out
}
@@ -0,0 +1,43 @@
package render
import (
"strings"
"testing"
)
func TestInjectAuthFieldsAddsCSRFAndNext(t *testing.T) {
html := `<!DOCTYPE html><html><body><main>
<form id="site-login-form" method="post" action="/login">
<label>用户名<input name="username"/></label>
<button type="submit">登录</button>
</form>
<p id="site-auth-err" class="auth-err" hidden></p>
</main></body></html>`
out := InjectAuthFields(html, "tok123", "/desk", "用户名或密码错误。")
for _, want := range []string{`name="_csrf"`, `value="tok123"`, `name="next"`, `value="/desk"`, `用户名或密码错误`} {
if !strings.Contains(out, want) {
t.Fatalf("missing %q in %s", want, out)
}
}
if strings.Contains(out, `id="site-auth-err" class="auth-err" hidden`) {
t.Fatalf("err still hidden: %s", out)
}
}
func TestInjectSkipsNonAuthForms(t *testing.T) {
html := `<form method="post" action="/_form/comment"><input name="body"/></form>`
out := InjectAuthFields(html, "tok", "/x", "")
if strings.Contains(out, `_csrf`) {
t.Fatalf("should not inject into comment form: %s", out)
}
}
func TestRenderAuthFormHTML(t *testing.T) {
spec := &AuthFormSpec{Action: "/desk/login", Submit: "进入后台", FormID: "desk-login-form", ErrID: "desk-login-err", NextDefault: "/desk", Kind: "login"}
html := RenderAuthFormHTML(spec, "c", "", "")
for _, want := range []string{`action="/desk/login"`, `name="_csrf"`, `value="/desk"`, `进入后台`} {
if !strings.Contains(html, want) {
t.Fatalf("missing %q in %s", want, html)
}
}
}
+247
View File
@@ -0,0 +1,247 @@
package render
import (
"regexp"
"strings"
"unicode"
"unicode/utf8"
)
// formatMetaDate shortens ISO timestamps to YYYY-MM-DD for card/article meta.
func formatMetaDate(s string) string {
s = strings.TrimSpace(s)
if len(s) >= 10 && s[4] == '-' && s[7] == '-' {
if len(s) == 10 || s[10] == 'T' || s[10] == ' ' {
return s[:10]
}
}
return s
}
func navBrandSpec(page map[string]any) map[string]any {
if page == nil {
return nil
}
if b, ok := page["nav_brand"].(map[string]any); ok {
return b
}
return nil
}
func themeKeyOf(page map[string]any) string {
if b := navBrandSpec(page); b != nil {
if k := text(b["theme_key"]); k != "" {
return k
}
if k := text(b["主题键"]); k != "" {
return k
}
}
return "mq-theme"
}
func renderNavBrandHTML(page map[string]any) string {
b := navBrandSpec(page)
if b == nil {
return ""
}
title := text(b["title"])
if title == "" {
title = text(b["标题"])
}
if title == "" {
title = text(page["title"])
}
href := text(b["href"])
if href == "" {
href = text(b["链接"])
}
if href == "" {
href = "/"
}
logo := text(b["logo"])
if logo == "" {
logo = text(b["标志"])
}
var s strings.Builder
s.WriteString(`<a id="nav-brand" class="nav-brand" href="`)
s.WriteString(esc(href))
s.WriteString(`" aria-label="`)
s.WriteString(esc(title))
s.WriteString(`">`)
if logo != "" {
s.WriteString(`<img class="nav-brand-logo" src="`)
s.WriteString(esc(logo))
s.WriteString(`" alt="`)
s.WriteString(esc(title))
s.WriteString(`" width="36" height="36" decoding="async"/>`)
}
if title != "" {
s.WriteString(`<span class="nav-brand-text">`)
s.WriteString(esc(title))
s.WriteString(`</span>`)
}
s.WriteString(`</a>`)
s.WriteString(`<button type="button" id="nav-menu-toggle" class="nav-menu-toggle" aria-controls="site-side-drawer" aria-expanded="false" aria-label="打开目录">`)
s.WriteString(`<span class="nav-menu-bars" aria-hidden="true"><i></i><i></i><i></i></span>`)
s.WriteString(`<span class="nav-menu-label">目录</span></button>`)
return s.String()
}
func renderThemeToggleHTML(page map[string]any) string {
if navBrandSpec(page) == nil {
return ""
}
return `<button type="button" id="theme-toggle" class="theme-toggle on-dark" title="切换主题" aria-label="切换到浅色模式">浅色</button>`
}
func renderNavInner(page map[string]any, linksHTML string) string {
brand := renderNavBrandHTML(page)
toggle := renderThemeToggleHTML(page)
return brand + linksHTML + toggle
}
func chromeExtrasHTML(page map[string]any) string {
if navBrandSpec(page) == nil && pageClient(page) == nil {
return ""
}
return `<div id="qd-progress" aria-hidden="true"></div>` +
`<button type="button" id="nav-drawer-veil" class="nav-drawer-veil" aria-label="关闭目录" hidden></button>`
}
func pageClient(page map[string]any) map[string]any {
if page == nil {
return nil
}
if c, ok := page["client"].(map[string]any); ok {
return c
}
return nil
}
func themeBootScript(page map[string]any) string {
if navBrandSpec(page) == nil && pageClient(page) == nil {
return ""
}
key := themeKeyOf(page)
return `<script>(function(){try{var t=localStorage.getItem("` + key + `");` +
`if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t);` +
`else document.documentElement.setAttribute("data-theme","dark");` +
`}catch(e){document.documentElement.setAttribute("data-theme","dark");}})();</script>`
}
func clientEmbedScript(page map[string]any) string {
c := pageClient(page)
if c == nil {
return ""
}
source := text(c["source"])
if source == "" {
source = text(c["源"])
}
if source == "" {
return ""
}
bridge := text(c["bridge"])
if bridge == "" {
bridge = text(c["桥"])
}
if bridge == "" {
bridge = "/static/marqdo-bridge.js"
}
wasm := text(c["wasm"])
if wasm == "" {
wasm = "/static/marqdo_wasm.wasm"
}
ver := ""
if v, ok := page["asset_version"].(string); ok {
ver = strings.TrimSpace(v)
} else if v, ok := page["资源版本"].(string); ok {
ver = strings.TrimSpace(v)
}
if ver != "" {
bridge = withAssetQuery(bridge, ver)
wasm = withAssetQuery(wasm, ver)
source = withAssetQuery(source, ver)
}
return `<script type="module" src="` + esc(bridge) + `" data-mq-wasm="` + esc(wasm) +
`" data-mq-source-url="` + esc(source) + `"></script>`
}
func withAssetQuery(url, ver string) string {
if ver == "" || url == "" {
return url
}
if strings.Contains(url, "v=") {
return url
}
sep := "?"
if strings.Contains(url, "?") {
sep = "&"
}
return url + sep + "v=" + ver
}
var firstPBlockRe = regexp.MustCompile(`(?is)^(\s*)(<p\b[^>]*>)(.*?)(</p>)`)
func shouldDropcap(plain string) bool {
plain = strings.Join(strings.Fields(plain), "")
if plain == "" {
return false
}
if strings.HasPrefix(plain, "$$") {
return false
}
r, _ := utf8.DecodeRuneInString(plain)
if r == '$' || r == '\\' || r == '[' || r == '(' || unicode.IsDigit(r) {
return false
}
if unicode.In(r, unicode.Han) {
return true
}
return (r >= 'A' && r <= 'Z') || (r >= 'a' && r <= 'z')
}
func stripTags(s string) string {
var b strings.Builder
in := false
for _, r := range s {
switch {
case r == '<':
in = true
case r == '>':
in = false
case !in:
b.WriteRune(r)
}
}
return b.String()
}
// tuneDropcapHTML adds has-dropcap to the first eligible paragraph in article markdown HTML.
func tuneDropcapHTML(inner string) string {
m := firstPBlockRe.FindStringSubmatch(inner)
if m == nil {
return inner
}
plain := stripTags(m[3])
if !shouldDropcap(plain) {
return inner
}
open := m[2]
if strings.Contains(open, "has-dropcap") {
return inner
}
if strings.Contains(open, `class="`) {
open = strings.Replace(open, `class="`, `class="has-dropcap `, 1)
} else if strings.Contains(open, `class='`) {
open = strings.Replace(open, `class='`, `class='has-dropcap `, 1)
} else {
open = strings.TrimSuffix(open, ">") + ` class="has-dropcap">`
}
loc := firstPBlockRe.FindStringIndex(inner)
if loc == nil {
return inner
}
return inner[:loc[0]] + m[1] + open + m[3] + m[4] + inner[loc[1]:]
}
@@ -0,0 +1,27 @@
package render
import (
"strings"
"testing"
)
func TestFormatMetaDate(t *testing.T) {
if got := formatMetaDate("2026-09-17T13:41:04Z"); got != "2026-09-17" {
t.Fatalf("got %q", got)
}
if got := formatMetaDate("plain"); got != "plain" {
t.Fatalf("got %q", got)
}
}
func TestTuneDropcapHTML(t *testing.T) {
in := "<p>中文首段。</p><p>二段</p>"
out := tuneDropcapHTML(in)
if !strings.Contains(out, `class="has-dropcap"`) {
t.Fatalf("expected dropcap: %s", out)
}
skip := "<p>$E=mc^2$</p>"
if got := tuneDropcapHTML(skip); strings.Contains(got, "has-dropcap") {
t.Fatalf("formula should skip: %s", got)
}
}
+6 -1
View File
@@ -10,6 +10,11 @@ import (
"github.com/yuin/goldmark/renderer/html"
)
// MarkdownToHTML renders Markdown to an article-body HTML fragment (GFM subset).
func MarkdownToHTML(md string) string {
return markdownToHTML(md)
}
// markdownToHTML renders article body Markdown to HTML (GFM subset), matching
// the Rust web plugin's pulldown-cmark path.
func markdownToHTML(md string) string {
@@ -34,5 +39,5 @@ func markdownToHTML(md string) string {
if err := gm.Convert([]byte(md), &buf); err != nil {
return `<div class="article-body"><p class="article-p">` + esc(md) + `</p></div>`
}
return `<div class="article-body md">` + buf.String() + `</div>`
return `<div class="article-body md">` + tuneDropcapHTML(buf.String()) + `</div>`
}
+28
View File
@@ -0,0 +1,28 @@
package render
import (
"strings"
"testing"
)
func TestIsRailTarget(t *testing.T) {
for _, in := range []string{"rail", "轨", "新闻轨", "#side-rail", "aside.side-rail"} {
if !isRailTarget(in) {
t.Fatalf("expected rail: %q", in)
}
}
if isRailTarget("#comment-list") {
t.Fatal("comment list must not be rail")
}
}
func TestRenderNewsRail(t *testing.T) {
html := renderNewsRail([]map[string]any{
{"title": "A", "href": "https://ex.test/a", "meta": "2026-09-01", "tag": "IBM"},
})
for _, want := range []string{`side-rail--news`, `https://ex.test/a`, `target="_blank"`, `量子新闻`, `全部 →`} {
if !strings.Contains(html, want) {
t.Fatalf("missing %q in %s", want, html)
}
}
}
+463 -31
View File
@@ -462,6 +462,192 @@ func resolveMain(page map[string]any, dbURL string) (intro string, items []map[s
return intro, items, total
}
// listBind is one secondary page list (compose_list / 列表装配).
type listBind struct {
Items []map[string]any
Target string
HTML string
Rail bool
}
func isRailTarget(target string) bool {
t := strings.TrimSpace(strings.ToLower(target))
t = strings.TrimPrefix(t, "#")
switch t {
case "rail", "轨", "side-rail", "aside.side-rail", "新闻轨":
return true
default:
return false
}
}
func resolveLists(page map[string]any, dbURL string) []listBind {
raw, ok := page["lists"].([]any)
if !ok || len(raw) == 0 || dbURL == "" {
return nil
}
var out []listBind
for _, entry := range raw {
em, ok := entry.(map[string]any)
if !ok {
continue
}
bindsAny := table.AsBind(em["main"])
arr, _ := bindsAny.([]any)
if len(arr) == 0 {
continue
}
tn, ok := table.BindTableName(arr)
if !ok {
continue
}
sub := map[string]any{"params": pageParams(page)}
if q, ok := em["query"]; ok {
sub["query"] = q
}
if o, ok := em["order"].(string); ok {
sub["order"] = o
}
limit := int64(200)
target := ""
if t, ok := em["target"].(string); ok {
target = t
}
if isRailTarget(target) {
limit = 24
}
data := selectPageData(dbURL, tn, sub, limit, 0)
rawRows, _ := data["rows"].([]any)
projected := table.ProjectRows(arr, rawRows)
parr, _ := projected.([]any)
var items []map[string]any
for _, v := range parr {
if m, ok := v.(map[string]any); ok {
items = append(items, m)
}
}
lb := listBind{Items: items, Target: target, Rail: isRailTarget(target)}
if lb.Rail {
lb.HTML = renderNewsRail(items)
} else {
lb.HTML = renderListSection(page, items)
}
out = append(out, lb)
}
return out
}
func renderNewsRail(items []map[string]any) string {
var list strings.Builder
if len(items) == 0 {
list.WriteString(`<li class="side-news-empty">暂无快讯,请在库表 news 中添加。</li>`)
} else {
for _, it := range items {
title := text(it["title"])
href := strings.TrimSpace(text(it["href"]))
if href == "" {
href = "#"
}
meta := text(it["meta"])
if len(meta) > 10 {
meta = meta[:10]
}
tag := text(it["tag"])
ext := strings.HasPrefix(href, "http://") || strings.HasPrefix(href, "https://")
list.WriteString(`<li>`)
list.WriteString(`<a href="` + esc(href) + `"`)
if ext {
list.WriteString(` target="_blank" rel="noopener noreferrer"`)
}
list.WriteString(`>`)
list.WriteString(`<span class="side-news-meta">`)
if meta != "" {
list.WriteString(`<time>` + esc(meta) + `</time>`)
}
if tag != "" {
list.WriteString(`<span class="side-news-src">` + esc(tag) + `</span>`)
}
list.WriteString(`</span>`)
list.WriteString(`<span class="side-news-title">` + esc(title) + `</span>`)
list.WriteString(`</a></li>`)
}
}
return `<aside class="side-rail side-rail--news" aria-label="量子新闻">` +
`<div class="side-rail-head">` +
`<p class="side-rail-label">量子新闻</p>` +
`<a class="side-rail-jump" href="/news" title="浏览全部新闻" aria-label="浏览全部新闻">全部 →</a>` +
`</div>` +
`<div class="side-rail-body"><ul class="side-news-list">` + list.String() + `</ul></div>` +
`</aside>`
}
func renderListSection(page map[string]any, items []map[string]any) string {
var s strings.Builder
s.WriteString(`<div class="list-bind" aria-live="polite">`)
if len(items) == 0 {
s.WriteString(`<p class="list-empty comment-empty">还没有条目。</p>`)
} else {
s.WriteString(`<ul class="list-thread comment-thread">`)
for _, it := range items {
s.WriteString(renderListItem(page, it))
}
s.WriteString(`</ul>`)
}
s.WriteString(`</div>`)
return s.String()
}
func renderListItem(page map[string]any, it map[string]any) string {
title := text(it["title"])
body := text(it["body"])
meta := text(it["meta"])
href := text(it["href"])
if href != "" {
return `<li class="list-item">` + renderCard(page, it) + `</li>`
}
var s strings.Builder
s.WriteString(`<li class="list-item comment-item">`)
s.WriteString(`<div class="comment-meta">`)
if title != "" {
s.WriteString(fmt.Sprintf(`<span class="comment-author">%s</span>`, esc(title)))
}
if meta != "" {
s.WriteString(fmt.Sprintf(`<time>%s</time>`, esc(meta)))
}
s.WriteString(`</div>`)
if body != "" {
escaped := esc(body)
escaped = strings.ReplaceAll(escaped, "\n", "<br>")
s.WriteString(fmt.Sprintf(`<p class="comment-body">%s</p>`, escaped))
}
s.WriteString(`</li>`)
return s.String()
}
func applyListTargets(intro string, lists []listBind) (string, string, string) {
rest := strings.Builder{}
rail := ""
for _, lb := range lists {
if lb.HTML == "" {
continue
}
if lb.Rail {
if rail == "" {
rail = lb.HTML
}
continue
}
if lb.Target != "" && intro != "" {
if injected, ok := injectHTMLIntoID(intro, lb.Target, lb.HTML); ok {
intro = injected
continue
}
}
rest.WriteString(lb.HTML)
}
return intro, rest.String(), rail
}
func fieldCSS(obj map[string]any, field string) string {
css, _ := obj["_css"].(map[string]any)
if css == nil {
@@ -617,6 +803,9 @@ func headHTML(page map[string]any, defaultTitle string) string {
}
var s strings.Builder
s.WriteString(fmt.Sprintf("<title>%s</title>", esc(pageTitle)))
if csrf, ok := page["_csrf"].(string); ok && strings.TrimSpace(csrf) != "" {
s.WriteString(fmt.Sprintf(`<meta name="csrf-token" content="%s"/>`, esc(strings.TrimSpace(csrf))))
}
if meta, ok := page["meta"].(map[string]any); ok {
for k, v := range meta {
if k == "title" {
@@ -649,29 +838,152 @@ func headHTML(page map[string]any, defaultTitle string) string {
assetVersion = v
}
s.WriteString(assets.RenderHeadLinksWithVersion(links, assetVersion))
if headNeedsKatexBoot(links) {
s.WriteString(katexBootScript())
}
}
if pageNeedsMarkdownPreview(page) {
s.WriteString(markdownPreviewBootScript())
}
s.WriteString(themeBootScript(page))
s.WriteString(clientEmbedScript(page))
return s.String()
}
func headNeedsKatexBoot(links []assets.HeadLink) bool {
hasAuto := false
for _, l := range links {
href := strings.ToLower(l.Href)
if strings.Contains(href, "auto-render") {
hasAuto = true
break
}
}
return hasAuto
}
func katexBootScript() string {
// Official host glue: call KaTeX auto-render after deferred scripts load.
// Authors must not ship this as business JS.
return `<script defer>
document.addEventListener("DOMContentLoaded",function(){
if(typeof renderMathInElement!=="function")return;
var roots=document.querySelectorAll(".article,.article-body.md");
if(!roots.length)roots=document.querySelectorAll("main.main");
var opts={delimiters:[
{left:"$$",right:"$$",display:true},
{left:"\\[",right:"\\]",display:true},
{left:"$",right:"$",display:false},
{left:"\\(",right:"\\)",display:false}
],throwOnError:false,ignoredTags:["script","noscript","style","textarea","pre","code"]};
for(var i=0;i<roots.length;i++){try{renderMathInElement(roots[i],opts);}catch(e){}}
});
</script>`
}
func pageNeedsMarkdownPreview(page map[string]any) bool {
if page == nil {
return false
}
frm, _ := page["form"].(map[string]any)
if frm == nil {
return false
}
fields, _ := frm["fields"].([]any)
for _, f := range fields {
fm, ok := f.(map[string]any)
if !ok {
continue
}
ty := strings.ToLower(strings.TrimSpace(text(fm["type"])))
if ty == "markdown" {
return true
}
}
return false
}
func markdownPreviewBootScript() string {
// Official host glue: live-preview textarea.mq-markdown via POST /_md.
return `<script defer>
document.addEventListener("DOMContentLoaded",function(){
var tas=document.querySelectorAll("textarea.mq-markdown[data-mq-field=markdown]");
for(var i=0;i<tas.length;i++){(function(ta){
var root=ta.closest(".md-field")||ta.parentElement;
var prev=root&&root.querySelector(".mq-md-preview");
if(!prev)return;
var timer=null;
function run(){
fetch("/_md",{method:"POST",headers:{"Content-Type":"text/plain;charset=utf-8"},body:ta.value||""})
.then(function(r){return r.text();})
.then(function(html){prev.innerHTML=html||'<p class="lede mq-md-empty">预览</p>';})
.catch(function(){});
}
ta.addEventListener("input",function(){clearTimeout(timer);timer=setTimeout(run,160);});
run();
})(tas[i]);}
});
</script>`
}
func cardHref(page map[string]any, href string) string {
href = strings.TrimSpace(href)
if href == "" {
return ""
}
if strings.HasPrefix(href, "http://") || strings.HasPrefix(href, "https://") || strings.HasPrefix(href, "//") {
return href
}
if strings.HasPrefix(href, "/") {
return href
}
prefix := "/post/"
if page != nil {
if p, ok := page["link_prefix"].(string); ok {
prefix = p
}
}
return prefix + href
}
func renderCard(page map[string]any, it map[string]any) string {
title := text(it["title"])
body := text(it["body"])
href := text(it["href"])
href := cardHref(page, text(it["href"]))
meta := text(it["meta"])
tag := text(it["tag"])
tc := classAttr(fieldCSS(it, "title"))
bc := classAttr(fieldCSS(it, "body"))
var card strings.Builder
card.WriteString(`<article class="card">`)
if href != "" {
prefix := "/post/"
if p, ok := page["link_prefix"].(string); ok {
prefix = p
cls := "card"
switch v := it["pinned"].(type) {
case bool:
if v {
cls += " is-pinned"
}
card.WriteString(fmt.Sprintf(`<a class="card-link" href="%s">`, esc(prefix+href)))
case string:
if v == "1" || strings.EqualFold(v, "true") {
cls += " is-pinned"
}
case float64:
if v == 1 {
cls += " is-pinned"
}
case int:
if v == 1 {
cls += " is-pinned"
}
case int64:
if v == 1 {
cls += " is-pinned"
}
}
var card strings.Builder
card.WriteString(`<article class="` + cls + `">`)
if href != "" {
card.WriteString(fmt.Sprintf(`<a class="card-link" href="%s">`, esc(href)))
}
if meta != "" {
card.WriteString(fmt.Sprintf(`<div class="card-meta">%s</div>`, esc(meta)))
card.WriteString(fmt.Sprintf(`<div class="card-meta">%s</div>`, esc(formatMetaDate(meta))))
}
card.WriteString(fmt.Sprintf("<h2%s>%s</h2>", tc, esc(title)))
if tag != "" {
@@ -695,7 +1007,7 @@ func renderArticle(it map[string]any) string {
var s strings.Builder
s.WriteString(`<article class="article">`)
if meta != "" {
s.WriteString(fmt.Sprintf(`<div class="article-meta">%s</div>`, esc(meta)))
s.WriteString(fmt.Sprintf(`<div class="article-meta">%s</div>`, esc(formatMetaDate(meta))))
}
s.WriteString(fmt.Sprintf(`<h1 class="article-title">%s</h1>`, esc(title)))
if tag != "" {
@@ -846,9 +1158,69 @@ func pageFormHTML(page map[string]any) (formID string, html string) {
if !ok || frm == nil {
return "", ""
}
return id, form.RenderBody(frm, id, nil, nil, "")
ctx := &form.RequestContext{
Params: pageParams(page),
}
if u, ok := page["_nav_user"].(string); ok {
ctx.Username = u
}
if r, ok := page["_route"].(string); ok && r != "" {
ctx.ReturnPath = r
ctx.Path = r
}
data := resolveFormData(page, "")
return id, form.RenderBodyCtx(frm, id, data, nil, "", ctx)
}
// resolveFormData returns stamped form_data, or loads a DB row via form_load + params.
func resolveFormData(page map[string]any, dbURL string) map[string]any {
if page == nil {
return nil
}
if raw, ok := page["form_data"].(map[string]any); ok && raw != nil && len(raw) > 0 {
return raw
}
if dbURL == "" {
if u, ok := page["_db_url"].(string); ok {
dbURL = u
}
}
load, ok := page["form_load"].(map[string]any)
if !ok || load == nil || dbURL == "" {
return nil
}
table := text(load["table"])
if table == "" {
table = text(load["表"])
}
if table == "" {
return nil
}
idParam := text(load["id_param"])
if idParam == "" {
idParam = text(load["id参数"])
}
if idParam == "" {
idParam = "id"
}
id := ""
if params, ok := page["params"].(map[string]any); ok {
id = text(params[idParam])
}
if id == "" {
return nil
}
row, err := db.Get(dbURL, table, id)
if err != nil || row == nil {
return nil
}
if m, ok := row.(map[string]any); ok {
return m
}
return nil
}
func pushIntro(buf *strings.Builder, intro string) {
pushIntroAndForm(buf, intro, nil)
}
@@ -870,12 +1242,12 @@ func pushIntroAndForm(buf *strings.Builder, intro string, page map[string]any) {
}
if formHTML != "" && target != "" && intro != "" {
if injected, ok := injectHTMLIntoID(intro, target, formHTML); ok {
buf.WriteString(fmt.Sprintf(`<div class="main-intro">%s</div>`, injected))
buf.WriteString(fmt.Sprintf(`<div class="%s">%s</div>`, introWrapClass(injected), injected))
return
}
}
if intro != "" {
buf.WriteString(fmt.Sprintf(`<div class="main-intro">%s</div>`, intro))
buf.WriteString(fmt.Sprintf(`<div class="%s">%s</div>`, introWrapClass(intro), intro))
}
if formHTML != "" {
buf.WriteString(formHTML)
@@ -883,6 +1255,13 @@ func pushIntroAndForm(buf *strings.Builder, intro string, page map[string]any) {
}
}
func introWrapClass(intro string) string {
if strings.Contains(intro, "masthead-guide") {
return "main-intro masthead-split"
}
return "main-intro"
}
func renderFragment(page map[string]any, dbURL, slot string) string {
slot = table.NormalizeSlot(slot)
switch slot {
@@ -890,12 +1269,12 @@ func renderFragment(page map[string]any, dbURL, slot string) string {
links := resolveLinks(page["nav"], dbURL, page)
return fmt.Sprintf(
`<header class="topnav" data-slot="nav">%s</header>`,
renderULWithMQ(links, "nav", nil),
renderNavInner(page, renderULWithMQ(links, "nav", nil)),
)
case "sidebar":
links := resolveLinks(page["sidebar"], dbURL, page)
return fmt.Sprintf(
`<aside class="side" data-slot="sidebar"><span class="side-label">侧栏</span>%s</aside>`,
`<aside class="side" id="site-side-drawer" role="navigation" aria-label="站点目录" data-slot="sidebar"><span class="side-label">侧栏</span>%s</aside>`,
renderULWithMQ(links, "side-nav", nil),
)
case "footer":
@@ -906,19 +1285,26 @@ func renderFragment(page map[string]any, dbURL, slot string) string {
)
default:
intro, items, _ := resolveMain(page, dbURL)
lists := resolveLists(page, dbURL)
intro, listRest, _ := applyListTargets(intro, lists)
isDetail, _ := page["detail"].(bool)
var body strings.Builder
pushIntroAndForm(&body, intro, page)
if len(items) > 0 {
isDetail, _ := page["detail"].(bool)
if isDetail {
if isDetail {
if len(items) > 0 {
body.WriteString(renderArticle(items[0]))
} else {
}
body.WriteString(listRest)
pushIntroAndForm(&body, intro, page)
} else {
pushIntroAndForm(&body, intro, page)
if len(items) > 0 {
body.WriteString(`<section class="content cards">`)
for _, it := range items {
body.WriteString(renderCard(page, it))
}
body.WriteString(`</section>`)
}
body.WriteString(listRest)
}
return fmt.Sprintf(`<main class="main" data-slot="main">%s</main>`, body.String())
}
@@ -929,6 +1315,9 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
if page == nil {
page = map[string]any{}
}
if dbURL != "" {
page["_db_url"] = dbURL
}
if partID != "" {
parts, _ := page["parts"].(map[string]any)
if parts != nil {
@@ -967,6 +1356,9 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
side := resolveLinks(page["sidebar"], dbURL, page)
foot := resolveLinks(page["footer"], dbURL, page)
intro, items, total := resolveMain(page, dbURL)
if params, ok := page["params"].(map[string]any); ok && len(params) > 0 && intro != "" {
intro = ResolveRouteParams(intro, params)
}
navCSS, mqPairs := navMediaClassMapMany(nav, side, foot)
extra, _ := page["styles_css"].(string)
if navCSS != "" {
@@ -1011,21 +1403,49 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
if images, ok := page["images_html"].(string); ok && images != "" {
mainHTML.WriteString(images)
}
pushIntroAndForm(&mainHTML, intro, page)
if len(items) > 0 {
isDetail, _ := page["detail"].(bool)
if isDetail {
lists := resolveLists(page, dbURL)
csrfTok := ""
if v, ok := page["_csrf"].(string); ok {
csrfTok = strings.TrimSpace(v)
}
authNext := ""
if v, ok := page["_auth_next"].(string); ok {
authNext = strings.TrimSpace(v)
}
flashErr := ""
if v, ok := page["_flash_err"].(string); ok {
flashErr = strings.TrimSpace(v)
}
if spec := AuthFormFromPage(page); spec != nil {
if authNext == "" && spec.NextDefault != "" {
authNext = spec.NextDefault
}
intro = ApplyAuthFormIntoIntro(intro, spec, csrfTok, authNext, flashErr)
}
intro, listRest, railHTML := applyListTargets(intro, lists)
isDetail, _ := page["detail"].(bool)
if isDetail {
if len(items) > 0 {
mainHTML.WriteString(renderArticle(items[0]))
} else {
if total != nil {
mainHTML.WriteString(renderPagination(page, *total, len(items)))
}
}
mainHTML.WriteString(listRest)
pushIntroAndForm(&mainHTML, intro, page)
} else {
pushIntroAndForm(&mainHTML, intro, page)
if len(items) > 0 {
mainHTML.WriteString(`<section class="content cards">`)
for _, it := range items {
mainHTML.WriteString(renderCard(page, it))
}
mainHTML.WriteString(`</section>`)
if total != nil {
mainHTML.WriteString(renderPagination(page, *total, len(items)))
}
}
if total != nil {
mainHTML.WriteString(renderPagination(page, *total, len(items)))
}
mainHTML.WriteString(listRest)
}
styleBlock := ""
@@ -1037,7 +1457,7 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
sideHTML := ""
if showChrome && hasSide {
sideHTML = fmt.Sprintf(
`<aside class="%s"%s><span class="side-label">侧栏</span>%s</aside>`,
`<aside class="%s" id="site-side-drawer" role="navigation" aria-label="站点目录"%s><span class="side-label">侧栏</span>%s</aside>`,
slotClass(page, "sidebar", "side"),
slotAttrs("sidebar", parts, page),
renderULWithMQ(side, "side-nav", mqPairs),
@@ -1052,7 +1472,7 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
`<header class="%s"%s>%s</header>`,
slotClass(page, "nav", "topnav"),
slotAttrs("nav", parts, page),
renderULWithMQ(nav, "nav", mqPairs),
renderNavInner(page, renderULWithMQ(nav, "nav", mqPairs)),
)
}
}
@@ -1077,8 +1497,15 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
bodyClass = bodyClass + " " + strings.TrimSpace(extraBody)
}
}
if railHTML != "" && !strings.Contains(bodyClass, "has-rail") {
if bodyClass == "" {
bodyClass = "has-rail"
} else {
bodyClass = bodyClass + " has-rail"
}
}
return fmt.Sprintf(`<!DOCTYPE html>
html := fmt.Sprintf(`<!DOCTYPE html>
<html lang="zh-CN"><head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
@@ -1088,17 +1515,22 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
<body class="%s">
%s
%s
%s
<main class="%s"%s>%s</main>
%s
%s
</body></html>`,
headHTML(page, title),
styleBlock,
bodyClass,
chromeExtrasHTML(page),
headerHTML,
sideHTML,
slotClass(page, "main", "main"),
slotAttrs("main", parts, page),
mainHTML.String(),
railHTML,
footerHTML,
)
return InjectAuthFields(html, csrfTok, authNext, flashErr)
}
@@ -257,3 +257,63 @@ func TestPartSlotSrcUsesResolvedRoute(t *testing.T) {
t.Fatalf("missing resolved slot src: %s", html)
}
}
func TestNavBrandClientChrome(t *testing.T) {
page := map[string]any{
"title": "求道量子",
"nav": []any{
map[string]any{"label": "文章", "href": "/"},
},
"nav_brand": map[string]any{
"title": "求道量子",
"href": "/",
"logo": "/static/logo.png",
"theme_key": "mq-theme",
},
"client": map[string]any{
"source": "/static/client.mq.md",
},
}
html := render.RenderPage(page, "", "")
if !strings.Contains(html, `id="nav-brand"`) {
t.Fatalf("missing nav-brand: %s", html[:500])
}
if !strings.Contains(html, `id="theme-toggle"`) {
t.Fatalf("missing theme-toggle")
}
if !strings.Contains(html, `id="nav-menu-toggle"`) {
t.Fatalf("missing menu toggle")
}
if !strings.Contains(html, `data-mq-source-url="/static/client.mq.md"`) {
t.Fatalf("missing client embed")
}
if !strings.Contains(html, `localStorage.getItem("mq-theme")`) {
t.Fatalf("missing theme boot")
}
if !strings.Contains(html, `id="qd-progress"`) {
t.Fatalf("missing progress")
}
if !strings.Contains(html, `id="nav-drawer-veil"`) {
t.Fatalf("missing drawer veil")
}
}
func TestClientEmbedAssetVersion(t *testing.T) {
page := map[string]any{
"title": "v",
"asset_version": "20260918d",
"client": map[string]any{
"source": "/static/client.mq.md",
},
}
html := render.RenderPage(page, "", "")
if !strings.Contains(html, `/static/marqdo-bridge.js?v=20260918d`) {
t.Fatalf("missing versioned bridge: %s", html)
}
if !strings.Contains(html, `data-mq-wasm="/static/marqdo_wasm.wasm?v=20260918d"`) {
t.Fatalf("missing versioned wasm")
}
if !strings.Contains(html, `data-mq-source-url="/static/client.mq.md?v=20260918d"`) {
t.Fatalf("missing versioned source")
}
}
@@ -103,3 +103,20 @@ func TestMarkdownToHTML(t *testing.T) {
t.Fatalf("%s", out)
}
}
func TestCardHrefAbsoluteAndPrefixed(t *testing.T) {
page := map[string]any{"link_prefix": "/post/"}
if got := cardHref(page, "https://example.com/a"); got != "https://example.com/a" {
t.Fatalf("absolute: %q", got)
}
if got := cardHref(page, "/about"); got != "/about" {
t.Fatalf("root: %q", got)
}
if got := cardHref(page, "hello"); got != "/post/hello" {
t.Fatalf("prefixed: %q", got)
}
html := renderCard(page, map[string]any{"title": "T", "href": "https://ex.test/x", "body": "b"})
if !strings.Contains(html, `href="https://ex.test/x"`) {
t.Fatalf("card absolute: %s", html)
}
}
+70 -4
View File
@@ -220,13 +220,17 @@ func Reset(ttlSec uint64) {
}
func ensureSessionTable(url string) error {
_, err := db.Exec(url, fmt.Sprintf(`
create := fmt.Sprintf(`
CREATE TABLE IF NOT EXISTS "%s" (
id TEXT PRIMARY KEY,
expires_at INTEGER NOT NULL,
data TEXT NOT NULL
);
CREATE INDEX IF NOT EXISTS idx_marqdo_sessions_exp ON "%s"(expires_at);`, sessionTable, sessionTable), nil)
)`, sessionTable)
if _, err := db.Exec(url, create, nil); err != nil {
return err
}
idx := fmt.Sprintf(`CREATE INDEX IF NOT EXISTS idx_marqdo_sessions_exp ON "%s"(expires_at)`, sessionTable)
_, err := db.Exec(url, idx, nil)
return err
}
@@ -315,7 +319,7 @@ func saveSQL(url, id string, exp uint64, data map[string]any) error {
}
_, err = db.Exec(url, fmt.Sprintf(`
INSERT INTO "%s" (id, expires_at, data) VALUES (?, ?, ?)
ON CONFLICT(id) DO UPDATE SET expires_at = excluded.expires_at, data = excluded.data`, sessionTable),
ON CONFLICT (id) DO UPDATE SET expires_at = excluded.expires_at, data = excluded.data`, sessionTable),
[]any{id, int64(exp), string(raw)})
return err
}
@@ -612,6 +616,20 @@ func RoleFromCookie(cookieHeader string) string {
return "visitor"
}
// UsernameFromCookie returns the session username or empty string.
func UsernameFromCookie(cookieHeader string) string {
sid, ok := IDFromCookie(cookieHeader)
if !ok {
return ""
}
if v, ok := GetValue(sid, "username"); ok {
if s, ok := v.(string); ok {
return s
}
}
return ""
}
// RoleAllowed reports whether role is in allowed (empty allowed = all).
func RoleAllowed(role string, allowed []string) bool {
if len(allowed) == 0 {
@@ -625,3 +643,51 @@ func RoleAllowed(role string, allowed []string) bool {
}
return false
}
// PermissionsFromCookie returns session permission codes (empty if anonymous).
func PermissionsFromCookie(cookieHeader string) []string {
sid, ok := IDFromCookie(cookieHeader)
if !ok {
return nil
}
return PermissionsFromSession(sid)
}
// PermissionsFromSession reads the permissions CSV from a session id.
func PermissionsFromSession(sid string) []string {
if v, ok := GetValue(sid, "permissions"); ok {
if s, ok := v.(string); ok && s != "" {
return ParseRolesCSV(s)
}
}
return nil
}
// SetPermissions stores permission codes on the session.
func SetPermissions(sid string, codes []string) {
SetValue(sid, "permissions", strings.Join(codes, ","))
}
// PermissionAllowed reports whether the session holds any of needed.
func PermissionAllowed(held, needed []string) bool {
if len(needed) == 0 {
return true
}
set := map[string]struct{}{}
for _, h := range held {
h = strings.ToLower(strings.TrimSpace(h))
if h == "*" {
return true
}
if h != "" {
set[h] = struct{}{}
}
}
for _, n := range needed {
n = strings.ToLower(strings.TrimSpace(n))
if _, ok := set[n]; ok {
return true
}
}
return false
}
+252
View File
@@ -0,0 +1,252 @@
// Package tenant resolves multi-tenant request context for ext/web.
package tenant
import (
"context"
"fmt"
"net/http"
"strings"
)
type ctxKey int
const requestKey ctxKey = 1
// Config is stored on the app bag under key "tenant".
type Config struct {
Mode string // path | subdomain | header
Param string // path capture / query / header name
Column string // DB column (default tenant_id)
DefaultScope bool // auto-scope all selects/inserts when true
}
// FromBag reads tenant config from an app bag.
func FromBag(appBag map[string]any) Config {
cfg := Config{Column: "tenant_id"}
raw, ok := appBag["tenant"].(map[string]any)
if !ok {
return cfg
}
cfg.Mode = strings.ToLower(strings.TrimSpace(str(raw, "mode", "模式")))
cfg.Param = strings.TrimSpace(str(raw, "param", "参数", "tenant_param"))
if c := str(raw, "column", "列", "tenant_column"); c != "" {
cfg.Column = c
}
if v, ok := raw["default_scope"]; ok {
cfg.DefaultScope = boolish(v)
} else if v, ok := raw["默认作用域"]; ok {
cfg.DefaultScope = boolish(v)
} else if v, ok := raw["scope"]; ok {
cfg.DefaultScope = boolish(v)
}
return cfg
}
// Enabled reports whether tenant resolution is configured.
func (c Config) Enabled() bool {
return c.Mode != ""
}
// Configure merges tenant options onto the app bag.
func Configure(appBag map[string]any, opts map[string]any) (map[string]any, error) {
if opts == nil {
opts = map[string]any{}
}
mode := strings.ToLower(strings.TrimSpace(str(opts, "mode", "模式")))
if mode == "" {
return nil, fmt.Errorf("tenant: mode required (path|subdomain|header)")
}
switch mode {
case "path", "路径", "subdomain", "子域", "header", "头":
default:
return nil, fmt.Errorf("tenant: unknown mode %q", mode)
}
if mode == "路径" {
mode = "path"
}
if mode == "子域" {
mode = "subdomain"
}
if mode == "头" {
mode = "header"
}
param := strings.TrimSpace(str(opts, "param", "参数", "tenant_param"))
if param == "" {
switch mode {
case "path":
param = "t"
case "header":
param = "X-Tenant-Id"
case "subdomain":
param = ""
}
}
col := strings.TrimSpace(str(opts, "column", "列", "tenant_column"))
if col == "" {
col = "tenant_id"
}
entry := map[string]any{
"mode": mode,
"param": param,
"column": col,
}
if v, ok := first(opts, "default_scope", "默认作用域", "scope"); ok {
entry["default_scope"] = boolish(v)
}
out := clone(appBag)
out["tenant"] = entry
return out, nil
}
// Resolve extracts tenant id from the HTTP request.
func Resolve(r *http.Request, cfg Config) string {
if !cfg.Enabled() {
return ""
}
switch cfg.Mode {
case "path":
if cfg.Param != "" {
if v := r.PathValue(cfg.Param); v != "" {
return sanitize(v)
}
if v := r.URL.Query().Get(cfg.Param); v != "" {
return sanitize(v)
}
// /t/{tenant}/… when param is t: take segment after /t/
parts := strings.Split(strings.Trim(r.URL.Path, "/"), "/")
if cfg.Param == "t" && len(parts) >= 2 && parts[0] == "t" {
return sanitize(parts[1])
}
for i, p := range parts {
if p == cfg.Param && i+1 < len(parts) {
return sanitize(parts[i+1])
}
}
}
case "subdomain":
host := r.Host
if h, _, ok := strings.Cut(host, ":"); ok {
host = h
}
labels := strings.Split(host, ".")
if len(labels) >= 3 {
return sanitize(labels[0])
}
case "header":
name := cfg.Param
if name == "" {
name = "X-Tenant-Id"
}
return sanitize(r.Header.Get(name))
}
return ""
}
// WithContext stores tenant id on the request context.
func WithContext(ctx context.Context, id string) context.Context {
return context.WithValue(ctx, requestKey, id)
}
// FromContext reads tenant id (empty if unset).
func FromContext(ctx context.Context) string {
if ctx == nil {
return ""
}
if s, ok := ctx.Value(requestKey).(string); ok {
return s
}
return ""
}
// MergeWhere adds tenant_id equality to a where value (map or list of maps).
func MergeWhere(where any, column, tenantID string) any {
if tenantID == "" || column == "" {
return where
}
clause := map[string]any{"字段": column, "field": column, "操作": "=", "op": "=", "值": tenantID, "value": tenantID}
switch t := where.(type) {
case nil:
return []any{clause}
case []any:
out := make([]any, 0, len(t)+1)
out = append(out, t...)
out = append(out, clause)
return out
case map[string]any:
out := cloneMap(t)
out[column] = tenantID
return out
default:
return []any{where, clause}
}
}
// StampRow sets tenant column on an insert/update row map if missing.
func StampRow(row map[string]any, column, tenantID string) map[string]any {
if row == nil || tenantID == "" || column == "" {
return row
}
if _, ok := row[column]; ok {
return row
}
out := cloneMap(row)
out[column] = tenantID
return out
}
func sanitize(s string) string {
s = strings.TrimSpace(strings.ToLower(s))
var b strings.Builder
for _, r := range s {
if (r >= 'a' && r <= 'z') || (r >= '0' && r <= '9') || r == '-' || r == '_' {
b.WriteRune(r)
}
}
return b.String()
}
func str(m map[string]any, keys ...string) string {
for _, k := range keys {
if v, ok := m[k]; ok && v != nil {
if s, ok := v.(string); ok {
return s
}
return fmt.Sprint(v)
}
}
return ""
}
func first(m map[string]any, keys ...string) (any, bool) {
for _, k := range keys {
if v, ok := m[k]; ok && v != nil {
return v, true
}
}
return nil, false
}
func boolish(v any) bool {
switch t := v.(type) {
case bool:
return t
case string:
switch strings.TrimSpace(t) {
case "true", "True", "1", "yes", "on", "真":
return true
}
case float64:
return t != 0
}
return false
}
func clone(m map[string]any) map[string]any {
out := make(map[string]any, len(m))
for k, v := range m {
out[k] = v
}
return out
}
func cloneMap(m map[string]any) map[string]any { return clone(m) }
@@ -0,0 +1,58 @@
package tenant_test
import (
"net/http/httptest"
"testing"
"github.com/marqdo/marqdo/plugins/web/internal/tenant"
)
func TestResolvePathQuery(t *testing.T) {
cfg := tenant.Config{Mode: "path", Param: "t", Column: "tenant_id"}
r := httptest.NewRequest("GET", "/api/items?t=acme", nil)
if got := tenant.Resolve(r, cfg); got != "acme" {
t.Fatalf("got %q", got)
}
}
func TestResolvePathPrefix(t *testing.T) {
cfg := tenant.Config{Mode: "path", Param: "t"}
r := httptest.NewRequest("GET", "/t/beta/items", nil)
if got := tenant.Resolve(r, cfg); got != "beta" {
t.Fatalf("got %q", got)
}
}
func TestResolveHeader(t *testing.T) {
cfg := tenant.Config{Mode: "header", Param: "X-Tenant-Id"}
r := httptest.NewRequest("GET", "/", nil)
r.Header.Set("X-Tenant-Id", "Gamma")
if got := tenant.Resolve(r, cfg); got != "gamma" {
t.Fatalf("got %q", got)
}
}
func TestMergeWhereAndStamp(t *testing.T) {
w := tenant.MergeWhere(nil, "tenant_id", "acme")
arr, ok := w.([]any)
if !ok || len(arr) != 1 {
t.Fatalf("where=%v", w)
}
row := tenant.StampRow(map[string]any{"title": "x"}, "tenant_id", "acme")
if row["tenant_id"] != "acme" {
t.Fatalf("row=%v", row)
}
}
func TestConfigure(t *testing.T) {
out, err := tenant.Configure(map[string]any{}, map[string]any{
"mode": "path", "param": "org", "default_scope": true,
})
if err != nil {
t.Fatal(err)
}
cfg := tenant.FromBag(out)
if cfg.Mode != "path" || cfg.Param != "org" || !cfg.DefaultScope {
t.Fatalf("%+v", cfg)
}
}
+52 -4
View File
@@ -7,13 +7,15 @@ import (
"github.com/marqdo/marqdo/plugins/web/internal/app"
)
// RouteSpec is one ws_routes entry (mode + optional room_key template).
// RouteSpec is one ws_routes entry (mode + optional room_key / on_message / presence).
type RouteSpec struct {
Mode Mode
RoomKey string
Mode Mode
RoomKey string
OnMessage string
Presence bool
}
// RouteWS registers path → {mode, room_key?} on app.ws_routes (Rust web_app_route_ws).
// RouteWS registers path → {mode, room_key?, on_message?, presence?} on app.ws_routes.
func RouteWS(appBag map[string]any, path string, args map[string]any) (map[string]any, error) {
path, err := app.NormalizeRoutePath(path, appBag)
if err != nil {
@@ -24,6 +26,8 @@ func RouteWS(appBag map[string]any, path string, args map[string]any) (map[strin
if mode == ModeRoom && roomKey == "" {
return nil, fmt.Errorf("mode=room requires room_key")
}
onMsg := OnMessageFromArgs(args)
presence := PresenceFromArgs(args)
out := clone(appBag)
wsRoutes := map[string]any{}
if r, ok := out["ws_routes"].(map[string]any); ok {
@@ -33,6 +37,12 @@ func RouteWS(appBag map[string]any, path string, args map[string]any) (map[strin
if roomKey != "" {
spec["room_key"] = roomKey
}
if onMsg != "" {
spec["on_message"] = onMsg
}
if presence {
spec["presence"] = true
}
wsRoutes[path] = spec
out["ws_routes"] = wsRoutes
return out, nil
@@ -46,6 +56,34 @@ func RoomKeyFromArgs(args map[string]any) string {
return ""
}
// OnMessageFromArgs reads on_message / 消息钩子 (lib.member path).
func OnMessageFromArgs(args map[string]any) string {
if v, ok := first(args, "on_message", "消息钩子", "钩子"); ok {
return strings.TrimSpace(fmt.Sprint(v))
}
return ""
}
// PresenceFromArgs reads presence / 在场 flag.
func PresenceFromArgs(args map[string]any) bool {
if v, ok := first(args, "presence", "在场"); ok {
return boolish(v)
}
return false
}
// ExpandTemplate replaces `{name}` tokens using values from PathValue-style map.
func ExpandTemplate(tmpl string, values map[string]string) string {
if tmpl == "" || len(values) == 0 {
return tmpl
}
out := tmpl
for k, v := range values {
out = strings.ReplaceAll(out, "{"+k+"}", v)
}
return out
}
// RoutesOf reads ws_routes from an app bag.
func RoutesOf(appBag map[string]any) map[string]Mode {
out := map[string]Mode{}
@@ -117,6 +155,16 @@ func parseRouteSpec(spec any) RouteSpec {
if rk, ok := t["room_key"]; ok {
out.RoomKey = strings.TrimSpace(fmt.Sprint(rk))
}
if om, ok := t["on_message"]; ok {
out.OnMessage = strings.TrimSpace(fmt.Sprint(om))
} else if om, ok := t["消息钩子"]; ok {
out.OnMessage = strings.TrimSpace(fmt.Sprint(om))
}
if p, ok := t["presence"]; ok {
out.Presence = boolish(p)
} else if p, ok := t["在场"]; ok {
out.Presence = boolish(p)
}
case string:
out.Mode = ParseMode(t)
default:
+27
View File
@@ -113,6 +113,33 @@ func TestRouteWSRoomRequiresKey(t *testing.T) {
}
}
func TestExpandTemplate(t *testing.T) {
got := ws.ExpandTemplate("chat.room.{id}", map[string]string{"id": "lobby"})
if got != "chat.room.lobby" {
t.Fatalf("got %q", got)
}
}
func TestRouteWSOnMessageAndPresence(t *testing.T) {
a := app.New(nil)
out, err := ws.RouteWS(a, "/chat/{id}", map[string]any{
"mode": "room",
"room_key": "chat.room.{id}",
"on_message": "chat.persist",
"presence": true,
})
if err != nil {
t.Fatal(err)
}
spec, err := ws.RouteSpecOf(out, "/chat/{id}")
if err != nil {
t.Fatal(err)
}
if spec.OnMessage != "chat.persist" || !spec.Presence {
t.Fatalf("spec=%+v", spec)
}
}
func TestConnectRefusesBadURL(t *testing.T) {
out := ws.Connect("http://127.0.0.1:1", "hi", nil, 1)
if out["ok"] == true {
+172 -8
View File
@@ -60,6 +60,7 @@ extern int web_page_chrome(char *args_json, char **out_json, char **err_msg);
extern int web_style(char *args_json, char **out_json, char **err_msg);
extern int web_compose_components(char *args_json, char **out_json, char **err_msg);
extern int web_compose_main(char *args_json, char **out_json, char **err_msg);
extern int web_compose_list(char *args_json, char **out_json, char **err_msg);
extern int web_compose_intro(char *args_json, char **out_json, char **err_msg);
extern int web_intro(char *args_json, char **out_json, char **err_msg);
extern int web_render(char *args_json, char **out_json, char **err_msg);
@@ -72,6 +73,10 @@ extern int web_db_exec(char *args_json, char **out_json, char **err_msg);
extern int web_form_new(char *args_json, char **out_json, char **err_msg);
extern int web_form_fields(char *args_json, char **out_json, char **err_msg);
extern int web_compose_form(char *args_json, char **out_json, char **err_msg);
extern int web_compose_auth_form(char *args_json, char **out_json, char **err_msg);
extern int web_compose_nav_brand(char *args_json, char **out_json, char **err_msg);
extern int web_compose_client(char *args_json, char **out_json, char **err_msg);
extern int web_compose_form_load(char *args_json, char **out_json, char **err_msg);
extern int web_app_new(char *args_json, char **out_json, char **err_msg);
extern int web_app_route(char *args_json, char **out_json, char **err_msg);
extern int web_db_update(char *args_json, char **out_json, char **err_msg);
@@ -85,7 +90,8 @@ extern int web_db_migrate(char *args_json, char **out_json, char **err_msg);
extern int web_db_fts_create(char *args_json, char **out_json, char **err_msg);
extern int web_db_search(char *args_json, char **out_json, char **err_msg);
extern int web_db_table_info(char *args_json, char **out_json, char **err_msg);
extern int web_form_rules(char *args_json, char **out_json, char **err_msg);
extern int web_form_rules(char *args_json, char **out_json, char **err_msg);
extern int web_form_labels(char *args_json, char **out_json, char **err_msg);
extern int web_form_validate(char *args_json, char **out_json, char **err_msg);
extern int web_form_render(char *args_json, char **out_json, char **err_msg);
extern int web_form_submit(char *args_json, char **out_json, char **err_msg);
@@ -105,7 +111,17 @@ extern int web_auth_check(char *args_json, char **out_json, char **err_msg);
extern int web_auth_logout(char *args_json, char **out_json, char **err_msg);
extern int web_auth_new(char *args_json, char **out_json, char **err_msg);
extern int web_app_auth(char *args_json, char **out_json, char **err_msg);
extern int web_app_oidc(char *args_json, char **out_json, char **err_msg);
extern int web_app_gate(char *args_json, char **out_json, char **err_msg);
extern int web_app_rbac(char *args_json, char **out_json, char **err_msg);
extern int web_app_tenant(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_can(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_ensure(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_assign_role(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_create_role(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_set_role_permissions(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_list_roles(char *args_json, char **out_json, char **err_msg);
extern int web_rbac_list_permissions(char *args_json, char **out_json, char **err_msg);
extern int web_storage_new(char *args_json, char **out_json, char **err_msg);
extern int web_storage_put(char *args_json, char **out_json, char **err_msg);
extern int web_storage_get(char *args_json, char **out_json, char **err_msg);
@@ -155,9 +171,14 @@ static int register_core(void) {
if (host_register((char *)"web_style", (char *)"name,table,strict", web_style) != 0) return 1;
if (host_register((char *)"web_compose_components", (char *)"page,components", web_compose_components) != 0) return 1;
if (host_register((char *)"web_compose_main", (char *)"page,main", web_compose_main) != 0) return 1;
if (host_register((char *)"web_compose_list", (char *)"page,main,query,order,target", web_compose_list) != 0) return 1;
if (host_register((char *)"web_compose_intro", (char *)"page,intro", web_compose_intro) != 0) return 1;
if (host_register((char *)"web_intro", (char *)"table", web_intro) != 0) return 1;
if (host_register((char *)"web_compose_form", (char *)"page,form,id,target", web_compose_form) != 0) return 1;
if (host_register((char *)"web_compose_auth_form", (char *)"page,action,submit,form_id,err_id,target,next,kind", web_compose_auth_form) != 0) return 1;
if (host_register((char *)"web_compose_nav_brand", (char *)"page,title,href,logo,logo_light,theme_key", web_compose_nav_brand) != 0) return 1;
if (host_register((char *)"web_compose_client", (char *)"page,source,bridge,wasm", web_compose_client) != 0) return 1;
if (host_register((char *)"web_compose_form_load", (char *)"page,table,id_param", web_compose_form_load) != 0) return 1;
if (host_register((char *)"web_render", (char *)"page", web_render) != 0) return 1;
if (host_register((char *)"web_db_new", (char *)"url", web_db_new) != 0) return 1;
if (host_register((char *)"web_db_init", (char *)"url,name,fields", web_db_init) != 0) return 1;
@@ -179,6 +200,7 @@ static int register_core(void) {
if (host_register((char *)"web_form_new", (char *)"table,action,id", web_form_new) != 0) return 1;
if (host_register((char *)"web_form_fields", (char *)"form,fields", web_form_fields) != 0) return 1;
if (host_register((char *)"web_form_rules", (char *)"form,rules", web_form_rules) != 0) return 1;
if (host_register((char *)"web_form_labels", (char *)"form,submit,cancel,cancel_href", web_form_labels) != 0) return 1;
if (host_register((char *)"web_form_validate", (char *)"form,rules,data", web_form_validate) != 0) return 1;
if (host_register((char *)"web_form_render", (char *)"form,id", web_form_render) != 0) return 1;
if (host_register((char *)"web_form_submit", (char *)"form,data,url", web_form_submit) != 0) return 1;
@@ -199,8 +221,18 @@ static int register_core(void) {
if (host_register((char *)"web_auth_check", (char *)"session_id", web_auth_check) != 0) return 1;
if (host_register((char *)"web_auth_logout", (char *)"session_id", web_auth_logout) != 0) return 1;
if (host_register((char *)"web_auth_new", (char *)"users,session_ttl", web_auth_new) != 0) return 1;
if (host_register((char *)"web_app_auth", (char *)"app,users,session_ttl,admin_prefix,login_redirect,logout_redirect,login_path", web_app_auth) != 0) return 1;
if (host_register((char *)"web_app_gate", (char *)"app,path,roles,match,on_deny,exclude", web_app_gate) != 0) return 1;
if (host_register((char *)"web_app_auth", (char *)"app,users,session_ttl,admin_prefix,login_redirect,logout_redirect,login_path,register,register_path,default_role,session_url", web_app_auth) != 0) return 1;
if (host_register((char *)"web_app_oidc", (char *)"app,issuer,client_id,client_secret,redirect_uri,scopes,callback_path,authorize_url,token_url,userinfo_url", web_app_oidc) != 0) return 1;
if (host_register((char *)"web_app_gate", (char *)"app,path,roles,permissions,match,on_deny,exclude", web_app_gate) != 0) return 1;
if (host_register((char *)"web_app_rbac", (char *)"app,catalog,desk", web_app_rbac) != 0) return 1;
if (host_register((char *)"web_app_tenant", (char *)"app,mode,param,column,default_scope", web_app_tenant) != 0) return 1;
if (host_register((char *)"web_rbac_can", (char *)"permissions,needed", web_rbac_can) != 0) return 1;
if (host_register((char *)"web_rbac_ensure", (char *)"url", web_rbac_ensure) != 0) return 1;
if (host_register((char *)"web_rbac_assign_role", (char *)"url,username,role", web_rbac_assign_role) != 0) return 1;
if (host_register((char *)"web_rbac_create_role", (char *)"url,name", web_rbac_create_role) != 0) return 1;
if (host_register((char *)"web_rbac_set_role_permissions", (char *)"url,role,permissions,grantable", web_rbac_set_role_permissions) != 0) return 1;
if (host_register((char *)"web_rbac_list_roles", (char *)"url", web_rbac_list_roles) != 0) return 1;
if (host_register((char *)"web_rbac_list_permissions", (char *)"url", web_rbac_list_permissions) != 0) return 1;
if (host_register((char *)"web_storage_new", (char *)"url", web_storage_new) != 0) return 1;
if (host_register((char *)"web_storage_put", (char *)"url,key,body,path,content_type", web_storage_put) != 0) return 1;
if (host_register((char *)"web_storage_get", (char *)"url,key", web_storage_get) != 0) return 1;
@@ -226,7 +258,7 @@ static int register_core(void) {
if (host_register((char *)"web_app_sitemap", (char *)"app,path,base,table,loc,limit,items", web_app_sitemap) != 0) return 1;
if (host_register((char *)"web_app_robots", (char *)"app,body,sitemap", web_app_robots) != 0) return 1;
if (host_register((char *)"web_sitemap_build", (char *)"base,items", web_sitemap_build) != 0) return 1;
if (host_register((char *)"web_app_route_ws", (char *)"app,path,echo,mode", web_app_route_ws) != 0) return 1;
if (host_register((char *)"web_app_route_ws", (char *)"app,path,echo,mode,room_key,on_message,presence", web_app_route_ws) != 0) return 1;
if (host_register((char *)"web_ws_connect", (char *)"url,message,headers,timeout_sec", web_ws_connect) != 0) return 1;
if (host_register((char *)"web_cache_new", (char *)"url", web_cache_new) != 0) return 1;
if (host_register((char *)"web_cache_get", (char *)"url,key", web_cache_get) != 0) return 1;
@@ -424,12 +456,14 @@ func resolveDbURL(url string) string {
}
func dbURLOf(args map[string]any) (string, error) {
if s, ok := argStr(args, "url", "db_url"); ok && s != "" {
if s, ok := argStr(args, "url", "db_url", "数据库"); ok && s != "" {
return resolveDbURL(s), nil
}
if dbObj, ok := args["db"].(map[string]any); ok {
if s, ok := argStr(dbObj, "url"); ok && s != "" {
return resolveDbURL(s), nil
for _, key := range []string{"url", "db", "数据库"} {
if dbObj, ok := args[key].(map[string]any); ok {
if s, ok := argStr(dbObj, "url"); ok && s != "" {
return resolveDbURL(s), nil
}
}
}
return "", fmt.Errorf("missing db url")
@@ -513,6 +547,30 @@ func web_compose_main(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int
return replyJSON(outJSON, errMsg, out, err)
}
//export web_compose_list
func web_compose_list(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
pageBag := asPageMap(args["page"])
main := args["main"]
if main == nil {
main = args["主体"]
}
if main == nil {
return replyJSON(outJSON, errMsg, nil, fmt.Errorf("missing `main`"))
}
query := args["query"]
if query == nil {
query = args["条件"]
}
order, _ := argStr(args, "order", "排序")
target, _ := argStr(args, "target", "插槽", "表单插槽")
out, err := compose.ComposeList(pageBag, main, query, order, target, callLib)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_compose_intro
func web_compose_intro(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
@@ -772,6 +830,112 @@ func web_compose_form(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int
return replyJSON(outJSON, errMsg, out, err)
}
//export web_compose_auth_form
func web_compose_auth_form(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
pageBag := args["page"]
action, _ := argStr(args, "action")
if action == "" {
action, _ = argStr(args, "动作")
}
submit, _ := argStr(args, "submit")
if submit == "" {
submit, _ = argStr(args, "提交")
}
formID, _ := argStr(args, "form_id")
if formID == "" {
formID, _ = argStr(args, "表单id")
}
errID, _ := argStr(args, "err_id")
if errID == "" {
errID, _ = argStr(args, "错误id")
}
target, _ := argStr(args, "target")
if target == "" {
target, _ = argStr(args, "表单插槽")
}
next, _ := argStr(args, "next")
if next == "" {
next, _ = argStr(args, "回跳")
}
kind, _ := argStr(args, "kind")
if kind == "" {
kind, _ = argStr(args, "种类")
}
out, err := compose.ComposeAuthForm(pageBag, action, submit, formID, errID, target, next, kind)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_compose_nav_brand
func web_compose_nav_brand(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
title, _ := argStr(args, "title")
if title == "" {
title, _ = argStr(args, "标题")
}
href, _ := argStr(args, "href")
if href == "" {
href, _ = argStr(args, "链接")
}
logo, _ := argStr(args, "logo")
if logo == "" {
logo, _ = argStr(args, "标志")
}
logoLight, _ := argStr(args, "logo_light")
if logoLight == "" {
logoLight, _ = argStr(args, "浅色标志")
}
themeKey, _ := argStr(args, "theme_key")
if themeKey == "" {
themeKey, _ = argStr(args, "主题键")
}
out, err := compose.ComposeNavBrand(args["page"], title, href, logo, logoLight, themeKey)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_compose_client
func web_compose_client(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
source, _ := argStr(args, "source")
if source == "" {
source, _ = argStr(args, "源")
}
bridge, _ := argStr(args, "bridge")
if bridge == "" {
bridge, _ = argStr(args, "桥")
}
wasm, _ := argStr(args, "wasm")
out, err := compose.ComposeClient(args["page"], bridge, wasm, source)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_compose_form_load
func web_compose_form_load(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
if err != nil {
return replyJSON(outJSON, errMsg, nil, err)
}
table, _ := argStr(args, "table")
if table == "" {
table, _ = argStr(args, "表")
}
idParam, _ := argStr(args, "id_param")
if idParam == "" {
idParam, _ = argStr(args, "id参数")
}
out, err := compose.ComposeFormLoad(args["page"], table, idParam)
return replyJSON(outJSON, errMsg, out, err)
}
//export web_app_new
func web_app_new(argsJSON *C.char, outJSON **C.char, errMsg **C.char) C.int {
args, err := parseArgs(argsJSON)
+183 -58
View File
@@ -4,10 +4,15 @@
# Example: ./scripts/ppa-build-source.sh noble
#
# Launchpad builders have no network and noble's cargo (1.75) cannot read
# Cargo.lock v4. This script therefore:
# Cargo.lock v4. For a *new* upstream SemVer this script:
# 1) cargo vendor → vendor/
# 2) installs a modern Rust toolchain into third_party/rust (cached)
# 3) packs both into the .orig.tar.xz for offline debuild on Launchpad
#
# For debian-only bumps (same upstream X.Y.Z already in the PPA):
# - Reuse the published marqdo_X.Y.Z.orig.tar.xz (never rewrite it)
# - debuild -S -sd (do not re-upload .orig)
# Override: MARQDO_PPA_FORCE_ORIG=1 rebuilds orig; MARQDO_PPA_ORIG=/path uses that file.
set -euo pipefail
SERIES="${1:-noble}"
@@ -47,20 +52,175 @@ RUST_NAME="rust-${RUST_VER}-${RUST_TRIPLE}"
RUST_CACHE="${MARQDO_PPA_RUST_CACHE:-${HOME}/.cache/marqdo-ppa}"
RUST_TARBALL="${RUST_CACHE}/${RUST_NAME}.tar.gz"
RUST_URL="${MARQDO_PPA_RUST_URL:-https://static.rust-lang.org/dist/${RUST_NAME}.tar.gz}"
PPA_OWNER="${MARQDO_PPA_OWNER:-cflmy}"
PPA_NAME="${MARQDO_PPA_NAME:-marqdo}"
ORIG_NAME="marqdo_${VER}.orig.tar.xz"
FORCE_ORIG="${MARQDO_PPA_FORCE_ORIG:-0}"
resolve_existing_orig() {
local candidate
if [ -n "${MARQDO_PPA_ORIG:-}" ]; then
candidate="${MARQDO_PPA_ORIG}"
if [ ! -f "$candidate" ]; then
echo "error: MARQDO_PPA_ORIG not a file: $candidate" >&2
exit 1
fi
echo "$candidate"
return 0
fi
for candidate in \
"$BUILD_AREA/$ORIG_NAME" \
"$RUST_CACHE/$ORIG_NAME" \
"$HOME/.cache/marqdo-ppa/$ORIG_NAME"
do
if [ -f "$candidate" ]; then
echo "$candidate"
return 0
fi
done
return 1
}
download_published_orig() {
local dest="$1"
local urls=(
"https://ppa.launchpadcontent.net/${PPA_OWNER}/${PPA_NAME}/ubuntu/pool/main/m/marqdo/${ORIG_NAME}"
"https://launchpad.net/~${PPA_OWNER}/+archive/ubuntu/${PPA_NAME}/+files/${ORIG_NAME}"
)
local url
mkdir -p "$(dirname "$dest")"
for url in "${urls[@]}"; do
echo " trying ${url}"
if curl -fL --retry 3 --retry-delay 2 --connect-timeout 30 \
-o "${dest}.partial" "$url"; then
mv "${dest}.partial" "$dest"
return 0
fi
rm -f "${dest}.partial"
done
return 1
}
echo "==> upstream ${VER} → debian ${DEB_VER} (${SERIES})"
rm -rf "$PKG_ROOT"
mkdir -p "$PKG_ROOT" "$BUILD_AREA" "$RUST_CACHE"
# Clean export of sources (no target/, .git)
if command -v git >/dev/null && git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
git archive --format=tar HEAD | tar -x -C "$PKG_ROOT"
else
rsync -a --exclude target --exclude .git --exclude build-area "$ROOT"/ "$PKG_ROOT"/
REUSE_ORIG=0
ORIG_SRC=""
if [ "$FORCE_ORIG" != "1" ]; then
# Prefer the bytes already accepted by Launchpad (rewriting .orig is rejected).
if download_published_orig "$RUST_CACHE/$ORIG_NAME"; then
ORIG_SRC="$RUST_CACHE/$ORIG_NAME"
elif ORIG_SRC="$(resolve_existing_orig)"; then
echo "warning: could not fetch PPA ${ORIG_NAME}; using local ${ORIG_SRC}" >&2
echo "warning: if its sha256 differs from the archive, Launchpad will reject the upload" >&2
fi
if [ -n "$ORIG_SRC" ]; then
REUSE_ORIG=1
fi
fi
# Ensure debian/ from working tree (may be newer than last commit)
rsync -a "$ROOT/debian/" "$PKG_ROOT/debian/"
if [ "$REUSE_ORIG" -eq 1 ]; then
echo "==> reusing published ${ORIG_NAME} (debian-only bump; do not rewrite orig)"
echo " source: ${ORIG_SRC}"
sha256sum "$ORIG_SRC"
cp -f "$ORIG_SRC" "$BUILD_AREA/$ORIG_NAME"
# Unpack orig (top dir is usually ${VER} or marqdo-${VER})
tar -xJf "$BUILD_AREA/$ORIG_NAME" -C "$(dirname "$PKG_ROOT")"
if [ ! -d "$PKG_ROOT" ]; then
# Some tarballs use marqdo-${VER}/
if [ -d "$(dirname "$PKG_ROOT")/marqdo-${VER}" ]; then
mv "$(dirname "$PKG_ROOT")/marqdo-${VER}" "$PKG_ROOT"
else
echo "error: unpack did not create ${PKG_ROOT}" >&2
tar -tJf "$BUILD_AREA/$ORIG_NAME" | head -5 >&2
exit 1
fi
fi
rsync -a "$ROOT/debian/" "$PKG_ROOT/debian/"
else
echo "==> building fresh ${ORIG_NAME} (new upstream or MARQDO_PPA_FORCE_ORIG=1)"
# Clean export of sources (no target/, .git)
if command -v git >/dev/null && git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
git archive --format=tar HEAD | tar -x -C "$PKG_ROOT"
else
rsync -a --exclude target --exclude .git --exclude build-area "$ROOT"/ "$PKG_ROOT"/
fi
rsync -a "$ROOT/debian/" "$PKG_ROOT/debian/"
cd "$PKG_ROOT"
echo "==> cargo vendor (Launchpad offline)"
mkdir -p .cargo
cargo vendor --locked vendor >/tmp/marqdo-cargo-vendor.conf
cat > .cargo/config.toml <<'EOF'
[source.crates-io]
replace-with = "vendored-sources"
[source.vendored-sources]
directory = "vendor"
EOF
# dh_clean removes *.orig; drop those paths from vendor checksums so a
# stray clean (or older rules) cannot break `cargo --offline` on Launchpad.
python3 - <<'PY'
from __future__ import annotations
import json
from pathlib import Path
root = Path("vendor")
if not root.is_dir():
raise SystemExit("vendor/ missing after cargo vendor")
n_files = 0
n_json = 0
for checksum in root.rglob(".cargo-checksum.json"):
data = json.loads(checksum.read_text(encoding="utf-8"))
files = data.get("files") or {}
drop = [name for name in files if name.endswith(".orig") or name.endswith(".rej")]
if not drop:
continue
for name in drop:
del files[name]
path = checksum.parent / name
if path.is_file():
path.unlink()
n_files += 1
checksum.write_text(json.dumps(data, indent=4) + "\n", encoding="utf-8")
n_json += 1
print(f"stripped {n_files} *.orig/*.rej from {n_json} vendor checksums")
PY
echo "==> bundle Rust ${RUST_VER} (${RUST_TRIPLE}) for Launchpad"
if [ ! -f "$RUST_TARBALL" ]; then
echo " downloading ${RUST_URL}"
curl -fL --retry 3 --retry-delay 2 -o "${RUST_TARBALL}.partial" "$RUST_URL"
mv "${RUST_TARBALL}.partial" "$RUST_TARBALL"
else
echo " cache hit ${RUST_TARBALL}"
fi
rm -rf third_party/rust
mkdir -p third_party
RUST_EXTRACT="$(mktemp -d "${TMPDIR:-/tmp}/marqdo-rust.XXXXXX")"
tar -xzf "$RUST_TARBALL" -C "$RUST_EXTRACT"
INSTALL_SH="$(find "$RUST_EXTRACT" -maxdepth 2 -name install.sh | head -1)"
if [ -z "$INSTALL_SH" ]; then
echo "error: install.sh not found in ${RUST_TARBALL}" >&2
exit 1
fi
bash "$INSTALL_SH" \
--prefix="$PKG_ROOT/third_party/rust" \
--without=rust-docs \
--disable-ldconfig
rm -rf "$RUST_EXTRACT"
"$PKG_ROOT/third_party/rust/bin/rustc" --version
"$PKG_ROOT/third_party/rust/bin/cargo" --version
cd "$(dirname "$PKG_ROOT")"
echo "==> packing ${ORIG_NAME} (vendor + third_party/rust)"
rm -f "$BUILD_AREA/$ORIG_NAME"
tar -cJf "$BUILD_AREA/$ORIG_NAME" \
--exclude=debian \
-C "$(dirname "$PKG_ROOT")" "$(basename "$PKG_ROOT")"
fi
cd "$PKG_ROOT"
python3 - <<PY
@@ -79,58 +239,19 @@ p.write_text(text2, encoding="utf-8")
print("changelog:", p.read_text(encoding="utf-8").splitlines()[0])
PY
echo "==> cargo vendor (Launchpad offline)"
mkdir -p .cargo
cargo vendor --locked vendor >/tmp/marqdo-cargo-vendor.conf
cat > .cargo/config.toml <<'EOF'
[source.crates-io]
replace-with = "vendored-sources"
[source.vendored-sources]
directory = "vendor"
EOF
echo "==> bundle Rust ${RUST_VER} (${RUST_TRIPLE}) for Launchpad"
if [ ! -f "$RUST_TARBALL" ]; then
echo " downloading ${RUST_URL}"
curl -fL --retry 3 --retry-delay 2 -o "${RUST_TARBALL}.partial" "$RUST_URL"
mv "${RUST_TARBALL}.partial" "$RUST_TARBALL"
else
echo " cache hit ${RUST_TARBALL}"
fi
rm -rf third_party/rust
mkdir -p third_party
RUST_EXTRACT="$(mktemp -d "${TMPDIR:-/tmp}/marqdo-rust.XXXXXX")"
tar -xzf "$RUST_TARBALL" -C "$RUST_EXTRACT"
# Official dist tarball contains install.sh
INSTALL_SH="$(find "$RUST_EXTRACT" -maxdepth 2 -name install.sh | head -1)"
if [ -z "$INSTALL_SH" ]; then
echo "error: install.sh not found in ${RUST_TARBALL}" >&2
exit 1
fi
# --disable-ldconfig avoids needing root; strip docs to save space
bash "$INSTALL_SH" \
--prefix="$PKG_ROOT/third_party/rust" \
--without=rust-docs \
--disable-ldconfig
rm -rf "$RUST_EXTRACT"
"$PKG_ROOT/third_party/rust/bin/rustc" --version
"$PKG_ROOT/third_party/rust/bin/cargo" --version
# Always rebuild orig (vendor + rust toolchain change every run)
cd "$(dirname "$PKG_ROOT")"
ORIG="marqdo_${VER}.orig.tar.xz"
echo "==> packing ${ORIG} (vendor + third_party/rust)"
rm -f "$BUILD_AREA/$ORIG" "marqdo_${VER}.orig.tar.xz"
tar -cJf "$BUILD_AREA/$ORIG" \
--exclude=debian \
-C "$(dirname "$PKG_ROOT")" "$(basename "$PKG_ROOT")"
ln -sfn "$BUILD_AREA/$ORIG" "marqdo_${VER}.orig.tar.xz"
ls -lh "$BUILD_AREA/$ORIG"
ln -sfn "$BUILD_AREA/$ORIG_NAME" "$(dirname "$PKG_ROOT")/$ORIG_NAME"
ls -lh "$BUILD_AREA/$ORIG_NAME"
cd "$PKG_ROOT"
echo "==> debuild -S (key ${GPG_KEY})"
debuild -S -sa -k"${GPG_KEY}" -d
# -sd: debian-only upload (reuse published orig). -sa: include orig (new upstream).
if [ "$REUSE_ORIG" -eq 1 ]; then
DEBUILD_ORIG_FLAG="-sd"
echo "==> debuild -S ${DEBUILD_ORIG_FLAG} (key ${GPG_KEY}; not re-uploading .orig)"
else
DEBUILD_ORIG_FLAG="-sa"
echo "==> debuild -S ${DEBUILD_ORIG_FLAG} (key ${GPG_KEY}; including new .orig)"
fi
debuild -S ${DEBUILD_ORIG_FLAG} -k"${GPG_KEY}" -d
# debuild writes next to package parent (/tmp/marqdo-ppa/); collect into build-area
mkdir -p "$BUILD_AREA"
@@ -146,6 +267,10 @@ shopt -u nullglob
echo "==> artifacts in $BUILD_AREA:"
ls -la "$BUILD_AREA"/marqdo_"${DEB_VER}"* "$BUILD_AREA"/marqdo_"${VER}".orig.tar.* 2>/dev/null || true
if [ "$REUSE_ORIG" -eq 1 ]; then
echo " sha256 of reused orig (must match PPA):"
sha256sum "$BUILD_AREA/$ORIG_NAME"
fi
CHANGES="$BUILD_AREA/marqdo_${DEB_VER}_source.changes"
if [ -f "$CHANGES" ]; then
echo
+25 -12
View File
@@ -140,18 +140,28 @@ pub fn resolve_import(from_dir: &Path, rel: &str) -> Result<PathBuf> {
"cannot resolve import `{rel}` from {}",
from_dir.display()
);
let user_ext = crate::ext_cli::default_user_ext_dir();
if env::var_os("MARQDO_EXT").is_none() && !user_ext.join("web").join("web.mq.md").is_file()
#[cfg(feature = "cli")]
{
msg.push_str(&format!(
"\nhint: run `marqdo ext add web` (installs under {}), or set MARQDO_EXT",
user_ext.display()
));
} else if env::var_os("MARQDO_EXT").is_none() {
msg.push_str(&format!(
"\nhint: looked under {}; set MARQDO_EXT to override",
user_ext.display()
));
let user_ext = crate::ext_cli::default_user_ext_dir();
if env::var_os("MARQDO_EXT").is_none()
&& !user_ext.join("web").join("web.mq.md").is_file()
{
msg.push_str(&format!(
"\nhint: run `marqdo ext add web` (installs under {}), or set MARQDO_EXT",
user_ext.display()
));
} else if env::var_os("MARQDO_EXT").is_none() {
msg.push_str(&format!(
"\nhint: looked under {}; set MARQDO_EXT to override",
user_ext.display()
));
}
}
#[cfg(not(feature = "cli"))]
{
if env::var_os("MARQDO_EXT").is_none() {
msg.push_str("\nhint: set MARQDO_EXT to your extension pack root");
}
}
bail!("{msg}");
}
@@ -203,7 +213,10 @@ fn ext_search_roots() -> Vec<PathBuf> {
roots.push(PathBuf::from(h));
}
// Default install root from `marqdo ext add` (~/.marqdo/ext)
roots.push(crate::ext_cli::default_user_ext_dir());
#[cfg(feature = "cli")]
{
roots.push(crate::ext_cli::default_user_ext_dir());
}
if let Ok(cwd) = env::current_dir() {
roots.push(cwd.join("ext"));
}
+25
View File
@@ -0,0 +1,25 @@
---
title: web-auth-custom-page
description: Custom branded login owns GET /login; POST failure re-renders same shell with CSRF; no author JS.
import 网页:ext/web/网页.mq.md
---
# main
`用户` =
| 行 | 用户名 | 密码 |
|----|--------|------|
| 1 | alice | secret12 |
**page = > 网页.页面 标题="Home" 引言="<p>home</p>"**
**login = > 网页.页面 标题="登录" 引言="<div class='panel'><h1>登录</h1><div id='auth-mount'></div></div>"**
**login = > login.鉴权表单 动作="/login" 提交="登录" 表单id="login-form" 错误id="login-err" 表单插槽="#auth-mount" 种类="login"**
**db = > 网页.数据库**
**app = > 网页.应用 页面=page 数据库=db 后台=假 主机="127.0.0.1" 端口=0**
**app = > app.路由 路径="/login" 页面=login**
**app = > app.鉴权 用户表=`用户` 会话时长=3600 登录路径="/login" 登录回跳="/"**
> print text=web-auth-custom-page ok
*None*
+26
View File
@@ -0,0 +1,26 @@
---
title: web collab bag smoke
description: route_ws room+presence for collab doc
import web:ext/web/web.mq.md
import json:lib/json.mq.md
import sys:lib/sys.mq.md
---
# main
**首页 = > web.page title="c"**
**应用 = > web.app page=`首页` admin=False**
**应用 = > `应用`.route_ws path="/live/{id}" mode="room" room_key="doc.{id}" presence=True**
**routes = > json.get value=`应用` key="ws_routes"**
**spec = > json.get value=`routes` key="/live/{id}"**
**mode = > json.get value=`spec` key="mode"**
**pr = > json.get value=`spec` key="presence"**
1. `mode` == "room"
1. `pr` == True
> print text=collab-ws-bag-ok
2. *
> print text=presence-fail
> sys.exit code=1
2. *
> print text=mode-fail
> sys.exit code=1
+123
View File
@@ -0,0 +1,123 @@
---
title: web form source live server
description: Request-context field sources — body only; author/slug stamped server-side.
import web:ext/web/web.mq.md
import plugin:lib/plugin.mq.md
import sys:lib/sys.mq.md
---
# main
**p = > plugin.native_path name="web"**
1. `p`
> plugin.load path=`p`
2. *
> sys.exit code=1
`post_schema` =
| 字段 | 类型 | 必填 |
|------|------|------|
| id | integer | false |
| slug | text | true |
| title | text | true |
| content | text | true |
`comment_schema` =
| 字段 | 类型 | 必填 |
|------|------|------|
| id | integer | false |
| post_slug | text | true |
| author | text | true |
| body | text | true |
| created_at | text | false |
**store = > web.db url="sqlite:web-fixtures/data/form-source-live.db"**
> `store`.init name=posts fields=`post_schema`
> `store`.init name=comments fields=`comment_schema`
> `store`.exec sql="DELETE FROM comments"
> `store`.exec sql="DELETE FROM posts"
`seed` =
| slug | title | content |
|------|-------|---------|
| hello | Hello | Body of hello |
> `store`.insert table=posts rows=`seed`
`detail` =
| 属性 | 值 | 样式 |
|------|-----|------|
| title | posts.title | |
| body | posts.content | |
`post_q` =
| 字段 | 操作 | 值 |
|------|------|-----|
| slug | = | {slug} |
`comment_fields` =
| 字段 | 标签 | 类型 | 必填 | 默认 | 来源 |
|------|------|------|------|------|------|
| body | Comment | textarea | true | | client |
| author | | text | true | | session.username |
| post_slug | | text | true | | route.slug |
| created_at | | text | false | | now |
`comment_rules` =
| 字段 | 规则 | 消息 |
|------|------|------|
| body | required | body required |
| author | required | login required |
| post_slug | required | slug required |
**cf = > web.form table="comments" action="insert"**
**cf = > `cf`.fields fields=`comment_fields`**
**cf = > `cf`.rules rules=`comment_rules`**
`comment_cards` =
| 属性 | 值 | 样式 |
|------|-----|------|
| title | comments.author | |
| body | comments.body | |
| meta | comments.created_at | |
`comment_q` =
| 字段 | 操作 | 值 |
|------|------|-----|
| post_slug | = | {slug} |
**post = > web.page title="Post" intro="<section class='post-comments'><h2>Comments</h2><div id='comment-list'></div><div id='comment-form-mount'></div></section>"**
**post = > `post`.compose_main main=`detail`**
**post = > `post`.query query=`post_q`**
**post = > `post`.detail detail=True**
**post = > `post`.compose_list main=`comment_cards` query=`comment_q` order="-created_at" target="#comment-list"**
**post = > `post`.compose_form form=`cf` id="comment" target="#comment-form-mount"**
`users` =
| 行 | 用户 | 密码 |
|----|------|------|
| 1 | alice | secret |
**app = > web.app page=`post` db=`store` port=18117**
**app = > `app`.route path="/post/{slug}" page=`post`**
**app = > `app`.auth users=`users` login_path="/login" login_redirect="/" session_ttl=3600**
**app = > `app`.mount_form id="comment" form=`cf`**
`api` =
| 路径 | 方法 | 表 | 条件 | 排序 | 上限 |
|------|------|----|------|------|------|
| /api/comments | GET | comments | | "-created_at" | 50 |
**app = > `app`.configure json=`api`**
> `app`.listen
+56
View File
@@ -0,0 +1,56 @@
---
title: web RBAC smoke
description: app.rbac flag + gate permissions CSV stored on app bag
import web:ext/web/web.mq.md
import json:lib/json.mq.md
---
# main
> print text=rbac-smoke-start
**首页 = > web.page title="home"**
`用户表` =
| 用户名 | 密码 | 角色 |
|--------|------|------|
| admin | secret | admin |
**应用 = > web.app page=`首页` admin=False**
**应用 = > `应用`.enable_rbac**
**authbag = > json.get value=`应用` key="auth"**
**rbac_on = > json.get value=`authbag` key="rbac"**
1. `rbac_on` == True
> print text=rbac-flag-ok
2. *
> print text=rbac-flag-fail
**应用 = > `应用`.auth users=`用户表` login_path="/login"**
**authbag2 = > json.get value=`应用` key="auth"**
**rbac_kept = > json.get value=`authbag2` key="rbac"**
1. `rbac_kept` == True
> print text=rbac-survives-auth-ok
2. *
> print text=rbac-survives-auth-fail
**应用 = > `应用`.gate path="/desk" permissions="desk:access" match="prefix" on_deny="redirect" exclude="/login"**
**gates = > json.get value=`应用` key="gates"**
**g1 = > at value=`gates` index=1**
**perms = > json.get value=`g1` key="permissions"**
**p0 = > at value=`perms` index=0**
1. `p0` == "desk:access"
> print text=gate-perm-ok
2. *
> print text=gate-perm-fail
**应用2 = > web.app page=`首页` admin=False**
**应用2 = > `应用2`.gate path="/desk/roles" permissions="roles:manage" roles="editor" match="exact"**
**gates2 = > json.get value=`应用2` key="gates"**
**g0 = > at value=`gates2` index=0**
**perms2 = > json.get value=`g0` key="permissions"**
**p1 = > at value=`perms2` index=0**
1. `p1` == "roles:manage"
> print text=gate-roles-manage-ok
2. *
> print text=gate-roles-manage-fail
> print text=rbac-smoke-done
+49
View File
@@ -0,0 +1,49 @@
---
title: web RBAC db register/assign smoke
description: EnsureSchema path via create_role + assign + can
import web:ext/web/web.mq.md
import json:lib/json.mq.md
import sys:lib/sys.mq.md
---
# main
> print text=rbac-db-start
**db = > web.db url="sqlite::memory:"**
**url = > json.get value=`db` key="url"**
**rbac = > web.rbac**
**seed = > `rbac`.create_role url=`db` name="reviewer"**
**ok1 = > json.get value=`seed` key="ok"**
1. `ok1` == True
> print text=create-role-ok
2. *
> print text=create-role-fail
> sys.exit code=1
**setp = > `rbac`.set_role_permissions url=`db` role="reviewer" permissions="comments:create,desk:access"**
**ok2 = > json.get value=`setp` key="ok"**
1. `ok2` == True
> print text=set-perms-ok
2. *
> print text=set-perms-fail
> sys.exit code=1
**can = > `rbac`.can permissions="comments:create,desk:access" needed="desk:access"**
**allowed = > json.get value=`can` key="allowed"**
1. `allowed` == True
> print text=can-ok
2. *
> print text=can-fail
> sys.exit code=1
**deny = > `rbac`.can permissions="comments:create" needed="roles:manage"**
**denied = > json.get value=`deny` key="allowed"**
1. `denied` == False
> print text=can-deny-ok
2. *
> print text=can-deny-fail
> sys.exit code=1
> print text=rbac-db-done
+34
View File
@@ -0,0 +1,34 @@
---
title: browser spa helpers smoke
description: store_set / spa_goto effect bags
import browser:lib/browser.mq.md
import json:lib/json.mq.md
import sys:lib/sys.mq.md
---
# main
**set = > browser.store_set key="k" value="v" scope="memory"**
**op = > json.get value=`set` key="storage"**
**op_name = > json.get value=`op` key="op"**
**scope = > json.get value=`op` key="scope"**
1. `op_name` == "set"
1. `scope` == "memory"
> print text=store-set-ok
2. *
> print text=scope-fail
> sys.exit code=1
2. *
> print text=op-fail
> sys.exit code=1
**nav = > browser.spa_goto url="/item" replace=False**
**n = > json.get value=`nav` key="navigate"**
**url = > json.get value=`n` key="url"**
1. `url` == "/item"
> print text=spa-goto-ok
2. *
> print text=spa-goto-fail
> sys.exit code=1
> print text=spa-helpers-ok
+30
View File
@@ -0,0 +1,30 @@
---
title: web tenant bag smoke
description: app.tenant mode=path stores config
import web:ext/web/web.mq.md
import json:lib/json.mq.md
import sys:lib/sys.mq.md
---
# main
**首页 = > web.page title="t"**
**应用 = > web.app page=`首页` admin=False**
**应用 = > `应用`.tenant mode="path" param="t" column="tenant_id" default_scope=True**
**bag = > json.get value=`应用` key="tenant"**
**mode = > json.get value=`bag` key="mode"**
**param = > json.get value=`bag` key="param"**
**scope = > json.get value=`bag` key="default_scope"**
1. `mode` == "path"
1. `param` == "t"
1. `scope` == True
> print text=tenant-bag-ok
2. *
> print text=scope-fail
> sys.exit code=1
2. *
> print text=param-fail
> sys.exit code=1
2. *
> print text=mode-fail
> sys.exit code=1
+36
View File
@@ -0,0 +1,36 @@
---
title: web WS room + on_message bag smoke
description: route_ws mode=room stores room_key, on_message, presence
import web:ext/web/web.mq.md
import json:lib/json.mq.md
import sys:lib/sys.mq.md
---
# main
**首页 = > web.page title="ws"**
**应用 = > web.app page=`首页` admin=False**
**应用 = > `应用`.route_ws path="/chat/{id}" mode="room" room_key="chat.room.{id}" on_message="chat.persist" presence=True**
**routes = > json.get value=`应用` key="ws_routes"**
**spec = > json.get value=`routes` key="/chat/{id}"**
**mode = > json.get value=`spec` key="mode"**
**rk = > json.get value=`spec` key="room_key"**
**om = > json.get value=`spec` key="on_message"**
**pr = > json.get value=`spec` key="presence"**
1. `mode` == "room"
1. `rk` == "chat.room.{id}"
1. `om` == "chat.persist"
1. `pr` == True
> print text=ws-room-bag-ok
2. *
> print text=presence-fail
> sys.exit code=1
2. *
> print text=on-message-fail
> sys.exit code=1
2. *
> print text=room-key-fail
> sys.exit code=1
2. *
> print text=mode-fail
> sys.exit code=1
+152
View File
@@ -84,6 +84,14 @@ fn ensure_web_plugin_built() {
assert!(lib.is_file(), "missing Go web plugin at {}", lib.display());
// SAFETY: single-threaded Once; children inherit for the rest of the test process.
std::env::set_var("MARQDO_WEB_PLUGIN", &lib);
// Prefer repo `ext/` over a stale `~/.marqdo/ext` so new page methods (e.g. compose_list)
// are visible without requiring `marqdo ext add web` before gold.
if std::env::var_os("MARQDO_EXT").is_none() {
let ext = root.join("ext");
if ext.join("web").join("web.mq.md").is_file() {
std::env::set_var("MARQDO_EXT", &ext);
}
}
});
}
@@ -1784,6 +1792,150 @@ slot-ok",
);
}
#[test]
fn ext_web_form_source_live() {
// Field sources: only body is client-editable; author/slug stamped from session/route.
ensure_web_plugin_built();
let script = "tests/ext/web-form-source-live-server.mq.md";
let bin = env!("CARGO_BIN_EXE_marqdo");
let mut child = Command::new(bin)
.args(["run", script])
.current_dir(env!("CARGO_MANIFEST_DIR"))
.stdout(Stdio::piped())
.stderr(Stdio::piped())
.spawn()
.expect("spawn form-source live server");
let base = "http://127.0.0.1:18117";
let ready = std::time::Instant::now();
loop {
if ready.elapsed().as_secs() > 15 {
let _ = child.kill();
panic!("form-source live server did not start in time");
}
let out = Command::new("curl")
.args([
"-s",
"-o",
"/dev/null",
"-w",
"%{http_code}",
&format!("{base}/post/hello"),
])
.output()
.expect("curl probe");
if String::from_utf8_lossy(&out.stdout) == "200" {
break;
}
std::thread::sleep(std::time::Duration::from_millis(300));
}
let page = Command::new("curl")
.args(["-s", &format!("{base}/post/hello")])
.output()
.expect("curl post page");
let html = String::from_utf8_lossy(&page.stdout);
assert!(
html.contains(r#"name="body""#),
"body field missing: {html}"
);
assert!(
!html.contains(r#"name="author""#),
"author must not render (server-only): {html}"
);
assert!(
!html.contains(r#"name="post_slug""#),
"post_slug must not render (server-only): {html}"
);
assert!(
html.contains("_mq_params") && html.contains("hello"),
"expected _mq_params with slug: {html}"
);
let jar = std::env::temp_dir().join("marqdo-form-source-cookies.txt");
let _ = std::fs::remove_file(&jar);
let login = Command::new("curl")
.args([
"-s",
"-c",
jar.to_str().unwrap(),
"-b",
jar.to_str().unwrap(),
"-o",
"/dev/null",
"-w",
"%{http_code}",
"-X",
"POST",
&format!("{base}/login"),
"-d",
"username=alice&password=secret",
])
.output()
.expect("curl login");
let login_code = String::from_utf8_lossy(&login.stdout);
assert!(
login_code == "303" || login_code == "302" || login_code == "200",
"login http_code={login_code}"
);
let post = Command::new("curl")
.args([
"-s",
"-c",
jar.to_str().unwrap(),
"-b",
jar.to_str().unwrap(),
"-o",
"/dev/null",
"-w",
"%{http_code}",
"-X",
"POST",
&format!("{base}/_form/comment"),
"--data-urlencode",
"body=gold comment",
"--data-urlencode",
"author=forged-attacker",
"--data-urlencode",
"post_slug=evil-slug",
"--data-urlencode",
r#"_mq_params={"slug":"hello"}"#,
"--data-urlencode",
"_mq_return=/post/hello",
])
.output()
.expect("curl form post");
let post_code = String::from_utf8_lossy(&post.stdout);
assert!(
post_code == "303" || post_code == "302",
"form post http_code={post_code}"
);
let api = Command::new("curl")
.args(["-s", &format!("{base}/api/comments")])
.output()
.expect("curl comments api");
let body = String::from_utf8_lossy(&api.stdout);
assert!(
body.contains("\"author\":\"alice\"") && body.contains("gold comment"),
"author must be session user, not forged: {body}"
);
assert!(
body.contains("\"post_slug\":\"hello\""),
"post_slug must be route param, not forged: {body}"
);
assert!(
!body.contains("forged-attacker") && !body.contains("evil-slug"),
"forged values must not persist: {body}"
);
let _ = child.kill();
let _ = child.wait();
let _ = std::fs::remove_file(&jar);
}
#[test]
fn ext_web_part_smoke() {
ensure_web_plugin_built();