railcode 0.1.12 → 0.1.13

package/README.md

@@ -36,9 +36,9 @@ railcode db <list|query> ...       List data connectors / run read-only SQL
   build command when needed, then uploads the output dir. The app is
   created-or-resolved by slug in your saved org, and the live URL is printed.
 - **`db`** inspects the org's **data connectors** (per-org Postgres) and runs
-  ad-hoc read-only SQL. Run from an app dir for an app you've already deployed;
-  it resolves the existing app by slug (it won't create one) and uses the same
-  bearer, app-scoped routes the `dev` proxy forwards to.
+  ad-hoc read-only SQL. It works straight after `railcode login` — **no app and no
+  `railcode.json` required** — since connectors are org-scoped; it hits the app-less
+  `/api/organizations/{org}/data/*` plane with your login token.
   `railcode db list` (aliases `ls`, `connections`) prints each connector's
   `name` + `engine` (`--json` for the raw array). `railcode db query "<sql>"`
   (alias `sql`) runs SQL against `--connection` (default `default`) and prints a

package/dist/index.js

@@ -353,17 +353,6 @@ async function resolveOrCreateApp(config, slug) {
     });
     return (await readJsonOrThrow(created, "Create app"));
 }
-// Resolve an existing app by slug WITHOUT creating it — for read-only commands
-// (e.g. `railcode db`) that must not spawn a phantom app as a side effect.
-async function resolveExistingApp(config, slug) {
-    const orgPath = `/api/organizations/${config.orgUuid}/apps`;
-    const list = (await readJsonOrThrow(await authedFetch(config, orgPath), "List apps"));
-    const existing = list.find((app) => app.app_slug === slug);
-    if (!existing) {
-        throw new CliError(`App "${slug}" hasn't been created in your org yet. Run \`railcode deploy\` first.`, 1);
-    }
-    return existing;
-}
 async function postDeploy(config, appUuid, files) {
     // The deploy API is multipart: one part named "files" per file, with the
     // relative path carried as the part filename.
@@ -815,7 +804,7 @@ Query options:
   --json                                 Print the raw { columns, rows, rowcount, truncated } envelope
 
 SQL is sent read-only with bound parameters — values are never interpolated into
-the query. Run from an app directory (a ${MANIFEST_NAME} with an "app" slug).
+the query. Works right after \`railcode login\` — no app or ${MANIFEST_NAME} required.
 `;
 async function commandDb(args) {
     try {
@@ -851,8 +840,7 @@ async function commandDbList(args) {
         throw new CliError(`railcode db list takes no arguments (got "${args.rest[1]}").`, 2);
     }
     const config = requireLogin(args);
-    const app = await resolveExistingApp(config, requireAppSlug());
-    const connections = await fetchDbConnections(config, app.uuid);
+    const connections = await fetchDbConnections(config);
     if (args.options.json) {
         console.log(JSON.stringify(connections, null, 2));
         return;
@@ -874,10 +862,9 @@ async function commandDbQuery(args) {
     const connection = optionString(args, "connection") ?? "default";
     const query = source.kind === "file" ? readSqlFile(source.path) : source.sql;
     const config = requireLogin(args);
-    const app = await resolveExistingApp(config, requireAppSlug());
     // --engine wins; otherwise look the engine up from the connector list.
-    const engine = engineOption ?? inferEngine(await fetchDbConnections(config, app.uuid), connection);
-    const result = await runDbQuery(config, app.uuid, { engine, connection, query, params });
+    const engine = engineOption ?? inferEngine(await fetchDbConnections(config), connection);
+    const result = await runDbQuery(config, { engine, connection, query, params });
     if (args.options.json) {
         console.log(JSON.stringify(result, null, 2));
         return;
@@ -889,22 +876,14 @@ async function commandDbQuery(args) {
         console.log("Note: results were truncated by the server.");
     }
 }
-function requireAppSlug() {
-    const manifest = readManifest(process.cwd());
-    if (!manifest?.app) {
-        throw new CliError(`No ${MANIFEST_NAME} with an "app" slug here. Run \`railcode init <app>\` first, or add ${MANIFEST_NAME}.`, 2);
-    }
-    assertAppName(manifest.app);
-    return manifest.app;
-}
-async function fetchDbConnections(config, appUuid) {
-    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/apps/${appUuid}/connections`);
+async function fetchDbConnections(config) {
+    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/data/connections`);
     if (resp.status === 401)
         await reLoginOrThrow();
     return (await readJsonOrThrow(resp, "List connections"));
 }
-async function runDbQuery(config, appUuid, body) {
-    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/apps/${appUuid}/sql`, {
+async function runDbQuery(config, body) {
+    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/data/sql`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify(body),
@@ -943,9 +922,8 @@ function camelToKebab(value) {
 // (`railcode connector list|fetch`)
 //
 // Service connectors are org-configured HTTP proxies to downstream SaaS APIs.
-// The app is the scoping/attribution context, so — like `railcode db` — we
-// resolve (never create) the app by slug and use the bearer, app-scoped routes
-// `railcode dev` forwards to.
+// Like `railcode db`, these one-shot commands hit the org-scoped `/data/*` plane
+// with the login bearer token — no app (and no railcode.json) required.
 // ---------------------------------------------------------------------------
 const CONNECTOR_HELP = `railcode connector — service connectors
 
@@ -972,8 +950,8 @@ Fetch options:
   --json                                 Print the raw { status, ok, headers, body, truncated } envelope
 
 The connector holds the credential; you control only method/path/body. A non-2xx
-upstream status is still printed but exits non-zero. Run from an app directory (a
-${MANIFEST_NAME} with an "app" slug).
+upstream status is still printed but exits non-zero. Works right after
+\`railcode login\` — no app or ${MANIFEST_NAME} required.
 `;
 async function commandConnector(args) {
     try {
@@ -1013,8 +991,7 @@ async function commandConnectorList(args) {
         throw new CliError(`railcode connector list takes no arguments (got "${args.rest[1]}").`, 2);
     }
     const config = requireLogin(args);
-    const app = await resolveExistingApp(config, requireAppSlug());
-    const connectors = await fetchServiceConnectors(config, app.uuid);
+    const connectors = await fetchServiceConnectors(config);
     if (args.options.json) {
         console.log(JSON.stringify(connectors, null, 2));
         return;
@@ -1040,8 +1017,7 @@ async function commandConnectorFetch(args) {
             : null;
     const payload = buildConnectorRequest({ connector, method, path: args.rest[1] ?? "", body });
     const config = requireLogin(args);
-    const app = await resolveExistingApp(config, requireAppSlug());
-    const envelope = await runConnectorRequest(config, app.uuid, payload);
+    const envelope = await runConnectorRequest(config, payload);
     if (args.options.json) {
         console.log(JSON.stringify(envelope, null, 2));
     }
@@ -1065,8 +1041,7 @@ async function commandConnectorDocs(args) {
         throw new CliError("Pass either --json or --openapi, not both.", 2);
     }
     const config = requireLogin(args);
-    const app = await resolveExistingApp(config, requireAppSlug());
-    const docs = await fetchServiceConnectorDocs(config, app.uuid, name);
+    const docs = await fetchServiceConnectorDocs(config, name);
     if (args.options.json) {
         console.log(JSON.stringify(docs, null, 2));
         return;
@@ -1081,14 +1056,14 @@ async function commandConnectorDocs(args) {
     }
     console.log(renderConnectorDocs(docs));
 }
-async function fetchServiceConnectors(config, appUuid) {
-    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/apps/${appUuid}/service-connectors`);
+async function fetchServiceConnectors(config) {
+    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/data/service-connectors`);
     if (resp.status === 401)
         await reLoginOrThrow();
     return (await readJsonOrThrow(resp, "List service connectors"));
 }
-async function fetchServiceConnectorDocs(config, appUuid, name) {
-    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/apps/${appUuid}/service-connectors/${encodeURIComponent(name)}`);
+async function fetchServiceConnectorDocs(config, name) {
+    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/data/service-connectors/${encodeURIComponent(name)}`);
     if (resp.status === 401)
         await reLoginOrThrow();
     if (resp.status === 404) {
@@ -1096,8 +1071,8 @@ async function fetchServiceConnectorDocs(config, appUuid, name) {
     }
     return (await readJsonOrThrow(resp, "Connector docs"));
 }
-async function runConnectorRequest(config, appUuid, body) {
-    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/apps/${appUuid}/service-connectors/request`, {
+async function runConnectorRequest(config, body) {
+    const resp = await authedFetch(config, `/api/organizations/${config.orgUuid}/data/service-connectors/request`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify(body),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "railcode",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Developer CLI for the multi-tenant Railcode platform: log in, scaffold, and deploy static apps.",
   "license": "MIT",
   "type": "module",