typed-soap 0.0.1 → 0.0.2

package/dist/deserializer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Custom deserializer that fills gaps in the `soap` package's built-in
+ * XML-to-JS type conversion. Soap natively handles int, integer, short,
+ * long, float, double, decimal, boolean, dateTime, and date. Everything
+ * else falls through as a raw string. This map adds the missing numeric
+ * types so our generated TypeScript types match the actual runtime values.
+ */
+export declare const typedSoapDeserializer: Record<string, (text: string) => number>;
+//# sourceMappingURL=deserializer.d.ts.map

package/dist/deserializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.d.ts","sourceRoot":"","sources":["../src/deserializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAU1E,CAAC"}

package/dist/deserializer.js

@@ -0,0 +1,19 @@
+/**
+ * Custom deserializer that fills gaps in the `soap` package's built-in
+ * XML-to-JS type conversion. Soap natively handles int, integer, short,
+ * long, float, double, decimal, boolean, dateTime, and date. Everything
+ * else falls through as a raw string. This map adds the missing numeric
+ * types so our generated TypeScript types match the actual runtime values.
+ */
+export const typedSoapDeserializer = {
+    byte: (text) => parseInt(text, 10),
+    unsignedByte: (text) => parseInt(text, 10),
+    unsignedShort: (text) => parseInt(text, 10),
+    unsignedInt: (text) => parseInt(text, 10),
+    unsignedLong: (text) => parseInt(text, 10),
+    negativeInteger: (text) => parseInt(text, 10),
+    nonNegativeInteger: (text) => parseInt(text, 10),
+    positiveInteger: (text) => parseInt(text, 10),
+    nonPositiveInteger: (text) => parseInt(text, 10),
+};
+//# sourceMappingURL=deserializer.js.map

package/dist/deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializer.js","sourceRoot":"","sources":["../src/deserializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,IAAI,EAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,YAAY,EAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,aAAa,EAAO,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,WAAW,EAAS,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,YAAY,EAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,eAAe,EAAK,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,eAAe,EAAK,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;CACjD,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,20 @@
-export declare function createSoapWrapper(): void;
+import type { ServiceDefinition, InferClient, SoapClientOptions } from "./types.js";
+export type { ServiceDefinition, OperationDefinition, InferClient, SoapClientOptions } from "./types.js";
+/**
+ * Creates a type-safe SOAP client from a WSDL URL or file path.
+ *
+ * The generic parameter `T` should be a generated `ServiceDefinition`
+ * produced by `tsoap-cli`. The returned client has fully typed methods
+ * matching the WSDL's services, ports, and operations.
+ *
+ * @example
+ * ```ts
+ * import { createSoapClient } from 'typed-soap';
+ * import type { MyServiceDef } from './generated/my-service.js';
+ *
+ * const client = await createSoapClient<MyServiceDef>('http://example.com?wsdl');
+ * const result = await client.MyService.MyPort.MyOp({ arg: 'value' });
+ * ```
+ */
+export declare function createSoapClient<T extends ServiceDefinition>(wsdlUrl: string, options?: SoapClientOptions): Promise<InferClient<T>>;
 //# 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,wBAAgB,iBAAiB,SAEhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpF,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzG;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,EAChE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAgCzB"}

package/dist/index.js

@@ -1,4 +1,45 @@
-export function createSoapWrapper() {
-    // TODO: implement runtime SOAP client wrapper
+import * as soap from "soap";
+import { typedSoapDeserializer } from "./deserializer.js";
+import { createClientProxy } from "./proxy.js";
+/**
+ * Creates a type-safe SOAP client from a WSDL URL or file path.
+ *
+ * The generic parameter `T` should be a generated `ServiceDefinition`
+ * produced by `tsoap-cli`. The returned client has fully typed methods
+ * matching the WSDL's services, ports, and operations.
+ *
+ * @example
+ * ```ts
+ * import { createSoapClient } from 'typed-soap';
+ * import type { MyServiceDef } from './generated/my-service.js';
+ *
+ * const client = await createSoapClient<MyServiceDef>('http://example.com?wsdl');
+ * const result = await client.MyService.MyPort.MyOp({ arg: 'value' });
+ * ```
+ */
+export async function createSoapClient(wsdlUrl, options) {
+    if (!wsdlUrl) {
+        throw new Error("createSoapClient: wsdlUrl is required");
+    }
+    const { endpoint, customDeserializer: userDeserializer, ...soapOptions } = options ?? {};
+    const mergedOptions = {
+        ...soapOptions,
+        customDeserializer: {
+            ...typedSoapDeserializer,
+            ...userDeserializer,
+        },
+    };
+    let client;
+    try {
+        client = await soap.createClientAsync(wsdlUrl, mergedOptions);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to create SOAP client from "${wsdlUrl}": ${message}`);
+    }
+    if (endpoint) {
+        client.setEndpoint(endpoint);
+    }
+    return createClientProxy(client);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB;IAC/B,8CAA8C;AAChD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,OAA2B;IAE3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,GACtE,OAAO,IAAI,EAAE,CAAC;IAEhB,MAAM,aAAa,GAAkB;QACnC,GAAG,WAAW;QACd,kBAAkB,EAAE;YAClB,GAAG,qBAAqB;YACxB,GAAG,gBAAgB;SACpB;KACF,CAAC;IAEF,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,MAAM,OAAO,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,iBAAiB,CAAC,MAAM,CAAmB,CAAC;AACrD,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,9 @@
+import type { Client } from "soap";
+/**
+ * Creates a 3-level nested Proxy over a soap Client so that
+ * `proxy.ServiceName.PortName.OperationName(args)` delegates to
+ * `client.ServiceName.PortName.OperationNameAsync(args)` and
+ * returns only the result (first element of the response tuple).
+ */
+export declare function createClientProxy(client: Client): unknown;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAqBnC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAkFzD"}

package/dist/proxy.js

@@ -0,0 +1,73 @@
+const JS_INTERNALS = new Set([
+    "then",
+    "toJSON",
+    "valueOf",
+    "toString",
+    "inspect",
+    "constructor",
+    "asymmetricMatch",
+    "nodeType",
+    "tagName",
+    "$$typeof",
+    "@@__IMMUTABLE_ITERABLE__@@",
+    "@@__IMMUTABLE_RECORD__@@",
+]);
+function isInternalAccess(prop) {
+    return typeof prop === "symbol" || JS_INTERNALS.has(prop);
+}
+/**
+ * Creates a 3-level nested Proxy over a soap Client so that
+ * `proxy.ServiceName.PortName.OperationName(args)` delegates to
+ * `client.ServiceName.PortName.OperationNameAsync(args)` and
+ * returns only the result (first element of the response tuple).
+ */
+export function createClientProxy(client) {
+    const serviceDescription = client.describe();
+    return new Proxy({}, {
+        get(_target, serviceName) {
+            if (isInternalAccess(serviceName))
+                return undefined;
+            if (!(serviceName in serviceDescription)) {
+                const available = Object.keys(serviceDescription);
+                throw new Error(`Service "${String(serviceName)}" not found. ` +
+                    `Available services: ${JSON.stringify(available)}`);
+            }
+            return new Proxy({}, {
+                get(_target, portName) {
+                    if (isInternalAccess(portName))
+                        return undefined;
+                    const portDesc = serviceDescription[serviceName]?.[portName];
+                    if (!portDesc) {
+                        const available = Object.keys(serviceDescription[serviceName] ?? {});
+                        throw new Error(`Port "${String(portName)}" not found on service "${String(serviceName)}". ` +
+                            `Available ports: ${JSON.stringify(available)}`);
+                    }
+                    return new Proxy({}, {
+                        get(_target, operationName) {
+                            if (isInternalAccess(operationName))
+                                return undefined;
+                            if (!(operationName in portDesc)) {
+                                const available = Object.keys(portDesc);
+                                throw new Error(`Operation "${String(operationName)}" not found on ` +
+                                    `${String(serviceName)}.${String(portName)}. ` +
+                                    `Available operations: ${JSON.stringify(available)}`);
+                            }
+                            return async (input) => {
+                                const serviceObj = client[serviceName];
+                                const portObj = serviceObj?.[portName];
+                                const method = portObj?.[operationName + "Async"];
+                                if (typeof method !== "function") {
+                                    throw new Error(`Operation ${String(serviceName)}.${String(portName)}.${String(operationName)} ` +
+                                        `exists in WSDL but was not found on the SOAP client`);
+                                }
+                                const [result] = await method(input);
+                                return result;
+                            };
+                        },
+                    });
+                },
+            });
+        },
+    });
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+import type { IOptions } from "soap";
+export type OperationDefinition = {
+    input: unknown;
+    output: unknown;
+};
+export type ServiceDefinition = {
+    [service: string]: {
+        [port: string]: {
+            [operation: string]: OperationDefinition;
+        };
+    };
+};
+/**
+ * Transforms a static service definition into a callable client interface.
+ * Each `{ input: I; output: O }` becomes `(input: I) => Promise<O>`.
+ */
+export type InferClient<T extends ServiceDefinition> = {
+    [S in keyof T]: {
+        [P in keyof T[S]]: {
+            [O in keyof T[S][P]]: T[S][P][O] extends OperationDefinition ? (input: T[S][P][O]["input"]) => Promise<T[S][P][O]["output"]> : never;
+        };
+    };
+};
+export interface SoapClientOptions extends IOptions {
+    /**
+     * Override the SOAP endpoint URL. If provided, this replaces
+     * the `<soap:address location="...">` from the WSDL.
+     */
+    endpoint?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,OAAO,EAAE,MAAM,GAAG;QACjB,CAAC,IAAI,EAAE,MAAM,GAAG;YACd,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAAC;SAC1C,CAAC;KACH,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,iBAAiB,IAAI;KACpD,CAAC,IAAI,MAAM,CAAC,GAAG;SACb,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;aAChB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,mBAAmB,GACxD,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC7D,KAAK;SACV;KACF;CACF,CAAC;AAEF,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "typed-soap",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "End-to-end type-safe SOAP client for TypeScript. Generate typed RPC wrappers directly from WSDLs.",
-  "keywords": ["soap", "typescript", "wsdl", "rpc", "trpc", "types", "client", "node-soap", "generator"],
+  "keywords": [
+    "soap",
+    "typescript",
+    "wsdl",
+    "rpc",
+    "trpc",
+    "types",
+    "client",
+    "node-soap",
+    "generator"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/deserializer.ts

@@ -0,0 +1,18 @@
+/**
+ * Custom deserializer that fills gaps in the `soap` package's built-in
+ * XML-to-JS type conversion. Soap natively handles int, integer, short,
+ * long, float, double, decimal, boolean, dateTime, and date. Everything
+ * else falls through as a raw string. This map adds the missing numeric
+ * types so our generated TypeScript types match the actual runtime values.
+ */
+export const typedSoapDeserializer: Record<string, (text: string) => number> = {
+  byte:               (text) => parseInt(text, 10),
+  unsignedByte:       (text) => parseInt(text, 10),
+  unsignedShort:      (text) => parseInt(text, 10),
+  unsignedInt:        (text) => parseInt(text, 10),
+  unsignedLong:       (text) => parseInt(text, 10),
+  negativeInteger:    (text) => parseInt(text, 10),
+  nonNegativeInteger: (text) => parseInt(text, 10),
+  positiveInteger:    (text) => parseInt(text, 10),
+  nonPositiveInteger: (text) => parseInt(text, 10),
+};

package/src/index.ts

@@ -1,3 +1,59 @@
-export function createSoapWrapper() {
-  // TODO: implement runtime SOAP client wrapper
+import * as soap from "soap";
+import type { ServiceDefinition, InferClient, SoapClientOptions } from "./types.js";
+import { typedSoapDeserializer } from "./deserializer.js";
+import { createClientProxy } from "./proxy.js";
+
+export type { ServiceDefinition, OperationDefinition, InferClient, SoapClientOptions } from "./types.js";
+
+/**
+ * Creates a type-safe SOAP client from a WSDL URL or file path.
+ *
+ * The generic parameter `T` should be a generated `ServiceDefinition`
+ * produced by `tsoap-cli`. The returned client has fully typed methods
+ * matching the WSDL's services, ports, and operations.
+ *
+ * @example
+ * ```ts
+ * import { createSoapClient } from 'typed-soap';
+ * import type { MyServiceDef } from './generated/my-service.js';
+ *
+ * const client = await createSoapClient<MyServiceDef>('http://example.com?wsdl');
+ * const result = await client.MyService.MyPort.MyOp({ arg: 'value' });
+ * ```
+ */
+export async function createSoapClient<T extends ServiceDefinition>(
+  wsdlUrl: string,
+  options?: SoapClientOptions,
+): Promise<InferClient<T>> {
+  if (!wsdlUrl) {
+    throw new Error("createSoapClient: wsdlUrl is required");
+  }
+
+  const { endpoint, customDeserializer: userDeserializer, ...soapOptions } =
+    options ?? {};
+
+  const mergedOptions: soap.IOptions = {
+    ...soapOptions,
+    customDeserializer: {
+      ...typedSoapDeserializer,
+      ...userDeserializer,
+    },
+  };
+
+  let client: soap.Client;
+  try {
+    client = await soap.createClientAsync(wsdlUrl, mergedOptions);
+  } catch (err) {
+    const message =
+      err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `Failed to create SOAP client from "${wsdlUrl}": ${message}`,
+    );
+  }
+
+  if (endpoint) {
+    client.setEndpoint(endpoint);
+  }
+
+  return createClientProxy(client) as InferClient<T>;
 }

package/src/proxy.ts

@@ -0,0 +1,110 @@
+import type { Client } from "soap";
+
+const JS_INTERNALS = new Set([
+  "then",
+  "toJSON",
+  "valueOf",
+  "toString",
+  "inspect",
+  "constructor",
+  "asymmetricMatch",
+  "nodeType",
+  "tagName",
+  "$$typeof",
+  "@@__IMMUTABLE_ITERABLE__@@",
+  "@@__IMMUTABLE_RECORD__@@",
+]);
+
+function isInternalAccess(prop: string | symbol): boolean {
+  return typeof prop === "symbol" || JS_INTERNALS.has(prop as string);
+}
+
+/**
+ * Creates a 3-level nested Proxy over a soap Client so that
+ * `proxy.ServiceName.PortName.OperationName(args)` delegates to
+ * `client.ServiceName.PortName.OperationNameAsync(args)` and
+ * returns only the result (first element of the response tuple).
+ */
+export function createClientProxy(client: Client): unknown {
+  const serviceDescription = client.describe();
+
+  return new Proxy(
+    {},
+    {
+      get(_target, serviceName: string | symbol) {
+        if (isInternalAccess(serviceName)) return undefined;
+
+        if (!(serviceName in serviceDescription)) {
+          const available = Object.keys(serviceDescription);
+          throw new Error(
+            `Service "${String(serviceName)}" not found. ` +
+              `Available services: ${JSON.stringify(available)}`,
+          );
+        }
+
+        return new Proxy(
+          {},
+          {
+            get(_target, portName: string | symbol) {
+              if (isInternalAccess(portName)) return undefined;
+
+              const portDesc =
+                serviceDescription[serviceName as string]?.[portName as string];
+              if (!portDesc) {
+                const available = Object.keys(
+                  serviceDescription[serviceName as string] ?? {},
+                );
+                throw new Error(
+                  `Port "${String(portName)}" not found on service "${String(serviceName)}". ` +
+                    `Available ports: ${JSON.stringify(available)}`,
+                );
+              }
+
+              return new Proxy(
+                {},
+                {
+                  get(_target, operationName: string | symbol) {
+                    if (isInternalAccess(operationName)) return undefined;
+
+                    if (!(operationName in portDesc)) {
+                      const available = Object.keys(portDesc);
+                      throw new Error(
+                        `Operation "${String(operationName)}" not found on ` +
+                          `${String(serviceName)}.${String(portName)}. ` +
+                          `Available operations: ${JSON.stringify(available)}`,
+                      );
+                    }
+
+                    return async (input: unknown) => {
+                      const serviceObj = (client as Record<string, unknown>)[
+                        serviceName as string
+                      ] as Record<string, unknown> | undefined;
+                      const portObj = serviceObj?.[portName as string] as
+                        | Record<string, unknown>
+                        | undefined;
+                      const method = portObj?.[
+                        (operationName as string) + "Async"
+                      ] as
+                        | ((...args: unknown[]) => Promise<unknown[]>)
+                        | undefined;
+
+                      if (typeof method !== "function") {
+                        throw new Error(
+                          `Operation ${String(serviceName)}.${String(portName)}.${String(operationName)} ` +
+                            `exists in WSDL but was not found on the SOAP client`,
+                        );
+                      }
+
+                      const [result] = await method(input);
+                      return result;
+                    };
+                  },
+                },
+              );
+            },
+          },
+        );
+      },
+    },
+  );
+}

package/src/types.ts

@@ -0,0 +1,36 @@
+import type { IOptions } from "soap";
+
+export type OperationDefinition = {
+  input: unknown;
+  output: unknown;
+};
+
+export type ServiceDefinition = {
+  [service: string]: {
+    [port: string]: {
+      [operation: string]: OperationDefinition;
+    };
+  };
+};
+
+/**
+ * Transforms a static service definition into a callable client interface.
+ * Each `{ input: I; output: O }` becomes `(input: I) => Promise<O>`.
+ */
+export type InferClient<T extends ServiceDefinition> = {
+  [S in keyof T]: {
+    [P in keyof T[S]]: {
+      [O in keyof T[S][P]]: T[S][P][O] extends OperationDefinition
+        ? (input: T[S][P][O]["input"]) => Promise<T[S][P][O]["output"]>
+        : never;
+    };
+  };
+};
+
+export interface SoapClientOptions extends IOptions {
+  /**
+   * Override the SOAP endpoint URL. If provided, this replaces
+   * the `<soap:address location="...">` from the WSDL.
+   */
+  endpoint?: string;
+}