@spyglasshq/sdk 0.1.2 → 0.1.4

package/README.md

@@ -48,7 +48,7 @@
   - [Discover Creators](#3-discover-creators)
   - [Creative Insights & Landing Pages](#4-creative-insights--landing-pages)
   - [Post Comments](#5-post-comments)
-  - [Index a New Brand](#6-index-a-new-brand)
+  - [Index a New Account](#6-index-a-new-account)
   - [Check Team Credit Usage](#7-check-team-credit-usage)
 - [API Reference Overview](#api-reference-overview)
 - [TypeScript Types](#typescript-types)
@@ -86,7 +86,7 @@ const client = new Spyglass({
 });
 
 // 1. Resolve a brand by name
-const { brands } = await client.search.brands({
+const { brands } = await client.searchBrands({
   names: ["Nike"],
   limit: 1,
 });
@@ -95,7 +95,7 @@ const brand = brands[0];
 
 if (brand) {
   // 2. Search the creatives that brand is running
-  const { media } = await client.search.getMedia({
+  const { media } = await client.searchMedia({
     brandId: brand.id,
     query: "marathon running shoes comfort",
     limit: 10,
@@ -124,13 +124,13 @@ Search advertisers by name (`names`), social handle (`igUsername`, `tiktokUserna
 
 ```ts
 // Fuzzy name lookup
-const byName = await client.search.brands({
+const byName = await client.searchBrands({
   names: ["Athletic Greens", "AG1"],
   limit: 5,
 });
 
 // Natural-language discovery
-const byBrief = await client.search.brands({
+const byBrief = await client.searchBrands({
   query: "DTC electrolyte and hydration powder brands",
   limit: 10,
 });
@@ -142,16 +142,16 @@ Pass `brandId` to inspect a specific brand or creator's creatives, or omit `bran
 
 ```ts
 // Optional: look up valid product taxonomy paths first (free call)
-const { taxonomies } = await client.search.taxonomies({
+const { paths } = await client.searchTaxonomies({
   query: "running shoes",
 });
 
-const { media, count } = await client.search.getMedia({
+const { media, count } = await client.searchMedia({
   query: "UGC founder story explaining product benefits",
   channel: ["META_AD", "TIKTOK"],
   format: ["VIDEO"],
   status: "ACTIVE",
-  taxonomy: taxonomies.slice(0, 2),
+  taxonomy: paths.slice(0, 2),
   minDaysRun: 14,
   limit: 20,
   offset: 0,
@@ -168,23 +168,23 @@ Each item in `media` includes creative intelligence extracted by Spyglass:
 Search creators by handle, name, or natural-language brief, and filter by demographic and profile attributes (`gender`, `ageRange`, `ethnicity`, `location`, `language`):
 
 ```ts
-const { creators } = await client.search.creators({
+const { creators } = await client.searchCreators({
   query: "skincare routine and dermatology tips",
   gender: "female",
-  ageRange: ["25-34"],
-  location: ["US"],
-  language: ["en"],
+  ageRange: "25-34",
+  location: "United States",
+  language: "English",
   limit: 20,
 });
 ```
 
 ### 4. Creative Insights & Landing Pages
 
-Pull clustered creative themes (`HOOK`, `USP`, `PERSONA`, `MEDIA_MIX`) and ranked destination landing pages for any brand:
+Pull clustered creative themes (`HOOK`, `USP`, `PERSONA`, `MEDIA_MIX`) and ranked destination landing pages for any account:
 
 ```ts
 // Ranked hooks + weekly volume breakdown over the last 90 days
-const insights = await client.search.getBrandMediaInsights({
+const insights = await client.account.insights({
   id: brand.id,
   type: "HOOK",
   maxDaysBack: 90,
@@ -192,7 +192,7 @@ const insights = await client.search.getBrandMediaInsights({
 });
 
 // Top landing pages where the brand sends ad traffic
-const { landingPages } = await client.search.getBrandLandingPages({
+const { landingPages } = await client.account.landingPages({
   id: brand.id,
   showInactive: "false",
   limit: 20,
@@ -204,19 +204,19 @@ const { landingPages } = await client.search.getBrandLandingPages({
 Fetch public comments from Instagram posts/reels (by shortcode or URL) and TikTok videos (by video ID or URL):
 
 ```ts
-const { posts } = await client.search.getComments({
+const { posts } = await client.getComments({
   instagramIds: ["https://www.instagram.com/reel/C2xY9abcD1e/"],
   tiktokIds: ["https://www.tiktok.com/@nike/video/7234567890123456789"],
   limit: 1, // comment pages per post
 });
 ```
 
-### 6. Index a New Brand
+### 6. Index a New Account
 
-If Spyglass doesn't have a brand yet, submit its website or social profile URL (`POST /account/index` is free) and poll until `status` is `"ready"`:
+If Spyglass doesn't have a brand or creator yet, submit its website or social profile URL (`POST /account/index` is free) and poll until `status` is `"ready"`:
 
 ```ts
-const indexed = await client.indexing.indexBrand({
+const indexed = await client.account.index({
   websiteUrl: "https://www.on.com",
 });
 
@@ -224,12 +224,12 @@ const indexed = await client.indexing.indexBrand({
 let status = indexed.status;
 while (status === "indexing") {
   await new Promise((resolve) => setTimeout(resolve, 3000));
-  const check = await client.indexing.indexBrandStatus({ id: indexed.brandId });
+  const check = await client.account.indexStatus({ id: indexed.brandId });
   status = check.status;
 }
 
 if (status === "ready" || status === "already_exists") {
-  const account = await client.search.getAccount({ id: indexed.brandId });
+  const account = await client.account.get({ id: indexed.brandId });
   console.log("Indexed account:", account.name);
 }
 ```
@@ -239,7 +239,7 @@ if (status === "ready" || status === "already_exists") {
 Check your team's remaining monthly credits and current billing window (free call):
 
 ```ts
-const usage = await client.account.getCreditUsage();
+const usage = await client.getCreditUsage();
 console.log(`Remaining: ${usage.remainingCredits} / ${usage.planCredits}`);
 ```
 
@@ -249,17 +249,17 @@ console.log(`Remaining: ${usage.remainingCredits} / ${usage.planCredits}`);
 
 | SDK Method | HTTP Endpoint | Cost | Rate Limit |
 | --- | --- | --- | --- |
-| `client.search.brands(req)` | `POST /brands` | $0.0020 / brand returned | 120 / min |
-| `client.search.creators(req)` | `POST /creators` | $0.0020 / creator returned | 120 / min |
-| `client.search.getAccount({ id })` | `GET /account/{id}` | $0.0020 / account returned | 120 / min |
-| `client.search.getMedia(req)` | `POST /media` | $0.0010 / creative returned | 120 / min |
-| `client.search.taxonomies({ query })` | `GET /taxonomies` | Free | 120 / min |
-| `client.search.getBrandMediaInsights(req)` | `GET /account/{id}/insights` | $0.0010 / cluster returned | 120 / min |
-| `client.search.getBrandLandingPages(req)` | `GET /account/{id}/landing-pages` | $0.0050 / landing page returned | 120 / min |
-| `client.search.getComments(req)` | `POST /comments` | $0.0100 / live page fetched | 20 / min |
-| `client.indexing.indexBrand(req)` | `POST /account/index` | Free | 50 / min |
-| `client.indexing.indexBrandStatus({ id })` | `GET /account/{id}/index-status` | Free | 300 / min |
-| `client.account.getCreditUsage()` | `GET /team/credit-usage` | Free | 120 / min |
+| `client.searchBrands(req)` | `POST /brands` | $0.0020 / brand returned | 120 / min |
+| `client.searchCreators(req)` | `POST /creators` | $0.0020 / creator returned | 120 / min |
+| `client.searchMedia(req)` | `POST /media` | $0.0010 / creative returned | 120 / min |
+| `client.searchTaxonomies({ query })` | `GET /taxonomies` | Free | 120 / min |
+| `client.getComments(req)` | `POST /comments` | $0.0100 / live page fetched | 20 / min |
+| `client.account.get({ id })` | `GET /account/{id}` | $0.0020 / account returned | 120 / min |
+| `client.account.insights(req)` | `GET /account/{id}/insights` | $0.0010 / cluster returned | 120 / min |
+| `client.account.landingPages(req)` | `GET /account/{id}/landing-pages` | $0.0050 / landing page returned | 120 / min |
+| `client.account.index(req)` | `POST /account/index` | Free | 50 / min |
+| `client.account.indexStatus({ id })` | `GET /account/{id}/index-status` | Free | 300 / min |
+| `client.getCreditUsage()` | `GET /team/credit-usage` | Free | 120 / min |
 
 Full method signatures and parameter types are available in [`reference.md`](https://github.com/spyglass-so/spyglass-typescript/blob/main/reference.md) and at [docs.spyglass.so](https://docs.spyglass.so).
 
@@ -272,13 +272,13 @@ All request and response types are exported under the `spyglass` namespace:
 ```ts
 import { spyglass } from "@spyglasshq/sdk";
 
-const request: spyglass.GetMediaRequest = {
+const request: spyglass.SearchMediaRequest = {
   query: "summer sale",
   channel: ["META_AD"],
   limit: 25,
 };
 
-type MediaItem = spyglass.GetMediaResponse.Media.Item;
+type MediaItem = spyglass.SearchMediaResponse.Media.Item;
 ```
 
 ## Error Handling
@@ -289,7 +289,7 @@ When the API returns a non-2xx status code (`400`, `401`, `402` out of credits,
 import { SpyglassError } from "@spyglasshq/sdk";
 
 try {
-  await client.search.brands({ names: ["Nike"], limit: 5 });
+  await client.searchBrands({ names: ["Nike"], limit: 5 });
 } catch (err) {
   if (err instanceof SpyglassError) {
     console.error("Status:", err.statusCode);
@@ -310,7 +310,7 @@ The SDK defaults to a **60-second timeout** and **2 automatic retries** with exp
 ```ts
 const controller = new AbortController();
 
-const response = await client.search.getMedia(
+const response = await client.searchMedia(
   { query: "protein bar", limit: 10 },
   {
     timeoutInSeconds: 30,
@@ -326,8 +326,8 @@ const response = await client.search.getMedia(
 Chain `.withRawResponse()` on any request promise to inspect HTTP status codes and headers alongside parsed data:
 
 ```ts
-const { data, rawResponse } = await client.search
-  .brands({ names: ["Nike"], limit: 1 })
+const { data, rawResponse } = await client
+  .searchBrands({ names: ["Nike"], limit: 1 })
   .withRawResponse();
 
 console.log(data.brands);
@@ -336,11 +336,9 @@ console.log(rawResponse.headers.get("retry-after"));
 
 ### Tree-Shakeable Subpackage Imports
 
-Import individual resource clients directly for minimal bundle sizes:
+Import the `account` resource client directly for minimal bundle sizes:
 
 ```ts
-import { SearchClient } from "@spyglasshq/sdk/search";
-import { IndexingClient } from "@spyglasshq/sdk/indexing";
 import { AccountClient } from "@spyglasshq/sdk/account";
 ```
 

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@spyglasshq/sdk",
-        "X-Fern-SDK-Version": "0.1.2",
-        "User-Agent": "@spyglasshq/sdk/0.1.2",
+        "X-Fern-SDK-Version": "0.1.3",
+        "User-Agent": "@spyglasshq/sdk/0.1.3",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/Client.d.ts

@@ -1,6 +1,5 @@
+import * as spyglass from "./api/index.js";
 import { AccountClient } from "./api/resources/account/client/Client.js";
-import { IndexingClient } from "./api/resources/indexing/client/Client.js";
-import { SearchClient } from "./api/resources/search/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
 import * as core from "./core/index.js";
@@ -11,13 +10,265 @@ export declare namespace Spyglass {
 }
 export declare class Spyglass {
     protected readonly _options: NormalizedClientOptionsWithAuth<Spyglass.Options>;
-    protected _search: SearchClient | undefined;
     protected _account: AccountClient | undefined;
-    protected _indexing: IndexingClient | undefined;
     constructor(options: Spyglass.Options);
-    get search(): SearchClient;
     get account(): AccountClient;
-    get indexing(): IndexingClient;
+    /**
+     * Find brands.
+     * Search semantically with `query`, or look them up by name, id, or
+     * social handle. Either way, you can also narrow the results with
+     * filters such as product taxonomy, location, and follower count.
+     *
+     * Send one search field. Each field is its own mode:
+     *
+     * - **Query** (`query`). A natural-language brief. Runs a language model and
+     *   ranks by relevance, so `sortBy` is ignored. Bills at least one row even
+     *   when nothing matches.
+     * - **Name** (`names`). Fuzzy-matches account names (a case-insensitive contains
+     *   match). Pass every name in one array.
+     * - **ID** (`brandIds`). Looks up known ids. Missing ids are omitted and listed
+     *   in `unmatchedIds`. `limit` and `offset` are ignored.
+     * - **Instagram** (`igUsername`). Case-insensitive contains match on the
+     *   handle. A leading `@` is ignored.
+     * - **TikTok** (`tiktokUsername`). Same match on the TikTok handle.
+     *
+     * If a request includes more than one of these fields, only the highest
+     * priority field is used. The rest are ignored:
+     *
+     * 1. `brandIds`
+     * 2. `igUsername` or `tiktokUsername` (if both are set, either handle can match)
+     * 3. `names`
+     * 4. `query`
+     *
+     * One exception: `query` together with `names` uses both. `names` narrows the
+     * set, and `query` ranks inside it.
+     *
+     * `limit` (default 20, max 100) caps the rows returned, and the cost, for
+     * every mode except ID.
+     *
+     * Limited to 120 requests per minute per user.
+     * Costs 2,000 microdollars ($0.0020) per brand returned, charged against your plan's monthly credits. The count field is what you were charged for.
+     * A `query` search runs a language model, so it bills a minimum of one
+     * row even when nothing matches.
+     *
+     * @param {spyglass.SearchBrandsRequest} request
+     * @param {Spyglass.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link spyglass.BadRequestError}
+     * @throws {@link spyglass.UnauthorizedError}
+     * @throws {@link spyglass.PaymentRequiredError}
+     * @throws {@link spyglass.ForbiddenError}
+     * @throws {@link spyglass.MethodNotAllowedError}
+     * @throws {@link spyglass.ContentTooLargeError}
+     * @throws {@link spyglass.TooManyRequestsError}
+     * @throws {@link spyglass.InternalServerError}
+     * @throws {@link errors.SpyglassError}
+     * @throws {@link errors.SpyglassTimeoutError}
+     *
+     * @example
+     *     await client.searchBrands({
+     *         names: ["Nike"],
+     *         limit: 3
+     *     })
+     */
+    searchBrands(request?: spyglass.SearchBrandsRequest, requestOptions?: Spyglass.RequestOptions): core.HttpResponsePromise<spyglass.SearchBrandsResponse>;
+    private __searchBrands;
+    /**
+     * Find creators.
+     * Search semantically with `query`, or look them up by name, id, or
+     * social handle. Either way, you can also narrow the results with
+     * filters such as audience profile, location, and follower count.
+     *
+     * Send one search field. Each field is its own mode:
+     *
+     * - **Query** (`query`). A natural-language brief. Runs a language model and
+     *   ranks by relevance, so `sortBy` is ignored. Bills at least one row even
+     *   when nothing matches.
+     * - **Name** (`names`). Fuzzy-matches account names (a case-insensitive contains
+     *   match). Pass every name in one array.
+     * - **ID** (`brandIds`). Looks up known ids. Missing ids are omitted and listed
+     *   in `unmatchedIds`. `limit` and `offset` are ignored.
+     * - **Instagram** (`igUsername`). Case-insensitive contains match on the
+     *   handle. A leading `@` is ignored.
+     * - **TikTok** (`tiktokUsername`). Same match on the TikTok handle.
+     *
+     * If a request includes more than one of these fields, only the highest
+     * priority field is used. The rest are ignored:
+     *
+     * 1. `brandIds`
+     * 2. `igUsername` or `tiktokUsername` (if both are set, either handle can match)
+     * 3. `names`
+     * 4. `query`
+     *
+     * One exception: `query` together with `names` uses both. `names` narrows the
+     * set, and `query` ranks inside it.
+     *
+     * `limit` (default 20, max 100) caps the rows returned, and the cost, for
+     * every mode except ID.
+     *
+     * Limited to 120 requests per minute per user.
+     * Costs 2,000 microdollars ($0.0020) per creator returned, charged against your plan's monthly credits. The count field is what you were charged for.
+     * A `query` search runs a language model, so it bills a minimum of one
+     * row even when nothing matches.
+     *
+     * @param {spyglass.SearchCreatorsRequest} request
+     * @param {Spyglass.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link spyglass.BadRequestError}
+     * @throws {@link spyglass.UnauthorizedError}
+     * @throws {@link spyglass.PaymentRequiredError}
+     * @throws {@link spyglass.ForbiddenError}
+     * @throws {@link spyglass.MethodNotAllowedError}
+     * @throws {@link spyglass.ContentTooLargeError}
+     * @throws {@link spyglass.TooManyRequestsError}
+     * @throws {@link spyglass.InternalServerError}
+     * @throws {@link errors.SpyglassError}
+     * @throws {@link errors.SpyglassTimeoutError}
+     *
+     * @example
+     *     await client.searchCreators({
+     *         igUsername: "charlidamelio",
+     *         limit: 3,
+     *         gender: "female"
+     *     })
+     */
+    searchCreators(request?: spyglass.SearchCreatorsRequest, requestOptions?: Spyglass.RequestOptions): core.HttpResponsePromise<spyglass.SearchCreatorsResponse>;
+    private __searchCreators;
+    /**
+     * Find taxonomy paths you can pass to POST /media as `taxonomy`.
+     * `query` is a product or category phrase. Each path is a string
+     * such as `Apparel > Footwear > Sneakers`.
+     *
+     * Limited to 120 requests per minute per user.
+     * This call is free and does not use credits.
+     *
+     * @param {spyglass.SearchTaxonomiesRequest} request
+     * @param {Spyglass.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link spyglass.BadRequestError}
+     * @throws {@link spyglass.UnauthorizedError}
+     * @throws {@link spyglass.PaymentRequiredError}
+     * @throws {@link spyglass.ForbiddenError}
+     * @throws {@link spyglass.MethodNotAllowedError}
+     * @throws {@link spyglass.TooManyRequestsError}
+     * @throws {@link spyglass.InternalServerError}
+     * @throws {@link errors.SpyglassError}
+     * @throws {@link errors.SpyglassTimeoutError}
+     *
+     * @example
+     *     await client.searchTaxonomies({
+     *         query: "running shoes"
+     *     })
+     */
+    searchTaxonomies(request: spyglass.SearchTaxonomiesRequest, requestOptions?: Spyglass.RequestOptions): core.HttpResponsePromise<spyglass.SearchTaxonomiesResponse>;
+    private __searchTaxonomies;
+    /**
+     * Return creatives. Pass `brandId` to scope to one brand or creator,
+     * or omit it to search the whole corpus. Without `brandId`,
+     * `query` is required.
+     *
+     * Limited to 120 requests per minute per user.
+     * Costs 1,000 microdollars ($0.0010) per creative returned, charged against your plan's monthly credits. The count field is what you were charged for.
+     * The call bills a minimum of one row even when nothing matches. In that
+     * case `count` is 0 but you are charged for one row.
+     *
+     * @param {spyglass.SearchMediaRequest} request
+     * @param {Spyglass.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link spyglass.BadRequestError}
+     * @throws {@link spyglass.UnauthorizedError}
+     * @throws {@link spyglass.PaymentRequiredError}
+     * @throws {@link spyglass.ForbiddenError}
+     * @throws {@link spyglass.NotFoundError}
+     * @throws {@link spyglass.MethodNotAllowedError}
+     * @throws {@link spyglass.ContentTooLargeError}
+     * @throws {@link spyglass.TooManyRequestsError}
+     * @throws {@link spyglass.InternalServerError}
+     * @throws {@link errors.SpyglassError}
+     * @throws {@link errors.SpyglassTimeoutError}
+     *
+     * @example
+     *     await client.searchMedia({
+     *         query: "comfort-focused video ads",
+     *         limit: 20
+     *     })
+     */
+    searchMedia(request?: spyglass.SearchMediaRequest, requestOptions?: Spyglass.RequestOptions): core.HttpResponsePromise<spyglass.SearchMediaResponse>;
+    private __searchMedia;
+    /**
+     * Credits left on the API key's team, the credits included in the
+     * plan, and the current billing period. Granted credits count toward
+     * `remainingCredits` and not `planCredits`.
+     *
+     * Limited to 120 requests per minute per user.
+     * This call is free and does not use credits. It still responds when
+     * the team is out of credits.
+     *
+     * @param {Spyglass.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link spyglass.BadRequestError}
+     * @throws {@link spyglass.UnauthorizedError}
+     * @throws {@link spyglass.PaymentRequiredError}
+     * @throws {@link spyglass.ForbiddenError}
+     * @throws {@link spyglass.MethodNotAllowedError}
+     * @throws {@link spyglass.TooManyRequestsError}
+     * @throws {@link spyglass.InternalServerError}
+     * @throws {@link errors.SpyglassError}
+     * @throws {@link errors.SpyglassTimeoutError}
+     *
+     * @example
+     *     await client.getCreditUsage()
+     */
+    getCreditUsage(requestOptions?: Spyglass.RequestOptions): core.HttpResponsePromise<spyglass.GetCreditUsageResponse>;
+    private __getCreditUsage;
+    /**
+     * Return public comments for specific Instagram or TikTok posts.
+     * Pass post URLs or the platform id. At least one of `instagramIds` or
+     * `tiktokIds` is required (max 20 each). `limit` is comment pages
+     * per post (default 1, max 20).
+     *
+     * Instagram accepts a shortcode or a post URL:
+     *
+     * - `C2xY9abcD1e`
+     * - `https://www.instagram.com/p/C2xY9abcD1e/`
+     * - `https://www.instagram.com/reel/C2xY9abcD1e/`
+     *
+     * TikTok accepts a video id or a post URL:
+     *
+     * - `7234567890123456789`
+     * - `https://www.tiktok.com/@nike/video/7234567890123456789`
+     *
+     * Recent posts may be scraped live; older posts with stored comments
+     * are served from cache.
+     *
+     * Limited to 20 requests per minute per user.
+     * Costs 10,000 microdollars ($0.0100) per successful page of comments returned, charged against your plan's monthly credits.
+     * Each comment page fetched live (`limit`, default 1) is one billed
+     * unit. Cached posts do not scrape and are not billed.
+     *
+     * @param {spyglass.GetCommentsRequest} request
+     * @param {Spyglass.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link spyglass.BadRequestError}
+     * @throws {@link spyglass.UnauthorizedError}
+     * @throws {@link spyglass.PaymentRequiredError}
+     * @throws {@link spyglass.ForbiddenError}
+     * @throws {@link spyglass.MethodNotAllowedError}
+     * @throws {@link spyglass.ContentTooLargeError}
+     * @throws {@link spyglass.TooManyRequestsError}
+     * @throws {@link spyglass.InternalServerError}
+     * @throws {@link errors.SpyglassError}
+     * @throws {@link errors.SpyglassTimeoutError}
+     *
+     * @example
+     *     await client.getComments({
+     *         instagramIds: ["https://www.instagram.com/p/C2xY9abcD1e/"],
+     *         tiktokIds: ["https://www.tiktok.com/@nike/video/7234567890123456789"],
+     *         limit: 1
+     *     })
+     */
+    getComments(request?: spyglass.GetCommentsRequest, requestOptions?: Spyglass.RequestOptions): core.HttpResponsePromise<spyglass.GetCommentsResponse>;
+    private __getComments;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.