magicbell-js 1.3.0 → 1.4.0

package/src/user-client/http/transport/request.ts

@@ -9,6 +9,8 @@ import { ContentType, HttpMethod, RetryOptions, SdkConfig, ValidationOptions } f
 import {
   CreateRequestParameters,
   ErrorDefinition,
+  isRequestCursorPagination,
+  RequestCursorPagination,
   RequestPagination,
   RequestParameter,
   ResponseDefinition,
@@ -43,7 +45,11 @@ export class Request<PageSchema = unknown[]> {
 
   public retry: RetryOptions = {} as any;
 
-  public pagination?: RequestPagination<PageSchema>;
+  public pagination?: RequestPagination<PageSchema> | RequestCursorPagination<PageSchema>;
+
+  public filename?: string;
+
+  public filenames?: string[];
 
   private readonly pathPattern: string;
 
@@ -64,6 +70,8 @@ export class Request<PageSchema = unknown[]> {
     this.retry = params.retry;
     this.validation = params.validation;
     this.pagination = params.pagination;
+    this.filename = params.filename;
+    this.filenames = params.filenames;
   }
 
   addHeaderParam(key: string, param: RequestParameter): void {
@@ -165,6 +173,8 @@ export class Request<PageSchema = unknown[]> {
       requestContentType: overrides?.requestContentType ?? this.requestContentType,
       retry: overrides?.retry ?? this.retry,
       validation: overrides?.validation ?? this.validation,
+      filename: overrides?.filename ?? this.filename,
+      filenames: overrides?.filenames ?? this.filenames,
     };
     return new Request({
       ...createRequestParams,
@@ -180,17 +190,28 @@ export class Request<PageSchema = unknown[]> {
     return new HeaderSerializer().serialize(this.headers);
   }
 
-  public nextPage(): void {
+  public nextPage(cursor?: string): void {
     if (!this.pagination) {
       return;
     }
 
-    const offsetParam = this.getOffsetParam();
-    if (!offsetParam) {
+    // Check if this is cursor pagination using type guard
+    if (isRequestCursorPagination(this.pagination)) {
+      const cursorParam = this.getCursorParam();
+      if (cursorParam && cursor !== undefined) {
+        cursorParam.value = cursor;
+      }
       return;
     }
 
-    offsetParam.value = Number(offsetParam.value) + this.pagination.pageSize;
+    // Handle limit-offset pagination
+    const offsetParam = this.getOffsetParam();
+    if (offsetParam) {
+      if (this.pagination.pageSize === undefined) {
+        throw new Error('pageSize is required for limit-offset pagination');
+      }
+      offsetParam.value = Number(offsetParam.value) + this.pagination.pageSize;
+    }
   }
 
   private constructPath(): string {
@@ -202,6 +223,11 @@ export class Request<PageSchema = unknown[]> {
     return offsetParam;
   }
 
+  private getCursorParam(): RequestParameter | undefined {
+    const cursorParam = this.getAllParams().find((param) => param.isCursor);
+    return cursorParam;
+  }
+
   private getAllParams(): RequestParameter[] {
     const allParams: RequestParameter[] = [];
 

package/src/user-client/http/transport/transport-hook-adapter.ts

@@ -84,6 +84,7 @@ export class TransportHookAdapter<T> {
         explode: requestParam?.explode ?? false,
         isLimit: requestParam?.isLimit ?? false,
         isOffset: requestParam?.isOffset ?? false,
+        isCursor: requestParam?.isCursor ?? false,
       });
     });
     return transportParams;

package/src/user-client/http/transport/types.ts

@@ -31,7 +31,9 @@ export interface CreateRequestParameters<Page = unknown[]> {
   requestContentType: ContentType;
   validation: ValidationOptions;
   retry: RetryOptions;
-  pagination?: RequestPagination<Page>;
+  pagination?: RequestPagination<Page> | RequestCursorPagination<Page>;
+  filename?: string;
+  filenames?: string[];
 }
 
 export interface RequestParameter {
@@ -42,10 +44,24 @@ export interface RequestParameter {
   style: SerializationStyle;
   isLimit: boolean;
   isOffset: boolean;
+  isCursor: boolean;
 }
 
 export interface RequestPagination<Page> {
-  pageSize: number;
+  pageSize?: number;
   pagePath: string[];
   pageSchema?: ZodType<Page, any, any>;
 }
+
+export interface RequestCursorPagination<Page> {
+  pagePath: string[];
+  pageSchema?: ZodType<Page, any, any>;
+  cursorPath: string[];
+  cursorSchema?: ZodType<string | null | undefined>;
+}
+
+export function isRequestCursorPagination<Page>(
+  pagination: RequestPagination<Page> | RequestCursorPagination<Page> | undefined,
+): pagination is RequestCursorPagination<Page> {
+  return !!pagination && 'cursorPath' in pagination;
+}

package/src/user-client/http/types.ts

@@ -3,7 +3,7 @@ import { ZodType } from 'zod';
 import { Environment } from './environment.js';
 import { Request } from './transport/request.js';
 
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export type HttpMethod = 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
 
 export interface SdkConfig {
   baseUrl?: string;
@@ -26,6 +26,14 @@ export interface HttpResponse<T = unknown> {
   raw: ArrayBuffer;
 }
 
+export interface PaginatedHttpResponse<T = unknown> extends HttpResponse<T> {
+  // Marker interface for pagination responses
+}
+
+export interface CursorPaginatedHttpResponse<T = unknown> extends HttpResponse<T> {
+  nextCursor?: string | null;
+}
+
 export interface RequestHandler {
   next?: RequestHandler;
 

package/src/user-client/http/utils/content-type.ts

@@ -1,33 +1,50 @@
 import { ContentType } from '../types.js';
 
 export function getContentTypeDefinition(contentType: string): ContentType {
-  if (contentType.startsWith('application/') && contentType.includes('xml')) {
+  const ct = contentType.toLowerCase();
+
+  if (ct.startsWith('application/') && ct.includes('xml')) {
     return ContentType.Xml;
   }
 
-  if (contentType.toLowerCase() === 'application/x-www-form-urlencoded') {
+  if (ct === 'application/x-www-form-urlencoded') {
     return ContentType.FormUrlEncoded;
   }
 
-  if (contentType.toLowerCase() === 'text/event-stream') {
+  if (ct === 'text/event-stream') {
     return ContentType.EventStream;
   }
 
-  if (contentType.toLowerCase().startsWith('text/')) {
+  // Check for JSON content types (including text/json) before text types
+  if (ct === 'application/json' || ct === 'text/json' || ct.includes('+json')) {
+    return ContentType.Json;
+  }
+
+  if (ct === 'application/javascript') {
+    return ContentType.Text;
+  }
+
+  if (ct.startsWith('text/')) {
+    return ContentType.Text;
+  }
+
+  // SVG is text-based XML, not binary
+  if (ct === 'image/svg+xml') {
     return ContentType.Text;
   }
 
-  if (contentType.toLowerCase().startsWith('image/')) {
+  if (ct.startsWith('image/')) {
     return ContentType.Image;
   }
 
-  if (contentType.toLowerCase() === 'application/octet-stream') {
+  if (ct === 'application/octet-stream' || ct === 'application/pdf') {
     return ContentType.Binary;
   }
 
-  if (contentType.toLowerCase() === 'application/json') {
-    return ContentType.Json;
+  // Wildcard content type
+  if (ct === '*/*') {
+    return ContentType.Binary;
   }
 
-  return ContentType.Json;
+  return ContentType.Binary;
 }