@colyseus/schema 5.0.8 → 5.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colyseus/schema",
-  "version": "5.0.8",
+  "version": "5.0.9",
   "description": "Binary state serializer with delta encoding for games",
   "type": "module",
   "bin": {

package/src/annotations.ts

@@ -575,6 +575,30 @@ export function deprecated(throws: boolean = true): PropertyDecorator {
     }
 }
 
+let defineTypesWarned = false;
+
+/**
+ * Adds synchronizable fields to an existing `Schema` subclass — the pre-5.0
+ * helper for plain JavaScript users.
+ *
+ * @deprecated Use `schema()` with `t.*` field builders instead:
+ * https://docs.colyseus.io/state/schema
+ */
+export function defineTypes(
+    target: typeof Schema,
+    fields: Definition,
+    options?: TypeOptions
+) {
+    if (!defineTypesWarned) {
+        defineTypesWarned = true;
+        console.warn("@colyseus/schema: defineTypes() is deprecated and will be removed in a future release. Use schema() with t.* field builders instead → https://docs.colyseus.io/state/schema");
+    }
+    for (let field in fields) {
+        type(fields[field], options)(target.prototype, field);
+    }
+    return target;
+}
+
 // Helper type to extract InitProps from initialize method.
 // - Non-empty initialize params: use them directly.
 // - Zero-arg initialize: no args accepted (`never`) — user-supplied field

package/src/codegen/parser.ts

@@ -8,6 +8,8 @@ let currentProperty: Property;
 
 let globalContext: Context;
 
+let defineTypesWarned = false;
+
 const BUILDER_COLLECTION_KINDS = new Set(["array", "map", "set", "collection"]);
 
 /**
@@ -254,6 +256,44 @@ function inspectNode(node: ts.Node, context: Context, decoratorName: string) {
                     defineProperty(property, prop.initializer);
                 }
 
+            } else if (
+                node.getText() === "defineTypes" &&
+                (
+                    node.parent.kind === ts.SyntaxKind.CallExpression ||
+                    node.parent.kind === ts.SyntaxKind.PropertyAccessExpression
+                )
+            ) {
+                /**
+                 * JavaScript source file (`.js`)
+                 * Using `defineTypes()` (deprecated)
+                 */
+                const callExpression = (node.parent.kind === ts.SyntaxKind.PropertyAccessExpression)
+                    ? node.parent.parent as ts.CallExpression
+                    : node.parent as ts.CallExpression;
+
+                if (callExpression.kind !== ts.SyntaxKind.CallExpression) {
+                    break;
+                }
+
+                if (!defineTypesWarned) {
+                    defineTypesWarned = true;
+                    console.warn("schema-codegen: defineTypes() is deprecated and will be removed in a future release. Use schema() with t.* field builders instead → https://docs.colyseus.io/state/schema");
+                }
+
+                const className = callExpression.arguments[0].getText()
+                currentStructure.name = className;
+
+                const types = callExpression.arguments[1] as any;
+                for (let i = 0; i < types.properties.length; i++) {
+                    const prop = types.properties[i];
+
+                    const property = currentProperty || new Property();
+                    property.name = prop.name.escapedText;
+                    currentStructure.addProperty(property);
+
+                    defineProperty(property, prop.initializer);
+                }
+
             }
 
             if (node.parent.kind === ts.SyntaxKind.ClassDeclaration) {

package/src/index.ts

@@ -49,6 +49,7 @@ export { Metadata } from "./Metadata.js";
 export {
     type,
     deprecated,
+    defineTypes,
     owned,
     unreliable,
     transient,