@notiflows/node 0.0.1

package/resources/topics/subscriptions.d.mts

@@ -0,0 +1,137 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as UsersSubscriptionsAPI from "../users/subscriptions.mjs";
+import { SubscriptionsCursorPage } from "../users/subscriptions.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { type CursorPageParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Subscriptions extends APIResource {
+    /**
+     * Retrieve all users subscribed to a specific topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const subscription of client.topics.subscriptions.list(
+     *   'order-updates',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(topicID: string, query?: SubscriptionListParams | null | undefined, options?: RequestOptions): PagePromise<SubscriptionsCursorPage, UsersSubscriptionsAPI.Subscription>;
+    /**
+     * Subscribe multiple users to a topic in a single request.
+     *
+     * - Topics are created automatically if they don't exist.
+     * - If a user is already subscribed, they are included in the `successful`
+     *   response.
+     * - Returns `207 Multi-Status` if some subscriptions failed.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.subscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    subscribeBulk(topicID: string, body: SubscriptionSubscribeBulkParams, options?: RequestOptions): APIPromise<BulkOperationResponse>;
+    /**
+     * Unsubscribe multiple users from a topic in a single request.
+     *
+     * - Returns `207 Multi-Status` if some unsubscriptions failed (e.g., user not
+     *   found).
+     * - Users not subscribed to the topic are included in the `failed` response.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.unsubscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    unsubscribeBulk(topicID: string, body: SubscriptionUnsubscribeBulkParams, options?: RequestOptions): APIPromise<BulkOperationResponse>;
+}
+/**
+ * Response for bulk operations showing successful and failed items
+ */
+export interface BulkOperationResponse {
+    /**
+     * Failed operations with error details
+     */
+    failed: Array<BulkOperationResponse.Failed>;
+    /**
+     * Successfully processed subscriptions
+     */
+    successful: Array<UsersSubscriptionsAPI.Subscription>;
+}
+export declare namespace BulkOperationResponse {
+    /**
+     * Details of a failed bulk operation item
+     */
+    interface Failed {
+        /**
+         * The external ID that failed
+         */
+        external_id: string;
+        /**
+         * Human-readable error reason
+         */
+        reason: string;
+    }
+}
+/**
+ * Request body for bulk subscribe/unsubscribe operations
+ */
+export interface BulkSubscribeRequest {
+    /**
+     * List of user external IDs to subscribe/unsubscribe
+     */
+    user_external_ids: Array<string>;
+}
+export interface SubscriptionListParams extends CursorPageParams {
+    /**
+     * Cursor for fetching the previous page
+     */
+    before?: string;
+    /**
+     * Filter by created after (ISO 8601 datetime)
+     */
+    created_after?: string;
+    /**
+     * Filter by created before (ISO 8601 datetime)
+     */
+    created_before?: string;
+}
+export interface SubscriptionSubscribeBulkParams {
+    /**
+     * List of user external IDs to subscribe/unsubscribe
+     */
+    user_external_ids: Array<string>;
+}
+export interface SubscriptionUnsubscribeBulkParams {
+    /**
+     * List of user external IDs to subscribe/unsubscribe
+     */
+    user_external_ids: Array<string>;
+}
+export declare namespace Subscriptions {
+    export { type BulkOperationResponse as BulkOperationResponse, type BulkSubscribeRequest as BulkSubscribeRequest, type SubscriptionListParams as SubscriptionListParams, type SubscriptionSubscribeBulkParams as SubscriptionSubscribeBulkParams, type SubscriptionUnsubscribeBulkParams as SubscriptionUnsubscribeBulkParams, };
+}
+export { type SubscriptionsCursorPage };
+//# sourceMappingURL=subscriptions.d.mts.map

package/resources/topics/subscriptions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.mts","sourceRoot":"","sources":["../../src/resources/topics/subscriptions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,qBAAqB;OAC1B,EAAE,uBAAuB,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAc,KAAK,gBAAgB,EAAE,WAAW,EAAE;OAClD,EAAE,cAAc,EAAE;AAGzB,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,sBAAsB,GAAG,IAAI,GAAG,SAAc,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,uBAAuB,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAQ3E;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,+BAA+B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iCAAiC,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;CAGrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE5C;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,yBAAiB,qBAAqB,CAAC;IACrC;;OAEG;IACH,UAAiB,MAAM;QACrB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KAChB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH;AAED,OAAO,EAAE,KAAK,uBAAuB,EAAE,CAAC"}

package/resources/topics/subscriptions.d.ts

@@ -0,0 +1,137 @@
+import { APIResource } from "../../core/resource.js";
+import * as UsersSubscriptionsAPI from "../users/subscriptions.js";
+import { SubscriptionsCursorPage } from "../users/subscriptions.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { type CursorPageParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Subscriptions extends APIResource {
+    /**
+     * Retrieve all users subscribed to a specific topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const subscription of client.topics.subscriptions.list(
+     *   'order-updates',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(topicID: string, query?: SubscriptionListParams | null | undefined, options?: RequestOptions): PagePromise<SubscriptionsCursorPage, UsersSubscriptionsAPI.Subscription>;
+    /**
+     * Subscribe multiple users to a topic in a single request.
+     *
+     * - Topics are created automatically if they don't exist.
+     * - If a user is already subscribed, they are included in the `successful`
+     *   response.
+     * - Returns `207 Multi-Status` if some subscriptions failed.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.subscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    subscribeBulk(topicID: string, body: SubscriptionSubscribeBulkParams, options?: RequestOptions): APIPromise<BulkOperationResponse>;
+    /**
+     * Unsubscribe multiple users from a topic in a single request.
+     *
+     * - Returns `207 Multi-Status` if some unsubscriptions failed (e.g., user not
+     *   found).
+     * - Users not subscribed to the topic are included in the `failed` response.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.unsubscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    unsubscribeBulk(topicID: string, body: SubscriptionUnsubscribeBulkParams, options?: RequestOptions): APIPromise<BulkOperationResponse>;
+}
+/**
+ * Response for bulk operations showing successful and failed items
+ */
+export interface BulkOperationResponse {
+    /**
+     * Failed operations with error details
+     */
+    failed: Array<BulkOperationResponse.Failed>;
+    /**
+     * Successfully processed subscriptions
+     */
+    successful: Array<UsersSubscriptionsAPI.Subscription>;
+}
+export declare namespace BulkOperationResponse {
+    /**
+     * Details of a failed bulk operation item
+     */
+    interface Failed {
+        /**
+         * The external ID that failed
+         */
+        external_id: string;
+        /**
+         * Human-readable error reason
+         */
+        reason: string;
+    }
+}
+/**
+ * Request body for bulk subscribe/unsubscribe operations
+ */
+export interface BulkSubscribeRequest {
+    /**
+     * List of user external IDs to subscribe/unsubscribe
+     */
+    user_external_ids: Array<string>;
+}
+export interface SubscriptionListParams extends CursorPageParams {
+    /**
+     * Cursor for fetching the previous page
+     */
+    before?: string;
+    /**
+     * Filter by created after (ISO 8601 datetime)
+     */
+    created_after?: string;
+    /**
+     * Filter by created before (ISO 8601 datetime)
+     */
+    created_before?: string;
+}
+export interface SubscriptionSubscribeBulkParams {
+    /**
+     * List of user external IDs to subscribe/unsubscribe
+     */
+    user_external_ids: Array<string>;
+}
+export interface SubscriptionUnsubscribeBulkParams {
+    /**
+     * List of user external IDs to subscribe/unsubscribe
+     */
+    user_external_ids: Array<string>;
+}
+export declare namespace Subscriptions {
+    export { type BulkOperationResponse as BulkOperationResponse, type BulkSubscribeRequest as BulkSubscribeRequest, type SubscriptionListParams as SubscriptionListParams, type SubscriptionSubscribeBulkParams as SubscriptionSubscribeBulkParams, type SubscriptionUnsubscribeBulkParams as SubscriptionUnsubscribeBulkParams, };
+}
+export { type SubscriptionsCursorPage };
+//# sourceMappingURL=subscriptions.d.ts.map

package/resources/topics/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/resources/topics/subscriptions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,qBAAqB;OAC1B,EAAE,uBAAuB,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAc,KAAK,gBAAgB,EAAE,WAAW,EAAE;OAClD,EAAE,cAAc,EAAE;AAGzB,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,sBAAsB,GAAG,IAAI,GAAG,SAAc,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,uBAAuB,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAQ3E;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,+BAA+B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iCAAiC,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;CAGrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE5C;;OAEG;IACH,UAAU,EAAE,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,yBAAiB,qBAAqB,CAAC;IACrC;;OAEG;IACH,UAAiB,MAAM;QACrB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KAChB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH;AAED,OAAO,EAAE,KAAK,uBAAuB,EAAE,CAAC"}

package/resources/topics/subscriptions.js

@@ -0,0 +1,78 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subscriptions = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+class Subscriptions extends resource_1.APIResource {
+    /**
+     * Retrieve all users subscribed to a specific topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const subscription of client.topics.subscriptions.list(
+     *   'order-updates',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(topicID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/topics/${topicID}/subscriptions`, (pagination_1.CursorPage), { query, ...options });
+    }
+    /**
+     * Subscribe multiple users to a topic in a single request.
+     *
+     * - Topics are created automatically if they don't exist.
+     * - If a user is already subscribed, they are included in the `successful`
+     *   response.
+     * - Returns `207 Multi-Status` if some subscriptions failed.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.subscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    subscribeBulk(topicID, body, options) {
+        return this._client.post((0, path_1.path) `/topics/${topicID}/subscriptions`, { body, ...options });
+    }
+    /**
+     * Unsubscribe multiple users from a topic in a single request.
+     *
+     * - Returns `207 Multi-Status` if some unsubscriptions failed (e.g., user not
+     *   found).
+     * - Users not subscribed to the topic are included in the `failed` response.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.unsubscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    unsubscribeBulk(topicID, body, options) {
+        return this._client.delete((0, path_1.path) `/topics/${topicID}/subscriptions`, { body, ...options });
+    }
+}
+exports.Subscriptions = Subscriptions;
+//# sourceMappingURL=subscriptions.js.map

package/resources/topics/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/resources/topics/subscriptions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,yDAAuF;AAEvF,uDAAiD;AAEjD,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,OAAe,EACf,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,WAAW,OAAO,gBAAgB,EACtC,CAAA,uBAA8C,CAAA,EAC9C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CACX,OAAe,EACf,IAAqC,EACrC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CACb,OAAe,EACf,IAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF;AAtFD,sCAsFC"}

package/resources/topics/subscriptions.mjs

@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { CursorPage } from "../../core/pagination.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Subscriptions extends APIResource {
+    /**
+     * Retrieve all users subscribed to a specific topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const subscription of client.topics.subscriptions.list(
+     *   'order-updates',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(topicID, query = {}, options) {
+        return this._client.getAPIList(path `/topics/${topicID}/subscriptions`, (CursorPage), { query, ...options });
+    }
+    /**
+     * Subscribe multiple users to a topic in a single request.
+     *
+     * - Topics are created automatically if they don't exist.
+     * - If a user is already subscribed, they are included in the `successful`
+     *   response.
+     * - Returns `207 Multi-Status` if some subscriptions failed.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.subscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    subscribeBulk(topicID, body, options) {
+        return this._client.post(path `/topics/${topicID}/subscriptions`, { body, ...options });
+    }
+    /**
+     * Unsubscribe multiple users from a topic in a single request.
+     *
+     * - Returns `207 Multi-Status` if some unsubscriptions failed (e.g., user not
+     *   found).
+     * - Users not subscribed to the topic are included in the `failed` response.
+     *
+     * @example
+     * ```ts
+     * const bulkOperationResponse =
+     *   await client.topics.subscriptions.unsubscribeBulk(
+     *     'order-updates',
+     *     {
+     *       user_external_ids: [
+     *         'user_12345',
+     *         'user_67890',
+     *         'user_11111',
+     *       ],
+     *     },
+     *   );
+     * ```
+     */
+    unsubscribeBulk(topicID, body, options) {
+        return this._client.delete(path `/topics/${topicID}/subscriptions`, { body, ...options });
+    }
+}
+//# sourceMappingURL=subscriptions.mjs.map

package/resources/topics/subscriptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.mjs","sourceRoot":"","sources":["../../src/resources/topics/subscriptions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,UAAU,EAAsC;OAElD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,OAAe,EACf,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,WAAW,OAAO,gBAAgB,EACtC,CAAA,UAA8C,CAAA,EAC9C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CACX,OAAe,EACf,IAAqC,EACrC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,OAAO,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CACb,OAAe,EACf,IAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,WAAW,OAAO,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/resources/topics/topics.d.mts

@@ -0,0 +1,70 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as SubscriptionsAPI from "./subscriptions.mjs";
+import { BulkOperationResponse, BulkSubscribeRequest, SubscriptionListParams, SubscriptionSubscribeBulkParams, SubscriptionUnsubscribeBulkParams, Subscriptions } from "./subscriptions.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { CursorPage, type CursorPageParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Topics extends APIResource {
+    subscriptions: SubscriptionsAPI.Subscriptions;
+    /**
+     * Retrieve a topic by name.
+     *
+     * @example
+     * ```ts
+     * const topic = await client.topics.retrieve('order-updates');
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<Topic>;
+    /**
+     * Retrieve a paginated list of all topics in your project.
+     *
+     * Topics are used for pub/sub notification patterns. Users subscribe to topics,
+     * and you can run notiflows for all subscribers of a topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const topic of client.topics.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: TopicListParams | null | undefined, options?: RequestOptions): PagePromise<TopicsCursorPage, Topic>;
+    /**
+     * Delete a topic and all its subscriptions.
+     *
+     * **Warning:** This removes all user subscriptions to this topic. Users will need
+     * to re-subscribe if the topic is recreated.
+     *
+     * @example
+     * ```ts
+     * await client.topics.delete('order-updates');
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+}
+export type TopicsCursorPage = CursorPage<Topic>;
+/**
+ * A topic for pub/sub notification patterns
+ */
+export interface Topic {
+    /**
+     * When the topic was created
+     */
+    created_at: string;
+    /**
+     * Unique topic name within your project
+     */
+    name: string;
+}
+export interface TopicListParams extends CursorPageParams {
+    /**
+     * Cursor for fetching the previous page
+     */
+    before?: string;
+}
+export declare namespace Topics {
+    export { type Topic as Topic, type TopicsCursorPage as TopicsCursorPage, type TopicListParams as TopicListParams, };
+    export { Subscriptions as Subscriptions, type BulkOperationResponse as BulkOperationResponse, type BulkSubscribeRequest as BulkSubscribeRequest, type SubscriptionListParams as SubscriptionListParams, type SubscriptionSubscribeBulkParams as SubscriptionSubscribeBulkParams, type SubscriptionUnsubscribeBulkParams as SubscriptionUnsubscribeBulkParams, };
+}
+//# sourceMappingURL=topics.d.mts.map

package/resources/topics/topics.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.mts","sourceRoot":"","sources":["../../src/resources/topics/topics.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,gBAAgB;OACrB,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,EAC/B,iCAAiC,EACjC,aAAa,EACd;OACM,EAAE,UAAU,EAAE;OACd,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE;OAElD,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IAEjG;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;IAIjE;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,gBAAgB,EAAE,KAAK,CAAC;IAIvC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;IAEF,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH"}

package/resources/topics/topics.d.ts

@@ -0,0 +1,70 @@
+import { APIResource } from "../../core/resource.js";
+import * as SubscriptionsAPI from "./subscriptions.js";
+import { BulkOperationResponse, BulkSubscribeRequest, SubscriptionListParams, SubscriptionSubscribeBulkParams, SubscriptionUnsubscribeBulkParams, Subscriptions } from "./subscriptions.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { CursorPage, type CursorPageParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Topics extends APIResource {
+    subscriptions: SubscriptionsAPI.Subscriptions;
+    /**
+     * Retrieve a topic by name.
+     *
+     * @example
+     * ```ts
+     * const topic = await client.topics.retrieve('order-updates');
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<Topic>;
+    /**
+     * Retrieve a paginated list of all topics in your project.
+     *
+     * Topics are used for pub/sub notification patterns. Users subscribe to topics,
+     * and you can run notiflows for all subscribers of a topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const topic of client.topics.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: TopicListParams | null | undefined, options?: RequestOptions): PagePromise<TopicsCursorPage, Topic>;
+    /**
+     * Delete a topic and all its subscriptions.
+     *
+     * **Warning:** This removes all user subscriptions to this topic. Users will need
+     * to re-subscribe if the topic is recreated.
+     *
+     * @example
+     * ```ts
+     * await client.topics.delete('order-updates');
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+}
+export type TopicsCursorPage = CursorPage<Topic>;
+/**
+ * A topic for pub/sub notification patterns
+ */
+export interface Topic {
+    /**
+     * When the topic was created
+     */
+    created_at: string;
+    /**
+     * Unique topic name within your project
+     */
+    name: string;
+}
+export interface TopicListParams extends CursorPageParams {
+    /**
+     * Cursor for fetching the previous page
+     */
+    before?: string;
+}
+export declare namespace Topics {
+    export { type Topic as Topic, type TopicsCursorPage as TopicsCursorPage, type TopicListParams as TopicListParams, };
+    export { Subscriptions as Subscriptions, type BulkOperationResponse as BulkOperationResponse, type BulkSubscribeRequest as BulkSubscribeRequest, type SubscriptionListParams as SubscriptionListParams, type SubscriptionSubscribeBulkParams as SubscriptionSubscribeBulkParams, type SubscriptionUnsubscribeBulkParams as SubscriptionUnsubscribeBulkParams, };
+}
+//# sourceMappingURL=topics.d.ts.map

package/resources/topics/topics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../src/resources/topics/topics.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,gBAAgB;OACrB,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,EAC/B,iCAAiC,EACjC,aAAa,EACd;OACM,EAAE,UAAU,EAAE;OACd,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE;OAElD,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IAEjG;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;IAIjE;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,gBAAgB,EAAE,KAAK,CAAC;IAIvC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;IAEF,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,iCAAiC,IAAI,iCAAiC,GAC5E,CAAC;CACH"}

package/resources/topics/topics.js

@@ -0,0 +1,65 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Topics = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const SubscriptionsAPI = tslib_1.__importStar(require("./subscriptions.js"));
+const subscriptions_1 = require("./subscriptions.js");
+const pagination_1 = require("../../core/pagination.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Topics extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.subscriptions = new SubscriptionsAPI.Subscriptions(this._client);
+    }
+    /**
+     * Retrieve a topic by name.
+     *
+     * @example
+     * ```ts
+     * const topic = await client.topics.retrieve('order-updates');
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/topics/${id}`, options);
+    }
+    /**
+     * Retrieve a paginated list of all topics in your project.
+     *
+     * Topics are used for pub/sub notification patterns. Users subscribe to topics,
+     * and you can run notiflows for all subscribers of a topic.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const topic of client.topics.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/topics', (pagination_1.CursorPage), { query, ...options });
+    }
+    /**
+     * Delete a topic and all its subscriptions.
+     *
+     * **Warning:** This removes all user subscriptions to this topic. Users will need
+     * to re-subscribe if the topic is recreated.
+     *
+     * @example
+     * ```ts
+     * await client.topics.delete('order-updates');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/topics/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Topics = Topics;
+Topics.Subscriptions = subscriptions_1.Subscriptions;
+//# sourceMappingURL=topics.js.map

package/resources/topics/topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/resources/topics/topics.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6EAAoD;AACpD,sDAOyB;AAEzB,yDAAuF;AACvF,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,MAAO,SAAQ,sBAAW;IAAvC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAoDnG,CAAC;IAlDC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,uBAAiB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,WAAW,EAAE,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AArDD,wBAqDC;AA0BD,MAAM,CAAC,aAAa,GAAG,6BAAa,CAAC"}