quickbase-js 0.1.0-beta.7

package/CHANGELOG.md

@@ -0,0 +1,129 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## [0.1.0-beta.7](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.6...v0.1.0-beta.7) (2025-03-16)
+
+
+### Features
+
+* added Record, hybrid semantic naming, fully typed QuickbaseClient with few response models left as type:any ([535a02e](https://github.com/DrewBradfordXYZ/quickbase-js/commit/535a02e10d5974d2a2deb6dc213286da94d68dea))
+* all fields tests pass ([84c539f](https://github.com/DrewBradfordXYZ/quickbase-js/commit/84c539fce7ba9d57c997b831be404a1398a6ac25))
+* all types, methods and files generated ([f25bea0](https://github.com/DrewBradfordXYZ/quickbase-js/commit/f25bea0e65a019d75b39a9caf85901d520bf1ac8))
+* build files always produce production code ([2f78598](https://github.com/DrewBradfordXYZ/quickbase-js/commit/2f785984416c61e1b3deda2b801071cbb1303a74))
+* copyApp unit test passes ([0e13f91](https://github.com/DrewBradfordXYZ/quickbase-js/commit/0e13f918c5daabbbd6e17c2424b3f18eca2eb3a4))
+* FieldMap issue resolved ([b3b7b41](https://github.com/DrewBradfordXYZ/quickbase-js/commit/b3b7b415d6a0f7701851f32a5e0b1207a07ba481))
+* getApp and deleteApp test passes ([f5225e0](https://github.com/DrewBradfordXYZ/quickbase-js/commit/f5225e06299de58f34d6a765e73268d9a54e807d))
+* getAppEvents spec update ([1028255](https://github.com/DrewBradfordXYZ/quickbase-js/commit/10282559cd76d004899fa2ebcea6f5f435ffae2b))
+* import and upsert success ([ea9d9ee](https://github.com/DrewBradfordXYZ/quickbase-js/commit/ea9d9eef8384ad73b8cffb8183fbc374ab9cc25b))
+* log-gen yaml file gets created next to the build file ([cfe25af](https://github.com/DrewBradfordXYZ/quickbase-js/commit/cfe25afb60498909d2bac8ec963484e1c1b42d3f))
+* logging for swagger2.0 ([819aa17](https://github.com/DrewBradfordXYZ/quickbase-js/commit/819aa170cfc02e4e5b223ac13834d50bce5dda93))
+* missing-types-report updated to empty on success ([e35b28d](https://github.com/DrewBradfordXYZ/quickbase-js/commit/e35b28d61563b21f7bad3e1c9c3751bfa254ab4a))
+* QuickbaseClient is fully-typed from raw spec ([5c875c2](https://github.com/DrewBradfordXYZ/quickbase-js/commit/5c875c2ee07c38731c5609c384aaa8d3fbbdd64a))
+* reorganize open-api folder ([a0fe5bd](https://github.com/DrewBradfordXYZ/quickbase-js/commit/a0fe5bda606c37e7636d36c7fc5e233d191ac249))
+* simplifyName refactor again ([2a2952e](https://github.com/DrewBradfordXYZ/quickbase-js/commit/2a2952ea90fab818501d17908d6cd85a79c41adb))
+* split up fix-spec- files ([85b6a3e](https://github.com/DrewBradfordXYZ/quickbase-js/commit/85b6a3efb92520a46aa619bdfc4bf70d06984b3f))
+* unit auth tests pass ([494897f](https://github.com/DrewBradfordXYZ/quickbase-js/commit/494897f4551854096f89b1af43df4a455dfd9f4b))
+* unit records tests pass ([8160b53](https://github.com/DrewBradfordXYZ/quickbase-js/commit/8160b53378447fcd8e37fac178e7d4693b502288))
+* unit tables tests pass ([c4ec0ac](https://github.com/DrewBradfordXYZ/quickbase-js/commit/c4ec0ac378dd03e5d018b4ea83530e2c0fe905a2))
+* unit tests for apps folder is passing ([72ae8e5](https://github.com/DrewBradfordXYZ/quickbase-js/commit/72ae8e529cddc66626617c6b1ff672f40763f7b7))
+* update scripts to call integration tests, all tests pass ([08911f7](https://github.com/DrewBradfordXYZ/quickbase-js/commit/08911f76b214e6eb3ca8b4362c156d55383d7264))
+
+
+### Bug Fixes
+
+* added back CreateRelationshipRequest and UpdateRelationshipRequest ([0d932ee](https://github.com/DrewBradfordXYZ/quickbase-js/commit/0d932eed8b603c6b84e13b8834a89722b91fabf3))
+* generate-unified-interface type fixes ([b8acd16](https://github.com/DrewBradfordXYZ/quickbase-js/commit/b8acd16805f456336d396856c6ff88a29aa02813))
+* playwright cleanup and type fixes ([ff30a15](https://github.com/DrewBradfordXYZ/quickbase-js/commit/ff30a15c1a244c7eb1ad4f52941f60b775bb88d4))
+* remove the old /paths /definitons completely in scripts ([48ee6a3](https://github.com/DrewBradfordXYZ/quickbase-js/commit/48ee6a3b15579ca9224b89acde73f492e0769cab))
+* update tags/tables.ts to match raw schema ([c6ed554](https://github.com/DrewBradfordXYZ/quickbase-js/commit/c6ed554f0994187224219b454d1e8671307fc189))
+
+## [1.1.0-beta.6](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.5...v1.1.0-beta.6) (2025-03-13)
+
+
+### Features
+
+* omit credientials for all api calls that are not fetching a temp token ([b1b4aae](https://github.com/DrewBradfordXYZ/quickbase-js/commit/b1b4aae02aaa655e6eaab2fe0d532d526e6dc69f))
+
+## [1.1.0-beta.5](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.4...v1.1.0-beta.5) (2025-03-13)
+
+
+### Features
+
+* ESM and UMD build prod ([49513e9](https://github.com/DrewBradfordXYZ/quickbase-js/commit/49513e902e7bf4dd35da3c6508242e96507a91bd))
+* ESM and UMD support and src folder reorganization ([dc0170b](https://github.com/DrewBradfordXYZ/quickbase-js/commit/dc0170b547e6e9e57a117fbcccfdbeb86e48a8c7))
+
+## [1.1.0-beta.4](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.3...v1.1.0-beta.4) (2025-03-12)
+
+
+### Features
+
+* createField and deleteFields tests are passing ([4b47c4d](https://github.com/DrewBradfordXYZ/quickbase-js/commit/4b47c4deb9b3d731e6e7938c12fcebe97830568b))
+* createField mock and integration tests pass ([b227c73](https://github.com/DrewBradfordXYZ/quickbase-js/commit/b227c73b08f7efa5ce5f3d0c2897f82c8976a009))
+* deleteFields spec update ([1f8beca](https://github.com/DrewBradfordXYZ/quickbase-js/commit/1f8becaca0d6b7950648c1b9bc2b0215781fa829))
+* getFeildsUsage.test.ts unit and integration tests pass ([82a4886](https://github.com/DrewBradfordXYZ/quickbase-js/commit/82a488622967ec24a8767cbb19c59ef4ce808749))
+* getField.test.ts unit and integration tests pass ([3e50b70](https://github.com/DrewBradfordXYZ/quickbase-js/commit/3e50b704f0ebea47f2fee3d02d811ea1b43db6c4))
+* getFieldsUsage fix spec ([031faaa](https://github.com/DrewBradfordXYZ/quickbase-js/commit/031faaaeab9597f35fdd1ddcf5157ce5d774390b))
+* getFieldUsage spec and unit test pass ([ac2824b](https://github.com/DrewBradfordXYZ/quickbase-js/commit/ac2824b226140dde99e33cf594d57bd6ffd4dc39))
+* getFieldUsage unit and integration tests pass ([e62b586](https://github.com/DrewBradfordXYZ/quickbase-js/commit/e62b586d534620479a25dda2796ba5dcb8043705))
+* split up fix-spec-paths and fix-spec-definitions into many files ([20d3246](https://github.com/DrewBradfordXYZ/quickbase-js/commit/20d32464e6337028778845fa55fbb19c5543f7eb))
+
+
+### Bug Fixes
+
+* cleanup createField.test.ts logging ([7b1306b](https://github.com/DrewBradfordXYZ/quickbase-js/commit/7b1306bd8eb49e2c932ce267f33457e949e0f74b))
+* createField test syntax update ([043f964](https://github.com/DrewBradfordXYZ/quickbase-js/commit/043f964a47346878440eb73cc10c110dab904ad7))
+* getFieldsUsage type fix ([4c6f271](https://github.com/DrewBradfordXYZ/quickbase-js/commit/4c6f271d123131ae13a236664f28fbbdfde3d564))
+* update deleteFields error type spec ([1788e1c](https://github.com/DrewBradfordXYZ/quickbase-js/commit/1788e1ce6d4d2c8df871ec8b112be908d706f884))
+
+## [1.1.0-beta.3](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.2...v1.1.0-beta.3) (2025-03-11)
+
+### Features
+
+- copyApp fix-spec updates ([4c10ab4](https://github.com/DrewBradfordXYZ/quickbase-js/commit/4c10ab41464df047402a207c7b9e81026a7b6202))
+- copyApp unit test passes ([b121bf1](https://github.com/DrewBradfordXYZ/quickbase-js/commit/b121bf1d0130f338f131de5417896d798fe90db3))
+- deleteApp fix spec added ([b27ce11](https://github.com/DrewBradfordXYZ/quickbase-js/commit/b27ce11e2b08bc631d7656dedec57f6f5e579450))
+- fix-spec-\* for getRelationship interface ([aad9fbd](https://github.com/DrewBradfordXYZ/quickbase-js/commit/aad9fbd7fc92b8aaaef901174c81169543ae86d2))
+- getRelationship unit and integration test pass ([a1269bb](https://github.com/DrewBradfordXYZ/quickbase-js/commit/a1269bb60523944bdf5030404539043c967f0b83))
+- updated Upsert200Response and Upsert207Response, deleteRecords.test.ts integration type issues resolved ([d39dad5](https://github.com/DrewBradfordXYZ/quickbase-js/commit/d39dad55d783d280db9dbae2ca4c782df3a1f12e))
+- usertokens 401s do not generate a token, createApp unit and integration tests, deleteApp integration tests pass ([e3a092d](https://github.com/DrewBradfordXYZ/quickbase-js/commit/e3a092d76f283d5c5200ddbb5afd32782fc15379))
+
+## [1.1.0-beta.2](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.1...v1.1.0-beta.2) (2025-03-11)
+
+## [1.1.0-beta.1](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.1.0-beta.0...v1.1.0-beta.1) (2025-03-11)
+
+### Features
+
+- runQuery.test.ts integration test pass ([180b17f](https://github.com/DrewBradfordXYZ/quickbase-js/commit/180b17f265c26a0d23bde3ca6993bad1ba4f65ee))
+- runQuery.test.ts unit test pass ([84e2fc4](https://github.com/DrewBradfordXYZ/quickbase-js/commit/84e2fc4f237d5f558fcd20d7b6b8eb83f685d7ac))
+
+### Bug Fixes
+
+- added stub variables to unit tests ([d84b534](https://github.com/DrewBradfordXYZ/quickbase-js/commit/d84b5344201300d8d59e622b025d96ad9813d4eb))
+- create env stubs for mock tests and update getTables.test.ts ([3d31c9e](https://github.com/DrewBradfordXYZ/quickbase-js/commit/3d31c9ebc9f852b99d1a807759490055d75c6396))
+
+## [1.1.0-beta.0](https://github.com/DrewBradfordXYZ/quickbase-js/compare/v1.0.1-beta.0...v1.1.0-beta.0) (2025-03-11)
+
+### Features
+
+- add deleteTable integration test with 404 verification ([277aec6](https://github.com/DrewBradfordXYZ/quickbase-js/commit/277aec66a3047fab687ce81ad42b9371e8c2bf56))
+- deleteRecords integration and unit tests ([d3beba1](https://github.com/DrewBradfordXYZ/quickbase-js/commit/d3beba1a362b13166b38f59eeea83c289ddaf999))
+- integration tests for deleteRecords and upsert pass ([759978b](https://github.com/DrewBradfordXYZ/quickbase-js/commit/759978bc13cb1c50c03770232eb02a1c3c08428d))
+- mock deleteRecords passes ([a167028](https://github.com/DrewBradfordXYZ/quickbase-js/commit/a1670286def030950c568e92ca99ea12e20d5b62))
+- upsert mock test passes ([dde6d07](https://github.com/DrewBradfordXYZ/quickbase-js/commit/dde6d07d4c4c73bd14189f87fdc6347744004e4e))
+
+### Bug Fixes
+
+- all vitests are passing again ([7206ba3](https://github.com/DrewBradfordXYZ/quickbase-js/commit/7206ba3f28bd7a3c7f5d699988e9a9a1f0053f42))
+- fix-spec and test updates for createTable ([9c0cdd3](https://github.com/DrewBradfordXYZ/quickbase-js/commit/9c0cdd3b707971e6fb8f3e73598e3a600ff2b33d))
+- fix-spec for upsertRecords and createApp ([d12de40](https://github.com/DrewBradfordXYZ/quickbase-js/commit/d12de40feac35e5d86a0b7d5019d8058cdfcffd9))
+- fix-spec getTable ([1eb936c](https://github.com/DrewBradfordXYZ/quickbase-js/commit/1eb936c360ce5df4818b8d5ef7ccf4dc6b769af0))
+- fix-spec getTable deleteTable ([236349a](https://github.com/DrewBradfordXYZ/quickbase-js/commit/236349af9e30776e00754232d83d76e065aab00b))
+- fix-spec updates for createApp ([3614958](https://github.com/DrewBradfordXYZ/quickbase-js/commit/36149589ff2544ec50a82d9dc9b183f15d07778d))
+- fix-spec updateTable ([26e278c](https://github.com/DrewBradfordXYZ/quickbase-js/commit/26e278cdbbe96d33e51f14e90ebb2c8b47d70f07))
+- getTables test pass, change order for extractDbid to assign temp token dbid ([37b7685](https://github.com/DrewBradfordXYZ/quickbase-js/commit/37b7685d55a0f64e62cb91ad23df28d4916d5a50))
+- upsert unit test type fixes ([8460cc8](https://github.com/DrewBradfordXYZ/quickbase-js/commit/8460cc8e63564bc8602dc12a9b6415094cc215f0))
+
+### 1.0.1-beta.0 (2025-03-10)
+
+Testing done in a consuming library for getApp() and getFields()

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Drew Bradford
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,204 @@
+# quickbase-js
+
+# Installation
+
+```bash
+npm install --save quickbase-js
+```
+
+## Examples
+
+### CDN Code Page
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Quickbase</title>
+    <script src="https://cdn.jsdelivr.net/npm/quickbase-js@1.1.0-beta.6/dist/umd/quickbase.umd.min.js"></script>
+  </head>
+
+  <body>
+    <div>
+      <h1>Quickbase-js CDN Example</h1>
+      <p id="result">Loading...</p>
+    </div>
+    <script>
+      var realm = "xxxxxxxxxxxxxxxxxxxx"; // replace with your realm
+      var appId = "xxxxxxxxxxxxxxxxxxxx"; // replace with your app ID
+      if (typeof QuickbaseJS === "undefined") {
+        document.getElementById("result").textContent =
+          "Error: Failed to load QuickbaseJS library.";
+      } else {
+        var qbClient = QuickbaseJS.quickbase({
+          realm,
+          useTempTokens: true,
+        });
+
+        qbClient
+          .getApp({ appId })
+          .then(function (app) {
+            document.getElementById("result").textContent =
+              "App Name: " + app.name;
+          })
+          .catch(function (err) {
+            document.getElementById("result").textContent =
+              "Error: " + (err.message || "Failed to load app");
+          });
+      }
+    </script>
+  </body>
+</html>
+```
+
+# Development workflow
+
+```bash
+npm run gen:all
+npm run build
+npm run test:all
+```
+
+## Usage
+
+### Node.js (ESM - Recommended)
+
+For modern Node.js applications, use ES modules:
+
+```javascript
+// ESM (Node.js) - Recommended
+import { quickbase } from "quickbase-js";
+const qb = quickbase({ realm: "example", userToken: "your-token" });
+
+// Example: Fetching an app
+const app = await qb.getApp({ appId: "your-app-id" });
+console.log(app);
+
+// Example: Creating a record with temporary token
+const qbTemp = quickbase({ realm: "example", useTempTokens: true });
+const record = await qbTemp.upsert({
+  body: {
+    to: "your-table-id",
+    data: [
+      {
+        /* record data */
+      },
+    ],
+  },
+});
+console.log(record);
+```
+
+```javascript
+// Example: TypeScript ESM (Recommended)
+import { quickbase } from "quickbase-js";
+const qbTyped: QuickbaseClient = quickbase({
+  realm: "example",
+  userToken: "your-token",
+});
+const typedApp = await qbTyped.getApp({ appId: "your-app-id" });
+console.log(typedApp);
+```
+
+```javascript
+// Example: UMD via CDN (QuickBase Code Pages)
+// Note: This is HTML, not JavaScript, and should be used in a browser environment
+
+<script src="https://cdn.jsdelivr.net/npm/quickbase-js@1.1.0-beta.4/dist/umd/quickbase.umd.js"></script>
+<script>
+  const qb = new QuickbaseJS({ realm: 'example', useTempTokens: true });
+  // Example: Fetching an app
+  qb.getApp({ appId: 'your-app-id' }).then(app => console.log(app));
+</script>
+
+```
+
+## In QuickBase Code Pages (Browser Environment)
+
+### useTempTokens: true:
+
+Token Fetch: Auto-fetches temporary tokens using the provided fetchApi (or window.fetch by default) with cookies (withCredentials: true in the internal tokenClient).
+
+Subsequent Calls (e.g., getApp): Uses the same fetchApi (or window.fetch) with the QB-TEMP-TOKEN {TOKEN} header. No additional config needed beyond realm and useTempTokens.
+
+How It Works: Leverages the browser’s session cookies for the initial token fetch, then uses the token for all API calls. In a real code page, window.fetch handles both steps seamlessly.
+
+Test Output: The test uses page.evaluate for token fetch and node-fetch for getApp to bypass Playwright’s browser fetch issue, but in a code page, it’s all window.fetch.
+
+### userToken:
+
+All Calls: Uses the provided fetchApi (or window.fetch by default) with the QB-USER-TOKEN {TOKEN} header. No session cookies needed (credentials: "omit").
+
+How It Works: The user token authenticates directly, independent of the browser session, making it straightforward and reliable.
+
+Test Output: Confirms this with page.evaluate sending QB-USER-TOKEN.
+
+## In Node.js (Non-Browser Environment)
+
+### userToken:
+
+All Calls: Works with a provided fetchApi (e.g., fetchApi: node-fetch). Sets QB-USER-TOKEN {TOKEN} header.
+
+How It Works: Fully functional as long as fetchApi is supplied (e.g., node-fetch), since user tokens don’t require a browser session.
+
+Requirement: Must provide fetchApi explicitly (no default in Node.js).
+
+### useTempTokens: true:
+
+Behavior: Fails with a clear error unless a browser-like fetchApi is provided:
+
+"Temporary tokens require a browser environment or a custom fetchApi with browser-like session support"
+
+How It Works: Temp tokens need a browser session with cookies, which Node.js can’t provide natively. A custom fetchApi (e.g., via Puppeteer) could work but is impractical for typical Node.js use.
+
+Practicality: Effectively unusable in Node.js without external browser support, aligning with QuickBase’s temp token requirement.
+
+## getTempTokenDBID
+
+Temporary Token Handling with getTempTokenDBID
+The QuickBase API provides the getTempTokenDBID method to fetch temporary tokens (QB-TEMP-TOKEN) for browser-based authentication, typically using session credentials (e.g., cookies). These tokens are short-lived (~5 minutes) and intended for secure, client-side API calls. In the generated OpenAPI client, getTempTokenDBID makes a straightforward GET request to /v1/auth/temporary/{dbid} and returns { temporaryAuthorization: string }. However, this raw implementation lacks caching and doesn’t optimize repeated calls, which can lead to unnecessary API requests.
+In quickbaseClient.ts, we enhance getTempTokenDBID when useTempTokens: true is enabled, wrapping it with intelligent token management:
+Caching: We introduce a TokenCache to store temporary tokens by dbid. Before fetching a new token, the client checks the cache. If a valid token exists, it’s returned immediately, avoiding redundant API calls.
+
+Custom Fetch Logic: Instead of relying solely on the generated method, we use a custom fetchTempToken function to fetch tokens. This ensures consistency with browser-based session authentication (credentials: "include") and allows us to cache the result.
+
+Early Returns: For getTempTokenDBID, we bypass the generated method’s execution by returning the cached or freshly fetched token directly. This prevents unnecessary calls to the underlying API when the token is already available or just retrieved.
+
+Why This Matters
+Efficiency: Caching reduces API requests, crucial for performance in browser environments where temp tokens are fetched frequently but don’t change within their lifespan.
+
+Seamless Integration: The wrapper supports both QB-USER-TOKEN (server-side) and QB-TEMP-TOKEN (client-side) workflows, controlled by the useTempTokens config. This makes the client versatile for different use cases.
+
+Testability: The enhancement fixes issues in unit tests (e.g., getTempToken.test.ts) by ensuring predictable behavior—fetching once and reusing cached tokens—avoiding unexpected errors from redundant calls.
+
+How It Works
+When you call client.getTempTokenDBID({ dbid: "someDbid" }) with useTempTokens: true:
+Cache Check: Looks for an existing token in tokenCache for the given dbid.
+
+Fetch if Needed: If no cached token exists, fetchTempToken requests a new one from /v1/auth/temporary/{dbid} and caches it.
+
+Return Early: Returns { temporaryAuthorization: token } immediately, skipping the generated method’s execution.
+
+For other methods (e.g., getFields), the fetched temp token is applied to the Authorization header, ensuring authenticated API calls without re-fetching.
+
+## 401 Unauthorized Error Behavior
+
+The quickbase-js library manages 401 Unauthorized errors from the QuickBase API when using temporary tokens (useTempTokens: true). Normally, it keeps tokens fresh via a time-managed cache intending to never have a 401 Unauthorized error, but there is added safety measures incase a 401 happens to occur.
+
+If a 401 happens, the library tries once more with a fresh temporary token.
+
+It gets the new token using fetchTempToken and retries the call.
+
+If the retry fails with another 401, it stops and throws an error like API Error: Unauthorized (Status: 401).
+
+Fetching a New Token:
+If fetchTempToken itself gets a 401 (e.g., no valid login session), it doesn’t retry.
+
+It throws an error right away: API Error: Unauthorized (Status: 401).
+
+Why It’s Like This
+One Retry: Retries once to fix expired tokens, but stops to avoid endless tries.
+
+Fast Fail: No retry on fetchTempToken 401s means you know quickly if login is broken.
+
+No Loops: Built to never get stuck retrying forever.

package/build-common.js

@@ -0,0 +1,131 @@
+// build-common.js
+import { execSync } from "child_process";
+import { rollup } from "rollup";
+import terser from "@rollup/plugin-terser";
+import nodeResolve from "@rollup/plugin-node-resolve";
+import commonjs from "@rollup/plugin-commonjs";
+import dts from "rollup-plugin-dts";
+import { rimrafSync } from "rimraf";
+import {
+  copyFileSync,
+  readdirSync,
+  readFileSync,
+  writeFileSync,
+  mkdirSync,
+  statSync,
+} from "fs";
+import { join } from "path";
+
+export const external = [
+  "node:http",
+  "node:https",
+  "node:zlib",
+  "node:stream",
+  "node:buffer",
+  "node:util",
+  "node:url",
+  "node:net",
+  "node:fs",
+  "node:path",
+  "node-fetch",
+];
+export const globals = { "node-fetch": "fetch" };
+
+export const srcDir = join(process.cwd(), "src");
+export const tempSrcDir = join(process.cwd(), "dist/temp-src");
+export const excludeDirs = ["specs"];
+export const excludeFiles = ["generated/index.ts"]; // Exclude generated/index.ts to avoid duplicate exports
+
+export function copyAndRewriteTsExtensions(src, dest) {
+  console.log(`Copying from ${src} to ${dest}`);
+  mkdirSync(dest, { recursive: true });
+  const files = readdirSync(src, { withFileTypes: true });
+
+  for (const file of files) {
+    const srcPath = join(src, file.name);
+    const destPath = join(dest, file.name);
+
+    if (file.isDirectory()) {
+      if (excludeDirs.includes(file.name)) {
+        console.log(`Skipping excluded directory ${srcPath}`);
+        continue;
+      }
+      copyAndRewriteTsExtensions(srcPath, destPath);
+    } else if (file.name.endsWith(".ts")) {
+      if (excludeFiles.some((excluded) => srcPath.includes(excluded))) {
+        console.log(`Skipping excluded file ${srcPath}`);
+        continue;
+      }
+      console.log(`Processing ${srcPath} -> ${destPath}`);
+      let fileContent = readFileSync(srcPath, "utf8");
+
+      // Remove .ts extensions from import/export statements for runtime compatibility
+      fileContent = removeTsExtensionsFromImports(fileContent);
+      fileContent = removeTsExtensionsFromStarExports(fileContent);
+
+      writeFileSync(destPath, fileContent, "utf8");
+    } else {
+      console.log(`Skipping non-.ts file ${srcPath}`);
+    }
+  }
+}
+
+export function removeTsExtensionsFromImports(content) {
+  // Matches: 'from "./some/path.ts"' or 'from "../another.ts"'
+  const importPattern = /from\s+(['"])(\.[\w\/-]+)\.ts\1/g;
+  return content.replace(importPattern, `from $1$2$1`);
+}
+
+export function removeTsExtensionsFromStarExports(content) {
+  // Matches: 'export * from "./some/path.ts"' or 'export * from "../another.ts"'
+  const exportStarPattern = /export\s+\*\s+from\s+(['"])(\.[\w\/-]+)\.ts\1/g;
+  return content.replace(exportStarPattern, `export * from $1$2$1`);
+}
+
+export async function createBundle(input, plugins, format, outputOptions) {
+  const bundle = await rollup({
+    input,
+    external,
+    plugins,
+  });
+  await bundle.write(outputOptions);
+  await bundle.close();
+}
+
+export function compileTypeScript() {
+  console.log("Running tsc...");
+  const tsFiles = readdirSync(tempSrcDir, { recursive: true })
+    .filter((file) => file.endsWith(".ts"))
+    .map((file) => join(tempSrcDir, file));
+  const tscCommand = `npx tsc ${tsFiles.join(" ")} --outDir ${join(
+    process.cwd(),
+    "dist/temp"
+  )} --module ESNext --target ESNext --sourceMap --moduleResolution bundler --baseUrl ${process.cwd()}`;
+  console.log(`Command: ${tscCommand}`);
+  execSync(tscCommand, { stdio: "inherit" });
+}
+
+export async function generateDeclarations() {
+  console.log("Generating declarations...");
+  const dtsBundle = await rollup({
+    input: "src/quickbaseClient.ts",
+    plugins: [dts({ tsconfig: "./tsconfig.json", respectExternal: true })],
+  });
+  await dtsBundle.write({ file: "dist/esm/quickbase.d.ts", format: "esm" });
+  await dtsBundle.write({ file: "dist/umd/quickbase.umd.d.ts", format: "umd" });
+  await dtsBundle.close();
+}
+
+export function listFilesWithSizes(dir, prefix = "") {
+  const files = readdirSync(dir, { withFileTypes: true });
+  for (const file of files) {
+    const filePath = join(dir, file.name);
+    if (file.isDirectory()) {
+      listFilesWithSizes(filePath, `${prefix}${file.name}/`);
+    } else {
+      const stats = statSync(filePath);
+      const sizeKB = (stats.size / 1024).toFixed(2);
+      console.log(`${prefix}${file.name} - ${sizeKB} KB`);
+    }
+  }
+}

package/build-esm.js

@@ -0,0 +1,71 @@
+import { rimrafSync } from "rimraf";
+import { join } from "path";
+import nodeResolve from "@rollup/plugin-node-resolve";
+import commonjs from "@rollup/plugin-commonjs";
+import terser from "@rollup/plugin-terser";
+import {
+  copyAndRewriteTsExtensions,
+  compileTypeScript,
+  createBundle,
+  external,
+  globals,
+  srcDir,
+  tempSrcDir,
+  generateDeclarations,
+  listFilesWithSizes,
+} from "./build-common.js";
+
+// Clean specific folders for ESM build
+rimrafSync("dist/esm");
+rimrafSync("dist/temp");
+rimrafSync("dist/temp-src");
+
+// Copy and rewrite TS files
+copyAndRewriteTsExtensions(srcDir, tempSrcDir);
+
+// Compile TypeScript
+compileTypeScript();
+
+// ESM Builds
+console.log("Building ESM bundles...");
+
+// Generate unminified ESM bundle
+console.log("Building unminified ESM bundle...");
+await createBundle(
+  "dist/temp/quickbaseClient.js",
+  [nodeResolve({ preferBuiltins: true }), commonjs()],
+  "esm",
+  {
+    dir: "dist/esm",
+    format: "esm",
+    sourcemap: true,
+    entryFileNames: "quickbase.js",
+  }
+);
+
+// Generate minified ESM bundle
+console.log("Building minified ESM bundle...");
+await createBundle(
+  "dist/temp/quickbaseClient.js",
+  [nodeResolve({ preferBuiltins: true }), commonjs(), terser()],
+  "esm",
+  {
+    dir: "dist/esm",
+    format: "esm",
+    sourcemap: true,
+    entryFileNames: "quickbase.min.js",
+  }
+);
+
+// Generate declarations
+await generateDeclarations();
+
+// Clean up
+rimrafSync("dist/temp");
+rimrafSync("dist/temp-src");
+
+// List generated files
+console.log("\nGenerated files:");
+listFilesWithSizes(join(process.cwd(), "dist/esm"));
+
+console.log("\nESM build completed successfully");

package/build-umd.js

@@ -0,0 +1,69 @@
+import { rimrafSync } from "rimraf";
+import { join } from "path";
+import nodeResolve from "@rollup/plugin-node-resolve";
+import commonjs from "@rollup/plugin-commonjs";
+import terser from "@rollup/plugin-terser";
+import {
+  copyAndRewriteTsExtensions,
+  compileTypeScript,
+  createBundle,
+  external,
+  globals,
+  srcDir,
+  tempSrcDir,
+  listFilesWithSizes,
+} from "./build-common.js";
+
+// Clean specific folders for UMD build
+rimrafSync("dist/umd");
+rimrafSync("dist/temp");
+rimrafSync("dist/temp-src");
+
+// Copy and rewrite TS files
+copyAndRewriteTsExtensions(srcDir, tempSrcDir);
+
+// Compile TypeScript
+compileTypeScript();
+
+// UMD Builds
+console.log("Building UMD bundles...");
+
+// Generate unminified UMD bundle
+console.log("Building unminified UMD bundle...");
+await createBundle(
+  "dist/temp/quickbaseClient.js",
+  [nodeResolve({ preferBuiltins: true, browser: true }), commonjs()],
+  "umd",
+  {
+    file: join(process.cwd(), "dist/umd", "quickbase.umd.js"),
+    format: "umd",
+    name: "QuickbaseJS",
+    sourcemap: true,
+    globals,
+  }
+);
+
+// Generate minified UMD bundle
+console.log("Building minified UMD bundle...");
+await createBundle(
+  "dist/temp/quickbaseClient.js",
+  [nodeResolve({ preferBuiltins: true, browser: true }), commonjs(), terser()],
+  "umd",
+  {
+    file: join(process.cwd(), "dist/umd", "quickbase.umd.min.js"),
+    format: "umd",
+    name: "QuickbaseJS",
+    sourcemap: true,
+    globals,
+  }
+);
+
+// Clean up
+rimrafSync("dist/temp");
+rimrafSync("dist/temp-src");
+
+// List generated files
+console.log("\nGenerated files:");
+listFilesWithSizes(join(process.cwd(), "dist/umd"));
+
+console.log("\nUMD build completed successfully");