@sonordev/site-kit 1.2.7

package/dist/server-api-GJPNRYUP.js

@@ -0,0 +1,81 @@
+'use strict';
+
+var chunkDW5UJKHH_js = require('./chunk-DW5UJKHH.js');
+require('./chunk-ZSMWDLMK.js');
+
+
+
+Object.defineProperty(exports, "ensureMetadata", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.ensureMetadata; }
+});
+Object.defineProperty(exports, "getABTest", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getABTest; }
+});
+Object.defineProperty(exports, "getContentBlock", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getContentBlock; }
+});
+Object.defineProperty(exports, "getEntities", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getEntities; }
+});
+Object.defineProperty(exports, "getEntityEnhancedSchema", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getEntityEnhancedSchema; }
+});
+Object.defineProperty(exports, "getFAQData", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getFAQData; }
+});
+Object.defineProperty(exports, "getInternalLinks", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getInternalLinks; }
+});
+Object.defineProperty(exports, "getManagedScripts", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getManagedScripts; }
+});
+Object.defineProperty(exports, "getPrimaryEntity", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getPrimaryEntity; }
+});
+Object.defineProperty(exports, "getRedirectData", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getRedirectData; }
+});
+Object.defineProperty(exports, "getRobotsData", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getRobotsData; }
+});
+Object.defineProperty(exports, "getSEOPageData", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getSEOPageData; }
+});
+Object.defineProperty(exports, "getSchemaMarkups", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getSchemaMarkups; }
+});
+Object.defineProperty(exports, "getSitemapEntries", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getSitemapEntries; }
+});
+Object.defineProperty(exports, "getVisibilityScore", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getVisibilityScore; }
+});
+Object.defineProperty(exports, "getVisibilitySummary", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.getVisibilitySummary; }
+});
+Object.defineProperty(exports, "recordABImpression", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.recordABImpression; }
+});
+Object.defineProperty(exports, "registerSitemap", {
+  enumerable: true,
+  get: function () { return chunkDW5UJKHH_js.registerSitemap; }
+});
+//# sourceMappingURL=server-api-GJPNRYUP.js.map
+//# sourceMappingURL=server-api-GJPNRYUP.js.map

package/dist/server-api-GJPNRYUP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"server-api-GJPNRYUP.js"}

package/dist/setup/client.d.mts

@@ -0,0 +1,60 @@
+export { S as SetupWizard, S as UptradeSetup } from '../SetupWizard-Cki06kB0.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Integration Code Generator
+ *
+ * Generates site-kit integration code snippets based on enabled modules.
+ * Used by SetupWizard and can be called standalone.
+ */
+interface IntegrationSnippet {
+    module: string;
+    snippetType: 'install' | 'layout' | 'component' | 'page' | 'api-route' | 'env';
+    title: string;
+    description?: string;
+    filePath?: string;
+    code: string;
+    language: 'typescript' | 'tsx' | 'bash' | 'env';
+    order: number;
+    required: boolean;
+}
+interface GeneratorContext {
+    projectId: string;
+    projectName?: string;
+    apiUrl?: string;
+    enabledModules: string[];
+    brand?: {
+        primaryColor?: string;
+        secondaryColor?: string;
+        businessName?: string;
+    };
+}
+/**
+ * Generate all integration code snippets for enabled modules
+ */
+declare function generateIntegrationCode(context: GeneratorContext): IntegrationSnippet[];
+/**
+ * Get snippets grouped by module
+ */
+declare function getSnippetsByModule(snippets: IntegrationSnippet[]): Record<string, IntegrationSnippet[]>;
+
+/**
+ * IntegrationCodeView - Display generated site-kit integration code
+ *
+ * Shows code snippets grouped by module with copy functionality.
+ * Can be used in setup wizards or admin dashboards.
+ */
+interface IntegrationCodeViewProps {
+    projectId: string;
+    enabledModules: string[];
+    apiUrl?: string;
+    brand?: {
+        primaryColor?: string;
+        businessName?: string;
+    };
+    className?: string;
+    onCopy?: (code: string, title: string) => void;
+}
+declare function IntegrationCodeView({ projectId, enabledModules, apiUrl, brand, className, onCopy, }: IntegrationCodeViewProps): react_jsx_runtime.JSX.Element;
+
+export { type GeneratorContext, IntegrationCodeView, type IntegrationCodeViewProps, type IntegrationSnippet, generateIntegrationCode, getSnippetsByModule };

package/dist/setup/client.d.ts

@@ -0,0 +1,60 @@
+export { S as SetupWizard, S as UptradeSetup } from '../SetupWizard-Cki06kB0.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Integration Code Generator
+ *
+ * Generates site-kit integration code snippets based on enabled modules.
+ * Used by SetupWizard and can be called standalone.
+ */
+interface IntegrationSnippet {
+    module: string;
+    snippetType: 'install' | 'layout' | 'component' | 'page' | 'api-route' | 'env';
+    title: string;
+    description?: string;
+    filePath?: string;
+    code: string;
+    language: 'typescript' | 'tsx' | 'bash' | 'env';
+    order: number;
+    required: boolean;
+}
+interface GeneratorContext {
+    projectId: string;
+    projectName?: string;
+    apiUrl?: string;
+    enabledModules: string[];
+    brand?: {
+        primaryColor?: string;
+        secondaryColor?: string;
+        businessName?: string;
+    };
+}
+/**
+ * Generate all integration code snippets for enabled modules
+ */
+declare function generateIntegrationCode(context: GeneratorContext): IntegrationSnippet[];
+/**
+ * Get snippets grouped by module
+ */
+declare function getSnippetsByModule(snippets: IntegrationSnippet[]): Record<string, IntegrationSnippet[]>;
+
+/**
+ * IntegrationCodeView - Display generated site-kit integration code
+ *
+ * Shows code snippets grouped by module with copy functionality.
+ * Can be used in setup wizards or admin dashboards.
+ */
+interface IntegrationCodeViewProps {
+    projectId: string;
+    enabledModules: string[];
+    apiUrl?: string;
+    brand?: {
+        primaryColor?: string;
+        businessName?: string;
+    };
+    className?: string;
+    onCopy?: (code: string, title: string) => void;
+}
+declare function IntegrationCodeView({ projectId, enabledModules, apiUrl, brand, className, onCopy, }: IntegrationCodeViewProps): react_jsx_runtime.JSX.Element;
+
+export { type GeneratorContext, IntegrationCodeView, type IntegrationCodeViewProps, type IntegrationSnippet, generateIntegrationCode, getSnippetsByModule };

package/dist/setup/client.js

@@ -0,0 +1,31 @@
+'use client';
+'use strict';
+
+var chunkXQQWI6WB_js = require('../chunk-XQQWI6WB.js');
+var chunk72MQFHYJ_js = require('../chunk-72MQFHYJ.js');
+require('../chunk-ZSMWDLMK.js');
+
+
+
+Object.defineProperty(exports, "IntegrationCodeView", {
+  enumerable: true,
+  get: function () { return chunkXQQWI6WB_js.IntegrationCodeView; }
+});
+Object.defineProperty(exports, "generateIntegrationCode", {
+  enumerable: true,
+  get: function () { return chunkXQQWI6WB_js.generateIntegrationCode; }
+});
+Object.defineProperty(exports, "getSnippetsByModule", {
+  enumerable: true,
+  get: function () { return chunkXQQWI6WB_js.getSnippetsByModule; }
+});
+Object.defineProperty(exports, "SetupWizard", {
+  enumerable: true,
+  get: function () { return chunk72MQFHYJ_js.SetupWizard; }
+});
+Object.defineProperty(exports, "UptradeSetup", {
+  enumerable: true,
+  get: function () { return chunk72MQFHYJ_js.SetupWizard; }
+});
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/setup/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"client.js"}

package/dist/setup/client.mjs

@@ -0,0 +1,6 @@
+'use client';
+export { IntegrationCodeView, generateIntegrationCode, getSnippetsByModule } from '../chunk-AFAO3TGS.mjs';
+export { SetupWizard, SetupWizard as UptradeSetup } from '../chunk-P3UWIUJS.mjs';
+import '../chunk-4XPGGLVP.mjs';
+//# sourceMappingURL=client.mjs.map
+//# sourceMappingURL=client.mjs.map

package/dist/setup/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"client.mjs"}

package/dist/setup/index.d.mts

@@ -0,0 +1,5 @@
+export { S as SetupWizard, S as UptradeSetup } from '../SetupWizard-Cki06kB0.mjs';
+export { handleRequest } from './server.mjs';
+export { GeneratorContext, IntegrationCodeView, IntegrationCodeViewProps, IntegrationSnippet, generateIntegrationCode, getSnippetsByModule } from './client.mjs';
+import 'react/jsx-runtime';
+import 'next/server';

package/dist/setup/index.d.ts

@@ -0,0 +1,5 @@
+export { S as SetupWizard, S as UptradeSetup } from '../SetupWizard-Cki06kB0.js';
+export { handleRequest } from './server.js';
+export { GeneratorContext, IntegrationCodeView, IntegrationCodeViewProps, IntegrationSnippet, generateIntegrationCode, getSnippetsByModule } from './client.js';
+import 'react/jsx-runtime';
+import 'next/server';

package/dist/setup/index.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var chunkXQQWI6WB_js = require('../chunk-XQQWI6WB.js');
+var chunkBYLIU6XG_js = require('../chunk-BYLIU6XG.js');
+var chunk72MQFHYJ_js = require('../chunk-72MQFHYJ.js');
+require('../chunk-ZSMWDLMK.js');
+
+
+
+Object.defineProperty(exports, "IntegrationCodeView", {
+  enumerable: true,
+  get: function () { return chunkXQQWI6WB_js.IntegrationCodeView; }
+});
+Object.defineProperty(exports, "generateIntegrationCode", {
+  enumerable: true,
+  get: function () { return chunkXQQWI6WB_js.generateIntegrationCode; }
+});
+Object.defineProperty(exports, "getSnippetsByModule", {
+  enumerable: true,
+  get: function () { return chunkXQQWI6WB_js.getSnippetsByModule; }
+});
+Object.defineProperty(exports, "handleRequest", {
+  enumerable: true,
+  get: function () { return chunkBYLIU6XG_js.handleRequest; }
+});
+Object.defineProperty(exports, "SetupWizard", {
+  enumerable: true,
+  get: function () { return chunk72MQFHYJ_js.SetupWizard; }
+});
+Object.defineProperty(exports, "UptradeSetup", {
+  enumerable: true,
+  get: function () { return chunk72MQFHYJ_js.SetupWizard; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/setup/index.mjs

@@ -0,0 +1,6 @@
+export { IntegrationCodeView, generateIntegrationCode, getSnippetsByModule } from '../chunk-AFAO3TGS.mjs';
+export { handleRequest } from '../chunk-DQYMKR27.mjs';
+export { SetupWizard, SetupWizard as UptradeSetup } from '../chunk-P3UWIUJS.mjs';
+import '../chunk-4XPGGLVP.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/setup/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/setup/server.d.mts

@@ -0,0 +1,14 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Setup Wizard API Handlers
+ *
+ * These are Next.js API route handlers that the SetupWizard component calls.
+ * They run on the server and have access to fs for code generation.
+ *
+ * Usage: Copy these to your app/_uptrade/api/ folder
+ */
+
+declare function handleRequest(req: NextRequest, route: string): Promise<NextResponse>;
+
+export { handleRequest };

package/dist/setup/server.d.ts

@@ -0,0 +1,14 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Setup Wizard API Handlers
+ *
+ * These are Next.js API route handlers that the SetupWizard component calls.
+ * They run on the server and have access to fs for code generation.
+ *
+ * Usage: Copy these to your app/_uptrade/api/ folder
+ */
+
+declare function handleRequest(req: NextRequest, route: string): Promise<NextResponse>;
+
+export { handleRequest };

package/dist/setup/server.js

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkBYLIU6XG_js = require('../chunk-BYLIU6XG.js');
+require('../chunk-ZSMWDLMK.js');
+
+
+
+Object.defineProperty(exports, "handleRequest", {
+  enumerable: true,
+  get: function () { return chunkBYLIU6XG_js.handleRequest; }
+});
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/setup/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"server.js"}

package/dist/setup/server.mjs

@@ -0,0 +1,4 @@
+export { handleRequest } from '../chunk-DQYMKR27.mjs';
+import '../chunk-4XPGGLVP.mjs';
+//# sourceMappingURL=server.mjs.map
+//# sourceMappingURL=server.mjs.map

package/dist/setup/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"server.mjs"}

package/dist/site-config/index.d.mts

@@ -0,0 +1,24 @@
+/**
+ * Site config from Portal (project-info) by API key.
+ * Resolves site_url and domain so consumers only need NEXT_PUBLIC_UPTRADE_API_KEY.
+ */
+interface SiteConfig {
+    site_url: string;
+    domain: string;
+}
+interface GetSiteConfigOptions {
+    apiKey?: string;
+    apiUrl?: string;
+}
+/**
+ * Fetch site_url and domain from Portal project-info for the given API key.
+ * Uses in-memory cache (TTL 10 min) keyed by apiKey.
+ * Safe for Edge (middleware) and Node (route handlers).
+ */
+declare function getSiteConfig(options?: GetSiteConfigOptions): Promise<SiteConfig | null>;
+/**
+ * Clear in-memory site config cache (e.g. for tests).
+ */
+declare function clearSiteConfigCache(): void;
+
+export { type GetSiteConfigOptions, type SiteConfig, clearSiteConfigCache, getSiteConfig };

package/dist/site-config/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Site config from Portal (project-info) by API key.
+ * Resolves site_url and domain so consumers only need NEXT_PUBLIC_UPTRADE_API_KEY.
+ */
+interface SiteConfig {
+    site_url: string;
+    domain: string;
+}
+interface GetSiteConfigOptions {
+    apiKey?: string;
+    apiUrl?: string;
+}
+/**
+ * Fetch site_url and domain from Portal project-info for the given API key.
+ * Uses in-memory cache (TTL 10 min) keyed by apiKey.
+ * Safe for Edge (middleware) and Node (route handlers).
+ */
+declare function getSiteConfig(options?: GetSiteConfigOptions): Promise<SiteConfig | null>;
+/**
+ * Clear in-memory site config cache (e.g. for tests).
+ */
+declare function clearSiteConfigCache(): void;
+
+export { type GetSiteConfigOptions, type SiteConfig, clearSiteConfigCache, getSiteConfig };

package/dist/site-config/index.js

@@ -0,0 +1,17 @@
+'use strict';
+
+var chunk7557OTHW_js = require('../chunk-7557OTHW.js');
+require('../chunk-ZSMWDLMK.js');
+
+
+
+Object.defineProperty(exports, "clearSiteConfigCache", {
+  enumerable: true,
+  get: function () { return chunk7557OTHW_js.clearSiteConfigCache; }
+});
+Object.defineProperty(exports, "getSiteConfig", {
+  enumerable: true,
+  get: function () { return chunk7557OTHW_js.getSiteConfig; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/site-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/site-config/index.mjs

@@ -0,0 +1,4 @@
+export { clearSiteConfigCache, getSiteConfig } from '../chunk-GCJXQ4AG.mjs';
+import '../chunk-4XPGGLVP.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/site-config/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/sitemap/index.d.mts

@@ -0,0 +1,96 @@
+import { L as LLMsDataResponse } from '../types-Blb2QNkV.mjs';
+
+/**
+ * @sonordev/site-kit - Sitemap Generator
+ *
+ * Automatically generates sitemap.xml from Next.js app directory structure.
+ * Works at build time to discover all pages and sync them to Portal API.
+ *
+ * @example
+ * ```ts
+ * // app/sitemap.ts
+ * import { createSitemap } from '@sonordev/site-kit/sitemap'
+ *
+ * export default createSitemap({
+ *   baseUrl: 'https://example.com',
+ *   // Optional: exclude patterns
+ *   exclude: ['/admin/*', '/api/*'],
+ *   // Optional: additional dynamic routes
+ *   additionalPaths: async () => [
+ *     { path: '/blog/post-1', priority: 0.7 },
+ *   ]
+ * })
+ * ```
+ */
+interface SitemapEntry {
+    url: string;
+    lastModified?: Date | string;
+    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+}
+interface SitemapConfig {
+    /** Base URL for the site (optional when apiKey is set; then resolved from Portal project-info) */
+    baseUrl?: string;
+    /** Glob patterns to exclude (e.g., ['/admin/*', '/api/*']) */
+    exclude?: string[];
+    /** Default priority for pages */
+    defaultPriority?: number;
+    /** Default change frequency */
+    defaultChangeFrequency?: SitemapEntry['changeFrequency'];
+    /** Additional paths to include (for dynamic routes) */
+    additionalPaths?: () => Promise<Array<{
+        path: string;
+        priority?: number;
+        changeFrequency?: SitemapEntry['changeFrequency'];
+    }>>;
+    /** Priority overrides by path pattern */
+    priorities?: Record<string, number>;
+    /** Portal API URL for syncing (defaults to NEXT_PUBLIC_UPTRADE_API_URL or https://api.uptrademedia.com) */
+    apiUrl?: string;
+    /** Portal API key for syncing (defaults to NEXT_PUBLIC_UPTRADE_API_KEY) */
+    apiKey?: string;
+    /** Disable auto-sync to Portal API */
+    disableSync?: boolean;
+    /** When true, await meta optimization before build completes (for build-time llms.txt with managed_llm_schema) */
+    awaitMetaOptimization?: boolean;
+    /** When true (default when API key present), write AI-optimized llms.txt to public/llms.txt after sitemap sync */
+    optimizedLLMsTxt?: boolean;
+    /** When true with optimizedLLMsTxt, also write public/llms-full.txt */
+    optimizedLLMsFullTxt?: boolean;
+    /** When Portal returns empty services, use this to supply local site data for llms.txt */
+    getLocalData?: () => Promise<LLMsDataResponse | null>;
+    /** Use Signal AI visibility scores to compute page priority (40% visibility + 30% depth + 30% base) */
+    intelligentPriority?: boolean;
+}
+interface SyncSitemapOptions {
+    /** Trigger Signal AI meta optimization after sync */
+    optimizeMeta?: boolean;
+    /** When true, wait for meta optimization to complete (for build-time llms.txt) */
+    awaitMeta?: boolean;
+}
+/**
+ * Sync sitemap entries to Portal API
+ * Called automatically by createSitemap at build time
+ */
+declare function syncSitemapToPortal(entries: SitemapEntry[], apiUrl: string, apiKey: string, options?: SyncSitemapOptions): Promise<{
+    success: boolean;
+    created: number;
+    updated: number;
+}>;
+/**
+ * Create a sitemap generator function for Next.js
+ * Automatically syncs to Portal API at build time.
+ *
+ * @example
+ * ```ts
+ * // app/sitemap.ts
+ * import { createSitemap } from '@sonordev/site-kit/sitemap'
+ *
+ * export default createSitemap({
+ *   baseUrl: 'https://example.com'
+ * })
+ * ```
+ */
+declare function createSitemap(config: SitemapConfig): () => SitemapEntry[] | Promise<SitemapEntry[]>;
+
+export { type SitemapConfig, type SitemapEntry, type SyncSitemapOptions, createSitemap, syncSitemapToPortal };

package/dist/sitemap/index.d.ts

@@ -0,0 +1,96 @@
+import { L as LLMsDataResponse } from '../types-Blb2QNkV.js';
+
+/**
+ * @sonordev/site-kit - Sitemap Generator
+ *
+ * Automatically generates sitemap.xml from Next.js app directory structure.
+ * Works at build time to discover all pages and sync them to Portal API.
+ *
+ * @example
+ * ```ts
+ * // app/sitemap.ts
+ * import { createSitemap } from '@sonordev/site-kit/sitemap'
+ *
+ * export default createSitemap({
+ *   baseUrl: 'https://example.com',
+ *   // Optional: exclude patterns
+ *   exclude: ['/admin/*', '/api/*'],
+ *   // Optional: additional dynamic routes
+ *   additionalPaths: async () => [
+ *     { path: '/blog/post-1', priority: 0.7 },
+ *   ]
+ * })
+ * ```
+ */
+interface SitemapEntry {
+    url: string;
+    lastModified?: Date | string;
+    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+}
+interface SitemapConfig {
+    /** Base URL for the site (optional when apiKey is set; then resolved from Portal project-info) */
+    baseUrl?: string;
+    /** Glob patterns to exclude (e.g., ['/admin/*', '/api/*']) */
+    exclude?: string[];
+    /** Default priority for pages */
+    defaultPriority?: number;
+    /** Default change frequency */
+    defaultChangeFrequency?: SitemapEntry['changeFrequency'];
+    /** Additional paths to include (for dynamic routes) */
+    additionalPaths?: () => Promise<Array<{
+        path: string;
+        priority?: number;
+        changeFrequency?: SitemapEntry['changeFrequency'];
+    }>>;
+    /** Priority overrides by path pattern */
+    priorities?: Record<string, number>;
+    /** Portal API URL for syncing (defaults to NEXT_PUBLIC_UPTRADE_API_URL or https://api.uptrademedia.com) */
+    apiUrl?: string;
+    /** Portal API key for syncing (defaults to NEXT_PUBLIC_UPTRADE_API_KEY) */
+    apiKey?: string;
+    /** Disable auto-sync to Portal API */
+    disableSync?: boolean;
+    /** When true, await meta optimization before build completes (for build-time llms.txt with managed_llm_schema) */
+    awaitMetaOptimization?: boolean;
+    /** When true (default when API key present), write AI-optimized llms.txt to public/llms.txt after sitemap sync */
+    optimizedLLMsTxt?: boolean;
+    /** When true with optimizedLLMsTxt, also write public/llms-full.txt */
+    optimizedLLMsFullTxt?: boolean;
+    /** When Portal returns empty services, use this to supply local site data for llms.txt */
+    getLocalData?: () => Promise<LLMsDataResponse | null>;
+    /** Use Signal AI visibility scores to compute page priority (40% visibility + 30% depth + 30% base) */
+    intelligentPriority?: boolean;
+}
+interface SyncSitemapOptions {
+    /** Trigger Signal AI meta optimization after sync */
+    optimizeMeta?: boolean;
+    /** When true, wait for meta optimization to complete (for build-time llms.txt) */
+    awaitMeta?: boolean;
+}
+/**
+ * Sync sitemap entries to Portal API
+ * Called automatically by createSitemap at build time
+ */
+declare function syncSitemapToPortal(entries: SitemapEntry[], apiUrl: string, apiKey: string, options?: SyncSitemapOptions): Promise<{
+    success: boolean;
+    created: number;
+    updated: number;
+}>;
+/**
+ * Create a sitemap generator function for Next.js
+ * Automatically syncs to Portal API at build time.
+ *
+ * @example
+ * ```ts
+ * // app/sitemap.ts
+ * import { createSitemap } from '@sonordev/site-kit/sitemap'
+ *
+ * export default createSitemap({
+ *   baseUrl: 'https://example.com'
+ * })
+ * ```
+ */
+declare function createSitemap(config: SitemapConfig): () => SitemapEntry[] | Promise<SitemapEntry[]>;
+
+export { type SitemapConfig, type SitemapEntry, type SyncSitemapOptions, createSitemap, syncSitemapToPortal };