@azurioh/discord-kernel 0.1.0 → 1.0.0

package/package.json

@@ -1,89 +1,464 @@
 {
-	"name": "@azurioh/discord-kernel",
-	"version": "0.1.0",
-	"description": "Framework kernel for Discord bots: command DSL, guards, interaction routing, composed components, i18n, ports (Presenter, Logger, DatabaseConnection, Authorizer, Scheduler).",
-	"keywords": [
-		"discord",
-		"discord.js",
-		"discord-bot",
-		"framework",
-		"clean-architecture",
-		"hexagonal",
-		"typescript",
-		"i18n"
-	],
-	"license": "MIT",
-	"author": "Alan Cunin (https://github.com/Azurioh)",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/Azurioh/discord-kernel.git"
-	},
-	"bugs": {
-		"url": "https://github.com/Azurioh/discord-kernel/issues"
-	},
-	"homepage": "https://github.com/Azurioh/discord-kernel#readme",
-	"engines": {
-		"node": ">=22.12.0"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"exports": {
-		"./package.json": "./package.json",
-		"./errors": {
-			"types": "./dist/errors/index.d.ts",
-			"default": "./dist/errors/index.js"
-		},
-		"./i18n": {
-			"types": "./dist/i18n/index.d.ts",
-			"default": "./dist/i18n/index.js"
-		},
-		"./discord/components/interactive-message": {
-			"types": "./dist/discord/components/interactive-message/index.d.ts",
-			"default": "./dist/discord/components/interactive-message/index.js"
-		},
-		"./discord/components/paginator": {
-			"types": "./dist/discord/components/paginator/index.d.ts",
-			"default": "./dist/discord/components/paginator/index.js"
-		},
-		"./discord/components/settings-editor": {
-			"types": "./dist/discord/components/settings-editor/index.d.ts",
-			"default": "./dist/discord/components/settings-editor/index.js"
-		},
-		"./*": {
-			"types": "./dist/*.d.ts",
-			"default": "./dist/*.js"
-		}
-	},
-	"files": [
-		"dist",
-		"src"
-	],
-	"scripts": {
-		"build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
-		"typecheck": "tsc -p tsconfig.json",
-		"lint": "biome ci",
-		"format": "biome check --write",
-		"knip": "knip",
-		"test": "vitest run",
-		"test:watch": "vitest",
-		"prepublishOnly": "npm run build"
-	},
-	"dependencies": {
-		"node-cron": "4.6.0"
-	},
-	"peerDependencies": {
-		"discord.js": "^14.27.0"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.5.7",
-		"@types/node": "24.13.3",
-		"discord.js": "14.27.0",
-		"knip": "^6.15.0",
-		"tsc-alias": "^1.8.16",
-		"typescript": "^5.9.3",
-		"vite-tsconfig-paths": "^6.1.1",
-		"vitest": "^4.1.8"
-	},
-	"packageManager": "pnpm@11.20.0"
-}
+  "name": "@azurioh/discord-kernel",
+  "version": "1.0.0",
+  "description": "Framework kernel for Discord bots: command DSL, guards, interaction routing, composed components, i18n, ports (Presenter, Logger, DatabaseConnection, Authorizer, Scheduler).",
+  "keywords": [
+    "discord",
+    "discord.js",
+    "discord-bot",
+    "framework",
+    "clean-architecture",
+    "hexagonal",
+    "typescript",
+    "i18n"
+  ],
+  "license": "MIT",
+  "author": "Alan Cunin (https://github.com/Azurioh)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Azurioh/discord-kernel.git",
+    "directory": "packages/kernel"
+  },
+  "bugs": {
+    "url": "https://github.com/Azurioh/discord-kernel/issues"
+  },
+  "homepage": "https://github.com/Azurioh/discord-kernel/tree/main/packages/kernel#readme",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "default": "./dist/errors/index.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "default": "./dist/i18n/index.js"
+    },
+    "./discord/components/interactive-message": {
+      "types": "./dist/discord/components/interactive-message/index.d.ts",
+      "default": "./dist/discord/components/interactive-message/index.js"
+    },
+    "./discord/components/paginator": {
+      "types": "./dist/discord/components/paginator/index.d.ts",
+      "default": "./dist/discord/components/paginator/index.js"
+    },
+    "./discord/components/settings-editor": {
+      "types": "./dist/discord/components/settings-editor/index.d.ts",
+      "default": "./dist/discord/components/settings-editor/index.js"
+    },
+    "./settings": {
+      "types": "./dist/settings/index.d.ts",
+      "default": "./dist/settings/index.js"
+    },
+    "./settings/testing": {
+      "types": "./dist/settings/testing/index.d.ts",
+      "default": "./dist/settings/testing/index.js"
+    },
+    "./authz/authorizer": {
+      "types": "./dist/authz/authorizer.d.ts",
+      "default": "./dist/authz/authorizer.js"
+    },
+    "./authz/require-level-guard": {
+      "types": "./dist/authz/require-level-guard.d.ts",
+      "default": "./dist/authz/require-level-guard.js"
+    },
+    "./clock": {
+      "types": "./dist/clock.d.ts",
+      "default": "./dist/clock.js"
+    },
+    "./color": {
+      "types": "./dist/color.d.ts",
+      "default": "./dist/color.js"
+    },
+    "./concurrency/keyed-queue": {
+      "types": "./dist/concurrency/keyed-queue.d.ts",
+      "default": "./dist/concurrency/keyed-queue.js"
+    },
+    "./concurrency/run-with-concurrency": {
+      "types": "./dist/concurrency/run-with-concurrency.d.ts",
+      "default": "./dist/concurrency/run-with-concurrency.js"
+    },
+    "./config/env": {
+      "types": "./dist/config/env.d.ts",
+      "default": "./dist/config/env.js"
+    },
+    "./config/errors": {
+      "types": "./dist/config/errors.d.ts",
+      "default": "./dist/config/errors.js"
+    },
+    "./datetime": {
+      "types": "./dist/datetime.d.ts",
+      "default": "./dist/datetime.js"
+    },
+    "./discord/api-errors": {
+      "types": "./dist/discord/api-errors.d.ts",
+      "default": "./dist/discord/api-errors.js"
+    },
+    "./discord/channel-exporter": {
+      "types": "./dist/discord/channel-exporter.d.ts",
+      "default": "./dist/discord/channel-exporter.js"
+    },
+    "./discord/command/all-required": {
+      "types": "./dist/discord/command/all-required.d.ts",
+      "default": "./dist/discord/command/all-required.js"
+    },
+    "./discord/command/autocomplete-dispatcher": {
+      "types": "./dist/discord/command/autocomplete-dispatcher.d.ts",
+      "default": "./dist/discord/command/autocomplete-dispatcher.js"
+    },
+    "./discord/command/autocomplete-limits": {
+      "types": "./dist/discord/command/autocomplete-limits.d.ts",
+      "default": "./dist/discord/command/autocomplete-limits.js"
+    },
+    "./discord/command/autocomplete": {
+      "types": "./dist/discord/command/autocomplete.d.ts",
+      "default": "./dist/discord/command/autocomplete.js"
+    },
+    "./discord/command/command-responders": {
+      "types": "./dist/discord/command/command-responders.d.ts",
+      "default": "./dist/discord/command/command-responders.js"
+    },
+    "./discord/command/context": {
+      "types": "./dist/discord/command/context.d.ts",
+      "default": "./dist/discord/command/context.js"
+    },
+    "./discord/command/cooldown-guard": {
+      "types": "./dist/discord/command/cooldown-guard.d.ts",
+      "default": "./dist/discord/command/cooldown-guard.js"
+    },
+    "./discord/command/create-command": {
+      "types": "./dist/discord/command/create-command.d.ts",
+      "default": "./dist/discord/command/create-command.js"
+    },
+    "./discord/command/create-context-menu-command": {
+      "types": "./dist/discord/command/create-context-menu-command.d.ts",
+      "default": "./dist/discord/command/create-context-menu-command.js"
+    },
+    "./discord/command/errors": {
+      "types": "./dist/discord/command/errors.d.ts",
+      "default": "./dist/discord/command/errors.js"
+    },
+    "./discord/command/guard": {
+      "types": "./dist/discord/command/guard.d.ts",
+      "default": "./dist/discord/command/guard.js"
+    },
+    "./discord/command/localization": {
+      "types": "./dist/discord/command/localization.d.ts",
+      "default": "./dist/discord/command/localization.js"
+    },
+    "./discord/command/options": {
+      "types": "./dist/discord/command/options.d.ts",
+      "default": "./dist/discord/command/options.js"
+    },
+    "./discord/command/passes-guard": {
+      "types": "./dist/discord/command/passes-guard.d.ts",
+      "default": "./dist/discord/command/passes-guard.js"
+    },
+    "./discord/command/permission-guard": {
+      "types": "./dist/discord/command/permission-guard.d.ts",
+      "default": "./dist/discord/command/permission-guard.js"
+    },
+    "./discord/command/render-command-failure": {
+      "types": "./dist/discord/command/render-command-failure.d.ts",
+      "default": "./dist/discord/command/render-command-failure.js"
+    },
+    "./discord/command/route-key": {
+      "types": "./dist/discord/command/route-key.d.ts",
+      "default": "./dist/discord/command/route-key.js"
+    },
+    "./discord/command/router": {
+      "types": "./dist/discord/command/router.d.ts",
+      "default": "./dist/discord/command/router.js"
+    },
+    "./discord/command/send-embed": {
+      "types": "./dist/discord/command/send-embed.d.ts",
+      "default": "./dist/discord/command/send-embed.js"
+    },
+    "./discord/command/types": {
+      "types": "./dist/discord/command/types.d.ts",
+      "default": "./dist/discord/command/types.js"
+    },
+    "./discord/components/component-access": {
+      "types": "./dist/discord/components/component-access.d.ts",
+      "default": "./dist/discord/components/component-access.js"
+    },
+    "./discord/components/component-router": {
+      "types": "./dist/discord/components/component-router.d.ts",
+      "default": "./dist/discord/components/component-router.js"
+    },
+    "./discord/components/interactive-message/index": {
+      "types": "./dist/discord/components/interactive-message/index.d.ts",
+      "default": "./dist/discord/components/interactive-message/index.js"
+    },
+    "./discord/components/interactive-message/interactive-message-collector": {
+      "types": "./dist/discord/components/interactive-message/interactive-message-collector.d.ts",
+      "default": "./dist/discord/components/interactive-message/interactive-message-collector.js"
+    },
+    "./discord/components/interactive-message/message-edit-options": {
+      "types": "./dist/discord/components/interactive-message/message-edit-options.d.ts",
+      "default": "./dist/discord/components/interactive-message/message-edit-options.js"
+    },
+    "./discord/components/interactive-message/mount-interactive-message": {
+      "types": "./dist/discord/components/interactive-message/mount-interactive-message.d.ts",
+      "default": "./dist/discord/components/interactive-message/mount-interactive-message.js"
+    },
+    "./discord/components/interactive-message/state-store": {
+      "types": "./dist/discord/components/interactive-message/state-store.d.ts",
+      "default": "./dist/discord/components/interactive-message/state-store.js"
+    },
+    "./discord/components/paginator/index": {
+      "types": "./dist/discord/components/paginator/index.d.ts",
+      "default": "./dist/discord/components/paginator/index.js"
+    },
+    "./discord/components/paginator/mount-paginator": {
+      "types": "./dist/discord/components/paginator/mount-paginator.d.ts",
+      "default": "./dist/discord/components/paginator/mount-paginator.js"
+    },
+    "./discord/components/paginator/page-state": {
+      "types": "./dist/discord/components/paginator/page-state.d.ts",
+      "default": "./dist/discord/components/paginator/page-state.js"
+    },
+    "./discord/components/paginator/paginator-buttons": {
+      "types": "./dist/discord/components/paginator/paginator-buttons.d.ts",
+      "default": "./dist/discord/components/paginator/paginator-buttons.js"
+    },
+    "./discord/components/paginator/paginator-view": {
+      "types": "./dist/discord/components/paginator/paginator-view.d.ts",
+      "default": "./dist/discord/components/paginator/paginator-view.js"
+    },
+    "./discord/components/persistent-paginator": {
+      "types": "./dist/discord/components/persistent-paginator.d.ts",
+      "default": "./dist/discord/components/persistent-paginator.js"
+    },
+    "./discord/components/settings-editor/index": {
+      "types": "./dist/discord/components/settings-editor/index.d.ts",
+      "default": "./dist/discord/components/settings-editor/index.js"
+    },
+    "./discord/components/settings-editor/mount-settings-editor": {
+      "types": "./dist/discord/components/settings-editor/mount-settings-editor.d.ts",
+      "default": "./dist/discord/components/settings-editor/mount-settings-editor.js"
+    },
+    "./discord/components/settings-editor/navigation": {
+      "types": "./dist/discord/components/settings-editor/navigation.d.ts",
+      "default": "./dist/discord/components/settings-editor/navigation.js"
+    },
+    "./discord/components/settings-editor/settings-editor-card.view": {
+      "types": "./dist/discord/components/settings-editor/settings-editor-card.view.d.ts",
+      "default": "./dist/discord/components/settings-editor/settings-editor-card.view.js"
+    },
+    "./discord/components/settings-editor/settings-editor-field-modal": {
+      "types": "./dist/discord/components/settings-editor/settings-editor-field-modal.d.ts",
+      "default": "./dist/discord/components/settings-editor/settings-editor-field-modal.js"
+    },
+    "./discord/components/settings-editor/settings-editor-field-values": {
+      "types": "./dist/discord/components/settings-editor/settings-editor-field-values.d.ts",
+      "default": "./dist/discord/components/settings-editor/settings-editor-field-values.js"
+    },
+    "./discord/components/settings-editor/settings-editor-fields": {
+      "types": "./dist/discord/components/settings-editor/settings-editor-fields.d.ts",
+      "default": "./dist/discord/components/settings-editor/settings-editor-fields.js"
+    },
+    "./discord/components/settings-editor/settings-editor.view": {
+      "types": "./dist/discord/components/settings-editor/settings-editor.view.d.ts",
+      "default": "./dist/discord/components/settings-editor/settings-editor.view.js"
+    },
+    "./discord/events/create-event": {
+      "types": "./dist/discord/events/create-event.d.ts",
+      "default": "./dist/discord/events/create-event.js"
+    },
+    "./discord/events/event-router": {
+      "types": "./dist/discord/events/event-router.d.ts",
+      "default": "./dist/discord/events/event-router.js"
+    },
+    "./discord/events/types": {
+      "types": "./dist/discord/events/types.d.ts",
+      "default": "./dist/discord/events/types.js"
+    },
+    "./discord/i18n": {
+      "types": "./dist/discord/i18n.d.ts",
+      "default": "./dist/discord/i18n.js"
+    },
+    "./discord/interaction/button": {
+      "types": "./dist/discord/interaction/button.d.ts",
+      "default": "./dist/discord/interaction/button.js"
+    },
+    "./discord/interaction/interaction-locale": {
+      "types": "./dist/discord/interaction/interaction-locale.d.ts",
+      "default": "./dist/discord/interaction/interaction-locale.js"
+    },
+    "./discord/interaction/interaction-router": {
+      "types": "./dist/discord/interaction/interaction-router.d.ts",
+      "default": "./dist/discord/interaction/interaction-router.js"
+    },
+    "./discord/interaction/locale-resolver": {
+      "types": "./dist/discord/interaction/locale-resolver.d.ts",
+      "default": "./dist/discord/interaction/locale-resolver.js"
+    },
+    "./discord/interaction/modal": {
+      "types": "./dist/discord/interaction/modal.d.ts",
+      "default": "./dist/discord/interaction/modal.js"
+    },
+    "./discord/interaction/select-bounds": {
+      "types": "./dist/discord/interaction/select-bounds.d.ts",
+      "default": "./dist/discord/interaction/select-bounds.js"
+    },
+    "./discord/interaction/select-menu": {
+      "types": "./dist/discord/interaction/select-menu.d.ts",
+      "default": "./dist/discord/interaction/select-menu.js"
+    },
+    "./discord/permissions": {
+      "types": "./dist/discord/permissions.d.ts",
+      "default": "./dist/discord/permissions.js"
+    },
+    "./discord/placeholder-registry-errors": {
+      "types": "./dist/discord/placeholder-registry-errors.d.ts",
+      "default": "./dist/discord/placeholder-registry-errors.js"
+    },
+    "./discord/placeholder-registry": {
+      "types": "./dist/discord/placeholder-registry.d.ts",
+      "default": "./dist/discord/placeholder-registry.js"
+    },
+    "./discord/presenter": {
+      "types": "./dist/discord/presenter.d.ts",
+      "default": "./dist/discord/presenter.js"
+    },
+    "./discord/settings/discord-guild-directory": {
+      "types": "./dist/discord/settings/discord-guild-directory.d.ts",
+      "default": "./dist/discord/settings/discord-guild-directory.js"
+    },
+    "./discord/settings/guild-locale-resolver": {
+      "types": "./dist/discord/settings/guild-locale-resolver.d.ts",
+      "default": "./dist/discord/settings/guild-locale-resolver.js"
+    },
+    "./discord/settings/require-configured": {
+      "types": "./dist/discord/settings/require-configured.d.ts",
+      "default": "./dist/discord/settings/require-configured.js"
+    },
+    "./discord/ui/card": {
+      "types": "./dist/discord/ui/card.d.ts",
+      "default": "./dist/discord/ui/card.js"
+    },
+    "./discord/ui/color-aliases": {
+      "types": "./dist/discord/ui/color-aliases.d.ts",
+      "default": "./dist/discord/ui/color-aliases.js"
+    },
+    "./discord/ui/color-input-errors": {
+      "types": "./dist/discord/ui/color-input-errors.d.ts",
+      "default": "./dist/discord/ui/color-input-errors.js"
+    },
+    "./discord/ui/color-input": {
+      "types": "./dist/discord/ui/color-input.d.ts",
+      "default": "./dist/discord/ui/color-input.js"
+    },
+    "./discord/ui/colors": {
+      "types": "./dist/discord/ui/colors.d.ts",
+      "default": "./dist/discord/ui/colors.js"
+    },
+    "./discord/ui/embed": {
+      "types": "./dist/discord/ui/embed.d.ts",
+      "default": "./dist/discord/ui/embed.js"
+    },
+    "./discord/ui/message-attachments": {
+      "types": "./dist/discord/ui/message-attachments.d.ts",
+      "default": "./dist/discord/ui/message-attachments.js"
+    },
+    "./errors/business-error": {
+      "types": "./dist/errors/business-error.d.ts",
+      "default": "./dist/errors/business-error.js"
+    },
+    "./errors/describe-error": {
+      "types": "./dist/errors/describe-error.d.ts",
+      "default": "./dist/errors/describe-error.js"
+    },
+    "./errors/error-message": {
+      "types": "./dist/errors/error-message.d.ts",
+      "default": "./dist/errors/error-message.js"
+    },
+    "./errors/incident-ref": {
+      "types": "./dist/errors/incident-ref.d.ts",
+      "default": "./dist/errors/incident-ref.js"
+    },
+    "./errors/index": {
+      "types": "./dist/errors/index.d.ts",
+      "default": "./dist/errors/index.js"
+    },
+    "./i18n/business-message": {
+      "types": "./dist/i18n/business-message.d.ts",
+      "default": "./dist/i18n/business-message.js"
+    },
+    "./i18n/catalog": {
+      "types": "./dist/i18n/catalog.d.ts",
+      "default": "./dist/i18n/catalog.js"
+    },
+    "./i18n/errors": {
+      "types": "./dist/i18n/errors.d.ts",
+      "default": "./dist/i18n/errors.js"
+    },
+    "./i18n/index": {
+      "types": "./dist/i18n/index.d.ts",
+      "default": "./dist/i18n/index.js"
+    },
+    "./i18n/locale": {
+      "types": "./dist/i18n/locale.d.ts",
+      "default": "./dist/i18n/locale.js"
+    },
+    "./i18n/translator": {
+      "types": "./dist/i18n/translator.d.ts",
+      "default": "./dist/i18n/translator.js"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "default": "./dist/logger.js"
+    },
+    "./module/module": {
+      "types": "./dist/module/module.d.ts",
+      "default": "./dist/module/module.js"
+    },
+    "./persistence/database": {
+      "types": "./dist/persistence/database.d.ts",
+      "default": "./dist/persistence/database.js"
+    },
+    "./resilience/retry": {
+      "types": "./dist/resilience/retry.d.ts",
+      "default": "./dist/resilience/retry.js"
+    },
+    "./scheduler/errors": {
+      "types": "./dist/scheduler/errors.d.ts",
+      "default": "./dist/scheduler/errors.js"
+    },
+    "./scheduler/scheduler": {
+      "types": "./dist/scheduler/scheduler.d.ts",
+      "default": "./dist/scheduler/scheduler.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "node-cron": "4.6.0",
+    "zod": "4.6.5"
+  },
+  "peerDependencies": {
+    "discord.js": "^14.27.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "ajv": "8.20.0",
+    "discord.js": "14.27.0",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/authz/require-level-guard.ts

@@ -1,7 +1,7 @@
 import type { BaseInteraction, CommandInteraction } from "discord.js";
 import type { Authorizer, PermissionLevel } from "@/authz/authorizer";
 import type { Guard } from "@/discord/command/guard";
-import type { LocalizedText } from "@/i18n";
+import type { LocalizedText } from "@/i18n/translator";
 
 /**
  * Role IDs held by the interacting member, resolved without a network call: