playcademy 0.11.14 → 0.12.0

package/dist/constants.d.ts

@@ -1,5 +1,30 @@
 export { GAME_WORKER_DOMAINS, PLAYCADEMY_BASE_URLS, PLAYCADEMY_DOMAINS } from '@playcademy/constants';
 
+/**
+ * API routes related constants
+ */
+/**
+ * Default directory for custom API routes
+ * Used when integrations.customRoutes.directory is not specified in config
+ */
+declare const DEFAULT_API_ROUTES_DIRECTORY = "server/api";
+
+/**
+ * Database-related constants
+ */
+/**
+ * Default directory for database files
+ */
+declare const DEFAULT_DATABASE_DIRECTORY = "db";
+/**
+ * Default directory for database schema files
+ */
+declare const DEFAULT_SCHEMA_DIRECTORY = "db/schema";
+/**
+ * Default path for seed file
+ */
+declare const DEFAULT_SEED_FILE = "db/seed.ts";
+
 /**
  * HTTP server constants for CLI OAuth callback handling
  */
@@ -10,6 +35,46 @@ declare const CALLBACK_PATH = "/callback";
 /** Timeout for SSO authentication in milliseconds (30 seconds) */
 declare const SSO_AUTH_TIMEOUT_MS = 30000;
 
+/**
+ * Path constants for CLI directories and files
+ */
+/**
+ * CLI workspace directories (local to project)
+ */
+declare const CLI_DIRECTORIES: {
+    /** Root directory for CLI artifacts in workspace */
+    readonly WORKSPACE: ".playcademy";
+    /** Database directory within workspace */
+    readonly DATABASE: ".playcademy/db";
+};
+/**
+ * CLI user directories (in home directory)
+ */
+declare const CLI_USER_DIRECTORIES: {
+    /** User config directory for auth, games store, etc. */
+    readonly CONFIG: ".playcademy";
+};
+/**
+ * Default output paths
+ */
+declare const CLI_DEFAULT_OUTPUTS: {
+    /** Default worker bundle output for debug command */
+    readonly WORKER_BUNDLE: ".playcademy/worker-bundle.js";
+};
+/**
+ * CLI file names
+ */
+declare const CLI_FILES: {
+    /** Auth store file in user config directory */
+    readonly AUTH_STORE: "auth.json";
+    /** Games deployment info store */
+    readonly GAMES_STORE: "games.json";
+    /** Dev server PID file */
+    readonly DEV_SERVER_PID: "dev-server.pid";
+    /** Initial database file (before miniflare) */
+    readonly INITIAL_DATABASE: "initial.sqlite";
+};
+
 /**
  * Default port numbers for local development servers
  */
@@ -25,4 +90,10 @@ declare const DEFAULT_PORTS: {
  */
 declare const CONFIG_FILE_NAMES: string[];
 
-export { CALLBACK_PATH, CALLBACK_PORT, CONFIG_FILE_NAMES, DEFAULT_PORTS, SSO_AUTH_TIMEOUT_MS };
+/**
+ * Cloudflare Workers compatibility date
+ * Update when adopting new Cloudflare features or breaking changes
+ */
+declare const CLOUDFLARE_COMPATIBILITY_DATE = "2024-01-01";
+
+export { CALLBACK_PATH, CALLBACK_PORT, CLI_DEFAULT_OUTPUTS, CLI_DIRECTORIES, CLI_FILES, CLI_USER_DIRECTORIES, CLOUDFLARE_COMPATIBILITY_DATE, CONFIG_FILE_NAMES, DEFAULT_API_ROUTES_DIRECTORY, DEFAULT_DATABASE_DIRECTORY, DEFAULT_PORTS, DEFAULT_SCHEMA_DIRECTORY, DEFAULT_SEED_FILE, SSO_AUTH_TIMEOUT_MS };

package/dist/constants.js

@@ -1,8 +1,42 @@
+// src/constants/api.ts
+var DEFAULT_API_ROUTES_DIRECTORY = "server/api";
+
+// src/constants/database.ts
+var DEFAULT_DATABASE_DIRECTORY = "db";
+var DEFAULT_SCHEMA_DIRECTORY = "db/schema";
+var DEFAULT_SEED_FILE = "db/seed.ts";
+
 // src/constants/http-server.ts
 var CALLBACK_PORT = 6175;
 var CALLBACK_PATH = "/callback";
 var SSO_AUTH_TIMEOUT_MS = 3e4;
 
+// src/constants/paths.ts
+var CLI_DIRECTORIES = {
+  /** Root directory for CLI artifacts in workspace */
+  WORKSPACE: ".playcademy",
+  /** Database directory within workspace */
+  DATABASE: ".playcademy/db"
+};
+var CLI_USER_DIRECTORIES = {
+  /** User config directory for auth, games store, etc. */
+  CONFIG: ".playcademy"
+};
+var CLI_DEFAULT_OUTPUTS = {
+  /** Default worker bundle output for debug command */
+  WORKER_BUNDLE: ".playcademy/worker-bundle.js"
+};
+var CLI_FILES = {
+  /** Auth store file in user config directory */
+  AUTH_STORE: "auth.json",
+  /** Games deployment info store */
+  GAMES_STORE: "games.json",
+  /** Dev server PID file */
+  DEV_SERVER_PID: "dev-server.pid",
+  /** Initial database file (before miniflare) */
+  INITIAL_DATABASE: "initial.sqlite"
+};
+
 // src/constants/ports.ts
 var DEFAULT_PORTS = {
   /** Sandbox server (mock platform API) */
@@ -66,11 +100,23 @@ var BADGES = {
   EARLY_ADOPTER: ITEM_SLUGS.EARLY_ADOPTER_BADGE,
   FIRST_GAME: ITEM_SLUGS.FIRST_GAME_BADGE
 };
+
+// src/constants/index.ts
+var CLOUDFLARE_COMPATIBILITY_DATE = "2024-01-01";
 export {
   CALLBACK_PATH,
   CALLBACK_PORT,
+  CLI_DEFAULT_OUTPUTS,
+  CLI_DIRECTORIES,
+  CLI_FILES,
+  CLI_USER_DIRECTORIES,
+  CLOUDFLARE_COMPATIBILITY_DATE,
   CONFIG_FILE_NAMES,
+  DEFAULT_API_ROUTES_DIRECTORY,
+  DEFAULT_DATABASE_DIRECTORY,
   DEFAULT_PORTS,
+  DEFAULT_SCHEMA_DIRECTORY,
+  DEFAULT_SEED_FILE,
   GAME_WORKER_DOMAINS,
   PLAYCADEMY_BASE_URLS,
   PLAYCADEMY_DOMAINS,

package/dist/db.d.ts

@@ -0,0 +1,61 @@
+import Database from 'better-sqlite3';
+
+/**
+ * Development Database Path Helper
+ *
+ * Provides a helper for drizzle.config.ts to locate the development database.
+ * Handles the miniflare database detection and fallback to initial.sqlite.
+ */
+/**
+ * Get the path to the development database for use in drizzle.config.ts
+ *
+ * This function:
+ * - Checks for an existing miniflare database (created by `playcademy dev`)
+ * - Falls back to initial.sqlite if miniflare DB doesn't exist
+ * - Creates the database file if it doesn't exist
+ * - Migrates initial.sqlite to miniflare DB on first detection
+ *
+ * @example
+ * ```ts
+ * import { getDevDbPath } from 'playcademy'
+ * import { defineConfig } from 'drizzle-kit'
+ *
+ * export default defineConfig({
+ *   schema: './db/schema/index.ts',
+ *   dbCredentials: { url: getDevDbPath() },
+ *   // ...
+ * })
+ * ```
+ */
+declare function getDevDbPath(): string;
+
+/**
+ * Database Reset Utility
+ *
+ * Utility for resetting the local development database
+ */
+
+/**
+ * Reset the database by dropping all tables and recreating from schema
+ *
+ * This function:
+ * 1. Drops all user tables dynamically (queries sqlite_master)
+ * 2. Runs `drizzle-kit push` to recreate tables from your schema
+ * 3. Returns a connected drizzle instance ready for seeding
+ *
+ * @returns Better-sqlite3 Database instance with schema applied
+ *
+ * @example
+ * ```ts
+ * import { drizzle } from 'drizzle-orm/better-sqlite3'
+ * import { resetDatabase } from 'playcademy/db'
+ * import * as schema from './schema'
+ *
+ * const sqlite = resetDatabase()
+ * const db = drizzle(sqlite, { schema })
+ * await db.insert(schema.users).values({ ... })
+ * ```
+ */
+declare function resetDatabase(): Database.Database;
+
+export { getDevDbPath as getPath, resetDatabase };