@apollo-deploy/tesseract 2.0.0 → 2.2.0

package/dist/pipeline/validate.d.ts

@@ -0,0 +1,11 @@
+import type { EnrichedSDKIR } from '../types/ir.js';
+/**
+ * Rejects SDK contracts whose shape has already been erased.
+ *
+ * Tesseract can translate concrete schemas between languages. It cannot recover
+ * fields from `unknown`, `Any`, `JsonElement`, or an untyped JSON map. Failing
+ * here keeps every generated target honest instead of quietly emitting catch-all
+ * types such as JsonElement, Any, mixed, or interface{}.
+ */
+export declare function validateConcreteContract(enriched: EnrichedSDKIR): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/pipeline/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/pipeline/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAId,MAAM,gBAAgB,CAAC;AAKxB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGtE"}

package/dist/pipeline/validate.js

@@ -0,0 +1,67 @@
+const DYNAMIC_TYPE_PATTERN = /\b(?:unknown|any|JsonElement|JsonObject|JsonArray|JsonPrimitive|JsonNull|Any)\b|serde_json::Value|interface\s*\{\s*\}/;
+/**
+ * Rejects SDK contracts whose shape has already been erased.
+ *
+ * Tesseract can translate concrete schemas between languages. It cannot recover
+ * fields from `unknown`, `Any`, `JsonElement`, or an untyped JSON map. Failing
+ * here keeps every generated target honest instead of quietly emitting catch-all
+ * types such as JsonElement, Any, mixed, or interface{}.
+ */
+export function validateConcreteContract(enriched) {
+    for (const schema of enriched.schemas)
+        validateSchema(schema);
+    for (const group of enriched.groups)
+        validateGroup(group);
+}
+function validateSchema(schema) {
+    if (schema.ownership?.kind === 'external')
+        return;
+    if (DYNAMIC_TYPE_PATTERN.test(schema.name)) {
+        fail(`schema ${schema.name}`, schema.name);
+    }
+    checkType(`schema ${schema.name} alias`, schema.aliasType);
+    checkType(`schema ${schema.name} additionalProperties`, schema.additionalPropertiesType);
+    for (const [index, member] of (schema.unionMembers ?? []).entries()) {
+        checkType(`schema ${schema.name} union member ${index + 1}`, member);
+    }
+    for (const [index, member] of (schema.intersectionMembers ?? []).entries()) {
+        checkType(`schema ${schema.name} intersection member ${index + 1}`, member);
+    }
+    for (const property of schema.properties) {
+        checkType(`schema ${schema.name}.${property.name}`, property.type);
+    }
+}
+function validateGroup(group) {
+    for (const operation of group.operations)
+        validateOperation(group, operation);
+}
+function validateOperation(group, operation) {
+    const location = `${operation.httpMethod} ${operation.path} (${group.name}.${operation.name})`;
+    checkType(`${location} response`, operation.responseType);
+    checkType(`${location} request body`, operation.requestBody?.type);
+    checkType(`${location} query`, operation.queryType);
+    checkType(`${location} headers`, operation.headerType);
+    checkType(`${location} cookies`, operation.cookieType);
+    checkType(`${location} event`, operation.eventSchema);
+    checkType(`${location} SSE envelope`, operation.sseReturnType);
+    for (const parameter of [
+        ...operation.pathParams,
+        ...operation.queryParams,
+        ...operation.headerParams,
+        ...operation.cookieParams,
+    ]) {
+        checkType(`${location} parameter ${parameter.originalName}`, parameter.type);
+    }
+}
+function checkType(location, type) {
+    if (!type || type === 'void' || type === 'never')
+        return;
+    if (DYNAMIC_TYPE_PATTERN.test(type))
+        fail(location, type);
+}
+function fail(location, type) {
+    throw new Error(`Tesseract cannot generate a complete SDK model for ${location}: ${type}. ` +
+        'Replace dynamic JSON/Any/unknown fields with a concrete serializable model. ' +
+        'For example, use Map<String, PaymentMethod> instead of Map<String, JsonElement>.');
+}
+//# sourceMappingURL=validate.js.map

package/dist/pipeline/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/pipeline/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apollo-deploy/tesseract",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "type": "module",
   "description": "Manifest-first SDK generator for TypeScript, Python, Ruby, PHP, Go, Rust, Kotlin, and C#",
   "bin": {
@@ -59,8 +59,10 @@
   "scripts": {
     "build": "tsc",
     "dev": "bun src/cli.ts",
-    "prepublishOnly": "npm test",
-    "test": "npm run build && node --test test/*.test.mjs"
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui"
   },
   "dependencies": {
     "change-case": "^5.4.4",
@@ -109,6 +111,8 @@
   "devDependencies": {
     "@types/node": "^20.14.0",
     "fastify": "^5.8.5",
-    "typescript": "^5.5.0"
+    "typescript": "^5.5.0",
+    "vitest": "^3.2.4",
+    "@vitest/coverage-v8": "^3.2.4"
   }
 }

package/templates/kotlin/types.hbs

@@ -2,13 +2,9 @@ package {{packageName}}.models
 
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
-import kotlinx.serialization.json.JsonElement
 
 {{#each schemas}}
-{{#if external}}
-typealias {{name}} = JsonElement
-
-{{else if isEnum}}
+{{#if isEnum}}
 {{#if stringEnum}}
 @Serializable
 enum class {{name}} {
@@ -20,12 +16,6 @@ enum class {{name}} {
 typealias {{name}} = Double
 {{/if}}
 
-{{else if isUnionType}}
-typealias {{name}} = JsonElement
-
-{{else if isIntersectionType}}
-typealias {{name}} = JsonElement
-
 {{else if isTypeAlias}}
 typealias {{name}} = {{{aliasType}}}
 

package/templates/typescript/package-json.hbs

@@ -16,7 +16,8 @@
     "prepublishOnly": "tsc"
   },
   "dependencies": {
-    "axios": "1.14.0"{{#each externalPackages}},
+    "axios": "1.14.0",
+    "zod": "^4.4.0"{{#each externalPackages}},
     "{{name}}": "{{version}}"{{/each}}
   },
   "devDependencies": {

package/templates/typescript/types.hbs

@@ -17,11 +17,11 @@ export { SDKError } from './errors.js';
 
 // ── Per-domain type files ────────────────────────────
 {{#each domainTypeFiles}}
-export type * from './{{this}}.js';
+export * from './{{this}}.js';
 {{/each}}
 {{/if}}
 {{#if includeModels}}
-export type * from './models.js';
+export * from './models.js';
 {{/if}}
 {{#if externalImports.length}}