@dereekb/util 13.23.0 → 13.25.0

package/eslint/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@dereekb/util/eslint",
-  "version": "13.23.0",
+  "version": "13.25.0",
   "peerDependencies": {
-    "@dereekb/util": "13.23.0",
-    "@typescript-eslint/utils": "8.59.3"
+    "@dereekb/util": "13.25.0",
+    "@typescript-eslint/utils": "8.59.3",
+    "typescript": "5.9.3"
   },
   "devDependencies": {
     "@typescript-eslint/parser": "8.59.3",

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

@@ -21,6 +21,7 @@ export { UTIL_REQUIRE_DBX_RULE_COMPANION_TAGS_RULE, type UtilRequireDbxRuleCompa
 export { UTIL_REQUIRE_CONSTANT_NAMING_RULE, type UtilRequireConstantNamingRuleOptions, type UtilRequireConstantNamingRuleDefinition } from './require-constant-naming.rule';
 export { UTIL_REQUIRE_DEFAULT_PREFIX_NAMING_RULE, type UtilRequireDefaultPrefixNamingRuleOptions, type UtilRequireDefaultPrefixNamingRuleDefinition } from './require-default-prefix-naming.rule';
 export { UTIL_REQUIRE_EXPORTED_JSDOC_EXAMPLE_RULE, type UtilRequireExportedJsdocExampleRuleOptions, type UtilRequireExportedJsdocExampleRuleDefinition } from './require-exported-jsdoc-example.rule';
+export { UTIL_NO_ENUM_LITERAL_CAST_RULE, type UtilNoEnumLiteralCastRuleDefinition } from './no-enum-literal-cast.rule';
 export { UTIL_ESLINT_PLUGIN, utilESLintPlugin, type UtilEslintPlugin } from './plugin';
 export { getStatementAnchor, leadingJsdocFor } from './comments';
 export { parseJsdocComment, type ParsedJsdoc, type ParsedJsdocTag, type ParsedJsdocLine } from './jsdoc-parser';

package/eslint/src/lib/no-enum-literal-cast.rule.d.ts

@@ -0,0 +1,51 @@
+interface AstNode {
+    readonly type: string;
+    [key: string]: any;
+}
+/**
+ * ESLint rule definition for no-enum-literal-cast.
+ */
+export interface UtilNoEnumLiteralCastRuleDefinition {
+    readonly meta: {
+        readonly type: 'problem';
+        readonly fixable: 'code';
+        readonly docs: {
+            readonly description: string;
+            readonly recommended: boolean;
+        };
+        readonly messages: {
+            readonly useEnumMember: string;
+            readonly unsafeEnumCast: string;
+        };
+        readonly schema: readonly object[];
+    };
+    create(context: {
+        report: (descriptor: {
+            node: AstNode;
+            messageId: string;
+            data?: Record<string, string>;
+            fix?: (fixer: AstNode) => AstNode | AstNode[];
+        }) => void;
+        sourceCode: AstNode;
+    }): Record<string, (node: AstNode) => void>;
+}
+/**
+ * ESLint rule that flags a numeric/string literal asserted onto an enum type — e.g.
+ * `layer: 0 as PromptLayer` — and steers it to the named member (`PromptLayer.REPLY_PROTOCOL`).
+ *
+ * The cast is doubly harmful: it bypasses type-checking (any in-range *or* out-of-range number
+ * satisfies `n as SomeEnum`, so `99 as PromptLayer` compiles silently) and it hides intent behind a
+ * magic number. The rule is type-aware: it fires ONLY when the assertion target resolves to a real
+ * `enum` / `const enum`, so legitimate branded-primitive aliases (`30 as EntityId`,
+ * `7001 as ConceptId`) — which have no named members and for which the cast is the sanctioned form —
+ * are never touched.
+ *
+ * When the literal matches a member, the fix rewrites the assertion to `Enum.MEMBER` and, when the
+ * enum is bound via `import type` / `import { type … }`, converts that binding to a value import so
+ * the rewritten value reference compiles. When the literal matches NO member, the rule reports the
+ * unsafe cast without a fix (there is no correct member to substitute).
+ *
+ * Requires type information — it no-ops in lint passes without it (no `projectService` / `project`).
+ */
+export declare const UTIL_NO_ENUM_LITERAL_CAST_RULE: UtilNoEnumLiteralCastRuleDefinition;
+export {};

package/eslint/src/lib/plugin.d.ts

@@ -23,6 +23,7 @@ import { type UtilRequireDefaultPrefixNamingRuleDefinition } from './require-def
 import { type UtilRequireExportedJsdocExampleRuleDefinition } from './require-exported-jsdoc-example.rule';
 import { type UtilNoInlineStringEmptyObjectIntersectionRuleDefinition } from './no-inline-string-empty-object-intersection.rule';
 import { type UtilPreferSuggestedStringRuleDefinition } from './prefer-suggested-string.rule';
+import { type UtilNoEnumLiteralCastRuleDefinition } from './no-enum-literal-cast.rule';
 /**
  * ESLint plugin interface for @dereekb/util rules.
  */
@@ -54,6 +55,7 @@ export interface UtilEslintPlugin {
         readonly 'require-exported-jsdoc-example': UtilRequireExportedJsdocExampleRuleDefinition;
         readonly 'no-inline-string-empty-object-intersection': UtilNoInlineStringEmptyObjectIntersectionRuleDefinition;
         readonly 'prefer-suggested-string': UtilPreferSuggestedStringRuleDefinition;
+        readonly 'no-enum-literal-cast': UtilNoEnumLiteralCastRuleDefinition;
     };
 }
 /**

package/fetch/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "13.23.0",
+  "version": "13.25.0",
   "peerDependencies": {
-    "@dereekb/util": "13.23.0",
+    "@dereekb/util": "13.25.0",
     "make-error": "^1.3.6",
     "fast-content-type-parse": "^3.0.0"
   },