@tinycloudlabs/sdk-core 1.0.0

package/dist/authorization/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * TinyCloud SDK Authorization Module
+ *
+ * This module provides authorization and capability management
+ * for the TinyCloud SDK.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CapabilityKeyRegistry,
+ *   ICapabilityKeyRegistry,
+ *   createCapabilityKeyRegistry,
+ * } from "@tinycloudlabs/sdk-core/authorization";
+ *
+ * // Create a capability registry
+ * const registry = createCapabilityKeyRegistry();
+ *
+ * // Register a session key with its delegations
+ * registry.registerKey(sessionKey, [rootDelegation]);
+ *
+ * // Get the best key for an operation
+ * const key = registry.getKeyForCapability(
+ *   "tinycloud://my-space/kv/data",
+ *   "tinycloud.kv/get"
+ * );
+ *
+ * if (key) {
+ *   // Use this key for the operation
+ *   console.log("Using key:", key.id);
+ * }
+ * ```
+ */
+export { CapabilityKeyRegistry, ICapabilityKeyRegistry, createCapabilityKeyRegistry, StoredDelegationChain, CapabilityKeyRegistryErrorCodes, CapabilityKeyRegistryErrorCode, } from "./CapabilityKeyRegistry";
+export { SignRequest, SignResponse, SignCallback, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, EventEmitterStrategy, SignStrategy, defaultSignStrategy, } from "./strategies";
+export { SpaceCreationContext, ISpaceCreationHandler, AutoApproveSpaceCreationHandler, defaultSpaceCreationHandler, } from "./spaceCreation";
+//# sourceMappingURL=index.d.ts.map

package/dist/authorization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAEL,qBAAqB,EAErB,sBAAsB,EAEtB,2BAA2B,EAE3B,qBAAqB,EAErB,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAEL,WAAW,EACX,YAAY,EACZ,YAAY,EAEZ,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EAEZ,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,oBAAoB,EAEpB,qBAAqB,EAErB,+BAA+B,EAE/B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/authorization/index.js

@@ -0,0 +1,52 @@
+/**
+ * TinyCloud SDK Authorization Module
+ *
+ * This module provides authorization and capability management
+ * for the TinyCloud SDK.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CapabilityKeyRegistry,
+ *   ICapabilityKeyRegistry,
+ *   createCapabilityKeyRegistry,
+ * } from "@tinycloudlabs/sdk-core/authorization";
+ *
+ * // Create a capability registry
+ * const registry = createCapabilityKeyRegistry();
+ *
+ * // Register a session key with its delegations
+ * registry.registerKey(sessionKey, [rootDelegation]);
+ *
+ * // Get the best key for an operation
+ * const key = registry.getKeyForCapability(
+ *   "tinycloud://my-space/kv/data",
+ *   "tinycloud.kv/get"
+ * );
+ *
+ * if (key) {
+ *   // Use this key for the operation
+ *   console.log("Using key:", key.id);
+ * }
+ * ```
+ */
+export { 
+// Class
+CapabilityKeyRegistry, 
+// Factory
+createCapabilityKeyRegistry, 
+// Error codes
+CapabilityKeyRegistryErrorCodes, } from "./CapabilityKeyRegistry";
+// SignStrategy types
+export { 
+// Default
+defaultSignStrategy, } from "./strategies";
+// Space creation handler types
+export { 
+// Default implementation
+AutoApproveSpaceCreationHandler, 
+// Default instance
+defaultSpaceCreationHandler, } from "./spaceCreation";
+//# sourceMappingURL=index.js.map

package/dist/authorization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO;AACL,QAAQ;AACR,qBAAqB;AAGrB,UAAU;AACV,2BAA2B;AAG3B,cAAc;AACd,+BAA+B,GAEhC,MAAM,yBAAyB,CAAC;AAEjC,qBAAqB;AACrB,OAAO;AAWL,UAAU;AACV,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,+BAA+B;AAC/B,OAAO;AAKL,yBAAyB;AACzB,+BAA+B;AAC/B,mBAAmB;AACnB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/authorization/spaceCreation.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Space creation handler types for TinyCloud authorization.
+ *
+ * These types abstract space creation confirmation, allowing different
+ * implementations for web (modal) vs node (auto-approve) environments.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Context passed to space creation handlers.
+ */
+export interface SpaceCreationContext {
+    /** The unique identifier for the space being created */
+    spaceId: string;
+    /** Ethereum address of the user creating the space */
+    address: string;
+    /** Chain ID for the creation context */
+    chainId: number;
+    /** Host URL where the space will be created */
+    host: string;
+}
+/**
+ * Interface for handling space creation confirmation.
+ *
+ * Implementations can provide different UX patterns:
+ * - Auto-approve for backend services
+ * - Modal confirmation for web apps
+ * - CLI prompts for terminal apps
+ *
+ * @example
+ * ```typescript
+ * class ModalSpaceCreationHandler implements ISpaceCreationHandler {
+ *   async confirmSpaceCreation(context: SpaceCreationContext): Promise<boolean> {
+ *     return await showConfirmationModal(`Create space ${context.spaceId}?`);
+ *   }
+ *
+ *   onSpaceCreated(context: SpaceCreationContext): void {
+ *     showToast(`Space ${context.spaceId} created!`);
+ *   }
+ *
+ *   onSpaceCreationFailed(context: SpaceCreationContext, error: Error): void {
+ *     showErrorModal(`Failed to create space: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export interface ISpaceCreationHandler {
+    /**
+     * Called when a new space needs to be created.
+     * Returns true if space should be created, false to skip.
+     *
+     * @param context - Information about the space to be created
+     * @returns Promise resolving to true to proceed, false to cancel
+     */
+    confirmSpaceCreation(context: SpaceCreationContext): Promise<boolean>;
+    /**
+     * Called after successful space creation.
+     * Optional - implement to show success UI or perform cleanup.
+     *
+     * @param context - Information about the created space
+     */
+    onSpaceCreated?(context: SpaceCreationContext): void;
+    /**
+     * Called if space creation fails.
+     * Optional - implement to show error UI or perform recovery.
+     *
+     * @param context - Information about the space that failed to create
+     * @param error - The error that occurred
+     */
+    onSpaceCreationFailed?(context: SpaceCreationContext, error: Error): void;
+}
+/**
+ * Default handler that auto-approves all space creation.
+ *
+ * Use cases:
+ * - Backend services
+ * - Automated scripts
+ * - Node.js applications without UI
+ *
+ * @example
+ * ```typescript
+ * const handler = new AutoApproveSpaceCreationHandler();
+ * const config = { spaceCreationHandler: handler };
+ * ```
+ */
+export declare class AutoApproveSpaceCreationHandler implements ISpaceCreationHandler {
+    /**
+     * Always returns true to auto-approve space creation.
+     */
+    confirmSpaceCreation(): Promise<boolean>;
+}
+/**
+ * Default space creation handler that auto-approves all requests.
+ */
+export declare const defaultSpaceCreationHandler: ISpaceCreationHandler;
+//# sourceMappingURL=spaceCreation.d.ts.map

package/dist/authorization/spaceCreation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceCreation.d.ts","sourceRoot":"","sources":["../../src/authorization/spaceCreation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAErD;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3E;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,+BAAgC,YAAW,qBAAqB;IAC3E;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;CAG/C;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,qBACH,CAAC"}

package/dist/authorization/spaceCreation.js

@@ -0,0 +1,35 @@
+/**
+ * Space creation handler types for TinyCloud authorization.
+ *
+ * These types abstract space creation confirmation, allowing different
+ * implementations for web (modal) vs node (auto-approve) environments.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Default handler that auto-approves all space creation.
+ *
+ * Use cases:
+ * - Backend services
+ * - Automated scripts
+ * - Node.js applications without UI
+ *
+ * @example
+ * ```typescript
+ * const handler = new AutoApproveSpaceCreationHandler();
+ * const config = { spaceCreationHandler: handler };
+ * ```
+ */
+export class AutoApproveSpaceCreationHandler {
+    /**
+     * Always returns true to auto-approve space creation.
+     */
+    async confirmSpaceCreation() {
+        return true;
+    }
+}
+/**
+ * Default space creation handler that auto-approves all requests.
+ */
+export const defaultSpaceCreationHandler = new AutoApproveSpaceCreationHandler();
+//# sourceMappingURL=spaceCreation.js.map

package/dist/authorization/spaceCreation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceCreation.js","sourceRoot":"","sources":["../../src/authorization/spaceCreation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqEH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,+BAA+B;IAC1C;;OAEG;IACH,KAAK,CAAC,oBAAoB;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,IAAI,+BAA+B,EAAE,CAAC"}

package/dist/authorization/spaceCreation.schema.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Zod schemas for space creation handler types.
+ *
+ * These schemas provide runtime validation for space creation configuration.
+ * Types are derived from schemas using z.infer<>.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+import type { Result } from "../delegations/types.schema";
+import type { ValidationError } from "../storage.schema";
+/**
+ * Schema for context passed to space creation handlers.
+ */
+export declare const SpaceCreationContextSchema: z.ZodObject<{
+    /** The unique identifier for the space being created */
+    spaceId: z.ZodString;
+    /** Ethereum address of the user creating the space */
+    address: z.ZodString;
+    /** Chain ID for the creation context */
+    chainId: z.ZodNumber;
+    /** Host URL where the space will be created */
+    host: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceId: string;
+    address: string;
+    chainId: number;
+    host: string;
+}, {
+    spaceId: string;
+    address: string;
+    chainId: number;
+    host: string;
+}>;
+export type SpaceCreationContext = z.infer<typeof SpaceCreationContextSchema>;
+/**
+ * Schema for ISpaceCreationHandler interface.
+ *
+ * Note: Since this is an interface with methods, we validate shape only.
+ * The actual implementation is not validated at runtime.
+ */
+export declare const SpaceCreationHandlerSchema: z.ZodObject<{
+    /** Called when a new space needs to be created */
+    confirmSpaceCreation: z.ZodEffects<z.ZodUnknown, (context: SpaceCreationContext) => Promise<boolean>, unknown>;
+    /** Called after successful space creation (optional) */
+    onSpaceCreated: z.ZodOptional<z.ZodEffects<z.ZodUnknown, ((context: SpaceCreationContext) => void) | undefined, unknown>>;
+    /** Called if space creation fails (optional) */
+    onSpaceCreationFailed: z.ZodOptional<z.ZodEffects<z.ZodUnknown, ((context: SpaceCreationContext, error: Error) => void) | undefined, unknown>>;
+}, "strip", z.ZodTypeAny, {
+    confirmSpaceCreation: (context: SpaceCreationContext) => Promise<boolean>;
+    onSpaceCreated?: ((context: SpaceCreationContext) => void) | undefined;
+    onSpaceCreationFailed?: ((context: SpaceCreationContext, error: Error) => void) | undefined;
+}, {
+    confirmSpaceCreation?: unknown;
+    onSpaceCreated?: unknown;
+    onSpaceCreationFailed?: unknown;
+}>;
+export type ISpaceCreationHandler = z.infer<typeof SpaceCreationHandlerSchema>;
+/**
+ * Validates a SpaceCreationContext object and returns a Result.
+ */
+export declare function validateSpaceCreationContext(data: unknown): Result<SpaceCreationContext, ValidationError>;
+/**
+ * Validates an ISpaceCreationHandler object and returns a Result.
+ */
+export declare function validateSpaceCreationHandler(data: unknown): Result<ISpaceCreationHandler, ValidationError>;
+//# sourceMappingURL=spaceCreation.schema.d.ts.map

package/dist/authorization/spaceCreation.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceCreation.schema.d.ts","sourceRoot":"","sources":["../../src/authorization/spaceCreation.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAezD;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,wDAAwD;;IAExD,sDAAsD;;IAEtD,wCAAwC;;IAExC,+CAA+C;;;;;;;;;;;;EAE/C,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;IACrC,kDAAkD;+DAExB,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC;IAInE,wDAAwD;wEAI3B,oBAAoB,KAAK,IAAI;IAK1D,gDAAgD;+EAInB,oBAAoB,SAAS,KAAK,KAAK,IAAI;;oCAjB9C,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC;gCAQtC,oBAAoB,KAAK,IAAI;uCAS7B,oBAAoB,SAAS,KAAK,KAAK,IAAI;;;;;EAKxE,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM/E;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAc/C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,qBAAqB,EAAE,eAAe,CAAC,CAchD"}

package/dist/authorization/spaceCreation.schema.js

@@ -0,0 +1,95 @@
+/**
+ * Zod schemas for space creation handler types.
+ *
+ * These schemas provide runtime validation for space creation configuration.
+ * Types are derived from schemas using z.infer<>.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+// =============================================================================
+// Shared Patterns
+// =============================================================================
+/**
+ * Ethereum address pattern (checksummed or lowercase).
+ */
+const ethereumAddressPattern = /^0x[a-fA-F0-9]{40}$/;
+// =============================================================================
+// Space Creation Context Schema
+// =============================================================================
+/**
+ * Schema for context passed to space creation handlers.
+ */
+export const SpaceCreationContextSchema = z.object({
+    /** The unique identifier for the space being created */
+    spaceId: z.string(),
+    /** Ethereum address of the user creating the space */
+    address: z.string().regex(ethereumAddressPattern, "Invalid Ethereum address"),
+    /** Chain ID for the creation context */
+    chainId: z.number().int().positive(),
+    /** Host URL where the space will be created */
+    host: z.string().url(),
+});
+// =============================================================================
+// Space Creation Handler Schema
+// =============================================================================
+/**
+ * Schema for ISpaceCreationHandler interface.
+ *
+ * Note: Since this is an interface with methods, we validate shape only.
+ * The actual implementation is not validated at runtime.
+ */
+export const SpaceCreationHandlerSchema = z.object({
+    /** Called when a new space needs to be created */
+    confirmSpaceCreation: z.unknown().refine((val) => typeof val === "function", { message: "Expected a confirmSpaceCreation function" }),
+    /** Called after successful space creation (optional) */
+    onSpaceCreated: z
+        .unknown()
+        .refine((val) => val === undefined || typeof val === "function", { message: "Expected an onSpaceCreated function or undefined" })
+        .optional(),
+    /** Called if space creation fails (optional) */
+    onSpaceCreationFailed: z
+        .unknown()
+        .refine((val) => val === undefined || typeof val === "function", { message: "Expected an onSpaceCreationFailed function or undefined" })
+        .optional(),
+});
+// =============================================================================
+// Validation Helpers
+// =============================================================================
+/**
+ * Validates a SpaceCreationContext object and returns a Result.
+ */
+export function validateSpaceCreationContext(data) {
+    const result = SpaceCreationContextSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: result.error.message,
+                service: "authorization",
+                meta: { issues: result.error.issues },
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+/**
+ * Validates an ISpaceCreationHandler object and returns a Result.
+ */
+export function validateSpaceCreationHandler(data) {
+    const result = SpaceCreationHandlerSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: result.error.message,
+                service: "authorization",
+                meta: { issues: result.error.issues },
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=spaceCreation.schema.js.map

package/dist/authorization/spaceCreation.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceCreation.schema.js","sourceRoot":"","sources":["../../src/authorization/spaceCreation.schema.ts"],"names":[],"mappings":"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"}

package/dist/authorization/spaceCreation.schema.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for space creation schemas.
+ */
+export {};
+//# sourceMappingURL=spaceCreation.schema.test.d.ts.map

package/dist/authorization/spaceCreation.schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceCreation.schema.test.d.ts","sourceRoot":"","sources":["../../src/authorization/spaceCreation.schema.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/authorization/spaceCreation.schema.test.js

@@ -0,0 +1,168 @@
+/**
+ * Tests for space creation schemas.
+ */
+import { describe, it, expect } from "bun:test";
+import { SpaceCreationContextSchema, SpaceCreationHandlerSchema, validateSpaceCreationContext, validateSpaceCreationHandler, } from "./spaceCreation.schema";
+describe("SpaceCreationContextSchema", () => {
+    const validContext = {
+        spaceId: "space-123",
+        address: "0x1234567890123456789012345678901234567890",
+        chainId: 1,
+        host: "https://node.tinycloud.xyz",
+    };
+    it("should accept valid context", () => {
+        const result = SpaceCreationContextSchema.safeParse(validContext);
+        expect(result.success).toBe(true);
+    });
+    it("should accept lowercase address", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            address: "0xabcdef1234567890123456789012345678901234",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept uppercase address", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            address: "0xABCDEF1234567890123456789012345678901234",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject invalid Ethereum address", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            address: "not-an-address",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject short address", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            address: "0x1234",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject missing spaceId", () => {
+        const { spaceId, ...rest } = validContext;
+        expect(SpaceCreationContextSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject missing address", () => {
+        const { address, ...rest } = validContext;
+        expect(SpaceCreationContextSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject missing chainId", () => {
+        const { chainId, ...rest } = validContext;
+        expect(SpaceCreationContextSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject missing host", () => {
+        const { host, ...rest } = validContext;
+        expect(SpaceCreationContextSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject negative chainId", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            chainId: -1,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject zero chainId", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            chainId: 0,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject invalid host URL", () => {
+        const result = SpaceCreationContextSchema.safeParse({
+            ...validContext,
+            host: "not-a-url",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("SpaceCreationHandlerSchema", () => {
+    it("should accept handler with only confirmSpaceCreation", () => {
+        const handler = {
+            confirmSpaceCreation: async () => true,
+        };
+        const result = SpaceCreationHandlerSchema.safeParse(handler);
+        expect(result.success).toBe(true);
+    });
+    it("should accept handler with all methods", () => {
+        const handler = {
+            confirmSpaceCreation: async () => true,
+            onSpaceCreated: () => { },
+            onSpaceCreationFailed: () => { },
+        };
+        const result = SpaceCreationHandlerSchema.safeParse(handler);
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-function confirmSpaceCreation", () => {
+        const handler = {
+            confirmSpaceCreation: "not a function",
+        };
+        const result = SpaceCreationHandlerSchema.safeParse(handler);
+        expect(result.success).toBe(false);
+    });
+    it("should reject missing confirmSpaceCreation", () => {
+        const handler = {
+            onSpaceCreated: () => { },
+        };
+        const result = SpaceCreationHandlerSchema.safeParse(handler);
+        expect(result.success).toBe(false);
+    });
+    it("should reject non-function onSpaceCreated", () => {
+        const handler = {
+            confirmSpaceCreation: async () => true,
+            onSpaceCreated: "not a function",
+        };
+        const result = SpaceCreationHandlerSchema.safeParse(handler);
+        expect(result.success).toBe(false);
+    });
+    it("should reject non-function onSpaceCreationFailed", () => {
+        const handler = {
+            confirmSpaceCreation: async () => true,
+            onSpaceCreationFailed: "not a function",
+        };
+        const result = SpaceCreationHandlerSchema.safeParse(handler);
+        expect(result.success).toBe(false);
+    });
+});
+describe("validateSpaceCreationContext", () => {
+    it("should return ok result for valid context", () => {
+        const result = validateSpaceCreationContext({
+            spaceId: "space-123",
+            address: "0x1234567890123456789012345678901234567890",
+            chainId: 1,
+            host: "https://node.tinycloud.xyz",
+        });
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.spaceId).toBe("space-123");
+        }
+    });
+    it("should return error result for invalid context", () => {
+        const result = validateSpaceCreationContext({});
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+            expect(result.error.service).toBe("authorization");
+        }
+    });
+});
+describe("validateSpaceCreationHandler", () => {
+    it("should return ok result for valid handler", () => {
+        const result = validateSpaceCreationHandler({
+            confirmSpaceCreation: async () => true,
+        });
+        expect(result.ok).toBe(true);
+    });
+    it("should return error result for invalid handler", () => {
+        const result = validateSpaceCreationHandler({});
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+        }
+    });
+});
+//# sourceMappingURL=spaceCreation.schema.test.js.map

package/dist/authorization/spaceCreation.schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceCreation.schema.test.js","sourceRoot":"","sources":["../../src/authorization/spaceCreation.schema.test.ts"],"names":[],"mappings":"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"}