crewly 1.20.29 → 1.20.31

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

@@ -0,0 +1,157 @@
+/**
+ * DriveService — Google Drive over the owner's Workspace grant.
+ *
+ * Works within the scopes the grant already carries: `drive.readonly`
+ * (search, metadata, download / export of anything the owner can see) and
+ * `drive.file` (upload; the created files are then editable by Crewly).
+ * Google-native files (Docs / Sheets / Slides) are read through `export`
+ * as text / CSV so an agent gets something it can reason about.
+ *
+ * @module services/google/drive.service
+ */
+import { type GoogleApiDeps } from './google-api.client.js';
+/** Drive file metadata (the fields Crewly asks for). */
+export interface DriveFile {
+    id: string;
+    name: string;
+    mimeType: string;
+    modifiedTime?: string;
+    size?: number;
+    webViewLink?: string;
+    owners?: string[];
+    parents?: string[];
+}
+/** Search input. */
+export interface DriveSearchInput {
+    /** Free text; matched against name and full text. Empty = most recent files. */
+    query?: string;
+    /** Restrict to a MIME type (e.g. `application/vnd.google-apps.spreadsheet`). */
+    mimeType?: string;
+    /** Restrict to a folder id. */
+    folderId?: string;
+    max?: number;
+}
+/** What `readContent` returns. */
+export interface DriveContent {
+    file: DriveFile;
+    /** MIME type of `content` (`text/plain`, `text/csv`, or the file's own). */
+    contentType: string;
+    /** UTF-8 text for text-like files; base64 for binary files. */
+    content: string;
+    encoding: 'utf8' | 'base64';
+    bytes: number;
+}
+/** Upload input. */
+export interface DriveUploadInput {
+    name: string;
+    mimeType?: string;
+    /** UTF-8 text, or base64 when `encoding` is `base64`. */
+    content: string;
+    encoding?: 'utf8' | 'base64';
+    folderId?: string;
+    /** Convert to the Google-native type (`application/vnd.google-apps.document` …) on upload. */
+    convertTo?: string;
+}
+interface DriveWireFile {
+    id?: string;
+    name?: string;
+    mimeType?: string;
+    modifiedTime?: string;
+    size?: string;
+    webViewLink?: string;
+    owners?: Array<{
+        emailAddress?: string;
+    }>;
+    parents?: string[];
+}
+/**
+ * Trim a Drive file resource to {@link DriveFile}.
+ *
+ * @param wire - Google's file resource
+ * @returns The trimmed file
+ */
+export declare function toDriveFile(wire: DriveWireFile): DriveFile;
+/**
+ * Escape a value for a Drive `q` string literal.
+ *
+ * @param value - Raw text
+ * @returns Escaped text (backslashes and single quotes)
+ */
+export declare function escapeDriveQuery(value: string): string;
+/**
+ * Build the Drive `q` expression for a search.
+ *
+ * @param input - Search input
+ * @returns The `q` string
+ */
+export declare function buildDriveQuery(input: DriveSearchInput): string;
+/**
+ * Whether a MIME type is something an agent can read as text.
+ *
+ * @param mimeType - MIME type
+ * @returns True for text/*, JSON, XML, CSV and friends
+ */
+export declare function isTextMime(mimeType: string): boolean;
+/**
+ * Drive: search, metadata, content, upload.
+ *
+ * @example
+ * ```ts
+ * const drive = new DriveService({ tokens });
+ * const hits = await drive.search({ query: 'Q3 plan' });
+ * ```
+ */
+export declare class DriveService {
+    private readonly deps;
+    private readonly base;
+    private readonly uploadBase;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps: GoogleApiDeps);
+    /**
+     * `files.list` — most recently modified first.
+     *
+     * @param input - Query / MIME / folder / cap
+     * @returns Matching files
+     * @throws GoogleWorkspaceError on auth / Google failures
+     */
+    search(input?: DriveSearchInput): Promise<DriveFile[]>;
+    /**
+     * `files.get` metadata.
+     *
+     * @param id - File id
+     * @returns The file
+     * @throws GoogleWorkspaceError(400, validation) without an id; Google 404 passes through
+     */
+    get(id: string): Promise<DriveFile>;
+    /**
+     * File content: Google-native types are exported (Docs → text/plain,
+     * Sheets → text/csv, Slides → text/plain); other files are downloaded and
+     * returned as UTF-8 when text-like, else base64.
+     *
+     * @param id - File id
+     * @returns Content with its type and encoding
+     * @throws GoogleWorkspaceError(413, validation) when the file exceeds DRIVE_MAX_CONTENT_BYTES
+     */
+    readContent(id: string): Promise<DriveContent>;
+    /**
+     * Multipart `files.create` — a new file in My Drive (or a folder),
+     * optionally converted to a Google-native type.
+     *
+     * @param input - Name, MIME, content, folder, conversion
+     * @returns The created file
+     * @throws GoogleWorkspaceError(400, validation) for a missing name/content or oversized content
+     */
+    upload(input: DriveUploadInput): Promise<DriveFile>;
+}
+/**
+ * Validate a file / document id.
+ *
+ * @param id - Candidate id
+ * @returns The trimmed id
+ * @throws GoogleWorkspaceError(400, validation) when empty
+ */
+export declare function requireId(id: string | undefined): string;
+export {};
+//# sourceMappingURL=drive.service.d.ts.map

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

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

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

@@ -0,0 +1,203 @@
+/**
+ * DriveService — Google Drive over the owner's Workspace grant.
+ *
+ * Works within the scopes the grant already carries: `drive.readonly`
+ * (search, metadata, download / export of anything the owner can see) and
+ * `drive.file` (upload; the created files are then editable by Crewly).
+ * Google-native files (Docs / Sheets / Slides) are read through `export`
+ * as text / CSV so an agent gets something it can reason about.
+ *
+ * @module services/google/drive.service
+ */
+import { randomBytes } from 'crypto';
+import { GOOGLE_WORKSPACE_CONSTANTS } from '../../constants.js';
+import { GoogleWorkspaceError } from './google-workspace-token.service.js';
+import { buildGoogleUrl, googleRequest } from './google-api.client.js';
+import { clampMax } from './gmail.service.js';
+const FILE_FIELDS = 'id,name,mimeType,modifiedTime,size,webViewLink,owners(emailAddress),parents';
+/**
+ * Trim a Drive file resource to {@link DriveFile}.
+ *
+ * @param wire - Google's file resource
+ * @returns The trimmed file
+ */
+export function toDriveFile(wire) {
+    return {
+        id: wire.id ?? '',
+        name: wire.name ?? '',
+        mimeType: wire.mimeType ?? '',
+        ...(wire.modifiedTime ? { modifiedTime: wire.modifiedTime } : {}),
+        ...(wire.size ? { size: Number(wire.size) } : {}),
+        ...(wire.webViewLink ? { webViewLink: wire.webViewLink } : {}),
+        ...(wire.owners?.length ? { owners: wire.owners.map((o) => o.emailAddress ?? '').filter(Boolean) } : {}),
+        ...(wire.parents?.length ? { parents: wire.parents } : {}),
+    };
+}
+/**
+ * Escape a value for a Drive `q` string literal.
+ *
+ * @param value - Raw text
+ * @returns Escaped text (backslashes and single quotes)
+ */
+export function escapeDriveQuery(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+/**
+ * Build the Drive `q` expression for a search.
+ *
+ * @param input - Search input
+ * @returns The `q` string
+ */
+export function buildDriveQuery(input) {
+    const terms = ['trashed = false'];
+    const text = (input.query ?? '').trim();
+    if (text) {
+        const escaped = escapeDriveQuery(text);
+        terms.push(`(name contains '${escaped}' or fullText contains '${escaped}')`);
+    }
+    if (input.mimeType?.trim())
+        terms.push(`mimeType = '${escapeDriveQuery(input.mimeType.trim())}'`);
+    if (input.folderId?.trim())
+        terms.push(`'${escapeDriveQuery(input.folderId.trim())}' in parents`);
+    return terms.join(' and ');
+}
+/**
+ * Whether a MIME type is something an agent can read as text.
+ *
+ * @param mimeType - MIME type
+ * @returns True for text/*, JSON, XML, CSV and friends
+ */
+export function isTextMime(mimeType) {
+    return /^text\//.test(mimeType) || /\b(json|xml|csv|javascript|yaml|markdown)\b/.test(mimeType);
+}
+/**
+ * Drive: search, metadata, content, upload.
+ *
+ * @example
+ * ```ts
+ * const drive = new DriveService({ tokens });
+ * const hits = await drive.search({ query: 'Q3 plan' });
+ * ```
+ */
+export class DriveService {
+    deps;
+    base = GOOGLE_WORKSPACE_CONSTANTS.DRIVE_API_BASE;
+    uploadBase = GOOGLE_WORKSPACE_CONSTANTS.DRIVE_UPLOAD_BASE;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * `files.list` — most recently modified first.
+     *
+     * @param input - Query / MIME / folder / cap
+     * @returns Matching files
+     * @throws GoogleWorkspaceError on auth / Google failures
+     */
+    async search(input = {}) {
+        const max = clampMax(input.max, GOOGLE_WORKSPACE_CONSTANTS.DRIVE_DEFAULT_MAX_RESULTS, GOOGLE_WORKSPACE_CONSTANTS.DRIVE_MAX_RESULTS_CEILING);
+        const data = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/files`, {
+            q: buildDriveQuery(input),
+            pageSize: max,
+            orderBy: 'modifiedTime desc',
+            fields: `files(${FILE_FIELDS})`,
+            supportsAllDrives: 'true',
+            includeItemsFromAllDrives: 'true',
+        }));
+        return (data.files ?? []).map(toDriveFile);
+    }
+    /**
+     * `files.get` metadata.
+     *
+     * @param id - File id
+     * @returns The file
+     * @throws GoogleWorkspaceError(400, validation) without an id; Google 404 passes through
+     */
+    async get(id) {
+        const fileId = requireId(id);
+        const wire = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/files/${encodeURIComponent(fileId)}`, { fields: FILE_FIELDS, supportsAllDrives: 'true' }));
+        return toDriveFile(wire);
+    }
+    /**
+     * File content: Google-native types are exported (Docs → text/plain,
+     * Sheets → text/csv, Slides → text/plain); other files are downloaded and
+     * returned as UTF-8 when text-like, else base64.
+     *
+     * @param id - File id
+     * @returns Content with its type and encoding
+     * @throws GoogleWorkspaceError(413, validation) when the file exceeds DRIVE_MAX_CONTENT_BYTES
+     */
+    async readContent(id) {
+        const file = await this.get(id);
+        const exportMime = GOOGLE_WORKSPACE_CONSTANTS.DRIVE_EXPORT_MIME[file.mimeType];
+        if (exportMime) {
+            const text = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/files/${encodeURIComponent(file.id)}/export`, { mimeType: exportMime }), { responseType: 'text' });
+            return { file, contentType: exportMime, content: text, encoding: 'utf8', bytes: Buffer.byteLength(text, 'utf8') };
+        }
+        if (file.mimeType.startsWith('application/vnd.google-apps.')) {
+            throw new GoogleWorkspaceError(400, GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES.VALIDATION, `Cannot read a ${file.mimeType} as text`);
+        }
+        if ((file.size ?? 0) > GOOGLE_WORKSPACE_CONSTANTS.DRIVE_MAX_CONTENT_BYTES) {
+            throw new GoogleWorkspaceError(413, GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES.VALIDATION, `File is larger than ${GOOGLE_WORKSPACE_CONSTANTS.DRIVE_MAX_CONTENT_BYTES} bytes; open it via webViewLink instead`);
+        }
+        const raw = await googleRequest(this.deps, buildGoogleUrl(`${this.base}/files/${encodeURIComponent(file.id)}`, { alt: 'media', supportsAllDrives: 'true' }), { responseType: 'text' });
+        if (isTextMime(file.mimeType)) {
+            return { file, contentType: file.mimeType, content: raw, encoding: 'utf8', bytes: Buffer.byteLength(raw, 'utf8') };
+        }
+        // fetch's text() decoded as UTF-8; re-encode as latin1 to recover the bytes for small binaries.
+        const buf = Buffer.from(raw, 'latin1');
+        return { file, contentType: file.mimeType, content: buf.toString('base64'), encoding: 'base64', bytes: buf.length };
+    }
+    /**
+     * Multipart `files.create` — a new file in My Drive (or a folder),
+     * optionally converted to a Google-native type.
+     *
+     * @param input - Name, MIME, content, folder, conversion
+     * @returns The created file
+     * @throws GoogleWorkspaceError(400, validation) for a missing name/content or oversized content
+     */
+    async upload(input) {
+        const CODES = GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES;
+        const name = (input.name ?? '').trim();
+        if (!name)
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, '"name" is required');
+        if (typeof input.content !== 'string' || input.content.length === 0) {
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, '"content" is required');
+        }
+        const bytes = input.encoding === 'base64' ? Buffer.from(input.content, 'base64') : Buffer.from(input.content, 'utf8');
+        if (bytes.length > GOOGLE_WORKSPACE_CONSTANTS.DRIVE_MAX_CONTENT_BYTES) {
+            throw new GoogleWorkspaceError(400, CODES.VALIDATION, `content exceeds ${GOOGLE_WORKSPACE_CONSTANTS.DRIVE_MAX_CONTENT_BYTES} bytes`);
+        }
+        const mimeType = input.mimeType?.trim() || (input.encoding === 'base64' ? 'application/octet-stream' : 'text/plain');
+        const metadata = { name };
+        if (input.convertTo?.trim())
+            metadata.mimeType = input.convertTo.trim();
+        if (input.folderId?.trim())
+            metadata.parents = [input.folderId.trim()];
+        const boundary = `crewly-${randomBytes(12).toString('hex')}`;
+        const body = Buffer.concat([
+            Buffer.from(`--${boundary}\r\nContent-Type: application/json; charset=UTF-8\r\n\r\n${JSON.stringify(metadata)}\r\n`, 'utf8'),
+            Buffer.from(`--${boundary}\r\nContent-Type: ${mimeType}\r\n\r\n`, 'utf8'),
+            bytes,
+            Buffer.from(`\r\n--${boundary}--`, 'utf8'),
+        ]);
+        const wire = await googleRequest(this.deps, buildGoogleUrl(`${this.uploadBase}/files`, { uploadType: 'multipart', fields: FILE_FIELDS, supportsAllDrives: 'true' }), { method: 'POST', rawBody: body, contentType: `multipart/related; boundary=${boundary}` });
+        return toDriveFile(wire);
+    }
+}
+/**
+ * Validate a file / document id.
+ *
+ * @param id - Candidate id
+ * @returns The trimmed id
+ * @throws GoogleWorkspaceError(400, validation) when empty
+ */
+export function requireId(id) {
+    const value = (id ?? '').trim();
+    if (!value)
+        throw new GoogleWorkspaceError(400, GOOGLE_WORKSPACE_CONSTANTS.ERROR_CODES.VALIDATION, '"id" is required');
+    return value;
+}
+//# sourceMappingURL=drive.service.js.map

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

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

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"}