@supacloud/compiler 0.15.0 → 0.19.1

package/dist/migrations.d.ts

@@ -0,0 +1,41 @@
+export interface SourceMigrationIssue {
+    code: string;
+    message: string;
+    file: string;
+    line?: number;
+}
+export interface SourceMigrationResult {
+    changed: boolean;
+    content: string;
+    replacements: number;
+    issues: SourceMigrationIssue[];
+}
+export interface SupaCloudMigration {
+    id: string;
+    from: string;
+    to: string;
+    description: string;
+    apply(source: string, fileName: string): SourceMigrationResult;
+}
+export interface MigrateProjectOptions {
+    rootDir: string;
+    include?: string[];
+    write?: boolean;
+}
+export interface MigrateFileResult {
+    file: string;
+    changed: boolean;
+    replacements: number;
+    issues: SourceMigrationIssue[];
+}
+export interface MigrateProjectResult {
+    write: boolean;
+    migrations: Array<Pick<SupaCloudMigration, "id" | "from" | "to" | "description">>;
+    files: MigrateFileResult[];
+    changedFiles: string[];
+    issues: SourceMigrationIssue[];
+}
+declare function migrateRouteResponse(source: string, fileName: string): SourceMigrationResult;
+export declare const SUPACLOUD_MIGRATIONS: SupaCloudMigration[];
+export declare function migrateProject(options: MigrateProjectOptions): Promise<MigrateProjectResult>;
+export { migrateRouteResponse };

package/dist/openapi-tools.d.ts

@@ -0,0 +1,41 @@
+export type OpenApiObject = {
+    [key: string]: unknown;
+};
+export interface OpenApiDocument {
+    openapi: string;
+    info: OpenApiObject;
+    paths: OpenApiObject;
+    [key: string]: unknown;
+}
+export declare class OpenApiDocumentError extends Error {
+    readonly code: "OPENAPI_DOCUMENT_INVALID";
+    constructor();
+}
+export interface OpenApiJsonWriteResult {
+    path: string;
+    written: boolean;
+}
+export interface OpenApiExportOptions {
+    modulePath: string;
+    outputPath: string;
+    space?: number;
+}
+export interface OpenApiDiffChange {
+    kind: "breaking" | "non-breaking";
+    code: string;
+    path: string;
+    message: string;
+}
+export interface OpenApiDiffResult {
+    ok: boolean;
+    breaking: OpenApiDiffChange[];
+    changes: OpenApiDiffChange[];
+}
+export declare function parseOpenApiDocument(value: unknown): OpenApiDocument;
+export declare function serializeOpenApiJson(document: unknown, space?: number): string;
+export declare function readOpenApiJson(path: string): Promise<OpenApiDocument>;
+export declare function writeOpenApiJson(document: unknown, outputPath: string, space?: number): Promise<OpenApiJsonWriteResult>;
+export declare function loadGeneratedOpenApiDocument(modulePath: string): Promise<OpenApiDocument>;
+export declare function exportGeneratedOpenApiJson(options: OpenApiExportOptions): Promise<OpenApiJsonWriteResult>;
+export declare function diffOpenApiDocuments(baseValue: unknown, currentValue: unknown): OpenApiDiffResult;
+export declare function formatOpenApiDiff(result: OpenApiDiffResult): string;

package/dist/route-contracts.d.ts

@@ -7,11 +7,11 @@ export declare function inspectRouteContracts(graph: ApplicationGraph): {
     method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     path: string;
     file: string;
-    missing: ("query" | "body" | "params" | "response")[];
+    missing: ("query" | "body" | "headers" | "cookie" | "params" | "response")[];
     validation: {
         body: string;
         response: string;
-        schemas: Partial<Record<"query" | "body" | "params" | "response", "opaque" | "declared">>;
+        schemas: Partial<Record<"query" | "body" | "headers" | "cookie" | "params" | "response", "opaque" | "declared">>;
         evidence: string | null;
         verified: false;
         obligations: string[];

package/dist/type-safety.d.ts

@@ -1,4 +1,30 @@
 import type { Diagnostic, TypeSafetyOptions } from "./types";
+export declare const TYPE_SAFETY_DIAGNOSTIC_CODES: {
+    readonly "generated-any": {
+        readonly errorCode: "SC6001";
+        readonly docsUrl: "https://supacloud.dev/errors/SC6001";
+    };
+    readonly "source-any": {
+        readonly errorCode: "SC6002";
+        readonly docsUrl: "https://supacloud.dev/errors/SC6002";
+    };
+    readonly "source-type-assertion": {
+        readonly errorCode: "SC6003";
+        readonly docsUrl: "https://supacloud.dev/errors/SC6003";
+    };
+    readonly "source-non-null-assertion": {
+        readonly errorCode: "SC6004";
+        readonly docsUrl: "https://supacloud.dev/errors/SC6004";
+    };
+    readonly "source-implicit-widening": {
+        readonly errorCode: "SC6005";
+        readonly docsUrl: "https://supacloud.dev/errors/SC6005";
+    };
+    readonly "source-type-suppression": {
+        readonly errorCode: "SC6006";
+        readonly docsUrl: "https://supacloud.dev/errors/SC6006";
+    };
+};
 export interface TypeSafetyScanOptions extends TypeSafetyOptions {
     rootDir: string;
     include?: string[];

package/dist/types.d.ts

@@ -4,6 +4,9 @@
  */
 import type { IncrementalProgramSession } from "./program";
 export type Scope = "application" | "request" | "job";
+export type JobMode = "task" | "workflow";
+export type JobIdempotency = "required" | "none";
+export type JobSchemaKind = "opaque" | "declared";
 export type ProviderKind = "class" | "value" | "factory" | "existing";
 export type TokenKind = "injection-token" | "class";
 export interface FunctionalInjectNode {
@@ -140,7 +143,7 @@ export interface ProviderNode {
 }
 export interface HandlerParamNode {
     name: string;
-    kind: "param" | "query" | "body" | "headers" | "context" | "unknown";
+    kind: "param" | "query" | "body" | "headers" | "cookie" | "context" | "unknown";
     bindingName?: string;
     transform?: "number" | "boolean" | "string";
     default?: unknown;
@@ -151,7 +154,7 @@ export interface RouteNode {
         response?: "framework" | "native-json" | "binary" | "stream";
         evidence?: string;
     };
-    schemaKinds?: Partial<Record<"body" | "params" | "query" | "response", "opaque" | "declared">>;
+    schemaKinds?: Partial<Record<"body" | "params" | "query" | "headers" | "cookie" | "response", "opaque" | "declared">>;
     nativeResponse?: boolean;
     method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     path: string;
@@ -159,7 +162,10 @@ export interface RouteNode {
     body?: string;
     params?: string;
     query?: string;
+    headers?: string;
+    cookie?: string;
     response?: string;
+    responses?: Record<string, string>;
     /** @Command-decorated class explicitly bound by the route. */
     command?: string;
     /** Route guards executed before handler (Angular CanActivateFn style). */
@@ -241,6 +247,21 @@ export interface JobNode {
     /** Generated services key; follows a custom useClass provider token when present. */
     serviceKey: string;
     scope: Scope;
+    /** Input schema symbol imported into the generated application, when declared. */
+    input?: string;
+    /** Output schema symbol imported into the generated application, when declared. */
+    output?: string;
+    schemaKinds?: Partial<Record<"input" | "output", JobSchemaKind>>;
+    /** Job schema symbol name -> relative module path for import generation. */
+    schemaImports?: Record<string, string>;
+    /** Existing execution adapter selected by the job declaration. */
+    mode?: JobMode;
+    /** Adapter-owned execution deadline in seconds. */
+    timeoutSec?: number;
+    /** Adapter-owned maximum execution attempts. */
+    maxAttempts?: number;
+    /** Adapter-owned idempotency requirement. */
+    idempotency?: JobIdempotency;
     aspects?: AspectRefNode[];
 }
 export interface QueryNode {
@@ -338,6 +359,10 @@ export interface CompileOptions {
     writeOnError?: boolean;
     /** Generate typed API client in client.ts (default: false). */
     generateClient?: boolean;
+    /** Generate the OpenAPI 3.1 document module in openapi.ts (default: false). */
+    generateOpenApi?: boolean;
+    /** OpenAPI document metadata and explicitly configured security schemes. */
+    openApi?: OpenApiOptions;
     /** Generate typed permissions registry in permissions.ts (default: false). */
     generatePermissions?: boolean;
     /** Prune unused root providers from compiled output (Angular Ivy AOT tree-shaking). */
@@ -366,6 +391,36 @@ export interface GraphqlOptions {
         output: string;
     }>;
 }
+export interface OpenApiServer {
+    url: string;
+    description?: string;
+}
+export type OpenApiSecurityScheme = {
+    type: "apiKey";
+    name: string;
+    in: "header" | "query" | "cookie";
+    description?: string;
+} | {
+    type: "http";
+    scheme: string;
+    bearerFormat?: string;
+    description?: string;
+} | {
+    type: "oauth2";
+    flows: Record<string, unknown>;
+    description?: string;
+} | {
+    type: "openIdConnect";
+    openIdConnectUrl: string;
+    description?: string;
+};
+export interface OpenApiOptions {
+    title?: string;
+    version?: string;
+    description?: string;
+    servers?: OpenApiServer[];
+    securitySchemes?: Record<string, OpenApiSecurityScheme>;
+}
 export interface GraphqlContractSummary {
     schema: string;
     schemaHash?: string;
@@ -414,11 +469,14 @@ export interface ValidateOptions {
 }
 /** Runtime capabilities declared by the Command executor. */
 export interface CommandExecutionCapabilities {
+    /** Require named persistent adapters and explicit audit/idempotency declarations. */
+    requirePersistentAdapters?: boolean;
     /** Explicit named adapters; declarations must also be tested against the database. */
     rpc?: Record<string, {
         audit?: boolean;
         idempotency?: boolean;
         transaction?: boolean;
+        boundary?: "database" | "external";
     }>;
     /** Whether runtime permission checks are supported. */
     permission?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.15.0",
+  "version": "0.19.1",
   "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",
@@ -18,7 +18,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "DELIVERY.md"
   ],
   "scripts": {
     "build": "bun run clean && bun run build:js && bun run build:types",
@@ -46,6 +47,7 @@
     "directory": "packages/compiler"
   },
   "dependencies": {
+    "@sinclair/typebox": "^0.34.52",
     "@graphql-codegen/core": "^6.2.0",
     "@graphql-codegen/typed-document-node": "^7.1.0",
     "@graphql-codegen/typescript-operations": "^6.1.6",
@@ -54,7 +56,7 @@
     "graphql": "^16"
   },
   "devDependencies": {
-    "@types/bun": "^1.4.0",
+    "@types/bun": "^1.4.2",
     "typescript": "^7.0.2"
   }
 }