figmanage 1.0.1 → 1.2.0

package/dist/cli/org.js

@@ -0,0 +1,227 @@
+import { Command } from 'commander';
+import { listAdmins, listOrgTeams, seatUsage, listTeamMembers, billingOverview, listInvoices, orgDomains, aiCreditUsage, exportMembers, listOrgMembers, contractRates, changeSeat, } from '../operations/org.js';
+import { output, error } from './format.js';
+import { requireCookie } from './helpers.js';
+export function orgCommand() {
+    const org = new Command('org')
+        .description('Org administration and billing');
+    org
+        .command('list-admins')
+        .description('List org admins with permission levels and seat status')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--include-license-admins', 'Include license admins')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listAdmins(config, {
+                org_id: options.orgId,
+                include_license_admins: options.includeLicenseAdmins,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('list-teams')
+        .description('List all teams in the org')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--include-secret-teams', 'Include secret teams')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listOrgTeams(config, {
+                org_id: options.orgId,
+                include_secret_teams: options.includeSecretTeams,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('seat-usage')
+        .description('Seat usage breakdown by type and activity')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--search <query>', 'Filter counts by user search query')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await seatUsage(config, {
+                org_id: options.orgId,
+                search_query: options.search,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('team-members <team-id>')
+        .description('List members of a team')
+        .option('--json', 'Force JSON output')
+        .action(async (teamId, options) => {
+        try {
+            const config = requireCookie();
+            const result = await listTeamMembers(config, { team_id: teamId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('billing')
+        .description('Org billing data including invoice history and amounts')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await billingOverview(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('invoices')
+        .description('List open and upcoming invoices')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listInvoices(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('domains')
+        .description('Org domain configuration and SSO/SAML settings')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await orgDomains(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('ai-credits <plan-id>')
+        .description('AI credit usage summary for a billing plan')
+        .option('--json', 'Force JSON output')
+        .action(async (planId, options) => {
+        try {
+            const config = requireCookie();
+            const result = await aiCreditUsage(config, { plan_id: planId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('export-members')
+        .description('Trigger async CSV export of all org members')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const msg = await exportMembers(config, { org_id: options.orgId });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('members')
+        .description('List org members with seat type, permission, and activity')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--search <query>', 'Filter members by name or email')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listOrgMembers(config, {
+                org_id: options.orgId,
+                search_query: options.search,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('contract-rates')
+        .description('Seat pricing per type (expert, developer, collaborator)')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await contractRates(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('change-seat <user-id> <seat-type>')
+        .description("Change a user's seat type (full, dev, collab, view)")
+        .option('--org-id <id>', 'Org ID override')
+        .option('--confirm', 'Authorize billing change for upgrades')
+        .option('--json', 'Force JSON output')
+        .action(async (userId, seatType, options) => {
+        try {
+            const config = requireCookie();
+            const result = await changeSeat(config, {
+                user_id: userId,
+                seat_type: seatType,
+                org_id: options.orgId,
+                confirm: options.confirm,
+            });
+            if (typeof result === 'string') {
+                output({ message: result }, options);
+            }
+            else {
+                output(result, options);
+            }
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return org;
+}
+//# sourceMappingURL=org.js.map

package/dist/cli/permissions.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function permissionsCommand(): Command;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/cli/permissions.js

@@ -0,0 +1,133 @@
+import { Command } from 'commander';
+import { getPermissions, setPermissions, share, revokeAccess, listRoleRequests, approveRoleRequest, denyRoleRequest, } from '../operations/permissions.js';
+import { output, error } from './format.js';
+import { requireCookie } from './helpers.js';
+export function permissionsCommand() {
+    const permissions = new Command('permissions')
+        .description('Manage file, project, and team permissions');
+    permissions
+        .command('get <resource-type> <resource-id>')
+        .description('See who has access to a file, project, or team')
+        .option('--json', 'Force JSON output')
+        .action(async (resourceType, resourceId, options) => {
+        try {
+            const config = requireCookie();
+            const result = await getPermissions(config, {
+                resource_type: resourceType,
+                resource_id: resourceId,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    permissions
+        .command('set <resource-type> <resource-id> <user-id> <role>')
+        .description('Change access level for a user on a file, project, or team')
+        .option('--json', 'Force JSON output')
+        .action(async (resourceType, resourceId, userId, role, options) => {
+        try {
+            const config = requireCookie();
+            const msg = await setPermissions(config, {
+                resource_type: resourceType,
+                resource_id: resourceId,
+                user_id: userId,
+                role,
+            });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    permissions
+        .command('share <resource-type> <resource-id> <email>')
+        .description('Share a file or project with someone by email')
+        .option('--role <role>', 'Role to grant (editor or viewer)', 'viewer')
+        .option('--json', 'Force JSON output')
+        .action(async (resourceType, resourceId, email, options) => {
+        try {
+            const config = requireCookie();
+            const result = await share(config, {
+                resource_type: resourceType,
+                resource_id: resourceId,
+                email,
+                role: options.role,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    permissions
+        .command('revoke <resource-type> <resource-id> <user-id>')
+        .description("Remove someone's access to a file, project, or team")
+        .option('--json', 'Force JSON output')
+        .action(async (resourceType, resourceId, userId, options) => {
+        try {
+            const config = requireCookie();
+            const msg = await revokeAccess(config, {
+                resource_type: resourceType,
+                resource_id: resourceId,
+                user_id: userId,
+            });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    permissions
+        .command('requests')
+        .description('List pending file access requests')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listRoleRequests(config);
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    permissions
+        .command('approve <notification-id>')
+        .description('Approve a pending file access request')
+        .option('--json', 'Force JSON output')
+        .action(async (notificationId, options) => {
+        try {
+            const config = requireCookie();
+            const msg = await approveRoleRequest(config, { notification_id: notificationId });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    permissions
+        .command('deny <notification-id>')
+        .description('Decline a pending file access request')
+        .option('--json', 'Force JSON output')
+        .action(async (notificationId, options) => {
+        try {
+            const config = requireCookie();
+            const msg = await denyRoleRequest(config, { notification_id: notificationId });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return permissions;
+}
+//# sourceMappingURL=permissions.js.map

package/dist/cli/projects.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function projectsCommand(): Command;
+//# sourceMappingURL=projects.d.ts.map

package/dist/cli/projects.js

@@ -0,0 +1,110 @@
+import { Command } from 'commander';
+import { createProject, renameProject, moveProject, trashProject, restoreProject, setProjectDescription, } from '../operations/projects.js';
+import { output, error } from './format.js';
+import { requireCookie } from './helpers.js';
+export function projectsCommand() {
+    const projects = new Command('projects')
+        .description('Manage Figma projects');
+    projects
+        .command('create <team-id>')
+        .description('Create a new project in a team')
+        .requiredOption('--name <name>', 'Project name')
+        .option('--json', 'Force JSON output')
+        .action(async (teamId, options) => {
+        try {
+            const config = requireCookie();
+            const result = await createProject(config, { team_id: teamId, name: options.name });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    projects
+        .command('rename <project-id>')
+        .description('Rename a project')
+        .requiredOption('--name <name>', 'New name')
+        .option('--json', 'Force JSON output')
+        .action(async (projectId, options) => {
+        try {
+            const config = requireCookie();
+            await renameProject(config, { project_id: projectId, name: options.name });
+            output({ renamed: projectId, name: options.name }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    projects
+        .command('move <project-id>')
+        .description('Move a project to a different team')
+        .requiredOption('--destination <team-id>', 'Destination team ID')
+        .option('--json', 'Force JSON output')
+        .action(async (projectId, options) => {
+        try {
+            const config = requireCookie();
+            await moveProject(config, {
+                project_id: projectId,
+                destination_team_id: options.destination,
+            });
+            output({ moved: projectId, destination_team_id: options.destination }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    projects
+        .command('trash <project-id>')
+        .description('Move a project to trash')
+        .option('--json', 'Force JSON output')
+        .action(async (projectId, options) => {
+        try {
+            const config = requireCookie();
+            await trashProject(config, { project_id: projectId });
+            output({ trashed: projectId }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    projects
+        .command('restore <project-id>')
+        .description('Restore a project from trash')
+        .option('--json', 'Force JSON output')
+        .action(async (projectId, options) => {
+        try {
+            const config = requireCookie();
+            await restoreProject(config, { project_id: projectId });
+            output({ restored: projectId }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    projects
+        .command('set-description <project-id>')
+        .description('Set or update a project description')
+        .requiredOption('--description <text>', 'Description text')
+        .option('--json', 'Force JSON output')
+        .action(async (projectId, options) => {
+        try {
+            const config = requireCookie();
+            await setProjectDescription(config, {
+                project_id: projectId,
+                description: options.description,
+            });
+            output({ updated: projectId }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return projects;
+}
+//# sourceMappingURL=projects.js.map

package/dist/cli/reading.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function readingCommand(): Command;
+//# sourceMappingURL=reading.d.ts.map

package/dist/cli/reading.js

@@ -0,0 +1,51 @@
+import { Command } from 'commander';
+import { getFile, getNodes } from '../operations/reading.js';
+import { output, error } from './format.js';
+import { requirePat } from './helpers.js';
+export function readingCommand() {
+    const reading = new Command('reading')
+        .description('Read file contents and node trees');
+    reading
+        .command('get-file <file-key>')
+        .description('Read file contents as a node tree')
+        .option('--depth <n>', 'Tree depth limit (0=root, 1=pages, 2=top-level frames)')
+        .option('--node-id <id>', 'Start from a specific node instead of document root')
+        .option('--json', 'Force JSON output')
+        .action(async (fileKey, options) => {
+        try {
+            const config = requirePat();
+            const result = await getFile(config, {
+                file_key: fileKey,
+                depth: options.depth !== undefined ? parseInt(options.depth, 10) : undefined,
+                node_id: options.nodeId,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    reading
+        .command('get-nodes <file-key> <node-ids...>')
+        .description('Read specific nodes from a file')
+        .option('--depth <n>', 'Depth limit per node')
+        .option('--json', 'Force JSON output')
+        .action(async (fileKey, nodeIds, options) => {
+        try {
+            const config = requirePat();
+            const result = await getNodes(config, {
+                file_key: fileKey,
+                node_ids: nodeIds,
+                depth: options.depth !== undefined ? parseInt(options.depth, 10) : undefined,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return reading;
+}
+//# sourceMappingURL=reading.js.map

package/dist/cli/teams.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function teamsCommand(): Command;
+//# sourceMappingURL=teams.d.ts.map

package/dist/cli/teams.js

@@ -0,0 +1,56 @@
+import { Command } from 'commander';
+import { createTeam, renameTeam, deleteTeam } from '../operations/teams.js';
+import { output, error } from './format.js';
+import { requireCookie } from './helpers.js';
+export function teamsCommand() {
+    const teams = new Command('teams')
+        .description('Create, rename, and delete teams');
+    teams
+        .command('create <name>')
+        .description('Create a new team in the org')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (name, options) => {
+        try {
+            const config = requireCookie();
+            const result = await createTeam(config, { name, org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    teams
+        .command('rename <team-id> <name>')
+        .description('Rename an existing team')
+        .option('--json', 'Force JSON output')
+        .action(async (teamId, name, options) => {
+        try {
+            const config = requireCookie();
+            const msg = await renameTeam(config, { team_id: teamId, name });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    teams
+        .command('delete <team-id>')
+        .description('Delete a team (destructive, cannot be undone)')
+        .option('--json', 'Force JSON output')
+        .action(async (teamId, options) => {
+        try {
+            const config = requireCookie();
+            const msg = await deleteTeam(config, { team_id: teamId });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return teams;
+}
+//# sourceMappingURL=teams.js.map

package/dist/cli/variables.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function variablesCommand(): Command;
+//# sourceMappingURL=variables.d.ts.map

package/dist/cli/variables.js

@@ -0,0 +1,80 @@
+import { Command } from 'commander';
+import { listLocalVariables, listPublishedVariables, updateVariables, isEnterpriseScopeError, ENTERPRISE_ERROR, } from '../operations/variables.js';
+import { output, error } from './format.js';
+import { requirePat } from './helpers.js';
+export function variablesCommand() {
+    const variables = new Command('variables')
+        .description('Manage file variables (Enterprise)');
+    variables
+        .command('list-local <file-key>')
+        .description('List local variables and variable collections in a file')
+        .option('--json', 'Force JSON output')
+        .action(async (fileKey, options) => {
+        try {
+            const config = requirePat();
+            const result = await listLocalVariables(config, { file_key: fileKey });
+            output(result, options);
+        }
+        catch (e) {
+            if (isEnterpriseScopeError(e)) {
+                error(ENTERPRISE_ERROR);
+            }
+            else {
+                error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            }
+            process.exit(1);
+        }
+    });
+    variables
+        .command('list-published <file-key>')
+        .description('List published variables from a library file')
+        .option('--json', 'Force JSON output')
+        .action(async (fileKey, options) => {
+        try {
+            const config = requirePat();
+            const result = await listPublishedVariables(config, { file_key: fileKey });
+            output(result, options);
+        }
+        catch (e) {
+            if (isEnterpriseScopeError(e)) {
+                error(ENTERPRISE_ERROR);
+            }
+            else {
+                error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            }
+            process.exit(1);
+        }
+    });
+    variables
+        .command('update <file-key>')
+        .description('Bulk create, update, or delete variables, collections, modes, and mode values')
+        .option('--variable-collections <json>', 'Collection operations as JSON array')
+        .option('--variable-modes <json>', 'Mode operations as JSON array')
+        .option('--variables <json>', 'Variable operations as JSON array')
+        .option('--variable-mode-values <json>', 'Value assignments as JSON array')
+        .option('--json', 'Force JSON output')
+        .action(async (fileKey, options) => {
+        try {
+            const config = requirePat();
+            const result = await updateVariables(config, {
+                file_key: fileKey,
+                variable_collections: options.variableCollections ? JSON.parse(options.variableCollections) : undefined,
+                variable_modes: options.variableModes ? JSON.parse(options.variableModes) : undefined,
+                variables: options.variables ? JSON.parse(options.variables) : undefined,
+                variable_mode_values: options.variableModeValues ? JSON.parse(options.variableModeValues) : undefined,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            if (isEnterpriseScopeError(e)) {
+                error(ENTERPRISE_ERROR);
+            }
+            else {
+                error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            }
+            process.exit(1);
+        }
+    });
+    return variables;
+}
+//# sourceMappingURL=variables.js.map