@express-zod-api/migration 24.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anna Bocharova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# Migration script for Express Zod API
+
+ESLint plugin for migrating Express Zod API to its next major version.
+
+## Requirements
+
+- `eslint` v9;
+- `typescript-eslint` v8.
+
+## Usage
+
+The minimal configuration to apply migrations automatically using `eslint --fix`:
+
+```js
+// eslint.config.mjs
+import parser from "@typescript-eslint/parser";
+import migration from "@express-zod-api/migration";
+
+export default [
+  { languageOptions: { parser }, plugins: { migration } },
+  { files: ["**/*.ts"], rules: { "migration/v24": "error" } },
+];
+```

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var f=(t,e)=>{for(var n in e)i(t,n,{get:e[n],enumerable:!0})},g=(t,e,n,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of S(e))!d.call(t,o)&&o!==n&&i(t,o,{get:()=>e[o],enumerable:!(a=u(e,o))||a.enumerable});return t};var y=t=>g(i({},"__esModule",{value:!0}),t);var z={};f(z,{default:()=>b});module.exports=y(z);var r=require("@typescript-eslint/utils"),T={numericRange:`${r.AST_NODE_TYPES.NewExpression}[callee.name='Documentation'] > ${r.AST_NODE_TYPES.ObjectExpression} > ${r.AST_NODE_TYPES.Property}[key.name='numericRange']`,optionalPropStyle:`${r.AST_NODE_TYPES.NewExpression}[callee.name='Integration'] > ${r.AST_NODE_TYPES.ObjectExpression} > ${r.AST_NODE_TYPES.Property}[key.name='optionalPropStyle']`,depicter:`${r.AST_NODE_TYPES.VariableDeclarator}[id.typeAnnotation.typeAnnotation.typeName.name='Depicter'] > ${r.AST_NODE_TYPES.ArrowFunctionExpression}`,nextCall:`${r.AST_NODE_TYPES.VariableDeclarator}[id.typeAnnotation.typeAnnotation.typeName.name='Depicter'] > ${r.AST_NODE_TYPES.ArrowFunctionExpression} ${r.AST_NODE_TYPES.CallExpression}[callee.name='next']`,zod:`${r.AST_NODE_TYPES.ImportDeclaration}[source.value='zod']`,ezFile:`${r.AST_NODE_TYPES.CallExpression}[arguments.0.type='${r.AST_NODE_TYPES.Literal}']:has( ${r.AST_NODE_TYPES.MemberExpression}[object.name='ez'][property.name='file'] )`},E=t=>Object.keys(t).reduce((e,n)=>Object.assign(e,{[T[n]]:t[n]}),{}),l=(t,e)=>[t.range[0],t.range[1]+(e.sourceCode.getTokenAfter(t)?.value===","?1:0)],m=t=>e=>t.report({node:e,messageId:"remove",data:{subject:e.key.name},fix:n=>n.removeRange(l(e,t))}),x=r.ESLintUtils.RuleCreator.withoutDocs({meta:{type:"problem",fixable:"code",schema:[],messages:{change:"change {{ subject }} from {{ from }} to {{ to }}",add:"add {{ subject }} to {{ to }}",move:"move {{ subject }} to {{ to }}",remove:"remove {{ subject }}"}},defaultOptions:[],create:t=>E({numericRange:m(t),optionalPropStyle:m(t),depicter:e=>{let[n,a]=e.params;if(n?.type!==r.AST_NODE_TYPES.Identifier)return;let o=n.name;if(a?.type!==r.AST_NODE_TYPES.ObjectPattern)return;let p=a.properties.find(s=>s.type===r.AST_NODE_TYPES.Property&&s.key.type===r.AST_NODE_TYPES.Identifier&&s.key.name==="next");t.report({node:e,messageId:"change",data:{subject:"arguments",from:`[${o}, { next, ...rest }]`,to:`[{ zodSchema: ${o}, jsonSchema }, { ...rest }]`},fix:s=>{let c=[s.replaceText(n,`{ zodSchema: ${o}, jsonSchema }`)];return p&&c.push(s.removeRange(l(p,t))),c}})},nextCall:e=>t.report({node:e,messageId:"change",data:{subject:"statement",from:"next()",to:"jsonSchema"},fix:n=>n.replaceText(e,"jsonSchema")}),zod:e=>t.report({node:e.source,messageId:"change",data:{subject:"import",from:"zod",to:"zod/v4"},fix:n=>n.replaceText(e.source,'"zod/v4"')}),ezFile:e=>{let[n]=e.arguments,a=n.value==="buffer"?"ez.buffer()":n.value==="base64"?"z.base64()":n.value==="binary"?"ez.buffer().or(z.string())":"z.string()";t.report({node:e,messageId:"change",data:{subject:"schema",from:"ez.file()",to:a},fix:o=>o.replaceText(e,a)})}})}),b={rules:{v24:x}};

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+
+/**
+ * @desc ESLint plugin for migrating to this version (from previous), requires eslint v9 and typescript-eslint v8
+ * @deprecated Single-use tool that can be removed and changed regardless SemVer. Remember to delete it after use.
+ * @example
+ *          // eslint.config.mjs:
+ *          import parser from "@typescript-eslint/parser";
+ *          import migration from "express-zod-api/migration";
+ *          export default [
+ *            { languageOptions: {parser}, plugins: {migration} },
+ *            { files: ["**\/*.ts"], rules: { "migration/v24": "error" } }
+ *          ];
+ * */
+declare const _default: {
+    rules: {
+        v24: ESLintUtils.RuleModule<"change" | "add" | "move" | "remove", [], unknown, ESLintUtils.RuleListener>;
+    };
+};
+
+export = _default;

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+
+/**
+ * @desc ESLint plugin for migrating to this version (from previous), requires eslint v9 and typescript-eslint v8
+ * @deprecated Single-use tool that can be removed and changed regardless SemVer. Remember to delete it after use.
+ * @example
+ *          // eslint.config.mjs:
+ *          import parser from "@typescript-eslint/parser";
+ *          import migration from "express-zod-api/migration";
+ *          export default [
+ *            { languageOptions: {parser}, plugins: {migration} },
+ *            { files: ["**\/*.ts"], rules: { "migration/v24": "error" } }
+ *          ];
+ * */
+declare const _default: {
+    rules: {
+        v24: ESLintUtils.RuleModule<"change" | "add" | "move" | "remove", [], unknown, ESLintUtils.RuleListener>;
+    };
+};
+
+export { _default as default };

package/dist/index.js

@@ -0,0 +1 @@
+import{ESLintUtils as l,AST_NODE_TYPES as t}from"@typescript-eslint/utils";var u={numericRange:`${t.NewExpression}[callee.name='Documentation'] > ${t.ObjectExpression} > ${t.Property}[key.name='numericRange']`,optionalPropStyle:`${t.NewExpression}[callee.name='Integration'] > ${t.ObjectExpression} > ${t.Property}[key.name='optionalPropStyle']`,depicter:`${t.VariableDeclarator}[id.typeAnnotation.typeAnnotation.typeName.name='Depicter'] > ${t.ArrowFunctionExpression}`,nextCall:`${t.VariableDeclarator}[id.typeAnnotation.typeAnnotation.typeName.name='Depicter'] > ${t.ArrowFunctionExpression} ${t.CallExpression}[callee.name='next']`,zod:`${t.ImportDeclaration}[source.value='zod']`,ezFile:`${t.CallExpression}[arguments.0.type='${t.Literal}']:has( ${t.MemberExpression}[object.name='ez'][property.name='file'] )`},S=r=>Object.keys(r).reduce((e,n)=>Object.assign(e,{[u[n]]:r[n]}),{}),m=(r,e)=>[r.range[0],r.range[1]+(e.sourceCode.getTokenAfter(r)?.value===","?1:0)],c=r=>e=>r.report({node:e,messageId:"remove",data:{subject:e.key.name},fix:n=>n.removeRange(m(e,r))}),d=l.RuleCreator.withoutDocs({meta:{type:"problem",fixable:"code",schema:[],messages:{change:"change {{ subject }} from {{ from }} to {{ to }}",add:"add {{ subject }} to {{ to }}",move:"move {{ subject }} to {{ to }}",remove:"remove {{ subject }}"}},defaultOptions:[],create:r=>S({numericRange:c(r),optionalPropStyle:c(r),depicter:e=>{let[n,a]=e.params;if(n?.type!==t.Identifier)return;let s=n.name;if(a?.type!==t.ObjectPattern)return;let i=a.properties.find(o=>o.type===t.Property&&o.key.type===t.Identifier&&o.key.name==="next");r.report({node:e,messageId:"change",data:{subject:"arguments",from:`[${s}, { next, ...rest }]`,to:`[{ zodSchema: ${s}, jsonSchema }, { ...rest }]`},fix:o=>{let p=[o.replaceText(n,`{ zodSchema: ${s}, jsonSchema }`)];return i&&p.push(o.removeRange(m(i,r))),p}})},nextCall:e=>r.report({node:e,messageId:"change",data:{subject:"statement",from:"next()",to:"jsonSchema"},fix:n=>n.replaceText(e,"jsonSchema")}),zod:e=>r.report({node:e.source,messageId:"change",data:{subject:"import",from:"zod",to:"zod/v4"},fix:n=>n.replaceText(e.source,'"zod/v4"')}),ezFile:e=>{let[n]=e.arguments,a=n.value==="buffer"?"ez.buffer()":n.value==="base64"?"z.base64()":n.value==="binary"?"ez.buffer().or(z.string())":"z.string()";r.report({node:e,messageId:"change",data:{subject:"schema",from:"ez.file()",to:a},fix:s=>s.replaceText(e,a)})}})}),g={rules:{v24:d}};export{g as default};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@express-zod-api/migration",
+  "version": "24.0.0-beta.1",
+  "license": "MIT",
+  "description": "Migration scripts for express-zod-api",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RobinTail/express-zod-api.git"
+  },
+  "author": {
+    "name": "Anna Bocharova",
+    "url": "https://robintail.cz",
+    "email": "me@robintail.cz"
+  },
+  "bugs": "https://github.com/RobinTail/express-zod-api/issues",
+  "funding": "https://github.com/sponsors/RobinTail",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.cts",
+  "module": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "*.md"
+  ],
+  "peerDependencies": {
+    "typescript-eslint": "^8.0.0",
+    "eslint": "^9.0.0"
+  },
+  "devDependencies": {
+    "@typescript-eslint/rule-tester": "^8.34.0"
+  },
+  "scripts": {
+    "pretest": "tsc --noEmit",
+    "test": "vitest run --globals",
+    "build": "tsup",
+    "postbuild": "attw --pack"
+  }
+}