chore: update versions (#2712)

This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.


# Releases
## @nhost/apollo@7.1.0

### Minor Changes

-   d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost/graphql-js@0.3.0

### Minor Changes

-   d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0

## @nhost/hasura-auth-js@2.5.0

### Minor Changes

-   d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0

## @nhost/react@3.5.0

### Minor Changes

-   d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost/vue@2.6.0

### Minor Changes

-   d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost/react-apollo@12.0.0

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/apollo@7.1.0
    -   @nhost/react@3.5.0

## @nhost/react-urql@9.0.0

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0

## @nhost/nextjs@2.1.14

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0

## @nhost/nhost-js@3.1.3

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/hasura-auth-js@2.5.0
    -   @nhost/graphql-js@0.3.0

## @nhost/dashboard@1.16.1

### Patch Changes

-   @nhost/react-apollo@12.0.0
-   @nhost/nextjs@2.1.14

## @nhost-examples/cli@0.3.5

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost-examples/codegen-react-apollo@0.4.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0
    -   @nhost/react-apollo@12.0.0

## @nhost-examples/codegen-react-query@0.4.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0

## @nhost-examples/codegen-react-urql@0.3.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0
    -   @nhost/react-urql@9.0.0

## @nhost-examples/multi-tenant-one-to-many@2.2.5

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost-examples/nextjs@0.3.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0
    -   @nhost/react-apollo@12.0.0
    -   @nhost/nextjs@2.1.14

## @nhost-examples/node-storage@0.2.5

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost-examples/nextjs-server-components@0.4.5

### Patch Changes

-   @nhost/nhost-js@3.1.3

## @nhost-examples/react-apollo@0.8.5

### Patch Changes

-   aef4a0a: fix: resolve e2e test issues
-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0
    -   @nhost/react-apollo@12.0.0

## @nhost-examples/react-gqty@1.2.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/react@3.5.0

## @nhost-examples/vue-apollo@0.6.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/apollo@7.1.0
    -   @nhost/vue@2.6.0
    -   @nhost/nhost-js@3.1.3

## @nhost-examples/vue-quickstart@0.2.5

### Patch Changes

-   Updated dependencies [d0c9f4c]
    -   @nhost/apollo@7.1.0
    -   @nhost/vue@2.6.0

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

dashboard/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @nhost/dashboard
 
+## 1.16.1
+
+### Patch Changes
+
+- @nhost/react-apollo@12.0.0
+- @nhost/nextjs@2.1.14
+
+## 1.16.0
+
+### Minor Changes
+
+- c6d5c5c: feat: add toggle switch to enable/disable public access in the database settings
+
+## 1.15.2
+
+### Patch Changes
+
+- @nhost/react-apollo@11.0.4
+- @nhost/nextjs@2.1.13
+
+## 1.15.1
+
+### Patch Changes
+
+- @nhost/react-apollo@11.0.3
+- @nhost/nextjs@2.1.12
+
 ## 1.15.0
 
 ### Minor Changes

dashboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/dashboard",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "private": true,
   "scripts": {
     "preinstall": "npx only-allow pnpm",

dashboard/src/features/database/settings/components/DatabaseConnectionInfo/DatabaseConnectionInfo.tsx

@@ -1,3 +1,7 @@
+import { ApplyLocalSettingsDialog } from '@/components/common/ApplyLocalSettingsDialog';
+import { useDialog } from '@/components/common/DialogProvider';
+import { useUI } from '@/components/common/UIProvider';
+import { Form } from '@/components/form/Form';
 import { SettingsContainer } from '@/components/layout/SettingsContainer';
 import { ActivityIndicator } from '@/components/ui/v2/ActivityIndicator';
 import { Alert } from '@/components/ui/v2/Alert';
@@ -7,11 +11,32 @@ import type { InputProps } from '@/components/ui/v2/Input';
 import { Input } from '@/components/ui/v2/Input';
 import { InputAdornment } from '@/components/ui/v2/InputAdornment';
 import { useCurrentWorkspaceAndProject } from '@/features/projects/common/hooks/useCurrentWorkspaceAndProject';
+import { useIsPlatform } from '@/features/projects/common/hooks/useIsPlatform';
 import { generateAppServiceUrl } from '@/features/projects/common/utils/generateAppServiceUrl';
+import { useLocalMimirClient } from '@/hooks/useLocalMimirClient';
 import { copy } from '@/utils/copy';
-import { useGetPostgresSettingsQuery } from '@/utils/__generated__/graphql';
+import { execPromiseWithErrorToast } from '@/utils/execPromiseWithErrorToast';
+import {
+  useGetPostgresSettingsQuery,
+  useUpdateConfigMutation,
+} from '@/utils/__generated__/graphql';
+import { yupResolver } from '@hookform/resolvers/yup';
+import { FormProvider, useForm } from 'react-hook-form';
+import * as Yup from 'yup';
+
+const databasePublicAccessValidationSchema = Yup.object({
+  enablePublicAccess: Yup.bool(),
+});
+
+type DatabasePublicAccessFormValues = Yup.InferType<
+  typeof databasePublicAccessValidationSchema
+>;
 
 export default function DatabaseConnectionInfo() {
+  const { openDialog } = useDialog();
+  const isPlatform = useIsPlatform();
+  const { maintenanceActive } = useUI();
+  const localMimirClient = useLocalMimirClient();
   const { currentProject } = useCurrentWorkspaceAndProject();
 
   const { data, loading, error } = useGetPostgresSettingsQuery({
@@ -19,6 +44,61 @@ export default function DatabaseConnectionInfo() {
     fetchPolicy: 'cache-only',
   });
 
+  const [updateConfig] = useUpdateConfigMutation({
+    ...(!isPlatform ? { client: localMimirClient } : {}),
+  });
+
+  const enablePublicAccess =
+    !!data?.config?.postgres?.resources?.enablePublicAccess;
+
+  const form = useForm<DatabasePublicAccessFormValues>({
+    reValidateMode: 'onSubmit',
+    defaultValues: {
+      enablePublicAccess,
+    },
+    resolver: yupResolver(databasePublicAccessValidationSchema),
+  });
+
+  async function handleSubmit(formValues: DatabasePublicAccessFormValues) {
+    const updateConfigPromise = updateConfig({
+      variables: {
+        appId: currentProject.id,
+        config: {
+          postgres: {
+            resources: {
+              enablePublicAccess: formValues.enablePublicAccess,
+            },
+          },
+        },
+      },
+    });
+
+    await execPromiseWithErrorToast(
+      async () => {
+        await updateConfigPromise;
+        form.reset(formValues);
+
+        if (!isPlatform) {
+          openDialog({
+            title: 'Apply your changes',
+            component: <ApplyLocalSettingsDialog />,
+            props: {
+              PaperProps: {
+                className: 'max-w-2xl',
+              },
+            },
+          });
+        }
+      },
+      {
+        loadingMessage: 'Database settings are being updated...',
+        successMessage: 'Database settings have been updated successfully.',
+        errorMessage:
+          "An error occurred while trying to update the project's database settings.",
+      },
+    );
+  }
+
   if (loading) {
     return (
       <ActivityIndicator
@@ -76,49 +156,72 @@ export default function DatabaseConnectionInfo() {
     },
   ];
 
-  return (
-    <SettingsContainer
-      title="Connection Info"
-      description="Connect directly to the Postgres database with this information."
-      slotProps={{ footer: { className: 'hidden' } }}
-      className="grid grid-cols-6 gap-4 pb-2"
-    >
-      {settingsDatabaseCustomInputs.map(
-        ({ name, label, className, value: inputValue }) => (
-          <Input
-            key={name}
-            label={label}
-            required
-            disabled
-            value={inputValue}
-            className={className}
-            slotProps={{ inputRoot: { className: '!pr-8 truncate' } }}
-            fullWidth
-            hideEmptyHelperText
-            endAdornment={
-              <InputAdornment position="end" className="absolute right-2">
-                <Button
-                  sx={{ minWidth: 0, padding: 0 }}
-                  color="secondary"
-                  variant="borderless"
-                  onClick={(e) => {
-                    e.stopPropagation();
-                    copy(inputValue as string, `${label}`);
-                  }}
-                >
-                  <CopyIcon className="h-4 w-4" />
-                </Button>
-              </InputAdornment>
-            }
-          />
-        ),
-      )}
+  const { formState } = form;
 
-      <Alert severity="info" className="col-span-6 text-left">
-        To connect to the Postgres database directly, generate a new password,
-        securely save it, and then modify your connection string with the newly
-        created password.
-      </Alert>
-    </SettingsContainer>
+  return (
+    <FormProvider {...form}>
+      <Form onSubmit={handleSubmit}>
+        <SettingsContainer
+          title="Public access"
+          description={
+            enablePublicAccess
+              ? 'Connect directly to the Postgres database with this information.'
+              : 'Enable public access to your Postgres database.'
+          }
+          slotProps={{
+            submitButton: {
+              disabled: !formState.isDirty || maintenanceActive,
+              loading: formState.isSubmitting,
+            },
+          }}
+          className="grid grid-cols-6 gap-4 pb-2"
+          switchId="enablePublicAccess"
+          showSwitch
+        >
+          {enablePublicAccess && (
+            <>
+              {settingsDatabaseCustomInputs.map(
+                ({ name, label, className, value: inputValue }) => (
+                  <Input
+                    key={name}
+                    label={label}
+                    required
+                    disabled
+                    value={inputValue}
+                    className={className}
+                    slotProps={{ inputRoot: { className: '!pr-8 truncate' } }}
+                    fullWidth
+                    hideEmptyHelperText
+                    endAdornment={
+                      <InputAdornment
+                        position="end"
+                        className="absolute right-2"
+                      >
+                        <Button
+                          sx={{ minWidth: 0, padding: 0 }}
+                          color="secondary"
+                          variant="borderless"
+                          onClick={(e) => {
+                            e.stopPropagation();
+                            copy(inputValue as string, `${label}`);
+                          }}
+                        >
+                          <CopyIcon className="w-4 h-4" />
+                        </Button>
+                      </InputAdornment>
+                    }
+                  />
+                ),
+              )}
+              <Alert severity="info" className="col-span-6 text-left">
+                To connect to the Postgres database directly, generate a new
+                password, securely save it, and then modify your connection
+                string with the newly created password.
+              </Alert>
+            </>
+          )}
+        </SettingsContainer>
+      </Form>
+    </FormProvider>
   );
 }

dashboard/src/features/database/settings/gql/getPostgresSettings.gql

@@ -13,6 +13,7 @@ query GetPostgresSettings($appId: uuid!) {
         storage {
           capacity
         }
+        enablePublicAccess
       }
     }
   }

dashboard/src/gql/app/settings/updateConfig.graphql

@@ -6,6 +6,7 @@ mutation UpdateConfig($appId: uuid!, $config: ConfigConfigUpdateInput!) {
         storage {
           capacity
         }
+        enablePublicAccess
       }
     }
     ai {

dashboard/src/utils/__generated__/graphql.ts

@@ -1804,6 +1804,7 @@ export type ConfigPostgresInsertInput = {
 export type ConfigPostgresResources = {
   __typename?: 'ConfigPostgresResources';
   compute?: Maybe<ConfigResourcesCompute>;
+  enablePublicAccess?: Maybe<Scalars['Boolean']>;
   networking?: Maybe<ConfigNetworking>;
   /** Number of replicas for a service */
   replicas?: Maybe<Scalars['ConfigUint8']>;
@@ -1815,6 +1816,7 @@ export type ConfigPostgresResourcesComparisonExp = {
   _not?: InputMaybe<ConfigPostgresResourcesComparisonExp>;
   _or?: InputMaybe<Array<ConfigPostgresResourcesComparisonExp>>;
   compute?: InputMaybe<ConfigResourcesComputeComparisonExp>;
+  enablePublicAccess?: InputMaybe<ConfigBooleanComparisonExp>;
   networking?: InputMaybe<ConfigNetworkingComparisonExp>;
   replicas?: InputMaybe<ConfigUint8ComparisonExp>;
   storage?: InputMaybe<ConfigPostgresStorageComparisonExp>;
@@ -1822,6 +1824,7 @@ export type ConfigPostgresResourcesComparisonExp = {
 
 export type ConfigPostgresResourcesInsertInput = {
   compute?: InputMaybe<ConfigResourcesComputeInsertInput>;
+  enablePublicAccess?: InputMaybe<Scalars['Boolean']>;
   networking?: InputMaybe<ConfigNetworkingInsertInput>;
   replicas?: InputMaybe<Scalars['ConfigUint8']>;
   storage?: InputMaybe<ConfigPostgresStorageInsertInput>;
@@ -1829,6 +1832,7 @@ export type ConfigPostgresResourcesInsertInput = {
 
 export type ConfigPostgresResourcesUpdateInput = {
   compute?: InputMaybe<ConfigResourcesComputeUpdateInput>;
+  enablePublicAccess?: InputMaybe<Scalars['Boolean']>;
   networking?: InputMaybe<ConfigNetworkingUpdateInput>;
   replicas?: InputMaybe<Scalars['ConfigUint8']>;
   storage?: InputMaybe<ConfigPostgresStorageUpdateInput>;
@@ -2526,6 +2530,7 @@ export type ConfigSystemConfigPostgres = {
   database: Scalars['String'];
   disk?: Maybe<ConfigSystemConfigPostgresDisk>;
   enabled?: Maybe<Scalars['Boolean']>;
+  majorVersion?: Maybe<Scalars['String']>;
 };
 
 export type ConfigSystemConfigPostgresComparisonExp = {
@@ -2536,6 +2541,7 @@ export type ConfigSystemConfigPostgresComparisonExp = {
   database?: InputMaybe<ConfigStringComparisonExp>;
   disk?: InputMaybe<ConfigSystemConfigPostgresDiskComparisonExp>;
   enabled?: InputMaybe<ConfigBooleanComparisonExp>;
+  majorVersion?: InputMaybe<ConfigStringComparisonExp>;
 };
 
 export type ConfigSystemConfigPostgresConnectionString = {
@@ -2599,6 +2605,7 @@ export type ConfigSystemConfigPostgresInsertInput = {
   database: Scalars['String'];
   disk?: InputMaybe<ConfigSystemConfigPostgresDiskInsertInput>;
   enabled?: InputMaybe<Scalars['Boolean']>;
+  majorVersion?: InputMaybe<Scalars['String']>;
 };
 
 export type ConfigSystemConfigPostgresUpdateInput = {
@@ -2606,6 +2613,7 @@ export type ConfigSystemConfigPostgresUpdateInput = {
   database?: InputMaybe<Scalars['String']>;
   disk?: InputMaybe<ConfigSystemConfigPostgresDiskUpdateInput>;
   enabled?: InputMaybe<Scalars['Boolean']>;
+  majorVersion?: InputMaybe<Scalars['String']>;
 };
 
 export type ConfigSystemConfigUpdateInput = {
@@ -2687,14 +2695,6 @@ export type Metrics = {
   value: Scalars['float64'];
 };
 
-export type StatsDailyLiveFreeApps = {
-  __typename?: 'StatsDailyLiveFreeApps';
-  avg: Scalars['Int'];
-  max: Scalars['Int'];
-  min: Scalars['Int'];
-  raw: Array<Scalars['Int']>;
-};
-
 export type StatsLiveApps = {
   __typename?: 'StatsLiveApps';
   appID: Array<Scalars['uuid']>;
@@ -11826,6 +11826,7 @@ export type Mutation_Root = {
   billingUpdatePersistentVolume: Scalars['Boolean'];
   billingUpdateReports: Scalars['Boolean'];
   billingUploadReports: Scalars['Boolean'];
+  changeDatabaseVersion: Scalars['Boolean'];
   /** delete single row from the table: "apps" */
   deleteApp?: Maybe<Apps>;
   /** delete single row from the table: "app_states" */
@@ -12511,6 +12512,14 @@ export type Mutation_RootBillingUpdateReportsArgs = {
 };
 
 
+/** mutation root */
+export type Mutation_RootChangeDatabaseVersionArgs = {
+  appID: Scalars['uuid'];
+  force?: InputMaybe<Scalars['Boolean']>;
+  version: Scalars['String'];
+};
+
+
 /** mutation root */
 export type Mutation_RootDeleteAppArgs = {
   id: Scalars['uuid'];
@@ -16016,12 +16025,6 @@ export type Query_Root = {
   softwareVersions: Array<Software_Versions>;
   /** fetch aggregated fields from the table: "software_versions" */
   softwareVersionsAggregate: Software_Versions_Aggregate;
-  /**
-   * Returns the per-day number of free live apps in the given time range, as well as the min, max and avg.
-   *
-   * Requests that returned a 4xx or 5xx status code are not counted as live traffic.
-   */
-  statsDailyLiveFreeApps: StatsDailyLiveFreeApps;
   /**
    * Returns lists of apps that have some live traffic in the give time range.
    * From defaults to 24 hours ago and to defaults to now.
@@ -16031,6 +16034,8 @@ export type Query_Root = {
   statsLiveApps: StatsLiveApps;
   systemConfig?: Maybe<ConfigSystemConfig>;
   systemConfigs: Array<ConfigAppSystemConfig>;
+  /** Returns system logs for a given application */
+  systemLogs: Array<Log>;
   /** fetch data from the table: "auth.users" using primary key columns */
   user?: Maybe<Users>;
   /** fetch data from the table: "auth.users" */
@@ -17079,12 +17084,6 @@ export type Query_RootSoftwareVersionsAggregateArgs = {
 };
 
 
-export type Query_RootStatsDailyLiveFreeAppsArgs = {
-  from?: InputMaybe<Scalars['Timestamp']>;
-  to?: InputMaybe<Scalars['Timestamp']>;
-};
-
-
 export type Query_RootStatsLiveAppsArgs = {
   from?: InputMaybe<Scalars['Timestamp']>;
   to?: InputMaybe<Scalars['Timestamp']>;
@@ -17101,6 +17100,14 @@ export type Query_RootSystemConfigsArgs = {
 };
 
 
+export type Query_RootSystemLogsArgs = {
+  action: Scalars['String'];
+  appID: Scalars['String'];
+  from?: InputMaybe<Scalars['Timestamp']>;
+  to?: InputMaybe<Scalars['Timestamp']>;
+};
+
+
 export type Query_RootUserArgs = {
   id: Scalars['uuid'];
 };
@@ -22690,7 +22697,7 @@ export type GetPostgresSettingsQueryVariables = Exact<{
 }>;
 
 
-export type GetPostgresSettingsQuery = { __typename?: 'query_root', systemConfig?: { __typename?: 'ConfigSystemConfig', postgres: { __typename?: 'ConfigSystemConfigPostgres', database: string } } | null, config?: { __typename: 'ConfigConfig', id: 'ConfigConfig', postgres?: { __typename?: 'ConfigPostgres', version?: string | null, resources?: { __typename?: 'ConfigPostgresResources', storage?: { __typename?: 'ConfigPostgresStorage', capacity: any } | null } | null } | null } | null };
+export type GetPostgresSettingsQuery = { __typename?: 'query_root', systemConfig?: { __typename?: 'ConfigSystemConfig', postgres: { __typename?: 'ConfigSystemConfigPostgres', database: string } } | null, config?: { __typename: 'ConfigConfig', id: 'ConfigConfig', postgres?: { __typename?: 'ConfigPostgres', version?: string | null, resources?: { __typename?: 'ConfigPostgresResources', enablePublicAccess?: boolean | null, storage?: { __typename?: 'ConfigPostgresStorage', capacity: any } | null } | null } | null } | null };
 
 export type ResetDatabasePasswordMutationVariables = Exact<{
   appId: Scalars['String'];
@@ -22922,7 +22929,7 @@ export type UpdateConfigMutationVariables = Exact<{
 }>;
 
 
-export type UpdateConfigMutation = { __typename?: 'mutation_root', updateConfig: { __typename?: 'ConfigConfig', id: 'ConfigConfig', postgres?: { __typename?: 'ConfigPostgres', resources?: { __typename?: 'ConfigPostgresResources', storage?: { __typename?: 'ConfigPostgresStorage', capacity: any } | null } | null } | null, ai?: { __typename?: 'ConfigAI', version?: string | null, webhookSecret: string, autoEmbeddings?: { __typename?: 'ConfigAIAutoEmbeddings', synchPeriodMinutes?: any | null } | null, openai: { __typename?: 'ConfigAIOpenai', organization?: string | null, apiKey: string }, resources: { __typename?: 'ConfigAIResources', compute: { __typename?: 'ConfigComputeResources', cpu: any, memory: any } } } | null } };
+export type UpdateConfigMutation = { __typename?: 'mutation_root', updateConfig: { __typename?: 'ConfigConfig', id: 'ConfigConfig', postgres?: { __typename?: 'ConfigPostgres', resources?: { __typename?: 'ConfigPostgresResources', enablePublicAccess?: boolean | null, storage?: { __typename?: 'ConfigPostgresStorage', capacity: any } | null } | null } | null, ai?: { __typename?: 'ConfigAI', version?: string | null, webhookSecret: string, autoEmbeddings?: { __typename?: 'ConfigAIAutoEmbeddings', synchPeriodMinutes?: any | null } | null, openai: { __typename?: 'ConfigAIOpenai', organization?: string | null, apiKey: string }, resources: { __typename?: 'ConfigAIResources', compute: { __typename?: 'ConfigComputeResources', cpu: any, memory: any } } } | null } };
 
 export type UnpauseApplicationMutationVariables = Exact<{
   appId: Scalars['uuid'];
@@ -24065,6 +24072,7 @@ export const GetPostgresSettingsDocument = gql`
         storage {
           capacity
         }
+        enablePublicAccess
       }
     }
   }
@@ -25428,6 +25436,7 @@ export const UpdateConfigDocument = gql`
         storage {
           capacity
         }
+        enablePublicAccess
       }
     }
     ai {

docs/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @nhost/docs
 
+## 2.12.0
+
+### Minor Changes
+
+- d5077c7: feat: added docs about how to connect to postgres
+
+## 2.11.0
+
+### Minor Changes
+
+- c6dc7f4: chore: docs: add Nhost client reference
+
 ## 2.10.3
 
 ### Patch Changes

docs/guides/database/access.mdx

@@ -0,0 +1,43 @@
+---
+title: Accessing the Database
+description: How to access the database directly using the connection string
+icon: key
+---
+
+In most cases you will not need to access the database directly, choosing to interact with the data via the Graphql API, however, if you need direct access to postgres you can access it via the connection string.
+
+
+# Nhost Run
+
+You can find details on how to connect to the database from an [Nhost Run](/product/run) service [here](/guides/run/networking#connecting-to-the-nhost-stack). If you don't know the password you can set a new password in the dashboard:
+
+  **Project Dashboard -> Settings -> Database**
+
+![reset password](/images/guides/database/access/reset.png)
+
+# Public Access
+
+For security reasons, by default your database won't be accessible online. If you need to access it directly from the Internet, first you will need to enable public access (enabling public access will also show the connection details):
+
+<Tabs>
+<Tab title="Dashboard">
+  **Project Dashboard -> Settings -> Database**
+
+  ![public access](/images/guides/database/access/public.png)
+
+</Tab>
+<Tab title="Config">
+```toml
+[postgres.resources]
+enablePublicAccess = true
+```
+</Tab>
+</Tabs>
+
+<Note>
+Public access to your database utilizes [pgbouncer](http://www.pgbouncer.org). As this pooler is shared infrastructure the pooler will still be available even if your database has no public access configured. The pooler will simply not have access to your database.
+</Note>
+
+# Functions
+
+[Functions](/product/functions) run on a separate network, which means in order to access the database you will first need to [make it public](#public-access).

docs/mint.json

@@ -96,7 +96,7 @@
     },
     {
       "group": "Database",
-      "pages": ["guides/database/configuring-postgres", "guides/database/extensions", "guides/database/performance"]
+      "pages": ["guides/database/configuring-postgres", "guides/database/access", "guides/database/extensions", "guides/database/performance"]
     },
     {
         "group": "AI",
@@ -298,6 +298,10 @@
           "group": "JavaScript",
           "icon": "js",
           "pages": [
+            {
+              "group": "nhost-js",
+              "pages": ["reference/javascript/nhost-js/nhost-client", "reference/javascript/nhost-js/set-role", "reference/javascript/nhost-js/unset-role"]
+            },
             {
               "group": "Auth",
               "pages": [
@@ -338,7 +342,10 @@
                 "reference/javascript/storage/get-public-url",
                 "reference/javascript/storage/delete",
                 "reference/javascript/storage/set-access-token",
-                "reference/javascript/storage/set-admin-secret"
+                "reference/javascript/storage/set-admin-secret",
+                "reference/javascript/storage/set-headers",
+                "reference/javascript/storage/unset-headers",
+                "reference/javascript/storage/get-headers"
               ]
             },
             {
@@ -347,7 +354,10 @@
                 "reference/javascript/graphql/nhost-graphql-client",
                 "reference/javascript/graphql/get-url",
                 "reference/javascript/graphql/set-access-token",
-                "reference/javascript/graphql/request"
+                "reference/javascript/graphql/request",
+                "reference/javascript/graphql/set-headers",
+                "reference/javascript/graphql/unset-headers",
+                "reference/javascript/graphql/get-headers"
               ]
             },
             {

docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/docs",
-  "version": "2.10.3",
+  "version": "2.12.0",
   "private": true,
   "scripts": {
     "start": "mintlify dev"

docs/reference/javascript/graphql/get-headers.mdx

@@ -0,0 +1,10 @@
+---
+title: getHeaders()
+sidebarTitle: getHeaders()
+---
+
+Use `nhost.graphql.getHeaders` to get the global headers sent with all graphql requests
+
+```ts
+nhost.graphql.getHeaders()
+```

docs/reference/javascript/graphql/set-headers.mdx

@@ -0,0 +1,20 @@
+---
+title: setHeaders()
+sidebarTitle: setHeaders()
+---
+
+Use `nhost.graphql.setHeaders` to set global headers to be sent in all subsequent graphql requests
+
+```ts
+nhost.graphql.setHeaders({
+  'x-hasura-role': 'admin'
+})
+```
+
+## Parameters
+
+---
+
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---

docs/reference/javascript/graphql/unset-headers.mdx

@@ -0,0 +1,11 @@
+---
+title: unsetHeaders()
+sidebarTitle: unsetHeaders()
+---
+
+Use `nhost.graphql.unsetHeaders` to remove global headers sent with all requests, except for the role header to preserve
+the role set by 'setRole' method.
+
+```ts
+nhost.graphql.unsetHeaders()
+```

docs/reference/javascript/nhost-js/nhost-client.mdx

@@ -0,0 +1,51 @@
+---
+title: NhostClient
+description: The Nhost client is the entry point to Nhost services.
+---
+
+# `NhostClient`
+
+```ts
+// Create a new Nhost client from subdomain and region.
+const nhost = new NhostClient({ subdomain, region })
+```
+
+```ts
+// Create a new Nhost client from individual service URLs (custom domains, self-hosting, etc).
+const nhost = new NhostClient({
+  authUrl: 'my-auth-service-url',
+  storageUrl: 'my-storage-service-url',
+  graphqlUrl: 'my-graphql-service-url',
+  functionsUrl: 'my-functions-service-url'
+})
+```
+
+```ts
+// Create a new Nhost client for local development.
+const nhost = new NhostClient({ subdomain: 'local' })
+```
+
+## Parameters
+
+---
+
+**<span className="parameter-name">\_\_namedParameters</span>** <span className="optional-status">required</span> [`NhostClientConstructorParams`](/reference/javascript/nhost-js/types/nhost-client-constructor-params)
+
+| Property                                                                                                            | Type                                                                            | Required | Notes                                                                                                                                    |
+| :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------ | :------: | :--------------------------------------------------------------------------------------------------------------------------------------- |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>adminSecret</span>         | <code>string</code>                                                             |          | When set, the admin secret is sent as a header, `x-hasura-admin-secret`, for all requests to GraphQL, Storage, and Serverless Functions. |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>functionsUrl</span>        | <code>string</code>                                                             |          |                                                                                                                                          |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>storageUrl</span>          | <code>string</code>                                                             |          |                                                                                                                                          |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>graphqlUrl</span>          | <code>string</code>                                                             |          |                                                                                                                                          |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>authUrl</span>             | <code>string</code>                                                             |          |                                                                                                                                          |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>region</span>              | <code>string</code>                                                             |          | Project region (e.g. `eu-central-1`) Project region is not required during local development (when `subdomain` is `localhost`)           |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>subdomain</span>           | <code>string</code>                                                             |          | Project subdomain (e.g. `ieingiwnginwnfnegqwvdqwdwq`) Use `localhost` during local development                                           |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>devTools</span>            | <code>boolean</code>                                                            |          | Activate devTools e.g. the ability to connect to the xstate inspector                                                                    |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>autoSignIn</span>          | <code>boolean</code>                                                            |          | When set to true, will parse the url on startup to check if it contains a refresh token to start the session with                        |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>autoRefreshToken</span>    | <code>boolean</code>                                                            |          | When set to true, will automatically refresh token before it expires                                                                     |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>clientStorage</span>       | [`ClientStorage`](/reference/javascript/nhost-js/types/client-storage)          |          | Object where the refresh token will be persisted and read locally.                                                                       |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>clientStorageType</span>   | [`ClientStorageType`](/reference/javascript/nhost-js/types/client-storage-type) |          | Define a way to get information about the refresh token and its exipration date.                                                         |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>refreshIntervalTime</span> | <code>number</code>                                                             |          | Time interval until token refreshes, in seconds                                                                                          |
+| <span className="parameter-name"><span className="light-grey">\_\_namedParameters.</span>start</span>               | <code>boolean</code>                                                            |          |                                                                                                                                          |
+
+---

docs/reference/javascript/nhost-js/set-role.mdx

@@ -0,0 +1,29 @@
+---
+title: setRole()
+sidebarTitle: setRole()
+---
+
+Use `nhost.setRole` to set the user role for all subsequent GraphQL, storage, and functions calls.
+Underneath, this method sets the `x-hasura-role` header on the graphql, storage,
+and functions clients.
+
+```ts
+nhost.graphql.setHeaders({ 'x-hasura-role': role })
+nhost.storage.setHeaders({ 'x-hasura-role': role })
+nhost.functions.setHeaders({ 'x-hasura-role': role })
+```
+
+Note: Exercise caution when mixing the use of `setRole` along with `setHeaders` when setting the
+`x-hasura-role` header, as the last call will override any previous ones.
+
+```ts
+nhost.setRole('admin')
+```
+
+## Parameters
+
+---
+
+**<span className="parameter-name">role</span>** <span className="optional-status">required</span> <code>string</code>
+
+---

docs/reference/javascript/nhost-js/types/client-storage-type.mdx

@@ -0,0 +1,18 @@
+---
+title: ClientStorageType
+sidebarTitle: ClientStorageType
+description: No description provided.
+---
+
+# `ClientStorageType`
+
+```ts
+type ClientStorageType =
+  | 'capacitor'
+  | 'custom'
+  | 'expo-secure-storage'
+  | 'localStorage'
+  | 'react-native'
+  | 'web'
+  | 'cookie'
+```

docs/reference/javascript/nhost-js/types/client-storage.mdx

@@ -0,0 +1,55 @@
+---
+title: ClientStorage
+sidebarTitle: ClientStorage
+description: No description provided.
+---
+
+# `ClientStorage`
+
+## Parameters
+
+---
+
+**<span className="parameter-name">customSet</span>** <span className="optional-status">optional</span> <code>(key: string, value: null &#124; string) =&gt; void &#124; Promise&lt;void&gt;</code>
+
+---
+
+**<span className="parameter-name">customGet</span>** <span className="optional-status">optional</span> <code>(key: string) =&gt; null &#124; string &#124; Promise&lt;null &#124; string&gt;</code>
+
+---
+
+**<span className="parameter-name">deleteItemAsync</span>** <span className="optional-status">optional</span> <code>(key: string) =&gt; void</code>
+
+---
+
+**<span className="parameter-name">getItemAsync</span>** <span className="optional-status">optional</span> <code>(key: string) =&gt; any</code>
+
+---
+
+**<span className="parameter-name">setItemAsync</span>** <span className="optional-status">optional</span> <code>(key: string, value: string) =&gt; void</code>
+
+---
+
+**<span className="parameter-name">remove</span>** <span className="optional-status">optional</span> <code>(options: &#123; key: string &#125;) =&gt; void</code>
+
+---
+
+**<span className="parameter-name">get</span>** <span className="optional-status">optional</span> <code>(options: &#123; key: string &#125;) =&gt; any</code>
+
+---
+
+**<span className="parameter-name">set</span>** <span className="optional-status">optional</span> <code>(options: &#123; key: string, value: string &#125;) =&gt; void</code>
+
+---
+
+**<span className="parameter-name">removeItem</span>** <span className="optional-status">optional</span> <code>(key: string) =&gt; void</code>
+
+---
+
+**<span className="parameter-name">getItem</span>** <span className="optional-status">optional</span> <code>(key: string) =&gt; any</code>
+
+---
+
+**<span className="parameter-name">setItem</span>** <span className="optional-status">optional</span> <code>(\_key: string, \_value: string) =&gt; void</code>
+
+---

docs/reference/javascript/nhost-js/types/nhost-client-constructor-params.mdx

@@ -0,0 +1,118 @@
+---
+title: NhostClientConstructorParams
+sidebarTitle: NhostClientConstructorParams
+description: No description provided.
+---
+
+# `NhostClientConstructorParams`
+
+## Parameters
+
+---
+
+**<span className="parameter-name">start</span>** <span className="optional-status">optional</span> <code>boolean</code>
+
+---
+
+**<span className="parameter-name">refreshIntervalTime</span>** <span className="optional-status">optional</span> <code>number</code>
+
+Time interval until token refreshes, in seconds
+
+---
+
+**<span className="parameter-name">clientStorageType</span>** <span className="optional-status">optional</span> [`ClientStorageType`](/reference/javascript/nhost-js/types/client-storage-type)
+
+Define a way to get information about the refresh token and its exipration date.
+
+**`@default`**
+
+`web`
+
+---
+
+**<span className="parameter-name">clientStorage</span>** <span className="optional-status">optional</span> [`ClientStorage`](/reference/javascript/nhost-js/types/client-storage)
+
+Object where the refresh token will be persisted and read locally.
+
+Recommended values:
+
+- `'web'` and `'cookies'`: no value is required
+- `'react-native'`: `import Storage from @react-native-async-storage/async-storage`
+- `'cookies'`: `localStorage`
+- `'custom'`: an object that defines the following methods:
+  - `setItem` or `setItemAsync`
+  - `getItem` or `getItemAsync`
+  - `removeItem`
+- `'capacitor'`: `import { Storage } from @capacitor/storage`
+- `'expo-secure-store'`: `import * as SecureStore from 'expo-secure-store'`
+
+| Property                                                                                                  | Type                                                                                         | Required | Notes |
+| :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :------: | :---- |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>setItem</span>         | <code>(\_key: string, \_value: string) =&gt; void</code>                                     |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>getItem</span>         | <code>(key: string) =&gt; any</code>                                                         |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>removeItem</span>      | <code>(key: string) =&gt; void</code>                                                        |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>set</span>             | <code>(options: &#123; key: string, value: string &#125;) =&gt; void</code>                  |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>get</span>             | <code>(options: &#123; key: string &#125;) =&gt; any</code>                                  |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>remove</span>          | <code>(options: &#123; key: string &#125;) =&gt; void</code>                                 |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>setItemAsync</span>    | <code>(key: string, value: string) =&gt; void</code>                                         |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>getItemAsync</span>    | <code>(key: string) =&gt; any</code>                                                         |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>deleteItemAsync</span> | <code>(key: string) =&gt; void</code>                                                        |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>customGet</span>       | <code>(key: string) =&gt; null &#124; string &#124; Promise&lt;null &#124; string&gt;</code> |          |       |
+| <span className="parameter-name"><span className="light-grey">clientStorage.</span>customSet</span>       | <code>(key: string, value: null &#124; string) =&gt; void &#124; Promise&lt;void&gt;</code>  |          |       |
+
+---
+
+**<span className="parameter-name">autoRefreshToken</span>** <span className="optional-status">optional</span> <code>boolean</code>
+
+When set to true, will automatically refresh token before it expires
+
+---
+
+**<span className="parameter-name">autoSignIn</span>** <span className="optional-status">optional</span> <code>boolean</code>
+
+When set to true, will parse the url on startup to check if it contains a refresh token to start the session with
+
+---
+
+**<span className="parameter-name">devTools</span>** <span className="optional-status">optional</span> <code>boolean</code>
+
+Activate devTools e.g. the ability to connect to the xstate inspector
+
+---
+
+**<span className="parameter-name">subdomain</span>** <span className="optional-status">optional</span> <code>string</code>
+
+Project subdomain (e.g. `ieingiwnginwnfnegqwvdqwdwq`)
+Use `localhost` during local development
+
+---
+
+**<span className="parameter-name">region</span>** <span className="optional-status">optional</span> <code>string</code>
+
+Project region (e.g. `eu-central-1`)
+Project region is not required during local development (when `subdomain` is `localhost`)
+
+---
+
+**<span className="parameter-name">authUrl</span>** <span className="optional-status">optional</span> <code>string</code>
+
+---
+
+**<span className="parameter-name">graphqlUrl</span>** <span className="optional-status">optional</span> <code>string</code>
+
+---
+
+**<span className="parameter-name">storageUrl</span>** <span className="optional-status">optional</span> <code>string</code>
+
+---
+
+**<span className="parameter-name">functionsUrl</span>** <span className="optional-status">optional</span> <code>string</code>
+
+---
+
+**<span className="parameter-name">adminSecret</span>** <span className="optional-status">optional</span> <code>string</code>
+
+When set, the admin secret is sent as a header, `x-hasura-admin-secret`,
+for all requests to GraphQL, Storage, and Serverless Functions.
+
+---

docs/reference/javascript/nhost-js/unset-role.mdx

@@ -0,0 +1,14 @@
+---
+title: unsetRole()
+sidebarTitle: unsetRole()
+---
+
+Use `nhost.unsetRole` to unset the user role for all subsequent graphql, storage and functions calls.
+Underneath, this method removes the `x-hasura-role` header from the graphql, storage and functions clients.
+
+Note: Exercise caution when mixing the use of `unsetRole` along with `setHeaders` when setting the
+`x-hasura-role` header, as the last call will override any previous ones.
+
+```ts
+nhost.unsetRole()
+```

docs/reference/javascript/storage/download.mdx

@@ -22,6 +22,6 @@ const { file, error } = await nhost.storage.download({ fileId: '<File-ID>' })
 | <span className="parameter-name"><span className="light-grey">params.</span>quality</span> | <code>number</code>                       |          | Image quality, between 1 and 100, 100 being the best quality |
 | <span className="parameter-name"><span className="light-grey">params.</span>height</span>  | <code>number</code>                       |          | Image height, in pixels                                      |
 | <span className="parameter-name"><span className="light-grey">params.</span>width</span>   | <code>number</code>                       |          | Image width, in pixels                                       |
-| <span className="parameter-name"><span className="light-grey">params.</span>headers</span> | <code>Record&lt;string, string&gt;</code> |          | Optional headers to be sent with the request                 |
+| <span className="parameter-name"><span className="light-grey">params.</span>headers</span> | <code>Record&lt;string, string&gt;</code> |          |                                                              |
 
 ---

docs/reference/javascript/storage/get-headers.mdx

@@ -0,0 +1,10 @@
+---
+title: getHeaders()
+sidebarTitle: getHeaders()
+---
+
+Use `nhost.storage.getHeaders` to get global headers sent with all storage requests.
+
+```ts
+nhost.storage.getHeaders()
+```

docs/reference/javascript/storage/get-presigned-url.mdx

@@ -24,12 +24,13 @@ console.log('expiration: ', presignedUrl.expiration)
 
 **<span className="parameter-name">params</span>** <span className="optional-status">required</span> [`StorageGetPresignedUrlParams`](/reference/javascript/storage/types/storage-get-presigned-url-params)
 
-| Property                                                                                   | Type                | Required | Notes                                                        |
-| :----------------------------------------------------------------------------------------- | :------------------ | :------: | :----------------------------------------------------------- |
-| <span className="parameter-name"><span className="light-grey">params.</span>fileId</span>  | <code>string</code> |    ✔️    |                                                              |
-| <span className="parameter-name"><span className="light-grey">params.</span>blur</span>    | <code>number</code> |          | Image blur, between 0 and 100                                |
-| <span className="parameter-name"><span className="light-grey">params.</span>quality</span> | <code>number</code> |          | Image quality, between 1 and 100, 100 being the best quality |
-| <span className="parameter-name"><span className="light-grey">params.</span>height</span>  | <code>number</code> |          | Image height, in pixels                                      |
-| <span className="parameter-name"><span className="light-grey">params.</span>width</span>   | <code>number</code> |          | Image width, in pixels                                       |
+| Property                                                                                   | Type                                      | Required | Notes                                                        |
+| :----------------------------------------------------------------------------------------- | :---------------------------------------- | :------: | :----------------------------------------------------------- |
+| <span className="parameter-name"><span className="light-grey">params.</span>fileId</span>  | <code>string</code>                       |    ✔️    |                                                              |
+| <span className="parameter-name"><span className="light-grey">params.</span>blur</span>    | <code>number</code>                       |          | Image blur, between 0 and 100                                |
+| <span className="parameter-name"><span className="light-grey">params.</span>quality</span> | <code>number</code>                       |          | Image quality, between 1 and 100, 100 being the best quality |
+| <span className="parameter-name"><span className="light-grey">params.</span>height</span>  | <code>number</code>                       |          | Image height, in pixels                                      |
+| <span className="parameter-name"><span className="light-grey">params.</span>width</span>   | <code>number</code>                       |          | Image width, in pixels                                       |
+| <span className="parameter-name"><span className="light-grey">params.</span>headers</span> | <code>Record&lt;string, string&gt;</code> |          |                                                              |
 
 ---

docs/reference/javascript/storage/set-headers.mdx

@@ -0,0 +1,22 @@
+---
+title: setHeaders()
+sidebarTitle: setHeaders()
+---
+
+Use `nhost.storage.setHeaders` to set global headers to be sent for all subsequent storage requests.
+
+```ts
+nhost.storage.setHeaders({
+  'x-hasura-role': 'admin'
+})
+```
+
+## Parameters
+
+---
+
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+key value headers object
+
+---

docs/reference/javascript/storage/types/api-delete-params.mdx

@@ -10,6 +10,10 @@ description: No description provided.
 
 ---
 
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---
+
 **<span className="parameter-name">fileId</span>** <span className="optional-status">required</span> <code>string</code>
 
 ---

docs/reference/javascript/storage/types/api-get-presigned-url-params.mdx

@@ -10,6 +10,10 @@ description: No description provided.
 
 ---
 
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---
+
 **<span className="parameter-name">fileId</span>** <span className="optional-status">required</span> <code>string</code>
 
 ---

docs/reference/javascript/storage/types/storage-download-file-params.mdx

@@ -40,6 +40,4 @@ Image width, in pixels
 
 **<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
 
-Optional headers to be sent with the request
-
 ---

docs/reference/javascript/storage/types/storage-get-presigned-url-params.mdx

@@ -37,3 +37,7 @@ Image height, in pixels
 Image width, in pixels
 
 ---
+
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---

docs/reference/javascript/storage/types/storage-headers-param.mdx

@@ -0,0 +1,15 @@
+---
+title: StorageHeadersParam
+sidebarTitle: StorageHeadersParam
+description: No description provided.
+---
+
+# `StorageHeadersParam`
+
+## Parameters
+
+---
+
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---

docs/reference/javascript/storage/types/storage-upload-file-params.mdx

@@ -25,3 +25,7 @@ description: No description provided.
 **<span className="parameter-name">id</span>** <span className="optional-status">optional</span> <code>string</code>
 
 ---
+
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---

docs/reference/javascript/storage/types/storage-upload-form-data-params.mdx

@@ -14,10 +14,10 @@ description: No description provided.
 
 ---
 
-**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
-
----
-
 **<span className="parameter-name">bucketId</span>** <span className="optional-status">optional</span> <code>string</code>
 
 ---
+
+**<span className="parameter-name">headers</span>** <span className="optional-status">optional</span> <code>Record&lt;string, string&gt;</code>
+
+---

docs/reference/javascript/storage/unset-headers.mdx

@@ -0,0 +1,10 @@
+---
+title: unsetHeaders()
+sidebarTitle: unsetHeaders()
+---
+
+Use `nhost.storage.unsetHeaders` to remove the global headers sent for all subsequent storage requests.
+
+```ts
+nhost.storage.unsetHeaders()
+```

docs/reference/javascript/storage/upload.mdx

@@ -19,12 +19,13 @@ If no `bucketId` is specified the bucket `default` is used.
 
 **<span className="parameter-name">params</span>** <span className="optional-status">required</span> [`StorageUploadFileParams`](/reference/javascript/storage/types/storage-upload-file-params)
 
-| Property                                                                                    | Type                | Required | Notes |
-| :------------------------------------------------------------------------------------------ | :------------------ | :------: | :---- |
-| <span className="parameter-name"><span className="light-grey">params.</span>file</span>     | <code>File</code>   |    ✔️    |       |
-| <span className="parameter-name"><span className="light-grey">params.</span>bucketId</span> | <code>string</code> |          |       |
-| <span className="parameter-name"><span className="light-grey">params.</span>name</span>     | <code>string</code> |          |       |
-| <span className="parameter-name"><span className="light-grey">params.</span>id</span>       | <code>string</code> |          |       |
+| Property                                                                                    | Type                                      | Required | Notes |
+| :------------------------------------------------------------------------------------------ | :---------------------------------------- | :------: | :---- |
+| <span className="parameter-name"><span className="light-grey">params.</span>file</span>     | <code>File</code>                         |    ✔️    |       |
+| <span className="parameter-name"><span className="light-grey">params.</span>bucketId</span> | <code>string</code>                       |          |       |
+| <span className="parameter-name"><span className="light-grey">params.</span>name</span>     | <code>string</code>                       |          |       |
+| <span className="parameter-name"><span className="light-grey">params.</span>id</span>       | <code>string</code>                       |          |       |
+| <span className="parameter-name"><span className="light-grey">params.</span>headers</span>  | <code>Record&lt;string, string&gt;</code> |          |       |
 
 ---
 
@@ -64,7 +65,7 @@ await storage.upload({
 | Property                                                                                    | Type                                      | Required | Notes |
 | :------------------------------------------------------------------------------------------ | :---------------------------------------- | :------: | :---- |
 | <span className="parameter-name"><span className="light-grey">params.</span>formData</span> | <code>FormData &#124; FormData</code>     |    ✔️    |       |
-| <span className="parameter-name"><span className="light-grey">params.</span>headers</span>  | <code>Record&lt;string, string&gt;</code> |          |       |
 | <span className="parameter-name"><span className="light-grey">params.</span>bucketId</span> | <code>string</code>                       |          |       |
+| <span className="parameter-name"><span className="light-grey">params.</span>headers</span>  | <code>Record&lt;string, string&gt;</code> |          |       |
 
 ---

examples/cli/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @nhost-examples/cli
 
+## 0.3.5
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 0.3.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 0.3.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 0.3.2
 
 ### Patch Changes

examples/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/cli",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "main": "src/index.mjs",
   "private": true,
   "scripts": {

examples/codegen-react-apollo/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @nhost-examples/codegen-react-apollo
 
+## 0.4.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+  - @nhost/react-apollo@12.0.0
+
+## 0.4.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+- @nhost/react-apollo@11.0.4
+
+## 0.4.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+- @nhost/react-apollo@11.0.3
+
 ## 0.4.2
 
 ### Patch Changes

examples/codegen-react-apollo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/codegen-react-apollo",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "private": true,
   "scripts": {
     "codegen": "graphql-codegen",

examples/codegen-react-query/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @nhost-examples/codegen-react-query
 
+## 0.4.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+
+## 0.4.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+
+## 0.4.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+
 ## 0.4.2
 
 ### Patch Changes

examples/codegen-react-query/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/codegen-react-query",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "private": true,
   "scripts": {
     "codegen": "graphql-codegen",

examples/codegen-react-urql/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @nhost-examples/react-urql
 
+## 0.3.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+  - @nhost/react-urql@9.0.0
+
+## 0.3.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+- @nhost/react-urql@8.0.4
+
+## 0.3.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+- @nhost/react-urql@8.0.3
+
 ## 0.3.2
 
 ### Patch Changes

examples/codegen-react-urql/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nhost-examples/codegen-react-urql",
   "private": true,
-  "version": "0.3.2",
+  "version": "0.3.5",
   "scripts": {
     "dev": "vite",
     "build": "tsc && vite build",

examples/multi-tenant-one-to-many/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @nhost-examples/multi-tenant-one-to-many
 
+## 2.2.5
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 2.2.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 2.2.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 2.2.2
 
 ### Patch Changes

examples/multi-tenant-one-to-many/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nhost-examples/multi-tenant-one-to-many",
   "private": true,
-  "version": "2.2.2",
+  "version": "2.2.5",
   "description": "",
   "main": "index.js",
   "scripts": {},

examples/nextjs/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @nhost-examples/nextjs
 
+## 0.3.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+  - @nhost/react-apollo@12.0.0
+  - @nhost/nextjs@2.1.14
+
+## 0.3.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+- @nhost/react-apollo@11.0.4
+- @nhost/nextjs@2.1.13
+
+## 0.3.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+- @nhost/react-apollo@11.0.3
+- @nhost/nextjs@2.1.12
+
 ## 0.3.2
 
 ### Patch Changes

examples/nextjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/nextjs",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "private": true,
   "scripts": {
     "dev": "next dev",

examples/node-storage/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @nhost-examples/node-storage
 
+## 0.2.5
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 0.2.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 0.2.2
 
 ### Patch Changes

examples/node-storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/node-storage",
-  "version": "0.2.2",
+  "version": "0.2.5",
   "private": true,
   "description": "This is an example of how to use the Storage with Node.js",
   "main": "src/index.mjs",

examples/quickstarts/nextjs-server-components/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @nhost-examples/nextjs-server-components
 
+## 0.4.5
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 0.4.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 0.4.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 0.4.2
 
 ### Patch Changes

examples/quickstarts/nextjs-server-components/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/nextjs-server-components",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "private": true,
   "scripts": {
     "dev": "next dev",

examples/react-apollo/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @nhost-examples/react-apollo
 
+## 0.8.5
+
+### Patch Changes
+
+- aef4a0a: fix: resolve e2e test issues
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+  - @nhost/react-apollo@12.0.0
+
+## 0.8.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+- @nhost/react-apollo@11.0.4
+
+## 0.8.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+- @nhost/react-apollo@11.0.3
+
 ## 0.8.2
 
 ### Patch Changes

examples/react-apollo/e2e/utils.ts

@@ -119,7 +119,7 @@ export async function verifyMagicLink({
 
   await page
     .frameLocator('#preview-html')
-    .getByRole('link', { name: /sign in/i })
+    .getByRole('link', { name: /verify email/i })
     .click()
 
   const authenticatedPage = await authenticatedPagePromise
@@ -154,7 +154,7 @@ export async function resetPassword({
 
   await page
     .frameLocator('#preview-html')
-    .getByRole('link', { name: /reset password/i })
+    .getByRole('link', { name: /verify email/i })
     .click()
 
   const authenticatedPage = await authenticatedPagePromise

examples/react-apollo/nhost/overlays/local.json

@@ -1,12 +1,38 @@
 [
   {
+    "value": "disabled",
     "op": "replace",
-    "path": "/auth/method/webauthn/relyingParty/origins/0",
-    "value": "http://localhost:3000"
+    "path": "/auth/elevatedPrivileges/mode"
   },
   {
+    "op": "remove",
+    "path": "/auth/method/oauth/apple/clientId"
+  },
+  {
+    "value": false,
     "op": "replace",
-    "path": "/auth/redirections/clientUrl",
-    "value": "http://localhost:3000"
+    "path": "/auth/method/oauth/apple/enabled"
+  },
+  {
+    "op": "remove",
+    "path": "/auth/method/oauth/apple/keyId"
+  },
+  {
+    "op": "remove",
+    "path": "/auth/method/oauth/apple/privateKey"
+  },
+  {
+    "op": "remove",
+    "path": "/auth/method/oauth/apple/teamId"
+  },
+  {
+    "value": "http://localhost:3000",
+    "op": "replace",
+    "path": "/auth/method/webauthn/relyingParty/origins/0"
+  },
+  {
+    "value": "http://localhost:3000",
+    "op": "replace",
+    "path": "/auth/redirections/clientUrl"
   }
 ]

examples/react-apollo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/react-apollo",
-  "version": "0.8.2",
+  "version": "0.8.5",
   "private": true,
   "dependencies": {
     "@apollo/client": "^3.9.9",
@@ -22,9 +22,9 @@
   "scripts": {
     "dev": "vite --host localhost --port 3000",
     "generate": "graphql-codegen --config graphql.config.yaml",
-    "install-browsers": "pnpm dlx playwright@1.31.0 install --with-deps",
+    "install-browsers": "pnpm playwright install && pnpm playwright install-deps",
     "e2e": "pnpm e2e:start-backend && pnpm e2e:test",
-    "e2e:test": "pnpm install-browsers && pnpm dlx playwright@1.31.0 test; nhost down",
+    "e2e:test": "pnpm install-browsers && pnpm playwright test",
     "e2e:start-backend": "cp .secrets.example .secrets && nhost up",
     "e2e:start-ui": "run-s build preview",
     "build": "vite build",
@@ -52,7 +52,7 @@
     "@faker-js/faker": "^7.6.0",
     "@graphql-codegen/cli": "^5.0.2",
     "@nuintun/qrcode": "^3.4.0",
-    "@playwright/test": "1.31.0",
+    "@playwright/test": "1.41.0",
     "@types/pngjs": "^6.0.4",
     "@types/react": "^18.2.73",
     "@types/react-dom": "^18.2.23",

examples/react-apollo/pnpm-lock.yaml

@@ -1241,7 +1241,7 @@ packages:
       '@simplewebauthn/browser': 6.2.2
       fetch-ponyfill: 7.1.0
       js-cookie: 3.0.5
-      jwt-decode: 3.1.2
+      jwt-decode: 4.0.0
       xstate: 4.38.3
     transitivePeerDependencies:
       - encoding
@@ -1299,7 +1299,7 @@ packages:
     dependencies:
       '@nhost/nhost-js': 3.0.2(graphql@16.8.1)
       '@xstate/react': 3.2.2(@types/react@18.2.48)(react@18.2.0)(xstate@4.38.3)
-      jwt-decode: 3.1.2
+      jwt-decode: 4.0.0
       react: 18.2.0
       react-dom: 18.2.0(react@18.2.0)
       xstate: 4.38.3

examples/react-gqty/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @nhost-examples/react-gqty
 
+## 1.2.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+
+## 1.2.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+
+## 1.2.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+
 ## 1.2.2
 
 ### Patch Changes

examples/react-gqty/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nhost-examples/react-gqty",
   "private": true,
-  "version": "1.2.2",
+  "version": "1.2.5",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/vue-apollo/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @nhost-examples/vue-apollo
 
+## 0.6.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/apollo@7.1.0
+  - @nhost/vue@2.6.0
+  - @nhost/nhost-js@3.1.3
+
+## 0.6.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+  - @nhost/apollo@7.0.2
+  - @nhost/vue@2.5.4
+
+## 0.6.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+- @nhost/apollo@7.0.1
+- @nhost/vue@2.5.3
+
 ## 0.6.2
 
 ### Patch Changes

examples/vue-apollo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nhost-examples/vue-apollo",
   "private": true,
-  "version": "0.6.2",
+  "version": "0.6.5",
   "scripts": {
     "dev": "vite",
     "build": "vite build",

examples/vue-quickstart/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @nhost-examples/vue-quickstart
 
+## 0.2.5
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/apollo@7.1.0
+  - @nhost/vue@2.6.0
+
+## 0.2.4
+
+### Patch Changes
+
+- @nhost/apollo@7.0.2
+- @nhost/vue@2.5.4
+
+## 0.2.3
+
+### Patch Changes
+
+- @nhost/apollo@7.0.1
+- @nhost/vue@2.5.3
+
 ## 0.2.2
 
 ### Patch Changes

examples/vue-quickstart/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost-examples/vue-quickstart",
-  "version": "0.2.2",
+  "version": "0.2.5",
   "private": true,
   "scripts": {
     "build": "vite build",

integrations/apollo/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @nhost/apollo
 
+## 7.1.0
+
+### Minor Changes
+
+- d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 7.0.2
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 7.0.1
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 7.0.0
 
 ### Patch Changes

integrations/apollo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/apollo",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "Nhost Apollo Client library",
   "license": "MIT",
   "keywords": [
@@ -66,7 +66,7 @@
   "dependencies": {
     "graphql": "16.8.1",
     "graphql-ws": "^5.16.0",
-    "jwt-decode": "^3.1.2"
+    "jwt-decode": "^4.0.0"
   },
   "devDependencies": {
     "@apollo/client": "^3.9.9",

integrations/apollo/src/index.ts

@@ -12,7 +12,7 @@ import { setContext } from '@apollo/client/link/context'
 import { GraphQLWsLink } from '@apollo/client/link/subscriptions'
 import { getMainDefinition } from '@apollo/client/utilities'
 import { AuthContext, NhostClient } from '@nhost/nhost-js'
-import jwtDecode, { JwtPayload } from 'jwt-decode'
+import { jwtDecode, JwtPayload } from 'jwt-decode'
 
 import { createRestartableClient } from './ws'
 const isBrowser = typeof window !== 'undefined'
@@ -67,7 +67,7 @@ export const createApolloClient = ({
     const marginInSeconds = 3
     const marginInMilliseconds = marginInSeconds * 1000
 
-    let decodedToken: JwtPayload = jwtDecode(accessToken.value)
+    let decodedToken = jwtDecode(accessToken.value) as JwtPayload
     return decodedToken.exp! * 1000 > Date.now() - marginInMilliseconds
   }
 

integrations/react-apollo/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @nhost/react-apollo
 
+## 12.0.0
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/apollo@7.1.0
+  - @nhost/react@3.5.0
+
+## 11.0.4
+
+### Patch Changes
+
+- @nhost/apollo@7.0.2
+- @nhost/react@3.4.4
+
+## 11.0.3
+
+### Patch Changes
+
+- @nhost/apollo@7.0.1
+- @nhost/react@3.4.3
+
 ## 11.0.2
 
 ### Patch Changes

integrations/react-apollo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/react-apollo",
-  "version": "11.0.2",
+  "version": "12.0.0",
   "description": "Nhost React Apollo client",
   "license": "MIT",
   "keywords": [

integrations/react-urql/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @nhost/react-urql
 
+## 9.0.0
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+
+## 8.0.4
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+
+## 8.0.3
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+
 ## 8.0.2
 
 ### Patch Changes

integrations/react-urql/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/react-urql",
-  "version": "8.0.2",
+  "version": "9.0.0",
   "description": "Nhost React URQL client",
   "license": "MIT",
   "keywords": [

packages/graphql-js/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @nhost/graphql-js
 
+## 0.3.0
+
+### Minor Changes
+
+- d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0
+
 ## 0.2.0
 
 ### Minor Changes

packages/graphql-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/graphql-js",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Nhost GraphQL client",
   "license": "MIT",
   "keywords": [
@@ -54,14 +54,16 @@
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "^3.2.0",
+    "base-64": "^1.0.0",
     "isomorphic-unfetch": "^3.1.0",
-    "jose": "^5.2.3"
+    "jwt-decode": "^4.0.0"
   },
   "peerDependencies": {
     "graphql": "^14.0.0 || ^15.0.0 || ^16.0.0"
   },
   "devDependencies": {
     "@nhost/docgen": "workspace:*",
+    "@types/base-64": "^1.0.2",
     "graphql": "16.8.1"
   }
 }

packages/graphql-js/src/client.ts

@@ -12,7 +12,7 @@ import {
   Variables
 } from './types'
 
-import * as jose from 'jose'
+import { jwtDecode, JwtPayload } from 'jwt-decode'
 
 /**
  * @alias GraphQL
@@ -37,7 +37,7 @@ export class NhostGraphqlClient {
     }
 
     try {
-      const decodedToken = jose.decodeJwt<jose.JWTPayload>(this.accessToken)
+      const decodedToken = jwtDecode(this.accessToken) as JwtPayload
       return decodedToken.exp != null && decodedToken.exp * 1000 > Date.now()
     } catch (error) {
       console.error('Error decoding token:', error)

packages/hasura-auth-js/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @nhost/hasura-auth-js
 
+## 2.5.0
+
+### Minor Changes
+
+- d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0
+
 ## 2.4.2
 
 ### Patch Changes

packages/hasura-auth-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/hasura-auth-js",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "description": "Hasura-auth client",
   "license": "MIT",
   "keywords": [
@@ -66,8 +66,8 @@
   "dependencies": {
     "@simplewebauthn/browser": "^9.0.1",
     "fetch-ponyfill": "^7.1.0",
-    "jose": "^5.2.3",
     "js-cookie": "^3.0.5",
+    "jwt-decode": "^4.0.0",
     "xstate": "^4.38.3"
   },
   "devDependencies": {

packages/hasura-auth-js/src/hasura-auth-client.ts

@@ -1,4 +1,4 @@
-import * as jose from 'jose'
+import { jwtDecode } from 'jwt-decode'
 import { interpret } from 'xstate'
 import {
   EMAIL_NEEDS_VERIFICATION,
@@ -664,7 +664,7 @@ export class HasuraAuthClient {
   public getDecodedAccessToken(): JWTClaims | null {
     const jwt = this.getAccessToken()
     if (!jwt) return null
-    return jose.decodeJwt<JWTClaims>(jwt)
+    return jwtDecode<JWTClaims>(jwt)
   }
 
   /**

packages/hasura-storage-js/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @nhost/hasura-storage-js
 
+## 2.5.1
+
+### Patch Changes
+
+- 8512a7f: fix: fix types StorageGetUrlParams and StorageGetPresignedUrlParams to include missing StorageHeadersParam
+
 ## 2.5.0
 
 ### Minor Changes

packages/hasura-storage-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/hasura-storage-js",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Hasura-storage client",
   "license": "MIT",
   "keywords": [

packages/hasura-storage-js/src/hasura-storage-client.ts

@@ -124,8 +124,9 @@ export class HasuraStorageClient {
   async getPresignedUrl(
     params: StorageGetPresignedUrlParams
   ): Promise<StorageGetPresignedUrlResponse> {
-    const { fileId, ...imageTransformationParams } = params
+    const { fileId, headers, ...imageTransformationParams } = params
     const { presignedUrl, error } = await this.api.getPresignedUrl(params)
+
     if (error) {
       return { presignedUrl: null, error }
     }

packages/hasura-storage-js/src/utils/types.ts

@@ -81,7 +81,9 @@ export interface StorageGetUrlParams extends StorageImageTransformationParams {
   fileId: string
 }
 
-export interface StorageGetPresignedUrlParams extends StorageImageTransformationParams {
+export interface StorageGetPresignedUrlParams
+  extends StorageImageTransformationParams,
+    StorageHeadersParam {
   fileId: string
 }
 

packages/nextjs/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @nhost/nextjs
 
+## 2.1.14
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/react@3.5.0
+
+## 2.1.13
+
+### Patch Changes
+
+- @nhost/react@3.4.4
+
+## 2.1.12
+
+### Patch Changes
+
+- @nhost/react@3.4.3
+
 ## 2.1.11
 
 ### Patch Changes

packages/nextjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/nextjs",
-  "version": "2.1.11",
+  "version": "2.1.14",
   "description": "Nhost NextJS library",
   "license": "MIT",
   "keywords": [

packages/nhost-js/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @nhost/nhost-js
 
+## 3.1.3
+
+### Patch Changes
+
+- Updated dependencies [d0c9f4c]
+  - @nhost/hasura-auth-js@2.5.0
+  - @nhost/graphql-js@0.3.0
+
+## 3.1.2
+
+### Patch Changes
+
+- 4c35171: fix: update docstring to correctly reflect usage of nhost.unsetRole method
+- 3cea460: chore: update docs links for nhost-js setRole and unsetRole methods
+
+## 3.1.1
+
+### Patch Changes
+
+- Updated dependencies [8512a7f]
+  - @nhost/hasura-storage-js@2.5.1
+
 ## 3.1.0
 
 ### Minor Changes

packages/nhost-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/nhost-js",
-  "version": "3.1.0",
+  "version": "3.1.3",
   "description": "Nhost JavaScript SDK",
   "license": "MIT",
   "keywords": [

packages/nhost-js/src/clients/nhost.ts

@@ -18,13 +18,30 @@ export class NhostClient {
   readonly devTools?: boolean
 
   /**
-   * Nhost Client
    *
    * @example
    * ```ts
+   * // Create a new Nhost client from subdomain and region.
    * const nhost = new NhostClient({ subdomain, region });
    * ```
    *
+   *
+   * ```ts
+   * // Create a new Nhost client from individual service URLs (custom domains, self-hosting, etc).
+   * const nhost = new NhostClient({ 
+   *   authUrl: "my-auth-service-url",
+   *   storageUrl: "my-storage-service-url",
+   *   graphqlUrl: "my-graphql-service-url",
+   *   functionsUrl: "my-functions-service-url",
+   * });
+   * ```
+   *
+   *
+   * ```ts
+   * // Create a new Nhost client for local development.
+   * const nhost = new NhostClient({ subdomain: "local" });
+   * ```
+   *
    * @docs https://docs.nhost.io/reference/javascript
    */
   constructor({
@@ -110,7 +127,7 @@ export class NhostClient {
    * nhost.setRole('admin')
    * ```
    *
-   * @docs https://docs.nhost.io/reference/javascript/set-role
+   * @docs https://docs.nhost.io/reference/javascript/nhost-js/set-role
    */
   setRole(role: string) {
     this.graphql.setHeaders({ 'x-hasura-role': role })
@@ -127,10 +144,10 @@ export class NhostClient {
    *
    * @example
    * ```ts
-   * nhost.unsetRole('admin')
+   * nhost.unsetRole()
    * ```
    *
-   * @docs https://docs.nhost.io/reference/javascript/set-role
+   * @docs https://docs.nhost.io/reference/javascript/nhost-js/unset-role
    */
   unsetRole() {
     this.graphql.setHeaders((({ 'x-hasura-role': _, ...rest }) => rest)(this.graphql.getHeaders()))

packages/react/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @nhost/react
 
+## 3.5.0
+
+### Minor Changes
+
+- d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 3.4.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 3.4.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 3.4.2
 
 ### Patch Changes

packages/react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/react",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "description": "Nhost React library",
   "license": "MIT",
   "keywords": [
@@ -64,7 +64,7 @@
   "dependencies": {
     "@nhost/nhost-js": "workspace:*",
     "@xstate/react": "^3.2.2",
-    "jwt-decode": "^3.1.2",
+    "jwt-decode": "^4.0.0",
     "react-dom": "^18.2.0",
     "xstate": "^4.38.3"
   },

packages/react/src/useDecodedAccessToken.ts

@@ -1,5 +1,5 @@
 import { JWTClaims } from '@nhost/nhost-js'
-import jwt_decode from 'jwt-decode'
+import { jwtDecode } from 'jwt-decode'
 import { useAccessToken } from './useAccessToken'
 
 /**
@@ -14,5 +14,5 @@ import { useAccessToken } from './useAccessToken'
  */
 export const useDecodedAccessToken = (): JWTClaims | null => {
   const jwt = useAccessToken()
-  return jwt ? jwt_decode<JWTClaims>(jwt) : null
+  return jwt ? jwtDecode<JWTClaims>(jwt) : null
 }

packages/vue/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @nhost/vue
 
+## 2.6.0
+
+### Minor Changes
+
+- d0c9f4c: fix: replace `jose` with `jwt-decode` version 4.0.0
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.3
+
+## 2.5.4
+
+### Patch Changes
+
+- Updated dependencies [4c35171]
+- Updated dependencies [3cea460]
+  - @nhost/nhost-js@3.1.2
+
+## 2.5.3
+
+### Patch Changes
+
+- @nhost/nhost-js@3.1.1
+
 ## 2.5.2
 
 ### Patch Changes

packages/vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhost/vue",
-  "version": "2.5.2",
+  "version": "2.6.0",
   "description": "Nhost Vue library",
   "license": "MIT",
   "keywords": [
@@ -68,7 +68,7 @@
     "@nhost/nhost-js": "workspace:*",
     "@vueuse/core": "^10.9.0",
     "@xstate/vue": "^2.0.0",
-    "jwt-decode": "^3.1.2"
+    "jwt-decode": "^4.0.0"
   },
   "devDependencies": {
     "@nhost/docgen": "workspace:*",

packages/vue/src/useDecodedAccessToken.ts

@@ -1,5 +1,5 @@
 import { JWTClaims } from '@nhost/nhost-js'
-import jwt_decode from 'jwt-decode'
+import { jwtDecode } from 'jwt-decode'
 import { computed, ComputedRef } from 'vue'
 import { useAccessToken } from './useAccessToken'
 
@@ -15,5 +15,5 @@ import { useAccessToken } from './useAccessToken'
  */
 export const useDecodedAccessToken = (): ComputedRef<JWTClaims | null> => {
   const jwt = useAccessToken()
-  return computed(() => (jwt.value ? jwt_decode<JWTClaims>(jwt.value) : null))
+  return computed(() => (jwt.value ? jwtDecode<JWTClaims>(jwt.value) : null))
 }

pnpm-lock.yaml

@@ -1122,8 +1122,8 @@ importers:
         specifier: ^3.4.0
         version: 3.4.0
       '@playwright/test':
-        specifier: 1.31.0
-        version: 1.31.0
+        specifier: 1.41.0
+        version: 1.41.0
       '@types/pngjs':
         specifier: ^6.0.4
         version: 6.0.4
@@ -1413,8 +1413,8 @@ importers:
         specifier: ^5.16.0
         version: 5.16.0(graphql@16.8.1)
       jwt-decode:
-        specifier: ^3.1.2
-        version: 3.1.2
+        specifier: ^4.0.0
+        version: 4.0.0
     devDependencies:
       '@apollo/client':
         specifier: ^3.9.9
@@ -1580,16 +1580,22 @@ importers:
       '@graphql-typed-document-node/core':
         specifier: ^3.2.0
         version: 3.2.0(graphql@16.8.1)
+      base-64:
+        specifier: ^1.0.0
+        version: 1.0.0
       isomorphic-unfetch:
         specifier: ^3.1.0
         version: 3.1.0
-      jose:
-        specifier: ^5.2.3
-        version: 5.2.3
+      jwt-decode:
+        specifier: ^4.0.0
+        version: 4.0.0
     devDependencies:
       '@nhost/docgen':
         specifier: workspace:*
         version: link:../docgen
+      '@types/base-64':
+        specifier: ^1.0.2
+        version: 1.0.2
       graphql:
         specifier: 16.8.1
         version: 16.8.1
@@ -1602,12 +1608,12 @@ importers:
       fetch-ponyfill:
         specifier: ^7.1.0
         version: 7.1.0
-      jose:
-        specifier: ^5.2.3
-        version: 5.2.3
       js-cookie:
         specifier: ^3.0.5
         version: 3.0.5
+      jwt-decode:
+        specifier: ^4.0.0
+        version: 4.0.0
       xstate:
         specifier: ^4.38.3
         version: 4.38.3
@@ -1727,8 +1733,8 @@ importers:
         specifier: ^3.2.2
         version: 3.2.2(@types/react@18.2.73)(react@18.2.0)(xstate@4.38.3)
       jwt-decode:
-        specifier: ^3.1.2
-        version: 3.1.2
+        specifier: ^4.0.0
+        version: 4.0.0
       react-dom:
         specifier: ^18.2.0
         version: 18.2.0(react@18.2.0)
@@ -1792,8 +1798,8 @@ importers:
         specifier: ^2.0.0
         version: 2.0.0(vue@3.4.21)(xstate@4.38.3)
       jwt-decode:
-        specifier: ^3.1.2
-        version: 3.1.2
+        specifier: ^4.0.0
+        version: 4.0.0
     devDependencies:
       '@nhost/docgen':
         specifier: workspace:*
@@ -7813,17 +7819,6 @@ packages:
     requiresBuild: true
     optional: true
 
-  /@playwright/test@1.31.0:
-    resolution: {integrity: sha512-Ys5s/06Dg9g3zAIdCIb/UOBYim3U7Zjb3DvC6XBtnRmnglH5O47iwYzmtxXu9fhSyzI2Jn28apkXIOD81GgCdw==}
-    engines: {node: '>=14'}
-    hasBin: true
-    dependencies:
-      '@types/node': 18.19.28
-      playwright-core: 1.31.0
-    optionalDependencies:
-      fsevents: 2.3.2
-    dev: true
-
   /@playwright/test@1.41.0:
     resolution: {integrity: sha512-Grvzj841THwtpBOrfiHOeYTJQxDRnKofMSzCiV8XeyLWu3o89qftQ4BCKfkziJhSUQRd0utKhrddtIsiraIwmw==}
     engines: {node: '>=16'}
@@ -10474,6 +10469,10 @@ packages:
       '@babel/types': 7.24.0
     dev: true
 
+  /@types/base-64@1.0.2:
+    resolution: {integrity: sha512-uPgKMmM9fmn7I+Zi6YBqctOye4SlJsHKcisjHIMWpb2YKZRc36GpKyNuQ03JcT+oNXg1m7Uv4wU94EVltn8/cw==}
+    dev: true
+
   /@types/bcryptjs@2.4.6:
     resolution: {integrity: sha512-9xlo6R2qDs5uixm0bcIqCeMCE6HiQsIyel9KQySStiyqNl2tnj2mP3DX1Nf56MD6KMenNNlBBsy3LJ7gUEQPXQ==}
     dev: true
@@ -10861,7 +10860,7 @@ packages:
     resolution: {integrity: sha512-G3sY+NpsA9jnwm0ixhAFQSJ3Q9JkpLZpJbI3GMv0mIAT0y3mRabYeINzal5WOChIiaTEGQYlHOKgkaM9EisWHw==}
     dependencies:
       '@types/caseless': 0.12.5
-      '@types/node': 16.18.93
+      '@types/node': 18.19.28
       '@types/tough-cookie': 4.0.5
       form-data: 2.5.1
     dev: false
@@ -12458,9 +12457,6 @@ packages:
 
   /ajv-formats@2.1.1:
     resolution: {integrity: sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==}
-    peerDependenciesMeta:
-      ajv:
-        optional: true
     dependencies:
       ajv: 8.12.0
     dev: true
@@ -13200,6 +13196,10 @@ packages:
   /balanced-match@1.0.2:
     resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
 
+  /base-64@1.0.0:
+    resolution: {integrity: sha512-kwDPIFCGx0NZHog36dj+tHiwP4QMzsZ3AgMViUBKI0+V5n4U0ufTCUMhnQ04diaRI8EX/QcPfql7zlhZ7j4zgg==}
+    dev: false
+
   /base64-js@1.5.1:
     resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
 
@@ -19522,6 +19522,7 @@ packages:
 
   /jose@5.2.3:
     resolution: {integrity: sha512-KUXdbctm1uHVL8BYhnyHkgp3zDX5KW8ZhAKVFEfUbU2P8Alpzjb+48hHvjOdQIyPshoblhzsuqOwEEAbtHVirA==}
+    dev: true
 
   /jpeg-js@0.4.4:
     resolution: {integrity: sha512-WZzeDOEtTOBK4Mdsar0IqEU5sMr3vSV2RqkAIzUEV2BHnUfKGyswWFPFwK5EeDo93K3FohSHbLAjj0s1Wzd+dg==}
@@ -19820,6 +19821,12 @@ packages:
 
   /jwt-decode@3.1.2:
     resolution: {integrity: sha512-UfpWE/VZn0iP50d8cz9NrZLM9lSWhcJ+0Gt/nm4by88UL+J1SiKN8/5dkjMmbEzwL2CAe+67GsegCbIKtbp75A==}
+    dev: true
+
+  /jwt-decode@4.0.0:
+    resolution: {integrity: sha512-+KJGIyHgkGuIq3IEBNftfhW/LfWhXUIY6OmyVWjliu5KH1y0fw7VQ8YndE2O4qZdMSd9SqbnC8GOcZEy0Om7sA==}
+    engines: {node: '>=18'}
+    dev: false
 
   /katex@0.16.10:
     resolution: {integrity: sha512-ZiqaC04tp2O5utMsl2TEZTXxa6WSC4yo0fv5ML++D3QZv/vx2Mct0mTlRx3O+uUkjfuAgOkzsCmq5MiUEsDDdA==}
@@ -22891,12 +22898,6 @@ packages:
       pathe: 1.1.2
     dev: true
 
-  /playwright-core@1.31.0:
-    resolution: {integrity: sha512-/KquBjS5DcASCh8cGeNVHuC0kyb7c9plKTwaKxgOGtxT7+DZO2fjmFvPDBSXslEIK5CeOO/2kk5rOCktFXKEdA==}
-    engines: {node: '>=14'}
-    hasBin: true
-    dev: true
-
   /playwright-core@1.41.0:
     resolution: {integrity: sha512-UGKASUhXmvqm2Lxa1fNr8sFwAtqjpgBRr9jQ7XBI8Rn5uFiEowGUGwrruUQsVPIom4bk7Lt+oLGpXobnXzrBIw==}
     engines: {node: '>=16'}
@@ -23420,7 +23421,7 @@ packages:
       '@protobufjs/path': 1.1.2
       '@protobufjs/pool': 1.1.0
       '@protobufjs/utf8': 1.1.0
-      '@types/node': 16.18.93
+      '@types/node': 18.19.28
       long: 5.2.3
     dev: false