arcmira 0.2.0 → 0.3.0

package/dist/cjs/api/resources/channels/resources/related/types/OrganizationsRelatedRequestMode.d.ts

@@ -0,0 +1,6 @@
+/** Person relationship lens: guest appearances or inbound mentions. */
+export declare const OrganizationsRelatedRequestMode: {
+    readonly Appearances: "appearances";
+    readonly Mentions: "mentions";
+};
+export type OrganizationsRelatedRequestMode = (typeof OrganizationsRelatedRequestMode)[keyof typeof OrganizationsRelatedRequestMode];

package/dist/cjs/api/resources/channels/resources/related/types/OrganizationsRelatedRequestMode.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrganizationsRelatedRequestMode = void 0;
+/** Person relationship lens: guest appearances or inbound mentions. */
+exports.OrganizationsRelatedRequestMode = {
+    Appearances: "appearances",
+    Mentions: "mentions",
+};

package/dist/cjs/api/resources/channels/resources/related/types/PeopleRelatedRequestIsAppearance.d.ts

@@ -0,0 +1,8 @@
+/** For person appearances, true lists guest episodes and false lists inbound mentions. */
+export declare const PeopleRelatedRequestIsAppearance: {
+    readonly Zero: "0";
+    readonly One: "1";
+    readonly True: "true";
+    readonly False: "false";
+};
+export type PeopleRelatedRequestIsAppearance = (typeof PeopleRelatedRequestIsAppearance)[keyof typeof PeopleRelatedRequestIsAppearance];

package/dist/cjs/api/resources/channels/resources/related/types/PeopleRelatedRequestIsAppearance.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeopleRelatedRequestIsAppearance = void 0;
+/** For person appearances, true lists guest episodes and false lists inbound mentions. */
+exports.PeopleRelatedRequestIsAppearance = {
+    Zero: "0",
+    One: "1",
+    True: "true",
+    False: "false",
+};

package/dist/cjs/api/resources/channels/resources/related/types/PeopleRelatedRequestMode.d.ts

@@ -0,0 +1,6 @@
+/** Person relationship lens: guest appearances or inbound mentions. */
+export declare const PeopleRelatedRequestMode: {
+    readonly Appearances: "appearances";
+    readonly Mentions: "mentions";
+};
+export type PeopleRelatedRequestMode = (typeof PeopleRelatedRequestMode)[keyof typeof PeopleRelatedRequestMode];

package/dist/cjs/api/resources/channels/resources/related/types/PeopleRelatedRequestMode.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeopleRelatedRequestMode = void 0;
+/** Person relationship lens: guest appearances or inbound mentions. */
+exports.PeopleRelatedRequestMode = {
+    Appearances: "appearances",
+    Mentions: "mentions",
+};

package/dist/cjs/api/resources/channels/resources/related/types/ProductsRelatedRequestIsAppearance.d.ts

@@ -0,0 +1,8 @@
+/** For person appearances, true lists guest episodes and false lists inbound mentions. */
+export declare const ProductsRelatedRequestIsAppearance: {
+    readonly Zero: "0";
+    readonly One: "1";
+    readonly True: "true";
+    readonly False: "false";
+};
+export type ProductsRelatedRequestIsAppearance = (typeof ProductsRelatedRequestIsAppearance)[keyof typeof ProductsRelatedRequestIsAppearance];

package/dist/cjs/api/resources/channels/resources/related/types/ProductsRelatedRequestIsAppearance.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductsRelatedRequestIsAppearance = void 0;
+/** For person appearances, true lists guest episodes and false lists inbound mentions. */
+exports.ProductsRelatedRequestIsAppearance = {
+    Zero: "0",
+    One: "1",
+    True: "true",
+    False: "false",
+};

package/dist/cjs/api/resources/channels/resources/related/types/ProductsRelatedRequestMode.d.ts

@@ -0,0 +1,6 @@
+/** Person relationship lens: guest appearances or inbound mentions. */
+export declare const ProductsRelatedRequestMode: {
+    readonly Appearances: "appearances";
+    readonly Mentions: "mentions";
+};
+export type ProductsRelatedRequestMode = (typeof ProductsRelatedRequestMode)[keyof typeof ProductsRelatedRequestMode];

package/dist/cjs/api/resources/channels/resources/related/types/ProductsRelatedRequestMode.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductsRelatedRequestMode = void 0;
+/** Person relationship lens: guest appearances or inbound mentions. */
+exports.ProductsRelatedRequestMode = {
+    Appearances: "appearances",
+    Mentions: "mentions",
+};

package/dist/cjs/api/resources/channels/resources/related/types/TopicsRelatedRequestIsAppearance.d.ts

@@ -0,0 +1,8 @@
+/** For person appearances, true lists guest episodes and false lists inbound mentions. */
+export declare const TopicsRelatedRequestIsAppearance: {
+    readonly Zero: "0";
+    readonly One: "1";
+    readonly True: "true";
+    readonly False: "false";
+};
+export type TopicsRelatedRequestIsAppearance = (typeof TopicsRelatedRequestIsAppearance)[keyof typeof TopicsRelatedRequestIsAppearance];

package/dist/cjs/api/resources/channels/resources/related/types/TopicsRelatedRequestIsAppearance.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicsRelatedRequestIsAppearance = void 0;
+/** For person appearances, true lists guest episodes and false lists inbound mentions. */
+exports.TopicsRelatedRequestIsAppearance = {
+    Zero: "0",
+    One: "1",
+    True: "true",
+    False: "false",
+};

package/dist/cjs/api/resources/channels/resources/related/types/TopicsRelatedRequestMode.d.ts

@@ -0,0 +1,6 @@
+/** Person relationship lens: guest appearances or inbound mentions. */
+export declare const TopicsRelatedRequestMode: {
+    readonly Appearances: "appearances";
+    readonly Mentions: "mentions";
+};
+export type TopicsRelatedRequestMode = (typeof TopicsRelatedRequestMode)[keyof typeof TopicsRelatedRequestMode];

package/dist/cjs/api/resources/channels/resources/related/types/TopicsRelatedRequestMode.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicsRelatedRequestMode = void 0;
+/** Person relationship lens: guest appearances or inbound mentions. */
+exports.TopicsRelatedRequestMode = {
+    Appearances: "appearances",
+    Mentions: "mentions",
+};

package/dist/cjs/api/resources/channels/resources/related/types/index.d.ts

@@ -1,5 +1,15 @@
+export * from "./ChannelsRelatedRequestIsAppearance.js";
+export * from "./ChannelsRelatedRequestMode.js";
 export * from "./ChannelsRelatedRequestOrder.js";
+export * from "./OrganizationsRelatedRequestIsAppearance.js";
+export * from "./OrganizationsRelatedRequestMode.js";
 export * from "./OrganizationsRelatedRequestOrder.js";
+export * from "./PeopleRelatedRequestIsAppearance.js";
+export * from "./PeopleRelatedRequestMode.js";
 export * from "./PeopleRelatedRequestOrder.js";
+export * from "./ProductsRelatedRequestIsAppearance.js";
+export * from "./ProductsRelatedRequestMode.js";
 export * from "./ProductsRelatedRequestOrder.js";
+export * from "./TopicsRelatedRequestIsAppearance.js";
+export * from "./TopicsRelatedRequestMode.js";
 export * from "./TopicsRelatedRequestOrder.js";

package/dist/cjs/api/resources/channels/resources/related/types/index.js

@@ -14,8 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ChannelsRelatedRequestIsAppearance.js"), exports);
+__exportStar(require("./ChannelsRelatedRequestMode.js"), exports);
 __exportStar(require("./ChannelsRelatedRequestOrder.js"), exports);
+__exportStar(require("./OrganizationsRelatedRequestIsAppearance.js"), exports);
+__exportStar(require("./OrganizationsRelatedRequestMode.js"), exports);
 __exportStar(require("./OrganizationsRelatedRequestOrder.js"), exports);
+__exportStar(require("./PeopleRelatedRequestIsAppearance.js"), exports);
+__exportStar(require("./PeopleRelatedRequestMode.js"), exports);
 __exportStar(require("./PeopleRelatedRequestOrder.js"), exports);
+__exportStar(require("./ProductsRelatedRequestIsAppearance.js"), exports);
+__exportStar(require("./ProductsRelatedRequestMode.js"), exports);
 __exportStar(require("./ProductsRelatedRequestOrder.js"), exports);
+__exportStar(require("./TopicsRelatedRequestIsAppearance.js"), exports);
+__exportStar(require("./TopicsRelatedRequestMode.js"), exports);
 __exportStar(require("./TopicsRelatedRequestOrder.js"), exports);

package/dist/cjs/api/resources/channels/resources/videos/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class VideosClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<VideosClient.Options>;
     constructor(options?: VideosClient.Options);
     /**
-     * The indexed videos of a YouTube channel, newest first, each with its video_id, title, publish date, duration, view count, and watch_url on arcmira.com. Call it for the latest or most recent episode of a show, or to list what a show published in a window, then pass a video_id to GET /v1/mentions/counts video_ids for what that episode mentions or to GET /v1/transcripts/{video_id} to read it. indexed_through is the newest date we hold for the channel. An empty list means nothing is indexed; channel backfill is not available yet. Bills one row per video returned. Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.
+     * The indexed videos of a YouTube channel, newest first, each with its video_id, title, publish date, duration, view count, and watch_url on arcmira.com. Pass next_cursor as cursor to continue. The signed token binds the route, filters, caller and visibility; invalid or old tokens return invalid_cursor. A first-page media ID fence excludes later insertions, including old-date backfills; edits and deletions to existing rows remain live. Call it for the latest or most recent episode of a show, or to list what a show published in a window, then pass a video_id to GET /v1/mentions/counts video_ids for what that episode mentions or to GET /v1/transcripts/{video_id} to read it. indexed_through is the newest date we hold for the channel. An empty list means nothing is indexed; channel backfill is not available yet. Bills one row per video returned. Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.
      *
      * @param {Arcmira.channels.ListVideosRequest} request
      * @param {VideosClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -31,6 +31,5 @@ export declare class VideosClient {
      *         channel_id: "channel_id"
      *     })
      */
-    list(request: Arcmira.channels.ListVideosRequest, requestOptions?: VideosClient.RequestOptions): core.HttpResponsePromise<Arcmira.ChannelVideosResponse>;
-    private __list;
+    list(request: Arcmira.channels.ListVideosRequest, requestOptions?: VideosClient.RequestOptions): Promise<core.Page<Arcmira.ChannelVideosResponse.Episodes.Item, Arcmira.ChannelVideosResponse>>;
 }

package/dist/cjs/api/resources/channels/resources/videos/client/Client.js

@@ -56,7 +56,7 @@ class VideosClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * The indexed videos of a YouTube channel, newest first, each with its video_id, title, publish date, duration, view count, and watch_url on arcmira.com. Call it for the latest or most recent episode of a show, or to list what a show published in a window, then pass a video_id to GET /v1/mentions/counts video_ids for what that episode mentions or to GET /v1/transcripts/{video_id} to read it. indexed_through is the newest date we hold for the channel. An empty list means nothing is indexed; channel backfill is not available yet. Bills one row per video returned. Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.
+     * The indexed videos of a YouTube channel, newest first, each with its video_id, title, publish date, duration, view count, and watch_url on arcmira.com. Pass next_cursor as cursor to continue. The signed token binds the route, filters, caller and visibility; invalid or old tokens return invalid_cursor. A first-page media ID fence excludes later insertions, including old-date backfills; edits and deletions to existing rows remain live. Call it for the latest or most recent episode of a show, or to list what a show published in a window, then pass a video_id to GET /v1/mentions/counts video_ids for what that episode mentions or to GET /v1/transcripts/{video_id} to read it. indexed_through is the newest date we hold for the channel. An empty list means nothing is indexed; channel backfill is not available yet. Bills one row per video returned. Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.
      *
      * @param {Arcmira.channels.ListVideosRequest} request
      * @param {VideosClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -77,62 +77,76 @@ class VideosClient {
      *     })
      */
     list(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
-    }
-    __list(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { channel_id: channelId, limit, published_after: publishedAfter, published_before: publishedBefore, } = request;
-            const _queryParams = {
-                limit,
-                published_after: publishedAfter,
-                published_before: publishedBefore,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield core.fetcher({
-                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ArcmiraEnvironment.Default, `v1/channels/${core.url.encodePathParam(channelId)}/videos`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 400:
-                        throw new Arcmira.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 401:
-                        throw new Arcmira.UnauthorizedError(_response.error.body, _response.rawResponse);
-                    case 402:
-                        throw new Arcmira.PaymentRequiredError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new Arcmira.ForbiddenError(_response.error.body, _response.rawResponse);
-                    case 404:
-                        throw new Arcmira.NotFoundError(_response.error.body, _response.rawResponse);
-                    case 429:
-                        throw new Arcmira.TooManyRequestsError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Arcmira.InternalServerError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.ArcmiraError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
+            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+                const { channel_id: channelId, limit, cursor, published_after: publishedAfter, published_before: publishedBefore, } = request;
+                const _queryParams = {
+                    limit,
+                    cursor,
+                    published_after: publishedAfter,
+                    published_before: publishedBefore,
+                };
+                const _authRequest = yield this._options.authProvider.getAuthRequest();
+                const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _response = yield core.fetcher({
+                    url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ArcmiraEnvironment.Default, `v1/channels/${core.url.encodePathParam(channelId)}/videos`),
+                    method: "GET",
+                    headers: _headers,
+                    queryString: core.url
+                        .queryBuilder()
+                        .addMany(_queryParams)
+                        .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                        .build(),
+                    timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                    maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                    fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                    logging: this._options.logging,
+                });
+                if (_response.ok) {
+                    return {
+                        data: _response.body,
+                        rawResponse: _response.rawResponse,
+                    };
                 }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/channels/{channel_id}/videos");
+                if (_response.error.reason === "status-code") {
+                    switch (_response.error.statusCode) {
+                        case 400:
+                            throw new Arcmira.BadRequestError(_response.error.body, _response.rawResponse);
+                        case 401:
+                            throw new Arcmira.UnauthorizedError(_response.error.body, _response.rawResponse);
+                        case 402:
+                            throw new Arcmira.PaymentRequiredError(_response.error.body, _response.rawResponse);
+                        case 403:
+                            throw new Arcmira.ForbiddenError(_response.error.body, _response.rawResponse);
+                        case 404:
+                            throw new Arcmira.NotFoundError(_response.error.body, _response.rawResponse);
+                        case 429:
+                            throw new Arcmira.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                        case 500:
+                            throw new Arcmira.InternalServerError(_response.error.body, _response.rawResponse);
+                        default:
+                            throw new errors.ArcmiraError({
+                                statusCode: _response.error.statusCode,
+                                body: _response.error.body,
+                                rawResponse: _response.rawResponse,
+                            });
+                    }
+                }
+                return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/channels/{channel_id}/videos");
+            }));
+            const dataWithRawResponse = yield list(request).withRawResponse();
+            return new core.Page({
+                response: dataWithRawResponse.data,
+                rawResponse: dataWithRawResponse.rawResponse,
+                hasNextPage: (response) => (response === null || response === void 0 ? void 0 : response.next_cursor) != null &&
+                    !(typeof (response === null || response === void 0 ? void 0 : response.next_cursor) === "string" && (response === null || response === void 0 ? void 0 : response.next_cursor) === ""),
+                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.episodes) !== null && _a !== void 0 ? _a : []; },
+                loadPage: (response) => {
+                    return list(core.setObjectProperty(request, "cursor", response === null || response === void 0 ? void 0 : response.next_cursor));
+                },
+            });
         });
     }
 }

package/dist/cjs/api/resources/channels/resources/videos/client/requests/ListVideosRequest.d.ts

@@ -9,6 +9,8 @@ export interface ListVideosRequest {
     channel_id: string;
     /** Videos to return, 1 to 25, newest first. Default 10. Pass 1 for the latest episode. */
     limit?: number;
+    /** Opaque continuation from next_cursor. Bound to the channel, filters, caller, and visibility; limit may change between pages. Invalid or old tokens return invalid_cursor. */
+    cursor?: string;
     /** ISO date. Only videos published on or after this day. */
     published_after?: string;
     /** ISO date. Only videos published before this day. */

package/dist/cjs/api/resources/corrections/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class CorrectionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<CorrectionsClient.Options>;
     constructor(options?: CorrectionsClient.Options);
     /**
-     * Unified corrections ingestion for all kinds: line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite. Corrections are free (0 rows) and land as pending-review rows attributed to your API key; speaker_identify/add_person also create a community-flagged appearance immediately. segment_rewrite is the structural primitive: it replaces an inclusive segment range with new segments (an empty replacements array deletes the range); timestamps can be pinned per replacement with optional start/end seconds, and unpinned times are repaired by char-proportional interpolation between pins. Anchored kinds (line_edit, speaker_reassign, entity_tag, segment_rewrite) must echo the `revision` from a Premium transcript read and an `anchor` ({ segmentIndex, contentHash: djb2 of the covered segment text }); `anchor.segmentIndex` is the line's `index` in that read. Error semantics for outbox-style clients: 409 = revision/anchor mismatch, the transcript changed underneath the correction (body { reason, currentRevision }); drop or re-anchor the event and continue, the sequence number is consumed. 412 = seq mismatch (body { expectedSeq }); refetch the transcript, rebase local counters, and resend.
+     * Unified corrections ingestion for all kinds: line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite. Corrections are free (0 rows) and land as pending-review rows attributed to your API key; speaker_identify/add_person also create a community-flagged appearance immediately. segment_rewrite is the structural primitive: it replaces an inclusive segment range with new segments (an empty replacements array deletes the range); timestamps can be pinned per replacement with optional start/end seconds, and unpinned times are repaired by char-proportional interpolation between pins. Anchored kinds (line_edit, speaker_reassign, entity_tag, segment_rewrite) must echo the `revision` from a Premium transcript read and an `anchor` ({ segmentIndex, contentHash: djb2 of the covered segment text }); `anchor.segmentIndex` is the line's `index` in that read. Every refusal uses the shared error envelope. Error semantics for outbox-style clients: a 409 revision_mismatch or anchor_mismatch means the transcript changed, and error.current_revision is the revision to re-read; create a new event and key after re-anchoring, because the original refusal consumed its sequence and is replayable. A 409 idempotency_conflict means a finalized key was reused for changed intent; recover the original request instead of rebasing that key. A 412 sequence_mismatch stores no receipt or effect; error.expected_seq is the next seq, so synchronize local counters and resend under the same key.
      *
      * @param {Arcmira.SubmitCorrectionsRequest} request
      * @param {CorrectionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -29,6 +29,7 @@ export declare class CorrectionsClient {
      *
      * @example
      *     await client.corrections.submit({
+     *         "Idempotency-Key": "8b2f6c3e-4d1a-4e7b-9c05-2f6a1b7d3e90",
      *         video_id: "video_id",
      *         kind: "line_edit",
      *         payload: {

package/dist/cjs/api/resources/corrections/client/Client.js

@@ -68,7 +68,7 @@ class CorrectionsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Unified corrections ingestion for all kinds: line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite. Corrections are free (0 rows) and land as pending-review rows attributed to your API key; speaker_identify/add_person also create a community-flagged appearance immediately. segment_rewrite is the structural primitive: it replaces an inclusive segment range with new segments (an empty replacements array deletes the range); timestamps can be pinned per replacement with optional start/end seconds, and unpinned times are repaired by char-proportional interpolation between pins. Anchored kinds (line_edit, speaker_reassign, entity_tag, segment_rewrite) must echo the `revision` from a Premium transcript read and an `anchor` ({ segmentIndex, contentHash: djb2 of the covered segment text }); `anchor.segmentIndex` is the line's `index` in that read. Error semantics for outbox-style clients: 409 = revision/anchor mismatch, the transcript changed underneath the correction (body { reason, currentRevision }); drop or re-anchor the event and continue, the sequence number is consumed. 412 = seq mismatch (body { expectedSeq }); refetch the transcript, rebase local counters, and resend.
+     * Unified corrections ingestion for all kinds: line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite. Corrections are free (0 rows) and land as pending-review rows attributed to your API key; speaker_identify/add_person also create a community-flagged appearance immediately. segment_rewrite is the structural primitive: it replaces an inclusive segment range with new segments (an empty replacements array deletes the range); timestamps can be pinned per replacement with optional start/end seconds, and unpinned times are repaired by char-proportional interpolation between pins. Anchored kinds (line_edit, speaker_reassign, entity_tag, segment_rewrite) must echo the `revision` from a Premium transcript read and an `anchor` ({ segmentIndex, contentHash: djb2 of the covered segment text }); `anchor.segmentIndex` is the line's `index` in that read. Every refusal uses the shared error envelope. Error semantics for outbox-style clients: a 409 revision_mismatch or anchor_mismatch means the transcript changed, and error.current_revision is the revision to re-read; create a new event and key after re-anchoring, because the original refusal consumed its sequence and is replayable. A 409 idempotency_conflict means a finalized key was reused for changed intent; recover the original request instead of rebasing that key. A 412 sequence_mismatch stores no receipt or effect; error.expected_seq is the next seq, so synchronize local counters and resend under the same key.
      *
      * @param {Arcmira.SubmitCorrectionsRequest} request
      * @param {CorrectionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -86,6 +86,7 @@ class CorrectionsClient {
      *
      * @example
      *     await client.corrections.submit({
+     *         "Idempotency-Key": "8b2f6c3e-4d1a-4e7b-9c05-2f6a1b7d3e90",
      *         video_id: "video_id",
      *         kind: "line_edit",
      *         payload: {

package/dist/cjs/api/resources/corrections/client/requests/SubmitCorrectionsRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "8b2f6c3e-4d1a-4e7b-9c05-2f6a1b7d3e90",
  *         video_id: "video_id",
  *         kind: "line_edit",
  *         payload: {
@@ -11,7 +12,7 @@
 export interface SubmitCorrectionsRequest {
     /** YouTube video id, 11 characters. */
     video_id: string;
-    /** The client event id, such as a UUID. A retry with the same key returns the stored final response with Idempotency-Replayed: true. A 412 is never stored, so a rebased resend under the same key runs again. */
+    /** 1 to 255 printable ASCII characters (0x21 to 0x7E); anything else is 400 invalid_idempotency_key. Persist a unique client event key with the HTTP method, public path and parsed body. The same finalized intent replays its original response with Idempotency-Replayed: true; changed finalized input returns 409 idempotency_conflict. Receipts have no expiry. A 412 stores no receipt or effect, so synchronize the sequence and resend under the same key. Other finalized refusals consume the eligible sequence once. */
     "Idempotency-Key"?: string;
     kind: SubmitCorrectionsRequest.Kind;
     /** Per-video monotonic sequence number (strict FIFO per user+video). Optional for one-off submissions; required for outbox-style clients that depend on ordering. Any mismatch returns 412 with the expected value. */

package/dist/cjs/api/resources/entities/resources/mentions/client/requests/ListMentionsRequest.d.ts

@@ -9,6 +9,7 @@ export interface ListMentionsRequest {
     /** Entity id, ent_{n} or the numeric id. Merged ids follow their redirect. */
     id: string;
     limit?: number;
+    /** Signed continuation from next_cursor. Bound to this route, normalized query, caller and visibility; invalid or old tokens return invalid_cursor. */
     cursor?: string;
     channel_id?: string;
     channel_name?: string;

package/dist/cjs/api/resources/entities/resources/recommendations/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class RecommendationsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<RecommendationsClient.Options>;
     constructor(options?: RecommendationsClient.Options);
     /**
-     * Cursor-paginated commercial mentions (ad reads, endorsements, neutral mentions) for one entity, newest media first. Requires a Pro+ plan. Read timestamps from start_seconds / end_seconds (integer seconds); the MM:SS string fields are deprecated. Rows below min_confidence (default 0.7) and disputed rows (unless include_disputed=true) are excluded.
+     * Cursor-paginated commercial mentions (ad reads, endorsements, neutral mentions) for one entity, newest media first. The signed continuation binds the route, filters, caller and visibility; invalid or old cursors return invalid_cursor. A first-page ID fence excludes later insertions, including old-date backfills. Edits and deletions to existing rows remain live. Requires a Pro+ plan. Read timestamps from start_seconds / end_seconds (integer seconds); the MM:SS string fields are deprecated. Rows below min_confidence (default 0.7) and disputed rows (unless include_disputed=true) are excluded.
      *
      * @param {Arcmira.entities.ListRecommendationsRequest} request
      * @param {RecommendationsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/entities/resources/recommendations/client/Client.js

@@ -56,7 +56,7 @@ class RecommendationsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Cursor-paginated commercial mentions (ad reads, endorsements, neutral mentions) for one entity, newest media first. Requires a Pro+ plan. Read timestamps from start_seconds / end_seconds (integer seconds); the MM:SS string fields are deprecated. Rows below min_confidence (default 0.7) and disputed rows (unless include_disputed=true) are excluded.
+     * Cursor-paginated commercial mentions (ad reads, endorsements, neutral mentions) for one entity, newest media first. The signed continuation binds the route, filters, caller and visibility; invalid or old cursors return invalid_cursor. A first-page ID fence excludes later insertions, including old-date backfills. Edits and deletions to existing rows remain live. Requires a Pro+ plan. Read timestamps from start_seconds / end_seconds (integer seconds); the MM:SS string fields are deprecated. Rows below min_confidence (default 0.7) and disputed rows (unless include_disputed=true) are excluded.
      *
      * @param {Arcmira.entities.ListRecommendationsRequest} request
      * @param {RecommendationsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/entities/resources/recommendations/client/requests/ListRecommendationsRequest.d.ts

@@ -9,6 +9,7 @@ export interface ListRecommendationsRequest {
     /** Entity id, ent_{n} or the numeric id. Merged ids follow their redirect. */
     id: string;
     limit?: number;
+    /** Signed continuation from next_cursor. Bound to this route, normalized query, caller and visibility; invalid or old tokens return invalid_cursor. */
     cursor?: string;
     channel_id?: string;
     channel_name?: string;

package/dist/cjs/api/resources/feedback/client/Client.d.ts

@@ -27,9 +27,15 @@ export declare class FeedbackClient {
      * @throws {@link errors.ArcmiraTimeoutError}
      *
      * @example
-     *     await client.feedback.submit()
+     *     await client.feedback.submit({
+     *         "Idempotency-Key": "8b2f6c3e-4d1a-4e7b-9c05-2f6a1b7d3e90",
+     *         type: "recommendations",
+     *         query: {
+     *             "key": "value"
+     *         }
+     *     })
      */
-    submit(request?: Arcmira.SubmitFeedbackRequest, requestOptions?: FeedbackClient.RequestOptions): core.HttpResponsePromise<Arcmira.FeedbackResponse>;
+    submit(request: Arcmira.SubmitFeedbackRequest, requestOptions?: FeedbackClient.RequestOptions): core.HttpResponsePromise<Arcmira.FeedbackResponse>;
     private __submit;
     /**
      * Returns the submission (id, type, query, notes, created_at) plus its per-correction rows, each with a review status in the public vocabulary: pending_review, needs_information, accepted, accepted_with_changes, rejected, withdrawn, applied, reverted (accepted means a reviewer agreed; applied means the change is live in the index). Only the submitting user's keys can read a submission; unknown ids and other users' submissions both return 404 (never 403).

package/dist/cjs/api/resources/feedback/client/Client.js

@@ -84,13 +84,19 @@ class FeedbackClient {
      * @throws {@link errors.ArcmiraTimeoutError}
      *
      * @example
-     *     await client.feedback.submit()
+     *     await client.feedback.submit({
+     *         "Idempotency-Key": "8b2f6c3e-4d1a-4e7b-9c05-2f6a1b7d3e90",
+     *         type: "recommendations",
+     *         query: {
+     *             "key": "value"
+     *         }
+     *     })
      */
-    submit(request = {}, requestOptions) {
+    submit(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__submit(request, requestOptions));
     }
-    __submit() {
-        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+    __submit(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const { "Idempotency-Key": idempotencyKey } = request, _body = __rest(request, ["Idempotency-Key"]);
             const _authRequest = yield this._options.authProvider.getAuthRequest();

package/dist/cjs/api/resources/feedback/client/requests/SubmitFeedbackRequest.d.ts

@@ -1,15 +1,21 @@
 import type * as Arcmira from "../../../../index.js";
 /**
  * @example
- *     {}
+ *     {
+ *         "Idempotency-Key": "8b2f6c3e-4d1a-4e7b-9c05-2f6a1b7d3e90",
+ *         type: "recommendations",
+ *         query: {
+ *             "key": "value"
+ *         }
+ *     }
  */
 export interface SubmitFeedbackRequest {
-    /** A unique key you generate per logical request, such as a UUID. A retry with the same key and the same body within 24 hours returns the stored response with Idempotency-Replayed: true instead of running again. The same key with a different body answers 409 idempotency_conflict. Keys are scoped to the credential. */
+    /** 1 to 255 printable ASCII characters (0x21 to 0x7E); anything else is 400 invalid_idempotency_key. Persist a unique key and the exact request before sending a logical mutation. A retry returns its stored response with Idempotency-Replayed: true. A changed intent under a finalized key returns 409 idempotency_conflict. Keys belong to the authenticated owner, credential and mutation domain. Current authorization still applies. Receipts have no general 24-hour expiry; signing-secret recovery alone expires after 24 hours or when the secret is displaced. */
     "Idempotency-Key"?: string;
     /** The surface being reviewed. Values: recommendations (/v1/recommendations rows by com_* id; requires a Pro+ plan), channel_sponsors (sponsor entities on a channel; requires a Pro+ plan), mentions (/v1/mentions rows by men_* id), entities_search (/v1/entities/search hits), entities (/v1/entities/lookup and /v1/entities/{id} payloads), channels (/v1/channels/{slug} payloads), monitor_alert (fired alert rows from /v1/monitors/{id}/alerts or /v1/trackers/{id}/alerts; corrections target the alert row id), appearances (person appearance rows), search (rows from /v1/search or /v1/entities/search). */
-    type?: SubmitFeedbackRequest.Type;
+    type: SubmitFeedbackRequest.Type;
     /** The query object that produced the result you are reviewing, echoed back verbatim so reviewers can replay it. For monitor_alert feedback, carry monitor_id and/or tracker_id and/or alert_id. */
-    query?: Record<string, unknown>;
+    query: Record<string, unknown>;
     endpoint?: string;
     method?: SubmitFeedbackRequest.Method;
     request_id?: string;

package/dist/cjs/api/resources/me/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class MeClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<MeClient.Options>;
     constructor(options?: MeClient.Options);
     /**
-     * Returns the credential making the request (key_id, key_label, credential_kind), the masked account email, the tier, scopes, rate limit, row usage with period_resets_at, and account settings. settings.transcripts is what a transcript request that names no parameter of its own receives: every key of the account resolves against it.
+     * Available even when the account has exhausted its usage allowance. Returns the credential making the request (key_id, key_label, credential_kind), the masked account email, the tier, scopes, rate limit, row usage with period_resets_at, and account settings. settings.transcripts is what a transcript request that names no parameter of its own receives: every key of the account resolves against it.
      *
      * @param {MeClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/me/client/Client.js

@@ -57,7 +57,7 @@ class MeClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Returns the credential making the request (key_id, key_label, credential_kind), the masked account email, the tier, scopes, rate limit, row usage with period_resets_at, and account settings. settings.transcripts is what a transcript request that names no parameter of its own receives: every key of the account resolves against it.
+     * Available even when the account has exhausted its usage allowance. Returns the credential making the request (key_id, key_label, credential_kind), the masked account email, the tier, scopes, rate limit, row usage with period_resets_at, and account settings. settings.transcripts is what a transcript request that names no parameter of its own receives: every key of the account resolves against it.
      *
      * @param {MeClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/me/client/requests/UpdateSettingsMeRequest.d.ts

@@ -13,7 +13,7 @@ export declare namespace UpdateSettingsMeRequest {
      * Fields to change. An omitted field keeps the value the account already carries.
      */
     interface Transcripts {
-        /** Default transcript quality for this account: captions or premium. premium still needs a plan carrying Premium transcripts at request time. */
+        /** Default transcript quality for this account: captions or premium. premium reads require an existing purchase. Owned transcripts remain readable after a plan downgrade; new purchases require an eligible plan. */
         quality?: Transcripts.Quality | undefined;
         /** Default comma-separated caption language priority list, tried in order (e.g. "de,en"), at most 5 codes. Use asr for the first automatic track and asr-<code> for a specific one. */
         language?: string | undefined;
@@ -21,7 +21,7 @@ export declare namespace UpdateSettingsMeRequest {
         timestamps?: boolean | undefined;
     }
     namespace Transcripts {
-        /** Default transcript quality for this account: captions or premium. premium still needs a plan carrying Premium transcripts at request time. */
+        /** Default transcript quality for this account: captions or premium. premium reads require an existing purchase. Owned transcripts remain readable after a plan downgrade; new purchases require an eligible plan. */
         const Quality: {
             readonly Captions: "captions";
             readonly Premium: "premium";

package/dist/cjs/api/resources/me/client/requests/UpdateSettingsMeRequest.js

@@ -6,7 +6,7 @@ var UpdateSettingsMeRequest;
 (function (UpdateSettingsMeRequest) {
     let Transcripts;
     (function (Transcripts) {
-        /** Default transcript quality for this account: captions or premium. premium still needs a plan carrying Premium transcripts at request time. */
+        /** Default transcript quality for this account: captions or premium. premium reads require an existing purchase. Owned transcripts remain readable after a plan downgrade; new purchases require an eligible plan. */
         Transcripts.Quality = {
             Captions: "captions",
             Premium: "premium",

package/dist/cjs/api/resources/mentions/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class MentionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<MentionsClient.Options>;
     constructor(options?: MentionsClient.Options);
     /**
-     * Cursor-paginated mentions filtered by entity (entity_id or entity_name is required), channel, text query, sentiment, appearance flag, and date range. Read timestamps from start_seconds / end_seconds (integer seconds; 0 means full episode); the MM:SS (or HH:MM:SS) string fields are deprecated. is_appearance filtering applies to person entities only; passing is_appearance=true for any other type returns a 400 (appearances_person_only). details=full attaches per-mention commercial recommendations and requires a Pro+ plan.
+     * Cursor-paginated mentions filtered by entity (entity_id or entity_name is required), channel, text query, sentiment, appearance flag, and date range. The signed continuation binds the route, filters, caller and visibility; invalid or old cursors return invalid_cursor. A first-page ID fence excludes later insertions, including old-date backfills. Edits and deletions to existing rows remain live. Read timestamps from start_seconds / end_seconds (integer seconds; 0 means full episode); the MM:SS (or HH:MM:SS) string fields are deprecated. is_appearance filtering applies to person entities only; passing is_appearance=true for any other type returns a 400 (appearances_person_only). details=full attaches per-mention commercial recommendations and requires a Pro+ plan.
      *
      * @param {Arcmira.ListMentionsRequest} request
      * @param {MentionsClient.RequestOptions} requestOptions - Request-specific configuration.