@sqlrooms/utils 0.24.3 → 0.24.5

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export * from './str';
 export * from './xhr';
 export * from './filepaths';
 export { safeJsonParse } from './json';
+export { memoizeOnce } from './memoization';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -11,4 +11,5 @@ export * from './str';
 export * from './xhr';
 export * from './filepaths';
 export { safeJsonParse } from './json';
+export { memoizeOnce } from './memoization';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nexport * from './color';\nexport * from './format';\nexport * from './helpers';\nexport {isMacOS} from './browser';\nexport * from './random';\nexport * from './str';\nexport * from './xhr';\nexport * from './filepaths';\nexport {safeJsonParse} from './json';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nexport * from './color';\nexport * from './format';\nexport * from './helpers';\nexport {isMacOS} from './browser';\nexport * from './random';\nexport * from './str';\nexport * from './xhr';\nexport * from './filepaths';\nexport {safeJsonParse} from './json';\nexport {memoizeOnce} from './memoization';\n"]}

package/dist/memoization.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Creates a memoized version of a function that caches only the last result.
+ * The cache is invalidated when any of the arguments change.
+ *
+ * This is useful for expensive operations that are likely to be called
+ * multiple times with the same arguments, like database queries or API calls.
+ *
+ * @param fn - The function to memoize
+ * @returns A memoized version of the function
+ *
+ * @example
+ * ```ts
+ * const expensiveQuery = async (userId: string, limit: number) => {
+ *   return await database.query(`SELECT * FROM users WHERE id = ? LIMIT ?`, [userId, limit]);
+ * };
+ *
+ * const memoizedQuery = memoizeOnce(expensiveQuery);
+ *
+ * // First call executes the function
+ * const result1 = await memoizedQuery("123", 10);
+ *
+ * // Second call with same arguments returns cached result
+ * const result2 = await memoizedQuery("123", 10); // Uses cache
+ *
+ * // Call with different arguments invalidates cache and executes function
+ * const result3 = await memoizedQuery("456", 10); // Executes function
+ * ```
+ */
+export declare function memoizeOnce<TArgs extends readonly unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+//# sourceMappingURL=memoization.d.ts.map

package/dist/memoization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoization.d.ts","sourceRoot":"","sources":["../src/memoization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,EAAE,OAAO,EACnE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAC9B,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAkB7B"}

package/dist/memoization.js

@@ -0,0 +1,53 @@
+/**
+ * Creates a memoized version of a function that caches only the last result.
+ * The cache is invalidated when any of the arguments change.
+ *
+ * This is useful for expensive operations that are likely to be called
+ * multiple times with the same arguments, like database queries or API calls.
+ *
+ * @param fn - The function to memoize
+ * @returns A memoized version of the function
+ *
+ * @example
+ * ```ts
+ * const expensiveQuery = async (userId: string, limit: number) => {
+ *   return await database.query(`SELECT * FROM users WHERE id = ? LIMIT ?`, [userId, limit]);
+ * };
+ *
+ * const memoizedQuery = memoizeOnce(expensiveQuery);
+ *
+ * // First call executes the function
+ * const result1 = await memoizedQuery("123", 10);
+ *
+ * // Second call with same arguments returns cached result
+ * const result2 = await memoizedQuery("123", 10); // Uses cache
+ *
+ * // Call with different arguments invalidates cache and executes function
+ * const result3 = await memoizedQuery("456", 10); // Executes function
+ * ```
+ */
+export function memoizeOnce(fn) {
+    let lastArgs;
+    let lastResult;
+    let hasResult = false;
+    return function (...args) {
+        // Check if we have a cached result and arguments haven't changed
+        if (hasResult && lastArgs && argsEqual(lastArgs, args)) {
+            return lastResult;
+        }
+        // Call the function with the correct context and cache the result
+        lastResult = fn.apply(this, args);
+        lastArgs = args;
+        hasResult = true;
+        return lastResult;
+    };
+}
+/**
+ * Shallow comparison of two arrays to check if all elements are equal
+ */
+function argsEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return a.every((val, index) => val === b[index]);
+}
+//# sourceMappingURL=memoization.js.map

package/dist/memoization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoization.js","sourceRoot":"","sources":["../src/memoization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,WAAW,CACzB,EAA+B;IAE/B,IAAI,QAA2B,CAAC;IAChC,IAAI,UAAmB,CAAC;IACxB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,UAAqB,GAAG,IAAW;QACxC,iEAAiE;QACjE,IAAI,SAAS,IAAI,QAAQ,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACvD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,kEAAkE;QAClE,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAwB,CAAC,CAAC;QACtD,QAAQ,GAAG,IAAI,CAAC;QAChB,SAAS,GAAG,IAAI,CAAC;QAEjB,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAA+B,CAAI,EAAE,CAAI;IACzD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC","sourcesContent":["/**\n * Creates a memoized version of a function that caches only the last result.\n * The cache is invalidated when any of the arguments change.\n *\n * This is useful for expensive operations that are likely to be called\n * multiple times with the same arguments, like database queries or API calls.\n *\n * @param fn - The function to memoize\n * @returns A memoized version of the function\n *\n * @example\n * ```ts\n * const expensiveQuery = async (userId: string, limit: number) => {\n *   return await database.query(`SELECT * FROM users WHERE id = ? LIMIT ?`, [userId, limit]);\n * };\n *\n * const memoizedQuery = memoizeOnce(expensiveQuery);\n *\n * // First call executes the function\n * const result1 = await memoizedQuery(\"123\", 10);\n *\n * // Second call with same arguments returns cached result\n * const result2 = await memoizedQuery(\"123\", 10); // Uses cache\n *\n * // Call with different arguments invalidates cache and executes function\n * const result3 = await memoizedQuery(\"456\", 10); // Executes function\n * ```\n */\nexport function memoizeOnce<TArgs extends readonly unknown[], TReturn>(\n  fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n  let lastArgs: TArgs | undefined;\n  let lastResult: TReturn;\n  let hasResult = false;\n\n  return function (this: any, ...args: TArgs): TReturn {\n    // Check if we have a cached result and arguments haven't changed\n    if (hasResult && lastArgs && argsEqual(lastArgs, args)) {\n      return lastResult;\n    }\n\n    // Call the function with the correct context and cache the result\n    lastResult = fn.apply(this, args as unknown as any[]);\n    lastArgs = args;\n    hasResult = true;\n\n    return lastResult;\n  };\n}\n\n/**\n * Shallow comparison of two arrays to check if all elements are equal\n */\nfunction argsEqual<T extends readonly unknown[]>(a: T, b: T): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((val, index) => val === b[index]);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqlrooms/utils",
-  "version": "0.24.3",
+  "version": "0.24.5",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "dist/index.js",
@@ -44,5 +44,5 @@
     "react": ">=18",
     "react-dom": ">=18"
   },
-  "gitHead": "90963995f87b6867cff780e4c5f4e74dac38fa00"
+  "gitHead": "393aee155a8954a9e5b7e792e6f98118182f2cc3"
 }