open-index/open-npm huggingface dataset:
npm package: @littlechic/vision
Description: LittleChic Vision API for object detection and image processing
Latest version: 2.0.0

# Little Chic Vision

This repo is for a spike on the [Google Vision API](https://cloud.google.com/vision?hl=en) to evaluate whether it is applicable to Little Chic Market.

## Authentication

### Local Environment

Use the `gcloud` CLI to set up authentication for the Google Vision API client library. To do this, create application default credentials for your local environment:

```shell
gcloud init
gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID
```

The [document](https://cloud.google.com/vision/docs/setup#client-library-user-account-authentication).

### Production Environment

The preferred method to set up authentication from outside of Google Cloud is to use workload identity federation. For more information, see [Set up ADC for on-premises or another cloud provider](https://cloud.google.com/docs/authentication/set-up-adc-on-premises#wlif) in the Google Cloud authentication documentation.

## Usage

Produce face and item detection results:

```shell
npm install
node faces.js
node items.js
```

If there are HEIC images, transfer them to JPEG:

```shell
node heic2jpeg.js
```

# 本地測試 NPM 套件的方式 (`npm pack`)

當你正在開發一個本地 NPM 套件，例如 `@littlechic/vision`，並希望在一個其他專案（例如 Next.js 應用）中測試這個套件，推薦使用 `npm pack` 的方式，避免 `npm link` 帶來的 symlink 問題。

## 🧩 適用情境

- 你正在開發一個可重複使用的套件（library）
- 想要在另一個專案中 **本地測試尚未發佈的版本**
- 不想用 `npm link`，以避免 symlink 相依造成 Webpack 或 TypeScript 編譯錯誤

---

## 📦 使用 `npm pack` 測試套件

### 1. 在套件目錄中打包

```bash
cd /path/to/your/package
npm run build     # 如果你的套件有 build 步驟
npm pack
```

這會產出一個 .tgz 檔案，例如：

```bash
@littlechic/vision-1.0.0.tgz
```

### 2. 在應用端安裝該套件

切換到你要測試的專案目錄（例如 Next.js 應用）：

```bash
cd /path/to/your/app
npm install /absolute/path/to/@littlechic/vision-1.0.0.tgz
```

✅ 安裝完成後，你可以像正常使用 npm 套件一樣：

```
import { VisionService } from '@littlechic/vision';
```