@quadient/skillshare 1.2.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
@@ -156,6 +167,20 @@ npx @quadient/skillshare update "Prompt Lint" --dry-run
 npx @quadient/skillshare update 12 --target ./installed
 ```
 
+Publish an authenticated static page. The upload replaces the page's complete
+content, and the directory must contain `index.html` at its root. By default the
+directory name is used as the page slug:
+
+```bash
+npx @quadient/skillshare pages upload ./release-notes
+npx @quadient/skillshare pages upload ./site --slug release-notes
+npx @quadient/skillshare pages list
+npx @quadient/skillshare pages show release-notes
+```
+
+The page is then available at
+`https://skillshare.inspireclouduat.net/p/release-notes/` after SSO sign-in.
+
 ## Package Distribution
 
 The CLI is prepared for publishing as `@quadient/skillshare`.

package/dist/index.js

@@ -78,6 +78,11 @@ Commands:
   install <skillId|skillName> [version] --target <directory>
   install --skill-version-id <id> --target <directory>
   update [skillId|skillName] [--target <directory>] [--dry-run]
+  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)
@@ -103,12 +108,27 @@ 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':
         case 'upload':
         case 'install':
-        case 'update': {
+        case 'update':
+        case 'page':
+        case 'pages': {
             const activeBaseUrl = await resolveActiveBaseUrl();
             const client = await createClient(activeBaseUrl, options.token);
             switch (command) {
@@ -254,6 +274,45 @@ async function main() {
                     });
                     return;
                 }
+                case 'page':
+                case 'pages': {
+                    const action = options.positionals[0] ?? 'list';
+                    if (action === 'list') {
+                        const pages = await client.get('/api/pages');
+                        for (const page of pages) {
+                            console.log(`${page.slug}\t${page.fileCount}\t${page.ownerDisplayName}`);
+                        }
+                        return;
+                    }
+                    if (action === 'show') {
+                        const slug = options.positionals[1];
+                        if (!slug)
+                            throw new Error('pages show requires <slug>');
+                        console.log(JSON.stringify(await client.get(`/api/pages/${encodeURIComponent(slug)}`), null, 2));
+                        return;
+                    }
+                    if (action === 'upload') {
+                        const directory = options.positionals[1];
+                        if (!directory)
+                            throw new Error('pages upload requires <directory>');
+                        const resolvedDirectory = resolve(directory);
+                        const slug = normalizePageSlug(options.flags.slug ?? basename(resolvedDirectory));
+                        const pageFiles = await loadLocalPageFiles(resolvedDirectory);
+                        const uploadStatus = spinner({ indicator: 'timer' });
+                        uploadStatus.start(`Uploading ${pageFiles.files.length} files (${formatByteSize(pageFiles.totalBytes)}) to /p/${slug}/`);
+                        try {
+                            const detail = await client.replacePageContent(slug, pageFiles.files);
+                            uploadStatus.stop(`Published /p/${detail.slug}/ with ${detail.files.length} files`);
+                            console.log(JSON.stringify(detail, null, 2));
+                        }
+                        catch (error) {
+                            uploadStatus.clear();
+                            throw error;
+                        }
+                        return;
+                    }
+                    throw new Error(`Unknown pages command '${action}'. Use list, show, or upload.`);
+                }
             }
             return;
         }
@@ -736,6 +795,20 @@ async function loadLocalSkillContext(directory, baseUrl) {
         defaults: deriveSkillDefaults(files, resolvedDirectory),
     };
 }
+async function loadLocalPageFiles(directory) {
+    const filePlans = await collectFilePlans(directory, directory, { includeSkillMetadata: true });
+    if (filePlans.length === 0) {
+        throw new Error('The page directory is empty.');
+    }
+    if (!filePlans.some((file) => file.relativePath === 'index.html')) {
+        throw new Error('The page directory must contain index.html at its root.');
+    }
+    const totalBytes = filePlans.reduce((sum, file) => sum + file.size, 0);
+    return {
+        files: await collectFiles(filePlans),
+        totalBytes,
+    };
+}
 async function createSkillFromDirectory(client, localSkill, input) {
     const name = normalizeText(input.name) ?? localSkill.defaults.name;
     const description = normalizeText(input.description) ?? localSkill.defaults.description;
@@ -1095,6 +1168,13 @@ function normalizeText(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed : null;
 }
+function normalizePageSlug(value) {
+    const normalized = value.trim().toLowerCase();
+    if (!/^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/.test(normalized)) {
+        throw new Error('Page slug must be 1-64 lowercase letters, numbers, or hyphens, and cannot start or end with a hyphen.');
+    }
+    return normalized;
+}
 async function resolveExistingUploadSkill(client, localSkill, options) {
     const explicitSkillId = normalizeText(options?.explicitSkillId);
     if (explicitSkillId) {
@@ -1263,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 = {};
@@ -1424,6 +1564,17 @@ async function createClient(baseUrl, explicitToken) {
             });
             return parseJson(response);
         },
+        async replacePageContent(slug, files) {
+            const formData = new FormData();
+            for (const file of files) {
+                formData.append('files', new Blob([toBlobPart(file.content)], { type: file.contentType }), file.relativePath);
+            }
+            const response = await sendAuthorized(`/api/pages/${encodeURIComponent(slug)}/content`, {
+                method: 'PUT',
+                body: formData,
+            });
+            return parseJson(response);
+        },
     };
 }
 async function buildHeaders(getAccessToken, initialHeaders) {
@@ -1725,13 +1876,13 @@ async function removeLegacyLocalSkillMetadata(directory) {
         throw error;
     }
 }
-async function collectFilePlans(root, current = root) {
+async function collectFilePlans(root, current = root, options = {}) {
     const entries = await readdir(current, { withFileTypes: true });
     const files = [];
     for (const entry of entries) {
         const entryPath = join(current, entry.name);
         if (entry.isDirectory()) {
-            files.push(...(await collectFilePlans(root, entryPath)));
+            files.push(...(await collectFilePlans(root, entryPath, options)));
             continue;
         }
         const entryStat = await stat(entryPath);
@@ -1739,7 +1890,7 @@ async function collectFilePlans(root, current = root) {
             continue;
         }
         const relativePath = relative(root, entryPath).replaceAll('\\', '/');
-        if (relativePath === SKILL_METADATA_FILE_NAME) {
+        if (!options.includeSkillMetadata && relativePath === SKILL_METADATA_FILE_NAME) {
             continue;
         }
         files.push({
@@ -1775,14 +1926,51 @@ function validateSkillDirectory(files) {
     }
 }
 function guessContentType(path) {
-    if (path.endsWith('.md'))
+    const normalized = path.toLowerCase();
+    if (normalized.endsWith('.html') || normalized.endsWith('.htm'))
+        return 'text/html; charset=utf-8';
+    if (normalized.endsWith('.css'))
+        return 'text/css; charset=utf-8';
+    if (normalized.endsWith('.js') || normalized.endsWith('.mjs'))
+        return 'text/javascript; charset=utf-8';
+    if (normalized.endsWith('.md'))
         return 'text/markdown; charset=utf-8';
-    if (path.endsWith('.json'))
+    if (normalized.endsWith('.json') || normalized.endsWith('.webmanifest'))
         return 'application/json; charset=utf-8';
-    if (path.endsWith('.yaml') || path.endsWith('.yml'))
+    if (normalized.endsWith('.yaml') || normalized.endsWith('.yml'))
         return 'application/yaml; charset=utf-8';
-    if (path.endsWith('.txt'))
+    if (normalized.endsWith('.txt') || normalized.endsWith('.csv'))
         return 'text/plain; charset=utf-8';
+    if (normalized.endsWith('.svg'))
+        return 'image/svg+xml';
+    if (normalized.endsWith('.png'))
+        return 'image/png';
+    if (normalized.endsWith('.jpg') || normalized.endsWith('.jpeg'))
+        return 'image/jpeg';
+    if (normalized.endsWith('.webp'))
+        return 'image/webp';
+    if (normalized.endsWith('.gif'))
+        return 'image/gif';
+    if (normalized.endsWith('.avif'))
+        return 'image/avif';
+    if (normalized.endsWith('.ico'))
+        return 'image/x-icon';
+    if (normalized.endsWith('.mp4'))
+        return 'video/mp4';
+    if (normalized.endsWith('.webm'))
+        return 'video/webm';
+    if (normalized.endsWith('.mp3'))
+        return 'audio/mpeg';
+    if (normalized.endsWith('.wav'))
+        return 'audio/wav';
+    if (normalized.endsWith('.pdf'))
+        return 'application/pdf';
+    if (normalized.endsWith('.wasm'))
+        return 'application/wasm';
+    if (normalized.endsWith('.woff'))
+        return 'font/woff';
+    if (normalized.endsWith('.woff2'))
+        return 'font/woff2';
     return 'application/octet-stream';
 }
 function formatByteSize(bytes) {

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@quadient/skillshare",
-  "version": "1.2.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",
@@ -21,14 +21,14 @@
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "^24.6.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.3"
+    "@types/node": "^26.1.1",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2"
   },
   "engines": {
     "node": ">=20"
   },
   "dependencies": {
-    "@clack/prompts": "^1.2.0"
+    "@clack/prompts": "^1.7.0"
   }
 }