@playcademy/sdk 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import * as drizzle_zod from 'drizzle-zod';
 import { z } from 'zod';
 import * as _playcademy_timeback_types from '@playcademy/timeback/types';
 import { OrganizationConfig, CourseConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
+import { SchemaInfo } from '@playcademy/cloudflare';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
@@ -3134,12 +3135,31 @@ interface TimebackIntegrationConfig {
     /** Component-Resource link overrides */
     componentResource?: Partial<ComponentResourceConfig>;
 }
+/**
+ * Custom API routes integration
+ */
+interface CustomRoutesIntegration {
+    /** Directory for custom API routes (defaults to 'server/api') */
+    directory?: string;
+}
+/**
+ * Database integration
+ */
+interface DatabaseIntegration {
+    /** Database directory (defaults to 'db') */
+    directory?: string;
+}
 /**
  * Integrations configuration
+ * All backend features (database, custom routes, external services) are configured here
  */
 interface IntegrationsConfig {
     /** TimeBack integration (optional) */
     timeback?: TimebackIntegrationConfig;
+    /** Custom API routes (optional) */
+    customRoutes?: CustomRoutesIntegration | boolean;
+    /** Database (optional) */
+    database?: DatabaseIntegration | boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -3162,15 +3182,22 @@ interface PlaycademyConfig {
     externalUrl?: string;
     /** Game platform */
     platform?: 'web' | 'unity' | 'godot';
-    /** Backend configuration */
-    backend?: {
-        /** Custom API routes directory (defaults to 'api') */
-        directory?: string;
-    };
-    /** External integrations */
+    /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
 }
 
+/**
+ * Resource bindings for backend deployment
+ * Provider-agnostic abstraction for cloud resources
+ */
+interface BackendResourceBindings {
+    /** SQL database instances to create and bind (maps to D1 on Cloudflare) */
+    database?: string[];
+    /** Key-value store namespaces to create and bind (maps to KV on Cloudflare) */
+    keyValue?: string[];
+    /** Object storage buckets to bind (maps to R2 on Cloudflare) */
+    bucket?: string[];
+}
 /**
  * Backend deployment bundle for uploading to Playcademy platform
  */
@@ -3179,6 +3206,10 @@ interface BackendDeploymentBundle {
     code: string;
     /** Game configuration */
     config: PlaycademyConfig;
+    /** Optional resource bindings (database, storage, etc.) */
+    bindings?: BackendResourceBindings;
+    /** Optional schema information for database setup */
+    schema?: SchemaInfo;
 }
 
 type TokenType = 'session' | 'apiKey' | 'gameJwt';
@@ -3854,11 +3885,11 @@ declare class PlaycademyClient {
         };
         items: {
             create: (props: InsertItemInput) => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;
@@ -3866,11 +3897,11 @@ declare class PlaycademyClient {
                 imageUrl: string | null;
             }>;
             get: (itemId: string) => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;
@@ -3878,11 +3909,11 @@ declare class PlaycademyClient {
                 imageUrl: string | null;
             }>;
             list: () => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;
@@ -3890,11 +3921,11 @@ declare class PlaycademyClient {
                 imageUrl: string | null;
             }[]>;
             update: (itemId: string, props: UpdateItemInput) => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;

package/dist/index.js

@@ -15,22 +15,22 @@ var isBrowser = () => {
   const g = globalThis;
   return typeof g.window !== "undefined" && typeof g.document !== "undefined";
 }, isProduction = () => {
-  return false;
+  return typeof process !== "undefined" && false;
 }, isDevelopment = () => {
-  return true;
+  return typeof process !== "undefined" && true;
 }, isInteractiveTTY = () => {
-  return Boolean(process.stdout && process.stdout.isTTY);
+  return typeof process !== "undefined" && Boolean(process.stdout && process.stdout.isTTY);
 }, detectOutputFormat = () => {
   if (isBrowser()) {
     return "browser";
   }
-  if (process.env.LOG_FORMAT === "json") {
+  if (typeof process !== "undefined" && process.env.LOG_FORMAT === "json") {
     return "json-single-line";
   }
-  if (process.env.LOG_PRETTY === "true" && isDevelopment()) {
+  if (typeof process !== "undefined" && process.env.LOG_PRETTY === "true" && isDevelopment()) {
     return "json-pretty";
   }
-  const colorPreference = (process.env.LOG_COLOR ?? "auto").toLowerCase();
+  const colorPreference = typeof process !== "undefined" ? (process.env.LOG_COLOR ?? "auto").toLowerCase() : "auto";
   if (colorPreference === "always" && !isProduction()) {
     return "color-tty";
   }
@@ -111,7 +111,7 @@ var isBrowser = () => {
       return console.log;
   }
 }, levelPriority, getMinimumLogLevel = () => {
-  const envLevel = (process.env.LOG_LEVEL ?? "").toLowerCase();
+  const envLevel = typeof process !== "undefined" ? (process.env.LOG_LEVEL ?? "").toLowerCase() : "";
   if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
     return envLevel;
   }

package/dist/server.d.ts

@@ -1,3 +1,4 @@
+import { SchemaInfo } from '@playcademy/cloudflare';
 import * as _playcademy_timeback_types from '@playcademy/timeback/types';
 import { OrganizationConfig, CourseConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
 export { ActivityData, ComponentConfig, ComponentResourceConfig, CourseConfig, EndActivityPayload, OrganizationConfig, ResourceConfig, TimebackGrade, TimebackSubject } from '@playcademy/timeback/types';
@@ -24,12 +25,31 @@ interface TimebackIntegrationConfig {
     /** Component-Resource link overrides */
     componentResource?: Partial<ComponentResourceConfig>;
 }
+/**
+ * Custom API routes integration
+ */
+interface CustomRoutesIntegration {
+    /** Directory for custom API routes (defaults to 'server/api') */
+    directory?: string;
+}
+/**
+ * Database integration
+ */
+interface DatabaseIntegration {
+    /** Database directory (defaults to 'db') */
+    directory?: string;
+}
 /**
  * Integrations configuration
+ * All backend features (database, custom routes, external services) are configured here
  */
 interface IntegrationsConfig {
     /** TimeBack integration (optional) */
     timeback?: TimebackIntegrationConfig;
+    /** Custom API routes (optional) */
+    customRoutes?: CustomRoutesIntegration | boolean;
+    /** Database (optional) */
+    database?: DatabaseIntegration | boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -52,12 +72,7 @@ interface PlaycademyConfig {
     externalUrl?: string;
     /** Game platform */
     platform?: 'web' | 'unity' | 'godot';
-    /** Backend configuration */
-    backend?: {
-        /** Custom API routes directory (defaults to 'api') */
-        directory?: string;
-    };
-    /** External integrations */
+    /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
 }
 
@@ -130,6 +145,18 @@ interface PlaycademyServerClientState {
     courseId?: string;
 }
 
+/**
+ * Resource bindings for backend deployment
+ * Provider-agnostic abstraction for cloud resources
+ */
+interface BackendResourceBindings {
+    /** SQL database instances to create and bind (maps to D1 on Cloudflare) */
+    database?: string[];
+    /** Key-value store namespaces to create and bind (maps to KV on Cloudflare) */
+    keyValue?: string[];
+    /** Object storage buckets to bind (maps to R2 on Cloudflare) */
+    bucket?: string[];
+}
 /**
  * Backend deployment bundle for uploading to Playcademy platform
  */
@@ -138,6 +165,10 @@ interface BackendDeploymentBundle {
     code: string;
     /** Game configuration */
     config: PlaycademyConfig;
+    /** Optional resource bindings (database, storage, etc.) */
+    bindings?: BackendResourceBindings;
+    /** Optional schema information for database setup */
+    schema?: SchemaInfo;
 }
 
 /**
@@ -334,4 +365,4 @@ declare function verifyGameToken(gameToken: string, options?: {
 }>;
 
 export { PlaycademyClient, verifyGameToken };
-export type { BackendDeploymentBundle, IntegrationsConfig, PlaycademyConfig, PlaycademyServerClientConfig, PlaycademyServerClientState, TimebackIntegrationConfig };
+export type { BackendDeploymentBundle, BackendResourceBindings, IntegrationsConfig, PlaycademyConfig, PlaycademyServerClientConfig, PlaycademyServerClientState, TimebackIntegrationConfig };

package/dist/types.d.ts

@@ -6,6 +6,7 @@ import { z } from 'zod';
 import * as _playcademy_realtime_server_types from '@playcademy/realtime/server/types';
 import * as _playcademy_timeback_types from '@playcademy/timeback/types';
 import { OrganizationConfig, CourseConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
+import { SchemaInfo } from '@playcademy/cloudflare';
 
 declare const userRoleEnum: drizzle_orm_pg_core.PgEnum<["admin", "player", "developer"]>;
 declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
@@ -3903,12 +3904,31 @@ interface TimebackIntegrationConfig {
     /** Component-Resource link overrides */
     componentResource?: Partial<ComponentResourceConfig>;
 }
+/**
+ * Custom API routes integration
+ */
+interface CustomRoutesIntegration {
+    /** Directory for custom API routes (defaults to 'server/api') */
+    directory?: string;
+}
+/**
+ * Database integration
+ */
+interface DatabaseIntegration {
+    /** Database directory (defaults to 'db') */
+    directory?: string;
+}
 /**
  * Integrations configuration
+ * All backend features (database, custom routes, external services) are configured here
  */
 interface IntegrationsConfig {
     /** TimeBack integration (optional) */
     timeback?: TimebackIntegrationConfig;
+    /** Custom API routes (optional) */
+    customRoutes?: CustomRoutesIntegration | boolean;
+    /** Database (optional) */
+    database?: DatabaseIntegration | boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -3931,12 +3951,7 @@ interface PlaycademyConfig {
     externalUrl?: string;
     /** Game platform */
     platform?: 'web' | 'unity' | 'godot';
-    /** Backend configuration */
-    backend?: {
-        /** Custom API routes directory (defaults to 'api') */
-        directory?: string;
-    };
-    /** External integrations */
+    /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
 }
 
@@ -4009,6 +4024,18 @@ interface PlaycademyServerClientState {
     courseId?: string;
 }
 
+/**
+ * Resource bindings for backend deployment
+ * Provider-agnostic abstraction for cloud resources
+ */
+interface BackendResourceBindings {
+    /** SQL database instances to create and bind (maps to D1 on Cloudflare) */
+    database?: string[];
+    /** Key-value store namespaces to create and bind (maps to KV on Cloudflare) */
+    keyValue?: string[];
+    /** Object storage buckets to bind (maps to R2 on Cloudflare) */
+    bucket?: string[];
+}
 /**
  * Backend deployment bundle for uploading to Playcademy platform
  */
@@ -4017,6 +4044,10 @@ interface BackendDeploymentBundle {
     code: string;
     /** Game configuration */
     config: PlaycademyConfig;
+    /** Optional resource bindings (database, storage, etc.) */
+    bindings?: BackendResourceBindings;
+    /** Optional schema information for database setup */
+    schema?: SchemaInfo;
 }
 
 interface UserScore {
@@ -4542,11 +4573,11 @@ declare class PlaycademyClient {
         };
         items: {
             create: (props: InsertItemInput) => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;
@@ -4554,11 +4585,11 @@ declare class PlaycademyClient {
                 imageUrl: string | null;
             }>;
             get: (itemId: string) => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;
@@ -4566,11 +4597,11 @@ declare class PlaycademyClient {
                 imageUrl: string | null;
             }>;
             list: () => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;
@@ -4578,11 +4609,11 @@ declare class PlaycademyClient {
                 imageUrl: string | null;
             }[]>;
             update: (itemId: string, props: UpdateItemInput) => Promise<{
+                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 id: string;
                 createdAt: Date;
-                type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 gameId: string | null;
-                slug: string;
                 displayName: string;
                 metadata: unknown;
                 description: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.1.3",
+    "version": "0.1.5",
     "type": "module",
     "exports": {
         ".": {