packing-ecom 2026.6.17

package/README.md

@@ -0,0 +1,39 @@
+# packing-ecom
+
+CLI cài đặt và khởi động E-commerce Packing Control Center.
+
+## Nền tảng hỗ trợ
+
+- Windows 10/11 x64
+- macOS Intel x64
+- macOS Apple Silicon
+- Ubuntu 22.04/24.04 x64
+
+## Cài đặt
+
+```bash
+npm install -g packing-ecom
+packing-ecom
+```
+
+Khi cài đặt, npm tự chọn binary package phù hợp với hệ điều hành/CPU. Lệnh
+`packing-ecom` xác minh binary, khởi động backend cục bộ, tự chọn cổng từ 8000
+đến 8999 và mở giao diện trong trình duyệt. Python, OpenCV và các thư viện xử
+lý ảnh đã nằm trong binary; máy người dùng không cần cài Python hay Docker.
+
+Ứng dụng có thể sử dụng camera tích hợp/USB và URL camera RTSP/HTTP trong cùng
+mạng LAN. Trên macOS, người dùng cần cấp quyền Camera cho Terminal; trên Linux,
+tài khoản cần có quyền truy cập thiết bị `/dev/video*`.
+
+## Lệnh
+
+```bash
+packing-ecom --help
+packing-ecom --version
+```
+
+Video và ảnh mặc định được lưu tại `Downloads/e-commerce-packing`. Có thể đổi
+thư mục lưu trữ trong giao diện.
+
+Package chính chỉ chứa launcher. Binary được phân phối bằng package npm riêng
+cho từng nền tảng và được xác minh bằng SHA-256 trước khi chạy.

package/bin/packing-ecom.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+'use strict'
+
+const childProcess = require('node:child_process')
+const fs = require('node:fs')
+const net = require('node:net')
+const os = require('node:os')
+const path = require('node:path')
+
+const packageJson = require('../package.json')
+const { ensureBinary } = require('../lib/installer')
+
+function printHelp() {
+  console.log(`packing-ecom ${packageJson.version}
+
+Khởi động E-commerce Packing Control Center.
+
+Cách dùng:
+  packing-ecom
+  packing-ecom --help
+  packing-ecom --version`)
+}
+
+function getStateDirectory() {
+  if (process.env.PACKING_ECOM_STATE_DIR) {
+    return path.resolve(process.env.PACKING_ECOM_STATE_DIR)
+  }
+  if (process.platform === 'win32') {
+    return path.join(
+      process.env.LOCALAPPDATA || process.env.APPDATA || os.homedir(),
+      'packing-ecom',
+    )
+  }
+  if (process.platform === 'darwin') {
+    return path.join(os.homedir(), 'Library', 'Application Support', 'packing-ecom')
+  }
+  return path.join(
+    process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state'),
+    'packing-ecom',
+  )
+}
+
+function isProcessRunning(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch (error) {
+    return error.code === 'EPERM'
+  }
+}
+
+function openBrowser(url) {
+  let command
+  let args
+  if (process.platform === 'darwin') {
+    command = 'open'
+    args = [url]
+  } else if (process.platform === 'win32') {
+    command = 'cmd.exe'
+    args = ['/d', '/s', '/c', 'start', '', url]
+  } else {
+    command = 'xdg-open'
+    args = [url]
+  }
+  const opener = childProcess.spawn(command, args, {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: true,
+  })
+  opener.unref()
+}
+
+function readActiveInstance(lockPath) {
+  try {
+    const state = JSON.parse(fs.readFileSync(lockPath, 'utf8'))
+    return isProcessRunning(state.pid) ? state : null
+  } catch {
+    return null
+  }
+}
+
+function acquireLock(lockPath, port) {
+  const active = readActiveInstance(lockPath)
+  if (active) return { active, acquired: false }
+
+  try {
+    fs.unlinkSync(lockPath)
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error
+  }
+
+  try {
+    const fileDescriptor = fs.openSync(lockPath, 'wx', 0o600)
+    fs.writeFileSync(fileDescriptor, JSON.stringify({ pid: process.pid, port }))
+    fs.closeSync(fileDescriptor)
+    return { active: null, acquired: true }
+  } catch (error) {
+    if (error.code !== 'EEXIST') throw error
+    return { active: readActiveInstance(lockPath), acquired: false }
+  }
+}
+
+function isPortAvailable(port) {
+  return new Promise((resolve) => {
+    const server = net.createServer()
+    server.unref()
+    server.once('error', () => resolve(false))
+    server.listen({ host: '127.0.0.1', port, exclusive: true }, () => {
+      server.close(() => resolve(true))
+    })
+  })
+}
+
+async function findFreePort(startPort = 8000) {
+  const requestedPort = Number.parseInt(process.env.PACKING_ECOM_PORT || '', 10)
+  if (Number.isInteger(requestedPort) && requestedPort >= 1024 && requestedPort <= 65535) {
+    if (await isPortAvailable(requestedPort)) return requestedPort
+    throw new Error(`Cổng PACKING_ECOM_PORT=${requestedPort} đang được sử dụng.`)
+  }
+
+  for (let port = startPort; port < 9000; port += 1) {
+    if (await isPortAvailable(port)) return port
+  }
+  throw new Error('Không tìm được cổng trống trong khoảng 8000-8999.')
+}
+
+async function run() {
+  const args = process.argv.slice(2)
+  if (args.includes('--help') || args.includes('-h')) {
+    printHelp()
+    return
+  }
+  if (args.includes('--version') || args.includes('-v')) {
+    console.log(packageJson.version)
+    return
+  }
+  if (args.length > 0) {
+    throw new Error(`Tham số không được hỗ trợ: ${args.join(' ')}`)
+  }
+
+  const stateDirectory = getStateDirectory()
+  fs.mkdirSync(stateDirectory, { recursive: true })
+  const lockPath = path.join(stateDirectory, 'packing-ecom.lock')
+
+  const currentInstance = readActiveInstance(lockPath)
+  if (currentInstance) {
+    const url = `http://127.0.0.1:${currentInstance.port}`
+    console.log(`[packing-ecom] Ứng dụng đang chạy tại ${url}`)
+    openBrowser(url)
+    return
+  }
+
+  const port = await findFreePort()
+  const lock = acquireLock(lockPath, port)
+  if (!lock.acquired) {
+    if (!lock.active) {
+      throw new Error('Không thể giành quyền khởi động ứng dụng. Vui lòng chạy lại.')
+    }
+    const url = `http://127.0.0.1:${lock.active.port}`
+    console.log(`[packing-ecom] Ứng dụng đang chạy tại ${url}`)
+    openBrowser(url)
+    return
+  }
+
+  const cleanup = () => {
+    try {
+      const state = JSON.parse(fs.readFileSync(lockPath, 'utf8'))
+      if (state.pid === process.pid) fs.unlinkSync(lockPath)
+    } catch {
+      // Lock đã được dọn hoặc không còn hợp lệ.
+    }
+  }
+
+  try {
+    const binaryPath = await ensureBinary()
+    console.log(`[packing-ecom] Khởi động tại http://127.0.0.1:${port}`)
+    const child = childProcess.spawn(binaryPath, [], {
+      env: {
+        ...process.env,
+        IS_DOCKER: '0',
+        PORT: String(port),
+        PACKING_ECOM_LOG_DIR: stateDirectory,
+      },
+      stdio: 'inherit',
+      windowsHide: false,
+    })
+
+    const forwardSignal = (signal) => {
+      if (!child.killed) child.kill(signal)
+    }
+    process.once('SIGINT', () => forwardSignal('SIGINT'))
+    process.once('SIGTERM', () => forwardSignal('SIGTERM'))
+
+    const exitCode = await new Promise((resolve, reject) => {
+      child.once('error', reject)
+      child.once('exit', (code, signal) => {
+        if (signal) resolve(1)
+        else resolve(code || 0)
+      })
+    })
+    process.exitCode = exitCode
+  } finally {
+    cleanup()
+  }
+}
+
+run().catch((error) => {
+  console.error(`[packing-ecom] ${error.message}`)
+  process.exitCode = 1
+})
+
+module.exports = {
+  acquireLock,
+  findFreePort,
+  getStateDirectory,
+  isProcessRunning,
+  isPortAvailable,
+  readActiveInstance,
+}

package/lib/installer.js

@@ -0,0 +1,91 @@
+'use strict'
+
+const crypto = require('node:crypto')
+const fs = require('node:fs')
+const path = require('node:path')
+
+const {
+  getLocalExecutableName,
+  getPlatformPackageName,
+  getTarget,
+} = require('./platform')
+
+function parseChecksum(contents) {
+  const match = contents.match(/\b([a-f0-9]{64})\b/i)
+  if (!match) {
+    throw new Error('Checksum SHA-256 của binary package không hợp lệ.')
+  }
+  return match[1].toLowerCase()
+}
+
+function calculateSha256(filePath) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256')
+    const stream = fs.createReadStream(filePath)
+    stream.on('error', reject)
+    stream.on('data', (chunk) => hash.update(chunk))
+    stream.on('end', () => resolve(hash.digest('hex')))
+  })
+}
+
+function resolveBinaryPath(target = getTarget()) {
+  if (process.env.PACKING_ECOM_BINARY_PATH) {
+    return path.resolve(process.env.PACKING_ECOM_BINARY_PATH)
+  }
+
+  const packageName = getPlatformPackageName(target)
+  let packageJsonPath
+  try {
+    packageJsonPath = require.resolve(`${packageName}/package.json`, {
+      paths: [path.resolve(__dirname, '..')],
+    })
+  } catch (error) {
+    throw new Error(
+      `Không tìm thấy binary package ${packageName}. ` +
+        'Hãy cài lại packing-ecom và không dùng --omit=optional.',
+      { cause: error },
+    )
+  }
+
+  return path.join(
+    path.dirname(packageJsonPath),
+    'bin',
+    getLocalExecutableName(target),
+  )
+}
+
+async function ensureBinary() {
+  const binaryPath = resolveBinaryPath()
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error(`Không tìm thấy binary: ${binaryPath}`)
+  }
+
+  if (process.env.PACKING_ECOM_BINARY_PATH) {
+    return binaryPath
+  }
+
+  const checksumPath = `${binaryPath}.sha256`
+  if (!fs.existsSync(checksumPath)) {
+    throw new Error(`Không tìm thấy checksum: ${checksumPath}`)
+  }
+
+  const expected = parseChecksum(fs.readFileSync(checksumPath, 'utf8'))
+  const actual = await calculateSha256(binaryPath)
+  if (actual !== expected) {
+    throw new Error(
+      `Checksum SHA-256 không khớp cho ${path.basename(binaryPath)}.`,
+    )
+  }
+
+  if (process.platform !== 'win32') {
+    fs.chmodSync(binaryPath, 0o755)
+  }
+  return binaryPath
+}
+
+module.exports = {
+  calculateSha256,
+  ensureBinary,
+  parseChecksum,
+  resolveBinaryPath,
+}

package/lib/platform.js

@@ -0,0 +1,67 @@
+'use strict'
+
+const SUPPORTED_TARGETS = Object.freeze({
+  'win32-x64': {
+    extension: '.exe',
+    label: 'Windows 10/11 x64',
+    packageName: 'packing-ecom-windows-x64',
+  },
+  'darwin-x64': {
+    extension: '',
+    label: 'macOS Intel x64',
+    packageName: 'packing-ecom-darwin-x64',
+  },
+  'darwin-arm64': {
+    extension: '',
+    label: 'macOS Apple Silicon',
+    packageName: 'packing-ecom-darwin-arm64',
+  },
+  'linux-x64': {
+    extension: '',
+    label: 'Linux x64 (Ubuntu 22.04/24.04)',
+    packageName: 'packing-ecom-linux-x64',
+  },
+})
+
+function getTarget(platform = process.platform, arch = process.arch) {
+  const target = `${platform}-${arch}`
+  if (!SUPPORTED_TARGETS[target]) {
+    const supported = Object.values(SUPPORTED_TARGETS)
+      .map(({ label }) => label)
+      .join(', ')
+    throw new Error(
+      `Hệ điều hành/CPU ${target} chưa được hỗ trợ. Các nền tảng hỗ trợ: ${supported}.`,
+    )
+  }
+  return target
+}
+
+function getReleaseFilename(target) {
+  const config = SUPPORTED_TARGETS[target]
+  if (!config) {
+    throw new Error(`Target build không hợp lệ: ${target}`)
+  }
+  return `packing-ecom-${target}${config.extension}`
+}
+
+function getLocalExecutableName(target) {
+  return target.startsWith('win32-')
+    ? 'packing-ecom.exe'
+    : 'packing-ecom'
+}
+
+function getPlatformPackageName(target) {
+  const config = SUPPORTED_TARGETS[target]
+  if (!config) {
+    throw new Error(`Target build không hợp lệ: ${target}`)
+  }
+  return config.packageName
+}
+
+module.exports = {
+  SUPPORTED_TARGETS,
+  getLocalExecutableName,
+  getPlatformPackageName,
+  getReleaseFilename,
+  getTarget,
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "packing-ecom",
+  "version": "2026.6.17",
+  "description": "E-commerce packing camera control center",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JustinNguyen9979/e-commerce-packing.git"
+  },
+  "homepage": "https://github.com/JustinNguyen9979/e-commerce-packing",
+  "bugs": {
+    "url": "https://github.com/JustinNguyen9979/e-commerce-packing/issues"
+  },
+  "bin": {
+    "packing-ecom": "bin/packing-ecom.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test ../../tests/npm/*.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "packing-ecom-darwin-arm64": "2026.6.17",
+    "packing-ecom-darwin-x64": "2026.6.17",
+    "packing-ecom-linux-x64": "2026.6.17",
+    "packing-ecom-windows-x64": "2026.6.17"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}