@aglyn/plugins-crm 1.0.0-beta.221 → 1.0.0-beta.222

package/src/lib/transfer/activities.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/transfer/activities.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * WHAT THE TEAM LOGGED, AS A FILE (AGL-3528) — `crm.activities`, exported.\n *\n * Every call, email, meeting and note logged against a contact, a company,\n * a deal or a lead, with who logged it and what it was about: the record of\n * the team's work, taken out to report on or to keep. An activity is\n * logged on a record, as it happens, so the resource is exported and never\n * imported (`directions: [\"export\"]`).\n *=========================================*/\n\nimport {\n  CRM_ACTIVITY_DIRECTION_LABELS,\n  CRM_ACTIVITY_KIND_LABELS,\n  CRM_COLLECTIONS,\n  CRM_EMAIL_DELIVERY_STATE_LABELS,\n  type CrmActivityDirection,\n  type CrmActivityKind,\n  type CrmEmailDeliveryState,\n} from '@aglyn/aglyn/server'\nimport { TRANSFER_ID_FIELD } from '@aglyn/aglyn/data-transfer'\nimport {\n  countCrmExport,\n  crmMemberEmails,\n  crmTransferEnv,\n  type CrmTransferEnv,\n  isoOf,\n  lookupById,\n  lookupResult,\n  pickValues,\n  readCrmExportPage,\n  requireCrmRecords,\n  textOf,\n  type TransferExportHooks,\n  visibleIn,\n} from './common'\nimport { ACTIVITY_TRANSFER_FIELDS, ACTIVITY_TRANSFER_GROUPS, CRM_TIMESTAMP_FIELDS } from './fields'\n\nconst activitiesOf = (env: CrmTransferEnv) => env.orgRef.collection(CRM_COLLECTIONS.activities)\n\n/** The words an export writes for the records an activity is about. */\ninterface ActivityNames {\n  by?: (uid: string) => string | undefined\n  contact?: (id: string) => string | undefined\n  company?: (id: string) => string | undefined\n  deal?: (id: string) => string | undefined\n  lead?: (id: string) => string | undefined\n}\n\n/** One activity as values by field id. */\nexport function activityTransferValues(\n  id: string,\n  activity: Record<string, unknown>,\n  names: ActivityNames = {},\n): Record<string, unknown> {\n  const text = (value: unknown) => textOf(value) || null\n  const link = (value: unknown, resolve?: (id: string) => string | undefined) => {\n    const linked = text(value)\n    return linked ? (resolve?.(linked) ?? linked) : null\n  }\n  const kind = textOf(activity['kind']) as CrmActivityKind\n  const direction = textOf(activity['direction']) as CrmActivityDirection\n  const delivery = textOf(activity['deliveryState']) as CrmEmailDeliveryState\n  return {\n    subject: text(activity['subject']),\n    kind: CRM_ACTIVITY_KIND_LABELS[kind] ?? text(kind),\n    direction: CRM_ACTIVITY_DIRECTION_LABELS[direction] ?? text(direction),\n    at: isoOf(activity['atMs']),\n    body: text(activity['body']),\n    outcome: text(activity['outcome']),\n    durationMinutes: typeof activity['durationMinutes'] === 'number' ? activity['durationMinutes'] : null,\n    by: link(activity['byUid'], names.by) ?? text(activity['byName']),\n    to: text(activity['to']),\n    from: text(activity['from']),\n    deliveryState: CRM_EMAIL_DELIVERY_STATE_LABELS[delivery] ?? text(delivery),\n    contact: link(activity['contactId'], names.contact),\n    company: link(activity['companyId'], names.company),\n    deal: link(activity['dealId'], names.deal),\n    lead: link(activity['leadId'], names.lead),\n    createdAt: isoOf(activity['createdAt']),\n    updatedAt: isoOf(activity['updatedAt']),\n    [TRANSFER_ID_FIELD]: id,\n  }\n}\n\n/** Reads one field of each linked record by id. */\nasync function namesOf(\n  env: CrmTransferEnv,\n  collection: string,\n  ids: Iterable<string>,\n  field: (data: Record<string, unknown>) => string,\n): Promise<Map<string, string>> {\n  const out = new Map<string, string>()\n  const wanted = [...new Set(ids)].filter((id) => id && !id.includes('/'))\n  for (let at = 0; at < wanted.length; at += 500) {\n    const refs = wanted.slice(at, at + 500).map((id) => env.orgRef.collection(collection).doc(id))\n    for (const snapshot of await env.firestore.getAll(...refs)) {\n      if (snapshot.exists) out.set(snapshot.id, field(snapshot.data() ?? {}))\n    }\n  }\n  return out\n}\n\n/** The `crm.activities` hooks: an export, and the reads undo would ask. */\nexport function activitiesTransferResource(): TransferExportHooks {\n  return {\n    fields: () => ({ standard: ACTIVITY_TRANSFER_FIELDS, system: CRM_TIMESTAMP_FIELDS, groups: ACTIVITY_TRANSFER_GROUPS }),\n    matchKeys: [{ fieldId: TRANSFER_ID_FIELD, normalizer: 'aglynId' }],\n\n    async count(ctx, options) {\n      const env = await crmTransferEnv(ctx)\n      requireCrmRecords(env, 'activities')\n      return countCrmExport(env, activitiesOf(env), options, (data) => visibleIn(env, data['visibleTo'], options.scopeTokens))\n    },\n\n    async readPage(ctx, cursor, fieldIds, options) {\n      const env = await crmTransferEnv(ctx)\n      requireCrmRecords(env, 'activities')\n      const emails = fieldIds.includes('by') ? await crmMemberEmails(env.orgId) : new Map<string, string>()\n      return readCrmExportPage(\n        env,\n        activitiesOf(env),\n        cursor,\n        options,\n        (data) => visibleIn(env, data['visibleTo'], options?.scopeTokens),\n        async (docs) => {\n          const ids = (field: string) => docs.map((doc) => textOf(doc.data[field])).filter(Boolean)\n          const wants = (field: string) => fieldIds.includes(field)\n          const empty = new Map<string, string>()\n          const [contacts, companies, deals, leads] = await Promise.all([\n            wants('contact') ? namesOf(env, 'contacts', ids('contactId'), (data) => textOf(data['email'])) : empty,\n            wants('company') ? namesOf(env, CRM_COLLECTIONS.companies, ids('companyId'), (data) => textOf(data['name'])) : empty,\n            wants('deal') ? namesOf(env, CRM_COLLECTIONS.deals, ids('dealId'), (data) => textOf(data['title'])) : empty,\n            wants('lead') ? namesOf(env, 'leads', ids('leadId'), (data) => textOf(data['email'])) : empty,\n          ])\n          return docs.map((doc) =>\n            pickValues(\n              activityTransferValues(doc.id, doc.data, {\n                by: (uid) => emails.get(uid),\n                contact: (id) => contacts.get(id) || undefined,\n                company: (id) => companies.get(id) || undefined,\n                deal: (id) => deals.get(id) || undefined,\n                lead: (id) => leads.get(id) || undefined,\n              }),\n              fieldIds,\n            ),\n          )\n        },\n      )\n    },\n\n    async lookup(ctx, requests) {\n      const env = await crmTransferEnv(ctx)\n      const found = { lookup: new Map<string, string[]>(), docs: new Map<string, Record<string, unknown>>() }\n      for (const request of requests) {\n        if (request.fieldId === TRANSFER_ID_FIELD) {\n          await lookupById(env, activitiesOf(env), request, (data) => visibleIn(env, data['visibleTo']), found)\n        }\n      }\n      return lookupResult(found, (id, data) => activityTransferValues(id, data))\n    },\n  }\n}\n"],"names":["CRM_ACTIVITY_DIRECTION_LABELS","CRM_ACTIVITY_KIND_LABELS","CRM_COLLECTIONS","CRM_EMAIL_DELIVERY_STATE_LABELS","TRANSFER_ID_FIELD","countCrmExport","crmMemberEmails","crmTransferEnv","isoOf","lookupById","lookupResult","pickValues","readCrmExportPage","requireCrmRecords","textOf","visibleIn","ACTIVITY_TRANSFER_FIELDS","ACTIVITY_TRANSFER_GROUPS","CRM_TIMESTAMP_FIELDS","activitiesOf","env","orgRef","collection","activities","activityTransferValues","id","activity","names","link","text","value","resolve","linked","kind","direction","delivery","subject","at","body","outcome","durationMinutes","by","to","from","deliveryState","contact","company","deal","lead","createdAt","updatedAt","namesOf","ids","field","out","Map","wanted","Set","filter","includes","length","refs","slice","map","doc","snapshot","firestore","getAll","exists","set","data","activitiesTransferResource","fields","standard","system","groups","matchKeys","fieldId","normalizer","count","ctx","options","scopeTokens","readPage","cursor","fieldIds","emails","orgId","docs","Boolean","wants","empty","contacts","companies","deals","leads","Promise","all","uid","get","undefined","lookup","requests","found","request"],"mappings":"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"}

package/src/lib/transfer/aliases.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { TransferAliasDictionary } from '@aglyn/aglyn/data-transfer';
+export declare const CONTACT_ALIASES: readonly TransferAliasDictionary[];
+export declare const COMPANY_ALIASES: readonly TransferAliasDictionary[];
+export declare const LEAD_ALIASES: readonly TransferAliasDictionary[];
+export declare const DEAL_ALIASES: readonly TransferAliasDictionary[];
+export declare const TASK_ALIASES: readonly TransferAliasDictionary[];