@quadient/skillshare 1.2.0 → 1.3.0

package/README.md

@@ -156,6 +156,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,9 @@ 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>]
 
 Options:
   --token <token>    Bearer token for API requests (overrides SKILLSHARE_TOKEN)
@@ -108,7 +111,9 @@ async function main() {
         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 +259,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 +780,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 +1153,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) {
@@ -1424,6 +1489,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 +1801,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 +1815,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 +1851,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,6 +1,6 @@
 {
   "name": "@quadient/skillshare",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Skillshare CLI for installing and publishing Quadient skills",
   "type": "module",
   "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"
   }
 }