@nhost/nhost-js 4.0.1 → 4.1.0

package/dist/src/fetch/middlewareUpdateSessionFromResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"middlewareUpdateSessionFromResponse.js","sourceRoot":"","sources":["../../../src/fetch/middlewareUpdateSessionFromResponse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CACjD,OAAuB,EACR,EAAE;IACjB;;;;;OAKG;IACH,MAAM,gBAAgB,GAAG,CACvB,IAAuC,EACvB,EAAE;QAClB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,iBAAiB;YACjB,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QAC9B,CAAC;QAED,IAAI,aAAa,IAAI,IAAI,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YACpD,UAAU;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,CAAC,IAA+D,EAAE,EAAE,CACzE,KAAK,EAAE,GAAW,EAAE,OAAqB,EAAE,EAAE;QAC3C,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE1C,IAAI,CAAC;YACH,oCAAoC;YACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,6BAA6B;gBAC7B,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,2EAA2E;YAC3E,IACE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACtB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACxB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;gBACD,2CAA2C;gBAC3C,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAExC,sBAAsB;gBACtB,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAEzC,CAAC;gBAEnB,IAAI,IAAI,EAAE,CAAC;oBACT,8DAA8D;oBAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBAEvC,qCAAqC;oBACrC,IAAI,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;wBACjD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;QAED,+BAA+B;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACN,CAAC,CAAC"}
+{"version":3,"file":"middlewareUpdateSessionFromResponse.js","sourceRoot":"","sources":["../../../src/fetch/middlewareUpdateSessionFromResponse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CACjD,OAAuB,EACR,EAAE;IACjB;;;;;OAKG;IACH,MAAM,gBAAgB,GAAG,CACvB,IAAuC,EACvB,EAAE;QAClB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,iBAAiB;YACjB,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QAC9B,CAAC;QAED,IAAI,aAAa,IAAI,IAAI,IAAI,cAAc,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACtE,UAAU;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,CAAC,IAA+D,EAAE,EAAE,CACzE,KAAK,EAAE,GAAW,EAAE,OAAqB,EAAE,EAAE;QAC3C,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE1C,IAAI,CAAC;YACH,oCAAoC;YACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,6BAA6B;gBAC7B,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,2EAA2E;YAC3E,IACE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACtB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACxB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;gBACD,2CAA2C;gBAC3C,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAExC,sBAAsB;gBACtB,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAEzC,CAAC;gBAEnB,IAAI,IAAI,EAAE,CAAC;oBACT,8DAA8D;oBAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBAEvC,qCAAqC;oBACrC,IAAI,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;wBACjD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;QAED,+BAA+B;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACN,CAAC,CAAC"}

package/dist/src/fetch/middlewareWithAdminSession.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Admin session middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically attach
+ * Hasura admin secret for admin permissions in requests.
+ */
+import type { ChainFunction } from "./fetch";
+/**
+ * Configuration options for admin session middleware
+ */
+export interface AdminSessionOptions {
+    /**
+     * Hasura admin secret for elevated permissions (sets x-hasura-admin-secret header)
+     */
+    adminSecret: string;
+    /**
+     * Hasura role to use for the request (sets x-hasura-role header)
+     */
+    role?: string;
+    /**
+     * Additional Hasura session variables to attach to requests.
+     * Keys will be automatically prefixed with 'x-hasura-' if not already present.
+     *
+     * @example
+     * ```ts
+     * {
+     *   'user-id': '123',
+     *   'org-id': '456'
+     * }
+     * // Results in headers:
+     * // x-hasura-user-id: 123
+     * // x-hasura-org-id: 456
+     * ```
+     */
+    sessionVariables?: Record<string, string>;
+}
+/**
+ * Creates a fetch middleware that attaches the Hasura admin secret and optional session variables to requests.
+ *
+ * This middleware:
+ * 1. Sets the x-hasura-admin-secret header, which grants full admin access to Hasura
+ * 2. Optionally sets the x-hasura-role header if a role is provided
+ * 3. Optionally sets additional x-hasura-* headers for custom session variables
+ *
+ * **Security Warning**: Never use this middleware in client-side code or expose
+ * the admin secret to end users. Admin secrets grant unrestricted access to your
+ * entire database. This should only be used in trusted server-side environments.
+ *
+ * The middleware preserves request-specific headers when they conflict with the
+ * admin session configuration.
+ *
+ * @param options - Admin session options including admin secret, role, and session variables
+ * @returns A middleware function that can be used in the fetch chain
+ *
+ * @example
+ * ```ts
+ * // Create middleware with admin secret only
+ * const adminMiddleware = withAdminSessionMiddleware({
+ *   adminSecret: process.env.NHOST_ADMIN_SECRET
+ * });
+ *
+ * // Create middleware with admin secret and role
+ * const adminUserMiddleware = withAdminSessionMiddleware({
+ *   adminSecret: process.env.NHOST_ADMIN_SECRET,
+ *   role: 'user'
+ * });
+ *
+ * // Create middleware with admin secret, role, and custom session variables
+ * const fullMiddleware = withAdminSessionMiddleware({
+ *   adminSecret: process.env.NHOST_ADMIN_SECRET,
+ *   role: 'user',
+ *   sessionVariables: {
+ *     'user-id': '123',
+ *     'org-id': '456'
+ *   }
+ * });
+ *
+ * // Use with createCustomClient for an admin client
+ * const adminClient = createCustomClient({
+ *   subdomain: 'myproject',
+ *   region: 'eu-central-1',
+ *   chainFunctions: [adminMiddleware]
+ * });
+ * ```
+ */
+export declare const withAdminSessionMiddleware: (options: AdminSessionOptions) => ChainFunction;
+//# sourceMappingURL=middlewareWithAdminSession.d.ts.map

package/dist/src/fetch/middlewareWithAdminSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareWithAdminSession.d.ts","sourceRoot":"","sources":["../../../src/fetch/middlewareWithAdminSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,0BAA0B,GACpC,SAAS,mBAAmB,KAAG,aA6B/B,CAAC"}

package/dist/src/fetch/middlewareWithAdminSession.js

@@ -0,0 +1,79 @@
+/**
+ * Admin session middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically attach
+ * Hasura admin secret for admin permissions in requests.
+ */
+/**
+ * Creates a fetch middleware that attaches the Hasura admin secret and optional session variables to requests.
+ *
+ * This middleware:
+ * 1. Sets the x-hasura-admin-secret header, which grants full admin access to Hasura
+ * 2. Optionally sets the x-hasura-role header if a role is provided
+ * 3. Optionally sets additional x-hasura-* headers for custom session variables
+ *
+ * **Security Warning**: Never use this middleware in client-side code or expose
+ * the admin secret to end users. Admin secrets grant unrestricted access to your
+ * entire database. This should only be used in trusted server-side environments.
+ *
+ * The middleware preserves request-specific headers when they conflict with the
+ * admin session configuration.
+ *
+ * @param options - Admin session options including admin secret, role, and session variables
+ * @returns A middleware function that can be used in the fetch chain
+ *
+ * @example
+ * ```ts
+ * // Create middleware with admin secret only
+ * const adminMiddleware = withAdminSessionMiddleware({
+ *   adminSecret: process.env.NHOST_ADMIN_SECRET
+ * });
+ *
+ * // Create middleware with admin secret and role
+ * const adminUserMiddleware = withAdminSessionMiddleware({
+ *   adminSecret: process.env.NHOST_ADMIN_SECRET,
+ *   role: 'user'
+ * });
+ *
+ * // Create middleware with admin secret, role, and custom session variables
+ * const fullMiddleware = withAdminSessionMiddleware({
+ *   adminSecret: process.env.NHOST_ADMIN_SECRET,
+ *   role: 'user',
+ *   sessionVariables: {
+ *     'user-id': '123',
+ *     'org-id': '456'
+ *   }
+ * });
+ *
+ * // Use with createCustomClient for an admin client
+ * const adminClient = createCustomClient({
+ *   subdomain: 'myproject',
+ *   region: 'eu-central-1',
+ *   chainFunctions: [adminMiddleware]
+ * });
+ * ```
+ */
+export const withAdminSessionMiddleware = (options) => (next) => async (url, requestOptions = {}) => {
+    const headers = new Headers(requestOptions.headers || {});
+    // Set x-hasura-admin-secret if not already present
+    if (!headers.has("x-hasura-admin-secret")) {
+        headers.set("x-hasura-admin-secret", options.adminSecret);
+    }
+    // Set x-hasura-role if provided and not already present
+    if (options.role && !headers.has("x-hasura-role")) {
+        headers.set("x-hasura-role", options.role);
+    }
+    // Set custom session variables
+    if (options.sessionVariables) {
+        for (const [key, value] of Object.entries(options.sessionVariables)) {
+            // Ensure the key has the x-hasura- prefix
+            const headerKey = key.startsWith("x-hasura-") ? key : `x-hasura-${key}`;
+            // Only set if not already present in the request
+            if (!headers.has(headerKey)) {
+                headers.set(headerKey, value);
+            }
+        }
+    }
+    return next(url, { ...requestOptions, headers });
+};
+//# sourceMappingURL=middlewareWithAdminSession.js.map

package/dist/src/fetch/middlewareWithAdminSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareWithAdminSession.js","sourceRoot":"","sources":["../../../src/fetch/middlewareWithAdminSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,CAAC,MAAM,0BAA0B,GACrC,CAAC,OAA4B,EAAiB,EAAE,CAChD,CAAC,IAAmB,EAAiB,EAAE,CACvC,KAAK,EAAE,GAAW,EAAE,iBAA8B,EAAE,EAAqB,EAAE;IACzE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAE1D,mDAAmD;IACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,CAAC;IAED,wDAAwD;IACxD,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpE,0CAA0C;YAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC;YAExE,iDAAiD;YACjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/src/fetch/middlewareWithHeaders.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Headers middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically attach
+ * default headers to all outgoing requests, while allowing request-specific
+ * headers to take precedence.
+ */
+import type { ChainFunction } from "./fetch";
+/**
+ * Creates a fetch middleware that attaches default headers to requests.
+ *
+ * This middleware:
+ * 1. Merges default headers with request-specific headers
+ * 2. Preserves request-specific headers when they conflict with defaults
+ *
+ * The middleware ensures consistent headers across requests while allowing
+ * individual requests to override defaults as needed.
+ *
+ * @param defaultHeaders - Default headers to attach to all requests
+ * @returns A middleware function that can be used in the fetch chain
+ */
+export declare const withHeadersMiddleware: (defaultHeaders: HeadersInit) => ChainFunction;
+//# sourceMappingURL=middlewareWithHeaders.d.ts.map

package/dist/src/fetch/middlewareWithHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareWithHeaders.d.ts","sourceRoot":"","sources":["../../../src/fetch/middlewareWithHeaders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAC/B,gBAAgB,WAAW,KAAG,aAa9B,CAAC"}

package/dist/src/fetch/middlewareWithHeaders.js

@@ -0,0 +1,31 @@
+/**
+ * Headers middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically attach
+ * default headers to all outgoing requests, while allowing request-specific
+ * headers to take precedence.
+ */
+/**
+ * Creates a fetch middleware that attaches default headers to requests.
+ *
+ * This middleware:
+ * 1. Merges default headers with request-specific headers
+ * 2. Preserves request-specific headers when they conflict with defaults
+ *
+ * The middleware ensures consistent headers across requests while allowing
+ * individual requests to override defaults as needed.
+ *
+ * @param defaultHeaders - Default headers to attach to all requests
+ * @returns A middleware function that can be used in the fetch chain
+ */
+export const withHeadersMiddleware = (defaultHeaders) => (next) => async (url, options = {}) => {
+    const headers = new Headers(options.headers || {});
+    const defaults = new Headers(defaultHeaders);
+    defaults.forEach((value, key) => {
+        if (!headers.has(key)) {
+            headers.set(key, value);
+        }
+    });
+    return next(url, { ...options, headers });
+};
+//# sourceMappingURL=middlewareWithHeaders.js.map

package/dist/src/fetch/middlewareWithHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareWithHeaders.js","sourceRoot":"","sources":["../../../src/fetch/middlewareWithHeaders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,CAAC,cAA2B,EAAiB,EAAE,CAC/C,CAAC,IAAmB,EAAiB,EAAE,CACvC,KAAK,EAAE,GAAW,EAAE,UAAuB,EAAE,EAAqB,EAAE;IAClE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAE7C,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC"}

package/dist/src/fetch/middlewareWithRole.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Role middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically set
+ * the Hasura role for all requests. This is useful when you want to
+ * make requests as a specific role without using the admin secret.
+ */
+import type { ChainFunction } from "./fetch";
+/**
+ * Creates a fetch middleware that sets the Hasura role header.
+ *
+ * This middleware sets the x-hasura-role header for all requests, allowing
+ * you to specify which role's permissions should be used. This works with
+ * authenticated sessions where the user has access to the specified role.
+ *
+ * Unlike `withAdminSessionMiddleware`, this does not bypass permission rules
+ * but instead uses the permission rules defined for the specified role.
+ *
+ * The middleware preserves request-specific headers when they conflict with
+ * the role configuration.
+ *
+ * @param role - The Hasura role to use for requests
+ * @returns A middleware function that can be used in the fetch chain
+ *
+ * @example
+ * ```ts
+ * // Use with createClient to default all requests to a specific role
+ * const nhost = createClient({
+ *   subdomain: 'myproject',
+ *   region: 'eu-central-1',
+ *   chainFunctions: [withRoleMiddleware('moderator')]
+ * });
+ *
+ * // Use with createServerClient for server-side requests
+ * const serverNhost = createServerClient({
+ *   subdomain: 'myproject',
+ *   region: 'eu-central-1',
+ *   storage: myServerStorage,
+ *   chainFunctions: [withRoleMiddleware('moderator')]
+ * });
+ * ```
+ */
+export declare const withRoleMiddleware: (role: string) => ChainFunction;
+//# sourceMappingURL=middlewareWithRole.d.ts.map

package/dist/src/fetch/middlewareWithRole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareWithRole.d.ts","sourceRoot":"","sources":["../../../src/fetch/middlewareWithRole.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,kBAAkB,GAC5B,MAAM,MAAM,KAAG,aAWf,CAAC"}

package/dist/src/fetch/middlewareWithRole.js

@@ -0,0 +1,50 @@
+/**
+ * Role middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically set
+ * the Hasura role for all requests. This is useful when you want to
+ * make requests as a specific role without using the admin secret.
+ */
+/**
+ * Creates a fetch middleware that sets the Hasura role header.
+ *
+ * This middleware sets the x-hasura-role header for all requests, allowing
+ * you to specify which role's permissions should be used. This works with
+ * authenticated sessions where the user has access to the specified role.
+ *
+ * Unlike `withAdminSessionMiddleware`, this does not bypass permission rules
+ * but instead uses the permission rules defined for the specified role.
+ *
+ * The middleware preserves request-specific headers when they conflict with
+ * the role configuration.
+ *
+ * @param role - The Hasura role to use for requests
+ * @returns A middleware function that can be used in the fetch chain
+ *
+ * @example
+ * ```ts
+ * // Use with createClient to default all requests to a specific role
+ * const nhost = createClient({
+ *   subdomain: 'myproject',
+ *   region: 'eu-central-1',
+ *   chainFunctions: [withRoleMiddleware('moderator')]
+ * });
+ *
+ * // Use with createServerClient for server-side requests
+ * const serverNhost = createServerClient({
+ *   subdomain: 'myproject',
+ *   region: 'eu-central-1',
+ *   storage: myServerStorage,
+ *   chainFunctions: [withRoleMiddleware('moderator')]
+ * });
+ * ```
+ */
+export const withRoleMiddleware = (role) => (next) => async (url, requestOptions = {}) => {
+    const headers = new Headers(requestOptions.headers || {});
+    // Set x-hasura-role if not already present
+    if (!headers.has("x-hasura-role")) {
+        headers.set("x-hasura-role", role);
+    }
+    return next(url, { ...requestOptions, headers });
+};
+//# sourceMappingURL=middlewareWithRole.js.map

package/dist/src/fetch/middlewareWithRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareWithRole.js","sourceRoot":"","sources":["../../../src/fetch/middlewareWithRole.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,CAAC,IAAY,EAAiB,EAAE,CAChC,CAAC,IAAmB,EAAiB,EAAE,CACvC,KAAK,EAAE,GAAW,EAAE,iBAA8B,EAAE,EAAqB,EAAE;IACzE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAE1D,2CAA2C;IAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/src/functions/client.d.ts

@@ -10,6 +10,10 @@ import { type ChainFunction, type FetchResponse } from "../fetch";
  */
 export interface Client {
     baseURL: string;
+    /** Add a middleware function to the fetch chain
+     * @param chainFunction - The middleware function to add
+     */
+    pushChainFunction(chainFunction: ChainFunction): void;
     /**
      * Execute a request to a serverless function
      * The response body will be automatically parsed based on the content type into the following types:
@@ -19,7 +23,8 @@ export interface Client {
      *
      * @param path - The path to the serverless function
      * @param options - Additional fetch options to apply to the request
-     * @returns Promise with the function response and metadata.    */
+     * @returns Promise with the function response and metadata.
+     */
     fetch<T = unknown>(path: string, options?: RequestInit): Promise<FetchResponse<T>>;
     /**
      * Executes a POST request to a serverless function with a JSON body

package/dist/src/functions/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/functions/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;sEASkE;IAClE,KAAK,CAAC,CAAC,GAAG,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,iBAAgB,aAAa,EAAO,KACnC,MAiFF,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/functions/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAEtD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,iBAAgB,aAAa,EAAO,KACnC,MAuFF,CAAC"}

package/dist/src/functions/client.js

@@ -17,7 +17,11 @@ import { createEnhancedFetch, FetchError, } from "../fetch";
  * @returns Functions client with fetch method
  */
 export const createAPIClient = (baseURL, chainFunctions = []) => {
-    const enhancedFetch = createEnhancedFetch(chainFunctions);
+    let enhancedFetch = createEnhancedFetch(chainFunctions);
+    const pushChainFunction = (chainFunction) => {
+        chainFunctions.push(chainFunction);
+        enhancedFetch = createEnhancedFetch(chainFunctions);
+    };
     /**
      * Executes a request to a serverless function and processes the response
      *
@@ -84,6 +88,7 @@ export const createAPIClient = (baseURL, chainFunctions = []) => {
         baseURL,
         fetch,
         post,
+        pushChainFunction,
     };
 };
 //# sourceMappingURL=client.js.map

package/dist/src/functions/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/functions/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,mBAAmB,EACnB,UAAU,GAEX,MAAM,UAAU,CAAC;AA4ClB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAe,EACf,iBAAkC,EAAE,EAC5B,EAAE;IACV,MAAM,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAE1D;;;;;;;;;OASG;IACH,MAAM,KAAK,GAAG,KAAK,EACjB,IAAY,EACZ,OAAqB,EACsB,EAAE;QAC7C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAE/D,IAAI,IAAuB,CAAC;QAC5B,yCAAyC;QACzC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAM,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACjE,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC,CAAC;IAEF;;;;;;;;;;;;;OAaG;IACH,MAAM,IAAI,GAAG,KAAK,EAChB,IAAY,EACZ,IAAc,EACd,UAAuB,EAAE,EACkB,EAAE;QAC7C,6CAA6C;QAC7C,MAAM,cAAc,GAAgB;YAClC,GAAG,OAAO;YACV,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,CAAC,OAAO;aACnB;YACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC;QAEF,OAAO,KAAK,CAAI,IAAI,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,6CAA6C;IAC7C,OAAO;QACL,OAAO;QACP,KAAK;QACL,IAAI;KACK,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/functions/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,mBAAmB,EACnB,UAAU,GAEX,MAAM,UAAU,CAAC;AAkDlB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAe,EACf,iBAAkC,EAAE,EAC5B,EAAE;IACV,IAAI,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAExD,MAAM,iBAAiB,GAAG,CAAC,aAA4B,EAAE,EAAE;QACzD,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnC,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF;;;;;;;;;OASG;IACH,MAAM,KAAK,GAAG,KAAK,EACjB,IAAY,EACZ,OAAqB,EACsB,EAAE;QAC7C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAE/D,IAAI,IAAuB,CAAC;QAC5B,yCAAyC;QACzC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAM,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACjE,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC,CAAC;IAEF;;;;;;;;;;;;;OAaG;IACH,MAAM,IAAI,GAAG,KAAK,EAChB,IAAY,EACZ,IAAc,EACd,UAAuB,EAAE,EACkB,EAAE;QAC7C,6CAA6C;QAC7C,MAAM,cAAc,GAAgB;YAClC,GAAG,OAAO;YACV,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,CAAC,OAAO;aACnB;YACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC;QAEF,OAAO,KAAK,CAAI,IAAI,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,6CAA6C;IAC7C,OAAO;QACL,OAAO;QACP,KAAK;QACL,IAAI;QACJ,iBAAiB;KACR,CAAC;AACd,CAAC,CAAC"}

package/dist/src/graphql/client.d.ts

@@ -77,6 +77,10 @@ export interface Client {
      * URL for the GraphQL endpoint.
      */
     url: string;
+    /** Add a middleware function to the fetch chain
+     * @param chainFunction - The middleware function to add
+     */
+    pushChainFunction(chainFunction: ChainFunction): void;
 }
 /**
  * Creates a GraphQL API client for interacting with a GraphQL endpoint.

package/dist/src/graphql/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/graphql/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU,GAAG,gBAAgB;IAC3D,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,aAAa,GAAG,OAAO;IACtD,kDAAkD;IAClD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa,GAAG,OAAO,EAAE,UAAU,GAAG,gBAAgB,EAC5D,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,EACnC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa,EAAE,UAAU,GAAG,gBAAgB,EAClD,QAAQ,EAAE,iBAAiB,CAAC,aAAa,EAAE,UAAU,CAAC,EACtD,SAAS,CAAC,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1D;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,MAAM,EACX,iBAAgB,aAAa,EAAO,KACnC,MA6EF,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/graphql/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU,GAAG,gBAAgB;IAC3D,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,aAAa,GAAG,OAAO;IACtD,kDAAkD;IAClD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa,GAAG,OAAO,EAAE,UAAU,GAAG,gBAAgB,EAC5D,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,EACnC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa,EAAE,UAAU,GAAG,gBAAgB,EAClD,QAAQ,EAAE,iBAAiB,CAAC,aAAa,EAAE,UAAU,CAAC,EACtD,SAAS,CAAC,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1D;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,MAAM,EACX,iBAAgB,aAAa,EAAO,KACnC,MAmFF,CAAC"}

package/dist/src/graphql/client.js

@@ -17,7 +17,11 @@ import { createEnhancedFetch, FetchError, } from "../fetch";
  * @returns GraphQL client with query and mutation methods
  */
 export const createAPIClient = (url, chainFunctions = []) => {
-    const enhancedFetch = createEnhancedFetch(chainFunctions);
+    let enhancedFetch = createEnhancedFetch(chainFunctions);
+    const pushChainFunction = (chainFunction) => {
+        chainFunctions.push(chainFunction);
+        enhancedFetch = createEnhancedFetch(chainFunctions);
+    };
     const executeOperation = async (request, options) => {
         const response = await enhancedFetch(`${url}`, {
             method: "POST",
@@ -61,6 +65,7 @@ export const createAPIClient = (url, chainFunctions = []) => {
     return {
         request,
         url,
+        pushChainFunction,
     };
 };
 //# sourceMappingURL=client.js.map

package/dist/src/graphql/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/graphql/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,mBAAmB,EACnB,UAAU,GAEX,MAAM,UAAU,CAAC;AAkFlB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAW,EACX,iBAAkC,EAAE,EAC5B,EAAE;IACV,MAAM,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAE1D,MAAM,gBAAgB,GAAG,KAAK,EAI5B,OAAmC,EACnC,OAAqB,EACmC,EAAE;QAC1D,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,GAAG,EAAE,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,GAAG,OAAO;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAmC,CAC3C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CACK,CAAC;QAEpC,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAWF,SAAS,OAAO,CACd,iBAEgD,EAChD,kBAA6C,EAC7C,OAAqB;QAErB,IAAI,OAAO,iBAAiB,KAAK,QAAQ,IAAI,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACzE,MAAM,UAAU,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAEpD,MAAM,OAAO,GAA+B;gBAC1C,KAAK,EAAE,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBAC/C,SAAS,EAAE,kBAAgC;gBAC3C,aAAa,EACX,UAAU,IAAI,MAAM,IAAI,UAAU;oBAChC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK;oBACxB,CAAC,CAAC,SAAS;aAChB,CAAC;YACF,OAAO,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,wBAAwB;YACxB,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAClC,MAAM,cAAc,GAAG,kBAAiC,CAAC;YACzD,OAAO,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,GAAG;KACM,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/graphql/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,mBAAmB,EACnB,UAAU,GAEX,MAAM,UAAU,CAAC;AAuFlB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAW,EACX,iBAAkC,EAAE,EAC5B,EAAE;IACV,IAAI,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAExD,MAAM,iBAAiB,GAAG,CAAC,aAA4B,EAAE,EAAE;QACzD,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnC,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,KAAK,EAI5B,OAAmC,EACnC,OAAqB,EACmC,EAAE;QAC1D,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,GAAG,EAAE,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,GAAG,OAAO;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAmC,CAC3C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CACK,CAAC;QAEpC,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAWF,SAAS,OAAO,CACd,iBAEgD,EAChD,kBAA6C,EAC7C,OAAqB;QAErB,IAAI,OAAO,iBAAiB,KAAK,QAAQ,IAAI,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACzE,MAAM,UAAU,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAEpD,MAAM,OAAO,GAA+B;gBAC1C,KAAK,EAAE,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBAC/C,SAAS,EAAE,kBAAgC;gBAC3C,aAAa,EACX,UAAU,IAAI,MAAM,IAAI,UAAU;oBAChC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK;oBACxB,CAAC,CAAC,SAAS;aAChB,CAAC;YACF,OAAO,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,wBAAwB;YACxB,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAClC,MAAM,cAAc,GAAG,kBAAiC,CAAC;YACzD,OAAO,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,GAAG;QACH,iBAAiB;KACR,CAAC;AACd,CAAC,CAAC"}

package/dist/src/index.d.ts

@@ -17,11 +17,21 @@
  *
  * Create a client instance to interact with Nhost services:
  *
- * {@includeCode ./__tests__/docstrings.test.ts:11-115}
+ * {@includeCode ./__tests__/docstrings.test.ts:15-119}
+ *
+ * ### Creating an admin client
+ *
+ * You can also create an admin client if needed. This client will have admin access to the database
+ * and will bypass permissions. Additionally, it can impersonate users and set any role or session
+ * variable.
+ *
+ * IMPORTANT!!! Keep your admin secret safe and never expose it in client-side code.
+ *
+ * {@includeCode ./__tests__/docstrings.test.ts:142-201}
  *
  * @packageDocumentation
  */
-export { createClient, createServerClient, type NhostClient, type NhostClientOptions, type NhostServerClientOptions, } from "./nhost";
+export { type ClientConfigurationFn, createClient, createNhostClient, createServerClient, type NhostClient, type NhostClientOptions, type NhostServerClientOptions, withAdminSession, withClientSideSessionMiddleware, withServerSideSessionMiddleware, } from "./nhost";
 /**
  * Generates a base URL for a Nhost service based on configuration
  *

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,EACzD,YAAY,MAAM,EAClB,SAAS,MAAM,EACf,YAAY,MAAM,KACjB,MAQF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC1B,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,gBAAgB,EAChB,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,EACzD,YAAY,MAAM,EAClB,SAAS,MAAM,EACf,YAAY,MAAM,KACjB,MAQF,CAAC"}

package/dist/src/index.js

@@ -17,11 +17,21 @@
  *
  * Create a client instance to interact with Nhost services:
  *
- * {@includeCode ./__tests__/docstrings.test.ts:11-115}
+ * {@includeCode ./__tests__/docstrings.test.ts:15-119}
+ *
+ * ### Creating an admin client
+ *
+ * You can also create an admin client if needed. This client will have admin access to the database
+ * and will bypass permissions. Additionally, it can impersonate users and set any role or session
+ * variable.
+ *
+ * IMPORTANT!!! Keep your admin secret safe and never expose it in client-side code.
+ *
+ * {@includeCode ./__tests__/docstrings.test.ts:142-201}
  *
  * @packageDocumentation
  */
-export { createClient, createServerClient, } from "./nhost";
+export { createClient, createNhostClient, createServerClient, withAdminSession, withClientSideSessionMiddleware, withServerSideSessionMiddleware, } from "./nhost";
 /**
  * Generates a base URL for a Nhost service based on configuration
  *

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,GAInB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,WAAyD,EACzD,SAAkB,EAClB,MAAe,EACf,SAAkB,EACV,EAAE;IACV,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QAC/B,OAAO,WAAW,SAAS,IAAI,WAAW,IAAI,MAAM,eAAe,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,iBAAiB,WAAW,qBAAqB,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAEL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAIlB,gBAAgB,EAChB,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,WAAyD,EACzD,SAAkB,EAClB,MAAe,EACf,SAAkB,EACV,EAAE;IACV,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QAC/B,OAAO,WAAW,SAAS,IAAI,WAAW,IAAI,MAAM,eAAe,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,iBAAiB,WAAW,qBAAqB,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC"}