@dimension-studios/shop-browser 1.31.0-preprod-release.147

package/README.md

@@ -0,0 +1,110 @@
+# @dimension-studios/shop-browser
+
+Interactive CLI to pick a TikTok shop (authorized for your API token), load cookies from the Dimension **TTK Fetch** API, open **Chromium** with Playwright, and navigate to common TikTok Seller / Affiliate URLs.
+
+Uses the same credentials as **`@dimension-studios/ttk-proxy`**. Publishable tarball includes only compiled `dist/` and `bin/` — no database or internal monorepo code.
+
+## Requirements
+
+- Node.js ≥ 24 (matching the monorepo; see repo `engines`).
+- Credentials for `/ttk-proxy/*` endpoints (API URL + key + secret).
+- Backend support for **`GET /ttk-proxy/shops/search?q=`** (installed with the Node API that exposes TTK proxy).
+
+## Installation (CLI users)
+
+```bash
+npm install -g @dimension-studios/shop-browser
+```
+
+Install Playwright browsers once:
+
+```bash
+npx playwright install chromium
+```
+
+If Chromium cannot launch, set `EXECUTABLE_PATH` to your Chrome/Chromium executable (documented below).
+
+## First-time setup
+
+Either set environment variables (e.g. in your shell profile) or persist them via the bundled config (same UX as `@dimension-studios/ttk-proxy`):
+
+### Environment variables (recommended)
+
+```bash
+export TTK_FETCH_API_URL="https://your-node-api.example.com"
+export TTK_FETCH_API_KEY="your-api-key"
+export TTK_FETCH_API_SECRET="your-api-secret"
+```
+
+Then verify:
+
+```bash
+shop-browser config
+```
+
+### Save credentials with config:set
+
+```bash
+shop-browser config:set apiUrl "https://your-node-api.example.com"
+shop-browser config:set apiKey "your-api-key"
+shop-browser config:set apiSecret "your-api-secret"
+
+shop-browser config --show
+```
+
+## Usage
+
+Run with **no arguments** to start the flow:
+
+```bash
+shop-browser
+```
+
+1. Search for a shop by name or slug (at least **2 characters**). Results come from your token’s authorized shops only.
+2. Choose a destination page (Seller Center, Affiliate Center, Support messages).
+3. Close the browser window when done; the process exits.
+
+### Optional environment
+
+| Variable | Purpose |
+|----------|--------|
+| `HEADLESS` | If `true` or `1`, runs Playwright headless (default: visible window). |
+| `EXECUTABLE_PATH` | Path to Chrome/Chromium if the bundled Playwright browser is not used. |
+
+Copy `.env.example` to `.env` only for local development; do not commit real secrets.
+
+### Help and version
+
+```bash
+shop-browser --help
+shop-browser --version
+shop-browser config --help
+```
+
+## Development (in this monorepo)
+
+```bash
+npm install
+npm run build -w @dimension-studios/shop-browser
+npm run type-check -w @dimension-studios/shop-browser
+```
+
+Run from source (expects env via `dotenv` / linked root `.env`):
+
+```bash
+npm run start -w @dimension-studios/shop-browser
+# or from repo root:
+npm run tools:isb
+```
+
+## Related packages
+
+- **`@dimension-studios/ttk-proxy`** — call TTK proxy APIs from the terminal, including `ttk-proxy shops <query>` for debugging shop search.
+
+## License
+
+ISC
+
+## Author
+
+Dimension Studios

package/bin/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import("../dist/index.mjs").catch((err) => {
+  console.error("Failed to load shop-browser:", err)
+  process.exit(1)
+})

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{readFileSync as e}from"node:fs";import{dirname as t,join as n}from"node:path";import{fileURLToPath as r}from"node:url";import{logger as i}from"@rharkor/logger";import{program as a}from"commander";import"dotenv/config";import o from"conf";import{setTimeout as s}from"node:timers/promises";import{Separator as c,search as l,select as u}from"@inquirer/prompts";import{chromium as d}from"playwright";const f=new o({projectName:`dimension-shop-browser`});function p(){let e=f.get(`apiUrl`),t=f.get(`apiKey`),n=f.get(`apiSecret`);if(!e||!t||!n)throw Error("Missing API configuration. Run `shop-browser config` or set TTK_FETCH_API_URL, TTK_FETCH_API_KEY, and TTK_FETCH_API_SECRET.");return{apiUrl:e,apiKey:t,apiSecret:n}}function m(e){e.apiUrl&&f.set(`apiUrl`,e.apiUrl),e.apiKey&&f.set(`apiKey`,e.apiKey),e.apiSecret&&f.set(`apiSecret`,e.apiSecret)}function h(){let e=process.env.TTK_FETCH_API_URL,t=process.env.TTK_FETCH_API_KEY,n=process.env.TTK_FETCH_API_SECRET;e&&f.set(`apiUrl`,e),t&&f.set(`apiKey`,t),n&&f.set(`apiSecret`,n)}function g(e){try{if(e.clear){f.clear(),i.success(`✅ Configuration cleared`);return}if(e.show){let e=f.store;i.info(`📋 Current configuration:`),console.log(JSON.stringify(e,null,2));return}h();let t=f.get(`apiUrl`),n=f.get(`apiKey`),r=f.get(`apiSecret`);(!t||!n||!r)&&(i.error(`❌ Missing configuration`),i.info(`Please set the following environment variables:`),i.info(`  - TTK_FETCH_API_URL`),i.info(`  - TTK_FETCH_API_KEY`),i.info(`  - TTK_FETCH_API_SECRET`),i.info(`Or manually set them using:`),i.info(` shop-browser config:set apiUrl "your-url"`),i.info(` shop-browser config:set apiKey "your-key"`),i.info(` shop-browser config:set apiSecret "your-secret"`),process.exit(1));let a=t,o=n,s=r;i.success(`✅ Configuration loaded successfully`),i.info(`📋 Current configuration:`),i.info(`  API URL: ${a}`),i.info(`  API Key: ${o}`),i.info(`  API Secret: ${c(s)}`);function c(e){return!e||e.length<8?`*`.repeat(e.length):`${e.slice(0,4)}${`*`.repeat(e.length-8)}${e.slice(-4)}`}}catch(e){i.error(`❌ Failed to manage configuration`),e instanceof Error?i.error(e.message):i.error(String(e)),process.exit(1)}}function _(e,t){try{[`apiUrl`,`apiKey`,`apiSecret`].includes(e)||(i.error(`❌ Invalid config key: ${e}`),i.info(`Valid keys: apiUrl, apiKey, apiSecret`),process.exit(1)),m({[e]:t}),i.success(`✅ Set ${e} successfully`)}catch(e){i.error(`❌ Failed to set configuration`),e instanceof Error?i.error(e.message):i.error(String(e)),process.exit(1)}}async function v(e){let{apiUrl:t,apiKey:n,apiSecret:r}=p(),i=new URLSearchParams({q:e.trim()}),a=await fetch(`${t}/ttk-proxy/shops/search?${i}`,{method:`GET`,headers:{"X-Api-Key":n,"X-Api-Secret":r},signal:AbortSignal.timeout(15e3)});if(!a.ok){let e=await a.text();throw Error(`Shop search failed (${a.status}): ${e||a.statusText}`)}return(await a.json()).shops}async function y(e){let{apiUrl:t,apiKey:n,apiSecret:r}=p(),i=await fetch(`${t}/ttk-proxy/get-cookies`,{method:`POST`,headers:{"Content-Type":`application/json`,"X-Api-Key":n,"X-Api-Secret":r},body:JSON.stringify({shopId:e}),signal:AbortSignal.timeout(15e3)});if(!i.ok){let e=await i.text();throw Error(`Could not fetch cookies (${i.status}): ${e||i.statusText}`)}return(await i.json()).cookies??[]}const b=[{name:`TikTok Seller Center`,value:`https://seller-us.tiktok.com/homepage`},{name:`TikTok Affiliate Center`,value:`https://affiliate-us.tiktok.com`},{name:`TikTok Support Messages`,value:`https://seller-us.tiktok.com/chat/inbox/current`}];function x(){p()}function S(){let e=process.env.HEADLESS?.toLowerCase();return e===`true`||e===`1`}function C(){let e=process.env.EXECUTABLE_PATH?.trim();return e?.length?e:void 0}async function w(){x();let e=await y((await l({message:`Select a shop:`,source:async(e,{signal:t})=>{let n=e?.trim();if(t.aborted||!n)return[];if(n.length<2)return[new c(`Enter at least 2 characters to search`)];await s(300);let r=await v(n).catch(e=>(console.error(e instanceof Error?e.message:e),[]));return t.aborted?[]:r.length===0?[new c(`No shops found — try another search`)]:r.map(e=>({name:`${e.name} (${e.slug})`,value:{id:e.id,slug:e.slug,name:e.name}}))}})).id);if(!Array.isArray(e)||e.length===0)throw Error(`No cookies returned for this shop. Check TTK proxy access for this shop.`);let t=e,n=await u({message:`Select the page you want to navigate to:`,choices:[...b]}),r=await d.launch({headless:S(),executablePath:C(),args:[`--no-sandbox`,`--disable-setuid-sandbox`,`--disable-popup-blocking`,`--disable-external-protocol-handling`]}),i=await r.newContext({viewport:null});await i.addCookies(t);let a=await i.newPage();await a.goto(n),console.warn(`Browser opened. Close the browser window to end the process.`),a.on(`close`,()=>r.close()),process.on(`SIGINT`,()=>{console.warn(`
+Received SIGINT. Closing browser...`),r.close()}),await new Promise(e=>r.on(`disconnected`,e)),console.warn(`Browser closed by user. Exiting...`),process.exit(0)}const T=n(t(r(import.meta.url)),`..`,`package.json`),E=JSON.parse(e(T,`utf8`));await i.init(),h(),a.name(`shop-browser`).description(`Open TikTok shop pages using TTK proxy cookies`).version(E.version),a.command(`config`).description(`Manage TTK Fetch API credentials`).option(`-s, --show`,`Show current configuration`).option(`-c, --clear`,`Clear all configuration`).action(e=>{g(e)}),a.command(`config:set`).description(`Set a configuration value`).argument(`<key>`,`Configuration key (apiUrl, apiKey, apiSecret)`).argument(`<value>`,`Configuration value`).action((e,t)=>{_(e,t)});const D=process.argv.slice(2),O=D[0];if(D.length===0)try{await w()}catch(e){i.error(e instanceof Error?e.message:String(e)),process.exit(1)}else O===`config`||O===`config:set`?a.parse(process.argv):O===`-h`||O===`--help`?(i.info(`\n${a.helpInformation()}`),i.info(`Run "${a.name()}" with no arguments to search for a shop and open Chromium with cookies.\n`)):O===`-V`||O===`--version`?i.info(E.version):(i.error(`Unknown argument: ${O??``}`),process.exit(1));export{};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@dimension-studios/shop-browser",
+  "version": "1.31.0-preprod-release.147",
+  "description": "Open TikTok shop pages in Chromium using TTK proxy cookies",
+  "keywords": [
+    "tiktok",
+    "shop",
+    "browser",
+    "playwright",
+    "cli"
+  ],
+  "author": "Dimension Studios",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dimension-studios/dimension.git",
+    "directory": "packages/shop-browser"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "shop-browser": "./bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown && chmod +x bin/cli.js",
+    "clean": "rm -rf dist",
+    "dev": "tsdown --watch",
+    "start": "dotenv -- tsx src/index.ts",
+    "type-check": "tsgo --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@rharkor/logger": "1.3.3",
+    "commander": "14.0.3",
+    "conf": "15.1.0",
+    "dotenv": "17.4.2",
+    "@inquirer/prompts": "8.4.1",
+    "playwright": "1.59.1",
+    "tsdown": "0.21.7"
+  },
+  "devDependencies": {
+    "@types/node": "24.12.2",
+    "dotenv-cli": "11.0.0",
+    "tsx": "4.21.0",
+    "@typescript/native-preview": "7.0.0-dev.20260415.1"
+  }
+}