create-aziz-app 3.1.2 → 3.1.3

package/template/_framework/next-response.js

@@ -1,128 +1,128 @@
-// ============================================================
-//  NextResponse — a small, Next.js App Router-compatible response
-//  object used inside api/** route handlers (server-side, Node).
-//
-//    return NextResponse.json({ ok: true });
-//    return NextResponse.json({ error: 'nope' }, { status: 400 });
-//    return NextResponse.redirect('/login');
-//    const res = NextResponse.json({ ok: true });
-//    res.cookies.set('token', 'abc', { httpOnly: true });
-//    return res;
-// ============================================================
-
-class ResponseCookies {
-    constructor(headers) {
-        this.headers = headers;
-    }
-
-    set(name, value, options = {}) {
-        let cookie = `${name}=${encodeURIComponent(value)}`;
-
-        if (options.maxAge != null) cookie += `; Max-Age=${Math.floor(options.maxAge)}`;
-        if (options.expires) cookie += `; Expires=${new Date(options.expires).toUTCString()}`;
-        cookie += `; Path=${options.path || '/'}`;
-        if (options.domain) cookie += `; Domain=${options.domain}`;
-        if (options.httpOnly) cookie += '; HttpOnly';
-        if (options.secure) cookie += '; Secure';
-        if (options.sameSite) cookie += `; SameSite=${options.sameSite}`;
-
-        const existing = this.headers.get('Set-Cookie');
-        if (!existing) this.headers.set('Set-Cookie', [cookie]);
-        else if (Array.isArray(existing)) existing.push(cookie);
-        else this.headers.set('Set-Cookie', [existing, cookie]);
-
-        return this;
-    }
-
-    delete(name, options = {}) {
-        return this.set(name, '', { ...options, maxAge: 0 });
-    }
-
-    get(name) {
-        const existing = this.headers.get('Set-Cookie');
-        const list = Array.isArray(existing) ? existing : existing ? [existing] : [];
-        for (const cookie of list) {
-            if (cookie.startsWith(`${name}=`)) {
-                return { name, value: cookie.slice(name.length + 1).split(';')[0] };
-            }
-        }
-        return undefined;
-    }
-}
-
-class NextResponse {
-    constructor(body = null, init = {}) {
-        this.body = body;
-        this.status = init.status || 200;
-        this.statusText = init.statusText || '';
-        this.headers = new Map();
-
-        const headers = init.headers || {};
-        if (headers instanceof Map) {
-            for (const [k, v] of headers) this.headers.set(k, v);
-        } else if (typeof headers.forEach === 'function' && typeof headers.get === 'function') {
-            headers.forEach((v, k) => this.headers.set(k, v)); // Headers instance
-        } else if (typeof headers === 'object') {
-            for (const k of Object.keys(headers)) this.headers.set(k, headers[k]);
-        }
-
-        this.cookies = new ResponseCookies(this.headers);
-    }
-
-    get ok() {
-        return this.status >= 200 && this.status < 300;
-    }
-
-    static json(data, init = {}) {
-        return new NextResponse(JSON.stringify(data), {
-            ...init,
-            headers: {
-                'Content-Type': 'application/json; charset=utf-8',
-                ...(init.headers || {}),
-            },
-        });
-    }
-
-    static text(text, init = {}) {
-        return new NextResponse(String(text), {
-            ...init,
-            headers: {
-                'Content-Type': 'text/plain; charset=utf-8',
-                ...(init.headers || {}),
-            },
-        });
-    }
-
-    static html(html, init = {}) {
-        return new NextResponse(String(html), {
-            ...init,
-            headers: {
-                'Content-Type': 'text/html; charset=utf-8',
-                ...(init.headers || {}),
-            },
-        });
-    }
-
-    static redirect(url, init = {}) {
-        const destination = typeof url === 'string' ? url : String(url);
-        return new NextResponse(null, {
-            ...init,
-            status: init.status || 307,
-            headers: { 'Location': destination, ...(init.headers || {}) },
-        });
-    }
-
-    static error() {
-        return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
-    }
-
-    async json() {
-        return JSON.parse(this.body ?? 'null');
-    }
-
-    async text() {
-        return this.body == null ? '' : String(this.body);
-    }
-}
-
-module.exports = { NextResponse };
+// ============================================================
+//  NextResponse — a small, Next.js App Router-compatible response
+//  object used inside api/** route handlers (server-side, Node).
+//
+//    return NextResponse.json({ ok: true });
+//    return NextResponse.json({ error: 'nope' }, { status: 400 });
+//    return NextResponse.redirect('/login');
+//    const res = NextResponse.json({ ok: true });
+//    res.cookies.set('token', 'abc', { httpOnly: true });
+//    return res;
+// ============================================================
+
+class ResponseCookies {
+    constructor(headers) {
+        this.headers = headers;
+    }
+
+    set(name, value, options = {}) {
+        let cookie = `${name}=${encodeURIComponent(value)}`;
+
+        if (options.maxAge != null) cookie += `; Max-Age=${Math.floor(options.maxAge)}`;
+        if (options.expires) cookie += `; Expires=${new Date(options.expires).toUTCString()}`;
+        cookie += `; Path=${options.path || '/'}`;
+        if (options.domain) cookie += `; Domain=${options.domain}`;
+        if (options.httpOnly) cookie += '; HttpOnly';
+        if (options.secure) cookie += '; Secure';
+        if (options.sameSite) cookie += `; SameSite=${options.sameSite}`;
+
+        const existing = this.headers.get('Set-Cookie');
+        if (!existing) this.headers.set('Set-Cookie', [cookie]);
+        else if (Array.isArray(existing)) existing.push(cookie);
+        else this.headers.set('Set-Cookie', [existing, cookie]);
+
+        return this;
+    }
+
+    delete(name, options = {}) {
+        return this.set(name, '', { ...options, maxAge: 0 });
+    }
+
+    get(name) {
+        const existing = this.headers.get('Set-Cookie');
+        const list = Array.isArray(existing) ? existing : existing ? [existing] : [];
+        for (const cookie of list) {
+            if (cookie.startsWith(`${name}=`)) {
+                return { name, value: cookie.slice(name.length + 1).split(';')[0] };
+            }
+        }
+        return undefined;
+    }
+}
+
+class NextResponse {
+    constructor(body = null, init = {}) {
+        this.body = body;
+        this.status = init.status || 200;
+        this.statusText = init.statusText || '';
+        this.headers = new Map();
+
+        const headers = init.headers || {};
+        if (headers instanceof Map) {
+            for (const [k, v] of headers) this.headers.set(k, v);
+        } else if (typeof headers.forEach === 'function' && typeof headers.get === 'function') {
+            headers.forEach((v, k) => this.headers.set(k, v)); // Headers instance
+        } else if (typeof headers === 'object') {
+            for (const k of Object.keys(headers)) this.headers.set(k, headers[k]);
+        }
+
+        this.cookies = new ResponseCookies(this.headers);
+    }
+
+    get ok() {
+        return this.status >= 200 && this.status < 300;
+    }
+
+    static json(data, init = {}) {
+        return new NextResponse(JSON.stringify(data), {
+            ...init,
+            headers: {
+                'Content-Type': 'application/json; charset=utf-8',
+                ...(init.headers || {}),
+            },
+        });
+    }
+
+    static text(text, init = {}) {
+        return new NextResponse(String(text), {
+            ...init,
+            headers: {
+                'Content-Type': 'text/plain; charset=utf-8',
+                ...(init.headers || {}),
+            },
+        });
+    }
+
+    static html(html, init = {}) {
+        return new NextResponse(String(html), {
+            ...init,
+            headers: {
+                'Content-Type': 'text/html; charset=utf-8',
+                ...(init.headers || {}),
+            },
+        });
+    }
+
+    static redirect(url, init = {}) {
+        const destination = typeof url === 'string' ? url : String(url);
+        return new NextResponse(null, {
+            ...init,
+            status: init.status || 307,
+            headers: { 'Location': destination, ...(init.headers || {}) },
+        });
+    }
+
+    static error() {
+        return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
+    }
+
+    async json() {
+        return JSON.parse(this.body ?? 'null');
+    }
+
+    async text() {
+        return this.body == null ? '' : String(this.body);
+    }
+}
+
+module.exports = { NextResponse };

package/template/_framework/route-match.js

@@ -1,145 +1,145 @@
-// ============================================================
-//  Aziz.js — Route matching (pure, dependency-free)
-//
-//  Used by the client router. Kept side-effect free so it can
-//  be unit-tested in isolation.
-//
-//  Supported patterns:
-//    /about            → static
-//    /blog/[slug]      → dynamic segment
-//    /files/[...path]  → catch-all (one or more segments)
-// ============================================================
-
-// Strip query/hash, force leading slash, drop trailing slash (except root).
-export function normalizePath(pathname) {
-    if (!pathname) return '/';
-    let p = String(pathname).split('?')[0].split('#')[0];
-    if (!p.startsWith('/')) p = '/' + p;
-    if (p.length > 1 && p.endsWith('/')) p = p.replace(/\/+$/, '');
-    return p || '/';
-}
-
-export function splitPath(pathname) {
-    return normalizePath(pathname).split('/').filter(Boolean);
-}
-
-function isDynamic(part) {
-    return part.startsWith('[') && part.endsWith(']') && !part.startsWith('[...');
-}
-
-function isCatchAll(part) {
-    return part.startsWith('[...') && part.endsWith(']');
-}
-
-// Match a route pattern against a pathname.
-// Returns a params object, or null when there is no match.
-export function matchRoute(pattern, pathname) {
-    const patternParts = splitPath(pattern);
-    const pathParts = splitPath(pathname);
-    const params = {};
-
-    const catchAll = patternParts.findIndex(isCatchAll);
-
-    if (catchAll !== -1) {
-        // Catch-all must be the final segment. It needs at least one
-        // path segment of its own (/blog/[...slug] does not match /blog).
-        if (pathParts.length < patternParts.length) return null;
-
-        for (let i = 0; i < catchAll; i++) {
-            const p = patternParts[i];
-            if (isDynamic(p)) {
-                params[p.slice(1, -1)] = decodeURIComponent(pathParts[i]);
-            } else if (p !== pathParts[i]) {
-                return null;
-            }
-        }
-        params[patternParts[catchAll].slice(4, -1)] = pathParts.slice(catchAll).map(decodeURIComponent);
-        return params;
-    }
-
-    if (patternParts.length !== pathParts.length) return null;
-
-    for (let i = 0; i < patternParts.length; i++) {
-        const p = patternParts[i];
-        if (isDynamic(p)) {
-            params[p.slice(1, -1)] = decodeURIComponent(pathParts[i]);
-        } else if (p !== pathParts[i]) {
-            return null;
-        }
-    }
-
-    return params;
-}
-
-// Specificity score — higher is more specific.
-export function specificity(pattern) {
-    const parts = splitPath(pattern);
-    let statics = 0;
-    let dynamics = 0;
-    let catchAll = 0;
-    for (const p of parts) {
-        if (isCatchAll(p)) catchAll++;
-        else if (isDynamic(p)) dynamics++;
-        else statics++;
-    }
-    return { statics, dynamics, catchAll, depth: parts.length };
-}
-
-export function compareSpecificity(a, b) {
-    if (a.catchAll !== b.catchAll) return a.catchAll - b.catchAll;
-    if (a.statics !== b.statics) return b.statics - a.statics;
-    if (a.dynamics !== b.dynamics) return b.dynamics - a.dynamics;
-    return b.depth - a.depth;
-}
-
-// Resolve the best route for a pathname from a { pattern: value } map.
-// Returns { pattern, params, value } or null.
-export function resolveRoute(routes, pathname) {
-    const normalized = normalizePath(pathname);
-
-    // 1. Exact match wins outright
-    if (Object.prototype.hasOwnProperty.call(routes, normalized)) {
-        return { pattern: normalized, params: {}, value: routes[normalized] };
-    }
-
-    // 2. Dynamic / catch-all patterns, ranked by specificity
-    const candidates = [];
-    for (const pattern of Object.keys(routes)) {
-        if (!pattern.includes('[')) continue;
-        const params = matchRoute(pattern, normalized);
-        if (params !== null) {
-            candidates.push({ pattern, params, value: routes[pattern], score: specificity(pattern) });
-        }
-    }
-
-    if (candidates.length === 0) return null;
-    candidates.sort((a, b) => compareSpecificity(a.score, b.score));
-    const best = candidates[0];
-    return { pattern: best.pattern, params: best.params, value: best.value };
-}
-
-// Does a layout at `pattern` apply to `pathname`?
-// Layouts are prefix-scoped: app/about/layout.js applies to /about and /about/*.
-export function matchesLayout(pattern, pathname) {
-    const patternParts = splitPath(pattern);
-    if (patternParts.length === 0) return true; // root layout
-
-    const pathParts = splitPath(pathname);
-    if (pathParts.length < patternParts.length) return false;
-
-    for (let i = 0; i < patternParts.length; i++) {
-        const p = patternParts[i];
-        if (isCatchAll(p)) return true;
-        if (isDynamic(p)) continue;
-        if (p !== pathParts[i]) return false;
-    }
-
-    return true;
-}
-
-// Collect matching layouts, outermost (root) first.
-export function collectLayouts(layouts, pathname) {
-    return layouts
-        .filter(l => matchesLayout(l.path, pathname))
-        .sort((a, b) => splitPath(a.path).length - splitPath(b.path).length);
-}
+// ============================================================
+//  Aziz.js — Route matching (pure, dependency-free)
+//
+//  Used by the client router. Kept side-effect free so it can
+//  be unit-tested in isolation.
+//
+//  Supported patterns:
+//    /about            → static
+//    /blog/[slug]      → dynamic segment
+//    /files/[...path]  → catch-all (one or more segments)
+// ============================================================
+
+// Strip query/hash, force leading slash, drop trailing slash (except root).
+export function normalizePath(pathname) {
+    if (!pathname) return '/';
+    let p = String(pathname).split('?')[0].split('#')[0];
+    if (!p.startsWith('/')) p = '/' + p;
+    if (p.length > 1 && p.endsWith('/')) p = p.replace(/\/+$/, '');
+    return p || '/';
+}
+
+export function splitPath(pathname) {
+    return normalizePath(pathname).split('/').filter(Boolean);
+}
+
+function isDynamic(part) {
+    return part.startsWith('[') && part.endsWith(']') && !part.startsWith('[...');
+}
+
+function isCatchAll(part) {
+    return part.startsWith('[...') && part.endsWith(']');
+}
+
+// Match a route pattern against a pathname.
+// Returns a params object, or null when there is no match.
+export function matchRoute(pattern, pathname) {
+    const patternParts = splitPath(pattern);
+    const pathParts = splitPath(pathname);
+    const params = {};
+
+    const catchAll = patternParts.findIndex(isCatchAll);
+
+    if (catchAll !== -1) {
+        // Catch-all must be the final segment. It needs at least one
+        // path segment of its own (/blog/[...slug] does not match /blog).
+        if (pathParts.length < patternParts.length) return null;
+
+        for (let i = 0; i < catchAll; i++) {
+            const p = patternParts[i];
+            if (isDynamic(p)) {
+                params[p.slice(1, -1)] = decodeURIComponent(pathParts[i]);
+            } else if (p !== pathParts[i]) {
+                return null;
+            }
+        }
+        params[patternParts[catchAll].slice(4, -1)] = pathParts.slice(catchAll).map(decodeURIComponent);
+        return params;
+    }
+
+    if (patternParts.length !== pathParts.length) return null;
+
+    for (let i = 0; i < patternParts.length; i++) {
+        const p = patternParts[i];
+        if (isDynamic(p)) {
+            params[p.slice(1, -1)] = decodeURIComponent(pathParts[i]);
+        } else if (p !== pathParts[i]) {
+            return null;
+        }
+    }
+
+    return params;
+}
+
+// Specificity score — higher is more specific.
+export function specificity(pattern) {
+    const parts = splitPath(pattern);
+    let statics = 0;
+    let dynamics = 0;
+    let catchAll = 0;
+    for (const p of parts) {
+        if (isCatchAll(p)) catchAll++;
+        else if (isDynamic(p)) dynamics++;
+        else statics++;
+    }
+    return { statics, dynamics, catchAll, depth: parts.length };
+}
+
+export function compareSpecificity(a, b) {
+    if (a.catchAll !== b.catchAll) return a.catchAll - b.catchAll;
+    if (a.statics !== b.statics) return b.statics - a.statics;
+    if (a.dynamics !== b.dynamics) return b.dynamics - a.dynamics;
+    return b.depth - a.depth;
+}
+
+// Resolve the best route for a pathname from a { pattern: value } map.
+// Returns { pattern, params, value } or null.
+export function resolveRoute(routes, pathname) {
+    const normalized = normalizePath(pathname);
+
+    // 1. Exact match wins outright
+    if (Object.prototype.hasOwnProperty.call(routes, normalized)) {
+        return { pattern: normalized, params: {}, value: routes[normalized] };
+    }
+
+    // 2. Dynamic / catch-all patterns, ranked by specificity
+    const candidates = [];
+    for (const pattern of Object.keys(routes)) {
+        if (!pattern.includes('[')) continue;
+        const params = matchRoute(pattern, normalized);
+        if (params !== null) {
+            candidates.push({ pattern, params, value: routes[pattern], score: specificity(pattern) });
+        }
+    }
+
+    if (candidates.length === 0) return null;
+    candidates.sort((a, b) => compareSpecificity(a.score, b.score));
+    const best = candidates[0];
+    return { pattern: best.pattern, params: best.params, value: best.value };
+}
+
+// Does a layout at `pattern` apply to `pathname`?
+// Layouts are prefix-scoped: app/about/layout.js applies to /about and /about/*.
+export function matchesLayout(pattern, pathname) {
+    const patternParts = splitPath(pattern);
+    if (patternParts.length === 0) return true; // root layout
+
+    const pathParts = splitPath(pathname);
+    if (pathParts.length < patternParts.length) return false;
+
+    for (let i = 0; i < patternParts.length; i++) {
+        const p = patternParts[i];
+        if (isCatchAll(p)) return true;
+        if (isDynamic(p)) continue;
+        if (p !== pathParts[i]) return false;
+    }
+
+    return true;
+}
+
+// Collect matching layouts, outermost (root) first.
+export function collectLayouts(layouts, pathname) {
+    return layouts
+        .filter(l => matchesLayout(l.path, pathname))
+        .sort((a, b) => splitPath(a.path).length - splitPath(b.path).length);
+}