@bobfrankston/gcards 0.1.2 → 0.1.5

package/{types.ts → glib/types.ts}

@@ -1,305 +1,305 @@
-/**
- * Google People API Type Definitions
- * Reference: https://developers.google.com/people/api/rest/v1/people
- */
-
-// ============================================================
-// Google People API Response Types (from API)
-// ============================================================
-
-export interface GooglePersonMetadata {
-    sources?: Array<{
-        type: string;              // "CONTACT", "PROFILE", "DOMAIN_PROFILE"
-        id: string;
-        etag?: string;
-        updateTime?: string;
-    }>;
-    previousResourceNames?: string[];
-    linkedPeopleResourceNames?: string[];
-    deleted?: boolean;
-}
-
-export interface GoogleName {
-    metadata?: FieldMetadata;
-    displayName?: string;
-    displayNameLastFirst?: string;
-    familyName?: string;
-    givenName?: string;
-    middleName?: string;
-    honorificPrefix?: string;
-    honorificSuffix?: string;
-    phoneticFullName?: string;
-    phoneticFamilyName?: string;
-    phoneticGivenName?: string;
-    phoneticMiddleName?: string;
-    phoneticHonorificPrefix?: string;
-    phoneticHonorificSuffix?: string;
-    unstructuredName?: string;
-}
-
-export interface GoogleNickname {
-    metadata?: FieldMetadata;
-    value?: string;
-    type?: string;  // "DEFAULT", "MAIDEN_NAME", "INITIALS", etc.
-}
-
-export interface GoogleEmailAddress {
-    metadata?: FieldMetadata;
-    value?: string;
-    type?: string;           // "home", "work", "other"
-    formattedType?: string;
-    displayName?: string;
-}
-
-export interface GooglePhoneNumber {
-    metadata?: FieldMetadata;
-    value?: string;
-    canonicalForm?: string;  // E.164 format
-    type?: string;           // "home", "work", "mobile", etc.
-    formattedType?: string;
-}
-
-export interface GoogleAddress {
-    metadata?: FieldMetadata;
-    formattedValue?: string;
-    type?: string;
-    formattedType?: string;
-    poBox?: string;
-    streetAddress?: string;
-    extendedAddress?: string;
-    city?: string;
-    region?: string;
-    postalCode?: string;
-    country?: string;
-    countryCode?: string;
-}
-
-export interface GoogleOrganization {
-    metadata?: FieldMetadata;
-    type?: string;
-    formattedType?: string;
-    name?: string;
-    department?: string;
-    title?: string;
-    jobDescription?: string;
-    symbol?: string;
-    phoneticName?: string;
-    location?: string;
-    startDate?: GoogleDate;
-    endDate?: GoogleDate;
-    current?: boolean;
-}
-
-export interface GoogleBiography {
-    metadata?: FieldMetadata;
-    value?: string;
-    contentType?: string;  // "TEXT_PLAIN", "TEXT_HTML"
-}
-
-export interface GoogleUrl {
-    metadata?: FieldMetadata;
-    value?: string;
-    type?: string;
-    formattedType?: string;
-}
-
-export interface GooglePhoto {
-    metadata?: FieldMetadata;
-    url?: string;
-    default?: boolean;
-}
-
-export interface GoogleBirthday {
-    metadata?: FieldMetadata;
-    date?: GoogleDate;
-    text?: string;
-}
-
-export interface GoogleDate {
-    year?: number;
-    month?: number;
-    day?: number;
-}
-
-export interface GoogleEvent {
-    metadata?: FieldMetadata;
-    date?: GoogleDate;
-    type?: string;
-    formattedType?: string;
-}
-
-export interface GoogleRelation {
-    metadata?: FieldMetadata;
-    person?: string;
-    type?: string;
-    formattedType?: string;
-}
-
-export interface GoogleMembership {
-    metadata?: FieldMetadata;
-    contactGroupMembership?: {
-        contactGroupId?: string;
-        contactGroupResourceName?: string;
-    };
-    domainMembership?: {
-        inViewerDomain?: boolean;
-    };
-}
-
-export interface GoogleUserDefined {
-    metadata?: FieldMetadata;
-    key?: string;
-    value?: string;
-}
-
-export interface FieldMetadata {
-    primary?: boolean;
-    verified?: boolean;
-    source?: {
-        type: string;
-        id: string;
-    };
-    sourcePrimary?: boolean;
-}
-
-/**
- * Full Google Person resource as returned by People API
- */
-export interface GooglePerson {
-    resourceName: string;          // e.g., "people/c1234567890"
-    etag?: string;
-    metadata?: GooglePersonMetadata;
-    names?: GoogleName[];
-    nicknames?: GoogleNickname[];
-    photos?: GooglePhoto[];
-    birthdays?: GoogleBirthday[];
-    addresses?: GoogleAddress[];
-    emailAddresses?: GoogleEmailAddress[];
-    phoneNumbers?: GooglePhoneNumber[];
-    organizations?: GoogleOrganization[];
-    biographies?: GoogleBiography[];
-    urls?: GoogleUrl[];
-    events?: GoogleEvent[];
-    relations?: GoogleRelation[];
-    memberships?: GoogleMembership[];
-    userDefined?: GoogleUserDefined[];
-    imClients?: Array<{
-        metadata?: FieldMetadata;
-        username?: string;
-        type?: string;
-        formattedType?: string;
-        protocol?: string;
-        formattedProtocol?: string;
-    }>;
-    sipAddresses?: Array<{
-        metadata?: FieldMetadata;
-        value?: string;
-        type?: string;
-        formattedType?: string;
-    }>;
-    fileAses?: Array<{
-        metadata?: FieldMetadata;
-        value?: string;
-    }>;
-}
-
-export interface GoogleConnectionsResponse {
-    connections?: GooglePerson[];
-    nextPageToken?: string;
-    nextSyncToken?: string;
-    totalPeople?: number;
-    totalItems?: number;
-}
-
-// ============================================================
-// Local Simplified Format (for analysis/cleanup)
-// ============================================================
-
-export interface LocalContact {
-    // Identity & reconciliation
-    resourceName: string;          // From Google - used for updates
-    etag?: string;                 // For conflict detection
-
-    // Core identity
-    displayName: string;
-    givenName?: string;
-    familyName?: string;
-    nickname?: string;
-
-    // Contact info (flattened, typed arrays)
-    emails: Array<{ value: string; type?: string; primary?: boolean }>;
-    phones: Array<{ value: string; type?: string; primary?: boolean }>;
-    addresses: Array<{
-        formatted?: string;
-        street?: string;
-        city?: string;
-        region?: string;
-        postalCode?: string;
-        country?: string;
-        type?: string;
-    }>;
-
-    // Professional
-    organizations: Array<{
-        name?: string;
-        title?: string;
-        department?: string;
-    }>;
-
-    // Social/web
-    urls: Array<{ value: string; type?: string }>;
-
-    // Dates
-    birthday?: { year?: number; month?: number; day?: number };
-
-    // Notes
-    notes?: string;
-
-    // Groups
-    groups: string[];              // contactGroupResourceNames
-
-    // Metadata for cleanup
-    _meta: {
-        sourceType: string;        // "CONTACT", "PROFILE", etc.
-        updateTime?: string;
-        isTestEntry?: boolean;     // Flagged as test (m-XXXX@bob.ma pattern)
-        duplicateOf?: string[];    // resourceNames of potential duplicates
-        mergeConfidence?: number;  // 0-1 confidence for merge candidates
-    };
-}
-
-// ============================================================
-// Cleanup Analysis Types
-// ============================================================
-
-export interface DuplicateGroup {
-    primary: string;               // resourceName of "best" contact
-    duplicates: string[];          // resourceNames to merge into primary
-    confidence: number;            // 0-1 merge confidence
-    matchReasons: string[];        // Why these are considered duplicates
-}
-
-export interface CleanupReport {
-    totalContacts: number;
-    testEntries: LocalContact[];   // To be deleted
-    duplicateGroups: DuplicateGroup[];
-    emptyContacts: LocalContact[]; // No useful info
-    suggestions: string[];         // Human-readable recommendations
-}
-
-// ============================================================
-// Deletion Logging (for tracking cleanup history)
-// ============================================================
-
-export interface DeletionRecord {
-    resourceName: string;
-    displayName: string;
-    reason: string;                // "test_entry", "duplicate_of:people/cXXX", "empty", etc.
-    deletedAt: string;             // ISO timestamp
-    originalData: LocalContact;    // Snapshot before deletion
-}
-
-export interface DeletionLog {
-    deletions: DeletionRecord[];
-    lastUpdated: string;           // ISO timestamp
-}
+/**
+ * Google People API Type Definitions
+ * Reference: https://developers.google.com/people/api/rest/v1/people
+ */
+
+// ============================================================
+// Google People API Response Types (from API)
+// ============================================================
+
+export interface GooglePersonMetadata {
+    sources?: Array<{
+        type: string;              // "CONTACT", "PROFILE", "DOMAIN_PROFILE"
+        id: string;
+        etag?: string;
+        updateTime?: string;
+    }>;
+    previousResourceNames?: string[];
+    linkedPeopleResourceNames?: string[];
+    deleted?: boolean;
+}
+
+export interface GoogleName {
+    metadata?: FieldMetadata;
+    displayName?: string;
+    displayNameLastFirst?: string;
+    familyName?: string;
+    givenName?: string;
+    middleName?: string;
+    honorificPrefix?: string;
+    honorificSuffix?: string;
+    phoneticFullName?: string;
+    phoneticFamilyName?: string;
+    phoneticGivenName?: string;
+    phoneticMiddleName?: string;
+    phoneticHonorificPrefix?: string;
+    phoneticHonorificSuffix?: string;
+    unstructuredName?: string;
+}
+
+export interface GoogleNickname {
+    metadata?: FieldMetadata;
+    value?: string;
+    type?: string;  // "DEFAULT", "MAIDEN_NAME", "INITIALS", etc.
+}
+
+export interface GoogleEmailAddress {
+    metadata?: FieldMetadata;
+    value?: string;
+    type?: string;           // "home", "work", "other"
+    formattedType?: string;
+    displayName?: string;
+}
+
+export interface GooglePhoneNumber {
+    metadata?: FieldMetadata;
+    value?: string;
+    canonicalForm?: string;  // E.164 format
+    type?: string;           // "home", "work", "mobile", etc.
+    formattedType?: string;
+}
+
+export interface GoogleAddress {
+    metadata?: FieldMetadata;
+    formattedValue?: string;
+    type?: string;
+    formattedType?: string;
+    poBox?: string;
+    streetAddress?: string;
+    extendedAddress?: string;
+    city?: string;
+    region?: string;
+    postalCode?: string;
+    country?: string;
+    countryCode?: string;
+}
+
+export interface GoogleOrganization {
+    metadata?: FieldMetadata;
+    type?: string;
+    formattedType?: string;
+    name?: string;
+    department?: string;
+    title?: string;
+    jobDescription?: string;
+    symbol?: string;
+    phoneticName?: string;
+    location?: string;
+    startDate?: GoogleDate;
+    endDate?: GoogleDate;
+    current?: boolean;
+}
+
+export interface GoogleBiography {
+    metadata?: FieldMetadata;
+    value?: string;
+    contentType?: string;  // "TEXT_PLAIN", "TEXT_HTML"
+}
+
+export interface GoogleUrl {
+    metadata?: FieldMetadata;
+    value?: string;
+    type?: string;
+    formattedType?: string;
+}
+
+export interface GooglePhoto {
+    metadata?: FieldMetadata;
+    url?: string;
+    default?: boolean;
+}
+
+export interface GoogleBirthday {
+    metadata?: FieldMetadata;
+    date?: GoogleDate;
+    text?: string;
+}
+
+export interface GoogleDate {
+    year?: number;
+    month?: number;
+    day?: number;
+}
+
+export interface GoogleEvent {
+    metadata?: FieldMetadata;
+    date?: GoogleDate;
+    type?: string;
+    formattedType?: string;
+}
+
+export interface GoogleRelation {
+    metadata?: FieldMetadata;
+    person?: string;
+    type?: string;
+    formattedType?: string;
+}
+
+export interface GoogleMembership {
+    metadata?: FieldMetadata;
+    contactGroupMembership?: {
+        contactGroupId?: string;
+        contactGroupResourceName?: string;
+    };
+    domainMembership?: {
+        inViewerDomain?: boolean;
+    };
+}
+
+export interface GoogleUserDefined {
+    metadata?: FieldMetadata;
+    key?: string;
+    value?: string;
+}
+
+export interface FieldMetadata {
+    primary?: boolean;
+    verified?: boolean;
+    source?: {
+        type: string;
+        id: string;
+    };
+    sourcePrimary?: boolean;
+}
+
+/**
+ * Full Google Person resource as returned by People API
+ */
+export interface GooglePerson {
+    resourceName: string;          // e.g., "people/c1234567890"
+    etag?: string;
+    metadata?: GooglePersonMetadata;
+    names?: GoogleName[];
+    nicknames?: GoogleNickname[];
+    photos?: GooglePhoto[];
+    birthdays?: GoogleBirthday[];
+    addresses?: GoogleAddress[];
+    emailAddresses?: GoogleEmailAddress[];
+    phoneNumbers?: GooglePhoneNumber[];
+    organizations?: GoogleOrganization[];
+    biographies?: GoogleBiography[];
+    urls?: GoogleUrl[];
+    events?: GoogleEvent[];
+    relations?: GoogleRelation[];
+    memberships?: GoogleMembership[];
+    userDefined?: GoogleUserDefined[];
+    imClients?: Array<{
+        metadata?: FieldMetadata;
+        username?: string;
+        type?: string;
+        formattedType?: string;
+        protocol?: string;
+        formattedProtocol?: string;
+    }>;
+    sipAddresses?: Array<{
+        metadata?: FieldMetadata;
+        value?: string;
+        type?: string;
+        formattedType?: string;
+    }>;
+    fileAses?: Array<{
+        metadata?: FieldMetadata;
+        value?: string;
+    }>;
+}
+
+export interface GoogleConnectionsResponse {
+    connections?: GooglePerson[];
+    nextPageToken?: string;
+    nextSyncToken?: string;
+    totalPeople?: number;
+    totalItems?: number;
+}
+
+// ============================================================
+// Local Simplified Format (for analysis/cleanup)
+// ============================================================
+
+export interface LocalContact {
+    // Identity & reconciliation
+    resourceName: string;          // From Google - used for updates
+    etag?: string;                 // For conflict detection
+
+    // Core identity
+    displayName: string;
+    givenName?: string;
+    familyName?: string;
+    nickname?: string;
+
+    // Contact info (flattened, typed arrays)
+    emails: Array<{ value: string; type?: string; primary?: boolean }>;
+    phones: Array<{ value: string; type?: string; primary?: boolean }>;
+    addresses: Array<{
+        formatted?: string;
+        street?: string;
+        city?: string;
+        region?: string;
+        postalCode?: string;
+        country?: string;
+        type?: string;
+    }>;
+
+    // Professional
+    organizations: Array<{
+        name?: string;
+        title?: string;
+        department?: string;
+    }>;
+
+    // Social/web
+    urls: Array<{ value: string; type?: string }>;
+
+    // Dates
+    birthday?: { year?: number; month?: number; day?: number };
+
+    // Notes
+    notes?: string;
+
+    // Groups
+    groups: string[];              // contactGroupResourceNames
+
+    // Metadata for cleanup
+    _meta: {
+        sourceType: string;        // "CONTACT", "PROFILE", etc.
+        updateTime?: string;
+        isTestEntry?: boolean;     // Flagged as test (m-XXXX@bob.ma pattern)
+        duplicateOf?: string[];    // resourceNames of potential duplicates
+        mergeConfidence?: number;  // 0-1 confidence for merge candidates
+    };
+}
+
+// ============================================================
+// Cleanup Analysis Types
+// ============================================================
+
+export interface DuplicateGroup {
+    primary: string;               // resourceName of "best" contact
+    duplicates: string[];          // resourceNames to merge into primary
+    confidence: number;            // 0-1 merge confidence
+    matchReasons: string[];        // Why these are considered duplicates
+}
+
+export interface CleanupReport {
+    totalContacts: number;
+    testEntries: LocalContact[];   // To be deleted
+    duplicateGroups: DuplicateGroup[];
+    emptyContacts: LocalContact[]; // No useful info
+    suggestions: string[];         // Human-readable recommendations
+}
+
+// ============================================================
+// Deletion Logging (for tracking cleanup history)
+// ============================================================
+
+export interface DeletionRecord {
+    resourceName: string;
+    displayName: string;
+    reason: string;                // "test_entry", "duplicate_of:people/cXXX", "empty", etc.
+    deletedAt: string;             // ISO timestamp
+    originalData: LocalContact;    // Snapshot before deletion
+}
+
+export interface DeletionLog {
+    deletions: DeletionRecord[];
+    lastUpdated: string;           // ISO timestamp
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@bobfrankston/gcards",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Google Contacts cleanup and management tool",
   "type": "module",
   "main": "gcards.ts",
   "bin": {
-    "gcards": "gcards.ts"
+    "gcards": "gcards.ts",
+    "gfix": "gfix.ts"
   },
   "repository": {
     "type": "git",
@@ -16,7 +17,7 @@
     "prerelease:local": "git add -A && (git diff-index --quiet HEAD || git commit -m \"Pre-release commit\")",
     "preversion": "npm run check && git add -A",
     "postversion": "git push && git push --tags",
-    "release": "npm run prerelease:local && npm version patch && npm publish --access public"
+    "release": "npm whoami && npm run prerelease:local && npm version patch && npm publish --access public"
   },
   "keywords": [
     "google",
@@ -27,7 +28,8 @@
   "author": "Bob Frankston",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^22.10.1"
+    "@types/node": "^22.10.1",
+    "tsx": "^4.21.0"
   },
   "dependencies": {
     "@bobfrankston/miscassists": "file:../../../projects/NodeJS/miscassists"