Registry / auth-security / supabase-auth-helpers-qwik

supabase-auth-helpers-qwik

library0.0.3jsnpmunverified

Beta Qwik-specific auth utilities for Supabase, version 0.0.3. Provides convenience helpers for implementing user authentication in Qwik applications, leveraging resumability and the Qwik framework's unique architecture. Requires peer dependency @supabase/supabase-js ^2.0.4. As a beta package, it may have breaking changes without notice. It is part of the broader supabase/auth-helpers ecosystem, targeting Qwik specifically. Differentiators include integration with Qwik's $() async patterns and server-side rendering capabilities.

auth-security web-framework

npm install supabase-auth-helpers-qwik

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SUPABASE-AUTH-HELP

supabase-auth-helpers-qwik

auth-securityjavascriptv0.0.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createClient

✓ import { createClient } from '@supabase/auth-helpers-qwik'

✗ const createClient = require('@supabase/auth-helpers-qwik')

ESM only; package does not provide CJS exports.

AuthSession

✓ import { AuthSession } from '@supabase/auth-helpers-qwik'

✗ import { AuthSession } from '@supabase/supabase-js'

Type for the auth session context; available from this package.

useSupabaseClient

✓ import { useSupabaseClient } from '@supabase/auth-helpers-qwik'

✗ import { useSupabaseClient } from '@supabase/supabase-js'

Hook or composable specific to Qwik; not a React hook.

Shows basic usage: create a Supabase client via context, fetch session on mount, and conditionally display user info.

import { createClient, useSupabaseClient, AuthSession } from '@supabase/auth-helpers-qwik'; import { component$, useMount$, useSignal } from '@builder.io/qwik'; export default component$(() => { const supabase = useSupabaseClient(); const session = useSignal<AuthSession | null>(null); useMount$(async () => { const { data: { session: s } } = await supabase.auth.getSession(); session.value = s; }); return ( <div> {session.value ? ( <p>Logged in as {session.value.user?.email}</p> ) : ( <p>Not logged in</p> )} </div> ); });

Debug

Known issues

breakingPackage is in beta (0.0.3); breaking changes may occur without major version bump.

fix

Pin to exact version and monitor releases.

affects: >=0.0.1

gotchauseSupabaseClient requires a parent provider for the Supabase client context.

fix

Ensure your app wraps with a provider that calls createClient.

affects: >=0.0.1

gotchaThe package is ESM-only and cannot be used with require() or in CommonJS contexts.

fix

Use import statements and ensure your project is configured for ESM.

affects: >=0.0.1

gotchaThe package uses Qwik's $() pattern; mixing with non-$ functions may cause issues.

fix

Wrap async operations in $() or use useAsync$ appropriately.

affects: >=0.0.1

Errors

Common errors & fixes

Cannot find module '@supabase/auth-helpers-qwik' or its corresponding type declarations.

Package not installed or type resolution not configured.

fix

Install the package: npm install @supabase/auth-helpers-qwik and ensure tsconfig includes 'node' in types.

Uncaught (in promise) TypeError: supabase.auth.getSession is not a function

Supabase client not initialized or wrong import.

fix

Ensure you use createClient from this package and not from @supabase/supabase-js directly.

Upgrade

Version history

0.0.3latest on npm

Audit

Dependencies

@supabase/supabase-jsrequiredCore Supabase client for auth operations

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/BuilderIO/qwik ↗

packagehttps://www.npmjs.com/package/supabase-auth-helpers-qwik ↗

homepagehttps://qwik.builder.io/ ↗