@sockethub/schemas 3.0.0-beta.0 → 3.0.0-beta.1

package/dist/maps/context-map.json

@@ -1,6 +1,6 @@
 {
-  "schemaVersion": "3.0.0-beta.0",
-  "generatedAt": "2026-10-12T13:04:34.157Z",
+  "schemaVersion": "3.0.0-beta.1",
+  "generatedAt": "2026-11-02T15:05:44.363Z",
   "contextToPlatformId": {
     "https://sockethub.org/ns/context/platform/caldav/v1.jsonld": "caldav",
     "https://sockethub.org/ns/context/platform/carddav/v1.jsonld": "carddav",

package/dist/schemas/json/activity-stream.json

@@ -1,5 +1,5 @@
 {
-	"$id": "https://sockethub.org/schemas/3.0.0-beta.0/activity-stream.json",
+	"$id": "https://sockethub.org/schemas/3.0.0-beta.1/activity-stream.json",
 	"description": "Schema for Sockethub Activity Streams",
 	"type": "object",
 	"required": [

package/dist/schemas/json/platform.json

@@ -1,5 +1,5 @@
 {
-	"$id": "https://sockethub.org/schemas/3.0.0-beta.0/platform.json",
+	"$id": "https://sockethub.org/schemas/3.0.0-beta.1/platform.json",
 	"type": "object",
 	"required": [
 		"name",

package/dist/schemas/json/service-descriptor.json

@@ -1,5 +1,5 @@
 {
-	"$id": "https://sockethub.org/schemas/3.0.0-beta.0/service-descriptor.json",
+	"$id": "https://sockethub.org/schemas/3.0.0-beta.1/service-descriptor.json",
 	"description": "Sockethub service descriptor",
 	"type": "object",
 	"required": [

package/dist/schemas/json/sockethub-config.json

@@ -1,5 +1,5 @@
 {
-	"$id": "https://sockethub.org/schemas/3.0.0-beta.0/sockethub-config.json",
+	"$id": "https://sockethub.org/schemas/3.0.0-beta.1/sockethub-config.json",
 	"description": "Sockethub Config Schema",
 	"type": "object",
 	"required": [
@@ -202,6 +202,9 @@
 					"properties": {
 						"connectTimeoutMs": {
 							"type": "number"
+						},
+						"allowPrivateAddresses": {
+							"type": "boolean"
 						}
 					}
 				},
@@ -300,11 +303,23 @@
 			"type": "object",
 			"additionalProperties": false,
 			"properties": {
+				"maxInstancesPerSession": {
+					"type": "integer",
+					"minimum": 0,
+					"default": 10,
+					"description": "Maximum persistent instances per socket session. 0 disables the cap."
+				},
+				"maxInstancesPerIp": {
+					"type": "integer",
+					"minimum": 0,
+					"default": 20,
+					"description": "Maximum persistent instances per client IP, including HTTP actions. 0 disables the cap."
+				},
 				"maxPlatformInstances": {
 					"type": "number",
 					"minimum": 0,
 					"default": 100,
-					"description": "Upper bound on concurrently running platform instances (child processes). Each persistent-platform actor forks its own process, so an unbounded count is a resource exhaustion risk on public instances. 0 disables the cap."
+					"description": "Upper bound on concurrently running persistent platform instances (child processes). Each persistent-platform actor forks its own process, so an unbounded count is a resource exhaustion risk on public instances. 0 disables the cap."
 				}
 			}
 		},

package/dist/schemas/platform/xmpp/v1/credentials.schema.json

@@ -32,7 +32,9 @@
           "type": "string"
         },
         "port": {
-          "type": "number"
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535
         },
         "resource": {
           "type": "string"

package/dist/schemas/sockethub-config.d.ts

@@ -180,6 +180,9 @@ export declare const SockethubConfigSchema: {
                         connectTimeoutMs: {
                             type: string;
                         };
+                        allowPrivateAddresses: {
+                            type: string;
+                        };
                     };
                 };
                 "@sockethub/platform-metadata": {
@@ -274,6 +277,18 @@ export declare const SockethubConfigSchema: {
             type: string;
             additionalProperties: boolean;
             properties: {
+                maxInstancesPerSession: {
+                    type: string;
+                    minimum: number;
+                    default: number;
+                    description: string;
+                };
+                maxInstancesPerIp: {
+                    type: string;
+                    minimum: number;
+                    default: number;
+                    description: string;
+                };
                 maxPlatformInstances: {
                     type: string;
                     minimum: number;

package/dist/service-descriptor.d.ts

@@ -1,4 +1,9 @@
 import { type ServiceDescriptor, ServiceDescriptorSchema, type ServiceEndpoints } from "./schemas/service-descriptor.js";
+/**
+ * Type guard for a server's service descriptor. Validates with Ajv when code
+ * generation is available and falls back to a structural check when a Content
+ * Security Policy blocks it.
+ */
 export declare function validateServiceDescriptor(descriptor: unknown): descriptor is ServiceDescriptor;
 export { ServiceDescriptorSchema };
 export type { ServiceDescriptor, ServiceEndpoints };

package/dist/service-descriptor.js

@@ -6222,6 +6222,28 @@ var require_ajv = __commonJS(function(exports, module) {
 // src/service-descriptor.ts
 var import_ajv = __toESM(require_ajv(), 1);
 
+// src/helpers/codegen.ts
+var available;
+var warned = false;
+function isCodegenAvailable() {
+  if (available === undefined) {
+    try {
+      new Function("return true");
+      available = true;
+    } catch {
+      available = false;
+    }
+  }
+  return available;
+}
+function warnCodegenUnavailable() {
+  if (warned) {
+    return;
+  }
+  warned = true;
+  console.warn("[@sockethub/schemas] Schema validation is disabled: this environment's Content Security Policy blocks `new Function`, which Ajv needs to compile schemas. The Sockethub server still validates every message.");
+}
+
 // src/schemas/service-descriptor.ts
 var apiVersion = {
   type: "integer",
@@ -6266,15 +6288,68 @@ var ServiceDescriptorSchema = {
 };
 
 // src/service-descriptor.ts
-var ajv = new import_ajv.default({ strictTypes: false, allErrors: true });
+var ajv;
 var validator;
 function validateServiceDescriptor(descriptor) {
+  if (!isCodegenAvailable()) {
+    warnCodegenUnavailable();
+    return isServiceDescriptorShape(descriptor);
+  }
+  if (!ajv) {
+    ajv = new import_ajv.default({ strictTypes: false, allErrors: true });
+  }
   validator ??= ajv.compile(ServiceDescriptorSchema);
   return validator(descriptor);
 }
+function isServiceDescriptorShape(descriptor) {
+  if (!descriptor || typeof descriptor !== "object") {
+    return false;
+  }
+  const value = descriptor;
+  if (value.name !== "sockethub") {
+    return false;
+  }
+  if (!isApiVersion(value.apiVersion)) {
+    return false;
+  }
+  if (!Array.isArray(value.platforms)) {
+    return false;
+  }
+  for (const platform of value.platforms) {
+    if (!platform || typeof platform !== "object") {
+      return false;
+    }
+    const entry = platform;
+    if (typeof entry.id !== "string" || entry.id.length === 0) {
+      return false;
+    }
+    if (!isApiVersion(entry.apiVersion)) {
+      return false;
+    }
+  }
+  if (value.endpoints !== undefined) {
+    if (!value.endpoints || typeof value.endpoints !== "object") {
+      return false;
+    }
+    const endpoints = value.endpoints;
+    if (!isAbsolutePath(endpoints.socketIO)) {
+      return false;
+    }
+    if (endpoints.httpActions !== undefined && !isAbsolutePath(endpoints.httpActions)) {
+      return false;
+    }
+  }
+  return true;
+}
+function isApiVersion(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isAbsolutePath(value) {
+  return typeof value === "string" && /^\/(?![/\\])[^\s\\]*$/.test(value);
+}
 export {
   ServiceDescriptorSchema,
   validateServiceDescriptor
 };
 
-//# debugId=80A2C8695850A8EE64756E2164756E21
+//# debugId=D62B42AEB54699FA64756E2164756E21