svedocs 0.1.0-beta.2

package/dist/ai/runtime.js

@@ -0,0 +1,105 @@
+import { createCloudflareAiSearchAiProvider, createMockAiProvider, createWorkersAiProvider } from './providers.js';
+import { createAskResponse } from './response.js';
+import { createOpenAiCompatibleProvider } from './openai-compatible.js';
+export function createConfiguredAiProvider(options) {
+    const provider = normalizeProviderName(options.provider ?? options.config.ai.provider);
+    if (!options.config.ai.enabled)
+        return createMockAiProvider();
+    const systemPrompt = options.config.ai.systemPrompt;
+    const maxResults = options.config.ai.maxResults;
+    if (provider === 'cloudflare-workers-ai') {
+        const ai = readWorkersAiBinding(options.env);
+        if (ai)
+            return createWorkersAiProvider({
+                ai,
+                ...(systemPrompt ? { systemPrompt } : {}),
+                ...(typeof maxResults === 'number' ? { citationLimit: maxResults } : {})
+            });
+        return createMockAiProvider();
+    }
+    if (provider === 'cloudflare-ai-search') {
+        const binding = readCloudflareAiSearchBinding(options.env, options.config);
+        if (binding) {
+            return createCloudflareAiSearchAiProvider({
+                binding,
+                instanceName: options.config.cloudflare.aiSearch.instanceName,
+                ...(systemPrompt ? { systemPrompt } : {}),
+                ...(typeof maxResults === 'number' ? { maxResults } : {})
+            });
+        }
+        return createMockAiProvider();
+    }
+    if (provider === 'openai-compatible') {
+        const apiKey = readFirstEnv(options.env, ['SVEDOCS_OPENAI_COMPATIBLE_API_KEY', 'OPENAI_COMPATIBLE_API_KEY']);
+        const baseUrl = readFirstEnv(options.env, ['SVEDOCS_OPENAI_COMPATIBLE_BASE_URL', 'OPENAI_COMPATIBLE_BASE_URL']);
+        const model = readFirstEnv(options.env, ['SVEDOCS_OPENAI_COMPATIBLE_MODEL', 'OPENAI_COMPATIBLE_MODEL']);
+        const temperature = readNumberEnv(options.env, ['SVEDOCS_OPENAI_COMPATIBLE_TEMPERATURE', 'OPENAI_COMPATIBLE_TEMPERATURE']);
+        if (apiKey && model) {
+            return createOpenAiCompatibleProvider({
+                apiKey,
+                model,
+                ...(baseUrl ? { baseUrl } : {}),
+                ...(typeof temperature === 'number' ? { temperature } : {}),
+                ...(systemPrompt ? { systemPrompt } : {}),
+                ...(options.fetch ? { fetch: options.fetch } : {})
+            });
+        }
+        return createMockAiProvider();
+    }
+    return createMockAiProvider();
+}
+export function createConfiguredAskResponse(config, records, request, options = {}) {
+    const provider = createConfiguredAiProvider({
+        config,
+        ...(options.provider ? { provider: options.provider } : {}),
+        ...(options.env ? { env: options.env } : {}),
+        ...(options.fetch ? { fetch: options.fetch } : {})
+    });
+    return createAskResponse(provider, request, {
+        records,
+        ...(typeof options.stream === 'boolean' ? { stream: options.stream } : {}),
+        ...(options.scope ? { scope: options.scope } : {}),
+        ...(options.rateLimiter ? { rateLimiter: options.rateLimiter } : {}),
+        ...(options.rateLimitKey ? { rateLimitKey: options.rateLimitKey } : {})
+    });
+}
+function readCloudflareAiSearchBinding(env, config) {
+    const bindingName = config.cloudflare.aiSearch.binding;
+    const dynamicBinding = env?.[bindingName];
+    if (isCloudflareAiSearchBinding(dynamicBinding))
+        return dynamicBinding;
+    if (isCloudflareAiSearchBinding(env?.SVEDOCS_AI_SEARCH))
+        return env.SVEDOCS_AI_SEARCH;
+    return undefined;
+}
+function readWorkersAiBinding(env) {
+    return isWorkersAiBinding(env?.AI) ? env.AI : undefined;
+}
+function isCloudflareAiSearchBinding(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    return 'search' in value || 'get' in value;
+}
+function isWorkersAiBinding(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    return 'run' in value && typeof value.run === 'function';
+}
+function readFirstEnv(env, keys) {
+    for (const key of keys) {
+        const value = env?.[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function readNumberEnv(env, keys) {
+    const value = readFirstEnv(env, keys);
+    if (!value)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function normalizeProviderName(provider) {
+    return provider?.trim().toLowerCase() || 'mock';
+}

package/dist/ai/types.d.ts

@@ -0,0 +1,93 @@
+import type { SvedocsSearchRecord } from '../core.js';
+import type { CloudflareAiSearchChatOutput, CloudflareAiSearchInput, CloudflareAiSearchInstance, CloudflareAiSearchNamespace, SearchScope } from '../search.js';
+export interface AiProvider {
+    name: string;
+    ask(input: AskInput): Promise<AskResult> | AskResult;
+    stream?(input: AskInput): Promise<Response | ReadableStream<Uint8Array>> | Response | ReadableStream<Uint8Array>;
+}
+export interface AskCitation {
+    title: string;
+    url: string;
+    section?: string;
+}
+export interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface AskInput {
+    question: string;
+    messages?: ChatMessage[];
+    systemPrompt?: string;
+    context?: string[];
+    records?: SvedocsSearchRecord[];
+    scope?: SearchScope;
+    maxResults?: number;
+}
+export interface AskResult {
+    answer: string;
+    citations: AskCitation[];
+}
+export interface AiRateLimitResult {
+    allowed: boolean;
+    retryAfter?: number;
+}
+export interface AiRateLimiter {
+    check(input: {
+        key: string;
+        request: Request;
+    }): AiRateLimitResult | Promise<AiRateLimitResult>;
+}
+export interface AiRateLimitStore {
+    get(key: string): Promise<{
+        count: number;
+        resetAt: number;
+    } | undefined>;
+    put(key: string, value: {
+        count: number;
+        resetAt: number;
+    }, ttlSeconds: number): Promise<void>;
+}
+export interface CreateAskResponseOptions {
+    records?: SvedocsSearchRecord[];
+    stream?: boolean;
+    scope?: SearchScope | ((request: Request) => SearchScope);
+    rateLimiter?: AiRateLimiter;
+    rateLimitKey?: string | ((request: Request) => string);
+    systemPrompt?: string;
+    maxResults?: number;
+}
+export interface CloudflareAiChatInstance extends CloudflareAiSearchInstance {
+    chatCompletions?(input: {
+        messages: Array<{
+            role: 'system' | 'developer' | 'user' | 'assistant' | 'tool';
+            content: string;
+        }>;
+        model?: string;
+        stream?: boolean;
+        ai_search_options?: CloudflareAiSearchInput['ai_search_options'];
+    }): Promise<CloudflareAiSearchChatOutput | Response | ReadableStream<Uint8Array>>;
+}
+export interface CloudflareWorkersAiBinding {
+    run(model: string, input: {
+        messages?: Array<{
+            role: 'system' | 'user' | 'assistant';
+            content: string;
+        }>;
+        prompt?: string;
+        stream?: boolean;
+    }): Promise<string | {
+        response?: string;
+        answer?: string;
+        result?: string;
+    }>;
+}
+export interface CloudflareKvNamespace {
+    get<T = unknown>(key: string, options?: {
+        type?: 'json';
+    }): Promise<T | null>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+}
+export type AiSearchBinding = CloudflareAiChatInstance | CloudflareAiSearchNamespace;
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

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

package/dist/ai/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ai.d.ts

@@ -0,0 +1,7 @@
+export * from './ai/types.js';
+export * from './ai/providers.js';
+export * from './ai/openai-compatible.js';
+export * from './ai/rate-limit.js';
+export * from './ai/response.js';
+export * from './ai/runtime.js';
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/ai.js

@@ -0,0 +1,6 @@
+export * from './ai/types.js';
+export * from './ai/providers.js';
+export * from './ai/openai-compatible.js';
+export * from './ai/rate-limit.js';
+export * from './ai/response.js';
+export * from './ai/runtime.js';

package/dist/ambient.d.ts

@@ -0,0 +1,5 @@
+declare module '*.svelte' {
+  import type { Component } from 'svelte';
+  const component: Component<Record<string, unknown>>;
+  export default component;
+}

package/dist/cloudflare.d.ts

@@ -0,0 +1,27 @@
+import type { SvedocsResolvedConfig } from './core.js';
+export type SvedocsBuildMode = 'edge' | 'static' | 'spa';
+export type SvedocsPagePrerenderOption = true | false | 'auto';
+export interface CloudflareBindingShape {
+    AI?: unknown;
+    SVEDOCS_AI_SEARCH?: unknown;
+    SVEDOCS_ASSETS?: unknown;
+    [key: string]: unknown;
+}
+export interface CloudflareBuildPreset {
+    mode: SvedocsBuildMode;
+    adapter: '@sveltejs/adapter-cloudflare' | '@sveltejs/adapter-static';
+    output: string;
+    recommended: boolean;
+    warning?: string;
+}
+export declare function createCloudflarePreset(mode?: SvedocsBuildMode): CloudflareBuildPreset;
+export declare function readSvedocsBuildMode(value?: string | undefined): SvedocsBuildMode;
+export declare function svedocsSsr(mode?: SvedocsBuildMode): boolean;
+export declare function svedocsPagePrerender(mode?: SvedocsBuildMode): SvedocsPagePrerenderOption;
+export declare function createWranglerJson(config: SvedocsResolvedConfig): Record<string, unknown>;
+export declare function createWranglerJsonc(config: SvedocsResolvedConfig): string;
+export declare function createWranglerToml(config: SvedocsResolvedConfig): string;
+export declare function createCloudflareEnvDts(config: SvedocsResolvedConfig): string;
+export declare function usesCloudflareAiSearch(config: SvedocsResolvedConfig): boolean;
+export declare function usesCloudflareWorkersAi(config: SvedocsResolvedConfig): boolean;
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,0BAA0B,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,8BAA8B,GAAG,0BAA0B,CAAC;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,gBAAyB,GAAG,qBAAqB,CAwB7F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,qBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,UAAU,CAAC,IAAI,mBAAyB,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,mBAAyB,GAAG,0BAA0B,CAG9F;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgCxE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAe5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAG7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE9E"}

package/dist/cloudflare.js

@@ -0,0 +1,146 @@
+export function createCloudflarePreset(mode = 'edge') {
+    if (mode === 'edge') {
+        return {
+            mode,
+            adapter: '@sveltejs/adapter-cloudflare',
+            output: '.svelte-kit/cloudflare',
+            recommended: true
+        };
+    }
+    if (mode === 'static') {
+        return {
+            mode,
+            adapter: '@sveltejs/adapter-static',
+            output: 'build',
+            recommended: true
+        };
+    }
+    return {
+        mode,
+        adapter: '@sveltejs/adapter-static',
+        output: 'build',
+        recommended: false,
+        warning: 'SPA mode prerenders known pages and writes a static fallback; edge SSR or full SSG is recommended when available.'
+    };
+}
+export function readSvedocsBuildMode(value = readSvedocsBuildModeEnv()) {
+    return value === 'static' || value === 'spa' || value === 'edge' ? value : 'edge';
+}
+export function svedocsSsr(mode = readSvedocsBuildMode()) {
+    return mode === 'edge' || mode === 'static' || mode === 'spa';
+}
+export function svedocsPagePrerender(mode = readSvedocsBuildMode()) {
+    if (mode === 'static' || mode === 'spa')
+        return true;
+    return 'auto';
+}
+function readSvedocsBuildModeEnv() {
+    return typeof process !== 'undefined' ? process.env.SVEDOCS_BUILD_MODE : undefined;
+}
+export function createWranglerJson(config) {
+    const wrangler = {
+        $schema: 'node_modules/wrangler/config-schema.json',
+        name: config.site.name,
+        compatibility_date: config.cloudflare.compatibilityDate,
+        pages_build_output_dir: createCloudflarePreset(config.build.mode).output
+    };
+    if (usesCloudflareAiSearch(config)) {
+        const aiSearchBinding = {
+            binding: config.cloudflare.aiSearch.binding,
+            remote: config.cloudflare.aiSearch.remote
+        };
+        if (config.cloudflare.aiSearch.namespace) {
+            wrangler.ai_search_namespaces = [
+                {
+                    ...aiSearchBinding,
+                    namespace: config.cloudflare.aiSearch.namespace
+                }
+            ];
+        }
+        else {
+            wrangler.ai_search = [
+                {
+                    ...aiSearchBinding,
+                    instance_name: config.cloudflare.aiSearch.instanceName
+                }
+            ];
+        }
+    }
+    if (usesCloudflareWorkersAi(config)) {
+        wrangler.ai = {
+            binding: 'AI'
+        };
+    }
+    return wrangler;
+}
+export function createWranglerJsonc(config) {
+    return `${JSON.stringify(createWranglerJson(config), null, 2)}\n`;
+}
+export function createWranglerToml(config) {
+    const lines = [
+        `name = ${tomlString(config.site.name)}`,
+        `compatibility_date = ${tomlString(config.cloudflare.compatibilityDate)}`,
+        `pages_build_output_dir = ${tomlString(createCloudflarePreset(config.build.mode).output)}`
+    ];
+    if (usesCloudflareAiSearch(config)) {
+        lines.push('');
+        if (config.cloudflare.aiSearch.namespace) {
+            lines.push('[[ai_search_namespaces]]', `binding = ${tomlString(config.cloudflare.aiSearch.binding)}`, `namespace = ${tomlString(config.cloudflare.aiSearch.namespace)}`);
+        }
+        else {
+            lines.push('[[ai_search]]', `binding = ${tomlString(config.cloudflare.aiSearch.binding)}`, `instance_name = ${tomlString(config.cloudflare.aiSearch.instanceName)}`);
+        }
+        if (config.cloudflare.aiSearch.remote) {
+            lines.push('remote = true');
+        }
+    }
+    if (usesCloudflareWorkersAi(config)) {
+        lines.push('', '[ai]', 'binding = "AI"');
+    }
+    return `${lines.join('\n')}\n`;
+}
+export function createCloudflareEnvDts(config) {
+    const lines = [
+        'declare namespace App {',
+        '  interface Platform {',
+        '    env: {',
+        ...createCloudflareBindingLines(config),
+        '    };',
+        '    context: {',
+        '      waitUntil(promise: Promise<unknown>): void;',
+        '    };',
+        '    caches: CacheStorage;',
+        '  }',
+        '}'
+    ];
+    return `${lines.join('\n')}\n`;
+}
+export function usesCloudflareAiSearch(config) {
+    return (config.search.enabled && config.search.provider === 'cloudflare-ai-search')
+        || (config.ai.enabled && config.ai.provider === 'cloudflare-ai-search');
+}
+export function usesCloudflareWorkersAi(config) {
+    return config.ai.enabled && config.ai.provider === 'cloudflare-workers-ai';
+}
+function createCloudflareBindingLines(config) {
+    const bindings = new Map();
+    if (usesCloudflareAiSearch(config)) {
+        addBindingType(bindings, config.cloudflare.aiSearch.binding, config.cloudflare.aiSearch.namespace
+            ? `import('svedocs/search').CloudflareAiSearchNamespace`
+            : `import('svedocs/search').CloudflareAiSearchInstance`);
+    }
+    if (usesCloudflareWorkersAi(config)) {
+        addBindingType(bindings, 'AI', `import('svedocs/ai').CloudflareWorkersAiBinding`);
+    }
+    const lines = Array.from(bindings.entries()).map(([name, types]) => `      ${formatBindingProperty(name)}: ${types.join(' & ')};`);
+    return lines.length > 0 ? lines : ['      [key: string]: unknown;'];
+}
+function addBindingType(bindings, name, type) {
+    bindings.set(name, [...(bindings.get(name) ?? []), type]);
+}
+function formatBindingProperty(name) {
+    return /^[A-Za-z_$][\w$]*$/.test(name) ? name : JSON.stringify(name);
+}
+function tomlString(value) {
+    return JSON.stringify(value);
+}