@broadcastingplatforms/sdk 0.0.0-dev.52fbff9

package/dist/errors.mjs

@@ -0,0 +1,127 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/errors.ts
+var SDKError = class extends Error {
+  /**
+   * Construct an SDKError. Signature is compatible with Error.
+   * You can pass in a message or an options object, as with the Error constructor.
+   * Additional fields (code, etc) may be added via the second argument.
+   */
+  constructor(message, details = {}) {
+    const resolvedMessage = message ?? (typeof details.message === "string" ? details.message : "Unknown error");
+    super(resolvedMessage);
+    /**
+     * Canonical SDK error code.
+     */
+    __publicField(this, "code");
+    /**
+     * HTTP status code if available.
+     */
+    __publicField(this, "statusCode");
+    /**
+     * End-user safe message.
+     */
+    __publicField(this, "userMessage");
+    /**
+     * Optional request metadata (null when unavailable).
+     */
+    __publicField(this, "request");
+    /**
+     * Optional response metadata (null when unavailable).
+     */
+    __publicField(this, "response");
+    Object.setPrototypeOf(this, new.target.prototype);
+    if (details && typeof details === "object") {
+      for (const [key, value] of Object.entries(details)) {
+        if (!["name", "message", "stack"].includes(key)) {
+          this[key] = value;
+        }
+      }
+    }
+    this.name = "SDKError";
+    this.code = details.code ?? "unknown_error";
+    this.statusCode = typeof details.statusCode === "number" ? details.statusCode : void 0;
+    this.userMessage = typeof details.userMessage === "string" ? details.userMessage : this.message;
+    this.request = details.request ?? null;
+    this.response = details.response ?? null;
+  }
+  /**
+   * Serialize the error into a plain object, preserving extra fields.
+   */
+  toJSON() {
+    const extras = { ...this };
+    delete extras.code;
+    delete extras.statusCode;
+    delete extras.message;
+    delete extras.userMessage;
+    delete extras.request;
+    delete extras.response;
+    delete extras.form;
+    delete extras.cause;
+    return {
+      ...extras,
+      code: this.code,
+      statusCode: this.statusCode,
+      message: this.message,
+      userMessage: this.userMessage,
+      request: this.request,
+      response: this.response
+    };
+  }
+};
+var STATUS_CODE_DEFAULTS = {
+  401: {
+    code: "authentication_required",
+    message: "Authentication required",
+    userMessage: "Please log in to continue. Your session may have expired."
+  },
+  403: {
+    code: "permission_denied",
+    message: "Permission denied",
+    userMessage: "You do not have permission to perform this action."
+  },
+  404: {
+    code: "not_found",
+    message: "Resource not found",
+    userMessage: "The requested resource was not found."
+  },
+  422: {
+    code: "validation_failed",
+    message: "Validation failed",
+    userMessage: "The provided information is invalid. Please check your input and try again."
+  },
+  429: {
+    code: "rate_limited",
+    message: "Rate limit exceeded",
+    userMessage: "Too many requests. Please wait a moment and try again."
+  },
+  500: {
+    code: "server_error",
+    message: "Internal server error",
+    userMessage: "Something went wrong on our end. Please try again later."
+  }
+};
+var DEFAULT_ERROR = {
+  code: "unknown_error",
+  userMessage: "An unexpected error occurred. Please try again."
+};
+function createSdkError(message, details = {}) {
+  const statusCode = details.response?.status;
+  const statusValues = statusCode && STATUS_CODE_DEFAULTS[statusCode] ? STATUS_CODE_DEFAULTS[statusCode] : DEFAULT_ERROR;
+  const enrichedDetails = {
+    ...details,
+    statusCode,
+    code: details.code ?? statusValues.code,
+    userMessage: details.userMessage ?? statusValues.userMessage,
+    request: details.request ?? null,
+    response: details.response ?? null
+  };
+  return new SDKError(message, enrichedDetails);
+}
+export {
+  SDKError,
+  createSdkError
+};
+//# sourceMappingURL=errors.mjs.map

package/dist/http.d.mts

@@ -0,0 +1 @@
+export { a as HttpClient, H as HttpClientOptions } from './auth-CSkJb9Wc.mjs';

package/dist/http.d.ts

@@ -0,0 +1 @@
+export { a as HttpClient, H as HttpClientOptions } from './auth-CSkJb9Wc.js';

package/dist/http.js

@@ -0,0 +1,323 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/http.ts
+var http_exports = {};
+__export(http_exports, {
+  HttpClient: () => HttpClient
+});
+module.exports = __toCommonJS(http_exports);
+
+// src/errors.ts
+var SDKError = class extends Error {
+  /**
+   * Construct an SDKError. Signature is compatible with Error.
+   * You can pass in a message or an options object, as with the Error constructor.
+   * Additional fields (code, etc) may be added via the second argument.
+   */
+  constructor(message, details = {}) {
+    const resolvedMessage = message ?? (typeof details.message === "string" ? details.message : "Unknown error");
+    super(resolvedMessage);
+    /**
+     * Canonical SDK error code.
+     */
+    __publicField(this, "code");
+    /**
+     * HTTP status code if available.
+     */
+    __publicField(this, "statusCode");
+    /**
+     * End-user safe message.
+     */
+    __publicField(this, "userMessage");
+    /**
+     * Optional request metadata (null when unavailable).
+     */
+    __publicField(this, "request");
+    /**
+     * Optional response metadata (null when unavailable).
+     */
+    __publicField(this, "response");
+    Object.setPrototypeOf(this, new.target.prototype);
+    if (details && typeof details === "object") {
+      for (const [key, value] of Object.entries(details)) {
+        if (!["name", "message", "stack"].includes(key)) {
+          this[key] = value;
+        }
+      }
+    }
+    this.name = "SDKError";
+    this.code = details.code ?? "unknown_error";
+    this.statusCode = typeof details.statusCode === "number" ? details.statusCode : void 0;
+    this.userMessage = typeof details.userMessage === "string" ? details.userMessage : this.message;
+    this.request = details.request ?? null;
+    this.response = details.response ?? null;
+  }
+  /**
+   * Serialize the error into a plain object, preserving extra fields.
+   */
+  toJSON() {
+    const extras = { ...this };
+    delete extras.code;
+    delete extras.statusCode;
+    delete extras.message;
+    delete extras.userMessage;
+    delete extras.request;
+    delete extras.response;
+    delete extras.form;
+    delete extras.cause;
+    return {
+      ...extras,
+      code: this.code,
+      statusCode: this.statusCode,
+      message: this.message,
+      userMessage: this.userMessage,
+      request: this.request,
+      response: this.response
+    };
+  }
+};
+var STATUS_CODE_DEFAULTS = {
+  401: {
+    code: "authentication_required",
+    message: "Authentication required",
+    userMessage: "Please log in to continue. Your session may have expired."
+  },
+  403: {
+    code: "permission_denied",
+    message: "Permission denied",
+    userMessage: "You do not have permission to perform this action."
+  },
+  404: {
+    code: "not_found",
+    message: "Resource not found",
+    userMessage: "The requested resource was not found."
+  },
+  422: {
+    code: "validation_failed",
+    message: "Validation failed",
+    userMessage: "The provided information is invalid. Please check your input and try again."
+  },
+  429: {
+    code: "rate_limited",
+    message: "Rate limit exceeded",
+    userMessage: "Too many requests. Please wait a moment and try again."
+  },
+  500: {
+    code: "server_error",
+    message: "Internal server error",
+    userMessage: "Something went wrong on our end. Please try again later."
+  }
+};
+var DEFAULT_ERROR = {
+  code: "unknown_error",
+  userMessage: "An unexpected error occurred. Please try again."
+};
+function createSdkError(message, details = {}) {
+  const statusCode = details.response?.status;
+  const statusValues = statusCode && STATUS_CODE_DEFAULTS[statusCode] ? STATUS_CODE_DEFAULTS[statusCode] : DEFAULT_ERROR;
+  const enrichedDetails = {
+    ...details,
+    statusCode,
+    code: details.code ?? statusValues.code,
+    userMessage: details.userMessage ?? statusValues.userMessage,
+    request: details.request ?? null,
+    response: details.response ?? null
+  };
+  return new SDKError(message, enrichedDetails);
+}
+
+// src/http.ts
+var resolveFetch = (provided) => {
+  if (provided) {
+    return provided.bind(globalThis);
+  }
+  if (typeof fetch === "function") {
+    return fetch.bind(globalThis);
+  }
+  throw createSdkError(
+    "Fetch implementation not found. Provide options.fetch when running outside Node 22+ or the browser."
+  );
+};
+var redactRequestMetadata = (request) => {
+  const redacted = request.clone();
+  redacted.headers.delete("authorization");
+  return redacted;
+};
+var removeContentTypeHeader = (headers) => {
+  for (const key of Object.keys(headers)) {
+    if (key.toLowerCase() === "content-type") {
+      delete headers[key];
+    }
+  }
+};
+var normalizeHeaders = (headers) => {
+  if (!headers) {
+    return {};
+  }
+  if (headers instanceof Headers) {
+    return Object.fromEntries(headers.entries());
+  }
+  if (Array.isArray(headers)) {
+    return Object.fromEntries(headers);
+  }
+  return { ...headers };
+};
+var HttpClient = class {
+  /**
+   * Create a new HTTP client instance.
+   */
+  constructor(options) {
+    __publicField(this, "baseUrl");
+    __publicField(this, "defaultHeaders");
+    __publicField(this, "fetcher");
+    __publicField(this, "beforeRequestHooks", []);
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.defaultHeaders = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      ...options.headers
+    };
+    this.fetcher = resolveFetch(options.fetch);
+  }
+  /**
+   * Register a hook that runs before each request.
+   */
+  onBeforeRequest(hook) {
+    this.beforeRequestHooks = [...this.beforeRequestHooks, hook];
+    return () => {
+      this.beforeRequestHooks = this.beforeRequestHooks.filter(
+        (existing) => existing !== hook
+      );
+    };
+  }
+  /**
+   * Execute an HTTP request and return the parsed response.
+   */
+  async request(path, options = {}) {
+    const { data } = await this.requestWithMetadata(path, options);
+    return data;
+  }
+  /**
+   * Execute an HTTP request and return the response with request metadata.
+   */
+  async requestWithMetadata(path, options = {}) {
+    const url = /^https?:\/\//i.test(path) ? path : `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const method = (options.method ?? "GET").toUpperCase();
+    const headers = {
+      ...this.defaultHeaders,
+      ...options.headers
+    };
+    const hasExplicitContentType = Object.keys(options.headers ?? {}).some(
+      (key) => key.toLowerCase() === "content-type"
+    );
+    let request = {
+      url,
+      init: {
+        ...options,
+        method,
+        headers
+      }
+    };
+    request = await this.beforeRequestHooks.reduce(
+      async (pendingRequest, hook) => {
+        const currentRequest = await pendingRequest;
+        const result = await hook(currentRequest);
+        return result ?? currentRequest;
+      },
+      Promise.resolve(request)
+    );
+    const normalizedHeaders = normalizeHeaders(request.init.headers);
+    const resolvedMethod = (request.init.method ?? method).toUpperCase();
+    const hasBody = request.init.body !== void 0 && request.init.body !== null;
+    if (!hasBody && !hasExplicitContentType && (resolvedMethod === "GET" || resolvedMethod === "HEAD")) {
+      removeContentTypeHeader(normalizedHeaders);
+    }
+    request = {
+      ...request,
+      init: {
+        ...request.init,
+        method: resolvedMethod,
+        headers: normalizedHeaders
+      }
+    };
+    const requestMetadata = new Request(request.url, request.init);
+    let response = null;
+    try {
+      response = await this.fetcher(request.url, request.init);
+      const contentType = response.headers.get("content-type") ?? "";
+      const isJson = contentType.includes("application/json");
+      if (!response.ok) {
+        const payload = isJson ? await response.json().catch(() => void 0) : await response.text();
+        const payloadObject = payload && typeof payload === "object" && !Array.isArray(payload) ? payload : null;
+        const fallbackMessage = typeof payload === "string" ? payload : null;
+        const message = typeof payloadObject?.message === "string" ? payloadObject.message : fallbackMessage || response.statusText || "Request failed";
+        const { code, ...payloadDetails } = payloadObject ?? {};
+        const resolvedCode = typeof code === "string" ? code : void 0;
+        throw createSdkError(message, {
+          ...payloadDetails,
+          code: resolvedCode,
+          request: redactRequestMetadata(requestMetadata),
+          response
+        });
+      }
+      if (response.status === 204) {
+        return { data: void 0, request: requestMetadata, response };
+      }
+      if (contentType.includes("application/json")) {
+        return {
+          data: await response.json(),
+          request: requestMetadata,
+          response
+        };
+      }
+      return {
+        data: await response.text(),
+        request: requestMetadata,
+        response
+      };
+    } catch (error) {
+      if (error instanceof SDKError) {
+        throw error;
+      }
+      const fallbackMessage = error instanceof Error ? error.message : "Request failed";
+      throw createSdkError(fallbackMessage, {
+        request: redactRequestMetadata(requestMetadata),
+        response
+      });
+    }
+  }
+  /**
+   * Determine whether the provided URL is same-origin with the configured base URL.
+   */
+  isSameOrigin(url) {
+    try {
+      return new URL(url).origin === new URL(this.baseUrl).origin;
+    } catch {
+      return false;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HttpClient
+});
+//# sourceMappingURL=http.js.map