@typespec/spector 0.1.0-alpha.0

package/dist/src/coverage/coverage-tracker.js

@@ -0,0 +1,125 @@
+import { Fail } from "@typespec/spec-api";
+import { logger } from "../logger.js";
+import { writeFileSync } from "fs";
+export class CoverageTracker {
+    coverageFile;
+    scenarios = {};
+    scenariosAndScenariosMetaData = [];
+    hits = new Map();
+    constructor(coverageFile) {
+        this.coverageFile = coverageFile;
+        process.on("exit", () => {
+            logger.info("Saving coverage");
+            this.saveCoverageSync();
+            logger.info("Coverage saved!");
+        });
+    }
+    setScenarios(arg1, arg2) {
+        if (arg1 instanceof Array === false && arg2 !== undefined) {
+            this.scenariosAndScenariosMetaData = [
+                {
+                    scenariosMetadata: arg1,
+                    scenarios: arg2,
+                }
+            ];
+        }
+        else {
+            this.scenariosAndScenariosMetaData = arg1;
+            for (const { scenarios } of this.scenariosAndScenariosMetaData) {
+                this.scenarios = { ...this.scenarios, ...scenarios };
+            }
+        }
+    }
+    async trackEndpointResponse(scenarioName, endpoint, response) {
+        let scenarioHits = this.hits.get(scenarioName);
+        if (scenarioHits === undefined) {
+            scenarioHits = new Map();
+            this.hits.set(scenarioName, scenarioHits);
+        }
+        let responses = scenarioHits.get(endpoint);
+        if (responses === undefined) {
+            responses = [];
+            scenarioHits.set(endpoint, responses);
+        }
+        responses.push(response);
+    }
+    computeCoverage() {
+        const coverageReports = [];
+        for (const { scenarios, scenariosMetadata } of this.scenariosAndScenariosMetaData) {
+            const results = {};
+            for (const [name, mockApi] of Object.entries(scenarios)) {
+                results[name] = this.computeScenarioStatus(name, mockApi);
+            }
+            coverageReports.push({
+                scenariosMetadata: scenariosMetadata,
+                results,
+                createdAt: new Date().toISOString(),
+            });
+        }
+        return coverageReports;
+    }
+    saveCoverageSync() {
+        const coverage = this.computeCoverage();
+        try {
+            writeFileSync(this.coverageFile, JSON.stringify(coverage, null, 2));
+        }
+        catch (e) {
+            logger.warn("Error while saving coverage", e);
+        }
+    }
+    computeScenarioStatus(name, mockApi) {
+        const scenarioHits = this.hits.get(name);
+        switch (mockApi.passCondition) {
+            case "response-success":
+                return checkAll((x) => x.status >= 200 && x.status < 300);
+            case "status-code":
+                return checkAll((x) => x.status === mockApi.code);
+            case "by-key":
+                return checkByKeys(mockApi);
+            default:
+                const _assertNever = mockApi;
+                throw new Error("Unreachable");
+        }
+        function checkAll(condition) {
+            for (const endpoint of mockApi.apis) {
+                const hits = scenarioHits?.get(endpoint.uri);
+                if (hits === undefined) {
+                    return "not-implemented";
+                }
+                if (!condition(hits[hits.length - 1])) {
+                    return "fail";
+                }
+            }
+            return "pass";
+        }
+        function checkByKeys(scenario) {
+            for (const endpoint of scenario.apis) {
+                const hits = scenarioHits?.get(endpoint.uri);
+                if (hits === undefined) {
+                    return "not-implemented";
+                }
+                const keys = new Set(scenario.keys);
+                for (const hit of hits) {
+                    if (!isKeyedMockResponse(hit)) {
+                        continue;
+                    }
+                    if (hit.pass === Fail) {
+                        return "fail";
+                    }
+                    keys.delete(hit.pass);
+                }
+                if (keys.size === 0) {
+                    return "pass";
+                }
+                else {
+                    return "fail";
+                }
+            }
+            return "fail";
+        }
+    }
+}
+function isKeyedMockResponse(response) {
+    return "pass" in response;
+}
+//# sourceMappingURL=coverage-tracker.js.map

package/dist/src/coverage/coverage-tracker.js.map

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

package/dist/src/coverage/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./coverage-report.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/coverage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/coverage/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/src/coverage/index.js

@@ -0,0 +1,2 @@
+export * from "./coverage-report.js";
+//# sourceMappingURL=index.js.map

package/dist/src/coverage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/coverage/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/src/coverage/scenario-manifest.d.ts

@@ -0,0 +1,6 @@
+import { Diagnostic } from "../utils/diagnostic-reporter.js";
+import { ScenarioManifest } from "@typespec/spec-coverage-sdk";
+import type { Scenario } from "../lib/decorators.js";
+export declare function computeScenarioManifest(scenariosPath: string): Promise<[ScenarioManifest | undefined, readonly Diagnostic[]]>;
+export declare function createScenarioManifest(scenariosPath: string, version: string, commit: string, scenarios: Scenario[]): ScenarioManifest;
+//# sourceMappingURL=scenario-manifest.d.ts.map

package/dist/src/coverage/scenario-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-manifest.d.ts","sourceRoot":"","sources":["../../../src/coverage/scenario-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EAAoB,gBAAgB,EAAiB,MAAM,6BAA6B,CAAC;AAGhG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,gBAAgB,GAAG,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC,CAShE;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,QAAQ,EAAE,GACpB,gBAAgB,CAgBlB"}

package/dist/src/coverage/scenario-manifest.js

@@ -0,0 +1,32 @@
+import { loadScenarios } from "../scenarios-resolver.js";
+import { getCommit, getPackageJson } from "../utils/misc-utils.js";
+import { GeneratorMode } from "@typespec/spec-coverage-sdk";
+import { getSourceLocation, normalizePath } from "@typespec/compiler";
+import { relative } from "path";
+export async function computeScenarioManifest(scenariosPath) {
+    const [scenarios, diagnostics] = await loadScenarios(scenariosPath);
+    if (diagnostics.length > 0) {
+        return [undefined, diagnostics];
+    }
+    const commit = getCommit(scenariosPath);
+    const pkg = await getPackageJson(scenariosPath);
+    return [createScenarioManifest(scenariosPath, pkg?.version ?? "?", commit, scenarios), []];
+}
+export function createScenarioManifest(scenariosPath, version, commit, scenarios) {
+    const sortedScenarios = [...scenarios].sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        version,
+        commit,
+        scenarios: sortedScenarios.map(({ name, scenarioDoc, target }) => {
+            const tspLocation = getSourceLocation(target);
+            const location = {
+                path: normalizePath(relative(scenariosPath, tspLocation.file.path)),
+                start: tspLocation.file.getLineAndCharacterOfPosition(tspLocation.pos),
+                end: tspLocation.file.getLineAndCharacterOfPosition(tspLocation.end),
+            };
+            return { name, scenarioDoc, location };
+        }),
+        modes: GeneratorMode,
+    };
+}
+//# sourceMappingURL=scenario-manifest.js.map

package/dist/src/coverage/scenario-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-manifest.js","sourceRoot":"","sources":["../../../src/coverage/scenario-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAsC,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGhC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB;IAErB,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;IACpE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;IAChD,OAAO,CAAC,sBAAsB,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,aAAqB,EACrB,OAAe,EACf,MAAc,EACd,SAAqB;IAErB,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,OAAO;QACL,OAAO;QACP,MAAM;QACN,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;YAC/D,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAqB;gBACjC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,6BAA6B,CAAC,WAAW,CAAC,GAAG,CAAC;gBACtE,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,6BAA6B,CAAC,WAAW,CAAC,GAAG,CAAC;aACrE,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC,CAAC;QACF,KAAK,EAAE,aAAa;KACrB,CAAC;AACJ,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./lib/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,2 @@
+export * from "./lib/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/src/lib/decorators.d.ts

@@ -0,0 +1,24 @@
+import { Interface, Namespace, Operation, Program } from "@typespec/compiler";
+import { HttpVerb } from "@typespec/http";
+import { ScenarioDecorator, ScenarioDocDecorator, ScenarioServiceDecorator } from "../../generated-defs/TypeSpec.Spector.js";
+export declare const $scenario: ScenarioDecorator;
+export declare const $scenarioDoc: ScenarioDocDecorator;
+export declare const $scenarioService: ScenarioServiceDecorator;
+export declare function getScenarioDoc(program: Program, target: Operation | Interface | Namespace): string | undefined;
+export interface Scenario {
+    name: string;
+    scenarioDoc: string;
+    target: Operation | Interface | Namespace;
+    endpoints: ScenarioEndpoint[];
+}
+export interface ScenarioEndpoint {
+    verb: HttpVerb;
+    path: string;
+    target: Operation;
+}
+export declare function listScenarios(program: Program): Scenario[];
+export declare function getScenarioEndpoints(program: Program, target: Namespace | Interface | Operation): ScenarioEndpoint[];
+export declare function listScenarioIn(program: Program, target: Namespace | Interface | Operation): Scenario[];
+export declare function isScenario(program: Program, target: Operation | Interface | Namespace): boolean;
+export declare function getScenarioName(program: Program, target: Operation | Interface | Namespace): string | undefined;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/src/lib/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/lib/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,SAAS,EAGT,SAAS,EACT,SAAS,EACT,OAAO,EACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAML,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,0CAA0C,CAAC;AAGlD,eAAO,MAAM,SAAS,EAAE,iBAEvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,oBAG1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,wBAsB9B,CAAC;AAEF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CAEpB;AAYD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAE1D;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GACxC,gBAAgB,EAAE,CAmBpB;AA+CD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GACxC,QAAQ,EAAE,CAwBZ;AAoBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAE/F;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CAMpB"}

package/dist/src/lib/decorators.js

@@ -0,0 +1,158 @@
+import { $service, getNamespaceFullName, getTypeName, listServices, } from "@typespec/compiler";
+import { $route, $server, getOperationVerb, getRoutePath, getServers, } from "@typespec/http";
+import { $versioned } from "@typespec/versioning";
+import { SpectorStateKeys } from "./lib.js";
+export const $scenario = (context, target, name) => {
+    context.program.stateMap(SpectorStateKeys.Scenario).set(target, name ?? target.name);
+};
+export const $scenarioDoc = (context, target, doc, formatArgs) => {
+    const formattedDoc = formatArgs ? replaceTemplatedStringFromProperties(doc, formatArgs) : doc;
+    context.program.stateMap(SpectorStateKeys.ScenarioDoc).set(target, formattedDoc);
+};
+export const $scenarioService = (context, target, route, options) => {
+    const properties = new Map().set("title", {
+        type: { kind: "String", value: getNamespaceFullName(target).replace(/\./g, "") },
+    });
+    context.program.stateSet(SpectorStateKeys.ScenarioService).add(target);
+    const versions = options ? options.properties.get("versioned")?.type : null;
+    if (versions) {
+        context.call($versioned, target, versions);
+    }
+    context.call($service, target, {
+        kind: "Model",
+        properties,
+        decorators: [],
+        projections: [],
+        name: "Service",
+        derivedModels: [],
+        projectionsByName: [],
+    });
+    context.call($server, target, "http://localhost:3000", "TestServer endpoint");
+    context.call($route, target, route);
+};
+export function getScenarioDoc(program, target) {
+    return program.stateMap(SpectorStateKeys.ScenarioDoc).get(target);
+}
+function replaceTemplatedStringFromProperties(formatString, formatArgs) {
+    return formatString.replace(/{(\w+)}/g, (_, propName) => {
+        const type = formatArgs.properties.get(propName)?.type;
+        if (type === undefined) {
+            return "";
+        }
+        return "value" in type ? String(type.value) : getTypeName(type);
+    });
+}
+export function listScenarios(program) {
+    return listScenarioIn(program, program.getGlobalNamespaceType());
+}
+export function getScenarioEndpoints(program, target) {
+    switch (target.kind) {
+        case "Namespace":
+            return [
+                ...[...target.namespaces.values()].flatMap((x) => getScenarioEndpoints(program, x)),
+                ...[...target.interfaces.values()].flatMap((x) => getScenarioEndpoints(program, x)),
+                ...[...target.operations.values()].flatMap((x) => getScenarioEndpoints(program, x)),
+            ];
+        case "Interface":
+            return [...target.operations.values()].flatMap((x) => getScenarioEndpoints(program, x));
+        case "Operation":
+            return [
+                {
+                    verb: getOperationVerb(program, target) ?? "get",
+                    path: getOperationRoute(program, target),
+                    target,
+                },
+            ];
+    }
+}
+function getRouteSegments(program, target) {
+    const route = getRoutePath(program, target)?.path;
+    const seg = route ? [route] : [];
+    switch (target.kind) {
+        case "Namespace":
+            return target.namespace ? [...getRouteSegments(program, target.namespace), ...seg] : seg;
+        case "Interface":
+            return target.namespace ? [...getRouteSegments(program, target.namespace), ...seg] : seg;
+        case "Operation":
+            return target.interface
+                ? [...getRouteSegments(program, target.interface), ...seg]
+                : target.namespace
+                    ? [...getRouteSegments(program, target.namespace), ...seg]
+                    : seg;
+    }
+}
+function getOperationRoute(program, target) {
+    const template = getRouteSegmentFromServer(program);
+    const segments = getRouteSegments(program, target);
+    return ((template
+        ? template.endsWith("/") || segments.length === 0
+            ? template
+            : template + "/"
+        : "/") + segments.map((x) => (x.startsWith("/") ? x.substring(1) : x)).join("/"));
+}
+function getRouteSegmentFromServer(program) {
+    const serviceNs = listServices(program)[0]?.type;
+    const server = getServers(program, serviceNs);
+    if (server && server.length === 1) {
+        if (server[0].url.indexOf("localhost:3000") > -1) {
+            return server[0].url.split("localhost:3000")[1];
+        }
+        else if (server[0].url.indexOf("{endpoint}") > -1) {
+            return server[0].url.split("{endpoint}")[1];
+        }
+        else {
+            return server[0].url;
+        }
+    }
+    return undefined;
+}
+export function listScenarioIn(program, target) {
+    const scenarioName = getScenarioName(program, target);
+    if (scenarioName) {
+        return [
+            {
+                target,
+                scenarioDoc: getScenarioDoc(program, target), /// `onValidate` validate against this happening
+                name: scenarioName,
+                endpoints: getScenarioEndpoints(program, target),
+            },
+        ];
+    }
+    switch (target.kind) {
+        case "Namespace":
+            return [
+                ...[...target.namespaces.values()].flatMap((x) => listScenarioIn(program, x)),
+                ...[...target.interfaces.values()].flatMap((x) => listScenarioIn(program, x)),
+                ...[...target.operations.values()].flatMap((x) => listScenarioIn(program, x)),
+            ];
+        case "Interface":
+            return [...target.operations.values()].flatMap((x) => listScenarioIn(program, x));
+        case "Operation":
+            return [];
+    }
+}
+function resolveScenarioName(target, name) {
+    const names = [name];
+    let current = target;
+    while (true) {
+        current =
+            current.kind === "Operation" && current.interface ? current.interface : current.namespace;
+        if (current === undefined ||
+            (current.kind === "Namespace" && (current.name === "" || current.name === "_Specs_"))) {
+            break;
+        }
+        names.unshift(current.name);
+    }
+    return names.join("_");
+}
+export function isScenario(program, target) {
+    return program.stateMap(SpectorStateKeys.Scenario).has(target);
+}
+export function getScenarioName(program, target) {
+    const name = program.stateMap(SpectorStateKeys.Scenario).get(target);
+    if (name === undefined) {
+        return undefined;
+    }
+    return resolveScenarioName(target, name);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/src/lib/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../src/lib/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAER,oBAAoB,EACpB,WAAW,EAEX,YAAY,GAKb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,MAAM,EACN,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,UAAU,GAEX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAK,EAAE,EAAE;IACrE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;AACvF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAW,EAAE,EAAE;IACtF,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,oCAAoC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9F,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAQ,EAAE,EAAE;IAC7F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE;QACxC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;KACjF,CAAC,CAAC;IAEH,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAE,OAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAgB,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;QAC7B,IAAI,EAAE,OAAO;QACb,UAAU;QACV,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,SAAS;QACf,aAAa,EAAE,EAAE;QACjB,iBAAiB,EAAE,EAAE;KACf,CAAC,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,qBAAqB,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,MAAyC;IAEzC,OAAO,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,oCAAoC,CAAC,YAAoB,EAAE,UAAiB;IACnF,OAAO,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;QACvD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAeD,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,MAAyC;IAEzC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,WAAW;YACd,OAAO;gBACL,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACnF,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACnF,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;aACpF,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1F,KAAK,WAAW;YACd,OAAO;gBACL;oBACE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK;oBAChD,IAAI,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC;oBACxC,MAAM;iBACP;aACF,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB,EAAE,MAAyC;IACnF,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAClD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3F,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAE3F,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,SAAS;gBACrB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,CAAC;gBAC1D,CAAC,CAAC,MAAM,CAAC,SAAS;oBAChB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,CAAC;oBAC1D,CAAC,CAAC,GAAG,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB,EAAE,MAAiB;IAC5D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,CACL,CAAC,QAAQ;QACP,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC/C,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,GAAG,GAAG;QAClB,CAAC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACnF,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAgB;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACpD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,MAAyC;IAEzC,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL;gBACE,MAAM;gBACN,WAAW,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAE,EAAE,gDAAgD;gBAC/F,IAAI,EAAE,YAAY;gBAClB,SAAS,EAAE,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC;aACjD;SACF,CAAC;IACJ,CAAC;IACD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,WAAW;YACd,OAAO;gBACL,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC7E,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC7E,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;aAC9E,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,KAAK,WAAW;YACd,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAyC,EAAE,IAAY;IAClF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IAErB,IAAI,OAAO,GAAkD,MAAM,CAAC;IACpE,OAAO,IAAI,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC5F,IACE,OAAO,KAAK,SAAS;YACrB,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,EACrF,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,MAAyC;IACpF,OAAO,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,MAAyC;IAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/src/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { $scenario, $scenarioDoc, $scenarioService, Scenario, ScenarioEndpoint, getScenarioDoc, getScenarioEndpoints, getScenarioName, isScenario, listScenarioIn, listScenarios, } from "./decorators.js";
+export { $lib, reportDiagnostic } from "./lib.js";
+export { $onValidate } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/lib/index.js

@@ -0,0 +1,6 @@
+export { $scenario, $scenarioDoc, $scenarioService, getScenarioDoc, getScenarioEndpoints, getScenarioName, isScenario, listScenarioIn, listScenarios, } from "./decorators.js";
+export { $lib, reportDiagnostic } from "./lib.js";
+export { $onValidate } from "./validate.js";
+/** @internal */
+export { $decorators } from "./tsp-index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAGhB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/lib/lib.d.ts

@@ -0,0 +1,33 @@
+export declare const $lib: import("@typespec/compiler").TypeSpecLibrary<{
+    "category-invalid": {
+        readonly default: import("@typespec/compiler").CallableMessage<["category", "allowed"]>;
+    };
+    "missing-scenario": {
+        readonly default: "Operation doesn't belong to a scenario. Use @scenario(name?: string) to mark it as a scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenario";
+    };
+    "missing-scenario-doc": {
+        readonly default: "Operation is missing a scenario doc. Use @scenarioDoc to provide the name of the scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenariodoc";
+    };
+}, Record<string, any>, "Scenario" | "ScenarioDoc" | "ScenarioService">;
+export declare const reportDiagnostic: <C extends "category-invalid" | "missing-scenario" | "missing-scenario-doc", M extends keyof {
+    "category-invalid": {
+        readonly default: import("@typespec/compiler").CallableMessage<["category", "allowed"]>;
+    };
+    "missing-scenario": {
+        readonly default: "Operation doesn't belong to a scenario. Use @scenario(name?: string) to mark it as a scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenario";
+    };
+    "missing-scenario-doc": {
+        readonly default: "Operation is missing a scenario doc. Use @scenarioDoc to provide the name of the scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenariodoc";
+    };
+}[C]>(program: import("@typespec/compiler").Program, diag: import("@typespec/compiler").DiagnosticReport<{
+    "category-invalid": {
+        readonly default: import("@typespec/compiler").CallableMessage<["category", "allowed"]>;
+    };
+    "missing-scenario": {
+        readonly default: "Operation doesn't belong to a scenario. Use @scenario(name?: string) to mark it as a scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenario";
+    };
+    "missing-scenario-doc": {
+        readonly default: "Operation is missing a scenario doc. Use @scenarioDoc to provide the name of the scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenariodoc";
+    };
+}, C, M>) => void, createStateSymbol: (name: string) => symbol, SpectorStateKeys: Record<"Scenario" | "ScenarioDoc" | "ScenarioService", symbol>;
+//# sourceMappingURL=lib.d.ts.map

package/dist/src/lib/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../../src/lib/lib.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI;;;;;;;;;;uEA4Bf,CAAC;AAEH,eAAO,MAAQ,gBAAgB;;;;;;;;;;;;;;;;;;;;mBAAE,iBAAiB,4BAAa,gBAAgB,gEAAS,CAAC"}

package/dist/src/lib/lib.js

@@ -0,0 +1,31 @@
+import { createTypeSpecLibrary, paramMessage } from "@typespec/compiler";
+export const $lib = createTypeSpecLibrary({
+    name: "@typespec/spector",
+    diagnostics: {
+        "category-invalid": {
+            severity: "error",
+            messages: {
+                default: paramMessage `Category "${"category"}" is not one of the allowed category. Use ${"allowed"}. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#category`,
+            },
+        },
+        "missing-scenario": {
+            severity: "warning",
+            messages: {
+                default: `Operation doesn't belong to a scenario. Use @scenario(name?: string) to mark it as a scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenario`,
+            },
+        },
+        "missing-scenario-doc": {
+            severity: "warning",
+            messages: {
+                default: `Operation is missing a scenario doc. Use @scenarioDoc to provide the name of the scenario. See https://github.com/Azure/cadl-ranch/blob/main/docs/decorators.md#scenariodoc`,
+            },
+        },
+    },
+    state: {
+        Scenario: { description: "Mark a scenario to be executed" },
+        ScenarioDoc: { description: "Mark a scenario documentation" },
+        ScenarioService: { description: "Mark a scenario service to be executed" },
+    },
+});
+export const { reportDiagnostic, createStateSymbol, stateKeys: SpectorStateKeys } = $lib;
+//# sourceMappingURL=lib.js.map

package/dist/src/lib/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../../src/lib/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAC;IACxC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;QACX,kBAAkB,EAAE;YAClB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE;gBACR,OAAO,EAAE,YAAY,CAAA,aAAa,UAAU,6CAA6C,SAAS,iFAAiF;aACpL;SACF;QAED,kBAAkB,EAAE;YAClB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE;gBACR,OAAO,EAAE,8KAA8K;aACxL;SACF;QACD,sBAAsB,EAAE;YACtB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE;gBACR,OAAO,EAAE,6KAA6K;aACvL;SACF;KACF;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAC3D,WAAW,EAAE,EAAE,WAAW,EAAE,+BAA+B,EAAE;QAC7D,eAAe,EAAE,EAAE,WAAW,EAAE,wCAAwC,EAAE;KAC3E;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC"}

package/dist/src/lib/tsp-index.d.ts

@@ -0,0 +1,2 @@
+export { $lib } from "./lib.js";
+//# sourceMappingURL=tsp-index.d.ts.map

package/dist/src/lib/tsp-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsp-index.d.ts","sourceRoot":"","sources":["../../../src/lib/tsp-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/lib/tsp-index.js

@@ -0,0 +1,11 @@
+import { $scenario, $scenarioDoc, $scenarioService } from "./decorators.js";
+export { $lib } from "./lib.js";
+/** @internal */
+export const $decorators = {
+    "TypeSpec.Spector": {
+        scenario: $scenario,
+        scenarioDoc: $scenarioDoc,
+        scenarioService: $scenarioService,
+    },
+};
+//# sourceMappingURL=tsp-index.js.map

package/dist/src/lib/tsp-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsp-index.js","sourceRoot":"","sources":["../../../src/lib/tsp-index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB,EAAE;QAClB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,YAAY;QACzB,eAAe,EAAE,gBAAgB;KACE;CACtC,CAAC"}

package/dist/src/lib/validate.d.ts

@@ -0,0 +1,3 @@
+import { Program } from "@typespec/compiler";
+export declare function $onValidate(program: Program): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/src/lib/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/lib/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,OAAO,EACR,MAAM,oBAAoB,CAAC;AAI5B,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,QAyB3C"}

package/dist/src/lib/validate.js

@@ -0,0 +1,41 @@
+import { isDeclaredInNamespace, isTemplateDeclaration, listServices, navigateProgram, } from "@typespec/compiler";
+import { getScenarioDoc, getScenarioName } from "./decorators.js";
+import { reportDiagnostic } from "./lib.js";
+export function $onValidate(program) {
+    const services = listServices(program);
+    navigateProgram(program, {
+        operation: (operation) => {
+            if ((operation.interface && isTemplateDeclaration(operation.interface)) ||
+                isTemplateDeclaration(operation)) {
+                return;
+            }
+            //  If the scenario is not defined in one of the scenario service then we can ignore it.
+            if (!services.some((x) => isDeclaredInNamespace(operation, x.type))) {
+                return;
+            }
+            const scenarioType = checkIsInScenario(program, operation);
+            if (!scenarioType) {
+                reportDiagnostic(program, { code: "missing-scenario", target: operation });
+            }
+            else {
+                const doc = getScenarioDoc(program, scenarioType);
+                if (doc === undefined) {
+                    reportDiagnostic(program, { code: "missing-scenario-doc", target: scenarioType });
+                }
+            }
+        },
+    });
+}
+function checkIsInScenario(program, type) {
+    if (getScenarioName(program, type)) {
+        return type;
+    }
+    if (type.kind === "Operation" && type.interface) {
+        return checkIsInScenario(program, type.interface);
+    }
+    if (type.namespace === undefined) {
+        return undefined;
+    }
+    return checkIsInScenario(program, type.namespace);
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/lib/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/lib/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EAEZ,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,OAAO,EAAE;QACvB,SAAS,EAAE,CAAC,SAAS,EAAE,EAAE;YACvB,IACE,CAAC,SAAS,CAAC,SAAS,IAAI,qBAAqB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACnE,qBAAqB,CAAC,SAAS,CAAC,EAChC,CAAC;gBACD,OAAO;YACT,CAAC;YACD,wFAAwF;YACxF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACpE,OAAO;YACT,CAAC;YACD,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC3D,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,gBAAgB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBAClD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,gBAAgB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;gBACpF,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAgB,EAChB,IAAuC;IAEvC,IAAI,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAChD,OAAO,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AACpD,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,3 @@
+import winston from "winston";
+export declare const logger: winston.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,eAAO,MAAM,MAAM,gBAOjB,CAAC"}

package/dist/src/logger.js

@@ -0,0 +1,10 @@
+import winston from "winston";
+export const logger = winston.createLogger({
+    level: "info",
+    transports: [
+        new winston.transports.Console({
+            format: winston.format.combine(winston.format.colorize(), winston.format.simple()),
+        }),
+    ],
+});
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,MAAM;IACb,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;SACnF,CAAC;KACH;CACF,CAAC,CAAC"}

package/dist/src/routes/admin.d.ts

@@ -0,0 +1,3 @@
+import { Router } from "express";
+export declare const adminRoutes: Router;
+//# sourceMappingURL=admin.d.ts.map