@gatwech/core 1.0.0-beta.19 → 1.0.0-beta.21

package/dist/api/index.d.mts

@@ -1,3 +1,3 @@
-import { a as optionsMiddleware, i as createAuthMiddleware, n as AuthMiddleware, r as createAuthEndpoint, t as AuthEndpoint } from "../index-Df0KhQRf.mjs";
+import { a as optionsMiddleware, i as createAuthMiddleware, n as AuthMiddleware, r as createAuthEndpoint, t as AuthEndpoint } from "../index-BL_t8cRp.mjs";
 import "../index-CNtOUpmF.mjs";
 export { AuthEndpoint, AuthMiddleware, createAuthEndpoint, createAuthMiddleware, optionsMiddleware };

package/dist/context/index.d.mts

@@ -1,4 +1,4 @@
-import { d as AuthContext, nt as DBAdapter, st as DBTransactionAdapter } from "../index-Df0KhQRf.mjs";
+import { d as AuthContext, nt as DBAdapter, st as DBTransactionAdapter } from "../index-BL_t8cRp.mjs";
 import "../index-CNtOUpmF.mjs";
 import { t as AsyncLocalStorage } from "../index-CRg-E-VF.mjs";
 import { EndpointContext, InputContext } from "better-call";

package/dist/db/adapter/index.d.mts

@@ -1,3 +1,3 @@
-import { at as DBAdapterInstance, ct as Where, et as CleanedWhere, it as DBAdapterFactoryConfig, nt as DBAdapter, ot as DBAdapterSchemaCreation, rt as DBAdapterDebugLogOption, st as DBTransactionAdapter, tt as CustomAdapter } from "../../index-Df0KhQRf.mjs";
+import { at as DBAdapterInstance, ct as Where, et as CleanedWhere, it as DBAdapterFactoryConfig, nt as DBAdapter, ot as DBAdapterSchemaCreation, rt as DBAdapterDebugLogOption, st as DBTransactionAdapter, tt as CustomAdapter } from "../../index-BL_t8cRp.mjs";
 import "../../index-CNtOUpmF.mjs";
 export { CleanedWhere, CustomAdapter, DBAdapter, DBAdapterDebugLogOption, DBAdapterFactoryConfig, DBAdapterInstance, DBAdapterSchemaCreation, DBTransactionAdapter, Where };

package/dist/db/index.d.mts

@@ -1,3 +1,3 @@
-import { At as DBPreservedModels, Ct as rateLimitSchema, Dt as DBFieldAttribute, Et as PayvoAuthPluginDBSchema, Mt as PayvoAuthDBSchema, Nt as SecondaryStorage, Ot as DBFieldAttributeConfig, St as RateLimit, Tt as accountSchema, _t as User, bt as Session, dt as FieldAttributeConfig, ft as FieldType, gt as verificationSchema, ht as Verification, jt as DBPrimitive, kt as DBFieldType, lt as AuthPluginSchema, mt as Primitive, pt as PayvoAuthDbSchema, ut as FieldAttribute, vt as userSchema, wt as Account, xt as sessionSchema, yt as coreSchema } from "../index-Df0KhQRf.mjs";
+import { At as DBPreservedModels, Ct as rateLimitSchema, Dt as DBFieldAttribute, Et as PayvoAuthPluginDBSchema, Mt as PayvoAuthDBSchema, Nt as SecondaryStorage, Ot as DBFieldAttributeConfig, St as RateLimit, Tt as accountSchema, _t as User, bt as Session, dt as FieldAttributeConfig, ft as FieldType, gt as verificationSchema, ht as Verification, jt as DBPrimitive, kt as DBFieldType, lt as AuthPluginSchema, mt as Primitive, pt as PayvoAuthDbSchema, ut as FieldAttribute, vt as userSchema, wt as Account, xt as sessionSchema, yt as coreSchema } from "../index-BL_t8cRp.mjs";
 import "../index-CNtOUpmF.mjs";
 export { Account, AuthPluginSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPreservedModels, DBPrimitive, FieldAttribute, FieldAttributeConfig, FieldType, PayvoAuthDBSchema, PayvoAuthDbSchema, PayvoAuthPluginDBSchema, Primitive, RateLimit, SecondaryStorage, Session, User, Verification, accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema };

package/dist/env/index.mjs

@@ -1,3 +1,3 @@
-import { a as shouldPublishLog, c as env, d as isDevelopment, f as isProduction, i as logger, l as getBooleanEnvVar, m as nodeENV, n as createLogger, o as getColorDepth, p as isTest, r as levels, s as ENV, t as TTY_COLORS, u as getEnvVar } from "../env-ubiqEEZm.mjs";
+import { a as shouldPublishLog, c as env, d as isDevelopment, f as isProduction, i as logger, l as getBooleanEnvVar, m as nodeENV, n as createLogger, o as getColorDepth, p as isTest, r as levels, s as ENV, t as TTY_COLORS, u as getEnvVar } from "../env-BL9S5k9_.mjs";
 
 export { ENV, TTY_COLORS, createLogger, env, getBooleanEnvVar, getColorDepth, getEnvVar, isDevelopment, isProduction, isTest, levels, logger, nodeENV, shouldPublishLog };

package/dist/error/index.mjs

@@ -1,4 +1,4 @@
-import "../utils-CTOwq_Nj.mjs";
-import { n as BASE_ERROR_CODES, t as PayvoAuthError } from "../error-DKIIiFmH.mjs";
+import "../utils-BFQCAfNW.mjs";
+import { n as BASE_ERROR_CODES, t as PayvoAuthError } from "../error-41YsFQ8b.mjs";
 
 export { BASE_ERROR_CODES, PayvoAuthError };

package/dist/{error-DKIIiFmH.mjs → error-41YsFQ8b.mjs}

@@ -1,4 +1,4 @@
-import { t as defineErrorCodes } from "./utils-CTOwq_Nj.mjs";
+import { t as defineErrorCodes } from "./utils-BFQCAfNW.mjs";
 
 //#region src/error/codes.ts
 const BASE_ERROR_CODES = defineErrorCodes({

package/dist/{index-Df0KhQRf.d.mts → index-BL_t8cRp.d.mts}

@@ -121,7 +121,7 @@ interface SecondaryStorage {
    * @param key - Key to get
    * @returns - Value of the key
    */
-  get: (key: string) => Awaitable$1<unknown>;
+  get: (key: string) => Awaitable<unknown>;
   /**
    * Atomically get a value and delete it from storage.
    *
@@ -133,7 +133,7 @@ interface SecondaryStorage {
    * breaking release, or require database-backed verification storage for
    * security-sensitive consume paths.
    */
-  getAndDelete?: (key: string) => Awaitable$1<unknown>;
+  getAndDelete?: (key: string) => Awaitable<unknown>;
   /**
    * Atomically increment the counter at `key` by one, returning the
    * post-increment value.
@@ -148,7 +148,7 @@ interface SecondaryStorage {
    * this required for secondary-storage-backed rate limiting in the next minor
    * on `next`.
    */
-  increment?: (key: string, ttl: number) => Awaitable$1<number>;
+  increment?: (key: string, ttl: number) => Awaitable<number>;
   set: (
   /**
    * Key to store
@@ -161,12 +161,12 @@ interface SecondaryStorage {
   /**
    * Time to live in seconds
    */
-  ttl?: number | undefined) => Awaitable$1<void | null | unknown>;
+  ttl?: number | undefined) => Awaitable<void | null | unknown>;
   /**
    *
    * @param key - Key to delete
    */
-  delete: (key: string) => Awaitable$1<void | null | string>;
+  delete: (key: string) => Awaitable<void | null | string>;
 }
 //#endregion
 //#region src/db/plugin.d.ts
@@ -1078,8 +1078,8 @@ type PayvoAuthCookies = {
 //#endregion
 //#region src/types/helper.d.ts
 type Primitive = string | number | symbol | bigint | boolean | null | undefined;
-type Awaitable$1<T> = T | Promise<T>;
-type AwaitableFunction<T> = T | (() => Awaitable$1<T>);
+type Awaitable<T> = T | Promise<T>;
+type AwaitableFunction<T> = T | (() => Awaitable<T>);
 type LiteralString = "" | (string & Record<never, never>);
 type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
 type Prettify<T> = { [K in keyof T]: T[K] } & {};
@@ -1387,7 +1387,7 @@ type SocialProviders = { [K in SocialProviderList[number]]?: Parameters<(typeof
 type SocialProviderList = typeof socialProviderList;
 //#endregion
 //#region src/types/plugin.d.ts
-type Awaitable<T> = T | Promise<T>;
+type Awaitable$1<T> = T | Promise<T>;
 type DeepPartial<T> = T extends Function ? T : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;
 type HookEndpointContext = Partial<EndpointContext<string, any> & Omit<InputContext<string, any>, "method">> & {
   path: string;
@@ -1403,7 +1403,7 @@ type PayvoAuthPlugin = {
    * The init function is called when the plugin is initialized.
    * You can return a new context or modify the existing context.
    */
-  init?: ((ctx: AuthContext) => Awaitable<{
+  init?: ((ctx: AuthContext) => Awaitable$1<{
     context?: DeepPartial<Omit<AuthContext, "options">>;
     options?: Partial<PayvoAuthOptions>;
   }> | void | Promise<void>) | undefined;
@@ -1624,6 +1624,27 @@ type PayvoAuthAdvancedOptions = {
    * Payvo Auth. And could lead to security vulnerabilities.
    */
   disableOriginCheck?: boolean | undefined;
+  /**
+   * Run deferred work, such as sending events to a remote service, after the
+   * response is sent. On serverless platforms, pass the platform's hook so
+   * the function stays alive until the work finishes.
+   *
+   * @example
+   * // Vercel
+   * import { waitUntil } from "@vercel/functions";
+   * advanced: { backgroundTasks: { handler: waitUntil } }
+   *
+   * @example
+   * // Cloudflare Workers, with the execution context kept in AsyncLocalStorage
+   * advanced: {
+   *   backgroundTasks: {
+   *     handler: (promise) => executionContext.getStore()?.waitUntil(promise),
+   *   },
+   * }
+   */
+  backgroundTasks?: {
+    handler: (promise: Promise<unknown>) => void;
+  } | undefined;
   /**
    * Configure cookies to be cross subdomains
    */
@@ -2369,9 +2390,10 @@ type PayvoAuthOptions = {
           data: Optional<User & Record<string, any>>;
         }>;
         /**
-         * Hook that is called after a user is updated.
+         * Hook that is called after a user is updated. `data` holds the
+         * fields that were written, after every `before` hook ran.
          */
-        after?: (user: User & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+        after?: (user: User & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<User> & Record<string, unknown>) => Promise<void>;
       };
       delete?: {
         /**
@@ -2416,9 +2438,10 @@ type PayvoAuthOptions = {
           data: Optional<Session & Record<string, any>>;
         }>;
         /**
-         * Hook that is called after a session is updated.
+         * Hook that is called after a session is updated. `data` holds the
+         * fields that were written, after every `before` hook ran.
          */
-        after?: (session: Session & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+        after?: (session: Session & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<Session> & Record<string, unknown>) => Promise<void>;
       };
       delete?: {
         /**
@@ -2463,9 +2486,10 @@ type PayvoAuthOptions = {
           data: Optional<Account & Record<string, any>>;
         }>;
         /**
-         * Hook that is called after a account is updated.
+         * Hook that is called after a account is updated. `data` holds the
+         * fields that were written, after every `before` hook ran.
          */
-        after?: (account: Account & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+        after?: (account: Account & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<Account> & Record<string, unknown>) => Promise<void>;
       };
       delete?: {
         /**
@@ -2507,9 +2531,11 @@ type PayvoAuthOptions = {
           data: Optional<Verification & Record<string, any>>;
         }>;
         /**
-         * Hook that is called after a verification is updated.
+         * Hook that is called after a verification is updated. `data`
+         * holds the fields that were written, after every `before` hook
+         * ran.
          */
-        after?: (verification: Verification & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+        after?: (verification: Verification & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<Verification> & Record<string, unknown>) => Promise<void>;
       };
       delete?: {
         /**
@@ -2793,6 +2819,19 @@ type AuthContext<Options extends PayvoAuthOptions = PayvoAuthOptions> = {
    * @default false
    */
   skipCSRFCheck: boolean;
+  /**
+   * Runs work after the response without blocking it, e.g. sending an
+   * event to a remote service.
+   *
+   * This is inferred from the `options.advanced?.backgroundTasks?.handler`
+   * option. Without one, the promise runs on its own.
+   */
+  runInBackground: (promise: Promise<unknown>) => void;
+  /**
+   * Runs work in the background when `advanced.backgroundTasks` is
+   * configured, and awaits it otherwise, for work that must finish
+   */
+  runInBackgroundOrAwait: (promise: Promise<unknown> | void) => Awaitable<unknown>;
 };
 //#endregion
 //#region src/types/plugin-client.d.ts
@@ -2999,4 +3038,4 @@ declare const createAuthEndpoint: <Path extends string, Opts extends EndpointOpt
 type AuthEndpoint = ReturnType<typeof createAuthEndpoint>;
 type AuthMiddleware = ReturnType<typeof createAuthMiddleware>;
 //#endregion
-export { ProviderOptions as $, GithubProfile as A, DBPreservedModels as At, createAuthorizationCodeRequest as B, SocialProviders as C, rateLimitSchema as Ct, GoogleProfile as D, DBFieldAttribute as Dt, GoogleOptions as E, PayvoAuthPluginDBSchema as Et, LiteralUnion as F, createRefreshAccessTokenRequest as G, validateToken as H, Prettify as I, clientCredentialsToken as J, refreshAccessToken as K, Primitive as L, Awaitable$1 as M, PayvoAuthDBSchema as Mt, AwaitableFunction as N, SecondaryStorage as Nt, google as O, DBFieldAttributeConfig as Ot, LiteralString as P, OAuthProvider as Q, UnionToIntersection as R, SocialProviderListEnum as S, RateLimit as St, socialProviders as T, accountSchema as Tt, generateCodeChallenge as U, validateAuthorizationCode as V, getOAuth2Tokens as W, OAuth2Tokens as X, createClientCredentialsTokenRequest as Y, OAuth2UserInfo as Z, PayvoAuthRateLimitOptions as _, User as _t, optionsMiddleware as a, DBAdapterInstance as at, SocialProvider as b, Session as bt, ClientStore as c, Where as ct, AuthContext as d, FieldAttributeConfig as dt, CleanedWhere as et, GenericEndpointContext as f, FieldType as ft, PayvoAuthOptions as g, verificationSchema as gt, PayvoAuthAdvancedOptions as h, Verification as ht, createAuthMiddleware as i, DBAdapterFactoryConfig as it, github as j, DBPrimitive as jt, GithubOptions as k, DBFieldType as kt, PayvoAuthClientOptions as l, AuthPluginSchema as lt, GenerateIdFn as m, Primitive$1 as mt, AuthMiddleware as n, DBAdapter as nt, StandardSchemaV1$1 as o, DBAdapterSchemaCreation as ot, InternalAdapter as p, PayvoAuthDbSchema as pt, createAuthorizationURL as q, createAuthEndpoint as r, DBAdapterDebugLogOption as rt, ClientAtomListener as s, DBTransactionAdapter as st, AuthEndpoint as t, CustomAdapter as tt, PayvoAuthClientPlugin as u, FieldAttribute as ut, HookEndpointContext as v, userSchema as vt, socialProviderList as w, Account as wt, SocialProviderList as x, sessionSchema as xt, PayvoAuthPlugin as y, coreSchema as yt, PayvoAuthCookies as z };
+export { ProviderOptions as $, GithubProfile as A, DBPreservedModels as At, createAuthorizationCodeRequest as B, SocialProviders as C, rateLimitSchema as Ct, GoogleProfile as D, DBFieldAttribute as Dt, GoogleOptions as E, PayvoAuthPluginDBSchema as Et, LiteralUnion as F, createRefreshAccessTokenRequest as G, validateToken as H, Prettify as I, clientCredentialsToken as J, refreshAccessToken as K, Primitive as L, Awaitable as M, PayvoAuthDBSchema as Mt, AwaitableFunction as N, SecondaryStorage as Nt, google as O, DBFieldAttributeConfig as Ot, LiteralString as P, OAuthProvider as Q, UnionToIntersection as R, SocialProviderListEnum as S, RateLimit as St, socialProviders as T, accountSchema as Tt, generateCodeChallenge as U, validateAuthorizationCode as V, getOAuth2Tokens as W, OAuth2Tokens as X, createClientCredentialsTokenRequest as Y, OAuth2UserInfo as Z, PayvoAuthRateLimitOptions as _, User as _t, optionsMiddleware as a, DBAdapterInstance as at, SocialProvider as b, Session as bt, ClientStore as c, Where as ct, AuthContext as d, FieldAttributeConfig as dt, CleanedWhere as et, GenericEndpointContext as f, FieldType as ft, PayvoAuthOptions as g, verificationSchema as gt, PayvoAuthAdvancedOptions as h, Verification as ht, createAuthMiddleware as i, DBAdapterFactoryConfig as it, github as j, DBPrimitive as jt, GithubOptions as k, DBFieldType as kt, PayvoAuthClientOptions as l, AuthPluginSchema as lt, GenerateIdFn as m, Primitive$1 as mt, AuthMiddleware as n, DBAdapter as nt, StandardSchemaV1$1 as o, DBAdapterSchemaCreation as ot, InternalAdapter as p, PayvoAuthDbSchema as pt, createAuthorizationURL as q, createAuthEndpoint as r, DBAdapterDebugLogOption as rt, ClientAtomListener as s, DBTransactionAdapter as st, AuthEndpoint as t, CustomAdapter as tt, PayvoAuthClientPlugin as u, FieldAttribute as ut, HookEndpointContext as v, userSchema as vt, socialProviderList as w, Account as wt, SocialProviderList as x, sessionSchema as xt, PayvoAuthPlugin as y, coreSchema as yt, PayvoAuthCookies as z };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { F as LiteralUnion, I as Prettify, L as Primitive, M as Awaitable, N as AwaitableFunction, P as LiteralString, R as UnionToIntersection, _ as PayvoAuthRateLimitOptions, c as ClientStore, d as AuthContext, f as GenericEndpointContext, g as PayvoAuthOptions, h as PayvoAuthAdvancedOptions, l as PayvoAuthClientOptions, m as GenerateIdFn, o as StandardSchemaV1, p as InternalAdapter, s as ClientAtomListener, u as PayvoAuthClientPlugin, v as HookEndpointContext, y as PayvoAuthPlugin, z as PayvoAuthCookies } from "./index-Df0KhQRf.mjs";
+import { F as LiteralUnion, I as Prettify, L as Primitive, M as Awaitable, N as AwaitableFunction, P as LiteralString, R as UnionToIntersection, _ as PayvoAuthRateLimitOptions, c as ClientStore, d as AuthContext, f as GenericEndpointContext, g as PayvoAuthOptions, h as PayvoAuthAdvancedOptions, l as PayvoAuthClientOptions, m as GenerateIdFn, o as StandardSchemaV1, p as InternalAdapter, s as ClientAtomListener, u as PayvoAuthClientPlugin, v as HookEndpointContext, y as PayvoAuthPlugin, z as PayvoAuthCookies } from "./index-BL_t8cRp.mjs";
 import "./index-CNtOUpmF.mjs";
 export { AuthContext, Awaitable, AwaitableFunction, ClientAtomListener, ClientStore, GenerateIdFn, GenericEndpointContext, HookEndpointContext, InternalAdapter, LiteralString, LiteralUnion, PayvoAuthAdvancedOptions, PayvoAuthClientOptions, PayvoAuthClientPlugin, PayvoAuthCookies, PayvoAuthOptions, PayvoAuthPlugin, PayvoAuthRateLimitOptions, Prettify, Primitive, StandardSchemaV1, UnionToIntersection };

package/dist/oauth2/index.d.mts

@@ -1,3 +1,3 @@
-import { $ as ProviderOptions, B as createAuthorizationCodeRequest, G as createRefreshAccessTokenRequest, H as validateToken, J as clientCredentialsToken, K as refreshAccessToken, Q as OAuthProvider, U as generateCodeChallenge, V as validateAuthorizationCode, W as getOAuth2Tokens, X as OAuth2Tokens, Y as createClientCredentialsTokenRequest, Z as OAuth2UserInfo, q as createAuthorizationURL } from "../index-Df0KhQRf.mjs";
+import { $ as ProviderOptions, B as createAuthorizationCodeRequest, G as createRefreshAccessTokenRequest, H as validateToken, J as clientCredentialsToken, K as refreshAccessToken, Q as OAuthProvider, U as generateCodeChallenge, V as validateAuthorizationCode, W as getOAuth2Tokens, X as OAuth2Tokens, Y as createClientCredentialsTokenRequest, Z as OAuth2UserInfo, q as createAuthorizationURL } from "../index-BL_t8cRp.mjs";
 import "../index-CNtOUpmF.mjs";
 export { OAuth2Tokens, OAuth2UserInfo, OAuthProvider, ProviderOptions, clientCredentialsToken, createAuthorizationCodeRequest, createAuthorizationURL, createClientCredentialsTokenRequest, createRefreshAccessTokenRequest, generateCodeChallenge, getOAuth2Tokens, refreshAccessToken, validateAuthorizationCode, validateToken };

package/dist/social-providers/index.d.mts

@@ -1,3 +1,3 @@
-import { A as GithubProfile, C as SocialProviders, D as GoogleProfile, E as GoogleOptions, O as google, S as SocialProviderListEnum, T as socialProviders, b as SocialProvider, j as github, k as GithubOptions, w as socialProviderList, x as SocialProviderList } from "../index-Df0KhQRf.mjs";
+import { A as GithubProfile, C as SocialProviders, D as GoogleProfile, E as GoogleOptions, O as google, S as SocialProviderListEnum, T as socialProviders, b as SocialProvider, j as github, k as GithubOptions, w as socialProviderList, x as SocialProviderList } from "../index-BL_t8cRp.mjs";
 import "../index-CNtOUpmF.mjs";
 export { GithubOptions, GithubProfile, GoogleOptions, GoogleProfile, SocialProvider, SocialProviderList, SocialProviderListEnum, SocialProviders, github, google, socialProviderList, socialProviders };

package/dist/social-providers/index.mjs

@@ -1,6 +1,6 @@
-import "../utils-CTOwq_Nj.mjs";
-import { t as PayvoAuthError } from "../error-DKIIiFmH.mjs";
-import { i as logger } from "../env-ubiqEEZm.mjs";
+import { i as logger } from "../env-BL9S5k9_.mjs";
+import "../utils-BFQCAfNW.mjs";
+import { t as PayvoAuthError } from "../error-41YsFQ8b.mjs";
 import { a as refreshAccessToken, n as validateAuthorizationCode, o as createAuthorizationURL } from "../oauth2-DyI7_CNv.mjs";
 import * as z$1 from "zod";
 import { betterFetch } from "@better-fetch/fetch";

package/dist/src/types/context.d.ts

@@ -4,7 +4,7 @@ import type { DBAdapter, Where } from "../db/adapter";
 import { createLogger } from "../env";
 import type { OAuthProvider } from "../oauth2";
 import type { PayvoAuthCookies } from "./cookie";
-import type { LiteralUnion } from "./helper";
+import type { Awaitable, LiteralUnion } from "./helper";
 import type { PayvoAuthOptions, PayvoAuthRateLimitOptions } from "./init-options";
 export type GenericEndpointContext<Options extends PayvoAuthOptions = PayvoAuthOptions> = EndpointContext<string, any> & {
     context: AuthContext<Options>;
@@ -173,5 +173,18 @@ export type AuthContext<Options extends PayvoAuthOptions = PayvoAuthOptions> = {
      * @default false
      */
     skipCSRFCheck: boolean;
+    /**
+     * Runs work after the response without blocking it, e.g. sending an
+     * event to a remote service.
+     *
+     * This is inferred from the `options.advanced?.backgroundTasks?.handler`
+     * option. Without one, the promise runs on its own.
+     */
+    runInBackground: (promise: Promise<unknown>) => void;
+    /**
+     * Runs work in the background when `advanced.backgroundTasks` is
+     * configured, and awaits it otherwise, for work that must finish
+     */
+    runInBackgroundOrAwait: (promise: Promise<unknown> | void) => Awaitable<unknown>;
 };
 export {};

package/dist/src/types/init-options.d.ts

@@ -137,6 +137,27 @@ export type PayvoAuthAdvancedOptions = {
      * Payvo Auth. And could lead to security vulnerabilities.
      */
     disableOriginCheck?: boolean | undefined;
+    /**
+     * Run deferred work, such as sending events to a remote service, after the
+     * response is sent. On serverless platforms, pass the platform's hook so
+     * the function stays alive until the work finishes.
+     *
+     * @example
+     * // Vercel
+     * import { waitUntil } from "@vercel/functions";
+     * advanced: { backgroundTasks: { handler: waitUntil } }
+     *
+     * @example
+     * // Cloudflare Workers, with the execution context kept in AsyncLocalStorage
+     * advanced: {
+     *   backgroundTasks: {
+     *     handler: (promise) => executionContext.getStore()?.waitUntil(promise),
+     *   },
+     * }
+     */
+    backgroundTasks?: {
+        handler: (promise: Promise<unknown>) => void;
+    } | undefined;
     /**
      * Configure cookies to be cross subdomains
      */
@@ -882,9 +903,10 @@ export type PayvoAuthOptions = {
                     data: Optional<User & Record<string, any>>;
                 }>;
                 /**
-                 * Hook that is called after a user is updated.
+                 * Hook that is called after a user is updated. `data` holds the
+                 * fields that were written, after every `before` hook ran.
                  */
-                after?: (user: User & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+                after?: (user: User & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<User> & Record<string, unknown>) => Promise<void>;
             };
             delete?: {
                 /**
@@ -929,9 +951,10 @@ export type PayvoAuthOptions = {
                     data: Optional<Session & Record<string, any>>;
                 }>;
                 /**
-                 * Hook that is called after a session is updated.
+                 * Hook that is called after a session is updated. `data` holds the
+                 * fields that were written, after every `before` hook ran.
                  */
-                after?: (session: Session & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+                after?: (session: Session & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<Session> & Record<string, unknown>) => Promise<void>;
             };
             delete?: {
                 /**
@@ -976,9 +999,10 @@ export type PayvoAuthOptions = {
                     data: Optional<Account & Record<string, any>>;
                 }>;
                 /**
-                 * Hook that is called after a account is updated.
+                 * Hook that is called after a account is updated. `data` holds the
+                 * fields that were written, after every `before` hook ran.
                  */
-                after?: (account: Account & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+                after?: (account: Account & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<Account> & Record<string, unknown>) => Promise<void>;
             };
             delete?: {
                 /**
@@ -1020,9 +1044,11 @@ export type PayvoAuthOptions = {
                     data: Optional<Verification & Record<string, any>>;
                 }>;
                 /**
-                 * Hook that is called after a verification is updated.
+                 * Hook that is called after a verification is updated. `data`
+                 * holds the fields that were written, after every `before` hook
+                 * ran.
                  */
-                after?: (verification: Verification & Record<string, unknown>, context?: GenericEndpointContext) => Promise<void>;
+                after?: (verification: Verification & Record<string, unknown>, context?: GenericEndpointContext, data?: Partial<Verification> & Record<string, unknown>) => Promise<void>;
             };
             delete?: {
                 /**

package/dist/utils/index.mjs

@@ -1,3 +1,3 @@
-import { t as defineErrorCodes } from "../utils-CTOwq_Nj.mjs";
+import { t as defineErrorCodes } from "../utils-BFQCAfNW.mjs";
 
 export { defineErrorCodes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gatwech/core",
-  "version": "1.0.0-beta.19",
+  "version": "1.0.0-beta.21",
   "description": "",
   "type": "module",
   "publishConfig": {