empuno 1.1.1 → 1.3.0

package/README.md

@@ -38,6 +38,7 @@ empuno leave-requests.approve 123
 empuno leave-requests.reject 124 --rejection_reason "Yoğun dönem"
 empuno employees.documents.store 45 --document_type is_sozlesmesi --file file=./sozlesme.pdf
 empuno leave-reports.download 12 --output ./rapor.pdf
+empuno reference sgk_exit_codes              # bir alanın geçerli değerleri
 empuno call POST /manager/leave-requests/123/approve    # ham çağrı
 empuno api leaves --status approved                     # salt-okuma Company API
 ```
@@ -50,6 +51,9 @@ komutu CLI güncellemesi olmadan görünür.
 - `--alan @dosya` ya da `--file alan=dosya` → multipart yükleme.
 - `--json '{…}'` / `--json @govde.json`, `--dry-run`, `--output yol`,
   `--profile ad` (birden çok firma).
+- Listeler `--per_page` (≤100) ve `--page` alır; yeni kaydın kimliği yanıtta
+  `flash.created` ya da `redirect.params` içindedir.
+- Geçmiş veri aktarımı (`data-migration.*`) davet/e-posta/bildirim göndermez.
 
 ## Talepler (empuno ekibine)
 

package/empuno.mjs

@@ -21,7 +21,7 @@ import os from 'node:os';
 import path from 'node:path';
 import crypto from 'node:crypto';
 
-const VERSION = '1.1.1'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
+const VERSION = '1.3.0'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
 const NPM_PACKAGE = 'empuno';
 const DEFAULT_URL = 'https://empuno.com';
 const CATALOG_TTL_MS = 10 * 60 * 1000;
@@ -234,7 +234,7 @@ function compareVersions(a, b) {
     return 0;
 }
 
-async function request(auth, method, urlPath, { query = {}, body = null, files = [], output = null, dryRun = false } = {}) {
+async function request(auth, method, urlPath, { query = {}, body = null, files = [], output = null, dryRun = false, headers: extraHeaders = {} } = {}) {
     const url = new URL(urlPath.startsWith('http') ? urlPath : auth.url + urlPath);
     for (const [k, v] of Object.entries(query)) {
         if (Array.isArray(v)) v.forEach((item) => url.searchParams.append(`${k}[]`, String(item)));
@@ -246,6 +246,7 @@ async function request(auth, method, urlPath, { query = {}, body = null, files =
         Accept: 'application/json',
         'User-Agent': `empuno-cli/${VERSION} node/${process.versions.node}`,
         'X-Empuno-Cli': VERSION,
+        ...extraHeaders,
     };
 
     let sendMethod = method;
@@ -647,6 +648,23 @@ function installedViaNpm() {
     }
 }
 
+async function cmdReference(args) {
+    const auth = resolveAuth(args.flags);
+    requireKey(auth);
+    const name = args.positional[0];
+    const { ok, result } = await request(auth, 'GET', `/api/company/v1/reference${name ? `/${encodeURIComponent(name)}` : ''}`);
+    if (wantsText() && ok && name && Array.isArray(result?.data)) {
+        for (const row of result.data) {
+            const key = row.code ?? row.value ?? row.id;
+            const label = row.label ?? row.name ?? '';
+            process.stdout.write(`${String(key).padEnd(24)} ${label}\n`);
+        }
+        return 0;
+    }
+    print(result);
+    return ok ? 0 : 1;
+}
+
 async function cmdUpdate(args) {
     if (installedViaNpm()) {
         // npm'in yönettiği dosyanın üzerine yazmak sürüm kaydını bozar.
@@ -760,8 +778,8 @@ async function cmdTickets(args) {
     const auth = resolveAuth(flags);
     requireKey(auth);
 
-    const send = async (method, urlPath, body = null, query = {}) => {
-        const response = await request(auth, method, urlPath, { body, query, dryRun: flags['dry-run'] });
+    const send = async (method, urlPath, body = null, query = {}, headers = {}) => {
+        const response = await request(auth, method, urlPath, { body, query, headers, dryRun: flags['dry-run'] });
         return response;
     };
 
@@ -789,7 +807,10 @@ async function cmdTickets(args) {
             }
             let context = opts.context ? readJsonArg(String(opts.context)) : {};
             if (opts.command) context = { ...context, command: String(opts.command) };
-            const r = await send('POST', base, { title: String(title), kind, body, priority: opts.priority, context: Object.keys(context).length ? context : undefined });
+            // Aynı içerik → aynı anahtar: betik yeniden denese de ikinci talep açılmaz
+            // (sunucu mevcut talebi duplicate=true ile döner).
+            const idem = crypto.createHash('sha256').update(`${title}|${kind}|${body}`).digest('hex').slice(0, 40);
+            const r = await send('POST', base, { title: String(title), kind, body, priority: opts.priority, context: Object.keys(context).length ? context : undefined }, {}, { 'Idempotency-Key': opts['idempotency-key'] ? String(opts['idempotency-key']) : idem });
             if (r.dryRun) return print(r.result), 0;
             print(r.result);
             return r.ok ? 0 : 1;
@@ -819,6 +840,140 @@ async function cmdTickets(args) {
     }
 }
 
+// ─── geçiş (başka sistemden geçmiş verinin aktarımı) ─────────────────────────
+
+const MIGRATE_KINDS = {
+  employees: { path: '/manager/data-migration/employees/commit', chunk: 200 },
+  leaves: { path: '/manager/data-migration/leaves/commit', chunk: 500 },
+  advances: { path: '/manager/data-migration/advances/commit', chunk: 200 },
+  expenses: { path: '/manager/data-migration/expenses/commit', chunk: 200 },
+  documents: { path: '/manager/data-migration/documents/commit', chunk: 10 },
+};
+
+/** Basit CSV ayrıştırıcı: tırnak, "" kaçışı, ; ya da , ayırıcı (başlıktan seçilir), BOM. */
+function parseCsv(text) {
+  const src = text.replace(/^/, '');
+  const firstLine = src.split(/\r?\n/, 1)[0] || '';
+  const delim = (firstLine.match(/;/g) || []).length > (firstLine.match(/,/g) || []).length ? ';' : ',';
+  const rows = [];
+  let row = [];
+  let field = '';
+  let quoted = false;
+  for (let i = 0; i < src.length; i++) {
+    const c = src[i];
+    if (quoted) {
+      if (c === '"' && src[i + 1] === '"') { field += '"'; i++; }
+      else if (c === '"') quoted = false;
+      else field += c;
+      continue;
+    }
+    if (c === '"') quoted = true;
+    else if (c === delim) { row.push(field); field = ''; }
+    else if (c === '\n' || c === '\r') {
+      if (c === '\r' && src[i + 1] === '\n') i++;
+      row.push(field); field = '';
+      if (row.some((v) => v !== '')) rows.push(row);
+      row = [];
+    } else field += c;
+  }
+  row.push(field);
+  if (row.some((v) => v !== '')) rows.push(row);
+  const [header, ...data] = rows;
+  if (!header) return [];
+  const keys = header.map((h) => h.trim());
+  return data.map((cells) => {
+    const obj = {};
+    keys.forEach((k, idx) => {
+      const v = (cells[idx] ?? '').trim();
+      if (v === '' || !k) return;
+      // CSV değerleri metin kalır (TC, sicil no, telefon); yalnız mantıksal değerler çevrilir.
+      obj[k] = ['true', 'false'].includes(v.toLowerCase()) ? v.toLowerCase() === 'true' : v;
+    });
+    return obj;
+  });
+}
+
+function readRecordsFile(file) {
+  if (!fs.existsSync(file)) throw new UsageError(`dosya bulunamadı: ${file}`);
+  const text = fs.readFileSync(file, 'utf8');
+  if (/\.csv$/i.test(file)) return parseCsv(text);
+  let data;
+  try { data = JSON.parse(text); } catch (e) { throw new UsageError(`geçersiz JSON (${file}): ${e.message}`); }
+  const records = Array.isArray(data) ? data : data?.records;
+  if (!Array.isArray(records)) throw new UsageError('JSON bir dizi ya da {"records": [...]} olmalı');
+  return records;
+}
+
+async function cmdMigrate(args) {
+  const { flags, fields, positional } = args;
+  const [kind, file] = positional;
+  if (!kind || !MIGRATE_KINDS[kind] || !file) {
+    throw new UsageError(`kullanım: empuno migrate <${Object.keys(MIGRATE_KINDS).join('|')}> <kayitlar.json|.csv> [--validate] [--on_existing update] [--employee_id N] [--chunk N]
+alanlar: empuno describe data-migration.${kind && MIGRATE_KINDS[kind] ? kind : 'employees'}.commit · rehber: https://empuno.com/api-docs/agent#gecis`);
+  }
+  const auth = resolveAuth(flags);
+  requireKey(auth);
+  const opts = fieldMap(fields);
+  const spec = MIGRATE_KINDS[kind];
+  const records = readRecordsFile(file);
+  const chunkSize = Math.max(1, Math.min(Number(opts.chunk) || spec.chunk, spec.chunk));
+  const validate = Boolean(flags.validate);
+  const baseDir = path.dirname(path.resolve(file));
+
+  const summary = { kind, file, dry_run: validate, records: records.length, created: 0, updated: 0, skipped: 0, failed: 0, results: [] };
+
+  for (let offset = 0; offset < records.length; offset += chunkSize) {
+    const chunk = records.slice(offset, offset + chunkSize);
+    let response;
+
+    if (kind === 'documents') {
+      const files = [];
+      const manifest = chunk.map((entry, i) => {
+        const filePath = path.resolve(baseDir, String(entry.file ?? ''));
+        files.push({ field: 'files[]', file: filePath });
+        return { ...entry, file: i };
+      });
+      for (const f of files) if (!fs.existsSync(f.file)) throw new UsageError(`dosya bulunamadı: ${f.file}`);
+      response = await request(auth, 'POST', spec.path, {
+        body: { manifest: JSON.stringify(manifest), ...(validate ? { dry_run: 1 } : {}) },
+        files,
+        dryRun: flags['dry-run'],
+      });
+    } else {
+      const body = { records: chunk, ...(validate ? { dry_run: true } : {}) };
+      if (opts.on_existing) body.on_existing = String(opts.on_existing);
+      if (opts.employee_id) body.employee_id = Number(opts.employee_id);
+      response = await request(auth, 'POST', spec.path, { body, dryRun: flags['dry-run'] });
+    }
+
+    if (response.dryRun) {
+      print(response.result);
+      return 0;
+    }
+    const r = response.result || {};
+    if (!response.ok) {
+      // Doğrulama hatası (422) tüm parçayı etkiler: sunucunun errors'ını kayıt indeksine çevir.
+      summary.failed += chunk.length;
+      summary.results.push({ chunk_offset: offset, action: 'failed', status: response.status, message: r.message, errors: r.errors });
+      continue;
+    }
+    for (const key of ['created', 'updated', 'skipped', 'failed']) summary[key] += Number(r[key] || 0);
+    for (const row of r.results || []) summary.results.push({ ...row, index: offset + Number(row.index ?? 0) });
+    if (isTTY) warn(`${Math.min(offset + chunkSize, records.length)}/${records.length} işlendi`);
+  }
+
+  summary.message = `${summary.created} ${validate ? 'eklenecek' : 'eklendi'}, ${summary.updated} güncellen${validate ? 'ecek' : 'di'}, ${summary.skipped} atlandı, ${summary.failed} hatalı${validate ? ' (doğrulama — hiçbir şey yazılmadı)' : ''}`;
+  if (wantsText()) {
+    process.stdout.write(`${summary.message}\n`);
+    for (const row of summary.results.filter((x) => x.action === 'failed')) {
+      process.stdout.write(`  ✗ #${row.index ?? row.chunk_offset}: ${row.reason || row.message || ''}${row.errors ? ' ' + JSON.stringify(row.errors) : ''}\n`);
+    }
+  } else {
+    print(summary);
+  }
+  return summary.failed > 0 ? 1 : 0;
+}
+
 // ─── destek (yalnız empuno ekibinin ajanları — emp_staff_ jetonu) ────────────
 
 function requireStaff(auth) {
@@ -928,7 +1083,8 @@ KURULUM
 KEŞİF
   empuno whoami                      # firma, anahtar türü, kimin adına çalıştığı
   empuno commands [ara] [--module leaves] [--writes|--reads] [--all] [--full]
-  empuno describe <komut>            # yöntem, yol, yol parametreleri, alanlar/kurallar, gereken yetki
+  empuno describe <komut>            # yöntem, yol, yol parametreleri, alanlar/kurallar, gereken yetki, hız sınırı
+  empuno reference [ad]              # geçerli değerler: sgk_exit_codes, employee_document_types, departments, branches, leave_types…
 
 ÇALIŞTIRMA (komut = panel rotası; listeden)
   empuno leave-requests.index --status pending --per_page 50
@@ -946,6 +1102,15 @@ ALANLAR
   --alan @./dosya.pdf | --file alan=./dosya.pdf   # multipart yükleme
   --query anahtar=değer              # yazma isteğinde ek sorgu parametresi
 
+GEÇİŞ (başka sistemden geçmiş veri — JSON ya da CSV; davet/e-posta/bildirim gitmez; tekrar çalıştırmak güvenli)
+  empuno migrate employees calisanlar.csv --validate        # önce yazmadan doğrula
+  empuno migrate employees calisanlar.csv [--on_existing update]   # ayrılmışlar dahil; TC ile eşler
+  empuno migrate leaves izinler.json                        # her satırda identity_number|employee_number + leave_type
+  empuno migrate advances avanslar.csv                      # geçmiş avans + devreden bakiye (deducted_amount)
+  empuno migrate expenses masraflar.csv                     # ödenmiş geçmiş masraf (kategori adla)
+  empuno migrate documents manifest.csv                     # file sütunu: dosya yolu; ≤10'arlı gönderilir
+  alanlar: empuno describe data-migration.<tür>.commit · sıra: çalışanlar → izin → avans → masraf → evrak
+
 TALEPLER (geliştirme isteği, hata, eleştiri, soru → empuno ekibi)
   empuno tickets [--status active|open|answered|closed|all] [--unread] [--mine]
   empuno tickets open "Toplu izin onayı" --kind feature --body "…"|@not.md [--priority high] [--command leave-requests.approve]
@@ -972,8 +1137,9 @@ BELGE: https://empuno.com/api-docs/agent
 
 async function main() {
     const argv = process.argv.slice(2);
-    const ticketish = ['tickets', 'ticket', 'support'].includes(argv.find((a) => !a.startsWith('--')) ?? '');
-    const args = parseArgs(argv, ticketish ? ['mine', 'unread', 'close', 'token-stdin'] : []);
+    const sub0 = argv.find((a) => !a.startsWith('--')) ?? '';
+    const ticketish = ['tickets', 'ticket', 'support'].includes(sub0);
+    const args = parseArgs(argv, ticketish ? ['mine', 'unread', 'close', 'token-stdin'] : sub0 === 'migrate' ? ['validate'] : []);
     const [sub, ...rest] = args.positional;
     args.positional = rest;
 
@@ -982,7 +1148,7 @@ async function main() {
         return 0;
     }
     if (args.flags.help) {
-        if (['tickets', 'ticket', 'support', 'login', 'commands', 'describe', 'call', 'api'].includes(sub)) {
+        if (['tickets', 'ticket', 'support', 'login', 'commands', 'describe', 'call', 'api', 'migrate', 'reference'].includes(sub)) {
             process.stdout.write(HELP);
             return 0;
         }
@@ -1016,6 +1182,11 @@ async function main() {
         case 'tickets':
         case 'ticket':
             return cmdTickets(args);
+        case 'reference':
+        case 'ref':
+            return cmdReference(args);
+        case 'migrate':
+            return cmdMigrate(args);
         case 'support':
             return cmdSupport(args);
         case 'run':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "empuno",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "empuno İK platformunun komut satırı: yönetim panelindeki tüm işlemleri (izin, bordro, vardiya, PDKS, zimmet, masraf, işe alım) yapay zekâ ajanlarına ve otomasyonlara açar.",
   "type": "module",
   "bin": {