statikapi 0.1.0 → 0.1.2

package/README.md

@@ -157,4 +157,4 @@ pnpm -C example/dynamic preview
 
 License
 
-ISC – see LICENSE
+MIT – see LICENSE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statikapi",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/zonayedpca/statikapi",

package/src/build/routeOutPath.js

@@ -4,5 +4,6 @@ import path from 'node:path';
 export function routeToOutPath({ outAbs, route }) {
   // '/' -> index.json, '/users' -> users/index.json, '/blog/archive' -> blog/archive/index.json
   const rel = route === '/' ? 'index.json' : route.slice(1) + '/index.json';
+
   return path.join(outAbs, rel);
 }

package/src/commands/build.js

@@ -1,27 +1,29 @@
-import { readFlags } from '../util/readFlags.js'; // from Task 3
-import { loadConfig } from '../config/loadConfig.js'; // from Task 3
-import { ConfigError } from '../config/validate.js'; // from Task 3
-import { mapRoutes } from '../router/mapRoutes.js'; // from Task 4
-import { loadModuleValue } from '../loader/loadModuleValue.js'; // from Task 5
-import { loadPaths } from '../loader/loadPaths.js';
 import path from 'node:path';
 import fs from 'node:fs/promises';
 import crypto from 'node:crypto';
 
+import { loadConfig } from '../config/loadConfig.js';
+import { ConfigError } from '../config/validate.js';
+import { loadPaths } from '../loader/loadPaths.js';
+import { loadModuleValue } from '../loader/loadModuleValue.js';
+import { mapRoutes } from '../router/mapRoutes.js';
+import { readFlags } from '../util/readFlags.js';
 import { emptyDir, writeFileEnsured } from '../util/fsx.js';
-import { routeToOutPath } from '../build/routeOutPath.js';
 import { formatBytes } from '../util/bytes.js';
+import { routeToOutPath } from '../build/routeOutPath.js';
 
 function toConcrete(routePattern, segTokens, segs) {
   // segTokens: ['users', ':id'] or ['docs','*slug']
   // segs: ['1'] or ['a','b']
   let idx = 0;
+
   const parts = routePattern.split('/').map((p) => {
     if (p.startsWith(':')) return segs[idx++] ?? '';
     if (p.startsWith('*')) return segs.slice(idx).join('/');
     return p;
   });
   const concrete = parts.join('/').replace(/\/+/g, '/');
+
   return concrete;
 }
 
@@ -56,7 +58,6 @@ export default async function buildCmd(argv) {
     // discover routes
     const routes = await mapRoutes({ srcAbs: config.paths.srcAbs });
 
-    // MVP: only handle static routes (dynamic/catch-all in next task)
     const staticRoutes = routes.filter((r) => r.type === 'static');
     const dynRoutes = routes.filter((r) => r.type === 'dynamic');
     const catRoutes = routes.filter((r) => r.type === 'catchall');

package/src/commands/dev.js

@@ -2,13 +2,14 @@ import chokidar from 'chokidar';
 import path from 'node:path';
 import fs from 'node:fs/promises';
 import crypto from 'node:crypto';
-import { readFlags } from '../util/readFlags.js';
+
 import { loadConfig } from '../config/loadConfig.js';
-import { mapRoutes, fileToRoute } from '../router/mapRoutes.js';
-import { routeToOutPath } from '../build/routeOutPath.js';
-import { writeFileEnsured } from '../util/fsx.js';
 import { loadModuleValue } from '../loader/loadModuleValue.js';
 import { loadPaths } from '../loader/loadPaths.js';
+import { mapRoutes, fileToRoute } from '../router/mapRoutes.js';
+import { readFlags } from '../util/readFlags.js';
+import { writeFileEnsured } from '../util/fsx.js';
+import { routeToOutPath } from '../build/routeOutPath.js';
 
 function clearScreen() {
   process.stdout.write('\x1Bc'); // ANSI "clear screen"
@@ -16,25 +17,31 @@ function clearScreen() {
 
 function toConcrete(routePattern, segTokens, segs) {
   let idx = 0;
+
   const parts = routePattern.split('/').map((p) => {
     if (p.startsWith(':')) return segs[idx++] ?? '';
     if (p.startsWith('*')) return segs.slice(idx).join('/');
     return p;
   });
+
   return parts.join('/').replace(/\/+/g, '/');
 }
 
 function toParams(segTokens, concreteRoute) {
   const concreteSegs = concreteRoute.split('/').filter(Boolean);
   const params = {};
+
   for (let i = 0; i < segTokens.length; i++) {
     const tok = segTokens[i];
+
     if (tok.startsWith(':')) params[tok.slice(1)] = concreteSegs[i] ?? '';
     else if (tok.startsWith('*')) {
       params[tok.slice(1)] = concreteSegs.slice(i);
+
       break;
     }
   }
+
   return params;
 }
 
@@ -42,6 +49,7 @@ export default async function devCmd(argv) {
   // In non-TTY (like node --test), behave like the old stub so tests don't hang.
   if (!process.stdout.isTTY) {
     console.log('statikapi dev → starting dev server (stub)');
+
     return 0;
   }
 
@@ -57,6 +65,7 @@ export default async function devCmd(argv) {
     try {
       // Node 18+ has global fetch
       const u = `${notifyOrigin}/_ui/changed?route=${encodeURIComponent(route)}`;
+
       await fetch(u, { method: 'POST' }).catch(() => {});
     } catch {
       // Ignore if preview isn't running
@@ -68,6 +77,7 @@ export default async function devCmd(argv) {
 
   // Manifest state
   const manifestByRoute = new Map(); // route -> entry
+
   const digest = (s) => crypto.createHash('sha1').update(s).digest('hex');
   const relSrc = (abs) => {
     try {
@@ -103,6 +113,7 @@ export default async function devCmd(argv) {
       hash: digest(json),
       revalidate: null,
     };
+
     manifestByRoute.set(route, entry);
   }
   function deleteFromManifest(route) {
@@ -143,6 +154,7 @@ export default async function devCmd(argv) {
       await upsertManifest({ route: concrete, srcFile: r.file, outFile, json });
       written++;
     }
+
     // Delete stale outputs from this file (not present anymore)
     const prev = lastEmitted.get(r.file) || new Set();
     for (const oldRoute of prev) {
@@ -174,11 +186,13 @@ export default async function devCmd(argv) {
     if (!rel) return false;
     if (rel.startsWith('_')) return false;
     const ext = path.extname(rel);
+
     return ext === '.js' || ext === '.mjs' || ext === '.cjs';
   }
 
   async function buildOne(fileAbs, kind) {
     if (!shouldHandle(fileAbs)) return;
+
     const info = fileToRoute({ srcAbs: config.paths.srcAbs, fileAbs });
     clearScreen();
     console.log(`statikapi dev → ${kind}: ${path.relative(process.cwd(), fileAbs)}`);
@@ -186,6 +200,7 @@ export default async function devCmd(argv) {
     if (!info) {
       // File is ignored or no longer maps; delete prior outputs if any
       const prev = lastEmitted.get(fileAbs);
+
       if (prev) {
         for (const route of prev) {
           const p = routeToOutPath({ outAbs: config.paths.outAbs, route });
@@ -199,12 +214,15 @@ export default async function devCmd(argv) {
         }
         lastEmitted.delete(fileAbs);
       }
+
       console.log(`[statikapi] (ignored or unmapped)`);
       await writeManifest();
+
       return;
     }
 
     const r = { file: fileAbs, route: info.route, type: info.type, segments: info.normSegments };
+
     try {
       if (r.type === 'static') {
         const files = await emitStatic(r, { fresh: true });
@@ -223,11 +241,14 @@ export default async function devCmd(argv) {
   // Initial full build
   clearScreen();
   console.log('statikapi dev → initial build…');
+
   const routes = await mapRoutes({ srcAbs: config.paths.srcAbs });
+
   for (const r of routes) {
     if (r.type === 'static') await emitStatic(r);
     else await emitDynamic(r);
   }
+
   await writeManifest();
   console.log(`[statikapi] ready. Watching ${path.relative(process.cwd(), config.paths.srcAbs)}/`);
 
@@ -235,6 +256,7 @@ export default async function devCmd(argv) {
     ignoreInitial: true,
     ignored: (p) => path.basename(p).startsWith('_'),
   });
+
   watcher.on('add', (p) => buildOne(p, 'add'));
   watcher.on('change', (p) => buildOne(p, 'change'));
   watcher.on('unlink', (p) => buildOne(p, 'unlink'));
@@ -245,5 +267,6 @@ export default async function devCmd(argv) {
     process.on('SIGINT', stop);
     process.on('SIGTERM', stop);
   });
+
   return 0;
 }

package/src/commands/init.js

@@ -1,10 +1,5 @@
-export default async function initCmd() {
-  console.log('statikapi init → use `npx create-statikapi <name>` to scaffold a new project.');
+export default async function initCmd(argv) {
+  // Delegate to create-statikapi programmatically
+  const { main } = await import('create-statikapi/src/index.js');
+  return (await main(argv), 0);
 }
-
-// after publishing, replace the above with the below:
-// export default async function initCmd(argv) {
-//   // Delegate to create-statikapi programmatically
-//   const { main } = await import('create-statikapi/src/index.js');
-//   return (await main(argv), 0);
-// }

package/src/commands/preview.js

@@ -4,14 +4,16 @@ import fss from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
 import { URL, fileURLToPath } from 'node:url';
-import { readFlags } from '../util/readFlags.js';
+
 import { loadConfig } from '../config/loadConfig.js';
+import { readFlags } from '../util/readFlags.js';
 import { routeToOutPath } from '../build/routeOutPath.js';
 
 export default async function previewCmd(argv) {
   // Keep old tests green: in non-TTY (node --test), behave like stub and exit.
   if (!process.stdout.isTTY) {
     console.log('statikapi preview → previewing built JSON (stub)');
+
     return 0;
   }
 
@@ -53,7 +55,9 @@ export default async function previewCmd(argv) {
       'Cache-Control': 'no-store',
       ...headers,
     };
+
     res.writeHead(code, h);
+
     if (body && (typeof body === 'string' || Buffer.isBuffer(body))) res.end(body);
     else res.end();
   };
@@ -81,10 +85,12 @@ export default async function previewCmd(argv) {
 
   // --- SSE: subscribers/broadcast ---
   const clients = new Set(); // Set<http.ServerResponse>
+
   function sseSend(res, data) {
     // default "message" event with one data line
     res.write(`data: ${data}\n\n`);
   }
+
   function broadcast(data) {
     for (const res of clients) {
       try {

package/src/config/loadConfig.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
+
 import { DEFAULT_CONFIG } from './defaults.js';
 import { validateAndNormalize, ConfigError } from './validate.js';
 
@@ -42,5 +43,6 @@ function pickFlags(flags) {
   const o = {};
   if (flags.srcDir != null) o.srcDir = String(flags.srcDir);
   if (flags.outDir != null) o.outDir = String(flags.outDir);
+
   return o;
 }

package/src/index.js

@@ -13,11 +13,13 @@ export async function run(argv = process.argv.slice(2)) {
 
   if (!cmd || cmd === '-h' || cmd === '--help') {
     console.log(HELP);
+
     return 0;
   }
 
   if (cmd === '-v' || cmd === '--version') {
     console.log(`statikapi v${version}`);
+
     return 0;
   }
 

package/src/loader/loadModuleValue.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
+
 import { LoaderError } from './errors.js';
 import { assertSerializable } from './serializeGuard.js';
 
@@ -15,6 +16,7 @@ export async function loadModuleValue(fileAbs, args = {}) {
 
   const fileInfo = short(fileAbs);
   let mod;
+
   try {
     const u = new URL(pathToFileURL(fileAbs).href);
     if (fresh) u.search = `v=${Date.now()}-${Math.random()}`;

package/src/loader/loadPaths.js

@@ -1,10 +1,12 @@
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
+
 import { LoaderError } from './errors.js';
 
 export async function loadPaths(fileAbs, { route, type, segments }, { fresh = false } = {}) {
   const fileInfo = short(fileAbs);
   let mod;
+
   try {
     const u = new URL(pathToFileURL(fileAbs).href);
     if (fresh) u.search = `v=${Date.now()}-${Math.random()}`;
@@ -12,9 +14,11 @@ export async function loadPaths(fileAbs, { route, type, segments }, { fresh = fa
   } catch (e) {
     throw new LoaderError(fileInfo, `Failed to import for paths(): ${e.message}`);
   }
+
   if (typeof mod?.paths !== 'function') return null;
 
   let res;
+
   try {
     res = await mod.paths();
   } catch (e) {
@@ -40,12 +44,14 @@ export async function loadPaths(fileAbs, { route, type, segments }, { fresh = fa
           `paths() entry for :${paramName(segments)} must not contain '/'`
         );
     }
+
     return res.map((v) => [v]); // normalize to array-of-segments
   }
 
   if (type === 'catchall') {
     // /docs/*slug → (string | string[])[]
     const out = [];
+
     for (const v of res) {
       if (typeof v === 'string') {
         if (!v)
@@ -80,6 +86,7 @@ export async function loadPaths(fileAbs, { route, type, segments }, { fresh = fa
         throw new LoaderError(fileInfo, `paths() for ${route} must be (string | string[])[]`);
       }
     }
+
     return out;
   }
 
@@ -90,6 +97,7 @@ export async function loadPaths(fileAbs, { route, type, segments }, { fresh = fa
 function paramName(segTokens) {
   // segTokens like ['users', ':id'] or ['docs','*slug']
   const tok = segTokens.find((t) => t.startsWith(':') || t.startsWith('*'));
+
   return tok ? tok.slice(1) : 'param';
 }
 

package/src/loader/serializeGuard.js

@@ -6,8 +6,10 @@ export function assertSerializable(value, atPath = '$', seen = new WeakSet()) {
   const t = typeof value;
 
   if (value === null || t === 'string' || t === 'boolean') return;
+
   if (t === 'number') {
     if (!Number.isFinite(value)) throw new SerializationError('Number must be finite', atPath);
+
     return;
   }
   if (t === 'bigint') throw new SerializationError('BigInt is not JSON-serializable', atPath);
@@ -17,12 +19,14 @@ export function assertSerializable(value, atPath = '$', seen = new WeakSet()) {
   // Objects / Arrays
   if (typeof value === 'object') {
     if (seen.has(value)) throw new SerializationError('Circular structure detected', atPath);
+
     seen.add(value);
 
     if (Array.isArray(value)) {
       for (let i = 0; i < value.length; i++) {
         assertSerializable(value[i], `${atPath}[${i}]`, seen);
       }
+
       return;
     }
 
@@ -30,6 +34,7 @@ export function assertSerializable(value, atPath = '$', seen = new WeakSet()) {
     const tag = Object.prototype.toString.call(value);
     const proto = Object.getPrototypeOf(value);
     const isPlain = tag === PLAIN_TAG && (proto === Object.prototype || proto === null);
+
     if (!isPlain) {
       const name = (value && value.constructor && value.constructor.name) || tag;
       throw new SerializationError(`Only plain objects/arrays allowed (got ${name})`, atPath);
@@ -43,6 +48,7 @@ export function assertSerializable(value, atPath = '$', seen = new WeakSet()) {
     for (const k of Object.keys(value)) {
       assertSerializable(value[k], `${atPath}.${k}`, seen);
     }
+
     return;
   }
 

package/src/router/mapRoutes.js

@@ -29,11 +29,14 @@ export async function mapRoutes({ srcAbs }) {
 async function walk(dir) {
   const out = [];
   const stack = [dir];
+
   while (stack.length) {
     const cur = stack.pop();
     const items = await fs.readdir(cur, { withFileTypes: true });
+
     for (const it of items) {
       const a = path.join(cur, it.name);
+
       if (it.isDirectory()) {
         stack.push(a);
       } else if (it.isFile()) {
@@ -41,6 +44,7 @@ async function walk(dir) {
       }
     }
   }
+
   return out;
 }
 
@@ -59,6 +63,7 @@ export function fileToRoute({ srcAbs, fileAbs }) {
   if (segments.some((s) => s.startsWith('_'))) return null;
 
   const { route, type, normSegments } = toRoute(segments);
+
   return { route, type, normSegments };
 }
 
@@ -107,8 +112,12 @@ function isCatchAll(seg) {
 // 3) fewer segments as a final tiebreaker
 function compareRoutes(a, b) {
   const rank = { static: 0, dynamic: 1, catchall: 2 };
+
   if (rank[a.type] !== rank[b.type]) return rank[a.type] - rank[b.type];
+
   const byRoute = a.route.localeCompare(b.route);
+
   if (byRoute !== 0) return byRoute;
+
   return a.segments.length - b.segments.length;
 }

package/src/util/bytes.js

@@ -1,10 +1,13 @@
 export function formatBytes(n) {
   if (n < 1024) return `${n} B`;
+
   const units = ['KB', 'MB', 'GB'];
   let u = -1;
+
   do {
     n /= 1024;
     u++;
   } while (n >= 1024 && u < units.length - 1);
+
   return `${n.toFixed(n >= 10 ? 0 : 1)} ${units[u]}`;
 }

package/src/util/fsx.js

@@ -4,14 +4,18 @@ import path from 'node:path';
 export async function ensureDir(p) {
   await fs.mkdir(p, { recursive: true });
 }
+
 export async function writeFileEnsured(fileAbs, data) {
   await ensureDir(path.dirname(fileAbs));
   await fs.writeFile(fileAbs, data);
 }
+
 export async function emptyDir(dirAbs) {
   // non-destructive: create if missing, else clean
   await ensureDir(dirAbs);
+
   const entries = await fs.readdir(dirAbs, { withFileTypes: true });
+
   await Promise.all(
     entries.map(async (e) => {
       const p = path.join(dirAbs, e.name);

package/src/util/readFlags.js

@@ -1,5 +1,6 @@
 export function readFlags(argv = []) {
   const out = {};
+
   for (let i = 0; i < argv.length; i++) {
     const t = argv[i];
     if (!t.startsWith('-')) continue;
@@ -17,12 +18,15 @@ export function readFlags(argv = []) {
       }
     }
   }
+
   return out;
 }
 
 function coerce(v) {
   if (v === 'true') return true;
   if (v === 'false') return false;
+
   const n = Number(v);
+
   return Number.isFinite(n) ? n : v;
 }