@angriff36/manifest 2.18.0

package/dist/manifest/projections/sveltekit/generator.js

@@ -0,0 +1,1043 @@
+/**
+ * SvelteKit projection for Manifest IR.
+ *
+ * Generates SvelteKit server routes (+server.ts) and load functions
+ * (+page.server.ts) from IR commands and entity reads. Mirrors the
+ * Next.js App Router projection but targets SvelteKit conventions:
+ *
+ *   - +server.ts            → API route (GET/POST) emitting `RequestHandler`s
+ *   - +page.server.ts       → `PageServerLoad` for SSR data and form `actions`
+ *   - $lib/* aliases        → `src/lib` imports
+ *   - type-safe `PageData`  → via the generated `./$types` module
+ *
+ * Surfaces:
+ *   - sveltekit.server  → +server.ts for an entity (GET list/detail, POST dispatch)
+ *   - sveltekit.load    → +page.server.ts (`load` + `actions`) for an entity page
+ *   - sveltekit.command → +server.ts dedicated to a single command POST
+ *   - sveltekit.types   → TypeScript types for entities, commands, results
+ *   - sveltekit.client  → $lib client utilities (response helpers, fetch wrappers)
+ *
+ * Writes always flow through the Manifest runtime so guards, policies,
+ * and constraints stay authoritative. Reads MAY bypass the runtime for
+ * performance (Prisma-style direct queries) when a database client is
+ * configured.
+ *
+ * Registers as the `sveltekit` projection in the canonical registry.
+ */
+// ============================================================================
+// Surface constants
+// ============================================================================
+const SURFACE_SERVER = 'sveltekit.server';
+const SURFACE_LOAD = 'sveltekit.load';
+const SURFACE_COMMAND = 'sveltekit.command';
+const SURFACE_TYPES = 'sveltekit.types';
+const SURFACE_CLIENT = 'sveltekit.client';
+const SURFACES = [
+    SURFACE_SERVER,
+    SURFACE_LOAD,
+    SURFACE_COMMAND,
+    SURFACE_TYPES,
+    SURFACE_CLIENT,
+];
+/**
+ * Default values for the SvelteKit projection.
+ */
+export const SVELTEKIT_DEFAULTS = {
+    authProvider: 'lucia',
+    authImportPath: '$lib/server/auth',
+    runtimeImportPath: '$lib/server/manifest-runtime',
+    runtimeFactoryName: 'createManifestRuntime',
+    databaseImportPath: '$lib/server/database',
+    routesDir: 'src/routes',
+    includeTenantFilter: true,
+    includeSoftDeleteFilter: true,
+    tenantIdProperty: 'tenantId',
+    deletedAtProperty: 'deletedAt',
+    strictMode: true,
+    includeComments: true,
+    unauthorizedStatus: 401,
+    emitFormActions: true,
+    emitTypeImports: true,
+};
+function normalizeOptions(opts = {}) {
+    return {
+        authProvider: opts.authProvider ?? SVELTEKIT_DEFAULTS.authProvider,
+        authImportPath: opts.authImportPath ?? SVELTEKIT_DEFAULTS.authImportPath,
+        runtimeImportPath: opts.runtimeImportPath ?? SVELTEKIT_DEFAULTS.runtimeImportPath,
+        runtimeFactoryName: opts.runtimeFactoryName ?? SVELTEKIT_DEFAULTS.runtimeFactoryName,
+        databaseImportPath: opts.databaseImportPath ?? SVELTEKIT_DEFAULTS.databaseImportPath,
+        validationImportPath: opts.validationImportPath,
+        routesDir: opts.routesDir ?? SVELTEKIT_DEFAULTS.routesDir,
+        includeTenantFilter: opts.includeTenantFilter ?? SVELTEKIT_DEFAULTS.includeTenantFilter,
+        includeSoftDeleteFilter: opts.includeSoftDeleteFilter ?? SVELTEKIT_DEFAULTS.includeSoftDeleteFilter,
+        tenantIdProperty: opts.tenantIdProperty ?? SVELTEKIT_DEFAULTS.tenantIdProperty,
+        deletedAtProperty: opts.deletedAtProperty ?? SVELTEKIT_DEFAULTS.deletedAtProperty,
+        strictMode: opts.strictMode ?? SVELTEKIT_DEFAULTS.strictMode,
+        includeComments: opts.includeComments ?? SVELTEKIT_DEFAULTS.includeComments,
+        unauthorizedStatus: opts.unauthorizedStatus ?? SVELTEKIT_DEFAULTS.unauthorizedStatus,
+        tenantProvider: opts.tenantProvider,
+        emitFormActions: opts.emitFormActions ?? SVELTEKIT_DEFAULTS.emitFormActions,
+        emitTypeImports: opts.emitTypeImports ?? SVELTEKIT_DEFAULTS.emitTypeImports,
+        generatedAt: opts.generatedAt ?? new Date().toISOString(),
+    };
+}
+// ============================================================================
+// Naming helpers
+// ============================================================================
+function toPascalCase(value) {
+    if (!value)
+        return value;
+    return value[0].toUpperCase() + value.slice(1);
+}
+function toLowerCamelCase(value) {
+    if (!value)
+        return value;
+    return value[0].toLowerCase() + value.slice(1);
+}
+function toKebabCase(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/\s+/g, '-')
+        .toLowerCase();
+}
+function toRouteSegment(value) {
+    return toKebabCase(value);
+}
+// ============================================================================
+// Type mapping: IR type → TypeScript
+// ============================================================================
+function irTypeToTs(irType) {
+    const baseMap = {
+        string: 'string',
+        number: 'number',
+        integer: 'number',
+        int: 'number',
+        boolean: 'boolean',
+        bool: 'boolean',
+        date: 'string',
+        datetime: 'string',
+        uuid: 'string',
+        email: 'string',
+        url: 'string',
+        uri: 'string',
+        any: 'unknown',
+        object: 'Record<string, unknown>',
+        decimal: 'string',
+        void: 'void',
+    };
+    let base;
+    if (irType.name === 'array' && irType.generic) {
+        base = `${irTypeToTs(irType.generic)}[]`;
+    }
+    else if (irType.name === 'map' && irType.generic) {
+        base = `Record<string, ${irTypeToTs(irType.generic)}>`;
+    }
+    else if (irType.name === 'record') {
+        base = 'Record<string, unknown>';
+    }
+    else {
+        base = baseMap[irType.name] ?? 'unknown';
+    }
+    return irType.nullable ? `${base} | null` : base;
+}
+// ============================================================================
+// Expression / value pretty-printer (for header comments only)
+// ============================================================================
+function irValueToJson(value) {
+    switch (value.kind) {
+        case 'string':
+            return value.value;
+        case 'number':
+            return value.value;
+        case 'boolean':
+            return value.value;
+        case 'null':
+            return null;
+        case 'array':
+            return value.elements.map(irValueToJson);
+        case 'object': {
+            const obj = {};
+            for (const [k, v] of Object.entries(value.properties)) {
+                obj[k] = irValueToJson(v);
+            }
+            return obj;
+        }
+    }
+}
+function expressionToString(expr) {
+    switch (expr.kind) {
+        case 'literal':
+            return JSON.stringify(irValueToJson(expr.value));
+        case 'identifier':
+            return expr.name;
+        case 'member':
+            return `${expressionToString(expr.object)}.${expr.property}`;
+        case 'binary':
+            return `${expressionToString(expr.left)} ${expr.operator} ${expressionToString(expr.right)}`;
+        case 'unary':
+            return `${expr.operator}${expressionToString(expr.operand)}`;
+        case 'call':
+            return `${expressionToString(expr.callee)}(${expr.args.map(expressionToString).join(', ')})`;
+        case 'conditional':
+            return `${expressionToString(expr.condition)} ? ${expressionToString(expr.consequent)} : ${expressionToString(expr.alternate)}`;
+        case 'array':
+            return `[${expr.elements.map(expressionToString).join(', ')}]`;
+        case 'object':
+            return `{${expr.properties
+                .map((p) => `${p.key}: ${expressionToString(p.value)}`)
+                .join(', ')}}`;
+        case 'lambda':
+            return `(${expr.params.join(', ')}) => ${expressionToString(expr.body)}`;
+        default:
+            return String(expr);
+    }
+}
+// ============================================================================
+// Header
+// ============================================================================
+function emitHeader(options, target) {
+    if (!options.includeComments)
+        return '';
+    return [
+        '/**',
+        ` * Auto-generated SvelteKit ${target}`,
+        ' * Generated from Manifest IR — DO NOT EDIT',
+        ` * Generated at: ${options.generatedAt}`,
+        ' *',
+        ' * Writes flow through the Manifest runtime to enforce',
+        ' * guards, policies, and constraints. Reads MAY bypass the runtime',
+        ' * when a database client is configured.',
+        ' *',
+        ' * Regenerate with: manifest generate <ir> -p sveltekit',
+        ' */',
+        '',
+    ].join('\n');
+}
+// ============================================================================
+// Auth import / body generation
+// ============================================================================
+function generateAuthImports(options) {
+    switch (options.authProvider) {
+        case 'lucia':
+            return `import { lucia } from "${options.authImportPath}";`;
+        case 'auth-js':
+            return `import { getServerSession } from "${options.authImportPath}";`;
+        case 'custom':
+            return `import { requireUser } from "${options.authImportPath}";`;
+        case 'none':
+        default:
+            return '';
+    }
+}
+/**
+ * Auth body for `+server.ts` style handlers (using `event.locals`/`event.request`).
+ * Produces lines that resolve a `userId` (and optionally `orgId`) plus an
+ * unauthorized short-circuit returning the configured status code.
+ */
+function generateServerAuthBody(options) {
+    const status = options.unauthorizedStatus;
+    switch (options.authProvider) {
+        case 'lucia':
+            return [
+                `  const session = event.locals.session;`,
+                `  if (!session?.user?.id) {`,
+                `    return json({ error: "Unauthorized", diagnostics: [] }, { status: ${status} });`,
+                `  }`,
+                `  const userId = session.user.id;`,
+            ].join('\n');
+        case 'auth-js':
+            return [
+                `  const session = await getServerSession(event);`,
+                `  if (!session?.user?.id) {`,
+                `    return json({ error: "Unauthorized", diagnostics: [] }, { status: ${status} });`,
+                `  }`,
+                `  const userId = session.user.id;`,
+            ].join('\n');
+        case 'custom':
+            return [
+                `  const user = await requireUser(event);`,
+                `  if (!user?.id) {`,
+                `    return json({ error: "Unauthorized", diagnostics: [] }, { status: ${status} });`,
+                `  }`,
+                `  const userId = user.id;`,
+            ].join('\n');
+        case 'none':
+        default:
+            return [
+                `  // Auth disabled — all requests allowed`,
+                `  const userId = "anonymous";`,
+            ].join('\n');
+    }
+}
+/**
+ * Auth body for `+page.server.ts` style loaders (`load` and form `actions`).
+ * Uses redirect/error helpers instead of inline JSON responses since the
+ * SvelteKit convention is to throw `redirect()` / `error()` from server load
+ * functions.
+ */
+function generateLoadAuthBody(options) {
+    const status = options.unauthorizedStatus;
+    switch (options.authProvider) {
+        case 'lucia':
+            return [
+                `  const session = event.locals.session;`,
+                `  if (!session?.user?.id) {`,
+                `    throw redirect(${status === 401 ? '302' : status}, "/login");`,
+                `  }`,
+                `  const userId = session.user.id;`,
+            ].join('\n');
+        case 'auth-js':
+            return [
+                `  const session = await getServerSession(event);`,
+                `  if (!session?.user?.id) {`,
+                `    throw redirect(${status === 401 ? '302' : status}, "/login");`,
+                `  }`,
+                `  const userId = session.user.id;`,
+            ].join('\n');
+        case 'custom':
+            return [
+                `  const user = await requireUser(event);`,
+                `  if (!user?.id) {`,
+                `    throw redirect(${status === 401 ? '302' : status}, "/login");`,
+                `  }`,
+                `  const userId = user.id;`,
+            ].join('\n');
+        case 'none':
+        default:
+            return [
+                `  // Auth disabled — all requests allowed`,
+                `  const userId = "anonymous";`,
+            ].join('\n');
+    }
+}
+// ============================================================================
+// Tenant resolution
+// ============================================================================
+function generateTenantLookup(options, jsonReturn) {
+    if (!options.includeTenantFilter)
+        return '';
+    if (options.tenantProvider) {
+        const { functionName, lookupKey } = options.tenantProvider;
+        return [
+            ``,
+            `  const ${options.tenantIdProperty} = await ${functionName}(${lookupKey});`,
+            `  if (!${options.tenantIdProperty}) {`,
+            jsonReturn
+                ? `    return json({ error: "Tenant not found", diagnostics: [] }, { status: 400 });`
+                : `    throw error(400, "Tenant not found");`,
+            `  }`,
+        ].join('\n');
+    }
+    return [
+        ``,
+        `  const userMapping = await database.userTenantMapping.findUnique({`,
+        `    where: { userId },`,
+        `  });`,
+        `  if (!userMapping) {`,
+        jsonReturn
+            ? `    return json({ error: "User not mapped to tenant", diagnostics: [] }, { status: 400 });`
+            : `    throw error(400, "User not mapped to tenant");`,
+        `  }`,
+        `  const { ${options.tenantIdProperty} } = userMapping;`,
+    ].join('\n');
+}
+// ============================================================================
+// Prisma-style direct read helpers
+// ============================================================================
+function entityHasProperty(entity, propertyName) {
+    return entity.properties.some((p) => p.name === propertyName);
+}
+function generateListReadQuery(entity, options) {
+    const delegate = toLowerCamelCase(entity.name);
+    const variable = `${delegate}s`;
+    const conditions = [];
+    if (options.includeTenantFilter) {
+        conditions.push(options.tenantIdProperty);
+    }
+    if (options.includeSoftDeleteFilter &&
+        entityHasProperty(entity, options.deletedAtProperty)) {
+        conditions.push(`${options.deletedAtProperty}: null`);
+    }
+    const whereClause = conditions.length
+        ? `where: { ${conditions.join(', ')} },`
+        : '';
+    const orderByField = entityHasProperty(entity, 'createdAt') ? 'createdAt' : 'id';
+    return [
+        `  const ${variable} = await database.${delegate}.findMany({`,
+        `    ${whereClause}`,
+        `    orderBy: { ${orderByField}: "desc" },`,
+        `  });`,
+    ].join('\n');
+}
+// ============================================================================
+// Command comment block
+// ============================================================================
+function generateCommandComment(command, entity, policies) {
+    const lines = [];
+    lines.push('  /**');
+    lines.push(`   * ${toPascalCase(command.name)} command for ${entity.name}.`);
+    if (command.guards.length > 0) {
+        lines.push(`   * Guards: ${command.guards.length} (evaluated in order, halts on first failure)`);
+        for (let i = 0; i < command.guards.length; i++) {
+            lines.push(`   *   [${i}] ${expressionToString(command.guards[i])}`);
+        }
+    }
+    if (command.constraints && command.constraints.length > 0) {
+        lines.push(`   * Constraints: ${command.constraints.length}`);
+    }
+    const entityPolicies = policies.filter((p) => p.entity === entity.name);
+    if (entityPolicies.length > 0) {
+        lines.push(`   * Policies: ${entityPolicies.map((p) => p.name).join(', ')}`);
+    }
+    if (command.emits.length > 0) {
+        lines.push(`   * Emits: ${command.emits.join(', ')}`);
+    }
+    lines.push('   */');
+    return lines.join('\n');
+}
+function generateImports(options, flags) {
+    const lines = [];
+    // SvelteKit core helpers
+    const skitParts = [];
+    if (flags.includeJson)
+        skitParts.push('json');
+    if (flags.includeError)
+        skitParts.push('error');
+    if (flags.includeRedirect)
+        skitParts.push('redirect');
+    if (flags.includeFail)
+        skitParts.push('fail');
+    if (skitParts.length > 0) {
+        lines.push(`import { ${skitParts.join(', ')} } from "@sveltejs/kit";`);
+    }
+    // Type-only imports from generated ./$types module
+    if (options.emitTypeImports && flags.includeTypes !== 'none') {
+        if (flags.includeTypes === 'server') {
+            lines.push(`import type { RequestHandler } from "./$types";`);
+        }
+        else {
+            lines.push(`import type { Actions, PageServerLoad } from "./$types";`);
+        }
+    }
+    // Database (for direct reads)
+    if (flags.includeDatabase) {
+        lines.push(`import { database } from "${options.databaseImportPath}";`);
+    }
+    // Runtime factory (for writes / command dispatch)
+    if (flags.includeRuntime) {
+        lines.push(`import { ${options.runtimeFactoryName} } from "${options.runtimeImportPath}";`);
+    }
+    // Auth provider import
+    const authImport = generateAuthImports(options);
+    if (authImport)
+        lines.push(authImport);
+    if (lines.length > 0)
+        lines.push('');
+    return lines.join('\n');
+}
+// ============================================================================
+// +server.ts generator (sveltekit.server)
+// ============================================================================
+function generateServerFile(entity, ir, options) {
+    const lines = [];
+    lines.push(emitHeader(options, `+server.ts route for ${entity.name}`));
+    lines.push(generateImports(options, {
+        includeJson: true,
+        includeError: false,
+        includeRedirect: false,
+        includeFail: false,
+        includeRuntime: true,
+        includeDatabase: true,
+        includeTypes: 'server',
+    }));
+    // GET → list
+    lines.push(`/**`);
+    lines.push(` * GET /${toRouteSegment(entity.name)} — list ${entity.name} entities`);
+    lines.push(` */`);
+    lines.push(`export const GET: RequestHandler = async (event) => {`);
+    lines.push('  try {');
+    lines.push(generateServerAuthBody(options));
+    const listTenant = generateTenantLookup(options, /* jsonReturn */ true);
+    if (listTenant)
+        lines.push(listTenant);
+    lines.push('');
+    lines.push(generateListReadQuery(entity, options));
+    lines.push('');
+    lines.push(`    return json({ ${toLowerCamelCase(entity.name)}s });`);
+    lines.push('  } catch (err) {');
+    lines.push(`    console.error("Error fetching ${toLowerCamelCase(entity.name)}s:", err);`);
+    lines.push('    return json(');
+    lines.push('      { error: "Internal server error", diagnostics: [] },');
+    lines.push('      { status: 500 }');
+    lines.push('    );');
+    lines.push('  }');
+    lines.push('};');
+    lines.push('');
+    // POST → dispatch a command on this entity
+    // Body shape: { command: string, params?: object, instanceId?: string }
+    const entityCommands = ir.commands
+        .filter((c) => c.entity === entity.name)
+        .map((c) => c.name);
+    lines.push(`/**`);
+    lines.push(` * POST /${toRouteSegment(entity.name)} — dispatch a Manifest command on ${entity.name}.`);
+    if (entityCommands.length > 0) {
+        lines.push(` * Available commands: ${entityCommands.join(', ')}`);
+    }
+    lines.push(' * Body: { command: string, params?: object, instanceId?: string }');
+    lines.push(` */`);
+    lines.push(`export const POST: RequestHandler = async (event) => {`);
+    lines.push('  try {');
+    lines.push(generateServerAuthBody(options));
+    const writeTenant = generateTenantLookup(options, /* jsonReturn */ true);
+    if (writeTenant)
+        lines.push(writeTenant);
+    lines.push('');
+    lines.push('    const body = await event.request.json();');
+    lines.push('    const { command, params, instanceId } = body ?? {};');
+    lines.push('    if (typeof command !== "string" || command.length === 0) {');
+    lines.push('      return json(');
+    lines.push('        { error: "Missing command name", diagnostics: [] },');
+    lines.push('        { status: 400 }');
+    lines.push('      );');
+    lines.push('    }');
+    lines.push('');
+    const userCtx = options.includeTenantFilter
+        ? `{ user: { id: userId, ${options.tenantIdProperty} } }`
+        : `{ user: { id: userId } }`;
+    lines.push(`    const runtime = await ${options.runtimeFactoryName}(${userCtx});`);
+    lines.push(`    const result = await runtime.runCommand("${entity.name}", command, {`);
+    lines.push('      params: params ?? {},');
+    lines.push('      instanceId,');
+    lines.push('    });');
+    lines.push('');
+    lines.push('    if (!result.success) {');
+    lines.push('      const firstDiagnostic = result.diagnostics?.[0];');
+    lines.push('      const status = firstDiagnostic?.kind === "policy_denial" ? 403');
+    lines.push('        : firstDiagnostic?.kind === "guard_failure" ? 422');
+    lines.push('        : firstDiagnostic?.kind === "constraint_block" ? 422');
+    lines.push('        : firstDiagnostic?.kind === "concurrency_conflict" ? 409');
+    lines.push('        : 400;');
+    lines.push('      return json(');
+    lines.push('        { error: result.error, diagnostics: result.diagnostics },');
+    lines.push('        { status }');
+    lines.push('      );');
+    lines.push('    }');
+    lines.push('');
+    lines.push('    return json({');
+    lines.push('      data: result.data,');
+    lines.push('      events: result.events,');
+    lines.push('      diagnostics: result.diagnostics,');
+    lines.push('    });');
+    lines.push('  } catch (err) {');
+    lines.push(`    console.error("Error dispatching command on ${entity.name}:", err);`);
+    lines.push('    return json(');
+    lines.push('      { error: "Internal server error", diagnostics: [] },');
+    lines.push('      { status: 500 }');
+    lines.push('    );');
+    lines.push('  }');
+    lines.push('};');
+    lines.push('');
+    return lines.join('\n');
+}
+// ============================================================================
+// +page.server.ts generator (sveltekit.load)
+// ============================================================================
+function generateLoadFile(entity, ir, options) {
+    const lines = [];
+    lines.push(emitHeader(options, `+page.server.ts loader for ${entity.name}`));
+    lines.push(generateImports(options, {
+        includeJson: false,
+        includeError: true,
+        includeRedirect: true,
+        includeFail: options.emitFormActions,
+        includeRuntime: options.emitFormActions,
+        includeDatabase: true,
+        includeTypes: 'load',
+    }));
+    // load function
+    const variable = `${toLowerCamelCase(entity.name)}s`;
+    lines.push(`/**`);
+    lines.push(` * SvelteKit PageServerLoad for the ${entity.name} list page. Returns`);
+    lines.push(' * type-safe `PageData` consumed by the corresponding +page.svelte.');
+    lines.push(` */`);
+    lines.push(`export const load: PageServerLoad = async (event) => {`);
+    lines.push(generateLoadAuthBody(options));
+    const loadTenant = generateTenantLookup(options, /* jsonReturn */ false);
+    if (loadTenant)
+        lines.push(loadTenant);
+    lines.push('');
+    lines.push(generateListReadQuery(entity, options));
+    lines.push('');
+    lines.push(`  return { ${variable} };`);
+    lines.push(`};`);
+    lines.push('');
+    if (options.emitFormActions) {
+        const entityCommands = ir.commands
+            .filter((c) => c.entity === entity.name)
+            .sort((a, b) => a.name.localeCompare(b.name));
+        lines.push(`/**`);
+        lines.push(' * SvelteKit form actions — POST-only handlers backing progressive');
+        lines.push(' * enhancement <form action="?/commandName" method="POST"> submissions.');
+        lines.push(' * Each action validates input via the Manifest runtime so guards, policies,');
+        lines.push(' * and constraints remain authoritative.');
+        lines.push(` */`);
+        lines.push('export const actions: Actions = {');
+        if (entityCommands.length === 0) {
+            lines.push('  // No commands declared for this entity.');
+        }
+        for (const command of entityCommands) {
+            lines.push(generateCommandComment(command, entity, ir.policies));
+            lines.push(`  ${command.name}: async (event) => {`);
+            lines.push('    try {');
+            lines.push(generateServerAuthBody(options));
+            const actionTenant = generateTenantLookup(options, /* jsonReturn */ true);
+            if (actionTenant)
+                lines.push(actionTenant);
+            lines.push('');
+            lines.push('      const formData = await event.request.formData();');
+            lines.push('      const params = Object.fromEntries(formData);');
+            lines.push('      const instanceId =');
+            lines.push('        (typeof params.instanceId === "string" ? params.instanceId : undefined) ??');
+            lines.push('        (typeof params.id === "string" ? params.id : undefined);');
+            lines.push('');
+            const userCtx = options.includeTenantFilter
+                ? `{ user: { id: userId, ${options.tenantIdProperty} } }`
+                : `{ user: { id: userId } }`;
+            lines.push(`      const runtime = await ${options.runtimeFactoryName}(${userCtx});`);
+            lines.push(`      const result = await runtime.runCommand("${entity.name}", "${command.name}", {`);
+            lines.push('        params,');
+            lines.push('        instanceId,');
+            lines.push('      });');
+            lines.push('');
+            lines.push('      if (!result.success) {');
+            lines.push('        const firstDiagnostic = result.diagnostics?.[0];');
+            lines.push('        const status = firstDiagnostic?.kind === "policy_denial" ? 403');
+            lines.push('          : firstDiagnostic?.kind === "guard_failure" ? 422');
+            lines.push('          : firstDiagnostic?.kind === "constraint_block" ? 422');
+            lines.push('          : firstDiagnostic?.kind === "concurrency_conflict" ? 409');
+            lines.push('          : 400;');
+            lines.push('        return fail(status, {');
+            lines.push('          error: result.error,');
+            lines.push('          diagnostics: result.diagnostics,');
+            lines.push('        });');
+            lines.push('      }');
+            lines.push('');
+            lines.push('      return {');
+            lines.push('        success: true,');
+            lines.push('        data: result.data,');
+            lines.push('        events: result.events,');
+            lines.push('        diagnostics: result.diagnostics,');
+            lines.push('      };');
+            lines.push('    } catch (err) {');
+            lines.push(`      console.error("Error executing ${command.name}:", err);`);
+            lines.push('      return fail(500, {');
+            lines.push('        error: "Internal server error",');
+            lines.push('        diagnostics: [],');
+            lines.push('      });');
+            lines.push('    }');
+            lines.push('  },');
+            lines.push('');
+        }
+        lines.push('};');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// +server.ts dedicated command route (sveltekit.command)
+// ============================================================================
+function generateCommandServerFile(entity, command, ir, options) {
+    const lines = [];
+    lines.push(emitHeader(options, `+server.ts route for ${entity.name}.${command.name}`));
+    lines.push(generateImports(options, {
+        includeJson: true,
+        includeError: false,
+        includeRedirect: false,
+        includeFail: false,
+        includeRuntime: true,
+        includeDatabase: false,
+        includeTypes: 'server',
+    }));
+    lines.push(generateCommandComment(command, entity, ir.policies).replace(/^ {2}/gm, ''));
+    lines.push(`export const POST: RequestHandler = async (event) => {`);
+    lines.push('  try {');
+    lines.push(generateServerAuthBody(options));
+    const cmdTenant = generateTenantLookup(options, /* jsonReturn */ true);
+    if (cmdTenant)
+        lines.push(cmdTenant);
+    lines.push('');
+    lines.push('    const body = await event.request.json().catch(() => ({}));');
+    lines.push('    const instanceId =');
+    lines.push('      (typeof body?.instanceId === "string" ? body.instanceId : undefined) ??');
+    lines.push('      (typeof body?.id === "string" ? body.id : undefined);');
+    lines.push('');
+    const userCtx = options.includeTenantFilter
+        ? `{ user: { id: userId, ${options.tenantIdProperty} } }`
+        : `{ user: { id: userId } }`;
+    lines.push(`    const runtime = await ${options.runtimeFactoryName}(${userCtx});`);
+    lines.push(`    const result = await runtime.runCommand("${entity.name}", "${command.name}", {`);
+    lines.push('      params: body ?? {},');
+    lines.push('      instanceId,');
+    lines.push('    });');
+    lines.push('');
+    lines.push('    if (!result.success) {');
+    lines.push('      const firstDiagnostic = result.diagnostics?.[0];');
+    lines.push('      const status = firstDiagnostic?.kind === "policy_denial" ? 403');
+    lines.push('        : firstDiagnostic?.kind === "guard_failure" ? 422');
+    lines.push('        : firstDiagnostic?.kind === "constraint_block" ? 422');
+    lines.push('        : firstDiagnostic?.kind === "concurrency_conflict" ? 409');
+    lines.push('        : 400;');
+    lines.push('      return json(');
+    lines.push('        { error: result.error, diagnostics: result.diagnostics },');
+    lines.push('        { status }');
+    lines.push('      );');
+    lines.push('    }');
+    lines.push('');
+    lines.push('    return json({');
+    lines.push('      data: result.data,');
+    lines.push('      events: result.events,');
+    lines.push('      diagnostics: result.diagnostics,');
+    lines.push('    });');
+    lines.push('  } catch (err) {');
+    lines.push(`    console.error("Error executing ${entity.name}.${command.name}:", err);`);
+    lines.push('    return json(');
+    lines.push('      { error: "Internal server error", diagnostics: [] },');
+    lines.push('      { status: 500 }');
+    lines.push('    );');
+    lines.push('  }');
+    lines.push('};');
+    lines.push('');
+    return lines.join('\n');
+}
+// ============================================================================
+// sveltekit.types — entity / command / result types
+// ============================================================================
+function generateEntityInterface(entity) {
+    const lines = [];
+    lines.push(`export interface ${entity.name} {`);
+    for (const prop of entity.properties) {
+        const optional = prop.modifiers.includes('optional') ||
+            prop.defaultValue !== undefined ||
+            prop.type.nullable;
+        const sigil = optional ? '?' : '';
+        lines.push(`  ${prop.name}${sigil}: ${irTypeToTs(prop.type)};`);
+    }
+    for (const computed of entity.computedProperties) {
+        lines.push(`  readonly ${computed.name}: ${irTypeToTs(computed.type)};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function generateCommandParamsInterface(command) {
+    const lines = [];
+    const entity = command.entity ?? 'Unknown';
+    const name = `${toPascalCase(entity)}${toPascalCase(command.name)}Params`;
+    lines.push(`export interface ${name} {`);
+    for (const param of command.parameters) {
+        const sigil = param.required ? '' : '?';
+        lines.push(`  ${param.name}${sigil}: ${irTypeToTs(param.type)};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function generateTypesFile(ir, options) {
+    const lines = [];
+    lines.push(emitHeader(options, 'TypeScript types for SvelteKit routes'));
+    lines.push('/** Diagnostic emitted by the Manifest runtime when a command fails. */');
+    lines.push('export interface ManifestDiagnostic {');
+    lines.push('  kind: string;');
+    lines.push('  message: string;');
+    lines.push('  [key: string]: unknown;');
+    lines.push('}');
+    lines.push('');
+    lines.push('/** Standardized success payload returned by +server.ts POST handlers. */');
+    lines.push('export interface ManifestActionResult<T = unknown> {');
+    lines.push('  success: boolean;');
+    lines.push('  data?: T;');
+    lines.push('  error?: string;');
+    lines.push('  events?: unknown[];');
+    lines.push('  diagnostics?: ManifestDiagnostic[];');
+    lines.push('}');
+    lines.push('');
+    const sortedEntities = [...ir.entities].sort((a, b) => a.name.localeCompare(b.name));
+    for (const entity of sortedEntities) {
+        lines.push(generateEntityInterface(entity));
+        lines.push('');
+    }
+    const sortedCommands = [...ir.commands]
+        .filter((c) => c.parameters.length > 0)
+        .sort((a, b) => {
+        const ak = `${a.entity ?? ''}.${a.name}`;
+        const bk = `${b.entity ?? ''}.${b.name}`;
+        return ak.localeCompare(bk);
+    });
+    for (const command of sortedCommands) {
+        lines.push(generateCommandParamsInterface(command));
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+// ============================================================================
+// sveltekit.client — $lib client utilities
+// ============================================================================
+function generateClientFile(options) {
+    const lines = [];
+    lines.push(emitHeader(options, '$lib client utilities for SvelteKit'));
+    lines.push('import type { ManifestActionResult, ManifestDiagnostic } from "./manifest-types";');
+    lines.push('');
+    lines.push('/**');
+    lines.push(' * Invoke a Manifest command via the SvelteKit +server.ts dispatch route.');
+    lines.push(' * Use this from client components after `enhance` is not appropriate.');
+    lines.push(' */');
+    lines.push('export async function invokeManifestCommand<T = unknown>(');
+    lines.push('  entity: string,');
+    lines.push('  command: string,');
+    lines.push('  params: Record<string, unknown> = {},');
+    lines.push('  instanceId?: string,');
+    lines.push('  fetchImpl: typeof fetch = fetch,');
+    lines.push('): Promise<ManifestActionResult<T>> {');
+    lines.push('  const segment = entity');
+    lines.push('    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")');
+    lines.push('    .toLowerCase();');
+    lines.push('  const response = await fetchImpl(`/${segment}`, {');
+    lines.push('    method: "POST",');
+    lines.push('    headers: { "Content-Type": "application/json" },');
+    lines.push('    body: JSON.stringify({ command, params, instanceId }),');
+    lines.push('  });');
+    lines.push('  const payload = (await response.json().catch(() => ({}))) as ManifestActionResult<T>;');
+    lines.push('  if (!response.ok && payload.success === undefined) {');
+    lines.push('    return {');
+    lines.push('      success: false,');
+    lines.push('      error: (payload as unknown as { error?: string }).error ?? response.statusText,');
+    lines.push('      diagnostics: (payload as unknown as { diagnostics?: ManifestDiagnostic[] }).diagnostics ?? [],');
+    lines.push('    };');
+    lines.push('  }');
+    lines.push('  return payload;');
+    lines.push('}');
+    lines.push('');
+    lines.push('/**');
+    lines.push(' * Normalize a runtime command result into the ManifestActionResult shape.');
+    lines.push(' */');
+    lines.push('export function normalizeCommandResult<T = unknown>(');
+    lines.push('  result: unknown,');
+    lines.push('): ManifestActionResult<T> {');
+    lines.push('  const r = result as Partial<ManifestActionResult<T>> & { error?: string };');
+    lines.push('  if (r && typeof r.success === "boolean") {');
+    lines.push('    return r as ManifestActionResult<T>;');
+    lines.push('  }');
+    lines.push('  return {');
+    lines.push('    success: !r?.error,');
+    lines.push('    data: r?.data as T | undefined,');
+    lines.push('    error: r?.error,');
+    lines.push('    events: r?.events ?? [],');
+    lines.push('    diagnostics: r?.diagnostics ?? [],');
+    lines.push('  };');
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+// ============================================================================
+// Surface dispatchers
+// ============================================================================
+function entityNotFoundDiagnostic(entityName, ir) {
+    return {
+        severity: 'error',
+        code: 'ENTITY_NOT_FOUND',
+        message: `Entity "${entityName}" not found in IR. Available entities: ${ir.entities
+            .map((e) => e.name)
+            .join(', ')}`,
+        entity: entityName,
+    };
+}
+function commandNotFoundDiagnostic(entityName, commandName, ir) {
+    const entityCommands = ir.commands
+        .filter((c) => c.entity === entityName)
+        .map((c) => c.name);
+    return {
+        severity: 'error',
+        code: 'COMMAND_NOT_FOUND',
+        message: `Command "${commandName}" not found on entity "${entityName}". Available commands: ${entityCommands.join(', ')}`,
+        entity: entityName,
+    };
+}
+// ============================================================================
+// Projection class
+// ============================================================================
+/**
+ * SvelteKit projection.
+ *
+ * Emits `+server.ts` API routes, `+page.server.ts` loaders with form
+ * `actions`, and supporting type / client artifacts that integrate with
+ * the Manifest runtime. Mirrors the Next.js App Router projection's
+ * semantics while honouring SvelteKit-specific conventions.
+ */
+export class SvelteKitProjection {
+    name = 'sveltekit';
+    description = 'SvelteKit +server.ts routes and +page.server.ts loaders with form actions, $lib imports, and type-safe PageData';
+    surfaces = SURFACES;
+    generate(ir, request) {
+        const options = normalizeOptions((request.options ?? {}));
+        switch (request.surface) {
+            case SURFACE_SERVER: {
+                if (!request.entity) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [
+                            {
+                                severity: 'error',
+                                code: 'MISSING_ENTITY',
+                                message: `surface "${SURFACE_SERVER}" requires entity`,
+                            },
+                        ],
+                    };
+                }
+                const entity = ir.entities.find((e) => e.name === request.entity);
+                if (!entity) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [entityNotFoundDiagnostic(request.entity, ir)],
+                    };
+                }
+                const code = generateServerFile(entity, ir, options);
+                return {
+                    artifacts: [
+                        {
+                            id: `sveltekit.server:${request.entity}`,
+                            pathHint: `${options.routesDir}/${toRouteSegment(request.entity)}/+server.ts`,
+                            contentType: 'typescript',
+                            code,
+                        },
+                    ],
+                    diagnostics: [],
+                };
+            }
+            case SURFACE_LOAD: {
+                if (!request.entity) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [
+                            {
+                                severity: 'error',
+                                code: 'MISSING_ENTITY',
+                                message: `surface "${SURFACE_LOAD}" requires entity`,
+                            },
+                        ],
+                    };
+                }
+                const entity = ir.entities.find((e) => e.name === request.entity);
+                if (!entity) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [entityNotFoundDiagnostic(request.entity, ir)],
+                    };
+                }
+                const code = generateLoadFile(entity, ir, options);
+                return {
+                    artifacts: [
+                        {
+                            id: `sveltekit.load:${request.entity}`,
+                            pathHint: `${options.routesDir}/${toRouteSegment(request.entity)}/+page.server.ts`,
+                            contentType: 'typescript',
+                            code,
+                        },
+                    ],
+                    diagnostics: [],
+                };
+            }
+            case SURFACE_COMMAND: {
+                if (!request.entity) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [
+                            {
+                                severity: 'error',
+                                code: 'MISSING_ENTITY',
+                                message: `surface "${SURFACE_COMMAND}" requires entity`,
+                            },
+                        ],
+                    };
+                }
+                if (!request.command) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [
+                            {
+                                severity: 'error',
+                                code: 'MISSING_COMMAND',
+                                message: `surface "${SURFACE_COMMAND}" requires command`,
+                            },
+                        ],
+                    };
+                }
+                const entity = ir.entities.find((e) => e.name === request.entity);
+                if (!entity) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [entityNotFoundDiagnostic(request.entity, ir)],
+                    };
+                }
+                const command = ir.commands.find((c) => c.entity === request.entity && c.name === request.command);
+                if (!command) {
+                    return {
+                        artifacts: [],
+                        diagnostics: [
+                            commandNotFoundDiagnostic(request.entity, request.command, ir),
+                        ],
+                    };
+                }
+                const code = generateCommandServerFile(entity, command, ir, options);
+                return {
+                    artifacts: [
+                        {
+                            id: `sveltekit.command:${request.entity}.${request.command}`,
+                            pathHint: `${options.routesDir}/${toRouteSegment(request.entity)}/commands/${toRouteSegment(request.command)}/+server.ts`,
+                            contentType: 'typescript',
+                            code,
+                        },
+                    ],
+                    diagnostics: [],
+                };
+            }
+            case SURFACE_TYPES: {
+                const code = generateTypesFile(ir, options);
+                return {
+                    artifacts: [
+                        {
+                            id: 'sveltekit.types',
+                            pathHint: 'src/lib/manifest-types.ts',
+                            contentType: 'typescript',
+                            code,
+                        },
+                    ],
+                    diagnostics: [],
+                };
+            }
+            case SURFACE_CLIENT: {
+                const code = generateClientFile(options);
+                return {
+                    artifacts: [
+                        {
+                            id: 'sveltekit.client',
+                            pathHint: 'src/lib/manifest-client.ts',
+                            contentType: 'typescript',
+                            code,
+                        },
+                    ],
+                    diagnostics: [],
+                };
+            }
+            default:
+                return {
+                    artifacts: [],
+                    diagnostics: [
+                        {
+                            severity: 'error',
+                            code: 'UNKNOWN_SURFACE',
+                            message: `Unknown surface: "${request.surface}". Available: ${SURFACES.join(', ')}`,
+                        },
+                    ],
+                };
+        }
+    }
+}
+//# sourceMappingURL=generator.js.map