create-convex-monorepo 0.2.0

package/dist/generator/index.js

@@ -0,0 +1,123 @@
+import { lstat, mkdir, mkdtemp, readdir, copyFile, unlink, rm, rmdir, } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { constants } from 'node:fs';
+import { createContext } from './context.js';
+import { normalizeOptions } from './options.js';
+import { generateRoot } from '../templates/root/index.js';
+import { generateBackend } from '../templates/backend/index.js';
+import { appTemplates } from '../templates/apps/index.js';
+import { authAdapters } from '../integrations/auth/index.js';
+import { pnpm, runCommand } from '../package-manager/index.js';
+export { normalizeOptions, validateProjectName } from './options.js';
+export function selectTemplate(framework) {
+    const template = appTemplates[framework];
+    if (!template)
+        throw new Error(`Unsupported framework: ${framework}`);
+    return template;
+}
+export async function generateProject(raw, settings = {}) {
+    settings.signal?.throwIfAborted();
+    const options = normalizeOptions(raw);
+    const cwd = resolve(settings.cwd ?? process.cwd());
+    const target = join(cwd, options.name);
+    let existingEmpty = false;
+    let originalIdentity;
+    try {
+        const stat = await lstat(target);
+        if (stat.isSymbolicLink() ||
+            !stat.isDirectory() ||
+            (await readdir(target)).length > 0)
+            throw new Error(`Refusing to overwrite ${target}. Choose a new or empty directory.`);
+        existingEmpty = true;
+        originalIdentity = { dev: stat.dev, ino: stat.ino };
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    await mkdir(cwd, { recursive: true });
+    const staging = await mkdtemp(join(cwd, `.${options.name}-`));
+    let createdTarget = false;
+    const committed = [];
+    async function commitDirectory(source, destination) {
+        for (const entry of await readdir(source, { withFileTypes: true })) {
+            settings.signal?.throwIfAborted();
+            const from = join(source, entry.name);
+            const to = join(destination, entry.name);
+            if (entry.isDirectory()) {
+                await mkdir(to);
+                committed.push({ path: to, directory: true });
+                await commitDirectory(from, to);
+            }
+            else if (entry.isFile()) {
+                await copyFile(from, to, constants.COPYFILE_EXCL);
+                committed.push({ path: to, directory: false });
+            }
+            else {
+                throw new Error(`Unsupported generated file: ${from}`);
+            }
+        }
+    }
+    try {
+        const context = createContext(staging, options);
+        await generateRoot(context);
+        await generateBackend(context);
+        settings.onProgress?.('Added packages/backend');
+        for (const app of options.apps) {
+            settings.signal?.throwIfAborted();
+            await selectTemplate(app.framework).generate(context, app);
+            settings.onProgress?.(`Added apps/${app.name}`);
+        }
+        await authAdapters[options.auth].apply(context);
+        settings.signal?.throwIfAborted();
+        if (existingEmpty) {
+            const current = await lstat(target);
+            if (current.isSymbolicLink() ||
+                current.dev !== originalIdentity?.dev ||
+                current.ino !== originalIdentity.ino ||
+                (await readdir(target)).length) {
+                throw new Error(`Destination changed during generation: ${target}`);
+            }
+        }
+        else {
+            await mkdir(target);
+            createdTarget = true;
+        }
+        // Exclusive copies work on Windows too, where renaming over an existing
+        // directory fails. Roll back only entries created by this invocation.
+        await commitDirectory(staging, target);
+        await rm(staging, { recursive: true, force: true });
+    }
+    catch (error) {
+        for (const entry of committed.reverse()) {
+            await (entry.directory ? rmdir(entry.path) : unlink(entry.path)).catch(() => undefined);
+        }
+        await rm(staging, { recursive: true, force: true });
+        if (createdTarget)
+            await rmdir(target).catch(() => undefined);
+        throw error;
+    }
+    let recovery = 'pnpm install';
+    try {
+        if (options.install) {
+            await pnpm.install(target, settings.signal);
+            settings.onProgress?.('Installed dependencies');
+        }
+        if (options.git) {
+            recovery = 'git init';
+            await runCommand('git', ['init'], target, settings.signal);
+            settings.onProgress?.('Initialized git');
+        }
+        if (options.initConvex) {
+            recovery = 'pnpm convex:setup';
+            settings.onProgress?.('Starting Convex setup');
+            await runCommand('pnpm', ['convex:setup'], target, settings.signal);
+            settings.onProgress?.('Initialized Convex and linked frontend URLs');
+        }
+    }
+    catch (error) {
+        throw new Error(`Project files are ready at ${target}, but setup failed. ${error instanceof Error ? error.message : String(error)}\nRun ${recovery} in that directory to retry.`, { cause: error });
+    }
+    return target;
+}
+//# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"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"}

package/dist/generator/options.d.ts

@@ -0,0 +1,15 @@
+import type { AppSpec, Framework, ProjectOptions } from './types.js';
+export interface RawOptions {
+    name?: string;
+    apps?: string | AppSpec[];
+    auth?: string;
+    example?: string;
+    packageManager?: string;
+    install?: boolean;
+    initConvex?: boolean;
+    git?: boolean;
+    yes?: boolean;
+}
+export declare const frameworks: readonly Framework[];
+export declare function validateProjectName(name: string): string | undefined;
+export declare function normalizeOptions(raw: RawOptions): ProjectOptions;

package/dist/generator/options.js

@@ -0,0 +1,85 @@
+export const frameworks = [
+    'next',
+    'vite',
+    'tanstack-start',
+    'expo',
+];
+const reserved = /^(?:con|prn|aux|nul|com[0-9]|lpt[0-9]|node_modules)$/i;
+export function validateProjectName(name) {
+    if (name.length > 100 ||
+        !/^[a-z0-9][a-z0-9-]*$/.test(name) ||
+        reserved.test(name)) {
+        return 'Use a lowercase name of 1–100 letters, numbers, or hyphens, starting with a letter or number. Paths and reserved names are not allowed.';
+    }
+    return undefined;
+}
+export function normalizeOptions(raw) {
+    const name = raw.name ?? 'my-app';
+    const error = validateProjectName(name);
+    if (error)
+        throw new Error(`Invalid project name "${name}". ${error}`);
+    if (raw.packageManager !== undefined && raw.packageManager !== 'pnpm')
+        throw new Error('Only pnpm is supported in v0.1.');
+    const initConvex = raw.initConvex ?? false;
+    if (initConvex && raw.install === false)
+        throw new Error('--init-convex requires dependencies. Omit --no-install or use --no-init-convex.');
+    const example = raw.example ?? 'messages';
+    if (example !== 'none' && example !== 'messages')
+        throw new Error(`Unknown example "${example}". Choose none or messages.`);
+    const auth = raw.auth ?? 'none';
+    if (auth !== 'none' && auth !== 'clerk')
+        throw new Error(`Unknown auth provider "${auth}". Choose none or clerk.`);
+    const used = new Set();
+    const input = raw.apps ?? 'next';
+    const entries = typeof input === 'string'
+        ? input.split(',').map((entry) => {
+            const parts = entry.trim().split(':');
+            if (parts.length > 2 || parts.some((part) => !part))
+                throw new Error(`Invalid app selection "${entry}". Use framework or name:framework.`);
+            return {
+                name: parts.length === 2 ? parts[0] : undefined,
+                framework: parts.at(-1),
+            };
+        })
+        : input.map((app) => ({ ...app }));
+    if (!entries.length)
+        throw new Error('Select at least one application.');
+    const apps = entries.map((entry) => {
+        if (!frameworks.includes(entry.framework))
+            throw new Error(`Unknown framework "${entry.framework}". Choose ${frameworks.join(', ')}.`);
+        const framework = entry.framework;
+        let appName = entry.name;
+        if (appName === undefined) {
+            const base = framework === 'expo'
+                ? 'mobile'
+                : used.has('web')
+                    ? framework === 'vite'
+                        ? 'admin'
+                        : 'app'
+                    : 'web';
+            appName = base;
+            for (let suffix = 2; used.has(appName); suffix++)
+                appName = `${base}-${suffix}`;
+        }
+        if (validateProjectName(appName))
+            throw new Error(`Invalid application name "${appName}".`);
+        if (['backend', 'typescript-config', 'eslint-config'].includes(appName)) {
+            throw new Error(`Application name "${appName}" is reserved for a shared package.`);
+        }
+        if (used.has(appName))
+            throw new Error(`Duplicate application name "${appName}".`);
+        used.add(appName);
+        return { name: appName, framework };
+    });
+    return {
+        name,
+        apps,
+        auth: auth,
+        example,
+        packageManager: 'pnpm',
+        install: raw.install ?? (initConvex || raw.yes || false),
+        initConvex,
+        git: raw.git ?? raw.yes ?? false,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/generator/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/generator/options.ts"],"names":[],"mappings":"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"}

package/dist/generator/types.d.ts

@@ -0,0 +1,47 @@
+export type Framework = 'next' | 'vite' | 'tanstack-start' | 'expo';
+export type Auth = 'none' | 'clerk';
+export type Example = 'none' | 'messages';
+export interface AppSpec {
+    name: string;
+    framework: Framework;
+}
+export interface ProjectOptions {
+    name: string;
+    apps: AppSpec[];
+    auth: Auth;
+    example: Example;
+    packageManager: 'pnpm';
+    install: boolean;
+    initConvex: boolean;
+    git: boolean;
+}
+export interface PackageManifest {
+    name: string;
+    version?: string;
+    private?: boolean;
+    type?: 'module' | 'commonjs';
+    main?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface GeneratorContext {
+    options: ProjectOptions;
+    /** Filesystem staging directory owned by this generation. */
+    root: string;
+    scope: string;
+    write(path: string, contents: string): Promise<void>;
+    json(path: string, value: unknown): Promise<void>;
+    mergePackage(path: string, patch: Partial<PackageManifest>): Promise<void>;
+}
+export interface AppTemplate {
+    id: Framework;
+    label: string;
+    generate(context: GeneratorContext, app: AppSpec): Promise<void>;
+}
+export interface AuthAdapter {
+    id: Auth;
+    label: string;
+    apply(context: GeneratorContext): Promise<void>;
+}

package/dist/generator/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/generator/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { generateProject } from './generator/index.js';
+export { normalizeOptions } from './generator/options.js';
+export type { GeneratorContext, ProjectOptions, AppSpec, AppTemplate, AuthAdapter, Framework, Auth, Example, } from './generator/types.js';
+export type { RawOptions } from './generator/options.js';
+export type { GenerateSettings } from './generator/index.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { generateProject } from './generator/index.js';
+export { normalizeOptions } from './generator/options.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/integrations/auth/clerk/index.d.ts

@@ -0,0 +1,2 @@
+import type { AuthAdapter } from '../../../generator/types.js';
+export declare const clerkAdapter: AuthAdapter;

package/dist/integrations/auth/clerk/index.js

@@ -0,0 +1,114 @@
+import { versions as v } from '../../../templates/versions.js';
+import { platform, writeProviders } from '../shared.js';
+const bindings = {
+    next: { sdk: '@clerk/nextjs', version: v.clerkNext },
+    vite: { sdk: '@clerk/react', version: v.clerkReact },
+    'tanstack-start': { sdk: '@clerk/tanstack-react-start', version: '1.5.12' },
+    expo: { sdk: '@clerk/expo', version: v.clerkExpo },
+};
+export const clerkAdapter = {
+    id: 'clerk',
+    label: 'Clerk',
+    async apply(ctx) {
+        if (ctx.options.example === 'messages')
+            await ctx.write('packages/backend/convex/access.ts', `import type { QueryCtx, MutationCtx } from './_generated/server';
+export async function getOwner(ctx: QueryCtx | MutationCtx): Promise<string> {
+  const identity = await ctx.auth.getUserIdentity();
+  if (!identity) throw new Error('Sign in to access messages.');
+  return identity.tokenIdentifier;
+}
+`);
+        await ctx.write('packages/backend/convex/auth.config.ts', `import type { AuthConfig } from 'convex/server';
+const domain = process.env.CLERK_JWT_ISSUER_DOMAIN;
+if (!domain) throw new Error('Set CLERK_JWT_ISSUER_DOMAIN on this Convex deployment. See README.md.');
+export default { providers: [{ domain, applicationID: 'convex' }] } satisfies AuthConfig;
+`);
+        await ctx.write('packages/backend/.env.clerk.example', '# Configure this on the Convex deployment with convex env set, not in frontend env files.\n# CLERK_JWT_ISSUER_DOMAIN=https://your-instance.clerk.accounts.dev\n');
+        for (const app of ctx.options.apps) {
+            const dir = `apps/${app.name}`;
+            const binding = bindings[app.framework];
+            const { native, prefix } = platform(app);
+            await ctx.mergePackage(`${dir}/package.json`, {
+                dependencies: {
+                    [binding.sdk]: binding.version,
+                    ...(native
+                        ? {
+                            'expo-secure-store': '57.0.3',
+                            'expo-auth-session': '57.0.11',
+                            'expo-web-browser': '57.0.2',
+                            'expo-crypto': '57.0.2',
+                            'expo-constants': '57.0.17',
+                        }
+                        : {}),
+                },
+            });
+            await ctx.write(`${dir}/.env.clerk.example`, `# Append these values to .env.local alongside the Convex URL.\n${prefix}_CLERK_PUBLISHABLE_KEY=\n${app.framework === 'next' || app.framework === 'tanstack-start' ? '# Server only. Never prefix this with NEXT_PUBLIC_, VITE_ or EXPO_PUBLIC_.\nCLERK_SECRET_KEY=\n' : ''}${native ? `# Enable Google OAuth and Native API in Clerk.\n# Register redirect URL: ccm-${ctx.options.name}-${app.name}://continue\n# Build a development client with pnpm ios or pnpm android for this scheme.\n` : ''}`);
+            await writeProviders(ctx, app, {
+                sdk: binding.sdk,
+                ...(native
+                    ? {
+                        extraImports: "import { tokenCache } from '@clerk/expo/token-cache';",
+                        providerProps: 'tokenCache={tokenCache}',
+                    }
+                    : {}),
+            });
+            if (app.framework === 'next') {
+                await ctx.write(`${dir}/src/proxy.ts`, `import { clerkMiddleware } from '@clerk/nextjs/server';
+export default clerkMiddleware();
+export const config = { matcher: ['/((?!_next|[^?]*\\\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)', '/(api|trpc)(.*)'] };
+`);
+            }
+            if (app.framework === 'tanstack-start') {
+                await ctx.write(`${dir}/src/start.ts`, `import { createStart } from '@tanstack/react-start';
+import { clerkMiddleware } from '@clerk/tanstack-react-start/server';
+export const startInstance = createStart(() => ({ requestMiddleware: [clerkMiddleware()] }));
+`);
+            }
+            if (!native) {
+                await ctx.write(`${dir}/src/auth-controls.tsx`, `'use client';
+import { useAuth, SignInButton, UserButton } from '${binding.sdk}';
+export function AuthControls() {
+  const { isLoaded, isSignedIn } = useAuth();
+  if (!isLoaded) return <p>Loading sign-in…</p>;
+  return isSignedIn ? <UserButton /> : <SignInButton mode="modal"><button type="button">Sign in</button></SignInButton>;
+}
+`);
+            }
+            else {
+                await ctx.write(`${dir}/src/auth-controls.tsx`, `import { useState } from 'react';
+import { Button, Text, View } from 'react-native';
+import { useAuth, useSSO } from '@clerk/expo';
+import * as AuthSession from 'expo-auth-session';
+import * as WebBrowser from 'expo-web-browser';
+WebBrowser.maybeCompleteAuthSession();
+export function AuthControls() {
+  const { isLoaded, isSignedIn, signOut } = useAuth();
+  const { startSSOFlow } = useSSO();
+  const [error, setError] = useState<string | null>(null);
+  const [pending, setPending] = useState(false);
+  async function authenticate() {
+    setPending(true); setError(null);
+    try {
+      const { createdSessionId, setActive } = await startSSOFlow({
+        strategy: 'oauth_google', redirectUrl: AuthSession.makeRedirectUri({ scheme: 'ccm-${ctx.options.name}-${app.name}', path: 'continue' }),
+      });
+      if (createdSessionId && setActive) await setActive({ session: createdSessionId });
+      else setError('Sign-in was cancelled or requires additional verification.');
+    } catch (cause) { setError(cause instanceof Error ? cause.message : 'Sign-in failed.'); }
+    finally { setPending(false); }
+  }
+  async function logout() {
+    try { await signOut(); } catch { setError('Could not sign out. Try again.'); }
+  }
+  if (!isLoaded) return <Text>Loading sign-in…</Text>;
+  return <View>
+    {isSignedIn ? <Button title="Sign out" onPress={() => { void logout(); }} /> : <Button title={pending ? 'Signing in…' : 'Sign in with Google'} disabled={pending} onPress={() => { void authenticate(); }} />}
+    {error && <Text accessibilityRole="alert">{error}</Text>}
+  </View>;
+}
+`);
+            }
+        }
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/integrations/auth/clerk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integrations/auth/clerk/index.ts"],"names":[],"mappings":"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"}

package/dist/integrations/auth/index.d.ts

@@ -0,0 +1,2 @@
+import type { Auth, AuthAdapter } from '../../generator/types.js';
+export declare const authAdapters: Record<Auth, AuthAdapter>;

package/dist/integrations/auth/index.js

@@ -0,0 +1,7 @@
+import { noneAdapter } from './none/index.js';
+import { clerkAdapter } from './clerk/index.js';
+export const authAdapters = {
+    none: noneAdapter,
+    clerk: clerkAdapter,
+};
+//# sourceMappingURL=index.js.map

package/dist/integrations/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAA8B;IACrD,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,YAAY;CACpB,CAAC"}

package/dist/integrations/auth/none/index.d.ts

@@ -0,0 +1,2 @@
+import type { AuthAdapter } from '../../../generator/types.js';
+export declare const noneAdapter: AuthAdapter;

package/dist/integrations/auth/none/index.js

@@ -0,0 +1,18 @@
+import { writeProviders } from '../shared.js';
+export const noneAdapter = {
+    id: 'none',
+    label: 'None',
+    async apply(ctx) {
+        if (ctx.options.example === 'messages')
+            await ctx.write('packages/backend/convex/access.ts', `import type { QueryCtx, MutationCtx } from './_generated/server';
+export async function getOwner(_ctx: QueryCtx | MutationCtx): Promise<string | undefined> {
+  return undefined;
+}
+`);
+        for (const app of ctx.options.apps) {
+            await writeProviders(ctx, app);
+            await ctx.write(`apps/${app.name}/src/auth-controls.tsx`, 'export function AuthControls() { return null; }\n');
+        }
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/integrations/auth/none/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integrations/auth/none/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,KAAK,CAAC,KAAK,CAAC,GAAG;QACb,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU;YACpC,MAAM,GAAG,CAAC,KAAK,CACb,mCAAmC,EACnC;;;;CAIP,CACM,CAAC;QACJ,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/B,MAAM,GAAG,CAAC,KAAK,CACb,QAAQ,GAAG,CAAC,IAAI,wBAAwB,EACxC,mDAAmD,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/integrations/auth/shared.d.ts

@@ -0,0 +1,11 @@
+import type { AppSpec, GeneratorContext } from '../../generator/types.js';
+export declare function platform(app: AppSpec): {
+    native: boolean;
+    prefix: string;
+    env: (name: string) => string;
+};
+export declare function writeProviders(ctx: GeneratorContext, app: AppSpec, auth?: {
+    sdk: string;
+    extraImports?: string;
+    providerProps?: string;
+}): Promise<void>;

package/dist/integrations/auth/shared.js

@@ -0,0 +1,40 @@
+export function platform(app) {
+    const native = app.framework === 'expo';
+    const prefix = app.framework === 'next' ? 'NEXT_PUBLIC' : native ? 'EXPO_PUBLIC' : 'VITE';
+    const env = (name) => `${prefix === 'VITE' ? 'import.meta.env' : 'process.env'}.${prefix}_${name}`;
+    return { native, prefix, env };
+}
+export async function writeProviders(ctx, app, auth) {
+    const { native, env } = platform(app);
+    const text = (message) => native ? `<Text>${message}</Text>` : `<p>${message}</p>`;
+    await ctx.write(`apps/${app.name}/src/providers.tsx`, `'use client';
+import { useState, type ReactNode } from 'react';
+import { ConvexReactClient, ${auth ? 'Authenticated, Unauthenticated, AuthLoading' : 'ConvexProvider'} } from 'convex/react';
+${native ? "import { Text, View } from 'react-native';" : ''}
+${auth
+        ? `import { ClerkProvider, useAuth } from '${auth.sdk}';
+import { ConvexProviderWithClerk } from 'convex/react-clerk';
+import { AuthControls } from './auth-controls';
+${auth.extraImports ?? ''}`
+        : ''}
+
+export function Providers({ children }: { children: ReactNode }) {
+  const url = ${env('CONVEX_URL')};
+  ${auth ? `const publishableKey = ${env('CLERK_PUBLISHABLE_KEY')};` : ''}
+  if (!url) return ${text(`Set ${platform(app).prefix}_CONVEX_URL in this app's .env.local.`)};
+  ${auth ? `if (!publishableKey) return ${text(`Set ${platform(app).prefix}_CLERK_PUBLISHABLE_KEY in this app's .env.local.`)};` : ''}
+  return ${auth ? `<ClerkProvider publishableKey={publishableKey} ${auth.providerProps ?? ''}>` : ''}<Connection url={url}>{children}</Connection>${auth ? '</ClerkProvider>' : ''};
+}
+function Connection({ url, children }: { url: string; children: ReactNode }) {
+  const [client] = useState(() => new ConvexReactClient(url${native ? ', { unsavedChangesWarning: false }' : ''}));
+  return ${auth
+        ? `<ConvexProviderWithClerk client={client} useAuth={useAuth}>
+    <AuthLoading>${text('Connecting authentication…')}</AuthLoading>
+    <Unauthenticated><AuthControls /></Unauthenticated>
+    <Authenticated>${native ? '<View style={{ flex: 1, padding: 24, paddingTop: 64 }}>' : ''}{children}${native ? '</View>' : ''}</Authenticated>
+  </ConvexProviderWithClerk>`
+        : `<ConvexProvider client={client}>${native ? '<View style={{ flex: 1, padding: 24, paddingTop: 64 }}>' : ''}{children}${native ? '</View>' : ''}</ConvexProvider>`};
+}
+`);
+}
+//# sourceMappingURL=shared.js.map

package/dist/integrations/auth/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/integrations/auth/shared.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC;IACxC,MAAM,MAAM,GACV,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAC3B,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;IAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAqB,EACrB,GAAY,EACZ,IAIC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAC/B,MAAM,CAAC,CAAC,CAAC,SAAS,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC;IAC3D,MAAM,GAAG,CAAC,KAAK,CACb,QAAQ,GAAG,CAAC,IAAI,oBAAoB,EACpC;;8BAE0B,IAAI,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,gBAAgB;EACnG,MAAM,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE;EAE1D,IAAI;QACF,CAAC,CAAC,2CAA2C,IAAI,CAAC,GAAG;;;EAGvD,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE;QACvB,CAAC,CAAC,EACN;;;gBAGgB,GAAG,CAAC,YAAY,CAAC;IAC7B,IAAI,CAAC,CAAC,CAAC,0BAA0B,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;qBACpD,IAAI,CAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,uCAAuC,CAAC;IACzF,IAAI,CAAC,CAAC,CAAC,+BAA+B,IAAI,CAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,kDAAkD,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;WAC1H,IAAI,CAAC,CAAC,CAAC,kDAAkD,IAAI,CAAC,aAAa,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,gDAAgD,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE;;;6DAGrH,MAAM,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,EAAE;WAE3G,IAAI;QACF,CAAC,CAAC;mBACW,IAAI,CAAC,4BAA4B,CAAC;;qBAEhC,MAAM,CAAC,CAAC,CAAC,yDAAyD,CAAC,CAAC,CAAC,EAAE,aAAa,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;6BACnG;QACvB,CAAC,CAAC,mCAAmC,MAAM,CAAC,CAAC,CAAC,yDAAyD,CAAC,CAAC,CAAC,EAAE,aAAa,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,mBACpJ;;CAED,CACE,CAAC;AACJ,CAAC"}

package/dist/package-manager/index.d.ts

@@ -0,0 +1,6 @@
+export declare function runCommand(command: string, args: readonly string[], cwd: string, signal?: AbortSignal): Promise<void>;
+export interface PackageManager {
+    id: 'pnpm';
+    install(cwd: string, signal?: AbortSignal): Promise<void>;
+}
+export declare const pnpm: PackageManager;

package/dist/package-manager/index.js

@@ -0,0 +1,22 @@
+import spawn from 'cross-spawn';
+export function runCommand(command, args, cwd, signal) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, [...args], {
+            cwd,
+            stdio: 'inherit',
+            shell: false,
+            ...(signal ? { signal } : {}),
+        });
+        child.once('error', (error) => reject(new Error(`Could not run ${command}: ${error.message}`, {
+            cause: error,
+        })));
+        child.once('exit', (code, signal) => code === 0
+            ? resolve()
+            : reject(new Error(`${command} ${args.join(' ')} failed (${signal ?? `exit ${code}`}).`)));
+    });
+}
+export const pnpm = {
+    id: 'pnpm',
+    install: (cwd, signal) => runCommand('pnpm', ['install'], cwd, signal),
+};
+//# sourceMappingURL=index.js.map

package/dist/package-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/package-manager/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,aAAa,CAAC;AAEhC,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,IAAuB,EACvB,GAAW,EACX,MAAoB;IAEpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;YACtC,GAAG;YACH,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,KAAK;YACZ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAC5B,MAAM,CACJ,IAAI,KAAK,CAAC,iBAAiB,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE;YACtD,KAAK,EAAE,KAAK;SACb,CAAC,CACH,CACF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAClC,IAAI,KAAK,CAAC;YACR,CAAC,CAAC,OAAO,EAAE;YACX,CAAC,CAAC,MAAM,CACJ,IAAI,KAAK,CACP,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,IAAI,QAAQ,IAAI,EAAE,IAAI,CACrE,CACF,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAKD,MAAM,CAAC,MAAM,IAAI,GAAmB;IAClC,EAAE,EAAE,MAAM;IACV,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CACvE,CAAC"}

package/dist/templates/apps/expo/index.d.ts

@@ -0,0 +1,2 @@
+import type { AppTemplate } from '../../../generator/types.js';
+export declare const expoTemplate: AppTemplate;