vidspotai-shared 1.0.0

package/lib/services/aiGen/providers/openai/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./openai.service"), exports);

package/lib/services/aiGen/providers/openai/openai.service.d.ts

@@ -0,0 +1,12 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, TextGenerationParams, TextGenerationResult, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
+export declare class OpenaiService extends BaseAiGenProviderService {
+    private readonly apiVersion;
+    private client;
+    constructor();
+    generateVideo(params: VideoGenerationParams): Promise<VideoGenerationResult>;
+    checkVideoStatus({ task, outputFilename, outputFilePath, }: VideoStatusParams): Promise<VideoStatusResult | null>;
+    generateText(params: TextGenerationParams): Promise<TextGenerationResult>;
+    getCreditUsed({ modelKey, duration }: CreditUsageParams): number;
+}
+//# sourceMappingURL=openai.service.d.ts.map

package/lib/services/aiGen/providers/openai/openai.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/openai/openai.service.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,MAAM,CAAS;;IAQjB,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAoB3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAwClD,YAAY,CAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IA4BhC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,EAAE,iBAAiB,GAAG,MAAM;CAMrE"}

package/lib/services/aiGen/providers/openai/openai.service.js

@@ -0,0 +1,97 @@
+"use strict";
+// openai.service.ts
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenaiService = void 0;
+const openai_1 = __importDefault(require("openai"));
+const aiModels_1 = require("../../../../globals/aiModels");
+const types_1 = require("../../../../globals/types");
+const helpers_1 = require("../../helpers");
+const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+const utils_1 = require("../../../../utils");
+const firebase_1 = require("../../../../libs/firebase");
+class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
+    constructor() {
+        super();
+        this.apiVersion = "preview";
+        this.client = new openai_1.default({ apiKey: process.env.OPENAI_API_KEY });
+    }
+    async generateVideo(params) {
+        (0, helpers_1.validateParams)(params);
+        const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId || "sora-2";
+        const job = await this.client.videos.create({
+            prompt: params.prompt || "",
+            model: modelId,
+            seconds: params.duration?.toString() || "4",
+            size: params.dimensions || "720x1280",
+        });
+        if (job.status === "failed") {
+            throw new Error(`OpenAI video generation failed: ${JSON.stringify(job.error)}`);
+        }
+        return { task: job.id, status: types_1.EVideoJobStatus.TRIGGERED };
+    }
+    async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
+        // Get job info from OpenAI
+        const job = await this.client.videos.retrieve(task);
+        if (job.status === "completed") {
+            // Download video content from OpenAI
+            const response = await this.client.videos.downloadContent(task);
+            const blob = await response.blob();
+            const buffer = Buffer.from(await blob.arrayBuffer());
+            // Upload to Firebase Storage
+            const filePath = `${outputFilePath}/${outputFilename}.mp4`;
+            const file = (0, firebase_1.getBucket)().file(filePath);
+            await file.save(buffer, { contentType: "video/mp4" });
+            // Generate a signed URL
+            const [signedUrl] = await file.getSignedUrl({
+                action: "read",
+                expires: "03-09-2491",
+            });
+            return {
+                status: types_1.EVideoJobStatus.COMPLETED,
+                videoUrl: signedUrl,
+            };
+        }
+        if (job.status === "failed") {
+            return {
+                status: types_1.EVideoJobStatus.FAILED,
+                errorMessage: job.error
+                    ? `${job.error.code}: ${job.error.message}`
+                    : "Unknown error",
+            };
+        }
+        return { status: types_1.EVideoJobStatus.PENDING };
+    }
+    async generateText(params) {
+        const { input, modelKey, options } = params;
+        const model = aiModels_1.aiModelConfigs[modelKey]?.modelId || "gpt-4o-mini";
+        let parsedInput = [];
+        if (typeof input === "string") {
+            parsedInput = [
+                { role: "user", content: input },
+            ];
+        }
+        else {
+            parsedInput = input;
+        }
+        const completion = await this.client.chat.completions.create({
+            model,
+            messages: parsedInput,
+            temperature: options?.temperature || 0.7,
+            response_format: options?.responseFormat || { type: "text" },
+        });
+        const text = completion.choices?.[0]?.message?.content?.trim() || "No response";
+        return {
+            text,
+        };
+    }
+    getCreditUsed({ modelKey, duration = 5 }) {
+        const modelConfig = aiModels_1.aiModelConfigs[modelKey];
+        return modelConfig?.cost?.perSecond
+            ? (0, utils_1.getCreditsFromCost)(modelConfig?.cost?.perSecond * duration)
+            : 0;
+    }
+}
+exports.OpenaiService = OpenaiService;

package/lib/services/aiGen/providers/runway/dtypes.d.ts

@@ -0,0 +1,14 @@
+declare const TGEN4_TURBO_RATIOS: readonly ["1280:720", "1584:672", "1104:832", "720:1280", "832:1104", "960:960"];
+export type Gen4TurboRatio = (typeof TGEN4_TURBO_RATIOS)[number];
+export declare const GEN4_TURBO_RATIOS: string[];
+export declare const TGEN4_TURBO_DURATIONS: readonly [5, 8, 10];
+export type Gen4TurboDuration = (typeof TGEN4_TURBO_DURATIONS)[number];
+export declare const GEN4_TURBO_DURATIONS: number[];
+declare const TGEN4_ALEPH_RATIOS: readonly ["1280:720", "720:1280", "1104:832", "960:960", "832:1104", "1584:672", "848:480", "640:480"];
+export type Gen4AlephRatio = (typeof TGEN4_ALEPH_RATIOS)[number];
+export declare const GEN4_ALEPH_RATIOS: string[];
+export declare const TGEN4_ALEPH_DURATIONS: readonly [5];
+export type Gen4AlephDuration = (typeof TGEN4_ALEPH_DURATIONS)[number];
+export declare const GEN4_ALEPH_DURATIONS: number[];
+export {};
+//# sourceMappingURL=dtypes.d.ts.map

package/lib/services/aiGen/providers/runway/dtypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtypes.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/dtypes.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,kBAAkB,kFAOd,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAA4B,CAAC;AAEnE,eAAO,MAAM,qBAAqB,qBAAsB,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAA+B,CAAC;AAEzE,QAAA,MAAM,kBAAkB,wGASd,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAA4B,CAAC;AAEnE,eAAO,MAAM,qBAAqB,cAAe,CAAC;AAClD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAA+B,CAAC"}

package/lib/services/aiGen/providers/runway/dtypes.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEN4_ALEPH_DURATIONS = exports.TGEN4_ALEPH_DURATIONS = exports.GEN4_ALEPH_RATIOS = exports.GEN4_TURBO_DURATIONS = exports.TGEN4_TURBO_DURATIONS = exports.GEN4_TURBO_RATIOS = void 0;
+const TGEN4_TURBO_RATIOS = [
+    "1280:720", // default
+    "1584:672",
+    "1104:832",
+    "720:1280",
+    "832:1104",
+    "960:960",
+];
+exports.GEN4_TURBO_RATIOS = [...TGEN4_TURBO_RATIOS];
+exports.TGEN4_TURBO_DURATIONS = [5, 8, 10];
+exports.GEN4_TURBO_DURATIONS = [...exports.TGEN4_TURBO_DURATIONS];
+const TGEN4_ALEPH_RATIOS = [
+    "1280:720", // default
+    "720:1280",
+    "1104:832",
+    "960:960",
+    "832:1104",
+    "1584:672",
+    "848:480",
+    "640:480",
+];
+exports.GEN4_ALEPH_RATIOS = [...TGEN4_ALEPH_RATIOS];
+exports.TGEN4_ALEPH_DURATIONS = [5];
+exports.GEN4_ALEPH_DURATIONS = [...exports.TGEN4_ALEPH_DURATIONS];

package/lib/services/aiGen/providers/runway/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./runway.service";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/aiGen/providers/runway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/lib/services/aiGen/providers/runway/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./runway.service"), exports);
+__exportStar(require("./types"), exports);

package/lib/services/aiGen/providers/runway/runway.service.d.ts

@@ -0,0 +1,12 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
+export declare class RunwayService extends BaseAiGenProviderService {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor();
+    private request;
+    generateVideo(params: VideoGenerationParams): Promise<VideoGenerationResult>;
+    checkVideoStatus({ task, outputFilename, outputFilePath, }: VideoStatusParams): Promise<VideoStatusResult | null>;
+    getCreditUsed({ modelKey, duration }: CreditUsageParams): number;
+}
+//# sourceMappingURL=runway.service.d.ts.map

package/lib/services/aiGen/providers/runway/runway.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/runway.service.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IA+Bf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA+C3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA4DxD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,EAAE,iBAAiB,GAAG,MAAM;CAIrE"}

package/lib/services/aiGen/providers/runway/runway.service.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunwayService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const aiModels_1 = require("../../../../globals/aiModels");
+const helpers_1 = require("../../../../utils/helpers");
+const firebase_1 = require("../../../../libs/firebase");
+const helpers_2 = require("../../helpers");
+const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+const types_1 = require("../../../../globals/types");
+class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
+    constructor() {
+        super();
+        this.baseUrl = "https://api.runwayml.com/v1";
+        if (!process.env.RUNWAYML_API_SECRET) {
+            throw new Error("Missing RUNWAYML_API_SECRET in environment variables");
+        }
+        this.apiKey = process.env.RUNWAYML_API_SECRET;
+    }
+    async request(endpoint, method, body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+        const response = await (0, axios_1.default)({
+            url,
+            method,
+            headers,
+            data: body,
+            timeout: 180000, // 3 minutes
+            validateStatus: () => true, // manually handle status
+        });
+        if (response.status < 200 || response.status >= 300) {
+            throw new Error(`Runway API Error: ${response.status} ${response.statusText} - ${JSON.stringify(response.data)}`);
+        }
+        return response.data;
+    }
+    async generateVideo(params) {
+        (0, helpers_2.validateParams)(params);
+        const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId;
+        if (!modelId)
+            throw new Error(`Unknown modelKey: ${params.modelKey}`);
+        let run;
+        // IMAGE → VIDEO
+        if (modelId === "gen4_turbo") {
+            const body = {
+                model: "gen4_turbo",
+                promptText: params.prompt,
+                promptImage: [{ uri: params.inputImageUrl, position: "first" }],
+                ratio: params.aspectRatio,
+                duration: params.duration,
+            };
+            run = await this.request("/image-to-video", "POST", body);
+        }
+        // VIDEO → VIDEO
+        else if (modelId === "gen4_aleph") {
+            const body = {
+                model: "gen4_aleph",
+                promptText: params.prompt,
+                videoUri: params.inputVideoUrl,
+                ratio: params.aspectRatio,
+            };
+            run = await this.request("/video-to-video", "POST", body);
+        }
+        else {
+            throw new Error(`Invalid params: Model ${params.modelKey} does not support this generation type`);
+        }
+        return { task: run.id, status: types_1.EVideoJobStatus.PENDING };
+    }
+    async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
+        const result = await this.request(`/tasks/${task}`, "GET");
+        if (result.status === "SUCCEEDED" && result.output?.length) {
+            const videoUri = result.output[0];
+            if (!videoUri) {
+                return {
+                    status: types_1.EVideoJobStatus.FAILED,
+                    errorMessage: "No video returned from Runway API",
+                };
+            }
+            // Download the video as binary data
+            const videoResp = await axios_1.default.get(videoUri, {
+                responseType: "arraybuffer",
+                timeout: 180000,
+            });
+            if (videoResp.status !== 200) {
+                return {
+                    status: types_1.EVideoJobStatus.FAILED,
+                    errorMessage: `Failed to download video: ${videoResp.status}`,
+                };
+            }
+            const buffer = Buffer.from(videoResp.data);
+            const filePath = `${outputFilePath}/${outputFilename}.mp4`;
+            const file = (0, firebase_1.getBucket)().file(filePath);
+            await file.save(buffer, { contentType: "video/mp4" });
+            const [signedUrl] = await file.getSignedUrl({
+                action: "read",
+                expires: "03-09-2491",
+            });
+            return {
+                videoUrl: signedUrl,
+                status: types_1.EVideoJobStatus.COMPLETED,
+            };
+        }
+        if (result.status === "FAILED" || result.status === "CANCELLED") {
+            return {
+                status: types_1.EVideoJobStatus.FAILED,
+                errorMessage: `Failure: ${result.failure || "unknown"} Code: ${result.failureCode || "unknown"}`,
+            };
+        }
+        // Still processing
+        return { status: types_1.EVideoJobStatus.PENDING };
+    }
+    getCreditUsed({ modelKey, duration = 5 }) {
+        const modelConfig = aiModels_1.aiModelConfigs[modelKey];
+        return (0, helpers_1.getCreditsFromCost)(modelConfig.cost?.perSecond ?? duration);
+    }
+}
+exports.RunwayService = RunwayService;

package/lib/services/aiGen/providers/runway/types.d.ts

@@ -0,0 +1,14 @@
+declare const TGEN4_TURBO_RATIOS: readonly ["1280:720", "1584:672", "1104:832", "720:1280", "832:1104", "960:960"];
+export type Gen4TurboRatio = (typeof TGEN4_TURBO_RATIOS)[number];
+export declare const GEN4_TURBO_RATIOS: string[];
+export declare const TGEN4_TURBO_DURATIONS: readonly [5, 8, 10];
+export type Gen4TurboDuration = (typeof TGEN4_TURBO_DURATIONS)[number];
+export declare const GEN4_TURBO_DURATIONS: number[];
+declare const TGEN4_ALEPH_RATIOS: readonly ["1280:720", "720:1280", "1104:832", "960:960", "832:1104", "1584:672", "848:480", "640:480"];
+export type Gen4AlephRatio = (typeof TGEN4_ALEPH_RATIOS)[number];
+export declare const GEN4_ALEPH_RATIOS: string[];
+export declare const TGEN4_ALEPH_DURATIONS: readonly [5];
+export type Gen4AlephDuration = (typeof TGEN4_ALEPH_DURATIONS)[number];
+export declare const GEN4_ALEPH_DURATIONS: number[];
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/services/aiGen/providers/runway/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/types.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,kBAAkB,kFAOd,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAA4B,CAAC;AAEnE,eAAO,MAAM,qBAAqB,qBAAsB,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAA+B,CAAC;AAEzE,QAAA,MAAM,kBAAkB,wGASd,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAA4B,CAAC;AAEnE,eAAO,MAAM,qBAAqB,cAAe,CAAC;AAClD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAA+B,CAAC"}

package/lib/services/aiGen/providers/runway/types.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEN4_ALEPH_DURATIONS = exports.TGEN4_ALEPH_DURATIONS = exports.GEN4_ALEPH_RATIOS = exports.GEN4_TURBO_DURATIONS = exports.TGEN4_TURBO_DURATIONS = exports.GEN4_TURBO_RATIOS = void 0;
+const TGEN4_TURBO_RATIOS = [
+    "1280:720", // default
+    "1584:672",
+    "1104:832",
+    "720:1280",
+    "832:1104",
+    "960:960",
+];
+exports.GEN4_TURBO_RATIOS = [...TGEN4_TURBO_RATIOS];
+exports.TGEN4_TURBO_DURATIONS = [5, 8, 10];
+exports.GEN4_TURBO_DURATIONS = [...exports.TGEN4_TURBO_DURATIONS];
+const TGEN4_ALEPH_RATIOS = [
+    "1280:720", // default
+    "720:1280",
+    "1104:832",
+    "960:960",
+    "832:1104",
+    "1584:672",
+    "848:480",
+    "640:480",
+];
+exports.GEN4_ALEPH_RATIOS = [...TGEN4_ALEPH_RATIOS];
+exports.TGEN4_ALEPH_DURATIONS = [5];
+exports.GEN4_ALEPH_DURATIONS = [...exports.TGEN4_ALEPH_DURATIONS];

package/lib/services/aiGen/providers/types.d.ts

@@ -0,0 +1,49 @@
+import { ChatCompletionMessageParam } from "openai/resources/index";
+import { ETextGenModels, EVideoGenModels } from "../../../globals/aiModels";
+import { EVideoJobStatus, TVideoJobTask } from "../../../globals/types";
+import { EVideoMode } from "../types";
+export interface VideoGenerationParams {
+    prompt?: string;
+    modelKey: EVideoGenModels;
+    resolution?: string;
+    aspectRatio?: string;
+    dimensions?: string;
+    duration?: number;
+    inputVideoUrl?: string;
+    inputImageUrl?: string;
+    mode?: EVideoMode;
+}
+export interface VideoGenerationResult {
+    status: EVideoJobStatus;
+    task?: TVideoJobTask;
+}
+export interface VideoStatusResult {
+    status: EVideoJobStatus;
+    videoUrl?: string;
+    errorMessage?: string;
+}
+export interface VideoStatusParams {
+    task: TVideoJobTask;
+    modelKey: EVideoGenModels;
+    outputFilename: string;
+    outputFilePath?: string;
+}
+export interface TextGenerationParams {
+    input: ChatCompletionMessageParam[] | string;
+    modelKey: ETextGenModels;
+    options?: Record<string, any>;
+}
+export interface TextGenerationResult {
+    text: string;
+}
+export interface CreditUsageParams {
+    modelKey: EVideoGenModels | ETextGenModels;
+    mode?: EVideoMode;
+    duration?: number;
+    resolution?: string;
+    dimensions?: string;
+    aspectRatio?: string;
+    inputType?: "text" | "image" | "video";
+    outputType?: "text" | "image" | "video";
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/services/aiGen/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/aiGen/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAC;IAExB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CAEvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CAMzB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,0BAA0B,EAAE,GAAG,MAAM,CAAC;IAC7C,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;CACzC"}

package/lib/services/aiGen/providers/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/services/aiGen/types.d.ts

@@ -0,0 +1,5 @@
+export declare enum EVideoMode {
+    STANDARD = "std",
+    PROFESSIONAL = "pro"
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/services/aiGen/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/aiGen/types.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,QAAQ,QAAQ;IAChB,YAAY,QAAQ;CACrB"}

package/lib/services/aiGen/types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVideoMode = void 0;
+var EVideoMode;
+(function (EVideoMode) {
+    EVideoMode["STANDARD"] = "std";
+    EVideoMode["PROFESSIONAL"] = "pro";
+})(EVideoMode || (exports.EVideoMode = EVideoMode = {}));

package/lib/services/firestore.service.d.ts

@@ -0,0 +1,66 @@
+import admin from "firebase-admin";
+import { DocumentData, WhereFilterOp, OrderByDirection } from "@google-cloud/firestore";
+import { CollectionReference, DocumentReference } from "firebase-admin/firestore";
+import { IUserModel } from "../models/user.model";
+import { IVideoJobModel } from "../models/video.model";
+import { DeepPartial } from "../globals/types";
+/**
+ * FirestoreService
+ * ----------------
+ * Centralized Firestore access with typed collections & static CRUD utilities.
+ */
+export declare class FirestoreService {
+    static videoJobsCol: admin.firestore.CollectionReference<IVideoJobModel, admin.firestore.DocumentData>;
+    static usersCol: admin.firestore.CollectionReference<IUserModel, admin.firestore.DocumentData>;
+    static scriptsCol: admin.firestore.CollectionReference<{
+        userId: string;
+        prompt: string;
+        durationType: import("../globals/types").EVideoDurationType;
+        videoModelKey: import("..").EVideoGenModels;
+        createdAt: Date;
+        updatedAt: Date;
+    } & {
+        summary: string;
+        scenes: {
+            sceneIndex: number;
+            duration: number;
+            videoPrompt: string;
+            description: string;
+            dialogue: string;
+        }[];
+    }, admin.firestore.DocumentData>;
+    /** Add new document with generated ID */
+    static appendNewRecord<T>(collectionRef: CollectionReference<T>, data: T): Promise<DocumentReference<T>>;
+    /** Add or overwrite a document with a specific ID */
+    static addData<T>(collectionRef: CollectionReference<T>, id: string, data: T): Promise<DocumentReference<T>>;
+    /** Get all documents from a collection */
+    static getAllData<T>(collectionRef: CollectionReference<T>): Promise<(T & {
+        id: string;
+    })[]>;
+    /** Get a single document by ID */
+    static getDataById<T>(collectionRef: CollectionReference<T>, id: string): Promise<(T & {
+        id: string;
+    }) | undefined>;
+    /** Get a user by ID (typed) */
+    static getUserById(id: string): Promise<IUserModel | undefined>;
+    /** Get a user by ID (typed) */
+    static getUserByEmail(email: string): Promise<IUserModel | undefined>;
+    /** Query collection by field */
+    static getDataByKeyField<T extends DocumentData>(collectionRef: CollectionReference<T>, fieldName: string, operator: WhereFilterOp, value: any, options?: {
+        orderByField?: keyof T | string;
+        orderDirection?: OrderByDirection;
+        limit?: number;
+    }): Promise<(T & {
+        id: string;
+    })[]>;
+    /** Update document fields (partial update) */
+    static updateData<T>(collectionRef: CollectionReference<T>, id: string, newFieldRecord: DeepPartial<T>, options?: {
+        deepMerge?: boolean;
+    }): Promise<void>;
+    private static flattenObject;
+    /** Update user document (typed helper) */
+    static updateUserData(id: string, newFieldRecord: Partial<IUserModel>): Promise<void>;
+    /** Delete document */
+    static deleteData<T>(collectionRef: CollectionReference<T>, id: string): Promise<void>;
+}
+//# sourceMappingURL=firestore.service.d.ts.map

package/lib/services/firestore.service.d.ts.map

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