@quadient/skillshare 1.4.0 → 1.5.0

package/README.md

@@ -209,3 +209,11 @@ bun run publish:tui -- --otp 123456
 ```
 
 The publish script builds `tui/`, validates the packed files with `npm pack --dry-run`, and only then runs `npm publish`.
+
+## Pages applications
+
+`skillshare pages upload <directory> --slug <slug>` accepts static sites or
+Wrangler JSON/JSONC projects. The CLI bundles Worker dependencies locally; install
+them and build frontend assets before uploading. Inspect process status and logs
+with `skillshare pages runtime <slug>`. Pages are served below `/p/<slug>/`, so use
+that base path when building assets. Runtime data survives content replacement.

package/dist/index.js

@@ -1,3 +1,4 @@
+import { preparePageFiles } from './pages.js';
 import { createServer } from 'node:http';
 import { createHash, randomBytes } from 'node:crypto';
 import { spawn } from 'node:child_process';
@@ -280,15 +281,15 @@ async function main() {
                     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}`);
+                            console.log(`${page.slug}\t${page.kind}\t${page.fileCount}\t${page.ownerDisplayName}`);
                         }
                         return;
                     }
-                    if (action === 'show') {
+                    if (action === 'show' || action === 'runtime') {
                         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));
+                            throw new Error(`pages ${action} requires <slug>`);
+                        console.log(JSON.stringify(await client.get(`/api/pages/${encodeURIComponent(slug)}${action === 'runtime' ? '/runtime' : ''}`), null, 2));
                         return;
                     }
                     if (action === 'upload') {
@@ -311,7 +312,7 @@ async function main() {
                         }
                         return;
                     }
-                    throw new Error(`Unknown pages command '${action}'. Use list, show, or upload.`);
+                    throw new Error(`Unknown pages command '${action}'. Use list, show, runtime, or upload.`);
                 }
             }
             return;
@@ -796,17 +797,14 @@ async function loadLocalSkillContext(directory, baseUrl) {
     };
 }
 async function loadLocalPageFiles(directory) {
-    const filePlans = await collectFilePlans(directory, directory, { includeSkillMetadata: true });
+    const filePlans = await collectFilePlans(directory, directory, { includeSkillMetadata: true, pageProject: 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);
+    const files = await preparePageFiles(directory, await collectFiles(filePlans));
     return {
-        files: await collectFiles(filePlans),
-        totalBytes,
+        files,
+        totalBytes: files.reduce((sum, file) => sum + file.content.length, 0),
     };
 }
 async function createSkillFromDirectory(client, localSkill, input) {
@@ -1881,6 +1879,8 @@ async function collectFilePlans(root, current = root, options = {}) {
     const files = [];
     for (const entry of entries) {
         const entryPath = join(current, entry.name);
+        if (options.pageProject && (entry.isSymbolicLink() || ['.git', '.celld', '.wrangler', 'node_modules'].includes(entry.name)))
+            continue;
         if (entry.isDirectory()) {
             files.push(...(await collectFilePlans(root, entryPath, options)));
             continue;

package/dist/pages.js

@@ -0,0 +1,51 @@
+import { builtinModules } from 'node:module';
+import { build } from 'esbuild';
+import { parse, printParseErrorCode } from 'jsonc-parser';
+import { resolve, relative } from 'node:path';
+export async function preparePageFiles(directory, files) {
+    const configurations = files.filter(file => file.relativePath === 'wrangler.json' || file.relativePath === 'wrangler.jsonc');
+    if (configurations.length > 1)
+        throw new Error('Publish only one of wrangler.json and wrangler.jsonc.');
+    const configFile = configurations[0];
+    if (!configFile) {
+        if (!files.some(file => file.relativePath === 'index.html'))
+            throw new Error('The page directory must contain index.html or a Wrangler configuration at its root.');
+        return files;
+    }
+    const errors = [];
+    const config = parse(configFile.content.toString('utf8'), errors, { allowTrailingComma: true });
+    if (errors.length || !config || typeof config !== 'object' || Array.isArray(config))
+        throw new Error(`Invalid ${configFile.relativePath}: ${errors.map(error => printParseErrorCode(error.error)).join(', ')}`);
+    if (!config.main || config.no_bundle === true)
+        return files;
+    if (typeof config.main !== 'string' || !files.some(file => file.relativePath === config.main.replace(/^\.\//, '')))
+        throw new Error('Wrangler main must name a file inside the uploaded project.');
+    if (files.some(file => file.relativePath.startsWith('__skillshare/')))
+        throw new Error('The __skillshare directory is reserved for the compiled Worker.');
+    const outputDirectory = resolve(directory, '__skillshare');
+    const output = await build({
+        absWorkingDir: directory,
+        entryPoints: [config.main],
+        outdir: outputDirectory,
+        entryNames: 'worker',
+        bundle: true,
+        write: false,
+        format: 'esm',
+        platform: 'browser',
+        target: 'es2024',
+        conditions: ['workerd', 'worker', 'browser'],
+        external: ['cloudflare:*', 'node:*', ...builtinModules],
+        loader: { '.wasm': 'copy' },
+    });
+    config.main = '__skillshare/worker.js';
+    // Native celld still performs its own validation/bundling, including sibling WASM modules.
+    const prepared = files.map(file => file === configFile
+        ? { ...file, content: Buffer.from(JSON.stringify(config, null, 2)) } : file);
+    for (const file of output.outputFiles)
+        prepared.push({
+            relativePath: relative(directory, file.path).replaceAll('\\', '/'),
+            content: Buffer.from(file.contents),
+            contentType: file.path.endsWith('.wasm') ? 'application/wasm' : 'text/javascript; charset=utf-8',
+        });
+    return prepared;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadient/skillshare",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Skillshare CLI for installing and publishing Quadient skills",
   "type": "module",
   "bin": {
@@ -29,6 +29,8 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@clack/prompts": "^1.7.0"
+    "@clack/prompts": "^1.7.0",
+    "esbuild": "0.28.2",
+    "jsonc-parser": "3.3.1"
   }
 }