@conduit-client/service-provisioner 3.7.1 → 3.8.0

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

@@ -33,6 +33,22 @@ export type RequestedService<R extends ServiceRequest<any>> = R extends Optional
 export type RequestedServices<R extends ServicesRequest<any>> = {
     [k in keyof R]: RequestedService<R[k]>;
 };
+/**
+ * A function that attempts to resolve a set of requested services. A runtime
+ * environment must provide a ServiceResolver to enable service consumers to
+ * request services. buildStaticServiceResolver() and buildDynamicServiceResolver()
+ * can be used to create resolvers for scenarios where the full set of services is
+ * known ahead of time.
+ */
+export type ServiceResolver<R extends ServicesRequest<any>> = (requested: R) => PromiseLike<[resolved: RequestedServices<R>, unresolved: Array<keyof R>]>;
+/**
+ * Indicates if a published service satisfies a given service request.
+ *
+ * @param service published service
+ * @param request requested service
+ * @returns true if the published service satisfies the request; false otherwise
+ */
+export declare function serviceSatisfies(service: PublishedService, request: ServiceRequest<ServiceDescriptor<unknown>>): boolean;
 /**
  * Attempts to resolve a set of requested services against a set of published services.
  * Returns a map of the requested services if the published services satisfy the request;
@@ -42,6 +58,9 @@ export type RequestedServices<R extends ServicesRequest<any>> = {
  * override the default getServices() implementation below. Service consumers should only
  * use the default export to request the services they need.
  *
+ * This function is provided for legacy use only. New code should use resolvers and/or
+ * serviceSatisfies() instead.
+ *
  * @param published published services
  * @param requested requested services
  * @returns service map if published satisfies requests; undefined if not
@@ -76,3 +95,34 @@ export default function getServices<R extends ServicesRequest<any>>(request: R,
  * @param services services to be used to satisfy future getServices() requests
  */
 export declare function setServices(services: PublishedService[]): void;
+/**
+ * Sets the service resolver that will be used to satisfy calls to getServices().
+ * Any previously registered service resolver is replaced with the resolver provided.
+ * Note overwriting resolvers should be done with great care as previous callers
+ * of getServices() will not be aware of the new resolver.
+ *
+ * @param resolver service resolver
+ */
+export declare function setServiceResolver(resolver: ServiceResolver<any>): void;
+/**
+ * Builds a service resolver that will resolve against the supplied static set of services.
+ *
+ * Note that the returned resolver is functionally equivalent to one returned by
+ * buildDynamicServiceResolver() when only static services are supplied. This function
+ * is preferred when all services are statically created and bootstrap size is a concern.
+ *
+ * @param services statically-defined services
+ * @returns a ServiceResolver that resolves against the supplied services
+ */
+export declare function buildStaticServiceResolver<R extends ServicesRequest<ServiceDescriptor<unknown>>>(services: PublishedService[]): ServiceResolver<R>;
+/**
+ * Builds a service resolver that will resolve against the supplied set of satic & dynamic
+ * services.
+ *
+ * @param services set of statically-defined services, or builder functions for dynamically-
+ *    defined services
+ * @returns a ServiceResolver that resolves against the supplied services
+ */
+export declare function buildDynamicServiceResolver<R extends ServicesRequest<ServiceDescriptor<unknown>>>(services: Array<PublishedService | (Omit<PublishedService, 'service'> & {
+    builder: (request: ServiceRequest<ServiceDescriptor<unknown>>) => PromiseLike<PublishedService>;
+})>): ServiceResolver<R>;

package/dist/v1/index.js

@@ -4,40 +4,45 @@
  * For full license text, see the LICENSE.txt file
  */
 import { racesync, satisfies, resolvedPromiseLike } from "@conduit-client/utils";
+function serviceSatisfies(service, request) {
+  return (
+    // service types must match
+    service.type === request.type && // version of the service must satisfy the requested version
+    satisfies(service.version, request.version) && // no tags requested, or the service matches every requested tag value
+    (request.tags === void 0 || Object.keys(request.tags).every((tag) => {
+      var _a;
+      return ((_a = service.tags) == null ? void 0 : _a[tag]) === request.tags[tag];
+    }))
+  );
+}
 function resolve(published, requested) {
-  const result = {};
-  for (const [name, request] of Object.entries(requested)) {
-    const matchingService = published.find(
-      (s) => (
-        // service types must match
-        s.type === request.type && // version of the service must satisfy the requested version
-        satisfies(s.version, request.version) && // no tags requested, or the service matches every requested tag value
-        (request.tags === void 0 || Object.keys(request.tags).every((tag) => {
-          var _a;
-          return ((_a = s.tags) == null ? void 0 : _a[tag]) === request.tags[tag];
-        }))
-      )
-    );
+  const resolved = {};
+  for (const [name, req] of Object.entries(requested)) {
+    const matchingService = published.find((s) => serviceSatisfies(s, req));
     if (matchingService) {
-      result[name] = matchingService.service;
-    } else if (!("optional" in request && request.optional)) {
-      return;
+      resolved[name] = matchingService.service;
+    } else if (!("optional" in req && req.optional)) {
+      return void 0;
     }
   }
-  return result;
+  return resolved;
 }
-let servicesAvailable;
-let waitForServices = new Promise(
-  (resolve2) => servicesAvailable = resolve2
+let resolverAvailable;
+let waitForResolver = new Promise(
+  (resolve2) => resolverAvailable = resolve2
 );
 function getServices(request, timeout = 3e4) {
-  const servicesPromise = waitForServices.then((services) => {
-    const result = resolve(services, request);
-    if (result) {
-      return result;
-    }
-    throw new Error("no matches found for one or more requested services");
-  });
+  const servicesPromise = waitForResolver.then(
+    (resolver) => (
+      // try to resolve the requested services against our services
+      resolver(request).then(([resolved, unresolved]) => {
+        if (unresolved.length === 0) {
+          return resolved;
+        }
+        throw new Error("no matches found for one or more requested services");
+      })
+    )
+  );
   let timeoutId;
   let timeoutPromise = new Promise((_, reject) => {
     timeoutId = setTimeout(() => reject(new Error("OneStore services unavailable")), timeout);
@@ -55,12 +60,77 @@ function getServices(request, timeout = 3e4) {
   );
 }
 function setServices(services) {
-  waitForServices = resolvedPromiseLike(services);
-  servicesAvailable(services);
+  setServiceResolver(buildStaticServiceResolver(services));
+}
+function setServiceResolver(resolver) {
+  waitForResolver = resolvedPromiseLike(resolver);
+  resolverAvailable(resolver);
+}
+function buildStaticServiceResolver(services) {
+  return (requested) => {
+    const resolved = {};
+    const unresolved = [];
+    for (const [name, req] of Object.entries(requested)) {
+      const matchingService = services.find((s) => serviceSatisfies(s, req));
+      if (matchingService) {
+        resolved[name] = matchingService.service;
+      } else if (!("optional" in req && req.optional)) {
+        unresolved.push(name);
+      }
+    }
+    return resolvedPromiseLike([resolved, unresolved]);
+  };
+}
+function buildDynamicServiceResolver(services) {
+  const currentServices = services.map((svc) => Object.assign({ service: void 0 }, svc));
+  return (requested) => {
+    const resolved = {};
+    const pending = [];
+    const unresolved = [];
+    Object.entries(requested).forEach(([name, req]) => {
+      const matchingService = currentServices.find((s) => serviceSatisfies(s, req));
+      if (matchingService == null ? void 0 : matchingService.service) {
+        resolved[name] = matchingService.service;
+      } else if (matchingService == null ? void 0 : matchingService.promise) {
+        pending.push(
+          matchingService.promise.then((builtService) => {
+            resolved[name] = builtService.service;
+          })
+        );
+      } else if (matchingService == null ? void 0 : matchingService.builder) {
+        matchingService.promise = matchingService.builder(req);
+        pending.push(
+          matchingService.promise.then(
+            (builtService) => {
+              resolved[name] = matchingService.service = builtService.service;
+              matchingService.promise = void 0;
+            },
+            (error) => {
+              console.error(
+                `failed to build service ${matchingService.type}/${matchingService.version}: ${error}`
+              );
+              matchingService.promise = void 0;
+              throw error;
+            }
+          )
+        );
+      } else if (!("optional" in req && req.optional)) {
+        unresolved.push(name);
+      }
+    });
+    if (pending.length > 0) {
+      return Promise.all(pending).then(() => [resolved, unresolved]);
+    }
+    return resolvedPromiseLike([resolved, unresolved]);
+  };
 }
 export {
+  buildDynamicServiceResolver,
+  buildStaticServiceResolver,
   getServices as default,
   resolve,
+  serviceSatisfies,
+  setServiceResolver,
   setServices
 };
 //# sourceMappingURL=index.js.map

package/dist/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/v1/index.ts"],"sourcesContent":["import {\n    resolvedPromiseLike,\n    racesync,\n    satisfies,\n    type ServiceDescriptor,\n} from '@conduit-client/utils';\n\n/**\n * When a service instance is registered it can have additional tags associated with it.\n * Service consumers can use these tags to discriminate among otherwise equivalent\n * instances of the service.\n */\nexport type PublishedService = ServiceDescriptor<unknown> & {\n    tags?: Record<string, string>;\n};\n\n/**\n * A request for a required single service.\n */\nexport type ServiceRequest<D extends ServiceDescriptor<unknown>> = Omit<D, 'service'> & {\n    tags?: Record<string, string>;\n};\n\n/**\n * A request for an optional single service.\n */\nexport type OptionalServiceRequest<D extends ServiceDescriptor<unknown>> = ServiceRequest<D> & {\n    optional: true;\n};\n\n/**\n * A request for a set of services.\n */\nexport type ServicesRequest<\n    D extends ServiceDescriptor<unknown>,\n    Name extends string = D['type'],\n> = Record<Name, ServiceRequest<D> | OptionalServiceRequest<D>>;\n\n/**\n * Utility type to extract the service implementation type from a ServiceRequest.\n */\nexport type RequestedService<R extends ServiceRequest<any>> =\n    R extends OptionalServiceRequest<ServiceDescriptor<infer S>>\n        ? S | undefined\n        : R extends ServiceRequest<ServiceDescriptor<infer S>>\n          ? S\n          : never;\n\n/**\n * A map of services that matches a given ServicesRequest.\n */\nexport type RequestedServices<R extends ServicesRequest<any>> = {\n    [k in keyof R]: RequestedService<R[k]>;\n};\n\n/**\n * Attempts to resolve a set of requested services against a set of published services.\n * Returns a map of the requested services if the published services satisfy the request;\n * undefined if published services are missing one or more of the requested services.\n *\n * Note that this function is exported ONLY for use by runtime environments that need to\n * override the default getServices() implementation below. Service consumers should only\n * use the default export to request the services they need.\n *\n * @param published published services\n * @param requested requested services\n * @returns service map if published satisfies requests; undefined if not\n */\nexport function resolve<R extends ServicesRequest<ServiceDescriptor<unknown>>>(\n    published: PublishedService[],\n    requested: R\n): RequestedServices<R> | undefined {\n    const result: RequestedServices<R> = {} as any;\n\n    for (const [name, request] of Object.entries(requested)) {\n        const matchingService = published.find(\n            (s) =>\n                // service types must match\n                s.type === request.type &&\n                // version of the service must satisfy the requested version\n                satisfies(s.version, request.version) &&\n                // no tags requested, or the service matches every requested tag value\n                (request.tags === undefined ||\n                    Object.keys(request.tags).every((tag) => s.tags?.[tag] === request.tags![tag]))\n        );\n\n        if (matchingService) {\n            (result as any)[name] = matchingService.service;\n        } else if (!('optional' in request && request.optional)) {\n            return;\n        }\n    }\n\n    return result;\n}\n\n/**\n * Most-recently set of published services.\n */\nlet servicesAvailable: (services: PublishedService[]) => void;\nlet waitForServices: PromiseLike<PublishedService[]> = new Promise<PublishedService[]>(\n    (resolve) => (servicesAvailable = resolve)\n);\n\n/**\n * Requests a given set of services from the runtime environment.\n *\n * The default implementation of this function guarantees that the return\n * PromiseLike will be resolved synchronously. That is, one of the functions\n * supplied to its .then() will be invoked before .then() returns. Overrides\n * of this function SHOULD preserve this behavior whenever possible, as\n * some service consumer initialization patterns cannot support asynchronous\n * initialization of services.\n *\n * @param request requested services\n * @returns PromiseLike for the requested services; rejects if the requested\n *    services are not available\n */\nexport default function getServices<R extends ServicesRequest<any>>(\n    request: R,\n    timeout: number = 30000\n): PromiseLike<RequestedServices<R>> {\n    const servicesPromise = waitForServices.then((services) => {\n        // try to resolve the requested services against our services\n        const result = resolve(services, request);\n\n        // resolve/reject based on whether we have all the requested services\n        if (result) {\n            return result;\n        }\n\n        throw new Error('no matches found for one or more requested services');\n    });\n\n    let timeoutId: ReturnType<typeof setTimeout>;\n    let timeoutPromise = new Promise<never>((_, reject) => {\n        timeoutId = setTimeout(() => reject(new Error('OneStore services unavailable')), timeout);\n    });\n\n    return racesync([servicesPromise, timeoutPromise]).then(\n        (value) => {\n            clearTimeout(timeoutId);\n            return value;\n        },\n        (reason) => {\n            clearTimeout(timeoutId);\n            // eslint-disable-next-line\n            console.error(reason);\n            throw reason;\n        }\n    );\n}\n\n/**\n * Sets the services that will be used to satisfy calls to getServices().\n * Any previously registered services are replaced with the services provided.\n * Note overwriting services should be done with great care as previous callers\n * of getServices() will not be aware of the new services.\n * \n * The default implementation provided by this module only supports a single\n * set of active services. Runtime environments that require multiple sets of\n * active services will need to override this module with their own\n * implementation.\n \n * @param services services to be used to satisfy future getServices() requests\n */\nexport function setServices(services: PublishedService[]) {\n    waitForServices = resolvedPromiseLike(services);\n    servicesAvailable(services);\n}\n"],"names":["resolve"],"mappings":";;;;;;AAoEO,SAAS,QACZ,WACA,WACgC;AAChC,QAAM,SAA+B,CAAA;AAErC,aAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,SAAS,GAAG;AACrD,UAAM,kBAAkB,UAAU;AAAA,MAC9B,CAAC;AAAA;AAAA,QAEG,EAAE,SAAS,QAAQ;AAAA,QAEnB,UAAU,EAAE,SAAS,QAAQ,OAAO;AAAA,SAEnC,QAAQ,SAAS,UACd,OAAO,KAAK,QAAQ,IAAI,EAAE,MAAM,CAAC,QAAA;;AAAQ,0BAAE,SAAF,mBAAS,UAAS,QAAQ,KAAM,GAAG;AAAA,SAAC;AAAA;AAAA,IAAA;AAGzF,QAAI,iBAAiB;AAChB,aAAe,IAAI,IAAI,gBAAgB;AAAA,IAC5C,WAAW,EAAE,cAAc,WAAW,QAAQ,WAAW;AACrD;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO;AACX;AAKA,IAAI;AACJ,IAAI,kBAAmD,IAAI;AAAA,EACvD,CAACA,aAAa,oBAAoBA;AACtC;AAgBA,SAAwB,YACpB,SACA,UAAkB,KACe;AACjC,QAAM,kBAAkB,gBAAgB,KAAK,CAAC,aAAa;AAEvD,UAAM,SAAS,QAAQ,UAAU,OAAO;AAGxC,QAAI,QAAQ;AACR,aAAO;AAAA,IACX;AAEA,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACzE,CAAC;AAED,MAAI;AACJ,MAAI,iBAAiB,IAAI,QAAe,CAAC,GAAG,WAAW;AACnD,gBAAY,WAAW,MAAM,OAAO,IAAI,MAAM,+BAA+B,CAAC,GAAG,OAAO;AAAA,EAC5F,CAAC;AAED,SAAO,SAAS,CAAC,iBAAiB,cAAc,CAAC,EAAE;AAAA,IAC/C,CAAC,UAAU;AACP,mBAAa,SAAS;AACtB,aAAO;AAAA,IACX;AAAA,IACA,CAAC,WAAW;AACR,mBAAa,SAAS;AAEtB,cAAQ,MAAM,MAAM;AACpB,YAAM;AAAA,IACV;AAAA,EAAA;AAER;AAeO,SAAS,YAAY,UAA8B;AACtD,oBAAkB,oBAAoB,QAAQ;AAC9C,oBAAkB,QAAQ;AAC9B;"}
+{"version":3,"file":"index.js","sources":["../../src/v1/index.ts"],"sourcesContent":["import {\n    resolvedPromiseLike,\n    racesync,\n    satisfies,\n    type ServiceDescriptor,\n} from '@conduit-client/utils';\n\n/**\n * When a service instance is registered it can have additional tags associated with it.\n * Service consumers can use these tags to discriminate among otherwise equivalent\n * instances of the service.\n */\nexport type PublishedService = ServiceDescriptor<unknown> & {\n    tags?: Record<string, string>;\n};\n\n/**\n * A request for a required single service.\n */\nexport type ServiceRequest<D extends ServiceDescriptor<unknown>> = Omit<D, 'service'> & {\n    tags?: Record<string, string>;\n};\n\n/**\n * A request for an optional single service.\n */\nexport type OptionalServiceRequest<D extends ServiceDescriptor<unknown>> = ServiceRequest<D> & {\n    optional: true;\n};\n\n/**\n * A request for a set of services.\n */\nexport type ServicesRequest<\n    D extends ServiceDescriptor<unknown>,\n    Name extends string = D['type'],\n> = Record<Name, ServiceRequest<D> | OptionalServiceRequest<D>>;\n\n/**\n * Utility type to extract the service implementation type from a ServiceRequest.\n */\nexport type RequestedService<R extends ServiceRequest<any>> =\n    R extends OptionalServiceRequest<ServiceDescriptor<infer S>>\n        ? S | undefined\n        : R extends ServiceRequest<ServiceDescriptor<infer S>>\n          ? S\n          : never;\n\n/**\n * A map of services that matches a given ServicesRequest.\n */\nexport type RequestedServices<R extends ServicesRequest<any>> = {\n    [k in keyof R]: RequestedService<R[k]>;\n};\n\n/**\n * A function that attempts to resolve a set of requested services. A runtime\n * environment must provide a ServiceResolver to enable service consumers to\n * request services. buildStaticServiceResolver() and buildDynamicServiceResolver()\n * can be used to create resolvers for scenarios where the full set of services is\n * known ahead of time.\n */\nexport type ServiceResolver<R extends ServicesRequest<any>> = (\n    requested: R\n) => PromiseLike<[resolved: RequestedServices<R>, unresolved: Array<keyof R>]>;\n\n/**\n * Indicates if a published service satisfies a given service request.\n *\n * @param service published service\n * @param request requested service\n * @returns true if the published service satisfies the request; false otherwise\n */\nexport function serviceSatisfies(\n    service: PublishedService,\n    request: ServiceRequest<ServiceDescriptor<unknown>>\n): boolean {\n    return (\n        // service types must match\n        service.type === request.type &&\n        // version of the service must satisfy the requested version\n        satisfies(service.version, request.version) &&\n        // no tags requested, or the service matches every requested tag value\n        (request.tags === undefined ||\n            Object.keys(request.tags).every((tag) => service.tags?.[tag] === request.tags![tag]))\n    );\n}\n\n/**\n * Attempts to resolve a set of requested services against a set of published services.\n * Returns a map of the requested services if the published services satisfy the request;\n * undefined if published services are missing one or more of the requested services.\n *\n * Note that this function is exported ONLY for use by runtime environments that need to\n * override the default getServices() implementation below. Service consumers should only\n * use the default export to request the services they need.\n *\n * This function is provided for legacy use only. New code should use resolvers and/or\n * serviceSatisfies() instead.\n *\n * @param published published services\n * @param requested requested services\n * @returns service map if published satisfies requests; undefined if not\n */\nexport function resolve<R extends ServicesRequest<ServiceDescriptor<unknown>>>(\n    published: PublishedService[],\n    requested: R\n): RequestedServices<R> | undefined {\n    const resolved: RequestedServices<R> = {} as any;\n    const unresolved: Array<keyof R> = [];\n\n    for (const [name, req] of Object.entries(requested)) {\n        const matchingService = published.find((s) => serviceSatisfies(s, req));\n\n        if (matchingService) {\n            (resolved as any)[name] = matchingService.service;\n        } else if (!('optional' in req && req.optional)) {\n            return undefined;\n        }\n    }\n\n    return resolved;\n}\n\n/**\n * Most-recently set resolver.\n */\nlet resolverAvailable: (resolver: ServiceResolver<any>) => void;\nlet waitForResolver: PromiseLike<ServiceResolver<any>> = new Promise<ServiceResolver<any>>(\n    (resolve) => (resolverAvailable = resolve)\n);\n\n/**\n * Requests a given set of services from the runtime environment.\n *\n * The default implementation of this function guarantees that the return\n * PromiseLike will be resolved synchronously. That is, one of the functions\n * supplied to its .then() will be invoked before .then() returns. Overrides\n * of this function SHOULD preserve this behavior whenever possible, as\n * some service consumer initialization patterns cannot support asynchronous\n * initialization of services.\n *\n * @param request requested services\n * @returns PromiseLike for the requested services; rejects if the requested\n *    services are not available\n */\nexport default function getServices<R extends ServicesRequest<any>>(\n    request: R,\n    timeout: number = 30000\n): PromiseLike<RequestedServices<R>> {\n    const servicesPromise = waitForResolver.then((resolver) =>\n        // try to resolve the requested services against our services\n        resolver(request).then(([resolved, unresolved]) => {\n            if (unresolved.length === 0) {\n                return resolved;\n            }\n\n            throw new Error('no matches found for one or more requested services');\n        })\n    );\n\n    let timeoutId: ReturnType<typeof setTimeout>;\n    let timeoutPromise = new Promise<never>((_, reject) => {\n        timeoutId = setTimeout(() => reject(new Error('OneStore services unavailable')), timeout);\n    });\n\n    return racesync([servicesPromise, timeoutPromise]).then(\n        (value) => {\n            clearTimeout(timeoutId);\n            return value;\n        },\n        (reason) => {\n            clearTimeout(timeoutId);\n            // eslint-disable-next-line\n            console.error(reason);\n            throw reason;\n        }\n    );\n}\n\n/**\n * Sets the services that will be used to satisfy calls to getServices().\n * Any previously registered services are replaced with the services provided.\n * Note overwriting services should be done with great care as previous callers\n * of getServices() will not be aware of the new services.\n * \n * The default implementation provided by this module only supports a single\n * set of active services. Runtime environments that require multiple sets of\n * active services will need to override this module with their own\n * implementation.\n \n * @param services services to be used to satisfy future getServices() requests\n */\nexport function setServices(services: PublishedService[]) {\n    setServiceResolver(buildStaticServiceResolver(services));\n}\n\n/**\n * Sets the service resolver that will be used to satisfy calls to getServices().\n * Any previously registered service resolver is replaced with the resolver provided.\n * Note overwriting resolvers should be done with great care as previous callers\n * of getServices() will not be aware of the new resolver.\n *\n * @param resolver service resolver\n */\nexport function setServiceResolver(resolver: ServiceResolver<any>) {\n    waitForResolver = resolvedPromiseLike(resolver);\n    resolverAvailable(resolver);\n}\n\n/**\n * Builds a service resolver that will resolve against the supplied static set of services.\n *\n * Note that the returned resolver is functionally equivalent to one returned by\n * buildDynamicServiceResolver() when only static services are supplied. This function\n * is preferred when all services are statically created and bootstrap size is a concern.\n *\n * @param services statically-defined services\n * @returns a ServiceResolver that resolves against the supplied services\n */\nexport function buildStaticServiceResolver<R extends ServicesRequest<ServiceDescriptor<unknown>>>(\n    services: PublishedService[]\n): ServiceResolver<R> {\n    return (requested: R) => {\n        const resolved: RequestedServices<R> = {} as any;\n        const unresolved: Array<keyof R> = [];\n\n        for (const [name, req] of Object.entries(requested)) {\n            const matchingService = services.find((s) => serviceSatisfies(s, req));\n\n            if (matchingService) {\n                (resolved as any)[name] = matchingService.service;\n            } else if (!('optional' in req && req.optional)) {\n                unresolved.push(name);\n            }\n        }\n\n        return resolvedPromiseLike([resolved, unresolved]);\n    };\n}\n\n/**\n * Builds a service resolver that will resolve against the supplied set of satic & dynamic\n * services.\n *\n * @param services set of statically-defined services, or builder functions for dynamically-\n *    defined services\n * @returns a ServiceResolver that resolves against the supplied services\n */\nexport function buildDynamicServiceResolver<R extends ServicesRequest<ServiceDescriptor<unknown>>>(\n    services: Array<\n        | PublishedService\n        | (Omit<PublishedService, 'service'> & {\n              builder: (\n                  request: ServiceRequest<ServiceDescriptor<unknown>>\n              ) => PromiseLike<PublishedService>;\n          })\n    >\n): ServiceResolver<R> {\n    // Used to track the current set of services. Each service is in one of the following\n    // states:\n    //\n    // - service !== undefined\n    //   the service has been built and is available\n    // - service === undefined && promise !== undefined\n    //   the service is being built, the promise will resolve to the service when available\n    // - service === undefined && promise === undefined && builder !== undefined\n    //   the service needs to be built\n    const currentServices: Array<\n        PublishedService & {\n            builder?: (\n                request: ServiceRequest<ServiceDescriptor<unknown>>\n            ) => PromiseLike<PublishedService>;\n            promise?: PromiseLike<PublishedService>;\n        }\n    > = services.map((svc) => Object.assign({ service: undefined }, svc));\n\n    return (requested: R) => {\n        const resolved: RequestedServices<R> = {} as any;\n        const pending: PromiseLike<void>[] = [];\n        const unresolved: Array<keyof R> = [];\n\n        Object.entries(requested).forEach(([name, req]) => {\n            const matchingService = currentServices.find((s) => serviceSatisfies(s, req));\n\n            // service is already built\n            if (matchingService?.service) {\n                (resolved as any)[name] = matchingService.service;\n            }\n            // service is being built\n            else if (matchingService?.promise) {\n                pending.push(\n                    matchingService.promise.then((builtService) => {\n                        (resolved as any)[name] = builtService.service;\n                    })\n                );\n            }\n            // service needs to be built\n            else if (matchingService?.builder) {\n                matchingService.promise = matchingService.builder(req);\n                pending.push(\n                    matchingService.promise.then(\n                        (builtService) => {\n                            (resolved as any)[name] = matchingService.service =\n                                builtService.service;\n                            matchingService.promise = undefined;\n                        },\n                        (error) => {\n                            // eslint-disable-next-line\n                            console.error(\n                                `failed to build service ${matchingService.type}/${matchingService.version}: ${error}`\n                            );\n                            // clear the promise so future requests will retry building the service\n                            matchingService.promise = undefined;\n                            throw error;\n                        }\n                    )\n                );\n            }\n            // service is not available; note that this logic prioritizes building an\n            // optional service over reporting it as unresolved\n            else if (!('optional' in req && req.optional)) {\n                unresolved.push(name);\n            }\n        });\n\n        if (pending.length > 0) {\n            return Promise.all(pending).then(() => [resolved, unresolved]);\n        }\n\n        return resolvedPromiseLike([resolved, unresolved]);\n    };\n}\n"],"names":["resolve"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@conduit-client/service-provisioner",
-    "version": "3.7.1",
+    "version": "3.8.0",
     "private": false,
     "description": "Luvio Service Provisioner",
     "type": "module",
@@ -31,7 +31,7 @@
         "watch": "npm run build --watch"
     },
     "dependencies": {
-        "@conduit-client/utils": "3.7.1"
+        "@conduit-client/utils": "3.8.0"
     },
     "volta": {
         "extends": "../../../package.json"
@@ -39,7 +39,7 @@
     "size-limit": [
         {
             "path": "./dist/v1/index.js",
-            "limit": "720 B"
+            "limit": "1.2 kB"
         }
     ]
 }