@ariadng/sheets 0.1.0 → 0.2.0

package/dist/core/index.mjs

@@ -1,271 +0,0 @@
-// src/core/client.ts
-import { google } from "googleapis";
-
-// src/core/errors.ts
-var GoogleSheetsError = class extends Error {
-  constructor(originalError) {
-    const message = originalError.response?.data?.error?.message || originalError.message || "Unknown error";
-    super(message);
-    this.name = "GoogleSheetsError";
-    this.code = originalError.response?.status || originalError.code;
-    this.originalError = originalError;
-    const retryableCodes = [429, 500, 502, 503, 504, "ECONNRESET", "ETIMEDOUT", "ENOTFOUND"];
-    this.isRetryable = retryableCodes.includes(this.code);
-    if (originalError.stack) {
-      this.stack = originalError.stack;
-    }
-  }
-  /**
-   * Check if error is a rate limit error
-   */
-  isRateLimitError() {
-    return this.code === 429;
-  }
-  /**
-   * Check if error is a permission error
-   */
-  isPermissionError() {
-    return this.code === 403;
-  }
-  /**
-   * Check if error is a not found error
-   */
-  isNotFoundError() {
-    return this.code === 404;
-  }
-  /**
-   * Get a user-friendly error message
-   */
-  getUserMessage() {
-    if (this.isPermissionError()) {
-      return "Permission denied. Please ensure the spreadsheet is shared with the service account or you have proper OAuth permissions.";
-    }
-    if (this.isRateLimitError()) {
-      return "Rate limit exceeded. Please wait before making more requests.";
-    }
-    if (this.isNotFoundError()) {
-      return "Spreadsheet or range not found. Please check the ID and range are correct.";
-    }
-    return this.message;
-  }
-};
-
-// src/core/client.ts
-var GoogleSheetsCore = class {
-  constructor(config) {
-    this.sheets = google.sheets({
-      version: "v4",
-      auth: config.auth
-    });
-    this.retryConfig = {
-      maxAttempts: config.retryConfig?.maxAttempts ?? 3,
-      maxDelay: config.retryConfig?.maxDelay ?? 1e4,
-      initialDelay: config.retryConfig?.initialDelay ?? 1e3
-    };
-  }
-  /**
-   * Read values from a spreadsheet
-   * @param spreadsheetId The spreadsheet ID
-   * @param range A1 notation range (e.g., 'Sheet1!A1:B10')
-   * @returns 2D array of values
-   */
-  async read(spreadsheetId, range) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.get({
-        spreadsheetId,
-        range
-      });
-      return response.data.values || [];
-    });
-  }
-  /**
-   * Write values to a spreadsheet
-   * @param spreadsheetId The spreadsheet ID
-   * @param range A1 notation range
-   * @param values 2D array of values to write
-   */
-  async write(spreadsheetId, range, values) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.update({
-        spreadsheetId,
-        range,
-        valueInputOption: "USER_ENTERED",
-        requestBody: { values }
-      });
-      return response.data;
-    });
-  }
-  /**
-   * Append values to a spreadsheet
-   */
-  async append(spreadsheetId, range, values) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.append({
-        spreadsheetId,
-        range,
-        valueInputOption: "USER_ENTERED",
-        insertDataOption: "INSERT_ROWS",
-        requestBody: { values }
-      });
-      return response.data;
-    });
-  }
-  /**
-   * Clear values in a range
-   */
-  async clear(spreadsheetId, range) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.clear({
-        spreadsheetId,
-        range
-      });
-      return response.data;
-    });
-  }
-  /**
-   * Batch read multiple ranges
-   */
-  async batchRead(spreadsheetId, ranges) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.batchGet({
-        spreadsheetId,
-        ranges
-      });
-      return response.data.valueRanges || [];
-    });
-  }
-  /**
-   * Batch update multiple ranges
-   */
-  async batchWrite(spreadsheetId, data) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.batchUpdate({
-        spreadsheetId,
-        requestBody: {
-          data: data.map((item) => ({
-            range: item.range,
-            values: item.values
-          })),
-          valueInputOption: "USER_ENTERED"
-        }
-      });
-      return response.data;
-    });
-  }
-  /**
-   * Batch clear multiple ranges
-   */
-  async batchClear(spreadsheetId, ranges) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.values.batchClear({
-        spreadsheetId,
-        requestBody: { ranges }
-      });
-      return response.data;
-    });
-  }
-  /**
-   * Get spreadsheet metadata
-   */
-  async getSpreadsheet(spreadsheetId) {
-    return this.withRetry(async () => {
-      const response = await this.sheets.spreadsheets.get({
-        spreadsheetId
-      });
-      return response.data;
-    });
-  }
-  /**
-   * Get the underlying Sheets API instance for advanced usage
-   */
-  getApi() {
-    return this.sheets;
-  }
-  /**
-   * Simple exponential backoff retry logic
-   */
-  async withRetry(fn) {
-    let lastError;
-    for (let attempt = 0; attempt < this.retryConfig.maxAttempts; attempt++) {
-      try {
-        return await fn();
-      } catch (error) {
-        lastError = error;
-        if (!this.isRetryable(error) || attempt === this.retryConfig.maxAttempts - 1) {
-          throw new GoogleSheetsError(error);
-        }
-        const baseDelay = Math.min(
-          this.retryConfig.initialDelay * Math.pow(2, attempt),
-          this.retryConfig.maxDelay
-        );
-        const jitter = Math.random() * 1e3;
-        const delay = baseDelay + jitter;
-        await new Promise((resolve) => setTimeout(resolve, delay));
-      }
-    }
-    throw new GoogleSheetsError(lastError);
-  }
-  isRetryable(error) {
-    const retryableCodes = [429, 500, 502, 503, 504];
-    const retryableErrors = ["ECONNRESET", "ETIMEDOUT", "ENOTFOUND"];
-    return retryableCodes.includes(error.code) || retryableCodes.includes(error.response?.status) || retryableErrors.includes(error.code);
-  }
-};
-
-// src/core/auth.ts
-import { GoogleAuth, OAuth2Client, JWT } from "google-auth-library";
-import * as fs from "fs/promises";
-async function createServiceAccountAuth(keyFile) {
-  const key = typeof keyFile === "string" ? JSON.parse(await fs.readFile(keyFile, "utf8")) : keyFile;
-  const jwt = new JWT({
-    email: key.client_email,
-    key: key.private_key,
-    scopes: ["https://www.googleapis.com/auth/spreadsheets"]
-  });
-  return jwt;
-}
-async function createOAuth2Client(credentials, tokenPath) {
-  const client = new OAuth2Client(
-    credentials.client_id,
-    credentials.client_secret,
-    credentials.redirect_uris[0]
-  );
-  if (tokenPath) {
-    try {
-      const token = JSON.parse(await fs.readFile(tokenPath, "utf8"));
-      client.setCredentials(token);
-    } catch {
-    }
-  }
-  return client;
-}
-function generateAuthUrl(client, scopes = ["https://www.googleapis.com/auth/spreadsheets"]) {
-  return client.generateAuthUrl({
-    access_type: "offline",
-    scope: scopes
-  });
-}
-async function getTokenFromCode(client, code) {
-  const { tokens } = await client.getToken(code);
-  client.setCredentials(tokens);
-  return tokens;
-}
-async function saveToken(tokens, path) {
-  await fs.writeFile(path, JSON.stringify(tokens, null, 2));
-}
-function createAuth(auth) {
-  if (auth instanceof GoogleAuth || auth instanceof OAuth2Client || auth instanceof JWT) {
-    return auth;
-  }
-  return createServiceAccountAuth(auth);
-}
-export {
-  GoogleSheetsCore,
-  GoogleSheetsError,
-  createAuth,
-  createOAuth2Client,
-  createServiceAccountAuth,
-  generateAuthUrl,
-  getTokenFromCode,
-  saveToken
-};

package/dist/plus/batch.d.ts

@@ -1,25 +0,0 @@
-import { GoogleSheetsCore } from '../core';
-import { sheets_v4 } from 'googleapis';
-export interface BatchWriteOperation {
-    range: string;
-    values: any[][];
-}
-export declare class BatchOperations {
-    private client;
-    private readonly MAX_BATCH_SIZE;
-    constructor(client: GoogleSheetsCore);
-    batchWrite(spreadsheetId: string, operations: BatchWriteOperation[]): Promise<sheets_v4.Schema$BatchUpdateValuesResponse[]>;
-    batchClear(spreadsheetId: string, ranges: string[]): Promise<sheets_v4.Schema$BatchClearValuesResponse[]>;
-    batchRead(spreadsheetId: string, ranges: string[]): Promise<sheets_v4.Schema$ValueRange[]>;
-    executeBatch(spreadsheetId: string, operations: {
-        writes?: BatchWriteOperation[];
-        clears?: string[];
-        reads?: string[];
-    }): Promise<{
-        writeResults?: sheets_v4.Schema$BatchUpdateValuesResponse[];
-        clearResults?: sheets_v4.Schema$BatchClearValuesResponse[];
-        readResults?: sheets_v4.Schema$ValueRange[];
-    }>;
-    private chunk;
-}
-//# sourceMappingURL=batch.d.ts.map

package/dist/plus/batch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/plus/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;CAChB;AAED,qBAAa,eAAe;IAIf,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAElB,MAAM,EAAE,gBAAgB;IAMtC,UAAU,CACf,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,EAAE,GAC/B,OAAO,CAAC,SAAS,CAAC,gCAAgC,EAAE,CAAC;IAelD,UAAU,CACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,SAAS,CAAC,+BAA+B,EAAE,CAAC;IAejD,SAAS,CACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAenC,YAAY,CACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE;QACX,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GACC,OAAO,CAAC;QACV,YAAY,CAAC,EAAE,SAAS,CAAC,gCAAgC,EAAE,CAAC;QAC5D,YAAY,CAAC,EAAE,SAAS,CAAC,+BAA+B,EAAE,CAAC;QAC3D,WAAW,CAAC,EAAE,SAAS,CAAC,iBAAiB,EAAE,CAAC;KAC5C,CAAC;IAyCF,OAAO,CAAC,KAAK;CAOb"}

package/dist/plus/cache.d.ts

@@ -1,19 +0,0 @@
-import { GoogleSheetsCore } from '../core';
-export interface CacheConfig {
-    ttlSeconds?: number;
-    maxEntries?: number;
-}
-export declare class SimpleCache {
-    private cache;
-    private config;
-    constructor(config?: CacheConfig);
-    get(key: string): any | null;
-    set(key: string, value: any, ttlOverride?: number): void;
-    invalidate(pattern?: string): void;
-    size(): number;
-    clear(): void;
-}
-export declare function withCache(client: GoogleSheetsCore, config?: CacheConfig): GoogleSheetsCore & {
-    cache: SimpleCache;
-};
-//# sourceMappingURL=cache.d.ts.map

package/dist/plus/cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/plus/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,WAAW;IAOhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAa5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBxD,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAelC,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;CAGb;AAKD,wBAAgB,SAAS,CACxB,MAAM,EAAE,gBAAgB,EACxB,MAAM,CAAC,EAAE,WAAW,GAClB,gBAAgB,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAmH3C"}

package/dist/plus/index.d.ts

@@ -1,7 +0,0 @@
-export { BatchOperations } from './batch';
-export type { BatchWriteOperation } from './batch';
-export { SimpleCache, withCache } from './cache';
-export type { CacheConfig } from './cache';
-export { A1, TypedSheets, Parsers, Serializers } from './types';
-export * from '../core';
-//# sourceMappingURL=index.d.ts.map

package/dist/plus/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGhE,cAAc,SAAS,CAAC"}