@azure-tools/typespec-azure-examples 0.2.0-dev.1 → 0.2.0-dev.2

package/dist/src/migrate/normalize.js

@@ -0,0 +1,63 @@
+/**
+ * Normalize embedded concrete API-version strings to the `{api-version}` placeholder.
+ *
+ * `x-ms-examples` frequently bake the api-version into header and body string values
+ * (`Location`, `Azure-AsyncOperation`, `nextLink`, ...). Replacing those with `{api-version}`
+ * lets otherwise-identical variants across versions collapse into a single lineage entry.
+ */
+/** Recursively replace occurrences of `version` in string values with `{api-version}`. */
+export function normalizeApiVersion(value, version) {
+    return normalize(value, buildMatcher([version]));
+}
+/**
+ * Normalize using any of the provided versions (longest first, so more specific version strings
+ * win over prefixes).
+ */
+export function normalizeApiVersions(value, versions) {
+    const ordered = [...new Set(versions)].filter((v) => v.length > 0);
+    if (ordered.length === 0)
+        return value;
+    return normalize(value, buildMatcher(ordered));
+}
+/**
+ * A trailing guard so an api-version string is only matched as a whole token. Azure api-versions are
+ * `YYYY-MM-DD[-suffix]` and are never immediately followed by a digit or the ISO-8601 time
+ * designator `T`, so this prevents corrupting embedded timestamps such as `2023-01-01T09:00:00Z`.
+ */
+const VERSION_BOUNDARY = "(?![T\\d])";
+function buildMatcher(versions) {
+    // Longest first so a more specific version (e.g. `...-preview`) wins over a prefix.
+    const alternation = [...versions]
+        .sort((a, b) => b.length - a.length)
+        .map(escapeRegExp)
+        .join("|");
+    return {
+        embedded: new RegExp(`(?:${alternation})${VERSION_BOUNDARY}`, "g"),
+        bare: new RegExp(`^(?:${alternation})$`),
+    };
+}
+function normalize(value, matcher) {
+    if (typeof value === "string") {
+        // A scalar whose entire value is a bare api-version is real data (e.g. a `date` field), not a
+        // version embedded in a URL or header — leave it untouched so migration stays lossless.
+        if (matcher.bare.test(value))
+            return value;
+        matcher.embedded.lastIndex = 0;
+        return value.replace(matcher.embedded, "{api-version}");
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalize(item, matcher));
+    }
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            out[key] = normalize(item, matcher);
+        }
+        return out;
+    }
+    return value;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=normalize.js.map

package/dist/src/migrate/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/migrate/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0FAA0F;AAC1F,MAAM,UAAU,mBAAmB,CAAI,KAAQ,EAAE,OAAe;IAC9D,OAAO,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAM,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAI,KAAQ,EAAE,QAA2B;IAC3E,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAM,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAStC,SAAS,YAAY,CAAC,QAA2B;IAC/C,oFAAoF;IACpF,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;SACnC,GAAG,CAAC,YAAY,CAAC;SACjB,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO;QACL,QAAQ,EAAE,IAAI,MAAM,CAAC,MAAM,WAAW,IAAI,gBAAgB,EAAE,EAAE,GAAG,CAAC;QAClE,IAAI,EAAE,IAAI,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,OAAgB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,8FAA8F;QAC9F,wFAAwF;QACxF,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/src/migrate/operation-key.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Derive the `examples.yaml` operation key from a Swagger `operationId`.
+ *
+ * Swagger operation ids follow the `Interface_Method` convention (as emitted by
+ * `@azure-tools/typespec-autorest`). The unified format uses the interface-relative key
+ * `Interface.method` with a lower-cased first letter on the method (e.g. `CaCertificates_Get`
+ * becomes `CaCertificates.get`). Operation ids without an underscore become a bare top-level key.
+ */
+export declare function deriveOperationKey(operationId: string): string;
+/** The interface portion of a derived operation key (everything before the first `.`). */
+export declare function interfaceOf(operationKey: string): string;
+//# sourceMappingURL=operation-key.d.ts.map

package/dist/src/migrate/operation-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-key.d.ts","sourceRoot":"","sources":["../../../src/migrate/operation-key.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/src/migrate/operation-key.js

@@ -0,0 +1,28 @@
+/**
+ * Derive the `examples.yaml` operation key from a Swagger `operationId`.
+ *
+ * Swagger operation ids follow the `Interface_Method` convention (as emitted by
+ * `@azure-tools/typespec-autorest`). The unified format uses the interface-relative key
+ * `Interface.method` with a lower-cased first letter on the method (e.g. `CaCertificates_Get`
+ * becomes `CaCertificates.get`). Operation ids without an underscore become a bare top-level key.
+ */
+export function deriveOperationKey(operationId) {
+    const underscore = operationId.indexOf("_");
+    if (underscore < 0) {
+        return operationId;
+    }
+    const iface = operationId.slice(0, underscore);
+    const method = operationId.slice(underscore + 1);
+    return `${iface}.${lowerFirst(method)}`;
+}
+/** The interface portion of a derived operation key (everything before the first `.`). */
+export function interfaceOf(operationKey) {
+    const dot = operationKey.indexOf(".");
+    return dot < 0 ? operationKey : operationKey.slice(0, dot);
+}
+function lowerFirst(value) {
+    if (value.length === 0)
+        return value;
+    return value.charAt(0).toLowerCase() + value.slice(1);
+}
+//# sourceMappingURL=operation-key.js.map

package/dist/src/migrate/operation-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-key.js","sourceRoot":"","sources":["../../../src/migrate/operation-key.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,YAAoB;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/migrate/swagger-types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Types describing the *inputs* to `tsp-examples-migrate`: the classic Swagger `x-ms-examples`
+ * extension and the referenced example JSON documents.
+ */
+/** Parameter location as declared on a Swagger operation/path parameter. */
+export type ParameterLocation = "path" | "query" | "header" | "body" | "formData";
+/** A Swagger parameter object (or a `$ref` to one). */
+export interface SwaggerParameter {
+    readonly name?: string;
+    readonly in?: ParameterLocation;
+    readonly $ref?: string;
+}
+/** A single Swagger operation carrying `x-ms-examples`. */
+export interface SwaggerOperation {
+    readonly operationId?: string;
+    readonly parameters?: SwaggerParameter[];
+    readonly "x-ms-examples"?: Record<string, {
+        readonly $ref?: string;
+    }>;
+}
+/** The subset of a Swagger document `tsp-examples-migrate` reads. */
+export interface SwaggerDocument {
+    readonly info?: {
+        readonly title?: string;
+        readonly version?: string;
+    };
+    readonly parameters?: Record<string, SwaggerParameter>;
+    readonly paths?: Record<string, SwaggerPathItem>;
+}
+/** A Swagger path item: HTTP methods plus optional path-level `parameters`. */
+export interface SwaggerPathItem {
+    readonly parameters?: SwaggerParameter[];
+    readonly [method: string]: unknown;
+}
+/** The referenced `x-ms-examples` example document. */
+export interface XmsExampleDoc {
+    readonly operationId?: string;
+    readonly title?: string;
+    readonly parameters?: Record<string, unknown>;
+    readonly responses?: Record<string, XmsExampleResponse>;
+}
+export interface XmsExampleResponse {
+    readonly headers?: Record<string, unknown>;
+    readonly body?: unknown;
+}
+/** The HTTP methods that can carry an operation on a Swagger path item. */
+export declare const HTTP_METHODS: readonly ["get", "put", "post", "delete", "options", "head", "patch"];
+//# sourceMappingURL=swagger-types.d.ts.map

package/dist/src/migrate/swagger-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger-types.d.ts","sourceRoot":"","sources":["../../../src/migrate/swagger-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAElF,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAClD;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,uEAAwE,CAAC"}

package/dist/src/migrate/swagger-types.js

@@ -0,0 +1,7 @@
+/**
+ * Types describing the *inputs* to `tsp-examples-migrate`: the classic Swagger `x-ms-examples`
+ * extension and the referenced example JSON documents.
+ */
+/** The HTTP methods that can carry an operation on a Swagger path item. */
+export const HTTP_METHODS = ["get", "put", "post", "delete", "options", "head", "patch"];
+//# sourceMappingURL=swagger-types.js.map

package/dist/src/migrate/swagger-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger-types.js","sourceRoot":"","sources":["../../../src/migrate/swagger-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6CH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC"}

package/dist/src/migrate/swagger.d.ts

@@ -0,0 +1,49 @@
+import type { ParameterLocation, SwaggerDocument, SwaggerParameter, XmsExampleDoc } from "./swagger-types.js";
+/** An operation extracted from a Swagger document, with its parameter-location map. */
+export interface ExtractedOperation {
+    readonly operationId: string;
+    readonly paramLocations: Map<string, ParameterLocation>;
+    readonly examples: Record<string, {
+        readonly $ref?: string;
+    }>;
+}
+/** One example, fully loaded and associated with an operation and API version. */
+export interface CrawledExample {
+    readonly operationId: string;
+    readonly version: string;
+    readonly exampleName: string;
+    /** The original `x-ms-examples` file name (basename of the `$ref`), e.g. `Foo_Get.json`. */
+    readonly fileName: string;
+    readonly doc: XmsExampleDoc;
+    readonly paramLocations: Map<string, ParameterLocation>;
+}
+/** The full result of crawling a spec tree. */
+export interface CrawlResult {
+    readonly examples: CrawledExample[];
+    readonly namespace?: string;
+    readonly versions: string[];
+}
+/** Detect the resource-provider namespace from Swagger path templates (`/providers/<NS>/`). */
+export declare function namespaceFromPaths(pathKeys: Iterable<string>): string | undefined;
+/** Resolve a local `#/parameters/<name>` reference against the document's parameter map. */
+export declare function resolveLocalParam(doc: SwaggerDocument, parameter: SwaggerParameter): SwaggerParameter | undefined;
+/** Build a parameter-name → location map from path-level and operation-level parameters. */
+export declare function collectParamLocations(doc: SwaggerDocument, parameters: readonly SwaggerParameter[] | undefined): Map<string, ParameterLocation>;
+/** Extract every operation that carries `x-ms-examples` from a parsed Swagger document. */
+export declare function extractOperations(doc: SwaggerDocument): ExtractedOperation[];
+/**
+ * Extract the API version from a Swagger file path: the path segment immediately following a
+ * `stable` or `preview` segment (the Azure spec layout). Returns `undefined` when not found.
+ */
+export declare function versionFromPath(filePath: string): string | undefined;
+/** Resolve an `x-ms-examples` `$ref` (relative file path with optional fragment) to a file path. */
+export declare function resolveRefPath(fromFile: string, ref: string): string;
+/**
+ * Recursively discover Swagger documents under `root`. A file qualifies when its path contains a
+ * `stable`/`preview` version segment and its content has a `paths` object (i.e. it is a service
+ * spec, not an example JSON).
+ */
+export declare function discoverSwaggerFiles(root: string): Promise<string[]>;
+/** Crawl `root`, loading every `x-ms-examples` document for every versioned Swagger operation. */
+export declare function crawlExamples(root: string): Promise<CrawlResult>;
+//# sourceMappingURL=swagger.d.ts.map

package/dist/src/migrate/swagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../../src/migrate/swagger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAEf,gBAAgB,EAChB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAG5B,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACzD;AAED,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAMjF;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,gBAAgB,GAC1B,gBAAgB,GAAG,SAAS,CAK9B;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,GAClD,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAShC;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,EAAE,CAkB5E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQpE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW1E;AAOD,kGAAkG;AAClG,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA0CtE"}

package/dist/src/migrate/swagger.js

@@ -0,0 +1,144 @@
+import { readdir, readFile } from "fs/promises";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "path";
+import { HTTP_METHODS } from "./swagger-types.js";
+/** Detect the resource-provider namespace from Swagger path templates (`/providers/<NS>/`). */
+export function namespaceFromPaths(pathKeys) {
+    for (const path of pathKeys) {
+        const match = /\/providers\/([^/{}]+)\//.exec(path);
+        if (match)
+            return match[1];
+    }
+    return undefined;
+}
+/** Resolve a local `#/parameters/<name>` reference against the document's parameter map. */
+export function resolveLocalParam(doc, parameter) {
+    if (parameter.$ref === undefined)
+        return parameter;
+    const match = /^#\/parameters\/(.+)$/.exec(parameter.$ref);
+    if (!match)
+        return undefined;
+    return doc.parameters?.[decodeURIComponent(match[1])];
+}
+/** Build a parameter-name → location map from path-level and operation-level parameters. */
+export function collectParamLocations(doc, parameters) {
+    const map = new Map();
+    for (const raw of parameters ?? []) {
+        const resolved = resolveLocalParam(doc, raw);
+        if (resolved?.name !== undefined && resolved.in !== undefined) {
+            map.set(resolved.name, resolved.in);
+        }
+    }
+    return map;
+}
+/** Extract every operation that carries `x-ms-examples` from a parsed Swagger document. */
+export function extractOperations(doc) {
+    const operations = [];
+    for (const pathItem of Object.values(doc.paths ?? {})) {
+        const pathParams = pathItem.parameters;
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (operation === undefined || typeof operation !== "object")
+                continue;
+            const examples = operation["x-ms-examples"];
+            if (examples === undefined || operation.operationId === undefined)
+                continue;
+            const paramLocations = collectParamLocations(doc, [
+                ...(pathParams ?? []),
+                ...(operation.parameters ?? []),
+            ]);
+            operations.push({ operationId: operation.operationId, paramLocations, examples });
+        }
+    }
+    return operations;
+}
+/**
+ * Extract the API version from a Swagger file path: the path segment immediately following a
+ * `stable` or `preview` segment (the Azure spec layout). Returns `undefined` when not found.
+ */
+export function versionFromPath(filePath) {
+    const segments = filePath.split(/[\\/]/);
+    for (let i = 0; i < segments.length - 1; i++) {
+        if (segments[i] === "stable" || segments[i] === "preview") {
+            return segments[i + 1];
+        }
+    }
+    return undefined;
+}
+/** Resolve an `x-ms-examples` `$ref` (relative file path with optional fragment) to a file path. */
+export function resolveRefPath(fromFile, ref) {
+    const withoutFragment = ref.split("#")[0];
+    if (isAbsolute(withoutFragment))
+        return withoutFragment;
+    return resolve(dirname(fromFile), withoutFragment);
+}
+/**
+ * Recursively discover Swagger documents under `root`. A file qualifies when its path contains a
+ * `stable`/`preview` version segment and its content has a `paths` object (i.e. it is a service
+ * spec, not an example JSON).
+ */
+export async function discoverSwaggerFiles(root) {
+    const entries = await readdir(root, { recursive: true, withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(".json"))
+            continue;
+        const full = join(entryDir(entry, root), entry.name);
+        if (versionFromPath(full) === undefined)
+            continue;
+        if (full.split(sep).includes("examples"))
+            continue;
+        files.push(full);
+    }
+    return files.sort();
+}
+function entryDir(entry, root) {
+    // Node's Dirent exposes `parentPath` (>=20.12) or the older `path`.
+    return entry.parentPath ?? entry.path ?? root;
+}
+/** Crawl `root`, loading every `x-ms-examples` document for every versioned Swagger operation. */
+export async function crawlExamples(root) {
+    const files = await discoverSwaggerFiles(root);
+    const crawled = [];
+    const versions = new Set();
+    let namespace;
+    for (const file of files) {
+        let doc;
+        try {
+            doc = JSON.parse(await readFile(file, "utf-8"));
+        }
+        catch {
+            continue;
+        }
+        if (doc.paths === undefined)
+            continue;
+        const version = versionFromPath(file);
+        if (version === undefined)
+            continue;
+        versions.add(version);
+        namespace ??= namespaceFromPaths(Object.keys(doc.paths));
+        for (const operation of extractOperations(doc)) {
+            for (const [exampleName, entry] of Object.entries(operation.examples)) {
+                if (entry?.$ref === undefined)
+                    continue;
+                const examplePath = resolveRefPath(file, entry.$ref);
+                let exampleDoc;
+                try {
+                    exampleDoc = JSON.parse(await readFile(examplePath, "utf-8"));
+                }
+                catch {
+                    continue;
+                }
+                crawled.push({
+                    operationId: operation.operationId,
+                    version,
+                    exampleName,
+                    fileName: basename(examplePath),
+                    doc: exampleDoc,
+                    paramLocations: operation.paramLocations,
+                });
+            }
+        }
+    }
+    return { examples: crawled, namespace, versions: [...versions] };
+}
+//# sourceMappingURL=swagger.js.map

package/dist/src/migrate/swagger.js.map

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

package/dist/src/migrate/transform.d.ts

@@ -0,0 +1,12 @@
+import type { MigratedVariant } from "./model.js";
+import type { ParameterLocation, XmsExampleDoc } from "./swagger-types.js";
+/**
+ * Convert one `x-ms-examples` document into a {@link MigratedVariant}, using a map of
+ * parameter-name → location (built from the operation's Swagger parameter definitions) to bucket
+ * each example parameter into `request.path` / `query` / `headers` / `body`.
+ *
+ * The implicit `api-version` parameter is dropped. Parameters whose location is unknown (not
+ * declared on the operation) default to `query`.
+ */
+export declare function transformExample(doc: XmsExampleDoc, paramLocations: ReadonlyMap<string, ParameterLocation>): MigratedVariant;
+//# sourceMappingURL=transform.d.ts.map

package/dist/src/migrate/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/migrate/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqC,eAAe,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACrD,eAAe,CAoCjB"}

package/dist/src/migrate/transform.js

@@ -0,0 +1,45 @@
+/**
+ * Convert one `x-ms-examples` document into a {@link MigratedVariant}, using a map of
+ * parameter-name → location (built from the operation's Swagger parameter definitions) to bucket
+ * each example parameter into `request.path` / `query` / `headers` / `body`.
+ *
+ * The implicit `api-version` parameter is dropped. Parameters whose location is unknown (not
+ * declared on the operation) default to `query`.
+ */
+export function transformExample(doc, paramLocations) {
+    const request = {};
+    for (const [name, value] of Object.entries(doc.parameters ?? {})) {
+        if (name.toLowerCase() === "api-version")
+            continue;
+        const location = paramLocations.get(name) ?? "query";
+        switch (location) {
+            case "body":
+                request.body = value;
+                break;
+            case "path":
+                (request.path ??= {})[name] = value;
+                break;
+            case "header":
+                (request.headers ??= {})[name] = value;
+                break;
+            case "query":
+            case "formData":
+            default:
+                (request.query ??= {})[name] = value;
+                break;
+        }
+    }
+    const responses = {};
+    for (const [code, response] of Object.entries(doc.responses ?? {})) {
+        const mapped = {};
+        if (response && typeof response === "object") {
+            if (response.headers !== undefined)
+                mapped.headers = response.headers;
+            if (response.body !== undefined)
+                mapped.body = response.body;
+        }
+        responses[code] = mapped;
+    }
+    return { request, responses };
+}
+//# sourceMappingURL=transform.js.map

package/dist/src/migrate/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/migrate/transform.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAkB,EAClB,cAAsD;IAEtD,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,aAAa;YAAE,SAAS;QAEnD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;QACrD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC;gBACrB,MAAM;YACR,KAAK,MAAM;gBACT,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACpC,MAAM;YACR,KAAK,QAAQ;gBACX,CAAC,OAAO,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACvC,MAAM;YACR,KAAK,OAAO,CAAC;YACb,KAAK,UAAU,CAAC;YAChB;gBACE,CAAC,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACrC,MAAM;QACV,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAqC,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QACnE,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC7C,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;YACtE,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC/D,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/dist/src/migrate/version-order.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Version ordering for migration. Azure API versions are date-based (`YYYY-MM-DD`) with an optional
+ * `-preview`/`-beta` suffix. When a `service.yaml` order is available it is authoritative; otherwise
+ * this heuristic sorts by date ascending and places a same-dated preview *before* its GA.
+ */
+/** Build a comparator from an explicit, authoritative version order (e.g. from `service.yaml`). */
+export declare function comparatorFromOrder(order: readonly string[]): (a: string, b: string) => number;
+/** Heuristic comparator over date-based Azure version strings. */
+export declare function defaultCompareVersions(a: string, b: string): number;
+/** Return the earliest version under the given comparator. */
+export declare function earliestVersion(versions: readonly string[], compare: (a: string, b: string) => number): string | undefined;
+/** Return the latest version under the given comparator. */
+export declare function latestVersion(versions: readonly string[], compare: (a: string, b: string) => number): string | undefined;
+//# sourceMappingURL=version-order.d.ts.map

package/dist/src/migrate/version-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-order.d.ts","sourceRoot":"","sources":["../../../src/migrate/version-order.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAU9F;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GACxC,MAAM,GAAG,SAAS,CAGpB;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GACxC,MAAM,GAAG,SAAS,CAGpB"}

package/dist/src/migrate/version-order.js

@@ -0,0 +1,52 @@
+/**
+ * Version ordering for migration. Azure API versions are date-based (`YYYY-MM-DD`) with an optional
+ * `-preview`/`-beta` suffix. When a `service.yaml` order is available it is authoritative; otherwise
+ * this heuristic sorts by date ascending and places a same-dated preview *before* its GA.
+ */
+/** Build a comparator from an explicit, authoritative version order (e.g. from `service.yaml`). */
+export function comparatorFromOrder(order) {
+    const index = new Map(order.map((version, i) => [version, i]));
+    return (a, b) => {
+        const ia = index.get(a);
+        const ib = index.get(b);
+        if (ia !== undefined && ib !== undefined)
+            return ia - ib;
+        if (ia !== undefined)
+            return -1;
+        if (ib !== undefined)
+            return 1;
+        return defaultCompareVersions(a, b);
+    };
+}
+/** Heuristic comparator over date-based Azure version strings. */
+export function defaultCompareVersions(a, b) {
+    const da = datePart(a);
+    const db = datePart(b);
+    if (da !== db)
+        return da < db ? -1 : 1;
+    const pa = isPreview(a) ? 0 : 1;
+    const pb = isPreview(b) ? 0 : 1;
+    if (pa !== pb)
+        return pa - pb;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** Return the earliest version under the given comparator. */
+export function earliestVersion(versions, compare) {
+    if (versions.length === 0)
+        return undefined;
+    return [...versions].sort(compare)[0];
+}
+/** Return the latest version under the given comparator. */
+export function latestVersion(versions, compare) {
+    if (versions.length === 0)
+        return undefined;
+    return [...versions].sort(compare)[versions.length - 1];
+}
+function datePart(version) {
+    const match = /^\d{4}-\d{2}-\d{2}/.exec(version);
+    return match ? match[0] : version;
+}
+function isPreview(version) {
+    return /-(preview|beta|privatepreview)/i.test(version);
+}
+//# sourceMappingURL=version-order.js.map

package/dist/src/migrate/version-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-order.js","sourceRoot":"","sources":["../../../src/migrate/version-order.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mGAAmG;AACnG,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACd,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QACzD,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC;QAChC,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,sBAAsB,CAAC,CAAS,EAAE,CAAS;IACzD,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,QAA2B,EAC3B,OAAyC;IAEzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,OAAyC;IAEzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe;IAC/B,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,iCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/src/migrate-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=migrate-cli.d.ts.map

package/dist/src/migrate-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-cli.d.ts","sourceRoot":"","sources":["../../src/migrate-cli.ts"],"names":[],"mappings":""}