@similie/hyphen-rtsp-tunnel 1.1.0

package/dist/services/sqs-notifier.js

@@ -0,0 +1,109 @@
+import { SQSClient, SendMessageCommand, } from "@aws-sdk/client-sqs";
+/**
+ * Env:
+ *  - SQS_QUEUE_URL (required)
+ *  - AWS_REGION (required)
+ *
+ * Credentials:
+ *  - resolved automatically by AWS SDK (env / instance role / task role / etc.)
+ */
+export class SqsNotifier {
+    enabled;
+    sqs = null;
+    queueUrl = null;
+    isFifo = false;
+    ctx = null;
+    constructor() {
+        const queueUrl = process.env.SQS_QUEUE_URL?.trim();
+        const region = process.env.AWS_REGION?.trim();
+        if (!queueUrl || !region) {
+            this.enabled = false;
+            return;
+        }
+        this.enabled = true;
+        this.queueUrl = queueUrl;
+        this.isFifo = queueUrl.endsWith(".fifo");
+        this.sqs = new SQSClient({ region });
+    }
+    init(ctx) {
+        this.ctx = ctx;
+        if (!this.enabled) {
+            return this.ctx.log("[rtsp-tunnel][sqs] disabled (missing SQS_QUEUE_URL or AWS_REGION)");
+        }
+        this.ctx.log("[rtsp-tunnel][sqs] enabled queue=", {
+            queueUrl: this.queueUrl,
+        });
+    }
+    async shutdown() {
+        // AWS SDK v3 clients have destroy() to close sockets
+        try {
+            this.sqs?.destroy();
+        }
+        catch { }
+        this.sqs = null;
+    }
+    async send(eventName, payload) {
+        this.ctx?.log("[rtsp-tunnel][sqs] send called", { eventName, payload });
+        if (!this.enabled || !this.sqs || !this.queueUrl)
+            return;
+        // Build a consistent message envelope
+        const msg = this.buildMessage(eventName, payload);
+        const params = {
+            QueueUrl: this.queueUrl,
+            MessageBody: JSON.stringify(msg),
+        };
+        // FIFO-safe handling
+        if (this.isFifo) {
+            params.MessageDeduplicationId = msg.deduplicationId;
+            params.MessageGroupId = msg.groupId;
+        }
+        try {
+            await this.sqs.send(new SendMessageCommand(params));
+            this.ctx?.log("[rtsp-tunnel][sqs] sent", {
+                eventName,
+                groupId: msg.groupId,
+            });
+        }
+        catch (err) {
+            this.ctx?.log("[rtsp-tunnel][sqs] send failed", {
+                eventName,
+                error: err?.message ?? err,
+            });
+            throw err;
+        }
+    }
+    // ----------------- internals -----------------
+    buildMessage(eventName, payload) {
+        // Prefer payloadId for grouping, then deviceId.
+        const groupId = payload.payloadId || payload.deviceId || "hyphen";
+        // Dedup: prefer payloadId if present; otherwise sessionId; otherwise a stable fallback.
+        // (SQS FIFO requires <= 128 chars; we keep it simple.)
+        const deduplicationId = payload.payloadId ||
+            payload.sessionId ||
+            `${payload.deviceId || "unknown"}:${eventName}:${payload.capturedAt || payload.at || ""}`;
+        // For stored snapshots, include storedUri if your storage worker attaches it.
+        // For now, it may be undefined and that’s fine.
+        const storedUri = payload.storedUri;
+        return {
+            version: 1,
+            source: "hyphen-rtsp-tunnel",
+            event: eventName,
+            capturedAt: payload.capturedAt || null,
+            at: payload.at || null,
+            deviceId: payload.deviceId || "unknown",
+            payloadId: payload.payloadId ?? null,
+            sessionId: payload.sessionId || null,
+            remote: payload.remote || null,
+            // file paths/uris
+            localPath: payload.localPath || null,
+            storedUri: storedUri || null,
+            // failure details (for snapshot:failed)
+            stage: payload.stage || null,
+            error: payload.error || null,
+            // FIFO helpers
+            groupId,
+            deduplicationId,
+        };
+    }
+}
+//# sourceMappingURL=sqs-notifier.js.map

package/dist/services/sqs-notifier.js.map

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

package/dist/services/storage-s3.d.ts

@@ -0,0 +1,12 @@
+import type { StorageAdapter, StoreInput, StoreResult } from "./storage.js";
+import { S3Client } from "@aws-sdk/client-s3";
+export declare class S3StorageAdapter implements StorageAdapter {
+    private readonly bucket;
+    private readonly prefix;
+    private readonly deleteOnMove;
+    name: string;
+    private readonly s3;
+    constructor(bucket: string, prefix?: string, s3Client?: S3Client, deleteOnMove?: boolean);
+    store(input: StoreInput): Promise<StoreResult>;
+}
+//# sourceMappingURL=storage-s3.d.ts.map

package/dist/services/storage-s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.d.ts","sourceRoot":"","sources":["../../src/services/storage-s3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,QAAQ,EAAoB,MAAM,oBAAoB,CAAC;AAMhE,qBAAa,gBAAiB,YAAW,cAAc;IAKnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAP/B,IAAI,SAAQ;IACZ,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAGX,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAsB,EAC/C,QAAQ,CAAC,EAAE,QAAQ,EACF,YAAY,GAAE,OAAc;IAMzC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAmCrD"}

package/dist/services/storage-s3.js

@@ -0,0 +1,49 @@
+import fs from "node:fs";
+import path from "node:path";
+import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
+function safeSegment(s) {
+    return (s || "unknown").replace(/[^a-zA-Z0-9._/-]/g, "_").slice(0, 128);
+}
+export class S3StorageAdapter {
+    bucket;
+    prefix;
+    deleteOnMove;
+    name = "s3";
+    s3;
+    constructor(bucket, prefix = "hyphen/rtsp", s3Client, deleteOnMove = true) {
+        this.bucket = bucket;
+        this.prefix = prefix;
+        this.deleteOnMove = deleteOnMove;
+        this.s3 = s3Client ?? new S3Client({});
+        if (!bucket)
+            throw new Error("S3StorageAdapter requires bucket");
+    }
+    async store(input) {
+        const fileName = path.basename(input.localPath);
+        const day = input.day ?? new Date(input.capturedAt).toISOString().slice(0, 10); // "2025-12-28"
+        const keyParts = [
+            safeSegment(this.prefix),
+            safeSegment(input.deviceId),
+            input.payloadId ? safeSegment(input.payloadId) : null,
+            //   safeSegment(input.capturedAt.replace(/[:.]/g, "-")),
+            day,
+            fileName,
+        ].filter(Boolean);
+        const key = keyParts.join("/");
+        const body = fs.createReadStream(input.localPath);
+        await this.s3.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            Body: body,
+            ContentType: "image/jpeg",
+        }));
+        if (this.deleteOnMove) {
+            fs.unlinkSync(input.localPath);
+        }
+        return {
+            storage: "s3",
+            storedUri: `s3://${this.bucket}/${key}`,
+        };
+    }
+}
+//# sourceMappingURL=storage-s3.js.map

package/dist/services/storage-s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-s3.js","sourceRoot":"","sources":["../../src/services/storage-s3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,OAAO,gBAAgB;IAKR;IACA;IAEA;IAPnB,IAAI,GAAG,IAAI,CAAC;IACK,EAAE,CAAW;IAE9B,YACmB,MAAc,EACd,SAAiB,aAAa,EAC/C,QAAmB,EACF,eAAwB,IAAI;QAH5B,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAwB;QAE9B,iBAAY,GAAZ,YAAY,CAAgB;QAE7C,IAAI,CAAC,EAAE,GAAG,QAAQ,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAiB;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,GAAG,GACP,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe;QACrF,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;YACxB,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC3B,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;YACrD,yDAAyD;YACzD,GAAG;YACH,QAAQ;SACT,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,IAAI,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAChB,IAAI,gBAAgB,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,GAAG;YACR,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,YAAY;SAC1B,CAAC,CACH,CAAC;QAEF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,QAAQ,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE;SACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/services/storage-worker.d.ts

@@ -0,0 +1,22 @@
+import type { RtspTunnelEvents } from "./events.js";
+import type { StorageAdapter } from "./storage.js";
+type CtxLike = {
+    log: (...args: any[]) => void;
+};
+export declare class StorageWorker {
+    private readonly ctx;
+    private readonly events;
+    private readonly storage;
+    private readonly concurrency;
+    private readonly deleteAfterStore;
+    private running;
+    private inFlight;
+    private queue;
+    private onCapturedBound;
+    constructor(ctx: CtxLike, events: RtspTunnelEvents, storage: StorageAdapter, concurrency?: number, deleteAfterStore?: boolean);
+    start(): void;
+    stop(): Promise<void>;
+    private pump;
+}
+export {};
+//# sourceMappingURL=storage-worker.d.ts.map

package/dist/services/storage-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-worker.d.ts","sourceRoot":"","sources":["../../src/services/storage-worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,KAAK,OAAO,GAAG;IAAE,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAAE,CAAC;AAEjD,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAG5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAZnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,eAAe,CAAqD;gBAGzD,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,cAAc,EACvB,WAAW,SAE3B,EACgB,gBAAgB,UACnB;IAGhB,KAAK;IAgBC,IAAI;IAmBV,OAAO,CAAC,IAAI;CAqDb"}

package/dist/services/storage-worker.js

@@ -0,0 +1,100 @@
+// storage-worker.ts
+import fs from "node:fs";
+import { dayFromCapturedAt } from "./day.js";
+export class StorageWorker {
+    ctx;
+    events;
+    storage;
+    concurrency;
+    deleteAfterStore;
+    running = false;
+    inFlight = 0;
+    queue = [];
+    onCapturedBound = null;
+    constructor(ctx, events, storage, concurrency = Number(process.env.STORAGE_CONCURRENCY ?? "2"), deleteAfterStore = (process.env.STORAGE_DELETE_LOCAL ??
+        "1") === "1") {
+        this.ctx = ctx;
+        this.events = events;
+        this.storage = storage;
+        this.concurrency = concurrency;
+        this.deleteAfterStore = deleteAfterStore;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.onCapturedBound = (e) => {
+            // cheap enqueue; never await here
+            this.queue.push(e);
+            this.pump();
+        };
+        this.events.on("snapshot:captured", this.onCapturedBound);
+        this.ctx.log(`[rtsp-tunnel] storage worker started storage=${this.storage.name} concurrency=${this.concurrency}`);
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.onCapturedBound) {
+            this.events.off("snapshot:captured", this.onCapturedBound);
+            this.onCapturedBound = null;
+        }
+        // wait a short window for in-flight tasks (best effort)
+        const start = Date.now();
+        while (this.inFlight > 0 && Date.now() - start < 5000) {
+            await new Promise((r) => setTimeout(r, 50));
+        }
+        this.queue = [];
+        this.ctx.log("[rtsp-tunnel] storage worker stopped");
+    }
+    pump() {
+        if (!this.running)
+            return;
+        while (this.inFlight < this.concurrency && this.queue.length > 0) {
+            const job = this.queue.shift();
+            this.inFlight++;
+            (async () => {
+                try {
+                    const day = dayFromCapturedAt(job.capturedAt, job.tzOffsetHours ?? null);
+                    const stored = await this.storage.store({
+                        localPath: job.localPath,
+                        deviceId: job.deviceId,
+                        payloadId: job.payloadId,
+                        capturedAt: job.capturedAt,
+                        day,
+                    });
+                    // delete local file by default (configurable), unless adapter says otherwise
+                    const shouldDelete = this.deleteAfterStore && (stored.deleteLocal ?? true);
+                    if (shouldDelete) {
+                        try {
+                            fs.unlinkSync(job.localPath);
+                        }
+                        catch { }
+                    }
+                    this.events.emitStored({
+                        ...job,
+                        storage: stored.storage,
+                        storedUri: stored.storedUri,
+                        day,
+                        tzOffsetHours: job.tzOffsetHours ?? null,
+                    });
+                }
+                catch (e) {
+                    this.events.emitFailed({
+                        sessionId: job.sessionId,
+                        deviceId: job.deviceId,
+                        payloadId: job.payloadId,
+                        remote: job.remote,
+                        stage: "store",
+                        error: e?.message ?? String(e),
+                    });
+                }
+                finally {
+                    this.inFlight--;
+                    this.pump();
+                }
+            })();
+        }
+    }
+}
+//# sourceMappingURL=storage-worker.js.map

package/dist/services/storage-worker.js.map

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

package/dist/services/storage.d.ts

@@ -0,0 +1,28 @@
+export type StoreInput = {
+    localPath: string;
+    deviceId: string;
+    payloadId: string | null;
+    capturedAt: string;
+    day?: string;
+};
+export type StoreResult = {
+    storage: string;
+    storedUri: string;
+    deleteLocal?: boolean;
+};
+export interface StorageAdapter {
+    name: string;
+    store(input: StoreInput): Promise<StoreResult>;
+}
+export declare class LocalStorageAdapter implements StorageAdapter {
+    name: string;
+    store(input: StoreInput): Promise<StoreResult>;
+}
+export declare class LocalMoveStorageAdapter implements StorageAdapter {
+    private readonly rootDir;
+    private readonly mode;
+    name: string;
+    constructor(rootDir: string, mode?: "copy" | "move");
+    store(input: StoreInput): Promise<StoreResult>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/services/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/services/storage.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChD;AAGD,qBAAa,mBAAoB,YAAW,cAAc;IACxD,IAAI,SAAW;IACT,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAOrD;AAGD,qBAAa,uBAAwB,YAAW,cAAc;IAG1D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,IAAI,SAAgB;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,MAAe;IAK3C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAiBrD"}

package/dist/services/storage.js

@@ -0,0 +1,41 @@
+// storage.ts
+import path from "node:path";
+import fs from "node:fs";
+// -------- Default: keep local file in place (no-op) --------
+export class LocalStorageAdapter {
+    name = "local";
+    async store(input) {
+        return {
+            storage: "local",
+            storedUri: `file://${input.localPath}`,
+            deleteLocal: false,
+        };
+    }
+}
+// -------- Optional: move/copy to a new root folder --------
+export class LocalMoveStorageAdapter {
+    rootDir;
+    mode;
+    name = "local-move";
+    constructor(rootDir, mode = "move") {
+        this.rootDir = rootDir;
+        this.mode = mode;
+        fs.mkdirSync(rootDir, { recursive: true });
+    }
+    async store(input) {
+        const safeDev = input.deviceId;
+        const sub = input.payloadId ? path.join(safeDev, input.payloadId) : safeDev;
+        const destDir = path.join(this.rootDir, sub);
+        fs.mkdirSync(destDir, { recursive: true });
+        const filename = path.basename(input.localPath);
+        const destPath = path.join(destDir, filename);
+        if (this.mode === "move") {
+            fs.renameSync(input.localPath, destPath);
+        }
+        else {
+            fs.copyFileSync(input.localPath, destPath);
+        }
+        return { storage: this.name, storedUri: `file://${destPath}` };
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/services/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/services/storage.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAqBzB,8DAA8D;AAC9D,MAAM,OAAO,mBAAmB;IAC9B,IAAI,GAAG,OAAO,CAAC;IACf,KAAK,CAAC,KAAK,CAAC,KAAiB;QAC3B,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,UAAU,KAAK,CAAC,SAAS,EAAE;YACtC,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,uBAAuB;IAGf;IACA;IAHnB,IAAI,GAAG,YAAY,CAAC;IACpB,YACmB,OAAe,EACf,OAAwB,MAAM;QAD9B,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAA0B;QAE/C,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAiB;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7C,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,QAAQ,EAAE,EAAE,CAAC;IACjE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@similie/hyphen-rtsp-tunnel",
+  "version": "1.1.0",
+  "description": "API module for Hyphen Command Center. Provides REST and WebSocket interfaces for managing RTSP streams and related services.",
+  "license": "MIT",
+  "author": "adam.smith@similie.org",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json -w",
+    "prepare": "pnpm run build",
+    "docs": "./node_modules/typedoc/bin/typedoc --out docs src",
+    "release": "npm run build && standard-version"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.958.0",
+    "@aws-sdk/client-sqs": "^3.958.0",
+    "@similie/ellipsies": "^1.0.16",
+    "@similie/hyphen-command-server-types": "^1.0.6",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.9.2",
+    "@types/ws": "^8.18.1",
+    "standard-version": "^9.5.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
+    "typedoc": "^0.28.14",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ]
+}