@revealui/contracts 1.0.0

package/dist/entities/session.js

@@ -0,0 +1,253 @@
+/**
+ * Session Entity Contract
+ *
+ * Manages authentication session lifecycle with security-critical validation.
+ * Sessions can be persistent (7 days) or regular (1 day) with automatic expiration.
+ *
+ * Business Rules:
+ * - Persistent sessions last 7 days
+ * - Regular sessions last 1 day
+ * - Sessions expire based on expiresAt timestamp
+ * - Last activity tracked on each request
+ * - Token hash stored (never plain token)
+ * - Cascading deletion when user is deleted
+ */
+import { z } from 'zod/v4';
+// =============================================================================
+// Constants
+// =============================================================================
+export const SESSION_SCHEMA_VERSION = 1;
+// Session duration constants (in milliseconds)
+export const SESSION_DURATION = {
+    REGULAR: 24 * 60 * 60 * 1000, // 1 day
+    PERSISTENT: 7 * 24 * 60 * 60 * 1000, // 7 days
+};
+// =============================================================================
+// Base Session Schema
+// =============================================================================
+/**
+ * Session object schema
+ */
+export const SessionObjectSchema = z.object({
+    id: z.string().uuid(),
+    schemaVersion: z.string().default(String(SESSION_SCHEMA_VERSION)),
+    userId: z.string().uuid(),
+    tokenHash: z.string().min(1, 'Token hash is required'),
+    expiresAt: z.date(),
+    userAgent: z.string().nullable().default(null),
+    ipAddress: z.string().nullable().default(null),
+    persistent: z.boolean().nullable().default(false),
+    lastActivityAt: z.date(),
+    createdAt: z.date(),
+});
+/**
+ * Session schema with validation rules
+ */
+export const SessionBaseSchema = SessionObjectSchema.refine((data) => {
+    // Validate expiration is in the future (for new sessions)
+    const now = new Date();
+    return data.expiresAt > now;
+}, {
+    message: 'Session expiration must be in the future',
+    path: ['expiresAt'],
+}).refine((data) => {
+    // Validate token hash format (should be a hash, not plain text)
+    const isValidHash = /^[a-f0-9]{64}$/i.test(data.tokenHash) || data.tokenHash.startsWith('$2');
+    return isValidHash;
+}, {
+    message: 'Token hash must be a valid SHA-256 or bcrypt hash',
+    path: ['tokenHash'],
+});
+export const SessionSchema = SessionBaseSchema;
+// =============================================================================
+// Insert Schema
+// =============================================================================
+/**
+ * Schema for creating new sessions
+ */
+export const SessionInsertSchema = SessionObjectSchema.omit({
+    id: true,
+    createdAt: true,
+    lastActivityAt: true,
+}).extend({
+    id: z.string().uuid().optional(),
+    createdAt: z.date().optional(),
+    lastActivityAt: z.date().optional(),
+});
+// =============================================================================
+// Computed Fields
+// =============================================================================
+/**
+ * Check if a session is expired
+ */
+export function isSessionExpired(session) {
+    return session.expiresAt <= new Date();
+}
+/**
+ * Check if a session is still valid (not expired)
+ */
+export function isSessionValid(session) {
+    return !isSessionExpired(session);
+}
+/**
+ * Calculate session duration based on persistent flag
+ */
+export function calculateSessionDuration(persistent) {
+    return persistent ? SESSION_DURATION.PERSISTENT : SESSION_DURATION.REGULAR;
+}
+/**
+ * Calculate expiration date for a new session
+ */
+export function calculateExpiresAt(persistent, from = new Date()) {
+    const duration = calculateSessionDuration(persistent);
+    return new Date(from.getTime() + duration);
+}
+/**
+ * Check if session needs activity update (last activity > 5 minutes ago)
+ */
+export function needsActivityUpdate(session, thresholdMinutes = 5) {
+    const threshold = thresholdMinutes * 60 * 1000;
+    const timeSinceLastActivity = Date.now() - session.lastActivityAt.getTime();
+    return timeSinceLastActivity > threshold;
+}
+/**
+ * Get remaining session time in milliseconds
+ */
+export function getSessionTimeRemaining(session) {
+    const now = Date.now();
+    const expiresAt = session.expiresAt.getTime();
+    return Math.max(0, expiresAt - now);
+}
+/**
+ * Get session age in milliseconds
+ */
+export function getSessionAge(session) {
+    const now = Date.now();
+    const createdAt = session.createdAt.getTime();
+    return now - createdAt;
+}
+/**
+ * Check if session is nearing expiration (< 1 hour remaining)
+ */
+export function isSessionNearExpiration(session, thresholdMinutes = 60) {
+    const threshold = thresholdMinutes * 60 * 1000;
+    const remaining = getSessionTimeRemaining(session);
+    return remaining > 0 && remaining < threshold;
+}
+// =============================================================================
+// Validation Helpers
+// =============================================================================
+/**
+ * Validate session token hash format
+ */
+export function validateTokenHash(tokenHash) {
+    // SHA-256 hash (64 hex characters) or bcrypt hash (starts with $2)
+    return /^[a-f0-9]{64}$/i.test(tokenHash) || tokenHash.startsWith('$2');
+}
+/**
+ * Validate IP address format (IPv4 or IPv6)
+ */
+export function validateIpAddress(ip) {
+    if (!ip)
+        return true; // Nullable field
+    // IPv4
+    const ipv4Regex = /^(\d{1,3}\.){3}\d{1,3}$/;
+    if (ipv4Regex.test(ip)) {
+        const parts = ip.split('.');
+        return parts.every((part) => Number.parseInt(part, 10) <= 255);
+    }
+    // IPv6
+    const ipv6Regex = /^([0-9a-f]{0,4}:){2,7}[0-9a-f]{0,4}$/i;
+    return ipv6Regex.test(ip);
+}
+// =============================================================================
+// Session State Management
+// =============================================================================
+/**
+ * Create session insert data with computed fields
+ */
+export function createSessionInsert(userId, tokenHash, options) {
+    const now = new Date();
+    const persistent = options?.persistent ?? false;
+    return {
+        id: options?.id,
+        schemaVersion: String(SESSION_SCHEMA_VERSION),
+        userId,
+        tokenHash,
+        expiresAt: calculateExpiresAt(persistent, now),
+        userAgent: options?.userAgent ?? null,
+        ipAddress: options?.ipAddress ?? null,
+        persistent,
+        lastActivityAt: now,
+        createdAt: now,
+    };
+}
+/**
+ * Update session activity timestamp
+ */
+export function updateSessionActivity() {
+    return {
+        lastActivityAt: new Date(),
+    };
+}
+/**
+ * Convert session to format with computed fields
+ */
+export function sessionToHuman(session) {
+    return {
+        ...session,
+        _computed: {
+            isExpired: isSessionExpired(session),
+            isValid: isSessionValid(session),
+            timeRemaining: getSessionTimeRemaining(session),
+            age: getSessionAge(session),
+            isNearExpiration: isSessionNearExpiration(session),
+            needsRefresh: isSessionNearExpiration(session, 120), // < 2 hours
+            durationMs: calculateSessionDuration(session.persistent ?? false),
+        },
+    };
+}
+/**
+ * Convert session to agent-compatible format
+ */
+export function sessionToAgent(session) {
+    return {
+        ...session,
+        metadata: {
+            expired: isSessionExpired(session),
+            valid: isSessionValid(session),
+            timeRemainingMs: getSessionTimeRemaining(session),
+            ageMs: getSessionAge(session),
+            nearExpiration: isSessionNearExpiration(session),
+            type: session.persistent ? 'persistent' : 'regular',
+        },
+    };
+}
+/**
+ * Zod schema for session with computed fields
+ */
+export const SessionWithComputedSchema = SessionSchema.and(z.object({
+    _computed: z.object({
+        isExpired: z.boolean(),
+        isValid: z.boolean(),
+        timeRemaining: z.number(),
+        age: z.number(),
+        isNearExpiration: z.boolean(),
+        needsRefresh: z.boolean(),
+        durationMs: z.number(),
+    }),
+}));
+/**
+ * Zod schema for session with agent metadata
+ */
+export const SessionAgentSchema = SessionSchema.and(z.object({
+    metadata: z.object({
+        expired: z.boolean(),
+        valid: z.boolean(),
+        timeRemainingMs: z.number(),
+        ageMs: z.number(),
+        nearExpiration: z.boolean(),
+        type: z.enum(['persistent', 'regular']),
+    }),
+}));
+//# sourceMappingURL=session.js.map

package/dist/entities/session.js.map

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

package/dist/entities/site.d.ts

@@ -0,0 +1,387 @@
+/**
+ * Site Schema
+ *
+ * A Site is a project container - it holds pages, assets, and configuration.
+ * Sites are the primary unit of ownership and collaboration.
+ *
+ * Sites support both human management (through UI) and agent management
+ * (through structured APIs), enabling true human-AI collaboration.
+ *
+ * This schema extends the auto-generated SitesSelectSchema from the database
+ * and adds:
+ * - Structured validation for JSONB fields (settings, theme)
+ * - Dual representation (human + agent views)
+ * - Business logic and computed fields
+ */
+import { z } from 'zod/v4';
+export declare const SITE_SCHEMA_VERSION = 1;
+export declare const SiteStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+    archived: "archived";
+    maintenance: "maintenance";
+}>;
+export type SiteStatus = z.infer<typeof SiteStatusSchema>;
+export declare const SiteThemeSchema: z.ZodObject<{
+    primaryColor: z.ZodOptional<z.ZodString>;
+    secondaryColor: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    backgroundColor: z.ZodOptional<z.ZodString>;
+    textColor: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    headingFontFamily: z.ZodOptional<z.ZodString>;
+    borderRadius: z.ZodDefault<z.ZodEnum<{
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        none: "none";
+        full: "full";
+    }>>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        auto: "auto";
+    }>>;
+    customVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SiteTheme = z.infer<typeof SiteThemeSchema>;
+export declare const SiteSeoSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodURL>;
+    twitterHandle: z.ZodOptional<z.ZodString>;
+    facebookAppId: z.ZodOptional<z.ZodString>;
+    googleSiteVerification: z.ZodOptional<z.ZodString>;
+    robots: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SiteSeo = z.infer<typeof SiteSeoSchema>;
+export declare const SiteSettingsSchema: z.ZodObject<{
+    domain: z.ZodOptional<z.ZodString>;
+    subdomain: z.ZodOptional<z.ZodString>;
+    language: z.ZodDefault<z.ZodString>;
+    supportedLanguages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    timezone: z.ZodDefault<z.ZodString>;
+    seo: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodURL>;
+        twitterHandle: z.ZodOptional<z.ZodString>;
+        facebookAppId: z.ZodOptional<z.ZodString>;
+        googleSiteVerification: z.ZodOptional<z.ZodString>;
+        robots: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    analyticsId: z.ZodOptional<z.ZodString>;
+    allowAgentEdits: z.ZodDefault<z.ZodBoolean>;
+    agentRestrictions: z.ZodOptional<z.ZodObject<{
+        canPublish: z.ZodDefault<z.ZodBoolean>;
+        canDeletePages: z.ZodDefault<z.ZodBoolean>;
+        canModifySettings: z.ZodDefault<z.ZodBoolean>;
+        protectedPages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    notFoundPageId: z.ZodOptional<z.ZodString>;
+    faviconUrl: z.ZodOptional<z.ZodURL>;
+    socialLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        platform: z.ZodString;
+        url: z.ZodURL;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SiteSettings = z.infer<typeof SiteSettingsSchema>;
+export declare const SiteCollaboratorSchema: z.ZodObject<{
+    userId: z.ZodString;
+    role: z.ZodEnum<{
+        admin: "admin";
+        editor: "editor";
+        viewer: "viewer";
+    }>;
+    addedAt: z.ZodString;
+    addedBy: z.ZodString;
+}, z.core.$strip>;
+export type SiteCollaborator = z.infer<typeof SiteCollaboratorSchema>;
+export declare const SiteSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    human: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        helpText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        semanticType: z.ZodString;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            vector: z.ZodArray<z.ZodNumber>;
+            dimension: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                custom: "custom";
+                readonly: "readonly";
+                pattern: "pattern";
+                required: "required";
+                immutable: "immutable";
+                range: "range";
+                dependency: "dependency";
+                capability: "capability";
+                permission: "permission";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            returns: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sideEffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            destructive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                dependency: "dependency";
+                parent: "parent";
+                child: "child";
+                sibling: "sibling";
+                reference: "reference";
+                related: "related";
+            }>;
+            targetId: z.ZodString;
+            targetType: z.ZodString;
+            weight: z.ZodDefault<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    ownerId: z.ZodString;
+    status: z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        maintenance: "maintenance";
+    }>;
+    settings: z.ZodObject<{
+        domain: z.ZodOptional<z.ZodString>;
+        subdomain: z.ZodOptional<z.ZodString>;
+        language: z.ZodDefault<z.ZodString>;
+        supportedLanguages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        timezone: z.ZodDefault<z.ZodString>;
+        seo: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodURL>;
+            twitterHandle: z.ZodOptional<z.ZodString>;
+            facebookAppId: z.ZodOptional<z.ZodString>;
+            googleSiteVerification: z.ZodOptional<z.ZodString>;
+            robots: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        analyticsId: z.ZodOptional<z.ZodString>;
+        allowAgentEdits: z.ZodDefault<z.ZodBoolean>;
+        agentRestrictions: z.ZodOptional<z.ZodObject<{
+            canPublish: z.ZodDefault<z.ZodBoolean>;
+            canDeletePages: z.ZodDefault<z.ZodBoolean>;
+            canModifySettings: z.ZodDefault<z.ZodBoolean>;
+            protectedPages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        notFoundPageId: z.ZodOptional<z.ZodString>;
+        faviconUrl: z.ZodOptional<z.ZodURL>;
+        socialLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            platform: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    collaborators: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        role: z.ZodEnum<{
+            admin: "admin";
+            editor: "editor";
+            viewer: "viewer";
+        }>;
+        addedAt: z.ZodString;
+        addedBy: z.ZodString;
+    }, z.core.$strip>>>;
+    templateId: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodObject<{
+        primaryColor: z.ZodOptional<z.ZodString>;
+        secondaryColor: z.ZodOptional<z.ZodString>;
+        accentColor: z.ZodOptional<z.ZodString>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        textColor: z.ZodOptional<z.ZodString>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        headingFontFamily: z.ZodOptional<z.ZodString>;
+        borderRadius: z.ZodDefault<z.ZodEnum<{
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            none: "none";
+            full: "full";
+        }>>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            auto: "auto";
+        }>>;
+        customVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    pageCount: z.ZodDefault<z.ZodNumber>;
+    publishedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Site = z.infer<typeof SiteSchema>;
+export declare const CreateSiteInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    ownerId: z.ZodString;
+    templateId: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodObject<{
+        domain: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        subdomain: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        language: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        supportedLanguages: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        timezone: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        seo: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodURL>;
+            twitterHandle: z.ZodOptional<z.ZodString>;
+            facebookAppId: z.ZodOptional<z.ZodString>;
+            googleSiteVerification: z.ZodOptional<z.ZodString>;
+            robots: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        analyticsId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        allowAgentEdits: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        agentRestrictions: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            canPublish: z.ZodDefault<z.ZodBoolean>;
+            canDeletePages: z.ZodDefault<z.ZodBoolean>;
+            canModifySettings: z.ZodDefault<z.ZodBoolean>;
+            protectedPages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        notFoundPageId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        faviconUrl: z.ZodOptional<z.ZodOptional<z.ZodURL>>;
+        socialLinks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            platform: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+    theme: z.ZodOptional<z.ZodObject<{
+        primaryColor: z.ZodOptional<z.ZodString>;
+        secondaryColor: z.ZodOptional<z.ZodString>;
+        accentColor: z.ZodOptional<z.ZodString>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        textColor: z.ZodOptional<z.ZodString>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        headingFontFamily: z.ZodOptional<z.ZodString>;
+        borderRadius: z.ZodDefault<z.ZodEnum<{
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            none: "none";
+            full: "full";
+        }>>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            auto: "auto";
+        }>>;
+        customVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateSiteInput = z.infer<typeof CreateSiteInputSchema>;
+/**
+ * Creates a new site with dual representation
+ */
+export declare function createSite(id: string, input: CreateSiteInput): Site;
+export declare const UpdateSiteInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        maintenance: "maintenance";
+    }>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        domain: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        subdomain: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        language: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        supportedLanguages: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        timezone: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        seo: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodURL>;
+            twitterHandle: z.ZodOptional<z.ZodString>;
+            facebookAppId: z.ZodOptional<z.ZodString>;
+            googleSiteVerification: z.ZodOptional<z.ZodString>;
+            robots: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        analyticsId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        allowAgentEdits: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        agentRestrictions: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            canPublish: z.ZodDefault<z.ZodBoolean>;
+            canDeletePages: z.ZodDefault<z.ZodBoolean>;
+            canModifySettings: z.ZodDefault<z.ZodBoolean>;
+            protectedPages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        notFoundPageId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        faviconUrl: z.ZodOptional<z.ZodOptional<z.ZodURL>>;
+        socialLinks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            platform: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+    theme: z.ZodOptional<z.ZodObject<{
+        primaryColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        secondaryColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        accentColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        backgroundColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        textColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        fontFamily: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        headingFontFamily: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        borderRadius: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            none: "none";
+            full: "full";
+        }>>>;
+        mode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+            auto: "auto";
+        }>>>;
+        customVariables: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UpdateSiteInput = z.infer<typeof UpdateSiteInputSchema>;
+/**
+ * Checks if a user has permission to perform an action on a site
+ */
+export declare function canUserPerformAction(site: Site, userId: string, action: 'view' | 'edit' | 'admin' | 'delete'): boolean;
+/**
+ * Checks if an agent can edit this site
+ */
+export declare function canAgentEditSite(site: Site): boolean;
+//# sourceMappingURL=site.d.ts.map

package/dist/entities/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/entities/site.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAe1B,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAMpC,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAMzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;iBA6C1B,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAMvD,eAAO,MAAM,aAAa;;;;;;;;iBAqBxB,CAAA;AAEF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAMnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyD7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAM7D,eAAO,MAAM,sBAAsB;;;;;;;;;iBAKjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAMrE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwCrB,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAM7C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CA2GnE;AAMD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMnE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAC3C,OAAO,CAkBT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEpD"}