@supacloud/compiler 0.12.0 → 0.13.1

package/dist/inspect.d.ts

@@ -21,6 +21,7 @@ export interface ContextPack {
         importedBy: string[];
         imports: string[];
     };
+    graphql?: ApplicationGraph["graphql"];
 }
 export interface DoctorResult {
     checks: Array<{

package/dist/types.d.ts

@@ -287,6 +287,8 @@ export interface ModuleNode {
     featureSpec?: FeatureSpecNode;
 }
 export interface ApplicationGraph {
+    /** Offline query inventory for AI context. Kept in graphql.manifest.json, not app.manifest.json. */
+    graphql?: GraphqlContractSummary;
     modules: ModuleNode[];
     /** Depended token names provided by platform injection rather than any module. */
     externalTokens: string[];
@@ -308,6 +310,8 @@ export interface ApplicationGraph {
     };
 }
 export interface CompileOptions {
+    /** Opt-in, offline GraphQL query contracts backed by a role-scoped schema snapshot. */
+    graphql?: GraphqlOptions;
     /** Require schemas for bound route inputs and responses. Does not prove runtime validation. */
     requireRouteContracts?: boolean;
     /** Project root directory (containing tsconfig). */
@@ -348,6 +352,30 @@ export interface CompileOptions {
     /** Type-safety gates for generated artifacts and production source. */
     typeSafety?: TypeSafetyOptions;
 }
+export interface GraphqlOptions {
+    /** Additionally emit standard TypedDocumentNode artifacts for GraphQL ecosystem clients. */
+    typedDocuments?: boolean;
+    /** Exported role-scoped database snapshot (.graphql/.gql/.json), never authored SDL or executable code.
+     * Relative to rootDir for the programmatic API. Offline compilation does not attest its origin. */
+    schema: string;
+    /** Query/fragment globs relative to rootDir. Defaults to all .graphql and .gql files. */
+    documents?: string[];
+    /** Explicit wire types for custom scalars. Unmapped scalars remain unknown. */
+    scalars?: Record<string, string | {
+        input: string;
+        output: string;
+    }>;
+}
+export interface GraphqlContractSummary {
+    schema: string;
+    schemaHash?: string;
+    documents: string[];
+    operations: Array<{
+        name: string;
+        file: string;
+        line: number;
+    }>;
+}
 export interface TypeSafetyOptions {
     /** Reject the `any` keyword in generated TypeScript artifacts. */
     noAnyInGenerated?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.12.0",
+  "version": "0.13.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",
@@ -22,11 +22,12 @@
   ],
   "scripts": {
     "build": "bun run clean && bun run build:js && bun run build:types",
-    "build:js": "bun build src/index.ts src/cli.ts --outdir dist --target node --external @typescript/typescript6",
+    "build:js": "bun build src/index.ts src/cli.ts --outdir dist --target node --external @typescript/typescript6 --external graphql --external '@graphql-codegen/*'",
     "build:types": "tsc -p tsconfig.json --emitDeclarationOnly",
     "clean": "rm -rf dist",
-    "prepublishOnly": "bun run build",
+    "prepublishOnly": "bun run build && bun run test:package",
     "test": "bun test",
+    "test:package": "SUPACLOUD_COMPILER_TEST_CLI=\"$PWD/dist/cli.js\" bun test src/graphql-package.test.ts",
     "benchmark": "bun run src/benchmark.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
@@ -45,7 +46,12 @@
     "directory": "packages/compiler"
   },
   "dependencies": {
-    "@typescript/typescript6": "^6.0.2"
+    "@graphql-codegen/core": "^6.2.0",
+    "@graphql-codegen/typed-document-node": "^7.1.0",
+    "@graphql-codegen/typescript-operations": "^6.1.6",
+    "@graphql-typed-document-node/core": "^3.2.0",
+    "@typescript/typescript6": "^6.0.2",
+    "graphql": "^16"
   },
   "devDependencies": {
     "@types/bun": "^1.4.0",