@joai/core 0.2.0

package/dist/index.mjs

@@ -0,0 +1,303 @@
+//#region src/config/urls.ts
+const toSubdomainBaseUrl = (env, subdomain) => {
+	if (env === "local") return `http://${subdomain}.joai--api.test`;
+	if (env === "devnet") return `https://devnet-${subdomain}.joai.ai`;
+	if (env === "testnet") return `https://testnet-${subdomain}.joai.ai`;
+	return `https://${subdomain}.joai.ai`;
+};
+const getApiBaseUrl = (env) => toSubdomainBaseUrl(env, "api");
+const getCortexBaseUrl = (env) => {
+	if (env === "local") return "http://localhost:3010";
+	if (env === "devnet") return "https://devnet-cortex.joai.ai";
+	if (env === "testnet") return "https://testnet-cortex.joai.ai";
+	return "https://cortex.joai.ai";
+};
+const getAppBaseUrl = (env) => {
+	if (env === "local") return "http://app.joai--api.test:3004";
+	if (env === "devnet") return "https://devnet.joai.ai";
+	if (env === "testnet") return "https://testnet.joai.ai";
+	return "https://joai.ai";
+};
+const getMcpServerAgentUrl = (env, agent) => `${toSubdomainBaseUrl(env, "cortex")}/mcp/agents/${agent}`;
+//#endregion
+//#region src/config/constants.ts
+const JoaiUrls = {
+	TelegramGroup: "https://telegram.joai.ai",
+	Twitter: "https://x.com/JoAiAgents",
+	Reddit: "https://www.reddit.com/r/JoAi/",
+	GitHub: "https://github.com/JoAiHQ",
+	LinkedIn: "https://www.linkedin.com/company/joai",
+	Docs: "https://docs.joai.ai",
+	DocsApi: "https://docs.joai.ai/api",
+	DocsWebhooks: "https://docs.joai.ai/webhooks",
+	AppStore: "https://apps.apple.com/app/joai/id6741204807",
+	PlayStore: "https://play.google.com/store/apps/details?id=ai.joai.app"
+};
+//#endregion
+//#region src/http/service.ts
+var HttpService = class {
+	constructor(baseUrl, cookies, authToken, options) {
+		this.get = async (url, options) => await this.request("GET", url, void 0, options);
+		this.post = async (url, data, options) => await this.request("POST", url, data, options);
+		this.put = async (url, data, options) => await this.request("PUT", url, data, options);
+		this.delete = async (url, options) => await this.request("DELETE", url, void 0, options);
+		this.getCsrfToken = () => {
+			if (typeof document === "undefined") return null;
+			const match = document.cookie.match(/(?:^|;\s*)XSRF-TOKEN=([^;]*)/);
+			return match ? decodeURIComponent(match[1]) : null;
+		};
+		this.request = async (httpMethod, url, data, options, isRetry) => {
+			const requestUrl = url.startsWith("http") ? url : `${this.baseUrl}/${url}`;
+			const requestInfo = this.getRequestInfo(httpMethod, data, options);
+			const response = await this.convertResponse(this.fetchFn(requestUrl, requestInfo));
+			if (response.original.status === 419 && !isRetry) {
+				await this.refreshCsrfToken();
+				return this.request(httpMethod, url, data, options, true);
+			}
+			if (response.original.status === 401) this.onUnauthorized(response);
+			if (response.original.status === 429) {
+				console.warn(`[HTTP 429] ${httpMethod} ${requestUrl}`);
+				this.onTooManyRequests(response);
+			}
+			if (response.original.status === 503) this.onMaintenanceMode(response);
+			if (response.ok) this.onSuccessfulResponse(response);
+			return response;
+		};
+		this.refreshCsrfToken = async () => {
+			await this.fetchFn(`${this.baseUrl}/sanctum/csrf-cookie`, {
+				method: "GET",
+				credentials: "include",
+				headers: {
+					Accept: "application/json",
+					...this.headers
+				}
+			});
+		};
+		this.convertResponse = async (apiRes) => {
+			try {
+				const response = await apiRes;
+				const body = response.status === 204 ? {} : await response.json();
+				return {
+					data: body.data || null,
+					meta: body.meta,
+					body,
+					errors: body.errors || [],
+					ok: response.ok && !(body.errors && body.errors.length > 0),
+					noContent: response.status === 204,
+					paymentRequired: response.status === 402,
+					original: response
+				};
+			} catch (error) {
+				this.onNetworkError(error);
+				const anyError = error;
+				return {
+					data: {},
+					errors: anyError.response && (anyError.response.data || {}).errors,
+					body: {},
+					ok: false,
+					noContent: false,
+					paymentRequired: false,
+					original: anyError
+				};
+			}
+		};
+		this.getRequestInfo = (httpMethod = "GET", data, options) => {
+			const isJson = options?.isJson !== false;
+			const isFormData = data instanceof FormData;
+			const situationalHeaders = options?.headers || {};
+			const csrfToken = httpMethod !== "GET" ? this.getCsrfToken() : null;
+			const headers = {
+				Accept: "application/json",
+				...this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {},
+				...csrfToken ? { "X-XSRF-TOKEN": csrfToken } : {},
+				...situationalHeaders,
+				...this.headers
+			};
+			if (isJson && !isFormData) headers["Content-Type"] = "application/json";
+			return {
+				method: httpMethod,
+				credentials: "include",
+				headers,
+				body: httpMethod !== "GET" ? isJson && !isFormData ? JSON.stringify(data || {}) : data : void 0
+			};
+		};
+		this.baseUrl = baseUrl;
+		this.authToken = authToken || null;
+		this.fetchFn = options?.customFetch ?? globalThis.fetch.bind(globalThis);
+		this.onNetworkError = () => {};
+		this.onSuccessfulResponse = () => {};
+		this.onUnauthorized = () => {};
+		this.onMaintenanceMode = () => {};
+		this.onTooManyRequests = () => {};
+		this.headers = {
+			...options?.refererUrl ? { Referer: options.refererUrl } : {},
+			...cookies ? { Cookie: cookies } : {},
+			...options?.headers ?? {}
+		};
+	}
+};
+//#endregion
+//#region src/helpers/string.ts
+const sanitizeAlphanumeric = (val) => val.replace(/[^a-z0-9]/gi, "");
+const sanitizeNumeric = (val) => {
+	return (val.split(".").length > 2 && val.endsWith(".") ? val.slice(0, -1) : val).replace(/[^0-9\.]+/g, "");
+};
+const toNameInitials = (name) => name.split(" ").map((word) => word[0]).join("");
+const toPreviewText = (text, maxChars = 100) => {
+	if (!text) return "";
+	let sanitized = text.replace(/<\/?(h[1-6])[^>]*>/gi, " - ").replace(/<\/?(p|div|ul|ol|li|br|hr)[^>]*>/gi, " ").replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
+	sanitized = sanitized.startsWith("- ") ? sanitized.slice(2) : sanitized;
+	sanitized = sanitized.length > maxChars ? sanitized.substring(0, sanitized.lastIndexOf(" ", maxChars)) + "..." : sanitized;
+	return sanitized;
+};
+//#endregion
+//#region src/helpers/number.ts
+const abbreviateNumber = (val) => {
+	const SI_SYMBOL = [
+		"",
+		"k",
+		"M",
+		"G",
+		"T",
+		"P",
+		"E"
+	];
+	const tier = Math.log10(Math.abs(val)) / 3 | 0;
+	if (tier === 0) return val;
+	const suffix = SI_SYMBOL[tier];
+	return (val / Math.pow(10, tier * 3)).toFixed(1) + suffix;
+};
+const toHexEncodedNonce = (nonce) => {
+	const hex = nonce.toString(16);
+	return hex.length % 2 ? "0" + hex : hex;
+};
+const toNftId = (collection, nonce) => `${collection}-${toHexEncodedNonce(nonce)}`;
+//#endregion
+//#region src/helpers/file.ts
+const isFileFormatImage = (filename) => {
+	if (!filename) return false;
+	const sanitized = filename.toLowerCase();
+	return sanitized.endsWith(".png") || sanitized.endsWith(".jpeg") || sanitized.endsWith(".jpg") || sanitized.endsWith(".gif");
+};
+const isFileFormatVideo = (filename) => {
+	if (!filename) return false;
+	const sanitized = filename.toLowerCase();
+	return sanitized.endsWith(".mov") || sanitized.endsWith(".quicktime") || sanitized.endsWith(".mp4") || sanitized.endsWith(".webm");
+};
+const isFileFormatAudio = (filename) => {
+	if (!filename) return false;
+	const sanitized = filename.toLowerCase();
+	return sanitized.endsWith(".acc") || sanitized.endsWith(".flac") || sanitized.endsWith(".m4a") || sanitized.endsWith(".mp3") || sanitized.endsWith(".wav");
+};
+//#endregion
+//#region src/helpers/async.ts
+const withRetry = async (fn, validate, { maxRetries = 5, retryDelay = 1e3 } = {}) => {
+	for (let attempt = 1; attempt <= maxRetries; attempt++) {
+		const result = await fn();
+		if (validate(result)) return result;
+		if (attempt === maxRetries) throw new Error("Max retries reached: validation failed");
+		await new Promise((resolve) => setTimeout(resolve, retryDelay));
+	}
+	throw new Error("Unexpected end of retry loop");
+};
+//#endregion
+//#region src/helpers/asset.ts
+const AssetBaseUrl = "https://raw.githubusercontent.com/JoAiHQ/assets/main";
+const getAssetAppLogoUrl = (name) => `${AssetBaseUrl}/apps/logos/${name}`;
+const getAssetChainLogoUrl = (name) => `${AssetBaseUrl}/chains/logos/${name}`;
+const getAssetTokenLogoUrl = (name) => `${AssetBaseUrl}/tokens/logos/${name}`;
+const getAssetWalletLogoUrl = (name) => `${AssetBaseUrl}/wallets/logos/${name}`;
+const getAssetPartnerLogoUrl = (name) => `${AssetBaseUrl}/partners/logos/${name}`;
+//#endregion
+//#region src/budget/types.ts
+const PeriodTypeLabels = {
+	0: "One-time",
+	1: "Daily",
+	2: "Weekly",
+	3: "Monthly"
+};
+const PeriodTypeOptions = [
+	{
+		value: 0,
+		label: "None (one-time)"
+	},
+	{
+		value: 1,
+		label: "Daily"
+	},
+	{
+		value: 2,
+		label: "Weekly"
+	},
+	{
+		value: 3,
+		label: "Monthly"
+	}
+];
+//#endregion
+//#region src/contract/types.ts
+const DefaultCodeMetadata = {
+	isUpgradeable: true,
+	isReadable: false,
+	isPayable: false,
+	isPayableBySmartContract: false
+};
+const ContractCategoryDisplayNames = {
+	default: "Popular",
+	nft: "NFT",
+	marketplace: "Marketplace",
+	staking: "Staking",
+	governance: "Governance",
+	defi: "DeFi",
+	game: "Game",
+	social: "Social",
+	identity: "Identity",
+	infra: "Infrastructure"
+};
+//#endregion
+//#region src/ogimage/types.ts
+const OG_IMAGE_WIDTH = 1200;
+const OG_IMAGE_HEIGHT = 630;
+const OG_IMAGE_CONFIG = {
+	width: OG_IMAGE_WIDTH,
+	height: 630
+};
+const OgImageColors = {
+	primaryDark: "#66CC66",
+	primaryLight: "#98FF98",
+	secondaryDark: "#CCCC33",
+	secondaryLight: "#FFFF66",
+	brandBlack: "#181818",
+	brandWhite: "#f3f3f3",
+	gray: {
+		400: "#A3A3A3",
+		700: "#404040",
+		800: "#262626",
+		900: "#171717"
+	}
+};
+//#endregion
+//#region src/skill/types.ts
+const SkillType = {
+	Knowledge: "knowledge",
+	ContentTemplate: "content-template",
+	PersonalityClone: "personality-clone",
+	BrandKit: "brand-kit",
+	VideoTemplate: "video-template",
+	VisualKit: "visual-kit"
+};
+const SkillMediaBindingRole = {
+	Subject: "subject",
+	Style: "style",
+	Logo: "logo",
+	Product: "product",
+	Motion: "motion",
+	FirstFrame: "first_frame",
+	LastFrame: "last_frame"
+};
+const SkillScope = {
+	Agent: "agent",
+	Team: "team"
+};
+//#endregion
+export { ContractCategoryDisplayNames, DefaultCodeMetadata, HttpService, JoaiUrls, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OgImageColors, PeriodTypeLabels, PeriodTypeOptions, SkillMediaBindingRole, SkillScope, SkillType, abbreviateNumber, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getMcpServerAgentUrl, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, sanitizeAlphanumeric, sanitizeNumeric, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@joai/core",
+  "version": "0.2.0",
+  "description": "JoAi shared types, HTTP service, and config",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "peerDependencies": {
+    "@joai/warps": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3"
+  }
+}