primitive-admin 1.0.22 → 1.0.24

package/dist/src/commands/databases.js

@@ -19,12 +19,12 @@ Examples:
   $ primitive databases create "My Database"
   $ primitive databases get <database-id>
   $ primitive databases records models <database-id>
-  $ primitive databases records query <database-id> <model-name>
-  $ primitive databases records save <database-id> <model-name> --data '{"name":"Alice"}'
+  $ primitive databases records describe <database-id> <model-name>
+  $ primitive databases operations list <database-id>
+  $ primitive databases operations execute <database-id> <operation-name> --params '{"key":"value"}'
   $ primitive databases indexes list <database-id>
   $ primitive databases indexes create <database-id> --model contacts --field email
   $ primitive databases permissions list <database-id>
-  $ primitive databases group-permissions list <database-id>
 `);
     // List databases
     databases
@@ -50,7 +50,7 @@ Examples:
             console.log(formatTable(list, [
                 { header: "ID", key: "databaseId", format: formatId },
                 { header: "TITLE", key: "title" },
-                { header: "DEFAULT PERM", key: "defaultPermission", format: (v) => v || "—" },
+                { header: "TYPE", key: "databaseType", format: (v) => v || "—" },
                 { header: "PERMISSION", key: "permission" },
                 { header: "CREATED", key: "createdAt", format: formatDate },
             ]));
@@ -66,16 +66,13 @@ Examples:
         .description("Create a new database")
         .argument("<title>", "Database title")
         .option("--app <app-id>", "App ID")
-        .option("--default-permission <level>", "Default permission for all app users: reader or read-write")
+        .requiredOption("--type <database-type>", "Database type (required)")
         .option("--json", "Output as JSON")
         .action(async (title, options) => {
         const resolvedAppId = resolveAppId(undefined, options);
         const client = new ApiClient();
         try {
-            const params = { title };
-            if (options.defaultPermission) {
-                params.defaultPermission = options.defaultPermission;
-            }
+            const params = { title, databaseType: options.type };
             const result = await client.createDatabase(resolvedAppId, params);
             if (options.json) {
                 json(result);
@@ -84,8 +81,8 @@ Examples:
             success("Database created.");
             keyValue("Database ID", result.databaseId);
             keyValue("Title", result.title);
-            if (result.defaultPermission) {
-                keyValue("Default Permission", result.defaultPermission);
+            if (result.databaseType) {
+                keyValue("Database Type", result.databaseType);
             }
         }
         catch (err) {
@@ -111,9 +108,8 @@ Examples:
             }
             keyValue("Database ID", result.databaseId);
             keyValue("Title", result.title);
-            keyValue("Default Permission", result.defaultPermission || "none");
-            keyValue("Rule Set", result.ruleSetId || "none");
-            keyValue("Permission", result.permission);
+            keyValue("Database Type", result.databaseType || "none");
+            keyValue("Permission", result.permission || "none");
             keyValue("Created", formatDate(result.createdAt));
         }
         catch (err) {
@@ -124,12 +120,11 @@ Examples:
     // Update database
     databases
         .command("update")
-        .description("Update a database (title, default permission, rule set)")
+        .description("Update a database (title, type)")
         .argument("<database-id>", "Database ID")
         .option("--app <app-id>", "App ID")
         .option("--title <title>", "New title")
-        .option("--default-permission <level>", "Default permission for all app users: reader, read-write, or none")
-        .option("--rule-set-id <id>", "Attach a rule set (use 'none' to detach)")
+        .option("--type <database-type>", "Database type (use 'none' to clear)")
         .option("--json", "Output as JSON")
         .action(async (databaseId, options) => {
         const resolvedAppId = resolveAppId(undefined, options);
@@ -138,20 +133,14 @@ Examples:
         if (options.title) {
             params.title = options.title;
         }
-        if (options.defaultPermission !== undefined) {
-            params.defaultPermission =
-                options.defaultPermission === "none"
-                    ? null
-                    : options.defaultPermission;
-        }
-        if (options.ruleSetId !== undefined) {
-            params.ruleSetId =
-                options.ruleSetId === "none"
+        if (options.type !== undefined) {
+            params.databaseType =
+                options.type === "none"
                     ? null
-                    : options.ruleSetId;
+                    : options.type;
         }
         if (Object.keys(params).length === 0) {
-            error("Provide at least one of --title, --default-permission, or --rule-set-id.");
+            error("Provide at least one of --title or --type.");
             process.exit(1);
         }
         try {
@@ -163,8 +152,7 @@ Examples:
             success("Database updated.");
             keyValue("Database ID", result.databaseId);
             keyValue("Title", result.title);
-            keyValue("Default Permission", result.defaultPermission || "none");
-            keyValue("Rule Set", result.ruleSetId || "none");
+            keyValue("Database Type", result.databaseType || "none");
         }
         catch (err) {
             error(err.message);
@@ -248,7 +236,7 @@ Examples:
         .description("Grant a user permission on a database")
         .argument("<database-id>", "Database ID")
         .requiredOption("--user-id <user-id>", "User ID to grant permission to")
-        .requiredOption("--permission <permission>", "Permission level: owner, read-write, or reader")
+        .requiredOption("--permission <permission>", "Permission level: manager")
         .option("--app <app-id>", "App ID")
         .option("--json", "Output as JSON")
         .action(async (databaseId, options) => {
@@ -305,10 +293,10 @@ Examples:
             process.exit(1);
         }
     });
-    // ---- Records subcommand group ----
+    // ---- Records subcommand group (models & describe only) ----
     const records = databases
         .command("records")
-        .description("Query, create, and manage records in a database");
+        .description("Inspect models and schemas in a database");
     // List models
     records
         .command("models")
@@ -371,64 +359,38 @@ Examples:
             process.exit(1);
         }
     });
-    // Query records
-    records
-        .command("query")
-        .description("Query records in a database")
+    // ---- Metadata subcommand group ----
+    const metadata = databases
+        .command("metadata")
+        .description("Manage database metadata");
+    metadata
+        .command("update")
+        .description("Update database metadata (merge with existing)")
         .argument("<database-id>", "Database ID")
-        .argument("<model-name>", "Model name")
-        .option("--filter <json>", "Filter as JSON", "{}")
-        .option("--limit <n>", "Max records to return", "25")
-        .option("--cursor <cursor>", "Pagination cursor")
+        .requiredOption("--data <json>", "Metadata fields as JSON (merged with existing)")
         .option("--app <app-id>", "App ID")
         .option("--json", "Output as JSON")
-        .action(async (databaseId, modelName, options) => {
+        .action(async (databaseId, options) => {
         const resolvedAppId = resolveAppId(undefined, options);
         const client = new ApiClient();
-        let filter = {};
+        let data;
         try {
-            filter = JSON.parse(options.filter);
+            data = JSON.parse(options.data);
         }
         catch {
-            error("Invalid --filter JSON.");
+            error("Invalid --data JSON.");
             process.exit(1);
+            return;
         }
         try {
-            const body = {
-                modelName,
-                filter,
-                options: { limit: parseInt(options.limit, 10) },
-            };
-            if (options.cursor)
-                body.options.cursor = options.cursor;
-            const result = await client.queryDatabaseRecords(resolvedAppId, databaseId, body);
-            const data = result.data || [];
+            const result = await client.updateDatabaseMetadata(resolvedAppId, databaseId, data);
             if (options.json) {
                 json(result);
                 return;
             }
-            if (data.length === 0) {
-                info("No records found.");
-                return;
-            }
-            // Derive columns from first record
-            const cols = Object.keys(data[0]).filter((k) => k !== "type");
-            console.log(formatTable(data, cols.map((c) => ({
-                header: c.toUpperCase(),
-                key: c,
-                format: (v) => {
-                    if (v === null || v === undefined)
-                        return "—";
-                    if (typeof v === "object") {
-                        const s = JSON.stringify(v);
-                        return s.length > 50 ? s.slice(0, 47) + "..." : s;
-                    }
-                    const s = String(v);
-                    return s.length > 50 ? s.slice(0, 47) + "..." : s;
-                },
-            }))));
-            if (result.hasMore) {
-                info(`More records available. Use --cursor ${result.cursor} to continue.`);
+            success("Metadata updated.");
+            if (result.metadata) {
+                keyValue("Metadata", JSON.stringify(result.metadata));
             }
         }
         catch (err) {
@@ -436,116 +398,134 @@ Examples:
             process.exit(1);
         }
     });
-    // Count records
-    records
-        .command("count")
-        .description("Count records of a model")
+    // ---- Operations subcommand group ----
+    const operations = databases
+        .command("operations")
+        .description("List and execute registered operations on a database");
+    // List operations
+    operations
+        .command("list")
+        .description("List registered operations available on a database")
         .argument("<database-id>", "Database ID")
-        .argument("<model-name>", "Model name")
-        .option("--filter <json>", "Filter as JSON", "{}")
         .option("--app <app-id>", "App ID")
         .option("--json", "Output as JSON")
-        .action(async (databaseId, modelName, options) => {
+        .action(async (databaseId, options) => {
         const resolvedAppId = resolveAppId(undefined, options);
         const client = new ApiClient();
-        let filter = {};
-        try {
-            filter = JSON.parse(options.filter);
-        }
-        catch {
-            error("Invalid --filter JSON.");
-            process.exit(1);
-        }
         try {
-            const result = await client.countDatabaseRecords(resolvedAppId, databaseId, {
-                modelName,
-                filter,
-            });
+            const result = await client.listDatabaseOperations(resolvedAppId, databaseId);
+            const list = Array.isArray(result) ? result : [];
             if (options.json) {
-                json(result);
+                json(list);
+                return;
+            }
+            if (list.length === 0) {
+                info("No operations found.");
                 return;
             }
-            console.log(`Count: ${result.count}`);
+            console.log(formatTable(list, [
+                { header: "NAME", key: "name" },
+                { header: "TYPE", key: "type" },
+                { header: "MODEL", key: "modelName" },
+                { header: "ACCESS", key: "access" },
+            ]));
         }
         catch (err) {
             error(err.message);
             process.exit(1);
         }
     });
-    // Save record
-    records
-        .command("save")
-        .description("Create or update a record")
+    // Execute operation
+    operations
+        .command("execute")
+        .description("Execute a registered operation on a database")
         .argument("<database-id>", "Database ID")
-        .argument("<model-name>", "Model name")
-        .option("--id <id>", "Record ID (auto-generated if omitted)")
-        .requiredOption("--data <json>", "Record data as JSON")
+        .argument("<operation-name>", "Operation name")
+        .option("--params <json>", "Operation parameters as JSON")
+        .option("--limit <n>", "Max records to return (for queries)")
+        .option("--cursor <cursor>", "Pagination cursor")
+        .option("--token <jwt>", "Execute as a specific user (dev/test — JWT visible in process args)")
         .option("--app <app-id>", "App ID")
         .option("--json", "Output as JSON")
-        .action(async (databaseId, modelName, options) => {
+        .option("--timing", "Show server-side timing breakdown")
+        .action(async (databaseId, operationName, options) => {
         const resolvedAppId = resolveAppId(undefined, options);
         const client = new ApiClient();
-        let data;
-        try {
-            data = JSON.parse(options.data);
-        }
-        catch {
-            error("Invalid --data JSON.");
-            process.exit(1);
-            return;
+        let params;
+        if (options.params) {
+            try {
+                params = JSON.parse(options.params);
+            }
+            catch {
+                error("Invalid --params JSON.");
+                process.exit(1);
+                return;
+            }
         }
-        const id = options.id || crypto.randomUUID().replace(/-/g, "").slice(0, 20);
+        const body = {};
+        if (params)
+            body.params = params;
+        if (options.limit)
+            body.limit = parseInt(options.limit, 10);
+        if (options.cursor)
+            body.cursor = options.cursor;
         try {
-            const result = await client.saveDatabaseRecord(resolvedAppId, databaseId, {
-                modelName,
-                id,
-                data,
-            });
+            const result = await client.executeDatabaseOperation(resolvedAppId, databaseId, operationName, body, options.token, { timing: !!options.timing });
             if (options.json) {
                 json(result);
                 return;
             }
-            success(`Record saved.`);
-            keyValue("ID", result.id || id);
-        }
-        catch (err) {
-            error(err.message);
-            process.exit(1);
-        }
-    });
-    // Delete record
-    records
-        .command("delete")
-        .description("Delete a record")
-        .argument("<database-id>", "Database ID")
-        .argument("<model-name>", "Model name")
-        .argument("<record-id>", "Record ID")
-        .option("--app <app-id>", "App ID")
-        .option("-y, --yes", "Skip confirmation prompt")
-        .action(async (databaseId, modelName, recordId, options) => {
-        const resolvedAppId = resolveAppId(undefined, options);
-        if (!options.yes) {
-            const inquirer = await import("inquirer");
-            const { confirm } = await inquirer.default.prompt([
-                {
-                    type: "confirm",
-                    name: "confirm",
-                    message: `Delete record ${recordId} from ${modelName}?`,
-                    default: false,
-                },
-            ]);
-            if (!confirm) {
-                info("Cancelled.");
-                return;
+            // Smart display based on result shape
+            if (result.data && Array.isArray(result.data)) {
+                if (result.data.length === 0) {
+                    info("No records found.");
+                }
+                else {
+                    const cols = Object.keys(result.data[0]).filter((k) => k !== "type");
+                    console.log(formatTable(result.data, cols.map((c) => ({
+                        header: c.toUpperCase(),
+                        key: c,
+                        format: (v) => {
+                            if (v === null || v === undefined)
+                                return "—";
+                            if (typeof v === "object") {
+                                const s = JSON.stringify(v);
+                                return s.length > 50 ? s.slice(0, 47) + "..." : s;
+                            }
+                            const s = String(v);
+                            return s.length > 50 ? s.slice(0, 47) + "..." : s;
+                        },
+                    }))));
+                }
+                if (result.hasMore) {
+                    info(`More records available. Use --cursor ${result.cursor} to continue.`);
+                }
+            }
+            else if (result.count !== undefined) {
+                console.log(`Count: ${result.count}`);
+            }
+            else if (result.result !== undefined) {
+                // Aggregate result
+                json(result);
+            }
+            else if (result.results && Array.isArray(result.results)) {
+                // Batch/mutation results
+                success(`Operation executed (${result.results.length} result${result.results.length === 1 ? "" : "s"}).`);
+            }
+            else if (result.success !== undefined) {
+                success("Operation executed.");
+            }
+            else {
+                json(result);
+            }
+            // Display timing if present
+            if (result._timing) {
+                console.log("");
+                console.log("Timing:");
+                for (const [key, value] of Object.entries(result._timing)) {
+                    console.log(`  ${key}: ${value}ms`);
+                }
             }
-        }
-        const client = new ApiClient();
-        try {
-            await client.deleteDatabaseRecord(resolvedAppId, databaseId, {
-                modelName,
-                id: recordId,
-            });
-            success(`Record ${recordId} deleted.`);
         }
         catch (err) {
             error(err.message);
@@ -661,108 +641,5 @@ Examples:
             process.exit(1);
         }
     });
-    // ---- Group Permissions subcommand group ----
-    const groupPermissions = databases
-        .command("group-permissions")
-        .description("Manage group permissions on a database");
-    // List group permissions
-    groupPermissions
-        .command("list")
-        .description("List group permissions for a database")
-        .argument("<database-id>", "Database ID")
-        .option("--app <app-id>", "App ID")
-        .option("--json", "Output as JSON")
-        .action(async (databaseId, options) => {
-        const resolvedAppId = resolveAppId(undefined, options);
-        const client = new ApiClient();
-        try {
-            const result = await client.listDatabaseGroupPermissions(resolvedAppId, databaseId);
-            const list = Array.isArray(result) ? result : result?.permissions ?? [];
-            if (options.json) {
-                json(list);
-                return;
-            }
-            if (list.length === 0) {
-                info("No group permissions found.");
-                return;
-            }
-            console.log(formatTable(list, [
-                { header: "GROUP_TYPE", key: "groupType" },
-                { header: "GROUP_ID", key: "groupId" },
-                { header: "PERMISSION", key: "permission" },
-                { header: "GRANTED", key: "grantedAt", format: formatDate },
-            ]));
-        }
-        catch (err) {
-            error(err.message);
-            process.exit(1);
-        }
-    });
-    // Grant group permission
-    groupPermissions
-        .command("grant")
-        .description("Grant a group permission on a database")
-        .argument("<database-id>", "Database ID")
-        .requiredOption("--group-type <type>", "Group type")
-        .requiredOption("--group-id <id>", "Group ID")
-        .requiredOption("--permission <permission>", "Permission level: read-write or reader")
-        .option("--app <app-id>", "App ID")
-        .option("--json", "Output as JSON")
-        .action(async (databaseId, options) => {
-        const resolvedAppId = resolveAppId(undefined, options);
-        const client = new ApiClient();
-        try {
-            const result = await client.grantDatabaseGroupPermission(resolvedAppId, databaseId, {
-                groupType: options.groupType,
-                groupId: options.groupId,
-                permission: options.permission,
-            });
-            if (options.json) {
-                json(result);
-                return;
-            }
-            success(`Permission '${options.permission}' granted to group ${options.groupType}/${options.groupId}.`);
-        }
-        catch (err) {
-            error(err.message);
-            process.exit(1);
-        }
-    });
-    // Revoke group permission
-    groupPermissions
-        .command("revoke")
-        .description("Revoke a group's permission on a database")
-        .argument("<database-id>", "Database ID")
-        .argument("<group-type>", "Group type")
-        .argument("<group-id>", "Group ID")
-        .option("--app <app-id>", "App ID")
-        .option("-y, --yes", "Skip confirmation prompt")
-        .action(async (databaseId, groupType, groupId, options) => {
-        const resolvedAppId = resolveAppId(undefined, options);
-        if (!options.yes) {
-            const inquirer = await import("inquirer");
-            const { confirm } = await inquirer.default.prompt([
-                {
-                    type: "confirm",
-                    name: "confirm",
-                    message: `Revoke permission for group ${groupType}/${groupId} on database ${databaseId}?`,
-                    default: false,
-                },
-            ]);
-            if (!confirm) {
-                info("Cancelled.");
-                return;
-            }
-        }
-        const client = new ApiClient();
-        try {
-            await client.revokeDatabaseGroupPermission(resolvedAppId, databaseId, groupType, groupId);
-            success(`Permission revoked for group ${groupType}/${groupId}.`);
-        }
-        catch (err) {
-            error(err.message);
-            process.exit(1);
-        }
-    });
 }
 //# sourceMappingURL=databases.js.map