@x12i/pocket-videos-server 0.0.0-stage → 1.1.0

package/package.json

@@ -1,6 +1,19 @@
 {
   "name": "@x12i/pocket-videos-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "license": "UNLICENSED",
+  "type": "module",
+  "description": "Development server for Pocket Videos. Serves the client with a content directory overlaid, including Range requests for MP3 and MP4.",
+  "exports": {
+    ".": "./serve.js"
+  },
+  "files": [
+    "serve.js"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@x12i/pocket-videos": "1.1.0"
+  }
+}

package/serve.js

@@ -0,0 +1,91 @@
+// Development server for Pocket Videos.
+//   node serve.js            -> http://localhost:8080
+//   node serve.js 3000       -> http://localhost:3000
+// contentDir may be one directory or a list. Earlier directories win over later
+// ones, and all of them win over the same path in the client package, so a later
+// app (catalog, media, manifest, icons) sits on top of the generic shell.
+// Range requests are supported for seeking. Not for production.
+
+import http from 'node:http';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { clientDir as packagedClientDir } from '@x12i/pocket-videos/client-dir';
+
+const TYPES = {
+  '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8', '.webmanifest': 'application/manifest+json',
+  '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.webp': 'image/webp', '.svg': 'image/svg+xml',
+  '.woff2': 'font/woff2', '.m4a': 'audio/mp4', '.mp3': 'audio/mpeg', '.ogg': 'audio/ogg', '.wav': 'audio/wav',
+  '.mp4': 'video/mp4', '.webm': 'video/webm', '.mov': 'video/quicktime',
+  '.txt': 'text/plain; charset=utf-8',
+};
+
+function inside(root, file) {
+  return file === root || file.startsWith(root + path.sep);
+}
+
+function locate(roots, rel, cb, index = 0) {
+  if (index >= roots.length) { cb(null); return; }
+  const root = roots[index];
+  const file = path.normalize(path.join(root, rel));
+  if (!inside(root, file)) { locate(roots, rel, cb, index + 1); return; }
+  fs.stat(file, (err, stat) => {
+    if (err || !stat.isFile()) locate(roots, rel, cb, index + 1);
+    else cb({ file, stat });
+  });
+}
+
+export function createServer({ clientDir, contentDir } = {}) {
+  if (!clientDir) throw new Error('createServer requires clientDir');
+  const contentDirs = (Array.isArray(contentDir) ? contentDir : [contentDir]).filter(Boolean);
+  const roots = [...contentDirs, clientDir].map((dir) => path.resolve(dir));
+
+  return http.createServer((req, res) => {
+    let rel;
+    try { rel = decodeURIComponent(new URL(req.url, 'http://x').pathname); } catch { res.writeHead(400).end(); return; }
+    if (rel.endsWith('/')) rel += 'index.html';
+    rel = rel.replace(/^\/+/, '');
+    if (!rel || rel.includes('\0')) { res.writeHead(400).end(); return; }
+
+    locate(roots, rel, (found) => {
+      if (!found) { res.writeHead(404, { 'Content-Type': 'text/plain' }).end('Not found'); return; }
+      const { file, stat } = found;
+      const type = TYPES[path.extname(file).toLowerCase()] || 'application/octet-stream';
+      const headers = { 'Content-Type': type, 'Accept-Ranges': 'bytes', 'Cache-Control': 'no-cache' };
+      const range = /^bytes=(\d*)-(\d*)$/.exec(req.headers.range || '');
+      if (range && (range[1] || range[2])) {
+        let start, end;
+        if (range[1] === '') { start = Math.max(0, stat.size - Number(range[2])); end = stat.size - 1; }
+        else { start = Number(range[1]); end = range[2] === '' ? stat.size - 1 : Math.min(Number(range[2]), stat.size - 1); }
+        if (start >= stat.size || start > end) { res.writeHead(416, { 'Content-Range': `bytes */${stat.size}` }).end(); return; }
+        res.writeHead(206, { ...headers, 'Content-Range': `bytes ${start}-${end}/${stat.size}`, 'Content-Length': end - start + 1 });
+        if (req.method === 'HEAD') { res.end(); return; }
+        fs.createReadStream(file, { start, end }).pipe(res);
+        return;
+      }
+      res.writeHead(200, { ...headers, 'Content-Length': stat.size });
+      if (req.method === 'HEAD') { res.end(); return; }
+      fs.createReadStream(file).pipe(res);
+    });
+  });
+}
+
+function defaultContentDir() {
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    path.resolve(here, '../../demo'),
+    path.resolve(process.cwd(), 'demo'),
+  ];
+  for (const dir of candidates) {
+    if (fs.existsSync(path.join(dir, 'catalog.json'))) return dir;
+  }
+  return candidates[0];
+}
+
+const invokedDirectly = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+if (invokedDirectly) {
+  const port = Number(process.argv[2]) || 8080;
+  createServer({ clientDir: packagedClientDir, contentDir: defaultContentDir() })
+    .listen(port, () => console.log(`Pocket Videos running at http://localhost:${port}`));
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.