@zoralabs/protocol-sdk 0.7.0 → 0.7.1

package/dist/ipfs/arweave.d.ts

@@ -0,0 +1,3 @@
+export type ArweaveURL = `ar://${string}`;
+export declare function isArweaveURL(url: string | null | undefined): boolean;
+//# sourceMappingURL=arweave.d.ts.map

package/dist/ipfs/arweave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arweave.d.ts","sourceRoot":"","sources":["../../src/ipfs/arweave.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,MAAM,EAAE,CAAC;AAE1C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpE"}

package/dist/ipfs/gateway.d.ts

@@ -0,0 +1,4 @@
+export declare function arweaveGatewayUrl(normalizedArweaveUrl: string | null): string | null;
+export declare function ipfsGatewayUrl(url: string | null): string | null;
+export declare function getFetchableUrl(uri: string | null | undefined): string | null;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/ipfs/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/ipfs/gateway.ts"],"names":[],"mappings":"AAOA,wBAAgB,iBAAiB,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,iBAIpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,iBAOhD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAyB7E"}

package/dist/ipfs/index.d.ts

@@ -0,0 +1,4 @@
+export { makeMediaTokenMetadata, makeTextTokenMetadata, } from "./token-metadata";
+export { generateTextNftMetadataFiles } from "./text-metadata";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ipfs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,cAAc,SAAS,CAAC"}

package/dist/ipfs/ipfs.d.ts

@@ -0,0 +1,5 @@
+export type IPFSUrl = `ipfs://${string}`;
+export declare function isCID(str: string | null | undefined): boolean;
+export declare function normalizeIPFSUrl(url: string | null | undefined): IPFSUrl | null;
+export declare function isNormalizeableIPFSUrl(url: string | null | undefined): boolean;
+//# sourceMappingURL=ipfs.d.ts.map

package/dist/ipfs/ipfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs.d.ts","sourceRoot":"","sources":["../../src/ipfs/ipfs.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,UAAU,MAAM,EAAE,CAAC;AAEzC,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAU7D;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,OAAO,GAAG,IAAI,CAgChB;AA2BD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,OAAO,CAET"}

package/dist/ipfs/mimeTypes.d.ts

@@ -0,0 +1,25 @@
+export declare const TEXT_PLAIN = "text/plain";
+export declare const isImage: (mimeType: string | null | undefined) => boolean;
+export declare enum MediaType {
+    CSV = "CSV",
+    NUMBERS = "NUMBERS",
+    EXCEL = "EXCEL",
+    IMAGE = "IMAGE",
+    VIDEO = "VIDEO",
+    AUDIO = "AUDIO",
+    TIFF = "TIFF",
+    TEXT = "TEXT",
+    PDF = "PDF",
+    MODEL = "MODEL",
+    HTML = "HTML",
+    ZIP = "ZIP",
+    UNKNOWN = "UNKNOWN"
+}
+export declare const DEFAULT_THUMBNAIL_CID_HASHES: {
+    [key: string]: string;
+};
+export declare const JSON_MIME_TYPE = "application/json";
+/** Return a MediaType for the given mime type. If mime type is unknown you can provide a filename as a fallback, where the type will be guessed based on extension. */
+export declare function mimeTypeToMedia(mimeType?: string | null): MediaType;
+export declare function getMimeType(uri?: string): Promise<string | null | undefined>;
+//# sourceMappingURL=mimeTypes.d.ts.map

package/dist/ipfs/mimeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimeTypes.d.ts","sourceRoot":"","sources":["../../src/ipfs/mimeTypes.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,eAAe,CAAC;AAevC,eAAO,MAAM,OAAO,aAAc,MAAM,GAAG,IAAI,GAAG,SAAS,YAG1D,CAAC;AAEF,oBAAY,SAAS;IACnB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,4BAA4B,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAYjE,CAAC;AA2BF,eAAO,MAAM,cAAc,qBAAqB,CAAC;AA4CjD,uKAAuK;AACvK,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,aAOvD;AAED,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,sCAM7C"}

package/dist/ipfs/text-metadata.d.ts

@@ -0,0 +1,5 @@
+import { TextMetadataFiles } from "./types";
+/** For text nfts, this will generate files that are needed for the metadata json, including the txt.file containing the text, and a thumbnail image containing a preview of the text
+ */
+export declare function generateTextNftMetadataFiles(text: string): Promise<TextMetadataFiles>;
+//# sourceMappingURL=text-metadata.d.ts.map

package/dist/ipfs/text-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-metadata.d.ts","sourceRoot":"","sources":["../../src/ipfs/text-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiH5C;GACG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAU5B"}

package/dist/ipfs/token-metadata.d.ts

@@ -0,0 +1,14 @@
+import { MakeMediaMetadataParams, MakeTextMetadataParams, TokenMetadataJson } from "./types";
+/**
+ * Takes properties for a text based nft and formats it as proper json metadata
+ * for the token, which should be uploaded to IPFS.
+ * @param parameters - The parameters to format into metadata {@link MakeTextMetadataParams}
+ */
+export declare const makeTextTokenMetadata: (parameters: MakeTextMetadataParams) => TokenMetadataJson;
+/**
+ * Takes properties for a media based nft (video, image, etc) and formats it as proper json metadata
+ * for the token, which should be uploaded to IPFS.
+ * @param parameters - The parameters to format into metadata {@link MakeMediaMetadataParams}
+ */
+export declare const makeMediaTokenMetadata: ({ name, description, attributes, mediaUrl, thumbnailUrl, }: MakeMediaMetadataParams) => Promise<TokenMetadataJson>;
+//# sourceMappingURL=token-metadata.d.ts.map

package/dist/ipfs/token-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.d.ts","sourceRoot":"","sources":["../../src/ipfs/token-metadata.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eACpB,sBAAsB,KACjC,iBAoBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,+DAMhC,uBAAuB,KAAG,QAAQ,iBAAiB,CA4CrD,CAAC"}

package/dist/ipfs/types.d.ts

@@ -0,0 +1,49 @@
+export type CreateERC1155TokenAttributes = {
+    trait_type: string;
+    value: string;
+};
+export type ContractMetadataJson = {
+    name?: string;
+    description?: string;
+    image?: string;
+};
+export type TokenMetadataJson = {
+    name: string;
+    description?: string;
+    /** Primary image file */
+    image?: string;
+    animation_url?: string | null;
+    content?: {
+        mime: string;
+        uri: string;
+    } | null;
+    attributes: Array<CreateERC1155TokenAttributes>;
+};
+export type BaseMetadataParams = {
+    /** Token name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Optional attributes to tag the token with */
+    attributes?: CreateERC1155TokenAttributes[];
+};
+export type MakeTextMetadataParams = BaseMetadataParams & {
+    /** Ipfs url where media is hosted */
+    textFileUrl: string;
+    /** If thumbnail was generate for text file, thumbnail image url */
+    thumbnailUrl?: string;
+};
+export type TextMetadataFiles = {
+    name: string;
+    /** File that holds the text, and is the primary media */
+    mediaUrlFile: File;
+    /** Thumbnail image preview of the text */
+    thumbnailFile: File;
+};
+export type MakeMediaMetadataParams = BaseMetadataParams & {
+    /** Ipfs url where media is hosted */
+    mediaUrl: string;
+    /** Ipfs url where thumbnail of media is hosted */
+    thumbnailUrl?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ipfs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ipfs/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,CAAC,EAAE,4BAA4B,EAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IACxD,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,YAAY,EAAE,IAAI,CAAC;IACnB,0CAA0C;IAC1C,aAAa,EAAE,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,GAAG;IACzD,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC"}

package/dist/premint/premint-client.d.ts

@@ -9,7 +9,7 @@ import { MakeMintParametersArgumentsBase, MakePremintMintParametersArguments, Mi
 import { PremintFromApi } from "./conversions";
 import { SimulateContractParametersWithAccount } from "src/types";
 type PremintedV2LogType = DecodeEventLogReturnType<typeof zoraCreator1155PremintExecutorImplABI, "PremintedV2">["args"];
-type URLSReturnType = {
+export type URLSReturnType = {
     explorer: null | string;
     zoraCollect: null | string;
     zoraManage: null | string;
@@ -1520,6 +1520,7 @@ type PremintReturn<T extends PremintConfigVersion> = {
     signAndSubmit: (params: SignAndSubmitParams) => Promise<SignAndSubmitReturn>;
     /** For the case where the premint is signed externally, takes the signature for the Premint, and submits it and the Premint to the Zora Premint API */
     submit: (params: SubmitParams) => Promise<void>;
+    urls: URLSReturnType;
 } & PremintConfigWithVersion<T>;
 /** CREATE */
 type CreatePremintParameters = {

package/dist/premint/premint-client.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoralabs/protocol-sdk",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "repository": "https://github.com/ourzora/zora-protocol",
   "license": "MIT",
   "type": "module",
@@ -32,6 +32,7 @@
     "viem": "^2.11.1"
   },
   "devDependencies": {
+    "@fleekhq/fleek-storage-js": "^1.0.24",
     "@lavamoat/preinstall-always-fail": "2.0.0",
     "@reservoir0x/relay-sdk": "^0.3.8",
     "@reservoir0x/reservoir-sdk": "^2.0.11",

package/src/index.ts

@@ -29,3 +29,5 @@ export {
 export * from "./create/types";
 
 export * from "./sdk";
+
+export * from "./ipfs";

package/src/ipfs/arweave.ts

@@ -0,0 +1,5 @@
+export type ArweaveURL = `ar://${string}`;
+
+export function isArweaveURL(url: string | null | undefined): boolean {
+  return url && typeof url === "string" ? url.startsWith("ar://") : false;
+}

package/src/ipfs/gateway.ts

@@ -0,0 +1,48 @@
+import { isArweaveURL } from "./arweave";
+import { isNormalizeableIPFSUrl, normalizeIPFSUrl } from "./ipfs";
+
+const IPFS_GATEWAY = "https://magic.decentralized-content.com";
+
+const ARWEAVE_GATEWAY = "https://arweave.net";
+
+export function arweaveGatewayUrl(normalizedArweaveUrl: string | null) {
+  if (!normalizedArweaveUrl || typeof normalizedArweaveUrl !== "string")
+    return null;
+  return normalizedArweaveUrl.replace("ar://", `${ARWEAVE_GATEWAY}/`);
+}
+
+export function ipfsGatewayUrl(url: string | null) {
+  if (!url || typeof url !== "string") return null;
+  const normalizedIPFSUrl = normalizeIPFSUrl(url);
+  if (normalizedIPFSUrl) {
+    return normalizedIPFSUrl.replace("ipfs://", `${IPFS_GATEWAY}/ipfs/`);
+  }
+  return null;
+}
+
+export function getFetchableUrl(uri: string | null | undefined): string | null {
+  if (!uri || typeof uri !== "string") return null;
+
+  // Prevent fetching from insecure URLs
+  if (uri.startsWith("http://")) return null;
+
+  // If it is an IPFS HTTP or ipfs:// url
+  if (isNormalizeableIPFSUrl(uri)) {
+    // Return a fetchable gateway url
+    return ipfsGatewayUrl(uri);
+  }
+
+  // If it is a ar:// url
+  if (isArweaveURL(uri)) {
+    // Return a fetchable gateway url
+    return arweaveGatewayUrl(uri);
+  }
+
+  // If it is already a url (or blob or data-uri)
+  if (/^(https|data|blob):/.test(uri)) {
+    // Return the URI
+    return uri;
+  }
+
+  return null;
+}

package/src/ipfs/index.ts

@@ -0,0 +1,7 @@
+export {
+  makeMediaTokenMetadata,
+  makeTextTokenMetadata,
+} from "./token-metadata";
+export { generateTextNftMetadataFiles } from "./text-metadata";
+
+export * from "./types";

package/src/ipfs/ipfs.ts

@@ -0,0 +1,82 @@
+import { CID } from "multiformats/cid";
+
+export type IPFSUrl = `ipfs://${string}`;
+
+export function isCID(str: string | null | undefined): boolean {
+  if (!str) return false;
+
+  try {
+    CID.parse(str);
+    return true;
+  } catch (e) {
+    if (/^(bafy|Qm)/.test(str)) return true;
+    return false;
+  }
+}
+
+export function normalizeIPFSUrl(
+  url: string | null | undefined,
+): IPFSUrl | null {
+  if (!url || typeof url !== "string") return null;
+
+  // Handle urls wrapped in quotes
+  url = url.replace(/"/g, "");
+
+  // Check if already a normalized IPFS url
+  if (isNormalizedIPFSURL(url)) return url as IPFSUrl;
+
+  // Check if url is a CID string
+  if (isCID(url)) return `ipfs://${url}`;
+
+  // If url is not either an ipfs gateway or protocol url
+  if (!isIPFSUrl(url)) return null;
+
+  // If url is already a gateway url, parse and normalize
+  if (isGatewayIPFSUrl(url)) {
+    // Replace leading double-slashes and parse URL
+    const parsed = new URL(url.replace(/^\/\//, "http://"));
+    // Remove IPFS from the URL
+    // http://gateway/ipfs/<CID>?x=y#z -> http://gateway/<CID>?x=y#z
+    parsed.pathname = parsed.pathname.replace(/^\/ipfs\//, "");
+    // Remove the protocol and host from the URL
+    // http://gateway/<CID>?x=y#z -> <CID>?x=y#z
+    const cid = parsed
+      .toString()
+      .replace(`${parsed.protocol}//${parsed.host}/`, "");
+    // Prepend ipfs protocol
+    return `ipfs://${cid}`;
+  }
+
+  return null;
+}
+
+function isNormalizedIPFSURL(url: string | null | undefined): boolean {
+  return url && typeof url === "string" ? url.startsWith("ipfs://") : false;
+}
+
+function isGatewayIPFSUrl(url: string | null | undefined): boolean {
+  if (url && typeof url === "string") {
+    try {
+      const parsed = new URL(url.replace(/^"|'(.*)"|'$/, "$1"));
+      return (
+        !isNormalizedIPFSURL(url) &&
+        parsed &&
+        parsed.pathname.startsWith("/ipfs/")
+      );
+    } catch {
+      return false;
+    }
+  }
+
+  return false;
+}
+
+function isIPFSUrl(url: string | null | undefined): boolean {
+  return url ? isNormalizedIPFSURL(url) || isGatewayIPFSUrl(url) : false;
+}
+
+export function isNormalizeableIPFSUrl(
+  url: string | null | undefined,
+): boolean {
+  return url ? isIPFSUrl(url) || isCID(url) : false;
+}

package/src/ipfs/mimeTypes.ts

@@ -0,0 +1,141 @@
+// text
+const HTML = "text/html";
+const MARKDOWN = "text/markdown";
+const MARKDOWN_UTF8 = "text/markdown; charset=utf-8";
+const TEXT_PLAIN_UTF8 = "text/plain; charset=utf-8";
+export const TEXT_PLAIN = "text/plain";
+const CSV = "text/csv";
+const NUMBERS = ".numbers";
+const EXCEL = ".xlsx";
+const PDF = "application/pdf";
+
+// image
+const JPG = "image/jpg";
+const JPEG = "image/jpeg";
+const PNG = "image/png";
+const WEBP = "image/webp";
+const SVG = "image/svg+xml";
+const TIFF = "image/tiff";
+const GIF = "image/gif";
+
+export const isImage = (mimeType: string | null | undefined) => {
+  if (!mimeType) return false;
+  return [JPG, JPEG, PNG, WEBP, SVG, TIFF, GIF].includes(mimeType);
+};
+
+export enum MediaType {
+  CSV = "CSV",
+  NUMBERS = "NUMBERS",
+  EXCEL = "EXCEL",
+  IMAGE = "IMAGE",
+  VIDEO = "VIDEO",
+  AUDIO = "AUDIO",
+  TIFF = "TIFF",
+  TEXT = "TEXT",
+  PDF = "PDF",
+  MODEL = "MODEL",
+  HTML = "HTML",
+  ZIP = "ZIP",
+  UNKNOWN = "UNKNOWN",
+}
+
+export const DEFAULT_THUMBNAIL_CID_HASHES: { [key: string]: string } = {
+  [MediaType.AUDIO]:
+    "bafkreidir5laqi26ta6ivnpe2zpekgrfcyi4tb5x6vhwmwnledmzxshfb4",
+  [MediaType.VIDEO]:
+    "bafkreifm4edadl3j5luoyvw4p6elxeqd77la7bulee6vhq5gq4chfk32mu",
+  [MediaType.HTML]:
+    "bafkreifgvi6xfwqy2l6g45csyokejpaib52ee7zrw6etrxl2tas4xkkclq",
+  [MediaType.ZIP]:
+    "bafkreihe5rr5jbkwzegisjlhxbb7jw22xw5oilfmgd2re6tz6buo4pasdq", // assuming all zip files are html directories
+  [MediaType.TEXT]:
+    "bafkreiaez25nfgggzrnza2loxf6xueb2esm44pnyjyulwoslnipowrf56q",
+  default: "bafkreihcoahllisbpb4eeypdwtm7go5uh275wxd7wf2tantpxlpjhviok4",
+};
+
+// video
+const MP4 = "video/mp4";
+const QUICKTIME = "video/quicktime";
+const M4V = "video/x-m4v";
+const WEBM = "video/webm";
+
+// audio
+const M4A = "audio/x-m4a";
+const MPEG = "audio/mpeg";
+const MP3 = "audio/mp3";
+const WAV = "audio/wav";
+const VND_WAV = "audio/vnd.wav";
+const VND_WAVE = "audio/vnd.wave";
+const WAVE = "audio/wave";
+const X_WAV = "audio/x-wav";
+const AIFF = "audio/aiff";
+
+// 3D
+const GLTF = "model/gltf+json";
+const GLB = "model/gltf-binary";
+// File extensions, as some files return '' as the mimetype
+const GLTF_EXT = ".gltf";
+const GLB_EXT = ".glb";
+
+// application
+export const JSON_MIME_TYPE = "application/json";
+const ZIP = "application/zip";
+
+const mimeToMediaType = {
+  [HTML]: MediaType.HTML,
+  [JPG]: MediaType.IMAGE,
+  [JPEG]: MediaType.IMAGE,
+  [PNG]: MediaType.IMAGE,
+  [WEBP]: MediaType.IMAGE,
+  [SVG]: MediaType.IMAGE,
+  [TIFF]: MediaType.TIFF,
+  [GIF]: MediaType.IMAGE,
+  [MP4]: MediaType.VIDEO,
+  [WEBM]: MediaType.VIDEO,
+  [QUICKTIME]: MediaType.VIDEO,
+  [M4V]: MediaType.VIDEO,
+  [MPEG]: MediaType.AUDIO,
+  [MP3]: MediaType.AUDIO,
+  [M4A]: MediaType.AUDIO,
+  [VND_WAV]: MediaType.AUDIO,
+  [VND_WAVE]: MediaType.AUDIO,
+  [WAV]: MediaType.AUDIO,
+  [WAVE]: MediaType.AUDIO,
+  [X_WAV]: MediaType.AUDIO,
+  [AIFF]: MediaType.AUDIO,
+  [TEXT_PLAIN]: MediaType.TEXT,
+  [TEXT_PLAIN_UTF8]: MediaType.TEXT,
+  [MARKDOWN]: MediaType.TEXT,
+  [MARKDOWN_UTF8]: MediaType.TEXT,
+  [CSV]: MediaType.CSV,
+  [NUMBERS]: MediaType.NUMBERS,
+  [EXCEL]: MediaType.EXCEL,
+  [PDF]: MediaType.PDF,
+  [ZIP]: MediaType.ZIP,
+  [GLTF]: MediaType.MODEL,
+  [GLTF_EXT]: MediaType.MODEL,
+  [GLB]: MediaType.MODEL,
+  // GLTF returns 'application/json' as the mimetype,
+  // and as the only JSON-encoded media we currently support,
+  // we assume that if the mimetype is JSON, it's a GLTF
+  [JSON_MIME_TYPE]: MediaType.MODEL,
+  [GLB_EXT]: MediaType.MODEL,
+} as const;
+
+/** Return a MediaType for the given mime type. If mime type is unknown you can provide a filename as a fallback, where the type will be guessed based on extension. */
+export function mimeTypeToMedia(mimeType?: string | null) {
+  if (!mimeType) return MediaType.UNKNOWN;
+
+  return (
+    mimeToMediaType[mimeType as keyof typeof mimeToMediaType] ||
+    MediaType.UNKNOWN
+  );
+}
+
+export async function getMimeType(uri?: string) {
+  if (!uri) return uri;
+
+  const res = await fetch(uri, { method: "HEAD" });
+  let mimeType = res.headers.get("content-type");
+  return mimeType;
+}

package/src/ipfs/text-metadata.ts

@@ -0,0 +1,128 @@
+import { TextMetadataFiles } from "./types";
+
+const CHAR_LIMIT = 1111;
+
+const wrapText = ({
+  ctx,
+  text,
+  x,
+  y,
+  maxWidth,
+  lineHeight,
+}: {
+  ctx: CanvasRenderingContext2D;
+  text: string;
+  x: number;
+  y: number;
+  maxWidth: number;
+  lineHeight: number;
+}) => {
+  // Split text into words
+  let words = text.replaceAll("\n", " \n ").split(/ +/);
+  let line = ""; // This will store the text of the current line
+  let testLine = ""; // This will store the text when we add a word, to test if it's too long
+  let lineArray = []; // This is an array of lines, which the function will return
+
+  for (var n = 0; n < words.length; n++) {
+    // Measure text sizing
+    testLine += `${words[n]} `;
+    let metrics = ctx.measureText(testLine);
+    let testWidth = metrics.width;
+    // If the width of this test line is more than the max width
+    if (words[n]?.includes("\n") || (testWidth > maxWidth && n > 0)) {
+      // Then the line is finished, push the current line into "lineArray"
+      lineArray.push({ text: line, x, y });
+      // Start a new line
+      y += lineHeight;
+      // Update line and test line to use this word as the first word on the next line
+      // If it's a newline, then don't add a space
+      if (words[n]?.includes("\n")) {
+        line = ``;
+        testLine = ``;
+      } else {
+        line = `${words[n]} `;
+        testLine = `${words[n]} `;
+      }
+    } else {
+      // Test line is less than the max width, add the word to the current line
+      line += `${words[n]} `;
+    }
+    // Handle a single line...
+    if (n === words.length - 1) {
+      lineArray.push({ text: line, x, y });
+    }
+  }
+  return lineArray;
+};
+
+async function generateTextPreview(text: string): Promise<File> {
+  // Trim the text to a reasonable max length. Prevent crashes if the user pastes a gigantic string
+  const trimmedText = text.trim().slice(0, CHAR_LIMIT);
+
+  const [width, height] = [500, 500];
+  const padding = 20;
+  const dpr = 2;
+
+  const fontFamily = "Inter";
+  const [fontSize, lineHeight] = [16, 24];
+  const [textColor, backgroundColor] = ["black", "white"];
+
+  return new Promise((resolve, reject) => {
+    const canvas = document.createElement("canvas");
+    canvas.width = width * dpr;
+    canvas.height = height * dpr;
+    const ctx = canvas.getContext("2d");
+    if (!ctx) {
+      return reject(new Error("Could not create canvas context"));
+    }
+    ctx.fillStyle = backgroundColor;
+    ctx.fillRect(0, 0, width * dpr, width * dpr);
+    ctx.fillStyle = textColor;
+    ctx.font = `${fontSize * dpr}px ${fontFamily}`;
+    const wrapped = wrapText({
+      ctx,
+      text: trimmedText,
+      x: padding * dpr,
+      y: fontSize * dpr + padding * dpr,
+      maxWidth: width * dpr - padding * 2 * dpr,
+      lineHeight: lineHeight * dpr,
+    });
+    wrapped.forEach((line) => ctx.fillText(line.text, line.x, line.y));
+    canvas.toBlob((blob) => {
+      if (!blob) {
+        return reject(new Error("Could not create blob"));
+      }
+      resolve(new File([blob], "thumbnail.png", { type: "image/png" }));
+    });
+  });
+}
+
+function generateTextTitle(text: string) {
+  const firstLine = text.split("\n")[0]!;
+  const firstSentence = firstLine?.split(". ")[0]!;
+
+  if (firstSentence.length > 50) {
+    return firstSentence.slice(0, 50) + "...";
+  }
+
+  return firstSentence;
+}
+
+const toTextFile = (text: string) =>
+  new File([text], "Untitled.txt", { type: "text/plain" });
+
+/** For text nfts, this will generate files that are needed for the metadata json, including the txt.file containing the text, and a thumbnail image containing a preview of the text
+ */
+export async function generateTextNftMetadataFiles(
+  text: string,
+): Promise<TextMetadataFiles> {
+  const name = generateTextTitle(text);
+  const textFile = toTextFile(text);
+  const thumbnailFile = await generateTextPreview(text);
+
+  return {
+    name,
+    mediaUrlFile: textFile,
+    thumbnailFile,
+  };
+}