crewly 1.20.28 → 1.20.30

package/dist/backend/backend/src/services/google/google-api.client.d.ts

@@ -26,19 +26,27 @@ export interface GoogleApiDeps {
  * @returns The full URL string
  */
 export declare function buildGoogleUrl(base: string, params?: Record<string, string | number | string[] | undefined>): string;
+/** Request options for {@link googleRequest}. */
+export interface GoogleRequestInit {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** JSON body (serialised, `Content-Type: application/json`). */
+    body?: unknown;
+    /** Pre-encoded body (multipart upload, binary) — needs `contentType`. */
+    rawBody?: string | Buffer;
+    contentType?: string;
+    /** `text` returns the body verbatim (Drive export / `alt=media`); default `json`. */
+    responseType?: 'json' | 'text';
+}
 /**
- * Authenticated JSON call to a Google API.
+ * Authenticated call to a Google API.
  *
  * @param deps - Token provider + fetch
  * @param url - Absolute URL (use {@link buildGoogleUrl})
- * @param init - Method and optional JSON body
- * @returns The parsed JSON response
+ * @param init - Method, body and response type
+ * @returns The parsed JSON response (or the raw text with `responseType: 'text'`)
  * @throws GoogleWorkspaceError — token failures pass through; Google 401 →
  *   401 google_error (cache dropped), 403/404/429 keep their status, other
  *   failures → 502 google_error, unreachable → 502 network
  */
-export declare function googleRequest<T>(deps: GoogleApiDeps, url: string, init?: {
-    method?: 'GET' | 'POST';
-    body?: unknown;
-}): Promise<T>;
+export declare function googleRequest<T>(deps: GoogleApiDeps, url: string, init?: GoogleRequestInit): Promise<T>;
 //# sourceMappingURL=google-api.client.d.ts.map

package/dist/backend/backend/src/services/google/google-api.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-api.client.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/google/google-api.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAwBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAM,GAAG,MAAM,CAWxH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,CAAC,CAAC,CAsCZ"}
+{"version":3,"file":"google-api.client.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/google/google-api.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAwBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAM,GAAG,MAAM,CAWxH;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CA4CjH"}

package/dist/backend/backend/src/services/google/google-api.client.js

@@ -51,12 +51,12 @@ export function buildGoogleUrl(base, params = {}) {
     return url.toString();
 }
 /**
- * Authenticated JSON call to a Google API.
+ * Authenticated call to a Google API.
  *
  * @param deps - Token provider + fetch
  * @param url - Absolute URL (use {@link buildGoogleUrl})
- * @param init - Method and optional JSON body
- * @returns The parsed JSON response
+ * @param init - Method, body and response type
+ * @returns The parsed JSON response (or the raw text with `responseType: 'text'`)
  * @throws GoogleWorkspaceError — token failures pass through; Google 401 →
  *   401 google_error (cache dropped), 403/404/429 keep their status, other
  *   failures → 502 google_error, unreachable → 502 network
@@ -65,16 +65,21 @@ export async function googleRequest(deps, url, init = {}) {
     const token = await deps.tokens.getAccessToken();
     const fetchImpl = deps.fetchImpl ?? fetch;
     const CODES = GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES;
+    const wantsText = init.responseType === 'text';
     let res;
     try {
         res = await fetchImpl(url, {
             method: init.method ?? 'GET',
             headers: {
                 Authorization: `Bearer ${token}`,
-                Accept: 'application/json',
-                ...(init.body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+                Accept: wantsText ? '*/*' : 'application/json',
+                ...(init.rawBody !== undefined
+                    ? { 'Content-Type': init.contentType ?? 'application/octet-stream' }
+                    : init.body !== undefined
+                        ? { 'Content-Type': 'application/json' }
+                        : {}),
             },
-            body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+            body: init.rawBody !== undefined ? init.rawBody : init.body !== undefined ? JSON.stringify(init.body) : undefined,
             signal: AbortSignal.timeout(GOOGLE_WORKSPACE_CONSTANTS.REQUEST_TIMEOUT_MS),
         });
     }
@@ -92,6 +97,8 @@ export async function googleRequest(deps, url, init = {}) {
         const passthrough = res.status === 403 || res.status === 404 || res.status === 429;
         throw new GoogleWorkspaceError(passthrough ? res.status : 502, CODES.GOOGLE_ERROR, message);
     }
+    if (wantsText)
+        return text;
     if (!text)
         return {};
     try {

package/dist/backend/backend/src/services/google/google-api.client.js.map

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

package/dist/backend/backend/src/services/google/sheets.service.d.ts

@@ -0,0 +1,118 @@
+/**
+ * SheetsService — Google Sheets over the owner's Workspace grant.
+ *
+ * Reads any spreadsheet the owner can see (`drive.readonly`), creates new
+ * spreadsheets and writes to the ones Crewly created (`drive.file`).
+ * Writing to a spreadsheet made elsewhere needs the `spreadsheets` scope
+ * the grant does not carry yet; Google answers 403 and the error says so.
+ *
+ * @module services/google/sheets.service
+ */
+import { type GoogleApiDeps } from './google-api.client.js';
+/** A cell value as the API returns it (strings/numbers/booleans). */
+export type SheetCell = string | number | boolean;
+/** A rectangular block of values. */
+export interface SheetValues {
+    spreadsheetId: string;
+    range: string;
+    rows: SheetCell[][];
+}
+/** Spreadsheet metadata. */
+export interface SpreadsheetInfo {
+    id: string;
+    title: string;
+    sheets: Array<{
+        title: string;
+        rowCount?: number;
+        columnCount?: number;
+    }>;
+    webViewLink: string;
+}
+/** Create input. */
+export interface SheetCreateInput {
+    title: string;
+    /** Name of the first sheet tab (default "Sheet1"). */
+    sheetTitle?: string;
+    /** Initial rows written from A1. */
+    rows?: SheetCell[][];
+}
+/** Write input (append or overwrite). */
+export interface SheetWriteInput {
+    spreadsheetId: string;
+    /** A1 range; for append the table it belongs to, for update the top-left anchor. */
+    range?: string;
+    rows: SheetCell[][];
+}
+/**
+ * Validate rows for a write.
+ *
+ * @param rows - Candidate rows
+ * @returns The rows
+ * @throws GoogleWorkspaceError(400, validation) when empty, not rectangular-ish, or too many
+ */
+export declare function requireRows(rows: unknown): SheetCell[][];
+/**
+ * Sheets: read, create, append, update.
+ */
+export declare class SheetsService {
+    private readonly deps;
+    private readonly base;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps: GoogleApiDeps);
+    /**
+     * `spreadsheets.get` (properties only) — title and the sheet tabs.
+     *
+     * @param id - Spreadsheet id
+     * @returns Metadata
+     */
+    info(id: string): Promise<SpreadsheetInfo>;
+    /**
+     * `spreadsheets.values.get`.
+     *
+     * @param id - Spreadsheet id
+     * @param range - A1 range (default `A1:Z1000` on the first sheet)
+     * @returns The values (rows may be ragged)
+     */
+    read(id: string, range?: string): Promise<SheetValues>;
+    /**
+     * `spreadsheets.create`, then `values.update` from A1 when rows are given.
+     *
+     * @param input - Title, first-sheet name, initial rows
+     * @returns The new spreadsheet
+     * @throws GoogleWorkspaceError(400, validation) without a title
+     */
+    create(input: SheetCreateInput): Promise<SpreadsheetInfo>;
+    /**
+     * `spreadsheets.values.append` — rows go below the last row of the
+     * table that contains `range` (default: the first sheet).
+     *
+     * @param input - Spreadsheet, range, rows
+     * @returns Updated range and counts
+     */
+    append(input: SheetWriteInput): Promise<{
+        spreadsheetId: string;
+        updatedRange: string;
+        updatedRows: number;
+    }>;
+    /**
+     * `spreadsheets.values.update` — overwrite starting at `range`.
+     *
+     * @param input - Spreadsheet, anchor range, rows
+     * @returns Updated range and counts
+     */
+    update(input: SheetWriteInput): Promise<{
+        spreadsheetId: string;
+        updatedRange: string;
+        updatedRows: number;
+    }>;
+}
+/**
+ * Quote a sheet name for an A1 range when it needs it.
+ *
+ * @param name - Sheet title
+ * @returns `'My Sheet'` or `Sheet1`
+ */
+export declare function quoteSheet(name: string): string;
+//# sourceMappingURL=sheets.service.d.ts.map

package/dist/backend/backend/src/services/google/sheets.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/google/sheets.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG3F,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oBAAoB;AACpB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;CACrB;AASD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,EAAE,CAexD;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8C;IAEnE;;OAEG;gBACS,IAAI,EAAE,aAAa;IAI/B;;;;;OAKG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAWhD;;;;;;OAMG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAa5D;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAe/D;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAenH;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAapH;AAgBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/backend/backend/src/services/google/sheets.service.js

@@ -0,0 +1,158 @@
+/**
+ * SheetsService — Google Sheets over the owner's Workspace grant.
+ *
+ * Reads any spreadsheet the owner can see (`drive.readonly`), creates new
+ * spreadsheets and writes to the ones Crewly created (`drive.file`).
+ * Writing to a spreadsheet made elsewhere needs the `spreadsheets` scope
+ * the grant does not carry yet; Google answers 403 and the error says so.
+ *
+ * @module services/google/sheets.service
+ */
+import { GOOGLE_WORKSPACE_CONSTANTS } from '../../constants.js';
+import { GoogleWorkspaceError } from './google-workspace-token.service.js';
+import { buildGoogleUrl, googleRequest } from './google-api.client.js';
+import { requireId } from './drive.service.js';
+/**
+ * Validate rows for a write.
+ *
+ * @param rows - Candidate rows
+ * @returns The rows
+ * @throws GoogleWorkspaceError(400, validation) when empty, not rectangular-ish, or too many
+ */
+export function requireRows(rows) {
+    const CODES = GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES;
+    if (!Array.isArray(rows) || rows.length === 0)
+        throw new GoogleWorkspaceError(400, CODES.VALIDATION, '"rows" must be a non-empty array of arrays');
+    if (rows.length > GOOGLE_WORKSPACE_CONSTANTS.SHEETS_MAX_ROWS) {
+        throw new GoogleWorkspaceError(400, CODES.VALIDATION, `"rows" exceeds ${GOOGLE_WORKSPACE_CONSTANTS.SHEETS_MAX_ROWS}`);
+    }
+    for (const row of rows) {
+        if (!Array.isArray(row))
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, 'each row must be an array');
+        for (const cell of row) {
+            if (cell !== null && cell !== undefined && !['string', 'number', 'boolean'].includes(typeof cell)) {
+                throw new GoogleWorkspaceError(400, CODES.VALIDATION, 'cells must be strings, numbers or booleans');
+            }
+        }
+    }
+    return rows.map((row) => row.map((cell) => (cell === null || cell === undefined ? '' : cell)));
+}
+/**
+ * Sheets: read, create, append, update.
+ */
+export class SheetsService {
+    deps;
+    base = GOOGLE_WORKSPACE_CONSTANTS.SHEETS_API_BASE;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * `spreadsheets.get` (properties only) — title and the sheet tabs.
+     *
+     * @param id - Spreadsheet id
+     * @returns Metadata
+     */
+    async info(id) {
+        const spreadsheetId = requireId(id);
+        const wire = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}`, {
+            fields: 'spreadsheetId,properties.title,spreadsheetUrl,sheets.properties(title,gridProperties(rowCount,columnCount))',
+        }));
+        return toInfo(wire);
+    }
+    /**
+     * `spreadsheets.values.get`.
+     *
+     * @param id - Spreadsheet id
+     * @param range - A1 range (default `A1:Z1000` on the first sheet)
+     * @returns The values (rows may be ragged)
+     */
+    async read(id, range) {
+        const spreadsheetId = requireId(id);
+        const a1 = (range ?? '').trim() || GOOGLE_WORKSPACE_CONSTANTS.SHEETS_DEFAULT_RANGE;
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(a1)}`, {
+            valueRenderOption: 'UNFORMATTED_VALUE',
+            dateTimeRenderOption: 'FORMATTED_STRING',
+        }));
+        return { spreadsheetId, range: data.range ?? a1, rows: data.values ?? [] };
+    }
+    /**
+     * `spreadsheets.create`, then `values.update` from A1 when rows are given.
+     *
+     * @param input - Title, first-sheet name, initial rows
+     * @returns The new spreadsheet
+     * @throws GoogleWorkspaceError(400, validation) without a title
+     */
+    async create(input) {
+        const title = (input.title ?? '').trim();
+        if (!title)
+            throw new GoogleWorkspaceError(400, GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES.VALIDATION, '"title" is required');
+        const sheetTitle = (input.sheetTitle ?? '').trim() || 'Sheet1';
+        const created = await googleRequest(this.deps, `${this.base}/spreadsheets`, {
+            method: 'POST',
+            body: { properties: { title }, sheets: [{ properties: { title: sheetTitle } }] },
+        });
+        const id = created.spreadsheetId ?? '';
+        if (input.rows && input.rows.length > 0) {
+            await this.update({ spreadsheetId: id, range: `${quoteSheet(sheetTitle)}!A1`, rows: input.rows });
+        }
+        return toInfo(created);
+    }
+    /**
+     * `spreadsheets.values.append` — rows go below the last row of the
+     * table that contains `range` (default: the first sheet).
+     *
+     * @param input - Spreadsheet, range, rows
+     * @returns Updated range and counts
+     */
+    async append(input) {
+        const spreadsheetId = requireId(input.spreadsheetId);
+        const rows = requireRows(input.rows);
+        const a1 = (input.range ?? '').trim() || 'A1';
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(a1)}:append`, {
+            valueInputOption: 'USER_ENTERED',
+            insertDataOption: 'INSERT_ROWS',
+        }), { method: 'POST', body: { values: rows } });
+        return { spreadsheetId, updatedRange: data.updates?.updatedRange ?? a1, updatedRows: data.updates?.updatedRows ?? rows.length };
+    }
+    /**
+     * `spreadsheets.values.update` — overwrite starting at `range`.
+     *
+     * @param input - Spreadsheet, anchor range, rows
+     * @returns Updated range and counts
+     */
+    async update(input) {
+        const spreadsheetId = requireId(input.spreadsheetId);
+        const rows = requireRows(input.rows);
+        const a1 = (input.range ?? '').trim() || 'A1';
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(a1)}`, {
+            valueInputOption: 'USER_ENTERED',
+        }), { method: 'PUT', body: { values: rows } });
+        return { spreadsheetId, updatedRange: data.updatedRange ?? a1, updatedRows: data.updatedRows ?? rows.length };
+    }
+}
+function toInfo(wire) {
+    const id = wire.spreadsheetId ?? '';
+    return {
+        id,
+        title: wire.properties?.title ?? '',
+        sheets: (wire.sheets ?? []).map((s) => ({
+            title: s.properties?.title ?? '',
+            ...(s.properties?.gridProperties?.rowCount !== undefined ? { rowCount: s.properties.gridProperties.rowCount } : {}),
+            ...(s.properties?.gridProperties?.columnCount !== undefined ? { columnCount: s.properties.gridProperties.columnCount } : {}),
+        })),
+        webViewLink: wire.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}/edit`,
+    };
+}
+/**
+ * Quote a sheet name for an A1 range when it needs it.
+ *
+ * @param name - Sheet title
+ * @returns `'My Sheet'` or `Sheet1`
+ */
+export function quoteSheet(name) {
+    return /^[A-Za-z0-9_]+$/.test(name) ? name : `'${name.replace(/'/g, "''")}'`;
+}
+//# sourceMappingURL=sheets.service.js.map

package/dist/backend/backend/src/services/google/sheets.service.js.map

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

package/dist/backend/backend/src/services/google/slides.service.d.ts

@@ -0,0 +1,136 @@
+/**
+ * SlidesService — Google Slides over the owner's Workspace grant.
+ *
+ * Reads any presentation the owner can see (`drive.readonly`) and builds
+ * new decks from an outline (`drive.file`). Each outline slide becomes a
+ * TITLE_AND_BODY slide with the title and bullet lines; the deck's default
+ * first slide is removed so the outline is the whole deck.
+ *
+ * @module services/google/slides.service
+ */
+import { type GoogleApiDeps } from './google-api.client.js';
+/** One slide, flattened. */
+export interface SlideText {
+    index: number;
+    objectId: string;
+    /** Every text line on the slide, in reading order. */
+    lines: string[];
+    notes?: string;
+}
+/** A presentation, flattened. */
+export interface PresentationText {
+    id: string;
+    title: string;
+    slideCount: number;
+    slides: SlideText[];
+    webViewLink: string;
+}
+/** One slide of an outline. */
+export interface SlideOutline {
+    title: string;
+    /** Body lines; each becomes one paragraph (bulleting is the layout's default). */
+    bullets?: string[];
+    /** Speaker notes are not written (the Slides API needs the notes shape id) — kept for callers' bookkeeping. */
+    notes?: string;
+}
+/** Create input. */
+export interface PresentationCreateInput {
+    title: string;
+    slides: SlideOutline[];
+}
+interface WireTextElement {
+    textRun?: {
+        content?: string;
+    };
+}
+interface WirePageElement {
+    shape?: {
+        text?: {
+            textElements?: WireTextElement[];
+        };
+    };
+    table?: {
+        tableRows?: Array<{
+            tableCells?: Array<{
+                text?: {
+                    textElements?: WireTextElement[];
+                };
+            }>;
+        }>;
+    };
+    elementGroup?: {
+        children?: WirePageElement[];
+    };
+}
+interface WirePage {
+    objectId?: string;
+    pageElements?: WirePageElement[];
+    slideProperties?: {
+        notesPage?: {
+            pageElements?: WirePageElement[];
+        };
+    };
+}
+interface WirePresentation {
+    presentationId?: string;
+    title?: string;
+    slides?: WirePage[];
+}
+/**
+ * Lines of text in a page element (shape text, table cells, groups).
+ *
+ * @param el - Page element
+ * @returns Non-empty lines
+ */
+export declare function elementLines(el: WirePageElement): string[];
+/**
+ * Flatten a presentation.
+ *
+ * @param wire - `presentations.get` payload
+ * @returns Title + slides as text
+ */
+export declare function toPresentationText(wire: WirePresentation): PresentationText;
+/**
+ * The batchUpdate requests that turn an outline into slides.
+ *
+ * @param outline - Slides to add
+ * @param removeSlideId - Object id of the default slide to delete, if any
+ * @returns Requests in order (creates, inserts, then the delete)
+ */
+export declare function buildSlideRequests(outline: SlideOutline[], removeSlideId?: string): unknown[];
+/**
+ * Slides: read, create from outline.
+ */
+export declare class SlidesService {
+    private readonly deps;
+    private readonly base;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps: GoogleApiDeps);
+    /**
+     * `presentations.get`, flattened to text per slide.
+     *
+     * @param id - Presentation id
+     * @returns Title + slides
+     */
+    read(id: string): Promise<PresentationText>;
+    /**
+     * `presentations.create` + one `batchUpdate` that adds every outline
+     * slide and removes the default blank one.
+     *
+     * @param input - Title and outline
+     * @returns The new deck, flattened (as read back from Google)
+     * @throws GoogleWorkspaceError(400, validation) without a title / slides, or too many slides
+     */
+    create(input: PresentationCreateInput): Promise<PresentationText>;
+}
+/**
+ * Browser link for a presentation.
+ *
+ * @param id - Presentation id
+ * @returns URL
+ */
+export declare function slidesLink(id: string): string;
+export {};
+//# sourceMappingURL=slides.service.d.ts.map

package/dist/backend/backend/src/services/google/slides.service.d.ts.map

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