{"id":18838,"library":"supabase-auth-helpers-qwik","title":"@supabase/auth-helpers-qwik","description":"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.","status":"active","version":"0.0.3","language":"javascript","source_language":"en","source_url":"https://github.com/BuilderIO/qwik","tags":["javascript","Supabase","Auth","Qwik","typescript"],"install":[{"cmd":"npm install supabase-auth-helpers-qwik","lang":"bash","label":"npm"},{"cmd":"yarn add supabase-auth-helpers-qwik","lang":"bash","label":"yarn"},{"cmd":"pnpm add supabase-auth-helpers-qwik","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core Supabase client for auth operations","package":"@supabase/supabase-js","optional":false}],"imports":[{"note":"ESM only; package does not provide CJS exports.","wrong":"const createClient = require('@supabase/auth-helpers-qwik')","symbol":"createClient","correct":"import { createClient } from '@supabase/auth-helpers-qwik'"},{"note":"Type for the auth session context; available from this package.","wrong":"import { AuthSession } from '@supabase/supabase-js'","symbol":"AuthSession","correct":"import { AuthSession } from '@supabase/auth-helpers-qwik'"},{"note":"Hook or composable specific to Qwik; not a React hook.","wrong":"import { useSupabaseClient } from '@supabase/supabase-js'","symbol":"useSupabaseClient","correct":"import { useSupabaseClient } from '@supabase/auth-helpers-qwik'"}],"quickstart":{"code":"import { createClient, useSupabaseClient, AuthSession } from '@supabase/auth-helpers-qwik';\nimport { component$, useMount$, useSignal } from '@builder.io/qwik';\n\nexport default component$(() => {\n  const supabase = useSupabaseClient();\n  const session = useSignal<AuthSession | null>(null);\n\n  useMount$(async () => {\n    const { data: { session: s } } = await supabase.auth.getSession();\n    session.value = s;\n  });\n\n  return (\n    <div>\n      {session.value ? (\n        <p>Logged in as {session.value.user?.email}</p>\n      ) : (\n        <p>Not logged in</p>\n      )}\n    </div>\n  );\n});","lang":"typescript","description":"Shows basic usage: create a Supabase client via context, fetch session on mount, and conditionally display user info."},"warnings":[{"fix":"Pin to exact version and monitor releases.","message":"Package is in beta (0.0.3); breaking changes may occur without major version bump.","severity":"breaking","affected_versions":">=0.0.1"},{"fix":"Ensure your app wraps with a provider that calls createClient.","message":"useSupabaseClient requires a parent provider for the Supabase client context.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Use import statements and ensure your project is configured for ESM.","message":"The package is ESM-only and cannot be used with require() or in CommonJS contexts.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Wrap async operations in $() or use useAsync$ appropriately.","message":"The package uses Qwik's $() pattern; mixing with non-$ functions may cause issues.","severity":"gotcha","affected_versions":">=0.0.1"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install the package: npm install @supabase/auth-helpers-qwik and ensure tsconfig includes 'node' in types.","cause":"Package not installed or type resolution not configured.","error":"Cannot find module '@supabase/auth-helpers-qwik' or its corresponding type declarations."},{"fix":"Ensure you use createClient from this package and not from @supabase/supabase-js directly.","cause":"Supabase client not initialized or wrong import.","error":"Uncaught (in promise) TypeError: supabase.auth.getSession is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}