@brandazine/solari-sdk 0.2.8 → 0.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2,7 +2,7 @@ import type { SolariToolMap, SolariToolName, SolariTools, SolariToolsWithoutRequ
2
2
  export * from "./tools.generated.js";
3
3
  export declare const DEFAULT_BASE_URL = "https://solari.sh";
4
4
  export declare const API_PREFIX = "/mcp/api/v1";
5
- export declare const SDK_VERSION = "0.2.8";
5
+ export declare const SDK_VERSION = "0.2.9";
6
6
  export declare const TOKEN_ENV = "SOLARI_TOKEN";
7
7
  export interface SolariTool {
8
8
  name: string;
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  export * from "./tools.generated.js";
2
2
  export const DEFAULT_BASE_URL = "https://solari.sh";
3
3
  export const API_PREFIX = "/mcp/api/v1";
4
- export const SDK_VERSION = "0.2.8";
4
+ export const SDK_VERSION = "0.2.9";
5
5
  export const TOKEN_ENV = "SOLARI_TOKEN";
6
6
  const DEFAULT_TIMEOUT_MS = 150_000;
7
7
  export class SolariError extends Error {
@@ -1,4 +1,4 @@
1
- /** Recorded profile values of one collected Instagram account over time, for follower growth and trend comparisons. points lists follower_count, following_count, post_count, is_verified, and is_private, oldest first, each with captured_at: the moment the catalog collected those values. current holds the catalog's current values, and current.collected_at says when the profile was last collected from Instagram; check it before treating the numbers as today's. granularity=day (default) keeps the last point of each UTC day; all returns every recorded point. The range is since/until (UTC dates, inclusive) and defaults to the last 90 days; truncated=true means older points were dropped, so narrow since. Points exist only when the account was collected, so gaps are normal, and most accounts have no points between late August 2025 and late September 2026. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_account first, which cannot backfill past values. Works with any signed-in SOLARI account. */
1
+ /** Recorded profile values of one collected Instagram account over time, for follower growth and trend comparisons. points lists follower_count, following_count, post_count, is_verified, and is_private, oldest first, each with captured_at: the moment the catalog collected those values. current holds the catalog's current values, and current.collected_at says when the profile was last collected from Instagram; check it before treating the numbers as today's. granularity=day (default) keeps the last point of each UTC day; all returns every recorded point. The range is since/until (UTC dates, inclusive) and defaults to the last 90 days; truncated=true means older points were dropped, so narrow since. Points exist only when the account was collected, so gaps are normal, and most accounts have no points from 2025-08-26 to 2025-09-27. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_account first, which cannot backfill past values. Works with any signed-in SOLARI account. */
2
2
  export interface CatalogInstagramAccountHistoryArgs {
3
3
  /** account_id of the account (SOLARI account UUID). Provide this or username. */
4
4
  "account_id"?: string | undefined;
@@ -749,7 +749,7 @@ export interface SolariTools {
749
749
  catalog: {
750
750
  instagram: {
751
751
  account: {
752
- /** Recorded profile values of one collected Instagram account over time, for follower growth and trend comparisons. points lists follower_count, following_count, post_count, is_verified, and is_private, oldest first, each with captured_at: the moment the catalog collected those values. current holds the catalog's current values, and current.collected_at says when the profile was last collected from Instagram; check it before treating the numbers as today's. granularity=day (default) keeps the last point of each UTC day; all returns every recorded point. The range is since/until (UTC dates, inclusive) and defaults to the last 90 days; truncated=true means older points were dropped, so narrow since. Points exist only when the account was collected, so gaps are normal, and most accounts have no points between late August 2025 and late September 2026. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_account first, which cannot backfill past values. Works with any signed-in SOLARI account. */
752
+ /** Recorded profile values of one collected Instagram account over time, for follower growth and trend comparisons. points lists follower_count, following_count, post_count, is_verified, and is_private, oldest first, each with captured_at: the moment the catalog collected those values. current holds the catalog's current values, and current.collected_at says when the profile was last collected from Instagram; check it before treating the numbers as today's. granularity=day (default) keeps the last point of each UTC day; all returns every recorded point. The range is since/until (UTC dates, inclusive) and defaults to the last 90 days; truncated=true means older points were dropped, so narrow since. Points exist only when the account was collected, so gaps are normal, and most accounts have no points from 2025-08-26 to 2025-09-27. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_account first, which cannot backfill past values. Works with any signed-in SOLARI account. */
753
753
  history<T = unknown>(args?: CatalogInstagramAccountHistoryArgs): Promise<T>;
754
754
  /** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. posts_collected_at is how far the stored posts reach, stored_post_count against profile_post_count shows whether collection is incomplete, and refreshes_regularly says whether the account is re-collected on a schedule; when the requested dates run past posts_collected_at, note explains that later posts are not in the catalog yet — an empty result then does not mean the account posted nothing, so call solari_fetch_instagram_posts to re-collect it. This reads the catalog only; found=false means the handle is not in the catalog (note says when Instagram no longer has it) — call solari_fetch_instagram_posts with that username first. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
755
755
  posts<T = unknown>(args?: CatalogInstagramAccountPostsArgs): Promise<T>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brandazine/solari-sdk",
3
- "version": "0.2.8",
3
+ "version": "0.2.9",
4
4
  "description": "TypeScript client for the SOLARI API — creator and brand intelligence across Instagram and TikTok, plus Meta Threads profiles and posts.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://solari.sh/api",