@nodaro/sdk 2.29.0 → 2.32.0

package/dist/entries/community.d.cts

@@ -0,0 +1,87 @@
+import { BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from '@nodaro/shared/apps';
+export { BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, CommunityCard, CommunityEntityType, CommunityFullDetail, CommunityReportReason, CommunitySort, FavoriteListingResult, PublishListingParams, PublishListingResult, ReportListingResult, SharedListing } from '@nodaro/shared/apps';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/organizations';
+
+/**
+ * The community-listing types are the single source of truth in
+ * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
+ * here so SDK consumers don't have to add `@nodaro/shared` as a second
+ * dependency just to typecheck `browse`/`clone`/`favorite`/`report`.
+ */
+/**
+ * Community — browse, favorite, clone, and report shared characters,
+ * locations, and objects.
+ *
+ * Publishing is intentionally NOT exposed here: it is admin-only via the
+ * editor, and the publish route rejects personal access tokens (which is what
+ * the SDK uses).
+ */
+declare class CommunityResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.
+     * Pass the returned `nextCursor` back as `cursor` to fetch the next page.
+     */
+    browse(params?: BrowseCommunityParams): Promise<BrowseCommunityResult>;
+    /** `GET /v1/community/detail/:slug` → a single listing by its slug. */
+    get(slug: string): Promise<{
+        data: CommunityCard;
+    }>;
+    /**
+     * `GET /v1/community/detail/:slug/full` → the full read-only detail (card
+     * identity + the stored public snapshot). Like {@link get}, but includes the
+     * snapshot asset/voice/text blob needed to render the full cross-user view.
+     */
+    getFull(slug: string): Promise<{
+        data: CommunityFullDetail;
+    }>;
+    /** `GET /v1/community/favorites` → the listings you've favorited. */
+    favorites(): Promise<{
+        data: CommunityCard[];
+    }>;
+    /**
+     * `POST /v1/community/listings/:id/clone` → copy a listing into your library.
+     * Returns the new asset's `entityType` and `id`. Requires the `assets:write`
+     * scope when called with an OAuth app token.
+     */
+    clone(id: string, entityType: CommunityEntityType): Promise<CloneListingResult>;
+    /**
+     * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the
+     * resulting `favorited` state (`true` after adding, `false` after removing).
+     */
+    favorite(id: string): Promise<FavoriteListingResult>;
+    /**
+     * `POST /v1/community/listings/:id/report` → flag a listing for moderation.
+     * `reason` must be one of {@link CommunityReportReason}.
+     */
+    report(id: string, reason: CommunityReportReason): Promise<ReportListingResult>;
+    /**
+     * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR
+     * entities to the community, returning the new listing's `slug` + `id`.
+     *
+     * **Requires an admin token** (the route is `requireAdmin`) AND the caller
+     * must own the source entity. Personal/OAuth tokens without admin role get a
+     * 401. For `character` listings, `params.likenessAttestation` must be `true`.
+     */
+    publish(entityType: CommunityEntityType, entityId: string, params: PublishListingParams): Promise<PublishListingResult>;
+    /**
+     * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing
+     * you published. **Requires an admin token** (the route is `requireAdmin`).
+     */
+    unpublish(listingId: string): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR
+     * existing listing (if any) for a source entity. Returns `{ data: null }`
+     * when the entity hasn't been shared. **Requires an admin token** (the route
+     * is `requireAdmin`); only returns listings created by the caller.
+     */
+    sharedListing(entityType: CommunityEntityType, sourceId: string): Promise<{
+        data: SharedListing | null;
+    }>;
+}
+
+export { CommunityResource };

package/dist/entries/community.d.ts

@@ -0,0 +1,87 @@
+import { BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from '@nodaro/shared/apps';
+export { BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, CommunityCard, CommunityEntityType, CommunityFullDetail, CommunityReportReason, CommunitySort, FavoriteListingResult, PublishListingParams, PublishListingResult, ReportListingResult, SharedListing } from '@nodaro/shared/apps';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/organizations';
+
+/**
+ * The community-listing types are the single source of truth in
+ * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
+ * here so SDK consumers don't have to add `@nodaro/shared` as a second
+ * dependency just to typecheck `browse`/`clone`/`favorite`/`report`.
+ */
+/**
+ * Community — browse, favorite, clone, and report shared characters,
+ * locations, and objects.
+ *
+ * Publishing is intentionally NOT exposed here: it is admin-only via the
+ * editor, and the publish route rejects personal access tokens (which is what
+ * the SDK uses).
+ */
+declare class CommunityResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.
+     * Pass the returned `nextCursor` back as `cursor` to fetch the next page.
+     */
+    browse(params?: BrowseCommunityParams): Promise<BrowseCommunityResult>;
+    /** `GET /v1/community/detail/:slug` → a single listing by its slug. */
+    get(slug: string): Promise<{
+        data: CommunityCard;
+    }>;
+    /**
+     * `GET /v1/community/detail/:slug/full` → the full read-only detail (card
+     * identity + the stored public snapshot). Like {@link get}, but includes the
+     * snapshot asset/voice/text blob needed to render the full cross-user view.
+     */
+    getFull(slug: string): Promise<{
+        data: CommunityFullDetail;
+    }>;
+    /** `GET /v1/community/favorites` → the listings you've favorited. */
+    favorites(): Promise<{
+        data: CommunityCard[];
+    }>;
+    /**
+     * `POST /v1/community/listings/:id/clone` → copy a listing into your library.
+     * Returns the new asset's `entityType` and `id`. Requires the `assets:write`
+     * scope when called with an OAuth app token.
+     */
+    clone(id: string, entityType: CommunityEntityType): Promise<CloneListingResult>;
+    /**
+     * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the
+     * resulting `favorited` state (`true` after adding, `false` after removing).
+     */
+    favorite(id: string): Promise<FavoriteListingResult>;
+    /**
+     * `POST /v1/community/listings/:id/report` → flag a listing for moderation.
+     * `reason` must be one of {@link CommunityReportReason}.
+     */
+    report(id: string, reason: CommunityReportReason): Promise<ReportListingResult>;
+    /**
+     * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR
+     * entities to the community, returning the new listing's `slug` + `id`.
+     *
+     * **Requires an admin token** (the route is `requireAdmin`) AND the caller
+     * must own the source entity. Personal/OAuth tokens without admin role get a
+     * 401. For `character` listings, `params.likenessAttestation` must be `true`.
+     */
+    publish(entityType: CommunityEntityType, entityId: string, params: PublishListingParams): Promise<PublishListingResult>;
+    /**
+     * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing
+     * you published. **Requires an admin token** (the route is `requireAdmin`).
+     */
+    unpublish(listingId: string): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR
+     * existing listing (if any) for a source entity. Returns `{ data: null }`
+     * when the entity hasn't been shared. **Requires an admin token** (the route
+     * is `requireAdmin`); only returns listings created by the caller.
+     */
+    sharedListing(entityType: CommunityEntityType, sourceId: string): Promise<{
+        data: SharedListing | null;
+    }>;
+}
+
+export { CommunityResource };

package/dist/entries/community.js

@@ -0,0 +1,4 @@
+import '../chunk-GAZJ2PA3.js';
+export { CommunityResource } from '../chunk-SFB4YLCS.js';
+//# sourceMappingURL=community.js.map
+//# sourceMappingURL=community.js.map

package/dist/entries/community.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"community.js"}

package/dist/entries/competitors.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-LWZLWSXD.cjs');
+var chunkYFS2LMG4_cjs = require('../chunk-YFS2LMG4.cjs');
+
+
+
+Object.defineProperty(exports, "CompetitorsResource", {
+  enumerable: true,
+  get: function () { return chunkYFS2LMG4_cjs.CompetitorsResource; }
+});
+//# sourceMappingURL=competitors.cjs.map
+//# sourceMappingURL=competitors.cjs.map

package/dist/entries/competitors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"competitors.cjs"}

package/dist/entries/competitors.d.cts

@@ -0,0 +1,96 @@
+import { TrackedCompetitor, CompetitorListResult, CompetitorDetail, CompetitorHistory, CompetitorCompareInput, CompetitorCompareResult, CreateCompetitorInput, UpdateCompetitorInput, CompetitorCardsResult, CompetitorLessonsResult, CompetitorActionsResult, CardActionResult, CompetitorDiscovery } from '@nodaro/shared/social';
+export { ActionCard, ActionCardKind, ActionCardPriority, AdviceFamily, AdviceRecord, BrandLesson, BrandLessonKind, BrandLessons, BrandPlatformLessons, CardAction, CardActionResult, CardOutcome, CardOutcomeState, CardSnapshot, CardVerdict, CompetitorAboutPlatform, CompetitorAccountKey, CompetitorAccounts, CompetitorActionsResult, CompetitorBrandTally, CompetitorCardsResult, CompetitorCompareInput, CompetitorCompareResult, CompetitorDetail, CompetitorDiscovery, CompetitorHistory, CompetitorHistoryPlatform, CompetitorHistoryPoint, CompetitorLessonsResult, CompetitorListResult, CompetitorPeriod, CompetitorPeriodFollowers, CompetitorPeriodPlatform, CompetitorPlatformTally, CompetitorPost, CompetitorScan, CompetitorScanCounts, CompetitorScanSummary, CompetitorSchedule, CompetitorSearch, CompetitorSearchKind, CreateCompetitorInput, MarkCardInput, TrackedCompetitor, UpdateCardActionInput, UpdateCompetitorInput } from '@nodaro/shared/social';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Competitors — brands you track (competitors, or your own), their scans and
+ * the action cards read from them. Nodaro Cloud.
+ *
+ * Adding, reading and website lookups are free. A scan costs one Social
+ * Search page per search it runs (`TrackedCompetitor.searches`); searches that
+ * fail are not charged.
+ */
+declare class CompetitorsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** `GET /v1/competitors` → every tracked brand. */
+    list(): Promise<TrackedCompetitor[]>;
+    /** `GET /v1/competitors` → every tracked brand, with how many months of scans your plan keeps. */
+    listWithPlan(): Promise<CompetitorListResult>;
+    /**
+     * `GET /v1/competitors/:id` → one brand with its latest scan (posts and
+     * cards) and its scan history; with `scan`, the brand as of that scan.
+     */
+    get(id: string, options?: {
+        readonly scan?: string;
+    }): Promise<CompetitorDetail>;
+    /** `GET /v1/competitors/:id/history` → the brand's scans oldest first, per platform what each found and read (free). */
+    history(id: string): Promise<CompetitorHistory>;
+    /**
+     * `GET /v1/competitors/:id/compare` → the brand over a period, and over a
+     * second one to compare with (free). A post belongs to a period by its
+     * publish date; a period is at most a year.
+     */
+    compare(id: string, input: CompetitorCompareInput): Promise<CompetitorCompareResult>;
+    /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */
+    create(input: CreateCompetitorInput): Promise<TrackedCompetitor>;
+    /**
+     * `PATCH /v1/competitors/:id` → change its accounts, platforms, name or schedule.
+     * `accounts` replaces the whole set: pass every account to keep. Send
+     * `schedule` only to change it (it restarts the brand's schedule). While a
+     * scan of the brand runs, a change to its name, accounts, platforms or
+     * `isOwn` is refused with `409 scan_running`.
+     */
+    update(id: string, input: UpdateCompetitorInput): Promise<TrackedCompetitor>;
+    /** `DELETE /v1/competitors/:id` → stop tracking it (its scans go too). */
+    delete(id: string): Promise<void>;
+    /** `GET /v1/competitors/cards` → every action card, most urgent first, with the posts they rest on. */
+    cards(): Promise<CompetitorCardsResult>;
+    /**
+     * `GET /v1/competitors/:id/lessons` → what works for a brand: per platform,
+     * what its best posts share, measured on its own posts across every stored
+     * scan, with the posts each lesson rests on (free). "What works for you" on
+     * the brand marked as yours.
+     */
+    lessons(id: string): Promise<CompetitorLessonsResult>;
+    /**
+     * `GET /v1/competitors/actions` → the cards you marked "I did this", newest
+     * first, each with how it went (`outcome`), and your track record per
+     * family of advice (free). Each scan of your own brand judges the post that
+     * came of a card once it is a few days old; the first verdict stays.
+     */
+    tried(): Promise<CompetitorActionsResult>;
+    /**
+     * `POST /v1/competitors/actions` → "I did this" on a card on your wall (its
+     * `id` from `cards()`), optionally with the link to your post that came of
+     * it. Only cards whose advice ends in a post of yours can be marked
+     * (`400 not_measurable`). Marking a marked card returns its mark
+     * (`created: false`).
+     */
+    markDone(cardId: string, options?: {
+        postUrl?: string;
+    }): Promise<CardActionResult>;
+    /**
+     * `PATCH /v1/competitors/actions/:id` → link the post that came of a marked
+     * card (the post's full link; a short link is refused with `400
+     * short_link`), or `null` to remove the link. Another post is judged afresh.
+     */
+    linkPost(markId: string, postUrl: string | null): Promise<CardActionResult>;
+    /** `PATCH /v1/competitors/actions/:id` with `seen: true` → you have seen its verdict (the app stops announcing it). */
+    markSeen(markId: string): Promise<CardActionResult>;
+    /** `DELETE /v1/competitors/actions/:id` → undo "I did this" (its verdict leaves your track record). */
+    unmark(markId: string): Promise<void>;
+    /** `POST /v1/competitor-discover` → a brand's accounts found from its website (free; guesses are marked). */
+    discover(website: string): Promise<CompetitorDiscovery>;
+    /**
+     * `POST /v1/competitor-scan` → scan a brand now. Answers with a job id;
+     * poll `client.jobs.getStatus(jobId)`, then read `get(id)` or `cards()`.
+     */
+    scan(id: string): Promise<{
+        jobId: string;
+    }>;
+}
+
+export { CompetitorsResource };

package/dist/entries/competitors.d.ts

@@ -0,0 +1,96 @@
+import { TrackedCompetitor, CompetitorListResult, CompetitorDetail, CompetitorHistory, CompetitorCompareInput, CompetitorCompareResult, CreateCompetitorInput, UpdateCompetitorInput, CompetitorCardsResult, CompetitorLessonsResult, CompetitorActionsResult, CardActionResult, CompetitorDiscovery } from '@nodaro/shared/social';
+export { ActionCard, ActionCardKind, ActionCardPriority, AdviceFamily, AdviceRecord, BrandLesson, BrandLessonKind, BrandLessons, BrandPlatformLessons, CardAction, CardActionResult, CardOutcome, CardOutcomeState, CardSnapshot, CardVerdict, CompetitorAboutPlatform, CompetitorAccountKey, CompetitorAccounts, CompetitorActionsResult, CompetitorBrandTally, CompetitorCardsResult, CompetitorCompareInput, CompetitorCompareResult, CompetitorDetail, CompetitorDiscovery, CompetitorHistory, CompetitorHistoryPlatform, CompetitorHistoryPoint, CompetitorLessonsResult, CompetitorListResult, CompetitorPeriod, CompetitorPeriodFollowers, CompetitorPeriodPlatform, CompetitorPlatformTally, CompetitorPost, CompetitorScan, CompetitorScanCounts, CompetitorScanSummary, CompetitorSchedule, CompetitorSearch, CompetitorSearchKind, CreateCompetitorInput, MarkCardInput, TrackedCompetitor, UpdateCardActionInput, UpdateCompetitorInput } from '@nodaro/shared/social';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Competitors — brands you track (competitors, or your own), their scans and
+ * the action cards read from them. Nodaro Cloud.
+ *
+ * Adding, reading and website lookups are free. A scan costs one Social
+ * Search page per search it runs (`TrackedCompetitor.searches`); searches that
+ * fail are not charged.
+ */
+declare class CompetitorsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** `GET /v1/competitors` → every tracked brand. */
+    list(): Promise<TrackedCompetitor[]>;
+    /** `GET /v1/competitors` → every tracked brand, with how many months of scans your plan keeps. */
+    listWithPlan(): Promise<CompetitorListResult>;
+    /**
+     * `GET /v1/competitors/:id` → one brand with its latest scan (posts and
+     * cards) and its scan history; with `scan`, the brand as of that scan.
+     */
+    get(id: string, options?: {
+        readonly scan?: string;
+    }): Promise<CompetitorDetail>;
+    /** `GET /v1/competitors/:id/history` → the brand's scans oldest first, per platform what each found and read (free). */
+    history(id: string): Promise<CompetitorHistory>;
+    /**
+     * `GET /v1/competitors/:id/compare` → the brand over a period, and over a
+     * second one to compare with (free). A post belongs to a period by its
+     * publish date; a period is at most a year.
+     */
+    compare(id: string, input: CompetitorCompareInput): Promise<CompetitorCompareResult>;
+    /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */
+    create(input: CreateCompetitorInput): Promise<TrackedCompetitor>;
+    /**
+     * `PATCH /v1/competitors/:id` → change its accounts, platforms, name or schedule.
+     * `accounts` replaces the whole set: pass every account to keep. Send
+     * `schedule` only to change it (it restarts the brand's schedule). While a
+     * scan of the brand runs, a change to its name, accounts, platforms or
+     * `isOwn` is refused with `409 scan_running`.
+     */
+    update(id: string, input: UpdateCompetitorInput): Promise<TrackedCompetitor>;
+    /** `DELETE /v1/competitors/:id` → stop tracking it (its scans go too). */
+    delete(id: string): Promise<void>;
+    /** `GET /v1/competitors/cards` → every action card, most urgent first, with the posts they rest on. */
+    cards(): Promise<CompetitorCardsResult>;
+    /**
+     * `GET /v1/competitors/:id/lessons` → what works for a brand: per platform,
+     * what its best posts share, measured on its own posts across every stored
+     * scan, with the posts each lesson rests on (free). "What works for you" on
+     * the brand marked as yours.
+     */
+    lessons(id: string): Promise<CompetitorLessonsResult>;
+    /**
+     * `GET /v1/competitors/actions` → the cards you marked "I did this", newest
+     * first, each with how it went (`outcome`), and your track record per
+     * family of advice (free). Each scan of your own brand judges the post that
+     * came of a card once it is a few days old; the first verdict stays.
+     */
+    tried(): Promise<CompetitorActionsResult>;
+    /**
+     * `POST /v1/competitors/actions` → "I did this" on a card on your wall (its
+     * `id` from `cards()`), optionally with the link to your post that came of
+     * it. Only cards whose advice ends in a post of yours can be marked
+     * (`400 not_measurable`). Marking a marked card returns its mark
+     * (`created: false`).
+     */
+    markDone(cardId: string, options?: {
+        postUrl?: string;
+    }): Promise<CardActionResult>;
+    /**
+     * `PATCH /v1/competitors/actions/:id` → link the post that came of a marked
+     * card (the post's full link; a short link is refused with `400
+     * short_link`), or `null` to remove the link. Another post is judged afresh.
+     */
+    linkPost(markId: string, postUrl: string | null): Promise<CardActionResult>;
+    /** `PATCH /v1/competitors/actions/:id` with `seen: true` → you have seen its verdict (the app stops announcing it). */
+    markSeen(markId: string): Promise<CardActionResult>;
+    /** `DELETE /v1/competitors/actions/:id` → undo "I did this" (its verdict leaves your track record). */
+    unmark(markId: string): Promise<void>;
+    /** `POST /v1/competitor-discover` → a brand's accounts found from its website (free; guesses are marked). */
+    discover(website: string): Promise<CompetitorDiscovery>;
+    /**
+     * `POST /v1/competitor-scan` → scan a brand now. Answers with a job id;
+     * poll `client.jobs.getStatus(jobId)`, then read `get(id)` or `cards()`.
+     */
+    scan(id: string): Promise<{
+        jobId: string;
+    }>;
+}
+
+export { CompetitorsResource };

package/dist/entries/competitors.js

@@ -0,0 +1,4 @@
+import '../chunk-GD24ZRFD.js';
+export { CompetitorsResource } from '../chunk-BU5A6K4C.js';
+//# sourceMappingURL=competitors.js.map
+//# sourceMappingURL=competitors.js.map

package/dist/entries/competitors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"competitors.js"}

package/dist/entries/copilot.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+require('../chunk-W33CKW6Q.cjs');
+var chunkNLQQHJ25_cjs = require('../chunk-NLQQHJ25.cjs');
+require('../chunk-KNMW722T.cjs');
+require('../chunk-N6GLZOE4.cjs');
+
+
+
+Object.defineProperty(exports, "CopilotResource", {
+  enumerable: true,
+  get: function () { return chunkNLQQHJ25_cjs.CopilotResource; }
+});
+//# sourceMappingURL=copilot.cjs.map
+//# sourceMappingURL=copilot.cjs.map

package/dist/entries/copilot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"copilot.cjs"}