naro-cli 0.17.0 → 0.19.0

package/dist/deploy.d.ts

@@ -1,7 +1,8 @@
-import { type CacheTransport } from "@next-deploy/build";
+import { type CacheTransport, type LocalBuildDependencies } from "@next-deploy/build";
 import { type CliGitConnection } from "@next-deploy/sdk";
 import type { BuildObserver, DeploymentArtifact, DeploymentStatus, DeploymentStrategyRecord } from "./artifact-types";
 import { type GitInfo } from "./git-info";
+import { type WorkingTreeCopy } from "./working-tree";
 /** The slice of LocalBuildExecutor the deploy flow needs — injectable in tests. */
 export interface DeployBuildExecutor {
     build(input: {
@@ -24,8 +25,26 @@ export declare function readProjectEnv(dir: string): Record<string, string>;
 export declare function eventsObserver(cp: string, deploymentId: string, token: string, fetchImpl?: typeof fetch, logIngestUrl?: string): BuildObserver & {
     /** Sends what is buffered now; never throws. */
     flush(): Promise<void>;
+    /**
+     * Fails this deployment with the error the dashboard shows. The local
+     * build holds only this deployment's token, not the /fail callback's, so
+     * without this a failed build left the row building — LIVE on the
+     * dashboard — until the sweeper's 10 minutes (known-issues #16). Never
+     * throws: the build's own error is what the caller reports.
+     */
+    fail(code: string, message: string): Promise<void>;
 };
 export declare function slugify(value: string): string;
+/**
+ * What copyWorkingTree left out or rewrote, as one line each — built from the
+ * copy so the terminal, MCP and the build log say the same thing.
+ */
+export declare function workingTreeNotices(copy: WorkingTreeCopy): {
+    level: "WARN" | "INFO";
+    message: string;
+}[];
+/** Exported for the test that pins the clone to copyWorkingTree. */
+export declare function localDependencies(sourceDir: string, say?: (message: string) => void): LocalBuildDependencies;
 export interface DeployOptions {
     name?: string | undefined;
     /** Linked project id (.naro/project.json or --project). */
@@ -34,6 +53,13 @@ export interface DeployOptions {
     teamSlug?: string | undefined;
     rootDirectory?: string | null;
     production?: boolean;
+    /**
+     * Deploy to this named environment (its slug) instead of preview. Not with
+     * `production` (the control plane refuses both), and not `production` or
+     * `preview` themselves: those are `production: true` and the default, and
+     * are refused with VALIDATION_FAILED before anything runs.
+     */
+    environment?: string | undefined;
     env?: Record<string, string> | undefined;
     branch?: string | undefined;
     /** Explicit token (--token / MCP config); wins over the stored session. */
@@ -43,6 +69,12 @@ export interface DeployOptions {
     /** Skip the framework gate (deploy even when detection says not deployable). */
     force?: boolean;
     fetch?: typeof fetch;
+    /**
+     * How often to ask whether the deployment finished. Tests set it low: their
+     * control plane answers DEPLOYING first, and a real 2.5 s wait per test was
+     * enough to time some out when the whole suite ran at once.
+     */
+    pollIntervalMs?: number;
     /** Test seam: replaces the local OpenNext build. */
     executor?: DeployBuildExecutor;
     /** Test seam: replaces the `git` calls that read the repository. */
@@ -59,6 +91,11 @@ export interface DeployResult {
     status: DeploymentStatus;
     url: string;
     production: boolean;
+    /**
+     * The named environment it went to, as the control plane confirmed; null
+     * for production and preview.
+     */
+    environment?: string | null;
     /** 끝까지 채워지지 않은 키. */
     missingEnvKeys: string[];
     /** 서버가 확정한 목적지 — 출력과 링크 파일이 이 값을 쓴다. */

package/dist/deploy.js

@@ -2,15 +2,19 @@
 import {
   deployDirectory,
   eventsObserver,
-  parseDotenv,
+  localDependencies,
+  parseDotenv2 as parseDotenv,
   readProjectEnv,
-  slugify
-} from "./chunk-PYRN5XR6.js";
+  slugify,
+  workingTreeNotices
+} from "./chunk-DEEFHVDZ.js";
 import "./chunk-K3NQKI34.js";
 export {
   deployDirectory,
   eventsObserver,
+  localDependencies,
   parseDotenv,
   readProjectEnv,
-  slugify
+  slugify,
+  workingTreeNotices
 };

package/dist/env-consent.d.ts

@@ -4,13 +4,21 @@ export interface EnvConsentContext {
     cwd: string;
     prompter: Prompter;
     output: Output;
+    /** 배포가 가는 이름 있는 환경의 slug. 없으면 production·preview 배포다. */
+    environment?: string;
     /** 테스트 주입용. 기본값은 SDK의 readProjectEnv. */
     readEnv?: (dir: string) => Record<string, string>;
 }
+/** 비밀값은 앞 네 글자까지만 — 8자 이하면 하나도 보이지 않는다. */
+export declare function maskSecretValue(value: string): string;
 export declare function maskEnvValue(key: string, value: string): string;
 /** 동의를 구하기 전에는 존재만 확인한다. 내용은 열지 않는다. */
 export declare function findDotenvFile(dir: string): string | null;
-export declare function envAddGuidance(keys: string[]): string[];
+/**
+ * 값을 채우는 명령 안내. `env add KEY`만 쓰면 target이 `all`이라 production에도
+ * 닿으므로, 환경에 배포할 때는 그 환경의 slug를 붙여 그 환경에만 저장하게 한다.
+ */
+export declare function envAddGuidance(keys: string[], environment?: string): string[];
 /**
  * 누락된 env 키를 채운다. dotenv 파일은 사용자가 명시적으로 동의한 뒤에만
  * 열리고, 그때도 요청된 키의 값만 꺼낸다 — 파일의 나머지 내용은 전송되지 않는다.

package/dist/env-surface.d.ts

@@ -0,0 +1,12 @@
+import type { EnvVarInfo } from "@next-deploy/sdk";
+/**
+ * The values one surface gets, one per key, the way the server's
+ * `envForSurface` picks them for a deployment: the surface's own row beats
+ * `all` whichever the list shows first, and no other surface's row applies
+ * (preview's never reaches an environment). A row's target is its surface's
+ * name: `production`, `preview` or an environment's slug.
+ *
+ * A leaf module on purpose: `naro env pull` and the library deploy (which MCP
+ * imports) both read it, and neither should pull in the other's commands.
+ */
+export declare function pullEnv(rows: EnvVarInfo[], surface: string): Record<string, string>;