@bearei/contracts 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented in this file. The format is b
 [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).
 
+## 3.1.0 — 2026-10-30
+
+### Added
+
+- `EMAIL_TEMPLATE` and `EmailTemplate`: the template identifiers accepted by `bearei-email` and used
+  by clients to pick an email template. Values are `SIGN_UP_CAPTCHA` and `RESET_PASSWORD_CAPTCHA`.
+  The enum is additive; no existing export changed.
+
 ## 3.0.0 — 2026-10-29
 
 ### Breaking

package/README.md

@@ -13,6 +13,7 @@ English | [中文](./README.zh-CN.md)
 | `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                                       |
+| `EMAIL_TEMPLATE`, `EmailTemplate`                      | value | Email template values used by services and clients  |
 | `ORDER`, `Order`                                       | value | Sort order values                                   |
 | `PERMISSION`, `Permission`                             | value | Permission values used by services and clients      |
 | `SUBSCRIPTION_FEATURE`, `SubscriptionFeature`          | value | Subscription feature values scoped like permissions |

package/README.zh-CN.md

@@ -13,6 +13,7 @@ ESM 与 CommonJS 两种产物。
 | `PaginationQuery`、`PaginatedResult<T>`                | 类型 | 分页请求字段与分页响应信封               |
 | `RESERVED_REQUEST_HEADER`、`ReservedRequestHeaderName` | 值   | 由网关或认证层写入的保留请求头           |
 | `LANGUAGE`、`Language`                                 | 值   | 语言值                                   |
+| `EMAIL_TEMPLATE`、`EmailTemplate`                      | 值   | 服务与客户端共用的邮件模板值             |
 | `ORDER`、`Order`                                       | 值   | 排序值                                   |
 | `PERMISSION`、`Permission`                             | 值   | 服务与客户端共用的权限值                 |
 | `SUBSCRIPTION_FEATURE`、`SubscriptionFeature`          | 值   | 订阅特性值，与权限使用相同的区域写法     |

package/dist/index.d.mts

@@ -1,3 +1,9 @@
+declare const EMAIL_TEMPLATE: {
+    readonly RESET_PASSWORD_CAPTCHA: "RESET_PASSWORD_CAPTCHA";
+    readonly SIGN_UP_CAPTCHA: "SIGN_UP_CAPTCHA";
+};
+type EmailTemplate = (typeof EMAIL_TEMPLATE)[keyof typeof EMAIL_TEMPLATE];
+
 /**
  * Numeric error codes shared by Bearei services and clients.
  * Values are part of the wire contract: append new codes, never renumber or reuse.
@@ -166,5 +172,5 @@ declare const SUBSCRIPTION_FEATURE: {
 };
 type SubscriptionFeature = (typeof SUBSCRIPTION_FEATURE)[keyof typeof SUBSCRIPTION_FEATURE];
 
-export { DEFAULT_PAGE_SIZE, HTTP_EXCEPTION_CODE, LANGUAGE, MAX_PAGE_SIZE, ORDER, PERMISSION, RESERVED_REQUEST_HEADER, SUBSCRIPTION_FEATURE };
-export type { ApiErrorBody, HttpExceptionCode, Language, Order, PaginatedResult, PaginationQuery, Permission, ReservedRequestHeaderName, SubscriptionFeature };
+export { DEFAULT_PAGE_SIZE, EMAIL_TEMPLATE, HTTP_EXCEPTION_CODE, LANGUAGE, MAX_PAGE_SIZE, ORDER, PERMISSION, RESERVED_REQUEST_HEADER, SUBSCRIPTION_FEATURE };
+export type { ApiErrorBody, EmailTemplate, HttpExceptionCode, Language, Order, PaginatedResult, PaginationQuery, Permission, ReservedRequestHeaderName, SubscriptionFeature };

package/dist/index.d.ts

@@ -1,3 +1,9 @@
+declare const EMAIL_TEMPLATE: {
+    readonly RESET_PASSWORD_CAPTCHA: "RESET_PASSWORD_CAPTCHA";
+    readonly SIGN_UP_CAPTCHA: "SIGN_UP_CAPTCHA";
+};
+type EmailTemplate = (typeof EMAIL_TEMPLATE)[keyof typeof EMAIL_TEMPLATE];
+
 /**
  * Numeric error codes shared by Bearei services and clients.
  * Values are part of the wire contract: append new codes, never renumber or reuse.
@@ -166,5 +172,5 @@ declare const SUBSCRIPTION_FEATURE: {
 };
 type SubscriptionFeature = (typeof SUBSCRIPTION_FEATURE)[keyof typeof SUBSCRIPTION_FEATURE];
 
-export { DEFAULT_PAGE_SIZE, HTTP_EXCEPTION_CODE, LANGUAGE, MAX_PAGE_SIZE, ORDER, PERMISSION, RESERVED_REQUEST_HEADER, SUBSCRIPTION_FEATURE };
-export type { ApiErrorBody, HttpExceptionCode, Language, Order, PaginatedResult, PaginationQuery, Permission, ReservedRequestHeaderName, SubscriptionFeature };
+export { DEFAULT_PAGE_SIZE, EMAIL_TEMPLATE, HTTP_EXCEPTION_CODE, LANGUAGE, MAX_PAGE_SIZE, ORDER, PERMISSION, RESERVED_REQUEST_HEADER, SUBSCRIPTION_FEATURE };
+export type { ApiErrorBody, EmailTemplate, HttpExceptionCode, Language, Order, PaginatedResult, PaginationQuery, Permission, ReservedRequestHeaderName, SubscriptionFeature };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
+  EMAIL_TEMPLATE: () => EMAIL_TEMPLATE,
   HTTP_EXCEPTION_CODE: () => HTTP_EXCEPTION_CODE,
   LANGUAGE: () => LANGUAGE,
   MAX_PAGE_SIZE: () => MAX_PAGE_SIZE,
@@ -31,6 +32,12 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/email-template.enum.ts
+var EMAIL_TEMPLATE = {
+  RESET_PASSWORD_CAPTCHA: "RESET_PASSWORD_CAPTCHA",
+  SIGN_UP_CAPTCHA: "SIGN_UP_CAPTCHA"
+};
+
 // src/error-code.enum.ts
 var HTTP_EXCEPTION_CODE = {
   ACCESS_DENIED_FOR_GUEST: 401003,
@@ -175,6 +182,7 @@ var SUBSCRIPTION_FEATURE = {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_PAGE_SIZE,
+  EMAIL_TEMPLATE,
   HTTP_EXCEPTION_CODE,
   LANGUAGE,
   MAX_PAGE_SIZE,

package/dist/index.mjs

@@ -1,3 +1,9 @@
+// src/email-template.enum.ts
+var EMAIL_TEMPLATE = {
+  RESET_PASSWORD_CAPTCHA: "RESET_PASSWORD_CAPTCHA",
+  SIGN_UP_CAPTCHA: "SIGN_UP_CAPTCHA"
+};
+
 // src/error-code.enum.ts
 var HTTP_EXCEPTION_CODE = {
   ACCESS_DENIED_FOR_GUEST: 401003,
@@ -141,6 +147,7 @@ var SUBSCRIPTION_FEATURE = {
 };
 export {
   DEFAULT_PAGE_SIZE,
+  EMAIL_TEMPLATE,
   HTTP_EXCEPTION_CODE,
   LANGUAGE,
   MAX_PAGE_SIZE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bearei/contracts",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Framework-agnostic wire contracts shared by Bearei services, clients and apps",
   "keywords": [
     "bearei",