feat: add labels output

> List of labels that were set based on the provided policy. The output is a stringified JSON array.

README.md

@@ -307,6 +307,21 @@ Token used to set labels
 * requirements: `required`
 * recomended value: `secrets.GITHUB_TOKEN`
 
+## Outputs
+
+### labels
+
+List of labels that were set based on the provided policy. The output is a stringified JSON array.
+
+> [!TIP]
+>
+> Use [`fromJSON`](https://docs.github.com/en/actions/learn-github-actions/expressions#fromjson) function to parse the output to get an array of labels.
+>
+> ```yml
+> # access the first label
+> element: ${{ fromJSON(steps.<step-id>.outputs.labels)[0] }}
+> ```
+
 ## Policy
 
 It's possible to define a labeling policy to further customize the labeling process. The policy can be defined using `.github/advanced-issue-labeler.yml` configuration file. The structure needs to be as follows:

action.yml

@@ -35,6 +35,10 @@ inputs:
     required: true
     description: GitHub token used to set issue labels
 
+outputs:
+  labels:
+    description: Labels that were set on issue. Value is a stringified array.
+
 runs:
   using: node20
   main: dist/index.js

src/action.ts

@@ -1,4 +1,4 @@
-import { getInput, debug, info } from '@actions/core';
+import { getInput, debug, info, setOutput } from '@actions/core';
 import { context } from '@actions/github';
 
 import { Config } from './config';
@@ -41,6 +41,8 @@ async function action(octokit: CustomOctokit) {
     }
   );
 
+  setOutput('labels', JSON.stringify(labels));
+
   debug(`GitHub API response status: [${response.status}]`);
 }