@openpkg-ts/sdk 0.34.1 → 0.35.0

package/dist/index.d.ts

@@ -33,6 +33,10 @@ interface ExtractOptions {
 	includePrivate?: boolean;
 	/** Configuration for resolving external package re-exports */
 	externals?: ExternalsConfig;
+	/** Max properties to serialize per object type (default: 20) */
+	maxProperties?: number;
+	/** Callback when properties are truncated */
+	onTruncation?: (typeName: string, actual: number, limit: number) => void;
 }
 interface ExtractResult {
 	spec: OpenPkg;
@@ -48,6 +52,12 @@ interface ExtractResult {
 		vendors: string[];
 		/** Any errors encountered during runtime extraction */
 		errors: string[];
+		/** Non-fatal warnings from extraction (e.g., individual schema failures) */
+		warnings: Array<{
+			code: string;
+			message: string;
+			exportName?: string;
+		}>;
 		/** Extraction method used: 'compiled' or 'direct-ts (runtime)' */
 		method?: string;
 	};
@@ -1165,6 +1175,10 @@ interface SerializerContext {
 	inTupleElement?: boolean;
 	/** Include private/protected class members (default: false) */
 	includePrivate?: boolean;
+	/** Max properties to serialize per object type (default: 20) */
+	maxProperties: number;
+	/** Callback when properties are truncated */
+	onTruncation?: (typeName: string, actual: number, limit: number) => void;
 }
 declare class TypeRegistry {
 	private types;
@@ -1296,11 +1310,34 @@ interface ExtractStandardSchemasOptions {
 	libraryOptions?: Record<string, unknown>;
 }
 /**
+* Warning codes for extraction diagnostics.
+*
+* - `SCHEMA_FAILED`: Standard Schema extraction failed (e.g., ~standard.jsonSchema.output() threw)
+* - `TYPEBOX_FAILED`: TypeBox schema sanitization failed
+* - `PARSE_FAILED`: Failed to parse subprocess JSON output
+* - `CLEANUP_FAILED`: Failed to delete temp worker script file
+* - `TSCONFIG_INVALID`: Could not parse tsconfig.json (uses defaults)
+*/
+type ExtractionWarningCode = "SCHEMA_FAILED" | "TYPEBOX_FAILED" | "PARSE_FAILED" | "CLEANUP_FAILED" | "TSCONFIG_INVALID" | "OUTPUT_TRUNCATED";
+/**
+* Warning from extraction process.
+* Captures non-fatal issues during schema extraction.
+*/
+interface ExtractionWarning {
+	/** Warning type identifier */
+	code: ExtractionWarningCode;
+	/** Human-readable description */
+	message: string;
+	/** Export name if applicable */
+	exportName?: string;
+}
+/**
 * Result of Standard Schema extraction.
 */
 interface StandardSchemaExtractionOutput {
 	schemas: Map<string, StandardSchemaExtractionResult>;
 	errors: string[];
+	warnings: ExtractionWarning[];
 }
 /**
 * Check if an object implements StandardJSONSchemaV1.
@@ -1719,4 +1756,4 @@ declare function normalizeMembers(members: SpecMember3[], options?: NormalizeOpt
 import ts16 from "typescript";
 declare function isExported(node: ts16.Node): boolean;
 declare function getNodeName(node: ts16.Node): string | undefined;
-export { zodAdapter, withDescription2 as withDescription, valibotAdapter, typeboxAdapter, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toReactString, toReact, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, sortByName, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveExportTarget, resolveCompiledPath, registerReferencedTypes, registerAdapter, recommendSemverBump, query, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isProperty, isPrimitiveName, isMethod, isExported, isBuiltinGeneric, isAnonymous, hasDeprecatedTag, groupByVisibility, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExport2 as getExport, getDeprecationMessage, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findMissingParamDocs, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, createProgram, createDocs, categorizeBreakingChanges, calculateNextVersion, buildSignatureString, buildSchema, arktypeAdapter, analyzeSpec, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecDiff, SpecDiagnostics, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaExtractionResult, SchemaAdapter, ReactLayoutOptions, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, JSONSchema, JSONOptions, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, DiagnosticItem, Diagnostic, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };
+export { zodAdapter, withDescription2 as withDescription, valibotAdapter, typeboxAdapter, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toReactString, toReact, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, sortByName, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveExportTarget, resolveCompiledPath, registerReferencedTypes, registerAdapter, recommendSemverBump, query, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isPureRefSchema, isProperty, isPrimitiveName, isMethod, isExported, isBuiltinGeneric, isAnonymous, hasDeprecatedTag, groupByVisibility, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExport2 as getExport, getDeprecationMessage, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findMissingParamDocs, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, createProgram, createDocs, categorizeBreakingChanges, calculateNextVersion, buildSignatureString, buildSchema, arktypeAdapter, analyzeSpec, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecDiff, SpecDiagnostics, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaExtractionResult, SchemaAdapter, ReactLayoutOptions, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, JSONSchema, JSONOptions, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractionWarningCode, ExtractionWarning, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, DiagnosticItem, Diagnostic, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };

package/dist/index.js

@@ -45,7 +45,10 @@ function loadConfig(cwd) {
     try {
       const content = fs.readFileSync(configPath, "utf-8");
       return JSON.parse(content);
-    } catch {}
+    } catch (err) {
+      const msg = err instanceof SyntaxError ? err.message : String(err);
+      console.warn(`Warning: Invalid JSON in ${CONFIG_FILENAME}: ${msg}`);
+    }
   }
   const pkgPath = path.join(cwd, "package.json");
   if (fs.existsSync(pkgPath)) {
@@ -55,7 +58,10 @@ function loadConfig(cwd) {
       if (pkg.openpkg) {
         return pkg.openpkg;
       }
-    } catch {}
+    } catch (err) {
+      const msg = err instanceof SyntaxError ? err.message : String(err);
+      console.warn(`Warning: Invalid JSON in package.json: ${msg}`);
+    }
   }
   return null;
 }
@@ -2529,9 +2535,11 @@ function buildSchemaInternal(type, checker, ctx) {
 function buildFunctionSchema(callSignatures, checker, ctx) {
   const buildSignatures = () => {
     const signatures = callSignatures.map((sig) => {
-      const params = sig.getParameters().map((param) => {
-        const paramType = checker.getTypeOfSymbolAtLocation(param, param.valueDeclaration);
+      const params = sig.getParameters().flatMap((param) => {
         const decl = param.valueDeclaration;
+        if (!decl)
+          return [];
+        const paramType = checker.getTypeOfSymbolAtLocation(param, decl);
         const isOptional = !!decl?.questionToken || !!decl?.initializer;
         return {
           name: param.getName(),
@@ -2712,7 +2720,9 @@ function extractParameters(signature, ctx) {
   const jsdocTags = signatureDecl ? ts4.getJSDocTags(signatureDecl) : [];
   for (const param of signature.getParameters()) {
     const decl = param.valueDeclaration;
-    const type = checker.getTypeOfSymbolAtLocation(param, decl ?? param.valueDeclaration);
+    if (!decl)
+      continue;
+    const type = checker.getTypeOfSymbolAtLocation(param, decl);
     if (decl && ts4.isObjectBindingPattern(decl.name)) {
       const expandedParams = expandBindingPattern(decl, type, jsdocTags, ctx);
       result.push(...expandedParams);
@@ -2857,7 +2867,12 @@ function registerReferencedTypes(type, ctx, depth = 0) {
   }
   if (type.flags & ts4.TypeFlags.Object) {
     const props = type.getProperties();
-    for (const prop of props.slice(0, 20)) {
+    const limit = ctx.maxProperties;
+    if (props.length > limit && ctx.onTruncation) {
+      const typeName = type.getSymbol()?.getName() ?? "anonymous";
+      ctx.onTruncation(typeName, props.length, limit);
+    }
+    for (const prop of props.slice(0, limit)) {
       const propType = checker.getTypeOfSymbol(prop);
       registerReferencedTypes(propType, ctx, depth + 1);
     }
@@ -3056,7 +3071,12 @@ class TypeRegistry {
     }
     const props = {};
     const required = [];
-    for (const prop of properties.slice(0, 20)) {
+    const limit = ctx.maxProperties;
+    if (properties.length > limit && ctx.onTruncation) {
+      const typeName = type.getSymbol()?.getName() ?? "anonymous";
+      ctx.onTruncation(typeName, properties.length, limit);
+    }
+    for (const prop of properties.slice(0, limit)) {
       const propName = prop.getName();
       if (propName.startsWith("_"))
         continue;
@@ -3090,7 +3110,9 @@ function createContext(program, sourceFile, options = {}) {
     typeRegistry: new TypeRegistry,
     exportedIds: new Set,
     visitedTypes: new Set,
-    includePrivate: options.includePrivate ?? false
+    includePrivate: options.includePrivate ?? false,
+    maxProperties: options.maxProperties ?? 20,
+    onTruncation: options.onTruncation
   };
 }
 function getInheritedMembers(classType, ownMemberNames, ctx, isStatic = false) {
@@ -3098,7 +3120,12 @@ function getInheritedMembers(classType, ownMemberNames, ctx, isStatic = false) {
   const inherited = [];
   const visited = new Set;
   const inheritedNames = new Set;
-  const typeToWalk = isStatic ? classType.getSymbol()?.valueDeclaration && checker.getTypeOfSymbolAtLocation(classType.getSymbol(), classType.getSymbol().valueDeclaration) : classType;
+  let typeToWalk = classType;
+  if (isStatic) {
+    const symbol = classType.getSymbol();
+    const valueDecl = symbol?.valueDeclaration;
+    typeToWalk = symbol && valueDecl ? checker.getTypeOfSymbolAtLocation(symbol, valueDecl) : undefined;
+  }
   if (!typeToWalk)
     return inherited;
   walkBaseTypes(typeToWalk, ownMemberNames, inherited, inheritedNames, visited, ctx, isStatic);
@@ -3249,6 +3276,8 @@ function serializeClass(node, ctx) {
           methodsByName.set(methodMember.name, methodMember);
         } else {
           const existing = methodsByName.get(methodMember.name);
+          if (!existing)
+            continue;
           if (!existing.description && methodMember.description) {
             existing.description = methodMember.description;
           }
@@ -4761,6 +4790,7 @@ import { spawn, spawnSync } from "node:child_process";
 import * as fs5 from "node:fs";
 import * as os from "node:os";
 import * as path5 from "node:path";
+var MAX_BUFFER_SIZE = 10 * 1024 * 1024;
 function isStandardJSONSchema(obj) {
   if (typeof obj !== "object" || obj === null)
     return false;
@@ -4860,6 +4890,7 @@ async function extract() {
     const absPath = path.resolve(modulePath);
     const mod = await import(pathToFileURL(absPath).href);
     const results = [];
+    const warnings = [];
 
     // Build exports map - handle both ESM and CJS (where exports are in mod.default)
     const exports = {};
@@ -4892,7 +4923,7 @@ async function extract() {
             inputSchema
           });
         } catch (e) {
-          // Skip schemas that fail to extract
+          warnings.push({ code: 'SCHEMA_FAILED', message: String(e), exportName: name });
         }
         continue;
       }
@@ -4906,15 +4937,15 @@ async function extract() {
             outputSchema: sanitizeTypeBoxSchema(value)
           });
         } catch (e) {
-          // Skip schemas that fail to extract
+          warnings.push({ code: 'TYPEBOX_FAILED', message: String(e), exportName: name });
         }
         continue;
       }
     }
 
-    console.log(JSON.stringify({ success: true, results }));
+    console.log(JSON.stringify({ success: true, results, warnings }));
   } catch (e) {
-    console.log(JSON.stringify({ success: false, error: e.message }));
+    console.log(JSON.stringify({ success: false, error: e.message, warnings: [] }));
   }
 }
 
@@ -4946,6 +4977,7 @@ async function extract() {
     const absPath = path.resolve(modulePath);
     const mod = await import(pathToFileURL(absPath).href);
     const results: Array<{exportName: string; vendor: string; outputSchema: unknown; inputSchema?: unknown}> = [];
+    const warnings: Array<{code: string; message: string; exportName?: string}> = [];
 
     // Build exports map
     const exports: Record<string, unknown> = {};
@@ -4974,7 +5006,9 @@ async function extract() {
             const outputSchema = (jsonSchema.output as Function)(options);
             const inputSchema = typeof jsonSchema.input === 'function' ? (jsonSchema.input as Function)(options) : undefined;
             results.push({ exportName: name, vendor: std.vendor as string, outputSchema, inputSchema });
-          } catch {}
+          } catch (e) {
+            warnings.push({ code: 'SCHEMA_FAILED', message: String(e), exportName: name });
+          }
           continue;
         }
       }
@@ -4983,13 +5017,15 @@ async function extract() {
       if (isTypeBoxSchema(value)) {
         try {
           results.push({ exportName: name, vendor: 'typebox', outputSchema: sanitizeTypeBoxSchema(value) });
-        } catch {}
+        } catch (e) {
+          warnings.push({ code: 'TYPEBOX_FAILED', message: String(e), exportName: name });
+        }
       }
     }
 
-    console.log(JSON.stringify({ success: true, results }));
+    console.log(JSON.stringify({ success: true, results, warnings }));
   } catch (e) {
-    console.log(JSON.stringify({ success: false, error: (e as Error).message }));
+    console.log(JSON.stringify({ success: false, error: (e as Error).message, warnings: [] }));
   }
 }
 
@@ -4999,7 +5035,8 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
   const { timeout = 1e4, target = "draft-2020-12", libraryOptions } = options;
   const result = {
     schemas: new Map,
-    errors: []
+    errors: [],
+    warnings: []
   };
   const runtime = detectTsRuntime();
   if (!runtime) {
@@ -5024,16 +5061,32 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
       });
       let stdout = "";
       let stderr = "";
+      let stdoutTruncated = false;
+      let stderrTruncated = false;
       child.stdout.on("data", (data) => {
-        stdout += data.toString();
+        if (stdout.length < MAX_BUFFER_SIZE) {
+          const chunk = data.toString();
+          stdout += chunk.slice(0, MAX_BUFFER_SIZE - stdout.length);
+          if (stdout.length >= MAX_BUFFER_SIZE)
+            stdoutTruncated = true;
+        }
       });
       child.stderr.on("data", (data) => {
-        stderr += data.toString();
+        if (stderr.length < MAX_BUFFER_SIZE) {
+          const chunk = data.toString();
+          stderr += chunk.slice(0, MAX_BUFFER_SIZE - stderr.length);
+          if (stderr.length >= MAX_BUFFER_SIZE)
+            stderrTruncated = true;
+        }
       });
       child.on("close", (code) => {
         try {
           fs5.unlinkSync(workerPath);
-        } catch {}
+        } catch (cleanupErr) {
+          if (cleanupErr?.code !== "ENOENT") {
+            result.warnings.push({ code: "CLEANUP_FAILED", message: String(cleanupErr) });
+          }
+        }
         if (code !== 0) {
           result.errors.push(`Extraction failed (${runtime.name}): ${stderr || `exit code ${code}`}`);
           resolve2(result);
@@ -5054,15 +5107,34 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
               inputSchema: item.inputSchema
             });
           }
+          if (Array.isArray(parsed.warnings)) {
+            for (const w of parsed.warnings) {
+              result.warnings.push({
+                code: w.code,
+                message: w.message,
+                exportName: w.exportName
+              });
+            }
+          }
         } catch (e) {
           result.errors.push(`Failed to parse extraction output: ${e}`);
         }
+        if (stdoutTruncated) {
+          result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stdout exceeded 10MB buffer limit" });
+        }
+        if (stderrTruncated) {
+          result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stderr exceeded 10MB buffer limit" });
+        }
         resolve2(result);
       });
       child.on("error", (err) => {
         try {
           fs5.unlinkSync(workerPath);
-        } catch {}
+        } catch (cleanupErr) {
+          if (cleanupErr?.code !== "ENOENT") {
+            result.warnings.push({ code: "CLEANUP_FAILED", message: String(cleanupErr) });
+          }
+        }
         result.errors.push(`Subprocess error: ${err.message}`);
         resolve2(result);
       });
@@ -5070,7 +5142,11 @@ async function extractStandardSchemasFromTs(tsFilePath, options = {}) {
   } catch (e) {
     try {
       fs5.unlinkSync(workerPath);
-    } catch {}
+    } catch (cleanupErr) {
+      if (cleanupErr?.code !== "ENOENT") {
+        result.warnings.push({ code: "CLEANUP_FAILED", message: String(cleanupErr) });
+      }
+    }
     result.errors.push(`Failed to create worker script: ${e}`);
     return result;
   }
@@ -5087,7 +5163,7 @@ function readTsconfigOutDir(baseDir) {
     if (tsconfig.compilerOptions?.outDir) {
       return tsconfig.compilerOptions.outDir.replace(/^\.\//, "");
     }
-  } catch {}
+  } catch (_e) {}
   return null;
 }
 function resolveCompiledPath(tsPath, baseDir) {
@@ -5131,7 +5207,8 @@ async function extractStandardSchemas(compiledJsPath, options = {}) {
   const { timeout = 1e4, target = "draft-2020-12", libraryOptions } = options;
   const result = {
     schemas: new Map,
-    errors: []
+    errors: [],
+    warnings: []
   };
   if (!fs5.existsSync(compiledJsPath)) {
     result.errors.push(`Compiled JS not found: ${compiledJsPath}`);
@@ -5145,11 +5222,23 @@ async function extractStandardSchemas(compiledJsPath, options = {}) {
     });
     let stdout = "";
     let stderr = "";
+    let stdoutTruncated = false;
+    let stderrTruncated = false;
     child.stdout.on("data", (data) => {
-      stdout += data.toString();
+      if (stdout.length < MAX_BUFFER_SIZE) {
+        const chunk = data.toString();
+        stdout += chunk.slice(0, MAX_BUFFER_SIZE - stdout.length);
+        if (stdout.length >= MAX_BUFFER_SIZE)
+          stdoutTruncated = true;
+      }
     });
     child.stderr.on("data", (data) => {
-      stderr += data.toString();
+      if (stderr.length < MAX_BUFFER_SIZE) {
+        const chunk = data.toString();
+        stderr += chunk.slice(0, MAX_BUFFER_SIZE - stderr.length);
+        if (stderr.length >= MAX_BUFFER_SIZE)
+          stderrTruncated = true;
+      }
     });
     child.on("close", (code) => {
       if (code !== 0) {
@@ -5172,9 +5261,24 @@ async function extractStandardSchemas(compiledJsPath, options = {}) {
             inputSchema: item.inputSchema
           });
         }
+        if (Array.isArray(parsed.warnings)) {
+          for (const w of parsed.warnings) {
+            result.warnings.push({
+              code: w.code,
+              message: w.message,
+              exportName: w.exportName
+            });
+          }
+        }
       } catch (e) {
         result.errors.push(`Failed to parse extraction output: ${e}`);
       }
+      if (stdoutTruncated) {
+        result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stdout exceeded 10MB buffer limit" });
+      }
+      if (stderrTruncated) {
+        result.warnings.push({ code: "OUTPUT_TRUNCATED", message: "stderr exceeded 10MB buffer limit" });
+      }
       resolve2(result);
     });
     child.on("error", (err) => {
@@ -5210,7 +5314,8 @@ async function extractStandardSchemasFromProject(entryFile, baseDir, options = {
   const hint = isTypeScript && !runtime ? " Install bun, tsx, or ts-node for direct TS execution." : "";
   return {
     schemas: new Map,
-    errors: [`Could not find compiled JS for ${entryFile}.${hint}`]
+    errors: [`Could not find compiled JS for ${entryFile}.${hint}`],
+    warnings: []
   };
 }
 
@@ -5796,7 +5901,9 @@ async function extract(options) {
       ignore,
       onProgress,
       isDtsSource,
-      includePrivate
+      includePrivate,
+      maxProperties,
+      onTruncation
     } = options;
     const diagnostics = [];
     let exports = [];
@@ -5836,7 +5943,9 @@ async function extract(options) {
       maxTypeDepth,
       maxExternalTypeDepth,
       resolveExternalTypes,
-      includePrivate
+      includePrivate,
+      maxProperties,
+      onTruncation
     });
     ctx.exportedIds = exportedIds;
     const filteredSymbols = exportedSymbols.filter((s) => shouldIncludeExport(s.getName(), only, ignore));
@@ -5845,6 +5954,8 @@ async function extract(options) {
       const symbol = filteredSymbols[i];
       const exportName = symbol.getName();
       const tracker = exportTracker.get(exportName);
+      if (!tracker)
+        continue;
       onProgress?.(i + 1, total, exportName);
       if (i > 0 && i % YIELD_BATCH_SIZE === 0) {
         await new Promise((r) => setImmediate(r));
@@ -5976,6 +6087,7 @@ async function extract(options) {
           merged: mergeResult.merged,
           vendors: [...new Set([...runtimeResult.schemas.values()].map((s) => s.vendor))],
           errors: runtimeResult.errors,
+          warnings: runtimeResult.warnings,
           method
         };
       }
@@ -5986,6 +6098,13 @@ async function extract(options) {
           code: "RUNTIME_SCHEMA_ERROR"
         });
       }
+      for (const warning of runtimeResult.warnings) {
+        diagnostics.push({
+          message: `Schema extraction skipped${warning.exportName ? ` (${warning.exportName})` : ""}: ${warning.message}`,
+          severity: "warning",
+          code: warning.code
+        });
+      }
     }
     const normalizedExports = exports.map((exp) => normalizeExport(exp, { dialect: "draft-2020-12" }));
     const normalizedTypes = types.map((t) => normalizeType(t, { dialect: "draft-2020-12" }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/sdk",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "description": "TypeScript API extraction SDK - programmatic primitives for OpenPkg specs",
   "keywords": [
     "openpkg",