@brix-sdk/platform-shared 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# @brix-sdk/platform-shared
+
+> Shared utilities for Brix Platform capabilities
+
+## Overview
+
+This package provides shared utilities, types, and helpers used across Brix Platform capability implementations.
+
+## Features
+
+- Common utility functions
+- Shared type definitions
+- Error handling utilities
+- Logging helpers
+- Validation utilities
+
+## Installation
+
+```bash
+npm install @brix-sdk/platform-shared
+```
+
+## Usage
+
+```typescript
+import {
+  createLogger,
+  validateConfig,
+  formatError,
+  deepMerge
+} from '@brix-sdk/platform-shared';
+
+// Create a namespaced logger
+const logger = createLogger('my-capability');
+logger.info('Capability initialized');
+logger.error('Something went wrong', error);
+
+// Validate configuration
+const config = validateConfig(userConfig, schema);
+
+// Deep merge objects
+const merged = deepMerge(defaults, overrides);
+```
+
+## Utilities
+
+| Utility | Description |
+|---------|-------------|
+| `createLogger` | Namespaced logging with levels |
+| `validateConfig` | JSON schema validation |
+| `formatError` | Error formatting and serialization |
+| `deepMerge` | Deep object merging |
+| `debounce` | Function debouncing |
+| `throttle` | Function throttling |
+
+## License
+
+Apache-2.0

package/dist/chunk-4CV4JOE5.js

@@ -0,0 +1,24 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+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);
+
+export { __esm, __export, __toCommonJS };
+//# sourceMappingURL=chunk-4CV4JOE5.js.map
+//# sourceMappingURL=chunk-4CV4JOE5.js.map

package/dist/chunk-4CV4JOE5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-4CV4JOE5.js"}

package/dist/chunk-5CQ3FANY.js

@@ -0,0 +1,162 @@
+// src/constants/platform.ts
+var PLATFORM_VERSION = "3.0.0";
+var CAPABILITY_PREFIX = "brix";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_RETRY_COUNT = 3;
+var DEFAULT_RETRY_DELAY = 1e3;
+var MAX_EVENT_HISTORY = 100;
+var STORAGE_KEY_PREFIX = "shinwa:";
+var STORAGE_KEYS = {
+  /**
+   * Locale setting
+   */
+  LOCALE: `${STORAGE_KEY_PREFIX}locale`,
+  /**
+   * Theme setting
+   */
+  THEME: `${STORAGE_KEY_PREFIX}theme`,
+  /**
+   * User preferences
+   */
+  PREFERENCES: `${STORAGE_KEY_PREFIX}preferences`,
+  /**
+   * Authentication token
+   */
+  AUTH_TOKEN: `${STORAGE_KEY_PREFIX}auth:token`,
+  /**
+   * Refresh token
+   */
+  REFRESH_TOKEN: `${STORAGE_KEY_PREFIX}auth:refresh`
+};
+var HTTP_METHODS = {
+  GET: "GET",
+  POST: "POST",
+  PUT: "PUT",
+  PATCH: "PATCH",
+  DELETE: "DELETE",
+  HEAD: "HEAD",
+  OPTIONS: "OPTIONS"
+};
+var HTTP_STATUS = {
+  OK: 200,
+  CREATED: 201,
+  NO_CONTENT: 204,
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  CONFLICT: 409,
+  UNPROCESSABLE_ENTITY: 422,
+  TOO_MANY_REQUESTS: 429,
+  INTERNAL_SERVER_ERROR: 500,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503
+};
+
+// src/constants/errors.ts
+var COMMON_ERROR_CODES = {
+  /**
+   * Unknown error
+   */
+  UNKNOWN: "ERR_UNKNOWN",
+  /**
+   * Invalid parameters
+   */
+  INVALID_PARAMS: "ERR_INVALID_PARAMS",
+  /**
+   * Operation timeout
+   */
+  TIMEOUT: "ERR_TIMEOUT",
+  /**
+   * Network error
+   */
+  NETWORK: "ERR_NETWORK",
+  /**
+   * Operation cancelled
+   */
+  CANCELLED: "ERR_CANCELLED",
+  /**
+   * Resource not found
+   */
+  NOT_FOUND: "ERR_NOT_FOUND",
+  /**
+   * Resource already exists
+   */
+  ALREADY_EXISTS: "ERR_ALREADY_EXISTS"
+};
+var AUTH_ERROR_CODES = {
+  /**
+   * Not authenticated
+   */
+  UNAUTHENTICATED: "ERR_AUTH_UNAUTHENTICATED",
+  /**
+   * Unauthorized
+   */
+  UNAUTHORIZED: "ERR_AUTH_UNAUTHORIZED",
+  /**
+   * Invalid token
+   */
+  INVALID_TOKEN: "ERR_AUTH_INVALID_TOKEN",
+  /**
+   * Token expired
+   */
+  TOKEN_EXPIRED: "ERR_AUTH_TOKEN_EXPIRED",
+  /**
+   * Session expired
+   */
+  SESSION_EXPIRED: "ERR_AUTH_SESSION_EXPIRED",
+  /**
+   * Refresh token failed
+   */
+  REFRESH_FAILED: "ERR_AUTH_REFRESH_FAILED"
+};
+var NAVIGATION_ERROR_CODES = {
+  /**
+   * Page not found
+   */
+  PAGE_NOT_FOUND: "ERR_NAV_PAGE_NOT_FOUND",
+  /**
+   * Navigation blocked
+   */
+  NAVIGATION_BLOCKED: "ERR_NAV_BLOCKED",
+  /**
+   * Permission denied
+   */
+  PERMISSION_DENIED: "ERR_NAV_PERMISSION_DENIED",
+  /**
+   * Invalid page ID
+   */
+  INVALID_PAGE_ID: "ERR_NAV_INVALID_PAGE_ID"
+};
+var PLUGIN_ERROR_CODES = {
+  /**
+   * Plugin load failed
+   */
+  LOAD_FAILED: "ERR_PLUGIN_LOAD_FAILED",
+  /**
+   * Plugin initialization failed
+   */
+  INIT_FAILED: "ERR_PLUGIN_INIT_FAILED",
+  /**
+   * Plugin not found
+   */
+  NOT_FOUND: "ERR_PLUGIN_NOT_FOUND",
+  /**
+   * Plugin version incompatible
+   */
+  VERSION_MISMATCH: "ERR_PLUGIN_VERSION_MISMATCH",
+  /**
+   * Plugin dependency missing
+   */
+  MISSING_DEPENDENCY: "ERR_PLUGIN_MISSING_DEPENDENCY"
+};
+var ERROR_CODES = {
+  ...COMMON_ERROR_CODES,
+  ...AUTH_ERROR_CODES,
+  ...NAVIGATION_ERROR_CODES,
+  ...PLUGIN_ERROR_CODES
+};
+
+export { AUTH_ERROR_CODES, CAPABILITY_PREFIX, COMMON_ERROR_CODES, DEFAULT_RETRY_COUNT, DEFAULT_RETRY_DELAY, DEFAULT_TIMEOUT, ERROR_CODES, HTTP_METHODS, HTTP_STATUS, MAX_EVENT_HISTORY, NAVIGATION_ERROR_CODES, PLATFORM_VERSION, PLUGIN_ERROR_CODES, STORAGE_KEYS, STORAGE_KEY_PREFIX };
+//# sourceMappingURL=chunk-5CQ3FANY.js.map
+//# sourceMappingURL=chunk-5CQ3FANY.js.map

package/dist/chunk-5CQ3FANY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/platform.ts","../src/constants/errors.ts"],"names":[],"mappings":"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","file":"chunk-5CQ3FANY.js","sourcesContent":["/**\r\n * Copyright 2026 Brix Platform Authors\r\n *\r\n * Licensed under the Apache License, Version 2.0 (the \"License\");\r\n * you may not use this file except in compliance with the License.\r\n * You may obtain a copy of the License at\r\n *\r\n *     http://www.apache.org/licenses/LICENSE-2.0\r\n *\r\n * Unless required by applicable law or agreed to in writing, software\r\n * distributed under the License is distributed on an \"AS IS\" BASIS,\r\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n * See the License for the specific language governing permissions and\r\n * limitations under the License.\r\n */\r\n/**\r\n * @file Platform constants definitions\r\n * @description Cross-platform shared platform constants\r\n * @module @brix/platform-shared/constants/platform\r\n * @version 3.0.0\r\n */\r\n\r\n/**\r\n * Platform version number\r\n */\r\nexport const PLATFORM_VERSION = '3.0.0';\r\n\r\n/**\r\n * Capability type prefix\r\n */\r\nexport const CAPABILITY_PREFIX = 'brix';\r\n\r\n/**\r\n * Default timeout in milliseconds\r\n */\r\nexport const DEFAULT_TIMEOUT = 30000;\r\n\r\n/**\r\n * Default retry count\r\n */\r\nexport const DEFAULT_RETRY_COUNT = 3;\r\n\r\n/**\r\n * Default retry delay in milliseconds\r\n */\r\nexport const DEFAULT_RETRY_DELAY = 1000;\r\n\r\n/**\r\n * Maximum event history record count\r\n */\r\nexport const MAX_EVENT_HISTORY = 100;\r\n\r\n/**\r\n * Storage key prefix\r\n */\r\nexport const STORAGE_KEY_PREFIX = 'shinwa:';\r\n\r\n/**\r\n * Storage keys\r\n */\r\nexport const STORAGE_KEYS = {\r\n  /**\r\n   * Locale setting\r\n   */\r\n  LOCALE: `${STORAGE_KEY_PREFIX}locale`,\r\n  \r\n  /**\r\n   * Theme setting\r\n   */\r\n  THEME: `${STORAGE_KEY_PREFIX}theme`,\r\n  \r\n  /**\r\n   * User preferences\r\n   */\r\n  PREFERENCES: `${STORAGE_KEY_PREFIX}preferences`,\r\n  \r\n  /**\r\n   * Authentication token\r\n   */\r\n  AUTH_TOKEN: `${STORAGE_KEY_PREFIX}auth:token`,\r\n  \r\n  /**\r\n   * Refresh token\r\n   */\r\n  REFRESH_TOKEN: `${STORAGE_KEY_PREFIX}auth:refresh`,\r\n} as const;\r\n\r\n/**\r\n * HTTP methods\r\n */\r\nexport const HTTP_METHODS = {\r\n  GET: 'GET',\r\n  POST: 'POST',\r\n  PUT: 'PUT',\r\n  PATCH: 'PATCH',\r\n  DELETE: 'DELETE',\r\n  HEAD: 'HEAD',\r\n  OPTIONS: 'OPTIONS',\r\n} as const;\r\n\r\n/**\r\n * HTTP status codes\r\n */\r\nexport const HTTP_STATUS = {\r\n  OK: 200,\r\n  CREATED: 201,\r\n  NO_CONTENT: 204,\r\n  BAD_REQUEST: 400,\r\n  UNAUTHORIZED: 401,\r\n  FORBIDDEN: 403,\r\n  NOT_FOUND: 404,\r\n  CONFLICT: 409,\r\n  UNPROCESSABLE_ENTITY: 422,\r\n  TOO_MANY_REQUESTS: 429,\r\n  INTERNAL_SERVER_ERROR: 500,\r\n  BAD_GATEWAY: 502,\r\n  SERVICE_UNAVAILABLE: 503,\r\n} as const;\r\n","/**\r\n * Copyright 2026 Brix Platform Authors\r\n *\r\n * Licensed under the Apache License, Version 2.0 (the \"License\");\r\n * you may not use this file except in compliance with the License.\r\n * You may obtain a copy of the License at\r\n *\r\n *     http://www.apache.org/licenses/LICENSE-2.0\r\n *\r\n * Unless required by applicable law or agreed to in writing, software\r\n * distributed under the License is distributed on an \"AS IS\" BASIS,\r\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n * See the License for the specific language governing permissions and\r\n * limitations under the License.\r\n */\r\n/**\r\n * @file Error code definitions\r\n * @description Cross-platform shared error code constants\r\n * @module @brix/platform-shared/constants/errors\r\n * @version 3.0.0\r\n */\r\n\r\n/**\r\n * Common error codes\r\n */\r\nexport const COMMON_ERROR_CODES = {\r\n  /**\r\n   * Unknown error\r\n   */\r\n  UNKNOWN: 'ERR_UNKNOWN',\r\n  \r\n  /**\r\n   * Invalid parameters\r\n   */\r\n  INVALID_PARAMS: 'ERR_INVALID_PARAMS',\r\n  \r\n  /**\r\n   * Operation timeout\r\n   */\r\n  TIMEOUT: 'ERR_TIMEOUT',\r\n  \r\n  /**\r\n   * Network error\r\n   */\r\n  NETWORK: 'ERR_NETWORK',\r\n  \r\n  /**\r\n   * Operation cancelled\r\n   */\r\n  CANCELLED: 'ERR_CANCELLED',\r\n  \r\n  /**\r\n   * Resource not found\r\n   */\r\n  NOT_FOUND: 'ERR_NOT_FOUND',\r\n  \r\n  /**\r\n   * Resource already exists\r\n   */\r\n  ALREADY_EXISTS: 'ERR_ALREADY_EXISTS',\r\n} as const;\r\n\r\n/**\r\n * Authentication error codes\r\n */\r\nexport const AUTH_ERROR_CODES = {\r\n  /**\r\n   * Not authenticated\r\n   */\r\n  UNAUTHENTICATED: 'ERR_AUTH_UNAUTHENTICATED',\r\n  \r\n  /**\r\n   * Unauthorized\r\n   */\r\n  UNAUTHORIZED: 'ERR_AUTH_UNAUTHORIZED',\r\n  \r\n  /**\r\n   * Invalid token\r\n   */\r\n  INVALID_TOKEN: 'ERR_AUTH_INVALID_TOKEN',\r\n  \r\n  /**\r\n   * Token expired\r\n   */\r\n  TOKEN_EXPIRED: 'ERR_AUTH_TOKEN_EXPIRED',\r\n  \r\n  /**\r\n   * Session expired\r\n   */\r\n  SESSION_EXPIRED: 'ERR_AUTH_SESSION_EXPIRED',\r\n  \r\n  /**\r\n   * Refresh token failed\r\n   */\r\n  REFRESH_FAILED: 'ERR_AUTH_REFRESH_FAILED',\r\n} as const;\r\n\r\n/**\r\n * Navigation error codes\r\n */\r\nexport const NAVIGATION_ERROR_CODES = {\r\n  /**\r\n   * Page not found\r\n   */\r\n  PAGE_NOT_FOUND: 'ERR_NAV_PAGE_NOT_FOUND',\r\n  \r\n  /**\r\n   * Navigation blocked\r\n   */\r\n  NAVIGATION_BLOCKED: 'ERR_NAV_BLOCKED',\r\n  \r\n  /**\r\n   * Permission denied\r\n   */\r\n  PERMISSION_DENIED: 'ERR_NAV_PERMISSION_DENIED',\r\n  \r\n  /**\r\n   * Invalid page ID\r\n   */\r\n  INVALID_PAGE_ID: 'ERR_NAV_INVALID_PAGE_ID',\r\n} as const;\r\n\r\n/**\r\n * Plugin error codes\r\n */\r\nexport const PLUGIN_ERROR_CODES = {\r\n  /**\r\n   * Plugin load failed\r\n   */\r\n  LOAD_FAILED: 'ERR_PLUGIN_LOAD_FAILED',\r\n  \r\n  /**\r\n   * Plugin initialization failed\r\n   */\r\n  INIT_FAILED: 'ERR_PLUGIN_INIT_FAILED',\r\n  \r\n  /**\r\n   * Plugin not found\r\n   */\r\n  NOT_FOUND: 'ERR_PLUGIN_NOT_FOUND',\r\n  \r\n  /**\r\n   * Plugin version incompatible\r\n   */\r\n  VERSION_MISMATCH: 'ERR_PLUGIN_VERSION_MISMATCH',\r\n  \r\n  /**\r\n   * Plugin dependency missing\r\n   */\r\n  MISSING_DEPENDENCY: 'ERR_PLUGIN_MISSING_DEPENDENCY',\r\n} as const;\r\n\r\n/**\r\n * All error codes\r\n */\r\nexport const ERROR_CODES = {\r\n  ...COMMON_ERROR_CODES,\r\n  ...AUTH_ERROR_CODES,\r\n  ...NAVIGATION_ERROR_CODES,\r\n  ...PLUGIN_ERROR_CODES,\r\n} as const;\r\n"]}

package/dist/chunk-DJX6ASLI.js

@@ -0,0 +1,143 @@
+import { __export, __esm } from './chunk-4CV4JOE5.js';
+
+// src/utils/id.ts
+var id_exports = {};
+__export(id_exports, {
+  SimpleSnowflake: () => SimpleSnowflake,
+  createDailySequenceIdGenerator: () => createDailySequenceIdGenerator,
+  createSequenceIdGenerator: () => createSequenceIdGenerator,
+  extractTimestampFromId: () => extractTimestampFromId,
+  generateNanoId: () => generateNanoId,
+  generateShortId: () => generateShortId,
+  generateSnowflakeId: () => generateSnowflakeId,
+  generateTimestampId: () => generateTimestampId,
+  generateUUID: () => generateUUID,
+  isValidUUID: () => isValidUUID
+});
+function generateUUID() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function isValidUUID(uuid) {
+  const regex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+  return regex.test(uuid);
+}
+function generateShortId(length = 8, charset = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789") {
+  const charsetLength = charset.length;
+  let result = "";
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    const randomValues = new Uint32Array(length);
+    crypto.getRandomValues(randomValues);
+    for (let i = 0; i < length; i++) {
+      result += charset[randomValues[i] % charsetLength];
+    }
+  } else {
+    for (let i = 0; i < length; i++) {
+      result += charset[Math.floor(Math.random() * charsetLength)];
+    }
+  }
+  return result;
+}
+function generateNanoId(length = 21) {
+  const charset = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+  return generateShortId(length, charset);
+}
+function generateTimestampId(randomLength = 6) {
+  const timestamp = Date.now().toString(36);
+  const random = generateShortId(randomLength, "abcdefghijklmnopqrstuvwxyz0123456789");
+  return `${timestamp}${random}`;
+}
+function extractTimestampFromId(id) {
+  const timestampPart = id.slice(0, 8);
+  try {
+    const timestamp = parseInt(timestampPart, 36);
+    if (isNaN(timestamp)) return null;
+    return new Date(timestamp);
+  } catch {
+    return null;
+  }
+}
+function createSequenceIdGenerator(prefix = "", start = 1) {
+  let counter = start;
+  return () => `${prefix}${counter++}`;
+}
+function createDailySequenceIdGenerator(prefix = "") {
+  let lastDate = "";
+  let counter = 0;
+  return () => {
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10).replace(/-/g, "");
+    if (today !== lastDate) {
+      lastDate = today;
+      counter = 0;
+    }
+    return `${prefix}${today}${(++counter).toString().padStart(6, "0")}`;
+  };
+}
+function generateSnowflakeId() {
+  return defaultSnowflake.generate();
+}
+var SimpleSnowflake, defaultSnowflake;
+var init_id = __esm({
+  "src/utils/id.ts"() {
+    SimpleSnowflake = class {
+      constructor() {
+        /** 当前序列号 */
+        this.sequence = 0;
+        /** 上次生成时间戳 */
+        this.lastTimestamp = -1;
+      }
+      /**
+       * 生成雪花 ID
+       * 
+       * @returns 雪花 ID 字符串
+       */
+      generate() {
+        let timestamp = Date.now();
+        if (timestamp === this.lastTimestamp) {
+          this.sequence = this.sequence + 1 & 4095;
+          if (this.sequence === 0) {
+            while (timestamp <= this.lastTimestamp) {
+              timestamp = Date.now();
+            }
+          }
+        } else {
+          this.sequence = 0;
+        }
+        this.lastTimestamp = timestamp;
+        const random = Math.floor(Math.random() * 1024);
+        const id = BigInt(timestamp) << BigInt(22) | BigInt(this.sequence) << BigInt(10) | BigInt(random);
+        return id.toString();
+      }
+    };
+    defaultSnowflake = new SimpleSnowflake();
+  }
+});
+/**
+ * @file id.ts
+ * @description ID 生成工具函数集
+ * @module @brix/utils/id
+ * @version 3.0.0
+ * 
+ * 【模块说明】
+ * 提供各种 ID 生成工具，包括 UUID、短 ID、NanoID、时间戳 ID、雪花 ID 等。
+ * 不同场景可选择不同的 ID 生成策略。
+ * 
+ * 【选择建议】
+ * - UUID：需要全球唯一且标准格式时使用
+ * - ShortId：用于 URL、临时标识等需要短 ID 的场景
+ * - NanoId：URL 安全的短 ID，比 ShortId 更随机
+ * - TimestampId：需要按时间排序的场景
+ * - SnowflakeId：高并发分布式系统（需配合节点 ID）
+ * 
+ * @license Apache-2.0
+ */
+
+export { SimpleSnowflake, createDailySequenceIdGenerator, createSequenceIdGenerator, extractTimestampFromId, generateNanoId, generateShortId, generateSnowflakeId, generateTimestampId, generateUUID, id_exports, init_id, isValidUUID };
+//# sourceMappingURL=chunk-DJX6ASLI.js.map
+//# sourceMappingURL=chunk-DJX6ASLI.js.map

package/dist/chunk-DJX6ASLI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/id.ts"],"names":[],"mappings":"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","file":"chunk-DJX6ASLI.js","sourcesContent":["/**\r\n * @file id.ts\r\n * @description ID 生成工具函数集\r\n * @module @brix/utils/id\r\n * @version 3.0.0\r\n * \r\n * 【模块说明】\r\n * 提供各种 ID 生成工具，包括 UUID、短 ID、NanoID、时间戳 ID、雪花 ID 等。\r\n * 不同场景可选择不同的 ID 生成策略。\r\n * \r\n * 【选择建议】\r\n * - UUID：需要全球唯一且标准格式时使用\r\n * - ShortId：用于 URL、临时标识等需要短 ID 的场景\r\n * - NanoId：URL 安全的短 ID，比 ShortId 更随机\r\n * - TimestampId：需要按时间排序的场景\r\n * - SnowflakeId：高并发分布式系统（需配合节点 ID）\r\n * \r\n * @license Apache-2.0\r\n */\r\n\r\n// ============================================================\r\n// UUID\r\n// ============================================================\r\n\r\n/**\r\n * 生成 UUID v4\r\n * \r\n * 【功能说明】\r\n * 生成符合 RFC 4122 v4 标准的 UUID。\r\n * 优先使用原生 crypto.randomUUID()，降级使用随机数生成。\r\n * \r\n * 【特点】\r\n * - 全球唯一\r\n * - 标准格式，便于跨系统交互\r\n * - 36字符（含连字符）\r\n * \r\n * @returns UUID 字符串\r\n * \r\n * @example\r\n * ```typescript\r\n * generateUUID(); // 'f47ac10b-58cc-4372-a567-0e02b2c3d479'\r\n * generateUUID(); // '7c9e6679-7425-40de-944b-e07fc1f90ae7'\r\n * ```\r\n */\r\nexport function generateUUID(): string {\r\n  // 优先使用 crypto API\r\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\r\n    return crypto.randomUUID();\r\n  }\r\n\r\n  // 降级方案\r\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\r\n    const r = (Math.random() * 16) | 0;\r\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\r\n    return v.toString(16);\r\n  });\r\n}\r\n\r\n/**\r\n * 验证 UUID 格式\r\n * \r\n * 【功能说明】\r\n * 验证字符串是否为有效的 UUID 格式（v1-v5）。\r\n * \r\n * @param uuid UUID 字符串\r\n * @returns 是否为有效 UUID\r\n * \r\n * @example\r\n * ```typescript\r\n * isValidUUID('f47ac10b-58cc-4372-a567-0e02b2c3d479'); // true\r\n * isValidUUID('not-a-uuid');                           // false\r\n * isValidUUID('f47ac10b58cc4372a5670e02b2c3d479');    // false（缺少连字符）\r\n * ```\r\n */\r\nexport function isValidUUID(uuid: string): boolean {\r\n  const regex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\r\n  return regex.test(uuid);\r\n}\r\n\r\n// ============================================================\r\n// 短 ID\r\n// ============================================================\r\n\r\n/**\r\n * 生成短 ID\r\n * \r\n * 【功能说明】\r\n * 生成指定长度的随机 ID，默认使用字母数字字符集。\r\n * 适用于 URL 路径、临时标识等场景。\r\n * \r\n * 【碰撞概率】\r\n * 8位默认字符集约有 218 万亿种组合（62^8）\r\n * \r\n * @param length ID 长度（默认 8）\r\n * @param charset 字符集（默认字母数字）\r\n * @returns 短 ID 字符串\r\n * \r\n * @example\r\n * ```typescript\r\n * generateShortId();      // 'a1B2c3D4'\r\n * generateShortId(12);    // 'a1B2c3D4e5F6'\r\n * generateShortId(6, '0123456789'); // '123456'（纯数字）\r\n * ```\r\n */\r\nexport function generateShortId(\r\n  length: number = 8,\r\n  charset: string = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'\r\n): string {\r\n  const charsetLength = charset.length;\r\n  let result = '';\r\n\r\n  // 优先使用 crypto API\r\n  if (typeof crypto !== 'undefined' && crypto.getRandomValues) {\r\n    const randomValues = new Uint32Array(length);\r\n    crypto.getRandomValues(randomValues);\r\n    for (let i = 0; i < length; i++) {\r\n      result += charset[randomValues[i] % charsetLength];\r\n    }\r\n  } else {\r\n    for (let i = 0; i < length; i++) {\r\n      result += charset[Math.floor(Math.random() * charsetLength)];\r\n    }\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * 生成 NanoID 风格的 ID\r\n * \r\n * 【功能说明】\r\n * 生成 NanoID 风格的随机 ID，使用 URL 安全字符集。\r\n * 比 UUID 更短，比 ShortId 更随机。\r\n * \r\n * 【特点】\r\n * - URL 安全（无需编码）\r\n * - 默认21位，碰撞概率极低\r\n * - 比 UUID 更短\r\n * \r\n * @param length ID 长度（默认 21）\r\n * @returns NanoID 字符串\r\n * \r\n * @example\r\n * ```typescript\r\n * generateNanoId();    // 'V1StGXR8_Z5jdHi6B-myT'\r\n * generateNanoId(10);  // 'IRFa-VaY2b'\r\n * ```\r\n */\r\nexport function generateNanoId(length: number = 21): string {\r\n  // URL 安全字符集\r\n  const charset = 'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';\r\n  return generateShortId(length, charset);\r\n}\r\n\r\n// ============================================================\r\n// 时间戳 ID\r\n// ============================================================\r\n\r\n/**\r\n * 生成基于时间戳的 ID\r\n * \r\n * 【功能说明】\r\n * 生成包含时间信息的 ID，格式为：时间戳(base36) + 随机串。\r\n * 适用于需要按时间排序或提取时间信息的场景。\r\n * \r\n * 【优势】\r\n * - 按创建时间自然排序\r\n * - 可以从 ID 中提取创建时间\r\n * - 比 UUID 更短\r\n * \r\n * @param randomLength 随机部分长度（默认 6）\r\n * @returns 时间戳 ID\r\n * \r\n * @example\r\n * ```typescript\r\n * generateTimestampId();    // 'lnjhgk4xabcdef'\r\n * generateTimestampId(10);  // 'lnjhgk4xabcdefghij'\r\n * \r\n * // ID 可按时间排序\r\n * const ids = [id1, id2, id3].sort(); // 按创建时间排序\r\n * ```\r\n */\r\nexport function generateTimestampId(randomLength: number = 6): string {\r\n  const timestamp = Date.now().toString(36);\r\n  const random = generateShortId(randomLength, 'abcdefghijklmnopqrstuvwxyz0123456789');\r\n  return `${timestamp}${random}`;\r\n}\r\n\r\n/**\r\n * 从时间戳 ID 中提取时间\r\n * \r\n * 【功能说明】\r\n * 尝试从时间戳 ID 中提取创建时间。\r\n * 仅适用于 generateTimestampId 生成的 ID。\r\n * \r\n * @param id 时间戳 ID\r\n * @returns Date 对象，解析失败返回 null\r\n * \r\n * @example\r\n * ```typescript\r\n * const id = generateTimestampId();\r\n * const date = extractTimestampFromId(id);\r\n * console.log(date); // 2024-01-01T12:00:00.000Z\r\n * \r\n * extractTimestampFromId('invalid'); // null\r\n * ```\r\n */\r\nexport function extractTimestampFromId(id: string): Date | null {\r\n  // 尝试提取 base36 时间戳部分（前8位）\r\n  const timestampPart = id.slice(0, 8);\r\n  try {\r\n    const timestamp = parseInt(timestampPart, 36);\r\n    if (isNaN(timestamp)) return null;\r\n    return new Date(timestamp);\r\n  } catch {\r\n    return null;\r\n  }\r\n}\r\n\r\n// ============================================================\r\n// 序列 ID\r\n// ============================================================\r\n\r\n/**\r\n * 创建序列 ID 生成器\r\n * \r\n * 【功能说明】\r\n * 创建一个自增序列 ID 生成器，每次调用返回递增的 ID。\r\n * 适用于单机环境下的唯一 ID 生成。\r\n * \r\n * 【注意】\r\n * - 仅在单进程内唯一\r\n * - 重启后计数器重置\r\n * - 不适合分布式环境\r\n * \r\n * @param prefix ID 前缀（可选）\r\n * @param start 起始值（默认 1）\r\n * @returns 生成器函数\r\n * \r\n * @example\r\n * ```typescript\r\n * const genOrderId = createSequenceIdGenerator('ORD-', 1000);\r\n * genOrderId(); // 'ORD-1000'\r\n * genOrderId(); // 'ORD-1001'\r\n * genOrderId(); // 'ORD-1002'\r\n * \r\n * const genId = createSequenceIdGenerator();\r\n * genId(); // '1'\r\n * genId(); // '2'\r\n * ```\r\n */\r\nexport function createSequenceIdGenerator(\r\n  prefix: string = '',\r\n  start: number = 1\r\n): () => string {\r\n  let counter = start;\r\n  return () => `${prefix}${counter++}`;\r\n}\r\n\r\n/**\r\n * 创建带日期前缀的序列 ID 生成器\r\n * \r\n * 【功能说明】\r\n * 创建按日自增的序列 ID 生成器。\r\n * 格式：前缀 + 日期(YYYYMMDD) + 序号(6位)。\r\n * 每天计数器自动重置。\r\n * \r\n * 【适用场景】\r\n * - 订单号\r\n * - 流水号\r\n * - 工单号\r\n * \r\n * @param prefix ID 前缀（可选）\r\n * @returns 生成器函数\r\n * \r\n * @example\r\n * ```typescript\r\n * const genOrderId = createDailySequenceIdGenerator('ORD');\r\n * genOrderId(); // 'ORD20240101000001'\r\n * genOrderId(); // 'ORD20240101000002'\r\n * \r\n * // 第二天\r\n * genOrderId(); // 'ORD20240102000001'（计数器重置）\r\n * ```\r\n */\r\nexport function createDailySequenceIdGenerator(prefix: string = ''): () => string {\r\n  let lastDate = '';\r\n  let counter = 0;\r\n\r\n  return () => {\r\n    const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');\r\n    if (today !== lastDate) {\r\n      lastDate = today;\r\n      counter = 0;\r\n    }\r\n    return `${prefix}${today}${(++counter).toString().padStart(6, '0')}`;\r\n  };\r\n}\r\n\r\n// ============================================================\r\n// 雪花 ID (简化版)\r\n// ============================================================\r\n\r\n/**\r\n * 简化版雪花 ID 生成器\r\n * \r\n * 【功能说明】\r\n * 生成类似 Twitter Snowflake 的 64 位唯一 ID。\r\n * 此为简化实现，不含 workerId/datacenterId。\r\n * \r\n * 【ID 结构】\r\n * - 时间戳（41位）：可用约69年\r\n * - 序列号（12位）：每毫秒可生成 4096 个 ID\r\n * - 随机数（10位）：增加随机性\r\n * \r\n * 【注意】\r\n * - 简化版适用于单节点或对全局唯一性要求不高的场景\r\n * - 生产环境分布式部署建议使用服务端生成\r\n * \r\n * @example\r\n * ```typescript\r\n * const snowflake = new SimpleSnowflake();\r\n * snowflake.generate(); // '7123456789012345678'\r\n * snowflake.generate(); // '7123456789012345679'\r\n * ```\r\n */\r\nexport class SimpleSnowflake {\r\n  /** 当前序列号 */\r\n  private sequence = 0;\r\n  /** 上次生成时间戳 */\r\n  private lastTimestamp = -1;\r\n\r\n  /**\r\n   * 生成雪花 ID\r\n   * \r\n   * @returns 雪花 ID 字符串\r\n   */\r\n  generate(): string {\r\n    let timestamp = Date.now();\r\n\r\n    if (timestamp === this.lastTimestamp) {\r\n      // 同一毫秒内，序列号递增\r\n      this.sequence = (this.sequence + 1) & 0xfff; // 12 bit\r\n      if (this.sequence === 0) {\r\n        // 序列号溢出，等待下一毫秒\r\n        while (timestamp <= this.lastTimestamp) {\r\n          timestamp = Date.now();\r\n        }\r\n      }\r\n    } else {\r\n      // 新的毫秒，重置序列号\r\n      this.sequence = 0;\r\n    }\r\n\r\n    this.lastTimestamp = timestamp;\r\n\r\n    // 使用 BigInt 组合各部分\r\n    const random = Math.floor(Math.random() * 1024); // 10 bit\r\n    const id =\r\n      (BigInt(timestamp) << BigInt(22)) |\r\n      (BigInt(this.sequence) << BigInt(10)) |\r\n      BigInt(random);\r\n\r\n    return id.toString();\r\n  }\r\n}\r\n\r\n/**\r\n * 默认的雪花 ID 生成器实例\r\n */\r\nconst defaultSnowflake = new SimpleSnowflake();\r\n\r\n/**\r\n * 生成雪花 ID\r\n * \r\n * 【功能说明】\r\n * 使用默认生成器实例生成雪花 ID。\r\n * 便捷函数，无需手动创建实例。\r\n * \r\n * @returns 雪花 ID 字符串\r\n * \r\n * @example\r\n * ```typescript\r\n * generateSnowflakeId(); // '7123456789012345678'\r\n * generateSnowflakeId(); // '7123456789012345679'\r\n * \r\n * // 可按数值排序（时间有序）\r\n * BigInt(id1) < BigInt(id2); // true（id1 先生成）\r\n * ```\r\n */\r\nexport function generateSnowflakeId(): string {\r\n  return defaultSnowflake.generate();\r\n}\r\n"]}

package/dist/chunk-GNCIKXWI.js

@@ -0,0 +1,3 @@
+export { DEFAULT_CACHE_OPTIONS, DEFAULT_RETRY_OPTIONS, HttpError, HttpErrorCode, RETRYABLE_NETWORK_ERRORS, RETRYABLE_STATUS_CODES, SimpleCache, calculateBackoffDelay, createRetryable, delay, generateCacheKey, shouldRetry, withCache, withRetry } from '@brix/infra-adapter-http-web';
+//# sourceMappingURL=chunk-GNCIKXWI.js.map
+//# sourceMappingURL=chunk-GNCIKXWI.js.map

package/dist/chunk-GNCIKXWI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-GNCIKXWI.js","sourcesContent":[]}