@tinycloud/sdk-core 1.0.0

package/dist/space.schema.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Zod schemas for space hosting and session activation types.
+ *
+ * These schemas provide runtime validation for space hosting operations.
+ * Types are derived from schemas using z.infer<>.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+import type { Result, ServiceError } from "@tinycloud/sdk-services";
+/**
+ * Validation error type for schema validation failures.
+ */
+export interface ValidationError extends ServiceError {
+    code: "VALIDATION_ERROR";
+    meta?: {
+        issues: z.ZodIssue[];
+        path?: string;
+    };
+}
+/**
+ * Result of a space hosting or session activation attempt.
+ *
+ * This schema represents the response from space hosting and session
+ * activation operations with TinyCloud servers.
+ */
+export declare const SpaceHostResultSchema: z.ZodObject<{
+    /** Whether the operation succeeded (2xx status) */
+    success: z.ZodBoolean;
+    /** HTTP status code */
+    status: z.ZodNumber;
+    /** Error message if failed */
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: number;
+    success: boolean;
+    error?: string | undefined;
+}, {
+    status: number;
+    success: boolean;
+    error?: string | undefined;
+}>;
+export type SpaceHostResult = z.infer<typeof SpaceHostResultSchema>;
+/**
+ * Validate a SpaceHostResult object against the schema.
+ *
+ * @param data - Unknown data to validate
+ * @returns Result with validated data or validation error
+ *
+ * @example
+ * ```typescript
+ * const result = validateSpaceHostResult(response);
+ * if (result.ok) {
+ *   if (result.data.success) {
+ *     console.log("Space hosted successfully");
+ *   } else {
+ *     console.error("Failed:", result.data.error);
+ *   }
+ * } else {
+ *   console.error("Validation failed:", result.error.message);
+ * }
+ * ```
+ */
+export declare function validateSpaceHostResult(data: unknown): Result<SpaceHostResult, ValidationError>;
+//# sourceMappingURL=space.schema.d.ts.map

package/dist/space.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.schema.d.ts","sourceRoot":"","sources":["../src/space.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMpE;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAMD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;IAChC,mDAAmD;;IAEnD,uBAAuB;;IAEvB,8BAA8B;;;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,CAc1C"}

package/dist/space.schema.js

@@ -0,0 +1,65 @@
+/**
+ * Zod schemas for space hosting and session activation types.
+ *
+ * These schemas provide runtime validation for space hosting operations.
+ * Types are derived from schemas using z.infer<>.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+// =============================================================================
+// SpaceHostResult Schema
+// =============================================================================
+/**
+ * Result of a space hosting or session activation attempt.
+ *
+ * This schema represents the response from space hosting and session
+ * activation operations with TinyCloud servers.
+ */
+export const SpaceHostResultSchema = z.object({
+    /** Whether the operation succeeded (2xx status) */
+    success: z.boolean(),
+    /** HTTP status code */
+    status: z.number().int(),
+    /** Error message if failed */
+    error: z.string().optional(),
+});
+// =============================================================================
+// Validation Helpers
+// =============================================================================
+/**
+ * Validate a SpaceHostResult object against the schema.
+ *
+ * @param data - Unknown data to validate
+ * @returns Result with validated data or validation error
+ *
+ * @example
+ * ```typescript
+ * const result = validateSpaceHostResult(response);
+ * if (result.ok) {
+ *   if (result.data.success) {
+ *     console.log("Space hosted successfully");
+ *   } else {
+ *     console.error("Failed:", result.data.error);
+ *   }
+ * } else {
+ *   console.error("Validation failed:", result.error.message);
+ * }
+ * ```
+ */
+export function validateSpaceHostResult(data) {
+    const result = SpaceHostResultSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: result.error.message,
+                service: "space",
+                meta: { issues: result.error.issues },
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=space.schema.js.map

package/dist/space.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space.schema.js","sourceRoot":"","sources":["../src/space.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,mDAAmD;IACnD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,uBAAuB;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,8BAA8B;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAIH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAa;IAEb,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;gBAC7B,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;aACtC;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/space.schema.test.d.ts

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

package/dist/space.schema.test.d.ts.map

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

package/dist/space.schema.test.js

@@ -0,0 +1,148 @@
+/**
+ * Tests for space.schema.ts Zod schemas.
+ */
+import { describe, expect, it } from "bun:test";
+import { SpaceHostResultSchema, validateSpaceHostResult, } from "./space.schema";
+// =============================================================================
+// Test Fixtures
+// =============================================================================
+const validSuccessResult = {
+    success: true,
+    status: 200,
+};
+const validFailureResult = {
+    success: false,
+    status: 404,
+    error: "Space not found",
+};
+// =============================================================================
+// SpaceHostResultSchema Tests
+// =============================================================================
+describe("SpaceHostResultSchema", () => {
+    describe("valid inputs", () => {
+        it("accepts successful result without error", () => {
+            const result = SpaceHostResultSchema.safeParse(validSuccessResult);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.success).toBe(true);
+                expect(result.data.status).toBe(200);
+                expect(result.data.error).toBeUndefined();
+            }
+        });
+        it("accepts failure result with error message", () => {
+            const result = SpaceHostResultSchema.safeParse(validFailureResult);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.success).toBe(false);
+                expect(result.data.status).toBe(404);
+                expect(result.data.error).toBe("Space not found");
+            }
+        });
+        it("accepts result with empty error string", () => {
+            const data = {
+                success: false,
+                status: 500,
+                error: "",
+            };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(true);
+        });
+        it("accepts various HTTP status codes", () => {
+            const statusCodes = [200, 201, 204, 400, 401, 403, 404, 409, 500, 502, 503];
+            for (const status of statusCodes) {
+                const data = { success: status < 400, status };
+                const result = SpaceHostResultSchema.safeParse(data);
+                expect(result.success).toBe(true);
+            }
+        });
+    });
+    describe("invalid inputs", () => {
+        it("rejects missing success field", () => {
+            const data = { status: 200 };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(false);
+        });
+        it("rejects missing status field", () => {
+            const data = { success: true };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(false);
+        });
+        it("rejects non-boolean success", () => {
+            const data = { success: "true", status: 200 };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(false);
+        });
+        it("rejects non-number status", () => {
+            const data = { success: true, status: "200" };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(false);
+        });
+        it("rejects floating point status", () => {
+            const data = { success: true, status: 200.5 };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(false);
+        });
+        it("rejects non-string error", () => {
+            const data = { success: false, status: 500, error: 123 };
+            const result = SpaceHostResultSchema.safeParse(data);
+            expect(result.success).toBe(false);
+        });
+        it("rejects null", () => {
+            const result = SpaceHostResultSchema.safeParse(null);
+            expect(result.success).toBe(false);
+        });
+        it("rejects undefined", () => {
+            const result = SpaceHostResultSchema.safeParse(undefined);
+            expect(result.success).toBe(false);
+        });
+        it("rejects empty object", () => {
+            const result = SpaceHostResultSchema.safeParse({});
+            expect(result.success).toBe(false);
+        });
+    });
+});
+// =============================================================================
+// Validation Function Tests
+// =============================================================================
+describe("validateSpaceHostResult", () => {
+    it("returns ok result for valid success data", () => {
+        const result = validateSpaceHostResult(validSuccessResult);
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.success).toBe(true);
+            expect(result.data.status).toBe(200);
+        }
+    });
+    it("returns ok result for valid failure data", () => {
+        const result = validateSpaceHostResult(validFailureResult);
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.success).toBe(false);
+            expect(result.data.error).toBe("Space not found");
+        }
+    });
+    it("returns error result for invalid data", () => {
+        const result = validateSpaceHostResult({});
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+            expect(result.error.service).toBe("space");
+            expect(result.error.meta?.issues).toBeDefined();
+        }
+    });
+    it("returns error with validation issues for missing success", () => {
+        const result = validateSpaceHostResult({ status: 200 });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.meta?.issues).toContainEqual(expect.objectContaining({ path: ["success"] }));
+        }
+    });
+    it("returns error with validation issues for invalid status type", () => {
+        const result = validateSpaceHostResult({ success: true, status: "200" });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.meta?.issues).toContainEqual(expect.objectContaining({ path: ["status"] }));
+        }
+    });
+});
+//# sourceMappingURL=space.schema.test.js.map

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

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

package/dist/spaces/Space.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Space - Represents a scoped access point to a TinyCloud space.
+ *
+ * The Space object provides scoped access to services within a specific space,
+ * whether owned by the user or delegated from another user.
+ *
+ * @packageDocumentation
+ */
+import type { IKVService, Result, ServiceError } from "@tinycloud/sdk-services";
+import type { SpaceInfo } from "../delegations/types";
+/**
+ * Interface for space-scoped delegation operations.
+ *
+ * Provides delegation management scoped to a specific space.
+ */
+export interface ISpaceScopedDelegations {
+    /**
+     * List delegations created by the user in this space (outgoing).
+     */
+    list(): Promise<Result<import("../delegations/types").Delegation[], ServiceError>>;
+    /**
+     * List delegations received by the user for this space (incoming).
+     */
+    listReceived(): Promise<Result<import("../delegations/types").Delegation[], ServiceError>>;
+    /**
+     * Create a delegation within this space.
+     */
+    create(params: Omit<import("../delegations/types").CreateDelegationParams, "spaceId">): Promise<Result<import("../delegations/types").Delegation, ServiceError>>;
+    /**
+     * Revoke a delegation within this space.
+     */
+    revoke(cid: string): Promise<Result<void, ServiceError>>;
+}
+/**
+ * Interface for space-scoped sharing operations.
+ *
+ * Provides sharing link management scoped to a specific space.
+ */
+export interface ISpaceScopedSharing {
+    /**
+     * Generate a sharing link for a resource in this space.
+     */
+    generate(params: Omit<import("../delegations/types").GenerateShareParams, "spaceId">): Promise<Result<import("../delegations/types").ShareLink, ServiceError>>;
+    /**
+     * List active sharing links in this space.
+     */
+    list(): Promise<Result<import("../delegations/types").ShareLink[], ServiceError>>;
+    /**
+     * Revoke a sharing link.
+     */
+    revoke(token: string): Promise<Result<void, ServiceError>>;
+}
+/**
+ * Interface for a Space object.
+ *
+ * Provides scoped access to services within a specific space.
+ */
+export interface ISpace {
+    /**
+     * The space identifier.
+     */
+    readonly id: string;
+    /**
+     * The short name of the space.
+     */
+    readonly name: string;
+    /**
+     * KV operations scoped to this space.
+     */
+    readonly kv: IKVService;
+    /**
+     * Delegation operations scoped to this space.
+     */
+    readonly delegations: ISpaceScopedDelegations;
+    /**
+     * Sharing operations scoped to this space.
+     */
+    readonly sharing: ISpaceScopedSharing;
+    /**
+     * Get space metadata.
+     */
+    info(): Promise<Result<SpaceInfo, ServiceError>>;
+}
+/**
+ * Configuration for creating a Space object.
+ */
+export interface SpaceConfig {
+    /**
+     * The space identifier (full URI).
+     */
+    id: string;
+    /**
+     * The short name of the space.
+     */
+    name: string;
+    /**
+     * Factory function to create a space-scoped KV service.
+     */
+    createKV: (spaceId: string) => IKVService;
+    /**
+     * Factory function to create space-scoped delegations.
+     */
+    createDelegations: (spaceId: string) => ISpaceScopedDelegations;
+    /**
+     * Factory function to create space-scoped sharing.
+     */
+    createSharing: (spaceId: string) => ISpaceScopedSharing;
+    /**
+     * Function to get space info.
+     */
+    getInfo: (spaceId: string) => Promise<Result<SpaceInfo, ServiceError>>;
+}
+/**
+ * Space - Provides scoped access to services within a specific space.
+ *
+ * @example
+ * ```typescript
+ * const space = sdk.space('default');
+ *
+ * // KV operations scoped to this space
+ * await space.kv.put('key', 'value');
+ * const result = await space.kv.get('key');
+ *
+ * // Delegation operations scoped to this space
+ * await space.delegations.create({
+ *   delegateDID: 'did:pkh:eip155:1:0x...',
+ *   path: '/shared/',
+ *   actions: ['tinycloud.kv/get']
+ * });
+ *
+ * // Get space metadata
+ * const info = await space.info();
+ * ```
+ */
+export declare class Space implements ISpace {
+    private readonly _id;
+    private readonly _name;
+    private readonly _kv;
+    private readonly _delegations;
+    private readonly _sharing;
+    private readonly _getInfo;
+    /**
+     * Create a new Space instance.
+     *
+     * @param config - Space configuration
+     */
+    constructor(config: SpaceConfig);
+    /**
+     * The space identifier (full URI).
+     */
+    get id(): string;
+    /**
+     * The short name of the space.
+     */
+    get name(): string;
+    /**
+     * KV operations scoped to this space.
+     */
+    get kv(): IKVService;
+    /**
+     * Delegation operations scoped to this space.
+     */
+    get delegations(): ISpaceScopedDelegations;
+    /**
+     * Sharing operations scoped to this space.
+     */
+    get sharing(): ISpaceScopedSharing;
+    /**
+     * Get space metadata.
+     *
+     * @returns Result containing space information
+     */
+    info(): Promise<Result<SpaceInfo, ServiceError>>;
+}
+//# sourceMappingURL=Space.d.ts.map

package/dist/spaces/Space.d.ts.map

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

package/dist/spaces/Space.js

@@ -0,0 +1,84 @@
+/**
+ * Space - Represents a scoped access point to a TinyCloud space.
+ *
+ * The Space object provides scoped access to services within a specific space,
+ * whether owned by the user or delegated from another user.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Space - Provides scoped access to services within a specific space.
+ *
+ * @example
+ * ```typescript
+ * const space = sdk.space('default');
+ *
+ * // KV operations scoped to this space
+ * await space.kv.put('key', 'value');
+ * const result = await space.kv.get('key');
+ *
+ * // Delegation operations scoped to this space
+ * await space.delegations.create({
+ *   delegateDID: 'did:pkh:eip155:1:0x...',
+ *   path: '/shared/',
+ *   actions: ['tinycloud.kv/get']
+ * });
+ *
+ * // Get space metadata
+ * const info = await space.info();
+ * ```
+ */
+export class Space {
+    /**
+     * Create a new Space instance.
+     *
+     * @param config - Space configuration
+     */
+    constructor(config) {
+        this._id = config.id;
+        this._name = config.name;
+        this._kv = config.createKV(config.id);
+        this._delegations = config.createDelegations(config.id);
+        this._sharing = config.createSharing(config.id);
+        this._getInfo = config.getInfo;
+    }
+    /**
+     * The space identifier (full URI).
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * The short name of the space.
+     */
+    get name() {
+        return this._name;
+    }
+    /**
+     * KV operations scoped to this space.
+     */
+    get kv() {
+        return this._kv;
+    }
+    /**
+     * Delegation operations scoped to this space.
+     */
+    get delegations() {
+        return this._delegations;
+    }
+    /**
+     * Sharing operations scoped to this space.
+     */
+    get sharing() {
+        return this._sharing;
+    }
+    /**
+     * Get space metadata.
+     *
+     * @returns Result containing space information
+     */
+    async info() {
+        return this._getInfo(this._id);
+    }
+}
+//# sourceMappingURL=Space.js.map

package/dist/spaces/Space.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Space.js","sourceRoot":"","sources":["../../src/spaces/Space.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkIH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,KAAK;IAQhB;;;;OAIG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;CACF"}