@ariadng/sheets 0.1.1 → 0.3.0

package/dist/types/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Google Sheets API Type Definitions
+ */
+export interface GridProperties {
+    rowCount: number;
+    columnCount: number;
+    frozenRowCount?: number;
+    frozenColumnCount?: number;
+    hideGridlines?: boolean;
+}
+export interface SheetProperties {
+    sheetId: number;
+    title: string;
+    index: number;
+    sheetType?: 'GRID' | 'OBJECT' | 'DATA_SOURCE';
+    gridProperties?: GridProperties;
+    hidden?: boolean;
+    rightToLeft?: boolean;
+}
+export interface SpreadsheetProperties {
+    title: string;
+    locale?: string;
+    timeZone?: string;
+    autoRecalc?: 'ON_CHANGE' | 'MINUTE' | 'HOUR';
+    defaultFormat?: CellFormat;
+}
+export interface Spreadsheet {
+    spreadsheetId: string;
+    properties: SpreadsheetProperties;
+    sheets: {
+        properties: SheetProperties;
+    }[];
+    spreadsheetUrl?: string;
+}
+export interface CellFormat {
+    numberFormat?: {
+        type: string;
+        pattern?: string;
+    };
+    backgroundColor?: Color;
+    textFormat?: TextFormat;
+}
+export interface Color {
+    red?: number;
+    green?: number;
+    blue?: number;
+    alpha?: number;
+}
+export interface TextFormat {
+    foregroundColor?: Color;
+    fontFamily?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    strikethrough?: boolean;
+    underline?: boolean;
+}
+export interface CellValue {
+    value: string | number | boolean | null;
+    formula?: string;
+    formattedValue?: string;
+}
+export type ValueRenderOption = 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA';
+export type DateTimeRenderOption = 'SERIAL_NUMBER' | 'FORMATTED_STRING';
+export type MajorDimension = 'ROWS' | 'COLUMNS';
+export interface ValueRange {
+    range: string;
+    majorDimension: MajorDimension;
+    values: CellValue[][];
+}
+export interface GetValuesOptions {
+    valueRenderOption?: ValueRenderOption;
+    dateTimeRenderOption?: DateTimeRenderOption;
+    majorDimension?: MajorDimension;
+}
+export interface BatchGetValuesResponse {
+    spreadsheetId: string;
+    valueRanges: ValueRange[];
+}
+export interface OAuthConfig {
+    type: 'oauth';
+    accessToken: string;
+    refreshToken?: string;
+    clientId?: string;
+    clientSecret?: string;
+}
+export interface ServiceAccountConfig {
+    type: 'service-account';
+    credentialsPath?: string;
+    credentials?: ServiceAccountCredentials;
+}
+export interface ServiceAccountCredentials {
+    type: 'service_account';
+    project_id: string;
+    private_key_id: string;
+    private_key: string;
+    client_email: string;
+    client_id: string;
+    auth_uri: string;
+    token_uri: string;
+}
+export interface UserAuthConfig {
+    type: 'user';
+}
+export interface StoredTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    email?: string;
+}
+export type AuthConfig = OAuthConfig | ServiceAccountConfig | UserAuthConfig;
+export interface SheetsClientOptions {
+    auth: AuthConfig;
+}
+export interface SheetsApiErrorDetail {
+    '@type'?: string;
+    reason?: string;
+    domain?: string;
+    metadata?: Record<string, string>;
+}
+export interface SheetsApiError {
+    code: number;
+    message: string;
+    status: string;
+    details?: SheetsApiErrorDetail[];
+}
+export declare class SheetsError extends Error {
+    code: number;
+    status: string;
+    details?: SheetsApiErrorDetail[];
+    constructor(error: SheetsApiError);
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,16 @@
+/**
+ * Google Sheets API Type Definitions
+ */
+export class SheetsError extends Error {
+    code;
+    status;
+    details;
+    constructor(error) {
+        super(error.message);
+        this.name = 'SheetsError';
+        this.code = error.code;
+        this.status = error.status;
+        this.details = error.details;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgKH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClC,IAAI,CAAS;IACb,MAAM,CAAS;IACf,OAAO,CAA0B;IAEjC,YAAY,KAAqB;QAC7B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACjC,CAAC;CACJ"}

package/package.json

@@ -1,81 +1,60 @@
 {
-	"name": "@ariadng/sheets",
-	"version": "0.1.1",
-	"description": "A pragmatic TypeScript client for Google Sheets API v4",
-	"main": "./dist/core/index.js",
-	"module": "./dist/core/index.mjs",
-	"types": "./dist/core/index.d.ts",
-	"exports": {
-		"./core": {
-			"types": "./dist/core/index.d.ts",
-			"import": "./dist/core/index.mjs",
-			"require": "./dist/core/index.js"
-		},
-		"./plus": {
-			"types": "./dist/plus/index.d.ts",
-			"import": "./dist/plus/index.mjs",
-			"require": "./dist/plus/index.js"
-		},
-		"./advanced": {
-			"types": "./dist/advanced/index.d.ts",
-			"import": "./dist/advanced/index.mjs",
-			"require": "./dist/advanced/index.js"
-		}
-	},
-	"scripts": {
-		"build": "npm run clean && npm run build:esm && npm run build:cjs && npm run build:types",
-		"build:esm": "esbuild src/*/index.ts --bundle --platform=node --format=esm --outdir=dist --out-extension:.js=.mjs --external:googleapis --external:google-auth-library",
-		"build:cjs": "esbuild src/*/index.ts --bundle --platform=node --format=cjs --outdir=dist --external:googleapis --external:google-auth-library",
-		"build:types": "tsc --emitDeclarationOnly --declaration",
-		"clean": "rm -rf dist",
-		"test": "jest",
-		"test:unit": "jest --testPathIgnorePatterns=integration.test.ts",
-		"test:watch": "jest --watch",
-		"test:coverage": "jest --coverage",
-		"lint": "eslint src/**/*.ts",
-		"format": "prettier --write src/**/*.ts",
-		"typecheck": "tsc --noEmit",
-		"dev": "npm run build -- --watch",
-		"prepublishOnly": "npm run build && npm run test:unit && npm run typecheck"
-	},
-	"keywords": [
-		"google-sheets",
-		"google",
-		"sheets",
-		"spreadsheet",
-		"api",
-		"typescript"
-	],
-	"author": "ariadng",
-	"license": "MIT",
-	"dependencies": {
-		"googleapis": "^144.0.0",
-		"google-auth-library": "^9.15.0"
-	},
-	"devDependencies": {
-		"@types/jest": "^29.5.14",
-		"@types/node": "^22.10.2",
-		"@typescript-eslint/eslint-plugin": "^8.18.0",
-		"@typescript-eslint/parser": "^8.18.0",
-		"esbuild": "^0.24.0",
-		"eslint": "^9.17.0",
-		"jest": "^29.7.0",
-		"prettier": "^3.4.2",
-		"ts-jest": "^29.2.5",
-		"ts-node": "^10.9.2",
-		"typescript": "^5.7.2"
-	},
-	"files": [
-		"dist",
-		"README.md",
-		"LICENSE"
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/ariadng/sheets.git"
-	},
-	"bugs": {
-		"url": "https://github.com/ariadng/sheets/issues"
-	},
-	"homepage": "https://github.com/ariadng/sheets#readme"
+    "name": "@ariadng/sheets",
+    "version": "0.3.0",
+    "description": "Google Sheets CLI and API client. Read spreadsheet data from the command line or Node.js. No external SDK required.",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "sheets": "bin/sheets.js"
+    },
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "bin",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx watch src/cli.ts",
+        "start": "node dist/cli.js",
+        "test": "echo \"No tests yet\" && exit 0",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "google-sheets",
+        "google",
+        "sheets",
+        "spreadsheet",
+        "api",
+        "cli",
+        "command-line",
+        "oauth",
+        "service-account",
+        "read",
+        "data"
+    ],
+    "author": "Aria Dhanang",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ariadng/sheets.git"
+    },
+    "homepage": "https://github.com/ariadng/sheets#readme",
+    "bugs": {
+        "url": "https://github.com/ariadng/sheets/issues"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "tsx": "^4.0.0",
+        "typescript": "^5.0.0"
+    }
 }

package/dist/advanced/index.d.ts

@@ -1,5 +0,0 @@
-export { AdaptiveRateLimiter, TokenBucketRateLimiter, withAdaptiveRateLimit, withTokenBucketRateLimit, } from './rate-limit';
-export { MetricsCollector, PerformanceMonitor, withMetrics, } from './metrics';
-export type { Metrics } from './metrics';
-export * from '../plus';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/advanced/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACX,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,cAAc,SAAS,CAAC"}