@quadient/skillshare 1.8.1 → 1.10.0

package/dist/output.js

@@ -0,0 +1,167 @@
+// Human-readable renderers for CLI commands. Every command also supports --json for scripts.
+export function formatTable(headers, rows) {
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => (row[index] ?? '').length)));
+    const line = (cells) => cells
+        .map((cell, index) => (index === cells.length - 1 ? cell : cell.padEnd(widths[index] ?? 0)))
+        .join('  ')
+        .trimEnd();
+    return [line(headers), ...rows.map(line)].join('\n');
+}
+export function formatDateTime(value) {
+    if (!value)
+        return '—';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    const pad = (part) => String(part).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+export function formatByteSize(bytes) {
+    if (!Number.isFinite(bytes) || bytes <= 0) {
+        return '0 B';
+    }
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let value = bytes;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    const decimals = value >= 10 || unitIndex === 0 ? 0 : 1;
+    return `${value.toFixed(decimals)} ${units[unitIndex]}`;
+}
+function fields(entries) {
+    const present = entries.filter((entry) => entry[1] !== null && entry[1] !== undefined && entry[1] !== '');
+    const width = Math.max(...present.map(([label]) => label.length + 1));
+    return present.map(([label, value]) => `${`${label}:`.padEnd(width)}  ${value}`);
+}
+export function plural(count, noun) {
+    return `${count} ${noun}${count === 1 ? '' : 's'}`;
+}
+function fileLines(files) {
+    const width = Math.max(0, ...files.map((file) => file.nameWithPath.length));
+    return files.map((file) => `  ${file.nameWithPath.padEnd(width)}  ${formatByteSize(file.length)}`);
+}
+function limitedList(lines, limit, what) {
+    return lines.length > limit
+        ? [...lines.slice(0, limit), `  … and ${lines.length - limit} more ${what} (use --json for all)`]
+        : lines;
+}
+export function renderUser(user, server) {
+    return [
+        `${user.displayName}${user.email ? ` <${user.email}>` : ''}`,
+        ...fields([
+            ['Server', server],
+            ['Role', user.isAdmin ? 'admin' : 'user'],
+            ['Microsoft account', user.entraObjectId ? 'linked' : 'not linked yet (open Skillshare in the browser once)'],
+        ]),
+    ].join('\n');
+}
+export function renderSkillList(skills) {
+    if (skills.length === 0)
+        return 'No skills in the registry yet.';
+    return formatTable(['ID', 'NAME', 'LATEST', 'UPDATED'], skills.map((skill) => [
+        String(skill.id),
+        `${skill.name}${skill.deprecated ? ' (deprecated)' : ''}`,
+        skill.latestVersion ?? '—',
+        formatDateTime(skill.updated),
+    ]));
+}
+export function renderSkillDetail(skill) {
+    const lines = [
+        `${skill.name} (#${skill.id})${skill.deprecated ? ' — deprecated' : ''}`,
+        skill.description,
+        '',
+        ...fields([
+            ['Owner', skill.ownerDisplayName],
+            ['Latest', skill.latestVersion ?? 'no published version'],
+            ['Updated', skill.updated ? formatDateTime(skill.updated) : undefined],
+            ['Install', `skillshare install ${skill.id}`],
+        ]),
+    ];
+    if (skill.versions.length > 0) {
+        lines.push('', formatTable(['VERSION', 'PUBLISHED', 'BY', 'FILES', 'DOWNLOADS'], skill.versions.map((version) => [
+            `${version.version}${version.isLatest ? ' (latest)' : ''}`,
+            formatDateTime(version.created),
+            version.createdByDisplayName ?? '—',
+            String(version.files.length),
+            version.downloadCount === undefined ? '—' : String(version.downloadCount),
+        ])));
+    }
+    return lines.join('\n');
+}
+export function renderSkillVersion(skillName, version) {
+    const totalBytes = version.files.reduce((sum, file) => sum + file.length, 0);
+    return [
+        `${skillName} ${version.version}${version.isLatest ? ' (latest)' : ''}`,
+        ...fields([
+            ['Published', `${formatDateTime(version.created)}${version.createdByDisplayName ? ` by ${version.createdByDisplayName}` : ''}`],
+            ['Downloads', version.downloadCount],
+        ]),
+        '',
+        `Files (${version.files.length}, ${formatByteSize(totalBytes)}):`,
+        ...limitedList(fileLines(version.files), 50, 'files'),
+    ].join('\n');
+}
+export function renderPageList(pages) {
+    if (pages.length === 0)
+        return 'No pages published yet.';
+    return formatTable(['SLUG', 'KIND', 'FILES', 'SIZE', 'OWNER', 'UPDATED'], pages.map((page) => [
+        page.slug,
+        page.kind === 'celld' ? 'app' : 'static',
+        String(page.fileCount),
+        formatByteSize(page.totalBytes),
+        page.ownerDisplayName,
+        formatDateTime(page.updated),
+    ]));
+}
+export function renderPageDetail(page, baseUrl, now = new Date()) {
+    const month = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, '0')}`;
+    const totalBytes = page.files.reduce((sum, file) => sum + file.length, 0);
+    return [
+        `${page.slug} (${page.kind === 'celld' ? 'application' : 'static site'})`,
+        ...fields([
+            ['URL', pageUrl(baseUrl, page.slug)],
+            ['Owner', page.ownerDisplayName],
+            ['Revision', `${page.contentRevision}, updated ${formatDateTime(page.updated)}`],
+            ['Users this month', page.monthlyUsage.find((usage) => usage.month === month)?.uniqueUsers ?? 0],
+        ]),
+        '',
+        `Files (${page.files.length}, ${formatByteSize(totalBytes)}):`,
+        ...limitedList(fileLines(page.files), 30, 'files'),
+    ].join('\n');
+}
+export function renderPageRuntime(slug, runtime, logLimit = 20) {
+    const lines = [
+        `${slug}: ${runtime.state} · revision ${runtime.revision}${runtime.processId ? ` · pid ${runtime.processId}` : ''}`,
+    ];
+    if (runtime.error)
+        lines.push(`Error: ${runtime.error}`);
+    if (runtime.logs.length > 0) {
+        const shown = runtime.logs.slice(-logLimit);
+        lines.push('', `Last ${shown.length} of ${runtime.logs.length} log lines${runtime.logs.length > shown.length ? ' (use --json for all)' : ''}:`, ...shown);
+    }
+    else {
+        lines.push('No log output yet.');
+    }
+    return lines.join('\n');
+}
+export function renderTeamsStatus(status) {
+    const state = status.requiresReconnect
+        ? 'reconnect required — run skillshare teams login'
+        : status.configured
+            ? `connected${status.identity ? ` as ${status.identity}` : ''}`
+            : 'not connected — run skillshare teams login';
+    return [
+        `Teams: ${state}`,
+        ...fields([
+            ['Access', status.configured ? status.accessMode : undefined],
+            ['Session expires', status.configured && status.expiresAt ? formatDateTime(status.expiresAt) : undefined],
+            ['Updated', status.updatedAt ? formatDateTime(status.updatedAt) : undefined],
+            ['MCP endpoint', status.endpoint],
+        ]),
+    ].join('\n');
+}
+export function pageUrl(baseUrl, slug) {
+    return `${baseUrl.replace(/\/+$/, '')}/p/${encodeURIComponent(slug)}/`;
+}

package/dist/pages.js

@@ -1,7 +1,36 @@
 import { builtinModules } from 'node:module';
 import { build } from 'esbuild';
 import { parse, printParseErrorCode } from 'jsonc-parser';
-import { resolve, relative } from 'node:path';
+import { basename, dirname, resolve, relative } from 'node:path';
+// Build output folders say nothing about the page, so publishing them under their own name is almost always a mistake.
+const GENERIC_DIRECTORY_NAMES = new Set(['dist', 'build', 'out', 'output', 'public', 'www', 'static', 'site', '_site', 'html', 'web', 'export']);
+const SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/;
+export function normalizePageSlug(value) {
+    const normalized = value.trim().toLowerCase();
+    if (!SLUG_PATTERN.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;
+}
+export function resolvePageSlug(directory, explicitSlug) {
+    if (explicitSlug !== undefined)
+        return normalizePageSlug(explicitSlug);
+    const resolvedDirectory = resolve(directory);
+    const name = basename(resolvedDirectory);
+    if (GENERIC_DIRECTORY_NAMES.has(name.toLowerCase().replace(/^\./, ''))) {
+        const suggestion = toSlugCandidate(basename(dirname(resolvedDirectory)));
+        throw new Error(`'${name}' looks like a build output folder, not a page name. Pass --slug, for example --slug ${suggestion && !GENERIC_DIRECTORY_NAMES.has(suggestion) ? suggestion : 'my-page'}.`);
+    }
+    const candidate = toSlugCandidate(name);
+    if (!candidate) {
+        throw new Error(`Cannot derive a page slug from '${name}'. Pass --slug <slug>.`);
+    }
+    return candidate;
+}
+function toSlugCandidate(value) {
+    const candidate = value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 64).replace(/-+$/, '');
+    return SLUG_PATTERN.test(candidate) ? candidate : '';
+}
 export async function preparePageFiles(directory, files) {
     const configurations = files.filter(file => file.relativePath === 'wrangler.json' || file.relativePath === 'wrangler.jsonc');
     if (configurations.length > 1)

package/dist/teams.js

@@ -6,6 +6,7 @@ import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { captureTeamsLogin } from './teams-auth.js';
 import { watchTeamsConnection } from './teams-watch.js';
+import { renderTeamsStatus } from './output.js';
 const root = '/api/mcps/providers/teams';
 const guid = /^[a-f\d]{8}-[a-f\d]{4}-[a-f\d]{4}-[a-f\d]{4}-[a-f\d]{12}$/i;
 /**
@@ -72,9 +73,15 @@ export async function runTeamsCommand(client, args, flags, appDirectory) {
         }
         return;
     }
-    if (action === 'status' || action === 'test') {
-        const result = action === 'test' ? await client.post(`${root}/test`) : await client.get(`${root}/settings`);
-        console.log(JSON.stringify(result, null, 2));
+    const json = flags.json === 'true';
+    if (action === 'status') {
+        const status = await client.get(`${root}/settings`);
+        console.log(json ? JSON.stringify(status, null, 2) : renderTeamsStatus(status));
+        return;
+    }
+    if (action === 'test') {
+        const result = await client.post(`${root}/test`);
+        console.log(json ? JSON.stringify(result, null, 2) : `Teams connection works${result.identity ? ` for ${result.identity}` : ''}.`);
         return;
     }
     if (action === 'logout') {
@@ -107,7 +114,8 @@ export async function runTeamsCommand(client, args, flags, appDirectory) {
                 body: Readable.toWeb(stream), duplex: 'half',
             });
             await expectOk(response);
-            console.log(JSON.stringify(await response.json(), null, 2));
+            const item = await response.json();
+            console.log(json ? JSON.stringify(item, null, 2) : `Uploaded ${item.name ?? basename(path)} to your Teams files.${item.webUrl ? `\n  ${item.webUrl}` : ''}`);
         }
         finally {
             stream.destroy();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadient/skillshare",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "Skillshare CLI for installing and publishing Quadient skills",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "start": "node ./dist/index.js",
     "prepublishOnly": "npm run build",
-    "test": "tsx --test cli-args.test.ts install-files.test.ts pages.test.ts pages-dev.test.ts teams-auth.test.ts teams-watch.test.ts teams-browser.test.ts"
+    "test": "tsx --test cli-args.test.ts install-files.test.ts output.test.ts pages.test.ts pages-dev.test.ts teams-auth.test.ts teams-watch.test.ts teams-browser.test.ts agents.test.ts"
   },
   "publishConfig": {
     "access": "public"