downlynpm 1.0.0

package/README

@@ -0,0 +1,80 @@
+# downly
+
+Node.js SDK for [downly.web.id](https://downly.web.id) — Social media video & audio downloader.
+
+## Installation
+
+```bash
+npm install downly
+```
+
+## Usage
+
+```js
+const { download, detectPlatform } = require('downly');
+
+// Download
+const result = await download('https://www.tiktok.com/@khaby.lame/video/123');
+
+console.log(result.downloadUrl);   // Direct download URL (expires in 1 hour)
+console.log(result.filename);      // 'tiktok-video.mp4'
+console.log(result.thumbnail);     // Thumbnail URL or null
+console.log(result.platform);      // 'tiktok'
+console.log(result.expiresAt);     // '2026-01-01T00:00:00+00:00'
+console.log(result.rateLimit);     // { remaining: 1, resetAt: '...' }
+
+// Detect platform without downloading
+const platform = detectPlatform('https://youtu.be/dQw4w9WgXcQ');
+console.log(platform); // 'youtube'
+```
+
+## Supported Platforms
+
+| Platform | URL Example |
+|----------|-------------|
+| TikTok | `tiktok.com/@user/video/...` |
+| YouTube | `youtube.com/watch?v=...`, `youtu.be/...`, `youtube.com/shorts/...` |
+| Twitter / X | `twitter.com/...`, `x.com/...` |
+| Facebook | `facebook.com/...`, `fb.watch/...` |
+| Spotify | `open.spotify.com/track/...` |
+| Instagram | `instagram.com/reel/...`, `instagram.com/p/...` |
+
+## Error Handling
+
+```js
+const { download, DownlyError } = require('downly');
+
+try {
+  const result = await download('https://www.tiktok.com/@user/video/123');
+  console.log(result.downloadUrl);
+} catch (err) {
+  if (err instanceof DownlyError) {
+    console.error(err.message);     // Error message
+    console.error(err.code);        // 'RATE_LIMITED' | 'DOWNLOAD_FAILED' | 'NETWORK_ERROR' | 'TIMEOUT' | 'INVALID_URL'
+    console.error(err.platform);    // 'tiktok' | 'youtube' | etc.
+  }
+}
+```
+
+## Error Codes
+
+| Code | Description |
+|------|-------------|
+| `INVALID_URL` | URL kosong atau format tidak valid |
+| `DOWNLOAD_FAILED` | Platform tidak support atau konten private |
+| `RATE_LIMITED` | Melebihi limit 2 request/menit |
+| `NETWORK_ERROR` | Gagal konek ke server |
+| `TIMEOUT` | Request timeout (default 30s) |
+
+## Notes
+
+- Download URL expire dalam **1 jam**
+- Rate limit: **2 request/menit** per IP
+- File disimpan di server downly.web.id, bukan di device lo
+- No API key needed
+
+## Links
+
+- Website: [downly.web.id](https://downly.web.id)
+- Author: [zatzd](https://github.com/zatzd)
+- Support: [saweria.co/ZATT](https://saweria.co/ZATT)

package/index.js

@@ -0,0 +1,133 @@
+'use strict';
+
+const https = require('https');
+const http = require('http');
+
+const BASE_URL = 'https://downly.web.id/api.php';
+
+/**
+ * Downly SDK - Node.js
+ * Social media downloader wrapper for downly.web.id
+ */
+
+class DownlyError extends Error {
+  constructor(message, code, platform) {
+    super(message);
+    this.name = 'DownlyError';
+    this.code = code || 'UNKNOWN_ERROR';
+    this.platform = platform || null;
+  }
+}
+
+/**
+ * Make a POST request
+ * @param {string} url
+ * @param {object} body
+ * @returns {Promise<object>}
+ */
+function post(url, body) {
+  return new Promise((resolve, reject) => {
+    const payload = JSON.stringify(body);
+    const parsed  = new URL(url);
+    const lib     = parsed.protocol === 'https:' ? https : http;
+
+    const options = {
+      hostname: parsed.hostname,
+      port    : parsed.port || (parsed.protocol === 'https:' ? 443 : 80),
+      path    : parsed.pathname,
+      method  : 'POST',
+      headers : {
+        'Content-Type'  : 'application/json',
+        'Content-Length': Buffer.byteLength(payload),
+        'User-Agent'    : 'downly-node-sdk/1.0.0',
+      },
+    };
+
+    const req = lib.request(options, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        try {
+          resolve({ status: res.statusCode, body: JSON.parse(data) });
+        } catch {
+          reject(new DownlyError('Invalid JSON response', 'PARSE_ERROR'));
+        }
+      });
+    });
+
+    req.on('error', err => reject(new DownlyError(err.message, 'NETWORK_ERROR')));
+    req.setTimeout(30000, () => {
+      req.destroy();
+      reject(new DownlyError('Request timeout', 'TIMEOUT'));
+    });
+
+    req.write(payload);
+    req.end();
+  });
+}
+
+/**
+ * Download media from social media URL
+ * @param {string} url - Social media post URL
+ * @returns {Promise<DownlyResult>}
+ *
+ * @typedef {Object} DownlyResult
+ * @property {string} status - 'success'
+ * @property {string} downloadUrl - Direct download URL (hosted on downly.web.id)
+ * @property {string} filename - Suggested filename
+ * @property {string|null} thumbnail - Thumbnail URL
+ * @property {string} platform - Detected platform
+ * @property {string} expiresAt - ISO 8601 expiry time (1 hour)
+ * @property {object} rateLimit - { remaining, resetAt }
+ */
+async function download(url) {
+  if (!url || typeof url !== 'string') {
+    throw new DownlyError('URL is required', 'INVALID_URL');
+  }
+
+  try { new URL(url); } catch {
+    throw new DownlyError('Invalid URL format', 'INVALID_URL');
+  }
+
+  const res = await post(BASE_URL, { url });
+
+  if (res.status === 429) {
+    throw new DownlyError(
+      res.body.error || 'Rate limit exceeded',
+      'RATE_LIMITED',
+      res.body.platform
+    );
+  }
+
+  if (res.status !== 200 || res.body.error) {
+    throw new DownlyError(
+      res.body.error || 'Download failed',
+      'DOWNLOAD_FAILED',
+      res.body.platform
+    );
+  }
+
+  return res.body;
+}
+
+/**
+ * Detect platform from URL without downloading
+ * @param {string} url
+ * @returns {string}
+ */
+function detectPlatform(url) {
+  try {
+    const host = new URL(url).hostname.replace(/^(www\.|m\.)/, '');
+    if (host.includes('instagram.com')) return 'instagram';
+    if (host.includes('tiktok.com'))    return 'tiktok';
+    if (host.includes('twitter.com') || host.includes('x.com')) return 'twitter';
+    if (host.includes('youtube.com') || host.includes('youtu.be')) return 'youtube';
+    if (host.includes('facebook.com') || host.includes('fb.watch')) return 'facebook';
+    if (host.includes('spotify.com'))   return 'spotify';
+    return 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+module.exports = { download, detectPlatform, DownlyError };

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "downlynpm",
+  "version": "1.0.0",
+  "description": "Node.js SDK for downly.web.id — social media downloader",
+  "main": "index.js",
+  "keywords": [
+    "downloader",
+    "tiktok",
+    "instagram",
+    "youtube",
+    "twitter",
+    "facebook",
+    "spotify"
+  ],
+  "author": "zatzd",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zatzd/downly"
+  },
+  "homepage": "https://downly.web.id",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}