@nativescript/cloudflare-cli 0.1.0-beta.10 → 0.1.0-beta.11

package/README.md

@@ -7,7 +7,7 @@ npx @nativescript/cloudflare-cli live --mac    # a Mac app: opens the IDE and ru
 npx @nativescript/cloudflare-cli live --electron   # an Electron app with native views, run the same way
 ```
 
-`live` creates a project on preview.nativescript.org (`--server` or `NS_EDGE_SERVER` for another edge), saves it to `.ns-edge.json` and opens its IDE. The framework flags are `ns create`'s (`--ng`/`--angular`, `--react`, `--vue`, `--svelte`, `--solid`, `--ts`); without one a phone project is plain TypeScript with XML views. Run it again in the same folder to reopen that project (no flag needed), or add `--new` for another; a flag for a different kind of project than the folder's asks for `--new`. `--from <link>` starts from a copy of a shared project instead, such as a sample (its link, or a bare id on the same server). While `live` runs a Mac app it restarts the app if it crashes, unless it crashes three times in a minute. Without a create token the project is free: a few hosted agent turns a day, no backend, deleted after 30 days unused. `--no-open` skips the browser; with `--mac` or `--electron`, `--allow-eval` lets the agent run code on this Mac.
+`live` creates a project on preview.nativescript.org (`--server` or `NS_EDGE_SERVER` for another edge), saves it to `.ns-edge.json` and opens its IDE. The framework flags are `ns create`'s (`--ng`/`--angular`, `--react`, `--vue`, `--svelte`, `--solid`, `--ts`); without one a phone project is plain TypeScript with XML views. Run it again in the same folder to reopen that project (no flag needed), or add `--new` for another; a flag for a different kind of project than the folder's asks for `--new`. `--from <sample>` starts from a copy of a shared project instead: a sample's name (`--from expo-settings`; `samples` lists them), or any project's link or bare id. While `live` runs a Mac app it restarts the app if it crashes, unless it crashes three times in a minute. Without a create token the project is free: a few hosted agent turns a day, no backend, deleted after 30 days unused. `--no-open` skips the browser; with `--mac` or `--electron`, `--allow-eval` lets the agent run code on this Mac.
 
 ## Mirror a local project
 

package/dist/bin.js

@@ -105,18 +105,23 @@ async function printPairing(ref) {
 }
 /** This folder's project, if it has one the server still knows. */
 /**
- * The project `--from` names: a link to it (its IDE, read-only or device link)
- * or a bare id on this CLI's server, with what it was made as.
+ * The project `--from` names: a link to it (its IDE, read-only or device link),
+ * a bare id, or a sample's name on this CLI's server, with what it was made as.
  */
 async function sourceProject(from) {
     let server = flag('server') ?? LIVE_SERVER;
     let id = from;
     if (!/^[0-9a-f]{32}$/.test(from)) {
-        const match = URL.canParse(from) ? new URL(from).pathname.match(/^\/p\/([0-9a-f]{32})/) : null;
-        if (!match)
-            throw new Error(`--from takes a project link (https://…/p/<id>) or id, not '${from}'.`);
-        server = new URL(from).origin;
-        id = match[1];
+        if (URL.canParse(from) && /^https?:$/.test(new URL(from).protocol)) {
+            const link = new URL(from);
+            const match = link.pathname.match(/^\/p\/([0-9a-f]{32})(?:\/|$)/) ?? link.pathname.match(/^\/p\/([a-z0-9-]+)\/?$/);
+            if (!match)
+                throw new Error(`--from takes a sample's name, a project link (https://…/p/<id>) or its id, not '${from}'.`);
+            server = link.origin;
+            id = match[1];
+        }
+        if (!/^[0-9a-f]{32}$/.test(id))
+            id = await sampleId(server, id);
     }
     const res = await fetch(`${server}/p/${id}/details`).catch(() => null);
     if (!res?.ok)
@@ -124,6 +129,22 @@ async function sourceProject(from) {
     const { template, title } = (await res.json());
     return { server, id, template, title };
 }
+async function listSamples(server) {
+    const res = await fetch(`${server}/api/samples`).catch(() => null);
+    if (!res?.ok || !res.headers.get('content-type')?.includes('json'))
+        return null;
+    return (await res.json());
+}
+async function sampleId(server, name) {
+    const res = await fetch(`${server}/api/samples/${encodeURIComponent(name)}`).catch(() => null);
+    if (!res)
+        throw new Error(`Couldn't reach ${server} to look up the sample '${name}'.`);
+    if (res.ok && res.headers.get('content-type')?.includes('json'))
+        return (await res.json()).id;
+    const names = (await listSamples(server))?.map((s) => s.name) ?? [];
+    const known = names.length ? ` Its samples: ${names.join(', ')}.` : '';
+    throw new Error(`There's no sample named '${name}' on ${server}.${known} --from also takes a project link or its full 32-character id.`);
+}
 async function savedProject() {
     if (!existsSync(join(root, CONFIG)))
         return null;
@@ -314,22 +335,35 @@ const commands = {
     async qr() {
         await printPairing(await loadRef());
     },
+    async samples() {
+        const server = flag('server') ?? LIVE_SERVER;
+        const list = await listSamples(server);
+        if (!list)
+            throw new Error(`Couldn't list the samples on ${server}.`);
+        if (!list.length)
+            return console.log(`${server} has no named samples yet.`);
+        const width = Math.max(...list.map((s) => s.name.length));
+        for (const s of list)
+            console.log(`  ${s.name.padEnd(width)}  ${s.title}`);
+        console.log(`\nStart from one with: npx @nativescript/cloudflare-cli live --from <name>`);
+    },
     async help() {
         console.log(`ns-edge <command>
 
-  live [--ng|--react|--vue|--svelte|--solid|--desktop|--electron|--expo] [--new] [--from <link>] [--no-open] [--allow-eval]
+  live [--ng|--react|--vue|--svelte|--solid|--desktop|--electron|--expo] [--new] [--from <sample>] [--no-open] [--allow-eval]
                             create a project (or reopen this folder's), open its IDE, and print a QR code
                             for your phone; --ng, --react, --vue, --svelte or --solid picks the framework
                             (plain TypeScript with XML views otherwise); --desktop (or --mac, --windows)
                             or --electron runs it on this Mac or Windows PC instead, with that OS's own
                             controls; --expo runs an Expo Desktop app on this Mac or Windows x64 PC;
-                            --from starts from a copy of a shared project (a sample's link or id)
+                            --from starts from a copy of a shared project: a sample's name, link or id
   create [--server <url>] [--token <t>] [--ng|--react|--vue|--svelte|--solid|--template <name>]
                             create an edge project and save .ns-edge.json
   push                      upload app/ and server/ in one transaction
   watch                     push, then stream every save to the edge
   pull                      download the project's files here
-  qr                        print the pairing QR code`);
+  qr                        print the pairing QR code
+  samples                   list the samples --from can start from by name`);
     },
 };
 const run = commands[cmd] ?? commands.help;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nativescript/cloudflare-cli",
-  "version": "0.1.0-beta.10",
+  "version": "0.1.0-beta.11",
   "description": "Mirror a NativeScript project into an ns-edge project from a terminal or a Vite dev server",
   "license": "Apache-2.0",
   "type": "module",