wiki-plugin-shoppe 0.0.7 → 0.0.8

package/CLAUDE.md

@@ -51,8 +51,15 @@ my-shoppe.zip
       cover.jpg           ← optional cover image
       screenshot.png      ← any assets referenced in the markdown
       info.json           ← optional: { "title": "…", "description": "…" }
-    02-Another Post/
-      post.md
+    02-My Series/         ← subdirectories = multi-part series
+      cover.jpg           ← optional series cover
+      intro.md            ← optional series intro
+      info.json           ← optional: { "title": "…", "description": "…" }
+      01-Part One/
+        post.md
+        diagram.png
+      02-Part Two/
+        post.md
   albums/
     Vacation 2025/        ← photo album = subfolder
       photo1.jpg

package/client/shoppe.js

@@ -78,10 +78,16 @@
     01-Hello World/   ← number prefix sets table of contents order
       post.md         ← the post content
       cover.jpg       ← optional cover image
-      screenshot.png  ← any other assets referenced in the markdown
+      screenshot.png  ← any assets referenced in the markdown
       info.json       ← optional: { "title": "…", "description": "…" }
-    02-Another Post/
-      post.md
+    02-My Series/     ← subdirectories = multi-part series
+      cover.jpg       ← optional series cover
+      info.json       ← optional: { "title": "…", "description": "…" }
+      01-Part One/
+        post.md
+        diagram.png
+      02-Part Two/
+        post.md
   albums/
     Vacation 2025/    ← subfolder of images = photo album
       photo1.jpg

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-plugin-shoppe",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Multi-tenant digital goods shoppe for federated wiki, powered by Sanora",
   "keywords": [
     "wiki",

package/server/server.js

@@ -246,8 +246,16 @@ async function processArchive(zipPath) {
   zip.extractAllTo(tmpDir, true);
 
   try {
-    // Read and validate manifest
-    const manifestPath = path.join(tmpDir, 'manifest.json');
+    // Find manifest.json — handle zips that wrap everything in a top-level folder
+    let root = tmpDir;
+    let manifestPath = path.join(tmpDir, 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+      const entries = fs.readdirSync(tmpDir);
+      if (entries.length === 1 && fs.statSync(path.join(tmpDir, entries[0])).isDirectory()) {
+        root = path.join(tmpDir, entries[0]);
+        manifestPath = path.join(root, 'manifest.json');
+      }
+    }
     if (!fs.existsSync(manifestPath)) {
       throw new Error('Archive is missing manifest.json');
     }
@@ -267,7 +275,7 @@ async function processArchive(zipPath) {
 
     // ---- books/ ----
     // Each book is a subfolder containing the book file, cover.jpg, and info.json
-    const booksDir = path.join(tmpDir, 'books');
+    const booksDir = path.join(root, 'books');
     if (fs.existsSync(booksDir)) {
       for (const entry of fs.readdirSync(booksDir)) {
         const entryPath = path.join(booksDir, entry);
@@ -307,7 +315,7 @@ async function processArchive(zipPath) {
 
     // ---- music/ ----
     // Albums are subfolders; standalone files are individual tracks
-    const musicDir = path.join(tmpDir, 'music');
+    const musicDir = path.join(root, 'music');
     if (fs.existsSync(musicDir)) {
       for (const entry of fs.readdirSync(musicDir)) {
         const entryPath = path.join(musicDir, entry);
@@ -353,7 +361,7 @@ async function processArchive(zipPath) {
     // Each post is a numbered subfolder: "01-My Title/" containing post.md,
     // optional assets (images etc.), and optional info.json for metadata overrides.
     // Folders are sorted by their numeric prefix to build the table of contents.
-    const postsDir = path.join(tmpDir, 'posts');
+    const postsDir = path.join(root, 'posts');
     if (fs.existsSync(postsDir)) {
       const postFolders = fs.readdirSync(postsDir)
         .filter(f => fs.statSync(path.join(postsDir, f)).isDirectory())
@@ -362,61 +370,139 @@ async function processArchive(zipPath) {
       for (let order = 0; order < postFolders.length; order++) {
         const entry = postFolders[order];
         const entryPath = path.join(postsDir, entry);
-        try {
-          // Metadata: info.json overrides folder name and md heading
-          const infoPath = path.join(entryPath, 'info.json');
-          const info = fs.existsSync(infoPath)
-            ? JSON.parse(fs.readFileSync(infoPath, 'utf8'))
-            : {};
+        const folderTitle = entry.replace(/^\d+-/, '');
+
+        const infoPath = path.join(entryPath, 'info.json');
+        const info = fs.existsSync(infoPath)
+          ? JSON.parse(fs.readFileSync(infoPath, 'utf8'))
+          : {};
+        const seriesTitle = info.title || folderTitle;
+
+        // Check if this is a multi-part series (has numbered subdirectories)
+        const subDirs = fs.readdirSync(entryPath)
+          .filter(f => fs.statSync(path.join(entryPath, f)).isDirectory())
+          .sort();
+        const mdFiles = fs.readdirSync(entryPath).filter(f => f.endsWith('.md'));
+        const isSeries = subDirs.length > 0;
+
+        if (isSeries) {
+          // Register the series itself as a parent product
+          try {
+            const description = info.description || `A ${subDirs.length}-part series`;
+            await sanoraCreateProduct(tenant, seriesTitle, 'post-series', description, 0, 0, `post,series,order:${order}`);
+
+            const covers = fs.readdirSync(entryPath).filter(f => IMAGE_EXTS.has(path.extname(f).toLowerCase()));
+            if (covers.length > 0) {
+              const coverBuf = fs.readFileSync(path.join(entryPath, covers[0]));
+              await sanoraUploadImage(tenant, seriesTitle, coverBuf, covers[0]);
+            }
+
+            // Optional series-level intro .md
+            if (mdFiles.length > 0) {
+              const mdBuf = fs.readFileSync(path.join(entryPath, mdFiles[0]));
+              await sanoraUploadArtifact(tenant, seriesTitle, mdBuf, mdFiles[0], 'text');
+            }
+
+            console.log(`[shoppe]   📝 series [${order + 1}]: ${seriesTitle} (${subDirs.length} parts)`);
+          } catch (err) {
+            console.warn(`[shoppe]   ⚠️  series ${entry}: ${err.message}`);
+          }
 
-          // Find the .md file
-          const mdFiles = fs.readdirSync(entryPath).filter(f => f.endsWith('.md'));
-          if (mdFiles.length === 0) {
-            console.warn(`[shoppe]   ⚠️  post ${entry}: no .md file found, skipping`);
-            continue;
+          // Register each part
+          for (let partIndex = 0; partIndex < subDirs.length; partIndex++) {
+            const partEntry = subDirs[partIndex];
+            const partPath = path.join(entryPath, partEntry);
+            const partFolderTitle = partEntry.replace(/^\d+-/, '');
+
+            const partInfoPath = path.join(partPath, 'info.json');
+            const partInfo = fs.existsSync(partInfoPath)
+              ? JSON.parse(fs.readFileSync(partInfoPath, 'utf8'))
+              : {};
+            const partTitle = partInfo.title || partFolderTitle;
+            // Sanora product title must be unique — namespace under series
+            const productTitle = `${seriesTitle}: ${partTitle}`;
+
+            try {
+              const partMdFiles = fs.readdirSync(partPath).filter(f => f.endsWith('.md'));
+              if (partMdFiles.length === 0) {
+                console.warn(`[shoppe]   ⚠️  part ${partEntry}: no .md file, skipping`);
+                continue;
+              }
+
+              const mdBuf = fs.readFileSync(path.join(partPath, partMdFiles[0]));
+              const firstHeading = mdBuf.toString('utf8').split('\n')[0].replace(/^#+\s*/, '');
+              const description = partInfo.description || firstHeading || partTitle;
+
+              await sanoraCreateProduct(tenant, productTitle, 'post', description, 0, 0,
+                `post,blog,series:${seriesTitle},part:${partIndex + 1},order:${order}`);
+
+              await sanoraUploadArtifact(tenant, productTitle, mdBuf, partMdFiles[0], 'text');
+
+              const partCovers = fs.readdirSync(partPath).filter(f => IMAGE_EXTS.has(path.extname(f).toLowerCase()));
+              if (partCovers.length > 0) {
+                const coverBuf = fs.readFileSync(path.join(partPath, partCovers[0]));
+                await sanoraUploadImage(tenant, productTitle, coverBuf, partCovers[0]);
+              }
+
+              const partAssets = fs.readdirSync(partPath).filter(f =>
+                !f.endsWith('.md') && f !== 'info.json' && f !== partCovers[0] &&
+                IMAGE_EXTS.has(path.extname(f).toLowerCase())
+              );
+              for (const asset of partAssets) {
+                const buf = fs.readFileSync(path.join(partPath, asset));
+                await sanoraUploadArtifact(tenant, productTitle, buf, asset, 'image');
+              }
+
+              console.log(`[shoppe]     part ${partIndex + 1}: ${partTitle}`);
+            } catch (err) {
+              console.warn(`[shoppe]   ⚠️  part ${partEntry}: ${err.message}`);
+            }
           }
-          const mdBuf = fs.readFileSync(path.join(entryPath, mdFiles[0]));
-          const mdContent = mdBuf.toString('utf8');
 
-          // Derive title: info.json > folder name stripped of numeric prefix
-          const folderTitle = entry.replace(/^\d+-/, '');
-          const firstHeading = mdContent.split('\n')[0].replace(/^#+\s*/, '');
-          const title = info.title || folderTitle;
-          const description = info.description || firstHeading || title;
+          results.posts.push({ title: seriesTitle, order, parts: subDirs.length });
 
-          await sanoraCreateProduct(tenant, title, 'post', description, 0, 0, `post,blog,order:${order}`);
+        } else {
+          // Single post
+          try {
+            if (mdFiles.length === 0) {
+              console.warn(`[shoppe]   ⚠️  post ${entry}: no .md file found, skipping`);
+              continue;
+            }
+            const mdBuf = fs.readFileSync(path.join(entryPath, mdFiles[0]));
+            const firstHeading = mdBuf.toString('utf8').split('\n')[0].replace(/^#+\s*/, '');
+            const title = info.title || folderTitle;
+            const description = info.description || firstHeading || title;
 
-          // Upload the markdown as the main artifact
-          await sanoraUploadArtifact(tenant, title, mdBuf, mdFiles[0], 'text');
+            await sanoraCreateProduct(tenant, title, 'post', description, 0, 0, `post,blog,order:${order}`);
+            await sanoraUploadArtifact(tenant, title, mdBuf, mdFiles[0], 'text');
 
-          // Upload cover image if present
-          const covers = fs.readdirSync(entryPath).filter(f => IMAGE_EXTS.has(path.extname(f).toLowerCase()));
-          if (covers.length > 0) {
-            const coverBuf = fs.readFileSync(path.join(entryPath, covers[0]));
-            await sanoraUploadImage(tenant, title, coverBuf, covers[0]);
-          }
+            const covers = fs.readdirSync(entryPath).filter(f => IMAGE_EXTS.has(path.extname(f).toLowerCase()));
+            if (covers.length > 0) {
+              const coverBuf = fs.readFileSync(path.join(entryPath, covers[0]));
+              await sanoraUploadImage(tenant, title, coverBuf, covers[0]);
+            }
 
-          // Upload remaining assets (images not used as cover)
-          const assets = fs.readdirSync(entryPath).filter(f =>
-            !f.endsWith('.md') && f !== 'info.json' && f !== covers[0] &&
-            IMAGE_EXTS.has(path.extname(f).toLowerCase())
-          );
-          for (const asset of assets) {
-            const buf = fs.readFileSync(path.join(entryPath, asset));
-            await sanoraUploadArtifact(tenant, title, buf, asset, 'image');
-          }
+            const assets = fs.readdirSync(entryPath).filter(f =>
+              !f.endsWith('.md') && f !== 'info.json' && f !== covers[0] &&
+              IMAGE_EXTS.has(path.extname(f).toLowerCase())
+            );
+            for (const asset of assets) {
+              const buf = fs.readFileSync(path.join(entryPath, asset));
+              await sanoraUploadArtifact(tenant, title, buf, asset, 'image');
+            }
 
-          results.posts.push({ title, order });
-          console.log(`[shoppe]   📝 post [${order + 1}]: ${title}`);
-        } catch (err) {
-          console.warn(`[shoppe]   ⚠️  post ${entry}: ${err.message}`);
+            results.posts.push({ title, order });
+            console.log(`[shoppe]   📝 post [${order + 1}]: ${title}`);
+          } catch (err) {
+            console.warn(`[shoppe]   ⚠️  post ${entry}: ${err.message}`);
+          }
         }
       }
     }
 
     // ---- albums/ ----
     // Each subfolder is a photo album
-    const albumsDir = path.join(tmpDir, 'albums');
+    const albumsDir = path.join(root, 'albums');
     if (fs.existsSync(albumsDir)) {
       for (const entry of fs.readdirSync(albumsDir)) {
         const entryPath = path.join(albumsDir, entry);
@@ -442,7 +528,7 @@ async function processArchive(zipPath) {
 
     // ---- products/ ----
     // Each subfolder is a physical product with cover.jpg + info.json
-    const productsDir = path.join(tmpDir, 'products');
+    const productsDir = path.join(root, 'products');
     if (fs.existsSync(productsDir)) {
       for (const entry of fs.readdirSync(productsDir)) {
         const entryPath = path.join(productsDir, entry);