@opensea/seadn 2.0.8 → 2.1.0

package/dist/index.d.mts

@@ -6,7 +6,8 @@ type MediaParams = {
     format?: MediaFormat;
     quality?: number | `${number}`;
     fit?: MediaFit;
+    t?: number;
 };
-declare function optimize(image: string | URL, { width, height, format, quality, fit }: MediaParams): string;
+declare function optimize(image: string | URL, { width, height, format, quality, fit, t }: MediaParams): string;
 
 export { type MediaFit, type MediaFormat, type MediaParams, optimize };

package/dist/index.d.ts

@@ -6,7 +6,8 @@ type MediaParams = {
     format?: MediaFormat;
     quality?: number | `${number}`;
     fit?: MediaFit;
+    t?: number;
 };
-declare function optimize(image: string | URL, { width, height, format, quality, fit }: MediaParams): string;
+declare function optimize(image: string | URL, { width, height, format, quality, fit, t }: MediaParams): string;
 
 export { type MediaFit, type MediaFormat, type MediaParams, optimize };

package/dist/index.js

@@ -1,2 +1,2 @@
-"use strict";var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var p=(e,t)=>{for(var r in t)o(e,r,{get:t[r],enumerable:!0})},b=(e,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of d(t))!c.call(e,n)&&n!==r&&o(e,n,{get:()=>t[n],enumerable:!(a=u(t,n))||a.enumerable});return e};var m=e=>b(o({},"__esModule",{value:!0}),e);var w={};p(w,{optimize:()=>f});module.exports=m(w);function f(e,{width:t,height:r,format:a,quality:n,fit:s}){try{typeof e=="string"&&(e=new URL(e))}catch(M){return e.toString()}if(!(e instanceof URL))return e;if(!h(e))return e.toString();let i=new URLSearchParams;if(r!==void 0&&i.set("h",String(r)),t!==void 0&&i.set("w",String(t)),a!==void 0&&i.set("format",a),n){if(Number(n)<=0||Number(n)>100)throw new Error("Quality has to be a positive number between 1 and 100");i.set("q",String(n))}return s!==void 0&&i.set("fit",s),e.search=i.toString(),e.toString()}function h(e){if(!l(e))return!1;let t=e.pathname.split(".");if(t.length<=1)return!0;switch(t[t.length-1]){case"png":case"jpeg":case"webp":case"avif":case"ico":case"gif":case void 0:return!0;default:return!1}}function l(e){return e.hostname.endsWith("seadn.io")}0&&(module.exports={optimize});
+"use strict";var s=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var h=(e,n)=>{for(var r in n)s(e,r,{get:n[r],enumerable:!0})},x=(e,n,r,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of m(n))!l.call(e,t)&&t!==r&&s(e,t,{get:()=>n[t],enumerable:!(o=b(n,t))||o.enumerable});return e};var R=e=>x(s({},"__esModule",{value:!0}),e);var g={};h(g,{optimize:()=>d});module.exports=R(g);function d(e,{width:n,height:r,format:o,quality:t,fit:a,t:f}){try{typeof e=="string"&&(e=new URL(e))}catch(w){return e.toString()}if(!(e instanceof URL))return e;let u=S(e);if(!L(e)&&!u)return e.toString();let i=new URLSearchParams;if(r!==void 0&&i.set("h",String(r)),n!==void 0&&i.set("w",String(n)),o!==void 0&&i.set("format",o),t){if(Number(t)<=0||Number(t)>100)throw new Error("Quality has to be a positive number between 1 and 100");i.set("q",String(t))}if(a!==void 0&&i.set("fit",a),f!==void 0)u&&i.set("t",String(f));else if(c(e))return e.toString();return e.search=i.toString(),e.toString()}function c(e){let n=p(e);return n==="mp4"||n==="mov"}function S(e){return c(e)}function L(e){if(!U(e))return!1;switch(p(e)){case"png":case"jpeg":case"webp":case"avif":case"ico":case"gif":case void 0:return!0;default:return!1}}function p(e){let n=e.pathname.split(".");if(!(n.length<=1))return n[n.length-1]}function U(e){return e.hostname.endsWith("seadn.io")}0&&(module.exports={optimize});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/sdk.ts"],"sourcesContent":["export { optimize, MediaParams, MediaFormat, MediaFit } from \"./sdk\";\n","export type MediaFormat = \"webp\" | \"avif\" | \"jpeg\" | \"png\";\nexport type MediaFit = \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n\nexport type MediaParams = {\n  width?: number | `${number}`;\n  height?: number | `${number}`;\n  format?: MediaFormat;\n  quality?: number | `${number}`;\n  fit?: MediaFit;\n};\n\nexport function optimize(\n  image: string | URL,\n  { width, height, format, quality, fit }: MediaParams,\n): string {\n  try {\n    if (typeof image === \"string\") {\n      image = new URL(image);\n    }\n  } catch {\n    return image.toString();\n  }\n\n  if (!(image instanceof URL)) {\n    return image;\n  }\n\n  if (!canBeResized(image)) {\n    return image.toString();\n  }\n\n  const params = new URLSearchParams();\n  if (height !== undefined) {\n    params.set(\"h\", String(height));\n  }\n  if (width !== undefined) {\n    params.set(\"w\", String(width));\n  }\n  if (format !== undefined) {\n    params.set(\"format\", format);\n  }\n  if (quality) {\n    if (Number(quality) <= 0 || Number(quality) > 100) {\n      throw new Error(\"Quality has to be a positive number between 1 and 100\");\n    }\n    params.set(\"q\", String(quality));\n  }\n  if (fit !== undefined) {\n    params.set(\"fit\", fit);\n  }\n\n  image.search = params.toString();\n  return image.toString();\n}\n\nfunction canBeResized(url: URL): boolean {\n  if (!isSeadnURL(url)) {\n    return false;\n  }\n\n  const split = url.pathname.split(\".\");\n  if (split.length <= 1) {\n    return true;\n  }\n\n  const extension = split[split.length - 1];\n  switch (extension) {\n    case \"png\":\n    case \"jpeg\":\n    case \"webp\":\n    case \"avif\":\n    case \"ico\":\n    case \"gif\":\n    case undefined:\n      return true;\n    default:\n      return false;\n  }\n}\n\nexport function isSeadnURL(url: URL): boolean {\n  return url.hostname.endsWith(\"seadn.io\");\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GCWO,SAASI,EACdC,EACA,CAAE,MAAAC,EAAO,OAAAC,EAAQ,OAAAC,EAAQ,QAAAC,EAAS,IAAAC,CAAI,EAC9B,CACR,GAAI,CACE,OAAOL,GAAU,WACnBA,EAAQ,IAAI,IAAIA,CAAK,EAEzB,OAAQM,EAAA,CACN,OAAON,EAAM,SAAS,CACxB,CAEA,GAAI,EAAEA,aAAiB,KACrB,OAAOA,EAGT,GAAI,CAACO,EAAaP,CAAK,EACrB,OAAOA,EAAM,SAAS,EAGxB,IAAMQ,EAAS,IAAI,gBAUnB,GATIN,IAAW,QACbM,EAAO,IAAI,IAAK,OAAON,CAAM,CAAC,EAE5BD,IAAU,QACZO,EAAO,IAAI,IAAK,OAAOP,CAAK,CAAC,EAE3BE,IAAW,QACbK,EAAO,IAAI,SAAUL,CAAM,EAEzBC,EAAS,CACX,GAAI,OAAOA,CAAO,GAAK,GAAK,OAAOA,CAAO,EAAI,IAC5C,MAAM,IAAI,MAAM,uDAAuD,EAEzEI,EAAO,IAAI,IAAK,OAAOJ,CAAO,CAAC,CACjC,CACA,OAAIC,IAAQ,QACVG,EAAO,IAAI,MAAOH,CAAG,EAGvBL,EAAM,OAASQ,EAAO,SAAS,EACxBR,EAAM,SAAS,CACxB,CAEA,SAASO,EAAaE,EAAmB,CACvC,GAAI,CAACC,EAAWD,CAAG,EACjB,MAAO,GAGT,IAAME,EAAQF,EAAI,SAAS,MAAM,GAAG,EACpC,GAAIE,EAAM,QAAU,EAClB,MAAO,GAIT,OADkBA,EAAMA,EAAM,OAAS,CAAC,EACrB,CACjB,IAAK,MACL,IAAK,OACL,IAAK,OACL,IAAK,OACL,IAAK,MACL,IAAK,MACL,KAAK,OACH,MAAO,GACT,QACE,MAAO,EACX,CACF,CAEO,SAASD,EAAWD,EAAmB,CAC5C,OAAOA,EAAI,SAAS,SAAS,UAAU,CACzC","names":["src_exports","__export","optimize","__toCommonJS","optimize","image","width","height","format","quality","fit","e","canBeResized","params","url","isSeadnURL","split"]}
+{"version":3,"sources":["../src/index.ts","../src/sdk.ts"],"sourcesContent":["export { optimize, MediaParams, MediaFormat, MediaFit } from \"./sdk\";\n","export type MediaFormat = \"webp\" | \"avif\" | \"jpeg\" | \"png\";\nexport type MediaFit = \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n\nexport type MediaParams = {\n  width?: number | `${number}`;\n  height?: number | `${number}`;\n  format?: MediaFormat;\n  quality?: number | `${number}`;\n  fit?: MediaFit;\n  // Frame extraction time in seconds. Only applicable for videos\n  t?: number;\n};\n\nexport function optimize(\n  image: string | URL,\n  { width, height, format, quality, fit, t }: MediaParams,\n): string {\n  try {\n    if (typeof image === \"string\") {\n      image = new URL(image);\n    }\n  } catch {\n    return image.toString();\n  }\n\n  if (!(image instanceof URL)) {\n    return image;\n  }\n\n  const isFrameable = canExtractFrame(image);\n  if (!canBeResized(image) && !isFrameable) {\n    return image.toString();\n  }\n\n  const params = new URLSearchParams();\n  if (height !== undefined) {\n    params.set(\"h\", String(height));\n  }\n  if (width !== undefined) {\n    params.set(\"w\", String(width));\n  }\n  if (format !== undefined) {\n    params.set(\"format\", format);\n  }\n  if (quality) {\n    if (Number(quality) <= 0 || Number(quality) > 100) {\n      throw new Error(\"Quality has to be a positive number between 1 and 100\");\n    }\n    params.set(\"q\", String(quality));\n  }\n  if (fit !== undefined) {\n    params.set(\"fit\", fit);\n  }\n  if (t !== undefined) {\n    if (isFrameable) {\n      params.set(\"t\", String(t));\n    }\n  } else if (isVideo(image)) {\n    return image.toString();\n  }\n\n  image.search = params.toString();\n  return image.toString();\n}\n\nfunction isVideo(url: URL): boolean {\n  const extension = getExtension(url);\n  return extension === \"mp4\" || extension === \"mov\";\n}\n\nfunction canExtractFrame(url: URL): boolean {\n  return isVideo(url);\n}\n\nfunction canBeResized(url: URL): boolean {\n  if (!isSeadnURL(url)) {\n    return false;\n  }\n  const extension = getExtension(url);\n  switch (extension) {\n    case \"png\":\n    case \"jpeg\":\n    case \"webp\":\n    case \"avif\":\n    case \"ico\":\n    case \"gif\":\n    case undefined:\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction getExtension(url: URL): string | undefined {\n  const split = url.pathname.split(\".\");\n  if (split.length <= 1) {\n    return undefined;\n  }\n  return split[split.length - 1];\n}\n\nexport function isSeadnURL(url: URL): boolean {\n  return url.hostname.endsWith(\"seadn.io\");\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GCaO,SAASI,EACdC,EACA,CAAE,MAAAC,EAAO,OAAAC,EAAQ,OAAAC,EAAQ,QAAAC,EAAS,IAAAC,EAAK,EAAAC,CAAE,EACjC,CACR,GAAI,CACE,OAAON,GAAU,WACnBA,EAAQ,IAAI,IAAIA,CAAK,EAEzB,OAAQO,EAAA,CACN,OAAOP,EAAM,SAAS,CACxB,CAEA,GAAI,EAAEA,aAAiB,KACrB,OAAOA,EAGT,IAAMQ,EAAcC,EAAgBT,CAAK,EACzC,GAAI,CAACU,EAAaV,CAAK,GAAK,CAACQ,EAC3B,OAAOR,EAAM,SAAS,EAGxB,IAAMW,EAAS,IAAI,gBAUnB,GATIT,IAAW,QACbS,EAAO,IAAI,IAAK,OAAOT,CAAM,CAAC,EAE5BD,IAAU,QACZU,EAAO,IAAI,IAAK,OAAOV,CAAK,CAAC,EAE3BE,IAAW,QACbQ,EAAO,IAAI,SAAUR,CAAM,EAEzBC,EAAS,CACX,GAAI,OAAOA,CAAO,GAAK,GAAK,OAAOA,CAAO,EAAI,IAC5C,MAAM,IAAI,MAAM,uDAAuD,EAEzEO,EAAO,IAAI,IAAK,OAAOP,CAAO,CAAC,CACjC,CAIA,GAHIC,IAAQ,QACVM,EAAO,IAAI,MAAON,CAAG,EAEnBC,IAAM,OACJE,GACFG,EAAO,IAAI,IAAK,OAAOL,CAAC,CAAC,UAElBM,EAAQZ,CAAK,EACtB,OAAOA,EAAM,SAAS,EAGxB,OAAAA,EAAM,OAASW,EAAO,SAAS,EACxBX,EAAM,SAAS,CACxB,CAEA,SAASY,EAAQC,EAAmB,CAClC,IAAMC,EAAYC,EAAaF,CAAG,EAClC,OAAOC,IAAc,OAASA,IAAc,KAC9C,CAEA,SAASL,EAAgBI,EAAmB,CAC1C,OAAOD,EAAQC,CAAG,CACpB,CAEA,SAASH,EAAaG,EAAmB,CACvC,GAAI,CAACG,EAAWH,CAAG,EACjB,MAAO,GAGT,OADkBE,EAAaF,CAAG,EACf,CACjB,IAAK,MACL,IAAK,OACL,IAAK,OACL,IAAK,OACL,IAAK,MACL,IAAK,MACL,KAAK,OACH,MAAO,GACT,QACE,MAAO,EACX,CACF,CAEA,SAASE,EAAaF,EAA8B,CAClD,IAAMI,EAAQJ,EAAI,SAAS,MAAM,GAAG,EACpC,GAAI,EAAAI,EAAM,QAAU,GAGpB,OAAOA,EAAMA,EAAM,OAAS,CAAC,CAC/B,CAEO,SAASD,EAAWH,EAAmB,CAC5C,OAAOA,EAAI,SAAS,SAAS,UAAU,CACzC","names":["src_exports","__export","optimize","__toCommonJS","optimize","image","width","height","format","quality","fit","t","e","isFrameable","canExtractFrame","canBeResized","params","isVideo","url","extension","getExtension","isSeadnURL","split"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-function s(e,{width:t,height:i,format:a,quality:r,fit:o}){try{typeof e=="string"&&(e=new URL(e))}catch(d){return e.toString()}if(!(e instanceof URL))return e;if(!f(e))return e.toString();let n=new URLSearchParams;if(i!==void 0&&n.set("h",String(i)),t!==void 0&&n.set("w",String(t)),a!==void 0&&n.set("format",a),r){if(Number(r)<=0||Number(r)>100)throw new Error("Quality has to be a positive number between 1 and 100");n.set("q",String(r))}return o!==void 0&&n.set("fit",o),e.search=n.toString(),e.toString()}function f(e){if(!u(e))return!1;let t=e.pathname.split(".");if(t.length<=1)return!0;switch(t[t.length-1]){case"png":case"jpeg":case"webp":case"avif":case"ico":case"gif":case void 0:return!0;default:return!1}}function u(e){return e.hostname.endsWith("seadn.io")}export{s as optimize};
+function c(e,{width:n,height:i,format:o,quality:r,fit:s,t:a}){try{typeof e=="string"&&(e=new URL(e))}catch(l){return e.toString()}if(!(e instanceof URL))return e;let f=p(e);if(!b(e)&&!f)return e.toString();let t=new URLSearchParams;if(i!==void 0&&t.set("h",String(i)),n!==void 0&&t.set("w",String(n)),o!==void 0&&t.set("format",o),r){if(Number(r)<=0||Number(r)>100)throw new Error("Quality has to be a positive number between 1 and 100");t.set("q",String(r))}if(s!==void 0&&t.set("fit",s),a!==void 0)f&&t.set("t",String(a));else if(u(e))return e.toString();return e.search=t.toString(),e.toString()}function u(e){let n=d(e);return n==="mp4"||n==="mov"}function p(e){return u(e)}function b(e){if(!m(e))return!1;switch(d(e)){case"png":case"jpeg":case"webp":case"avif":case"ico":case"gif":case void 0:return!0;default:return!1}}function d(e){let n=e.pathname.split(".");if(!(n.length<=1))return n[n.length-1]}function m(e){return e.hostname.endsWith("seadn.io")}export{c as optimize};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sdk.ts"],"sourcesContent":["export type MediaFormat = \"webp\" | \"avif\" | \"jpeg\" | \"png\";\nexport type MediaFit = \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n\nexport type MediaParams = {\n  width?: number | `${number}`;\n  height?: number | `${number}`;\n  format?: MediaFormat;\n  quality?: number | `${number}`;\n  fit?: MediaFit;\n};\n\nexport function optimize(\n  image: string | URL,\n  { width, height, format, quality, fit }: MediaParams,\n): string {\n  try {\n    if (typeof image === \"string\") {\n      image = new URL(image);\n    }\n  } catch {\n    return image.toString();\n  }\n\n  if (!(image instanceof URL)) {\n    return image;\n  }\n\n  if (!canBeResized(image)) {\n    return image.toString();\n  }\n\n  const params = new URLSearchParams();\n  if (height !== undefined) {\n    params.set(\"h\", String(height));\n  }\n  if (width !== undefined) {\n    params.set(\"w\", String(width));\n  }\n  if (format !== undefined) {\n    params.set(\"format\", format);\n  }\n  if (quality) {\n    if (Number(quality) <= 0 || Number(quality) > 100) {\n      throw new Error(\"Quality has to be a positive number between 1 and 100\");\n    }\n    params.set(\"q\", String(quality));\n  }\n  if (fit !== undefined) {\n    params.set(\"fit\", fit);\n  }\n\n  image.search = params.toString();\n  return image.toString();\n}\n\nfunction canBeResized(url: URL): boolean {\n  if (!isSeadnURL(url)) {\n    return false;\n  }\n\n  const split = url.pathname.split(\".\");\n  if (split.length <= 1) {\n    return true;\n  }\n\n  const extension = split[split.length - 1];\n  switch (extension) {\n    case \"png\":\n    case \"jpeg\":\n    case \"webp\":\n    case \"avif\":\n    case \"ico\":\n    case \"gif\":\n    case undefined:\n      return true;\n    default:\n      return false;\n  }\n}\n\nexport function isSeadnURL(url: URL): boolean {\n  return url.hostname.endsWith(\"seadn.io\");\n}\n"],"mappings":"AAWO,SAASA,EACdC,EACA,CAAE,MAAAC,EAAO,OAAAC,EAAQ,OAAAC,EAAQ,QAAAC,EAAS,IAAAC,CAAI,EAC9B,CACR,GAAI,CACE,OAAOL,GAAU,WACnBA,EAAQ,IAAI,IAAIA,CAAK,EAEzB,OAAQM,EAAA,CACN,OAAON,EAAM,SAAS,CACxB,CAEA,GAAI,EAAEA,aAAiB,KACrB,OAAOA,EAGT,GAAI,CAACO,EAAaP,CAAK,EACrB,OAAOA,EAAM,SAAS,EAGxB,IAAMQ,EAAS,IAAI,gBAUnB,GATIN,IAAW,QACbM,EAAO,IAAI,IAAK,OAAON,CAAM,CAAC,EAE5BD,IAAU,QACZO,EAAO,IAAI,IAAK,OAAOP,CAAK,CAAC,EAE3BE,IAAW,QACbK,EAAO,IAAI,SAAUL,CAAM,EAEzBC,EAAS,CACX,GAAI,OAAOA,CAAO,GAAK,GAAK,OAAOA,CAAO,EAAI,IAC5C,MAAM,IAAI,MAAM,uDAAuD,EAEzEI,EAAO,IAAI,IAAK,OAAOJ,CAAO,CAAC,CACjC,CACA,OAAIC,IAAQ,QACVG,EAAO,IAAI,MAAOH,CAAG,EAGvBL,EAAM,OAASQ,EAAO,SAAS,EACxBR,EAAM,SAAS,CACxB,CAEA,SAASO,EAAaE,EAAmB,CACvC,GAAI,CAACC,EAAWD,CAAG,EACjB,MAAO,GAGT,IAAME,EAAQF,EAAI,SAAS,MAAM,GAAG,EACpC,GAAIE,EAAM,QAAU,EAClB,MAAO,GAIT,OADkBA,EAAMA,EAAM,OAAS,CAAC,EACrB,CACjB,IAAK,MACL,IAAK,OACL,IAAK,OACL,IAAK,OACL,IAAK,MACL,IAAK,MACL,KAAK,OACH,MAAO,GACT,QACE,MAAO,EACX,CACF,CAEO,SAASD,EAAWD,EAAmB,CAC5C,OAAOA,EAAI,SAAS,SAAS,UAAU,CACzC","names":["optimize","image","width","height","format","quality","fit","e","canBeResized","params","url","isSeadnURL","split"]}
+{"version":3,"sources":["../src/sdk.ts"],"sourcesContent":["export type MediaFormat = \"webp\" | \"avif\" | \"jpeg\" | \"png\";\nexport type MediaFit = \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n\nexport type MediaParams = {\n  width?: number | `${number}`;\n  height?: number | `${number}`;\n  format?: MediaFormat;\n  quality?: number | `${number}`;\n  fit?: MediaFit;\n  // Frame extraction time in seconds. Only applicable for videos\n  t?: number;\n};\n\nexport function optimize(\n  image: string | URL,\n  { width, height, format, quality, fit, t }: MediaParams,\n): string {\n  try {\n    if (typeof image === \"string\") {\n      image = new URL(image);\n    }\n  } catch {\n    return image.toString();\n  }\n\n  if (!(image instanceof URL)) {\n    return image;\n  }\n\n  const isFrameable = canExtractFrame(image);\n  if (!canBeResized(image) && !isFrameable) {\n    return image.toString();\n  }\n\n  const params = new URLSearchParams();\n  if (height !== undefined) {\n    params.set(\"h\", String(height));\n  }\n  if (width !== undefined) {\n    params.set(\"w\", String(width));\n  }\n  if (format !== undefined) {\n    params.set(\"format\", format);\n  }\n  if (quality) {\n    if (Number(quality) <= 0 || Number(quality) > 100) {\n      throw new Error(\"Quality has to be a positive number between 1 and 100\");\n    }\n    params.set(\"q\", String(quality));\n  }\n  if (fit !== undefined) {\n    params.set(\"fit\", fit);\n  }\n  if (t !== undefined) {\n    if (isFrameable) {\n      params.set(\"t\", String(t));\n    }\n  } else if (isVideo(image)) {\n    return image.toString();\n  }\n\n  image.search = params.toString();\n  return image.toString();\n}\n\nfunction isVideo(url: URL): boolean {\n  const extension = getExtension(url);\n  return extension === \"mp4\" || extension === \"mov\";\n}\n\nfunction canExtractFrame(url: URL): boolean {\n  return isVideo(url);\n}\n\nfunction canBeResized(url: URL): boolean {\n  if (!isSeadnURL(url)) {\n    return false;\n  }\n  const extension = getExtension(url);\n  switch (extension) {\n    case \"png\":\n    case \"jpeg\":\n    case \"webp\":\n    case \"avif\":\n    case \"ico\":\n    case \"gif\":\n    case undefined:\n      return true;\n    default:\n      return false;\n  }\n}\n\nfunction getExtension(url: URL): string | undefined {\n  const split = url.pathname.split(\".\");\n  if (split.length <= 1) {\n    return undefined;\n  }\n  return split[split.length - 1];\n}\n\nexport function isSeadnURL(url: URL): boolean {\n  return url.hostname.endsWith(\"seadn.io\");\n}\n"],"mappings":"AAaO,SAASA,EACdC,EACA,CAAE,MAAAC,EAAO,OAAAC,EAAQ,OAAAC,EAAQ,QAAAC,EAAS,IAAAC,EAAK,EAAAC,CAAE,EACjC,CACR,GAAI,CACE,OAAON,GAAU,WACnBA,EAAQ,IAAI,IAAIA,CAAK,EAEzB,OAAQO,EAAA,CACN,OAAOP,EAAM,SAAS,CACxB,CAEA,GAAI,EAAEA,aAAiB,KACrB,OAAOA,EAGT,IAAMQ,EAAcC,EAAgBT,CAAK,EACzC,GAAI,CAACU,EAAaV,CAAK,GAAK,CAACQ,EAC3B,OAAOR,EAAM,SAAS,EAGxB,IAAMW,EAAS,IAAI,gBAUnB,GATIT,IAAW,QACbS,EAAO,IAAI,IAAK,OAAOT,CAAM,CAAC,EAE5BD,IAAU,QACZU,EAAO,IAAI,IAAK,OAAOV,CAAK,CAAC,EAE3BE,IAAW,QACbQ,EAAO,IAAI,SAAUR,CAAM,EAEzBC,EAAS,CACX,GAAI,OAAOA,CAAO,GAAK,GAAK,OAAOA,CAAO,EAAI,IAC5C,MAAM,IAAI,MAAM,uDAAuD,EAEzEO,EAAO,IAAI,IAAK,OAAOP,CAAO,CAAC,CACjC,CAIA,GAHIC,IAAQ,QACVM,EAAO,IAAI,MAAON,CAAG,EAEnBC,IAAM,OACJE,GACFG,EAAO,IAAI,IAAK,OAAOL,CAAC,CAAC,UAElBM,EAAQZ,CAAK,EACtB,OAAOA,EAAM,SAAS,EAGxB,OAAAA,EAAM,OAASW,EAAO,SAAS,EACxBX,EAAM,SAAS,CACxB,CAEA,SAASY,EAAQC,EAAmB,CAClC,IAAMC,EAAYC,EAAaF,CAAG,EAClC,OAAOC,IAAc,OAASA,IAAc,KAC9C,CAEA,SAASL,EAAgBI,EAAmB,CAC1C,OAAOD,EAAQC,CAAG,CACpB,CAEA,SAASH,EAAaG,EAAmB,CACvC,GAAI,CAACG,EAAWH,CAAG,EACjB,MAAO,GAGT,OADkBE,EAAaF,CAAG,EACf,CACjB,IAAK,MACL,IAAK,OACL,IAAK,OACL,IAAK,OACL,IAAK,MACL,IAAK,MACL,KAAK,OACH,MAAO,GACT,QACE,MAAO,EACX,CACF,CAEA,SAASE,EAAaF,EAA8B,CAClD,IAAMI,EAAQJ,EAAI,SAAS,MAAM,GAAG,EACpC,GAAI,EAAAI,EAAM,QAAU,GAGpB,OAAOA,EAAMA,EAAM,OAAS,CAAC,CAC/B,CAEO,SAASD,EAAWH,EAAmB,CAC5C,OAAOA,EAAI,SAAS,SAAS,UAAU,CACzC","names":["optimize","image","width","height","format","quality","fit","t","e","isFrameable","canExtractFrame","canBeResized","params","isVideo","url","extension","getExtension","isSeadnURL","split"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/seadn",
-  "version": "2.0.8",
+  "version": "2.1.0",
   "description": "Javascript SDK to work with SeaDN",
   "license": "MIT",
   "author": "OpenSea Developers",
@@ -19,9 +19,9 @@
     "typecheck": "tsc"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "0.15.3",
-    "tsup": "8.1.0",
-    "typescript": "5.5.3",
+    "@arethetypeswrong/cli": "0.15.4",
+    "tsup": "8.2.4",
+    "typescript": "5.5.4",
     "vitest": "1.6.0"
   }
 }

package/src/sdk.spec.ts

@@ -88,6 +88,26 @@ test.each([
     { height: 100, width: 100, format: "avif" } satisfies MediaParams,
     "https://xyz.com/bored-ape.png",
   ],
+  [
+    "https://i2.seadn.io/bored-ape",
+    { t: 0.1 } satisfies MediaParams,
+    "https://i2.seadn.io/bored-ape",
+  ],
+  [
+    "https://i2.seadn.io/bored-ape.mp4",
+    { t: 0.1, height: 50 } satisfies MediaParams,
+    "https://i2.seadn.io/bored-ape.mp4?h=50&t=0.1",
+  ],
+  [
+    "https://i2.seadn.io/bored-ape.gif",
+    { t: 0.1 } satisfies MediaParams,
+    "https://i2.seadn.io/bored-ape.gif",
+  ],
+  [
+    "https://i2.seadn.io/bored-ape.mp4",
+    { width: 50, height: 50 } satisfies MediaParams,
+    "https://i2.seadn.io/bored-ape.mp4",
+  ],
 ])("resizeImage(%o, %o) -> %o", (url, resizeParams, expected) => {
   expect(optimize(url as string, resizeParams)).toEqual(expected);
 });

package/src/sdk.ts

@@ -7,11 +7,13 @@ export type MediaParams = {
   format?: MediaFormat;
   quality?: number | `${number}`;
   fit?: MediaFit;
+  // Frame extraction time in seconds. Only applicable for videos
+  t?: number;
 };
 
 export function optimize(
   image: string | URL,
-  { width, height, format, quality, fit }: MediaParams,
+  { width, height, format, quality, fit, t }: MediaParams,
 ): string {
   try {
     if (typeof image === "string") {
@@ -25,7 +27,8 @@ export function optimize(
     return image;
   }
 
-  if (!canBeResized(image)) {
+  const isFrameable = canExtractFrame(image);
+  if (!canBeResized(image) && !isFrameable) {
     return image.toString();
   }
 
@@ -48,22 +51,32 @@ export function optimize(
   if (fit !== undefined) {
     params.set("fit", fit);
   }
+  if (t !== undefined) {
+    if (isFrameable) {
+      params.set("t", String(t));
+    }
+  } else if (isVideo(image)) {
+    return image.toString();
+  }
 
   image.search = params.toString();
   return image.toString();
 }
 
+function isVideo(url: URL): boolean {
+  const extension = getExtension(url);
+  return extension === "mp4" || extension === "mov";
+}
+
+function canExtractFrame(url: URL): boolean {
+  return isVideo(url);
+}
+
 function canBeResized(url: URL): boolean {
   if (!isSeadnURL(url)) {
     return false;
   }
-
-  const split = url.pathname.split(".");
-  if (split.length <= 1) {
-    return true;
-  }
-
-  const extension = split[split.length - 1];
+  const extension = getExtension(url);
   switch (extension) {
     case "png":
     case "jpeg":
@@ -78,6 +91,14 @@ function canBeResized(url: URL): boolean {
   }
 }
 
+function getExtension(url: URL): string | undefined {
+  const split = url.pathname.split(".");
+  if (split.length <= 1) {
+    return undefined;
+  }
+  return split[split.length - 1];
+}
+
 export function isSeadnURL(url: URL): boolean {
   return url.hostname.endsWith("seadn.io");
 }