scratch-l10n 6.1.93 → 6.1.95

package/locales/interface-msgs.js

@@ -20565,14 +20565,14 @@ export default {
     "gui.unsupportedBrowser.back": "Հետ գնալ",
     "gui.unsupportedBrowser.previewfaq": "Ավելին իմանալու համար այցելեք <a>{previewFaqLink}</a>։",
     "gui.unsupportedBrowser.previewfaqlinktext": "ՀՏՀ",
-    "gui.cards.tutorialsIcon": "Tutorials icon",
-    "gui.cards.shrinkIcon": "Shrink icon",
-    "gui.cards.expandIcon": "Expand icon",
-    "gui.cards.closeIcon": "Close icon",
-    "gui.cards.leftArrowIcon": "Left arrow icon",
-    "gui.cards.rightArrowIcon": "Right arrow icon",
-    "gui.cards.previousStepButton": "Previous step",
-    "gui.cards.nextStepButton": "Next step",
+    "gui.cards.tutorialsIcon": "Ուսուցողական նյութերի մանրապատկեր",
+    "gui.cards.shrinkIcon": "Փոքրացնել մանրապատկերը",
+    "gui.cards.expandIcon": "Մեծացնել մանրապատկերը",
+    "gui.cards.closeIcon": "Փակել մանրապատկերը",
+    "gui.cards.leftArrowIcon": "Ձախ սլաքի պատկերը",
+    "gui.cards.rightArrowIcon": "Աջ սլաքի պատկերը",
+    "gui.cards.previousStepButton": "Նախորդ քայլը",
+    "gui.cards.nextStepButton": "Հաջորդ քայլը",
     "gui.cards.all-tutorials": "Ձեռնարկներ",
     "gui.cards.shrink": "Փոքրացնել",
     "gui.cards.expand": "Ընդլայնել",
@@ -20582,8 +20582,8 @@ export default {
     "gui.comingSoon.message1": "Մի անհանգստացեք, մենք աշխատում ենք դրա վրա {emoji}",
     "gui.comingSoon.message2": "Շուտով...",
     "gui.comingSoon.message3": "Մենք աշխատում ենք դրա վրա {emoji}",
-    "gui.confirmationPrompt.confirm": "yes",
-    "gui.confirmationPrompt.cancel": "no",
+    "gui.confirmationPrompt.confirm": "այո",
+    "gui.confirmationPrompt.cancel": "ոչ",
     "gui.connection.auto-scanning.prescan": "Մոտեցրեք սարքը և սկսեք որոնումը:",
     "gui.connection.auto-scanning.scanBeginMessage": "Սեղմեք սարքի վրայի կոճակը։",
     "gui.connection.auto-scanning.noPeripheralsFound": "Ոչ մի սարք չի գտնվել",
@@ -20633,8 +20633,8 @@ export default {
     "gui.customProcedures.cancel": "Չեղարկել",
     "gui.customProcedures.ok": "Լավ",
     "gui.debugModal.title": "Վրիպազերծում | Լուծել խնդիրները",
-    "gui.debugModal.previous": "Previous",
-    "gui.debugModal.next": "Next",
+    "gui.debugModal.previous": "Նախորդը",
+    "gui.debugModal.next": "Հաջորդը",
     "gui.debugModal.readAloud.title": "Բարձրաձայն կարդալ",
     "gui.debugModal.readAloud.description1": "Կոդը բարձրաձայն կարդալիս մտածեք համակարգչի տեսանկյունից։",
     "gui.debugModal.readAloud.description2": "Արդյո՞ք ներառում եք քայլեր, որոնք իրականում չկան։",
@@ -20660,67 +20660,67 @@ export default {
     "gui.debugModal.tinkerWithBlockOrder.description5": "Փորձեք մասնիկներն օգտագործել ցիկլի կամ պայմանական հրահանգի ներսում՝ դրանք ցիկլից կամ պայմանական հրահանգից դուրս օգտագործելու փոխարեն։",
     "gui.debugModal.toLoopOrNot.title": "Կիրառե՞լ ցիկլ, թե՞ ոչ",
     "gui.debugModal.toLoopOrNot.description1": "Եթե օգտագործում եք «Կառավարում» բաժնի այնպիսի մասնիկներ, ինչպիսիք են «անվերջ» և «կրկնել», ստուգեք՝ արդյո՞ք ցիկլի ներսում գտնվող բոլոր մասնիկները պետք է այնտեղ լինեն, կամ արդյո՞ք որևէ մասնիկ (օրինակ՝ «սպասել») բացակայում է՝ գործողությունը վերակայելու կամ ժամանակը կարգավորելու համար։ Ցանկանո՞ւմ եք, որ ձեր ցիկլն անվերջ գործարկվի, թե՞ որոշակի քանակով։ Արդյո՞ք որևէ բան պետք է դադարեցնի ցիկլը։",
-    "gui.debugModal.toLoopOrNot.description2": "Perhaps you aren't using a loop when you should be? For instance, if you are using a conditional statement block like \"if then,\" does the program only need to check if it is true or false once? Or does it need to check continuously, in which case, you would want to place your conditional statement inside a forever loop?",
-    "gui.debugModal.timingAndParallelism.title": "Think About Timing & Parallelism",
-    "gui.debugModal.timingAndParallelism.sectionTitle": "Timing & Parallelism",
-    "gui.debugModal.timingAndParallelism.description1": "Do you have multiple events trying to run at the same time? If two sequences are programmed to start at the same time, you can get unpredictable behavior.",
-    "gui.debugModal.timingAndParallelism.description2": "Add small waits, broadcasts, or user interaction (like clicking or pressing a key) to see if this affects the result.",
-    "gui.debugModal.thinkAboutBlockOptions.title": "Think About Block Options",
+    "gui.debugModal.toLoopOrNot.description2": "Հնարավոր է, որ ցիկլ չես օգտագործում այն դեպքում, երբ պետք է։ Օրինակ՝ եթե օգտագործում ես «եթե, ապա» պայմանի մասնիկն, արդյո՞ք ծրագիրը պետք է միայն մեկ անգամ ստուգի՝ պայմանը ճիշտ է, թե սխալ։ Թե՞ այն պետք է անընդհատ ստուգի, որի դեպքում պայմանի մասնիկը պետք է տեղադրել «անվերջ» ցիկլի ներսում։",
+    "gui.debugModal.timingAndParallelism.title": "Մտածիր գործողությունների ժամանակի և զուգահեռ կատարման մասին",
+    "gui.debugModal.timingAndParallelism.sectionTitle": "Ժամանակ և զուգահեռ կատարում",
+    "gui.debugModal.timingAndParallelism.description1": "Ունե՞ս մի քանի իրադարձություններ, որոնք պետք է կատարվեն միաժամանակ։ Եթե երկու գործողությունների հաջորդականություն ծրագրավորված է միաժամանակ սկսվելու համար, կարող ես ծրագրային անկանխատեսելի դրսևորում ստանալ։",
+    "gui.debugModal.timingAndParallelism.description2": "Ավելացրու կարճ դադարներ, հաղորդագրություններ կամ օգտագործողի գործողություններ (օրինակ՝ սեղմում կամ ստեղնի հպում)՝ տեսնելու համար, թե արդյոք դրանք ազդում են արդյունքի վրա։",
+    "gui.debugModal.thinkAboutBlockOptions.title": "Մտածիր մասնիկի տարբերակների մասին",
     "gui.debugModal.thinkAboutBlockOptions.description1": "Is there a similar but different block you can use?",
-    "gui.debugModal.thinkAboutBlockOptions.description2": "Some blocks look similar but can behave differently, such as “set” vs “change” or “play until done” vs “start.”",
-    "gui.debugModal.thinkAboutBlockOptions.description3": "Try using a similar block in place of what you have, and see if this affects the result.",
-    "gui.debugModal.checkTheValues.title": "Check the Values",
-    "gui.debugModal.checkTheValues.description1": "If you are using variables or reporter blocks, check the value at the moment the code sequence is run.",
-    "gui.debugModal.checkTheValues.description2": "Do/should all the sprites control a variable, or should only one sprite have control?",
-    "gui.debugModal.checkTheValues.description3": "Where is the value reset? Where is it changed?",
-    "gui.debugModal.checkCodeSequence.title": "Check Code Sequence",
-    "gui.debugModal.checkCodeSequence.description1": "Check that your code sequence is attached to the correct sprite or the backdrop, if appropriate.",
-    "gui.debugModal.checkCodeSequence.description2": "If you need to move your code to another sprite, click and drag it until you are hovering over the correct sprite. Release it once the sprite wiggles.",
-    "gui.debugModal.checkCodeSequence.description3": "You can also use your Backpack (bottom of screen) to store and move your code or assets.",
-    "gui.debugModal.commentYourCode.title": "Comment Your Code",
-    "gui.debugModal.commentYourCode.description1": "Adding comments to your code can help others looking at your code to understand it. It can also help you remember how your code works when you come back to it later.",
-    "gui.debugModal.commentYourCode.description2": "Right click on script area to “Add Comment.” Use everyday language to explain what a block, or small sequence of blocks, does.",
-    "gui.debugModal.takeABreak.title": "Take a Break, Step Away",
-    "gui.debugModal.takeABreak.description1": "Sometimes, spending too much time focused on an issue can be counterproductive and frustrating.",
-    "gui.debugModal.takeABreak.description2": "Take a break and step away from the screen to clear your mind. After some rest, focusing on something else, or getting some water, you can approach the problem with fresh eyes.",
-    "gui.debugModal.askForHelp.title": "Ask for Help",
-    "gui.debugModal.askForHelp.description1": "If you are still stuck, you can ask for help from a peer. Try finding a debugging/help studio and share your project, asking for help in a comment or the project notes.",
-    "gui.debugModal.askForHelp.description2": "Ask one to three people to try your code, as different people may have different perspectives or solutions!",
-    "gui.gui.shouldDeleteSprite": "Are you sure you want to delete this sprite?",
-    "gui.gui.shouldDeleteCostume": "Are you sure you want to delete this costume?",
-    "gui.gui.shouldDeleteSound": "Are you sure you want to delete this sound?",
-    "gui.gui.deleteAssetHeading": "Confirm Asset Deletion",
+    "gui.debugModal.thinkAboutBlockOptions.description2": "Որոշ մասնիկներ նման են իրար, բայց կարող են տարբեր կերպ գործել, օրինակ՝ «սահմանել» և «փոխել», կամ «արտաբերել մինչև ավարտը» և «արտաբերել»։",
+    "gui.debugModal.thinkAboutBlockOptions.description3": "Փորձիր քո օգտագործած մասնիկի փոխարեն կիրառել մեկ այլ նմանատիպ մասնիկ և տես՝ արդյոք դա ազդում է արդյունքի վրա։",
+    "gui.debugModal.checkTheValues.title": "Ստուգիր արժեքները",
+    "gui.debugModal.checkTheValues.description1": "Եթե օգտագործում ես փոփոխականներ կամ արժեք վերադարձնող մասնիկներ, ստուգիր դրանց արժեքը կոդի հաջորդականության կատարման պահին։",
+    "gui.debugModal.checkTheValues.description2": "Արդյո՞ք բոլոր կերպարները պետք է կառավարեն փոփոխականը, թե՞ այն պետք է կառավարի միայն մեկ կերպար։",
+    "gui.debugModal.checkTheValues.description3": "Որտե՞ղ է արժեքը վերակայվում։ Որտե՞ղ է այն փոխվում։",
+    "gui.debugModal.checkCodeSequence.title": "Ստուգիր կոդի հաջորդականությունը",
+    "gui.debugModal.checkCodeSequence.description1": "Անհրաժեշտության դեպքում ստուգիր, արդյո՞ք սցենարը կցված է ճիշտ կերպարին կամ ետնապատկերին։",
+    "gui.debugModal.checkCodeSequence.description2": "Եթե պետք է կոդը տեղափոխիր մեկ այլ կերպարի վրա․ սեղմիր ու քաշիր այն դեպի համապատասխան կերպարը։ Բաց թող այն, երբ կերպարը սկսի շարժվել։",
+    "gui.debugModal.checkCodeSequence.description3": "Կարող ես նաև օգտագործել քո Ուսապարկը (էկրանի ներքևում)՝ կոդը կամ այլ նյութերը պահելու և տեղափոխելու համար։",
+    "gui.debugModal.commentYourCode.title": "Մեկնաբանություն թող սցենարի մասին",
+    "gui.debugModal.commentYourCode.description1": "Կոդում մեկնաբանություններ ավելացնելը կարող է օգնել ուրիշներին հասկանալ քո կոդը։ Այն նաև կօգնի քեզ հիշել, թե ինչպես է աշխատում կոդդ, երբ հետագայում կրկին վերադառնաս դրան։",
+    "gui.debugModal.commentYourCode.description2": "Աջ սեղմում արա սցենարների տարածքում և ընտրիր «Ավելացնել մեկնաբանություն»։ Առօրյա լեզվով բացատրիր, թե ինչ է անում որևէ բլոմասնիկկ կամ մասնիկների փոքր հաջորդականություն։",
+    "gui.debugModal.takeABreak.title": "Ընդմիջում արա և մի փոքր հեռացիր",
+    "gui.debugModal.takeABreak.description1": "Երբեմն որևէ խնդրի վրա չափազանց երկար կենտրոնանալը կարող է հակառակ ազդեցությունն ունենալ և հիասթափություն առաջացնել։",
+    "gui.debugModal.takeABreak.description2": "Ընդմիջում արա և մի փոքր հեռացիր էկրանից՝ միտքդ թարմացնելու համար։ Որոշ ժամանակ հանգստանալուց, մեկ այլ բանով զբաղվելուց կամ մի փոքր ջուր խմելուց հետո կարող ես թարմ հայացքով վերադառնալ խնդրին։",
+    "gui.debugModal.askForHelp.title": "Օգնություն խնդրիր",
+    "gui.debugModal.askForHelp.description1": "Եթե դեռ չես կարողանում լուծել խնդիրը, կարող ես օգնություն խնդրել մեկ ուրիշից։ Փորձիր գտնել վրիպազերծման կամ օգնության ստուդիա և կիսվել քո նախագծով՝ օգնություն խնդրելով մեկնաբանության կամ նախագծի նշումների միջոցով։",
+    "gui.debugModal.askForHelp.description2": "Խնդրիր մինչև երեք հոգու փորձարկել քո կոդը, քանի որ տարբեր մարդիկ կարող են տարբեր տեսանկյուններ կամ լուծումներ առաջարկել։",
+    "gui.gui.shouldDeleteSprite": "Վստա՞հ ես, որ ցանկանում ես ջնջել այս կերպարը։",
+    "gui.gui.shouldDeleteCostume": "Վստա՞հ ես, որ ցանկանում ես ջնջել այս զգեստը։",
+    "gui.gui.shouldDeleteSound": "Վստա՞հ ես, որ ցանկանում ես ջնջել այս ձայնը։",
+    "gui.gui.deleteAssetHeading": "Հաստատել նյութի ջնջումը",
     "gui.SpriteInfo.direction": "Ուղղություն",
     "gui.directionPicker.rotationStyles.allAround": "Շուրջ բոլորը",
     "gui.directionPicker.rotationStyles.leftRight": "Ձախ/Աջ",
     "gui.directionPicker.rotationStyles.dontRotate": "Չպտտել",
     "gui.gui.addExtension": "Ավելացնել ընդլայնում",
-    "gui.aria.menuBar": "Menu topbar",
+    "gui.aria.menuBar": "Վերին ընտրացանկի գոտի",
     "gui.aria.editor": "Խմբագրիչ",
-    "gui.aria.tabList": "Tab list",
-    "gui.aria.codePanel": "Code editor panel",
-    "gui.aria.costumesPanel": "Costumes editor panel",
-    "gui.aria.backdropsPanel": "Backdrops editor panel",
-    "gui.aria.soundsPanel": "Sounds editor panel",
+    "gui.aria.tabList": "Ներդիրների ցանկ",
+    "gui.aria.codePanel": "Այլագրի խմբագրման վահանակ",
+    "gui.aria.costumesPanel": "Զգեստի խմբագրման վահանակ",
+    "gui.aria.backdropsPanel": "Ետնապատկերի խմբագրման վահանակ",
+    "gui.aria.soundsPanel": "Ձայնի խմբագրման վահանակ",
     "gui.aria.backpack": "Ուսապարկ",
-    "gui.aria.stageAndTarget": "Stage and target",
+    "gui.aria.stageAndTarget": "Բեմ և թիրախ",
     "gui.aria.stage": "Բեմ",
-    "gui.aria.targetPane": "Target pane",
+    "gui.aria.targetPane": "Թիրախային վահանակի մատչելիության պիտակ",
     "gui.gui.codeTab": "Սցենարներ",
     "gui.gui.backdropsTab": "Ետնապատկեր",
     "gui.gui.costumesTab": "Զգեստներ",
     "gui.gui.soundsTab": "Ձայն",
-    "gui.libraryItem.memberAssetImgAlt": "Blue star icon indicating an asset is for members",
+    "gui.libraryItem.memberAssetImgAlt": "Կապույտ աստղի մանրապատկեր, որը ցույց է տալիս, որ տվյալ նյութը նախատեսված է անդամների համար",
     "gui.extensionLibrary.comingSoon": "Շուտով",
     "gui.extensionLibrary.requires": "Պահանջվում է",
     "gui.extensionLibrary.collaboration": "Համագործակցությունը",
     "gui.library.filterPlaceholder": "Որոնել",
     "gui.library.allTag": "Բոլորը",
     "gui.library.gettingStarted": "Սկսել",
-    "gui.library.basics": "Basics",
-    "gui.library.intermediate": "Intermediate",
-    "gui.library.prompts": "Prompts",
-    "gui.library.membershipTag": "Membership",
+    "gui.library.basics": "Հիմունքներ",
+    "gui.library.intermediate": "Միջին մակարդակ",
+    "gui.library.prompts": "Հուշող հրահանգներ",
+    "gui.library.membershipTag": "Անդամակցություն",
     "gui.loader.message1": "Մասնիկի ստեղծում ․․․ ",
     "gui.loader.message2": "Կերպարների բեռնում ․․․ ",
     "gui.loader.message3": "Ձայների բեռնում ․․․",
@@ -20737,7 +20737,7 @@ export default {
     "gui.accountMenu.myClass": "Իմ դասը",
     "gui.accountMenu.accountSettings": "Հաշվի կարգավորումներ",
     "gui.accountMenu.signOut": "Դուրս գալ",
-    "gui.authorInfo.byUser": "by <span>{name}</span>",
+    "gui.authorInfo.byUser": "<span>{name}</span> -ի կողմից",
     "gui.menuBar.seeProjectPage": "Տեսնել նախագծի էջը",
     "gui.menuBar.edit": "Խմբագրել",
     "gui.menuBar.turboModeOff": "Անջատել արագացված ռեժիմը",
@@ -20754,9 +20754,9 @@ export default {
     "login.needHelp": "Օգնության կարի՞ք ունեք:",
     "form.validationRequired": "Այս դաշտը պարտադիր է",
     "gui.menuBar.tutorialsLibrary": "Ձեռնարկներ",
-    "gui.menuBar.debug": "Debug",
-    "gui.menuBar.home": "Home",
-    "gui.menuBar.myStuff": "My Stuff",
+    "gui.menuBar.debug": "Վրիպազերծում",
+    "gui.menuBar.home": "Գլխավոր",
+    "gui.menuBar.myStuff": "Իմ ունեցածը",
     "gui.menuBar.restoreSprite": "Վերականգնել կերպարը",
     "gui.menuBar.restoreSound": "Վերականգնել ձայնը",
     "gui.menuBar.restoreCostume": "Վերականգնել զգեստը",
@@ -20828,8 +20828,8 @@ export default {
     "gui.soundEditor.fadeIn": "Հզորացնել",
     "gui.soundEditor.mute": "Անձայն",
     "gui.SpriteInfo.spritePlaceholder": "Անուն",
-    "gui.SpriteInfo.showSpriteAction": "Show sprite",
-    "gui.SpriteInfo.hideSpriteAction": "Hide sprite",
+    "gui.SpriteInfo.showSpriteAction": "Ցուցադրել կերպարը",
+    "gui.SpriteInfo.hideSpriteAction": "Թաքցնել կերպարը",
     "gui.SpriteInfo.sprite": "Կերպար",
     "gui.SpriteInfo.show": "Ցույց տալ",
     "gui.SpriteInfo.size": "Չափս",
@@ -20844,9 +20844,9 @@ export default {
     "gui.stageHeader.stageSizeSmall": "Անցնել փոքր բեմի",
     "gui.stageHeader.stageSizeFull": "Ակտիվացնել լիաէկրան ռեժիմը",
     "gui.stageHeader.stageSizeUnFull": "Դուրս գալ լիաէկրան ռեժիմից",
-    "gui.stageHeader.saveThumbnail": "Set Thumbnail",
-    "gui.stageHeader.saveThumbnailMessage": "Are you sure you want to set your thumbnail?",
-    "gui.stageHeader.thumbnailTooltipTitle": "Hey there! 👋",
+    "gui.stageHeader.saveThumbnail": "Սահմանել մանրապատկերը",
+    "gui.stageHeader.saveThumbnailMessage": "Վստա՞հ ես, որ ցանկանում ես սահմանել քո մանրապատկերը։",
+    "gui.stageHeader.thumbnailTooltipTitle": "Ողջո՜ւյն։ 👋",
     "gui.stageHeader.thumbnailTooltipBody": "<b>\"Set Thumbnail\"</b> has a new spot. It works by taking a snapshot of your stage and setting it as your project thumbnail.",
     "gui.stageHeader.fullscreenControl": "Լիաէկրան կառավարում",
     "gui.spriteSelector.addBackdropFromLibrary": "Ընտրել ետնապատկերը",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scratch-l10n",
-  "version": "6.1.93",
+  "version": "6.1.95",
   "description": "Localization for the Scratch 3.0 components",
   "main": "./dist/l10n.js",
   "browser": "./src/index.mjs",
@@ -55,7 +55,7 @@
     "lodash.defaultsdeep": "4.6.1",
     "mkdirp": "3.0.1",
     "transifex": "1.6.6",
-    "tsx": "4.23.0"
+    "tsx": "4.23.1"
   },
   "devDependencies": {
     "@babel/cli": "7.29.7",
@@ -73,7 +73,7 @@
     "@types/lodash.defaultsdeep": "4.6.9",
     "babel-loader": "8.4.1",
     "babel-plugin-react-intl": "3.5.1",
-    "eslint": "9.39.4",
+    "eslint": "9.39.5",
     "eslint-config-scratch": "11.0.53",
     "format-message-cli": "6.2.4",
     "globals": "17.7.0",
@@ -83,10 +83,10 @@
     "jsonlint": "1.6.3",
     "p-limit": "2.3.0",
     "p-queue": "3.2.0",
-    "prettier": "3.9.4",
+    "prettier": "3.9.5",
     "rimraf": "2.7.1",
     "scratch-semantic-release-config": "4.0.1",
-    "semantic-release": "25.0.5",
+    "semantic-release": "25.0.6",
     "webpack": "4.47.0",
     "webpack-cli": "3.3.12"
   },

package/scripts/lib/errors.mts

@@ -0,0 +1,12 @@
+/**
+ * @file
+ * Small shared helpers for working with caught values.
+ */
+
+/**
+ * Extract a human-readable message from a caught value. `catch` values are typed `unknown` and are
+ * not guaranteed to be `Error` instances, so read `.message` only when it really is one.
+ * @param err - the caught value
+ * @returns the error message, or a string representation of a non-Error throw
+ */
+export const messageOf = (err: unknown): string => (err instanceof Error ? err.message : String(err))

package/scripts/lib/freshdesk-api.mts

@@ -1,4 +1,5 @@
 // interface to FreshDesk Solutions (knowledge base) api
+import { messageOf } from './errors.mts'
 
 /**
  * Extend
@@ -12,7 +13,7 @@ export interface HttpError extends Error {
 }
 
 /**
- * Properties to provide when creating a Category throught the Freshdesk API. Also works for updates.
+ * Properties to provide when creating a Category through the Freshdesk API. Also works for updates.
  * @see https://developers.freshdesk.com/api/#create_solution_category
  */
 export interface FreshdeskCategoryCreate {
@@ -38,7 +39,7 @@ export interface FreshdeskCategory extends FreshdeskCategoryCreate {
 }
 
 /**
- * Properties to provide when creating a Folder throught the Freshdesk API. Also works for updates.
+ * Properties to provide when creating a Folder through the Freshdesk API. Also works for updates.
  * @see https://developers.freshdesk.com/api/#create_solution_folder
  */
 export interface FreshdeskFolderCreate {
@@ -89,7 +90,7 @@ export enum FreshdeskFolderVisibility {
 }
 
 /**
- * Properties to provide when creating an Article throught the Freshdesk API. Also works for updates.
+ * Properties to provide when creating an Article through the Freshdesk API. Also works for updates.
  * @see https://developers.freshdesk.com/api/#create_solution_article
  */
 export interface FreshdeskArticleCreate {
@@ -146,6 +147,23 @@ export interface FreshdeskSEOData {
   meta_keywords?: string[]
 }
 
+/**
+ * A Freshdesk agent, as returned by the `agents/me` endpoint.
+ * @see https://developers.freshdesk.com/api/#me
+ */
+export interface FreshdeskAgent {
+  /** Unique ID of the agent */
+  id: number
+  /** Scope of tickets the agent can access */
+  ticket_scope?: number
+  /** The agent's contact details */
+  contact: {
+    name: string
+    email: string
+    active?: boolean
+  }
+}
+
 /**
  * Wrapper for Freshdesk's REST API
  */
@@ -166,11 +184,14 @@ export class FreshdeskApi {
   }
 
   /**
-   * Checks the status of a response. If status is not ok, or the body is not JSON, raise exception
+   * Checks the status of a response. If status is not ok, or the body is not JSON, raise exception.
+   * On error, the response body is included in the message: Freshdesk reports the actual reason for
+   * a failure there (for example `{"code":"access_denied","message":"..."}`), so surfacing it turns
+   * an opaque "HTTP 403" into something diagnosable.
    * @param res - The response object
    * @returns the response if it is ok
    */
-  checkStatus(res: Response) {
+  async checkStatus(res: Response) {
     if (res.ok) {
       if (res.headers.get('content-type')?.includes('application/json')) {
         return res
@@ -181,6 +202,12 @@ export class FreshdeskApi {
     if (res.status === 403) {
       message += ` -- this item may have been deleted in Freshdesk, or the API key lacks permission.`
     }
+    // Read the body for the underlying reason. It is safe to consume here because we only reach this
+    // point on error and are about to throw; the caller never reads the body of a failed response.
+    const body = (await res.text().catch(() => '')).trim()
+    if (body) {
+      message += ` -- response: ${body.length > 500 ? `${body.slice(0, 500)}...` : body}`
+    }
     const err = new Error(message) as HttpError
     err.code = res.status
     if (res.status === 429) {
@@ -191,7 +218,7 @@ export class FreshdeskApi {
 
   async listCategories(): Promise<FreshdeskCategory[]> {
     const res = await fetch(`${this.baseUrl}/api/v2/solutions/categories`, { headers: this.defaultHeaders })
-    this.checkStatus(res)
+    await this.checkStatus(res)
     return (await res.json()) as FreshdeskCategory[]
   }
 
@@ -199,7 +226,7 @@ export class FreshdeskApi {
     const res = await fetch(`${this.baseUrl}/api/v2/solutions/categories/${category.id}/folders`, {
       headers: this.defaultHeaders,
     })
-    this.checkStatus(res)
+    await this.checkStatus(res)
     return (await res.json()) as FreshdeskFolder[]
   }
 
@@ -207,10 +234,22 @@ export class FreshdeskApi {
     const res = await fetch(`${this.baseUrl}/api/v2/solutions/folders/${folder.id}/articles`, {
       headers: this.defaultHeaders,
     })
-    this.checkStatus(res)
+    await this.checkStatus(res)
     return (await res.json()) as FreshdeskArticle[]
   }
 
+  /**
+   * Fetch the agent that the configured API key authenticates as. The account behind the token
+   * determines what the sync may read and write, so surfacing it makes a permission problem (such
+   * as a `403 access_denied` on a specific item) much easier to route to the right person.
+   * @returns the agent's id and contact details
+   */
+  async getAuthenticatedAgent(): Promise<FreshdeskAgent> {
+    const res = await fetch(`${this.baseUrl}/api/v2/agents/me`, { headers: this.defaultHeaders })
+    await this.checkStatus(res)
+    return (await res.json()) as FreshdeskAgent
+  }
+
   async updateCategoryTranslation(
     id: FreshdeskCategory['id'],
     locale: string,
@@ -226,7 +265,7 @@ export class FreshdeskApi {
         body: JSON.stringify(body),
         headers: this.defaultHeaders,
       })
-      this.checkStatus(res)
+      await this.checkStatus(res)
       return (await res.json()) as FreshdeskCategory
     } catch (err) {
       const httpError = err as HttpError
@@ -237,7 +276,7 @@ export class FreshdeskApi {
           body: JSON.stringify(body),
           headers: this.defaultHeaders,
         })
-        this.checkStatus(res2)
+        await this.checkStatus(res2)
         return (await res2.json()) as FreshdeskCategory
       }
       if (httpError.code === 429) {
@@ -263,7 +302,7 @@ export class FreshdeskApi {
         body: JSON.stringify(body),
         headers: this.defaultHeaders,
       })
-      this.checkStatus(res)
+      await this.checkStatus(res)
       return (await res.json()) as FreshdeskFolder
     } catch (err) {
       const httpError = err as HttpError
@@ -274,7 +313,7 @@ export class FreshdeskApi {
           body: JSON.stringify(body),
           headers: this.defaultHeaders,
         })
-        this.checkStatus(res2)
+        await this.checkStatus(res2)
         return (await res2.json()) as FreshdeskFolder
       }
       if (httpError.code === 429) {
@@ -300,7 +339,7 @@ export class FreshdeskApi {
         body: JSON.stringify(body),
         headers: this.defaultHeaders,
       })
-      this.checkStatus(res)
+      await this.checkStatus(res)
       return (await res.json()) as FreshdeskArticle
     } catch (err) {
       const httpError = err as HttpError
@@ -311,7 +350,7 @@ export class FreshdeskApi {
           body: JSON.stringify(body),
           headers: this.defaultHeaders,
         })
-        this.checkStatus(res2)
+        await this.checkStatus(res2)
         return (await res2.json()) as FreshdeskArticle
       }
       if (httpError.code === 429) {
@@ -323,4 +362,21 @@ export class FreshdeskApi {
   }
 }
 
+/**
+ * Log which agent the given Freshdesk client authenticates as. Never throws: identifying the agent
+ * is a diagnostic aid, so a failure here (for example an invalid token) is reported and swallowed
+ * rather than aborting the caller, which will hit the same problem with a clearer error of its own.
+ * The agent's email is intentionally omitted to keep it out of public CI logs; the name and id are
+ * enough to find the account in Freshdesk.
+ * @param fd - a configured Freshdesk client
+ */
+export const logAuthenticatedAgent = async (fd: FreshdeskApi): Promise<void> => {
+  try {
+    const agent = await fd.getAuthenticatedAgent()
+    console.log(`Freshdesk token authenticated as "${agent.contact.name}" (agent id ${agent.id}).`)
+  } catch (error) {
+    console.warn(`Could not identify the Freshdesk agent for the configured token: ${messageOf(error)}`)
+  }
+}
+
 export default FreshdeskApi