@tinycloud/sdk-core 2.0.1 → 2.0.2-beta.0

package/package.json

@@ -1,36 +1,37 @@
 {
   "name": "@tinycloud/sdk-core",
-  "version": "2.0.1",
+  "version": "2.0.2-beta.0",
   "description": "Core TinyCloud SDK - shared interfaces and TinyCloud class",
   "author": "TinyCloud, Inc.",
   "license": "EGPL",
   "type": "module",
-  "main": "dist/index.js",
+  "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "require": "./dist/index.cjs"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
     "clean": "rm -rf dist",
     "test": "bun test"
   },
   "dependencies": {
-    "@tinycloud/sdk-services": "^2.0.1",
+    "@tinycloud/sdk-services": "workspace:*",
     "siwe": "^2.3.2",
     "zod": "^3.22.0",
     "zod-to-json-schema": "^3.22.0"
   },
   "devDependencies": {
     "@types/node": "^20",
+    "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },
   "repository": {

package/dist/TinyCloud.d.ts

@@ -1,271 +0,0 @@
-import { IUserAuthorization, ClientSession, Extension } from "./userAuthorization";
-import { IService, IServiceContext, IKVService, ISQLService, IDuckDbService, IDataVaultService, InvokeFunction, FetchFunction, RetryPolicy, ServiceConstructor, Result, ServiceError } from "@tinycloud/sdk-services";
-/**
- * Configuration for the TinyCloud SDK.
- */
-export interface TinyCloudConfig {
-    /** Whether to automatically resolve ENS names */
-    resolveEns?: boolean;
-    /**
-     * TinyCloud host URLs.
-     * Required when using services.
-     */
-    hosts?: string[];
-    /**
-     * Platform-specific invoke function from WASM binding.
-     * Required when using services.
-     */
-    invoke?: InvokeFunction;
-    /**
-     * Custom fetch implementation.
-     * Defaults to globalThis.fetch.
-     */
-    fetch?: FetchFunction;
-    /**
-     * Service constructors to register.
-     * Built-in services (like KVService) are registered by default unless overridden.
-     *
-     * @example
-     * ```typescript
-     * services: {
-     *   kv: KVService,  // default
-     *   files: MyFileService,  // custom
-     * }
-     * ```
-     */
-    services?: Record<string, ServiceConstructor>;
-    /**
-     * Per-service configuration.
-     *
-     * @example
-     * ```typescript
-     * serviceConfigs: {
-     *   kv: { prefix: 'myapp' },
-     *   files: { maxSize: 10_000_000 },
-     * }
-     * ```
-     */
-    serviceConfigs?: Record<string, Record<string, unknown>>;
-    /**
-     * Retry policy for service operations.
-     */
-    retryPolicy?: Partial<RetryPolicy>;
-}
-/**
- * TinyCloud SDK - Unified entry point for web and node.
- *
- * This class provides the main SDK interface. Platform-specific behavior
- * is injected through the IUserAuthorization implementation:
- * - WebUserAuthorization for browser environments
- * - NodeUserAuthorization for Node.js environments
- *
- * @example
- * ```typescript
- * // Web usage
- * import { TinyCloud } from '@tinycloud/sdk-core';
- * import { WebUserAuthorization } from '@tinycloud/web-sdk';
- *
- * const auth = new WebUserAuthorization({ ... });
- * const tc = new TinyCloud(auth);
- * await tc.signIn();
- * const result = await tc.kv.put('key', 'value');
- *
- * // Node usage
- * import { TinyCloud } from '@tinycloud/sdk-core';
- * import { NodeUserAuthorization, PrivateKeySigner } from '@tinycloud/node-sdk';
- *
- * const signer = new PrivateKeySigner(process.env.PRIVATE_KEY);
- * const auth = new NodeUserAuthorization({
- *   signStrategy: { type: 'auto-sign' },
- *   signer,
- *   domain: 'api.myapp.com'
- * });
- * const tc = new TinyCloud(auth);
- * await tc.signIn();
- * ```
- */
-export declare class TinyCloud {
-    /**
-     * User authorization handler.
-     * Provides authentication and signing capabilities.
-     */
-    readonly userAuthorization: IUserAuthorization;
-    /**
-     * SDK configuration.
-     */
-    private config;
-    /**
-     * Registered extensions.
-     */
-    private extensions;
-    /**
-     * Service context providing platform dependencies to services.
-     */
-    private _serviceContext?;
-    /**
-     * Registered services by name.
-     */
-    private _services;
-    /**
-     * Whether services have been initialized.
-     */
-    private _servicesInitialized;
-    /**
-     * Create a new TinyCloud SDK instance.
-     *
-     * @param userAuthorization - Platform-specific authorization implementation
-     * @param config - Optional SDK configuration
-     */
-    constructor(userAuthorization: IUserAuthorization, config?: TinyCloudConfig);
-    /**
-     * Initialize services with platform dependencies.
-     * Must be called before using services.
-     *
-     * @param invoke - Platform-specific invoke function from WASM binding
-     * @param hosts - TinyCloud host URLs (optional, uses config.hosts)
-     * @param fetchFn - Custom fetch implementation (optional)
-     */
-    initializeServices(invoke?: InvokeFunction, hosts?: string[], fetchFn?: FetchFunction): void;
-    /**
-     * Get the service context.
-     * @throws Error if services are not initialized
-     */
-    get serviceContext(): IServiceContext;
-    /**
-     * Get a registered service by name.
-     *
-     * @param name - Service name (e.g., 'kv')
-     * @returns The service instance or undefined
-     */
-    getService<T extends IService>(name: string): T | undefined;
-    /**
-     * Get the KV service.
-     * @throws Error if services are not initialized
-     */
-    get kv(): IKVService;
-    /**
-     * Get the SQL service.
-     * @throws Error if services are not initialized
-     */
-    get sql(): ISQLService;
-    /**
-     * Get the DuckDB service.
-     * @throws Error if services are not initialized
-     */
-    get duckdb(): IDuckDbService;
-    /**
-     * Get the Data Vault service.
-     * @throws Error if services are not initialized or vault service is not registered
-     */
-    get vault(): IDataVaultService;
-    /**
-     * Notify services of session change.
-     * Called internally after sign-in and sign-out.
-     *
-     * @param session - The new session, or null if signed out
-     */
-    private notifyServicesOfSessionChange;
-    /**
-     * Abort all pending service operations.
-     * Called internally before sign-out.
-     */
-    private abortServiceOperations;
-    /**
-     * Convert ClientSession to ServiceSession.
-     * Returns null if session lacks required fields.
-     */
-    private toServiceSession;
-    /**
-     * Add an extension to the SDK.
-     * Extensions can add capabilities and lifecycle hooks.
-     */
-    extend(extension: Extension): void;
-    /**
-     * Check if an extension is enabled.
-     * @param namespace - The extension namespace to check
-     */
-    isExtensionEnabled(namespace: string): boolean;
-    /**
-     * Get the current session, if signed in.
-     */
-    get session(): ClientSession | undefined;
-    /**
-     * Check if the user is signed in.
-     */
-    get isSignedIn(): boolean;
-    /**
-     * Sign in and create a new session.
-     * Notifies services of the new session after successful sign-in.
-     * @returns The new session
-     */
-    signIn(): Promise<ClientSession>;
-    /**
-     * Sign out and clear the current session.
-     * Aborts pending service operations and notifies services.
-     */
-    signOut(): Promise<void>;
-    /**
-     * Get the current wallet address.
-     */
-    address(): string | undefined;
-    /**
-     * Get the current chain ID.
-     */
-    chainId(): number | undefined;
-    /**
-     * Sign a message with the connected wallet.
-     * @param message - Message to sign
-     */
-    signMessage(message: string): Promise<string>;
-    /**
-     * Cached public KV service instance.
-     */
-    private _publicKV?;
-    /**
-     * Construct the deterministic public space ID for a given address and chain ID.
-     *
-     * @param address - Ethereum address (0x-prefixed)
-     * @param chainId - Chain ID (e.g., 1 for mainnet)
-     * @returns The public space ID
-     */
-    static makePublicSpaceId(address: string, chainId: number): string;
-    /**
-     * Ensure the user's public space exists.
-     * Creates it via spaces.create('public') if it doesn't.
-     * Called automatically by modules that need to publish data.
-     *
-     * Requires the user to be signed in and services to be initialized.
-     */
-    ensurePublicSpace(): Promise<Result<void, ServiceError>>;
-    /**
-     * Get a KVService scoped to the user's own public space.
-     * Writes require authentication (owner/delegate).
-     *
-     * @throws Error if not signed in or services not initialized
-     */
-    get publicKV(): IKVService;
-    /**
-     * Read from any user's public space (unauthenticated).
-     * Uses the public REST endpoint — no session needed.
-     *
-     * @param host - TinyCloud server URL (e.g., "https://node.tinycloud.xyz")
-     * @param spaceId - Full public space ID
-     * @param key - Key to read
-     * @param fetchFn - Optional custom fetch function
-     * @returns The data at the key
-     */
-    static readPublicSpace<T = unknown>(host: string, spaceId: string, key: string, fetchFn?: FetchFunction): Promise<Result<T, ServiceError>>;
-    /**
-     * Read from any user's public space by address (unauthenticated).
-     * Convenience method that constructs the space ID from address and chain ID.
-     *
-     * @param host - TinyCloud server URL
-     * @param address - Ethereum address (0x-prefixed)
-     * @param chainId - Chain ID (e.g., 1 for mainnet)
-     * @param key - Key to read
-     * @param fetchFn - Optional custom fetch function
-     * @returns The data at the key
-     */
-    static readPublicKey<T = unknown>(host: string, address: string, chainId: number, key: string, fetchFn?: FetchFunction): Promise<Result<T, ServiceError>>;
-}
-//# sourceMappingURL=TinyCloud.d.ts.map

package/dist/TinyCloud.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TinyCloud.d.ts","sourceRoot":"","sources":["../src/TinyCloud.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,QAAQ,EACR,eAAe,EACf,UAAU,EAEV,WAAW,EAEX,cAAc,EAEd,iBAAiB,EAEjB,cAAc,EACd,aAAa,EACb,WAAW,EAEX,kBAAkB,EAClB,MAAM,EAIN,YAAY,EAEb,MAAM,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;IAIrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAE9C;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzD;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,SAAgB,iBAAiB,EAAE,kBAAkB,CAAC;IAEtD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAkB;IAEhC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAmB;IAIrC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAC,CAAiB;IAEzC;;OAEG;IACH,OAAO,CAAC,SAAS,CAAoC;IAErD;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAAkB;IAE9C;;;;;OAKG;gBACS,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,eAAe;IAO3E;;;;;;;OAOG;IACI,kBAAkB,CACvB,MAAM,CAAC,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI;IA8CP;;;OAGG;IACH,IAAW,cAAc,IAAI,eAAe,CAO3C;IAED;;;;;OAKG;IACI,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlE;;;OAGG;IACH,IAAW,EAAE,IAAI,UAAU,CAY1B;IAED;;;OAGG;IACH,IAAW,GAAG,IAAI,WAAW,CAY5B;IAED;;;OAGG;IACH,IAAW,MAAM,IAAI,cAAc,CAYlC;IAED;;;OAGG;IACH,IAAW,KAAK,IAAI,iBAAiB,CAYpC;IAED;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAMrC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACI,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKzC;;;OAGG;IACI,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMrD;;OAEG;IACH,IAAW,OAAO,IAAI,aAAa,GAAG,SAAS,CAE9C;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED;;;;OAIG;IACU,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAU7C;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAarC;;OAEG;IACI,OAAO,IAAI,MAAM,GAAG,SAAS;IAIpC;;OAEG;IACI,OAAO,IAAI,MAAM,GAAG,SAAS;IAIpC;;;OAGG;IACU,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1D;;OAEG;IACH,OAAO,CAAC,SAAS,CAAC,CAAa;IAE/B;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAIlE;;;;;;OAMG;IACU,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IA+GrE;;;;;OAKG;IACH,IAAW,QAAQ,IAAI,UAAU,CAyChC;IAED;;;;;;;;;OASG;WACU,eAAe,CAAC,CAAC,GAAG,OAAO,EACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAwDnC;;;;;;;;;;OAUG;WACU,aAAa,CAAC,CAAC,GAAG,OAAO,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;CAKpC"}