@azure-tools/typespec-azure-resource-manager 0.71.0-dev.10 → 0.71.0-dev.12

package/README.md

@@ -45,6 +45,8 @@ Available ruleSets:
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-key-invalid-chars`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-key-invalid-chars)                       | Arm resource key must contain only alphanumeric characters.                                                                                                                                                                                           |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-name-pattern`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-name-pattern)                                 | The resource name parameter should be defined with a 'pattern' restriction.                                                                                                                                                                           |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-operation-response`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-operation-response)                     | [RPC 008]: PUT, GET, PATCH & LIST must return the same resource schema.                                                                                                                                                                               |
+| [`@azure-tools/typespec-azure-resource-manager/use-api-version`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-api-version)                                                     | Validate ARM Resource operations include the api-version parameter referencing Azure.ResourceManager.CommonTypes.ApiVersionParameter.                                                                                                                 |
+| [`@azure-tools/typespec-azure-resource-manager/use-operation-decorator`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-operation-decorator)                                     | Validate ARM Resource operations use the correct decorator for the HTTP verb.                                                                                                                                                                         |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-path-segment-invalid-chars`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-path-segment-invalid-chars)     | Arm resource name must contain only alphanumeric characters.                                                                                                                                                                                          |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-provisioning-state`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-provisioning-state)                     | Check for properly configured provisioningState property.                                                                                                                                                                                             |
 | [`@azure-tools/typespec-azure-resource-manager/version-progression`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/version-progression)                                             | Validate that ARM service versions all use unique dates and are declared in strictly increasing chronological order.                                                                                                                                  |
@@ -52,7 +54,7 @@ Available ruleSets:
 | [`@azure-tools/typespec-azure-resource-manager/arm-custom-resource-usage-discourage`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-custom-resource-usage-discourage)           | Verify the usage of @customAzureResource decorator.                                                                                                                                                                                                   |
 | [`@azure-tools/typespec-azure-resource-manager/arm-feature-file-usage-discourage`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-feature-file-usage-discourage)                 | Verify the usage of @featureFiles decorator.                                                                                                                                                                                                          |
 | [`@azure-tools/typespec-azure-resource-manager/beyond-nesting-levels`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/beyond-nesting-levels)                                         | Tracked Resources must use 3 or fewer levels of nesting.                                                                                                                                                                                              |
-| [`@azure-tools/typespec-azure-resource-manager/arm-resource-operation`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-operation)                                       | Validate ARM Resource operations.                                                                                                                                                                                                                     |
+| [`@azure-tools/typespec-azure-resource-manager/use-interface`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-interface)                                                         | Validate ARM Resource operations are defined inside an interface declaration.                                                                                                                                                                         |
 | [`@azure-tools/typespec-azure-resource-manager/no-resource-delete-operation`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/no-resource-delete-operation)                           | Check for resources that must have a delete operation.                                                                                                                                                                                                |
 | [`@azure-tools/typespec-azure-resource-manager/empty-updateable-properties`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/empty-updateable-properties)                             | Should have updateable properties.                                                                                                                                                                                                                    |
 | [`@azure-tools/typespec-azure-resource-manager/arm-resource-interface-requires-decorator`](https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-interface-requires-decorator) | Each resource interface must have an @armResourceOperations decorator.                                                                                                                                                                                |

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

@@ -1 +1 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../src/linter.ts"],"names":[],"mappings":"AAyFA,eAAO,MAAM,OAAO,+CAElB,CAAC"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../src/linter.ts"],"names":[],"mappings":"AA6FA,eAAO,MAAM,OAAO,+CAElB,CAAC"}

package/dist/src/linter.js

@@ -23,7 +23,6 @@ import { patchOperationsRule } from "./rules/arm-resource-patch.js";
 import { armResourcePathInvalidCharsRule } from "./rules/arm-resource-path-invalid-chars.js";
 import { armResourceProvisioningStateRule } from "./rules/arm-resource-provisioning-state-rule.js";
 import { beyondNestingRule } from "./rules/beyond-nesting-levels.js";
-import { coreOperationsRule } from "./rules/core-operations.js";
 import { envelopePropertiesRules } from "./rules/envelope-properties.js";
 import { improperSubscriptionListOperationRule } from "./rules/improper-subscription-list-operation.js";
 import { lroLocationHeaderRule } from "./rules/lro-location-header.js";
@@ -39,6 +38,9 @@ import { resourceNameRule } from "./rules/resource-name.js";
 import { retryAfterRule } from "./rules/retry-after.js";
 import { secretProprule } from "./rules/secret-prop.js";
 import { unsupportedTypeRule } from "./rules/unsupported-type.js";
+import { useApiVersionRule } from "./rules/use-api-version.js";
+import { useInterfaceRule } from "./rules/use-interface.js";
+import { useOperationDecoratorRule } from "./rules/use-operation-decorator.js";
 import { useRelationshipRequiredPropertiesRule } from "./rules/use-relationship-required-properties.js";
 import { versionProgressionRule } from "./rules/version-progression.js";
 const rules = [
@@ -59,6 +61,8 @@ const rules = [
     armResourceKeyInvalidCharsRule,
     armResourceNamePatternRule,
     armResourceOperationsRule,
+    useApiVersionRule,
+    useOperationDecoratorRule,
     armResourcePathInvalidCharsRule,
     armResourceProvisioningStateRule,
     versionProgressionRule,
@@ -66,7 +70,7 @@ const rules = [
     armCustomResourceUsageDiscourage,
     armFeatureFileUsageDiscourage,
     beyondNestingRule,
-    coreOperationsRule,
+    useInterfaceRule,
     deleteOperationMissingRule,
     envelopePropertiesRules,
     interfacesRule,

package/dist/src/linter.js.map

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

package/dist/src/rules/use-api-version.d.ts

@@ -0,0 +1,4 @@
+export declare const useApiVersionRule: import("@typespec/compiler").LinterRuleDefinition<"use-api-version", {
+    readonly default: "All Resource operations must use an api-version parameter. Please include Azure.ResourceManager.ApiVersionParameter in the operation parameter list using the spread (...ApiVersionParameter) operator, or using one of the common resource parameter models.";
+}, Record<string, never>>;
+//# sourceMappingURL=use-api-version.d.ts.map

package/dist/src/rules/use-api-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-api-version.d.ts","sourceRoot":"","sources":["../../../src/rules/use-api-version.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB;;yBA4B5B,CAAC"}

package/dist/src/rules/use-api-version.js

@@ -0,0 +1,45 @@
+import { createRule, isTemplateInstance } from "@typespec/compiler";
+import { getNamespaceName, getSourceModel, isTemplatedInterfaceOperation } from "./utils.js";
+export const useApiVersionRule = createRule({
+    name: "use-api-version",
+    severity: "warning",
+    description: "Validate ARM Resource operations include the api-version parameter referencing Azure.ResourceManager.CommonTypes.ApiVersionParameter.",
+    url: "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-api-version",
+    messages: {
+        default: "All Resource operations must use an api-version parameter. Please include Azure.ResourceManager.ApiVersionParameter in the operation parameter list using the spread (...ApiVersionParameter) operator, or using one of the common resource parameter models.",
+    },
+    create(context) {
+        return {
+            operation: (operation) => {
+                if (!isTemplateInstance(operation) && !isTemplatedInterfaceOperation(operation)) {
+                    const parameters = operation.parameters;
+                    if (parameters === undefined ||
+                        parameters === null ||
+                        !hasApiParameter(context.program, parameters)) {
+                        context.reportDiagnostic({
+                            target: operation,
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+function isApiParameter(program, property) {
+    if (property.type.kind !== "Scalar")
+        return false;
+    if (!property.sourceProperty)
+        return false;
+    const sourceModel = getSourceModel(property.sourceProperty);
+    if (sourceModel === undefined)
+        return false;
+    return (sourceModel.name === "ApiVersionParameter" &&
+        getNamespaceName(program, sourceModel) === "Azure.ResourceManager.CommonTypes");
+}
+function hasApiParameter(program, model) {
+    if (model.properties === undefined || model.properties.size === 0)
+        return false;
+    const apiVersionParams = [...model.properties.values()].filter((i) => isApiParameter(program, i));
+    return apiVersionParams !== null && apiVersionParams.length === 1;
+}
+//# sourceMappingURL=use-api-version.js.map

package/dist/src/rules/use-api-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-api-version.js","sourceRoot":"","sources":["../../../src/rules/use-api-version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE7F,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,SAAS;IACnB,WAAW,EACT,uIAAuI;IACzI,GAAG,EAAE,oGAAoG;IACzG,QAAQ,EAAE;QACR,OAAO,EACL,+PAA+P;KAClQ;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,SAAS,EAAE,CAAC,SAAoB,EAAE,EAAE;gBAClC,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,6BAA6B,CAAC,SAAS,CAAC,EAAE,CAAC;oBAChF,MAAM,UAAU,GAAU,SAAS,CAAC,UAAU,CAAC;oBAC/C,IACE,UAAU,KAAK,SAAS;wBACxB,UAAU,KAAK,IAAI;wBACnB,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,EAC7C,CAAC;wBACD,OAAO,CAAC,gBAAgB,CAAC;4BACvB,MAAM,EAAE,SAAS;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,OAAgB,EAAE,QAAuB;IAC/D,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,QAAQ,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,WAAW,GAAsB,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC/E,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,CACL,WAAW,CAAC,IAAI,KAAK,qBAAqB;QAC1C,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,mCAAmC,CAC/E,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB,EAAE,KAAY;IACrD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,MAAM,gBAAgB,GAAoB,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACpF,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAC3B,CAAC;IACF,OAAO,gBAAgB,KAAK,IAAI,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/src/rules/use-interface.d.ts

@@ -0,0 +1,4 @@
+export declare const useInterfaceRule: import("@typespec/compiler").LinterRuleDefinition<"use-interface", {
+    readonly default: "All operations must be inside an interface declaration.";
+}, Record<string, never>>;
+//# sourceMappingURL=use-interface.d.ts.map

package/dist/src/rules/use-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-interface.d.ts","sourceRoot":"","sources":["../../../src/rules/use-interface.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB;;yBA4B3B,CAAC"}

package/dist/src/rules/use-interface.js

@@ -0,0 +1,29 @@
+import { createRule, isTemplateInstance } from "@typespec/compiler";
+import { SyntaxKind } from "@typespec/compiler/ast";
+import { isSourceOperationResourceManagerInternal, isTemplatedInterfaceOperation, } from "./utils.js";
+export const useInterfaceRule = createRule({
+    name: "use-interface",
+    severity: "warning",
+    description: "Validate ARM Resource operations are defined inside an interface declaration.",
+    url: "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-interface",
+    messages: {
+        default: "All operations must be inside an interface declaration.",
+    },
+    create(context) {
+        return {
+            operation: (operation) => {
+                if (!isSourceOperationResourceManagerInternal(operation) &&
+                    !isTemplateInstance(operation)) {
+                    if (!isTemplatedInterfaceOperation(operation) &&
+                        (!operation.node?.parent ||
+                            operation.node.parent.kind !== SyntaxKind.InterfaceStatement)) {
+                        context.reportDiagnostic({
+                            target: operation,
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=use-interface.js.map

package/dist/src/rules/use-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-interface.js","sourceRoot":"","sources":["../../../src/rules/use-interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,wCAAwC,EACxC,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,+EAA+E;IAC5F,GAAG,EAAE,kGAAkG;IACvG,QAAQ,EAAE;QACR,OAAO,EAAE,yDAAyD;KACnE;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,SAAS,EAAE,CAAC,SAAoB,EAAE,EAAE;gBAClC,IACE,CAAC,wCAAwC,CAAC,SAAS,CAAC;oBACpD,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAC9B,CAAC;oBACD,IACE,CAAC,6BAA6B,CAAC,SAAS,CAAC;wBACzC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM;4BACtB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,kBAAkB,CAAC,EAC/D,CAAC;wBACD,OAAO,CAAC,gBAAgB,CAAC;4BACvB,MAAM,EAAE,SAAS;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/src/rules/use-operation-decorator.d.ts

@@ -0,0 +1,5 @@
+export declare const useOperationDecoratorRule: import("@typespec/compiler").LinterRuleDefinition<"use-operation-decorator", {
+    readonly default: import("@typespec/compiler").CallableMessage<["verb", "decorator"]>;
+    readonly invalidOperationType: import("@typespec/compiler").CallableMessage<["verb", "decorator", "operationType"]>;
+}, Record<string, never>>;
+//# sourceMappingURL=use-operation-decorator.d.ts.map

package/dist/src/rules/use-operation-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-operation-decorator.d.ts","sourceRoot":"","sources":["../../../src/rules/use-operation-decorator.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,yBAAyB;;;yBA0DpC,CAAC"}

package/dist/src/rules/use-operation-decorator.js

@@ -0,0 +1,133 @@
+import { createRule, isTemplateInstance, paramMessage } from "@typespec/compiler";
+import { getOperationVerb } from "@typespec/http";
+import { getSegment } from "@typespec/rest";
+import { isSourceOperationResourceManagerInternal, isTemplatedInterfaceOperation, } from "./utils.js";
+export const useOperationDecoratorRule = createRule({
+    name: "use-operation-decorator",
+    severity: "warning",
+    description: "Validate ARM Resource operations use the correct decorator for the HTTP verb.",
+    url: "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/use-operation-decorator",
+    messages: {
+        default: paramMessage `Resource ${"verb"} operation must be decorated with ${"decorator"}.`,
+        invalidOperationType: paramMessage `Resource ${"verb"} operation decorator ${"decorator"} must use operationType ${"operationType"}.`,
+    },
+    create(context) {
+        return {
+            operation: (operation) => {
+                if (!isSourceOperationResourceManagerInternal(operation) &&
+                    !isTemplateInstance(operation)) {
+                    const verb = getOperationVerb(context.program, operation);
+                    if (verb && isTemplatedInterfaceOperation(operation) === false) {
+                        const requiredDecorators = resourceOperationDecorators[verb];
+                        if (requiredDecorators?.length > 0) {
+                            const decorator = operation.decorators.find((d) => requiredDecorators.indexOf(d.decorator.name) >= 0);
+                            if (!decorator && !isArmProviderOperation(context.program, operation)) {
+                                context.reportDiagnostic({
+                                    messageId: "default",
+                                    target: operation,
+                                    format: {
+                                        verb: verb.toUpperCase(),
+                                        decorator: requiredDecorators.map((d) => `@${d.substring(1)}`).join(" or "),
+                                    },
+                                });
+                            }
+                            else if (decorator) {
+                                const allowedOperationTypes = operationTypesByVerb[verb];
+                                const operationType = getGenericDecoratorOperationType(decorator);
+                                if (allowedOperationTypes !== undefined &&
+                                    operationType !== undefined &&
+                                    !allowedOperationTypes.includes(operationType)) {
+                                    context.reportDiagnostic({
+                                        messageId: "invalidOperationType",
+                                        target: operation,
+                                        format: {
+                                            verb: verb.toUpperCase(),
+                                            decorator: `@${decorator.decorator.name.substring(1)}`,
+                                            operationType: allowedOperationTypes.map((x) => `"${x}"`).join(" or "),
+                                        },
+                                    });
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+        };
+    },
+});
+// These private ARM decorators cover all operation types and serve as valid alternatives
+// to the public per-verb decorators (e.g. in extension resource, legacy, and built-in operations).
+const genericArmResourceDecorators = [
+    "$extensionResourceOperation",
+    "$legacyResourceOperation",
+    "$builtInResourceOperation",
+    "$legacyExtensionResourceOperation",
+];
+// operationType argument position per decorator signature:
+// - extensionResourceOperation(targetResourceType, extensionResourceType, operationType, ...)
+// - legacyResourceOperation(resourceType, operationType, ...)
+// - builtInResourceOperation(parentResourceType, builtInResourceType, operationType, ...)
+// - legacyExtensionResourceOperation(resourceType, operationType, ...)
+const operationTypeArgIndexByDecorator = {
+    $extensionResourceOperation: 2,
+    $legacyResourceOperation: 1,
+    $builtInResourceOperation: 2,
+    $legacyExtensionResourceOperation: 1,
+};
+const resourceOperationDecorators = {
+    put: ["$armResourceCreateOrUpdate", ...genericArmResourceDecorators],
+    get: ["$armResourceRead", "$armResourceList", ...genericArmResourceDecorators],
+    patch: ["$armResourceUpdate", ...genericArmResourceDecorators],
+    delete: ["$armResourceDelete", ...genericArmResourceDecorators],
+    post: ["$armResourceAction", "$armResourceCollectionAction", ...genericArmResourceDecorators],
+    head: [],
+};
+// ARM operationType conventions:
+// - PUT => createOrUpdate
+// - GET => read or list
+// - PATCH => update
+// - DELETE => delete
+// - POST => action
+// This map is used only for generic private decorators that encode operation type as an argument.
+const operationTypesByVerb = {
+    put: ["createOrUpdate"],
+    get: ["read", "list"],
+    patch: ["update"],
+    delete: ["delete"],
+    post: ["action"],
+};
+function isGenericArmResourceDecorator(name) {
+    return genericArmResourceDecorators.includes(name);
+}
+function getGenericDecoratorOperationType(decorator) {
+    const decoratorName = decorator.decorator.name;
+    if (!isGenericArmResourceDecorator(decoratorName)) {
+        return undefined;
+    }
+    const operationTypeArg = decorator.args[operationTypeArgIndexByDecorator[decoratorName]];
+    return getDecoratorArgumentStringValue(operationTypeArg);
+}
+function getDecoratorArgumentStringValue(arg) {
+    return typeof arg?.jsValue === "string" ? arg.jsValue : undefined;
+}
+function isStaticSegment(segment) {
+    return segment === undefined || segment === "locations";
+}
+function isArmProviderOperation(program, operation) {
+    let isProviderAction = false;
+    for (const [index, [, property]] of [...operation.parameters.properties].entries()) {
+        const segment = getSegment(program, property);
+        if (segment === "providers") {
+            isProviderAction = true;
+        }
+        else if (isProviderAction && !isStaticSegment(segment)) {
+            return false;
+        }
+        const isLastSegment = index === operation.parameters.properties.size - 1;
+        if (isLastSegment && !segment) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=use-operation-decorator.js.map

package/dist/src/rules/use-operation-decorator.js.map

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

package/lib/common-types/billing-data.tsp

@@ -0,0 +1,211 @@
+using Azure.Core;
+using Versioning;
+
+namespace Azure.ResourceManager.CommonTypes;
+
+/**
+ * Billing Data
+ */
+@added(Versions.v6)
+model BillingData {
+  /**
+   * The system ID of the resource. Globally unique per cloud.
+   */
+  @visibility(Lifecycle.Read)
+  systemId?: uuid;
+
+  /**
+   * Indicates the billing state of the resource.
+   */
+  @visibility(Lifecycle.Read)
+  state?: BillingState = BillingState.Pending;
+
+  /**
+   * Indicates reason(s) for the current billing state of the resource.
+   */
+  @visibility(Lifecycle.Read)
+  reasons?: BillingStateReason[];
+
+  /**
+   * The product identifier referencing a product in the catalog.
+   */
+  productCode: uuid;
+
+  /**
+   * Product token (JWT) identifying a specific version of the product.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  productToken?: string;
+
+  /**
+   * The number of instances of the product.
+   */
+  quantity: int64 = 1;
+
+  /**
+   * Start date indicating the beginning of the term for which the resource is committed.
+   */
+  startDate?: utcDateTime;
+
+  /**
+   * End date indicating the end of the term for which the resource is committed.
+   */
+  endDate?: utcDateTime;
+
+  /**
+   * Billing token (JWT) representing additional billing context.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  billingToken?: string;
+
+  /**
+   * The resource's billing schedule.
+   */
+  schedule?: BillingSchedule;
+}
+
+/**
+ * Billing schedule.
+ */
+@added(Versions.v6)
+model BillingSchedule {
+  /**
+   * Indicates the renewal behavior of this resource.
+   */
+  renewal: BillingRenewalType = BillingRenewalType.Automatic;
+
+  /**
+   * Schedules billing changes for this resource.
+   */
+  changes?: BillingScheduleChange[];
+}
+
+/**
+ * Billing schedule change.
+ */
+@added(Versions.v6)
+model BillingScheduleChange {
+  /**
+   * Indicates when the change is expected to become effective.
+   */
+  effective: BillingScheduleChangeEffectiveType = BillingScheduleChangeEffectiveType.Renewal;
+
+  /**
+   * The absolute date when the change is expected to become effective. Required when `effective` = `AbsoluteDate`.
+   */
+  effectiveDate?: utcDateTime;
+
+  /**
+   * The kind of change.
+   */
+  kind: BillingScheduleChangeKind = BillingScheduleChangeKind.Update;
+
+  /**
+   * The new product identifier. When not specified, the resource's product code remains unchanged.
+   */
+  productCode?: uuid;
+
+  /**
+   * Product token (JWT) identifying a specific version of the scheduled product. Can only be
+   * specified when productCode is specified also.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  productToken?: string;
+
+  /**
+   * The new number of instances of the product. When not specified, the resource's quantity remains unchanged.
+   */
+  quantity?: int64;
+
+  /**
+   * The new (coterminous) end date of the product. Can only be specified when effective = renewal.
+   * When not specified, the resource's end date is calculated based on the renewal date and the
+   * product's term duration.
+   */
+  endDate?: utcDateTime;
+
+  /**
+   * Billing token (JWT) representing additional billing context.
+   */
+  @visibility(Lifecycle.Create, Lifecycle.Update)
+  billingToken?: string;
+}
+
+/**
+ * Billing state.
+ */
+@added(Versions.v6)
+union BillingState {
+  /** Resource's billing has not yet started. */
+  Pending: "Pending",
+
+  /** Resource's billing is activate. */
+  Active: "Active",
+
+  /** Resource's billing is in a warning state. */
+  Warned: "Warned",
+
+  /** Resource's billing is inactive. */
+  Inactive: "Inactive",
+
+  string,
+}
+
+/**
+ * Billing state reason.
+ */
+@added(Versions.v6)
+union BillingStateReason {
+  /** Resource's billing has been suspended by Microsoft. */
+  Suspended: "Suspended",
+
+  /** Resource has been canceled by the customer. */
+  Canceled: "Canceled",
+
+  /** Resource's billing has expired. */
+  Expired: "Expired",
+
+  string,
+}
+
+/**
+ * Type of renewal.
+ */
+@added(Versions.v6)
+union BillingRenewalType {
+  /** Automatically renew the product when its term ends. */
+  Automatic: "Automatic",
+
+  /** Don't automatically renew the product. */
+  None: "None",
+
+  string,
+}
+
+/**
+ * When a scheduled change is expected to become effective.
+ */
+@added(Versions.v6)
+union BillingScheduleChangeEffectiveType {
+  /** At a specified date. */
+  AbsoluteDate: "AbsoluteDate",
+
+  /** At time of term renewal. */
+  Renewal: "Renewal",
+
+  string,
+}
+
+/**
+ * Type of scheduled change.
+ */
+@added(Versions.v6)
+union BillingScheduleChangeKind {
+  /** Update the resource. */
+  Update: "Update",
+
+  /** Cancel the resource. */
+  Cancel: "Cancel",
+
+  string,
+}

package/lib/common-types/common-types.tsp

@@ -12,5 +12,5 @@ import "./versions.tsp";
 import "./mobo-ref.tsp";
 import "./network-security-perimeter-ref.tsp";
 import "./nsp-operations.tsp";
-
+import "./billing-data.tsp";
 namespace Azure.ResourceManager.CommonTypes;

package/lib/models.tsp

@@ -452,4 +452,21 @@ model AvailabilityZonesProperty {
   zones?: string[];
 }
 
+/**
+ * Standard resource billing data property to represent the resource's current billing state.
+ * Spread this model directly into your resource property model when modeling e.g. prepaid resources.
+ *
+ * @example
+ *
+ * ```typespec
+ * model FooProperties {
+ *   ...BillingDataProperty,
+ * }
+ * ```
+ */
+model BillingDataProperty {
+  /** The billing data of the resource. */
+  billingData: CommonTypes.BillingData;
+}
+
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-resource-manager",
-  "version": "0.71.0-dev.10",
+  "version": "0.71.0-dev.12",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",
@@ -47,15 +47,15 @@
     "pluralize": "^8.0.0"
   },
   "peerDependencies": {
-    "@azure-tools/typespec-azure-core": "^0.70.0 || >= 0.71.0-dev.3",
-    "@typespec/compiler": "^1.14.0",
+    "@azure-tools/typespec-azure-core": "^0.70.0 || >= 0.71.0-dev.4",
     "@typespec/http": "^1.14.0",
+    "@typespec/compiler": "^1.14.0",
     "@typespec/rest": "^0.84.0",
-    "@typespec/versioning": "^0.84.0",
-    "@typespec/openapi": "^1.14.0"
+    "@typespec/openapi": "^1.14.0",
+    "@typespec/versioning": "^0.84.0"
   },
   "devDependencies": {
-    "@azure-tools/typespec-azure-core": "^0.70.0 || >= 0.71.0-dev.3",
+    "@azure-tools/typespec-azure-core": "^0.70.0 || >= 0.71.0-dev.4",
     "@types/node": "^26.0.0",
     "@types/pluralize": "^0.0.33",
     "@vitest/coverage-v8": "^4.1.3",
@@ -63,10 +63,10 @@
     "rimraf": "^6.1.3",
     "typescript": "~6.0.2",
     "vitest": "^4.1.3",
-    "@typespec/rest": "^0.84.0",
-    "@typespec/versioning": "^0.84.0",
     "@typespec/compiler": "^1.14.0",
     "@typespec/library-linter": "^0.84.0",
+    "@typespec/rest": "^0.84.0",
+    "@typespec/versioning": "^0.84.0",
     "@typespec/tspd": "^0.76.0",
     "@typespec/http": "^1.14.0",
     "@typespec/openapi": "^1.14.0"

package/dist/src/rules/core-operations.d.ts

@@ -1,6 +0,0 @@
-export declare const coreOperationsRule: import("@typespec/compiler").LinterRuleDefinition<"arm-resource-operation", {
-    readonly default: "All Resource operations must use an api-version parameter. Please include Azure.ResourceManager.ApiVersionParameter in the operation parameter list using the spread (...ApiVersionParameter) operator, or using one of the common resource parameter models.";
-    readonly opOutsideInterface: "All operations must be inside an interface declaration.";
-    readonly opMissingDecorator: import("@typespec/compiler").CallableMessage<["verb", "decorator"]>;
-}, Record<string, never>>;
-//# sourceMappingURL=core-operations.d.ts.map

package/dist/src/rules/core-operations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core-operations.d.ts","sourceRoot":"","sources":["../../../src/rules/core-operations.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,kBAAkB;;;;yBA8D7B,CAAC"}

package/dist/src/rules/core-operations.js

@@ -1,105 +0,0 @@
-import { createRule, fileRef, isTemplateInstance, paramMessage, } from "@typespec/compiler";
-import { SyntaxKind } from "@typespec/compiler/ast";
-import { getOperationVerb } from "@typespec/http";
-import { getSegment } from "@typespec/rest";
-import { getNamespaceName, getSourceModel, isSourceOperationResourceManagerInternal, isTemplatedInterfaceOperation, } from "./utils.js";
-export const coreOperationsRule = createRule({
-    name: "arm-resource-operation",
-    docs: fileRef.fromPackageRoot("src/rules/arm-resource-operation.md"),
-    severity: "warning",
-    description: "Validate ARM Resource operations.",
-    url: "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-resource-operation",
-    messages: {
-        default: "All Resource operations must use an api-version parameter. Please include Azure.ResourceManager.ApiVersionParameter in the operation parameter list using the spread (...ApiVersionParameter) operator, or using one of the common resource parameter models.",
-        opOutsideInterface: "All operations must be inside an interface declaration.",
-        opMissingDecorator: paramMessage `Resource ${"verb"} operation must be decorated with ${"decorator"}.`,
-    },
-    create(context) {
-        return {
-            operation: (operation) => {
-                if (!isSourceOperationResourceManagerInternal(operation) &&
-                    !isTemplateInstance(operation)) {
-                    const verb = getOperationVerb(context.program, operation);
-                    if (!isTemplatedInterfaceOperation(operation) &&
-                        (!operation.node?.parent ||
-                            operation.node.parent.kind !== SyntaxKind.InterfaceStatement)) {
-                        context.reportDiagnostic({
-                            messageId: "opOutsideInterface",
-                            target: operation,
-                        });
-                    }
-                    const parameters = operation.parameters;
-                    if (parameters === undefined ||
-                        parameters === null ||
-                        !hasApiParameter(context.program, parameters)) {
-                        context.reportDiagnostic({
-                            target: operation,
-                        });
-                    }
-                    if (verb) {
-                        const requiredDecorators = resourceOperationDecorators[verb];
-                        if (requiredDecorators?.length > 0) {
-                            const decorator = operation.decorators.find((d) => requiredDecorators.indexOf(d.decorator.name) >= 0);
-                            if (!decorator && !isArmProviderOperation(context.program, operation)) {
-                                context.reportDiagnostic({
-                                    messageId: "opMissingDecorator",
-                                    target: operation,
-                                    format: {
-                                        verb: verb.toUpperCase(),
-                                        decorator: requiredDecorators.map((d) => `@${d.substring(1)}`).join(" or "),
-                                    },
-                                });
-                            }
-                        }
-                    }
-                }
-            },
-        };
-    },
-});
-const resourceOperationDecorators = {
-    put: ["$armResourceCreateOrUpdate"],
-    get: ["$armResourceRead", "$armResourceList"],
-    patch: ["$armResourceUpdate"],
-    delete: ["$armResourceDelete"],
-    post: ["$armResourceAction", "$armResourceCollectionAction"],
-    head: [],
-};
-function isApiParameter(program, property) {
-    if (property.type.kind !== "Scalar")
-        return false;
-    if (!property.sourceProperty)
-        return false;
-    const sourceModel = getSourceModel(property.sourceProperty);
-    if (sourceModel === undefined)
-        return false;
-    return (sourceModel.name === "ApiVersionParameter" &&
-        getNamespaceName(program, sourceModel) === "Azure.ResourceManager.CommonTypes");
-}
-function hasApiParameter(program, model) {
-    if (model.properties === undefined || model.properties.size === 0)
-        return false;
-    const apiVersionParams = [...model.properties.values()].filter((i) => isApiParameter(program, i));
-    return apiVersionParams !== null && apiVersionParams.length === 1;
-}
-function isStaticSegment(segment, property) {
-    return segment === undefined || segment === "locations";
-}
-function isArmProviderOperation(program, operation) {
-    let isProviderAction = false;
-    for (const [index, [, property]] of [...operation.parameters.properties].entries()) {
-        const segment = getSegment(program, property);
-        if (segment === "providers") {
-            isProviderAction = true;
-        }
-        else if (isProviderAction && !isStaticSegment(segment, property)) {
-            return false;
-        }
-        const isLastSegment = index === operation.parameters.properties.size - 1;
-        if (isLastSegment && !segment) {
-            return true;
-        }
-    }
-    return false;
-}
-//# sourceMappingURL=core-operations.js.map

package/dist/src/rules/core-operations.js.map

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