@tinycloudlabs/web-sdk 0.2.0 → 1.0.0

package/dist/authorization/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Web-sdk authorization module.
+ *
+ * Provides WebUserAuthorization implementing the node-sdk architecture
+ * with browser-specific features like wallet popups and modal confirmations.
+ *
+ * @packageDocumentation
+ */
+export { WebUserAuthorization, WebUserAuthorizationConfig, WebSignStrategy, WalletPopupStrategy, defaultWebSignStrategy, } from "./WebUserAuthorization";
+export { ModalSpaceCreationHandler, defaultWebSpaceCreationHandler, } from "./WebSpaceCreationHandler";
+export { SignStrategy, SignRequest, SignResponse, SignCallback, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, EventEmitterStrategy, defaultSignStrategy, ISpaceCreationHandler, SpaceCreationContext, AutoApproveSpaceCreationHandler, defaultSpaceCreationHandler, } from "@tinycloudlabs/sdk-core";
+//# 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;;;;;;;GAOG;AAEH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC"}

package/dist/delegation.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Delegation types and utilities for web-sdk.
+ *
+ * These types are compatible with node-sdk's delegation system,
+ * allowing delegations to be exchanged between platforms.
+ */
+import { Delegation, TinyCloudSession, IKVService } from "@tinycloudlabs/sdk-core";
+/**
+ * A portable delegation that can be transported between users.
+ * Extends the base Delegation type with fields required for transport.
+ *
+ * @remarks
+ * PortableDelegation adds transport fields to Delegation:
+ * - `delegationHeader`: Structured authorization header for API calls
+ * - `ownerAddress`: Space owner's address for session creation
+ * - `chainId`: Chain ID for session creation
+ * - `host`: Optional server URL
+ */
+export interface PortableDelegation extends Omit<Delegation, "isRevoked"> {
+    /** The authorization header for this delegation (structured format) */
+    delegationHeader: {
+        Authorization: string;
+    };
+    /** The address of the space owner */
+    ownerAddress: string;
+    /** The chain ID */
+    chainId: number;
+    /** TinyCloud server URL where this delegation was created */
+    host?: string;
+    /** Whether the recipient is prevented from creating sub-delegations */
+    disableSubDelegation?: boolean;
+}
+/**
+ * Serialize a PortableDelegation for transport (e.g., over network).
+ */
+export declare function serializeDelegation(delegation: PortableDelegation): string;
+/**
+ * Deserialize a PortableDelegation from transport.
+ * Handles both new format (cid) and legacy format (delegationCid).
+ */
+export declare function deserializeDelegation(data: string): PortableDelegation;
+/**
+ * Provides access to a space via a received delegation.
+ *
+ * This is returned by TinyCloudWeb.useDelegation() and provides
+ * KV operations on the delegated space.
+ *
+ * @example
+ * ```typescript
+ * // Receive a delegation from another user
+ * const delegation = deserializeDelegation(receivedData);
+ *
+ * // Use the delegation
+ * const access = await tcw.useDelegation(delegation);
+ *
+ * // Perform KV operations on the delegated space
+ * const data = await access.kv.get("shared/document.json");
+ * await access.kv.put("shared/notes.txt", "Hello!");
+ * ```
+ */
+export declare class DelegatedAccess {
+    private session;
+    private _delegation;
+    private host;
+    private _serviceContext;
+    private _kv;
+    constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string);
+    /**
+     * Get the delegation this access was created from.
+     */
+    get delegation(): PortableDelegation;
+    /**
+     * The space ID this access is for.
+     */
+    get spaceId(): string;
+    /**
+     * The path this access is scoped to.
+     */
+    get path(): string;
+    /**
+     * KV operations on the delegated space.
+     */
+    get kv(): IKVService;
+}
+//# sourceMappingURL=delegation.d.ts.map

package/dist/delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../src/delegation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAEhB,UAAU,EAIX,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC;IACvE,uEAAuE;IACvE,gBAAgB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5C,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAK1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAStE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,GAAG,CAAY;gBAGrB,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM;IA+Bd;;OAEG;IACH,IAAI,UAAU,IAAI,kBAAkB,CAEnC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,EAAE,IAAI,UAAU,CAEnB;CACF"}

package/dist/index.d.ts

@@ -1,14 +1,16 @@
-export * from './modules/tcw';
-export * from './modules';
-export * from './notifications';
+export { TinyCloudWeb, Config, ShareReceiveResult } from './modules/tcw';
+export { UserAuthorization, IUserAuthorization } from './modules/UserAuthorization';
+export { WebUserAuthorization, WebUserAuthorizationConfig, WebSignStrategy, WalletPopupStrategy, defaultWebSignStrategy, ModalSpaceCreationHandler, defaultWebSpaceCreationHandler, } from './authorization';
+export { SignStrategy, SignRequest, SignResponse, SignCallback, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, EventEmitterStrategy, defaultSignStrategy, ISpaceCreationHandler, SpaceCreationContext, AutoApproveSpaceCreationHandler, defaultSpaceCreationHandler, } from '@tinycloudlabs/sdk-core';
 export * from '@tinycloudlabs/web-core/client';
 export * from '@tinycloudlabs/web-core';
-export { 
-/** @deprecated use TCWClientConfig field instead */
-TCWClientConfig as TCWConfig, 
-/** @deprecated use TCWClientProviders field instead */
-TCWClientProviders as TCWProviders, 
-/** @deprecated use TCWClientSession field instead */
-TCWClientSession as TCWSession, } from '@tinycloudlabs/web-core/client';
 export { SiweMessage } from 'siwe';
+export { TinyCloud, ISigner, ISessionStorage, IUserAuthorization as ICoreUserAuthorization, PersistedSessionData, SiweConfig, PartialSiweMessage, } from '@tinycloudlabs/sdk-core';
+export { IKVService, KVService, KVResponse, PrefixedKVService, IPrefixedKVService, } from '@tinycloudlabs/sdk-core';
+export { DelegationManager, DelegationManagerConfig, Delegation, CreateDelegationParams, DelegationChain, DelegationApiResponse, DelegationResult, DelegationError, DelegationErrorCodes, DelegationErrorCode, SharingService, createSharingService, ISharingService, SharingServiceConfig, EncodedShareData, ReceiveOptions, ShareAccess, JWK, KeyType, KeyInfo, CapabilityEntry, DelegationRecord, DelegationChainV2, DelegationDirection, DelegationFilters, SpaceOwnership, SpaceInfo, ShareSchema, ShareLink, ShareLinkData, IngestOptions, GenerateShareParams, } from '@tinycloudlabs/sdk-core';
+export { CapabilityKeyRegistry, ICapabilityKeyRegistry, createCapabilityKeyRegistry, StoredDelegationChain, CapabilityKeyRegistryErrorCodes, CapabilityKeyRegistryErrorCode, } from '@tinycloudlabs/sdk-core';
+export { SpaceService, ISpaceService, SpaceServiceConfig, SpaceErrorCodes, SpaceErrorCode, createSpaceService, parseSpaceUri, buildSpaceUri, Space, ISpace, SpaceConfig, ISpaceScopedDelegations, ISpaceScopedSharing, } from '@tinycloudlabs/sdk-core';
+export { ProtocolMismatchError, VersionCheckError, checkNodeVersion, } from '@tinycloudlabs/sdk-core';
+export { createKVService } from './modules/Storage/tinycloud/KVServiceAdapter';
+export { PortableDelegation, DelegatedAccess, serializeDelegation, deserializeDelegation, } from './delegation';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,OAAO;AACL,oDAAoD;AACpD,eAAe,IAAI,SAAS;AAC5B,uDAAuD;AACvD,kBAAkB,IAAI,YAAY;AAClC,qDAAqD;AACrD,gBAAgB,IAAI,UAAU,GAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKpF,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAKjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,EACL,SAAS,EACT,OAAO,EACP,eAAe,EACf,kBAAkB,IAAI,sBAAsB,EAC5C,oBAAoB,EACpB,UAAU,EACV,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAEL,iBAAiB,EACjB,uBAAuB,EAEvB,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EAEnB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,WAAW,EAEX,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,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,EAEb,KAAK,EACL,MAAM,EACN,WAAW,EACX,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAQ/E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}