@supacloud/compiler 0.28.0 → 0.29.0

package/dist/diagnostics.d.ts

@@ -0,0 +1,39 @@
+import type { Diagnostic } from "./types";
+import type { DiagnosticRepair } from "./repair-plan";
+/** Shared source for CLI JSON consumers, editor diagnostics and AI repair tools. */
+export interface DiagnosticReportEntry {
+    diagnostic: Diagnostic;
+    repair?: DiagnosticRepair;
+    guidance?: string;
+}
+export interface DiagnosticReport {
+    format: 1;
+    entries: DiagnosticReportEntry[];
+}
+export declare function createDiagnosticReport(diagnostics: readonly Diagnostic[]): DiagnosticReport;
+/** LSP-shaped data only. It neither starts a language server nor applies unreviewed edits. */
+export declare function toEditorDiagnostics(diagnostics: readonly Diagnostic[]): {
+    message: string;
+    data: {
+        diagnostic: Diagnostic;
+        repair?: DiagnosticRepair;
+        guidance?: string;
+        format: 1;
+    };
+    codeDescription?: {
+        href: string;
+    } | undefined;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+    severity: 1 | 2;
+    source: string;
+    code: string;
+}[];

package/dist/diagnostics.js

@@ -0,0 +1,73 @@
+// src/repair-plan.ts
+function createDiagnosticRepairPlan(diagnostics) {
+  return diagnostics.flatMap((diagnostic) => {
+    const fix = diagnostic.fix;
+    if (!fix)
+      return [];
+    return [{
+      code: diagnostic.code,
+      ...diagnostic.errorCode === undefined ? {} : { errorCode: diagnostic.errorCode },
+      ...diagnostic.file === undefined ? {} : { file: diagnostic.file },
+      ...diagnostic.line === undefined ? {} : { line: diagnostic.line },
+      type: fix.type,
+      targetFile: fix.targetFile,
+      fix,
+      ...classifyFix(fix)
+    }];
+  });
+}
+function classifyFix(fix) {
+  switch (fix.type) {
+    case "set_command_mode":
+      if (fix.value !== "required" && fix.value !== "none") {
+        return { readiness: "input-required", reason: "Choose an explicit transaction or idempotency policy; no policy is inferred." };
+      }
+      break;
+    case "add_command_permission":
+      if (!fix.permission?.trim()) {
+        return { readiness: "input-required", reason: "Choose an explicit business permission; privileges are never inferred." };
+      }
+      break;
+    case "add_module_import":
+      if (!fix.importPath || !fix.symbol) {
+        return { readiness: "input-required", reason: "Supply the module import path and exported symbol before previewing." };
+      }
+      break;
+    case "add_route_parameter_binding":
+      break;
+    default:
+      return { readiness: "manual", reason: "The semantic fix executor does not implement this suggestion; edit and verify it manually." };
+  }
+  return { readiness: "preview", reason: "Preview with the semantic fix executor; source preconditions are checked before writing." };
+}
+
+// src/diagnostics.ts
+function createDiagnosticReport(diagnostics) {
+  return { format: 1, entries: diagnostics.map((diagnostic) => {
+    const repair = createDiagnosticRepairPlan([diagnostic])[0];
+    return {
+      diagnostic: { ...diagnostic },
+      ...repair ? { repair } : {},
+      ...diagnostic.suggestion ? { guidance: diagnostic.suggestion } : {}
+    };
+  }) };
+}
+function toEditorDiagnostics(diagnostics) {
+  return createDiagnosticReport(diagnostics).entries.map((entry) => ({
+    range: {
+      start: { line: Math.max(0, (entry.diagnostic.line ?? 1) - 1), character: 0 },
+      end: { line: Math.max(0, (entry.diagnostic.line ?? 1) - 1), character: 0 }
+    },
+    severity: entry.diagnostic.severity === "error" ? 1 : 2,
+    source: "supacloud",
+    code: entry.diagnostic.errorCode ?? entry.diagnostic.code,
+    ...entry.diagnostic.docsUrl ? { codeDescription: { href: entry.diagnostic.docsUrl } } : {},
+    message: entry.diagnostic.message + (entry.guidance ? `
+${entry.guidance}` : ""),
+    data: { format: 1, ...entry }
+  }));
+}
+export {
+  createDiagnosticReport,
+  toEditorDiagnostics
+};

package/dist/http-provider-migration.d.ts

@@ -0,0 +1,6 @@
+import * as ts from "@typescript/typescript6";
+import type { SourceMigrationResult } from "./migrations";
+import type { Diagnostic } from "./types";
+/** Never replaces the root array helper in constructor/custom pipeline usages. */
+export declare function migrateHttpProviderImports(source: string, fileName: string): SourceMigrationResult;
+export declare function scanHttpProviderImports(source: ts.SourceFile, file: string): Diagnostic[];