# @skynethub/userprofile-library > This library exposes a class that wraps the User Profile DAC, created and hosted by SkynetHub. Latest version **0.1.18-beta** (published 2021-11-17) · MIT license · 0 weekly downloads ## Install ```sh npm install @skynethub/userprofile-library pnpm add @skynethub/userprofile-library yarn add @skynethub/userprofile-library bun add @skynethub/userprofile-library ``` ## Health **Score 30/100 (F)** — status: abandoned. Positive: has types; esm support; no vulnerabilities; high quality score. Warnings: low downloads; pre 1.0. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.1.18-beta | | Published | 2021-11-17 | | First published | 2021-04-24 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 3 | | Unpacked size | 45.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 2 | | Author | Skynet Hub | | Maintainers | skynethub | ## Links - npm: https://www.npmjs.com/package/@skynethub/userprofile-library - Repository: https://github.com/skynethubio/userprofile-library - Homepage: https://github.com/skynethubio/userprofile-library#readme - Issues: https://github.com/skynethubio/userprofile-library/issues - npm.io page: https://npm.io/package/@skynethub/userprofile-library ## Dependencies (3) - [post-me](https://npm.io/package/post-me.md) ^0.4.5 - [skynet-js](https://npm.io/package/skynet-js.md) 4.0.18-beta - [skynet-mysky-utils](https://npm.io/package/skynet-mysky-utils.md) ^0.3.0 ## Recent versions - 0.1.18-beta (latest) — 2021-11-17 - 0.1.17-beta — 2021-11-17 - 0.1.16-beta — 2021-11-08 - 0.1.15-beta — 2021-11-08 - 0.1.14-beta — 2021-11-01 - 0.1.13-beta — 2021-10-30 - 0.1.12-beta — 2021-09-03 - 0.1.11-beta — 2021-09-03 - 0.1.10-beta — 2021-05-13 - 0.1.9-beta — 2021-05-08 - 0.1.8-beta — 2021-05-06 - 0.1.7-beta — 2021-05-03 - 0.1.6-beta — 2021-04-30 - 0.1.5-beta — 2021-04-27 - 0.1.4-beta — 2021-04-27 - … 4 more at https://npm.io/package/@skynethub/userprofile-library/versions ## README # User Profile Record Library ## Description The user profile record library is a library for skapp developers, allowing them to record the user profile data of their users within the skapp that they are building. The main purpose of this tool is content discovery; if all skapps were to make use of this library, the end result would be a scrapable global record of all content and the popularity of that content and the skapp. This information will eventually get displayed in a type of leaderboard that ranks top pieces of content and top skapps. ## Interface The library itself is a simple class that acts as a wrapper around the User Profile Record DAC. This DAC, or Data Access Controller, is built and hosted by Skynetlabs. The library will contain a hardcoded reference to its domain, thus abstracting all of its complexities from the skapp developer. The skapp developer is expected to call upon the User Profile record when its user perform the following types of actions. **_"UserStatus" is experimental feature and will be formally release after getting Skynet community feedback. Implementation may change based on Skynet community feedback_** Two new features. (1) (near) RealTime UserStatus (2) Privacy Preferences RealTime UserStatus on Skynet: (1) UserStatus consist of two fields "status" and "lastSeen". Status can be Online,Do not disturb, Invisible..etc (full list). LastSeen value contains unix timestamp. calling system is responsbile for converting timestamp to localtime/time format. (2) Also, Skynet is unique related to userStatus. We have two types of UserStatus. "Global" and "Skapp" specific. "Global" level only "LastSeen" value gets updated every two minutes. As of today there is no global status(this depends on community feedback post alpha release). "Skapp" level, User can set status from list of possible values (link,this will be expanded to support custom messages in future). Skapp specific status are most useful when user wants to be "online" on riftApp.hns but may prefer to stay "invisible" on skymessage.hns // Data Path PREFERENCES_INDEX_PATH: `profile-dac.hns/preferencesIndex.json` PREFERENCES_PATH: `profile-dac.hns/${skapp}/preferences.json` PROFILE_INDEX_PATH: `profile-dac.hns/profileIndex.json` PROFILE_PATH: `profile-dac.hns/${skapp}/userprofile.json` USER_STATUS_INDEX_PATH: `profile-dac.hns/userstatus` USER_STATUS_PATH: `profile-dac.hns/${skapp}/userstatus` ${skapp} will be replaced with skapp domain name. if skapp is skyprofile.hns, path will look like below PREFERENCES_INDEX_PATH: `profile-dac.hns/preferencesIndex.json` PREFERENCES_PATH: `profile-dac.hns/skyprofile.hns/preferences.json` PROFILE_INDEX_PATH: `profile-dac.hns/profileIndex.json` PROFILE_PATH: `profile-dac.hns/skyprofile.hns/userprofile.json` USER_STATUS_INDEX_PATH: `profile-dac.hns/userstatus` USER_STATUS_PATH: `profile-dac.hns/skyprofile.hns/userstatus` on a seperate note, If you want to explore these paths and check your data at these paths, I strongly recommend to use https://riftapp.hns.siasky.net ("data" tab on UI) ```typescript // DAC methods setUserStatus(status: string): Promise; setProfile(profile: IUserProfile): Promise; updateProfile(profile: Partial): Promise; setPreferences(prefs: IUserPreferences): Promise; getSkappPreferences():Promise; setGlobalPreferences(prefs: IUserPreferences): Promise; getGlobalPreferences():Promise; // Library Methods getUserStatus(userID: string, options?: IUserStatusOptions): Promise; getProfile(userID: string, options: IProfileOptions): Promise; getProfileHistory(userID: string): Promise; getPreferences(userID: string, options: IPreferencesOptions): Promise; getPreferencesHistory(userID: string): Promise export interface IUserProfile { version: number; username: string; firstName?: string; lastName?: string; emailID?: string; contact?: string; aboutMe?: string; location?: string; topics?: string[]; avatar?: IAvatar[]; connections?: any[]; } export interface IAvatar { ext: string, w: number, h: number, url: string } // Sample JSON { version: 1, username: "Terminator", emailID: "terminator@skynetlabs.mysky", firstName: "My", lastName: "Sky", contact: "007", aboutMe: "New decentralized Internet", location: "Above Cloud", topics: ['Skynet', 'MySky','Web3'], connections: [ { "twitter": "https://twitter.com/skynetlabs" }, { "github": "https://github.com/skynetlabs" }, ], avatar: [ { "ext": "jpeg", "w": 300, "h": 300, "url": "sia://RABycdgWznT8YeIk57CDE9w0CiwWeHi7JoYOyTwq_UaSXQ/23/300" } ] } interface IProfileOptions{ ipd?:string, skapp?:string } interface IUserPreferences { version: number, darkmode?: boolean, portal?: string, userStatus?: IUserStatusPreferences | null } interface IUserStatusPreferences { statusPrivacy: PrivacyType; lastSeenPrivacy: LastSeenPrivacyType; updatefrequency: number; // 0,1,5,10,15 //more to be added in upcoming versions } interface IUserStatusOptions { skapp?: string, onUserStatusChange?: (latestUserStatus : IUserStatus) => void; } interface IPreferencesOptions{ skapp?:string } interface ICreateDACResponse { submitted: boolean; error?: string; } // Types const StatusType = { ONLINE: 'Online', IDLE: 'Idle', DO_NOT_DISTURB: 'Do Not Disturb', INVISIBLE: 'Invisible', NONE: 'None' } as const; const PrivacyType = { PRIVATE: 'Private', PUBLIC: 'Public' } as const; const LastSeenPrivacyType = { PRIVATE: 'Private', PUBLIC_TS: 'Public with Timestamp', PUBLIC_NO_TS: 'Public without Timestamp', } as const; const UserPresenceType = { RECENTLY: 'Recently', YESTERDAY: 'Yesterday', WITHIN_A_WEEK: 'Within a week', WITHIN_A_MONTH: 'Within a month', LONG_TIME_AGO: 'Long time ago' } as const; ``` ## Usage Using the library is very straightforward. In this section we'll show an example of how a skapp could use the userprofile library. ```typescript import { SkynetClient } from "skynet-js"; import { UserProfileDAC } from "@skynethub/userprofile-library"; (async () => { // create client const client = new SkynetClient(); // create content record const userProfileRecord = new UserProfileDAC(); // load mysky const mySky = await client.loadMySky("exampleskapp.hns"); // get userID const userID = await mySky.userID(); // load DACs await mySky.loadDacs(userProfileRecord); let userProfile = await mySky.getProfile(userID); let userPreference = await mySky.getPreference(userID); // ####### (near) RealTime UserStatus ####### // UserStatus consist of two fields "status" and "lastSeen" // We have two type of UserStatus. "Global" and "Skapp" specific. // "Global" // Method 1: get userstatus via callback every 2 minutes // Only "LastSeen" value will change. const onGlobalUserStatusChange = async (latestStatus) => { console.log(`>>> callback : ${JSONstringify(latestStatus)}`); // sample latestStatus : {"status":"None","lastSeen":"1637108915830"} // parse display "latestStatus" in your skapp. }; profileDAC.getUserStatus(userID, {onUserStatusChange: onGlobalUserStatusChange, }); // Method 2: get one time status without callback const globalUserStatus = await profileDAC.getUserStatus(userID,); // "Skapp" specific // Method 1 : get specific userstatus via callback every 2 minutes const skapp = "riftapp.hns"; const onSkappUserStatusChange = async (latestStatus) => { console.log(`>>> callback : ${JSONstringify(latestStatus)}`); // sample latestStatus : {"status":"Online","lastSeen":"1637108914997"} // parse display "latestStatus" in your skapp. }; profileDAC.getUserStatus(userID, {skapp: skapp,onUserStatusChange: onSkappUserStatusChange}); // Method 2: get one time status without callback const globalUserStatus = await profileDAC.getUserStatus(userID,); // Preferences const globalPref = await profileDAC.getPreferences(userID) const skappPref = await profileDAC.getPreferences(userID, { skapp: "riftapp.hns"}) const preferencesJSON = { darkmode: true, portal: "https://siasky.net/", userStatus: { statusPrivacy:"Public", lastSeenPrivacy:"Public with Timestamp" } }; const globalPref = await profileDAC.setGlobalPreferences(preferencesJSON) // Set preferences for loggedIn Skapp domain const skappPref = await profileDAC.setPreferences(preferencesJSON) ``` --- _Source: https://npm.io/package/@skynethub/userprofile-library · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._