@supacloud/compiler 0.27.4 → 0.29.0

package/NOTICE

@@ -1,22 +1,17 @@
 SupaCloud
 Copyright 2025 SupaCloud Contributors
 
-SupaCloud project-owned code in this revision is licensed under the GNU
-Affero General Public License, version 3 only (AGPL-3.0-only). The complete
-license is provided in LICENSE. This is not an "or later" grant.
+SupaCloud project-owned code in this revision is licensed under the Apache
+License, Version 2.0 (Apache-2.0). The complete license is provided in
+LICENSE.
 
 This program is distributed without any warranty; without even the implied
 warranty of merchantability or fitness for a particular purpose.
 
 Third-party components, incorporated upstream code, and their copyright,
-license and attribution notices retain their original terms. This notice
-does not replace those terms or claim ownership of third-party work.
+license and attribution notices retain their original terms. This notice does
+not replace those terms or claim ownership of third-party work.
 
-Earlier SupaCloud code was distributed under Apache-2.0 or MIT as indicated
-in its original files and package metadata. Previously granted permissions
-are not revoked by this change. The historical Apache-2.0 text is preserved
-in LICENSE-APACHE-2.0.txt. Retain any applicable upstream MIT notices as well.
-
-Before publishing this licensing change, maintainers must confirm authority
-to license the affected contributions and compatibility of incorporated
-third-party code. This notice is not evidence of contributor consent.
+Previously released SupaCloud versions retain the permissions granted with
+those versions. See the historical license files and release notices where
+applicable.

package/README.md

@@ -747,4 +747,4 @@ metadata, not an authorization boundary.
 
 ## License
 
-AGPL-3.0-only. See the repository root `LICENSE` and `NOTICE` files.
+Apache-2.0. See the repository root `LICENSE` and `NOTICE` files.

package/dist/api-source.d.ts

@@ -0,0 +1,11 @@
+import * as ts from "@typescript/typescript6";
+export interface ApiOrigin {
+    module: string;
+    name: string;
+}
+/** Bind one source for lexical identity only. Never load dependencies or execute application code. */
+export declare function bindApiSource(source: ts.SourceFile): {
+    source: ts.SourceFile;
+    checker: ts.TypeChecker;
+};
+export declare function apiOrigin(expression: ts.Expression, checker: ts.TypeChecker, seen?: Set<ts.Node>): ApiOrigin | undefined;

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;