@kubun/connector-google-contacts 0.10.0 → 0.12.0

package/lib/actions.js

@@ -1 +1,20 @@
-import{createContact as e,updateContact as c}from"./api.js";export function createGoogleContactsActionHandler(t){return{create:async(c,a)=>e({accessToken:t.credential.accessToken,params:a,fetch:t.fetch}),update:async(e,a,n)=>c({accessToken:t.credential.accessToken,sourceID:a,params:n,fetch:t.fetch})}}
+import { createContact, updateContact } from './api.js';
+export function createGoogleContactsActionHandler(config) {
+    return {
+        async create (_model, params) {
+            return createContact({
+                accessToken: config.credential.accessToken,
+                params,
+                fetch: config.fetch
+            });
+        },
+        async update (_model, sourceID, params) {
+            return updateContact({
+                accessToken: config.credential.accessToken,
+                sourceID,
+                params,
+                fetch: config.fetch
+            });
+        }
+    };
+}

package/lib/api.js

@@ -1 +1,141 @@
-let e="names,emailAddresses,phoneNumbers,organizations,photos",o="https://people.googleapis.com/v1";async function a(e){try{let o=await e.json();return o.error?.message??`${e.status} ${e.statusText}`}catch{return`${e.status} ${e.statusText}`}}export function buildListURL(a){let t=new URL(`${o}/people/me/connections`);return t.searchParams.set("personFields",e),t.searchParams.set("pageSize",String(a.pageSize??100)),null!=a.syncToken&&t.searchParams.set("syncToken",a.syncToken),t.searchParams.set("requestSyncToken","true"),null!=a.pageToken&&t.searchParams.set("pageToken",a.pageToken),t.toString()}export function mapPersonToEntity(e){return{sourceService:"google-contacts",sourceID:e.resourceName,displayName:e.names?.[0]?.displayName??"",email:e.emailAddresses?.[0]?.value??void 0,phoneNumber:e.phoneNumbers?.[0]?.value??void 0,organization:e.organizations?.[0]?.name??void 0,jobTitle:e.organizations?.[0]?.title??void 0,photoURL:e.photos?.[0]?.url??void 0,sourceURL:`https://contacts.google.com/person/${e.resourceName.replace("people/","")}`}}export function buildPersonFromParams(e){let o={};return null!=e.displayName&&(o.names=[{givenName:e.displayName}]),null!=e.email&&(o.emailAddresses=[{value:e.email}]),null!=e.phoneNumber&&(o.phoneNumbers=[{value:e.phoneNumber}]),(null!=e.organization||null!=e.jobTitle)&&(o.organizations=[{...null!=e.organization?{name:e.organization}:{},...null!=e.jobTitle?{title:e.jobTitle}:{}}]),o}export async function createContact(t){let n=t.fetch??globalThis.fetch,r=buildPersonFromParams(t.params),s=await n(`${o}/people:createContact?personFields=${e}`,{method:"POST",headers:{Authorization:`Bearer ${t.accessToken}`,"Content-Type":"application/json"},body:JSON.stringify(r)});if(!s.ok){let e=await a(s);throw Error(`Google People API error: ${e}`)}return mapPersonToEntity(await s.json())}export async function updateContact(t){let n=t.fetch??globalThis.fetch,r=`${o}/${t.sourceID}?personFields=${e}`,s=await n(r,{headers:{Authorization:`Bearer ${t.accessToken}`}});if(!s.ok){let e=await a(s);throw Error(`Google People API error: ${e}`)}let i=await s.json(),l=buildPersonFromParams(t.params);l.etag=i.etag;let u=[];null!=l.names&&u.push("names"),null!=l.emailAddresses&&u.push("emailAddresses"),null!=l.phoneNumbers&&u.push("phoneNumbers"),null!=l.organizations&&u.push("organizations");let p=`${o}/${t.sourceID}:updateContact?updatePersonFields=${u.join(",")}&personFields=${e}`,c=await n(p,{method:"PATCH",headers:{Authorization:`Bearer ${t.accessToken}`,"Content-Type":"application/json"},body:JSON.stringify(l)});if(!c.ok){let e=await a(c);throw Error(`Google People API error: ${e}`)}return mapPersonToEntity(await c.json())}
+const PERSON_FIELDS = 'names,emailAddresses,phoneNumbers,organizations,photos';
+const CONTACTS_BASE_URL = 'https://people.googleapis.com/v1';
+// A Google People API resource name is `people/{id}`. A sourceID reaches here
+// from caller-controlled GraphQL input and is interpolated straight into the
+// request path, so anything outside this shape (path traversal, extra segments,
+// query injection) is rejected before a URL is built.
+const SOURCE_ID_PATTERN = /^people\/[A-Za-z0-9_-]+$/;
+function assertValidSourceID(sourceID) {
+    if (!SOURCE_ID_PATTERN.test(sourceID)) {
+        throw new Error(`Invalid contact sourceID: ${JSON.stringify(sourceID)}`);
+    }
+}
+async function parseGoogleError(response) {
+    try {
+        const body = await response.json();
+        return body.error?.message ?? `${response.status} ${response.statusText}`;
+    } catch  {
+        return `${response.status} ${response.statusText}`;
+    }
+}
+export function buildListURL(params) {
+    const url = new URL(`${CONTACTS_BASE_URL}/people/me/connections`);
+    url.searchParams.set('personFields', PERSON_FIELDS);
+    url.searchParams.set('pageSize', String(params.pageSize ?? 100));
+    if (params.syncToken != null) {
+        url.searchParams.set('syncToken', params.syncToken);
+        url.searchParams.set('requestSyncToken', 'true');
+    } else {
+        url.searchParams.set('requestSyncToken', 'true');
+    }
+    if (params.pageToken != null) {
+        url.searchParams.set('pageToken', params.pageToken);
+    }
+    return url.toString();
+}
+export function mapPersonToEntity(person) {
+    return {
+        sourceService: 'google-contacts',
+        sourceID: person.resourceName,
+        displayName: person.names?.[0]?.displayName ?? '',
+        email: person.emailAddresses?.[0]?.value ?? undefined,
+        phoneNumber: person.phoneNumbers?.[0]?.value ?? undefined,
+        organization: person.organizations?.[0]?.name ?? undefined,
+        jobTitle: person.organizations?.[0]?.title ?? undefined,
+        photoURL: person.photos?.[0]?.url ?? undefined,
+        sourceURL: `https://contacts.google.com/person/${person.resourceName.replace('people/', '')}`
+    };
+}
+export function buildPersonFromParams(params) {
+    const person = {};
+    if (params.displayName != null) {
+        person.names = [
+            {
+                givenName: params.displayName
+            }
+        ];
+    }
+    if (params.email != null) {
+        person.emailAddresses = [
+            {
+                value: params.email
+            }
+        ];
+    }
+    if (params.phoneNumber != null) {
+        person.phoneNumbers = [
+            {
+                value: params.phoneNumber
+            }
+        ];
+    }
+    if (params.organization != null || params.jobTitle != null) {
+        person.organizations = [
+            {
+                ...params.organization != null ? {
+                    name: params.organization
+                } : {},
+                ...params.jobTitle != null ? {
+                    title: params.jobTitle
+                } : {}
+            }
+        ];
+    }
+    return person;
+}
+export async function createContact(options) {
+    const fetchFn = options.fetch ?? globalThis.fetch;
+    const person = buildPersonFromParams(options.params);
+    const response = await fetchFn(`${CONTACTS_BASE_URL}/people:createContact?personFields=${PERSON_FIELDS}`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${options.accessToken}`,
+            'Content-Type': 'application/json'
+        },
+        body: JSON.stringify(person)
+    });
+    if (!response.ok) {
+        const errorMessage = await parseGoogleError(response);
+        throw new Error(`Google People API error: ${errorMessage}`);
+    }
+    const created = await response.json();
+    return mapPersonToEntity(created);
+}
+export async function updateContact(options) {
+    assertValidSourceID(options.sourceID);
+    const fetchFn = options.fetch ?? globalThis.fetch;
+    // Fetch current person to get etag (required by Google People API for updates)
+    const getURL = `${CONTACTS_BASE_URL}/${options.sourceID}?personFields=${PERSON_FIELDS}`;
+    const getResponse = await fetchFn(getURL, {
+        headers: {
+            Authorization: `Bearer ${options.accessToken}`
+        }
+    });
+    if (!getResponse.ok) {
+        const errorMessage = await parseGoogleError(getResponse);
+        throw new Error(`Google People API error: ${errorMessage}`);
+    }
+    const current = await getResponse.json();
+    const person = buildPersonFromParams(options.params);
+    person.etag = current.etag;
+    const updatePersonFields = [];
+    if (person.names != null) updatePersonFields.push('names');
+    if (person.emailAddresses != null) updatePersonFields.push('emailAddresses');
+    if (person.phoneNumbers != null) updatePersonFields.push('phoneNumbers');
+    if (person.organizations != null) updatePersonFields.push('organizations');
+    const url = `${CONTACTS_BASE_URL}/${options.sourceID}:updateContact?updatePersonFields=${updatePersonFields.join(',')}&personFields=${PERSON_FIELDS}`;
+    const response = await fetchFn(url, {
+        method: 'PATCH',
+        headers: {
+            Authorization: `Bearer ${options.accessToken}`,
+            'Content-Type': 'application/json'
+        },
+        body: JSON.stringify(person)
+    });
+    if (!response.ok) {
+        const errorMessage = await parseGoogleError(response);
+        throw new Error(`Google People API error: ${errorMessage}`);
+    }
+    const updated = await response.json();
+    return mapPersonToEntity(updated);
+}

package/lib/connector.js

@@ -1 +1,97 @@
-import{createGoogleContactsActionHandler as e}from"./actions.js";import{googleContactsClusters as t}from"./model.js";import{createGoogleContactsProvider as o}from"./provider.js";export function createGoogleContactsConnector(r){return{name:"google-contacts",version:"1.0.0",clusters:t,syncStrategies:["on-demand"],auth:{provider:"google",scopes:["https://www.googleapis.com/auth/contacts.readonly"],writeScopes:["https://www.googleapis.com/auth/contacts"]},actions:[{name:"create",description:"Create a new Google Contact",entityModel:"GoogleContact",requiresCredential:!0,input:{type:"object",properties:{displayName:{type:"string"},email:{type:"string"},phoneNumber:{type:"string"},organization:{type:"string"},jobTitle:{type:"string"}},required:["displayName"]}},{name:"update",description:"Update an existing Google Contact",entityModel:"GoogleContact",requiresCredential:!0,input:{type:"object",properties:{sourceID:{type:"string"},displayName:{type:"string"},email:{type:"string"},phoneNumber:{type:"string"},organization:{type:"string"},jobTitle:{type:"string"}},required:["sourceID"]}}],actionHandler:t=>e({credential:t.credential,fetch:r?.fetch}),serverProvider:e=>o({credential:e.credential,fetch:r?.fetch})}}
+import { createGoogleContactsActionHandler } from './actions.js';
+import { googleContactsClusters } from './model.js';
+import { createGoogleContactsProvider } from './provider.js';
+export function createGoogleContactsConnector(options) {
+    return {
+        name: 'google-contacts',
+        version: '1.0.0',
+        clusters: googleContactsClusters,
+        syncStrategies: [
+            'on-demand'
+        ],
+        auth: {
+            provider: 'google',
+            scopes: [
+                'https://www.googleapis.com/auth/contacts.readonly'
+            ],
+            writeScopes: [
+                'https://www.googleapis.com/auth/contacts'
+            ]
+        },
+        actions: [
+            {
+                name: 'create',
+                description: 'Create a new Google Contact',
+                entityModel: 'GoogleContact',
+                requiresCredential: true,
+                input: {
+                    type: 'object',
+                    properties: {
+                        displayName: {
+                            type: 'string'
+                        },
+                        email: {
+                            type: 'string'
+                        },
+                        phoneNumber: {
+                            type: 'string'
+                        },
+                        organization: {
+                            type: 'string'
+                        },
+                        jobTitle: {
+                            type: 'string'
+                        }
+                    },
+                    required: [
+                        'displayName'
+                    ]
+                }
+            },
+            {
+                name: 'update',
+                description: 'Update an existing Google Contact',
+                entityModel: 'GoogleContact',
+                requiresCredential: true,
+                input: {
+                    type: 'object',
+                    properties: {
+                        sourceID: {
+                            type: 'string'
+                        },
+                        displayName: {
+                            type: 'string'
+                        },
+                        email: {
+                            type: 'string'
+                        },
+                        phoneNumber: {
+                            type: 'string'
+                        },
+                        organization: {
+                            type: 'string'
+                        },
+                        jobTitle: {
+                            type: 'string'
+                        }
+                    },
+                    required: [
+                        'sourceID'
+                    ]
+                }
+            }
+        ],
+        actionHandler: (config)=>{
+            return createGoogleContactsActionHandler({
+                credential: config.credential,
+                fetch: options?.fetch
+            });
+        },
+        serverProvider: (config)=>{
+            return createGoogleContactsProvider({
+                credential: config.credential,
+                fetch: options?.fetch
+            });
+        }
+    };
+}

package/lib/index.js

@@ -1 +1,5 @@
-export{createGoogleContactsActionHandler}from"./actions.js";export{buildListURL,buildPersonFromParams,createContact,mapPersonToEntity,updateContact}from"./api.js";export{createGoogleContactsConnector}from"./connector.js";export{googleContactDefinition,googleContactsClusters}from"./model.js";export{createGoogleContactsProvider}from"./provider.js";
+export { createGoogleContactsActionHandler } from './actions.js';
+export { buildListURL, buildPersonFromParams, createContact, mapPersonToEntity, updateContact } from './api.js';
+export { createGoogleContactsConnector } from './connector.js';
+export { googleContactDefinition, googleContactsClusters } from './model.js';
+export { createGoogleContactsProvider } from './provider.js';

package/lib/model.js

@@ -1 +1,79 @@
-import{connectorClusters as e,connectorModelIDs as t}from"@kubun/connector";import{modelIDs as o,modelsClusters as i}from"@kubun/models";import{GraphBuilder as r}from"@kubun/protocol";import{dateTimeSchema as n,urlSchema as s}from"@kubun/scalars";export const googleContactDefinition={name:"GoogleContact",behavior:"default",interfaces:[t.ExternalEntity,o.ContactKind],schema:{type:"object",properties:{displayName:{type:"string"},sourceService:{$ref:"#/definitions/SourceService"},sourceID:{$ref:"#/definitions/SourceID"},lastSyncedAt:{$ref:"#/definitions/DateTime"},sourceURL:{$ref:"#/definitions/SourceURL"},email:{type:"string"},phoneNumber:{type:"string"},organization:{type:"string"},jobTitle:{type:"string"},photoURL:{$ref:"#/definitions/PhotoURL"}},required:["sourceService","sourceID","lastSyncedAt"],additionalProperties:!1,definitions:{SourceService:{type:"string",title:"SourceService",minLength:1,maxLength:50},SourceID:{type:"string",title:"SourceID",minLength:1,maxLength:500},SourceURL:s,PhotoURL:s,DateTime:n}},fieldsMeta:{}};let c=new r({externalClusters:{...e,...i}});c.add(googleContactDefinition);export const googleContactsClusters=c.build();
+import { connectorClusters, connectorModelIDs } from '@kubun/connector';
+import { modelIDs, modelsClusters } from '@kubun/models';
+import { GraphBuilder } from '@kubun/protocol';
+import { dateTimeSchema, urlSchema } from '@kubun/scalars';
+export const googleContactDefinition = {
+    name: 'GoogleContact',
+    behavior: 'default',
+    interfaces: [
+        connectorModelIDs.ExternalEntity,
+        modelIDs.ContactKind
+    ],
+    schema: {
+        type: 'object',
+        properties: {
+            displayName: {
+                type: 'string'
+            },
+            sourceService: {
+                $ref: '#/definitions/SourceService'
+            },
+            sourceID: {
+                $ref: '#/definitions/SourceID'
+            },
+            lastSyncedAt: {
+                $ref: '#/definitions/DateTime'
+            },
+            sourceURL: {
+                $ref: '#/definitions/SourceURL'
+            },
+            email: {
+                type: 'string'
+            },
+            phoneNumber: {
+                type: 'string'
+            },
+            organization: {
+                type: 'string'
+            },
+            jobTitle: {
+                type: 'string'
+            },
+            photoURL: {
+                $ref: '#/definitions/PhotoURL'
+            }
+        },
+        required: [
+            'sourceService',
+            'sourceID',
+            'lastSyncedAt'
+        ],
+        additionalProperties: false,
+        definitions: {
+            SourceService: {
+                type: 'string',
+                title: 'SourceService',
+                minLength: 1,
+                maxLength: 50
+            },
+            SourceID: {
+                type: 'string',
+                title: 'SourceID',
+                minLength: 1,
+                maxLength: 500
+            },
+            SourceURL: urlSchema,
+            PhotoURL: urlSchema,
+            DateTime: dateTimeSchema
+        }
+    },
+    fieldsMeta: {}
+};
+const builder = new GraphBuilder({
+    externalClusters: {
+        ...connectorClusters,
+        ...modelsClusters
+    }
+});
+builder.add(googleContactDefinition);
+export const googleContactsClusters = builder.build();

package/lib/provider.js

@@ -1 +1,71 @@
-import{resolveModelID as e}from"@kubun/connector";import{buildListURL as n,mapPersonToEntity as o}from"./api.js";import{googleContactsClusters as t}from"./model.js";let l=e(t,"GoogleContact");export function createGoogleContactsProvider(e){let t=e.fetch??globalThis.fetch;async function a(o){let l=n({pageToken:o.pageToken,syncToken:o.syncToken}),a=await t(l,{headers:{Authorization:`Bearer ${e.credential.accessToken}`},signal:o.signal});if(!a.ok)throw Error(`Google People API error: ${a.status} ${a.statusText}`);return await a.json()}async function*i(e){let n,t;do{let i=await a({pageToken:n,signal:e.signal}),c=(i.connections??[]).map(o);n=i.nextPageToken,t=i.nextSyncToken,yield{modelID:l,entities:c,hasMore:null!=n,checkpoint:t}}while(null!=n)}return{supportedStrategies:["on-demand"],fetchAll:i,async *fetchChanges(e){let n,t=e.checkpoint;if(null==t)return void(yield*i(e));do{let i=await a({pageToken:n,syncToken:null!=n?void 0:t,signal:e.signal}),c=(i.connections??[]).map(o);n=i.nextPageToken,yield{modelID:l,entities:c,hasMore:null!=n,checkpoint:i.nextSyncToken}}while(null!=n)}}}
+import { resolveModelID } from '@kubun/connector';
+import { buildListURL, mapPersonToEntity } from './api.js';
+import { googleContactsClusters } from './model.js';
+const GOOGLE_CONTACT_MODEL_ID = resolveModelID(googleContactsClusters, 'GoogleContact');
+export function createGoogleContactsProvider(config) {
+    const fetchFn = config.fetch ?? globalThis.fetch;
+    async function fetchPage(params) {
+        const url = buildListURL({
+            pageToken: params.pageToken,
+            syncToken: params.syncToken
+        });
+        const response = await fetchFn(url, {
+            headers: {
+                Authorization: `Bearer ${config.credential.accessToken}`
+            },
+            signal: params.signal
+        });
+        if (!response.ok) {
+            throw new Error(`Google People API error: ${response.status} ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    async function* fetchAllEntities(params) {
+        let pageToken;
+        let syncToken;
+        do {
+            const data = await fetchPage({
+                pageToken,
+                signal: params.signal
+            });
+            const entities = (data.connections ?? []).map(mapPersonToEntity);
+            pageToken = data.nextPageToken;
+            syncToken = data.nextSyncToken;
+            yield {
+                modelID: GOOGLE_CONTACT_MODEL_ID,
+                entities,
+                hasMore: pageToken != null,
+                checkpoint: syncToken
+            };
+        }while (pageToken != null)
+    }
+    return {
+        supportedStrategies: [
+            'on-demand'
+        ],
+        fetchAll: fetchAllEntities,
+        async *fetchChanges (params) {
+            const syncToken = params.checkpoint;
+            if (syncToken == null) {
+                yield* fetchAllEntities(params);
+                return;
+            }
+            let pageToken;
+            do {
+                const data = await fetchPage({
+                    pageToken,
+                    syncToken: pageToken != null ? undefined : syncToken,
+                    signal: params.signal
+                });
+                const entities = (data.connections ?? []).map(mapPersonToEntity);
+                pageToken = data.nextPageToken;
+                yield {
+                    modelID: GOOGLE_CONTACT_MODEL_ID,
+                    entities,
+                    hasMore: pageToken != null,
+                    checkpoint: data.nextSyncToken
+                };
+            }while (pageToken != null)
+        }
+    };
+}

package/package.json

@@ -1,34 +1,34 @@
 {
   "name": "@kubun/connector-google-contacts",
-  "version": "0.10.0",
-  "license": "see LICENSE.md",
+  "version": "0.12.0",
   "keywords": [],
+  "license": "see LICENSE.md",
+  "sideEffects": false,
   "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
   "exports": {
     ".": "./lib/index.js"
   },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
   "files": [
     "lib/*",
     "LICENSE.md"
   ],
-  "sideEffects": false,
   "dependencies": {
-    "@kubun/models": "^0.10.0",
-    "@kubun/protocol": "^0.10.0",
-    "@kubun/connector": "^0.10.0",
-    "@kubun/provider-google": "^0.10.0",
-    "@kubun/scalars": "^0.10.0"
+    "@kubun/connector": "^0.12.0",
+    "@kubun/models": "^0.12.0",
+    "@kubun/protocol": "^0.12.0",
+    "@kubun/scalars": "^0.12.0",
+    "@kubun/provider-google": "^0.12.0"
   },
   "scripts": {
+    "build": "pnpm run build:clean && pnpm run build:js && pnpm run build:types",
     "build:clean": "del lib",
-    "build:js": "swc src -d ./lib --config-file ../../swc.json --strip-leading-paths",
+    "build:js": "swc src -d ./lib --config-file ../../node_modules/@kigu/dev/swc.json --strip-leading-paths",
     "build:types": "tsc --emitDeclarationOnly --skipLibCheck",
     "build:types:ci": "tsc --emitDeclarationOnly --declarationMap false",
-    "build": "pnpm run build:clean && pnpm run build:js && pnpm run build:types",
+    "test": "pnpm run test:types && pnpm run test:unit",
     "test:types": "tsc --noEmit -p tsconfig.test.json",
-    "test:unit": "vitest run",
-    "test": "pnpm run test:types && pnpm run test:unit"
+    "test:unit": "vitest run"
   }
 }