@dofe/infra-contracts-base 0.1.42

package/dist/base.d.ts

@@ -0,0 +1,243 @@
+import { z } from 'zod';
+import { AppRouter } from '@ts-rest/core';
+/**
+ * Base API Response Schema
+ * Matches the existing { code, msg, data } format used in the backend
+ */
+export declare const HTTP_CODE: {
+    readonly SUCCESS: 0;
+    readonly ERROR: -1;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly VALIDATION_ERROR: 422;
+};
+/**
+ * Empty query schema for GET endpoints without query parameters
+ * Used by ts-rest to validate that no unexpected query params are passed
+ */
+export declare const EmptyQuerySchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * API 版本号常量（从 @repo/constants 复制，避免循环依赖）
+ */
+export declare const API_VERSION: {
+    readonly V1: "1";
+    readonly V2: "2";
+};
+export type ApiVersion = (typeof API_VERSION)[keyof typeof API_VERSION];
+export declare const API_VERSION_HEADER: "x-api-version";
+export declare const API_VERSION_DEFAULT: "1";
+/**
+ * Contract 元数据 Symbol
+ * 用于在 contract 上附加版本信息
+ */
+export declare const CONTRACT_METADATA: unique symbol;
+/**
+ * Contract 元数据接口
+ */
+export interface ContractMetadata {
+    /** API 版本号 */
+    version: ApiVersion;
+    /** 路由前缀 */
+    pathPrefix: string;
+}
+/**
+ * 带版本元数据的 Contract 类型
+ */
+export type VersionedContract<T extends AppRouter> = T & {
+    [CONTRACT_METADATA]: ContractMetadata;
+};
+/**
+ * 创建带版本的 Contract
+ *
+ * @param contract - ts-rest contract router
+ * @param metadata - 版本和路径元数据
+ * @returns 带元数据的 contract
+ *
+ * @example
+ * ```typescript
+ * const c = initContract();
+ * export const signContract = withVersion(
+ *   c.router({ ... }, { pathPrefix: '/sign' }),
+ *   { version: API_VERSION.V1, pathPrefix: '/sign' }
+ * );
+ *
+ * // 读取版本
+ * const version = getContractVersion(signContract); // '1'
+ * ```
+ */
+export declare function withVersion<T extends AppRouter>(contract: T, metadata: ContractMetadata): VersionedContract<T>;
+/**
+ * 从 Contract 获取版本号
+ *
+ * @param contract - ts-rest contract
+ * @returns 版本号，如果未设置则返回默认版本
+ */
+export declare function getContractVersion(contract: unknown): ApiVersion;
+/**
+ * 从 Contract 获取完整元数据
+ *
+ * @param contract - ts-rest contract
+ * @returns 元数据对象，如果未设置则返回 undefined
+ */
+export declare function getContractMetadata(contract: unknown): ContractMetadata | undefined;
+/**
+ * 检查 Contract 是否有版本元数据
+ */
+export declare function hasContractVersion(contract: unknown): boolean;
+export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    code: z.ZodNumber;
+    msg: z.ZodString;
+    data: T;
+}, z.core.$strip>;
+export declare const RestResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    rest: z.ZodBoolean;
+    data: T;
+}, z.core.$strip>;
+/**
+ * Helper function to create API response schema
+ * Wraps any data schema in the standard { code, msg, data } format
+ * Alias for ApiResponseSchema for more intuitive usage in contracts
+ *
+ * 配合 response.helper.ts 中的 success(), created(), deleted() 等函数使用
+ */
+export declare const createApiResponse: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    code: z.ZodNumber;
+    msg: z.ZodString;
+    data: T;
+}, z.core.$strip>;
+export type ApiResponse<T> = {
+    code: number;
+    msg: string;
+    data: T;
+};
+export declare const PaginationQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    sort: z.ZodOptional<z.ZodString>;
+    asc: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strip>;
+export type PaginationQuery = z.infer<typeof PaginationQuerySchema>;
+/**
+ * Base paginated response schema with generic item type
+ * Returns { list, total, page, limit } for all list endpoints
+ *
+ * @template T - The Zod schema for list items
+ * @example
+ * const UserListResponseSchema = PaginatedResponseSchema(UserSchema);
+ * // Results in: { list: User[], total: number, page: number, limit: number }
+ */
+export declare const PaginatedResponseSchema: <T extends z.ZodTypeAny>(itemSchema: T) => z.ZodObject<{
+    list: z.ZodArray<T>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Extended paginated response schema with optional metadata fields
+ * Includes additional fields like totalSize, permission, role, nowTime
+ * 用于替代 DoFeApp.PageResponseData，保持 zod-first 的设计
+ *
+ * @template T - The Zod schema for list items
+ * @example
+ * const SpaceListResponseSchema = ExtendedPaginatedResponseSchema(SpaceSchema);
+ * // Results in: { list: Space[], total: number, page: number, limit: number, totalSize?: number, ... }
+ */
+export declare const ExtendedPaginatedResponseSchema: <T extends z.ZodTypeAny>(itemSchema: T) => z.ZodObject<{
+    list: z.ZodArray<T>;
+    total: z.ZodNumber;
+    page: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    totalSize: z.ZodOptional<z.ZodNumber>;
+    permission: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    role: z.ZodOptional<z.ZodString>;
+    nowTime: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+}, z.core.$strip>;
+/**
+ * Generic paginated response type
+ * Use this for type-safe paginated API responses
+ *
+ * @template T - The type of items in the list
+ */
+export type PaginatedResponse<T> = {
+    list: T[];
+    total: number;
+    page: number;
+    limit: number;
+};
+/**
+ * Extended paginated response type with optional metadata
+ * 用于替代 DoFeApp.PageResponseData，提供更丰富的分页信息
+ *
+ * @template T - The type of items in the list
+ */
+export type ExtendedPaginatedResponse<T> = {
+    list: T[];
+    total: number;
+    page?: number;
+    limit?: number;
+    /** 总大小（字节），用于文件列表 */
+    totalSize?: number;
+    /** 权限列表 */
+    permission?: string[];
+    /** 角色标识 */
+    role?: string;
+    /** 服务器当前时间 */
+    nowTime?: Date;
+};
+export declare const IdSchema: z.ZodString;
+export declare const SuccessResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export type SuccessResponse = z.infer<typeof SuccessResponseSchema>;
+export declare const ErrorResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    msg: z.ZodString;
+    data: z.ZodOptional<z.ZodNull>;
+}, z.core.$strip>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+export declare const EnhancedErrorResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    msg: z.ZodString;
+    data: z.ZodNull;
+    error: z.ZodOptional<z.ZodObject<{
+        errorCode: z.ZodNumber;
+        errorType: z.ZodString;
+        errorData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EnhancedErrorResponse = z.infer<typeof EnhancedErrorResponseSchema>;
+export declare function createApiContract<TBody extends z.ZodTypeAny | undefined, TQuery extends z.ZodTypeAny | undefined, TParams extends z.ZodTypeAny | undefined, TResponse extends z.ZodTypeAny>(config: {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    summary?: string;
+    body?: TBody;
+    query?: TQuery;
+    pathParams?: TParams;
+    responses: {
+        200: TResponse;
+        401?: z.ZodTypeAny;
+        403?: z.ZodTypeAny;
+        404?: z.ZodTypeAny;
+        422?: z.ZodTypeAny;
+    };
+}): {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    summary?: string;
+    body?: TBody;
+    query?: TQuery;
+    pathParams?: TParams;
+    responses: {
+        200: TResponse;
+        401?: z.ZodTypeAny;
+        403?: z.ZodTypeAny;
+        404?: z.ZodTypeAny;
+        422?: z.ZodTypeAny;
+    };
+};
+export { z };
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

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

package/dist/base.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = exports.EnhancedErrorResponseSchema = exports.ErrorResponseSchema = exports.SuccessResponseSchema = exports.IdSchema = exports.ExtendedPaginatedResponseSchema = exports.PaginatedResponseSchema = exports.PaginationQuerySchema = exports.createApiResponse = exports.RestResponseSchema = exports.ApiResponseSchema = exports.CONTRACT_METADATA = exports.API_VERSION_DEFAULT = exports.API_VERSION_HEADER = exports.API_VERSION = exports.EmptyQuerySchema = exports.HTTP_CODE = void 0;
+exports.withVersion = withVersion;
+exports.getContractVersion = getContractVersion;
+exports.getContractMetadata = getContractMetadata;
+exports.hasContractVersion = hasContractVersion;
+exports.createApiContract = createApiContract;
+const zod_1 = require("zod");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
+/**
+ * Base API Response Schema
+ * Matches the existing { code, msg, data } format used in the backend
+ */
+// HTTP status codes used in the API
+exports.HTTP_CODE = {
+    SUCCESS: 0,
+    ERROR: -1,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    VALIDATION_ERROR: 422,
+};
+// ============================================================================
+// Empty Query Schema - Shared Schema for Endpoints Without Query Parameters
+// ============================================================================
+/**
+ * Empty query schema for GET endpoints without query parameters
+ * Used by ts-rest to validate that no unexpected query params are passed
+ */
+exports.EmptyQuerySchema = zod_1.z.object({});
+// ============================================================================
+// API Versioning - Contract Metadata
+// ============================================================================
+/**
+ * API 版本号常量（从 @repo/constants 复制，避免循环依赖）
+ */
+exports.API_VERSION = {
+    V1: '1',
+    V2: '2',
+};
+exports.API_VERSION_HEADER = 'x-api-version';
+exports.API_VERSION_DEFAULT = exports.API_VERSION.V1;
+/**
+ * Contract 元数据 Symbol
+ * 用于在 contract 上附加版本信息
+ */
+exports.CONTRACT_METADATA = Symbol('CONTRACT_METADATA');
+/**
+ * 创建带版本的 Contract
+ *
+ * @param contract - ts-rest contract router
+ * @param metadata - 版本和路径元数据
+ * @returns 带元数据的 contract
+ *
+ * @example
+ * ```typescript
+ * const c = initContract();
+ * export const signContract = withVersion(
+ *   c.router({ ... }, { pathPrefix: '/sign' }),
+ *   { version: API_VERSION.V1, pathPrefix: '/sign' }
+ * );
+ *
+ * // 读取版本
+ * const version = getContractVersion(signContract); // '1'
+ * ```
+ */
+function withVersion(contract, metadata) {
+    const versionedContract = contract;
+    versionedContract[exports.CONTRACT_METADATA] = metadata;
+    return versionedContract;
+}
+/**
+ * 从 Contract 获取版本号
+ *
+ * @param contract - ts-rest contract
+ * @returns 版本号，如果未设置则返回默认版本
+ */
+function getContractVersion(contract) {
+    if (contract &&
+        typeof contract === 'object' &&
+        exports.CONTRACT_METADATA in contract) {
+        return contract[exports.CONTRACT_METADATA]
+            .version;
+    }
+    return exports.API_VERSION_DEFAULT;
+}
+/**
+ * 从 Contract 获取完整元数据
+ *
+ * @param contract - ts-rest contract
+ * @returns 元数据对象，如果未设置则返回 undefined
+ */
+function getContractMetadata(contract) {
+    if (contract &&
+        typeof contract === 'object' &&
+        exports.CONTRACT_METADATA in contract) {
+        return contract[exports.CONTRACT_METADATA];
+    }
+    return undefined;
+}
+/**
+ * 检查 Contract 是否有版本元数据
+ */
+function hasContractVersion(contract) {
+    return (contract !== null &&
+        typeof contract === 'object' &&
+        exports.CONTRACT_METADATA in contract);
+}
+// Base response wrapper schema
+const ApiResponseSchema = (dataSchema) => zod_1.z.object({
+    code: zod_1.z.number(),
+    msg: zod_1.z.string(),
+    data: dataSchema,
+});
+exports.ApiResponseSchema = ApiResponseSchema;
+// Alternative response wrapper schema with rest: true format (used in rbac-api)
+const RestResponseSchema = (dataSchema) => zod_1.z.object({
+    rest: zod_1.z.boolean(),
+    data: dataSchema,
+});
+exports.RestResponseSchema = RestResponseSchema;
+/**
+ * Helper function to create API response schema
+ * Wraps any data schema in the standard { code, msg, data } format
+ * Alias for ApiResponseSchema for more intuitive usage in contracts
+ *
+ * 配合 response.helper.ts 中的 success(), created(), deleted() 等函数使用
+ */
+exports.createApiResponse = exports.ApiResponseSchema;
+// Pagination query schema (matches PaginationQueryDto)
+// Note: 'sort' enum values are project-specific, extend in each project if needed
+exports.PaginationQuerySchema = zod_1.z.object({
+    limit: zod_1.z.coerce.number().positive().optional().default(20),
+    page: zod_1.z.coerce.number().positive().min(1).optional().default(1),
+    sort: zod_1.z.string().optional(), // Generic string, projects can refine with .enum([...])
+    asc: zod_1.z.enum(['asc', 'desc']).optional(),
+});
+/**
+ * Base paginated response schema with generic item type
+ * Returns { list, total, page, limit } for all list endpoints
+ *
+ * @template T - The Zod schema for list items
+ * @example
+ * const UserListResponseSchema = PaginatedResponseSchema(UserSchema);
+ * // Results in: { list: User[], total: number, page: number, limit: number }
+ */
+const PaginatedResponseSchema = (itemSchema) => zod_1.z.object({
+    list: zod_1.z.array(itemSchema),
+    total: zod_1.z.number(),
+    page: zod_1.z.number(),
+    limit: zod_1.z.number(),
+});
+exports.PaginatedResponseSchema = PaginatedResponseSchema;
+/**
+ * Extended paginated response schema with optional metadata fields
+ * Includes additional fields like totalSize, permission, role, nowTime
+ * 用于替代 DoFeApp.PageResponseData，保持 zod-first 的设计
+ *
+ * @template T - The Zod schema for list items
+ * @example
+ * const SpaceListResponseSchema = ExtendedPaginatedResponseSchema(SpaceSchema);
+ * // Results in: { list: Space[], total: number, page: number, limit: number, totalSize?: number, ... }
+ */
+const ExtendedPaginatedResponseSchema = (itemSchema) => zod_1.z.object({
+    list: zod_1.z.array(itemSchema),
+    total: zod_1.z.number(),
+    page: zod_1.z.number().optional(),
+    limit: zod_1.z.number().optional(),
+    /** 总大小（字节），用于文件列表 */
+    totalSize: zod_1.z.number().optional(),
+    /** 权限列表 */
+    permission: zod_1.z.array(zod_1.z.string()).optional(),
+    /** 角色标识 */
+    role: zod_1.z.string().optional(),
+    /** 服务器当前时间 */
+    nowTime: zod_1.z.coerce.date().optional(),
+});
+exports.ExtendedPaginatedResponseSchema = ExtendedPaginatedResponseSchema;
+// Common ID schema (UUID string)
+exports.IdSchema = zod_1.z.string().uuid();
+// Common success response
+exports.SuccessResponseSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+});
+// Error response schema (basic)
+exports.ErrorResponseSchema = zod_1.z.object({
+    code: zod_1.z.number(),
+    msg: zod_1.z.string(),
+    data: zod_1.z.null().optional(),
+});
+// Enhanced error response with error details
+exports.EnhancedErrorResponseSchema = zod_1.z.object({
+    code: zod_1.z.number(),
+    msg: zod_1.z.string(),
+    data: zod_1.z.null(),
+    error: zod_1.z
+        .object({
+        errorCode: zod_1.z.number(),
+        errorType: zod_1.z.string(),
+        errorData: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    })
+        .optional(),
+});
+// Helper function to create API response schema with common responses
+function createApiContract(config) {
+    return config;
+}
+//# sourceMappingURL=base.js.map

package/dist/base.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/contracts-base/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/contracts-base/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dofe/infra-contracts-base",
+  "version": "0.1.42",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./base": {
+      "types": "./dist/base.d.ts",
+      "default": "./dist/base.js"
+    }
+  },
+  "peerDependencies": {
+    "@ts-rest/core": "3.53.0-rc.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@ts-rest/core": "3.53.0-rc.1",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3",
+    "zod": "^4.4.3"
+  },
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}