@supacloud/compiler 0.12.0 → 0.13.0

package/dist/config.d.ts

@@ -1,5 +1,7 @@
-import type { CommandExecutionCapabilities, CompileOptions, ModuleBoundaryPresetName } from "./types";
+import type { CommandExecutionCapabilities, CompileOptions, GraphqlOptions, ModuleBoundaryPresetName } from "./types";
 export interface SupaCloudConfig {
+    /** Opt-in outside app init. Schema is configuration-relative; documents are root-relative. */
+    graphql?: GraphqlOptions | false;
     root?: string;
     outDir?: string;
     include?: string[];
@@ -27,6 +29,7 @@ export declare function resolveSupacloudConfig(config?: SupaCloudConfig, cwd?: s
     moduleBoundaryPreset: ModuleBoundaryPresetName;
     commandCapabilities?: CommandExecutionCapabilities;
     treeShakeUnusedProviders: boolean;
+    graphql?: GraphqlOptions;
 };
 export declare function loadSupacloudConfig(cwd?: string): Promise<SupaCloudConfig>;
 export declare function compileOptionsFromConfig(config: SupaCloudConfig, cwd?: string): CompileOptions;

package/dist/generate.d.ts

@@ -22,6 +22,7 @@ export declare function renderApplication(graph: ApplicationGraph, options: Gene
  * Generated code imports only application classes and schemas, with no runtime reflection or container lookup.
  */
 export declare function generateApplication(graph: ApplicationGraph, options: GenerateOptions): Promise<string[]>;
+export declare function writeFileIfChanged(path: string, content: string, hashes?: Map<string, string>): Promise<boolean>;
 /**
  * Generates typed API client in client.ts from discovered Controllers and Routes.
  * Modeled after Angular HttpClient and typed contract clients.

package/dist/graphql-client.d.ts

@@ -0,0 +1,2 @@
+/** Appended to the generated SDK; browser consumers need only the platform fetch API. */
+export declare const GRAPHQL_CLIENT_SOURCE = "\nexport interface GraphqlClientOptions {\n  /** Project base URL, not the management API URL. HTTPS is required outside loopback. */\n  url: string;\n  /** Public project key only. Never put a service-role or management key in a browser. */\n  publishableKey?: string;\n  /** Resolved on every request so session refresh and logout are observed. */\n  getAccessToken?: () => string | null | undefined | Promise<string | null | undefined>;\n  fetch?: (url: string, init: RequestInit) => Promise<Response>;\n}\n\nexport interface GraphqlRequestOptions {\n  signal?: AbortSignal;\n}\n\nexport class GraphqlRequestError extends Error {\n  constructor(\n    public readonly code: \"http\" | \"graphql\" | \"invalid-response\",\n    message: string,\n    public readonly status?: number,\n    public readonly errors?: readonly unknown[],\n  ) {\n    super(message);\n    this.name = \"GraphqlRequestError\";\n  }\n}\n\nexport function createGraphqlClient(options: GraphqlClientOptions) {\n  const endpoint = new URL(options.url);\n  const loopback = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(endpoint.hostname);\n  if (endpoint.protocol !== \"https:\" && !(endpoint.protocol === \"http:\" && loopback)) {\n    throw new Error(\"GraphQL requires HTTPS outside loopback development.\");\n  }\n  if (endpoint.username || endpoint.password || endpoint.search || endpoint.hash) {\n    throw new Error(\"GraphQL project URLs must not contain credentials, query parameters or fragments.\");\n  }\n  endpoint.pathname = endpoint.pathname.replace(/\\/$/, \"\") + \"/graphql/v1\";\n  const fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);\n  return getSdk<GraphqlRequestOptions>(async <R, V>(\n    query: string,\n    variables?: V,\n    request?: GraphqlRequestOptions,\n  ): Promise<R> => {\n    const headers = new Headers({ \"Content-Type\": \"application/json\", Accept: \"application/json\" });\n    if (options.publishableKey) headers.set(\"apikey\", options.publishableKey);\n    const token = await options.getAccessToken?.();\n    if (token) headers.set(\"Authorization\", \"Bearer \" + token);\n    const response = await fetcher(endpoint.toString(), {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify({ query, variables }),\n      signal: request?.signal,\n      redirect: \"error\",\n    });\n    if (!response.ok) {\n      throw new GraphqlRequestError(\"http\", \"GraphQL HTTP request failed (\" + response.status + \").\", response.status);\n    }\n    let envelope: unknown;\n    try {\n      envelope = await response.json();\n    } catch {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned invalid JSON.\", response.status);\n    }\n    if (!envelope || typeof envelope !== \"object\" || Array.isArray(envelope)) {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned an invalid envelope.\", response.status);\n    }\n    if (\"errors\" in envelope) {\n      if (!Array.isArray(envelope.errors)) {\n        throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned invalid errors.\", response.status);\n      }\n      if (envelope.errors.length > 0) {\n        throw new GraphqlRequestError(\"graphql\", \"GraphQL query failed.\", response.status, envelope.errors);\n      }\n    }\n    if (!(\"data\" in envelope) || !envelope.data || typeof envelope.data !== \"object\" || Array.isArray(envelope.data)) {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned no result object.\", response.status);\n    }\n    // Operation types describe the schema snapshot, not runtime response validation.\n    return envelope.data as R;\n  });\n}\n";

package/dist/graphql-inputs.d.ts

@@ -0,0 +1,3 @@
+import type { CompileOptions } from "./types";
+/** Shared inventory keeps optional GraphQL inputs in the incremental cache without loading codegen. */
+export declare function graphqlInputPaths(options: CompileOptions): string[];

package/dist/graphql-options.d.ts

@@ -0,0 +1,7 @@
+import type { GraphqlOptions } from "./types";
+export declare class GraphqlConfigurationError extends Error {
+    readonly code = "graphql-config-invalid";
+    constructor(detail: string);
+}
+/** Validate before resolving paths so URLs cannot turn into apparently local filenames. */
+export declare function assertGraphqlOptions(value: unknown): asserts value is GraphqlOptions;

package/dist/graphql-schema.d.ts

@@ -0,0 +1,17 @@
+export interface PullGraphqlSchemaOptions {
+    /** Explicit project URL. This operation never discovers or changes a deployment. */
+    url: string;
+    output: string;
+    publishableKey?: string;
+    accessToken?: string;
+    /** Compare the deployed role schema with the snapshot without writing. Useful after migrations. */
+    check?: boolean;
+    fetch?: (url: string, init: RequestInit) => Promise<Response>;
+}
+/** Explicit authenticated snapshot export, separate from the offline compile/check pipeline. */
+export declare function pullGraphqlSchema(options: PullGraphqlSchemaOptions): Promise<{
+    path: string;
+    schemaHash: string;
+    upToDate: boolean;
+    written: boolean;
+}>;

package/dist/graphql.d.ts

@@ -0,0 +1,8 @@
+import type { CompileOptions, Diagnostic, GraphqlContractSummary } from "./types";
+export interface GraphqlArtifacts {
+    diagnostics: Diagnostic[];
+    files: Record<string, string>;
+    contract?: GraphqlContractSummary;
+}
+/** Offline only: schema authority and role selection belong to the explicit snapshot workflow. */
+export declare function renderGraphql(options: CompileOptions): Promise<GraphqlArtifacts>;

package/dist/index.d.ts

@@ -23,5 +23,7 @@ export { DEFAULT_SUPACLOUD_CONFIG, compileOptionsFromConfig, defineSupacloudConf
 export type { SupaCloudConfig } from "./config";
 export { camelName } from "./util";
 export { ANGULAR_ENTERPRISE_RULES, CLEAN_ARCHITECTURE_RULES, MODULAR_MONOLITH_RULES, MODULE_BOUNDARY_PROFILES, getModuleBoundaryPreset, getModuleBoundaryProfile, resolveModuleBoundaries, } from "./profiles";
-export type { ApplicationGraph, AspectRefNode, CachedModuleEntry, CheckProjectResult, CommandExecutionCapabilities, CommandNode, CompileOptions, CompileResult, CompileStats, ControllerNode, DependencyGraphCache, DependencyGraphIndex, Diagnostic, DiagnosticFix, ModuleBoundaryPresetName, ModuleBoundaryProfile, ModuleBoundaryRule, ModuleNode, JobNode, ProviderKind, ProviderNode, QueryNode, RouteNode, Scope, TokenKind, TypeSafetyOptions, ValidateOptions, WatchEvent, WatchHandle, WatchOptions, FeatureSpecNode, FeatureTransitionNode, } from "./types";
+export type { ApplicationGraph, AspectRefNode, CachedModuleEntry, CheckProjectResult, CommandExecutionCapabilities, CommandNode, CompileOptions, CompileResult, CompileStats, ControllerNode, DependencyGraphCache, DependencyGraphIndex, Diagnostic, DiagnosticFix, ModuleBoundaryPresetName, ModuleBoundaryProfile, ModuleBoundaryRule, ModuleNode, JobNode, ProviderKind, ProviderNode, QueryNode, RouteNode, Scope, TokenKind, TypeSafetyOptions, ValidateOptions, WatchEvent, WatchHandle, WatchOptions, FeatureSpecNode, FeatureTransitionNode, GraphqlOptions, GraphqlContractSummary, } from "./types";
 export { inspectRouteContracts, validateRouteContracts } from "./route-contracts";
+export { pullGraphqlSchema } from "./graphql-schema";
+export type { PullGraphqlSchemaOptions } from "./graphql-schema";