@tinycloudlabs/sdk-core 1.0.0

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

@@ -0,0 +1,253 @@
+/**
+ * Tests for SignStrategy schemas.
+ */
+import { describe, it, expect } from "bun:test";
+import { SignRequestSchema, SignResponseSchema, SignRequestTypeSchema, AutoSignStrategySchema, AutoRejectStrategySchema, CallbackStrategySchema, EventEmitterStrategySchema, SignStrategySchema, validateSignStrategy, validateSignRequest, validateSignResponse, } from "./strategies.schema";
+describe("SignRequestTypeSchema", () => {
+    it("should accept valid sign request types", () => {
+        expect(SignRequestTypeSchema.safeParse("siwe").success).toBe(true);
+        expect(SignRequestTypeSchema.safeParse("message").success).toBe(true);
+    });
+    it("should reject invalid sign request types", () => {
+        expect(SignRequestTypeSchema.safeParse("invalid").success).toBe(false);
+        expect(SignRequestTypeSchema.safeParse("").success).toBe(false);
+        expect(SignRequestTypeSchema.safeParse(123).success).toBe(false);
+    });
+});
+describe("SignRequestSchema", () => {
+    const validRequest = {
+        address: "0x1234567890123456789012345678901234567890",
+        chainId: 1,
+        message: "Sign this message",
+        type: "siwe",
+    };
+    it("should accept valid sign request", () => {
+        const result = SignRequestSchema.safeParse(validRequest);
+        expect(result.success).toBe(true);
+    });
+    it("should accept message type", () => {
+        const result = SignRequestSchema.safeParse({
+            ...validRequest,
+            type: "message",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject missing address", () => {
+        const { address, ...rest } = validRequest;
+        expect(SignRequestSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject missing chainId", () => {
+        const { chainId, ...rest } = validRequest;
+        expect(SignRequestSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject missing message", () => {
+        const { message, ...rest } = validRequest;
+        expect(SignRequestSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject missing type", () => {
+        const { type, ...rest } = validRequest;
+        expect(SignRequestSchema.safeParse(rest).success).toBe(false);
+    });
+    it("should reject invalid type", () => {
+        const result = SignRequestSchema.safeParse({
+            ...validRequest,
+            type: "invalid",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("SignResponseSchema", () => {
+    it("should accept approved response with signature", () => {
+        const result = SignResponseSchema.safeParse({
+            approved: true,
+            signature: "0xabcdef",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept rejected response with reason", () => {
+        const result = SignResponseSchema.safeParse({
+            approved: false,
+            reason: "User cancelled",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept minimal response", () => {
+        const result = SignResponseSchema.safeParse({
+            approved: true,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject missing approved field", () => {
+        const result = SignResponseSchema.safeParse({
+            signature: "0xabcdef",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("AutoSignStrategySchema", () => {
+    it("should accept valid auto-sign strategy", () => {
+        const result = AutoSignStrategySchema.safeParse({ type: "auto-sign" });
+        expect(result.success).toBe(true);
+    });
+    it("should reject wrong type", () => {
+        const result = AutoSignStrategySchema.safeParse({ type: "auto-reject" });
+        expect(result.success).toBe(false);
+    });
+    it("should reject missing type", () => {
+        const result = AutoSignStrategySchema.safeParse({});
+        expect(result.success).toBe(false);
+    });
+});
+describe("AutoRejectStrategySchema", () => {
+    it("should accept valid auto-reject strategy", () => {
+        const result = AutoRejectStrategySchema.safeParse({ type: "auto-reject" });
+        expect(result.success).toBe(true);
+    });
+    it("should reject wrong type", () => {
+        const result = AutoRejectStrategySchema.safeParse({ type: "auto-sign" });
+        expect(result.success).toBe(false);
+    });
+});
+describe("CallbackStrategySchema", () => {
+    it("should accept valid callback strategy", () => {
+        const handler = async () => ({ approved: true, signature: "0x123" });
+        const result = CallbackStrategySchema.safeParse({
+            type: "callback",
+            handler,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-function handler", () => {
+        const result = CallbackStrategySchema.safeParse({
+            type: "callback",
+            handler: "not a function",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject missing handler", () => {
+        const result = CallbackStrategySchema.safeParse({
+            type: "callback",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("EventEmitterStrategySchema", () => {
+    it("should accept valid event emitter strategy", () => {
+        const emitter = new EventTarget();
+        const result = EventEmitterStrategySchema.safeParse({
+            type: "event-emitter",
+            emitter,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should accept with optional timeout", () => {
+        const emitter = new EventTarget();
+        const result = EventEmitterStrategySchema.safeParse({
+            type: "event-emitter",
+            emitter,
+            timeout: 30000,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject non-EventTarget emitter", () => {
+        const result = EventEmitterStrategySchema.safeParse({
+            type: "event-emitter",
+            emitter: "not an event target",
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject missing emitter", () => {
+        const result = EventEmitterStrategySchema.safeParse({
+            type: "event-emitter",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe("SignStrategySchema", () => {
+    it("should accept auto-sign strategy", () => {
+        const result = SignStrategySchema.safeParse({ type: "auto-sign" });
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.type).toBe("auto-sign");
+        }
+    });
+    it("should accept auto-reject strategy", () => {
+        const result = SignStrategySchema.safeParse({ type: "auto-reject" });
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.type).toBe("auto-reject");
+        }
+    });
+    it("should accept callback strategy", () => {
+        const handler = async () => ({ approved: true });
+        const result = SignStrategySchema.safeParse({ type: "callback", handler });
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.type).toBe("callback");
+        }
+    });
+    it("should accept event-emitter strategy", () => {
+        const emitter = new EventTarget();
+        const result = SignStrategySchema.safeParse({
+            type: "event-emitter",
+            emitter,
+        });
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.type).toBe("event-emitter");
+        }
+    });
+    it("should reject unknown strategy type", () => {
+        const result = SignStrategySchema.safeParse({ type: "unknown" });
+        expect(result.success).toBe(false);
+    });
+});
+describe("validateSignStrategy", () => {
+    it("should return ok result for valid strategy", () => {
+        const result = validateSignStrategy({ type: "auto-sign" });
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.data.type).toBe("auto-sign");
+        }
+    });
+    it("should return error result for invalid strategy", () => {
+        const result = validateSignStrategy({ type: "invalid" });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+            expect(result.error.service).toBe("authorization");
+        }
+    });
+});
+describe("validateSignRequest", () => {
+    it("should return ok result for valid request", () => {
+        const result = validateSignRequest({
+            address: "0x1234567890123456789012345678901234567890",
+            chainId: 1,
+            message: "Test",
+            type: "siwe",
+        });
+        expect(result.ok).toBe(true);
+    });
+    it("should return error result for invalid request", () => {
+        const result = validateSignRequest({});
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+        }
+    });
+});
+describe("validateSignResponse", () => {
+    it("should return ok result for valid response", () => {
+        const result = validateSignResponse({ approved: true });
+        expect(result.ok).toBe(true);
+    });
+    it("should return error result for invalid response", () => {
+        const result = validateSignResponse({});
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error.code).toBe("VALIDATION_ERROR");
+        }
+    });
+});
+//# sourceMappingURL=strategies.schema.test.js.map

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

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

package/dist/delegations/DelegationManager.d.ts

@@ -0,0 +1,164 @@
+/**
+ * DelegationManager - Handles delegation CRUD operations.
+ *
+ * This class manages the creation, revocation, listing, and querying
+ * of delegations within TinyCloud. It extracts and improves upon the
+ * delegation functionality previously in ITinyCloudStorage.
+ *
+ * @packageDocumentation
+ */
+import type { ServiceSession } from "@tinycloudlabs/sdk-services";
+import { Result, Delegation, CreateDelegationParams, DelegationChain, DelegationManagerConfig } from "./types";
+/**
+ * DelegationManager handles all delegation-related operations.
+ *
+ * @example
+ * ```typescript
+ * import { DelegationManager } from "@tinycloudlabs/sdk-core/delegations";
+ *
+ * const delegations = new DelegationManager({
+ *   hosts: ["https://node.tinycloud.xyz"],
+ *   session,
+ *   invoke,
+ * });
+ *
+ * // Create a delegation
+ * const result = await delegations.create({
+ *   delegateDID: "did:pkh:eip155:1:0x...",
+ *   path: "shared/",
+ *   actions: ["tinycloud.kv/get", "tinycloud.kv/list"],
+ *   expiry: new Date(Date.now() + 24 * 60 * 60 * 1000), // 24 hours
+ * });
+ *
+ * if (result.ok) {
+ *   console.log("Created delegation:", result.data.cid);
+ * }
+ * ```
+ */
+export declare class DelegationManager {
+    private hosts;
+    private session;
+    private invoke;
+    private fetchFn;
+    /**
+     * Creates a new DelegationManager instance.
+     *
+     * @param config - Configuration including hosts, session, and invoke function
+     */
+    constructor(config: DelegationManagerConfig);
+    /**
+     * Updates the session (e.g., after re-authentication).
+     *
+     * @param session - New session to use for operations
+     */
+    updateSession(session: ServiceSession): void;
+    /**
+     * Gets the primary host URL.
+     */
+    private get host();
+    /**
+     * Executes an invoke operation against the delegation API.
+     */
+    private invokeOperation;
+    /**
+     * Creates a new delegation.
+     *
+     * Delegates specific permissions to another DID for a given path.
+     * The delegatee can then use these permissions to access resources
+     * within the specified scope.
+     *
+     * @param params - Parameters for the delegation
+     * @returns Result containing the created Delegation or an error
+     *
+     * @example
+     * ```typescript
+     * const result = await manager.create({
+     *   delegateDID: bob.did,
+     *   path: "documents/shared/",
+     *   actions: ["tinycloud.kv/get", "tinycloud.kv/put"],
+     *   expiry: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000), // 7 days
+     * });
+     * ```
+     */
+    create(params: CreateDelegationParams): Promise<Result<Delegation>>;
+    /**
+     * Revokes an existing delegation.
+     *
+     * Once revoked, the delegation can no longer be used to access resources.
+     * This also invalidates any sub-delegations derived from this delegation.
+     *
+     * @param cid - The CID of the delegation to revoke
+     * @returns Result indicating success or an error
+     *
+     * @example
+     * ```typescript
+     * const result = await manager.revoke("bafy...");
+     * if (result.ok) {
+     *   console.log("Delegation revoked successfully");
+     * }
+     * ```
+     */
+    revoke(cid: string): Promise<Result<void>>;
+    /**
+     * Lists all delegations for the current session's space.
+     *
+     * Returns both delegations created by the current user (as delegator)
+     * and delegations granted to the current user (as delegatee).
+     *
+     * @returns Result containing an array of Delegations or an error
+     *
+     * @example
+     * ```typescript
+     * const result = await manager.list();
+     * if (result.ok) {
+     *   for (const delegation of result.data) {
+     *     console.log(`${delegation.cid}: ${delegation.path} -> ${delegation.delegateDID}`);
+     *   }
+     * }
+     * ```
+     */
+    list(): Promise<Result<Delegation[]>>;
+    /**
+     * Gets the full delegation chain for a given delegation.
+     *
+     * Returns the chain of delegations from the root (original delegator)
+     * to the specified delegation, including all intermediate sub-delegations.
+     *
+     * @param cid - The CID of the delegation to get the chain for
+     * @returns Result containing the DelegationChain or an error
+     *
+     * @example
+     * ```typescript
+     * const result = await manager.getChain("bafy...");
+     * if (result.ok) {
+     *   console.log("Chain length:", result.data.length);
+     *   for (const delegation of result.data) {
+     *     console.log(`- ${delegation.delegatorDID} -> ${delegation.delegateDID}`);
+     *   }
+     * }
+     * ```
+     */
+    getChain(cid: string): Promise<Result<DelegationChain>>;
+    /**
+     * Checks if the current session has permission for a given path and action.
+     *
+     * This can be used to verify permissions before attempting an operation,
+     * or to implement custom access control logic.
+     *
+     * @param path - The resource path to check
+     * @param action - The action to check (e.g., "tinycloud.kv/get")
+     * @returns Result containing a boolean indicating permission or an error
+     *
+     * @example
+     * ```typescript
+     * const result = await manager.checkPermission("documents/private/", "tinycloud.kv/put");
+     * if (result.ok && result.data) {
+     *   console.log("Permission granted");
+     * } else {
+     *   console.log("Permission denied");
+     * }
+     * ```
+     */
+    checkPermission(path: string, action: string): Promise<Result<boolean>>;
+}
+//# sourceMappingURL=DelegationManager.d.ts.map

package/dist/delegations/DelegationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelegationManager.d.ts","sourceRoot":"","sources":["../../src/delegations/DelegationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,MAAM,EAGN,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EAExB,MAAM,SAAS,CAAC;AA+BjB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;;OAIG;gBACS,MAAM,EAAE,uBAAuB;IAO3C;;;;OAIG;IACI,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAInD;;OAEG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;OAEG;YACW,eAAe;IAc7B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAkGzE;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAmEhD;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAoE3C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAiG7D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CAuE9E"}