magicbell-js 0.0.2 → 0.0.4

package/src/project-client/index.ts

@@ -0,0 +1,94 @@
+import { Environment } from './http/environment.js';
+import { SdkConfig } from './http/types.js';
+import { BroadcastsService } from './services/broadcasts/index.js';
+import { ChannelsService } from './services/channels/index.js';
+import { EventsService } from './services/events/index.js';
+import { IntegrationsService } from './services/integrations/index.js';
+import { JwtService } from './services/jwt/index.js';
+import { NotificationsService } from './services/notifications/index.js';
+import { UsersService } from './services/users/index.js';
+
+export { Environment } from './http/environment.js';
+export * from './http/index.js';
+export * from './services/broadcasts/index.js';
+export * from './services/channels/index.js';
+export * from './services/common/index.js';
+export * from './services/events/index.js';
+export * from './services/integrations/index.js';
+export * from './services/jwt/index.js';
+export * from './services/notifications/index.js';
+export * from './services/users/index.js';
+
+export class Client {
+  public readonly broadcasts: BroadcastsService;
+
+  public readonly channels: ChannelsService;
+
+  public readonly events: EventsService;
+
+  public readonly integrations: IntegrationsService;
+
+  public readonly jwt: JwtService;
+
+  public readonly notifications: NotificationsService;
+
+  public readonly users: UsersService;
+
+  constructor(public config: SdkConfig) {
+    this.broadcasts = new BroadcastsService(this.config);
+
+    this.channels = new ChannelsService(this.config);
+
+    this.events = new EventsService(this.config);
+
+    this.integrations = new IntegrationsService(this.config);
+
+    this.jwt = new JwtService(this.config);
+
+    this.notifications = new NotificationsService(this.config);
+
+    this.users = new UsersService(this.config);
+  }
+
+  set baseUrl(baseUrl: string) {
+    this.broadcasts.baseUrl = baseUrl;
+    this.channels.baseUrl = baseUrl;
+    this.events.baseUrl = baseUrl;
+    this.integrations.baseUrl = baseUrl;
+    this.jwt.baseUrl = baseUrl;
+    this.notifications.baseUrl = baseUrl;
+    this.users.baseUrl = baseUrl;
+  }
+
+  set environment(environment: Environment) {
+    this.broadcasts.baseUrl = environment;
+    this.channels.baseUrl = environment;
+    this.events.baseUrl = environment;
+    this.integrations.baseUrl = environment;
+    this.jwt.baseUrl = environment;
+    this.notifications.baseUrl = environment;
+    this.users.baseUrl = environment;
+  }
+
+  set timeoutMs(timeoutMs: number) {
+    this.broadcasts.timeoutMs = timeoutMs;
+    this.channels.timeoutMs = timeoutMs;
+    this.events.timeoutMs = timeoutMs;
+    this.integrations.timeoutMs = timeoutMs;
+    this.jwt.timeoutMs = timeoutMs;
+    this.notifications.timeoutMs = timeoutMs;
+    this.users.timeoutMs = timeoutMs;
+  }
+
+  set token(token: string) {
+    this.broadcasts.token = token;
+    this.channels.token = token;
+    this.events.token = token;
+    this.integrations.token = token;
+    this.jwt.token = token;
+    this.notifications.token = token;
+    this.users.token = token;
+  }
+}
+
+// c029837e0e474b76bc487506e8799df5e3335891efe4fb02bda7a1441840310c

package/src/project-client/services/base-service.ts

@@ -0,0 +1,27 @@
+import { HttpClient } from '../http/client.js';
+import { Environment } from '../http/environment.js';
+import { SdkConfig } from '../http/types.js';
+
+export class BaseService {
+  public client: HttpClient;
+
+  constructor(public config: SdkConfig) {
+    this.client = new HttpClient(this.config);
+  }
+
+  set baseUrl(baseUrl: string) {
+    this.config.baseUrl = baseUrl;
+  }
+
+  set environment(environment: Environment) {
+    this.config.environment = environment;
+  }
+
+  set timeoutMs(timeoutMs: number) {
+    this.config.timeoutMs = timeoutMs;
+  }
+
+  set token(token: string) {
+    this.config.token = token;
+  }
+}

package/src/project-client/services/broadcasts/broadcasts-service.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+
+import { Environment } from '../../http/environment.js';
+import { SerializationStyle } from '../../http/serialization/base-serializer.js';
+import { RequestBuilder } from '../../http/transport/request-builder.js';
+import { ContentType, HttpResponse, RequestConfig } from '../../http/types.js';
+import { BaseService } from '../base-service.js';
+import { Broadcast, broadcastRequest, broadcastResponse } from './models/broadcast.js';
+import { BroadcastCollection, broadcastCollectionResponse } from './models/broadcast-collection.js';
+import { ListBroadcastsParams } from './request-params.js';
+
+export class BroadcastsService extends BaseService {
+  /**
+   * Retrieves a paginated list of broadcasts for the project. Returns basic information about each broadcast including its creation time and status.
+   * @param {number} [params.limit] -
+   * @param {string} [params.startingAfter] -
+   * @param {string} [params.endingBefore] -
+   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<BroadcastCollection>>} OK
+   */
+  async listBroadcasts(
+    params?: ListBroadcastsParams,
+    requestConfig?: RequestConfig,
+  ): Promise<HttpResponse<BroadcastCollection>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('GET')
+      .setPath('/broadcasts')
+      .setRequestSchema(z.any())
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: broadcastCollectionResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addQueryParam({
+        key: 'limit',
+        value: params?.limit,
+      })
+      .addQueryParam({
+        key: 'starting_after',
+        value: params?.startingAfter,
+      })
+      .addQueryParam({
+        key: 'ending_before',
+        value: params?.endingBefore,
+      })
+      .build();
+    return this.client.call<BroadcastCollection>(request);
+  }
+
+  /**
+   * Creates a new broadcast message. When a broadcast is created, it generates individual notifications for relevant users within the project.
+   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<Broadcast>>} Created
+   */
+  async createBroadcast(body: Broadcast, requestConfig?: RequestConfig): Promise<HttpResponse<Broadcast>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('POST')
+      .setPath('/broadcasts')
+      .setRequestSchema(broadcastRequest)
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: broadcastResponse,
+        contentType: ContentType.Json,
+        status: 201,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addHeaderParam({ key: 'Content-Type', value: 'application/json' })
+      .addBody(body)
+      .build();
+    return this.client.call<Broadcast>(request);
+  }
+
+  /**
+   * Retrieves detailed information about a specific broadcast by its ID. Includes the broadcast's configuration and current status.
+   * @param {string} broadcastId -
+   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<Broadcast>>} OK
+   */
+  async fetchBroadcast(broadcastId: string, requestConfig?: RequestConfig): Promise<HttpResponse<Broadcast>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('GET')
+      .setPath('/broadcasts/{broadcast_id}')
+      .setRequestSchema(z.any())
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: broadcastResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addPathParam({
+        key: 'broadcast_id',
+        value: broadcastId,
+      })
+      .build();
+    return this.client.call<Broadcast>(request);
+  }
+}

package/src/project-client/services/broadcasts/index.ts

@@ -0,0 +1,2 @@
+export { BroadcastsService } from './broadcasts-service.js';
+export * from './models/index.js';

package/src/project-client/services/broadcasts/models/broadcast-collection.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+
+import { Links, links, linksRequest, linksResponse } from '../../common/links.js';
+import { Broadcast, broadcast, broadcastRequest, broadcastResponse } from './broadcast.js';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const broadcastCollection = z.lazy(() => {
+  return z.object({
+    data: z.array(broadcast).optional(),
+    links: links.optional(),
+  });
+});
+
+/**
+ *
+ * @typedef  {BroadcastCollection} broadcastCollection
+ * @property {Broadcast[]}
+ * @property {Links}
+ */
+export type BroadcastCollection = z.infer<typeof broadcastCollection>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const broadcastCollectionResponse = z.lazy(() => {
+  return z
+    .object({
+      data: z.array(broadcastResponse).optional(),
+      links: linksResponse.optional(),
+    })
+    .transform((data) => ({
+      data: data['data'],
+      links: data['links'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const broadcastCollectionRequest = z.lazy(() => {
+  return z
+    .object({
+      data: z.array(broadcastRequest).optional(),
+      links: linksRequest.optional(),
+    })
+    .transform((data) => ({
+      data: data['data'],
+      links: data['links'],
+    }));
+});

package/src/project-client/services/broadcasts/models/broadcast-status.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+
+import { Errors, errors, errorsRequest, errorsResponse } from './errors.js';
+import { Summary, summary, summaryRequest, summaryResponse } from './summary.js';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const broadcastStatus = z.lazy(() => {
+  return z.object({
+    errors: z.array(errors).nullable(),
+    status: z.string(),
+    summary: summary,
+  });
+});
+
+/**
+ *
+ * @typedef  {BroadcastStatus} broadcastStatus
+ * @property {Errors[]}
+ * @property {StatusStatus}
+ * @property {Summary}
+ */
+export type BroadcastStatus = z.infer<typeof broadcastStatus>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const broadcastStatusResponse = z.lazy(() => {
+  return z
+    .object({
+      errors: z.array(errorsResponse).nullable(),
+      status: z.string(),
+      summary: summaryResponse,
+    })
+    .transform((data) => ({
+      errors: data['errors'],
+      status: data['status'],
+      summary: data['summary'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const broadcastStatusRequest = z.lazy(() => {
+  return z
+    .object({
+      errors: z.array(errorsRequest).nullable(),
+      status: z.string(),
+      summary: summaryRequest,
+    })
+    .transform((data) => ({
+      errors: data['errors'],
+      status: data['status'],
+      summary: data['summary'],
+    }));
+});

package/src/project-client/services/broadcasts/models/broadcast.ts

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+
+import {
+  BroadcastStatus,
+  broadcastStatus,
+  broadcastStatusRequest,
+  broadcastStatusResponse,
+} from './broadcast-status.js';
+import { Overrides, overrides, overridesRequest, overridesResponse } from './overrides.js';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const broadcast = z.lazy(() => {
+  return z.object({
+    actionUrl: z.string().max(2048).optional().nullable(),
+    category: z
+      .string()
+      .max(255)
+      .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+      .optional()
+      .nullable(),
+    content: z.string().max(10485760).optional().nullable(),
+    createdAt: z.string().optional(),
+    customAttributes: z.any().optional().nullable(),
+    id: z.string().optional(),
+    overrides: overrides.optional().nullable(),
+    recipients: z.array(z.any()).min(1).max(1000).nullable(),
+    status: broadcastStatus.optional().nullable(),
+    title: z.string().min(1).max(255),
+    topic: z
+      .string()
+      .max(255)
+      .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+      .optional()
+      .nullable(),
+  });
+});
+
+/**
+ *
+ * @typedef  {Broadcast} broadcast
+ * @property {string}
+ * @property {string}
+ * @property {string}
+ * @property {string} - The timestamp when the broadcast was created.
+ * @property {any}
+ * @property {string} - The unique id for this broadcast.
+ * @property {Overrides}
+ * @property {any[]}
+ * @property {BroadcastStatus}
+ * @property {string}
+ * @property {string}
+ */
+export type Broadcast = z.infer<typeof broadcast>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const broadcastResponse = z.lazy(() => {
+  return z
+    .object({
+      action_url: z.string().max(2048).optional().nullable(),
+      category: z
+        .string()
+        .max(255)
+        .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+        .optional()
+        .nullable(),
+      content: z.string().max(10485760).optional().nullable(),
+      created_at: z.string().optional(),
+      custom_attributes: z.any().optional().nullable(),
+      id: z.string().optional(),
+      overrides: overridesResponse.optional().nullable(),
+      recipients: z.array(z.any()).min(1).max(1000).nullable(),
+      status: broadcastStatusResponse.optional().nullable(),
+      title: z.string().min(1).max(255),
+      topic: z
+        .string()
+        .max(255)
+        .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+        .optional()
+        .nullable(),
+    })
+    .transform((data) => ({
+      actionUrl: data['action_url'],
+      category: data['category'],
+      content: data['content'],
+      createdAt: data['created_at'],
+      customAttributes: data['custom_attributes'],
+      id: data['id'],
+      overrides: data['overrides'],
+      recipients: data['recipients'],
+      status: data['status'],
+      title: data['title'],
+      topic: data['topic'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const broadcastRequest = z.lazy(() => {
+  return z
+    .object({
+      actionUrl: z.string().max(2048).optional().nullable(),
+      category: z
+        .string()
+        .max(255)
+        .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+        .optional()
+        .nullable(),
+      content: z.string().max(10485760).optional().nullable(),
+      createdAt: z.string().optional(),
+      customAttributes: z.any().optional().nullable(),
+      id: z.string().optional(),
+      overrides: overridesRequest.optional().nullable(),
+      recipients: z.array(z.any()).min(1).max(1000).nullable(),
+      status: broadcastStatusRequest.optional().nullable(),
+      title: z.string().min(1).max(255),
+      topic: z
+        .string()
+        .max(255)
+        .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+        .optional()
+        .nullable(),
+    })
+    .transform((data) => ({
+      action_url: data['actionUrl'],
+      category: data['category'],
+      content: data['content'],
+      created_at: data['createdAt'],
+      custom_attributes: data['customAttributes'],
+      id: data['id'],
+      overrides: data['overrides'],
+      recipients: data['recipients'],
+      status: data['status'],
+      title: data['title'],
+      topic: data['topic'],
+    }));
+});

package/src/project-client/services/broadcasts/models/email.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const email = z.lazy(() => {
+  return z.object({
+    actionUrl: z.string().max(2048).optional().nullable(),
+    content: z.string().max(1048576).optional(),
+    title: z.string().min(1).max(255).optional(),
+  });
+});
+
+/**
+ *
+ * @typedef  {Email} email
+ * @property {string}
+ * @property {string}
+ * @property {string}
+ */
+export type Email = z.infer<typeof email>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const emailResponse = z.lazy(() => {
+  return z
+    .object({
+      action_url: z.string().max(2048).optional().nullable(),
+      content: z.string().max(1048576).optional(),
+      title: z.string().min(1).max(255).optional(),
+    })
+    .transform((data) => ({
+      actionUrl: data['action_url'],
+      content: data['content'],
+      title: data['title'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const emailRequest = z.lazy(() => {
+  return z
+    .object({
+      actionUrl: z.string().max(2048).optional().nullable(),
+      content: z.string().max(1048576).optional(),
+      title: z.string().min(1).max(255).optional(),
+    })
+    .transform((data) => ({
+      action_url: data['actionUrl'],
+      content: data['content'],
+      title: data['title'],
+    }));
+});

package/src/project-client/services/broadcasts/models/errors.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const errors = z.lazy(() => {
+  return z.object({
+    message: z.string().optional(),
+  });
+});
+
+/**
+ *
+ * @typedef  {Errors} errors
+ * @property {string}
+ */
+export type Errors = z.infer<typeof errors>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const errorsResponse = z.lazy(() => {
+  return z
+    .object({
+      message: z.string().optional(),
+    })
+    .transform((data) => ({
+      message: data['message'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const errorsRequest = z.lazy(() => {
+  return z
+    .object({
+      message: z.string().optional(),
+    })
+    .transform((data) => ({
+      message: data['message'],
+    }));
+});

package/src/project-client/services/broadcasts/models/in-app.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const inApp = z.lazy(() => {
+  return z.object({
+    actionUrl: z.string().max(2048).optional().nullable(),
+    content: z.string().max(1048576).optional(),
+    title: z.string().min(1).max(255).optional(),
+  });
+});
+
+/**
+ *
+ * @typedef  {InApp} inApp
+ * @property {string}
+ * @property {string}
+ * @property {string}
+ */
+export type InApp = z.infer<typeof inApp>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const inAppResponse = z.lazy(() => {
+  return z
+    .object({
+      action_url: z.string().max(2048).optional().nullable(),
+      content: z.string().max(1048576).optional(),
+      title: z.string().min(1).max(255).optional(),
+    })
+    .transform((data) => ({
+      actionUrl: data['action_url'],
+      content: data['content'],
+      title: data['title'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const inAppRequest = z.lazy(() => {
+  return z
+    .object({
+      actionUrl: z.string().max(2048).optional().nullable(),
+      content: z.string().max(1048576).optional(),
+      title: z.string().min(1).max(255).optional(),
+    })
+    .transform((data) => ({
+      action_url: data['actionUrl'],
+      content: data['content'],
+      title: data['title'],
+    }));
+});

package/src/project-client/services/broadcasts/models/index.ts

@@ -0,0 +1,15 @@
+export type { Broadcast } from './broadcast.js';
+export type { BroadcastCollection } from './broadcast-collection.js';
+export type { BroadcastStatus } from './broadcast-status.js';
+export type { Email } from './email.js';
+export type { Errors } from './errors.js';
+export type { InApp } from './in-app.js';
+export type { MobilePush } from './mobile-push.js';
+export type { Overrides } from './overrides.js';
+export type { OverridesChannels } from './overrides-channels.js';
+export type { Providers } from './providers.js';
+export type { Slack } from './slack.js';
+export type { Sms } from './sms.js';
+export { StatusStatus } from './status-status.js';
+export type { Summary } from './summary.js';
+export type { WebPush } from './web-push.js';