Open fwqaaq opened 5 months ago
This will be done with the entire ecosystem, not just the core library. We have to make sure that things stay consistent and compatible.
This requires a new build infrastructure. We still want to publish everything to npm
because as of 2024, that is still the go-to place for Node.js users.
It is currently unclear whether or not we are going to leverage the existing tools we built. We may also want to write a service called jsr2npm that
There are a lot of things to consider here, since people should be able to import grammY
and it should all just work with no further setup.
We might have to make the difficult decision to drop support for CJS, but since this commit we might just ship ESM without TLA and require CJS users to pass a flag until it is stable.
I advocate for writing a custom script that replaces imports with JSR ones, and vendors whatever cannot be replaced.
Which imports? Do you mean @std
?
This will be done with the entire ecosystem, not just the core library. We have to make sure that things stay consistent and compatible.
Yeah, the support of grammy for ESM is excellent, and JSR provides a very simple way to migrate: https://jsr.io/docs/migrate-x-to-jsr
Which imports? Do you mean
@std
?
@KnorpelSenf Yes, and grammY imports, of course.
I’m also unsure how JSR handles peer dependencies for Node.js, so I don’t think it’d be good to recommend it for Node.js users (maybe?).
It's pretty simple to download npm-ready tarball from jsr.
There is a special endpoint . For example:https://npm.jsr.io/@jsr/shevernitskiy__amo
outputs:
{
"name": "@jsr/shevernitskiy__amo",
"description": "This is a simple wrapper client for the amoCRM REST API. It covers almost all API modules and endpoints. Also, it manages to token refreshing and webhook handling.",
"dist-tags": {
"latest": "0.2.5"
},
"versions": {
"0.2.5": {
"name": "@jsr/shevernitskiy__amo",
"version": "0.2.5",
"description": "This is a simple wrapper client for the amoCRM REST API. It covers almost all API modules and endpoints. Also, it manages to token refreshing and webhook handling.",
"dist": {
"tarball": "https://npm.jsr.io/~/11/@jsr/shevernitskiy__amo/0.2.5.tgz",
"shasum": "04C2380FC1C556A52FA0A40FD3865A881550537D",
"integrity": "sha512-k/HilfYJb+hbTRfbdtZy2G//nOLSmk1VCfNrXDHjnyWyeq06KS5LzUns0zAghmVSMoPQJYTOSW0nIA6Y7hiYkg=="
},
"dependencies": {
}
},
"0.2.4": {
"name": "@jsr/shevernitskiy__amo",
"version": "0.2.4",
"description": "This is a simple wrapper client for the amoCRM REST API. It covers almost all API modules and endpoints. Also, it manages to token refreshing and webhook handling.",
"dist": {
"tarball": "https://npm.jsr.io/~/11/@jsr/shevernitskiy__amo/0.2.4.tgz",
"shasum": "39C6C73D454DE23A06E693F5A8E6308AB4084C01",
"integrity": "sha512-J1Vx1QduYjUXKe2vVcK7luL8znCOfo1DA+Tv1VG6CVRGfOUx3Z2/Yk7SBHV8HNTs/q77dSxxglIJWL40grEFIA=="
},
"dependencies": {
}
}
},
"time": {
"created": "2024-03-02T05:37:01.088Z",
"modified": "2024-03-03T05:14:15.443Z",
"0.2.5": "2024-04-11T05:02:50.177Z",
"0.2.4": "2024-03-02T05:37:10.149Z"
}
}
It contains all npm needs including package.json
:
_dist
contains d.ts files
Yep we're aware how JSR works, the pending question is just if we
a) download npm tarballs from JSR and upload them to npm, or b) build our own tool, potentially leveraging the build functionality of JSR, and package stuff in CI and upload it ourselves.
a) is much easier, but we depend on an API during build.
b) is harder but naturally more reliable.
I think it could be a
for start and then replaced for b
without any issues (if it will be needed). In CI it cloud be 1 or several steps.
I've noticed, that hono dev doing some work on this too:) https://github.com/honojs/hono/pull/2662
Btw, https://github.com/denoland/dnt allows to download a package and make it local in case of it can't be resolved as npm packcage. Also it supports shims and mappings like *.deno.ts
/ *.node.ts
as well as deno2node
and handles with jsr specifiers (https://github.com/denoland/dnt/pull/398).
So, we could prepare npm build with this tool and move to JSR imports in deno source code.
d2n
already does this for us. You're describing our current build setup, just with /x swapped out for jsr.
As I understand, d2n can't download packages and make it local when it can't be resolved as npm package.
It can do this, but I don't think we use that feature anyway.
If we can't get rid of custom build tooling, then we can switch to JSR immediately and close this issue. Moving to dnt
is not an option, this has been discussed extensively on numerous occasions. The only reason why we'd need to touch our tooling is if we can maybe drop everything and let JSR handle it, and all that's left for us to do is to download and re-upload.
I think I would like to go with the following approach:
api
crate from https://github.com/jsr-io/jsr/tree/main/api and then calling https://github.com/jsr-io/jsr/blob/4389058b3e80b647e3126fd84c005272d66e5348/api/src/tasks.rs#L71Do you want to spin up whole api and use endpoint or just get the tarball build code? Seems like the actual build code is here https://github.com/jsr-io/jsr/blob/main/api/src/analysis.rs#L434
Well, at least i want to try:D https://github.com/jsr-io/jsr/issues/525
Nice! I'd fork JSR and extract the things myself so that we can work with it. If they accept a contribution upstream, that's great, but I would not want to wait for that.
The best way to do this is to isolate the transpilation up to the point that we just need to provide a scope, a name, and a version, and receive a tarball.
You can use
npm
ordeno
to get packages from JSR.