@portaidentity/cli 0.1.0

package/dist/commands/user-claim.js

@@ -0,0 +1,123 @@
+/**
+ * CLI user custom claim value subcommands.
+ *
+ * Manages custom claim values for users within an organization.
+ *
+ * Usage:
+ *   porta user claims list --org <org-id> <user-id>
+ *   porta user claims set --org <org-id> <user-id> --claim <claim-id> --value <value>
+ *   porta user claims remove --org <org-id> <user-id> --claim <claim-id>
+ *
+ * @module commands/user-claim
+ */
+import { createClient } from '../client-factory.js';
+import { handleError } from '../error-handler.js';
+import { printTable, printJson, success, warn, info, truncate } from '../output.js';
+// ---------------------------------------------------------------------------
+// Command definition
+// ---------------------------------------------------------------------------
+/** User claims subcommand group — registered under `user` */
+export const userClaimsCommand = {
+    command: 'claims',
+    describe: 'Manage user custom claim values',
+    builder: (yargs) => {
+        return yargs
+            // ── list ───────────────────────────────────────────────────────
+            .command('list <user-id>', 'List custom claim values for a user', (y) => y
+            .positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const claims = await sdkClient.userClaims.list(argv.org, argv['user-id']);
+                if (claims.length === 0) {
+                    warn('No custom claims set');
+                    return;
+                }
+                if (argv.json) {
+                    printJson(claims);
+                }
+                else {
+                    printTable(['Claim ID', 'Claim Name', 'Value'], claims.map((c) => [
+                        truncate(c.claimDefinitionId, 8),
+                        c.claimName ?? '—',
+                        String(c.value),
+                    ]));
+                    info(`Total: ${claims.length} claims`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── set ────────────────────────────────────────────────────────
+            .command('set <user-id>', 'Set a custom claim value for a user', (y) => y
+            .positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID',
+        })
+            .option('claim', {
+            type: 'string',
+            demandOption: true,
+            description: 'Claim definition UUID',
+        })
+            .option('value', {
+            type: 'string',
+            demandOption: true,
+            description: 'Claim value',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.userClaims.set(argv.org, argv['user-id'], argv.claim, argv.value);
+                success(`Claim ${argv.claim} set for user ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── remove ─────────────────────────────────────────────────────
+            .command('remove <user-id>', 'Remove a custom claim value from a user', (y) => y
+            .positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID',
+        })
+            .option('claim', {
+            type: 'string',
+            demandOption: true,
+            description: 'Claim definition UUID to remove',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.userClaims.remove(argv.org, argv['user-id'], argv.claim);
+                success(`Claim ${argv.claim} removed from user ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            .demandCommand(1, 'Specify a claims subcommand: list, set, remove');
+    },
+    handler: () => {
+        // No-op — subcommands handle execution
+    },
+};
+//# sourceMappingURL=user-claim.js.map

package/dist/commands/user-claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-claim.js","sourceRoot":"","sources":["../../src/commands/user-claim.ts"],"names":[],"mappings":"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"}

package/dist/commands/user-role.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI user role assignment subcommands.
+ *
+ * Manages role assignments for users within an organization.
+ *
+ * Usage:
+ *   porta user roles list --org <org-id> <user-id>
+ *   porta user roles assign --org <org-id> <user-id> --role <role-id>
+ *   porta user roles remove --org <org-id> <user-id> --role <role-id>
+ *
+ * @module commands/user-role
+ */
+import type { CommandModule } from 'yargs';
+import type { GlobalOptions } from '../global-options.js';
+/** User roles subcommand group — registered under `user` */
+export declare const userRolesCommand: CommandModule<GlobalOptions, GlobalOptions>;
+//# sourceMappingURL=user-role.d.ts.map

package/dist/commands/user-role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-role.d.ts","sourceRoot":"","sources":["../../src/commands/user-role.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAuB1D,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,aAAa,EAAE,aAAa,CAsHxE,CAAC"}

package/dist/commands/user-role.js

@@ -0,0 +1,118 @@
+/**
+ * CLI user role assignment subcommands.
+ *
+ * Manages role assignments for users within an organization.
+ *
+ * Usage:
+ *   porta user roles list --org <org-id> <user-id>
+ *   porta user roles assign --org <org-id> <user-id> --role <role-id>
+ *   porta user roles remove --org <org-id> <user-id> --role <role-id>
+ *
+ * @module commands/user-role
+ */
+import { createClient } from '../client-factory.js';
+import { handleError } from '../error-handler.js';
+import { printTable, printJson, success, warn, info, formatDate, truncate } from '../output.js';
+// ---------------------------------------------------------------------------
+// Command definition
+// ---------------------------------------------------------------------------
+/** User roles subcommand group — registered under `user` */
+export const userRolesCommand = {
+    command: 'roles',
+    describe: 'Manage user role assignments',
+    builder: (yargs) => {
+        return yargs
+            // ── list ───────────────────────────────────────────────────────
+            .command('list <user-id>', 'List roles assigned to a user', (y) => y
+            .positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const roles = await sdkClient.userRoles.list(argv.org, argv['user-id']);
+                if (roles.length === 0) {
+                    warn('No roles assigned');
+                    return;
+                }
+                if (argv.json) {
+                    printJson(roles);
+                }
+                else {
+                    printTable(['Role ID', 'Role Name', 'Assigned At'], roles.map((r) => [
+                        truncate(r.roleId, 8),
+                        r.roleName ?? '—',
+                        r.assignedAt ? formatDate(r.assignedAt) : '—',
+                    ]));
+                    info(`Total: ${roles.length} roles`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── assign ─────────────────────────────────────────────────────
+            .command('assign <user-id>', 'Assign a role to a user', (y) => y
+            .positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID',
+        })
+            .option('role', {
+            type: 'string',
+            demandOption: true,
+            description: 'Role UUID to assign',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.userRoles.assign(argv.org, argv['user-id'], argv.role);
+                success(`Role ${argv.role} assigned to user ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── remove ─────────────────────────────────────────────────────
+            .command('remove <user-id>', 'Remove a role from a user', (y) => y
+            .positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })
+            .option('org', {
+            type: 'string',
+            demandOption: true,
+            description: 'Organization UUID',
+        })
+            .option('role', {
+            type: 'string',
+            demandOption: true,
+            description: 'Role UUID to remove',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.userRoles.remove(argv.org, argv['user-id'], argv.role);
+                success(`Role ${argv.role} removed from user ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            .demandCommand(1, 'Specify a roles subcommand: list, assign, remove');
+    },
+    handler: () => {
+        // No-op — subcommands handle execution
+    },
+};
+//# sourceMappingURL=user-role.js.map

package/dist/commands/user-role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-role.js","sourceRoot":"","sources":["../../src/commands/user-role.ts"],"names":[],"mappings":"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"}

package/dist/commands/user.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CLI user management commands.
+ *
+ * Provides CRUD, status lifecycle, password management, and nested
+ * role/claim subcommands for users within an organization.
+ * All operations are org-scoped (require --org flag).
+ *
+ * Usage:
+ *   porta user create --org <id> --email <email> [--name "..."] [--password "..."]
+ *   porta user invite --org <id> --email <email> [--name "..."]
+ *   porta user list --org <id> [--status active|invited|...] [--search "..."]
+ *   porta user show --org <id> <user-id>
+ *   porta user update --org <id> <user-id> [--name "..."] [--email "..."]
+ *   porta user suspend/reactivate/lock/unlock/deactivate --org <id> <user-id>
+ *   porta user set-password --org <id> <user-id> --password "..."
+ *   porta user history --org <id> <user-id>
+ *   porta user roles <subcommand> ...
+ *   porta user claims <subcommand> ...
+ *
+ * @module commands/user
+ */
+import type { CommandModule } from 'yargs';
+import type { GlobalOptions } from '../global-options.js';
+/** The user command module — registered at the top level of the CLI */
+export declare const userCommand: CommandModule<GlobalOptions, GlobalOptions>;
+//# sourceMappingURL=user.d.ts.map

package/dist/commands/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/commands/user.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAwE1D,uEAAuE;AACvE,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,aAAa,EAAE,aAAa,CAyanE,CAAC"}

package/dist/commands/user.js

@@ -0,0 +1,352 @@
+/**
+ * CLI user management commands.
+ *
+ * Provides CRUD, status lifecycle, password management, and nested
+ * role/claim subcommands for users within an organization.
+ * All operations are org-scoped (require --org flag).
+ *
+ * Usage:
+ *   porta user create --org <id> --email <email> [--name "..."] [--password "..."]
+ *   porta user invite --org <id> --email <email> [--name "..."]
+ *   porta user list --org <id> [--status active|invited|...] [--search "..."]
+ *   porta user show --org <id> <user-id>
+ *   porta user update --org <id> <user-id> [--name "..."] [--email "..."]
+ *   porta user suspend/reactivate/lock/unlock/deactivate --org <id> <user-id>
+ *   porta user set-password --org <id> <user-id> --password "..."
+ *   porta user history --org <id> <user-id>
+ *   porta user roles <subcommand> ...
+ *   porta user claims <subcommand> ...
+ *
+ * @module commands/user
+ */
+import { createClient } from '../client-factory.js';
+import { handleError } from '../error-handler.js';
+import { printTable, printJson, success, warn, info, formatDate, truncate, } from '../output.js';
+import { confirm } from '../prompt.js';
+import { userRolesCommand } from './user-role.js';
+import { userClaimsCommand } from './user-claim.js';
+// ---------------------------------------------------------------------------
+// Shared option builder for --org
+// ---------------------------------------------------------------------------
+function withOrgOption(y) {
+    return y.option('org', {
+        type: 'string',
+        demandOption: true,
+        description: 'Organization UUID',
+    });
+}
+// ---------------------------------------------------------------------------
+// Command definition
+// ---------------------------------------------------------------------------
+/** The user command module — registered at the top level of the CLI */
+export const userCommand = {
+    command: 'user',
+    describe: 'Manage users within an organization',
+    builder: (yargs) => {
+        return yargs
+            // ── create ──────────────────────────────────────────────────────
+            .command('create', 'Create a new user', (y) => withOrgOption(y)
+            .option('email', {
+            type: 'string',
+            demandOption: true,
+            description: 'User email address',
+        })
+            .option('name', {
+            type: 'string',
+            description: 'User display name',
+        })
+            .option('password', {
+            type: 'string',
+            description: 'Initial password (optional — passwordless if omitted)',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const user = await sdkClient.users.create({
+                    organizationId: argv.org,
+                    email: argv.email,
+                    name: argv.name,
+                    password: argv.password,
+                });
+                if (argv.json) {
+                    printJson(user);
+                }
+                else {
+                    success(`User created: ${user.email}`);
+                    printTable(['Field', 'Value'], [
+                        ['ID', user.id],
+                        ['Email', user.email],
+                        ['Name', user.name ?? '—'],
+                        ['Status', user.status],
+                        ['Created', formatDate(user.createdAt)],
+                    ]);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── invite ──────────────────────────────────────────────────────
+            .command('invite', 'Invite a user via email', (y) => withOrgOption(y)
+            .option('email', {
+            type: 'string',
+            demandOption: true,
+            description: 'Email address to invite',
+        })
+            .option('name', {
+            type: 'string',
+            description: 'Invitee display name',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const user = await sdkClient.users.invite({
+                    organizationId: argv.org,
+                    email: argv.email,
+                    name: argv.name,
+                });
+                if (argv.json) {
+                    printJson(user);
+                }
+                else {
+                    success(`Invitation sent to ${user.email}`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── list ────────────────────────────────────────────────────────
+            .command('list', 'List users in an organization', (y) => withOrgOption(y)
+            .option('status', {
+            type: 'string',
+            choices: ['active', 'invited', 'suspended', 'locked', 'deactivated'],
+            description: 'Filter by status',
+        })
+            .option('search', {
+            type: 'string',
+            description: 'Search by email or name',
+        })
+            .option('page', {
+            type: 'number',
+            default: 1,
+            description: 'Page number',
+        })
+            .option('page-size', {
+            type: 'number',
+            default: 20,
+            description: 'Items per page',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const result = await sdkClient.users.list(argv.org, {
+                    page: argv.page,
+                    pageSize: argv['page-size'],
+                    ...(argv.status && {
+                        status: argv.status,
+                    }),
+                    ...(argv.search && { search: argv.search }),
+                });
+                if (result.data.length === 0) {
+                    warn('No users found');
+                    return;
+                }
+                if (argv.json) {
+                    printJson(result);
+                }
+                else {
+                    printTable(['ID', 'Email', 'Name', 'Status', 'Last Login', 'Created'], result.data.map((u) => [
+                        truncate(u.id, 8),
+                        u.email,
+                        u.name ?? '—',
+                        u.status,
+                        u.lastLoginAt ? formatDate(u.lastLoginAt) : '—',
+                        formatDate(u.createdAt),
+                    ]));
+                    info(`Total: ${result.total} users`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── show ────────────────────────────────────────────────────────
+            .command('show <user-id>', 'Show user details', (y) => withOrgOption(y.positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const { data: u } = await sdkClient.users.get(argv.org, argv['user-id']);
+                if (argv.json) {
+                    printJson(u);
+                }
+                else {
+                    printTable(['Field', 'Value'], [
+                        ['ID', u.id],
+                        ['Email', u.email],
+                        ['Name', u.name ?? '—'],
+                        ['Status', u.status],
+                        ['Email Verified', u.emailVerified ? 'Yes' : 'No'],
+                        ['Has Password', u.hasPassword ? 'Yes' : 'No'],
+                        ['Failed Logins', String(u.failedLoginCount)],
+                        ['Last Login', u.lastLoginAt ? formatDate(u.lastLoginAt) : '—'],
+                        ['Locked At', u.lockedAt ? formatDate(u.lockedAt) : '—'],
+                        ['Created', formatDate(u.createdAt)],
+                        ['Updated', formatDate(u.updatedAt)],
+                    ]);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── update ──────────────────────────────────────────────────────
+            .command('update <user-id>', 'Update user fields', (y) => withOrgOption(y.positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        }))
+            .option('name', {
+            type: 'string',
+            description: 'New display name',
+        })
+            .option('email', {
+            type: 'string',
+            description: 'New email address',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const { etag } = await sdkClient.users.get(argv.org, argv['user-id']);
+                const updated = await sdkClient.users.update(argv.org, argv['user-id'], {
+                    name: argv.name,
+                    email: argv.email,
+                }, etag ?? undefined);
+                if (argv.json) {
+                    printJson(updated);
+                }
+                else {
+                    success(`User updated: ${updated.email}`);
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── status lifecycle commands ───────────────────────────────────
+            .command('suspend <user-id>', 'Suspend a user', (y) => withOrgOption(y.positional('user-id', { type: 'string', demandOption: true, description: 'User UUID' })), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.users.suspend(argv.org, argv['user-id']);
+                success(`User suspended: ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            .command('reactivate <user-id>', 'Reactivate a suspended user', (y) => withOrgOption(y.positional('user-id', { type: 'string', demandOption: true, description: 'User UUID' })), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.users.reactivate(argv.org, argv['user-id']);
+                success(`User reactivated: ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            .command('lock <user-id>', 'Lock a user account', (y) => withOrgOption(y.positional('user-id', { type: 'string', demandOption: true, description: 'User UUID' })), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.users.lock(argv.org, argv['user-id']);
+                success(`User locked: ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            .command('unlock <user-id>', 'Unlock a locked user account', (y) => withOrgOption(y.positional('user-id', { type: 'string', demandOption: true, description: 'User UUID' })), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.users.unlock(argv.org, argv['user-id']);
+                success(`User unlocked: ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            .command('deactivate <user-id>', 'Deactivate a user (permanent)', (y) => withOrgOption(y.positional('user-id', { type: 'string', demandOption: true, description: 'User UUID' })), async (argv) => {
+            try {
+                if (!argv.force) {
+                    const confirmed = await confirm(`Deactivate user ${argv['user-id']}? This action is permanent.`);
+                    if (!confirmed) {
+                        warn('Operation cancelled');
+                        return;
+                    }
+                }
+                const sdkClient = createClient(argv);
+                await sdkClient.users.deactivate(argv.org, argv['user-id']);
+                success(`User deactivated: ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── set-password ────────────────────────────────────────────────
+            .command('set-password <user-id>', 'Set or reset a user password', (y) => withOrgOption(y.positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })).option('password', {
+            type: 'string',
+            demandOption: true,
+            description: 'New password',
+        }), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                await sdkClient.users.setPassword(argv.org, argv['user-id'], {
+                    password: argv.password,
+                });
+                success(`Password set for user: ${argv['user-id']}`);
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── history ─────────────────────────────────────────────────────
+            .command('history <user-id>', 'Show user change history', (y) => withOrgOption(y.positional('user-id', {
+            type: 'string',
+            demandOption: true,
+            description: 'User UUID',
+        })), async (argv) => {
+            try {
+                const sdkClient = createClient(argv);
+                const history = await sdkClient.users.getHistory(argv.org, argv['user-id']);
+                if (history.length === 0) {
+                    warn('No history entries found');
+                    return;
+                }
+                if (argv.json) {
+                    printJson(history);
+                }
+                else {
+                    printTable(['Date', 'Action', 'Actor', 'Changes'], history.map((h) => [
+                        formatDate(h.createdAt),
+                        h.action,
+                        h.performedBy ?? '—',
+                        h.changes ? JSON.stringify(h.changes).slice(0, 60) : '—',
+                    ]));
+                }
+            }
+            catch (err) {
+                handleError(err, argv.verbose);
+            }
+        })
+            // ── nested subcommand groups ────────────────────────────────────
+            .command(userRolesCommand)
+            .command(userClaimsCommand)
+            .demandCommand(1, 'Specify a user subcommand: create, invite, list, show, update, suspend, reactivate, lock, unlock, deactivate, set-password, history, roles, claims');
+    },
+    handler: () => {
+        // No-op — subcommands handle execution
+    },
+};
+//# sourceMappingURL=user.js.map