@supacloud/compiler 0.24.0 → 0.26.0

package/dist/migration-assess.d.ts

@@ -0,0 +1,62 @@
+import { type OpenApiDiffResult } from "./openapi-tools";
+import type { CompileOptions, Diagnostic } from "./types";
+export type MigrationAssessmentStatus = "compatible" | "needs-review" | "breaking" | "unsupported" | "not-proven";
+export type MigrationRenderMode = "unspecified" | "browser" | "ssr" | "edge" | "trusted-server";
+export interface MigrationAssessmentFinding {
+    code: string;
+    status: MigrationAssessmentStatus;
+    message: string;
+    evidence?: string;
+    remediation?: string;
+}
+export interface MigrationAssessmentOptions {
+    projectDir: string;
+    compile: CompileOptions;
+    baselineOpenApiPath?: string;
+    currentOpenApiPath?: string;
+    renderMode?: MigrationRenderMode;
+}
+export interface MigrationAssessmentResult {
+    version: 1;
+    ok: boolean;
+    status: MigrationAssessmentStatus;
+    readOnly: true;
+    writesPerformed: false;
+    rendering: {
+        selected: MigrationRenderMode;
+        ssrRequired: false;
+        supportedModes: readonly ["browser", "ssr", "edge", "trusted-server"];
+        guidance: string;
+    };
+    dependencies: {
+        expected: Readonly<Record<string, string>>;
+        problems: string[];
+    };
+    compiler: {
+        upToDate: boolean;
+        diagnostics: Diagnostic[];
+        mismatches: string[];
+    };
+    artifacts: {
+        contractsManifest: {
+            path: string;
+            present: boolean;
+            sha256?: string;
+            version?: number;
+            commands?: number;
+            routes?: number;
+            permissions?: number;
+        };
+        openApi?: {
+            baselinePath: string;
+            baselineSha256: string;
+            currentPath: string;
+            currentSha256: string;
+            diff: OpenApiDiffResult;
+        };
+    };
+    findings: MigrationAssessmentFinding[];
+}
+/** Build a local, read-only migration report. It never requires or enables SSR. */
+export declare function assessMigration(options: MigrationAssessmentOptions): Promise<MigrationAssessmentResult>;
+export declare function formatMigrationAssessment(result: MigrationAssessmentResult): string;

package/dist/repair-plan.d.ts

@@ -0,0 +1,17 @@
+import type { Diagnostic, DiagnosticFix } from "./types";
+export interface DiagnosticRepair {
+    code: string;
+    errorCode?: string;
+    file?: string;
+    line?: number;
+    type: DiagnosticFix["type"];
+    targetFile: string;
+    fix: DiagnosticFix;
+    readiness: "preview" | "input-required" | "manual";
+    reason: string;
+}
+/**
+ * Classifies suggestions without executing them or inferring policy.
+ * Preview readiness does not guarantee that source preconditions still hold.
+ */
+export declare function createDiagnosticRepairPlan(diagnostics: readonly Diagnostic[]): DiagnosticRepair[];

package/dist/types.d.ts

@@ -149,6 +149,8 @@ export interface HandlerParamNode {
     default?: unknown;
 }
 export interface RouteNode {
+    parse?: "none";
+    allowDeleteBody?: true;
     contract?: {
         body?: "framework" | "domain";
         response?: "framework" | "native-json" | "binary" | "stream";
@@ -308,6 +310,8 @@ export interface ModuleNode {
     featureSpec?: FeatureSpecNode;
 }
 export interface ApplicationGraph {
+    /** Handler declaration files by module, for inspection only; omitted from app.manifest.json. */
+    moduleHandlerFiles?: Record<string, string[]>;
     /** Offline query inventory for AI context. Kept in graphql.manifest.json, not app.manifest.json. */
     graphql?: GraphqlContractSummary;
     modules: ModuleNode[];
@@ -456,6 +460,8 @@ export interface ModuleBoundaryProfile {
 }
 export interface ValidateOptions {
     strict?: boolean;
+    /** Reject route shapes that cannot coexist in an OpenAPI document. */
+    generateOpenApi?: boolean;
     moduleBoundaryPreset?: ModuleBoundaryPresetName;
     moduleBoundaries?: ModuleBoundaryRule[];
     /** Allow routes to bind directly to @Command (defaults to true). */
@@ -533,6 +539,8 @@ export interface WatchHandle {
 }
 export interface CachedModuleEntry {
     module: ModuleNode;
+    /** Direct handler declarations retained for inspection on cache hits. */
+    handlerFiles?: string[];
     /** Files owned by this module (normalized relative paths). */
     ownedFiles: string[];
     /** File hash mapping for owned files. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",