playcademy 0.14.2 → 0.14.4-alpha.1

package/dist/templates/api/sample-protected.ts.template

@@ -0,0 +1,34 @@
+import type { User } from '../../lib/auth'
+
+/**
+ * Protected Route Example
+ *
+ * Demonstrates how to require authentication in a route.
+ * This endpoint will only be accessible to authenticated users.
+ */
+export async function GET(c: Context): Promise<Response> {
+    // Check if user is authenticated
+    const user = c.get('user') as User | undefined
+
+    if (!user) {
+        return c.json({ error: 'Authentication required' }, 401)
+    }
+
+    // OPTIONAL: Require user to be from Playcademy platform
+    // Useful for platform-exclusive features
+    // if (!user.playcademyUserId) {
+    //     return c.json({ error: 'Platform access required' }, 403)
+    // }
+
+    return c.json({
+        success: true,
+        message: 'Authentication working! You are signed in.',
+        user: {
+            id: user.id,
+            email: user.email,
+            name: user.name,
+            playcademyUserId: user.playcademyUserId,
+        },
+    })
+}
+

package/dist/templates/auth/auth-catch-all.ts.template

@@ -0,0 +1,18 @@
+/**
+ * Better Auth Routes
+ *
+ * Handles all Better Auth routes (/api/auth/*)
+ * This is a standard catch-all route - no customization needed.
+ */
+import { getAuth } from '../../lib/auth'
+
+export async function GET(c: Context): Promise<Response> {
+    const auth = getAuth(c)
+    return auth.handler(c.req.raw)
+}
+
+export async function POST(c: Context): Promise<Response> {
+    const auth = getAuth(c)
+    return auth.handler(c.req.raw)
+}
+

package/dist/templates/auth/auth-schema.ts.template

@@ -0,0 +1,62 @@
+/**
+ * Better Auth Schema
+ *
+ * Database tables for Better Auth authentication system
+ */
+import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+
+export const user = sqliteTable('user', {
+    id: text('id').primaryKey(),
+    name: text('name').notNull(),
+    email: text('email').notNull().unique(),
+    emailVerified: integer('emailVerified').notNull(),
+    image: text('image'),
+    createdAt: integer('createdAt', { mode: 'timestamp' }).notNull(),
+    updatedAt: integer('updatedAt', { mode: 'timestamp' }).notNull(),
+
+    // Platform linkage: Links this user to a Playcademy platform identity
+    // When users launch the game from Playcademy, their platform identity
+    // is verified and linked to a Better Auth session via this field
+    playcademyUserId: text('playcademy_user_id').unique(),
+})
+
+export const session = sqliteTable('session', {
+    id: text('id').primaryKey(),
+    expiresAt: integer('expiresAt', { mode: 'timestamp' }).notNull(),
+    token: text('token').notNull().unique(),
+    createdAt: integer('createdAt', { mode: 'timestamp' }).notNull(),
+    updatedAt: integer('updatedAt', { mode: 'timestamp' }).notNull(),
+    ipAddress: text('ipAddress'),
+    userAgent: text('userAgent'),
+    userId: text('userId')
+        .notNull()
+        .references(() => user.id, { onDelete: 'cascade' }),
+})
+
+export const account = sqliteTable('account', {
+    id: text('id').primaryKey(),
+    accountId: text('accountId').notNull(),
+    providerId: text('providerId').notNull(),
+    userId: text('userId')
+        .notNull()
+        .references(() => user.id, { onDelete: 'cascade' }),
+    accessToken: text('accessToken'),
+    refreshToken: text('refreshToken'),
+    idToken: text('idToken'),
+    accessTokenExpiresAt: integer('accessTokenExpiresAt', { mode: 'timestamp' }),
+    refreshTokenExpiresAt: integer('refreshTokenExpiresAt', { mode: 'timestamp' }),
+    scope: text('scope'),
+    password: text('password'),
+    createdAt: integer('createdAt', { mode: 'timestamp' }).notNull(),
+    updatedAt: integer('updatedAt', { mode: 'timestamp' }).notNull(),
+})
+
+export const verification = sqliteTable('verification', {
+    id: text('id').primaryKey(),
+    identifier: text('identifier').notNull(),
+    value: text('value').notNull(),
+    expiresAt: integer('expiresAt', { mode: 'timestamp' }).notNull(),
+    createdAt: integer('createdAt', { mode: 'timestamp' }).notNull(),
+    updatedAt: integer('updatedAt', { mode: 'timestamp' }).notNull(),
+})
+

package/dist/templates/auth/auth.ts.template

@@ -0,0 +1,55 @@
+/**
+ * Better Auth Configuration
+ *
+ * CUSTOMIZABLE: This file is where you configure your auth providers,
+ * social logins, and other auth-specific settings.
+ */
+import { betterAuth } from 'better-auth'
+import { drizzleAdapter } from 'better-auth/adapters/drizzle'
+
+import { playcademy } from '@playcademy/better-auth/server'
+
+import { getDb } from '../../db'
+
+import type { Context } from 'hono'
+
+export function getAuth(c: Context) {
+    const db = getDb(c.env.DB)
+
+    // CUSTOMIZABLE: Configure trusted origins for CORS
+    // These origins are allowed to make cross-origin requests to your game's auth endpoints.
+    // Add your deployed game URLs here when you deploy to staging or production.
+    const trustedOrigins = [
+        'http://localhost:5173', // Local development
+        // 'https://{{GAME_SLUG}}-staging.playcademy.gg', // Staging deployment
+        // 'https://{{GAME_SLUG}}.playcademy.gg', // Production deployment
+    ]
+
+    return betterAuth({
+        database: drizzleAdapter(db, {
+            provider: 'sqlite',
+            usePlural: false,
+        }),
+
+        trustedOrigins,
+{{EMAIL_AND_PASSWORD}}{{SOCIAL_PROVIDERS}}
+        // REQUIRED: Platform integration
+        plugins: [
+            playcademy(),
+        ],
+
+        // CUSTOMIZABLE: Cookie settings
+        advanced: {
+            defaultCookieAttributes: {
+                path: '/',
+                secure: true,
+                partitioned: true, // CHIPS for Chrome/Edge
+                sameSite: 'none', // Ensure state + session cookies are sent on cross-site redirects
+            },
+        },
+    })
+}
+
+export type Auth = ReturnType<typeof getAuth>
+export type Session = Auth['$Infer']['Session']
+export type User = Auth['$Infer']['Session']['user']

package/dist/templates/config/integrations-config.js.template

@@ -1,7 +1,7 @@
 
 
     // External integrations
-    // See https://docs.playcademy.com/integrations for more details
+    // See https://docs.playcademy.net/integrations/overview.html for more details
     integrations: {
 {{INTEGRATIONS_CONTENT}}
     },

package/dist/templates/playcademy-env.d.ts.template

@@ -1,15 +1,24 @@
+/**
+ * Playcademy Environment Types
+ *
+ * Auto-generated by Playcademy CLI.
+ * Regenerated on: playcademy dev, playcademy init, playcademy db init, playcademy auth init
+ *
+ * Do not edit - changes will be overwritten.
+ */
+
 /// <reference types="./.playcademy/node_modules/@cloudflare/workers-types" />
 
-import type { Context as HonoContext } from './.playcademy/node_modules/hono'
+import type { Context as HonoContext } from './.playcademy/node_modules/hono'{{AUTH_IMPORT}}
 
 declare global {
     interface PlaycademyEnv {
         PLAYCADEMY_API_KEY: string
         GAME_ID: string
         PLAYCADEMY_BASE_URL: string{{BINDINGS}}{{SECRETS}}
-    }
+    }{{VARIABLES}}
 
-    type Context = HonoContext<{ Bindings: PlaycademyEnv }>
+    type Context = HonoContext<{ Bindings: PlaycademyEnv{{CONTEXT_VARS}} }>
 }
 
 export {}

package/dist/utils.d.ts

@@ -54,6 +54,8 @@ interface IntegrationsConfig {
     kv?: boolean;
     /** Bucket storage (optional) */
     bucket?: boolean;
+    /** Authentication (optional) */
+    auth?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -80,6 +82,14 @@ interface PlaycademyConfig {
     integrations?: IntegrationsConfig;
 }
 
+/**
+ * Logger interface for embedding in other tools (e.g., vite plugin)
+ */
+interface PluginLogger {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}
 interface DevServerOptions {
     port: number;
     /** Playcademy config. If not provided, will attempt to load from playcademy.config.js */
@@ -94,6 +104,8 @@ interface DevServerOptions {
     onReload?: (restart: () => Promise<void>) => void;
     /** URL for Playcademy platform/sandbox API (defaults to localhost:5174 platform) */
     platformUrl?: string;
+    /** Custom logger for embedding (e.g., from vite plugin) */
+    customLogger?: PluginLogger;
 }
 
 /**