@webpieces/http-client-node 0.4.698 → 0.4.700

package/src/index.js

@@ -15,12 +15,16 @@
  * import { ClientHttpFactory, ClientConfig } from '@webpieces/http-client-node';
  *
  * // inject the factory, then one client per contract
- * const server2 = factory.createRpcClient(Server2Api, new ClientConfig('server2'));
+ * const server2 = factory.createRpcClient(
+ *     Server2Api,
+ *     new ClientConfig('server2', new DeployedServiceHost()),
+ *     [],   // this client's outbound filters
+ * );
  * const response = await server2.fetchValue(req);
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TranslatedFailure = exports.ClientErrorTranslator = exports.ProxyClient = exports.ClientConfig = exports.NODE_PROXY_CLIENT_PROVIDER = exports.NodeProxyClient = exports.ClientHttpFactory = void 0;
+exports.ClientFilterDefinition = exports.ClientRequest = exports.TranslatedFailure = exports.ClientErrorTranslator = exports.ProxyClient = exports.SSRF_GUARD_PRIORITY = exports.BASE_URL_OVERRIDE_PRIORITY = exports.ContextBaseUrlOverrideFilter = exports.DnsAddressResolver = exports.AddressResolver = exports.InternalAddressRules = exports.MissingRuntimeBaseUrlError = exports.RuntimeHostEndpointUnsupportedError = exports.SsrfRefusedError = exports.SsrfGuardFilter = exports.SsrfPolicy = exports.RuntimeHostFromContextAllowingInternalAddresses = exports.RuntimeHostFromContext = exports.DeployedServiceHost = exports.HostPolicy = exports.ClientConfig = exports.NODE_PROXY_CLIENT_PROVIDER = exports.NodeProxyClient = exports.ClientHttpFactory = void 0;
 var ClientHttpFactory_1 = require("./ClientHttpFactory");
 Object.defineProperty(exports, "ClientHttpFactory", { enumerable: true, get: function () { return ClientHttpFactory_1.ClientHttpFactory; } });
 var NodeProxyClient_1 = require("./NodeProxyClient");
@@ -28,9 +32,41 @@ Object.defineProperty(exports, "NodeProxyClient", { enumerable: true, get: funct
 Object.defineProperty(exports, "NODE_PROXY_CLIENT_PROVIDER", { enumerable: true, get: function () { return NodeProxyClient_1.NODE_PROXY_CLIENT_PROVIDER; } });
 var ClientConfig_1 = require("./ClientConfig");
 Object.defineProperty(exports, "ClientConfig", { enumerable: true, get: function () { return ClientConfig_1.ClientConfig; } });
+// WHERE a client's requests go. Naming one is required on every ClientConfig — see HostPolicy.
+var HostPolicy_1 = require("./HostPolicy");
+Object.defineProperty(exports, "HostPolicy", { enumerable: true, get: function () { return HostPolicy_1.HostPolicy; } });
+Object.defineProperty(exports, "DeployedServiceHost", { enumerable: true, get: function () { return HostPolicy_1.DeployedServiceHost; } });
+Object.defineProperty(exports, "RuntimeHostFromContext", { enumerable: true, get: function () { return HostPolicy_1.RuntimeHostFromContext; } });
+Object.defineProperty(exports, "RuntimeHostFromContextAllowingInternalAddresses", { enumerable: true, get: function () { return HostPolicy_1.RuntimeHostFromContextAllowingInternalAddresses; } });
+// The SSRF policy a runtime host is judged under, and the refusal it produces. On by default; the
+// ONLY way to relax it is naming RuntimeHostFromContextAllowingInternalAddresses at the call site.
+var SsrfPolicy_1 = require("./SsrfPolicy");
+Object.defineProperty(exports, "SsrfPolicy", { enumerable: true, get: function () { return SsrfPolicy_1.SsrfPolicy; } });
+var SsrfGuardFilter_1 = require("./SsrfGuardFilter");
+Object.defineProperty(exports, "SsrfGuardFilter", { enumerable: true, get: function () { return SsrfGuardFilter_1.SsrfGuardFilter; } });
+var SsrfRefusedError_1 = require("./SsrfRefusedError");
+Object.defineProperty(exports, "SsrfRefusedError", { enumerable: true, get: function () { return SsrfRefusedError_1.SsrfRefusedError; } });
+// The two refusals that happen BEFORE any bytes leave, and are not about the destination itself.
+var RuntimeHostErrors_1 = require("./RuntimeHostErrors");
+Object.defineProperty(exports, "RuntimeHostEndpointUnsupportedError", { enumerable: true, get: function () { return RuntimeHostErrors_1.RuntimeHostEndpointUnsupportedError; } });
+Object.defineProperty(exports, "MissingRuntimeBaseUrlError", { enumerable: true, get: function () { return RuntimeHostErrors_1.MissingRuntimeBaseUrlError; } });
+var InternalAddressRules_1 = require("./InternalAddressRules");
+Object.defineProperty(exports, "InternalAddressRules", { enumerable: true, get: function () { return InternalAddressRules_1.InternalAddressRules; } });
+var AddressResolver_1 = require("./AddressResolver");
+Object.defineProperty(exports, "AddressResolver", { enumerable: true, get: function () { return AddressResolver_1.AddressResolver; } });
+Object.defineProperty(exports, "DnsAddressResolver", { enumerable: true, get: function () { return AddressResolver_1.DnsAddressResolver; } });
+// The built-in outbound filter that carries a per-call destination from the RequestContext into the
+// send path, and the two framework priorities an app orders its own filters against.
+var ContextBaseUrlOverrideFilter_1 = require("./ContextBaseUrlOverrideFilter");
+Object.defineProperty(exports, "ContextBaseUrlOverrideFilter", { enumerable: true, get: function () { return ContextBaseUrlOverrideFilter_1.ContextBaseUrlOverrideFilter; } });
+Object.defineProperty(exports, "BASE_URL_OVERRIDE_PRIORITY", { enumerable: true, get: function () { return ContextBaseUrlOverrideFilter_1.BASE_URL_OVERRIDE_PRIORITY; } });
+Object.defineProperty(exports, "SSRF_GUARD_PRIORITY", { enumerable: true, get: function () { return ContextBaseUrlOverrideFilter_1.SSRF_GUARD_PRIORITY; } });
 // The isomorphic engine, re-exported so a server app needs one import.
 var http_client_core_1 = require("@webpieces/http-client-core");
 Object.defineProperty(exports, "ProxyClient", { enumerable: true, get: function () { return http_client_core_1.ProxyClient; } });
 Object.defineProperty(exports, "ClientErrorTranslator", { enumerable: true, get: function () { return http_client_core_1.ClientErrorTranslator; } });
 Object.defineProperty(exports, "TranslatedFailure", { enumerable: true, get: function () { return http_client_core_1.TranslatedFailure; } });
+var http_client_core_2 = require("@webpieces/http-client-core");
+Object.defineProperty(exports, "ClientRequest", { enumerable: true, get: function () { return http_client_core_2.ClientRequest; } });
+Object.defineProperty(exports, "ClientFilterDefinition", { enumerable: true, get: function () { return http_client_core_2.ClientFilterDefinition; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-node/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,qDAAgF;AAAvE,kHAAA,eAAe,OAAA;AAAE,6HAAA,0BAA0B,OAAA;AACpD,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,uEAAuE;AACvE,gEAAoG;AAA3F,+GAAA,WAAW,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AAAE,qHAAA,iBAAiB,OAAA","sourcesContent":["/**\n * @webpieces/http-client-node\n *\n * The SERVER-side HTTP client. Reads an API contract's decorators and generates type-safe HTTP\n * clients from it — the same contract the callee's controller implements.\n *\n * Node-only, so unlike @webpieces/http-client-browser it is fully inversify-wired and reads the\n * magic context straight out of the AsyncLocalStorage-backed RequestContext. There is no\n * ContextReader indirection, because a server has exactly one right answer, and a call made\n * OUTSIDE `RequestContext.run(...)` throws instead of silently dropping the trace.\n *\n * Usage:\n * ```typescript\n * import { ClientHttpFactory, ClientConfig } from '@webpieces/http-client-node';\n *\n * // inject the factory, then one client per contract\n * const server2 = factory.createRpcClient(Server2Api, new ClientConfig('server2'));\n * const response = await server2.fetchValue(req);\n * ```\n */\n\nexport { ClientHttpFactory } from './ClientHttpFactory';\nexport { NodeProxyClient, NODE_PROXY_CLIENT_PROVIDER } from './NodeProxyClient';\nexport { ClientConfig } from './ClientConfig';\n\n// The isomorphic engine, re-exported so a server app needs one import.\nexport { ProxyClient, ClientErrorTranslator, TranslatedFailure } from '@webpieces/http-client-core';\nexport type { ApiPrototype } from '@webpieces/http-client-core';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-client-node/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AAEH,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,qDAAgF;AAAvE,kHAAA,eAAe,OAAA;AAAE,6HAAA,0BAA0B,OAAA;AACpD,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,+FAA+F;AAC/F,2CAAwI;AAA/H,wGAAA,UAAU,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAAE,oHAAA,sBAAsB,OAAA;AAAE,6IAAA,+CAA+C,OAAA;AAEjH,kGAAkG;AAClG,mGAAmG;AACnG,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,iGAAiG;AACjG,yDAAsG;AAA7F,wIAAA,mCAAmC,OAAA;AAAE,+HAAA,0BAA0B,OAAA;AACxE,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,qDAAwE;AAA/D,kHAAA,eAAe,OAAA;AAAE,qHAAA,kBAAkB,OAAA;AAE5C,oGAAoG;AACpG,qFAAqF;AACrF,+EAA+H;AAAtH,4IAAA,4BAA4B,OAAA;AAAE,0IAAA,0BAA0B,OAAA;AAAE,mIAAA,mBAAmB,OAAA;AAEtF,uEAAuE;AACvE,gEAAoG;AAA3F,+GAAA,WAAW,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAC9D,gEAAoF;AAA3E,iHAAA,aAAa,OAAA;AAAE,0HAAA,sBAAsB,OAAA","sourcesContent":["/**\n * @webpieces/http-client-node\n *\n * The SERVER-side HTTP client. Reads an API contract's decorators and generates type-safe HTTP\n * clients from it — the same contract the callee's controller implements.\n *\n * Node-only, so unlike @webpieces/http-client-browser it is fully inversify-wired and reads the\n * magic context straight out of the AsyncLocalStorage-backed RequestContext. There is no\n * ContextReader indirection, because a server has exactly one right answer, and a call made\n * OUTSIDE `RequestContext.run(...)` throws instead of silently dropping the trace.\n *\n * Usage:\n * ```typescript\n * import { ClientHttpFactory, ClientConfig } from '@webpieces/http-client-node';\n *\n * // inject the factory, then one client per contract\n * const server2 = factory.createRpcClient(\n *     Server2Api,\n *     new ClientConfig('server2', new DeployedServiceHost()),\n *     [],   // this client's outbound filters\n * );\n * const response = await server2.fetchValue(req);\n * ```\n */\n\nexport { ClientHttpFactory } from './ClientHttpFactory';\nexport { NodeProxyClient, NODE_PROXY_CLIENT_PROVIDER } from './NodeProxyClient';\nexport { ClientConfig } from './ClientConfig';\n\n// WHERE a client's requests go. Naming one is required on every ClientConfig — see HostPolicy.\nexport { HostPolicy, DeployedServiceHost, RuntimeHostFromContext, RuntimeHostFromContextAllowingInternalAddresses } from './HostPolicy';\n\n// The SSRF policy a runtime host is judged under, and the refusal it produces. On by default; the\n// ONLY way to relax it is naming RuntimeHostFromContextAllowingInternalAddresses at the call site.\nexport { SsrfPolicy } from './SsrfPolicy';\nexport { SsrfGuardFilter } from './SsrfGuardFilter';\nexport { SsrfRefusedError } from './SsrfRefusedError';\n// The two refusals that happen BEFORE any bytes leave, and are not about the destination itself.\nexport { RuntimeHostEndpointUnsupportedError, MissingRuntimeBaseUrlError } from './RuntimeHostErrors';\nexport { InternalAddressRules } from './InternalAddressRules';\nexport { AddressResolver, DnsAddressResolver } from './AddressResolver';\n\n// The built-in outbound filter that carries a per-call destination from the RequestContext into the\n// send path, and the two framework priorities an app orders its own filters against.\nexport { ContextBaseUrlOverrideFilter, BASE_URL_OVERRIDE_PRIORITY, SSRF_GUARD_PRIORITY } from './ContextBaseUrlOverrideFilter';\n\n// The isomorphic engine, re-exported so a server app needs one import.\nexport { ProxyClient, ClientErrorTranslator, TranslatedFailure } from '@webpieces/http-client-core';\nexport { ClientRequest, ClientFilterDefinition } from '@webpieces/http-client-core';\nexport type { ClientFilter } from '@webpieces/http-client-core';\nexport type { ApiPrototype } from '@webpieces/http-client-core';\n"]}