@tinycloudlabs/sdk-core 1.0.0

package/dist/delegations/SharingService.schema.d.ts

@@ -0,0 +1,401 @@
+/**
+ * Zod schemas for SharingService types.
+ *
+ * These schemas provide runtime validation for sharing link data,
+ * receive options, and service configuration.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+import type { FetchFunction, IKVService, InvokeFunction, ServiceSession } from "@tinycloudlabs/sdk-services";
+import { type Result, type DelegationError } from "./types.schema.js";
+import type { ICapabilityKeyRegistry } from "../authorization/CapabilityKeyRegistry.js";
+import type { DelegationManager } from "./DelegationManager.js";
+/**
+ * Schema for data encoded in a sharing link.
+ *
+ * This is the primary validation point for external share link data.
+ * The link is base64-decoded and JSON-parsed, then validated against this schema.
+ */
+export declare const EncodedShareDataSchema: z.ZodObject<{
+    /** Private key in JWK format (must include d parameter) */
+    key: z.ZodEffects<z.ZodObject<{
+        kty: z.ZodString;
+        crv: z.ZodOptional<z.ZodString>;
+        x: z.ZodOptional<z.ZodString>;
+        y: z.ZodOptional<z.ZodString>;
+        d: z.ZodOptional<z.ZodString>;
+        e: z.ZodOptional<z.ZodString>;
+        n: z.ZodOptional<z.ZodString>;
+        kid: z.ZodOptional<z.ZodString>;
+        alg: z.ZodOptional<z.ZodString>;
+        use: z.ZodOptional<z.ZodString>;
+        key_ops: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kty: string;
+        crv?: string | undefined;
+        x?: string | undefined;
+        y?: string | undefined;
+        d?: string | undefined;
+        e?: string | undefined;
+        n?: string | undefined;
+        kid?: string | undefined;
+        alg?: string | undefined;
+        use?: string | undefined;
+        key_ops?: string[] | undefined;
+    }, {
+        kty: string;
+        crv?: string | undefined;
+        x?: string | undefined;
+        y?: string | undefined;
+        d?: string | undefined;
+        e?: string | undefined;
+        n?: string | undefined;
+        kid?: string | undefined;
+        alg?: string | undefined;
+        use?: string | undefined;
+        key_ops?: string[] | undefined;
+    }>, {
+        kty: string;
+        crv?: string | undefined;
+        x?: string | undefined;
+        y?: string | undefined;
+        d?: string | undefined;
+        e?: string | undefined;
+        n?: string | undefined;
+        kid?: string | undefined;
+        alg?: string | undefined;
+        use?: string | undefined;
+        key_ops?: string[] | undefined;
+    }, {
+        kty: string;
+        crv?: string | undefined;
+        x?: string | undefined;
+        y?: string | undefined;
+        d?: string | undefined;
+        e?: string | undefined;
+        n?: string | undefined;
+        kid?: string | undefined;
+        alg?: string | undefined;
+        use?: string | undefined;
+        key_ops?: string[] | undefined;
+    }>;
+    /** DID of the key */
+    keyDid: z.ZodString;
+    /** The delegation granting access */
+    delegation: z.ZodObject<{
+        cid: z.ZodString;
+        delegateDID: z.ZodString;
+        spaceId: z.ZodString;
+        path: z.ZodString;
+        actions: z.ZodArray<z.ZodString, "many">;
+        expiry: z.ZodDate;
+        isRevoked: z.ZodBoolean;
+        delegatorDID: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodDate>;
+        parentCid: z.ZodOptional<z.ZodString>;
+        allowSubDelegation: z.ZodOptional<z.ZodBoolean>;
+        authHeader: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        cid: string;
+        delegateDID: string;
+        spaceId: string;
+        actions: string[];
+        expiry: Date;
+        isRevoked: boolean;
+        delegatorDID?: string | undefined;
+        createdAt?: Date | undefined;
+        parentCid?: string | undefined;
+        allowSubDelegation?: boolean | undefined;
+        authHeader?: string | undefined;
+    }, {
+        path: string;
+        cid: string;
+        delegateDID: string;
+        spaceId: string;
+        actions: string[];
+        expiry: Date;
+        isRevoked: boolean;
+        delegatorDID?: string | undefined;
+        createdAt?: Date | undefined;
+        parentCid?: string | undefined;
+        allowSubDelegation?: boolean | undefined;
+        authHeader?: string | undefined;
+    }>;
+    /** Resource path this link grants access to */
+    path: z.ZodString;
+    /** TinyCloud host URL */
+    host: z.ZodString;
+    /** Space ID */
+    spaceId: z.ZodString;
+    /** Schema version (must be 1) */
+    version: z.ZodLiteral<1>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    delegation: {
+        path: string;
+        cid: string;
+        delegateDID: string;
+        spaceId: string;
+        actions: string[];
+        expiry: Date;
+        isRevoked: boolean;
+        delegatorDID?: string | undefined;
+        createdAt?: Date | undefined;
+        parentCid?: string | undefined;
+        allowSubDelegation?: boolean | undefined;
+        authHeader?: string | undefined;
+    };
+    spaceId: string;
+    version: 1;
+    key: {
+        kty: string;
+        crv?: string | undefined;
+        x?: string | undefined;
+        y?: string | undefined;
+        d?: string | undefined;
+        e?: string | undefined;
+        n?: string | undefined;
+        kid?: string | undefined;
+        alg?: string | undefined;
+        use?: string | undefined;
+        key_ops?: string[] | undefined;
+    };
+    keyDid: string;
+    host: string;
+}, {
+    path: string;
+    delegation: {
+        path: string;
+        cid: string;
+        delegateDID: string;
+        spaceId: string;
+        actions: string[];
+        expiry: Date;
+        isRevoked: boolean;
+        delegatorDID?: string | undefined;
+        createdAt?: Date | undefined;
+        parentCid?: string | undefined;
+        allowSubDelegation?: boolean | undefined;
+        authHeader?: string | undefined;
+    };
+    spaceId: string;
+    version: 1;
+    key: {
+        kty: string;
+        crv?: string | undefined;
+        x?: string | undefined;
+        y?: string | undefined;
+        d?: string | undefined;
+        e?: string | undefined;
+        n?: string | undefined;
+        kid?: string | undefined;
+        alg?: string | undefined;
+        use?: string | undefined;
+        key_ops?: string[] | undefined;
+    };
+    keyDid: string;
+    host: string;
+}>;
+export type EncodedShareData = z.infer<typeof EncodedShareDataSchema>;
+/**
+ * Schema for options when receiving a sharing link.
+ */
+export declare const ReceiveOptionsSchema: z.ZodObject<{
+    /**
+     * Whether to automatically create a sub-delegation to the current session key.
+     * Default: true
+     */
+    autoSubdelegate: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether to use the current session key for operations (requires autoSubdelegate).
+     * Default: true
+     */
+    useSessionKey: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Ingestion options passed to CapabilityKeyRegistry.
+     */
+    ingestOptions: z.ZodOptional<z.ZodObject<{
+        persist: z.ZodOptional<z.ZodBoolean>;
+        validateChain: z.ZodOptional<z.ZodBoolean>;
+        keyName: z.ZodOptional<z.ZodString>;
+        createSessionKey: z.ZodOptional<z.ZodBoolean>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        priority?: number | undefined;
+        persist?: boolean | undefined;
+        validateChain?: boolean | undefined;
+        keyName?: string | undefined;
+        createSessionKey?: boolean | undefined;
+    }, {
+        priority?: number | undefined;
+        persist?: boolean | undefined;
+        validateChain?: boolean | undefined;
+        keyName?: string | undefined;
+        createSessionKey?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    autoSubdelegate?: boolean | undefined;
+    useSessionKey?: boolean | undefined;
+    ingestOptions?: {
+        priority?: number | undefined;
+        persist?: boolean | undefined;
+        validateChain?: boolean | undefined;
+        keyName?: string | undefined;
+        createSessionKey?: boolean | undefined;
+    } | undefined;
+}, {
+    autoSubdelegate?: boolean | undefined;
+    useSessionKey?: boolean | undefined;
+    ingestOptions?: {
+        priority?: number | undefined;
+        persist?: boolean | undefined;
+        validateChain?: boolean | undefined;
+        keyName?: string | undefined;
+        createSessionKey?: boolean | undefined;
+    } | undefined;
+}>;
+export type ReceiveOptions = z.infer<typeof ReceiveOptionsSchema>;
+/**
+ * Schema for SharingService configuration.
+ *
+ * Note: Function fields use z.function() for shape validation only.
+ * External types (ServiceSession, DelegationManager, ICapabilityKeyRegistry)
+ * use z.unknown() with runtime type refinement.
+ */
+export declare const SharingServiceConfigSchema: z.ZodObject<{
+    /** TinyCloud host URLs */
+    hosts: z.ZodArray<z.ZodString, "many">;
+    /**
+     * Active session for authentication.
+     * Required for generate(), optional for receive().
+     */
+    session: z.ZodOptional<z.ZodEffects<z.ZodUnknown, ServiceSession, unknown>>;
+    /** Platform-specific invoke function */
+    invoke: z.ZodEffects<z.ZodUnknown, InvokeFunction, unknown>;
+    /** Optional custom fetch implementation */
+    fetch: z.ZodOptional<z.ZodEffects<z.ZodUnknown, FetchFunction, unknown>>;
+    /** Key provider for cryptographic operations */
+    keyProvider: z.ZodObject<{
+        createSessionKey: z.ZodEffects<z.ZodUnknown, (name: string) => Promise<string>, unknown>;
+        getJWK: z.ZodEffects<z.ZodUnknown, (keyId: string) => object, unknown>;
+        getDID: z.ZodEffects<z.ZodUnknown, (keyId: string) => Promise<string>, unknown>;
+    }, "strip", z.ZodTypeAny, {
+        createSessionKey: (name: string) => Promise<string>;
+        getJWK: (keyId: string) => object;
+        getDID: (keyId: string) => Promise<string>;
+    }, {
+        createSessionKey?: unknown;
+        getJWK?: unknown;
+        getDID?: unknown;
+    }>;
+    /** Capability key registry for key/delegation management */
+    registry: z.ZodEffects<z.ZodUnknown, ICapabilityKeyRegistry, unknown>;
+    /**
+     * Delegation manager for creating delegations.
+     * Required for generate(), optional for receive().
+     */
+    delegationManager: z.ZodOptional<z.ZodEffects<z.ZodUnknown, DelegationManager, unknown>>;
+    /** Factory for creating KV service instances */
+    createKVService: z.ZodEffects<z.ZodUnknown, (config: {
+        hosts: string[];
+        session: ServiceSession;
+        invoke: InvokeFunction;
+        fetch?: FetchFunction;
+        pathPrefix?: string;
+    }) => IKVService, unknown>;
+    /** Base URL for sharing links (e.g., "https://share.myapp.com") */
+    baseUrl: z.ZodOptional<z.ZodString>;
+    /**
+     * Custom delegation creation function.
+     */
+    createDelegation: z.ZodOptional<z.ZodEffects<z.ZodUnknown, Function | undefined, unknown>>;
+    /**
+     * WASM function for client-side delegation creation.
+     */
+    createDelegationWasm: z.ZodOptional<z.ZodEffects<z.ZodUnknown, Function | undefined, unknown>>;
+    /**
+     * Path prefix for KV operations.
+     */
+    pathPrefix: z.ZodOptional<z.ZodString>;
+    /**
+     * Session expiry time.
+     */
+    sessionExpiry: z.ZodOptional<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    hosts: string[];
+    invoke: InvokeFunction;
+    keyProvider: {
+        createSessionKey: (name: string) => Promise<string>;
+        getJWK: (keyId: string) => object;
+        getDID: (keyId: string) => Promise<string>;
+    };
+    registry: ICapabilityKeyRegistry;
+    createKVService: (config: {
+        hosts: string[];
+        session: ServiceSession;
+        invoke: InvokeFunction;
+        fetch?: FetchFunction;
+        pathPrefix?: string;
+    }) => IKVService;
+    session?: ServiceSession | undefined;
+    baseUrl?: string | undefined;
+    fetch?: FetchFunction | undefined;
+    delegationManager?: DelegationManager | undefined;
+    createDelegation?: Function | undefined;
+    createDelegationWasm?: Function | undefined;
+    pathPrefix?: string | undefined;
+    sessionExpiry?: Date | undefined;
+}, {
+    hosts: string[];
+    keyProvider: {
+        createSessionKey?: unknown;
+        getJWK?: unknown;
+        getDID?: unknown;
+    };
+    session?: unknown;
+    baseUrl?: string | undefined;
+    invoke?: unknown;
+    fetch?: unknown;
+    registry?: unknown;
+    delegationManager?: unknown;
+    createKVService?: unknown;
+    createDelegation?: unknown;
+    createDelegationWasm?: unknown;
+    pathPrefix?: string | undefined;
+    sessionExpiry?: Date | undefined;
+}>;
+export type SharingServiceConfig = z.infer<typeof SharingServiceConfigSchema>;
+/**
+ * Validates encoded share data from a decoded link.
+ *
+ * @param data - Unknown data to validate (from JSON.parse)
+ * @returns Result with validated data or validation error
+ *
+ * @example
+ * ```typescript
+ * const parsed = JSON.parse(base64UrlDecode(linkData));
+ * const result = validateEncodedShareData(parsed);
+ * if (!result.ok) {
+ *   return result; // Forward the error
+ * }
+ * const shareData = result.data;
+ * ```
+ */
+export declare function validateEncodedShareData(data: unknown): Result<EncodedShareData, DelegationError>;
+/**
+ * Validates receive options.
+ *
+ * @param data - Unknown data to validate
+ * @returns Result with validated data or validation error
+ */
+export declare function validateReceiveOptions(data: unknown): Result<ReceiveOptions, DelegationError>;
+/**
+ * Validates SharingService configuration.
+ *
+ * @param data - Unknown data to validate
+ * @returns Result with validated data or validation error
+ */
+export declare function validateSharingServiceConfig(data: unknown): Result<SharingServiceConfig, DelegationError>;
+//# sourceMappingURL=SharingService.schema.d.ts.map

package/dist/delegations/SharingService.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharingService.schema.d.ts","sourceRoot":"","sources":["../../src/delegations/SharingService.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,cAAc,EACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IACjC,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK3D,qBAAqB;;IAErB,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAErC,+CAA+C;;IAE/C,yBAAyB;;IAEzB,eAAe;;IAEf,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;IAEH;;;OAGG;;IAEH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;IACrC,0BAA0B;;IAE1B;;;OAGG;;IASH,wCAAwC;;IAMxC,2CAA2C;;IAS3C,gDAAgD;;;;;;;;;;;;;;IAEhD,4DAA4D;;IAQ5D;;;OAGG;;IASH,gDAAgD;yDAEvB;QACrB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,cAAc,CAAC;QACxB,MAAM,EAAE,cAAc,CAAC;QACvB,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,UAAU;IAGlB,mEAAmE;;IAEnE;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAEH;;OAEG;;;;;;;;;;;8BAnCsB;QACrB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,cAAc,CAAC;QACxB,MAAM,EAAE,cAAc,CAAC;QACvB,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BlB,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAc3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAczC;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAc/C"}

package/dist/delegations/SharingService.schema.js

@@ -0,0 +1,211 @@
+/**
+ * Zod schemas for SharingService types.
+ *
+ * These schemas provide runtime validation for sharing link data,
+ * receive options, and service configuration.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+import { JWKSchema, DelegationSchema, KeyProviderSchema, IngestOptionsSchema, DelegationErrorCodes, } from "./types.schema.js";
+// =============================================================================
+// EncodedShareData Schema
+// =============================================================================
+/**
+ * Schema for data encoded in a sharing link.
+ *
+ * This is the primary validation point for external share link data.
+ * The link is base64-decoded and JSON-parsed, then validated against this schema.
+ */
+export const EncodedShareDataSchema = z.object({
+    /** Private key in JWK format (must include d parameter) */
+    key: JWKSchema.refine((jwk) => typeof jwk.d === "string" && jwk.d.length > 0, { message: "JWK must include private key (d parameter)" }),
+    /** DID of the key */
+    keyDid: z.string().min(1, "keyDid is required"),
+    /** The delegation granting access */
+    delegation: DelegationSchema,
+    /** Resource path this link grants access to */
+    path: z.string().min(1, "path is required"),
+    /** TinyCloud host URL */
+    host: z.string().url("host must be a valid URL"),
+    /** Space ID */
+    spaceId: z.string().min(1, "spaceId is required"),
+    /** Schema version (must be 1) */
+    version: z.literal(1),
+});
+// =============================================================================
+// ReceiveOptions Schema
+// =============================================================================
+/**
+ * Schema for options when receiving a sharing link.
+ */
+export const ReceiveOptionsSchema = z.object({
+    /**
+     * Whether to automatically create a sub-delegation to the current session key.
+     * Default: true
+     */
+    autoSubdelegate: z.boolean().optional(),
+    /**
+     * Whether to use the current session key for operations (requires autoSubdelegate).
+     * Default: true
+     */
+    useSessionKey: z.boolean().optional(),
+    /**
+     * Ingestion options passed to CapabilityKeyRegistry.
+     */
+    ingestOptions: IngestOptionsSchema.optional(),
+});
+// =============================================================================
+// SharingServiceConfig Schema
+// =============================================================================
+/**
+ * Schema for SharingService configuration.
+ *
+ * Note: Function fields use z.function() for shape validation only.
+ * External types (ServiceSession, DelegationManager, ICapabilityKeyRegistry)
+ * use z.unknown() with runtime type refinement.
+ */
+export const SharingServiceConfigSchema = z.object({
+    /** TinyCloud host URLs */
+    hosts: z.array(z.string().url()).min(1, "At least one host URL is required"),
+    /**
+     * Active session for authentication.
+     * Required for generate(), optional for receive().
+     */
+    session: z
+        .unknown()
+        .refine((val) => val === undefined || (val !== null && typeof val === "object"), { message: "Expected a ServiceSession object or undefined" })
+        .optional(),
+    /** Platform-specific invoke function */
+    invoke: z
+        .unknown()
+        .refine((val) => typeof val === "function", {
+        message: "Expected an invoke function",
+    }),
+    /** Optional custom fetch implementation */
+    fetch: z
+        .unknown()
+        .refine((val) => val === undefined || typeof val === "function", { message: "Expected a fetch function or undefined" })
+        .optional(),
+    /** Key provider for cryptographic operations */
+    keyProvider: KeyProviderSchema,
+    /** Capability key registry for key/delegation management */
+    registry: z
+        .unknown()
+        .refine((val) => val !== null && typeof val === "object", { message: "Expected an ICapabilityKeyRegistry object" }),
+    /**
+     * Delegation manager for creating delegations.
+     * Required for generate(), optional for receive().
+     */
+    delegationManager: z
+        .unknown()
+        .refine((val) => val === undefined || (val !== null && typeof val === "object"), { message: "Expected a DelegationManager object or undefined" })
+        .optional(),
+    /** Factory for creating KV service instances */
+    createKVService: z.unknown().refine((val) => typeof val === "function", { message: "Expected a createKVService factory function" }),
+    /** Base URL for sharing links (e.g., "https://share.myapp.com") */
+    baseUrl: z.string().optional(),
+    /**
+     * Custom delegation creation function.
+     */
+    createDelegation: z
+        .unknown()
+        .refine((val) => val === undefined || typeof val === "function", {
+        message: "Expected a createDelegation function or undefined",
+    })
+        .optional(),
+    /**
+     * WASM function for client-side delegation creation.
+     */
+    createDelegationWasm: z
+        .unknown()
+        .refine((val) => val === undefined || typeof val === "function", {
+        message: "Expected a createDelegationWasm function or undefined",
+    })
+        .optional(),
+    /**
+     * Path prefix for KV operations.
+     */
+    pathPrefix: z.string().optional(),
+    /**
+     * Session expiry time.
+     */
+    sessionExpiry: z.date().optional(),
+});
+// =============================================================================
+// Validation Helpers
+// =============================================================================
+/**
+ * Validates encoded share data from a decoded link.
+ *
+ * @param data - Unknown data to validate (from JSON.parse)
+ * @returns Result with validated data or validation error
+ *
+ * @example
+ * ```typescript
+ * const parsed = JSON.parse(base64UrlDecode(linkData));
+ * const result = validateEncodedShareData(parsed);
+ * if (!result.ok) {
+ *   return result; // Forward the error
+ * }
+ * const shareData = result.data;
+ * ```
+ */
+export function validateEncodedShareData(data) {
+    const result = EncodedShareDataSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: DelegationErrorCodes.VALIDATION_ERROR,
+                message: `Invalid share data: ${result.error.message}`,
+                service: "delegation",
+                meta: { issues: result.error.issues },
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+/**
+ * Validates receive options.
+ *
+ * @param data - Unknown data to validate
+ * @returns Result with validated data or validation error
+ */
+export function validateReceiveOptions(data) {
+    const result = ReceiveOptionsSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: DelegationErrorCodes.VALIDATION_ERROR,
+                message: `Invalid receive options: ${result.error.message}`,
+                service: "delegation",
+                meta: { issues: result.error.issues },
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+/**
+ * Validates SharingService configuration.
+ *
+ * @param data - Unknown data to validate
+ * @returns Result with validated data or validation error
+ */
+export function validateSharingServiceConfig(data) {
+    const result = SharingServiceConfigSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: DelegationErrorCodes.VALIDATION_ERROR,
+                message: `Invalid SharingService config: ${result.error.message}`,
+                service: "delegation",
+                meta: { issues: result.error.issues },
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=SharingService.schema.js.map

package/dist/delegations/SharingService.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharingService.schema.js","sourceRoot":"","sources":["../../src/delegations/SharingService.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAGnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAI3B,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,2DAA2D;IAC3D,GAAG,EAAE,SAAS,CAAC,MAAM,CACnB,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EACtD,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAC1D;IACD,qBAAqB;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC;IAC/C,qCAAqC;IACrC,UAAU,EAAE,gBAAgB;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC3C,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAChD,eAAe;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IACjD,iCAAiC;IACjC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACtB,CAAC,CAAC;AAIH,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C;;;OAGG;IACH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC;;OAEG;IACH,aAAa,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAIH,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,0BAA0B;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC5E;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,MAAM,CACL,CAAC,GAAG,EAAyB,EAAE,CAC7B,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,EAChE,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAC7D;SACA,QAAQ,EAAE;IACb,wCAAwC;IACxC,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,MAAM,CAAC,CAAC,GAAG,EAAyB,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,EAAE;QACjE,OAAO,EAAE,6BAA6B;KACvC,CAAC;IACJ,2CAA2C;IAC3C,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,MAAM,CACL,CAAC,GAAG,EAAwB,EAAE,CAC5B,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,UAAU,EAChD,EAAE,OAAO,EAAE,wCAAwC,EAAE,CACtD;SACA,QAAQ,EAAE;IACb,gDAAgD;IAChD,WAAW,EAAE,iBAAiB;IAC9B,4DAA4D;IAC5D,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,MAAM,CACL,CAAC,GAAG,EAAiC,EAAE,CACrC,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EACzC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CACzD;IACH;;;OAGG;IACH,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,MAAM,CACL,CAAC,GAAG,EAA4B,EAAE,CAChC,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,EAChE,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAChE;SACA,QAAQ,EAAE;IACb,gDAAgD;IAChD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CACjC,CAAC,GAAG,EAMa,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,EAC7C,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAC3D;IACD,mEAAmE;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B;;OAEG;IACH,gBAAgB,EAAE,CAAC;SAChB,OAAO,EAAE;SACT,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;QAC/D,OAAO,EAAE,mDAAmD;KAC7D,CAAC;SACD,QAAQ,EAAE;IACb;;OAEG;IACH,oBAAoB,EAAE,CAAC;SACpB,OAAO,EAAE;SACT,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;QAC/D,OAAO,EAAE,uDAAuD;KACjE,CAAC;SACD,QAAQ,EAAE;IACb;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC;;OAEG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAa;IAEb,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,oBAAoB,CAAC,gBAAgB;gBAC3C,OAAO,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;gBACtD,OAAO,EAAE,YAAY;gBACrB,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;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAa;IAEb,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,oBAAoB,CAAC,gBAAgB;gBAC3C,OAAO,EAAE,4BAA4B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;gBAC3D,OAAO,EAAE,YAAY;gBACrB,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;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAa;IAEb,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,oBAAoB,CAAC,gBAAgB;gBAC3C,OAAO,EAAE,kCAAkC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;gBACjE,OAAO,EAAE,YAAY;gBACrB,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/delegations/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * TinyCloud SDK Delegations Module
+ *
+ * This module provides delegation and sharing link functionality
+ * for the TinyCloud SDK. It extracts and improves upon the delegation
+ * functionality previously in ITinyCloudStorage.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   DelegationManager,
+ *   SharingService,
+ *   Delegation,
+ *   CreateDelegationParams,
+ * } from "@tinycloudlabs/sdk-core/delegations";
+ *
+ * // Create delegation manager
+ * 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"],
+ * });
+ * ```
+ */
+export { Result, DelegationError, DelegationErrorCodes, DelegationErrorCode, Delegation, CreateDelegationParams, DelegationChain, DelegationApiResponse, DelegationManagerConfig, KeyProvider, JWK, KeyType, KeyInfo, CapabilityEntry, DelegationRecord, DelegationChainV2, DelegationDirection, DelegationFilters, SpaceOwnership, SpaceInfo, ShareSchema, ShareLink, ShareLinkData, IngestOptions, GenerateShareParams, CreateDelegationWasmParams, CreateDelegationWasmResult, } from "./types";
+export { DelegationManager } from "./DelegationManager";
+export { SharingService, createSharingService, ISharingService, SharingServiceConfig, EncodedShareData, ReceiveOptions, ShareAccess, } from "./SharingService";
+export { EncodedShareDataSchema, ReceiveOptionsSchema, SharingServiceConfigSchema, validateEncodedShareData, validateReceiveOptions, validateSharingServiceConfig, } from "./SharingService.schema.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delegations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAEL,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EAGnB,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EAGrB,uBAAuB,EACvB,WAAW,EAGX,GAAG,EACH,OAAO,EACP,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,mBAAmB,EAGnB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}