@specific.dev/cli 0.1.122 → 0.1.123

package/dist/cli.js

@@ -367814,6 +367814,58 @@ var ApiClient = class {
     }
     return response.json();
   }
+  async createPreviewEnvironment(projectId) {
+    const url = `${this.baseUrl}/environments/preview`;
+    writeLog("api", `POST ${url}`);
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...await this.authHeaders()
+      },
+      body: JSON.stringify({ projectId })
+    });
+    writeLog("api", `Response: ${response.status} ${response.statusText}`);
+    if (!response.ok) {
+      try {
+        const error = await response.json();
+        throw new Error(
+          `Failed to create preview environment: ${error.error} (${error.code})`
+        );
+      } catch (e) {
+        if (e instanceof Error && e.message.startsWith("Failed to create preview")) {
+          throw e;
+        }
+        throw new Error(`Failed to create preview environment: ${response.statusText}`);
+      }
+    }
+    return response.json();
+  }
+  async deletePreviewEnvironment(environmentId) {
+    const url = `${this.baseUrl}/environments/${environmentId}`;
+    writeLog("api", `DELETE ${url}`);
+    const response = await fetch(url, {
+      method: "DELETE",
+      headers: await this.authHeaders()
+    });
+    writeLog("api", `Response: ${response.status} ${response.statusText}`);
+    if (!response.ok) {
+      if (response.status === 404) {
+        return;
+      }
+      try {
+        const error = await response.json();
+        throw new Error(
+          `Failed to delete preview environment: ${error.error} (${error.code})`
+        );
+      } catch (e) {
+        if (e instanceof Error && e.message.startsWith("Failed to delete preview")) {
+          throw e;
+        }
+        throw new Error(`Failed to delete preview environment: ${response.statusText}`);
+      }
+    }
+  }
   async getMe(signal) {
     const url = `${this.baseUrl}/users/me`;
     writeLog("api", `GET ${url}`);
@@ -367891,6 +367943,13 @@ var SpecificClient = class {
   async submitConfigs(deploymentId, configs) {
     await this.client.submitConfigs(deploymentId, configs);
   }
+  // --- Preview Environments ---
+  async createPreviewEnvironment(projectId) {
+    return this.client.createPreviewEnvironment(projectId);
+  }
+  async deletePreviewEnvironment(environmentId) {
+    return this.client.deletePreviewEnvironment(environmentId);
+  }
 };
 function toDeployment(response) {
   return {
@@ -372770,6 +372829,7 @@ import * as fs3 from "fs";
 import * as path3 from "path";
 var PROJECT_ID_FILE = ".specific/project_id";
 var ENVIRONMENT_ID_FILE = ".specific/environment_id";
+var PREVIEW_ENVIRONMENT_ID_FILE = ".specific/preview_environment_id";
 var ProjectNotLinkedError = class extends Error {
   constructor() {
     super(
@@ -372826,6 +372886,21 @@ function writeEnvironmentId(environmentId, projectDir = process.cwd()) {
   }
   fs3.writeFileSync(path3.join(specificDir, "environment_id"), environmentId + "\n");
 }
+function readPreviewEnvironmentId(projectDir = process.cwd()) {
+  const filePath = path3.join(projectDir, PREVIEW_ENVIRONMENT_ID_FILE);
+  if (!fs3.existsSync(filePath)) {
+    return null;
+  }
+  const id = fs3.readFileSync(filePath, "utf-8").trim();
+  return id || null;
+}
+function writePreviewEnvironmentId(environmentId, projectDir = process.cwd()) {
+  const specificDir = path3.join(projectDir, ".specific");
+  if (!fs3.existsSync(specificDir)) {
+    fs3.mkdirSync(specificDir, { recursive: true });
+  }
+  fs3.writeFileSync(path3.join(specificDir, "preview_environment_id"), environmentId + "\n");
+}
 
 // src/lib/auth/credentials.ts
 import * as fs19 from "fs";
@@ -373266,7 +373341,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.122",
+      cli_version: "0.1.123",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -376181,6 +376256,21 @@ async function runDeployPipeline(options2) {
   } else if (!hasProjectId(projectDir)) {
     writeProjectId(projectId);
   }
+  if (options2.preview) {
+    const previousPreviewId = readPreviewEnvironmentId(projectDir);
+    if (previousPreviewId) {
+      console.log("Cleaning up previous preview environment...");
+      try {
+        await client2.deletePreviewEnvironment(previousPreviewId);
+      } catch {
+      }
+    }
+    console.log("Creating preview environment...");
+    const preview = await client2.createPreviewEnvironment(projectId);
+    writePreviewEnvironmentId(preview.id, projectDir);
+    console.log(`Preview environment "${preview.name}" created (expires: ${new Date(preview.expiresAt).toLocaleString()})`);
+    options2.env = preview.name;
+  }
   let environmentName;
   if (options2.env) {
     environmentName = options2.env;
@@ -376402,14 +376492,15 @@ async function deployCommand(options2) {
     console.error(formatConfigError(err, hcl, configPath));
     process.exit(1);
   }
-  const hasNonInteractiveFlags = options2.project || options2.secret?.length || options2.config?.length;
+  const hasNonInteractiveFlags = options2.project || options2.secret?.length || options2.config?.length || options2.preview;
   if (!isInteractive() || hasNonInteractiveFlags) {
     await runDeployPipeline({
       config,
       projectId: options2.project,
       env: options2.env,
       secrets: options2.secret,
-      configs: options2.config
+      configs: options2.config,
+      preview: options2.preview
     });
     return;
   }
@@ -377278,7 +377369,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.122";
+  const currentVersion = "0.1.123";
   const response = await fetch(`${BINARIES_BASE_URL}/latest?t=${Date.now()}`);
   if (!response.ok) {
     throw new Error(`Failed to check for updates: HTTP ${response.status}`);
@@ -377548,7 +377639,7 @@ async function projectListCommand() {
 var program = new Command();
 var env = "production";
 var envLabel = env !== "production" ? `[${env.toUpperCase()}] ` : "";
-program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.122").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.123").enablePositionalOptions();
 program.command("init").description("Initialize project for use with a coding agent").option("--agent <name...>", "Agents to configure (cursor, claude, codex, other)").addHelpText("after", `
 Examples:
   $ specific init
@@ -377569,11 +377660,12 @@ Examples:
   const key = options2.key ?? getDefaultKey();
   devCommand(key, options2.tunnel ?? false);
 });
-program.command("deploy").description("Deploy to Specific infrastructure").option("--project <id>", "Project ID to deploy to (overrides .projectid file)").option("--env <name>", "Target environment (auto-selected if only one exists)").option("--secret <key=value...>", "Secret values (repeatable)").option("--config <key=value...>", "Config values (repeatable)").addHelpText("after", `
+program.command("deploy").description("Deploy to Specific infrastructure").option("--project <id>", "Project ID to deploy to (overrides .projectid file)").option("--env <name>", "Target environment (auto-selected if only one exists)").option("--secret <key=value...>", "Secret values (repeatable)").option("--config <key=value...>", "Config values (repeatable)").option("--preview", "Deploy to an ephemeral preview environment").addHelpText("after", `
 Examples:
   $ specific deploy
   $ specific deploy --env staging
   $ specific deploy --project proj_123
+  $ specific deploy --preview
   $ specific deploy --secret db_url=postgres://... --config domain=app.com`).action((options2) => {
   deployCommand(options2);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/cli",
-  "version": "0.1.122",
+  "version": "0.1.123",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",