@conduit-client/service-cache-control 2.0.0

package/LICENSE.txt

@@ -0,0 +1,27 @@
+*Attorney/Client Privileged + Confidential*
+
+Terms of Use for Public Code (Non-OSS)
+
+*NOTE:* Before publishing code under this license/these Terms of Use, please review https://salesforce.quip.com/WFfvAMKB18AL and confirm that you’ve completed all prerequisites described therein. *These Terms of Use may not be used or modified without input from IP and Product Legal.*
+
+*Terms of Use*
+
+Copyright 2022 Salesforce, Inc. All rights reserved. 
+
+These Terms of Use govern the download, installation, and/or use of this software provided by Salesforce, Inc. (“Salesforce”) (the “Software”), were last updated on April 15, 2022, ** and constitute a legally binding agreement between you and Salesforce. If you do not agree to these Terms of Use, do not install or use the Software. 
+ 
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, and distribute the Software and derivative works subject to these Terms. These Terms shall be included in all copies or substantial portions of the Software. 
+
+Subject to the limited rights expressly granted hereunder, Salesforce reserves all rights, title, and interest in and to all intellectual property subsisting in the Software. No rights are granted to you hereunder other than as expressly set forth herein. Users residing in countries on the United States Office of Foreign Assets Control sanction list, or which are otherwise subject to a US export embargo, may not use the Software.
+ 
+Implementation of the Software may require development work, for which you are responsible. The Software may contain bugs, errors and incompatibilities and is made available on an AS IS basis without support, updates, or service level commitments. 
+ 
+Salesforce reserves the right at any time to modify, suspend, or discontinue, the Software (or any part thereof) with or without notice. You agree that Salesforce shall not be liable to you or to any third party for any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or proceeding made or brought against Salesforce by a third party arising out of or accruing from (a) your use of the Software, and (b) any application you develop with the Software that infringes any copyright, trademark, trade secret, trade dress, patent, or other intellectual property right of any person or defames any person or violates their rights of publicity or privacy (each a “Claim Against Salesforce”), and will indemnify Salesforce from any damages, attorney fees, and costs finally awarded against Salesforce as a result of, or for any amounts paid by Salesforce under a settlement approved by you in writing of, a Claim Against Salesforce, provided Salesforce (x) promptly gives you written notice of the Claim Against Salesforce, (y) gives you sole control of the defense and settlement of the Claim Against Salesforce (except that you may not settle any Claim Against Salesforce unless it unconditionally releases Salesforce of all liability), and (z) gives you all reasonable assistance, at your expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA, OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ 
+These Terms of Use shall be governed exclusively by the internal laws of the State of California, without regard to its conflicts of laws rules. Each party hereby consents to the exclusive jurisdiction of the state and federal courts located in San Francisco County, California to adjudicate any dispute arising out of or relating to these Terms of Use and the download, installation, and/or use of the Software. Except as expressly stated herein, these Terms of Use constitute the entire agreement between the parties, and supersede all prior and contemporaneous agreements, proposals, or representations, written or oral, concerning their subject matter. No modification, amendment, or waiver of any provision of these Terms of Use shall be effective unless it is by an update to these Terms of Use that Salesforce makes available, or is in writing and signed by the party against whom the modification, amendment, or waiver is to be asserted.
+
+_*Data Privacy*_: Salesforce may collect, process, and store device, system, and other information related to your use of the Software. This information includes, but is not limited to, IP address, user metrics, and other data (“Usage Data”). Salesforce may use Usage Data for analytics, product development, and marketing purposes. You acknowledge that files generated in conjunction with the Software may contain sensitive or confidential data, and you are solely responsible for anonymizing and protecting such data.  

package/README.md

@@ -0,0 +1 @@
+This software is provided as-is with no support provided.

package/dist/main/index.js

@@ -0,0 +1,6 @@
+/*!
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+//# sourceMappingURL=index.js.map

package/dist/main/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/types/v1/__tests__/cache-control.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/v1/__tests__/utils.d.ts

@@ -0,0 +1,28 @@
+import { Key, Cache } from '@conduit-client/service-cache/v1';
+import { DurableCacheInclusionPolicy } from '@conduit-client/service-cache-inclusion-policy/v1';
+import { SyncOrAsync } from '@conduit-client/utils';
+import type { RequestRunner } from '../cache-control';
+export declare class TestRequestRunner implements RequestRunner<any, any> {
+    data: any;
+    getData: () => any;
+    readFromCache: import("vitest").Mock<(...args: any[]) => any>;
+    requestFromNetwork: import("vitest").Mock<(...args: any[]) => any>;
+    writeToCache: import("vitest").Mock<(...args: any[]) => any>;
+}
+export declare class NetworkRequestErrorRequestRunner extends TestRequestRunner {
+    requestFromNetwork: import("vitest").Mock<(...args: any[]) => any>;
+}
+export declare class CacheMissAfterNetworkRequestRunner extends TestRequestRunner {
+    writeToCache: import("vitest").Mock<(...args: any[]) => any>;
+}
+export declare class TestDurableCacheInclusionPolicy extends DurableCacheInclusionPolicy {
+    l2: Cache;
+    constructor();
+    revive(keys: Set<Key>, l1: Cache): SyncOrAsync<Set<Key>>;
+    syncToL2Cache(updatedKeys: Set<Key>, l1: Cache): SyncOrAsync<void>;
+    find: import("vitest").Mock<(...args: any[]) => any>;
+    findAndModify: import("vitest").Mock<(...args: any[]) => any>;
+}
+export declare class NoCacheRequestRunner extends TestRequestRunner {
+    writeToCache: import("vitest").Mock<(...args: any[]) => any>;
+}

package/dist/types/v1/cache-control-strategies/__tests__/cache-control-strategy.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/v1/cache-control-strategies/__tests__/max-age-cache-control-strategy.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/v1/cache-control-strategies/__tests__/no-cache-control-strategy.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/v1/cache-control-strategies/__tests__/only-if-cached-cache-control-strategy.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/v1/cache-control-strategies/cache-control-strategy.d.ts

@@ -0,0 +1,18 @@
+import { SyncOrAsync, type Result } from '@conduit-client/utils';
+import type { ExecuteOptions, RequestRunner } from '../cache-control';
+import type { CacheControlMetadata, NamedCacheService, Cache } from '@conduit-client/service-cache/v1';
+import type { MaxAgeRequestConfig } from './max-age-cache-control-strategy';
+import type { NoCacheRequestConfig } from './no-cache-control-strategy';
+import type { OnlyIfCachedRequestConfig } from './only-if-cached-cache-control-strategy';
+import { NamedInstrumentationService } from '@conduit-client/service-instrumentation/v1';
+import { NamedCacheInclusionPolicyService } from '@conduit-client/service-cache-inclusion-policy/v1';
+export type CacheControlStrategyConfig = MaxAgeRequestConfig | NoCacheRequestConfig | OnlyIfCachedRequestConfig;
+export declare abstract class CacheControlStrategy<NetworkResult, Error> {
+    protected services: NamedCacheService & NamedCacheInclusionPolicyService & Partial<NamedInstrumentationService>;
+    protected config: CacheControlStrategyConfig;
+    protected requestRunner: RequestRunner<NetworkResult, Error>;
+    filteredCache: Cache;
+    constructor(services: NamedCacheService & NamedCacheInclusionPolicyService & Partial<NamedInstrumentationService>, config: CacheControlStrategyConfig, requestRunner: RequestRunner<NetworkResult, Error>);
+    abstract execute(options?: ExecuteOptions): SyncOrAsync<Result<void, Error>>;
+    protected get expiredChecks(): ((cacheControlMetadata: CacheControlMetadata) => boolean)[];
+}

package/dist/types/v1/cache-control-strategies/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cache-control-strategy';
+export * from './max-age-cache-control-strategy';
+export * from './only-if-cached-cache-control-strategy';

package/dist/types/v1/cache-control-strategies/max-age-cache-control-strategy.d.ts

@@ -0,0 +1,15 @@
+import { type Result, type SyncOrAsync } from '@conduit-client/utils';
+import { CacheControlStrategy } from './cache-control-strategy';
+import type { CacheControlMetadata } from '@conduit-client/service-cache/v1';
+import type { ExecuteOptions } from '../cache-control';
+export type MaxAgeRequestConfig = {
+    type: 'max-age';
+    requestMaxAge: number;
+    now: number;
+};
+export declare class MaxAgeCacheControlStrategy<NetworkResult, Error> extends CacheControlStrategy<NetworkResult, Error> {
+    execute(options?: ExecuteOptions): SyncOrAsync<Result<void, Error>>;
+    private collectCacheHitInstrumentation;
+    private collectCacheMissInstrumentation;
+    protected get expiredChecks(): ((cacheControlMetadata: CacheControlMetadata) => boolean)[];
+}

package/dist/types/v1/cache-control-strategies/no-cache-control-strategy.d.ts

@@ -0,0 +1,9 @@
+import { SyncOrAsync, type Result } from '@conduit-client/utils';
+import { CacheControlStrategy } from './cache-control-strategy';
+export type NoCacheRequestConfig = {
+    type: 'no-cache';
+    now: number;
+};
+export declare class NoCacheCacheControlStrategy<NetworkResult, Error> extends CacheControlStrategy<NetworkResult, Error> {
+    execute(): SyncOrAsync<Result<void, Error>>;
+}

package/dist/types/v1/cache-control-strategies/only-if-cached-cache-control-strategy.d.ts

@@ -0,0 +1,25 @@
+import { type Result, type SyncOrAsync } from '@conduit-client/utils';
+import { CacheControlStrategy } from './cache-control-strategy';
+import type { CacheControlMetadata } from '@conduit-client/service-cache/v1';
+import type { ExecuteOptions } from '../cache-control';
+export type OnlyIfCachedRequestConfig = {
+    type: 'only-if-cached';
+    now: number;
+};
+/**
+ * Only-if-cached strategy:
+ * - Never performs a network request
+ * - Returns cached data if present
+ * - Allows serving stale entries per RFC 9111 (only-if-cached may be satisfied by a stored response)
+ * - Excludes no-store entries
+ */
+export declare class OnlyIfCachedCacheControlStrategy<NetworkResult, Error> extends CacheControlStrategy<NetworkResult, Error> {
+    execute(options?: ExecuteOptions): SyncOrAsync<Result<void, Error>>;
+    protected get expiredChecks(): ((cacheControlMetadata: CacheControlMetadata) => cacheControlMetadata is {
+        type: "no-store";
+    } & {
+        generatedTime: number;
+    })[];
+    private collectCacheHitInstrumentation;
+    private collectCacheMissInstrumentation;
+}

package/dist/types/v1/cache-control.d.ts

@@ -0,0 +1,43 @@
+import { type SyncOrAsync, type Result, DeepReadonly } from '@conduit-client/utils';
+import type { CacheControlStrategyConfig } from './cache-control-strategies/cache-control-strategy';
+import type { Cache, CacheEntry, NamedCacheService, Key, ReadonlyCache } from '@conduit-client/service-cache/v1';
+import type { InstrumentationAttributes, NamedInstrumentationService } from '@conduit-client/service-instrumentation/v1';
+import { NamedCacheInclusionPolicyService, CacheQuery, CacheUpdate } from '@conduit-client/service-cache-inclusion-policy/v1';
+/**
+ * A class that exposes access for
+ * - reading from a cache
+ * - writing to a cache
+ * - making a network request
+ *
+ * This allows the cache controller to run these methods in any order
+ * based on the canonical & requested cache control metadata, without having
+ * to understand the inner workings of these functions
+ */
+export type RequestRunner<NetworkResult, E> = {
+    readFromCache: (cache: ReadonlyCache) => SyncOrAsync<Result<void, E>>;
+    requestFromNetwork: () => AsyncGenerator<NetworkResult | undefined, void, void>;
+    writeToCache: (cache: Cache, networkResult: NetworkResult) => SyncOrAsync<Result<void, E>>;
+};
+export type ExecuteOptions = {
+    instrumentationAttributes?: InstrumentationAttributes;
+};
+/**
+ * A class that allows the execution of requested cache control strategies,
+ * while also enforcing the canonical cache control metadata.
+ */
+export declare class CacheController {
+    protected services: NamedCacheService & NamedCacheInclusionPolicyService & Partial<NamedInstrumentationService>;
+    constructor(services: NamedCacheService & NamedCacheInclusionPolicyService & Partial<NamedInstrumentationService>);
+    execute<NetworkResult, E = unknown>(config: CacheControlStrategyConfig, requestRunner: RequestRunner<NetworkResult, E>, options?: ExecuteOptions): SyncOrAsync<Result<void, E>>;
+    private getCacheControlStrategy;
+    /**
+     * Finds cache entries that match the given query.
+     * Returns an async generator that yields `[key, entry]`.
+     */
+    find(query: CacheQuery): AsyncGenerator<[key: Key, value: DeepReadonly<CacheEntry<unknown>>], void, unknown>;
+    /**
+     * Finds and modifies cache entries that match the given query.
+     * Extends `find(query)` and returns an async generator of modified keys.
+     */
+    findAndModify(query: CacheQuery, cacheUpdate: CacheUpdate): AsyncGenerator<Key, void, unknown>;
+}

package/dist/types/v1/index.d.ts

@@ -0,0 +1,11 @@
+import { CacheController } from './cache-control';
+import type { ServiceDescriptor, NamedService, PublicInterface } from '@conduit-client/utils';
+import type { Cache } from '@conduit-client/service-cache/v1';
+import type { CacheInclusionPolicyService } from '@conduit-client/service-cache-inclusion-policy/v1';
+import { InstrumentationService } from '@conduit-client/service-instrumentation/v1';
+export type { CacheControlStrategyConfig } from './cache-control-strategies';
+export type { RequestRunner } from './cache-control';
+export type ICacheController = PublicInterface<CacheController>;
+export type NamedCacheControllerService<Name extends string = 'cacheController'> = NamedService<Name, ICacheController>;
+export type CacheControllerServiceDescriptor = ServiceDescriptor<ICacheController, 'cacheController', '1.0'>;
+export declare function buildServiceDescriptor(cache: Cache, cacheInclusionPolicy: CacheInclusionPolicyService, instrumentation?: InstrumentationService): CacheControllerServiceDescriptor;

package/dist/v1/index.js

@@ -0,0 +1,227 @@
+/*!
+ * Copyright (c) 2022, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ok, err, UserVisibleError, FetchResponse, HttpStatusCode } from "@conduit-client/utils";
+class CacheControlStrategy {
+  constructor(services, config, requestRunner) {
+    this.services = services;
+    this.config = config;
+    this.requestRunner = requestRunner;
+    this.filteredCache = this.services.cache.filter((_, entry) => {
+      const { cacheControl } = entry.metadata;
+      return !this.expiredChecks.some((check) => check(cacheControl));
+    });
+  }
+  get expiredChecks() {
+    return [
+      (cacheControlMetadata) => cacheControlMetadata.type === "max-age" && this.config.now > cacheControlMetadata.generatedTime + cacheControlMetadata.maxAge,
+      (cacheControlMetadata) => cacheControlMetadata.type === "max-age" && cacheControlMetadata.maxAge <= 0,
+      (cacheControlMetadata) => cacheControlMetadata.type === "no-store",
+      (cacheControlMetadata) => cacheControlMetadata.type === "no-cache" && cacheControlMetadata.generatedTime < this.config.now
+    ];
+  }
+}
+class NoCacheCacheControlStrategy extends CacheControlStrategy {
+  execute() {
+    const tempCache = this.filteredCache;
+    return new Promise(async (resolve, reject) => {
+      try {
+        let readResult = ok(void 0);
+        for await (const rfnResult of this.requestRunner.requestFromNetwork()) {
+          if (rfnResult) {
+            const result = await this.services.cacheInclusionPolicy.write({
+              l1: tempCache,
+              writeToL1: (l1) => this.requestRunner.writeToCache(l1, rfnResult)
+            });
+            if (result.isErr()) {
+              return resolve(result);
+            }
+          }
+          readResult = await this.services.cacheInclusionPolicy.read({
+            l1: tempCache,
+            readFromL1: (l1) => this.requestRunner.readFromCache(l1)
+          });
+          if (readResult.isOk()) {
+            resolve(readResult);
+          }
+        }
+        return resolve(readResult);
+      } catch (error) {
+        return reject(error);
+      }
+    });
+  }
+}
+class MaxAgeCacheControlStrategy extends CacheControlStrategy {
+  execute(options) {
+    const startTime = this.services.instrumentation ? this.services.instrumentation.currentTimeMs() : 0;
+    return this.services.cacheInclusionPolicy.read({
+      l1: this.filteredCache,
+      readFromL1: (l1) => this.requestRunner.readFromCache(l1)
+    }).then((value) => {
+      if (value.isOk()) {
+        this.collectCacheHitInstrumentation(
+          startTime,
+          options == null ? void 0 : options.instrumentationAttributes
+        );
+        return ok(void 0);
+      }
+      this.collectCacheMissInstrumentation(startTime, options == null ? void 0 : options.instrumentationAttributes);
+      const tempCache = this.filteredCache;
+      return new Promise(async (resolve, reject) => {
+        try {
+          let readResult = ok(void 0);
+          for await (const rfnResult of this.requestRunner.requestFromNetwork()) {
+            if (rfnResult) {
+              const result = await this.services.cacheInclusionPolicy.write({
+                l1: tempCache,
+                writeToL1: (l1) => this.requestRunner.writeToCache(l1, rfnResult)
+              });
+              if (result.isErr()) {
+                return resolve(err(result.error));
+              }
+            }
+            readResult = await this.services.cacheInclusionPolicy.read({
+              l1: tempCache,
+              readFromL1: (l1) => this.requestRunner.readFromCache(l1)
+            });
+            if (readResult.isOk()) {
+              resolve(ok(void 0));
+            }
+          }
+          return resolve(readResult);
+        } catch (e) {
+          return reject(e);
+        }
+      });
+    });
+  }
+  collectCacheHitInstrumentation(startTime, instrumentationAttributes) {
+    if (this.services.instrumentation) {
+      const meter = this.services.instrumentation.metrics.getMeter("onestore");
+      meter.createCounter(`command.max-age.cache-hit.count`).add(1, instrumentationAttributes);
+      meter.createHistogram(`command.max-age.cache-hit.duration`).record(
+        this.services.instrumentation.currentTimeMs() - startTime,
+        instrumentationAttributes
+      );
+    }
+  }
+  collectCacheMissInstrumentation(startTime, instrumentationAttributes) {
+    if (this.services.instrumentation) {
+      const meter = this.services.instrumentation.metrics.getMeter("onestore");
+      meter.createCounter(`command.max-age.cache-miss.count`).add(1, instrumentationAttributes);
+      meter.createHistogram(`command.max-age.cache-miss.duration`).record(
+        this.services.instrumentation.currentTimeMs() - startTime,
+        instrumentationAttributes
+      );
+    }
+  }
+  get expiredChecks() {
+    const config = this.config;
+    return [
+      ...super.expiredChecks,
+      (cacheControlMetadata) => {
+        return cacheControlMetadata.generatedTime + config.requestMaxAge < config.now;
+      }
+    ];
+  }
+}
+class OnlyIfCachedCacheControlStrategy extends CacheControlStrategy {
+  execute(options) {
+    const startTime = this.services.instrumentation ? this.services.instrumentation.currentTimeMs() : 0;
+    return this.services.cacheInclusionPolicy.read({
+      l1: this.filteredCache,
+      readFromL1: (l1) => this.requestRunner.readFromCache(l1)
+    }).then((result) => {
+      if (result.isOk()) {
+        this.collectCacheHitInstrumentation(
+          startTime,
+          options == null ? void 0 : options.instrumentationAttributes
+        );
+        return ok(void 0);
+      }
+      this.collectCacheMissInstrumentation(startTime, options == null ? void 0 : options.instrumentationAttributes);
+      const error = new UserVisibleError(
+        new FetchResponse(HttpStatusCode.GatewayTimeout, {
+          error: "Cache miss for only-if-cached request"
+        })
+      );
+      return err(error);
+    });
+  }
+  get expiredChecks() {
+    return [
+      (cacheControlMetadata) => cacheControlMetadata.type === "no-store"
+    ];
+  }
+  collectCacheHitInstrumentation(startTime, instrumentationAttributes) {
+    if (this.services.instrumentation) {
+      const meter = this.services.instrumentation.metrics.getMeter("onestore");
+      meter.createCounter(`command.only-if-cached.cache-hit.count`).add(1, instrumentationAttributes);
+      meter.createHistogram(
+        `command.only-if-cached.cache-hit.duration`
+      ).record(
+        this.services.instrumentation.currentTimeMs() - startTime,
+        instrumentationAttributes
+      );
+    }
+  }
+  collectCacheMissInstrumentation(startTime, instrumentationAttributes) {
+    if (this.services.instrumentation) {
+      const meter = this.services.instrumentation.metrics.getMeter("onestore");
+      meter.createCounter(`command.only-if-cached.cache-miss.count`).add(1, instrumentationAttributes);
+      meter.createHistogram(
+        `command.only-if-cached.cache-miss.duration`
+      ).record(
+        this.services.instrumentation.currentTimeMs() - startTime,
+        instrumentationAttributes
+      );
+    }
+  }
+}
+class CacheController {
+  constructor(services) {
+    this.services = services;
+  }
+  execute(config, requestRunner, options) {
+    const strategy = this.getCacheControlStrategy(config, requestRunner);
+    return strategy.execute(options);
+  }
+  getCacheControlStrategy(config, requestRunner) {
+    if (config.type === "max-age") {
+      return new MaxAgeCacheControlStrategy(this.services, config, requestRunner);
+    } else if (config.type === "no-cache") {
+      return new NoCacheCacheControlStrategy(this.services, config, requestRunner);
+    } else if (config.type === "only-if-cached") {
+      return new OnlyIfCachedCacheControlStrategy(this.services, config, requestRunner);
+    }
+    throw new Error(`Unknown cache control strategy ${config.type}`);
+  }
+  /**
+   * Finds cache entries that match the given query.
+   * Returns an async generator that yields `[key, entry]`.
+   */
+  async *find(query) {
+    yield* this.services.cacheInclusionPolicy.find(query);
+  }
+  /**
+   * Finds and modifies cache entries that match the given query.
+   * Extends `find(query)` and returns an async generator of modified keys.
+   */
+  async *findAndModify(query, cacheUpdate) {
+    yield* this.services.cacheInclusionPolicy.findAndModify(query, cacheUpdate);
+  }
+}
+function buildServiceDescriptor(cache, cacheInclusionPolicy, instrumentation) {
+  return {
+    type: "cacheController",
+    version: "1.0",
+    service: new CacheController({ cache, cacheInclusionPolicy, instrumentation })
+  };
+}
+export {
+  buildServiceDescriptor
+};
+//# sourceMappingURL=index.js.map

package/dist/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/v1/cache-control-strategies/cache-control-strategy.ts","../../src/v1/cache-control-strategies/no-cache-control-strategy.ts","../../src/v1/cache-control-strategies/max-age-cache-control-strategy.ts","../../src/v1/cache-control-strategies/only-if-cached-cache-control-strategy.ts","../../src/v1/cache-control.ts","../../src/v1/index.ts"],"sourcesContent":["import { SyncOrAsync, type Result } from '@conduit-client/utils';\nimport type { ExecuteOptions, RequestRunner } from '../cache-control';\nimport type {\n    CacheControlMetadata,\n    CacheEntry,\n    NamedCacheService,\n    Cache,\n} from '@conduit-client/service-cache/v1';\nimport type { MaxAgeRequestConfig } from './max-age-cache-control-strategy';\nimport type { NoCacheRequestConfig } from './no-cache-control-strategy';\nimport type { OnlyIfCachedRequestConfig } from './only-if-cached-cache-control-strategy';\nimport { NamedInstrumentationService } from '@conduit-client/service-instrumentation/v1';\nimport { NamedCacheInclusionPolicyService } from '@conduit-client/service-cache-inclusion-policy/v1';\n\nexport type CacheControlStrategyConfig =\n    | MaxAgeRequestConfig\n    | NoCacheRequestConfig\n    | OnlyIfCachedRequestConfig;\n\nexport abstract class CacheControlStrategy<NetworkResult, Error> {\n    filteredCache: Cache;\n    constructor(\n        protected services: NamedCacheService &\n            NamedCacheInclusionPolicyService &\n            Partial<NamedInstrumentationService>,\n        protected config: CacheControlStrategyConfig,\n        protected requestRunner: RequestRunner<NetworkResult, Error>\n    ) {\n        this.filteredCache = this.services.cache.filter((_, entry: CacheEntry<unknown>) => {\n            const { cacheControl } = entry.metadata;\n            return !this.expiredChecks.some((check) => check(cacheControl));\n        });\n    }\n\n    abstract execute(options?: ExecuteOptions): SyncOrAsync<Result<void, Error>>;\n\n    protected get expiredChecks() {\n        return [\n            (cacheControlMetadata: CacheControlMetadata) =>\n                cacheControlMetadata.type === 'max-age' &&\n                this.config.now > cacheControlMetadata.generatedTime + cacheControlMetadata.maxAge,\n            (cacheControlMetadata: CacheControlMetadata) =>\n                cacheControlMetadata.type === 'max-age' && cacheControlMetadata.maxAge <= 0,\n            (cacheControlMetadata: CacheControlMetadata) =>\n                cacheControlMetadata.type === 'no-store',\n            (cacheControlMetadata: CacheControlMetadata) =>\n                cacheControlMetadata.type === 'no-cache' &&\n                cacheControlMetadata.generatedTime < this.config.now,\n        ];\n    }\n}\n","import { err, ok, SyncOrAsync, type Result } from '@conduit-client/utils';\nimport { CacheControlStrategy } from './cache-control-strategy';\n\nexport type NoCacheRequestConfig = {\n    type: 'no-cache';\n    now: number; // seconds\n};\n\nexport class NoCacheCacheControlStrategy<NetworkResult, Error> extends CacheControlStrategy<\n    NetworkResult,\n    Error\n> {\n    execute(): SyncOrAsync<Result<void, Error>> {\n        // TODO - should be using wrapper here that suppresses no-store writes\n        const tempCache = this.filteredCache;\n        return new Promise(async (resolve, reject) => {\n            try {\n                let readResult: Result<void, Error> = ok(undefined);\n                for await (const rfnResult of this.requestRunner.requestFromNetwork()) {\n                    if (rfnResult) {\n                        const result = await this.services.cacheInclusionPolicy.write({\n                            l1: tempCache,\n                            writeToL1: (l1) => this.requestRunner.writeToCache(l1, rfnResult),\n                        });\n                        if (result.isErr()) {\n                            return resolve(result);\n                        }\n                    }\n                    // give readFromCache another shot at the cache\n                    readResult = await this.services.cacheInclusionPolicy.read({\n                        l1: tempCache,\n                        readFromL1: (l1) => this.requestRunner.readFromCache(l1),\n                    });\n                    if (readResult.isOk()) {\n                        resolve(readResult);\n                    }\n                }\n                return resolve(readResult);\n            } catch (error) {\n                return reject(error);\n            }\n        });\n    }\n}\n","import {\n    type Err,\n    err,\n    ok,\n    resolvedPromiseLike,\n    type Result,\n    type SyncOrAsync,\n} from '@conduit-client/utils';\nimport { CacheControlStrategy } from './cache-control-strategy';\nimport type { CacheControlMetadata, Cache } from '@conduit-client/service-cache/v1';\nimport type { ExecuteOptions } from '../cache-control';\nimport { InstrumentationAttributes } from '@conduit-client/service-instrumentation/v1';\n\nexport type MaxAgeRequestConfig = {\n    type: 'max-age';\n    requestMaxAge: number; // seconds\n    now: number; // seconds\n};\nexport class MaxAgeCacheControlStrategy<NetworkResult, Error> extends CacheControlStrategy<\n    NetworkResult,\n    Error\n> {\n    execute(options?: ExecuteOptions): SyncOrAsync<Result<void, Error>> {\n        const startTime: number = this.services.instrumentation\n            ? this.services.instrumentation.currentTimeMs()\n            : 0;\n\n        return this.services.cacheInclusionPolicy\n            .read({\n                l1: this.filteredCache,\n                readFromL1: (l1) => this.requestRunner.readFromCache(l1),\n            })\n            .then((value) => {\n                // ignore error from initial cache read\n                if (value.isOk()) {\n                    this.collectCacheHitInstrumentation(\n                        startTime,\n                        options?.instrumentationAttributes\n                    );\n                    return ok(undefined);\n                }\n\n                this.collectCacheMissInstrumentation(startTime, options?.instrumentationAttributes);\n\n                // initial cache read failed, awaits are ok beyond this point since the data\n                // must come from network requests\n                const tempCache = this.filteredCache;\n                return new Promise(async (resolve, reject) => {\n                    try {\n                        let readResult: Result<void, Error> = ok(undefined);\n                        for await (const rfnResult of this.requestRunner.requestFromNetwork()) {\n                            // async generator has a value to ingest\n                            if (rfnResult) {\n                                const result = await this.services.cacheInclusionPolicy.write({\n                                    l1: tempCache,\n                                    writeToL1: (l1) =>\n                                        this.requestRunner.writeToCache(l1, rfnResult),\n                                });\n                                if (result.isErr()) {\n                                    return resolve(err(result.error));\n                                }\n                            }\n\n                            // give readFromCache another shot at the cache\n                            readResult = await this.services.cacheInclusionPolicy.read({\n                                l1: tempCache,\n                                readFromL1: (l1) => this.requestRunner.readFromCache(l1),\n                            });\n                            if (readResult.isOk()) {\n                                resolve(ok(undefined));\n                            }\n                        }\n                        return resolve(readResult);\n                    } catch (e) {\n                        return reject(e);\n                    }\n                });\n            });\n    }\n\n    private collectCacheHitInstrumentation(\n        startTime: number,\n        instrumentationAttributes: InstrumentationAttributes | undefined\n    ) {\n        if (this.services.instrumentation) {\n            const meter = this.services.instrumentation.metrics.getMeter('onestore');\n            meter\n                .createCounter<InstrumentationAttributes>(`command.max-age.cache-hit.count`)\n                .add(1, instrumentationAttributes);\n            meter\n                .createHistogram<InstrumentationAttributes>(`command.max-age.cache-hit.duration`)\n                .record(\n                    this.services.instrumentation.currentTimeMs() - startTime,\n                    instrumentationAttributes\n                );\n        }\n    }\n\n    private collectCacheMissInstrumentation(\n        startTime: number,\n        instrumentationAttributes: InstrumentationAttributes | undefined\n    ) {\n        if (this.services.instrumentation) {\n            const meter = this.services.instrumentation.metrics.getMeter('onestore');\n            meter\n                .createCounter<InstrumentationAttributes>(`command.max-age.cache-miss.count`)\n                .add(1, instrumentationAttributes);\n            meter\n                .createHistogram<InstrumentationAttributes>(`command.max-age.cache-miss.duration`)\n                .record(\n                    this.services.instrumentation.currentTimeMs() - startTime,\n                    instrumentationAttributes\n                );\n        }\n    }\n\n    protected get expiredChecks() {\n        const config = this.config as MaxAgeRequestConfig;\n        return [\n            ...super.expiredChecks,\n            (cacheControlMetadata: CacheControlMetadata) => {\n                return cacheControlMetadata.generatedTime + config.requestMaxAge < config.now;\n            },\n        ];\n    }\n}\n","import {\n    err,\n    type Result,\n    type SyncOrAsync,\n    FetchResponse,\n    HttpStatusCode,\n    UserVisibleError,\n    ok,\n} from '@conduit-client/utils';\nimport { CacheControlStrategy } from './cache-control-strategy';\nimport type { CacheControlMetadata } from '@conduit-client/service-cache/v1';\nimport type { ExecuteOptions } from '../cache-control';\nimport { InstrumentationAttributes } from '@conduit-client/service-instrumentation/v1';\n\nexport type OnlyIfCachedRequestConfig = {\n    type: 'only-if-cached';\n    now: number; // seconds\n};\n\n/**\n * Only-if-cached strategy:\n * - Never performs a network request\n * - Returns cached data if present\n * - Allows serving stale entries per RFC 9111 (only-if-cached may be satisfied by a stored response)\n * - Excludes no-store entries\n */\nexport class OnlyIfCachedCacheControlStrategy<NetworkResult, Error> extends CacheControlStrategy<\n    NetworkResult,\n    Error\n> {\n    execute(options?: ExecuteOptions): SyncOrAsync<Result<void, Error>> {\n        const startTime: number = this.services.instrumentation\n            ? this.services.instrumentation.currentTimeMs()\n            : 0;\n\n        return this.services.cacheInclusionPolicy\n            .read({\n                l1: this.filteredCache,\n                readFromL1: (l1) => this.requestRunner.readFromCache(l1),\n            })\n            .then((result) => {\n                if (result.isOk()) {\n                    this.collectCacheHitInstrumentation(\n                        startTime,\n                        options?.instrumentationAttributes\n                    );\n                    return ok(undefined);\n                }\n                this.collectCacheMissInstrumentation(startTime, options?.instrumentationAttributes);\n                const error = new UserVisibleError(\n                    new FetchResponse(HttpStatusCode.GatewayTimeout, {\n                        error: 'Cache miss for only-if-cached request',\n                    })\n                );\n                return err(error as unknown as Error);\n            });\n    }\n\n    protected get expiredChecks() {\n        // Allow stale cached entries (max-age expired or no-cache) to be used.\n        // Still exclude no-store entries.\n        return [\n            (cacheControlMetadata: CacheControlMetadata) =>\n                cacheControlMetadata.type === 'no-store',\n        ];\n    }\n\n    private collectCacheHitInstrumentation(\n        startTime: number,\n        instrumentationAttributes: InstrumentationAttributes | undefined\n    ) {\n        if (this.services.instrumentation) {\n            const meter = this.services.instrumentation.metrics.getMeter('onestore');\n            meter\n                .createCounter<InstrumentationAttributes>(`command.only-if-cached.cache-hit.count`)\n                .add(1, instrumentationAttributes);\n            meter\n                .createHistogram<InstrumentationAttributes>(\n                    `command.only-if-cached.cache-hit.duration`\n                )\n                .record(\n                    this.services.instrumentation.currentTimeMs() - startTime,\n                    instrumentationAttributes\n                );\n        }\n    }\n\n    private collectCacheMissInstrumentation(\n        startTime: number,\n        instrumentationAttributes: InstrumentationAttributes | undefined\n    ) {\n        if (this.services.instrumentation) {\n            const meter = this.services.instrumentation.metrics.getMeter('onestore');\n            meter\n                .createCounter<InstrumentationAttributes>(`command.only-if-cached.cache-miss.count`)\n                .add(1, instrumentationAttributes);\n            meter\n                .createHistogram<InstrumentationAttributes>(\n                    `command.only-if-cached.cache-miss.duration`\n                )\n                .record(\n                    this.services.instrumentation.currentTimeMs() - startTime,\n                    instrumentationAttributes\n                );\n        }\n    }\n}\n","import { type SyncOrAsync, type Result, DeepReadonly } from '@conduit-client/utils';\nimport { NoCacheCacheControlStrategy } from './cache-control-strategies/no-cache-control-strategy';\nimport { MaxAgeCacheControlStrategy } from './cache-control-strategies/max-age-cache-control-strategy';\nimport { OnlyIfCachedCacheControlStrategy } from './cache-control-strategies/only-if-cached-cache-control-strategy';\nimport type {\n    CacheControlStrategy,\n    CacheControlStrategyConfig,\n} from './cache-control-strategies/cache-control-strategy';\nimport type {\n    Cache,\n    CacheEntry,\n    NamedCacheService,\n    Key,\n    ReadonlyCache,\n} from '@conduit-client/service-cache/v1';\nimport type {\n    InstrumentationAttributes,\n    NamedInstrumentationService,\n} from '@conduit-client/service-instrumentation/v1';\nimport {\n    NamedCacheInclusionPolicyService,\n    CacheQuery,\n    CacheUpdate,\n} from '@conduit-client/service-cache-inclusion-policy/v1';\n\n/**\n * A class that exposes access for\n * - reading from a cache\n * - writing to a cache\n * - making a network request\n *\n * This allows the cache controller to run these methods in any order\n * based on the canonical & requested cache control metadata, without having\n * to understand the inner workings of these functions\n */\nexport type RequestRunner<NetworkResult, E> = {\n    readFromCache: (cache: ReadonlyCache) => SyncOrAsync<Result<void, E>>;\n    requestFromNetwork: () => AsyncGenerator<NetworkResult | undefined, void, void>;\n    writeToCache: (cache: Cache, networkResult: NetworkResult) => SyncOrAsync<Result<void, E>>;\n};\n\nexport type ExecuteOptions = {\n    instrumentationAttributes?: InstrumentationAttributes;\n};\n\n/**\n * A class that allows the execution of requested cache control strategies,\n * while also enforcing the canonical cache control metadata.\n */\nexport class CacheController {\n    constructor(\n        protected services: NamedCacheService &\n            NamedCacheInclusionPolicyService &\n            Partial<NamedInstrumentationService>\n    ) {}\n\n    execute<NetworkResult, E = unknown>(\n        config: CacheControlStrategyConfig,\n        requestRunner: RequestRunner<NetworkResult, E>,\n        options?: ExecuteOptions\n    ) {\n        const strategy = this.getCacheControlStrategy<NetworkResult, E>(config, requestRunner);\n        return strategy.execute(options);\n    }\n\n    private getCacheControlStrategy<NetworkResult, Error>(\n        config: CacheControlStrategyConfig,\n        requestRunner: RequestRunner<NetworkResult, Error>\n    ): CacheControlStrategy<NetworkResult, Error> {\n        if (config.type === 'max-age') {\n            return new MaxAgeCacheControlStrategy(this.services, config, requestRunner);\n        } else if (config.type === 'no-cache') {\n            return new NoCacheCacheControlStrategy(this.services, config, requestRunner);\n        } else if (config.type === 'only-if-cached') {\n            return new OnlyIfCachedCacheControlStrategy(this.services, config, requestRunner);\n        }\n\n        throw new Error(`Unknown cache control strategy ${(config as any).type}`);\n    }\n\n    /**\n     * Finds cache entries that match the given query.\n     * Returns an async generator that yields `[key, entry]`.\n     */\n    async *find(\n        query: CacheQuery\n    ): AsyncGenerator<[key: Key, value: DeepReadonly<CacheEntry<unknown>>], void, unknown> {\n        yield* this.services.cacheInclusionPolicy.find(query);\n    }\n\n    /**\n     * Finds and modifies cache entries that match the given query.\n     * Extends `find(query)` and returns an async generator of modified keys.\n     */\n    async *findAndModify(\n        query: CacheQuery,\n        cacheUpdate: CacheUpdate\n    ): AsyncGenerator<Key, void, unknown> {\n        yield* this.services.cacheInclusionPolicy.findAndModify(query, cacheUpdate);\n    }\n}\n","import { CacheController } from './cache-control';\nimport type { ServiceDescriptor, NamedService, PublicInterface } from '@conduit-client/utils';\nimport type { Cache } from '@conduit-client/service-cache/v1';\nimport type { CacheInclusionPolicyService } from '@conduit-client/service-cache-inclusion-policy/v1';\nimport { InstrumentationService } from '@conduit-client/service-instrumentation/v1';\nexport type { CacheControlStrategyConfig } from './cache-control-strategies';\n\nexport type { RequestRunner } from './cache-control';\n\nexport type ICacheController = PublicInterface<CacheController>;\n\nexport type NamedCacheControllerService<Name extends string = 'cacheController'> = NamedService<\n    Name,\n    ICacheController\n>;\n\nexport type CacheControllerServiceDescriptor = ServiceDescriptor<\n    ICacheController,\n    'cacheController',\n    '1.0'\n>;\n\nexport function buildServiceDescriptor(\n    cache: Cache,\n    cacheInclusionPolicy: CacheInclusionPolicyService,\n    instrumentation?: InstrumentationService\n): CacheControllerServiceDescriptor {\n    return {\n        type: 'cacheController',\n        version: '1.0',\n        service: new CacheController({ cache, cacheInclusionPolicy, instrumentation }),\n    };\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "@conduit-client/service-cache-control",
+    "version": "2.0.0",
+    "private": false,
+    "description": "OneStore Cache Control Service definition",
+    "type": "module",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/salesforce-experience-platform-emu/luvio-next.git",
+        "directory": "packages/@conduit-client/services/cache-control"
+    },
+    "license": "SEE LICENSE IN LICENSE.txt",
+    "exports": {
+        "./v1": {
+            "import": "./dist/v1/index.js",
+            "types": "./dist/types/v1/index.d.ts",
+            "require": "./dist/v1/index.js"
+        }
+    },
+    "main": "dist/index.js",
+    "module": "./dist/main/index.js",
+    "types": "dist/types/index.d.ts",
+    "files": [
+        "dist/"
+    ],
+    "scripts": {
+        "build": "vite build && tsc --build --emitDeclarationOnly",
+        "clean": "rm -rf dist",
+        "test": "vitest run",
+        "test:size": "size-limit",
+        "watch": "npm run build --watch"
+    },
+    "dependencies": {
+        "@conduit-client/service-cache": "2.0.0",
+        "@conduit-client/service-cache-inclusion-policy": "2.0.0",
+        "@conduit-client/utils": "2.0.0"
+    },
+    "volta": {
+        "extends": "../../../../package.json"
+    },
+    "size-limit": [
+        {
+            "path": "./dist/v1/index.js",
+            "limit": "2.6 kB"
+        }
+    ]
+}