@notiflows/node 0.0.1

package/resources/users/users.d.ts

@@ -0,0 +1,216 @@
+import { APIResource } from "../../core/resource.js";
+import * as ChannelSettingsAPI from "./channel-settings.js";
+import { ChannelSettingDeleteParams, ChannelSettingRetrieveParams, ChannelSettingUpdateParams, ChannelSettings, MobilePushSettings, SlackSettings } from "./channel-settings.js";
+import * as DeliveriesAPI from "./deliveries.js";
+import { Deliveries, DeliveryListParams, DeliveryRetrieveParams } from "./deliveries.js";
+import * as NotificationsAPI from "./notifications.js";
+import { NotificationListParams, NotificationRetrieveParams, Notifications } from "./notifications.js";
+import * as PreferencesAPI from "./preferences.js";
+import { PreferenceUpdateParams, Preferences, UpdatePreferencesRequest } from "./preferences.js";
+import * as SubscriptionsAPI from "./subscriptions.js";
+import { Subscription, SubscriptionListParams, SubscriptionRetrieveParams, SubscriptionSubscribeParams, SubscriptionUnsubscribeParams, Subscriptions, SubscriptionsCursorPage } 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 Users extends APIResource {
+    channelSettings: ChannelSettingsAPI.ChannelSettings;
+    deliveries: DeliveriesAPI.Deliveries;
+    notifications: NotificationsAPI.Notifications;
+    preferences: PreferencesAPI.Preferences;
+    subscriptions: SubscriptionsAPI.Subscriptions;
+    /**
+     * Retrieve a single user by their external ID. The external ID is the identifier
+     * you assigned when creating the user.
+     *
+     * @example
+     * ```ts
+     * const user = await client.users.retrieve('user_12345');
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<User>;
+    /**
+     * Retrieve a paginated list of users in your project. Users are sorted by creation
+     * date (newest first).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const user of client.users.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: UserListParams | null | undefined, options?: RequestOptions): PagePromise<UsersCursorPage, User>;
+    /**
+     * Permanently delete a user and all their associated data including:
+     *
+     * - Subscriptions
+     * - Preferences
+     * - Channel settings
+     * - Notifications and deliveries
+     *
+     * **This action cannot be undone.**
+     *
+     * @example
+     * ```ts
+     * await client.users.delete('user_12345');
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Create a new user or update an existing user by external ID (upsert operation).
+     *
+     * - If the user doesn't exist, they will be created with the provided attributes.
+     * - If the user exists, their attributes will be updated (merge behavior).
+     * - `custom_fields` are deep-merged with existing values.
+     *
+     * **Returns:**
+     *
+     * - `201 Created` when a new user is created
+     * - `200 OK` when an existing user is updated
+     *
+     * @example
+     * ```ts
+     * const user = await client.users.upsert('user_12345', {
+     *   external_id: 'user_12345',
+     * });
+     * ```
+     */
+    upsert(id: string, body: UserUpsertParams, options?: RequestOptions): APIPromise<User>;
+}
+export type UsersCursorPage = CursorPage<User>;
+/**
+ * A user (recipient) in your project
+ */
+export interface User {
+    /**
+     * Internal Notiflows user ID (UUIDv7)
+     */
+    id: string;
+    /**
+     * When the user was created (ISO 8601)
+     */
+    created_at: string;
+    /**
+     * Your system's unique identifier for this user
+     */
+    external_id: string;
+    /**
+     * When the user was last updated (ISO 8601)
+     */
+    updated_at: string;
+    /**
+     * URL to user's avatar image (must be https://)
+     */
+    avatar?: string | null;
+    /**
+     * Arbitrary JSON object for additional user attributes. Accessible in templates as
+     * `recipient.custom_fields.*`
+     */
+    custom_fields?: unknown | null;
+    /**
+     * User's email address for email notifications
+     */
+    email?: string | null;
+    /**
+     * User's first name for personalization
+     */
+    first_name?: string | null;
+    /**
+     * User's last name for personalization
+     */
+    last_name?: string | null;
+    /**
+     * BCP 47 locale code for localized notifications
+     */
+    locale?: string | null;
+    /**
+     * User's phone number in E.164 format for SMS notifications
+     */
+    phone?: string | null;
+    /**
+     * IANA timezone for time-sensitive notifications
+     */
+    timezone?: string | null;
+}
+export interface UserListParams extends CursorPageParams {
+    /**
+     * Cursor for fetching the previous page
+     */
+    before?: string;
+    /**
+     * Filter users created after this datetime (ISO 8601)
+     */
+    created_after?: string;
+    /**
+     * Filter users created before this datetime (ISO 8601)
+     */
+    created_before?: string;
+}
+export interface UserUpsertParams {
+    /**
+     * Your system's unique identifier for this user. Required for creating new users.
+     */
+    external_id: string;
+    /**
+     * URL to user's avatar image (must start with http:// or https://)
+     */
+    avatar?: string;
+    /**
+     * Initial channel settings (e.g., device tokens for push)
+     */
+    channel_settings?: Array<UserUpsertParams.ChannelSetting>;
+    /**
+     * Custom attributes. Deep-merged with existing values on update.
+     */
+    custom_fields?: unknown;
+    /**
+     * User's email address
+     */
+    email?: string;
+    /**
+     * User's first name
+     */
+    first_name?: string;
+    /**
+     * User's last name
+     */
+    last_name?: string;
+    /**
+     * BCP 47 locale code (e.g., en-US, es-ES, fr-FR)
+     */
+    locale?: string;
+    /**
+     * User's phone number in E.164 format
+     */
+    phone?: string;
+    /**
+     * Request body for updating user preferences. Only provided fields are updated.
+     */
+    preferences?: PreferencesAPI.UpdatePreferencesRequest;
+    /**
+     * IANA timezone (e.g., America/New_York, Europe/London)
+     */
+    timezone?: string;
+}
+export declare namespace UserUpsertParams {
+    interface ChannelSetting {
+        /**
+         * Channel ID
+         */
+        channel_id: string;
+        /**
+         * Provider-specific settings
+         */
+        settings: unknown;
+    }
+}
+export declare namespace Users {
+    export { type User as User, type UsersCursorPage as UsersCursorPage, type UserListParams as UserListParams, type UserUpsertParams as UserUpsertParams, };
+    export { type ChannelSettings as ChannelSettings, type MobilePushSettings as MobilePushSettings, type SlackSettings as SlackSettings, type ChannelSettingRetrieveParams as ChannelSettingRetrieveParams, type ChannelSettingUpdateParams as ChannelSettingUpdateParams, type ChannelSettingDeleteParams as ChannelSettingDeleteParams, };
+    export { Deliveries as Deliveries, type DeliveryRetrieveParams as DeliveryRetrieveParams, type DeliveryListParams as DeliveryListParams, };
+    export { Notifications as Notifications, type NotificationRetrieveParams as NotificationRetrieveParams, type NotificationListParams as NotificationListParams, };
+    export { type Preferences as Preferences, type UpdatePreferencesRequest as UpdatePreferencesRequest, type PreferenceUpdateParams as PreferenceUpdateParams, };
+    export { Subscriptions as Subscriptions, type Subscription as Subscription, type SubscriptionsCursorPage as SubscriptionsCursorPage, type SubscriptionRetrieveParams as SubscriptionRetrieveParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionSubscribeParams as SubscriptionSubscribeParams, type SubscriptionUnsubscribeParams as SubscriptionUnsubscribeParams, };
+}
+//# sourceMappingURL=users.d.ts.map

package/resources/users/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/resources/users/users.ts"],"names":[],"mappings":"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"}

package/resources/users/users.js

@@ -0,0 +1,102 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Users = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const ChannelSettingsAPI = tslib_1.__importStar(require("./channel-settings.js"));
+const DeliveriesAPI = tslib_1.__importStar(require("./deliveries.js"));
+const deliveries_1 = require("./deliveries.js");
+const NotificationsAPI = tslib_1.__importStar(require("./notifications.js"));
+const notifications_1 = require("./notifications.js");
+const PreferencesAPI = tslib_1.__importStar(require("./preferences.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 Users extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.channelSettings = new ChannelSettingsAPI.ChannelSettings(this._client);
+        this.deliveries = new DeliveriesAPI.Deliveries(this._client);
+        this.notifications = new NotificationsAPI.Notifications(this._client);
+        this.preferences = new PreferencesAPI.Preferences(this._client);
+        this.subscriptions = new SubscriptionsAPI.Subscriptions(this._client);
+    }
+    /**
+     * Retrieve a single user by their external ID. The external ID is the identifier
+     * you assigned when creating the user.
+     *
+     * @example
+     * ```ts
+     * const user = await client.users.retrieve('user_12345');
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/users/${id}`, options);
+    }
+    /**
+     * Retrieve a paginated list of users in your project. Users are sorted by creation
+     * date (newest first).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const user of client.users.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/users', (pagination_1.CursorPage), { query, ...options });
+    }
+    /**
+     * Permanently delete a user and all their associated data including:
+     *
+     * - Subscriptions
+     * - Preferences
+     * - Channel settings
+     * - Notifications and deliveries
+     *
+     * **This action cannot be undone.**
+     *
+     * @example
+     * ```ts
+     * await client.users.delete('user_12345');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/users/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Create a new user or update an existing user by external ID (upsert operation).
+     *
+     * - If the user doesn't exist, they will be created with the provided attributes.
+     * - If the user exists, their attributes will be updated (merge behavior).
+     * - `custom_fields` are deep-merged with existing values.
+     *
+     * **Returns:**
+     *
+     * - `201 Created` when a new user is created
+     * - `200 OK` when an existing user is updated
+     *
+     * @example
+     * ```ts
+     * const user = await client.users.upsert('user_12345', {
+     *   external_id: 'user_12345',
+     * });
+     * ```
+     */
+    upsert(id, body, options) {
+        return this._client.put((0, path_1.path) `/users/${id}`, { body, ...options });
+    }
+}
+exports.Users = Users;
+Users.Deliveries = deliveries_1.Deliveries;
+Users.Notifications = notifications_1.Notifications;
+Users.Subscriptions = subscriptions_1.Subscriptions;
+//# sourceMappingURL=users.js.map

package/resources/users/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/resources/users/users.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,kFAAyD;AASzD,uEAA8C;AAC9C,gDAAsF;AACtF,6EAAoD;AACpD,sDAAoG;AACpG,yEAAgD;AAEhD,6EAAoD;AACpD,sDAQyB;AAEzB,yDAAuF;AACvF,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,oBAAe,GAAuC,IAAI,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3G,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvF,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA8EnG,CAAC;IA5EC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAA,uBAAgB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,EAAE,EAAE;YAC7C,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;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AAnFD,sBAmFC;AA8JD,KAAK,CAAC,UAAU,GAAG,uBAAU,CAAC;AAC9B,KAAK,CAAC,aAAa,GAAG,6BAAa,CAAC;AACpC,KAAK,CAAC,aAAa,GAAG,6BAAa,CAAC"}

package/resources/users/users.mjs

@@ -0,0 +1,97 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as ChannelSettingsAPI from "./channel-settings.mjs";
+import * as DeliveriesAPI from "./deliveries.mjs";
+import { Deliveries } from "./deliveries.mjs";
+import * as NotificationsAPI from "./notifications.mjs";
+import { Notifications } from "./notifications.mjs";
+import * as PreferencesAPI from "./preferences.mjs";
+import * as SubscriptionsAPI from "./subscriptions.mjs";
+import { Subscriptions, } from "./subscriptions.mjs";
+import { CursorPage } from "../../core/pagination.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Users extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.channelSettings = new ChannelSettingsAPI.ChannelSettings(this._client);
+        this.deliveries = new DeliveriesAPI.Deliveries(this._client);
+        this.notifications = new NotificationsAPI.Notifications(this._client);
+        this.preferences = new PreferencesAPI.Preferences(this._client);
+        this.subscriptions = new SubscriptionsAPI.Subscriptions(this._client);
+    }
+    /**
+     * Retrieve a single user by their external ID. The external ID is the identifier
+     * you assigned when creating the user.
+     *
+     * @example
+     * ```ts
+     * const user = await client.users.retrieve('user_12345');
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/users/${id}`, options);
+    }
+    /**
+     * Retrieve a paginated list of users in your project. Users are sorted by creation
+     * date (newest first).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const user of client.users.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/users', (CursorPage), { query, ...options });
+    }
+    /**
+     * Permanently delete a user and all their associated data including:
+     *
+     * - Subscriptions
+     * - Preferences
+     * - Channel settings
+     * - Notifications and deliveries
+     *
+     * **This action cannot be undone.**
+     *
+     * @example
+     * ```ts
+     * await client.users.delete('user_12345');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/users/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Create a new user or update an existing user by external ID (upsert operation).
+     *
+     * - If the user doesn't exist, they will be created with the provided attributes.
+     * - If the user exists, their attributes will be updated (merge behavior).
+     * - `custom_fields` are deep-merged with existing values.
+     *
+     * **Returns:**
+     *
+     * - `201 Created` when a new user is created
+     * - `200 OK` when an existing user is updated
+     *
+     * @example
+     * ```ts
+     * const user = await client.users.upsert('user_12345', {
+     *   external_id: 'user_12345',
+     * });
+     * ```
+     */
+    upsert(id, body, options) {
+        return this._client.put(path `/users/${id}`, { body, ...options });
+    }
+}
+Users.Deliveries = Deliveries;
+Users.Notifications = Notifications;
+Users.Subscriptions = Subscriptions;
+//# sourceMappingURL=users.mjs.map

package/resources/users/users.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.mjs","sourceRoot":"","sources":["../../src/resources/users/users.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,kBAAkB;OASvB,KAAK,aAAa;OAClB,EAAE,UAAU,EAA8C;OAC1D,KAAK,gBAAgB;OACrB,EAAsD,aAAa,EAAE;OACrE,KAAK,cAAc;OAEnB,KAAK,gBAAgB;OACrB,EAML,aAAa,GAEd;OAEM,EAAE,UAAU,EAAsC;OAClD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,oBAAe,GAAuC,IAAI,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3G,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvF,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA8EnG,CAAC;IA5EC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAA,UAAgB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,UAAU,EAAE,EAAE,EAAE;YAC7C,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AA8JD,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;AAC9B,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;AACpC,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC"}

package/resources/users.d.mts

@@ -0,0 +1,2 @@
+export * from "./users/index.mjs";
+//# sourceMappingURL=users.d.mts.map

package/resources/users.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.mts","sourceRoot":"","sources":["../src/resources/users.ts"],"names":[],"mappings":""}

package/resources/users.d.ts

@@ -0,0 +1,2 @@
+export * from "./users/index.js";
+//# sourceMappingURL=users.d.ts.map

package/resources/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../src/resources/users.ts"],"names":[],"mappings":""}

package/resources/users.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./users/index.js"), exports);
+//# sourceMappingURL=users.js.map

package/resources/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../src/resources/users.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAA8B"}

package/resources/users.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./users/index.mjs";
+//# sourceMappingURL=users.mjs.map

package/resources/users.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.mjs","sourceRoot":"","sources":["../src/resources/users.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources.d.mts

@@ -0,0 +1,2 @@
+export * from "./resources/index.mjs";
+//# sourceMappingURL=resources.d.mts.map

package/resources.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.mts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}

package/resources.d.ts

@@ -0,0 +1,2 @@
+export * from "./resources/index.js";
+//# sourceMappingURL=resources.d.ts.map

package/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}

package/resources.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+tslib_1.__exportStar(require("./resources/index.js"), exports);
+//# sourceMappingURL=resources.js.map

package/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":";;;AAAA,+DAAkC"}

package/resources.mjs

@@ -0,0 +1,2 @@
+export * from "./resources/index.mjs";
+//# sourceMappingURL=resources.mjs.map

package/resources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.mjs","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}

package/src/api-promise.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/api-promise instead */
+export * from './core/api-promise';