@uploadista/core 0.0.2

package/src/utils/throttle.test.ts

@@ -0,0 +1,101 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { throttle } from "./throttle";
+
+describe("throttle", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("should throttle function calls", () => {
+    const mockFn = vi.fn();
+    const throttledFn = throttle(mockFn, 100);
+
+    throttledFn();
+    expect(mockFn).toHaveBeenCalledOnce(); // Leading call
+
+    throttledFn();
+    throttledFn();
+    expect(mockFn).toHaveBeenCalledOnce(); // Still only one call
+
+    vi.advanceTimersByTime(100);
+    expect(mockFn).toHaveBeenCalledTimes(2); // Trailing call executed
+  });
+
+  it("should respect leading option when set to false", () => {
+    const mockFn = vi.fn();
+    const throttledFn = throttle(mockFn, 100, { leading: false });
+
+    throttledFn();
+    expect(mockFn).not.toHaveBeenCalled(); // No leading call
+
+    vi.advanceTimersByTime(100);
+    expect(mockFn).toHaveBeenCalledOnce(); // Trailing call executed
+  });
+
+  it("should respect trailing option when set to false", () => {
+    const mockFn = vi.fn();
+    const throttledFn = throttle(mockFn, 100, { trailing: false });
+
+    throttledFn();
+    expect(mockFn).toHaveBeenCalledOnce(); // Leading call
+
+    throttledFn();
+    vi.advanceTimersByTime(100);
+    expect(mockFn).toHaveBeenCalledOnce(); // No trailing call
+  });
+
+  it("should use default options when none provided", () => {
+    const mockFn = vi.fn();
+    const throttledFn = throttle(mockFn, 100);
+
+    throttledFn();
+    expect(mockFn).toHaveBeenCalledOnce(); // leading: true by default
+
+    throttledFn();
+    vi.advanceTimersByTime(100);
+    expect(mockFn).toHaveBeenCalledTimes(2); // trailing: true by default
+  });
+
+  it("should preserve function arguments", () => {
+    const mockFn = vi.fn();
+    const throttledFn = throttle(mockFn, 100);
+
+    throttledFn("arg1", "arg2", 123);
+    expect(mockFn).toHaveBeenCalledWith("arg1", "arg2", 123);
+  });
+
+  it("should preserve function context (this)", () => {
+    const obj = {
+      value: 42,
+      fn: vi.fn(function (this: { value: number }) {
+        return this.value;
+      }),
+    };
+
+    const throttledFn = throttle(obj.fn, 100);
+    throttledFn.call(obj);
+
+    expect(obj.fn).toHaveBeenCalledOnce();
+  });
+
+  it("should handle multiple rapid calls within throttle period", () => {
+    const mockFn = vi.fn();
+    const throttledFn = throttle(mockFn, 100);
+
+    // Make 5 rapid calls
+    for (let i = 0; i < 5; i++) {
+      throttledFn(i);
+    }
+
+    expect(mockFn).toHaveBeenCalledOnce(); // Only leading call
+    expect(mockFn).toHaveBeenCalledWith(0); // First call's arguments
+
+    vi.advanceTimersByTime(100);
+    expect(mockFn).toHaveBeenCalledTimes(2); // Trailing call executed
+    expect(mockFn).toHaveBeenLastCalledWith(4); // Last call's arguments
+  });
+});

package/src/utils/throttle.ts

@@ -0,0 +1,29 @@
+import { debounce } from "./debounce.js";
+
+export function throttle<T, A extends unknown[], Return>(
+  fn: (this: T, ...args: A) => Return,
+  wait: number,
+  {
+    leading = true,
+    trailing = true,
+  }: { leading?: boolean; trailing?: boolean } = {},
+) {
+  return debounce(fn, wait, {
+    leading,
+    trailing,
+  });
+}
+
+/**
+ * Effect-based throttle utilities
+ */
+export const ThrottleEffect = {
+  /**
+   * Creates a legacy throttle function wrapper
+   * @param fn - Function to throttle
+   * @param wait - Wait time in milliseconds
+   * @param options - Throttle options
+   * @returns Throttled function
+   */
+  legacy: throttle,
+};

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "extends": "@uploadista/typescript-config/base.json",
+  "compilerOptions": {
+    "baseUrl": "./",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "typeRoots": ["../../../node_modules/@types"]
+  },
+  "include": ["src"],
+  "exclude": [
+    "src/**/*.test.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.ts",
+    "src/**/*.spec.tsx",
+    "src/**/__tests__/**"
+  ]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts","./src/errors/index.ts","./src/errors/uploadista-error.ts","./src/flow/edge.ts","./src/flow/event.ts","./src/flow/flow-server.ts","./src/flow/flow.ts","./src/flow/index.ts","./src/flow/node.ts","./src/flow/parallel-scheduler.ts","./src/flow/typed-flow.ts","./src/flow/nodes/index.ts","./src/flow/nodes/input-node.ts","./src/flow/nodes/storage-node.ts","./src/flow/nodes/transform-node.ts","./src/flow/plugins/credential-provider.ts","./src/flow/plugins/image-ai-plugin.ts","./src/flow/plugins/image-plugin.ts","./src/flow/plugins/zip-plugin.ts","./src/flow/plugins/types/describe-image-node.ts","./src/flow/plugins/types/index.ts","./src/flow/plugins/types/optimize-node.ts","./src/flow/plugins/types/remove-background-node.ts","./src/flow/plugins/types/resize-node.ts","./src/flow/types/flow-file.ts","./src/flow/types/flow-job.ts","./src/flow/types/flow-types.ts","./src/flow/types/index.ts","./src/flow/types/run-args.ts","./src/flow/types/type-validator.ts","./src/flow/utils/resolve-upload-metadata.ts","./src/logger/logger.ts","./src/streams/stream-limiter.ts","./src/types/data-store.ts","./src/types/event-broadcaster.ts","./src/types/event-emitter.ts","./src/types/index.ts","./src/types/input-file.ts","./src/types/kv-store.ts","./src/types/middleware.ts","./src/types/upload-event.ts","./src/types/upload-file.ts","./src/types/websocket.ts","./src/upload/convert-to-stream.ts","./src/upload/create-upload.ts","./src/upload/index.ts","./src/upload/mime.ts","./src/upload/upload-chunk.ts","./src/upload/upload-server.ts","./src/upload/upload-strategy-negotiator.ts","./src/upload/upload-url.ts","./src/upload/write-to-store.ts","./src/utils/checksum.ts","./src/utils/debounce.ts","./src/utils/generate-id.ts","./src/utils/md5.ts","./src/utils/once.ts","./src/utils/throttle.ts"],"version":"5.9.3"}

package/tsdown.config.ts

@@ -0,0 +1,25 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: {
+    index: "src/index.ts",
+    "errors/index": "src/errors/index.ts",
+    "types/index": "src/types/index.ts",
+    "flow/index": "src/flow/index.ts",
+    "upload/index": "src/upload/index.ts",
+    "logger/logger": "src/logger/logger.ts",
+    "streams/multi-stream": "src/streams/multi-stream.ts",
+    "streams/stream-limiter": "src/streams/stream-limiter.ts",
+    "streams/stream-splitter": "src/streams/stream-splitter.ts",
+    "utils/debounce": "src/utils/debounce.ts",
+    "utils/generate-id": "src/utils/generate-id.ts",
+    "utils/md5": "src/utils/md5.ts",
+    "utils/once": "src/utils/once.ts",
+    "utils/semaphore": "src/utils/semaphore.ts",
+    "utils/throttle": "src/utils/throttle.ts",
+  },
+  minify: true,
+  format: ["esm", "cjs"],
+  dts: true,
+  outDir: "dist",
+});

package/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    exclude: ['node_modules', 'dist'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: ['node_modules/', 'dist/', '**/*.d.ts', '**/*.test.ts', '**/*.spec.ts']
+    }
+  }
+});