@starcier/create-builder 1.0.0-next.0 → 1.0.0-next.1

package/README.md

@@ -26,18 +26,24 @@ Until `1.0.0` is released, use `@next` as above.
 
 ### Connection settings
 
-These do not change between clients, so set them once as environment variables rather than
-passing them every time:
+These do not change between clients, so they are **built in** and you never type them. Override
+one only to point somewhere else, such as a local API, with an option or an environment variable:
 
 | Variable | Option | What |
 | --- | --- | --- |
 | `STARCIER_API_URL` | `--api-url` | The API's origin |
 | `STARCIER_AUTH0_DOMAIN` | `--auth0-domain` | The Auth0 tenant's domain |
-| `STARCIER_AUTH0_AUDIENCE` | `--auth0-audience` | The API's audience; defaults to `https://starcier-api` |
+| `STARCIER_AUTH0_AUDIENCE` | `--auth0-audience` | The API's audience |
 | `STARCIER_AUTH0_CLIENT_ID` | `--auth0-client-id` | The builders' single-page application, written into the builder's `.env` |
 | `STARCIER_AUTH0_CLI_CLIENT_ID` | `--cli-client-id` | The native application this command signs in with |
 | `STARCIER_TOKEN` | `--token` | An API access token, used instead of signing in |
 
+The built-in values point at Starcier's dev environment until production goes live.
+
+**Signing in.** Until the command's own Auth0 application exists, it cannot sign you in through
+the browser, so it needs your access token: sign in to the Starcier builder, copy the token, and
+set it as `STARCIER_TOKEN` for the terminal you run the command in.
+
 ## What it guarantees
 
 - **Nothing half-created.** The files are prepared aside and moved into place only after the

package/dist/args.js

@@ -73,5 +73,7 @@ Options:
   --offline                  Create the files only: no sign-in, no tenant
   -h, --help                 Show this help
 
-Creating the tenant needs a Starcier staff account. Anything not given is asked for.
+The name, slug and folder are asked for when not given. The API and Auth0
+settings are built in, so leave them out unless pointing somewhere else.
+Creating the tenant needs a Starcier staff account.
 `;

package/dist/defaults.js

@@ -0,0 +1,15 @@
+/**
+ * Where a new builder connects when nothing else is given. These are the same
+ * for every client, so an operator never has to know or type them; flags and
+ * `STARCIER_*` variables still win, e.g. to point at a local API.
+ *
+ * Today they are the dev environment's, the only one that exists. At go-live
+ * they become production's (deploy-to-production.md, "Client builders").
+ */
+export const DEFAULTS = {
+    apiUrl: 'https://starcier-design-system-dev.up.railway.app',
+    auth0Domain: 'dev-k7pyqn8upxwm2wgi.us.auth0.com',
+    auth0Audience: 'https://starcier-design-system-api',
+    spaClientId: 'tqVw1OE5L4ElaTeKtnKfynBr2rIWNeY7',
+    cliClientId: undefined,
+};

package/dist/main.js

@@ -4,10 +4,10 @@ import { basename, dirname, join, relative, resolve } from 'node:path';
 import { createTenant, normaliseApiUrl } from './api.js';
 import { flagFor, parseArgs, USAGE } from './args.js';
 import { pollForToken, requestDeviceCode } from './auth.js';
+import { DEFAULTS } from './defaults.js';
 import { CliError } from './errors.js';
 import { slugProblem, suggestSlug } from './slug.js';
 import { configureBuilder, renderTemplate } from './template.js';
-const DEFAULT_AUDIENCE = 'https://starcier-api';
 const defaultGitInit = (dir) => {
     spawnSync('git', ['init', '--quiet'], { cwd: dir, stdio: 'ignore' });
 };
@@ -23,15 +23,6 @@ async function askValid(prompter, question, problem) {
     }
 }
 const required = (label) => (value) => (value ? null : `${label} is required.`);
-function urlProblem(value) {
-    try {
-        const url = new URL(value);
-        return url.protocol === 'https:' || url.protocol === 'http:' ? null : 'Use an http(s) address.';
-    }
-    catch {
-        return 'That is not a valid address.';
-    }
-}
 async function assertUsable(target) {
     const entries = await readdir(target).catch((err) => {
         if (err.code === 'ENOENT')
@@ -41,14 +32,21 @@ async function assertUsable(target) {
     if (entries.length > 0)
         throw new CliError(`${target} is not empty. Choose a new folder.`);
 }
-/** Everything the online path needs, from flags, environment variables or questions. */
-async function resolveConnection(options, prompter) {
-    const value = (key, message, check = required(message)) => options[key] ? Promise.resolve(options[key]) : askValid(prompter, { message, flag: flagFor(key) }, check);
-    const apiUrl = normaliseApiUrl(await value('apiUrl', 'Starcier API address', (v) => required('The API address')(v) ?? urlProblem(v)));
-    const auth0Domain = await value('auth0Domain', 'Auth0 domain');
-    const auth0Audience = options.auth0Audience || DEFAULT_AUDIENCE;
-    const spaClientId = await value('spaClientId', "The builders' Auth0 client id");
-    const cliClientId = options.token ? undefined : await value('cliClientId', "This command's Auth0 client id");
+/**
+ * Everything the online path needs: flags and environment variables, else the
+ * built-in defaults, so nothing here is ever asked. Signing in needs either a
+ * token or the command's own Auth0 application.
+ */
+function resolveConnection(options) {
+    const apiUrl = normaliseApiUrl(options.apiUrl || DEFAULTS.apiUrl);
+    const auth0Domain = options.auth0Domain || DEFAULTS.auth0Domain;
+    const auth0Audience = options.auth0Audience || DEFAULTS.auth0Audience;
+    const spaClientId = options.spaClientId || DEFAULTS.spaClientId;
+    const cliClientId = options.token ? undefined : options.cliClientId || DEFAULTS.cliClientId;
+    if (!options.token && !cliClientId) {
+        throw new CliError('Signing in through the browser is not set up yet. Sign in to the Starcier builder, copy your access ' +
+            `token, and pass it with ${flagFor('token')} or the STARCIER_TOKEN environment variable.`);
+    }
     return { apiUrl, auth0Domain, auth0Audience, spaClientId, cliClientId };
 }
 async function signIn(config, deps) {
@@ -89,7 +87,7 @@ export async function run(deps) {
     const dir = options.dir || (await prompter.ask({ message: 'Folder', default: `${slug}-builder`, flag: 'a folder argument' }));
     const target = resolve(deps.cwd, dir);
     await assertUsable(target);
-    const connection = options.offline ? null : await resolveConnection(options, prompter);
+    const connection = options.offline ? null : resolveConnection(options);
     await mkdir(dirname(target), { recursive: true });
     const staging = await mkdtemp(join(dirname(target), `.${basename(target)}-`));
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starcier/create-builder",
-  "version": "1.0.0-next.0",
+  "version": "1.0.0-next.1",
   "description": "Creates a Starcier prototype builder for a client: registers its tenant with the Starcier API and writes a repository with a starter design system. Run with `npm create @starcier/builder`.",
   "license": "MIT",
   "repository": {

package/template/package.json

@@ -12,7 +12,7 @@
   "dependencies": {
     "@auth0/auth0-react": "^2.22.1",
     "@starcier/builder-shell": "^1.0.0-next.1",
-    "@starcier/collab-core": "^1.0.0-next.1",
+    "@starcier/collab-core": "^1.0.0-next.3",
     "@starcier/collab-ui": "^1.0.0-next.1",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",