@autoappy/cli 0.1.0-beta.0 → 0.2.0-beta.0

package/README.md

@@ -2,7 +2,7 @@
 
 Develop and synchronize Auto Appy applications from VS Code.
 
-> Beta contract: the CLI is implemented and locally tested, but app source pull/push requires the matching Auto Appy backend source endpoints before public use.
+The CLI keeps the hosted frontend, managed database schema, and saved APIs synchronized with one Auto Appy app.
 
 ## Start a project
 
@@ -17,6 +17,13 @@ npm run dev
 
 The starter keeps credentials in `.env` and non-secret project identity in `autoappy.json`.
 
+```dotenv
+AUTOAPPY_BASE_URL=https://api.autoappy.com
+AUTOAPPY_APP_TOKEN=aa_app_your_token
+```
+
+Create the token from the app's **Develop in VS Code** page with `data:read`, `data:write`, `api:manage`, `schema:manage`, `app:read`, and `app:deploy`. The token is limited to the apps selected when it is created. Never commit `.env`.
+
 ## Commands
 
 ```text
@@ -35,9 +42,9 @@ autoappy check
 
 Database synchronization covers schema only. Customer records are never copied into the project or Git by these commands.
 
-## Required backend contract
+## Backend contract
 
-The current Auto Appy development-kit, schema and managed-API endpoints are used directly. Frontend synchronization additionally requires:
+The Auto Appy development-kit, schema, managed-API, and versioned frontend endpoints are used directly:
 
 ```text
 GET   /api/v1/platform/organisations/{workspace}/data/apps/{app}/source

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autoappy/cli",
-  "version": "0.1.0-beta.0",
+  "version": "0.2.0-beta.0",
   "description": "Develop and synchronize Auto Appy applications from VS Code.",
   "type": "module",
   "bin": {

package/src/sync.js

@@ -30,7 +30,15 @@ export function mergeProjects({ baseline, local, remote }) {
 
 export async function pullCode({ root, client }) {
   const remote = await client.source();
-  if (!remote?.project || !Number.isInteger(remote.version)) throw new Error('The backend does not yet provide the Auto Appy app-source synchronization contract.');
+  if (!remote || !Number.isInteger(remote.version) || (remote.project === undefined)) throw new Error('Auto Appy returned an incomplete app-source response.');
+  if (remote.project === null) {
+    if (remote.version !== 0 || !remote.source_hash) throw new Error('Auto Appy returned an invalid blank app source.');
+    const state = readState(root);
+    const local = readLocalProject(root);
+    state.code = { version: 0, sourceHash: remote.source_hash, project: null };
+    writeState(root, state);
+    return { files: local.files.length, preserved: true, blank: true };
+  }
   const project = normalizeViewProject(remote.project);
   const state = readState(root);
   const local = readLocalProject(root);
@@ -48,8 +56,19 @@ export async function pullCode({ root, client }) {
 export async function pushCode({ root, client }) {
   const local = readLocalProject(root);
   const remote = await client.source();
-  if (!remote?.project || !Number.isInteger(remote.version)) throw new Error('The backend does not yet provide the Auto Appy app-source synchronization contract.');
+  if (!remote || !Number.isInteger(remote.version) || remote.project === undefined) throw new Error('Auto Appy returned an incomplete app-source response.');
   const state = readState(root);
+  if (remote.project === null) {
+    if (remote.version !== 0 || !remote.source_hash) throw new Error('Auto Appy returned an invalid blank app source.');
+    if (!state.code || state.code.project !== null || state.code.version !== 0 || state.code.sourceHash !== remote.source_hash) {
+      throw new Error('Pull the blank app before its first push so Auto Appy can protect remote changes.');
+    }
+    const saved = await client.saveSource({ expected_version: 0, source_hash: remote.source_hash, request_id: crypto.randomUUID(), project: local });
+    if (!saved || !Number.isInteger(saved.version)) throw new Error('Auto Appy returned an incomplete deployment receipt. Check the app before retrying.');
+    state.code = { version: saved.version, sourceHash: saved.source_hash || hash(local), project: local, deploymentId: saved.deployment_id || null };
+    writeState(root, state);
+    return { changed: true, version: saved.version, files: local.files.length, live: saved.status === 'published' };
+  }
   const remoteProject = normalizeViewProject(remote.project);
   const baseline = state.code?.project;
   if (!baseline && hash(local) !== hash(remoteProject)) throw new Error('Pull the app before its first push so Auto Appy can protect remote changes.');

package/templates/hosted-app/README.md

@@ -4,6 +4,7 @@
 2. Set `AUTOAPPY_BASE_URL` and `AUTOAPPY_APP_TOKEN` in `.env`.
 3. Run `npm install` and `npm run pull`.
 4. Develop with `npm run dev`.
-5. Review with `npm run status`, then publish with `npm run push`.
+5. Review with `npm run status`, then publish the database, APIs, and frontend with `npm run push`.
 
 Database commands synchronize schema definitions, not customer records.
+The first pull keeps this starter when the Auto Appy app has no frontend yet. The first push creates and publishes it.

package/templates/hosted-app/package.json

@@ -21,7 +21,7 @@
     "react-dom": "18.3.1"
   },
   "devDependencies": {
-    "@autoappy/cli": "0.1.0-beta.0",
+    "@autoappy/cli": "0.2.0-beta.0",
     "vite": "6.1.0"
   },
   "engines": {