wasp/waspc/ChangeLog.md

Changelog

v0.x.x.x (TBD)

[NEW FEATURE] Dockerfile customization

You can now customize the default Wasp Dockerfile by either extending/replacing our build stages or using your own custom logic. To make use of this feature, simply add a Dockerfile to the root of your project and it will be appended to the bottom of the existing Wasp Dockerfile.

v0.6.0.0 (2022/09/29)

BREAKING CHANGES

• The EmailAndPassword auth method has been renamed usernameAndPassword to better reflect the current usage. Email validation will be addressed in the future.
  • This means the auth.userEntity model should now have field called username (instead of email, as before).
    • If you'd like to treat the old email field as username, you can create a migration file like so:

      $ cd migrations
      $ mkdir "migrations/`date -n +%Y%m%d%H%M%S`_some_name" && touch $_/migration.sql
      

      You can then add contents like the following:

        -- Drop the old index (NOTE: name may vary based on Prisma version)
      DROP INDEX "User_email_key";
      
      -- Alter the table to rename the column, thus preserving the data
      ALTER TABLE "User"
      RENAME COLUMN "email" TO "username";
      
      -- Create a new index
      CREATE UNIQUE INDEX "User_username_key" ON "User"("username");
      

      • NOTE: If you simply changed email to username in your .wasp file, Prisma will try to drop the table and recreate it, which is likely not what you want if you have data you want to preserve.
    • If you would like to add a new username column and keep email as is, be sure to add a calculated value in the migration (perhaps a random string, or something based on the email). The username column should remain NOT NULL and UNIQUE.
• WASP_WEB_CLIENT_URL is now a required environment variable to improve CORS security. It is set by default in development. In production, this should point to the URL where your frontend app is being hosted.
• The generated Dockerfile has been updated from node:14-alpine to node:16-alpine.
• Wasp Jobs callback function arguments have been updated to the following: async function jobHandler(args, context). Jobs can now make use of entities, accessed via context, like Operations. Additionally, the data passed into the Job handler function are no longer wrapped in a data property, and are now instead accessed exactly as they are supplied via args.
• React got updated to React 17.

[NEW FEATURE] Google is now a supported authentication method!

You can now offer your users the ability to sign in with Google! Enabling it is just a few lines and offers a fast, easy, and secure way to get users into your app! We also have a comprehensive setup guide for creating a new app in the Google Developer Console.

Stay tuned, as more external auth methods will be added in the future. Let us know what you'd like to see support for next!

[NEW FEATURE] Wasp Language Server

Now, your installation of Wasp also brings Wasp language server with it! This means live error reporting in Wasp files in supported IDEs (currently only VSCode).

Make sure to update your Wasp VSCode extension to get the benefits of Wasp Language Server.

[NEW FEATURE] Optimistic updates via useAction hook

We added useAction hook to our JS API, which allows you to specify optimistic update details for an Action. This means that, if you have a good idea of how an Action will affect the state on the client, you can perform those changes immediatelly upon its call (instead of waiting for Action to finish), by modifying what specific Queries currently return. Once Action is actually done, related Queries will be unvalidated as usual and therefore fetch the real result, but in the meantime the changes you specified via optimistic updates will be visible.

This is great for apps where there is a lot of interactivity and you want the UI to update instantly with your changes, even as they are still being saved to the server.

Check out https://wasp-lang.dev/docs/language/features#the-useaction-hook for more details.

Bug fixes

• Works around a sodium-native bug (used by a Wasp dependency, secure-password) that caused signup/login runtime issues with Heroku deployments by downgrading it from v3.4.1 to v3.3.0 via a package.json override. Ref: https://github.com/sodium-friends/sodium-native/issues/160
• Improved warnings by Wasp to do database migration -> now there are less false positives.

---

v0.5.2.1 (2022/07/14)

Bug fixes

• Made wasp CLI more robust regarding encoding used on the machine.
• Worked around the bug in latest npm, so that Wasp now again supports latest LTS npm version.

---

v0.5.2.0 (2022/06/23)

Upgraded Prisma to latest version (13.15.2)

Among various other things, this brins support for OpenSSL3. So if you couldn't run Wasp on your operating system due to Prisma not supporting OpenSSL3, those days are over!

---

v0.5.1.0 (2022/06/17)

[NEW FEATURES]

• There is now app.client.setup function in .wasp that you can use to define custom setup you want to do on client before on its initialization.
• You can now configure the React Query's QueryClient by calling special function exposed by Wasp in your JS (in app.client.setup).

Various improvements and bug fixes

• Limited Wasp node version to <=16.15.0 for now, since there is a problem with later versions and how Wasp uses npx.
• Reduced some of the redundant warning messages in Wasp CLI.
• Fixed unresponsive UI on server reload.

---

v0.5.0.0 (2022/05/18)

[NEW FEATURE] Wasp now has support for running Jobs!

If you have server tasks that you do not want to handle as part of the normal request-response cycle, now Wasp allows you to make that function a Job and it will gain some "superpowers"!

Jobs will persist between server restarts, can be retried if they fail, and they can even be delayed until the future (or have a recurring schedule)!

Some examples where you may want to use a Job on the server include sending an email, making an HTTP request to some external API, or doing some nightly calculations.

To run Jobs, you don't need any additional infrastructure at the moment, just a Postgre database that you anyway need to deploy Wasp to production.

BREAKING CHANGES

• Wasp now requires latest LTS version of NodeJS
  • We had a bit of issues with being too relaxed on the version of NodeJS that can be used with Wasp so we thightened it up a bit. We also added a more thorough check in Wasp for it, that will warn you very explicitely if you are using the wrong version of Node.
• Updated react-query to v3
  • This brings some new features from react query while also laying the foundation for the further features we are building on top of it in Wasp (coming soon!).
• Updated python to python3 in Dockerfile generated upon wasp build.

Various improvements

• Finally fixed a bug with orphaned processes in development.
• Various other bug fixes, doc improvements, and refactorings.

---

v0.4.0.0 (2022/02/23)

[BREAKING CHANGE] Upgrading Prisma to version 3.9.1

We are happy to announce Wasp is now using a much newer version of Prisma! This change does not impact the Wasp DSL support for Prisma, but it does come with some caveats from Prisma based on your usage. Please see this note for any breaking changes: https://www.prisma.io/docs/guides/upgrade-guides/upgrading-versions/upgrading-to-prisma-3

Note: When you first migrate after upgrading, you will likely see a new migration created for 3.x specific features related to updating foreign keys and indexes.

Various improvements

• Automatically regenerating your Prisma client, as needed, based on your Prisma schema changes.
• Tracking your NPM project dependency changes and automatically invoking npm install, as needed, so you are always up to date.
• and more!

---

v0.3.0.0 (2022/02/04)

[BREAKING CHANGE] New Wasp-lang syntax!

Mostly it is very similar to what it was before, with some following bigger changes:

• auth, dependencies, and couple of other "singleton" delcarations now became part of app declaration.
• All declarations now need to have name, including route.
• route has different syntax.
• dependencies have different syntax.

For exact details about new syntax, check https://wasp-lang.dev/docs/language/syntax .

Various improvements

• Better compiler error messages.
• Nicer CLI output.
• Added delay on recompilation to avoid redundant recompiling.
• Added onAuthSucceededRedirectTo field in app.
• and more!

Unreleased changes