ezthrottle 1.0.0 → 1.1.1

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "ezthrottle",
-  "version": "1.0.0",
-  "description": "Node.js SDK for EZThrottle - The World's First API Aqueduct",
-  "main": "src/index.js",
+  "version": "1.1.1",
+  "description": "Node.js SDK for EZThrottle - The API Dam for rate-limited services",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
     "test": "node test/client.test.js"
   },
   "keywords": [
@@ -11,7 +14,8 @@
     "rate-limiting",
     "api",
     "queue",
-    "tracktags"
+    "tracktags",
+    "typescript"
   ],
   "author": "TrackTags",
   "license": "MIT",
@@ -19,8 +23,19 @@
     "type": "git",
     "url": "https://github.com/rjpruitt16/ezthrottle-node"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "dependencies": {
-    "node-fetch": "^2.7.0"
+    "node-fetch": "^2.7.0",
+    "uuid": "^8.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/node-fetch": "^2.6.0",
+    "@types/uuid": "^8.3.0",
+    "typescript": "^5.0.0"
   },
   "engines": {
     "node": ">=14.0.0"

package/examples/basic.js

@@ -1,43 +0,0 @@
-const { EZThrottle, RateLimitError } = require('../src');
-
-async function main() {
-  const client = new EZThrottle({
-    apiKey: process.env.TRACKTAGS_API_KEY || 'ck_live_cust_XXX_YYY',
-  });
-
-  try {
-    console.log('Queueing request...');
-    
-    const result = await client.queueRequest({
-      url: 'https://api.example.com/data',
-      webhookUrl: 'https://myapp.com/webhook',
-      method: 'GET',
-      metadata: {
-        userId: '12345',
-        requestId: 'abc-123',
-      },
-    });
-
-    console.log('Job queued successfully:', result);
-    console.log('Job ID:', result.job_id);
-
-  } catch (error) {
-    if (error instanceof RateLimitError) {
-      console.error('Rate limited!');
-      console.error('Error:', error.message);
-      console.error('Retry at:', new Date(error.retryAt));
-      
-      const waitMs = error.retryAt - Date.now();
-      console.log(`Wait ${Math.ceil(waitMs / 1000)} seconds before retrying`);
-      
-    } else {
-      console.error('Error:', error.message);
-    }
-  }
-}
-
-if (require.main === module) {
-  main().catch(console.error);
-}
-
-module.exports = { main };

package/src/client.js

@@ -1,136 +0,0 @@
-const fetch = require('node-fetch');
-const { EZThrottleError, TimeoutError, RateLimitError } = require('./errors');
-
-class EZThrottle {
-  constructor({ apiKey, tracktagsUrl, ezthrottleUrl }) {
-    if (!apiKey) {
-      throw new Error('apiKey is required');
-    }
-
-    this.apiKey = apiKey;
-    this.tracktagsUrl = tracktagsUrl || 'https://tracktags.fly.dev';
-    this.ezthrottleUrl = ezthrottleUrl || 'https://ezthrottle.fly.dev';
-  }
-
-  async queueRequest({ url, webhookUrl, method = 'GET', headers, body, metadata, retryAt }) {
-    const jobPayload = {
-      url,
-      webhook_url: webhookUrl,
-      method: method.toUpperCase(),
-    };
-
-    if (headers) jobPayload.headers = headers;
-    if (body) jobPayload.body = body;
-    if (metadata) jobPayload.metadata = metadata;
-    if (retryAt !== undefined) jobPayload.retry_at = retryAt;
-
-    const proxyPayload = {
-      scope: 'customer',
-      metric_name: '',
-      target_url: `${this.ezthrottleUrl}/api/v1/jobs`,
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(jobPayload),
-    };
-
-    const response = await fetch(`${this.tracktagsUrl}/api/v1/proxy`, {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${this.apiKey}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(proxyPayload),
-    });
-
-    if (response.status === 429) {
-      const errorData = await response.json();
-      const retryAfterSeconds = response.headers.get('retry-after');
-      let calculatedRetryAt = errorData.retry_at;
-
-      if (retryAfterSeconds && !calculatedRetryAt) {
-        calculatedRetryAt = Date.now() + (parseInt(retryAfterSeconds) * 1000);
-      }
-
-      throw new RateLimitError(
-        `Rate limited: ${errorData.error || 'Unknown error'}`,
-        calculatedRetryAt
-      );
-    }
-
-    if (response.status !== 200) {
-      const text = await response.text();
-      throw new EZThrottleError(`Proxy request failed: ${text}`);
-    }
-
-    const proxyResponse = await response.json();
-
-    if (proxyResponse.status !== 'allowed') {
-      throw new EZThrottleError(
-        `Request denied: ${proxyResponse.error || 'Unknown error'}`
-      );
-    }
-
-    const forwarded = proxyResponse.forwarded_response || {};
-
-    if (forwarded.status_code !== 201) {
-      throw new EZThrottleError(
-        `EZThrottle job creation failed: ${forwarded.body || 'Unknown error'}`
-      );
-    }
-
-    const ezthrottleResponse = JSON.parse(forwarded.body || '{}');
-    return ezthrottleResponse;
-  }
-
-  async request({ url, method = 'GET', headers, body }) {
-    return fetch(url, {
-      method,
-      headers,
-      body,
-    });
-  }
-
-  async queueAndWait({
-    url,
-    webhookUrl,
-    method = 'GET',
-    headers,
-    body,
-    metadata,
-    retryAt,
-    timeout = 300000,
-    pollInterval = 2000,
-  }) {
-    const result = await this.queueRequest({
-      url,
-      webhookUrl,
-      method,
-      headers,
-      body,
-      metadata,
-      retryAt,
-    });
-
-    const jobId = result.job_id;
-    if (!jobId) {
-      throw new EZThrottleError('No job_id in response');
-    }
-
-    const startTime = Date.now();
-
-    return new Promise((resolve, reject) => {
-      const checkResult = async () => {
-        if (Date.now() - startTime > timeout) {
-          reject(new TimeoutError(`Timeout waiting for job ${jobId}`));
-          return;
-        }
-        setTimeout(checkResult, pollInterval);
-      };
-      checkResult();
-    });
-  }
-}
-
-module.exports = EZThrottle;

package/src/errors.js

@@ -1,27 +0,0 @@
-class EZThrottleError extends Error {
-  constructor(message, retryAt = null) {
-    super(message);
-    this.name = 'EZThrottleError';
-    this.retryAt = retryAt;
-  }
-}
-
-class TimeoutError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = 'TimeoutError';
-  }
-}
-
-class RateLimitError extends EZThrottleError {
-  constructor(message, retryAt) {
-    super(message, retryAt);
-    this.name = 'RateLimitError';
-  }
-}
-
-module.exports = {
-  EZThrottleError,
-  TimeoutError,
-  RateLimitError,
-};

package/src/index.js

@@ -1,11 +0,0 @@
-const EZThrottle = require('./client');
-const { EZThrottleError, TimeoutError, RateLimitError } = require('./errors');
-
-module.exports = {
-  EZThrottle,
-  EZThrottleError,
-  TimeoutError,
-  RateLimitError,
-};
-
-module.exports.default = EZThrottle;