@leadping/sdk 1.0.33 → 1.0.35

package/README.md

@@ -5,47 +5,77 @@
 
 # ![Leadping](https://leadping.ai/favicon.ico) Leadping TypeScript SDK
 
-Type-safe TypeScript client for the Leadping API.
+The official, type-safe TypeScript and JavaScript SDK for the Leadping API. Use it to integrate lead management, conversations, SMS and calling, automations, reporting, billing, and business settings into Node.js and server-side TypeScript applications.
 
-## Install
+The package is generated from the [Leadping OpenAPI specification](https://leadping.ai/docs/openapi.json) with Microsoft Kiota. It contains request builders and models; your application supplies the fetch request adapter, credentials, retry policy, and credential storage.
 
-```bash
-npm install @leadping/sdk
-```
+## Installation
 
-The generated client uses a Kiota request adapter. Install the default fetch adapter:
+Install the SDK and Kiota's fetch adapter:
 
 ```bash
-npm install @microsoft/kiota-http-fetchlibrary
+npm install @leadping/sdk @microsoft/kiota-http-fetchlibrary
 ```
 
-GitHub Packages is also available:
+The SDK package is `@leadping/sdk`. The similarly named `@leadpingai/sdk` package is only used when consuming releases from GitHub Packages.
 
-```bash
-npm config set @leadpingai:registry https://npm.pkg.github.com
-npm install @leadpingai/sdk
-```
+## Authentication
+
+Set `LEADPING_API_KEY` to a WorkOS organization API key (`sk_...`). The SDK sends it as `Authorization: Bearer <credential>`. User access tokens are also supported when acting for a signed-in user; `lp_src_...` keys are only for lead-ingestion endpoints. See [API authentication](https://leadping.ai/docs/api-authentication). Do not expose organization or source keys in browser code.
+
+## Create a client
 
-## Use
+Kiota's API-key authentication provider can place the complete Bearer value in the `Authorization` header:
 
 ```ts
 import { createLeadpingOpenApiClient } from "@leadping/sdk";
-
-const adapter = createLeadpingRequestAdapter();
+import {
+  ApiKeyAuthenticationProvider,
+  ApiKeyLocation,
+} from "@microsoft/kiota-abstractions";
+import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
+
+const credential = process.env.LEADPING_API_KEY;
+if (!credential) {
+  throw new Error("LEADPING_API_KEY is not set.");
+}
+
+const authProvider = new ApiKeyAuthenticationProvider(
+  `Bearer ${credential}`,
+  "Authorization",
+  ApiKeyLocation.Header,
+  new Set(["api.leadping.ai"]),
+);
+
+const adapter = new FetchRequestAdapter(authProvider);
 const client = createLeadpingOpenApiClient(adapter);
 
-const me = await client.users.me.get();
+const lead = await client.leads.byId("lead-id").get();
+console.log(lead?.id);
 ```
 
-`createLeadpingRequestAdapter` is application code. Configure it to send one of:
+The client defaults to `https://api.leadping.ai`.
+
+## Common operations
+
+Request builders mirror the API path. Methods such as `byId()` select a resource; terminal methods send the request.
 
-- `Authorization: Bearer <token>`
-- `X-Leadping-Api-Key: <key>`
+```ts
+// Requires a user access token.
+const currentUser = await client.users.me.get();
+
+// Retrieve organization resources by ID.
+const source = await client.sources.byId("source-id").get();
+const lead = await client.leads.byId("lead-id").get();
+```
 
-The client defaults to `https://api.leadping.ai` when the adapter does not already have a base URL.
+Create and update operations accept generated request-body types exported by `@leadping/sdk`.
 
-## Links
+## Resources
 
-- [Documentation](https://leadping.ai/docs)
+- [Leadping introduction](https://leadping.ai/docs/introduction)
+- [API authentication](https://leadping.ai/docs/api-authentication)
 - [API reference](https://leadping.ai/docs/api-reference)
+- [OpenAPI specification](https://leadping.ai/docs/openapi.json)
+- [npm package](https://www.npmjs.com/package/@leadping/sdk)
 - [License](LICENSE)

package/dist/analytics/my/index.d.ts

@@ -27,7 +27,7 @@ export interface MyRequestBuilderGetQueryParameters {
     /**
      * Optional number of recent days to include when explicit timestamps are not supplied.
      */
-    days?: number;
+    days?: string;
     /**
      * Optional exclusive end timestamp for the analytics period.
      */

package/dist/leads/intake/index.d.ts

@@ -64,7 +64,7 @@ export interface IntakeRequestBuilderGetQueryParameters {
     /**
      * Direct-post price supplied by the lead source during intake.
      */
-    directPostPrice?: number;
+    directPostPrice?: string;
     /**
      * Email address for the person represented by this lead intake request.
      */
@@ -104,7 +104,7 @@ export interface IntakeRequestBuilderGetQueryParameters {
     /**
      * Lead price or transaction price supplied to the Leadping API.
      */
-    price?: number;
+    price?: string;
     /**
      * Product or offer associated with the lead or source.
      */