@supacloud/compiler 0.23.0 → 0.25.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.23.0",
+  "version": "0.25.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",