@playcademy/sdk 0.1.4 → 0.1.6

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,33 @@ 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;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -3162,15 +3184,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 +3208,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 +3887,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 +3899,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 +3911,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 +3923,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,33 @@ 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;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -52,12 +74,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 +147,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 +167,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 +367,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,33 @@ 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;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -3931,12 +3953,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 +4026,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 +4046,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 +4575,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 +4587,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 +4599,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 +4611,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.4",
+    "version": "0.1.6",
     "type": "module",
     "exports": {
         ".": {
@@ -37,12 +37,12 @@
         "@playcademy/constants": "0.0.1",
         "@playcademy/data": "0.0.1",
         "@playcademy/logger": "0.0.1",
-        "@playcademy/sandbox": "0.1.0",
+        "@playcademy/sandbox": "0.1.1",
         "@playcademy/test": "0.0.1",
         "@playcademy/timeback": "0.0.1",
         "@playcademy/utils": "0.0.1",
         "@types/bun": "latest",
-        "playcademy": "0.11.13",
+        "playcademy": "0.12.9",
         "rollup": "^4.50.2",
         "rollup-plugin-dts": "^6.2.3",
         "typescript": "^5.7.2",