@yss123/cage-client 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shunshunyue and Cage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @yss123/cage-client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+笼子前端 SDK 运行时：请求、错误码、can()、查询 hooks
+
+Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+
+## 使用
+
+```powershell
+pnpm add @yss123/cage-client
+```
+
+首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 Node.js 24 或更新版本。
+
+- [完整使用说明](https://github.com/shunshunyue/cage/blob/main/docs/使用说明.md)
+- [框架源码与范例](https://github.com/shunshunyue/cage)
+- [问题反馈](https://github.com/shunshunyue/cage/issues)
+
+许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+import { type QueryKey, type UseQueryOptions } from '@tanstack/react-query';
+import type { z } from 'zod';
+/** 所有接口都可能返回的通用错误码 */
+export type CommonError = 'UNAUTHENTICATED' | 'FORBIDDEN' | 'INVALID_INPUT' | 'RATE_LIMITED' | 'INTERNAL' | 'NETWORK';
+export type CageResult<T, E extends string = never> = {
+    ok: true;
+    data: T;
+    code?: undefined;
+} | {
+    ok: false;
+    code: E | CommonError;
+    domainCode?: string;
+    detail?: unknown;
+    status: number;
+    requestId?: string;
+    data?: undefined;
+};
+export interface ClientOptions {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    /** 会话失效时调用（例如跳转登录页） */
+    onUnauthenticated?: () => void;
+}
+export declare class CageClient {
+    private readonly opts;
+    private csrfToken;
+    constructor(opts?: ClientOptions);
+    private get f();
+    private url;
+    csrf(refresh?: boolean): Promise<string>;
+    private handle;
+    /** 写请求：自动附带幂等键和 CSRF 令牌。返回值和错误码都有类型。 */
+    post<T, E extends string = never>(path: string, body?: unknown, o?: {
+        idempotencyKey?: string;
+    }): Promise<CageResult<T, E>>;
+    get<T>(path: string, query?: Record<string, unknown>): Promise<CageResult<T, 'NOT_FOUND'>>;
+    login(username: string, password: string): Promise<CageResult<{
+        ok: true;
+    }, never>>;
+    logout(): Promise<CageResult<unknown, never>>;
+}
+/** 默认实例 */
+export declare const client: CageClient;
+export declare function configureClient(opts: ClientOptions): CageClient;
+export declare function setCapabilities(list: string[]): void;
+/** 登录后调用一次（client.login 已自动调用） */
+export declare function loadMe(c?: CageClient): Promise<CageResult<{
+    user: any;
+    capabilities: string[];
+}, "NOT_FOUND">>;
+export declare const currentUser: () => {
+    id: string;
+    username: string;
+    name: string;
+    deptId: string;
+} | null;
+/** 当前用户有没有某个能力点（只用于界面显示） */
+export declare function can(capability: string): boolean;
+/** React：能力变化时自动重新渲染 */
+export declare function useCan(capability: string): boolean;
+export declare class CageQueryError extends Error {
+    readonly result: Extract<CageResult<unknown, string>, {
+        ok: false;
+    }>;
+    constructor(result: Extract<CageResult<unknown, string>, {
+        ok: false;
+    }>);
+}
+export interface Page<T> {
+    items: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/** 详情或任意 GET：响应用 schema 校验 */
+export declare function useCageQuery<T>(key: QueryKey, path: string, schema?: z.ZodType<T>, options?: Omit<UseQueryOptions<T>, 'queryKey' | 'queryFn'> & {
+    query?: Record<string, unknown>;
+}): import("@tanstack/react-query").UseQueryResult<T, Error>;
+/** 列表：分页、排序、过滤参数统一 */
+export declare function useCageList<T>(key: QueryKey, path: string, params?: Record<string, unknown>, itemSchema?: z.ZodType<T>): import("@tanstack/react-query").UseQueryResult<Page<T>, Error>;
+/** 命令：成功后让相关查询失效 */
+export declare function useCageCommand<A extends unknown[], T, E extends string>(fn: (...args: A) => Promise<CageResult<T, E>>, invalidate?: QueryKey[]): import("@tanstack/react-query").UseMutationResult<CageResult<T, E>, Error, A, unknown>;

package/dist/index.js

@@ -0,0 +1,184 @@
+// @yss123/cage-client：前端 SDK 运行时。生成的 contracts 包在它上面：请求、错误码、can()、查询 hooks。
+// can() 只影响按钮显示；就算有人绕过前端直接调接口，内核第 3 关一样会拒绝。
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useSyncExternalStore } from 'react';
+function uuid() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {
+        const r = (Math.random() * 16) | 0;
+        return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);
+    });
+}
+export class CageClient {
+    opts;
+    csrfToken = null;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    get f() {
+        return this.opts.fetch ?? ((...a) => fetch(...a));
+    }
+    url(path, query) {
+        const base = this.opts.baseUrl ?? '';
+        const qs = query
+            ? Object.entries(query)
+                .filter(([, v]) => v !== undefined && v !== null && v !== '')
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+                .join('&')
+            : '';
+        return `${base}${path}${qs ? `?${qs}` : ''}`;
+    }
+    async csrf(refresh = false) {
+        if (this.csrfToken && !refresh)
+            return this.csrfToken;
+        const r = await this.f(this.url('/auth/csrf'), { credentials: 'include' });
+        this.csrfToken = (await r.json()).token;
+        return this.csrfToken;
+    }
+    async handle(res) {
+        const text = await res.text();
+        let body = null;
+        try {
+            body = text ? JSON.parse(text) : null;
+        }
+        catch {
+            body = text;
+        }
+        if (res.ok)
+            return { ok: true, data: body };
+        if (res.status === 401)
+            this.opts.onUnauthenticated?.();
+        return { ok: false, code: body?.code ?? 'INTERNAL', domainCode: body?.domainCode, detail: body?.detail, status: res.status, requestId: body?.requestId };
+    }
+    /** 写请求：自动附带幂等键和 CSRF 令牌。返回值和错误码都有类型。 */
+    async post(path, body = {}, o = {}) {
+        const key = o.idempotencyKey ?? uuid();
+        for (let attempt = 0; attempt < 2; attempt++) {
+            try {
+                const res = await this.f(this.url(path), {
+                    method: 'POST',
+                    credentials: 'include',
+                    headers: { 'content-type': 'application/json', 'idempotency-key': key, 'x-csrf-token': await this.csrf(attempt > 0) },
+                    body: JSON.stringify(body ?? {}),
+                });
+                const r = await this.handle(res);
+                // CSRF 令牌过期：刷新后用同一个幂等键重试一次
+                if (!r.ok && r.status === 403 && r.detail === 'CSRF' && attempt === 0)
+                    continue;
+                return r;
+            }
+            catch {
+                if (attempt === 1)
+                    return { ok: false, code: 'NETWORK', status: 0 };
+            }
+        }
+        return { ok: false, code: 'NETWORK', status: 0 };
+    }
+    async get(path, query) {
+        try {
+            const res = await this.f(this.url(path, query), { credentials: 'include' });
+            return this.handle(res);
+        }
+        catch {
+            return { ok: false, code: 'NETWORK', status: 0 };
+        }
+    }
+    async login(username, password) {
+        const r = await this.post('/auth/login', { username, password });
+        if (r.ok) {
+            this.csrfToken = null;
+            await loadMe(this);
+        }
+        return r;
+    }
+    async logout() {
+        const r = await this.post('/auth/logout');
+        setCapabilities([]);
+        this.csrfToken = null;
+        return r;
+    }
+}
+/** 默认实例 */
+export const client = new CageClient();
+export function configureClient(opts) {
+    Object.assign(client, new CageClient(opts));
+    return client;
+}
+// ---------------- 能力判断 ----------------
+let caps = new Set();
+let me = null;
+const listeners = new Set();
+export function setCapabilities(list) {
+    caps = new Set(list);
+    for (const l of listeners)
+        l();
+}
+/** 登录后调用一次（client.login 已自动调用） */
+export async function loadMe(c = client) {
+    const r = await c.get('/api/me');
+    me = r.ok ? r.data : null;
+    setCapabilities(r.ok ? r.data.capabilities : []);
+    return r;
+}
+export const currentUser = () => me?.user ?? null;
+/** 当前用户有没有某个能力点（只用于界面显示） */
+export function can(capability) {
+    return caps.has(capability);
+}
+/** React：能力变化时自动重新渲染 */
+export function useCan(capability) {
+    return useSyncExternalStore((cb) => {
+        listeners.add(cb);
+        return () => listeners.delete(cb);
+    }, () => caps.has(capability), () => false);
+}
+// ---------------- 查询 hooks（TanStack Query） ----------------
+export class CageQueryError extends Error {
+    result;
+    constructor(result) {
+        super(result.code);
+        this.result = result;
+        this.name = 'CageQueryError';
+    }
+}
+/** 详情或任意 GET：响应用 schema 校验 */
+export function useCageQuery(key, path, schema, options = {}) {
+    const { query, ...rest } = options;
+    return useQuery({
+        queryKey: query ? [...key, query] : key,
+        queryFn: async () => {
+            const r = await client.get(path, query);
+            if (!r.ok)
+                throw new CageQueryError(r);
+            return schema ? schema.parse(r.data) : r.data;
+        },
+        ...rest,
+    });
+}
+/** 列表：分页、排序、过滤参数统一 */
+export function useCageList(key, path, params = {}, itemSchema) {
+    return useQuery({
+        queryKey: [...key, params],
+        queryFn: async () => {
+            const r = await client.get(path, params);
+            if (!r.ok)
+                throw new CageQueryError(r);
+            return itemSchema ? { ...r.data, items: r.data.items.map((i) => itemSchema.parse(i)) } : r.data;
+        },
+    });
+}
+/** 命令：成功后让相关查询失效 */
+export function useCageCommand(fn, invalidate = []) {
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: async (args) => fn(...args),
+        onSuccess: (r) => {
+            if (r.ok)
+                for (const k of invalidate)
+                    void qc.invalidateQueries({ queryKey: k });
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@yss123/cage-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "笼子前端 SDK 运行时：请求、错误码、can()、查询 hooks",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "react": ">=18",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.85.5",
+    "@types/react": "^19.1.12",
+    "react": "^19.1.1",
+    "zod": "^4.1.5"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shunshunyue/cage.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://github.com/shunshunyue/cage#readme",
+  "bugs": {
+    "url": "https://github.com/shunshunyue/cage/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }