@aglyn/aglyn 1.0.0-beta.253 → 1.0.0-beta.255

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/aglyn",
-  "version": "1.0.0-beta.253",
+  "version": "1.0.0-beta.255",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -37,16 +37,16 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-enums": "1.0.0-beta.253",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.253",
-    "@aglyn/shared-data-types": "1.0.0-beta.253",
-    "@aglyn/shared-util-email": "1.0.0-beta.253",
-    "@aglyn/shared-util-first-touch": "1.0.0-beta.253",
-    "@aglyn/shared-util-http": "1.0.0-beta.253",
-    "@aglyn/shared-util-logger": "1.0.0-beta.253",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.253",
-    "@aglyn/shared-util-tools": "1.0.0-beta.253",
-    "@aglyn/shared-util-vendor": "1.0.0-beta.253",
+    "@aglyn/shared-data-enums": "1.0.0-beta.255",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.255",
+    "@aglyn/shared-data-types": "1.0.0-beta.255",
+    "@aglyn/shared-util-email": "1.0.0-beta.255",
+    "@aglyn/shared-util-first-touch": "1.0.0-beta.255",
+    "@aglyn/shared-util-http": "1.0.0-beta.255",
+    "@aglyn/shared-util-logger": "1.0.0-beta.255",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.255",
+    "@aglyn/shared-util-tools": "1.0.0-beta.255",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.255",
     "@data-driven-forms/react-form-renderer": "^4.2.0",
     "@msgpack/msgpack": "^3.1.3",
     "@types/unist": "^3.0.3",

package/src/lib/app-utils/business-profile-values.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @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.
+ */
+/**
+ * The pure part of the business profile: its fields, limits, sources and the
+ * write rules (what the owner typed is theirs; a changed field becomes the
+ * owner's). It imports nothing, so the native apps replay it from
+ * `function-cases.generated.json` (AGL-3671); `business-profile.ts` re-exports
+ * all of it, so every existing import is unchanged.
+ */
+/** The collection a profile document lives in, under a host or an org. */
+export declare const BUSINESS_PROFILE_SUBCOLLECTION = "businessProfile";
+/** The site's profile document id. */
+export declare const BUSINESS_PROFILE_SITE_DOC = "profile";
+/** The workspace defaults document id. */
+export declare const BUSINESS_PROFILE_WORKSPACE_DOC = "defaults";
+/** Who wrote a stored value: the owner, the guided start's answers, or a generator. */
+export type BusinessProfileSource = 'owner' | 'start' | 'ai';
+/**
+ * Where a RESOLVED value came from: a stored source, the site's own settings
+ * (`seo.entity`, `business`, the display name), or the workspace defaults.
+ */
+export type BusinessProfileOrigin = BusinessProfileSource | 'site' | 'workspace';
+export declare const BUSINESS_TONES: readonly ["friendly", "professional", "playful", "premium", "plain"];
+export type BusinessTone = (typeof BUSINESS_TONES)[number];
+/** Each tone as the owner picks it and as a writer is told it. */
+export declare const BUSINESS_TONE_LABELS: Readonly<Record<BusinessTone, string>>;
+/** The fields the profile document stores itself. */
+export declare const BUSINESS_PROFILE_FIELDS: readonly ["whatYouDo", "services", "serviceArea", "audience", "tone", "toneNotes"];
+export type BusinessProfileField = (typeof BUSINESS_PROFILE_FIELDS)[number];
+/** Each field's ceiling, in characters; `services` is per item. */
+export declare const BUSINESS_PROFILE_MAX_CHARS: Readonly<Record<Exclude<BusinessProfileField, 'tone'>, number>>;
+/** At most this many services are kept. */
+export declare const BUSINESS_PROFILE_MAX_SERVICES = 12;
+/** The stored document, at either level. */
+export interface BusinessProfileDoc {
+    whatYouDo?: string;
+    services?: string[];
+    serviceArea?: string;
+    audience?: string;
+    tone?: BusinessTone | null;
+    toneNotes?: string;
+    /** Who wrote each stored value; a value without one is the owner's. */
+    sources?: Partial<Record<BusinessProfileField, BusinessProfileSource>>;
+    updatedAt?: unknown;
+    updatedBy?: string | null;
+}
+/** The values a write carries, before they are sanitized. */
+export type BusinessProfileValues = Partial<Pick<BusinessProfileDoc, 'whatYouDo' | 'services' | 'serviceArea' | 'audience' | 'tone' | 'toneNotes'>>;
+export declare const text: (value: unknown, max: number) => string;
+/** One field's stored value, sanitized; empty is `''`, `[]` or `null`. */
+export declare function fieldValue(doc: BusinessProfileValues | null | undefined, field: BusinessProfileField): unknown;
+export declare const isEmpty: (value: unknown) => boolean;
+/** The source a stored, non-empty value carries; the owner's when none is recorded. */
+export declare function businessProfileSourceOf(doc: BusinessProfileDoc | null | undefined, field: BusinessProfileField): BusinessProfileSource | null;
+/** Every value a write may carry, sanitized; an absent field stays absent. */
+export declare function sanitizeBusinessProfileValues(values: BusinessProfileValues): BusinessProfileValues;
+/**
+ * The document a generator's or the guided start's values make of the stored
+ * one: each value fills a field that is empty or was written by a source that
+ * weighs less, and nothing else. `null` when nothing would change, so a caller
+ * writes only when there is something to write.
+ */
+export declare function mergeBusinessProfilePrefill(current: BusinessProfileDoc | null | undefined, values: BusinessProfileValues, source: Exclude<BusinessProfileSource, 'owner'>): BusinessProfileDoc | null;
+/**
+ * The document the owner's save makes: every field they changed becomes
+ * theirs, and a field they left as it was keeps the source it had — so saving
+ * the form after correcting one line does not claim every suggestion on it.
+ */
+export declare function businessProfileOwnerWrite(current: BusinessProfileDoc | null | undefined, edited: BusinessProfileValues): Pick<BusinessProfileDoc, BusinessProfileField | 'sources'>;

package/src/lib/app-utils/business-profile-values.js

@@ -0,0 +1,160 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ /**
+ * The pure part of the business profile: its fields, limits, sources and the
+ * write rules (what the owner typed is theirs; a changed field becomes the
+ * owner's). It imports nothing, so the native apps replay it from
+ * `function-cases.generated.json` (AGL-3671); `business-profile.ts` re-exports
+ * all of it, so every existing import is unchanged.
+ */ /** The collection a profile document lives in, under a host or an org. */ export const BUSINESS_PROFILE_SUBCOLLECTION = 'businessProfile';
+/** The site's profile document id. */ export const BUSINESS_PROFILE_SITE_DOC = 'profile';
+/** The workspace defaults document id. */ export const BUSINESS_PROFILE_WORKSPACE_DOC = 'defaults';
+/** How much a source's words weigh: a higher rank is never replaced by a lower one. */ const SOURCE_RANK = {
+    ai: 1,
+    start: 2,
+    owner: 3
+};
+export const BUSINESS_TONES = [
+    'friendly',
+    'professional',
+    'playful',
+    'premium',
+    'plain'
+];
+/** Each tone as the owner picks it and as a writer is told it. */ export const BUSINESS_TONE_LABELS = {
+    friendly: 'Friendly and warm',
+    professional: 'Professional and clear',
+    playful: 'Playful and upbeat',
+    premium: 'Premium and refined',
+    plain: 'Plain and direct'
+};
+/** The fields the profile document stores itself. */ export const BUSINESS_PROFILE_FIELDS = [
+    'whatYouDo',
+    'services',
+    'serviceArea',
+    'audience',
+    'tone',
+    'toneNotes'
+];
+/** Each field's ceiling, in characters; `services` is per item. */ export const BUSINESS_PROFILE_MAX_CHARS = {
+    whatYouDo: 200,
+    services: 60,
+    serviceArea: 120,
+    audience: 160,
+    toneNotes: 200
+};
+/** At most this many services are kept. */ export const BUSINESS_PROFILE_MAX_SERVICES = 12;
+export const text = (value, max)=>typeof value === 'string' ? value.replace(/\s+/g, ' ').trim().slice(0, max) : '';
+const tone = (value)=>BUSINESS_TONES.includes(value) ? value : null;
+const services = (value)=>{
+    const items = Array.isArray(value) ? value : typeof value === 'string' ? value.split(/[,\n]/) : [];
+    const seen = new Set();
+    const kept = [];
+    for (const item of items){
+        const name = text(item, BUSINESS_PROFILE_MAX_CHARS.services);
+        const key = name.toLowerCase();
+        if (!name || seen.has(key)) continue;
+        seen.add(key);
+        kept.push(name);
+        if (kept.length >= BUSINESS_PROFILE_MAX_SERVICES) break;
+    }
+    return kept;
+};
+/** One field's stored value, sanitized; empty is `''`, `[]` or `null`. */ export function fieldValue(doc, field) {
+    switch(field){
+        case 'services':
+            return services(doc == null ? void 0 : doc.services);
+        case 'tone':
+            return tone(doc == null ? void 0 : doc.tone);
+        default:
+            return text(doc == null ? void 0 : doc[field], BUSINESS_PROFILE_MAX_CHARS[field]);
+    }
+}
+export const isEmpty = (value)=>value === null || value === '' || Array.isArray(value) && value.length === 0;
+/** The source a stored, non-empty value carries; the owner's when none is recorded. */ export function businessProfileSourceOf(doc, field) {
+    var _doc_sources;
+    if (isEmpty(fieldValue(doc, field))) return null;
+    const source = doc == null ? void 0 : (_doc_sources = doc.sources) == null ? void 0 : _doc_sources[field];
+    return source && source in SOURCE_RANK ? source : 'owner';
+}
+/** Every value a write may carry, sanitized; an absent field stays absent. */ export function sanitizeBusinessProfileValues(values) {
+    const clean = {};
+    for (const field of BUSINESS_PROFILE_FIELDS){
+        if (!(field in values)) continue;
+        clean[field] = fieldValue(values, field);
+    }
+    return clean;
+}
+/**
+ * The document a generator's or the guided start's values make of the stored
+ * one: each value fills a field that is empty or was written by a source that
+ * weighs less, and nothing else. `null` when nothing would change, so a caller
+ * writes only when there is something to write.
+ */ export function mergeBusinessProfilePrefill(current, values, source) {
+    var _ref;
+    const clean = sanitizeBusinessProfileValues(values);
+    const next = _extends({}, current != null ? current : {}, {
+        sources: _extends({}, (_ref = current == null ? void 0 : current.sources) != null ? _ref : {})
+    });
+    let changed = false;
+    for (const field of BUSINESS_PROFILE_FIELDS){
+        var _current_sources;
+        if (!(field in clean)) continue;
+        const value = clean[field];
+        if (isEmpty(value)) continue;
+        // An explicit source counts even on an empty value: a field the owner
+        // cleared stays cleared rather than being refilled behind them.
+        const recorded = current == null ? void 0 : (_current_sources = current.sources) == null ? void 0 : _current_sources[field];
+        const held = recorded && recorded in SOURCE_RANK ? recorded : businessProfileSourceOf(current, field);
+        if (held && SOURCE_RANK[held] >= SOURCE_RANK[source]) continue;
+        if (JSON.stringify(fieldValue(current, field)) === JSON.stringify(value)) continue;
+        next[field] = value;
+        next.sources[field] = source;
+        changed = true;
+    }
+    return changed ? next : null;
+}
+/**
+ * The document the owner's save makes: every field they changed becomes
+ * theirs, and a field they left as it was keeps the source it had — so saving
+ * the form after correcting one line does not claim every suggestion on it.
+ */ export function businessProfileOwnerWrite(current, edited) {
+    const clean = sanitizeBusinessProfileValues(edited);
+    const next = {};
+    const sources = {};
+    for (const field of BUSINESS_PROFILE_FIELDS){
+        var _businessProfileSourceOf;
+        const before = fieldValue(current, field);
+        const after = field in clean ? clean[field] : before;
+        next[field] = after;
+        const same = JSON.stringify(before) === JSON.stringify(after);
+        if (isEmpty(after)) {
+            var _current_sources;
+            // A suggestion the owner deleted is their decision, and recorded as
+            // one, so the next prefill does not put it back.
+            if (!same) sources[field] = 'owner';
+            else if ((current == null ? void 0 : (_current_sources = current.sources) == null ? void 0 : _current_sources[field]) === 'owner') sources[field] = 'owner';
+            continue;
+        }
+        sources[field] = same ? (_businessProfileSourceOf = businessProfileSourceOf(current, field)) != null ? _businessProfileSourceOf : 'owner' : 'owner';
+    }
+    return _extends({}, next, {
+        sources
+    });
+}
+
+//# sourceMappingURL=business-profile-values.js.map

package/src/lib/app-utils/business-profile-values.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/business-profile-values.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 * The pure part of the business profile: its fields, limits, sources and the\n * write rules (what the owner typed is theirs; a changed field becomes the\n * owner's). It imports nothing, so the native apps replay it from\n * `function-cases.generated.json` (AGL-3671); `business-profile.ts` re-exports\n * all of it, so every existing import is unchanged.\n */\n\n/** The collection a profile document lives in, under a host or an org. */\nexport const BUSINESS_PROFILE_SUBCOLLECTION = 'businessProfile'\n/** The site's profile document id. */\nexport const BUSINESS_PROFILE_SITE_DOC = 'profile'\n/** The workspace defaults document id. */\nexport const BUSINESS_PROFILE_WORKSPACE_DOC = 'defaults'\n\n/** Who wrote a stored value: the owner, the guided start's answers, or a generator. */\nexport type BusinessProfileSource = 'owner' | 'start' | 'ai'\n\n/**\n * Where a RESOLVED value came from: a stored source, the site's own settings\n * (`seo.entity`, `business`, the display name), or the workspace defaults.\n */\nexport type BusinessProfileOrigin = BusinessProfileSource | 'site' | 'workspace'\n\n/** How much a source's words weigh: a higher rank is never replaced by a lower one. */\nconst SOURCE_RANK: Readonly<Record<BusinessProfileSource, number>> = {\n  ai: 1,\n  start: 2,\n  owner: 3,\n}\n\nexport const BUSINESS_TONES = ['friendly', 'professional', 'playful', 'premium', 'plain'] as const\nexport type BusinessTone = (typeof BUSINESS_TONES)[number]\n\n/** Each tone as the owner picks it and as a writer is told it. */\nexport const BUSINESS_TONE_LABELS: Readonly<Record<BusinessTone, string>> = {\n  friendly: 'Friendly and warm',\n  professional: 'Professional and clear',\n  playful: 'Playful and upbeat',\n  premium: 'Premium and refined',\n  plain: 'Plain and direct',\n}\n\n/** The fields the profile document stores itself. */\nexport const BUSINESS_PROFILE_FIELDS = [\n  'whatYouDo',\n  'services',\n  'serviceArea',\n  'audience',\n  'tone',\n  'toneNotes',\n] as const\nexport type BusinessProfileField = (typeof BUSINESS_PROFILE_FIELDS)[number]\n\n/** Each field's ceiling, in characters; `services` is per item. */\nexport const BUSINESS_PROFILE_MAX_CHARS: Readonly<Record<Exclude<BusinessProfileField, 'tone'>, number>> = {\n  whatYouDo: 200,\n  services: 60,\n  serviceArea: 120,\n  audience: 160,\n  toneNotes: 200,\n}\n\n/** At most this many services are kept. */\nexport const BUSINESS_PROFILE_MAX_SERVICES = 12\n\n/** The stored document, at either level. */\nexport interface BusinessProfileDoc {\n  whatYouDo?: string\n  services?: string[]\n  serviceArea?: string\n  audience?: string\n  tone?: BusinessTone | null\n  toneNotes?: string\n  /** Who wrote each stored value; a value without one is the owner's. */\n  sources?: Partial<Record<BusinessProfileField, BusinessProfileSource>>\n  updatedAt?: unknown\n  updatedBy?: string | null\n}\n\n/** The values a write carries, before they are sanitized. */\nexport type BusinessProfileValues = Partial<\n  Pick<BusinessProfileDoc, 'whatYouDo' | 'services' | 'serviceArea' | 'audience' | 'tone' | 'toneNotes'>\n>\n\nexport const text = (value: unknown, max: number): string =>\n  typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim().slice(0, max) : ''\n\nconst tone = (value: unknown): BusinessTone | null =>\n  (BUSINESS_TONES as readonly unknown[]).includes(value) ? (value as BusinessTone) : null\n\nconst services = (value: unknown): string[] => {\n  const items = Array.isArray(value) ? value : typeof value === 'string' ? value.split(/[,\\n]/) : []\n  const seen = new Set<string>()\n  const kept: string[] = []\n  for (const item of items) {\n    const name = text(item, BUSINESS_PROFILE_MAX_CHARS.services)\n    const key = name.toLowerCase()\n    if (!name || seen.has(key)) continue\n    seen.add(key)\n    kept.push(name)\n    if (kept.length >= BUSINESS_PROFILE_MAX_SERVICES) break\n  }\n  return kept\n}\n\n/** One field's stored value, sanitized; empty is `''`, `[]` or `null`. */\nexport function fieldValue(doc: BusinessProfileValues | null | undefined, field: BusinessProfileField): unknown {\n  switch (field) {\n    case 'services':\n      return services(doc?.services)\n    case 'tone':\n      return tone(doc?.tone)\n    default:\n      return text(doc?.[field], BUSINESS_PROFILE_MAX_CHARS[field])\n  }\n}\n\nexport const isEmpty = (value: unknown): boolean =>\n  value === null || value === '' || (Array.isArray(value) && value.length === 0)\n\n/** The source a stored, non-empty value carries; the owner's when none is recorded. */\nexport function businessProfileSourceOf(\n  doc: BusinessProfileDoc | null | undefined,\n  field: BusinessProfileField,\n): BusinessProfileSource | null {\n  if (isEmpty(fieldValue(doc, field))) return null\n  const source = doc?.sources?.[field]\n  return source && source in SOURCE_RANK ? source : 'owner'\n}\n\n/** Every value a write may carry, sanitized; an absent field stays absent. */\nexport function sanitizeBusinessProfileValues(values: BusinessProfileValues): BusinessProfileValues {\n  const clean: BusinessProfileValues = {}\n  for (const field of BUSINESS_PROFILE_FIELDS) {\n    if (!(field in values)) continue\n    ;(clean as Record<string, unknown>)[field] = fieldValue(values, field)\n  }\n  return clean\n}\n\n/**\n * The document a generator's or the guided start's values make of the stored\n * one: each value fills a field that is empty or was written by a source that\n * weighs less, and nothing else. `null` when nothing would change, so a caller\n * writes only when there is something to write.\n */\nexport function mergeBusinessProfilePrefill(\n  current: BusinessProfileDoc | null | undefined,\n  values: BusinessProfileValues,\n  source: Exclude<BusinessProfileSource, 'owner'>,\n): BusinessProfileDoc | null {\n  const clean = sanitizeBusinessProfileValues(values)\n  const next: BusinessProfileDoc = { ...(current ?? {}), sources: { ...(current?.sources ?? {}) } }\n  let changed = false\n  for (const field of BUSINESS_PROFILE_FIELDS) {\n    if (!(field in clean)) continue\n    const value = (clean as Record<string, unknown>)[field]\n    if (isEmpty(value)) continue\n    // An explicit source counts even on an empty value: a field the owner\n    // cleared stays cleared rather than being refilled behind them.\n    const recorded = current?.sources?.[field]\n    const held = recorded && recorded in SOURCE_RANK ? recorded : businessProfileSourceOf(current, field)\n    if (held && SOURCE_RANK[held] >= SOURCE_RANK[source]) continue\n    if (JSON.stringify(fieldValue(current, field)) === JSON.stringify(value)) continue\n    ;(next as Record<string, unknown>)[field] = value\n    next.sources![field] = source\n    changed = true\n  }\n  return changed ? next : null\n}\n\n/**\n * The document the owner's save makes: every field they changed becomes\n * theirs, and a field they left as it was keeps the source it had — so saving\n * the form after correcting one line does not claim every suggestion on it.\n */\nexport function businessProfileOwnerWrite(\n  current: BusinessProfileDoc | null | undefined,\n  edited: BusinessProfileValues,\n): Pick<BusinessProfileDoc, BusinessProfileField | 'sources'> {\n  const clean = sanitizeBusinessProfileValues(edited)\n  const next: Record<string, unknown> = {}\n  const sources: Partial<Record<BusinessProfileField, BusinessProfileSource>> = {}\n  for (const field of BUSINESS_PROFILE_FIELDS) {\n    const before = fieldValue(current, field)\n    const after = field in clean ? (clean as Record<string, unknown>)[field] : before\n    next[field] = after\n    const same = JSON.stringify(before) === JSON.stringify(after)\n    if (isEmpty(after)) {\n      // A suggestion the owner deleted is their decision, and recorded as\n      // one, so the next prefill does not put it back.\n      if (!same) sources[field] = 'owner'\n      else if (current?.sources?.[field] === 'owner') sources[field] = 'owner'\n      continue\n    }\n    sources[field] = same ? (businessProfileSourceOf(current, field) ?? 'owner') : 'owner'\n  }\n  return { ...(next as Pick<BusinessProfileDoc, BusinessProfileField>), sources }\n}\n"],"names":["BUSINESS_PROFILE_SUBCOLLECTION","BUSINESS_PROFILE_SITE_DOC","BUSINESS_PROFILE_WORKSPACE_DOC","SOURCE_RANK","ai","start","owner","BUSINESS_TONES","BUSINESS_TONE_LABELS","friendly","professional","playful","premium","plain","BUSINESS_PROFILE_FIELDS","BUSINESS_PROFILE_MAX_CHARS","whatYouDo","services","serviceArea","audience","toneNotes","BUSINESS_PROFILE_MAX_SERVICES","text","value","max","replace","trim","slice","tone","includes","items","Array","isArray","split","seen","Set","kept","item","name","key","toLowerCase","has","add","push","length","fieldValue","doc","field","isEmpty","businessProfileSourceOf","source","sources","sanitizeBusinessProfileValues","values","clean","mergeBusinessProfilePrefill","current","next","changed","recorded","held","JSON","stringify","businessProfileOwnerWrite","edited","before","after","same"],"mappings":"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"}

package/src/lib/app-utils/business-profile.d.ts

@@ -15,6 +15,13 @@
  * limitations under the License.
  */
 import { type HostSeoEntity } from './content-authors';
+import { type BusinessProfileDoc, type BusinessProfileOrigin, type BusinessTone } from './business-profile-values';
+export { BUSINESS_PROFILE_FIELDS, BUSINESS_PROFILE_MAX_CHARS, BUSINESS_PROFILE_MAX_SERVICES, BUSINESS_PROFILE_SITE_DOC, BUSINESS_PROFILE_SUBCOLLECTION, BUSINESS_PROFILE_WORKSPACE_DOC, BUSINESS_TONE_LABELS, BUSINESS_TONES, businessProfileOwnerWrite, businessProfileSourceOf, mergeBusinessProfilePrefill, sanitizeBusinessProfileValues, } from './business-profile-values';
+export type { BusinessProfileDoc, BusinessProfileField, BusinessProfileOrigin, BusinessProfileSource, BusinessProfileValues, BusinessTone, } from './business-profile-values';
+/** The tones as a plain list, in the order the owner picks them, for the native apps' pickers. */
+export declare const BUSINESS_TONE_ORDER: readonly string[];
+/** The stored fields as a plain list, for the native apps' writers. */
+export declare const BUSINESS_PROFILE_FIELD_ORDER: readonly string[];
 /**
  * A site's BUSINESS PROFILE (AGL-3661): what the business is, as everything
  * that writes about it needs to know — the site's own pages, the structured
@@ -51,49 +58,6 @@ import { type HostSeoEntity } from './content-authors';
  * what a generator guessed; and a generator's guess fills only what is empty.
  * {@link mergeBusinessProfilePrefill} is the one place that rule is applied.
  */
-/** The collection a profile document lives in, under a host or an org. */
-export declare const BUSINESS_PROFILE_SUBCOLLECTION = "businessProfile";
-/** The site's profile document id. */
-export declare const BUSINESS_PROFILE_SITE_DOC = "profile";
-/** The workspace defaults document id. */
-export declare const BUSINESS_PROFILE_WORKSPACE_DOC = "defaults";
-/** Who wrote a stored value: the owner, the guided start's answers, or a generator. */
-export type BusinessProfileSource = 'owner' | 'start' | 'ai';
-/**
- * Where a RESOLVED value came from: a stored source, the site's own settings
- * (`seo.entity`, `business`, the display name), or the workspace defaults.
- */
-export type BusinessProfileOrigin = BusinessProfileSource | 'site' | 'workspace';
-export declare const BUSINESS_TONES: readonly ["friendly", "professional", "playful", "premium", "plain"];
-export type BusinessTone = (typeof BUSINESS_TONES)[number];
-/** The tones as a plain list, in the order the owner picks them, for the native apps' pickers. */
-export declare const BUSINESS_TONE_ORDER: readonly string[];
-/** Each tone as the owner picks it and as a writer is told it. */
-export declare const BUSINESS_TONE_LABELS: Readonly<Record<BusinessTone, string>>;
-/** The fields the profile document stores itself. */
-export declare const BUSINESS_PROFILE_FIELDS: readonly ["whatYouDo", "services", "serviceArea", "audience", "tone", "toneNotes"];
-export type BusinessProfileField = (typeof BUSINESS_PROFILE_FIELDS)[number];
-/** The stored fields as a plain list, for the native apps' writers. */
-export declare const BUSINESS_PROFILE_FIELD_ORDER: readonly string[];
-/** Each field's ceiling, in characters; `services` is per item. */
-export declare const BUSINESS_PROFILE_MAX_CHARS: Readonly<Record<Exclude<BusinessProfileField, 'tone'>, number>>;
-/** At most this many services are kept. */
-export declare const BUSINESS_PROFILE_MAX_SERVICES = 12;
-/** The stored document, at either level. */
-export interface BusinessProfileDoc {
-    whatYouDo?: string;
-    services?: string[];
-    serviceArea?: string;
-    audience?: string;
-    tone?: BusinessTone | null;
-    toneNotes?: string;
-    /** Who wrote each stored value; a value without one is the owner's. */
-    sources?: Partial<Record<BusinessProfileField, BusinessProfileSource>>;
-    updatedAt?: unknown;
-    updatedBy?: string | null;
-}
-/** The values a write carries, before they are sanitized. */
-export type BusinessProfileValues = Partial<Pick<BusinessProfileDoc, 'whatYouDo' | 'services' | 'serviceArea' | 'audience' | 'tone' | 'toneNotes'>>;
 /** The host fields the profile reads. A closed surface, as the host tokens' is. */
 export interface BusinessProfileHost {
     displayName?: string;
@@ -137,23 +101,6 @@ export interface ResolvedBusinessProfile {
     profiles: string[];
     logo: string | null;
 }
-/** The source a stored, non-empty value carries; the owner's when none is recorded. */
-export declare function businessProfileSourceOf(doc: BusinessProfileDoc | null | undefined, field: BusinessProfileField): BusinessProfileSource | null;
-/** Every value a write may carry, sanitized; an absent field stays absent. */
-export declare function sanitizeBusinessProfileValues(values: BusinessProfileValues): BusinessProfileValues;
-/**
- * The document a generator's or the guided start's values make of the stored
- * one: each value fills a field that is empty or was written by a source that
- * weighs less, and nothing else. `null` when nothing would change, so a caller
- * writes only when there is something to write.
- */
-export declare function mergeBusinessProfilePrefill(current: BusinessProfileDoc | null | undefined, values: BusinessProfileValues, source: Exclude<BusinessProfileSource, 'owner'>): BusinessProfileDoc | null;
-/**
- * The document the owner's save makes: every field they changed becomes
- * theirs, and a field they left as it was keeps the source it had — so saving
- * the form after correcting one line does not claim every suggestion on it.
- */
-export declare function businessProfileOwnerWrite(current: BusinessProfileDoc | null | undefined, edited: BusinessProfileValues): Pick<BusinessProfileDoc, BusinessProfileField | 'sources'>;
 /**
  * The profile as every reader sees it, field by field (AGL-3661):
  *

package/src/lib/app-utils/business-profile.js

@@ -1,4 +1,3 @@
-import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -17,179 +16,10 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  */ import { siteProfileUrls } from "./content-authors.js";
 import { normalizeAreaServed } from "./local-business.js";
 import { PLATFORM_BRAND_NAME } from "./platform-brand.js";
-/**
- * A site's BUSINESS PROFILE (AGL-3661): what the business is, as everything
- * that writes about it needs to know — the site's own pages, the structured
- * data, and any generator a plugin brings.
- *
- * ── Most of it is already stored, so this stores only the rest ─────────────
- *
- * The site's name, its one-line description, its contact details, its hours,
- * the areas it serves and its social profiles all have a home on the host
- * document already: `seo.entity` (the publisher entity the JSON-LD is built
- * from, edited in Setup → SEO) and `business` (the contact card the `host.*`
- * tokens and the footer read, edited in Setup → Basic details). Copying them
- * here would make two places to keep in step, and the copy would drift.
- *
- * So the profile document holds only what has no home yet — the services, the
- * audience, the tone of voice — plus a line about the business and the area it
- * serves for a site whose SEO entity does not say. {@link resolveBusinessProfile}
- * reads the two together into one picture, field by field, and says where
- * each value came from.
- *
- * ── Where it is stored ────────────────────────────────────────────────────
- *
- * `hosts/{hostId}/businessProfile/profile` for a site and
- * `orgs/{orgId}/businessProfile/defaults` for the workspace, whose values a
- * site inherits where it has none of its own. A subcollection document rather
- * than a key on the host: the host document's `business` map is replaced
- * whole by the contact card's save, and a key beside it would be one more
- * thing a partial write could blank.
- *
- * ── Whose words win ───────────────────────────────────────────────────────
- *
- * Every stored value carries its source. What the owner typed is never
- * replaced by anything else; what the guided start was told replaces only
- * what a generator guessed; and a generator's guess fills only what is empty.
- * {@link mergeBusinessProfilePrefill} is the one place that rule is applied.
- */ /** The collection a profile document lives in, under a host or an org. */ export const BUSINESS_PROFILE_SUBCOLLECTION = 'businessProfile';
-/** The site's profile document id. */ export const BUSINESS_PROFILE_SITE_DOC = 'profile';
-/** The workspace defaults document id. */ export const BUSINESS_PROFILE_WORKSPACE_DOC = 'defaults';
-/** How much a source's words weigh: a higher rank is never replaced by a lower one. */ const SOURCE_RANK = {
-    ai: 1,
-    start: 2,
-    owner: 3
-};
-export const BUSINESS_TONES = [
-    'friendly',
-    'professional',
-    'playful',
-    'premium',
-    'plain'
-];
+import { BUSINESS_PROFILE_FIELDS, BUSINESS_PROFILE_MAX_CHARS, BUSINESS_TONES, businessProfileSourceOf, fieldValue, isEmpty, text } from "./business-profile-values.js";
+export { BUSINESS_PROFILE_FIELDS, BUSINESS_PROFILE_MAX_CHARS, BUSINESS_PROFILE_MAX_SERVICES, BUSINESS_PROFILE_SITE_DOC, BUSINESS_PROFILE_SUBCOLLECTION, BUSINESS_PROFILE_WORKSPACE_DOC, BUSINESS_TONE_LABELS, BUSINESS_TONES, businessProfileOwnerWrite, businessProfileSourceOf, mergeBusinessProfilePrefill, sanitizeBusinessProfileValues } from "./business-profile-values.js";
 /** The tones as a plain list, in the order the owner picks them, for the native apps' pickers. */ export const BUSINESS_TONE_ORDER = BUSINESS_TONES;
-/** Each tone as the owner picks it and as a writer is told it. */ export const BUSINESS_TONE_LABELS = {
-    friendly: 'Friendly and warm',
-    professional: 'Professional and clear',
-    playful: 'Playful and upbeat',
-    premium: 'Premium and refined',
-    plain: 'Plain and direct'
-};
-/** The fields the profile document stores itself. */ export const BUSINESS_PROFILE_FIELDS = [
-    'whatYouDo',
-    'services',
-    'serviceArea',
-    'audience',
-    'tone',
-    'toneNotes'
-];
 /** The stored fields as a plain list, for the native apps' writers. */ export const BUSINESS_PROFILE_FIELD_ORDER = BUSINESS_PROFILE_FIELDS;
-/** Each field's ceiling, in characters; `services` is per item. */ export const BUSINESS_PROFILE_MAX_CHARS = {
-    whatYouDo: 200,
-    services: 60,
-    serviceArea: 120,
-    audience: 160,
-    toneNotes: 200
-};
-/** At most this many services are kept. */ export const BUSINESS_PROFILE_MAX_SERVICES = 12;
-const text = (value, max)=>typeof value === 'string' ? value.replace(/\s+/g, ' ').trim().slice(0, max) : '';
-const tone = (value)=>BUSINESS_TONES.includes(value) ? value : null;
-const services = (value)=>{
-    const items = Array.isArray(value) ? value : typeof value === 'string' ? value.split(/[,\n]/) : [];
-    const seen = new Set();
-    const kept = [];
-    for (const item of items){
-        const name = text(item, BUSINESS_PROFILE_MAX_CHARS.services);
-        const key = name.toLowerCase();
-        if (!name || seen.has(key)) continue;
-        seen.add(key);
-        kept.push(name);
-        if (kept.length >= BUSINESS_PROFILE_MAX_SERVICES) break;
-    }
-    return kept;
-};
-/** One field's stored value, sanitized; empty is `''`, `[]` or `null`. */ function fieldValue(doc, field) {
-    switch(field){
-        case 'services':
-            return services(doc == null ? void 0 : doc.services);
-        case 'tone':
-            return tone(doc == null ? void 0 : doc.tone);
-        default:
-            return text(doc == null ? void 0 : doc[field], BUSINESS_PROFILE_MAX_CHARS[field]);
-    }
-}
-const isEmpty = (value)=>value === null || value === '' || Array.isArray(value) && value.length === 0;
-/** The source a stored, non-empty value carries; the owner's when none is recorded. */ export function businessProfileSourceOf(doc, field) {
-    var _doc_sources;
-    if (isEmpty(fieldValue(doc, field))) return null;
-    const source = doc == null ? void 0 : (_doc_sources = doc.sources) == null ? void 0 : _doc_sources[field];
-    return source && source in SOURCE_RANK ? source : 'owner';
-}
-/** Every value a write may carry, sanitized; an absent field stays absent. */ export function sanitizeBusinessProfileValues(values) {
-    const clean = {};
-    for (const field of BUSINESS_PROFILE_FIELDS){
-        if (!(field in values)) continue;
-        clean[field] = fieldValue(values, field);
-    }
-    return clean;
-}
-/**
- * The document a generator's or the guided start's values make of the stored
- * one: each value fills a field that is empty or was written by a source that
- * weighs less, and nothing else. `null` when nothing would change, so a caller
- * writes only when there is something to write.
- */ export function mergeBusinessProfilePrefill(current, values, source) {
-    var _ref;
-    const clean = sanitizeBusinessProfileValues(values);
-    const next = _extends({}, current != null ? current : {}, {
-        sources: _extends({}, (_ref = current == null ? void 0 : current.sources) != null ? _ref : {})
-    });
-    let changed = false;
-    for (const field of BUSINESS_PROFILE_FIELDS){
-        var _current_sources;
-        if (!(field in clean)) continue;
-        const value = clean[field];
-        if (isEmpty(value)) continue;
-        // An explicit source counts even on an empty value: a field the owner
-        // cleared stays cleared rather than being refilled behind them.
-        const recorded = current == null ? void 0 : (_current_sources = current.sources) == null ? void 0 : _current_sources[field];
-        const held = recorded && recorded in SOURCE_RANK ? recorded : businessProfileSourceOf(current, field);
-        if (held && SOURCE_RANK[held] >= SOURCE_RANK[source]) continue;
-        if (JSON.stringify(fieldValue(current, field)) === JSON.stringify(value)) continue;
-        next[field] = value;
-        next.sources[field] = source;
-        changed = true;
-    }
-    return changed ? next : null;
-}
-/**
- * The document the owner's save makes: every field they changed becomes
- * theirs, and a field they left as it was keeps the source it had — so saving
- * the form after correcting one line does not claim every suggestion on it.
- */ export function businessProfileOwnerWrite(current, edited) {
-    const clean = sanitizeBusinessProfileValues(edited);
-    const next = {};
-    const sources = {};
-    for (const field of BUSINESS_PROFILE_FIELDS){
-        var _businessProfileSourceOf;
-        const before = fieldValue(current, field);
-        const after = field in clean ? clean[field] : before;
-        next[field] = after;
-        const same = JSON.stringify(before) === JSON.stringify(after);
-        if (isEmpty(after)) {
-            var _current_sources;
-            // A suggestion the owner deleted is their decision, and recorded as
-            // one, so the next prefill does not put it back.
-            if (!same) sources[field] = 'owner';
-            else if ((current == null ? void 0 : (_current_sources = current.sources) == null ? void 0 : _current_sources[field]) === 'owner') sources[field] = 'owner';
-            continue;
-        }
-        sources[field] = same ? (_businessProfileSourceOf = businessProfileSourceOf(current, field)) != null ? _businessProfileSourceOf : 'owner' : 'owner';
-    }
-    return _extends({}, next, {
-        sources
-    });
-}
 /** The postal address as one line: the SEO entity's parts, else the contact card's block. */ function addressLine(host) {
     var _host_seo_entity, _host_seo, _host_business;
     const parts = host == null ? void 0 : (_host_seo = host.seo) == null ? void 0 : (_host_seo_entity = _host_seo.entity) == null ? void 0 : _host_seo_entity.address;