@offlinejs/benchmarks 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { StorageAdapter, EntityRecord } from '@offlinejs/types';
+
+interface BenchmarkResult {
+    durationMs: number;
+    name: string;
+    records: number;
+    throughputPerSecond?: number;
+}
+interface AdapterBenchmarkOptions {
+    collection?: string;
+    records?: number;
+    storage: StorageAdapter;
+}
+interface BenchmarkSuiteResult {
+    find: BenchmarkResult;
+    indexedFind?: BenchmarkResult;
+    writes: BenchmarkResult;
+}
+declare const createBenchmarkRecord: (index: number) => EntityRecord;
+declare const benchmarkAdapterWrites: (options: AdapterBenchmarkOptions) => Promise<BenchmarkResult>;
+declare const benchmarkAdapterBatchWrites: (options: AdapterBenchmarkOptions & {
+    batchSize?: number;
+}) => Promise<BenchmarkResult>;
+declare const benchmarkAdapterFind: (options: AdapterBenchmarkOptions) => Promise<BenchmarkResult>;
+declare const benchmarkIndexedFind: (options: AdapterBenchmarkOptions) => Promise<BenchmarkResult>;
+/** Seed + write/find suite sized for 100k-record adapter comparisons. */
+declare const runAdapterBenchmarkSuite: (options: AdapterBenchmarkOptions) => Promise<BenchmarkSuiteResult>;
+declare const formatBenchmarkResult: (result: BenchmarkResult) => string;
+
+export { type AdapterBenchmarkOptions, type BenchmarkResult, type BenchmarkSuiteResult, benchmarkAdapterBatchWrites, benchmarkAdapterFind, benchmarkAdapterWrites, benchmarkIndexedFind, createBenchmarkRecord, formatBenchmarkResult, runAdapterBenchmarkSuite };

package/dist/index.js

@@ -0,0 +1,81 @@
+// src/index.ts
+var createBenchmarkRecord = (index) => ({
+  id: `record_${index}`,
+  createdAt: index,
+  group: index % 2 === 0 ? "even" : "odd",
+  title: `Benchmark record ${index}`
+});
+var benchmarkAdapterWrites = async (options) => {
+  const records = options.records ?? 1e5;
+  const collection = options.collection ?? "benchmark";
+  const startedAt = performance.now();
+  for (let index = 0; index < records; index += 1) {
+    await options.storage.set(collection, createBenchmarkRecord(index));
+  }
+  return toResult(`${options.storage.name}:writes`, records, startedAt);
+};
+var benchmarkAdapterBatchWrites = async (options) => {
+  const records = options.records ?? 1e5;
+  const collection = options.collection ?? "benchmark";
+  const batchSize = options.batchSize ?? 500;
+  const startedAt = performance.now();
+  for (let index = 0; index < records; index += batchSize) {
+    const batch = Array.from(
+      { length: Math.min(batchSize, records - index) },
+      (_, offset) => options.storage.set(collection, createBenchmarkRecord(index + offset))
+    );
+    await Promise.all(batch);
+  }
+  return toResult(`${options.storage.name}:batch-writes`, records, startedAt);
+};
+var benchmarkAdapterFind = async (options) => {
+  const collection = options.collection ?? "benchmark";
+  const startedAt = performance.now();
+  const records = await options.storage.find(collection, {
+    filters: { group: "even" },
+    limit: 100,
+    orderBy: "createdAt",
+    sort: "desc"
+  });
+  return toResult(`${options.storage.name}:find`, records.length, startedAt);
+};
+var benchmarkIndexedFind = async (options) => {
+  const collection = options.collection ?? "benchmark";
+  const storage = options.storage;
+  if (typeof storage.createIndex === "function") {
+    await storage.createIndex({
+      collection,
+      fields: ["group"],
+      name: "benchmark_group"
+    });
+  }
+  const startedAt = performance.now();
+  const records = await options.storage.find(collection, {
+    filters: { group: "even" },
+    limit: 100
+  });
+  return toResult(`${options.storage.name}:indexed-find`, records.length, startedAt);
+};
+var runAdapterBenchmarkSuite = async (options) => {
+  const writes = await benchmarkAdapterWrites(options);
+  const find = await benchmarkAdapterFind(options);
+  const indexedFind = await benchmarkIndexedFind(options);
+  return { find, indexedFind, writes };
+};
+var formatBenchmarkResult = (result) => {
+  const throughput = result.throughputPerSecond === void 0 ? "" : ` (${result.throughputPerSecond.toFixed(0)} ops/s)`;
+  return `${result.name}: ${result.records} records in ${result.durationMs.toFixed(2)}ms${throughput}`;
+};
+var toResult = (name, records, startedAt) => {
+  const durationMs = performance.now() - startedAt;
+  return {
+    durationMs,
+    name,
+    records,
+    ...durationMs > 0 ? { throughputPerSecond: records / durationMs * 1e3 } : {}
+  };
+};
+
+export { benchmarkAdapterBatchWrites, benchmarkAdapterFind, benchmarkAdapterWrites, benchmarkIndexedFind, createBenchmarkRecord, formatBenchmarkResult, runAdapterBenchmarkSuite };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { EntityRecord, IndexableStorageAdapter, StorageAdapter } from \"@offlinejs/types\";\n\nexport interface BenchmarkResult {\n  durationMs: number;\n  name: string;\n  records: number;\n  throughputPerSecond?: number;\n}\n\nexport interface AdapterBenchmarkOptions {\n  collection?: string;\n  records?: number;\n  storage: StorageAdapter;\n}\n\nexport interface BenchmarkSuiteResult {\n  find: BenchmarkResult;\n  indexedFind?: BenchmarkResult;\n  writes: BenchmarkResult;\n}\n\nexport const createBenchmarkRecord = (index: number): EntityRecord => ({\n  id: `record_${index}`,\n  createdAt: index,\n  group: index % 2 === 0 ? \"even\" : \"odd\",\n  title: `Benchmark record ${index}`\n});\n\nexport const benchmarkAdapterWrites = async (\n  options: AdapterBenchmarkOptions\n): Promise<BenchmarkResult> => {\n  const records = options.records ?? 100_000;\n  const collection = options.collection ?? \"benchmark\";\n  const startedAt = performance.now();\n\n  for (let index = 0; index < records; index += 1) {\n    await options.storage.set(collection, createBenchmarkRecord(index));\n  }\n\n  return toResult(`${options.storage.name}:writes`, records, startedAt);\n};\n\nexport const benchmarkAdapterBatchWrites = async (\n  options: AdapterBenchmarkOptions & { batchSize?: number }\n): Promise<BenchmarkResult> => {\n  const records = options.records ?? 100_000;\n  const collection = options.collection ?? \"benchmark\";\n  const batchSize = options.batchSize ?? 500;\n  const startedAt = performance.now();\n\n  for (let index = 0; index < records; index += batchSize) {\n    const batch = Array.from({ length: Math.min(batchSize, records - index) }, (_, offset) =>\n      options.storage.set(collection, createBenchmarkRecord(index + offset))\n    );\n    await Promise.all(batch);\n  }\n\n  return toResult(`${options.storage.name}:batch-writes`, records, startedAt);\n};\n\nexport const benchmarkAdapterFind = async (\n  options: AdapterBenchmarkOptions\n): Promise<BenchmarkResult> => {\n  const collection = options.collection ?? \"benchmark\";\n  const startedAt = performance.now();\n  const records = await options.storage.find(collection, {\n    filters: { group: \"even\" },\n    limit: 100,\n    orderBy: \"createdAt\",\n    sort: \"desc\"\n  });\n\n  return toResult(`${options.storage.name}:find`, records.length, startedAt);\n};\n\nexport const benchmarkIndexedFind = async (\n  options: AdapterBenchmarkOptions\n): Promise<BenchmarkResult> => {\n  const collection = options.collection ?? \"benchmark\";\n  const storage = options.storage as IndexableStorageAdapter;\n\n  if (typeof storage.createIndex === \"function\") {\n    await storage.createIndex({\n      collection,\n      fields: [\"group\"],\n      name: \"benchmark_group\"\n    });\n  }\n\n  const startedAt = performance.now();\n  const records = await options.storage.find(collection, {\n    filters: { group: \"even\" },\n    limit: 100\n  });\n\n  return toResult(`${options.storage.name}:indexed-find`, records.length, startedAt);\n};\n\n/** Seed + write/find suite sized for 100k-record adapter comparisons. */\nexport const runAdapterBenchmarkSuite = async (\n  options: AdapterBenchmarkOptions\n): Promise<BenchmarkSuiteResult> => {\n  const writes = await benchmarkAdapterWrites(options);\n  const find = await benchmarkAdapterFind(options);\n  const indexedFind = await benchmarkIndexedFind(options);\n\n  return { find, indexedFind, writes };\n};\n\nexport const formatBenchmarkResult = (result: BenchmarkResult): string => {\n  const throughput =\n    result.throughputPerSecond === undefined\n      ? \"\"\n      : ` (${result.throughputPerSecond.toFixed(0)} ops/s)`;\n  return `${result.name}: ${result.records} records in ${result.durationMs.toFixed(2)}ms${throughput}`;\n};\n\nconst toResult = (name: string, records: number, startedAt: number): BenchmarkResult => {\n  const durationMs = performance.now() - startedAt;\n  return {\n    durationMs,\n    name,\n    records,\n    ...(durationMs > 0 ? { throughputPerSecond: (records / durationMs) * 1000 } : {})\n  };\n};\n"]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@offlinejs/benchmarks",
+  "version": "0.1.0",
+  "description": "Benchmark utilities for OfflineJS adapters and sync flows.",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@offlinejs/types": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "latest",
+    "typescript": "latest"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}