@broadcastingplatforms/sdk 0.0.0-dev.52fbff9

package/dist/streams.mjs

@@ -0,0 +1,242 @@
+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);
+}
+
+// src/resource.ts
+var buildQueryString = (params) => {
+  if (!params) {
+    return "";
+  }
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        if (item === null || item === void 0) {
+          continue;
+        }
+        searchParams.append(`${key}[]`, String(item));
+      }
+      continue;
+    }
+    if (value === null || value === void 0) {
+      continue;
+    }
+    searchParams.set(key, String(value));
+  }
+  return searchParams.toString();
+};
+
+// src/streams.ts
+var StreamsClient = class {
+  /**
+   * Create a new streams client instance.
+   */
+  constructor(http) {
+    __publicField(this, "http");
+    this.http = http;
+  }
+  /**
+   * List active streams.
+   */
+  async listActive(options = {}) {
+    return this.list(void 0, options);
+  }
+  /**
+   * List streams with optional query params.
+   */
+  async list(params, options = {}) {
+    const rest = { ...options, body: void 0 };
+    const query = buildQueryString(params);
+    const path = query ? `/v2/streams?${query}` : "/v2/streams";
+    return this.http.request(path, {
+      ...rest,
+      method: "GET"
+    });
+  }
+  /**
+   * Fetch a stream by id.
+   */
+  async get(streamId, options = {}) {
+    const rest = { ...options, body: void 0 };
+    return this.http.request(
+      `/v2/streams/${encodeURIComponent(String(streamId))}`,
+      {
+        ...rest,
+        method: "GET"
+      }
+    );
+  }
+  /**
+   * Fetch a stream by channel slug.
+   * @param userLogin - Channel slug or login handle.
+   * @param options - Request options.
+   * @returns Stream payload when found, otherwise null.
+   */
+  async getBySlug(userLogin, options = {}) {
+    const rest = { ...options, body: void 0 };
+    try {
+      const channelResponse = await this.http.request(
+        `/v2/channels/${encodeURIComponent(userLogin)}`,
+        {
+          ...rest,
+          method: "GET"
+        }
+      );
+      if (channelResponse?.active_stream) {
+        return channelResponse.active_stream;
+      }
+      return null;
+    } catch (error) {
+      if (error instanceof SDKError) {
+        if (error.statusCode === 404) {
+          return null;
+        }
+        throw error;
+      }
+      const message = error instanceof Error ? error.message : String(error);
+      throw createSdkError(message);
+    }
+  }
+  /**
+   * Fetch the player source payload for the given stream id.
+   */
+  async getPlayerSource(streamId, options = {}) {
+    const response = await this.get(streamId, options);
+    const stream = this.extractStreamPayload(response);
+    return stream?.player_source ?? null;
+  }
+  /**
+   * Normalize stream payloads for get operations.
+   */
+  extractStreamPayload(response) {
+    if (response && typeof response === "object") {
+      if ("data" in response) {
+        return response.data ?? null;
+      }
+    }
+    return response ?? null;
+  }
+};
+export {
+  StreamsClient
+};
+//# sourceMappingURL=streams.mjs.map

package/dist/types.d.mts

@@ -0,0 +1 @@
+export { i as BeforeRequestHook, N as Channel, O as ChannelCharacteristics, P as ChannelLink, Q as ChannelResponse, T as ChannelTag, U as ChatMessage, V as ChatMessageMetadata, Y as ChatMessageTransaction, Z as ChatMessageUser, W as ChatMessagesQuery, X as ChatMessagesResponse, j as CookieAccessors, k as CookieOptions, l as CookiesStorageAdapter, m as HttpRequest, n as HttpRequestOptions, R as RealtimeChannel, o as RealtimeChatClient, p as RealtimeClient, q as RealtimeClientOptions, _ as RealtimeClientOverrides, r as RealtimeConnectionState, s as RealtimeConnectionStateCallback, t as RealtimeEventCallback, u as RealtimePresenceChannel, D as ResourceId, E as ResourceQueryParams, F as ResourceQueryValue, v as SDKErrorCode, x as SDKErrorShape, h as SdkClient, w as SdkErrorCode, y as SdkErrorShape, z as StorageAdapter, G as Stream, I as StreamChannel, J as StreamListResponse, K as StreamPlayerSource, L as StreamResponse, M as StreamTag, a0 as Tag } from './auth-CSkJb9Wc.mjs';

package/dist/types.d.ts

@@ -0,0 +1 @@
+export { i as BeforeRequestHook, N as Channel, O as ChannelCharacteristics, P as ChannelLink, Q as ChannelResponse, T as ChannelTag, U as ChatMessage, V as ChatMessageMetadata, Y as ChatMessageTransaction, Z as ChatMessageUser, W as ChatMessagesQuery, X as ChatMessagesResponse, j as CookieAccessors, k as CookieOptions, l as CookiesStorageAdapter, m as HttpRequest, n as HttpRequestOptions, R as RealtimeChannel, o as RealtimeChatClient, p as RealtimeClient, q as RealtimeClientOptions, _ as RealtimeClientOverrides, r as RealtimeConnectionState, s as RealtimeConnectionStateCallback, t as RealtimeEventCallback, u as RealtimePresenceChannel, D as ResourceId, E as ResourceQueryParams, F as ResourceQueryValue, v as SDKErrorCode, x as SDKErrorShape, h as SdkClient, w as SdkErrorCode, y as SdkErrorShape, z as StorageAdapter, G as Stream, I as StreamChannel, J as StreamListResponse, K as StreamPlayerSource, L as StreamResponse, M as StreamTag, a0 as Tag } from './auth-CSkJb9Wc.js';

package/dist/types.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=types.mjs.map

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@broadcastingplatforms/sdk",
+  "version": "0.0.0-dev.52fbff9",
+  "description": "Broadcasting Platform SDK",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "!**/*.map"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.mjs",
+      "require": "./dist/auth.js"
+    },
+    "./browser-client": {
+      "types": "./dist/browser-client.d.ts",
+      "import": "./dist/browser-client.mjs",
+      "require": "./dist/browser-client.js"
+    },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "import": "./dist/http.mjs",
+      "require": "./dist/http.js"
+    },
+    "./resource": {
+      "types": "./dist/resource.d.ts",
+      "import": "./dist/resource.mjs",
+      "require": "./dist/resource.js"
+    },
+    "./streams": {
+      "types": "./dist/streams.d.ts",
+      "import": "./dist/streams.mjs",
+      "require": "./dist/streams.js"
+    },
+    "./channels": {
+      "types": "./dist/channels.d.ts",
+      "import": "./dist/channels.mjs",
+      "require": "./dist/channels.js"
+    },
+    "./chat": {
+      "types": "./dist/chat.d.ts",
+      "import": "./dist/chat.mjs",
+      "require": "./dist/chat.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.mjs",
+      "require": "./dist/errors.js"
+    },
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "import": "./dist/storage.mjs",
+      "require": "./dist/storage.js"
+    },
+    "./server-client": {
+      "types": "./dist/server-client.d.ts",
+      "import": "./dist/server-client.mjs",
+      "require": "./dist/server-client.js"
+    },
+    "./realtime": {
+      "types": "./dist/realtime.d.ts",
+      "import": "./dist/realtime.mjs",
+      "require": "./dist/realtime.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.js"
+    }
+  },
+  "tsup": {
+    "entry": [
+      "src/index.ts",
+      "src/auth.ts",
+      "src/browser-client.ts",
+      "src/http.ts",
+      "src/resource.ts",
+      "src/streams.ts",
+      "src/channels.ts",
+      "src/chat.ts",
+      "src/errors.ts",
+      "src/realtime.ts",
+      "src/server-client.ts",
+      "src/storage.ts",
+      "src/types.ts"
+    ],
+    "format": [
+      "esm",
+      "cjs"
+    ],
+    "dts": true,
+    "sourcemap": true,
+    "clean": true,
+    "splitting": false,
+    "target": "es2020"
+  },
+  "dependencies": {
+    "jwt-decode": "^4.0.0",
+    "pusher-js": "^8.4.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@bp/typescript": "*",
+    "@typescript-eslint/eslint-plugin": "^8.33.0",
+    "@typescript-eslint/parser": "^8.33.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "tsup": "^8.0.2",
+    "tsx": "^4.19.2",
+    "pusher-js": "^8.4.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "lint": "eslint -c ./eslint.config.mjs \"{src,tests}/**/*.{ts,tsx,js,jsx}\" --fix",
+    "test": "vitest run",
+    "manual-tests": "npm run build && vitest run tests/manual-tests.vitest.js"
+  }
+}