@dadan-mvp/record-sdk 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# `@dadan-mvp/record-sdk`
+
+Headless Dadan Record SDK — capture, upload (TUS), and session events. **No UI, no iframe.**
+
+For the default in-page recorder use [`@dadan-mvp/record-sdk-ui`](../record-sdk-ui) or a framework package (`-react` / `-vue` / `-angular`).
+
+## Install
+
+```bash
+npm install @dadan-mvp/record-sdk
+```
+
+## Headless
+
+```ts
+import { createRecorder, isSupported } from "@dadan-mvp/record-sdk";
+
+const support = await isSupported();
+if (!support.supported) throw new Error(support.error);
+
+const recorder = await createRecorder({
+  mode: "custom",
+  publicAppId, // SDK mints uploadToken; Origin must be allowlisted
+  videoTitle: "My recording", // optional
+  // folderId / teamId optional — else app defaults from session
+  uploadToken,
+  environment: "sandbox",
+});
+
+recorder.configureButton().on("upload-complete", (video) => {
+  console.log(video);
+});
+
+recorder.open({ mode: "both" });
+// Drive your own UI, or pair with @dadan-mvp/record-sdk-ui createInstance.
+```
+
+## With default UI
+
+```ts
+import { createInstance } from "@dadan-mvp/record-sdk-ui";
+```

package/dist/chunk-DBC6WGEP.js

@@ -0,0 +1,49 @@
+// src/is-supported.ts
+async function isSupported() {
+  const reasons = [];
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return {
+      supported: false,
+      error: "Record SDK requires a browser environment",
+      reasons: ["no-window"]
+    };
+  }
+  if (!window.isSecureContext) reasons.push("insecure-context");
+  if (!navigator.mediaDevices) {
+    reasons.push("no-media-devices");
+  } else if (typeof navigator.mediaDevices.getUserMedia !== "function") {
+    reasons.push("no-getUserMedia");
+  }
+  if (typeof MediaRecorder === "undefined") reasons.push("no-MediaRecorder");
+  if (reasons.length > 0) {
+    return {
+      supported: false,
+      error: `Record SDK not supported: ${reasons.join(", ")}`,
+      reasons
+    };
+  }
+  return { supported: true };
+}
+async function isModeSupported(mode) {
+  const base = await isSupported();
+  if (!base.supported) return base;
+  const reasons = [];
+  const needsDisplay = mode === "screen" || mode === "both";
+  if (needsDisplay && typeof navigator.mediaDevices?.getDisplayMedia !== "function") {
+    reasons.push("no-getDisplayMedia");
+  }
+  if (reasons.length > 0) {
+    return {
+      supported: false,
+      error: `Mode "${mode}" not supported: ${reasons.join(", ")}`,
+      reasons
+    };
+  }
+  return { supported: true };
+}
+
+export {
+  isSupported,
+  isModeSupported
+};
+//# sourceMappingURL=chunk-DBC6WGEP.js.map

package/dist/chunk-DBC6WGEP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/is-supported.ts"],"sourcesContent":["import type { IsSupportedResult, RecordingMode } from \"@dadan-mvp/sdk-protocol\";\r\n\r\n/** Hard requirements shared by all recording modes. */\r\nexport async function isSupported(): Promise<IsSupportedResult> {\r\n  const reasons: string[] = [];\r\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") {\r\n    return {\r\n      supported: false,\r\n      error: \"Record SDK requires a browser environment\",\r\n      reasons: [\"no-window\"],\r\n    };\r\n  }\r\n  if (!window.isSecureContext) reasons.push(\"insecure-context\");\r\n  if (!navigator.mediaDevices) {\r\n    reasons.push(\"no-media-devices\");\r\n  } else if (typeof navigator.mediaDevices.getUserMedia !== \"function\") {\r\n    reasons.push(\"no-getUserMedia\");\r\n  }\r\n  if (typeof MediaRecorder === \"undefined\") reasons.push(\"no-MediaRecorder\");\r\n  if (reasons.length > 0) {\r\n    return {\r\n      supported: false,\r\n      error: `Record SDK not supported: ${reasons.join(\", \")}`,\r\n      reasons,\r\n    };\r\n  }\r\n  return { supported: true };\r\n}\r\n\r\n/** Soft check for a specific mode (e.g. screen needs display-capture). */\r\nexport async function isModeSupported(\r\n  mode: RecordingMode\r\n): Promise<IsSupportedResult> {\r\n  const base = await isSupported();\r\n  if (!base.supported) return base;\r\n\r\n  const reasons: string[] = [];\r\n  const needsDisplay = mode === \"screen\" || mode === \"both\";\r\n  if (\r\n    needsDisplay &&\r\n    typeof navigator.mediaDevices?.getDisplayMedia !== \"function\"\r\n  ) {\r\n    reasons.push(\"no-getDisplayMedia\");\r\n  }\r\n  if (reasons.length > 0) {\r\n    return {\r\n      supported: false,\r\n      error: `Mode \"${mode}\" not supported: ${reasons.join(\", \")}`,\r\n      reasons,\r\n    };\r\n  }\r\n  return { supported: true };\r\n}\r\n"],"mappings":";AAGA,eAAsB,cAA0C;AAC9D,QAAM,UAAoB,CAAC;AAC3B,MAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aAAa;AACpE,WAAO;AAAA,MACL,WAAW;AAAA,MACX,OAAO;AAAA,MACP,SAAS,CAAC,WAAW;AAAA,IACvB;AAAA,EACF;AACA,MAAI,CAAC,OAAO,gBAAiB,SAAQ,KAAK,kBAAkB;AAC5D,MAAI,CAAC,UAAU,cAAc;AAC3B,YAAQ,KAAK,kBAAkB;AAAA,EACjC,WAAW,OAAO,UAAU,aAAa,iBAAiB,YAAY;AACpE,YAAQ,KAAK,iBAAiB;AAAA,EAChC;AACA,MAAI,OAAO,kBAAkB,YAAa,SAAQ,KAAK,kBAAkB;AACzE,MAAI,QAAQ,SAAS,GAAG;AACtB,WAAO;AAAA,MACL,WAAW;AAAA,MACX,OAAO,6BAA6B,QAAQ,KAAK,IAAI,CAAC;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,WAAW,KAAK;AAC3B;AAGA,eAAsB,gBACpB,MAC4B;AAC5B,QAAM,OAAO,MAAM,YAAY;AAC/B,MAAI,CAAC,KAAK,UAAW,QAAO;AAE5B,QAAM,UAAoB,CAAC;AAC3B,QAAM,eAAe,SAAS,YAAY,SAAS;AACnD,MACE,gBACA,OAAO,UAAU,cAAc,oBAAoB,YACnD;AACA,YAAQ,KAAK,oBAAoB;AAAA,EACnC;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,WAAO;AAAA,MACL,WAAW;AAAA,MACX,OAAO,SAAS,IAAI,oBAAoB,QAAQ,KAAK,IAAI,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,WAAW,KAAK;AAC3B;","names":[]}