@specific.dev/cli 0.1.91 → 0.1.93

package/dist/docs/postgres/reshape/index.md

@@ -70,14 +70,11 @@ service "api" {
 
 Place migration files in your migrations directory. Files are processed in **lexical order** (e.g., `001_first.toml` before `002_second.toml`).
 
-**IMPORTANT:** You MUST run `specific reshape check` every time you create or edit a migration file. This validates the migration syntax and catches errors before the watcher applies them. Without this step, invalid migrations will silently fail to apply.
+**IMPORTANT:** You MUST run `specific check` every time you create or edit a migration file. This validates both your `specific.hcl` configuration and all migration files, catching errors before the watcher applies them. Without this step, invalid migrations will silently fail to apply.
 
 ```bash
-# Validate all migration files
-specific reshape check
-
-# Validate migrations for a specific database
-specific reshape check main
+# Validate specific.hcl and all migration files
+specific check
 ```
 
 Example migration (`migrations/001_create_users.toml`):
@@ -130,12 +127,12 @@ specific reshape abort main
 ## Development Workflow
 
 1. Write your migration file in the migrations directory
-2. Run `specific reshape check` to validate the migration syntax
+2. Run `specific check` to validate both `specific.hcl` and migration syntax
 3. `specific dev` automatically applies it
-4. Iterate on the migration - run `specific reshape check` after **every** change
+4. Iterate on the migration - run `specific check` after **every** change
 5. When ready, add a new migration file to "lock in" the previous one
 
-**Remember:** Always run `specific reshape check` after any change to a migration file. This is required to catch syntax errors before they are applied.
+**Remember:** Always run `specific check` after any change to a migration file or `specific.hcl`. This validates everything in one step.
 
 Completed migrations are made read-only to prevent accidental changes. If you need to modify a completed migration, you'll need to manually change the file permissions first.
 

package/dist/docs/services.md

@@ -22,7 +22,13 @@ service "web" {
 
   env = {
     PORT = port
-    API_URL = service.api.public_url
+    API_URL = "https://${service.api.public_url}"
+  }
+
+  dev {
+    env = {
+      API_URL = "http://${service.api.public_url}"
+    }
   }
 }
 
@@ -143,10 +149,34 @@ service "worker" {
 
 Available service reference attributes:
 
-- `service.<name>.private_url` - Internal URL without scheme (host and port)
+- `service.<name>.private_url` - Internal URL without scheme (e.g., `localhost:3001`). Does NOT include `http://` or `https://`.
 - `service.<name>.host` - Host only (e.g., `localhost`)
-- `service.<name>.port` - Port only (e.g., `3000`)
-- `service.<name>.public_url` - Public URL without scheme (host and port). Only available for endpoints with `public = true`. Served over HTTPS.
+- `service.<name>.port` - Port only (e.g., `3001`)
+- `service.<name>.public_url` - Public URL without scheme (e.g., `my-app.specific.app` in production, `localhost:3001` in dev). Does NOT include `http://` or `https://`. Only available for endpoints with `public = true`.
+
+**Important:** `public_url` and `private_url` do NOT include a scheme. In production, services are served over HTTPS. In local development, services use plain HTTP. When you need to construct a full URL, use string interpolation with the correct scheme for each environment. Use the `dev { env = {} }` block to override with `http://` locally:
+
+```hcl
+service "web" {
+  build = build.web
+  command = "npm start"
+
+  endpoint {
+    public = true
+  }
+
+  env = {
+    PORT = port
+    API_URL = "https://${service.api.public_url}"
+  }
+
+  dev {
+    env = {
+      API_URL = "http://${service.api.public_url}"
+    }
+  }
+}
+```
 
 For services with multiple named endpoints, you must specify the endpoint:
 
@@ -186,7 +216,13 @@ service "api" {
 
   env = {
     PORT = port
-    CORS_ORIGIN = service.web.public_url
+    CORS_ORIGIN = "https://${service.web.public_url}"
+  }
+
+  dev {
+    env = {
+      CORS_ORIGIN = "http://${service.web.public_url}"
+    }
   }
 }
 ```
@@ -315,11 +351,19 @@ service "worker" {
     CUSTOM_DB    = "host=${postgres.main.host} port=${postgres.main.port}"
     PUBLIC_API   = "https://${service.api.public_url}/v1"
   }
+
+  dev {
+    env = {
+      PUBLIC_API = "http://${service.api.public_url}/v1"
+    }
+  }
 }
 ```
 
 All resource references (services, postgres, redis, storage, port, endpoint) can be used inside interpolated strings. Secret and config references cannot be interpolated — they must be used as standalone values.
 
+Since `public_url` and `private_url` do not include a scheme, you should use `https://` in the top-level `env` (for production) and override with `http://` in the `dev { env = {} }` block (for local development). The `dev` env block is merged with the top-level env, so you only need to override the variables that differ.
+
 ## Service dev configuration
 
 Override how a service runs in development. If the referenced build has no `dev` block, it is skipped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/cli",
-  "version": "0.1.91",
+  "version": "0.1.93",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",
@@ -17,7 +17,6 @@
     "link:dev": "npm run build:dev && npm link",
     "link:staging": "npm run build:staging && npm link",
     "link:prod": "npm run build && npm link",
-    "postinstall": "node dist/postinstall.js || true",
     "build:binary": "npx tsx scripts/build-binary.ts"
   },
   "keywords": [

package/dist/admin/_next/static/chunks/153355cea359ee0f.js

@@ -1 +0,0 @@
-(globalThis.TURBOPACK||(globalThis.TURBOPACK=[])).push(["object"==typeof document?document.currentScript:void 0,12283,35014,e=>{"use strict";var t=e.i(90795),r=e.i(59369);function o(){let e=window.location.hostname;return"localhost"===e||"127.0.0.1"===e}function n(){let e=window.location.hostname,t=".spcf.localhost";if("localhost"===e||"127.0.0.1"===e||"spcf.localhost"===e)return"default";if(e.endsWith(t)){let r=e.slice(0,-t.length);if(r&&!r.includes("."))return r}return null}function s(e,t){return o()&&t?`http://localhost:${t}`:"default"===e?"https://__drizzle_gateway.spcf.localhost":`https://__drizzle_gateway.${e}.spcf.localhost`}function a(e,t){return o()&&t?`http://localhost:${t}`:"default"===e?"https://__temporal.spcf.localhost":`https://__temporal.${e}.spcf.localhost`}e.s(["getDrizzleGatewayUrl",()=>s,"getInstanceKey",()=>n,"getTemporalUiUrl",()=>a],35014);let l=(0,r.createContext)(void 0);function i({children:e}){let[o,i]=(0,r.useState)(null),[c,u]=(0,r.useState)(null),[m,d]=(0,r.useState)(!1),h=(0,r.useMemo)(()=>n(),[]);(0,r.useEffect)(()=>{async function e(){try{let e=await fetch("/api/state");if(!e.ok)throw Error("Failed to fetch state");let t=await e.json();i(t),d(!0),u(null)}catch(e){e instanceof TypeError&&"Failed to fetch"===e.message?u("specific dev is not running. Restart it to reconnect."):u(e instanceof Error?e.message:"Unknown error"),d(!1)}}e();let t=setInterval(e,2e3);return()=>clearInterval(t)},[]);let f=o?.resources.some(e=>"postgres"===e.type)??!1,p=(0,r.useMemo)(()=>h?s(h,o?.drizzleGatewayPort):null,[h,o?.drizzleGatewayPort]),y=o?.hasTemporal??!1,v=(0,r.useMemo)(()=>h?a(h,o?.temporalUiPort):null,[h,o?.temporalUiPort]),g=o?.hasMail??!1,w=o?.mailApiUrl??null,T=o?.projectId??null,b=(0,r.useMemo)(()=>({state:o,error:c,connected:m,instanceKey:h,hasDatabases:f,drizzleGatewayUrl:p,hasTemporal:y,temporalUiUrl:v,hasMail:g,mailApiUrl:w,projectId:T}),[o,c,m,h,f,p,y,v,g,w,T]);return(0,t.jsx)(l.Provider,{value:b,children:e})}function c(){let e=(0,r.useContext)(l);if(void 0===e)throw Error("useDevState must be used within a DevStateProvider");return e}e.s(["DevStateProvider",()=>i,"useDevState",()=>c],12283)},70932,e=>{"use strict";var t=e.i(59369),r=(e,t,r,o,n,s,a,l)=>{let i=document.documentElement,c=["light","dark"];function u(t){var r;(Array.isArray(e)?e:[e]).forEach(e=>{let r="class"===e,o=r&&s?n.map(e=>s[e]||e):n;r?(i.classList.remove(...o),i.classList.add(s&&s[t]?s[t]:t)):i.setAttribute(e,t)}),r=t,l&&c.includes(r)&&(i.style.colorScheme=r)}if(o)u(o);else try{let e=localStorage.getItem(t)||r,o=a&&"system"===e?window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light":e;u(o)}catch(e){}},o=["light","dark"],n="(prefers-color-scheme: dark)",s="u"<typeof window,a=t.createContext(void 0),l={setTheme:e=>{},themes:[]},i=()=>{var e;return null!=(e=t.useContext(a))?e:l},c=e=>t.useContext(a)?t.createElement(t.Fragment,null,e.children):t.createElement(m,{...e}),u=["light","dark"],m=({forcedTheme:e,disableTransitionOnChange:r=!1,enableSystem:s=!0,enableColorScheme:l=!0,storageKey:i="theme",themes:c=u,defaultTheme:m=s?"system":"light",attribute:y="data-theme",value:v,children:g,nonce:w,scriptProps:T})=>{let[b,S]=t.useState(()=>h(i,m)),[E,C]=t.useState(()=>"system"===b?p():b),P=v?Object.values(v):c,k=t.useCallback(e=>{let t=e;if(!t)return;"system"===e&&s&&(t=p());let n=v?v[t]:t,a=r?f(w):null,i=document.documentElement,c=e=>{"class"===e?(i.classList.remove(...P),n&&i.classList.add(n)):e.startsWith("data-")&&(n?i.setAttribute(e,n):i.removeAttribute(e))};if(Array.isArray(y)?y.forEach(c):c(y),l){let e=o.includes(m)?m:null,r=o.includes(t)?t:e;i.style.colorScheme=r}null==a||a()},[w]),_=t.useCallback(e=>{let t="function"==typeof e?e(b):e;S(t);try{localStorage.setItem(i,t)}catch(e){}},[b]),z=t.useCallback(t=>{C(p(t)),"system"===b&&s&&!e&&k("system")},[b,e]);t.useEffect(()=>{let e=window.matchMedia(n);return e.addListener(z),z(e),()=>e.removeListener(z)},[z]),t.useEffect(()=>{let e=e=>{e.key===i&&(e.newValue?S(e.newValue):_(m))};return window.addEventListener("storage",e),()=>window.removeEventListener("storage",e)},[_]),t.useEffect(()=>{k(null!=e?e:b)},[e,b]);let A=t.useMemo(()=>({theme:b,setTheme:_,forcedTheme:e,resolvedTheme:"system"===b?E:b,themes:s?[...c,"system"]:c,systemTheme:s?E:void 0}),[b,_,e,E,s,c]);return t.createElement(a.Provider,{value:A},t.createElement(d,{forcedTheme:e,storageKey:i,attribute:y,enableSystem:s,enableColorScheme:l,defaultTheme:m,value:v,themes:c,nonce:w,scriptProps:T}),g)},d=t.memo(({forcedTheme:e,storageKey:o,attribute:n,enableSystem:s,enableColorScheme:a,defaultTheme:l,value:i,themes:c,nonce:u,scriptProps:m})=>{let d=JSON.stringify([n,o,l,e,c,i,s,a]).slice(1,-1);return t.createElement("script",{...m,suppressHydrationWarning:!0,nonce:"u"<typeof window?u:"",dangerouslySetInnerHTML:{__html:`(${r.toString()})(${d})`}})}),h=(e,t)=>{let r;if(!s){try{r=localStorage.getItem(e)||void 0}catch(e){}return r||t}},f=e=>{let t=document.createElement("style");return e&&t.setAttribute("nonce",e),t.appendChild(document.createTextNode("*,*::before,*::after{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;-ms-transition:none!important;transition:none!important}")),document.head.appendChild(t),()=>{window.getComputedStyle(document.body),setTimeout(()=>{document.head.removeChild(t)},1)}},p=e=>(e||(e=window.matchMedia(n)),e.matches?"dark":"light");e.s(["ThemeProvider",()=>c,"useTheme",()=>i])},49311,e=>{"use strict";var t=e.i(90795),r=e.i(70932);function o({children:e,...o}){return(0,t.jsx)(r.ThemeProvider,{...o,children:e})}e.s(["ThemeProvider",()=>o])}]);