@tinycloudlabs/sdk-core 1.0.0

package/dist/userAuthorization.schema.test.js

@@ -0,0 +1,356 @@
+/**
+ * Tests for UserAuthorization configuration schemas.
+ */
+import { describe, it, expect } from "bun:test";
+import { PartialSiweMessageSchema, UserAuthorizationConfigSchema, validateUserAuthorizationConfig, validatePartialSiweMessage, } from "./userAuthorization.schema";
+describe("PartialSiweMessageSchema", () => {
+    it("should accept empty object", () => {
+        const result = PartialSiweMessageSchema.safeParse({});
+        expect(result.success).toBe(true);
+    });
+    it("should accept minimal fields", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            address: "0x1234567890123456789012345678901234567890",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept all fields", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            address: "0x1234567890123456789012345678901234567890",
+            chainId: 1,
+            uri: "https://example.com",
+            version: "1",
+            domain: "example.com",
+            statement: "Sign in to Example",
+            nonce: "abc123",
+            issuedAt: "2024-01-01T00:00:00Z",
+            expirationTime: "2024-01-02T00:00:00Z",
+            notBefore: "2024-01-01T00:00:00Z",
+            requestId: "req-123",
+            resources: ["https://example.com/resource"],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept valid chainId", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            chainId: 1,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept chainId for polygon", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            chainId: 137,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject negative chainId", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            chainId: -1,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject zero chainId", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            chainId: 0,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject non-integer chainId", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            chainId: 1.5,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept resources array", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            resources: ["https://a.com", "https://b.com"],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-array resources", () => {
+        const result = PartialSiweMessageSchema.safeParse({
+            resources: "https://example.com",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("UserAuthorizationConfigSchema", () => {
+    // Mock signer object
+    const mockSigner = {
+        getAddress: async () => "0x1234567890123456789012345678901234567890",
+        signMessage: async () => "0xsignature",
+        getChainId: async () => 1,
+    };
+    it("should accept minimal config with signer", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject missing signer", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({});
+        expect(result.success).toBe(false);
+    });
+    it("should reject null signer", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: null,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject primitive signer", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: "not an object",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept sessionStorage object", () => {
+        const mockStorage = {
+            saveSession: async () => { },
+            loadSession: async () => null,
+            clearSession: async () => { },
+        };
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            sessionStorage: mockStorage,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-object sessionStorage", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            sessionStorage: "not an object",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept siweConfig object", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            siweConfig: { domain: "example.com" },
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept domain string", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            domain: "example.com",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept extensions array", () => {
+        const mockExtension = {
+            namespace: "test",
+            capabilities: [],
+        };
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            extensions: [mockExtension],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-array extensions", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            extensions: { namespace: "test" },
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject primitive in extensions array", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            extensions: ["not an object"],
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept auto-sign strategy", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            signStrategy: { type: "auto-sign" },
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept auto-reject strategy", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            signStrategy: { type: "auto-reject" },
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept callback strategy", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            signStrategy: {
+                type: "callback",
+                handler: async () => ({ approved: true }),
+            },
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept event-emitter strategy", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            signStrategy: {
+                type: "event-emitter",
+                emitter: new EventTarget(),
+            },
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject invalid sign strategy", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            signStrategy: { type: "invalid" },
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept spaceCreationHandler", () => {
+        const handler = {
+            confirmSpaceCreation: async () => true,
+        };
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            spaceCreationHandler: handler,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject invalid spaceCreationHandler", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            spaceCreationHandler: { notValid: true },
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept autoCreateSpace boolean", () => {
+        expect(UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            autoCreateSpace: true,
+        }).success).toBe(true);
+        expect(UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            autoCreateSpace: false,
+        }).success).toBe(true);
+    });
+    it("should reject non-boolean autoCreateSpace", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            autoCreateSpace: "true",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept spacePrefix string", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            spacePrefix: "myapp",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept tinycloudHosts array", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            tinycloudHosts: ["https://a.com", "https://b.com"],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-array tinycloudHosts", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            tinycloudHosts: "https://node.tinycloud.xyz",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept sessionExpirationMs", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            sessionExpirationMs: 86400000, // 24 hours
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject negative sessionExpirationMs", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            sessionExpirationMs: -1000,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject zero sessionExpirationMs", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            sessionExpirationMs: 0,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should accept full config", () => {
+        const result = UserAuthorizationConfigSchema.safeParse({
+            signer: mockSigner,
+            sessionStorage: { saveSession: async () => { } },
+            siweConfig: { domain: "example.com" },
+            domain: "example.com",
+            extensions: [{ namespace: "storage" }],
+            signStrategy: { type: "auto-sign" },
+            spaceCreationHandler: { confirmSpaceCreation: async () => true },
+            autoCreateSpace: true,
+            spacePrefix: "default",
+            tinycloudHosts: ["https://node.tinycloud.xyz"],
+            sessionExpirationMs: 86400000,
+        });
+        expect(result.success).toBe(true);
+    });
+});
+describe("validateUserAuthorizationConfig", () => {
+    const mockSigner = {
+        getAddress: async () => "0x1234567890123456789012345678901234567890",
+    };
+    it("should return ok result for valid config", () => {
+        const result = validateUserAuthorizationConfig({
+            signer: mockSigner,
+            domain: "example.com",
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.domain).toBe("example.com");
+        }
+    });
+    it("should return error result for missing signer", () => {
+        const result = validateUserAuthorizationConfig({});
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+            expect(result.error.service).toBe("authorization");
+            expect(result.error.meta?.issues).toBeDefined();
+        }
+    });
+    it("should return error result for invalid sign strategy", () => {
+        const result = validateUserAuthorizationConfig({
+            signer: mockSigner,
+            signStrategy: { type: "invalid" },
+        });
+        expect(result.ok).toBe(false);
+    });
+});
+describe("validatePartialSiweMessage", () => {
+    it("should return ok result for valid message", () => {
+        const result = validatePartialSiweMessage({
+            address: "0x1234567890123456789012345678901234567890",
+            chainId: 1,
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.address).toBe("0x1234567890123456789012345678901234567890");
+            expect(result.data.chainId).toBe(1);
+        }
+    });
+    it("should return ok result for empty message", () => {
+        const result = validatePartialSiweMessage({});
+        expect(result.ok).toBe(true);
+    });
+    it("should return error result for invalid chainId", () => {
+        const result = validatePartialSiweMessage({
+            chainId: -1,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+            expect(result.error.service).toBe("authorization");
+        }
+    });
+});
+//# sourceMappingURL=userAuthorization.schema.test.js.map

package/dist/userAuthorization.schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userAuthorization.schema.test.js","sourceRoot":"","sources":["../src/userAuthorization.schema.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,4CAA4C;SACtD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,4CAA4C;YACrD,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,qBAAqB;YAC1B,OAAO,EAAE,GAAG;YACZ,MAAM,EAAE,aAAa;YACrB,SAAS,EAAE,oBAAoB;YAC/B,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,sBAAsB;YAChC,cAAc,EAAE,sBAAsB;YACtC,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,CAAC,8BAA8B,CAAC;SAC5C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,CAAC,CAAC;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,SAAS,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC;YAChD,SAAS,EAAE,qBAAqB;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,qBAAqB;IACrB,MAAM,UAAU,GAAG;QACjB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,4CAA4C;QACpE,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa;QACtC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;KAC1B,CAAC;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,eAAe;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,WAAW,GAAG;YAClB,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;YAC3B,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;YAC7B,YAAY,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SAC7B,CAAC;QACF,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,WAAW;SAC5B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,eAAe;SAChC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,aAAa,GAAG;YACpB,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,EAAE;SACjB,CAAC;QACF,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,CAAC,aAAa,CAAC;SAC5B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,CAAC,eAAe,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE;gBACZ,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;aAC1C;SACF,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE;gBACZ,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI,WAAW,EAAE;aAC3B;SACF,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG;YACd,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;SACvC,CAAC;QACF,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,oBAAoB,EAAE,OAAO;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,oBAAoB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;SACzC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CACJ,6BAA6B,CAAC,SAAS,CAAC;YACtC,MAAM,EAAE,UAAU;YAClB,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC,OAAO,CACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,CACJ,6BAA6B,CAAC,SAAS,CAAC;YACtC,MAAM,EAAE,UAAU;YAClB,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC,OAAO,CACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,eAAe,EAAE,MAAM;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,OAAO;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;SACnD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,4BAA4B;SAC7C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,mBAAmB,EAAE,QAAQ,EAAE,WAAW;SAC3C,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,mBAAmB,EAAE,CAAC,IAAI;SAC3B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,mBAAmB,EAAE,CAAC;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE;YAC/C,UAAU,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;YACrC,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;YACtC,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;YACnC,oBAAoB,EAAE,EAAE,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,EAAE;YAChE,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,SAAS;YACtB,cAAc,EAAE,CAAC,4BAA4B,CAAC;YAC9C,mBAAmB,EAAE,QAAQ;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,MAAM,UAAU,GAAG;QACjB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,4CAA4C;KACrE,CAAC;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,+BAA+B,CAAC;YAC7C,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,+BAA+B,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,+BAA+B,CAAC;YAC7C,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,0BAA0B,CAAC;YACxC,OAAO,EAAE,4CAA4C;YACrD,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAC9B,4CAA4C,CAC7C,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,0BAA0B,CAAC;YACxC,OAAO,EAAE,CAAC,CAAC;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Protocol version checking for SDK-to-node compatibility.
+ *
+ * @packageDocumentation
+ */
+export declare class ProtocolMismatchError extends Error {
+    readonly sdkProtocol: number;
+    readonly nodeProtocol: number;
+    readonly nodeVersion: string;
+    readonly host: string;
+    name: "ProtocolMismatchError";
+    constructor(sdkProtocol: number, nodeProtocol: number, nodeVersion: string, host: string);
+}
+export declare class VersionCheckError extends Error {
+    readonly host: string;
+    readonly cause?: Error | undefined;
+    name: "VersionCheckError";
+    constructor(host: string, cause?: Error | undefined);
+}
+/**
+ * Check that the SDK protocol version matches the node's protocol version.
+ *
+ * @param host - The TinyCloud node host URL
+ * @param sdkProtocol - The SDK's protocol version (from WASM)
+ * @param fetchFn - Fetch implementation (defaults to globalThis.fetch)
+ * @throws VersionCheckError if the /version endpoint is unreachable
+ * @throws ProtocolMismatchError if protocol versions don't match
+ */
+export declare function checkNodeVersion(host: string, sdkProtocol: number, fetchFn?: typeof globalThis.fetch): Promise<void>;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,WAAW,EAAE,MAAM;aACnB,YAAY,EAAE,MAAM;aACpB,WAAW,EAAE,MAAM;aACnB,IAAI,EAAE,MAAM;IAL9B,IAAI,EAAG,uBAAuB,CAAU;gBAEtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM;CAS/B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAGxB,IAAI,EAAE,MAAM;aACZ,KAAK,CAAC,EAAE,KAAK;IAH/B,IAAI,EAAG,mBAAmB,CAAU;gBAElB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,KAAK,YAAA;CAMhC;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAyC,GACnE,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/version.js

@@ -0,0 +1,54 @@
+/**
+ * Protocol version checking for SDK-to-node compatibility.
+ *
+ * @packageDocumentation
+ */
+export class ProtocolMismatchError extends Error {
+    constructor(sdkProtocol, nodeProtocol, nodeVersion, host) {
+        super(`SDK protocol version ${sdkProtocol} is incompatible with node protocol version ${nodeProtocol} (node v${nodeVersion}) at ${host}. ` +
+            (sdkProtocol < nodeProtocol
+                ? "Please update your SDK."
+                : "Please update the TinyCloud node."));
+        this.sdkProtocol = sdkProtocol;
+        this.nodeProtocol = nodeProtocol;
+        this.nodeVersion = nodeVersion;
+        this.host = host;
+        this.name = "ProtocolMismatchError";
+    }
+}
+export class VersionCheckError extends Error {
+    constructor(host, cause) {
+        super(`Failed to check version at ${host}. Ensure the node is running v1.0.0+ and the /version endpoint is accessible.`);
+        this.host = host;
+        this.cause = cause;
+        this.name = "VersionCheckError";
+    }
+}
+/**
+ * Check that the SDK protocol version matches the node's protocol version.
+ *
+ * @param host - The TinyCloud node host URL
+ * @param sdkProtocol - The SDK's protocol version (from WASM)
+ * @param fetchFn - Fetch implementation (defaults to globalThis.fetch)
+ * @throws VersionCheckError if the /version endpoint is unreachable
+ * @throws ProtocolMismatchError if protocol versions don't match
+ */
+export async function checkNodeVersion(host, sdkProtocol, fetchFn = globalThis.fetch.bind(globalThis)) {
+    let response;
+    try {
+        response = await fetchFn(`${host}/version`, {
+            signal: AbortSignal.timeout(5000),
+        });
+    }
+    catch (err) {
+        throw new VersionCheckError(host, err);
+    }
+    if (!response.ok) {
+        throw new VersionCheckError(host);
+    }
+    const data = (await response.json());
+    if (sdkProtocol !== data.protocol) {
+        throw new ProtocolMismatchError(sdkProtocol, data.protocol, data.version, host);
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE9C,YACkB,WAAmB,EACnB,YAAoB,EACpB,WAAmB,EACnB,IAAY;QAE5B,KAAK,CACH,wBAAwB,WAAW,+CAA+C,YAAY,WAAW,WAAW,QAAQ,IAAI,IAAI;YAClI,CAAC,WAAW,GAAG,YAAY;gBACzB,CAAC,CAAC,yBAAyB;gBAC3B,CAAC,CAAC,mCAAmC,CAAC,CAC3C,CAAC;QAVc,gBAAW,GAAX,WAAW,CAAQ;QACnB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,gBAAW,GAAX,WAAW,CAAQ;QACnB,SAAI,GAAJ,IAAI,CAAQ;QAL9B,SAAI,GAAG,uBAAgC,CAAC;IAaxC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAE1C,YACkB,IAAY,EACZ,KAAa;QAE7B,KAAK,CACH,8BAA8B,IAAI,+EAA+E,CAClH,CAAC;QALc,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;QAH/B,SAAI,GAAG,mBAA4B,CAAC;IAQpC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,WAAmB,EACnB,UAAmC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IAEpE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE;YAC1C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,GAAY,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;IAEF,IAAI,WAAW,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,qBAAqB,CAC7B,WAAW,EACX,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,IAAI,CACL,CAAC;IACJ,CAAC;AACH,CAAC"}