@seolful/nextjs-connector 1.0.0

package/bin/seolful-next.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { init } from '../dist/cli/init.js'
+
+init()

package/dist/api.d.ts

@@ -0,0 +1,4 @@
+import { NextRequest } from 'next/server';
+export declare function GET(request: NextRequest): Promise<Response>;
+export declare function POST(request: NextRequest): Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAyBzC,wBAAsB,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CASjE;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAelE"}

package/dist/api.js

@@ -0,0 +1,43 @@
+import { validateToken } from './middleware/validate-token.js';
+import { auditDataHandler } from './handlers/audit-data.js';
+import { crawlHandler } from './handlers/crawl.js';
+import { updateSeoHandler } from './handlers/update-seo.js';
+import { aiVisibilityHandler } from './handlers/update-ai-visibility.js';
+import { demoteH1Handler } from './handlers/demote-h1.js';
+function resolvePath(request) {
+    const url = new URL(request.url);
+    const match = url.pathname.match(/\/api\/seolful\/v1\/(.+)/);
+    return match?.[1] ?? '';
+}
+async function withAuth(request, handler) {
+    const result = await validateToken(request.headers);
+    if (!result.valid) {
+        return Response.json({ error: result.error }, { status: result.status });
+    }
+    return handler(request);
+}
+export async function GET(request) {
+    const path = resolvePath(request);
+    switch (path) {
+        case 'audit-data':
+            return withAuth(request, auditDataHandler);
+        default:
+            return Response.json({ error: 'Not found' }, { status: 404 });
+    }
+}
+export async function POST(request) {
+    const path = resolvePath(request);
+    switch (path) {
+        case 'crawl':
+            return withAuth(request, crawlHandler);
+        case 'update-seo':
+            return withAuth(request, updateSeoHandler);
+        case 'update-ai-visibility':
+            return withAuth(request, aiVisibilityHandler);
+        case 'demote-h1':
+            return withAuth(request, demoteH1Handler);
+        default:
+            return Response.json({ error: 'Not found' }, { status: 404 });
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,SAAS,WAAW,CAAC,OAAoB;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC5D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACzB,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,OAAoB,EACpB,OAAgD;IAEhD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAoB;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IAEjC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;QAC5C;YACE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAoB;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IAEjC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;QACxC,KAAK,YAAY;YACf,OAAO,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;QAC5C,KAAK,sBAAsB;YACzB,OAAO,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;QAC/C,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;QAC3C;YACE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACjE,CAAC;AACH,CAAC"}

package/dist/cli/handshake.d.ts

@@ -0,0 +1,17 @@
+export interface HandshakePayload {
+    clientId: string;
+    token: string;
+    siteUrl: string;
+    siteName: string;
+    connectionKey: string;
+    connectorVersion: string;
+}
+export interface HandshakeResult {
+    status: string;
+    siteId: number;
+    siteUuid: string;
+    publishEndpoint: string;
+    newConnectionKey?: string;
+}
+export declare function performHandshake(appUrl: string, payload: HandshakePayload): Promise<HandshakeResult>;
+//# sourceMappingURL=handshake.d.ts.map

package/dist/cli/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/cli/handshake.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAgC1B"}

package/dist/cli/handshake.js

@@ -0,0 +1,30 @@
+export async function performHandshake(appUrl, payload) {
+    const endpoint = `${appUrl}/api/plugin/handshake`;
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            client_id: payload.clientId,
+            token: payload.token,
+            site_url: payload.siteUrl,
+            site_name: payload.siteName,
+            platform: 'nextjs',
+            connection_key: payload.connectionKey,
+            connector_version: payload.connectorVersion,
+        }),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => '');
+        throw new Error(`Handshake failed: HTTP ${response.status} — ${body.slice(0, 200)}`);
+    }
+    const data = (await response.json());
+    return {
+        status: data.status,
+        siteId: data.site_id,
+        siteUuid: data.site_uuid,
+        publishEndpoint: data.publish_endpoint,
+        newConnectionKey: data.new_connection_key ?? undefined,
+    };
+}
+//# sourceMappingURL=handshake.js.map

package/dist/cli/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/cli/handshake.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,OAAyB;IAEzB,MAAM,QAAQ,GAAG,GAAG,MAAM,uBAAuB,CAAA;IAEjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QACrC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,SAAS,EAAE,OAAO,CAAC,QAAQ;YAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,SAAS,EAAE,OAAO,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ;YAClB,cAAc,EAAE,OAAO,CAAC,aAAa;YACrC,iBAAiB,EAAE,OAAO,CAAC,gBAAgB;SAC5C,CAAC;QACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAA;IAE/D,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAgB;QAC7B,MAAM,EAAE,IAAI,CAAC,OAAiB;QAC9B,QAAQ,EAAE,IAAI,CAAC,SAAmB;QAClC,eAAe,EAAE,IAAI,CAAC,gBAA0B;QAChD,gBAAgB,EAAG,IAAI,CAAC,kBAAyC,IAAI,SAAS;KAC/E,CAAA;AACH,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,2 @@
+export declare function init(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AA2DA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA4I1C"}

package/dist/cli/init.js

@@ -0,0 +1,173 @@
+import { createInterface } from 'node:readline/promises';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import bcrypt from 'bcryptjs';
+import { performHandshake } from './handshake.js';
+import { writeEnvLocal, updateGitignore, scaffoldApiRoute, injectIntoLayout } from './scaffold.js';
+function randomString(length) {
+    return randomBytes(Math.ceil(length / 2))
+        .toString('hex')
+        .slice(0, length);
+}
+function decodeConnectionKey(key) {
+    try {
+        const padded = key.replace(/-/g, '+').replace(/_/g, '/');
+        const json = Buffer.from(padded, 'base64').toString('utf8');
+        const decoded = JSON.parse(json);
+        if (!decoded.url)
+            return null;
+        return { url: decoded.url.replace(/\/$/, ''), tok: decoded.tok ?? '' };
+    }
+    catch {
+        return null;
+    }
+}
+function isNextJsProject(cwd) {
+    const pkgPath = join(cwd, 'package.json');
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return Boolean(pkg.dependencies?.next || pkg.devDependencies?.next);
+    }
+    catch {
+        return false;
+    }
+}
+function getPackageVersion() {
+    try {
+        const pkgPath = new URL('../../package.json', import.meta.url);
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return pkg.version ?? '1.0.0';
+    }
+    catch {
+        return '1.0.0';
+    }
+}
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        if (args[i].startsWith('--')) {
+            const [key, ...rest] = args[i].replace(/^--/, '').split('=');
+            result[key] = rest.length ? rest.join('=') : (args[++i] ?? '');
+        }
+    }
+    return result;
+}
+export async function init() {
+    const cwd = process.cwd();
+    console.log('\n  Seolful Next.js Connector Setup\n');
+    if (!isNextJsProject(cwd)) {
+        console.error('  ✖ No Next.js project found in the current directory.');
+        console.error('  Run this command from the root of your Next.js app.\n');
+        process.exit(1);
+    }
+    const flags = parseArgs();
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        // Step 1: Get connection key
+        const connectionKey = flags['key'] ?? (await rl.question('  Connection key (from Seolful dashboard): '));
+        if (!connectionKey.trim()) {
+            console.error('\n  ✖ A connection key is required.\n');
+            process.exit(1);
+        }
+        const decoded = decodeConnectionKey(connectionKey.trim());
+        if (!decoded) {
+            console.error('\n  ✖ Invalid connection key. Copy a fresh one from your Seolful dashboard.\n');
+            process.exit(1);
+        }
+        // Step 2: Get site URL
+        const defaultUrl = process.env.NEXT_PUBLIC_SITE_URL ?? process.env.SEOLFUL_SITE_URL ?? 'http://localhost:3000';
+        const siteUrl = (flags['site-url'] ??
+            ((await rl.question(`  Site URL [${defaultUrl}]: `)) || defaultUrl)).replace(/\/$/, '');
+        // Step 3: Get site name
+        let defaultName = 'My Next.js Site';
+        try {
+            const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
+            if (pkg.name)
+                defaultName = pkg.name;
+        }
+        catch {
+            // ignore
+        }
+        const siteName = flags['site-name'] ?? ((await rl.question(`  Site name [${defaultName}]: `)) || defaultName);
+        rl.close();
+        console.log();
+        console.log(`  Seolful app:  ${decoded.url}`);
+        console.log(`  Site URL:     ${siteUrl}`);
+        console.log(`  Site name:    ${siteName}`);
+        console.log();
+        // Step 4: Generate credentials
+        const clientId = randomString(12);
+        const token = randomString(40);
+        // Step 5: Handshake
+        process.stdout.write('  Connecting to Seolful... ');
+        const result = await performHandshake(decoded.url, {
+            clientId,
+            token,
+            siteUrl,
+            siteName,
+            connectionKey: connectionKey.trim(),
+            connectorVersion: getPackageVersion(),
+        });
+        console.log('✔ Connected');
+        // Step 6: Store credentials
+        const storageDir = join(cwd, '.seolful');
+        if (!existsSync(storageDir))
+            mkdirSync(storageDir, { recursive: true });
+        const tokenHash = await bcrypt.hash(token, 10);
+        writeFileSync(join(storageDir, 'connection.json'), JSON.stringify({
+            clientId,
+            tokenHash,
+            siteUrl,
+            connectedAt: new Date().toISOString(),
+        }, null, 2));
+        const configData = {
+            appUrl: decoded.url,
+            siteUrl,
+            siteName,
+        };
+        if (result.newConnectionKey) {
+            configData.connectionKey = result.newConnectionKey;
+        }
+        writeFileSync(join(storageDir, 'config.json'), JSON.stringify(configData, null, 2));
+        // Step 7: Write .env.local
+        writeEnvLocal(cwd, 'SEOLFUL_CLIENT_ID', clientId);
+        writeEnvLocal(cwd, 'SEOLFUL_TOKEN', token);
+        writeEnvLocal(cwd, 'SEOLFUL_APP_URL', decoded.url);
+        writeEnvLocal(cwd, 'SEOLFUL_SITE_URL', siteUrl);
+        // Step 8: Scaffold API route
+        const routePath = scaffoldApiRoute(cwd);
+        // Step 9: Inject SEO into root layout
+        const layoutModified = injectIntoLayout(cwd);
+        // Step 10: Update .gitignore
+        updateGitignore(cwd);
+        // Step 11: Success
+        console.log();
+        console.log('  ✔ .env.local updated');
+        console.log('  ✔ .seolful/ created');
+        console.log(`  ✔ ${routePath}`);
+        if (layoutModified) {
+            console.log(`  ✔ ${layoutModified} — auto-injection enabled`);
+        }
+        console.log('  ✔ .gitignore updated');
+        console.log();
+        if (!layoutModified) {
+            console.log('  Note: Could not auto-modify your root layout.');
+            console.log('  Add this to your layout.tsx generateMetadata:');
+            console.log('    import { withSeolfulMetadata } from \'@seolful/next\'');
+            console.log();
+        }
+        console.log('  Seolful is ready — start your dev server and trigger a sync from the dashboard.');
+        console.log();
+    }
+    catch (error) {
+        rl.close();
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`\n  ✖ ${message}\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/scaffold.d.ts

@@ -0,0 +1,6 @@
+export declare function writeEnvLocal(cwd: string, key: string, value: string): void;
+export declare function updateGitignore(cwd: string): void;
+export declare function scaffoldApiRoute(cwd: string): string;
+export declare function putFile(filePath: string, content: string): void;
+export declare function injectIntoLayout(cwd: string): string | null;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/cli/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAU3E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQjD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBpD;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0E3D"}

package/dist/cli/scaffold.js

@@ -0,0 +1,101 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+export function writeEnvLocal(cwd, key, value) {
+    const envPath = join(cwd, '.env.local');
+    let contents = existsSync(envPath) ? readFileSync(envPath, 'utf8') : '';
+    const pattern = new RegExp(`^${key}=.*`, 'm');
+    if (pattern.test(contents)) {
+        contents = contents.replace(pattern, `${key}=${value}`);
+    }
+    else {
+        contents += (contents.endsWith('\n') || contents === '' ? '' : '\n') + `${key}=${value}\n`;
+    }
+    writeFileSync(envPath, contents);
+}
+export function updateGitignore(cwd) {
+    const gitignorePath = join(cwd, '.gitignore');
+    let contents = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf8') : '';
+    if (!contents.includes('.seolful/')) {
+        contents += (contents.endsWith('\n') || contents === '' ? '' : '\n') + '\n# Seolful connector data\n.seolful/\n';
+        writeFileSync(gitignorePath, contents);
+    }
+}
+export function scaffoldApiRoute(cwd) {
+    const routeContent = `export { GET, POST } from '@seolful/next/api'
+`;
+    // Detect src/ directory usage
+    const useSrc = existsSync(join(cwd, 'src', 'app'));
+    const appDir = useSrc ? join(cwd, 'src', 'app') : join(cwd, 'app');
+    const routeDir = join(appDir, 'api', 'seolful', 'v1', '[...path]');
+    const routePath = join(routeDir, 'route.ts');
+    if (!existsSync(routeDir)) {
+        mkdirSync(routeDir, { recursive: true });
+    }
+    writeFileSync(routePath, routeContent);
+    const relative = useSrc ? 'src/app/api/seolful/v1/[...path]/route.ts' : 'app/api/seolful/v1/[...path]/route.ts';
+    return relative;
+}
+export function putFile(filePath, content) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(filePath, content);
+}
+export function injectIntoLayout(cwd) {
+    const useSrc = existsSync(join(cwd, 'src', 'app'));
+    const appDir = useSrc ? join(cwd, 'src', 'app') : join(cwd, 'app');
+    // Find the root layout file
+    let layoutPath = null;
+    for (const ext of ['tsx', 'ts', 'jsx', 'js']) {
+        const candidate = join(appDir, `layout.${ext}`);
+        if (existsSync(candidate)) {
+            layoutPath = candidate;
+            break;
+        }
+    }
+    if (!layoutPath)
+        return null;
+    let content = readFileSync(layoutPath, 'utf8');
+    // Already injected
+    if (content.includes('@seolful/next') || content.includes('withSeolfulMetadata')) {
+        return null;
+    }
+    // Pattern: `export const metadata: Metadata = { ... };`
+    // Convert to generateMetadata that wraps the static object with Seolful overrides
+    const staticMetadataMatch = content.match(/export\s+const\s+metadata\s*(?::\s*Metadata\s*)?=\s*(\{[\s\S]*?\n\};?)/m);
+    if (staticMetadataMatch) {
+        const metadataObject = staticMetadataMatch[1].replace(/;$/, '');
+        const fullMatch = staticMetadataMatch[0];
+        // Add the import
+        const seolfulImport = `import { withSeolfulMetadata } from '@seolful/next'\n`;
+        // Check if there's already an import from 'next' for Metadata type
+        if (content.includes("import type { Metadata }")) {
+            content = content.replace(/import type \{ Metadata \}[^\n]*\n/, (match) => match + seolfulImport);
+        }
+        else if (content.includes("from 'next'") || content.includes('from "next"')) {
+            // Add after the existing next import
+            content = content.replace(/(from ['"]next['"][^\n]*\n)/, (match) => match + seolfulImport);
+        }
+        else {
+            // Add at the top
+            content = seolfulImport + content;
+        }
+        // Replace static metadata with generateMetadata function
+        const replacement = `const baseMetadata = ${metadataObject}
+
+export async function generateMetadata({ params }: { params: Promise<Record<string, string>> }) {
+  return withSeolfulMetadata('/', baseMetadata)
+}`;
+        content = content.replace(fullMatch, replacement);
+        writeFileSync(layoutPath, content);
+        const relative = useSrc ? 'src/app/layout.tsx' : 'app/layout.tsx';
+        return relative;
+    }
+    // Pattern: already has generateMetadata — wrap the return value
+    if (content.includes('generateMetadata')) {
+        // Too complex to auto-modify — skip
+        return null;
+    }
+    return null;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/cli/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import type { SeolfulConfig } from './types.js';
+export declare function getStorageDir(): string;
+export declare function getConfig(): SeolfulConfig;
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,SAAS,IAAI,aAAa,CA+BzC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/config.js

@@ -0,0 +1,44 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+let cached = null;
+export function getStorageDir() {
+    if (process.env.SEOLFUL_STORAGE_DIR)
+        return process.env.SEOLFUL_STORAGE_DIR;
+    if (process.env.VERCEL === '1')
+        return '/tmp/.seolful';
+    return join(process.cwd(), '.seolful');
+}
+export function getConfig() {
+    if (cached)
+        return cached;
+    const storageDir = getStorageDir();
+    const configPath = join(storageDir, 'config.json');
+    let fileConfig = {};
+    if (existsSync(configPath)) {
+        try {
+            fileConfig = JSON.parse(readFileSync(configPath, 'utf8'));
+        }
+        catch {
+            // Ignore malformed config
+        }
+    }
+    cached = {
+        appUrl: process.env.SEOLFUL_APP_URL ?? fileConfig.appUrl ?? '',
+        siteUrl: process.env.SEOLFUL_SITE_URL ?? fileConfig.siteUrl ?? '',
+        siteName: process.env.SEOLFUL_SITE_NAME ?? fileConfig.siteName ?? '',
+        connectionKey: process.env.SEOLFUL_CONNECTION_KEY ?? fileConfig.connectionKey,
+        storageDir,
+        crawl: {
+            urls: fileConfig.crawl?.urls ?? [],
+            sitemapUrl: process.env.SEOLFUL_SITEMAP_URL ?? fileConfig.crawl?.sitemapUrl,
+            useSitemap: fileConfig.crawl?.useSitemap ?? true,
+            delayMs: Number(process.env.SEOLFUL_CRAWL_DELAY_MS ?? fileConfig.crawl?.delayMs ?? 300),
+            timeout: Number(process.env.SEOLFUL_CRAWL_TIMEOUT ?? fileConfig.crawl?.timeout ?? 10),
+        },
+    };
+    return cached;
+}
+export function clearConfigCache() {
+    cached = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,IAAI,MAAM,GAAyB,IAAI,CAAA;AAEvC,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAA;IAC3E,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,eAAe,CAAA;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAA;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAElD,IAAI,UAAU,GAA2B,EAAE,CAAA;IAC3C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,GAAG;QACP,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC,MAAM,IAAI,EAAE;QAC9D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,CAAC,OAAO,IAAI,EAAE;QACjE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,UAAU,CAAC,QAAQ,IAAI,EAAE;QACpE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,UAAU,CAAC,aAAa;QAC7E,UAAU;QACV,KAAK,EAAE;YACL,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE;YAClC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,UAAU,CAAC,KAAK,EAAE,UAAU;YAC3E,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,IAAI,IAAI;YAChD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,UAAU,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC;YACvF,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,UAAU,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;SACtF;KACF,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,IAAI,CAAA;AACf,CAAC"}

package/dist/crawler/analyze.d.ts

@@ -0,0 +1,18 @@
+import type { ImageAlt } from '../types.js';
+export interface PageAnalysis {
+    url: string;
+    slug: string;
+    title: string | null;
+    metaDescription: string | null;
+    h1: string | null;
+    h1Count: number;
+    h1Secondary: string | null;
+    wordCount: number;
+    imageAlts: ImageAlt[];
+    internalLinkCount: number;
+    structuredData: object[];
+    noindex: boolean;
+    canonicalUrl: string | null;
+}
+export declare function analyzePage(url: string, html: string): PageAnalysis;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/crawler/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/crawler/analyze.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAqBnE"}

package/dist/crawler/analyze.js

@@ -0,0 +1,114 @@
+import { parse } from 'node-html-parser';
+export function analyzePage(url, html) {
+    const root = parse(html);
+    const h1s = extractAllH1s(root);
+    const pathname = safePathname(url);
+    return {
+        url,
+        slug: pathname,
+        title: extractTitle(root),
+        metaDescription: extractMetaDescription(root),
+        h1: h1s[0] ?? null,
+        h1Count: h1s.length,
+        h1Secondary: h1s[1] ?? null,
+        wordCount: countWords(root),
+        imageAlts: extractImageAlts(root),
+        internalLinkCount: countInternalLinks(root, url),
+        structuredData: extractStructuredData(root),
+        noindex: detectNoindex(root),
+        canonicalUrl: extractCanonical(root),
+    };
+}
+function safePathname(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return '/';
+    }
+}
+function extractTitle(root) {
+    const title = root.querySelector('title');
+    const text = title?.textContent?.trim();
+    return text || null;
+}
+function extractMetaDescription(root) {
+    const meta = root.querySelector('meta[name="description"]');
+    const content = meta?.getAttribute('content')?.trim();
+    return content || null;
+}
+function extractAllH1s(root) {
+    return root
+        .querySelectorAll('h1')
+        .map((el) => el.textContent.trim())
+        .filter(Boolean);
+}
+function countWords(root) {
+    const body = root.querySelector('body');
+    if (!body)
+        return 0;
+    // Remove script and style elements
+    for (const el of body.querySelectorAll('script, style')) {
+        el.remove();
+    }
+    const text = body.textContent.replace(/\s+/g, ' ').trim();
+    if (!text)
+        return 0;
+    return text.split(/\s+/).length;
+}
+function extractImageAlts(root) {
+    return root.querySelectorAll('img').reduce((acc, img) => {
+        const src = img.getAttribute('src') || img.getAttribute('data-src');
+        if (!src)
+            return acc;
+        const alt = img.getAttribute('alt') ?? '';
+        acc.push({ src, alt, missing: alt === '' });
+        return acc;
+    }, []);
+}
+function countInternalLinks(root, pageUrl) {
+    let host = '';
+    try {
+        host = new URL(pageUrl).host;
+    }
+    catch {
+        return 0;
+    }
+    let count = 0;
+    for (const a of root.querySelectorAll('a[href]')) {
+        const href = a.getAttribute('href') ?? '';
+        if (href.startsWith('/') || href.includes(host)) {
+            count++;
+        }
+    }
+    return count;
+}
+function extractStructuredData(root) {
+    const schemas = [];
+    for (const script of root.querySelectorAll('script[type="application/ld+json"]')) {
+        try {
+            const decoded = JSON.parse(script.textContent);
+            if (decoded && typeof decoded === 'object') {
+                schemas.push(decoded);
+            }
+        }
+        catch {
+            // skip malformed JSON-LD
+        }
+    }
+    return schemas;
+}
+function detectNoindex(root) {
+    for (const name of ['robots', 'googlebot']) {
+        const meta = root.querySelector(`meta[name="${name}"]`);
+        const content = meta?.getAttribute('content')?.toLowerCase() ?? '';
+        if (content.includes('noindex'))
+            return true;
+    }
+    return false;
+}
+function extractCanonical(root) {
+    const link = root.querySelector('link[rel="canonical"]');
+    return link?.getAttribute('href') ?? null;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/crawler/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/crawler/analyze.ts"],"names":[],"mappings":"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"}