{"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,"search_vec":"'0.0.3':11 '2.0.4':35 'applic':21 'architectur':30 'async':64 'auth':6,74 'authent':18 'beta':2,38 'break':43 'broader':52 'capabl':71 'chang':44 'conveni':13 'depend':33 'differenti':58 'ecosystem':54 'framework':27 'helper':14 'implement':16 'includ':59 'integr':60 'javascript':72 'leverag':22 'may':41 'notic':46 'packag':39 'part':49 'pattern':65 'peer':32 'provid':12 'qwik':4,20,26,56,62,75 'qwik-specif':3 'render':70 'requir':31 'resum':23 'server':68 'server-sid':67 'side':69 'specif':5,57 'supabas':9,73 'supabase/auth-helpers':53 'supabase/auth-helpers-qwik':1 'supabase/supabase-js':34 'target':55 'typescript':76 'uniqu':29 'user':17 'util':7 'version':10 'without':45","created_at":"2026-04-25T07:40:23.815725+00:00","updated_at":"2026-04-25T07:40:23.815725+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":"https://qwik.builder.io/","github":"https://github.com/BuilderIO/qwik","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/supabase-auth-helpers-qwik","openapi_spec":null,"status_page":null,"smithery":null,"categories":["auth-security","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-17","next_check":"2026-07-24","install_tag":null}}