@workos/oagen 0.30.2 → 0.31.0

package/dist/compat/index.d.mts

@@ -1,15 +1,64 @@
-import { $ as AdditiveChangeCategory, At as CompatSnapshot, Bt as ALL_LANGUAGE_IDS, Ct as MethodOverlay, Dt as ViolationSeverity, Et as ViolationCategory, Ft as CompatTypeRef, Ht as getDefaultPolicy, It as CompatVisibility, Lt as LanguageId, Mt as CompatStability, Nt as CompatSymbol, Ot as CompatParameter, Pt as CompatSymbolKind, Rt as ParameterSensitivity, St as LanguageHints, Tt as Violation, Ut as mergePolicy, Vt as CompatPolicyHints, _t as ApiProperty, at as CompatFailLevel, bt as DiffResult, ct as defaultSeverityForCategory, dt as ApiClass, et as BreakingChangeCategory, ft as ApiEnum, gt as ApiParam, ht as ApiMethod, it as CompatConfig, jt as CompatSourceKind, kt as CompatPassingStyle, lt as severityMeetsThreshold, mt as ApiInterface, nt as CompatChangeCategory, ot as CompatProvenance, pt as ApiField, rt as CompatChangeSeverity, st as SoftRiskChangeCategory, t as ApiSpec, tt as CompatApproval, ut as Addition, vt as ApiSurface, wt as OverlayLookup, xt as Extractor, yt as ApiTypeAlias, zt as apiSurfaceToSnapshot } from "../types-BcbGLNkh.mjs";
-import { a as specDerivedEnumValues, c as specDerivedMethodPaths, d as ClassifiedChange, f as classifyAddedSymbol, i as filterSurface, l as specDerivedNames, m as summarizeChanges, n as diffSnapshots, o as specDerivedFieldPaths, p as classifySymbolChanges, r as diffSurfaces, s as specDerivedHttpKeys, t as CompatDiffResult, u as ClassificationResult } from "../differ-nZSxhCfC.mjs";
-
+import { At as ViolationCategory, Bt as CompatVisibility, Ct as ApiTypeAlias, Dt as MethodOverlay, Et as LanguageHints, Ft as CompatSourceKind, Gt as CompatPolicyHints, Ht as ParameterSensitivity, It as CompatStability, Kt as getDefaultPolicy, Lt as CompatSymbol, Mt as CompatParameter, Nt as CompatPassingStyle, Ot as OverlayLookup, Pt as CompatSnapshot, Rt as CompatSymbolKind, St as ApiSurface, Tt as Extractor, Ut as apiSurfaceToSnapshot, Vt as LanguageId, Wt as ALL_LANGUAGE_IDS, _t as ApiField, at as CompatApproval, bt as ApiParam, ct as CompatConfig, dt as SoftRiskChangeCategory, ft as defaultSeverityForCategory, gt as ApiEnum, ht as ApiClass, it as BreakingChangeCategory, jt as ViolationSeverity, kt as Violation, lt as CompatFailLevel, mt as Addition, ot as CompatChangeCategory, pt as severityMeetsThreshold, qt as mergePolicy, rt as AdditiveChangeCategory, st as CompatChangeSeverity, t as ApiSpec, ut as CompatProvenance, vt as ApiInterface, wt as DiffResult, xt as ApiProperty, yt as ApiMethod, zt as CompatTypeRef } from "../types-I7W7CNl1.mjs";
+import { a as ClassifiedChange, c as summarizeChanges, i as ClassificationResult, n as diffSnapshots, o as classifyAddedSymbol, r as diffSurfaces, s as classifySymbolChanges, t as CompatDiffResult } from "../differ-B0DSuKUZ.mjs";
 //#region src/compat/schema.d.ts
 /** Current schema version for compatibility snapshots. */
-declare const COMPAT_SCHEMA_VERSION = "1";
+export declare const COMPAT_SCHEMA_VERSION = "1";
 /** Validate that a parsed snapshot has a compatible schema version. */
-declare function isCompatibleSchemaVersion(snapshot: {
+export declare function isCompatibleSchemaVersion(snapshot: {
   schemaVersion?: string;
 }): boolean;
 /** Validate the basic structure of a parsed compat snapshot. */
-declare function validateSnapshot(data: unknown): data is CompatSnapshot;
+export declare function validateSnapshot(data: unknown): data is CompatSnapshot;
+//#endregion
+//#region src/compat/spec-filter.d.ts
+/**
+ * Compute the set of symbol names that are derivable from the OpenAPI spec.
+ * Only these names should be compared during compat verification — everything
+ * else in the baseline is hand-written and out of scope for generation.
+ */
+export declare function specDerivedNames(spec: ApiSpec, hints: LanguageHints): Set<string>;
+/**
+ * Compute a map of enum name → set of wire values that appear in the spec.
+ * Used by filterSurface to exclude hand-added enum members that aren't in the spec.
+ */
+export declare function specDerivedEnumValues(spec: ApiSpec): Map<string, Set<string | number>>;
+/**
+ * Compute the set of field paths (e.g., "Organization.name") that are defined
+ * in the OpenAPI spec's model schemas. Used by filterSurface to exclude
+ * hand-added SDK fields that reference spec-derived types.
+ */
+export declare function specDerivedFieldPaths(spec: ApiSpec, hints: LanguageHints): Set<string>;
+/**
+ * Compute the set of method paths (e.g., "Auth.authorize") that are defined
+ * as operations in the OpenAPI spec's services. Used by filterSurface to
+ * exclude hand-written SDK methods that don't correspond to spec operations.
+ */
+export declare function specDerivedMethodPaths(spec: ApiSpec): Set<string>;
+/**
+ * Compute the set of HTTP operation keys (e.g., "GET /auth/authorize") that
+ * exist in the spec. Used for overlay-based method matching.
+ */
+export declare function specDerivedHttpKeys(spec: ApiSpec): Set<string>;
+/**
+ * Filter an ApiSurface to only include symbols whose names appear in the
+ * allowed set. Symbols not in the set are dropped entirely — they won't
+ * count toward the total or produce violations.
+ *
+ * For interfaces: when fieldPaths is provided, only keeps fields that appear
+ * in the spec-derived field paths. This prevents false positives from hand-added
+ * SDK fields that reference spec-derived types but aren't defined in the spec.
+ *
+ * For classes: when methodPaths is provided, only keeps methods whose names
+ * appear in the spec-derived method paths. This prevents false positives from
+ * hand-written SDK methods (e.g., Auth.authorization_url, Webhooks.construct_event)
+ * that don't correspond to spec operations. Properties on service classes are
+ * also filtered: only UPPER_CASE constants that are spec-derivable are kept.
+ */
+export declare function filterSurface(surface: ApiSurface, allowedNames: Set<string>, opts?: {
+  fieldPaths?: Set<string>;
+  methodPaths?: Set<string>;
+  enumValues?: Map<string, Set<string | number>>;
+}): ApiSurface;
 //#endregion
 //#region src/compat/concepts.d.ts
 /** A conceptual change with per-language severity. */
@@ -40,14 +89,14 @@ interface ConceptualRollup {
  * derived from the symbol, category, and match details. Changes with the
  * same ID across different languages represent the same conceptual change.
  */
-declare function buildConceptualRollup(perLanguageResults: Array<{
+export declare function buildConceptualRollup(perLanguageResults: Array<{
   diff: CompatDiffResult;
   language: LanguageId;
 }>): ConceptualRollup;
 /** Get the highest severity across all languages for a conceptual change. */
-declare function highestSeverity(change: ConceptualChange): CompatChangeSeverity;
+export declare function highestSeverity(change: ConceptualChange): CompatChangeSeverity;
 /** Count conceptual changes by highest severity. */
-declare function summarizeConceptualChanges(rollup: ConceptualRollup): {
+export declare function summarizeConceptualChanges(rollup: ConceptualRollup): {
   breaking: number;
   softRisk: number;
   additive: number;
@@ -79,9 +128,9 @@ interface CompatReportChange {
   remediation?: string;
 }
 /** Generate a machine-readable compat report from a diff result. */
-declare function generateReport(diff: CompatDiffResult, language?: string): CompatReport;
+export declare function generateReport(diff: CompatDiffResult, language?: string): CompatReport;
 /** Generate a human-readable summary string for terminal output. */
-declare function formatHumanSummary(diff: CompatDiffResult, opts?: {
+export declare function formatHumanSummary(diff: CompatDiffResult, opts?: {
   explain?: boolean;
   language?: string;
 }): string;
@@ -95,12 +144,12 @@ interface ConceptualReport {
   }[];
 }
 /** Generate a conceptual cross-language report from multiple per-language results. */
-declare function generateConceptualReport(perLanguageResults: Array<{
+export declare function generateConceptualReport(perLanguageResults: Array<{
   diff: CompatDiffResult;
   language: LanguageId;
 }>): ConceptualReport;
 /** Format a conceptual cross-language summary for terminal output. */
-declare function formatConceptualSummary(perLanguageResults: Array<{
+export declare function formatConceptualSummary(perLanguageResults: Array<{
   diff: CompatDiffResult;
   language: LanguageId;
 }>): string;
@@ -121,28 +170,28 @@ interface ApprovalValidation {
   errors: string[];
 }
 /** Validate that an approval is narrow enough to be accepted. */
-declare function validateApproval(approval: CompatApproval): ApprovalValidation;
+export declare function validateApproval(approval: CompatApproval): ApprovalValidation;
 /** Validate all approvals in a config. Returns errors keyed by index. */
-declare function validateApprovals(approvals: CompatApproval[]): Map<number, string[]>;
+export declare function validateApprovals(approvals: CompatApproval[]): Map<number, string[]>;
 /**
  * Match a classified change against a list of approvals.
  * Returns the first matching approval, or null if none match.
  */
-declare function matchApproval(change: ClassifiedChange, approvals: CompatApproval[], language: LanguageId): CompatApproval | null;
+export declare function matchApproval(change: ClassifiedChange, approvals: CompatApproval[], language: LanguageId): CompatApproval | null;
 /**
  * Apply approvals to a list of changes.
  * Returns matches for every change (approved or not).
  */
-declare function applyApprovals(changes: ClassifiedChange[], approvals: CompatApproval[], language: LanguageId): ApprovalMatch[];
+export declare function applyApprovals(changes: ClassifiedChange[], approvals: CompatApproval[], language: LanguageId): ApprovalMatch[];
 /**
  * Filter changes to only those NOT covered by approvals.
  * These are the remaining unapproved changes that may cause failure.
  */
-declare function unapprovedChanges(changes: ClassifiedChange[], approvals: CompatApproval[], language: LanguageId): ClassifiedChange[];
+export declare function unapprovedChanges(changes: ClassifiedChange[], approvals: CompatApproval[], language: LanguageId): ClassifiedChange[];
 //#endregion
 //#region src/compat/extractor-registry.d.ts
-declare function registerExtractor(extractor: Extractor): void;
-declare function getExtractor(language: string): Extractor;
+export declare function registerExtractor(extractor: Extractor): void;
+export declare function getExtractor(language: string): Extractor;
 //#endregion
 //#region src/compat/overlay.d.ts
 interface ManifestEntry {
@@ -155,62 +204,62 @@ interface ManifestEntry {
   bodyFields: string[];
   queryFields: string[];
 }
-declare function buildOverlayLookup(surface: ApiSurface, manifest?: ManifestEntry[], spec?: ApiSpec, hints?: LanguageHints, options?: {
+export declare function buildOverlayLookup(surface: ApiSurface, manifest?: ManifestEntry[], spec?: ApiSpec, hints?: LanguageHints, options?: {
   strictModelMatch?: boolean;
 }): OverlayLookup;
 /** Check if a classified change is patchable by the overlay loop. */
-declare function isPatchableChange(change: ClassifiedChange): boolean;
+export declare function isPatchableChange(change: ClassifiedChange): boolean;
 /**
  * Patch overlay with classified changes from a failed verification.
  * Adds explicit name mappings for symbols that were generated with wrong names.
  * Returns a new OverlayLookup (immutable).
  */
-declare function patchOverlay(overlay: OverlayLookup, changes: ClassifiedChange[], baseline: ApiSurface): OverlayLookup;
+export declare function patchOverlay(overlay: OverlayLookup, changes: ClassifiedChange[], baseline: ApiSurface): OverlayLookup;
 //#endregion
 //#region src/compat/extractors/node.d.ts
-declare const nodeExtractor: Extractor;
+export declare const nodeExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/php.d.ts
 /** Default PHP extractor with generic language hints (no SDK-specific bases). */
-declare const phpExtractor: Extractor;
+export declare const phpExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/python.d.ts
 /** Default Python extractor with generic language hints (no SDK-specific bases). */
-declare const pythonExtractor: Extractor;
+export declare const pythonExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/ruby.d.ts
-declare const rubyExtractor: Extractor;
+export declare const rubyExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/go.d.ts
-declare const goExtractor: Extractor;
+export declare const goExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/rust.d.ts
-declare const rustExtractor: Extractor;
+export declare const rustExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/kotlin.d.ts
-declare const kotlinExtractor: Extractor;
+export declare const kotlinExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/dotnet.d.ts
 /** Default DotNet extractor with generic language hints. */
-declare const dotnetExtractor: Extractor;
+export declare const dotnetExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/elixir.d.ts
-declare const elixirExtractor: Extractor;
+export declare const elixirExtractor: Extractor;
 //#endregion
 //#region src/compat/extractors/ios.d.ts
-declare const iosExtractor: Extractor;
+export declare const iosExtractor: Extractor;
 //#endregion
 //#region src/compat/language-hints.d.ts
 /**
  * Node/TypeScript language hints — reference implementation.
  * Extracted from the hardcoded logic previously in differ.ts and overlay.ts.
  */
-declare const nodeHints: LanguageHints;
+export declare const nodeHints: LanguageHints;
 /**
  * Merge partial language hint overrides over nodeHints defaults.
  * Any hint not provided falls back to the Node/TypeScript implementation.
  */
-declare function resolveHints(overrides: Partial<LanguageHints>): LanguageHints;
+export declare function resolveHints(overrides: Partial<LanguageHints>): LanguageHints;
 //#endregion
-export { ALL_LANGUAGE_IDS, type Addition, type AdditiveChangeCategory, type ApiClass, type ApiEnum, type ApiField, type ApiInterface, type ApiMethod, type ApiParam, type ApiProperty, type ApiSurface, type ApiTypeAlias, type ApprovalMatch, type ApprovalValidation, type BreakingChangeCategory, COMPAT_SCHEMA_VERSION, type ClassificationResult, type ClassifiedChange, type CompatApproval, type CompatChangeCategory, type CompatChangeSeverity, type CompatConfig, type CompatDiffResult, type CompatFailLevel, type CompatParameter, type CompatPassingStyle, type CompatPolicyHints, type CompatProvenance, type CompatReport, type CompatReportChange, type CompatSnapshot, type CompatSourceKind, type CompatStability, type CompatSymbol, type CompatSymbolKind, type CompatTypeRef, type CompatVisibility, type ConceptualChange, type ConceptualReport, type ConceptualRollup, type DiffResult, type Extractor, type LanguageHints, type LanguageId, type MethodOverlay, type OverlayLookup, type ParameterSensitivity, type SoftRiskChangeCategory, type Violation, type ViolationCategory, type ViolationSeverity, apiSurfaceToSnapshot, applyApprovals, buildConceptualRollup, buildOverlayLookup, classifyAddedSymbol, classifySymbolChanges, defaultSeverityForCategory, diffSnapshots, diffSurfaces, dotnetExtractor, elixirExtractor, filterSurface, formatConceptualSummary, formatHumanSummary, generateConceptualReport, generateReport, getDefaultPolicy, getExtractor, goExtractor, highestSeverity, iosExtractor, isCompatibleSchemaVersion, isPatchableChange, kotlinExtractor, matchApproval, mergePolicy, nodeExtractor, nodeHints, patchOverlay, phpExtractor, pythonExtractor, registerExtractor, resolveHints, rubyExtractor, rustExtractor, severityMeetsThreshold, specDerivedEnumValues, specDerivedFieldPaths, specDerivedHttpKeys, specDerivedMethodPaths, specDerivedNames, summarizeChanges, summarizeConceptualChanges, unapprovedChanges, validateApproval, validateApprovals, validateSnapshot };
+export { ALL_LANGUAGE_IDS, type Addition, type AdditiveChangeCategory, type ApiClass, type ApiEnum, type ApiField, type ApiInterface, type ApiMethod, type ApiParam, type ApiProperty, type ApiSurface, type ApiTypeAlias, type ApprovalMatch, type ApprovalValidation, type BreakingChangeCategory, type ClassificationResult, type ClassifiedChange, type CompatApproval, type CompatChangeCategory, type CompatChangeSeverity, type CompatConfig, type CompatDiffResult, type CompatFailLevel, type CompatParameter, type CompatPassingStyle, type CompatPolicyHints, type CompatProvenance, type CompatReport, type CompatReportChange, type CompatSnapshot, type CompatSourceKind, type CompatStability, type CompatSymbol, type CompatSymbolKind, type CompatTypeRef, type CompatVisibility, type ConceptualChange, type ConceptualReport, type ConceptualRollup, type DiffResult, type Extractor, type LanguageHints, type LanguageId, type MethodOverlay, type OverlayLookup, type ParameterSensitivity, type SoftRiskChangeCategory, type Violation, type ViolationCategory, type ViolationSeverity, apiSurfaceToSnapshot, classifyAddedSymbol, classifySymbolChanges, defaultSeverityForCategory, diffSnapshots, diffSurfaces, getDefaultPolicy, mergePolicy, severityMeetsThreshold, summarizeChanges };
 //# sourceMappingURL=index.d.mts.map

package/dist/compat/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/compat/schema.ts","../../src/compat/concepts.ts","../../src/compat/report.ts","../../src/compat/approvals.ts","../../src/compat/extractor-registry.ts","../../src/compat/overlay.ts","../../src/compat/extractors/node.ts","../../src/compat/extractors/php.ts","../../src/compat/extractors/python.ts","../../src/compat/extractors/ruby.ts","../../src/compat/extractors/go.ts","../../src/compat/extractors/rust.ts","../../src/compat/extractors/kotlin.ts","../../src/compat/extractors/dotnet.ts","../../src/compat/extractors/elixir.ts","../../src/compat/extractors/ios.ts","../../src/compat/language-hints.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/compat/schema.ts","../../src/compat/spec-filter.ts","../../src/compat/concepts.ts","../../src/compat/report.ts","../../src/compat/approvals.ts","../../src/compat/extractor-registry.ts","../../src/compat/overlay.ts","../../src/compat/extractors/node.ts","../../src/compat/extractors/php.ts","../../src/compat/extractors/python.ts","../../src/compat/extractors/ruby.ts","../../src/compat/extractors/go.ts","../../src/compat/extractors/rust.ts","../../src/compat/extractors/kotlin.ts","../../src/compat/extractors/dotnet.ts","../../src/compat/extractors/elixir.ts","../../src/compat/extractors/ios.ts","../../src/compat/language-hints.ts"],"mappings":";;;;qBAUa;;wBAGG,0BAA0B;EAAY;;;wBAKtC,iBAAiB,gBAAgB,QAAQ;;;;;;;;wBCTzC,iBAAiB,MAAM,SAAS,OAAO,gBAAgB;;;;;wBAsDvD,sBAAsB,MAAM,UAAU,YAAY;;;;;;wBAalD,sBAAsB,MAAM,SAAS,OAAO,gBAAgB;;;;;;wBAqB5D,uBAAuB,MAAM,UAAU;;;;;wBAcvC,oBAAoB,MAAM,UAAU;;;;;;;;;;;;;;;;wBAoDpC,cACd,SAAS,YACT,cAAc,aACd;EACE,aAAa;EACb,cAAc;EACd,aAAa,YAAY;IAE1B;;;;UC7Jc;;EAEf;;EAEA;;EAEA,UAAU;;EAEV,QAAQ,QAAQ,OAAO,YAAY;;EAEnC;;EAEA,KAAK;;EAEL,KAAK;;;UAIU;EACf,mBAAmB;;;;;;;;;wBAUL,sBACd,oBAAoB;EAAQ,MAAM;EAAkB,UAAU;KAC7D;;wBA4Ba,gBAAgB,QAAQ,mBAAmB;;wBAQ3C,2BAA2B,QAAQ;EACjD;EACA;EACA;;;;;UCnEe;EACf;EACA;EACA;IACE;IACA;IACA;;EAEF,SAAS;;;UAIM;EACf,UAAU;EACV,UAAU;EACV;EACA;EACA,YAAY;EACZ,KAAK;EACL,KAAK;EACL;;EAEA;;;wBAIc,eAAe,MAAM,kBAAkB,oBAAoB;;wBAwB3D,mBAAmB,MAAM,kBAAkB;EAAS;EAAmB;;;UA2DtE;EACf;IACE;IACA;IACA,UAAU;IACV,QAAQ,QAAQ,OAAO,YAAY;;;;wBAKvB,yBACd,oBAAoB;EAAQ,MAAM;EAAkB,UAAU;KAC7D;;wBAaa,wBACd,oBAAoB;EAAQ,MAAM;EAAkB,UAAU;;;;;UCzI/C;;EAEf,QAAQ;;EAER,UAAU;;EAEV;;;UAIe;EACf;EACA;;;wBAQc,iBAAiB,UAAU,iBAAiB;;wBA2B5C,kBAAkB,WAAW,mBAAmB;;;;;wBAmBhD,cACd,QAAQ,kBACR,WAAW,kBACX,UAAU,aACT;;;;;wBAaa,eACd,SAAS,oBACT,WAAW,kBACX,UAAU,aACT;;;;;wBAea,kBACd,SAAS,oBACT,WAAW,kBACX,UAAU,aACT;;;wBCpHa,kBAAkB,WAAW;wBAI7B,aAAa,mBAAmB;;;UCD/B;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;wBAoDc,mBACd,SAAS,YACT,WAAW,iBACX,OAAO,SACP,QAAQ,eACR;EAAY;IACX;;wBA6aa,kBAAkB,QAAQ;;;;;;wBAS1B,aAAa,SAAS,eAAe,SAAS,oBAAoB,UAAU,aAAa;;;qBC3e5F,eAAe;;;;qBCqMf,cAAc;;;;qBCwJd,iBAAiB;;;qBC7RjB,eAAe;;;qBC2Df,aAAa;;;qBCjEb,eAAe;;;qBCJf,iBAAiB;;;;qBCsLjB,iBAAiB;;;qBCnKjB,iBAAiB;;;qBCOjB,cAAc;;;;;;;qBCtCd,WAAW;;;;;wBAuJR,aAAa,WAAW,QAAQ,iBAAiB"}

package/dist/compat/index.mjs

@@ -1,5 +1,5 @@
-import { t as safeParse$1, v as ExtractorError } from "../tree-sitter-CDKm3n64.mjs";
-import { A as getDefaultPolicy, C as defaultSeverityForCategory, D as isCompatibleSchemaVersion, E as COMPAT_SCHEMA_VERSION, O as validateSnapshot, S as summarizeChanges, T as apiSurfaceToSnapshot, _ as nodeHints, a as registerExtractor, b as classifyAddedSymbol, c as filterSurface, d as specDerivedHttpKeys, f as specDerivedMethodPaths, g as namedTypeWordsOverlap, h as defaultIsNullableOnlyDifference, i as getExtractor, j as mergePolicy, k as ALL_LANGUAGE_IDS, l as specDerivedEnumValues, m as NAMED_TYPE_RE, n as isPatchableChange, o as diffSnapshots, p as specDerivedNames, r as patchOverlay, s as diffSurfaces, t as buildOverlayLookup, u as specDerivedFieldPaths, v as resolveHints, w as severityMeetsThreshold, x as classifySymbolChanges, y as typeExistsInSurface } from "../overlay-DWAHPofk.mjs";
+import { t as safeParse$1, v as ExtractorError } from "../tree-sitter-C7Hk-NDu.mjs";
+import { A as getDefaultPolicy, C as defaultSeverityForCategory, D as isCompatibleSchemaVersion, E as COMPAT_SCHEMA_VERSION, O as validateSnapshot, S as summarizeChanges, T as apiSurfaceToSnapshot, _ as nodeHints, a as registerExtractor, b as classifyAddedSymbol, c as filterSurface, d as specDerivedHttpKeys, f as specDerivedMethodPaths, g as namedTypeWordsOverlap, h as defaultIsNullableOnlyDifference, i as getExtractor, j as mergePolicy, k as ALL_LANGUAGE_IDS, l as specDerivedEnumValues, m as NAMED_TYPE_RE, n as isPatchableChange, o as diffSnapshots, p as specDerivedNames, r as patchOverlay, s as diffSurfaces, t as buildOverlayLookup, u as specDerivedFieldPaths, v as resolveHints, w as severityMeetsThreshold, x as classifySymbolChanges, y as typeExistsInSurface } from "../overlay-Dj3WWlNP.mjs";
 import path, { basename, dirname, join, relative, resolve } from "node:path";
 import Parser from "tree-sitter";
 import ts from "typescript";
@@ -261,7 +261,8 @@ const nodeExtractor = {
 	language: "node",
 	hints: nodeHints,
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		sdkPath = resolve(sdkPath);
@@ -1092,7 +1093,7 @@ function buildSurface$7(allClasses, hints) {
 * Parser:  `php-parser.ts`  — tree-sitter-based PHP source analysis
 * Surface: `php-surface.ts` — ApiSurface construction
 */
-const PHP_BODY_TYPES = new Set(["array", "mixed"]);
+const PHP_BODY_TYPES = /* @__PURE__ */ new Set(["array", "mixed"]);
 const phpHints = {
 	stripNullable(type) {
 		if (type.startsWith("?")) return type.slice(1);
@@ -1187,7 +1188,8 @@ function createPhpExtractor(hintOverrides) {
 		language: "php",
 		hints: mergedHints,
 		async extractSnapshot(sdkPath) {
-			return apiSurfaceToSnapshot(await this.extract(sdkPath));
+			const surface = await this.extract(sdkPath);
+			return apiSurfaceToSnapshot(surface);
 		},
 		async extract(sdkPath) {
 			let sourceDir;
@@ -1565,9 +1567,9 @@ function parsePythonFile(filePath, sdkPath) {
 /** Default model base classes. Overridden by hints.modelBaseClasses when provided. */
 const DEFAULT_MODEL_BASES = [];
 /** Known dict-like base classes (→ ApiInterface). */
-const DICT_BASES = new Set(["TypedDict"]);
+const DICT_BASES = /* @__PURE__ */ new Set(["TypedDict"]);
 /** Known protocol bases (→ ApiClass as service). */
-const PROTOCOL_BASES = new Set(["Protocol"]);
+const PROTOCOL_BASES = /* @__PURE__ */ new Set(["Protocol"]);
 /** Default exception bases. Overridden by hints.exceptionBaseClasses when provided. */
 const DEFAULT_EXCEPTION_BASES = ["Exception", "BaseException"];
 /** Check if a class has any of the given base classes (by simple name). */
@@ -1862,7 +1864,7 @@ function buildSurface$6(parsedFiles, hints) {
 * Parser:  `python-parser.ts`  — tree-sitter-based Python source analysis
 * Surface: `python-surface.ts` — ApiSurface construction
 */
-const PYTHON_PRIMITIVE_TYPES = new Set([
+const PYTHON_PRIMITIVE_TYPES = /* @__PURE__ */ new Set([
 	"str",
 	"int",
 	"float",
@@ -2030,7 +2032,7 @@ const pythonHints = {
 		if (candClean.startsWith("Literal[") && candidateSurface.enums?.[baseClean]) return true;
 		if (baseClean === "str" && candidateSurface.enums[candClean]) return true;
 		if (candClean === "str" && candidateSurface.enums?.[baseClean]) return true;
-		const numericTypes = new Set(["int", "float"]);
+		const numericTypes = /* @__PURE__ */ new Set(["int", "float"]);
 		if (numericTypes.has(baseClean) && numericTypes.has(candClean)) return true;
 		if (NAMED_TYPE_RE.test(baseClean) && NAMED_TYPE_RE.test(candClean)) {
 			if (typeExistsInSurface(candClean, candidateSurface)) {
@@ -2052,7 +2054,7 @@ const pythonHints = {
 				if (!namedTypeWordsOverlap(baseRet, candRet)) return false;
 			}
 		}
-		const bodyDictTypes = new Set([
+		const bodyDictTypes = /* @__PURE__ */ new Set([
 			"dict[str, Any]",
 			"Dict[str, Any]",
 			"dict"
@@ -2080,7 +2082,8 @@ function createPythonExtractor(hintOverrides) {
 		language: "python",
 		hints: mergedHints,
 		async extractSnapshot(sdkPath) {
-			return apiSurfaceToSnapshot(await this.extract(sdkPath));
+			const surface = await this.extract(sdkPath);
+			return apiSurfaceToSnapshot(surface);
 		},
 		async extract(sdkPath) {
 			const sourceRoot = findPythonSourceRoot(sdkPath);
@@ -2365,7 +2368,6 @@ function extractMethodParams(methodNode) {
 			});
 			break;
 		}
-		default: break;
 	}
 	return params;
 }
@@ -2502,7 +2504,8 @@ const rubyExtractor = {
 	language: "ruby",
 	hints: rubyHints,
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		const libPath = resolve(sdkPath, "lib");
@@ -2844,7 +2847,8 @@ function buildReturnType(returnTypes) {
 }
 /** Get the package directory name from a source file relative path. */
 function getPackageDirName(relPath) {
-	return basename(dirname(relPath)) || "root";
+	const dir = dirname(relPath);
+	return basename(dir) || "root";
 }
 /**
 * When multiple packages define the same exported symbol, qualify with the
@@ -3094,7 +3098,8 @@ const goExtractor = {
 		}
 	},
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		const goFiles = walkGoFiles(sdkPath);
@@ -3586,7 +3591,8 @@ const rustExtractor = {
 		}
 	},
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		const rsFiles = walkRustFiles(sdkPath);
@@ -4024,7 +4030,8 @@ const kotlinExtractor = {
 		}
 	},
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		const ktFiles = walkKotlinFiles(sdkPath);
@@ -4360,7 +4367,7 @@ function buildSurface$2(allClasses, allEnums, _hints) {
 * Parser:  `dotnet-parser.ts`  — regex-based C# source analysis
 * Surface: `dotnet-surface.ts` — ApiSurface construction
 */
-const DOTNET_PRIMITIVE_TYPES = new Set([
+const DOTNET_PRIMITIVE_TYPES = /* @__PURE__ */ new Set([
 	"string",
 	"int",
 	"long",
@@ -4494,7 +4501,7 @@ const dotnetHints = {
 				if (namedTypeWordsOverlap(baseClean, candClean)) return true;
 			}
 		}
-		const numericTypes = new Set([
+		const numericTypes = /* @__PURE__ */ new Set([
 			"int",
 			"long",
 			"float",
@@ -4520,7 +4527,8 @@ function createDotnetExtractor(hintOverrides) {
 		language: "dotnet",
 		hints: mergedHints,
 		async extractSnapshot(sdkPath) {
-			return apiSurfaceToSnapshot(await this.extract(sdkPath));
+			const surface = await this.extract(sdkPath);
+			return apiSurfaceToSnapshot(surface);
 		},
 		async extract(sdkPath) {
 			let sourceDir;
@@ -5016,7 +5024,8 @@ const elixirExtractor = {
 		}
 	},
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		let sourceDir;
@@ -5069,7 +5078,7 @@ const elixirExtractor = {
 *    member raw values in `init(rawValue:)` / `var rawValue` switches rather
 *    than `case name = "value"` declarations.
 */
-const SKIP_DIRS = new Set([
+const SKIP_DIRS = /* @__PURE__ */ new Set([
 	"build",
 	"Tests",
 	"DerivedData",
@@ -5643,7 +5652,8 @@ const iosExtractor = {
 		}
 	},
 	async extractSnapshot(sdkPath) {
-		return apiSurfaceToSnapshot(await this.extract(sdkPath));
+		const surface = await this.extract(sdkPath);
+		return apiSurfaceToSnapshot(surface);
 	},
 	async extract(sdkPath) {
 		const swiftFiles = walkSwiftFiles(sdkPath);