@milaboratories/pl-middle-layer 1.68.2 → 1.69.0

package/dist/middle_layer/sharing_list.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sharing_list.cjs","names":["SharingOutboxResourceType","SharedEnvelopeResourceType","treeFilter","Computable","AcceptanceFieldPrefix","SynchronizedTreeState","asShareId","SharingStateResourceType"],"sources":["../../src/middle_layer/sharing_list.ts"],"sourcesContent":["import type { PruningFunction } from \"@milaboratories/pl-tree\";\nimport { SynchronizedTreeState } from \"@milaboratories/pl-tree\";\nimport type { Filter, PlClient, SignedResourceId } from \"@milaboratories/pl-client\";\nimport {\n  isEveryoneUserLogin,\n  resourceIdToString,\n  resourceType,\n  resourceTypesEqual,\n  treeFilter,\n} from \"@milaboratories/pl-client\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { MiddleLayerEnvironment } from \"./middle_layer\";\nimport type { ProjectId } from \"@milaboratories/pl-model-common\";\nimport type {\n  EnvelopeAcceptance,\n  EnvelopeData,\n  EnvelopeMode,\n  ShareId,\n} from \"../model/sharing_model\";\nimport {\n  AcceptanceFieldPrefix,\n  asShareId,\n  SharedEnvelopeResourceType,\n  SharingOutboxResourceType,\n  SharingStateResourceType,\n} from \"../model/sharing_model\";\n\n/** Donor-facing view of one outgoing share. */\nexport interface OutgoingShare {\n  shareId: ShareId; // stable logical identity of the share, preserved across changes\n  sharedAt: number; // this instance's creation time (ms epoch)\n  expiresAt?: number; // EnvelopeData.expiresAt; null maps to undefined = never expires\n  mode: EnvelopeMode;\n  title: string; // display name shown to recipients; defaults to the first project's name\n  /** One entry per project in the pack, so the change UI can offer a per-project decision.\n   *  `projectId` is the donor's source project id; `updatedAt` is when this project's\n   *  snapshot was last (re)taken. */\n  projects: { projectId: ProjectId; label: string; updatedAt: number }[];\n  /** Full recipient logins, from `ListGrants` on the envelope; `[\"*\"]` for everyone-shares. */\n  recipients: string[];\n  /** Per recipient who has responded: their decision and when, from acceptance/{login}. */\n  responses: Record<string, { action: \"accepted\" | \"rejected\"; timestamp: number }>;\n}\n\n/** Per-project view for the donor's change UI, from {@link EnvelopeData.projects}. */\nfunction envelopeProjects(data: EnvelopeData): OutgoingShare[\"projects\"] {\n  return Object.values(data.projects).map((p) => ({\n    projectId: p.source,\n    label: p.label,\n    updatedAt: p.updatedAt,\n  }));\n}\n\n/** Acceptor-facing view of one pending share. */\nexport interface PendingShare {\n  shareId: ShareId;\n  sender: string; // EnvelopeData.sender, display only\n  title: string; // display name shown to recipients; defaults to the first project's name\n  mode: EnvelopeMode; // v1 renders only \"copy\" entries\n  grantedAt: number;\n}\n\nconst SharingOutboxPruningFunction: PruningFunction = (resource) => {\n  if (\n    !resourceTypesEqual(resource.type, SharingOutboxResourceType) &&\n    !resourceTypesEqual(resource.type, SharedEnvelopeResourceType)\n  )\n    return [];\n  return resource.fields;\n};\n\n// Server-side traversal scope (modern resourceTree path). Pruning is client-side ONLY and does\n// NOT stop the backend walk — without a fieldFilter the backend descends through the envelope's\n// project/{uuid} snapshots into the whole project graph (StreamManager etc.), whose field-driven\n// finality predicate then throws on the pruned-to-[] fields. Following fields only FROM the outbox\n// and the envelope stops the walk at the project snapshots (UserProject), which we never traverse.\nconst SharingOutboxFieldFilter: Filter = treeFilter.or(\n  treeFilter.resourceTypeEq(SharingOutboxResourceType.name),\n  treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name),\n);\n\n/** Intermediate of an outgoing share before its full recipient list is fetched: everything the\n *  tree carries synchronously, plus the envelope's signed id for the async `ListGrants` enrich. */\ntype OutgoingShareDraft = Omit<OutgoingShare, \"recipients\"> & { envelopeRid: SignedResourceId };\n\n/**\n * Reactive view of the donor's own outbox. Reads each live envelope's immutable\n * {@link EnvelopeData} plus the per-recipient `acceptance/{login}` records from the tree, then\n * enriches each share's full recipient list via `ListGrants` on the envelope (`[\"*\"]` for an\n * everyone-share). `ListGrants` is gated backend-side to the envelope owner (the donor), which is\n * exactly who reads this view.\n *\n * API-level only in M1 (no UI).\n */\nexport function createOutgoingSharesComputable(\n  pl: PlClient,\n  tree: SynchronizedTreeState,\n): Computable<OutgoingShare[] | undefined> {\n  return Computable.make(\n    (ctx) => {\n      const node = ctx.accessor(tree.entry()).node();\n      if (node === undefined) return undefined;\n\n      const drafts: OutgoingShareDraft[] = [];\n      // Outbox fields are keyed by shareId; each value is a SharedEnvelope.\n      for (const fieldName of node.listDynamicFields()) {\n        const envelope = node.traverse(fieldName);\n        if (envelope === undefined) continue;\n        if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n\n        const data = envelope.getDataAsJson<EnvelopeData>();\n        if (data === undefined) continue;\n\n        const responses: OutgoingShare[\"responses\"] = {};\n        for (const f of envelope.listDynamicFields()) {\n          if (!f.startsWith(AcceptanceFieldPrefix)) continue;\n          const login = f.slice(AcceptanceFieldPrefix.length);\n          const acc = envelope.traverse(f);\n          const accData = acc?.getDataAsJson<EnvelopeAcceptance>();\n          if (accData === undefined) continue;\n          responses[login] = { action: accData.action, timestamp: accData.timestamp };\n        }\n\n        drafts.push({\n          shareId: data.shareId,\n          sharedAt: data.sharedAt,\n          ...(data.expiresAt !== null ? { expiresAt: data.expiresAt } : {}),\n          mode: data.mode,\n          title: data.title,\n          projects: envelopeProjects(data),\n          responses,\n          envelopeRid: envelope.id,\n        });\n      }\n      drafts.sort((a, b) => b.sharedAt - a.sharedAt);\n      return drafts;\n    },\n    {\n      // Resolve each share's recipients via listGrants. An everyone-grant maps to \"*\"; the donor's\n      // own grant is dropped. One tx per envelope so a just-revoked rid faults only its own read,\n      // which allSettled degrades to []. Recipients aren't cached — a live share's recipient set can\n      // change. Transactional listGrants when available, else the standalone gRPC-only RPC.\n      postprocessValue: async (\n        drafts: OutgoingShareDraft[] | undefined,\n      ): Promise<OutgoingShare[] | undefined> => {\n        if (drafts === undefined) return undefined;\n        const self = pl.userResources.authUser;\n        const toRecipients = (grants: { user: string }[]): string[] =>\n          grants.some((g) => isEveryoneUserLogin(g.user))\n            ? [\"*\"]\n            : grants.map((g) => g.user).filter((u) => u !== self);\n\n        const txGrants = pl.hasCapability(\"txListGrants:v1\");\n        const settled = await Promise.allSettled(\n          drafts.map((d) =>\n            txGrants\n              ? pl.withReadTx(\"ListShareGrant\", (tx) => tx.listGrants(d.envelopeRid))\n              : pl.userResources.listGrants(d.envelopeRid),\n          ),\n        );\n\n        return drafts.map(({ envelopeRid: _envelopeRid, ...share }, i): OutgoingShare => {\n          const r = settled[i];\n          return { ...share, recipients: r.status === \"fulfilled\" ? toRecipients(r.value) : [] };\n        });\n      },\n    },\n  );\n}\n\n/**\n * Creates the donor's outbox synchronized tree (single explicit root) plus the\n * {@link OutgoingShare} computable over it.\n */\nexport async function createOutgoingShares(\n  pl: PlClient,\n  outboxRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<{ tree: SynchronizedTreeState; computable: Computable<OutgoingShare[] | undefined> }> {\n  const tree = await SynchronizedTreeState.init(\n    pl,\n    outboxRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingOutboxPruningFunction,\n      fieldFilter: SharingOutboxFieldFilter,\n    },\n    env.logger,\n  );\n  return { computable: createOutgoingSharesComputable(pl, tree), tree };\n}\n\nconst DecisionFieldPrefix = \"decision/\";\n\nconst SharedEnvelopePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharedEnvelopeResourceType)) return [];\n  return resource.fields;\n};\n\n// Discovery only needs each envelope's immutable EnvelopeData (basic resource data); it must NOT\n// descend into the project snapshots. Following fields only FROM the envelope stops the walk at\n// the UserProject snapshots (their fields are never followed).\nconst PendingSharesFieldFilter: Filter = treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name);\n\n/**\n * Creates the acceptor's shared-resource discovery tree (a `{kind:'shared'}` seed over\n * {@link SharedEnvelopeResourceType}) plus the {@link PendingShare} computable over it.\n *\n * An envelope surfaces only when its shareId has NO decision/{shareId} on SharingState —\n * the dedup is applied by the caller, which holds the SharingState tree.\n */\nexport async function createPendingSharesTree(\n  pl: PlClient,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    {\n      kind: \"shared\",\n      resourceType: resourceType(\n        SharedEnvelopeResourceType.name,\n        SharedEnvelopeResourceType.version,\n      ),\n    },\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharedEnvelopePruningFunction,\n      fieldFilter: PendingSharesFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** A live envelope discovered in the acceptor's shared-resource tree: its signed resource id and\n *  decoded {@link EnvelopeData}. The accept/reject flow keys these by `data.shareId`. */\nexport type LiveEnvelope = { rid: SignedResourceId; data: EnvelopeData };\n\n/**\n * Builds a Computable yielding the acceptor's currently-live envelopes, read from the\n * shared-resource discovery tree the ML already maintains — the single discovery mechanism.\n * Accept/reject `.getValue()` this instead of re-streaming `ListUserResources`, so there is no\n * second discovery path. The envelope's signed `rid` (from the tree node) is what the write tx\n * needs; `copyEnvelopeProjectsIntoList` reads the project snapshots itself inside the tx.\n *\n * Returns `undefined` while the tree is still empty/unresolved (mirrors the other tree-backed\n * computables here). Yields a flat list; the caller dedups by `shareId` — at most one live\n * envelope per shareId is expected (the donor keeps one), and a replace tears the old one down.\n */\nexport function createLiveEnvelopesComputable(\n  sharedTree: SynchronizedTreeState,\n): Computable<LiveEnvelope[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n    const result: LiveEnvelope[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = envelope.getDataAsJson<EnvelopeData>();\n      if (data === undefined) continue;\n      result.push({ rid: envelope.id, data });\n    }\n    return result;\n  });\n}\n\n/**\n * Builds the {@link PendingShare} computable over the shared-resource discovery tree, filtered\n * against the set of already-handled shareIds (those with a decision/{shareId} in the acceptor's\n * SharingState). Both trees feed one Computable so it recomputes when either changes.\n *\n * `currentUserLogin` (when known) suppresses the user's own shares: a share-with-everybody grants\n * the everyone-user, so the donor discovers their own envelope as a pending share. There is no\n * scenario where a user accepts their own share, so they are dropped from the pending view.\n */\nexport function createPendingSharesComputable(\n  sharedTree: SynchronizedTreeState,\n  sharingStateTree: SynchronizedTreeState,\n  currentUserLogin: string | null,\n): Computable<PendingShare[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n\n    // Set of shareIds already handled (accepted or rejected) — dedup discovery on the logical share.\n    const stateNode = ctx.accessor(sharingStateTree.entry()).node();\n    const handled = new Set<ShareId>();\n    if (stateNode !== undefined)\n      for (const f of stateNode.listDynamicFields())\n        if (f.startsWith(DecisionFieldPrefix))\n          handled.add(asShareId(f.slice(DecisionFieldPrefix.length)));\n\n    const result: PendingShare[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = envelope.getDataAsJson<EnvelopeData>();\n      if (data === undefined) continue;\n      if (handled.has(data.shareId)) continue; // already accepted or rejected\n      if (currentUserLogin !== null && data.sender === currentUserLogin) continue; // own share\n      if (data.expiresAt !== null && data.expiresAt <= Date.now()) continue;\n\n      result.push({\n        shareId: data.shareId,\n        sender: data.sender,\n        title: data.title,\n        mode: data.mode,\n        grantedAt: data.sharedAt,\n      });\n    }\n    result.sort((a, b) => b.grantedAt - a.grantedAt);\n    return result;\n  });\n}\n\nconst SharingStatePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharingStateResourceType)) return [];\n  return resource.fields;\n};\n\n// decision/{shareId} values are leaf JSON resources; follow fields only from SharingState.\nconst SharingStateFieldFilter: Filter = treeFilter.resourceTypeEq(SharingStateResourceType.name);\n\n/** Creates the acceptor's SharingState synchronized tree (single explicit root). */\nexport async function createSharingStateTree(\n  pl: PlClient,\n  stateRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    stateRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingStatePruningFunction,\n      fieldFilter: SharingStateFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** Maps an envelope resource id (signed) to its string form, for failure reporting. */\nexport function envelopeIdString(rid: SignedResourceId): string {\n  return resourceIdToString(rid);\n}\n"],"mappings":"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"}
+{"version":3,"file":"sharing_list.cjs","names":["envelopeProjectMap","SharingOutboxResourceType","SharedEnvelopeResourceType","treeFilter","Computable","normalizeEnvelopeData","AcceptanceFieldPrefix","SynchronizedTreeState","asShareId","SharingStateResourceType"],"sources":["../../src/middle_layer/sharing_list.ts"],"sourcesContent":["import type { PruningFunction } from \"@milaboratories/pl-tree\";\nimport { SynchronizedTreeState } from \"@milaboratories/pl-tree\";\nimport type { Filter, PlClient, SignedResourceId } from \"@milaboratories/pl-client\";\nimport {\n  isEveryoneUserLogin,\n  resourceIdToString,\n  resourceType,\n  resourceTypesEqual,\n  treeFilter,\n} from \"@milaboratories/pl-client\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { MiddleLayerEnvironment } from \"./middle_layer\";\nimport type { ProjectId } from \"@milaboratories/pl-model-common\";\nimport type {\n  EnvelopeAcceptance,\n  EnvelopeData,\n  EnvelopeMode,\n  EnvelopePayloadKind,\n  ShareId,\n} from \"../model/sharing_model\";\nimport {\n  AcceptanceFieldPrefix,\n  asShareId,\n  envelopeProjectMap,\n  normalizeEnvelopeData,\n  SharedEnvelopeResourceType,\n  SharingOutboxResourceType,\n  SharingStateResourceType,\n} from \"../model/sharing_model\";\n\n/** Donor-facing view of one outgoing share. */\nexport interface OutgoingShare {\n  shareId: ShareId; // stable logical identity of the share, preserved across changes\n  sharedAt: number; // this instance's creation time (ms epoch)\n  expiresAt?: number; // EnvelopeData.expiresAt; null maps to undefined = never expires\n  mode: EnvelopeMode;\n  title: string; // display name shown to recipients; defaults to the first project's name\n  /** What the share carries — a pack of projects, or one template document. */\n  payloadKind: EnvelopePayloadKind;\n  /** One entry per project in the pack, so the change UI can offer a per-project decision.\n   *  `projectId` is the donor's source project id; `updatedAt` is when this project's\n   *  snapshot was last (re)taken. Empty for a template share. */\n  projects: { projectId: ProjectId; label: string; updatedAt: number }[];\n  /** The shared template, for a template share; absent for a project share. */\n  template?: { label: string; blockCount: number };\n  /** Full recipient logins, from `ListGrants` on the envelope; `[\"*\"]` for everyone-shares. */\n  recipients: string[];\n  /** Whether {@link responses} can ever be populated for this share. A template share is granted\n   *  read-only, so no recipient can record a reply on the envelope and the donor never learns who\n   *  accepted — a view must say so rather than render an empty response list as \"nobody yet\". */\n  responsesAvailable: boolean;\n  /** Per recipient who has responded: their decision and when, from acceptance/{login}. */\n  responses: Record<string, { action: \"accepted\" | \"rejected\"; timestamp: number }>;\n}\n\n/** Per-project view for the donor's change UI, from the envelope's `projects` payload; empty\n *  for a payload that carries no project. */\nfunction envelopeProjects(data: EnvelopeData): OutgoingShare[\"projects\"] {\n  return Object.values(envelopeProjectMap(data)).map((p) => ({\n    projectId: p.source,\n    label: p.label,\n    updatedAt: p.updatedAt,\n  }));\n}\n\n/** Acceptor-facing view of one pending share. */\nexport interface PendingShare {\n  shareId: ShareId;\n  sender: string; // EnvelopeData.sender, display only\n  title: string; // display name shown to recipients; defaults to the first project's name\n  mode: EnvelopeMode; // v1 renders only \"copy\" entries\n  /** What the offer carries, so the recipient is told what they are being offered — projects to\n   *  copy, or a template for their own shelf. */\n  payloadKind: EnvelopePayloadKind;\n  grantedAt: number;\n}\n\nconst SharingOutboxPruningFunction: PruningFunction = (resource) => {\n  if (\n    !resourceTypesEqual(resource.type, SharingOutboxResourceType) &&\n    !resourceTypesEqual(resource.type, SharedEnvelopeResourceType)\n  )\n    return [];\n  return resource.fields;\n};\n\n// Server-side traversal scope (modern resourceTree path). Pruning is client-side ONLY and does\n// NOT stop the backend walk — without a fieldFilter the backend descends through the envelope's\n// project/{uuid} snapshots into the whole project graph (StreamManager etc.), whose field-driven\n// finality predicate then throws on the pruned-to-[] fields. Following fields only FROM the outbox\n// and the envelope stops the walk at the project snapshots (UserProject), which we never traverse.\nconst SharingOutboxFieldFilter: Filter = treeFilter.or(\n  treeFilter.resourceTypeEq(SharingOutboxResourceType.name),\n  treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name),\n);\n\n/** Intermediate of an outgoing share before its full recipient list is fetched: everything the\n *  tree carries synchronously, plus the envelope's signed id for the async `ListGrants` enrich. */\ntype OutgoingShareDraft = Omit<OutgoingShare, \"recipients\"> & { envelopeRid: SignedResourceId };\n\n/**\n * Reactive view of the donor's own outbox. Reads each live envelope's immutable\n * {@link EnvelopeData} plus the per-recipient `acceptance/{login}` records from the tree, then\n * enriches each share's full recipient list via `ListGrants` on the envelope (`[\"*\"]` for an\n * everyone-share). `ListGrants` is gated backend-side to the envelope owner (the donor), which is\n * exactly who reads this view.\n *\n * API-level only in M1 (no UI).\n */\nexport function createOutgoingSharesComputable(\n  pl: PlClient,\n  tree: SynchronizedTreeState,\n): Computable<OutgoingShare[] | undefined> {\n  return Computable.make(\n    (ctx) => {\n      const node = ctx.accessor(tree.entry()).node();\n      if (node === undefined) return undefined;\n\n      const drafts: OutgoingShareDraft[] = [];\n      // Outbox fields are keyed by shareId; each value is a SharedEnvelope.\n      for (const fieldName of node.listDynamicFields()) {\n        const envelope = node.traverse(fieldName);\n        if (envelope === undefined) continue;\n        if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n\n        const data = normalizeEnvelopeData(envelope.getDataAsJson<unknown>());\n        if (data === undefined) continue; // unknown version or payload kind — not ours to show\n\n        const responses: OutgoingShare[\"responses\"] = {};\n        for (const f of envelope.listDynamicFields()) {\n          if (!f.startsWith(AcceptanceFieldPrefix)) continue;\n          const login = f.slice(AcceptanceFieldPrefix.length);\n          const acc = envelope.traverse(f);\n          const accData = acc?.getDataAsJson<EnvelopeAcceptance>();\n          if (accData === undefined) continue;\n          responses[login] = { action: accData.action, timestamp: accData.timestamp };\n        }\n\n        drafts.push({\n          shareId: data.shareId,\n          sharedAt: data.sharedAt,\n          ...(data.expiresAt !== null ? { expiresAt: data.expiresAt } : {}),\n          mode: data.mode,\n          title: data.title,\n          payloadKind: data.payload.kind,\n          projects: envelopeProjects(data),\n          ...(data.payload.kind === \"template\"\n            ? {\n                template: {\n                  label: data.payload.label,\n                  blockCount: data.payload.document.blocks.length,\n                },\n              }\n            : {}),\n          responsesAvailable: data.payload.kind !== \"template\",\n          responses,\n          envelopeRid: envelope.id,\n        });\n      }\n      drafts.sort((a, b) => b.sharedAt - a.sharedAt);\n      return drafts;\n    },\n    {\n      // Resolve each share's recipients via listGrants. An everyone-grant maps to \"*\"; the donor's\n      // own grant is dropped. One tx per envelope so a just-revoked rid faults only its own read,\n      // which allSettled degrades to []. Recipients aren't cached — a live share's recipient set can\n      // change. Transactional listGrants when available, else the standalone gRPC-only RPC.\n      postprocessValue: async (\n        drafts: OutgoingShareDraft[] | undefined,\n      ): Promise<OutgoingShare[] | undefined> => {\n        if (drafts === undefined) return undefined;\n        const self = pl.userResources.authUser;\n        const toRecipients = (grants: { user: string }[]): string[] =>\n          grants.some((g) => isEveryoneUserLogin(g.user))\n            ? [\"*\"]\n            : grants.map((g) => g.user).filter((u) => u !== self);\n\n        const txGrants = pl.hasCapability(\"txListGrants:v1\");\n        const settled = await Promise.allSettled(\n          drafts.map((d) =>\n            txGrants\n              ? pl.withReadTx(\"ListShareGrant\", (tx) => tx.listGrants(d.envelopeRid))\n              : pl.userResources.listGrants(d.envelopeRid),\n          ),\n        );\n\n        return drafts.map(({ envelopeRid: _envelopeRid, ...share }, i): OutgoingShare => {\n          const r = settled[i];\n          return { ...share, recipients: r.status === \"fulfilled\" ? toRecipients(r.value) : [] };\n        });\n      },\n    },\n  );\n}\n\n/**\n * Creates the donor's outbox synchronized tree (single explicit root) plus the\n * {@link OutgoingShare} computable over it.\n */\nexport async function createOutgoingShares(\n  pl: PlClient,\n  outboxRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<{ tree: SynchronizedTreeState; computable: Computable<OutgoingShare[] | undefined> }> {\n  const tree = await SynchronizedTreeState.init(\n    pl,\n    outboxRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingOutboxPruningFunction,\n      fieldFilter: SharingOutboxFieldFilter,\n    },\n    env.logger,\n  );\n  return { computable: createOutgoingSharesComputable(pl, tree), tree };\n}\n\nconst DecisionFieldPrefix = \"decision/\";\n\nconst SharedEnvelopePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharedEnvelopeResourceType)) return [];\n  return resource.fields;\n};\n\n// Discovery only needs each envelope's immutable EnvelopeData (basic resource data); it must NOT\n// descend into the project snapshots. Following fields only FROM the envelope stops the walk at\n// the UserProject snapshots (their fields are never followed).\nconst PendingSharesFieldFilter: Filter = treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name);\n\n/**\n * Creates the acceptor's shared-resource discovery tree (a `{kind:'shared'}` seed over\n * {@link SharedEnvelopeResourceType}) plus the {@link PendingShare} computable over it.\n *\n * An envelope surfaces only when its shareId has NO decision/{shareId} on SharingState —\n * the dedup is applied by the caller, which holds the SharingState tree.\n */\nexport async function createPendingSharesTree(\n  pl: PlClient,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    {\n      kind: \"shared\",\n      resourceType: resourceType(\n        SharedEnvelopeResourceType.name,\n        SharedEnvelopeResourceType.version,\n      ),\n    },\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharedEnvelopePruningFunction,\n      fieldFilter: PendingSharesFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** A live envelope discovered in the acceptor's shared-resource tree: its signed resource id and\n *  decoded {@link EnvelopeData}. The accept/reject flow keys these by `data.shareId`. */\nexport type LiveEnvelope = { rid: SignedResourceId; data: EnvelopeData };\n\n/**\n * Builds a Computable yielding the acceptor's currently-live envelopes, read from the\n * shared-resource discovery tree the ML already maintains — the single discovery mechanism.\n * Accept/reject `.getValue()` this instead of re-streaming `ListUserResources`, so there is no\n * second discovery path. The envelope's signed `rid` (from the tree node) is what the write tx\n * needs; `copyEnvelopeProjectsIntoList` reads the project snapshots itself inside the tx.\n *\n * Returns `undefined` while the tree is still empty/unresolved (mirrors the other tree-backed\n * computables here). Yields a flat list; the caller dedups by `shareId` — at most one live\n * envelope per shareId is expected (the donor keeps one), and a replace tears the old one down.\n */\nexport function createLiveEnvelopesComputable(\n  sharedTree: SynchronizedTreeState,\n): Computable<LiveEnvelope[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n    const result: LiveEnvelope[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = normalizeEnvelopeData(envelope.getDataAsJson<unknown>());\n      // Same recognise-or-hide rule as the pending view, and for the same envelope: hiding an\n      // offer while accept could still resolve it would only move the problem.\n      if (data === undefined) continue;\n      result.push({ rid: envelope.id, data });\n    }\n    return result;\n  });\n}\n\n/**\n * Builds the {@link PendingShare} computable over the shared-resource discovery tree, filtered\n * against the set of already-handled shareIds (those with a decision/{shareId} in the acceptor's\n * SharingState). Both trees feed one Computable so it recomputes when either changes.\n *\n * `currentUserLogin` (when known) suppresses the user's own shares: a share-with-everybody grants\n * the everyone-user, so the donor discovers their own envelope as a pending share. There is no\n * scenario where a user accepts their own share, so they are dropped from the pending view.\n */\nexport function createPendingSharesComputable(\n  sharedTree: SynchronizedTreeState,\n  sharingStateTree: SynchronizedTreeState,\n  currentUserLogin: string | null,\n): Computable<PendingShare[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n\n    // Set of shareIds already handled (accepted or rejected) — dedup discovery on the logical share.\n    const stateNode = ctx.accessor(sharingStateTree.entry()).node();\n    const handled = new Set<ShareId>();\n    if (stateNode !== undefined)\n      for (const f of stateNode.listDynamicFields())\n        if (f.startsWith(DecisionFieldPrefix))\n          handled.add(asShareId(f.slice(DecisionFieldPrefix.length)));\n\n    const result: PendingShare[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = normalizeEnvelopeData(envelope.getDataAsJson<unknown>());\n      // An envelope whose schemaVersion or payload kind this build does not know is hidden, not\n      // offered: there is nothing useful to do with a share we cannot read.\n      if (data === undefined) continue;\n      if (handled.has(data.shareId)) continue; // already accepted or rejected\n      if (currentUserLogin !== null && data.sender === currentUserLogin) continue; // own share\n      if (data.expiresAt !== null && data.expiresAt <= Date.now()) continue;\n\n      result.push({\n        shareId: data.shareId,\n        sender: data.sender,\n        title: data.title,\n        mode: data.mode,\n        payloadKind: data.payload.kind,\n        grantedAt: data.sharedAt,\n      });\n    }\n    result.sort((a, b) => b.grantedAt - a.grantedAt);\n    return result;\n  });\n}\n\nconst SharingStatePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharingStateResourceType)) return [];\n  return resource.fields;\n};\n\n// decision/{shareId} values are leaf JSON resources; follow fields only from SharingState.\nconst SharingStateFieldFilter: Filter = treeFilter.resourceTypeEq(SharingStateResourceType.name);\n\n/** Creates the acceptor's SharingState synchronized tree (single explicit root). */\nexport async function createSharingStateTree(\n  pl: PlClient,\n  stateRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    stateRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingStatePruningFunction,\n      fieldFilter: SharingStateFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** Maps an envelope resource id (signed) to its string form, for failure reporting. */\nexport function envelopeIdString(rid: SignedResourceId): string {\n  return resourceIdToString(rid);\n}\n"],"mappings":"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"}

package/dist/middle_layer/sharing_list.d.ts

@@ -1,4 +1,4 @@
-import { EnvelopeMode, ShareId } from "../model/sharing_model.js";
+import { EnvelopeMode, EnvelopePayloadKind, ShareId } from "../model/sharing_model.js";
 import "./middle_layer.js";
 import { ProjectId } from "@milaboratories/pl-model-common";
 import { PlClient, SignedResourceId } from "@milaboratories/pl-client";
@@ -12,16 +12,27 @@ export interface OutgoingShare {
   expiresAt?: number;
   mode: EnvelopeMode;
   title: string;
+  /** What the share carries — a pack of projects, or one template document. */
+  payloadKind: EnvelopePayloadKind;
   /** One entry per project in the pack, so the change UI can offer a per-project decision.
    *  `projectId` is the donor's source project id; `updatedAt` is when this project's
-   *  snapshot was last (re)taken. */
+   *  snapshot was last (re)taken. Empty for a template share. */
   projects: {
     projectId: ProjectId;
     label: string;
     updatedAt: number;
   }[];
+  /** The shared template, for a template share; absent for a project share. */
+  template?: {
+    label: string;
+    blockCount: number;
+  };
   /** Full recipient logins, from `ListGrants` on the envelope; `["*"]` for everyone-shares. */
   recipients: string[];
+  /** Whether {@link responses} can ever be populated for this share. A template share is granted
+   *  read-only, so no recipient can record a reply on the envelope and the donor never learns who
+   *  accepted — a view must say so rather than render an empty response list as "nobody yet". */
+  responsesAvailable: boolean;
   /** Per recipient who has responded: their decision and when, from acceptance/{login}. */
   responses: Record<string, {
     action: "accepted" | "rejected";
@@ -34,6 +45,9 @@ export interface PendingShare {
   sender: string;
   title: string;
   mode: EnvelopeMode;
+  /** What the offer carries, so the recipient is told what they are being offered — projects to
+   *  copy, or a template for their own shelf. */
+  payloadKind: EnvelopePayloadKind;
   grantedAt: number;
 }
 //#endregion

package/dist/middle_layer/sharing_list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sharing_list.d.ts","names":[],"sources":["../../src/middle_layer/sharing_list.ts"],"mappings":";;;;;;;;iBA4BiB;EACf,SAAS;EACT;EACA;EACA,MAAM;EACN;;;;EAIA;IAAY,WAAW;IAAW;IAAe;;;EAEjD;;EAEA,WAAW;IAAiB;IAAiC;;;;iBAa9C;EACf,SAAS;EACT;EACA;EACA,MAAM;EACN"}
+{"version":3,"file":"sharing_list.d.ts","names":[],"sources":["../../src/middle_layer/sharing_list.ts"],"mappings":";;;;;;;;iBA+BiB;EACf,SAAS;EACT;EACA;EACA,MAAM;EACN;;EAEA,aAAa;;;;EAIb;IAAY,WAAW;IAAW;IAAe;;;EAEjD;IAAa;IAAe;;;EAE5B;;;;EAIA;;EAEA,WAAW;IAAiB;IAAiC;;;;iBAc9C;EACf,SAAS;EACT;EACA;EACA,MAAM;;;EAGN,aAAa;EACb"}

package/dist/middle_layer/sharing_list.js

@@ -1,11 +1,12 @@
-import { AcceptanceFieldPrefix, SharedEnvelopeResourceType, SharingOutboxResourceType, SharingStateResourceType, asShareId } from "../model/sharing_model.js";
+import { AcceptanceFieldPrefix, SharedEnvelopeResourceType, SharingOutboxResourceType, SharingStateResourceType, asShareId, envelopeProjectMap, normalizeEnvelopeData } from "../model/sharing_model.js";
 import { isEveryoneUserLogin, resourceType, resourceTypesEqual, treeFilter } from "@milaboratories/pl-client";
 import { SynchronizedTreeState } from "@milaboratories/pl-tree";
 import { Computable } from "@milaboratories/computable";
 //#region src/middle_layer/sharing_list.ts
-/** Per-project view for the donor's change UI, from {@link EnvelopeData.projects}. */
+/** Per-project view for the donor's change UI, from the envelope's `projects` payload; empty
+*  for a payload that carries no project. */
 function envelopeProjects(data) {
-	return Object.values(data.projects).map((p) => ({
+	return Object.values(envelopeProjectMap(data)).map((p) => ({
 		projectId: p.source,
 		label: p.label,
 		updatedAt: p.updatedAt
@@ -34,7 +35,7 @@ function createOutgoingSharesComputable(pl, tree) {
 			const envelope = node.traverse(fieldName);
 			if (envelope === void 0) continue;
 			if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;
-			const data = envelope.getDataAsJson();
+			const data = normalizeEnvelopeData(envelope.getDataAsJson());
 			if (data === void 0) continue;
 			const responses = {};
 			for (const f of envelope.listDynamicFields()) {
@@ -53,7 +54,13 @@ function createOutgoingSharesComputable(pl, tree) {
 				...data.expiresAt !== null ? { expiresAt: data.expiresAt } : {},
 				mode: data.mode,
 				title: data.title,
+				payloadKind: data.payload.kind,
 				projects: envelopeProjects(data),
+				...data.payload.kind === "template" ? { template: {
+					label: data.payload.label,
+					blockCount: data.payload.document.blocks.length
+				} } : {},
+				responsesAvailable: data.payload.kind !== "template",
 				responses,
 				envelopeRid: envelope.id
 			});
@@ -131,7 +138,7 @@ function createLiveEnvelopesComputable(sharedTree) {
 		for (const envelope of roots) {
 			if (envelope === void 0) continue;
 			if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;
-			const data = envelope.getDataAsJson();
+			const data = normalizeEnvelopeData(envelope.getDataAsJson());
 			if (data === void 0) continue;
 			result.push({
 				rid: envelope.id,
@@ -162,7 +169,7 @@ function createPendingSharesComputable(sharedTree, sharingStateTree, currentUser
 		for (const envelope of roots) {
 			if (envelope === void 0) continue;
 			if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;
-			const data = envelope.getDataAsJson();
+			const data = normalizeEnvelopeData(envelope.getDataAsJson());
 			if (data === void 0) continue;
 			if (handled.has(data.shareId)) continue;
 			if (currentUserLogin !== null && data.sender === currentUserLogin) continue;
@@ -172,6 +179,7 @@ function createPendingSharesComputable(sharedTree, sharingStateTree, currentUser
 				sender: data.sender,
 				title: data.title,
 				mode: data.mode,
+				payloadKind: data.payload.kind,
 				grantedAt: data.sharedAt
 			});
 		}

package/dist/middle_layer/sharing_list.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharing_list.js","names":[],"sources":["../../src/middle_layer/sharing_list.ts"],"sourcesContent":["import type { PruningFunction } from \"@milaboratories/pl-tree\";\nimport { SynchronizedTreeState } from \"@milaboratories/pl-tree\";\nimport type { Filter, PlClient, SignedResourceId } from \"@milaboratories/pl-client\";\nimport {\n  isEveryoneUserLogin,\n  resourceIdToString,\n  resourceType,\n  resourceTypesEqual,\n  treeFilter,\n} from \"@milaboratories/pl-client\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { MiddleLayerEnvironment } from \"./middle_layer\";\nimport type { ProjectId } from \"@milaboratories/pl-model-common\";\nimport type {\n  EnvelopeAcceptance,\n  EnvelopeData,\n  EnvelopeMode,\n  ShareId,\n} from \"../model/sharing_model\";\nimport {\n  AcceptanceFieldPrefix,\n  asShareId,\n  SharedEnvelopeResourceType,\n  SharingOutboxResourceType,\n  SharingStateResourceType,\n} from \"../model/sharing_model\";\n\n/** Donor-facing view of one outgoing share. */\nexport interface OutgoingShare {\n  shareId: ShareId; // stable logical identity of the share, preserved across changes\n  sharedAt: number; // this instance's creation time (ms epoch)\n  expiresAt?: number; // EnvelopeData.expiresAt; null maps to undefined = never expires\n  mode: EnvelopeMode;\n  title: string; // display name shown to recipients; defaults to the first project's name\n  /** One entry per project in the pack, so the change UI can offer a per-project decision.\n   *  `projectId` is the donor's source project id; `updatedAt` is when this project's\n   *  snapshot was last (re)taken. */\n  projects: { projectId: ProjectId; label: string; updatedAt: number }[];\n  /** Full recipient logins, from `ListGrants` on the envelope; `[\"*\"]` for everyone-shares. */\n  recipients: string[];\n  /** Per recipient who has responded: their decision and when, from acceptance/{login}. */\n  responses: Record<string, { action: \"accepted\" | \"rejected\"; timestamp: number }>;\n}\n\n/** Per-project view for the donor's change UI, from {@link EnvelopeData.projects}. */\nfunction envelopeProjects(data: EnvelopeData): OutgoingShare[\"projects\"] {\n  return Object.values(data.projects).map((p) => ({\n    projectId: p.source,\n    label: p.label,\n    updatedAt: p.updatedAt,\n  }));\n}\n\n/** Acceptor-facing view of one pending share. */\nexport interface PendingShare {\n  shareId: ShareId;\n  sender: string; // EnvelopeData.sender, display only\n  title: string; // display name shown to recipients; defaults to the first project's name\n  mode: EnvelopeMode; // v1 renders only \"copy\" entries\n  grantedAt: number;\n}\n\nconst SharingOutboxPruningFunction: PruningFunction = (resource) => {\n  if (\n    !resourceTypesEqual(resource.type, SharingOutboxResourceType) &&\n    !resourceTypesEqual(resource.type, SharedEnvelopeResourceType)\n  )\n    return [];\n  return resource.fields;\n};\n\n// Server-side traversal scope (modern resourceTree path). Pruning is client-side ONLY and does\n// NOT stop the backend walk — without a fieldFilter the backend descends through the envelope's\n// project/{uuid} snapshots into the whole project graph (StreamManager etc.), whose field-driven\n// finality predicate then throws on the pruned-to-[] fields. Following fields only FROM the outbox\n// and the envelope stops the walk at the project snapshots (UserProject), which we never traverse.\nconst SharingOutboxFieldFilter: Filter = treeFilter.or(\n  treeFilter.resourceTypeEq(SharingOutboxResourceType.name),\n  treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name),\n);\n\n/** Intermediate of an outgoing share before its full recipient list is fetched: everything the\n *  tree carries synchronously, plus the envelope's signed id for the async `ListGrants` enrich. */\ntype OutgoingShareDraft = Omit<OutgoingShare, \"recipients\"> & { envelopeRid: SignedResourceId };\n\n/**\n * Reactive view of the donor's own outbox. Reads each live envelope's immutable\n * {@link EnvelopeData} plus the per-recipient `acceptance/{login}` records from the tree, then\n * enriches each share's full recipient list via `ListGrants` on the envelope (`[\"*\"]` for an\n * everyone-share). `ListGrants` is gated backend-side to the envelope owner (the donor), which is\n * exactly who reads this view.\n *\n * API-level only in M1 (no UI).\n */\nexport function createOutgoingSharesComputable(\n  pl: PlClient,\n  tree: SynchronizedTreeState,\n): Computable<OutgoingShare[] | undefined> {\n  return Computable.make(\n    (ctx) => {\n      const node = ctx.accessor(tree.entry()).node();\n      if (node === undefined) return undefined;\n\n      const drafts: OutgoingShareDraft[] = [];\n      // Outbox fields are keyed by shareId; each value is a SharedEnvelope.\n      for (const fieldName of node.listDynamicFields()) {\n        const envelope = node.traverse(fieldName);\n        if (envelope === undefined) continue;\n        if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n\n        const data = envelope.getDataAsJson<EnvelopeData>();\n        if (data === undefined) continue;\n\n        const responses: OutgoingShare[\"responses\"] = {};\n        for (const f of envelope.listDynamicFields()) {\n          if (!f.startsWith(AcceptanceFieldPrefix)) continue;\n          const login = f.slice(AcceptanceFieldPrefix.length);\n          const acc = envelope.traverse(f);\n          const accData = acc?.getDataAsJson<EnvelopeAcceptance>();\n          if (accData === undefined) continue;\n          responses[login] = { action: accData.action, timestamp: accData.timestamp };\n        }\n\n        drafts.push({\n          shareId: data.shareId,\n          sharedAt: data.sharedAt,\n          ...(data.expiresAt !== null ? { expiresAt: data.expiresAt } : {}),\n          mode: data.mode,\n          title: data.title,\n          projects: envelopeProjects(data),\n          responses,\n          envelopeRid: envelope.id,\n        });\n      }\n      drafts.sort((a, b) => b.sharedAt - a.sharedAt);\n      return drafts;\n    },\n    {\n      // Resolve each share's recipients via listGrants. An everyone-grant maps to \"*\"; the donor's\n      // own grant is dropped. One tx per envelope so a just-revoked rid faults only its own read,\n      // which allSettled degrades to []. Recipients aren't cached — a live share's recipient set can\n      // change. Transactional listGrants when available, else the standalone gRPC-only RPC.\n      postprocessValue: async (\n        drafts: OutgoingShareDraft[] | undefined,\n      ): Promise<OutgoingShare[] | undefined> => {\n        if (drafts === undefined) return undefined;\n        const self = pl.userResources.authUser;\n        const toRecipients = (grants: { user: string }[]): string[] =>\n          grants.some((g) => isEveryoneUserLogin(g.user))\n            ? [\"*\"]\n            : grants.map((g) => g.user).filter((u) => u !== self);\n\n        const txGrants = pl.hasCapability(\"txListGrants:v1\");\n        const settled = await Promise.allSettled(\n          drafts.map((d) =>\n            txGrants\n              ? pl.withReadTx(\"ListShareGrant\", (tx) => tx.listGrants(d.envelopeRid))\n              : pl.userResources.listGrants(d.envelopeRid),\n          ),\n        );\n\n        return drafts.map(({ envelopeRid: _envelopeRid, ...share }, i): OutgoingShare => {\n          const r = settled[i];\n          return { ...share, recipients: r.status === \"fulfilled\" ? toRecipients(r.value) : [] };\n        });\n      },\n    },\n  );\n}\n\n/**\n * Creates the donor's outbox synchronized tree (single explicit root) plus the\n * {@link OutgoingShare} computable over it.\n */\nexport async function createOutgoingShares(\n  pl: PlClient,\n  outboxRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<{ tree: SynchronizedTreeState; computable: Computable<OutgoingShare[] | undefined> }> {\n  const tree = await SynchronizedTreeState.init(\n    pl,\n    outboxRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingOutboxPruningFunction,\n      fieldFilter: SharingOutboxFieldFilter,\n    },\n    env.logger,\n  );\n  return { computable: createOutgoingSharesComputable(pl, tree), tree };\n}\n\nconst DecisionFieldPrefix = \"decision/\";\n\nconst SharedEnvelopePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharedEnvelopeResourceType)) return [];\n  return resource.fields;\n};\n\n// Discovery only needs each envelope's immutable EnvelopeData (basic resource data); it must NOT\n// descend into the project snapshots. Following fields only FROM the envelope stops the walk at\n// the UserProject snapshots (their fields are never followed).\nconst PendingSharesFieldFilter: Filter = treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name);\n\n/**\n * Creates the acceptor's shared-resource discovery tree (a `{kind:'shared'}` seed over\n * {@link SharedEnvelopeResourceType}) plus the {@link PendingShare} computable over it.\n *\n * An envelope surfaces only when its shareId has NO decision/{shareId} on SharingState —\n * the dedup is applied by the caller, which holds the SharingState tree.\n */\nexport async function createPendingSharesTree(\n  pl: PlClient,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    {\n      kind: \"shared\",\n      resourceType: resourceType(\n        SharedEnvelopeResourceType.name,\n        SharedEnvelopeResourceType.version,\n      ),\n    },\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharedEnvelopePruningFunction,\n      fieldFilter: PendingSharesFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** A live envelope discovered in the acceptor's shared-resource tree: its signed resource id and\n *  decoded {@link EnvelopeData}. The accept/reject flow keys these by `data.shareId`. */\nexport type LiveEnvelope = { rid: SignedResourceId; data: EnvelopeData };\n\n/**\n * Builds a Computable yielding the acceptor's currently-live envelopes, read from the\n * shared-resource discovery tree the ML already maintains — the single discovery mechanism.\n * Accept/reject `.getValue()` this instead of re-streaming `ListUserResources`, so there is no\n * second discovery path. The envelope's signed `rid` (from the tree node) is what the write tx\n * needs; `copyEnvelopeProjectsIntoList` reads the project snapshots itself inside the tx.\n *\n * Returns `undefined` while the tree is still empty/unresolved (mirrors the other tree-backed\n * computables here). Yields a flat list; the caller dedups by `shareId` — at most one live\n * envelope per shareId is expected (the donor keeps one), and a replace tears the old one down.\n */\nexport function createLiveEnvelopesComputable(\n  sharedTree: SynchronizedTreeState,\n): Computable<LiveEnvelope[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n    const result: LiveEnvelope[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = envelope.getDataAsJson<EnvelopeData>();\n      if (data === undefined) continue;\n      result.push({ rid: envelope.id, data });\n    }\n    return result;\n  });\n}\n\n/**\n * Builds the {@link PendingShare} computable over the shared-resource discovery tree, filtered\n * against the set of already-handled shareIds (those with a decision/{shareId} in the acceptor's\n * SharingState). Both trees feed one Computable so it recomputes when either changes.\n *\n * `currentUserLogin` (when known) suppresses the user's own shares: a share-with-everybody grants\n * the everyone-user, so the donor discovers their own envelope as a pending share. There is no\n * scenario where a user accepts their own share, so they are dropped from the pending view.\n */\nexport function createPendingSharesComputable(\n  sharedTree: SynchronizedTreeState,\n  sharingStateTree: SynchronizedTreeState,\n  currentUserLogin: string | null,\n): Computable<PendingShare[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n\n    // Set of shareIds already handled (accepted or rejected) — dedup discovery on the logical share.\n    const stateNode = ctx.accessor(sharingStateTree.entry()).node();\n    const handled = new Set<ShareId>();\n    if (stateNode !== undefined)\n      for (const f of stateNode.listDynamicFields())\n        if (f.startsWith(DecisionFieldPrefix))\n          handled.add(asShareId(f.slice(DecisionFieldPrefix.length)));\n\n    const result: PendingShare[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = envelope.getDataAsJson<EnvelopeData>();\n      if (data === undefined) continue;\n      if (handled.has(data.shareId)) continue; // already accepted or rejected\n      if (currentUserLogin !== null && data.sender === currentUserLogin) continue; // own share\n      if (data.expiresAt !== null && data.expiresAt <= Date.now()) continue;\n\n      result.push({\n        shareId: data.shareId,\n        sender: data.sender,\n        title: data.title,\n        mode: data.mode,\n        grantedAt: data.sharedAt,\n      });\n    }\n    result.sort((a, b) => b.grantedAt - a.grantedAt);\n    return result;\n  });\n}\n\nconst SharingStatePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharingStateResourceType)) return [];\n  return resource.fields;\n};\n\n// decision/{shareId} values are leaf JSON resources; follow fields only from SharingState.\nconst SharingStateFieldFilter: Filter = treeFilter.resourceTypeEq(SharingStateResourceType.name);\n\n/** Creates the acceptor's SharingState synchronized tree (single explicit root). */\nexport async function createSharingStateTree(\n  pl: PlClient,\n  stateRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    stateRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingStatePruningFunction,\n      fieldFilter: SharingStateFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** Maps an envelope resource id (signed) to its string form, for failure reporting. */\nexport function envelopeIdString(rid: SignedResourceId): string {\n  return resourceIdToString(rid);\n}\n"],"mappings":"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"}
+{"version":3,"file":"sharing_list.js","names":[],"sources":["../../src/middle_layer/sharing_list.ts"],"sourcesContent":["import type { PruningFunction } from \"@milaboratories/pl-tree\";\nimport { SynchronizedTreeState } from \"@milaboratories/pl-tree\";\nimport type { Filter, PlClient, SignedResourceId } from \"@milaboratories/pl-client\";\nimport {\n  isEveryoneUserLogin,\n  resourceIdToString,\n  resourceType,\n  resourceTypesEqual,\n  treeFilter,\n} from \"@milaboratories/pl-client\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { MiddleLayerEnvironment } from \"./middle_layer\";\nimport type { ProjectId } from \"@milaboratories/pl-model-common\";\nimport type {\n  EnvelopeAcceptance,\n  EnvelopeData,\n  EnvelopeMode,\n  EnvelopePayloadKind,\n  ShareId,\n} from \"../model/sharing_model\";\nimport {\n  AcceptanceFieldPrefix,\n  asShareId,\n  envelopeProjectMap,\n  normalizeEnvelopeData,\n  SharedEnvelopeResourceType,\n  SharingOutboxResourceType,\n  SharingStateResourceType,\n} from \"../model/sharing_model\";\n\n/** Donor-facing view of one outgoing share. */\nexport interface OutgoingShare {\n  shareId: ShareId; // stable logical identity of the share, preserved across changes\n  sharedAt: number; // this instance's creation time (ms epoch)\n  expiresAt?: number; // EnvelopeData.expiresAt; null maps to undefined = never expires\n  mode: EnvelopeMode;\n  title: string; // display name shown to recipients; defaults to the first project's name\n  /** What the share carries — a pack of projects, or one template document. */\n  payloadKind: EnvelopePayloadKind;\n  /** One entry per project in the pack, so the change UI can offer a per-project decision.\n   *  `projectId` is the donor's source project id; `updatedAt` is when this project's\n   *  snapshot was last (re)taken. Empty for a template share. */\n  projects: { projectId: ProjectId; label: string; updatedAt: number }[];\n  /** The shared template, for a template share; absent for a project share. */\n  template?: { label: string; blockCount: number };\n  /** Full recipient logins, from `ListGrants` on the envelope; `[\"*\"]` for everyone-shares. */\n  recipients: string[];\n  /** Whether {@link responses} can ever be populated for this share. A template share is granted\n   *  read-only, so no recipient can record a reply on the envelope and the donor never learns who\n   *  accepted — a view must say so rather than render an empty response list as \"nobody yet\". */\n  responsesAvailable: boolean;\n  /** Per recipient who has responded: their decision and when, from acceptance/{login}. */\n  responses: Record<string, { action: \"accepted\" | \"rejected\"; timestamp: number }>;\n}\n\n/** Per-project view for the donor's change UI, from the envelope's `projects` payload; empty\n *  for a payload that carries no project. */\nfunction envelopeProjects(data: EnvelopeData): OutgoingShare[\"projects\"] {\n  return Object.values(envelopeProjectMap(data)).map((p) => ({\n    projectId: p.source,\n    label: p.label,\n    updatedAt: p.updatedAt,\n  }));\n}\n\n/** Acceptor-facing view of one pending share. */\nexport interface PendingShare {\n  shareId: ShareId;\n  sender: string; // EnvelopeData.sender, display only\n  title: string; // display name shown to recipients; defaults to the first project's name\n  mode: EnvelopeMode; // v1 renders only \"copy\" entries\n  /** What the offer carries, so the recipient is told what they are being offered — projects to\n   *  copy, or a template for their own shelf. */\n  payloadKind: EnvelopePayloadKind;\n  grantedAt: number;\n}\n\nconst SharingOutboxPruningFunction: PruningFunction = (resource) => {\n  if (\n    !resourceTypesEqual(resource.type, SharingOutboxResourceType) &&\n    !resourceTypesEqual(resource.type, SharedEnvelopeResourceType)\n  )\n    return [];\n  return resource.fields;\n};\n\n// Server-side traversal scope (modern resourceTree path). Pruning is client-side ONLY and does\n// NOT stop the backend walk — without a fieldFilter the backend descends through the envelope's\n// project/{uuid} snapshots into the whole project graph (StreamManager etc.), whose field-driven\n// finality predicate then throws on the pruned-to-[] fields. Following fields only FROM the outbox\n// and the envelope stops the walk at the project snapshots (UserProject), which we never traverse.\nconst SharingOutboxFieldFilter: Filter = treeFilter.or(\n  treeFilter.resourceTypeEq(SharingOutboxResourceType.name),\n  treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name),\n);\n\n/** Intermediate of an outgoing share before its full recipient list is fetched: everything the\n *  tree carries synchronously, plus the envelope's signed id for the async `ListGrants` enrich. */\ntype OutgoingShareDraft = Omit<OutgoingShare, \"recipients\"> & { envelopeRid: SignedResourceId };\n\n/**\n * Reactive view of the donor's own outbox. Reads each live envelope's immutable\n * {@link EnvelopeData} plus the per-recipient `acceptance/{login}` records from the tree, then\n * enriches each share's full recipient list via `ListGrants` on the envelope (`[\"*\"]` for an\n * everyone-share). `ListGrants` is gated backend-side to the envelope owner (the donor), which is\n * exactly who reads this view.\n *\n * API-level only in M1 (no UI).\n */\nexport function createOutgoingSharesComputable(\n  pl: PlClient,\n  tree: SynchronizedTreeState,\n): Computable<OutgoingShare[] | undefined> {\n  return Computable.make(\n    (ctx) => {\n      const node = ctx.accessor(tree.entry()).node();\n      if (node === undefined) return undefined;\n\n      const drafts: OutgoingShareDraft[] = [];\n      // Outbox fields are keyed by shareId; each value is a SharedEnvelope.\n      for (const fieldName of node.listDynamicFields()) {\n        const envelope = node.traverse(fieldName);\n        if (envelope === undefined) continue;\n        if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n\n        const data = normalizeEnvelopeData(envelope.getDataAsJson<unknown>());\n        if (data === undefined) continue; // unknown version or payload kind — not ours to show\n\n        const responses: OutgoingShare[\"responses\"] = {};\n        for (const f of envelope.listDynamicFields()) {\n          if (!f.startsWith(AcceptanceFieldPrefix)) continue;\n          const login = f.slice(AcceptanceFieldPrefix.length);\n          const acc = envelope.traverse(f);\n          const accData = acc?.getDataAsJson<EnvelopeAcceptance>();\n          if (accData === undefined) continue;\n          responses[login] = { action: accData.action, timestamp: accData.timestamp };\n        }\n\n        drafts.push({\n          shareId: data.shareId,\n          sharedAt: data.sharedAt,\n          ...(data.expiresAt !== null ? { expiresAt: data.expiresAt } : {}),\n          mode: data.mode,\n          title: data.title,\n          payloadKind: data.payload.kind,\n          projects: envelopeProjects(data),\n          ...(data.payload.kind === \"template\"\n            ? {\n                template: {\n                  label: data.payload.label,\n                  blockCount: data.payload.document.blocks.length,\n                },\n              }\n            : {}),\n          responsesAvailable: data.payload.kind !== \"template\",\n          responses,\n          envelopeRid: envelope.id,\n        });\n      }\n      drafts.sort((a, b) => b.sharedAt - a.sharedAt);\n      return drafts;\n    },\n    {\n      // Resolve each share's recipients via listGrants. An everyone-grant maps to \"*\"; the donor's\n      // own grant is dropped. One tx per envelope so a just-revoked rid faults only its own read,\n      // which allSettled degrades to []. Recipients aren't cached — a live share's recipient set can\n      // change. Transactional listGrants when available, else the standalone gRPC-only RPC.\n      postprocessValue: async (\n        drafts: OutgoingShareDraft[] | undefined,\n      ): Promise<OutgoingShare[] | undefined> => {\n        if (drafts === undefined) return undefined;\n        const self = pl.userResources.authUser;\n        const toRecipients = (grants: { user: string }[]): string[] =>\n          grants.some((g) => isEveryoneUserLogin(g.user))\n            ? [\"*\"]\n            : grants.map((g) => g.user).filter((u) => u !== self);\n\n        const txGrants = pl.hasCapability(\"txListGrants:v1\");\n        const settled = await Promise.allSettled(\n          drafts.map((d) =>\n            txGrants\n              ? pl.withReadTx(\"ListShareGrant\", (tx) => tx.listGrants(d.envelopeRid))\n              : pl.userResources.listGrants(d.envelopeRid),\n          ),\n        );\n\n        return drafts.map(({ envelopeRid: _envelopeRid, ...share }, i): OutgoingShare => {\n          const r = settled[i];\n          return { ...share, recipients: r.status === \"fulfilled\" ? toRecipients(r.value) : [] };\n        });\n      },\n    },\n  );\n}\n\n/**\n * Creates the donor's outbox synchronized tree (single explicit root) plus the\n * {@link OutgoingShare} computable over it.\n */\nexport async function createOutgoingShares(\n  pl: PlClient,\n  outboxRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<{ tree: SynchronizedTreeState; computable: Computable<OutgoingShare[] | undefined> }> {\n  const tree = await SynchronizedTreeState.init(\n    pl,\n    outboxRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingOutboxPruningFunction,\n      fieldFilter: SharingOutboxFieldFilter,\n    },\n    env.logger,\n  );\n  return { computable: createOutgoingSharesComputable(pl, tree), tree };\n}\n\nconst DecisionFieldPrefix = \"decision/\";\n\nconst SharedEnvelopePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharedEnvelopeResourceType)) return [];\n  return resource.fields;\n};\n\n// Discovery only needs each envelope's immutable EnvelopeData (basic resource data); it must NOT\n// descend into the project snapshots. Following fields only FROM the envelope stops the walk at\n// the UserProject snapshots (their fields are never followed).\nconst PendingSharesFieldFilter: Filter = treeFilter.resourceTypeEq(SharedEnvelopeResourceType.name);\n\n/**\n * Creates the acceptor's shared-resource discovery tree (a `{kind:'shared'}` seed over\n * {@link SharedEnvelopeResourceType}) plus the {@link PendingShare} computable over it.\n *\n * An envelope surfaces only when its shareId has NO decision/{shareId} on SharingState —\n * the dedup is applied by the caller, which holds the SharingState tree.\n */\nexport async function createPendingSharesTree(\n  pl: PlClient,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    {\n      kind: \"shared\",\n      resourceType: resourceType(\n        SharedEnvelopeResourceType.name,\n        SharedEnvelopeResourceType.version,\n      ),\n    },\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharedEnvelopePruningFunction,\n      fieldFilter: PendingSharesFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** A live envelope discovered in the acceptor's shared-resource tree: its signed resource id and\n *  decoded {@link EnvelopeData}. The accept/reject flow keys these by `data.shareId`. */\nexport type LiveEnvelope = { rid: SignedResourceId; data: EnvelopeData };\n\n/**\n * Builds a Computable yielding the acceptor's currently-live envelopes, read from the\n * shared-resource discovery tree the ML already maintains — the single discovery mechanism.\n * Accept/reject `.getValue()` this instead of re-streaming `ListUserResources`, so there is no\n * second discovery path. The envelope's signed `rid` (from the tree node) is what the write tx\n * needs; `copyEnvelopeProjectsIntoList` reads the project snapshots itself inside the tx.\n *\n * Returns `undefined` while the tree is still empty/unresolved (mirrors the other tree-backed\n * computables here). Yields a flat list; the caller dedups by `shareId` — at most one live\n * envelope per shareId is expected (the donor keeps one), and a replace tears the old one down.\n */\nexport function createLiveEnvelopesComputable(\n  sharedTree: SynchronizedTreeState,\n): Computable<LiveEnvelope[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n    const result: LiveEnvelope[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = normalizeEnvelopeData(envelope.getDataAsJson<unknown>());\n      // Same recognise-or-hide rule as the pending view, and for the same envelope: hiding an\n      // offer while accept could still resolve it would only move the problem.\n      if (data === undefined) continue;\n      result.push({ rid: envelope.id, data });\n    }\n    return result;\n  });\n}\n\n/**\n * Builds the {@link PendingShare} computable over the shared-resource discovery tree, filtered\n * against the set of already-handled shareIds (those with a decision/{shareId} in the acceptor's\n * SharingState). Both trees feed one Computable so it recomputes when either changes.\n *\n * `currentUserLogin` (when known) suppresses the user's own shares: a share-with-everybody grants\n * the everyone-user, so the donor discovers their own envelope as a pending share. There is no\n * scenario where a user accepts their own share, so they are dropped from the pending view.\n */\nexport function createPendingSharesComputable(\n  sharedTree: SynchronizedTreeState,\n  sharingStateTree: SynchronizedTreeState,\n  currentUserLogin: string | null,\n): Computable<PendingShare[] | undefined> {\n  return Computable.make((ctx) => {\n    const roots = ctx.accessor(sharedTree.rootsEntry()).nodes();\n\n    // Set of shareIds already handled (accepted or rejected) — dedup discovery on the logical share.\n    const stateNode = ctx.accessor(sharingStateTree.entry()).node();\n    const handled = new Set<ShareId>();\n    if (stateNode !== undefined)\n      for (const f of stateNode.listDynamicFields())\n        if (f.startsWith(DecisionFieldPrefix))\n          handled.add(asShareId(f.slice(DecisionFieldPrefix.length)));\n\n    const result: PendingShare[] = [];\n    for (const envelope of roots) {\n      if (envelope === undefined) continue;\n      if (!resourceTypesEqual(envelope.resourceType, SharedEnvelopeResourceType)) continue;\n      const data = normalizeEnvelopeData(envelope.getDataAsJson<unknown>());\n      // An envelope whose schemaVersion or payload kind this build does not know is hidden, not\n      // offered: there is nothing useful to do with a share we cannot read.\n      if (data === undefined) continue;\n      if (handled.has(data.shareId)) continue; // already accepted or rejected\n      if (currentUserLogin !== null && data.sender === currentUserLogin) continue; // own share\n      if (data.expiresAt !== null && data.expiresAt <= Date.now()) continue;\n\n      result.push({\n        shareId: data.shareId,\n        sender: data.sender,\n        title: data.title,\n        mode: data.mode,\n        payloadKind: data.payload.kind,\n        grantedAt: data.sharedAt,\n      });\n    }\n    result.sort((a, b) => b.grantedAt - a.grantedAt);\n    return result;\n  });\n}\n\nconst SharingStatePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, SharingStateResourceType)) return [];\n  return resource.fields;\n};\n\n// decision/{shareId} values are leaf JSON resources; follow fields only from SharingState.\nconst SharingStateFieldFilter: Filter = treeFilter.resourceTypeEq(SharingStateResourceType.name);\n\n/** Creates the acceptor's SharingState synchronized tree (single explicit root). */\nexport async function createSharingStateTree(\n  pl: PlClient,\n  stateRid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<SynchronizedTreeState> {\n  return await SynchronizedTreeState.init(\n    pl,\n    stateRid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: SharingStatePruningFunction,\n      fieldFilter: SharingStateFieldFilter,\n    },\n    env.logger,\n  );\n}\n\n/** Maps an envelope resource id (signed) to its string form, for failure reporting. */\nexport function envelopeIdString(rid: SignedResourceId): string {\n  return resourceIdToString(rid);\n}\n"],"mappings":"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"}

package/dist/middle_layer/template_list.cjs

@@ -0,0 +1,72 @@
+let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
+let _milaboratories_pl_client = require("@milaboratories/pl-client");
+let _milaboratories_pl_tree = require("@milaboratories/pl-tree");
+let _milaboratories_computable = require("@milaboratories/computable");
+//#region src/middle_layer/template_list.ts
+const TemplatesField = "templates";
+const TemplatesResourceType = {
+	name: "Templates",
+	version: "1"
+};
+const TemplateResourceType = {
+	name: "UserTemplate",
+	version: "1"
+};
+/** Mutable: the only part of a stored template a rename may touch. */
+const TemplateLabelKey = "TemplateLabel";
+const TemplateCreatedTimestamp = "TemplateCreated";
+/** Decodes the immutable `data` blob of a `UserTemplate` read through a transaction. The
+*  single raw-decode site; the tree side reads the same JSON with `getDataAsJson`. */
+function decodeStoredTemplateData(data) {
+	return JSON.parse(Buffer.from(data).toString("utf-8"));
+}
+const TemplatesListTreePruningFunction = (resource) => {
+	if (!(0, _milaboratories_pl_client.resourceTypesEqual)(resource.type, TemplatesResourceType)) return [];
+	return resource.fields;
+};
+const templatesListFieldFilter = _milaboratories_pl_client.treeFilter.resourceTypeEq(TemplatesResourceType.name);
+async function createTemplateList(pl, rid, env) {
+	const tree = await _milaboratories_pl_tree.SynchronizedTreeState.init(pl, rid, {
+		...env.ops.defaultTreeOptions,
+		pruning: TemplatesListTreePruningFunction,
+		fieldFilter: templatesListFieldFilter
+	}, env.logger);
+	return {
+		computable: _milaboratories_computable.Computable.make((ctx) => {
+			const node = ctx.accessor(tree.entry()).node();
+			if (node === void 0) return void 0;
+			const result = [];
+			for (const field of node.listDynamicFields()) {
+				const tpl = node.traverse(field);
+				if (tpl === void 0) continue;
+				const data = tpl.getDataAsJson();
+				if (data === void 0) continue;
+				const label = (0, _milaboratories_ts_helpers.notEmpty)(tpl.getKeyValueAsJson(TemplateLabelKey));
+				const created = (0, _milaboratories_ts_helpers.notEmpty)(tpl.getKeyValueAsJson(TemplateCreatedTimestamp));
+				result.push({
+					id: (0, _milaboratories_pl_client.resourceIdToString)(tpl.id),
+					label,
+					created: new Date(created),
+					blockCount: data.document.blocks.length,
+					...data.sourceProjectLabel !== void 0 ? { sourceProjectLabel: data.sourceProjectLabel } : {},
+					...data.sender !== void 0 ? { sender: data.sender } : {}
+				});
+			}
+			result.sort((a, b) => b.created.valueOf() - a.created.valueOf());
+			return result;
+		}).withStableType(),
+		tree
+	};
+}
+//#endregion
+exports.TemplateCreatedTimestamp = TemplateCreatedTimestamp;
+exports.TemplateLabelKey = TemplateLabelKey;
+exports.TemplateResourceType = TemplateResourceType;
+exports.TemplatesField = TemplatesField;
+exports.TemplatesListTreePruningFunction = TemplatesListTreePruningFunction;
+exports.TemplatesResourceType = TemplatesResourceType;
+exports.createTemplateList = createTemplateList;
+exports.decodeStoredTemplateData = decodeStoredTemplateData;
+exports.templatesListFieldFilter = templatesListFieldFilter;
+
+//# sourceMappingURL=template_list.cjs.map

package/dist/middle_layer/template_list.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_list.cjs","names":["treeFilter","SynchronizedTreeState","Computable"],"sources":["../../src/middle_layer/template_list.ts"],"sourcesContent":["import type { PruningFunction } from \"@milaboratories/pl-tree\";\nimport { SynchronizedTreeState } from \"@milaboratories/pl-tree\";\nimport type {\n  Filter,\n  PlClient,\n  PlTransaction,\n  ResourceType,\n  SignedResourceId,\n} from \"@milaboratories/pl-client\";\nimport {\n  field,\n  isNullSignedResourceId,\n  resourceIdToString,\n  resourceTypesEqual,\n  treeFilter,\n} from \"@milaboratories/pl-client\";\nimport type { TreeAndComputableU } from \"./types\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { MiddleLayerEnvironment } from \"./middle_layer\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\nimport type { Branded, ProjectTemplateV1 } from \"@milaboratories/pl-model-common\";\nimport type { TemplateExportProblem } from \"../model/template_export\";\nimport type { TemplateShareProblem } from \"../model/template_share\";\nimport type { ShareId } from \"../model/sharing_model\";\nimport type { AppliedEntry, TemplateApplyProblem } from \"../model/template_apply\";\nimport type { ProjectId } from \"../model/project_model\";\n\nexport const TemplatesField = \"templates\";\nexport const TemplatesResourceType: ResourceType = { name: \"Templates\", version: \"1\" };\nexport const TemplateResourceType: ResourceType = { name: \"UserTemplate\", version: \"1\" };\n\n/** Mutable: the only part of a stored template a rename may touch. */\nexport const TemplateLabelKey = \"TemplateLabel\";\nexport const TemplateCreatedTimestamp = \"TemplateCreated\";\n\n/**\n * Unique template identifier in middle layer, the stringified signed resource id of the\n * `UserTemplate`. Branded so it cannot be confused with a {@link ProjectId} — both are\n * stringified resource ids and every template method takes one of them.\n */\nexport type TemplateId = Branded<string, \"TemplateId\">;\n\n/**\n * Immutable `data` on a UserTemplate: the document plus what was true when it was taken.\n *\n * The document lives here and never in KV: KV is listed and fully re-read on every poll,\n * while resource data syncs incrementally, and a template document is a multi-kilobyte\n * value that never changes.\n */\nexport interface StoredTemplateData {\n  schemaVersion: 1;\n  document: ProjectTemplateV1;\n  /** Provenance, display only; absent for a template that arrived as a share. */\n  sourceProjectLabel?: string;\n  /** Login of the sender, when it arrived as a share. */\n  sender?: string;\n}\n\n/** Decodes the immutable `data` blob of a `UserTemplate` read through a transaction. The\n *  single raw-decode site; the tree side reads the same JSON with `getDataAsJson`. */\nexport function decodeStoredTemplateData(data: Uint8Array): StoredTemplateData {\n  return JSON.parse(Buffer.from(data).toString(\"utf-8\")) as StoredTemplateData;\n}\n\n/** One template as the template list surfaces it. */\nexport interface TemplateListEntry {\n  /** Unique template identifier in middle layer. Use to operate with the given template. */\n  id: TemplateId;\n  /** The mutable label, the only part a rename changes. */\n  label: string;\n  created: Date;\n  /** Number of blocks the stored document lists — derived, not stored. */\n  blockCount: number;\n  sourceProjectLabel?: string;\n  sender?: string;\n}\n\n/** What saving a project as a template yields: the stored template, or every block in the way. */\nexport type SaveProjectAsTemplateOutcome =\n  | { readonly ok: true; readonly templateId: TemplateId }\n  | { readonly ok: false; readonly problems: readonly TemplateExportProblem[] };\n\n/** What sharing a stored template yields: the share's logical id, or every entry in the way. */\nexport type ShareTemplateOutcome =\n  | { readonly ok: true; readonly shareId: ShareId }\n  | { readonly ok: false; readonly problems: readonly TemplateShareProblem[] };\n\n/**\n * What applying a stored template yields.\n *\n * `ok: false` carries no project id because no project was created: nothing is written\n * until every entry has an installable block.\n */\nexport type CreateProjectFromTemplateOutcome =\n  | {\n      readonly ok: true;\n      readonly projectId: ProjectId;\n      readonly added: readonly AppliedEntry[];\n    }\n  | { readonly ok: false; readonly problems: readonly TemplateApplyProblem[] };\n\n/**\n * Resolves the templates-list resource on the transaction's client root, lazily creating (and\n * locking) an empty one when the {@link TemplatesField} is not yet populated. Returns its signed\n * id. Used when writing into a root that may have no templates list yet, e.g. a template landing\n * in a recipient's root.\n */\nexport async function ensureTemplateListRid(tx: PlTransaction): Promise<SignedResourceId> {\n  const templatesField = field(tx.clientRoot, TemplatesField);\n  tx.createField(templatesField, \"Dynamic\");\n  const fData = await tx.getField(templatesField);\n  if (isNullSignedResourceId(fData.value)) {\n    const ref = tx.createEphemeral(TemplatesResourceType);\n    tx.lock(ref);\n    tx.setField(templatesField, ref);\n    return await ref.globalId;\n  }\n  return fData.value;\n}\n\nexport const TemplatesListTreePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, TemplatesResourceType)) return [];\n  return resource.fields;\n};\n\nexport const templatesListFieldFilter: Filter = treeFilter.resourceTypeEq(\n  TemplatesResourceType.name,\n);\n\nexport async function createTemplateList(\n  pl: PlClient,\n  rid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<TreeAndComputableU<TemplateListEntry[]>> {\n  const tree = await SynchronizedTreeState.init(\n    pl,\n    rid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: TemplatesListTreePruningFunction,\n      fieldFilter: templatesListFieldFilter,\n    },\n    env.logger,\n  );\n\n  const c = Computable.make((ctx) => {\n    const node = ctx.accessor(tree.entry()).node();\n    if (node === undefined) return undefined;\n    const result: TemplateListEntry[] = [];\n\n    // Templates list resource keeps templates assigned to fields. Each field name is a UUID\n    for (const field of node.listDynamicFields()) {\n      const tpl = node.traverse(field);\n      if (tpl === undefined) continue;\n      const data = tpl.getDataAsJson<StoredTemplateData>();\n      // A template whose data has not synced yet is not an entry with unknown content —\n      // it is an entry we cannot describe at all, so it stays out of the list until it has.\n      if (data === undefined) continue;\n      const label = notEmpty(tpl.getKeyValueAsJson<string>(TemplateLabelKey));\n      const created = notEmpty(tpl.getKeyValueAsJson<number>(TemplateCreatedTimestamp));\n      result.push({\n        id: resourceIdToString(tpl.id) as TemplateId,\n        label,\n        created: new Date(created),\n        blockCount: data.document.blocks.length,\n        ...(data.sourceProjectLabel !== undefined\n          ? { sourceProjectLabel: data.sourceProjectLabel }\n          : {}),\n        ...(data.sender !== undefined ? { sender: data.sender } : {}),\n      });\n    }\n    result.sort((a, b) => b.created.valueOf() - a.created.valueOf());\n    return result;\n  }).withStableType();\n\n  return { computable: c, tree };\n}\n"],"mappings":";;;;;AA2BA,MAAa,iBAAiB;AAC9B,MAAa,wBAAsC;CAAE,MAAM;CAAa,SAAS;AAAI;AACrF,MAAa,uBAAqC;CAAE,MAAM;CAAgB,SAAS;AAAI;;AAGvF,MAAa,mBAAmB;AAChC,MAAa,2BAA2B;;;AA2BxC,SAAgB,yBAAyB,MAAsC;CAC7E,OAAO,KAAK,MAAM,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC;AACvD;AA0DA,MAAa,oCAAqD,aAAa;CAC7E,IAAI,EAAA,GAAA,0BAAA,mBAAA,CAAoB,SAAS,MAAM,qBAAqB,GAAG,OAAO,CAAC;CACvE,OAAO,SAAS;AAClB;AAEA,MAAa,2BAAmCA,0BAAAA,WAAW,eACzD,sBAAsB,IACxB;AAEA,eAAsB,mBACpB,IACA,KACA,KACkD;CAClD,MAAM,OAAO,MAAMC,wBAAAA,sBAAsB,KACvC,IACA,KACA;EACE,GAAG,IAAI,IAAI;EACX,SAAS;EACT,aAAa;CACf,GACA,IAAI,MACN;CAgCA,OAAO;EAAE,YA9BCC,2BAAAA,WAAW,MAAM,QAAQ;GACjC,MAAM,OAAO,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK;GAC7C,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;GAC/B,MAAM,SAA8B,CAAC;GAGrC,KAAK,MAAM,SAAS,KAAK,kBAAkB,GAAG;IAC5C,MAAM,MAAM,KAAK,SAAS,KAAK;IAC/B,IAAI,QAAQ,KAAA,GAAW;IACvB,MAAM,OAAO,IAAI,cAAkC;IAGnD,IAAI,SAAS,KAAA,GAAW;IACxB,MAAM,SAAA,GAAA,2BAAA,SAAA,CAAiB,IAAI,kBAA0B,gBAAgB,CAAC;IACtE,MAAM,WAAA,GAAA,2BAAA,SAAA,CAAmB,IAAI,kBAA0B,wBAAwB,CAAC;IAChF,OAAO,KAAK;KACV,KAAA,GAAA,0BAAA,mBAAA,CAAuB,IAAI,EAAE;KAC7B;KACA,SAAS,IAAI,KAAK,OAAO;KACzB,YAAY,KAAK,SAAS,OAAO;KACjC,GAAI,KAAK,uBAAuB,KAAA,IAC5B,EAAE,oBAAoB,KAAK,mBAAmB,IAC9C,CAAC;KACL,GAAI,KAAK,WAAW,KAAA,IAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;IAC7D,CAAC;GACH;GACA,OAAO,MAAM,GAAG,MAAM,EAAE,QAAQ,QAAQ,IAAI,EAAE,QAAQ,QAAQ,CAAC;GAC/D,OAAO;EACT,CAAC,CAAC,CAAC,eAEkB;EAAG;CAAK;AAC/B"}

package/dist/middle_layer/template_list.d.ts

@@ -0,0 +1,77 @@
+import { AppliedEntry, TemplateApplyProblem } from "../model/template_apply.js";
+import "./types.js";
+import { ProjectId as ProjectId$1 } from "../model/project_model.js";
+import { TemplateExportProblem } from "../model/template_export.js";
+import { TemplateShareProblem } from "../model/template_share.js";
+import { ShareId } from "../model/sharing_model.js";
+import "./middle_layer.js";
+import { Branded, ProjectTemplateV1 } from "@milaboratories/pl-model-common";
+import { PlClient, PlTransaction, ResourceType, SignedResourceId } from "@milaboratories/pl-client";
+import "@milaboratories/pl-tree";
+//#region src/middle_layer/template_list.d.ts
+export declare const TemplatesField = "templates";
+/**
+ * Unique template identifier in middle layer, the stringified signed resource id of the
+ * `UserTemplate`. Branded so it cannot be confused with a {@link ProjectId} — both are
+ * stringified resource ids and every template method takes one of them.
+ */
+export type TemplateId = Branded<string, "TemplateId">;
+/**
+ * Immutable `data` on a UserTemplate: the document plus what was true when it was taken.
+ *
+ * The document lives here and never in KV: KV is listed and fully re-read on every poll,
+ * while resource data syncs incrementally, and a template document is a multi-kilobyte
+ * value that never changes.
+ */
+export interface StoredTemplateData {
+  schemaVersion: 1;
+  document: ProjectTemplateV1;
+  /** Provenance, display only; absent for a template that arrived as a share. */
+  sourceProjectLabel?: string;
+  /** Login of the sender, when it arrived as a share. */
+  sender?: string;
+}
+/** One template as the template list surfaces it. */
+export interface TemplateListEntry {
+  /** Unique template identifier in middle layer. Use to operate with the given template. */
+  id: TemplateId;
+  /** The mutable label, the only part a rename changes. */
+  label: string;
+  created: Date;
+  /** Number of blocks the stored document lists — derived, not stored. */
+  blockCount: number;
+  sourceProjectLabel?: string;
+  sender?: string;
+}
+/** What saving a project as a template yields: the stored template, or every block in the way. */
+export type SaveProjectAsTemplateOutcome = {
+  readonly ok: true;
+  readonly templateId: TemplateId;
+} | {
+  readonly ok: false;
+  readonly problems: readonly TemplateExportProblem[];
+};
+/** What sharing a stored template yields: the share's logical id, or every entry in the way. */
+export type ShareTemplateOutcome = {
+  readonly ok: true;
+  readonly shareId: ShareId;
+} | {
+  readonly ok: false;
+  readonly problems: readonly TemplateShareProblem[];
+};
+/**
+ * What applying a stored template yields.
+ *
+ * `ok: false` carries no project id because no project was created: nothing is written
+ * until every entry has an installable block.
+ */
+export type CreateProjectFromTemplateOutcome = {
+  readonly ok: true;
+  readonly projectId: ProjectId$1;
+  readonly added: readonly AppliedEntry[];
+} | {
+  readonly ok: false;
+  readonly problems: readonly TemplateApplyProblem[];
+};
+//#endregion
+//# sourceMappingURL=template_list.d.ts.map

package/dist/middle_layer/template_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_list.d.ts","names":[],"sources":["../../src/middle_layer/template_list.ts"],"mappings":";;;;;;;;;;;qBA2Ba;;;;;;YAaD,aAAa;;;;;;;;iBASR;EACf;EACA,UAAU;;EAEV;;EAEA;;;iBAUe;;EAEf,IAAI;;EAEJ;EACA,SAAS;;EAET;EACA;EACA;;;YAIU;WACG;WAAmB,YAAY;;WAC/B;WAAoB,mBAAmB;;;YAG1C;WACG;WAAmB,SAAS;;WAC5B;WAAoB,mBAAmB;;;;;;;;YAQ1C;WAEG;WACA,WAAW;WACX,gBAAgB;;WAEhB;WAAoB,mBAAmB"}

package/dist/middle_layer/template_list.js

@@ -0,0 +1,64 @@
+import { notEmpty } from "@milaboratories/ts-helpers";
+import { resourceIdToString, resourceTypesEqual, treeFilter } from "@milaboratories/pl-client";
+import { SynchronizedTreeState } from "@milaboratories/pl-tree";
+import { Computable } from "@milaboratories/computable";
+//#region src/middle_layer/template_list.ts
+const TemplatesField = "templates";
+const TemplatesResourceType = {
+	name: "Templates",
+	version: "1"
+};
+const TemplateResourceType = {
+	name: "UserTemplate",
+	version: "1"
+};
+/** Mutable: the only part of a stored template a rename may touch. */
+const TemplateLabelKey = "TemplateLabel";
+const TemplateCreatedTimestamp = "TemplateCreated";
+/** Decodes the immutable `data` blob of a `UserTemplate` read through a transaction. The
+*  single raw-decode site; the tree side reads the same JSON with `getDataAsJson`. */
+function decodeStoredTemplateData(data) {
+	return JSON.parse(Buffer.from(data).toString("utf-8"));
+}
+const TemplatesListTreePruningFunction = (resource) => {
+	if (!resourceTypesEqual(resource.type, TemplatesResourceType)) return [];
+	return resource.fields;
+};
+const templatesListFieldFilter = treeFilter.resourceTypeEq(TemplatesResourceType.name);
+async function createTemplateList(pl, rid, env) {
+	const tree = await SynchronizedTreeState.init(pl, rid, {
+		...env.ops.defaultTreeOptions,
+		pruning: TemplatesListTreePruningFunction,
+		fieldFilter: templatesListFieldFilter
+	}, env.logger);
+	return {
+		computable: Computable.make((ctx) => {
+			const node = ctx.accessor(tree.entry()).node();
+			if (node === void 0) return void 0;
+			const result = [];
+			for (const field of node.listDynamicFields()) {
+				const tpl = node.traverse(field);
+				if (tpl === void 0) continue;
+				const data = tpl.getDataAsJson();
+				if (data === void 0) continue;
+				const label = notEmpty(tpl.getKeyValueAsJson(TemplateLabelKey));
+				const created = notEmpty(tpl.getKeyValueAsJson(TemplateCreatedTimestamp));
+				result.push({
+					id: resourceIdToString(tpl.id),
+					label,
+					created: new Date(created),
+					blockCount: data.document.blocks.length,
+					...data.sourceProjectLabel !== void 0 ? { sourceProjectLabel: data.sourceProjectLabel } : {},
+					...data.sender !== void 0 ? { sender: data.sender } : {}
+				});
+			}
+			result.sort((a, b) => b.created.valueOf() - a.created.valueOf());
+			return result;
+		}).withStableType(),
+		tree
+	};
+}
+//#endregion
+export { TemplateCreatedTimestamp, TemplateLabelKey, TemplateResourceType, TemplatesField, TemplatesListTreePruningFunction, TemplatesResourceType, createTemplateList, decodeStoredTemplateData, templatesListFieldFilter };
+
+//# sourceMappingURL=template_list.js.map

package/dist/middle_layer/template_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_list.js","names":[],"sources":["../../src/middle_layer/template_list.ts"],"sourcesContent":["import type { PruningFunction } from \"@milaboratories/pl-tree\";\nimport { SynchronizedTreeState } from \"@milaboratories/pl-tree\";\nimport type {\n  Filter,\n  PlClient,\n  PlTransaction,\n  ResourceType,\n  SignedResourceId,\n} from \"@milaboratories/pl-client\";\nimport {\n  field,\n  isNullSignedResourceId,\n  resourceIdToString,\n  resourceTypesEqual,\n  treeFilter,\n} from \"@milaboratories/pl-client\";\nimport type { TreeAndComputableU } from \"./types\";\nimport { Computable } from \"@milaboratories/computable\";\nimport type { MiddleLayerEnvironment } from \"./middle_layer\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\nimport type { Branded, ProjectTemplateV1 } from \"@milaboratories/pl-model-common\";\nimport type { TemplateExportProblem } from \"../model/template_export\";\nimport type { TemplateShareProblem } from \"../model/template_share\";\nimport type { ShareId } from \"../model/sharing_model\";\nimport type { AppliedEntry, TemplateApplyProblem } from \"../model/template_apply\";\nimport type { ProjectId } from \"../model/project_model\";\n\nexport const TemplatesField = \"templates\";\nexport const TemplatesResourceType: ResourceType = { name: \"Templates\", version: \"1\" };\nexport const TemplateResourceType: ResourceType = { name: \"UserTemplate\", version: \"1\" };\n\n/** Mutable: the only part of a stored template a rename may touch. */\nexport const TemplateLabelKey = \"TemplateLabel\";\nexport const TemplateCreatedTimestamp = \"TemplateCreated\";\n\n/**\n * Unique template identifier in middle layer, the stringified signed resource id of the\n * `UserTemplate`. Branded so it cannot be confused with a {@link ProjectId} — both are\n * stringified resource ids and every template method takes one of them.\n */\nexport type TemplateId = Branded<string, \"TemplateId\">;\n\n/**\n * Immutable `data` on a UserTemplate: the document plus what was true when it was taken.\n *\n * The document lives here and never in KV: KV is listed and fully re-read on every poll,\n * while resource data syncs incrementally, and a template document is a multi-kilobyte\n * value that never changes.\n */\nexport interface StoredTemplateData {\n  schemaVersion: 1;\n  document: ProjectTemplateV1;\n  /** Provenance, display only; absent for a template that arrived as a share. */\n  sourceProjectLabel?: string;\n  /** Login of the sender, when it arrived as a share. */\n  sender?: string;\n}\n\n/** Decodes the immutable `data` blob of a `UserTemplate` read through a transaction. The\n *  single raw-decode site; the tree side reads the same JSON with `getDataAsJson`. */\nexport function decodeStoredTemplateData(data: Uint8Array): StoredTemplateData {\n  return JSON.parse(Buffer.from(data).toString(\"utf-8\")) as StoredTemplateData;\n}\n\n/** One template as the template list surfaces it. */\nexport interface TemplateListEntry {\n  /** Unique template identifier in middle layer. Use to operate with the given template. */\n  id: TemplateId;\n  /** The mutable label, the only part a rename changes. */\n  label: string;\n  created: Date;\n  /** Number of blocks the stored document lists — derived, not stored. */\n  blockCount: number;\n  sourceProjectLabel?: string;\n  sender?: string;\n}\n\n/** What saving a project as a template yields: the stored template, or every block in the way. */\nexport type SaveProjectAsTemplateOutcome =\n  | { readonly ok: true; readonly templateId: TemplateId }\n  | { readonly ok: false; readonly problems: readonly TemplateExportProblem[] };\n\n/** What sharing a stored template yields: the share's logical id, or every entry in the way. */\nexport type ShareTemplateOutcome =\n  | { readonly ok: true; readonly shareId: ShareId }\n  | { readonly ok: false; readonly problems: readonly TemplateShareProblem[] };\n\n/**\n * What applying a stored template yields.\n *\n * `ok: false` carries no project id because no project was created: nothing is written\n * until every entry has an installable block.\n */\nexport type CreateProjectFromTemplateOutcome =\n  | {\n      readonly ok: true;\n      readonly projectId: ProjectId;\n      readonly added: readonly AppliedEntry[];\n    }\n  | { readonly ok: false; readonly problems: readonly TemplateApplyProblem[] };\n\n/**\n * Resolves the templates-list resource on the transaction's client root, lazily creating (and\n * locking) an empty one when the {@link TemplatesField} is not yet populated. Returns its signed\n * id. Used when writing into a root that may have no templates list yet, e.g. a template landing\n * in a recipient's root.\n */\nexport async function ensureTemplateListRid(tx: PlTransaction): Promise<SignedResourceId> {\n  const templatesField = field(tx.clientRoot, TemplatesField);\n  tx.createField(templatesField, \"Dynamic\");\n  const fData = await tx.getField(templatesField);\n  if (isNullSignedResourceId(fData.value)) {\n    const ref = tx.createEphemeral(TemplatesResourceType);\n    tx.lock(ref);\n    tx.setField(templatesField, ref);\n    return await ref.globalId;\n  }\n  return fData.value;\n}\n\nexport const TemplatesListTreePruningFunction: PruningFunction = (resource) => {\n  if (!resourceTypesEqual(resource.type, TemplatesResourceType)) return [];\n  return resource.fields;\n};\n\nexport const templatesListFieldFilter: Filter = treeFilter.resourceTypeEq(\n  TemplatesResourceType.name,\n);\n\nexport async function createTemplateList(\n  pl: PlClient,\n  rid: SignedResourceId,\n  env: MiddleLayerEnvironment,\n): Promise<TreeAndComputableU<TemplateListEntry[]>> {\n  const tree = await SynchronizedTreeState.init(\n    pl,\n    rid,\n    {\n      ...env.ops.defaultTreeOptions,\n      pruning: TemplatesListTreePruningFunction,\n      fieldFilter: templatesListFieldFilter,\n    },\n    env.logger,\n  );\n\n  const c = Computable.make((ctx) => {\n    const node = ctx.accessor(tree.entry()).node();\n    if (node === undefined) return undefined;\n    const result: TemplateListEntry[] = [];\n\n    // Templates list resource keeps templates assigned to fields. Each field name is a UUID\n    for (const field of node.listDynamicFields()) {\n      const tpl = node.traverse(field);\n      if (tpl === undefined) continue;\n      const data = tpl.getDataAsJson<StoredTemplateData>();\n      // A template whose data has not synced yet is not an entry with unknown content —\n      // it is an entry we cannot describe at all, so it stays out of the list until it has.\n      if (data === undefined) continue;\n      const label = notEmpty(tpl.getKeyValueAsJson<string>(TemplateLabelKey));\n      const created = notEmpty(tpl.getKeyValueAsJson<number>(TemplateCreatedTimestamp));\n      result.push({\n        id: resourceIdToString(tpl.id) as TemplateId,\n        label,\n        created: new Date(created),\n        blockCount: data.document.blocks.length,\n        ...(data.sourceProjectLabel !== undefined\n          ? { sourceProjectLabel: data.sourceProjectLabel }\n          : {}),\n        ...(data.sender !== undefined ? { sender: data.sender } : {}),\n      });\n    }\n    result.sort((a, b) => b.created.valueOf() - a.created.valueOf());\n    return result;\n  }).withStableType();\n\n  return { computable: c, tree };\n}\n"],"mappings":";;;;;AA2BA,MAAa,iBAAiB;AAC9B,MAAa,wBAAsC;CAAE,MAAM;CAAa,SAAS;AAAI;AACrF,MAAa,uBAAqC;CAAE,MAAM;CAAgB,SAAS;AAAI;;AAGvF,MAAa,mBAAmB;AAChC,MAAa,2BAA2B;;;AA2BxC,SAAgB,yBAAyB,MAAsC;CAC7E,OAAO,KAAK,MAAM,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC;AACvD;AA0DA,MAAa,oCAAqD,aAAa;CAC7E,IAAI,CAAC,mBAAmB,SAAS,MAAM,qBAAqB,GAAG,OAAO,CAAC;CACvE,OAAO,SAAS;AAClB;AAEA,MAAa,2BAAmC,WAAW,eACzD,sBAAsB,IACxB;AAEA,eAAsB,mBACpB,IACA,KACA,KACkD;CAClD,MAAM,OAAO,MAAM,sBAAsB,KACvC,IACA,KACA;EACE,GAAG,IAAI,IAAI;EACX,SAAS;EACT,aAAa;CACf,GACA,IAAI,MACN;CAgCA,OAAO;EAAE,YA9BC,WAAW,MAAM,QAAQ;GACjC,MAAM,OAAO,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK;GAC7C,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;GAC/B,MAAM,SAA8B,CAAC;GAGrC,KAAK,MAAM,SAAS,KAAK,kBAAkB,GAAG;IAC5C,MAAM,MAAM,KAAK,SAAS,KAAK;IAC/B,IAAI,QAAQ,KAAA,GAAW;IACvB,MAAM,OAAO,IAAI,cAAkC;IAGnD,IAAI,SAAS,KAAA,GAAW;IACxB,MAAM,QAAQ,SAAS,IAAI,kBAA0B,gBAAgB,CAAC;IACtE,MAAM,UAAU,SAAS,IAAI,kBAA0B,wBAAwB,CAAC;IAChF,OAAO,KAAK;KACV,IAAI,mBAAmB,IAAI,EAAE;KAC7B;KACA,SAAS,IAAI,KAAK,OAAO;KACzB,YAAY,KAAK,SAAS,OAAO;KACjC,GAAI,KAAK,uBAAuB,KAAA,IAC5B,EAAE,oBAAoB,KAAK,mBAAmB,IAC9C,CAAC;KACL,GAAI,KAAK,WAAW,KAAA,IAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;IAC7D,CAAC;GACH;GACA,OAAO,MAAM,GAAG,MAAM,EAAE,QAAQ,QAAQ,IAAI,EAAE,QAAQ,QAAQ,CAAC;GAC/D,OAAO;EACT,CAAC,CAAC,CAAC,eAEkB;EAAG;CAAK;AAC/B"}

package/dist/model/index.cjs

@@ -4,8 +4,11 @@ const require_sharing_model = require("./sharing_model.cjs");
 const require_template_parser = require("./template_parser.cjs");
 const require_template_resolve = require("./template_resolve.cjs");
 const require_template_apply = require("./template_apply.cjs");
+const require_template_serializer = require("./template_serializer.cjs");
+const require_template_share = require("./template_share.cjs");
 exports.AcceptanceFieldPrefix = require_sharing_model.AcceptanceFieldPrefix;
 exports.BlockArgsAuthorKeyPrefix = require_project_model.BlockArgsAuthorKeyPrefix;
+exports.EnvelopeSchemaVersionCurrent = require_sharing_model.EnvelopeSchemaVersionCurrent;
 exports.FrontendFromFolderResourceType = require_block_pack_spec.FrontendFromFolderResourceType;
 exports.FrontendFromLocalTgzResourceType = require_block_pack_spec.FrontendFromLocalTgzResourceType;
 exports.FrontendFromUrlResourceType = require_block_pack_spec.FrontendFromUrlResourceType;
@@ -30,8 +33,13 @@ exports.canGrantToEveryone = require_sharing_model.canGrantToEveryone;
 exports.canImpersonate = require_sharing_model.canImpersonate;
 exports.decisionField = require_sharing_model.decisionField;
 exports.decodeEnvelopeData = require_sharing_model.decodeEnvelopeData;
+exports.envelopeProjectMap = require_sharing_model.envelopeProjectMap;
 exports.isAcceptanceField = require_sharing_model.isAcceptanceField;
+exports.locationOf = require_template_serializer.locationOf;
 exports.newShareId = require_sharing_model.newShareId;
+exports.normalizeEnvelopeData = require_sharing_model.normalizeEnvelopeData;
 exports.parseBlockPackName = require_template_resolve.parseBlockPackName;
 exports.parseProjectTemplateV1Yaml = require_template_parser.parseProjectTemplateV1Yaml;
 exports.resolveTemplateEntries = require_template_resolve.resolveTemplateEntries;
+exports.stringifyProjectTemplateV1 = require_template_serializer.stringifyProjectTemplateV1;
+exports.unshareableTemplateEntries = require_template_share.unshareableTemplateEntries;