@openstax/ts-utils 1.34.0 → 1.35.0

package/dist/esm/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Returns the literal type `'yes'` if the first generic tuple array is a prefix of the second,
+ * the `'no'` literal type otherwise. Can be used in conditional types, e.g.
+ *
+ * `type WillBeString = TupleExtends<[1,2], [1,2,3]> extends 'yes' ? string : number;`
+ *
+ * There may be a better way to do this; `T1 extends T2` doesn't work
+ */
+export type TupleExtends<T1, T2> = T1 extends [infer T1Head, ...infer T1Tail] ? T2 extends [infer T2Head, ...infer T2Tail] ? T1Head extends T2Head ? TupleExtends<T1Tail, T2Tail> extends 'yes' ? 'yes' : 'no' : 'no' : T2 extends [] ? 'yes' : 'no' : T1 extends [] ? T2 extends [] ? 'yes' : 'no' : 'no';
+/**
+ * unions each member of the tuple
+ */
+export type TupleZip<T1, T2> = T1 extends [infer T1Head, ...infer T1Tail] ? T2 extends [infer T2Head, ...infer T2Tail] ? [T1Head & T2Head, ...TupleZip<T1Tail, T2Tail>] : T2 extends [] ? T1 : never : T1 extends [] ? T2 extends any[] ? T2 : never : never;
+/**
+ * If `R` is `Promise<I>`, returns `I`, otherwise returns `R`
+ * @deprecated use TypeScript builtin Awaited instead:
+ * @see https://www.typescriptlang.org/docs/handbook/release-notes/typescript-4-5.html#the-awaited-type-and-promise-improvements
+ */
+export type UnwrapPromise<R> = R extends Promise<infer I> ? I : R;
+/**
+ * turns `thing | thing2` into `thing & thing2`
+ * @see https://stackoverflow.com/a/50375286/14809536
+ */
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+/**
+ * make certain fields required
+ * @see https://stackoverflow.com/a/69328045/14809536
+ */
+export type WithRequired<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,22 +1,244 @@
 {
   "name": "@openstax/ts-utils",
-  "version": "1.34.0",
+  "version": "1.35.0",
+  "bin": {
+    "ts-utils": "./script/bin-entry.bash"
+  },
   "dependencies": {
-    "@openstax/ts-utils": "1.33.0"
+    "@aws-sdk/client-dynamodb": "^3.171.0",
+    "@aws-sdk/client-s3": "^3.267.0",
+    "@aws-sdk/client-ssm": "^3.171.0",
+    "@aws-sdk/client-sts": "^3.171.0",
+    "@aws-sdk/s3-presigned-post": "^3.267.0",
+    "@aws-sdk/s3-request-presigner": "^3.267.0",
+    "@aws-sdk/util-dynamodb": "^3.171.0",
+    "aws-sdk": "^2.1145.0",
+    "cookie": "^0.5.0",
+    "date-fns": "^2.29.2",
+    "deep-equal": "^2.1.0",
+    "jsonwebtoken": "^9.0.0",
+    "jwks-rsa": "^3.1.0",
+    "ms": "^2.1.3",
+    "node-jose": "^2.2.0",
+    "path-to-regexp": "^6.2.0",
+    "query-string": "^7.1.1",
+    "tiny-async-pool": "^2.1.0",
+    "uuid": "^9.0.0"
   },
   "devDependencies": {
-    "syncpack": "^12.3.0"
+    "@opensearch-project/opensearch": "^1.2.0",
+    "@types/cookie": "^0.5.0",
+    "@types/cors": "^2.8.13",
+    "@types/deep-equal": "^1.0.1",
+    "@types/express": "^4.17.13",
+    "@types/jest": "^29.5.14",
+    "@types/jsonwebtoken": "^9.0.1",
+    "@types/lodash": "^4.14.200",
+    "@types/ms": "^0.7.34",
+    "@types/multer": "^1.4.7",
+    "@types/node": "^24.2.0",
+    "@types/node-fetch": "^2.6.11",
+    "@types/node-jose": "^1.1.12",
+    "@types/tiny-async-pool": "^2.0.0",
+    "@types/uuid": "^8.3.4",
+    "@typescript-eslint/eslint-plugin": "^5.13.0",
+    "@typescript-eslint/parser": "^8.39.0",
+    "cors": "^2.8.5",
+    "cspell": "^5.18.5",
+    "eslint": "^8.10.0",
+    "eslint-plugin-import": "^2.25.4",
+    "eslint-plugin-jest": "^26.1.1",
+    "express": "^4.17.3",
+    "jest": "^29.7.0",
+    "multer": "^1.4.5-lts.1",
+    "node-fetch": "^2.7.0",
+    "npm-run-all": "^4.1.5",
+    "postgres": "^3.4.5",
+    "rollup-plugin-commonjs": "^10.1.0",
+    "rollup-plugin-typescript2": "^0.31.2",
+    "ts-jest": "^29.4.1",
+    "typescript": "5.9.2",
+    "yargs": "^17.5.1",
+    "zod": "^4.0.15"
+  },
+  "exports": {
+    ".": {
+      "browser": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./*": {
+      "browser": "./dist/cjs/*.js",
+      "import": "./dist/esm/*.js",
+      "require": "./dist/cjs/*.js"
+    },
+    "./assertions": {
+      "browser": "./dist/cjs/assertions/index.js",
+      "import": "./dist/esm/assertions/index.js",
+      "require": "./dist/cjs/assertions/index.js"
+    },
+    "./aws": {
+      "browser": "./dist/cjs/aws/index.js",
+      "import": "./dist/esm/aws/index.js",
+      "require": "./dist/cjs/aws/index.js"
+    },
+    "./config": {
+      "browser": "./dist/cjs/config/index.js",
+      "import": "./dist/esm/config/index.js",
+      "require": "./dist/cjs/config/index.js"
+    },
+    "./errors": {
+      "browser": "./dist/cjs/errors/index.js",
+      "import": "./dist/esm/errors/index.js",
+      "require": "./dist/cjs/errors/index.js"
+    },
+    "./fetch": {
+      "browser": "./dist/cjs/fetch/index.js",
+      "import": "./dist/esm/fetch/index.js",
+      "require": "./dist/cjs/fetch/index.js"
+    },
+    "./guards": {
+      "browser": "./dist/cjs/guards/index.js",
+      "import": "./dist/esm/guards/index.js",
+      "require": "./dist/cjs/guards/index.js"
+    },
+    "./middleware": {
+      "browser": "./dist/cjs/middleware/index.js",
+      "import": "./dist/esm/middleware/index.js",
+      "require": "./dist/cjs/middleware/index.js"
+    },
+    "./misc": {
+      "browser": "./dist/cjs/misc/index.js",
+      "import": "./dist/esm/misc/index.js",
+      "require": "./dist/cjs/misc/index.js"
+    },
+    "./pagination": {
+      "browser": "./dist/cjs/pagination/index.js",
+      "import": "./dist/esm/pagination/index.js",
+      "require": "./dist/cjs/pagination/index.js"
+    },
+    "./routing": {
+      "browser": "./dist/cjs/routing/index.js",
+      "import": "./dist/esm/routing/index.js",
+      "require": "./dist/cjs/routing/index.js"
+    },
+    "./services": {
+      "browser": "./dist/cjs/services/index.js",
+      "import": "./dist/esm/services/index.js",
+      "require": "./dist/cjs/services/index.js"
+    },
+    "./services/launchParams": {
+      "browser": "./dist/cjs/services/launchParams/index.js",
+      "import": "./dist/esm/services/launchParams/index.js",
+      "require": "./dist/cjs/services/launchParams/index.js"
+    },
+    "./services/exercisesGateway": {
+      "browser": "./dist/cjs/services/exercisesGateway/index.js",
+      "import": "./dist/esm/services/exercisesGateway/index.js",
+      "require": "./dist/cjs/services/exercisesGateway/index.js"
+    },
+    "./services/accountsGateway": {
+      "browser": "./dist/cjs/services/accountsGateway/index.js",
+      "import": "./dist/esm/services/accountsGateway/index.js",
+      "require": "./dist/cjs/services/accountsGateway/index.js"
+    },
+    "./services/logger": {
+      "browser": "./dist/cjs/services/logger/index.js",
+      "import": "./dist/esm/services/logger/index.js",
+      "require": "./dist/cjs/services/logger/index.js"
+    },
+    "./services/searchProvider": {
+      "browser": "./dist/cjs/services/searchProvider/index.js",
+      "import": "./dist/esm/services/searchProvider/index.js",
+      "require": "./dist/cjs/services/searchProvider/index.js"
+    },
+    "./services/documentStore": {
+      "browser": "./dist/cjs/services/documentStore/index.js",
+      "import": "./dist/esm/services/documentStore/index.js",
+      "require": "./dist/cjs/services/documentStore/index.js"
+    },
+    "./services/documentStore/unversioned": {
+      "browser": "./dist/cjs/services/documentStore/unversioned/index.js",
+      "import": "./dist/esm/services/documentStore/unversioned/index.js",
+      "require": "./dist/cjs/services/documentStore/unversioned/index.js"
+    },
+    "./services/documentStore/versioned": {
+      "browser": "./dist/cjs/services/documentStore/versioned/index.js",
+      "import": "./dist/esm/services/documentStore/versioned/index.js",
+      "require": "./dist/cjs/services/documentStore/versioned/index.js"
+    },
+    "./services/lrsGateway": {
+      "browser": "./dist/cjs/services/lrsGateway/index.js",
+      "import": "./dist/esm/services/lrsGateway/index.js",
+      "require": "./dist/cjs/services/lrsGateway/index.js"
+    },
+    "./services/authProvider": {
+      "browser": "./dist/cjs/services/authProvider/index.js",
+      "import": "./dist/esm/services/authProvider/index.js",
+      "require": "./dist/cjs/services/authProvider/index.js"
+    },
+    "./services/authProvider/utils": {
+      "browser": "./dist/cjs/services/authProvider/utils/index.js",
+      "import": "./dist/esm/services/authProvider/utils/index.js",
+      "require": "./dist/cjs/services/authProvider/utils/index.js"
+    },
+    "./services/apiGateway": {
+      "browser": "./dist/cjs/services/apiGateway/index.js",
+      "import": "./dist/esm/services/apiGateway/index.js",
+      "require": "./dist/cjs/services/apiGateway/index.js"
+    },
+    "./services/fileServer": {
+      "browser": "./dist/cjs/services/fileServer/index.js",
+      "import": "./dist/esm/services/fileServer/index.js",
+      "require": "./dist/cjs/services/fileServer/index.js"
+    },
+    "./services/postgresConnection": {
+      "browser": "./dist/cjs/services/postgresConnection/index.js",
+      "import": "./dist/esm/services/postgresConnection/index.js",
+      "require": "./dist/cjs/services/postgresConnection/index.js"
+    },
+    "./services/streamIndexer": {
+      "browser": "./dist/cjs/services/streamIndexer/index.js",
+      "import": "./dist/esm/services/streamIndexer/index.js",
+      "require": "./dist/cjs/services/streamIndexer/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "script"
+  ],
+  "license": "MIT",
+  "main": "index.js",
+  "peerDependencies": {
+    "@opensearch-project/opensearch": "^1.2.0",
+    "cors": "^2.8.5",
+    "express": "^4.17.3",
+    "multer": "^1.4.5-lts.1",
+    "postgres": "^3.4.5",
+    "zod": "^4.0.15"
   },
-  "private": false,
   "scripts": {
-    "build": "./scripts/build.bash",
+    "build": "./script/build.bash",
+    "build:clean": "yarn clean && yarn build",
     "ci": "CI=true npm-run-all ci:*",
-    "ci:packages": "./scripts/ci.bash",
-    "ci:spelling": "git ls-files -- . ':!:packages/' | yarn cspell -c ./cspell.json --file-list stdin",
-    "ci:versions": "syncpack lint",
-    "start": "./scripts/start.bash"
+    "ci:lint": "eslint --max-warnings=0 .",
+    "ci:spelling": "git ls-files | yarn cspell -c ../../cspell.json --file-list stdin",
+    "ci:test": "yarn jest --coverage",
+    "ci:typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "coverage-report": "open coverage/index.html",
+    "start": "./script/build.bash --watch",
+    "test": "yarn jest"
   },
-  "workspaces": [
-    "packages/*"
-  ]
+  "sideEffects": false,
+  "types": "index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/esm/*",
+        "dist/esm/*.d.ts",
+        "dist/esm/*/index.d.ts"
+      ]
+    }
+  }
 }

package/.cfnlintrc

@@ -1,2 +0,0 @@
-templates:
-  - deploy/*.cfn.yml

package/.github/CODEOWNERS

@@ -1 +0,0 @@
-* @openstax/disco-devs

package/.github/workflows/ci.yml

@@ -1,36 +0,0 @@
-name: CI
-
-on: [pull_request]
-
-jobs:
-  linked_issue:
-    name: Jira
-    runs-on: ubuntu-latest
-    steps:
-    - uses: openstax/jira-linked-action@v0.1.14
-      with:
-        jira_site: openstax
-        jira_project: DISCO
-        jira_email: ${{ secrets.JiraEmail }}
-        jira_token: ${{ secrets.JiraToken }}
-  test:
-    name: checks
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        module: [lambda, frontend, utils]
-    env:
-      CI: true
-    steps:
-    - uses: actions/checkout@v2
-      with:
-        ref: ${{ github.event.pull_request.head.sha }}
-    - uses: actions/setup-node@v3
-      with:
-        node-version-file: .nvmrc
-        cache: yarn
-    - run: yarn install --immutable
-    - run: yarn build
-    - run: yarn ci
-      working-directory: packages/${{ matrix.module }}

package/.github/workflows/lint.yml

@@ -1,55 +0,0 @@
-name: Lint
-
-on: [pull_request]
-
-jobs:
-  cfn:
-    timeout-minutes: 30
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repo
-        uses: actions/checkout@v3
-        with:
-          ref: ${{ github.event.pull_request.head.sha }}
-
-      - name: Setup python
-        uses: actions/setup-python@v4
-        with:
-          python-version: 3.9
-
-      - name: Run pip install
-        run: pip install cfn-lint
-
-      - name: Run cfn-lint
-        run: cfn-lint
-  spelling:
-    name: spelling
-    runs-on: ubuntu-latest
-    env:
-      CI: true
-    steps:
-    - uses: actions/checkout@v2
-      with:
-        ref: ${{ github.event.pull_request.head.sha }}
-    - uses: actions/setup-node@v3
-      with:
-        node-version-file: .nvmrc
-        cache: yarn
-    - run: yarn install --immutable
-    - run: yarn ci:spelling
-  syncpack:
-    name: versions
-    runs-on: ubuntu-latest
-    env:
-      CI: true
-    steps:
-    - uses: actions/checkout@v2
-      with:
-        ref: ${{ github.event.pull_request.head.sha }}
-    - uses: actions/setup-node@v3
-      with:
-        node-version-file: .nvmrc
-        cache: yarn
-    - run: yarn install --immutable
-    - run: yarn ci:versions

package/.nvmrc

@@ -1 +0,0 @@
-v22.16.0

package/.syncignore

@@ -1,4 +0,0 @@
-README.md
-docs/*
-example/*
-packages/utils/*

package/.syncpackrc

@@ -1,18 +0,0 @@
-{
-  "semverGroups": [
-    {
-      "label": "use exact versions",
-      "packages": ["**"],
-      "dependencyTypes": ["**"],
-      "dependencies": ["@openstax/ts-utils", "typescript", "react-scripts", "@project/*", "@openstax/ui-components"],
-      "range": ""
-    },
-    {
-      "label": "use caret ranges",
-      "packages": ["**"],
-      "dependencyTypes": ["prod"],
-      "dependencies": ["**"],
-      "range": "^"
-    }
-  ]
-}

package/CONTRIBUTING.md

@@ -1,96 +0,0 @@
-<!-- spell-checker: ignore tada Connexions HOTFIXES -->
-# Contributing to Openstax
-
-:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
-
-The following is a set of guidelines for contributing to the Openstax repositories, which are hosted in the [Openstax Organization](https://github.com/openstax) and [Connexions Organization](https://github.com/Connexions) on GitHub.
-These are just guidelines, not rules. Use your best judgment and feel free to propose changes to this document in a pull request.
-
-#### Table of Contents
-
-- [Git Hygiene](#git-hygiene)
-  - [Use a Good Commit Message](#use-a-good-commit-message)
-  - [Squash Commits](#squash-commits)
-  - [Handling Merge Conflicts](#handling-merge-conflicts)
-- [Testing](#testing)
-  - [JavaScript](#javascript)
-
-# Git Hygiene
-
-Some guidelines for keeping your code in shape
-
-
-## Use a Good Commit Message
-
-[Use a good commit message](https://github.com/spring-projects/spring-framework/blob/30bce7/CONTRIBUTING.md#format-commit-messages)
-
-
-## Squash Commits
-
-The project doesn't need a record of you fixing whitespace and spelling mistakes in your PR. As a general rule of thumb, if a commit modifies a previous commit in the same PR, it probably needs to be squashed. That means that a PR may often only be a single commit. This makes rebasing (see below) easier, and keeps the history clean, which can make debugging infinitely easier in the long run.
-
-- It's fine to make as many commits as you need while you're working on your local branch. Keeping your history clean as you work will probably be much easier than trying to do it all at the end, though.
-
-- If you just want to make a change and have it apply to your last commit, you can use `git commit --amend`. If you want a change to be associated with an older commit, you can use `git commit -i HEAD~3` (where `3` is the number of commits to rebase). You can also use `git log` to find a commit's hash and `git rebase -i <commit hash>` (the commit should be the one PRIOR to the commit you want to modify).
-
-- Interactive rebase (`git rebase -i`) will open your default editor in which you can replace `pick` with `fixup` or `f` to combine commits (you can also use this to reorder commits, mark commits to edit their commit messages, and other powerful tools which are explained in the file itself). Save the changes, and git will execute the rebase.
-
-After rebasing, if your branch is already pushed up to GitHub, you'll have to force push the changes using `git push -f`, since the history has changed.
-
-**Warning:** Only rebase your own branches.
-
-**Warning:** **DO NOT REBASE HOTFIXES** Otherwise :bomb: :sparkles:
-
-
-
-## Handling Merge Conflicts
-
-Occasionally a Pull Request will have Merge Conflicts. **Do not merge master into your branch.** Instead, make sure your `master` branch is up to date:
-
-```sh
-git checkout master
-git pull
-```
-
-Then rebase your branch on `master`:
-
-```sh
-git checkout _my-branch_
-git rebase master
-```
-
-If there are any conflicts you need to resolve, it will suspend the rebase for you to fix them. Then do:
-
-```sh
-git add .
-git rebase --continue
-```
-
-It will do one round of conflict-checking for each commit in your branch, so keeping your history clean will make rebasing much easier. When the rebase is done, your branch will be up to date with master and ready to issue a PR if you are.
-
-# Hotfix
-To make a fix against production, first find the revision.  For example
-for tutor, you can find the revisions here: http://tutor.openstax.org/rev.txt
-
-Once you have the revision commit sha, you can do the following:
-```sh
-git branch <branch-name> <revision-sha>
-git checkout <branch-name>
-```
-
-After adding in your fixes, just push your branch up using:
-```sh
-git push origin <branch-name>
-```
-
-Since we don't keep a production branch, you can just make a PR against master and then you're done!
-
-# Testing
-
-This section contains testing practices for the various languages used in openstax
-
-## JavaScript
-
-Use the diagnostics from `npm test` (tests are also run as part of `npm start` and any changes to a file are also tested if `npm start` is currently running). 
-It's much easier to stay on top of issues as you make changes than trying to fix everything later. 
-If you have `npm start` running, it can also sometimes be useful to run `npm test` in a separate process, which will analyze every file, and is the same tests that Travis CI runs on commits and PRs.