@specific.dev/cli 0.1.122 → 0.1.124

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.124",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -373591,10 +373666,6 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/lib/beta/registry.ts
 var BETA_REGISTRY = [
-  {
-    name: "temporal",
-    description: "Managed Temporal workflow engine for durable workflows and background tasks"
-  },
   {
     name: "mail",
     description: "Managed email sending via SMTP for transactional emails"
@@ -375148,6 +375219,7 @@ function PhaseIndicator({
   showSpinner = true
 }) {
   const phases = [
+    "creating-preview",
     "creating-tarball",
     "creating-deployment",
     "uploading",
@@ -375299,7 +375371,7 @@ function formatErrorCode(code) {
 function StructuredError({ error }) {
   return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, /* @__PURE__ */ React7.createElement(Text7, { color: "red", bold: true }, formatErrorCode(error.code), ": ", error.message), error.resource && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, "Resource: ", error.resource), error.output && /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { bold: true }, "Output:"), /* @__PURE__ */ React7.createElement(Text7, null, error.output)));
 }
-function DeployUI({ envFlag, config }) {
+function DeployUI({ envFlag, preview, config }) {
   const { exit } = useApp3();
   const [state, setState] = useState6({ phase: "checking-auth" });
   const clientRef = React7.useRef(null);
@@ -375487,6 +375559,15 @@ function DeployUI({ envFlag, config }) {
           }));
           return;
         }
+        if (preview) {
+          setState((s) => ({
+            ...s,
+            phase: "creating-preview",
+            environments,
+            previewStatus: "Creating preview environment"
+          }));
+          return;
+        }
         if (envFlag) {
           const match = environments.find((e) => e.name === envFlag);
           if (!match) {
@@ -375549,6 +375630,45 @@ function DeployUI({ envFlag, config }) {
       cancelled = true;
     };
   }, [state.phase, state.projectId]);
+  useEffect6(() => {
+    if (state.phase !== "creating-preview" || !state.projectId) return;
+    let cancelled = false;
+    async function createPreview() {
+      try {
+        const token = await getValidAccessToken();
+        const client2 = new SpecificClient({ accessToken: token });
+        const projectDir = process.cwd();
+        const previousPreviewId = readPreviewEnvironmentId(projectDir);
+        if (previousPreviewId) {
+          setState((s) => ({ ...s, previewStatus: "Tearing down previous preview environment" }));
+          try {
+            await client2.deletePreviewEnvironment(previousPreviewId);
+          } catch {
+          }
+        }
+        if (cancelled) return;
+        setState((s) => ({ ...s, previewStatus: "Creating preview environment" }));
+        const previewEnv = await client2.createPreviewEnvironment(state.projectId);
+        writePreviewEnvironmentId(previewEnv.id, projectDir);
+        if (cancelled) return;
+        setState((s) => ({
+          ...s,
+          phase: "creating-tarball",
+          environmentName: previewEnv.name
+        }));
+      } catch (err) {
+        if (cancelled) return;
+        setState({
+          phase: "error",
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
+    createPreview();
+    return () => {
+      cancelled = true;
+    };
+  }, [state.phase, state.projectId]);
   const handleEnvironmentSelect = useCallback3(
     (env2) => {
       writeEnvironmentId(env2.id);
@@ -376100,7 +376220,14 @@ function DeployUI({ envFlag, config }) {
     }
     return "Preparing";
   };
-  return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React7.createElement(Text7, null, /* @__PURE__ */ React7.createElement(Text7, { bold: true, color: "cyan" }, "Deploying to ", environment), deployment && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, " (", deployment.id, ")")), /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, /* @__PURE__ */ React7.createElement(
+  return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React7.createElement(Text7, null, /* @__PURE__ */ React7.createElement(Text7, { bold: true, color: "cyan" }, preview ? `Deploying preview${environment !== "prod" ? ` (${environment})` : ""}` : `Deploying to ${environment}`), deployment && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, " (", deployment.id, ")")), /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, preview && /* @__PURE__ */ React7.createElement(
+    PhaseIndicator,
+    {
+      phase: "creating-preview",
+      currentPhase: displayPhase,
+      label: state.previewStatus || "Creating preview environment"
+    }
+  ), /* @__PURE__ */ React7.createElement(
     PhaseIndicator,
     {
       phase: "creating-tarball",
@@ -376181,6 +376308,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;
@@ -376409,7 +376551,8 @@ async function deployCommand(options2) {
       projectId: options2.project,
       env: options2.env,
       secrets: options2.secret,
-      configs: options2.config
+      configs: options2.config,
+      preview: options2.preview
     });
     return;
   }
@@ -376418,6 +376561,7 @@ async function deployCommand(options2) {
       DeployUI,
       {
         envFlag: options2.env,
+        preview: options2.preview,
         config
       }
     )
@@ -377278,7 +377422,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.122";
+  const currentVersion = "0.1.124";
   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 +377692,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.124").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 +377713,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/dist/docs/index.md

@@ -22,9 +22,7 @@ A full development environment can be started with `specific dev`. To deploy any
 - [Storage](/storage): define S3-compatible object/blob storage for services to store files in.
 - [Redis](/redis): define non-durable Redis-compatible databases for caching and more.
 - [Volumes](/volumes): define persistent storage volumes for services to store files in.
-<!-- beta:temporal -->
 - [Temporal](/temporal): managed durable workflow engine for background tasks, AI agents, cron jobs and more.
-<!-- /beta:temporal -->
 <!-- beta:mail -->
 - [Mail](/mail): managed email sending via SMTP for transactional emails.
 <!-- /beta:mail -->
@@ -37,7 +35,7 @@ The following is a list of common frameworks and libraries with guidance on how
 - [Next.js](/integrations/nextjs): full-stack React framework
 - [Drizzle ORM](/integrations/drizzle): TypeScript ORM with type safety
 - [Prisma](/integrations/prisma): TypeScript ORM with auto-generated client
-- [Temporal](/integrations/temporal): durable workflow engine for background tasks, AI agents, cron jobs, batch jobs and more
+- [Temporal](/integrations/temporal): using Temporal with Specific for durable workflows, background tasks, AI agents, cron jobs and more
 
 ## Adding Specific to existing projects / migrating to Specific
 

package/dist/docs/integrations/temporal.md

@@ -1,93 +1,3 @@
 # Temporal
 
-<!-- beta:temporal -->
-> **Beta**: Specific now has built-in Temporal support. See [Temporal](/temporal) for the recommended approach using the `temporal` block. The manual setup below still works but is no longer needed.
-<!-- /beta:temporal -->
-
-Temporal is a durable workflow engine. This guide covers running Temporal locally during development and connecting to Temporal Cloud in production.
-
-Temporal has extensive SDK support across many languages including TypeScript, Python, Go, Java, .NET, and PHP. See the [Temporal documentation](https://docs.temporal.io/) for language-specific guides on implementing workers, workflows, and activities. This document only covers integration with Specific.
-
-## Configuration
-
-Define a dev-only Temporal service that runs locally, along with configs and secrets for production Temporal Cloud.
-
-```hcl
-build "app" {
-  base = "node"
-}
-
-# Dev-only service: runs local Temporal server during development
-# No top-level command means it's excluded from production deployment
-#
-service "temporal" {
-  endpoint "grpc" {}
-  endpoint "ui" { public = true }
-
-  dev {
-    command = "temporal server start-dev --port $GRPC_PORT --ui-port $UI_PORT --db-filename /tmp/temporal.db"
-    env = {
-      GRPC_PORT = endpoint.grpc.port
-      UI_PORT   = endpoint.ui.port
-    }
-  }
-}
-
-# Temporal Cloud address (e.g., your-namespace.tmprl.cloud:7233)
-config "temporal_address" {}
-
-# Namespace - uses "default" in dev, must be set for production
-config "temporal_namespace" {
-  dev {
-    default = "default"
-  }
-}
-
-# API key for Temporal Cloud - not required in dev
-secret "temporal_api_key" {
-  dev {
-    required = false
-  }
-}
-
-service "app" {
-  build = build.app
-  command = "node index.js"
-  expose {}
-
-  env = {
-    PORT               = port
-    TEMPORAL_ADDRESS   = config.temporal_address
-    TEMPORAL_NAMESPACE = config.temporal_namespace
-    TEMPORAL_API_KEY   = secret.temporal_api_key
-  }
-
-  dev {
-    command = "node --watch index.js"
-    env = {
-      # Override to use local Temporal service instead
-      TEMPORAL_ADDRESS = ""
-      TEMPORAL_HOST    = service.temporal.endpoint.grpc.host
-      TEMPORAL_PORT    = service.temporal.endpoint.grpc.port
-    }
-  }
-}
-```
-
-## Development
-
-Running `specific dev` automatically starts a local Temporal server. The user must install the Temporal CLI for this: https://temporal.io/setup/install-temporal-cli. The Temporal Web UI is available at the public endpoint URL shown in the output.
-
-Your app connects to the local Temporal server using the service endpoint environment variables (`TEMPORAL_HOST` and `TEMPORAL_PORT`).
-
-## Production
-
-In production, the dev-only `temporal` service is excluded from deployment. Your app connects to Temporal Cloud using:
-
-1. `temporal_address` - Your Temporal Cloud address (e.g., `your-namespace.tmprl.cloud:7233`)
-2. `temporal_namespace` - Your Temporal Cloud namespace
-3. `temporal_api_key` - API key for authentication
-
-Set these with `specific secrets set` before deploying.
-
-## SDK support
+Specific has built-in Temporal support via the `temporal` block. See [Temporal](/temporal) for the full guide on configuration, development, and production deployment.

package/dist/docs/temporal.md

@@ -1,4 +1,3 @@
-<!-- beta:temporal -->
 # Temporal
 
 Define managed Temporal workflow engines for durable workflows, background tasks, AI agents, cron jobs, batch jobs and more.
@@ -66,4 +65,3 @@ Running `specific deploy` automatically provisions a managed [Temporal Cloud](ht
 4. Credentials are securely injected into your services
 
 The reference attributes (`temporal.<name>.url`, `.namespace`, `.api_key`) resolve to the Temporal Cloud values in production, so no environment-specific overrides are needed.
-<!-- /beta:temporal -->

package/package.json

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