@auersperg/flare 0.3.2 → 0.3.4

package/dist/cli/{chunk-5cq8wgte.js → chunk-5yg1zj5n.js}

@@ -26,26 +26,46 @@ async function request(platform, path, body) {
       return "null";
     }));
     if (config) {
-      const { storedToken } = await import("./chunk-x14smx1y.js");
+      const { storedToken } = await import("./chunk-5s6zv1h9.js");
       token = await storedToken(platform, config.project);
     }
   }
   if (!token)
     throw Error("Sign in with flare dev; CI can set FLARE_DEPLOY_TOKEN");
-  const r = await fetch(allowedUrl(platform) + path, {
-    method: body === undefined ? "GET" : "POST",
-    headers: {
-      authorization: `Bearer ${token}`,
-      ...body === undefined ? {} : { "content-type": "application/json" }
-    },
-    body: body === undefined ? undefined : JSON.stringify(body),
-    redirect: "error",
-    signal: AbortSignal.timeout(60000)
-  });
-  const result = await r.json();
+  const url = allowedUrl(platform) + path;
+  const write = body !== undefined;
+  const encoded = write ? JSON.stringify(body) : undefined;
+  let r;
+  try {
+    r = await fetch(url, {
+      method: write ? "POST" : "GET",
+      headers: {
+        authorization: `Bearer ${token}`,
+        ...write ? { "content-type": "application/json" } : {}
+      },
+      body: encoded,
+      redirect: "error",
+      signal: AbortSignal.timeout(60000)
+    });
+  } catch {
+    const error = Error(write ? "Management write outcome is unknown; inspect current state before retrying. Writes are not automatically retried." : "Management request interrupted or timed out");
+    error.ambiguous = write;
+    throw error;
+  }
+  let result;
+  try {
+    result = await r.json();
+  } catch {
+    const error = Error(`Invalid management response (HTTP ${r.status}); ${write && (r.ok || r.status >= 500) ? "write outcome is unknown; inspect current state before retrying" : "check platform availability and authorization"}`);
+    error.status = r.status;
+    error.ambiguous = write && (r.ok || r.status >= 500);
+    throw error;
+  }
   if (!r.ok) {
-    const error = Error(`${result.error ?? "Deployment failed"} (HTTP ${r.status}); writes are not automatically retried`);
+    const code = typeof result?.error === "string" && /^[A-Z][A-Z0-9_]{0,63}$/.test(result.error) ? result.error : "Management request failed";
+    const error = Error(`${code} (HTTP ${r.status}); writes are not automatically retried`);
     error.status = r.status;
+    error.ambiguous = write && r.status >= 500;
     throw error;
   }
   return result;
@@ -68,9 +88,6 @@ async function link(options) {
 async function deploy(options = {}) {
   if (!options.release) {
     const config = JSON.parse(await readFile(".flare/project.json", "utf8"));
-    const { prepare, generateApi } = await import("./chunk-786w6vrj.js");
-    const { buildApplication } = await import("./chunk-vx7kmczm.js");
-    const source = await prepare(), directory = resolve(".flare/releases/" + randomUUID());
     const env = options.env ?? "prod";
     if (!["dev", "prod"].includes(env))
       throw Error("Environment must be dev or prod");
@@ -89,6 +106,9 @@ async function deploy(options = {}) {
         prompt.close();
       }
     }
+    const { prepare, generateApi } = await import("./chunk-fv98dfg5.js");
+    const { buildApplication } = await import("./chunk-vx7kmczm.js");
+    const source = await prepare(), directory = resolve(".flare/releases/" + randomUUID());
     try {
       await buildApplication({ ...source, outdir: directory });
       const result = await deploy({
@@ -118,13 +138,13 @@ async function deploy(options = {}) {
     facet: await read("facet.js"),
     action: await read("action.js")
   };
-  let expected;
+  const health = await request(config.platform, `/api/projects/${config.project}/${env}/health`);
+  const expected = health?.active;
+  if (!/^[a-f0-9]{64}$/.test(expected ?? ""))
+    throw Error("Environment has no active backend; inspect dashboard Health before deploying");
   if (options.cmd) {
-    const health = await request(config.platform, `/api/projects/${config.project}/${env}/health`);
-    expected = health.active;
-    const { generateApi } = await import("./chunk-786w6vrj.js");
-    await generateApi(directory);
-    await frontendBuild(config, env, options.cmd);
+    const { withGeneratedApi } = await import("./chunk-fv98dfg5.js");
+    await withGeneratedApi(directory, () => frontendBuild(config, env, options.cmd));
   }
   return request(config.platform, `/api/projects/${config.project}/${env}/deploy`, { bundle, confirm: options.confirm, expected });
 }
@@ -133,14 +153,14 @@ async function dev(options = {}) {
     throw Error("Watch publishes only to dev; use deploy for production");
   const simple = !options.entry;
   if (simple) {
-    const { scaffold } = await import("./chunk-786w6vrj.js");
+    const { scaffold } = await import("./chunk-fv98dfg5.js");
     await scaffold();
     try {
       await access(".flare/project.json");
     } catch (e) {
       if (e.code !== "ENOENT")
         throw e;
-      const { connect } = await import("./chunk-x14smx1y.js");
+      const { connect } = await import("./chunk-5s6zv1h9.js");
       await connect();
     }
   }
@@ -152,7 +172,7 @@ async function dev(options = {}) {
     } catch (e) {
       if (process.env.FLARE_DEPLOY_TOKEN || e.status !== 401 && !e.message.startsWith("Sign in"))
         throw e;
-      const { connect } = await import("./chunk-x14smx1y.js");
+      const { connect } = await import("./chunk-5s6zv1h9.js");
       await connect();
     }
   }
@@ -167,7 +187,7 @@ async function dev(options = {}) {
     try {
       const outdir = resolve(".flare/releases/" + randomUUID());
       try {
-        const { prepare, generateApi, frontendEnvironment } = await import("./chunk-786w6vrj.js");
+        const { prepare, generateApi, frontendEnvironment } = await import("./chunk-fv98dfg5.js");
         const source = simple ? await prepare() : { entry: options.entry };
         const release = await buildApplication({ ...source, outdir });
         if (release.hash !== hash) {
@@ -289,14 +309,13 @@ async function releaseOperation(options, operation) {
     if (bundle.release.hash !== options.hash)
       throw Error("Release hash mismatch");
     const { generateReferences } = await import("./chunk-vx7kmczm.js");
-    const { generateApi } = await import("./chunk-786w6vrj.js");
+    const { withGeneratedApi } = await import("./chunk-fv98dfg5.js");
     await mkdir(".flare", { recursive: true });
     const directory = await mkdtemp(resolve(".flare/release-contract-"));
     try {
       await writeFile(join(directory, "api.ts"), await generateReferences(bundle.manifest));
       await writeFile(join(directory, "manifest.json"), JSON.stringify(bundle.manifest));
-      await generateApi(directory);
-      await frontendBuild(config, env, options.cmd);
+      await withGeneratedApi(directory, () => frontendBuild(config, env, options.cmd));
     } finally {
       await rm(directory, { recursive: true, force: true });
     }

package/dist/cli/{chunk-786w6vrj.js → chunk-fv98dfg5.js}

@@ -140,6 +140,25 @@ async function generateApi(directory) {
 export const api = ${serialize(tree)} as const;
 `);
 }
+async function withGeneratedApi(directory, build) {
+  const files = ["flare/_generated/api.ts", "flare/_generated/references.ts"];
+  const previous = await Promise.all(files.map((file) => readFile(file).catch((error) => {
+    if (error.code !== "ENOENT")
+      throw error;
+    return null;
+  })));
+  try {
+    await generateApi(directory);
+    return await build();
+  } catch (error) {
+    try {
+      await Promise.all(files.map((file, i) => previous[i] === null ? rm(file, { force: true }) : writeFile(file, previous[i])));
+    } catch (restoreError) {
+      throw new AggregateError([error, restoreError], "Build failed and local client references could not be restored");
+    }
+    throw error;
+  }
+}
 async function frontendEnvironment(url) {
   const pkg = JSON.parse(await readFile("package.json", "utf8"));
   const dependencies = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -165,5 +184,6 @@ export {
   frontendEnvironment,
   generateApi,
   prepare,
-  scaffold
+  scaffold,
+  withGeneratedApi
 };

package/dist/cli/flare.js

@@ -1,5 +1,73 @@
 #!/usr/bin/env bun
 // @bun
+// packages/flare/package.json
+var package_default = {
+  name: "@auersperg/flare",
+  version: "0.3.4",
+  license: "MIT",
+  type: "module",
+  description: "Flare client, server declarations and development CLI",
+  bin: {
+    flare: "./dist/cli/flare.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  exports: {
+    ".": {
+      types: "./dist/sdk/client.d.ts",
+      import: "./dist/sdk/client.js"
+    },
+    "./server": {
+      types: "./dist/sdk/server.d.ts",
+      import: "./dist/sdk/server.js"
+    },
+    "./react": {
+      types: "./dist/sdk/react.d.ts",
+      import: "./dist/sdk/react.js"
+    },
+    "./protocol": {
+      types: "./dist/sdk/protocol.d.ts",
+      import: "./dist/sdk/protocol.js"
+    },
+    "./cloudflare": {
+      types: "./dist/sdk/cloudflare.d.ts",
+      import: "./dist/sdk/cloudflare.js"
+    }
+  },
+  dependencies: {
+    "@standard-schema/spec": "1.1.0",
+    zod: "4.6.5",
+    "json-schema-to-typescript": "16.0.0"
+  },
+  engines: {
+    bun: ">=1.4.3"
+  },
+  repository: {
+    type: "git",
+    url: "https://github.com/auersperg/flare.git",
+    directory: "packages/flare"
+  },
+  sideEffects: false,
+  peerDependencies: {
+    react: ">=19"
+  },
+  peerDependenciesMeta: {
+    react: {
+      optional: true
+    }
+  },
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/",
+    tag: "next"
+  },
+  scripts: {
+    prepack: "bun run --cwd ../.. verify"
+  }
+};
 
 // packages/flare/src/cli/main.mjs
 if (typeof Bun === "undefined" || !Bun.semver.satisfies(Bun.version, ">=1.4.3")) {
@@ -8,11 +76,17 @@ if (typeof Bun === "undefined" || !Bun.semver.satisfies(Bun.version, ">=1.4.3"))
 }
 var [command, ...args] = process.argv.slice(2);
 if (!command || ["--help", "help"].includes(command))
-  console.log(`Flare 0.3 private minimum
+  console.log(`Flare ${package_default.version} trusted-team preview
 
 flare dev                  Browser login, setup and cloud dev watch
 flare deploy               Confirmed production build and deploy
 
+Platform lifecycle (Cloudflare account authorization):
+flare platform install
+flare platform status
+flare platform update --dry-run
+flare platform update
+
 Advanced commands:
 flare releases --env dev|prod
 flare promote --hash <dev release hash> [--cmd "bun run build"]
@@ -24,8 +98,50 @@ flare dev --entry <app.ts>
 flare backup create|list|restore|delete|status --env dev|prod
   restore --from dev|prod --id <backup ID> (empty target only)
 
-Dashboard is Cloudflare-only. Local tooling does not run a dashboard or backend. CLI authentication uses FLARE_DEPLOY_TOKEN from the online dashboard. Run flare dev with no flags for browser login, project selection and automatic schema/API generation. Run flare deploy with no flags for a confirmed production release. Platform installation is separate.`);
-else if ([
+Dashboard is Cloudflare-only. Local tooling does not run a dashboard or backend. Run flare dev for Access-protected browser approval and project-scoped credentials stored outside the application; CI can use FLARE_DEPLOY_TOKEN. Backend dev runs in Cloudflare; start the frontend separately. Production changes require project confirmation. Platform installation is separate.`);
+else if (command === "platform") {
+  try {
+    const operation = args.shift();
+    if (["help", "--help"].includes(operation)) {
+      console.log(`flare platform install|status|update [--account <ID>] [--name <name>]
+install: [--owner <email>] [--dashboard-host <host> --runtime-host <host>] [--subdomain <workers.dev prefix>]
+install/update: [--dry-run] [--confirm <account ID>] [--resume]
+Uses the platform payload bundled with this CLI release. Never updates applications or runs a local dashboard. Requires separate Cloudflare account permissions; FLARE_DEPLOY_TOKEN is not an account token.`);
+    } else {
+      if (!["install", "status", "update"].includes(operation))
+        throw Error("Supported: flare platform install|status|update; no deployment has occurred.");
+      const options = { operation };
+      const allowed = operation === "install" ? [
+        "account",
+        "name",
+        "owner",
+        "dashboard-host",
+        "runtime-host",
+        "subdomain",
+        "confirm",
+        "dry-run",
+        "resume"
+      ] : operation === "update" ? ["account", "name", "confirm", "dry-run", "resume"] : ["account", "name"];
+      for (let i = 0;i < args.length; i++) {
+        const key = args[i]?.slice(2);
+        if (!args[i]?.startsWith("--") || !allowed.includes(key) || key in options)
+          throw Error("Expected supported unique platform options; no deployment has occurred.");
+        if (["dry-run", "resume"].includes(key))
+          options[key] = true;
+        else {
+          if (!args[i + 1] || args[i + 1].startsWith("--"))
+            throw Error("Platform option requires a value; no deployment has occurred.");
+          options[key] = args[++i];
+        }
+      }
+      const { platform } = await import("./chunk-5tjevcsj.js");
+      console.log(JSON.stringify(await platform(options), null, 2));
+    }
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : "Platform command failed");
+    process.exitCode = 1;
+  }
+} else if ([
   "build",
   "link",
   "deploy",
@@ -63,7 +179,7 @@ else if ([
       console.log(`Built immutable release ${x.hash}
 ${x.outdir}`);
     } else {
-      const cloud = await import("./chunk-5cq8wgte.js");
+      const cloud = await import("./chunk-5yg1zj5n.js");
       const x = await cloud[command](options);
       if (x)
         console.log(JSON.stringify(x, null, 2));