wiki-plugin-shoppe 0.0.6 → 0.0.8

package/CLAUDE.md

@@ -31,8 +31,14 @@ The first 3 emoji are fixed per wiki instance (`SHOPPE_BASE_EMOJI`, default `
 my-shoppe.zip
   manifest.json           ← required: { uuid, emojicode, name }
   books/
-    My Novel.epub
-    Technical Guide.pdf
+    My Novel/             ← subfolder per book
+      my-novel.epub
+      cover.jpg
+      info.json           ← { "title": "…", "description": "…", "price": 0 }
+    Technical Guide/
+      guide.pdf
+      cover.jpg
+      info.json
   music/
     My Album/             ← album = subfolder
       cover.jpg
@@ -40,8 +46,20 @@ my-shoppe.zip
       02-track.mp3
     Standalone Track.mp3  ← standalone track = file directly in music/
   posts/
-    2025-01-hello-world.md
-    2025-02-another-post.md
+    01-Hello World/       ← numeric prefix determines table of contents order
+      post.md             ← the post content (required)
+      cover.jpg           ← optional cover image
+      screenshot.png      ← any assets referenced in the markdown
+      info.json           ← optional: { "title": "…", "description": "…" }
+    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

@@ -64,13 +64,30 @@
                 <div class="sw-step-body"><strong>Build your shoppe folder</strong> with this structure, then zip the whole thing:
                   <div class="sw-tree">my-shoppe.zip
   manifest.json       ← { "uuid": "…", "emojicode": "…", "name": "My Shoppe" }
-  books/              ← .epub  .pdf  .mobi
+  books/
+    My Novel/         ← subfolder per book
+      my-novel.epub
+      cover.jpg
+      info.json       ← { "title": "…", "description": "…", "price": 0 }
   music/
     My Album/         ← subfolder = album (add cover.jpg inside)
       cover.jpg
       01-track.mp3
     standalone.mp3    ← file directly here = single track
-  posts/              ← .md files
+  posts/
+    01-Hello World/   ← number prefix sets table of contents order
+      post.md         ← the post content
+      cover.jpg       ← optional cover image
+      screenshot.png  ← any assets referenced in the markdown
+      info.json       ← optional: { "title": "…", "description": "…" }
+    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.6",
+  "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');
     }
@@ -266,26 +274,48 @@ async function processArchive(zipPath) {
     const results = { books: [], music: [], posts: [], albums: [], products: [] };
 
     // ---- books/ ----
-    const booksDir = path.join(tmpDir, 'books');
+    // Each book is a subfolder containing the book file, cover.jpg, and info.json
+    const booksDir = path.join(root, 'books');
     if (fs.existsSync(booksDir)) {
-      for (const file of fs.readdirSync(booksDir)) {
-        if (!BOOK_EXTS.has(path.extname(file).toLowerCase())) continue;
-        const title = path.basename(file, path.extname(file));
+      for (const entry of fs.readdirSync(booksDir)) {
+        const entryPath = path.join(booksDir, entry);
+        if (!fs.statSync(entryPath).isDirectory()) continue;
         try {
-          const buf = fs.readFileSync(path.join(booksDir, file));
-          await sanoraCreateProduct(tenant, title, 'book', `Book: ${title}`, 0, 0, 'book');
-          await sanoraUploadArtifact(tenant, title, buf, file, 'ebook');
-          results.books.push({ title });
+          const infoPath = path.join(entryPath, 'info.json');
+          const info = fs.existsSync(infoPath)
+            ? JSON.parse(fs.readFileSync(infoPath, 'utf8'))
+            : {};
+          const title = info.title || entry;
+          const description = info.description || '';
+          const price = info.price || 0;
+
+          await sanoraCreateProduct(tenant, title, 'book', description, price, 0, 'book');
+
+          // Cover image
+          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]);
+          }
+
+          // Book file
+          const bookFiles = fs.readdirSync(entryPath).filter(f => BOOK_EXTS.has(path.extname(f).toLowerCase()));
+          if (bookFiles.length > 0) {
+            const buf = fs.readFileSync(path.join(entryPath, bookFiles[0]));
+            await sanoraUploadArtifact(tenant, title, buf, bookFiles[0], 'ebook');
+          }
+
+          results.books.push({ title, price });
           console.log(`[shoppe]   📚 book: ${title}`);
         } catch (err) {
-          console.warn(`[shoppe]   ⚠️  book ${file}: ${err.message}`);
+          console.warn(`[shoppe]   ⚠️  book ${entry}: ${err.message}`);
         }
       }
     }
 
     // ---- 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);
@@ -328,27 +358,151 @@ async function processArchive(zipPath) {
     }
 
     // ---- posts/ ----
-    const postsDir = path.join(tmpDir, 'posts');
+    // 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(root, 'posts');
     if (fs.existsSync(postsDir)) {
-      for (const file of fs.readdirSync(postsDir)) {
-        if (!file.endsWith('.md')) continue;
-        const title = path.basename(file, '.md');
-        try {
-          const buf = fs.readFileSync(path.join(postsDir, file));
-          const firstLine = buf.toString('utf8').split('\n')[0].replace(/^#+\s*/, '');
-          await sanoraCreateProduct(tenant, title, 'post', firstLine || title, 0, 0, 'post,blog');
-          await sanoraUploadArtifact(tenant, title, buf, file, 'text');
-          results.posts.push({ title });
-          console.log(`[shoppe]   📝 post: ${title}`);
-        } catch (err) {
-          console.warn(`[shoppe]   ⚠️  post ${file}: ${err.message}`);
+      const postFolders = fs.readdirSync(postsDir)
+        .filter(f => fs.statSync(path.join(postsDir, f)).isDirectory())
+        .sort(); // lexicographic sort respects numeric prefixes (01-, 02-, …)
+
+      for (let order = 0; order < postFolders.length; order++) {
+        const entry = postFolders[order];
+        const entryPath = path.join(postsDir, entry);
+        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}`);
+          }
+
+          // 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}`);
+            }
+          }
+
+          results.posts.push({ title: seriesTitle, order, parts: subDirs.length });
+
+        } 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;
+
+            await sanoraCreateProduct(tenant, title, 'post', description, 0, 0, `post,blog,order:${order}`);
+            await sanoraUploadArtifact(tenant, title, mdBuf, mdFiles[0], 'text');
+
+            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 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}`);
+          }
         }
       }
     }
 
     // ---- 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);
@@ -374,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);