@hey-api/shared 0.1.2 → 0.2.0

package/dist/index.mjs

@@ -1782,7 +1782,7 @@ function pathToJsonPointer(path$1) {
 	return "#" + (segments ? `/${segments}` : "");
 }
 /**
-* Checks if a $ref points to a top-level component (not a deep path reference).
+* Checks if a $ref or path points to a top-level component (not a deep path reference).
 *
 * Top-level component references:
 * - OpenAPI 3.x: #/components/{type}/{name} (3 segments)
@@ -1791,11 +1791,11 @@ function pathToJsonPointer(path$1) {
 * Deep path references (4+ segments for 3.x, 3+ for 2.0) should be inlined
 * because they don't have corresponding registered symbols.
 *
-* @param $ref - The $ref string to check
+* @param refOrPath - The $ref string or path array to check
 * @returns true if the ref points to a top-level component, false otherwise
 */
-function isTopLevelComponentRef($ref) {
-	const path$1 = jsonPointerToPath($ref);
+function isTopLevelComponent(refOrPath) {
+	const path$1 = refOrPath instanceof Array ? refOrPath : jsonPointerToPath(refOrPath);
 	if (path$1[0] === "components") return path$1.length === 3;
 	if (path$1[0] === "definitions") return path$1.length === 2;
 	return false;
@@ -4364,7 +4364,7 @@ const parseEnum$2 = ({ context, schema, state }) => {
 };
 const parseRef$2 = ({ context, schema, state }) => {
 	const irSchema = {};
-	if (!isTopLevelComponentRef(schema.$ref)) {
+	if (!isTopLevelComponent(schema.$ref)) {
 		if (!state.circularReferenceTracker.has(schema.$ref)) {
 			const refSchema = context.resolveRef(schema.$ref);
 			const originalRef = state.$ref;
@@ -5690,7 +5690,7 @@ const parseOneOf$1 = ({ context, schema, state }) => {
 	return irSchema;
 };
 const parseRef$1 = ({ context, schema, state }) => {
-	if (!isTopLevelComponentRef(schema.$ref)) {
+	if (!isTopLevelComponent(schema.$ref)) {
 		if (!state.circularReferenceTracker.has(schema.$ref)) {
 			const refSchema = context.resolveRef(schema.$ref);
 			const originalRef = state.$ref;
@@ -7038,7 +7038,7 @@ const parseOneOf = ({ context, schema, state }) => {
 	return irSchema;
 };
 const parseRef = ({ context, schema, state }) => {
-	if (!isTopLevelComponentRef(schema.$ref)) {
+	if (!isTopLevelComponent(schema.$ref)) {
 		if (!state.circularReferenceTracker.has(schema.$ref)) {
 			const refSchema = context.resolveRef(schema.$ref);
 			const originalRef = state.$ref;
@@ -8144,6 +8144,43 @@ function patchOpenApiSpec({ patchOptions, spec: _spec }) {
 	}
 }
 
+//#endregion
+//#region src/plugins/schema-processor.ts
+function createSchemaProcessor() {
+	const emitted = /* @__PURE__ */ new Set();
+	let contextTags;
+	let contextAnchor;
+	return {
+		get context() {
+			return {
+				anchor: contextAnchor,
+				tags: contextTags
+			};
+		},
+		hasEmitted(path$1) {
+			return emitted.has(pathToJsonPointer(path$1));
+		},
+		markEmitted(path$1) {
+			const pointer = pathToJsonPointer(path$1);
+			if (emitted.has(pointer)) return false;
+			emitted.add(pointer);
+			return true;
+		},
+		withContext(ctx, fn) {
+			const prevTags = contextTags;
+			const prevAnchor = contextAnchor;
+			contextTags = ctx.tags;
+			contextAnchor = ctx.anchor;
+			try {
+				return fn();
+			} finally {
+				contextTags = prevTags;
+				contextAnchor = prevAnchor;
+			}
+		}
+	};
+}
+
 //#endregion
 //#region src/plugins/shared/utils/config.ts
 const definePluginConfig = (defaultConfig) => (userConfig) => ({
@@ -8181,5 +8218,109 @@ const utils = {
 };
 
 //#endregion
-export { ConfigError, ConfigValidationError, Context, HeyApiError, IntentContext, JobError, MinHeap, OperationPath, OperationStrategy, PluginInstance, applyNaming, buildGraph, checkNodeVersion, compileInputPath, createOperationKey, debugTools, deduplicateSchema, defaultPaginationKeywords, definePluginConfig, dependencyFactory, encodeJsonPointerSegment, ensureDirSync, escapeComment, findPackageJson, findTsConfigPath, getInput, getLogs, getParser, getSpec, hasOperationDataRequired, hasParameterGroupObjectRequired, hasParametersObjectRequired, heyApiRegistryBaseUrl, inputToApiRegistry, isTopLevelComponentRef, jsonPointerToPath, loadPackageJson, loadTsConfig, logCrashReport, logInputPaths, mappers, normalizeJsonPointer, openGitHubIssueWithCrashReport, operationPagination, operationResponsesMap, parameterWithPagination, parseOpenApiSpec, parseUrl, parseV2_0_X, parseV3_0_X, parseV3_1_X, patchOpenApiSpec, pathToJsonPointer, postprocessOutput, printCliIntro, printCrashReport, refToName, resolveNaming, resolveRef, resolveSource, satisfies, shouldReportCrash, statusCodeToGroup, toCase, utils, valueToObject };
+//#region src/utils/path.ts
+/**
+* After these structural segments, the next segment has a known role.
+* This is what makes a property literally named "properties" safe —
+* it occupies the name position, never the structural position.
+*/
+const STRUCTURAL_ROLE = {
+	items: "index",
+	patternProperties: "name",
+	properties: "name"
+};
+/**
+* These structural segments have no following name/index —
+* they are the terminal structural node. Append a suffix
+* to disambiguate from the parent.
+*/
+const STRUCTURAL_SUFFIX = { additionalProperties: "Value" };
+/**
+* Root context configuration.
+*/
+const ROOT_CONTEXT = {
+	components: {
+		names: 1,
+		skip: 2
+	},
+	definitions: {
+		names: 1,
+		skip: 1
+	},
+	paths: {
+		names: 2,
+		skip: 1
+	},
+	webhooks: {
+		names: 2,
+		skip: 1
+	}
+};
+/**
+* Sanitizes a path segment for use in a derived name.
+*
+* Handles API path segments like `/api/v1/users/{id}` → `ApiV1UsersId`.
+*/
+function sanitizeSegment(segment) {
+	const str = String(segment);
+	if (str.startsWith("/")) return str.split("/").filter(Boolean).map((part) => {
+		const clean = part.replace(/[{}]/g, "");
+		return clean.charAt(0).toUpperCase() + clean.slice(1);
+	}).join("");
+	return str;
+}
+/**
+* Derives a composite name from a path.
+*
+* Examples:
+*   .../User                                    → 'User'
+*   .../User/properties/address                 → 'UserAddress'
+*   .../User/properties/properties              → 'UserProperties'
+*   .../User/properties/address/properties/city → 'UserAddressCity'
+*   .../Pet/additionalProperties                → 'PetValue'
+*   .../Order/properties/items/items/0          → 'OrderItems'
+*   paths//event/get/properties/query           → 'EventGetQuery'
+*
+* With anchor:
+*   paths//event/get/properties/query, { anchor: 'event.subscribe' }
+*                                               → 'event.subscribe-Query'
+*/
+function pathToName(path$1, options) {
+	const names = [];
+	let index = 0;
+	const rootContext = ROOT_CONTEXT[path$1[0]];
+	if (rootContext) {
+		index = rootContext.skip;
+		if (options?.anchor) {
+			names.push(options.anchor);
+			index += rootContext.names;
+		} else for (let n = 0; n < rootContext.names && index < path$1.length; n++) {
+			names.push(sanitizeSegment(path$1[index]));
+			index++;
+		}
+	} else if (options?.anchor) {
+		names.push(options.anchor);
+		index++;
+	} else if (index < path$1.length) {
+		names.push(sanitizeSegment(path$1[index]));
+		index++;
+	}
+	while (index < path$1.length) {
+		const segment = String(path$1[index]);
+		const role = STRUCTURAL_ROLE[segment];
+		if (role === "name") {
+			index++;
+			if (index < path$1.length) names.push(sanitizeSegment(path$1[index]));
+		} else if (role === "index") {
+			index++;
+			if (index < path$1.length && typeof path$1[index] === "number") index++;
+			continue;
+		} else if (STRUCTURAL_SUFFIX[segment]) names.push(STRUCTURAL_SUFFIX[segment]);
+		index++;
+	}
+	return decodeURI(names.join("-"));
+}
+
+//#endregion
+export { ConfigError, ConfigValidationError, Context, HeyApiError, IntentContext, JobError, MinHeap, OperationPath, OperationStrategy, PluginInstance, addItemsToSchema, applyNaming, buildGraph, checkNodeVersion, compileInputPath, createOperationKey, createSchemaProcessor, debugTools, deduplicateSchema, defaultPaginationKeywords, definePluginConfig, dependencyFactory, encodeJsonPointerSegment, ensureDirSync, escapeComment, findPackageJson, findTsConfigPath, getInput, getLogs, getParser, getSpec, hasOperationDataRequired, hasParameterGroupObjectRequired, hasParametersObjectRequired, heyApiRegistryBaseUrl, inputToApiRegistry, isTopLevelComponent, jsonPointerToPath, loadPackageJson, loadTsConfig, logCrashReport, logInputPaths, mappers, normalizeJsonPointer, openGitHubIssueWithCrashReport, operationPagination, operationResponsesMap, parameterWithPagination, parseOpenApiSpec, parseUrl, parseV2_0_X, parseV3_0_X, parseV3_1_X, patchOpenApiSpec, pathToJsonPointer, pathToName, postprocessOutput, printCliIntro, printCrashReport, refToName, resolveNaming, resolveRef, resolveSource, satisfies, shouldReportCrash, statusCodeToGroup, toCase, utils, valueToObject };
 //# sourceMappingURL=index.mjs.map