conductor-node 11.10.1 → 12.0.0-beta.10

package/README.md

@@ -6,109 +6,381 @@
       <img alt="Conductor logo" src="https://github.com/conductor-is/quickbooks-desktop-api/assets/170023/d67464b8-53a7-4d33-afeb-05a2efde1fa8" width="325">
     </picture>
   </a>
-  <h3>QuickBooks Desktop API for Python, Node.js, TypeScript, and REST</h3>
+  <h3>QuickBooks Desktop/Enterprise real-time API for Node.js, Python, and REST</h3>
   <a href="https://docs.conductor.is/quickstart">Quickstart</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
   <a href="https://conductor.is">Website</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
   <a href="https://docs.conductor.is">Docs</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
-  <a href="https://docs.conductor.is/qbd-examples">Examples</a>
-  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
-  <a href="https://twitter.com/conductor_is">Twitter</a>
+  <a href="https://docs.conductor.is/qbd-api">Examples</a>
   <br />
   <br />
   <a href="https://npmjs.com/package/conductor-node"><img src="https://img.shields.io/npm/dm/conductor-node.svg?logo=npm" alt="NPM download count"></a>
-  <a href="https://npmjs.org/package/conductor-node"><img src="https://img.shields.io/npm/v/conductor-node.svg?logo=npm" alt="Package version"></a>
+  <a href="https://npmjs.org/package/conductor-node"><img src="https://img.shields.io/npm/v/conductor-node.svg?logo=npm" alt="NPM version"></a>
+  <a href="https://npmjs.org/package/conductor-node"><img src="https://img.shields.io/bundlephobia/minzip/conductor-node" alt="NPM bundle size"></a>
   <img src="https://img.shields.io/badge/coverage-100%25-brightgreen" alt="Code coverage">
   <a href="LICENSE"><img src="https://img.shields.io/npm/l/conductor-node.svg?color=blue&logo=github" alt="License" /></a>
   <hr />
 </div>
 
-## What is Conductor?
+[Conductor](https://conductor.is) is a real-time, fully-typed API for **QuickBooks Desktop** (sometimes called QuickBooks Enterprise). In just a few lines, get real-time access to fetch, create, or update _any_ QuickBooks Desktop object type and receive a fully-typed response.
 
-Conductor is a real-time, fully-typed API for **QuickBooks Desktop** (sometimes called QuickBooks Enterprise), available via Python, Node.js, TypeScript, and REST. In just a few lines, get real-time access to fetch, create, or update [_any_ QuickBooks Desktop object type](https://docs.conductor.is/qbd/api#supported-object-types) and receive a fully-typed response. Check out [the documentation](https://docs.conductor.is) to get started.
+⭐ **Follow our [Quickstart guide](https://docs.conductor.is/quickstart) to get started.**
 
-Conductor, the company, is building a data integration platform for vertical SaaS companies, starting with QuickBooks Desktop. Our team has spent over a decade building companies, scaling vast software systems, and obsessing over quality.
+This repository contains the official Conductor **Node.js** library, which provides convenient access to our QuickBooks Desktop API from any server-side TypeScript or JavaScript application.
 
-<!-- markdownlint-disable MD033 -->
-<div align="center">
-  <a href="https://docs.conductor.is"><img src="https://user-images.githubusercontent.com/170023/213273732-83dd6881-0b36-4787-820b-bd55cdc8444f.jpg" alt="QuickBooks Desktop autocomplete" width="600" style="border-radius: 20px;" /></a>
-</div>
+- For Python, see [conductor-python](https://github.com/conductor-is/quickbooks-desktop-python).
+
+## Documentation
+
+The REST API documentation can be found on [docs.conductor.is](https://docs.conductor.is/api-ref). The full API of this library can be found in [api.md](api.md).
+
+## Installation
+
+```sh
+npm install conductor-node@beta
+```
+
+> **Note:** Though this version of the Node.js SDK uses an NPM `@beta` tag, it **_is_ stable and ready for production use**! We merely have a few more endpoints to migrate before prompting all existing users to update. **Any new Conductor users should absolutely use the beta version**!
+>
+> If you're migrating from the old `conductor-node` package, see the [migration guide](https://docs.conductor.is/qbd-api/upgrade-node).
 
 ## Key features
 
-- **Any data type:** Query, create, or update any QuickBooks Desktop data type.
-- **Real-time**: Get real-time updates on your QuickBooks Desktop data. No queues, no polling.
-- **Modern API:** JSON-based REST API, replacing the old XML-based SOAP model.
-- **Typed client libraries:** Fully typed libraries in Node.js and Python with autocomplete, inline docs, and type validation for endpoints, parameters, and responses.
-- **Request handling:** Invisibly manages queues, timeouts, retries, and pagination.
-- **Multi-company support:** Connects to multiple QuickBooks Desktop company files.
-- **Validation:** Sanitizes and validates all inputs and outputs.
-- **Unified error handling:** Streamlines error handling across the QuickBooks stack.
-- **Authentication flow UI:** Simple UI for securely connecting QuickBooks Desktop accounts.
+- **Any data type**: Query, create, or update any QuickBooks Desktop data type.
+- **Real-time**: Get real-time updates on your QuickBooks Desktop data. No queues, no jobs, no cache layer -- just direct access to the data.
+- **Modern API**: JSON-based REST API, replacing the old XML-based SOAP model.
+- **Typed client libraries**: Fully typed libraries in Node.js and Python with autocomplete, inline docs, and type validation for endpoints, parameters, and responses.
+- **Request handling**: Invisibly manages queues, timeouts, retries, and pagination.
+- **Auto-pagination**: Automatically handles paginated responses to retrieve complete datasets.
+- **Multi-company support**: Connects to multiple QuickBooks Desktop company files.
+- **Validation**: Sanitizes and validates all inputs and outputs.
+- **Unified error handling**: Streamlines error handling across the QuickBooks stack.
+- **Authentication flow UI**: Simple UI for securely connecting QuickBooks Desktop accounts.
 - **Dashboard**: UI to monitor and manage your QuickBooks Desktop connections and data.
-- **Error resolution:** Detailed guides and instructions for resolving errors and handling edge cases.
+- **Error resolution**: Detailed guides and instructions for resolving errors and handling edge cases.
 
-## What is this repo?
-
-This repository is a library for conveniently accessing Conductor's QuickBooks Desktop API from TypeScript or JavaScript. The library is a wrapper around the Conductor REST API, providing a fully-typed, easy-to-use interface for fetching, creating, and updating QuickBooks Desktop objects.
+## Usage
 
-## Requirements
+The full API of this library can be found with code samples at [docs.conductor.is/qbd-api](https://docs.conductor.is/qbd-api).
 
-1. A Conductor account. Sign up [here](https://dashboard.conductor.is/sign-up).
-2. A QuickBooks Desktop instance for testing. If you don't have one, you can [create a free test instance](https://docs.conductor.is/qbd/test-instance).
+<!-- prettier-ignore -->
+```js
+import Conductor from 'conductor-node';
 
-## Documentation
+const conductor = new Conductor({
+  apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
+});
 
-1. [Quickstart](https://docs.conductor.is/quickstart)
-2. [Node.js / TypeScript API](https://docs.conductor.is/qbd/api)
-3. [API Reference](https://docs.conductor.is/apis)
-4. [Error Handling](https://docs.conductor.is/usage/error-handling)
+async function main() {
+  const page = await conductor.qbd.invoices.list({ conductorEndUserId: 'YOUR_END_USER_ID' });
+  const invoice = page.data[0];
 
-## Installation
+  console.log(invoice.id);
+}
 
-```sh
-npm install conductor-node
-# or
-yarn add conductor-node
+main();
 ```
 
-## Usage
+### Request & Response types
 
-The full API documentation is available [here](https://docs.conductor.is) along with many code examples. The following is a quickstart example:
+This library includes TypeScript definitions for all request params and response fields. You may import and use them like so:
 
+<!-- prettier-ignore -->
 ```ts
-import Conductor from "conductor-node";
+import Conductor from 'conductor-node';
 
-const conductor = new Conductor("{{YOUR_SECRET_KEY}}");
+const conductor = new Conductor({
+  apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
+});
 
 async function main() {
-  // 1. Create a new EndUser.
-  const endUser = await conductor.endUsers.create({
-    companyName: "{{END_USER_COMPANY_NAME}}",
-    sourceId: "{{UNIQUE_ID_FROM_YOUR_DB}}",
-    email: "{{END_USER_EMAIL}}",
-  });
-  console.log("Save this EndUser ID to auth future requests:", endUser.id);
-
-  // 2. Create an AuthSession to establish the QuickBooks Desktop connection.
-  const authSession = await conductor.authSessions.create({
-    publishableKey: "{{YOUR_PUBLISHABLE_KEY}}",
-    endUserId: endUser.id,
-  });
-  console.log("Complete the QuickBooks Desktop auth:", authSession.authFlowUrl);
-
-  // 3. Get a list of invoices from this EndUser's QuickBooks Desktop.
-  const qbdInvoices = await conductor.qbd.customer.query(endUser.id, {
-    MaxReturned: 10,
-  });
-  console.log("QuickBooks Desktop invoices:", qbdInvoices);
+  const params: Conductor.Qbd.InvoiceListParams = { conductorEndUserId: 'YOUR_END_USER_ID' };
+  const [invoice]: [Conductor.Qbd.Invoice] = await conductor.qbd.invoices.list(params);
 }
 
 main();
 ```
 
-## More documentation
+Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
+
+## Handling errors
+
+When the library is unable to connect to the API,
+or if the API returns a non-success status code (i.e., 4xx or 5xx response),
+a subclass of `APIError` will be thrown:
+
+<!-- prettier-ignore -->
+```ts
+async function main() {
+  const page = await conductor.qbd.invoices
+    .list({ conductorEndUserId: 'YOUR_END_USER_ID' })
+    .catch(async (err) => {
+      if (err instanceof Conductor.APIError) {
+        console.log(err.status); // 400
+        console.log(err.name); // BadRequestError
+        console.log(err.headers); // {server: 'nginx', ...}
+      } else {
+        throw err;
+      }
+    });
+}
+
+main();
+```
+
+Error codes are as followed:
+
+| Status Code | Error Type                 |
+| ----------- | -------------------------- |
+| 400         | `BadRequestError`          |
+| 401         | `AuthenticationError`      |
+| 403         | `PermissionDeniedError`    |
+| 404         | `NotFoundError`            |
+| 422         | `UnprocessableEntityError` |
+| 429         | `RateLimitError`           |
+| >=500       | `InternalServerError`      |
+| N/A         | `APIConnectionError`       |
+
+### Retries
+
+Certain errors will be automatically retried 2 times by default, with a short exponential backoff.
+Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
+429 Rate Limit, and >=500 Internal errors will all be retried by default.
+
+You can use the `maxRetries` option to configure or disable this:
+
+<!-- prettier-ignore -->
+```js
+// Configure the default for all requests:
+const conductor = new Conductor({
+  maxRetries: 0, // default is 2
+});
+
+// Or, configure per-request:
+await conductor.qbd.invoices.list({ conductorEndUserId: 'YOUR_END_USER_ID' }, {
+  maxRetries: 5,
+});
+```
+
+### Timeouts
+
+Requests time out after 2 minutes by default. You can configure this with a `timeout` option:
+
+<!-- prettier-ignore -->
+```ts
+// Configure the default for all requests:
+const conductor = new Conductor({
+  timeout: 20 * 1000, // 20 seconds (default is 2 minutes)
+});
+
+// Override per-request:
+await conductor.qbd.invoices.list({ conductorEndUserId: 'YOUR_END_USER_ID' }, {
+  timeout: 5 * 1000,
+});
+```
+
+On timeout, an `APIConnectionTimeoutError` is thrown.
+
+Note that requests which time out will be [retried twice by default](#retries).
+
+## Auto-pagination
+
+List methods in the Conductor API are paginated.
+You can use the `for await … of` syntax to iterate through items across all pages:
+
+```ts
+async function fetchAllQbdInvoices(params) {
+  const allQbdInvoices = [];
+  // Automatically fetches more pages as needed.
+  for await (const invoice of conductor.qbd.invoices.list({ conductorEndUserId: 'YOUR_END_USER_ID' })) {
+    allQbdInvoices.push(invoice);
+  }
+  return allQbdInvoices;
+}
+```
+
+Alternatively, you can request a single page at a time:
+
+```ts
+let page = await conductor.qbd.invoices.list({ conductorEndUserId: 'YOUR_END_USER_ID' });
+for (const invoice of page.data) {
+  console.log(invoice);
+}
+
+// Convenience methods are provided for manually paginating:
+while (page.hasNextPage()) {
+  page = await page.getNextPage();
+  // ...
+}
+```
+
+## Advanced Usage
+
+### Accessing raw Response data (e.g., headers)
+
+The "raw" `Response` returned by `fetch()` can be accessed through the `.asResponse()` method on the `APIPromise` type that all methods return.
+
+You can also use the `.withResponse()` method to get the raw `Response` along with the parsed data.
+
+<!-- prettier-ignore -->
+```ts
+const conductor = new Conductor();
+
+const response = await conductor.qbd.invoices.list({ conductorEndUserId: 'YOUR_END_USER_ID' }).asResponse();
+console.log(response.headers.get('X-My-Header'));
+console.log(response.statusText); // access the underlying Response object
+
+const { data: page, response: raw } = await conductor.qbd.invoices
+  .list({ conductorEndUserId: 'YOUR_END_USER_ID' })
+  .withResponse();
+console.log(raw.headers.get('X-My-Header'));
+for await (const invoice of page) {
+  console.log(invoice.id);
+}
+```
+
+### Making custom/undocumented requests
+
+This library is typed for convenient access to the documented API. If you need to access undocumented
+endpoints, params, or response properties, the library can still be used.
+
+#### Undocumented endpoints
+
+To make requests to undocumented endpoints, you can use `conductor.get`, `conductor.post`, and other HTTP verbs.
+Options on the client, such as retries, will be respected when making these requests.
+
+```ts
+await conductor.post('/some/path', {
+  body: { some_prop: 'foo' },
+  query: { some_query_arg: 'bar' },
+});
+```
+
+#### Undocumented request params
+
+To make requests using undocumented parameters, you may use `// @ts-expect-error` on the undocumented
+parameter. This library doesn't validate at runtime that the request matches the type, so any extra values you
+send will be sent as-is.
+
+```ts
+conductor.foo.create({
+  foo: 'my_param',
+  bar: 12,
+  // @ts-expect-error baz is not yet public
+  baz: 'undocumented option',
+});
+```
+
+For requests with the `GET` verb, any extra params will be in the query, all other requests will send the
+extra param in the body.
+
+If you want to explicitly send an extra argument, you can do so with the `query`, `body`, and `headers` request
+options.
+
+#### Undocumented response properties
+
+To access undocumented response properties, you may access the response object with `// @ts-expect-error` on
+the response object, or cast the response object to the requisite type. Like the request params, we do not
+validate or strip extra properties from the response from the API.
+
+### Customizing the fetch client
+
+By default, this library uses `node-fetch` in Node, and expects a global `fetch` function in other environments.
+
+If you would prefer to use a global, web-standards-compliant `fetch` function even in a Node environment,
+(for example, if you are running Node with `--experimental-fetch` or using NextJS which polyfills with `undici`),
+add the following import before your first import `from "Conductor"`:
+
+```ts
+// Tell TypeScript and the package to use the global web fetch instead of node-fetch.
+// Note, despite the name, this does not add any polyfills, but expects them to be provided if needed.
+import 'conductor-node/shims/web';
+import Conductor from 'conductor-node';
+```
+
+To do the inverse, add `import "conductor-node/shims/node"` (which does import polyfills).
+This can also be useful if you are getting the wrong TypeScript types for `Response` ([more details](https://github.com/conductor-is/quickbooks-desktop-node/tree/main/src/_shims#readme)).
+
+### Logging and middleware
+
+You may also provide a custom `fetch` function when instantiating the client,
+which can be used to inspect or alter the `Request` or `Response` before/after each request:
+
+```ts
+import { fetch } from 'undici'; // as one example
+import Conductor from 'conductor-node';
+
+const conductor = new Conductor({
+  fetch: async (url: RequestInfo, init?: RequestInit): Promise<Response> => {
+    console.log('About to make a request', url, init);
+    const response = await fetch(url, init);
+    console.log('Got response', response);
+    return response;
+  },
+});
+```
+
+Note that if given a `DEBUG=true` environment variable, this library will log all requests and responses automatically.
+This is intended for debugging purposes only and may change in the future without notice.
+
+### Configuring an HTTP(S) Agent (e.g., for proxies)
+
+By default, this library uses a stable agent for all http/https requests to reuse TCP connections, eliminating many TCP & TLS handshakes and shaving around 100ms off most requests.
+
+If you would like to disable or customize this behavior, for example to use the API behind a proxy, you can pass an `httpAgent` which is used for all requests (be they http or https), for example:
+
+<!-- prettier-ignore -->
+```ts
+import http from 'http';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+
+// Configure the default for all requests:
+const conductor = new Conductor({
+  httpAgent: new HttpsProxyAgent(process.env.PROXY_URL),
+});
+
+// Override per-request:
+await conductor.qbd.invoices.list(
+  { conductorEndUserId: 'YOUR_END_USER_ID' },
+  {
+    httpAgent: new http.Agent({ keepAlive: false }),
+  },
+);
+```
+
+## Semantic versioning
+
+This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions, though certain backwards-incompatible changes may be released as minor versions:
+
+1. Changes that only affect static types, without breaking runtime behavior.
+2. Changes to library internals which are technically public but not intended or documented for external use. _(Please open a GitHub issue to let us know if you are relying on such internals.)_
+3. Changes that we do not expect to impact the vast majority of users in practice.
+
+We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
+
+We are keen for your feedback; please open an [issue](https://www.github.com/conductor-is/quickbooks-desktop-node/issues) with questions, bugs, or suggestions.
+
+## Requirements
+
+TypeScript >= 4.5 is supported.
+
+The following runtimes are supported:
+
+- Web browsers (Up-to-date Chrome, Firefox, Safari, Edge, and more)
+- Node.js 18 LTS or later ([non-EOL](https://endoflife.date/nodejs)) versions.
+- Deno v1.28.0 or higher.
+- Bun 1.0 or later.
+- Cloudflare Workers.
+- Vercel Edge Runtime.
+- Jest 28 or greater with the `"node"` environment (`"jsdom"` is not supported at this time).
+- Nitro v2.6 or greater.
+
+Note that React Native is not supported at this time.
+
+If you are interested in other runtime environments, please open or upvote an issue on GitHub.
+
+## Contributing
 
-Please see our [full documentation site](https://docs.conductor.is) for more docs, guides, and code examples.
+See [the contributing documentation](./CONTRIBUTING.md).

package/_shims/MultipartBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+export declare class MultipartBody {
+    body: any;
+    constructor(body: any);
+    get [Symbol.toStringTag](): string;
+}
+//# sourceMappingURL=MultipartBody.d.ts.map

package/_shims/MultipartBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultipartBody.d.ts","sourceRoot":"","sources":["../src/_shims/MultipartBody.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACL,IAAI,EAAE,GAAG;gBAAT,IAAI,EAAE,GAAG;IAC5B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF"}

package/_shims/MultipartBody.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultipartBody = void 0;
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+class MultipartBody {
+    constructor(body) {
+        this.body = body;
+    }
+    get [Symbol.toStringTag]() {
+        return 'MultipartBody';
+    }
+}
+exports.MultipartBody = MultipartBody;
+//# sourceMappingURL=MultipartBody.js.map

package/_shims/MultipartBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultipartBody.js","sourceRoot":"","sources":["../src/_shims/MultipartBody.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,aAAa;IACxB,YAAmB,IAAS;QAAT,SAAI,GAAJ,IAAI,CAAK;IAAG,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF;AALD,sCAKC"}

package/_shims/MultipartBody.mjs

@@ -0,0 +1,12 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+export class MultipartBody {
+    constructor(body) {
+        this.body = body;
+    }
+    get [Symbol.toStringTag]() {
+        return 'MultipartBody';
+    }
+}
+//# sourceMappingURL=MultipartBody.mjs.map

package/_shims/MultipartBody.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultipartBody.mjs","sourceRoot":"","sources":["../src/_shims/MultipartBody.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB,YAAmB,IAAS;QAAT,SAAI,GAAJ,IAAI,CAAK;IAAG,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}

package/_shims/README.md

@@ -0,0 +1,46 @@
+# 👋 Wondering what everything in here does?
+
+`conductor-node` supports a wide variety of runtime environments like Node.js, Deno, Bun, browsers, and various
+edge runtimes, as well as both CommonJS (CJS) and EcmaScript Modules (ESM).
+
+To do this, `conductor-node` provides shims for either using `node-fetch` when in Node (because `fetch` is still experimental there) or the global `fetch` API built into the environment when not in Node.
+
+It uses [conditional exports](https://nodejs.org/api/packages.html#conditional-exports) to
+automatically select the correct shims for each environment. However, conditional exports are a fairly new
+feature and not supported everywhere. For instance, the TypeScript `"moduleResolution": "node"`
+
+setting doesn't consult the `exports` map, compared to `"moduleResolution": "nodeNext"`, which does.
+Unfortunately that's still the default setting, and it can result in errors like
+getting the wrong raw `Response` type from `.asResponse()`, for example.
+
+The user can work around these issues by manually importing one of:
+
+- `import 'conductor-node/shims/node'`
+- `import 'conductor-node/shims/web'`
+
+All of the code here in `_shims` handles selecting the automatic default shims or manual overrides.
+
+### How it works - Runtime
+
+Runtime shims get installed by calling `setShims` exported by `conductor-node/_shims/registry`.
+
+Manually importing `conductor-node/shims/node` or `conductor-node/shims/web`, calls `setShims` with the respective runtime shims.
+
+All client code imports shims from `conductor-node/_shims/index`, which:
+
+- checks if shims have been set manually
+- if not, calls `setShims` with the shims from `conductor-node/_shims/auto/runtime`
+- re-exports the installed shims from `conductor-node/_shims/registry`.
+
+`conductor-node/_shims/auto/runtime` exports web runtime shims.
+If the `node` export condition is set, the export map replaces it with `conductor-node/_shims/auto/runtime-node`.
+
+### How it works - Type time
+
+All client code imports shim types from `conductor-node/_shims/index`, which selects the manual types from `conductor-node/_shims/manual-types` if they have been declared, otherwise it exports the auto types from `conductor-node/_shims/auto/types`.
+
+`conductor-node/_shims/manual-types` exports an empty namespace.
+Manually importing `conductor-node/shims/node` or `conductor-node/shims/web` merges declarations into this empty namespace, so they get picked up by `conductor-node/_shims/index`.
+
+`conductor-node/_shims/auto/types` exports web type definitions.
+If the `node` export condition is set, the export map replaces it with `conductor-node/_shims/auto/types-node`, though TS only picks this up if `"moduleResolution": "nodenext"` or `"moduleResolution": "bundler"`.

package/_shims/auto/runtime-bun.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+export * from "../bun-runtime.js";
+//# sourceMappingURL=runtime-bun.d.ts.map

package/_shims/auto/runtime-bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bun.d.ts","sourceRoot":"","sources":["../../src/_shims/auto/runtime-bun.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC"}

package/_shims/auto/runtime-bun.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+__exportStar(require("../bun-runtime.js"), exports);
+//# sourceMappingURL=runtime-bun.js.map

package/_shims/auto/runtime-bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bun.js","sourceRoot":"","sources":["../../src/_shims/auto/runtime-bun.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,oDAA+B"}

package/_shims/auto/runtime-bun.mjs

@@ -0,0 +1,2 @@
+export * from "../bun-runtime.mjs";
+//# sourceMappingURL=runtime-bun.mjs.map

package/_shims/auto/runtime-bun.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bun.mjs","sourceRoot":"","sources":["../../src/_shims/auto/runtime-bun.ts"],"names":[],"mappings":""}

package/_shims/auto/runtime-node.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+export * from "../node-runtime.js";
+//# sourceMappingURL=runtime-node.d.ts.map

package/_shims/auto/runtime-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-node.d.ts","sourceRoot":"","sources":["../../src/_shims/auto/runtime-node.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iBAAiB,CAAC"}

package/_shims/auto/runtime-node.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+__exportStar(require("../node-runtime.js"), exports);
+//# sourceMappingURL=runtime-node.js.map

package/_shims/auto/runtime-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-node.js","sourceRoot":"","sources":["../../src/_shims/auto/runtime-node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,qDAAgC"}

package/_shims/auto/runtime-node.mjs

@@ -0,0 +1,2 @@
+export * from "../node-runtime.mjs";
+//# sourceMappingURL=runtime-node.mjs.map

package/_shims/auto/runtime-node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-node.mjs","sourceRoot":"","sources":["../../src/_shims/auto/runtime-node.ts"],"names":[],"mappings":""}

package/_shims/auto/runtime.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+export * from "../web-runtime.js";
+//# sourceMappingURL=runtime.d.ts.map

package/_shims/auto/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/_shims/auto/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC"}