Google Contact Saver

CLI tool dan library Node.js untuk menyimpan kontak ke Google Contacts dengan normalisasi nomor telepon (e.g., 08123456789 → +628123456789).

Fitur

• Normalisasi nomor telepon otomatis.
• Cek duplikat sebelum menyimpan.
• Enkripsi token OAuth.
• Validasi input nama dan nomor.
• Logging terstruktur dengan pino.
• Batch insert untuk menyimpan banyak kontak sekaligus.
• Dukungan CLI dan programmatic.

Instalasi

Global (CLI)

npm install -g google-contact-saver

Local (Project)

npm install google-contact-saver

Setup Google API

1. Aktifkan Google People API dan unduh google-credentials.json dari Google Cloud Console.
2. Letakkan google-credentials.json di root project atau direktori kerja.
3. Jalankan perintah login:

   google-contact-saver login

Penggunaan

CLI

Login

google-contact-saver login

Simpan Kontak Tunggal

google-contact-saver save --nama "John Doe" --nomor "08123456789"

Simpan Banyak Kontak

Buat file kontaks.json:

[
  { "nama": "John Doe", "nomor": "08123456789" },
  { "nama": "Jane Smith", "nomor": "08134567890" }
]

Jalankan perintah:

google-contact-saver batch --file kontaks.json

Programmatic (Node.js)

Simpan Kontak Tunggal

const { simpanKontak } = require("google-contact-saver");

simpanKontak({ nama: "John Doe", nomor: "08123456789" })
  .then(console.log)
  .catch(console.error);

Simpan Banyak Kontak

const { simpanBanyakKontak } = require("google-contact-saver");

const kontaks = [
  { nama: "John Doe", nomor: "08123456789" },
  { nama: "Jane Smith", nomor: "08134567890" }
];

simpanBanyakKontak(kontaks)
  .then(console.log)
  .catch(console.error);

Logging

• Menggunakan pino untuk logging terstruktur.
• Level logging dapat dikonfigurasi via environment variable:

  LOG_LEVEL=debug google-contact-saver save --nama "John" --nomor "08123456789"

CLI Commands

| Perintah | Deskripsi | Contoh | |-----------|--------------------------------------------|---------------------------------------------| | login | Autentikasi OAuth dengan Google. | google-contact-saver login | | save | Simpan kontak tunggal. | google-contact-saver save --nama "John" --nomor "08123456789" | | batch | Simpan banyak kontak dari file JSON. | google-contact-saver batch --file kontaks.json |

Troubleshooting

Error: "Token tidak ditemukan"

• Pastikan Anda sudah menjalankan:

  google-contact-saver login

Error: "Nomor tidak valid"

• Pastikan nomor telepon hanya mengandung angka, spasi, +, -, atau ().
• Contoh nomor valid:
  • 08123456789
  • +628123456789
  • 0812-3456-789

Update Package

Jika ada pembaruan, update package dengan:

npm update -g google-contact-saver