@deerdesign/deertools 1.0.2 → 1.0.3

package/README.md

@@ -6,13 +6,15 @@ Log in once from your computer, and grant your AI coding agent (Antigravity, Cur
 
 ### Supported Products
 
-| Product Key | Name | Production URL | Description |
-| :--- | :--- | :--- | :--- |
-| `kosztorys` | DeerTools Kosztorys | `https://connect.deerdesign.pl/kosztorys/` | Floor plan PDF analysis, kitchen area detection, interior cost estimation |
-| `katalog` | DeerTools Katalog | `https://connect.deerdesign.pl/katalog/` | Material catalog (Smart/Modern/High Life), category specs, products |
-| `dostawy` | DeerTools Dostawy | `https://ship.deergroup.pl/` | Logistics, site delivery schedules, supplier shipments, tracking |
-| `supplier` | Supplier Hub | `https://supplier.deergroup.pl/` | Supplier orders, line items, claims, delivery status |
-| `rendermind` | RenderMind | `https://rendermind.deergroup.pl/` | pCon 3D render pipelines, AI image generation, floor plan proxies |
+| Product Command Key | Polish Alias | Name | Production URL | Description |
+| :--- | :--- | :--- | :--- | :--- |
+| `estimate` | `kosztorys` | DeerTools Estimate | `https://connect.deerdesign.pl/kosztorys/` | Floor plan PDF analysis, kitchen area detection, interior cost estimation |
+| `catalog` | `katalog` | DeerTools Catalog | `https://connect.deerdesign.pl/katalog/` | Material catalog (Smart/Modern/High Life), category specs, products |
+| `deliveries` | `dostawy` | DeerTools Deliveries | `https://ship.deergroup.pl/` | Logistics, site delivery schedules, supplier shipments, tracking |
+| `supplier` | — | Supplier Hub | `https://supplier.deergroup.pl/` | Supplier orders, line items, claims, delivery status |
+| `rendermind` | — | RenderMind | `https://rendermind.deergroup.pl/` | pCon 3D render pipelines, AI image generation, floor plan proxies |
+
+*(Both English names like `catalog`, `estimate`, `deliveries` and legacy Polish names like `katalog`, `kosztorys`, `dostawy` are supported interchangeably).*
 
 ---
 
@@ -23,7 +25,7 @@ Requires **Node.js ≥ 18**. Zero runtime dependencies.
 ### Option 1: Run instantly with `npx` (No installation needed)
 
 ```bash
-npx @deerdesign/deertools login rendermind
+npx @deerdesign/deertools login catalog
 ```
 
 ### Option 2: Install globally
@@ -48,10 +50,16 @@ DeerTools CLI implements the official **OAuth 2.1 Authorization Code grant with
 
 ```bash
 # Log in to a single product with read-only access (default):
+deertools login catalog
+
+# Log in to other products (in English or Polish):
+deertools login estimate         # or: deertools login kosztorys
+deertools login deliveries       # or: deertools login dostawy
+deertools login supplier
 deertools login rendermind
 
 # Request read + write scopes:
-deertools login katalog --write
+deertools login catalog --write
 
 # Interactive login across all 5 products sequentially:
 deertools login all
@@ -63,14 +71,14 @@ deertools whoami
 deertools whoami --json
 
 # Revoke local credentials:
-deertools logout rendermind
+deertools logout catalog
 ```
 
 ### How it works under the hood
 
 1. **RFC 8414 Discovery**: The CLI queries `/.well-known/oauth-authorization-server` on the product host to discover authorization and token endpoints.
 2. **Loopback Server**: The CLI starts an ephemeral HTTP server on `127.0.0.1:<random-port>` and generates a cryptographically secure PKCE code verifier and S256 challenge.
-3. **Browser Consent**: The user's default browser opens to the product's `/oauth/authorize` page. The user authenticates (SSO / Microsoft / Magic Link) and approves the requested scopes.
+3. **Browser Consent**: The user's default browser opens to the product's `/oauth/authorize` page. The user authenticates (Microsoft SSO / SSO / Magic Link) and approves the requested scopes.
 4. **Single-Use Authorization Code**: The browser redirects to the loopback server with a short-lived authorization code (60-second TTL). No keys or tokens ever appear in query strings.
 5. **Direct Exchange**: The CLI sends a direct `POST` to the product's token endpoint (`/oauth-token`) with the code verifier.
 6. **Local Storage**: The product issues a scoped API key (`deer_<product>_live_...`) valid for 90 days. The CLI persists it in `~/.deertools/credentials.json` with strict POSIX file permissions (`0600`).
@@ -83,13 +91,14 @@ deertools logout rendermind
 
 ```bash
 # Read high-level llms.txt (public overview and authentication instructions):
+deertools docs catalog
 deertools docs rendermind
 
 # Fetch full OpenAPI 3.0 JSON specification:
-deertools docs rendermind openapi
+deertools docs catalog openapi
 
 # List all available endpoints with required scopes:
-deertools endpoints rendermind
+deertools endpoints catalog
 ```
 
 ### 2. Invoke Product APIs
@@ -98,7 +107,7 @@ The CLI handles authorization headers automatically, rejecting any requests to n
 
 ```bash
 # Call GET endpoint:
-deertools api katalog GET /api/v1/products --query category=flooring
+deertools api catalog GET /api/v1/products --query category=flooring
 
 # Call POST endpoint with JSON payload:
 deertools api rendermind POST /api/v1/visualizations --data '{"prompt":"Modern Scandinavian kitchen"}'
@@ -110,10 +119,11 @@ deertools api rendermind POST /api/v1/visualizations --data-file request.json
 ### 3. Specialized Helpers
 
 ```bash
-# Analyze architectural floor plan PDF and calculate cost estimate (Kosztorys):
+# Analyze architectural floor plan PDF and calculate cost estimate (Estimate / Kosztorys):
 deertools estimate --file floorplan.pdf --kitchen 6
 
 # Install product agent skills into ~/.gemini/config/skills:
+deertools skill install catalog
 deertools skill install rendermind
 ```
 
@@ -124,9 +134,9 @@ deertools skill install rendermind
 In CI pipelines or containerized agents where browser interaction is unavailable, provide API keys via environment variables:
 
 ```bash
-export DEERTOOLS_KOSZTORYS_KEY="deer_kosztorys_live_..."
-export DEERTOOLS_KATALOG_KEY="deer_katalog_live_..."
-export DEERTOOLS_DOSTAWY_KEY="deer_dostawy_live_..."
+export DEERTOOLS_CATALOG_KEY="deer_catalog_live_..."       # or DEERTOOLS_KATALOG_KEY
+export DEERTOOLS_ESTIMATE_KEY="deer_kosztorys_live_..."    # or DEERTOOLS_KOSZTORYS_KEY
+export DEERTOOLS_DELIVERIES_KEY="deer_dostawy_live_..."    # or DEERTOOLS_DOSTAWY_KEY
 export DEERTOOLS_SUPPLIER_KEY="deer_supplier_live_..."
 export DEERTOOLS_RENDERMIND_KEY="deer_rendermind_live_..."
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deerdesign/deertools",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"

package/src/credentials.js

@@ -37,20 +37,39 @@ function saveProduct(productId, entry) {
 
 function removeProduct(productId) {
   const data = readAll();
-  const existed = Boolean(data.products[productId]);
-  delete data.products[productId];
+  const ids = [productId];
+  try {
+    const { getProduct } = require('./registry');
+    const p = getProduct(productId);
+    if (p.aliases) ids.push(...p.aliases);
+  } catch (_) {}
+  let existed = false;
+  for (const id of ids) {
+    if (data.products[id]) {
+      existed = true;
+      delete data.products[id];
+    }
+  }
   writeAll(data);
   return existed;
 }
 
 /** Klucz z zmiennej środowiskowej ma pierwszeństwo (CI, agenty); zwraca też źródło. */
 function getKey(product) {
-  const envName = `DEERTOOLS_${product.id.toUpperCase()}_KEY`;
-  const fromEnv = process.env[envName] || (process.env.DEER_API_KEY && process.env.DEER_API_KEY.startsWith(product.keyPrefix) ? process.env.DEER_API_KEY : '');
-  if (fromEnv) return { key: fromEnv, source: `env:${envName}`, entry: null };
-  const entry = readAll().products[product.id];
-  if (!entry || !entry.key) return null;
-  return { key: entry.key, source: 'file', entry };
+  const idsToCheck = [product.id, ...(product.aliases || [])];
+  for (const pid of idsToCheck) {
+    const envName = `DEERTOOLS_${pid.toUpperCase()}_KEY`;
+    if (process.env[envName]) return { key: process.env[envName], source: `env:${envName}`, entry: null };
+  }
+  if (process.env.DEER_API_KEY && process.env.DEER_API_KEY.startsWith(product.keyPrefix)) {
+    return { key: process.env.DEER_API_KEY, source: 'env:DEER_API_KEY', entry: null };
+  }
+  const products = readAll().products;
+  for (const pid of idsToCheck) {
+    const entry = products[pid];
+    if (entry && entry.key) return { key: entry.key, source: 'file', entry };
+  }
+  return null;
 }
 
 function expiryInfo(entry) {

package/src/registry.js

@@ -1,53 +1,85 @@
 'use strict';
 /**
- * Rejestr produktów DeerTools. Każdy produkt ma własny adres autoryzacji, własny prefiks klucza
- * i własne API. Adres bazowy API i lista endpointów pochodzą z publicznego openapi.json produktu
- * (wykrywanego z llms.txt), więc CLI nie zna endpointów na sztywno.
+ * DeerTools Product Registry.
+ *
+ * Primary CLI product identifiers are in English:
+ *   - estimate    (Polish alias: kosztorys)
+ *   - catalog     (Polish alias: katalog)
+ *   - deliveries  (Polish alias: dostawy)
+ *   - supplier
+ *   - rendermind
  */
 const PRODUCTS = {
-  kosztorys: {
-    name: 'Kosztorys',
+  estimate: {
+    name: 'Estimate',
+    localName: 'Kosztorys',
     site: 'https://connect.deerdesign.pl/kosztorys',
     authorizeUrl: 'https://connect.deerdesign.pl/kosztorys/oauth/authorize',
+    tokenUrl: 'https://vlemuxlubrowuuxpgllk.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_kosztorys_live_',
     fallbackApiBase: 'https://vlemuxlubrowuuxpgllk.supabase.co/functions/v1',
+    aliases: ['kosztorys', 'costs', 'cost'],
   },
-  katalog: {
-    name: 'Katalog Connect',
+  catalog: {
+    name: 'Catalog',
+    localName: 'Katalog Connect',
     site: 'https://connect.deerdesign.pl/katalog',
     authorizeUrl: 'https://connect.deerdesign.pl/katalog/oauth/authorize',
+    tokenUrl: 'https://ftzaobeixglnssemugjf.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_catalog_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://ftzaobeixglnssemugjf.supabase.co/functions/v1/api-gateway',
+    aliases: ['katalog'],
   },
-  dostawy: {
-    name: 'Dostawy',
+  deliveries: {
+    name: 'Deliveries',
+    localName: 'Dostawy',
     site: 'https://ship.deergroup.pl',
     authorizeUrl: 'https://ship.deergroup.pl/oauth/authorize',
+    tokenUrl: 'https://ddyfbvogkumvscckotvb.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_dostawy_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://ddyfbvogkumvscckotvb.supabase.co/functions/v1',
+    aliases: ['dostawy', 'shipping', 'delivery', 'ship'],
   },
   supplier: {
     name: 'Supplier Hub',
+    localName: 'Supplier Hub',
     site: 'https://supplier.deergroup.pl',
     authorizeUrl: 'https://supplier.deergroup.pl/oauth/authorize',
+    tokenUrl: 'https://hubnxvzxdgocbtmkfdsz.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_supplier_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://hubnxvzxdgocbtmkfdsz.supabase.co/functions/v1/public-api',
+    aliases: [],
   },
   rendermind: {
     name: 'RenderMind',
+    localName: 'RenderMind',
     site: 'https://rendermind.deergroup.pl',
     authorizeUrl: 'https://rendermind.deergroup.pl/oauth/authorize',
+    tokenUrl: 'https://lkljsuptgyktkwojnwbu.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_rendermind_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://lkljsuptgyktkwojnwbu.supabase.co/functions/v1/rendermind-api',
+    aliases: [],
   },
 };
 
+const ALIASES = {
+  kosztorys: 'estimate',
+  costs: 'estimate',
+  cost: 'estimate',
+  katalog: 'catalog',
+  dostawy: 'deliveries',
+  shipping: 'deliveries',
+  delivery: 'deliveries',
+  ship: 'deliveries',
+};
+
 const ALL_IDS = Object.keys(PRODUCTS);
 
 function getProduct(id) {
-  const key = String(id || '').toLowerCase();
+  let key = String(id || '').toLowerCase().trim();
+  if (ALIASES[key]) key = ALIASES[key];
   if (!PRODUCTS[key]) {
-    const err = new Error(`Nieznany produkt „${id}”. Dostępne: ${ALL_IDS.join(', ')}.`);
+    const err = new Error(`Nieznany produkt „${id}”. Dostępne: ${ALL_IDS.join(', ')} (lub po polsku: kosztorys, katalog, dostawy).`);
     err.exitCode = 2;
     throw err;
   }
@@ -59,4 +91,4 @@ function resolveProducts(arg) {
   return String(arg).split(',').map((s) => getProduct(s.trim()));
 }
 
-module.exports = { PRODUCTS, ALL_IDS, getProduct, resolveProducts };
+module.exports = { PRODUCTS, ALIASES, ALL_IDS, getProduct, resolveProducts };