@peterhauge/apiops-cli 0.1.3-alpha.0

package/dist/lib/resource-path.js

@@ -0,0 +1,401 @@
+/**
+ * T013: Resource descriptor ↔ artifact file path mapping
+ * Map descriptor to directory/file paths per data-model.md artifact conventions
+ */
+import * as path from 'node:path';
+import { RESOURCE_TYPE_METADATA, ResourceType } from '../models/resource-types.js';
+/**
+ * Association resource types that represent parent-child relationships
+ * (not independently publishable resources).
+ * These are handled specially during publishing via association files
+ * (apis.json, groups.json) and should not be discovered as individual resources.
+ */
+const ASSOCIATION_TYPES = new Set([
+    ResourceType.ProductApi,
+    ResourceType.ProductGroup,
+    ResourceType.ProductTag,
+    ResourceType.GatewayApi,
+]);
+/**
+ * Fills all positional `{i}` tokens in a template string with `nameParts[i]`.
+ * Throws if a placeholder index has no corresponding entry in `nameParts`.
+ *
+ * Examples:
+ *   formatTemplatePath('apis/{0}/operations/{1}', ['petstore', 'get-user'])
+ *     → 'apis/petstore/operations/get-user'
+ *   formatTemplatePath('', []) → ''
+ */
+export function formatTemplatePath(template, nameParts) {
+    return template.replace(/\{(\d+)\}/g, (_match, idx) => {
+        const i = +idx;
+        const value = nameParts[i];
+        if (value === undefined) {
+            throw new Error(`formatTemplatePath: nameParts[${i}] is undefined for template "${template}" ` +
+                `(nameParts has ${nameParts.length} entries)`);
+        }
+        return value;
+    });
+}
+/**
+ * Returns the number of positional `{i}` placeholders in a template string.
+ *
+ * Used by callers that need to validate that enough name-parts have been
+ * supplied before filling a template — without performing regex matching
+ * themselves.
+ *
+ * Example:
+ *   countTemplatePlaceholders('apis/{0}/operations/{1}') → 2
+ *   countTemplatePlaceholders('policies/policy')         → 0
+ */
+export function countTemplatePlaceholders(template) {
+    return (template.match(/\{\d+\}/g) ?? []).length;
+}
+/**
+ * Ensures a path starts with a single leading slash.
+ *
+ * Example:
+ *   makeFullPath('namedValues/my-nv') → '/namedValues/my-nv'
+ *   makeFullPath('/namedValues/my-nv') → '/namedValues/my-nv'
+ */
+export function makeFullPath(relativePath) {
+    return relativePath.startsWith('/') ? relativePath : `/${relativePath}`;
+}
+/**
+ * Strips a single leading slash from a path, if present.
+ *
+ * Example:
+ *   makeRelativePath('/namedValues/my-nv') → 'namedValues/my-nv'
+ *   makeRelativePath('namedValues/my-nv')  → 'namedValues/my-nv'
+ */
+export function makeRelativePath(absolutePath) {
+    return absolutePath.startsWith('/') ? absolutePath.substring(1) : absolutePath;
+}
+/**
+ * Returns the resource's own name — the last element of `nameParts`.
+ *
+ * For 1-part types (e.g. Api, Product) `nameParts` contains only the own
+ * name, so this is equivalent to `nameParts[0]`.  For 2-part types (e.g.
+ * ApiOperation, ProductTag) the own name is always the final element, with
+ * the parent name preceding it.  Using this helper instead of a hard-coded
+ * index guards against future arity changes and avoids accidentally
+ * returning the parent name.
+ *
+ * Throws a `RangeError` if `nameParts` is empty.
+ *
+ * Examples:
+ *   getNameFromNameParts(['petstore'])                   → 'petstore'
+ *   getNameFromNameParts(['petstore', 'get-user'])       → 'get-user'
+ *   getNameFromNameParts([])                             → throws RangeError
+ */
+export function getNameFromNameParts(nameParts) {
+    const value = nameParts[nameParts.length - 1];
+    if (value === undefined) {
+        throw new RangeError('getNameFromNameParts: nameParts is empty');
+    }
+    return value;
+}
+/**
+ * Returns `nameParts[index]`, throwing a descriptive `RangeError` if the
+ * index is out of range.
+ *
+ * Prefer this over direct bracket access (`nameParts[0]`) so that missing
+ * name-parts surface as an explicit error rather than a silent `undefined`.
+ *
+ * Examples:
+ *   getNamePart(['petstore', 'get-user'], 0)  → 'petstore'
+ *   getNamePart(['petstore', 'get-user'], 1)  → 'get-user'
+ *   getNamePart([], 0)                        → throws RangeError
+ */
+export function getNamePart(nameParts, index) {
+    const value = nameParts[index];
+    if (value === undefined) {
+        throw new RangeError(`getNamePart: nameParts[${index}] is out of range ` +
+            `(nameParts has ${nameParts.length} ${nameParts.length === 1 ? 'entry' : 'entries'})`);
+    }
+    return value;
+}
+/**
+ * Converts a positional template string to a capturing regex.
+ * Each `{i}` placeholder becomes a `([^/]+)` capture group; all other
+ * regex-special characters are escaped.  A trailing slash (if present)
+ * is stripped before building the pattern.
+ *
+ * This function is intentionally **not exported** — callers should use the
+ * higher-level `parseTemplatePath` helper rather than constructing regexes
+ * directly.
+ */
+function templateToRegex(template) {
+    const source = template
+        .replace(/\/+$/, '') // strip any trailing slash
+        .replace(/[.+^${}()|[\]\\]/g, (ch) => (ch === '{' || ch === '}' ? ch : `\\${ch}`))
+        .replace(/\{\d+\}/g, '([^/]+)');
+    return new RegExp(`^${source}$`);
+}
+/**
+ * Matches a positional template against a slash-delimited path string and
+ * returns the captured name-part values in positional order, or `undefined`
+ * if the path does not match the template.
+ *
+ * Both artifact-directory paths and ARM path suffixes use the same
+ * `{0}`, `{1}` placeholder syntax, so this single function handles both.
+ * Callers are not required to know anything about regexes.
+ *
+ * Examples:
+ *   parseTemplatePath('apis/{0}/operations/{1}', 'apis/petstore/operations/get')
+ *     → ['petstore', 'get']
+ *   parseTemplatePath('policies/policy', 'policies/policy')
+ *     → []
+ *   parseTemplatePath('apis/{0}', 'backends/b1')
+ *     → undefined
+ */
+export function parseTemplatePath(template, path) {
+    const match = templateToRegex(template).exec(path);
+    if (!match)
+        return undefined;
+    // Captures correspond directly to {0}, {1}, … positions in the template
+    return match.slice(1);
+}
+/**
+ * Builds the artifact directory path for a given descriptor.
+ * Returns the directory where this resource's files should be stored.
+ *
+ * @param baseDir - Root artifact directory
+ * @param descriptor - Resource descriptor
+ * @returns Full directory path (OS-normalized)
+ */
+export function buildArtifactDirectory(baseDir, descriptor) {
+    const metadata = RESOURCE_TYPE_METADATA[descriptor.type];
+    let resolvedDir = formatTemplatePath(metadata.artifactDirectory, descriptor.nameParts);
+    // Handle workspace prefix
+    if (descriptor.workspace) {
+        resolvedDir = path.join('workspaces', descriptor.workspace, resolvedDir);
+    }
+    return path.join(baseDir, resolvedDir);
+}
+/**
+ * Builds the full artifact file path for a given descriptor.
+ * Returns the path to the info file (JSON/XML/MD).
+ *
+ * @param baseDir - Root artifact directory
+ * @param descriptor - Resource descriptor
+ * @returns Full file path (OS-normalized), or undefined if resource has no info file
+ */
+export function buildArtifactFilePath(baseDir, descriptor) {
+    const metadata = RESOURCE_TYPE_METADATA[descriptor.type];
+    if (!metadata.infoFile) {
+        return undefined;
+    }
+    const directory = buildArtifactDirectory(baseDir, descriptor);
+    return path.join(directory, metadata.infoFile);
+}
+/**
+ * Builds the policy file path for a resource that supports policies.
+ *
+ * @param baseDir - Root artifact directory
+ * @param descriptor - Resource descriptor
+ * @returns Full path to policy.xml file
+ */
+export function buildPolicyFilePath(baseDir, descriptor) {
+    const directory = buildArtifactDirectory(baseDir, descriptor);
+    return path.join(directory, 'policy.xml');
+}
+/**
+ * Builds the API specification file path.
+ *
+ * @param baseDir - Root artifact directory
+ * @param descriptor - API descriptor
+ * @param format - Specification format (yaml, json, graphql, wsdl, wadl)
+ * @returns Full path to specification file
+ */
+export function buildSpecificationFilePath(baseDir, descriptor, format) {
+    if (descriptor.type !== ResourceType.Api) {
+        throw new Error(`Specification path only valid for API resources, got ${descriptor.type}`);
+    }
+    const directory = buildArtifactDirectory(baseDir, descriptor);
+    const extensionMap = {
+        yaml: 'yaml',
+        json: 'json',
+        graphql: 'graphql',
+        wsdl: 'wsdl',
+        wadl: 'wadl',
+    };
+    const extension = extensionMap[format] ?? 'txt';
+    return path.join(directory, `specification.${extension}`);
+}
+/**
+ * Builds the association file path (apis.json or groups.json).
+ *
+ * @param baseDir - Root artifact directory
+ * @param descriptor - Product or Gateway descriptor
+ * @param associationType - Type of association (apis, groups, or tags)
+ * @returns Full path to association file
+ */
+export function buildAssociationFilePath(baseDir, descriptor, associationType) {
+    const validTypes = [ResourceType.Product, ResourceType.Gateway];
+    if (!validTypes.includes(descriptor.type)) {
+        throw new Error(`Association path only valid for Product/Gateway resources, got ${descriptor.type}`);
+    }
+    const directory = buildArtifactDirectory(baseDir, descriptor);
+    return path.join(directory, `${associationType}.json`);
+}
+/**
+ * Derives the list URL path segment(s) from an ARM path suffix template.
+ *
+ * The list path is structurally derivable from `armPathSuffix`:
+ * - Last segment is a fixed word (no placeholder) → singleton; neither path is present.
+ * - Exactly one `{N}` placeholder and it is the last segment → top-level resource;
+ *   `listPath` = the path before the placeholder (with a leading '/').
+ * - Two or more `{N}` placeholders and the last segment is the highest-index one →
+ *   child resource; `childListPath` = the collection segment immediately before the
+ *   last placeholder (with a leading '/').
+ *
+ * Examples:
+ *   deriveListPaths('namedValues/{0}')            → { listPath: '/namedValues' }
+ *   deriveListPaths('apis/{0}/operations/{1}')    → { childListPath: '/operations' }
+ *   deriveListPaths('policies/policy')            → {}  (singleton)
+ *   deriveListPaths('apis/{0}/policies/policy')   → {}  (singleton)
+ */
+export function deriveListPaths(template) {
+    const segments = template.split('/');
+    const lastSeg = segments[segments.length - 1];
+    // Singleton: last segment is a fixed word (not a `{N}` placeholder)
+    if (!lastSeg || !/^\{\d+\}$/.test(lastSeg)) {
+        return {};
+    }
+    const placeholderCount = countTemplatePlaceholders(template);
+    if (placeholderCount === 1) {
+        // Top-level resource: list path = everything before the placeholder
+        const listBase = segments.slice(0, -1).join('/');
+        return { listPath: `/${listBase}` };
+    }
+    // Child resource: child-list path = collection segment immediately before the last placeholder
+    const collectionSeg = segments[segments.length - 2];
+    return { childListPath: `/${collectionSeg}` };
+}
+/**
+ * Parses an artifact file path back into a ResourceDescriptor.
+ * Inverse of buildArtifactFilePath.
+ *
+ * @param baseDir - Root artifact directory
+ * @param filePath - Full path to artifact file
+ * @returns ResourceDescriptor or undefined if path doesn't match known patterns
+ */
+export function parseArtifactPath(baseDir, filePath) {
+    // Get relative path from base directory
+    const relativePath = path.relative(baseDir, filePath);
+    const parts = relativePath.split(path.sep);
+    // Check for workspace prefix
+    let workspace;
+    let startIndex = 0;
+    if (parts[0] === 'workspaces' && parts[1]) {
+        workspace = parts[1];
+        startIndex = 2;
+    }
+    // Get the file name
+    const fileName = parts[parts.length - 1];
+    if (!fileName) {
+        return undefined;
+    }
+    // Try to match against each resource type's pattern
+    for (const [typeKey, metadata] of Object.entries(RESOURCE_TYPE_METADATA)) {
+        const type = typeKey;
+        if (metadata.infoFile !== fileName) {
+            continue;
+        }
+        // Skip association resource types — these are handled specially during publishing
+        // via their parent's association files (apis.json, groups.json)
+        if (ASSOCIATION_TYPES.has(type)) {
+            return undefined;
+        }
+        const nameParts = parseTemplatePath(metadata.artifactDirectory, parts.slice(startIndex, -1).join('/'));
+        if (nameParts !== undefined) {
+            return { type, nameParts, workspace };
+        }
+    }
+    return undefined;
+}
+/**
+ * Check if a resource type is a singleton (no list, only get).
+ * Singletons have armPathSuffix ending with a fixed segment (no `{n}` placeholder).
+ * E.g., ServicePolicy (`policies/policy`), ApiWiki (`apis/{0}/wikis/default`).
+ */
+export function isSingletonType(type) {
+    const meta = RESOURCE_TYPE_METADATA[type];
+    // Singleton if the last segment doesn't contain a placeholder
+    const lastSegment = meta.armPathSuffix.split('/').pop() ?? '';
+    return !lastSegment.includes('{');
+}
+/**
+ * Check if a resource type is a child type requiring a parent.
+ * Child types have armPathSuffix with more path segments after the first placeholder.
+ * E.g., `apis/{0}/tags/{1}` or `apis/{0}/policies/policy`.
+ */
+export function isChildType(type) {
+    const meta = RESOURCE_TYPE_METADATA[type];
+    const placeholderCount = countTemplatePlaceholders(meta.armPathSuffix);
+    // 2+ placeholders means it's definitely a child (e.g., apis/{0}/tags/{1})
+    if (placeholderCount >= 2)
+        return true;
+    // Check for nested fixed-name resources under a parent (e.g., apis/{0}/policies/policy)
+    const parts = meta.armPathSuffix.split('/');
+    const firstPlaceholderIdx = parts.findIndex(p => p.includes('{'));
+    return firstPlaceholderIdx >= 0 && firstPlaceholderIdx < parts.length - 1;
+}
+/**
+ * Compute the publish tier for a resource type based on ARM path structure.
+ * Resources are published from lowest tier to highest; same tier runs in parallel.
+ *
+ * Tier formula: `placeholderCount * 2 + (hasSegmentsAfterLastPlaceholder ? 1 : 0)`
+ *
+ * This ensures:
+ * - Fewer placeholders = earlier tier (parents before children)
+ * - Within same placeholder count, resources ending at a placeholder come
+ *   before those with fixed segments after (e.g., operations before operation policies)
+ *
+ * Examples:
+ *   `apis/{0}`                              → tier 2 (1 placeholder, ends at placeholder)
+ *   `apis/{0}/policies/policy`              → tier 3 (1 placeholder, has suffix)
+ *   `apis/{0}/operations/{1}`               → tier 4 (2 placeholders, ends at placeholder)
+ *   `apis/{0}/operations/{1}/policies/policy` → tier 5 (2 placeholders, has suffix)
+ */
+export function getPublishTier(type) {
+    const meta = RESOURCE_TYPE_METADATA[type];
+    const parts = meta.armPathSuffix.split('/');
+    const placeholderCount = countTemplatePlaceholders(meta.armPathSuffix);
+    // Find the index of the last segment containing a placeholder
+    let lastPlaceholderIdx = -1;
+    for (let i = 0; i < parts.length; i++) {
+        if (parts[i].includes('{')) {
+            lastPlaceholderIdx = i;
+        }
+    }
+    // Check if there are segments after the last placeholder
+    const hasSegmentsAfter = lastPlaceholderIdx >= 0 && lastPlaceholderIdx < parts.length - 1;
+    return placeholderCount * 2 + (hasSegmentsAfter ? 1 : 0);
+}
+/**
+ * Check if a resource type is a "grandchild" - has path segments after the last placeholder.
+ * These types depend on an intermediate parent that must exist first.
+ *
+ * @deprecated Use getPublishTier() for N-tier ordering instead
+ */
+export function hasNestedParent(type) {
+    const meta = RESOURCE_TYPE_METADATA[type];
+    const parts = meta.armPathSuffix.split('/');
+    // Find the index of the last segment containing a placeholder
+    let lastPlaceholderIdx = -1;
+    for (let i = 0; i < parts.length; i++) {
+        if (parts[i].includes('{')) {
+            lastPlaceholderIdx = i;
+        }
+    }
+    // No placeholders = top-level singleton (ServicePolicy), not a grandchild
+    if (lastPlaceholderIdx === -1)
+        return false;
+    // Grandchild if there are segments after the last placeholder
+    // AND there are at least 2 placeholders (meaning there's an intermediate parent)
+    const hasSegmentsAfter = lastPlaceholderIdx < parts.length - 1;
+    const placeholderCount = countTemplatePlaceholders(meta.armPathSuffix);
+    return hasSegmentsAfter && placeholderCount >= 2;
+}
+//# sourceMappingURL=resource-path.js.map

package/dist/lib/resource-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-path.js","sourceRoot":"","sources":["../../src/lib/resource-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAe;IAC9C,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,YAAY;IACzB,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,UAAU;CACxB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,SAAmB;IACtE,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE;QAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,iCAAiC,CAAC,gCAAgC,QAAQ,IAAI;gBAC9E,kBAAkB,SAAS,CAAC,MAAM,WAAW,CAC9C,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB;IACnD,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAmB;IACtD,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,SAAmB,EAAE,KAAa;IAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,0BAA0B,KAAK,oBAAoB;YACnD,kBAAkB,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,MAAM,GAAG,QAAQ;SACpB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,2BAA2B;SAC/C,OAAO,CAAC,mBAAmB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;SACjF,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAClC,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAY;IAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,wEAAwE;IACxE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,UAA8B;IAE9B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAEvF,0BAA0B;IAC1B,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,UAA8B;IAE9B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,UAA8B;IAE9B,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,UAA8B,EAC9B,MAAqD;IAErD,IAAI,UAAU,CAAC,IAAI,KAAK,YAAY,CAAC,GAAG,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,wDAAwD,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE9D,MAAM,YAAY,GAA2B;QAC3C,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,SAAS,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,UAA8B,EAC9B,eAA2C;IAE3C,MAAM,UAAU,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,kEAAkE,UAAU,CAAC,IAAI,EAAE,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,eAAe,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAI9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9C,oEAAoE;IACpE,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAE7D,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAC3B,oEAAoE;QACpE,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,IAAI,QAAQ,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,+FAA+F;IAC/F,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,aAAa,EAAE,IAAI,aAAa,EAAE,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,QAAgB;IAEhB,wCAAwC;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE3C,6BAA6B;IAC7B,IAAI,SAA6B,CAAC;IAClC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,GAAG,OAAuB,CAAC;QAErC,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,kFAAkF;QAClF,gEAAgE;QAChE,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,SAAS,GAAG,iBAAiB,CACjC,QAAQ,CAAC,iBAAiB,EAC1B,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACtC,CAAC;QAEF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC9D,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvE,0EAA0E;IAC1E,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,wFAAwF;IACxF,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,mBAAmB,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,OAAO,mBAAmB,IAAI,CAAC,IAAI,mBAAmB,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAEvE,8DAA8D;IAC9D,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,kBAAkB,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,MAAM,gBAAgB,GAAG,kBAAkB,IAAI,CAAC,IAAI,kBAAkB,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAE1F,OAAO,gBAAgB,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5C,8DAA8D;IAC9D,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,kBAAkB,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,IAAI,kBAAkB,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,8DAA8D;IAC9D,iFAAiF;IACjF,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAEvE,OAAO,gBAAgB,IAAI,gBAAgB,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/resource-uri.d.ts

@@ -0,0 +1,40 @@
+/**
+ * T012: Resource descriptor ↔ ARM URI mapping
+ * Build full ARM URL from ApimServiceContext + ResourceDescriptor
+ */
+import { ApimServiceContext, ResourceDescriptor } from '../models/types.js';
+/**
+ * Builds the full ARM resource URI for a given descriptor and service context.
+ * Includes workspace prefix if descriptor.workspace is set.
+ *
+ * @param context - APIM service context containing base URL
+ * @param descriptor - Resource descriptor with type and nameParts
+ * @returns Full ARM URL including API version query parameter
+ */
+export declare function buildArmUri(context: ApimServiceContext, descriptor: ResourceDescriptor): string;
+/**
+ * Parses an ARM resource URI into a ResourceDescriptor.
+ * Inverse of buildArmUri.
+ *
+ * @param uri - Full ARM resource URI
+ * @param context - APIM service context for validation
+ * @returns ResourceDescriptor or undefined if URI doesn't match expected pattern
+ */
+export declare function parseArmUri(uri: string, context: ApimServiceContext): ResourceDescriptor | undefined;
+/**
+ * Builds a human-readable ARM-path-style label for log output.
+ *
+ * Fills every `{i}` placeholder in `armPathSuffix` with `nameParts[i]`
+ * (no encoding — this is for display only).
+ *
+ * Examples:
+ *   NamedValue ['mySecret']                 → 'namedValues/mySecret'
+ *   ApiOperation ['petstore', 'get-user']   → 'apis/petstore/operations/get-user'
+ *   ApiOperationPolicy ['petstore', 'get']  → 'apis/petstore/operations/get/policies/policy'
+ *   ServicePolicy []                        → 'policies/policy'
+ *
+ * @param descriptor - Resource descriptor
+ * @returns ARM-path-style label string
+ */
+export declare function buildResourceLabel(descriptor: ResourceDescriptor): string;
+//# sourceMappingURL=resource-uri.d.ts.map

package/dist/lib/resource-uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-uri.d.ts","sourceRoot":"","sources":["../../src/lib/resource-uri.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI5E;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAoBR;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,GAAG,SAAS,CAmChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAIzE"}

package/dist/lib/resource-uri.js

@@ -0,0 +1,86 @@
+/**
+ * T012: Resource descriptor ↔ ARM URI mapping
+ * Build full ARM URL from ApimServiceContext + ResourceDescriptor
+ */
+import { RESOURCE_TYPE_METADATA } from '../models/resource-types.js';
+import { formatTemplatePath, parseTemplatePath, countTemplatePlaceholders, makeFullPath, makeRelativePath } from './resource-path.js';
+/**
+ * Builds the full ARM resource URI for a given descriptor and service context.
+ * Includes workspace prefix if descriptor.workspace is set.
+ *
+ * @param context - APIM service context containing base URL
+ * @param descriptor - Resource descriptor with type and nameParts
+ * @returns Full ARM URL including API version query parameter
+ */
+export function buildArmUri(context, descriptor) {
+    const metadata = RESOURCE_TYPE_METADATA[descriptor.type];
+    // Validate that all positional placeholders have a corresponding name-part
+    const placeholderCount = countTemplatePlaceholders(metadata.armPathSuffix);
+    if (descriptor.nameParts.length < placeholderCount) {
+        throw new Error(`Unresolved placeholder in ARM path for ${descriptor.type}: expected ${placeholderCount} name-parts, got ${descriptor.nameParts.length}`);
+    }
+    // URL-encode each name part before filling the ARM path template
+    const armPath = formatTemplatePath(metadata.armPathSuffix, descriptor.nameParts.map(encodeURIComponent));
+    // Add workspace prefix if workspace-scoped; prepend '/' to produce an absolute path
+    const fullPath = descriptor.workspace
+        ? makeFullPath(`workspaces/${encodeURIComponent(descriptor.workspace)}/${armPath}`)
+        : makeFullPath(armPath);
+    return `${context.baseUrl}${fullPath}?api-version=${context.apiVersion}`;
+}
+/**
+ * Parses an ARM resource URI into a ResourceDescriptor.
+ * Inverse of buildArmUri.
+ *
+ * @param uri - Full ARM resource URI
+ * @param context - APIM service context for validation
+ * @returns ResourceDescriptor or undefined if URI doesn't match expected pattern
+ */
+export function parseArmUri(uri, context) {
+    // Remove query parameters
+    const urlWithoutQuery = uri.split('?')[0];
+    // Remove base URL to get relative path
+    if (!urlWithoutQuery?.startsWith(context.baseUrl)) {
+        return undefined;
+    }
+    let relativePath = urlWithoutQuery.substring(context.baseUrl.length);
+    // Extract workspace if present
+    let workspace;
+    const workspaceMatch = relativePath.match(/^\/workspaces\/([^/]+)(.*)/);
+    if (workspaceMatch && workspaceMatch[1] && workspaceMatch[2]) {
+        workspace = decodeURIComponent(workspaceMatch[1]);
+        relativePath = workspaceMatch[2];
+    }
+    // Strip the leading '/' — armPathSuffix templates have no leading slash
+    relativePath = makeRelativePath(relativePath);
+    // Try to match against each resource type's ARM path pattern
+    for (const [typeKey, metadata] of Object.entries(RESOURCE_TYPE_METADATA)) {
+        const type = typeKey;
+        // Use the shared parseTemplatePath helper — no direct regex construction here
+        const nameParts = parseTemplatePath(metadata.armPathSuffix, relativePath);
+        if (nameParts) {
+            return { type, nameParts: nameParts.map((m) => decodeURIComponent(m)), workspace };
+        }
+    }
+    return undefined;
+}
+/**
+ * Builds a human-readable ARM-path-style label for log output.
+ *
+ * Fills every `{i}` placeholder in `armPathSuffix` with `nameParts[i]`
+ * (no encoding — this is for display only).
+ *
+ * Examples:
+ *   NamedValue ['mySecret']                 → 'namedValues/mySecret'
+ *   ApiOperation ['petstore', 'get-user']   → 'apis/petstore/operations/get-user'
+ *   ApiOperationPolicy ['petstore', 'get']  → 'apis/petstore/operations/get/policies/policy'
+ *   ServicePolicy []                        → 'policies/policy'
+ *
+ * @param descriptor - Resource descriptor
+ * @returns ARM-path-style label string
+ */
+export function buildResourceLabel(descriptor) {
+    const metadata = RESOURCE_TYPE_METADATA[descriptor.type];
+    // armPathSuffix has no leading slash, so the result is already relative
+    return formatTemplatePath(metadata.armPathSuffix, descriptor.nameParts);
+}
+//# sourceMappingURL=resource-uri.js.map

package/dist/lib/resource-uri.js.map

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

package/dist/lib/user-agent.d.ts

@@ -0,0 +1,2 @@
+export declare const USER_AGENT: string;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/lib/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../src/lib/user-agent.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,QAA8B,CAAC"}

package/dist/lib/user-agent.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+export const USER_AGENT = `apiops-cli/${pkg.version}`;
+//# sourceMappingURL=user-agent.js.map

package/dist/lib/user-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.js","sourceRoot":"","sources":["../../src/lib/user-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEjE,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC"}

package/dist/models/config.d.ts

@@ -0,0 +1,83 @@
+/**
+ * T008: Config interfaces
+ * ExtractConfig, FilterConfig, PublishConfig, OverrideConfig, InitConfig
+ */
+import { ApimServiceContext } from './types.js';
+import { LogLevel } from '../lib/logger.js';
+export interface ExtractConfig {
+    service: ApimServiceContext;
+    outputDir: string;
+    filter?: FilterConfig;
+    includeTransitive: boolean;
+    specFormat?: string;
+    logLevel: LogLevel;
+    otelConfigPath?: string;
+}
+export interface FilterConfig {
+    apiNames?: string[];
+    backendNames?: string[];
+    productNames?: string[];
+    namedValueNames?: string[];
+    loggerNames?: string[];
+    diagnosticNames?: string[];
+    tagNames?: string[];
+    policyFragmentNames?: string[];
+    gatewayNames?: string[];
+    versionSetNames?: string[];
+    groupNames?: string[];
+    subscriptionNames?: string[];
+    schemaNames?: string[];
+    policyRestrictionNames?: string[];
+    documentationNames?: string[];
+    workspaceNames?: string[];
+}
+export interface PublishConfig {
+    service: ApimServiceContext;
+    sourceDir: string;
+    overrides?: OverrideConfig;
+    dryRun: boolean;
+    deleteUnmatched: boolean;
+    commitId?: string;
+    logLevel: LogLevel;
+    otelConfigPath?: string;
+}
+export interface OverrideConfig {
+    namedValues?: Record<string, NamedValueOverride>;
+    backends?: Record<string, BackendOverride>;
+    apis?: Record<string, ApiOverride>;
+    diagnostics?: Record<string, DiagnosticOverride>;
+    loggers?: Record<string, LoggerOverride>;
+}
+export interface NamedValueOverride {
+    value?: string;
+    displayName?: string;
+    tags?: string[];
+    keyVault?: {
+        identityClientId?: string;
+        secretIdentifier?: string;
+    };
+}
+export interface BackendOverride {
+    url?: string;
+    credentials?: Record<string, unknown>;
+}
+export interface ApiOverride {
+    serviceUrl?: string;
+}
+export interface DiagnosticOverride {
+    loggerId?: string;
+}
+export interface LoggerOverride {
+    credentials?: Record<string, unknown>;
+    resourceId?: string;
+}
+export interface InitConfig {
+    ciProvider?: 'github-actions' | 'azure-devops';
+    nonInteractive: boolean;
+    artifactDir: string;
+    environments: string[];
+    outputDir: string;
+    cliPackage: string;
+    force: boolean;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/models/config.d.ts.map

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