ardent-cli-beta 0.0.10 → 0.0.11

package/README.md

@@ -13,8 +13,9 @@ 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 +34,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/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 login.');
+        if (!session.selectedProject)
+            this.error('No project selected. Run ardent project list, then ardent 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 login.');
+        if (!session.selectedProject)
+            this.error('No project selected. Run ardent project list, then ardent 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/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/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.11"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ardent-cli-beta",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "The Ardent command-line interface",
   "license": "Apache-2.0",
   "type": "module",