ardent-cli-beta 0.0.10 → 0.0.12

package/README.md

@@ -4,17 +4,22 @@
 
 The Ardent CLI is the customer command-line client for the control-plane API.
 
-The Oclif foundation and authentication are implemented. `ardent login` opens
+Install the beta with `npm install --global ardent-cli-beta`, then run
+`ardent-beta <command>`. The package registers only the `ardent-beta` executable,
+so it can be installed alongside an existing `ardent` command.
+
+The Oclif foundation and authentication are implemented. `ardent-beta login` opens
 the Ardent frontend and returns the approved API key through a loopback callback
-bound with PKCE. `ardent login --token <token>` validates and stores an existing
+bound with PKCE. `ardent-beta login --token <token>` validates and stores an existing
 API token for CI and automation; `ARDENT_TOKEN` supplies the same flag
-non-interactively. `ardent status` and `ardent logout` inspect and remove that
+non-interactively. `ardent-beta status` and `ardent-beta logout` inspect and remove that
 local session. The CLI always talks to Ardent's production control plane. Oclif
 provides help, version, autocomplete, and native JSON command behavior. Resource
 context is retained from login. Project listing, creation, deletion, and local
 context switching are implemented. Organization member listing, invitation,
-removal, and pending-invitation cancellation are implemented; other resource
-commands are not implemented yet.
+removal, and pending-invitation cancellation are implemented. Connector listing
+and registration are implemented; registration follows connector status, while
+credential delivery and replication readiness remain owed.
 
 Set `ARDENT_API_URL` to point the CLI at a development control plane. Without
 it, the CLI uses `https://production.tryardent.com`.
@@ -33,6 +38,8 @@ npm run build
 ./bin/run.js member invite teammate@example.com
 ./bin/run.js member invite administrator@example.com --role admin
 ./bin/run.js member delete teammate@example.com
+./bin/run.js connector list
+./bin/run.js connector create postgresql 'postgresql://user:password@database.example.com/app'
 ARDENT_API_URL=http://localhost:8080 ./bin/run.js login --token <token>
 ```
 

package/dist/auth/browser.js

@@ -73,7 +73,7 @@ export async function loginWithBrowser(directory, options = {}) {
     options.onAuthorizationURL?.(authorizationURL.toString(), opened);
     const timeout = setTimeout(() => {
         deadline.abort();
-        rejectLogin(new Error('Ardent CLI login timed out. Run ardent login to try again.'));
+        rejectLogin(new Error('Ardent CLI login timed out. Run ardent-beta login to try again.'));
     }, options.timeoutMs ?? LOGIN_TIMEOUT_MS);
     try {
         return await completion;

package/dist/auth/credentials.js

@@ -55,7 +55,7 @@ export async function loadSession(directory) {
         };
     }
     catch {
-        throw new Error(`Ardent configuration at ${configPath(directory)} is invalid. Run ardent logout, then log in again.`);
+        throw new Error(`Ardent configuration at ${configPath(directory)} is invalid. Run ardent-beta logout, then log in again.`);
     }
 }
 function isProjectIdentity(value) {

package/dist/commands/connector/create.d.ts

@@ -0,0 +1,19 @@
+import { ArdentCommand } from '../../command.js';
+interface ConnectorCreation {
+    connector_id: string;
+    status: 'registered' | 'registering';
+}
+export default class ConnectorCreate extends ArdentCommand {
+    static args: {
+        type: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        url: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static helpGroup: string;
+    static flags: {
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ConnectorCreation>;
+}
+export {};

package/dist/commands/connector/create.js

@@ -0,0 +1,56 @@
+import { randomUUID } from 'node:crypto';
+import { Args, Flags, ux } from '@oclif/core';
+import { loadSession } from '../../auth/credentials.js';
+import { ArdentCommand } from '../../command.js';
+import { createConnector, waitForConnectorRegistration } from '../../connectors/client.js';
+import { terminalText } from '../../terminal.js';
+export default class ConnectorCreate extends ArdentCommand {
+    static args = {
+        type: Args.string({ description: 'Connector type', required: true }),
+        url: Args.string({ description: 'PostgreSQL connection URL', required: true }),
+    };
+    static description = 'Register a PostgreSQL connector in the selected project';
+    static helpGroup = 'Connectors';
+    static flags = {
+        environment: Flags.string({ description: 'Environment ID (defaults to Ardent Cloud)' }),
+        name: Flags.string({ char: 'n', description: 'Connector name' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConnectorCreate);
+        if (!['postgres', 'postgresql'].includes(args.type.toLowerCase())) {
+            this.error(`Unsupported connector type ${JSON.stringify(args.type)}. Supported: postgresql.`);
+        }
+        const session = await loadSession(this.config.configDir);
+        if (!session?.organization)
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
+        if (!session.selectedProject)
+            this.error('No project selected. Run ardent-beta project list, then ardent-beta project switch <name>.');
+        const providedName = flags.name?.trim();
+        if (flags.name !== undefined && !providedName)
+            this.error('Connector name cannot be empty.');
+        const name = providedName ?? `${session.selectedProject.name}-${randomUUID().slice(0, 8)}`;
+        const environmentID = flags.environment?.trim();
+        if (flags.environment !== undefined && !environmentID)
+            this.error('Environment ID cannot be empty.');
+        const interactive = !this.jsonEnabled() && ux.action.type === 'spinner';
+        if (interactive) {
+            ux.action.start(`${terminalText(name)} in ${terminalText(session.selectedProject.name)}`, 'registering');
+        }
+        else if (!this.jsonEnabled()) {
+            this.log(`Registering connector ${terminalText(name)} for project ${terminalText(session.selectedProject.name)}...`);
+        }
+        const registration = await createConnector(session.token, session.organization.id, session.selectedProject.id, environmentID, name, args.url);
+        if (!interactive) {
+            if (!this.jsonEnabled()) {
+                this.log(`Connector registration started (${terminalText(registration.connector_id)}).`);
+            }
+            return { connector_id: registration.connector_id, status: 'registering' };
+        }
+        await waitForConnectorRegistration(session.token, registration.connector_id, (status) => {
+            ux.action.status = status;
+        });
+        ux.action.stop(ux.colorize('green', '✓ registered'));
+        this.log('Credential delivery and replication readiness are still pending.');
+        return { connector_id: registration.connector_id, status: 'registered' };
+    }
+}

package/dist/commands/connector/list.d.ts

@@ -0,0 +1,9 @@
+import { ArdentCommand } from '../../command.js';
+import { type Connector } from '../../connectors/client.js';
+export default class ConnectorList extends ArdentCommand {
+    static description: string;
+    static helpGroup: string;
+    run(): Promise<{
+        connectors: Connector[];
+    }>;
+}

package/dist/commands/connector/list.js

@@ -0,0 +1,25 @@
+import { loadSession } from '../../auth/credentials.js';
+import { ArdentCommand } from '../../command.js';
+import { listConnectors } from '../../connectors/client.js';
+import { terminalText } from '../../terminal.js';
+export default class ConnectorList extends ArdentCommand {
+    static description = 'List connectors in the selected project';
+    static helpGroup = 'Connectors';
+    async run() {
+        const session = await loadSession(this.config.configDir);
+        if (!session?.organization)
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
+        if (!session.selectedProject)
+            this.error('No project selected. Run ardent-beta project list, then ardent-beta project switch <name>.');
+        const connectors = await listConnectors(session.token, session.organization.id, session.selectedProject.id);
+        if (!this.jsonEnabled()) {
+            if (connectors.length === 0)
+                this.log('No connectors found.');
+            const nameWidth = Math.max(0, ...connectors.map(({ name }) => terminalText(name).length));
+            for (const connector of connectors) {
+                this.log(`${terminalText(connector.name).padEnd(nameWidth)}  ${terminalText(connector.status)}`);
+            }
+        }
+        return { connectors };
+    }
+}

package/dist/commands/member/delete.js

@@ -16,7 +16,7 @@ export default class MemberDelete extends ArdentCommand {
             this.error('Email cannot be empty.');
         const session = await loadSession(this.config.configDir);
         if (!session?.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const [memberships, invitations] = await Promise.all([
             listMemberships(session.token, session.organization.id),
             listInvitations(session.token, session.organization.id),

package/dist/commands/member/invite.js

@@ -25,7 +25,7 @@ export default class MemberInvite extends ArdentCommand {
             this.error('Email cannot be empty.');
         const session = await loadSession(this.config.configDir);
         if (!session?.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const role = roles[flags.role];
         const invitation = await inviteMember(session.token, session.organization.id, email, role);
         if (!this.jsonEnabled())

package/dist/commands/member/list.js

@@ -8,7 +8,7 @@ export default class MemberList extends ArdentCommand {
     async run() {
         const session = await loadSession(this.config.configDir);
         if (!session?.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const [memberships, invitations] = await Promise.all([
             listMemberships(session.token, session.organization.id),
             listReadableInvitations(session.token, session.organization.id),

package/dist/commands/project/create.js

@@ -17,9 +17,9 @@ export default class ProjectCreate extends ArdentCommand {
             this.error('Project name cannot be empty.');
         const session = await loadSession(this.config.configDir);
         if (!session)
-            this.error('Not logged in to Ardent. Run ardent login.');
+            this.error('Not logged in to Ardent. Run ardent-beta login.');
         if (!session.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const project = await createProject(session.token, session.organization.id, name);
         await selectProject(this.config.configDir, session, project);
         if (!this.jsonEnabled())

package/dist/commands/project/delete.js

@@ -17,7 +17,7 @@ export default class ProjectDelete extends ArdentCommand {
             this.error('Project name cannot be empty.');
         const session = await loadSession(this.config.configDir);
         if (!session?.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const projects = await listProjects(session.token, session.organization.id);
         const project = projects.find((candidate) => candidate.name === name);
         if (!project)

package/dist/commands/project/list.js

@@ -10,9 +10,9 @@ export default class ProjectList extends ArdentCommand {
     async run() {
         const session = await loadSession(this.config.configDir);
         if (!session)
-            this.error('Not logged in to Ardent. Run ardent login.');
+            this.error('Not logged in to Ardent. Run ardent-beta login.');
         if (!session.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const projects = await listProjects(session.token, session.organization.id);
         const refreshedSession = await replaceProjectCache(this.config.configDir, session, projects);
         if (!this.jsonEnabled()) {

package/dist/commands/project/switch.js

@@ -16,10 +16,10 @@ export default class ProjectSwitch extends ArdentCommand {
             this.error('Project name cannot be empty.');
         const session = await loadSession(this.config.configDir);
         if (!session?.organization)
-            this.error('You must be logged in to run this command. Run ardent login.');
+            this.error('You must be logged in to run this command. Run ardent-beta login.');
         const project = cachedProjectNamed(session, name);
         if (!project)
-            this.error(`Project ${JSON.stringify(name)} not found. Run ardent project list.`);
+            this.error(`Project ${JSON.stringify(name)} not found. Run ardent-beta project list.`);
         await selectProject(this.config.configDir, session, project);
         if (!this.jsonEnabled())
             this.log(`✓ Switched to project ${terminalText(project.name)}`);

package/dist/connectors/client.d.ts

@@ -0,0 +1,25 @@
+export interface Connector {
+    created_at: string;
+    environment_id: string;
+    id: string;
+    name: string;
+    project_id: string;
+    source: {
+        database: string;
+        host: string;
+        port: number;
+    };
+    status: string;
+    updated_at: string;
+}
+export interface ConnectorRegistration {
+    connector_id: string;
+}
+export interface ConnectorRegistrationStatus {
+    connector_id: string;
+    failure?: string;
+    status: 'failed' | 'registered' | 'registering';
+}
+export declare function listConnectors(token: string, organizationID: string, projectID: string): Promise<Connector[]>;
+export declare function createConnector(token: string, organizationID: string, projectID: string, environmentID: string | undefined, name: string, url: string): Promise<ConnectorRegistration>;
+export declare function waitForConnectorRegistration(token: string, connectorID: string, onStatus?: (status: ConnectorRegistrationStatus['status']) => void): Promise<ConnectorRegistrationStatus>;

package/dist/connectors/client.js

@@ -0,0 +1,76 @@
+import { randomUUID } from 'node:crypto';
+import { request } from '../api/client.js';
+export async function listConnectors(token, organizationID, projectID) {
+    const query = new URLSearchParams({ organization_id: organizationID, project_id: projectID });
+    const connectors = await request(token, `/connectors?${query}`);
+    if (!Array.isArray(connectors) || connectors.some((connector) => !isConnector(connector, projectID))) {
+        throw new Error('Ardent API returned an invalid connectors response.');
+    }
+    return connectors;
+}
+export async function createConnector(token, organizationID, projectID, environmentID, name, url) {
+    const requestID = randomUUID();
+    const registration = await request(token, '/connectors', {
+        body: JSON.stringify({
+            ...(environmentID ? { environment_id: environmentID } : {}),
+            name,
+            organization_id: organizationID,
+            project_id: projectID,
+            request_id: requestID,
+            url,
+        }),
+        method: 'POST',
+    });
+    if (!isConnectorRegistration(registration))
+        throw new Error('Ardent API returned an invalid connector registration response.');
+    return registration;
+}
+export async function waitForConnectorRegistration(token, connectorID, onStatus) {
+    for (;;) {
+        const status = await request(token, `/connectors/${encodeURIComponent(connectorID)}`);
+        if (!isConnectorRegistrationStatus(status, connectorID)) {
+            throw new Error('Ardent API returned an invalid connector registration status.');
+        }
+        onStatus?.(status.status);
+        if (status.status === 'registered')
+            return status;
+        if (status.status === 'failed')
+            throw new Error(status.failure || 'Connector registration failed.');
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+}
+function isConnector(value, projectID) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const connector = value;
+    const source = connector.source;
+    return (typeof connector.id === 'string' &&
+        connector.id.length > 0 &&
+        connector.project_id === projectID &&
+        typeof connector.environment_id === 'string' &&
+        connector.environment_id.length > 0 &&
+        typeof connector.name === 'string' &&
+        typeof connector.status === 'string' &&
+        connector.status.length > 0 &&
+        typeof source === 'object' &&
+        source !== null &&
+        typeof source.host === 'string' &&
+        Number.isInteger(source.port) &&
+        typeof source.database === 'string' &&
+        typeof connector.created_at === 'string' &&
+        typeof connector.updated_at === 'string');
+}
+function isConnectorRegistration(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const registration = value;
+    return typeof registration.connector_id === 'string' && registration.connector_id.length > 0;
+}
+function isConnectorRegistrationStatus(value, connectorID) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const status = value;
+    return (status.connector_id === connectorID &&
+        (status.status === 'registering' || status.status === 'registered' || status.status === 'failed') &&
+        (status.failure === undefined || typeof status.failure === 'string'));
+}

package/dist/help.js

@@ -13,12 +13,12 @@ export default class ArdentHelp extends Help {
         }
         this.log('Get started:');
         this.log('');
-        this.log(ux.colorize('green', '  ardent login                    Standard CLI login'));
-        this.log('  ardent login --token <token>    Non-interactive login (CI and automation)');
+        this.log(ux.colorize('green', '  ardent-beta login                    Standard CLI login'));
+        this.log('  ardent-beta login --token <token>    Non-interactive login (CI and automation)');
         this.log('');
         this.log('For all commands:');
         this.log('');
-        this.log('  ardent --help');
+        this.log('  ardent-beta --help');
     }
     async authenticated() {
         try {
@@ -31,7 +31,7 @@ export default class ArdentHelp extends Help {
     showArdentHelp(authenticated) {
         this.log(`Ardent CLI ${ux.colorize('dim', `v${this.config.version}`)}`);
         this.log('');
-        this.log(this.section('USAGE', '$ ardent <command>'));
+        this.log(this.section('USAGE', '$ ardent-beta <command>'));
         const groups = new Map();
         for (const command of this.sortedCommands) {
             if (command.hidden || command.pluginName !== this.config.name || typeof command.helpGroup !== 'string')
@@ -42,7 +42,7 @@ export default class ArdentHelp extends Help {
         }
         for (const [group, commands] of groups) {
             const rows = commands.map((command) => {
-                const name = `ardent ${command.id.replaceAll(':', ' ')}`;
+                const name = `ardent-beta ${command.id.replaceAll(':', ' ')}`;
                 return [!authenticated && command.id === 'login' ? ux.colorize('green', name) : name, this.summary(command)];
             });
             this.log('');

package/dist/members/client.js

@@ -72,12 +72,12 @@ export async function inviteMember(token, organizationID, email, role) {
 export async function deleteMembership(token, organizationID, userID) {
     const response = await request(token, `/organizations/${encodeURIComponent(organizationID)}/memberships/${encodeURIComponent(userID)}`, { method: 'DELETE' });
     if (response !== undefined)
-        throw new Error('Ardent API did not confirm member deletion. Run ardent member list before retrying.');
+        throw new Error('Ardent API did not confirm member deletion. Run ardent-beta member list before retrying.');
 }
 export async function deleteInvitation(token, organizationID, invitationID) {
     const response = await request(token, `/organizations/${encodeURIComponent(organizationID)}/invitations/${encodeURIComponent(invitationID)}`, { method: 'DELETE' });
     if (response !== undefined)
-        throw new Error('Ardent API did not confirm invitation cancellation. Run ardent member list before retrying.');
+        throw new Error('Ardent API did not confirm invitation cancellation. Run ardent-beta member list before retrying.');
 }
 function isMembership(value, organizationID) {
     if (typeof value !== 'object' || value === null)

package/dist/projects/client.js

@@ -20,7 +20,7 @@ export async function createProject(token, organizationID, name) {
 export async function deleteProject(token, organizationID, projectID) {
     const response = await request(token, `/projects/${encodeURIComponent(projectID)}?organization_id=${encodeURIComponent(organizationID)}`, { method: 'DELETE' });
     if (response !== undefined) {
-        throw new Error('Ardent API did not confirm project deletion. Run ardent project list before retrying.');
+        throw new Error('Ardent API did not confirm project deletion. Run ardent-beta project list before retrying.');
     }
 }
 function isProject(value, organizationID) {

package/oclif.manifest.json

@@ -95,6 +95,92 @@
         "status.js"
       ]
     },
+    "connector:create": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Connector type",
+          "name": "type",
+          "required": true
+        },
+        "url": {
+          "description": "PostgreSQL connection URL",
+          "name": "url",
+          "required": true
+        }
+      },
+      "description": "Register a PostgreSQL connector in the selected project",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "environment": {
+          "description": "Environment ID (defaults to Ardent Cloud)",
+          "name": "environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Connector name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connector:create",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "helpGroup": "Connectors",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "connector",
+        "create.js"
+      ]
+    },
+    "connector:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List connectors in the selected project",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connector:list",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "helpGroup": "Connectors",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "connector",
+        "list.js"
+      ]
+    },
     "member:delete": {
       "aliases": [],
       "args": {
@@ -350,5 +436,5 @@
       ]
     }
   },
-  "version": "0.0.10"
+  "version": "0.0.12"
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "ardent-cli-beta",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "The Ardent command-line interface",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
-    "ardent": "./bin/run.js"
+    "ardent-beta": "./bin/run.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,7 +22,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "oclif": {
-    "bin": "ardent",
+    "bin": "ardent-beta",
     "dirname": "ardent",
     "commands": "./dist/commands",
     "helpClass": "./dist/help",