@enformik/cli 0.5.0 → 0.6.0

package/dist/site.js

@@ -11,7 +11,7 @@ export class DeployClient {
     constructor(o) {
         this.o = o;
         // Her kullanım yolunda (deploy, status, whoami, app check) dağıtım anahtarı düz metin gitmesin.
-        assertSecureUrl(o.consoleUrl, 'Konsol adresi');
+        assertSecureUrl(o.consoleUrl, 'Console URL');
     }
     url(path) { return joinUrl(this.o.consoleUrl, `/api/deploy/v1${path}`); }
     headers(extra = {}) {
@@ -46,6 +46,31 @@ export class DeployClient {
         return (await this.call(`/deployments/${id}`, { retries: 2 })).deployment;
     }
 }
+/**
+ * Finalizes a deployment. A `409 invalid_state` can mean the first finalize worked and only its reply was lost (the request was retried), or
+ * another run of the same CI job already finalized it, so the deployment's real state decides: running or finished -> carry on with that state;
+ * still waiting for its upload / finalize -> the error stands.
+ */
+export async function finalizeDeployment(client, dep) {
+    try {
+        await client.finalize(dep.deploymentId);
+        return { ...dep, status: 'validating' };
+    }
+    catch (e) {
+        if (!(e instanceof CliError) || e.code !== 'invalid_state')
+            throw e;
+        let cur;
+        try {
+            cur = await client.status(dep.deploymentId);
+        }
+        catch {
+            throw e;
+        } // the state could not be read: the original (actionable) error is the better message
+        if (cur.status === 'awaiting_upload' || cur.status === 'uploaded')
+            throw e;
+        return { ...dep, ...cur };
+    }
+}
 /** Üst üste bu kadar yoklama hatasından sonra bırakılır. */
 const MAX_POLL_FAILURES = 5;
 const TERMINAL = new Set(['live', 'failed', 'expired', 'superseded']);
@@ -67,7 +92,8 @@ export async function waitForDeployment(client, id, opts) {
         catch (e) {
             // Geçici hata (ağ, 5xx): sunucu dağıtımı yayınlıyor olabilir, tek bir yoklama hatası CI'ı kırmasın.
             // Kalıcı hatalar (geçersiz anahtar, 404…) kodla gelir ve hemen iletilir.
-            const transient = e instanceof CliError && (!e.code || e.code === 'deploy_unavailable');
+            // Bir 429 (kodsuz) da geçicidir: sunucu dağıtımı sürdürüyor, yoklamayı kısıtlama yüzünden bırakmayız.
+            const transient = (e instanceof CliError && (!e.code || e.code === 'deploy_unavailable')) || (e instanceof ApiError && e.status === 429 && !e.code);
             if (!transient || ++failures >= MAX_POLL_FAILURES)
                 throw e;
             if (now() - start > opts.timeoutMs)
@@ -82,7 +108,7 @@ export async function waitForDeployment(client, id, opts) {
         if (isTerminal(v.status))
             return v;
         if (now() - start > opts.timeoutMs)
-            throw new CliError(`Zaman aşımı: dağıtım ${Math.round(opts.timeoutMs / 1000)} sn içinde tamamlanmadı (son durum: ${v.status}). Konsolun "Sürümler" sekmesinden izleyebilirsiniz.`);
+            throw new CliError(`Timed out: the deployment did not finish within ${Math.round(opts.timeoutMs / 1000)} s (last status: ${v.status}). You can follow it on the console's "Releases" tab.`);
         await sleep(interval);
         interval = Math.min(interval + 500, 5000);
     }
@@ -128,25 +154,31 @@ export function idempotencyKey(env, rand = randomUUID, contentSha) {
     return `cli-${rand()}`.slice(0, 64);
 }
 const HINTS = {
-    invalid_key: 'Dağıtım anahtarı geçersiz, iptal edilmiş ya da bu siteye ait değil. ENFORMIK_DEPLOY_KEY değerini kontrol edin.',
-    key_expired: 'Dağıtım anahtarının süresi dolmuş. Konsolda yeni bir anahtar oluşturup CI gizli değişkenini güncelleyin.',
-    rate_limited: 'Çok fazla geçersiz anahtar denemesi; biraz bekleyip yeniden deneyin.',
-    developer_site_disabled: 'Bu ortamda geliştirici sitesi etkin değil. Konsolda "Geliştirici sitesi" penceresinden etkinleştirin.',
-    environment_inactive: 'Web sitesi ortamı şu anda kullanılamıyor (ör. abonelik askıda).',
-    deploy_in_progress: 'Bu ortamda devam eden bir dağıtım var; bitmesini bekleyip yeniden deneyin.',
-    deploy_unavailable: 'Dağıtım altyapısı şu anda hazır değil; biraz sonra yeniden deneyin.',
-    deployment_expired: 'Yükleme süresi dolmuş; komutu yeniden çalıştırın.',
-    quota_exceeded: 'Arşiv izin verilen boyutu aşıyor (en çok 50 MB).',
-    size_mismatch: 'Yüklenen içerik bildirilen boyutla uyuşmuyor; komutu yeniden çalıştırın.',
-    checksum_mismatch: 'Yüklenen içeriğin sağlama toplamı uyuşmuyor (yükleme bozulmuş olabilir); komutu yeniden çalıştırın.',
+    invalid_key: 'The deploy key is invalid, revoked, or does not belong to this site. Check the ENFORMIK_DEPLOY_KEY value.',
+    key_expired: 'The deploy key has expired. Create a new key in the console and update the CI secret variable.',
+    rate_limited: 'Too many invalid key attempts; wait a moment and try again.',
+    developer_site_disabled: 'The developer site is not enabled in this environment. Enable it from the "Developer site" dialog in the console.',
+    environment_inactive: 'The website environment is currently unavailable (e.g. the subscription is suspended).',
+    deploy_in_progress: 'A deployment is already in progress in this environment; wait for it to finish and try again.',
+    deploy_unavailable: 'The deployment infrastructure is not ready right now; try again shortly.',
+    deployment_expired: 'The upload window has expired; run the command again.',
+    invalid_state: 'The deployment is not in a state that allows this step (for example it was already finalized or its upload is incomplete); run the command again.',
+    quota_exceeded: 'The archive exceeds the allowed size (50 MB max).',
+    size_mismatch: 'The uploaded content does not match the declared size; run the command again.',
+    checksum_mismatch: 'The checksum of the uploaded content does not match (the upload may be corrupted); run the command again.',
 };
 export function describeDeployError(e) {
     if (!(e instanceof ApiError))
         return e;
+    // Any 429 except one with a known hint (the deploy-key limiter) keeps its rate-limit message and JSON shape (status, retryAfterSeconds).
+    if (e.status === 429 && !(e.code && HINTS[e.code]))
+        return e;
     const hint = e.code ? HINTS[e.code] : undefined;
     const detail = e.body?.details;
     let msg = hint ?? e.message ?? `HTTP ${e.status}`;
     if (e.code === 'artifact_invalid' && Array.isArray(detail))
-        msg = `Arşiv geçerli değil: ${detail.map((d) => d.message).join('; ')}`;
+        msg = `Invalid archive: ${detail.map((d) => d.message).join('; ')}`;
+    if (e.status === 429 && e.retryAfterSeconds !== undefined)
+        msg += ` (retry in about ${e.retryAfterSeconds} s)`;
     return new CliError(msg, 1, e.code, e.body);
 }

package/dist/zip.js

@@ -28,7 +28,7 @@ const MAX_U32 = 0xffffffff;
 /** Girdileri sıralı (deterministik) olarak outPath'e zipler. */
 export function writeZipFile(files, outPath) {
     if (files.length > MAX_ENTRIES)
-        throw new Error(`Zip en fazla ${MAX_ENTRIES} girdi içerebilir.`);
+        throw new Error(`A zip can contain at most ${MAX_ENTRIES} entries.`);
     const sorted = [...files].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
     const fd = openSync(outPath, 'w');
     let offset = 0;
@@ -44,7 +44,7 @@ export function writeZipFile(files, outPath) {
         for (const f of sorted) {
             const data = readFileSync(f.path);
             if (data.length >= MAX_U32)
-                throw new Error(`Dosya çok büyük (zip64 desteklenmiyor): ${f.name}`);
+                throw new Error(`File too large (zip64 is not supported): ${f.name}`);
             const name = Buffer.from(f.name, 'utf8');
             const deflated = deflateRawSync(data, { level: 6 });
             const useDeflate = deflated.length < data.length;
@@ -96,7 +96,7 @@ export function writeZipFile(files, outPath) {
         end.writeUInt32LE(cdStart, 16);
         write(end);
         if (offset >= MAX_U32)
-            throw new Error('Zip 4 GB sınırını aşıyor.');
+            throw new Error('The zip exceeds the 4 GB limit.');
         return { entries: sorted.length, bytes: offset };
     }
     finally {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@enformik/cli",
-  "version": "0.5.0",
-  "description": "Enformik geliştirici CLI'si: web sitesi dağıtımı ve uygulama modülü (şema) yükseltme.",
+  "version": "0.6.0",
+  "description": "Enformik developer CLI: website deployment and application module (schema) upgrades.",
   "license": "MIT",
   "type": "module",
   "bin": {