javascript-ampache
Version:
A JS library for the Ampache API
1 lines • 150 kB
Source Map (JSON)
{"version":3,"file":"index.modern.mjs","sources":["../node_modules/querystringify/index.js","../node_modules/unfetch/dist/unfetch.module.js","../node_modules/isomorphic-unfetch/browser.js","../node_modules/jssha/dist/sha256.mjs","../src/utils.ts","../src/base.ts","../src/index.ts","../src/albums/index.ts","../src/artists/index.ts","../src/auth/index.ts","../src/bookmarks/index.ts","../src/catalogs/index.ts","../src/genres/index.ts","../src/labels/index.ts","../src/licenses/index.ts","../src/live-streams/index.ts","../src/playlists/index.ts","../src/podcasts/index.ts","../src/preferences/index.ts","../src/shares/index.ts","../src/shouts/index.ts","../src/songs/index.ts","../src/system/index.ts","../src/users/index.ts","../src/videos/index.ts"],"sourcesContent":["'use strict';\n\nvar has = Object.prototype.hasOwnProperty\n , undef;\n\n/**\n * Decode a URI encoded string.\n *\n * @param {String} input The URI encoded string.\n * @returns {String|Null} The decoded string.\n * @api private\n */\nfunction decode(input) {\n try {\n return decodeURIComponent(input.replace(/\\+/g, ' '));\n } catch (e) {\n return null;\n }\n}\n\n/**\n * Attempts to encode a given input.\n *\n * @param {String} input The string that needs to be encoded.\n * @returns {String|Null} The encoded string.\n * @api private\n */\nfunction encode(input) {\n try {\n return encodeURIComponent(input);\n } catch (e) {\n return null;\n }\n}\n\n/**\n * Simple query string parser.\n *\n * @param {String} query The query string that needs to be parsed.\n * @returns {Object}\n * @api public\n */\nfunction querystring(query) {\n var parser = /([^=?#&]+)=?([^&]*)/g\n , result = {}\n , part;\n\n while (part = parser.exec(query)) {\n var key = decode(part[1])\n , value = decode(part[2]);\n\n //\n // Prevent overriding of existing properties. This ensures that build-in\n // methods like `toString` or __proto__ are not overriden by malicious\n // querystrings.\n //\n // In the case if failed decoding, we want to omit the key/value pairs\n // from the result.\n //\n if (key === null || value === null || key in result) continue;\n result[key] = value;\n }\n\n return result;\n}\n\n/**\n * Transform a query string to an object.\n *\n * @param {Object} obj Object that should be transformed.\n * @param {String} prefix Optional prefix.\n * @returns {String}\n * @api public\n */\nfunction querystringify(obj, prefix) {\n prefix = prefix || '';\n\n var pairs = []\n , value\n , key;\n\n //\n // Optionally prefix with a '?' if needed\n //\n if ('string' !== typeof prefix) prefix = '?';\n\n for (key in obj) {\n if (has.call(obj, key)) {\n value = obj[key];\n\n //\n // Edge cases where we actually want to encode the value to an empty\n // string instead of the stringified value.\n //\n if (!value && (value === null || value === undef || isNaN(value))) {\n value = '';\n }\n\n key = encode(key);\n value = encode(value);\n\n //\n // If we failed to encode the strings, we should bail out as we don't\n // want to add invalid strings to the query.\n //\n if (key === null || value === null) continue;\n pairs.push(key +'='+ value);\n }\n }\n\n return pairs.length ? prefix + pairs.join('&') : '';\n}\n\n//\n// Expose the module.\n//\nexports.stringify = querystringify;\nexports.parse = querystring;\n","export default function(e,n){return n=n||{},new Promise(function(t,r){var s=new XMLHttpRequest,o=[],u=[],i={},a=function(){return{ok:2==(s.status/100|0),statusText:s.statusText,status:s.status,url:s.responseURL,text:function(){return Promise.resolve(s.responseText)},json:function(){return Promise.resolve(s.responseText).then(JSON.parse)},blob:function(){return Promise.resolve(new Blob([s.response]))},clone:a,headers:{keys:function(){return o},entries:function(){return u},get:function(e){return i[e.toLowerCase()]},has:function(e){return e.toLowerCase()in i}}}};for(var l in s.open(n.method||\"get\",e,!0),s.onload=function(){s.getAllResponseHeaders().replace(/^(.*?):[^\\S\\n]*([\\s\\S]*?)$/gm,function(e,n,t){o.push(n=n.toLowerCase()),u.push([n,t]),i[n]=i[n]?i[n]+\",\"+t:t}),t(a())},s.onerror=r,s.withCredentials=\"include\"==n.credentials,n.headers)s.setRequestHeader(l,n.headers[l]);s.send(n.body||null)})}\n//# sourceMappingURL=unfetch.module.js.map\n","module.exports = self.fetch || (self.fetch = require('unfetch').default || require('unfetch'));\n","/**\n * A JavaScript implementation of the SHA family of hashes - defined in FIPS PUB 180-4, FIPS PUB 202,\n * and SP 800-185 - as well as the corresponding HMAC implementation as defined in FIPS PUB 198-1.\n *\n * Copyright 2008-2023 Brian Turek, 1998-2009 Paul Johnston & Contributors\n * Distributed under the BSD License\n * See http://caligatio.github.com/jsSHA/ for more information\n */\nconst t=\"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/\",r=\"ARRAYBUFFER not supported by this environment\",n=\"UINT8ARRAY not supported by this environment\";function i(t,r,n,i){let e,s,o;const h=r||[0],u=(n=n||0)>>>3,f=-1===i?3:0;for(e=0;e<t.length;e+=1)o=e+u,s=o>>>2,h.length<=s&&h.push(0),h[s]|=t[e]<<8*(f+i*(o%4));return{value:h,binLen:8*t.length+n}}function e(e,s,o){switch(s){case\"UTF8\":case\"UTF16BE\":case\"UTF16LE\":break;default:throw new Error(\"encoding must be UTF8, UTF16BE, or UTF16LE\")}switch(e){case\"HEX\":return function(t,r,n){return function(t,r,n,i){let e,s,o,h;if(0!=t.length%2)throw new Error(\"String of HEX type must be in byte increments\");const u=r||[0],f=(n=n||0)>>>3,c=-1===i?3:0;for(e=0;e<t.length;e+=2){if(s=parseInt(t.substr(e,2),16),isNaN(s))throw new Error(\"String of HEX type contains invalid characters\");for(h=(e>>>1)+f,o=h>>>2;u.length<=o;)u.push(0);u[o]|=s<<8*(c+i*(h%4))}return{value:u,binLen:4*t.length+n}}(t,r,n,o)};case\"TEXT\":return function(t,r,n){return function(t,r,n,i,e){let s,o,h,u,f,c,a,w,E=0;const l=n||[0],A=(i=i||0)>>>3;if(\"UTF8\"===r)for(a=-1===e?3:0,h=0;h<t.length;h+=1)for(s=t.charCodeAt(h),o=[],128>s?o.push(s):2048>s?(o.push(192|s>>>6),o.push(128|63&s)):55296>s||57344<=s?o.push(224|s>>>12,128|s>>>6&63,128|63&s):(h+=1,s=65536+((1023&s)<<10|1023&t.charCodeAt(h)),o.push(240|s>>>18,128|s>>>12&63,128|s>>>6&63,128|63&s)),u=0;u<o.length;u+=1){for(c=E+A,f=c>>>2;l.length<=f;)l.push(0);l[f]|=o[u]<<8*(a+e*(c%4)),E+=1}else for(a=-1===e?2:0,w=\"UTF16LE\"===r&&1!==e||\"UTF16LE\"!==r&&1===e,h=0;h<t.length;h+=1){for(s=t.charCodeAt(h),!0===w&&(u=255&s,s=u<<8|s>>>8),c=E+A,f=c>>>2;l.length<=f;)l.push(0);l[f]|=s<<8*(a+e*(c%4)),E+=2}return{value:l,binLen:8*E+i}}(t,s,r,n,o)};case\"B64\":return function(r,n,i){return function(r,n,i,e){let s,o,h,u,f,c,a,w=0;const E=n||[0],l=(i=i||0)>>>3,A=-1===e?3:0,p=r.indexOf(\"=\");if(-1===r.search(/^[a-zA-Z0-9=+/]+$/))throw new Error(\"Invalid character in base-64 string\");if(r=r.replace(/=/g,\"\"),-1!==p&&p<r.length)throw new Error(\"Invalid '=' found in base-64 string\");for(o=0;o<r.length;o+=4){for(f=r.substr(o,4),u=0,h=0;h<f.length;h+=1)s=t.indexOf(f.charAt(h)),u|=s<<18-6*h;for(h=0;h<f.length-1;h+=1){for(a=w+l,c=a>>>2;E.length<=c;)E.push(0);E[c]|=(u>>>16-8*h&255)<<8*(A+e*(a%4)),w+=1}}return{value:E,binLen:8*w+i}}(r,n,i,o)};case\"BYTES\":return function(t,r,n){return function(t,r,n,i){let e,s,o,h;const u=r||[0],f=(n=n||0)>>>3,c=-1===i?3:0;for(s=0;s<t.length;s+=1)e=t.charCodeAt(s),h=s+f,o=h>>>2,u.length<=o&&u.push(0),u[o]|=e<<8*(c+i*(h%4));return{value:u,binLen:8*t.length+n}}(t,r,n,o)};case\"ARRAYBUFFER\":try{new ArrayBuffer(0)}catch(t){throw new Error(r)}return function(t,r,n){return function(t,r,n,e){return i(new Uint8Array(t),r,n,e)}(t,r,n,o)};case\"UINT8ARRAY\":try{new Uint8Array(0)}catch(t){throw new Error(n)}return function(t,r,n){return i(t,r,n,o)};default:throw new Error(\"format must be HEX, TEXT, B64, BYTES, ARRAYBUFFER, or UINT8ARRAY\")}}function s(i,e,s,o){switch(i){case\"HEX\":return function(t){return function(t,r,n,i){const e=\"0123456789abcdef\";let s,o,h=\"\";const u=r/8,f=-1===n?3:0;for(s=0;s<u;s+=1)o=t[s>>>2]>>>8*(f+n*(s%4)),h+=e.charAt(o>>>4&15)+e.charAt(15&o);return i.outputUpper?h.toUpperCase():h}(t,e,s,o)};case\"B64\":return function(r){return function(r,n,i,e){let s,o,h,u,f,c=\"\";const a=n/8,w=-1===i?3:0;for(s=0;s<a;s+=3)for(u=s+1<a?r[s+1>>>2]:0,f=s+2<a?r[s+2>>>2]:0,h=(r[s>>>2]>>>8*(w+i*(s%4))&255)<<16|(u>>>8*(w+i*((s+1)%4))&255)<<8|f>>>8*(w+i*((s+2)%4))&255,o=0;o<4;o+=1)c+=8*s+6*o<=n?t.charAt(h>>>6*(3-o)&63):e.b64Pad;return c}(r,e,s,o)};case\"BYTES\":return function(t){return function(t,r,n){let i,e,s=\"\";const o=r/8,h=-1===n?3:0;for(i=0;i<o;i+=1)e=t[i>>>2]>>>8*(h+n*(i%4))&255,s+=String.fromCharCode(e);return s}(t,e,s)};case\"ARRAYBUFFER\":try{new ArrayBuffer(0)}catch(t){throw new Error(r)}return function(t){return function(t,r,n){let i;const e=r/8,s=new ArrayBuffer(e),o=new Uint8Array(s),h=-1===n?3:0;for(i=0;i<e;i+=1)o[i]=t[i>>>2]>>>8*(h+n*(i%4))&255;return s}(t,e,s)};case\"UINT8ARRAY\":try{new Uint8Array(0)}catch(t){throw new Error(n)}return function(t){return function(t,r,n){let i;const e=r/8,s=-1===n?3:0,o=new Uint8Array(e);for(i=0;i<e;i+=1)o[i]=t[i>>>2]>>>8*(s+n*(i%4))&255;return o}(t,e,s)};default:throw new Error(\"format must be HEX, B64, BYTES, ARRAYBUFFER, or UINT8ARRAY\")}}const o=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298],h=[3238371032,914150663,812702999,4144912697,4290775857,1750603025,1694076839,3204075428],u=[1779033703,3144134277,1013904242,2773480762,1359893119,2600822924,528734635,1541459225];function f(t){const r={outputUpper:!1,b64Pad:\"=\",outputLen:-1},n=t||{},i=\"Output length must be a multiple of 8\";if(r.outputUpper=n.outputUpper||!1,n.b64Pad&&(r.b64Pad=n.b64Pad),n.outputLen){if(n.outputLen%8!=0)throw new Error(i);r.outputLen=n.outputLen}else if(n.shakeLen){if(n.shakeLen%8!=0)throw new Error(i);r.outputLen=n.shakeLen}if(\"boolean\"!=typeof r.outputUpper)throw new Error(\"Invalid outputUpper formatting option\");if(\"string\"!=typeof r.b64Pad)throw new Error(\"Invalid b64Pad formatting option\");return r}class c{constructor(t,r,n){const i=n||{};if(this.t=r,this.i=i.encoding||\"UTF8\",this.numRounds=i.numRounds||1,isNaN(this.numRounds)||this.numRounds!==parseInt(this.numRounds,10)||1>this.numRounds)throw new Error(\"numRounds must a integer >= 1\");this.o=t,this.h=[],this.u=0,this.l=!1,this.A=0,this.p=!1,this.U=[],this.R=[]}update(t){let r,n=0;const i=this.T>>>5,e=this.F(t,this.h,this.u),s=e.binLen,o=e.value,h=s>>>5;for(r=0;r<h;r+=i)n+this.T<=s&&(this.m=this.g(o.slice(r,r+i),this.m),n+=this.T);return this.A+=n,this.h=o.slice(n>>>5),this.u=s%this.T,this.l=!0,this}getHash(t,r){let n,i,e=this.H;const o=f(r);if(this.B){if(-1===o.outputLen)throw new Error(\"Output length must be specified in options\");e=o.outputLen}const h=s(t,e,this.v,o);if(this.p&&this.C)return h(this.C(o));for(i=this.Y(this.h.slice(),this.u,this.A,this.S(this.m),e),n=1;n<this.numRounds;n+=1)this.B&&e%32!=0&&(i[i.length-1]&=16777215>>>24-e%32),i=this.Y(i,e,0,this.I(this.o),e);return h(i)}setHMACKey(t,r,n){if(!this.L)throw new Error(\"Variant does not support HMAC\");if(this.l)throw new Error(\"Cannot set MAC key after calling update\");const i=e(r,(n||{}).encoding||\"UTF8\",this.v);this.M(i(t))}M(t){const r=this.T>>>3,n=r/4-1;let i;if(1!==this.numRounds)throw new Error(\"Cannot set numRounds with MAC\");if(this.p)throw new Error(\"MAC key already set\");for(r<t.binLen/8&&(t.value=this.Y(t.value,t.binLen,0,this.I(this.o),this.H));t.value.length<=n;)t.value.push(0);for(i=0;i<=n;i+=1)this.U[i]=909522486^t.value[i],this.R[i]=1549556828^t.value[i];this.m=this.g(this.U,this.m),this.A=this.T,this.p=!0}getHMAC(t,r){const n=f(r);return s(t,this.H,this.v,n)(this.N())}N(){let t;if(!this.p)throw new Error(\"Cannot call getHMAC without first setting MAC key\");const r=this.Y(this.h.slice(),this.u,this.A,this.S(this.m),this.H);return t=this.g(this.R,this.I(this.o)),t=this.Y(r,this.H,this.T,t,this.H),t}}function a(t,r){return t>>>r|t<<32-r}function w(t,r){return t>>>r}function E(t,r,n){return t&r^~t&n}function l(t,r,n){return t&r^t&n^r&n}function A(t){return a(t,2)^a(t,13)^a(t,22)}function p(t,r){const n=(65535&t)+(65535&r);return(65535&(t>>>16)+(r>>>16)+(n>>>16))<<16|65535&n}function U(t,r,n,i){const e=(65535&t)+(65535&r)+(65535&n)+(65535&i);return(65535&(t>>>16)+(r>>>16)+(n>>>16)+(i>>>16)+(e>>>16))<<16|65535&e}function d(t,r,n,i,e){const s=(65535&t)+(65535&r)+(65535&n)+(65535&i)+(65535&e);return(65535&(t>>>16)+(r>>>16)+(n>>>16)+(i>>>16)+(e>>>16)+(s>>>16))<<16|65535&s}function R(t){return a(t,7)^a(t,18)^w(t,3)}function y(t){return a(t,6)^a(t,11)^a(t,25)}function T(t){let r;return r=\"SHA-224\"==t?h.slice():u.slice(),r}function F(t,r){let n,i,e,s,h,u,f,c,T,F,b;const m=[];for(n=r[0],i=r[1],e=r[2],s=r[3],h=r[4],u=r[5],f=r[6],c=r[7],b=0;b<64;b+=1)m[b]=b<16?t[b]:U(a(g=m[b-2],17)^a(g,19)^w(g,10),m[b-7],R(m[b-15]),m[b-16]),T=d(c,y(h),E(h,u,f),o[b],m[b]),F=p(A(n),l(n,i,e)),c=f,f=u,u=h,h=p(s,T),s=e,e=i,i=n,n=p(T,F);var g;return r[0]=p(n,r[0]),r[1]=p(i,r[1]),r[2]=p(e,r[2]),r[3]=p(s,r[3]),r[4]=p(h,r[4]),r[5]=p(u,r[5]),r[6]=p(f,r[6]),r[7]=p(c,r[7]),r}class b extends c{constructor(t,r,n){if(\"SHA-224\"!==t&&\"SHA-256\"!==t)throw new Error(\"Chosen SHA variant is not supported\");super(t,r,n);const i=n||{};this.C=this.N,this.L=!0,this.v=-1,this.F=e(this.t,this.i,this.v),this.g=F,this.S=function(t){return t.slice()},this.I=T,this.Y=function(r,n,i,e){return function(t,r,n,i,e){let s,o;const h=15+(r+65>>>9<<4),u=r+n;for(;t.length<=h;)t.push(0);for(t[r>>>5]|=128<<24-r%32,t[h]=4294967295&u,t[h-1]=u/4294967296|0,s=0;s<t.length;s+=16)i=F(t.slice(s,s+16),i);return o=\"SHA-224\"===e?[i[0],i[1],i[2],i[3],i[4],i[5],i[6]]:i,o}(r,n,i,e,t)},this.m=T(t),this.T=512,this.H=\"SHA-224\"===t?224:256,this.B=!1,i.hmacKey&&this.M(function(t,r,n,i){const s=t+\" must include a value and format\";if(!r){if(!i)throw new Error(s);return i}if(void 0===r.value||!r.format)throw new Error(s);return e(r.format,r.encoding||\"UTF8\",n)(r.value)}(\"hmacKey\",i.hmacKey,this.v))}}export{b as default};\n","import JsSHA from \"jssha/dist/sha256\";\r\nimport { Base } from \"./base\";\r\n\r\nexport function applyMixins(derivedCtor: any, baseCtors: any[]) {\r\n baseCtors.forEach((baseCtor) => {\r\n Object.getOwnPropertyNames(baseCtor.prototype).forEach((name) => {\r\n Object.defineProperty(\r\n derivedCtor.prototype,\r\n name,\r\n Object.getOwnPropertyDescriptor(baseCtor.prototype, name),\r\n );\r\n });\r\n });\r\n}\r\n\r\nexport function encryptPassword(password: string, time: number) {\r\n let key = getSHA256(password);\r\n return getSHA256(time + key);\r\n\r\n function getSHA256(text) {\r\n let shaObj = new JsSHA(\"SHA-256\", \"TEXT\", { encoding: \"UTF8\" });\r\n shaObj.update(text);\r\n\r\n return shaObj.getHash(\"HEX\");\r\n }\r\n}\r\n\r\nexport function outputDebugURL(url: string, config: Base) {\r\n let label = \"javascript-ampache query URL\";\r\n\r\n if (config.useBearerToken) {\r\n label = \"(Using Bearer token, auth added for debugging) - \" + label;\r\n url += \"&auth=\" + config.sessionKey;\r\n }\r\n\r\n console.debug(\r\n label + \" %c\" + url,\r\n \"color: black; font-style: italic; background-color: orange;padding: 2px\",\r\n );\r\n}","import fetch from \"isomorphic-unfetch\";\r\nimport qs from \"querystringify\";\r\nimport { outputDebugURL } from \"./utils\";\r\n\r\ntype Config = {\r\n url: string;\r\n sessionKey?: string;\r\n useBearerToken?: boolean;\r\n debug?: boolean;\r\n};\r\n\r\nexport type Success = {\r\n success: string;\r\n};\r\n\r\n/**\r\n * @param [offset] Return results starting from this index position\r\n * @param [limit] Maximum number of results to return\r\n */\r\nexport type Pagination = {\r\n offset?: number;\r\n limit?: number;\r\n};\r\n\r\n/**\r\n * @param [offset] Return results starting from this index position\r\n * @param [limit] Maximum number of results to return\r\n * @param [cond] Apply additional filters to the browse using ; separated comma string pairs (e.g. 'filter1,value1;filter2,value2')\r\n * @param [sort] Sort name or comma-separated key pair. (e.g. 'name,order') Default order 'ASC' (e.g. 'name,ASC' == 'name')\r\n */\r\nexport type ExtendedPagination = Pagination & {\r\n cond?: string;\r\n sort?: string;\r\n};\r\n\r\nexport type BinaryBoolean = 0 | 1;\r\n\r\nexport type UID = string | number;\r\n\r\nexport abstract class Base {\r\n sessionKey: string;\r\n url: string;\r\n version: string = \"6.6.8\";\r\n useBearerToken: boolean;\r\n debug: boolean;\r\n\r\n constructor(config: Config) {\r\n this.sessionKey = config.sessionKey || null;\r\n this.url = config.url;\r\n this.useBearerToken = config.useBearerToken || false;\r\n this.debug = config.debug || false;\r\n }\r\n\r\n protected request<T>(endpoint: string): Promise<T> {\r\n let url =\r\n this.url +\r\n \"/server/json.server.php?action=\" +\r\n endpoint +\r\n \"&version=\" +\r\n this.version;\r\n\r\n if (!this.useBearerToken) {\r\n url += \"&auth=\" + this.sessionKey;\r\n }\r\n\r\n if (this.debug) {\r\n outputDebugURL(url, this);\r\n }\r\n\r\n return fetch(url, {\r\n method: \"GET\",\r\n headers: this.useBearerToken ? { Authorization: \"Bearer \" + this.sessionKey } : {},\r\n }).then((r) => {\r\n if (r.ok) {\r\n return r.json();\r\n }\r\n throw new Error(r.statusText);\r\n });\r\n }\r\n\r\n protected binary<T>(endpoint: string): Promise<Blob> {\r\n let url =\r\n this.url +\r\n \"/server/json.server.php?action=\" + endpoint +\r\n \"&version=\" + this.version;\r\n\r\n if (!this.useBearerToken) {\r\n url += \"&auth=\" + this.sessionKey;\r\n }\r\n\r\n if (this.debug) {\r\n outputDebugURL(url, this);\r\n }\r\n\r\n return fetch(url, {\r\n method: \"GET\",\r\n headers: this.useBearerToken ? { Authorization: \"Bearer \" + this.sessionKey } : {},\r\n })\r\n .then((response) => response.blob())\r\n .then((r) => {\r\n return r;\r\n });\r\n }\r\n\r\n public setSessionKey(sessionKey: string) {\r\n this.sessionKey = sessionKey;\r\n }\r\n\r\n /**\r\n * Construct and return a URL\r\n * @param endpoint\r\n * @param [params]\r\n */\r\n public rawURL(endpoint: string, params?: {}) {\r\n let query = endpoint;\r\n query += qs.stringify(params, \"&\");\r\n\r\n let url =\r\n this.url +\r\n \"/server/json.server.php?action=\" + query +\r\n \"&version=\" + this.version;\r\n\r\n if (!this.useBearerToken) {\r\n url += \"&auth=\" + this.sessionKey;\r\n }\r\n\r\n if (this.debug) {\r\n outputDebugURL(url, this);\r\n }\r\n\r\n return url;\r\n }\r\n}\r\n","import { Albums } from \"./albums\";\nimport { Artists } from \"./artists\";\nimport { Auth } from \"./auth\";\nimport { Bookmarks } from \"./bookmarks\";\nimport { Catalogs } from \"./catalogs\";\nimport { Genres } from \"./genres\";\nimport { Labels } from \"./labels\";\nimport { Licenses } from \"./licenses\";\nimport { LiveStreams } from \"./live-streams\";\nimport { Playlists } from \"./playlists\";\nimport { Podcasts } from \"./podcasts\";\nimport { Preferences } from \"./preferences\";\nimport { Shares } from \"./shares\";\nimport { Shouts } from \"./shouts\";\nimport { Songs } from \"./songs\";\nimport { System } from \"./system\";\nimport { Users } from \"./users\";\nimport { Videos } from \"./videos\";\nimport { applyMixins } from \"./utils\";\nimport { Base } from \"./base\";\n\nclass AmpacheAPI extends Base {}\ninterface AmpacheAPI\n extends Albums,\n Artists,\n Auth,\n Bookmarks,\n Catalogs,\n Genres,\n Labels,\n Licenses,\n LiveStreams,\n Playlists,\n Podcasts,\n Preferences,\n Shares,\n Shouts,\n Songs,\n System,\n Users,\n Videos {}\napplyMixins(AmpacheAPI, [\n Albums,\n Artists,\n Auth,\n Bookmarks,\n Catalogs,\n Genres,\n Labels,\n Licenses,\n LiveStreams,\n Playlists,\n Podcasts,\n Preferences,\n Shares,\n Shouts,\n Songs,\n System,\n Users,\n Videos,\n]);\n\nexport default AmpacheAPI;\n","import qs from \"querystringify\";\nimport { AlbumResponse, AlbumsResponse } from \"./types\";\nimport { Base, BinaryBoolean, ExtendedPagination, UID } from \"../base\";\n\nexport class Albums extends Base {\n /**\n * This returns albums based on the provided search filters\n * @remarks MINIMUM_API_VERSION=380001\n * @param [params.filter] UID to find\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\n * @param [params.add] ISO 8601 Date Format (2020-09-16) Find objects with an 'add' date newer than the specified date\n * @param [params.update] ISO 8601 Date Format (2020-09-16) Find objects with an 'update' time newer than the specified date\n * @param [params.include] albums, songs (include child objects in the response)\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#albums}\n */\n albums(\n params?: {\n filter?: number;\n exact?: BinaryBoolean;\n add?: Date;\n update?: Date;\n include?: \"albums\" | \"songs\";\n } & ExtendedPagination,\n ) {\n let query = \"albums\";\n query += qs.stringify(params, \"&\");\n return this.request<AlbumsResponse>(query);\n }\n\n /**\n * This returns a single album based on the UID provided\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.filter UID to find\n * @param [params.include] songs (include child objects in the response)\n * @see {@link https://ampache.org/api/api-json-methods#album}\n */\n album(params: { filter: UID; include?: \"songs\" }) {\n let query = \"album\";\n query += qs.stringify(params, \"&\");\n return this.request<AlbumResponse>(query);\n }\n\n /**\n * This returns the albums of an artist\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.filter UID to find\n * @param [params.album_artist] 0, 1 (if true filter for album artists only)\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#artist_albums}\n */\n artistAlbums(\n params: {\n filter: UID;\n album_artist?: BinaryBoolean;\n } & ExtendedPagination,\n ) {\n let query = \"artist_albums\";\n query += qs.stringify(params, \"&\");\n return this.request<AlbumsResponse>(query);\n }\n\n /**\n * This returns the albums associated with the genre in question\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.filter UID to find\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#genre_albums}\n */\n genreAlbums(\n params?: {\n filter: UID;\n } & ExtendedPagination,\n ) {\n let query = \"genre_albums\";\n query += qs.stringify(params, \"&\");\n return this.request<AlbumsResponse>(query);\n }\n}\n","import qs from \"querystringify\";\nimport { ArtistResponse, ArtistsResponse } from \"./types\";\nimport { Base, BinaryBoolean, ExtendedPagination, UID } from \"../base\";\n\nexport class Artists extends Base {\n /**\n * This takes a collection of inputs and returns artist objects\n * @remarks MINIMUM_API_VERSION=380001\n * @param [params.filter] Filter results to match this string\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\n * @param [params.add] ISO 8601 Date Format (2020-09-16) Find objects with an 'add' date newer than the specified date\n * @param [params.update] ISO 8601 Date Format (2020-09-16) Find objects with an 'update' time newer than the specified date\n * @param [params.include] (albums | songs) include child objects in the response\n * @param [params.album_artist] 0, 1 (if true filter for album artists only)\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#artists}\n */\n artists(\n params?: {\n filter?: string;\n exact?: BinaryBoolean;\n add?: Date;\n update?: Date;\n include?: \"albums\" | \"songs\";\n album_artist?: BinaryBoolean;\n } & ExtendedPagination,\n ) {\n let query = \"artists\";\n query += qs.stringify(params, \"&\");\n return this.request<ArtistsResponse>(query);\n }\n\n /**\n * This returns a single artist based on the UID of said artist\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.filter UID to find\n * @param [params.include] (albums | songs) include child objects in the response\n * @see {@link https://ampache.org/api/api-json-methods#artist}\n */\n artist(params: { filter: UID; include?: \"albums\" | \"songs\" }) {\n let query = \"artist\";\n query += qs.stringify(params, \"&\");\n return this.request<ArtistResponse>(query);\n }\n\n /**\n * This returns the artists associated with the genre in question as defined by the UID\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.filter UID to find\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#genre_artists}\n */\n genreArtists(\n params: {\n filter: UID;\n } & ExtendedPagination,\n ) {\n let query = \"genre_artists\";\n query += qs.stringify(params, \"&\");\n return this.request<ArtistsResponse>(query);\n }\n\n /**\n * This returns the artists associated with the label in question as defined by the UID\n * @remarks MINIMUM_API_VERSION=420000\n * @param params.filter UID of find\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#label_artists}\n */\n labelArtists(\n params: {\n filter: UID;\n } & ExtendedPagination,\n ) {\n let query = \"label_artists\";\n query += qs.stringify(params, \"&\");\n return this.request<ArtistsResponse>(query);\n }\n}\n","import JsSHA from \"jssha/dist/sha256\";\nimport qs from \"querystringify\";\nimport fetch from \"isomorphic-unfetch\";\nimport { Base, Success } from \"../base\";\nimport { AuthResponse } from \"./types\";\nimport { outputDebugURL } from \"../utils\";\n\nexport class Auth extends Base {\n /**\n * Handles verifying a new handshake\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.auth encrypted apikey OR password if using password auth\n * @param [params.user] username\n * @param [params.timestamp] UNIXTIME()\n * @param [params.version] version of Ampache API to establish connection with\n * @see {@link https://ampache.org/api/api-json-methods#handshake}\n */\n handshake(params: {\n auth: string;\n user?: string;\n timestamp?: number;\n version?: string;\n }) {\n let token = params.auth;\n\n // generate a timestamp if one wasn't provided\n if (!params.timestamp) {\n params.timestamp = Math.floor(new Date().getTime() / 1000);\n }\n\n // override the fallback API version with specified\n if (params.version) {\n this.version = params.version;\n }\n\n // drop timestamp if no user provided (i.e. logging in with API key)\n if (!params.user) {\n delete params.timestamp;\n }\n\n // not needed if using Bearer token\n if (this.useBearerToken) {\n delete params.auth;\n }\n\n let query = this.url + \"/server/json.server.php?action=handshake\";\n query += qs.stringify(params, \"&\");\n\n if (this.debug) {\n outputDebugURL(query, this);\n }\n\n return fetch(query, {\n method: \"GET\",\n headers: this.useBearerToken ? { Authorization: \"Bearer \" + token } : {},\n })\n .then((response) => response.json())\n .then((data) => {\n if (data.auth) {\n this.sessionKey = data.auth;\n }\n return <AuthResponse>data;\n });\n }\n\n /**\n * This can be called without being authenticated, it is useful for determining if what the status\n * of the server is, and what version it is running/compatible with\n * @remarks MINIMUM_API_VERSION=380001\n * @param [params.auth] (Session ID) returns version information and extends the session if passed\n * @param [params.version] API Version that the application understands\n * @see {@link https://ampache.org/api/api-json-methods#ping}\n */\n ping(params?: { auth?: string; version?: string }) {\n let query = \"ping\";\n query += qs.stringify(params, \"&\");\n return this.request<AuthResponse>(query);\n }\n\n /**\n * Destroy a session using the session auth parameter\n * @remarks MINIMUM_API_VERSION=400001\n * @param params.auth Session ID to destroy\n * @see {@link https://ampache.org/api/api-json-methods#goodbye}\n */\n goodbye(params: { auth: string }) {\n let query = \"goodbye\";\n query += qs.stringify(params, \"&\");\n return this.request<Success>(query);\n }\n\n /**\n * Email a new password to the user (if allowed) using a reset token.\n * @remarks MINIMUM_API_VERSION=6.1.0\n * @param params.auth Password reset token\n * @see {@link https://ampache.org/api/api-json-methods#lost_password}\n */\n lostPassword(params: { auth: string }) {\n let query = \"lost_password\";\n query += qs.stringify(params, \"&\");\n return this.request<Success>(query);\n }\n\n /**\n * Encrypt your password into the accepted format.\n */\n encryptPassword(params: { password: string; time: number }) {\n let key = getSHA256(params.password);\n return getSHA256(params.time + key);\n\n function getSHA256(text) {\n let shaObj = new JsSHA(\"SHA-256\", \"TEXT\", { encoding: \"UTF8\" });\n shaObj.update(text);\n\n return shaObj.getHash(\"HEX\");\n }\n }\n}\n","import qs from \"querystringify\";\r\nimport { BookmarkResponse, BookmarksResponse } from \"./types\";\r\nimport { Base, BinaryBoolean, Success, UID } from \"../base\";\r\n\r\nexport class Bookmarks extends Base {\r\n /**\r\n * Get a single bookmark by bookmark_id\r\n * @remarks MINIMUM_API_VERSION=6.1.0\r\n * @param params.filter UID to find\r\n * @param [params.include] 0,1, if true include the object in the bookmark\r\n * @see {@link https://ampache.org/api/api-json-methods#bookmark}\r\n */\r\n bookmark(params: { filter: UID; include?: BinaryBoolean }) {\r\n let query = \"bookmark\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<BookmarkResponse>(query);\r\n }\r\n\r\n /**\r\n * Get information about bookmarked media this user is allowed to manage\r\n * @remarks MINIMUM_API_VERSION=5.0.0\r\n * @param [params.client] filter by the agent/client name\r\n * @param [params.include] 0,1, if true include the object in the bookmark\r\n * @see {@link https://ampache.org/api/api-json-methods#bookmarks}\r\n */\r\n bookmarks(params: { client?: string; include?: BinaryBoolean }) {\r\n let query = \"bookmarks\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<BookmarksResponse>(query);\r\n }\r\n\r\n /**\r\n * Get the bookmark/s from its object_id and object_type.\r\n * @remarks MINIMUM_API_VERSION=5.0.0\r\n * @param params.filter UID to find\r\n * @param params.type Object type\r\n * @param [params.include] 0,1, if true include the object in the bookmark\r\n * @see {@link https://ampache.org/api/api-json-methods#get_bookmark}\r\n */\r\n getBookmark(params: {\r\n filter: UID;\r\n type: \"song\" | \"video\" | \"podcast_episode\";\r\n include?: BinaryBoolean;\r\n all?: BinaryBoolean;\r\n }) {\r\n let query = \"get_bookmark\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<BookmarkResponse>(query);\r\n }\r\n\r\n /**\r\n * Create a placeholder for the current media that you can return to later.\r\n * @remarks MINIMUM_API_VERSION=5.0.0\r\n * @param params.filter UID to find\r\n * @param params.type Object type\r\n * @param params.position current track time in seconds\r\n * @param [params.client] Agent string. (Default: 'AmpacheAPI')\r\n * @param [params.date] update time (Default: UNIXTIME())\r\n * @param [params.include] 0,1, if true include the object in the bookmark\r\n * @see {@link https://ampache.org/api/api-json-methods#bookmark_create}\r\n */\r\n bookmarkCreate(params: {\r\n filter: UID;\r\n type: \"song\" | \"video\" | \"podcast_episode\";\r\n position: number;\r\n client?: string;\r\n date?: number;\r\n include?: BinaryBoolean;\r\n }) {\r\n let query = \"bookmark_create\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<BookmarkResponse>(query);\r\n }\r\n\r\n /**\r\n * Edit a placeholder for the current media that you can return to later.\r\n * @remarks MINIMUM_API_VERSION=5.0.0\r\n * @param params.filter UID to find\r\n * @param params.type Object type\r\n * @param params.position current track time in seconds\r\n * @param [params.client] Agent string. (Default: 'AmpacheAPI')\r\n * @param [params.date] update time (Default: UNIXTIME())\r\n * @param [params.include] 0,1, if true include the object in the bookmark\r\n * @see {@link https://ampache.org/api/api-json-methods#bookmark_edit}\r\n */\r\n bookmarkEdit(params: {\r\n filter: UID;\r\n type: \"song\" | \"video\" | \"podcast_episode\";\r\n position: number;\r\n client?: string;\r\n date?: number;\r\n include?: BinaryBoolean;\r\n }) {\r\n let query = \"bookmark_edit\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<BookmarkResponse>(query);\r\n }\r\n\r\n /**\r\n * Delete an existing bookmark. (if it exists)\r\n * @remarks MINIMUM_API_VERSION=5.0.0\r\n * @param params.filter UID to find\r\n * @param params.type Object type\r\n * @param [params.client] Agent string. (Default: 'AmpacheAPI')\r\n @see {@link https://ampache.org/api/api-json-methods#bookmark_delete}\r\n */\r\n bookmarkDelete(params: {\r\n filter: UID;\r\n type: \"song\" | \"video\" | \"podcast_episode\";\r\n client?: string;\r\n }) {\r\n let query = \"bookmark_delete\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<Success>(query);\r\n }\r\n}\r\n","import qs from \"querystringify\";\r\nimport { CatalogResponse, CatalogsResponse } from \"./types\";\r\nimport { Base, ExtendedPagination, Success, UID } from \"../base\";\r\n\r\nexport class Catalogs extends Base {\r\n /**\r\n * This searches the catalogs and returns... catalogs\r\n * @remarks MINIMUM_API_VERSION=420000\r\n * @param [params.filter] Catalog type\r\n * @param [params.offset]\r\n * @param [params.limit]\r\n * @param [params.cond]\r\n * @param [params.sort]\r\n * @see {@link https://ampache.org/api/api-json-methods#catalogs}\r\n */\r\n catalogs(\r\n params?: {\r\n filter?:\r\n | \"music\"\r\n | \"clip\"\r\n | \"tvshow\"\r\n | \"movie\"\r\n | \"personal_video\"\r\n | \"podcast\";\r\n } & ExtendedPagination,\r\n ) {\r\n let query = \"catalogs\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<CatalogsResponse>(query);\r\n }\r\n\r\n /**\r\n * Return catalog by UID\r\n * @remarks MINIMUM_API_VERSION=420000\r\n * @param params.filter UID to find\r\n * @see {@link https://ampache.org/api/api-json-methods#catalog}\r\n */\r\n catalog(params: { filter: UID }) {\r\n let query = \"catalog\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<CatalogResponse>(query);\r\n }\r\n\r\n /**\r\n * Kick off a catalog update or clean for the selected catalog\r\n * ACCESS REQUIRED: 75 (Catalog Manager)\r\n * @remarks MINIMUM_API_VERSION=400001\r\n * @param params.task add_to_catalog, clean_catalog\r\n * @param params.catalog UID of catalog\r\n * @see {@link https://ampache.org/api/api-json-methods#catalog_action}\r\n */\r\n catalogAction(params: {\r\n task: \"add_to_catalog\" | \"clean_catalog\";\r\n catalog: UID;\r\n }) {\r\n let query = \"catalog_action\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<Success>(query);\r\n }\r\n\r\n /**\r\n * Perform actions on local catalog files. Single file versions of catalog add, clean, verify and remove (delete).\r\n * Make sure you remember to urlencode those file names!\r\n * ACCESS REQUIRED: 50 (Content Manager)\r\n * @remarks MINIMUM_API_VERSION=420000\r\n * @param params.file FULL path to local file\r\n * @param params.task add, clean, verify, remove, (can include comma-separated values)\r\n * @param params.catalog UID of catalog\r\n * @see {@link https://ampache.org/api/api-json-methods#catalog_file}\r\n */\r\n catalogFile(params: { file: string; task: string; catalog: UID }) {\r\n let query = \"catalog_file\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<Success>(query);\r\n }\r\n\r\n /**\r\n * Create a new catalog.\r\n * ACCESS REQUIRED: 75 (Catalog Manager)\r\n * @remarks MINIMUM_API_VERSION=6.0.0\r\n * @param params.name Name for the catalog\r\n * @param params.path URL or folder path for your catalog\r\n * @param [params.type] Default: 'local'\r\n * @param [params.media_type] Default: 'music'\r\n * @param [params.file_pattern] Pattern used identify tags from the file name. Default: '%T - %t'\r\n * @param [params.folder_pattern] Pattern used identify tags from the folder name. Default: '%a/%A'\r\n * @param [params.username] login to remote catalog\r\n * @param [params.password] password to remote catalog\r\n * @see {@link https://ampache.org/api/api-json-methods#catalog_add}\r\n */\r\n catalogAdd(params: {\r\n name: string;\r\n path: string;\r\n type?:\r\n | \"local\"\r\n | \"beets\"\r\n | \"remote\"\r\n | \"subsonic\"\r\n | \"seafile\"\r\n | \"beetsremote\";\r\n media_type?:\r\n | \"music\"\r\n | \"podcast\"\r\n | \"clip\"\r\n | \"tvshow\"\r\n | \"movie\"\r\n | \"personal_video\";\r\n file_pattern?: string;\r\n folder_pattern?: string;\r\n username?: string;\r\n password?: string;\r\n }) {\r\n let query = \"catalog_add\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<CatalogResponse>(query);\r\n }\r\n\r\n /**\r\n * Delete an existing catalog. (if it exists)\r\n * ACCESS REQUIRED: 75 (Catalog Manager)\r\n * @remarks MINIMUM_API_VERSION=6.0.0\r\n * @param params.filter ID of the catalog\r\n * @see {@link https://ampache.org/api/api-json-methods#catalog_delete}\r\n */\r\n catalogDelete(params: { filter: UID }) {\r\n let query = \"catalog_delete\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<Success>(query);\r\n }\r\n}\r\n","import qs from \"querystringify\";\nimport { GenreResponse, GenresResponse } from \"./types\";\nimport { Base, BinaryBoolean, ExtendedPagination, UID } from \"../base\";\n\nexport class Genres extends Base {\n /**\n * This returns the genres (Tags) based on the specified filter\n * @remarks MINIMUM_API_VERSION=380001\n * @param [params.filter] UID to find\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#genres}\n */\n genres(\n params?: {\n filter?: string;\n exact?: BinaryBoolean;\n } & ExtendedPagination,\n ) {\n let query = \"genres\";\n query += qs.stringify(params, \"&\");\n return this.request<GenresResponse>(query);\n }\n\n /**\n * This returns a single genre based on UID\n * @remarks MINIMUM_API_VERSION=380001\n * @param params.filter UID to find\n * @see {@link https://ampache.org/api/api-json-methods#genre}\n */\n genre(params: { filter: UID }) {\n let query = \"genre\";\n query += qs.stringify(params, \"&\");\n return this.request<GenreResponse>(query);\n }\n}\n","import qs from \"querystringify\";\nimport { LabelResponse, LabelsResponse } from \"./types\";\nimport { Base, BinaryBoolean, ExtendedPagination, UID } from \"../base\";\n\nexport class Labels extends Base {\n /**\n * This returns labels based on the specified filter\n * @remarks MINIMUM_API_VERSION=420000\n * @param [params.filter] Filter results to match this string\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\n * @param [params.add] ISO 8601 Date Format (2020-09-16) Find objects with an 'add' date newer than the specified date\n * @param [params.update] ISO 8601 Date Format (2020-09-16) Find objects with an 'update' time newer than the specified date\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#labels}\n */\n labels(\n params?: {\n filter?: string;\n exact?: BinaryBoolean;\n add?: Date;\n update?: Date;\n } & ExtendedPagination,\n ) {\n let query = \"labels\";\n query += qs.stringify(params, \"&\");\n return this.request<LabelsResponse>(query);\n }\n\n /**\n * This returns a single label\n * @remarks MINIMUM_API_VERSION=420000\n * @param params.filter UID to find\n * @see {@link https://ampache.org/api/api-json-methods#label}\n */\n label(params: { filter: UID }) {\n let query = \"label\";\n query += qs.stringify(params, \"&\");\n return this.request<LabelResponse>(query);\n }\n}\n","import qs from \"querystringify\";\nimport { LicenseResponse, LicensesResponse } from \"./types\";\nimport { Base, BinaryBoolean, ExtendedPagination, UID } from \"../base\";\n\nexport class Licenses extends Base {\n /**\n * This returns licenses based on the specified filter\n * @remarks MINIMUM_API_VERSION=420000\n * @param [params.filter] Filter results to match this string\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\n * @param [params.add] ISO 8601 Date Format (2020-09-16) Find objects with an 'add' date newer than the specified date\n * @param [params.update] ISO 8601 Date Format (2020-09-16) Find objects with an 'update' time newer than the specified date\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#licenses}\n */\n licenses(\n params?: {\n filter?: string;\n exact?: BinaryBoolean;\n add?: Date;\n update?: Date;\n } & ExtendedPagination,\n ) {\n let query = \"licenses\";\n query += qs.stringify(params, \"&\");\n return this.request<LicensesResponse>(query);\n }\n\n /**\n * This returns a single license\n * @remarks MINIMUM_API_VERSION=420000\n * @param params.filter UID to find\n * @see {@link https://ampache.org/api/api-json-methods#license}\n */\n license(params: { filter: UID }) {\n let query = \"license\";\n query += qs.stringify(params, \"&\");\n return this.request<LicenseResponse>(query);\n }\n}\n","import qs from \"querystringify\";\nimport { LiveStreamResponse, LiveStreamsResponse } from \"./types\";\nimport { Base, BinaryBoolean, ExtendedPagination, Success, UID } from \"../base\";\n\nexport class LiveStreams extends Base {\n /**\n * This returns live_streams based on the specified filter\n * @remarks MINIMUM_API_VERSION=5.1.0\n * @param [params.filter] Filter results to match this string\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\n * @param [params.add] ISO 8601 Date Format (2020-09-16) Find objects with an 'add' date newer than the specified date\n * @param [params.update] ISO 8601 Date Format (2020-09-16) Find objects with an 'update' time newer than the specified date\n * @param [params.offset]\n * @param [params.limit]\n * @param [params.cond]\n * @param [params.sort]\n * @see {@link https://ampache.org/api/api-json-methods#live_streams}\n */\n liveStreams(\n params?: {\n filter?: string;\n exact?: BinaryBoolean;\n add?: Date;\n update?: Date;\n } & ExtendedPagination,\n ) {\n let query = \"live_streams\";\n query += qs.stringify(params, \"&\");\n return this.request<LiveStreamsResponse>(query);\n }\n\n /**\n * This returns a single live_stream\n * @remarks MINIMUM_API_VERSION=5.1.0\n * @param params.filter UID to find\n * @see {@link https://ampache.org/api/api-json-methods#live_stream}\n */\n liveStream(params: { filter: UID }) {\n let query = \"live_stream\";\n query += qs.stringify(params, \"&\");\n return this.request<LiveStreamResponse>(query);\n }\n\n /**\n * Create a live_stream (radio station) object.\n * ACCESS REQUIRED: 50 (Content Manager)\n * @remarks MINIMUM_API_VERSION=6.0.0\n * @param params.name Stream title\n * @param params.url URL of the http/s stream\n * @param params.codec Stream codec\n * @param params.catalog Catalog ID to associate with this stream\n * @param [params.site_url] Homepage URL of the stream\n * @see {@link https://ampache.org/api/api-json-methods#live_stream_create}\n */\n liveStreamCreate(params: {\n name: string;\n url: string;\n codec: \"mp3\" | \"flac\" | \"ogg\" | \"vorbis\" | \"opus\" | \"aac\" | \"alac\";\n catalog: string;\n site_url?: string;\n }) {\n let query = \"live_stream_create\";\n query += qs.stringify(params, \"&\");\n return this.request<LiveStreamResponse>(query);\n }\n\n /**\n * Edit a live_stream (radio station) object.\n * ACCESS REQUIRED: 50 (Content Manager)\n * @remarks MINIMUM_API_VERSION=6.0.0\n * @param params.filter Object to find\n * @param [params.name] Stream title\n * @param [params.url] URL of the http/s stream\n * @param [params.codec] Stream codec\n * @param [params.catalog] Catalog ID to associate with this stream\n * @param [params.site_url] Homepage URL of the stream\n * @see {@link https://ampache.org/api/api-json-methods#live_stream_edit}\n */\n liveStreamEdit(params: {\n filter: string;\n name?: string;\n url?: string;\n codec?: \"mp3\" | \"flac\" | \"ogg\" | \"vorbis\" | \"opus\" | \"aac\" | \"alac\";\n catalog?: string;\n site_url?: string;\n }) {\n let query = \"live_stream_edit\";\n query += qs.stringify(params, \"&\");\n return this.request<LiveStreamResponse>(query);\n }\n\n /**\n * Delete a live_stream (radio station) object (if it exists)\n * ACCESS REQUIRED: 50 (Content Manager)\n * @remarks MINIMUM_API_VERSION=6.0.0\n * @param params.filter Object to find\n * @see {@link https://ampache.org/api/api-json-methods#live_stream_delete}\n */\n liveStreamDelete(params: { filter: string }) {\n let query = \"live_stream_delete\";\n query += qs.stringify(params, \"&\");\n return this.request<Success>(query);\n }\n}\n","import qs from \"querystringify\";\r\nimport { HashResponse, PlaylistResponse, PlaylistsResponse } from \"./types\";\r\nimport { SongsResponse } from \"../songs/types\";\r\nimport {\r\n Base,\r\n BinaryBoolean,\r\n ExtendedPagination,\r\n Pagination,\r\n Success,\r\n UID,\r\n} from \"../base\";\r\n\r\nexport class Playlists extends Base {\r\n /**\r\n * This returns playlists based on the specified filter\r\n * @remarks MINIMUM_API_VERSION=380001\r\n * @param [params.filter] Filter results to match this string\r\n * @param [params.exact] 0, 1 (if true filter is exact = rather than fuzzy LIKE)\r\n * @param [params.add] ISO 8601 Date Format (2020-09-16) Find objects with an 'add' date newer than the specified date\r\n * @param [params.update] ISO 8601 Date Format (2020-09-16) Find objects with an 'update' time newer than the specified date\r\n * @param [params.hide_search] 0, 1 (if true do not include searches/smartlists in the result)\r\n * @param [params.show_dupes] 0, 1 (if true ignore 'api_hide_dupe_searches' setting)\r\n * @param [params.include] 0, 1 (if true include the objects in the playlist)\r\n * @param [params.offset]\r\n * @param [params.limit]\r\n * @param [params.cond]\r\n * @param [params.sort]\r\n * @see {@link https://ampache.org/api/api-json-methods#playlists}\r\n */\r\n playlists(\r\n params?: {\r\n filter?: string;\r\n exact?: BinaryBoolean;\r\n add?: Date;\r\n update?: Date;\r\n hide_search?: BinaryBoolean;\r\n show_dupes?: BinaryBoolean;\r\n include?: BinaryBoolean;\r\n } & ExtendedPagination,\r\n ) {\r\n let query = \"playlists\";\r\n query += qs.stringify(params, \"&\");\r\n return this.request<PlaylistsResponse>(query);\r\n }\r\n\r\n /**\r\n * This returns smartlists based on the specified filter. NOTE: Filtered from Playlists() so pagination is invalid.\r\n * @remarks MINIMUM_API_VERSION=380001\r\n * @param [params.filt