@tinycloud/web-core 1.0.0

package/dist/types.schema.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * Zod schemas for TinyCloud Web Core types.
+ *
+ * These schemas provide runtime validation for RPC providers, route configuration,
+ * and ENS data. Types are derived from schemas using z.infer<>.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerRouteNamesSchema = exports.ServerRoutesSchema = exports.ServerRouteEndpointTypeSchema = exports.isServerMiddlewareConfig = exports.ServerMiddlewareConfigSchema = exports.RouteConfigSchema = exports.isCustomProvider = exports.isAnkrProvider = exports.isPocketProvider = exports.isCloudflareProvider = exports.isAlchemyProvider = exports.isInfuraProvider = exports.isEtherscanProvider = exports.RPCProviderSchema = exports.GenericProviderSchema = exports.CustomProviderSchema = exports.AnkrProviderSchema = exports.PocketProviderSchema = exports.CloudflareProviderSchema = exports.AlchemyProviderSchema = exports.InfuraProviderSchema = exports.EtherscanProviderSchema = exports.InfuraProviderProjectSettingsSchema = exports.AnkrProviderNetworks = exports.AnkrProviderNetworksSchema = exports.PocketProviderNetworks = exports.PocketProviderNetworksSchema = exports.AlchemyProviderNetworks = exports.AlchemyProviderNetworksSchema = exports.InfuraProviderNetworks = exports.InfuraProviderNetworksSchema = exports.EtherscanProviderNetworks = exports.EtherscanProviderNetworksSchema = exports.RPCProviders = exports.RPCProvidersSchema = exports.EnsDataSchema = void 0;
+exports.validateEnsData = validateEnsData;
+exports.validateRPCProvider = validateRPCProvider;
+exports.validateServerRoutes = validateServerRoutes;
+const zod_1 = require("zod");
+// =============================================================================
+// ENS Data
+// =============================================================================
+/**
+ * ENS data supported by TCW.
+ */
+exports.EnsDataSchema = zod_1.z.object({
+    /** ENS name/domain. */
+    domain: zod_1.z.string().nullable().optional(),
+    /** ENS avatar. */
+    avatarUrl: zod_1.z.string().nullable().optional(),
+});
+// =============================================================================
+// RPC Provider Enums
+// =============================================================================
+/**
+ * Enum of supported EthersJS providers.
+ */
+exports.RPCProvidersSchema = zod_1.z.enum([
+    "alchemy",
+    "ankr",
+    "cloudflare",
+    "custom",
+    "etherscan",
+    "infura",
+    "pocket",
+]);
+/**
+ * Enum values for RPCProviders (for backwards compatibility).
+ */
+exports.RPCProviders = {
+    AlchemyProvider: "alchemy",
+    AnkrProvider: "ankr",
+    CloudflareProvider: "cloudflare",
+    CustomProvider: "custom",
+    EtherscanProvider: "etherscan",
+    InfuraProvider: "infura",
+    PocketProvider: "pocket",
+};
+// =============================================================================
+// Network Enums
+// =============================================================================
+/**
+ * Enum of supported networks for Etherscan.
+ */
+exports.EtherscanProviderNetworksSchema = zod_1.z.enum([
+    "homestead",
+    "ropsten",
+    "rinkeby",
+    "goerli",
+    "kovan",
+]);
+exports.EtherscanProviderNetworks = {
+    MAINNET: "homestead",
+    ROPSTEN: "ropsten",
+    RINKEBY: "rinkeby",
+    GOERLI: "goerli",
+    KOVAN: "kovan",
+};
+/**
+ * Enum of supported networks for Infura.
+ */
+exports.InfuraProviderNetworksSchema = zod_1.z.enum([
+    "homestead",
+    "ropsten",
+    "rinkeby",
+    "goerli",
+    "kovan",
+    "matic",
+    "maticmum",
+    "optimism",
+    "optimism-kovan",
+    "arbitrum",
+    "arbitrum-rinkeby",
+]);
+exports.InfuraProviderNetworks = {
+    MAINNET: "homestead",
+    ROPSTEN: "ropsten",
+    RINKEBY: "rinkeby",
+    GOERLI: "goerli",
+    KOVAN: "kovan",
+    POLYGON: "matic",
+    POLYGON_MUMBAI: "maticmum",
+    OPTIMISM: "optimism",
+    OPTIMISM_KOVAN: "optimism-kovan",
+    ARBITRUM: "arbitrum",
+    ARBITRUM_RINKEBY: "arbitrum-rinkeby",
+};
+/**
+ * Enum of supported networks for Alchemy.
+ */
+exports.AlchemyProviderNetworksSchema = zod_1.z.enum([
+    "homestead",
+    "ropsten",
+    "rinkeby",
+    "goerli",
+    "kovan",
+    "matic",
+    "maticmum",
+    "optimism",
+    "optimism-kovan",
+    "arbitrum",
+    "arbitrum-rinkeby",
+]);
+exports.AlchemyProviderNetworks = {
+    MAINNET: "homestead",
+    ROPSTEN: "ropsten",
+    RINKEBY: "rinkeby",
+    GOERLI: "goerli",
+    KOVAN: "kovan",
+    POLYGON: "matic",
+    POLYGON_MUMBAI: "maticmum",
+    OPTIMISM: "optimism",
+    OPTIMISM_KOVAN: "optimism-kovan",
+    ARBITRUM: "arbitrum",
+    ARBITRUM_RINKEBY: "arbitrum-rinkeby",
+};
+/**
+ * Enum of supported networks for Pocket.
+ */
+exports.PocketProviderNetworksSchema = zod_1.z.enum([
+    "homestead",
+    "ropsten",
+    "rinkeby",
+    "goerli",
+]);
+exports.PocketProviderNetworks = {
+    MAINNET: "homestead",
+    ROPSTEN: "ropsten",
+    RINKEBY: "rinkeby",
+    GOERLI: "goerli",
+};
+/**
+ * Enum of supported networks for Ankr.
+ */
+exports.AnkrProviderNetworksSchema = zod_1.z.enum([
+    "homestead",
+    "matic",
+    "arbitrum",
+]);
+exports.AnkrProviderNetworks = {
+    MAINNET: "homestead",
+    POLYGON: "matic",
+    ARBITRUM: "arbitrum",
+};
+// =============================================================================
+// Provider Types
+// =============================================================================
+/**
+ * Infura provider project settings.
+ */
+exports.InfuraProviderProjectSettingsSchema = zod_1.z.object({
+    projectId: zod_1.z.string(),
+    projectSecret: zod_1.z.string(),
+});
+/**
+ * Etherscan provider settings.
+ */
+exports.EtherscanProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("etherscan"),
+    apiKey: zod_1.z.string().optional(),
+    network: exports.EtherscanProviderNetworksSchema.optional(),
+});
+/**
+ * Infura provider settings.
+ */
+exports.InfuraProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("infura"),
+    apiKey: zod_1.z.union([zod_1.z.string(), exports.InfuraProviderProjectSettingsSchema]),
+    network: exports.InfuraProviderNetworksSchema.optional(),
+});
+/**
+ * Alchemy provider settings.
+ */
+exports.AlchemyProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("alchemy"),
+    apiKey: zod_1.z.string().optional(),
+    network: exports.AlchemyProviderNetworksSchema.optional(),
+});
+/**
+ * Cloudflare provider settings.
+ */
+exports.CloudflareProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("cloudflare"),
+});
+/**
+ * Pocket provider settings.
+ */
+exports.PocketProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("pocket"),
+    apiKey: zod_1.z.string().optional(),
+    network: exports.PocketProviderNetworksSchema.optional(),
+});
+/**
+ * Ankr provider settings.
+ */
+exports.AnkrProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("ankr"),
+    apiKey: zod_1.z.string().optional(),
+    network: exports.AnkrProviderNetworksSchema.optional(),
+});
+/**
+ * Custom provider settings.
+ * Note: url and network are ethers types, validated as unknown.
+ */
+exports.CustomProviderSchema = zod_1.z.object({
+    service: zod_1.z.literal("custom"),
+    url: zod_1.z.unknown().optional(),
+    network: zod_1.z.unknown().optional(),
+});
+/**
+ * Generic provider settings.
+ * Note: url and network are ethers types, validated as unknown.
+ */
+exports.GenericProviderSchema = zod_1.z.object({
+    service: exports.RPCProvidersSchema,
+    url: zod_1.z.unknown().optional(),
+    network: zod_1.z.unknown().optional(),
+    apiKey: zod_1.z.union([zod_1.z.string(), exports.InfuraProviderProjectSettingsSchema]).optional(),
+});
+/**
+ * Supported provider types (discriminated union).
+ */
+exports.RPCProviderSchema = zod_1.z.discriminatedUnion("service", [
+    exports.EtherscanProviderSchema,
+    exports.InfuraProviderSchema,
+    exports.AlchemyProviderSchema,
+    exports.CloudflareProviderSchema,
+    exports.PocketProviderSchema,
+    exports.AnkrProviderSchema,
+    exports.CustomProviderSchema,
+]);
+// =============================================================================
+// Type Guards (for backwards compatibility)
+// =============================================================================
+const isEtherscanProvider = (provider) => provider.service === "etherscan";
+exports.isEtherscanProvider = isEtherscanProvider;
+const isInfuraProvider = (provider) => provider.service === "infura";
+exports.isInfuraProvider = isInfuraProvider;
+const isAlchemyProvider = (provider) => provider.service === "alchemy";
+exports.isAlchemyProvider = isAlchemyProvider;
+const isCloudflareProvider = (provider) => provider.service === "cloudflare";
+exports.isCloudflareProvider = isCloudflareProvider;
+const isPocketProvider = (provider) => provider.service === "pocket";
+exports.isPocketProvider = isPocketProvider;
+const isAnkrProvider = (provider) => provider.service === "ankr";
+exports.isAnkrProvider = isAnkrProvider;
+const isCustomProvider = (provider) => provider.service === "custom";
+exports.isCustomProvider = isCustomProvider;
+// =============================================================================
+// Route Configuration Types
+// =============================================================================
+/**
+ * TCW Route Configuration.
+ * This configuration is used to override the default endpoint paths.
+ */
+exports.RouteConfigSchema = zod_1.z.object({
+    /** Endpoint path. */
+    url: zod_1.z.string().optional(),
+    /** Endpoint request method. */
+    method: zod_1.z.enum(["get", "post", "put", "delete"]).optional(),
+    /** Custom Operation - Replace the tcw function called with a function of your own. */
+    customAPIOperation: zod_1.z.function().optional(),
+});
+/**
+ * Server middleware configuration.
+ */
+exports.ServerMiddlewareConfigSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    callback: zod_1.z.function().optional(),
+});
+/**
+ * Type-Guard for ServerMiddlewareConfig.
+ */
+const isServerMiddlewareConfig = (config) => typeof config === "object" &&
+    config !== null &&
+    "path" in config &&
+    typeof config.path === "string";
+exports.isServerMiddlewareConfig = isServerMiddlewareConfig;
+/**
+ * Server route endpoint type (union).
+ */
+exports.ServerRouteEndpointTypeSchema = zod_1.z.union([
+    exports.RouteConfigSchema.partial(),
+    zod_1.z.unknown(), // AxiosRequestConfig
+    zod_1.z.string(),
+    exports.ServerMiddlewareConfigSchema,
+]);
+/**
+ * Server endpoints configuration.
+ */
+exports.ServerRoutesSchema = zod_1.z.object({
+    /** Get nonce endpoint path. /tcw-nonce as default. */
+    nonce: exports.ServerRouteEndpointTypeSchema.optional(),
+    /** Post login endpoint path. /tcw-login as default. */
+    login: exports.ServerRouteEndpointTypeSchema.optional(),
+    /** Post logout endpoint path. /tcw-logout as default. */
+    logout: exports.ServerRouteEndpointTypeSchema.optional(),
+});
+/**
+ * Server endpoints name configuration.
+ */
+exports.ServerRouteNamesSchema = zod_1.z.object({
+    /** Get nonce endpoint path. /tcw-nonce as default. */
+    nonce: zod_1.z.string().optional(),
+    /** Post login endpoint path. /tcw-login as default. */
+    login: zod_1.z.string().optional(),
+    /** Post logout endpoint path. /tcw-logout as default. */
+    logout: zod_1.z.string().optional(),
+});
+/**
+ * Validates EnsData.
+ */
+function validateEnsData(data) {
+    const result = exports.EnsDataSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: result.error.message,
+                issues: result.error.issues,
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+/**
+ * Validates RPCProvider.
+ */
+function validateRPCProvider(data) {
+    const result = exports.RPCProviderSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: result.error.message,
+                issues: result.error.issues,
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+/**
+ * Validates ServerRoutes.
+ */
+function validateServerRoutes(data) {
+    const result = exports.ServerRoutesSchema.safeParse(data);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: result.error.message,
+                issues: result.error.issues,
+            },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=types.schema.js.map

package/dist/types.schema.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,15 @@
+import { EnsData, RPCProvider } from '../types';
+import { ethers } from 'ethers';
+/**
+ * @param rpc - RPCProvider
+ * @returns an ethers provider based on the RPC configuration.
+ */
+export declare const getProvider: (rpc?: RPCProvider) => ethers.providers.BaseProvider;
+/**
+ * Resolves ENS data supported by TCW.
+ * @param provider - Ethers provider.
+ * @param address - User address.
+ * @returns Object containing ENS data.
+ */
+export declare const resolveEns: (provider: ethers.providers.BaseProvider, address: string) => Promise<EnsData>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,OAAO,EAIP,WAAW,EACZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAsB,MAAM,QAAQ,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,WAAW,KAChB,MAAM,CAAC,SAAS,CAAC,YAyCnB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,CAAC,SAAS,CAAC,YAAY,EAEvC,SAAS,MAAM,KACd,OAAO,CAAC,OAAO,CAqBjB,CAAC"}

package/dist/utils/utils.js

@@ -0,0 +1,77 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEns = exports.getProvider = void 0;
+const types_1 = require("../types");
+const ethers_1 = require("ethers");
+/**
+ * @param rpc - RPCProvider
+ * @returns an ethers provider based on the RPC configuration.
+ */
+const getProvider = (rpc) => {
+    var _a, _b, _c, _d, _e;
+    if (!rpc) {
+        return (0, ethers_1.getDefaultProvider)();
+    }
+    if ((0, types_1.isEtherscanProvider)(rpc)) {
+        return new ethers_1.ethers.providers.EtherscanProvider((_a = rpc.network) !== null && _a !== void 0 ? _a : types_1.EtherscanProviderNetworks.MAINNET, rpc.apiKey);
+    }
+    if ((0, types_1.isInfuraProvider)(rpc)) {
+        return new ethers_1.ethers.providers.InfuraProvider((_b = rpc.network) !== null && _b !== void 0 ? _b : types_1.InfuraProviderNetworks.MAINNET, rpc.apiKey);
+    }
+    if ((0, types_1.isAlchemyProvider)(rpc)) {
+        return new ethers_1.ethers.providers.AlchemyProvider((_c = rpc.network) !== null && _c !== void 0 ? _c : types_1.AlchemyProviderNetworks.MAINNET, rpc.apiKey);
+    }
+    if ((0, types_1.isCloudflareProvider)(rpc)) {
+        return new ethers_1.ethers.providers.CloudflareProvider();
+    }
+    if ((0, types_1.isPocketProvider)(rpc)) {
+        return new ethers_1.ethers.providers.PocketProvider((_d = rpc.network) !== null && _d !== void 0 ? _d : types_1.PocketProviderNetworks.MAINNET, rpc.apiKey);
+    }
+    if ((0, types_1.isAnkrProvider)(rpc)) {
+        return new ethers_1.ethers.providers.AnkrProvider((_e = rpc.network) !== null && _e !== void 0 ? _e : types_1.AnkrProviderNetworks.MAINNET, rpc.apiKey);
+    }
+    if ((0, types_1.isCustomProvider)(rpc)) {
+        return new ethers_1.ethers.providers.JsonRpcProvider(rpc.url, rpc.network);
+    }
+    return (0, ethers_1.getDefaultProvider)();
+};
+exports.getProvider = getProvider;
+/**
+ * Resolves ENS data supported by TCW.
+ * @param provider - Ethers provider.
+ * @param address - User address.
+ * @returns Object containing ENS data.
+ */
+const resolveEns = (provider, 
+/* User Address */
+address) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!address) {
+        throw new Error('Missing address.');
+    }
+    const ens = {};
+    const promises = [];
+    promises.push(provider.lookupAddress(address));
+    promises.push(provider.getAvatar(address));
+    yield Promise.all(promises)
+        .then(([domain, avatarUrl]) => {
+        if (domain) {
+            ens['domain'] = domain;
+        }
+        if (avatarUrl) {
+            ens['avatarUrl'] = avatarUrl;
+        }
+    })
+        .catch(console.error);
+    return ens;
+});
+exports.resolveEns = resolveEns;
+//# sourceMappingURL=utils.js.map

package/dist/utils/utils.js.map

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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@tinycloud/web-core",
+  "version": "1.0.0",
+  "description": "TinyCloud Web Core library",
+  "author": "TinyCloud, Inc.",
+  "license": "EGPL",
+  "homepage": "https://github.com/TinyCloudLabs/web-sdk#readme",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bugs": {
+    "url": "https://github.com/TinyCloudLabs/web-sdk/issues"
+  },
+  "directories": {
+    "src": "src"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.js",
+      "default": "./dist/client/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/index.d.ts"
+      ],
+      "client": [
+        "dist/client/index.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "doc": "yarn doc:extractor && yarn doc:documenter",
+    "doc:extractor": "api-extractor run",
+    "doc:documenter": "api-documenter generate -i temp -o ../../documentation/docs/web-core"
+  },
+  "engines": {
+    "node": ">=18.16.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@github.com:TinyCloudLabs/web-sdk.git"
+  },
+  "dependencies": {
+    "@tinycloud/web-sdk-wasm": "^1.0.0",
+    "@types/axios": "^0.14.4",
+    "axios": "^1.7.9",
+    "ethers": "^5.7.2",
+    "events": "^3.3.0",
+    "express": "^4.21.2",
+    "express-session": "^1.18.1",
+    "siwe": "^2.3.2",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.26.5",
+    "@microsoft/api-extractor": "^7.49.1",
+    "@types/node": "^18.19.74",
+    "typescript": "^5.7.3",
+    "@typescript-eslint/eslint-plugin": "^5.62.0",
+    "@typescript-eslint/parser": "^5.62.0",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^8.10.0",
+    "prettier": "^2.8.8"
+  },
+  "files": [
+    "dist"
+  ]
+}