@cstar.help/js 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -134,6 +134,13 @@ declare class HttpClient {
     private sleep;
 }
 
+/**
+ * The subset of the global `EventSource` constructor surface that the
+ * realtime client uses. Allows polyfill injection (e.g. the `eventsource`
+ * npm package on Node) without forcing the polyfill to satisfy the full
+ * lib.dom.d.ts shape.
+ */
+type EventSourceConstructor = new (url: string) => EventSource;
 /** Options for configuring the realtime connection. */
 interface RealtimeOptions {
     /** Event types to subscribe to (e.g., ['ticket.*', 'boss.*']). Omit for all. */
@@ -142,6 +149,13 @@ interface RealtimeOptions {
     autoReconnect?: boolean;
     /** Max reconnection attempts before giving up (default: 10). */
     maxRetries?: number;
+    /**
+     * EventSource constructor to use. Defaults to `globalThis.EventSource`
+     * (browsers and Node 22+). Pass an explicit polyfill (e.g. the
+     * `eventsource` npm package) to subscribe from a Node environment that
+     * lacks the global. Closes NEW-v2-02.
+     */
+    eventSource?: EventSourceConstructor;
 }
 /** A parsed realtime event from the SSE stream. */
 interface RealtimeEvent<T = unknown> {
@@ -189,7 +203,15 @@ declare class CStarRealtime {
     private readonly autoReconnect;
     private readonly maxRetries;
     private readonly types;
+    private readonly eventSourceCtor;
     constructor(httpClient: HttpClient, options?: RealtimeOptions);
+    /**
+     * Resolve the EventSource constructor to use for this connection.
+     * Returns the explicit polyfill when one was injected, otherwise the
+     * global. Returns `undefined` when neither is available — callers must
+     * convert to `CStarRealtimeUnavailableError` before touching it.
+     */
+    private resolveEventSource;
     /** Subscribe to a specific event type. Supports wildcards (e.g., 'ticket.*'). Returns an unsubscribe function. */
     on<T = unknown>(eventType: string, handler: EventHandler<T>): () => void;
     /** Subscribe to all events. Returns an unsubscribe function. */
@@ -393,6 +415,12 @@ declare abstract class BaseResource<TEntity, TListParams extends PaginationParam
     update(id: string, params: TUpdateParams, options?: RequestOptions): Promise<TEntity>;
     /** Delete a resource by ID. */
     del(id: string): Promise<DeleteResponse>;
+    /**
+     * Delete a resource by ID. Alias for `del()` — kept because IDE
+     * auto-complete and documentation both surface `delete` first. Closes
+     * NEW-v2-06.
+     */
+    delete(id: string): Promise<DeleteResponse>;
     /**
      * Auto-paginating async iterator that yields every item across all pages.
      *
@@ -989,7 +1017,15 @@ interface Webhook {
     metadata: Metadata;
     createdAt: string;
     updatedAt: string;
-    /** Only returned on creation (POST). */
+    /**
+     * Signing secret for HMAC verification (`whsec_*`). Only returned on
+     * creation (POST `/webhooks`). Save it immediately — subsequent reads
+     * will not include it. Use it as the `secret` argument to
+     * `constructEvent` / `verifySignature` from `@cstar.help/js/webhook`.
+     */
+    signingSecret?: string;
+    /** @deprecated since 0.15.0 — use {@link signingSecret} instead. Kept
+     * during the deprecation window so 0.14.x consumers keep working. */
     secret?: string;
 }
 /** Parameters for listing webhooks. */
@@ -3028,6 +3064,28 @@ declare class OfflineQueue {
     private loadFromStorage;
 }
 
+/**
+ * Error classes for the cStar SDK.
+ *
+ * NEW-v3-01 — Cross-subpath instanceof identity.
+ *
+ * Each public subpath (`/library`, `/auth`, `/community`, `/quickhelp`, ...)
+ * is bundled as a separate tsup entry with `splitting: false`, so each one
+ * carries its own copy of this module. Without deduplication, errors thrown
+ * by `LibraryClient` carry the LibraryClient-bundled `CStarError` class —
+ * not the one a consumer imports from `@cstar.help/js`. That makes
+ * `instanceof CStarError` checks fail silently, invalidating every "did the
+ * SDK throw a typed cStar error?" branch in user code.
+ *
+ * Fix: register each class on a `Symbol.for(...)` slot of `globalThis`. The
+ * symbol is realm-shared, so every bundled copy of this module resolves to
+ * the SAME class identity at runtime — the first copy to load wins, and all
+ * subsequent copies surface the canonical class via the same slot. The
+ * inline `Impl` definitions are only used as the seed for the very first
+ * copy to register. Internal `parseError` / `parsePublicError` reference the
+ * EXPORTED canonical names so instances they construct also land on the
+ * canonical class.
+ */
 /** Error type constants matching the cStar API. */
 declare const ErrorType: {
     readonly AUTHENTICATION_ERROR: "authentication_error";
@@ -3052,7 +3110,7 @@ interface ApiErrorBody {
     enable_url?: string;
 }
 /** Base error class for all cStar API errors. */
-declare class CStarError extends Error {
+declare class CStarErrorImpl extends Error {
     readonly type: string;
     readonly code: string;
     readonly param?: string;
@@ -3061,49 +3119,51 @@ declare class CStarError extends Error {
     readonly statusCode: number;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown when authentication fails (401). */
-declare class CStarAuthenticationError extends CStarError {
+declare class CStarAuthenticationErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown when rate limited (429). Includes retry timing. */
-declare class CStarRateLimitError extends CStarError {
+declare class CStarRateLimitErrorImpl extends CStarErrorImpl {
     readonly retryAfter: number;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody, retryAfter?: number);
 }
-/** Thrown when a resource is not found (404). */
-declare class CStarNotFoundError extends CStarError {
+declare class CStarNotFoundErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown on invalid request parameters (400/422). */
-declare class CStarValidationError extends CStarError {
+declare class CStarValidationErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown when authenticated but lacking permission (403). */
-declare class CStarPermissionError extends CStarError {
+declare class CStarPermissionErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown on resource conflicts (409). */
-declare class CStarConflictError extends CStarError {
+declare class CStarConflictErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown on internal server errors (500+). */
-declare class CStarServerError extends CStarError {
+declare class CStarServerErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/**
- * Thrown when the call landed on a feature that the team has not enabled
- * or configured (e.g. Quick Help on a team without an AI agent). Carries
- * `feature` and `enableUrl` so the caller can route the user to the
- * dashboard setting that fixes it.
- *
- * Closes F-031 — anonymous QuickHelp `.ask()` previously surfaced as an
- * unactionable 503.
- */
-declare class CStarFeatureDisabledError extends CStarError {
+declare class CStarFeatureDisabledErrorImpl extends CStarErrorImpl {
     readonly feature: string;
     readonly enableUrl: string;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
+declare const CStarError: typeof CStarErrorImpl;
+type CStarError = InstanceType<typeof CStarErrorImpl>;
+declare const CStarAuthenticationError: typeof CStarAuthenticationErrorImpl;
+type CStarAuthenticationError = InstanceType<typeof CStarAuthenticationErrorImpl>;
+declare const CStarRateLimitError: typeof CStarRateLimitErrorImpl;
+type CStarRateLimitError = InstanceType<typeof CStarRateLimitErrorImpl>;
+declare const CStarNotFoundError: typeof CStarNotFoundErrorImpl;
+type CStarNotFoundError = InstanceType<typeof CStarNotFoundErrorImpl>;
+declare const CStarValidationError: typeof CStarValidationErrorImpl;
+type CStarValidationError = InstanceType<typeof CStarValidationErrorImpl>;
+declare const CStarPermissionError: typeof CStarPermissionErrorImpl;
+type CStarPermissionError = InstanceType<typeof CStarPermissionErrorImpl>;
+declare const CStarConflictError: typeof CStarConflictErrorImpl;
+type CStarConflictError = InstanceType<typeof CStarConflictErrorImpl>;
+declare const CStarServerError: typeof CStarServerErrorImpl;
+type CStarServerError = InstanceType<typeof CStarServerErrorImpl>;
+declare const CStarFeatureDisabledError: typeof CStarFeatureDisabledErrorImpl;
+type CStarFeatureDisabledError = InstanceType<typeof CStarFeatureDisabledErrorImpl>;
 
 /** Configuration for the CStarClient. */
 interface CStarClientConfig {

package/dist/index.d.ts

@@ -134,6 +134,13 @@ declare class HttpClient {
     private sleep;
 }
 
+/**
+ * The subset of the global `EventSource` constructor surface that the
+ * realtime client uses. Allows polyfill injection (e.g. the `eventsource`
+ * npm package on Node) without forcing the polyfill to satisfy the full
+ * lib.dom.d.ts shape.
+ */
+type EventSourceConstructor = new (url: string) => EventSource;
 /** Options for configuring the realtime connection. */
 interface RealtimeOptions {
     /** Event types to subscribe to (e.g., ['ticket.*', 'boss.*']). Omit for all. */
@@ -142,6 +149,13 @@ interface RealtimeOptions {
     autoReconnect?: boolean;
     /** Max reconnection attempts before giving up (default: 10). */
     maxRetries?: number;
+    /**
+     * EventSource constructor to use. Defaults to `globalThis.EventSource`
+     * (browsers and Node 22+). Pass an explicit polyfill (e.g. the
+     * `eventsource` npm package) to subscribe from a Node environment that
+     * lacks the global. Closes NEW-v2-02.
+     */
+    eventSource?: EventSourceConstructor;
 }
 /** A parsed realtime event from the SSE stream. */
 interface RealtimeEvent<T = unknown> {
@@ -189,7 +203,15 @@ declare class CStarRealtime {
     private readonly autoReconnect;
     private readonly maxRetries;
     private readonly types;
+    private readonly eventSourceCtor;
     constructor(httpClient: HttpClient, options?: RealtimeOptions);
+    /**
+     * Resolve the EventSource constructor to use for this connection.
+     * Returns the explicit polyfill when one was injected, otherwise the
+     * global. Returns `undefined` when neither is available — callers must
+     * convert to `CStarRealtimeUnavailableError` before touching it.
+     */
+    private resolveEventSource;
     /** Subscribe to a specific event type. Supports wildcards (e.g., 'ticket.*'). Returns an unsubscribe function. */
     on<T = unknown>(eventType: string, handler: EventHandler<T>): () => void;
     /** Subscribe to all events. Returns an unsubscribe function. */
@@ -393,6 +415,12 @@ declare abstract class BaseResource<TEntity, TListParams extends PaginationParam
     update(id: string, params: TUpdateParams, options?: RequestOptions): Promise<TEntity>;
     /** Delete a resource by ID. */
     del(id: string): Promise<DeleteResponse>;
+    /**
+     * Delete a resource by ID. Alias for `del()` — kept because IDE
+     * auto-complete and documentation both surface `delete` first. Closes
+     * NEW-v2-06.
+     */
+    delete(id: string): Promise<DeleteResponse>;
     /**
      * Auto-paginating async iterator that yields every item across all pages.
      *
@@ -989,7 +1017,15 @@ interface Webhook {
     metadata: Metadata;
     createdAt: string;
     updatedAt: string;
-    /** Only returned on creation (POST). */
+    /**
+     * Signing secret for HMAC verification (`whsec_*`). Only returned on
+     * creation (POST `/webhooks`). Save it immediately — subsequent reads
+     * will not include it. Use it as the `secret` argument to
+     * `constructEvent` / `verifySignature` from `@cstar.help/js/webhook`.
+     */
+    signingSecret?: string;
+    /** @deprecated since 0.15.0 — use {@link signingSecret} instead. Kept
+     * during the deprecation window so 0.14.x consumers keep working. */
     secret?: string;
 }
 /** Parameters for listing webhooks. */
@@ -3028,6 +3064,28 @@ declare class OfflineQueue {
     private loadFromStorage;
 }
 
+/**
+ * Error classes for the cStar SDK.
+ *
+ * NEW-v3-01 — Cross-subpath instanceof identity.
+ *
+ * Each public subpath (`/library`, `/auth`, `/community`, `/quickhelp`, ...)
+ * is bundled as a separate tsup entry with `splitting: false`, so each one
+ * carries its own copy of this module. Without deduplication, errors thrown
+ * by `LibraryClient` carry the LibraryClient-bundled `CStarError` class —
+ * not the one a consumer imports from `@cstar.help/js`. That makes
+ * `instanceof CStarError` checks fail silently, invalidating every "did the
+ * SDK throw a typed cStar error?" branch in user code.
+ *
+ * Fix: register each class on a `Symbol.for(...)` slot of `globalThis`. The
+ * symbol is realm-shared, so every bundled copy of this module resolves to
+ * the SAME class identity at runtime — the first copy to load wins, and all
+ * subsequent copies surface the canonical class via the same slot. The
+ * inline `Impl` definitions are only used as the seed for the very first
+ * copy to register. Internal `parseError` / `parsePublicError` reference the
+ * EXPORTED canonical names so instances they construct also land on the
+ * canonical class.
+ */
 /** Error type constants matching the cStar API. */
 declare const ErrorType: {
     readonly AUTHENTICATION_ERROR: "authentication_error";
@@ -3052,7 +3110,7 @@ interface ApiErrorBody {
     enable_url?: string;
 }
 /** Base error class for all cStar API errors. */
-declare class CStarError extends Error {
+declare class CStarErrorImpl extends Error {
     readonly type: string;
     readonly code: string;
     readonly param?: string;
@@ -3061,49 +3119,51 @@ declare class CStarError extends Error {
     readonly statusCode: number;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown when authentication fails (401). */
-declare class CStarAuthenticationError extends CStarError {
+declare class CStarAuthenticationErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown when rate limited (429). Includes retry timing. */
-declare class CStarRateLimitError extends CStarError {
+declare class CStarRateLimitErrorImpl extends CStarErrorImpl {
     readonly retryAfter: number;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody, retryAfter?: number);
 }
-/** Thrown when a resource is not found (404). */
-declare class CStarNotFoundError extends CStarError {
+declare class CStarNotFoundErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown on invalid request parameters (400/422). */
-declare class CStarValidationError extends CStarError {
+declare class CStarValidationErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown when authenticated but lacking permission (403). */
-declare class CStarPermissionError extends CStarError {
+declare class CStarPermissionErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown on resource conflicts (409). */
-declare class CStarConflictError extends CStarError {
+declare class CStarConflictErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/** Thrown on internal server errors (500+). */
-declare class CStarServerError extends CStarError {
+declare class CStarServerErrorImpl extends CStarErrorImpl {
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
-/**
- * Thrown when the call landed on a feature that the team has not enabled
- * or configured (e.g. Quick Help on a team without an AI agent). Carries
- * `feature` and `enableUrl` so the caller can route the user to the
- * dashboard setting that fixes it.
- *
- * Closes F-031 — anonymous QuickHelp `.ask()` previously surfaced as an
- * unactionable 503.
- */
-declare class CStarFeatureDisabledError extends CStarError {
+declare class CStarFeatureDisabledErrorImpl extends CStarErrorImpl {
     readonly feature: string;
     readonly enableUrl: string;
     constructor(messageOrStatus: string | number, body?: ApiErrorBody);
 }
+declare const CStarError: typeof CStarErrorImpl;
+type CStarError = InstanceType<typeof CStarErrorImpl>;
+declare const CStarAuthenticationError: typeof CStarAuthenticationErrorImpl;
+type CStarAuthenticationError = InstanceType<typeof CStarAuthenticationErrorImpl>;
+declare const CStarRateLimitError: typeof CStarRateLimitErrorImpl;
+type CStarRateLimitError = InstanceType<typeof CStarRateLimitErrorImpl>;
+declare const CStarNotFoundError: typeof CStarNotFoundErrorImpl;
+type CStarNotFoundError = InstanceType<typeof CStarNotFoundErrorImpl>;
+declare const CStarValidationError: typeof CStarValidationErrorImpl;
+type CStarValidationError = InstanceType<typeof CStarValidationErrorImpl>;
+declare const CStarPermissionError: typeof CStarPermissionErrorImpl;
+type CStarPermissionError = InstanceType<typeof CStarPermissionErrorImpl>;
+declare const CStarConflictError: typeof CStarConflictErrorImpl;
+type CStarConflictError = InstanceType<typeof CStarConflictErrorImpl>;
+declare const CStarServerError: typeof CStarServerErrorImpl;
+type CStarServerError = InstanceType<typeof CStarServerErrorImpl>;
+declare const CStarFeatureDisabledError: typeof CStarFeatureDisabledErrorImpl;
+type CStarFeatureDisabledError = InstanceType<typeof CStarFeatureDisabledErrorImpl>;
 
 /** Configuration for the CStarClient. */
 interface CStarClientConfig {

package/dist/index.js

@@ -35,7 +35,7 @@ function normalizeArgs(messageOrStatus, maybeBody, defaults) {
     }
   };
 }
-var CStarError = class extends Error {
+var CStarErrorImpl = class extends Error {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body);
     super(resolved.message);
@@ -48,7 +48,7 @@ var CStarError = class extends Error {
     this.statusCode = statusCode;
   }
 };
-var CStarAuthenticationError = class extends CStarError {
+var CStarAuthenticationErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.AUTHENTICATION_ERROR,
@@ -59,7 +59,7 @@ var CStarAuthenticationError = class extends CStarError {
     this.name = "CStarAuthenticationError";
   }
 };
-var CStarRateLimitError = class extends CStarError {
+var CStarRateLimitErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body, retryAfter) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.RATE_LIMIT_ERROR,
@@ -71,7 +71,7 @@ var CStarRateLimitError = class extends CStarError {
     this.retryAfter = retryAfter ?? 60;
   }
 };
-var CStarNotFoundError = class extends CStarError {
+var CStarNotFoundErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.NOT_FOUND_ERROR,
@@ -82,7 +82,7 @@ var CStarNotFoundError = class extends CStarError {
     this.name = "CStarNotFoundError";
   }
 };
-var CStarValidationError = class extends CStarError {
+var CStarValidationErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.INVALID_REQUEST_ERROR,
@@ -93,7 +93,7 @@ var CStarValidationError = class extends CStarError {
     this.name = "CStarValidationError";
   }
 };
-var CStarPermissionError = class extends CStarError {
+var CStarPermissionErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.PERMISSION_ERROR,
@@ -104,7 +104,7 @@ var CStarPermissionError = class extends CStarError {
     this.name = "CStarPermissionError";
   }
 };
-var CStarConflictError = class extends CStarError {
+var CStarConflictErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.CONFLICT_ERROR,
@@ -115,7 +115,7 @@ var CStarConflictError = class extends CStarError {
     this.name = "CStarConflictError";
   }
 };
-var CStarServerError = class extends CStarError {
+var CStarServerErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.SERVER_ERROR,
@@ -126,7 +126,7 @@ var CStarServerError = class extends CStarError {
     this.name = "CStarServerError";
   }
 };
-var CStarFeatureDisabledError = class extends CStarError {
+var CStarFeatureDisabledErrorImpl = class extends CStarErrorImpl {
   constructor(messageOrStatus, body) {
     const { statusCode, body: resolved } = normalizeArgs(messageOrStatus, body, {
       type: ErrorType.FEATURE_NOT_CONFIGURED,
@@ -139,6 +139,42 @@ var CStarFeatureDisabledError = class extends CStarError {
     this.enableUrl = resolved.enable_url ?? "";
   }
 };
+var CStarRealtimeUnavailableErrorImpl = class extends CStarErrorImpl {
+  constructor(message) {
+    const resolved = message ?? "EventSource is not available in this environment. Real-time subscriptions only work in the browser. Move the call to a client-only path (`useEffect` / `onMount`), or pass an `eventSource` polyfill via the realtime options. See https://cstar.help/developers/sdk/realtime#ssr";
+    super(0, {
+      type: ErrorType.API_ERROR,
+      code: "realtime_unavailable",
+      message: resolved,
+      doc_url: "https://cstar.help/developers/sdk/realtime#ssr"
+    });
+    this.name = "CStarRealtimeUnavailableError";
+  }
+};
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@cstar.help/js/errors/v1");
+var globalSlot = globalThis;
+var registry = globalSlot[REGISTRY_KEY] ?? (globalSlot[REGISTRY_KEY] = {
+  CStarError: CStarErrorImpl,
+  CStarAuthenticationError: CStarAuthenticationErrorImpl,
+  CStarRateLimitError: CStarRateLimitErrorImpl,
+  CStarNotFoundError: CStarNotFoundErrorImpl,
+  CStarValidationError: CStarValidationErrorImpl,
+  CStarPermissionError: CStarPermissionErrorImpl,
+  CStarConflictError: CStarConflictErrorImpl,
+  CStarServerError: CStarServerErrorImpl,
+  CStarFeatureDisabledError: CStarFeatureDisabledErrorImpl,
+  CStarRealtimeUnavailableError: CStarRealtimeUnavailableErrorImpl
+});
+var CStarError = registry.CStarError;
+var CStarAuthenticationError = registry.CStarAuthenticationError;
+var CStarRateLimitError = registry.CStarRateLimitError;
+var CStarNotFoundError = registry.CStarNotFoundError;
+var CStarValidationError = registry.CStarValidationError;
+var CStarPermissionError = registry.CStarPermissionError;
+var CStarConflictError = registry.CStarConflictError;
+var CStarServerError = registry.CStarServerError;
+var CStarFeatureDisabledError = registry.CStarFeatureDisabledError;
+var CStarRealtimeUnavailableError = registry.CStarRealtimeUnavailableError;
 var STATUS_TO_CLASS = {
   400: CStarValidationError,
   401: CStarAuthenticationError,
@@ -181,7 +217,7 @@ function parseError(statusCode, body, retryAfter) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.13.0";
+var SDK_VERSION = "0.15.0";
 var DEFAULT_BASE_URL = "https://www.cstar.help";
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_MAX_RETRIES = 3;
@@ -426,6 +462,18 @@ var CStarRealtime = class {
     this.autoReconnect = options?.autoReconnect ?? true;
     this.maxRetries = options?.maxRetries ?? 10;
     this.types = options?.types;
+    this.eventSourceCtor = options?.eventSource;
+  }
+  /**
+   * Resolve the EventSource constructor to use for this connection.
+   * Returns the explicit polyfill when one was injected, otherwise the
+   * global. Returns `undefined` when neither is available — callers must
+   * convert to `CStarRealtimeUnavailableError` before touching it.
+   */
+  resolveEventSource() {
+    if (this.eventSourceCtor) return this.eventSourceCtor;
+    const fromGlobal = globalThis.EventSource;
+    return typeof fromGlobal === "function" ? fromGlobal : void 0;
   }
   /** Subscribe to a specific event type. Supports wildcards (e.g., 'ticket.*'). Returns an unsubscribe function. */
   on(eventType, handler) {
@@ -480,6 +528,9 @@ var CStarRealtime = class {
   /** Start the SSE connection. Called automatically on first handler registration. */
   connect() {
     if (this.eventSource || this.destroyed || this.connecting) return;
+    if (!this.resolveEventSource()) {
+      throw new CStarRealtimeUnavailableError();
+    }
     this.connecting = true;
     const headers = this.httpClient.getAuthHeaders();
     const rawKey = headers.Authorization?.replace("Bearer ", "") ?? "";
@@ -518,7 +569,12 @@ var CStarRealtime = class {
     }
     const separator = qs ? "&" : "?";
     const authenticatedUrl = authToken ? `${url}${separator}token=${authToken}` : url;
-    this.eventSource = new EventSource(authenticatedUrl);
+    const Ctor = this.resolveEventSource();
+    if (!Ctor) {
+      this.connecting = false;
+      throw new CStarRealtimeUnavailableError();
+    }
+    this.eventSource = new Ctor(authenticatedUrl);
     this.eventSource.onopen = () => {
       this.connecting = false;
       this.retryCount = 0;
@@ -937,6 +993,14 @@ var BaseResource = class {
   async del(id) {
     return this.client.request("DELETE", `${this.basePath}/${id}`);
   }
+  /**
+   * Delete a resource by ID. Alias for `del()` — kept because IDE
+   * auto-complete and documentation both surface `delete` first. Closes
+   * NEW-v2-06.
+   */
+  async delete(id) {
+    return this.del(id);
+  }
   /**
    * Auto-paginating async iterator that yields every item across all pages.
    *