@offlinejs/utils 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { IndexDefinition, EntityRecord, QueryOptions, StorageAdapter, SyncTransport, QueryFilters, IndexableStorageAdapter } from '@offlinejs/types';
+
+declare const now: () => number;
+declare const isBrowser: () => boolean;
+declare const delay: (ms: number) => Promise<void>;
+declare const createId: () => string;
+declare const clone: <TValue>(value: TValue) => TValue;
+declare const normalizeError: (error: unknown) => Error;
+declare const assertStorageAdapter: (adapter: StorageAdapter) => void;
+declare const assertSyncTransport: (transport: SyncTransport) => void;
+declare const toQueryString: (query?: Record<string, string | number | boolean | undefined>) => string;
+declare const backoffDelay: (attempt: number, options: {
+    baseDelayMs: number;
+    factor: number;
+    jitter: boolean;
+    maxDelayMs: number;
+}) => number;
+declare const matchesQuery: <TRecord extends EntityRecord>(record: TRecord, query?: QueryOptions<TRecord>) => boolean;
+declare const applyQuery: <TRecord extends EntityRecord>(records: TRecord[], query?: QueryOptions<TRecord>) => TRecord[];
+declare const countQuery: <TRecord extends EntityRecord>(records: TRecord[], query?: QueryOptions<TRecord>) => number;
+declare const serializeIndexValue: (value: unknown) => string;
+declare const serializeCompoundIndexValue: (values: unknown[]) => string;
+declare const readIndexFields: (record: EntityRecord, fields: Array<string | number | symbol>) => unknown[];
+interface EqualityLookup {
+    field: string;
+    value: unknown;
+}
+/** Extract simple equality lookups that secondary indexes can accelerate. */
+declare const getEqualityFilterLookups: <TRecord extends EntityRecord>(filters?: QueryFilters<TRecord>) => EqualityLookup[];
+interface MatchedIndex {
+    index: IndexDefinition;
+    values: unknown[];
+}
+/** Prefer the most specific index whose fields are all covered by equality filters. */
+declare const findMatchingIndex: (indexes: IndexDefinition[], lookups: EqualityLookup[]) => MatchedIndex | null;
+/** Forward index APIs through storage wrappers (validation/encryption). */
+declare const withIndexForwarding: <TAdapter extends StorageAdapter>(wrapper: TAdapter, inner: StorageAdapter) => TAdapter & IndexableStorageAdapter;
+
+export { type EqualityLookup, type MatchedIndex, applyQuery, assertStorageAdapter, assertSyncTransport, backoffDelay, clone, countQuery, createId, delay, findMatchingIndex, getEqualityFilterLookups, isBrowser, matchesQuery, normalizeError, now, readIndexFields, serializeCompoundIndexValue, serializeIndexValue, toQueryString, withIndexForwarding };

package/dist/index.js

@@ -0,0 +1,229 @@
+import { STORAGE_ADAPTER_CONTRACT_VERSION, SYNC_TRANSPORT_CONTRACT_VERSION } from '@offlinejs/types';
+
+// src/index.ts
+var now = () => Date.now();
+var isBrowser = () => typeof globalThis.window !== "undefined" && typeof globalThis.document !== "undefined";
+var delay = (ms) => new Promise((resolve) => {
+  globalThis.setTimeout(resolve, ms);
+});
+var createId = () => {
+  const cryptoApi = globalThis.crypto;
+  if (cryptoApi?.randomUUID) {
+    return cryptoApi.randomUUID();
+  }
+  return `offline_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+};
+var clone = (value) => {
+  if (typeof globalThis.structuredClone === "function") {
+    return globalThis.structuredClone(value);
+  }
+  return JSON.parse(JSON.stringify(value));
+};
+var normalizeError = (error) => {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(typeof error === "string" ? error : "Unknown OfflineJS error");
+};
+var assertStorageAdapter = (adapter) => {
+  const requiredMethods = [
+    "get",
+    "set",
+    "delete",
+    "find",
+    "clear",
+    "transaction"
+  ];
+  if (!adapter.name) {
+    throw new Error("OfflineJS storage adapter requires a stable name");
+  }
+  for (const method of requiredMethods) {
+    if (typeof adapter[method] !== "function") {
+      throw new Error(`OfflineJS storage adapter "${adapter.name}" is missing ${String(method)}()`);
+    }
+  }
+  if (adapter.contractVersion !== void 0 && adapter.contractVersion !== STORAGE_ADAPTER_CONTRACT_VERSION) {
+    throw new Error(
+      `Unsupported storage adapter contract ${adapter.contractVersion}; expected ${STORAGE_ADAPTER_CONTRACT_VERSION}`
+    );
+  }
+};
+var assertSyncTransport = (transport) => {
+  if (typeof transport.request !== "function") {
+    throw new Error("OfflineJS sync transport requires request()");
+  }
+  if (transport.contractVersion !== void 0 && transport.contractVersion !== SYNC_TRANSPORT_CONTRACT_VERSION) {
+    throw new Error(
+      `Unsupported sync transport contract ${transport.contractVersion}; expected ${SYNC_TRANSPORT_CONTRACT_VERSION}`
+    );
+  }
+};
+var toQueryString = (query) => {
+  if (!query) {
+    return "";
+  }
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0) {
+      params.set(key, String(value));
+    }
+  }
+  const result = params.toString();
+  return result.length > 0 ? `?${result}` : "";
+};
+var backoffDelay = (attempt, options) => {
+  const exponentialDelay = Math.min(
+    options.baseDelayMs * options.factor ** Math.max(0, attempt - 1),
+    options.maxDelayMs
+  );
+  if (!options.jitter) {
+    return exponentialDelay;
+  }
+  return Math.round(exponentialDelay * (0.5 + Math.random() * 0.5));
+};
+var matchesQuery = (record, query = {}) => {
+  if (query.filters && !matchesFilters(record, query.filters)) {
+    return false;
+  }
+  if (!query.search) {
+    return true;
+  }
+  const search = query.search.toLowerCase();
+  const fields = query.searchFields?.map((field) => String(field)) ?? Object.keys(record);
+  return fields.some(
+    (field) => String(record[field] ?? "").toLowerCase().includes(search)
+  );
+};
+var applyQuery = (records, query = {}) => {
+  const filtered = records.filter((record) => matchesQuery(record, query));
+  const sorted = sortRecords(filtered, query);
+  const offset = Math.max(0, query.offset ?? 0);
+  const limit = query.limit ?? sorted.length;
+  return sorted.slice(offset, offset + limit);
+};
+var countQuery = (records, query = {}) => records.filter((record) => matchesQuery(record, query)).length;
+var serializeIndexValue = (value) => JSON.stringify(value ?? null);
+var serializeCompoundIndexValue = (values) => JSON.stringify(values.map((value) => value ?? null));
+var readIndexFields = (record, fields) => fields.map((field) => record[String(field)]);
+var getEqualityFilterLookups = (filters) => {
+  if (!filters) {
+    return [];
+  }
+  const lookups = [];
+  for (const [field, expected] of Object.entries(filters)) {
+    if (expected === void 0) {
+      continue;
+    }
+    if (Array.isArray(expected) || expected === null || typeof expected !== "object") {
+      lookups.push({ field, value: expected });
+      continue;
+    }
+    if ("eq" in expected && expected.eq !== void 0) {
+      lookups.push({ field, value: expected.eq });
+    }
+  }
+  return lookups;
+};
+var findMatchingIndex = (indexes, lookups) => {
+  if (indexes.length === 0 || lookups.length === 0) {
+    return null;
+  }
+  const lookupByField = new Map(lookups.map((lookup) => [lookup.field, lookup.value]));
+  const ranked = [...indexes].sort((left, right) => right.fields.length - left.fields.length);
+  for (const index of ranked) {
+    const fields = index.fields.map(String);
+    if (fields.every((field) => lookupByField.has(field))) {
+      return {
+        index,
+        values: fields.map((field) => lookupByField.get(field))
+      };
+    }
+  }
+  return null;
+};
+var withIndexForwarding = (wrapper, inner) => {
+  const indexable = inner;
+  return Object.assign(wrapper, {
+    ...typeof indexable.createIndex === "function" ? { createIndex: indexable.createIndex.bind(indexable) } : {},
+    ...typeof indexable.dropIndex === "function" ? { dropIndex: indexable.dropIndex.bind(indexable) } : {},
+    ...typeof indexable.listIndexes === "function" ? { listIndexes: indexable.listIndexes.bind(indexable) } : {}
+  });
+};
+var sortRecords = (records, query) => {
+  if (!query.orderBy) {
+    return [...records];
+  }
+  const direction = query.sort === "desc" ? -1 : 1;
+  const key = String(query.orderBy);
+  return [...records].sort((left, right) => {
+    const leftValue = left[key];
+    const rightValue = right[key];
+    if (leftValue === rightValue) {
+      return 0;
+    }
+    if (leftValue === void 0 || leftValue === null) {
+      return -1 * direction;
+    }
+    if (rightValue === void 0 || rightValue === null) {
+      return direction;
+    }
+    return leftValue > rightValue ? direction : -direction;
+  });
+};
+var matchesFilters = (record, filters) => {
+  for (const [field, expected] of Object.entries(filters)) {
+    const actual = record[field];
+    if (Array.isArray(expected)) {
+      if (!expected.includes(actual)) {
+        return false;
+      }
+      continue;
+    }
+    if (expected && typeof expected === "object") {
+      if (!matchesOperator(actual, expected)) {
+        return false;
+      }
+      continue;
+    }
+    if (actual !== expected) {
+      return false;
+    }
+  }
+  return true;
+};
+var matchesOperator = (actual, expected) => {
+  if ("eq" in expected && actual !== expected.eq) {
+    return false;
+  }
+  if ("ne" in expected && actual === expected.ne) {
+    return false;
+  }
+  if ("gt" in expected && !isGreaterThan(actual, expected.gt)) {
+    return false;
+  }
+  if ("gte" in expected && !isGreaterThanOrEqual(actual, expected.gte)) {
+    return false;
+  }
+  if ("lt" in expected && !isLessThan(actual, expected.lt)) {
+    return false;
+  }
+  if ("lte" in expected && !isLessThanOrEqual(actual, expected.lte)) {
+    return false;
+  }
+  if ("in" in expected && !expected.in?.includes(actual)) {
+    return false;
+  }
+  if ("contains" in expected) {
+    return String(actual ?? "").toLowerCase().includes(String(expected.contains).toLowerCase());
+  }
+  return true;
+};
+var isComparable = (value) => typeof value === "number" || typeof value === "string";
+var isGreaterThan = (actual, expected) => isComparable(actual) && expected !== void 0 && actual > expected;
+var isGreaterThanOrEqual = (actual, expected) => isComparable(actual) && expected !== void 0 && actual >= expected;
+var isLessThan = (actual, expected) => isComparable(actual) && expected !== void 0 && actual < expected;
+var isLessThanOrEqual = (actual, expected) => isComparable(actual) && expected !== void 0 && actual <= expected;
+
+export { applyQuery, assertStorageAdapter, assertSyncTransport, backoffDelay, clone, countQuery, createId, delay, findMatchingIndex, getEqualityFilterLookups, isBrowser, matchesQuery, normalizeError, now, readIndexFields, serializeCompoundIndexValue, serializeIndexValue, toQueryString, withIndexForwarding };
+//# 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 {\n  STORAGE_ADAPTER_CONTRACT_VERSION,\n  SYNC_TRANSPORT_CONTRACT_VERSION,\n  type EntityRecord,\n  type IndexableStorageAdapter,\n  type IndexDefinition,\n  type QueryFilterValue,\n  type QueryFilters,\n  type QueryOptions,\n  type StorageAdapter,\n  type SyncTransport\n} from \"@offlinejs/types\";\n\ntype OperatorFilter = Extract<QueryFilterValue, { eq?: unknown }>;\n\nexport const now = (): number => Date.now();\n\nexport const isBrowser = (): boolean =>\n  typeof globalThis.window !== \"undefined\" && typeof globalThis.document !== \"undefined\";\n\nexport const delay = (ms: number): Promise<void> =>\n  new Promise((resolve) => {\n    globalThis.setTimeout(resolve, ms);\n  });\n\nexport const createId = (): string => {\n  const cryptoApi = globalThis.crypto;\n\n  if (cryptoApi?.randomUUID) {\n    return cryptoApi.randomUUID();\n  }\n\n  return `offline_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n};\n\nexport const clone = <TValue>(value: TValue): TValue => {\n  if (typeof globalThis.structuredClone === \"function\") {\n    return globalThis.structuredClone(value);\n  }\n\n  return JSON.parse(JSON.stringify(value)) as TValue;\n};\n\nexport const normalizeError = (error: unknown): Error => {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  return new Error(typeof error === \"string\" ? error : \"Unknown OfflineJS error\");\n};\n\nexport const assertStorageAdapter = (adapter: StorageAdapter): void => {\n  const requiredMethods: Array<keyof StorageAdapter> = [\n    \"get\",\n    \"set\",\n    \"delete\",\n    \"find\",\n    \"clear\",\n    \"transaction\"\n  ];\n\n  if (!adapter.name) {\n    throw new Error(\"OfflineJS storage adapter requires a stable name\");\n  }\n\n  for (const method of requiredMethods) {\n    if (typeof adapter[method] !== \"function\") {\n      throw new Error(`OfflineJS storage adapter \"${adapter.name}\" is missing ${String(method)}()`);\n    }\n  }\n\n  if (\n    adapter.contractVersion !== undefined &&\n    adapter.contractVersion !== STORAGE_ADAPTER_CONTRACT_VERSION\n  ) {\n    throw new Error(\n      `Unsupported storage adapter contract ${adapter.contractVersion}; expected ${STORAGE_ADAPTER_CONTRACT_VERSION}`\n    );\n  }\n};\n\nexport const assertSyncTransport = (transport: SyncTransport): void => {\n  if (typeof transport.request !== \"function\") {\n    throw new Error(\"OfflineJS sync transport requires request()\");\n  }\n\n  if (\n    transport.contractVersion !== undefined &&\n    transport.contractVersion !== SYNC_TRANSPORT_CONTRACT_VERSION\n  ) {\n    throw new Error(\n      `Unsupported sync transport contract ${transport.contractVersion}; expected ${SYNC_TRANSPORT_CONTRACT_VERSION}`\n    );\n  }\n};\n\nexport const toQueryString = (\n  query?: Record<string, string | number | boolean | undefined>\n): string => {\n  if (!query) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value !== undefined) {\n      params.set(key, String(value));\n    }\n  }\n\n  const result = params.toString();\n  return result.length > 0 ? `?${result}` : \"\";\n};\n\nexport const backoffDelay = (\n  attempt: number,\n  options: { baseDelayMs: number; factor: number; jitter: boolean; maxDelayMs: number }\n): number => {\n  const exponentialDelay = Math.min(\n    options.baseDelayMs * options.factor ** Math.max(0, attempt - 1),\n    options.maxDelayMs\n  );\n\n  if (!options.jitter) {\n    return exponentialDelay;\n  }\n\n  return Math.round(exponentialDelay * (0.5 + Math.random() * 0.5));\n};\n\nexport const matchesQuery = <TRecord extends EntityRecord>(\n  record: TRecord,\n  query: QueryOptions<TRecord> = {}\n): boolean => {\n  if (query.filters && !matchesFilters(record, query.filters as Record<string, QueryFilterValue>)) {\n    return false;\n  }\n\n  if (!query.search) {\n    return true;\n  }\n\n  const search = query.search.toLowerCase();\n  const fields = query.searchFields?.map((field) => String(field)) ?? Object.keys(record);\n\n  return fields.some((field) =>\n    String(record[field] ?? \"\")\n      .toLowerCase()\n      .includes(search)\n  );\n};\n\nexport const applyQuery = <TRecord extends EntityRecord>(\n  records: TRecord[],\n  query: QueryOptions<TRecord> = {}\n): TRecord[] => {\n  const filtered = records.filter((record) => matchesQuery(record, query));\n  const sorted = sortRecords(filtered, query);\n  const offset = Math.max(0, query.offset ?? 0);\n  const limit = query.limit ?? sorted.length;\n\n  return sorted.slice(offset, offset + limit);\n};\n\nexport const countQuery = <TRecord extends EntityRecord>(\n  records: TRecord[],\n  query: QueryOptions<TRecord> = {}\n): number => records.filter((record) => matchesQuery(record, query)).length;\n\nexport const serializeIndexValue = (value: unknown): string => JSON.stringify(value ?? null);\n\nexport const serializeCompoundIndexValue = (values: unknown[]): string =>\n  JSON.stringify(values.map((value) => value ?? null));\n\nexport const readIndexFields = (record: EntityRecord, fields: Array<string | number | symbol>): unknown[] =>\n  fields.map((field) => record[String(field)]);\n\nexport interface EqualityLookup {\n  field: string;\n  value: unknown;\n}\n\n/** Extract simple equality lookups that secondary indexes can accelerate. */\nexport const getEqualityFilterLookups = <TRecord extends EntityRecord>(\n  filters?: QueryFilters<TRecord>\n): EqualityLookup[] => {\n  if (!filters) {\n    return [];\n  }\n\n  const lookups: EqualityLookup[] = [];\n\n  for (const [field, expected] of Object.entries(filters)) {\n    if (expected === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(expected) || expected === null || typeof expected !== \"object\") {\n      lookups.push({ field, value: expected });\n      continue;\n    }\n\n    if (\"eq\" in expected && expected.eq !== undefined) {\n      lookups.push({ field, value: expected.eq });\n    }\n  }\n\n  return lookups;\n};\n\nexport interface MatchedIndex {\n  index: IndexDefinition;\n  values: unknown[];\n}\n\n/** Prefer the most specific index whose fields are all covered by equality filters. */\nexport const findMatchingIndex = (\n  indexes: IndexDefinition[],\n  lookups: EqualityLookup[]\n): MatchedIndex | null => {\n  if (indexes.length === 0 || lookups.length === 0) {\n    return null;\n  }\n\n  const lookupByField = new Map(lookups.map((lookup) => [lookup.field, lookup.value]));\n  const ranked = [...indexes].sort((left, right) => right.fields.length - left.fields.length);\n\n  for (const index of ranked) {\n    const fields = index.fields.map(String);\n\n    if (fields.every((field) => lookupByField.has(field))) {\n      return {\n        index,\n        values: fields.map((field) => lookupByField.get(field))\n      };\n    }\n  }\n\n  return null;\n};\n\n/** Forward index APIs through storage wrappers (validation/encryption). */\nexport const withIndexForwarding = <TAdapter extends StorageAdapter>(\n  wrapper: TAdapter,\n  inner: StorageAdapter\n): TAdapter & IndexableStorageAdapter => {\n  const indexable = inner as IndexableStorageAdapter;\n\n  return Object.assign(wrapper, {\n    ...(typeof indexable.createIndex === \"function\"\n      ? { createIndex: indexable.createIndex.bind(indexable) }\n      : {}),\n    ...(typeof indexable.dropIndex === \"function\"\n      ? { dropIndex: indexable.dropIndex.bind(indexable) }\n      : {}),\n    ...(typeof indexable.listIndexes === \"function\"\n      ? { listIndexes: indexable.listIndexes.bind(indexable) }\n      : {})\n  }) as TAdapter & IndexableStorageAdapter;\n};\n\nconst sortRecords = <TRecord extends EntityRecord>(\n  records: TRecord[],\n  query: QueryOptions<TRecord>\n): TRecord[] => {\n  if (!query.orderBy) {\n    return [...records];\n  }\n\n  const direction = query.sort === \"desc\" ? -1 : 1;\n  const key = String(query.orderBy);\n\n  return [...records].sort((left, right) => {\n    const leftValue = left[key];\n    const rightValue = right[key];\n\n    if (leftValue === rightValue) {\n      return 0;\n    }\n\n    if (leftValue === undefined || leftValue === null) {\n      return -1 * direction;\n    }\n\n    if (rightValue === undefined || rightValue === null) {\n      return direction;\n    }\n\n    return leftValue > rightValue ? direction : -direction;\n  });\n};\n\nconst matchesFilters = (\n  record: EntityRecord,\n  filters: Record<string, QueryFilterValue>\n): boolean => {\n  for (const [field, expected] of Object.entries(filters)) {\n    const actual = record[field];\n\n    if (Array.isArray(expected)) {\n      if (!expected.includes(actual as never)) {\n        return false;\n      }\n      continue;\n    }\n\n    if (expected && typeof expected === \"object\") {\n      if (!matchesOperator(actual, expected)) {\n        return false;\n      }\n      continue;\n    }\n\n    if (actual !== expected) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\nconst matchesOperator = (actual: unknown, expected: OperatorFilter): boolean => {\n  if (\"eq\" in expected && actual !== expected.eq) {\n    return false;\n  }\n\n  if (\"ne\" in expected && actual === expected.ne) {\n    return false;\n  }\n\n  if (\"gt\" in expected && !isGreaterThan(actual, expected.gt)) {\n    return false;\n  }\n\n  if (\"gte\" in expected && !isGreaterThanOrEqual(actual, expected.gte)) {\n    return false;\n  }\n\n  if (\"lt\" in expected && !isLessThan(actual, expected.lt)) {\n    return false;\n  }\n\n  if (\"lte\" in expected && !isLessThanOrEqual(actual, expected.lte)) {\n    return false;\n  }\n\n  if (\"in\" in expected && !expected.in?.includes(actual)) {\n    return false;\n  }\n\n  if (\"contains\" in expected) {\n    return String(actual ?? \"\")\n      .toLowerCase()\n      .includes(String(expected.contains).toLowerCase());\n  }\n\n  return true;\n};\n\nconst isComparable = (value: unknown): value is number | string =>\n  typeof value === \"number\" || typeof value === \"string\";\n\nconst isGreaterThan = (actual: unknown, expected: number | string | undefined): boolean =>\n  isComparable(actual) && expected !== undefined && actual > expected;\n\nconst isGreaterThanOrEqual = (actual: unknown, expected: number | string | undefined): boolean =>\n  isComparable(actual) && expected !== undefined && actual >= expected;\n\nconst isLessThan = (actual: unknown, expected: number | string | undefined): boolean =>\n  isComparable(actual) && expected !== undefined && actual < expected;\n\nconst isLessThanOrEqual = (actual: unknown, expected: number | string | undefined): boolean =>\n  isComparable(actual) && expected !== undefined && actual <= expected;\n"]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@offlinejs/utils",
+  "version": "0.1.0",
+  "description": "Small runtime utilities for OfflineJS packages.",
+  "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"
+  }
+}