@a83/orbiter-admin 0.3.13 → 0.3.15

package/src/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+// --port flag → PORT env var
+const portIdx = process.argv.indexOf('--port');
+if (portIdx !== -1 && process.argv[portIdx + 1]) {
+  process.env.PORT = process.argv[portIdx + 1];
+}
+
+// Resolve ORBITER_POD to absolute path (server.js does chdir, so must happen first)
+if (process.env.ORBITER_POD) {
+  process.env.ORBITER_POD = resolve(process.env.ORBITER_POD);
+} else {
+  // Auto-detect a single .pod file in cwd
+  const pods = readdirSync('.').filter(f => f.endsWith('.pod'));
+  if (pods.length === 0) {
+    console.error('Error: No .pod file found in current directory.');
+    console.error('Set ORBITER_POD=/path/to/content.pod or run from the directory containing your .pod file.');
+    process.exit(1);
+  }
+  if (pods.length > 1) {
+    console.error('Multiple .pod files found. Specify one with ORBITER_POD:');
+    pods.forEach(p => console.error('  ORBITER_POD=' + resolve(p)));
+    process.exit(1);
+  }
+  process.env.ORBITER_POD = resolve(pods[0]);
+}
+
+await import('./server.js');

package/src/email.js

@@ -0,0 +1,50 @@
+import nodemailer from 'nodemailer';
+import { openPod } from '@a83/orbiter-core';
+
+/**
+ * Send a notification email if SMTP is configured.
+ * @param {string} podPath
+ * @param {string} event   — 'publish' | 'comment'
+ * @param {object} ctx     — { collection, slug, username, body? }
+ */
+export async function sendNotification(podPath, event, ctx = {}) {
+  let db;
+  try {
+    db = openPod(podPath);
+    const shouldSend = event === 'publish'
+      ? db.getMeta('email.notify_publish') === '1'
+      : db.getMeta('email.notify_comment') === '1';
+    if (!shouldSend) { db.close(); return; }
+
+    const host = db.getMeta('email.smtp_host') ?? '';
+    const port = parseInt(db.getMeta('email.smtp_port') ?? '587', 10);
+    const user = db.getMeta('email.smtp_user') ?? '';
+    const pass = db.getMeta('email.smtp_pass') ?? '';
+    const from = db.getMeta('email.smtp_from') || user;
+    const to   = db.getMeta('email.notify_to') ?? '';
+    const site = db.getMeta('site.name') ?? 'Orbiter';
+    db.close();
+
+    if (!host || !to) return;
+
+    const transport = nodemailer.createTransport({
+      host, port,
+      secure: port === 465,
+      auth: user ? { user, pass } : undefined,
+    });
+
+    let subject, text;
+    if (event === 'publish') {
+      subject = `[${site}] Entry published: ${ctx.collection}/${ctx.slug}`;
+      text    = `${ctx.username ?? 'Someone'} just published "${ctx.slug}" in the "${ctx.collection}" collection.`;
+    } else {
+      subject = `[${site}] New comment on ${ctx.collection}/${ctx.slug}`;
+      text    = `${ctx.username ?? 'Someone'} commented on "${ctx.slug}":\n\n${ctx.body ?? ''}`;
+    }
+
+    await transport.sendMail({ from, to, subject, text });
+  } catch (e) {
+    console.warn('[email]', e.message);
+    db?.close();
+  }
+}

package/src/routes/comments.js

@@ -1,5 +1,6 @@
 import { Hono } from 'hono';
 import { openPod } from '@a83/orbiter-core';
+import { sendNotification } from '../email.js';
 
 export const commentRoutes = new Hono();
 
@@ -25,6 +26,7 @@ commentRoutes.post('/:collectionId/entries/:slug/comments', async (c) => {
   const username = c.get('user')?.username ?? 'unknown';
   const id = db.createComment(entry.id, username, body.trim());
   db.close();
+  sendNotification(c.get('podPath'), 'comment', { collection: collectionId, slug, username, body: body.trim() }).catch(()=>{});
   return c.json({ ok: true, id }, 201);
 });
 

package/src/routes/entries.js

@@ -1,5 +1,6 @@
 import { Hono } from 'hono';
 import { openPod } from '@a83/orbiter-core';
+import { sendNotification } from '../email.js';
 
 export const entryRoutes = new Hono();
 
@@ -108,6 +109,7 @@ entryRoutes.put('/:collectionId/entries/:slug', async (c) => {
 
   if (body.status === 'published' && before?.status !== 'published') {
     fireWebhook(c.get('podPath'));
+    sendNotification(c.get('podPath'), 'publish', { collection: collectionId, slug: body.slug ?? slug, username }).catch(()=>{});
   }
   return c.json(updated);
 });

package/src/routes/locks.js

@@ -0,0 +1,48 @@
+import { Hono } from 'hono';
+import { openPod } from '@a83/orbiter-core';
+
+export const lockRoutes = new Hono();
+
+const STALE_MS = 90_000; // lock expires after 90 s without refresh
+
+function lockKey(collection, slug) {
+  return `lock.${collection}.${slug}`;
+}
+
+function parseLock(val) {
+  if (!val) return null;
+  const [username, ts] = val.split('|');
+  const age = Date.now() - new Date(ts).getTime();
+  if (age > STALE_MS) return null; // stale — treat as free
+  return { username, ts };
+}
+
+// POST /api/locks/:collection/:slug — claim or refresh lock
+lockRoutes.post('/:collection/:slug', (c) => {
+  const { collection, slug } = c.req.param();
+  const username = c.get('user')?.username ?? 'unknown';
+  const db  = openPod(c.get('podPath'));
+  const key = lockKey(collection, slug);
+  const existing = parseLock(db.getMeta(key));
+
+  if (existing && existing.username !== username) {
+    db.close();
+    return c.json({ locked: true, by: existing.username }, 409);
+  }
+
+  db.setMeta(key, `${username}|${new Date().toISOString()}`);
+  db.close();
+  return c.json({ locked: false });
+});
+
+// DELETE /api/locks/:collection/:slug — release lock
+lockRoutes.delete('/:collection/:slug', (c) => {
+  const { collection, slug } = c.req.param();
+  const username = c.get('user')?.username ?? 'unknown';
+  const db  = openPod(c.get('podPath'));
+  const key = lockKey(collection, slug);
+  const existing = parseLock(db.getMeta(key));
+  if (existing && existing.username === username) db.setMeta(key, '');
+  db.close();
+  return c.json({ ok: true });
+});

package/src/routes/meta.js

@@ -15,6 +15,8 @@ const ALLOWED_KEYS = [
   'dashboard.notes', 'dashboard.todos',
   'ui.theme',
   'format_version',
+  'email.smtp_host', 'email.smtp_port', 'email.smtp_user', 'email.smtp_pass',
+  'email.smtp_from', 'email.notify_publish', 'email.notify_comment', 'email.notify_to',
 ];
 
 const PREVIEW_URL_RE = /^preview_url\.[a-z0-9_-]+$/;

package/src/server.js

@@ -23,6 +23,7 @@ import { githubRoutes }     from './routes/github.js';
 import { infoRoutes }       from './routes/info.js';
 import { importRoutes }     from './routes/import.js';
 import { commentRoutes }    from './routes/comments.js';
+import { lockRoutes }       from './routes/locks.js';
 import { requireAuth }      from './middleware/auth.js';
 
 const { version: adminVersion } = JSON.parse(
@@ -74,6 +75,7 @@ export function createApp(podPath) {
   api.route('/import',       importRoutes);
   api.route('/collections',  commentRoutes);
   api.route('/',             commentRoutes);
+  api.route('/locks',        lockRoutes);
 
   app.route('/api', api);