@milaboratories/pl-middle-layer 1.70.0 → 1.71.0

package/dist/middle_layer/template_list.js.map

@@ -1 +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"}
+{"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 { 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. */\nexport type ShareTemplateOutcome = { readonly shareId: ShareId };\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":";;;;;AA0BA,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;AAwDA,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

@@ -5,7 +5,6 @@ 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;
@@ -42,4 +41,3 @@ 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;

package/dist/model/index.d.ts

@@ -2,9 +2,8 @@ import { AppliedEntry, TemplateApplyProblem, TemplateApplyReport, TemplateEntryR
 import { BlockPackProvider, ExactResolution, KindResolution, ResolvedEntry, TemplateResolveOutcome, parseBlockPackName, resolveTemplateEntries } from "./template_resolve.js";
 import { BlockArgsAuthorKeyPrefix, ProjectCreatedTimestamp, ProjectField, ProjectId, ProjectLastModifiedTimestamp, ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey } from "./project_model.js";
 import { TemplateExportProblem } from "./template_export.js";
-import { TemplateShareProblem, unshareableTemplateEntries } from "./template_share.js";
 import { AcceptanceFieldPrefix, EnvelopeAcceptance, EnvelopeData, EnvelopeMode, EnvelopePayload, EnvelopePayloadKind, EnvelopeProject, EnvelopeSchemaVersion, EnvelopeSchemaVersionCurrent, ProjectChangeAction, ProjectFieldUuid, ShareId, ShareProjectsOptions, ShareTemplateOptions, SharedEnvelopeResourceType, SharingDecision, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, envelopeProjectMap, isAcceptanceField, newShareId, normalizeEnvelopeData } from "./sharing_model.js";
 import { ProjectTemplateExportOutcome, locationOf, stringifyProjectTemplateV1 } from "./template_serializer.js";
 import { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec } from "./block_pack_spec.js";
 import { TemplateParseOutcome, parseProjectTemplateV1Yaml } from "./template_parser.js";
-export { AcceptanceFieldPrefix, type AppliedEntry, BlockArgsAuthorKeyPrefix, BlockPackExplicit, type BlockPackProvider, BlockPackSpecAny, BlockPackSpecPrepared, EnvelopeAcceptance, EnvelopeData, EnvelopeMode, EnvelopePayload, EnvelopePayloadKind, EnvelopeProject, EnvelopeSchemaVersion, EnvelopeSchemaVersionCurrent, type ExactResolution, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec, type KindResolution, ProjectChangeAction, ProjectCreatedTimestamp, type ProjectField, ProjectFieldUuid, ProjectLastModifiedTimestamp, type ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, type ProjectTemplateExportOutcome, type ResolvedEntry, SchemaVersionCurrent, SchemaVersionKey, ShareId, ShareProjectsOptions, ShareTemplateOptions, SharedEnvelopeResourceType, SharingDecision, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, type TemplateApplyProblem, type TemplateApplyReport, TemplateEntryRejected, type TemplateExportProblem, type TemplateParseOutcome, type TemplateResolveOutcome, type TemplateShareProblem, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, envelopeProjectMap, isAcceptanceField, locationOf, newShareId, normalizeEnvelopeData, parseBlockPackName, parseProjectTemplateV1Yaml, resolveTemplateEntries, stringifyProjectTemplateV1, unshareableTemplateEntries };
+export { AcceptanceFieldPrefix, type AppliedEntry, BlockArgsAuthorKeyPrefix, BlockPackExplicit, type BlockPackProvider, BlockPackSpecAny, BlockPackSpecPrepared, EnvelopeAcceptance, EnvelopeData, EnvelopeMode, EnvelopePayload, EnvelopePayloadKind, EnvelopeProject, EnvelopeSchemaVersion, EnvelopeSchemaVersionCurrent, type ExactResolution, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec, type KindResolution, ProjectChangeAction, ProjectCreatedTimestamp, type ProjectField, ProjectFieldUuid, ProjectLastModifiedTimestamp, type ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, type ProjectTemplateExportOutcome, type ResolvedEntry, SchemaVersionCurrent, SchemaVersionKey, ShareId, ShareProjectsOptions, ShareTemplateOptions, SharedEnvelopeResourceType, SharingDecision, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, type TemplateApplyProblem, type TemplateApplyReport, TemplateEntryRejected, type TemplateExportProblem, type TemplateParseOutcome, type TemplateResolveOutcome, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, envelopeProjectMap, isAcceptanceField, locationOf, newShareId, normalizeEnvelopeData, parseBlockPackName, parseProjectTemplateV1Yaml, resolveTemplateEntries, stringifyProjectTemplateV1 };

package/dist/model/index.js

@@ -5,5 +5,4 @@ import { parseProjectTemplateV1Yaml } from "./template_parser.js";
 import { parseBlockPackName, resolveTemplateEntries } from "./template_resolve.js";
 import { TemplateEntryRejected } from "./template_apply.js";
 import { locationOf, stringifyProjectTemplateV1 } from "./template_serializer.js";
-import { unshareableTemplateEntries } from "./template_share.js";
-export { AcceptanceFieldPrefix, BlockArgsAuthorKeyPrefix, EnvelopeSchemaVersionCurrent, FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, TemplateEntryRejected, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, envelopeProjectMap, isAcceptanceField, locationOf, newShareId, normalizeEnvelopeData, parseBlockPackName, parseProjectTemplateV1Yaml, resolveTemplateEntries, stringifyProjectTemplateV1, unshareableTemplateEntries };
+export { AcceptanceFieldPrefix, BlockArgsAuthorKeyPrefix, EnvelopeSchemaVersionCurrent, FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, TemplateEntryRejected, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, envelopeProjectMap, isAcceptanceField, locationOf, newShareId, normalizeEnvelopeData, parseBlockPackName, parseProjectTemplateV1Yaml, resolveTemplateEntries, stringifyProjectTemplateV1 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-middle-layer",
-  "version": "1.70.0",
+  "version": "1.71.0",
   "description": "Pl Middle Layer",
   "keywords": [],
   "license": "UNLICENSED",
@@ -30,25 +30,25 @@
     "utility-types": "^3.11.0",
     "yaml": "^2.8.0",
     "zod": "~3.25.76",
-    "@milaboratories/helpers": "1.14.5",
-    "@milaboratories/pf-spec-driver": "1.5.1",
     "@milaboratories/columns-collection-driver": "0.2.4",
+    "@milaboratories/helpers": "1.14.5",
     "@milaboratories/computable": "2.9.8",
     "@milaboratories/pf-driver": "1.9.1",
+    "@milaboratories/pf-spec-driver": "1.5.1",
     "@milaboratories/pl-deployments": "3.0.16",
-    "@milaboratories/pl-client": "3.16.0",
     "@milaboratories/pl-drivers": "1.16.19",
     "@milaboratories/pl-http": "1.2.4",
     "@milaboratories/pl-model-backend": "1.4.23",
+    "@milaboratories/pl-client": "3.16.0",
+    "@milaboratories/pl-model-common": "1.48.0",
     "@milaboratories/pl-model-middle-layer": "1.32.0",
     "@milaboratories/pl-tree": "1.14.2",
-    "@milaboratories/pl-model-common": "1.48.0",
-    "@milaboratories/resolve-helper": "1.1.3",
     "@milaboratories/ts-helpers": "1.8.6",
     "@milaboratories/pl-errors": "1.4.38",
-    "@platforma-sdk/workflow-tengo": "6.9.0",
     "@platforma-sdk/block-tools": "2.14.6",
-    "@platforma-sdk/model": "1.83.9"
+    "@platforma-sdk/model": "1.83.9",
+    "@milaboratories/resolve-helper": "1.1.3",
+    "@platforma-sdk/workflow-tengo": "6.9.0"
   },
   "devDependencies": {
     "@types/node": "~24.5.2",

package/src/middle_layer/middle_layer.ts

@@ -75,8 +75,6 @@ import {
   type ShareProjectsOptions,
   type ShareTemplateOptions,
 } from "../model/sharing_model";
-import type { TemplateShareProblem } from "../model/template_share";
-import { unshareableTemplateEntries } from "../model/template_share";
 import {
   buildShareEnvelope,
   buildTemplateShareEnvelope,
@@ -1002,9 +1000,10 @@ export class MiddleLayer {
    * The cost of that is the donor's receipt: nobody can write an acceptance onto a read-only
    * envelope, so a template share never reports who accepted it.
    *
-   * A template holding a block installed from a folder on this machine is refused rather than sent,
-   * with every offending entry named. {@link checkTemplateShareable} answers the same question
-   * without attempting the share, so a UI can state it on the template itself.
+   * Nothing about the document is checked: a stored template is shareable by virtue of existing.
+   * An entry the recipient cannot resolve — a block installed from a folder on the sender's
+   * machine, say — is theirs to see when they preview or apply it, where every unresolvable entry
+   * is named anyway.
    *
    * @param id template to share
    * @param options recipients XOR everyone, plus the title recipients see
@@ -1013,8 +1012,7 @@ export class MiddleLayer {
     id: TemplateId,
     options: ShareTemplateOptions,
   ): Promise<ShareTemplateOutcome> {
-    const loaded = await this.loadShareableTemplate(id);
-    if (!loaded.ok) return { ok: false, problems: loaded.problems };
+    const template = await this.loadTemplateForShare(id);
 
     const everyone = "everyone" in options;
     const sender = this.currentUserLogin ?? "";
@@ -1026,7 +1024,7 @@ export class MiddleLayer {
       const { envelope, data } = buildTemplateShareEnvelope(
         tx,
         this.sharingOutboxResourceId,
-        loaded.template,
+        template,
         { sender, title: options.title, expiresAt },
       );
       shareId = data.shareId;
@@ -1037,29 +1035,16 @@ export class MiddleLayer {
     });
 
     await this.sharingOutboxTree.refreshState();
-    return { ok: true, shareId: shareId! };
+    return { shareId: shareId! };
   }
 
-  /**
-   * Every entry of a stored template that stands in the way of sharing it, empty for a template
-   * that can be shared. Reads the template and nothing else, so a UI can state the refusal on the
-   * template itself instead of only when the user tries to share it.
-   */
-  public async checkTemplateShareable(id: TemplateId): Promise<readonly TemplateShareProblem[]> {
-    const stored = await this.getTemplateData(id);
-    return unshareableTemplateEntries(stored.document);
-  }
-
-  /** The document and the label of a template that may be shared, or every entry that stops it.
-   *  The label is what the recipient's own list will show, so it travels with the document. */
-  private async loadShareableTemplate(
+  /** The document and the label of a template about to be shared. The label is what the
+   *  recipient's own list will show, so it travels with the document. */
+  private async loadTemplateForShare(
     id: TemplateId,
-  ): Promise<
-    | { ok: true; template: { document: ProjectTemplateV1; label: string } }
-    | { ok: false; problems: readonly TemplateShareProblem[] }
-  > {
+  ): Promise<{ document: ProjectTemplateV1; label: string }> {
     const rid = await this.resolveTemplateId(id);
-    const template = await this.pl.withReadTx("MLReadTemplateForShare", async (tx) => {
+    return await this.pl.withReadTx("MLReadTemplateForShare", async (tx) => {
       const rd = await tx.getResourceData(rid, false);
       if (rd.data === undefined) throw new Error(`Template ${id} carries no document.`);
       return {
@@ -1067,10 +1052,6 @@ export class MiddleLayer {
         label: await tx.getKValueJson<string>(rid, TemplateLabelKey),
       };
     });
-
-    const problems = unshareableTemplateEntries(template.document);
-    if (problems.length > 0) return { ok: false, problems };
-    return { ok: true, template };
   }
 
   /**
@@ -1092,8 +1073,7 @@ export class MiddleLayer {
    * `opts.templateId` is required for, and only used by, a share that carries a template: a stored
    * template is immutable, so an improved one is a different template and the share cannot re-read
    * the one it started from — the caller names the new target. Every other option means the same
-   * thing for both kinds of share. Sharing the named template must be permitted (see
-   * {@link checkTemplateShareable}) or this throws.
+   * thing for both kinds of share.
    */
   public async changeShare(
     shareId: ShareId,
@@ -1105,14 +1085,9 @@ export class MiddleLayer {
       templateId?: TemplateId;
     } = {},
   ): Promise<void> {
-    // Read outside the write tx: it is two round-trips of its own, and the refusal it can produce
-    // must be raised before anything is torn down.
+    // Read outside the write tx: it is two round-trips of its own.
     const target =
-      opts.templateId === undefined ? undefined : await this.loadShareableTemplate(opts.templateId);
-    if (target !== undefined && !target.ok)
-      throw new Error(
-        `changeShare: template ${opts.templateId} cannot be shared: ${describeShareProblems(target.problems)}`,
-      );
+      opts.templateId === undefined ? undefined : await this.loadTemplateForShare(opts.templateId);
 
     await this.pl.withWriteTx("MLChangeShare", async (tx) => {
       const old = await this.resolveOutboxEnvelope(tx, shareId);
@@ -1137,17 +1112,12 @@ export class MiddleLayer {
 
         // Same shareId, same outbox field name — detach the old field before rebuilding, or they collide.
         tx.removeField(field(this.sharingOutboxResourceId, old.fieldName));
-        const { envelope } = buildTemplateShareEnvelope(
-          tx,
-          this.sharingOutboxResourceId,
-          target.template,
-          {
-            sender: self,
-            title: opts.title === undefined ? old.data.title : opts.title.trim(),
-            expiresAt: everyone ? null : Date.now() + this.env.ops.envelopeTtlMs,
-            shareId, // SAME shareId — the essence of change
-          },
-        );
+        const { envelope } = buildTemplateShareEnvelope(tx, this.sharingOutboxResourceId, target, {
+          sender: self,
+          title: opts.title === undefined ? old.data.title : opts.title.trim(),
+          expiresAt: everyone ? null : Date.now() + this.env.ops.envelopeTtlMs,
+          shareId, // SAME shareId — the essence of change
+        });
 
         // Nothing to transfer: a read-only grant cannot write an acceptance, so a template share
         // never accumulated one.
@@ -1828,9 +1798,3 @@ export class MiddleLayer {
 //
 // Internals
 //
-
-/** Refusal reasons as one line, each naming the entry it belongs to, so a throw that escapes to a
- *  log still says which block stands in the way. */
-function describeShareProblems(problems: readonly TemplateShareProblem[]): string {
-  return problems.map((p) => `${p.entryId}: ${p.error}`).join("; ");
-}

package/src/middle_layer/template_list.ts

@@ -20,7 +20,6 @@ import type { MiddleLayerEnvironment } from "./middle_layer";
 import { notEmpty } from "@milaboratories/ts-helpers";
 import type { Branded, ProjectTemplateV1 } from "@milaboratories/pl-model-common";
 import type { TemplateExportProblem } from "../model/template_export";
-import type { TemplateShareProblem } from "../model/template_share";
 import type { ShareId } from "../model/sharing_model";
 import type { AppliedEntry, TemplateApplyProblem } from "../model/template_apply";
 import type { ProjectId } from "../model/project_model";
@@ -80,10 +79,8 @@ 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 sharing a stored template yields: the share's logical id. */
+export type ShareTemplateOutcome = { readonly shareId: ShareId };
 
 /**
  * What applying a stored template yields.

package/src/middle_layer/templates.test.ts

@@ -91,26 +91,19 @@ test("an entry nothing can resolve creates no project, and every entry is report
   });
 });
 
-test("a template holding a block from a folder on this machine is refused rather than shared", async () => {
+test("a template holding a block from a folder on this machine is shared like any other", async () => {
   await withMl(async (ml) => {
-    const stored = await storeTemplate(ml, "Built here", {
-      schemaVersion: 1,
-      document: documentOf(entry("a"), entry("b", LOCAL_FOLDER)),
-    });
+    const document = documentOf(entry("a"), entry("b", LOCAL_FOLDER));
+    const stored = await storeTemplate(ml, "Built here", { schemaVersion: 1, document });
 
-    // Asked of a template that is merely being displayed, so the refusal can be stated on the
-    // template itself instead of only once the user has tried to send it.
-    expect((await ml.checkTemplateShareable(stored.id)).map((p) => p.entryId)).toStrictEqual(["b"]);
-
-    const outcome = await ml.shareTemplate(stored.id, {
-      recipients: ["colleague"],
-      title: "Built here",
-    });
+    // A stored template is shareable by existing. Whether the recipient can resolve every entry
+    // is their question, answered where they preview or apply it — not a gate on sending.
+    // With everyone, like the other share tests here: a named recipient must already exist on
+    // the backend, and the test server has no second user.
+    const shared = await ml.shareTemplate(stored.id, { everyone: true, title: "Built here" });
 
-    if (outcome.ok) throw new Error("a template with a file: entry must not be shareable");
-    expect(outcome.problems.map((p) => p.entryId)).toStrictEqual(["b"]);
-    // Refused before anything was written: no envelope, so nothing to revoke.
-    expect((await ml.outgoingShares.getValue()) ?? []).toStrictEqual([]);
+    const outgoing = await ml.outgoingShares.awaitStableValue();
+    expect((outgoing ?? []).map((s) => s.shareId)).toStrictEqual([shared.shareId]);
   });
 });
 
@@ -142,7 +135,6 @@ test("an accepted template share lands on the acceptor's shelf and builds nothin
     });
 
     const shared = await ml.shareTemplate(stored.id, { everyone: true, title: "A pipeline" });
-    if (!shared.ok) throw new Error(`share refused: ${JSON.stringify(shared.problems)}`);
 
     const outcome = await ml.acceptShare([shared.shareId]);
 
@@ -175,7 +167,6 @@ test("a changed template share keeps its id, and whoever already responded is no
     });
 
     const shared = await ml.shareTemplate(first.id, { everyone: true, title: "First" });
-    if (!shared.ok) throw new Error(`share refused: ${JSON.stringify(shared.problems)}`);
 
     // Someone responds to the share, which is what the replace below must not undo.
     const accept = await ml.acceptShare([shared.shareId]);
@@ -186,7 +177,7 @@ test("a changed template share keeps its id, and whoever already responded is no
     await ml.changeShare(shared.shareId, { templateId: second.id, title: "Second" });
 
     const outgoing = (await ml.outgoingShares.getValue()) ?? [];
-    expect(outgoing.map((s) => s.shareId)).toStrictEqual([shared.shareId]);
+    expect((outgoing ?? []).map((s) => s.shareId)).toStrictEqual([shared.shareId]);
     expect(outgoing[0]).toMatchObject({
       payloadKind: "template",
       title: "Second",

package/src/model/index.ts

@@ -48,4 +48,3 @@ export type { TemplateExportProblem } from "./template_export";
 
 // The template share path. Whether a template may be shared at all is a question a UI asks about
 // a template it is merely displaying, so the check and its problem type are public.
-export { unshareableTemplateEntries, type TemplateShareProblem } from "./template_share";

package/dist/model/template_share.cjs

@@ -1,42 +0,0 @@
-let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-//#region src/model/template_share.ts
-/**
-* Every entry of a template that cannot travel to another machine, or an empty list for a
-* template that can be shared.
-*
-* An entry's `location` names a place rather than a name, and a `file:` place is a folder on
-* the author's own disk: a recipient resolving it finds nothing, or worse finds something
-* else. Such a template stays perfectly usable where it was made, so it is stored and applied
-* as normal — only sharing it is refused.
-*
-* A location whose scheme cannot be read is refused for the same reason: nothing can resolve
-* it anywhere, here included.
-*
-* Every offending entry is reported, not only the first, so a UI can name each block instead
-* of sending its user round the loop once per entry.
-*/
-function unshareableTemplateEntries(document) {
-	const problems = [];
-	for (const entry of document.blocks) {
-		if (entry.location === void 0) continue;
-		let scheme;
-		try {
-			scheme = (0, _milaboratories_pl_model_common.parseBlockPackLocation)(entry.location).scheme;
-		} catch (e) {
-			problems.push({
-				entryId: entry.id,
-				error: `Block is installed from a location nothing can resolve: ${e instanceof Error ? e.message : String(e)}`
-			});
-			continue;
-		}
-		if (scheme === "file") problems.push({
-			entryId: entry.id,
-			error: `Block is installed from ${entry.location}, a folder on this machine — it resolves to nothing on the recipient's, so this template cannot be shared`
-		});
-	}
-	return problems;
-}
-//#endregion
-exports.unshareableTemplateEntries = unshareableTemplateEntries;
-
-//# sourceMappingURL=template_share.cjs.map

package/dist/model/template_share.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"template_share.cjs","names":[],"sources":["../../src/model/template_share.ts"],"sourcesContent":["import type { ProjectTemplateV1 } from \"@milaboratories/pl-model-common\";\nimport { parseBlockPackLocation } from \"@milaboratories/pl-model-common\";\n\n/** One template entry standing in the way of sharing the template, and why. */\nexport type TemplateShareProblem = {\n  /** The template-local id of the entry the problem belongs to; on an exported template it is\n   *  the block's project-local uuid. */\n  readonly entryId: string;\n  readonly error: string;\n};\n\n/**\n * Every entry of a template that cannot travel to another machine, or an empty list for a\n * template that can be shared.\n *\n * An entry's `location` names a place rather than a name, and a `file:` place is a folder on\n * the author's own disk: a recipient resolving it finds nothing, or worse finds something\n * else. Such a template stays perfectly usable where it was made, so it is stored and applied\n * as normal — only sharing it is refused.\n *\n * A location whose scheme cannot be read is refused for the same reason: nothing can resolve\n * it anywhere, here included.\n *\n * Every offending entry is reported, not only the first, so a UI can name each block instead\n * of sending its user round the loop once per entry.\n */\nexport function unshareableTemplateEntries(\n  document: ProjectTemplateV1,\n): readonly TemplateShareProblem[] {\n  const problems: TemplateShareProblem[] = [];\n  for (const entry of document.blocks) {\n    if (entry.location === undefined) continue;\n    let scheme: string;\n    try {\n      scheme = parseBlockPackLocation(entry.location).scheme;\n    } catch (e) {\n      problems.push({\n        entryId: entry.id,\n        error: `Block is installed from a location nothing can resolve: ${e instanceof Error ? e.message : String(e)}`,\n      });\n      continue;\n    }\n    if (scheme === \"file\")\n      problems.push({\n        entryId: entry.id,\n        error:\n          `Block is installed from ${entry.location}, a folder on this machine — it resolves ` +\n          \"to nothing on the recipient's, so this template cannot be shared\",\n      });\n  }\n  return problems;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,SAAgB,2BACd,UACiC;CACjC,MAAM,WAAmC,CAAC;CAC1C,KAAK,MAAM,SAAS,SAAS,QAAQ;EACnC,IAAI,MAAM,aAAa,KAAA,GAAW;EAClC,IAAI;EACJ,IAAI;GACF,UAAA,GAAA,gCAAA,uBAAA,CAAgC,MAAM,QAAQ,CAAC,CAAC;EAClD,SAAS,GAAG;GACV,SAAS,KAAK;IACZ,SAAS,MAAM;IACf,OAAO,2DAA2D,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;GAC7G,CAAC;GACD;EACF;EACA,IAAI,WAAW,QACb,SAAS,KAAK;GACZ,SAAS,MAAM;GACf,OACE,2BAA2B,MAAM,SAAS;EAE9C,CAAC;CACL;CACA,OAAO;AACT"}

package/dist/model/template_share.d.ts

@@ -1,27 +0,0 @@
-import { ProjectTemplateV1 } from "@milaboratories/pl-model-common";
-//#region src/model/template_share.d.ts
-/** One template entry standing in the way of sharing the template, and why. */
-export type TemplateShareProblem = {
-  /** The template-local id of the entry the problem belongs to; on an exported template it is
-   *  the block's project-local uuid. */
-  readonly entryId: string;
-  readonly error: string;
-};
-/**
- * Every entry of a template that cannot travel to another machine, or an empty list for a
- * template that can be shared.
- *
- * An entry's `location` names a place rather than a name, and a `file:` place is a folder on
- * the author's own disk: a recipient resolving it finds nothing, or worse finds something
- * else. Such a template stays perfectly usable where it was made, so it is stored and applied
- * as normal — only sharing it is refused.
- *
- * A location whose scheme cannot be read is refused for the same reason: nothing can resolve
- * it anywhere, here included.
- *
- * Every offending entry is reported, not only the first, so a UI can name each block instead
- * of sending its user round the loop once per entry.
- */
-export declare function unshareableTemplateEntries(document: ProjectTemplateV1): readonly TemplateShareProblem[];
-//#endregion
-//# sourceMappingURL=template_share.d.ts.map

package/dist/model/template_share.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template_share.d.ts","names":[],"sources":["../../src/model/template_share.ts"],"mappings":";;;YAIY;;;WAGD;WACA;;;;;;;;;;;;;;;;;wBAkBK,2BACd,UAAU,6BACA"}

package/dist/model/template_share.js

@@ -1,42 +0,0 @@
-import { parseBlockPackLocation } from "@milaboratories/pl-model-common";
-//#region src/model/template_share.ts
-/**
-* Every entry of a template that cannot travel to another machine, or an empty list for a
-* template that can be shared.
-*
-* An entry's `location` names a place rather than a name, and a `file:` place is a folder on
-* the author's own disk: a recipient resolving it finds nothing, or worse finds something
-* else. Such a template stays perfectly usable where it was made, so it is stored and applied
-* as normal — only sharing it is refused.
-*
-* A location whose scheme cannot be read is refused for the same reason: nothing can resolve
-* it anywhere, here included.
-*
-* Every offending entry is reported, not only the first, so a UI can name each block instead
-* of sending its user round the loop once per entry.
-*/
-function unshareableTemplateEntries(document) {
-	const problems = [];
-	for (const entry of document.blocks) {
-		if (entry.location === void 0) continue;
-		let scheme;
-		try {
-			scheme = parseBlockPackLocation(entry.location).scheme;
-		} catch (e) {
-			problems.push({
-				entryId: entry.id,
-				error: `Block is installed from a location nothing can resolve: ${e instanceof Error ? e.message : String(e)}`
-			});
-			continue;
-		}
-		if (scheme === "file") problems.push({
-			entryId: entry.id,
-			error: `Block is installed from ${entry.location}, a folder on this machine — it resolves to nothing on the recipient's, so this template cannot be shared`
-		});
-	}
-	return problems;
-}
-//#endregion
-export { unshareableTemplateEntries };
-
-//# sourceMappingURL=template_share.js.map

package/dist/model/template_share.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template_share.js","names":[],"sources":["../../src/model/template_share.ts"],"sourcesContent":["import type { ProjectTemplateV1 } from \"@milaboratories/pl-model-common\";\nimport { parseBlockPackLocation } from \"@milaboratories/pl-model-common\";\n\n/** One template entry standing in the way of sharing the template, and why. */\nexport type TemplateShareProblem = {\n  /** The template-local id of the entry the problem belongs to; on an exported template it is\n   *  the block's project-local uuid. */\n  readonly entryId: string;\n  readonly error: string;\n};\n\n/**\n * Every entry of a template that cannot travel to another machine, or an empty list for a\n * template that can be shared.\n *\n * An entry's `location` names a place rather than a name, and a `file:` place is a folder on\n * the author's own disk: a recipient resolving it finds nothing, or worse finds something\n * else. Such a template stays perfectly usable where it was made, so it is stored and applied\n * as normal — only sharing it is refused.\n *\n * A location whose scheme cannot be read is refused for the same reason: nothing can resolve\n * it anywhere, here included.\n *\n * Every offending entry is reported, not only the first, so a UI can name each block instead\n * of sending its user round the loop once per entry.\n */\nexport function unshareableTemplateEntries(\n  document: ProjectTemplateV1,\n): readonly TemplateShareProblem[] {\n  const problems: TemplateShareProblem[] = [];\n  for (const entry of document.blocks) {\n    if (entry.location === undefined) continue;\n    let scheme: string;\n    try {\n      scheme = parseBlockPackLocation(entry.location).scheme;\n    } catch (e) {\n      problems.push({\n        entryId: entry.id,\n        error: `Block is installed from a location nothing can resolve: ${e instanceof Error ? e.message : String(e)}`,\n      });\n      continue;\n    }\n    if (scheme === \"file\")\n      problems.push({\n        entryId: entry.id,\n        error:\n          `Block is installed from ${entry.location}, a folder on this machine — it resolves ` +\n          \"to nothing on the recipient's, so this template cannot be shared\",\n      });\n  }\n  return problems;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,SAAgB,2BACd,UACiC;CACjC,MAAM,WAAmC,CAAC;CAC1C,KAAK,MAAM,SAAS,SAAS,QAAQ;EACnC,IAAI,MAAM,aAAa,KAAA,GAAW;EAClC,IAAI;EACJ,IAAI;GACF,SAAS,uBAAuB,MAAM,QAAQ,CAAC,CAAC;EAClD,SAAS,GAAG;GACV,SAAS,KAAK;IACZ,SAAS,MAAM;IACf,OAAO,2DAA2D,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;GAC7G,CAAC;GACD;EACF;EACA,IAAI,WAAW,QACb,SAAS,KAAK;GACZ,SAAS,MAAM;GACf,OACE,2BAA2B,MAAM,SAAS;EAE9C,CAAC;CACL;CACA,OAAO;AACT"}

package/src/model/template_share.test.ts

@@ -1,78 +0,0 @@
-import { describe, expect, test } from "vitest";
-import type {
-  BlockKindSelectorReference,
-  BlockPackLocationReference,
-  ProjectTemplateV1,
-  ProjectTemplateV1Entry,
-} from "@milaboratories/pl-model-common";
-import { PROJECT_TEMPLATE_SCHEMA_V1 } from "@milaboratories/pl-model-common";
-import { unshareableTemplateEntries } from "./template_share";
-
-/**
- * Whether a stored template may travel to another machine.
- *
- * A function of the document alone, which is why it is asked both when a share is attempted
- * and when a template is merely displayed — the refusal has to be visible on the template
- * itself, not only after the user tries.
- */
-
-const KIND = "@platforma-open/milaboratories.demo.kind@^1.0.0" as BlockKindSelectorReference;
-
-const entry = (id: string, location?: string): ProjectTemplateV1Entry => ({
-  id,
-  kind: KIND,
-  params: {},
-  ...(location !== undefined ? { location: location as BlockPackLocationReference } : {}),
-});
-
-const documentOf = (...blocks: ProjectTemplateV1Entry[]): ProjectTemplateV1 => ({
-  schema: PROJECT_TEMPLATE_SCHEMA_V1,
-  blocks,
-});
-
-describe("unshareableTemplateEntries", () => {
-  test("a template whose entries name no place at all can be shared", () => {
-    // The common case: every entry resolves through its kind, which means the same thing
-    // on the recipient's machine as it does here.
-    expect(unshareableTemplateEntries(documentOf(entry("a"), entry("b")))).toStrictEqual([]);
-  });
-
-  test("an entry installed from a folder on this machine refuses the share, and says which folder", () => {
-    const problems = unshareableTemplateEntries(
-      documentOf(entry("a"), entry("b", "file:///Users/dev/blocks/demo/block")),
-    );
-
-    expect(problems.map((p) => p.entryId)).toStrictEqual(["b"]);
-    expect(problems[0].error).toContain("file:///Users/dev/blocks/demo/block");
-  });
-
-  test("every offending entry is reported, not only the first", () => {
-    // A UI names each block once instead of sending its user round the loop per entry.
-    const problems = unshareableTemplateEntries(
-      documentOf(
-        entry("a", "file:///blocks/a"),
-        entry("b"),
-        entry("c", "FILE:///blocks/c"), // the scheme is case-insensitive
-      ),
-    );
-
-    expect(problems.map((p) => p.entryId)).toStrictEqual(["a", "c"]);
-  });
-
-  test("a location whose scheme cannot be read is refused too", () => {
-    // Nothing can resolve it anywhere, here included — so the reason differs from the
-    // `file:` one, and the message says so rather than blaming the recipient's machine.
-    const problems = unshareableTemplateEntries(documentOf(entry("a", "/blocks/a")));
-
-    expect(problems.map((p) => p.entryId)).toStrictEqual(["a"]);
-    expect(problems[0].error).toContain("nothing can resolve");
-  });
-
-  test("a location naming a place both machines can reach is not refused", () => {
-    // The rule is about a place that means something different elsewhere, not about
-    // locations as such.
-    expect(
-      unshareableTemplateEntries(documentOf(entry("a", "https://blocks.example.org/demo"))),
-    ).toStrictEqual([]);
-  });
-});

package/src/model/template_share.ts

@@ -1,52 +0,0 @@
-import type { ProjectTemplateV1 } from "@milaboratories/pl-model-common";
-import { parseBlockPackLocation } from "@milaboratories/pl-model-common";
-
-/** One template entry standing in the way of sharing the template, and why. */
-export type TemplateShareProblem = {
-  /** The template-local id of the entry the problem belongs to; on an exported template it is
-   *  the block's project-local uuid. */
-  readonly entryId: string;
-  readonly error: string;
-};
-
-/**
- * Every entry of a template that cannot travel to another machine, or an empty list for a
- * template that can be shared.
- *
- * An entry's `location` names a place rather than a name, and a `file:` place is a folder on
- * the author's own disk: a recipient resolving it finds nothing, or worse finds something
- * else. Such a template stays perfectly usable where it was made, so it is stored and applied
- * as normal — only sharing it is refused.
- *
- * A location whose scheme cannot be read is refused for the same reason: nothing can resolve
- * it anywhere, here included.
- *
- * Every offending entry is reported, not only the first, so a UI can name each block instead
- * of sending its user round the loop once per entry.
- */
-export function unshareableTemplateEntries(
-  document: ProjectTemplateV1,
-): readonly TemplateShareProblem[] {
-  const problems: TemplateShareProblem[] = [];
-  for (const entry of document.blocks) {
-    if (entry.location === undefined) continue;
-    let scheme: string;
-    try {
-      scheme = parseBlockPackLocation(entry.location).scheme;
-    } catch (e) {
-      problems.push({
-        entryId: entry.id,
-        error: `Block is installed from a location nothing can resolve: ${e instanceof Error ? e.message : String(e)}`,
-      });
-      continue;
-    }
-    if (scheme === "file")
-      problems.push({
-        entryId: entry.id,
-        error:
-          `Block is installed from ${entry.location}, a folder on this machine — it resolves ` +
-          "to nothing on the recipient's, so this template cannot be shared",
-      });
-  }
-  return problems;
-}