salt-agent-sdk 0.33.0 → 0.34.0

package/dist/index.js

@@ -36,5 +36,6 @@ __exportStar(require("./ask"), exports);
 __exportStar(require("./socket"), exports);
 __exportStar(require("./actions"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./media"), exports);
 __exportStar(require("./device/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,kDAAgC;AAChC,+CAA6B;AAC7B,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,yCAAuB;AACvB,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,4CAA0B;AAC1B,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,kDAAgC;AAChC,+CAA6B;AAC7B,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,yCAAuB;AACvB,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,4CAA0B;AAC1B,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,oDAAkC"}

package/dist/media.d.ts

@@ -0,0 +1,125 @@
+import type { SaltId } from "./ids.js";
+export interface MediaPerson {
+    id: SaltId;
+    username: string;
+    display_name: string;
+    avatar_url: string | null;
+    account_type: string;
+}
+export type LiveSessionState = "connecting" | "live" | "ending" | "ended" | "failed";
+export interface LiveSession {
+    id: string;
+    chat_id: SaltId;
+    state: LiveSessionState;
+    title: string | null;
+    source_type: "webrtc" | "rtmp";
+    record: boolean;
+    host: MediaPerson;
+    started_at: string | null;
+    ended_at: string | null;
+    ended_reason: string | null;
+    viewer_count: number;
+    peak_viewers: number;
+    recording: null | {
+        media_id: string;
+        video_post_id: string;
+        status: "processing" | "draft" | "published" | "discarded";
+    };
+    /** Viewer-relative: the host, or a room admin. */
+    can_end: boolean;
+}
+export interface StreamCredential {
+    id: SaltId;
+    chat_id: SaltId;
+    label: string | null;
+    protocol: "rtmps";
+    key_last4: string;
+    persistent: boolean;
+    enabled: boolean;
+    last_used_at: string | null;
+    created_at: string;
+}
+/** Returned once, when a live session or credential is made or rotated, and never again. Treat `stream_key` as a secret. */
+export interface PublishBlock {
+    ingest_endpoint: string;
+    stream_key: string;
+    /** `rtmps://<ingest_endpoint>:443/app/`: append the stream key for the full publish URL. */
+    rtmps_url: string;
+}
+export interface MediaAsset {
+    id: string;
+    kind: string;
+    state: "uploading" | "processing" | "ready" | "failed" | "removed";
+    playback: null | {
+        kind: "progressive" | "hls";
+        url: string;
+        poster_url: string | null;
+    };
+    duration_ms: number | null;
+    width: number | null;
+    height: number | null;
+    failed_reason: string | null;
+    transcript: null | {
+        status: "pending" | "ready" | "failed";
+        language: string | null;
+        text_url: string | null;
+        vtt_url: string | null;
+    };
+    created_at: string;
+}
+export interface VideoPost {
+    id: string;
+    status: "draft" | "published" | "hidden" | "removed";
+    caption: string | null;
+    media: MediaAsset;
+    creator: MediaPerson;
+    chat_id: SaltId;
+    room: null | {
+        id: SaltId;
+        name: string;
+    };
+    also_in_chat_id: SaltId | null;
+    message_id: SaltId | null;
+    published_at: string | null;
+    seq: number | null;
+    counts: {
+        views: number;
+        replies: number;
+        reactions: number;
+    };
+    can_edit: boolean;
+    live_session_id: string | null;
+}
+export interface UploadPlan {
+    upload_id: string;
+    part_size: number;
+    parts: {
+        n: number;
+        url: string;
+    }[];
+}
+export interface VideoFeedPage {
+    items: VideoPost[];
+    live: LiveSession[];
+    next_before_seq: number | null;
+}
+export type VideoFeedScope = "following" | "everyone" | "room";
+export interface VideoEvent {
+    post_id: string;
+    kind: string;
+    at: string;
+}
+export interface MediaPlaybackCookies {
+    expires_at: string;
+    /** Name to value. Send them as a `Cookie` header on requests to the media CDN host. */
+    cookies: Record<string, string>;
+}
+/** Where `uploadVideo` reads from: bytes in memory, or a path to a file on disk. */
+export type VideoUploadSource = Uint8Array | string;
+export interface UploadVideoOptions {
+    contentType: "video/mp4" | "video/quicktime" | "video/webm" | (string & {});
+    filename?: string;
+    /** Attempts per part before giving up (default 3). */
+    retries?: number;
+}
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"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"}

package/dist/media.js

@@ -0,0 +1,5 @@
+"use strict";
+// Live and short-video types (salt-api /api/v1/live_sessions, /stream_credentials, /media, /video_posts, /video/feed).
+// Shapes follow the media build contract; client.ts carries the methods.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":";AAAA,uHAAuH;AACvH,yEAAyE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salt-agent-sdk",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Plumbing for building Salt (saltapp.ai) agents: webhook receiving/routing, PGP encrypt/decrypt, a typed REST client, and card builders. Bring your own agent logic -- this handles everything Salt-protocol-specific.",
   "license": "MIT",
   "author": "0x0000F8 <0000F8@proton.me>",