@fastpix/fastpix-node 2.0.4 → 2.0.6

package/tests/artifacts-non-get/updated-source-access.raw.json

@@ -0,0 +1,94 @@
+{
+  "success": true,
+  "data": {
+    "thumbnail": "https://images.fastpix.io/446315bf-11a7-44d2-92ef-a0c56808d2d0/thumbnail.png",
+    "id": "3123e275-3f7f-4abf-9655-7a8f5a7dbc61",
+    "workspaceId": "fd9197bb-8cfa-4569-b046-a30fb95e2381",
+    "metadata": {
+      "updated": "true"
+    },
+    "mediaQuality": "standard",
+    "creatorId": "8fa85f64-5717-4562-b3fc-2c963f66afa6",
+    "title": "sdk validate title",
+    "maxResolution": "720p",
+    "sourceResolution": "1080",
+    "status": "Ready",
+    "sourceAccess": true,
+    "playbackIds": [
+      {
+        "id": "446315bf-11a7-44d2-92ef-a0c56808d2d0",
+        "accessPolicy": "public",
+        "accessRestrictions": {
+          "domains": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          },
+          "userAgents": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          }
+        }
+      },
+      {
+        "id": "ca3fb5ce-b9de-432c-80b9-e332569c735c",
+        "accessPolicy": "public",
+        "accessRestrictions": {
+          "domains": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          },
+          "userAgents": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          }
+        }
+      }
+    ],
+    "tracks": [
+      {
+        "id": "237e7472-0fac-458b-9dd4-209844533803",
+        "type": "subtitle",
+        "status": "preparing",
+        "languageCode": "en-US",
+        "languageName": "English"
+      },
+      {
+        "id": "58ccc04e-dbbc-4ed2-bc04-f128106034a2",
+        "type": "audio",
+        "status": "available",
+        "languageCode": "it",
+        "languageName": "Italian"
+      },
+      {
+        "id": "5cf0ba86-4615-4bd6-a04a-f0c0e89610df",
+        "type": "video",
+        "width": 1920,
+        "height": 1080,
+        "frameRate": "60.000",
+        "status": "available"
+      },
+      {
+        "id": "c1926bee-969c-431f-b7c5-d321eb9460d3",
+        "type": "audio",
+        "status": "available",
+        "languageCode": "und",
+        "languageName": "default"
+      }
+    ],
+    "generatedSubtitles": [
+      {
+        "status": "preparing"
+      }
+    ],
+    "isAudioOnly": false,
+    "subtitleAvailable": false,
+    "duration": "00:00:10",
+    "aspectRatio": "16:9",
+    "createdAt": "2026-05-20T12:50:15.662960Z",
+    "updatedAt": "2026-05-20T12:54:15.795092Z"
+  }
+}

package/tests/artifacts-non-get/updated-source-access.sdk.json

@@ -0,0 +1,94 @@
+{
+  "success": true,
+  "data": {
+    "thumbnail": "https://images.fastpix.io/446315bf-11a7-44d2-92ef-a0c56808d2d0/thumbnail.png",
+    "id": "3123e275-3f7f-4abf-9655-7a8f5a7dbc61",
+    "workspaceId": "fd9197bb-8cfa-4569-b046-a30fb95e2381",
+    "metadata": {
+      "updated": "true"
+    },
+    "mediaQuality": "standard",
+    "creatorId": "8fa85f64-5717-4562-b3fc-2c963f66afa6",
+    "title": "sdk validate title",
+    "maxResolution": "720p",
+    "sourceResolution": "1080",
+    "status": "Ready",
+    "sourceAccess": true,
+    "playbackIds": [
+      {
+        "id": "446315bf-11a7-44d2-92ef-a0c56808d2d0",
+        "accessPolicy": "public",
+        "accessRestrictions": {
+          "domains": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          },
+          "userAgents": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          }
+        }
+      },
+      {
+        "id": "ca3fb5ce-b9de-432c-80b9-e332569c735c",
+        "accessPolicy": "public",
+        "accessRestrictions": {
+          "domains": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          },
+          "userAgents": {
+            "defaultPolicy": "allow",
+            "allow": [],
+            "deny": []
+          }
+        }
+      }
+    ],
+    "tracks": [
+      {
+        "id": "237e7472-0fac-458b-9dd4-209844533803",
+        "type": "subtitle",
+        "status": "preparing",
+        "languageName": "English",
+        "languageCode": "en-US"
+      },
+      {
+        "id": "58ccc04e-dbbc-4ed2-bc04-f128106034a2",
+        "type": "audio",
+        "status": "available",
+        "languageName": "Italian",
+        "languageCode": "it"
+      },
+      {
+        "id": "5cf0ba86-4615-4bd6-a04a-f0c0e89610df",
+        "type": "video",
+        "width": 1920,
+        "height": 1080,
+        "frameRate": "60.000",
+        "status": "available"
+      },
+      {
+        "id": "c1926bee-969c-431f-b7c5-d321eb9460d3",
+        "type": "audio",
+        "status": "available",
+        "languageName": "default",
+        "languageCode": "und"
+      }
+    ],
+    "generatedSubtitles": [
+      {
+        "status": "preparing"
+      }
+    ],
+    "isAudioOnly": false,
+    "subtitleAvailable": false,
+    "duration": "00:00:10",
+    "aspectRatio": "16:9",
+    "createdAt": "2026-05-20T12:50:15.662Z",
+    "updatedAt": "2026-05-20T12:54:15.795Z"
+  }
+}

package/tests/build-url-mapping-pass2.mjs

@@ -0,0 +1,77 @@
+// Second-pass URL replacements for entries that didn't match by link text.
+import { readFileSync, writeFileSync, readdirSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+
+const urlMap = {
+  "https://docs.fastpix.com/": "https://fastpix.com/docs/",
+  "https://docs.fastpix.com/changelog/api-update-direct-upload-media-from-device":
+    "https://fastpix.com/docs/changelog/api-update-direct-upload-media-from-device",
+  "https://docs.fastpix.com/docs/basic-authentication":
+    "https://fastpix.com/docs/getting-started/activate-your-account#authentication-format",
+  "https://docs.fastpix.com/docs/live-stream-overview":
+    "https://fastpix.com/docs/get-started/live-overview",
+  "https://docs.fastpix.com/docs/video-data-overview":
+    "https://fastpix.com/docs/concepts/what-video-data-do-we-capture",
+  // No 1:1 replacement in fixed.yaml. Closest user-facing page for the
+  // signing-keys concept lives under video-security:
+  "https://docs.fastpix.com/reference/signingkeys-overview":
+    "https://fastpix.com/docs/video-security/secure-media-access-with-jwts",
+};
+
+const sortedKeys = Object.keys(urlMap).sort((a, b) => b.length - a.length);
+
+function walk(dir, out = []) {
+  for (const f of readdirSync(dir)) {
+    const p = join(dir, f);
+    const st = statSync(p);
+    if (st.isDirectory()) {
+      if (f === "node_modules" || f === ".git" || f === "dist") continue;
+      walk(p, out);
+    } else if (f.endsWith(".md")) {
+      out.push(p);
+    }
+  }
+  return out;
+}
+
+const mdFiles = walk(ROOT);
+let totalReplacements = 0;
+let filesChanged = 0;
+for (const file of mdFiles) {
+  let content = readFileSync(file, "utf-8");
+  let fileCount = 0;
+  for (const oldUrl of sortedKeys) {
+    const newUrl = urlMap[oldUrl];
+    if (content.includes(oldUrl)) {
+      const count = content.split(oldUrl).length - 1;
+      content = content.split(oldUrl).join(newUrl);
+      fileCount += count;
+    }
+  }
+  if (fileCount > 0) {
+    writeFileSync(file, content);
+    filesChanged++;
+    totalReplacements += fileCount;
+    console.log(`  ${file.replace(ROOT + "/", "")}  (${fileCount} replacements)`);
+  }
+}
+console.log(`\nPass 2: ${totalReplacements} replacements across ${filesChanged} files.`);
+
+// Verify no docs.fastpix URLs remain
+const remaining = new Set();
+for (const file of mdFiles) {
+  const c = readFileSync(file, "utf-8");
+  for (const m of c.matchAll(/https?:\/\/docs\.fastpix\.[^\s"')<>]+/g)) {
+    remaining.add(`${m[0]}  (in ${file.replace(ROOT + "/", "")})`);
+  }
+}
+if (remaining.size) {
+  console.log(`\nStill-unresolved docs.fastpix URLs:`);
+  for (const u of [...remaining].sort()) console.log(`  ${u}`);
+} else {
+  console.log(`\n✅  Zero docs.fastpix URLs remain in any markdown file.`);
+}

package/tests/build-url-mapping.mjs

@@ -0,0 +1,101 @@
+// Build OLD → NEW URL mapping by pairing <a href="...">text</a> entries
+// across old-yaml.yaml and fixed.yaml. Then apply to every README under
+// the repo (excluding node_modules and the yaml files themselves).
+import { readFileSync, writeFileSync, readdirSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+
+// Parse all <a href="URL">TEXT</a> pairs in a yaml.
+function extractAnchors(yamlPath) {
+  const text = readFileSync(yamlPath, "utf-8");
+  const re = /<a href="(https?:\/\/[^"]+)"[^>]*>([^<]+)<\/a>/g;
+  const map = new Map(); // text → set of urls
+  let m;
+  while ((m = re.exec(text))) {
+    const url = m[1].trim();
+    const linkText = m[2].trim();
+    if (!map.has(linkText)) map.set(linkText, new Set());
+    map.get(linkText).add(url);
+  }
+  return map;
+}
+
+const oldMap = extractAnchors(join(ROOT, "old-yaml.yaml"));
+const newMap = extractAnchors(join(ROOT, "fixed.yaml"));
+
+// Build oldURL → newURL by linkText match.
+const urlMap = new Map();
+for (const [text, oldUrls] of oldMap) {
+  const newUrls = newMap.get(text);
+  if (!newUrls) continue;
+  // Prefer same-domain replacement; pick first new url
+  const newUrl = [...newUrls][0];
+  for (const oldUrl of oldUrls) {
+    if (oldUrl !== newUrl) urlMap.set(oldUrl, newUrl);
+  }
+}
+
+// Sort longest first to avoid prefix collisions in replacement
+const sortedKeys = [...urlMap.keys()].sort((a, b) => b.length - a.length);
+
+// Walk all .md files (excluding node_modules)
+function walk(dir, out = []) {
+  for (const f of readdirSync(dir)) {
+    const p = join(dir, f);
+    const st = statSync(p);
+    if (st.isDirectory()) {
+      if (f === "node_modules" || f === ".git" || f === "dist") continue;
+      walk(p, out);
+    } else if (f.endsWith(".md")) {
+      out.push(p);
+    }
+  }
+  return out;
+}
+
+const mdFiles = walk(ROOT);
+let totalReplacements = 0;
+let filesChanged = 0;
+
+for (const file of mdFiles) {
+  let content = readFileSync(file, "utf-8");
+  let changed = false;
+  let fileCount = 0;
+  for (const oldUrl of sortedKeys) {
+    const newUrl = urlMap.get(oldUrl);
+    if (content.includes(oldUrl)) {
+      const count = (
+        content.match(new RegExp(oldUrl.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g")) || []
+      ).length;
+      content = content.split(oldUrl).join(newUrl);
+      totalReplacements += count;
+      fileCount += count;
+      changed = true;
+    }
+  }
+  if (changed) {
+    writeFileSync(file, content);
+    filesChanged++;
+    console.log(`  ${file.replace(ROOT + "/", "")}  (${fileCount} replacements)`);
+  }
+}
+
+console.log(
+  `\nSummary: ${urlMap.size} URL mappings, ${totalReplacements} replacements across ${filesChanged} files.`,
+);
+
+// Diagnostic: orphan old URLs in markdown that didn't have a new-yaml counterpart
+const allOldUrlsInMd = new Set();
+for (const file of mdFiles) {
+  const c = readFileSync(file, "utf-8");
+  for (const m of c.matchAll(/https?:\/\/docs\.fastpix\.[^\s"')<>]+/g)) {
+    allOldUrlsInMd.add(m[0]);
+  }
+}
+if (allOldUrlsInMd.size) {
+  console.log(`\nUnmapped old docs.fastpix URLs still in markdown:`);
+  for (const u of [...allOldUrlsInMd].sort()) console.log(`  ${u}`);
+}

package/tests/check-broken-links.mjs

@@ -0,0 +1,89 @@
+// Check every external URL across all markdown files for broken links.
+// Uses HEAD first, falls back to GET if HEAD fails. Treats 2xx/3xx as OK.
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+
+function walk(dir, out = []) {
+  for (const f of readdirSync(dir)) {
+    const p = join(dir, f);
+    const st = statSync(p);
+    if (st.isDirectory()) {
+      if (["node_modules", ".git", "dist"].includes(f)) continue;
+      walk(p, out);
+    } else if (f.endsWith(".md")) out.push(p);
+  }
+  return out;
+}
+
+const mdFiles = walk(ROOT);
+const urlToFiles = new Map(); // url -> Set(files)
+const urlRe = /https?:\/\/[^\s"'<>()[\]`]+/g;
+
+for (const f of mdFiles) {
+  const content = readFileSync(f, "utf-8");
+  for (const m of content.matchAll(urlRe)) {
+    let url = m[0].replace(/[.,;:)\]]+$/, ""); // strip trailing punctuation
+    if (!urlToFiles.has(url)) urlToFiles.set(url, new Set());
+    urlToFiles.get(url).add(f.replace(ROOT + "/", ""));
+  }
+}
+
+const urls = [...urlToFiles.keys()].sort();
+console.log(`Checking ${urls.length} unique URLs across ${mdFiles.length} markdown files...\n`);
+
+async function checkUrl(url) {
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), 15000);
+  try {
+    let res = await fetch(url, {
+      method: "HEAD",
+      redirect: "follow",
+      signal: ctrl.signal,
+      headers: { "User-Agent": "Mozilla/5.0 (link-checker)" },
+    });
+    // Many servers reject HEAD (405) — fall back to GET range.
+    if (res.status === 405 || res.status === 403 || res.status === 0) {
+      res = await fetch(url, {
+        method: "GET",
+        redirect: "follow",
+        signal: ctrl.signal,
+        headers: { "User-Agent": "Mozilla/5.0 (link-checker)", Range: "bytes=0-0" },
+      });
+    }
+    return { ok: res.ok || (res.status >= 200 && res.status < 400), status: res.status };
+  } catch (e) {
+    return { ok: false, status: 0, error: e.name === "AbortError" ? "timeout" : e.message };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+const broken = [];
+const concurrency = 10;
+let idx = 0;
+async function worker() {
+  while (idx < urls.length) {
+    const i = idx++;
+    const url = urls[i];
+    const r = await checkUrl(url);
+    const tag = r.ok ? "✅" : "❌";
+    const status = r.status || r.error || "?";
+    process.stdout.write(
+      `${tag} [${String(i + 1).padStart(3)}/${urls.length}] ${status}  ${url}\n`,
+    );
+    if (!r.ok) broken.push({ url, status: r.status, error: r.error, files: [...urlToFiles.get(url)] });
+  }
+}
+await Promise.all(Array.from({ length: concurrency }, worker));
+
+console.log(`\n=== Broken links: ${broken.length} ===`);
+for (const b of broken) {
+  console.log(`\n${b.url}`);
+  console.log(`  status: ${b.status || b.error}`);
+  console.log(`  appears in:`);
+  for (const f of b.files) console.log(`    - ${f}`);
+}

package/tests/diff-api-vs-sdk.mjs

@@ -0,0 +1,94 @@
+// One-shot diff over GET artifact pairs.
+// For each <op>.api.json + <op>.sdk.json pair:
+//   - missingInSDK  : paths in API not in SDK
+//   - nullInSDKNotInAPI : paths in SDK whose value is null AND not present in API
+import { readdirSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ARTIFACTS = join(__dirname, "artifacts");
+
+function canonicalKey(k) {
+  const camel = k.includes("_")
+    ? k.toLowerCase().replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase())
+    : k;
+  return camel.replaceAll("SDK", "Sdk").replaceAll("API", "Api");
+}
+
+// Collect leaf+intermediate paths. For SDK side, also track which paths have a
+// null value so we can isolate "field exists but value is null" cases.
+function collectPaths(value, prefix = "", out = new Map()) {
+  if (value === undefined) return out;
+  if (value === null) {
+    if (prefix) out.set(prefix, "null");
+    return out;
+  }
+  if (typeof value !== "object") {
+    if (prefix) out.set(prefix, "value");
+    return out;
+  }
+  if (Array.isArray(value)) {
+    // treat [] same as missing — skip empty arrays for comparison
+    if (value.length === 0) return out;
+    const p = prefix ? `${prefix}[]` : "[]";
+    out.set(p, "array");
+    for (const item of value) collectPaths(item, p, out);
+    return out;
+  }
+  for (const [k, v] of Object.entries(value)) {
+    if (Array.isArray(v) && v.length === 0) continue;
+    const ck = canonicalKey(k);
+    const p = prefix ? `${prefix}.${ck}` : ck;
+    out.set(p, v === null ? "null" : typeof v === "object" ? "object" : "value");
+    collectPaths(v, p, out);
+  }
+  return out;
+}
+
+const files = readdirSync(ARTIFACTS);
+const ops = new Set();
+for (const f of files) {
+  const m = f.match(/^(.+)\.(api|sdk)\.json$/);
+  if (m) ops.add(m[1]);
+}
+
+const report = [];
+for (const op of [...ops].sort()) {
+  const apiPath = join(ARTIFACTS, `${op}.api.json`);
+  const sdkPath = join(ARTIFACTS, `${op}.sdk.json`);
+  let api, sdk;
+  try {
+    api = JSON.parse(readFileSync(apiPath, "utf-8"));
+    sdk = JSON.parse(readFileSync(sdkPath, "utf-8"));
+  } catch {
+    continue;
+  }
+
+  const apiPaths = collectPaths(api);
+  const sdkPaths = collectPaths(sdk);
+
+  // Missing in SDK = in API but not in SDK
+  const missingInSDK = [...apiPaths.keys()].filter((p) => !sdkPaths.has(p));
+  // Null in SDK not in API = SDK path has null value AND API does not have that path
+  const nullInSDKNotInAPI = [...sdkPaths.entries()]
+    .filter(([p, kind]) => kind === "null" && !apiPaths.has(p))
+    .map(([p]) => p);
+
+  if (missingInSDK.length === 0 && nullInSDKNotInAPI.length === 0) continue;
+
+  report.push({ op, missingInSDK: missingInSDK.sort(), nullInSDKNotInAPI: nullInSDKNotInAPI.sort() });
+}
+
+// Print compact summary
+console.log(`\nEndpoints with mismatches: ${report.length}\n`);
+for (const r of report) {
+  console.log(`── ${r.op} ──`);
+  if (r.missingInSDK.length) {
+    console.log(`  Missing in SDK (${r.missingInSDK.length}): ${r.missingInSDK.join(", ")}`);
+  }
+  if (r.nullInSDKNotInAPI.length) {
+    console.log(`  Null in SDK, absent in API (${r.nullInSDKNotInAPI.length}): ${r.nullInSDKNotInAPI.join(", ")}`);
+  }
+  console.log();
+}

package/tests/diff-passed.mjs

@@ -0,0 +1,99 @@
+// Per-endpoint strict diff for every PASSED endpoint (SDK call resolved).
+// Reports: clean match, or specific field-name differences.
+//   - missingInSDK: API has the field, SDK doesn't
+//   - extraInSDK: SDK has the field, API doesn't
+// Skips: artifacts where the SDK threw / API returned an error envelope.
+
+import { readdirSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ARTIFACTS = join(__dirname, "artifacts");
+
+function collectPathsStrict(value, prefix = "", out = new Set()) {
+  if (value === undefined || value === null) return out;
+  if (typeof value !== "object") return out;
+  if (Array.isArray(value)) {
+    if (value.length === 0) return out;
+    const p = prefix ? `${prefix}[]` : "[]";
+    for (const item of value) collectPathsStrict(item, p, out);
+    return out;
+  }
+  for (const [k, v] of Object.entries(value)) {
+    const p = prefix ? `${prefix}.${k}` : k;
+    out.add(p);
+    collectPathsStrict(v, p, out);
+  }
+  return out;
+}
+
+const files = readdirSync(ARTIFACTS);
+const ops = new Set();
+for (const f of files) {
+  const m = f.match(/^(.+)\.(api|sdk)\.json$/);
+  if (m) ops.add(m[1]);
+}
+
+const sorted = [...ops].sort();
+let clean = 0;
+let dirty = 0;
+let skipped = 0;
+const dirtyDetails = [];
+
+for (const op of sorted) {
+  const apiPath = join(ARTIFACTS, `${op}.api.json`);
+  const sdkPath = join(ARTIFACTS, `${op}.sdk.json`);
+  let api, sdk;
+  try {
+    api = JSON.parse(readFileSync(apiPath, "utf-8"));
+    sdk = JSON.parse(readFileSync(sdkPath, "utf-8"));
+  } catch {
+    continue;
+  }
+  // Skip 4xx/error artifacts — not real schema comparisons
+  if (api && api.success === false) {
+    skipped++;
+    continue;
+  }
+  if (sdk && sdk.statusCode && sdk.statusCode >= 400) {
+    skipped++;
+    continue;
+  }
+
+  const apiPaths = collectPathsStrict(api);
+  const sdkPaths = collectPathsStrict(sdk);
+
+  const missingInSDK = [...apiPaths].filter((p) => !sdkPaths.has(p)).sort();
+  const extraInSDK = [...sdkPaths].filter((p) => !apiPaths.has(p)).sort();
+
+  if (missingInSDK.length === 0 && extraInSDK.length === 0) {
+    clean++;
+    console.log(`✅  ${op}`);
+  } else {
+    dirty++;
+    dirtyDetails.push({ op, missingInSDK, extraInSDK });
+    console.log(
+      `⚠️  ${op}  (missing: ${missingInSDK.length}, extra: ${extraInSDK.length})`,
+    );
+  }
+}
+
+if (dirtyDetails.length) {
+  console.log("\n=== Details ===");
+  for (const { op, missingInSDK, extraInSDK } of dirtyDetails) {
+    console.log(`\n── ${op} ──`);
+    if (missingInSDK.length) {
+      console.log(`  Missing in SDK (API has, SDK doesn't): ${missingInSDK.length}`);
+      for (const p of missingInSDK) console.log(`    - ${p}`);
+    }
+    if (extraInSDK.length) {
+      console.log(`  Extra in SDK (SDK has, API doesn't): ${extraInSDK.length}`);
+      for (const p of extraInSDK) console.log(`    - ${p}`);
+    }
+  }
+}
+
+console.log(
+  `\nSummary: clean=${clean} dirty=${dirty} skipped(error-responses)=${skipped}  total=${clean + dirty + skipped}`,
+);