@vistagenic/vista 0.1.0-alpha.1

package/dist/server/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Vista Server Utilities
+ *
+ * Next.js-compatible server-only functions for use in Server Components and API routes.
+ * These functions only work on the server side.
+ */
+export interface CookieOptions {
+    maxAge?: number;
+    expires?: Date;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+    priority?: 'low' | 'medium' | 'high';
+}
+export interface ReadonlyCookie {
+    name: string;
+    value: string;
+}
+export interface CookieStore {
+    get(name: string): ReadonlyCookie | undefined;
+    getAll(): ReadonlyCookie[];
+    has(name: string): boolean;
+    set(name: string, value: string, options?: CookieOptions): void;
+    delete(name: string): void;
+}
+/**
+ * Access cookies in Server Components and API routes.
+ * Note: This is a simplified implementation - in production, integrate with actual request.
+ */
+export declare function cookies(): CookieStore;
+export interface ReadonlyHeaders {
+    get(name: string): string | null;
+    has(name: string): boolean;
+    entries(): IterableIterator<[string, string]>;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<string>;
+    forEach(callback: (value: string, key: string) => void): void;
+}
+/**
+ * Access request headers in Server Components.
+ * Note: This is a simplified implementation - in production, integrate with actual request.
+ */
+export declare function headers(): ReadonlyHeaders;
+export type RedirectType = 'push' | 'replace';
+export declare class RedirectError extends Error {
+    readonly url: string;
+    readonly type: RedirectType;
+    constructor(url: string, type?: RedirectType);
+}
+/**
+ * Redirect to another URL from a Server Component or API route.
+ * @param url - The URL to redirect to
+ * @param type - The type of redirect ('push' or 'replace')
+ * @throws RedirectError - Always throws to interrupt rendering
+ */
+export declare function redirect(url: string, type?: RedirectType): never;
+/**
+ * Permanent redirect (HTTP 308) to another URL.
+ * @param url - The URL to redirect to
+ * @throws RedirectError - Always throws to interrupt rendering
+ */
+export declare function permanentRedirect(url: string): never;
+export declare class NotFoundError extends Error {
+    constructor();
+}
+/**
+ * Trigger a 404 Not Found response from a Server Component.
+ * @throws NotFoundError - Always throws to interrupt rendering
+ */
+export declare function notFound(): never;
+/**
+ * Create a JSON response (for API routes).
+ */
+export declare function json<T>(data: T, init?: ResponseInit): Response;
+/**
+ * Create a NextResponse-compatible response object.
+ */
+export declare class NextResponse extends Response {
+    static json<T>(data: T, init?: ResponseInit): NextResponse;
+    static redirect(url: string | URL, status?: number): NextResponse;
+    static rewrite(url: string | URL): NextResponse;
+    static next(): NextResponse;
+}
+export interface NextRequest extends Request {
+    nextUrl: {
+        pathname: string;
+        searchParams: URLSearchParams;
+        href: string;
+        origin: string;
+    };
+    cookies: CookieStore;
+    headers: Headers;
+}

package/dist/server/index.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Vista Server Utilities
+ *
+ * Next.js-compatible server-only functions for use in Server Components and API routes.
+ * These functions only work on the server side.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextResponse = exports.NotFoundError = exports.RedirectError = void 0;
+exports.cookies = cookies;
+exports.headers = headers;
+exports.redirect = redirect;
+exports.permanentRedirect = permanentRedirect;
+exports.notFound = notFound;
+exports.json = json;
+/**
+ * Access cookies in Server Components and API routes.
+ * Note: This is a simplified implementation - in production, integrate with actual request.
+ */
+function cookies() {
+    // Server-side cookie access would be implemented here
+    // For now, return a mock implementation
+    const cookieMap = new Map();
+    // Check if we're in a server context
+    if (typeof window !== 'undefined') {
+        console.warn('cookies() should only be called on the server');
+    }
+    return {
+        get(name) {
+            const value = cookieMap.get(name);
+            return value ? { name, value } : undefined;
+        },
+        getAll() {
+            return Array.from(cookieMap.entries()).map(([name, value]) => ({ name, value }));
+        },
+        has(name) {
+            return cookieMap.has(name);
+        },
+        set(name, value, options) {
+            cookieMap.set(name, value);
+            // In real implementation, set the Set-Cookie header
+        },
+        delete(name) {
+            cookieMap.delete(name);
+            // In real implementation, set the Set-Cookie header with expired date
+        },
+    };
+}
+/**
+ * Access request headers in Server Components.
+ * Note: This is a simplified implementation - in production, integrate with actual request.
+ */
+function headers() {
+    // Server-side header access would be implemented here
+    const headerMap = new Map();
+    if (typeof window !== 'undefined') {
+        console.warn('headers() should only be called on the server');
+    }
+    return {
+        get(name) {
+            return headerMap.get(name.toLowerCase()) ?? null;
+        },
+        has(name) {
+            return headerMap.has(name.toLowerCase());
+        },
+        entries() {
+            return headerMap.entries();
+        },
+        keys() {
+            return headerMap.keys();
+        },
+        values() {
+            return headerMap.values();
+        },
+        forEach(callback) {
+            headerMap.forEach((value, key) => callback(value, key));
+        },
+    };
+}
+class RedirectError extends Error {
+    url;
+    type;
+    constructor(url, type = 'replace') {
+        super(`Redirect to ${url}`);
+        this.name = 'RedirectError';
+        this.url = url;
+        this.type = type;
+    }
+}
+exports.RedirectError = RedirectError;
+/**
+ * Redirect to another URL from a Server Component or API route.
+ * @param url - The URL to redirect to
+ * @param type - The type of redirect ('push' or 'replace')
+ * @throws RedirectError - Always throws to interrupt rendering
+ */
+function redirect(url, type = 'replace') {
+    throw new RedirectError(url, type);
+}
+/**
+ * Permanent redirect (HTTP 308) to another URL.
+ * @param url - The URL to redirect to
+ * @throws RedirectError - Always throws to interrupt rendering
+ */
+function permanentRedirect(url) {
+    throw new RedirectError(url, 'replace');
+}
+// ============================================================================
+// Not Found
+// ============================================================================
+class NotFoundError extends Error {
+    constructor() {
+        super('Not Found');
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Trigger a 404 Not Found response from a Server Component.
+ * @throws NotFoundError - Always throws to interrupt rendering
+ */
+function notFound() {
+    throw new NotFoundError();
+}
+// ============================================================================
+// Response Helpers
+// ============================================================================
+/**
+ * Create a JSON response (for API routes).
+ */
+function json(data, init) {
+    return new Response(JSON.stringify(data), {
+        ...init,
+        headers: {
+            'Content-Type': 'application/json',
+            ...init?.headers,
+        },
+    });
+}
+/**
+ * Create a NextResponse-compatible response object.
+ */
+class NextResponse extends Response {
+    static json(data, init) {
+        return new NextResponse(JSON.stringify(data), {
+            ...init,
+            headers: {
+                'Content-Type': 'application/json',
+                ...init?.headers,
+            },
+        });
+    }
+    static redirect(url, status = 307) {
+        return new NextResponse(null, {
+            status,
+            headers: {
+                Location: url.toString(),
+            },
+        });
+    }
+    static rewrite(url) {
+        // Rewrite implementation would go here
+        return new NextResponse(null, {
+            headers: {
+                'x-middleware-rewrite': url.toString(),
+            },
+        });
+    }
+    static next() {
+        return new NextResponse(null, {
+            headers: {
+                'x-middleware-next': '1',
+            },
+        });
+    }
+}
+exports.NextResponse = NextResponse;

package/dist/server/rsc-engine.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Vista RSC Engine
+ *
+ * React Server Components aware rendering engine.
+ *
+ * This engine implements the "True RSC Architecture":
+ * 1. Server components render on the server only, contribute 0kb to client
+ * 2. Client components are sent as references, hydrated on demand
+ * 3. Strict separation ensures server secrets never leak
+ */
+import webpack from 'webpack';
+export interface RSCEngineOptions {
+    port?: number;
+    compiler?: webpack.Compiler;
+}
+/**
+ * Start the RSC-aware Vista server
+ */
+export declare function startRSCServer(options?: RSCEngineOptions): void;
+export { startRSCServer as default };