@bearei/contracts 0.0.0-stage → 2.0.0-dev.3

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project are documented in this file. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 2.0.0-dev.3 — 2026-10-27
+
+Development snapshot published under the `next` dist-tag to verify the unified release pipeline
+across all Bearei repositories: the artifact is pulled back from the registry, re-verified and
+attached to the GitHub release. It matches the 2.0.0 scope documented below and leaves the
+`latest` dist-tag unchanged.
+
+Install it with `yarn add @bearei/contracts@next` or pin `@bearei/contracts@2.0.0-dev.3`.
+
+## 2.0.0-dev.2 — 2026-10-27
+
+Development snapshot published under the `next` dist-tag to verify the npm trusted publishing
+pipeline. It matches the 2.0.0 scope documented below and leaves the `latest` dist-tag unchanged.
+
+Install it with `yarn add @bearei/contracts@next` or pin `@bearei/contracts@2.0.0-dev.2`.
+
+## 2.0.0 — 2026-10-26
+
+### Added
+
+- `HTTP_EXCEPTION_CODE` and `HttpExceptionCode`, moved from `@bearei/nest` without changing any
+  numeric value.
+- `ApiErrorBody` with the normalized `{code, message, statusCode}` shape.
+- `DEFAULT_PAGE_SIZE`, `MAX_PAGE_SIZE`, `PaginationQuery` and `PaginatedResult<T>`.
+- `RESERVED_REQUEST_HEADER` and `ReservedRequestHeaderName` for the six `x-bearei-*` headers.
+- `LANGUAGE`, `Language`, `ORDER` and `Order`, moved from `@bearei/nest`.
+- Dual ESM and CommonJS builds with matching declaration files.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Bearei
+
+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,75 @@
-# Temporary Holding Version
+# @bearei/contracts
 
-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.
+Framework-agnostic wire contracts shared by Bearei services, clients and apps. The package has no
+runtime dependencies and ships both ESM and CommonJS builds.
+
+English | [中文](./README.zh-CN.md)
+
+| Export                                                 | Kind  | Purpose                                             |
+| ------------------------------------------------------ | ----- | --------------------------------------------------- |
+| `HTTP_EXCEPTION_CODE`, `HttpExceptionCode`             | value | Numeric error codes shared by services and clients  |
+| `ApiErrorBody`                                         | type  | Normalized error body `{code, message, statusCode}` |
+| `DEFAULT_PAGE_SIZE`, `MAX_PAGE_SIZE`                   | value | Paging limits used by every list endpoint           |
+| `PaginationQuery`, `PaginatedResult<T>`                | type  | Paging request fields and page envelope             |
+| `RESERVED_REQUEST_HEADER`, `ReservedRequestHeaderName` | value | Headers set by the gateway or authentication layer  |
+| `LANGUAGE`, `Language`                                 | value | Locale values                                       |
+| `ORDER`, `Order`                                       | value | Sort order values                                   |
+
+## Install
+
+```bash
+yarn add @bearei/contracts
+```
+
+## Usage
+
+```ts
+import {
+	DEFAULT_PAGE_SIZE,
+	HTTP_EXCEPTION_CODE,
+	RESERVED_REQUEST_HEADER,
+	type ApiErrorBody,
+	type PaginatedResult
+} from '@bearei/contracts'
+
+const error: ApiErrorBody = {
+	code: HTTP_EXCEPTION_CODE.NOT_FOUND,
+	message: 'Not Found',
+	statusCode: 404
+}
+
+const subject = request.headers[RESERVED_REQUEST_HEADER.SUBJECT]
+const page: PaginatedResult<{id: string}> = {
+	page: 1,
+	pageSize: DEFAULT_PAGE_SIZE,
+	results: [{id: 'a'}]
+}
+```
+
+### Module formats
+
+The `exports` map resolves `import` consumers to the ESM build and `require` consumers to the
+CommonJS build. TypeScript picks the matching declaration file (`.d.mts` or `.d.ts`).
+
+## Scope
+
+Only values and types that both ends of a wire boundary must agree on belong here:
+
+- numeric error codes and error response bodies
+- query and response shapes shared by API clients and services
+- reserved request header names
+- cross-project enums such as language and sort order
+
+Framework-specific code does not belong here: NestJS decorators, guards and interceptors,
+TypeORM entities, HTTP clients, persistence, and service-only DTOs stay in their own libraries.
+
+`HTTP_EXCEPTION_CODE` values are wire contract. Append new codes and never renumber or reuse an
+existing value; renaming a code is also a breaking change for consumers that imported it by name.
+
+## Development
+
+```bash
+yarn install
+yarn verify       # lint + typecheck + coverage + build
+yarn run pack   # pack once and inspect the tarball
+```

package/README.zh-CN.md

@@ -0,0 +1,75 @@
+# @bearei/contracts
+
+Bearei 服务、客户端与应用共享的传输契约，不依赖任何框架。包本身没有运行时依赖，同时提供
+ESM 与 CommonJS 两种产物。
+
+[English](./README.md) | 中文
+
+| 导出                                                   | 类型 | 用途                                     |
+| ------------------------------------------------------ | ---- | ---------------------------------------- |
+| `HTTP_EXCEPTION_CODE`、`HttpExceptionCode`             | 值   | 服务与客户端共享的数字错误码             |
+| `ApiErrorBody`                                         | 类型 | 统一错误体 `{code, message, statusCode}` |
+| `DEFAULT_PAGE_SIZE`、`MAX_PAGE_SIZE`                   | 值   | 所有列表接口使用的分页上限               |
+| `PaginationQuery`、`PaginatedResult<T>`                | 类型 | 分页请求字段与分页响应信封               |
+| `RESERVED_REQUEST_HEADER`、`ReservedRequestHeaderName` | 值   | 由网关或认证层写入的保留请求头           |
+| `LANGUAGE`、`Language`                                 | 值   | 语言值                                   |
+| `ORDER`、`Order`                                       | 值   | 排序值                                   |
+
+## 安装
+
+```bash
+yarn add @bearei/contracts
+```
+
+## 使用
+
+```ts
+import {
+	DEFAULT_PAGE_SIZE,
+	HTTP_EXCEPTION_CODE,
+	RESERVED_REQUEST_HEADER,
+	type ApiErrorBody,
+	type PaginatedResult
+} from '@bearei/contracts'
+
+const error: ApiErrorBody = {
+	code: HTTP_EXCEPTION_CODE.NOT_FOUND,
+	message: 'Not Found',
+	statusCode: 404
+}
+
+const subject = request.headers[RESERVED_REQUEST_HEADER.SUBJECT]
+const page: PaginatedResult<{id: string}> = {
+	page: 1,
+	pageSize: DEFAULT_PAGE_SIZE,
+	results: [{id: 'a'}]
+}
+```
+
+### 模块格式
+
+`exports` 映射会让 `import` 使用 ESM 产物、`require` 使用 CommonJS 产物；TypeScript 会自动选择
+对应的声明文件（`.d.mts` 或 `.d.ts`）。
+
+## 收录范围
+
+这里只放传输边界两端必须一致的值与类型：
+
+- 数字错误码与错误响应体
+- API 客户端与服务共享的查询、响应结构
+- 保留请求头名称
+- 语言、排序等跨项目枚举
+
+框架相关代码不放进这里：NestJS 装饰器、守卫、拦截器，TypeORM 实体，HTTP 客户端，持久化，
+以及仅服务端使用的 DTO 都留在各自的库中。
+
+`HTTP_EXCEPTION_CODE` 的数值属于线上契约。只能追加新错误码，不得重新编号或复用已有数值；
+重命名错误码同样会破坏按名称引用它的使用者。
+
+## 开发
+
+```bash
+yarn install
+yarn verify       # lint + typecheck + 覆盖率 + 构建
+yarn run pack   # 打包一次并检查 tarball
+```

package/dist/index.d.mts

@@ -0,0 +1,88 @@
+/**
+ * Numeric error codes shared by Bearei services and clients.
+ * Values are part of the wire contract: append new codes, never renumber or reuse.
+ */
+declare const HTTP_EXCEPTION_CODE: {
+    readonly ACCESS_DENIED_FOR_GUEST: 401003;
+    readonly APPLE_IAP_TRANSACTION_NOT_COMPLETED: 403004;
+    readonly APPLE_IAP_TRANSACTION_UNAUTHORIZED: 401008;
+    readonly APPLE_IAP_TRANSACTION_VERIFICATION_FAILED: 403005;
+    readonly BAD_GATEWAY: 502000;
+    readonly BAD_REQUEST: 400000;
+    readonly CONTAINS_INVALID_REQUEST_HEADERS: 400001;
+    readonly EMAIL_CODE_INVALID: 401004;
+    readonly EMAIL_SENDING_FAILED: 400005;
+    readonly EMAIL_SENDING_LIMIT_DAY: 400006;
+    readonly EMAIL_SENDING_LIMIT_MINUTE: 400007;
+    readonly FORBIDDEN: 403000;
+    readonly INTERNAL_SERVER_ERROR: 500000;
+    readonly INTERNAL_SERVER_REQUEST_TIMEOUT: 408001;
+    readonly INTERNAL_SERVER_SIGNATURE_VERIFICATION_FAILED: 401002;
+    readonly INVALID_PAYMENT_CHANNEL: 400008;
+    readonly MISSING_SIGN_IN_ENTITY: 400009;
+    readonly MISSING_SUBSCRIPTION_USER_ENTITY: 400010;
+    readonly NOT_FOUND: 404000;
+    readonly NOT_SUBSCRIBED: 403002;
+    readonly OR_VALIDATION_PARAMETER_INVALID: 400002;
+    readonly PASSWORD_HAS_EXPIRED: 401006;
+    readonly PASSWORD_IS_INVALID: 401007;
+    readonly PROHIBITED_OPERATIONS: 403001;
+    readonly PROHIBITED_RESET_PASSWORD: 403003;
+    readonly REQUEST_TIMEOUT: 408000;
+    readonly SERVICE_FIELDS_ALREADY_EXISTS: 400003;
+    readonly SIGNATURE_STRING_LENGTH_LIMIT: 400004;
+    readonly TOKEN_IS_NOT_FOUND: 401001;
+    readonly UNAUTHORIZED: 401000;
+    readonly UNPROCESSABLE_ENTITY: 422000;
+    readonly USER_DEACTIVATED: 401005;
+};
+type HttpExceptionCode = (typeof HTTP_EXCEPTION_CODE)[keyof typeof HTTP_EXCEPTION_CODE];
+
+/**
+ * Normalized error body returned by Bearei HTTP APIs.
+ * Services may return codes outside `HTTP_EXCEPTION_CODE`, so `code` stays numeric.
+ */
+interface ApiErrorBody {
+    code: number;
+    message: string;
+    statusCode: number;
+}
+
+declare const RESERVED_REQUEST_HEADER: {
+    readonly CLIENT: "x-bearei-client";
+    readonly DOMAIN_ID: "x-bearei-domain-id";
+    readonly INTERNAL_AUTHORIZATION: "x-bearei-internal-authorization";
+    readonly IP: "x-bearei-ip";
+    readonly SUBJECT: "x-bearei-subject";
+    readonly SUBSCRIPTION: "x-bearei-subscription";
+};
+type ReservedRequestHeaderName = (typeof RESERVED_REQUEST_HEADER)[keyof typeof RESERVED_REQUEST_HEADER];
+
+declare const LANGUAGE: {
+    readonly EN_US: "EN_US";
+    readonly ZH_CN: "ZH_CN";
+};
+type Language = (typeof LANGUAGE)[keyof typeof LANGUAGE];
+
+declare const ORDER: {
+    readonly ASC: "ASC";
+    readonly DESC: "DESC";
+};
+type Order = (typeof ORDER)[keyof typeof ORDER];
+
+declare const DEFAULT_PAGE_SIZE = 10;
+declare const MAX_PAGE_SIZE = 1024;
+interface PaginationQuery {
+    page?: number;
+    pageSize?: number;
+}
+interface PaginatedResult<T> {
+    page: number;
+    pageSize: number;
+    results: T[];
+    /** Present only when a total was requested for the first page. */
+    total?: number;
+}
+
+export { DEFAULT_PAGE_SIZE, HTTP_EXCEPTION_CODE, LANGUAGE, MAX_PAGE_SIZE, ORDER, RESERVED_REQUEST_HEADER };
+export type { ApiErrorBody, HttpExceptionCode, Language, Order, PaginatedResult, PaginationQuery, ReservedRequestHeaderName };

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Numeric error codes shared by Bearei services and clients.
+ * Values are part of the wire contract: append new codes, never renumber or reuse.
+ */
+declare const HTTP_EXCEPTION_CODE: {
+    readonly ACCESS_DENIED_FOR_GUEST: 401003;
+    readonly APPLE_IAP_TRANSACTION_NOT_COMPLETED: 403004;
+    readonly APPLE_IAP_TRANSACTION_UNAUTHORIZED: 401008;
+    readonly APPLE_IAP_TRANSACTION_VERIFICATION_FAILED: 403005;
+    readonly BAD_GATEWAY: 502000;
+    readonly BAD_REQUEST: 400000;
+    readonly CONTAINS_INVALID_REQUEST_HEADERS: 400001;
+    readonly EMAIL_CODE_INVALID: 401004;
+    readonly EMAIL_SENDING_FAILED: 400005;
+    readonly EMAIL_SENDING_LIMIT_DAY: 400006;
+    readonly EMAIL_SENDING_LIMIT_MINUTE: 400007;
+    readonly FORBIDDEN: 403000;
+    readonly INTERNAL_SERVER_ERROR: 500000;
+    readonly INTERNAL_SERVER_REQUEST_TIMEOUT: 408001;
+    readonly INTERNAL_SERVER_SIGNATURE_VERIFICATION_FAILED: 401002;
+    readonly INVALID_PAYMENT_CHANNEL: 400008;
+    readonly MISSING_SIGN_IN_ENTITY: 400009;
+    readonly MISSING_SUBSCRIPTION_USER_ENTITY: 400010;
+    readonly NOT_FOUND: 404000;
+    readonly NOT_SUBSCRIBED: 403002;
+    readonly OR_VALIDATION_PARAMETER_INVALID: 400002;
+    readonly PASSWORD_HAS_EXPIRED: 401006;
+    readonly PASSWORD_IS_INVALID: 401007;
+    readonly PROHIBITED_OPERATIONS: 403001;
+    readonly PROHIBITED_RESET_PASSWORD: 403003;
+    readonly REQUEST_TIMEOUT: 408000;
+    readonly SERVICE_FIELDS_ALREADY_EXISTS: 400003;
+    readonly SIGNATURE_STRING_LENGTH_LIMIT: 400004;
+    readonly TOKEN_IS_NOT_FOUND: 401001;
+    readonly UNAUTHORIZED: 401000;
+    readonly UNPROCESSABLE_ENTITY: 422000;
+    readonly USER_DEACTIVATED: 401005;
+};
+type HttpExceptionCode = (typeof HTTP_EXCEPTION_CODE)[keyof typeof HTTP_EXCEPTION_CODE];
+
+/**
+ * Normalized error body returned by Bearei HTTP APIs.
+ * Services may return codes outside `HTTP_EXCEPTION_CODE`, so `code` stays numeric.
+ */
+interface ApiErrorBody {
+    code: number;
+    message: string;
+    statusCode: number;
+}
+
+declare const RESERVED_REQUEST_HEADER: {
+    readonly CLIENT: "x-bearei-client";
+    readonly DOMAIN_ID: "x-bearei-domain-id";
+    readonly INTERNAL_AUTHORIZATION: "x-bearei-internal-authorization";
+    readonly IP: "x-bearei-ip";
+    readonly SUBJECT: "x-bearei-subject";
+    readonly SUBSCRIPTION: "x-bearei-subscription";
+};
+type ReservedRequestHeaderName = (typeof RESERVED_REQUEST_HEADER)[keyof typeof RESERVED_REQUEST_HEADER];
+
+declare const LANGUAGE: {
+    readonly EN_US: "EN_US";
+    readonly ZH_CN: "ZH_CN";
+};
+type Language = (typeof LANGUAGE)[keyof typeof LANGUAGE];
+
+declare const ORDER: {
+    readonly ASC: "ASC";
+    readonly DESC: "DESC";
+};
+type Order = (typeof ORDER)[keyof typeof ORDER];
+
+declare const DEFAULT_PAGE_SIZE = 10;
+declare const MAX_PAGE_SIZE = 1024;
+interface PaginationQuery {
+    page?: number;
+    pageSize?: number;
+}
+interface PaginatedResult<T> {
+    page: number;
+    pageSize: number;
+    results: T[];
+    /** Present only when a total was requested for the first page. */
+    total?: number;
+}
+
+export { DEFAULT_PAGE_SIZE, HTTP_EXCEPTION_CODE, LANGUAGE, MAX_PAGE_SIZE, ORDER, RESERVED_REQUEST_HEADER };
+export type { ApiErrorBody, HttpExceptionCode, Language, Order, PaginatedResult, PaginationQuery, ReservedRequestHeaderName };

package/dist/index.js

@@ -0,0 +1,101 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
+  HTTP_EXCEPTION_CODE: () => HTTP_EXCEPTION_CODE,
+  LANGUAGE: () => LANGUAGE,
+  MAX_PAGE_SIZE: () => MAX_PAGE_SIZE,
+  ORDER: () => ORDER,
+  RESERVED_REQUEST_HEADER: () => RESERVED_REQUEST_HEADER
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/error-code.ts
+var HTTP_EXCEPTION_CODE = {
+  ACCESS_DENIED_FOR_GUEST: 401003,
+  APPLE_IAP_TRANSACTION_NOT_COMPLETED: 403004,
+  APPLE_IAP_TRANSACTION_UNAUTHORIZED: 401008,
+  APPLE_IAP_TRANSACTION_VERIFICATION_FAILED: 403005,
+  BAD_GATEWAY: 502e3,
+  BAD_REQUEST: 4e5,
+  CONTAINS_INVALID_REQUEST_HEADERS: 400001,
+  EMAIL_CODE_INVALID: 401004,
+  EMAIL_SENDING_FAILED: 400005,
+  EMAIL_SENDING_LIMIT_DAY: 400006,
+  EMAIL_SENDING_LIMIT_MINUTE: 400007,
+  FORBIDDEN: 403e3,
+  INTERNAL_SERVER_ERROR: 5e5,
+  INTERNAL_SERVER_REQUEST_TIMEOUT: 408001,
+  INTERNAL_SERVER_SIGNATURE_VERIFICATION_FAILED: 401002,
+  INVALID_PAYMENT_CHANNEL: 400008,
+  MISSING_SIGN_IN_ENTITY: 400009,
+  MISSING_SUBSCRIPTION_USER_ENTITY: 400010,
+  NOT_FOUND: 404e3,
+  NOT_SUBSCRIBED: 403002,
+  OR_VALIDATION_PARAMETER_INVALID: 400002,
+  PASSWORD_HAS_EXPIRED: 401006,
+  PASSWORD_IS_INVALID: 401007,
+  PROHIBITED_OPERATIONS: 403001,
+  PROHIBITED_RESET_PASSWORD: 403003,
+  REQUEST_TIMEOUT: 408e3,
+  SERVICE_FIELDS_ALREADY_EXISTS: 400003,
+  SIGNATURE_STRING_LENGTH_LIMIT: 400004,
+  TOKEN_IS_NOT_FOUND: 401001,
+  UNAUTHORIZED: 401e3,
+  UNPROCESSABLE_ENTITY: 422e3,
+  USER_DEACTIVATED: 401005
+};
+
+// src/header.ts
+var RESERVED_REQUEST_HEADER = {
+  CLIENT: "x-bearei-client",
+  DOMAIN_ID: "x-bearei-domain-id",
+  INTERNAL_AUTHORIZATION: "x-bearei-internal-authorization",
+  IP: "x-bearei-ip",
+  SUBJECT: "x-bearei-subject",
+  SUBSCRIPTION: "x-bearei-subscription"
+};
+
+// src/language.ts
+var LANGUAGE = {
+  EN_US: "EN_US",
+  ZH_CN: "ZH_CN"
+};
+
+// src/order.ts
+var ORDER = {
+  ASC: "ASC",
+  DESC: "DESC"
+};
+
+// src/pagination.ts
+var DEFAULT_PAGE_SIZE = 10;
+var MAX_PAGE_SIZE = 1024;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_PAGE_SIZE,
+  HTTP_EXCEPTION_CODE,
+  LANGUAGE,
+  MAX_PAGE_SIZE,
+  ORDER,
+  RESERVED_REQUEST_HEADER
+});

package/dist/index.mjs

@@ -0,0 +1,69 @@
+// src/error-code.ts
+var HTTP_EXCEPTION_CODE = {
+  ACCESS_DENIED_FOR_GUEST: 401003,
+  APPLE_IAP_TRANSACTION_NOT_COMPLETED: 403004,
+  APPLE_IAP_TRANSACTION_UNAUTHORIZED: 401008,
+  APPLE_IAP_TRANSACTION_VERIFICATION_FAILED: 403005,
+  BAD_GATEWAY: 502e3,
+  BAD_REQUEST: 4e5,
+  CONTAINS_INVALID_REQUEST_HEADERS: 400001,
+  EMAIL_CODE_INVALID: 401004,
+  EMAIL_SENDING_FAILED: 400005,
+  EMAIL_SENDING_LIMIT_DAY: 400006,
+  EMAIL_SENDING_LIMIT_MINUTE: 400007,
+  FORBIDDEN: 403e3,
+  INTERNAL_SERVER_ERROR: 5e5,
+  INTERNAL_SERVER_REQUEST_TIMEOUT: 408001,
+  INTERNAL_SERVER_SIGNATURE_VERIFICATION_FAILED: 401002,
+  INVALID_PAYMENT_CHANNEL: 400008,
+  MISSING_SIGN_IN_ENTITY: 400009,
+  MISSING_SUBSCRIPTION_USER_ENTITY: 400010,
+  NOT_FOUND: 404e3,
+  NOT_SUBSCRIBED: 403002,
+  OR_VALIDATION_PARAMETER_INVALID: 400002,
+  PASSWORD_HAS_EXPIRED: 401006,
+  PASSWORD_IS_INVALID: 401007,
+  PROHIBITED_OPERATIONS: 403001,
+  PROHIBITED_RESET_PASSWORD: 403003,
+  REQUEST_TIMEOUT: 408e3,
+  SERVICE_FIELDS_ALREADY_EXISTS: 400003,
+  SIGNATURE_STRING_LENGTH_LIMIT: 400004,
+  TOKEN_IS_NOT_FOUND: 401001,
+  UNAUTHORIZED: 401e3,
+  UNPROCESSABLE_ENTITY: 422e3,
+  USER_DEACTIVATED: 401005
+};
+
+// src/header.ts
+var RESERVED_REQUEST_HEADER = {
+  CLIENT: "x-bearei-client",
+  DOMAIN_ID: "x-bearei-domain-id",
+  INTERNAL_AUTHORIZATION: "x-bearei-internal-authorization",
+  IP: "x-bearei-ip",
+  SUBJECT: "x-bearei-subject",
+  SUBSCRIPTION: "x-bearei-subscription"
+};
+
+// src/language.ts
+var LANGUAGE = {
+  EN_US: "EN_US",
+  ZH_CN: "ZH_CN"
+};
+
+// src/order.ts
+var ORDER = {
+  ASC: "ASC",
+  DESC: "DESC"
+};
+
+// src/pagination.ts
+var DEFAULT_PAGE_SIZE = 10;
+var MAX_PAGE_SIZE = 1024;
+export {
+  DEFAULT_PAGE_SIZE,
+  HTTP_EXCEPTION_CODE,
+  LANGUAGE,
+  MAX_PAGE_SIZE,
+  ORDER,
+  RESERVED_REQUEST_HEADER
+};

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "@bearei/contracts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.0-dev.3",
+  "description": "Framework-agnostic wire contracts shared by Bearei services, clients and apps",
+  "keywords": [
+    "bearei",
+    "contracts",
+    "shared",
+    "types"
+  ],
+  "homepage": "https://github.com/bear-ei/contracts#readme",
+  "bugs": {
+    "url": "https://github.com/bear-ei/contracts/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bear-ei/contracts.git"
+  },
+  "author": "bearei <bear_ei@outlook.com>",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@bearei/eslint-config": "^2.0.0",
+    "@bearei/jest-preset": "^2.0.0",
+    "@bearei/tsconfig": "^2.0.0",
+    "@types/jest": "^29.5.13",
+    "eslint": "^9.37.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.9.6",
+    "ts-jest": "^29.1.0",
+    "tsup": "^9.0.0",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "@bearei/jest-preset/nest",
+    "rootDir": ".",
+    "collectCoverageFrom": [
+      "src/**/*.ts",
+      "!src/**/*.spec.ts",
+      "!src/**/*.interface.ts",
+      "!src/index.ts"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 90,
+        "functions": 90,
+        "lines": 90,
+        "statements": 90
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint \"src/**/*.ts\"",
+    "pack": "yarn pack -o /tmp/bearei-contracts.tgz && bash .github/scripts/verify-tarball.sh /tmp/bearei-contracts.tgz",
+    "prepack": "yarn build",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "verify": "yarn lint && yarn typecheck && yarn test:coverage && yarn build"
+  },
+  "packageManager": "yarn@4.18.0"
 }