@posx/core 5.5.510 → 5.5.512

package/package.json

@@ -1,15 +1,90 @@
 {
   "name": "@posx/core",
-  "version": "5.5.510",
+  "version": "5.5.512",
   "description": "POSX core libraries",
+  "type": "module",
   "main": "./build/index.js",
+  "module": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "up": "node ./scripts/upload-to-s3.cjs --trace-warnings",
+    "start": "tsdown --watch",
+    "build": "tsdown",
+    "build:dts": "tsdown --dts-only",
+    "post:build": "node ./scripts/clean-build.cjs",
+    "mvm": "mv build/*.map scripts/sourcemaps/ && mv build/**/*.map scripts/sourcemaps/ && find build -name '*.map' -type f -delete",
+    "build:demo": "vite build --mode demo",
+    "test": "jest --maxWorkers=2",
+    "test:watch": "jest --watch",
+    "publish": "node ./scripts/publish.cjs",
+    "p": "pnpm i && npm test && npm run up:p && npm run build && npm run post:build && npm run publish && rm -rf build",
+    "debug": "npm run build && npm run post:build",
+    "coverage": "jest --coverage",
+    "trypublish": "npm publish || true",
+    "gen:index": "node ./scriptswc/generateIndex.cjs",
+    "up:p": "npm version patch && git push",
+    "up:m": "npm version minor && git push",
+    "docs": "typedoc --out docs src --excludePrivate --exclude '**/demo/**/*' --exclude '**/*+(interface|function|enum).ts'",
+    "see": "node ./scripts/lookup-sm.cjs",
+    "escpos": "node ./scripts/generate-escpos-bytes.mjs"
+  },
+  "repository": {
+    "type": "git"
+  },
   "author": "Steven Lee",
   "license": "UNLICENSED",
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
   "keywords": [
     "library",
     "starter",
     "es6"
   ],
+  "devDependencies": {
+    "@capacitor/core": "5.4.2",
+    "@litepos/autoquery": "5.0.10",
+    "@types/bcryptjs": "2.4.6",
+    "@types/jest": "30.0.0",
+    "@types/lodash": "^4.17.12",
+    "@types/node": "20.8.2",
+    "@types/uuid": "9.0.4",
+    "@typescript-eslint/eslint-plugin": "^4.33.0",
+    "@typescript-eslint/parser": "^4.33.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "ajv": "8.17.1",
+    "aws-sdk": "2.1550.0",
+    "colors": "1.4.0",
+    "eslint": "^7.32.0",
+    "fs-extra": "11.1.1",
+    "glob": "10.3.10",
+    "jest": "30.2.0",
+    "jest-environment-jsdom": "30.2.0",
+    "jsdom": "27.1.0",
+    "prompt-sync": "4.2.0",
+    "rollup-plugin-obfuscator": "^1.1.0",
+    "sqlite3": "5.1.6",
+    "terser": "^5.36.0",
+    "ts-jest": "29.4.5",
+    "tsdown": "0.16.1",
+    "typedoc": "^0.26.0",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.11",
+    "vite-plugin-bundle-obfuscator": "1.8.0",
+    "vite-plugin-dts": "^4.3.0",
+    "vitest": "^2.1.0",
+    "xlsx": "^0.18.5"
+  },
   "dependencies": {
     "@awesome-cordova-plugins/core": "6.6.0",
     "@awesome-cordova-plugins/network-interface": "6.6.0",
@@ -33,5 +108,14 @@
     "vm-browserify": "1.1.2",
     "wcwidth": "1.0.1",
     "zod": "3.23.8"
+  },
+  "peerDependencies": {
+    "@litepos/autoquery": "5.0.10",
+    "rxjs": "^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "rxjs": {
+      "optional": true
+    }
   }
-}
+}

package/AGENTS.md

@@ -1,24 +0,0 @@
-# Codex AI Development Guidelines
-
-## Rules you have to follow strictly
-
-- You are top-notch programmer who always write simplest code to achieve the ideal result
-- you are one liner engineers and we believe "The Great Tao is Simple", so try to keep changes small and focused
-- keep the changes as minimal as possible
-- if or else has one line of code, then { } are not needed and it should be wrote into same line
-- DO NOT write uncessary comment do not make newlines within a function and try to make the code compact
-- All crucial code should have proper explanation in English
-- Keep the simplifications as small and focused within the function or scope.
-- Do not overhaul the whole file or codebase which is irrelevant to the current task.
-
-## Best Practices for AI-Assisted Development
-
-1. **在开始编码前先充分讨论和规划架构，确保理解用户的真实需求和使用场景，避免过度设计。**
-
-2. **不要急于提交代码，应该等待用户明确指示后再进行 commit 和 push 操作。**
-
-3. **优先选择简洁的实现方式（如函数导出而非类），并删除冗余的中间层方法以保持代码清晰。**
-
----
-
-*This file contains guidelines learned from AI-human collaboration to improve development efficiency and code quality.*

package/CLAUDE.md

@@ -1,24 +0,0 @@
-# Claude AI Development Guidelines
-
-## Rules you have to follow strictly
-
-- You are top-notch programmer who always write simplest code to achieve the ideal result
-- you are one liner engineers and we believe "The Great Tao is Simple", so try to keep changes small and focused
-- keep the changes as minimal as possible
-- if or else has one line of code, then { } are not needed and it should be wrote into same line
-- DO NOT write uncessary comment do not make newlines within a function and try to make the code compact
-- All crucial code should have proper explanation in English
-- Keep the simplifications as small and focused within the function or scope.
-- Do not overhaul the whole file or codebase which is irrelevant to the current task.
-
-## Best Practices for AI-Assisted Development
-
-1. **在开始编码前先充分讨论和规划架构，确保理解用户的真实需求和使用场景，避免过度设计。**
-
-2. **不要急于提交代码，应该等待用户明确指示后再进行 commit 和 push 操作。**
-
-3. **优先选择简洁的实现方式（如函数导出而非类），并删除冗余的中间层方法以保持代码清晰。**
-
----
-
-*This file contains guidelines learned from AI-human collaboration to improve development efficiency and code quality.*

package/jest.config.cjs

@@ -1,36 +0,0 @@
-// jest.config.js
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'jsdom',
-  setupFilesAfterEnv: ['<rootDir>/jest.setup.cjs'],
-  transform: {
-    '^.+\\.ts$': ['ts-jest', {
-      tsconfig: {
-        module: 'commonjs',
-        esModuleInterop: true,
-      }
-    }],
-    '^.+\\.(mjs|js)$': ['ts-jest', {
-      tsconfig: {
-        allowJs: true,
-        module: 'commonjs',
-        esModuleInterop: true,
-      }
-    }]
-  },
-  transformIgnorePatterns: [
-    'node_modules/(?!(.pnpm|nanoid|@litepos|dexie|lodash-es)/)', // Transform ESM packages
-  ],
-  testMatch: [
-    '<rootDir>/src/test/**/*.test.ts'
-  ],
-  moduleNameMapper: {
-    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$': '<rootDir>/scripts/testMock.cjs',
-    '\\.(css|less)$': '<rootDir>/scripts/testMock.cjs',
-    '^nanoid$': '<rootDir>/src/test/__mocks__/nanoid.js',
-    '^dexie$': '<rootDir>/src/test/__mocks__/dexie.js',
-    '^@awesome-cordova-plugins/network-interface$': '<rootDir>/src/test/__mocks__/@awesome-cordova-plugins/network-interface.js',
-    '^canvas$': '<rootDir>/scripts/testMock.cjs'
-  },
-  moduleFileExtensions: ['web.js', 'js', 'web.ts', 'ts', 'web.tsx', 'tsx', 'json', 'web.jsx', 'jsx', 'node'],
-};

package/jest.setup.cjs

@@ -1,80 +0,0 @@
-// Jest setup file to polyfill File and Blob APIs
-// This ensures consistent behavior across different Node.js versions and test environments
-
-// Polyfill Blob.text() if not available
-if (typeof Blob !== 'undefined' && !Blob.prototype.text) {
-  Blob.prototype.text = async function() {
-    const reader = new FileReader();
-    return new Promise((resolve, reject) => {
-      reader.onload = () => resolve(reader.result);
-      reader.onerror = reject;
-      reader.readAsText(this);
-    });
-  };
-}
-
-// Polyfill FileReader if not available
-if (typeof FileReader === 'undefined') {
-  global.FileReader = class FileReader {
-    result = null;
-    error = null;
-    onload = null;
-    onerror = null;
-
-    readAsText(blob) {
-      try {
-        // For our polyfilled Blob
-        if (blob.parts) {
-          this.result = blob.parts.join('');
-        } else if (typeof blob === 'string') {
-          this.result = blob;
-        } else {
-          this.result = String(blob);
-        }
-
-        if (this.onload) {
-          setTimeout(() => this.onload({ target: this }), 0);
-        }
-      } catch (err) {
-        this.error = err;
-        if (this.onerror) {
-          setTimeout(() => this.onerror({ target: this }), 0);
-        }
-      }
-    }
-  };
-}
-
-// Polyfill Blob if not available (for Node.js < 18)
-if (typeof Blob === 'undefined') {
-  global.Blob = class Blob {
-    constructor(parts = [], options = {}) {
-      this.parts = parts;
-      this.type = options.type || '';
-      this.size = parts.reduce((acc, part) => {
-        return acc + (typeof part === 'string' ? part.length : part.length || 0);
-      }, 0);
-    }
-
-    async text() {
-      return this.parts.join('');
-    }
-
-    async arrayBuffer() {
-      const text = await this.text();
-      const buffer = Buffer.from(text);
-      return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-    }
-  };
-}
-
-// Polyfill File if not available (for Node.js < 18)
-if (typeof File === 'undefined') {
-  global.File = class File extends global.Blob {
-    constructor(bits, name, options = {}) {
-      super(bits, options);
-      this.name = name;
-      this.lastModified = options.lastModified || Date.now();
-    }
-  };
-}

package/memo/technical-docs/01_ARCHITECTURE.md

@@ -1,147 +0,0 @@
-# 01 - 整体架构
-
-> AI 上下文索引：服务工厂、依赖注入、Dexie数据库、Axios HTTP、服务层次、事件驱动
-
-## 架构概述
-
-本项目是 **核心服务库**，非前端应用。采用服务导向架构，通过工厂模式进行依赖注入。
-
-## 入口点
-
-**主入口:** `src/index.ts`
-- Barrel 导出所有公共 API
-- 导出服务工厂、领域模型、工具函数
-
-**服务工厂:** `src/service.factory.ts`
-- 初始化 Dexie 数据库 (28 张表)
-- 创建 Axios HTTP 客户端
-- 按需实例化领域服务
-- 管理数据库连接状态
-
-## 服务层次结构
-
-```
-IAppCoreService<T>     # 读操作接口
-    │
-    ├── IAppLocalService<T>   # 本地 CRUD (无远程)
-    │
-    └── IAppRemoteService<T>  # 远程 API CRUD
-            │
-            ├── addOne()     → PUT
-            ├── updateOne()  → PATCH
-            ├── updateMany() → PATCH
-            └── deleteOne()  → DELETE (软删除)
-```
-
-## 数据库架构
-
-**技术:** Dexie v3.2.4 (IndexedDB 包装器)
-**版本:** v28
-**表数量:** 28 张
-
-### 核心表
-
-| 表名 | 索引 | 用途 |
-|------|------|------|
-| items | uid, name, barcode, codename, sequence | 商品 |
-| sections | uid, sequence | 区域 |
-| section_items | uid, sequence | 桌位 |
-| categories | uid, sequence | 分类 |
-| invoices | uid, type, status, table_uid | 发票 |
-| employees | uid, role_uid | 员工 |
-| payment_methods | uid, is_cash | 支付方式 |
-| printers | uid | 打印机 |
-| print_jobs | uid, status, printer_type, device_uid_to_print | 打印任务 |
-| configs | uid | 配置 |
-| shifts | uid, status | 班次 |
-| tills | uid, employee_uid | 收银机 |
-
-### 基础索引模式
-
-```typescript
-const baseSchema = 'uid, updated_at, created_at, deleted_at, _timestamp, id_in_server, created_at_timestamp';
-```
-
-## 事件驱动模式
-
-### SignalR 集成
-
-**Hub 消息类型:** `src/types/hub.message.type.ts`
-
-```typescript
-enum HubMessageType {
-    PaynowEvent = 'paynow_event',
-    SmoochPaymentEvent = 'smooch_payment_event',
-    SyncInvoice = 'sync_invoice',
-}
-```
-
-### Dexie Live Query
-
-```typescript
-public liveQuery<T>(expr: () => T): Observable<T> {
-    return liveQuery(expr);
-}
-```
-- 提供响应式数据更新
-- 通过 RxJS Observable 集成
-
-## Electron Socket 桥接
-
-**位置:** `src/libs/electron.socket.ts`
-
-**状态机:**
-- CLOSED (0) → OPENING (1) → OPENED (2) → CLOSING (3)
-
-**用途:**
-- Electron IPC 通信
-- 硬件控制 (打印机、钱箱)
-
-## 插件系统
-
-### Handlebars 插件注册
-
-**位置:** `src/helpers/helpers.register.ts`
-
-用于动态模板渲染：
-- `string.helpers.ts` - 字符串处理
-- `comparison.helpers.ts` - 比较逻辑
-
-## 关键文件
-
-| 文件路径 | 大小 | 核心职责 |
-|----------|------|---------|
-| `src/service.factory.ts` | 6KB | 服务实例化、数据库初始化 |
-| `src/services/abstract.service.ts` | 8KB | 基础 CRUD 接口 |
-| `src/services/app.service.ts` | 82KB | 领域服务集合 |
-| `src/services/invoice.service.ts` | 107KB | 发票生命周期、计算引擎 |
-| `src/libs/electron.socket.ts` | 3KB | Electron IPC 桥接 |
-| `src/libs/escpos.printer.ts` | 18KB | ESC/POS 打印命令 |
-
-## 架构模式
-
-1. **服务工厂模式** - 延迟初始化服务
-2. **仓储模式** - AppRemoteService 提供数据访问抽象
-3. **适配器模式** - Dexie + Axios 双重持久化
-4. **观察者模式** - Dexie liveQuery + RxJS
-5. **模板方法模式** - 抽象服务基类
-6. **策略模式** - 多种计算流程 (CalcFlow)
-7. **事件驱动** - SignalR 实时同步
-
-## 运行模式
-
-```typescript
-enum ServiceMode {
-  LOCAL = 'local',    // 仅客户端模式
-  CLOUD = 'cloud'     // 远程 API 同步模式
-}
-```
-
-**LOCAL:** 仅使用 IndexedDB，无远程调用
-**CLOUD:** 与远程 API 同步，维护本地缓存
-
-## 相关文档
-
-- [PROJECT_OVERVIEW.md](./PROJECT_OVERVIEW.md) - 项目总览
-- [05_DATA_LAYER.md](./05_DATA_LAYER.md) - 数据层详解
-- [06_CROSS_PLATFORM.md](./06_CROSS_PLATFORM.md) - 跨平台能力