vidspotai-shared 1.0.19 → 1.0.22

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

@@ -45,7 +45,7 @@ export declare class FirestoreService {
     }) | undefined>;
     /** Get a user by ID (typed) */
     static getUserById(id: string): Promise<IUserModel | undefined>;
-    /** Get a user by ID (typed) */
+    /** Get a user by email (typed, first match) */
     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?: {

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

@@ -1 +1 @@
-{"version":3,"file":"firestore.service.d.ts","sourceRoot":"","sources":["../../src/services/firestore.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAEhB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAevD;;;;GAIG;AACH,qBAAa,gBAAgB;IAE3B,MAAM,CAAC,YAAY,oDAEqC;IAExD,MAAM,CAAC,QAAQ,gDAEqC;IAEpD,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;qBAEqC;IAItD,yCAAyC;WAC5B,eAAe,CAAC,CAAC,EAC5B,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,qDAAqD;WACxC,OAAO,CAAC,CAAC,EACpB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,0CAA0C;WAC7B,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAKlC,kCAAkC;WACrB,WAAW,CAAC,CAAC,EACxB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAO5C,+BAA+B;WAClB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIrE,+BAA+B;WAClB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAS3E,gCAAgC;WACnB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACnD,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;QAChC,cAAc,CAAC,EAAE,gBAAgB,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAsBlC,8CAA8C;WACjC,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAwB,GACrD,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B,0CAA0C;WAC7B,cAAc,CACzB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAIhB,sBAAsB;WACT,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC;CAIjB"}
+{"version":3,"file":"firestore.service.d.ts","sourceRoot":"","sources":["../../src/services/firestore.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAEhB,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAevD;;;;GAIG;AACH,qBAAa,gBAAgB;IAE3B,MAAM,CAAC,YAAY,oDAEqC;IAExD,MAAM,CAAC,QAAQ,gDAEqC;IAEpD,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;qBAEqC;IAItD,yCAAyC;WAC5B,eAAe,CAAC,CAAC,EAC5B,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,qDAAqD;WACxC,OAAO,CAAC,CAAC,EACpB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,0CAA0C;WAC7B,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAKlC,kCAAkC;WACrB,WAAW,CAAC,CAAC,EACxB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAO5C,+BAA+B;WAClB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIrE,+CAA+C;WAClC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAS3E,gCAAgC;WACnB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACnD,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;QAChC,cAAc,CAAC,EAAE,gBAAgB,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAsBlC,8CAA8C;WACjC,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAwB,GACrD,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B,0CAA0C;WAC7B,cAAc,CACzB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAIhB,sBAAsB;WACT,UAAU,CAAC,CAAC,EACvB,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC;CAIjB"}

package/lib/services/firestore.service.js

@@ -50,7 +50,7 @@ class FirestoreService {
     static async getUserById(id) {
         return this.getDataById(this.usersCol, id);
     }
-    /** Get a user by ID (typed) */
+    /** Get a user by email (typed, first match) */
     static async getUserByEmail(email) {
         return this.getDataByKeyField(this.usersCol, "email", "==", email).then((users) => users[0]);
     }

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

@@ -0,0 +1,5 @@
+export declare abstract class GCPService {
+    protected auth: any;
+    constructor();
+}
+//# sourceMappingURL=gcp.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gcp.service.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/gcp.service.ts"],"names":[],"mappings":"AAEA,8BAAsB,UAAU;IAC9B,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;;CAarB"}

package/lib/services/gcp/gcp.service.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GCPService = void 0;
+const googleapis_1 = require("googleapis");
+class GCPService {
+    constructor() {
+        if (!process.env.GOOGLE_CLIENT_EMAIL || !process.env.GOOGLE_PRIVATE_KEY) {
+            throw new Error("Missing GCP credentials");
+        }
+        this.auth = new googleapis_1.google.auth.JWT({
+            email: process.env.GOOGLE_CLIENT_EMAIL,
+            key: process.env.GOOGLE_PRIVATE_KEY.replace(/\\n/g, "\n"),
+            scopes: ["https://www.googleapis.com/auth/spreadsheets"],
+        });
+    }
+}
+exports.GCPService = GCPService;

package/lib/services/gcp/gsheet.service.d.ts

@@ -0,0 +1,16 @@
+import { GCPService } from "./gcp.service";
+import { GSheetAppendWithSchemaParams } from "./types";
+export declare class GSheetService extends GCPService {
+    private sheets;
+    constructor();
+    /**
+     * Append rows with automatic header + schema evolution support
+     */
+    appendRowsWithSchema<T extends Record<string, any>>(params: GSheetAppendWithSchemaParams<T>): Promise<void>;
+    private getHeader;
+    private writeHeader;
+    private mergeHeaders;
+    private ensureSheetExists;
+    private columnLetter;
+}
+//# sourceMappingURL=gsheet.service.d.ts.map

package/lib/services/gcp/gsheet.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsheet.service.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/gsheet.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,MAAM,CAAmB;;IAWjC;;OAEG;IACG,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;YAsDF,SAAS;YAYT,WAAW;IAezB,OAAO,CAAC,YAAY;YAMN,iBAAiB;IA4B/B,OAAO,CAAC,YAAY;CASrB"}

package/lib/services/gcp/gsheet.service.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GSheetService = void 0;
+const googleapis_1 = require("googleapis");
+const gcp_service_1 = require("./gcp.service");
+class GSheetService extends gcp_service_1.GCPService {
+    constructor() {
+        super();
+        this.sheets = googleapis_1.google.sheets({
+            version: "v4",
+            auth: this.auth,
+        });
+    }
+    /**
+     * Append rows with automatic header + schema evolution support
+     */
+    async appendRowsWithSchema(params) {
+        const { spreadsheetId, sheetName, header, rows, valueInputOption = "USER_ENTERED", } = params;
+        if (!rows || rows.length === 0) {
+            return;
+        }
+        // 1. Ensure sheet exists
+        await this.ensureSheetExists(spreadsheetId, sheetName);
+        // 2. Read existing header (row 1)
+        const existingHeader = await this.getHeader(spreadsheetId, sheetName);
+        // 3. Derive incoming header from rows if not explicitly provided
+        const incomingHeader = header
+            ? header.map(String)
+            : Array.from(new Set(rows.flatMap((row) => Object.keys(row))));
+        // 4. Merge headers (schema evolution)
+        const finalHeader = this.mergeHeaders(existingHeader, incomingHeader);
+        // 5. Write header if needed
+        if (existingHeader.length === 0 ||
+            finalHeader.length !== existingHeader.length) {
+            await this.writeHeader(spreadsheetId, sheetName, finalHeader);
+        }
+        // 6. Align rows to final header
+        const values = rows.map((row) => finalHeader.map((col) => (row[col] !== undefined ? row[col] : "")));
+        // 7. Append rows
+        await this.sheets.spreadsheets.values.append({
+            spreadsheetId,
+            range: `${sheetName}!A:${this.columnLetter(finalHeader.length)}`,
+            valueInputOption,
+            insertDataOption: "INSERT_ROWS",
+            requestBody: { values },
+        });
+    }
+    // ----------------------
+    // Helper Methods
+    // ----------------------
+    async getHeader(spreadsheetId, sheetName) {
+        const res = await this.sheets.spreadsheets.values.get({
+            spreadsheetId,
+            range: `${sheetName}!1:1`,
+        });
+        return res.data.values?.[0] ?? [];
+    }
+    async writeHeader(spreadsheetId, sheetName, header) {
+        await this.sheets.spreadsheets.values.update({
+            spreadsheetId,
+            range: `${sheetName}!1:1`,
+            valueInputOption: "RAW",
+            requestBody: {
+                values: [header],
+            },
+        });
+    }
+    mergeHeaders(existing, incoming) {
+        const set = new Set(existing);
+        incoming.forEach((col) => set.add(col));
+        return Array.from(set);
+    }
+    async ensureSheetExists(spreadsheetId, sheetName) {
+        const meta = await this.sheets.spreadsheets.get({
+            spreadsheetId,
+        });
+        const exists = meta.data.sheets?.some((s) => s.properties?.title === sheetName);
+        if (exists)
+            return;
+        await this.sheets.spreadsheets.batchUpdate({
+            spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        addSheet: {
+                            properties: { title: sheetName },
+                        },
+                    },
+                ],
+            },
+        });
+    }
+    columnLetter(colCount) {
+        let letter = "";
+        while (colCount > 0) {
+            const mod = (colCount - 1) % 26;
+            letter = String.fromCharCode(65 + mod) + letter;
+            colCount = Math.floor((colCount - 1) / 26);
+        }
+        return letter;
+    }
+}
+exports.GSheetService = GSheetService;

package/lib/services/gcp/index.d.ts

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

package/lib/services/gcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/lib/services/gcp/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("./gcp.service"), exports);
+__exportStar(require("./gsheet.service"), exports);

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

@@ -0,0 +1,18 @@
+export type GSheetAppendWithSchemaParams<T extends Record<string, any>> = {
+    spreadsheetId: string;
+    sheetName: string;
+    /**
+     * Optional header definition (schema)
+     * Order matters for display, not for compatibility
+     */
+    header?: (keyof T)[];
+    /**
+     * Rows as objects (schema-aware)
+     */
+    rows: T[];
+    /**
+     * Defaults to USER_ENTERED
+     */
+    valueInputOption?: "RAW" | "USER_ENTERED";
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,4BAA4B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,CAAC,EAAE,CAAC;IAEV;;OAEG;IACH,gBAAgB,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;CAC3C,CAAC"}

package/lib/services/gcp/types.js

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

package/lib/services/index.d.ts

@@ -2,4 +2,5 @@ export * from "./redis.service";
 export * from "./firestore.service";
 export * from "./aiGen";
 export * from "./bullmq.service";
+export * from "./gcp";
 //# sourceMappingURL=index.d.ts.map

package/lib/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC"}

package/lib/services/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./redis.service"), exports);
 __exportStar(require("./firestore.service"), exports);
 __exportStar(require("./aiGen"), exports);
 __exportStar(require("./bullmq.service"), exports);
+__exportStar(require("./gcp"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidspotai-shared",
-  "version": "1.0.19",
+  "version": "1.0.22",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "exports": {
@@ -21,6 +21,7 @@
     "bullmq": "^5.61.0",
     "firebase-admin": "^13.5.0",
     "fs-extra": "^11.3.2",
+    "googleapis": "^170.0.0",
     "ioredis": "^5.8.0",
     "jsonwebtoken": "^9.0.2",
     "openai": "^6.1.0",