alexandria-core

alexandria-core

An NPM module containing all of the core functionality to run the Alexandria front end.

Work in Progress

This section is a work in progress, so more information will be added periotically. Information may be out of data, for latest information, please read the code :)

Modules

Inside of Alexandria Core there are currently 4 modules. Each of the four modules have specific tasks to try and seperate the logic out. They are seperated as follows:

• Artifact: This contains helper functions for manipulating artifact JSON.
• Data: This contains simple access to application information that was fetched by the network layer.
• Network: Usually called by the Data layer. This module contains all of the server calls & network transfer functions (i.e. IPFS).
• util: Other generally helpful utility functions that we have found helpful.

Currently, we have implemented or planned the following functions:

Core.Artifact

Core.Artifact.getTXID(oipArtifact): returns the txid of the given artifact.

Core.Artifact.getTitle(oipArtifact): returns the title of the given artifact.

Core.Artifact.getType(oipArtifact): returns the type of the given artifact.

Core.Artifact.getSubtype(oipArtifact): returns the subtype of the given artifact.

Core.Artifact.getDescription(oipArtifact): returns the description of the given artifact.

Core.Artifact.getFiles(oipArtifact): returns the files of the given artifact.

Core.Artifact.getLocation(oipArtifact): returns the location of the given artifact (This is usually the IPFS hash, unless the Artifact uses another data storage layer).

Core.Artifact.getPublisherName(oipArtifact): returns the Publisher Name of the publisher that published the Artifact. If no Publisher Name is specified, it will display as Flotoshi.

Core.Artifact.getArtist(oipArtifact): returns the Artist of the given artifact. If an artist is not specified, it will return the Publisher Name.

Core.Artifact.getThumbnail(oipArtifact): returns the Thumbnail of the given artifact. This is calculated as the first File with the type "Image" that does not have a price to view it. Returns "" if no thumbnail can be found.

Core.Artifact.getFirstImage(oipArtifact): returns the first image in the given artifact. If none are found, "" will be returned.

Core.Artifact.getFirstHTML(oipArtifact): returns the first html document in the given artifact. This is calculated by grabbing the extension off of files, the first one with an extension of .html will be returned. If none are found, "" will be returned.

Core.Artifact.getSongs(oipArtifact): returns the a formatted JSON object of songs that were in the given artifact.

Core.Artifact.getEntypoIconForType(oipArtifact): returns the css class for the artifact type. This will likely be not very useful for most people.

Core.Artifact.paid(oipArtifact): returns true if any files have either a suggested buy price or suggested play price. Otherwise it will return false.

Core.Data

Core.Data.getSupportedArtifacts(callback(supportedArtifacts)): Provides an array of supported artifacts to the callback. All artifacts will be formatted based on the highest version supported by alexandria-core. Currently this is oip-041.

Core.Network

Core.Network.getIPFS(callback): Passes the IPFS object to the callback after it has been successfully spawned. You are highly discouraged from using this function, but it is here for advanced functionality.

Core.Network.getThumbnailFromIPFS(hash, onDataCallback): Give it either an IPFS file hash or hash + subfile (i.e. hash/filename.png). Each time data is downloaded (i.e. on download progress), we call the onDataCallback and pass a base64 encoded version of the file. You can feed this directly into an image source and it will load fine :)

Core.Network.getFileFromIPFS(hash, onCompleteCallback): Give it either an IPFS file hash or hash + subfile (i.e. hash/filename.png). When the file download is complete, we call the onDataCallback and pass a base64 encoded version of the file. You can feed this directly into an image source and it will load fine :)

Core.Network.getArtifactsFromOIPd(callback): This will grab a copy of the latest artifacts from OIPd and return them as an array to the callback.

Core.util

Core.util.chunksToFileURL(chunks, onLoad): This is used by the IPFS network layer to load byte arrays into a file URL reader, then return the fileURL base64 data to the onLoad callback.

Core.util.buildIPFSURL(hash, filename): returns a built HTTP link to the IPFS resource. Use this if you don't want to download the file, but just get the URL to access it.

Core.util.getExtension(filename): returns the file extension as a string. For example, pass this index.html and it will return html.

Core.util.decodeMakeJSONSafe(stringToDecode): This checks if there are non JSON supported characters that we should re-encode, if there are, then it encodes them and returns a fixed string, if not, it returns the original string.