@ones-open/node-sdk 0.0.4-15682.67 → 0.0.4-16644.216

package/dist/index.cjs

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const _defineProperty = require("@babel/runtime-corejs3/helpers/defineProperty");
-const lodashEs = require("lodash-es");
+const node_crypto = require("node:crypto");
 const Fetch = require("axios");
+const lodashEs = require("lodash-es");
 const _sortInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/sort");
 const getONESHostedBaseUrl = () => {
   return process.env.ONES_HOSTED_BASE_URL;
@@ -10,10 +10,79 @@ const getONESHostedBaseUrl = () => {
 const getONESHostedAppID = () => {
   return process.env.ONES_HOSTED_APP_ID;
 };
-const index$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const getONESHostedToken = () => {
+  return process.env.ONES_HOSTED_TOKEN;
+};
+const index$2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   getONESHostedAppID,
-  getONESHostedBaseUrl
+  getONESHostedBaseUrl,
+  getONESHostedToken
+}, Symbol.toStringTag, { value: "Module" }));
+const ASSERTION_TTL_SECONDS = 24 * 60 * 60;
+const ASSERTION_JTI_LENGTH = 16;
+const TOKEN_GRANT_TYPE = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer";
+const fetch$2 = Fetch.create();
+const buildJWTAssertion = (installationInfo, userID) => {
+  const now = Math.floor(Date.now() / 1e3);
+  const header = {
+    alg: "HS256",
+    typ: "JWT"
+  };
+  const payload = {
+    uid: userID,
+    rsh: "",
+    iss: installationInfo.installation_id,
+    sub: installationInfo.installation_id,
+    aud: "oauth",
+    exp: now + ASSERTION_TTL_SECONDS,
+    iat: now,
+    jti: node_crypto.randomUUID().replace(/-/g, "").slice(0, ASSERTION_JTI_LENGTH)
+  };
+  const encodedHeader = Buffer.from(JSON.stringify(header)).toString("base64url");
+  const encodedPayload = Buffer.from(JSON.stringify(payload)).toString("base64url");
+  const signingInput = `${encodedHeader}.${encodedPayload}`;
+  const signKey = Buffer.from(installationInfo.shared_secret, "base64");
+  const signature = node_crypto.createHmac("sha256", signKey).update(signingInput).digest("base64url");
+  return `${signingInput}.${signature}`;
+};
+const getAccessTokenByInstallationInfo = async function(installationInfo) {
+  let userID = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "";
+  const assertion = buildJWTAssertion(installationInfo, userID);
+  const tokenURL = new URL("/oauth2/token", installationInfo.ones_base_url);
+  const formData = new URLSearchParams();
+  formData.set("grant_type", TOKEN_GRANT_TYPE);
+  formData.set("client_id", installationInfo.installation_id);
+  formData.set("assertion", assertion);
+  try {
+    const response = await fetch$2.post(tokenURL.toString(), formData.toString(), {
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded"
+      }
+    });
+    const token = response.data;
+    if (!token.access_token) {
+      throw new Error("failed to get access token: empty access_token in response");
+    }
+    return token.access_token;
+  } catch (error) {
+    if (error instanceof Fetch.AxiosError) {
+      var _error$response, _error$response$statu, _error$response2, _error$response3;
+      const status = (_error$response = error.response) === null || _error$response === void 0 ? void 0 : _error$response.status;
+      const statusText = (_error$response$statu = (_error$response2 = error.response) === null || _error$response2 === void 0 ? void 0 : _error$response2.statusText) !== null && _error$response$statu !== void 0 ? _error$response$statu : "";
+      const data = (_error$response3 = error.response) === null || _error$response3 === void 0 ? void 0 : _error$response3.data;
+      const responseText = typeof data === "string" ? data : JSON.stringify(data);
+      throw new Error(`failed to get access token: ${status !== null && status !== void 0 ? status : "unknown"} ${statusText}, response: ${responseText}`);
+    }
+    throw error;
+  }
+};
+const oauth = {
+  getAccessTokenByInstallationInfo
+};
+const index$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  oauth
 }, Symbol.toStringTag, { value: "Module" }));
 var EntityWhereConditionEnum = /* @__PURE__ */ ((EntityWhereConditionEnum2) => {
   EntityWhereConditionEnum2["beginsWith"] = "beginsWith";
@@ -116,7 +185,7 @@ const createErrorResult = (code, message, error) => {
 };
 const fetch$1 = Fetch.create();
 const buildAuthHeaders$1 = () => {
-  const token = process.env.ONES_HOSTED_TOKEN;
+  const token = getONESHostedToken();
   if (token) {
     return {
       Authorization: `Bearer ${token}`
@@ -195,12 +264,12 @@ const defaultEntityQueryIndex = defaultEntityQuery.index;
 const defaultEntityQueryWhere = defaultEntityQuery.where;
 class EntityQueryClass {
   constructor(name) {
-    _defineProperty(this, "_name", "");
-    _defineProperty(this, "_cursor", [defaultEntityQueryCursor]);
-    _defineProperty(this, "_limit", [defaultEntityQueryLimit]);
-    _defineProperty(this, "_sort", [defaultEntityQuerySort]);
-    _defineProperty(this, "_index", [defaultEntityQueryIndex]);
-    _defineProperty(this, "_where", [defaultEntityQueryWhere]);
+    this._name = "";
+    this._cursor = [defaultEntityQueryCursor];
+    this._limit = [defaultEntityQueryLimit];
+    this._sort = [defaultEntityQuerySort];
+    this._index = [defaultEntityQueryIndex];
+    this._where = [defaultEntityQueryWhere];
     this._name = name;
   }
   cursor(cursor) {
@@ -294,7 +363,7 @@ class EntityQueryClass {
 }
 class EntityClass {
   constructor(name) {
-    _defineProperty(this, "_name", "");
+    this._name = "";
     this._name = name;
   }
   async get(key) {
@@ -400,11 +469,8 @@ var ObjectErrorCode = /* @__PURE__ */ ((ObjectErrorCode2) => {
   return ObjectErrorCode2;
 })(ObjectErrorCode || {});
 class ObjectError {
-  /**
-   * @description 错误载荷
-   */
   constructor(result) {
-    _defineProperty(this, "err_msg", "");
+    this.err_msg = "";
     this.code = result.code;
     this.err_msg = result.err_msg;
     this.err_values = result.err_values;
@@ -412,7 +478,7 @@ class ObjectError {
 }
 const fetch = Fetch.create();
 const buildAuthHeaders = () => {
-  const token = process.env.ONES_HOSTED_TOKEN;
+  const token = getONESHostedToken();
   if (token) {
     return {
       Authorization: `Bearer ${token}`
@@ -552,5 +618,6 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   object
 }, Symbol.toStringTag, { value: "Module" }));
 exports.ErrorCode = ErrorCode;
-exports.env = index$1;
+exports.env = index$2;
+exports.oauth = index$1;
 exports.storage = index;

package/dist/index.js

@@ -1,6 +1,6 @@
-import _defineProperty from "@babel/runtime-corejs3/helpers/defineProperty";
-import { isNull, isUndefined, isSymbol, set } from "lodash-es";
+import { randomUUID, createHmac } from "node:crypto";
 import Fetch, { AxiosError } from "axios";
+import { isNull, isUndefined, isSymbol, set } from "lodash-es";
 import _sortInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/sort";
 const getONESHostedBaseUrl = () => {
   return process.env.ONES_HOSTED_BASE_URL;
@@ -8,10 +8,79 @@ const getONESHostedBaseUrl = () => {
 const getONESHostedAppID = () => {
   return process.env.ONES_HOSTED_APP_ID;
 };
-const index$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const getONESHostedToken = () => {
+  return process.env.ONES_HOSTED_TOKEN;
+};
+const index$2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   getONESHostedAppID,
-  getONESHostedBaseUrl
+  getONESHostedBaseUrl,
+  getONESHostedToken
+}, Symbol.toStringTag, { value: "Module" }));
+const ASSERTION_TTL_SECONDS = 24 * 60 * 60;
+const ASSERTION_JTI_LENGTH = 16;
+const TOKEN_GRANT_TYPE = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer";
+const fetch$2 = Fetch.create();
+const buildJWTAssertion = (installationInfo, userID) => {
+  const now = Math.floor(Date.now() / 1e3);
+  const header = {
+    alg: "HS256",
+    typ: "JWT"
+  };
+  const payload = {
+    uid: userID,
+    rsh: "",
+    iss: installationInfo.installation_id,
+    sub: installationInfo.installation_id,
+    aud: "oauth",
+    exp: now + ASSERTION_TTL_SECONDS,
+    iat: now,
+    jti: randomUUID().replace(/-/g, "").slice(0, ASSERTION_JTI_LENGTH)
+  };
+  const encodedHeader = Buffer.from(JSON.stringify(header)).toString("base64url");
+  const encodedPayload = Buffer.from(JSON.stringify(payload)).toString("base64url");
+  const signingInput = `${encodedHeader}.${encodedPayload}`;
+  const signKey = Buffer.from(installationInfo.shared_secret, "base64");
+  const signature = createHmac("sha256", signKey).update(signingInput).digest("base64url");
+  return `${signingInput}.${signature}`;
+};
+const getAccessTokenByInstallationInfo = async function(installationInfo) {
+  let userID = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "";
+  const assertion = buildJWTAssertion(installationInfo, userID);
+  const tokenURL = new URL("/oauth2/token", installationInfo.ones_base_url);
+  const formData = new URLSearchParams();
+  formData.set("grant_type", TOKEN_GRANT_TYPE);
+  formData.set("client_id", installationInfo.installation_id);
+  formData.set("assertion", assertion);
+  try {
+    const response = await fetch$2.post(tokenURL.toString(), formData.toString(), {
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded"
+      }
+    });
+    const token = response.data;
+    if (!token.access_token) {
+      throw new Error("failed to get access token: empty access_token in response");
+    }
+    return token.access_token;
+  } catch (error) {
+    if (error instanceof AxiosError) {
+      var _error$response, _error$response$statu, _error$response2, _error$response3;
+      const status = (_error$response = error.response) === null || _error$response === void 0 ? void 0 : _error$response.status;
+      const statusText = (_error$response$statu = (_error$response2 = error.response) === null || _error$response2 === void 0 ? void 0 : _error$response2.statusText) !== null && _error$response$statu !== void 0 ? _error$response$statu : "";
+      const data = (_error$response3 = error.response) === null || _error$response3 === void 0 ? void 0 : _error$response3.data;
+      const responseText = typeof data === "string" ? data : JSON.stringify(data);
+      throw new Error(`failed to get access token: ${status !== null && status !== void 0 ? status : "unknown"} ${statusText}, response: ${responseText}`);
+    }
+    throw error;
+  }
+};
+const oauth = {
+  getAccessTokenByInstallationInfo
+};
+const index$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  oauth
 }, Symbol.toStringTag, { value: "Module" }));
 var EntityWhereConditionEnum = /* @__PURE__ */ ((EntityWhereConditionEnum2) => {
   EntityWhereConditionEnum2["beginsWith"] = "beginsWith";
@@ -114,7 +183,7 @@ const createErrorResult = (code, message, error) => {
 };
 const fetch$1 = Fetch.create();
 const buildAuthHeaders$1 = () => {
-  const token = process.env.ONES_HOSTED_TOKEN;
+  const token = getONESHostedToken();
   if (token) {
     return {
       Authorization: `Bearer ${token}`
@@ -193,12 +262,12 @@ const defaultEntityQueryIndex = defaultEntityQuery.index;
 const defaultEntityQueryWhere = defaultEntityQuery.where;
 class EntityQueryClass {
   constructor(name) {
-    _defineProperty(this, "_name", "");
-    _defineProperty(this, "_cursor", [defaultEntityQueryCursor]);
-    _defineProperty(this, "_limit", [defaultEntityQueryLimit]);
-    _defineProperty(this, "_sort", [defaultEntityQuerySort]);
-    _defineProperty(this, "_index", [defaultEntityQueryIndex]);
-    _defineProperty(this, "_where", [defaultEntityQueryWhere]);
+    this._name = "";
+    this._cursor = [defaultEntityQueryCursor];
+    this._limit = [defaultEntityQueryLimit];
+    this._sort = [defaultEntityQuerySort];
+    this._index = [defaultEntityQueryIndex];
+    this._where = [defaultEntityQueryWhere];
     this._name = name;
   }
   cursor(cursor) {
@@ -292,7 +361,7 @@ class EntityQueryClass {
 }
 class EntityClass {
   constructor(name) {
-    _defineProperty(this, "_name", "");
+    this._name = "";
     this._name = name;
   }
   async get(key) {
@@ -398,11 +467,8 @@ var ObjectErrorCode = /* @__PURE__ */ ((ObjectErrorCode2) => {
   return ObjectErrorCode2;
 })(ObjectErrorCode || {});
 class ObjectError {
-  /**
-   * @description 错误载荷
-   */
   constructor(result) {
-    _defineProperty(this, "err_msg", "");
+    this.err_msg = "";
     this.code = result.code;
     this.err_msg = result.err_msg;
     this.err_values = result.err_values;
@@ -410,7 +476,7 @@ class ObjectError {
 }
 const fetch = Fetch.create();
 const buildAuthHeaders = () => {
-  const token = process.env.ONES_HOSTED_TOKEN;
+  const token = getONESHostedToken();
   if (token) {
     return {
       Authorization: `Bearer ${token}`
@@ -551,6 +617,7 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
 }, Symbol.toStringTag, { value: "Module" }));
 export {
   ErrorCode,
-  index$1 as env,
+  index$2 as env,
+  index$1 as oauth,
   index as storage
 };

package/dist/types/packages/node/index.d.ts

@@ -1,5 +1,7 @@
 export * as env from '../../packages/strict/env';
+export * as oauth from './oauth';
 export * as storage from './storage';
 export { ErrorCode } from '../../packages/strict/error';
 export type { Entity, EntityBatchSetItem, EntityQuery, EntityListResultData, EntityError, ObjectError, ObjectStoreUploadResult, ObjectStoreDownloadResult, } from './storage';
+export type { InstallationInfo, OAuthClient } from './oauth';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/packages/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packages/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAA;AAC5C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,YAAY,EACV,MAAM,EACN,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packages/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAChC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,YAAY,EACV,MAAM,EACN,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA"}

package/dist/types/packages/node/oauth/index.d.ts

@@ -0,0 +1,4 @@
+import type { OAuthClient } from './types';
+export type * from './types';
+export declare const oauth: OAuthClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packages/node/oauth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/packages/node/oauth/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,WAAW,EAAE,MAAM,SAAS,CAAA;AAE5D,mBAAmB,SAAS,CAAA;AA2F5B,eAAO,MAAM,KAAK,EAAE,WAEnB,CAAA"}

package/dist/types/packages/node/oauth/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @description Installation callback data used for token exchange
+ */
+export interface InstallationInfo {
+    /**
+     * @description Installation ID of the app
+     */
+    installation_id: string;
+    /**
+     * @description Base64 encoded installation shared secret
+     */
+    shared_secret: string;
+    /**
+     * @description ONES base URL of the installation
+     */
+    ones_base_url: string;
+}
+export interface OAuthClient {
+    /**
+     * @description Exchange installation info for an OAuth access token
+     * @param installationInfo Installation callback data
+     * @param userID User ID in the installation organization.
+     *               Empty string means requesting token as the app itself.
+     * @returns Access token
+     */
+    getAccessTokenByInstallationInfo(installationInfo: InstallationInfo, userID?: string): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/packages/node/oauth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/packages/node/oauth/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,gCAAgC,CAC9B,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAAA;CACnB"}

package/dist/types/packages/node/storage/entity/entity/types.d.ts

@@ -7,55 +7,55 @@ export type BaseIndexesStructValue = null | StringOrNumberOrBoolean[] | [StringO
 export type BaseIndexesStruct<IndexesStruct> = SetFieldType<IndexesStruct, keyof IndexesStruct, BaseIndexesStructValue>;
 export type UnionIndexesStruct<IndexesStruct> = BaseIndexesStruct<IndexesStruct> | EmptyObject | null;
 /**
- * @description 实体操作对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity operation object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export interface Entity<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends UnionIndexesStruct<IndexesStruct>> {
     /**
-     * @description 获取一条实体数据
-     * @param key 实体数据 key
-     * @returns 实体数据 value
+     * @description Get one entity record
+     * @param key Entity data key
+     * @returns Entity data value
      */
     get<Key extends string>(key: NotEmptyString<Key>): Promise<EntityStruct | undefined>;
     /**
-     * @description 创建或者更新一条实体数据
-     * @param key 实体数据 key
-     * @param value 实体数据 value
+     * @description Create or update one entity record
+     * @param key Entity data key
+     * @param value Entity data value
      */
     set<Key extends string>(key: NotEmptyString<Key>, value: Partial<EntityStruct>): Promise<void>;
     /**
-     * @description 删除一条实体数据
-     * @param key 实体数据 key
+     * @description Delete one entity record
+     * @param key Entity data key
      */
     delete<Key extends string>(key: NotEmptyString<Key>): Promise<void>;
     /**
-     * @description 创建实体查询对象
+     * @description Create entity query object
      * @returns EntityQuery
      */
     query(): IfNull<IndexesStruct, BaseEntityQuery<EntityStruct, EmptyObject>, IfEmptyObject<IndexesStruct, InputIndexEntityQuery<EntityStruct, EmptyObject>, InferIndexEntityQuery<EntityStruct, Exclude<IndexesStruct, EmptyObject | null>>>>;
     /**
-     * @description 批量创建或者更新实体数据
-     * @param items 数组
+     * @description Batch create or update entity data
+     * @param items Array of items
      */
     batchSet<Items extends EntityBatchSetItem<EntityStruct>[]>(items: NotEmptyArray<Items>): Promise<void>;
     /**
-     * @description 批量删除实体数据
-     * @param keys 实体数据 key 数组
+     * @description Batch delete entity data
+     * @param keys Array of entity data keys
      */
     batchDelete<Keys extends string[]>(keys: NotEmptyArray<Keys>): Promise<void>;
 }
 /**
- * @description 批量创建或者更新实体数据的 item
- * @typedef EntityStruct 实体数据结构体
+ * @description Item for batch create or update entity data
+ * @typedef EntityStruct Entity data structure
  */
 export interface EntityBatchSetItem<EntityStruct extends BaseEntityStruct<EntityStruct>> {
     /**
-     * @description 实体数据 key
+     * @description Entity data key
      */
     key: string;
     /**
-     * @description 实体数据 value
+     * @description Entity data value
      */
     value: Partial<EntityStruct>;
 }

package/dist/types/packages/node/storage/entity/error/consts.d.ts

@@ -1,126 +1,126 @@
 /**
  * @enum EntityErrorCode
- * @description 实体错误码枚举
+ * @description Entity error code enum
  */
 export declare enum EntityErrorCode {
     /**
-     * @description 实体名称为空/包含非法字符/超出最大长度限制
+     * @description Entity name is empty / contains invalid characters / exceeds max length
      * @satisfies /^[_a-z0-9]{1,32}$/
      */
     EntityNameInvalid = "EntityNameInvalid",
     /**
-     * @description 实体名称不存在（配置未定义）
+     * @description Entity name does not exist (not defined in config)
      */
     EntityNotFound = "EntityNotFound",
     /**
-     * @description 实体数据不能为空
+     * @description Entity data cannot be empty
      */
     EntityDataEmpty = "EntityDataEmpty",
     /**
-     * @description 实体数据过多
+     * @description Too many entity data items
      * @satisfies maximum 100 items
      */
     EntityDataBatchLimit = "EntityDataBatchLimit",
     /**
-     * @description key 为空/包含非法字符/超出最大长度限制
+     * @description key is empty / contains invalid characters / exceeds max length
      * @satisfies /^[_a-z0-9]{1,64}$/
      */
     EntityDataKeyInvalid = "EntityDataKeyInvalid",
     /**
-     * @description key 重复
+     * @description Duplicate key
      */
     EntityDataKeyDuplicate = "EntityDataKeyDuplicate",
     /**
-     * @description 属性名为空/包含非法字符/超出最大长度限制
+     * @description Attribute name is empty / contains invalid characters / exceeds max length
      * @satisfies /^[_a-z0-9]{1,64}$/
      */
     EntityDataValueAttrInvalid = "EntityDataValueAttrInvalid",
     /**
-     * @description 属性名不存在（配置未定义）
+     * @description Attribute name does not exist (not defined in config)
      */
     EntityDataValueAttrNotFound = "EntityDataValueAttrNotFound",
     /**
-     * @description 值不能为空
+     * @description Value cannot be empty
      */
     EntityDataValueEmpty = "EntityDataValueEmpty",
     /**
-     * @description 值非法
+     * @description Invalid value
      */
     EntityDataValueInvalid = "EntityDataValueInvalid",
     /**
-     * @description string 类型的属性的值超出最大长度限制
+     * @description Value of string attribute exceeds max length
      */
     EntityDataStringValueTooLong = "EntityDataStringValueTooLong",
     /**
-     * @description text 类型的属性的值超出最大长度限制
+     * @description Value of text attribute exceeds max length
      * @satisfies maximum 32768 characters
      */
     EntityDataTextValueTooLong = "EntityDataTextValueTooLong",
     /**
-     * @description 缺少必填属性
+     * @description Missing required attribute
      */
     EntityDataAttrRequired = "EntityDataAttrRequired",
     /**
-     * @description 属性值的类型与定义的类型不匹配
+     * @description Attribute value type does not match definition
      */
     EntityDataValueTypeInvalid = "EntityDataValueTypeInvalid",
     /**
-     * @description 索引不能为空
+     * @description Index cannot be empty
      */
     EntityDataIndexEmpty = "EntityDataIndexEmpty",
     /**
-     * @description 索引为空/包含非法字符/超出最大长度限制
+     * @description Index is empty / contains invalid characters / exceeds max length
      * @satisfies /^[_a-z0-9]{1,64}$/
      */
     EntityDataIndexNameInvalid = "EntityDataIndexNameInvalid",
     /**
-     * @description 索引不存在（配置未定义）
+     * @description Index does not exist (not defined in config)
      */
     EntityDataIndexNotFound = "EntityDataIndexNotFound",
     /**
-     * @description 自定义索引中的属性值为空/非法
+     * @description Attribute value in custom index is empty or invalid
      */
     EntityDataPartitionValueInvalid = "EntityDataPartitionValueInvalid",
     /**
-     * @description 自定义索引中的属性值的类型与定义的类型不匹配
+     * @description Attribute value type in custom index does not match definition
      */
     EntityDataPartitionValueTypeInvalid = "EntityDataPartitionValueTypeInvalid",
     /**
-     * @description 自定义索引中的属性值超出最大长度限制
+     * @description Attribute value in custom index exceeds max length
      */
     EntityDataPartitionValueTooLong = "EntityDataPartitionValueTooLong",
     /**
-     * @description 数据存在唯一性约束错误
+     * @description Unique constraint violation
      */
     EntityDataUniqueConstraintFailed = "EntityDataUniqueConstraintFailed",
     /**
-     * @description 实体查询条件的子句的属性值类型不匹配
+     * @description Attribute value type in entity query condition clause does not match
      */
     EntityDataWhereConditionValueTypeInvalid = "EntityDataWhereConditionValueTypeInvalid",
     /**
-     * @description 实体查询条件的子句的属性值超出最大长度限制
+     * @description Attribute value in entity query condition clause exceeds max length
      */
     EntityDataWhereConditionValueTooLong = "EntityDataWhereConditionValueTooLong",
     /**
-     * @description 实体查询的游标的值非法
+     * @description Entity query cursor value is invalid
      */
     EntityDataPageCursorInvalid = "EntityDataPageCursorInvalid",
     /**
-     * @description 实体查询的排序的值非法
+     * @description Entity query sort value is invalid
      * @satisfies EntitySortEnum
      */
     EntityDataSortValueInvalid = "EntityDataSortValueInvalid",
     /**
-     * @description 实体查询的分页长度的值非法
+     * @description Entity query page limit value is invalid
      * @satisfies [1, 1000]
      */
     EntityDataPageLimitNotInRange = "EntityDataPageLimitNotInRange",
     /**
-     * @description 实体操作或者查询超时
+     * @description Entity operation or query timeout
      */
     EntityDataAPITimeOut = "EntityDataAPITimeOut",
     /**
-     * @description JSON 序列化失败
+     * @description JSON serialization failed
      */
     MalformedJSON = "Malformed.JSON"
 }

package/dist/types/packages/node/storage/entity/index.d.ts

@@ -9,7 +9,7 @@ export type * from './types';
 /**
  * @constant entity
  * @function EntityFactory
- * @description 实体
+ * @description Entity
  * @member Sort
  * @member EntityErrorCode
  * @member WhereConditions

package/dist/types/packages/node/storage/entity/query/types.d.ts

@@ -7,147 +7,147 @@ import type { BaseEntityStruct, BaseIndexesStruct, BaseIndexesStructValue } from
 import type { defaultEntityQueryCursor, defaultEntityQueryLimit, defaultEntityQuerySort, defaultEntityQueryIndex, defaultEntityQueryWhere } from './consts';
 export type LimitNumber = IntClosedRange<1, 998> | 999 | 1000;
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export interface BaseEntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> {
     /**
-     * @description 设置实体查询游标
-     * @param cursor 游标
+     * @description Set entity query cursor
+     * @param cursor Cursor
      * @returns EntityQuery
      */
     cursor(cursor: string | typeof defaultEntityQueryCursor): BaseEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 设置实体查询长度
+     * @description Set entity query limit
      * @satisfies [1, 1000]
-     * @param limit 长度
+     * @param limit Limit
      * @returns EntityQuery
      */
     limit(limit: LimitNumber | typeof defaultEntityQueryLimit): BaseEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 设置实体查询排序
-     * @param sort 排序
+     * @description Set entity query sort order
+     * @param sort Sort order
      * @returns EntityQuery
      */
     sort(sort: EntitySortEnum | typeof defaultEntityQuerySort): BaseEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 获取一条实体数据
-     * @returns 实体数据 value
+     * @description Get one entity record
+     * @returns Entity data value
      */
     getOne(): Promise<EntityResultData<EntityStruct> | undefined>;
     /**
-     * @description 获取实体数据数组
-     * @returns 实体数据分页查询结果对象
+     * @description Get entity data array
+     * @returns Entity data paginated query result object
      */
     getMany(): Promise<EntityListResultData<EntityStruct>>;
     /**
-     * @description 获取实体数据总数
-     * @returns 实体数据总数
+     * @description Get total count of entity data
+     * @returns Total count
      */
     count(): Promise<number>;
 }
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export interface InferIndexEntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> extends BaseEntityQuery<EntityStruct, IndexesStruct> {
     cursor: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['cursor'], InferIndexEntityQuery<EntityStruct, IndexesStruct>>;
     limit: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['limit'], InferIndexEntityQuery<EntityStruct, IndexesStruct>>;
     sort: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['sort'], InferIndexEntityQuery<EntityStruct, IndexesStruct>>;
     /**
-     * @description 设置实体查询索引
-     * @param index 索引
-     * @param partitions 索引分区的属性值
+     * @description Set entity query index
+     * @param index Index
+     * @param partitions Partition attribute values of the index
      * @returns EntityQuery
      */
     index<IndexKey extends keyof ConditionalExcept<IndexesStruct, null>>(index: IndexKey, partitions: IndexesStruct[IndexKey]): InferWhereEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 设置实体查询索引
-     * @param index 索引
+     * @description Set entity query index
+     * @param index Index
      * @returns EntityQuery
      */
     index<IndexKey extends keyof ConditionalPick<IndexesStruct, null>>(index: IndexKey): InferWhereEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 设置实体查询索引
-     * @param index 索引
+     * @description Set entity query index
+     * @param index Index
      * @returns EntityQuery
      */
     index(index: typeof defaultEntityQueryIndex): InferWhereEntityQuery<EntityStruct, IndexesStruct>;
 }
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export interface InputIndexEntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> extends BaseEntityQuery<EntityStruct, IndexesStruct> {
     cursor: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['cursor'], InputIndexEntityQuery<EntityStruct, IndexesStruct>>;
     limit: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['limit'], InputIndexEntityQuery<EntityStruct, IndexesStruct>>;
     sort: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['sort'], InputIndexEntityQuery<EntityStruct, IndexesStruct>>;
     /**
-     * @description 设置实体查询索引
-     * @typedef Partitions 索引分区的属性值类型
-     * @param index 索引
-     * @param partitions 索引分区的属性值
+     * @description Set entity query index
+     * @typedef Partitions Partition attribute value type of index
+     * @param index Index
+     * @param partitions Partition attribute values of the index
      * @returns EntityQuery
      */
     index<Partitions extends BaseIndexesStructValue>(index: string, partitions: Partitions): InputWhereEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 设置实体查询索引
-     * @param index 索引
+     * @description Set entity query index
+     * @param index Index
      * @returns EntityQuery
      */
     index(index: string): InputWhereEntityQuery<EntityStruct, IndexesStruct>;
     /**
-     * @description 设置实体查询索引
-     * @param index 索引
+     * @description Set entity query index
+     * @param index Index
      * @returns EntityQuery
      */
     index(index: typeof defaultEntityQueryIndex): InputWhereEntityQuery<EntityStruct, IndexesStruct>;
 }
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export interface InferWhereEntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> extends InferIndexEntityQuery<EntityStruct, IndexesStruct> {
     cursor: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['cursor'], InferWhereEntityQuery<EntityStruct, IndexesStruct>>;
     limit: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['limit'], InferWhereEntityQuery<EntityStruct, IndexesStruct>>;
     sort: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['sort'], InferWhereEntityQuery<EntityStruct, IndexesStruct>>;
     /**
-     * @description 设置实体查询条件
-     * @param condition 条件
+     * @description Set entity query condition
+     * @param condition Condition
      * @returns EntityQuery
      */
     where(condition: EntityWhereCondition | typeof defaultEntityQueryWhere): InferWhereEntityQuery<EntityStruct, IndexesStruct>;
 }
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export interface InputWhereEntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> extends InputIndexEntityQuery<EntityStruct, IndexesStruct> {
     cursor: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['cursor'], InputWhereEntityQuery<EntityStruct, IndexesStruct>>;
     limit: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['limit'], InputWhereEntityQuery<EntityStruct, IndexesStruct>>;
     sort: SetReturnType<BaseEntityQuery<EntityStruct, IndexesStruct>['sort'], InputWhereEntityQuery<EntityStruct, IndexesStruct>>;
     /**
-     * @description 设置实体查询条件
-     * @param condition 条件
+     * @description Set entity query condition
+     * @param condition Condition
      * @returns EntityQuery
      */
     where(condition: EntityWhereCondition | typeof defaultEntityQueryWhere): InputWhereEntityQuery<EntityStruct, IndexesStruct>;
 }
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export type UnionEntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> = BaseEntityQuery<EntityStruct, IndexesStruct> | InferIndexEntityQuery<EntityStruct, IndexesStruct> | InputIndexEntityQuery<EntityStruct, IndexesStruct> | InferWhereEntityQuery<EntityStruct, IndexesStruct> | InputWhereEntityQuery<EntityStruct, IndexesStruct>;
 /**
- * @description 实体查询对象
- * @typedef EntityStruct 实体数据结构体
- * @typedef IndexesStruct 实体索引结构体
+ * @description Entity query object
+ * @typedef EntityStruct Entity data structure
+ * @typedef IndexesStruct Entity index structure
  */
 export type EntityQuery<EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>> = UnionToIntersection<UnionEntityQuery<EntityStruct, IndexesStruct>>;
 export interface DefaultEntityQuery {

package/dist/types/packages/node/storage/entity/result/types.d.ts

@@ -6,48 +6,48 @@ export type EntityCountResult = EntityResult<{
 }>;
 export type EntityListResult<EntityStruct> = EntityResult<EntityListResultData<EntityStruct>>;
 /**
- * @description 实体数据查询结果对象
- * @typedef EntityStruct 实体数据结构体
+ * @description Entity data query result object
+ * @typedef EntityStruct Entity data structure
  */
 export interface EntityResultData<EntityStruct> {
     /**
-     * @description 数据 key
+     * @description Data key
      */
     key: string;
     /**
-     * @description 数据 value
+     * @description Data value
      */
     value: EntityStruct;
 }
 /**
- * @description 实体数据分页查询结果对象
- * @typedef EntityStruct 实体数据结构体
+ * @description Entity data paginated query result object
+ * @typedef EntityStruct Entity data structure
  */
 export interface EntityListResultData<EntityStruct> {
     /**
-     * @description 分页信息
+     * @description Pagination info
      */
     page_info: {
         /**
-         * @description 当前分页数据总数
+         * @description Total count of current page
          */
         count: number;
         /**
-         * @description 是否有更多数据
+         * @description Whether there is more data
          */
         has_more: boolean;
         /**
-         * @description 当前分页末尾数据游标
+         * @description Cursor at end of current page
          */
         end_cursor: string;
     };
     /**
-     * @description 分页数据数组
+     * @description Paginated data array
      */
     data: EntityResultData<EntityStruct>[];
 }
 /**
- * @description 实体查询或者操作错误对象
+ * @description Entity query or operation error object
  */
 export type EntityError = ErrorResult<never, EntityErrorCode>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types/packages/node/storage/entity/sort/consts.d.ts

@@ -1,14 +1,14 @@
 /**
  * @enum EntitySortEnum
- * @description 实体排序枚举
+ * @description Entity sort order enum
  */
 export declare enum EntitySortEnum {
     /**
-     * @description 正序
+     * @description Ascending
      */
     ASC = "ASC",
     /**
-     * @description 倒序
+     * @description Descending
      */
     DESC = "DESC"
 }

package/dist/types/packages/node/storage/entity/types.d.ts

@@ -6,40 +6,40 @@ import type { Entity, BaseEntityStruct, BaseIndexesStruct } from './entity';
 import type { defaultEntityQueryCursor, defaultEntityQueryIndex, defaultEntityQueryLimit, defaultEntityQuerySort, defaultEntityQueryWhere } from './query';
 export interface EntityStatic {
     /**
-     * @description 实体排序枚举
+     * @description Entity sort order enum
      */
     Sort: typeof EntitySortEnum;
     /**
-     * @description 实体错误码枚举
+     * @description Entity error code enum
      */
     EntityErrorCode: typeof EntityErrorCode;
     /**
-     * @description 实体查询条件方法枚举
+     * @description Entity query condition method enum
      */
     WhereConditions: typeof WhereConditions;
     /**
-     * @description 实体查询游标默认值
+     * @description Default entity query cursor
      */
     defaultEntityQueryCursor: typeof defaultEntityQueryCursor;
     /**
-     * @description 实体查询索引默认值
+     * @description Default entity query index
      */
     defaultEntityQueryIndex: typeof defaultEntityQueryIndex;
     /**
-     * @description 实体查询长度默认值
+     * @description Default entity query limit
      */
     defaultEntityQueryLimit: typeof defaultEntityQueryLimit;
     /**
-     * @description 实体查询排序默认值
+     * @description Default entity query sort
      */
     defaultEntityQuerySort: typeof defaultEntityQuerySort;
     /**
-     * @description 实体查询条件默认值
+     * @description Default entity query condition
      */
     defaultEntityQueryWhere: typeof defaultEntityQueryWhere;
 }
 /**
- * @description 编译时自动生成
+ * @description Auto-generated at compile time
  * @example
  * declare global {
  *   var ONESEntities: {
@@ -61,19 +61,19 @@ type PluginEntities = FindGlobalType<'ONESEntities'>;
 export interface BaseEntityFactory {
     /**
      * @function EntityFactory
-     * @description 创建实体操作对象
-     * @typedef EntityStruct 实体数据结构体
-     * @typedef IndexesStruct 实体索引结构体
-     * @param entityName 实体名称
+     * @description Create entity operation object
+     * @typedef EntityStruct Entity data structure
+     * @typedef IndexesStruct Entity index structure
+     * @param entityName Entity name
      * @returns Entity
      */
     <EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>>(entityName: string): Entity<EntityStruct, IndexesStruct>;
     /**
      * @function EntityFactory
-     * @description 创建实体操作对象
-     * @typedef EntityStruct 实体数据结构体
-     * @typedef IndexesStruct 实体索引结构体
-     * @param entityName 实体名称
+     * @description Create entity operation object
+     * @typedef EntityStruct Entity data structure
+     * @typedef IndexesStruct Entity index structure
+     * @param entityName Entity name
      * @returns Entity
      */
     <EntityStruct extends BaseEntityStruct<EntityStruct>>(entityName: string): Entity<EntityStruct, EmptyObject>;
@@ -81,28 +81,28 @@ export interface BaseEntityFactory {
 export interface PluginEntityFactory {
     /**
      * @function EntityFactory
-     * @description 创建实体操作对象
-     * @typedef EntityStruct 实体数据结构体
-     * @typedef IndexesStruct 实体索引结构体
-     * @param entityName 实体名称
+     * @description Create entity operation object
+     * @typedef EntityStruct Entity data structure
+     * @typedef IndexesStruct Entity index structure
+     * @param entityName Entity name
      * @returns Entity
      */
     <EntityName extends keyof PluginEntities>(entityName: EntityName): Entity<Get<PluginEntities, Exclude<EntityName, number | symbol>>['attributes'], Get<PluginEntities, Exclude<EntityName, number | symbol>>['indexes']>;
     /**
      * @function EntityFactory
-     * @description 创建实体操作对象
-     * @typedef EntityStruct 实体数据结构体
-     * @typedef IndexesStruct 实体索引结构体
-     * @param entityName 实体名称
+     * @description Create entity operation object
+     * @typedef EntityStruct Entity data structure
+     * @typedef IndexesStruct Entity index structure
+     * @param entityName Entity name
      * @returns Entity
      */
     <EntityStruct extends BaseEntityStruct<EntityStruct>, IndexesStruct extends BaseIndexesStruct<IndexesStruct>>(entityName: string): Entity<EntityStruct, IndexesStruct>;
     /**
      * @function EntityFactory
-     * @description 创建实体操作对象
-     * @typedef EntityStruct 实体数据结构体
-     * @typedef IndexesStruct 实体索引结构体
-     * @param entityName 实体名称
+     * @description Create entity operation object
+     * @typedef EntityStruct Entity data structure
+     * @typedef IndexesStruct Entity index structure
+     * @param entityName Entity name
      * @returns Entity
      */
     <EntityStruct extends BaseEntityStruct<EntityStruct>>(entityName: string): Entity<EntityStruct, EmptyObject>;

package/dist/types/packages/node/storage/entity/where/index.d.ts

@@ -3,7 +3,7 @@ export * from './consts';
 export * from './types';
 /**
  * @constant WhereConditions
- * @description 实体查询条件方法枚举
+ * @description Entity query condition method enum
  */
 export declare const WhereConditions: {
     /**

package/dist/types/packages/node/storage/object/error/consts.d.ts

@@ -1,19 +1,19 @@
 /**
  * @enum ObjectErrorCode
- * @description 对象存储错误码枚举
+ * @description Object storage error code enum
  */
 export declare enum ObjectErrorCode {
     /**
-     * @description 对象存储 key 为空/包含非法字符/超出最大长度限制
+     * @description Object storage key is empty / contains invalid characters / exceeds max length
      * @satisfies /^[0-9a-zA-Z!_.*'()-]{1,128}$/
      */
     ObjectKeyInvalid = "ObjectKeyInvalid",
     /**
-     * @description 对象存储 key 不存在
+     * @description Object storage key does not exist
      */
     ObjectKeyNotfound = "ObjectKeyNotfound",
     /**
-     * @description 请求超时
+     * @description Request timeout
      */
     RequestTimeOut = "RequestTimeOut"
 }

package/dist/types/packages/node/storage/object/error/index.d.ts

@@ -2,19 +2,19 @@ import type { ObjectErrorResult } from './types';
 export * from './consts';
 export * from './types';
 /**
- * @description 对象存储操作错误对象
+ * @description Object storage operation error object
  */
 export declare class ObjectError implements ObjectErrorResult {
     /**
-     * @description 错误码枚举
+     * @description Error code enum
      */
     code: import("../../..").ErrorCode | import("./consts").ObjectErrorCode;
     /**
-     * @description 错误文案
+     * @description Error message
      */
     err_msg: string;
     /**
-     * @description 错误载荷
+     * @description Error payload
      */
     err_values: Record<string, any> | undefined;
     constructor(result: ObjectErrorResult);

package/dist/types/packages/node/storage/object/index.d.ts

@@ -5,7 +5,7 @@ export type * from './result';
 export type * from './types';
 /**
  * @constant object
- * @description 对象存储
+ * @description Object storage
  * @member ObjectError
  * @member ObjectErrorCode
  * @member upload

package/dist/types/packages/node/storage/object/result/types.d.ts

@@ -15,15 +15,15 @@ export type ObjectDownloadResult = ObjectResult<{
 }>;
 export type ObjectDeleteResult = ObjectResult<never>;
 /**
- * @description 对象的元信息的结果对象
+ * @description Result object for object metadata
  */
 export interface ObjectMetadataResultData {
     /**
-     * @description 对象存储 key
+     * @description Object storage key
      */
     object_key: string;
     /**
-     * @description 文件大小，字节
+     * @description File size in bytes
      */
     size: number;
 }

package/dist/types/packages/node/storage/object/types.d.ts

@@ -1,64 +1,64 @@
 import type { ObjectError, ObjectErrorCode } from './error';
 import type { ObjectResultDataFields, ObjectMetadataResultData } from './result';
 /**
- * @description 获取上传信息的操作对象
+ * @description Operation object for getting upload info
  */
 export interface ObjectStoreUploadResult {
     /**
-     * @description 获取上传地址（需要在插件后端请求）
+     * @description Get upload URL (must be requested from plugin backend)
      */
     getUrl(): string;
     /**
-     * @description 获取上传地址（适合在浏览器中请求）
+     * @description Get upload URL (suitable for browser requests)
      */
     getWebUrl(): string;
     /**
-     * @description 获取请求的 FormData 参数
+     * @description Get FormData parameters for the request
      */
     getFields(): ObjectResultDataFields;
 }
 /**
- * @description 获取下载信息的操作对象
+ * @description Operation object for getting download info
  */
 export interface ObjectStoreDownloadResult {
     /**
-     * @description 获取下载地址（需要在插件后端请求）
+     * @description Get download URL (must be requested from plugin backend)
      */
     getUrl(): string;
     /**
-     * @description 获取下载地址（适合在浏览器中请求）
+     * @description Get download URL (suitable for browser requests)
      */
     getWebUrl(): string;
 }
 export interface ObjectStore {
     /**
-     * @description 对象存储操作错误对象
+     * @description Object storage operation error object
      */
     ObjectError: typeof ObjectError;
     /**
-     * @description 对象存储错误码枚举
+     * @description Object storage error code enum
      */
     ObjectErrorCode: typeof ObjectErrorCode;
     /**
-     * @description 上传一个对象
-     * @param key 对象存储 key
+     * @description Upload an object
+     * @param key Object storage key
      * @returns ObjectStoreUploadResult
      */
     upload(key: string): Promise<ObjectStoreUploadResult | ObjectError>;
     /**
-     * @description 下载一个对象
-     * @param key 对象存储 key
+     * @description Download an object
+     * @param key Object storage key
      * @returns ObjectStoreDownloadResult
      */
     download(key: string): Promise<ObjectStoreDownloadResult | ObjectError>;
     /**
-     * @description 删除一个对象
-     * @param key 对象存储 key
+     * @description Delete an object
+     * @param key Object storage key
      */
     delete(key: string): Promise<void | ObjectError>;
     /**
-     * @description 获取一个对象的元信息
-     * @param key 对象存储 key
+     * @description Get metadata of an object
+     * @param key Object storage key
      * @returns ObjectMetadataResultData
      */
     metadata(key: string): Promise<ObjectMetadataResultData | ObjectError>;

package/dist/types/packages/strict/env/index.d.ts

@@ -1,13 +1,19 @@
 /**
- * @description 获取开放平台 host
+ * @description Get the open platform base URL
  * @alias getONESHostedBaseUrl
- * @returns onesHostedBaseUrl
+ * @returns ONES_HOSTED_BASE_URL
  */
 export declare const getONESHostedBaseUrl: () => string | undefined;
 /**
- * @description 获取插件实例 ID
+ * @description Get the app instance ID
  * @alias getONESHostedAppID
- * @returns onesHostedAppID
+ * @returns ONES_HOSTED_APP_ID
  */
 export declare const getONESHostedAppID: () => string | undefined;
+/**
+ * @description Get the app hosted token
+ * @alias getONESHostedToken
+ * @returns ONES_HOSTED_TOKEN
+ */
+export declare const getONESHostedToken: () => string | undefined;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/packages/strict/env/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/packages/strict/env/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,0BAEhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,0BAE9B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/packages/strict/env/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,0BAEhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,0BAE9B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,0BAE9B,CAAA"}

package/dist/types/packages/strict/result/types.d.ts

@@ -1,29 +1,29 @@
 import type { ErrorCode } from '../../../packages/strict/error';
 export interface SuccessResult<Data> {
     /**
-     * @description 请求成功
+     * @description Request succeeded
      */
     code: 'OK';
     /**
-     * @description 请求响应体
+     * @description Response body
      */
     data?: Data;
 }
 export interface ErrorResult<Data, Code> {
     /**
-     * @description 错误码枚举
+     * @description Error code enum
      */
     code: Code | ErrorCode;
     /**
-     * @description 请求响应体
+     * @description Response body
      */
     data?: Data;
     /**
-     * @description 错误文案
+     * @description Error message
      */
     err_msg: string;
     /**
-     * @description 错误载荷
+     * @description Error payload
      */
     err_values?: Record<string, any>;
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@ones-open/node-sdk",
-  "version": "0.0.4-15682.67+25193e25",
+  "version": "0.0.4-16644.216+5b8986c9",
   "description": "",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
@@ -50,5 +50,5 @@
   "devDependencies": {
     "@types/lodash-es": "^4.17.12"
   },
-  "gitHead": "25193e2521e5eee2613c7d69e9e9b6364135482e"
+  "gitHead": "5b8986c971f7a93045070b6cede500665522199a"
 }