@dchighs/dc-assets 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Marcuth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/dragon-flash-animation-downloader.d.ts

@@ -0,0 +1,16 @@
+import { StaticFileDownloader } from "./static-file-downloader";
+export type DragonFlashAnimationDownloaderOptions = {
+    imageName: string;
+    phase: number;
+    skin?: string;
+    platformPrefix?: string;
+};
+export declare class DragonFlashAnimationDownloader extends StaticFileDownloader {
+    readonly imageName: string;
+    readonly phase: number;
+    readonly skin?: string;
+    readonly platformPrefix?: string;
+    readonly url: string;
+    constructor({ imageName, phase, skin, platformPrefix, }: DragonFlashAnimationDownloaderOptions);
+    download(filePath: string): Promise<string>;
+}

package/dist/dragon-flash-animation-downloader.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DragonFlashAnimationDownloader = void 0;
+const dc_core_1 = require("@dchighs/dc-core");
+const static_file_downloader_1 = require("./static-file-downloader");
+class DragonFlashAnimationDownloader extends static_file_downloader_1.StaticFileDownloader {
+    constructor({ imageName, phase, skin, platformPrefix, }) {
+        var _a;
+        super();
+        this.imageName = imageName;
+        this.phase = phase;
+        this.skin = skin;
+        this.platformPrefix = platformPrefix || dc_core_1.StaticFileUrlPlatformPrefix.Default;
+        const adjustedSkin = (_a = this.skin) !== null && _a !== void 0 ? _a : "";
+        this.url = `https://${this.platformPrefix}-static-s1.socialpointgames.com/static/dragoncity/assets/sprites/${this.imageName}${adjustedSkin}_${this.phase}.swf`;
+    }
+    async download(filePath) {
+        return await super.download(this.url, filePath);
+    }
+}
+exports.DragonFlashAnimationDownloader = DragonFlashAnimationDownloader;

package/dist/dragon-spine-animation-downloader.d.ts

@@ -0,0 +1,20 @@
+import { StaticFileDownloader } from "./static-file-downloader";
+export type DragonSpineAnimationDownloaderOptions = {
+    imageName: string;
+    phase: number;
+    skin?: string;
+    textureCompressionFormat?: string;
+    platformPrefix?: string;
+    useNewUrlFormat?: boolean;
+};
+export declare class DragonSpineAnimationDownloader extends StaticFileDownloader {
+    readonly imageName: string;
+    readonly phase: number;
+    readonly skin?: string;
+    readonly textureCompressionFormat: string;
+    readonly platformPrefix: string;
+    readonly useNewUrlFormat: boolean;
+    readonly url: string;
+    constructor({ imageName, phase, skin, textureCompressionFormat, platformPrefix, useNewUrlFormat }: DragonSpineAnimationDownloaderOptions);
+    download(filePath: string): Promise<string>;
+}

package/dist/dragon-spine-animation-downloader.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DragonSpineAnimationDownloader = void 0;
+const dc_core_1 = require("@dchighs/dc-core");
+const static_file_downloader_1 = require("./static-file-downloader");
+class DragonSpineAnimationDownloader extends static_file_downloader_1.StaticFileDownloader {
+    constructor({ imageName, phase, skin, textureCompressionFormat, platformPrefix, useNewUrlFormat }) {
+        var _a;
+        super();
+        this.imageName = imageName;
+        this.phase = phase;
+        this.skin = skin;
+        this.textureCompressionFormat = textureCompressionFormat || dc_core_1.TextureCompressionFormat.Default;
+        this.platformPrefix = platformPrefix || dc_core_1.StaticFileUrlPlatformPrefix.Default;
+        this.useNewUrlFormat = useNewUrlFormat !== null && useNewUrlFormat !== void 0 ? useNewUrlFormat : true;
+        const adjustedSkin = (_a = this.skin) !== null && _a !== void 0 ? _a : "";
+        if (this.useNewUrlFormat) {
+            this.url = `https://${this.platformPrefix}-static-s1.socialpointgames.com/static/dragoncity/mobile/engine/version_1_1/dragons/${this.imageName}${adjustedSkin}_${this.phase}/${this.imageName}${adjustedSkin}_${this.phase}_HD_tweened_${this.textureCompressionFormat}.zip`;
+        }
+        else {
+            this.url = `https://${this.platformPrefix}-static-s1.socialpointgames.com/static/dragoncity/mobile/engine/version_1_1/dragons/${this.imageName}${adjustedSkin}_${this.phase}/basic_${this.imageName}${skin}_${phase}_HD_spine-3-8-59_${this.textureCompressionFormat}.zip`;
+        }
+    }
+    async download(filePath) {
+        return await super.download(this.url, filePath);
+    }
+}
+exports.DragonSpineAnimationDownloader = DragonSpineAnimationDownloader;

package/dist/dragon-sprite-downloader.d.ts

@@ -0,0 +1,18 @@
+import { StaticFileDownloader } from "./static-file-downloader";
+export type DragonSpriteDownloaderOptions = {
+    imageQuality?: string;
+    imageName: string;
+    phase: number;
+    skin?: string;
+    platformPrefix?: string;
+};
+export declare class DragonSpriteDownloader extends StaticFileDownloader {
+    readonly platformPrefix: string;
+    readonly imageQuality: string;
+    readonly imageName: string;
+    readonly phase: number;
+    readonly skin?: string;
+    readonly url: string;
+    constructor({ imageQuality, imageName, phase, skin, platformPrefix, }: DragonSpriteDownloaderOptions);
+    download(filePath: string): Promise<string>;
+}

package/dist/dragon-sprite-downloader.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DragonSpriteDownloader = void 0;
+const dc_core_1 = require("@dchighs/dc-core");
+const static_file_downloader_1 = require("./static-file-downloader");
+class DragonSpriteDownloader extends static_file_downloader_1.StaticFileDownloader {
+    constructor({ imageQuality, imageName, phase, skin, platformPrefix, }) {
+        var _a;
+        super();
+        this.imageName = imageName;
+        this.imageQuality = imageQuality !== null && imageQuality !== void 0 ? imageQuality : dc_core_1.DragonSpriteQuality.Default;
+        this.platformPrefix = platformPrefix || dc_core_1.StaticFileUrlPlatformPrefix.Default;
+        this.phase = phase;
+        this.skin = skin;
+        const adjustedSkin = (_a = this.skin) !== null && _a !== void 0 ? _a : "";
+        this.url = `https://${this.platformPrefix}-static-s1.socialpointgames.com/static/dragoncity/mobile/ui/dragons/ui_${this.imageName}${adjustedSkin}_${this.phase}${this.imageQuality}.png`;
+    }
+    async download(filePath) {
+        return await super.download(this.url, filePath);
+    }
+}
+exports.DragonSpriteDownloader = DragonSpriteDownloader;

package/dist/dragon-thumbnail-downloader.d.ts

@@ -0,0 +1,16 @@
+import { StaticFileDownloader } from "./static-file-downloader";
+export type DragonThumbnailDownloaderOptions = {
+    imageName: string;
+    phase: number;
+    skin?: string;
+    platformPrefix?: string;
+};
+export declare class DragonThumbnailDownloader extends StaticFileDownloader {
+    readonly platformPrefix: string;
+    readonly imageName: string;
+    readonly phase: number;
+    readonly skin?: string;
+    readonly url: string;
+    constructor({ imageName, phase, skin, platformPrefix }: DragonThumbnailDownloaderOptions);
+    download(filePath: string): Promise<string>;
+}

package/dist/dragon-thumbnail-downloader.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DragonThumbnailDownloader = void 0;
+const dc_core_1 = require("@dchighs/dc-core");
+const static_file_downloader_1 = require("./static-file-downloader");
+class DragonThumbnailDownloader extends static_file_downloader_1.StaticFileDownloader {
+    constructor({ imageName, phase, skin, platformPrefix }) {
+        var _a;
+        super();
+        this.imageName = imageName;
+        this.platformPrefix = platformPrefix || dc_core_1.StaticFileUrlPlatformPrefix.Default;
+        this.phase = phase;
+        this.skin = skin;
+        const adjustedSkin = (_a = this.skin) !== null && _a !== void 0 ? _a : "";
+        this.url = `https://${this.platformPrefix}-static-s1.socialpointgames.com/static/dragoncity/mobile/ui/dragons/HD/thumb_${this.imageName}_${this.phase}${adjustedSkin}.png`;
+    }
+    async download(filePath) {
+        return await super.download(this.url, filePath);
+    }
+}
+exports.DragonThumbnailDownloader = DragonThumbnailDownloader;

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { DragonFlashAnimationDownloader, DragonFlashAnimationDownloaderOptions } from "./dragon-flash-animation-downloader";
+import { DragonSpineAnimationDownloader, DragonSpineAnimationDownloaderOptions } from "./dragon-spine-animation-downloader";
+import { DragonSpriteDownloader, DragonSpriteDownloaderOptions } from "./dragon-sprite-downloader";
+import { DragonThumbnailDownloader, DragonThumbnailDownloaderOptions } from "./dragon-thumbnail-downloader";
+import { IslandPackageDownloader, IslandPackageDownloaderOptions } from "./island-package-downloader";
+import { MusicDownloader, MusicDownloaderOptions } from "./music-downloader";
+declare const dcAssets: {
+    dragons: {
+        animations: {
+            flash: (options: DragonFlashAnimationDownloaderOptions) => DragonFlashAnimationDownloader;
+            spine: (options: DragonSpineAnimationDownloaderOptions) => DragonSpineAnimationDownloader;
+        };
+        sprite: (options: DragonSpriteDownloaderOptions) => DragonSpriteDownloader;
+        thumbnail: (options: DragonThumbnailDownloaderOptions) => DragonThumbnailDownloader;
+    };
+    islands: {
+        package: (options: IslandPackageDownloaderOptions) => IslandPackageDownloader;
+    };
+    sounds: {
+        music: (options: MusicDownloaderOptions) => MusicDownloader;
+    };
+};
+export * from "./dragon-flash-animation-downloader";
+export * from "./static-file-downloader";
+export * from "./dragon-spine-animation-downloader";
+export * from "./dragon-sprite-downloader";
+export * from "./island-package-downloader";
+export * from "./music-downloader";
+export default dcAssets;

package/dist/index.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dragon_flash_animation_downloader_1 = require("./dragon-flash-animation-downloader");
+const dragon_spine_animation_downloader_1 = require("./dragon-spine-animation-downloader");
+const dragon_sprite_downloader_1 = require("./dragon-sprite-downloader");
+const dragon_thumbnail_downloader_1 = require("./dragon-thumbnail-downloader");
+const island_package_downloader_1 = require("./island-package-downloader");
+const music_downloader_1 = require("./music-downloader");
+const dcAssets = {
+    dragons: {
+        animations: {
+            flash: (options) => new dragon_flash_animation_downloader_1.DragonFlashAnimationDownloader(options),
+            spine: (options) => new dragon_spine_animation_downloader_1.DragonSpineAnimationDownloader(options)
+        },
+        sprite: (options) => new dragon_sprite_downloader_1.DragonSpriteDownloader(options),
+        thumbnail: (options) => new dragon_thumbnail_downloader_1.DragonThumbnailDownloader(options),
+    },
+    islands: {
+        package: (options) => new island_package_downloader_1.IslandPackageDownloader(options)
+    },
+    sounds: {
+        music: (options) => new music_downloader_1.MusicDownloader(options)
+    }
+};
+__exportStar(require("./dragon-flash-animation-downloader"), exports);
+__exportStar(require("./static-file-downloader"), exports);
+__exportStar(require("./dragon-spine-animation-downloader"), exports);
+__exportStar(require("./dragon-sprite-downloader"), exports);
+__exportStar(require("./island-package-downloader"), exports);
+__exportStar(require("./music-downloader"), exports);
+exports.default = dcAssets;

package/dist/island-package-downloader.d.ts

@@ -0,0 +1,11 @@
+import { StaticFileDownloader } from "./static-file-downloader";
+export type IslandPackageDownloaderOptions = {
+    islandType?: string;
+    fileName?: string;
+    path?: string;
+};
+export declare class IslandPackageDownloader extends StaticFileDownloader {
+    readonly url: string;
+    constructor({ fileName, path, islandType }: IslandPackageDownloaderOptions);
+    download(filePath: string): Promise<string>;
+}

package/dist/island-package-downloader.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IslandPackageDownloader = void 0;
+const dc_core_1 = require("@dchighs/dc-core");
+const static_file_downloader_1 = require("./static-file-downloader");
+class IslandPackageDownloader extends static_file_downloader_1.StaticFileDownloader {
+    constructor({ fileName, path, islandType }) {
+        super();
+        if (!path && !islandType && !fileName) {
+            throw new Error("Either path, islandType or fileName must be provided.");
+        }
+        if (path) {
+            const items = path.split("/");
+            islandType = items[3];
+            fileName = items[4];
+        }
+        if (islandType === dc_core_1.IslandType.GridIslands && !fileName.endsWith("_optim.zip")) {
+            fileName = fileName.replace(".zip", "_optim.zip");
+        }
+        this.url = `https://www.socialpointgames.com/static/dragoncity/mobile/ui/${islandType === dc_core_1.IslandType.HeroicRaces ? "heroicraces_islands" : "islands"}/HD/dxt5/${fileName}`;
+    }
+    async download(filePath) {
+        return await super.download(this.url, filePath);
+    }
+}
+exports.IslandPackageDownloader = IslandPackageDownloader;

package/dist/music-downloader.d.ts

@@ -0,0 +1,12 @@
+import { StaticFileDownloader } from "./static-file-downloader";
+export type MusicDownloaderOptions = {
+    platformPrefix?: string;
+    keyName: string;
+};
+export declare class MusicDownloader extends StaticFileDownloader {
+    readonly platformPrefix: string;
+    readonly keyName: string;
+    readonly url: string;
+    constructor({ platformPrefix, keyName }: MusicDownloaderOptions);
+    download(filePath: string): Promise<string>;
+}

package/dist/music-downloader.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MusicDownloader = void 0;
+const dc_core_1 = require("@dchighs/dc-core");
+const static_file_downloader_1 = require("./static-file-downloader");
+class MusicDownloader extends static_file_downloader_1.StaticFileDownloader {
+    constructor({ platformPrefix, keyName }) {
+        super();
+        this.keyName = keyName;
+        this.platformPrefix = platformPrefix || dc_core_1.StaticFileUrlPlatformPrefix.Default;
+        this.url = `http://${this.platformPrefix}-static-s1.socialpointgames.com/static/dragoncity/mobile/sounds/music/${this.keyName}.mp3`;
+    }
+    async download(filePath) {
+        return await super.download(this.url, filePath);
+    }
+}
+exports.MusicDownloader = MusicDownloader;

package/dist/static-file-downloader.d.ts

@@ -0,0 +1,3 @@
+export declare class StaticFileDownloader {
+    download(url: string, filePath: string): Promise<string>;
+}

package/dist/static-file-downloader.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaticFileDownloader = void 0;
+const axios_1 = __importDefault(require("axios"));
+const node_fs_1 = __importDefault(require("node:fs"));
+class StaticFileDownloader {
+    async download(url, filePath) {
+        const response = await axios_1.default.get(url, { responseType: "arraybuffer" });
+        await node_fs_1.default.promises.writeFile(filePath, response.data);
+        return filePath;
+    }
+}
+exports.StaticFileDownloader = StaticFileDownloader;

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@dchighs/dc-assets",
+  "version": "0.0.1",
+  "description": "Library focused on downloading static files from the Dragon City server.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/*",
+    "!/**/__tests__"
+  ],
+  "scripts": {
+    "test": "jest",
+    "build": "tsc"
+  },
+  "keywords": [
+    "dragon city",
+    "dc",
+    "core",
+    "dc highs"
+  ],
+  "author": "Marcutyh",
+  "license": "MIT",
+  "type": "commonjs",
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "axios": "^1.13.2"
+  },
+  "peerDependencies": {
+    "@dchighs/dc-core": "^0.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DC-Highs/dc-assets.git"
+  }
+}