diff --git a/.github/workflows/deploy-fdr-dev.yml b/.github/workflows/deploy-fdr-dev.yml index 596c07f29e..f09fb24f0d 100644 --- a/.github/workflows/deploy-fdr-dev.yml +++ b/.github/workflows/deploy-fdr-dev.yml @@ -52,15 +52,9 @@ jobs: # which makes steps.has-changed.outputs.RESULT = 'true' run: npx turbo-ignore ${{ env.PACKAGE_NAME }} || echo "RESULT=true" >> $GITHUB_OUTPUT - - name: 🪴 Generate Fern SDKs - run: | - pnpm fern generate --local --api fdr --group local --log-level debug - env: - FERN_TOKEN: ${{ secrets.FERN_TOKEN }} - - name: 🧪 Build and test env: - SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }} + SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }} run: | pnpm turbo codegen build test --filter=${{ env.PACKAGE_NAME }} pnpm --filter "@fern-platform/fdr" sentry:sourcemaps diff --git a/.github/workflows/deploy-fdr-prod.yml b/.github/workflows/deploy-fdr-prod.yml index 7b202502bd..02e65c5605 100644 --- a/.github/workflows/deploy-fdr-prod.yml +++ b/.github/workflows/deploy-fdr-prod.yml @@ -41,12 +41,6 @@ jobs: - name: 📥 Install uses: ./.github/actions/install - - name: 🪴 Generate Code - run: | - pnpm fern generate --local --api fdr --group local --log-level debug - env: - FERN_TOKEN: ${{ secrets.FERN_TOKEN }} - - name: 🧪 Build and test run: pnpm turbo build test --filter=${{ env.PACKAGE_NAME }} @@ -97,4 +91,4 @@ jobs: healthchecks: needs: deploy_prod uses: ./.github/workflows/healthcheck.yml - secrets: inherit \ No newline at end of file + secrets: inherit diff --git a/.github/workflows/deploy-local-preview-bundle-dryrun.yml b/.github/workflows/deploy-local-preview-bundle-dryrun.yml index 51f23b4256..9f07bd99c3 100644 --- a/.github/workflows/deploy-local-preview-bundle-dryrun.yml +++ b/.github/workflows/deploy-local-preview-bundle-dryrun.yml @@ -26,7 +26,9 @@ jobs: - name: Install uses: ./.github/actions/install - name: Build local preview bundle - run: pnpm turbo --filter=@fern-ui/local-preview-bundle build + run: | + pnpm compile + pnpm --filter=@fern-ui/local-preview-bundle build - name: Synthesize local preview bundle run: pnpm --filter=@fern-ui/cdk run synth:dev2 @@ -44,6 +46,8 @@ jobs: - name: Install uses: ./.github/actions/install - name: Build local preview bundle - run: pnpm turbo --filter=@fern-ui/local-preview-bundle build + run: | + pnpm compile + pnpm --filter=@fern-ui/local-preview-bundle build - name: Synthesize local preview bundle run: pnpm --filter=@fern-ui/cdk run synth:prod diff --git a/.github/workflows/deploy-local-preview-bundle.yml b/.github/workflows/deploy-local-preview-bundle.yml index a64a76b2bb..9200682e6c 100644 --- a/.github/workflows/deploy-local-preview-bundle.yml +++ b/.github/workflows/deploy-local-preview-bundle.yml @@ -28,7 +28,9 @@ jobs: - name: Install uses: ./.github/actions/install - name: Build local preview bundle - run: ENABLE_SOURCE_MAPS=true pnpm turbo --filter=@fern-ui/local-preview-bundle build + run: | + pnpm compile + ENABLE_SOURCE_MAPS=true pnpm --filter=@fern-ui/local-preview-bundle build - name: Deploy local preview bundle run: pnpm --filter=@fern-ui/cdk run deploy:dev2 @@ -47,6 +49,8 @@ jobs: - name: Install uses: ./.github/actions/install - name: Build local preview bundle - run: pnpm turbo --filter=@fern-ui/local-preview-bundle build + run: | + pnpm compile + pnpm --filter=@fern-ui/local-preview-bundle build - name: Deploy local preview bundle run: pnpm --filter=@fern-ui/cdk run deploy:prod diff --git a/.github/workflows/fdr-ete.yml b/.github/workflows/fdr-ete.yml index c86c19c5d2..4f1534df01 100644 --- a/.github/workflows/fdr-ete.yml +++ b/.github/workflows/fdr-ete.yml @@ -32,6 +32,4 @@ jobs: # TODO: re-enable when moving to turbo # pnpm turbo --filter= docker:local run: | - cd servers/fdr - pnpm run docker:local - pnpm run test:ete + pnpm --filter=@fern-platform/fdr docker:local test:ete diff --git a/.github/workflows/playwright.yml b/.github/workflows/playwright.yml index a71cb5927d..0aece47314 100644 --- a/.github/workflows/playwright.yml +++ b/.github/workflows/playwright.yml @@ -11,25 +11,25 @@ env: WORKOS_CLIENT_ID: ${{ secrets.WORKOS_CLIENT_ID }} # HUME_API_KEY: ${{ secrets.HUME_API_KEY }} -jobs: - test: - timeout-minutes: 60 - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 +jobs: {} + # test: + # timeout-minutes: 60 + # runs-on: ubuntu-latest + # steps: + # - uses: actions/checkout@v4 - - name: Install - uses: ./.github/actions/install + # - name: Install + # uses: ./.github/actions/install - - name: Install Playwright Browsers - run: pnpm exec playwright install --with-deps + # - name: Install Playwright Browsers + # run: pnpm exec playwright install --with-deps - - name: Run Playwright tests - run: pnpm exec playwright test --debug + # - name: Run Playwright tests + # run: pnpm exec playwright test --debug - - uses: actions/upload-artifact@v4 - if: always() - with: - name: playwright-report - path: playwright-report/ - retention-days: 30 + # - uses: actions/upload-artifact@v4 + # if: always() + # with: + # name: playwright-report + # path: playwright-report/ + # retention-days: 30 diff --git a/clis/docs-migrator/package.json b/clis/docs-migrator/package.json index 380ea0a1d6..bb16358155 100644 --- a/clis/docs-migrator/package.json +++ b/clis/docs-migrator/package.json @@ -13,7 +13,7 @@ "scripts": { "clean": "rm -rf ./dist && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "format": "prettier --write --ignore-unknown --ignore-path ../../shared/.prettierignore \"**\"", "format:check": "prettier --check --ignore-unknown --ignore-path ../../shared/.prettierignore \"**\"", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../.eslintignore", diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/README.md b/clis/docs-migrator/src/__test__/outputs/bland/fern/README.md index 994a55db0b..6076636c92 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/README.md +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/README.md @@ -24,18 +24,9 @@ mintlify dev ### 😎 Publishing Changes -Install our Github App to autopropagate changes from youre repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard. +Install our Github App to autopropagate changes from youre repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard. #### Troubleshooting - Mintlify dev isn't running - Run `mintlify install` it'll re-install dependencies. - Page loads as a 404 - Make sure you are running in a folder with `mint.json` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/_snippets/snippet-example.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/_snippets/snippet-example.mdx index 476082d3dc..7ab902fc16 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/_snippets/snippet-example.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/_snippets/snippet-example.mdx @@ -5,12 +5,3 @@ slug: _snippets/snippet-example ## My Snippet This is an example of a reusable snippet - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch.mdx index a3c92dd406..d3c8e4e54e 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch.mdx @@ -16,10 +16,12 @@ slug: api-reference/batch-endpoint/batch This is the prompt or task used for all the phone calls in the request. Information can be inserted into it surrounding variable names with \{\{curly braces\}\}. - Example: - ```json - "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}." - ``` +Example: + +```json +"You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}." +``` + @@ -27,10 +29,11 @@ slug: api-reference/batch-endpoint/batch Each call in call_data *must* have a `phone_number` property. Properties are case-sensitive. - Example: +Example: + ```json [ - { + { "phone_number": "1234567890", "business": "ABC co.", "service": "Netflix", @@ -44,24 +47,29 @@ slug: api-reference/batch-endpoint/batch } ] ``` + - Adds a user-friendly label to your batch to keep track of it's original intention. This can help differentiate multiple call batches that are part of the same Campaign. Shown when a batch is retreived. + Adds a user-friendly label to your batch to keep track of it's original intention. This can help differentiate + multiple call batches that are part of the same Campaign. Shown when a batch is retreived. - Use ```campaign_id``` to organize related batches together. This can be set manually or auto-generated through Campaigns. + Use ```campaign_id``` to organize related batches together. This can be set manually or auto-generated through + Campaigns. When this is set to ```true```, only the first call of ```call_data``` will be dispatched. A common use case is to set the first ```phone_number``` value to your own to confirm everything's set up properly. - Includes additional information in the response when true so that it's easier to find any issues. +Includes additional information in the response when true so that it's easier to find any issues. + - All other parameters supported by the [Send Call](../../api-v1/post/calls.mdx) endpoint are supported here as well. They will be applied to each call in the batch. + All other parameters supported by the [Send Call](../../api-v1/post/calls.mdx) endpoint are supported here as well. They will + be applied to each call in the batch. ### Response @@ -78,18 +86,9 @@ slug: api-reference/batch-endpoint/batch ```json Response { - "message": "success", - "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch" + "message": "success", + "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch" } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_get.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_get.mdx index 32181d421a..66bca0489b 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_get.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_get.mdx @@ -36,8 +36,7 @@ slug: api-reference/batch-endpoint/batch_get - The unique identifier of the batch - used as the `batch_id` parameter in other - API calls. + The unique identifier of the batch - used as the `batch_id` parameter in other API calls. @@ -60,7 +59,6 @@ slug: api-reference/batch-endpoint/batch_get An object containing parameters for the calls in the batch. - An object containing analysis data for the batch. @@ -80,24 +78,26 @@ slug: api-reference/batch-endpoint/batch_get An object containing the number of calls in each queue status. - Example: - ```json - { - "complete": 237, - "queued": 2, - "call_error": 1 - } - ``` +Example: + +```json +{ + "complete": 237, + "queued": 2, + "call_error": 1 +} +``` + Contains `average`, `average_nonzero`, `summary` and `all` fields. - - `average`: The average call length in seconds. - - `average_nonzero`: The average call length in seconds, excluding calls with a length of less than a second. - - `summary`: A summary of the call lengths, grouped into ranges. - - `all`: Contains each call length, in case you want to use a different grouping than the default. - +- `average`: The average call length in seconds. +- `average_nonzero`: The average call length in seconds, excluding calls with a length of less than a second. +- `summary`: A summary of the call lengths, grouped into ranges. +- `all`: Contains each call length, in case you want to use a different grouping than the default. + Contains each `call_id` in the batch. @@ -106,15 +106,17 @@ slug: api-reference/batch-endpoint/batch_get Contains any error messages that calls in the batch may have. - Example: - ```json - [ - { - "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", - "error_message": "Cannot transfer to +12223334444 - Call is no longer active" - } - ] - ``` +Example: + +```json +[ + { + "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", + "error_message": "Cannot transfer to +12223334444 - Call is no longer active" + } +] +``` + @@ -169,107 +171,97 @@ slug: api-reference/batch-endpoint/batch_get } }, "analysis": { - "total_calls": 88, - "completed_calls": 86, - "in_progress_calls": 2, - "queue_statuses": { - "complete": 85, - "started": 2, - "call_error": 1 + "total_calls": 88, + "completed_calls": 86, + "in_progress_calls": 2, + "queue_statuses": { + "complete": 85, + "started": 2, + "call_error": 1 + }, + "call_lengths": { + "average": 17, + "average_nonzero": 31, + "summary": { + "0-5": 18, + "5-10": 4, + "10-15": 3, + "15-20": 2, + "20-30": 14, + "30-45": 28, + "45-60": 11, + "60-90": 6, + "90-120": 1, + "120+": 1 }, - "call_lengths": { - "average": 17, - "average_nonzero": 31, - "summary": { - "0-5": 18, - "5-10": 4, - "10-15": 3, - "15-20": 2, - "20-30": 14, - "30-45": 28, - "45-60": 11, - "60-90": 6, - "90-120": 1, - "120+": 1 - }, - "all": [ - 7, - 32, - //... - ] + "all": [ + 7, 32 + //... + ] + }, + "call_ids": [ + "ffa99be3-63dd-44dc-9523-380cd25c1b9e", + "591338a8-34b2-41e6-93da-b9029c9bdedc" + //... + ], + "error_messages": [ + { + "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", + "error_message": "Cannot transfer to +12223334444 - Call is no longer active" + } + ], + "endpoints": { + "api.bland.ai": 88 + } + }, + "call_data": [ + { + "status": "completed", + "corrected_duration": "12", + "end_at": "2023-12-16T00:17:38.000Z", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e", + "to": "1112223333", + "from": "+17473423273", + "completed": true, + "created_at": "2023-12-16T00:17:22.383682+00:00", + "queue_status": "complete", + "endpoint_url": "api.bland.ai", + "max_duration": 30, + "error_message": null, + "request_data": { + "phone_number": "1112223333", + "reduce_latency": true, + "wait": false, + "language": "ENG" }, - "call_ids": [ - "ffa99be3-63dd-44dc-9523-380cd25c1b9e", - "591338a8-34b2-41e6-93da-b9029c9bdedc", - //... - ], - "error_messages": [ + "transcripts": [ + { + "id": 1188954, + "created_at": "2023-12-16T00:17:30.46833+00:00", + "text": " Hi, Im calling about the laundromat for sale. —  ", + "user": "assistant", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" + }, { - "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", - "error_message": "Cannot transfer to +12223334444 - Call is no longer active" + "id": 1188957, + "created_at": "2023-12-16T00:17:35.14056+00:00", + "text": "I'll get back to you as soon as you can. Just leave a message. Thank you. Bye.", + "user": "user", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" + }, + { + "id": 1188959, + "created_at": "2023-12-16T00:17:36.710551+00:00", + "text": "Ended call: Goodbye", + "user": "agent-action", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" } ], - "endpoints": { - "api.bland.ai": 88 - } - }, - "call_data": [ - { - "status": "completed", - "corrected_duration": "12", - "end_at": "2023-12-16T00:17:38.000Z", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e", - "to": "1112223333", - "from": "+17473423273", - "completed": true, - "created_at": "2023-12-16T00:17:22.383682+00:00", - "queue_status": "complete", - "endpoint_url": "api.bland.ai", - "max_duration": 30, - "error_message": null, - "request_data": { - "phone_number": "1112223333", - "reduce_latency": true, - "wait": false, - "language": "ENG" - }, - "transcripts": [ - { - "id": 1188954, - "created_at": "2023-12-16T00:17:30.46833+00:00", - "text": " Hi, Im calling about the laundromat for sale. —  ", - "user": "assistant", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" - }, - { - "id": 1188957, - "created_at": "2023-12-16T00:17:35.14056+00:00", - "text": "I'll get back to you as soon as you can. Just leave a message. Thank you. Bye.", - "user": "user", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" - }, - { - "id": 1188959, - "created_at": "2023-12-16T00:17:36.710551+00:00", - "text": "Ended call: Goodbye", - "user": "agent-action", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" - } - ], - "call_length": 6.242 - }, + "call_length": 6.242 + } //... ] } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_stop.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_stop.mdx index 97ef945e46..142e7cc5c6 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_stop.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batch_stop.mdx @@ -20,8 +20,8 @@ slug: api-reference/batch-endpoint/batch_stop ### Response - The status of the request. If anything other than 'success', an error has - occurred or all calls have already been completed. + The status of the request. If anything other than 'success', an error has occurred or all calls have already been + completed. @@ -48,12 +48,3 @@ slug: api-reference/batch-endpoint/batch_stop ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batches_get.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batches_get.mdx index fadc6f25d8..e537d84f36 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batches_get.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/batches_get.mdx @@ -26,8 +26,8 @@ slug: api-reference/batch-endpoint/batches_get - The original base prompt used to create the batch. Will still contain the - original placeholder variables such as `{{ business }}` or `{{ name }}`. + The original base prompt used to create the batch. Will still contain the original placeholder variables such as ` + {{ business }}` or `{{ name }}`. @@ -35,13 +35,12 @@ slug: api-reference/batch-endpoint/batches_get - Enterprise customers with custom endpoints will see the endpoint code here if - specified. + Enterprise customers with custom endpoints will see the endpoint code here if specified. - The base call parameters used to create the batch, such as `voice_id`, - `max_duration`, `reduce_latency`, and `wait_for_greeting`. + The base call parameters used to create the batch, such as `voice_id`, `max_duration`, `reduce_latency`, and + `wait_for_greeting`. @@ -77,12 +76,3 @@ slug: api-reference/batch-endpoint/batches_get } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/end_batches.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/end_batches.mdx index 806774404a..17b24fea57 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/end_batches.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/batch-endpoint/end_batches.mdx @@ -14,8 +14,8 @@ slug: api-reference/batch-endpoint/end_batches ### Response - The status of the request. If anything other than 'success', an error has - occurred or all calls have already been completed. + The status of the request. If anything other than 'success', an error has occurred or all calls have already been + completed. @@ -46,12 +46,3 @@ slug: api-reference/batch-endpoint/end_batches ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/call.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/call.mdx index 7e7acbe6da..3a4cf5b5b8 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/call.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/call.mdx @@ -15,51 +15,56 @@ slug: api-reference/endpoint/call The phone number to call. Country code required for non-US numbers. - Example: `+12223334444`, `+44770090000`, `+61491550156`. +Example: `+12223334444`, `+44770090000`, `+61491550156`. + A phone number that the agent can transfer to under specific conditions, such as when the caller/callee asks to speak to a human. - For best results, specify the exact conditions to transfer under in the `task` parameter. Refer to the action as "transfer", any other phrasing such as "swap" or "switch" can cause unexpected behavior. +For best results, specify the exact conditions to transfer under in the `task` parameter. Refer to the action as "transfer", any other phrasing such as "swap" or "switch" can cause unexpected behavior. + +Example: `+12223334444`, `+44770090000`, `+61491550156`. - Example: `+12223334444`, `+44770090000`, `+61491550156`. Specify a purchased Outbound Number to call from. Country code is required, spaces or parentheses must be excluded. - By default, calls are initiated from a separate pool of numbers owned by Bland. +By default, calls are initiated from a separate pool of numbers owned by Bland. + Define how the AI should behave. Provide instructions, relevant information, and examples of the ideal conversation flow. - Note: Concise prompts lead to higher performance and adherence to instructions. Overly verbose prompts 'dilute' the context if filled with unnecessary/irrelevant details. +Note: Concise prompts lead to higher performance and adherence to instructions. Overly verbose prompts 'dilute' the context if filled with unnecessary/irrelevant details. + - Reducing latency means that the agent will generate responses more quickly and have less of a delay. This must be set to ```true``` when using Voice Clones. + Reducing latency means that the agent will generate responses more quickly and have less of a delay. This must be set + to ```true``` when using Voice Clones. When reduce latency is set to `true` (default): - - 0: American male - - 1: Australian female - - 2: American female +- 0: American male +- 1: Australian female +- 2: American female - When reduce latency is set to `false`: - - 0: American female (southern accent) - - 1: American male - - 2: British female - - 3: Indian male - +When reduce latency is set to `false`: + +- 0: American female (southern accent) +- 1: American male +- 2: British female +- 3: Indian male + - The webhook should be a http / https callback url. We will send the call_id - and transcript to this URL after the call completes. This can be useful if you - want to have real time notifications when calls finish. + The webhook should be a http / https callback url. We will send the call_id and transcript to this URL after the call + completes. This can be useful if you want to have real time notifications when calls finish. @@ -73,11 +78,13 @@ slug: api-reference/endpoint/call - A phrase that your call will start with instead of a generating one on the fly. This works both with and without `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. + A phrase that your call will start with instead of a generating one on the fly. This works both with and without + `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. - To record your phone call, set `record` to true. When your call completes, you can access the recording by requesting the `/call/recording` endpoint. + To record your phone call, set `record` to true. When your call completes, you can access the recording by requesting + the `/call/recording` endpoint. @@ -85,18 +92,20 @@ slug: api-reference/endpoint/call Note: This is an experimental parameter and may behave unexpectedly. - Adjust the predictability and consistency of the AI agent's voice. Lower values allow larger deviations from the baseline voice, whether default or cloned. Setting this too high however can cause a monotone voice. +Adjust the predictability and consistency of the AI agent's voice. Lower values allow larger deviations from the baseline voice, whether default or cloned. Setting this too high however can cause a monotone voice. + +Accepts decimal values between `0` and `1` (inclusive). - Accepts decimal values between `0` and `1` (inclusive). Note: This is an experimental parameter and may behave unexpectedly. - Higher values will make speech differences between the selected voice and others more prominent. Extremely high values can cause voice distortion. +Higher values will make speech differences between the selected voice and others more prominent. Extremely high values can cause voice distortion. + +Use lower values to lower the distinctiveness of the voice or eliminate unwanted audio static spikes. - Use lower values to lower the distinctiveness of the voice or eliminate unwanted audio static spikes. +Accepts decimal values between `0` and `1` (inclusive). - Accepts decimal values between `0` and `1` (inclusive). @@ -104,23 +113,19 @@ slug: api-reference/endpoint/call Note #2: Setting `reduce_latency` to `false` will cause this parameter to be ignored. - How fast your agent talks! This parameter is simply a speech-speed multiplier, and works with fractional values such as `0.5` or large ones like `2`. +How fast your agent talks! This parameter is simply a speech-speed multiplier, and works with fractional values such as `0.5` or large ones like `2`. + +Accepts decimal values between `0.1` and `5` (inclusive). - Accepts decimal values between `0.1` and `5` (inclusive). - Select a supported language of your choice. - Optimizes every part of our API for that language - transcription, speech, and other inner workings. - - Supported Languages and their codes: - - English: ```eng``` - - Spanish: ```esp``` - - French: ```fre``` - - Polish: ```pol``` + Select a supported language of your choice. Optimizes every part of our API for that language - transcription, speech, + and other inner workings. Supported Languages and their codes: - English: ```eng``` - Spanish: ```esp``` - French: + ```fre``` - Polish: ```pol``` @@ -157,49 +162,51 @@ slug: api-reference/endpoint/call - AMD mode helps our AI navigate phone trees and IVR systems. If you know your call will hit an automated system you should switch it on. - - NOTE: AMD mode causes increased delay for the first response, even if answered by a human. Highly recommended to set to `false` in the majority of cases. + AMD mode helps our AI navigate phone trees and IVR systems. If you know your call will hit an automated system you + should switch it on. NOTE: AMD mode causes increased delay for the first response, even if answered by a human. Highly + recommended to set to `false` in the majority of cases. When you want your AI to "know" a specific fact - like the caller's name or other relevant context. - The AI agent will be aware of both the key names as well as their corresponding values. +The AI agent will be aware of both the key names as well as their corresponding values. + A set of external API requests to fetch at the start of the call or repeatedly. - Each request object should contain: +Each request object should contain: - `url`: The URL of the external API to fetch data from. +`url`: The URL of the external API to fetch data from. - `response_data`: An array of objects describing how to parse and use the data fetched from the API. Explained in more detail below. +`response_data`: An array of objects describing how to parse and use the data fetched from the API. Explained in more detail below. - The following are optional: +The following are optional: - `method`: Allows `GET` or `POST`. Default: `GET` +`method`: Allows `GET` or `POST`. Default: `GET` - `cache`: Whether to fetch the data once at the beginning of the call, or to re-check continuously for data that might change mid-call. Default: `true` +`cache`: Whether to fetch the data once at the beginning of the call, or to re-check continuously for data that might change mid-call. Default: `true` - `headers`: An object of headers to send with the request. +`headers`: An object of headers to send with the request. - `body`: The body of the request. - - The following variables can be injected into the dynamic request body: - - - `{{from}}` (Ex. `+12223334444`) - - `{{to}}` - - `{{short_from}}` (Ex. `2223334444`) - - `{{short_to}}` - - `{{call_id}}` - - These string values will be replaced in each `dynamic_data[].body` where they're used by system values in each request. +`body`: The body of the request. + +The following variables can be injected into the dynamic request body: + +- `{{from}}` (Ex. `+12223334444`) +- `{{to}}` +- `{{short_from}}` (Ex. `2223334444`) +- `{{short_to}}` +- `{{call_id}}` + +These string values will be replaced in each `dynamic_data[].body` where they're used by system values in each request. + +Try out with this example: - Try out with this example: ```json "dynamic_data": [ { @@ -219,24 +226,27 @@ slug: api-reference/endpoint/call } ] ``` + An array of objects describing how to parse and use the data fetched from the API. Each object in this array should contain: -- `name`: A label for the fetched data. + +- `name`: A label for the fetched data. - Example: `"Flight Status"` -- `data`: The JSON path in the API response to extract the data from. +- `data`: The JSON path in the API response to extract the data from. - Example: `"user.flights[0].status"` -- `context`: How this data should be incorporated into the AI's knowledge. +- `context`: How this data should be incorporated into the AI's knowledge. - Example: `"John's flight is currently {{Flight Status}}"` - - + + When you increase the interruption latency, you force the AI phone agent to listen longer before responding. In practice, increasing the threshold results in less interruptions and more latency. - Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted much less frequently. +Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted much less frequently. + ### Response @@ -259,12 +269,3 @@ Each object in this array should contain: ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/dynamic_validate.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/dynamic_validate.mdx index eae350cedb..4e64e57e69 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/dynamic_validate.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/dynamic_validate.mdx @@ -17,7 +17,8 @@ slug: api-reference/endpoint/dynamic_validate ### Body - An array of objects, each specifying an external API to fetch data from. These objects must include the API endpoint, the HTTP method, a cache flag, and details on parsing and integrating the response. + An array of objects, each specifying an external API to fetch data from. These objects must include the API endpoint, + the HTTP method, a cache flag, and details on parsing and integrating the response. ### Response @@ -31,7 +32,8 @@ slug: api-reference/endpoint/dynamic_validate - Contains the results from the dynamic data fetch. Each object in this array shows the cache status, the name of the data, and the processed prompt with the inserted data. + Contains the results from the dynamic data fetch. Each object in this array shows the cache status, the name of the + data, and the processed prompt with the inserted data. @@ -39,7 +41,8 @@ slug: api-reference/endpoint/dynamic_validate - The parsed data from fetching the dynamic data. This can be used in other requests, the `task` or `prompt` fields, even other dynamic data requests through the `{{variable}}` syntax. + The parsed data from fetching the dynamic data. This can be used in other requests, the `task` or `prompt` fields, + even other dynamic data requests through the `{{ variable }}` syntax. @@ -150,11 +153,3 @@ slug: api-reference/endpoint/dynamic_validate } ``` - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/end.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/end.mdx index d35aa2b699..74d8f9da97 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/end.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/end.mdx @@ -23,9 +23,8 @@ slug: api-reference/endpoint/end - If the status is `success`, the message will say "Call ended successfully." - Otherwise if the status is `error`, the message will say "SID not found for - the given c_id." or "Internal server error." + If the status is `success`, the message will say "Call ended successfully." Otherwise if the status is `error`, the + message will say "SID not found for the given c_id." or "Internal server error." @@ -38,12 +37,3 @@ slug: api-reference/endpoint/end ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/hold.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/hold.mdx index 08e91196bd..66191da697 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/hold.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/hold.mdx @@ -16,22 +16,19 @@ slug: api-reference/endpoint/hold ### Body - This is the phone number of the person or company you want to call. - - International numbers: must include the country code and may not include - additional formatting (like parentheses and dashes). E.g. '+447700900077'. - - U.S. numbers: may include formatting, but we recommend stripping all - additional characters. + This is the phone number of the person or company you want to call. - International numbers: must include the country + code and may not include additional formatting (like parentheses and dashes). E.g. '+447700900077'. - U.S. numbers: + may include formatting, but we recommend stripping all additional characters. - Once the AI detects a human has answered the call, it will call this number. - Must follow the same formatting as `phone_number` + Once the AI detects a human has answered the call, it will call this number. Must follow the same formatting as + `phone_number` - By default, the AI will wait on hold, then call you when a human answers. If - you want the AI to first ask the other human a few questions, or want to give - it special rules about when to patch you into the phone call, provide those + By default, the AI will wait on hold, then call you when a human answers. If you want the AI to first ask the other + human a few questions, or want to give it special rules about when to patch you into the phone call, provide those instructions here. @@ -55,12 +52,3 @@ slug: api-reference/endpoint/hold ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/inbound_prompt.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/inbound_prompt.mdx index 5cc7112a39..786961227d 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/inbound_prompt.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/inbound_prompt.mdx @@ -14,20 +14,18 @@ slug: api-reference/endpoint/inbound_prompt ### Body - The phone number associated with the prompt. - Format: "+XXXXXXXXXX" or - "+XXX-XXX-XXXX". Make sure to include the exact phone number (area code and "+" included). Otherwise the update will fail. + The phone number associated with the prompt. - Format: "+XXXXXXXXXX" or "+XXX-XXX-XXXX". Make sure to include the + exact phone number (area code and "+" included). Otherwise the update will fail. - The new prompt for the given phone number. The prompt shouldn't exceed 5000 - characters. Note: Ensure the prompt is clear and relevant to your use case. + The new prompt for the given phone number. The prompt shouldn't exceed 5000 characters. Note: Ensure the prompt is + clear and relevant to your use case. - Set a custom voice for your agent. Matches the voices in the /call endpoint. - - 0: British Female (default) - - 1: Australian Female - - 2: American Male + Set a custom voice for your agent. Matches the voices in the /call endpoint. - 0: British Female (default) - 1: + Australian Female - 2: American Male ### Response @@ -37,8 +35,7 @@ slug: api-reference/endpoint/inbound_prompt - The creation timestamp of the inbound record. - Example: - "2023-10-10T12:00:00Z" + The creation timestamp of the inbound record. - Example: "2023-10-10T12:00:00Z" @@ -66,12 +63,3 @@ slug: api-reference/endpoint/inbound_prompt ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/logs.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/logs.mdx index ac31309883..d68a506532 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/logs.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/logs.mdx @@ -22,14 +22,8 @@ slug: api-reference/endpoint/logs ### Response - An array of phrases spoken during the call. - - Each index includes: - - - `id` - - `created_at` - - `text` - - `user` (can be `user`, `assistant`, `robot`, or `agent-action`) + An array of phrases spoken during the call. Each index includes: - `id` - `created_at` - `text` - `user` (can be + `user`, `assistant`, `robot`, or `agent-action`) @@ -49,28 +43,30 @@ slug: api-reference/endpoint/logs - Whether the call has been completed. If it differs from the value of 'queue_status', this will be the most up-to-date status. + Whether the call has been completed. If it differs from the value of 'queue_status', this will be the most up-to-date + status. The status of the call. During extremely high volume periods, calls may be queued for a short period of time before being dispatched. - Progresses through the following stages: +Progresses through the following stages: - - `new`: An API request has been received. - - `queued`: Call pararameters have been validated and authentication succeeded. - - `allocated`: Extremely brief, the call is being dispatched. - - `started`: The phone call is live and in progress. - - `complete`: The phone call has ended successfully. - - The following statuses show the point that was reached before an error: +- `new`: An API request has been received. +- `queued`: Call pararameters have been validated and authentication succeeded. +- `allocated`: Extremely brief, the call is being dispatched. +- `started`: The phone call is live and in progress. +- `complete`: The phone call has ended successfully. - - `pre_queue_error`: An error occurred before the call was queued. Invalid parameters generally cause this. - - `queue_error`: Error occurred while the call was queued. Ex. Valid phone number but to an unserviced area. - - `call_error`: Error occurred during live call. May be caused by transferring to an invalid phone number or an unforeseen error. - - `complete_error`: Error occurred after the call was completed. Ex. A post-call webhook failed. +The following statuses show the point that was reached before an error: + +- `pre_queue_error`: An error occurred before the call was queued. Invalid parameters generally cause this. +- `queue_error`: Error occurred while the call was queued. Ex. Valid phone number but to an unserviced area. +- `call_error`: Error occurred during live call. May be caused by transferring to an invalid phone number or an unforeseen error. +- `complete_error`: Error occurred after the call was completed. Ex. A post-call webhook failed. + +If at any point an error occurs, it will be recorded in the `error_message` field. - If at any point an error occurs, it will be recorded in the `error_message` field. @@ -86,7 +82,8 @@ slug: api-reference/endpoint/logs - The total length of time the call was connected. This differs from call_length in that it includes ringing and connection time. + The total length of time the call was connected. This differs from call_length in that it includes ringing and + connection time. @@ -97,7 +94,6 @@ slug: api-reference/endpoint/logs The timestamp for when the call was dispatched. - # Polling example To track the status of a live phone call, you can use a 'polling' technique to repeatedly ping the logs endpoint. @@ -170,10 +166,10 @@ while True: "error_message": null, "endpoint_url": "api.bland.ai", "request_data": { - "phone_number": "1112223344", - "reduce_latency": false, - "wait": false, - "language": "ENG" + "phone_number": "1112223344", + "reduce_latency": false, + "wait": false, + "language": "ENG" }, "completed": true, "created_at": "2023-09-22T19:14:27.015663+00:00", @@ -219,12 +215,3 @@ while True: ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/purchase.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/purchase.mdx index 02112db3a4..e2ff379540 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/purchase.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/purchase.mdx @@ -15,24 +15,25 @@ slug: api-reference/endpoint/purchase ### Body - Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact match if available. + Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact + match if available. - This defines how the AI will start the conversation, information available to - it, and its behaviors. Matches how the outbound `task` parameter functions. + This defines how the AI will start the conversation, information available to it, and its behaviors. Matches how the + outbound `task` parameter functions. - The webhook should be a http / https callback url. We will send the call_id - and transcript to this URL after the call completes. This can be useful if you - want to have real time notifications when calls finish. + The webhook should be a http / https callback url. We will send the call_id and transcript to this URL after the call + completes. This can be useful if you want to have real time notifications when calls finish. Specify an exact phone number you'd like to use. If provided, will override the `area_code` parameter and does not fallback to any other number. - Example of the correct format (Note the `"+1"` is mandatory): `"+12223334444"` +Example of the correct format (Note the `"+1"` is mandatory): `"+12223334444"` + ### Response @@ -40,7 +41,8 @@ slug: api-reference/endpoint/purchase The created phone number, will be in the following format: `+1XXXXXXXXXX` - Example: `+18582814611` +Example: `+18582814611` + @@ -52,12 +54,3 @@ slug: api-reference/endpoint/purchase ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/recording.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/recording.mdx index 21f0588081..0731e311da 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/recording.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/endpoint/recording.mdx @@ -23,8 +23,8 @@ slug: api-reference/endpoint/recording - If the status is `success`, the `url` field will be present. - Otherwise if the status is `error`, the message will say "Error fetching recording" or "Internal server error". + If the status is `success`, the `url` field will be present. Otherwise if the status is `error`, the message will say + "Error fetching recording" or "Internal server error". @@ -48,12 +48,3 @@ slug: api-reference/endpoint/recording ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/hold-endpoint/hold.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/hold-endpoint/hold.mdx index a2a7658854..36243fdc12 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/hold-endpoint/hold.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-reference/hold-endpoint/hold.mdx @@ -16,22 +16,19 @@ slug: api-reference/hold-endpoint/hold ### Body - This is the phone number of the person or company you want to call. - - International numbers: must include the country code and may not include - additional formatting (like parentheses and dashes). E.g. '+447700900077'. - - U.S. numbers: may include formatting, but we recommend stripping all - additional characters. + This is the phone number of the person or company you want to call. - International numbers: must include the country + code and may not include additional formatting (like parentheses and dashes). E.g. '+447700900077'. - U.S. numbers: + may include formatting, but we recommend stripping all additional characters. - Once the AI detects a human has answered the call, it will call this number. - Must follow the same formatting as `phone_number` + Once the AI detects a human has answered the call, it will call this number. Must follow the same formatting as + `phone_number` - By default, the AI will wait on hold, then call you when a human answers. If - you want the AI to first ask the other human a few questions, or want to give - it special rules about when to patch you into the phone call, provide those + By default, the AI will wait on hold, then call you when a human answers. If you want the AI to first ask the other + human a few questions, or want to give it special rules about when to patch you into the phone call, provide those instructions here. @@ -55,12 +52,3 @@ slug: api-reference/hold-endpoint/hold ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/agents.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/agents.mdx index 6918a7b99c..3d96b4bd27 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/agents.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/agents.mdx @@ -14,20 +14,14 @@ slug: api-v1/get/agents ### Response - Each agent object, containing the following fields: - - `agent_id` (string): The unique identifier for the agent. - - `webhook` (string): The webhook URL for the agent. - - `dynamic_data` (array): An array of dynamic data objects. - - `interruption_threshold` (number): The threshold for agent interruption. - - `first_sentence` (string): The first sentence the agent will say. - - `model` (string): The model used by the agent. - - `voice_settings` (object): The voice settings for the agent. - - `voice` (string): The voice used by the agent. - - `prompt` (string): The prompt for the agent. - - `temperature` (number): The temperature setting for the agent. - - `max_duration` (number): The maximum call duration for the agent. - - `language` (string): The language used by the agent. - - `tools` (array): An array of Custom Tools the agent can use. + Each agent object, containing the following fields: - `agent_id` (string): The unique identifier for the agent. - + `webhook` (string): The webhook URL for the agent. - `dynamic_data` (array): An array of dynamic data objects. - + `interruption_threshold` (number): The threshold for agent interruption. - `first_sentence` (string): The first + sentence the agent will say. - `model` (string): The model used by the agent. - `voice_settings` (object): The voice + settings for the agent. - `voice` (string): The voice used by the agent. - `prompt` (string): The prompt for the + agent. - `temperature` (number): The temperature setting for the agent. - `max_duration` (number): The maximum call + duration for the agent. - `language` (string): The language used by the agent. - `tools` (array): An array of Custom + Tools the agent can use. @@ -55,3 +49,4 @@ slug: api-v1/get/agents ``` +``` diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id-analysis.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id-analysis.mdx index a419b56557..3bd3d5cccb 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id-analysis.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id-analysis.mdx @@ -30,14 +30,9 @@ slug: api-v1/get/batches-id-analysis - An array of analysis objects, each corresponding to a call within the batch. - - Each analysis object includes: - - `call_id`, - - `batch_id` - - `goal` - - `answers` - the results of the AI analysis - - `questions` - the original questions asked by the AI + An array of analysis objects, each corresponding to a call within the batch. Each analysis object includes: - + `call_id`, - `batch_id` - `goal` - `answers` - the results of the AI analysis - `questions` - the original questions + asked by the AI @@ -68,10 +63,3 @@ slug: api-v1/get/batches-id-analysis } ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id.mdx index f5e5d3e245..0e023511ec 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches-id.mdx @@ -61,7 +61,6 @@ slug: api-v1/get/batches-id An object containing parameters for the calls in the batch. - An object containing analysis data for the batch. @@ -81,24 +80,26 @@ slug: api-v1/get/batches-id An object containing the number of calls in each queue status. - Example: - ```json - { - "complete": 237, - "queued": 2, - "call_error": 1 - } - ``` +Example: + +```json +{ + "complete": 237, + "queued": 2, + "call_error": 1 +} +``` + Contains `average`, `average_nonzero`, `summary` and `all` fields. - - `average`: The average call length in minutes. - - `average_nonzero`: The average call length in minutes, excluding calls with a length of less than one second. - - `summary`: A summary of the call lengths, grouped into ranges. - - `all`: Contains each call length, in case you want to use a different grouping than the default. - +- `average`: The average call length in minutes. +- `average_nonzero`: The average call length in minutes, excluding calls with a length of less than one second. +- `summary`: A summary of the call lengths, grouped into ranges. +- `all`: Contains each call length, in case you want to use a different grouping than the default. + Contains each `call_id` in the batch. @@ -107,15 +108,17 @@ slug: api-v1/get/batches-id Contains any error messages that calls in the batch may have. - Example: - ```json - [ - { - "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", - "error_message": "Cannot transfer to +12223334444 - Call is no longer active" - } - ] - ``` +Example: + +```json +[ + { + "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", + "error_message": "Cannot transfer to +12223334444 - Call is no longer active" + } +] +``` + @@ -153,13 +156,14 @@ slug: api-v1/get/batches-id Contains a string value if the batch had `answered_by_enabled` set to true. - Values: - - `voicemail` - - `human` - - `unknown` - - `no-answer` - - `null` - +Values: + +- `voicemail` +- `human` +- `unknown` +- `no-answer` +- `null` + @@ -181,108 +185,98 @@ slug: api-v1/get/batches-id } }, "call_data": [ - { - "status": "completed", - "corrected_duration": "12", - "end_at": "2023-12-16T00:17:38.000Z", - "call_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e", - "to": "1112223333", - "from": "+17473423273", - "completed": true, - "created_at": "2023-12-16T00:17:22.383682+00:00", - "queue_status": "complete", - "endpoint_url": "api.bland.ai", - "max_duration": 30, - "error_message": null, - "answered_by": "voicemail", - "request_data": { - "phone_number": "1112223333", - "reduce_latency": true, - "wait": false, - "language": "ENG" - }, - "transcripts": [ - { - "id": 1188954, - "created_at": "2023-12-16T00:17:30.46833+00:00", - "text": " Hi, Im calling about the laundromat for sale. —  ", - "user": "assistant", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" - }, - { - "id": 1188957, - "created_at": "2023-12-16T00:17:35.14056+00:00", - "text": "I'll get back to you as soon as you can. Just leave a message. Thank you. Bye.", - "user": "user", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" - }, - { - "id": 1188959, - "created_at": "2023-12-16T00:17:36.710551+00:00", - "text": "Ended call: Goodbye", - "user": "agent-action", - "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" - } - ], - "call_length": 0.12345 - }, - //... - ], - "analysis": { - "total_calls": 88, - "completed_calls": 86, - "in_progress_calls": 2, - "queue_statuses": { - "complete": 85, - "started": 2, - "call_error": 1 - }, - "call_lengths": { - "average": 17, - "average_nonzero": 31, - "summary": { - "0-5": 18, - "5-10": 4, - "10-15": 3, - "15-20": 2, - "20-30": 14, - "30-45": 28, - "45-60": 11, - "60-90": 6, - "90-120": 1, - "120+": 1 - }, - "all": [ - 7, - 32, - //... - ] + { + "status": "completed", + "corrected_duration": "12", + "end_at": "2023-12-16T00:17:38.000Z", + "call_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e", + "to": "1112223333", + "from": "+17473423273", + "completed": true, + "created_at": "2023-12-16T00:17:22.383682+00:00", + "queue_status": "complete", + "endpoint_url": "api.bland.ai", + "max_duration": 30, + "error_message": null, + "answered_by": "voicemail", + "request_data": { + "phone_number": "1112223333", + "reduce_latency": true, + "wait": false, + "language": "ENG" }, - "call_ids": [ - "ffa99be3-63dd-44dc-9523-380cd25c1b9e", - "591338a8-34b2-41e6-93da-b9029c9bdedc", - //... - ], - "error_messages": [ + "transcripts": [ + { + "id": 1188954, + "created_at": "2023-12-16T00:17:30.46833+00:00", + "text": " Hi, Im calling about the laundromat for sale. —  ", + "user": "assistant", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" + }, + { + "id": 1188957, + "created_at": "2023-12-16T00:17:35.14056+00:00", + "text": "I'll get back to you as soon as you can. Just leave a message. Thank you. Bye.", + "user": "user", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" + }, { - "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", - "error_message": "Cannot transfer to +12223334444 - Call is no longer active" + "id": 1188959, + "created_at": "2023-12-16T00:17:36.710551+00:00", + "text": "Ended call: Goodbye", + "user": "agent-action", + "c_id": "ffa99be3-63dd-44dc-9523-380cd25c1b9e" } ], - "endpoints": { - "api.bland.ai": 88 + "call_length": 0.12345 + } + //... + ], + "analysis": { + "total_calls": 88, + "completed_calls": 86, + "in_progress_calls": 2, + "queue_statuses": { + "complete": 85, + "started": 2, + "call_error": 1 + }, + "call_lengths": { + "average": 17, + "average_nonzero": 31, + "summary": { + "0-5": 18, + "5-10": 4, + "10-15": 3, + "15-20": 2, + "20-30": 14, + "30-45": 28, + "45-60": 11, + "60-90": 6, + "90-120": 1, + "120+": 1 + }, + "all": [ + 7, 32 + //... + ] + }, + "call_ids": [ + "ffa99be3-63dd-44dc-9523-380cd25c1b9e", + "591338a8-34b2-41e6-93da-b9029c9bdedc" + //... + ], + "error_messages": [ + { + "call_id": "c52f5f8c-147e-478c-4b40-88214feeba29", + "error_message": "Cannot transfer to +12223334444 - Call is no longer active" } + ], + "endpoints": { + "api.bland.ai": 88 + } } } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches.mdx index cb952b60a9..0a05d93b55 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/batches.mdx @@ -48,8 +48,8 @@ slug: api-v1/get/batches - The original base prompt used to create the batch. Will still contain the - original placeholder variables such as `{{ business }}` or `{{ name }}`. + The original base prompt used to create the batch. Will still contain the original placeholder variables such as ` + {{ business }}` or `{{ name }}`. @@ -57,13 +57,12 @@ slug: api-v1/get/batches - Enterprise customers with custom endpoints will see the endpoint code here (if - specified). + Enterprise customers with custom endpoints will see the endpoint code here (if specified). - The base call parameters used to create the batch, such as `voice_id`, - `max_duration`, `reduce_latency`, and `wait_for_greeting`. + The base call parameters used to create the batch, such as `voice_id`, `max_duration`, `reduce_latency`, and + `wait_for_greeting`. @@ -99,12 +98,3 @@ slug: api-v1/get/batches } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-corrected-transcript.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-corrected-transcript.mdx index 7982fb808b..d23d6a8811 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-corrected-transcript.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-corrected-transcript.mdx @@ -17,7 +17,6 @@ slug: api-v1/get/calls-corrected-transcript The unique identifier for the call to be corrected. - ### Response @@ -40,11 +39,12 @@ This will contain an array of objects. Each object will be constructed as the fo ``` -Corrected transcripts provides us with a raw output that is generally unusable because we can't eveen neccessarily align the 'assistant' and 'user' roles. To fix this, we provide our version of an 'aligned' transcript. This means essentailly a transcript where the roles are matched to the pieces of text. +Corrected transcripts provides us with a raw output that is generally unusable because we can't eveen neccessarily align the 'assistant' and 'user' roles. To fix this, we provide our version of an 'aligned' transcript. This means essentailly a transcript where the roles are matched to the pieces of text. We do this by vectorizing the text, taking the cosine similarity, and adding a predictive layer based off of the `wait_for_greeting` param (essentially how sure are we that assistant or user spoke first). -This will contain an array of objects. Each object will be constructed as the following. +This will contain an array of objects. Each object will be constructed as the following. + ```json { "id": 3056004, @@ -54,6 +54,7 @@ This will contain an array of objects. Each object will be constructed as the fo "c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488" }, ``` + @@ -340,10 +341,3 @@ This will contain an array of objects. Each object will be constructed as the fo } ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id-recording.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id-recording.mdx index e1b2702d59..bf7f0c695e 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id-recording.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id-recording.mdx @@ -32,14 +32,14 @@ slug: api-v1/get/calls-id-recording A 404 error will be returned if the call does not exist or the recording is not available. We can only retrieve recordings if the call was created with `record` set to `true`. - A 400/500 error will be returned if there is an error retrieving the recording. +A 400/500 error will be returned if there is an error retrieving the recording. + If the status is `success`, the `url` will provide the exact location of the MP3 file storing the call's audio. - ```json Success response @@ -61,10 +61,3 @@ slug: api-v1/get/calls-id-recording ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id.mdx index 4a5cbe303a..ce18f9cdff 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls-id.mdx @@ -20,14 +20,8 @@ slug: api-v1/get/calls-id ### Response - An array of phrases spoken during the call. - - Each index includes: - - - `id` - - `created_at` - - `text` - - `user` (can be `user`, `assistant`, `robot`, or `agent-action`) + An array of phrases spoken during the call. Each index includes: - `id` - `created_at` - `text` - `user` (can be + `user`, `assistant`, `robot`, or `agent-action`) @@ -37,7 +31,8 @@ slug: api-v1/get/calls-id Variables created during the call - both system variables as well as generated with `dynamic_data`. - For example, if you used a `dynamic_data` API request to generate a variable called `appointment_time`, you would see it here. +For example, if you used a `dynamic_data` API request to generate a variable called `appointment_time`, you would see it here. + @@ -61,28 +56,30 @@ slug: api-v1/get/calls-id - Whether the call has been completed. If it differs from the value of 'queue_status', this will be the most up-to-date status. + Whether the call has been completed. If it differs from the value of 'queue_status', this will be the most up-to-date + status. The status of the call. During extremely high volume periods, calls may be queued for a short period of time before being dispatched. - Progresses through the following stages: +Progresses through the following stages: + +- `new`: An API request has been received. +- `queued`: Call pararameters have been validated and authentication succeeded. +- `allocated`: Extremely brief, the call is being dispatched. +- `started`: The phone call is live and in progress. +- `complete`: The phone call has ended successfully. - - `new`: An API request has been received. - - `queued`: Call pararameters have been validated and authentication succeeded. - - `allocated`: Extremely brief, the call is being dispatched. - - `started`: The phone call is live and in progress. - - `complete`: The phone call has ended successfully. - - The following statuses show the point that was reached before an error: +The following statuses show the point that was reached before an error: - - `pre_queue_error`: An error occurred before the call was queued. Invalid parameters generally cause this. - - `queue_error`: Error occurred while the call was queued. Ex. Valid phone number but to an unserviced area. - - `call_error`: Error occurred during live call. May be caused by transferring to an invalid phone number or an unforeseen error. - - `complete_error`: Error occurred after the call was completed. Ex. A post-call webhook failed. +- `pre_queue_error`: An error occurred before the call was queued. Invalid parameters generally cause this. +- `queue_error`: Error occurred while the call was queued. Ex. Valid phone number but to an unserviced area. +- `call_error`: Error occurred during live call. May be caused by transferring to an invalid phone number or an unforeseen error. +- `complete_error`: Error occurred after the call was completed. Ex. A post-call webhook failed. + +If at any point an error occurs, it will be recorded in the `error_message` field. - If at any point an error occurs, it will be recorded in the `error_message` field. @@ -92,21 +89,19 @@ slug: api-v1/get/calls-id If `answered_by_enabled` was set to `true` in the original API request, this field contains one of the following values: - - `human`: The call was answered by a human. - - `voicemail`: The call was answered by an answering machine or voicemail. - - `unknown`: There was not enough audio at the start of the call to make a determination. - - `no-answer`: The call was not answered. - - `null`: Not enabled, or still processing the result. +- `human`: The call was answered by a human. +- `voicemail`: The call was answered by an answering machine or voicemail. +- `unknown`: There was not enough audio at the start of the call to make a determination. +- `no-answer`: The call was not answered. +- `null`: Not enabled, or still processing the result. + + - - Determinations are based on audio from the first five seconds of the phone call. - `unknown` is most likely a human, especially if there are multiple transcripts. - - Optimize calls for accurate results by getting humans to respond in the first five seconds: - - Increase `speed` in `voice_settings` - - Use with `wait_for_greeting` - - Use a short greeting in `first_sentence` such as "Hello?" or "Hi, is this \{\{name\}\}?" - - + - Optimize calls for accurate results by getting humans to respond in the first five seconds: - Increase `speed` in `voice_settings` - Use with `wait_for_greeting` - Use a short greeting in `first_sentence` such as "Hello?" or "Hi, is this \{\{name\}\}?" + + The URL that was called to dispatch the phone call. @@ -117,7 +112,8 @@ slug: api-v1/get/calls-id - The total length of time the call was connected. This differs from call_length in that it includes ringing and connection time. + The total length of time the call was connected. This differs from call_length in that it includes ringing and + connection time. @@ -204,12 +200,3 @@ slug: api-v1/get/calls-id } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls.mdx index 223217c408..ddd0968cb4 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/calls.mdx @@ -16,13 +16,15 @@ slug: api-v1/get/calls Filter calls by the number they were dispatched from. - The number that initiated the call - the user's phone number for inbound calls, or the number your AI Agent called from for outbound calls. +The number that initiated the call - the user's phone number for inbound calls, or the number your AI Agent called from for outbound calls. + Filter calls by the number they were dispatched to. - The number that answered the call - the user's phone number for outbound calls, or your AI Agent's number for inbound calls. +The number that answered the call - the user's phone number for outbound calls, or your AI Agent's number for inbound calls. + @@ -50,7 +52,8 @@ slug: api-v1/get/calls An array of call data objects. See the [Call](calls-id.mdx) section for details. - Note: Individual call transcripts are not included due to their size. +Note: Individual call transcripts are not included due to their size. + @@ -75,11 +78,3 @@ slug: api-v1/get/calls } ``` - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound-number.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound-number.mdx index c2b536d1d8..0cdae52dfa 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound-number.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound-number.mdx @@ -24,6 +24,7 @@ slug: api-v1/get/inbound-number - `%2B13334445555` - `13334445555` - `3334445555` + ### Response @@ -45,13 +46,12 @@ slug: api-v1/get/inbound-number - The `voice` your agent is using - will be a `reduce_latency` voice. - - For more information, see [List Voices](voices.mdx). + The `voice` your agent is using - will be a `reduce_latency` voice. For more information, see [List + Voices](voices.mdx). - The `pathway_id` your agent is using. + The `pathway_id` your agent is using. @@ -76,11 +76,3 @@ slug: api-v1/get/inbound-number } ``` - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound.mdx index c1720222b7..ae7030cb0f 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/inbound.mdx @@ -15,7 +15,7 @@ slug: api-v1/get/inbound Use your own Twilio account and only return inbound numbers associated with that account sid (optional). - +{" "} ### Response @@ -71,3 +71,4 @@ slug: api-v1/get/inbound +``` diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/me.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/me.mdx index 2c4a9dd555..29b84a897f 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/me.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/me.mdx @@ -14,16 +14,16 @@ slug: api-v1/get/me ### Response -An object containing your billing data. -Contains `current_balance` (number of credits), and `refill_to` if you have auto refill enabled. + An object containing your billing data. Contains `current_balance` (number of credits), and `refill_to` if you have + auto refill enabled. -The status of your account. + The status of your account. -The total number of calls you've made. + The total number of calls you've made. @@ -38,11 +38,3 @@ The total number of calls you've made. } ``` - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/outbound.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/outbound.mdx index 2a01c86538..c50faeb9d0 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/outbound.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/outbound.mdx @@ -23,23 +23,15 @@ slug: api-v1/get/outbound ```json Response { - "outbound_numbers": [ - { - "created_at": "2023-11-27T17:21:38.33359+00:00", - "phone_number": "+18005551234", - "last_initiated": "2023-12-08T21:47:49.808+00:00" - }, - //... - ] + "outbound_numbers": [ + { + "created_at": "2023-11-27T17:21:38.33359+00:00", + "phone_number": "+18005551234", + "last_initiated": "2023-12-08T21:47:49.808+00:00" + } + //... + ] } - ``` - - - - - - - - + diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts-id.mdx index 312f74a67c..3b75474647 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts-id.mdx @@ -12,21 +12,23 @@ slug: api-v1/get/subaccounts-id ### Path Parameters + - The unique identifier of the subaccount. + The unique identifier of the subaccount. ### Response + - Whether the subaccount creation succeeded. + Whether the subaccount creation succeeded. - The affected subaccount's unique identifier. + The affected subaccount's unique identifier. - The new API key for the subaccount. + The new API key for the subaccount. diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts.mdx index d3150c5266..133586caf5 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/subaccounts.mdx @@ -12,12 +12,13 @@ slug: api-v1/get/subaccounts ### Response + - Whether the subaccount creation succeeded. + Whether the subaccount creation succeeded. - An array of your subaccounts. + An array of your subaccounts. diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools-tool-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools-tool-id.mdx index c60700bb48..1c52c180aa 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools-tool-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools-tool-id.mdx @@ -12,18 +12,19 @@ slug: api-v1/get/tools-tool-id ### Path Parameters + - The ID of the tool you want to retrieve (starting with `TL-`). + The ID of the tool you want to retrieve (starting with `TL-`). ### Response - Whether the requet succeeded or failed. + Whether the requet succeeded or failed. - The tool you've created. + The tool you've created. @@ -67,4 +68,3 @@ slug: api-v1/get/tools-tool-id } ``` - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools.mdx index 0fa4b78481..8f9fd57df1 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/tools.mdx @@ -14,11 +14,11 @@ slug: api-v1/get/tools ### Response - Whether the requet succeeded or failed. + Whether the requet succeeded or failed. - An array of your available tools. + An array of your available tools. @@ -65,4 +65,3 @@ slug: api-v1/get/tools } ``` - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices-id.mdx index 40231b3bbf..1327268281 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices-id.mdx @@ -16,9 +16,10 @@ slug: api-v1/get/voices-id The unique identifier for the voice preset. - Place either the voice's `name` or `id` here. +Place either the voice's `name` or `id` here. + +For example, `GET https://api.bland.ai/v1/voices/david` or `GET https://api.bland.ai/v1/voices/ff2c405b-3dba-41e0-9261-bc8ee3f91f46`. - For example, `GET https://api.bland.ai/v1/voices/david` or `GET https://api.bland.ai/v1/voices/ff2c405b-3dba-41e0-9261-bc8ee3f91f46`. ### Response @@ -36,6 +37,7 @@ slug: api-v1/get/voices-id - `total_ratings` - The number of ratings for the voice. Note: Ratings are under development and may show incomplete or inaccurate data. + @@ -57,10 +59,3 @@ slug: api-v1/get/voices-id } ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices.mdx index 5ada09ce40..6c815dcfb9 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/get/voices.mdx @@ -45,6 +45,7 @@ slug: api-v1/get/voices Note: Ratings are under development at this time and may display incomplete/inaccurate data. + @@ -97,10 +98,3 @@ slug: api-v1/get/voices } ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts-delete.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts-delete.mdx index 17e948473a..02a1985863 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts-delete.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts-delete.mdx @@ -24,13 +24,13 @@ slug: api-v1/post/accounts-delete - `success` - The encrypted key was successfully deleted. - `error` - There was an error deleting the encrypted key. + - Special messages: - - `Error deleting Twilio credentials` - The encrypted key could not be deleted or already has been deleted. - - `Missing encrypted key` - The `encrypted_key` parameter is missing. - - none - The encrypted key was successfully deleted. + Special messages: - `Error deleting Twilio credentials` - The encrypted key could not be deleted or already has been + deleted. - `Missing encrypted key` - The `encrypted_key` parameter is missing. - none - The encrypted key was + successfully deleted. @@ -39,4 +39,4 @@ slug: api-v1/post/accounts-delete "status": "success" } ``` - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts.mdx index 5f86dd8af9..4c410d20ab 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/accounts.mdx @@ -16,17 +16,17 @@ slug: api-v1/post/accounts ### Body - Your Twilio account SID. + Your Twilio account SID. - Your Twilio auth token. + Your Twilio auth token. ### Response - Your `encrypted_key` to store and use in future requests. + Your `encrypted_key` to store and use in future requests. @@ -36,4 +36,4 @@ slug: api-v1/post/accounts "encrypted_key": "YOUR_ENCRYPTED_KEY" } ``` - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id-authorize.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id-authorize.mdx index bdd485ae78..b010a17474 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id-authorize.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id-authorize.mdx @@ -10,24 +10,21 @@ slug: api-v1/post/agents-id-authorize Your API key for authentication. - Example web call usage (client side): -```javascript -import { BlandWebClient } from 'bland-client-js-sdk'; +Example web call usage (client side): -const agentId = 'YOUR-AGENT-ID'; -const sessionToken = 'YOUR-SESSION-TOKEN'; +```javascript +import { BlandWebClient } from "bland-client-js-sdk"; +const agentId = "YOUR-AGENT-ID"; +const sessionToken = "YOUR-SESSION-TOKEN"; -document.addEventListener('DOMContentLoaded', async () => { - document.getElementById('btn').addEventListener('click', async () => { - const blandClient = new BlandWebClient( - agentId, - sessionToken - ); - await blandClient.initConversation({ - sampleRate: 44100, - }); +document.addEventListener("DOMContentLoaded", async () => { + document.getElementById("btn").addEventListener("click", async () => { + const blandClient = new BlandWebClient(agentId, sessionToken); + await blandClient.initConversation({ + sampleRate: 44100, }); + }); }); ``` @@ -38,7 +35,8 @@ document.addEventListener('DOMContentLoaded', async () => { The web agent to authorize a call for. - Special note: While in Beta, this request must be made to the `web.bland.ai` domain. +Special note: While in Beta, this request must be made to the `web.bland.ai` domain. + ### Response diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id.mdx index b8b6d23dc5..a761e725d7 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents-id.mdx @@ -14,13 +14,13 @@ slug: api-v1/post/agents-id ### Path Parameters - The web agent you'll be updating. + The web agent you'll be updating. ### Body - Provide instructions, relevant information, and examples of the ideal conversation flow. + Provide instructions, relevant information, and examples of the ideal conversation flow. #### Out-of-the-Box Behaviors (Summarized): @@ -33,11 +33,12 @@ slug: api-v1/post/agents-id - [Try out Agent Testing!](https://app.bland.ai/home?page=testing) - Aim for less than >2,000 characters where possible. - Simple, direct prompts are the most predictable and reliable. - - Frame instructions positively: - - `"Do this"` rather than `"Don't do this"`. + - Frame instructions positively: + - `"Do this"` rather than `"Don't do this"`. - Ex. "Keep the conversation casual" rather than "Don't be too formal". - This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation. + @@ -47,35 +48,37 @@ slug: api-v1/post/agents-id Define a JSON schema for how you want to get information about the call - information like email addresses, names, appointment times or any other type of custom data. - In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. +In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. - For example, if you wanted to retrieve this information from the call: +For example, if you wanted to retrieve this information from the call: - ```json - "analysis_schema": { - "email_address": "email", - "first_name": "string", - "last_name": "string", - "wants_to_book_appointment": "boolean", - "appointment_time": "YYYY-MM-DD HH:MM:SS" - } - ``` +```json +"analysis_schema": { + "email_address": "email", + "first_name": "string", + "last_name": "string", + "wants_to_book_appointment": "boolean", + "appointment_time": "YYYY-MM-DD HH:MM:SS" +} +``` - You would get it filled out like this in your webhook once the call completes: +You would get it filled out like this in your webhook once the call completes: + +```json +"analysis": { + "email_address": "johndoe@gmail.com", + "first_name": "John", + "last_name": "Doe", + "wants_to_book_appointment": true, + "appointment_time": "2024-01-01 12:00:00" +} +``` - ```json - "analysis": { - "email_address": "johndoe@gmail.com", - "first_name": "John", - "last_name": "Doe", - "wants_to_book_appointment": true, - "appointment_time": "2024-01-01 12:00:00" - } - ``` - Add any additional information you want to associate with the call. This can be useful for tracking or categorizing calls. + Add any additional information you want to associate with the call. This can be useful for tracking or categorizing + calls. @@ -88,18 +91,10 @@ slug: api-v1/post/agents-id - Select a supported language of your choice. - Optimizes every part of our API for that language - transcription, speech, and other inner workings. - - Supported Languages and their codes: - - English: ```ENG``` - - Spanish: ```ESP``` - - French: ```FRE``` - - Polish: ```POL``` - - German: ```GER``` - - Italian: ```ITA``` - - Brazilian Portuguese: ```PBR``` - - Portuguese: ```POR``` + Select a supported language of your choice. Optimizes every part of our API for that language - transcription, speech, + and other inner workings. Supported Languages and their codes: - English: ```ENG``` - Spanish: ```ESP``` - French: + ```FRE``` - Polish: ```POL``` - German: ```GER``` - Italian: ```ITA``` - Brazilian Portuguese: ```PBR``` - Portuguese: + ```POR``` @@ -107,69 +102,79 @@ slug: api-v1/post/agents-id and transcript to this URL after the call completes. This can be useful if you want to have real time notifications when calls finish. - Set to `null` or an empty string to clear the webhook. +Set to `null` or an empty string to clear the webhook. + Select a model to use for your call. - Options: `base`, `turbo` and `enhanced`. +Options: `base`, `turbo` and `enhanced`. - In nearly all cases, `enhanced` is the best choice for now. +In nearly all cases, `enhanced` is the best choice for now. - There are three different ways to use Bland: +There are three different ways to use Bland: - - `model: base` - - The original, follows scripts/procedures most effectively. - - Supports all features and capabilities. - - Best for Custom Tools - - - `model: enhanced` - - Much faster latency and very conversational, works best with objective-based prompts. - - Supports all features and capabilities. +- `model: base` - - `model: turbo` - - The absolute fastest latency possible, can be verbose at times - - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) - - Extremely realistic conversation capabilities + - The original, follows scripts/procedures most effectively. + - Supports all features and capabilities. + - Best for Custom Tools - - +- `model: enhanced` + + - Much faster latency and very conversational, works best with objective-based prompts. + - Supports all features and capabilities. + +- `model: turbo` + + - The absolute fastest latency possible, can be verbose at times + - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) + - Extremely realistic conversation capabilities + + + + A phrase that your call will start with instead of a generating one on the fly. This works both with and without `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. - To remove, set to `null` or an empty string. +To remove, set to `null` or an empty string. + Interact with the real world through API calls. - Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) +Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) + - Integrate data from external APIs into your agent's knowledge. + Integrate data from external APIs into your agent's knowledge. - Set to `null` or an empty string to clear dynamic data settings. +Set to `null` or an empty string to clear dynamic data settings. + +Detailed usage in the [Send Call](calls.mdx) endpoint. - Detailed usage in the [Send Call](calls.mdx) endpoint. When you increase the interruption latency, you force the AI phone agent to listen longer before responding. In practice, increasing the threshold results in less interruptions and more latency. - Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted less frequently. +Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted less frequently. + +Set to `null` to reset to default. - Set to `null` to reset to default. The maximum duration that calls to your agent can last before being automatically terminated. - Set to `null` to reset to default. +Set to `null` to reset to default. + ### Response @@ -187,20 +192,20 @@ slug: api-v1/post/agents-id - If the update was unsuccessful, this will contain the settings that failed to update. Useful to determine how your request is being interpreted on our end. + If the update was unsuccessful, this will contain the settings that failed to update. Useful to determine how your + request is being interpreted on our end. ```json Response { - "status": "success", - "message": "Successfully updated agent 46f37229-7d12-44be-b343-6e68274cfbea.", - "updates": { - "model": "enhanced" - } + "status": "success", + "message": "Successfully updated agent 46f37229-7d12-44be-b343-6e68274cfbea.", + "updates": { + "model": "enhanced" + } } ``` - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents.mdx index 142ed7e1fa..bb7c789319 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/agents.mdx @@ -11,23 +11,20 @@ slug: api-v1/post/agents Your API key for authentication. Example web call usage (client side): -```javascript -import { BlandWebClient } from 'bland-client-js-sdk'; -const agentId = 'YOUR-AGENT-ID'; -const sessionToken = 'YOUR-SESSION-TOKEN'; +```javascript +import { BlandWebClient } from "bland-client-js-sdk"; +const agentId = "YOUR-AGENT-ID"; +const sessionToken = "YOUR-SESSION-TOKEN"; -document.addEventListener('DOMContentLoaded', async () => { - document.getElementById('btn').addEventListener('click', async () => { - const blandClient = new BlandWebClient( - agentId, - sessionToken - ); - await blandClient.initConversation({ - sampleRate: 44100, - }); +document.addEventListener("DOMContentLoaded", async () => { + document.getElementById("btn").addEventListener("click", async () => { + const blandClient = new BlandWebClient(agentId, sessionToken); + await blandClient.initConversation({ + sampleRate: 44100, }); + }); }); ``` @@ -49,11 +46,12 @@ document.addEventListener('DOMContentLoaded', async () => { - [Try out Agent Testing!](https://app.bland.ai/home?page=testing) - Aim for less than >2,000 characters where possible. - Simple, direct prompts are the most predictable and reliable. - - Frame instructions positively: - - `"Do this"` rather than `"Don't do this"`. + - Frame instructions positively: + - `"Do this"` rather than `"Don't do this"`. - Ex. "Keep the conversation casual" rather than "Don't be too formal". - This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation. + @@ -63,35 +61,37 @@ document.addEventListener('DOMContentLoaded', async () => { Define a JSON schema for how you want to get information about the call - information like email addresses, names, appointment times or any other type of custom data. - In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. +In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. - For example, if you wanted to retrieve this information from the call: +For example, if you wanted to retrieve this information from the call: - ```json - "analysis_schema": { - "email_address": "email", - "first_name": "string", - "last_name": "string", - "wants_to_book_appointment": "boolean", - "appointment_time": "YYYY-MM-DD HH:MM:SS" - } - ``` +```json +"analysis_schema": { + "email_address": "email", + "first_name": "string", + "last_name": "string", + "wants_to_book_appointment": "boolean", + "appointment_time": "YYYY-MM-DD HH:MM:SS" +} +``` - You would get it filled out like this in your webhook once the call completes: +You would get it filled out like this in your webhook once the call completes: + +```json +"analysis": { + "email_address": "johndoe@gmail.com", + "first_name": "John", + "last_name": "Doe", + "wants_to_book_appointment": true, + "appointment_time": "2024-01-01 12:00:00" +} +``` - ```json - "analysis": { - "email_address": "johndoe@gmail.com", - "first_name": "John", - "last_name": "Doe", - "wants_to_book_appointment": true, - "appointment_time": "2024-01-01 12:00:00" - } - ``` - Add any additional information you want to associate with the call. This can be useful for tracking or categorizing calls. + Add any additional information you want to associate with the call. This can be useful for tracking or categorizing + calls. @@ -104,80 +104,81 @@ document.addEventListener('DOMContentLoaded', async () => { - Select a supported language of your choice. - Optimizes every part of our API for that language - transcription, speech, and other inner workings. - - Supported Languages and their codes: - - English: ```ENG``` - - Spanish: ```ESP``` - - French: ```FRE``` - - Polish: ```POL``` - - German: ```GER``` - - Italian: ```ITA``` - - Brazilian Portuguese: ```PBR``` - - Portuguese: ```POR``` + Select a supported language of your choice. Optimizes every part of our API for that language - transcription, speech, + and other inner workings. Supported Languages and their codes: - English: ```ENG``` - Spanish: ```ESP``` - French: + ```FRE``` - Polish: ```POL``` - German: ```GER``` - Italian: ```ITA``` - Brazilian Portuguese: ```PBR``` - Portuguese: + ```POR``` Select a model to use for your call. - Options: `base`, `turbo` and `enhanced`. +Options: `base`, `turbo` and `enhanced`. - In nearly all cases, `enhanced` is the best choice for now. +In nearly all cases, `enhanced` is the best choice for now. - There are three different ways to use Bland: +There are three different ways to use Bland: - - `model: base` - - The original, follows scripts/procedures most effectively. - - Supports all features and capabilities. - - Best for Custom Tools - - - `model: enhanced` - - Much faster latency and very conversational, works best with objective-based prompts. - - Supports all features and capabilities. +- `model: base` - - `model: turbo` - - The absolute fastest latency possible, can be verbose at times - - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) - - Extremely realistic conversation capabilities + - The original, follows scripts/procedures most effectively. + - Supports all features and capabilities. + - Best for Custom Tools - - +- `model: enhanced` + + - Much faster latency and very conversational, works best with objective-based prompts. + - Supports all features and capabilities. + +- `model: turbo` + + - The absolute fastest latency possible, can be verbose at times + - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) + - Extremely realistic conversation capabilities + + + + A phrase that your call will start with instead of a generating one on the fly. This works both with and without `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. - To remove, set to `null` or an empty string. +To remove, set to `null` or an empty string. + Interact with the real world through API calls. - Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) +Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) + - Integrate data from external APIs into your agent's knowledge. + Integrate data from external APIs into your agent's knowledge. + +Set to `null` or an empty string to clear dynamic data settings. - Set to `null` or an empty string to clear dynamic data settings. +Detailed usage in the [Send Call](calls.mdx) endpoint. - Detailed usage in the [Send Call](calls.mdx) endpoint. When you increase the interruption latency, you force the AI phone agent to listen longer before responding. In practice, increasing the threshold results in less interruptions and more latency. - Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted less frequently. +Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted less frequently. + +Set to `null` to reset to default. - Set to `null` to reset to default. The maximum duration that calls to your agent can last before being automatically terminated. - Set to `null` to reset to default. +Set to `null` to reset to default. + ### Response @@ -195,26 +196,21 @@ document.addEventListener('DOMContentLoaded', async () => { ```json Response { "agent": { - "agent_id": "2c565dc7-f41f-43db-a99f-e4c8ba9d7d18", - "webhook": null, - "dynamic_data": null, - "interruption_threshold": null, - "first_sentence": null, - "model": "enhanced", - "voice_settings": null, - "voice": "maya", - "prompt": "...", - "temperature": null, - "max_duration": 30, - "language": "ENG", - "tools": null + "agent_id": "2c565dc7-f41f-43db-a99f-e4c8ba9d7d18", + "webhook": null, + "dynamic_data": null, + "interruption_threshold": null, + "first_sentence": null, + "model": "enhanced", + "voice_settings": null, + "voice": "maya", + "prompt": "...", + "temperature": null, + "max_duration": 30, + "language": "ENG", + "tools": null } } ``` - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-analyze.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-analyze.mdx index 0766b4d2dd..8e3960204a 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-analyze.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-analyze.mdx @@ -20,7 +20,8 @@ slug: api-v1/post/batches-id-analyze ### Request Body - This is the overall purpose of the batch of calls. Provides context for the analysis to guide how the questions/transcripts are interpreted. + This is the overall purpose of the batch of calls. Provides context for the analysis to guide how the + questions/transcripts are interpreted. @@ -28,17 +29,19 @@ slug: api-v1/post/batches-id-analyze Each question should be an array with two elements: the question text and the expected answer type (e.g., "string", "boolean"). - Fairly flexible in terms of the expected answer type, and unanswerable questions will default to `null`. - - Examples: - ```json - "questions": [ - ["Who answered the call?", "human or voicemail"], - ["Positive feedback about the product: ", "string"], - ["Negative feedback about the product: ", "string"], - ["Customer confirmed they were satisfied", "boolean"] - ] - ``` +Fairly flexible in terms of the expected answer type, and unanswerable questions will default to `null`. + +Examples: + +```json +"questions": [ + ["Who answered the call?", "human or voicemail"], + ["Positive feedback about the product: ", "string"], + ["Negative feedback about the product: ", "string"], + ["Customer confirmed they were satisfied", "boolean"] + ] +``` + ### Response @@ -54,15 +57,17 @@ slug: api-v1/post/batches-id-analyze Contains the analyzed answers for each call in the batch. - The keys are `call_id`s from the batch, and the array values are the analysis results for each question in the batch. +The keys are `call_id`s from the batch, and the array values are the analysis results for each question in the batch. + Token-based price for the analysis request. - As a rough estimate, the base cost is `0.003` credits with an additional `0.0015` credits per call in the batch. +As a rough estimate, the base cost is `0.003` credits with an additional `0.0015` credits per call in the batch. + +Longer call transcripts and higher numbers of questions can increase the cost, however the cost scales very effectively with batches vs. individual calls. - Longer call transcripts and higher numbers of questions can increase the cost, however the cost scales very effectively with batches vs. individual calls. @@ -87,10 +92,3 @@ slug: api-v1/post/batches-id-analyze } ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-stop.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-stop.mdx index 341fc4913f..6e6a910544 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-stop.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches-id-stop.mdx @@ -20,7 +20,8 @@ slug: api-v1/post/batches-id-stop ### Response - The status of the request. If anything other than 'success', an error has occurred or all calls have already been completed. + The status of the request. If anything other than 'success', an error has occurred or all calls have already been + completed. @@ -47,12 +48,3 @@ slug: api-v1/post/batches-id-stop ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches.mdx index 17ee646b5c..25311afd0d 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/batches.mdx @@ -16,19 +16,22 @@ slug: api-v1/post/batches This is the prompt or task used for all the phone calls in the request. Information can be inserted into it surrounding variable names with \{\{curly braces\}\}. - Example: - ```json - "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}." - ``` +Example: + +```json +"You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}." +``` + Define a list of calls to make and their properties. Each call in call_data MUST have a "phone_number" property. Properties are case-sensitive. - Example: +Example: + ```json [ - { + { "phone_number": "1234567890", "business": "ABC Corp", "service": "Netflix", @@ -42,24 +45,29 @@ slug: api-v1/post/batches } ] ``` + - Adds a user-friendly label to your batch to keep track of it's original intention. This can help differentiate multiple call batches that are part of the same Campaign. Shown when a batch is retreived. + Adds a user-friendly label to your batch to keep track of it's original intention. This can help differentiate + multiple call batches that are part of the same Campaign. Shown when a batch is retreived. - Use ```campaign_id``` to organize related batches together. This can be set manually or auto-generated through Campaigns. + Use ```campaign_id``` to organize related batches together. This can be set manually or auto-generated through + Campaigns. When this is set to ```true```, only the first call of ```call_data``` will be dispatched. A common use case is to set the first ```phone_number``` value to your own to confirm everything's set up properly. - Includes additional information in the response when true so that it's easier to find any issues. +Includes additional information in the response when true so that it's easier to find any issues. + - All other parameters supported by the [Send Call](calls.mdx) endpoint are supported here as well. They will be applied to each call in the batch. + All other parameters supported by the [Send Call](calls.mdx) endpoint are supported here as well. They will + be applied to each call in the batch. ### Response @@ -76,18 +84,9 @@ slug: api-v1/post/batches ```json Response { - "message": "success", - "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch" + "message": "success", + "batch_id": "3p$7rQ3p9sT5bzmF-gen-batch" } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-analyze.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-analyze.mdx index 4e17524f16..4ec5196a78 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-analyze.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-analyze.mdx @@ -20,7 +20,8 @@ slug: api-v1/post/calls-id-analyze ### Request Body - This is the overall purpose of the call. Provides context for the analysis to guide how the questions/transcripts are interpreted. + This is the overall purpose of the call. Provides context for the analysis to guide how the questions/transcripts are + interpreted. @@ -28,17 +29,19 @@ slug: api-v1/post/calls-id-analyze Each question should be an array with two elements: the question text and the expected answer type (e.g., "string", "boolean"). - Fairly flexible in terms of the expected answer type, and unanswerable questions will default to `null`. +Fairly flexible in terms of the expected answer type, and unanswerable questions will default to `null`. + +Examples: + +```json +"questions": [ + ["Who answered the call?", "human or voicemail"], + ["Positive feedback about the product: ", "string"], + ["Negative feedback about the product: ", "string"], + ["Customer confirmed they were satisfied", "boolean"] + ] +``` - Examples: - ```json - "questions": [ - ["Who answered the call?", "human or voicemail"], - ["Positive feedback about the product: ", "string"], - ["Negative feedback about the product: ", "string"], - ["Customer confirmed they were satisfied", "boolean"] - ] - ``` ### Response @@ -58,9 +61,10 @@ slug: api-v1/post/calls-id-analyze Token-based price for the analysis request. - As a rough estimate, the base cost is `0.003` credits with an additional `0.0015` credits per call in the call. +As a rough estimate, the base cost is `0.003` credits with an additional `0.0015` credits per call in the call. + +Longer call transcripts and higher numbers of questions can increase the cost, however the cost scales very effectively with calls vs. individual calls. - Longer call transcripts and higher numbers of questions can increase the cost, however the cost scales very effectively with calls vs. individual calls. @@ -77,10 +81,3 @@ slug: api-v1/post/calls-id-analyze } ``` - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-stop.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-stop.mdx index 0c971604df..ab21194bc9 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-stop.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-id-stop.mdx @@ -24,9 +24,8 @@ slug: api-v1/post/calls-id-stop - If the status is `success`, the message will say "Call ended successfully." - Otherwise, if the status is `error`, the message will say "SID not found for - the given c_id." or "Internal server error." + If the status is `success`, the message will say "Call ended successfully." Otherwise, if the status is `error`, the + message will say "SID not found for the given c_id." or "Internal server error." @@ -37,12 +36,3 @@ slug: api-v1/post/calls-id-stop } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple-pathway.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple-pathway.mdx index 6f3929faca..0776b81439 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple-pathway.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple-pathway.mdx @@ -33,18 +33,19 @@ slug: api-v1/post/calls-simple-pathway - "+1 222 333 4444" - "222-333-4444" - Invalid: + Invalid: - "12223334444" - "552223334444" - "non-numeric characters" - "2223334444 ext. 123" + Follows the conversational pathway you created to guide the conversation. - You can access your pathway_id by clicking on the 'Copy ID' button on your pathways [here](https://app.bland.ai/home?page=convo-pathways). If you don't have any pathways, click the 'Create Pathway' button to create one! +You can access your pathway_id by clicking on the 'Copy ID' button on your pathways [here](https://app.bland.ai/home?page=convo-pathways). If you don't have any pathways, click the 'Create Pathway' button to create one! @@ -53,9 +54,8 @@ slug: api-v1/post/calls-simple-pathway [Step by step Web Tutorial](https://docs.bland.ai/tutorials/pathways) - - + ### Response @@ -77,12 +77,3 @@ slug: api-v1/post/calls-simple-pathway ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple.mdx index 0026248334..9d4ae9888d 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls-simple.mdx @@ -29,12 +29,13 @@ slug: api-v1/post/calls-simple - "+1 222 333 4444" - "222-333-4444" - Invalid: + Invalid: - "12223334444" - "552223334444" - "non-numeric characters" - "2223334444 ext. 123" + @@ -52,14 +53,13 @@ slug: api-v1/post/calls-simple - [Try out Agent Testing!](https://app.bland.ai/home?page=testing) - Aim for less than >2,000 characters where possible. - Simple, direct prompts are the most predictable and reliable. - - Frame instructions positively: - - `"Do this"` rather than `"Don't do this"`. + - Frame instructions positively: + - `"Do this"` rather than `"Don't do this"`. - Ex. "Keep the conversation casual" rather than "Don't be too formal". - This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation. - - + ### Response @@ -81,12 +81,3 @@ slug: api-v1/post/calls-simple ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls.mdx index 9d305fe57b..6094902362 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/calls.mdx @@ -34,12 +34,13 @@ slug: api-v1/post/calls - "+1 222 333 4444" - "222-333-4444" - Invalid: + Invalid: - "12223334444" - "552223334444" - "non-numeric characters" - "2223334444 ext. 123" + @@ -57,30 +58,32 @@ slug: api-v1/post/calls - [Try out Agent Testing!](https://app.bland.ai/home?page=testing) - Aim for less than >2,000 characters where possible. - Simple, direct prompts are the most predictable and reliable. - - Frame instructions positively: - - `"Do this"` rather than `"Don't do this"`. + - Frame instructions positively: + - `"Do this"` rather than `"Don't do this"`. - Ex. "Keep the conversation casual" rather than "Don't be too formal". - This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation. + The voice of the AI agent to use. Accepts any form of voice ID, including custom voice clones and voice presets. - Default voices can be referenced directly by their name instead of an id. +Default voices can be referenced directly by their name instead of an id. + +Usage example: `voice: "maya"` - Usage example: `voice: "maya"` +Bland Curated voices: - Bland Curated voices: - - `maya` - - `mason` - - `ryan` - - `adriana` - - `tina` - - `matt` - - `evelyn` +- `maya` +- `mason` +- `ryan` +- `adriana` +- `tina` +- `matt` +- `evelyn` - Use the [GET /v1/voices](https://api.bland.ai/voices) endpoint to see a full list of your available voices. +Use the [GET /v1/voices](https://api.bland.ai/voices) endpoint to see a full list of your available voices. @@ -97,48 +100,51 @@ slug: api-v1/post/calls - `reduce_latency: false, voice_id: 3` is equivalent to `voice: "HQ3"` Including `reduce_latency` may override the `voice` parameter, so exclude it when using `voice`. + All presets have been migrated to the `voice` parameter and can use either the preset name or ID. If you used to have a `voice_preset_id` of `"2f9fdbc7-4bf2-4792-8a18-21ce3c93978f"`, you can now use `voice: "2f9fdbc7-4bf2-4792-8a18-21ce3c93978f"`. + Define a JSON schema for how you want to get information about the call - information like email addresses, names, appointment times or any other type of custom data. - In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. - - For example, if you wanted to retrieve this information from the call: - - ```json - "analysis_schema": { - "email_address": "email", - "first_name": "string", - "last_name": "string", - "wants_to_book_appointment": "boolean", - "appointment_time": "YYYY-MM-DD HH:MM:SS" - } - ``` - - You would get it filled out like this in your webhook once the call completes: - - ```json - "analysis": { - "email_address": "johndoe@gmail.com", - "first_name": "John", - "last_name": "Doe", - "wants_to_book_appointment": true, - "appointment_time": "2024-01-01 12:00:00" - } - ``` - +In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. + +For example, if you wanted to retrieve this information from the call: + +```json +"analysis_schema": { + "email_address": "email", + "first_name": "string", + "last_name": "string", + "wants_to_book_appointment": "boolean", + "appointment_time": "YYYY-MM-DD HH:MM:SS" +} +``` +You would get it filled out like this in your webhook once the call completes: + +```json +"analysis": { + "email_address": "johndoe@gmail.com", + "first_name": "John", + "last_name": "Doe", + "wants_to_book_appointment": true, + "appointment_time": "2024-01-01 12:00:00" +} +``` + + - A phrase that your call will start with instead of a generating one on the fly. This works both with and without `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. + A phrase that your call will start with instead of a generating one on the fly. This works both with and without + `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. @@ -154,7 +160,8 @@ slug: api-v1/post/calls When you increase the interruption latency, you force the AI phone agent to listen longer before responding. In practice, increasing the threshold results in less interruptions and more latency. - Try setting the threshold to `200` milliseconds. You'll encounter higher latency, but you'll be interrupted much less frequently. +Try setting the threshold to `200` milliseconds. You'll encounter higher latency, but you'll be interrupted much less frequently. + @@ -162,84 +169,94 @@ slug: api-v1/post/calls can access the ID of your pathways by clicking the 'Copy ID' button of your pathway [here](https://app.bland.ai/home?page=convo-pathways) - Note: Certain parameters do not apply when using pathways. +Note: Certain parameters do not apply when using pathways. - - - `task` - The pathway substitutes as the agent's instructions. - - `model` - We use our own fine-tuned models under the hood. - - `tools` - Replaced by 'Webhook' Node in Pathways - - `transfer_list` - Replaced by 'Transfer Call' Node in Pathways - - `transfer_phone_number` - Replaced by 'Transfer Call' Node in Pathways - +{" "} + + + - `task` - The pathway substitutes as the agent's instructions. - `model` - We use our own fine-tuned models under the + hood. - `tools` - Replaced by 'Webhook' Node in Pathways - `transfer_list` - Replaced by 'Transfer Call' Node in + Pathways - `transfer_phone_number` - Replaced by 'Transfer Call' Node in Pathways + + +Example Simple Request body: + +```json +"phone_number": "+1975934749", +"pathway_id": "a0f0d4ed-f5f5-4f16-b3f9-22166594d7a7" +``` - Example Simple Request body: - ```json - "phone_number": "+1975934749", - "pathway_id": "a0f0d4ed-f5f5-4f16-b3f9-22166594d7a7" - ``` Select a model to use for your call. - Options: `gpt4`, `base`, `turbo` and `enhanced`. +Options: `gpt4`, `base`, `turbo` and `enhanced`. - In nearly all cases, `enhanced` is the best choice for now. +In nearly all cases, `enhanced` is the best choice for now. - There are four different ways to use Bland: +There are four different ways to use Bland: - - `model: gpt4` - - Slow but accurate - - Supports all features and capabilities. - - Best for complex tasks where latency isn't a priority +- `model: gpt4` - - `model: base` - - The original, follows scripts/procedures most effectively. - - Supports all features and capabilities. - - Best for Custom Tools - - - `model: enhanced` - - Much faster latency and very conversational, works best with objective-based prompts. - - Supports all features and capabilities. + - Slow but accurate + - Supports all features and capabilities. + - Best for complex tasks where latency isn't a priority - - `model: turbo` - - The absolute fastest latency possible, can be verbose at times - - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) - - Extremely realistic conversation capabilities +- `model: base` - - + - The original, follows scripts/procedures most effectively. + - Supports all features and capabilities. + - Best for Custom Tools + +- `model: enhanced` + + - Much faster latency and very conversational, works best with objective-based prompts. + - Supports all features and capabilities. + +- `model: turbo` + + - The absolute fastest latency possible, can be verbose at times + - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) + - Extremely realistic conversation capabilities + + + + Interact with the real world through API calls. - Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) +Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) + Add any additional information you want to associate with the call. This can be useful for tracking or categorizing calls. - Anything that you put here will be returned in your webhook or in the call details under `metadata`. +Anything that you put here will be returned in your webhook or in the call details under `metadata`. + +Example: + +```json +"metadata": { + "campaign_id": "1234", + "source": "web" +} +``` - Example: - ```json - "metadata": { - "campaign_id": "1234", - "source": "web" - } - ``` - The webhook should be a http / https callback url. We will send the call_id - and transcript to this URL after the call completes. This can be useful if you - want to have real time notifications when calls finish. + The webhook should be a http / https callback url. We will send the call_id and transcript to this URL after the call + completes. This can be useful if you want to have real time notifications when calls finish. - To record your phone call, set `record` to true. When your call completes, you can access through the `recording_url` field in the call details or your webhook. + To record your phone call, set `record` to true. When your call completes, you can access through the `recording_url` + field in the call details or your webhook. @@ -251,68 +268,64 @@ slug: api-v1/post/calls - In the `task`, refer to the action solely as "transfer" or "transferring". - Alternate phrasing such as "swap" or "switch" can mislead the agent, causing the action to be ignored. + Give your agent the ability to transfer calls to a set of phone numbers. - Overrides `transfer_phone_number` if a `transfer_list.default` is specified. +Overrides `transfer_phone_number` if a `transfer_list.default` is specified. - Will default to `transfer_list.default`, or the chosen phone number. +Will default to `transfer_list.default`, or the chosen phone number. - Example usage to route calls to different departments: +Example usage to route calls to different departments: + +```json +"transfer_list": { + "default": "+12223334444", + "sales": "+12223334444", + "support": "+12223334444", + "billing": "+12223334444" +} +``` - ```json - "transfer_list": { - "default": "+12223334444", - "sales": "+12223334444", - "support": "+12223334444", - "billing": "+12223334444" - } - ``` - Select a supported language of your choice. - Optimizes every part of our API for that language - transcription, speech, and other inner workings. - - Supported Languages and their codes: - - English: ```ENG``` - - Spanish: ```ESP``` - - French: ```FRE``` - - Polish: ```POL``` - - German: ```GER``` - - Italian: ```ITA``` - - Brazilian Portuguese: ```PBR``` - - Portuguese: ```POR``` + Select a supported language of your choice. Optimizes every part of our API for that language - transcription, speech, + and other inner workings. Supported Languages and their codes: - English: ```ENG``` - Spanish: ```ESP``` - French: + ```FRE``` - Polish: ```POL``` - German: ```GER``` - Italian: ```ITA``` - Brazilian Portuguese: ```PBR``` - Portuguese: + ```POR``` - Set the longest you want the call to possibly go in minutes. After the max_duration minutes have passed, the call will automatically end. - - Example Values: ```20, 2``` + Set the longest you want the call to possibly go in minutes. After the max_duration minutes have passed, the call will + automatically end. Example Values: ```20, 2``` Enables machine detection when the call starts to determine whether the call was answered by a person or a voicemail. - Best Practices (when enabled): - - Since the determination is made at the beginning of the call, use `wait_for_greeting` to try and coax a human response. - - If combined with `first_sentence`, try wording it so the person answering says something back - ex. `"Hello?"` or `"Is this \{\{name\}\}?"`. +Best Practices (when enabled): + +- Since the determination is made at the beginning of the call, use `wait_for_greeting` to try and coax a human response. +- If combined with `first_sentence`, try wording it so the person answering says something back - ex. `"Hello?"` or `"Is this \{\{name\}\}?"`. + +Price: `$0.02` per call, however there is no charge for unanswered calls or calls that failed to send. - Price: `$0.02` per call, however there is no charge for unanswered calls or calls that failed to send. Specify a purchased Outbound Number to call from. Country code is required, spaces or parentheses must be excluded. - By default, calls are initiated from a separate pool of numbers owned by Bland. +By default, calls are initiated from a separate pool of numbers owned by Bland. + - The pronunciation guide is an `array` of `objects` that guides the LLM on how to say specific words. This is great for situations with complicated terms or names. + The pronunciation guide is an `array` of `objects` that guides the LLM on how to say specific words. This is great for situations with complicated terms or names. -```json +````json [ { "word": "example", @@ -329,7 +342,7 @@ slug: api-v1/post/calls ] ``` - + - `word` — the word you want to guide the LLM on how to pronounce @@ -337,21 +350,21 @@ slug: api-v1/post/calls — the word you want to guide the LLM on how to pronounce. - `case_sensitive` — whether or not to consider case. Particularly useful with names. EG: 'Max' the name versus 'max' the word. Defaults to false. `Not required`. - - `spaced` + - `spaced` — whether or not to consider spaces. When `true` the word 'high' would be flagged but NOT 'hightop'. Defaults to true. `Not required`. - + A value between 0 and 1 that controls the randomness of the LLM. 0 will cause more deterministic outputs while 1 will cause more random. - + Example Values: ```"0.9", "0.3", "0.5"``` The time you want the call to start. If you don't specify a time (or the time is in the past), the call will send immediately. - + Set your time in the format `YYYY-MM-DD HH:MM:SS -HH:MM` (ex. `2021-01-01 12:00:00 -05:00`). The timezone is optional, and defaults to UTC if not specified. @@ -370,7 +383,7 @@ slug: api-v1/post/calls Options: - ```hangup``` - - ```leave_message ``` + - ```leave_message ``` - ```ignore``` Examples: @@ -388,12 +401,12 @@ slug: api-v1/post/calls - AMD mode helps your AI navigate phone trees and IVR systems. If you know your call will hit an automated system you should switch it on. + AMD mode helps your AI navigate phone trees and IVR systems. If you know your call will hit an automated system you should switch it on. Behavioral changes: - Much higher `interruption_threshold` so that the options are listened to in full. - Underlying prompt is adjusted so the AI is aware it's navigating a phone tree. - + NOTE: AMD mode causes increased delay for the first response, even if answered by a human. Highly recommended to set to `false` in the majority of cases. @@ -404,7 +417,7 @@ slug: api-v1/post/calls The AI agent will be aware of both the key names as well as their corresponding values. - Example Issue: + Example Issue: - The LLM is hallucinating specific facts. You need to provide specific information. Example Solution: - Use `request_data` to specify and label that data. @@ -437,16 +450,16 @@ slug: api-v1/post/calls `headers`: An object of headers to send with the request. - `body`: The body of the request. - - The following variables can be injected into the dynamic request body: - + `body`: The body of the request. + + The following variables can be injected into the dynamic request body: + - `{{from}}` (Ex. `+12223334444`) - `{{to}}` - `{{short_from}}` (Ex. `2223334444`) - `{{short_to}}` - `{{call_id}}` - + These string values will be replaced in each `dynamic_data[].body` where they're used by system values in each request. Try out with this example: @@ -468,23 +481,23 @@ slug: api-v1/post/calls ] } ] -``` +```` + An array of objects describing how to parse and use the data fetched from the API. Each object in this array should contain: - - `name`: A label for the fetched data. + - `name`: A label for the fetched data. - Example: `"Flight Status"` - - `data`: The JSON path in the API response to extract the data from. + - `data`: The JSON path in the API response to extract the data from. - Example: `"user.flights[0].status"` - - `context`: How this data should be incorporated into the AI's knowledge. + - `context`: How this data should be incorporated into the AI's knowledge. - Example: `"John's flight is currently {{Flight Status}}"` + - - ### Response @@ -506,19 +519,21 @@ slug: api-v1/post/calls For validation errors, a detailed list of each field with an error and it's error message. - Example: - ```json +Example: + +```json { - "status": "error", - "message": "Invalid parameters", - "errors": [ - "Missing required parameter: phone_number.", - "Missing required parameter: task.", - "Phone number must be a string or number.", - "Task must be a string." - ] + "status": "error", + "message": "Invalid parameters", + "errors": [ + "Missing required parameter: phone_number.", + "Missing required parameter: task.", + "Phone number must be a string or number.", + "Task must be a string." + ] } - ``` +``` + @@ -533,12 +548,3 @@ slug: api-v1/post/calls ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-insert.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-insert.mdx index d110e84692..e4966bd232 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-insert.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-insert.mdx @@ -25,6 +25,7 @@ slug: api-v1/post/inbound-insert Include the leading `'+'`, country code and the phone number without any special characters. Example: `["+12223334444", "+13334445555"]` + ### Response @@ -40,7 +41,8 @@ slug: api-v1/post/inbound-insert An array of phone numbers that were successfully inserted. - Any phone numbers that failed to be inserted will not be included in this array - for example if they are already in your account or not associated with the sepcified Twilio account. +Any phone numbers that failed to be inserted will not be included in this array - for example if they are already in your account or not associated with the sepcified Twilio account. + diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-number-update.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-number-update.mdx index 63bac48bab..7cdd908e98 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-number-update.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-number-update.mdx @@ -12,7 +12,8 @@ slug: api-v1/post/inbound-number-update - The `encrypted_key` for the Twilio account that owns the phone number you want to modify. Not required if you are using a Bland phone number. + The `encrypted_key` for the Twilio account that owns the phone number you want to modify. Not required if you are + using a Bland phone number. ### Path Parameters @@ -28,12 +29,13 @@ slug: api-v1/post/inbound-number-update - `%2B13334445555` - `13334445555` - `3334445555` + ### Body - Provide instructions, relevant information, and examples of the ideal conversation flow. + Provide instructions, relevant information, and examples of the ideal conversation flow. For inbound numbers, consider including additional context about the purpose of the call, and what types of callers to expect. @@ -48,11 +50,12 @@ slug: api-v1/post/inbound-number-update - [Try out Agent Testing!](https://app.bland.ai/home?page=testing) - Aim for less than >2,000 characters where possible. - Simple, direct prompts are the most predictable and reliable. - - Frame instructions positively: - - `"Do this"` rather than `"Don't do this"`. + - Frame instructions positively: + - `"Do this"` rather than `"Don't do this"`. - Ex. "Keep the conversation casual" rather than "Don't be too formal". - This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation. + @@ -62,35 +65,37 @@ slug: api-v1/post/inbound-number-update Define a JSON schema for how you want to get information about the call - information like email addresses, names, appointment times or any other type of custom data. - In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. +In the webhook response or whenever you retrieve call data later, you'll get the data you defined back under `analysis`. - For example, if you wanted to retrieve this information from the call: +For example, if you wanted to retrieve this information from the call: - ```json - "analysis_schema": { - "email_address": "email", - "first_name": "string", - "last_name": "string", - "wants_to_book_appointment": "boolean", - "appointment_time": "YYYY-MM-DD HH:MM:SS" - } - ``` +```json +"analysis_schema": { + "email_address": "email", + "first_name": "string", + "last_name": "string", + "wants_to_book_appointment": "boolean", + "appointment_time": "YYYY-MM-DD HH:MM:SS" +} +``` - You would get it filled out like this in your webhook once the call completes: +You would get it filled out like this in your webhook once the call completes: + +```json +"analysis": { + "email_address": "johndoe@gmail.com", + "first_name": "John", + "last_name": "Doe", + "wants_to_book_appointment": true, + "appointment_time": "2024-01-01 12:00:00" +} +``` - ```json - "analysis": { - "email_address": "johndoe@gmail.com", - "first_name": "John", - "last_name": "Doe", - "wants_to_book_appointment": true, - "appointment_time": "2024-01-01 12:00:00" - } - ``` - Add any additional information you want to associate with the call. This can be useful for tracking or categorizing calls. + Add any additional information you want to associate with the call. This can be useful for tracking or categorizing + calls. @@ -103,18 +108,10 @@ slug: api-v1/post/inbound-number-update - Select a supported language of your choice. - Optimizes every part of our API for that language - transcription, speech, and other inner workings. - - Supported Languages and their codes: - - English: ```ENG``` - - Spanish: ```ESP``` - - French: ```FRE``` - - Polish: ```POL``` - - German: ```GER``` - - Italian: ```ITA``` - - Brazilian Portuguese: ```PBR``` - - Portuguese: ```POR``` + Select a supported language of your choice. Optimizes every part of our API for that language - transcription, speech, + and other inner workings. Supported Languages and their codes: - English: ```ENG``` - Spanish: ```ESP``` - French: + ```FRE``` - Polish: ```POL``` - German: ```GER``` - Italian: ```ITA``` - Brazilian Portuguese: ```PBR``` - Portuguese: + ```POR``` @@ -122,60 +119,66 @@ slug: api-v1/post/inbound-number-update and transcript to this URL after the call completes. This can be useful if you want to have real time notifications when calls finish. - Set to `null` or an empty string to clear the webhook. +Set to `null` or an empty string to clear the webhook. + Give your agent the ability to transfer calls to a set of phone numbers. - Overrides `transfer_phone_number` if a `transfer_list.default` is specified. +Overrides `transfer_phone_number` if a `transfer_list.default` is specified. - Will default to `transfer_list.default`, or the chosen phone number. +Will default to `transfer_list.default`, or the chosen phone number. - Example usage to route calls to different departments: +Example usage to route calls to different departments: + +```json +"transfer_list": { + "default": "+12223334444", + "sales": "+12223334444", + "support": "+12223334444", + "billing": "+12223334444" +} +``` - ```json - "transfer_list": { - "default": "+12223334444", - "sales": "+12223334444", - "support": "+12223334444", - "billing": "+12223334444" - } - ``` Select a model to use for your call. - Options: `base`, `turbo` and `enhanced`. +Options: `base`, `turbo` and `enhanced`. - In nearly all cases, `enhanced` is the best choice for now. +In nearly all cases, `enhanced` is the best choice for now. - There are three different ways to use Bland: +There are three different ways to use Bland: - - `model: base` - - The original, follows scripts/procedures most effectively. - - Supports all features and capabilities. - - Best for Custom Tools - - - `model: enhanced` - - Much faster latency and very conversational, works best with objective-based prompts. - - Supports all features and capabilities. +- `model: base` - - `model: turbo` - - The absolute fastest latency possible, can be verbose at times - - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) - - Extremely realistic conversation capabilities + - The original, follows scripts/procedures most effectively. + - Supports all features and capabilities. + - Best for Custom Tools - - +- `model: enhanced` + + - Much faster latency and very conversational, works best with objective-based prompts. + - Supports all features and capabilities. + +- `model: turbo` + + - The absolute fastest latency possible, can be verbose at times + - Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools) + - Extremely realistic conversation capabilities + + + + A phone number that the agent can transfer to under specific conditions - such as being asked to speak to a human or supervisor. - Set to `null` to remove. +Set to `null` to remove. For best results: @@ -183,44 +186,51 @@ slug: api-v1/post/inbound-number-update - In the `task`, refer to the action solely as "transfer" or "transferring". - Alternate phrasing such as "swap" or "switch" can mislead the agent, causing the action to be ignored. + - To record your phone call, set `record` to true. When your call completes, you can access through the `recording_url` field in the call details or your webhook. + To record your phone call, set `record` to true. When your call completes, you can access through the `recording_url` + field in the call details or your webhook. A phrase that your call will start with instead of a generating one on the fly. This works both with and without `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters. - To remove, set to `null` or an empty string. +To remove, set to `null` or an empty string. + Interact with the real world through API calls. - Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) +Detailed tutorial here: [Custom Tools](../../tutorials/custom-tools.mdx) + - Integrate data from external APIs into your agent's knowledge. + Integrate data from external APIs into your agent's knowledge. - Set to `null` or an empty string to clear dynamic data settings. +Set to `null` or an empty string to clear dynamic data settings. + +Detailed usage in the [Send Call](calls.mdx) endpoint. - Detailed usage in the [Send Call](calls.mdx) endpoint. When you increase the interruption latency, you force the AI phone agent to listen longer before responding. In practice, increasing the threshold results in less interruptions and more latency. - Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted less frequently. +Try setting the threshold to `500` milliseconds. You'll encounter higher latency, but you'll be interrupted less frequently. + +Set to `null` to reset to default. - Set to `null` to reset to default. The maximum duration that calls to your agent can last before being automatically terminated. - Set to `null` to reset to default. +Set to `null` to reset to default. + ### Response @@ -238,35 +248,27 @@ slug: api-v1/post/inbound-number-update - If the update was unsuccessful, this will contain the settings that failed to update. Useful to determine how your request is being interpreted on our end. + If the update was unsuccessful, this will contain the settings that failed to update. Useful to determine how your + request is being interpreted on our end. ```json Response { - "status": "success", - "message": "Successfully updated number +18584139939.", - "updates": { - "prompt": "(Your prompt)", - "voice": "maya", - "webhook": null, - "first_sentence": "Roberta speaking, how can I help you?", - "record": false, - "max_duration": 30, - "model": "enhanced", - //... - } + "status": "success", + "message": "Successfully updated number +18584139939.", + "updates": { + "prompt": "(Your prompt)", + "voice": "maya", + "webhook": null, + "first_sentence": "Roberta speaking, how can I help you?", + "record": false, + "max_duration": 30, + "model": "enhanced" + //... + } } ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-purchase.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-purchase.mdx index 66c0318e35..af050d6c07 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-purchase.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/inbound-purchase.mdx @@ -16,30 +16,32 @@ slug: api-v1/post/inbound-purchase ### Body - Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact match if available. + Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact + match if available. - This defines how the AI will start the conversation, information available to - it, and its behaviors. Matches how the outbound `task` parameter functions. + This defines how the AI will start the conversation, information available to it, and its behaviors. Matches how the + outbound `task` parameter functions. Choose a country code for your phone number. - Options: `"US"` or `"CA"` for Canada. For others, please contact support. +Options: `"US"` or `"CA"` for Canada. For others, please contact support. + - The webhook should be a http / https callback url. We will send the call_id - and transcript to this URL after the call completes. This can be useful if you - want to have real time notifications when calls finish. + The webhook should be a http / https callback url. We will send the call_id and transcript to this URL after the call + completes. This can be useful if you want to have real time notifications when calls finish. Specify an exact phone number you'd like to use. If provided, will override the `area_code` parameter and does not fall back to any other number. - Example of the correct format (Note the `"+1"` is mandatory): `"+12223334444"` +Example of the correct format (Note the `"+1"` is mandatory): `"+12223334444"` + ### Response @@ -47,7 +49,8 @@ slug: api-v1/post/inbound-purchase The created phone number, will be in the following format: `+1XXXXXXXXXX` - Example: `+18582814611` +Example: `+18582814611` + @@ -59,12 +62,3 @@ slug: api-v1/post/inbound-purchase ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/outbound-purchase.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/outbound-purchase.mdx index b762beeca3..2df4623fe2 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/outbound-purchase.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/outbound-purchase.mdx @@ -16,7 +16,8 @@ slug: api-v1/post/outbound-purchase ### Body - Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact match if available. + Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact + match if available. ### Response @@ -24,7 +25,8 @@ slug: api-v1/post/outbound-purchase The created phone number, will be in the following format: `+1XXXXXXXXXX` - Example: `+18582814611` +Example: `+18582814611` + @@ -36,12 +38,3 @@ slug: api-v1/post/outbound-purchase ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-analyze.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-analyze.mdx index f50a45f221..4cb5d651e7 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-analyze.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-analyze.mdx @@ -12,43 +12,41 @@ slug: api-v1/post/sms-analyze ### Body - -An overarching goal for the information you want to extract from the SMS messages. + An overarching goal for the information you want to extract from the SMS messages. An array of questions that you want the AI to answer, along with their return types. For example: + ```json { - "answers": [ - [ "When does Bob want to move?", "time" ], - [ "Summarize the call.", "summary" ] - ] + "answers": [ + ["When does Bob want to move?", "time"], + ["Summarize the call.", "summary"] + ] } ``` + -The phone number that received the messages. + The phone number that received the messages. -The human/other phone number in the conversation. + The human/other phone number in the conversation. ```json Response { - "status": "success", - "message": "Successfully analyzed SMS messages.", - "answers": [ - "Bob prefers to have movers come in the morning.", - "..." - ] + "status": "success", + "message": "Successfully analyzed SMS messages.", + "answers": ["Bob prefers to have movers come in the morning.", "..."] } ``` diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-check-registration.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-check-registration.mdx index 99b9d43e31..d4f6dd4415 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-check-registration.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-check-registration.mdx @@ -14,10 +14,9 @@ slug: api-v1/post/sms-check-registration ### Body -The `registration_id` for the a2p registration. + The `registration_id` for the a2p registration. - ```json Response @@ -28,4 +27,4 @@ The `registration_id` for the a2p registration. } ``` - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-get-messages.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-get-messages.mdx index 05baf00313..8dee1eb64e 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-get-messages.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-get-messages.mdx @@ -17,11 +17,10 @@ slug: api-v1/post/sms-get-messages The `to` number in the conversation. This is the number you *do not* own. -The `from` number in the conversation. This is the number you *do* own. +The `from` number in the conversation. This is the number you *do* own. **Please note any ordering of numbers will work** - @@ -33,12 +32,3 @@ The `from` number in the conversation. This is the number you *do* own. ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-prompt-update.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-prompt-update.mdx index 373e699fc5..7713c49996 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-prompt-update.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-prompt-update.mdx @@ -12,17 +12,16 @@ slug: api-v1/post/sms-prompt-update ### Body - -The phone number to update. + The phone number to update. -The prompt for the AI to use when replying. + The prompt for the AI to use when replying. -Pass in an array of strings, that if present, the AI should not respond to. Set to `null` to disable. + Pass in an array of strings, that if present, the AI should not respond to. Set to `null` to disable. @@ -34,12 +33,3 @@ Pass in an array of strings, that if present, the AI should not respond to. Set ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-submit-reg.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-submit-reg.mdx index c4c3db0116..3584d37299 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-submit-reg.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-submit-reg.mdx @@ -12,7 +12,7 @@ slug: api-v1/post/sms-submit-reg This documentation provides detailed information on how to register an Application-to-Person (A2P) brand by making a POST request to our API. The process involves submitting your brand's details for registration and verification purposes. -A2P Registration is required for *all* businesses who wish to send SMS. There can be signifcant fines for any non compliant messages. A2P Registration can take 2 days -> 2 Weeks. +A2P Registration is required for _all_ businesses who wish to send SMS. There can be signifcant fines for any non compliant messages. A2P Registration can take 2 days -> 2 Weeks. ## Endpoint @@ -42,10 +42,11 @@ Your request should include a JSON body with the following parameters: - `trusted_user` (object): An object containing details about the trusted user registering the brand. Includes `position`, `last_name`, `phone_number`, `first_name`, and `email`. Ex. of trusted_user obj: -```json + +```json { "position": "CEO" //must be C Suite or VP, - "last_name":"Smith", + "last_name":"Smith", "first_name":"John" } ``` @@ -61,12 +62,11 @@ Our API provides detailed error messages to help you understand what went wrong A successful request returns a `200 OK` status code with a JSON body containing a message indicating the registration was successful and any relevant data or identifiers related to the A2P brand registration. -***Important**** The Brand Registration can take several attempts and days to weeks to complete. This success only indicates we *submitted* the registration correctly. - +**\*Important\*\*** The Brand Registration can take several attempts and days to weeks to complete. This success only indicates we _submitted_ the registration correctly. ```json { "message": "A2P Brand registration successful.", "data": {...} } -``` \ No newline at end of file +``` diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-toggle-human.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-toggle-human.mdx index 4e191912b5..a3c86027dd 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-toggle-human.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-toggle-human.mdx @@ -14,14 +14,15 @@ slug: api-v1/post/sms-toggle-human ### Body -The phone number to update. + The phone number to update. -Turn human mode on or off. +Turn human mode on or off. -`true` means that the AI will *not* reply. +`true` means that the AI will _not_ reply. `false` means the AI will reply + @@ -33,12 +34,3 @@ Turn human mode on or off. ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-webhook-update.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-webhook-update.mdx index db1761ad84..3445c3104f 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-webhook-update.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/sms-webhook-update.mdx @@ -13,11 +13,11 @@ slug: api-v1/post/sms-webhook-update ### Body -The phone number to update. + The phone number to update. -The webhook to fire when an SMS is received. + The webhook to fire when an SMS is received. @@ -29,12 +29,3 @@ The webhook to fire when an SMS is received. ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-disable.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-disable.mdx index 514b43af54..67c194236c 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-disable.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-disable.mdx @@ -16,24 +16,25 @@ slug: api-v1/post/subaccounts-id-disable ### Path Parameters - The unique identifier of the subaccount to which you want to transfer credits. + The unique identifier of the subaccount to which you want to transfer credits. ### Response + - Whether the subaccount was successfully disabled. + Whether the subaccount was successfully disabled. - The affected subaccount's unique identifier. + The affected subaccount's unique identifier. - The amount of credits transferred back to the parent account. + The amount of credits transferred back to the parent account. - The new balance of the parent account after the transfer. + The new balance of the parent account after the transfer. diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-rotate.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-rotate.mdx index 6b2d0a2af2..3fcacb17d9 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-rotate.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-rotate.mdx @@ -14,20 +14,21 @@ slug: api-v1/post/subaccounts-id-rotate ### Path Parameters - The unique identifier of the subaccount to which you want to transfer credits. + The unique identifier of the subaccount to which you want to transfer credits. ### Response + - Whether the subaccount creation succeeded. + Whether the subaccount creation succeeded. - The affected subaccount's unique identifier. + The affected subaccount's unique identifier. - The new API key for the subaccount. + The new API key for the subaccount. diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-transfer.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-transfer.mdx index 29e440bf86..de7574d33c 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-transfer.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts-id-transfer.mdx @@ -14,7 +14,7 @@ slug: api-v1/post/subaccounts-id-transfer ### Path Parameters - The unique identifier of the subaccount to which you want to transfer credits. + The unique identifier of the subaccount to which you want to transfer credits. ### Body @@ -23,19 +23,21 @@ slug: api-v1/post/subaccounts-id-transfer This many of your API credits will be transferred to the subaccount. The balance must be a positive integer that is at least 1, and less than your current account balance. + ### Response + - Whether the subaccount creation succeeded. + Whether the subaccount creation succeeded. - The new balance of your account after the transfer. + The new balance of your account after the transfer. - The new balance of the subaccount after the transfer. + The new balance of the subaccount after the transfer. diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts.mdx index a56839b917..fff14f6200 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/subaccounts.mdx @@ -21,14 +21,15 @@ slug: api-v1/post/subaccounts Special per-minute pricing plans carry over automatically to the subaccount, while increased rate limits do not. Unused credits can be reclaimed later with the subaccount's balance if needed. + - The first name of the user who will be using the subaccount. + The first name of the user who will be using the subaccount. - The last name of the user who will be using the subaccount. + The last name of the user who will be using the subaccount. @@ -37,15 +38,17 @@ slug: api-v1/post/subaccounts This enables you to set up credit card information, view and monitor usage, and further manage the subaccount as needed. The subaccount user will not be able to log into the Dev Portal unless you explicitly enable it by adding them as an Authorized User. + ### Response + - Whether the subaccount creation succeeded. + Whether the subaccount creation succeeded. - The unique identifier for the newly created subaccount. + The unique identifier for the newly created subaccount. @@ -54,6 +57,7 @@ slug: api-v1/post/subaccounts This is the only information that the subaccount user will need to start using the API. Do not use this as an identifier for the subaccount, since it can be rotated. + @@ -64,4 +68,4 @@ slug: api-v1/post/subaccounts "subaccount_key": "sub-sk-1234567890" } ``` - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools-tool-id.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools-tool-id.mdx index aeb4bc6419..e068e4af00 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools-tool-id.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools-tool-id.mdx @@ -12,8 +12,9 @@ slug: api-v1/post/tools-tool-id ### Path Parameters + - The ID of the Custom Tool you want to update. + The ID of the Custom Tool you want to update. ### Body @@ -38,8 +39,9 @@ slug: api-v1/post/tools-tool-id - `play` - `dial` - `hang` - + Choosing too similar of names to the default tools could cause the AI to select the wrong one, so decriptive two to three-word names are preferred. + @@ -52,6 +54,7 @@ slug: api-v1/post/tools-tool-id - `Press Buttons`: Presses buttons on phone. Each character is a different button. - `Wait`: Wait and go silent for an extended period of time (only use if absolutely necessary). - `Finish`: Say a goodbye message and end the call once completed. + @@ -64,44 +67,49 @@ slug: api-v1/post/tools-tool-id Special Note: You can have the AI dynamically generate speech by defining `input.speech` in the `input_schema`. + ```json - { - "input_schema": { - "example": { - "speech": "Checking your account details right now John!", - "name": "John Doe", - "email": "johndoe@gmail.com" - }, - "type": "object", - "properties": { - "speech": { - "type": "string" - }, - "name": { - "type": "string" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "required": ["speech", "name", "email"] - } - } +{ + "input_schema": { + "example": { + "speech": "Checking your account details right now John!", + "name": "John Doe", + "email": "johndoe@gmail.com" + }, + "type": "object", + "properties": { + "speech": { + "type": "string" + }, + "name": { + "type": "string" + }, + "email": { + "type": "string", + "format": "email" + } + }, + "required": ["speech", "name", "email"] + } +} ``` + + This is the endpoint of the external API that the tool will call. It must begin with `https://` and be a valid URL. + This is the HTTP method that the tool will use to call the external API. Valid options are `GET` and `POST`. + @@ -114,22 +122,25 @@ slug: api-v1/post/tools-tool-id Since prompt variables are supported, you can use them in the headers to send dynamic information to the external API. + ```json - // At the top level of your send call request you can define variables that you can access later using the double curly braces/dot syntax. +// At the top level of your send call request you can define variables that you can access later using the double curly braces/dot syntax. +{ + "request_data": { + "api_key": "sk-1234567890" + }, + "tools": [ { - "request_data": { - "api_key": "sk-1234567890", - }, - "tools": [ - { - "headers": { - "Authorization": "Bearer {{api_key}}" - } - } - ] + "headers": { + "Authorization": "Bearer {{api_key}}" + } } + ] +} ``` + + @@ -144,6 +155,7 @@ slug: api-v1/post/tools-tool-id Note: `GET` requests do not have a body. + ```json // AI-generated input is created as the `input` Prompt Variable - and the structure is defined by the input schema. // `input` will match the structure of `input_schema.example` if it is defined. @@ -160,7 +172,9 @@ slug: api-v1/post/tools-tool-id } } ``` + + @@ -173,16 +187,19 @@ slug: api-v1/post/tools-tool-id This is generally used with GET requests and built-in Prompt Variables like `"{{phone_number}}"` or `"{{call_id}}"`. + ```json - // appends ?pn={{phone_number}}&callId={{call_id}} to the URL - { - "query": { - "pn": "{{phone_number}}", - "callId": "{{call_id}}" - } - } +// appends ?pn={{phone_number}}&callId={{call_id}} to the URL +{ + "query": { + "pn": "{{phone_number}}", + "callId": "{{call_id}}" + } +} ``` + + @@ -209,34 +226,37 @@ slug: api-v1/post/tools-tool-id Agent input can be nested, and the will be transformed into JSON even if it's initially a string. + ```json - { - "input_schema": { - "example": { - "name": "John Doe", - "email": "johndoe@gmail.com" - }, - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "required": ["name", "email"] - }, - // both of these methods are identical, since {{input}} will be transformed into JSON - "body": "{{input}}", - "body": { - "name": "{{input.name}}", - "email": "{{input.email}}" - } - } +{ + "input_schema": { + "example": { + "name": "John Doe", + "email": "johndoe@gmail.com" + }, + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "email": { + "type": "string", + "format": "email" + } + }, + "required": ["name", "email"] + }, + // both of these methods are identical, since {{input}} will be transformed into JSON + "body": "{{input}}", + "body": { + "name": "{{input.name}}", + "email": "{{input.email}}" + } +} ``` + + @@ -247,6 +267,7 @@ slug: api-v1/post/tools-tool-id The path to the data you want must be in JSON Path format. Generally this means using dot notation to traverse the JSON object and is only required if you need to use that information on other tools or the response is too large. Example: + ```json // If the external API response is: { @@ -288,6 +309,7 @@ slug: api-v1/post/tools-tool-id "prompt": "The store is located at {{address_info.street}}, {{address_info.city}}, {{address_info.state}} {{zip_code}}." } ``` + @@ -298,11 +320,13 @@ slug: api-v1/post/tools-tool-id The default timeout is 10 seconds (10000 milliseconds). To always wait for a response, set the timeout to an extremely high value like 99999999. + ### Response + - Whether the tool creation succeeded. + Whether the tool creation succeeded. @@ -317,6 +341,7 @@ slug: api-v1/post/tools-tool-id ] } ``` + @@ -327,4 +352,3 @@ slug: api-v1/post/tools-tool-id } ``` - \ No newline at end of file diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools.mdx index 2faf45e84c..711a608537 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/tools.mdx @@ -33,8 +33,9 @@ slug: api-v1/post/tools - `play` - `dial` - `hang` - + Choosing too similar of names to the default tools could cause the AI to select the wrong one, so decriptive two to three-word names are preferred. + @@ -47,6 +48,7 @@ slug: api-v1/post/tools - `Press Buttons`: Presses buttons on phone. Each character is a different button. - `Wait`: Wait and go silent for an extended period of time (only use if absolutely necessary). - `Finish`: Say a goodbye message and end the call once completed. + @@ -59,44 +61,49 @@ slug: api-v1/post/tools Special Note: You can have the AI dynamically generate speech by defining `input.speech` in the `input_schema`. + ```json - { - "input_schema": { - "example": { - "speech": "Checking your account details right now John!", - "name": "John Doe", - "email": "johndoe@gmail.com" - }, - "type": "object", - "properties": { - "speech": { - "type": "string" - }, - "name": { - "type": "string" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "required": ["speech", "name", "email"] - } - } +{ + "input_schema": { + "example": { + "speech": "Checking your account details right now John!", + "name": "John Doe", + "email": "johndoe@gmail.com" + }, + "type": "object", + "properties": { + "speech": { + "type": "string" + }, + "name": { + "type": "string" + }, + "email": { + "type": "string", + "format": "email" + } + }, + "required": ["speech", "name", "email"] + } +} ``` + + This is the endpoint of the external API that the tool will call. It must begin with `https://` and be a valid URL. + This is the HTTP method that the tool will use to call the external API. Valid options are `GET` and `POST`. + @@ -109,22 +116,25 @@ slug: api-v1/post/tools Since prompt variables are supported, you can use them in the headers to send dynamic information to the external API. + ```json - // At the top level of your send call request you can define variables that you can access later using the double curly braces/dot syntax. +// At the top level of your send call request you can define variables that you can access later using the double curly braces/dot syntax. +{ + "request_data": { + "api_key": "sk-1234567890" + }, + "tools": [ { - "request_data": { - "api_key": "sk-1234567890", - }, - "tools": [ - { - "headers": { - "Authorization": "Bearer {{api_key}}" - } - } - ] + "headers": { + "Authorization": "Bearer {{api_key}}" + } } + ] +} ``` + + @@ -139,6 +149,7 @@ slug: api-v1/post/tools Note: `GET` requests do not have a body. + ```json // AI-generated input is created as the `input` Prompt Variable - and the structure is defined by the input schema. // `input` will match the structure of `input_schema.example` if it is defined. @@ -155,7 +166,9 @@ slug: api-v1/post/tools } } ``` + + @@ -168,16 +181,19 @@ slug: api-v1/post/tools This is generally used with GET requests and built-in Prompt Variables like `"{{phone_number}}"` or `"{{call_id}}"`. + ```json - // appends ?pn={{phone_number}}&callId={{call_id}} to the URL - { - "query": { - "pn": "{{phone_number}}", - "callId": "{{call_id}}" - } - } +// appends ?pn={{phone_number}}&callId={{call_id}} to the URL +{ + "query": { + "pn": "{{phone_number}}", + "callId": "{{call_id}}" + } +} ``` + + @@ -204,34 +220,37 @@ slug: api-v1/post/tools Agent input can be nested, and the will be transformed into JSON even if it's initially a string. + ```json - { - "input_schema": { - "example": { - "name": "John Doe", - "email": "johndoe@gmail.com" - }, - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "required": ["name", "email"] - }, - // both of these methods are identical, since {{input}} will be transformed into JSON - "body": "{{input}}", - "body": { - "name": "{{input.name}}", - "email": "{{input.email}}" - } - } +{ + "input_schema": { + "example": { + "name": "John Doe", + "email": "johndoe@gmail.com" + }, + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "email": { + "type": "string", + "format": "email" + } + }, + "required": ["name", "email"] + }, + // both of these methods are identical, since {{input}} will be transformed into JSON + "body": "{{input}}", + "body": { + "name": "{{input.name}}", + "email": "{{input.email}}" + } +} ``` + + @@ -242,6 +261,7 @@ slug: api-v1/post/tools The path to the data you want must be in JSON Path format. Generally this means using dot notation to traverse the JSON object and is only required if you need to use that information on other tools or the response is too large. Example: + ```json // If the external API response is: { @@ -283,6 +303,7 @@ slug: api-v1/post/tools "prompt": "The store is located at {{address_info.street}}, {{address_info.city}}, {{address_info.state}} {{zip_code}}." } ``` + @@ -293,11 +314,13 @@ slug: api-v1/post/tools The default timeout is 10 seconds (10000 milliseconds). To always wait for a response, set the timeout to an extremely high value like 99999999. + ### Response + - Whether the tool creation succeeded. + Whether the tool creation succeeded. @@ -312,6 +335,7 @@ slug: api-v1/post/tools ] } ``` + @@ -322,4 +346,3 @@ slug: api-v1/post/tools } ``` - \ No newline at end of file diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/voices-id-sample.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/voices-id-sample.mdx index c53a259cd0..10f6c37c0e 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/voices-id-sample.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/api-v1/post/voices-id-sample.mdx @@ -20,9 +20,10 @@ slug: api-v1/post/voices-id-sample ### Request Body - The text content to be spoken in the voice sample. + The text content to be spoken in the voice sample. + +Character limit: `200` characters. - Character limit: `200` characters. @@ -32,24 +33,14 @@ slug: api-v1/post/voices-id-sample The language of the text content. Default is `ENG`. - Some other language codes: "ESP", "GER", "FRE" +Some other language codes: "ESP", "GER", "FRE" + ### Response - The generated audio file of the spoken text using the specified or overridden voice preset settings. + The generated audio file of the spoken text using the specified or overridden voice preset settings. - -```json -(Generated audio file) -``` - - - - - - - - +```json (Generated audio file) ``` diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/development.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/development.mdx index 45b028f0f0..2a2834653f 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/development.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/development.mdx @@ -5,10 +5,7 @@ slug: development --- - - **Prerequisite** You should have installed Node.js (version 18.10.0 or - higher). - +**Prerequisite** You should have installed Node.js (version 18.10.0 or higher). Step 1. Install Mintlify on your OS: @@ -64,15 +61,12 @@ yarn global upgrade mintlify ## Deployment - - Unlimited editors available under the [Startup - Plan](https://mintlify.com/pricing) - +Unlimited editors available under the [Startup Plan](https://mintlify.com/pricing) You should see the following if the deploy successfully went through: - + ## Troubleshooting @@ -98,12 +92,3 @@ Repeat step 3. Curious about what changed in a CLI version? [Check out the CLI changelog.](/changelog/command-line) - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/enterprise-features/custom-twilio.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/enterprise-features/custom-twilio.mdx index b609121172..466694470e 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/enterprise-features/custom-twilio.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/enterprise-features/custom-twilio.mdx @@ -10,13 +10,14 @@ slug: enterprise-features/custom-twilio Enterprise customers can connect their own Twilio account to Bland. Easily bring over your existing phone numbers, integrations, and more. Pre-requisites: + - Your own Twilio account - An [Enterprise plan](https://forms.default.com/361589) with Bland ## Step 1: Creating an Encrypted Key with your Twilio Credentials 1. Go to your [Twilio Console](https://www.twilio.com/console) and get your Account SID and Auth Token. -2. Create an `encrypted_key` by [sending an API request](../api-v1/post/accounts.mdx) to Bland. +2. Create an `encrypted_key` by [sending an API request](../api-v1/post/accounts.mdx) to Bland. This is the only time that your `encrypted_key` will be returned to you. Make sure to store it securely, and new keys will need to be generated if lost. @@ -28,12 +29,13 @@ For example: ```json { - "Authorization": "BLAND_API_KEY", - "encrypted_key": "YOUR_ENCRYPTED_KEY" + "Authorization": "BLAND_API_KEY", + "encrypted_key": "YOUR_ENCRYPTED_KEY" } ``` -Note: +Note: + - You can set your `from` number in the API request - this will need to be a number owned by that Twilio account (and not one purchased through Bland). - By default, we'll send calls from a randomly selected number in the specified Twilio account if a `from` is not specified. @@ -48,4 +50,4 @@ We'll validate that these numbers are owned by that account and add them to your Note: When updating inbound numbers, the headers need to include the `encrypted_key` in addition to the `Authorization` header. Doing so makes sure the updates are applied to the correct Twilio account. -Once you update an inbound number through the [Dev Portal](https://app.bland.ai) or [API](../api-v1/post/inbound-number-update.mdx), that number will be automatically configured to run on Bland's infrastructure. No additional steps are required! \ No newline at end of file +Once you update an inbound number through the [Dev Portal](https://app.bland.ai) or [API](../api-v1/post/inbound-number-update.mdx), that number will be automatically configured to run on Bland's infrastructure. No additional steps are required! diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/code.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/code.mdx index 42fa072526..3f8f9749d9 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/code.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/code.mdx @@ -36,12 +36,3 @@ class HelloWorld { } ``` ```` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/images.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/images.mdx index d3aa23514a..ae81f98b4d 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/images.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/images.mdx @@ -5,10 +5,7 @@ slug: essentials/images --- - + ## Image @@ -40,7 +37,7 @@ To get more customizability with images, you can also use [embeds](/writing-cont frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen - style={{ width: '100%', borderRadius: '0.5rem' }} + style={{ width: "100%", borderRadius: "0.5rem" }} >
@@ -58,12 +55,3 @@ Loads another HTML page within the document. Most commonly used for embedding vi ```html ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/markdown.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/markdown.mdx index 4cfed0a950..eba6554033 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/markdown.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/markdown.mdx @@ -87,12 +87,3 @@ Mintlify supports [LaTeX](https://www.latex-project.org) through the Latex compo ```md 8 x (vk x H1 - H2) = (0,1) ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/navigation.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/navigation.mdx index 04a9a98964..3e5fb8d30d 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/navigation.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/navigation.mdx @@ -67,12 +67,3 @@ You cannot use `api` for the name of a folder unless you nest it inside another ## Hidden Pages MDX files not included in `mint.json` will not show up in the sidebar but are accessible through the search bar and by linking directly to them. - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/settings.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/settings.mdx index b2922f455c..9c466cf2eb 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/settings.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/essentials/settings.mdx @@ -60,12 +60,11 @@ Example: `mintlify` Hex color codes for your global theme - The primary color. Used for most often for highlighted content, section - headers, accents, in light mode + The primary color. Used for most often for highlighted content, section headers, accents, in light mode - The primary color for dark mode. Used for most often for highlighted - content, section headers, accents, in dark mode + The primary color for dark mode. Used for most often for highlighted content, section headers, accents, in dark + mode The primary color for important buttons @@ -117,8 +116,8 @@ Example: `mintlify` - Array of version names. Only use this if you want to show different versions - of docs with a dropdown in the navigation bar. + Array of version names. Only use this if you want to show different versions of docs with a dropdown in the navigation + bar. @@ -175,8 +174,8 @@ Example: `mintlify` The name of the tab label. - The start of the URL that marks what pages go in the tab. Generally, this - is the name of the folder you put your pages in. + The start of the URL that marks what pages go in the tab. Generally, this is the name of the folder you put your + pages in. @@ -316,15 +315,6 @@ Example: `mintlify` - A background image to be displayed behind every page. See example with - [Infisical](https://infisical.com/docs) and [FRPC](https://frpc.io). + A background image to be displayed behind every page. See example with [Infisical](https://infisical.com/docs) and + [FRPC](https://frpc.io). - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/examples/call.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/examples/call.mdx index f86a329eb6..1127883336 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/examples/call.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/examples/call.mdx @@ -5,31 +5,30 @@ slug: examples/call --- - + ## Introduction + Imagine you're selling a service, online. Your website contains a contact form where potential customers can request a demo. You know deals will close way more often if you call leads within 5 minutes of their form submission. Unfortunately, you don't have enough hands on deck to make those calls yourself, so you've decided to automate those calls with an AI voice agent. In this example, we'll show you how to call your inbound leads with a personalized prompt. Let's get started! ## Prompt for the phone call + Your phone call prompt should be written as a [template string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals) (a string that you can pass variables to). That way, you can insert the data captured from the form into your prompt. Here's what your prompt should look like (before you insert the data from the form). -Your name is Matt, and you're an AI phone agent from Acme Inc. Whenever an inbound lead visits your website, you call them within five minutes. You're direct in your manner of speech. You never repeat yourself. You follow your script as tightly as possible to keep the call on track. +Your name is Matt, and you're an AI phone agent from Acme Inc. Whenever an inbound lead visits your website, you call them within five minutes. You're direct in your manner of speech. You never repeat yourself. You follow your script as tightly as possible to keep the call on track. Here's how the typical phone call progresses: + 1. You introduce yourself 2. You ask qualification customers based on the customer type (startup, small business, enterprise) 3. If the customer is qualified, you explain that you'll text them a scheduling link right after the call 4. You end the phone call - **Example dialogue** You: Hello! @@ -71,6 +70,7 @@ Person: Yes, that works for me. You: Fantastic, I'll text you the link right away. Thanks for your time, `${first_name}`. We look forward to potentially working with you. Person: Thank you, Matt. Looking forward to it. + Did you notice how detailed the prompt is? It provides so much context, and explains what character the AI phone agent is playing, why it's playing it, how it should speak, how the call should progress, and even provides an example dialogue. @@ -78,9 +78,10 @@ Did you notice how detailed the prompt is? It provides so much context, and expl Now, check out what the prompt looks like after we insert the form variables. -Your name is Matt, and you're an AI phone agent from Acme Inc. Whenever an inbound lead visits your website, you call them within five minutes. You're direct in your manner of speech. You never repeat yourself. You follow your script as tightly as possible to keep the call on track. +Your name is Matt, and you're an AI phone agent from Acme Inc. Whenever an inbound lead visits your website, you call them within five minutes. You're direct in your manner of speech. You never repeat yourself. You follow your script as tightly as possible to keep the call on track. Here's how the typical phone call progresses: + 1. You introduce yourself 2. You ask qualification customers based on the customer type (startup, small business, enterprise) 3. If the customer is qualified, you explain that you'll text them a scheduling link right after the call @@ -127,6 +128,7 @@ Person: Yes, that works for me. You: Fantastic, I'll text you the link right away. Thanks for your time, Jordan. We look forward to potentially working with you. Person: Thank you, Matt. Looking forward to it. + ## Customizing the phone agent @@ -142,11 +144,3 @@ For clarity's sake, we'll include those in our code example anyone. The code example is present on the right hand section of this page. You can copy it, either in Javascript or Python. Have additional questions? Want to see other use cases? Join our [discord community](https://discord.gg/QvxDz8zcKe)! - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/quickstart.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/quickstart.mdx index f8bacb5726..8faa8e1cc4 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/quickstart.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/quickstart.mdx @@ -13,20 +13,16 @@ Learn how to update your docs locally and and deploy them to the public. - During the onboarding process, we created a repository on your Github with - your docs content. You can find this repository on our - [dashboard](https://dashboard.mintlify.com). To clone the repository - locally, follow these - [instructions](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) - in your terminal. + During the onboarding process, we created a repository on your Github with your docs content. You can find this + repository on our [dashboard](https://dashboard.mintlify.com). To clone the repository locally, follow these + [instructions](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) in + your terminal. - Previewing helps you make sure your changes look as intended. We built a - command line interface to render these changes locally. 1. Install the - [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview the - documentation changes locally with this command: ``` npm i -g mintlify ``` - 2. Run the following command at the root of your documentation (where - `mint.json` is): ``` mintlify dev ``` + Previewing helps you make sure your changes look as intended. We built a command line interface to render these + changes locally. 1. Install the [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview the documentation + changes locally with this command: ``` npm i -g mintlify ``` 2. Run the following command at the root of your + documentation (where `mint.json` is): ``` mintlify dev ``` @@ -35,18 +31,15 @@ Learn how to update your docs locally and and deploy them to the public. - Our Github app automatically deploys your changes to your docs site, so you - don't need to manage deployments yourself. You can find the link to install on - your [dashboard](https://dashboard.mintlify.com). Once the bot has been - successfully installed, there should be a check mark next to the commit hash - of the repo. + Our Github app automatically deploys your changes to your docs site, so you don't need to manage deployments yourself. + You can find the link to install on your [dashboard](https://dashboard.mintlify.com). Once the bot has been + successfully installed, there should be a check mark next to the commit hash of the repo. [Commit and push your changes to - Git](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) - for your changes to update in your docs site. If you push and don't see that - the Github app successfully deployed your changes, you can also manually - update your docs through our [dashboard](https://dashboard.mintlify.com). + Git](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository#about-git-push) for your + changes to update in your docs site. If you push and don't see that the Github app successfully deployed your changes, + you can also manually update your docs through our [dashboard](https://dashboard.mintlify.com). @@ -61,37 +54,16 @@ Add content directly in your files with MDX syntax and React components. You can Add flair to your docs with personalized branding. - + Implement your OpenAPI spec and enable API user interaction. - + Draw insights from user interactions with your documentation. - + Keep your docs on your own website's subdomain. - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/starter-guide.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/starter-guide.mdx index 29230a633e..ba70eebb35 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/starter-guide.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/starter-guide.mdx @@ -6,13 +6,15 @@ slug: starter-guide ## Creating a developer account + -To get started, sign up on the developer portal. +To get started, sign up on the developer portal. Enter your phone number and verification code. Finally, once your developer portal loads, go to the `Send phone call` page. ## Sending your first phone call + Although Bland is an API-first platform, the send phone call page provides a simple interface for quickly testing calls. On the left side you can adjust the call options and on the right hand side you can see how the code updates. @@ -20,20 +22,21 @@ Although Bland is an API-first platform, the send phone call page provides a sim Once you're satisfied with a call, copy the code on the right side (in Javascript, Python, or cURL) and add it to your application. - - In the `Phone Number` field, enter your own phone number. - + In the `Phone Number` field, enter your own phone number. - For the task box either select one of the example prompts or write your own. For more instrucionts about prompting your AI phone agent, read this blog post. + For the task box either select one of the example prompts or write your own. For more instrucionts about prompting + your AI phone agent, read this blog post. - Scroll to the bottom of the page, and press the `Send call` button. Note, calls are charged at $0.12/minute, billed to the exact second. + Scroll to the bottom of the page, and press the `Send call` button. Note, calls are charged at $0.12/minute, billed + to the exact second. To send a phone call programatically, read the API reference. ## Testing your phone agent + Once you've sent your first phone call, the next step is to test and improve the outputs from your phone agent. @@ -45,17 +48,18 @@ One way to test your agent is to send yourself test calls. A faster way, however Select the model and language and insert your current prompt into the task box. - Start messaging your phone agent. Act like you're the person receiving the call, and purposefully ask edge-case questions to throw the phone agent off. - - - Based on the responses you receive, update the instructions in the prompt. + Start messaging your phone agent. Act like you're the person receiving the call, and purposefully ask edge-case + questions to throw the phone agent off. + Based on the responses you receive, update the instructions in the prompt. ## Next steps + You now know how to send and test phone calls, but you've only scratched the surface of Bland's capabilties. Areas for further exploration: + Read the API reference. @@ -70,4 +74,3 @@ Areas for further exploration: See what people are building on Bland and get support from other users. - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/custom-tools.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/custom-tools.mdx index e4b4b86d7e..6e139477fc 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/custom-tools.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/custom-tools.mdx @@ -8,6 +8,7 @@ slug: tutorials/custom-tools ## Introduction Custom tools allow your agent to interact with any web API mid-call. Do things like: + Dispatch SMS or emails using the person's contact info. @@ -24,6 +25,7 @@ Custom tools allow your agent to interact with any web API mid-call. Do things l ## Background + To understand how custom tools work, let's take a peek under the hood of the Bland AI phone agent. During the conversation, the phone agent is constantly listening to figure out when it's supposed to respond. When the phone agent realizes it's time to respond, it reviews the tools in its toolbox and picks between them. @@ -31,6 +33,7 @@ During the conversation, the phone agent is constantly listening to figure out w Those tools include a `speak`, `wait`, and `button press` tool. When you create a custom tool, you add it to the existing 'toolbox' for the phone agent to pick from. A few natural questions arise: + 1. How do I define my custom tool? 2. How do I make sure my tool gets picked at the right time? 3. How does information from the call get passed to my custom tool's API request? @@ -42,6 +45,7 @@ Keep reading to find out. # Creating your custom tool ## Defining the API request + Imagine you're creating an AI phone agent to take restaurant orders. You want your phone agent to have the ability to place orders, by pinging your backend API. Here's what that request might look like: @@ -74,6 +78,7 @@ Here's what that request might look like: ## From API request to custom tool The next step is to convert the API request into a custom tool. Custom tools have the following properties: + - `name` - the agent will see this in the list of tools - `description` - a short explanation of what the tool does - `input_schema` - a JSON schema describing the input data @@ -81,11 +86,13 @@ The next step is to convert the API request into a custom tool. Custom tools hav - `response_data` - An array of objects that describe how to extract data from the response. Within the response data, you can create variables that the phone agent can reference in its prompt. ### Name & Description + The agent will see the name in the list of tools. The name, plus the description, help the AI phone agent when it decides which tool to use. For this example we'll set the name to `PlaceOrder`, and the description to `Places the final order for the drive thru`. ### Input Schema + The input schema is critical. It defines the shape of the API request, the different inputs the request can take, and also includes an example (which helps our system when creating requests). Here's what the input schema could look like: @@ -151,12 +158,14 @@ Here's what the input schema could look like: ``` Two important notes about input schema: + 1. `input_schema` is converted into the variable `"{{input}}"` that you can use in the request body/query/headers 2. To access nested properties, use dot notation: `"{{input.property.subproperty}}"` Scroll down to see the full example. ### Speech + Because requesting external APIs might take a while, we enable you to define a `speech` property. The phone agent will say the `speech` while it makes the request. An example speech might look like: `Perfect, I'll schedule that right now, give me just a second.` @@ -164,6 +173,7 @@ An example speech might look like: `Perfect, I'll schedule that right now, give For the restaurant ordering example, the speech could be `Thank you, placing that order now.` ### Response data + Once your API request comes back, you need to extract the response data, and then make the phone agent aware of the new information. The `data` field determines how you extract the data while the `name` field determines the variable name for reference in the prompt. @@ -185,103 +195,85 @@ Below is the entire API request for sending a phone call using the outlined cust ```json { - "phone_number": "...", - // note that the returned value ({{order_price}}) in the task is populated only after the tool is run - "task": "You are taking a drive thru order from a customer. Find out everything that they want like a drive thru cashier. Continue until they say they're done. Repeat the full order back to them after that, and ask if that's correct. If they confirm that it's correct, then and only then will you place their order using the PlaceOrder tool. After you place it, tell them their order total and to pull forward. Their order price is {{order_price}}", - "first_sentence": "Hi, what can I get started for you today?", - "request_data": { - "menu": { - "burger": [ - "patties" - ], - "fry": [ - "size" - ], - "shake": [ - "flavor", - "size" - ] - } - }, - "tools": [ - { - "name": "PlaceOrder", - "description": "Places the final order for the drive thru.", - "speech": "Thank you, placing that order now.", - "input_schema": { - "example": { - "items": [ - { - "name": "burger", - "patties": 2, - "quantity": 3 - }, - { - "name": "fry", - "size": "lg", - "quantity": 2 - } - ] - }, - "type": "object", - "properties": { - "items": { - "type": "array", - "items": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "patties": { - "type": "integer" - }, - "size": { - "type": "string", - "enum": [ - "sm", - "md", - "lg" - ] - }, - "flavor": { - "type": "string", - "enum": [ - "chocolate", - "strawberry", - "vanilla" - ], - "default": "vanilla" - }, - "quantity": { - "type": "integer" - } - }, - "required": [ - "name", - "quantity" - ] - } - } - } - }, - "url": "https://api.your-restaurant.com/orders", - "method": "POST", - "headers": { - "Content-Type": "application/json", - "Authorization": "Bearer ..." - }, - "body": { - "items": "{{input.items}}" + "phone_number": "...", + // note that the returned value ({{order_price}}) in the task is populated only after the tool is run + "task": "You are taking a drive thru order from a customer. Find out everything that they want like a drive thru cashier. Continue until they say they're done. Repeat the full order back to them after that, and ask if that's correct. If they confirm that it's correct, then and only then will you place their order using the PlaceOrder tool. After you place it, tell them their order total and to pull forward. Their order price is {{order_price}}", + "first_sentence": "Hi, what can I get started for you today?", + "request_data": { + "menu": { + "burger": ["patties"], + "fry": ["size"], + "shake": ["flavor", "size"] + } + }, + "tools": [ + { + "name": "PlaceOrder", + "description": "Places the final order for the drive thru.", + "speech": "Thank you, placing that order now.", + "input_schema": { + "example": { + "items": [ + { + "name": "burger", + "patties": 2, + "quantity": 3 }, - "response_data": [ - { - "name": "order_price", - "data": "$.price" + { + "name": "fry", + "size": "lg", + "quantity": 2 + } + ] + }, + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "patties": { + "type": "integer" + }, + "size": { + "type": "string", + "enum": ["sm", "md", "lg"] + }, + "flavor": { + "type": "string", + "enum": ["chocolate", "strawberry", "vanilla"], + "default": "vanilla" + }, + "quantity": { + "type": "integer" } - ] + }, + "required": ["name", "quantity"] + } + } } - ] + }, + "url": "https://api.your-restaurant.com/orders", + "method": "POST", + "headers": { + "Content-Type": "application/json", + "Authorization": "Bearer ..." + }, + "body": { + "items": "{{input.items}}" + }, + "response_data": [ + { + "name": "order_price", + "data": "$.price" + } + ] + } + ] } ``` @@ -294,27 +286,32 @@ Below is the entire API request for sending a phone call using the outlined cust Then the phone agent extracts the information from the transcript and passes it to the request body. You can improve the accuracy of the input data by creating a very clear `input_schema`. That includes providing a detailed `example` within. - - - The phone agent looks at the tool's name and description. Then it looks at the current context of the conversation to decide whether using the tool makes sense. +{" "} + + + The phone agent looks at the tool's name and description. Then it looks at the current context of the conversation to + decide whether using the tool makes sense. + + When the API response from the custom tool comes back, you can extract the API response and create variables. You can do this within the `response_data` property. Once you've given the variable a `name`, you can reference it in the prompt using double brackets (`{{}}`). Note, with the current setup, you might reference variables that have null values. Here's the restaurant example prompt: - + You are taking a drive thru order from a customer. Find out everything that they want like a drive thru cashier. Continue until they say they're done. Repeat the full order back to them after that, and ask if that's correct. If they confirm that it's correct, then and only then will you place their order using the PlaceOrder tool. After you place it, tell them their order total and to pull forward. Their order price is `{{order_price}}` - - In the above prompt, the `order_price` will be null until the data comes back. That's okay though. The prompt is structured to first take the order, then use the PlaceOrder tool, and then finally respond with the order price. + + In the above prompt, the `order_price` will be null until the data comes back. That's okay though. The prompt is structured to first take the order, then use the PlaceOrder tool, and then finally respond with the order price. By the time the phone agent is asked for the order price, it will have the information. Custom tools will continue getting more robust, to further prevent scenarios where variables without value from being referenced in prompts. + -If you have any additional questions, reach out at hello@bland.ai and one of our engineers will help. \ No newline at end of file +If you have any additional questions, reach out at hello@bland.ai and one of our engineers will help. diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/dynamic-data.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/dynamic-data.mdx index d7a02b61f1..d55a9b1f41 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/dynamic-data.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/dynamic-data.mdx @@ -10,6 +10,7 @@ slug: tutorials/dynamic-data With Dynamic Data, you can make external API requests at the start and throughout your phone call. This allows you to load data from your database, or from any other API. You can then use that data in your AI responses, or to define circumstantial behavior for each call. Some examples of what Dynamic Data enables: + - Maintain conversation history between calls - Define behavior based on the user's location - Handle real-time data like status updates or prices @@ -73,7 +74,7 @@ Here's how to make an [Inbound Agent](../api-v1/post/inbound-number-update.mdx) ] }, { - // Helpful tip for debugging: + // Helpful tip for debugging: // You can send the data to a webhook to see what it looks like "url": "https://webhook.site/...", "method": "POST", @@ -97,6 +98,7 @@ Here's how to make an [Inbound Agent](../api-v1/post/inbound-number-update.mdx) We'll cover the following features in this section: + - System variables - External API requests - Extracting data from responses @@ -110,6 +112,7 @@ Variables are defined with double curly braces, like `{{variable}}`. System vari Note: Variables are NOT case sensitive, and outer spaces are trimmed automatically. Base variables: + - `{{phone_number}}` - Always the other party's number - `{{country}}` - The country code (ex. US) - `{{state}}` - The state or province's abbreviation (ex. CA for California) @@ -127,7 +130,7 @@ Variables can be used mid-sentence, like this: ```json { - "task": "... Today is {{now}} ..." + "task": "... Today is {{now}} ..." } ``` @@ -155,16 +158,11 @@ Here's a simple request that can be used to load public data about the current p ``` -- `timeout` - The maximum number of milliseconds to wait for a response. - - Default: `2000` -- `method` - The HTTP method to use. - - Defaults to `GET`, otherwise `POST` is allowed. -- `headers` - An object of headers to send with the request. -- `body` - The body of the request. Only used if `method` is `POST`. -- `response_data` - An array of objects that define how to extract data from the response. - - See the next section for more details. -- `cache` - Whether to store the response, or refresh that data before each AI response. - - Defaults to `true`. + - `timeout` - The maximum number of milliseconds to wait for a response. - Default: `2000` - `method` - The HTTP + method to use. - Defaults to `GET`, otherwise `POST` is allowed. - `headers` - An object of headers to send with the + request. - `body` - The body of the request. Only used if `method` is `POST`. - `response_data` - An array of objects + that define how to extract data from the response. - See the next section for more details. - `cache` - Whether to + store the response, or refresh that data before each AI response. - Defaults to `true`. ## Extracting Data from Responses @@ -173,20 +171,20 @@ Rather than using the full response, you can extract specific data from the resp ```json { - "bpi": { - "USD": { - "code": "USD", - "rate": "9,000.00", - "description": "United States Dollar", - "rate_float": 9000 - }, - "GBP": { - "code": "GBP", - "rate": "6,000.00", - "description": "British Pound Sterling", - "rate_float": 6000 - } + "bpi": { + "USD": { + "code": "USD", + "rate": "9,000.00", + "description": "United States Dollar", + "rate_float": 9000 + }, + "GBP": { + "code": "GBP", + "rate": "6,000.00", + "description": "British Pound Sterling", + "rate_float": 6000 } + } } ``` @@ -194,10 +192,9 @@ Then `$.bpi.USD.rate` would return `9,000.00`. More complex filters can be used if they follow the [JSONPath format](https://docs.hevodata.com/sources/engg-analytics/streaming/rest-api/writing-jsonpath-expressions). - ## Variables as Parameters -Once defined with `response_data`, variables can be used nearly anywhere. +Once defined with `response_data`, variables can be used nearly anywhere. - In the `task` or `prompt` parameters - In the `context` parameter of `response_data` @@ -215,70 +212,59 @@ For this example, imagine a delivery service that offers instant checkout for cu ```json { - "dynamic_data": [ + "dynamic_data": [ + { + "url": "https://api.restaurant.com/customers", + "method": "GET", + "headers": { + "authorization": "ExtremelySecureCredentials" + }, + "query": { + "phone_number": "{{phone_number}}" + }, + "response_data": [ { - "url": "https://api.restaurant.com/customers", - "method": "GET", - "headers": { - "authorization": "ExtremelySecureCredentials" - }, - "query": { - "phone_number": "{{phone_number}}" - }, - "response_data": [ - { - "name": "member_id", - "data": "$.customer.member_id" - } - ] - }, - //... - ] + "name": "member_id", + "data": "$.customer.member_id" + } + ] + } + //... + ] } ``` We just created that `{{member_id}}` variable - now we can use it in the next request. -This delivery service also can be called to check on an order status. +This delivery service also can be called to check on an order status. Note a difference: The `cache` parameter is set to `false`, so if the order status changes during the call, the agent will immediately know about it and be able to inform the customer. ```json { - "dynamic_data": [ - //... + "dynamic_data": [ + //... + { + "url": "https://api.restaurant.com/orders", + "method": "GET", + "cache": false, + "headers": { + "authorization": "ExtremelySecureCredentials" + }, + "query": { + "member_id": "{{member_id}}" + }, + "response_data": [ { - "url": "https://api.restaurant.com/orders", - "method": "GET", - "cache": false, - "headers": { - "authorization": "ExtremelySecureCredentials" - }, - "query": { - "member_id": "{{member_id}}" - }, - "response_data": [ - { - "name": "order_id", - "data": "$.orders[0].id" - }, - { - "name": "order_status", - "data": "$.orders[0].status" - } - ] + "name": "order_id", + "data": "$.orders[0].id" + }, + { + "name": "order_status", + "data": "$.orders[0].status" } - ] + ] + } + ] } ``` - - - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/live-transfer.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/live-transfer.mdx index 71e3654cf0..dd4df6e3dc 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/live-transfer.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/live-transfer.mdx @@ -83,12 +83,3 @@ response = requests.post('https://api.bland.ai/v1/calls', json=data, headers=hea ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/max-duration.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/max-duration.mdx index 91a9608fd5..d882c59118 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/max-duration.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/max-duration.mdx @@ -85,12 +85,3 @@ response = requests.post('https://api.bland.ai/v1/calls', json=data, headers=hea ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/pathways.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/pathways.mdx index 9d3c1e6905..6b69ff95f8 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/pathways.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/pathways.mdx @@ -9,13 +9,14 @@ slug: tutorials/pathways [Template Pathway Video Tutorial](https://www.loom.com/share/be9d6f1072ae4267abc0717e36e66078?sid=82a7843f-9e7c-457a-8f7b-4d8ca026e1ff) - ## Introduction Conversational pathways are our new way of prompting Bland that has led to major breakthroughs in realism. + - Give your agent instructions on how it should respond at specific points of the conversation. Choose between prompting or fixed sentences. + Give your agent instructions on how it should respond at specific points of the conversation. Choose between + prompting or fixed sentences. Execute webhooks at any point during the conversation, and send speech during/after the webhook. @@ -54,7 +55,6 @@ In order to instruct the agent when to take this pathway, you would click on the And there you have it! You have now created a pathway from one node to another, and instructed the agent when to take this pathway. You can connect as many nodes as you want in this manner, and create as many pathways as you want. In order to create a new Node, press the 'Add new Node' button at the top-left of the screen. - # How the Pathways Agent Works The agent starts at the first node, and then moves to the next node based on the pathway that the agent decides to take. The agent will then execute the instructions in the node as dialogue, and then move on to the next node based on the pathway that the agent decides to take. This process will continue until the agent decides to end the call. @@ -63,7 +63,7 @@ The agent will make decisions based on the labels you put in the pathways, when -For Example, +For Example, In this example, at the node named 'Ask for reservation info', the node asks for the user's reservation information. Based on the user's response, the agent will then move on to the next node based on the labels you put in the pathways. For the current node, it will check if the user has provided reservation information where the number of guests is either less than 8 or more than 8. If the user has provided reservation information where the number of guests is less than 8, the agent will move on to the node named 'Reservation booking'. If the user has provided reservation information where the number of guests is more than 8, the agent will move on to the node named 'Transfer Call'. The agent will then execute the instructions in the node as dialogue, and then move on to the next node based on the pathway that the agent decides to take. And the process repeats! @@ -77,29 +77,28 @@ This helps you to ensure that the user provides the necessary information before - ## Global Nodes -Global Nodes take precendence over the condition decisions made by the agent. You can treat a global node as a node, that every other node in the pathway has a pathway to, with the label as the 'Global Pathway Label'. +Global Nodes take precendence over the condition decisions made by the agent. You can treat a global node as a node, that every other node in the pathway has a pathway to, with the label as the 'Global Pathway Label'. Using the Reservation Booking Example, if the user were to ask a question like 'What are the opening hours of the restaurant' when the agent is at the 'Ask for reservation info' node, the condition decision would not be met as the user did not provide the date, time, and number of guests for the reservation. However, the pathway label would be 'user has a question about the restaurant's hours or location', which links to a Global Node. As Global Nodes take precedence over the condition decision, the agent would then move to the 'Global Node' named 'Restaurant Questions' and provide the user with the opening hours of the restaurant. After providing the user with the opening hours of the restaurant, the agent would then automatically return to the 'Ask for reservation info' node, and continue with the flow of the conversation. This helps you to handle edge cases where the user might ask a question that is not related to the current conversation, and allows you to provide the user with the information they need, before returning to the conversation. -Tip: The variables `{{lastUserMessage}}` and `{{prevNodePrompt}}` can be used in the Global Node to provide the agent with context on what the user said, and steering the conversation back to its own original goal. +Tip: The variables `{{lastUserMessage}}` and `{{prevNodePrompt}}` can be used in the Global Node to provide the agent with context on what the user said, and steering the conversation back to its own original goal. -You are to answer any questions the user has, to the best of your knowledge. If you do not know the answer, simply say 'I don't have that information at that moment'. Do not make up any information/facts about the appointment. +You are to answer any questions the user has, to the best of your knowledge. If you do not know the answer, simply say 'I don't have that information at that moment'. Do not make up any information/facts about the appointment. After you answer the question, you are to direct the conversation back to your initial goal, which was as follows: Previous Goal: `{{prevNodePrompt}}` -If you deem the goal as achieved, you can simply ask the user 'So, shall we proceed?' . If the goal has not been achieved, you are to steer the conversation back to achieve your goal. -If you deem the goal as achieved, simply confirm the result with the user. If the goal has not been achieved, you are to steer the conversation back to achieve your goal. +If you deem the goal as achieved, you can simply ask the user 'So, shall we proceed?' . If the goal has not been achieved, you are to steer the conversation back to achieve your goal. +If you deem the goal as achieved, simply confirm the result with the user. If the goal has not been achieved, you are to steer the conversation back to achieve your goal. ``` Examples @@ -109,73 +108,71 @@ user: what day is it today? assistant: The day today is April 15th. So, what date works for you? -- --- +-- assistant: what date works for you? user: probably tomorrow, what time does the clinic open? assistant: The clinic opens at 9am. So, do you want to schedule for tomorrow? --- +-- ``` + - # Node Types - There are currently 6 different types of Nodes -- Default + +- Default - Webhook - Knowledge Base -- End Call +- End Call - Transfer Call - Wait for Response You can select the type of node you want by clicking on the dropdown of `Node Type`. - ## Base/Default Node (Important!) The default node provides the ability to generate a response to the user. This functionality is exposed to all other nodes as well. You can either: -- Use the `Prompt` field to give instructions on what the agent should do at this point in the conversation. This is the recommended way to generate responses as it makes the conversation more human and natural. -- Enable the 'Static Text' toggle to provide a fixed response, and the agent will always say the same thing at this point in the conversation. +- Use the `Prompt` field to give instructions on what the agent should do at this point in the conversation. This is the recommended way to generate responses as it makes the conversation more human and natural. +- Enable the 'Static Text' toggle to provide a fixed response, and the agent will always say the same thing at this point in the conversation. ### Optional Decision Guide -The optional decision guide is only to be used if your phone agent currently is not going down the correct pathway. We do not expect this to happen often, but still want to provide you the tools to handle these issues if they arise. +The optional decision guide is only to be used if your phone agent currently is not going down the correct pathway. We do not expect this to happen often, but still want to provide you the tools to handle these issues if they arise. It is a way to provide the phone agent with example scenarios of what the user might say, and what pathway the agent should take in response. You would put in examples of what the user might say in the `User Input` field, and then in the `Pathway` field, you would provide the pathway the agent should take in response. -### Condition +### Condition -The condition is a way to provide the agent with a condition that must be met in order for the agent to move on to the next node. If the condition is not met, the agent will stay on the same node and ensure the condition is met until the condition is fulfilled. +The condition is a way to provide the agent with a condition that must be met in order for the agent to move on to the next node. If the condition is not met, the agent will stay on the same node and ensure the condition is met until the condition is fulfilled. ### Global Nodes -Each node can be configured to be a Global Node. Global Nodes are nodes that are accessible by every other node in the Conversational Pathway. This means that it has an implicit pathway to every other node, and the label would be the 'Global Label'. +Each node can be configured to be a Global Node. Global Nodes are nodes that are accessible by every other node in the Conversational Pathway. This means that it has an implicit pathway to every other node, and the label would be the 'Global Label'. After entering a Global Node, the agent will execute the instructions inside the Global Node, and then automatically return to the node it was at before entering the Global Node, so it can continue with the flow of the conversation. -In a Global Node, you can also forward the agent to another node, by toggling the 'Enable Forwarding', which will allow you to select the node you want to move the agent to. This is useful if you want to move the agent to a existing node for a certain scenario, which could happen at any point in the conversation. +In a Global Node, you can also forward the agent to another node, by toggling the 'Enable Forwarding', which will allow you to select the node you want to move the agent to. This is useful if you want to move the agent to a existing node for a certain scenario, which could happen at any point in the conversation. ## Transfer Call Node -The transfer call node is used to transfer the call to another number when the node is reached, and the dialogue at this node is complete. +The transfer call node is used to transfer the call to another number when the node is reached, and the dialogue at this node is complete. -As such, you may have the agent say any final words before the call is transferred. +As such, you may have the agent say any final words before the call is transferred. - ## End Call Node The end call node will end the call when the node is reached, and the dialogue at this node is complete. @@ -188,7 +185,7 @@ As such, you may have the agent say any final words before the call is ended. The knowledge base node is used to connect your agent to a knowledge base, to answer any questions the user has. -Paste in any text in the 'Knowledge Base' field, and the agent will search through the knowledge base to answer the user. +Paste in any text in the 'Knowledge Base' field, and the agent will search through the knowledge base to answer the user. Coming soon - PDF Upload/Vector Database Integrations... @@ -198,7 +195,6 @@ Coming soon - PDF Upload/Vector Database Integrations... The Wait for Response Node works the same way as the Default Node, except it is also equipped with the ability to wait if the user requires time to respond or needs to hold for a moment. - ## Webhook Node The webhook node is used to execute webhooks at any point during the conversation, and send speech during/after the webhook. @@ -209,7 +205,6 @@ Similar to how the dialogue is handled in all other nodes, you can control the d Variables received from the webhook can be used in the dialogue as well, as shown in the example below. - # Global Prompt for all Nodes @@ -230,9 +225,7 @@ You can test the responses from your pathway agent by clicking on the 'Chat with - - -# Variables Reference/ Extraction +# Variables Reference/ Extraction ## Variables @@ -247,10 +240,9 @@ Some examples of variables that you can access at each node: - `{{to}}` - The phone number the call is to - `{{call_id}}` - The unique identifier for the call - ## Extracting Variables from Call/User Response -At each node, you can also extract variables from the user's response using the `Extract Variables from Call Info` field. You would put in the name of the variable you want to extract, the type of the variable (integer, string, boolean), and the description for what information you want the variable to store. You can also provide specific formats you expect and examples in the description. The more descriptive it is, the better the agent will be at extracting the variable more accurately. +At each node, you can also extract variables from the user's response using the `Extract Variables from Call Info` field. You would put in the name of the variable you want to extract, the type of the variable (integer, string, boolean), and the description for what information you want the variable to store. You can also provide specific formats you expect and examples in the description. The more descriptive it is, the better the agent will be at extracting the variable more accurately. Do note that when enable variable extraction, and wanting to reference the variable in the subsequent nodes, it would introduce slight latency as the agent would have to extract the variable from the user's response before generating the dialogue for the next node. @@ -262,7 +254,7 @@ For Example, the image below shows how the Webhook Node is set up to extract the # Fine Tuning the Pathway agent -While Conversational Pathways gives you a lot greater control compared to the regular call agent, hallucinations can still occur, or the agent might make wrong decisions in the pathway. However, we have provided you with the tools to handle these issues if they arise. Each node can be fine-tuned on the decision it makes, as well as the expected dialogue it generates, allowing you to handle even the most extreme edge cases that might arise easily. +While Conversational Pathways gives you a lot greater control compared to the regular call agent, hallucinations can still occur, or the agent might make wrong decisions in the pathway. However, we have provided you with the tools to handle these issues if they arise. Each node can be fine-tuned on the decision it makes, as well as the expected dialogue it generates, allowing you to handle even the most extreme edge cases that might arise easily. ### Steps to Fine-Tuning the agent @@ -280,12 +272,11 @@ Upon saving your changes, you will be able to see the fine-tuning data in the no Do note that the decisions for the condition and pathway chosen is made by the node the agent is currently at, and the dialogue is generated by the node which the agent decides to take the pathway to. -For Example, +For Example, If the agent is at Node 1, and the agent decides that the condition is achieved, and decides to take the pathway to Node 2, the dialogue generated will be from Node 2, and the decisions for the condition and pathway chosen will be from Node 1. As such, the training data for the condition and pathway chosen will be stored in Node 1, and amendments to the dialogue generated will be stored in Node 2. - # Quick Start with Tutorial / Templates To immediately start playing around with Conversational Pathways, you can use one of our templates. Visit the Conversational Pathways page on our Dev Portal, and duplicate the 'Restaurant Reservation' Template, and run through the agent to see how it works! @@ -295,6 +286,4 @@ We have also created a video walkthrough of that template to help you get starte Create a pathway now! Click [here](https://app.bland.ai/dashboard?page=convo-pathways) to get started! - If you have any additional questions, reach out on our [Discord](https://discord.gg/QvxDz8zcKe) and one of our engineers will help. - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-1000-calls-at-once.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-1000-calls-at-once.mdx index 2b57f58e4f..ae85560473 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-1000-calls-at-once.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-1000-calls-at-once.mdx @@ -87,8 +87,7 @@ const headers = { // Data const data = { - base_prompt: - "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.", + base_prompt: "You are calling {{business}} to renew their subscription to {{service}} before it expires on {{date}}.", call_data: [ { phone_number: "1234567890", @@ -115,12 +114,3 @@ await axios.post("https://api.bland.ai/v1/batches", data, { headers }); ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-first-call.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-first-call.mdx index 8efea0fc3e..7127b68870 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-first-call.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/send-first-call.mdx @@ -108,12 +108,3 @@ response = requests.post('https://api.bland.ai/v1/calls', json=data, headers=hea ``` - - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhook-signing.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhook-signing.mdx index b464966708..83176a4885 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhook-signing.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhook-signing.mdx @@ -21,32 +21,25 @@ To verify a webhook, you need to calculate the HMAC signature of the request bod Note that you must first create a webhook signing secret in the [Account Settings in the Dev Portal](https://app.bland.ai/dashboard?page=settings). Here is an example of how to verify a webhook in Node.js: + ```javascript -const crypto = require('node:crypto'); +const crypto = require("node:crypto"); function verifyWebhookSignature(key, data, signature) { + const expectedSignature = crypto.createHmac("sha256", key).update(data).digest("hex"); - const expectedSignature = crypto.createHmac('sha256', key) - .update(data) - .digest('hex'); - - return expectedSignature === signature; + return expectedSignature === signature; } //... -app.post('/webhook', (req, res) => { - const isValid = verifyWebhookSignature( - process.env.WEBHOOK_SECRET, - JSON.stringify(req.body), - req.headers['x-webhook-signature'] - ); +app.post("/webhook", (req, res) => { + const isValid = verifyWebhookSignature( + process.env.WEBHOOK_SECRET, + JSON.stringify(req.body), + req.headers["x-webhook-signature"], + ); - //... + //... }); ``` - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhooks.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhooks.mdx index 2cbd004178..996e4702ba 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhooks.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/tutorials/webhooks.mdx @@ -49,11 +49,3 @@ To test for outbound calls, once again create your webhook by referring back to Then, follow the [send phone call docs](https://docs.bland.ai/api-v1/post/calls) to create and send a phone call. Make sure you include the `webhook` as a parameter in your request. After, confirm that the webhook data populated on your webhook site page. And again, if you encounter issues, jump into [discord](https://discord.gg/QvxDz8zcKe) and message us - we will help asap. - - - - - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/bland/fern/welcome-to-bland.mdx b/clis/docs-migrator/src/__test__/outputs/bland/fern/welcome-to-bland.mdx index 3ddcd36fc6..26287abac4 100644 --- a/clis/docs-migrator/src/__test__/outputs/bland/fern/welcome-to-bland.mdx +++ b/clis/docs-migrator/src/__test__/outputs/bland/fern/welcome-to-bland.mdx @@ -7,11 +7,13 @@ slug: welcome-to-bland Bland is a platform for AI phone calling. Using our API, you can easily send or receive phone calls with a programmable voice agent. We really care about making our phone calls... + 1. **Fast**: sub-second latency from person speaking to AI responding. 2. **Reliable**: it's our responsibility, day in and day out, to make sure your phone calls work. No exceptions. 3. **Ultra flexible**: configure all aspects of your agent's behavior, by settings it's voice, creating transfer scenarios, configuring the initial greeting, etc. # What you can do with Bland + Dispatch AI phone calls to call customers, leads, and to streamline operations. @@ -34,6 +36,7 @@ We really care about making our phone calls... # Getting started + Read the API reference. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/README.md b/clis/docs-migrator/src/__test__/outputs/zep/fern/README.md index c89c478d15..cfed42991b 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/README.md +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/README.md @@ -24,7 +24,7 @@ mintlify dev ### Publishing Changes -Install our Github App to autopropagate changes from youre repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard. +Install our Github App to autopropagate changes from youre repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard. #### Troubleshooting diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/memories.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/memories.mdx index 99c6730e15..f7bc734572 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/memories.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/memories.mdx @@ -16,6 +16,7 @@ slug: chat-history-memory/memories The Memory and Summary are returned with UUIDs, token counts, timestamps, and other metadata. Memories are associated with [Sessions](sessions.mdx) in a many-to-one relationship. + ## Persisting a Memory to a Session @@ -31,6 +32,7 @@ Sessions are created automatically when adding Memories. If the `SessionID` is a upserted into the Session. [Manually creating a session](sessions.mdx) can be useful if you want to associate it with a user or add metadata. + @@ -60,37 +62,43 @@ messages = [Message(role=m["role"], content=m["content"], metadata=m.get("metada memory = Memory(messages=messages) result = client.memory.add_memory(session_id, memory) ``` + ```typescript import { ZepClient, Message, Memory } from "@getzep/zep-js"; -import * as uuid from 'uuid'; +import * as uuid from "uuid"; -const API_KEY = "" +const API_KEY = ""; const zepClient = await ZepClient.init(process.env.ZEP_API_KEY); const session_id: string = uuid.v4(); // A new session identifier const history: { role: string; content: string; metadata?: { [key: string]: any } }[] = [ - { "role": "Jane", "role_type": "user", "content": "Who was Octavia Butler?" }, - { "role": "HistoryBot", "role_type": "assistant", "content": "Octavia Estelle Butler (June 22, 1947 – February 24, 2006) was an American science fiction author." }, - { "role": "Jane", "role_type": "user", "content": "Which books of hers were made into movies?", "metadata": { "foo": "bar" } }, + { role: "Jane", role_type: "user", content: "Who was Octavia Butler?" }, + { + role: "HistoryBot", + role_type: "assistant", + content: "Octavia Estelle Butler (June 22, 1947 – February 24, 2006) was an American science fiction author.", + }, + { role: "Jane", role_type: "user", content: "Which books of hers were made into movies?", metadata: { foo: "bar" } }, ]; -const messages: Message[] = history.map(m => new Message({ role: m.role, content: m.content, metadata: m.metadata })); +const messages: Message[] = history.map((m) => new Message({ role: m.role, content: m.content, metadata: m.metadata })); const memory: Memory = new Memory({ messages }); const result = client.memory.addMemory(session_id, memory); ``` + - ## Getting a Session's Memory Read more about the difference between [Perpetual and Message Window Buffer Memory](/chat-history-memory). ### Perpetual Memory + The example below uses Zep's async API and a context manager. You may also use the sync API's `client.memory.get_memory` method and use the `client` outside of a context manager. @@ -113,16 +121,16 @@ async with ZepClient(api_key=api_key) as client: ```typescript const client = await ZepClient.init(api_key); try { - const memory = await client.memory.getMemory(session_id, "perpetual"); - for (const message of memory.messages) { - console.log(message.toDict()); - } + const memory = await client.memory.getMemory(session_id, "perpetual"); + for (const message of memory.messages) { + console.log(message.toDict()); + } } catch (error) { - if (error instanceof NotFoundError) { - console.log("Memory not found"); - } else { - throw error; - } + if (error instanceof NotFoundError) { + console.log("Memory not found"); + } else { + throw error; + } } ``` @@ -165,23 +173,25 @@ async with ZepClient(api_key) as client: except NotFoundError: print("Memory not found") ``` + ```typescript const client = await ZepClient.init(api_key); try { - const memory = await client.memory.getMemory(session_id, "message_window"); - for (const message of memory.messages) { - console.log(message.toDict()); - } + const memory = await client.memory.getMemory(session_id, "message_window"); + for (const message of memory.messages) { + console.log(message.toDict()); + } } catch (error) { - if (error instanceof NotFoundError) { - console.log("Memory not found"); - } else { - throw error; - } + if (error instanceof NotFoundError) { + console.log("Memory not found"); + } else { + throw error; + } } ``` + - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/messages.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/messages.mdx index b6f7b25676..4fd6e5f9b1 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/messages.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/messages.mdx @@ -2,12 +2,9 @@ slug: chat-history-memory/messages --- - -Messages are the individual components of a conversation, each linked to a [Session](sessions.mdx) in a many-to-one relationship. -To incorporate messages into sessions, utilize the [Memories](memories.mdx) feature. + + Messages are the individual components of a conversation, each linked to a [Session](sessions.mdx) in a many-to-one + relationship. To incorporate messages into sessions, utilize the [Memories](memories.mdx) feature. ## Get a Specific Message from a Session @@ -36,17 +33,17 @@ async with ZepClient(api_key=api_key) as client: const client: ZepClient = await ZepClient.init(api_key); try { - const session_id: string = "3e0e4af9-71ff-4541-b206-6133574bbbc6"; // Replace with the actual session_id - const message_id: string = "3e0e4af9-71ff-4541-b206-6133574bbbc7"; // Replace with the actual message_id + const session_id: string = "3e0e4af9-71ff-4541-b206-6133574bbbc6"; // Replace with the actual session_id + const message_id: string = "3e0e4af9-71ff-4541-b206-6133574bbbc7"; // Replace with the actual message_id - const message: Message = await client.message.getSessionMessage(session_id, message_id); - console.log(message); + const message: Message = await client.message.getSessionMessage(session_id, message_id); + console.log(message); } catch (error) { - if (error instanceof NotFoundError) { - console.log("Message not found"); - } else { - throw error; - } + if (error instanceof NotFoundError) { + console.log("Message not found"); + } else { + throw error; + } } ``` @@ -85,6 +82,7 @@ async with ZepClient(api_key) as client: except NotFoundError: print("Sesssion not found") ``` + @@ -92,18 +90,19 @@ async with ZepClient(api_key) as client: const client: ZepClient = await ZepClient.init(api_key); try { - const messages: Message[] = await client.message.getSessionMessages(session_id); - messages.forEach((message: Message) => { - console.log(message); - }); + const messages: Message[] = await client.message.getSessionMessages(session_id); + messages.forEach((message: Message) => { + console.log(message); + }); } catch (error) { - if (error instanceof NotFoundError) { - console.log("Message not found"); - } else { - throw error; - } + if (error instanceof NotFoundError) { + console.log("Message not found"); + } else { + throw error; + } } ``` + @@ -134,7 +133,7 @@ try { You have the ability to modify the metadata of a message. Please provide the metadata in the following format. Note that at this time, it's not possible to update the content of a message itself. -```json +```json { "metadata": { "foo": "bar" @@ -160,6 +159,7 @@ async with ZepClient(api_key) as client: except NotFoundError: print("Session not found") ``` + @@ -167,14 +167,15 @@ async with ZepClient(api_key) as client: const client: ZepClient = await ZepClient.init(api_key); try { - const session_id: string = "3e0e4af9-71ff-4541-b206-6133574bbbc6"; // Replace with the actual session_id - const message_uuid: string = "3e0e4af9-71ff-4541-b206-6133574bbbc7"; // Replace with the actual message_id - const metadata: any = { metadata: { foo: "bar" } }; // Replace with the desired metadata - await client.message.updateSessionMessageMetadata(session_id, message_uuid, metadata); + const session_id: string = "3e0e4af9-71ff-4541-b206-6133574bbbc6"; // Replace with the actual session_id + const message_uuid: string = "3e0e4af9-71ff-4541-b206-6133574bbbc7"; // Replace with the actual message_id + const metadata: any = { metadata: { foo: "bar" } }; // Replace with the desired metadata + await client.message.updateSessionMessageMetadata(session_id, message_uuid, metadata); } catch (error) { - console.error("Session not found", error); + console.error("Session not found", error); } ``` + @@ -195,4 +196,3 @@ try { } } ``` - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/overview.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/overview.mdx index bb12665e4a..76377a725f 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/overview.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/overview.mdx @@ -15,17 +15,17 @@ Zep offers several approaches to populating prompts with context from historical ## Perpetual Memory Perpetual Memory is the default memory type. Salient facts from the dialog are extracted and stored in a `Fact Table`. This -is updated in real-time as new messages are added to the Session. +is updated in real-time as new messages are added to the Session. Every time you call the Memory API to get a Memory, Zep returns the Fact Table, the most recent messages (per your `Message Window` setting), and a summary of the most recent messages prior to the `Message Window`. -We've found that including the combination of the Fact Table, summary, and the most recent messages in a prompts provides both factual +We've found that including the combination of the Fact Table, summary, and the most recent messages in a prompts provides both factual context and nuance to the LLM. - Perpetual Memory + Perpetual Memory ## Summary Retriever Memory @@ -40,7 +40,8 @@ You don't need to do anything to enable this feature, beyond adding messages to calling the `get_memory` API and requesting the `perpetual` `memory_type`. -Want to learn more about how Summary Retriever works? [Read How Perpetual Memory Works](#how-summary-retriever-memory-works). + Want to learn more about how Summary Retriever works? [Read How Perpetual Memory + Works](#how-summary-retriever-memory-works). ## Message Window Buffer Memory @@ -60,7 +61,7 @@ This is ongoing, ensuring that the entire conversation is incrementally summariz These summaries are also embedded, enabling vector similarity search over the entire series of conversation summaries. - Summary Retriever Flow Chart + Summary Retriever Flow Chart Every time you call the Memory API to get a Memory, Zep uses a proprietary, low-latency language model to generate a @@ -74,4 +75,4 @@ low-latency summarization model. The resulting summary and most recent messages populating your prompt. The entire process takes hundreds of milliseconds, so that you're able to rapidly populate your prompt with relevant -context. \ No newline at end of file +context. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/search.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/search.mdx index d1997dff20..5f02afdef5 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/search.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/search.mdx @@ -30,6 +30,7 @@ of both. Memory search also supports querying by message creation date. Read more about [constructing search queries](/working-with-search#maximal-marginal-relevance-re-ranking). + @@ -60,32 +61,33 @@ for search_result in search_results: # print(search_result.messsage.dict()) print(search_result.summary.dict()) ``` + ```typescript -import { MemorySearchPayload, ZepClient } from '@getzep/zep-js'; - +import { MemorySearchPayload, ZepClient } from "@getzep/zep-js"; // This uniquely identifies the user's session const session_id: string = "my_session_id"; // Initialize the Zep client before running this code const search_payload: MemorySearchPayload = { - text: "Is Lauren Olamina a character in a book?", - search_scope: "summary", // This could be messages or summary - search_type: "mmr", // Remove this if you'd prefer not to rerank results - mmr_lambda: 0.5, // Tune diversity vs relevance + text: "Is Lauren Olamina a character in a book?", + search_scope: "summary", // This could be messages or summary + search_type: "mmr", // Remove this if you'd prefer not to rerank results + mmr_lambda: 0.5, // Tune diversity vs relevance }; const search_results = await client.memory.searchMemory(session_id, search_payload); search_results.forEach((search_result) => { - // Uncomment for message search - // console.log(search_result.message); - console.log(search_result.summary); + // Uncomment for message search + // console.log(search_result.message); + console.log(search_result.summary); }); ``` + @@ -121,25 +123,22 @@ zep_client.memory.search_memory( ), ) ``` + ```typescript -await client.memory.searchMemory( - session_id, - { - query: "I enjoy reading science fiction.", - metadata: { - where: { jsonpath: '$[*] ? (@.foo == "bar")' }, - }, - } -); +await client.memory.searchMemory(session_id, { + query: "I enjoy reading science fiction.", + metadata: { + where: { jsonpath: '$[*] ? (@.foo == "bar")' }, + }, +}); ``` + - - ```json { "dist": 0.7170433826192629, @@ -193,5 +192,5 @@ Zep can return all messages from a search up to a certain row limit. This limit Searching through chat histories can be tricky. Chat messages are often brief and might not carry much "information". When these short texts are turned into high-dimensional embedding vectors, the result can be very sparse vectors. This sparsity means a lot of these vectors end up being close to each other in the vector space, which can lead to a higher chance of getting false positives in your search results for relevant messages. As a result, we recommend searching over Summaries, which include more information than Messages. - + diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/sessions.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/sessions.mdx index dae919edd6..81e50a717b 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/sessions.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/sessions.mdx @@ -10,6 +10,7 @@ associated with it. The `SessionID` is a string key that accepts arbitrary identifiers. Related data you'd like to store can be persisted as metadata. + ## Adding a Session @@ -23,34 +24,37 @@ conversation a user might have with your app Sessions are created automatically when adding Memories. If the SessionID already exists, then the Memory is upserted into the Session. Manually creating a session can be useful if you want to associate it with a user or add metadata. + -```python +```python async with ZepClient(api_key=api_key) as client: session_id = uuid.uuid4().hex # A new session identifier session = Session( - session_id=session_id, + session_id=session_id, user_id=user_id, # Optionally associate this session with a user metadata={"foo" : "bar"} ) await client.memory.aadd_session(session) ``` + -```typescript +```typescript const client: ZepClient = await ZepClient.init(api_key); const session_id: string = uuid.v4(); // Generate a new session identifier const session: Session = new Session({ - session_id, - user_id: user.user_id, // Optionally associate this session with a user - metadata: { "foo": "bar" }, + session_id, + user_id: user.user_id, // Optionally associate this session with a user + metadata: { foo: "bar" }, }); await client.memory.addSession(session); ``` + @@ -60,6 +64,7 @@ await client.memory.addSession(session); You can update a session's metadata by providing a Session object with new metadata. Note that metadata is merged, so any existing metadata will be preserved. + @@ -74,8 +79,8 @@ await client.memory.aupdate_session(session) ```typescript const session: Session = new Session({ - session_id, - metadata: { "qax": "baz" }, + session_id, + metadata: { qax: "baz" }, }); await client.memory.updateSession(session); ``` @@ -84,6 +89,7 @@ await client.memory.updateSession(session); ## Getting a Session + @@ -92,6 +98,7 @@ await client.memory.updateSession(session); session = await client.memory.aget_session(session_id) print(session.dict()) ``` + @@ -99,11 +106,10 @@ print(session.dict()) const session = await client.memory.getSession(session_id); console.log(session); ``` + - - ## Deleting a Session Deleting a Session soft-deletes the Session and all associated Memories. The Session and Memories are still available in @@ -120,17 +126,17 @@ Soft-deleted data is hard-deleted periodically. ```python await client.memory.adelete_memory(session_id) ``` + ```typescript -await client.memory.deleteMemory(session_id) +await client.memory.deleteMemory(session_id); ``` + - - ## Listing Sessions You can list all Sessions in the Zep Memory Store with optional limit and cursor parameters for pagination. We also @@ -152,6 +158,7 @@ for session_chunk in all_sessions: for session in session_chunk: print(session) ``` + @@ -159,15 +166,15 @@ for session_chunk in all_sessions: // List the first 10 Sessions const sessions: Session[] = await client.memory.listSessions(10, 0); console.log("First 10 Sessions:"); -sessions.forEach(session => console.log(session)); +sessions.forEach((session) => console.log(session)); // List All Sessions using a generator console.log("All Sessions:"); const allSessionsGenerator = client.memory.listSessionsChunked(100); for await (const sessionChunk of allSessionsGenerator) { - sessionChunk.forEach(session => console.log(session)); + sessionChunk.forEach((session) => console.log(session)); } ``` + - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/summaries.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/summaries.mdx index 1f104e9fea..e0d95937ed 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/summaries.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/chat-history-memory/summaries.mdx @@ -7,17 +7,16 @@ configured `Message Window` for your [Zep Project](/getting-started/projects). The first summary is generated after the first `N` messages are added to a Session. - - **Summaries are generated asynchronously.** Zep uses a proprietary, low-latency summarization model to generate dialog summaries asynchronously. This means that summary generation does not delay your requests to retrieve Memories from Zep. + - List of Summaries + List of Summaries ## Accessing Summaries @@ -34,5 +33,3 @@ search and includes this summary in your Memory request. Zep automatically determines which summary to add to a response based on your configured `Message Window` and the number of messages in the Session. - - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/dialog-classification.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/dialog-classification.mdx index 17c375c757..4587468446 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/dialog-classification.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/dialog-classification.mdx @@ -5,55 +5,40 @@ slug: dialog-classification -Zep enables you to classify Sessions into various categories and save these classifications in the Session's metadata. -This feature is handy for directing Sessions to appropriate agents or for monitoring the kinds of interactions users have with your Assistant. -Classifications are processed in just a few hundred milliseconds, allowing them to run synchronously with the chat loop. + Zep enables you to classify Sessions into various categories and save these classifications in the Session's metadata. + This feature is handy for directing Sessions to appropriate agents or for monitoring the kinds of interactions users + have with your Assistant. Classifications are processed in just a few hundred milliseconds, allowing them to run + synchronously with the chat loop. ## Classifying Sessions -A classification task consists of a topic and a list of classes. -The `topic` is the type of classification you want to perform, and the `classes` are the possible categories you want to classify the Session into. +A classification task consists of a topic and a list of classes. +The `topic` is the type of classification you want to perform, and the `classes` are the possible categories you want to classify the Session into. The `topic` is only used as a name or label for the classification task and does not affect the classification itself. -You may optionally specify the number of previous messages to consider when classifying the Session (default `4`), and whether to persist the classification in the Session's metadata (default `True`). +You may optionally specify the number of previous messages to consider when classifying the Session (default `4`), and whether to persist the classification in the Session's metadata (default `True`). - - ```python - classes = ["class1", "class2", ..., "other"] - classification = client.memory.classify_session( - session_id, - "topic", - classes, - last_n=4, - persist=True - ) - ``` - - - ```typescript - const classes = ["class1", "class2", ..., "other"] - const classification = await client.memory.classifySession( - session_id, - "topic", - classes, - 4, // lastN - true // persist - ) - ``` - + + ```python classes = ["class1", "class2", ..., "other"] classification = client.memory.classify_session( session_id, + "topic", classes, last_n=4, persist=True ) ``` + + + ```typescript const classes = ["class1", "class2", ..., "other"] const classification = await + client.memory.classifySession( session_id, "topic", classes, 4, // lastN true // persist ) ``` + The returned result will be one of the classes you provided, or "other" if none of the classes are a good fit. The classification result is also stored in the Session's metadata if `persist` is `True`. ```json -{"system":{"classes":{"topic":"travel"}}} +{ "system": { "classes": { "topic": "travel" } } } ``` And Sessions viewed in the Zep app will be labeled with the classification result. - Classifier Metadata Image + Classifier Metadata Image ### Adding Custom Instruction @@ -61,33 +46,20 @@ And Sessions viewed in the Zep app will be labeled with the classification resul You may optionally provide a custom instruction to the classification task. This instruction will be injected into the Dialog Classification Prompt. You may want to use this option if you have specific guidelines that you want to communicate to the LLM in addition to our classification prompt. + - - ```python - classes = ["advanced", "beginner", ..., "dojo"] - classification = client.memory.classify_session( - session_id, - "experience level", - classes, - instruction="Classify the user's experience level. You may classify experience as 'dojo' only if the user is a black belt." - ) - ``` - - - ```typescript - const classes = ["advanced", "beginner", ..., "dojo"] - const classification = await client.memory.classifySession( - session_id, - "experience level", - classes, - "Classify the user's experience level. You may classify experience as 'dojo' only if the user is a black belt." - ) - ``` - + + ```python classes = ["advanced", "beginner", ..., "dojo"] classification = client.memory.classify_session( + session_id, "experience level", classes, instruction="Classify the user's experience level. You may classify + experience as 'dojo' only if the user is a black belt." ) ``` + + + ```typescript const classes = ["advanced", "beginner", ..., "dojo"] const classification = await + client.memory.classifySession( session_id, "experience level", classes, "Classify the user's experience level. You + may classify experience as 'dojo' only if the user is a black belt." ) ``` + - - ### Building a Semantic Router with User Intent Zep's Session Classifier can be used to build a semantic router that routes user sessions to different agents or chains based on the user's intent. @@ -120,13 +92,15 @@ user: Hello, my phone isn't responding to touch. "has payment question", "other" ] + const classification = await client.memory.classifySession( - session_id, "intent", classes - ) +session_id, "intent", classes +) console.log(classification.class) ``` + ```Text "needs support" @@ -134,44 +108,29 @@ const classification = await client.memory.classifySession( ### A High-Performance Tool Picker -Using an agent to pick tools can often be slow and inaccurate. Zep's Session Classifier allows you to pick tools at very low latency +Using an agent to pick tools can often be slow and inaccurate. Zep's Session Classifier allows you to pick tools at very low latency and high accuracy. You may then instruct an LLM to use the selected tool and provided Session information. ```Text user: What is the capital of France? ``` + - - ```python - classes = [ - "complete math problems using a calculator", - "research topics or find information with a web search", - "no matching tool", - ] - classification = client.memory.classify_session( - session_id, "tool", classes - ) - ``` - - - ```typescript - const classes = [ - "complete math problems using a calculator", - "research topics or find information with a web search", - "no matching tool", - ] - const classification = await client.memory.classifySession( - session_id, "tool", classes - ) - ``` - + + ```python classes = [ "complete math problems using a calculator", "research topics or find information with a web + search", "no matching tool", ] classification = client.memory.classify_session( session_id, "tool", classes ) ``` + + + ```typescript const classes = [ "complete math problems using a calculator", "research topics or find information + with a web search", "no matching tool", ] const classification = await client.memory.classifySession( session_id, + "tool", classes ) ``` + ```Text "research topics or find information with a web search" ``` - ### Classifying Emotions Zep's Session Classifier can be used to classify user emotions and store these classifications in the Session's metadata. @@ -180,39 +139,16 @@ Zep's Session Classifier can be used to classify user emotions and store these c AI: We're unfortunately going to reschedule your appointment. user: Is that entirely necessary? I'm very busy. ``` + - - ```python - classes = [ - "happy", - "sad", - "frustrated", - "angry", - "other" - ] - classification = client.memory.classify_session( - session_id, - "emotion", - classes - ) - ``` - - - ```typescript - const classes = [ - "happy", - "sad", - "frustrated", - "angry", - "other" - ] - classification = await client.memory.classifySession( - session_id, - "emotion", - classes - ) - ``` - + + ```python classes = [ "happy", "sad", "frustrated", "angry", "other" ] classification = + client.memory.classify_session( session_id, "emotion", classes ) ``` + + + ```typescript const classes = [ "happy", "sad", "frustrated", "angry", "other" ] classification = await + client.memory.classifySession( session_id, "emotion", classes ) ``` + ```Text @@ -227,8 +163,8 @@ Zep supports executing multiple classification tasks against a Session, allowing { "system": { "classes": { - "topic": "travel", - "intent": "needs support", + "topic": "travel", + "intent": "needs support", "emotion": "frustrated" } } @@ -241,4 +177,4 @@ Zep supports executing multiple classification tasks against a Session, allowing 2. **Ensure your classes are well separated**: If your classes are too similar, the classifier will have a hard time distinguishing between them. 3. **Provide a "none", "other", or "unknown" class**: If none of the classes are a good fit, the classifier should be able to select an option that indicates this. 4. **Limit the number of previous messages**: The more messages you consider, the longer the classification will take. Additionally, the context may change through the conversation. Recommendation: no more than the prior 4 to 6 messages. -5. **Persist the classification**: If you want to use the classification result in the future, you should persist the classification in the Session's metadata. This is the default. \ No newline at end of file +5. **Persist the classification**: If you want to use the classification result in the future, you should persist the classification in the Session's metadata. This is the default. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/document-collections.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/document-collections.mdx index 43e6991c8f..10a24ca04d 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/document-collections.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/document-collections.mdx @@ -3,6 +3,7 @@ title: Document Collections slug: document-collections --- + Zep's document vector store lets you embed and search documents using vector similarity search, Maximum Marginal Relevance Re-Ranking, and metadata filtering. You can manage collections, ingest documents, and search using _Zep's SDKs_, _LangChain_, or _LlamaIndex_. @@ -13,17 +14,18 @@ You can manage collections, ingest documents, and search using _Zep's SDKs_, _La All methods come in sync and async flavors, with async methods prefixed with `a`. For instance, `zep-python` offers both `zep_client.memory.add_memory` and `zep_client.memory.aadd_memory`. + ## Key Concepts ### Collections -A `Collection` is a group of documents that use the same embedding strategy and model. *Zep automatically creates embeddings* for the documents you provide. +A `Collection` is a group of documents that use the same embedding strategy and model. _Zep automatically creates embeddings_ for the documents you provide. ### Documents -`Documents` are the texts you want to embed and search. You can add documents to collections and optionally assign them a unique ID and metadata. *If you add metadata, it can help filter search results.* +`Documents` are the texts you want to embed and search. You can add documents to collections and optionally assign them a unique ID and metadata. _If you add metadata, it can help filter search results._ ## Initializing the Zep Client @@ -57,9 +59,9 @@ const client = await ZepClient.init("zep_api_key"); const collection_name: string = "babbagedocs"; // The name of your collection. Alphanumeric values only const collection = await client.document.addCollection({ - name: collection_name, // Required - description: "Babbage's Calculating Engine", // Optional - metadata: { "foo": "bar" } // Optional metadata to associate with this collection + name: collection_name, // Required + description: "Babbage's Calculating Engine", // Optional + metadata: { foo: "bar" }, // Optional metadata to associate with this collection }); ``` @@ -82,14 +84,13 @@ collection = client.document.get_collection(collection_name) ```typescript -const collection = await client.document.getCollection(collection_name) +const collection = await client.document.getCollection(collection_name); ``` - ## Adding Documents to a Collection @@ -125,11 +126,11 @@ When you use `collection.add_documents`, it returns a list of Zep UUIDs correspo const chunks: string[] = read_chunks_from_file(file, max_chunk_size); // Your custom function to read chunks from a file const documents: Document[] = chunks.map((chunk, index) => { - return new Document({ - content: chunk, - documentId: `${collection_name}-${index}`, // Optional document ID - metadata: { "bar": index }, // Optional metadata - }); + return new Document({ + content: chunk, + documentId: `${collection_name}-${index}`, // Optional document ID + metadata: { bar: index }, // Optional metadata + }); }); const uuids: string[] = await client.document.addDocuments(collection_name, documents); @@ -143,12 +144,12 @@ When you use `collection.addDocuments`, it returns a list of Zep UUIDs correspon - Zep's document vector store has VectorStore support for Langchain. **Python Example:** + ```python from langchain.docstore.base import Document from langchain.text_splitter import RecursiveCharacterTextSplitter @@ -165,20 +166,22 @@ text_splitter = RecursiveCharacterTextSplitter( docs = text_splitter.create_documents([raw_text]) uuids = vectorstore.add_documents(docs) ``` + **Typescript Example:** + ```typescript import { ZepClient } from "@getzep/zep-js"; import { ZepVectorStore } from "@getzep/zep-js/langchain"; import { RecursiveCharacterTextSplitter } from "langchain/text_splitter"; const vectorStore = await ZepVectorStore.init({ - client: zepClient, - collectionName: "", + client: zepClient, + collectionName: "", }); const text_splitter = new RecursiveCharacterTextSplitter({ - chunkSize: 400, - chunkOverlap: 50, - lengthFunction: (text: string) => text.length, // Assuming lengthFunction accepts a function that returns the length of the text + chunkSize: 400, + chunkOverlap: 50, + lengthFunction: (text: string) => text.length, // Assuming lengthFunction accepts a function that returns the length of the text }); const docs = await text_splitter.createDocuments([raw_text]); @@ -189,7 +192,6 @@ const uuids = await vectorstore.addDocuments(docs); - ### Chunking your documents Choosing the right _chunking strategy_ is crucial and highly dependent on your specific needs. A variety of 3rd-party libraries, including Langchain, offer support for processing documents from numerous sources and dividing them into smaller segments suitable for embedding. @@ -224,12 +226,12 @@ while True: ```typescript while (true) { - const collection = await client.document.getCollection(collectionName); - console.log(`Embedding status: ${c.document_embedded_count}/${c.document_count} documents embedded`); - await sleep(1000); // Sleep for 1 second (1000 milliseconds) - if (collection.status === "ready") { - break; - } + const collection = await client.document.getCollection(collectionName); + console.log(`Embedding status: ${c.document_embedded_count}/${c.document_count} documents embedded`); + await sleep(1000); // Sleep for 1 second (1000 milliseconds) + if (collection.status === "ready") { + break; + } } ``` @@ -237,7 +239,6 @@ while (true) { - Once the collection's status changes to `ready`, it means all documents have been successfully embedded and are now searchable. ## Searching a Collection with Hybrid Vector Search @@ -250,6 +251,7 @@ You can initiate a search using either a text query or an embedding vector, depe Zep's Collection and Memory search support semantic search queries, JSONPath-based metadata filters, and a combination of both. Memory search also supports querying by message creation date. Read more about [constructing search queries](working-with-search.mdx). + @@ -288,13 +290,13 @@ let results = await collection.search({ text: query, limit: 5 }); // Hybrid search for documents using a query string and metadata filter const metadataQuery = { - where: { jsonpath: '$[*] ? (@.baz == "qux")' } + where: { jsonpath: '$[*] ? (@.baz == "qux")' }, }; results = await collection.search({ text: query, metadata: metadataQuery, limit: 5 }); // Search by embedding vector, rather than text query // embedding is a list of floats -results = await collection.search({ embedding: embedding, limit: 5}); +results = await collection.search({ embedding: embedding, limit: 5 }); ``` `metadata` is an optional dictionary of [JSONPath filters](https://www.ietf.org/archive/id/draft-goessner-dispatch-jsonpath-00.html) used to match on metadata associated with your documents. @@ -303,7 +305,6 @@ results = await collection.search({ embedding: embedding, limit: 5}); - **Python Example:** @@ -333,7 +334,7 @@ const resultsMMR = await vectorstore.search(query, { searchType: "mmr", k: 5 }); console.log(resultsMMR); ``` -*You can also use `ZepVectoreStore` as a retriever with langchain* +_You can also use `ZepVectoreStore` as a retriever with langchain_ Python example @@ -357,28 +358,22 @@ Typescript example const retriever = vectorStore.asRetriever(); const setupAndRetrieval = RunnableMap.from({ - context: new RunnableLambda({ - func: (input: string) => - retriever.invoke(input).then(combineDocuments), - }), - question: new RunnablePassthrough(), + context: new RunnableLambda({ + func: (input: string) => retriever.invoke(input).then(combineDocuments), + }), + question: new RunnablePassthrough(), }); const outputParser = new StringOutputParser(); -const chain = setupAndRetrieval - .pipe(prompt) - .pipe(model) - .pipe(outputParser) +const chain = setupAndRetrieval.pipe(prompt).pipe(model).pipe(outputParser); ``` -> *Please check the complete typescript [rag vector store chain example](https://github.com/getzep/zep-js/blob/main/examples/langchain/vector_store_example.ts)* - +> _Please check the complete typescript [rag vector store chain example](https://github.com/getzep/zep-js/blob/main/examples/langchain/vector_store_example.ts)_ - ## Retrieving Documents by UUID Zep supports retrieving a list of documents by Zep UUID: @@ -427,10 +422,10 @@ client.document.update_collection( ```typescript -await client.document.updateCollection( - collectionName, - { description: "Charles Babbage's Babbage's Calculating Engine 2", metadata: { newfoo: "newbar" } } -); +await client.document.updateCollection(collectionName, { + description: "Charles Babbage's Babbage's Calculating Engine 2", + metadata: { newfoo: "newbar" }, +}); ``` @@ -456,7 +451,6 @@ await collection.updateDocument(documentUUID, { documentId: "new_id", metadata: - ### Deleting Documents @@ -476,15 +470,13 @@ collection.delete_document(document_uuid) ```typescript -await collection.deleteDocument(document_uuid) +await collection.deleteDocument(document_uuid); ``` - - ### Deleting a Collection Deleting a collection will delete all documents in the collection, as well as the collection itself. @@ -502,11 +494,9 @@ client.document.delete_collection(collection_name) ```typescript -await client.document.deleteCollection(collection_name) +await client.document.deleteCollection(collection_name); ``` - - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/chainlit.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/chainlit.mdx index cf606786a5..8cdff2eaf9 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/chainlit.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/chainlit.mdx @@ -8,15 +8,14 @@ slug: ecosystem/chainlit - You can follow Chainlit installation steps on their - Getting Started Page + You can follow Chainlit installation steps on their + Getting Started Page By integrating Zep into your Chainlit LLM application, you elevate your conversational agent with powerful features like long-term memory and context fusion. In this guide, we'll walk you through the steps to build a simple Question and Answer agent using Chainlit, Open AI and Zep. - ### Steps to Use Zep Cloud with ChainLit 1. **Setup Zep Client**: Initialize the Zep Client within your ChainLit application using your [Zep Project API key](https://help.getzep.com/projects). @@ -50,22 +49,23 @@ async def start_chat(): # Generate unique identifiers for the user and session. user_id = str(uuid.uuid4()) session_id = str(uuid.uuid4()) - + # Save user and session identifiers in the current session context. cl.user_session.set("user_id", user_id) cl.user_session.set("session_id", session_id) # Register a new user in Zep's system using the generated User ID. await zep.user.aadd(CreateUserRequest(user_id=user_id)) - + # Start a new session for the user in Zep. await zep.memory.aadd_session(Session(user_id=user_id, session_id=session_id)) ``` - 3. **Zep Dialog tools**: Elevate agent knowledge with ChainLit Steps and Zep Dialog Tools -Discover more about Zep's dialog tools on the Zep Documentation Page. - + + Discover more about Zep's dialog tools on the{" "} + Zep Documentation Page. + ```python @cl.step(name="session classification", type="tool") @@ -85,12 +85,12 @@ async def classify_session(session_id: str): return classification ``` - - 4. **Message Handling**: You can effectively store and fetch your Chainlit application chat history on Zep memory store, enhancing your LLM conversational context. -Discover more about Zep's memory store capabilities on the Zep Documentation Page. - + + Discover more about Zep's memory store capabilities on the{" "} + Zep Documentation Page. + ```python @@ -100,10 +100,10 @@ async def call_openai(session_id): # Fetch session messages from Zep. memory = await zep.message.aget_session_messages(session_id) memory_history = [m.to_dict() for m in memory] - + # Prepare data, excluding certain fields for privacy/security. cleaned_data = [{k: v for k, v in item.items() if k not in ['created_at', 'role_type', 'token_count', 'uuid']} for item in memory_history] - + # Generate a response from OpenAI using the cleaned session data. response = await openai_client.chat.completions.create( model="gpt-4", @@ -138,13 +138,10 @@ async def on_message(message: cl.Message): ) ``` -5. To access your LLM session data, navigate to the Zep Cloud Console, select a session, and review all the associated session data and logs. -Zep Cloud session console example +5. To access your LLM session data, navigate to the Zep Cloud Console, select a session, and review all the associated session data and logs. +Zep Cloud session console example In conclusion, integrating Zep Cloud with Chainlit empowers developers to create conversational AI applications that are more intelligent, context-aware, and efficient. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/flowise.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/flowise.mdx index 3a6e837295..552548ce66 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/flowise.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/ecosystem/flowise.mdx @@ -8,8 +8,8 @@ slug: ecosystem/flowise - You can follow Flowise installation steps on their - Getting Started Page + You can follow Flowise installation steps on their + Getting Started Page ## Using Zep Cloud Nodes @@ -17,35 +17,30 @@ slug: ecosystem/flowise Once you have Flowise app up and running, you can use Zep Cloud nodes in your LLM apps. We expose the following nodes: -* `Zep Memory - Cloud` - wrapper around Zep Memory API. You can use this node to add Long-Term memory to your app. -Learn more about [Zep Memory](/chat-history-memory) + +- `Zep Memory - Cloud` - wrapper around Zep Memory API. You can use this node to add Long-Term memory to your app. + Learn more about [Zep Memory](/chat-history-memory) In order to use this node, you will need to have a Zep Project API key and add it as a Connect Credential in your Flowise app. -Zep Cloud Memory Flowise Node + +Zep Cloud Memory Flowise Node A complete chain using Zep Memory Node, may look like this: Zep Cloud Memory Flowise Node Complete Example -* `Zep Collection - Cloud` - wrapper around Zep’s document vector store. It lets you embed and search documents. You can use this node to add RAG capabilities to your app. -Learn more about [Zep Collections](../document-collections.mdx) +- `Zep Collection - Cloud` - wrapper around Zep’s document vector store. It lets you embed and search documents. You can use this node to add RAG capabilities to your app. + Learn more about [Zep Collections](../document-collections.mdx) In order to use this node, you will need to have a Zep Project API key and add it as a Connect Credential in your Flowise app. You will also need to provide the collection name for your Zep Collection. -Zep Cloud Collection Flowise Node + +Zep Cloud Collection Flowise Node A complete chain using Zep Collection Node, may look like this: @@ -56,9 +51,7 @@ A complete chain using Zep Collection Node, may look like this: We are using **Zep Collection Node** as a retriever passed into **Conversational Retrieval QA Chain**. This example also illustrates how you can use **Zep Memory** in combination with **Zep Collection**. + -Zep Cloud Collection Flowise Node Complete Example \ No newline at end of file +Zep Cloud Collection Flowise Node Complete Example diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/faq.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/faq.mdx index 4b17b86f0a..5154b5467e 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/faq.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/faq.mdx @@ -12,6 +12,7 @@ slug: faq Expression Language (LCEL) project. Please use the classes available in the Cloud SDKs and not in the LangChain SDKs. + Not yet - we are working on adding support for LlamaIndex. @@ -20,6 +21,7 @@ slug: faq Yes, you can use `Zep Memory - Cloud` and `Zep Collection - Cloud` nodes in the latest Flowise release. You can learn more in our [Flowise Ecosystem section](ecosystem/flowise.mdx). + @@ -27,6 +29,7 @@ slug: faq We've also removed the Named Entity Recognition (NER) feature. We are in the process of replacing NER with a more powerful and flexible Structured Data Extractor. + The API URL for Zep Cloud is `https://api.getzep.com`. Note that you do not need to specify the API URL when using the Cloud SDKs. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/getting-support.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/getting-support.mdx index f34dc7290c..a5122a1198 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/getting-support.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/getting-support.mdx @@ -4,4 +4,4 @@ slug: getting-support # Getting Support -Use the in-app chat to get help from the Zep team. You may also email us at [success@getzep.com](mailto:success@getzep.com). \ No newline at end of file +Use the in-app chat to get help from the Zep team. You may also email us at [success@getzep.com](mailto:success@getzep.com). diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/messagehistory-example.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/messagehistory-example.mdx index c8fe58979c..f3beb9fdc3 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/messagehistory-example.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/messagehistory-example.mdx @@ -3,7 +3,8 @@ title: MessageHistory Example slug: langchain/examples/messagehistory-example --- -The Zep Python SDK includes the `ZepChatMessageHistory` class, compatible with [LangChain Expression Language (LCEL)](https://python.langchain.com/docs/expression_language/get_started). + +The Zep Python SDK includes the `ZepChatMessageHistory` class, compatible with [LangChain Expression Language (LCEL)](https://python.langchain.com/docs/expression_language/get_started). This guide will walk you through creating a [MessageHistory](/chat-history-memory) chain using Zep's conversation history. @@ -15,6 +16,7 @@ This guide will walk you through creating a [MessageHistory](/chat-history-memor `ZEP_API_KEY` - API key to your zep project `OPENAI_API_KEY` - Open AI api key which the chain will require to generate the answer + @@ -26,6 +28,7 @@ This guide will walk you through creating a [MessageHistory](/chat-history-memor Alternatively, you can create a collection by running either [Document example](https://github.com/getzep/zep-python/blob/main/examples/documents/documents_async.py) in python sdk repository or [Document example](https://github.com/getzep/zep-js/blob/main/examples/documents/index.ts) in typescript sdk repository. + @@ -34,6 +37,7 @@ This guide will walk you through creating a [MessageHistory](/chat-history-memor You can create a session by running either [Memory example](https://github.com/getzep/zep-python/blob/main/examples/chat_history/memory_async.py) in python sdk repository or [Memory example](https://github.com/getzep/zep-js/blob/main/examples/memory/memory_example.ts) in typescript sdk repository. + **Initialize ZepClient with necessary imports** @@ -62,6 +66,7 @@ zep = ZepClient( api_key=ZEP_API_KEY, ) ``` + @@ -70,18 +75,15 @@ zep = ZepClient( import { ZepClient } from "@getzep/zep-js"; import { ZepChatMessageHistory } from "@getzep/zep-js/langchain"; import { ChatOpenAI } from "@langchain/openai"; -import { - ChatPromptTemplate, - MessagesPlaceholder, -} from "@langchain/core/prompts"; +import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts"; import { RunnableWithMessageHistory } from "@langchain/core/runnables"; const zepClient = await ZepClient.init(process.env.ZEP_API_KEY); ``` + - @@ -97,16 +99,18 @@ answer_prompt = ChatPromptTemplate.from_messages( ] ) ``` + ```typescript const prompt = ChatPromptTemplate.fromMessages([ - ["system", "Answer the user's question below. Be polite and helpful:"], - new MessagesPlaceholder("history"), - ["human", "{question}"], + ["system", "Answer the user's question below. Be polite and helpful:"], + new MessagesPlaceholder("history"), + ["human", "{question}"], ]); ``` + @@ -118,11 +122,11 @@ const prompt = ChatPromptTemplate.fromMessages([ This will incorporate the chat history into the prompt. It's **important** that this variable name aligns with the `history_messages_key` in the `RunnableWithMessageHistory` chain for seamless integration. + **`question` must match `input_messages_key` in `RunnableWithMessageHistory`` chain.** - **Compose the final chain** @@ -148,34 +152,36 @@ chain = RunnableWithMessageHistory( history_messages_key="chat_history", ) ``` + ```typescript const chain = prompt.pipe( - new ChatOpenAI({ - temperature: 0.8, - modelName: "gpt-3.5-turbo-1106", - }), + new ChatOpenAI({ + temperature: 0.8, + modelName: "gpt-3.5-turbo-1106", + }), ); const chainWithHistory = new RunnableWithMessageHistory({ - runnable: chain, - getMessageHistory: (sessionId) => - new ZepChatMessageHistory({ - client: zepClient, - sessionId: sessionId, - memoryType: "perpetual", - }), - inputMessagesKey: "question", - historyMessagesKey: "history", + runnable: chain, + getMessageHistory: (sessionId) => + new ZepChatMessageHistory({ + client: zepClient, + sessionId: sessionId, + memoryType: "perpetual", + }), + inputMessagesKey: "question", + historyMessagesKey: "history", }); ``` + - Here's a quick overview of what's happening: + 1. We use `RunnableWithMessageHistory` to incorporate [Zep's Chat History](/chat-history-memory) into our chain. 2. This class requires a `session_id` as a parameter when you activate the chain. 3. To manually invoke this chain, provide the `session_id` as a parameter and the `question` as an input to the chain. @@ -190,25 +196,26 @@ chain_with_history.invoke( config={"configurable": {"session_id": "-"}}, ) ``` + ```typescript await chainWithHistory.invoke( - { - question: "-", - }, - { - configurable: { - sessionId: "-", - }, + { + question: "-", + }, + { + configurable: { + sessionId: "-", }, + }, ); ``` + - First, we initialize `ZepChatMessageHistory` with the following parameters: 1. `session_id` - This uniquely identifies the conversation within Zep. @@ -231,6 +238,7 @@ This chain can also be executed as part of our LangServe sample project. To do t For this you will need to: Clone our [Python SDK](https://github.com/getzep/zep-python) + ```bash git clone https://github.com/getzep/zep-python cd examples/langchain-langserve diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/rag-message-history-example.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/rag-message-history-example.mdx index c1f022f4cd..ffc2765a94 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/rag-message-history-example.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/rag-message-history-example.mdx @@ -4,10 +4,7 @@ slug: langchain/examples/rag-message-history-example --- - - **You can generate a Project API Key in [Zep Dashboard](https://app.getzep.com/projects).** - - +**You can generate a Project API Key in [Zep Dashboard](https://app.getzep.com/projects).** Make sure you have the following environment variables specified when running these examples: @@ -15,6 +12,7 @@ slug: langchain/examples/rag-message-history-example `ZEP_API_KEY` - API key to your zep project `OPENAI_API_KEY` - Open AI api key which the chain will require to generate the answer + @@ -23,6 +21,7 @@ slug: langchain/examples/rag-message-history-example You can create a session by running either [Memory example](https://github.com/getzep/zep-python/blob/main/examples/chat_history/memory_async.py) in python sdk repository or [Memory example](https://github.com/getzep/zep-js/blob/main/examples/memory/memory_example.ts) in typescript sdk repository. + You can find a complete RAG + Message History examples in the SDK examples diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/vectorstore-example.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/vectorstore-example.mdx index 11cd2f1232..084e887d0c 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/vectorstore-example.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/examples/vectorstore-example.mdx @@ -3,13 +3,12 @@ title: VectorStore Example slug: langchain/examples/vectorstore-example --- + Zep Python SDK ships with `ZepVectorStore` class which can be used with [LangChain Expression Language (LCEL)](https://python.langchain.com/docs/expression_language/get_started) Let's explore how to create a RAG chain using the `ZepVectorStore` for semantic search. - - **You can generate a project api key in [Zep Dashboard](https://app.getzep.com/projects).** - +**You can generate a project api key in [Zep Dashboard](https://app.getzep.com/projects).** Before diving into these examples, please ensure you've set the following environment variables: @@ -17,6 +16,7 @@ Let's explore how to create a RAG chain using the `ZepVectorStore` for semantic `ZEP_API_KEY` - API key to your zep project `OPENAI_API_KEY` - Open AI api key which the chain will require to generate the answer + @@ -28,8 +28,8 @@ Let's explore how to create a RAG chain using the `ZepVectorStore` for semantic Alternatively, you can create a collection by running either [Document example](https://github.com/getzep/zep-python/blob/main/examples/documents/documents_async.py) in python sdk repository or [Document example](https://github.com/getzep/zep-js/blob/main/examples/documents/index.ts) in typescript sdk repository. - + @@ -39,6 +39,7 @@ Let's explore how to create a RAG chain using the `ZepVectorStore` for semantic ZEP_API_KEY = os.environ.get("ZEP_API_KEY") ZEP_COLLECTION_NAME = os.environ.get("ZEP_COLLECTION") ``` + @@ -46,14 +47,14 @@ ZEP_COLLECTION_NAME = os.environ.get("ZEP_COLLECTION") const ZEP_API_KEY = process.env.ZEP_API_KEY; const ZEP_COLLECTION_NAME = process.env.ZEP_COLLECTION; ``` + - - **Need a project API key? Create one from the [Zep Dashboard](https://app.getzep.com/projects).** - +**Need a project API key? Create one from the [Zep Dashboard](https://app.getzep.com/projects).** Initialize ZepClient with necessary imports + @@ -82,36 +83,28 @@ zep = ZepClient( api_key=ZEP_API_KEY, ) ``` + ```typescript import { ZepClient } from "@getep/zep-js"; import { ChatOpenAI } from "@langchain/openai"; -import { - BasePromptTemplate, - ChatPromptTemplate, - PromptTemplate, -} from "@langchain/core/prompts"; +import { BasePromptTemplate, ChatPromptTemplate, PromptTemplate } from "@langchain/core/prompts"; import { ZepVectorStore, formatDocument } from "@getep/zep-js/langchain"; import { Document } from "@langchain/core/documents"; -import { - RunnableMap, - RunnableLambda, - RunnablePassthrough, -} from "@langchain/core/runnables"; +import { RunnableMap, RunnableLambda, RunnablePassthrough } from "@langchain/core/runnables"; import { StringOutputParser } from "@langchain/core/output_parsers"; import { ConsoleCallbackHandler } from "@langchain/core/tracers/console"; - -const zepClient = await ZepClient.init( - ZEP_API_KEY, -); +const zepClient = await ZepClient.init(ZEP_API_KEY); ``` + Initialize ZepVectorStore + @@ -122,19 +115,22 @@ vectorstore = ZepVectorStore( zep_client=zep, ) ``` + ```typescript const vectorStore = await ZepVectorStore.init({ - client: zepClient, - collectionName: ZEP_COLLECTION_NAME, + client: zepClient, + collectionName: ZEP_COLLECTION_NAME, }); ``` + Let's set up the retriever. We'll use `vectorstore` for this purpose and configure it to use [MMR](Search.md) search result reranking. + @@ -142,17 +138,20 @@ Let's set up the retriever. We'll use `vectorstore` for this purpose and configu ```python retriever = vectorstore.as_retriever() ``` + ```typescript - const retriever = vectorStore.asRetriever(); +const retriever = vectorStore.asRetriever(); ``` + Create a prompt template for synthesizing answers. + @@ -169,6 +168,7 @@ answer_prompt = ChatPromptTemplate.from_messages( ] ) ``` + @@ -185,11 +185,12 @@ const prompt = ChatPromptTemplate.fromMessages([ ], ]); ``` + - Create the default document prompt and define the helper function for merging documents. + @@ -205,6 +206,7 @@ def _combine_documents( doc_strings = [format_document(doc, document_prompt) for doc in docs] return document_separator.join(doc_strings) ``` + @@ -212,18 +214,19 @@ def _combine_documents( const DEFAULT_DOCUMENT_PROMPT = PromptTemplate.fromTemplate("{pageContent}"); async function combineDocuments( - docs: Document[], - documentPrompt: BasePromptTemplate = DEFAULT_DOCUMENT_PROMPT, - documentSeparator: string = "\n\n", + docs: Document[], + documentPrompt: BasePromptTemplate = DEFAULT_DOCUMENT_PROMPT, + documentSeparator: string = "\n\n", ) { - const docStrings: string[] = await Promise.all( - docs.map((doc) => { - return formatDocument(doc, documentPrompt); - }), - ); - return docStrings.join(documentSeparator); + const docStrings: string[] = await Promise.all( + docs.map((doc) => { + return formatDocument(doc, documentPrompt); + }), + ); + return docStrings.join(documentSeparator); } ``` + @@ -241,6 +244,7 @@ inputs = RunnableParallel( {"question": lambda x: x["question"], "context": retriever | _combine_documents}, ).with_types(input_type=UserInput) ``` + Define context retriever chain with output parser @@ -249,17 +253,18 @@ Define context retriever chain with output parser const outputParser = new StringOutputParser(); const setupAndRetrieval = RunnableMap.from({ - context: new RunnableLambda({ - func: (input: string) => - retriever.invoke(input).then(combineDocuments), - }), - question: new RunnablePassthrough(), + context: new RunnableLambda({ + func: (input: string) => retriever.invoke(input).then(combineDocuments), + }), + question: new RunnablePassthrough(), }); ``` + Compose final chain + @@ -267,18 +272,20 @@ Compose final chain ```python chain = inputs | answer_prompt | ChatOpenAI() | StrOutputParser() ``` + ```typescript const chain = setupAndRetrieval - .pipe(prompt) - .pipe(model) - .pipe(outputParser) - .withConfig({ - callbacks: [new ConsoleCallbackHandler()], - }); // Optional console callback handler if you want to see input and output of each step in the chain + .pipe(prompt) + .pipe(model) + .pipe(outputParser) + .withConfig({ + callbacks: [new ConsoleCallbackHandler()], + }); // Optional console callback handler if you want to see input and output of each step in the chain ``` + @@ -290,6 +297,7 @@ Here's a quick rundown of how the process works: 4. Finally, `StrOutputParser` extracts the LLM's result into a string. To invote this chain manually, simply pass the `question` into the chain's input. + @@ -299,16 +307,17 @@ chain_with_history.invoke( {"question": "-"}, ) ``` + ```typescript - const result = await chain.invoke("-"); // Pass the question as input +const result = await chain.invoke("-"); // Pass the question as input ``` + - ## Running the Chain with LangServe You can run this chain, along with others, using our LangServe sample project. @@ -316,6 +325,7 @@ You can run this chain, along with others, using our LangServe sample project. Here's what you'll need to do: Clone our [Python SDK](https://github.com/getzep/zep-python) + ```bash git clone https://github.com/getzep/zep-python cd examples/langchain-langserve @@ -324,4 +334,3 @@ cd examples/langchain-langserve Review the [README](https://github.com/getzep/zep-python/blob/main/examples/README.md) in the `langchain-langserve` directory for setup instructions. After firing up the server, head over to `http://localhost:8000/rag_vector_store/playground` to explore the LangServe playground using this chain. - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/messagehistory.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/messagehistory.mdx index 5eb5cc6c6f..17aac608cf 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/messagehistory.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/messagehistory.mdx @@ -3,8 +3,10 @@ title: ZepChatMessageHistory slug: langchain/messagehistory --- + - **You can find a complete [Message History Example](examples/messagehistory-example.mdx) that showcases how to use the `ZepChatMessageHistory` class in the chain.** + **You can find a complete [Message History Example](examples/messagehistory-example.mdx) that showcases how to use the + `ZepChatMessageHistory` class in the chain.** @@ -78,4 +80,4 @@ slug: langchain/messagehistory ``` - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/overview.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/overview.mdx index 46b6d0ec18..360d7544a8 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/overview.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/overview.mdx @@ -3,7 +3,9 @@ title: Overview slug: langchain/overview --- + Zep's [Python](https://github.com/getzep/zep-python) and [Typescript](https://github.com/getzep/zep-js) SDKs ship with [ZepVectorStore](vectorstore.mdx) and [ZepChatMessageHistory](messagehistory.mdx) classes that are compatible with Langchain's JS and Python Expression Languages. + ### Managing Chat History Memory Zep's `ZepChatMessageHistory` class can be used to provide long-term memory for your LangChain chat apps or agents. Zep will store the entire historical message stream, and automatically enrich chat sessions. @@ -28,4 +30,5 @@ See [Python and Typescript examples](examples/messagehistory-example.mdx) of how **Want to use `ZepChatMessageHistory` together with `ZepVectorStore`?** Please check our complete [Python and Typescript examples](examples/rag-message-history-example.mdx) + diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/vectorstore.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/vectorstore.mdx index 916456078b..1d5e0e1938 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/vectorstore.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/langchain/vectorstore.mdx @@ -3,8 +3,10 @@ title: ZepVectorStore slug: langchain/vectorstore --- + - **You can find a complete [Vector Store Example](examples/vectorstore-example.mdx) that showcases how to use the `ZepVectorStore` class in the chain.** + **You can find a complete [Vector Store Example](examples/vectorstore-example.mdx) that showcases how to use the + `ZepVectorStore` class in the chain.** @@ -81,4 +83,4 @@ slug: langchain/vectorstore - \ No newline at end of file + diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/privacy-policy.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/privacy-policy.mdx index 3484f65ff8..9089e23d54 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/privacy-policy.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/privacy-policy.mdx @@ -3,6 +3,7 @@ title: Privacy Policy slug: legal/privacy-policy --- + **Version 1.0** **Last revised on: January 27^th^, 2024** @@ -11,7 +12,7 @@ Zep Software, Inc. (the "Company") is committed to maintaining robust privacy protections for its users.  Our Privacy Policy ("Privacy Policy") is designed to help you understand how we collect, use and safeguard the information you provide to us and to assist you in making -informed decisions when using our Service.   +informed decisions when using our Service. For purposes of this Agreement, "Site" refers to the Company's website properties, which can be accessed at the getzep.com Internet domain. @@ -41,7 +42,7 @@ generated based on the data you submit and number of clicks. **Personal Information** includes your email and name which you submit to us through the registration process at the Site. -1.1. *Information collected via Technology* +1.1. _Information collected via Technology_ To activate the Service you do not need to submit any Personal Information other than your email address and name. To use the Service @@ -62,7 +63,7 @@ when utilizing our services, both on an individual and aggregate basis. For example, the Company may use cookies to collect the following information: -- how often you use our websites and services +- how often you use our websites and services - which content and features you use The Company may use both persistent and session cookies; persistent @@ -70,7 +71,7 @@ cookies remain on your computer after you close your session and until you delete them, while session cookies expire when you close your browser. -1.2. *Information you provide us by registering for an account* +1.2. _Information you provide us by registering for an account_ In addition to the information provided automatically by your browser when you visit the Site, to become a subscriber to the Service you will @@ -80,7 +81,7 @@ creating a user name and a password. By registering, you are authorizing us to collect, store and use your email address in accordance with this Privacy Policy. -1.3. *Children's Privacy* +1.3. _Children's Privacy_ The Site and the Service are not directed to anyone under the age of 13. The Site does not knowingly collect or solicit information from anyone @@ -93,7 +94,7 @@ info@getzep.com. 2. HOW WE USE AND SHARE INFORMATION -*Personal Information:* +_Personal Information:_ Except as otherwise stated in this Privacy Policy, we do not sell, trade, rent or otherwise share for marketing purposes your Personal @@ -118,7 +119,7 @@ security or technical concerns; or to protect against harm to the rights, property, or safety of our users or the public as required or permitted by law. -*Non-Personal Information* +_Non-Personal Information_ In general, we use Non-Personal Information to help us improve the Service and customize the user experience. We also aggregate @@ -154,7 +155,7 @@ and secure server software. By using our Service, you acknowledge that you understand and agree to assume these risks. 4. YOUR RIGHTS REGARDING THE USE OF YOUR PERSONAL -INFORMATION + INFORMATION You have the right at any time to prevent us from contacting you for marketing purposes.  When we send a promotional communication to a user, @@ -194,4 +195,4 @@ page for updates. 7. CONTACT US If you have any questions regarding this Privacy Policy or the practices -of this Site, please contact us by sending an email to info@getzep.com. \ No newline at end of file +of this Site, please contact us by sending an email to info@getzep.com. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/terms-of-service.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/terms-of-service.mdx index 2a3a6e0507..6c594af556 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/terms-of-service.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/terms-of-service.mdx @@ -3,6 +3,7 @@ title: Terms of Service slug: legal/terms-of-service --- + **Version 1.0** **Last revised on: January 27^th^, 2024** @@ -30,7 +31,7 @@ conditions of this Agreement. Cover Page -*Order Form* +_Order Form_ **Cloud Service:** Zep is a cloud-based platform-as-a-service that offers fast, scalable, privacy-compliant building blocks for Generative @@ -60,7 +61,7 @@ Period **Invoice Period:** Monthly -*Key Terms* +_Key Terms_ **Customer:** The company or person who accesses or uses the Product. If the person accepting this Agreement is doing so on behalf of a company, @@ -100,7 +101,7 @@ For Provider: notices@getzep.com For Customer: The main email address on Customer's account -*Changes to the Standard Terms* +_Changes to the Standard Terms_ **Publicity Rights:** Modifying Section 14.7 of the Standard Terms, Provider may identify Customer and use Customer's logo and trademarks on diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/website-terms-of-use.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/website-terms-of-use.mdx index 3c49f9d26b..87c88ec80b 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/website-terms-of-use.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/legal/website-terms-of-use.mdx @@ -3,6 +3,7 @@ title: Website Terms of Use slug: legal/website-terms-of-use --- + **Version 1.0** **Last revised on: January 27^th^, 2024** @@ -42,131 +43,131 @@ CLAIMS AND SEEK RELIEF IN A COURT OF LAW AND TO HAVE A JURY TRIAL.** 1. **Accounts** 1.1. **Account Creation.** In order to use certain features of the Site, - you must register for an account ("**Account**") and provide certain - information about yourself as prompted by the account registration - form. You represent and warrant that: (a) all required registration - information you submit is truthful and accurate; (b) you will - maintain the accuracy of such information. You may delete your - Account at any time, for any reason, by following the instructions - on the Site. Company may suspend or terminate your Account in - accordance with Section 7. +you must register for an account ("**Account**") and provide certain +information about yourself as prompted by the account registration +form. You represent and warrant that: (a) all required registration +information you submit is truthful and accurate; (b) you will +maintain the accuracy of such information. You may delete your +Account at any time, for any reason, by following the instructions +on the Site. Company may suspend or terminate your Account in +accordance with Section 7. 1.2. **Account Responsibilities.** You are responsible for maintaining - the confidentiality of your Account login information and are fully - responsible for all activities that occur under your Account. You - agree to immediately notify Company of any unauthorized use, or - suspected unauthorized use of your Account or any other breach of - security. Company cannot and will not be liable for any loss or - damage arising from your failure to comply with the above - requirements. +the confidentiality of your Account login information and are fully +responsible for all activities that occur under your Account. You +agree to immediately notify Company of any unauthorized use, or +suspected unauthorized use of your Account or any other breach of +security. Company cannot and will not be liable for any loss or +damage arising from your failure to comply with the above +requirements. 2. **Access to the Site** 2.1. **License.** Subject to these Terms, Company grants you a - non-transferable, non-exclusive, revocable, limited license to use - and access the Site solely for your own personal, noncommercial use. +non-transferable, non-exclusive, revocable, limited license to use +and access the Site solely for your own personal, noncommercial use. 2.2. **Certain Restrictions.** The rights granted to you in these Terms - are subject to the following restrictions: (a) you shall not - license, sell, rent, lease, transfer, assign, distribute, host, or - otherwise commercially exploit the Site, whether in whole or in - part, or any content displayed on the Site; (b) you shall not - modify, make derivative works of, disassemble, reverse compile or - reverse engineer any part of the Site; (c) you shall not access the - Site in order to build a similar or competitive website, product, or - service; and (d) except as expressly stated herein, no part of the - Site may be copied, reproduced, distributed, republished, - downloaded, displayed, posted or transmitted in any form or by any - means. Unless otherwise indicated, any future release, update, or - other addition to functionality of the Site shall be subject to - these Terms. All copyright and other proprietary notices on the Site - (or on any content displayed on the Site) must be retained on all - copies thereof. +are subject to the following restrictions: (a) you shall not +license, sell, rent, lease, transfer, assign, distribute, host, or +otherwise commercially exploit the Site, whether in whole or in +part, or any content displayed on the Site; (b) you shall not +modify, make derivative works of, disassemble, reverse compile or +reverse engineer any part of the Site; (c) you shall not access the +Site in order to build a similar or competitive website, product, or +service; and (d) except as expressly stated herein, no part of the +Site may be copied, reproduced, distributed, republished, +downloaded, displayed, posted or transmitted in any form or by any +means. Unless otherwise indicated, any future release, update, or +other addition to functionality of the Site shall be subject to +these Terms. All copyright and other proprietary notices on the Site +(or on any content displayed on the Site) must be retained on all +copies thereof. 2.3. **Modification.** Company reserves the right, at any time, to - modify, suspend, or discontinue the Site (in whole or in part) with - or without notice to you. You agree that Company will not be liable - to you or to any third party for any modification, suspension, or - discontinuation of the Site or any part thereof. - -2.4. **No Support or Maintenance.** You acknowledge and agree that - Company will have no obligation to provide you with any support or - maintenance in connection with the Site. - -2.5. **Ownership.** You acknowledge that all the intellectual property - rights, including copyrights, patents, trade marks, and trade - secrets, in the Site and its content are owned by Company or - Company's suppliers. Neither these Terms (nor your access to the - Site) transfers to you or any third party any rights, title or - interest in or to such intellectual property rights, except for the - limited access rights expressly set forth in Section 2.1. Company - and its suppliers reserve all rights not granted in these Terms. - There are no implied licenses granted under these Terms. +modify, suspend, or discontinue the Site (in whole or in part) with +or without notice to you. You agree that Company will not be liable +to you or to any third party for any modification, suspension, or +discontinuation of the Site or any part thereof. + +2.4. **No Support or Maintenance.** You acknowledge and agree that +Company will have no obligation to provide you with any support or +maintenance in connection with the Site. + +2.5. **Ownership.** You acknowledge that all the intellectual property +rights, including copyrights, patents, trade marks, and trade +secrets, in the Site and its content are owned by Company or +Company's suppliers. Neither these Terms (nor your access to the +Site) transfers to you or any third party any rights, title or +interest in or to such intellectual property rights, except for the +limited access rights expressly set forth in Section 2.1. Company +and its suppliers reserve all rights not granted in these Terms. +There are no implied licenses granted under these Terms. 2.6. **Feedback.** If you provide Company with any feedback or - suggestions regarding the Site ("**Feedback**"), you hereby assign - to Company all rights in such Feedback and agree that Company shall - have the right to use and fully exploit such Feedback and related - information in any manner it deems appropriate. Company will treat - any Feedback you provide to Company as non-confidential and - non-proprietary. You agree that you will not submit to Company any - information or ideas that you consider to be confidential or - proprietary. +suggestions regarding the Site ("**Feedback**"), you hereby assign +to Company all rights in such Feedback and agree that Company shall +have the right to use and fully exploit such Feedback and related +information in any manner it deems appropriate. Company will treat +any Feedback you provide to Company as non-confidential and +non-proprietary. You agree that you will not submit to Company any +information or ideas that you consider to be confidential or +proprietary. 3. **Indemnification.** You agree to indemnify and hold - Company (and its officers, employees, and agents) harmless, - including costs and attorneys' fees, from any claim or demand made - by any third party due to or arising out of (a) your use of the - Site, (b) your violation of these Terms or (c) your violation of - applicable laws or regulations. Company reserves the right, at your - expense, to assume the exclusive defense and control of any matter - for which you are required to indemnify us, and you agree to - cooperate with our defense of these claims. You agree not to settle - any matter without the prior written consent of Company. Company - will use reasonable efforts to notify you of any such claim, action - or proceeding upon becoming aware of it. + Company (and its officers, employees, and agents) harmless, + including costs and attorneys' fees, from any claim or demand made + by any third party due to or arising out of (a) your use of the + Site, (b) your violation of these Terms or (c) your violation of + applicable laws or regulations. Company reserves the right, at your + expense, to assume the exclusive defense and control of any matter + for which you are required to indemnify us, and you agree to + cooperate with our defense of these claims. You agree not to settle + any matter without the prior written consent of Company. Company + will use reasonable efforts to notify you of any such claim, action + or proceeding upon becoming aware of it. 4. **Third-Party Links & Ads; Other Users** 4.1. **Third-Party Links & Ads.** The Site may contain links to - third-party websites and services, and/or display advertisements for - third parties (collectively, "**Third-Party Links & Ads**"). Such - Third-Party Links & Ads are not under the control of Company, and - Company is not responsible for any Third-Party Links & Ads. Company - provides access to these Third-Party Links & Ads only as a - convenience to you, and does not review, approve, monitor, endorse, - warrant, or make any representations with respect to Third-Party - Links & Ads. You use all Third-Party Links & Ads at your own risk, - and should apply a suitable level of caution and discretion in doing - so. When you click on any of the Third-Party Links & Ads, the - applicable third party's terms and policies apply, including the - third party's privacy and data gathering practices. You should make - whatever investigation you feel necessary or appropriate before - proceeding with any transaction in connection with such Third-Party - Links & Ads. +third-party websites and services, and/or display advertisements for +third parties (collectively, "**Third-Party Links & Ads**"). Such +Third-Party Links & Ads are not under the control of Company, and +Company is not responsible for any Third-Party Links & Ads. Company +provides access to these Third-Party Links & Ads only as a +convenience to you, and does not review, approve, monitor, endorse, +warrant, or make any representations with respect to Third-Party +Links & Ads. You use all Third-Party Links & Ads at your own risk, +and should apply a suitable level of caution and discretion in doing +so. When you click on any of the Third-Party Links & Ads, the +applicable third party's terms and policies apply, including the +third party's privacy and data gathering practices. You should make +whatever investigation you feel necessary or appropriate before +proceeding with any transaction in connection with such Third-Party +Links & Ads. 4.2. **Other Users.** Your interactions with other Site users are solely - between you and such users. You agree that Company will not be - responsible for any loss or damage incurred as the result of any - such interactions. If there is a dispute between you and any Site - user, we are under no obligation to become involved. +between you and such users. You agree that Company will not be +responsible for any loss or damage incurred as the result of any +such interactions. If there is a dispute between you and any Site +user, we are under no obligation to become involved. 4.3.. **Release.** You hereby release and forever discharge Company (and - our officers, employees, agents, successors, and assigns) from, and - hereby waive and relinquish, each and every past, present and future - dispute, claim, controversy, demand, right, obligation, liability, - action and cause of action of every kind and nature (including - personal injuries, death, and property damage), that has arisen or - arises directly or indirectly out of, or that relates directly or - indirectly to, the Site (including any interactions with, or act or - omission of, other Site users or any Third-Party Links & Ads). IF - YOU ARE A CALIFORNIA RESIDENT, YOU HEREBY WAIVE CALIFORNIA CIVIL - CODE SECTION 1542 IN CONNECTION WITH THE FOREGOING, WHICH STATES: "A - GENERAL RELEASE DOES NOT EXTEND TO CLAIMS WHICH THE CREDITOR OR - RELEASING PARTY DOES NOT KNOW OR SUSPECT TO EXIST IN HIS OR HER - FAVOR AT THE TIME OF EXECUTING THE RELEASE, WHICH IF KNOWN BY HIM OR - HER MUST HAVE MATERIALLY AFFECTED HIS OR HER SETTLEMENT WITH THE - DEBTOR OR RELEASED PARTY." +our officers, employees, agents, successors, and assigns) from, and +hereby waive and relinquish, each and every past, present and future +dispute, claim, controversy, demand, right, obligation, liability, +action and cause of action of every kind and nature (including +personal injuries, death, and property damage), that has arisen or +arises directly or indirectly out of, or that relates directly or +indirectly to, the Site (including any interactions with, or act or +omission of, other Site users or any Third-Party Links & Ads). IF +YOU ARE A CALIFORNIA RESIDENT, YOU HEREBY WAIVE CALIFORNIA CIVIL +CODE SECTION 1542 IN CONNECTION WITH THE FOREGOING, WHICH STATES: "A +GENERAL RELEASE DOES NOT EXTEND TO CLAIMS WHICH THE CREDITOR OR +RELEASING PARTY DOES NOT KNOW OR SUSPECT TO EXIST IN HIS OR HER +FAVOR AT THE TIME OF EXECUTING THE RELEASE, WHICH IF KNOWN BY HIM OR +HER MUST HAVE MATERIALLY AFFECTED HIS OR HER SETTLEMENT WITH THE +DEBTOR OR RELEASED PARTY." 5. **Disclaimers** @@ -213,80 +214,80 @@ FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 7. **Term and Termination.** Subject to this Section, - these Terms will remain in full force and effect while you use the - Site. We may suspend or terminate your rights to use the Site - (including your Account) at any time for any reason at our sole - discretion, including for any use of the Site in violation of these - Terms. Upon termination of your rights under these Terms, your - Account and right to access and use the Site will terminate - immediately. Company will not have any liability whatsoever to you - for any termination of your rights under these Terms, including for - termination of your Account. Even after your rights under these - Terms are terminated, the following provisions of these Terms will - remain in effect: Sections 2.2 through 2.6 and Sections 3 through 8. + these Terms will remain in full force and effect while you use the + Site. We may suspend or terminate your rights to use the Site + (including your Account) at any time for any reason at our sole + discretion, including for any use of the Site in violation of these + Terms. Upon termination of your rights under these Terms, your + Account and right to access and use the Site will terminate + immediately. Company will not have any liability whatsoever to you + for any termination of your rights under these Terms, including for + termination of your Account. Even after your rights under these + Terms are terminated, the following provisions of these Terms will + remain in effect: Sections 2.2 through 2.6 and Sections 3 through 8. 8. **General** 8.1. **Changes.** These Terms are subject to occasional revision, and if - we make any substantial changes, we may notify you by sending you an - e-mail to the last e-mail address you provided to us (if any), - and/or by prominently posting notice of the changes on our Site. You - are responsible for providing us with your most current e-mail - address. In the event that the last e-mail address that you have - provided us is not valid, or for any reason is not capable of - delivering to you the notice described above, our dispatch of the - e-mail containing such notice will nonetheless constitute effective - notice of the changes described in the notice. Continued use of our - Site following notice of such changes shall indicate your - acknowledgement of such changes and agreement to be bound by the - terms and conditions of such changes. +we make any substantial changes, we may notify you by sending you an +e-mail to the last e-mail address you provided to us (if any), +and/or by prominently posting notice of the changes on our Site. You +are responsible for providing us with your most current e-mail +address. In the event that the last e-mail address that you have +provided us is not valid, or for any reason is not capable of +delivering to you the notice described above, our dispatch of the +e-mail containing such notice will nonetheless constitute effective +notice of the changes described in the notice. Continued use of our +Site following notice of such changes shall indicate your +acknowledgement of such changes and agreement to be bound by the +terms and conditions of such changes. 8.2. **Dispute Resolution.** Please read the following - arbitration agreement in this Section (the "**Arbitration - Agreement**") carefully.  It requires you to arbitrate disputes with - Company, its parent companies, subsidiaries, affiliates, successors - and assigns and all of their respective officers, directors, - employees, agents, and representatives (collectively, the "**Company - Parties**") and limits the manner in which you can seek relief from - the Company Parties  +arbitration agreement in this Section (the "**Arbitration +Agreement**") carefully.  It requires you to arbitrate disputes with +Company, its parent companies, subsidiaries, affiliates, successors +and assigns and all of their respective officers, directors, +employees, agents, and representatives (collectively, the "**Company +Parties**") and limits the manner in which you can seek relief from +the Company Parties (a) **Applicability of Arbitration Agreement** You - agree that any dispute between you and any of the Company Parties - relating in any way to the Site, the services offered on the Site - (the "**Services**") or these Terms will be resolved by binding - arbitration, rather than in court, except that (1) you and the - Company Parties may assert individualized claims in small claims - court if the claims qualify, remain in such court and advance solely - on an individual, non-class basis; and (2) you or the Company - Parties may seek equitable relief in court for infringement or other - misuse of intellectual property rights (such as trademarks, trade - dress, domain names, trade secrets, copyrights, and patents). **This - Arbitration Agreement shall survive the expiration or termination of - these Terms and shall apply, without limitation, to all claims that - arose or were asserted before you agreed to these Terms (in - accordance with the preamble) or any prior version of these - Terms.** This Arbitration Agreement does not preclude you from - bringing issues to the attention of federal, state or local - agencies. Such agencies can, if the law allows, seek relief against - the Company Parties on your behalf. For purposes of this Arbitration - Agreement, "**Dispute**" will also include disputes that arose or - involve facts occurring before the existence of this or any prior - versions of the Agreement as well as claims that may arise after the - termination of these Terms. +agree that any dispute between you and any of the Company Parties +relating in any way to the Site, the services offered on the Site +(the "**Services**") or these Terms will be resolved by binding +arbitration, rather than in court, except that (1) you and the +Company Parties may assert individualized claims in small claims +court if the claims qualify, remain in such court and advance solely +on an individual, non-class basis; and (2) you or the Company +Parties may seek equitable relief in court for infringement or other +misuse of intellectual property rights (such as trademarks, trade +dress, domain names, trade secrets, copyrights, and patents). **This +Arbitration Agreement shall survive the expiration or termination of +these Terms and shall apply, without limitation, to all claims that +arose or were asserted before you agreed to these Terms (in +accordance with the preamble) or any prior version of these +Terms.** This Arbitration Agreement does not preclude you from +bringing issues to the attention of federal, state or local +agencies. Such agencies can, if the law allows, seek relief against +the Company Parties on your behalf. For purposes of this Arbitration +Agreement, "**Dispute**" will also include disputes that arose or +involve facts occurring before the existence of this or any prior +versions of the Agreement as well as claims that may arise after the +termination of these Terms. (b) **Informal Dispute Resolution.** There might be instances when a - Dispute arises between you and Company. If that occurs, Company is - committed to working with you to reach a reasonable resolution. You - and Company agree that good faith informal efforts to resolve - Disputes can result in a prompt, low‐cost and mutually beneficial - outcome. You and Company therefore agree that before either party - commences arbitration against the other (or initiates an action in - small claims court if a party so elects), we will personally meet - and confer telephonically or via videoconference, in a good faith - effort to resolve informally any Dispute covered by this Arbitration - Agreement ("**Informal Dispute Resolution Conference**"). If you are - represented by counsel, your counsel may participate in the - conference, but you will also participate in the conference. +Dispute arises between you and Company. If that occurs, Company is +committed to working with you to reach a reasonable resolution. You +and Company agree that good faith informal efforts to resolve +Disputes can result in a prompt, low‐cost and mutually beneficial +outcome. You and Company therefore agree that before either party +commences arbitration against the other (or initiates an action in +small claims court if a party so elects), we will personally meet +and confer telephonically or via videoconference, in a good faith +effort to resolve informally any Dispute covered by this Arbitration +Agreement ("**Informal Dispute Resolution Conference**"). If you are +represented by counsel, your counsel may participate in the +conference, but you will also participate in the conference. The party initiating a Dispute must give notice to the other party in writing of its intent to initiate an Informal Dispute Resolution @@ -314,45 +315,45 @@ informal communications to resolve the initiating party's Dispute. Engaging in the Informal Dispute Resolution Conference is a condition precedent and requirement that must be fulfilled before commencing arbitration. The statute of limitations and any filing -fee deadlines shall be tolled while the parties engage in the +fee deadlines shall be tolled while the parties engage in the Informal Dispute Resolution Conference process required by this section. (c) **Arbitration Rules and Forum.** These Terms evidence - a transaction involving interstate commerce; and notwithstanding any - other provision herein with respect to the applicable substantive - law, the Federal Arbitration Act, 9 U.S.C. § 1 et seq., will govern - the interpretation and enforcement of this Arbitration Agreement and - any arbitration proceedings. If the Informal Dispute Resolution - Process described above does not resolve satisfactorily within 60 - days after receipt of your Notice, you and Company agree that either - party shall have the right to finally resolve the Dispute through - binding arbitration. The Federal Arbitration Act governs the - interpretation and enforcement of this Arbitration Agreement. The - arbitration will be conducted by JAMS, an established alternative - dispute resolution provider. Disputes involving claims and - counterclaims with an amount in controversy under \$250,000, not - inclusive of attorneys' fees and interest, shall be subject to JAMS' - most current version of the Streamlined Arbitration Rules and - procedures available - at http://www.jamsadr.com/rules-streamlined-arbitration/; all - other claims shall be subject to JAMS's most current version of the - Comprehensive Arbitration Rules and Procedures, available - at http://www.jamsadr.com/rules-comprehensive-arbitration/. JAMS's - rules are also available at www.jamsadr.com or by calling JAMS at - 800-352-5267. A party who wishes to initiate arbitration must - provide the other party with a request for arbitration (the - "**Request**"). The Request must include: (1) the name, telephone - number, mailing address, e‐mail address of the party seeking - arbitration and the account username (if applicable) as well as the - email address associated with any applicable account; (2) a - statement of the legal claims being asserted and the factual bases - of those claims; (3) a description of the remedy sought and an - accurate, good‐faith calculation of the amount in controversy in - United States Dollars; (4) a statement certifying completion of the - Informal Dispute Resolution process as described above; and (5) - evidence that the requesting party has paid any necessary filing - fees in connection with such arbitration. +a transaction involving interstate commerce; and notwithstanding any +other provision herein with respect to the applicable substantive +law, the Federal Arbitration Act, 9 U.S.C. § 1 et seq., will govern +the interpretation and enforcement of this Arbitration Agreement and +any arbitration proceedings. If the Informal Dispute Resolution +Process described above does not resolve satisfactorily within 60 +days after receipt of your Notice, you and Company agree that either +party shall have the right to finally resolve the Dispute through +binding arbitration. The Federal Arbitration Act governs the +interpretation and enforcement of this Arbitration Agreement. The +arbitration will be conducted by JAMS, an established alternative +dispute resolution provider. Disputes involving claims and +counterclaims with an amount in controversy under \$250,000, not +inclusive of attorneys' fees and interest, shall be subject to JAMS' +most current version of the Streamlined Arbitration Rules and +procedures available +at http://www.jamsadr.com/rules-streamlined-arbitration/; all +other claims shall be subject to JAMS's most current version of the +Comprehensive Arbitration Rules and Procedures, available +at http://www.jamsadr.com/rules-comprehensive-arbitration/. JAMS's +rules are also available at www.jamsadr.com or by calling JAMS at +800-352-5267. A party who wishes to initiate arbitration must +provide the other party with a request for arbitration (the +"**Request**"). The Request must include: (1) the name, telephone +number, mailing address, e‐mail address of the party seeking +arbitration and the account username (if applicable) as well as the +email address associated with any applicable account; (2) a +statement of the legal claims being asserted and the factual bases +of those claims; (3) a description of the remedy sought and an +accurate, good‐faith calculation of the amount in controversy in +United States Dollars; (4) a statement certifying completion of the +Informal Dispute Resolution process as described above; and (5) +evidence that the requesting party has paid any necessary filing +fees in connection with such arbitration. If the party requesting arbitration is represented by counsel, the Request shall also include counsel's name, telephone number, mailing @@ -388,118 +389,118 @@ that they agree to keep all materials and documents exchanged during the arbitration proceedings confidential. (d) **Authority of Arbitrator.** The arbitrator shall have - exclusive authority to resolve all disputes subject to arbitration - hereunder including, without limitation, any dispute related to the - interpretation, applicability, enforceability or formation of this - Arbitration Agreement or any portion of the Arbitration Agreement, - except for the following: (1) all Disputes arising out of or - relating to the subsection entitled "Waiver of Class or Other - Non-Individualized Relief," including any claim that all or part of - the subsection entitled "Waiver of Class or Other Non-Individualized - Relief" is unenforceable, illegal, void or voidable, or that such - subsection entitled "Waiver of Class or Other Non-Individualized - Relief" has been breached, shall be decided by a court of competent - jurisdiction and not by an arbitrator; (2) except as expressly - contemplated in the subsection entitled "Batch Arbitration," all - Disputes about the payment of arbitration fees shall be decided only - by a court of competent jurisdiction and not by an arbitrator; (3) - all Disputes about whether either party has satisfied any condition - precedent to arbitration shall be decided only by a court of - competent jurisdiction and not by an arbitrator; and (4) all - Disputes about which version of the Arbitration Agreement applies - shall be decided only by a court of competent jurisdiction and not - by an arbitrator. The arbitration proceeding will not be - consolidated with any other matters or joined with any other cases - or parties, except as expressly provided in the subsection entitled - "Batch Arbitration." The arbitrator shall have the authority to - grant motions dispositive of all or part of any claim or dispute. - The arbitrator shall have the authority to award monetary damages - and to grant any non-monetary remedy or relief available to an - individual party under applicable law, the arbitral forum's rules, - and these Terms (including the Arbitration Agreement). The - arbitrator shall issue a written award and statement of decision - describing the essential findings and conclusions on which any award - (or decision not to render an award) is based, including the - calculation of any damages awarded. The arbitrator shall follow the - applicable law. The award of the arbitrator is final and binding - upon you and us. Judgment on the arbitration award may be entered in - any court having jurisdiction. +exclusive authority to resolve all disputes subject to arbitration +hereunder including, without limitation, any dispute related to the +interpretation, applicability, enforceability or formation of this +Arbitration Agreement or any portion of the Arbitration Agreement, +except for the following: (1) all Disputes arising out of or +relating to the subsection entitled "Waiver of Class or Other +Non-Individualized Relief," including any claim that all or part of +the subsection entitled "Waiver of Class or Other Non-Individualized +Relief" is unenforceable, illegal, void or voidable, or that such +subsection entitled "Waiver of Class or Other Non-Individualized +Relief" has been breached, shall be decided by a court of competent +jurisdiction and not by an arbitrator; (2) except as expressly +contemplated in the subsection entitled "Batch Arbitration," all +Disputes about the payment of arbitration fees shall be decided only +by a court of competent jurisdiction and not by an arbitrator; (3) +all Disputes about whether either party has satisfied any condition +precedent to arbitration shall be decided only by a court of +competent jurisdiction and not by an arbitrator; and (4) all +Disputes about which version of the Arbitration Agreement applies +shall be decided only by a court of competent jurisdiction and not +by an arbitrator. The arbitration proceeding will not be +consolidated with any other matters or joined with any other cases +or parties, except as expressly provided in the subsection entitled +"Batch Arbitration." The arbitrator shall have the authority to +grant motions dispositive of all or part of any claim or dispute. +The arbitrator shall have the authority to award monetary damages +and to grant any non-monetary remedy or relief available to an +individual party under applicable law, the arbitral forum's rules, +and these Terms (including the Arbitration Agreement). The +arbitrator shall issue a written award and statement of decision +describing the essential findings and conclusions on which any award +(or decision not to render an award) is based, including the +calculation of any damages awarded. The arbitrator shall follow the +applicable law. The award of the arbitrator is final and binding +upon you and us. Judgment on the arbitration award may be entered in +any court having jurisdiction. (e) **Waiver of Jury Trial.** EXCEPT AS SPECIFIED in - section 8.2(a) YOU AND THE COMPANY PARTIES HEREBY WAIVE ANY - CONSTITUTIONAL AND STATUTORY RIGHTS TO SUE IN COURT AND HAVE A TRIAL - IN FRONT OF A JUDGE OR A JURY. You and the Company Parties are - instead electing that all covered claims and disputes shall be - resolved exclusively by arbitration under this Arbitration - Agreement, except as specified in Section 8.2(a) above. An - arbitrator can award on an individual basis the same damages and - relief as a court and must follow these Terms as a court would. - However, there is no judge or jury in arbitration, and court review - of an arbitration award is subject to very limited review.  +section 8.2(a) YOU AND THE COMPANY PARTIES HEREBY WAIVE ANY +CONSTITUTIONAL AND STATUTORY RIGHTS TO SUE IN COURT AND HAVE A TRIAL +IN FRONT OF A JUDGE OR A JURY. You and the Company Parties are +instead electing that all covered claims and disputes shall be +resolved exclusively by arbitration under this Arbitration +Agreement, except as specified in Section 8.2(a) above. An +arbitrator can award on an individual basis the same damages and +relief as a court and must follow these Terms as a court would. +However, there is no judge or jury in arbitration, and court review +of an arbitration award is subject to very limited review. (f) **Waiver of Class or Other Non-Individualized - Relief.**  YOU AND COMPANY AGREE THAT, EXCEPT AS - SPECIFIED IN SUBSECTION 8.2(h) EACH OF US MAY BRING CLAIMS AGAINST - THE OTHER ONLY ON AN INDIVIDUAL BASIS AND NOT ON A CLASS, - REPRESENTATIVE, OR COLLECTIVE BASIS, AND THE PARTIES HEREBY WAIVE - ALL RIGHTS TO HAVE ANY DISPUTE BE BROUGHT, HEARD, ADMINISTERED, - RESOLVED, OR ARBITRATED ON A CLASS, COLLECTIVE, REPRESENTATIVE, OR - MASS ACTION BASIS. ONLY INDIVIDUAL RELIEF IS AVAILABLE, AND DISPUTES - OF MORE THAN ONE CUSTOMER OR USER CANNOT BE ARBITRATED OR - CONSOLIDATED WITH THOSE OF ANY OTHER CUSTOMER OR USER. Subject to - this Arbitration Agreement, the arbitrator may award declaratory or - injunctive relief only in favor of the individual party seeking - relief and only to the extent necessary to provide relief warranted - by the party's individual claim. Nothing in this paragraph is - intended to, nor shall it, affect the terms and conditions under the - Subsection 8.2(h) entitled "Batch Arbitration." Notwithstanding - anything to the contrary in this Arbitration Agreement, if a court - decides by means of a final decision, not subject to any further - appeal or recourse, that the limitations of this subsection, "Waiver - of Class or Other Non-Individualized Relief," are invalid or - unenforceable as to a particular claim or request for relief (such - as a request for public injunctive relief), you and Company agree - that that particular claim or request for relief (and only that - particular claim or request for relief) shall be severed from the - arbitration and may be litigated in the state or federal courts - located in the State of California. All other Disputes shall be - arbitrated or litigated in small claims court. This subsection does - not prevent you or Company from participating in a class-wide - settlement of claims. +Relief.**  YOU AND COMPANY AGREE THAT, EXCEPT AS +SPECIFIED IN SUBSECTION 8.2(h) EACH OF US MAY BRING CLAIMS AGAINST +THE OTHER ONLY ON AN INDIVIDUAL BASIS AND NOT ON A CLASS, +REPRESENTATIVE, OR COLLECTIVE BASIS, AND THE PARTIES HEREBY WAIVE +ALL RIGHTS TO HAVE ANY DISPUTE BE BROUGHT, HEARD, ADMINISTERED, +RESOLVED, OR ARBITRATED ON A CLASS, COLLECTIVE, REPRESENTATIVE, OR +MASS ACTION BASIS. ONLY INDIVIDUAL RELIEF IS AVAILABLE, AND DISPUTES +OF MORE THAN ONE CUSTOMER OR USER CANNOT BE ARBITRATED OR +CONSOLIDATED WITH THOSE OF ANY OTHER CUSTOMER OR USER. Subject to +this Arbitration Agreement, the arbitrator may award declaratory or +injunctive relief only in favor of the individual party seeking +relief and only to the extent necessary to provide relief warranted +by the party's individual claim. Nothing in this paragraph is +intended to, nor shall it, affect the terms and conditions under the +Subsection 8.2(h) entitled "Batch Arbitration." Notwithstanding +anything to the contrary in this Arbitration Agreement, if a court +decides by means of a final decision, not subject to any further +appeal or recourse, that the limitations of this subsection, "Waiver +of Class or Other Non-Individualized Relief," are invalid or +unenforceable as to a particular claim or request for relief (such +as a request for public injunctive relief), you and Company agree +that that particular claim or request for relief (and only that +particular claim or request for relief) shall be severed from the +arbitration and may be litigated in the state or federal courts +located in the State of California. All other Disputes shall be +arbitrated or litigated in small claims court. This subsection does +not prevent you or Company from participating in a class-wide +settlement of claims. (g) **Attorneys' Fees and Costs.** The parties shall bear their own - attorneys' fees and costs in arbitration unless the arbitrator finds - that either the substance of the Dispute or the relief sought in the - Request was frivolous or was brought for an improper purpose (as - measured by the standards set forth in Federal Rule of Civil - Procedure 11(b)). If you or Company need to invoke the authority of - a court of competent jurisdiction to compel arbitration, then the - party that obtains an order compelling arbitration in such action - shall have the right to collect from the other party its reasonable - costs, necessary disbursements, and reasonable attorneys' fees - incurred in securing an order compelling arbitration. The prevailing - party in any court action relating to whether either party has - satisfied any condition precedent to arbitration, including the - Informal Dispute Resolution Process, is entitled to recover their - reasonable costs, necessary disbursements, and reasonable attorneys' - fees and costs. +attorneys' fees and costs in arbitration unless the arbitrator finds +that either the substance of the Dispute or the relief sought in the +Request was frivolous or was brought for an improper purpose (as +measured by the standards set forth in Federal Rule of Civil +Procedure 11(b)). If you or Company need to invoke the authority of +a court of competent jurisdiction to compel arbitration, then the +party that obtains an order compelling arbitration in such action +shall have the right to collect from the other party its reasonable +costs, necessary disbursements, and reasonable attorneys' fees +incurred in securing an order compelling arbitration. The prevailing +party in any court action relating to whether either party has +satisfied any condition precedent to arbitration, including the +Informal Dispute Resolution Process, is entitled to recover their +reasonable costs, necessary disbursements, and reasonable attorneys' +fees and costs. (h) **Batch Arbitration.** To increase the efficiency of administration - and resolution of arbitrations, you and Company agree that in the - event that there are 100 or more individual Requests of a - substantially similar nature filed against Company by or with the - assistance of the same law firm, group of law firms, or - organizations, within a 30 day period (or as soon as possible - thereafter), the JAMS shall (1) administer the arbitration demands - in batches of 100 Requests per batch (plus, to the extent there are - less than 100 Requests left over after the batching described above, - a final batch consisting of the remaining Requests); (2) appoint one - arbitrator for each batch; and (3) provide for the resolution of - each batch as a single consolidated arbitration with one set of - filing and administrative fees due per side per batch, one - procedural calendar, one hearing (if any) in a place to be - determined by the arbitrator, and one final award ("**Batch - Arbitration**"). +and resolution of arbitrations, you and Company agree that in the +event that there are 100 or more individual Requests of a +substantially similar nature filed against Company by or with the +assistance of the same law firm, group of law firms, or +organizations, within a 30 day period (or as soon as possible +thereafter), the JAMS shall (1) administer the arbitration demands +in batches of 100 Requests per batch (plus, to the extent there are +less than 100 Requests left over after the batching described above, +a final batch consisting of the remaining Requests); (2) appoint one +arbitrator for each batch; and (3) provide for the resolution of +each batch as a single consolidated arbitration with one set of +filing and administrative fees due per side per batch, one +procedural calendar, one hearing (if any) in a place to be +determined by the arbitrator, and one final award ("**Batch +Arbitration**"). All parties agree that Requests are of a "substantially similar nature" if they arise out of or relate to the same event or factual @@ -530,109 +531,109 @@ under any circumstances, except as expressly set forth in this provision. (i) **30-Day Right to Opt Out.**  You have the right to opt out of the - provisions of this Arbitration Agreement by sending a timely written - notice of your decision to opt out to the following address: - 2261 Market Street #5686, San Francisco, CA 94114, or email to info@getzep.com, - within 30 days after first becoming subject to this Arbitration - Agreement. Your notice must include your name and address and a - clear statement that you want to opt out of this Arbitration - Agreement. If you opt out of this Arbitration Agreement, all other - parts of these Terms will continue to apply to you. Opting out of - this Arbitration Agreement has no effect on any other arbitration - agreements that you may currently have with us, or may enter into in - the future with us. +provisions of this Arbitration Agreement by sending a timely written +notice of your decision to opt out to the following address: +2261 Market Street #5686, San Francisco, CA 94114, or email to info@getzep.com, +within 30 days after first becoming subject to this Arbitration +Agreement. Your notice must include your name and address and a +clear statement that you want to opt out of this Arbitration +Agreement. If you opt out of this Arbitration Agreement, all other +parts of these Terms will continue to apply to you. Opting out of +this Arbitration Agreement has no effect on any other arbitration +agreements that you may currently have with us, or may enter into in +the future with us. (j) **Invalidity, Expiration.** Except as provided in the subsection - entitled "Waiver of Class or Other Non-Individualized Relief", if - any part or parts of this Arbitration Agreement are found under the - law to be invalid or unenforceable, then such specific part or parts - shall be of no force and effect and shall be severed and the - remainder of the Arbitration Agreement shall continue in full force - and effect. You further agree that any Dispute that you have with - Company as detailed in this Arbitration Agreement must be initiated - via arbitration within the applicable statute of limitation for that - claim or controversy, or it will be forever time barred. Likewise, - you agree that all applicable statutes of limitation will apply to - such arbitration in the same manner as those statutes of limitation - would apply in the applicable court of competent jurisdiction. +entitled "Waiver of Class or Other Non-Individualized Relief", if +any part or parts of this Arbitration Agreement are found under the +law to be invalid or unenforceable, then such specific part or parts +shall be of no force and effect and shall be severed and the +remainder of the Arbitration Agreement shall continue in full force +and effect. You further agree that any Dispute that you have with +Company as detailed in this Arbitration Agreement must be initiated +via arbitration within the applicable statute of limitation for that +claim or controversy, or it will be forever time barred. Likewise, +you agree that all applicable statutes of limitation will apply to +such arbitration in the same manner as those statutes of limitation +would apply in the applicable court of competent jurisdiction. (k)**Modification.** Notwithstanding any provision in - these Terms to the contrary, we agree that if Company makes any - future material change to this Arbitration Agreement, you may reject - that change within 30 days of such change becoming effective by - writing Company at the following address: 2261 Market Street #5686, - San Francisco, CA 94114, or email to info@getzep.com. Unless you reject the - change within 30 days of such change becoming effective by writing - to Company in accordance with the foregoing, your continued use of - the Site and/or Services, including the acceptance of products and - services offered on the Site following the posting of changes to - this Arbitration Agreement constitutes your acceptance of any such - changes. Changes to this Arbitration Agreement do not provide you - with a new opportunity to opt out of the Arbitration Agreement if - you have previously agreed to a version of these Terms and did not - validly opt out of arbitration. If you reject any change or update - to this Arbitration Agreement, and you were bound by an existing - agreement to arbitrate Disputes arising out of or relating in any - way to your access to or use of the Services or of the Site, any - communications you receive, any products sold or distributed through - the Site, the Services, or these Terms, the provisions of this - Arbitration Agreement as of the date you first accepted these Terms - (or accepted any subsequent changes to these Terms) remain in full - force and effect. Company will continue to honor any valid opt outs - of the Arbitration Agreement that you made to a prior version of - these Terms.  +these Terms to the contrary, we agree that if Company makes any +future material change to this Arbitration Agreement, you may reject +that change within 30 days of such change becoming effective by +writing Company at the following address: 2261 Market Street #5686, +San Francisco, CA 94114, or email to info@getzep.com. Unless you reject the +change within 30 days of such change becoming effective by writing +to Company in accordance with the foregoing, your continued use of +the Site and/or Services, including the acceptance of products and +services offered on the Site following the posting of changes to +this Arbitration Agreement constitutes your acceptance of any such +changes. Changes to this Arbitration Agreement do not provide you +with a new opportunity to opt out of the Arbitration Agreement if +you have previously agreed to a version of these Terms and did not +validly opt out of arbitration. If you reject any change or update +to this Arbitration Agreement, and you were bound by an existing +agreement to arbitrate Disputes arising out of or relating in any +way to your access to or use of the Services or of the Site, any +communications you receive, any products sold or distributed through +the Site, the Services, or these Terms, the provisions of this +Arbitration Agreement as of the date you first accepted these Terms +(or accepted any subsequent changes to these Terms) remain in full +force and effect. Company will continue to honor any valid opt outs +of the Arbitration Agreement that you made to a prior version of +these Terms. 8.3. **Export.** The Site may be subject to U.S. export control laws and - may be subject to export or import regulations in other countries. - You agree not to export, reexport, or transfer, directly or - indirectly, any U.S. technical data acquired from Company, or any - products utilizing such data, in violation of the United States - export laws or regulations. +may be subject to export or import regulations in other countries. +You agree not to export, reexport, or transfer, directly or +indirectly, any U.S. technical data acquired from Company, or any +products utilizing such data, in violation of the United States +export laws or regulations. 8.4. **Disclosures.** Company is located at the address in Section 8.8. - If you are a California resident, you may report complaints to the - Complaint Assistance Unit of the Division of Consumer Product of the - California Department of Consumer Affairs by contacting them in - writing at 400 R Street, Sacramento, CA 95814, or by telephone - at (800) 952-5210. +If you are a California resident, you may report complaints to the +Complaint Assistance Unit of the Division of Consumer Product of the +California Department of Consumer Affairs by contacting them in +writing at 400 R Street, Sacramento, CA 95814, or by telephone +at (800) 952-5210. 9.5. **Electronic Communications.** The communications between you and - Company use electronic means, whether you use the Site or send us - emails, or whether Company posts notices on the Site or communicates - with you via email. For contractual purposes, you (a) consent to - receive communications from Company in an electronic form; and (b) - agree that all terms and conditions, agreements, notices, - disclosures, and other communications that Company provides to you - electronically satisfy any legal requirement that such - communications would satisfy if it were be in a hardcopy writing. - The foregoing does not affect your non-waivable rights. +Company use electronic means, whether you use the Site or send us +emails, or whether Company posts notices on the Site or communicates +with you via email. For contractual purposes, you (a) consent to +receive communications from Company in an electronic form; and (b) +agree that all terms and conditions, agreements, notices, +disclosures, and other communications that Company provides to you +electronically satisfy any legal requirement that such +communications would satisfy if it were be in a hardcopy writing. +The foregoing does not affect your non-waivable rights. 8.6. **Entire Terms.** These Terms constitute the entire agreement - between you and us regarding the use of the Site. Our failure to - exercise or enforce any right or provision of these Terms shall not - operate as a waiver of such right or provision. The section titles - in these Terms are for convenience only and have no legal or - contractual effect. The word "including" means "including without - limitation". If any provision of these Terms is, for any reason, - held to be invalid or unenforceable, the other provisions of these - Terms will be unimpaired and the invalid or unenforceable provision - will be deemed modified so that it is valid and enforceable to the - maximum extent permitted by law. Your relationship to Company is - that of an independent contractor, and neither party is an agent or - partner of the other. These Terms, and your rights and obligations - herein, may not be assigned, subcontracted, delegated, or otherwise - transferred by you without Company's prior written consent, and any - attempted assignment, subcontract, delegation, or transfer in - violation of the foregoing will be null and void. Company may freely - assign these Terms. The terms and conditions set forth in these - Terms shall be binding upon assignees. +between you and us regarding the use of the Site. Our failure to +exercise or enforce any right or provision of these Terms shall not +operate as a waiver of such right or provision. The section titles +in these Terms are for convenience only and have no legal or +contractual effect. The word "including" means "including without +limitation". If any provision of these Terms is, for any reason, +held to be invalid or unenforceable, the other provisions of these +Terms will be unimpaired and the invalid or unenforceable provision +will be deemed modified so that it is valid and enforceable to the +maximum extent permitted by law. Your relationship to Company is +that of an independent contractor, and neither party is an agent or +partner of the other. These Terms, and your rights and obligations +herein, may not be assigned, subcontracted, delegated, or otherwise +transferred by you without Company's prior written consent, and any +attempted assignment, subcontract, delegation, or transfer in +violation of the foregoing will be null and void. Company may freely +assign these Terms. The terms and conditions set forth in these +Terms shall be binding upon assignees. 8.7. **Copyright/Trademark Information**. Copyright ©2024 Zep Software, Inc. All rights - reserved. All trademarks, logos and service marks ("**Marks**") - displayed on the Site are our property or the property of other - third parties. You are not permitted to use these Marks without our - prior written consent or the consent of such third party which may - own the Marks. +reserved. All trademarks, logos and service marks ("**Marks**") +displayed on the Site are our property or the property of other +third parties. You are not permitted to use these Marks without our +prior written consent or the consent of such third party which may +own the Marks. **Contact Information:** diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/openapi/openapi.json b/clis/docs-migrator/src/__test__/outputs/zep/fern/openapi/openapi.json index 248078eaf2..8a113c1769 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/openapi/openapi.json +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/openapi/openapi.json @@ -1 +1,1592 @@ -{"openapi":"3.0.1","info":{"title":"Zep Cloud API","contact":{},"version":"0.x"},"servers":[{"url":"https://app.getzep.com/api/v2"}],"paths":{"/api/v2/collections/{collectionName}/documents/uuid/{documentUUID}":{"patch":{"tags":["document"],"summary":"Updates a Document in a DocumentCollection by UUID","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"documentUUID","in":"path","description":"UUID of the Document to be updated","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Document to be updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateDocumentRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"document"}},"/collection/{collectionName}/documents/uuid/{documentUUID}":{"get":{"tags":["document"],"summary":"Gets a Document from a DocumentCollection by UUID","description":"Returns specified Document from a DocumentCollection.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"documentUUID","in":"path","description":"UUID of the Document to be updated","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.DocumentResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/collections":{"get":{"tags":["collection"],"summary":"Gets a list of DocumentCollections","description":"Returns a list of all DocumentCollections.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/models.DocumentCollectionResponse"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/collections/{collectionName}":{"get":{"tags":["collection"],"summary":"Gets a DocumentCollection","description":"Returns a DocumentCollection if it exists.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.DocumentCollectionResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"post":{"tags":["collection"],"summary":"Creates a new DocumentCollection","description":"If a collection with the same name already exists, an error will be returned.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Document Collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CreateDocumentCollectionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"collection"},"delete":{"tags":["collection"],"summary":"Deletes a DocumentCollection","description":"If a collection with the same name already exists, it will be overwritten.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"patch":{"tags":["collection"],"summary":"Updates a DocumentCollection","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Document Collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateDocumentCollectionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"collection"}},"/collections/{collectionName}/document":{"post":{"tags":["document"],"summary":"Creates Multiple Documents in a DocumentCollection","description":"Creates Documents in a specified DocumentCollection and returns their UUIDs.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Array of Documents to be created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.CreateDocumentRequest"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"documents"}},"/collections/{collectionName}/documents/batchDelete":{"post":{"tags":["document"],"summary":"Batch Deletes Documents from a DocumentCollection by UUID","description":"Deletes specified Documents from a DocumentCollection.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"UUIDs of the Documents to be deleted","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"documentUUIDs"}},"/collections/{collectionName}/documents/batchGet":{"post":{"tags":["document"],"summary":"Batch Gets Documents from a DocumentCollection","description":"Returns Documents from a DocumentCollection specified by UUID or ID.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"UUIDs and IDs of the Documents to be fetched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.GetDocumentListRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/models.DocumentResponse"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"documentRequest"}},"/collections/{collectionName}/documents/batchUpdate":{"patch":{"tags":["document"],"summary":"Batch Updates Documents in a DocumentCollection","description":"Updates Documents in a specified DocumentCollection.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Array of Documents to be updated","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.UpdateDocumentListRequest"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"documents"}},"/collections/{collectionName}/documents/uuid/{documentUUID}":{"delete":{"tags":["document"],"summary":"Delete Document from a DocumentCollection by UUID","description":"Delete specified Document from a DocumentCollection.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"documentUUID","in":"path","description":"UUID of the Document to be deleted","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Document Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/collections/{collectionName}/index/create":{"post":{"tags":["collection"],"summary":"Creates an index for a DocumentCollection","description":"Creates an index for the specified DocumentCollection to improve query performance.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"force","in":"query","description":"Force index creation, even if there are too few documents to index","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/collections/{collectionName}/search":{"post":{"tags":["document"],"summary":"Searches Documents in a DocumentCollection","description":"Searches Documents in a DocumentCollection based on provided search criteria.","parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Limit the number of returned documents","schema":{"type":"integer"}}],"requestBody":{"description":"Search criteria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.DocumentSearchPayload"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.DocumentSearchResultPage"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"searchPayload"}},"/sessions":{"get":{"tags":["session"],"summary":"Returns all sessions","description":"Get all sessions with optional limit and cursor for pagination.","parameters":[{"name":"limit","in":"query","description":"Limit the number of results returned","schema":{"type":"integer"}},{"name":"cursor","in":"query","description":"Cursor for pagination","schema":{"type":"integer"}}],"responses":{"200":{"description":"List of sessions","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.Session"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"post":{"tags":["session"],"summary":"Add a session","description":"add session by id","requestBody":{"description":"Session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CreateSessionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Session"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"session"}},"/sessions/{sessionId}":{"get":{"tags":["session"],"summary":"Returns a session by ID","description":"get session by id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Session"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"patch":{"tags":["session"],"summary":"Add a session","description":"add session by id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateSessionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Session"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"session"}},"/sessions/{sessionId}/classify":{"post":{"tags":["session"],"summary":"Classify a session","description":"classify a session by session id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Classify request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ClassifySessionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ClassifySessionResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"classifyRequest"}},"/sessions/{sessionId}/memory":{"get":{"tags":["memory"],"summary":"Returns a memory (latest summary and list of messages) for a given session","description":"get memory by session id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"memoryType","in":"query","description":"memoryType: perpetual or message_window","schema":{"type":"string"}},{"name":"lastn","in":"query","description":"Last N messages. Overrides memory_window configuration","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.Memory"}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"post":{"tags":["memory"],"summary":"Add memory messages to a given session","description":"add memory messages by session id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Memory messages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Memory"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"memoryMessages"},"delete":{"tags":["memory"],"summary":"Delete memory messages for a given session","description":"delete memory messages by session id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/sessions/{sessionId}/messages":{"get":{"tags":["messages"],"summary":"Retrieves all messages for a specific session","description":"get messages by session id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.Message"}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}}}},"/sessions/{sessionId}/messages/{messageId}":{"get":{"tags":["messages"],"summary":"Retrieves a specific message","description":"get message by session id and message id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","description":"Message ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Message"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}}},"patch":{"tags":["messages"],"summary":"Updates the metadata of a specific message","description":"update message metadata by session id and message id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","description":"Message ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"New Metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Message"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Message"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"x-codegen-request-body-name":"body"}},"/sessions/{sessionId}/search":{"post":{"tags":["search"],"summary":"Search memory messages for a given session","description":"search memory messages by session id and query","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Limit the number of results returned","schema":{"type":"integer"}}],"requestBody":{"description":"Search query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.MemorySearchPayload"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.MemorySearchResult"}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"searchPayload"}},"/sessions/{sessionId}/summaries":{"get":{"tags":["session"],"summary":"Returns a session's summaries by ID","description":"Get session summaries by ID","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.SummaryListResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/sessions/{sessionId}/synthesize_question":{"get":{"tags":["memory"],"summary":"Synthesize a question for a given session","description":"synthesize a question by session id","parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"lastNMessages","in":"query","description":"Last N messages","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.Question"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/user":{"get":{"tags":["user"],"summary":"List all users","description":"List all users with pagination.","parameters":[{"name":"pageNumber","in":"query","description":"Page number for pagination, starting from 1","schema":{"type":"integer"}},{"name":"pageSize","in":"query","description":"Number of users to retrieve per page","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successfully retrieved list of users","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.User"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"post":{"tags":["user"],"summary":"Add a user","description":"add user by id","requestBody":{"description":"User","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CreateUserRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.User"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"user"}},"/users-ordered":{"get":{"tags":["user"],"summary":"List all users","description":"list all users","parameters":[{"name":"limit","in":"query","description":"Limit","schema":{"type":"integer"}},{"name":"cursor","in":"query","description":"Cursor","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successfully retrieved list of users","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/models.User"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}},"/users/{userId}":{"get":{"tags":["user"],"summary":"Returns a user by ID","description":"get user by id","parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.User"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"delete":{"tags":["user"],"summary":"Delete a user","description":"delete user by id","parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]},"patch":{"tags":["user"],"summary":"Update a user","description":"update user by id","parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"User","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.User"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}],"x-codegen-request-body-name":"user"}},"/users/{userId}/sessions":{"get":{"tags":["user"],"summary":"List all sessions for a user","description":"list all sessions for a user by user id","parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.Session"}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apihandlers.APIError"}}}}},"security":[{"Bearer":[]}]}}},"components":{"schemas":{"apihandlers.APIError":{"type":"object","properties":{"message":{"type":"string"}}},"models.ClassifySessionRequest":{"type":"object","properties":{"classes":{"type":"array","items":{"type":"string"}},"last_n":{"type":"integer"},"name":{"type":"string"},"persist":{"type":"boolean"},"session_id":{"type":"string"}}},"models.ClassifySessionResponse":{"type":"object","properties":{"class":{"type":"string"},"name":{"type":"string"}}},"models.CreateDocumentCollectionRequest":{"required":["embedding_dimensions","is_auto_embedded","name"],"type":"object","properties":{"description":{"maxLength":1000,"type":"string"},"embedding_dimensions":{"maximum":2000,"minimum":8,"type":"integer"},"is_auto_embedded":{"type":"boolean","description":"these needs to be pointers so that we can distinguish between false and unset when validating"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"name":{"maxLength":40,"minLength":3,"type":"string"}}},"models.CreateDocumentRequest":{"type":"object","properties":{"content":{"type":"string"},"document_id":{"maxLength":100,"type":"string"},"embedding":{"type":"array","items":{"type":"number"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}}}},"models.CreateSessionRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"object"}},"session_id":{"type":"string"},"user_id":{"type":"string","description":"Must be a pointer to allow for null values"}}},"models.CreateUserRequest":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"user_id":{"type":"string"}}},"models.DocumentCollectionResponse":{"type":"object","properties":{"created_at":{"type":"string"},"description":{"type":"string"},"document_count":{"type":"integer","description":"Number of documents in the collection"},"document_embedded_count":{"type":"integer","description":"Number of documents with embeddings"},"embedding_dimensions":{"type":"integer"},"embedding_model_name":{"type":"string"},"is_auto_embedded":{"type":"boolean"},"is_indexed":{"type":"boolean"},"is_normalized":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"name":{"type":"string"},"updated_at":{"type":"string"},"uuid":{"type":"string"}}},"models.DocumentResponse":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"document_id":{"type":"string"},"embedding":{"type":"array","items":{"type":"number"}},"is_embedded":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"updated_at":{"type":"string"},"uuid":{"type":"string"}}},"models.DocumentSearchPayload":{"type":"object","properties":{"collection_name":{"type":"string"},"embedding":{"type":"array","items":{"type":"number"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"min_score":{"type":"number","description":"TODO: implement for documents"},"mmr_lambda":{"type":"number"},"search_type":{"$ref":"#/components/schemas/models.SearchType"},"text":{"type":"string"}}},"models.DocumentSearchResult":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"document_id":{"type":"string"},"embedding":{"type":"array","items":{"type":"number"}},"is_embedded":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"score":{"type":"number"},"updated_at":{"type":"string"},"uuid":{"type":"string"}}},"models.DocumentSearchResultPage":{"type":"object","properties":{"current_page":{"type":"integer"},"query_vector":{"type":"array","items":{"type":"number"}},"result_count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/models.DocumentSearchResult"}},"total_pages":{"type":"integer"}}},"models.GetDocumentListRequest":{"type":"object","properties":{"document_ids":{"type":"array","items":{"type":"string"}},"uuids":{"type":"array","items":{"type":"string"}}}},"models.Memory":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/models.Message"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"summary":{"$ref":"#/components/schemas/models.Summary"}}},"models.MemorySearchPayload":{"type":"object","properties":{"embedding":{"type":"array","items":{"type":"number"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"min_score":{"type":"number"},"mmr_lambda":{"type":"number"},"search_scope":{"$ref":"#/components/schemas/models.SearchScope"},"search_type":{"$ref":"#/components/schemas/models.SearchType"},"text":{"type":"string"}}},"models.MemorySearchResult":{"type":"object","properties":{"embedding":{"type":"array","items":{"type":"number"}},"message":{"$ref":"#/components/schemas/models.Message"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"score":{"type":"number"},"summary":{"$ref":"#/components/schemas/models.Summary"}}},"models.Message":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"role":{"type":"string"}, "role_type": {"type": "string"},"token_count":{"type":"integer"},"updated_at":{"type":"string"},"uuid":{"type":"string"}}},"models.Question":{"type":"object","properties":{"question":{"type":"string"}}},"models.SearchScope":{"type":"string","enum":["messages","summary"],"x-enum-varnames":["SearchScopeMessages","SearchScopeSummary"]},"models.SearchType":{"type":"string","enum":["similarity","mmr"],"x-enum-varnames":["SearchTypeSimilarity","SearchTypeMMR"]},"models.Session":{"type":"object","properties":{"created_at":{"type":"string"},"deleted_at":{"type":"string"},"id":{"type":"integer"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"project_uuid":{"type":"string"},"session_id":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string","description":"Must be a pointer to allow for null values"},"uuid":{"type":"string"}}},"models.Summary":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"related_message_uuids":{"type":"array","items":{"type":"string"}},"token_count":{"type":"integer"},"uuid":{"type":"string"}}},"models.SummaryListResponse":{"type":"object","properties":{"row_count":{"type":"integer"},"summaries":{"type":"array","items":{"$ref":"#/components/schemas/models.Summary"}},"total_count":{"type":"integer"}}},"models.UpdateDocumentCollectionRequest":{"type":"object","properties":{"description":{"maxLength":1000,"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}}}},"models.UpdateDocumentListRequest":{"required":["uuid"],"type":"object","properties":{"document_id":{"maxLength":40,"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"uuid":{"type":"string"}}},"models.UpdateDocumentRequest":{"type":"object","properties":{"document_id":{"maxLength":40,"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}}}},"models.UpdateSessionRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"object"}},"session_id":{"type":"string"}}},"models.UpdateUserRequest":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"user_id":{"type":"string"},"uuid":{"type":"string"}}},"models.User":{"type":"object","properties":{"created_at":{"type":"string"},"deleted_at":{"type":"string"},"email":{"type":"string"},"first_name":{"type":"string"},"id":{"type":"integer"},"last_name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"project_uuid":{"type":"string"},"session_count":{"type":"integer"},"updated_at":{"type":"string"},"user_id":{"type":"string"},"uuid":{"type":"string"}}}},"securitySchemes":{"Bearer":{"type":"apiKey","description":"Type \"Api-Key\" followed by a space and JWT token.","name":"Authorization","in":"header"}}},"x-original-swagger-version":"2.0"} \ No newline at end of file +{ + "openapi": "3.0.1", + "info": { "title": "Zep Cloud API", "contact": {}, "version": "0.x" }, + "servers": [{ "url": "https://app.getzep.com/api/v2" }], + "paths": { + "/api/v2/collections/{collectionName}/documents/uuid/{documentUUID}": { + "patch": { + "tags": ["document"], + "summary": "Updates a Document in a DocumentCollection by UUID", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "documentUUID", + "in": "path", + "description": "UUID of the Document to be updated", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Document to be updated", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.UpdateDocumentRequest" } } + }, + "required": true + }, + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "document" + } + }, + "/collection/{collectionName}/documents/uuid/{documentUUID}": { + "get": { + "tags": ["document"], + "summary": "Gets a Document from a DocumentCollection by UUID", + "description": "Returns specified Document from a DocumentCollection.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "documentUUID", + "in": "path", + "description": "UUID of the Document to be updated", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.DocumentResponse" } } } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/collections": { + "get": { + "tags": ["collection"], + "summary": "Gets a list of DocumentCollections", + "description": "Returns a list of all DocumentCollections.", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "array", + "items": { "$ref": "#/components/schemas/models.DocumentCollectionResponse" } + } + } + } + } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/collections/{collectionName}": { + "get": { + "tags": ["collection"], + "summary": "Gets a DocumentCollection", + "description": "Returns a DocumentCollection if it exists.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.DocumentCollectionResponse" } } + } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "post": { + "tags": ["collection"], + "summary": "Creates a new DocumentCollection", + "description": "If a collection with the same name already exists, an error will be returned.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Document Collection", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.CreateDocumentCollectionRequest" } } + }, + "required": true + }, + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "collection" + }, + "delete": { + "tags": ["collection"], + "summary": "Deletes a DocumentCollection", + "description": "If a collection with the same name already exists, it will be overwritten.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "patch": { + "tags": ["collection"], + "summary": "Updates a DocumentCollection", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Document Collection", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.UpdateDocumentCollectionRequest" } } + }, + "required": true + }, + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "collection" + } + }, + "/collections/{collectionName}/document": { + "post": { + "tags": ["document"], + "summary": "Creates Multiple Documents in a DocumentCollection", + "description": "Creates Documents in a specified DocumentCollection and returns their UUIDs.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Array of Documents to be created", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.CreateDocumentRequest" } } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "documents" + } + }, + "/collections/{collectionName}/documents/batchDelete": { + "post": { + "tags": ["document"], + "summary": "Batch Deletes Documents from a DocumentCollection by UUID", + "description": "Deletes specified Documents from a DocumentCollection.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "UUIDs of the Documents to be deleted", + "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } }, + "required": true + }, + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "documentUUIDs" + } + }, + "/collections/{collectionName}/documents/batchGet": { + "post": { + "tags": ["document"], + "summary": "Batch Gets Documents from a DocumentCollection", + "description": "Returns Documents from a DocumentCollection specified by UUID or ID.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "UUIDs and IDs of the Documents to be fetched", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.GetDocumentListRequest" } } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { "type": "array", "items": { "$ref": "#/components/schemas/models.DocumentResponse" } } + } + } + } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "documentRequest" + } + }, + "/collections/{collectionName}/documents/batchUpdate": { + "patch": { + "tags": ["document"], + "summary": "Batch Updates Documents in a DocumentCollection", + "description": "Updates Documents in a specified DocumentCollection.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Array of Documents to be updated", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { "$ref": "#/components/schemas/models.UpdateDocumentListRequest" } + } + } + }, + "required": true + }, + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "documents" + } + }, + "/collections/{collectionName}/documents/uuid/{documentUUID}": { + "delete": { + "tags": ["document"], + "summary": "Delete Document from a DocumentCollection by UUID", + "description": "Delete specified Document from a DocumentCollection.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "documentUUID", + "in": "path", + "description": "UUID of the Document to be deleted", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Document Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/collections/{collectionName}/index/create": { + "post": { + "tags": ["collection"], + "summary": "Creates an index for a DocumentCollection", + "description": "Creates an index for the specified DocumentCollection to improve query performance.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "force", + "in": "query", + "description": "Force index creation, even if there are too few documents to index", + "schema": { "type": "boolean" } + } + ], + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/collections/{collectionName}/search": { + "post": { + "tags": ["document"], + "summary": "Searches Documents in a DocumentCollection", + "description": "Searches Documents in a DocumentCollection based on provided search criteria.", + "parameters": [ + { + "name": "collectionName", + "in": "path", + "description": "Name of the Document Collection", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "limit", + "in": "query", + "description": "Limit the number of returned documents", + "schema": { "type": "integer" } + } + ], + "requestBody": { + "description": "Search criteria", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.DocumentSearchPayload" } } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.DocumentSearchResultPage" } } + } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "401": { + "description": "Unauthorized", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "searchPayload" + } + }, + "/sessions": { + "get": { + "tags": ["session"], + "summary": "Returns all sessions", + "description": "Get all sessions with optional limit and cursor for pagination.", + "parameters": [ + { + "name": "limit", + "in": "query", + "description": "Limit the number of results returned", + "schema": { "type": "integer" } + }, + { "name": "cursor", "in": "query", "description": "Cursor for pagination", "schema": { "type": "integer" } } + ], + "responses": { + "200": { + "description": "List of sessions", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.Session" } } + } + } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "post": { + "tags": ["session"], + "summary": "Add a session", + "description": "add session by id", + "requestBody": { + "description": "Session", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.CreateSessionRequest" } } + }, + "required": true + }, + "responses": { + "201": { + "description": "Created", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Session" } } } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "session" + } + }, + "/sessions/{sessionId}": { + "get": { + "tags": ["session"], + "summary": "Returns a session by ID", + "description": "get session by id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Session" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "patch": { + "tags": ["session"], + "summary": "Add a session", + "description": "add session by id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Session", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.UpdateSessionRequest" } } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Session" } } } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "session" + } + }, + "/sessions/{sessionId}/classify": { + "post": { + "tags": ["session"], + "summary": "Classify a session", + "description": "classify a session by session id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Classify request", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.ClassifySessionRequest" } } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.ClassifySessionResponse" } } + } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "classifyRequest" + } + }, + "/sessions/{sessionId}/memory": { + "get": { + "tags": ["memory"], + "summary": "Returns a memory (latest summary and list of messages) for a given session", + "description": "get memory by session id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "memoryType", + "in": "query", + "description": "memoryType: perpetual or message_window", + "schema": { "type": "string" } + }, + { + "name": "lastn", + "in": "query", + "description": "Last N messages. Overrides memory_window configuration", + "schema": { "type": "integer" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.Memory" } } + } + } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "post": { + "tags": ["memory"], + "summary": "Add memory messages to a given session", + "description": "add memory messages by session id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "Memory messages", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Memory" } } }, + "required": true + }, + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "memoryMessages" + }, + "delete": { + "tags": ["memory"], + "summary": "Delete memory messages for a given session", + "description": "delete memory messages by session id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/sessions/{sessionId}/messages": { + "get": { + "tags": ["messages"], + "summary": "Retrieves all messages for a specific session", + "description": "get messages by session id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.Message" } } + } + } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + } + } + }, + "/sessions/{sessionId}/messages/{messageId}": { + "get": { + "tags": ["messages"], + "summary": "Retrieves a specific message", + "description": "get message by session id and message id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "messageId", + "in": "path", + "description": "Message ID", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Message" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + } + }, + "patch": { + "tags": ["messages"], + "summary": "Updates the metadata of a specific message", + "description": "update message metadata by session id and message id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "messageId", + "in": "path", + "description": "Message ID", + "required": true, + "schema": { "type": "string" } + } + ], + "requestBody": { + "description": "New Metadata", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Message" } } }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Message" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "x-codegen-request-body-name": "body" + } + }, + "/sessions/{sessionId}/search": { + "post": { + "tags": ["search"], + "summary": "Search memory messages for a given session", + "description": "search memory messages by session id and query", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + }, + { + "name": "limit", + "in": "query", + "description": "Limit the number of results returned", + "schema": { "type": "integer" } + } + ], + "requestBody": { + "description": "Search query", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.MemorySearchPayload" } } + }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.MemorySearchResult" } } + } + } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "searchPayload" + } + }, + "/sessions/{sessionId}/summaries": { + "get": { + "tags": ["session"], + "summary": "Returns a session's summaries by ID", + "description": "Get session summaries by ID", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { "schema": { "$ref": "#/components/schemas/models.SummaryListResponse" } } + } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/sessions/{sessionId}/synthesize_question": { + "get": { + "tags": ["memory"], + "summary": "Synthesize a question for a given session", + "description": "synthesize a question by session id", + "parameters": [ + { + "name": "sessionId", + "in": "path", + "description": "Session ID", + "required": true, + "schema": { "type": "string" } + }, + { "name": "lastNMessages", "in": "query", "description": "Last N messages", "schema": { "type": "integer" } } + ], + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.Question" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/user": { + "get": { + "tags": ["user"], + "summary": "List all users", + "description": "List all users with pagination.", + "parameters": [ + { + "name": "pageNumber", + "in": "query", + "description": "Page number for pagination, starting from 1", + "schema": { "type": "integer" } + }, + { + "name": "pageSize", + "in": "query", + "description": "Number of users to retrieve per page", + "schema": { "type": "integer" } + } + ], + "responses": { + "200": { + "description": "Successfully retrieved list of users", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.User" } } + } + } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "post": { + "tags": ["user"], + "summary": "Add a user", + "description": "add user by id", + "requestBody": { + "description": "User", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.CreateUserRequest" } } }, + "required": true + }, + "responses": { + "201": { + "description": "Created", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.User" } } } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "user" + } + }, + "/users-ordered": { + "get": { + "tags": ["user"], + "summary": "List all users", + "description": "list all users", + "parameters": [ + { "name": "limit", "in": "query", "description": "Limit", "schema": { "type": "integer" } }, + { "name": "cursor", "in": "query", "description": "Cursor", "schema": { "type": "integer" } } + ], + "responses": { + "200": { + "description": "Successfully retrieved list of users", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { "type": "array", "items": { "$ref": "#/components/schemas/models.User" } } + } + } + } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + }, + "/users/{userId}": { + "get": { + "tags": ["user"], + "summary": "Returns a user by ID", + "description": "get user by id", + "parameters": [ + { "name": "userId", "in": "path", "description": "User ID", "required": true, "schema": { "type": "string" } } + ], + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.User" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "delete": { + "tags": ["user"], + "summary": "Delete a user", + "description": "delete user by id", + "parameters": [ + { "name": "userId", "in": "path", "description": "User ID", "required": true, "schema": { "type": "string" } } + ], + "responses": { + "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "string" } } } }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + }, + "patch": { + "tags": ["user"], + "summary": "Update a user", + "description": "update user by id", + "parameters": [ + { "name": "userId", "in": "path", "description": "User ID", "required": true, "schema": { "type": "string" } } + ], + "requestBody": { + "description": "User", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.UpdateUserRequest" } } }, + "required": true + }, + "responses": { + "200": { + "description": "OK", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/models.User" } } } + }, + "400": { + "description": "Bad Request", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "404": { + "description": "Not Found", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }], + "x-codegen-request-body-name": "user" + } + }, + "/users/{userId}/sessions": { + "get": { + "tags": ["user"], + "summary": "List all sessions for a user", + "description": "list all sessions for a user by user id", + "parameters": [ + { "name": "userId", "in": "path", "description": "User ID", "required": true, "schema": { "type": "string" } } + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { "type": "array", "items": { "$ref": "#/components/schemas/models.Session" } } + } + } + }, + "500": { + "description": "Internal Server Error", + "content": { "application/json": { "schema": { "$ref": "#/components/schemas/apihandlers.APIError" } } } + } + }, + "security": [{ "Bearer": [] }] + } + } + }, + "components": { + "schemas": { + "apihandlers.APIError": { "type": "object", "properties": { "message": { "type": "string" } } }, + "models.ClassifySessionRequest": { + "type": "object", + "properties": { + "classes": { "type": "array", "items": { "type": "string" } }, + "last_n": { "type": "integer" }, + "name": { "type": "string" }, + "persist": { "type": "boolean" }, + "session_id": { "type": "string" } + } + }, + "models.ClassifySessionResponse": { + "type": "object", + "properties": { "class": { "type": "string" }, "name": { "type": "string" } } + }, + "models.CreateDocumentCollectionRequest": { + "required": ["embedding_dimensions", "is_auto_embedded", "name"], + "type": "object", + "properties": { + "description": { "maxLength": 1000, "type": "string" }, + "embedding_dimensions": { "maximum": 2000, "minimum": 8, "type": "integer" }, + "is_auto_embedded": { + "type": "boolean", + "description": "these needs to be pointers so that we can distinguish between false and unset when validating" + }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "name": { "maxLength": 40, "minLength": 3, "type": "string" } + } + }, + "models.CreateDocumentRequest": { + "type": "object", + "properties": { + "content": { "type": "string" }, + "document_id": { "maxLength": 100, "type": "string" }, + "embedding": { "type": "array", "items": { "type": "number" } }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } } + } + }, + "models.CreateSessionRequest": { + "type": "object", + "properties": { + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "session_id": { "type": "string" }, + "user_id": { "type": "string", "description": "Must be a pointer to allow for null values" } + } + }, + "models.CreateUserRequest": { + "type": "object", + "properties": { + "email": { "type": "string" }, + "first_name": { "type": "string" }, + "last_name": { "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "user_id": { "type": "string" } + } + }, + "models.DocumentCollectionResponse": { + "type": "object", + "properties": { + "created_at": { "type": "string" }, + "description": { "type": "string" }, + "document_count": { "type": "integer", "description": "Number of documents in the collection" }, + "document_embedded_count": { "type": "integer", "description": "Number of documents with embeddings" }, + "embedding_dimensions": { "type": "integer" }, + "embedding_model_name": { "type": "string" }, + "is_auto_embedded": { "type": "boolean" }, + "is_indexed": { "type": "boolean" }, + "is_normalized": { "type": "boolean" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "name": { "type": "string" }, + "updated_at": { "type": "string" }, + "uuid": { "type": "string" } + } + }, + "models.DocumentResponse": { + "type": "object", + "properties": { + "content": { "type": "string" }, + "created_at": { "type": "string" }, + "document_id": { "type": "string" }, + "embedding": { "type": "array", "items": { "type": "number" } }, + "is_embedded": { "type": "boolean" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "updated_at": { "type": "string" }, + "uuid": { "type": "string" } + } + }, + "models.DocumentSearchPayload": { + "type": "object", + "properties": { + "collection_name": { "type": "string" }, + "embedding": { "type": "array", "items": { "type": "number" } }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "min_score": { "type": "number", "description": "TODO: implement for documents" }, + "mmr_lambda": { "type": "number" }, + "search_type": { "$ref": "#/components/schemas/models.SearchType" }, + "text": { "type": "string" } + } + }, + "models.DocumentSearchResult": { + "type": "object", + "properties": { + "content": { "type": "string" }, + "created_at": { "type": "string" }, + "document_id": { "type": "string" }, + "embedding": { "type": "array", "items": { "type": "number" } }, + "is_embedded": { "type": "boolean" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "score": { "type": "number" }, + "updated_at": { "type": "string" }, + "uuid": { "type": "string" } + } + }, + "models.DocumentSearchResultPage": { + "type": "object", + "properties": { + "current_page": { "type": "integer" }, + "query_vector": { "type": "array", "items": { "type": "number" } }, + "result_count": { "type": "integer" }, + "results": { "type": "array", "items": { "$ref": "#/components/schemas/models.DocumentSearchResult" } }, + "total_pages": { "type": "integer" } + } + }, + "models.GetDocumentListRequest": { + "type": "object", + "properties": { + "document_ids": { "type": "array", "items": { "type": "string" } }, + "uuids": { "type": "array", "items": { "type": "string" } } + } + }, + "models.Memory": { + "type": "object", + "properties": { + "messages": { "type": "array", "items": { "$ref": "#/components/schemas/models.Message" } }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "summary": { "$ref": "#/components/schemas/models.Summary" } + } + }, + "models.MemorySearchPayload": { + "type": "object", + "properties": { + "embedding": { "type": "array", "items": { "type": "number" } }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "min_score": { "type": "number" }, + "mmr_lambda": { "type": "number" }, + "search_scope": { "$ref": "#/components/schemas/models.SearchScope" }, + "search_type": { "$ref": "#/components/schemas/models.SearchType" }, + "text": { "type": "string" } + } + }, + "models.MemorySearchResult": { + "type": "object", + "properties": { + "embedding": { "type": "array", "items": { "type": "number" } }, + "message": { "$ref": "#/components/schemas/models.Message" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "score": { "type": "number" }, + "summary": { "$ref": "#/components/schemas/models.Summary" } + } + }, + "models.Message": { + "type": "object", + "properties": { + "content": { "type": "string" }, + "created_at": { "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "role": { "type": "string" }, + "role_type": { "type": "string" }, + "token_count": { "type": "integer" }, + "updated_at": { "type": "string" }, + "uuid": { "type": "string" } + } + }, + "models.Question": { "type": "object", "properties": { "question": { "type": "string" } } }, + "models.SearchScope": { + "type": "string", + "enum": ["messages", "summary"], + "x-enum-varnames": ["SearchScopeMessages", "SearchScopeSummary"] + }, + "models.SearchType": { + "type": "string", + "enum": ["similarity", "mmr"], + "x-enum-varnames": ["SearchTypeSimilarity", "SearchTypeMMR"] + }, + "models.Session": { + "type": "object", + "properties": { + "created_at": { "type": "string" }, + "deleted_at": { "type": "string" }, + "id": { "type": "integer" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "project_uuid": { "type": "string" }, + "session_id": { "type": "string" }, + "updated_at": { "type": "string" }, + "user_id": { "type": "string", "description": "Must be a pointer to allow for null values" }, + "uuid": { "type": "string" } + } + }, + "models.Summary": { + "type": "object", + "properties": { + "content": { "type": "string" }, + "created_at": { "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "related_message_uuids": { "type": "array", "items": { "type": "string" } }, + "token_count": { "type": "integer" }, + "uuid": { "type": "string" } + } + }, + "models.SummaryListResponse": { + "type": "object", + "properties": { + "row_count": { "type": "integer" }, + "summaries": { "type": "array", "items": { "$ref": "#/components/schemas/models.Summary" } }, + "total_count": { "type": "integer" } + } + }, + "models.UpdateDocumentCollectionRequest": { + "type": "object", + "properties": { + "description": { "maxLength": 1000, "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } } + } + }, + "models.UpdateDocumentListRequest": { + "required": ["uuid"], + "type": "object", + "properties": { + "document_id": { "maxLength": 40, "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "uuid": { "type": "string" } + } + }, + "models.UpdateDocumentRequest": { + "type": "object", + "properties": { + "document_id": { "maxLength": 40, "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } } + } + }, + "models.UpdateSessionRequest": { + "type": "object", + "properties": { + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "session_id": { "type": "string" } + } + }, + "models.UpdateUserRequest": { + "type": "object", + "properties": { + "email": { "type": "string" }, + "first_name": { "type": "string" }, + "last_name": { "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "user_id": { "type": "string" }, + "uuid": { "type": "string" } + } + }, + "models.User": { + "type": "object", + "properties": { + "created_at": { "type": "string" }, + "deleted_at": { "type": "string" }, + "email": { "type": "string" }, + "first_name": { "type": "string" }, + "id": { "type": "integer" }, + "last_name": { "type": "string" }, + "metadata": { "type": "object", "additionalProperties": { "type": "object" } }, + "project_uuid": { "type": "string" }, + "session_count": { "type": "integer" }, + "updated_at": { "type": "string" }, + "user_id": { "type": "string" }, + "uuid": { "type": "string" } + } + } + }, + "securitySchemes": { + "Bearer": { + "type": "apiKey", + "description": "Type \"Api-Key\" followed by a space and JWT token.", + "name": "Authorization", + "in": "header" + } + } + }, + "x-original-swagger-version": "2.0" +} diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/projects.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/projects.mdx index 5c588f690b..f571308688 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/projects.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/projects.mdx @@ -2,31 +2,36 @@ slug: projects --- - -Projects encapsulate abstractions such as Users, Sessions, Memories, and Documents, and various settings. - This allows you to keep your data organized by service, environment (such as development or production), or any other criteria that makes sense for your use case. - + + Projects encapsulate abstractions such as Users, Sessions, Memories, and Documents, and various settings. This allows + you to keep your data organized by service, environment (such as development or production), or any other criteria + that makes sense for your use case. + ## Creating a Project + When you sign up for Zep, your first project is automatically created. You'll be asked to configure a few project-specific settings (details below). If you need more projects, you can create them anytime through the [Zep Web App](https://app.getzep.com/projects/create). - Create a new project + Create a new project ### Project Essentials -* Unique Project Name: Choose a unique name for your project. -* Description (Optional): Feel free to add a brief description of your project. -* Model Selection: Let us know which LLM you'll be using. We count tokens in Zep artifacts like Messages and Summaries to help you stay within your prompt token budget. Knowing your model choice ensures we use the correct tokenizer. + +- Unique Project Name: Choose a unique name for your project. +- Description (Optional): Feel free to add a brief description of your project. +- Model Selection: Let us know which LLM you'll be using. We count tokens in Zep artifacts like Messages and Summaries to help you stay within your prompt token budget. Knowing your model choice ensures we use the correct tokenizer. > **You can modify your project settings later from the Dashboard.** ## Message Window + The Message Window, also known as the Memory Window, is a project setting that specifies how many messages are retrieved in a `GetMemory` call. It's set to a default of `6` messages and, while not adjustable during the initial project setup, can be easily changed later through the dashboard. ## LLM Model Selection and Token Counting + Select the LLM you'll be using for your Assistant. We count tokens in Zep artifacts like Messages and Summaries to help you stay within your prompt token budget. Knowing your model choice ensures we use the correct tokenizer. @@ -34,4 +39,5 @@ Knowing your model choice ensures we use the correct tokenizer. Available options are `GPT 3.5 or 4 family` and `Llama2 and related`. ## API Keys -API keys are specific to each project. You can create multiple keys for a single project. + +API keys are specific to each project. You can create multiple keys for a single project. diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/question-synthesis.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/question-synthesis.mdx index 11902f06cc..600a062857 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/question-synthesis.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/question-synthesis.mdx @@ -3,27 +3,29 @@ title: Question Synthesis slug: question-synthesis --- -Users often respond to questions with single-word answers that don't offer much information for search. + +Users often respond to questions with single-word answers that don't offer much information for search. For example, a user may respond to a question about their favorite book with "Dune" or a question about their -dietary restrictions with "dairy". +dietary restrictions with "dairy". - Without context, many user messages lack information necessary to successfully embed - a search query, resulting in poor or irrelevant search results. + Without context, many user messages lack information necessary to successfully embed a search query, resulting in poor + or irrelevant search results. Zep provides a low-latency question synthesis API that can be used to generate a question from the current conversation context, using -the most recent message to center the question. The resulting question can be used to search over document Collections or +the most recent message to center the question. The resulting question can be used to search over document Collections or chat history Messages and Summaries. Zep's [Perpetual Memory](/chat-history-memory) uses this question synthesis functionality internally to ensure that Memories it returns are relevant and useful. -While it's possible to synthesize a question using a general purpose LLM, this is often a slow and inaccurate exercise. +While it's possible to synthesize a question using a general purpose LLM, this is often a slow and inaccurate exercise. Zep's private, fine-tuned models are designed to return results in hundreds of milliseconds. - Want to see Question Synthesis in action? Take a look at [Zep's LangService VectorStore example](https://github.com/getzep/zep-python/blob/main/examples/langchain-langserve/app/message_history_vector_store_chain.py). + Want to see Question Synthesis in action? Take a look at [Zep's LangService VectorStore + example](https://github.com/getzep/zep-python/blob/main/examples/langchain-langserve/app/message_history_vector_store_chain.py). @@ -50,6 +52,7 @@ user: Is it easy to find vegetarian or vegan food in Iceland? assistant: Yes, Reykjavik has several vegetarian and vegan-friendly restaurants. Do you have any dietary restrictions? user: Yes, dairy. ``` + ```Text Can the user eat dairy products? -``` \ No newline at end of file +``` diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/sdks.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/sdks.mdx index c8206500e0..242792c07d 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/sdks.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/sdks.mdx @@ -16,12 +16,14 @@ To install the Zep Python SDK with Zep Cloud support, you'll need to install a r ```Bash pip install --pre zep-python ``` + ```Bash poetry add zep-python@^2.0.0rc ``` + @@ -29,7 +31,6 @@ poetry add zep-python@^2.0.0rc To install the Zep JavaScript SDK with Zep Cloud support, please install a pre-release version tagged with `@next`. - @@ -37,24 +38,26 @@ To install the Zep JavaScript SDK with Zep Cloud support, please install a pre-r ```Bash npm install @getzep/zep-js@next ``` + ```Bash yarn add @getzep/zep-js@next ``` + ```Bash pnpm install @getzep/zep-js@next ``` + ## Initialize Client - @@ -66,18 +69,18 @@ API_KEY = os.environ.get('ZEP_API_KEY') zep = ZepClient(api_key=API_KEY) ``` + ```typescript import { ZepClient } from "@getzep/zep-js"; -API_KEY = process.env.ZEP_API_KEY +API_KEY = process.env.ZEP_API_KEY; -const zep = await ZepClient.init( - API_KEY, -); +const zep = await ZepClient.init(API_KEY); ``` + @@ -88,12 +91,13 @@ const zep = await ZepClient.init( **The Python SDK Supports Async Use** - All methods are available as both sync and async, with the async methods prefixed with `a`. +All methods are available as both sync and async, with the async methods prefixed with `a`. For example, zep-python - has both `zep_client.memory.add_memory` and `zep_client.memory.aadd_memory` methods. - +has both `zep_client.memory.add_memory` and `zep_client.memory.aadd_memory` methods. + + ## LangChain @@ -111,6 +115,7 @@ Import the classes as shown below: ```python from zep_python.langchain import ZepChatMessageHistory, ZepVectorStore ``` + @@ -127,8 +132,9 @@ npm install langchain To import these classes, use the following syntax: ```typescript -import { ZepChatMessageHistory, ZepVectorStore } from "@getzep/zep-js/langchain" +import { ZepChatMessageHistory, ZepVectorStore } from "@getzep/zep-js/langchain"; ``` + @@ -138,7 +144,3 @@ import { ZepChatMessageHistory, ZepVectorStore } from "@getzep/zep-js/langchain" ## LlamaIndex Stay tuned! We are in the process of updating our LlamaIndex integration to be compatible with the latest Zep API. - - - - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/users.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/users.mdx index df38162422..ada2b868ef 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/users.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/users.mdx @@ -19,6 +19,7 @@ In the following sections, you will learn how to manage Users and their associat By associating a User with a Session, you can delete all Sessions and session artifacts associated with a User with a single API call. + ## The User model @@ -34,6 +35,7 @@ You can associate rich business context with a User: ## Adding a User You can add a new user by providing the user details. + @@ -53,32 +55,34 @@ user_request = CreateUserRequest( ) new_user = client.user.add(user_request) ``` + ```typescript -import { ZepClient, CreateUserRequest, UpdateUserRequest } from '@getzep/zep-js'; +import { ZepClient, CreateUserRequest, UpdateUserRequest } from "@getzep/zep-js"; const client: ZepClient = await ZepClient.init(API_KEY); const user_request: CreateUserRequest = { - userId: user_id, - email: "user@example.com", - firstName: "Jane", - lastName: "Smith", - metadata: { foo: "bar" }, + userId: user_id, + email: "user@example.com", + firstName: "Jane", + lastName: "Smith", + metadata: { foo: "bar" }, }; const new_user = await client.user.add(user_request); ``` + - > Learn how to associate [Sessions with Users](chat-history-memory/sessions.mdx) ## Getting a User You can retrieve a user by their ID. + @@ -86,19 +90,21 @@ You can retrieve a user by their ID. ```python user = client.user.get("user123") ``` + ```typescript -const user = await client.user.get("user123") +const user = await client.user.get("user123"); ``` + - ## Updating a User You can update a user's details by providing the updated user details. + @@ -114,27 +120,29 @@ user_request = UpdateUserRequest( updated_user = client.user.update(user_request) ``` + ```typescript const user_request: UpdateUserRequest = { - userId: user_id, - email: "updated_user@example.com", - firstName: "Jane", - lastName: "Smith", - metadata: { foo: "updated_bar" }, + userId: user_id, + email: "updated_user@example.com", + firstName: "Jane", + lastName: "Smith", + metadata: { foo: "updated_bar" }, }; const updated_user = await client.user.update(user_request); ``` + - ## Deleting a User You can delete a user by their ID. + @@ -142,16 +150,17 @@ You can delete a user by their ID. ```python client.user.delete("user123") ``` + ```typescript -await client.user.delete("user123") +await client.user.delete("user123"); ``` + - ## Getting a User's Sessions You can retrieve all Sessions for a user by their ID. @@ -162,19 +171,21 @@ You can retrieve all Sessions for a user by their ID. ```python sessions = client.user.get_sessions("user123") ``` + ```typescript -const sessions = await client.user.getSessions("user123") +const sessions = await client.user.getSessions("user123"); ``` + - ## Listing Users You can list all users, with optional limit and cursor parameters for pagination. + @@ -183,21 +194,23 @@ You can list all users, with optional limit and cursor parameters for pagination # List the first 10 users users = client.user.list(limit=10, cursor=0) ``` + ```typescript // List the first 10 users -const users = await client.user.list(10, 0) +const users = await client.user.list(10, 0); ``` + - ## Listing Users in Chunks You can retrieve users in chunks of a specified size. This is a generator function that yields each chunk of users as they are retrieved. + @@ -205,16 +218,16 @@ they are retrieved. for users in client.user.list_chunked(chunkSize=100): process(users) ``` + ```typescript for await (const chunk of client.user.listChunked(100)) { - // Process each chunk of users - await processChunk(chunk); + // Process each chunk of users + await processChunk(chunk); } ``` + - - diff --git a/clis/docs-migrator/src/__test__/outputs/zep/fern/working-with-search.mdx b/clis/docs-migrator/src/__test__/outputs/zep/fern/working-with-search.mdx index 875ed80984..777b777499 100644 --- a/clis/docs-migrator/src/__test__/outputs/zep/fern/working-with-search.mdx +++ b/clis/docs-migrator/src/__test__/outputs/zep/fern/working-with-search.mdx @@ -5,14 +5,14 @@ slug: working-with-search - Zep's Collection and Memory search supports semantic similarity search and similarity search re-ranked by [Maximal Marginal Relevance](#maximal-marginal-relevance-re-ranking). - Both of these search types can be filtered by JSONPath-based metadata filters. Memory search also supports querying by message or summary creation date. + Zep's Collection and Memory search supports semantic similarity search and similarity search re-ranked by [Maximal + Marginal Relevance](#maximal-marginal-relevance-re-ranking). Both of these search types can be filtered by + JSONPath-based metadata filters. Memory search also supports querying by message or summary creation date. - ## Simple, Text-based Semantic Queries -The simplest form of search query is a text-based semantic simailrity query. No metadata filter is required, and the query is simply a string of text. +The simplest form of search query is a text-based semantic simailrity query. No metadata filter is required, and the query is simply a string of text. Zep will convert the query into an embedding and find semantically similar documents, chat history summaries, or chat messages. Below is an example search against a chat session using only search text. @@ -33,7 +33,7 @@ search_payload = MemorySearchPayload( search_scope="messages", metadata={"where": {"jsonpath": '$[*] ? (@.bar == "foo")'}}, ) - + search_results = await client.memory.search_memory(session_id, search_payload) ``` @@ -47,9 +47,9 @@ import { ZepClient, MemorySearchPayload } from "@getzep/zep-js"; const zepClient = await ZepClient.init(process.env.ZEP_API_KEY); const searchPayload = new MemorySearchPayload({ - text: query, - search_scope: "messages", - metadata: { where: { jsonpath: '$[*] ? (@.bar == "foo")' } } + text: query, + search_scope: "messages", + metadata: { where: { jsonpath: '$[*] ? (@.bar == "foo")' } }, }); const searchResults = await client.memory.searchMemory(sessionId, searchPayload); @@ -58,8 +58,6 @@ const searchResults = await client.memory.searchMemory(sessionId, searchPayload) - - Read more about [chat message history search](chat-history-memory/search.mdx). ## Maximal Marginal Relevance Re-Ranking @@ -85,8 +83,6 @@ Zep's MMR algorithm is SIMD-hardware accelerated on `amd64` archicture CPUs, ens

Constructing an MMR Re-Ranked Search Query

- - #### MMR Search over Chat History @@ -123,10 +119,10 @@ import { ZepClient, MemorySearchPayload } from "@getzep/zep-js"; const zepClient = await ZepClient.init(process.env.ZEP_API_KEY); const searchPayload = new MemorySearchPayload({ - text: query, - search_scope: "summary", // This could be messages or summary - search_type: "mmr", - mmrLambda: 0.5, // tune diversity vs relevance + text: query, + search_scope: "summary", // This could be messages or summary + search_type: "mmr", + mmrLambda: 0.5, // tune diversity vs relevance }); const searchResults = await client.memory.searchMemory(sessionId, searchPayload, 3); @@ -135,7 +131,6 @@ const searchResults = await client.memory.searchMemory(sessionId, searchPayload, - #### MMR Search over Document Collections @@ -158,11 +153,14 @@ docs = collection.search( ```typescript // This assumes you've created a collection and added documents to it -const docs = await collection.search({ +const docs = await collection.search( + { text: query, search_type: "mmr", mmr_lambda: 0.5, -}, 3); + }, + 3, +); ``` @@ -175,6 +173,7 @@ Zep supports filtering search queries by metadata. Metadata filters are [JSONPat JSONPath queries allow for building sophisticated filters that match on elements at any level of the JSON document. The boolean logic overlay allows for combining multiple JSONPath queries using `and` and `or` operators. ### Useful resources for building and testing JSONPath queries + - [JSONPath Syntax](https://goessner.net/articles/JsonPath/) - [JSONPath Online Evaluator](https://jsonpath.com/) - [JSONPath Expression Tester](https://jsonpath.curiousconcept.com/#). @@ -196,7 +195,6 @@ Executing the above query against a chat session looks as follows: - ```python search_payload = MemorySearchPayload( text="Is Lauren Olamina a character in a book", @@ -216,17 +214,16 @@ search_results = client.memory.search_memory(session_id, search_payload) ```typescript const searchPayload = new MemorySearchPayload({ - text: "Is Lauren Olamina a character in a book", - metadata: { where: { jsonpath: '$[*] ? (@.author == "Octavia Butler")' } } + text: "Is Lauren Olamina a character in a book", + metadata: { where: { jsonpath: '$[*] ? (@.author == "Octavia Butler")' } }, }); -const search_results = await client.memory.searchMemory(session_id, search_payload) +const search_results = await client.memory.searchMemory(session_id, search_payload); ``` - ### Combining multiple JSONPath filters using boolean logic Multiple JSONPath queries can be combined using boolean logic. The following example will return documents or messages where the `author` field is equal to `"Octavia Butler"` **and** the `title` field is equal to `"Parable of the Sower"`. diff --git a/packages/generator-cli/.depcheckrc.json b/clis/generator-cli/.depcheckrc.json similarity index 100% rename from packages/generator-cli/.depcheckrc.json rename to clis/generator-cli/.depcheckrc.json diff --git a/packages/generator-cli/.env-cmdrc.cjs b/clis/generator-cli/.env-cmdrc.cjs similarity index 100% rename from packages/generator-cli/.env-cmdrc.cjs rename to clis/generator-cli/.env-cmdrc.cjs diff --git a/packages/generator-cli/.mrlint.json b/clis/generator-cli/.mrlint.json similarity index 100% rename from packages/generator-cli/.mrlint.json rename to clis/generator-cli/.mrlint.json diff --git a/packages/generator-cli/.prettierrc.cjs b/clis/generator-cli/.prettierrc.cjs similarity index 100% rename from packages/generator-cli/.prettierrc.cjs rename to clis/generator-cli/.prettierrc.cjs diff --git a/packages/generator-cli/package.json b/clis/generator-cli/package.json similarity index 86% rename from packages/generator-cli/package.json rename to clis/generator-cli/package.json index dce9936900..5af34cccad 100644 --- a/packages/generator-cli/package.json +++ b/clis/generator-cli/package.json @@ -12,8 +12,8 @@ }, "scripts": { "clean": "rm -rf ./dist && tsc --build --clean", - "dist:cli": "tsup ./src/cli.ts --format cjs && echo '#!/usr/bin/env node' | cat - dist/cli.cjs > dist/tmp && mv dist/tmp dist/cli.cjs", - "test": "vitest --passWithNoTests --globals --disable-console-intercept", + "compile": "tsup ./src/cli.ts --format cjs && echo '#!/usr/bin/env node' | cat - dist/cli.cjs > dist/tmp && mv dist/tmp dist/cli.cjs", + "test": "vitest --run --passWithNoTests --globals --disable-console-intercept", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/generator-cli/src/__test__/__snapshots__/basic-go.test.ts.snap b/clis/generator-cli/src/__test__/__snapshots__/basic-go.test.ts.snap similarity index 100% rename from packages/generator-cli/src/__test__/__snapshots__/basic-go.test.ts.snap rename to clis/generator-cli/src/__test__/__snapshots__/basic-go.test.ts.snap diff --git a/packages/generator-cli/src/__test__/__snapshots__/cohere-go-merged.test.ts.snap b/clis/generator-cli/src/__test__/__snapshots__/cohere-go-merged.test.ts.snap similarity index 100% rename from packages/generator-cli/src/__test__/__snapshots__/cohere-go-merged.test.ts.snap rename to clis/generator-cli/src/__test__/__snapshots__/cohere-go-merged.test.ts.snap diff --git a/packages/generator-cli/src/__test__/__snapshots__/cohere-go.test.ts.snap b/clis/generator-cli/src/__test__/__snapshots__/cohere-go.test.ts.snap similarity index 100% rename from packages/generator-cli/src/__test__/__snapshots__/cohere-go.test.ts.snap rename to clis/generator-cli/src/__test__/__snapshots__/cohere-go.test.ts.snap diff --git a/packages/generator-cli/src/__test__/__snapshots__/empty-go.test.ts.snap b/clis/generator-cli/src/__test__/__snapshots__/empty-go.test.ts.snap similarity index 100% rename from packages/generator-cli/src/__test__/__snapshots__/empty-go.test.ts.snap rename to clis/generator-cli/src/__test__/__snapshots__/empty-go.test.ts.snap diff --git a/packages/generator-cli/src/__test__/basic-go.test.ts b/clis/generator-cli/src/__test__/basic-go.test.ts similarity index 100% rename from packages/generator-cli/src/__test__/basic-go.test.ts rename to clis/generator-cli/src/__test__/basic-go.test.ts diff --git a/packages/generator-cli/src/__test__/cohere-go-merged.test.ts b/clis/generator-cli/src/__test__/cohere-go-merged.test.ts similarity index 100% rename from packages/generator-cli/src/__test__/cohere-go-merged.test.ts rename to clis/generator-cli/src/__test__/cohere-go-merged.test.ts diff --git a/packages/generator-cli/src/__test__/cohere-go.test.ts b/clis/generator-cli/src/__test__/cohere-go.test.ts similarity index 100% rename from packages/generator-cli/src/__test__/cohere-go.test.ts rename to clis/generator-cli/src/__test__/cohere-go.test.ts diff --git a/packages/generator-cli/src/__test__/empty-go.test.ts b/clis/generator-cli/src/__test__/empty-go.test.ts similarity index 100% rename from packages/generator-cli/src/__test__/empty-go.test.ts rename to clis/generator-cli/src/__test__/empty-go.test.ts diff --git a/packages/generator-cli/src/__test__/fixtures/basic-go/readme.json b/clis/generator-cli/src/__test__/fixtures/basic-go/readme.json similarity index 100% rename from packages/generator-cli/src/__test__/fixtures/basic-go/readme.json rename to clis/generator-cli/src/__test__/fixtures/basic-go/readme.json diff --git a/packages/generator-cli/src/__test__/fixtures/cohere-go-merged/README.md b/clis/generator-cli/src/__test__/fixtures/cohere-go-merged/README.md similarity index 100% rename from packages/generator-cli/src/__test__/fixtures/cohere-go-merged/README.md rename to clis/generator-cli/src/__test__/fixtures/cohere-go-merged/README.md diff --git a/packages/generator-cli/src/__test__/fixtures/cohere-go-merged/readme.json b/clis/generator-cli/src/__test__/fixtures/cohere-go-merged/readme.json similarity index 100% rename from packages/generator-cli/src/__test__/fixtures/cohere-go-merged/readme.json rename to clis/generator-cli/src/__test__/fixtures/cohere-go-merged/readme.json diff --git a/packages/generator-cli/src/__test__/fixtures/cohere-go/readme.json b/clis/generator-cli/src/__test__/fixtures/cohere-go/readme.json similarity index 100% rename from packages/generator-cli/src/__test__/fixtures/cohere-go/readme.json rename to clis/generator-cli/src/__test__/fixtures/cohere-go/readme.json diff --git a/packages/generator-cli/src/__test__/fixtures/empty-go/readme.json b/clis/generator-cli/src/__test__/fixtures/empty-go/readme.json similarity index 100% rename from packages/generator-cli/src/__test__/fixtures/empty-go/readme.json rename to clis/generator-cli/src/__test__/fixtures/empty-go/readme.json diff --git a/packages/generator-cli/src/__test__/testGenerateReadme.ts b/clis/generator-cli/src/__test__/testGenerateReadme.ts similarity index 100% rename from packages/generator-cli/src/__test__/testGenerateReadme.ts rename to clis/generator-cli/src/__test__/testGenerateReadme.ts diff --git a/packages/generator-cli/src/cli.ts b/clis/generator-cli/src/cli.ts similarity index 100% rename from packages/generator-cli/src/cli.ts rename to clis/generator-cli/src/cli.ts diff --git a/packages/generator-cli/src/configuration/generated/api/index.ts b/clis/generator-cli/src/configuration/generated/api/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/index.ts rename to clis/generator-cli/src/configuration/generated/api/index.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/feature/index.ts b/clis/generator-cli/src/configuration/generated/api/resources/feature/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/feature/index.ts rename to clis/generator-cli/src/configuration/generated/api/resources/feature/index.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureConfig.ts b/clis/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureConfig.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureConfig.ts rename to clis/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureConfig.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureId.ts b/clis/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureId.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureId.ts rename to clis/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureId.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureSpec.ts b/clis/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureSpec.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureSpec.ts rename to clis/generator-cli/src/configuration/generated/api/resources/feature/types/FeatureSpec.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/feature/types/StructuredFeatureId.ts b/clis/generator-cli/src/configuration/generated/api/resources/feature/types/StructuredFeatureId.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/feature/types/StructuredFeatureId.ts rename to clis/generator-cli/src/configuration/generated/api/resources/feature/types/StructuredFeatureId.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/feature/types/index.ts b/clis/generator-cli/src/configuration/generated/api/resources/feature/types/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/feature/types/index.ts rename to clis/generator-cli/src/configuration/generated/api/resources/feature/types/index.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/index.ts b/clis/generator-cli/src/configuration/generated/api/resources/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/index.ts rename to clis/generator-cli/src/configuration/generated/api/resources/index.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/index.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/index.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/index.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/CsharpInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/CsharpInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/CsharpInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/CsharpInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/GoInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/GoInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/GoInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/GoInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/GoPublishInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/GoPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/GoPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/GoPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/JavaInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/JavaInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/JavaInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/JavaInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/LanguageInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/LanguageInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/LanguageInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/LanguageInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/MavenPublishInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/MavenPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/MavenPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/MavenPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/NpmPublishInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/NpmPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/NpmPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/NpmPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/NugetPublishInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/NugetPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/NugetPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/NugetPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/PypiPublishInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/PypiPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/PypiPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/PypiPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/PythonInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/PythonInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/PythonInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/PythonInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeConfig.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeConfig.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeConfig.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeConfig.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeFeature.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeFeature.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeFeature.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/ReadmeFeature.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/RubyGemsPublishInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/RubyGemsPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/RubyGemsPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/RubyGemsPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/RubyInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/RubyInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/RubyInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/RubyInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/TypescriptInfo.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/TypescriptInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/TypescriptInfo.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/TypescriptInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/api/resources/readme/types/index.ts b/clis/generator-cli/src/configuration/generated/api/resources/readme/types/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/api/resources/readme/types/index.ts rename to clis/generator-cli/src/configuration/generated/api/resources/readme/types/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/index.ts b/clis/generator-cli/src/configuration/generated/core/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/index.ts rename to clis/generator-cli/src/configuration/generated/core/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/Schema.ts b/clis/generator-cli/src/configuration/generated/core/schemas/Schema.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/Schema.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/Schema.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/date/date.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/date/date.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/date/date.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/date/date.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/date/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/date/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/date/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/date/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/enum/enum.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/enum/enum.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/enum/enum.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/enum/enum.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/enum/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/enum/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/enum/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/enum/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/lazy/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/lazy/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/lazy/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/lazy/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazy.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazy.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazy.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazy.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazyObject.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazyObject.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazyObject.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/lazy/lazyObject.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/list/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/list/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/list/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/list/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/list/list.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/list/list.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/list/list.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/list/list.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/literals/booleanLiteral.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/literals/booleanLiteral.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/literals/booleanLiteral.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/literals/booleanLiteral.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/literals/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/literals/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/literals/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/literals/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/literals/stringLiteral.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/literals/stringLiteral.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/literals/stringLiteral.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/literals/stringLiteral.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object-like/getObjectLikeUtils.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object-like/getObjectLikeUtils.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object-like/getObjectLikeUtils.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object-like/getObjectLikeUtils.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object-like/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object-like/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object-like/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object-like/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object-like/types.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object-like/types.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object-like/types.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object-like/types.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object/object.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object/object.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object/object.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object/object.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object/objectWithoutOptionalProperties.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object/objectWithoutOptionalProperties.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object/objectWithoutOptionalProperties.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object/objectWithoutOptionalProperties.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object/property.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object/property.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object/property.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object/property.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/object/types.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/object/types.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/object/types.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/object/types.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/any.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/any.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/any.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/any.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/boolean.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/boolean.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/boolean.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/boolean.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/number.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/number.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/number.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/number.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/string.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/string.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/string.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/string.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/unknown.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/unknown.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/primitives/unknown.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/primitives/unknown.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/record/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/record/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/record/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/record/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/record/record.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/record/record.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/record/record.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/record/record.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/record/types.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/record/types.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/record/types.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/record/types.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/JsonError.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/JsonError.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/JsonError.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/JsonError.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/ParseError.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/ParseError.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/ParseError.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/ParseError.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/getSchemaUtils.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/getSchemaUtils.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/getSchemaUtils.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/getSchemaUtils.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/stringifyValidationErrors.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/stringifyValidationErrors.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/stringifyValidationErrors.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/schema-utils/stringifyValidationErrors.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/set/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/set/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/set/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/set/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/set/set.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/set/set.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/set/set.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/set/set.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/types.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/types.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/types.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/types.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/union/discriminant.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/union/discriminant.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/union/discriminant.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/union/discriminant.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/union/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/union/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/union/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/union/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/union/types.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/union/types.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/union/types.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/union/types.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/builders/union/union.ts b/clis/generator-cli/src/configuration/generated/core/schemas/builders/union/union.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/builders/union/union.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/builders/union/union.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/index.ts b/clis/generator-cli/src/configuration/generated/core/schemas/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/index.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/index.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/MaybePromise.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/MaybePromise.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/MaybePromise.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/MaybePromise.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/addQuestionMarksToNullableProperties.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/addQuestionMarksToNullableProperties.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/addQuestionMarksToNullableProperties.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/addQuestionMarksToNullableProperties.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/createIdentitySchemaCreator.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/createIdentitySchemaCreator.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/createIdentitySchemaCreator.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/createIdentitySchemaCreator.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/entries.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/entries.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/entries.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/entries.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/filterObject.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/filterObject.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/filterObject.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/filterObject.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/getErrorMessageForIncorrectType.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/getErrorMessageForIncorrectType.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/getErrorMessageForIncorrectType.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/getErrorMessageForIncorrectType.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/isPlainObject.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/isPlainObject.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/isPlainObject.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/isPlainObject.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/keys.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/keys.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/keys.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/keys.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/maybeSkipValidation.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/maybeSkipValidation.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/maybeSkipValidation.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/maybeSkipValidation.ts diff --git a/packages/generator-cli/src/configuration/generated/core/schemas/utils/partition.ts b/clis/generator-cli/src/configuration/generated/core/schemas/utils/partition.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/core/schemas/utils/partition.ts rename to clis/generator-cli/src/configuration/generated/core/schemas/utils/partition.ts diff --git a/packages/generator-cli/src/configuration/generated/errors/FernGeneratorCliError.ts b/clis/generator-cli/src/configuration/generated/errors/FernGeneratorCliError.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/errors/FernGeneratorCliError.ts rename to clis/generator-cli/src/configuration/generated/errors/FernGeneratorCliError.ts diff --git a/packages/generator-cli/src/configuration/generated/errors/FernGeneratorCliTimeoutError.ts b/clis/generator-cli/src/configuration/generated/errors/FernGeneratorCliTimeoutError.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/errors/FernGeneratorCliTimeoutError.ts rename to clis/generator-cli/src/configuration/generated/errors/FernGeneratorCliTimeoutError.ts diff --git a/packages/generator-cli/src/configuration/generated/errors/index.ts b/clis/generator-cli/src/configuration/generated/errors/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/errors/index.ts rename to clis/generator-cli/src/configuration/generated/errors/index.ts diff --git a/packages/generator-cli/src/configuration/generated/index.ts b/clis/generator-cli/src/configuration/generated/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/index.ts rename to clis/generator-cli/src/configuration/generated/index.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/index.ts b/clis/generator-cli/src/configuration/generated/serialization/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/index.ts rename to clis/generator-cli/src/configuration/generated/serialization/index.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/feature/index.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/feature/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/feature/index.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/feature/index.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureConfig.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureConfig.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureConfig.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureConfig.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureId.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureId.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureId.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureId.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureSpec.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureSpec.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureSpec.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/FeatureSpec.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/StructuredFeatureId.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/StructuredFeatureId.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/StructuredFeatureId.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/StructuredFeatureId.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/index.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/feature/types/index.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/feature/types/index.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/index.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/index.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/index.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/index.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/index.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/index.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/CsharpInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/CsharpInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/CsharpInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/CsharpInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoPublishInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/GoPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/JavaInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/JavaInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/JavaInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/JavaInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/LanguageInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/LanguageInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/LanguageInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/LanguageInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/MavenPublishInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/MavenPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/MavenPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/MavenPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/NpmPublishInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/NpmPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/NpmPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/NpmPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/NugetPublishInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/NugetPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/NugetPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/NugetPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/PypiPublishInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/PypiPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/PypiPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/PypiPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/PythonInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/PythonInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/PythonInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/PythonInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeConfig.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeConfig.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeConfig.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeConfig.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeFeature.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeFeature.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeFeature.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/ReadmeFeature.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyGemsPublishInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyGemsPublishInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyGemsPublishInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyGemsPublishInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/RubyInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/TypescriptInfo.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/TypescriptInfo.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/TypescriptInfo.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/TypescriptInfo.ts diff --git a/packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/index.ts b/clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/generated/serialization/resources/readme/types/index.ts rename to clis/generator-cli/src/configuration/generated/serialization/resources/readme/types/index.ts diff --git a/packages/generator-cli/src/configuration/index.ts b/clis/generator-cli/src/configuration/index.ts similarity index 100% rename from packages/generator-cli/src/configuration/index.ts rename to clis/generator-cli/src/configuration/index.ts diff --git a/packages/generator-cli/src/configuration/loadReadmeConfig.ts b/clis/generator-cli/src/configuration/loadReadmeConfig.ts similarity index 100% rename from packages/generator-cli/src/configuration/loadReadmeConfig.ts rename to clis/generator-cli/src/configuration/loadReadmeConfig.ts diff --git a/packages/generator-cli/src/index.ts b/clis/generator-cli/src/index.ts similarity index 100% rename from packages/generator-cli/src/index.ts rename to clis/generator-cli/src/index.ts diff --git a/packages/generator-cli/src/readme/Block.ts b/clis/generator-cli/src/readme/Block.ts similarity index 100% rename from packages/generator-cli/src/readme/Block.ts rename to clis/generator-cli/src/readme/Block.ts diff --git a/packages/generator-cli/src/readme/BlockMerger.ts b/clis/generator-cli/src/readme/BlockMerger.ts similarity index 100% rename from packages/generator-cli/src/readme/BlockMerger.ts rename to clis/generator-cli/src/readme/BlockMerger.ts diff --git a/packages/generator-cli/src/readme/ReadmeGenerator.ts b/clis/generator-cli/src/readme/ReadmeGenerator.ts similarity index 100% rename from packages/generator-cli/src/readme/ReadmeGenerator.ts rename to clis/generator-cli/src/readme/ReadmeGenerator.ts diff --git a/packages/generator-cli/src/readme/ReadmeParser.ts b/clis/generator-cli/src/readme/ReadmeParser.ts similarity index 100% rename from packages/generator-cli/src/readme/ReadmeParser.ts rename to clis/generator-cli/src/readme/ReadmeParser.ts diff --git a/packages/generator-cli/src/readme/index.ts b/clis/generator-cli/src/readme/index.ts similarity index 100% rename from packages/generator-cli/src/readme/index.ts rename to clis/generator-cli/src/readme/index.ts diff --git a/packages/generator-cli/src/utils/Writer.ts b/clis/generator-cli/src/utils/Writer.ts similarity index 100% rename from packages/generator-cli/src/utils/Writer.ts rename to clis/generator-cli/src/utils/Writer.ts diff --git a/packages/generator-cli/tsconfig.json b/clis/generator-cli/tsconfig.json similarity index 100% rename from packages/generator-cli/tsconfig.json rename to clis/generator-cli/tsconfig.json diff --git a/fern/apis/fdr/definition/api.yml b/fern/apis/fdr/definition/api.yml index 020a4b358b..237bc75652 100644 --- a/fern/apis/fdr/definition/api.yml +++ b/fern/apis/fdr/definition/api.yml @@ -1,13 +1,12 @@ name: registry auth: bearer -default-environment: Dev -environments: - Dev: https://registry-dev2.buildwithfern.com +default-environment: Prod +environments: Prod: https://registry.buildwithfern.com error-discrimination: strategy: property property-name: error -audiences: +audiences: - external - fiddle - snippets diff --git a/fern/apis/fdr/generators.yml b/fern/apis/fdr/generators.yml index 9e82eb14dc..4e583c9243 100644 --- a/fern/apis/fdr/generators.yml +++ b/fern/apis/fdr/generators.yml @@ -14,7 +14,7 @@ groups: # extraDevDependencies: # "@types/mime": "3.0.4" - name: fernapi/fern-typescript-node-sdk - version: 0.12.8-rc0 + version: 0.20.9 output: location: local-file-system path: ../../../packages/fdr-sdk/src/client/generated @@ -74,7 +74,7 @@ groups: namespaceExport: Fern includeApiReference: true extraDependencies: - "@fern-api/template-resolver": "^0.0.9" + "@fern-api/template-resolver": "0.3.0" template-resolver: audiences: diff --git a/package.json b/package.json index 21785cf24c..fe1c304fa3 100644 --- a/package.json +++ b/package.json @@ -83,7 +83,7 @@ "tailwindcss": "^3.4.3", "ts-node": "^10.9.1", "tsx": "^4.7.1", - "turbo": "^1.12.5", + "turbo": "^2.0.1", "typescript": "5.4.3", "typescript-plugin-css-modules": "^5.1.0", "vitest": "^1.5.0" diff --git a/packages/cdk/src/docs-fe-stack.ts b/packages/cdk/src/docs-fe-stack.ts index 8601b14e83..575c8186f8 100644 --- a/packages/cdk/src/docs-fe-stack.ts +++ b/packages/cdk/src/docs-fe-stack.ts @@ -41,6 +41,10 @@ export class DocsFeStack extends Stack { ); const local_preview_bundle_dist_zip = path.resolve(__dirname, "../../ui/local-preview-bundle/dist/out.zip"); + if (!fs.existsSync(LOCAL_PREVIEW_BUNDLE_OUT_DIR) || !fs.lstatSync(LOCAL_PREVIEW_BUNDLE_OUT_DIR).isDirectory()) { + throw new Error(`Local preview bundle not found at ${LOCAL_PREVIEW_BUNDLE_OUT_DIR}`); + } + void zipFolder(LOCAL_PREVIEW_BUNDLE_OUT_DIR, local_preview_bundle_dist_zip).then(() => { new BucketDeployment(this, "deploy-local-preview-bundle2", { sources: [Source.asset(local_preview_bundle_dist_zip)], diff --git a/packages/commons/core-utils/package.json b/packages/commons/core-utils/package.json index 5cdbf00713..700c6271a7 100644 --- a/packages/commons/core-utils/package.json +++ b/packages/commons/core-utils/package.json @@ -11,15 +11,14 @@ "dist" ], "type": "module", - "main": "dist/src/index.js", - "types": "dist/src/index.d.ts", - "module": "dist/src/index.js", "source": "src/index.ts", + "module": "src/index.ts", + "main": "src/index.ts", "sideEffects": false, "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/commons/core-utils/src/index.ts b/packages/commons/core-utils/src/index.ts index a632e4e64a..78a328929d 100644 --- a/packages/commons/core-utils/src/index.ts +++ b/packages/commons/core-utils/src/index.ts @@ -7,7 +7,6 @@ export { withMinimumTime } from "./delay/withMinimumTime"; export { EMPTY_ARRAY, EMPTY_OBJECT } from "./empty"; export { identity } from "./identity"; export { assertNonNullish, isNonNullish } from "./isNonNullish"; -export * from "./lodash"; export { noop } from "./noop"; export { entries, type Entries } from "./objects/entries"; export { isPlainObject } from "./objects/isPlainObject"; diff --git a/packages/commons/core-utils/tsconfig.json b/packages/commons/core-utils/tsconfig.json index 58d907334e..d569071014 100644 --- a/packages/commons/core-utils/tsconfig.json +++ b/packages/commons/core-utils/tsconfig.json @@ -1,5 +1,6 @@ { + "$schema": "https://json.schemastore.org/tsconfig", "extends": "@fern-platform/configs/tsconfig/library.json", - "compilerOptions": { "outDir": "./dist", "rootDir": "." }, + "compilerOptions": { "outDir": "./dist", "rootDir": "./src" }, "include": ["./src/**/*"] } diff --git a/packages/commons/fdr-utils/package.json b/packages/commons/fdr-utils/package.json index 9763303671..cd7af9c5cc 100644 --- a/packages/commons/fdr-utils/package.json +++ b/packages/commons/fdr-utils/package.json @@ -18,7 +18,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/commons/fdr-utils/src/docs.ts b/packages/commons/fdr-utils/src/docs.ts index 29f7bdad71..8947547f60 100644 --- a/packages/commons/fdr-utils/src/docs.ts +++ b/packages/commons/fdr-utils/src/docs.ts @@ -1,4 +1,5 @@ -import { DocsV1Read, FernNavigation } from "@fern-api/fdr-sdk"; +import { DocsV1Read } from "@fern-api/fdr-sdk"; +import { Availability } from "@fern-api/fdr-sdk/navigation"; export function isVersionedNavigationConfig( navigationConfig: DocsV1Read.NavigationConfig, @@ -42,19 +43,19 @@ export function assertIsUnversionedNavigationConfig( } } -export function getVersionAvailabilityLabel(availability: FernNavigation.Availability): string { +export function getVersionAvailabilityLabel(availability: Availability): string { switch (availability) { - case FernNavigation.Availability.Beta: + case Availability.Beta: return "beta"; - case FernNavigation.Availability.Deprecated: + case Availability.Deprecated: return "deprecated"; - case FernNavigation.Availability.GenerallyAvailable: + case Availability.GenerallyAvailable: return "generally available"; - case FernNavigation.Availability.Stable: + case Availability.Stable: return "stable"; - case FernNavigation.Availability.InDevelopment: + case Availability.InDevelopment: return "in development"; - case FernNavigation.Availability.PreRelease: + case Availability.PreRelease: return "pre-release"; default: return "unknown"; diff --git a/packages/commons/fdr-utils/tsconfig.json b/packages/commons/fdr-utils/tsconfig.json index 9a6c82205a..ac034eb684 100644 --- a/packages/commons/fdr-utils/tsconfig.json +++ b/packages/commons/fdr-utils/tsconfig.json @@ -1,5 +1,6 @@ { "extends": "@fern-platform/configs/tsconfig/library.json", "compilerOptions": { "outDir": "./dist", "rootDir": "./src" }, - "include": ["./src/**/*"] + "include": ["./src/**/*"], + "references": [{ "path": "../../fdr-sdk" }] } diff --git a/packages/commons/loadable/package.json b/packages/commons/loadable/package.json index 84cb325baa..9d5a6ec124 100644 --- a/packages/commons/loadable/package.json +++ b/packages/commons/loadable/package.json @@ -18,7 +18,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/commons/react/common-components/package.json b/packages/commons/react/common-components/package.json index 186d50d94f..866aa91a5b 100644 --- a/packages/commons/react/common-components/package.json +++ b/packages/commons/react/common-components/package.json @@ -18,7 +18,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/commons/react/fonts/package.json b/packages/commons/react/fonts/package.json index 968eef4ee8..781aa25c33 100644 --- a/packages/commons/react/fonts/package.json +++ b/packages/commons/react/fonts/package.json @@ -18,7 +18,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/commons/react/react-commons/package.json b/packages/commons/react/react-commons/package.json index e4d1effb6f..f13d9d1e94 100644 --- a/packages/commons/react/react-commons/package.json +++ b/packages/commons/react/react-commons/package.json @@ -18,7 +18,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/commons/react/react-query-utils/package.json b/packages/commons/react/react-query-utils/package.json index 4f077c1cce..65a66e9926 100644 --- a/packages/commons/react/react-query-utils/package.json +++ b/packages/commons/react/react-query-utils/package.json @@ -18,7 +18,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/fdr-sdk/package.json b/packages/fdr-sdk/package.json index 30126cde2c..2ca6d4894c 100644 --- a/packages/fdr-sdk/package.json +++ b/packages/fdr-sdk/package.json @@ -1,23 +1,36 @@ { "name": "@fern-api/fdr-sdk", "version": "0.0.0", - "main": "./dist/index.js", - "types": "./dist/index.d.ts", "files": [ "dist" ], "type": "module", - "module": "dist/index.js", "source": "src/index.ts", + "module": "src/index.ts", + "main": "src/index.ts", + "exports": { + "./navigation": { + "types": "./dist/navigation/index.d.ts", + "import": "./src/navigation/index.ts", + "default": "./dist/navigation/index.js" + }, + ".": { + "types": "./dist/index.d.ts", + "import": "./src/index.ts", + "default": "./dist/index.js" + } + }, "dependencies": { - "@fern-ui/core-utils": "workspace:*", "dayjs": "^1.11.11", "fast-deep-equal": "^3.1.3", "form-data": "4.0.0", "js-base64": "3.7.7", "qs": "6.12.0", "tinycolor2": "^1.6.0", - "url-join": "4.0.1" + "title": "^3.5.3", + "url-join": "4.0.1", + "node-fetch": "2.7.0", + "formdata-node": "^6.0.3" }, "devDependencies": { "@babel/core": "^7.18.9", @@ -27,13 +40,13 @@ "@fern-platform/configs": "workspace:*", "@types/qs": "6.9.14", "@types/tinycolor2": "^1.4.6", + "@types/title": "^3.4.3", "@types/url-join": "4.0.1", "eslint": "^8.56.0", - "eslint-config-custom": "*", "prettier": "^3.2.4", - "tsconfig": "*", "typescript": "5.4.3", - "vitest": "^1.5.0" + "vitest": "^1.5.0", + "@types/node-fetch": "2.6.9" }, "scripts": { "compile": "tsc --build", @@ -41,6 +54,6 @@ "format": "prettier --write --ignore-unknown --ignore-path ../../shared/.prettierignore \"**\"", "format:check": "prettier --check --ignore-unknown --ignore-path ../../shared/.prettierignore \"**\"", "lint": "eslint --max-warnings 0 src --ext .ts --resolve-plugins-relative-to ../../", - "test": "vitest" + "test": "vitest --run" } } diff --git a/packages/fdr-sdk/src/client/generated/Client.ts b/packages/fdr-sdk/src/client/generated/Client.ts index 92db2ee8d2..549053670b 100644 --- a/packages/fdr-sdk/src/client/generated/Client.ts +++ b/packages/fdr-sdk/src/client/generated/Client.ts @@ -21,6 +21,7 @@ export declare namespace FernRegistryClient { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/client/Client.ts index 8dbd4296da..9c68b28d5e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/client/Client.ts @@ -15,6 +15,7 @@ export declare namespace Api { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/client/Client.ts index 5ca4d55678..5013d972aa 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/client/Client.ts @@ -16,6 +16,7 @@ export declare namespace V1 { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbEndpointDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbEndpointDefinition.ts index 9869a05b64..b9e6c575ba 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbEndpointDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbEndpointDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DbEndpointDefinition extends FernRegistry.api.v1.read.WithDescription { authed?: boolean; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbHttpRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbHttpRequest.ts index d1ff707d0d..9902c7705c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbHttpRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/resources/endpoint/types/DbHttpRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DbHttpRequest extends FernRegistry.api.v1.read.WithDescription { contentType?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinition.ts index c5873c41ea..ed322c1721 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DbApiDefinition { id: FernRegistry.ApiDefinitionId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionPackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionPackage.ts index cec23ec4c3..989b91c328 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionPackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionPackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DbApiDefinitionPackage { endpoints: FernRegistry.api.v1.db.DbEndpointDefinition[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionSubpackage.ts index a7579e189a..c80db96deb 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/db/types/DbApiDefinitionSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DbApiDefinitionSubpackage extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/Client.ts index bf4f508133..c31caac083 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../../../../../environments"; import * as core from "../../../../../../../../core"; -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import urlJoin from "url-join"; export declare namespace Read { @@ -16,20 +16,28 @@ export declare namespace Read { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Read { constructor(protected readonly _options: Read.Options = {}) {} + /** + * @param {FernRegistry.ApiDefinitionId} apiDefinitionId + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.api.v1.read.getApi("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32") + */ public async getApi( apiDefinitionId: FernRegistry.ApiDefinitionId, requestOptions?: Read.RequestOptions ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, - `/registry/api/load/${apiDefinitionId}` + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, + `/registry/api/load/${encodeURIComponent(apiDefinitionId)}` ), method: "GET", headers: { @@ -41,6 +49,7 @@ export class Read { contentType: "application/json", timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -65,7 +74,7 @@ export class Read { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/getApi.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/getApi.ts index 1fded8c93e..421a189d5d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/getApi.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/client/getApi.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/commons/types/WithAvailability.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/commons/types/WithAvailability.ts index cd9fc245c5..193f95c960 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/commons/types/WithAvailability.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/commons/types/WithAvailability.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WithAvailability { availability?: FernRegistry.api.v1.read.Availability; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/BytesValue.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/BytesValue.ts index e460d3b106..1f8871cf8d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/BytesValue.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/BytesValue.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type BytesValue = FernRegistry.api.v1.read.BytesValue.Base64; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CodeExamples.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CodeExamples.ts index 13847e898e..8de551eb86 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CodeExamples.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CodeExamples.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface CodeExamples { nodeAxios?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CustomCodeSample.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CustomCodeSample.ts index 7b05e97def..72612a1950 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CustomCodeSample.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/CustomCodeSample.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; /** * Hand-written code samples diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointDefinition.ts index e26e39cbc5..ac6832bca8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EndpointDefinition extends FernRegistry.api.v1.read.WithDescription { /** When this is true, the api definition will have a union for auth */ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPath.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPath.ts index 8762eecce0..0f8a242cae 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPath.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPath.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EndpointPath { parts: FernRegistry.api.v1.read.EndpointPathPart[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPathPart.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPathPart.ts index 86e711b10f..989c9da67b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPathPart.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointPathPart.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type EndpointPathPart = | FernRegistry.api.v1.read.EndpointPathPart.Literal diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointSnippetTemplates.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointSnippetTemplates.ts index 31482a7f9c..5e58ead0e7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointSnippetTemplates.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/EndpointSnippetTemplates.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EndpointSnippetTemplates { typescript?: FernRegistry.VersionedSnippetTemplate; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Environment.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Environment.ts index 8eb0df67cd..8c89b6801b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Environment.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Environment.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface Environment { id: FernRegistry.api.v1.read.EnvironmentId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclaration.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclaration.ts index 42a3cfee80..ab3ef3106d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclaration.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclaration.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ErrorDeclaration extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclarationV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclarationV2.ts index 1977173b02..c88a92c6e5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclarationV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorDeclarationV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ErrorDeclarationV2 extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorExample.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorExample.ts index 4d4edff8c8..d9114985f4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorExample.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ErrorExample.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ErrorExample extends FernRegistry.api.v1.read.WithDescription { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointCall.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointCall.ts index 258ac36fdc..a322015f16 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointCall.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointCall.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ExampleEndpointCall extends FernRegistry.api.v1.read.WithDescription { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointRequest.ts index cde7c81d00..b04ca2df12 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ExampleEndpointRequest = | FernRegistry.api.v1.read.ExampleEndpointRequest.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointResponse.ts index 070cf7ca68..b8aea999da 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleEndpointResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ExampleEndpointResponse = | FernRegistry.api.v1.read.ExampleEndpointResponse.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleErrorResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleErrorResponse.ts index 0878f3c6fe..d857b9bae8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleErrorResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/ExampleErrorResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ExampleErrorResponse = FernRegistry.api.v1.read.ExampleErrorResponse.Json; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FilenameWithData.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FilenameWithData.ts index 58bd056b24..86c2a08004 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FilenameWithData.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FilenameWithData.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FilenameWithData { filename: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FormValue.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FormValue.ts index ca3a476343..67fd095862 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FormValue.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/FormValue.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FormValue = | FernRegistry.api.v1.read.FormValue.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Header.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Header.ts index 03ef3e97d9..0060db2a46 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Header.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Header.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface Header extends FernRegistry.api.v1.read.WithDescription, FernRegistry.api.v1.read.WithAvailability { key: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequest.ts index d9fff12d86..b1d11cd360 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface HttpRequest extends FernRegistry.api.v1.read.WithDescription { contentType: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequestBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequestBodyShape.ts index d1d85e414f..1d7003b5f3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequestBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpRequestBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type HttpRequestBodyShape = | FernRegistry.api.v1.read.HttpRequestBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponse.ts index 8b3fe82f1d..80cc33419f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface HttpResponse extends FernRegistry.api.v1.read.WithDescription { type: FernRegistry.api.v1.read.HttpResponseBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponseBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponseBodyShape.ts index 22c44de90e..5474f4caf9 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponseBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/HttpResponseBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type HttpResponseBodyShape = | FernRegistry.api.v1.read.HttpResponseBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/JsonBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/JsonBodyShape.ts index 196df37958..b518592cc5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/JsonBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/JsonBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type JsonBodyShape = | FernRegistry.api.v1.read.JsonBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Language.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Language.ts index 492c49f096..8012d41664 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Language.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/Language.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; /** * Fallback to string to catch-all for languages that are not supported by fern diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/NonStreamResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/NonStreamResponse.ts index 26b7bb66c9..531222798d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/NonStreamResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/NonStreamResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface NonStreamResponse { shape: FernRegistry.api.v1.read.JsonBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/PathParameter.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/PathParameter.ts index 610f3aeb53..98ac27838e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/PathParameter.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/PathParameter.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface PathParameter extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/QueryParameter.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/QueryParameter.ts index e4699999a8..0c18e3706f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/QueryParameter.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/QueryParameter.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface QueryParameter extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamCondition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamCondition.ts index 216491c8b4..5d09668422 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamCondition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamCondition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type StreamCondition = FernRegistry.api.v1.read.StreamCondition.BooleanRequestProperty; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamConditionResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamConditionResponse.ts index f2a54ac421..46b62894e8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamConditionResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamConditionResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface StreamConditionResponse { response: FernRegistry.api.v1.read.NonStreamResponse; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponse.ts index ebac10136d..cdd848c9e5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface StreamResponse { shape: FernRegistry.api.v1.read.JsonBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponseV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponseV2.ts index 5144134dbb..8cc73fcf7b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponseV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/endpoint/types/StreamResponseV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface StreamResponseV2 { /** diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionType.ts index 5bd6520524..30a7cb7e00 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DiscriminatedUnionType { discriminant: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionVariant.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionVariant.ts index 3ba34c3e59..c3a548f247 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionVariant.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/DiscriminatedUnionVariant.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DiscriminatedUnionVariant extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumType.ts index 472e9f67b1..c6e3321f55 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EnumType { values: FernRegistry.api.v1.read.EnumValue[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumValue.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumValue.ts index 36b22fb9f2..1b6d99e275 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumValue.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/EnumValue.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EnumValue extends FernRegistry.api.v1.read.WithDescription { value: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertyArray.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertyArray.ts index ee4afd18c9..cf389dfc44 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertyArray.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertyArray.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FilePropertyArray extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertySingle.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertySingle.ts index 647e01ff9b..047600ccc3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertySingle.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FilePropertySingle.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FilePropertySingle extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataBodyProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataBodyProperty.ts index 1af6751cec..8bc93a4fdc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataBodyProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataBodyProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FormDataBodyProperty extends FernRegistry.api.v1.read.ObjectProperty { contentType?: FernRegistry.api.v1.read.ContentType; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataFileProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataFileProperty.ts index d4f13b71c5..0be7facf08 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataFileProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataFileProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FormDataFileProperty = | FernRegistry.api.v1.read.FormDataFileProperty.File_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataProperty.ts index f6a39909fd..ea846845ed 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FormDataProperty = | FernRegistry.api.v1.read.FormDataProperty.File_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataRequest.ts index fa5d5729a4..6642065976 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/FormDataRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FormDataRequest extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ListType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ListType.ts index ff61111151..332672c1b5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ListType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ListType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ListType { itemType: FernRegistry.api.v1.read.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/LiteralType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/LiteralType.ts index 12f19d5bf8..90d613b174 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/LiteralType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/LiteralType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type LiteralType = | FernRegistry.api.v1.read.LiteralType.BooleanLiteral diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/MapType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/MapType.ts index f31fa4bff2..77ee824312 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/MapType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/MapType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface MapType { keyType: FernRegistry.api.v1.read.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectProperty.ts index 686d71d358..d6ecaa6ac1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ObjectProperty extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectType.ts index 0fb934f36f..3919c975d0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/ObjectType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ObjectType { extends: FernRegistry.api.v1.read.TypeId[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/OptionalType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/OptionalType.ts index ecc5846c64..1732614b0c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/OptionalType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/OptionalType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface OptionalType { itemType: FernRegistry.api.v1.read.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/PrimitiveType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/PrimitiveType.ts index 115e89037a..3026d1e69e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/PrimitiveType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/PrimitiveType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type PrimitiveType = | FernRegistry.api.v1.read.PrimitiveType.Integer diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/SetType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/SetType.ts index 190814f876..5930dd5a81 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/SetType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/SetType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface SetType { itemType: FernRegistry.api.v1.read.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeDefinition.ts index 58b050d110..567407c2f5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface TypeDefinition extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeReference.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeReference.ts index 752664e38f..9483cf6020 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeReference.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeReference.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type TypeReference = | FernRegistry.api.v1.read.TypeReference.Id diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeShape.ts index 7b502eb879..b96eb636d6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/TypeShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type TypeShape = | FernRegistry.api.v1.read.TypeShape.Alias diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionType.ts index 48d99e4bed..fe0f96f2c8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface UndiscriminatedUnionType { variants: FernRegistry.api.v1.read.UndiscriminatedUnionVariant[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionVariant.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionVariant.ts index 008c5e85ab..1dddf5f303 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionVariant.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/type/types/UndiscriminatedUnionVariant.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface UndiscriminatedUnionVariant extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookDefinition.ts index 7923ea24f3..5ae6a87293 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebhookDefinition extends FernRegistry.api.v1.read.WithDescription { urlSlug: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayload.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayload.ts index b01d2eb2e6..8d2271dcdd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayload.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayload.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebhookPayload extends FernRegistry.api.v1.read.WithDescription { type: FernRegistry.api.v1.read.WebhookPayloadShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayloadShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayloadShape.ts index 7db9c3927a..2e9144c510 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayloadShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/webhook/types/WebhookPayloadShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type WebhookPayloadShape = | FernRegistry.api.v1.read.WebhookPayloadShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketMessage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketMessage.ts index 6d0ab83b8b..db9bd0ae3c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketMessage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketMessage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ExampleWebSocketMessage { type: FernRegistry.api.v1.read.WebSocketMessageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketSession.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketSession.ts index 6dfb652cab..12f995a7a0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketSession.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/ExampleWebSocketSession.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ExampleWebSocketSession extends FernRegistry.api.v1.read.WithDescription { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketChannel.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketChannel.ts index 8804b28797..e1fc0ad1a4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketChannel.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketChannel.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebSocketChannel extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessage.ts index 6d00e89e59..16065bd0bf 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebSocketMessage extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessageBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessageBodyShape.ts index 502e7af8ca..baaaacf256 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessageBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/resources/websocket/types/WebSocketMessageBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type WebSocketMessageBodyShape = | FernRegistry.api.v1.read.WebSocketMessageBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiAuth.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiAuth.ts index 9238cdbbd3..37da7c6e74 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiAuth.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiAuth.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ApiAuth = | FernRegistry.api.v1.read.ApiAuth.BearerAuth diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinition.ts index f63bbd0dc2..d7b3928768 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiDefinition { id: FernRegistry.ApiDefinitionId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionPackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionPackage.ts index 4d60639afe..edb4976d73 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionPackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionPackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiDefinitionPackage { endpoints: FernRegistry.api.v1.read.EndpointDefinition[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionSubpackage.ts index 634c4db1f7..3962867011 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiDefinitionSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiDefinitionSubpackage extends FernRegistry.api.v1.read.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigItem.ts index b6ea5abd6d..6632102891 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ApiNavigationConfigItem = | FernRegistry.api.v1.read.ApiNavigationConfigItem.Subpackage diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts index 75ff4ede10..d9873d0e0a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigRoot { items: FernRegistry.api.v1.read.ApiNavigationConfigItem[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts index d7968cf2a3..ea258f3a75 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigSubpackage { subpackageId: FernRegistry.api.v1.read.SubpackageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/Client.ts index 374fd9d2fe..c2561b46ff 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../../../../../environments"; import * as core from "../../../../../../../../core"; -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import urlJoin from "url-join"; export declare namespace Register { @@ -16,12 +16,38 @@ export declare namespace Register { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Register { constructor(protected readonly _options: Register.Options = {}) {} + /** + * @param {FernRegistry.api.v1.register.RegisterApiDefinitionRequest} request + * @param {Register.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.api.v1.register.registerApiDefinition({ + * orgId: "string", + * apiId: "string", + * definition: { + * rootPackage: {}, + * types: { + * "string": {} + * }, + * subpackages: { + * "string": {} + * }, + * auth: { + * type: "bearerAuth" + * }, + * globalHeaders: [{}], + * snippetsConfiguration: {}, + * navigation: {} + * } + * }) + */ public async registerApiDefinition( request: FernRegistry.api.v1.register.RegisterApiDefinitionRequest, requestOptions?: Register.RequestOptions @@ -33,7 +59,7 @@ export class Register { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/registry/api/register" ), method: "POST", @@ -47,6 +73,7 @@ export class Register { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -72,7 +99,7 @@ export class Register { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/registerApiDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/registerApiDefinition.ts index 73d14bfdbd..cfcb90bf10 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/registerApiDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/registerApiDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/RegisterApiDefinitionRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/RegisterApiDefinitionRequest.ts index ad2dd97f25..49adbb87ad 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/RegisterApiDefinitionRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/RegisterApiDefinitionRequest.ts @@ -2,8 +2,30 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../index"; +/** + * @example + * { + * orgId: "string", + * apiId: "string", + * definition: { + * rootPackage: {}, + * types: { + * "string": {} + * }, + * subpackages: { + * "string": {} + * }, + * auth: { + * type: "bearerAuth" + * }, + * globalHeaders: [{}], + * snippetsConfiguration: {}, + * navigation: {} + * } + * } + */ export interface RegisterApiDefinitionRequest { orgId: FernRegistry.OrgId; apiId: FernRegistry.ApiId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/index.ts index afd82fbaa3..07da28e89a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/client/requests/index.ts @@ -1 +1 @@ -export { RegisterApiDefinitionRequest } from "./RegisterApiDefinitionRequest"; +export { type RegisterApiDefinitionRequest } from "./RegisterApiDefinitionRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/commons/types/WithAvailability.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/commons/types/WithAvailability.ts index cd4e495be4..836d2b7c08 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/commons/types/WithAvailability.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/commons/types/WithAvailability.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WithAvailability { availability?: FernRegistry.api.v1.register.Availability; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/BytesValue.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/BytesValue.ts index 57dcf19697..383f1f1ff1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/BytesValue.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/BytesValue.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type BytesValue = FernRegistry.api.v1.register.BytesValue.Base64; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/CustomCodeSample.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/CustomCodeSample.ts index e110412837..3d4242427a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/CustomCodeSample.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/CustomCodeSample.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; /** * Hand-written code samples diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointDefinition.ts index 9076078c4d..361872f64d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EndpointDefinition extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPath.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPath.ts index 23dea939d8..89358b42dd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPath.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPath.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EndpointPath { parts: FernRegistry.api.v1.register.EndpointPathPart[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPathPart.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPathPart.ts index 8672b78a6f..0bd93a024e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPathPart.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/EndpointPathPart.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type EndpointPathPart = | FernRegistry.api.v1.register.EndpointPathPart.Literal diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Environment.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Environment.ts index 50f3ff1928..04c71a3aff 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Environment.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Environment.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface Environment { id: FernRegistry.api.v1.register.EnvironmentId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclaration.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclaration.ts index 4e5723e3f2..1183b579fb 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclaration.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclaration.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ErrorDeclaration extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclarationV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclarationV2.ts index d626018529..32a8957b56 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclarationV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorDeclarationV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ErrorDeclarationV2 extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorExample.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorExample.ts index 062ada5472..5246ae46f4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorExample.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ErrorExample.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ErrorExample extends FernRegistry.api.v1.register.WithDescription { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointCall.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointCall.ts index 91a98a7bf4..99f6a0fcfd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointCall.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointCall.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ExampleEndpointCall extends FernRegistry.api.v1.register.WithDescription { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointRequest.ts index 1eb7f7f69e..bd05b1841f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ExampleEndpointRequest = | FernRegistry.api.v1.register.ExampleEndpointRequest.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointResponse.ts index a024e510ab..99eadf7d18 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleEndpointResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ExampleEndpointResponse = | FernRegistry.api.v1.register.ExampleEndpointResponse.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleErrorResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleErrorResponse.ts index ea76f5633e..4d1cba6371 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleErrorResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/ExampleErrorResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ExampleErrorResponse = FernRegistry.api.v1.register.ExampleErrorResponse.Json; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FilenameWithData.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FilenameWithData.ts index 42bd64d022..bbb4550345 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FilenameWithData.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FilenameWithData.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FilenameWithData { filename: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FormValue.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FormValue.ts index 189a2b4c48..94f83f62a6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FormValue.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/FormValue.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FormValue = | FernRegistry.api.v1.register.FormValue.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Header.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Header.ts index a2428c7a28..828462f519 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Header.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/Header.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface Header extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequest.ts index 2dfe7df3d2..08f9241177 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface HttpRequest extends FernRegistry.api.v1.register.WithDescription { type: FernRegistry.api.v1.register.HttpRequestBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequestBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequestBodyShape.ts index 6c8f61bec2..dbbf783f4b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequestBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpRequestBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type HttpRequestBodyShape = | FernRegistry.api.v1.register.HttpRequestBodyShape.Json diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponse.ts index 2d39eddff8..9b48629689 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface HttpResponse extends FernRegistry.api.v1.register.WithDescription { type: FernRegistry.api.v1.register.HttpResponseBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponseBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponseBodyShape.ts index 89ac211748..4c4577eca8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponseBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/HttpResponseBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type HttpResponseBodyShape = | FernRegistry.api.v1.register.HttpResponseBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonBodyShape.ts index 0d873b828a..48cbb948d3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type JsonBodyShape = | FernRegistry.api.v1.register.JsonBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonRequestBody.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonRequestBody.ts index ebc9ebce0f..e32b05b21e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonRequestBody.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/JsonRequestBody.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface JsonRequestBody { contentType: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/NonStreamResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/NonStreamResponse.ts index 1b211f28c8..ec05422da3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/NonStreamResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/NonStreamResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface NonStreamResponse { shape: FernRegistry.api.v1.register.JsonBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/PathParameter.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/PathParameter.ts index 6eaa2990e4..fd02bfd516 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/PathParameter.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/PathParameter.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface PathParameter extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/QueryParameter.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/QueryParameter.ts index 7d80e317f0..7993bf723e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/QueryParameter.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/QueryParameter.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface QueryParameter extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamCondition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamCondition.ts index c3692792f4..8453044d76 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamCondition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamCondition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type StreamCondition = FernRegistry.api.v1.register.StreamCondition.BooleanRequestProperty; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamConditionResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamConditionResponse.ts index 12c505c8ea..013ea8f43d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamConditionResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamConditionResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface StreamConditionResponse { response: FernRegistry.api.v1.register.NonStreamResponse; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponse.ts index 03e934b441..57115b84e3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface StreamResponse { shape: FernRegistry.api.v1.register.JsonBodyShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponseV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponseV2.ts index 721dc65507..bf315e515d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponseV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/endpoint/types/StreamResponseV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface StreamResponseV2 { /** diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/BytesRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/BytesRequest.ts index 87c3092e54..db1e76c21b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/BytesRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/BytesRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface BytesRequest extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionType.ts index 358afff4bd..4cb2192f8b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DiscriminatedUnionType { discriminant: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionVariant.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionVariant.ts index ff36a3c9dd..47738bbf16 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionVariant.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/DiscriminatedUnionVariant.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DiscriminatedUnionVariant extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumType.ts index 66b7633fe0..6b8353f2cd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EnumType { values: FernRegistry.api.v1.register.EnumValue[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumValue.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumValue.ts index 95f191cdf9..e9b16d5fa2 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumValue.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/EnumValue.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface EnumValue extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertyArray.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertyArray.ts index 11e928a30c..1a8132039c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertyArray.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertyArray.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FilePropertyArray extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertySingle.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertySingle.ts index f71a38a05e..0d5699d6dd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertySingle.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FilePropertySingle.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FilePropertySingle extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataBodyProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataBodyProperty.ts index 78f6658647..8fe3bc60c7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataBodyProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataBodyProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FormDataBodyProperty extends FernRegistry.api.v1.register.ObjectProperty { contentType?: FernRegistry.api.v1.register.ContentType; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataFileProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataFileProperty.ts index 75705749b9..51e3ed47aa 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataFileProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataFileProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FormDataFileProperty = | FernRegistry.api.v1.register.FormDataFileProperty.File_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataProperty.ts index 8cb584921e..bbf161ae47 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FormDataProperty = | FernRegistry.api.v1.register.FormDataProperty.File_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataRequest.ts index 284669187b..cf4267d118 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/FormDataRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FormDataRequest extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ListType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ListType.ts index f47fd0ac8e..8e8da0f97e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ListType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ListType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ListType { itemType: FernRegistry.api.v1.register.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/LiteralType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/LiteralType.ts index 413edbb117..31881cfa3e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/LiteralType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/LiteralType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type LiteralType = | FernRegistry.api.v1.register.LiteralType.BooleanLiteral diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/MapType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/MapType.ts index 9b243feedd..3a9590df84 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/MapType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/MapType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface MapType { keyType: FernRegistry.api.v1.register.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectProperty.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectProperty.ts index e8ad161a7a..98040a01d8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectProperty.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectProperty.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ObjectProperty extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectType.ts index a4a6bf21b2..0098c39c94 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/ObjectType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ObjectType { extends: FernRegistry.api.v1.register.TypeId[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/OptionalType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/OptionalType.ts index e031721a92..9368c7873e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/OptionalType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/OptionalType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface OptionalType { itemType: FernRegistry.api.v1.register.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/PrimitiveType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/PrimitiveType.ts index 2d7b920cbb..d84dd827ec 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/PrimitiveType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/PrimitiveType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type PrimitiveType = | FernRegistry.api.v1.register.PrimitiveType.Integer diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/SetType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/SetType.ts index f55ab4ac1a..2ccc889d53 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/SetType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/SetType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface SetType { itemType: FernRegistry.api.v1.register.TypeReference; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeDefinition.ts index 80dfe7161e..f8f9068a28 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface TypeDefinition extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeReference.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeReference.ts index c4305882ce..864b6ad7d7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeReference.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeReference.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type TypeReference = | FernRegistry.api.v1.register.TypeReference.Id diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeShape.ts index d71e284234..d93db65172 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/TypeShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type TypeShape = | FernRegistry.api.v1.register.TypeShape.Alias diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionType.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionType.ts index d65ffae711..02a65030bf 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionType.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionType.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface UndiscriminatedUnionType { variants: FernRegistry.api.v1.register.UndiscriminatedUnionVariant[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionVariant.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionVariant.ts index 68d0263beb..c908a3b038 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionVariant.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/type/types/UndiscriminatedUnionVariant.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface UndiscriminatedUnionVariant extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookDefinition.ts index eebe22ce24..4f3d4527cd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebhookDefinition extends FernRegistry.api.v1.register.WithDescription { method: FernRegistry.api.v1.register.WebhookHttpMethod; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayload.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayload.ts index de137d124b..047aac5286 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayload.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayload.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebhookPayload extends FernRegistry.api.v1.register.WithDescription { type: FernRegistry.api.v1.register.WebhookPayloadShape; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayloadShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayloadShape.ts index 35882a2fae..1aa91c7606 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayloadShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/webhook/types/WebhookPayloadShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type WebhookPayloadShape = | FernRegistry.api.v1.register.WebhookPayloadShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketMessage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketMessage.ts index 8f7ae8e0f8..de841fe92e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketMessage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketMessage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ExampleWebSocketMessage { type: FernRegistry.api.v1.register.WebSocketMessageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketSession.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketSession.ts index a3f95ffb57..06f840f468 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketSession.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/ExampleWebSocketSession.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ExampleWebSocketSession extends FernRegistry.api.v1.register.WithDescription { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketChannel.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketChannel.ts index 584d27475d..4923c234dd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketChannel.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketChannel.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebSocketChannel extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessage.ts index 2aeed76456..727edff372 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface WebSocketMessage extends FernRegistry.api.v1.register.WithDescription, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessageBodyShape.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessageBodyShape.ts index 43b88722cb..a3afd96aa5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessageBodyShape.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/resources/websocket/types/WebSocketMessageBodyShape.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type WebSocketMessageBodyShape = | FernRegistry.api.v1.register.WebSocketMessageBodyShape.Object_ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiAuth.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiAuth.ts index a70ace0175..53e4bdc0ea 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiAuth.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiAuth.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ApiAuth = | FernRegistry.api.v1.register.ApiAuth.BearerAuth diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinition.ts index 0f7156255a..f03b0d5255 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiDefinition { rootPackage: FernRegistry.api.v1.register.ApiDefinitionPackage; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionPackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionPackage.ts index c3175fd2c7..a423e1f7e1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionPackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionPackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiDefinitionPackage { endpoints: FernRegistry.api.v1.register.EndpointDefinition[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionSubpackage.ts index f86084b856..7be59af6d1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiDefinitionSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiDefinitionSubpackage extends FernRegistry.api.v1.register.ApiDefinitionPackage, diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigItem.ts index ccd84aa7c8..38e667c9ab 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ApiNavigationConfigItem = | FernRegistry.api.v1.register.ApiNavigationConfigItem.Subpackage diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigRoot.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigRoot.ts index 488e0a3df0..c5c6bc0bfc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigRoot.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigRoot.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigRoot { items: FernRegistry.api.v1.register.ApiNavigationConfigItem[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigSubpackage.ts index 44dce0e8d2..2532fa6370 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/ApiNavigationConfigSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigSubpackage { subpackageId: FernRegistry.api.v1.register.SubpackageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/RegisterApiDefinitionResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/RegisterApiDefinitionResponse.ts index 6364734bdf..14d06b8588 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/RegisterApiDefinitionResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/RegisterApiDefinitionResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface RegisterApiDefinitionResponse { apiDefinitionId: FernRegistry.ApiDefinitionId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/SnippetsConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/SnippetsConfig.ts index 9c7d8cc4fd..935a298f58 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/SnippetsConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/api/resources/v1/resources/register/types/SnippetsConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface SnippetsConfig { typescriptSdk?: FernRegistry.api.v1.register.TypescriptPackage; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/commons/types/EndpointIdentifier.ts b/packages/fdr-sdk/src/client/generated/api/resources/commons/types/EndpointIdentifier.ts index c15db5618f..45afc06ae9 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/commons/types/EndpointIdentifier.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/commons/types/EndpointIdentifier.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface EndpointIdentifier { path: FernRegistry.EndpointPath; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/Client.ts index ca0f621d67..e9c27a07bf 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../environments"; import * as core from "../../../../core"; -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import urlJoin from "url-join"; export declare namespace Diff { @@ -16,12 +16,23 @@ export declare namespace Diff { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Diff { constructor(protected readonly _options: Diff.Options = {}) {} + /** + * @param {FernRegistry.ApiDiffRequest} request + * @param {Diff.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.diff.diff({ + * previousApiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", + * currentApiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32" + * }) + */ public async diff( request: FernRegistry.ApiDiffRequest, requestOptions?: Diff.RequestOptions @@ -32,7 +43,7 @@ export class Diff { _queryParams["currentApiDefinitionId"] = currentApiDefinitionId; const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/registry/diff" ), method: "GET", @@ -46,6 +57,7 @@ export class Diff { queryParameters: _queryParams, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -60,7 +72,7 @@ export class Diff { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/diff.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/diff.ts index dcbda34cb5..11ab8c508b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/diff.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/diff.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = FernRegistry.diff.diff.Error._Unknown; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/ApiDiffRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/ApiDiffRequest.ts index 219a94df40..1d56e0bb8f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/ApiDiffRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/ApiDiffRequest.ts @@ -2,8 +2,15 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; +/** + * @example + * { + * previousApiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", + * currentApiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32" + * } + */ export interface ApiDiffRequest { /** * The id of the previous version of the api definition diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/index.ts index 8e3e8f7563..e73c1e674d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/client/requests/index.ts @@ -1 +1 @@ -export { ApiDiffRequest } from "./ApiDiffRequest"; +export { type ApiDiffRequest } from "./ApiDiffRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/AddedEndpoint.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/AddedEndpoint.ts index 478255a9f0..452da625f7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/AddedEndpoint.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/AddedEndpoint.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface AddedEndpoint { id: FernRegistry.EndpointIdentifier; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ApiDiff.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ApiDiff.ts index e4ce4393df..5d9d089cb7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ApiDiff.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ApiDiff.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface ApiDiff { addedEndpoints: FernRegistry.AddedEndpoint[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/PathParameterDiff.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/PathParameterDiff.ts index f1e33f9df5..ad29eaad0f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/PathParameterDiff.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/PathParameterDiff.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface PathParameterDiff { added: FernRegistry.PathParameter[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/QueryParameterDiff.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/QueryParameterDiff.ts index 93e0baab75..08f006cf77 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/QueryParameterDiff.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/QueryParameterDiff.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface QueryParameterDiff { added: FernRegistry.QueryParameter[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RemovedEndpoint.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RemovedEndpoint.ts index f001ca1e10..5ff4ad700b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RemovedEndpoint.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RemovedEndpoint.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface RemovedEndpoint { id: FernRegistry.EndpointIdentifier; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RequestBodyDiff.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RequestBodyDiff.ts index 9b4f8965be..3be3a4449c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RequestBodyDiff.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/RequestBodyDiff.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface RequestBodyDiff { added: FernRegistry.RequestBodyParameter[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ResponseBodyDiff.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ResponseBodyDiff.ts index 74935c8e79..c564b4e732 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ResponseBodyDiff.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/ResponseBodyDiff.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface ResponseBodyDiff { added: FernRegistry.ResponseBodyParameter[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/UpdatedEndpoint.ts b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/UpdatedEndpoint.ts index 52c8409b12..86617decf1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/diff/types/UpdatedEndpoint.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/diff/types/UpdatedEndpoint.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface UpdatedEndpoint { id: FernRegistry.EndpointIdentifier; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/client/Client.ts index 38c097a3c4..dcc64df44b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/client/Client.ts @@ -16,6 +16,7 @@ export declare namespace Docs { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/client/Client.ts index f9337875c1..0389490962 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/client/Client.ts @@ -16,6 +16,7 @@ export declare namespace V1 { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorConfig.ts index 43ded47cda..d0d514cf67 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type ColorConfig = | FernRegistry.docs.v1.commons.ColorConfig.Unthemed diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorThemedConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorThemedConfig.ts index 4dec1f764e..6ef020c8ed 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorThemedConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorThemedConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ColorThemedConfig { dark?: FernRegistry.docs.v1.commons.RgbaColor; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorUnthemedConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorUnthemedConfig.ts index c8800a837d..df304ad512 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorUnthemedConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorUnthemedConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ColorUnthemedConfig { color?: FernRegistry.docs.v1.commons.RgbaColor; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfig.ts index db26cda3e5..af1635180e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ColorsConfig { accentPrimary?: FernRegistry.docs.v1.commons.RgbaColor; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfigV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfigV2.ts index b2b8854be9..fea8815c4a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfigV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ColorsConfigV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ColorsConfigV2 { accentPrimary?: FernRegistry.docs.v1.commons.ColorConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfig.ts index 2817b8164b..09dbd8d85a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface CustomFontConfig { name: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfigVariant.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfigVariant.ts index 5329007f75..23920f2ced 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfigVariant.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/CustomFontConfigVariant.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface CustomFontConfigVariant { fontFile: FernRegistry.docs.v1.commons.FileId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfig.ts index 5f565e8eb9..21a4ec7892 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DocsTypographyConfig { headingsFont?: FernRegistry.docs.v1.commons.FontConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfigV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfigV2.ts index 43bb5d273c..d35926bc2c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfigV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/DocsTypographyConfigV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface DocsTypographyConfigV2 { headingsFont?: FernRegistry.docs.v1.commons.FontConfigV2; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FileIdOrUrl.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FileIdOrUrl.ts index fd41a62361..f126937543 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FileIdOrUrl.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FileIdOrUrl.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FileIdOrUrl = | FernRegistry.docs.v1.commons.FileIdOrUrl.FileId diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfig.ts index 06661fbb11..8b7125fe8f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface FontConfig { name: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfigV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfigV2.ts index b5dbeb41f4..7a700d0a16 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfigV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FontConfigV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FontConfigV2 = FernRegistry.docs.v1.commons.FontConfigV2.Custom; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FooterLink.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FooterLink.ts index d7b9042e08..3dc8af8e92 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FooterLink.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/FooterLink.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type FooterLink = | FernRegistry.docs.v1.commons.FooterLink.Github diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsConfig.ts index 522a7f3501..a5930d777c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface JsConfig { remote?: FernRegistry.docs.v1.commons.JsRemoteConfig[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsFileConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsFileConfig.ts index eb8e8d946a..8b4b444fae 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsFileConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsFileConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface JsFileConfig { fileId: FernRegistry.docs.v1.commons.FileId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsRemoteConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsRemoteConfig.ts index 53b33149a5..da0dd6745e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsRemoteConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/JsRemoteConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface JsRemoteConfig { url: FernRegistry.docs.v1.commons.Url; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/MetadataConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/MetadataConfig.ts index c1f1672628..f653a30747 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/MetadataConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/MetadataConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface MetadataConfig { "og:site_name"?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarGithubMetadata.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarGithubMetadata.ts index 38c6ae7680..cfc745b224 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarGithubMetadata.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarGithubMetadata.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface NavbarGithubMetadata { url: FernRegistry.docs.v1.commons.Url; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLink.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLink.ts index 1cadfd25e5..1b504c03d4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLink.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLink.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export type NavbarLink = | FernRegistry.docs.v1.commons.NavbarLink.Filled diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLinkMetadata.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLinkMetadata.ts index f85d6f9edd..b35aa096a3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLinkMetadata.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/NavbarLinkMetadata.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface NavbarLinkMetadata { url: FernRegistry.docs.v1.commons.Url; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ThemedFileId.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ThemedFileId.ts index 3b8009623d..c2167be607 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ThemedFileId.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/ThemedFileId.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../../index"; export interface ThemedFileId { dark?: FernRegistry.docs.v1.commons.FileId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/ApiSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/ApiSection.ts index 377374e794..a3c7a24ffc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/ApiSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/ApiSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiSection { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DbFileInfoV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DbFileInfoV2.ts index d954f8b8b9..31c68a3d1c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DbFileInfoV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DbFileInfoV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type DbFileInfoV2 = FernRegistry.docs.v1.db.DbFileInfoV2.S3Key | FernRegistry.docs.v1.db.DbFileInfoV2.Image; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDbConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDbConfig.ts index b2b0e0b11f..c0a31a4ec6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDbConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDbConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsDbConfig { title?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDb.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDb.ts index d5b6725d7f..cd59a2c1ab 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDb.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDb.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type DocsDefinitionDb = | FernRegistry.docs.v1.db.DocsDefinitionDb.V1 diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV1.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV1.ts index 3f3b34200b..1f92edb2dc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV1.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV1.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsDefinitionDbV1 { pages: Record; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV2.ts index 4a5b03deea..aa686008f7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsDefinitionDbV2 { pages: Record; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV3.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV3.ts index eb44b7ab0c..1e4e1f9557 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV3.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsDefinitionDbV3.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsDefinitionDbV3 { pages: Record; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsSection.ts index d36c970cbc..2e0f1e3ee2 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/DocsSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsSection { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationConfig.ts index 540fed8256..1069e50352 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationConfig = | FernRegistry.docs.v1.db.UnversionedNavigationConfig diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationItem.ts index be07998672..82a2599dd4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationItem = | FernRegistry.docs.v1.db.NavigationItem.Page diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTab.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTab.ts index 816a682e1f..6f4d3795e4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTab.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTab.ts @@ -2,6 +2,6 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationTab = FernRegistry.docs.v1.db.NavigationTabGroup | FernRegistry.docs.v1.read.NavigationTabLink; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabGroup.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabGroup.ts index c0f2b275f0..a0a40afef5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabGroup.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabGroup.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NavigationTabGroup { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabV2.ts index b887d16473..5d248c64f6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/NavigationTabV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationTabV2 = | FernRegistry.docs.v1.db.NavigationTabV2.Group diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedNavigationConfig.ts index 25eb3d7a41..0572401265 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type UnversionedNavigationConfig = | FernRegistry.docs.v1.db.UnversionedTabbedNavigationConfig diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedTabbedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedTabbedNavigationConfig.ts index 7e7de82cdc..c3c6c0d191 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedTabbedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedTabbedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedTabbedNavigationConfig { tabs?: FernRegistry.docs.v1.db.NavigationTab[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedUntabbedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedUntabbedNavigationConfig.ts index fe95644985..778740f97c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedUntabbedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/UnversionedUntabbedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedUntabbedNavigationConfig { items: FernRegistry.docs.v1.db.NavigationItem[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfig.ts index f5bf383ec7..345fb4965b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedNavigationConfig { versions: FernRegistry.docs.v1.db.VersionedNavigationConfigData[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfigData.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfigData.ts index e7f03aab60..f9bdee929e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfigData.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/db/types/VersionedNavigationConfigData.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedNavigationConfigData { version: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/Client.ts index 1739a02589..2e191f38bf 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../../../../../environments"; import * as core from "../../../../../../../../core"; -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import urlJoin from "url-join"; export declare namespace Read { @@ -16,12 +16,20 @@ export declare namespace Read { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Read { constructor(protected readonly _options: Read.Options = {}) {} + /** + * @param {string} domain + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v1.read.getDocsForDomainLegacy("string") + */ public async getDocsForDomainLegacy( domain: string, requestOptions?: Read.RequestOptions @@ -33,8 +41,8 @@ export class Read { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, - `/registry/docs/load/${domain}` + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, + `/registry/docs/load/${encodeURIComponent(domain)}` ), method: "GET", headers: { @@ -46,6 +54,7 @@ export class Read { contentType: "application/json", timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -70,6 +79,15 @@ export class Read { }; } + /** + * @param {FernRegistry.docs.v1.read.LoadDocsForDomainRequest} request + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v1.read.getDocsForDomain({ + * domain: "string" + * }) + */ public async getDocsForDomain( request: FernRegistry.docs.v1.read.LoadDocsForDomainRequest, requestOptions?: Read.RequestOptions @@ -78,7 +96,7 @@ export class Read { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/registry/docs/load" ), method: "POST", @@ -92,6 +110,7 @@ export class Read { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -116,7 +135,7 @@ export class Read { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomain.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomain.ts index 74f8bd12d0..5c247b7fb2 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomain.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomain.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomainLegacy.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomainLegacy.ts index 79f0d4fcc4..5baf3096c4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomainLegacy.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/getDocsForDomainLegacy.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/LoadDocsForDomainRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/LoadDocsForDomainRequest.ts index 74af9af185..4b93a639e6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/LoadDocsForDomainRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/LoadDocsForDomainRequest.ts @@ -2,6 +2,12 @@ * This file was auto-generated by Fern from our API Definition. */ +/** + * @example + * { + * domain: "string" + * } + */ export interface LoadDocsForDomainRequest { domain: string; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/index.ts index fa64a57f4d..45ce7b4139 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/client/requests/index.ts @@ -1 +1 @@ -export { LoadDocsForDomainRequest } from "./LoadDocsForDomainRequest"; +export { type LoadDocsForDomainRequest } from "./LoadDocsForDomainRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecord.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecord.ts index 38fba3ebf1..ff68e214b6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecord.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecord.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaEndpointRecord { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecordV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecordV2.ts index 7a06d90429..11ecf5d88e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecordV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaEndpointRecordV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaEndpointRecordV2 { endpoint: FernRegistry.docs.v1.read.AlgoliaRecordEndpointSummary; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecord.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecord.ts index f616eb1af7..9c159ddef9 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecord.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecord.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaPageRecord { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecordV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecordV2.ts index 43d68bc308..7b1d6c0f58 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecordV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaPageRecordV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaPageRecordV2 { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecord.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecord.ts index 62bbceef89..76e9b08141 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecord.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecord.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type AlgoliaRecord = | FernRegistry.docs.v1.read.AlgoliaRecord.Endpoint diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointPath.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointPath.ts index 258951f1e4..b42a0ccd76 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointPath.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointPath.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaRecordEndpointPath { parts: FernRegistry.api.v1.read.EndpointPathPart[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointSummary.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointSummary.ts index 99afbc132c..9c48e570c2 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointSummary.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordEndpointSummary.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaRecordEndpointSummary { name?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordPath.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordPath.ts index 854e5218ab..5eca062ed4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordPath.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordPath.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; /** * The path corresponding to a search record represented as a list of parts. If the docs are versioned, the version prefix must be added when building the string representation of the path. diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordVersion.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordVersion.ts index c0ea825b6e..30d68ff7aa 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordVersion.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/AlgoliaRecordVersion.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface AlgoliaRecordVersion { id: FernRegistry.docs.v1.read.VersionId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiArtifacts.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiArtifacts.ts index 8fcd09369b..21b1df424f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiArtifacts.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiArtifacts.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiArtifacts { sdks: FernRegistry.docs.v1.read.PublishedSdk[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigItem.ts index 1119902dcb..745cb754ee 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ApiNavigationConfigItem = | FernRegistry.docs.v1.read.ApiNavigationConfigItem.Subpackage diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts index d998366018..b46a79d106 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigRoot.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigRoot { summaryPageId?: FernRegistry.docs.v1.commons.PageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts index a55ff5a7fb..bcc78582f0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiNavigationConfigSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigSubpackage { summaryPageId?: FernRegistry.docs.v1.commons.PageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiSection.ts index 2bb0454917..431b6f800b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ApiSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiSection extends FernRegistry.docs.v1.read.NavigationNodeMetadata { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/Background.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/Background.ts index e8d178c177..f2952c99db 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/Background.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/Background.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type Background = FernRegistry.docs.v1.read.Background.Solid | FernRegistry.docs.v1.read.Background.Gradient; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogItem.ts index 7cf01888dd..e4156552fc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ChangelogItem { date: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSection.ts index 6d8ae28ad3..642a31e7e0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ChangelogSection extends FernRegistry.docs.v1.read.NavigationNodeMetadata { title?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSectionV1.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSectionV1.ts index 1dfdf027e4..962eba324d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSectionV1.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ChangelogSectionV1.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ChangelogSectionV1 extends FernRegistry.docs.v1.read.ChangelogSection { type: "changelog"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ColorsConfigV3.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ColorsConfigV3.ts index 51310fea80..19bdbf60be 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ColorsConfigV3.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ColorsConfigV3.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ColorsConfigV3 = | FernRegistry.docs.v1.read.ColorsConfigV3.Dark diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DarkAndLightModeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DarkAndLightModeConfig.ts index b2ae509a71..b9cea0c1b1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DarkAndLightModeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DarkAndLightModeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DarkAndLightModeConfig { dark: FernRegistry.docs.v1.read.ThemeConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsConfig.ts index 8bc88e986a..45ee2c6077 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsConfig { title?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsDefinition.ts index 065bf1f552..e9ca4e0c2a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsDefinition { algoliaSearchIndex?: FernRegistry.docs.v1.read.AlgoliaSearchIndex; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsLayoutConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsLayoutConfig.ts index 64f94135c3..e30e4fcc6c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsLayoutConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsLayoutConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsLayoutConfig { pageWidth?: FernRegistry.docs.v1.read.PageWidthSizeConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsSection.ts index f2dfa78c12..329247183b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/DocsSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsSection extends FernRegistry.docs.v1.read.NavigationNodeMetadata { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/File_.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/File_.ts index 7c51d4d1dd..bbc5c2aacc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/File_.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/File_.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type File_ = FernRegistry.docs.v1.read.File_.Url | FernRegistry.docs.v1.read.File_.Image; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ImageFile.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ImageFile.ts index 405c5dfbf4..11a90df1e7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ImageFile.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ImageFile.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ImageFile { url: FernRegistry.docs.v1.commons.Url; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/IndexSegment.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/IndexSegment.ts index 4cee47b756..5c5c075505 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/IndexSegment.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/IndexSegment.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface IndexSegment { id: FernRegistry.docs.v1.read.IndexSegmentId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/LoadDocsForUrlResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/LoadDocsForUrlResponse.ts index c290625d10..b4cc1b4307 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/LoadDocsForUrlResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/LoadDocsForUrlResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface LoadDocsForUrlResponse { baseUrl: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/MavenPackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/MavenPackage.ts index e9c558011b..8783217b0d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/MavenPackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/MavenPackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface MavenPackage { coordinate: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationConfig.ts index 623b6c133c..dd59c80d86 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationConfig = | FernRegistry.docs.v1.read.UnversionedNavigationConfig diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationItem.ts index 71b8ff0a8f..aac625ebbd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationItem = | FernRegistry.docs.v1.read.NavigationItem.Page diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTab.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTab.ts index 1fbb4fd1dc..5535845c1a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTab.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTab.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationTab = | FernRegistry.docs.v1.read.NavigationTabGroupV1 diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroup.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroup.ts index 4116d75613..cf7ffe0bf9 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroup.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroup.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NavigationTabGroup extends FernRegistry.docs.v1.read.NavigationNodeMetadata { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroupV1.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroupV1.ts index 97bca84669..cfb4855627 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroupV1.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabGroupV1.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NavigationTabGroupV1 extends FernRegistry.docs.v1.read.NavigationTabGroup { type?: "group"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLink.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLink.ts index 378a2f3e7e..e57c90bb3c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLink.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLink.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NavigationTabLink { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLinkV1.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLinkV1.ts index 55bf313bff..12094c7292 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLinkV1.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NavigationTabLinkV1.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NavigationTabLinkV1 extends FernRegistry.docs.v1.read.NavigationTabLink { type: "link"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NpmPackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NpmPackage.ts index 783b4aeb78..be14a52559 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NpmPackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/NpmPackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NpmPackage { packageName: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageContent.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageContent.ts index 125bb14bfa..9e3e918868 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageContent.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageContent.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface PageContent { markdown: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageMetadata.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageMetadata.ts index a2a078b649..8747f05ad7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageMetadata.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageMetadata.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface PageMetadata extends FernRegistry.docs.v1.read.NavigationNodeMetadata { id: FernRegistry.docs.v1.commons.PageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageWidthSizeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageWidthSizeConfig.ts index 0cb02af7fb..b76b76875a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageWidthSizeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PageWidthSizeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type PageWidthSizeConfig = | FernRegistry.docs.v1.read.PageWidthSizeConfig.Px diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedPostmanCollection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedPostmanCollection.ts index 8c54c3db14..cb4b7d2269 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedPostmanCollection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedPostmanCollection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface PublishedPostmanCollection { url: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedSdk.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedSdk.ts index 62707f17ca..7c981b6283 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedSdk.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PublishedSdk.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type PublishedSdk = | FernRegistry.docs.v1.read.PublishedSdk.Npm diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PypiPackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PypiPackage.ts index 41eade61a1..03d3924f75 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PypiPackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/PypiPackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface PypiPackage { packageName: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SearchInfo.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SearchInfo.ts index 57e7d82e2a..d8a9f07845 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SearchInfo.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SearchInfo.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type SearchInfo = /** diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SingleAlgoliaIndexInfo.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SingleAlgoliaIndexInfo.ts index cd423947e4..e756e237ab 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SingleAlgoliaIndexInfo.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SingleAlgoliaIndexInfo.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type SingleAlgoliaIndexInfo = | FernRegistry.docs.v1.read.SingleAlgoliaIndexInfo.Unversioned diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SizeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SizeConfig.ts index 2baef3f20b..ee31ec8be1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SizeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/SizeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type SizeConfig = FernRegistry.docs.v1.read.SizeConfig.Px | FernRegistry.docs.v1.read.SizeConfig.Rem; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ThemeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ThemeConfig.ts index d789495143..26557b56d8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ThemeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/ThemeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ThemeConfig { logo?: FernRegistry.docs.v1.commons.FileId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedNavigationConfig.ts index 3d6b2d09ca..f830326387 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type UnversionedNavigationConfig = | FernRegistry.docs.v1.read.UnversionedTabbedNavigationConfig diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedSingleAlgoliaIndexInfo.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedSingleAlgoliaIndexInfo.ts index 77075782fa..5b9986d9ce 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedSingleAlgoliaIndexInfo.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedSingleAlgoliaIndexInfo.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedSingleAlgoliaIndexInfo { indexSegment: FernRegistry.docs.v1.read.IndexSegment; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedTabbedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedTabbedNavigationConfig.ts index ba5d0cb700..659e47dc26 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedTabbedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedTabbedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedTabbedNavigationConfig { tabs: FernRegistry.docs.v1.read.NavigationTab[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedUntabbedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedUntabbedNavigationConfig.ts index 18bf271bcb..086a349a34 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedUntabbedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UnversionedUntabbedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedUntabbedNavigationConfig { items: FernRegistry.docs.v1.read.NavigationItem[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UrlFile.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UrlFile.ts index 7035709a5f..17d98f19a0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UrlFile.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/UrlFile.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UrlFile { url: FernRegistry.docs.v1.commons.Url; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfig.ts index 103f958191..d0e2e578a5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedNavigationConfig { versions: FernRegistry.docs.v1.read.VersionedNavigationConfigData[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfigData.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfigData.ts index 650153cd07..a4fca7b3f7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfigData.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedNavigationConfigData.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedNavigationConfigData { version: FernRegistry.docs.v1.read.VersionId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedSingleAlgoliaIndexInfo.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedSingleAlgoliaIndexInfo.ts index 2027a63edc..680cda290f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedSingleAlgoliaIndexInfo.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/read/types/VersionedSingleAlgoliaIndexInfo.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedSingleAlgoliaIndexInfo { indexSegmentsByVersionId: Record; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/Client.ts index ee050cb1a5..e282ff382d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../../../../../environments"; import * as core from "../../../../../../../../core"; -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import urlJoin from "url-join"; export declare namespace Write { @@ -16,12 +16,24 @@ export declare namespace Write { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Write { constructor(protected readonly _options: Write.Options = {}) {} + /** + * @param {FernRegistry.docs.v1.write.StartDocsRegisterRequest} request + * @param {Write.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v1.write.startDocsRegister({ + * domain: "string", + * orgId: "string", + * filepaths: ["string"] + * }) + */ public async startDocsRegister( request: FernRegistry.docs.v1.write.StartDocsRegisterRequest, requestOptions?: Write.RequestOptions @@ -33,7 +45,7 @@ export class Write { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/registry/docs/init" ), method: "POST", @@ -47,6 +59,7 @@ export class Write { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -61,6 +74,21 @@ export class Write { }; } + /** + * @param {FernRegistry.docs.v1.write.DocsRegistrationId} docsRegistrationId + * @param {FernRegistry.docs.v1.write.RegisterDocsRequest} request + * @param {Write.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v1.write.finishDocsRegister("string", { + * docsDefinition: { + * pages: { + * "string": {} + * }, + * config: {} + * } + * }) + */ public async finishDocsRegister( docsRegistrationId: FernRegistry.docs.v1.write.DocsRegistrationId, request: FernRegistry.docs.v1.write.RegisterDocsRequest, @@ -68,8 +96,8 @@ export class Write { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, - `/registry/docs/register/${docsRegistrationId}` + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, + `/registry/docs/register/${encodeURIComponent(docsRegistrationId)}` ), method: "POST", headers: { @@ -82,6 +110,7 @@ export class Write { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -108,7 +137,7 @@ export class Write { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/finishDocsRegister.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/finishDocsRegister.ts index e7828a2452..ff5f533e53 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/finishDocsRegister.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/finishDocsRegister.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/RegisterDocsRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/RegisterDocsRequest.ts index a49c0f26ee..698999a847 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/RegisterDocsRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/RegisterDocsRequest.ts @@ -2,8 +2,19 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../index"; +/** + * @example + * { + * docsDefinition: { + * pages: { + * "string": {} + * }, + * config: {} + * } + * } + */ export interface RegisterDocsRequest { docsDefinition: FernRegistry.docs.v1.write.DocsDefinition; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/StartDocsRegisterRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/StartDocsRegisterRequest.ts index 85167469a1..e826636f89 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/StartDocsRegisterRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/StartDocsRegisterRequest.ts @@ -2,8 +2,16 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../index"; +/** + * @example + * { + * domain: "string", + * orgId: "string", + * filepaths: ["string"] + * } + */ export interface StartDocsRegisterRequest { domain: string; orgId: FernRegistry.OrgId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/index.ts index 15cbb1fd08..70d9c96658 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/requests/index.ts @@ -1,2 +1,2 @@ -export { StartDocsRegisterRequest } from "./StartDocsRegisterRequest"; -export { RegisterDocsRequest } from "./RegisterDocsRequest"; +export { type StartDocsRegisterRequest } from "./StartDocsRegisterRequest"; +export { type RegisterDocsRequest } from "./RegisterDocsRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/startDocsRegister.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/startDocsRegister.ts index 75d2202abd..f236acc99e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/startDocsRegister.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/client/startDocsRegister.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = FernRegistry.docs.v1.write.startDocsRegister.Error._Unknown; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiArtifacts.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiArtifacts.ts index 354d77caff..70825572d5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiArtifacts.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiArtifacts.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiArtifacts { sdks: FernRegistry.docs.v1.write.PublishedSdk[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigItem.ts index 58fe20911d..49936ce8f5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ApiNavigationConfigItem = | FernRegistry.docs.v1.write.ApiNavigationConfigItem.Subpackage diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigRoot.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigRoot.ts index 9d372936f7..1a10518ce3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigRoot.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigRoot.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigRoot { summaryPageId?: FernRegistry.docs.v1.commons.PageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigSubpackage.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigSubpackage.ts index 32fccbccee..9d0ef2d5d0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigSubpackage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiNavigationConfigSubpackage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiNavigationConfigSubpackage { summaryPageId?: FernRegistry.docs.v1.commons.PageId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiSection.ts index ff0934fbe5..55035bc4e1 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ApiSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ApiSection extends FernRegistry.docs.v1.write.NavigationNodeMetadata { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSection.ts index a0c710b9b0..117074ce74 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ChangelogSection { /** Optional title for the changelog section. Defaults to "Changelog" if not provided. */ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSectionV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSectionV2.ts index 637cc34359..3644a3434a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSectionV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ChangelogSectionV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ChangelogSectionV2 extends FernRegistry.docs.v1.write.NavigationNodeMetadata { title?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ColorsConfigV3.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ColorsConfigV3.ts index cf6aea7587..d53be5a7c6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ColorsConfigV3.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ColorsConfigV3.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type ColorsConfigV3 = | FernRegistry.docs.v1.write.ColorsConfigV3.Dark diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DarkAndLightModeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DarkAndLightModeConfig.ts index 564c0eee4b..95f17d34cb 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DarkAndLightModeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DarkAndLightModeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DarkAndLightModeConfig { dark: FernRegistry.docs.v1.write.ThemeConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsConfig.ts index 7a967c5791..d6bb85446b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsConfig { title?: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsDefinition.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsDefinition.ts index fb0f5eedb0..c0f9225caa 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsDefinition.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsDefinition.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsDefinition { pages: Record; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsLayoutConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsLayoutConfig.ts index 301422477f..f5b77d0684 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsLayoutConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsLayoutConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsLayoutConfig { pageWidth?: FernRegistry.docs.v1.write.PageWidthSizeConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsSection.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsSection.ts index b69216104d..f44e92c951 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsSection.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/DocsSection.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface DocsSection extends FernRegistry.docs.v1.write.NavigationNodeMetadata { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/FileS3UploadUrl.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/FileS3UploadUrl.ts index e99d4a3c14..33e3c408b6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/FileS3UploadUrl.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/FileS3UploadUrl.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface FileS3UploadUrl { uploadUrl: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/InvliadCustomDomainErrorBody.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/InvliadCustomDomainErrorBody.ts index d3412463d7..cc50dcf410 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/InvliadCustomDomainErrorBody.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/InvliadCustomDomainErrorBody.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface InvliadCustomDomainErrorBody { overlappingDomains: FernRegistry.docs.v1.write.OverlappingCustomDomains[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationConfig.ts index f4505706fc..587afdadc7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationConfig = | FernRegistry.docs.v1.write.UnversionedNavigationConfig diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationItem.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationItem.ts index da8577b8b4..3b1d75511c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationItem.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationItem.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationItem = | FernRegistry.docs.v1.write.NavigationItem.Page diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTab.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTab.ts index a675af0f2d..6d23e46574 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTab.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTab.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationTab = | FernRegistry.docs.v1.write.NavigationTabGroup diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabGroup.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabGroup.ts index 1ec92a451d..0e4ad3a8ee 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabGroup.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabGroup.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface NavigationTabGroup extends FernRegistry.docs.v1.write.NavigationNodeMetadata { title: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabV2.ts index 48409aa9bd..deb9dbacc6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/NavigationTabV2.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type NavigationTabV2 = | FernRegistry.docs.v1.write.NavigationTabV2.Group diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageContent.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageContent.ts index 125bb14bfa..9e3e918868 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageContent.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageContent.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface PageContent { markdown: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageMetadata.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageMetadata.ts index cd5560d917..1de29a44d6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageMetadata.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageMetadata.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface PageMetadata extends FernRegistry.docs.v1.write.NavigationNodeMetadata { /** This is a filepath relative to the fern folder, with a .md/.mdx extension. */ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageWidthSizeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageWidthSizeConfig.ts index b493aae59e..a4e2a63186 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageWidthSizeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PageWidthSizeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type PageWidthSizeConfig = | FernRegistry.docs.v1.write.PageWidthSizeConfig.Px diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PublishedSdk.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PublishedSdk.ts index fbc1d11cfa..8bdaa734f4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PublishedSdk.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/PublishedSdk.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type PublishedSdk = | FernRegistry.docs.v1.write.PublishedSdk.Npm diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/SizeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/SizeConfig.ts index d2e3007e8c..ce481d3f16 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/SizeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/SizeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type SizeConfig = FernRegistry.docs.v1.write.SizeConfig.Px | FernRegistry.docs.v1.write.SizeConfig.Rem; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/StartDocsRegisterResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/StartDocsRegisterResponse.ts index c47c308fee..a2aa6fc648 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/StartDocsRegisterResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/StartDocsRegisterResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface StartDocsRegisterResponse { docsRegistrationId: FernRegistry.docs.v1.write.DocsRegistrationId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ThemeConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ThemeConfig.ts index 7dd41be040..76c7765cf3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ThemeConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/ThemeConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ThemeConfig { logo?: FernRegistry.docs.v1.commons.FileId; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedNavigationConfig.ts index 59aea520d5..d04c528bdb 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type UnversionedNavigationConfig = | FernRegistry.docs.v1.write.UnversionedTabbedNavigationConfig diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedTabbedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedTabbedNavigationConfig.ts index 6a8e94d51e..56b6589e6f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedTabbedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedTabbedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedTabbedNavigationConfig { tabs?: FernRegistry.docs.v1.write.NavigationTab[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedUntabbedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedUntabbedNavigationConfig.ts index b0973a1e17..efe653addc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedUntabbedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/UnversionedUntabbedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface UnversionedUntabbedNavigationConfig { items: FernRegistry.docs.v1.write.NavigationItem[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfig.ts index 01cb99d879..3e93b7bc4e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedNavigationConfig { versions: FernRegistry.docs.v1.write.VersionedNavigationConfigData[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfigData.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfigData.ts index 09f3e2e34e..c58551af79 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfigData.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v1/resources/write/types/VersionedNavigationConfigData.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface VersionedNavigationConfigData { version: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/client/Client.ts index adf1ec29d0..705bb2decd 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/client/Client.ts @@ -16,6 +16,7 @@ export declare namespace V2 { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/Client.ts index 454d628ca2..2fe8ea8e39 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../../../../../environments"; import * as core from "../../../../../../../../core"; -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import urlJoin from "url-join"; export declare namespace Read { @@ -16,19 +16,29 @@ export declare namespace Read { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Read { constructor(protected readonly _options: Read.Options = {}) {} + /** + * @param {FernRegistry.docs.v2.read.GetOrganizationForUrlRequest} request + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.read.getOrganizationForUrl({ + * url: "string" + * }) + */ public async getOrganizationForUrl( request: FernRegistry.docs.v2.read.GetOrganizationForUrlRequest, requestOptions?: Read.RequestOptions ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/v2/registry/docs/organization-for-url" ), method: "POST", @@ -42,6 +52,7 @@ export class Read { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -66,6 +77,15 @@ export class Read { }; } + /** + * @param {FernRegistry.docs.v2.read.LoadDocsForUrlRequest} request + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.read.getDocsForUrl({ + * url: "string" + * }) + */ public async getDocsForUrl( request: FernRegistry.docs.v2.read.LoadDocsForUrlRequest, requestOptions?: Read.RequestOptions @@ -77,7 +97,7 @@ export class Read { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/v2/registry/docs/load-with-url" ), method: "POST", @@ -91,6 +111,7 @@ export class Read { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -116,6 +137,15 @@ export class Read { }; } + /** + * @param {FernRegistry.docs.v2.read.LoadPrivateDocsForUrlRequest} request + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.read.getPrivateDocsForUrl({ + * url: "string" + * }) + */ public async getPrivateDocsForUrl( request: FernRegistry.docs.v2.read.LoadPrivateDocsForUrlRequest, requestOptions?: Read.RequestOptions @@ -127,7 +157,7 @@ export class Read { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/v2/registry/docs/private/load-with-url" ), method: "POST", @@ -141,6 +171,7 @@ export class Read { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -168,6 +199,12 @@ export class Read { /** * Loads the Docs Config and any referenced APIs by ID. + * + * @param {FernRegistry.DocsConfigId} docsConfigId + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.read.getDocsConfigById("string") */ public async getDocsConfigById( docsConfigId: FernRegistry.DocsConfigId, @@ -180,8 +217,8 @@ export class Read { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, - `/v2/registry/docs/${docsConfigId}` + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, + `/v2/registry/docs/${encodeURIComponent(docsConfigId)}` ), method: "GET", headers: { @@ -193,6 +230,7 @@ export class Read { contentType: "application/json", timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -217,6 +255,15 @@ export class Read { }; } + /** + * @param {FernRegistry.docs.v2.read.GetSearchApiKeyForIndexSegmentRequest} request + * @param {Read.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.read.getSearchApiKeyForIndexSegment({ + * indexSegmentId: "string" + * }) + */ public async getSearchApiKeyForIndexSegment( request: FernRegistry.docs.v2.read.GetSearchApiKeyForIndexSegmentRequest, requestOptions?: Read.RequestOptions @@ -228,7 +275,7 @@ export class Read { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/v2/registry/docs/search-api-key-with-index-segment" ), method: "POST", @@ -242,6 +289,7 @@ export class Read { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -266,7 +314,7 @@ export class Read { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsConfigById.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsConfigById.ts index 3df53c4bb6..c65ed68b7e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsConfigById.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsConfigById.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsForUrl.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsForUrl.ts index 3d9bd9e131..2921c609d6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsForUrl.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getDocsForUrl.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getOrganizationForUrl.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getOrganizationForUrl.ts index f972feb803..3710563699 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getOrganizationForUrl.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getOrganizationForUrl.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getPrivateDocsForUrl.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getPrivateDocsForUrl.ts index c1f6a4e93c..37c691ab5b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getPrivateDocsForUrl.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getPrivateDocsForUrl.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getSearchApiKeyForIndexSegment.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getSearchApiKeyForIndexSegment.ts index dbbb6bc43b..098b5bea8e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getSearchApiKeyForIndexSegment.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/getSearchApiKeyForIndexSegment.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetOrganizationForUrlRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetOrganizationForUrlRequest.ts index 6eb6bf72ac..a1144a1242 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetOrganizationForUrlRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetOrganizationForUrlRequest.ts @@ -2,6 +2,12 @@ * This file was auto-generated by Fern from our API Definition. */ +/** + * @example + * { + * url: "string" + * } + */ export interface GetOrganizationForUrlRequest { url: string; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetSearchApiKeyForIndexSegmentRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetSearchApiKeyForIndexSegmentRequest.ts index d22c0818b6..fdcc28dfd6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetSearchApiKeyForIndexSegmentRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/GetSearchApiKeyForIndexSegmentRequest.ts @@ -2,6 +2,12 @@ * This file was auto-generated by Fern from our API Definition. */ +/** + * @example + * { + * indexSegmentId: "string" + * } + */ export interface GetSearchApiKeyForIndexSegmentRequest { indexSegmentId: string; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadDocsForUrlRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadDocsForUrlRequest.ts index 39aa27ed04..c271ebff83 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadDocsForUrlRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadDocsForUrlRequest.ts @@ -2,6 +2,12 @@ * This file was auto-generated by Fern from our API Definition. */ +/** + * @example + * { + * url: "string" + * } + */ export interface LoadDocsForUrlRequest { url: string; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadPrivateDocsForUrlRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadPrivateDocsForUrlRequest.ts index 22cc9d6be7..77b74347ce 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadPrivateDocsForUrlRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/LoadPrivateDocsForUrlRequest.ts @@ -2,6 +2,12 @@ * This file was auto-generated by Fern from our API Definition. */ +/** + * @example + * { + * url: "string" + * } + */ export interface LoadPrivateDocsForUrlRequest { url: string; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/index.ts index ab6525cf23..2f0ab067ac 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/client/requests/index.ts @@ -1,4 +1,4 @@ -export { GetOrganizationForUrlRequest } from "./GetOrganizationForUrlRequest"; -export { LoadDocsForUrlRequest } from "./LoadDocsForUrlRequest"; -export { LoadPrivateDocsForUrlRequest } from "./LoadPrivateDocsForUrlRequest"; -export { GetSearchApiKeyForIndexSegmentRequest } from "./GetSearchApiKeyForIndexSegmentRequest"; +export { type GetOrganizationForUrlRequest } from "./GetOrganizationForUrlRequest"; +export { type LoadDocsForUrlRequest } from "./LoadDocsForUrlRequest"; +export { type LoadPrivateDocsForUrlRequest } from "./LoadPrivateDocsForUrlRequest"; +export { type GetSearchApiKeyForIndexSegmentRequest } from "./GetSearchApiKeyForIndexSegmentRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/GetDocsConfigByIdResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/GetDocsConfigByIdResponse.ts index 0e508ebb0e..8aedd330c2 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/GetDocsConfigByIdResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/GetDocsConfigByIdResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface GetDocsConfigByIdResponse { docsConfig: FernRegistry.docs.v1.read.DocsConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/LoadDocsForUrlResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/LoadDocsForUrlResponse.ts index 61cb41ac35..18516f9357 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/LoadDocsForUrlResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/read/types/LoadDocsForUrlResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface LoadDocsForUrlResponse { baseUrl: FernRegistry.docs.v2.read.BaseUrl; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/Client.ts index 0b4844901c..793971f60f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../../../../../environments"; import * as core from "../../../../../../../../core"; -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import urlJoin from "url-join"; export declare namespace Write { @@ -16,12 +16,36 @@ export declare namespace Write { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class Write { constructor(protected readonly _options: Write.Options = {}) {} + /** + * @param {FernRegistry.docs.v2.write.StartDocsRegisterRequestV2} request + * @param {Write.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.write.startDocsRegister({ + * domain: "string", + * customDomains: ["string"], + * authConfig: { + * type: "public" + * }, + * orgId: "string", + * apiId: "string", + * filepaths: ["string"], + * images: [{ + * filePath: "string", + * width: 1.1, + * height: 1.1, + * blurDataUrl: "string", + * alt: "string" + * }] + * }) + */ public async startDocsRegister( request: FernRegistry.docs.v2.write.StartDocsRegisterRequestV2, requestOptions?: Write.RequestOptions @@ -33,7 +57,7 @@ export class Write { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/v2/registry/docs/v2/init" ), method: "POST", @@ -47,6 +71,7 @@ export class Write { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -73,6 +98,26 @@ export class Write { }; } + /** + * @param {FernRegistry.docs.v2.write.StartDocsPreviewRegisterRequestV2} request + * @param {Write.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.write.startDocsPreviewRegister({ + * orgId: "string", + * authConfig: { + * type: "public" + * }, + * filepaths: ["string"], + * images: [{ + * filePath: "string", + * width: 1.1, + * height: 1.1, + * blurDataUrl: "string", + * alt: "string" + * }] + * }) + */ public async startDocsPreviewRegister( request: FernRegistry.docs.v2.write.StartDocsPreviewRegisterRequestV2, requestOptions?: Write.RequestOptions @@ -84,7 +129,7 @@ export class Write { > { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/v2/registry/docs/preview/init" ), method: "POST", @@ -98,6 +143,7 @@ export class Write { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -122,6 +168,21 @@ export class Write { }; } + /** + * @param {FernRegistry.docs.v1.write.DocsRegistrationId} docsRegistrationId + * @param {FernRegistry.docs.v2.write.RegisterDocsRequest} request + * @param {Write.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docs.v2.write.finishDocsRegister("string", { + * docsDefinition: { + * pages: { + * "string": {} + * }, + * config: {} + * } + * }) + */ public async finishDocsRegister( docsRegistrationId: FernRegistry.docs.v1.write.DocsRegistrationId, request: FernRegistry.docs.v2.write.RegisterDocsRequest, @@ -129,8 +190,8 @@ export class Write { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, - `/v2/registry/docs/register/${docsRegistrationId}` + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, + `/v2/registry/docs/register/${encodeURIComponent(docsRegistrationId)}` ), method: "POST", headers: { @@ -143,6 +204,7 @@ export class Write { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -169,7 +231,7 @@ export class Write { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/finishDocsRegister.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/finishDocsRegister.ts index d5a6ee4fcd..4dfaabb38b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/finishDocsRegister.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/finishDocsRegister.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/RegisterDocsRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/RegisterDocsRequest.ts index a49c0f26ee..698999a847 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/RegisterDocsRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/RegisterDocsRequest.ts @@ -2,8 +2,19 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../index"; +/** + * @example + * { + * docsDefinition: { + * pages: { + * "string": {} + * }, + * config: {} + * } + * } + */ export interface RegisterDocsRequest { docsDefinition: FernRegistry.docs.v1.write.DocsDefinition; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsPreviewRegisterRequestV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsPreviewRegisterRequestV2.ts index d22a22bc32..789d1df36f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsPreviewRegisterRequestV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsPreviewRegisterRequestV2.ts @@ -2,8 +2,25 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../index"; +/** + * @example + * { + * orgId: "string", + * authConfig: { + * type: "public" + * }, + * filepaths: ["string"], + * images: [{ + * filePath: "string", + * width: 1.1, + * height: 1.1, + * blurDataUrl: "string", + * alt: "string" + * }] + * } + */ export interface StartDocsPreviewRegisterRequestV2 { orgId: FernRegistry.OrgId; authConfig?: FernRegistry.docs.v2.write.AuthConfig; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsRegisterRequestV2.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsRegisterRequestV2.ts index beeaa83f19..4781e91e64 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsRegisterRequestV2.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/StartDocsRegisterRequestV2.ts @@ -2,8 +2,28 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../../.."; +import * as FernRegistry from "../../../../../../../../index"; +/** + * @example + * { + * domain: "string", + * customDomains: ["string"], + * authConfig: { + * type: "public" + * }, + * orgId: "string", + * apiId: "string", + * filepaths: ["string"], + * images: [{ + * filePath: "string", + * width: 1.1, + * height: 1.1, + * blurDataUrl: "string", + * alt: "string" + * }] + * } + */ export interface StartDocsRegisterRequestV2 { /** A `buildwithfern.com` url */ domain: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/index.ts index baadc61593..0c206a1f83 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/requests/index.ts @@ -1,3 +1,3 @@ -export { StartDocsRegisterRequestV2 } from "./StartDocsRegisterRequestV2"; -export { StartDocsPreviewRegisterRequestV2 } from "./StartDocsPreviewRegisterRequestV2"; -export { RegisterDocsRequest } from "./RegisterDocsRequest"; +export { type StartDocsRegisterRequestV2 } from "./StartDocsRegisterRequestV2"; +export { type StartDocsPreviewRegisterRequestV2 } from "./StartDocsPreviewRegisterRequestV2"; +export { type RegisterDocsRequest } from "./RegisterDocsRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsPreviewRegister.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsPreviewRegister.ts index a76f19a065..992b628207 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsPreviewRegister.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsPreviewRegister.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsRegister.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsRegister.ts index 0eeaee767e..3ddd6d39ec 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsRegister.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/client/startDocsRegister.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; import * as core from "../../../../../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/AuthConfig.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/AuthConfig.ts index e4ff57982b..ae9e135b3c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/AuthConfig.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/AuthConfig.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export type AuthConfig = FernRegistry.docs.v2.write.AuthConfig.Public | FernRegistry.docs.v2.write.AuthConfig.Private; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/ImageFilePath.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/ImageFilePath.ts index a562718101..3e91fd7e83 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/ImageFilePath.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/ImageFilePath.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface ImageFilePath { filePath: FernRegistry.docs.v1.write.FilePath; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/InvliadCustomDomainErrorBody.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/InvliadCustomDomainErrorBody.ts index e6aa7d09ef..43a4bc116d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/InvliadCustomDomainErrorBody.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/InvliadCustomDomainErrorBody.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface InvliadCustomDomainErrorBody { overlappingDomains: FernRegistry.docs.v2.write.OverlappingCustomDomains[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/StartDocsPreviewRegisterResponse.ts b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/StartDocsPreviewRegisterResponse.ts index 8d38c9850a..ddd25c8be8 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/StartDocsPreviewRegisterResponse.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docs/resources/v2/resources/write/types/StartDocsPreviewRegisterResponse.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../../../../.."; +import * as FernRegistry from "../../../../../../../index"; export interface StartDocsPreviewRegisterResponse extends FernRegistry.docs.v1.write.StartDocsRegisterResponse { previewUrl: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/Client.ts index 24a42b538f..4100c734ec 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../environments"; import * as core from "../../../../core"; -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import urlJoin from "url-join"; export declare namespace DocsCache { @@ -16,19 +16,29 @@ export declare namespace DocsCache { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } export class DocsCache { constructor(protected readonly _options: DocsCache.Options = {}) {} + /** + * @param {FernRegistry.InvalidateCachedDocsRequest} request + * @param {DocsCache.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.docsCache.invalidate({ + * url: "string" + * }) + */ public async invalidate( request: FernRegistry.InvalidateCachedDocsRequest, requestOptions?: DocsCache.RequestOptions ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/docs-cache/invalidate" ), method: "POST", @@ -42,6 +52,7 @@ export class DocsCache { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -56,7 +67,7 @@ export class DocsCache { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/invalidate.ts b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/invalidate.ts index 2c6789fd55..714abe6fec 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/invalidate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/invalidate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = FernRegistry.docsCache.invalidate.Error._Unknown; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/InvalidateCachedDocsRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/InvalidateCachedDocsRequest.ts index b916a9ac01..f95b9d57da 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/InvalidateCachedDocsRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/InvalidateCachedDocsRequest.ts @@ -2,6 +2,12 @@ * This file was auto-generated by Fern from our API Definition. */ +/** + * @example + * { + * url: "string" + * } + */ export interface InvalidateCachedDocsRequest { url: string; } diff --git a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/index.ts index 2860c062b0..a6f055150a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/docsCache/client/requests/index.ts @@ -1 +1 @@ -export { InvalidateCachedDocsRequest } from "./InvalidateCachedDocsRequest"; +export { type InvalidateCachedDocsRequest } from "./InvalidateCachedDocsRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/Client.ts index 790a7f9fa3..b67461f6ca 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../environments"; import * as core from "../../../../core"; -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import urlJoin from "url-join"; export declare namespace Snippets { @@ -16,6 +16,7 @@ export declare namespace Snippets { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } @@ -25,6 +26,9 @@ export class Snippets { /** * Get snippet by endpoint method and path * + * @param {FernRegistry.GetSnippetRequest} request + * @param {Snippets.RequestOptions} requestOptions - Request-specific configuration. + * * @example * await fernRegistry.snippets.get({ * endpoint: { @@ -39,7 +43,7 @@ export class Snippets { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/snippets" ), method: "POST", @@ -53,6 +57,7 @@ export class Snippets { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -85,6 +90,21 @@ export class Snippets { }; } + /** + * @param {FernRegistry.ListSnippetsRequest} request + * @param {Snippets.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.snippets.load({ + * page: 1, + * orgId: "vellum", + * apiId: "vellum-ai", + * sdks: [{ + * type: "python", + * package: "vellum-ai" + * }] + * }) + */ public async load( request: FernRegistry.ListSnippetsRequest = {}, requestOptions?: Snippets.RequestOptions @@ -97,7 +117,7 @@ export class Snippets { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/snippets/load" ), method: "POST", @@ -112,6 +132,7 @@ export class Snippets { body: _body, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -144,7 +165,7 @@ export class Snippets { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/get.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/get.ts index 67fb3cb540..2a28ce111c 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/get.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/get.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/load.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/load.ts index 5a1b366837..ea34cea929 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/load.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/load.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/GetSnippetRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/GetSnippetRequest.ts index 0005a53ab5..2ea4b2d410 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/GetSnippetRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/GetSnippetRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; /** * @example diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/ListSnippetsRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/ListSnippetsRequest.ts index 716ed5646e..b7048aa5d5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/ListSnippetsRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/ListSnippetsRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; /** * @example diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/index.ts index ce1613f478..3cfeb7d269 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/client/requests/index.ts @@ -1,2 +1,2 @@ -export { GetSnippetRequest } from "./GetSnippetRequest"; -export { ListSnippetsRequest } from "./ListSnippetsRequest"; +export { type GetSnippetRequest } from "./GetSnippetRequest"; +export { type ListSnippetsRequest } from "./ListSnippetsRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/CustomSnippetPayload.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/CustomSnippetPayload.ts index bba40647ab..4825f2f416 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/CustomSnippetPayload.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/CustomSnippetPayload.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface CustomSnippetPayload { headers?: FernRegistry.ParameterPayload[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/GoSnippet.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/GoSnippet.ts index 01ac2913f3..0e8f6e00d5 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/GoSnippet.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/GoSnippet.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface GoSnippet { sdk: FernRegistry.GoSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/JavaSnippet.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/JavaSnippet.ts index 0c176187a6..60f142d93f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/JavaSnippet.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/JavaSnippet.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface JavaSnippet { sdk: FernRegistry.JavaSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/PythonSnippet.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/PythonSnippet.ts index e0fe6ed480..c55f76a61d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/PythonSnippet.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/PythonSnippet.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface PythonSnippet { sdk: FernRegistry.PythonSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/RubySnippet.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/RubySnippet.ts index 4b1ff7990a..ccc9cd45ea 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/RubySnippet.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/RubySnippet.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface RubySnippet { sdk: FernRegistry.RubySdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Sdk.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Sdk.ts index a7d26e2ff1..114f620994 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Sdk.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Sdk.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type Sdk = | FernRegistry.Sdk.Typescript diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SdkRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SdkRequest.ts index c2e23211ec..86ad2c42b0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SdkRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SdkRequest.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type SdkRequest = | FernRegistry.SdkRequest.Typescript diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Snippet.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Snippet.ts index 27245f6c0a..0acac9e964 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Snippet.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/Snippet.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type Snippet = | FernRegistry.Snippet.Typescript diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsByEndpointMethod.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsByEndpointMethod.ts index 126a0608d3..63ee57d700 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsByEndpointMethod.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsByEndpointMethod.ts @@ -2,6 +2,6 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type SnippetsByEndpointMethod = Record; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsPage.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsPage.ts index a463f45e6c..4776971712 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsPage.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/SnippetsPage.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SnippetsPage { /** If present, pass this into the `page` query parameter to load the next page. */ diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/TypeScriptSnippet.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/TypeScriptSnippet.ts index a795fdaf25..ba961ff591 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/TypeScriptSnippet.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippets/types/TypeScriptSnippet.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface TypeScriptSnippet { sdk: FernRegistry.TypeScriptSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/Client.ts index 1c23bba8c6..936d4b73e3 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../environments"; import * as core from "../../../../core"; -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import urlJoin from "url-join"; export declare namespace SnippetsFactory { @@ -16,6 +16,7 @@ export declare namespace SnippetsFactory { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } @@ -24,6 +25,20 @@ export class SnippetsFactory { /** * Store endpoint snippets for a particular SDK. + * + * @param {FernRegistry.CreateSnippetRequest} request + * @param {SnippetsFactory.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.snippetsFactory.createSnippetsForSdk({ + * orgId: "string", + * apiId: "string", + * snippets: { + * type: "typescript", + * sdk: {}, + * snippets: [{}] + * } + * }) */ public async createSnippetsForSdk( request: FernRegistry.CreateSnippetRequest, @@ -31,7 +46,7 @@ export class SnippetsFactory { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/snippets/create" ), method: "POST", @@ -45,6 +60,7 @@ export class SnippetsFactory { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -72,7 +88,7 @@ export class SnippetsFactory { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/createSnippetsForSdk.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/createSnippetsForSdk.ts index 5721464899..59b01d54f2 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/createSnippetsForSdk.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/createSnippetsForSdk.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/CreateSnippetRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/CreateSnippetRequest.ts index 7b5a950fe3..1542a054ab 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/CreateSnippetRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/CreateSnippetRequest.ts @@ -2,8 +2,20 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; +/** + * @example + * { + * orgId: "string", + * apiId: "string", + * snippets: { + * type: "typescript", + * sdk: {}, + * snippets: [{}] + * } + * } + */ export interface CreateSnippetRequest { /** * The organization to create snippets for. diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/index.ts index 8bdc4747e9..1ca7b4cec4 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/client/requests/index.ts @@ -1 +1 @@ -export { CreateSnippetRequest } from "./CreateSnippetRequest"; +export { type CreateSnippetRequest } from "./CreateSnippetRequest"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/BaseSnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/BaseSnippetCreate.ts index 08bbe4f20f..8897e44407 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/BaseSnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/BaseSnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface BaseSnippetCreate { endpoint: FernRegistry.EndpointIdentifier; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/GoSdkSnippetsCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/GoSdkSnippetsCreate.ts index 2bb36d1b93..34e6bfdc83 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/GoSdkSnippetsCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/GoSdkSnippetsCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface GoSdkSnippetsCreate { sdk: FernRegistry.GoSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/JavaSdkSnippetsCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/JavaSdkSnippetsCreate.ts index 7f327245e0..e2ba0f39fb 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/JavaSdkSnippetsCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/JavaSdkSnippetsCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface JavaSdkSnippetsCreate { sdk: FernRegistry.JavaSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/PythonSdkSnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/PythonSdkSnippetCreate.ts index bc2d913b3c..ec5970a08f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/PythonSdkSnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/PythonSdkSnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface PythonSdkSnippetCreate { sdk: FernRegistry.PythonSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/RubySdkSnippetsCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/RubySdkSnippetsCreate.ts index 0012872d25..1d2f90c15f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/RubySdkSnippetsCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/RubySdkSnippetsCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface RubySdkSnippetsCreate { sdk: FernRegistry.RubySdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SdkSnippetsCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SdkSnippetsCreate.ts index 161961bb7d..2a37149240 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SdkSnippetsCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SdkSnippetsCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type SdkSnippetsCreate = | FernRegistry.SdkSnippetsCreate.Typescript diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleGoSnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleGoSnippetCreate.ts index 9f6c8bbb93..e39f2dcb59 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleGoSnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleGoSnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SingleGoSnippetCreate extends FernRegistry.BaseSnippetCreate { snippet: FernRegistry.GoSnippetCode; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleJavaSnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleJavaSnippetCreate.ts index f708c9c1da..c552d3f92b 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleJavaSnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleJavaSnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SingleJavaSnippetCreate extends FernRegistry.BaseSnippetCreate { snippet: FernRegistry.JavaSnippetCode; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SinglePythonSnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SinglePythonSnippetCreate.ts index 1471c098cf..e7bc4f396f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SinglePythonSnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SinglePythonSnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SinglePythonSnippetCreate extends FernRegistry.BaseSnippetCreate { snippet: FernRegistry.PythonSnippetCode; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleRubySnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleRubySnippetCreate.ts index 46c263fa24..7d37d4a551 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleRubySnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleRubySnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SingleRubySnippetCreate extends FernRegistry.BaseSnippetCreate { snippet: FernRegistry.RubySnippetCode; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleTypescriptSnippetCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleTypescriptSnippetCreate.ts index f40db22235..2c37df48ac 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleTypescriptSnippetCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/SingleTypescriptSnippetCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SingleTypescriptSnippetCreate extends FernRegistry.BaseSnippetCreate { snippet: FernRegistry.TypeScriptSnippetCode; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/TypescriptSdkSnippetsCreate.ts b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/TypescriptSdkSnippetsCreate.ts index 49045025a1..3dcdee9eb0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/TypescriptSdkSnippetsCreate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/snippetsFactory/types/TypescriptSdkSnippetsCreate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface TypescriptSdkSnippetsCreate { sdk: FernRegistry.TypeScriptSdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/Client.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/Client.ts index 045e580fc9..38d206f7d6 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/Client.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/Client.ts @@ -4,7 +4,7 @@ import * as environments from "../../../../environments"; import * as core from "../../../../core"; -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import urlJoin from "url-join"; export declare namespace Templates { @@ -16,6 +16,7 @@ export declare namespace Templates { interface RequestOptions { timeoutInSeconds?: number; maxRetries?: number; + abortSignal?: AbortSignal; } } @@ -24,6 +25,64 @@ export class Templates { /** * Store endpoint snippet for a particular SDK. + * + * @param {FernRegistry.RegisterSnippetTemplateRequest} request + * @param {Templates.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.templates.register({ + * orgId: "string", + * apiId: "string", + * apiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", + * snippet: { + * sdk: { + * type: "typescript", + * package: "string", + * version: "string" + * }, + * endpointId: { + * path: "string", + * method: FernRegistry.EndpointMethod.Put, + * identifierOverride: "string" + * }, + * snippetTemplate: { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * }, + * additionalTemplates: { + * "string": { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * } + * } + * } + * }) */ public async register( request: FernRegistry.RegisterSnippetTemplateRequest, @@ -31,7 +90,7 @@ export class Templates { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/snippet-template/register" ), method: "POST", @@ -45,6 +104,7 @@ export class Templates { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -61,6 +121,64 @@ export class Templates { /** * Store endpoint snippets for a particular SDK. + * + * @param {FernRegistry.RegisterSnippetTemplateBatchRequest} request + * @param {Templates.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.templates.registerBatch({ + * orgId: "string", + * apiId: "string", + * apiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", + * snippets: [{ + * sdk: { + * type: "typescript", + * package: "string", + * version: "string" + * }, + * endpointId: { + * path: "string", + * method: FernRegistry.EndpointMethod.Put, + * identifierOverride: "string" + * }, + * snippetTemplate: { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * }, + * additionalTemplates: { + * "string": { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * } + * } + * }] + * }) */ public async registerBatch( request: FernRegistry.RegisterSnippetTemplateBatchRequest, @@ -68,7 +186,7 @@ export class Templates { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/snippet-template/register/batch" ), method: "POST", @@ -82,6 +200,7 @@ export class Templates { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -98,6 +217,25 @@ export class Templates { /** * Get the endpoint's snippet template for a particular SDK. + * + * @param {FernRegistry.GetSnippetTemplate} request + * @param {Templates.RequestOptions} requestOptions - Request-specific configuration. + * + * @example + * await fernRegistry.templates.get({ + * orgId: "string", + * apiId: "string", + * sdk: { + * type: "typescript", + * package: "string", + * version: "string" + * }, + * endpointId: { + * path: "string", + * method: FernRegistry.EndpointMethod.Put, + * identifierOverride: "string" + * } + * }) */ public async get( request: FernRegistry.GetSnippetTemplate, @@ -105,7 +243,7 @@ export class Templates { ): Promise> { const _response = await core.fetcher({ url: urlJoin( - (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Dev, + (await core.Supplier.get(this._options.environment)) ?? environments.FernRegistryEnvironment.Prod, "/snippet-template/get" ), method: "POST", @@ -119,6 +257,7 @@ export class Templates { body: request, timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : undefined, maxRetries: requestOptions?.maxRetries, + abortSignal: requestOptions?.abortSignal, }); if (_response.ok) { return { @@ -144,7 +283,7 @@ export class Templates { }; } - protected async _getAuthorizationHeader() { + protected async _getAuthorizationHeader(): Promise { const bearer = await core.Supplier.get(this._options.token); if (bearer != null) { return `Bearer ${bearer}`; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/get.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/get.ts index 24aaec7d13..5b3cbc10ec 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/get.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/get.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/register.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/register.ts index c6bd334cb9..08560a061f 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/register.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/register.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = FernRegistry.templates.register.Error._Unknown; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/registerBatch.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/registerBatch.ts index 446dbc6c4f..83b6911786 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/registerBatch.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/registerBatch.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; import * as core from "../../../../core"; export type Error = FernRegistry.templates.registerBatch.Error._Unknown; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/GetSnippetTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/GetSnippetTemplate.ts index c9586cf595..af60d0506a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/GetSnippetTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/GetSnippetTemplate.ts @@ -2,8 +2,25 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; +/** + * @example + * { + * orgId: "string", + * apiId: "string", + * sdk: { + * type: "typescript", + * package: "string", + * version: "string" + * }, + * endpointId: { + * path: "string", + * method: FernRegistry.EndpointMethod.Put, + * identifierOverride: "string" + * } + * } + */ export interface GetSnippetTemplate { /** * The organization to create snippets for. diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateBatchRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateBatchRequest.ts index a226f3ed3d..956a9050ef 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateBatchRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateBatchRequest.ts @@ -2,8 +2,64 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; +/** + * @example + * { + * orgId: "string", + * apiId: "string", + * apiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", + * snippets: [{ + * sdk: { + * type: "typescript", + * package: "string", + * version: "string" + * }, + * endpointId: { + * path: "string", + * method: FernRegistry.EndpointMethod.Put, + * identifierOverride: "string" + * }, + * snippetTemplate: { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * }, + * additionalTemplates: { + * "string": { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * } + * } + * }] + * } + */ export interface RegisterSnippetTemplateBatchRequest { /** * The organization to create snippets for. diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateRequest.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateRequest.ts index e78cfbe405..b6446b6130 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateRequest.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/RegisterSnippetTemplateRequest.ts @@ -2,8 +2,64 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../../.."; +import * as FernRegistry from "../../../../index"; +/** + * @example + * { + * orgId: "string", + * apiId: "string", + * apiDefinitionId: "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", + * snippet: { + * sdk: { + * type: "typescript", + * package: "string", + * version: "string" + * }, + * endpointId: { + * path: "string", + * method: FernRegistry.EndpointMethod.Put, + * identifierOverride: "string" + * }, + * snippetTemplate: { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * }, + * additionalTemplates: { + * "string": { + * type: "v1", + * clientInstantiation: "string", + * functionInvocation: { + * type: "generic", + * imports: ["string"], + * isOptional: true, + * templateString: "string", + * templateInputs: [{ + * type: "template", + * value: { + * "key": "value" + * } + * }], + * inputDelimiter: "string" + * } + * } + * } + * } + * } + */ export interface RegisterSnippetTemplateRequest { /** * The organization to create snippets for. diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/index.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/index.ts index e2c41e3a29..b9f6182ac7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/index.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/client/requests/index.ts @@ -1,3 +1,3 @@ -export { RegisterSnippetTemplateRequest } from "./RegisterSnippetTemplateRequest"; -export { RegisterSnippetTemplateBatchRequest } from "./RegisterSnippetTemplateBatchRequest"; -export { GetSnippetTemplate } from "./GetSnippetTemplate"; +export { type RegisterSnippetTemplateRequest } from "./RegisterSnippetTemplateRequest"; +export { type RegisterSnippetTemplateBatchRequest } from "./RegisterSnippetTemplateBatchRequest"; +export { type GetSnippetTemplate } from "./GetSnippetTemplate"; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DictTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DictTemplate.ts index 8dc2bd7810..dea9a48f15 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DictTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DictTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface DictTemplate { imports?: string[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DiscriminatedUnionTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DiscriminatedUnionTemplate.ts index 8e8b621f8b..e46b2cc81a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DiscriminatedUnionTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/DiscriminatedUnionTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface DiscriminatedUnionTemplate { imports?: string[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EndpointSnippetTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EndpointSnippetTemplate.ts index b00ff40339..1bd981ef10 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EndpointSnippetTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EndpointSnippetTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface EndpointSnippetTemplate { sdk: FernRegistry.Sdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EnumTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EnumTemplate.ts index a65d1756d4..d118478b3e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EnumTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/EnumTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface EnumTemplate { imports?: string[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/GenericTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/GenericTemplate.ts index cc98b4955d..cc2f491bf7 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/GenericTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/GenericTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface GenericTemplate { imports?: string[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/IterableTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/IterableTemplate.ts index 96d155fbae..f1d3b635e0 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/IterableTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/IterableTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface IterableTemplate { imports?: string[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/PayloadInput.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/PayloadInput.ts index 242656a60d..6898afa324 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/PayloadInput.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/PayloadInput.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface PayloadInput { location: FernRegistry.PayloadLocation; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetRegistryEntry.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetRegistryEntry.ts index 129575b835..98381a7b41 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetRegistryEntry.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetRegistryEntry.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SnippetRegistryEntry { sdk: FernRegistry.Sdk; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetTemplate.ts index 72deb3732b..32aa702a5a 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/SnippetTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface SnippetTemplate { clientInstantiation: string; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/Template.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/Template.ts index 43147a9698..577e7c895d 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/Template.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/Template.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type Template = | FernRegistry.Template.Generic diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/TemplateInput.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/TemplateInput.ts index 6d646749b1..f4608006bc 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/TemplateInput.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/TemplateInput.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type TemplateInput = FernRegistry.TemplateInput.Template | FernRegistry.TemplateInput.Payload; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/UnionTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/UnionTemplate.ts index c244dc594f..b3f32bd9bf 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/UnionTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/UnionTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export interface UnionTemplate { imports?: string[]; diff --git a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/VersionedSnippetTemplate.ts b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/VersionedSnippetTemplate.ts index 2c1cb83db5..2fb882795e 100644 --- a/packages/fdr-sdk/src/client/generated/api/resources/templates/types/VersionedSnippetTemplate.ts +++ b/packages/fdr-sdk/src/client/generated/api/resources/templates/types/VersionedSnippetTemplate.ts @@ -2,7 +2,7 @@ * This file was auto-generated by Fern from our API Definition. */ -import * as FernRegistry from "../../.."; +import * as FernRegistry from "../../../index"; export type VersionedSnippetTemplate = FernRegistry.VersionedSnippetTemplate.V1; diff --git a/packages/fdr-sdk/src/client/generated/core/fetcher/Fetcher.ts b/packages/fdr-sdk/src/client/generated/core/fetcher/Fetcher.ts index 6ea728e856..7f81c5fee1 100644 --- a/packages/fdr-sdk/src/client/generated/core/fetcher/Fetcher.ts +++ b/packages/fdr-sdk/src/client/generated/core/fetcher/Fetcher.ts @@ -1,5 +1,5 @@ -import { default as FormData } from "form-data"; import qs from "qs"; +import { RUNTIME } from "../runtime"; import { APIResponse } from "./APIResponse"; export type FetchFunction = (args: Fetcher.Args) => Promise>; @@ -15,7 +15,8 @@ export declare namespace Fetcher { timeoutMs?: number; maxRetries?: number; withCredentials?: boolean; - responseType?: "json" | "blob" | "streaming"; + abortSignal?: AbortSignal; + responseType?: "json" | "blob" | "streaming" | "text"; } export type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError; @@ -66,34 +67,71 @@ async function fetcherImpl(args: Fetcher.Args): Promise { + if (body instanceof Uint8Array) { + return body; + } else if (args.contentType === "application/x-www-form-urlencoded" && typeof args.body === "string") { + return args.body; + } else { + return JSON.stringify(body); + } + }; + + if (RUNTIME.type === "node") { + if (args.body instanceof (await import("formdata-node")).FormData) { + body = args.body; + } else { + body = maybeStringifyBody(args.body); + } } else { - body = JSON.stringify(args.body); + if (args.body instanceof (await import("form-data")).default) { + // @ts-expect-error + body = args.body; + } else { + body = maybeStringifyBody(args.body); + } } - // This is overridden now. - const fetchFn = fetch; + // In Node.js environments, the SDK always uses`node-fetch`. + // If not in Node.js the SDK uses global fetch if available, + // and falls back to node-fetch. + const fetchFn = + RUNTIME.type === "node" + ? // `.default` is required due to this issue: + // https://github.com/node-fetch/node-fetch/issues/450#issuecomment-387045223 + ((await import("node-fetch")).default as any) + : typeof fetch == "function" + ? fetch + : ((await import("node-fetch")).default as any); const makeRequest = async (): Promise => { - const controller = new AbortController(); - let abortId = undefined; + const signals: AbortSignal[] = []; + + // Add timeout signal + let timeoutAbortId: NodeJS.Timeout | undefined = undefined; if (args.timeoutMs != null) { - abortId = setTimeout(() => controller.abort(), args.timeoutMs); + const { signal, abortId } = getTimeoutSignal(args.timeoutMs); + timeoutAbortId = abortId; + signals.push(signal); } + + // Add arbitrary signal + if (args.abortSignal != null) { + signals.push(args.abortSignal); + } + const response = await fetchFn(url, { method: args.method, headers, body, - signal: controller.signal, + signal: anySignal(signals), credentials: args.withCredentials ? "include" : undefined, }); - if (abortId != null) { - clearTimeout(abortId); + + if (timeoutAbortId != null) { + clearTimeout(timeoutAbortId); } + return response; }; @@ -120,6 +158,8 @@ async function fetcherImpl(args: Fetcher.Args): Promise 0) { @@ -155,7 +195,15 @@ async function fetcherImpl(args: Fetcher.Args): Promise(args: Fetcher.Args): Promise controller.abort(TIMEOUT), timeoutMs); + return { signal: controller.signal, abortId }; +} + +/** + * Returns an abort signal that is getting aborted when + * at least one of the specified abort signals is aborted. + * + * Requires at least node.js 18. + */ +function anySignal(...args: AbortSignal[] | [AbortSignal[]]): AbortSignal { + // Allowing signals to be passed either as array + // of signals or as multiple arguments. + const signals = (args.length === 1 && Array.isArray(args[0]) ? args[0] : args); + + const controller = new AbortController(); + + for (const signal of signals) { + if (signal.aborted) { + // Exiting early if one of the signals + // is already aborted. + controller.abort((signal as any)?.reason); + break; + } + + // Listening for signals and removing the listeners + // when at least one symbol is aborted. + signal.addEventListener("abort", () => controller.abort((signal as any)?.reason), { + signal: controller.signal, + }); + } + + return controller.signal; +} + export const fetcher: FetchFunction = fetcherImpl; diff --git a/packages/fdr-sdk/src/client/generated/environments.ts b/packages/fdr-sdk/src/client/generated/environments.ts index addd2f3a5c..d287aedeaa 100644 --- a/packages/fdr-sdk/src/client/generated/environments.ts +++ b/packages/fdr-sdk/src/client/generated/environments.ts @@ -3,8 +3,7 @@ */ export const FernRegistryEnvironment = { - Dev: "https://registry-dev2.buildwithfern.com", Prod: "https://registry.buildwithfern.com", } as const; -export type FernRegistryEnvironment = typeof FernRegistryEnvironment.Dev | typeof FernRegistryEnvironment.Prod; +export type FernRegistryEnvironment = typeof FernRegistryEnvironment.Prod; diff --git a/packages/fdr-sdk/src/client/index.ts b/packages/fdr-sdk/src/client/index.ts index cf1d9828a5..81f10e527c 100644 --- a/packages/fdr-sdk/src/client/index.ts +++ b/packages/fdr-sdk/src/client/index.ts @@ -7,6 +7,8 @@ export * as APIV1Read from "./generated/api/resources/api/resources/v1/resources export * as APIV1Write from "./generated/api/resources/api/resources/v1/resources/register"; export * as DocsV2Read from "./generated/api/resources/docs/resources/v2/resources/read"; export * as DocsV2Write from "./generated/api/resources/docs/resources/v2/resources/write"; +export * as Snippets from "./generated/api/resources/snippets/types"; +export * from "./generated/core/fetcher/APIResponse"; export { visitDbNavigationConfig, visitUnversionedDbNavigationConfig } from "./visitDbNavigationConfig"; export { visitDbNavigationTab, visitWriteNavigationTab } from "./visitNavigationTab"; export { visitReadNavigationConfig, visitUnversionedReadNavigationConfig } from "./visitReadNavigationConfig"; diff --git a/packages/fdr-sdk/src/converters/db/convertAPIDefinitionToDb.ts b/packages/fdr-sdk/src/converters/db/convertAPIDefinitionToDb.ts index d5889cb145..05a9e16210 100644 --- a/packages/fdr-sdk/src/converters/db/convertAPIDefinitionToDb.ts +++ b/packages/fdr-sdk/src/converters/db/convertAPIDefinitionToDb.ts @@ -1,6 +1,6 @@ -import { kebabCase, titleCase } from "@fern-ui/core-utils"; import isEqual from "fast-deep-equal"; import { APIV1Db, APIV1Read, APIV1Write, FdrAPI } from "../../client"; +import { kebabCase, titleCase } from "../../utils"; import { WithoutQuestionMarks } from "../utils/WithoutQuestionMarks"; import { assertNever } from "../utils/assertNever"; import { diff --git a/packages/fdr-sdk/src/converters/db/convertDocsDefinitionToDb.ts b/packages/fdr-sdk/src/converters/db/convertDocsDefinitionToDb.ts index c763fcd825..8e7a5b577c 100644 --- a/packages/fdr-sdk/src/converters/db/convertDocsDefinitionToDb.ts +++ b/packages/fdr-sdk/src/converters/db/convertDocsDefinitionToDb.ts @@ -1,4 +1,3 @@ -import { kebabCase } from "@fern-ui/core-utils"; import { DocsV1Db, DocsV1Read, @@ -10,6 +9,7 @@ import { visitWriteNavigationConfig, } from "../../client"; import { isNavigationTabLink } from "../../client/visitNavigationTab"; +import { kebabCase } from "../../utils"; import { type WithoutQuestionMarks } from "../utils/WithoutQuestionMarks"; import { assertNever } from "../utils/assertNever"; import { DEFAULT_DARK_MODE_ACCENT_PRIMARY, DEFAULT_LIGHT_MODE_ACCENT_PRIMARY } from "../utils/colors"; diff --git a/packages/fdr-sdk/src/converters/db/snippets/SDKSnippetHolder.ts b/packages/fdr-sdk/src/converters/db/snippets/SDKSnippetHolder.ts index 6ef6d5075c..0b1df024e3 100644 --- a/packages/fdr-sdk/src/converters/db/snippets/SDKSnippetHolder.ts +++ b/packages/fdr-sdk/src/converters/db/snippets/SDKSnippetHolder.ts @@ -183,7 +183,7 @@ export class SDKSnippetHolder { return exampleId != null && snippet.exampleIdentifier === exampleId; }); // if no example match, just pick first snippet for backwards-compatibility reasons - if (snippets.length === 0) { + if (snippets.length === 0 && snippetsForEndpoint[0] != null) { snippets = [snippetsForEndpoint[0]]; } diff --git a/packages/fdr-sdk/src/converters/db/upgrade/migrateDocsDbDefinition.ts b/packages/fdr-sdk/src/converters/db/upgrade/migrateDocsDbDefinition.ts index 1129035007..0e5dac153d 100644 --- a/packages/fdr-sdk/src/converters/db/upgrade/migrateDocsDbDefinition.ts +++ b/packages/fdr-sdk/src/converters/db/upgrade/migrateDocsDbDefinition.ts @@ -1,5 +1,5 @@ -import { isPlainObject } from "@fern-ui/core-utils"; import { DocsV1Db } from "../../../client"; +import { isPlainObject } from "../../../utils"; import { upgradeV1ToV2 } from "./upgradeV1ToV2"; import { upgradeV2ToV3 } from "./upgradeV2ToV3"; diff --git a/packages/fdr-sdk/src/converters/db/upgrade/upgradeV2ToV3.ts b/packages/fdr-sdk/src/converters/db/upgrade/upgradeV2ToV3.ts index 3b81280e85..3aa8d1a736 100644 --- a/packages/fdr-sdk/src/converters/db/upgrade/upgradeV2ToV3.ts +++ b/packages/fdr-sdk/src/converters/db/upgrade/upgradeV2ToV3.ts @@ -1,5 +1,5 @@ -import { mapValues } from "@fern-ui/core-utils"; import { DocsV1Db } from "../../../client"; +import { mapValues } from "../../../utils"; export function upgradeV2ToV3(v2: DocsV1Db.DocsDefinitionDb.V2): DocsV1Db.DocsDefinitionDb.V3 { return { diff --git a/packages/fdr-sdk/src/converters/read/convertDbDocsConfigToRead.ts b/packages/fdr-sdk/src/converters/read/convertDbDocsConfigToRead.ts index d7eecfbedd..78eb4f10b7 100644 --- a/packages/fdr-sdk/src/converters/read/convertDbDocsConfigToRead.ts +++ b/packages/fdr-sdk/src/converters/read/convertDbDocsConfigToRead.ts @@ -1,7 +1,7 @@ -import { kebabCase } from "@fern-ui/core-utils"; import tinycolor from "tinycolor2"; import { DocsV1Db, DocsV1Read, visitDbNavigationConfig, visitUnversionedDbNavigationConfig } from "../../client"; import { visitDbNavigationTab } from "../../client/visitNavigationTab"; +import { kebabCase } from "../../utils"; import { WithoutQuestionMarks } from "../utils/WithoutQuestionMarks"; import { assertNever } from "../utils/assertNever"; import { DEFAULT_DARK_MODE_ACCENT_PRIMARY, DEFAULT_LIGHT_MODE_ACCENT_PRIMARY } from "../utils/colors"; @@ -63,32 +63,32 @@ function transformTypographyToV2( }; } -function transformFontConfigV2ToV1(fontConfig: DocsV1Read.FontConfigV2 | undefined): DocsV1Read.FontConfig | undefined { - if (fontConfig == null) { - return undefined; - } - const firstVariant = fontConfig.variants[0]; - if (firstVariant == null) { - return undefined; - } - return { - name: fontConfig.name, - fontFile: firstVariant.fontFile, - }; -} +// function transformFontConfigV2ToV1(fontConfig: DocsV1Read.FontConfigV2 | undefined): DocsV1Read.FontConfig | undefined { +// if (fontConfig == null) { +// return undefined; +// } +// const firstVariant = fontConfig.variants[0]; +// if (firstVariant == null) { +// return undefined; +// } +// return { +// name: fontConfig.name, +// fontFile: firstVariant.fontFile, +// }; +// } -function transformTypographyV2ToV1( - typography: DocsV1Read.DocsTypographyConfigV2 | undefined, -): DocsV1Read.DocsTypographyConfig | undefined { - if (typography == null) { - return undefined; - } - return { - headingsFont: transformFontConfigV2ToV1(typography.headingsFont), - bodyFont: transformFontConfigV2ToV1(typography.bodyFont), - codeFont: transformFontConfigV2ToV1(typography.codeFont), - }; -} +// function transformTypographyV2ToV1( +// typography: DocsV1Read.DocsTypographyConfigV2 | undefined, +// ): DocsV1Read.DocsTypographyConfig | undefined { +// if (typography == null) { +// return undefined; +// } +// return { +// headingsFont: transformFontConfigV2ToV1(typography.headingsFont), +// bodyFont: transformFontConfigV2ToV1(typography.bodyFont), +// codeFont: transformFontConfigV2ToV1(typography.codeFont), +// }; +// } export function transformNavigationConfigToRead(dbShape: DocsV1Db.NavigationConfig): DocsV1Read.NavigationConfig { return visitDbNavigationConfig(dbShape, { diff --git a/packages/fdr-sdk/src/index.ts b/packages/fdr-sdk/src/index.ts index ce9d9409dc..1dd0b8d881 100644 --- a/packages/fdr-sdk/src/index.ts +++ b/packages/fdr-sdk/src/index.ts @@ -1,4 +1,3 @@ export * from "./client"; export * from "./converters"; export * as FernNavigation from "./navigation"; -export { NodeCollector } from "./navigation/NodeCollector"; diff --git a/packages/fdr-sdk/src/navigation/NodeCollector.ts b/packages/fdr-sdk/src/navigation/NodeCollector.ts index 4be19a739b..e8c56ddfdf 100644 --- a/packages/fdr-sdk/src/navigation/NodeCollector.ts +++ b/packages/fdr-sdk/src/navigation/NodeCollector.ts @@ -1,5 +1,5 @@ -import { once } from "@fern-ui/core-utils"; import urljoin from "url-join"; +import { once } from "../utils"; import { FernNavigation } from "./generated"; import { NavigationNode, diff --git a/packages/fdr-sdk/src/navigation/converters/ApiReferenceNavigationConverter.ts b/packages/fdr-sdk/src/navigation/converters/ApiReferenceNavigationConverter.ts index 051cb0aa02..10b21cc6f9 100644 --- a/packages/fdr-sdk/src/navigation/converters/ApiReferenceNavigationConverter.ts +++ b/packages/fdr-sdk/src/navigation/converters/ApiReferenceNavigationConverter.ts @@ -1,6 +1,6 @@ -import { noop, titleCase, visitDiscriminatedUnion } from "@fern-ui/core-utils"; import urljoin from "url-join"; import { APIV1Read, DocsV1Read } from "../../client"; +import { noop, titleCase, visitDiscriminatedUnion } from "../../utils"; import { ApiDefinitionHolder } from "../ApiDefinitionHolder"; import { FernNavigation } from "../generated"; import { followRedirects } from "../utils"; diff --git a/packages/fdr-sdk/src/navigation/converters/NavigationConfigConverter.ts b/packages/fdr-sdk/src/navigation/converters/NavigationConfigConverter.ts index 1fb5ef049d..39bcce046d 100644 --- a/packages/fdr-sdk/src/navigation/converters/NavigationConfigConverter.ts +++ b/packages/fdr-sdk/src/navigation/converters/NavigationConfigConverter.ts @@ -1,6 +1,6 @@ -import { assertNever, kebabCase, visitDiscriminatedUnion } from "@fern-ui/core-utils"; import urljoin from "url-join"; import { APIV1Read, DocsV1Read, visitReadNavigationConfig, visitUnversionedReadNavigationConfig } from "../../client"; +import { assertNever, kebabCase, visitDiscriminatedUnion } from "../../utils"; import { FernNavigation } from "../generated"; import { followRedirect, followRedirects } from "../utils"; import { convertAvailability } from "../utils/convertAvailability"; diff --git a/packages/fdr-sdk/src/navigation/index.ts b/packages/fdr-sdk/src/navigation/index.ts index dc6d97b7ca..050bb65876 100644 --- a/packages/fdr-sdk/src/navigation/index.ts +++ b/packages/fdr-sdk/src/navigation/index.ts @@ -1,12 +1,14 @@ +import { ApiDefinitionHolder } from "./ApiDefinitionHolder"; import { NavigationConfigConverter } from "./converters/NavigationConfigConverter"; import { NodeCollector } from "./NodeCollector"; const convert = NavigationConfigConverter.convert; const collectSlugs = NodeCollector.collect; +const createApiHolder = ApiDefinitionHolder.create; export * from "./ApiDefinitionHolder"; export { ApiReferenceNavigationConverter } from "./converters/ApiReferenceNavigationConverter"; export * from "./generated/api"; export * from "./types"; export * as utils from "./utils"; -export { collectSlugs, convert }; +export { ApiDefinitionHolder, collectSlugs, convert, createApiHolder, NavigationConfigConverter, NodeCollector }; diff --git a/packages/fdr-sdk/src/navigation/utils/convertAvailability.ts b/packages/fdr-sdk/src/navigation/utils/convertAvailability.ts index f774272873..2167be100e 100644 --- a/packages/fdr-sdk/src/navigation/utils/convertAvailability.ts +++ b/packages/fdr-sdk/src/navigation/utils/convertAvailability.ts @@ -1,5 +1,5 @@ -import { assertNever } from "@fern-ui/core-utils"; import { APIV1Read, DocsV1Read } from "../../client"; +import { assertNever } from "../../utils"; import { FernNavigation } from "../generated"; export function convertAvailability( diff --git a/packages/fdr-sdk/src/navigation/utils/convertLoadDocsForUrlResponse.ts b/packages/fdr-sdk/src/navigation/utils/convertLoadDocsForUrlResponse.ts index a6451d84e9..10bcca8baa 100644 --- a/packages/fdr-sdk/src/navigation/utils/convertLoadDocsForUrlResponse.ts +++ b/packages/fdr-sdk/src/navigation/utils/convertLoadDocsForUrlResponse.ts @@ -1,5 +1,5 @@ -import { mapValues } from "@fern-ui/core-utils"; import { APIV1Read, DocsV2Read } from "../../client"; +import { mapValues } from "../../utils"; import { NavigationConfigConverter } from "../converters/NavigationConfigConverter"; export function convertLoadDocsForUrlResponse(response: DocsV2Read.LoadDocsForUrlResponse) { diff --git a/packages/fdr-sdk/src/navigation/utils/findNode.ts b/packages/fdr-sdk/src/navigation/utils/findNode.ts index 26c06109bd..9455f1fe57 100644 --- a/packages/fdr-sdk/src/navigation/utils/findNode.ts +++ b/packages/fdr-sdk/src/navigation/utils/findNode.ts @@ -1,4 +1,4 @@ -import { noop, visitDiscriminatedUnion } from "@fern-ui/core-utils"; +import { noop, visitDiscriminatedUnion } from "../../utils"; import urljoin from "url-join"; import { NodeCollector } from "../NodeCollector"; diff --git a/packages/fdr-sdk/src/navigation/utils/followRedirect.ts b/packages/fdr-sdk/src/navigation/utils/followRedirect.ts index f36134e3d1..374a4a987d 100644 --- a/packages/fdr-sdk/src/navigation/utils/followRedirect.ts +++ b/packages/fdr-sdk/src/navigation/utils/followRedirect.ts @@ -1,4 +1,4 @@ -import { visitDiscriminatedUnion } from "@fern-ui/core-utils"; +import { visitDiscriminatedUnion } from "../../utils"; import { FernNavigation } from "../generated"; import { NavigationNode } from "../types/NavigationNode"; @@ -37,17 +37,11 @@ export function followRedirect(nodeToFollow: NavigationNode | undefined): FernNa } export function followRedirects(nodes: NavigationNode[]): FernNavigation.Slug | undefined { - let traversedFirst = false; for (const node of nodes) { - // if (traversedFirst) { - // // eslint-disable-next-line no-console - // console.error("First redirect path was not followed, this should not happen."); - // } const redirect = followRedirect(node); if (redirect != null) { return redirect; } - traversedFirst = true; } return; } diff --git a/packages/fdr-sdk/src/navigation/utils/getApiReferenceId.ts b/packages/fdr-sdk/src/navigation/utils/getApiReferenceId.ts index efa2a0d713..ea58c4274a 100644 --- a/packages/fdr-sdk/src/navigation/utils/getApiReferenceId.ts +++ b/packages/fdr-sdk/src/navigation/utils/getApiReferenceId.ts @@ -1,4 +1,4 @@ -import { visitDiscriminatedUnion } from "@fern-ui/core-utils"; +import { visitDiscriminatedUnion } from "../../utils"; import { FernNavigation } from "../generated"; import { NavigationNode } from "../types/NavigationNode"; diff --git a/packages/fdr-sdk/src/navigation/utils/getPageId.ts b/packages/fdr-sdk/src/navigation/utils/getPageId.ts index ef9de81f65..ecfabf190d 100644 --- a/packages/fdr-sdk/src/navigation/utils/getPageId.ts +++ b/packages/fdr-sdk/src/navigation/utils/getPageId.ts @@ -1,4 +1,4 @@ -import { visitDiscriminatedUnion } from "@fern-ui/core-utils"; +import { visitDiscriminatedUnion } from "../../utils"; import { FernNavigation } from "../generated"; import { NavigationNodePage } from "../types"; diff --git a/packages/fdr-sdk/src/navigation/utils/traverseNavigation.ts b/packages/fdr-sdk/src/navigation/utils/traverseNavigation.ts index 3419ddc670..f97fd750cd 100644 --- a/packages/fdr-sdk/src/navigation/utils/traverseNavigation.ts +++ b/packages/fdr-sdk/src/navigation/utils/traverseNavigation.ts @@ -1,9 +1,9 @@ -import { noop, visitDiscriminatedUnion } from "@fern-ui/core-utils"; +import { noop, visitDiscriminatedUnion } from "../../utils"; import { NavigationNode } from "../types/NavigationNode"; const SKIP = "skip" as const; -const CONTINUE = true as const; +// const CONTINUE = true as const; const STOP = false as const; export function traverseNavigation( diff --git a/packages/fdr-sdk/src/utils/assertNever.ts b/packages/fdr-sdk/src/utils/assertNever.ts new file mode 100644 index 0000000000..e96382acf1 --- /dev/null +++ b/packages/fdr-sdk/src/utils/assertNever.ts @@ -0,0 +1,6 @@ +export function assertNever(x: never): never { + throw new Error("Unexpected value: " + JSON.stringify(x)); +} + +// eslint-disable-next-line @typescript-eslint/no-empty-function +export function assertNeverNoThrow(_: never): void {} diff --git a/packages/fdr-sdk/src/utils/index.ts b/packages/fdr-sdk/src/utils/index.ts new file mode 100644 index 0000000000..b2a5f8b14a --- /dev/null +++ b/packages/fdr-sdk/src/utils/index.ts @@ -0,0 +1,5 @@ +export * from "./assertNever"; +export * from "./isPlainObject"; +export * from "./lodash"; +export * from "./titleCase"; +export * from "./visitDiscriminatedUnion"; diff --git a/packages/fdr-sdk/src/utils/isPlainObject.ts b/packages/fdr-sdk/src/utils/isPlainObject.ts new file mode 100644 index 0000000000..96272f18e1 --- /dev/null +++ b/packages/fdr-sdk/src/utils/isPlainObject.ts @@ -0,0 +1,18 @@ +// https://github.com/lodash/lodash/blob/master/isPlainObject.js +export function isPlainObject(value: unknown): value is Record { + if (!isObjectLike(value) || String(value) !== "[object Object]") { + return false; + } + if (Object.getPrototypeOf(value) == null) { + return true; + } + let proto = value; + while (Object.getPrototypeOf(proto) != null) { + proto = Object.getPrototypeOf(proto); + } + return Object.getPrototypeOf(value) === proto; +} + +function isObjectLike(value: unknown) { + return typeof value === "object" && value != null; +} diff --git a/packages/commons/core-utils/src/lodash/before.ts b/packages/fdr-sdk/src/utils/lodash/before.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/before.ts rename to packages/fdr-sdk/src/utils/lodash/before.ts diff --git a/packages/commons/core-utils/src/lodash/index.ts b/packages/fdr-sdk/src/utils/lodash/index.ts similarity index 85% rename from packages/commons/core-utils/src/lodash/index.ts rename to packages/fdr-sdk/src/utils/lodash/index.ts index c429874fb2..175d2e00bf 100644 --- a/packages/commons/core-utils/src/lodash/index.ts +++ b/packages/fdr-sdk/src/utils/lodash/index.ts @@ -1,3 +1,4 @@ export { default as kebabCase } from "./kebabCase"; export { default as mapValues } from "./mapValues"; +export * from "./noop"; export { default as once } from "./once"; diff --git a/packages/commons/core-utils/src/lodash/internal/getTag.ts b/packages/fdr-sdk/src/utils/lodash/internal/getTag.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/internal/getTag.ts rename to packages/fdr-sdk/src/utils/lodash/internal/getTag.ts diff --git a/packages/commons/core-utils/src/lodash/internal/unicodeWords.ts b/packages/fdr-sdk/src/utils/lodash/internal/unicodeWords.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/internal/unicodeWords.ts rename to packages/fdr-sdk/src/utils/lodash/internal/unicodeWords.ts diff --git a/packages/commons/core-utils/src/lodash/isSymbol.ts b/packages/fdr-sdk/src/utils/lodash/isSymbol.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/isSymbol.ts rename to packages/fdr-sdk/src/utils/lodash/isSymbol.ts diff --git a/packages/commons/core-utils/src/lodash/kebabCase.ts b/packages/fdr-sdk/src/utils/lodash/kebabCase.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/kebabCase.ts rename to packages/fdr-sdk/src/utils/lodash/kebabCase.ts diff --git a/packages/commons/core-utils/src/lodash/mapValues.ts b/packages/fdr-sdk/src/utils/lodash/mapValues.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/mapValues.ts rename to packages/fdr-sdk/src/utils/lodash/mapValues.ts diff --git a/packages/fdr-sdk/src/utils/lodash/noop.ts b/packages/fdr-sdk/src/utils/lodash/noop.ts new file mode 100644 index 0000000000..51cea12263 --- /dev/null +++ b/packages/fdr-sdk/src/utils/lodash/noop.ts @@ -0,0 +1,2 @@ +// eslint-disable-next-line @typescript-eslint/no-empty-function +export function noop(): void {} diff --git a/packages/commons/core-utils/src/lodash/once.ts b/packages/fdr-sdk/src/utils/lodash/once.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/once.ts rename to packages/fdr-sdk/src/utils/lodash/once.ts diff --git a/packages/commons/core-utils/src/lodash/toString.ts b/packages/fdr-sdk/src/utils/lodash/toString.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/toString.ts rename to packages/fdr-sdk/src/utils/lodash/toString.ts diff --git a/packages/commons/core-utils/src/lodash/words.ts b/packages/fdr-sdk/src/utils/lodash/words.ts similarity index 100% rename from packages/commons/core-utils/src/lodash/words.ts rename to packages/fdr-sdk/src/utils/lodash/words.ts diff --git a/packages/fdr-sdk/src/utils/specialTokens.ts b/packages/fdr-sdk/src/utils/specialTokens.ts new file mode 100644 index 0000000000..e5f69d47da --- /dev/null +++ b/packages/fdr-sdk/src/utils/specialTokens.ts @@ -0,0 +1,361 @@ +export const SPECIAL_TOKENS = [ + // privacy + "PII", + "PHI", + "PCI", + "GDPR", + "CCPA", + "HIPAA", + "COPPA", + "FERPA", + "GLBA", + "SOX", + "FISMA", + "NIST", + "CIS", + "ISO", + "IEC", + "ITAR", + "EAR", + "CMMC", + "CUI", + "CDI", + "FTC", + "FCC", + "SEC", + "FINRA", + + // security + "XSS", + "CSRF", + "SSRF", + "XSRF", + "TLS", + "SSL", + "SSH", + "API", + "OAuth", + "OAuth1", + "OAuth1.0", + "OAuth2", + "OAuth2.0", + "SAML", + "OpenID", + "OpenID Connect", + "CAPTCHA", + "reCAPTCHA", + "2FA", + "MFA", + "OTP", + "TOTP", + "HOTP", + "U2F", + "FIDO", + "FIDO2", + "PKI", + "HMAC", + "AES", + "RSA", + "SHA", + "MD5", + "BCrypt", + "PBKDF2", + "Argon2", + "SCrypt", + "JWT", + "JWE", + "JWS", + "JWK", + "JWA", + "JOSE", + + // shopping + "SKU", + "SKUs", + "UPC", + "EAN", + "ISBN", + "ASIN", + "MPN", + "MSRP", + "MAP", + "RRP", + "MSRP", + + // time + "AM", + "PM", + "UTC", + "GMT", + "PST", + "PDT", + "EST", + "EDT", + "CST", + "CDT", + "MST", + "MDT", + + // geography + "USA", + "UK", + "EU", + "UAE", + "APAC", + "EMEA", + "LATAM", + "ANZ", + "SEA", + "MEA", + "MENA", + "NATO", + "NA", + "SA", + "CA", + "EU", + "AU", + "NZ", + "JP", + "KR", + "CN", + "HK", + "TW", + "SG", + "MY", + "TH", + "ID", + "PH", + "VN", + "IN", + "PK", + "BD", + "LK", + "NP", + "MM", + "KH", + "LA", + "MM", + "BT", + "MV", + + // finance + "USD", + "EUR", + "GBP", + "JPY", + "CNY", + "RUB", + "INR", + "AUD", + "CAD", + "CHF", + "SGD", + "MYR", + "THB", + "IDR", + "KRW", + "PHP", + "VND", + "HKD", + "TWD", + "MXN", + "BRL", + "ARS", + "CLP", + "COP", + "PEN", + "ZAR", + "NGN", + "EGP", + "AED", + "SAR", + "ILS", + "TRY", + "SEK", + "NOK", + "DKK", + "ISK", + "HUF", + "PLN", + "CZK", + "RON", + "BGN", + + // programming + "API", + "APIs", + "SDK", + "SDKs", + "AI", + "OCR", + "REST", + "SOAP", + "JSON", + "XML", + "HTTP", + "HTTPS", + "URI", + "URL", + "CRUD", + "RESTful", + "KYB", + "KYC", + "AML", + "HTML", + "CSS", + "JS", + "SQL", + "DB", + "UI", + "UX", + "SaaS", + "PaaS", + "IaaS", + "IP", + "TCP", + "UDP", + "DNS", + "FTP", + "SMTP", + "IMAP", + "POP3", + "CSV", + "MVC", + "MVP", + "MVVM", + "DOM", + "SPA", + "SSR", + "CSR", + "DDoS", + "CDN", + "IoT", + "ML", + "DL", + "NLP", + "CLI", + "GUI", + "BI", + "ETL", + "RDBMS", + "NoSQL", + "IDE", + "CMS", + "CCPA", + "POSIX", + "ABI", + "API", + "AST", + "COBOL", + "DDL", + "DML", + + // AI-related + "NN", // Neural Network + "CNN", // Convolutional Neural Network + "RNN", // Recurrent Neural Network + "LSTM", // Long Short Term Memory + "GRU", // Gated Recurrent Unit + "ANN", // Artificial Neural Network + "GAN", // Generative Adversarial Network + "RL", // Reinforcement Learning + "DL", // Deep Learning + "ML", // Machine Learning + "NLP", // Natural Language Processing + "NLG", // Natural Language Generation + "NLU", // Natural Language Understanding + "BERT", // Bidirectional Encoder Representations from Transformers + "GPT", // Generative Pre-training Transformer + "SVM", // Support Vector Machine + "PCA", // Principal Component Analysis + "AI", // Artificial Intelligence + "CV", // Computer Vision + "TF", // TensorFlow + "TTS", // Text-to-Speech + "ASR", // Automatic Speech Recognition + "HMM", // Hidden Markov Model + "DNN", // Deep Neural Network + "MLP", // Multi-Layer Perceptron + "RBM", // Restricted Boltzmann Machine + "CRF", // Conditional Random Field + + // Media + "PDF", + "PDFs", + "RTF", + "TXT", + "XLS", + "XLSX", + "PPT", + + // Image + "JPG", + "JPEG", + "PNG", + "GIF", + "GIFs", + "SVG", + "TIFF", + "BMP", + "ICO", + "PSD", + "WebP", + "AVIF", + "HEIF", + "HEIC", + "EPS", + + // Audio + "MP3", + "WAV", + "AIFF", + "FLAC", + "WMA", + "AAC", + "OGG", + + // Video + "AVI", + "WMV", + "MOV", + "M4V", + "MP4", + "MPG", + "MPEG", + "FLV", + "SWF", + "MKV", + "WebM", + + // Cloud Computing + "GCP", // Google Cloud Platform + "AWS", // Amazon Web Services + "VM", // Virtual Machines + "VPC", // Virtual Private Cloud + "S3", // AWS Simple Storage Service + "EC2", // AWS Elastic Compute Cloud + + // Data Storage and Databases + "DynamoDB", + "CosmosDB", + "BigQuery", + "CI/CD", + + // Security and Compliance + "SOC1", // Service Organization Control 1 + "SOC2", // Service Organization Control 2 + "SOC3", // Service Organization Control 3 + "PCI DSS", // Payment Card Industry Data Security Standard + "WAF", // Web Application Firewall + "IAM", // Identity and Access Management + + // Networking + "SDN", // Software-Defined Networking + "MPLS", // Multi-Protocol Label Switching + "BGP", // Border Gateway Protocol + + // Frameworks and Libraries + "Vue.js", + "Node.js", + ".NET", +]; diff --git a/packages/fdr-sdk/src/utils/titleCase.ts b/packages/fdr-sdk/src/utils/titleCase.ts new file mode 100644 index 0000000000..d2b047ed59 --- /dev/null +++ b/packages/fdr-sdk/src/utils/titleCase.ts @@ -0,0 +1,19 @@ +import title from "title"; +import { SPECIAL_TOKENS } from "./specialTokens"; + +export function titleCase(name: string): string { + // regex match pascalCase or CamelCase and add spaces between words + name = name.replace(/([a-z])([A-Z])/g, "$1 $2"); + + // regex match snake_case and replace "_" with " " + name = name.replace(/_/g, " "); + + // regex match kebab-case and replace "-" with " " + name = name.replace(/-/g, " "); + + const titleCased = title(name, { special: SPECIAL_TOKENS }); + + // regex match "V 2", "V 4", etc. and replace it with "V2", "V4", etc. + const versionedTitle = titleCased.replace(/V\s(\d)/g, "V$1"); + return versionedTitle; +} diff --git a/packages/fdr-sdk/src/utils/visitDiscriminatedUnion.ts b/packages/fdr-sdk/src/utils/visitDiscriminatedUnion.ts new file mode 100644 index 0000000000..c36b74250c --- /dev/null +++ b/packages/fdr-sdk/src/utils/visitDiscriminatedUnion.ts @@ -0,0 +1,33 @@ +import { assertNever } from "./assertNever"; + +export type DiscriminatedUnionVisitor, U, Discriminant extends string> = { + [D in T[Discriminant]]: (value: Extract>) => U; +} & { + _other?: (value: Record) => U; +}; + +export function visitDiscriminatedUnion>( + item: T, +): { _visit: (visitor: DiscriminatedUnionVisitor) => U }; +export function visitDiscriminatedUnion, Discriminant extends string>( + item: T, + discriminant: Discriminant, +): { _visit: (visitor: DiscriminatedUnionVisitor) => U }; +export function visitDiscriminatedUnion, Discriminant extends string>( + item: T, + discriminant: Discriminant = "type" as Discriminant, +): { _visit: (visitor: DiscriminatedUnionVisitor) => U } { + return { + _visit: (visitor) => { + const visit = visitor[item[discriminant]]; + if (visit != null) { + return visit(item as Extract>); + } else { + if (visitor._other == null) { + assertNever(item as never); + } + return visitor._other(item); + } + }, + }; +} diff --git a/packages/fdr-sdk/tsconfig.json b/packages/fdr-sdk/tsconfig.json index 01a2cacccb..7b511639dd 100644 --- a/packages/fdr-sdk/tsconfig.json +++ b/packages/fdr-sdk/tsconfig.json @@ -1,10 +1,6 @@ { "$schema": "https://json.schemastore.org/tsconfig", - "extends": "@fern-platform/configs/tsconfig/react-library.json", - "compilerOptions": { - "isolatedModules": false, - "outDir": "./dist", - "rootDir": "./src" - }, + "extends": "@fern-platform/configs/tsconfig/library.json", + "compilerOptions": { "outDir": "./dist", "rootDir": "./src", "lib": ["DOM", "ESNext"] }, "include": ["./src/**/*"] } diff --git a/packages/fdr-sdk/turbo.json b/packages/fdr-sdk/turbo.json index cc807bcb92..a902298336 100644 --- a/packages/fdr-sdk/turbo.json +++ b/packages/fdr-sdk/turbo.json @@ -1,7 +1,7 @@ { "$schema": "https://turbo.build/schema.json", "extends": ["//"], - "pipeline": { + "tasks": { "compile": { "outputs": ["dist/**"], "dependsOn": ["^build", "^compile", "codegen"] diff --git a/packages/healthchecks/package.json b/packages/healthchecks/package.json index 99e67b3a14..4abe4c129a 100644 --- a/packages/healthchecks/package.json +++ b/packages/healthchecks/package.json @@ -21,7 +21,7 @@ "scripts": { "clean": "rm -rf ./dist && tsc --build --clean", "dist:cli": "tsup ./src/cli.ts --format cjs", - "test": "vitest --passWithNoTests --globals --disable-console-intercept", + "test": "vitest --run --passWithNoTests --globals --disable-console-intercept", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/scripts/package.json b/packages/scripts/package.json index a6c3bac5ae..4449bb2b7c 100644 --- a/packages/scripts/package.json +++ b/packages/scripts/package.json @@ -21,7 +21,7 @@ "scripts": { "clean": "rm -rf ./dist && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "format": "prettier --write --ignore-unknown --ignore-path ../../shared/.prettierignore \"**\"", diff --git a/packages/template-resolver/package.json b/packages/template-resolver/package.json index bab39eaf61..34c7c5c1b2 100644 --- a/packages/template-resolver/package.json +++ b/packages/template-resolver/package.json @@ -1,14 +1,21 @@ { "name": "@fern-api/template-resolver", "version": "0.0.0", - "main": "./dist/src/index.js", - "types": "./dist/src/index.d.ts", "files": [ "dist" ], "type": "module", - "module": "dist/src/index.js", + "module": "src/index.ts", "source": "src/index.ts", + "main": "src/index.ts", + "exports": { + ".": { + "types": "./dist/index.d.ts", + "import": "./src/index.ts", + "require": "./dist/index.js", + "default": "./dist/index.js" + } + }, "scripts": { "compile": "tsc --build", "clean": "rm -rf ./dist && tsc --build --clean", @@ -18,7 +25,7 @@ "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", "lint:style:fix": "pnpm lint:style --fix", - "test": "vitest --passWithNoTests" + "test": "vitest --run --passWithNoTests" }, "dependencies": { "lodash-es": "^4.17.21" diff --git a/packages/template-resolver/src/SnippetTemplateResolver.ts b/packages/template-resolver/src/SnippetTemplateResolver.ts index 5ab71ba5ce..a3c86900db 100644 --- a/packages/template-resolver/src/SnippetTemplateResolver.ts +++ b/packages/template-resolver/src/SnippetTemplateResolver.ts @@ -103,6 +103,9 @@ export class SnippetTemplateResolver { }); } } else { + if (payloadOverride == null && input.value.isOptional && input.value.type === "enum") { + continue; + } const evaluatedInput = this.resolveV1Template(input.value, payloadOverride); if (evaluatedInput != null) { evaluatedInputs.push(evaluatedInput); @@ -194,11 +197,11 @@ export class SnippetTemplateResolver { const unionMembers = template.members; const discriminator = template.discriminantField; - if (template.templateInput == null) { - return undefined; - } - - const maybeUnionValue = this.getPayloadValue(template.templateInput, payloadOverride); + const maybeUnionValue = this.getPayloadValue( + // Defaults to relative since the python generator didn't specify this on historical templates + template.templateInput ?? { location: "RELATIVE" }, + payloadOverride, + ); if (maybeUnionValue == null || !isPlainObject(maybeUnionValue) || !(discriminator in maybeUnionValue)) { return undefined; } diff --git a/packages/template-resolver/src/__test__/cohere.ts b/packages/template-resolver/src/__test__/cohere.ts new file mode 100644 index 0000000000..a71fd80dfe --- /dev/null +++ b/packages/template-resolver/src/__test__/cohere.ts @@ -0,0 +1,1408 @@ +import { FernRegistry } from "../generated"; + +export const CHAT_COMPLETION_SNIPPET: FernRegistry.EndpointSnippetTemplate = { + sdk: { + type: "typescript", + package: "cohere-ai", + version: "7.10.3", + }, + endpointId: { + path: "/chat", + method: "POST", + identifierOverride: "endpoint_.chat_stream", + }, + snippetTemplate: { + type: "v1", + functionInvocation: { + type: "generic", + imports: [], + templateString: "await cohere.chatStream(\n\t$FERN_INPUT\n)", + isOptional: false, + inputDelimiter: ",\n\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "{\n\t\t$FERN_INPUT\n\t}", + isOptional: true, + inputDelimiter: ",\n\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "message: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "message", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "model: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "model", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "preamble: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "preamble", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: "chatHistory: [\n\t\t\t$FERN_INPUT\n\t\t]", + delimiter: ",\n\t\t\t", + innerTemplate: { + type: "discriminatedUnion", + imports: [], + isOptional: true, + templateString: "'$FERN_INPUT'", + discriminantField: "role", + members: { + CHATBOT: { + type: "generic", + imports: [], + templateString: + '{ \n\t\t\t\trole : "CHATBOT", \n\t\t\t\t$FERN_INPUT\n\t\t\t}', + isOptional: true, + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "message: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "message", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: + "toolCalls: [\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t]", + delimiter: ",\n\t\t\t\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: + "{\n\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: + "name: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "name", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "parameters: {\n\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t}", + delimiter: + ",\n\t\t\t\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "parameters", + }, + }, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "tool_calls", + }, + }, + }, + ], + }, + }, + ], + }, + SYSTEM: { + type: "generic", + imports: [], + templateString: + '{ \n\t\t\t\trole : "SYSTEM", \n\t\t\t\t$FERN_INPUT\n\t\t\t}', + isOptional: true, + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "message: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "message", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: + "toolCalls: [\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t]", + delimiter: ",\n\t\t\t\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: + "{\n\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: + "name: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "name", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "parameters: {\n\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t}", + delimiter: + ",\n\t\t\t\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "parameters", + }, + }, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "tool_calls", + }, + }, + }, + ], + }, + }, + ], + }, + USER: { + type: "generic", + imports: [], + templateString: + '{ \n\t\t\t\trole : "USER", \n\t\t\t\t$FERN_INPUT\n\t\t\t}', + isOptional: true, + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "message: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "message", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: + "toolCalls: [\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t]", + delimiter: ",\n\t\t\t\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: + "{\n\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: + "name: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "name", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "parameters: {\n\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t}", + delimiter: + ",\n\t\t\t\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "parameters", + }, + }, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "tool_calls", + }, + }, + }, + ], + }, + }, + ], + }, + TOOL: { + type: "generic", + imports: [], + templateString: + '{ \n\t\t\t\trole : "TOOL", \n\t\t\t\t$FERN_INPUT\n\t\t\t}', + isOptional: true, + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: + "toolResults: [\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t]", + delimiter: ",\n\t\t\t\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: + "{\n\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: + "call: {\n\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t}", + isOptional: true, + inputDelimiter: + ",\n\t\t\t\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: + "name: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: "call.name", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "parameters: {\n\t\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t\t}", + delimiter: + ",\n\t\t\t\t\t\t\t\t\t", + keyValueSeparator: + ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: + true, + templateInputs: + [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: + true, + templateInputs: + [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: + "RELATIVE", + path: "call.parameters", + }, + }, + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: + "outputs: [\n\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t]", + delimiter: + ",\n\t\t\t\t\t\t\t\t", + innerTemplate: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "{\n\t\t\t\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t\t\t\t}", + delimiter: + ",\n\t\t\t\t\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: + "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: + "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: undefined, + }, + }, + templateInput: { + location: "RELATIVE", + path: "outputs", + }, + }, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "tool_results", + }, + }, + }, + ], + }, + }, + ], + }, + }, + templateInput: { + location: "RELATIVE", + path: undefined, + }, + }, + templateInput: { + location: "BODY", + path: "chat_history", + }, + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "conversationId: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "conversation_id", + }, + ], + }, + }, + { + type: "template", + value: { + type: "enum", + imports: [], + isOptional: true, + values: { + OFF: "Cohere.ChatStreamRequestPromptTruncation.Off", + AUTO: "Cohere.ChatStreamRequestPromptTruncation.Auto", + AUTO_PRESERVE_ORDER: + "Cohere.ChatStreamRequestPromptTruncation.AutoPreserveOrder", + }, + templateString: "promptTruncation: $FERN_INPUT", + templateInput: { + location: "BODY", + path: "prompt_truncation", + }, + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: "connectors: [\n\t\t\t$FERN_INPUT\n\t\t]", + delimiter: ",\n\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t$FERN_INPUT\n\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "id: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "id", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "userAccessToken: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "user_access_token", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "continueOnFailure: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "continue_on_failure", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "options: {\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + delimiter: ",\n\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "options", + }, + }, + }, + ], + }, + templateInput: { + location: "BODY", + path: "connectors", + }, + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "searchQueriesOnly: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "search_queries_only", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: "documents: [\n\t\t\t$FERN_INPUT\n\t\t]", + delimiter: ",\n\t\t\t", + innerTemplate: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: "{\n\t\t\t\t$FERN_INPUT\n\t\t\t}", + delimiter: ",\n\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: undefined, + }, + }, + templateInput: { + location: "BODY", + path: "documents", + }, + }, + }, + { + type: "template", + value: { + type: "enum", + imports: [], + isOptional: true, + values: { + fast: "Cohere.ChatStreamRequestCitationQuality.Fast", + accurate: "Cohere.ChatStreamRequestCitationQuality.Accurate", + }, + templateString: "citationQuality: $FERN_INPUT", + templateInput: { + location: "BODY", + path: "citation_quality", + }, + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "temperature: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "temperature", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "maxTokens: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "max_tokens", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "maxInputTokens: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "max_input_tokens", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "k: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "k", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "p: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "p", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "seed: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "seed", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: "stopSequences: [\n\t\t\t$FERN_INPUT\n\t\t]", + delimiter: ",\n\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "BODY", + path: "stop_sequences", + }, + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "frequencyPenalty: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "frequency_penalty", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "presencePenalty: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "presence_penalty", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "rawPrompting: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "raw_prompting", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "returnPrompt: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "return_prompt", + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: "tools: [\n\t\t\t$FERN_INPUT\n\t\t]", + delimiter: ",\n\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t$FERN_INPUT\n\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "name: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "name", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "description: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "description", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "parameterDefinitions: {\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + delimiter: ",\n\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "description: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "description", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "type: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "type", + }, + ], + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "required: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "required", + }, + ], + }, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "parameter_definitions", + }, + }, + }, + ], + }, + templateInput: { + location: "BODY", + path: "tools", + }, + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: "toolResults: [\n\t\t\t$FERN_INPUT\n\t\t]", + delimiter: ",\n\t\t\t", + innerTemplate: { + type: "generic", + imports: [], + templateString: "{\n\t\t\t\t$FERN_INPUT\n\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "call: {\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t}", + isOptional: true, + inputDelimiter: ",\n\t\t\t\t\t", + templateInputs: [ + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "name: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: "call.name", + }, + ], + }, + }, + { + type: "template", + value: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "parameters: {\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t}", + delimiter: ",\n\t\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: "call.parameters", + }, + }, + }, + ], + }, + }, + { + type: "template", + value: { + type: "iterable", + imports: [], + isOptional: true, + containerTemplateString: + "outputs: [\n\t\t\t\t\t$FERN_INPUT\n\t\t\t\t]", + delimiter: ",\n\t\t\t\t\t", + innerTemplate: { + type: "dict", + imports: [], + isOptional: true, + containerTemplateString: + "{\n\t\t\t\t\t\t$FERN_INPUT\n\t\t\t\t\t}", + delimiter: ",\n\t\t\t\t\t\t", + keyValueSeparator: ": ", + keyTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + valueTemplate: { + type: "generic", + imports: [], + templateString: "$FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "RELATIVE", + path: undefined, + }, + ], + }, + templateInput: { + location: "RELATIVE", + path: undefined, + }, + }, + templateInput: { + location: "RELATIVE", + path: "outputs", + }, + }, + }, + ], + }, + templateInput: { + location: "BODY", + path: "tool_results", + }, + }, + }, + { + type: "template", + value: { + type: "generic", + imports: [], + templateString: "forceSingleStep: $FERN_INPUT", + isOptional: true, + templateInputs: [ + { + type: "payload", + location: "BODY", + path: "force_single_step", + }, + ], + }, + }, + ], + }, + }, + ], + }, + clientInstantiation: + 'const cohere = new CohereClient({ token: "YOUR_TOKEN", clientName: "YOUR_CLIENT_NAME" });\n', + }, +}; diff --git a/packages/template-resolver/src/__test__/unit-tests/__snapshots__/cohere.test.ts.snap b/packages/template-resolver/src/__test__/unit-tests/__snapshots__/cohere.test.ts.snap new file mode 100644 index 0000000000..b1450c7f93 --- /dev/null +++ b/packages/template-resolver/src/__test__/unit-tests/__snapshots__/cohere.test.ts.snap @@ -0,0 +1,13 @@ +// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html + +exports[`Snippet Template Resolver > Test Chat Completion snippet 1`] = ` +" + +const cohere = new CohereClient({ token: "YOUR_TOKEN", clientName: "YOUR_CLIENT_NAME" }); + +await cohere.chatStream( + { + message: "Hello world!" + } +)" +`; diff --git a/packages/template-resolver/src/__test__/unit-tests/__snapshots__/octo.test.ts.snap b/packages/template-resolver/src/__test__/unit-tests/__snapshots__/octo.test.ts.snap new file mode 100644 index 0000000000..b8bb678946 --- /dev/null +++ b/packages/template-resolver/src/__test__/unit-tests/__snapshots__/octo.test.ts.snap @@ -0,0 +1,51 @@ +// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html + +exports[`Snippet Template Resolver > Empty payload 1`] = ` +" + +from elevenlabs.client import AsyncElevenLabs + +client = AsyncElevenLabs( + api_key="YOUR_API_KEY", +) +await client.voices.get_all( + +)" +`; + +exports[`Snippet Template Resolver > Test Chat Completion snippet 1`] = ` +" + +from octoai.client import AsyncOctoAI + +client = AsyncOctoAI( + api_key="YOUR_API_KEY", +) + +await client.text_gen.create_chat_completion_stream( +max_tokens=512, +messages=[], +model="qwen1.5-32b-chat", +presence_penalty=0, +temperature=0.1, +top_p=0.9 +)" +`; + +exports[`Snippet Template Resolver > Test Snippet Template Resolution 1`] = ` +"from octoai.image_gen import ImageGenerationRequest + +from octoai import AsyncAcme + +client = AsyncAcme(api_key='YOUR_API_KEY') +client.image_gen.generate_sdxl( + ImageGenerationRequest( + prompt="A prompt", + negative_prompt="A negative prompt", + tune_id="someId", + offset="10", + output_format="pcm_16000", + loras={"key1": "value1", "key2": "value2"} + ) +)" +`; diff --git a/packages/template-resolver/src/__test__/unit-tests/cohere.test.ts b/packages/template-resolver/src/__test__/unit-tests/cohere.test.ts new file mode 100644 index 0000000000..ce97efcb44 --- /dev/null +++ b/packages/template-resolver/src/__test__/unit-tests/cohere.test.ts @@ -0,0 +1,22 @@ +import { SnippetTemplateResolver } from "../../SnippetTemplateResolver"; +import { CHAT_COMPLETION_SNIPPET } from "../cohere"; + +describe("Snippet Template Resolver", () => { + it("Test Chat Completion snippet", () => { + const resolver = new SnippetTemplateResolver({ + payload: { + requestBody: { + message: "Hello world!", + }, + }, + endpointSnippetTemplate: CHAT_COMPLETION_SNIPPET, + }); + const customSnippet = resolver.resolve(); + + if (customSnippet.type !== "typescript") { + throw new Error("Expected snippet to be typescript"); + } + + expect(customSnippet.client).toMatchSnapshot(); + }); +}); diff --git a/packages/template-resolver/src/__test__/unit-tests/testSnippetTemplateResolver.test.ts b/packages/template-resolver/src/__test__/unit-tests/octo.test.ts similarity index 91% rename from packages/template-resolver/src/__test__/unit-tests/testSnippetTemplateResolver.test.ts rename to packages/template-resolver/src/__test__/unit-tests/octo.test.ts index 71e2cc643e..23e62c9595 100644 --- a/packages/template-resolver/src/__test__/unit-tests/testSnippetTemplateResolver.test.ts +++ b/packages/template-resolver/src/__test__/unit-tests/octo.test.ts @@ -117,7 +117,7 @@ describe("Snippet Template Resolver", () => { type: "template", value: { imports: [], - isOptional: true, + isOptional: false, templateString: "output_format=$FERN_INPUT", values: { mp3_22050_32: '"mp3_22050_32"', @@ -166,10 +166,11 @@ describe("Snippet Template Resolver", () => { const resolver = new SnippetTemplateResolver({ payload, endpointSnippetTemplate }); const customSnippet = resolver.resolve(); - expect(customSnippet.type).toEqual("python"); - expect((customSnippet as FernRegistry.PythonSnippet).sync_client).toEqual( - 'from octoai.image_gen import ImageGenerationRequest\nfrom octoai.image_gen import Scheduler\n\nfrom octoai import AsyncAcme\n\nclient = AsyncAcme(api_key=\'YOUR_API_KEY\')\nclient.image_gen.generate_sdxl(\n\tImageGenerationRequest(\n\t\tprompt="A prompt",\n\t\tnegative_prompt="A negative prompt",\n\t\ttune_id="someId",\n\t\toffset="10",\n\t\toutput_format="pcm_16000",\n\t\tloras={"key1": "value1", "key2": "value2"},\n\t\tsampler=OctoAI.myenum.PNDM\n\t)\n)', - ); + if (customSnippet.type !== "python") { + throw new Error("Expected snippet to be python"); + } + + expect(customSnippet.sync_client).toMatchSnapshot(); }); it("Empty payload", () => { @@ -207,7 +208,11 @@ describe("Snippet Template Resolver", () => { }); const customSnippet = resolver.resolve(); - expect(customSnippet.type).toEqual("python"); + if (customSnippet.type !== "python") { + throw new Error("Expected snippet to be python"); + } + + expect(customSnippet.sync_client).toMatchSnapshot(); }); it("Test Chat Completion snippet", () => { @@ -217,6 +222,10 @@ describe("Snippet Template Resolver", () => { }); const customSnippet = resolver.resolve(); - expect(customSnippet.type).toEqual("python"); + if (customSnippet.type !== "python") { + throw new Error("Expected snippet to be python"); + } + + expect(customSnippet.sync_client).toMatchSnapshot(); }); }); diff --git a/packages/template-resolver/tsconfig.json b/packages/template-resolver/tsconfig.json index daace200d4..9a6c82205a 100644 --- a/packages/template-resolver/tsconfig.json +++ b/packages/template-resolver/tsconfig.json @@ -1,6 +1,5 @@ { "extends": "@fern-platform/configs/tsconfig/library.json", - "compilerOptions": { "outDir": "./dist", "rootDir": "." }, - "include": ["./src/**/*"], - "references": [{ "path": "../commons/core-utils" }] + "compilerOptions": { "outDir": "./dist", "rootDir": "./src" }, + "include": ["./src/**/*"] } diff --git a/packages/template-resolver/turbo.json b/packages/template-resolver/turbo.json index cc807bcb92..a902298336 100644 --- a/packages/template-resolver/turbo.json +++ b/packages/template-resolver/turbo.json @@ -1,7 +1,7 @@ { "$schema": "https://turbo.build/schema.json", "extends": ["//"], - "pipeline": { + "tasks": { "compile": { "outputs": ["dist/**"], "dependsOn": ["^build", "^compile", "codegen"] diff --git a/packages/ui/app/package.json b/packages/ui/app/package.json index 6e97b144a9..40228fd957 100644 --- a/packages/ui/app/package.json +++ b/packages/ui/app/package.json @@ -21,7 +21,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals --disable-console-intercept", + "test": "vitest --run --passWithNoTests --globals --disable-console-intercept", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/ui/app/src/analytics/CustomerAnalytics.tsx b/packages/ui/app/src/analytics/CustomerAnalytics.tsx index 9d488b5850..a05f3e176f 100644 --- a/packages/ui/app/src/analytics/CustomerAnalytics.tsx +++ b/packages/ui/app/src/analytics/CustomerAnalytics.tsx @@ -21,6 +21,11 @@ const CUSTOMER_ANALYTICS: Record = { id: "GTM-P859DNW4", }, }, + humansignal: { + ga4: { + id: "G-5MGM6QQVFS", + }, + }, }; export function CustomerAnalytics({ domain }: { domain: string }): ReactElement | null { diff --git a/packages/ui/app/src/api-page/endpoints/EndpointContentCodeSnippets.tsx b/packages/ui/app/src/api-page/endpoints/EndpointContentCodeSnippets.tsx index 396e434744..c0a63a8c52 100644 --- a/packages/ui/app/src/api-page/endpoints/EndpointContentCodeSnippets.tsx +++ b/packages/ui/app/src/api-page/endpoints/EndpointContentCodeSnippets.tsx @@ -1,4 +1,3 @@ -"use client"; import { APIV1Read, FernNavigation } from "@fern-api/fdr-sdk"; import { FernButton, FernButtonGroup, FernScrollArea } from "@fern-ui/components"; import { EMPTY_OBJECT, visitDiscriminatedUnion } from "@fern-ui/core-utils"; diff --git a/packages/ui/app/src/api-playground/PlaygroundEndpointSelectorContent.tsx b/packages/ui/app/src/api-playground/PlaygroundEndpointSelectorContent.tsx index 1e74e2827c..64d1b23842 100644 --- a/packages/ui/app/src/api-playground/PlaygroundEndpointSelectorContent.tsx +++ b/packages/ui/app/src/api-playground/PlaygroundEndpointSelectorContent.tsx @@ -1,5 +1,4 @@ import { FernNavigation } from "@fern-api/fdr-sdk"; -import { traverseNavigation } from "@fern-api/fdr-sdk/dist/navigation/utils"; import { FernButton, FernInput, FernScrollArea, FernTooltip, FernTooltipProvider } from "@fern-ui/components"; import { isNonNullish } from "@fern-ui/core-utils"; import { Cross1Icon, MagnifyingGlassIcon, SlashIcon } from "@radix-ui/react-icons"; @@ -30,7 +29,7 @@ export interface ApiGroup { export function flattenApiSection(root: FernNavigation.SidebarRootNode): ApiGroup[] { const result: ApiGroup[] = []; - traverseNavigation(root, (node, _, parents) => { + FernNavigation.utils.traverseNavigation(root, (node, _, parents) => { if (node.type === "changelog") { return "skip"; } diff --git a/packages/ui/app/src/api-playground/utils.ts b/packages/ui/app/src/api-playground/utils.ts index 2589582dfa..891aab05aa 100644 --- a/packages/ui/app/src/api-playground/utils.ts +++ b/packages/ui/app/src/api-playground/utils.ts @@ -1,4 +1,4 @@ -import { CustomSnippetPayload } from "@fern-api/fdr-sdk/dist/client/generated/api"; +import { Snippets } from "@fern-api/fdr-sdk"; import { SnippetTemplateResolver } from "@fern-api/template-resolver"; import { isNonNullish, isPlainObject, visitDiscriminatedUnion } from "@fern-ui/core-utils"; import { isEmpty, mapValues, noop } from "lodash-es"; @@ -334,7 +334,9 @@ ${buildRequests({})}`, }); } -export function convertToCustomSnippetPayload(formState: PlaygroundEndpointRequestFormState): CustomSnippetPayload { +export function convertToCustomSnippetPayload( + formState: PlaygroundEndpointRequestFormState, +): Snippets.CustomSnippetPayload { return { pathParameters: Object.entries(formState.pathParameters).map(([name, value]) => ({ name, value })), queryParameters: Object.entries(formState.queryParameters).map(([name, value]) => ({ name, value })), diff --git a/packages/ui/app/src/contexts/docs-context/DocsContext.ts b/packages/ui/app/src/contexts/docs-context/DocsContext.ts index 929371a8d5..582ce525b6 100644 --- a/packages/ui/app/src/contexts/docs-context/DocsContext.ts +++ b/packages/ui/app/src/contexts/docs-context/DocsContext.ts @@ -1,4 +1,5 @@ -import { DocsV1Read, FdrAPI, FernNavigation, NodeCollector } from "@fern-api/fdr-sdk"; +import { DocsV1Read, FdrAPI, FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { ColorsConfig } from "@fern-ui/fdr-utils"; import React from "react"; import { DocsPage } from "../../next-app/DocsPage"; diff --git a/packages/ui/app/src/contexts/docs-context/DocsContextProvider.tsx b/packages/ui/app/src/contexts/docs-context/DocsContextProvider.tsx index 277455a774..3b0d4130ff 100644 --- a/packages/ui/app/src/contexts/docs-context/DocsContextProvider.tsx +++ b/packages/ui/app/src/contexts/docs-context/DocsContextProvider.tsx @@ -1,4 +1,5 @@ -import { DocsV1Read, DocsV2Read, NodeCollector } from "@fern-api/fdr-sdk"; +import { DocsV1Read, DocsV2Read } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { useDeepCompareMemoize } from "@fern-ui/react-commons"; import { useTheme } from "next-themes"; import Head from "next/head"; diff --git a/packages/ui/app/src/sidebar/CollapseSidebarContext.tsx b/packages/ui/app/src/sidebar/CollapseSidebarContext.tsx index 5adabff910..328b7d49e3 100644 --- a/packages/ui/app/src/sidebar/CollapseSidebarContext.tsx +++ b/packages/ui/app/src/sidebar/CollapseSidebarContext.tsx @@ -1,4 +1,5 @@ -import { FernNavigation, NodeCollector } from "@fern-api/fdr-sdk"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { noop } from "lodash-es"; import { useRouter } from "next/router"; import { diff --git a/packages/ui/app/src/util/__test__/dateUtils.test.ts b/packages/ui/app/src/util/__test__/dateUtils.test.ts deleted file mode 100644 index 1c2527d162..0000000000 --- a/packages/ui/app/src/util/__test__/dateUtils.test.ts +++ /dev/null @@ -1,162 +0,0 @@ -import moment from "moment"; -import { Changelog } from "../dateUtils"; - -describe("Changelog.toShortDateString", () => { - it("should return the correct date", () => { - const timestamp = "2020-01-01T00:00:00Z"; - expect(Changelog.toShortDateString(timestamp)).toEqual("Jan 01 2020"); - }); - - it("should return the correct date for a different date", () => { - const timestamp = "2020-02-02T00:00:00Z"; - expect(Changelog.toShortDateString(timestamp)).toEqual("Feb 02 2020"); - }); - - it("should return the correct date even for the end of the day", () => { - const timestamp = "2020-02-02T23:59:59Z"; - expect(Changelog.toShortDateString(timestamp)).toEqual("Feb 02 2020"); - }); - - it("should return the correct date for a different timezone", () => { - const timestamp = "2020-02-02T00:00:00+01:00"; - expect(Changelog.toShortDateString(timestamp)).toEqual("Feb 02 2020"); - - const timestamp2 = "2020-02-02T00:00:00-01:00"; - expect(Changelog.toShortDateString(timestamp2)).toEqual("Feb 02 2020"); - - const timestamp3 = "2020-02-02T00:00:00+02:00"; - expect(Changelog.toShortDateString(timestamp3)).toEqual("Feb 02 2020"); - }); -}); - -describe("Changelog.toLongDateString", () => { - it("should return the correct date", () => { - const timestamp = "2020-01-01T00:00:00Z"; - expect(Changelog.toLongDateString(timestamp)).toEqual("January 1, 2020"); - }); - - it("should return the correct date for a different date", () => { - const timestamp = "2020-02-02T00:00:00Z"; - expect(Changelog.toLongDateString(timestamp)).toEqual("February 2, 2020"); - }); - - it("should return the correct date even for the end of the day", () => { - const timestamp = "2020-02-02T23:59:59Z"; - expect(Changelog.toLongDateString(timestamp)).toEqual("February 2, 2020"); - }); -}); - -describe("Changelog.toCalendarDate", () => { - it("should return 'today' for the same day", () => { - const timestamp = moment().toISOString(); - expect(Changelog.toCalendarDate(timestamp)).toEqual("today"); - }); - - it("should return 'tomorrow' for the next day", () => { - const timestamp = moment().add(1, "day").toISOString(); - expect(Changelog.toCalendarDate(timestamp)).toEqual("tomorrow"); - }); - - it("should return 'yesterday' for the previous day", () => { - const timestamp = moment().subtract(1, "day").toISOString(); - expect(Changelog.toCalendarDate(timestamp)).toEqual("yesterday"); - }); - - it("should return the day of the week for the next week", () => { - const timestamp = moment().add(2, "days").toISOString(); - expect(Changelog.toCalendarDate(timestamp)).oneOf([ - "Monday", - "Tuesday", - "Wednesday", - "Thursday", - "Friday", - "Saturday", - "Sunday", - ]); - }); - - it("should return the day of the week for the previous week", () => { - const timestamp = moment().subtract(3, "days").toISOString(); - expect(Changelog.toCalendarDate(timestamp)).oneOf([ - "last Monday", - "last Tuesday", - "last Wednesday", - "last Thursday", - "last Friday", - "last Saturday", - "last Sunday", - ]); - }); - - it("should return the date for any other day", () => { - const timestamp = "2020-01-01T00:00:00Z"; - expect(Changelog.toCalendarDate(timestamp)).toEqual("1/1/2020"); - - const timestamp2 = "2020-01-31T00:00:00Z"; - expect(Changelog.toCalendarDate(timestamp2)).toEqual("1/31/2020"); - }); -}); - -describe("Changelog.withinLastWeek", () => { - it("should return true for today", () => { - const timestamp = moment().toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(true); - }); - - it("should return true for yesterday", () => { - const timestamp = moment().subtract(1, "day").toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(true); - }); - - it("should return true for 6 days ago", () => { - const timestamp = moment().subtract(6, "days").toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(true); - }); - - it("should return false for 8 days ago", () => { - const timestamp = moment().subtract(8, "days").toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(false); - }); - - it("should return false for 10 days ago", () => { - const timestamp = moment().subtract(10, "days").toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(false); - }); - - it("should return false tomorrow", () => { - const timestamp = moment().add(1, "day").toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(false); - }); - - it("should return false for 7 days from now", () => { - const timestamp = moment().add(7, "days").toISOString(); - expect(Changelog.withinLastWeek(timestamp)).toEqual(false); - }); -}); - -describe("Changelog.isFutureDate", () => { - it("should return true for today", () => { - const timestamp = moment().toISOString(); - expect(Changelog.isFutureDate(timestamp)).toEqual(false); - }); - - it("should return false for yesterday", () => { - const timestamp = moment().subtract(1, "day").toISOString(); - expect(Changelog.isFutureDate(timestamp)).toEqual(false); - }); - - it("should return false for 7 days ago", () => { - const timestamp = moment().subtract(7, "days").toISOString(); - expect(Changelog.isFutureDate(timestamp)).toEqual(false); - }); - - it("should return true for tomorrow", () => { - const timestamp = moment().add(1, "day").toISOString(); - expect(Changelog.isFutureDate(timestamp)).toEqual(true); - }); - - it("should return true for 7 days from now", () => { - const timestamp = moment().add(7, "days").toISOString(); - expect(Changelog.isFutureDate(timestamp)).toEqual(true); - }); -}); diff --git a/packages/ui/app/tsconfig.json b/packages/ui/app/tsconfig.json index 99caaa26c6..2b8d436b2c 100644 --- a/packages/ui/app/tsconfig.json +++ b/packages/ui/app/tsconfig.json @@ -12,6 +12,8 @@ { "path": "../../commons/loadable" }, { "path": "../components" }, { "path": "../../commons/react/react-commons" }, - { "path": "../../template-resolver" } + { "path": "../../template-resolver" }, + { "path": "../../fdr-sdk" }, + { "path": "../../commons/fdr-utils" } ] } diff --git a/packages/ui/components/package.json b/packages/ui/components/package.json index e5d42c4b88..e7b5dc362f 100644 --- a/packages/ui/components/package.json +++ b/packages/ui/components/package.json @@ -21,7 +21,7 @@ "scripts": { "clean": "rm -rf ./dist && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals --disable-console-intercept", + "test": "vitest --run --passWithNoTests --globals --disable-console-intercept", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/ui/docs-bundle/package.json b/packages/ui/docs-bundle/package.json index efb7092988..41ba695f25 100644 --- a/packages/ui/docs-bundle/package.json +++ b/packages/ui/docs-bundle/package.json @@ -17,7 +17,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/ui/docs-bundle/src/pages/api/fern-docs/resolve-api.ts b/packages/ui/docs-bundle/src/pages/api/fern-docs/resolve-api.ts index 0f0b2c4a2d..b5cb1f4d12 100644 --- a/packages/ui/docs-bundle/src/pages/api/fern-docs/resolve-api.ts +++ b/packages/ui/docs-bundle/src/pages/api/fern-docs/resolve-api.ts @@ -1,6 +1,5 @@ -import { ApiDefinitionHolder } from "@fern-api/fdr-sdk/dist/navigation/ApiDefinitionHolder"; -import { collectApiReferences } from "@fern-api/fdr-sdk/dist/navigation/utils/collectApiReferences"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { ApiDefinitionHolder } from "@fern-api/fdr-sdk/navigation"; import { ApiDefinitionResolver, ApiTypeResolver, REGISTRY_SERVICE, type ResolvedRootPackage } from "@fern-ui/ui"; import { NextApiHandler, NextApiResponse } from "next"; import { buildUrlFromApiNode } from "../../../utils/buildUrlFromApi"; @@ -35,12 +34,12 @@ const resolveApiHandler: NextApiHandler = async ( } const docs = docsResponse.body; - const root = convertLoadDocsForUrlResponse(docsResponse.body); + const root = FernNavigation.utils.convertLoadDocsForUrlResponse(docsResponse.body); const featureFlags = await getFeatureFlags(docs.baseUrl.domain); const packagesPromise: Promise[] = []; - collectApiReferences(root).forEach((apiReference) => { + FernNavigation.utils.collectApiReferences(root).forEach((apiReference) => { const api = docs.definition.apis[apiReference.apiDefinitionId]; if (api == null) { return; diff --git a/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all.ts b/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all.ts index a33798af67..b5abdce8fc 100644 --- a/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all.ts +++ b/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all.ts @@ -1,5 +1,5 @@ -import { NodeCollector } from "@fern-api/fdr-sdk/dist/navigation/NodeCollector"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { buildUrl } from "@fern-ui/fdr-utils"; import { NextApiHandler, NextApiRequest, NextApiResponse } from "next"; import urljoin from "url-join"; @@ -62,7 +62,7 @@ const handler: NextApiHandler = async ( return res.status(404).json({ successfulRevalidations: [], failedRevalidations: [] }); } - const node = convertLoadDocsForUrlResponse(docs); + const node = FernNavigation.utils.convertLoadDocsForUrlResponse(docs); const slugCollector = NodeCollector.collect(node); const urls = slugCollector.getSlugs().map((slug) => urljoin(xFernHost, slug)); diff --git a/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v2.ts b/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v2.ts index 06db5ac3ee..a7039a15f5 100644 --- a/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v2.ts +++ b/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v2.ts @@ -1,5 +1,5 @@ -import { NodeCollector } from "@fern-api/fdr-sdk/dist/navigation/NodeCollector"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { isPlainObject } from "@fern-ui/core-utils"; import { buildUrl } from "@fern-ui/fdr-utils"; import { NextApiHandler, NextApiRequest, NextApiResponse } from "next"; @@ -63,7 +63,7 @@ const handler: NextApiHandler = async ( return res.status(404).json({ successfulRevalidations: [], failedRevalidations: [] }); } - const node = convertLoadDocsForUrlResponse(docs); + const node = FernNavigation.utils.convertLoadDocsForUrlResponse(docs); const slugCollector = NodeCollector.collect(node); const urls = slugCollector.getSlugs().map((slug) => urljoin(xFernHost, slug)); diff --git a/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v3.ts b/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v3.ts index 8e7e4bb710..77710d247c 100644 --- a/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v3.ts +++ b/packages/ui/docs-bundle/src/pages/api/fern-docs/revalidate-all/v3.ts @@ -1,5 +1,5 @@ -import { NodeCollector } from "@fern-api/fdr-sdk/dist/navigation/NodeCollector"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { buildUrl } from "@fern-ui/fdr-utils"; import { NextApiHandler, NextApiRequest, NextApiResponse } from "next"; import urljoin from "url-join"; @@ -62,7 +62,7 @@ const handler: NextApiHandler = async ( return res.status(404).json({ successfulRevalidations: [], failedRevalidations: [] }); } - const node = convertLoadDocsForUrlResponse(docs); + const node = FernNavigation.utils.convertLoadDocsForUrlResponse(docs); const slugCollector = NodeCollector.collect(node); const urls = slugCollector.getSlugs().map((slug) => urljoin(xFernHost, slug)); diff --git a/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.ts b/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.ts index d6023936e3..7deabf07ca 100644 --- a/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.ts +++ b/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.ts @@ -1,5 +1,5 @@ -import { NodeCollector } from "@fern-api/fdr-sdk/dist/navigation/NodeCollector"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { NextRequest, NextResponse } from "next/server"; import urljoin from "url-join"; import { buildUrlFromApiEdge } from "../../../utils/buildUrlFromApi"; @@ -25,7 +25,7 @@ export default async function GET(req: NextRequest): Promise { return jsonResponse(404, [], { headers }); } - const node = convertLoadDocsForUrlResponse(docs); + const node = FernNavigation.utils.convertLoadDocsForUrlResponse(docs); const slugCollector = NodeCollector.collect(node); const urls = slugCollector.getPageSlugs().map((slug) => urljoin(xFernHost, slug)); diff --git a/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.xml.ts b/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.xml.ts index 4920db6e49..b3e83ece52 100644 --- a/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.xml.ts +++ b/packages/ui/docs-bundle/src/pages/api/fern-docs/sitemap.xml.ts @@ -1,5 +1,5 @@ -import { NodeCollector } from "@fern-api/fdr-sdk/dist/navigation/NodeCollector"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; +import { FernNavigation } from "@fern-api/fdr-sdk"; +import { NodeCollector } from "@fern-api/fdr-sdk/navigation"; import { NextRequest, NextResponse } from "next/server"; import urljoin from "url-join"; import { buildUrlFromApiEdge } from "../../../utils/buildUrlFromApi"; @@ -25,7 +25,7 @@ export default async function GET(req: NextRequest): Promise { return new NextResponse(null, { status: 404 }); } - const node = convertLoadDocsForUrlResponse(docs); + const node = FernNavigation.utils.convertLoadDocsForUrlResponse(docs); const slugCollector = NodeCollector.collect(node); const urls = slugCollector.getPageSlugs().map((slug) => urljoin(xFernHost, slug)); diff --git a/packages/ui/docs-bundle/src/utils/getDocsPageProps.ts b/packages/ui/docs-bundle/src/utils/getDocsPageProps.ts index 1c36896af8..dad743cbf7 100644 --- a/packages/ui/docs-bundle/src/utils/getDocsPageProps.ts +++ b/packages/ui/docs-bundle/src/utils/getDocsPageProps.ts @@ -1,6 +1,4 @@ -import { FdrClient, type DocsV2Read } from "@fern-api/fdr-sdk"; -import { convertLoadDocsForUrlResponse } from "@fern-api/fdr-sdk/dist/navigation/utils/convertLoadDocsForUrlResponse"; -import { findNode } from "@fern-api/fdr-sdk/dist/navigation/utils/findNode"; +import { FdrClient, FernNavigation, type DocsV2Read } from "@fern-api/fdr-sdk"; import { FernVenusApi, FernVenusApiClient } from "@fern-api/venus-api-sdk"; import { visitDiscriminatedUnion } from "@fern-ui/core-utils"; import { SidebarTab, buildUrl } from "@fern-ui/fdr-utils"; @@ -174,8 +172,8 @@ async function convertDocsToDocsPageProps({ }; } - const root = convertLoadDocsForUrlResponse(docs); - const node = findNode(root, slug); + const root = FernNavigation.utils.convertLoadDocsForUrlResponse(docs); + const node = FernNavigation.utils.findNode(root, slug); if (node.type === "notFound") { // eslint-disable-next-line no-console diff --git a/packages/ui/fontawesome-cdn/package.json b/packages/ui/fontawesome-cdn/package.json index 1d7edda1ff..b9e17daf8c 100644 --- a/packages/ui/fontawesome-cdn/package.json +++ b/packages/ui/fontawesome-cdn/package.json @@ -17,7 +17,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/packages/ui/local-preview-bundle/.depcheckrc.json b/packages/ui/local-preview-bundle/.depcheckrc.json index b2a82a4ecf..ef3f5df4b1 100644 --- a/packages/ui/local-preview-bundle/.depcheckrc.json +++ b/packages/ui/local-preview-bundle/.depcheckrc.json @@ -16,7 +16,8 @@ "lodash-es", "@types/lodash-es", "node-fetch", - "@types/node-fetch" + "@types/node-fetch", + "@emotion/is-prop-valid" ], "ignore-patterns": ["dist"] } diff --git a/packages/ui/local-preview-bundle/package.json b/packages/ui/local-preview-bundle/package.json index c0db078ae8..68abb557e1 100644 --- a/packages/ui/local-preview-bundle/package.json +++ b/packages/ui/local-preview-bundle/package.json @@ -17,7 +17,7 @@ "scripts": { "clean": "rm -rf ./lib && tsc --build --clean", "compile": "tsc --build", - "test": "vitest --passWithNoTests --globals", + "test": "vitest --run --passWithNoTests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "lint:style": "stylelint 'src/**/*.scss' --allow-empty-input --max-warnings 0", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 8cc5426bba..44ce9f5d15 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -157,8 +157,8 @@ importers: specifier: ^4.7.1 version: 4.9.3 turbo: - specifier: ^1.12.5 - version: 1.13.3 + specifier: ^2.0.1 + version: 2.0.1 typescript: specifier: 5.4.3 version: 5.4.3 @@ -236,6 +236,60 @@ importers: specifier: ^4.0.131 version: 4.0.159(@types/react@18.3.1)(openapi-types@12.1.3)(react-dom@18.3.1)(react@18.3.1) + clis/generator-cli: + devDependencies: + '@fern-api/fs-utils': + specifier: 0.15.0-rc63 + version: 0.15.0-rc63 + '@types/jest': + specifier: ^29.5.11 + version: 29.5.12 + '@types/lodash-es': + specifier: ^4.17.12 + version: 4.17.12 + '@types/node': + specifier: ^18.7.18 + version: 18.19.33 + '@types/yargs': + specifier: ^17.0.32 + version: 17.0.32 + '@yarnpkg/esbuild-plugin-pnp': + specifier: ^3.0.0-rc.15 + version: 3.0.0-rc.15(esbuild@0.20.2) + depcheck: + specifier: ^1.4.3 + version: 1.4.7 + esbuild: + specifier: 0.20.2 + version: 0.20.2 + eslint: + specifier: ^8.56.0 + version: 8.57.0 + execa: + specifier: ^5.1.1 + version: 5.1.1 + lodash-es: + specifier: ^4.17.12 + version: 4.17.21 + organize-imports-cli: + specifier: ^0.10.0 + version: 0.10.0 + prettier: + specifier: ^3.2.4 + version: 3.2.5 + tsup: + specifier: ^8.0.2 + version: 8.0.2(postcss@8.4.31)(ts-node@10.9.2)(typescript@4.9.5) + typescript: + specifier: 4.9.5 + version: 4.9.5 + vitest: + specifier: ^1.5.0 + version: 1.6.0(@types/node@18.19.33) + yargs: + specifier: ^17.4.1 + version: 17.7.2 + packages/cdk: dependencies: '@fern-fern/fern-cloud-sdk': @@ -621,9 +675,6 @@ importers: packages/fdr-sdk: dependencies: - '@fern-ui/core-utils': - specifier: workspace:* - version: link:../commons/core-utils dayjs: specifier: ^1.11.11 version: 1.11.11 @@ -633,15 +684,24 @@ importers: form-data: specifier: 4.0.0 version: 4.0.0 + formdata-node: + specifier: ^6.0.3 + version: 6.0.3 js-base64: specifier: 3.7.7 version: 3.7.7 + node-fetch: + specifier: 2.7.0 + version: 2.7.0 qs: specifier: 6.12.0 version: 6.12.0 tinycolor2: specifier: ^1.6.0 version: 1.6.0 + title: + specifier: ^3.5.3 + version: 3.5.3 url-join: specifier: 4.0.1 version: 4.0.1 @@ -661,27 +721,27 @@ importers: '@fern-platform/configs': specifier: workspace:* version: link:../configs + '@types/node-fetch': + specifier: 2.6.9 + version: 2.6.9 '@types/qs': specifier: 6.9.14 version: 6.9.14 '@types/tinycolor2': specifier: ^1.4.6 version: 1.4.6 + '@types/title': + specifier: ^3.4.3 + version: 3.4.3 '@types/url-join': specifier: 4.0.1 version: 4.0.1 eslint: specifier: ^8.56.0 version: 8.57.0 - eslint-config-custom: - specifier: '*' - version: 0.0.0(eslint@8.57.0)(typescript@5.4.3) prettier: specifier: ^3.2.4 version: 3.2.5 - tsconfig: - specifier: '*' - version: 7.0.0 typescript: specifier: 5.4.3 version: 5.4.3 @@ -689,60 +749,6 @@ importers: specifier: ^1.5.0 version: 1.6.0(@types/node@18.19.33) - packages/generator-cli: - devDependencies: - '@fern-api/fs-utils': - specifier: 0.15.0-rc63 - version: 0.15.0-rc63 - '@types/jest': - specifier: ^29.5.11 - version: 29.5.12 - '@types/lodash-es': - specifier: ^4.17.12 - version: 4.17.12 - '@types/node': - specifier: ^18.7.18 - version: 18.19.33 - '@types/yargs': - specifier: ^17.0.32 - version: 17.0.32 - '@yarnpkg/esbuild-plugin-pnp': - specifier: ^3.0.0-rc.15 - version: 3.0.0-rc.15(esbuild@0.20.2) - depcheck: - specifier: ^1.4.3 - version: 1.4.7 - esbuild: - specifier: 0.20.2 - version: 0.20.2 - eslint: - specifier: ^8.56.0 - version: 8.57.0 - execa: - specifier: ^5.1.1 - version: 5.1.1 - lodash-es: - specifier: ^4.17.12 - version: 4.17.21 - organize-imports-cli: - specifier: ^0.10.0 - version: 0.10.0 - prettier: - specifier: ^3.2.4 - version: 3.2.5 - tsup: - specifier: ^8.0.2 - version: 8.0.2(postcss@8.4.31)(ts-node@10.9.2)(typescript@4.9.5) - typescript: - specifier: 4.9.5 - version: 4.9.5 - vitest: - specifier: ^1.5.0 - version: 1.6.0(@types/node@18.19.33) - yargs: - specifier: ^17.4.1 - version: 17.7.2 - packages/healthchecks: devDependencies: '@fern-api/fdr-sdk': @@ -880,8 +886,6 @@ importers: specifier: 5.4.3 version: 5.4.3 - packages/template-resolver/dist/esm: {} - packages/ui/app: dependencies: '@datadog/browser-logs': @@ -1901,9 +1905,6 @@ importers: eslint: specifier: ^8.56.0 version: 8.57.0 - eslint-config-custom: - specifier: '*' - version: 0.0.0(eslint@8.57.0)(typescript@5.4.3) execa: specifier: ^5.1.1 version: 5.1.1 @@ -1916,9 +1917,6 @@ importers: prisma: specifier: 5.13.0 version: 5.13.0 - tsconfig: - specifier: '*' - version: 7.0.0 tsx: specifier: ^4.7.1 version: 4.9.3 @@ -5666,12 +5664,6 @@ packages: /@next/env@14.2.3: resolution: {integrity: sha512-W7fd7IbkfmeeY2gXrzJYDx8D2lWKbVoTIj1o1ScPHNzvp30s1AuoEFSdr39bC5sjxJaxTtq3OTCZboNp0lNWHA==} - /@next/eslint-plugin-next@12.3.4: - resolution: {integrity: sha512-BFwj8ykJY+zc1/jWANsDprDIu2MgwPOIKxNVnrKvPs+f5TPegrVnem8uScND+1veT4B7F6VeqgaNLFW1Hzl9Og==} - dependencies: - glob: 7.1.7 - dev: true - /@next/eslint-plugin-next@14.2.3: resolution: {integrity: sha512-L3oDricIIjgj1AVnRdRor21gI7mShlSwU/1ZGHmqM3LzHhXXhdkrfeNY5zif25Bi5Dd7fiJHsbhoZCHfXYvlAw==} dependencies: @@ -10894,26 +10886,6 @@ packages: - supports-color dev: true - /@typescript-eslint/parser@5.62.0(eslint@8.57.0)(typescript@5.4.3): - resolution: {integrity: sha512-VlJEV0fOQ7BExOsHYAGrgbEiZoi8D+Bl2+f6V2RrXerRSylnp+ZBHmPvaIa8cz0Ajx7WO7Z5RqfgYg7ED1nRhA==} - engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} - peerDependencies: - eslint: ^6.0.0 || ^7.0.0 || ^8.0.0 - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true - dependencies: - '@typescript-eslint/scope-manager': 5.62.0 - '@typescript-eslint/types': 5.62.0 - '@typescript-eslint/typescript-estree': 5.62.0(typescript@5.4.3) - debug: 4.3.4(supports-color@5.5.0) - eslint: 8.57.0 - typescript: 5.4.3 - transitivePeerDependencies: - - supports-color - dev: true - /@typescript-eslint/parser@7.2.0(eslint@8.57.0)(typescript@5.4.3): resolution: {integrity: sha512-5FKsVcHTk6TafQKQbuIVkXq58Fnbkd2wDL4LB7AURN7RUOu1utVP+G8+6u3ZhEroW3DF6hyo3ZEXxgKgp4KeCg==} engines: {node: ^16.0.0 || >=18.0.0} @@ -15033,44 +15005,6 @@ packages: source-map: 0.6.1 dev: true - /eslint-config-custom@0.0.0(eslint@8.57.0)(typescript@5.4.3): - resolution: {integrity: sha512-kwCw78yisbgKdJBJ5qooPmpBYDphDfM2oxSROmtfOwBXBwXuRiSV3suO01W3mVLEFpmQZxMWd/qajKpJhkKSug==} - dependencies: - eslint-config-next: 12.3.4(eslint@8.57.0)(typescript@5.4.3) - eslint-config-prettier: 8.10.0(eslint@8.57.0) - eslint-plugin-react: 7.28.0(eslint@8.57.0) - transitivePeerDependencies: - - eslint - - eslint-import-resolver-webpack - - supports-color - - typescript - dev: true - - /eslint-config-next@12.3.4(eslint@8.57.0)(typescript@5.4.3): - resolution: {integrity: sha512-WuT3gvgi7Bwz00AOmKGhOeqnyA5P29Cdyr0iVjLyfDbk+FANQKcOjFUTZIdyYfe5Tq1x4TGcmoe4CwctGvFjHQ==} - peerDependencies: - eslint: ^7.23.0 || ^8.0.0 - typescript: '>=3.3.1' - peerDependenciesMeta: - typescript: - optional: true - dependencies: - '@next/eslint-plugin-next': 12.3.4 - '@rushstack/eslint-patch': 1.10.2 - '@typescript-eslint/parser': 5.62.0(eslint@8.57.0)(typescript@5.4.3) - eslint: 8.57.0 - eslint-import-resolver-node: 0.3.9 - eslint-import-resolver-typescript: 2.7.1(eslint-plugin-import@2.29.1)(eslint@8.57.0) - eslint-plugin-import: 2.29.1(@typescript-eslint/parser@7.3.1)(eslint@8.57.0) - eslint-plugin-jsx-a11y: 6.8.0(eslint@8.57.0) - eslint-plugin-react: 7.34.1(eslint@8.57.0) - eslint-plugin-react-hooks: 4.6.2(eslint@8.57.0) - typescript: 5.4.3 - transitivePeerDependencies: - - eslint-import-resolver-webpack - - supports-color - dev: true - /eslint-config-next@14.2.3(eslint@8.57.0)(typescript@5.4.3): resolution: {integrity: sha512-ZkNztm3Q7hjqvB1rRlOX8P9E/cXRL9ajRcs8jufEtwMfTVYRqnmtnaSu57QqHyBlovMuiB8LEzfLBkh5RYV6Fg==} peerDependencies: @@ -15096,15 +15030,6 @@ packages: - supports-color dev: true - /eslint-config-prettier@8.10.0(eslint@8.57.0): - resolution: {integrity: sha512-SM8AMJdeQqRYT9O9zguiruQZaN7+z+E4eAP9oiLNGKMtomwaB1E9dcgUD6ZAn/eQAb52USbvezbiljfZUhbJcg==} - hasBin: true - peerDependencies: - eslint: '>=7.0.0' - dependencies: - eslint: 8.57.0 - dev: true - /eslint-config-prettier@9.1.0(eslint@8.57.0): resolution: {integrity: sha512-NSWl5BFQWEPi1j4TjVNItzYV7dZXZ+wP6I6ZhrBGpChQhZRUaElihE9uRRkcbRnNb76UMKDF3r+WTmNcGPKsqw==} hasBin: true @@ -15122,24 +15047,6 @@ packages: transitivePeerDependencies: - supports-color - /eslint-import-resolver-typescript@2.7.1(eslint-plugin-import@2.29.1)(eslint@8.57.0): - resolution: {integrity: sha512-00UbgGwV8bSgUv34igBDbTOtKhqoRMy9bFjNehT40bXg6585PNIct8HhXZ0SybqB9rWtXj9crcku8ndDn/gIqQ==} - engines: {node: '>=4'} - peerDependencies: - eslint: '*' - eslint-plugin-import: '*' - dependencies: - debug: 4.3.4(supports-color@5.5.0) - eslint: 8.57.0 - eslint-plugin-import: 2.29.1(@typescript-eslint/parser@7.3.1)(eslint@8.57.0) - glob: 7.2.3 - is-glob: 4.0.3 - resolve: 1.22.8 - tsconfig-paths: 3.15.0 - transitivePeerDependencies: - - supports-color - dev: true - /eslint-import-resolver-typescript@3.6.1(@typescript-eslint/parser@7.2.0)(eslint-import-resolver-node@0.3.9)(eslint-plugin-import@2.29.1)(eslint@8.57.0): resolution: {integrity: sha512-xgdptdoi5W3niYeuQxKmzVDTATvLYqhpwmykwsh7f6HIOStGWEIL9iqZgQDF9u9OEzrRwR8no5q2VT+bjAujTg==} engines: {node: ^14.18.0 || >=16.0.0} @@ -15353,29 +15260,6 @@ packages: dependencies: eslint: 8.57.0 - /eslint-plugin-react@7.28.0(eslint@8.57.0): - resolution: {integrity: sha512-IOlFIRHzWfEQQKcAD4iyYDndHwTQiCMcJVJjxempf203jnNLUnW34AXLrV33+nEXoifJE2ZEGmcjKPL8957eSw==} - engines: {node: '>=4'} - peerDependencies: - eslint: ^3 || ^4 || ^5 || ^6 || ^7 || ^8 - dependencies: - array-includes: 3.1.8 - array.prototype.flatmap: 1.3.2 - doctrine: 2.1.0 - eslint: 8.57.0 - estraverse: 5.3.0 - jsx-ast-utils: 3.3.5 - minimatch: 3.1.2 - object.entries: 1.1.8 - object.fromentries: 2.0.8 - object.hasown: 1.1.4 - object.values: 1.2.0 - prop-types: 15.8.1 - resolve: 2.0.0-next.5 - semver: 6.3.1 - string.prototype.matchall: 4.0.11 - dev: true - /eslint-plugin-react@7.34.1(eslint@8.57.0): resolution: {integrity: sha512-N97CxlouPT1AHt8Jn0mhhN2RrADlUAsk1/atcT2KyA/l9Q/E6ll7OIGwNumFmWfZ9skV3XXccYS19h80rHtgkw==} engines: {node: '>=4'} @@ -16279,6 +16163,11 @@ packages: web-streams-polyfill: 4.0.0-beta.3 dev: false + /formdata-node@6.0.3: + resolution: {integrity: sha512-8e1++BCiTzUno9v5IZ2J6bv4RU+3UKDmqWUQD0MIMVCd9AdhWkO1gw57oo1mNEX1dMq2EGI+FbWz4B92pscSQg==} + engines: {node: '>= 18'} + dev: false + /formidable@2.1.2: resolution: {integrity: sha512-CM3GuJ57US06mlpQ47YcunuUZ9jpm8Vx+P2CGt2j7HpgkKZO/DJYQ0Bobim8G6PFQmK5lOqOOdUXboU+h73A4g==} dependencies: @@ -16604,17 +16493,6 @@ packages: minipass: 7.1.1 path-scurry: 1.11.0 - /glob@7.1.7: - resolution: {integrity: sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==} - dependencies: - fs.realpath: 1.0.0 - inflight: 1.0.6 - inherits: 2.0.4 - minimatch: 3.1.2 - once: 1.4.0 - path-is-absolute: 1.0.1 - dev: true - /glob@7.2.3: resolution: {integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==} dependencies: @@ -25603,64 +25481,64 @@ packages: engines: {node: '>=0.6.11 <=0.7.0 || >=0.7.3'} dev: true - /turbo-darwin-64@1.13.3: - resolution: {integrity: sha512-glup8Qx1qEFB5jerAnXbS8WrL92OKyMmg5Hnd4PleLljAeYmx+cmmnsmLT7tpaVZIN58EAAwu8wHC6kIIqhbWA==} + /turbo-darwin-64@2.0.1: + resolution: {integrity: sha512-GO391pUmI6c6l/EpUIaXNzwbVDWRvYahm5oLB176dAWRYKYO+Osqs/XBdOM0G3l7ZFdR6nUtRJc8qinJp7qDUQ==} cpu: [x64] os: [darwin] requiresBuild: true dev: true optional: true - /turbo-darwin-arm64@1.13.3: - resolution: {integrity: sha512-/np2xD+f/+9qY8BVtuOQXRq5f9LehCFxamiQnwdqWm5iZmdjygC5T3uVSYuagVFsZKMvX3ycySwh8dylGTl6lg==} + /turbo-darwin-arm64@2.0.1: + resolution: {integrity: sha512-rmjJoxeq7nmH/F2aWKapahrDE2zE2Uc15rvs4Rz6qHOzSqC8R5uyLpQyTKIPIZ95O/z9nKfLfVPyiRENuk5vpw==} cpu: [arm64] os: [darwin] requiresBuild: true dev: true optional: true - /turbo-linux-64@1.13.3: - resolution: {integrity: sha512-G+HGrau54iAnbXLfl+N/PynqpDwi/uDzb6iM9hXEDG+yJnSJxaHMShhOkXYJPk9offm9prH33Khx2scXrYVW1g==} + /turbo-linux-64@2.0.1: + resolution: {integrity: sha512-vwTOc4v4jm6tM+9WlsiDlN+zwHP8A2wlsAYiNqz2u0DZL55aCWaVdivh2VpVLN36Mr9HgREGH0Fw+jx6ObcNRg==} cpu: [x64] os: [linux] requiresBuild: true dev: true optional: true - /turbo-linux-arm64@1.13.3: - resolution: {integrity: sha512-qWwEl5VR02NqRyl68/3pwp3c/olZuSp+vwlwrunuoNTm6JXGLG5pTeme4zoHNnk0qn4cCX7DFrOboArlYxv0wQ==} + /turbo-linux-arm64@2.0.1: + resolution: {integrity: sha512-DkVt76fjwY940DfmqznWhpYIlKYduvKAoTtylkERrDlcWUpDYWwqNbcf9PRRIbnjnv9lIxvuom1KZmMY+cw/Ig==} cpu: [arm64] os: [linux] requiresBuild: true dev: true optional: true - /turbo-windows-64@1.13.3: - resolution: {integrity: sha512-Nudr4bRChfJzBPzEmpVV85VwUYRCGKecwkBFpbp2a4NtrJ3+UP1VZES653ckqCu2FRyRuS0n03v9euMbAvzH+Q==} + /turbo-windows-64@2.0.1: + resolution: {integrity: sha512-XskV34kYuXVIHbRbgH8jr35Y8uA6kJOQ0LJStU4jFk7piiyk0a4n2GNDymMtvIwAxYdbuTe+pKuPCThFdirHBQ==} cpu: [x64] os: [win32] requiresBuild: true dev: true optional: true - /turbo-windows-arm64@1.13.3: - resolution: {integrity: sha512-ouJCgsVLd3icjRLmRvHQDDZnmGzT64GBupM1Y+TjtYn2LVaEBoV6hicFy8x5DUpnqdLy+YpCzRMkWlwhmkX7sQ==} + /turbo-windows-arm64@2.0.1: + resolution: {integrity: sha512-R2/RmKr2uQxkOCtXK5LNxdD3Iv7lUm56iy2FrDwTDgPI7X7K6WRjrxdirmFIu/fABYE5n6EampU3ejbG5mmGtg==} cpu: [arm64] os: [win32] requiresBuild: true dev: true optional: true - /turbo@1.13.3: - resolution: {integrity: sha512-n17HJv4F4CpsYTvKzUJhLbyewbXjq1oLCi90i5tW1TiWDz16ML1eDG7wi5dHaKxzh5efIM56SITnuVbMq5dk4g==} + /turbo@2.0.1: + resolution: {integrity: sha512-sJhxfBaN14pYj//xxAG6zAyStkE2j4HI9JVXVMob35SGob6dz/HuSqV/4QlVqw0uKAkwc1lXIsnykbe8RLmOOw==} hasBin: true optionalDependencies: - turbo-darwin-64: 1.13.3 - turbo-darwin-arm64: 1.13.3 - turbo-linux-64: 1.13.3 - turbo-linux-arm64: 1.13.3 - turbo-windows-64: 1.13.3 - turbo-windows-arm64: 1.13.3 + turbo-darwin-64: 2.0.1 + turbo-darwin-arm64: 2.0.1 + turbo-linux-64: 2.0.1 + turbo-linux-arm64: 2.0.1 + turbo-windows-64: 2.0.1 + turbo-windows-arm64: 2.0.1 dev: true /tween-functions@1.2.0: diff --git a/servers/fdr/Dockerfile b/servers/fdr/Dockerfile index b0820a226b..ec5ec83c7f 100644 --- a/servers/fdr/Dockerfile +++ b/servers/fdr/Dockerfile @@ -7,8 +7,7 @@ RUN apk update # Produce a pruned version of the monorepo WORKDIR /app -# Install pnpm -RUN npm install -g turbo +RUN npm install -g turbo@2.0.1 COPY . . RUN turbo prune @fern-platform/fdr --docker @@ -33,7 +32,9 @@ COPY --from=builder /app/out/full/ . COPY turbo.json turbo.json COPY shared shared COPY fern fern -RUN pnpm turbo run compile --filter=@fern-platform/fdr +RUN pnpm turbo --filter=@fern-api/fdr-sdk compile +RUN pnpm turbo --filter=@fern-platform/fdr codegen +RUN pnpm turbo --filter=@fern-platform/fdr compile FROM base AS runner WORKDIR /app @@ -45,4 +46,4 @@ ENV DATABASE_URL=$DATABASE_URL COPY --from=installer /app . -ENTRYPOINT ["/bin/sh", "/app/servers/fdr/scripts/run.sh"] +ENTRYPOINT ["/bin/sh", "/app/servers/fdr/scripts/run.sh"] \ No newline at end of file diff --git a/servers/fdr/package.json b/servers/fdr/package.json index fc2620a887..7e23096c27 100644 --- a/servers/fdr/package.json +++ b/servers/fdr/package.json @@ -59,13 +59,11 @@ "@yarnpkg/pnpify": "^4.0.1", "dotenv-cli": "^6.0.0", "eslint": "^8.56.0", - "eslint-config-custom": "*", "execa": "^5.1.1", "nodemon": "^3.0.0", "prettier": "^3.2.4", "prisma": "5.13.0", "redis": "^4.6.13", - "tsconfig": "*", "tsx": "^4.7.1", "typescript": "5.4.3", "vitest": "^1.5.0" @@ -87,7 +85,7 @@ "docker:local": "dotenv -e .env.test -- ./create_docker.sh local", "docker:dev": "dotenv -e .env.dev -- ./create_docker.sh", "docker:prod": "dotenv -e .env.prod -- ./create_docker.sh", - "test": "vitest src/__test__/unit-tests --globals", + "test": "vitest --run src/__test__/unit-tests --globals", "lint:eslint": "eslint --max-warnings 0 . --ignore-path=../../.eslintignore", "lint:eslint:fix": "pnpm lint:eslint --fix", "test:local": "dotenv -e .env.test -- vitest src/__test__/local --globals --config src/__test__/local/vitest.config.ts", diff --git a/servers/fdr/scripts/run.sh b/servers/fdr/scripts/run.sh index 58a34f47d7..9bbc9a1d86 100755 --- a/servers/fdr/scripts/run.sh +++ b/servers/fdr/scripts/run.sh @@ -1,4 +1,3 @@ #!/bin/sh -npm install -g prisma -prisma migrate deploy --schema /app/servers/fdr/prisma/schema.prisma -node --experimental-specifier-resolution=node /app/servers/fdr/dist/server.js \ No newline at end of file +prisma migrate deploy --schema /fdr/prisma/schema.prisma +node --experimental-specifier-resolution=node /fdr/dist/server.js \ No newline at end of file diff --git a/servers/fdr/src/__test__/local/util.ts b/servers/fdr/src/__test__/local/util.ts index 75d4cb4722..539ef3abb0 100644 --- a/servers/fdr/src/__test__/local/util.ts +++ b/servers/fdr/src/__test__/local/util.ts @@ -1,5 +1,4 @@ -import { APIV1Write, FdrClient } from "@fern-api/fdr-sdk"; -import { APIResponse } from "@fern-api/fdr-sdk/dist/client/generated/core"; +import { APIResponse, APIV1Write, FdrClient } from "@fern-api/fdr-sdk"; import type { DocsV2, IndexSegment } from "@prisma/client"; export function getUniqueDocsForUrl(prefix: string): string { diff --git a/servers/fdr/src/db/snippets/SnippetTemplate.ts b/servers/fdr/src/db/snippets/SnippetTemplate.ts index 88e4e54487..6ba6701bd4 100644 --- a/servers/fdr/src/db/snippets/SnippetTemplate.ts +++ b/servers/fdr/src/db/snippets/SnippetTemplate.ts @@ -10,7 +10,7 @@ import { SdkRequest, Template, } from "../../api/generated/api"; -import { readBuffer, writeBuffer } from "../../util"; +import { WithoutQuestionMarks, readBuffer, writeBuffer } from "../../util"; import { SdkDaoImpl, SdkPackage } from "../sdk/SdkDao"; import { SdkIdFactory } from "./SdkIdFactory"; import { @@ -156,15 +156,28 @@ export class SnippetTemplateDaoImpl implements SnippetTemplateDao { }): Promise { const sdkFromRequest = await getSdkFromSdkRequest(this.prisma, loadSnippetTemplateRequest.sdk); - const snippetTemplate = await this.prisma.snippetTemplate.findFirst({ - where: { - orgId: loadSnippetTemplateRequest.orgId, - apiName: loadSnippetTemplateRequest.apiId, - endpointPath: loadSnippetTemplateRequest.endpointId?.path, - endpointMethod: loadSnippetTemplateRequest.endpointId?.method, - sdkId: this.getSdkId(sdkFromRequest), - }, - }); + let snippetTemplate = null; + if (loadSnippetTemplateRequest.endpointId.identifierOverride != null) { + snippetTemplate = await this.prisma.snippetTemplate.findFirst({ + where: { + orgId: loadSnippetTemplateRequest.orgId, + apiName: loadSnippetTemplateRequest.apiId, + identifierOverride: loadSnippetTemplateRequest.endpointId.identifierOverride, + sdkId: this.getSdkId(sdkFromRequest), + }, + }); + } + if (snippetTemplate == null) { + snippetTemplate = await this.prisma.snippetTemplate.findFirst({ + where: { + orgId: loadSnippetTemplateRequest.orgId, + apiName: loadSnippetTemplateRequest.apiId, + endpointPath: loadSnippetTemplateRequest.endpointId?.path, + endpointMethod: loadSnippetTemplateRequest.endpointId?.method, + sdkId: this.getSdkId(sdkFromRequest), + }, + }); + } if (!snippetTemplate) { return null; @@ -173,6 +186,7 @@ export class SnippetTemplateDaoImpl implements SnippetTemplateDao { endpointId: { path: snippetTemplate.endpointPath, method: snippetTemplate.endpointMethod, + identifierOverride: snippetTemplate.identifierOverride ?? undefined, }, sdk: sdkFromRequest, snippetTemplate: { @@ -222,7 +236,7 @@ export class SnippetTemplateDaoImpl implements SnippetTemplateDao { const sdkDao = new SdkDaoImpl(this.prisma); await this.prisma.$transaction(async (tx) => { - const snippets: Prisma.Enumerable = []; + const snippets: Prisma.Enumerable> = []; const sdks: Prisma.Enumerable = []; storeSnippetsInfo.snippets.map(async (snippet) => { const sdkId = this.getSdkId(snippet.sdk); @@ -234,6 +248,7 @@ export class SnippetTemplateDaoImpl implements SnippetTemplateDao { apiDefinitionId: storeSnippetsInfo.apiDefinitionId, endpointPath: snippet.endpointId.path, endpointMethod: snippet.endpointId.method, + identifierOverride: snippet.endpointId.identifierOverride, sdkId, version: snippet.snippetTemplate.type, functionInvocation: writeBuffer(snippet.snippetTemplate.functionInvocation), diff --git a/servers/fdr/turbo.json b/servers/fdr/turbo.json index cc807bcb92..a902298336 100644 --- a/servers/fdr/turbo.json +++ b/servers/fdr/turbo.json @@ -1,7 +1,7 @@ { "$schema": "https://turbo.build/schema.json", "extends": ["//"], - "pipeline": { + "tasks": { "compile": { "outputs": ["dist/**"], "dependsOn": ["^build", "^compile", "codegen"] diff --git a/shared/.prettierignore b/shared/.prettierignore index 70e45f1598..24f927d4f8 100644 --- a/shared/.prettierignore +++ b/shared/.prettierignore @@ -24,3 +24,4 @@ clis/docs-migrator/src/__test__/fixtures/bland/api-reference/endpoint/call.mdx **/__test__/**/*.json **/__test__/fixtures/ **/__test__/outputs/ +.turbo diff --git a/turbo.json b/turbo.json index bc07845ca3..03026b6e38 100644 --- a/turbo.json +++ b/turbo.json @@ -1,6 +1,6 @@ { "$schema": "https://turbo.build/schema.json", - "pipeline": { + "tasks": { "build": { "outputs": ["dist/**", ".next/**", "!.next/cache/**"], "dependsOn": ["^build", "^compile", "codegen"]