@supacloud/compiler 0.27.4 → 0.28.0

package/dist/application-development.d.ts

@@ -0,0 +1,124 @@
+import type { ApplicationGraph } from "./types";
+import { type ExecutionPlan } from "./inspect";
+/**
+ * A stable, read-only projection of the current application graph for developer
+ * tooling. Never exports expressions, diagnostic messages, repair replacement
+ * values, credentials or business payloads. Readers share the delivery contract.
+ */
+export declare const APPLICATION_DEVELOPMENT_LIMITS: {
+    readonly outputBytes: number;
+    readonly modules: number;
+    readonly providers: number;
+    readonly routes: number;
+    readonly commands: number;
+    readonly jobs: number;
+    readonly resources: number;
+    readonly resourceUses: number;
+    readonly plans: number;
+    readonly diagnostics: number;
+};
+/** Shared formatted UTF-8 byte budget for archive writers and readers (including the final newline). */
+export declare const APPLICATION_DEVELOPMENT_ARCHIVE_MAX_BYTES = 524288;
+export declare const APPLICATION_DEVELOPMENT_SCHEMA = "supacloud.application-development.v1";
+export type DevelopmentSchemaKind = "opaque" | "declared";
+export interface ApplicationDevelopmentModule {
+    name: string;
+    className: string;
+    file?: string;
+    tags?: string[];
+    providers: string[];
+    controllers: string[];
+    commands: string[];
+    jobs: string[];
+    queries: string[];
+    resources: string[];
+}
+export interface ApplicationDevelopmentRoute {
+    module: string;
+    method: string;
+    path: string;
+    controller: string;
+    handler: string;
+    command?: string;
+    aspects: string[];
+    schemaKinds?: Record<string, DevelopmentSchemaKind>;
+}
+export interface ApplicationDevelopmentResourceUse {
+    resource: string;
+    operations: string[];
+}
+export interface ApplicationDevelopmentCommand {
+    module: string;
+    name: string;
+    permission?: string;
+    transaction: "required" | "none";
+    idempotency: "required" | "none";
+    audit?: string;
+    resources: ApplicationDevelopmentResourceUse[];
+}
+export interface ApplicationDevelopmentJob {
+    module: string;
+    name: string;
+    mode?: string;
+    resources: ApplicationDevelopmentResourceUse[];
+}
+export interface ApplicationDevelopmentResource {
+    name: string;
+    kind: string;
+}
+export interface ApplicationDevelopmentResourceUseEntry {
+    module: string;
+    owner: string;
+    ownerKind: "command" | "job";
+    resource: string;
+    operations: string[];
+}
+export interface ApplicationDevelopmentDiagnostic {
+    code: string;
+    severity: "error" | "warn";
+    file?: string;
+    line?: number;
+    repair?: {
+        type: string;
+        readiness: "preview" | "input-required" | "manual";
+    };
+}
+export interface ApplicationDevelopmentContext {
+    schema: typeof APPLICATION_DEVELOPMENT_SCHEMA;
+    source: "current-graph";
+    deploymentVerified: false;
+    modules: ApplicationDevelopmentModule[];
+    routes: ApplicationDevelopmentRoute[];
+    commands: ApplicationDevelopmentCommand[];
+    jobs: ApplicationDevelopmentJob[];
+    resources: ApplicationDevelopmentResource[];
+    resourceUses: ApplicationDevelopmentResourceUseEntry[];
+    executionPlans: ExecutionPlan[];
+    diagnostics: ApplicationDevelopmentDiagnostic[];
+    omitted: {
+        modules: number;
+        providers: number;
+        routes: number;
+        commands: number;
+        jobs: number;
+        resources: number;
+        resourceUses: number;
+        plans: number;
+        diagnostics: number;
+    };
+    limits: typeof APPLICATION_DEVELOPMENT_LIMITS;
+}
+export declare class ApplicationDevelopmentError extends Error {
+    readonly code: "APPLICATION_DEVELOPMENT_TOO_LARGE" | "APPLICATION_DEVELOPMENT_INVALID";
+    constructor(code: "APPLICATION_DEVELOPMENT_TOO_LARGE" | "APPLICATION_DEVELOPMENT_INVALID");
+}
+/** Keep the compiler API and error identity stable while sharing the wire parser. */
+export declare function parseApplicationDevelopmentContext(input: unknown): ApplicationDevelopmentContext;
+/** Deterministic projection of the current graph into the versioned contract. */
+export interface ApplicationDevelopmentOptions {
+    /** Interactive output defaults to 64 KiB; delivery archives allow 512 KiB. Neither mode is unbounded. */
+    byteBudget?: "interactive" | "archive";
+}
+export declare function createApplicationDevelopmentContext(graph: ApplicationGraph, options?: ApplicationDevelopmentOptions): ApplicationDevelopmentContext;
+/** Compact human-readable rendering, used by the `dev-context` CLI command. */
+export declare function formatApplicationDevelopmentContext(context: ApplicationDevelopmentContext): string;