@enformik/cli 0.1.1 → 0.2.0

package/README.md

@@ -23,20 +23,21 @@ npx @enformik/cli site deploy --dir dist
 
 ## Şema (modül) yükseltme
 
-Gerekenler: uygulamanızda **Şema yükseltici** (ya da Yönetici) rolünde bir **API istemcisi** (konsol → uygulamanın "API erişimi" bölümü) ve uygulamada kurulu bir modül. Modülün **ilk kurulumunu** bir yönetici yapar; sonraki yükseltmeler bu CLI ile yapılır.
+Gerekenler: uygulamanızda **Şema yükseltici** (yalnızca yükseltme), **Şema oluşturucu** (yükseltme + ilk kurulum) ya da Yönetici rolünde bir **API istemcisi** (konsol → **API Anahtarları** sayfası). Modülün ilk kurulumu `schema install` ile (Şema oluşturucu/Yönetici), sonraki yükseltmeler `schema push` ile yapılır.
 
 ```bash
 export ENFORMIK_APP_URL=https://<uygulama-adresiniz>
 export ENFORMIK_CLIENT_ID=apic-…
 export ENFORMIK_CLIENT_SECRET=…
 
+npx @enformik/cli schema install --manifest module.json --yes  # modülün ilk kurulumu (--dry-run: yalnızca göster)
 npx @enformik/cli schema diff --manifest module.json --check   # değişiklik varsa çıkış kodu 2
 npx @enformik/cli schema push --manifest module.json --yes
 ```
 
 > **Dikkat:** modül (şema) değişikliği uygulamanın **tüm çalışma alanlarını** etkiler. Canlı uygulamaya laptop'tan değil, CI'dan ve canlıya özel bir istemci ile uygulayın.
 
-"Şema yükseltici" rolü betik, otomasyon, yetki tanımı, veri kaynağı, etkileşimli sayfa, arayüz uzantısı ve tohum veri içeren manifestleri ve alan türü değişikliklerini uygulayamaz; bunlar bir yönetici tarafından uygulanır.
+"Şema yükseltici" ve "Şema oluşturucu" rolleri betik, otomasyon, yetki tanımı, veri kaynağı, etkileşimli sayfa, arayüz uzantısı ve tohum veri içeren manifestleri ve alan türü değişikliklerini uygulayamaz; bunlar bir yönetici tarafından uygulanır.
 
 ## Komutlar
 

package/dist/cli.js

@@ -3,7 +3,7 @@ import { readFileSync, realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { parseArgs } from 'node:util';
 import { link } from './commands/link.js';
-import { schemaDiff, schemaPush } from './commands/schema.js';
+import { schemaDiff, schemaInstall, schemaPush } from './commands/schema.js';
 import { siteDeploy, siteStatus } from './commands/site.js';
 import { whoami } from './commands/whoami.js';
 import { loadConfig, resolveSettings } from './config.js';
@@ -16,7 +16,7 @@ const OPTIONS = {
     config: { type: 'string' },
     'console-url': { type: 'string' }, 'app-url': { type: 'string' }, workspace: { type: 'string' },
     module: { type: 'string' }, manifest: { type: 'string' }, dir: { type: 'string' },
-    check: { type: 'boolean' }, yes: { type: 'boolean', short: 'y' }, 'seed-data': { type: 'boolean' }, 'expect-host': { type: 'string' },
+    check: { type: 'boolean' }, yes: { type: 'boolean', short: 'y' }, 'seed-data': { type: 'boolean' }, 'dry-run': { type: 'boolean' }, 'expect-host': { type: 'string' },
     'no-wait': { type: 'boolean' }, timeout: { type: 'string' }, 'no-verify': { type: 'boolean' },
 };
 const GLOBAL = ['json', 'help', 'version', 'debug', 'config'];
@@ -24,6 +24,7 @@ const COMMANDS = {
     link: { flags: ['console-url', 'app-url', 'workspace', 'module', 'manifest', 'dir', 'no-verify'], run: link, usage: 'enformik link [--console-url U] [--app-url U] [--workspace ID] [--module SLUG] [--manifest YOL] [--dir KLASÖR]' },
     whoami: { flags: ['console-url', 'app-url', 'workspace'], run: whoami, usage: 'enformik whoami' },
     'schema diff': { flags: ['app-url', 'workspace', 'module', 'manifest', 'check', 'seed-data', 'expect-host'], run: schemaDiff, usage: 'enformik schema diff [--manifest module.json] [--check]' },
+    'schema install': { flags: ['app-url', 'workspace', 'module', 'manifest', 'yes', 'dry-run', 'seed-data', 'expect-host'], run: schemaInstall, usage: 'enformik schema install [--manifest module.json] [--yes] [--dry-run]' },
     'schema push': { flags: ['app-url', 'workspace', 'module', 'manifest', 'yes', 'seed-data', 'expect-host'], run: schemaPush, usage: 'enformik schema push [--manifest module.json] [--yes] [--seed-data]' },
     'site deploy': { flags: ['console-url', 'dir', 'no-wait', 'timeout'], run: siteDeploy, usage: 'enformik site deploy [--dir dist] [--no-wait] [--timeout 600]' },
     'site status': { flags: ['console-url'], run: siteStatus, usage: 'enformik site status' },
@@ -37,6 +38,7 @@ Komutlar
   link          .enformik/config.json yazar (adresler; sır içermez)
   whoami        Hangi kimlikle, hangi hedefe bağlanıldığını gösterir
   schema diff   Modül manifestini uygulamadakiyle karşılaştırır (--check: değişiklik varsa çıkış kodu 2)
+  schema install  Modülü uygulamaya İLK kez kurar (rol: Şema oluşturucu; --dry-run yalnızca gösterir)
   schema push   Değişiklikleri uygular (etkileşimsiz ortamda --yes gerekir)
   site deploy   Derlenmiş siteyi (varsayılan: dist) web sitesi ortamına yayınlar
   site status   Hedef site ve canlı sürüm bilgisi

package/dist/commands/schema.js

@@ -5,12 +5,12 @@ import { CliError } from '../errors.js';
 import { assertSecureUrl } from '../http.js';
 import { adminOnlySections, parseManifest, pendingChanges, renderDiff, SchemaClient, typeChanges } from '../schema.js';
 /** Ortak hazırlık: manifest → uygulama keşfi → belirteç → modül kimliği. */
-async function prepare(ctx) {
+async function prepare(ctx, mode = 'existing') {
     const { settings, out } = ctx;
     if (!settings.appUrl)
         throw new CliError('Uygulama adresi yok. `enformik link --app-url https://…` çalıştırın ya da ENFORMIK_APP_URL tanımlayın.');
     if (!settings.clientId || !settings.clientSecret) {
-        throw new CliError('ENFORMIK_CLIENT_ID ve ENFORMIK_CLIENT_SECRET tanımlı olmalı (konsolda uygulamanızın "API erişimi" bölümünden rolü "Şema yükseltici" olan bir istemci oluşturun).');
+        throw new CliError('ENFORMIK_CLIENT_ID ve ENFORMIK_CLIENT_SECRET tanımlı olmalı (konsolda "API anahtarları" sayfasından rolü "Şema yükseltici" — ilk kurulum için "Şema oluşturucu" — olan bir istemci oluşturun).');
     }
     const appUrl = assertSecureUrl(settings.appUrl, 'Uygulama adresi');
     const expect = ctx.flags['expect-host'];
@@ -33,7 +33,7 @@ async function prepare(ctx) {
     const seedData = ctx.flags['seed-data'] === true;
     const admin = adminOnlySections(manifest, { seedData });
     if (admin.length > 0) {
-        out.warn(`Not: manifest yönetici gerektiren bölümler içeriyor (${admin.join(', ')}). "Şema yükseltici" rolündeki bir istemci bunu uygulayamaz.`);
+        out.warn(`Not: manifest yönetici gerektiren bölümler içeriyor (${admin.join(', ')}). "Şema yükseltici/oluşturucu" rolündeki bir istemci bunu uygulayamaz.`);
     }
     const app = await discoverApp(settings.appUrl, ctx.version, ctx.fetchImpl);
     const workspaceId = settings.workspaceId || app.tenantId;
@@ -41,6 +41,12 @@ async function prepare(ctx) {
         throw new CliError('Çalışma alanı belirlenemedi. --workspace <kimlik> verin ya da `enformik link --workspace` ile kaydedin.');
     const tok = await fetchAccessToken(app, settings.clientId, settings.clientSecret, ctx.version, ctx.fetchImpl);
     const client = new SchemaClient({ appUrl: settings.appUrl, token: tok.token, workspaceId, version: ctx.version, fetchImpl: ctx.fetchImpl });
+    if (mode === 'install') {
+        const existing = await client.findModule(slug);
+        if (existing)
+            throw new CliError(`"${slug}" modülü bu uygulamada zaten kurulu (sürüm ${existing.version}). Yükseltmek için \`enformik schema push\` kullanın.`);
+        return { client, manifest, manifestJson: JSON.stringify(manifest), moduleId: '', installedVersion: '', appHost: appUrl.hostname, seedData };
+    }
     const mod = await client.resolveModule(slug);
     return { client, manifest, manifestJson: JSON.stringify(manifest), moduleId: mod.id, installedVersion: mod.version, appHost: appUrl.hostname, seedData };
 }
@@ -109,3 +115,39 @@ export async function schemaPush(ctx) {
     ctx.out.result({ ...summary(p, res), applied: true });
     return 0;
 }
+/** enformik schema install [--yes] [--dry-run] — modülün ilk kurulumu (rol: Şema oluşturucu ya da Yönetici). */
+export async function schemaInstall(ctx) {
+    const p = await prepare(ctx, 'install');
+    const slug = p.manifest.module.slug;
+    const dry = await p.client.install(p.manifestJson, { seedData: p.seedData, dryRun: true });
+    ctx.out.info(`Modül: ${slug}  yeni kurulum → manifest ${p.manifest.module.version}`);
+    ctx.out.info(renderDiff(ctx.out, dry, { appHost: p.appHost }));
+    const base = { module: slug, manifestVersion: p.manifest.module.version, changes: pendingChanges(dry.diffs).length, diffs: dry.diffs, errors: dry.errors };
+    if (dry.errors.length > 0) {
+        ctx.out.result({ ...base, installed: false });
+        return 1;
+    }
+    if (ctx.flags['dry-run'] === true) {
+        ctx.out.result({ ...base, installed: false });
+        return 0;
+    }
+    if (ctx.flags.yes !== true) {
+        if (!ctx.isTTY)
+            throw new CliError('Etkileşimli terminal yok: modülü kurmak için --yes verin (sessizce onaylanmaz).');
+        if (!(await ctx.confirm('Modülü kurmak istiyor musunuz?'))) {
+            ctx.out.info('Vazgeçildi; hiçbir şey kurulmadı.');
+            ctx.out.result({ ...base, installed: false });
+            return 1;
+        }
+    }
+    const res = await p.client.install(p.manifestJson, { seedData: p.seedData, dryRun: false });
+    if (res.errors.length > 0) {
+        for (const e of res.errors)
+            ctx.out.error(`Hata: ${e}`);
+        ctx.out.result({ ...base, diffs: res.diffs, errors: res.errors, installed: false });
+        return 1;
+    }
+    ctx.out.info(ctx.out.paint('green', `✓ Kuruldu: modül ${slug} ${p.manifest.module.version} (${pendingChanges(res.diffs).length} kaynak). Sonraki değişiklikler için \`enformik schema push\` kullanın.`));
+    ctx.out.result({ ...base, moduleId: res.moduleId, diffs: res.diffs, errors: [], installed: true });
+    return 0;
+}

package/dist/schema.js

@@ -110,6 +110,33 @@ export class SchemaClient {
         const j = res.json;
         return { id: j.id, name: j.name, version: j.version };
     }
+    /** slug → kurulu modül ya da null (404 module_not_found); diğer hatalar fırlatılır. */
+    async findModule(slug) {
+        try {
+            return await this.resolveModule(slug);
+        }
+        catch (e) {
+            if (e instanceof CliError && e.code === 'module_not_found')
+                return null;
+            throw e;
+        }
+    }
+    /** Modülün İLK kurulumu (POST /api/modules/install, module.install yetkisi). dryRun: yalnızca fark, kurmaz. */
+    async install(manifestJson, opts) {
+        const q = [opts.dryRun ? 'dry_run=true' : '', opts.seedData ? 'seed_data=true' : ''].filter(Boolean).join('&');
+        // Kurulum tekrar edilmemeli (yeniden denemede 409 module_exists dönerdi); yalnızca kuru çalıştırma yeniden denenebilir.
+        const res = await request(joinUrl(this.o.appUrl, `/api/modules/install${q ? `?${q}` : ''}`), {
+            method: 'POST', headers: this.headers({ 'Content-Type': 'application/json' }), body: manifestJson,
+            retries: opts.dryRun ? 1 : 0, timeoutMs: 300_000, fetchImpl: this.o.fetchImpl,
+        });
+        try {
+            ensureOk(res);
+        }
+        catch (e) {
+            throw describeSchemaError(e, { install: true });
+        }
+        return normalizeDiff(res.json);
+    }
     async diff(moduleId, manifestJson, opts) {
         const res = await request(joinUrl(this.o.appUrl, `/api/modules/${moduleId}/diff${opts.seedData ? '?seed_data=true' : ''}`), {
             method: 'POST', headers: this.headers({ 'Content-Type': 'application/json' }), body: manifestJson, retries: 1, timeoutMs: 120_000, fetchImpl: this.o.fetchImpl,
@@ -154,14 +181,18 @@ export function describeSchemaError(e, ctx) {
         case 'breaking_change_blocked':
             return new CliError(`${e.message}`, 1, e.code, e.body);
         case 'module_not_found':
-            return new CliError(`"${ctx.slug ?? 'modül'}" slug'lı bir modül bu uygulamada kurulu değil. Modülün ilk kurulumunu (içe aktarma) bir yönetici bir kez yapmalıdır; sonraki yükseltmeleri bu CLI yapar.`, 1, e.code);
+            return new CliError(`"${ctx.slug ?? 'modül'}" slug'lı bir modül bu uygulamada kurulu değil. İlk kurulumu \`enformik schema install\` ile ("Şema oluşturucu" rolündeki bir istemciyle) ya da bir yönetici yapar; sonraki yükseltmeleri \`schema push\` yapar.`, 1, e.code);
+        case 'module_exists':
+            return new CliError('Bu slug ile bir modül zaten kurulu. Var olanı yükseltmek için `enformik schema push` kullanın.', 1, e.code);
         case 'payment_required':
             return new CliError('Uygulamanın planı/ödeme durumu nedeniyle işlem engellendi (402). Konsoldan abonelik durumunu kontrol edin.', 1, e.code);
     }
     if (e.status === 401)
         return new CliError('Kimlik reddedildi (401): belirteç geçersiz ya da istemci iptal edilmiş.', 1, 'unauthorized');
     if (e.status === 403) {
-        return new CliError('Bu istemcinin rolü modül yükseltmeye yetmiyor (403). Konsolda rolü "Şema yükseltici" ya da "Yönetici" olan bir API istemcisi kullanın.' +
+        return new CliError((ctx.install
+            ? 'Bu istemcinin rolü yeni modül kurmaya yetmiyor (403). Konsolda rolü "Şema oluşturucu" ya da "Yönetici" olan bir API istemcisi kullanın.'
+            : 'Bu istemcinin rolü modül yükseltmeye yetmiyor (403). Konsolda rolü "Şema yükseltici", "Şema oluşturucu" ya da "Yönetici" olan bir API istemcisi kullanın.') +
             (body.required ? ` (gereken yetki: ${body.required})` : ''), 1, 'forbidden');
     }
     if (e.status === 404)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enformik/cli",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Enformik geliştirici CLI'si: web sitesi dağıtımı ve uygulama modülü (şema) yükseltme.",
   "license": "UNLICENSED",
   "type": "module",