release: 0.1.0-alpha.7

.gitignore

@@ -7,4 +7,5 @@ dist
 dist-deno
 /*.tgz
 .idea/
+.eslintcache
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.6"
+  ".": "0.1.0-alpha.7"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/zeroentropy%2Fzeroentropy-bd2f55f423e09b74f83cbad6034fb76f7052363308d02533a908b49543cff459.yml
-openapi_spec_hash: 6d7566ebda7fecac4069744949d547e0
-config_hash: e07cdee04c971e1db74e91a5a4cd981c
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/zeroentropy%2Fzeroentropy-c95681b13dc56e64126746c6e546b564c7f802ae567fc9ccc1aeb8eddd40bb1e.yml
+openapi_spec_hash: 2ac723122fe938e384f11b5cf19e85ec
+config_hash: 3be2ee54cbc850c508c90b9ffae2efe5

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.1.0-alpha.7 (2025-11-24)
+
+Full Changelog: [v0.1.0-alpha.6...v0.1.0-alpha.7](https://github.com/zeroentropy-ai/zeroentropy-node/compare/v0.1.0-alpha.6...v0.1.0-alpha.7)
+
+### Features
+
+* **api:** manual updates ([de2c445](https://github.com/zeroentropy-ai/zeroentropy-node/commit/de2c4458b3a9fc3a6bc66b3e34d3db411d5ca6cd))
+
+
+### Chores
+
+* ci build action ([f6e516b](https://github.com/zeroentropy-ai/zeroentropy-node/commit/f6e516bafe89d3d501a111e64a01684588606d41))
+* **deps:** update dependency node-fetch to v2.6.13 ([b514540](https://github.com/zeroentropy-ai/zeroentropy-node/commit/b514540dad74b0359060b3427407f53276f94209))
+* **internal:** formatting change ([f08028e](https://github.com/zeroentropy-ai/zeroentropy-node/commit/f08028ecf081a78515aa37d5a8f31d89bcc5ec12))
+* **internal:** move publish config ([0819835](https://github.com/zeroentropy-ai/zeroentropy-node/commit/0819835ac68f52cc71834e770bab910f9db38eb8))
+* **internal:** remove redundant imports config ([8044b42](https://github.com/zeroentropy-ai/zeroentropy-node/commit/8044b42a7e1860b59633b1c1eea41aecd0761f1a))
+* **internal:** update comment in script ([90782a4](https://github.com/zeroentropy-ai/zeroentropy-node/commit/90782a460c764624013f0cd0025c15c6ddc7a69f))
+* make some internal functions async ([9722ec8](https://github.com/zeroentropy-ai/zeroentropy-node/commit/9722ec887e08667e0c2ffabe3b0e6e5390187da2))
+* update @stainless-api/prism-cli to v5.15.0 ([16c797e](https://github.com/zeroentropy-ai/zeroentropy-node/commit/16c797edaf4fc82dad985a6b8363c26d99da934a))
+* update CI script ([96de540](https://github.com/zeroentropy-ai/zeroentropy-node/commit/96de540a48b20d9e3b5abfed353056d2aca48de7))
+
 ## 0.1.0-alpha.6 (2025-07-08)
 
 Full Changelog: [v0.1.0-alpha.5...v0.1.0-alpha.6](https://github.com/zeroentropy-ai/zeroentropy-node/compare/v0.1.0-alpha.5...v0.1.0-alpha.6)

bin/publish-npm

@@ -58,4 +58,4 @@ else
 fi
 
 # Publish with the appropriate tag
-yarn publish --access public --tag "$TAG"
+yarn publish --tag "$TAG"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "zeroentropy",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.7",
   "description": "The official TypeScript library for the ZeroEntropy API",
   "author": "ZeroEntropy <founders@zeroentropy.dev>",
   "types": "dist/index.d.ts",
@@ -13,6 +13,9 @@
     "**/*"
   ],
   "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "./scripts/test",
     "build": "./scripts/build",
@@ -58,10 +61,6 @@
     "./shims/web.js",
     "./shims/web.mjs"
   ],
-  "imports": {
-    "zeroentropy": ".",
-    "zeroentropy/*": "./src/*"
-  },
   "exports": {
     "./_shims/auto/*": {
       "deno": {

scripts/bootstrap

@@ -4,10 +4,18 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ]; then
+if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ] && [ -t 0 ]; then
   brew bundle check >/dev/null 2>&1 || {
-    echo "==> Installing Homebrew dependencies…"
-    brew bundle
+    echo -n "==> Install Homebrew dependencies? (y/N): "
+    read -r response
+    case "$response" in
+      [yY][eE][sS]|[yY])
+        brew bundle
+        ;;
+      *)
+        ;;
+    esac
+    echo
   }
 fi
 

scripts/fast-format

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+echo "Script started with $# arguments"
+echo "Arguments: $*"
+echo "Script location: $(dirname "$0")"
+
+cd "$(dirname "$0")/.."
+echo "Changed to directory: $(pwd)"
+
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <file-with-paths> [additional-formatter-args...]"
+    echo "The file should contain one file path per line"
+    exit 1
+fi
+
+FILE_LIST="$1"
+
+echo "Looking for file: $FILE_LIST"
+
+if [ ! -f "$FILE_LIST" ]; then
+    echo "Error: File '$FILE_LIST' not found"
+    exit 1
+fi
+
+echo "==> Running eslint --fix"
+ESLINT_FILES="$(grep '\.ts$' "$FILE_LIST" || true)"
+if ! [ -z "$ESLINT_FILES" ]; then
+   echo "$ESLINT_FILES" | ESLINT_USE_FLAT_CONFIG="false" xargs ./node_modules/.bin/eslint --cache --fix
+fi
+
+echo "==> Running prettier --write"
+# format things eslint didn't
+PRETTIER_FILES="$(grep '\.\(js\|json\)$' "$FILE_LIST" || true)"
+if ! [ -z "$PRETTIER_FILES" ]; then
+   echo "$PRETTIER_FILES" | xargs ./node_modules/.bin/prettier \
+      --write --cache --cache-strategy metadata --no-error-on-unmatched-pattern \
+      '!**/dist' '!**/*.ts' '!**/*.mts' '!**/*.cts' '!**/*.js' '!**/*.mjs' '!**/*.cjs'
+fi

scripts/mock

@@ -21,7 +21,7 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
   # Wait for server to come online
   echo -n "Waiting for server"
@@ -37,5 +37,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL"
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
 fi

scripts/test

@@ -43,7 +43,7 @@ elif ! prism_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the prism command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stoplight/prism-cli@~5.3.2 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
   echo
 
   exit 1

scripts/utils/upload-artifact.sh

@@ -12,9 +12,11 @@ if [[ "$SIGNED_URL" == "null" ]]; then
   exit 1
 fi
 
-UPLOAD_RESPONSE=$(tar -cz dist | curl -v -X PUT \
+TARBALL=$(cd dist && npm pack --silent)
+
+UPLOAD_RESPONSE=$(curl -v -X PUT \
   -H "Content-Type: application/gzip" \
-  --data-binary @- "$SIGNED_URL" 2>&1)
+  --data-binary "@dist/$TARBALL" "$SIGNED_URL" 2>&1)
 
 if echo "$UPLOAD_RESPONSE" | grep -q "HTTP/[0-9.]* 200"; then
   echo -e "\033[32mUploaded build to Stainless storage.\033[0m"

src/core.ts

@@ -299,10 +299,10 @@ export abstract class APIClient {
     return null;
   }
 
-  buildRequest<Req>(
+  async buildRequest<Req>(
     inputOptions: FinalRequestOptions<Req>,
     { retryCount = 0 }: { retryCount?: number } = {},
-  ): { req: RequestInit; url: string; timeout: number } {
+  ): Promise<{ req: RequestInit; url: string; timeout: number }> {
     const options = { ...inputOptions };
     const { method, path, query, defaultBaseURL, headers: headers = {} } = options;
 
@@ -450,7 +450,9 @@ export abstract class APIClient {
 
     await this.prepareOptions(options);
 
-    const { req, url, timeout } = this.buildRequest(options, { retryCount: maxRetries - retriesRemaining });
+    const { req, url, timeout } = await this.buildRequest(options, {
+      retryCount: maxRetries - retriesRemaining,
+    });
 
     await this.prepareRequest(req, { url, options });
 
@@ -1086,21 +1088,21 @@ export const coerceBoolean = (value: unknown): boolean => {
 };
 
 export const maybeCoerceInteger = (value: unknown): number | undefined => {
-  if (value === undefined) {
+  if (value == null) {
     return undefined;
   }
   return coerceInteger(value);
 };
 
 export const maybeCoerceFloat = (value: unknown): number | undefined => {
-  if (value === undefined) {
+  if (value == null) {
     return undefined;
   }
   return coerceFloat(value);
 };
 
 export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
-  if (value === undefined) {
+  if (value == null) {
     return undefined;
   }
   return coerceBoolean(value);

src/index.ts

@@ -216,6 +216,7 @@ ZeroEntropy.DocumentGetInfoListResponsesGetDocumentInfoListCursor =
   DocumentGetInfoListResponsesGetDocumentInfoListCursor;
 ZeroEntropy.Queries = Queries;
 ZeroEntropy.Models = Models;
+
 export declare namespace ZeroEntropy {
   export type RequestOptions = Core.RequestOptions;
 

src/resources/collections.ts

@@ -72,6 +72,15 @@ export interface CollectionAddParams {
    * exceed 1024 bytes.
    */
   collection_name: string;
+
+  /**
+   * [ADVANCED] The number of shards to use for this collection. By using K shards,
+   * your documents can index with K times more throughput. However, queries will be
+   * automatically sent to all K shards and then aggregated. For large collections,
+   * this can make queries faster. But for small collections, this will make queries
+   * slower. `num_shards` must be one of [1, 8, 16, 32, 64]. The default is 1.
+   */
+  num_shards?: number;
 }
 
 export interface CollectionGetListParams {}

src/resources/documents.ts

@@ -14,9 +14,9 @@ export class Documents extends APIResource {
    *   `index_status` of `indexed`. After this call, the document will have an
    *   `index_status` of `not_indexed`, since the document will need to reindex with
    *   the new metadata.
-   * - When updating with a non-null `index_status`, setting it to
-   *   `not_parsed or `not_indexed`requires that the document must have`index_status`of`parsing_failed`or`indexing_failed`,
-   *   respectively.
+   * - When updating with a non-null `index_status`, setting it to `not_parsed` or
+   *   `not_indexed` requires that the document must have `index_status` of
+   *   `parsing_failed` or `indexing_failed`, respectively.
    *
    * A `404 Not Found` status code will be returned, if the provided collection name
    * or document path does not exist.
@@ -373,9 +373,11 @@ export namespace DocumentAddParams {
     pages: Array<string>;
 
     /**
-     * This field must be `text-pages`
+     * This field must be `text-pages` or `text-pages-unordered`. When `unordered` is
+     * provided, it is assumed that consecutive pages aren't meant to be read one after
+     * another. For example, PDFs are ordered, and CSVs are unordered.
      */
-    type: 'text-pages';
+    type: 'text-pages' | 'text-pages-unordered';
   }
 
   export interface APIBinaryDocument {

src/resources/models.ts

@@ -10,8 +10,16 @@ export class Models extends APIResource {
    * The results will be sorted by descending order of relevance. For each document,
    * the index and the score will be returned. The index is relative to the documents
    * array that was passed in. The score is the query-document relevancy determined
-   * by the reranker model. The value will be returned in descending order to
+   * by the reranker model. The results will be returned in descending order of
    * relevance.
+   *
+   * Organizations will, by default, have a ratelimit of `2,500,000`
+   * bytes-per-minute. If this is exceeded, requests will be throttled into
+   * `latency: "slow"` mode, up to `10,000,000` bytes-per-minute. If even this is
+   * exceeded, you will get a `429` error. To request higher ratelimits, please
+   * contact [founders@zeroentropy.dev](mailto:founders@zeroentropy.dev) or message
+   * us on [Discord](https://go.zeroentropy.dev/discord) or
+   * [Slack](https://go.zeroentropy.dev/slack)!
    */
   rerank(body: ModelRerankParams, options?: Core.RequestOptions): Core.APIPromise<ModelRerankResponse> {
     return this._client.post('/models/rerank', { body, ...options });
@@ -36,8 +44,8 @@ export namespace ModelRerankResponse {
     /**
      * The relevance score between this document and the query. This number will range
      * between 0.0 and 1.0. This score is dependent on only the query and the scored
-     * document; other documents do not affect this score. This value is deterministic,
-     * but may vary slightly due to floating point error.
+     * document; other documents do not affect this score. This value is intended to be
+     * deterministic, but it may vary slightly due to floating point error.
      */
     relevance_score: number;
   }
@@ -50,19 +58,29 @@ export interface ModelRerankParams {
   documents: Array<string>;
 
   /**
-   * The query to rerank the documents by. Results will be in descending order of
-   * relevance.
+   * The model ID to use for reranking. Options are: ["zerank-2", "zerank-1",
+   * "zerank-1-small"]
+   */
+  model: string;
+
+  /**
+   * The query to rerank the documents by.
    */
   query: string;
 
   /**
-   * The model ID to use for reranking. Options are: ["zerank-1-large"]
+   * Whether the call will be inferenced "fast" or "slow". RateLimits for slow API
+   * calls are orders of magnitude higher, but you can expect >10 second latency.
+   * Fast inferences are guaranteed subsecond, but rate limits are lower. If not
+   * specified, first a "fast" call will be attempted, but if you have exceeded your
+   * fast rate limit, then a slow call will be executed. If explicitly set to "fast",
+   * then 429 will be returned if it cannot be executed fast.
    */
-  model?: string;
+  latency?: 'fast' | 'slow' | null;
 
   /**
    * If provided, then only the top `n` documents will be returned in the results
-   * array.
+   * array. Otherwise, `n` will be the length of the provided documents array.
    */
   top_n?: number | null;
 }

src/resources/queries.ts

@@ -215,8 +215,11 @@ export interface QueryTopDocumentsParams {
 
   /**
    * The natural language query to search with. This cannot exceed 4096 UTF-8 bytes.
+   * If `null`, then the sort will be undefined. The purpose of `null` is to do
+   * faster metadata filter searches without care for relevancy. Cost per query is
+   * unchanged.
    */
-  query: string;
+  query: string | null;
 
   /**
    * The query filter to apply. Please read [Metadata Filtering](/metadata-filtering)

src/resources/status.ts

@@ -46,6 +46,12 @@ export interface StatusGetStatusResponse {
    */
   num_failed_documents: number;
 
+  /**
+   * The total number of bytes used by documents that are currently indexed. Measured
+   * as UTF-8 bytes. For PDF/DOCX/PPT/etc, this is of the OCR'ed text.
+   */
+  num_indexed_bytes: number;
+
   /**
    * The number of documents that are currently indexed.
    */

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.6'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.7'; // x-release-please-version

tests/api-resources/collections.test.ts

@@ -36,7 +36,7 @@ describe('resource collections', () => {
   });
 
   test('add: required and optional params', async () => {
-    const response = await client.collections.add({ collection_name: 'collection_name' });
+    const response = await client.collections.add({ collection_name: 'collection_name', num_shards: 0 });
   });
 
   test('getList', async () => {