Convert tenor to klipy outright since tenor shut down last night...

This commit is contained in:
Rory&
2026-07-07 19:32:26 +02:00
parent 0943b10065
commit 73fe4f4cd0
6 changed files with 207 additions and 140 deletions
@@ -29,7 +29,7 @@ public class GifTests(ITestOutputHelper testOutputHelper, TestFixture fixture) :
}
// wish this could just be a single string.... MEmberData requires returning an array spanning the argument count...
public static IEnumerable<string[]> GifProviders() => [["tenor"]];
public static IEnumerable<string[]> GifProviders() => [["klipy"]];
public static IEnumerable<object[]> GifSearchTestMatrix() {
foreach (var query in (string[])["meow", "meowmeow"])
@@ -42,6 +42,7 @@ public class GifTests(ITestOutputHelper testOutputHelper, TestFixture fixture) :
var resp = await Assert.HttpSuccess(await Client.ApiHttpClient.GetAsync($"gifs/search?q={query}&provider={provider}", TestContext.Current.CancellationToken));
var respContent = await resp.Content.ReadFromJsonAsync<List<GifItem>>(cancellationToken: TestContext.Current.CancellationToken);
_testOutputHelper.WriteLine($"Got {respContent!.Count} results");
Assert.True(respContent!.Count > 0, "respContent.Count > 0");
Assert.All(respContent, gif => {
Assert.StringNotNullOrWhitespace(gif.Id);
@@ -59,7 +60,8 @@ public class GifTests(ITestOutputHelper testOutputHelper, TestFixture fixture) :
var resp = await Assert.HttpSuccess(await Client.ApiHttpClient.GetAsync($"gifs/trending?provider={provider}", TestContext.Current.CancellationToken));
var respContent = await resp.Content.ReadFromJsonAsync<TrendingGifsResult>(cancellationToken: TestContext.Current.CancellationToken);
Assert.True(respContent!.Categories.Count > 0, "respContent.Categories.Count > 0");
_testOutputHelper.WriteLine($"Got {respContent!.Categories.Count} categories and {respContent.Gifs.Count} gifs");
Assert.True(respContent.Categories.Count > 0, "respContent.Categories.Count > 0");
Assert.True(respContent.Gifs.Count > 0, "respContent.Gifs.Count > 0");
Assert.All(respContent.Categories, cat => {
@@ -83,6 +85,7 @@ public class GifTests(ITestOutputHelper testOutputHelper, TestFixture fixture) :
var resp = await Assert.HttpSuccess(await Client.ApiHttpClient.GetAsync($"gifs/trending-gifs?provider={provider}", TestContext.Current.CancellationToken));
var respContent = await resp.Content.ReadFromJsonAsync<List<GifItem>>(cancellationToken: TestContext.Current.CancellationToken);
_testOutputHelper.WriteLine($"Got {respContent!.Count} results");
Assert.True(respContent!.Count > 0, "respContent.Count > 0");
Assert.All(respContent, gif => {
Assert.StringNotNullOrWhitespace(gif.Id);
@@ -0,0 +1,168 @@
/*
Spacebar: A FOSS re-implementation and extension of the Discord.com backend.
Copyright (C) 2026 Spacebar and Spacebar Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
import fs from "node:fs/promises";
import type { GifsResponse, GifTrendingCategory, GifMediaTypes, GifResponse } from "@spacebar/schemas";
import { Config } from "@spacebar/util";
import { SingletonCache, TimeSpan } from "@spacebar/extensions";
import type { IGifProvider } from "../IGifProvider";
const TRENDING_CATEGORIES_CACHE_DURATION = TimeSpan.fromSeconds(24 * 60 * 60); // 1 day
const TRENDING_GIFS_CACHE_DURATION = TimeSpan.fromSeconds(60 * 60); // 1 hour
// Klipy v1 API
export default class KlipyGifProvider implements IGifProvider {
id = "klipy";
available = true;
#apiKey: string;
#trendingCategoryCache = new SingletonCache<GifTrendingCategory[]>(TRENDING_CATEGORIES_CACHE_DURATION);
#trendingGifsCache = new SingletonCache<GifsResponse>(TRENDING_GIFS_CACHE_DURATION);
async init(): Promise<void> {
if (!Config.get().integrations.gifs.klipy.enabled) {
this.available = false;
return;
}
let apiKey = Config.get().integrations.gifs.klipy.apiKey;
if (!apiKey) {
const path = Config.get().integrations.gifs.klipy.apiKeyPath;
if (!(path && (await fs.stat(path)))) {
console.warn("[KlipyGifProvider] Klipy integration is enabled but no API key was provided, disabling...");
this.available = false;
return;
}
apiKey = (await fs.readFile(path, "utf-8")).trim();
}
this.#apiKey = apiKey;
console.log("[KlipyGifProvider] Hellorld!");
}
async search(query: { q: string; limit?: number; media_format: string; locale: string }): Promise<GifsResponse> {
query.media_format ??= "gif";
query.locale ??= "en";
const response = await fetch(`https://api.klipy.com/api/v1/${this.#apiKey}/gifs/search?q=${query.q}&locale=${query.locale}`, {
method: "get",
headers: { "Content-Type": "application/json" },
});
if (!response.ok) console.log(response, await response.text());
const responseData = (await response.json()) as KlipyTrendingResponse;
return responseData.data.data.map(this.convertGifResult);
}
async getTrendingCategories(query: { locale: string }): Promise<GifTrendingCategory[]> {
return await this.#trendingCategoryCache.getOrUpdate(async () => {
// query.media_format ??= "gif";
query.locale ??= "en";
const response = await fetch(`https://api.klipy.com/api/v1/${this.#apiKey}/gifs/categories?locale=${query.locale}`, {
method: "get",
headers: { "Content-Type": "application/json" },
});
if (!response.ok) console.log(response, await response.text());
const responseData = (await response.json()) as KlipyCategoriesResponse;
return responseData.data.categories.map((x) => ({
name: x.query,
src: x.preview_url,
})) satisfies GifTrendingCategory[];
});
}
async getTrendingGifs(query: { media_format: string; locale: string }): Promise<GifsResponse> {
return await this.#trendingGifsCache.getOrUpdate(async () => {
// query.media_format ??= "gif";
query.locale ??= "en";
const response = await fetch(`https://api.klipy.com/api/v1/${this.#apiKey}/gifs/trending?locale=${query.locale}`, {
method: "get",
headers: {
"Content-Type": "application/json",
Accept: "application/json",
},
});
if (!response.ok) console.log(response, await response.text());
const responseData = (await response.json()) as KlipyTrendingResponse;
return responseData.data.data.map(this.convertGifResult);
});
}
private convertGifResult(result: KlipyMediaItem) {
return {
id: result.id.toString(),
title: result.title,
url: result.slug, //?
src: result.file.hd.mp4.url,
gif_src: result.file.hd.gif.url,
width: result.file.hd.gif.width,
height: result.file.hd.gif.height,
preview: result.file.hd.gif.url,
} satisfies GifResponse;
}
}
// API response types
interface KlipyCategoriesResponse {
result: boolean;
data: { locale: string; categories: KlipyCategory[] };
}
interface KlipyCategory {
category: string;
query: string;
preview_url: string;
}
interface KlipyTrendingResponse {
result: boolean;
data: { current_page: number; per_page: number; has_next: boolean; data: KlipyMediaItem[] };
}
interface KlipyMediaItem {
id: number;
slug: string;
title: string;
file: KlipyFile;
tags: string[];
type: string;
blur_preview: string;
}
interface KlipyFile {
hd: KlipyFileSize;
md: KlipyFileSize;
sm: KlipyFileSize;
xs: KlipyFileSize;
}
interface KlipyFileSize {
gif: KlipyFileInfo;
webp: KlipyFileInfo;
jpg: KlipyFileInfo;
mp4: KlipyFileInfo;
webm: KlipyFileInfo;
}
interface KlipyFileInfo {
url: string;
width: number;
height: number;
size: number;
}
@@ -1,138 +0,0 @@
/*
Spacebar: A FOSS re-implementation and extension of the Discord.com backend.
Copyright (C) 2026 Spacebar and Spacebar Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
import type { IGifProvider } from "../IGifProvider";
import { GifsResponse, GifTrendingCategory, GifMediaTypes } from "@spacebar/schemas";
import { Config } from "@spacebar/util";
import { SingletonCache, TimeSpan } from "@spacebar/extensions";
const TRENDING_CATEGORIES_CACHE_DURATION = TimeSpan.fromSeconds(24 * 60 * 60); // 1 day
const TRENDING_GIFS_CACHE_DURATION = TimeSpan.fromSeconds(60 * 60); // 1 hour
// Tenor V1 API... Not yet shut down as of writing, but is going soon...
export default class TenorGifProvider implements IGifProvider {
id = "tenor";
available = true;
#apiKey: string;
#trendingCategoryCache = new SingletonCache<GifTrendingCategory[]>(TRENDING_CATEGORIES_CACHE_DURATION);
#trendingGifsCache = new SingletonCache<GifsResponse>(TRENDING_GIFS_CACHE_DURATION);
async init(): Promise<void> {
if (!(Config.get().gif.enabled && Config.get().gif.apiKey)) {
this.available = false;
return;
}
this.#apiKey = Config.get().gif.apiKey!;
console.log("[TenorGifProvider] Hellorld!");
}
async search(query: { q: string; limit?: number; media_format: string; locale: string }): Promise<GifsResponse> {
const response = await fetch(`https://g.tenor.com/v1/search?q=${query.q}&media_format=${query.media_format}&locale=${query.locale}&key=${this.#apiKey}`, {
method: "get",
headers: { "Content-Type": "application/json" },
});
const responseData = (await response.json()) as TenorSearchResults;
return responseData.results.map(this.convertGifResult);
}
async getTrendingCategories(query: { media_format: string; locale: string }): Promise<GifTrendingCategory[]> {
return await this.#trendingCategoryCache.getOrUpdate(async () => {
const response = await fetch(`https://g.tenor.com/v1/categories?locale=${query.locale}&key=${this.#apiKey}`, {
method: "get",
headers: { "Content-Type": "application/json" },
});
const responseData = (await response.json()) as TenorCategoriesResults;
return responseData.tags.map((x) => ({
name: x.searchterm,
src: x.image,
})) satisfies GifTrendingCategory[];
});
}
async getTrendingGifs(query: { media_format: string; locale: string }): Promise<GifsResponse> {
return await this.#trendingGifsCache.getOrUpdate(async () => {
const response = await fetch(`https://g.tenor.com/v1/trending?media_format=${query.media_format}&locale=${query.locale}&key=${this.#apiKey}`, {
method: "get",
headers: { "Content-Type": "application/json" },
});
console.log(response);
const responseData = (await response.json()) as TenorTrendingResults;
return responseData.results.map(this.convertGifResult);
});
}
private convertGifResult(result: TenorGif) {
return {
id: result.id,
title: result.title,
url: result.itemurl,
src: result.media[0].mp4.url,
gif_src: result.media[0].gif.url,
width: result.media[0].mp4.dims[0],
height: result.media[0].mp4.dims[1],
preview: result.media[0].mp4.preview,
};
}
}
// API response types
type TenorGif = {
created: number;
hasaudio: boolean;
id: string;
media: { [type in keyof typeof GifMediaTypes]: TenorMedia }[];
tags: string[];
title: string;
itemurl: string;
hascaption: boolean;
url: string;
};
type TenorMedia = {
preview: string;
url: string;
dims: number[];
size: number;
};
type TenorCategory = {
searchterm: string;
path: string;
image: string;
name: string;
};
type TenorCategoriesResults = {
tags: TenorCategory[];
};
type TenorTrendingResults = {
next: string;
results: TenorGif[];
locale: string;
};
type TenorSearchResults = {
next: string;
results: TenorGif[];
};
+2
View File
@@ -28,6 +28,7 @@ import {
GeneralConfiguration,
GifConfiguration,
GuildConfiguration,
IntegrationConfiguration,
LimitsConfiguration,
LoginConfiguration,
OffloadConfiguration,
@@ -63,4 +64,5 @@ export class ConfigValue {
offload: OffloadConfiguration = new OffloadConfiguration();
components = new ComponentConfiguration();
embeds = new EmbedConfiguration();
integrations = new IntegrationConfiguration();
}
@@ -0,0 +1,31 @@
/*
Spacebar: A FOSS re-implementation and extension of the Discord.com backend.
Copyright (C) 2026 Spacebar and Spacebar Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
export class IntegrationConfiguration {
gifs: GifIntegrationConfiguration = new GifIntegrationConfiguration();
}
export class GifIntegrationConfiguration {
klipy: GenericGifIntegrationConfiguration = new GenericGifIntegrationConfiguration();
}
export class GenericGifIntegrationConfiguration {
enabled: boolean = false;
apiKey?: string;
apiKeyPath?: string;
}
+1
View File
@@ -25,6 +25,7 @@ export * from "./ExternalTokensConfiguration";
export * from "./GeneralConfiguration";
export * from "./GifConfiguration";
export * from "./GuildConfiguration";
export * from "./IntegrationConfiguration";
export * from "./LimitConfigurations";
export * from "./OffloadConfiguration";
export * from "./LoginConfiguration";