@peterhauge/apiops-cli 0.1.3-alpha.0

package/dist/services/api-extractor.js

@@ -0,0 +1,319 @@
+/**
+ * T022: API-specific extraction logic
+ * API revisions, API specifications, operations & operation policies,
+ * GraphQL resolvers & resolver policies, API tags, diagnostics, schemas,
+ * releases, tag descriptions, wikis.
+ */
+import { ResourceType } from '../models/resource-types.js';
+import { shouldIncludeResource } from './filter-service.js';
+import { extractResourceType } from './resource-extractor.js';
+import { logger } from '../lib/logger.js';
+import { buildResourceLabel } from '../lib/resource-uri.js';
+import { getNamePart } from '../lib/resource-path.js';
+/**
+ * Extract all API-specific resources for a single API.
+ * This includes revisions, specifications, operations, policies, etc.
+ */
+export async function extractApiResources(client, store, context, apiDescriptor, apiJson, outputDir, filter, workspace) {
+    const apiName = getNamePart(apiDescriptor.nameParts, 0);
+    const result = {
+        apiName,
+        revisions: [],
+        specification: false,
+        operations: [],
+        operationPolicies: [],
+        tags: [],
+        diagnostics: [],
+        schemas: [],
+        releases: [],
+        tagDescriptions: [],
+        wiki: false,
+        resolvers: [],
+        resolverPolicies: [],
+        policies: [],
+    };
+    // Extract API revisions
+    result.revisions = await extractApiRevisions(client, store, context, apiName, outputDir, filter, workspace);
+    // Extract API schemas FIRST. For synthetic GraphQL APIs the SDL lives in an
+    // ApiSchema resource; by extracting schemas first we can detect that case
+    // from the results and skip the (failing) spec export — avoiding a redundant
+    // `list schemas` probe per GraphQL-typed API at scale.
+    const schemaResult = await extractResourceType(client, store, context, ResourceType.ApiSchema, outputDir, filter, apiDescriptor, workspace);
+    result.schemas = schemaResult.extracted;
+    // Extract API specification (uses already-extracted schemas to detect
+    // synthetic GraphQL without a second list call).
+    result.specification = await extractApiSpecification(client, store, context, apiDescriptor, apiJson, outputDir, result.schemas);
+    // Extract API policy
+    const policyContent = await extractApiPolicy(client, store, context, apiDescriptor, outputDir);
+    if (policyContent) {
+        result.policies.push(policyContent);
+    }
+    // Extract operations and their policies
+    const opsResult = await extractApiOperations(client, store, context, apiDescriptor, outputDir, filter, workspace);
+    result.operations = opsResult.operations;
+    result.operationPolicies = opsResult.operationPolicies;
+    result.policies.push(...opsResult.policies);
+    // Extract API tags
+    const tagsResult = await extractResourceType(client, store, context, ResourceType.ApiTag, outputDir, filter, apiDescriptor, workspace);
+    result.tags = tagsResult.extracted;
+    // Extract API diagnostics
+    const diagResult = await extractResourceType(client, store, context, ResourceType.ApiDiagnostic, outputDir, filter, apiDescriptor, workspace);
+    result.diagnostics = diagResult.extracted;
+    // Extract API releases
+    const releaseResult = await extractResourceType(client, store, context, ResourceType.ApiRelease, outputDir, filter, apiDescriptor, workspace);
+    result.releases = releaseResult.extracted;
+    // Extract API tag descriptions
+    const tagDescResult = await extractResourceType(client, store, context, ResourceType.ApiTagDescription, outputDir, filter, apiDescriptor, workspace);
+    result.tagDescriptions = tagDescResult.extracted;
+    // Extract API wiki
+    result.wiki = await extractApiWiki(client, store, context, apiDescriptor, outputDir);
+    // Extract GraphQL resolvers and their policies
+    const resolverResult = await extractGraphQLResolvers(client, store, context, apiDescriptor, apiJson, outputDir, filter, workspace);
+    result.resolvers = resolverResult.resolvers;
+    result.resolverPolicies = resolverResult.resolverPolicies;
+    result.policies.push(...resolverResult.policies);
+    return result;
+}
+/**
+ * Extract API revisions.
+ * Lists revisions and extracts each as a sub-folder with ;rev=N naming.
+ */
+async function extractApiRevisions(client, store, context, apiName, outputDir, filter, workspace) {
+    const results = [];
+    try {
+        const revisions = client.listApiRevisions(context, apiName);
+        for await (const revision of revisions) {
+            try {
+                const revNumber = (revision.apiRevision ?? revision.revisionNumber);
+                if (!revNumber || revNumber === '1') {
+                    // Skip revision 1 — it's the main API
+                    continue;
+                }
+                const revName = `${apiName};rev=${revNumber}`;
+                const descriptor = {
+                    type: ResourceType.Api,
+                    nameParts: [revName],
+                    workspace,
+                };
+                // Check filter — use root API name for matching
+                if (!shouldIncludeResource(descriptor, filter)) {
+                    continue;
+                }
+                // Get full revision resource
+                const revJson = await client.getResource(context, descriptor);
+                if (revJson) {
+                    await store.writeResource(outputDir, descriptor, revJson);
+                    results.push({ descriptor, json: revJson, status: 'success' });
+                    logger.info(`Extracted revision ${buildResourceLabel(descriptor)}`);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.warn(`Failed to extract revision: ${errorMessage}`);
+                results.push({
+                    descriptor: { type: ResourceType.Api, nameParts: [`${apiName};rev=?`] },
+                    json: {},
+                    status: 'error',
+                    error: errorMessage,
+                });
+            }
+        }
+    }
+    catch (error) {
+        logger.warn(`Failed to list revisions for API "${apiName}": ${error.message}`);
+    }
+    return results;
+}
+/**
+ * Extract API specification (OpenAPI/GraphQL/WSDL/WADL).
+ * WebSocket APIs do not have an OpenAPI specification — skip with a debug log.
+ * Synthetic GraphQL APIs (schema stored as an ApiSchema, no external SDL blob)
+ * are detected by inspecting already-extracted schemas and skipped here —
+ * their schema is captured by the ApiSchema extraction step. Pass-through
+ * GraphQL APIs (linked to an external GraphQL server) export their SDL via
+ * the graphql-link format.
+ */
+async function extractApiSpecification(client, store, context, apiDescriptor, apiJson, outputDir, extractedSchemas) {
+    const properties = apiJson.properties;
+    const apiType = properties?.type;
+    if (apiType?.toLowerCase() === 'websocket') {
+        logger.debug(`OpenAPI does not apply to WebSocket APIs`);
+        return false;
+    }
+    if (apiType?.toLowerCase() === 'graphql' && hasGraphQLSchema(extractedSchemas)) {
+        logger.debug(`Skipping spec export for synthetic GraphQL API "${getNamePart(apiDescriptor.nameParts, 0)}" — schema is captured via ApiSchema`);
+        return false;
+    }
+    try {
+        const spec = await client.getApiSpecification(context, getNamePart(apiDescriptor.nameParts, 0), apiType);
+        if (!spec) {
+            logger.debug(`No specification found for API "${getNamePart(apiDescriptor.nameParts, 0)}"`);
+            return false;
+        }
+        await store.writeContent(outputDir, apiDescriptor, spec.content, 'specification', spec.format);
+        logger.info(`Extracted specification ${buildResourceLabel(apiDescriptor)} (${spec.format})`);
+        return true;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.warn(`Failed to extract specification ${buildResourceLabel(apiDescriptor)}: ${errorMessage}`);
+        return false;
+    }
+}
+/**
+ * Returns true if any already-extracted ApiSchema resource has a contentType
+ * indicating a GraphQL schema. Used to distinguish synthetic GraphQL APIs
+ * (schema stored in APIM) from pass-through GraphQL APIs (schema fetched from
+ * backend). Inspects schemas that were extracted prior to spec export, so no
+ * extra list call is required.
+ */
+function hasGraphQLSchema(schemas) {
+    for (const schema of schemas) {
+        const props = schema.json.properties;
+        const contentType = props?.contentType?.toLowerCase() ?? '';
+        if (contentType.includes('graphql')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extract API-level policy.
+ */
+async function extractApiPolicy(client, store, context, apiDescriptor, outputDir) {
+    const policyDescriptor = {
+        type: ResourceType.ApiPolicy,
+        nameParts: [...apiDescriptor.nameParts],
+        workspace: apiDescriptor.workspace,
+    };
+    const policyJson = await client.getResource(context, policyDescriptor);
+    if (!policyJson) {
+        return undefined;
+    }
+    const properties = policyJson.properties;
+    const policyContent = properties?.value;
+    if (policyContent) {
+        await store.writeContent(outputDir, policyDescriptor, policyContent, 'policy');
+        logger.debug(`Extracted ${buildResourceLabel(policyDescriptor)}`);
+        return policyContent;
+    }
+    return undefined;
+}
+/**
+ * Extract API operations and their policies.
+ */
+async function extractApiOperations(client, store, context, apiDescriptor, outputDir, filter, workspace) {
+    const operations = [];
+    const operationPolicies = [];
+    const policies = [];
+    // Extract operations
+    const opsResult = await extractResourceType(client, store, context, ResourceType.ApiOperation, outputDir, filter, apiDescriptor, workspace);
+    operations.push(...opsResult.extracted);
+    // Extract operation policies for each operation
+    for (const op of opsResult.extracted) {
+        if (op.status !== 'success')
+            continue;
+        const opPolicyDescriptor = {
+            type: ResourceType.ApiOperationPolicy,
+            nameParts: [...op.descriptor.nameParts],
+            workspace,
+        };
+        const policyJson = await client.getResource(context, opPolicyDescriptor);
+        if (!policyJson)
+            continue;
+        const properties = policyJson.properties;
+        const policyContent = properties?.value;
+        if (policyContent) {
+            await store.writeContent(outputDir, opPolicyDescriptor, policyContent, 'policy');
+            operationPolicies.push({
+                descriptor: opPolicyDescriptor,
+                json: policyJson,
+                status: 'success',
+            });
+            policies.push(policyContent);
+            logger.debug(`Extracted ${buildResourceLabel(opPolicyDescriptor)}`);
+        }
+    }
+    return { operations, operationPolicies, policies };
+}
+/**
+ * Extract API wiki content.
+ */
+async function extractApiWiki(client, store, context, apiDescriptor, outputDir) {
+    const wikiDescriptor = {
+        type: ResourceType.ApiWiki,
+        nameParts: [...apiDescriptor.nameParts],
+        workspace: apiDescriptor.workspace,
+    };
+    try {
+        const wikiJson = await client.getResource(context, wikiDescriptor);
+        if (!wikiJson) {
+            return false;
+        }
+        // Extract markdown content from wiki JSON
+        const properties = wikiJson.properties;
+        const documents = properties?.documents;
+        if (documents) {
+            // Write wiki info as markdown — use writeResource (not writeContent with 'policy')
+            // since there is no dedicated 'wiki' content type in IArtifactStore
+            const content = documents.map((d) => `# ${d.title}\n\n${d.documentationId}`).join('\n\n');
+            const markdownJson = { ...wikiJson, _markdownContent: content };
+            await store.writeResource(outputDir, wikiDescriptor, markdownJson);
+        }
+        else {
+            // Write the raw JSON
+            await store.writeResource(outputDir, wikiDescriptor, wikiJson);
+        }
+        logger.info(`Extracted ${buildResourceLabel(wikiDescriptor)}`);
+        return true;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.debug(`No wiki ${buildResourceLabel(wikiDescriptor)}: ${errorMessage}`);
+        return false;
+    }
+}
+/**
+ * Extract GraphQL resolvers and their policies.
+ */
+async function extractGraphQLResolvers(client, store, context, apiDescriptor, apiJson, outputDir, filter, workspace) {
+    const resolvers = [];
+    const resolverPolicies = [];
+    const policies = [];
+    // Only extract resolvers for GraphQL APIs — use the already-fetched apiJson
+    const properties = apiJson.properties;
+    const apiType = properties?.type;
+    if (apiType?.toLowerCase() !== 'graphql') {
+        return { resolvers, resolverPolicies, policies };
+    }
+    // Extract resolvers
+    const resolverResult = await extractResourceType(client, store, context, ResourceType.GraphQLResolver, outputDir, filter, apiDescriptor, workspace);
+    resolvers.push(...resolverResult.extracted);
+    // Extract resolver policies
+    for (const resolver of resolverResult.extracted) {
+        if (resolver.status !== 'success')
+            continue;
+        const resolverPolicyDescriptor = {
+            type: ResourceType.GraphQLResolverPolicy,
+            nameParts: [...resolver.descriptor.nameParts],
+            workspace,
+        };
+        const policyJson = await client.getResource(context, resolverPolicyDescriptor);
+        if (!policyJson)
+            continue;
+        const props = policyJson.properties;
+        const policyContent = props?.value;
+        if (policyContent) {
+            await store.writeContent(outputDir, resolverPolicyDescriptor, policyContent, 'policy');
+            resolverPolicies.push({
+                descriptor: resolverPolicyDescriptor,
+                json: policyJson,
+                status: 'success',
+            });
+            policies.push(policyContent);
+            logger.debug(`Extracted ${buildResourceLabel(resolverPolicyDescriptor)}`);
+        }
+    }
+    return { resolvers, resolverPolicies, policies };
+}
+//# sourceMappingURL=api-extractor.js.map

package/dist/services/api-extractor.js.map

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

package/dist/services/api-publisher.d.ts

@@ -0,0 +1,18 @@
+/**
+ * T032: API publisher with revision handling
+ * Create root API first, then revisions in numeric order with forced revision numbers.
+ * Publish operations, policies, schemas, releases, resolvers, tag descriptions, wikis per FR-024.
+ * Handle SOAP/WSDL import via ?import=true&format=wsdl-link query parameter.
+ */
+import type { IApimClient } from '../clients/iapim-client.js';
+import type { IArtifactStore } from '../clients/iartifact-store.js';
+import type { ApimServiceContext, ResourceDescriptor } from '../models/types.js';
+import type { PublishConfig } from '../models/config.js';
+import { type ResourcePublishResult } from './resource-publisher.js';
+/**
+ * Publish an API with all its revisions and child resources.
+ * Creates root API first, then revisions in numeric order.
+ * Handles SOAP/WSDL import via ?import=true&format=wsdl-link.
+ */
+export declare function publishApi(client: IApimClient, store: IArtifactStore, context: ApimServiceContext, descriptor: ResourceDescriptor, config: PublishConfig): Promise<ResourcePublishResult>;
+//# sourceMappingURL=api-publisher.d.ts.map

package/dist/services/api-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-publisher.d.ts","sourceRoot":"","sources":["../../src/services/api-publisher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAwBtF;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,qBAAqB,CAAC,CA4BhC"}

package/dist/services/api-publisher.js

@@ -0,0 +1,290 @@
+/**
+ * T032: API publisher with revision handling
+ * Create root API first, then revisions in numeric order with forced revision numbers.
+ * Publish operations, policies, schemas, releases, resolvers, tag descriptions, wikis per FR-024.
+ * Handle SOAP/WSDL import via ?import=true&format=wsdl-link query parameter.
+ */
+import { ResourceType } from '../models/resource-types.js';
+import { publishResource } from './resource-publisher.js';
+import { runParallel } from '../lib/parallel-runner.js';
+import { applyOverrides } from './override-merger.js';
+import { logger } from '../lib/logger.js';
+import { getNamePart, getPublishTier } from '../lib/resource-path.js';
+import { isAutoGeneratedId } from '../lib/auto-generated.js';
+/**
+ * API child resource types that should be published after the API itself
+ */
+const API_CHILD_TYPES = [
+    ResourceType.ApiPolicy,
+    ResourceType.ApiTag,
+    ResourceType.ApiDiagnostic,
+    ResourceType.ApiOperation,
+    ResourceType.ApiOperationPolicy,
+    ResourceType.ApiSchema,
+    ResourceType.ApiRelease,
+    ResourceType.ApiTagDescription,
+    ResourceType.ApiWiki,
+    ResourceType.GraphQLResolver,
+    ResourceType.GraphQLResolverPolicy,
+];
+/**
+ * Publish an API with all its revisions and child resources.
+ * Creates root API first, then revisions in numeric order.
+ * Handles SOAP/WSDL import via ?import=true&format=wsdl-link.
+ */
+export async function publishApi(client, store, context, descriptor, config) {
+    try {
+        // Step 1: Publish root API (with spec import if available)
+        const rootResult = await publishRootApi(client, store, context, descriptor, config);
+        if (rootResult.status !== 'success') {
+            return rootResult;
+        }
+        // Step 2: Find and publish revisions in numeric order
+        await publishApiRevisions(client, store, context, descriptor, config);
+        // Step 3: Publish child resources in parallel
+        // When a spec was imported, operations and schemas are auto-created by APIM
+        await publishApiChildren(client, store, context, descriptor, config, rootResult.specImported);
+        return {
+            descriptor,
+            status: 'success',
+            action: 'put',
+        };
+    }
+    catch (error) {
+        return {
+            descriptor,
+            status: 'failed',
+            action: 'noop',
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+/**
+ * Maps spec file format to APIM ContentFormat for inline import.
+ */
+function getImportFormat(specFormat, _apiType) {
+    switch (specFormat) {
+        case 'yaml':
+            return 'openapi';
+        case 'json':
+            // Swagger 2.0 uses swagger-json, OpenAPI 3.x uses openapi+json.
+            // Default to openapi+json as the more modern format — APIM accepts both.
+            return 'openapi+json';
+        case 'wsdl':
+            return 'wsdl';
+        case 'wadl':
+            return 'wadl-xml';
+        case 'graphql':
+            // GraphQL schemas are managed via the ApiSchema resource, not via
+            // the import properties. Return undefined so we skip injection.
+            return undefined;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Publish the root API (apiInformation.json).
+ * When a specification file exists alongside the API metadata, injects
+ * `properties.format` and `properties.value` into the PUT body so APIM
+ * imports the spec and auto-creates operations + schemas.
+ */
+async function publishRootApi(client, store, context, descriptor, config) {
+    let json = await store.readResource(config.sourceDir, descriptor);
+    if (!json) {
+        return {
+            descriptor,
+            status: 'skipped',
+            action: 'noop',
+            specImported: false,
+        };
+    }
+    // Apply overrides
+    json = applyOverrides(descriptor, json, config.overrides);
+    // Try to read the specification file for this API
+    let specImported = false;
+    const specResult = await store.readContent(config.sourceDir, descriptor, 'specification');
+    if (specResult) {
+        const properties = json.properties;
+        const apiType = properties?.type;
+        const importFormat = getImportFormat(specResult.format ?? 'yaml', apiType);
+        if (importFormat) {
+            // Strip null-valued properties that cause validation errors in
+            // APIM's spec-import mode (e.g. "backendId": null → HTTP 400).
+            const cleanProps = {};
+            for (const [key, val] of Object.entries(properties ?? {})) {
+                if (val !== null) {
+                    cleanProps[key] = val;
+                }
+            }
+            // The `type` property from GET is read-only and ignored on PUT.
+            // APIM uses `apiType` to determine the API kind during spec import.
+            // Always set it explicitly (valid values: http, soap, websocket, graphql, odata, grpc, mcp).
+            if (apiType) {
+                cleanProps.apiType = apiType;
+            }
+            // Inject the spec into the PUT body for APIM to import
+            json = {
+                ...json,
+                properties: {
+                    ...cleanProps,
+                    format: importFormat,
+                    value: specResult.content,
+                },
+            };
+            specImported = true;
+            logger.info(`Including ${specResult.format} specification in API import for "${getNamePart(descriptor.nameParts, 0)}"`);
+        }
+    }
+    // PUT the API resource to APIM
+    await client.putResource(context, descriptor, json);
+    return {
+        descriptor,
+        status: 'success',
+        action: 'put',
+        specImported,
+    };
+}
+/**
+ * Find and publish API revisions in numeric order
+ */
+async function publishApiRevisions(client, store, context, apiDescriptor, config) {
+    // List all resources from store
+    const allDescriptors = await store.listResources(config.sourceDir);
+    // Find revision descriptors for this API
+    const revisionDescriptors = allDescriptors.filter((d) => d.type === ResourceType.Api &&
+        getNamePart(d.nameParts, 0).startsWith(`${getNamePart(apiDescriptor.nameParts, 0)};rev=`));
+    // Sort revisions by revision number
+    const sortedRevisions = revisionDescriptors.sort((a, b) => {
+        const revA = extractRevisionNumber(getNamePart(a.nameParts, 0));
+        const revB = extractRevisionNumber(getNamePart(b.nameParts, 0));
+        return revA - revB;
+    });
+    // Publish each revision in order
+    for (const revDescriptor of sortedRevisions) {
+        await publishResource(client, store, context, revDescriptor, config);
+    }
+}
+/**
+ * Resource types that are auto-created by APIM when importing a spec.
+ * Both ApiOperation and ApiSchema are initially excluded, but we selectively
+ * re-add: operations with schema references, and explicitly named schemas
+ * (non-auto-generated 24-char hex IDs).
+ */
+const SPEC_MANAGED_CHILD_TYPES = new Set([
+    ResourceType.ApiOperation,
+    ResourceType.ApiSchema,
+]);
+/**
+ * Publish all child resources of an API in parallel.
+ * When specImported is true, skips ApiSchema and ApiOperation since APIM
+ * auto-creates those from the imported specification. However:
+ * - Operations with schema references are re-PUT explicitly so APIM preserves those links
+ * - Explicitly named schemas (non-24-char-hex IDs) are also re-published
+ */
+async function publishApiChildren(client, store, context, apiDescriptor, config, specImported = false) {
+    // List all resources from store
+    const allDescriptors = await store.listResources(config.sourceDir);
+    // Find child descriptors for this API
+    let childDescriptors = allDescriptors.filter((d) => API_CHILD_TYPES.includes(d.type) &&
+        getNamePart(d.nameParts, 0) === getNamePart(apiDescriptor.nameParts, 0) &&
+        !(specImported && SPEC_MANAGED_CHILD_TYPES.has(d.type)));
+    // When a spec was imported, APIM auto-creates operations and schemas but loses
+    // schemaId/typeName references in representations. Re-include operations that
+    // carry such references so those links are explicitly restored via PUT.
+    if (specImported) {
+        const operationDescriptors = allDescriptors.filter((d) => d.type === ResourceType.ApiOperation &&
+            getNamePart(d.nameParts, 0) === getNamePart(apiDescriptor.nameParts, 0));
+        const schemaRefOps = await filterOperationsWithSchemaRefs(store, config.sourceDir, operationDescriptors);
+        if (schemaRefOps.length > 0) {
+            logger.debug(`Re-publishing ${schemaRefOps.length} operation(s) with schema references after spec import for "${getNamePart(apiDescriptor.nameParts, 0)}"`);
+            childDescriptors = [...childDescriptors, ...schemaRefOps];
+        }
+        // Re-include explicitly named schemas (non-auto-generated IDs).
+        // Auto-generated schemas have 24-char hex names and are recreated by spec import.
+        // Explicitly named schemas (like "src-rest-schema-item") must be published.
+        const explicitSchemas = allDescriptors.filter((d) => d.type === ResourceType.ApiSchema &&
+            getNamePart(d.nameParts, 0) === getNamePart(apiDescriptor.nameParts, 0) &&
+            !isAutoGeneratedId(getNamePart(d.nameParts, 1)));
+        if (explicitSchemas.length > 0) {
+            logger.debug(`Re-publishing ${explicitSchemas.length} explicit schema(s) after spec import for "${getNamePart(apiDescriptor.nameParts, 0)}"`);
+            childDescriptors = [...childDescriptors, ...explicitSchemas];
+        }
+    }
+    // Group resources by publish tier for dependency ordering.
+    // Lower tiers are published first (parents before children, operations before policies).
+    // Resources in the same tier can be published in parallel.
+    const tierMap = new Map();
+    for (const d of childDescriptors) {
+        const tier = getPublishTier(d.type);
+        const existing = tierMap.get(tier) ?? [];
+        existing.push(d);
+        tierMap.set(tier, existing);
+    }
+    // Publish each tier in order (lowest to highest)
+    const sortedTiers = [...tierMap.keys()].sort((a, b) => a - b);
+    for (const tier of sortedTiers) {
+        const descriptors = tierMap.get(tier) ?? [];
+        if (descriptors.length > 0) {
+            const tasks = descriptors.map((descriptor) => () => publishResource(client, store, context, descriptor, config));
+            await runParallel(tasks, 5);
+        }
+    }
+}
+/**
+ * Returns the subset of operation descriptors whose stored artifact contains
+ * at least one representation with a schemaId or typeName property.
+ * These operations must be re-PUT after a spec import so APIM retains the
+ * schema linkage that the import path discards.
+ */
+async function filterOperationsWithSchemaRefs(store, sourceDir, operationDescriptors) {
+    const result = [];
+    for (const descriptor of operationDescriptors) {
+        const json = await store.readResource(sourceDir, descriptor);
+        if (json && operationHasSchemaRefs(json)) {
+            result.push(descriptor);
+        }
+    }
+    return result;
+}
+/**
+ * Returns true if the operation JSON contains at least one representation
+ * (in request or any response) that has a schemaId or typeName property.
+ */
+function operationHasSchemaRefs(json) {
+    const props = json.properties;
+    if (!props)
+        return false;
+    const representationGroups = [];
+    const request = props.request;
+    if (request?.representations) {
+        representationGroups.push(request.representations);
+    }
+    const responses = props.responses;
+    if (Array.isArray(responses)) {
+        for (const response of responses) {
+            const r = response;
+            if (r.representations) {
+                representationGroups.push(r.representations);
+            }
+        }
+    }
+    for (const group of representationGroups) {
+        if (!Array.isArray(group))
+            continue;
+        for (const rep of group) {
+            const r = rep;
+            if (r.schemaId != null || r.typeName != null) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Extract revision number from API name (e.g., "my-api;rev=2" -> 2)
+ */
+function extractRevisionNumber(apiName) {
+    const match = /;rev=(\d+)/.exec(apiName);
+    return match ? parseInt(match[1], 10) : 0;
+}
+//# sourceMappingURL=api-publisher.js.map