crewly 1.20.28 → 1.20.30

package/dist/backend/backend/src/controllers/canva/canva.controller.js

@@ -0,0 +1,183 @@
+/**
+ * Canva controller — `/api/canva/*` on this instance.
+ *
+ * Grant management goes through Cloud (status / connect-url / disconnect);
+ * designs, exports and assets go straight to api.canva.com with the token
+ * Cloud mints. Backs the canva-* skills.
+ *
+ * @module controllers/canva/canva.controller
+ */
+import { CANVA_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../../services/core/logger.service.js';
+import { CanvaTokenService, CanvaError } from '../../services/canva/canva-token.service.js';
+import { CanvaService } from '../../services/canva/canva.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('CanvaController');
+let deps = null;
+function getDeps() {
+    if (!deps) {
+        const tokens = CanvaTokenService.getInstance();
+        deps = { tokens, canva: new CanvaService({ tokens }) };
+    }
+    return deps;
+}
+/**
+ * Replace the dependency set (tests).
+ *
+ * @param next - Deps or null to rebuild lazily
+ */
+export function setCanvaControllerDeps(next) {
+    deps = next;
+}
+function resolveReturnUrl(req) {
+    const explicit = typeof req.query.returnUrl === 'string' ? req.query.returnUrl : '';
+    if (/^https?:\/\//i.test(explicit))
+        return explicit;
+    return `${req.protocol}://${req.get('host')}${CANVA_CONSTANTS.SETTINGS_RETURN_PATH}`;
+}
+function connectUrlOrNull(req) {
+    try {
+        return getDeps().tokens.buildConnectUrl(resolveReturnUrl(req));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Answer a failure with `{ success:false, error, message, hint }`.
+ *
+ * @param req - Request (for the connect URL hint)
+ * @param res - Response
+ * @param err - The failure
+ */
+export function sendCanvaError(req, res, err) {
+    const CODES = CANVA_CONSTANTS.ERROR_CODES;
+    if (err instanceof CanvaError) {
+        let hint;
+        switch (err.code) {
+            case CODES.NOT_CONNECTED:
+                hint = connectUrlOrNull(req) ?? 'Sign in to Crewly Cloud (Settings → Cloud), then connect Canva under Settings → Integrations.';
+                break;
+            case CODES.NOT_LOGGED_IN:
+                hint = 'Sign in to Crewly Cloud first (Settings → Cloud).';
+                break;
+            case CODES.NOT_CONFIGURED:
+                hint = 'Crewly Cloud is not configured for Canva; nothing to do on this instance.';
+                break;
+            case CODES.VALIDATION:
+                hint = 'Fix the request and retry.';
+                break;
+            default:
+                hint = err.status === 401 ? 'The Canva token was rejected; retry once — the cache has been cleared.' : 'Canva or Crewly Cloud failed; retry later.';
+        }
+        res.status(err.status).json({ success: false, error: err.code, message: err.message, hint });
+        return;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    logger.error('Unexpected Canva failure', { error: message });
+    res.status(500).json({ success: false, error: 'internal', message, hint: 'Check the backend log.' });
+}
+function q(req, name) {
+    const v = req.query[name];
+    return typeof v === 'string' ? v.trim() : '';
+}
+function qInt(req, name) {
+    const v = q(req, name);
+    return v ? Number.parseInt(v, 10) : undefined;
+}
+/** GET /api/canva/status */
+export async function getStatus(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().tokens.status() });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** GET /api/canva/connect-url — `{ url }` to open in the browser. */
+export async function getConnectUrl(req, res) {
+    try {
+        res.json({ success: true, data: { url: getDeps().tokens.buildConnectUrl(resolveReturnUrl(req)) } });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** DELETE /api/canva/disconnect */
+export async function disconnect(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().tokens.disconnect() });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** GET /api/canva/designs?q=&ownership=&sort=&limit=&continuation= */
+export async function listDesigns(req, res) {
+    try {
+        const ownership = q(req, 'ownership');
+        const sort = q(req, 'sort');
+        const out = await getDeps().canva.listDesigns({
+            query: q(req, 'q') || undefined,
+            ownership: ownership === 'owned' || ownership === 'shared' || ownership === 'any' ? ownership : undefined,
+            sortBy: ['relevance', 'modified_descending', 'modified_ascending', 'title_descending', 'title_ascending'].find((s) => s === sort),
+            limit: qInt(req, 'limit'),
+            continuation: q(req, 'continuation') || undefined,
+        });
+        res.json({ success: true, data: { count: out.designs.length, designs: out.designs, ...(out.continuation ? { continuation: out.continuation } : {}) } });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** GET /api/canva/designs/:id */
+export async function getDesign(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().canva.getDesign(String(req.params.id ?? '')) });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** POST /api/canva/designs — `{ title?, preset?, width?, height?, assetId? }` */
+export async function createDesign(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const design = await getDeps().canva.createDesign({ title: body.title, preset: body.preset, width: body.width, height: body.height, assetId: body.assetId });
+        logger.info('Canva design created', { id: design.id, title: design.title });
+        res.json({ success: true, data: design });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** POST /api/canva/designs/:id/export — `{ format, quality?, videoQuality?, pages? }` */
+export async function exportDesign(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const out = await getDeps().canva.exportDesign({
+            designId: String(req.params.id ?? ''),
+            format: String(body.format ?? ''),
+            quality: body.quality,
+            videoQuality: body.videoQuality,
+            pages: Array.isArray(body.pages) ? body.pages : undefined,
+        });
+        res.json({ success: out.status === 'success', data: out });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+/** POST /api/canva/assets — `{ name, content (base64) }` */
+export async function uploadAsset(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const bytes = typeof body.content === 'string' ? Buffer.from(body.content, 'base64') : Buffer.alloc(0);
+        const asset = await getDeps().canva.uploadAsset(String(body.name ?? ''), bytes);
+        logger.info('Canva asset uploaded', { id: asset.id, name: asset.name, bytes: bytes.length });
+        res.json({ success: true, data: asset });
+    }
+    catch (err) {
+        sendCanvaError(req, res, err);
+    }
+}
+//# sourceMappingURL=canva.controller.js.map

package/dist/backend/backend/src/controllers/canva/canva.controller.js.map

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

package/dist/backend/backend/src/controllers/canva/canva.routes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Canva routes — mounted at `/api/canva`.
+ *
+ * - GET    /status               — grant status
+ * - GET    /connect-url          — Cloud consent-start URL
+ * - DELETE /disconnect           — revoke + forget
+ * - GET    /designs              — ?q=&ownership=&sort=&limit=&continuation=
+ * - GET    /designs/:id          — one design
+ * - POST   /designs              — { title?, preset?, width?, height?, assetId? }
+ * - POST   /designs/:id/export   — { format, quality?, videoQuality?, pages? }
+ * - POST   /assets               — { name, content: base64 }
+ *
+ * @module controllers/canva/canva.routes
+ */
+import { Router } from 'express';
+/**
+ * Creates the Canva router.
+ *
+ * @returns Express router
+ */
+export declare function createCanvaRouter(): Router;
+//# sourceMappingURL=canva.routes.d.ts.map

package/dist/backend/backend/src/controllers/canva/canva.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canva.routes.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/canva/canva.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C"}

package/dist/backend/backend/src/controllers/canva/canva.routes.js

@@ -0,0 +1,34 @@
+/**
+ * Canva routes — mounted at `/api/canva`.
+ *
+ * - GET    /status               — grant status
+ * - GET    /connect-url          — Cloud consent-start URL
+ * - DELETE /disconnect           — revoke + forget
+ * - GET    /designs              — ?q=&ownership=&sort=&limit=&continuation=
+ * - GET    /designs/:id          — one design
+ * - POST   /designs              — { title?, preset?, width?, height?, assetId? }
+ * - POST   /designs/:id/export   — { format, quality?, videoQuality?, pages? }
+ * - POST   /assets               — { name, content: base64 }
+ *
+ * @module controllers/canva/canva.routes
+ */
+import { Router } from 'express';
+import { getStatus, getConnectUrl, disconnect, listDesigns, getDesign, createDesign, exportDesign, uploadAsset } from './canva.controller.js';
+/**
+ * Creates the Canva router.
+ *
+ * @returns Express router
+ */
+export function createCanvaRouter() {
+    const router = Router();
+    router.get('/status', getStatus);
+    router.get('/connect-url', getConnectUrl);
+    router.delete('/disconnect', disconnect);
+    router.get('/designs', listDesigns);
+    router.get('/designs/:id', getDesign);
+    router.post('/designs', createDesign);
+    router.post('/designs/:id/export', exportDesign);
+    router.post('/assets', uploadAsset);
+    return router;
+}
+//# sourceMappingURL=canva.routes.js.map

package/dist/backend/backend/src/controllers/canva/canva.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canva.routes.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/canva/canva.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE9I;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/backend/backend/src/controllers/google/google.controller.d.ts

@@ -15,11 +15,19 @@ import type { Request, Response } from 'express';
 import { GoogleWorkspaceTokenService } from '../../services/google/google-workspace-token.service.js';
 import { GmailService } from '../../services/google/gmail.service.js';
 import { CalendarService } from '../../services/google/calendar.service.js';
+import { DriveService } from '../../services/google/drive.service.js';
+import { DocsService } from '../../services/google/docs.service.js';
+import { SheetsService } from '../../services/google/sheets.service.js';
+import { SlidesService } from '../../services/google/slides.service.js';
 /** The services the handlers use; swappable for tests. */
 export interface GoogleControllerDeps {
     tokens: GoogleWorkspaceTokenService;
     gmail: GmailService;
     calendar: CalendarService;
+    drive: DriveService;
+    docs: DocsService;
+    sheets: SheetsService;
+    slides: SlidesService;
 }
 /**
  * Replace (or, with null, reset) the services the handlers use. Tests only.
@@ -97,4 +105,96 @@ export declare function calendarList(req: Request, res: Response): Promise<void>
  * @param res - Response
  */
 export declare function calendarCreate(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/drive/files?q=&mimeType=&folderId=&max= — search.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function driveSearch(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/drive/files/:id — metadata.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function driveGet(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/drive/files/:id/content — exported text / downloaded body.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function driveContent(req: Request, res: Response): Promise<void>;
+/**
+ * POST /api/google/drive/files — body `{ name, content, encoding?, mimeType?, folderId?, convertTo? }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function driveUpload(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/docs/:id — document as text.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function docsRead(req: Request, res: Response): Promise<void>;
+/**
+ * POST /api/google/docs — body `{ title, text? }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function docsCreate(req: Request, res: Response): Promise<void>;
+/**
+ * POST /api/google/docs/:id/append — body `{ text }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function docsAppend(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/sheets/:id — title + tabs.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function sheetsInfo(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/sheets/:id/values?range= — cell values.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function sheetsRead(req: Request, res: Response): Promise<void>;
+/**
+ * POST /api/google/sheets — body `{ title, sheetTitle?, rows? }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function sheetsCreate(req: Request, res: Response): Promise<void>;
+/**
+ * POST /api/google/sheets/:id/values — body `{ range?, rows, mode?: 'append' | 'update' }`
+ * (default append).
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function sheetsWrite(req: Request, res: Response): Promise<void>;
+/**
+ * GET /api/google/slides/:id — deck as text per slide.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function slidesRead(req: Request, res: Response): Promise<void>;
+/**
+ * POST /api/google/slides — body `{ title, slides: [{ title, bullets? }] }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export declare function slidesCreate(req: Request, res: Response): Promise<void>;
 //# sourceMappingURL=google.controller.d.ts.map

package/dist/backend/backend/src/controllers/google/google.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/google/google.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EACL,2BAA2B,EAE5B,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,YAAY,EAAoC,MAAM,wCAAwC,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAI5E,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,2BAA2B,CAAC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAkBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE/E;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6B/E;AA0BD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB1E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAY7E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/E"}
+{"version":3,"file":"google.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/google/google.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EACL,2BAA2B,EAE5B,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,YAAY,EAAoC,MAAM,wCAAwC,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAkB,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,aAAa,EAAqB,MAAM,yCAAyC,CAAC;AAI3F,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,2BAA2B,CAAC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB;AA0BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE/E;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6B/E;AA0BD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB1E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAY7E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/E;AAMD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5E;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAMD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AAMD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7E;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5E;AAMD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7E"}

package/dist/backend/backend/src/controllers/google/google.controller.js

@@ -16,6 +16,10 @@ import { LoggerService } from '../../services/core/logger.service.js';
 import { GoogleWorkspaceTokenService, GoogleWorkspaceError, } from '../../services/google/google-workspace-token.service.js';
 import { GmailService, buildRfc822 } from '../../services/google/gmail.service.js';
 import { CalendarService } from '../../services/google/calendar.service.js';
+import { DriveService } from '../../services/google/drive.service.js';
+import { DocsService } from '../../services/google/docs.service.js';
+import { SheetsService } from '../../services/google/sheets.service.js';
+import { SlidesService } from '../../services/google/slides.service.js';
 const logger = LoggerService.getInstance().createComponentLogger('GoogleController');
 let deps = null;
 /**
@@ -27,7 +31,15 @@ let deps = null;
 function getDeps() {
     if (!deps) {
         const tokens = GoogleWorkspaceTokenService.getInstance();
-        deps = { tokens, gmail: new GmailService({ tokens }), calendar: new CalendarService({ tokens }) };
+        deps = {
+            tokens,
+            gmail: new GmailService({ tokens }),
+            calendar: new CalendarService({ tokens }),
+            drive: new DriveService({ tokens }),
+            docs: new DocsService({ tokens }),
+            sheets: new SheetsService({ tokens }),
+            slides: new SlidesService({ tokens }),
+        };
     }
     return deps;
 }
@@ -290,4 +302,228 @@ export async function calendarCreate(req, res) {
         sendGoogleError(req, res, err);
     }
 }
+// ---------------------------------------------------------------------------
+// Drive
+// ---------------------------------------------------------------------------
+/**
+ * GET /api/google/drive/files?q=&mimeType=&folderId=&max= — search.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function driveSearch(req, res) {
+    try {
+        const files = await getDeps().drive.search({
+            query: q(req, 'q') || undefined,
+            mimeType: q(req, 'mimeType') || undefined,
+            folderId: q(req, 'folderId') || undefined,
+            max: qInt(req, 'max'),
+        });
+        res.json({ success: true, data: { count: files.length, files } });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * GET /api/google/drive/files/:id — metadata.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function driveGet(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().drive.get(String(req.params.id ?? '')) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * GET /api/google/drive/files/:id/content — exported text / downloaded body.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function driveContent(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().drive.readContent(String(req.params.id ?? '')) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * POST /api/google/drive/files — body `{ name, content, encoding?, mimeType?, folderId?, convertTo? }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function driveUpload(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const file = await getDeps().drive.upload({
+            name: String(body.name ?? ''),
+            content: typeof body.content === 'string' ? body.content : '',
+            encoding: body.encoding === 'base64' ? 'base64' : 'utf8',
+            mimeType: body.mimeType,
+            folderId: body.folderId,
+            convertTo: body.convertTo,
+        });
+        logger.info('Drive file uploaded', { id: file.id, name: file.name });
+        res.json({ success: true, data: file });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+// ---------------------------------------------------------------------------
+// Docs
+// ---------------------------------------------------------------------------
+/**
+ * GET /api/google/docs/:id — document as text.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function docsRead(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().docs.read(String(req.params.id ?? '')) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * POST /api/google/docs — body `{ title, text? }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function docsCreate(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const doc = await getDeps().docs.create({ title: String(body.title ?? ''), text: typeof body.text === 'string' ? body.text : undefined });
+        logger.info('Google Doc created', { id: doc.id, title: doc.title });
+        res.json({ success: true, data: doc });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * POST /api/google/docs/:id/append — body `{ text }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function docsAppend(req, res) {
+    try {
+        const body = (req.body ?? {});
+        res.json({ success: true, data: await getDeps().docs.append(String(req.params.id ?? ''), String(body.text ?? '')) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+// ---------------------------------------------------------------------------
+// Sheets
+// ---------------------------------------------------------------------------
+/**
+ * GET /api/google/sheets/:id — title + tabs.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function sheetsInfo(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().sheets.info(String(req.params.id ?? '')) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * GET /api/google/sheets/:id/values?range= — cell values.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function sheetsRead(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().sheets.read(String(req.params.id ?? ''), q(req, 'range') || undefined) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * POST /api/google/sheets — body `{ title, sheetTitle?, rows? }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function sheetsCreate(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const info = await getDeps().sheets.create({ title: String(body.title ?? ''), sheetTitle: body.sheetTitle, rows: body.rows });
+        logger.info('Google Sheet created', { id: info.id, title: info.title });
+        res.json({ success: true, data: info });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * POST /api/google/sheets/:id/values — body `{ range?, rows, mode?: 'append' | 'update' }`
+ * (default append).
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function sheetsWrite(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const input = { spreadsheetId: String(req.params.id ?? ''), range: body.range, rows: body.rows };
+        const result = body.mode === 'update' ? await getDeps().sheets.update(input) : await getDeps().sheets.append(input);
+        res.json({ success: true, data: { mode: body.mode === 'update' ? 'update' : 'append', ...result } });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+// ---------------------------------------------------------------------------
+// Slides
+// ---------------------------------------------------------------------------
+/**
+ * GET /api/google/slides/:id — deck as text per slide.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function slidesRead(req, res) {
+    try {
+        res.json({ success: true, data: await getDeps().slides.read(String(req.params.id ?? '')) });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
+/**
+ * POST /api/google/slides — body `{ title, slides: [{ title, bullets? }] }`.
+ *
+ * @param req - Incoming request
+ * @param res - Response
+ */
+export async function slidesCreate(req, res) {
+    try {
+        const body = (req.body ?? {});
+        const deck = await getDeps().slides.create({ title: String(body.title ?? ''), slides: Array.isArray(body.slides) ? body.slides : [] });
+        logger.info('Google Slides deck created', { id: deck.id, title: deck.title, slides: deck.slideCount });
+        res.json({ success: true, data: deck });
+    }
+    catch (err) {
+        sendGoogleError(req, res, err);
+    }
+}
 //# sourceMappingURL=google.controller.js.map