nstantpage-agent 0.2.0 → 0.2.2

package/README.md

@@ -90,6 +90,7 @@ npx nstantpage-agent start
 | `-p, --port <port>` | `3000` | Local dev server port |
 | `-a, --api-port <port>` | `18924` | Internal API port |
 | `--project-id <id>` | — | Link to a specific project |
+| `--token <token>` | — | Auth token (skip login flow) |
 | `--gateway <url>` | `wss://webprev.live` | Gateway URL |
 | `--no-dev` | — | Don't start dev server automatically |
 
@@ -157,7 +158,9 @@ node dist/cli.js start . --project-id test --gateway ws://localhost:4000
 ## Troubleshooting
 
 ### "Not authenticated" error
-Run `npx nstantpage-agent login` to authenticate.
+Run `npx nstantpage-agent login` to authenticate (opens browser).
+Or pass your token directly: `npx nstantpage-agent start --token YOUR_TOKEN --project-id 1234`
+For local gateway testing, auth is skipped automatically when using `--gateway ws://localhost:4000`.
 
 ### Port already in use
 Use `--port` and `--api-port` flags to change ports:

package/dist/cli.js

@@ -33,6 +33,7 @@ program
     .option('-a, --api-port <port>', 'Local API server port (internal)', '18924')
     .option('--project-id <id>', 'Link to a specific project ID')
     .option('--gateway <url>', 'Gateway URL', 'wss://webprev.live')
+    .option('--token <token>', 'Auth token (skip login flow)')
     .option('--no-dev', 'Skip starting the dev server (start manually later)')
     .action(startCommand);
 program

package/dist/commands/login.js

@@ -19,6 +19,15 @@ export async function loginCommand() {
     const callbackPort = 18923;
     const token = await new Promise((resolve, reject) => {
         const server = http.createServer((req, res) => {
+            // Allow CORS from nstantpage.com (the auth page uses fetch())
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
             const url = new URL(req.url, `http://localhost:${callbackPort}`);
             const token = url.searchParams.get('token');
             if (token) {

package/dist/commands/start.d.ts

@@ -17,6 +17,7 @@ interface StartOptions {
     apiPort: string;
     projectId?: string;
     gateway: string;
+    token?: string;
     noDev?: boolean;
 }
 export declare function startCommand(directory: string, options: StartOptions): Promise<void>;

package/dist/commands/start.js

@@ -20,12 +20,22 @@ import { TunnelClient } from '../tunnel.js';
 import { LocalServer } from '../localServer.js';
 export async function startCommand(directory, options) {
     const conf = getConfig();
+    // If --token was passed, persist it
+    if (options.token) {
+        conf.set('token', options.token);
+    }
     // Check authentication
-    const token = conf.get('token');
-    if (!token) {
+    // Allow unauthenticated connections to local gateways (ws://localhost, ws://127.0.0.1)
+    const isLocalGateway = /^wss?:\/\/(localhost|127\.0\.0\.1)/.test(options.gateway);
+    let token = conf.get('token');
+    if (!token && !isLocalGateway) {
         console.log(chalk.red('✗ Not authenticated. Run "nstantpage login" first.'));
+        console.log(chalk.gray('  Or pass --token <your-token> to authenticate inline.'));
         process.exit(1);
     }
+    if (!token && isLocalGateway) {
+        token = 'local-dev';
+    }
     // Resolve project directory
     const projectDir = path.resolve(directory);
     if (!fs.existsSync(projectDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Local development agent for nstantpage.com — run your projects locally, preview in the cloud. Replaces cloud containers for faster builds.",
   "type": "module",
   "bin": {