@quadient/skillshare 1.3.0 → 1.4.0

package/README.md

@@ -148,6 +148,17 @@ export SKILLSHARE_TOKEN="<personal-access-token>"
 npx @quadient/skillshare whoami
 ```
 
+Register the production or local SkillShare host as a generic OAuth provider in Git Credential
+Manager 2.0.931 or newer:
+
+```bash
+skillshare git configure
+skillshare git configure local
+```
+
+Remove only the URL-scoped SkillShare registration with `skillshare git unconfigure [local]`.
+The first Git clone opens the browser login; no SkillShare personal access token needs to be created.
+
 Update recorded installs to the latest versions:
 
 ```bash

package/dist/index.js

@@ -81,6 +81,8 @@ Commands:
   pages list
   pages show <slug>
   pages upload <directory> [--slug <slug>]
+  git configure [local]
+  git unconfigure [local]
 
 Options:
   --token <token>    Bearer token for API requests (overrides SKILLSHARE_TOKEN)
@@ -106,6 +108,19 @@ async function main() {
             await logoutSession();
             return;
         }
+        case 'git': {
+            const action = options.positionals[0];
+            const baseUrl = options.positionals[1] === 'local' ? LOCAL_URL : PROD_URL;
+            if (action === 'configure') {
+                await configureGitCredentialManager(baseUrl);
+                return;
+            }
+            if (action === 'unconfigure') {
+                await unconfigureGitCredentialManager(baseUrl);
+                return;
+            }
+            throw new Error('git requires "configure [local]" or "unconfigure [local]".');
+        }
         case 'whoami':
         case 'list':
         case 'show':
@@ -1328,6 +1343,66 @@ async function login(baseUrl) {
     });
     console.log(`Logged in as ${response.user.displayName} (${baseUrl})`);
 }
+const GCM_MINIMUM_VERSION = [2, 0, 931];
+async function configureGitCredentialManager(baseUrl) {
+    baseUrl = normalizeBaseUrl(baseUrl);
+    const versionResult = await runProcess('git', ['credential-manager', '--version'], { allowFailure: true });
+    const version = parseVersion(`${versionResult.stdout} ${versionResult.stderr}`);
+    if (versionResult.exitCode !== 0 || !version || compareVersions(version, GCM_MINIMUM_VERSION) < 0) {
+        throw new Error('Git Credential Manager 2.0.931 or newer is required. Install or update GCM, then run this command again.');
+    }
+    await runProcess('git', ['credential-manager', 'configure']);
+    const prefix = `credential.${baseUrl}`;
+    const settings = [
+        [`${prefix}.provider`, 'generic'],
+        [`${prefix}.oauthClientId`, 'skillshare-gcm'],
+        [`${prefix}.oauthRedirectUri`, 'http://127.0.0.1'],
+        [`${prefix}.oauthAuthorizeEndpoint`, '/api/git/oauth/authorize'],
+        [`${prefix}.oauthTokenEndpoint`, '/api/git/oauth/token'],
+        [`${prefix}.oauthScopes`, 'git.read'],
+        [`${prefix}.oauthDefaultUserName`, 'skillshare'],
+        [`${prefix}.oauthUseClientAuthHeader`, 'false'],
+        [`${prefix}.useHttpPath`, 'false'],
+    ];
+    for (const [key, value] of settings) {
+        await runProcess('git', ['config', '--global', '--replace-all', key, value]);
+    }
+    console.log(`Registered ${baseUrl} in Git Credential Manager ${formatVersion(version)}.`);
+}
+async function unconfigureGitCredentialManager(baseUrl) {
+    baseUrl = normalizeBaseUrl(baseUrl);
+    const prefix = `credential.${baseUrl}`;
+    for (const key of [
+        'provider',
+        'oauthClientId',
+        'oauthRedirectUri',
+        'oauthAuthorizeEndpoint',
+        'oauthTokenEndpoint',
+        'oauthScopes',
+        'oauthDefaultUserName',
+        'oauthUseClientAuthHeader',
+        'useHttpPath',
+    ]) {
+        await runProcess('git', ['config', '--global', '--unset-all', `${prefix}.${key}`], { allowFailure: true });
+    }
+    console.log(`Removed the Git Credential Manager registration for ${baseUrl}.`);
+}
+function parseVersion(value) {
+    const match = value.match(/(?:^|\s)(\d+)\.(\d+)\.(\d+)(?:\D|$)/);
+    return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
+}
+function compareVersions(left, right) {
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const difference = (left[index] ?? 0) - (right[index] ?? 0);
+        if (difference !== 0) {
+            return difference;
+        }
+    }
+    return 0;
+}
+function formatVersion(version) {
+    return version.join('.');
+}
 async function parseOptions(args) {
     const booleanFlags = new Set(['dry-run']);
     const flags = {};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@quadient/skillshare",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Skillshare CLI for installing and publishing Quadient skills",
   "type": "module",
   "bin": {
-    "skillshare": "./bin/skillshare"
+    "skillshare": "bin/skillshare"
   },
   "files": [
     "bin",