@forumulate/cli 0.5.0 → 0.8.0

package/dist/commands/groups-org.js

@@ -0,0 +1,405 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORG_GROUPS = void 0;
+/**
+ * The organization's people and plumbing: orgs, members, invites, groups,
+ * roles, service accounts, tokens, webhooks, extensions, audit.
+ *
+ * Onboarding 200 people is a script, not 200 clicks, and the token a CI job
+ * runs on is rotated from a terminal — these are what an org admin scripts.
+ */
+exports.ORG_GROUPS = [
+    {
+        name: 'orgs',
+        noun: 'org',
+        about: 'organizations you belong to, their DeepL key and their UI string overrides',
+        verbs: {
+            list: {
+                op: 'Org_list',
+                about: 'List your organizations',
+                columns: ['id', 'slug', 'name', 'role'],
+            },
+            get: { op: 'Org_get', about: 'Get one organization (id or slug)', args: ['orgId'] },
+            create: { op: 'Org_create', about: 'Create an organization', args: ['name'] },
+            update: { op: 'Org_update', about: 'Update an organization', args: ['orgId'] },
+            delete: {
+                op: 'Org_remove',
+                about: 'Delete an organization',
+                args: ['orgId'],
+                destructive: true,
+            },
+            'deepl status': { op: 'Deepl_status', about: 'Whether a DeepL key is connected' },
+            'deepl set': {
+                op: 'Deepl_setKey',
+                about: 'Connect the organization’s own DeepL key (what every auto-translate uses)',
+                args: ['apiKey'],
+            },
+            'deepl clear': {
+                op: 'Deepl_clear',
+                about: 'Disconnect the DeepL key',
+                destructive: true,
+            },
+            'strings list': {
+                op: 'TranslationOverride_list',
+                about: 'The organization’s own wording for interface strings (--locale es)',
+                columns: ['locale', 'key', 'value', 'updatedAt'],
+            },
+            'strings set': {
+                op: 'TranslationOverride_set',
+                about: 'Override one interface string in one language',
+                args: ['locale', 'key', 'value...'],
+            },
+            'strings remove': {
+                op: 'TranslationOverride_remove',
+                about: 'Drop an override (readers see the built-in wording again)',
+                args: ['locale', 'key'],
+                extraQuery: ['locale', 'key'],
+                destructive: true,
+            },
+        },
+    },
+    {
+        name: 'members',
+        noun: 'member',
+        about: 'people in an organization',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Member_list',
+                about: 'List members',
+                columns: ['userId', 'email', 'name', 'role', 'createdAt'],
+            },
+            update: { op: 'Member_update', about: 'Change a member’s role (--role)', args: ['userId'] },
+            remove: {
+                op: 'Member_remove',
+                about: 'Remove a member',
+                args: ['userId'],
+                destructive: true,
+            },
+            'sign-out': {
+                op: 'Member_revokeSessions',
+                about: 'End every session a member has open',
+                args: ['userId'],
+                destructive: true,
+            },
+            reassign: {
+                op: 'Member_reassignContent',
+                about: 'Hand everything a member wrote to someone else',
+                args: ['userId', 'targetUserId'],
+            },
+        },
+    },
+    {
+        name: 'invites',
+        noun: 'invite',
+        about: 'invitations: sent, bulk, shareable links, and the ones waiting for you',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Member_invites',
+                about: 'List pending invites',
+                columns: ['id', 'email', 'role', 'expiresAt'],
+            },
+            create: { op: 'Member_invite', about: 'Invite someone (--role)', args: ['email'] },
+            bulk: {
+                op: 'Member_bulkInvite',
+                about: 'Invite many at once (a,b,c or --csv; --role)',
+                args: ['emails'],
+            },
+            revoke: {
+                op: 'Member_revokeInvite',
+                about: 'Revoke an invite',
+                args: ['inviteId'],
+                destructive: true,
+            },
+            'links list': {
+                op: 'Member_listInviteLinks',
+                about: 'Shareable invite links',
+                columns: ['id', 'role', 'uses', 'maxUses', 'expiresAt'],
+            },
+            'links create': {
+                op: 'Member_createInviteLink',
+                about: 'Make a link anyone can join with (--role, --maxUses, --expiresInDays)',
+            },
+            'links revoke': {
+                op: 'Member_revokeInviteLink',
+                about: 'Turn a link off',
+                args: ['linkId'],
+                destructive: true,
+            },
+            pending: {
+                op: 'Invite_pending',
+                about: 'Invitations waiting for YOU',
+                columns: ['id', 'orgName', 'role', 'expiresAt'],
+            },
+            accept: { op: 'Invite_acceptPending', about: 'Accept one of yours', args: ['inviteId'] },
+            redeem: {
+                op: 'Invite_accept',
+                about: 'Accept an invite by the token in its email',
+                args: ['token'],
+            },
+            join: {
+                op: 'Invite_acceptLink',
+                about: 'Join through a shareable link’s token',
+                args: ['token'],
+            },
+        },
+    },
+    {
+        name: 'groups',
+        noun: 'group',
+        about: 'groups of members: grants, flair, join requests',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Group_list',
+                about: 'List groups',
+                columns: ['id', 'name', 'visibility', 'joinPolicy', 'memberCount'],
+            },
+            get: { op: 'Group_get', about: 'Get one group', args: ['groupId'] },
+            create: {
+                op: 'Group_create',
+                about: 'Create a group (--visibility, --joinPolicy)',
+                args: ['name'],
+            },
+            update: { op: 'Group_update', about: 'Update a group', args: ['groupId'] },
+            delete: { op: 'Group_remove', about: 'Delete a group', args: ['groupId'], destructive: true },
+            'members add': {
+                op: 'Group_addMember',
+                about: 'Add a member (--isManager true)',
+                args: ['groupId', 'userId'],
+            },
+            'members remove': {
+                op: 'Group_removeMember',
+                about: 'Remove a member',
+                args: ['groupId', 'userId'],
+                destructive: true,
+            },
+            join: { op: 'Group_join', about: 'Join a group (or ask to)', args: ['groupId'] },
+            leave: { op: 'Group_leave', about: 'Leave a group', args: ['groupId'] },
+            'requests list': {
+                op: 'Group_requests',
+                about: 'Requests to join',
+                args: ['groupId'],
+                columns: ['id', 'userId', 'createdAt'],
+            },
+            'requests review': {
+                op: 'Group_review',
+                about: 'Approve or reject a request (approve|reject)',
+                args: ['groupId', 'requestId', 'action'],
+            },
+        },
+    },
+    {
+        name: 'roles',
+        noun: 'role',
+        about: 'custom roles: named sets of capabilities',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'CustomRole_list',
+                about: 'List custom roles',
+                columns: ['id', 'name', 'capabilities'],
+            },
+            create: {
+                op: 'CustomRole_create',
+                about: 'Create a role (--capabilities docs.read,docs.write)',
+                args: ['name'],
+            },
+            update: {
+                op: 'CustomRole_update',
+                about: 'Rename it or change its capabilities',
+                args: ['id'],
+            },
+            delete: { op: 'CustomRole_remove', about: 'Delete a role', args: ['id'], destructive: true },
+        },
+    },
+    {
+        name: 'service-accounts',
+        aliases: ['bots'],
+        noun: 'service account',
+        about: 'non-human members and the tokens they run on',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'ServiceAccount_list',
+                about: 'List service accounts',
+                columns: ['id', 'name', 'username', 'role', 'createdAt'],
+            },
+            create: { op: 'ServiceAccount_create', about: 'Create one (--role EDITOR)', args: ['name'] },
+            rename: {
+                op: 'ServiceAccount_rename',
+                about: 'Rename it (--username)',
+                args: ['id', 'name'],
+            },
+            revoke: {
+                op: 'ServiceAccount_revoke',
+                about: 'Remove it and every token it holds',
+                args: ['id'],
+                destructive: true,
+            },
+            'tokens list': {
+                op: 'ServiceAccount_tokens',
+                about: 'Its tokens',
+                args: ['id'],
+                columns: ['id', 'name', 'scopes', 'lastUsedAt', 'expiresAt'],
+            },
+            'tokens create': {
+                op: 'ServiceAccount_mint',
+                about: 'Mint a token (--scopes read,write; shown once)',
+                args: ['id', 'name'],
+            },
+            'tokens revoke': {
+                op: 'ServiceAccount_revokeToken',
+                about: 'Revoke one token',
+                args: ['id', 'tokenId'],
+                destructive: true,
+            },
+        },
+    },
+    {
+        name: 'tokens',
+        aliases: ['pats'],
+        noun: 'token',
+        about: 'your personal access tokens',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Pat_list',
+                about: 'List tokens',
+                columns: ['id', 'name', 'scopes', 'lastUsedAt', 'expiresAt'],
+            },
+            scopes: { op: 'Pat_scopes', about: 'The scopes a token can carry' },
+            create: {
+                op: 'Pat_create',
+                about: 'Mint a token (--scopes read,write; shown once)',
+                args: ['name'],
+            },
+            rotate: {
+                op: 'Pat_rotate',
+                about: 'Rotate a token (--graceMinutes)',
+                args: ['id'],
+                lookup: { id: { listOp: 'Pat_list', match: ['name'] } },
+            },
+            rename: {
+                op: 'Pat_rename',
+                about: 'Rename a token',
+                args: ['id', 'name'],
+                lookup: { id: { listOp: 'Pat_list', match: ['name'] } },
+            },
+            revoke: {
+                op: 'Pat_revoke',
+                about: 'Revoke a token',
+                args: ['id'],
+                destructive: true,
+                lookup: { id: { listOp: 'Pat_list', match: ['name'] } },
+            },
+        },
+    },
+    {
+        name: 'webhooks',
+        noun: 'webhook',
+        about: 'webhook endpoints, their deliveries, and replays',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Webhook_list',
+                about: 'List webhooks',
+                columns: ['id', 'url', 'events', 'active', 'format'],
+            },
+            events: { op: 'Webhook_events', about: 'The event names a webhook can subscribe to' },
+            create: {
+                op: 'Webhook_create',
+                about: 'Create a webhook (--events a,b; the secret is shown once)',
+                args: ['url'],
+            },
+            update: { op: 'Webhook_update', about: 'Update a webhook', args: ['webhookId'] },
+            delete: {
+                op: 'Webhook_remove',
+                about: 'Delete a webhook',
+                args: ['webhookId'],
+                destructive: true,
+            },
+            test: { op: 'Webhook_ping', about: 'Send a test delivery', args: ['webhookId'] },
+            'rotate-secret': {
+                op: 'Webhook_rotate',
+                about: 'Rotate the signing secret',
+                args: ['webhookId'],
+            },
+            deliveries: {
+                op: 'Webhook_deliveries',
+                about: 'Recent deliveries',
+                args: ['webhookId'],
+                columns: ['id', 'event', 'status', 'attempts', 'createdAt'],
+            },
+            replay: {
+                op: 'Webhook_replay',
+                about: 'Re-send one delivery',
+                args: ['webhookId', 'deliveryId'],
+            },
+        },
+    },
+    {
+        name: 'extensions',
+        noun: 'extension',
+        about: 'installed remote-app extensions and the marketplace',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Extension_list',
+                about: 'Installed extensions',
+                columns: ['id', 'name', 'version', 'enabled'],
+            },
+            available: {
+                op: 'Extension_available',
+                about: 'What the marketplace offers',
+                columns: ['slug', 'name', 'version', 'description'],
+            },
+            install: {
+                op: 'Extension_install',
+                about: 'Install from a manifest URL (or --manifest @m.json)',
+                args: ['manifestUrl'],
+            },
+            update: {
+                op: 'Extension_update',
+                about: 'Change its config, events or --enabled',
+                args: ['id'],
+            },
+            uninstall: {
+                op: 'Extension_uninstall',
+                about: 'Uninstall it',
+                args: ['id'],
+                destructive: true,
+            },
+            test: { op: 'Extension_test', about: 'Send it a test event', args: ['id'] },
+            deliveries: {
+                op: 'Extension_deliveries',
+                about: 'What was sent to it',
+                args: ['id'],
+                columns: ['id', 'event', 'status', 'createdAt'],
+            },
+            rotate: { op: 'Extension_rotate', about: 'Rotate its signing secret', args: ['id'] },
+            upgrade: { op: 'Extension_upgrade', about: 'Move to the newest manifest', args: ['id'] },
+        },
+    },
+    {
+        name: 'audit',
+        noun: 'audit entry',
+        about: 'the organization’s audit log',
+        defaultVerb: 'list',
+        verbs: {
+            list: {
+                op: 'Audit_list',
+                about: 'Who did what (--action, --actorUserId, --from, --to)',
+                columns: ['createdAt', 'action', 'actorUserId', 'targetType', 'targetId'],
+            },
+            actions: { op: 'Audit_actions', about: 'The action names the log records' },
+            export: {
+                op: 'Audit_exportCsv',
+                about: 'The log as CSV (same filters)',
+                download: 'audit.csv',
+            },
+        },
+    },
+];
+//# sourceMappingURL=groups-org.js.map

package/dist/commands/groups-org.js.map

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

package/dist/commands/groups-site.d.ts

@@ -0,0 +1,3 @@
+import type { GroupDef } from './resource';
+export declare const SITE_GROUPS: GroupDef[];
+//# sourceMappingURL=groups-site.d.ts.map

package/dist/commands/groups-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups-site.d.ts","sourceRoot":"","sources":["../../src/commands/groups-site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,YAAY,CAAC;AAqCpD,eAAO,MAAM,WAAW,EAAE,QAAQ,EA4MjC,CAAC"}

package/dist/commands/groups-site.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITE_GROUPS = void 0;
+/**
+ * The look and the address of what readers see: a space's theme (live and
+ * draft, and the portable bundle), the sites that join spaces under one
+ * domain, and the GitHub sync that keeps docs in a repository.
+ *
+ * `theme pull`/`push` was the ask: a theme kept in git and pushed from CI.
+ * `export`/`import` move the whole bundle; `draft …` stages a change and
+ * `draft publish` makes it live, the same two steps the studio takes.
+ */
+/** The draft verbs a space's and a site's theme share; the two differ only in operationIds. */
+function draftVerbs(ops) {
+    return {
+        'draft get': { op: ops.get, about: 'The theme draft, if there is one' },
+        'draft set': { op: ops.set, about: 'Replace the draft (--data @theme.json)' },
+        'draft patch': {
+            op: ops.patch,
+            about: 'Merge into the draft (--primaryColor …, --data @patch.json)',
+        },
+        'draft apply': {
+            op: ops.apply,
+            about: 'Stage a marketplace component into the draft (--componentId)',
+        },
+        'draft discard': { op: ops.discard, about: 'Throw the draft away', destructive: true },
+        'draft publish': { op: ops.publish, about: 'Make the draft live (--force)' },
+    };
+}
+exports.SITE_GROUPS = [
+    {
+        name: 'theme',
+        noun: 'theme',
+        about: 'a space’s reader theme: live, draft, and the portable bundle',
+        defaultVerb: 'get',
+        verbs: {
+            get: { op: 'SpaceSettings_getTheme', about: 'The live theme' },
+            set: { op: 'SpaceSettings_setTheme', about: 'Replace the live theme (--data @theme.json)' },
+            patch: {
+                op: 'SpaceSettings_patchTheme',
+                about: 'Change some keys of the live theme (--primaryColor "#0a7")',
+            },
+            ...draftVerbs({
+                get: 'SpaceSettings_getThemeDraft',
+                set: 'SpaceSettings_setThemeDraft',
+                patch: 'SpaceSettings_patchThemeDraft',
+                discard: 'SpaceSettings_discardThemeDraft',
+                publish: 'SpaceSettings_publishThemeDraft',
+                apply: 'ThemeBundle_applySpace',
+            }),
+            export: {
+                op: 'ThemeBundle_exportSpace',
+                about: 'The theme as a portable bundle (--json > theme.json)',
+            },
+            import: {
+                op: 'ThemeBundle_importSpace',
+                about: 'Load a bundle into the draft (--data @theme.json)',
+            },
+        },
+    },
+    {
+        name: 'sites',
+        noun: 'site',
+        about: 'sites: several spaces under one domain and one theme',
+        defaultVerb: 'list',
+        verbs: {
+            list: { op: 'Site_list', about: 'List sites', columns: ['id', 'slug', 'name', 'createdAt'] },
+            get: { op: 'Site_get', about: 'Get one site', args: ['siteId'] },
+            create: {
+                op: 'Site_create',
+                about: 'Create a site (--slug, --spaceIds a,b)',
+                args: ['name'],
+            },
+            update: { op: 'Site_update', about: 'Change some of it (--dryRun true)', args: ['siteId'] },
+            replace: {
+                op: 'Site_replace',
+                about: 'Replace its whole config (--data @site.json)',
+                args: ['siteId'],
+            },
+            delete: { op: 'Site_remove', about: 'Delete a site', args: ['siteId'], destructive: true },
+            staging: {
+                op: 'Site_setStaging',
+                about: 'Turn the staging copy on or off (true|false)',
+                args: ['siteId', 'staging'],
+            },
+            'domains list': {
+                op: 'Site_listDomains',
+                about: 'The site’s domains',
+                args: ['siteId'],
+                columns: ['id', 'hostname', 'basePath', 'verified', 'active'],
+            },
+            'domains add': {
+                op: 'Site_addDomain',
+                about: 'Add a domain (--basePath)',
+                args: ['siteId', 'hostname'],
+            },
+            'domains subdomain': {
+                op: 'Site_allocateSubdomain',
+                about: 'Take a free subdomain',
+                args: ['siteId', 'subdomain'],
+            },
+            'domains setup': {
+                op: 'Site_domainSetup',
+                about: 'What a domain is still waiting for',
+                args: ['siteId', 'domainId'],
+            },
+            'domains www': {
+                op: 'Site_setDomainWww',
+                about: 'Also redirect www. (true|false)',
+                args: ['siteId', 'domainId', 'alsoRedirectWww'],
+            },
+            'domains verify': {
+                op: 'Site_verifyDomain',
+                about: 'Re-run verification',
+                args: ['siteId', 'domainId'],
+            },
+            'domains activate': {
+                op: 'Site_activateDomain',
+                about: 'Start serving it',
+                args: ['siteId', 'domainId'],
+            },
+            'domains remove': {
+                op: 'Site_removeDomain',
+                about: 'Remove a domain',
+                args: ['siteId', 'domainId'],
+                destructive: true,
+            },
+            'theme export': {
+                op: 'ThemeBundle_exportSite',
+                about: 'The site theme as a bundle',
+                args: ['siteId'],
+            },
+            'theme import': {
+                op: 'ThemeBundle_importSite',
+                about: 'Load a bundle into the site draft (--data @theme.json)',
+                args: ['siteId'],
+            },
+            ...Object.fromEntries(Object.entries(draftVerbs({
+                get: 'ThemeBundle_siteDraft',
+                set: 'ThemeBundle_setSiteDraft',
+                patch: 'ThemeBundle_patchSiteDraft',
+                discard: 'ThemeBundle_discardSiteDraft',
+                publish: 'ThemeBundle_publishSiteDraft',
+                apply: 'ThemeBundle_applySite',
+            })).map(([verb, v]) => [verb, { ...v, args: ['siteId'] }])),
+        },
+    },
+    {
+        name: 'reader',
+        noun: 'page',
+        about: 'what a visitor is served: public pages and the blog, its feeds, as the public API answers',
+        defaultVerb: 'page',
+        verbs: {
+            page: {
+                op: 'Public_page',
+                about: 'A page as readers get it (--locale, --version, --share)',
+                args: ['pageId'],
+            },
+            markdown: {
+                op: 'Public_pageMarkdown',
+                about: 'A page as Markdown (--locale; --form source)',
+                args: ['pageId'],
+            },
+            version: {
+                op: 'Public_pageVersion',
+                about: 'A page in one docs version (--version)',
+                args: ['pageId'],
+            },
+            pdf: { op: 'Public_pagePdf', about: 'A page as PDF', args: ['pageId'], download: 'page.pdf' },
+            'blog index': {
+                op: 'PublicBlog_index',
+                about: 'The blog’s front page (--tag, --author, --series, --month)',
+                columns: ['slug', 'title', 'publishedAt'],
+            },
+            'blog article': { op: 'PublicBlog_article', about: 'One article', args: ['slug'] },
+            'blog markdown': {
+                op: 'PublicBlog_pieceMarkdown',
+                about: 'One article as Markdown (--locale)',
+                args: ['slug'],
+            },
+            'blog search': { op: 'PublicBlog_search', about: 'Search the blog', args: ['q...'] },
+            'blog tags': { op: 'PublicBlog_tags', about: 'Its tags' },
+            'blog archive': { op: 'PublicBlog_archive', about: 'Articles by month' },
+            'blog series': { op: 'PublicBlog_series', about: 'Its series' },
+            'blog permalink': {
+                op: 'PublicBlog_permalink',
+                about: 'What an old or custom path resolves to',
+                args: ['path'],
+            },
+            'blog rss': { op: 'PublicBlog_rss', about: 'The RSS feed (rss.xml)', download: 'rss.xml' },
+            'blog feed': {
+                op: 'PublicBlog_rssAlias',
+                about: 'The RSS feed at its feed.xml address',
+                download: 'feed.xml',
+            },
+            'blog json-feed': {
+                op: 'PublicBlog_jsonFeed',
+                about: 'The JSON Feed',
+                download: 'feed.json',
+            },
+        },
+    },
+    {
+        name: 'github',
+        aliases: ['git'],
+        noun: 'GitHub connection',
+        about: 'a docs space synced with a repository (GitHub, GitLab, Bitbucket)',
+        defaultVerb: 'status',
+        verbs: {
+            status: { op: 'Github_status', about: 'The connection and its last sync' },
+            connect: {
+                op: 'Github_connect',
+                about: 'Connect a repo (--token, --branch, --path, --provider)',
+                args: ['repo'],
+            },
+            import: { op: 'Github_import', about: 'Pull the repository into the space now' },
+            export: { op: 'Github_export', about: 'Push the space to the repository now' },
+            'pull-request': {
+                op: 'Github_pullRequest',
+                about: 'Open a pull request from a change request',
+                args: ['crId'],
+            },
+            'egress-ips': {
+                op: 'Github_egressIps',
+                about: 'The addresses we connect from (for a firewall)',
+            },
+        },
+    },
+];
+//# sourceMappingURL=groups-site.js.map