@fastpix/fastpix-node 2.0.1 → 2.0.3

package/samples/media/manage-videos.ts

@@ -0,0 +1,166 @@
+/**
+ * Manage Videos API Samples
+ * 
+ * This file demonstrates how to use the Manage Videos API to:
+ * - List all media
+ * - Get media by ID
+ * - Update media
+ * - Delete media
+ * - Add/update/delete tracks
+ * - Generate subtitles
+ * 
+ * Run this sample:
+ * npx tsx media/manage-videos.ts
+ */
+
+import { createFastpixClient, runSample } from "../common/setup.js";
+import { config, logResponse, logError } from "../common/config.js";
+
+let createdMediaId: string | undefined;
+
+async function listMedia() {
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.manageVideos.listMedia({
+    limit: 10,
+    offset: 0,
+  });
+
+  logResponse("List Media", result);
+  return result;
+}
+
+async function getMediaById() {
+  if (!createdMediaId) {
+    console.log("⚠️  No media ID available. Run createMediaFromUrl first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.manageVideos.getMedia({
+    mediaId: createdMediaId,
+  });
+
+  logResponse("Get Media by ID", result);
+  return result;
+}
+
+async function updateMedia() {
+  if (!createdMediaId) {
+    console.log("⚠️  No media ID available. Run createMediaFromUrl first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.manageVideos.updatedMedia({
+    mediaId: createdMediaId,
+    requestBody: {
+      metadata: {
+        title: "Updated Sample Video",
+        description: "This video has been updated via SDK",
+        category: "updated-sample",
+      },
+    },
+  });
+
+  logResponse("Update Media", result);
+  return result;
+}
+
+async function addMediaTrack() {
+  if (!createdMediaId) {
+    console.log("⚠️  No media ID available. Run createMediaFromUrl first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.manageVideos.addMediaTrack({
+    mediaId: createdMediaId,
+    requestBody: {
+      type: "subtitle",
+      language: "en",
+      name: "English Subtitles",
+    },
+  });
+
+  logResponse("Add Media Track", result);
+  return result;
+}
+
+async function generateSubtitleTrack() {
+  if (!createdMediaId) {
+    console.log("⚠️  No media ID available. Run createMediaFromUrl first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.manageVideos.generateSubtitleTrack({
+    mediaId: createdMediaId,
+    requestBody: {
+      language: "en",
+      name: "Auto-generated English Subtitles",
+    },
+  });
+
+  logResponse("Generate Subtitle Track", result);
+  return result;
+}
+
+async function deleteMedia() {
+  if (!createdMediaId) {
+    console.log("⚠️  No media ID available. Run createMediaFromUrl first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.manageVideos.deleteMedia({
+    mediaId: createdMediaId,
+  });
+
+  logResponse("Delete Media", result);
+  createdMediaId = undefined; // Reset the ID since media is deleted
+  return result;
+}
+
+async function main() {
+  console.log("🎬 Manage Videos API Samples");
+  console.log("=============================");
+  
+  // First, create a media item to work with
+  console.log("\n📹 Creating sample media...");
+  const fastpix = createFastpixClient();
+  const createResult = await fastpix.inputVideo.createMedia({
+    inputs: [
+      {
+        type: "video",
+        url: config.sampleVideoUrl,
+      },
+    ],
+    metadata: {
+      title: "Sample Video for Management",
+      description: "This video will be used to demonstrate management operations",
+    },
+    accessPolicy: "public",
+  });
+
+  if (createResult.createMediaSuccessResponse?.data?.id) {
+    createdMediaId = createResult.createMediaSuccessResponse.data.id;
+    console.log(`✅ Created media with ID: ${createdMediaId}`);
+  }
+
+  await runSample("List Media", listMedia);
+  await runSample("Get Media by ID", getMediaById);
+  await runSample("Update Media", updateMedia);
+  await runSample("Add Media Track", addMediaTrack);
+  await runSample("Generate Subtitle Track", generateSubtitleTrack);
+  
+  // Uncomment to delete the media (be careful!)
+  // await runSample("Delete Media", deleteMedia);
+}
+
+main().catch(console.error);

package/samples/media/playback.ts

@@ -0,0 +1,89 @@
+/**
+ * Playback API Samples
+ * 
+ * This file demonstrates how to use the Playback API to:
+ * - Create playback IDs
+ * - Get playback ID details
+ * - Delete playback IDs
+ * 
+ * Run this sample:
+ * npx tsx media/playback.ts
+ */
+
+import { createFastpixClient, runSample } from "../common/setup.js";
+import { config, logResponse } from "../common/config.js";
+
+let createdPlaybackId: string | undefined;
+
+async function createPlaybackId() {
+  const fastpix = createFastpixClient();
+  
+  // First, get a media item to create playback ID for
+  const mediaList = await fastpix.manageVideos.listMedia({ limit: 1 });
+  const mediaId = mediaList.listMediaSuccessResponse?.data?.media?.[0]?.id;
+  
+  if (!mediaId) {
+    console.log("⚠️  No media found. Please create some media first.");
+    return;
+  }
+
+  const result = await fastpix.playback.createMediaPlaybackId({
+    mediaId: mediaId,
+    requestBody: {
+      policy: "public",
+    },
+  });
+
+  if (result.createMediaPlaybackIdSuccessResponse?.data?.id) {
+    createdPlaybackId = result.createMediaPlaybackIdSuccessResponse.data.id;
+  }
+
+  logResponse("Create Playback ID", result);
+  return result;
+}
+
+async function getPlaybackId() {
+  if (!createdPlaybackId) {
+    console.log("⚠️  No playback ID available. Run createPlaybackId first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playback.getPlaybackId({
+    playbackId: createdPlaybackId,
+  });
+
+  logResponse("Get Playback ID", result);
+  return result;
+}
+
+async function deletePlaybackId() {
+  if (!createdPlaybackId) {
+    console.log("⚠️  No playback ID available. Run createPlaybackId first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playback.deleteMediaPlaybackId({
+    playbackId: createdPlaybackId,
+  });
+
+  logResponse("Delete Playback ID", result);
+  createdPlaybackId = undefined; // Reset the ID since playback ID is deleted
+  return result;
+}
+
+async function main() {
+  console.log("▶️  Playback API Samples");
+  console.log("========================");
+  
+  await runSample("Create Playback ID", createPlaybackId);
+  await runSample("Get Playback ID", getPlaybackId);
+  
+  // Uncomment to delete the playback ID
+  // await runSample("Delete Playback ID", deletePlaybackId);
+}
+
+main().catch(console.error);

package/samples/media/playlist.ts

@@ -0,0 +1,201 @@
+/**
+ * Playlist API Samples
+ * 
+ * This file demonstrates how to use the Playlist API to:
+ * - Create playlists
+ * - List playlists
+ * - Get playlist by ID
+ * - Update playlists
+ * - Add/remove/reorder media in playlists
+ * - Delete playlists
+ * 
+ * Run this sample:
+ * npx tsx media/playlist.ts
+ */
+
+import { createFastpixClient, runSample } from "../common/setup.js";
+import { config, logResponse } from "../common/config.js";
+
+let createdPlaylistId: string | undefined;
+let mediaIds: string[] = [];
+
+async function createPlaylist() {
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.createAPlaylist({
+    requestBody: {
+      name: config.samplePlaylistName,
+      description: config.samplePlaylistDescription,
+      metadata: {
+        category: "sample",
+        created_by: "sdk",
+      },
+    },
+  });
+
+  if (result.createAPlaylistSuccessResponse?.data?.id) {
+    createdPlaylistId = result.createAPlaylistSuccessResponse.data.id;
+  }
+
+  logResponse("Create Playlist", result);
+  return result;
+}
+
+async function listPlaylists() {
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.getAllPlaylists({
+    limit: 10,
+    offset: 0,
+  });
+
+  logResponse("List Playlists", result);
+  return result;
+}
+
+async function getPlaylistById() {
+  if (!createdPlaylistId) {
+    console.log("⚠️  No playlist ID available. Run createPlaylist first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.getPlaylistById({
+    playlistId: createdPlaylistId,
+  });
+
+  logResponse("Get Playlist by ID", result);
+  return result;
+}
+
+async function updatePlaylist() {
+  if (!createdPlaylistId) {
+    console.log("⚠️  No playlist ID available. Run createPlaylist first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.updateAPlaylist({
+    playlistId: createdPlaylistId,
+    requestBody: {
+      name: "Updated Sample Playlist",
+      description: "This playlist has been updated via SDK",
+      metadata: {
+        category: "updated-sample",
+        updated_by: "sdk",
+      },
+    },
+  });
+
+  logResponse("Update Playlist", result);
+  return result;
+}
+
+async function addMediaToPlaylist() {
+  if (!createdPlaylistId) {
+    console.log("⚠️  No playlist ID available. Run createPlaylist first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  // First, get some media to add to the playlist
+  const mediaList = await fastpix.manageVideos.listMedia({ limit: 2 });
+  const mediaItems = mediaList.listMediaSuccessResponse?.data?.media || [];
+  
+  if (mediaItems.length === 0) {
+    console.log("⚠️  No media found. Please create some media first.");
+    return;
+  }
+
+  // Add first media item to playlist
+  const mediaId = mediaItems[0].id;
+  mediaIds.push(mediaId);
+
+  const result = await fastpix.playlist.addMediaToPlaylist({
+    playlistId: createdPlaylistId,
+    requestBody: {
+      mediaId: mediaId,
+    },
+  });
+
+  logResponse("Add Media to Playlist", result);
+  return result;
+}
+
+async function changeMediaOrder() {
+  if (!createdPlaylistId || mediaIds.length === 0) {
+    console.log("⚠️  No playlist or media available. Run createPlaylist and addMediaToPlaylist first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.changeMediaOrderInPlaylist({
+    playlistId: createdPlaylistId,
+    requestBody: {
+      mediaId: mediaIds[0],
+      order: 1,
+    },
+  });
+
+  logResponse("Change Media Order", result);
+  return result;
+}
+
+async function deleteMediaFromPlaylist() {
+  if (!createdPlaylistId || mediaIds.length === 0) {
+    console.log("⚠️  No playlist or media available. Run createPlaylist and addMediaToPlaylist first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.deleteMediaFromPlaylist({
+    playlistId: createdPlaylistId,
+    requestBody: {
+      mediaId: mediaIds[0],
+    },
+  });
+
+  logResponse("Delete Media from Playlist", result);
+  mediaIds = []; // Reset media IDs
+  return result;
+}
+
+async function deletePlaylist() {
+  if (!createdPlaylistId) {
+    console.log("⚠️  No playlist ID available. Run createPlaylist first.");
+    return;
+  }
+
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.playlist.deleteAPlaylist({
+    playlistId: createdPlaylistId,
+  });
+
+  logResponse("Delete Playlist", result);
+  createdPlaylistId = undefined; // Reset the ID since playlist is deleted
+  return result;
+}
+
+async function main() {
+  console.log("📋 Playlist API Samples");
+  console.log("=======================");
+  
+  await runSample("Create Playlist", createPlaylist);
+  await runSample("List Playlists", listPlaylists);
+  await runSample("Get Playlist by ID", getPlaylistById);
+  await runSample("Update Playlist", updatePlaylist);
+  await runSample("Add Media to Playlist", addMediaToPlaylist);
+  await runSample("Change Media Order", changeMediaOrder);
+  await runSample("Delete Media from Playlist", deleteMediaFromPlaylist);
+  
+  // Uncomment to delete the playlist (be careful!)
+  // await runSample("Delete Playlist", deletePlaylist);
+}
+
+main().catch(console.error);

package/samples/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@fastpix/fastpix-node-samples",
+  "version": "1.0.0",
+  "description": "Sample code demonstrating FastPix Node.js SDK usage",
+  "type": "module",
+  "scripts": {
+    "build": "cd .. && npm run build",
+    "media": "npx tsx media/*.ts",
+    "live": "npx tsx live/*.ts",
+    "analytics": "npx tsx analytics/*.ts",
+    "ai": "npx tsx ai/*.ts",
+    "security": "npx tsx security/*.ts",
+    "all": "npx tsx */*.ts",
+    "input-video": "npx tsx media/input-video.ts",
+    "manage-videos": "npx tsx media/manage-videos.ts",
+    "playback": "npx tsx media/playback.ts",
+    "playlist": "npx tsx media/playlist.ts",
+    "start-live-stream": "npx tsx live/start-live-stream.ts",
+    "manage-live-stream": "npx tsx live/manage-live-stream.ts",
+    "live-playback": "npx tsx live/live-playback.ts",
+    "views": "npx tsx analytics/views.ts",
+    "metrics": "npx tsx analytics/metrics.ts",
+    "dimensions": "npx tsx analytics/dimensions.ts",
+    "errors": "npx tsx analytics/errors.ts",
+    "ai-features": "npx tsx ai/ai-features.ts",
+    "signing-keys": "npx tsx security/signing-keys.ts",
+    "drm-configurations": "npx tsx security/drm-configurations.ts"
+  },
+  "keywords": [
+    "fastpix",
+    "video",
+    "streaming",
+    "sdk",
+    "samples",
+    "examples"
+  ],
+  "author": "FastPix",
+  "license": "MIT",
+  "dependencies": {
+    "@fastpix/fastpix-node": "file:..",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/samples/security/drm-configurations.ts

@@ -0,0 +1,125 @@
+/**
+ * DRM Configurations API Samples
+ * 
+ * This file demonstrates how to use the DRM Configurations API to:
+ * - List DRM configurations
+ * - Get DRM configuration by ID
+ * 
+ * Run this sample:
+ * npx tsx security/drm-configurations.ts
+ */
+
+import { createFastpixClient, runSample } from "../common/setup.js";
+import { logResponse } from "../common/config.js";
+
+async function listDrmConfigurations() {
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.drmConfigurations.getDrmConfiguration();
+
+  logResponse("List DRM Configurations", result);
+  return result;
+}
+
+async function getDrmConfigurationById() {
+  const fastpix = createFastpixClient();
+  
+  // First, get available DRM configurations
+  const configs = await fastpix.drmConfigurations.getDrmConfiguration();
+  const configId = configs.getDrmConfigurationSuccessResponse?.data?.configurations?.[0]?.id;
+  
+  if (!configId) {
+    console.log("⚠️  No DRM configurations found.");
+    return;
+  }
+
+  const result = await fastpix.drmConfigurations.getDrmConfigurationById({
+    configId: configId,
+  });
+
+  logResponse(`Get DRM Configuration by ID (${configId})`, result);
+  return result;
+}
+
+async function exploreDrmConfigurations() {
+  const fastpix = createFastpixClient();
+  
+  const result = await fastpix.drmConfigurations.getDrmConfiguration();
+  const configurations = result.getDrmConfigurationSuccessResponse?.data?.configurations || [];
+  
+  console.log("\n🔒 DRM Configurations Overview:");
+  console.log("===============================");
+  console.log(`Found ${configurations.length} DRM configurations:`);
+  
+  for (const config of configurations) {
+    console.log(`\n📋 Configuration: ${config.name || 'Unnamed'}`);
+    console.log(`   ID: ${config.id}`);
+    console.log(`   Type: ${config.type || 'Unknown'}`);
+    console.log(`   Status: ${config.status || 'Unknown'}`);
+    
+    if (config.description) {
+      console.log(`   Description: ${config.description}`);
+    }
+    
+    if (config.supportedFormats) {
+      console.log(`   Supported Formats: ${config.supportedFormats.join(', ')}`);
+    }
+  }
+
+  return result;
+}
+
+async function getDetailedDrmInfo() {
+  const fastpix = createFastpixClient();
+  
+  // Get all configurations
+  const configs = await fastpix.drmConfigurations.getDrmConfiguration();
+  const configurations = configs.getDrmConfigurationSuccessResponse?.data?.configurations || [];
+  
+  if (configurations.length === 0) {
+    console.log("⚠️  No DRM configurations available.");
+    return;
+  }
+
+  console.log("\n🔍 Detailed DRM Configuration Information:");
+  console.log("==========================================");
+
+  // Get detailed info for each configuration
+  for (const config of configurations.slice(0, 3)) { // Limit to first 3 for demo
+    try {
+      const detailedConfig = await fastpix.drmConfigurations.getDrmConfigurationById({
+        configId: config.id!,
+      });
+
+      console.log(`\n📊 ${config.name || 'Configuration'} (${config.id}):`);
+      console.log(`   Type: ${detailedConfig.data?.type || 'Unknown'}`);
+      console.log(`   Status: ${detailedConfig.data?.status || 'Unknown'}`);
+      console.log(`   Created: ${detailedConfig.data?.createdAt || 'Unknown'}`);
+      console.log(`   Updated: ${detailedConfig.data?.updatedAt || 'Unknown'}`);
+      
+      if (detailedConfig.data?.settings) {
+        console.log(`   Settings: ${JSON.stringify(detailedConfig.data.settings, null, 2)}`);
+      }
+      
+      if (detailedConfig.data?.capabilities) {
+        console.log(`   Capabilities: ${detailedConfig.data.capabilities.join(', ')}`);
+      }
+    } catch (error) {
+      console.log(`   ❌ Error getting details for ${config.id}: ${error}`);
+    }
+  }
+
+  return configs;
+}
+
+async function main() {
+  console.log("🔒 DRM Configurations API Samples");
+  console.log("===================================");
+  
+  await runSample("List DRM Configurations", listDrmConfigurations);
+  await runSample("Get DRM Configuration by ID", getDrmConfigurationById);
+  await runSample("Explore DRM Configurations", exploreDrmConfigurations);
+  await runSample("Get Detailed DRM Info", getDetailedDrmInfo);
+}
+
+main().catch(console.error);